From be37730906230fcc4255a9802231cc4d3fe11679 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 27 Jan 2023 16:23:27 +0300
Subject: [PATCH 001/722] upd

---
 src/Common/DateLUT.cpp | 10 +++++++++-
 src/Common/DateLUT.h   | 24 ++++++++++++++++++++++--
 src/Core/Settings.h    |  1 +
 3 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/src/Common/DateLUT.cpp b/src/Common/DateLUT.cpp
index ae6127670e5..fd10b799b66 100644
--- a/src/Common/DateLUT.cpp
+++ b/src/Common/DateLUT.cpp
@@ -7,6 +7,8 @@
 
 #include <filesystem>
 #include <fstream>
+#include <Interpreters/Context.h>
+#include <Interpreters/Context_fwd.h>
 
 
 namespace
@@ -147,7 +149,7 @@ DateLUT::DateLUT()
 }
 
 
-const DateLUTImpl & DateLUT::getImplementation(const std::string & time_zone) const
+const ALWAYS_INLINE DateLUTImpl & DateLUT::getImplementation(const std::string & time_zone) const
 {
     std::lock_guard<std::mutex> lock(mutex);
 
@@ -163,3 +165,9 @@ DateLUT & DateLUT::getInstance()
     static DateLUT ret;
     return ret;
 }
+
+std::string DateLUT::extractTimezoneFromContext(const DB::ContextPtr query_context)
+{
+    std::string ret = query_context->getSettingsRef().implicit_timezone.value;
+    return ret;
+}
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index b7ba37c2bec..bd7969bffa6 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -5,6 +5,10 @@
 #include <base/defines.h>
 
 #include <boost/noncopyable.hpp>
+//
+//#include "Interpreters/Context_fwd.h"
+//#include "Interpreters/Context.h"
+#include "Common/CurrentThread.h"
 
 #include <atomic>
 #include <memory>
@@ -20,16 +24,30 @@ public:
     static ALWAYS_INLINE const DateLUTImpl & instance()  // -V1071
     {
         const auto & date_lut = getInstance();
+
+        if (DB::CurrentThread::isInitialized())
+        {
+            const auto query_context = DB::CurrentThread::get().getQueryContext();
+
+            if (query_context)
+            {
+                auto implicit_timezone = extractTimezoneFromContext(query_context);
+
+                if (!implicit_timezone.empty())
+                    return instance(implicit_timezone);
+            }
+        }
+
         return *date_lut.default_impl.load(std::memory_order_acquire);
     }
 
     /// Return singleton DateLUTImpl instance for a given time zone.
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
     {
-        const auto & date_lut = getInstance();
         if (time_zone.empty())
-            return *date_lut.default_impl.load(std::memory_order_acquire);
+            return instance();
 
+        const auto & date_lut = getInstance();
         return date_lut.getImplementation(time_zone);
     }
     static void setDefaultTimezone(const std::string & time_zone)
@@ -45,6 +63,8 @@ protected:
 private:
     static DateLUT & getInstance();
 
+    static std::string extractTimezoneFromContext(const DB::ContextPtr query_context);
+
     const DateLUTImpl & getImplementation(const std::string & time_zone) const;
 
     using DateLUTImplPtr = std::unique_ptr<DateLUTImpl>;
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 1948a6da012..2da5791ff81 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -688,6 +688,7 @@ class IColumn;
     M(Float, insert_keeper_fault_injection_probability, 0.0f, "Approximate probability of failure for a keeper request during insert. Valid value is in interval [0.0f, 1.0f]", 0) \
     M(UInt64, insert_keeper_fault_injection_seed, 0, "0 - random seed, otherwise the setting value", 0) \
     M(Bool, force_aggregation_in_order, false, "Force use of aggregation in order on remote nodes during distributed aggregation. PLEASE, NEVER CHANGE THIS SETTING VALUE MANUALLY!", IMPORTANT) \
+    M(String, implicit_timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 

From 537721e297e4ba94f30d5bd76ca0a7b01a080a5c Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 27 Jan 2023 23:40:43 +0300
Subject: [PATCH 002/722] re-add tests

---
 .../0_stateless/02538_implicit_timezone.reference        | 3 +++
 tests/queries/0_stateless/02538_implicit_timezone.sql    | 9 +++++++++
 2 files changed, 12 insertions(+)
 create mode 100644 tests/queries/0_stateless/02538_implicit_timezone.reference
 create mode 100644 tests/queries/0_stateless/02538_implicit_timezone.sql

diff --git a/tests/queries/0_stateless/02538_implicit_timezone.reference b/tests/queries/0_stateless/02538_implicit_timezone.reference
new file mode 100644
index 00000000000..8ed8024f652
--- /dev/null
+++ b/tests/queries/0_stateless/02538_implicit_timezone.reference
@@ -0,0 +1,3 @@
+1999-12-12 18:23:23.123
+1999-12-12 23:23:23.123
+1999-12-13 04:23:23.123
diff --git a/tests/queries/0_stateless/02538_implicit_timezone.sql b/tests/queries/0_stateless/02538_implicit_timezone.sql
new file mode 100644
index 00000000000..663b218d235
--- /dev/null
+++ b/tests/queries/0_stateless/02538_implicit_timezone.sql
@@ -0,0 +1,9 @@
+SET implicit_timezone = 'Asia/Novosibirsk';
+
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
+
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS implicit_timezone = 'Europe/Zurich';
+
+SET implicit_timezone = 'Europe/Zurich';
+
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
\ No newline at end of file

From 010edbf2aad3508402e82b8ce62f90ce62fc9f09 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 22 Feb 2023 10:39:23 +0100
Subject: [PATCH 003/722] do another way and logs work

---
 src/Common/DateLUT.h | 38 ++++++++++++++++++--------------------
 1 file changed, 18 insertions(+), 20 deletions(-)

diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index bd7969bffa6..6ec9cf1646d 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -5,9 +5,6 @@
 #include <base/defines.h>
 
 #include <boost/noncopyable.hpp>
-//
-//#include "Interpreters/Context_fwd.h"
-//#include "Interpreters/Context.h"
 #include "Common/CurrentThread.h"
 
 #include <atomic>
@@ -24,30 +21,31 @@ public:
     static ALWAYS_INLINE const DateLUTImpl & instance()  // -V1071
     {
         const auto & date_lut = getInstance();
-
-        if (DB::CurrentThread::isInitialized())
-        {
-            const auto query_context = DB::CurrentThread::get().getQueryContext();
-
-            if (query_context)
-            {
-                auto implicit_timezone = extractTimezoneFromContext(query_context);
-
-                if (!implicit_timezone.empty())
-                    return instance(implicit_timezone);
-            }
-        }
-
         return *date_lut.default_impl.load(std::memory_order_acquire);
     }
 
     /// Return singleton DateLUTImpl instance for a given time zone.
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
     {
-        if (time_zone.empty())
-            return instance();
-
         const auto & date_lut = getInstance();
+
+        if (time_zone.empty())
+        {
+            if (DB::CurrentThread::isInitialized())
+            {
+                const auto query_context = DB::CurrentThread::get().getQueryContext();
+
+                if (query_context)
+                {
+                    auto implicit_timezone = extractTimezoneFromContext(query_context);
+
+                    if (!implicit_timezone.empty())
+                        return instance(implicit_timezone);
+                }
+            }
+            return *date_lut.default_impl.load(std::memory_order_acquire);
+        }
+
         return date_lut.getImplementation(time_zone);
     }
     static void setDefaultTimezone(const std::string & time_zone)

From 1cf6c3a9c0fa4867684dee56c651d4131aa3b0fe Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 22 Feb 2023 10:51:32 +0100
Subject: [PATCH 004/722] update test names

---
 ...licit_timezone.reference => 02668_implicit_timezone.reference} | 0
 .../{02538_implicit_timezone.sql => 02668_implicit_timezone.sql}  | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename tests/queries/0_stateless/{02538_implicit_timezone.reference => 02668_implicit_timezone.reference} (100%)
 rename tests/queries/0_stateless/{02538_implicit_timezone.sql => 02668_implicit_timezone.sql} (100%)

diff --git a/tests/queries/0_stateless/02538_implicit_timezone.reference b/tests/queries/0_stateless/02668_implicit_timezone.reference
similarity index 100%
rename from tests/queries/0_stateless/02538_implicit_timezone.reference
rename to tests/queries/0_stateless/02668_implicit_timezone.reference
diff --git a/tests/queries/0_stateless/02538_implicit_timezone.sql b/tests/queries/0_stateless/02668_implicit_timezone.sql
similarity index 100%
rename from tests/queries/0_stateless/02538_implicit_timezone.sql
rename to tests/queries/0_stateless/02668_implicit_timezone.sql

From 393830ecdc78cd2745cc439d7ac95c3421fe9044 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 22 Feb 2023 16:30:46 +0100
Subject: [PATCH 005/722] add docs + tiny cleanup

---
 docs/en/operations/settings/settings.md | 27 ++++++++++++++++++++++++
 docs/ru/operations/settings/settings.md | 28 +++++++++++++++++++++++++
 src/Common/DateLUT.cpp                  |  3 +--
 3 files changed, 56 insertions(+), 2 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 1060eae1b0e..4e105124086 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3939,3 +3939,30 @@ Default value: `0`.
 :::note
 Use this setting only for backward compatibility if your use cases depend on old syntax.
 :::
+
+## implicit_timezone {#implicit_timezone}
+
+If specified, sets a implicit timezone (instead of server-default). All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
+Examples:
+```
+SELECT timeZone(), timeZoneOf(now())
+┌─timeZone()────┬─timeZoneOf(now())─┐
+│ Europe/Berlin │ Europe/Berlin     │
+└───────────────┴───────────────────┘
+
+:) SELECT timeZone(), timeZoneOf(now()) SETTINGS implicit_timezone = 'Asia/Novosibirsk'
+┌─timeZone()────┬─timeZoneOf(now())─┐
+│ Europe/Berlin │ Asia/Novosibirsk  │
+└───────────────┴───────────────────┘
+
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS implicit_timezone = 'America/Denver';
+┌─toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich')─┐
+│                                                      1999-12-13 07:23:23.123 │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+Possible values:
+
+-    Any valid timezone in `Region/Place` notation, e.g. `Europe/Berlin`
+
+Default value: `''`.
\ No newline at end of file
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 4025966ac21..8d3f2706585 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4084,3 +4084,31 @@ ALTER TABLE test FREEZE SETTINGS alter_partition_verbose_result = 1;
 Задает символ, который интерпретируется как суффикс после результирующего набора данных формата [CustomSeparated](../../interfaces/formats.md#format-customseparated).
 
 Значение по умолчанию: `''`.
+
+## implicit_timezone {#implicit_timezone}
+
+Задаёт значение часового пояса (timezone) по умолчанию для текущей сессии вместо часового пояса сервера. То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
+
+Примеры:
+```
+SELECT timeZone(), timeZoneOf(now())
+┌─timeZone()────┬─timeZoneOf(now())─┐
+│ Europe/Berlin │ Europe/Berlin     │
+└───────────────┴───────────────────┘
+
+:) SELECT timeZone(), timeZoneOf(now()) SETTINGS implicit_timezone = 'Asia/Novosibirsk'
+┌─timeZone()────┬─timeZoneOf(now())─┐
+│ Europe/Berlin │ Asia/Novosibirsk  │
+└───────────────┴───────────────────┘
+
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS implicit_timezone = 'America/Denver';
+┌─toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich')─┐
+│                                                      1999-12-13 07:23:23.123 │
+└──────────────────────────────────────────────────────────────────────────────┘
+```
+
+Возможные значения:
+
+-    Строка вида `Регион/Город`, например `Europe/Zurich`
+
+Значение по умолчанию: `''`.
\ No newline at end of file
diff --git a/src/Common/DateLUT.cpp b/src/Common/DateLUT.cpp
index fd10b799b66..e309b0cb28a 100644
--- a/src/Common/DateLUT.cpp
+++ b/src/Common/DateLUT.cpp
@@ -8,7 +8,6 @@
 #include <filesystem>
 #include <fstream>
 #include <Interpreters/Context.h>
-#include <Interpreters/Context_fwd.h>
 
 
 namespace
@@ -149,7 +148,7 @@ DateLUT::DateLUT()
 }
 
 
-const ALWAYS_INLINE DateLUTImpl & DateLUT::getImplementation(const std::string & time_zone) const
+const DateLUTImpl & DateLUT::getImplementation(const std::string & time_zone) const
 {
     std::lock_guard<std::mutex> lock(mutex);
 

From c61aff7cac2e5cc79dc4591d9228308e017e5b28 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 23 Feb 2023 13:38:13 +0100
Subject: [PATCH 006/722] Added standalone function to get server's own
 timezone

Fix missing global_context
---
 src/Common/DateLUT.h              | 10 ++++++++++
 src/Functions/serverConstants.cpp | 19 +++++++++++++++++--
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index b66821989e3..18ef5ee2e30 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -42,6 +42,16 @@ public:
                     if (!implicit_timezone.empty())
                         return instance(implicit_timezone);
                 }
+
+                const auto global_context = DB::CurrentThread::get().getGlobalContext();
+                if (global_context)
+                {
+                    auto implicit_timezone = extractTimezoneFromContext(global_context);
+
+                    if (!implicit_timezone.empty())
+                        return instance(implicit_timezone);
+                }
+
             }
             return *date_lut.default_impl.load(std::memory_order_acquire);
         }
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index 96615d0a4c9..a89e1564f28 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -60,13 +60,22 @@ namespace
     };
 
 
-    /// Returns the server time zone.
+    /// Returns default timezone for current session.
     class FunctionTimezone : public FunctionConstantBase<FunctionTimezone, String, DataTypeString>
     {
     public:
         static constexpr auto name = "timezone";
         static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionTimezone>(context); }
-        explicit FunctionTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance().getTimeZone()}, context->isDistributed()) {}
+        explicit FunctionTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance("").getTimeZone()}, context->isDistributed()) {}
+    };
+
+    /// Returns the server time zone (timezone in which server runs).
+    class FunctionServerTimezone : public FunctionConstantBase<FunctionServerTimezone, String, DataTypeString>
+    {
+    public:
+        static constexpr auto name = "serverTimezone";
+        static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionServerTimezone>(context); }
+        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance().getTimeZone()}, context->isDistributed()) {}
     };
 
 
@@ -155,6 +164,12 @@ REGISTER_FUNCTION(Timezone)
     factory.registerAlias("timeZone", "timezone");
 }
 
+REGISTER_FUNCTION(ServerTimezone)
+{
+    factory.registerFunction<FunctionServerTimezone>();
+    factory.registerAlias("serverTimeZone", "serverTimezone");
+}
+
 REGISTER_FUNCTION(Uptime)
 {
     factory.registerFunction<FunctionUptime>();

From a9d0f7e7dbb281def311b22e4ae6300c73b5e979 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 23 Feb 2023 19:14:49 +0100
Subject: [PATCH 007/722] Added docs for new serverTimeZone function Updated
 tests and docs

---
 docs/en/operations/settings/settings.md       | 28 ++++++++++---------
 .../functions/date-time-functions.md          | 21 +++++++++++++-
 docs/ru/operations/settings/settings.md       | 27 +++++++++---------
 .../functions/date-time-functions.md          | 21 +++++++++++++-
 src/Common/DateLUT.cpp                        |  3 +-
 src/Common/DateLUT.h                          |  8 ++++--
 src/Core/Settings.h                           |  2 +-
 src/Functions/serverConstants.cpp             | 23 +++++++++++++--
 ...rence => 02668_timezone_setting.reference} |  0
 ...imezone.sql => 02668_timezone_setting.sql} |  6 ++--
 10 files changed, 101 insertions(+), 38 deletions(-)
 rename tests/queries/0_stateless/{02668_implicit_timezone.reference => 02668_timezone_setting.reference} (100%)
 rename tests/queries/0_stateless/{02668_implicit_timezone.sql => 02668_timezone_setting.sql} (61%)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 4e105124086..c1c4483d341 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3940,25 +3940,27 @@ Default value: `0`.
 Use this setting only for backward compatibility if your use cases depend on old syntax.
 :::
 
-## implicit_timezone {#implicit_timezone}
+## timezone {#timezone}
 
 If specified, sets a implicit timezone (instead of server-default). All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
 Examples:
+
+```clickhouse
+SELECT timeZone(), serverTimezone() FORMAT TSV
+
+Europe/Berlin	Europe/Berlin
 ```
-SELECT timeZone(), timeZoneOf(now())
-┌─timeZone()────┬─timeZoneOf(now())─┐
-│ Europe/Berlin │ Europe/Berlin     │
-└───────────────┴───────────────────┘
 
-:) SELECT timeZone(), timeZoneOf(now()) SETTINGS implicit_timezone = 'Asia/Novosibirsk'
-┌─timeZone()────┬─timeZoneOf(now())─┐
-│ Europe/Berlin │ Asia/Novosibirsk  │
-└───────────────┴───────────────────┘
+```clickhouse
+SELECT timeZone(), serverTimezone() SETTINGS timezone = 'Asia/Novosibirsk' FORMAT TSV
 
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS implicit_timezone = 'America/Denver';
-┌─toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich')─┐
-│                                                      1999-12-13 07:23:23.123 │
-└──────────────────────────────────────────────────────────────────────────────┘
+Asia/Novosibirsk	Europe/Berlin
+```
+
+```clickhouse
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'America/Denver' FORMAT TSV
+
+1999-12-13 07:23:23.123
 ```
 
 Possible values:
diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index f6af8abcbaf..8d31cb3872f 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -26,7 +26,7 @@ SELECT
 
 ## timeZone
 
-Returns the timezone of the server.
+Returns the default timezone of the server for current session. This can be modified using `SET timezone = 'New/Value'`
 If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise it produces a constant value.
 
 **Syntax**
@@ -43,6 +43,25 @@ Alias: `timezone`.
 
 Type: [String](../../sql-reference/data-types/string.md).
 
+## serverTimeZone
+
+Returns the actual timezone in which the server runs in.
+If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise it produces a constant value.
+
+**Syntax**
+
+``` sql
+timeZone()
+```
+
+Alias: `ServerTimezone`, `servertimezone`.
+
+**Returned value**
+
+-   Timezone.
+
+Type: [String](../../sql-reference/data-types/string.md).
+
 ## toTimeZone
 
 Converts time or date and time to the specified time zone. The time zone is an attribute of the `Date` and `DateTime` data types. The internal value (number of seconds) of the table field or of the resultset's column does not change, the column's type changes and its string representation changes accordingly.
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 8d3f2706585..dd1e9d98427 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4085,26 +4085,27 @@ ALTER TABLE test FREEZE SETTINGS alter_partition_verbose_result = 1;
 
 Значение по умолчанию: `''`.
 
-## implicit_timezone {#implicit_timezone}
+## timezone {#timezone}
 
 Задаёт значение часового пояса (timezone) по умолчанию для текущей сессии вместо часового пояса сервера. То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
 
 Примеры:
+```clickhouse
+SELECT timeZone(), serverTimezone() FORMAT TSV
+
+Europe/Berlin	Europe/Berlin
 ```
-SELECT timeZone(), timeZoneOf(now())
-┌─timeZone()────┬─timeZoneOf(now())─┐
-│ Europe/Berlin │ Europe/Berlin     │
-└───────────────┴───────────────────┘
 
-:) SELECT timeZone(), timeZoneOf(now()) SETTINGS implicit_timezone = 'Asia/Novosibirsk'
-┌─timeZone()────┬─timeZoneOf(now())─┐
-│ Europe/Berlin │ Asia/Novosibirsk  │
-└───────────────┴───────────────────┘
+```clickhouse
+SELECT timeZone(), serverTimezone() SETTINGS timezone = 'Asia/Novosibirsk' FORMAT TSV
 
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS implicit_timezone = 'America/Denver';
-┌─toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich')─┐
-│                                                      1999-12-13 07:23:23.123 │
-└──────────────────────────────────────────────────────────────────────────────┘
+Asia/Novosibirsk	Europe/Berlin
+```
+
+```clickhouse
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'America/Denver' FORMAT TSV
+
+1999-12-13 07:23:23.123
 ```
 
 Возможные значения:
diff --git a/docs/ru/sql-reference/functions/date-time-functions.md b/docs/ru/sql-reference/functions/date-time-functions.md
index 8fbcaf9568b..77188ea2797 100644
--- a/docs/ru/sql-reference/functions/date-time-functions.md
+++ b/docs/ru/sql-reference/functions/date-time-functions.md
@@ -26,7 +26,7 @@ SELECT
 
 ## timeZone {#timezone}
 
-Возвращает часовой пояс сервера.
+Возвращает часовой пояс сервера, считающийся умолчанием для текущей сессии.
 Если функция вызывается в контексте распределенной таблицы, то она генерирует обычный столбец со значениями, актуальными для каждого шарда. Иначе возвращается константа.
 
 **Синтаксис**
@@ -43,6 +43,25 @@ timeZone()
 
 Тип: [String](../../sql-reference/data-types/string.md).
 
+## serverTimeZone {#servertimezone}
+
+Возвращает (истинный) часовой пояс сервера, в котором тот работает.
+Если функция вызывается в контексте распределенной таблицы, то она генерирует обычный столбец со значениями, актуальными для каждого шарда. Иначе возвращается константа.
+
+**Синтаксис**
+
+``` sql
+serverTimeZone()
+```
+
+Синонимы: `servertimezone`, `serverTimezone`.
+
+**Возвращаемое значение**
+
+-   Часовой пояс.
+
+Тип: [String](../../sql-reference/data-types/string.md).
+
 ## toTimeZone {#totimezone}
 
 Переводит дату или дату с временем в указанный часовой пояс. Часовой пояс - это атрибут типов `Date` и `DateTime`. Внутреннее значение (количество секунд) поля таблицы или результирующего столбца не изменяется, изменяется тип поля и, соответственно, его текстовое отображение.
diff --git a/src/Common/DateLUT.cpp b/src/Common/DateLUT.cpp
index e309b0cb28a..3698fe45aa7 100644
--- a/src/Common/DateLUT.cpp
+++ b/src/Common/DateLUT.cpp
@@ -167,6 +167,5 @@ DateLUT & DateLUT::getInstance()
 
 std::string DateLUT::extractTimezoneFromContext(const DB::ContextPtr query_context)
 {
-    std::string ret = query_context->getSettingsRef().implicit_timezone.value;
-    return ret;
+    return query_context->getSettingsRef().timezone.value;
 }
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index 18ef5ee2e30..a9ee61dc8ab 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -17,14 +17,18 @@
 class DateLUT : private boost::noncopyable
 {
 public:
-    /// Return singleton DateLUTImpl instance for the default time zone.
+    /// Return singleton DateLUTImpl instance for server's timezone (the one which server has).
     static ALWAYS_INLINE const DateLUTImpl & instance()
     {
         const auto & date_lut = getInstance();
         return *date_lut.default_impl.load(std::memory_order_acquire);
     }
 
-    /// Return singleton DateLUTImpl instance for a given time zone.
+    /*
+    Return singleton DateLUTImpl instance for a given time zone. If timezone is an empty string,
+    timezone set by `timezone` setting for current session is used. If it is not set, server's timezone is used,
+    and return is the same as calling instance().
+    */
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
     {
         const auto & date_lut = getInstance();
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index e3ed1b26269..e70b8c131b3 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -712,7 +712,7 @@ class IColumn;
     M(Float, insert_keeper_fault_injection_probability, 0.0f, "Approximate probability of failure for a keeper request during insert. Valid value is in interval [0.0f, 1.0f]", 0) \
     M(UInt64, insert_keeper_fault_injection_seed, 0, "0 - random seed, otherwise the setting value", 0) \
     M(Bool, force_aggregation_in_order, false, "Force use of aggregation in order on remote nodes during distributed aggregation. PLEASE, NEVER CHANGE THIS SETTING VALUE MANUALLY!", IMPORTANT) \
-    M(String, implicit_timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone.", 0) \
+    M(String, timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index a89e1564f28..b57f7e40e07 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -160,14 +160,33 @@ REGISTER_FUNCTION(TcpPort)
 
 REGISTER_FUNCTION(Timezone)
 {
-    factory.registerFunction<FunctionTimezone>();
+    factory.registerFunction<FunctionTimezone>({
+        R"(
+Returns the default timezone for current session.
+Used as default timezone for parsing DateTime|DateTime64 without explicitly specified timezone.
+Can be changed with SET timezone = 'New/Tz'
+
+[example:timezone]
+)",
+        Documentation::Examples{{"serverTimezone", "SELECT timezone();"}},
+        Documentation::Categories{"Constant", "Miscellaneous"}
+    });
     factory.registerAlias("timeZone", "timezone");
 }
 
 REGISTER_FUNCTION(ServerTimezone)
 {
-    factory.registerFunction<FunctionServerTimezone>();
+    factory.registerFunction<FunctionServerTimezone>({
+        R"(
+Returns the timezone name in which server operates.
+
+[example:serverTimezone]
+)",
+         Documentation::Examples{{"serverTimezone", "SELECT serverTimezone();"}},
+         Documentation::Categories{"Constant", "Miscellaneous"}
+    });
     factory.registerAlias("serverTimeZone", "serverTimezone");
+    factory.registerAlias("servertimezone", "serverTimezone");
 }
 
 REGISTER_FUNCTION(Uptime)
diff --git a/tests/queries/0_stateless/02668_implicit_timezone.reference b/tests/queries/0_stateless/02668_timezone_setting.reference
similarity index 100%
rename from tests/queries/0_stateless/02668_implicit_timezone.reference
rename to tests/queries/0_stateless/02668_timezone_setting.reference
diff --git a/tests/queries/0_stateless/02668_implicit_timezone.sql b/tests/queries/0_stateless/02668_timezone_setting.sql
similarity index 61%
rename from tests/queries/0_stateless/02668_implicit_timezone.sql
rename to tests/queries/0_stateless/02668_timezone_setting.sql
index 663b218d235..3748b536614 100644
--- a/tests/queries/0_stateless/02668_implicit_timezone.sql
+++ b/tests/queries/0_stateless/02668_timezone_setting.sql
@@ -1,9 +1,9 @@
-SET implicit_timezone = 'Asia/Novosibirsk';
+SET timezone = 'Asia/Novosibirsk';
 
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
 
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS implicit_timezone = 'Europe/Zurich';
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'Europe/Zurich';
 
-SET implicit_timezone = 'Europe/Zurich';
+SET timezone = 'Europe/Zurich';
 
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
\ No newline at end of file

From c3a6efe0310ec23521eb97c1b53c6616f72ba7a0 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 24 Feb 2023 20:51:12 +0100
Subject: [PATCH 008/722] update

---
 src/Client/ClientBase.cpp                           |  2 +-
 src/Common/DateLUT.h                                | 13 +++++++------
 src/Functions/serverConstants.cpp                   |  2 +-
 src/IO/ReadHelpers.h                                |  8 ++++----
 src/IO/WriteHelpers.h                               |  6 +++---
 .../queries/0_stateless/02668_timezone_setting.sql  |  6 +++---
 6 files changed, 19 insertions(+), 18 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index bc8c43af8c6..9ebe115d408 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -2139,7 +2139,7 @@ void ClientBase::runInteractive()
     initQueryIdFormats();
 
     /// Initialize DateLUT here to avoid counting time spent here as query execution time.
-    const auto local_tz = DateLUT::instance().getTimeZone();
+    const auto local_tz = DateLUT::instance("").getTimeZone();
 
     suggest.emplace();
     if (load_suggestions)
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index a9ee61dc8ab..29a4ee13d87 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -32,6 +32,7 @@ public:
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
     {
         const auto & date_lut = getInstance();
+        std::string effective_time_zone;
 
         if (time_zone.empty())
         {
@@ -41,19 +42,19 @@ public:
 
                 if (query_context)
                 {
-                    auto implicit_timezone = extractTimezoneFromContext(query_context);
+                    effective_time_zone = extractTimezoneFromContext(query_context);
 
-                    if (!implicit_timezone.empty())
-                        return instance(implicit_timezone);
+                    if (!effective_time_zone.empty())
+                        return date_lut.getImplementation(effective_time_zone);
                 }
 
                 const auto global_context = DB::CurrentThread::get().getGlobalContext();
                 if (global_context)
                 {
-                    auto implicit_timezone = extractTimezoneFromContext(global_context);
+                    effective_time_zone = extractTimezoneFromContext(global_context);
 
-                    if (!implicit_timezone.empty())
-                        return instance(implicit_timezone);
+                    if (!effective_time_zone.empty())
+                        return date_lut.getImplementation(effective_time_zone);
                 }
 
             }
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index b57f7e40e07..ea74d7a89bb 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -168,7 +168,7 @@ Can be changed with SET timezone = 'New/Tz'
 
 [example:timezone]
 )",
-        Documentation::Examples{{"serverTimezone", "SELECT timezone();"}},
+        Documentation::Examples{{"timezone", "SELECT timezone();"}},
         Documentation::Categories{"Constant", "Miscellaneous"}
     });
     factory.registerAlias("timeZone", "timezone");
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index f8931a7f622..9f5358ee141 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -1032,22 +1032,22 @@ inline ReturnType readDateTimeTextImpl(DateTime64 & datetime64, UInt32 scale, Re
     return ReturnType(is_ok);
 }
 
-inline void readDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
+inline void readDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
 {
     readDateTimeTextImpl<void>(datetime, buf, time_zone);
 }
 
-inline void readDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
+inline void readDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance(""))
 {
     readDateTimeTextImpl<void>(datetime64, scale, buf, date_lut);
 }
 
-inline bool tryReadDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
+inline bool tryReadDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
 {
     return readDateTimeTextImpl<bool>(datetime, buf, time_zone);
 }
 
-inline bool tryReadDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
+inline bool tryReadDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance(""))
 {
     return readDateTimeTextImpl<bool>(datetime64, scale, buf, date_lut);
 }
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index 1c0b48c53c3..d408e2bed42 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -755,14 +755,14 @@ inline void writeDateTimeText(const LocalDateTime & datetime, WriteBuffer & buf)
 
 /// In the format YYYY-MM-DD HH:MM:SS, according to the specified time zone.
 template <char date_delimeter = '-', char time_delimeter = ':', char between_date_time_delimiter = ' '>
-inline void writeDateTimeText(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
+inline void writeDateTimeText(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
 {
     writeDateTimeText<date_delimeter, time_delimeter, between_date_time_delimiter>(LocalDateTime(datetime, time_zone), buf);
 }
 
 /// In the format YYYY-MM-DD HH:MM:SS.NNNNNNNNN, according to the specified time zone.
 template <char date_delimeter = '-', char time_delimeter = ':', char between_date_time_delimiter = ' ', char fractional_time_delimiter = '.'>
-inline void writeDateTimeText(DateTime64 datetime64, UInt32 scale, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
+inline void writeDateTimeText(DateTime64 datetime64, UInt32 scale, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
 {
     static constexpr UInt32 MaxScale = DecimalUtils::max_precision<DateTime64>;
     scale = scale > MaxScale ? MaxScale : scale;
@@ -796,7 +796,7 @@ inline void writeDateTimeText(DateTime64 datetime64, UInt32 scale, WriteBuffer &
 
 /// In the RFC 1123 format: "Tue, 03 Dec 2019 00:11:50 GMT". You must provide GMT DateLUT.
 /// This is needed for HTTP requests.
-inline void writeDateTimeTextRFC1123(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
+inline void writeDateTimeTextRFC1123(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
 {
     const auto & values = time_zone.getValues(datetime);
 
diff --git a/tests/queries/0_stateless/02668_timezone_setting.sql b/tests/queries/0_stateless/02668_timezone_setting.sql
index 3748b536614..f331ab58307 100644
--- a/tests/queries/0_stateless/02668_timezone_setting.sql
+++ b/tests/queries/0_stateless/02668_timezone_setting.sql
@@ -1,9 +1,9 @@
 SET timezone = 'Asia/Novosibirsk';
-
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
-
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'Europe/Zurich';
 
 SET timezone = 'Europe/Zurich';
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
 
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
\ No newline at end of file
+SET timezone = 'Абырвалг';
+select now(); -- { serverError POCO_EXCEPTION }
\ No newline at end of file

From 6a996f552b9cf70f88d2a6c7c8f1ef2780268666 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Sun, 26 Feb 2023 10:06:27 +0100
Subject: [PATCH 009/722] update undocumented funcs reference

---
 .../02415_all_new_functions_must_be_documented.reference         | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/queries/0_stateless/02415_all_new_functions_must_be_documented.reference b/tests/queries/0_stateless/02415_all_new_functions_must_be_documented.reference
index e41249af54c..ce14ee871f5 100644
--- a/tests/queries/0_stateless/02415_all_new_functions_must_be_documented.reference
+++ b/tests/queries/0_stateless/02415_all_new_functions_must_be_documented.reference
@@ -683,7 +683,6 @@ throwIf
 tid
 timeSlot
 timeSlots
-timezone
 timezoneOf
 timezoneOffset
 toBool

From a69425326de20dcf5814c39a0962023cabec27ec Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 27 Feb 2023 01:40:00 +0100
Subject: [PATCH 010/722] upd

---
 src/Client/ClientBase.cpp         |  2 +-
 src/Common/DateLUT.h              | 59 +++++++++++++++----------------
 src/DataTypes/TimezoneMixin.h     |  2 +-
 src/Functions/serverConstants.cpp |  4 +--
 src/IO/ReadHelpers.h              |  8 ++---
 src/IO/WriteHelpers.h             |  6 ++--
 6 files changed, 39 insertions(+), 42 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index a335dca0602..96aff9aa304 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -2139,7 +2139,7 @@ void ClientBase::runInteractive()
     initQueryIdFormats();
 
     /// Initialize DateLUT here to avoid counting time spent here as query execution time.
-    const auto local_tz = DateLUT::instance("").getTimeZone();
+    const auto local_tz = DateLUT::instance().getTimeZone();
 
     suggest.emplace();
     if (load_suggestions)
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index 29a4ee13d87..efbf56b59b2 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -17,49 +17,46 @@
 class DateLUT : private boost::noncopyable
 {
 public:
-    /// Return singleton DateLUTImpl instance for server's timezone (the one which server has).
+    /// Return singleton DateLUTImpl instance for timezone set by `timezone` setting for current session is used.
+    /// If it is not set, server's timezone (the one which server has) is being used.
     static ALWAYS_INLINE const DateLUTImpl & instance()
     {
+        std::string effective_time_zone;
         const auto & date_lut = getInstance();
+
+        if (DB::CurrentThread::isInitialized())
+        {
+            const auto query_context = DB::CurrentThread::get().getQueryContext();
+
+            if (query_context)
+            {
+                effective_time_zone = extractTimezoneFromContext(query_context);
+
+                if (!effective_time_zone.empty())
+                    return date_lut.getImplementation(effective_time_zone);
+            }
+
+            const auto global_context = DB::CurrentThread::get().getGlobalContext();
+            if (global_context)
+            {
+                effective_time_zone = extractTimezoneFromContext(global_context);
+
+                if (!effective_time_zone.empty())
+                    return date_lut.getImplementation(effective_time_zone);
+            }
+
+        }
         return *date_lut.default_impl.load(std::memory_order_acquire);
     }
 
-    /*
-    Return singleton DateLUTImpl instance for a given time zone. If timezone is an empty string,
-    timezone set by `timezone` setting for current session is used. If it is not set, server's timezone is used,
-    and return is the same as calling instance().
-    */
+    /// Return singleton DateLUTImpl instance for a given time zone. If timezone is an empty string,
+    /// server's timezone is used. The `timezone` setting is not considered here.
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
     {
         const auto & date_lut = getInstance();
-        std::string effective_time_zone;
 
         if (time_zone.empty())
-        {
-            if (DB::CurrentThread::isInitialized())
-            {
-                const auto query_context = DB::CurrentThread::get().getQueryContext();
-
-                if (query_context)
-                {
-                    effective_time_zone = extractTimezoneFromContext(query_context);
-
-                    if (!effective_time_zone.empty())
-                        return date_lut.getImplementation(effective_time_zone);
-                }
-
-                const auto global_context = DB::CurrentThread::get().getGlobalContext();
-                if (global_context)
-                {
-                    effective_time_zone = extractTimezoneFromContext(global_context);
-
-                    if (!effective_time_zone.empty())
-                        return date_lut.getImplementation(effective_time_zone);
-                }
-
-            }
             return *date_lut.default_impl.load(std::memory_order_acquire);
-        }
 
         return date_lut.getImplementation(time_zone);
     }
diff --git a/src/DataTypes/TimezoneMixin.h b/src/DataTypes/TimezoneMixin.h
index 03ecde5dd0a..5b7870c7b9a 100644
--- a/src/DataTypes/TimezoneMixin.h
+++ b/src/DataTypes/TimezoneMixin.h
@@ -15,7 +15,7 @@ public:
 
     explicit TimezoneMixin(const String & time_zone_name = "")
         : has_explicit_time_zone(!time_zone_name.empty())
-        , time_zone(DateLUT::instance(time_zone_name))
+        , time_zone(time_zone_name.empty() ? DateLUT::instance() : DateLUT::instance(time_zone_name))
         , utc_time_zone(DateLUT::instance("UTC"))
     {
     }
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index ea74d7a89bb..57a6279bd7a 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -66,7 +66,7 @@ namespace
     public:
         static constexpr auto name = "timezone";
         static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionTimezone>(context); }
-        explicit FunctionTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance("").getTimeZone()}, context->isDistributed()) {}
+        explicit FunctionTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance().getTimeZone()}, context->isDistributed()) {}
     };
 
     /// Returns the server time zone (timezone in which server runs).
@@ -75,7 +75,7 @@ namespace
     public:
         static constexpr auto name = "serverTimezone";
         static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionServerTimezone>(context); }
-        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance().getTimeZone()}, context->isDistributed()) {}
+        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance("").getTimeZone()}, context->isDistributed()) {}
     };
 
 
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 9f5358ee141..f8931a7f622 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -1032,22 +1032,22 @@ inline ReturnType readDateTimeTextImpl(DateTime64 & datetime64, UInt32 scale, Re
     return ReturnType(is_ok);
 }
 
-inline void readDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
+inline void readDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
     readDateTimeTextImpl<void>(datetime, buf, time_zone);
 }
 
-inline void readDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance(""))
+inline void readDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
 {
     readDateTimeTextImpl<void>(datetime64, scale, buf, date_lut);
 }
 
-inline bool tryReadDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
+inline bool tryReadDateTimeText(time_t & datetime, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
     return readDateTimeTextImpl<bool>(datetime, buf, time_zone);
 }
 
-inline bool tryReadDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance(""))
+inline bool tryReadDateTime64Text(DateTime64 & datetime64, UInt32 scale, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
 {
     return readDateTimeTextImpl<bool>(datetime64, scale, buf, date_lut);
 }
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index d408e2bed42..1c0b48c53c3 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -755,14 +755,14 @@ inline void writeDateTimeText(const LocalDateTime & datetime, WriteBuffer & buf)
 
 /// In the format YYYY-MM-DD HH:MM:SS, according to the specified time zone.
 template <char date_delimeter = '-', char time_delimeter = ':', char between_date_time_delimiter = ' '>
-inline void writeDateTimeText(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
+inline void writeDateTimeText(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
     writeDateTimeText<date_delimeter, time_delimeter, between_date_time_delimiter>(LocalDateTime(datetime, time_zone), buf);
 }
 
 /// In the format YYYY-MM-DD HH:MM:SS.NNNNNNNNN, according to the specified time zone.
 template <char date_delimeter = '-', char time_delimeter = ':', char between_date_time_delimiter = ' ', char fractional_time_delimiter = '.'>
-inline void writeDateTimeText(DateTime64 datetime64, UInt32 scale, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
+inline void writeDateTimeText(DateTime64 datetime64, UInt32 scale, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
     static constexpr UInt32 MaxScale = DecimalUtils::max_precision<DateTime64>;
     scale = scale > MaxScale ? MaxScale : scale;
@@ -796,7 +796,7 @@ inline void writeDateTimeText(DateTime64 datetime64, UInt32 scale, WriteBuffer &
 
 /// In the RFC 1123 format: "Tue, 03 Dec 2019 00:11:50 GMT". You must provide GMT DateLUT.
 /// This is needed for HTTP requests.
-inline void writeDateTimeTextRFC1123(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance(""))
+inline void writeDateTimeTextRFC1123(time_t datetime, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
     const auto & values = time_zone.getValues(datetime);
 

From f3e19144d81449c1e2bdec52ebc38e85ea1e8ee9 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 27 Feb 2023 14:38:15 +0100
Subject: [PATCH 011/722] update

---
 src/Interpreters/executeQuery.cpp   | 3 ++-
 src/Loggers/OwnPatternFormatter.cpp | 2 +-
 src/Loggers/OwnPatternFormatter.h   | 2 ++
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index 435401796a0..cda7ec2b0d3 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -49,6 +49,7 @@
 #include <Interpreters/InterpreterTransactionControlQuery.h>
 #include <Interpreters/NormalizeSelectWithUnionQueryVisitor.h>
 #include <Interpreters/OpenTelemetrySpanLog.h>
+#include <Interpreters/OpenTelemetrySpanLog.h>
 #include <Interpreters/ProcessList.h>
 #include <Interpreters/ProcessorsProfileLog.h>
 #include <Interpreters/QueryLog.h>
@@ -1279,7 +1280,7 @@ void executeQuery(
     QueryResultDetails result_details
     {
         .query_id = context->getClientInfo().current_query_id,
-        .timezone = DateLUT::instance().getTimeZone(),
+        .timezone = DateLUT::instance("").getTimeZone(),
     };
 
     std::unique_ptr<WriteBuffer> compressed_buffer;
diff --git a/src/Loggers/OwnPatternFormatter.cpp b/src/Loggers/OwnPatternFormatter.cpp
index 02a2c2e510b..54d2b995d15 100644
--- a/src/Loggers/OwnPatternFormatter.cpp
+++ b/src/Loggers/OwnPatternFormatter.cpp
@@ -22,7 +22,7 @@ void OwnPatternFormatter::formatExtended(const DB::ExtendedLogMessage & msg_ext,
     const Poco::Message & msg = msg_ext.base;
 
     /// Change delimiters in date for compatibility with old logs.
-    DB::writeDateTimeText<'.', ':'>(msg_ext.time_seconds, wb);
+    DB::writeDateTimeText<'.', ':'>(msg_ext.time_seconds, wb, server_timezone);
 
     DB::writeChar('.', wb);
     DB::writeChar('0' + ((msg_ext.time_microseconds / 100000) % 10), wb);
diff --git a/src/Loggers/OwnPatternFormatter.h b/src/Loggers/OwnPatternFormatter.h
index d776b097cb2..07d0409b0ae 100644
--- a/src/Loggers/OwnPatternFormatter.h
+++ b/src/Loggers/OwnPatternFormatter.h
@@ -2,6 +2,7 @@
 
 
 #include <Poco/PatternFormatter.h>
+#include <Common/DateLUT.h>
 #include "ExtendedLogChannel.h"
 
 
@@ -30,5 +31,6 @@ public:
     virtual void formatExtended(const DB::ExtendedLogMessage & msg_ext, std::string & text) const;
 
 private:
+    const DateLUTImpl & server_timezone = DateLUT::instance("");
     bool color;
 };

From f2fbf2d61e8ede663ba37065d8ea8fe9b430de3e Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 6 Mar 2023 02:52:05 +0100
Subject: [PATCH 012/722] tcp protocol modification (min revision to be
 updated)

---
 src/Client/ClientBase.cpp             |  4 ++++
 src/Client/Connection.cpp             |  5 +++++
 src/Client/IServerConnection.h        |  2 ++
 src/Client/MultiplexedConnections.cpp |  2 ++
 src/Client/Suggest.cpp                |  1 +
 src/Common/DateLUT.h                  |  1 +
 src/Core/Protocol.h                   |  4 +++-
 src/Core/ProtocolDefines.h            |  2 ++
 src/Interpreters/executeQuery.cpp     |  2 +-
 src/Server/TCPHandler.cpp             | 12 ++++++++++++
 src/Server/TCPHandler.h               |  1 +
 11 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 96aff9aa304..65d04a6bb9d 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1020,6 +1020,10 @@ bool ClientBase::receiveAndProcessPacket(ASTPtr parsed_query, bool cancelled_)
             onProfileEvents(packet.block);
             return true;
 
+        case Protocol::Server::TimezoneUpdate:
+            DateLUT::setDefaultTimezone(packet.server_timezone);
+            return true;
+
         default:
             throw Exception(
                 ErrorCodes::UNKNOWN_PACKET_FROM_SERVER, "Unknown packet {} from server {}", packet.type, connection->getDescription());
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index eea007a8608..87e9e20e8f7 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -972,6 +972,11 @@ Packet Connection::receivePacket()
                 res.block = receiveProfileEvents();
                 return res;
 
+            case Protocol::Server::TimezoneUpdate:
+                readStringBinary(server_timezone, *in);
+                res.server_timezone = server_timezone;
+                return res;
+
             default:
                 /// In unknown state, disconnect - to not leave unsynchronised connection.
                 disconnect();
diff --git a/src/Client/IServerConnection.h b/src/Client/IServerConnection.h
index cd4db8f5258..52382ff9d45 100644
--- a/src/Client/IServerConnection.h
+++ b/src/Client/IServerConnection.h
@@ -38,6 +38,8 @@ struct Packet
     ParallelReadRequest request;
     ParallelReadResponse response;
 
+    std::string server_timezone;
+
     Packet() : type(Protocol::Server::Hello) {}
 };
 
diff --git a/src/Client/MultiplexedConnections.cpp b/src/Client/MultiplexedConnections.cpp
index cc260353339..668833b2a84 100644
--- a/src/Client/MultiplexedConnections.cpp
+++ b/src/Client/MultiplexedConnections.cpp
@@ -258,6 +258,7 @@ Packet MultiplexedConnections::drain()
 
         switch (packet.type)
         {
+            case Protocol::Server::TimezoneUpdate:
             case Protocol::Server::MergeTreeAllRangesAnnounecement:
             case Protocol::Server::MergeTreeReadTaskRequest:
             case Protocol::Server::ReadTaskRequest:
@@ -339,6 +340,7 @@ Packet MultiplexedConnections::receivePacketUnlocked(AsyncCallback async_callbac
 
     switch (packet.type)
     {
+        case Protocol::Server::TimezoneUpdate:
         case Protocol::Server::MergeTreeAllRangesAnnounecement:
         case Protocol::Server::MergeTreeReadTaskRequest:
         case Protocol::Server::ReadTaskRequest:
diff --git a/src/Client/Suggest.cpp b/src/Client/Suggest.cpp
index 7027f35d21a..4a29bead540 100644
--- a/src/Client/Suggest.cpp
+++ b/src/Client/Suggest.cpp
@@ -158,6 +158,7 @@ void Suggest::fetch(IServerConnection & connection, const ConnectionTimeouts & t
                 fillWordsFromBlock(packet.block);
                 continue;
 
+            case Protocol::Server::TimezoneUpdate:
             case Protocol::Server::Progress:
             case Protocol::Server::ProfileInfo:
             case Protocol::Server::Totals:
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index efbf56b59b2..f17fe772dbc 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -60,6 +60,7 @@ public:
 
         return date_lut.getImplementation(time_zone);
     }
+
     static void setDefaultTimezone(const std::string & time_zone)
     {
         auto & date_lut = getInstance();
diff --git a/src/Core/Protocol.h b/src/Core/Protocol.h
index 86c0a851c60..97a2831ffe8 100644
--- a/src/Core/Protocol.h
+++ b/src/Core/Protocol.h
@@ -83,7 +83,8 @@ namespace Protocol
             ProfileEvents = 14,             /// Packet with profile events from server.
             MergeTreeAllRangesAnnounecement = 15,
             MergeTreeReadTaskRequest = 16,  /// Request from a MergeTree replica to a coordinator
-            MAX = MergeTreeReadTaskRequest,
+            TimezoneUpdate = 17,            /// Receive server's (session-wide) default timezone
+            MAX = TimezoneUpdate,
 
         };
 
@@ -111,6 +112,7 @@ namespace Protocol
                 "ProfileEvents",
                 "MergeTreeAllRangesAnnounecement",
                 "MergeTreeReadTaskRequest",
+                "TimezoneUpdate",
             };
             return packet <= MAX
                 ? data[packet]
diff --git a/src/Core/ProtocolDefines.h b/src/Core/ProtocolDefines.h
index 3bbfb95f020..e56ae0305cc 100644
--- a/src/Core/ProtocolDefines.h
+++ b/src/Core/ProtocolDefines.h
@@ -72,3 +72,5 @@
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_SERVER_QUERY_TIME_IN_PROGRESS 54460
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES 54461
+
+#define DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES 54461
diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index cda7ec2b0d3..85e623dc17d 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -1280,7 +1280,7 @@ void executeQuery(
     QueryResultDetails result_details
     {
         .query_id = context->getClientInfo().current_query_id,
-        .timezone = DateLUT::instance("").getTimeZone(),
+        .timezone = DateLUT::instance().getTimeZone(),
     };
 
     std::unique_ptr<WriteBuffer> compressed_buffer;
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index a307b472a64..9bb11f34916 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -446,6 +446,7 @@ void TCPHandler::runImpl()
                             sendSelectProfileEvents();
                             sendLogs();
 
+
                             return false;
                         };
 
@@ -483,6 +484,9 @@ void TCPHandler::runImpl()
             {
                 std::lock_guard lock(task_callback_mutex);
                 sendLogs();
+                if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
+                    && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
+                    sendTimezone();
                 sendEndOfStream();
             }
 
@@ -1035,6 +1039,14 @@ void TCPHandler::sendInsertProfileEvents()
     sendProfileEvents();
 }
 
+void TCPHandler::sendTimezone()
+{
+    writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
+    writeStringBinary(DateLUT::instance().getTimeZone(), *out);
+    out->next();
+}
+
+
 bool TCPHandler::receiveProxyHeader()
 {
     if (in->eof())
diff --git a/src/Server/TCPHandler.h b/src/Server/TCPHandler.h
index f06b0b060b3..b19f908bc27 100644
--- a/src/Server/TCPHandler.h
+++ b/src/Server/TCPHandler.h
@@ -262,6 +262,7 @@ private:
     void sendProfileEvents();
     void sendSelectProfileEvents();
     void sendInsertProfileEvents();
+    void sendTimezone();
 
     /// Creates state.block_in/block_out for blocks read/write, depending on whether compression is enabled.
     void initBlockInput();

From 0706108b683ab5d67885b81a16b24a76c4d59513 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 6 Mar 2023 11:16:53 +0100
Subject: [PATCH 013/722] typo fix

---
 src/Interpreters/executeQuery.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Interpreters/executeQuery.cpp b/src/Interpreters/executeQuery.cpp
index 85e623dc17d..435401796a0 100644
--- a/src/Interpreters/executeQuery.cpp
+++ b/src/Interpreters/executeQuery.cpp
@@ -49,7 +49,6 @@
 #include <Interpreters/InterpreterTransactionControlQuery.h>
 #include <Interpreters/NormalizeSelectWithUnionQueryVisitor.h>
 #include <Interpreters/OpenTelemetrySpanLog.h>
-#include <Interpreters/OpenTelemetrySpanLog.h>
 #include <Interpreters/ProcessList.h>
 #include <Interpreters/ProcessorsProfileLog.h>
 #include <Interpreters/QueryLog.h>

From 57c5a637217779fbcc999cbaa5bd965f8892d092 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 6 Mar 2023 16:39:47 +0100
Subject: [PATCH 014/722] fix receive of timezone update on processing

---
 src/Client/ClientBase.cpp | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 65d04a6bb9d..7ca6bbed6ba 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1188,6 +1188,10 @@ bool ClientBase::receiveSampleBlock(Block & out, ColumnsDescription & columns_de
                 columns_description = ColumnsDescription::parse(packet.multistring_message[1]);
                 return receiveSampleBlock(out, columns_description, parsed_query);
 
+            case Protocol::Server::TimezoneUpdate:
+                DateLUT::setDefaultTimezone(packet.server_timezone);
+                break;
+
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
                     "Unexpected packet from server (expected Data, Exception or Log, got {})",
@@ -1533,6 +1537,10 @@ bool ClientBase::receiveEndOfQuery()
                 onProfileEvents(packet.block);
                 break;
 
+            case Protocol::Server::TimezoneUpdate:
+                DateLUT::setDefaultTimezone(packet.server_timezone);
+                break;
+
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
                     "Unexpected packet from server (expected Exception, EndOfStream, Log, Progress or ProfileEvents. Got {})",

From d93937cc5e92ae4612259e9e57bca15489aabc8f Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 6 Mar 2023 16:45:38 +0100
Subject: [PATCH 015/722] increment protocol version

---
 src/Core/ProtocolDefines.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Core/ProtocolDefines.h b/src/Core/ProtocolDefines.h
index e56ae0305cc..5483489d5c4 100644
--- a/src/Core/ProtocolDefines.h
+++ b/src/Core/ProtocolDefines.h
@@ -54,7 +54,7 @@
 /// NOTE: DBMS_TCP_PROTOCOL_VERSION has nothing common with VERSION_REVISION,
 /// later is just a number for server version (one number instead of commit SHA)
 /// for simplicity (sometimes it may be more convenient in some use cases).
-#define DBMS_TCP_PROTOCOL_VERSION 54461
+#define DBMS_TCP_PROTOCOL_VERSION 54462
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_INITIAL_QUERY_START_TIME 54449
 
@@ -73,4 +73,4 @@
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES 54461
 
-#define DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES 54461
+#define DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES 54462

From 3a918ae66a984451e0db0f56ffa6232b897ad62f Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 02:33:46 +0100
Subject: [PATCH 016/722] revert protocol changes, found better way

---
 src/Client/ClientBase.cpp             | 25 ++++++++++++-------------
 src/Client/Connection.cpp             |  5 -----
 src/Client/MultiplexedConnections.cpp |  2 --
 src/Client/Suggest.cpp                |  1 -
 src/Core/Protocol.h                   |  4 +---
 src/Core/ProtocolDefines.h            |  4 +---
 src/Server/TCPHandler.cpp             | 10 ----------
 src/Server/TCPHandler.h               |  1 -
 8 files changed, 14 insertions(+), 38 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 7ca6bbed6ba..09c510f01f3 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1020,10 +1020,6 @@ bool ClientBase::receiveAndProcessPacket(ASTPtr parsed_query, bool cancelled_)
             onProfileEvents(packet.block);
             return true;
 
-        case Protocol::Server::TimezoneUpdate:
-            DateLUT::setDefaultTimezone(packet.server_timezone);
-            return true;
-
         default:
             throw Exception(
                 ErrorCodes::UNKNOWN_PACKET_FROM_SERVER, "Unknown packet {} from server {}", packet.type, connection->getDescription());
@@ -1188,10 +1184,6 @@ bool ClientBase::receiveSampleBlock(Block & out, ColumnsDescription & columns_de
                 columns_description = ColumnsDescription::parse(packet.multistring_message[1]);
                 return receiveSampleBlock(out, columns_description, parsed_query);
 
-            case Protocol::Server::TimezoneUpdate:
-                DateLUT::setDefaultTimezone(packet.server_timezone);
-                break;
-
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
                     "Unexpected packet from server (expected Data, Exception or Log, got {})",
@@ -1500,7 +1492,7 @@ void ClientBase::receiveLogsAndProfileEvents(ASTPtr parsed_query)
 {
     auto packet_type = connection->checkPacket(0);
 
-    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents))
+    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents ))
     {
         receiveAndProcessPacket(parsed_query, false);
         packet_type = connection->checkPacket(0);
@@ -1537,10 +1529,6 @@ bool ClientBase::receiveEndOfQuery()
                 onProfileEvents(packet.block);
                 break;
 
-            case Protocol::Server::TimezoneUpdate:
-                DateLUT::setDefaultTimezone(packet.server_timezone);
-                break;
-
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
                     "Unexpected packet from server (expected Exception, EndOfStream, Log, Progress or ProfileEvents. Got {})",
@@ -1611,6 +1599,8 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
     progress_indication.resetProgress();
     profile_events.watch.restart();
 
+    const std::string old_timezone = DateLUT::instance().getTimeZone();
+
     {
         /// Temporarily apply query settings to context.
         std::optional<Settings> old_settings;
@@ -1659,6 +1649,9 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
 
         bool is_async_insert = global_context->getSettingsRef().async_insert && insert && insert->hasInlinedData();
 
+        if (!global_context->getSettingsRef().timezone.toString().empty())
+            DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
+
         /// INSERT query for which data transfer is needed (not an INSERT SELECT or input()) is processed separately.
         if (insert && (!insert->select || input_function) && !insert->watch && !is_async_insert)
         {
@@ -1693,6 +1686,10 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
                 query_parameters.insert_or_assign(name, value);
 
             global_context->addQueryParameters(set_query->query_parameters);
+
+            if (!global_context->getSettingsRef().timezone.toString().empty())
+                DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
+
         }
         if (const auto * use_query = parsed_query->as<ASTUseQuery>())
         {
@@ -1703,6 +1700,8 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
             connection->setDefaultDatabase(new_database);
         }
     }
+    else
+        DateLUT::setDefaultTimezone(old_timezone);
 
     /// Always print last block (if it was not printed already)
     if (profile_events.last_block)
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index 87e9e20e8f7..eea007a8608 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -972,11 +972,6 @@ Packet Connection::receivePacket()
                 res.block = receiveProfileEvents();
                 return res;
 
-            case Protocol::Server::TimezoneUpdate:
-                readStringBinary(server_timezone, *in);
-                res.server_timezone = server_timezone;
-                return res;
-
             default:
                 /// In unknown state, disconnect - to not leave unsynchronised connection.
                 disconnect();
diff --git a/src/Client/MultiplexedConnections.cpp b/src/Client/MultiplexedConnections.cpp
index 668833b2a84..cc260353339 100644
--- a/src/Client/MultiplexedConnections.cpp
+++ b/src/Client/MultiplexedConnections.cpp
@@ -258,7 +258,6 @@ Packet MultiplexedConnections::drain()
 
         switch (packet.type)
         {
-            case Protocol::Server::TimezoneUpdate:
             case Protocol::Server::MergeTreeAllRangesAnnounecement:
             case Protocol::Server::MergeTreeReadTaskRequest:
             case Protocol::Server::ReadTaskRequest:
@@ -340,7 +339,6 @@ Packet MultiplexedConnections::receivePacketUnlocked(AsyncCallback async_callbac
 
     switch (packet.type)
     {
-        case Protocol::Server::TimezoneUpdate:
         case Protocol::Server::MergeTreeAllRangesAnnounecement:
         case Protocol::Server::MergeTreeReadTaskRequest:
         case Protocol::Server::ReadTaskRequest:
diff --git a/src/Client/Suggest.cpp b/src/Client/Suggest.cpp
index 4a29bead540..7027f35d21a 100644
--- a/src/Client/Suggest.cpp
+++ b/src/Client/Suggest.cpp
@@ -158,7 +158,6 @@ void Suggest::fetch(IServerConnection & connection, const ConnectionTimeouts & t
                 fillWordsFromBlock(packet.block);
                 continue;
 
-            case Protocol::Server::TimezoneUpdate:
             case Protocol::Server::Progress:
             case Protocol::Server::ProfileInfo:
             case Protocol::Server::Totals:
diff --git a/src/Core/Protocol.h b/src/Core/Protocol.h
index 97a2831ffe8..86c0a851c60 100644
--- a/src/Core/Protocol.h
+++ b/src/Core/Protocol.h
@@ -83,8 +83,7 @@ namespace Protocol
             ProfileEvents = 14,             /// Packet with profile events from server.
             MergeTreeAllRangesAnnounecement = 15,
             MergeTreeReadTaskRequest = 16,  /// Request from a MergeTree replica to a coordinator
-            TimezoneUpdate = 17,            /// Receive server's (session-wide) default timezone
-            MAX = TimezoneUpdate,
+            MAX = MergeTreeReadTaskRequest,
 
         };
 
@@ -112,7 +111,6 @@ namespace Protocol
                 "ProfileEvents",
                 "MergeTreeAllRangesAnnounecement",
                 "MergeTreeReadTaskRequest",
-                "TimezoneUpdate",
             };
             return packet <= MAX
                 ? data[packet]
diff --git a/src/Core/ProtocolDefines.h b/src/Core/ProtocolDefines.h
index 5483489d5c4..3bbfb95f020 100644
--- a/src/Core/ProtocolDefines.h
+++ b/src/Core/ProtocolDefines.h
@@ -54,7 +54,7 @@
 /// NOTE: DBMS_TCP_PROTOCOL_VERSION has nothing common with VERSION_REVISION,
 /// later is just a number for server version (one number instead of commit SHA)
 /// for simplicity (sometimes it may be more convenient in some use cases).
-#define DBMS_TCP_PROTOCOL_VERSION 54462
+#define DBMS_TCP_PROTOCOL_VERSION 54461
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_INITIAL_QUERY_START_TIME 54449
 
@@ -72,5 +72,3 @@
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_SERVER_QUERY_TIME_IN_PROGRESS 54460
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES 54461
-
-#define DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES 54462
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 9bb11f34916..617b084a149 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -484,9 +484,6 @@ void TCPHandler::runImpl()
             {
                 std::lock_guard lock(task_callback_mutex);
                 sendLogs();
-                if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
-                    && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
-                    sendTimezone();
                 sendEndOfStream();
             }
 
@@ -1039,13 +1036,6 @@ void TCPHandler::sendInsertProfileEvents()
     sendProfileEvents();
 }
 
-void TCPHandler::sendTimezone()
-{
-    writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
-    writeStringBinary(DateLUT::instance().getTimeZone(), *out);
-    out->next();
-}
-
 
 bool TCPHandler::receiveProxyHeader()
 {
diff --git a/src/Server/TCPHandler.h b/src/Server/TCPHandler.h
index b19f908bc27..f06b0b060b3 100644
--- a/src/Server/TCPHandler.h
+++ b/src/Server/TCPHandler.h
@@ -262,7 +262,6 @@ private:
     void sendProfileEvents();
     void sendSelectProfileEvents();
     void sendInsertProfileEvents();
-    void sendTimezone();
 
     /// Creates state.block_in/block_out for blocks read/write, depending on whether compression is enabled.
     void initBlockInput();

From c859478db3a3964c49457e49bab62bdf975bed7f Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 02:36:02 +0100
Subject: [PATCH 017/722] upd

---
 src/Client/IServerConnection.h | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/Client/IServerConnection.h b/src/Client/IServerConnection.h
index 52382ff9d45..cd4db8f5258 100644
--- a/src/Client/IServerConnection.h
+++ b/src/Client/IServerConnection.h
@@ -38,8 +38,6 @@ struct Packet
     ParallelReadRequest request;
     ParallelReadResponse response;
 
-    std::string server_timezone;
-
     Packet() : type(Protocol::Server::Hello) {}
 };
 

From 5e7a861e688dea04ecfe9c54d30c642f65a28569 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 02:45:47 +0100
Subject: [PATCH 018/722] fix

---
 src/Server/TCPHandler.cpp | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 617b084a149..a307b472a64 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -446,7 +446,6 @@ void TCPHandler::runImpl()
                             sendSelectProfileEvents();
                             sendLogs();
 
-
                             return false;
                         };
 
@@ -1036,7 +1035,6 @@ void TCPHandler::sendInsertProfileEvents()
     sendProfileEvents();
 }
 
-
 bool TCPHandler::receiveProxyHeader()
 {
     if (in->eof())

From a7a3c9d1a675743e776fde32c96ccd9bbfc94e46 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 02:52:42 +0100
Subject: [PATCH 019/722] fix style

---
 src/Client/ClientBase.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 09c510f01f3..25442c89f99 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1492,7 +1492,7 @@ void ClientBase::receiveLogsAndProfileEvents(ASTPtr parsed_query)
 {
     auto packet_type = connection->checkPacket(0);
 
-    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents ))
+    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents))
     {
         receiveAndProcessPacket(parsed_query, false);
         packet_type = connection->checkPacket(0);

From e92501d5dd7a9f3a77ad38f8750432a2286e9f0b Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 13:02:02 +0100
Subject: [PATCH 020/722] update tests + exception

---
 src/Client/ClientBase.cpp                     | 28 +++++++++++++++++--
 ...rence => 02674_timezone_setting.reference} |  0
 ...setting.sql => 02674_timezone_setting.sql} |  4 +--
 3 files changed, 27 insertions(+), 5 deletions(-)
 rename tests/queries/0_stateless/{02668_timezone_setting.reference => 02674_timezone_setting.reference} (100%)
 rename tests/queries/0_stateless/{02668_timezone_setting.sql => 02674_timezone_setting.sql} (73%)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 25442c89f99..13f28806066 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -107,6 +107,7 @@ namespace ErrorCodes
     extern const int UNRECOGNIZED_ARGUMENTS;
     extern const int LOGICAL_ERROR;
     extern const int CANNOT_OPEN_FILE;
+    extern const int CANNOT_PARSE_DATETIME;
 }
 
 }
@@ -1599,6 +1600,9 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
     progress_indication.resetProgress();
     profile_events.watch.restart();
 
+    /// A query may contain timezone setting. To handle this, old client-wide tz is saved here.
+    /// If timezone was set for a query, after its execution client tz will be back to old one.
+    /// If it was a settings query, new setting will be applied to client.
     const std::string old_timezone = DateLUT::instance().getTimeZone();
 
     {
@@ -1649,8 +1653,18 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
 
         bool is_async_insert = global_context->getSettingsRef().async_insert && insert && insert->hasInlinedData();
 
-        if (!global_context->getSettingsRef().timezone.toString().empty())
-            DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
+        /// pre-load timezone from (query) settings -- new timezone may also be specified in query.
+        try
+        {
+            if (!global_context->getSettingsRef().timezone.toString().empty())
+                DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
+        }
+        catch (Poco::Exception &)
+        {
+            throw Exception(ErrorCodes::CANNOT_PARSE_DATETIME,
+                            "Invalid time zone {} in client settings. Use `SET timezone = \'New/TZ\'` to set a proper timezone.",
+                            global_context->getSettingsRef().timezone.toString());
+        }
 
         /// INSERT query for which data transfer is needed (not an INSERT SELECT or input()) is processed separately.
         if (insert && (!insert->select || input_function) && !insert->watch && !is_async_insert)
@@ -1687,9 +1701,17 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
 
             global_context->addQueryParameters(set_query->query_parameters);
 
+            try
+            {
             if (!global_context->getSettingsRef().timezone.toString().empty())
                 DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
-
+            }
+            catch (Poco::Exception &)
+            {
+                throw Exception(ErrorCodes::CANNOT_PARSE_DATETIME,
+                            "Invalid time zone {} in client settings. Use `SET timezone = \'New/TZ\'` to set a proper timezone.",
+                            global_context->getSettingsRef().timezone.toString());
+            }
         }
         if (const auto * use_query = parsed_query->as<ASTUseQuery>())
         {
diff --git a/tests/queries/0_stateless/02668_timezone_setting.reference b/tests/queries/0_stateless/02674_timezone_setting.reference
similarity index 100%
rename from tests/queries/0_stateless/02668_timezone_setting.reference
rename to tests/queries/0_stateless/02674_timezone_setting.reference
diff --git a/tests/queries/0_stateless/02668_timezone_setting.sql b/tests/queries/0_stateless/02674_timezone_setting.sql
similarity index 73%
rename from tests/queries/0_stateless/02668_timezone_setting.sql
rename to tests/queries/0_stateless/02674_timezone_setting.sql
index f331ab58307..51820fc2dca 100644
--- a/tests/queries/0_stateless/02668_timezone_setting.sql
+++ b/tests/queries/0_stateless/02674_timezone_setting.sql
@@ -5,5 +5,5 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 SET timezone = 'Europe/Zurich';
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
 
-SET timezone = 'Абырвалг';
-select now(); -- { serverError POCO_EXCEPTION }
\ No newline at end of file
+SET timezone = 'Абырвалг'; -- { clientError CANNOT_PARSE_DATETIME }
+select now();  -- { clientError CANNOT_PARSE_DATETIME }
\ No newline at end of file

From 1fd6e3f23b41dac6fde5b238e1a5da11a976b5ae Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 16:02:30 +0100
Subject: [PATCH 021/722] Revert "fix style"

This reverts commit a7a3c9d1a675743e776fde32c96ccd9bbfc94e46.
---
 src/Client/ClientBase.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 13f28806066..cfef1a5d3fe 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1493,7 +1493,7 @@ void ClientBase::receiveLogsAndProfileEvents(ASTPtr parsed_query)
 {
     auto packet_type = connection->checkPacket(0);
 
-    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents))
+    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents ))
     {
         receiveAndProcessPacket(parsed_query, false);
         packet_type = connection->checkPacket(0);

From 1ce697d8c06ce7f44e078f9b8809dcaa3e3ba8f8 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 7 Mar 2023 16:05:23 +0100
Subject: [PATCH 022/722] Revert "revert protocol changes, found better way"

This reverts commit 3a918ae66a984451e0db0f56ffa6232b897ad62f.
---
 src/Client/ClientBase.cpp                     | 47 +++++--------------
 src/Client/Connection.cpp                     |  5 ++
 src/Client/IServerConnection.h                |  2 +
 src/Client/MultiplexedConnections.cpp         |  2 +
 src/Client/Suggest.cpp                        |  1 +
 src/Core/Protocol.h                           |  4 +-
 src/Core/ProtocolDefines.h                    |  4 +-
 src/Server/TCPHandler.cpp                     | 12 +++++
 src/Server/TCPHandler.h                       |  1 +
 ...rence => 02668_timezone_setting.reference} |  0
 ...setting.sql => 02668_timezone_setting.sql} |  4 +-
 11 files changed, 44 insertions(+), 38 deletions(-)
 rename tests/queries/0_stateless/{02674_timezone_setting.reference => 02668_timezone_setting.reference} (100%)
 rename tests/queries/0_stateless/{02674_timezone_setting.sql => 02668_timezone_setting.sql} (73%)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index cfef1a5d3fe..7ca6bbed6ba 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -107,7 +107,6 @@ namespace ErrorCodes
     extern const int UNRECOGNIZED_ARGUMENTS;
     extern const int LOGICAL_ERROR;
     extern const int CANNOT_OPEN_FILE;
-    extern const int CANNOT_PARSE_DATETIME;
 }
 
 }
@@ -1021,6 +1020,10 @@ bool ClientBase::receiveAndProcessPacket(ASTPtr parsed_query, bool cancelled_)
             onProfileEvents(packet.block);
             return true;
 
+        case Protocol::Server::TimezoneUpdate:
+            DateLUT::setDefaultTimezone(packet.server_timezone);
+            return true;
+
         default:
             throw Exception(
                 ErrorCodes::UNKNOWN_PACKET_FROM_SERVER, "Unknown packet {} from server {}", packet.type, connection->getDescription());
@@ -1185,6 +1188,10 @@ bool ClientBase::receiveSampleBlock(Block & out, ColumnsDescription & columns_de
                 columns_description = ColumnsDescription::parse(packet.multistring_message[1]);
                 return receiveSampleBlock(out, columns_description, parsed_query);
 
+            case Protocol::Server::TimezoneUpdate:
+                DateLUT::setDefaultTimezone(packet.server_timezone);
+                break;
+
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
                     "Unexpected packet from server (expected Data, Exception or Log, got {})",
@@ -1493,7 +1500,7 @@ void ClientBase::receiveLogsAndProfileEvents(ASTPtr parsed_query)
 {
     auto packet_type = connection->checkPacket(0);
 
-    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents ))
+    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents))
     {
         receiveAndProcessPacket(parsed_query, false);
         packet_type = connection->checkPacket(0);
@@ -1530,6 +1537,10 @@ bool ClientBase::receiveEndOfQuery()
                 onProfileEvents(packet.block);
                 break;
 
+            case Protocol::Server::TimezoneUpdate:
+                DateLUT::setDefaultTimezone(packet.server_timezone);
+                break;
+
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
                     "Unexpected packet from server (expected Exception, EndOfStream, Log, Progress or ProfileEvents. Got {})",
@@ -1600,11 +1611,6 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
     progress_indication.resetProgress();
     profile_events.watch.restart();
 
-    /// A query may contain timezone setting. To handle this, old client-wide tz is saved here.
-    /// If timezone was set for a query, after its execution client tz will be back to old one.
-    /// If it was a settings query, new setting will be applied to client.
-    const std::string old_timezone = DateLUT::instance().getTimeZone();
-
     {
         /// Temporarily apply query settings to context.
         std::optional<Settings> old_settings;
@@ -1653,19 +1659,6 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
 
         bool is_async_insert = global_context->getSettingsRef().async_insert && insert && insert->hasInlinedData();
 
-        /// pre-load timezone from (query) settings -- new timezone may also be specified in query.
-        try
-        {
-            if (!global_context->getSettingsRef().timezone.toString().empty())
-                DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
-        }
-        catch (Poco::Exception &)
-        {
-            throw Exception(ErrorCodes::CANNOT_PARSE_DATETIME,
-                            "Invalid time zone {} in client settings. Use `SET timezone = \'New/TZ\'` to set a proper timezone.",
-                            global_context->getSettingsRef().timezone.toString());
-        }
-
         /// INSERT query for which data transfer is needed (not an INSERT SELECT or input()) is processed separately.
         if (insert && (!insert->select || input_function) && !insert->watch && !is_async_insert)
         {
@@ -1700,18 +1693,6 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
                 query_parameters.insert_or_assign(name, value);
 
             global_context->addQueryParameters(set_query->query_parameters);
-
-            try
-            {
-            if (!global_context->getSettingsRef().timezone.toString().empty())
-                DateLUT::setDefaultTimezone(global_context->getSettingsRef().timezone);
-            }
-            catch (Poco::Exception &)
-            {
-                throw Exception(ErrorCodes::CANNOT_PARSE_DATETIME,
-                            "Invalid time zone {} in client settings. Use `SET timezone = \'New/TZ\'` to set a proper timezone.",
-                            global_context->getSettingsRef().timezone.toString());
-            }
         }
         if (const auto * use_query = parsed_query->as<ASTUseQuery>())
         {
@@ -1722,8 +1703,6 @@ void ClientBase::processParsedSingleQuery(const String & full_query, const Strin
             connection->setDefaultDatabase(new_database);
         }
     }
-    else
-        DateLUT::setDefaultTimezone(old_timezone);
 
     /// Always print last block (if it was not printed already)
     if (profile_events.last_block)
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index eea007a8608..87e9e20e8f7 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -972,6 +972,11 @@ Packet Connection::receivePacket()
                 res.block = receiveProfileEvents();
                 return res;
 
+            case Protocol::Server::TimezoneUpdate:
+                readStringBinary(server_timezone, *in);
+                res.server_timezone = server_timezone;
+                return res;
+
             default:
                 /// In unknown state, disconnect - to not leave unsynchronised connection.
                 disconnect();
diff --git a/src/Client/IServerConnection.h b/src/Client/IServerConnection.h
index cd4db8f5258..52382ff9d45 100644
--- a/src/Client/IServerConnection.h
+++ b/src/Client/IServerConnection.h
@@ -38,6 +38,8 @@ struct Packet
     ParallelReadRequest request;
     ParallelReadResponse response;
 
+    std::string server_timezone;
+
     Packet() : type(Protocol::Server::Hello) {}
 };
 
diff --git a/src/Client/MultiplexedConnections.cpp b/src/Client/MultiplexedConnections.cpp
index cc260353339..668833b2a84 100644
--- a/src/Client/MultiplexedConnections.cpp
+++ b/src/Client/MultiplexedConnections.cpp
@@ -258,6 +258,7 @@ Packet MultiplexedConnections::drain()
 
         switch (packet.type)
         {
+            case Protocol::Server::TimezoneUpdate:
             case Protocol::Server::MergeTreeAllRangesAnnounecement:
             case Protocol::Server::MergeTreeReadTaskRequest:
             case Protocol::Server::ReadTaskRequest:
@@ -339,6 +340,7 @@ Packet MultiplexedConnections::receivePacketUnlocked(AsyncCallback async_callbac
 
     switch (packet.type)
     {
+        case Protocol::Server::TimezoneUpdate:
         case Protocol::Server::MergeTreeAllRangesAnnounecement:
         case Protocol::Server::MergeTreeReadTaskRequest:
         case Protocol::Server::ReadTaskRequest:
diff --git a/src/Client/Suggest.cpp b/src/Client/Suggest.cpp
index 7027f35d21a..4a29bead540 100644
--- a/src/Client/Suggest.cpp
+++ b/src/Client/Suggest.cpp
@@ -158,6 +158,7 @@ void Suggest::fetch(IServerConnection & connection, const ConnectionTimeouts & t
                 fillWordsFromBlock(packet.block);
                 continue;
 
+            case Protocol::Server::TimezoneUpdate:
             case Protocol::Server::Progress:
             case Protocol::Server::ProfileInfo:
             case Protocol::Server::Totals:
diff --git a/src/Core/Protocol.h b/src/Core/Protocol.h
index 86c0a851c60..97a2831ffe8 100644
--- a/src/Core/Protocol.h
+++ b/src/Core/Protocol.h
@@ -83,7 +83,8 @@ namespace Protocol
             ProfileEvents = 14,             /// Packet with profile events from server.
             MergeTreeAllRangesAnnounecement = 15,
             MergeTreeReadTaskRequest = 16,  /// Request from a MergeTree replica to a coordinator
-            MAX = MergeTreeReadTaskRequest,
+            TimezoneUpdate = 17,            /// Receive server's (session-wide) default timezone
+            MAX = TimezoneUpdate,
 
         };
 
@@ -111,6 +112,7 @@ namespace Protocol
                 "ProfileEvents",
                 "MergeTreeAllRangesAnnounecement",
                 "MergeTreeReadTaskRequest",
+                "TimezoneUpdate",
             };
             return packet <= MAX
                 ? data[packet]
diff --git a/src/Core/ProtocolDefines.h b/src/Core/ProtocolDefines.h
index 3bbfb95f020..5483489d5c4 100644
--- a/src/Core/ProtocolDefines.h
+++ b/src/Core/ProtocolDefines.h
@@ -54,7 +54,7 @@
 /// NOTE: DBMS_TCP_PROTOCOL_VERSION has nothing common with VERSION_REVISION,
 /// later is just a number for server version (one number instead of commit SHA)
 /// for simplicity (sometimes it may be more convenient in some use cases).
-#define DBMS_TCP_PROTOCOL_VERSION 54461
+#define DBMS_TCP_PROTOCOL_VERSION 54462
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_INITIAL_QUERY_START_TIME 54449
 
@@ -72,3 +72,5 @@
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_SERVER_QUERY_TIME_IN_PROGRESS 54460
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES 54461
+
+#define DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES 54462
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index a307b472a64..9bb11f34916 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -446,6 +446,7 @@ void TCPHandler::runImpl()
                             sendSelectProfileEvents();
                             sendLogs();
 
+
                             return false;
                         };
 
@@ -483,6 +484,9 @@ void TCPHandler::runImpl()
             {
                 std::lock_guard lock(task_callback_mutex);
                 sendLogs();
+                if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
+                    && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
+                    sendTimezone();
                 sendEndOfStream();
             }
 
@@ -1035,6 +1039,14 @@ void TCPHandler::sendInsertProfileEvents()
     sendProfileEvents();
 }
 
+void TCPHandler::sendTimezone()
+{
+    writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
+    writeStringBinary(DateLUT::instance().getTimeZone(), *out);
+    out->next();
+}
+
+
 bool TCPHandler::receiveProxyHeader()
 {
     if (in->eof())
diff --git a/src/Server/TCPHandler.h b/src/Server/TCPHandler.h
index f06b0b060b3..b19f908bc27 100644
--- a/src/Server/TCPHandler.h
+++ b/src/Server/TCPHandler.h
@@ -262,6 +262,7 @@ private:
     void sendProfileEvents();
     void sendSelectProfileEvents();
     void sendInsertProfileEvents();
+    void sendTimezone();
 
     /// Creates state.block_in/block_out for blocks read/write, depending on whether compression is enabled.
     void initBlockInput();
diff --git a/tests/queries/0_stateless/02674_timezone_setting.reference b/tests/queries/0_stateless/02668_timezone_setting.reference
similarity index 100%
rename from tests/queries/0_stateless/02674_timezone_setting.reference
rename to tests/queries/0_stateless/02668_timezone_setting.reference
diff --git a/tests/queries/0_stateless/02674_timezone_setting.sql b/tests/queries/0_stateless/02668_timezone_setting.sql
similarity index 73%
rename from tests/queries/0_stateless/02674_timezone_setting.sql
rename to tests/queries/0_stateless/02668_timezone_setting.sql
index 51820fc2dca..f331ab58307 100644
--- a/tests/queries/0_stateless/02674_timezone_setting.sql
+++ b/tests/queries/0_stateless/02668_timezone_setting.sql
@@ -5,5 +5,5 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 SET timezone = 'Europe/Zurich';
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
 
-SET timezone = 'Абырвалг'; -- { clientError CANNOT_PARSE_DATETIME }
-select now();  -- { clientError CANNOT_PARSE_DATETIME }
\ No newline at end of file
+SET timezone = 'Абырвалг';
+select now(); -- { serverError POCO_EXCEPTION }
\ No newline at end of file

From bbb31cf8913527eb21823216821ca536c2779563 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 15 Mar 2023 18:37:23 +0100
Subject: [PATCH 023/722] added validation on setting modification

---
 src/Client/ClientBase.cpp   | 17 ++++++++++++-----
 src/Client/ClientBase.h     |  1 +
 src/Core/Settings.h         |  2 +-
 src/Core/SettingsFields.cpp | 11 +++++++++++
 src/Core/SettingsFields.h   | 38 +++++++++++++++++++++++++++++++++++++
 src/Server/TCPHandler.cpp   | 17 +++++++++++++----
 6 files changed, 76 insertions(+), 10 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 7ca6bbed6ba..5b086d675ba 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1021,7 +1021,7 @@ bool ClientBase::receiveAndProcessPacket(ASTPtr parsed_query, bool cancelled_)
             return true;
 
         case Protocol::Server::TimezoneUpdate:
-            DateLUT::setDefaultTimezone(packet.server_timezone);
+            onTimezoneUpdate(packet.server_timezone);
             return true;
 
         default:
@@ -1046,6 +1046,11 @@ void ClientBase::onProgress(const Progress & value)
         progress_indication.writeProgress(*tty_buf);
 }
 
+void ClientBase::onTimezoneUpdate(const String & tz)
+{
+    DateLUT::setDefaultTimezone(tz);
+}
+
 
 void ClientBase::onEndOfStream()
 {
@@ -1189,12 +1194,12 @@ bool ClientBase::receiveSampleBlock(Block & out, ColumnsDescription & columns_de
                 return receiveSampleBlock(out, columns_description, parsed_query);
 
             case Protocol::Server::TimezoneUpdate:
-                DateLUT::setDefaultTimezone(packet.server_timezone);
+                onTimezoneUpdate(packet.server_timezone);
                 break;
 
             default:
                 throw NetException(ErrorCodes::UNEXPECTED_PACKET_FROM_SERVER,
-                    "Unexpected packet from server (expected Data, Exception or Log, got {})",
+                    "Unexpected packet from server (expected Data, Exception, Log or TimezoneUpdate, got {})",
                     String(Protocol::Server::toString(packet.type)));
         }
     }
@@ -1500,7 +1505,9 @@ void ClientBase::receiveLogsAndProfileEvents(ASTPtr parsed_query)
 {
     auto packet_type = connection->checkPacket(0);
 
-    while (packet_type && (*packet_type == Protocol::Server::Log || *packet_type == Protocol::Server::ProfileEvents))
+    while (packet_type && (*packet_type == Protocol::Server::Log           ||
+                           *packet_type == Protocol::Server::ProfileEvents ||
+                           *packet_type == Protocol::Server::TimezoneUpdate))
     {
         receiveAndProcessPacket(parsed_query, false);
         packet_type = connection->checkPacket(0);
@@ -1538,7 +1545,7 @@ bool ClientBase::receiveEndOfQuery()
                 break;
 
             case Protocol::Server::TimezoneUpdate:
-                DateLUT::setDefaultTimezone(packet.server_timezone);
+                onTimezoneUpdate(packet.server_timezone);
                 break;
 
             default:
diff --git a/src/Client/ClientBase.h b/src/Client/ClientBase.h
index 52e15a1a075..18d9a30cac0 100644
--- a/src/Client/ClientBase.h
+++ b/src/Client/ClientBase.h
@@ -139,6 +139,7 @@ private:
     void cancelQuery();
 
     void onProgress(const Progress & value);
+    void onTimezoneUpdate(const String & tz);
     void onData(Block & block, ASTPtr parsed_query);
     void onLogData(Block & block);
     void onTotals(Block & block, ASTPtr parsed_query);
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index e508818a26a..ced59219a5b 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -712,7 +712,7 @@ class IColumn;
     M(Float, insert_keeper_fault_injection_probability, 0.0f, "Approximate probability of failure for a keeper request during insert. Valid value is in interval [0.0f, 1.0f]", 0) \
     M(UInt64, insert_keeper_fault_injection_seed, 0, "0 - random seed, otherwise the setting value", 0) \
     M(Bool, force_aggregation_in_order, false, "Force use of aggregation in order on remote nodes during distributed aggregation. PLEASE, NEVER CHANGE THIS SETTING VALUE MANUALLY!", IMPORTANT) \
-    M(String, timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone.", 0) \
+    M(Timezone, timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 4164bf1e27e..44369c7c8a0 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -445,6 +445,17 @@ String SettingFieldEnumHelpers::readBinary(ReadBuffer & in)
     return str;
 }
 
+void SettingFieldTimezone::writeBinary(WriteBuffer & out) const
+{
+    writeStringBinary(value, out);
+}
+
+void SettingFieldTimezone::readBinary(ReadBuffer & in)
+{
+    String str;
+    readStringBinary(str, in);
+    *this = std::move(str);
+}
 
 String SettingFieldCustom::toString() const
 {
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index c6fe46c9f6b..b580122d3db 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -2,6 +2,7 @@
 
 #include <Poco/Timespan.h>
 #include <Poco/URI.h>
+#include <cctz/time_zone.h>
 #include <base/types.h>
 #include <Core/Field.h>
 #include <Core/MultiEnum.h>
@@ -539,6 +540,43 @@ void SettingFieldMultiEnum<EnumT, Traits>::readBinary(ReadBuffer & in)
         return std::initializer_list<std::pair<const char*, NEW_NAME>> __VA_ARGS__ .size();\
     }
 
+/* Setting field for specifying user-defined timezone. It is basically a string, but it needs validation.
+ */
+struct SettingFieldTimezone
+{
+    String value;
+    bool changed = false;
+
+    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
+    explicit SettingFieldTimezone(const String & str) { validateTimezone(str); value = str; }
+    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
+    explicit SettingFieldTimezone(const char * str) { validateTimezone(str); value = str; }
+    explicit SettingFieldTimezone(const Field & f) { const String & str = f.safeGet<const String &>(); validateTimezone(str); value = str; }
+
+    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
+    SettingFieldTimezone & operator =(const String & str) { *this = std::string_view{str}; return *this; }
+    SettingFieldTimezone & operator =(String && str) { validateTimezone(str); value = std::move(str); changed = true; return *this; }
+    SettingFieldTimezone & operator =(const char * str) { *this = std::string_view{str}; return *this; }
+    SettingFieldTimezone & operator =(const Field & f) { *this = f.safeGet<const String &>(); return *this; }
+
+    operator const String &() const { return value; } /// NOLINT
+    explicit operator Field() const { return value; }
+
+    const String & toString() const { return value; }
+    void parseFromString(const String & str) { *this = str; }
+
+    void writeBinary(WriteBuffer & out) const;
+    void readBinary(ReadBuffer & in);
+
+private:
+    cctz::time_zone validated_tz;
+    void validateTimezone(const std::string & str)
+    {
+        if (str != "" && !cctz::load_time_zone(str, &validated_tz))
+            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
+    }
+};
+
 /// Can keep a value of any type. Used for user-defined settings.
 struct SettingFieldCustom
 {
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 9bb11f34916..f43982c5133 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -442,6 +442,9 @@ void TCPHandler::runImpl()
                             if (isQueryCancelled())
                                 return true;
 
+                            if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
+                                && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
+                                sendTimezone();
                             sendProgress();
                             sendSelectProfileEvents();
                             sendLogs();
@@ -483,10 +486,10 @@ void TCPHandler::runImpl()
 
             {
                 std::lock_guard lock(task_callback_mutex);
-                sendLogs();
                 if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
                     && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
                     sendTimezone();
+                sendLogs();
                 sendEndOfStream();
             }
 
@@ -1041,9 +1044,15 @@ void TCPHandler::sendInsertProfileEvents()
 
 void TCPHandler::sendTimezone()
 {
-    writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
-    writeStringBinary(DateLUT::instance().getTimeZone(), *out);
-    out->next();
+//    const String & tz = CurrentThread::get().getQueryContext()->getSettingsRef().timezone.toString();
+    const String & tz = query_context->getSettingsRef().timezone.toString();
+    if (!tz.empty())
+    {
+        LOG_DEBUG(log, "Sent timezone: {}", tz);
+        writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
+        writeStringBinary(tz, *out);
+        out->next();
+    }
 }
 
 

From e36addb96a7eaaba8f9a90383d3e77020a1a61e8 Mon Sep 17 00:00:00 2001
From: Vasily Nemkov <V.Nemkov@gmail.com>
Date: Tue, 11 Apr 2023 13:03:03 +0200
Subject: [PATCH 024/722] Hackish way of setting up timezone on the client

Warning: lots of debug logging
---
 programs/client/Client.cpp                    | 12 ++++-
 src/Client/ClientBase.cpp                     | 47 +++++++++++++++++++
 src/Functions/timezoneOf.cpp                  | 13 +++++
 src/Interpreters/Context.cpp                  |  9 ++++
 src/Server/TCPHandler.cpp                     | 21 ++++++---
 .../0_stateless/02668_timezone_setting.sql    |  8 ++--
 6 files changed, 99 insertions(+), 11 deletions(-)

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 660b8d7c00a..2aa75e60294 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -4,8 +4,10 @@
 #include <map>
 #include <iostream>
 #include <iomanip>
+#include <memory>
 #include <optional>
 #include <string_view>
+#include <Common/ThreadStatus.h>
 #include <Common/scope_guard_safe.h>
 #include <boost/program_options.hpp>
 #include <boost/algorithm/string/replace.hpp>
@@ -307,7 +309,7 @@ int Client::main(const std::vector<std::string> & /*args*/)
 try
 {
     UseSSL use_ssl;
-    MainThreadStatus::getInstance();
+    auto & thread_status = MainThreadStatus::getInstance();
     setupSignalHandler();
 
     std::cout << std::fixed << std::setprecision(3);
@@ -320,6 +322,14 @@ try
     processConfig();
     initTtyBuffer(toProgressOption(config().getString("progress", "default")));
 
+    {
+        // All that just to set DB::CurrentThread::get().getGlobalContext()
+        // which is required for client timezone (pushed as from server) to work.
+        auto thread_group = std::make_shared<ThreadGroupStatus>();
+        thread_group->global_context = global_context;
+        thread_status.attachQuery(thread_group, false);
+    }
+
     /// Includes delayed_interactive.
     if (is_interactive)
     {
diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index ca32b9b97d7..e3e0364523a 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -65,6 +65,7 @@
 #include <Storages/ColumnsDescription.h>
 
 #include <boost/algorithm/string/case_conv.hpp>
+#include <Poco/Logger.h>
 #include <iostream>
 #include <filesystem>
 #include <map>
@@ -73,11 +74,44 @@
 #include "config_version.h"
 #include "config.h"
 
+#include <Common/logger_useful.h>
+
 
 namespace fs = std::filesystem;
 using namespace std::literals;
 
 
+namespace
+{
+using namespace DB;
+using ContetGetterFunc = std::function<ContextPtr(void)> const;
+const void* getContextPtrOrNull(ContetGetterFunc contextFunc)
+{
+    try
+    {
+        return contextFunc().get();
+    }
+    catch(...)
+    {
+    }
+    return nullptr;
+}
+
+void LogContextes(const std::string_view scope, const ContextPtr global_context)
+{
+    const auto * context = global_context.get();
+    std::cerr << scope << " contextes"
+              << "\n\tglobal:    "  << reinterpret_cast<const void*>(context)
+              << "\n\tsession:   "  << getContextPtrOrNull([&]() { return context ? context->getSessionContext() : nullptr; })
+              << "\n\tquery:     "   << getContextPtrOrNull([&]() { return context ? context->getQueryContext() : nullptr; })
+              << "\n\tcurrent T query: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getQueryContext(); })
+              << "\n\tcurrent T global: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getGlobalContext(); })
+//              << "\n\tbuffer:  "   << getContextPtrOrNull(context, &Context::getBufferContext)
+              << std::endl;
+}
+
+}
+
 namespace CurrentMetrics
 {
     extern const Metric MemoryTracking;
@@ -438,7 +472,12 @@ void ClientBase::onData(Block & block, ASTPtr parsed_query)
     /// output_format, do not output it.
     /// Also do not output too much data if we're fuzzing.
     if (block.rows() == 0 || (query_fuzzer_runs != 0 && processed_rows >= 100))
+    {
+        LogContextes("ClientBase::onData header", global_context);
         return;
+    }
+
+    LogContextes("ClientBase::onData DATA block", global_context);
 
     /// If results are written INTO OUTFILE, we can avoid clearing progress to avoid flicker.
     if (need_render_progress && tty_buf && (!select_into_file || select_into_file_and_stdout))
@@ -1048,7 +1087,15 @@ void ClientBase::onProgress(const Progress & value)
 
 void ClientBase::onTimezoneUpdate(const String & tz)
 {
+    std::cerr << "ClientBase::onTimezoneUpdate received new TZ from server: " <<  tz << std::endl;
     DateLUT::setDefaultTimezone(tz);
+
+    Settings settings;
+    settings.timezone = tz;
+    global_context->applySettingsChanges(settings.changes());
+//    DB::CurrentThread::get().getQueryContext()->applySettingsChanges(settings.changes());
+
+    LogContextes("ClientBase::onTimezoneUpdate", global_context);
 }
 
 
diff --git a/src/Functions/timezoneOf.cpp b/src/Functions/timezoneOf.cpp
index 6454b1cd735..ce419b7b4cd 100644
--- a/src/Functions/timezoneOf.cpp
+++ b/src/Functions/timezoneOf.cpp
@@ -5,7 +5,11 @@
 #include <DataTypes/DataTypeDateTime.h>
 #include <Common/DateLUTImpl.h>
 #include <Core/Field.h>
+#include "Poco/Logger.h"
 
+#include <Common/logger_useful.h>
+#include <Common/CurrentThread.h>
+#include <Interpreters/Context.h>
 
 namespace DB
 {
@@ -52,6 +56,15 @@ public:
     {
         DataTypePtr type_no_nullable = removeNullable(arguments[0].type);
 
+        {
+            const auto query_context = DB::CurrentThread::get().getQueryContext();
+
+            LOG_DEBUG(&Poco::Logger::get("Function timezoneOf"), "query context: {}, timezone: {} ({})",
+                reinterpret_cast<const void*>(query_context.get()),
+                query_context->getSettingsRef().timezone.toString(),
+                (query_context->getSettingsRef().timezone.changed ? "changed" : "UNCHANGED"));
+        }
+
         return DataTypeString().createColumnConst(input_rows_count,
             dynamic_cast<const TimezoneMixin &>(*type_no_nullable).getTimeZone().getTimeZone());
     }
diff --git a/src/Interpreters/Context.cpp b/src/Interpreters/Context.cpp
index cf1d5203bf7..e27889702c5 100644
--- a/src/Interpreters/Context.cpp
+++ b/src/Interpreters/Context.cpp
@@ -118,6 +118,8 @@
 #include <rocksdb/table.h>
 #endif
 
+#include <ranges>
+
 namespace fs = std::filesystem;
 
 namespace ProfileEvents
@@ -1543,6 +1545,13 @@ void Context::applySettingChange(const SettingChange & change)
 void Context::applySettingsChanges(const SettingsChanges & changes)
 {
     auto lock = getLock();
+    LOG_DEBUG(shared->log, "Context::applySettingsChanges {} applying settings changes: {}", reinterpret_cast<const void*>(this),
+        fmt::join(std::ranges::transform_view(changes,
+        [](const SettingChange & change)
+    {
+        return change.name + ": " + change.value.dump();
+    }), ", "));
+
     for (const SettingChange & change : changes)
         applySettingChange(change);
     applySettingsQuirks(settings);
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index ef4bf81a5c1..4d5402d65d5 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -345,6 +345,7 @@ void TCPHandler::runImpl()
                 /// Send block to the client - input storage structure.
                 state.input_header = metadata_snapshot->getSampleBlock();
                 sendData(state.input_header);
+                sendTimezone();
             });
 
             query_context->setInputBlocksReaderCallback([this] (ContextPtr context) -> Block
@@ -452,9 +453,7 @@ void TCPHandler::runImpl()
                             if (isQueryCancelled())
                                 return true;
 
-                            if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
-                                && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
-                                sendTimezone();
+//                            sendTimezone();
                             sendProgress();
                             sendSelectProfileEvents();
                             sendLogs();
@@ -496,9 +495,7 @@ void TCPHandler::runImpl()
 
             {
                 std::lock_guard lock(task_callback_mutex);
-                if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
-                    && client_tcp_protocol_version >= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
-                    sendTimezone();
+//                sendTimezone();
                 sendLogs();
                 sendEndOfStream();
             }
@@ -764,7 +761,7 @@ void TCPHandler::processInsertQuery()
 
         /// Send block to the client - table structure.
         sendData(executor.getHeader());
-
+        sendTimezone();
         sendLogs();
 
         while (readDataNext())
@@ -809,6 +806,7 @@ void TCPHandler::processOrdinaryQueryWithProcessors()
         {
             std::lock_guard lock(task_callback_mutex);
             sendData(header);
+            sendTimezone();
         }
     }
 
@@ -1061,7 +1059,16 @@ void TCPHandler::sendInsertProfileEvents()
 
 void TCPHandler::sendTimezone()
 {
+//    if (client_tcp_protocol_version <= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
+//            || client_tcp_protocol_version <= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
+//        return;
+
 //    const String & tz = CurrentThread::get().getQueryContext()->getSettingsRef().timezone.toString();
+    LOG_DEBUG(log, "TCPHandler::sendTimezone() query context: {}, timezone: {} ({})",
+            reinterpret_cast<const void*>(query_context.get()),
+            query_context->getSettingsRef().timezone.toString(),
+            (query_context->getSettingsRef().timezone.changed ? "changed" : "UNCHANGED"));
+
     const String & tz = query_context->getSettingsRef().timezone.toString();
     if (!tz.empty())
     {
diff --git a/tests/queries/0_stateless/02668_timezone_setting.sql b/tests/queries/0_stateless/02668_timezone_setting.sql
index f331ab58307..d85efaa8a39 100644
--- a/tests/queries/0_stateless/02668_timezone_setting.sql
+++ b/tests/queries/0_stateless/02668_timezone_setting.sql
@@ -1,9 +1,11 @@
+SET timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
+
 SET timezone = 'Asia/Novosibirsk';
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'Europe/Zurich';
 
-SET timezone = 'Europe/Zurich';
+SET timezone = 'Asia/Manila';
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
 
-SET timezone = 'Абырвалг';
-select now(); -- { serverError POCO_EXCEPTION }
\ No newline at end of file
+SELECT timezone(), serverTimeZone(), timezoneOf(now()) SETTINGS timezone = 'Europe/Zurich';
+SELECT timezone(), serverTimeZone(), timezoneOf(now()) SETTINGS timezone = 'Pacific/Pitcairn';

From 5d18343fb8ac1b0cae8085a660b8c995b9e33ea2 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 00:15:07 +0200
Subject: [PATCH 025/722] fixed delay

---
 src/Client/ClientBase.cpp | 36 +++++++++++++++++-------------------
 src/Server/TCPHandler.cpp | 12 ++++++------
 2 files changed, 23 insertions(+), 25 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index e3e0364523a..8da4ac200d9 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -65,7 +65,7 @@
 #include <Storages/ColumnsDescription.h>
 
 #include <boost/algorithm/string/case_conv.hpp>
-#include <Poco/Logger.h>
+//#include <Poco/Logger.h>
 #include <iostream>
 #include <filesystem>
 #include <map>
@@ -74,7 +74,7 @@
 #include "config_version.h"
 #include "config.h"
 
-#include <Common/logger_useful.h>
+//#include <Common/logger_useful.h>
 
 
 namespace fs = std::filesystem;
@@ -97,18 +97,18 @@ const void* getContextPtrOrNull(ContetGetterFunc contextFunc)
     return nullptr;
 }
 
-void LogContextes(const std::string_view scope, const ContextPtr global_context)
-{
-    const auto * context = global_context.get();
-    std::cerr << scope << " contextes"
-              << "\n\tglobal:    "  << reinterpret_cast<const void*>(context)
-              << "\n\tsession:   "  << getContextPtrOrNull([&]() { return context ? context->getSessionContext() : nullptr; })
-              << "\n\tquery:     "   << getContextPtrOrNull([&]() { return context ? context->getQueryContext() : nullptr; })
-              << "\n\tcurrent T query: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getQueryContext(); })
-              << "\n\tcurrent T global: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getGlobalContext(); })
-//              << "\n\tbuffer:  "   << getContextPtrOrNull(context, &Context::getBufferContext)
-              << std::endl;
-}
+//void LogContextes(const std::string_view scope, const ContextPtr global_context)
+//{
+//    const auto * context = global_context.get();
+//    std::cerr << scope << " contextes"
+//              << "\n\tglobal:    "  << reinterpret_cast<const void*>(context)
+//              << "\n\tsession:   "  << getContextPtrOrNull([&]() { return context ? context->getSessionContext() : nullptr; })
+//              << "\n\tquery:     "   << getContextPtrOrNull([&]() { return context ? context->getQueryContext() : nullptr; })
+//              << "\n\tcurrent T query: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getQueryContext(); })
+//              << "\n\tcurrent T global: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getGlobalContext(); })
+////              << "\n\tbuffer:  "   << getContextPtrOrNull(context, &Context::getBufferContext)
+//              << std::endl;
+//}
 
 }
 
@@ -473,11 +473,11 @@ void ClientBase::onData(Block & block, ASTPtr parsed_query)
     /// Also do not output too much data if we're fuzzing.
     if (block.rows() == 0 || (query_fuzzer_runs != 0 && processed_rows >= 100))
     {
-        LogContextes("ClientBase::onData header", global_context);
+//        LogContextes("ClientBase::onData header", global_context);
         return;
     }
 
-    LogContextes("ClientBase::onData DATA block", global_context);
+//    LogContextes("ClientBase::onData DATA block", global_context);
 
     /// If results are written INTO OUTFILE, we can avoid clearing progress to avoid flicker.
     if (need_render_progress && tty_buf && (!select_into_file || select_into_file_and_stdout))
@@ -1088,14 +1088,12 @@ void ClientBase::onProgress(const Progress & value)
 void ClientBase::onTimezoneUpdate(const String & tz)
 {
     std::cerr << "ClientBase::onTimezoneUpdate received new TZ from server: " <<  tz << std::endl;
-    DateLUT::setDefaultTimezone(tz);
 
     Settings settings;
     settings.timezone = tz;
     global_context->applySettingsChanges(settings.changes());
-//    DB::CurrentThread::get().getQueryContext()->applySettingsChanges(settings.changes());
 
-    LogContextes("ClientBase::onTimezoneUpdate", global_context);
+//    LogContextes("ClientBase::onTimezoneUpdate", global_context);
 }
 
 
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 4d5402d65d5..6ff7acf025a 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -453,7 +453,7 @@ void TCPHandler::runImpl()
                             if (isQueryCancelled())
                                 return true;
 
-//                            sendTimezone();
+                            sendTimezone();
                             sendProgress();
                             sendSelectProfileEvents();
                             sendLogs();
@@ -495,7 +495,7 @@ void TCPHandler::runImpl()
 
             {
                 std::lock_guard lock(task_callback_mutex);
-//                sendTimezone();
+                sendTimezone();
                 sendLogs();
                 sendEndOfStream();
             }
@@ -1069,14 +1069,14 @@ void TCPHandler::sendTimezone()
             query_context->getSettingsRef().timezone.toString(),
             (query_context->getSettingsRef().timezone.changed ? "changed" : "UNCHANGED"));
 
-    const String & tz = query_context->getSettingsRef().timezone.toString();
-    if (!tz.empty())
-    {
+    const String & tz = CurrentThread::get().getQueryContext()->getSettingsRef().timezone.toString();
+//    if (!tz.empty())
+//    {
         LOG_DEBUG(log, "Sent timezone: {}", tz);
         writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
         writeStringBinary(tz, *out);
         out->next();
-    }
+//    }
 }
 
 

From a9499eed794731a3fed2305e4d5f0e3607815816 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 12:47:05 +0200
Subject: [PATCH 026/722] moved getting server TZ DateLUT to separate place,
 upd tests and fix

---
 programs/copier/ClusterCopierApp.cpp          |  2 +-
 programs/keeper/Keeper.cpp                    |  4 +--
 programs/obfuscator/Obfuscator.cpp            |  2 +-
 programs/server/Server.cpp                    |  4 +--
 src/Client/ClientBase.cpp                     | 26 +++++++++----------
 src/Common/DateLUT.h                          |  7 +++++
 src/Daemon/BaseDaemon.cpp                     |  2 +-
 src/Functions/serverConstants.cpp             |  2 +-
 src/Loggers/OwnPatternFormatter.h             |  2 +-
 src/Storages/MergeTree/IMergeTreeDataPart.cpp |  2 +-
 .../MergeTree/MergeFromLogEntryTask.cpp       |  2 +-
 .../MergeTree/MergeTreeDataWriter.cpp         |  6 ++---
 .../MergeTree/MergeTreeMutationEntry.cpp      |  2 +-
 src/Storages/MergeTree/MergeTreePartInfo.cpp  |  4 +--
 src/Storages/MergeTree/MergeTreePartition.cpp |  4 +--
 .../MergeTree/ReplicatedMergeTreeLogEntry.cpp |  2 +-
 .../ReplicatedMergeTreeMutationEntry.cpp      |  2 +-
 src/Storages/StorageReplicatedMergeTree.cpp   |  2 +-
 src/Storages/WindowView/StorageWindowView.cpp |  2 +-
 .../02668_timezone_setting.reference          |  3 ---
 .../0_stateless/02668_timezone_setting.sql    | 11 --------
 .../02681_timezone_setting.reference          |  5 ++++
 .../0_stateless/02681_timezone_setting.sql    | 11 ++++++++
 23 files changed, 59 insertions(+), 50 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02668_timezone_setting.reference
 delete mode 100644 tests/queries/0_stateless/02668_timezone_setting.sql
 create mode 100644 tests/queries/0_stateless/02681_timezone_setting.reference
 create mode 100644 tests/queries/0_stateless/02681_timezone_setting.sql

diff --git a/programs/copier/ClusterCopierApp.cpp b/programs/copier/ClusterCopierApp.cpp
index b2994b90e23..92657f81c2a 100644
--- a/programs/copier/ClusterCopierApp.cpp
+++ b/programs/copier/ClusterCopierApp.cpp
@@ -43,7 +43,7 @@ void ClusterCopierApp::initialize(Poco::Util::Application & self)
     time_t timestamp = Poco::Timestamp().epochTime();
     auto curr_pid = Poco::Process::id();
 
-    process_id = std::to_string(DateLUT::instance().toNumYYYYMMDDhhmmss(timestamp)) + "_" + std::to_string(curr_pid);
+    process_id = std::to_string(DateLUT::serverTimezoneInstance().toNumYYYYMMDDhhmmss(timestamp)) + "_" + std::to_string(curr_pid);
     host_id = escapeForFileName(getFQDNOrHostName()) + '#' + process_id;
     process_path = fs::weakly_canonical(fs::path(base_dir) / ("clickhouse-copier_" + process_id));
     fs::create_directories(process_path);
diff --git a/programs/keeper/Keeper.cpp b/programs/keeper/Keeper.cpp
index ed3297ed7cb..58a87057363 100644
--- a/programs/keeper/Keeper.cpp
+++ b/programs/keeper/Keeper.cpp
@@ -399,8 +399,8 @@ try
 
     /// Initialize DateLUT early, to not interfere with running time of first query.
     LOG_DEBUG(log, "Initializing DateLUT.");
-    DateLUT::instance();
-    LOG_TRACE(log, "Initialized DateLUT with time zone '{}'.", DateLUT::instance().getTimeZone());
+    DateLUT::serverTimezoneInstance();
+    LOG_TRACE(log, "Initialized DateLUT with time zone '{}'.", DateLUT::serverTimezoneInstance().getTimeZone());
 
     /// Don't want to use DNS cache
     DNSResolver::instance().setDisableCacheFlag();
diff --git a/programs/obfuscator/Obfuscator.cpp b/programs/obfuscator/Obfuscator.cpp
index 274ad29a174..9b7f2c424d3 100644
--- a/programs/obfuscator/Obfuscator.cpp
+++ b/programs/obfuscator/Obfuscator.cpp
@@ -492,7 +492,7 @@ private:
     const DateLUTImpl & date_lut;
 
 public:
-    explicit DateTimeModel(UInt64 seed_) : seed(seed_), date_lut(DateLUT::instance()) {}
+    explicit DateTimeModel(UInt64 seed_) : seed(seed_), date_lut(DateLUT::serverTimezoneInstance()) {}
 
     void train(const IColumn &) override {}
     void finalize() override {}
diff --git a/programs/server/Server.cpp b/programs/server/Server.cpp
index 711dfb3820a..23113686aa1 100644
--- a/programs/server/Server.cpp
+++ b/programs/server/Server.cpp
@@ -1041,8 +1041,8 @@ try
 
     /// Initialize DateLUT early, to not interfere with running time of first query.
     LOG_DEBUG(log, "Initializing DateLUT.");
-    DateLUT::instance();
-    LOG_TRACE(log, "Initialized DateLUT with time zone '{}'.", DateLUT::instance().getTimeZone());
+    DateLUT::serverTimezoneInstance();
+    LOG_TRACE(log, "Initialized DateLUT with time zone '{}'.", DateLUT::serverTimezoneInstance().getTimeZone());
 
     /// Storage with temporary data for processing of heavy queries.
     if (!server_settings.tmp_policy.value.empty())
diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 8da4ac200d9..7a91a382787 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -84,18 +84,18 @@ using namespace std::literals;
 namespace
 {
 using namespace DB;
-using ContetGetterFunc = std::function<ContextPtr(void)> const;
-const void* getContextPtrOrNull(ContetGetterFunc contextFunc)
-{
-    try
-    {
-        return contextFunc().get();
-    }
-    catch(...)
-    {
-    }
-    return nullptr;
-}
+//using ContetGetterFunc = std::function<ContextPtr(void)> const;
+//const void* getContextPtrOrNull(ContetGetterFunc contextFunc)
+//{
+//    try
+//    {
+//        return contextFunc().get();
+//    }
+//    catch(...)
+//    {
+//    }
+//    return nullptr;
+//}
 
 //void LogContextes(const std::string_view scope, const ContextPtr global_context)
 //{
@@ -1087,7 +1087,7 @@ void ClientBase::onProgress(const Progress & value)
 
 void ClientBase::onTimezoneUpdate(const String & tz)
 {
-    std::cerr << "ClientBase::onTimezoneUpdate received new TZ from server: " <<  tz << std::endl;
+//    std::cerr << "ClientBase::onTimezoneUpdate received new TZ from server: " <<  tz << std::endl;
 
     Settings settings;
     settings.timezone = tz;
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index f17fe772dbc..810810edb6c 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -17,6 +17,13 @@
 class DateLUT : private boost::noncopyable
 {
 public:
+    /// Return singleton DateLUTImpl instance for server's (native) time zone.
+    static ALWAYS_INLINE const DateLUTImpl & serverTimezoneInstance()
+    {
+        const auto & date_lut = getInstance();
+        return *date_lut.default_impl.load(std::memory_order_acquire);
+    }
+
     /// Return singleton DateLUTImpl instance for timezone set by `timezone` setting for current session is used.
     /// If it is not set, server's timezone (the one which server has) is being used.
     static ALWAYS_INLINE const DateLUTImpl & instance()
diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index 18c4c0d97a0..c6b5be3ea87 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -1003,7 +1003,7 @@ void BaseDaemon::shouldSetupWatchdog(char * argv0_)
 void BaseDaemon::setupWatchdog()
 {
     /// Initialize in advance to avoid double initialization in forked processes.
-    DateLUT::instance();
+    DateLUT::serverTimezoneInstance();
 
     std::string original_process_name;
     if (argv0)
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index 57a6279bd7a..5d54815818d 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -75,7 +75,7 @@ namespace
     public:
         static constexpr auto name = "serverTimezone";
         static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionServerTimezone>(context); }
-        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance("").getTimeZone()}, context->isDistributed()) {}
+        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::serverTimezoneInstance().getTimeZone()}, context->isDistributed()) {}
     };
 
 
diff --git a/src/Loggers/OwnPatternFormatter.h b/src/Loggers/OwnPatternFormatter.h
index 07d0409b0ae..8b0d11bcec1 100644
--- a/src/Loggers/OwnPatternFormatter.h
+++ b/src/Loggers/OwnPatternFormatter.h
@@ -31,6 +31,6 @@ public:
     virtual void formatExtended(const DB::ExtendedLogMessage & msg_ext, std::string & text) const;
 
 private:
-    const DateLUTImpl & server_timezone = DateLUT::instance("");
+    const DateLUTImpl & server_timezone = DateLUT::serverTimezoneInstance();
     bool color;
 };
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index 85420cabb8d..f50a7169d39 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -1030,7 +1030,7 @@ void IMergeTreeDataPart::loadPartitionAndMinMaxIndex()
         DayNum max_date;
         MergeTreePartInfo::parseMinMaxDatesFromPartName(name, min_date, max_date);
 
-        const auto & date_lut = DateLUT::instance();
+        const auto & date_lut = DateLUT::serverTimezoneInstance();
         partition = MergeTreePartition(date_lut.toNumYYYYMM(min_date));
         minmax_idx = std::make_shared<MinMaxIndex>(min_date, max_date);
     }
diff --git a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
index e017c9681e8..28e30b5f64f 100644
--- a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
@@ -57,7 +57,7 @@ ReplicatedMergeMutateTaskBase::PrepareResult MergeFromLogEntryTask::prepare()
     {
         LOG_INFO(log, "Will try to fetch part {} until '{}' because this part assigned to recompression merge. "
             "Source replica {} will try to merge this part first", entry.new_part_name,
-            DateLUT::instance().timeToString(entry.create_time + storage_settings_ptr->try_fetch_recompressed_part_timeout.totalSeconds()), entry.source_replica);
+            DateLUT::serverTimezoneInstance().timeToString(entry.create_time + storage_settings_ptr->try_fetch_recompressed_part_timeout.totalSeconds()), entry.source_replica);
             /// Waiting other replica to recompress part. No need to check it.
             return PrepareResult{
                 .prepared_successfully = false,
diff --git a/src/Storages/MergeTree/MergeTreeDataWriter.cpp b/src/Storages/MergeTree/MergeTreeDataWriter.cpp
index 37cfe4d065e..48a1cb97c89 100644
--- a/src/Storages/MergeTree/MergeTreeDataWriter.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataWriter.cpp
@@ -115,7 +115,7 @@ void updateTTL(
 
     if (const ColumnUInt16 * column_date = typeid_cast<const ColumnUInt16 *>(ttl_column.get()))
     {
-        const auto & date_lut = DateLUT::instance();
+        const auto & date_lut = DateLUT::serverTimezoneInstance();
         for (const auto & val : column_date->getData())
             ttl_info.update(date_lut.fromDayNum(DayNum(val)));
     }
@@ -128,7 +128,7 @@ void updateTTL(
     {
         if (typeid_cast<const ColumnUInt16 *>(&column_const->getDataColumn()))
         {
-            const auto & date_lut = DateLUT::instance();
+            const auto & date_lut = DateLUT::serverTimezoneInstance();
             ttl_info.update(date_lut.fromDayNum(DayNum(column_const->getValue<UInt16>())));
         }
         else if (typeid_cast<const ColumnUInt32 *>(&column_const->getDataColumn()))
@@ -369,7 +369,7 @@ MergeTreeDataWriter::TemporaryPart MergeTreeDataWriter::writeTempPartImpl(
         DayNum min_date(minmax_idx->hyperrectangle[data.minmax_idx_date_column_pos].left.get<UInt64>());
         DayNum max_date(minmax_idx->hyperrectangle[data.minmax_idx_date_column_pos].right.get<UInt64>());
 
-        const auto & date_lut = DateLUT::instance();
+        const auto & date_lut = DateLUT::serverTimezoneInstance();
 
         auto min_month = date_lut.toNumYYYYMM(min_date);
         auto max_month = date_lut.toNumYYYYMM(max_date);
diff --git a/src/Storages/MergeTree/MergeTreeMutationEntry.cpp b/src/Storages/MergeTree/MergeTreeMutationEntry.cpp
index 2e30a3f3986..2c0359b0f3f 100644
--- a/src/Storages/MergeTree/MergeTreeMutationEntry.cpp
+++ b/src/Storages/MergeTree/MergeTreeMutationEntry.cpp
@@ -127,7 +127,7 @@ MergeTreeMutationEntry::MergeTreeMutationEntry(DiskPtr disk_, const String & pat
 
     LocalDateTime create_time_dt;
     *buf >> "create time: " >> create_time_dt >> "\n";
-    create_time = DateLUT::instance().makeDateTime(
+    create_time = DateLUT::serverTimezoneInstance().makeDateTime(
         create_time_dt.year(), create_time_dt.month(), create_time_dt.day(),
         create_time_dt.hour(), create_time_dt.minute(), create_time_dt.second());
 
diff --git a/src/Storages/MergeTree/MergeTreePartInfo.cpp b/src/Storages/MergeTree/MergeTreePartInfo.cpp
index 84432a293d7..e1b52d8a7b7 100644
--- a/src/Storages/MergeTree/MergeTreePartInfo.cpp
+++ b/src/Storages/MergeTree/MergeTreePartInfo.cpp
@@ -148,7 +148,7 @@ void MergeTreePartInfo::parseMinMaxDatesFromPartName(const String & part_name, D
         throw Exception(ErrorCodes::BAD_DATA_PART_NAME, "Unexpected part name: {}", part_name);
     }
 
-    const auto & date_lut = DateLUT::instance();
+    const auto & date_lut = DateLUT::serverTimezoneInstance();
 
     min_date = date_lut.YYYYMMDDToDayNum(min_yyyymmdd);
     max_date = date_lut.YYYYMMDDToDayNum(max_yyyymmdd);
@@ -219,7 +219,7 @@ String MergeTreePartInfo::getPartNameV1() const
 
 String MergeTreePartInfo::getPartNameV0(DayNum left_date, DayNum right_date) const
 {
-    const auto & date_lut = DateLUT::instance();
+    const auto & date_lut = DateLUT::serverTimezoneInstance();
 
     /// Directory name for the part has form: `YYYYMMDD_YYYYMMDD_N_N_L`.
 
diff --git a/src/Storages/MergeTree/MergeTreePartition.cpp b/src/Storages/MergeTree/MergeTreePartition.cpp
index 3b28012e7d6..b0fc34ac2f7 100644
--- a/src/Storages/MergeTree/MergeTreePartition.cpp
+++ b/src/Storages/MergeTree/MergeTreePartition.cpp
@@ -239,7 +239,7 @@ String MergeTreePartition::getID(const Block & partition_key_sample) const
                 result += '-';
 
             if (typeid_cast<const DataTypeDate *>(partition_key_sample.getByPosition(i).type.get()))
-                result += toString(DateLUT::instance().toNumYYYYMMDD(DayNum(value[i].safeGet<UInt64>())));
+                result += toString(DateLUT::serverTimezoneInstance().toNumYYYYMMDD(DayNum(value[i].safeGet<UInt64>())));
             else if (typeid_cast<const DataTypeIPv4 *>(partition_key_sample.getByPosition(i).type.get()))
                 result += toString(value[i].get<IPv4>().toUnderType());
             else
@@ -320,7 +320,7 @@ std::optional<Row> MergeTreePartition::tryParseValueFromID(const String & partit
                     throw Exception(
                         ErrorCodes::INVALID_PARTITION_VALUE, "Cannot parse partition_id: got unexpected Date: {}", date_yyyymmdd);
 
-                UInt32 date = DateLUT::instance().YYYYMMDDToDayNum(date_yyyymmdd);
+                UInt32 date = DateLUT::serverTimezoneInstance().YYYYMMDDToDayNum(date_yyyymmdd);
                 res.emplace_back(date);
                 break;
             }
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeLogEntry.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeLogEntry.cpp
index 79b0beb0933..ac956433eab 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeLogEntry.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeLogEntry.cpp
@@ -199,7 +199,7 @@ void ReplicatedMergeTreeLogEntryData::readText(ReadBuffer & in, MergeTreeDataFor
     {
         LocalDateTime create_time_dt;
         in >> "create_time: " >> create_time_dt >> "\n";
-        create_time = DateLUT::instance().makeDateTime(
+        create_time = DateLUT::serverTimezoneInstance().makeDateTime(
             create_time_dt.year(), create_time_dt.month(), create_time_dt.day(),
             create_time_dt.hour(), create_time_dt.minute(), create_time_dt.second());
     }
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeMutationEntry.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeMutationEntry.cpp
index 1efb3f6826b..17f3637e722 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeMutationEntry.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeMutationEntry.cpp
@@ -38,7 +38,7 @@ void ReplicatedMergeTreeMutationEntry::readText(ReadBuffer & in)
 
     LocalDateTime create_time_dt;
     in >> "create time: " >> create_time_dt >> "\n";
-    create_time = DateLUT::instance().makeDateTime(
+    create_time = DateLUT::serverTimezoneInstance().makeDateTime(
         create_time_dt.year(), create_time_dt.month(), create_time_dt.day(),
         create_time_dt.hour(), create_time_dt.minute(), create_time_dt.second());
 
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index fe4a144deaa..356663496a6 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -5318,7 +5318,7 @@ String getPartNamePossiblyFake(MergeTreeDataFormatVersion format_version, const
     if (format_version < MERGE_TREE_DATA_MIN_FORMAT_VERSION_WITH_CUSTOM_PARTITIONING)
     {
         /// The date range is all month long.
-        const auto & lut = DateLUT::instance();
+        const auto & lut = DateLUT::serverTimezoneInstance();
         time_t start_time = lut.YYYYMMDDToDate(parse<UInt32>(part_info.partition_id + "01"));
         DayNum left_date = DayNum(lut.toDayNum(start_time).toUnderType());
         DayNum right_date = DayNum(static_cast<size_t>(left_date) + lut.daysInMonth(start_time) - 1);
diff --git a/src/Storages/WindowView/StorageWindowView.cpp b/src/Storages/WindowView/StorageWindowView.cpp
index 3471e4ea6bf..8546fdd3c9f 100644
--- a/src/Storages/WindowView/StorageWindowView.cpp
+++ b/src/Storages/WindowView/StorageWindowView.cpp
@@ -1335,7 +1335,7 @@ ASTPtr StorageWindowView::innerQueryParser(const ASTSelectQuery & query)
         time_zone = &DateLUT::instance(window_view_timezone);
     }
     else
-        time_zone = &DateLUT::instance();
+        time_zone = &DateLUT::serverTimezoneInstance();
 
     return result;
 }
diff --git a/tests/queries/0_stateless/02668_timezone_setting.reference b/tests/queries/0_stateless/02668_timezone_setting.reference
deleted file mode 100644
index 8ed8024f652..00000000000
--- a/tests/queries/0_stateless/02668_timezone_setting.reference
+++ /dev/null
@@ -1,3 +0,0 @@
-1999-12-12 18:23:23.123
-1999-12-12 23:23:23.123
-1999-12-13 04:23:23.123
diff --git a/tests/queries/0_stateless/02668_timezone_setting.sql b/tests/queries/0_stateless/02668_timezone_setting.sql
deleted file mode 100644
index d85efaa8a39..00000000000
--- a/tests/queries/0_stateless/02668_timezone_setting.sql
+++ /dev/null
@@ -1,11 +0,0 @@
-SET timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
-
-SET timezone = 'Asia/Novosibirsk';
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'Europe/Zurich';
-
-SET timezone = 'Asia/Manila';
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
-
-SELECT timezone(), serverTimeZone(), timezoneOf(now()) SETTINGS timezone = 'Europe/Zurich';
-SELECT timezone(), serverTimeZone(), timezoneOf(now()) SETTINGS timezone = 'Pacific/Pitcairn';
diff --git a/tests/queries/0_stateless/02681_timezone_setting.reference b/tests/queries/0_stateless/02681_timezone_setting.reference
new file mode 100644
index 00000000000..8850d77ab03
--- /dev/null
+++ b/tests/queries/0_stateless/02681_timezone_setting.reference
@@ -0,0 +1,5 @@
+2022-12-12 17:23:23.123
+2022-12-12 23:23:23.123
+2022-12-12 22:23:23.123
+Europe/Zurich	Europe/Zurich
+Pacific/Pitcairn	Pacific/Pitcairn
diff --git a/tests/queries/0_stateless/02681_timezone_setting.sql b/tests/queries/0_stateless/02681_timezone_setting.sql
new file mode 100644
index 00000000000..73afb4c029b
--- /dev/null
+++ b/tests/queries/0_stateless/02681_timezone_setting.sql
@@ -0,0 +1,11 @@
+SET timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
+
+SET timezone = 'Asia/Novosibirsk';
+SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
+SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'Europe/Zurich';
+
+SET timezone = 'Asia/Manila';
+SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
+
+SELECT timezone(), timezoneOf(now()) SETTINGS timezone = 'Europe/Zurich' FORMAT TSV;
+SELECT timezone(), timezoneOf(now()) SETTINGS timezone = 'Pacific/Pitcairn' FORMAT TSV;

From daef5d818a5cdc6e358efaa49e56d90ee530e6bf Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 15:31:58 +0200
Subject: [PATCH 027/722] fix according to updates in ThreadStatus.h

---
 programs/client/Client.cpp | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index aa563198c82..528c504e555 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -325,9 +325,8 @@ try
     {
         // All that just to set DB::CurrentThread::get().getGlobalContext()
         // which is required for client timezone (pushed as from server) to work.
-        auto thread_group = std::make_shared<ThreadGroupStatus>();
-        thread_group->global_context = global_context;
-        thread_status.attachQuery(thread_group, false);
+        auto thread_group = std::make_shared<ThreadGroup>();
+        thread_status.attachToGroup(thread_group, false);
     }
 
     /// Includes delayed_interactive.

From 3f8956f854253a5b17c6fa4163372f7e0f6cf664 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 17:45:11 +0200
Subject: [PATCH 028/722] remove additional logging

---
 src/Client/ClientBase.cpp    | 30 ------------------------------
 src/Functions/timezoneOf.cpp | 14 --------------
 src/Interpreters/Context.cpp |  8 --------
 src/Server/TCPHandler.cpp    | 24 +++++++-----------------
 4 files changed, 7 insertions(+), 69 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index d722d39e8f6..f4253ab90f6 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -66,7 +66,6 @@
 #include <Storages/ColumnsDescription.h>
 
 #include <boost/algorithm/string/case_conv.hpp>
-//#include <Poco/Logger.h>
 #include <iostream>
 #include <filesystem>
 #include <map>
@@ -75,9 +74,6 @@
 #include "config_version.h"
 #include "config.h"
 
-//#include <Common/logger_useful.h>
-
-
 namespace fs = std::filesystem;
 using namespace std::literals;
 
@@ -85,32 +81,6 @@ using namespace std::literals;
 namespace
 {
 using namespace DB;
-//using ContetGetterFunc = std::function<ContextPtr(void)> const;
-//const void* getContextPtrOrNull(ContetGetterFunc contextFunc)
-//{
-//    try
-//    {
-//        return contextFunc().get();
-//    }
-//    catch(...)
-//    {
-//    }
-//    return nullptr;
-//}
-
-//void LogContextes(const std::string_view scope, const ContextPtr global_context)
-//{
-//    const auto * context = global_context.get();
-//    std::cerr << scope << " contextes"
-//              << "\n\tglobal:    "  << reinterpret_cast<const void*>(context)
-//              << "\n\tsession:   "  << getContextPtrOrNull([&]() { return context ? context->getSessionContext() : nullptr; })
-//              << "\n\tquery:     "   << getContextPtrOrNull([&]() { return context ? context->getQueryContext() : nullptr; })
-//              << "\n\tcurrent T query: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getQueryContext(); })
-//              << "\n\tcurrent T global: "   << getContextPtrOrNull([&]() { return DB::CurrentThread::get().getGlobalContext(); })
-////              << "\n\tbuffer:  "   << getContextPtrOrNull(context, &Context::getBufferContext)
-//              << std::endl;
-//}
-
 }
 
 namespace CurrentMetrics
diff --git a/src/Functions/timezoneOf.cpp b/src/Functions/timezoneOf.cpp
index ce419b7b4cd..7a5957a5dbc 100644
--- a/src/Functions/timezoneOf.cpp
+++ b/src/Functions/timezoneOf.cpp
@@ -5,11 +5,6 @@
 #include <DataTypes/DataTypeDateTime.h>
 #include <Common/DateLUTImpl.h>
 #include <Core/Field.h>
-#include "Poco/Logger.h"
-
-#include <Common/logger_useful.h>
-#include <Common/CurrentThread.h>
-#include <Interpreters/Context.h>
 
 namespace DB
 {
@@ -56,15 +51,6 @@ public:
     {
         DataTypePtr type_no_nullable = removeNullable(arguments[0].type);
 
-        {
-            const auto query_context = DB::CurrentThread::get().getQueryContext();
-
-            LOG_DEBUG(&Poco::Logger::get("Function timezoneOf"), "query context: {}, timezone: {} ({})",
-                reinterpret_cast<const void*>(query_context.get()),
-                query_context->getSettingsRef().timezone.toString(),
-                (query_context->getSettingsRef().timezone.changed ? "changed" : "UNCHANGED"));
-        }
-
         return DataTypeString().createColumnConst(input_rows_count,
             dynamic_cast<const TimezoneMixin &>(*type_no_nullable).getTimeZone().getTimeZone());
     }
diff --git a/src/Interpreters/Context.cpp b/src/Interpreters/Context.cpp
index 9e0b1dfd032..e888902ae29 100644
--- a/src/Interpreters/Context.cpp
+++ b/src/Interpreters/Context.cpp
@@ -119,8 +119,6 @@
 #include <rocksdb/table.h>
 #endif
 
-#include <ranges>
-
 namespace fs = std::filesystem;
 
 namespace ProfileEvents
@@ -1683,12 +1681,6 @@ void Context::applySettingChange(const SettingChange & change)
 void Context::applySettingsChanges(const SettingsChanges & changes)
 {
     auto lock = getLock();
-    LOG_DEBUG(shared->log, "Context::applySettingsChanges {} applying settings changes: {}", reinterpret_cast<const void*>(this),
-        fmt::join(std::ranges::transform_view(changes,
-        [](const SettingChange & change)
-    {
-        return change.name + ": " + change.value.dump();
-    }), ", "));
 
     for (const SettingChange & change : changes)
         applySettingChange(change);
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index a48097a649f..9a1b64eaf89 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -767,7 +767,6 @@ void TCPHandler::processInsertQuery()
 
         /// Send block to the client - table structure.
         sendData(executor.getHeader());
-        sendTimezone();
         sendLogs();
 
         while (readDataNext())
@@ -1070,24 +1069,15 @@ void TCPHandler::sendInsertProfileEvents()
 
 void TCPHandler::sendTimezone()
 {
-//    if (client_tcp_protocol_version <= DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES
-//            || client_tcp_protocol_version <= DBMS_MIN_REVISION_WITH_SERVER_TIMEZONE)
-//        return;
+    if (client_tcp_protocol_version < DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES)
+        return;
 
-//    const String & tz = CurrentThread::get().getQueryContext()->getSettingsRef().timezone.toString();
-    LOG_DEBUG(log, "TCPHandler::sendTimezone() query context: {}, timezone: {} ({})",
-            reinterpret_cast<const void*>(query_context.get()),
-            query_context->getSettingsRef().timezone.toString(),
-            (query_context->getSettingsRef().timezone.changed ? "changed" : "UNCHANGED"));
+    const String & tz = query_context->getSettingsRef().timezone.toString();
 
-    const String & tz = CurrentThread::get().getQueryContext()->getSettingsRef().timezone.toString();
-//    if (!tz.empty())
-//    {
-        LOG_DEBUG(log, "Sent timezone: {}", tz);
-        writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
-        writeStringBinary(tz, *out);
-        out->next();
-//    }
+    LOG_DEBUG(log, "TCPHandler::sendTimezone(): {}", tz);
+    writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
+    writeStringBinary(tz, *out);
+    out->next();
 }
 
 

From 73675cd8d29ffd3c5e1b1a57a023ee1ac946ef8c Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 19:17:48 +0200
Subject: [PATCH 029/722] tryfix fasttest

---
 src/Server/TCPHandler.cpp | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 9a1b64eaf89..152c7aba56e 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -458,7 +458,6 @@ void TCPHandler::runImpl()
                             if (getQueryCancellationStatus() == CancellationStatus::FULLY_CANCELLED)
                                 return true;
 
-                            sendTimezone();
                             sendProgress();
                             sendSelectProfileEvents();
                             sendLogs();
@@ -811,7 +810,6 @@ void TCPHandler::processOrdinaryQueryWithProcessors()
         {
             std::lock_guard lock(task_callback_mutex);
             sendData(header);
-            sendTimezone();
         }
     }
 

From 981a73cd867c435c74adf06cece8ec279fb8fde8 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 21:20:12 +0200
Subject: [PATCH 030/722] upd remotequeryexecutor on receive timezone

---
 src/QueryPipeline/RemoteQueryExecutor.cpp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/QueryPipeline/RemoteQueryExecutor.cpp b/src/QueryPipeline/RemoteQueryExecutor.cpp
index b7490a2ad9c..23c1412dc76 100644
--- a/src/QueryPipeline/RemoteQueryExecutor.cpp
+++ b/src/QueryPipeline/RemoteQueryExecutor.cpp
@@ -449,6 +449,9 @@ RemoteQueryExecutor::ReadResult RemoteQueryExecutor::processPacket(Packet packet
                     throw Exception(ErrorCodes::SYSTEM_ERROR, "Could not push into profile queue");
             break;
 
+        case Protocol::Server::TimezoneUpdate:
+            break;
+
         default:
             got_unknown_packet_from_replica = true;
             throw Exception(
@@ -546,6 +549,9 @@ void RemoteQueryExecutor::finish(std::unique_ptr<ReadContext> * read_context)
                 if (!profile_queue->emplace(std::move(packet.block)))
                     throw Exception(ErrorCodes::SYSTEM_ERROR, "Could not push into profile queue");
             break;
+            
+        case Protocol::Server::TimezoneUpdate:
+            break;
 
         default:
             got_unknown_packet_from_replica = true;

From 0c616ac0a287ce017c18561013b87e576ac8e74b Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 21:31:13 +0200
Subject: [PATCH 031/722] fix style

---
 src/QueryPipeline/RemoteQueryExecutor.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/QueryPipeline/RemoteQueryExecutor.cpp b/src/QueryPipeline/RemoteQueryExecutor.cpp
index 23c1412dc76..56b5357c522 100644
--- a/src/QueryPipeline/RemoteQueryExecutor.cpp
+++ b/src/QueryPipeline/RemoteQueryExecutor.cpp
@@ -549,7 +549,7 @@ void RemoteQueryExecutor::finish(std::unique_ptr<ReadContext> * read_context)
                 if (!profile_queue->emplace(std::move(packet.block)))
                     throw Exception(ErrorCodes::SYSTEM_ERROR, "Could not push into profile queue");
             break;
-            
+
         case Protocol::Server::TimezoneUpdate:
             break;
 

From 1ec32d374d8872aedd2f13bfdbbb263d98feed17 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 22:27:54 +0200
Subject: [PATCH 032/722] update Timezone packet processing

---
 src/Client/HedgedConnections.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Client/HedgedConnections.cpp b/src/Client/HedgedConnections.cpp
index 13e4fe75b3d..d11954f3838 100644
--- a/src/Client/HedgedConnections.cpp
+++ b/src/Client/HedgedConnections.cpp
@@ -418,6 +418,7 @@ Packet HedgedConnections::receivePacketFromReplica(const ReplicaLocation & repli
             }
             replica_with_last_received_packet = replica_location;
             break;
+        case Protocol::Server::TimezoneUpdate:
         case Protocol::Server::PartUUIDs:
         case Protocol::Server::ProfileInfo:
         case Protocol::Server::Totals:

From 16292eb5a18d1f410421217461a7b3e44b39dbec Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 12 Apr 2023 22:54:51 +0200
Subject: [PATCH 033/722] update timezone packet handling in remote inserter

---
 src/QueryPipeline/RemoteInserter.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/QueryPipeline/RemoteInserter.cpp b/src/QueryPipeline/RemoteInserter.cpp
index b8a878b56c3..134c169e35f 100644
--- a/src/QueryPipeline/RemoteInserter.cpp
+++ b/src/QueryPipeline/RemoteInserter.cpp
@@ -130,7 +130,7 @@ void RemoteInserter::onFinish()
             break;
         else if (Protocol::Server::Exception == packet.type)
             packet.exception->rethrow();
-        else if (Protocol::Server::Log == packet.type)
+        else if (Protocol::Server::Log == packet.type || Protocol::Server::TimezoneUpdate == packet.type)
         {
             // Do nothing
         }

From bac5fbc3d2cf1b9606d66543244036797221a4b3 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 13 Apr 2023 13:26:09 +0200
Subject: [PATCH 034/722] fix error on connection drop after 1st query

---
 src/Client/ClientBase.cpp | 4 ----
 src/Client/Connection.cpp | 4 ++++
 src/Server/TCPHandler.cpp | 4 +++-
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index f4253ab90f6..2e82144e64d 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1074,13 +1074,9 @@ void ClientBase::onProgress(const Progress & value)
 
 void ClientBase::onTimezoneUpdate(const String & tz)
 {
-//    std::cerr << "ClientBase::onTimezoneUpdate received new TZ from server: " <<  tz << std::endl;
-
     Settings settings;
     settings.timezone = tz;
     global_context->applySettingsChanges(settings.changes());
-
-//    LogContextes("ClientBase::onTimezoneUpdate", global_context);
 }
 
 
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index a0025eafd64..08549265848 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -335,6 +335,10 @@ void Connection::receiveHello()
             nonce.emplace(read_nonce);
         }
     }
+    else if (packet_type == Protocol::Server::TimezoneUpdate)
+    {
+        // skip this packet at hello, will receive and process it later
+    }
     else if (packet_type == Protocol::Server::Exception)
         receiveException()->rethrow();
     else
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 152c7aba56e..a875507d227 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -183,8 +183,11 @@ void TCPHandler::runImpl()
     /// User will be authenticated here. It will also set settings from user profile into connection_context.
     try
     {
+        LOG_DEBUG(log, "Before receiveHello");
         receiveHello();
+        LOG_DEBUG(log, "Before sendHello");
         sendHello();
+        LOG_DEBUG(log, "Before receiveAddendum");
         if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_ADDENDUM)
             receiveAddendum();
 
@@ -499,7 +502,6 @@ void TCPHandler::runImpl()
 
             {
                 std::lock_guard lock(task_callback_mutex);
-                sendTimezone();
                 sendLogs();
                 sendEndOfStream();
             }

From d5ea52e4b9b4005356f79e3eaadd4d6458fa116e Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 14 Apr 2023 01:28:59 +0200
Subject: [PATCH 035/722] optimize

---
 src/Common/DateLUT.h          | 11 +++++------
 src/Core/SettingsFields.h     |  6 +++---
 src/DataTypes/TimezoneMixin.h |  2 +-
 3 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index 810810edb6c..59b280240ea 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -28,11 +28,11 @@ public:
     /// If it is not set, server's timezone (the one which server has) is being used.
     static ALWAYS_INLINE const DateLUTImpl & instance()
     {
-        std::string effective_time_zone;
         const auto & date_lut = getInstance();
 
         if (DB::CurrentThread::isInitialized())
         {
+            std::string effective_time_zone;
             const auto query_context = DB::CurrentThread::get().getQueryContext();
 
             if (query_context)
@@ -43,6 +43,8 @@ public:
                     return date_lut.getImplementation(effective_time_zone);
             }
 
+            /// Timezone is passed in query_context, but on CH-Client we have no query context,
+            /// and each time we modify client's global context
             const auto global_context = DB::CurrentThread::get().getGlobalContext();
             if (global_context)
             {
@@ -56,15 +58,12 @@ public:
         return *date_lut.default_impl.load(std::memory_order_acquire);
     }
 
-    /// Return singleton DateLUTImpl instance for a given time zone. If timezone is an empty string,
-    /// server's timezone is used. The `timezone` setting is not considered here.
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
     {
-        const auto & date_lut = getInstance();
-
         if (time_zone.empty())
-            return *date_lut.default_impl.load(std::memory_order_acquire);
+            return instance();
 
+        const auto & date_lut = getInstance();
         return date_lut.getImplementation(time_zone);
     }
 
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 8e9ffe03008..0ee3ddd4862 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -576,10 +576,10 @@ struct SettingFieldTimezone
 
 private:
     cctz::time_zone validated_tz;
-    void validateTimezone(const std::string & str)
+    void validateTimezone(const std::string & tz_str)
     {
-        if (str != "" && !cctz::load_time_zone(str, &validated_tz))
-            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
+        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
+            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
     }
 };
 
diff --git a/src/DataTypes/TimezoneMixin.h b/src/DataTypes/TimezoneMixin.h
index 5b7870c7b9a..03ecde5dd0a 100644
--- a/src/DataTypes/TimezoneMixin.h
+++ b/src/DataTypes/TimezoneMixin.h
@@ -15,7 +15,7 @@ public:
 
     explicit TimezoneMixin(const String & time_zone_name = "")
         : has_explicit_time_zone(!time_zone_name.empty())
-        , time_zone(time_zone_name.empty() ? DateLUT::instance() : DateLUT::instance(time_zone_name))
+        , time_zone(DateLUT::instance(time_zone_name))
         , utc_time_zone(DateLUT::instance("UTC"))
     {
     }

From 267bbcab007d02748af2b2b18c63de73c4fa327b Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Fri, 14 Apr 2023 00:09:57 +0300
Subject: [PATCH 036/722] Added ability to implicitly use file table function
 in clickhouse-local

---
 programs/local/LocalServer.cpp                |   3 +-
 src/Databases/DatabaseFactory.cpp             |  21 +-
 src/Databases/DatabaseFileSystem.cpp          | 132 +++++++++
 src/Databases/DatabaseFileSystem.h            |  51 ++++
 src/Databases/DatabasesOverlay.cpp            | 267 ++++++++++++++++++
 src/Databases/DatabasesOverlay.h              |  68 +++++
 ...cal_implicit_file_table_function.reference |   9 +
 ...ouse_local_implicit_file_table_function.sh |  43 +++
 8 files changed, 591 insertions(+), 3 deletions(-)
 create mode 100644 src/Databases/DatabaseFileSystem.cpp
 create mode 100644 src/Databases/DatabaseFileSystem.h
 create mode 100644 src/Databases/DatabasesOverlay.cpp
 create mode 100644 src/Databases/DatabasesOverlay.h
 create mode 100644 tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
 create mode 100755 tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 5768e744f94..566d11791ca 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -9,6 +9,7 @@
 #include <Poco/NullChannel.h>
 #include <Poco/SimpleFileChannel.h>
 #include <Databases/DatabaseMemory.h>
+#include <Databases/DatabasesOverlay.h>
 #include <Storages/System/attachSystemTables.h>
 #include <Storages/System/attachInformationSchemaTables.h>
 #include <Interpreters/DatabaseCatalog.h>
@@ -647,7 +648,7 @@ void LocalServer::processConfig()
       *  if such tables will not be dropped, clickhouse-server will not be able to load them due to security reasons.
       */
     std::string default_database = config().getString("default_database", "_local");
-    DatabaseCatalog::instance().attachDatabase(default_database, std::make_shared<DatabaseMemory>(default_database, global_context));
+    DatabaseCatalog::instance().attachDatabase(default_database, CreateClickHouseLocalDatabaseOverlay(default_database, global_context));
     global_context->setCurrentDatabase(default_database);
     applyCmdOptions(global_context);
 
diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 89a799349bf..b023bb06ad1 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -7,6 +7,7 @@
 #include <Databases/DatabaseMemory.h>
 #include <Databases/DatabaseOrdinary.h>
 #include <Databases/DatabaseReplicated.h>
+#include <Databases/DatabaseFileSystem.h>
 #include <Interpreters/Context.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Parsers/ASTCreateQuery.h>
@@ -132,13 +133,13 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
     static const std::unordered_set<std::string_view> database_engines{"Ordinary", "Atomic", "Memory",
         "Dictionary", "Lazy", "Replicated", "MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "PostgreSQL", "MaterializedPostgreSQL", "SQLite"};
+        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "FileSystem"};
 
     if (!database_engines.contains(engine_name))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Database engine name `{}` does not exist", engine_name);
 
     static const std::unordered_set<std::string_view> engines_with_arguments{"MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite"};
+        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "FileSystem"};
 
     static const std::unordered_set<std::string_view> engines_with_table_overrides{"MaterializeMySQL", "MaterializedMySQL", "MaterializedPostgreSQL"};
     bool engine_may_have_arguments = engines_with_arguments.contains(engine_name);
@@ -432,6 +433,22 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         return std::make_shared<DatabaseSQLite>(context, engine_define, create.attach, database_path);
     }
 #endif
+    else if (engine_name == "FileSystem") {
+        const ASTFunction * engine = engine_define->engine;
+
+        // If init_path is empty, then the current path from Poco will be used
+        std::string init_path;
+
+        if (engine->arguments && engine->arguments->children.size() > 0) {
+            if (engine->arguments->children.size() != 1)
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "FileSystem database requires at most 1 argument: file_system_path");
+
+            const auto & arguments = engine->arguments->children;
+            init_path = safeGetLiteralValue<String>(arguments[0], engine_name);
+        }
+
+        return std::make_shared<DatabaseFileSystem>(database_name, init_path, context);
+    }
 
     throw Exception(ErrorCodes::UNKNOWN_DATABASE_ENGINE, "Unknown database engine: {}", engine_name);
 }
diff --git a/src/Databases/DatabaseFileSystem.cpp b/src/Databases/DatabaseFileSystem.cpp
new file mode 100644
index 00000000000..9e2273970c3
--- /dev/null
+++ b/src/Databases/DatabaseFileSystem.cpp
@@ -0,0 +1,132 @@
+#include <Databases/DatabaseFileSystem.h>
+
+#include <IO/Operators.h>
+#include <IO/WriteBufferFromString.h>
+#include <Interpreters/Context.h>
+#include <Parsers/ASTCreateQuery.h>
+#include <Parsers/ASTFunction.h>
+#include <Parsers/ASTLiteral.h>
+#include <Parsers/ParserCreateQuery.h>
+#include <Parsers/parseQuery.h>
+#include <Poco/File.h>
+#include <Poco/Path.h>
+#include <Storages/IStorage.h>
+#include <TableFunctions/TableFunctionFactory.h>
+
+
+namespace DB
+{
+
+DatabaseFileSystem::DatabaseFileSystem(const String & name_, const String & path_, ContextPtr context_)
+    : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
+{
+    if (path.empty())
+        path = Poco::Path::current();
+}
+
+std::string DatabaseFileSystem::getTablePath(const std::string& table_name) const
+{
+    return Poco::Path(path, table_name).toString();
+}
+
+void DatabaseFileSystem::addTable(const std::string& table_name, StoragePtr table_storage) const
+{
+    std::lock_guard lock(mutex);
+    loaded_tables.emplace(table_name, table_storage);
+}
+
+bool DatabaseFileSystem::isTableExist(const String & name, ContextPtr) const
+{
+    {
+        std::lock_guard lock(mutex);
+        if (loaded_tables.find(name) != loaded_tables.end())
+            return true;
+    }
+
+    Poco::File table_file(getTablePath(name));
+    return table_file.exists() && table_file.isFile();
+}
+
+StoragePtr DatabaseFileSystem::tryGetTable(const String & name, ContextPtr context_) const
+{
+    // Check if the table exists in the loaded tables map
+    {
+        std::lock_guard lock(mutex);
+        auto it = loaded_tables.find(name);
+        if (it != loaded_tables.end())
+            return it->second;
+    }
+
+    auto table_path = getTablePath(name);
+
+    // If the table doesn't exist in the tables map, check if the corresponding file exists
+    Poco::File table_file(table_path);
+    if (!table_file.exists())
+        return nullptr;
+
+    // If the file exists, create a new table using TableFunctionFile and return it.
+    auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
+
+    auto table_function = TableFunctionFactory::instance().get(args, context_);
+    if (!table_function)
+        return nullptr;
+
+    auto table_storage = table_function->execute(args, context_, name);
+    if (table_storage)
+        addTable(name, table_storage);
+
+    return table_storage;
+}
+
+ASTPtr DatabaseFileSystem::getCreateDatabaseQuery() const
+{
+    auto settings = getContext()->getSettingsRef();
+    ParserCreateQuery parser;
+
+    String query = "CREATE DATABASE " + backQuoteIfNeed(getDatabaseName()) + " ENGINE = FileSystem(" + backQuoteIfNeed(path) + ")";
+    ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
+
+    if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
+    {
+        auto & ast_create_query = ast->as<ASTCreateQuery &>();
+        ast_create_query.set(ast_create_query.comment, std::make_shared<ASTLiteral>(database_comment));
+    }
+
+    return ast;
+}
+
+void DatabaseFileSystem::shutdown()
+{
+    Tables tables_snapshot;
+    {
+        std::lock_guard lock(mutex);
+        tables_snapshot = loaded_tables;
+    }
+
+    for (const auto & kv : tables_snapshot)
+    {
+        auto table_id = kv.second->getStorageID();
+        kv.second->flushAndShutdown();
+    }
+
+    std::lock_guard lock(mutex);
+    loaded_tables.clear();
+}
+
+/**
+ * Returns an empty vector because the database is read-only and no tables can be backed up.
+ */
+std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFileSystem::getTablesForBackup(const FilterByNameFunction&, const ContextPtr&) const {
+    return {};
+}
+
+/**
+ *
+ * Returns an empty iterator because the database does not have its own tables
+ * But only caches them for quick access.
+ */
+DatabaseTablesIteratorPtr DatabaseFileSystem::getTablesIterator(ContextPtr, const FilterByNameFunction&) const {
+    return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
+}
+
+} // DB
diff --git a/src/Databases/DatabaseFileSystem.h b/src/Databases/DatabaseFileSystem.h
new file mode 100644
index 00000000000..474a7e78335
--- /dev/null
+++ b/src/Databases/DatabaseFileSystem.h
@@ -0,0 +1,51 @@
+#pragma once
+
+#include <mutex>
+#include <Databases/IDatabase.h>
+#include <Parsers/IAST.h>
+#include <Storages/IStorage_fwd.h>
+#include <base/types.h>
+
+namespace DB
+{
+
+class Context;
+
+/**
+  * DatabaseFileSystem allows to interact with files stored on the file system
+  * Uses TableFunctionFile to implicitly load file when a user requests the table, and provides read-only access to the data in the file
+  * Tables are cached inside the database for quick access
+  *
+  * Used in clickhouse-local to access local files
+  */
+class DatabaseFileSystem : public IDatabase, protected WithContext
+{
+public:
+    DatabaseFileSystem(const String & name, const String & path, ContextPtr context);
+
+    String getEngineName() const override { return "FileSystem"; }
+
+    bool isTableExist(const String & name, ContextPtr context) const override;
+
+    StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
+
+    bool empty() const override { return true; }
+
+    ASTPtr getCreateDatabaseQuery() const override;
+
+    void shutdown() override;
+
+    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
+    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
+
+protected:
+    std::string getTablePath(const std::string & table_name) const;
+    void addTable(const std::string & table_name, StoragePtr table_storage) const;
+
+private:
+    String path;
+    mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
+    Poco::Logger * log;
+};
+
+} // DB
diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
new file mode 100644
index 00000000000..9c3d802df73
--- /dev/null
+++ b/src/Databases/DatabasesOverlay.cpp
@@ -0,0 +1,267 @@
+#include <Databases/DatabasesOverlay.h>
+
+#include <Interpreters/Context.h>
+#include <Interpreters/InterpreterCreateQuery.h>
+#include <Common/typeid_cast.h>
+
+#include <Databases/DatabaseMemory.h>
+#include <Databases/DatabaseFileSystem.h>
+
+#include <Storages/IStorage_fwd.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int NOT_IMPLEMENTED;
+    extern const int LOGICAL_ERROR;
+    extern const int CANNOT_GET_CREATE_TABLE_QUERY;
+}
+
+DatabasesOverlay::DatabasesOverlay(const String & name_, ContextPtr context_)
+    : IDatabase(name_), WithContext(context_->getGlobalContext()), log(&Poco::Logger::get("DatabaseOverlay(" + name_ + ")"))
+{
+}
+
+DatabasesOverlay & DatabasesOverlay::registerNextDatabase(DatabasePtr database)
+{
+    databases.push_back(std::move(database));
+    return *this;
+}
+
+bool DatabasesOverlay::isTableExist(const String & table_name, ContextPtr context_) const
+{
+    for (const auto & db : databases)
+    {
+        if (db->isTableExist(table_name, context_))
+            return true;
+    }
+    return false;
+}
+
+StoragePtr DatabasesOverlay::tryGetTable(const String & table_name, ContextPtr context_) const
+{
+    StoragePtr result = nullptr;
+    for (const auto & db : databases)
+    {
+        result = db->tryGetTable(table_name, context_);
+        if (result)
+            break;
+    }
+    return result;
+}
+
+void DatabasesOverlay::createTable(ContextPtr context_, const String & table_name, const StoragePtr & table, const ASTPtr & query)
+{
+    for (auto & db : databases)
+    {
+        try
+        {
+            db->createTable(context_, table_name, table, query);
+            return;
+        }
+        catch (...)
+        {
+            continue;
+        }
+    }
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for CREATE TABLE {} query in Database{}", table_name, getEngineName());
+}
+
+void DatabasesOverlay::dropTable(ContextPtr context_, const String & table_name, bool sync)
+{
+    for (auto & db : databases)
+    {
+        try
+        {
+            db->dropTable(context_, table_name, sync);
+            return;
+        }
+        catch (...)
+        {
+            continue;
+        }
+    }
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for DROP TABLE {} query in Database{}", table_name, getEngineName());
+}
+
+void DatabasesOverlay::attachTable(
+    ContextPtr context_, const String & table_name, const StoragePtr & table, const String & relative_table_path)
+{
+    for (auto & db : databases)
+    {
+        try
+        {
+            db->attachTable(context_, table_name, table, relative_table_path);
+            return;
+        }
+        catch (...)
+        {
+            continue;
+        }
+    }
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for ATTACH TABLE query in Database{}", getEngineName());
+}
+
+StoragePtr DatabasesOverlay::detachTable(ContextPtr context_, const String & table_name)
+{
+    StoragePtr result = nullptr;
+    for (auto & db : databases)
+    {
+        try
+        {
+            result = db->detachTable(context_, table_name);
+            if (result)
+                return result;
+        }
+        catch (...)
+        {
+            continue;
+        }
+    }
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for DETACH TABLE {} query in Database{}", table_name, getEngineName());
+}
+
+ASTPtr DatabasesOverlay::getCreateTableQueryImpl(const String & name, ContextPtr context_, bool throw_on_error) const
+{
+    ASTPtr result = nullptr;
+    for (const auto & db : databases)
+    {
+        result = db->tryGetCreateTableQuery(name, context_);
+        if (result)
+            break;
+    }
+    if (!result && throw_on_error)
+        throw Exception(ErrorCodes::CANNOT_GET_CREATE_TABLE_QUERY, "There is no metadata of table {} in Database{}", name, getEngineName());
+    return result;
+}
+
+/*
+ * DatabaseOverlay cannot be constructed by "CREATE DATABASE" query, as it is not a traditional ClickHouse database
+ * To use DatabaseOverlay, it must be constructed programmatically in code
+ */
+ASTPtr DatabasesOverlay::getCreateDatabaseQuery() const
+{
+    return std::make_shared<ASTCreateQuery>();
+}
+
+String DatabasesOverlay::getTableDataPath(const String & table_name) const
+{
+    String result;
+    for (const auto & db : databases)
+    {
+        result = db->getTableDataPath(table_name);
+        if (!result.empty())
+            break;
+    }
+    return result;
+}
+
+String DatabasesOverlay::getTableDataPath(const ASTCreateQuery & query) const
+{
+    String result;
+    for (const auto & db : databases)
+    {
+        result = db->getTableDataPath(query);
+        if (!result.empty())
+            break;
+    }
+    return result;
+}
+
+UUID DatabasesOverlay::tryGetTableUUID(const String & table_name) const
+{
+    UUID result = UUIDHelpers::Nil;
+    for (const auto & db : databases)
+    {
+        result = db->tryGetTableUUID(table_name);
+        if (result != UUIDHelpers::Nil)
+            break;
+    }
+    return result;
+}
+
+void DatabasesOverlay::drop(ContextPtr context_)
+{
+    for (auto & db : databases)
+        db->drop(context_);
+}
+
+void DatabasesOverlay::alterTable(ContextPtr local_context, const StorageID & table_id, const StorageInMemoryMetadata & metadata)
+{
+    for (auto & db : databases)
+    {
+        try
+        {
+            db->alterTable(local_context, table_id, metadata);
+            return;
+        }
+        catch (...)
+        {
+            continue;
+        }
+    }
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for alterTable in Database{}", getEngineName());
+}
+
+std::vector<std::pair<ASTPtr, StoragePtr>>
+DatabasesOverlay::getTablesForBackup(const FilterByNameFunction & filter, const ContextPtr & local_context) const
+{
+    std::vector<std::pair<ASTPtr, StoragePtr>> result;
+    for (const auto & db : databases)
+    {
+        auto dbBackup = db->getTablesForBackup(filter, local_context);
+        result.insert(result.end(), std::make_move_iterator(dbBackup.begin()), std::make_move_iterator(dbBackup.end()));
+    }
+    return result;
+}
+
+void DatabasesOverlay::createTableRestoredFromBackup(
+    const ASTPtr & create_table_query,
+    ContextMutablePtr local_context,
+    std::shared_ptr<IRestoreCoordination> /*restore_coordination*/,
+    UInt64 /*timeout_ms*/)
+{
+    /// Creates a tables by executing a "CREATE TABLE" query.
+    InterpreterCreateQuery interpreter{create_table_query, local_context};
+    interpreter.setInternal(true);
+    interpreter.execute();
+}
+
+bool DatabasesOverlay::empty() const
+{
+    for (const auto & db : databases)
+    {
+        if (!db->empty())
+            return false;
+    }
+    return true;
+}
+
+void DatabasesOverlay::shutdown()
+{
+    for (auto & db : databases)
+        db->shutdown();
+}
+
+DatabaseTablesIteratorPtr DatabasesOverlay::getTablesIterator(ContextPtr context_, const FilterByNameFunction & filter_by_table_name) const
+{
+    Tables tables;
+    for (const auto & db : databases)
+    {
+        for (auto table_it = db->getTablesIterator(context_, filter_by_table_name); table_it->isValid(); table_it->next())
+            tables.insert({table_it->name(), table_it->table()});
+    }
+    return std::make_unique<DatabaseTablesSnapshotIterator>(std::move(tables), getDatabaseName());
+}
+
+DatabasePtr CreateClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_)
+{
+    auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFileSystem>(name_, "", context_));
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
+    return databaseCombiner;
+}
+
+}
diff --git a/src/Databases/DatabasesOverlay.h b/src/Databases/DatabasesOverlay.h
new file mode 100644
index 00000000000..77f0085161b
--- /dev/null
+++ b/src/Databases/DatabasesOverlay.h
@@ -0,0 +1,68 @@
+#pragma once
+
+#include <Storages/IStorage_fwd.h>
+#include <Databases/IDatabase.h>
+
+namespace DB
+{
+
+/**
+ * Implements the IDatabase interface and combines multiple other databases
+ * Searches for tables in each database in order until found, and delegates operations to the appropriate database
+ * Useful for combining databases
+ *
+ * Used in clickhouse-local to combine DatabaseFileSystem and DatabaseMemory
+ */
+class DatabasesOverlay : public IDatabase, protected WithContext
+{
+public:
+    DatabasesOverlay(const String & name_, ContextPtr context_);
+
+    /// Not thread-safe. Use only as factory to initialize database
+    DatabasesOverlay & registerNextDatabase(DatabasePtr database);
+
+    String getEngineName() const override { return "Overlay"; }
+
+public:
+    bool isTableExist(const String & table_name, ContextPtr context) const override;
+
+    StoragePtr tryGetTable(const String & table_name, ContextPtr context) const override;
+
+    void createTable(ContextPtr context, const String & table_name, const StoragePtr & table, const ASTPtr & query) override;
+
+    void dropTable(ContextPtr context, const String & table_name, bool sync) override;
+
+    void attachTable(ContextPtr context, const String & table_name, const StoragePtr & table, const String & relative_table_path) override;
+
+    StoragePtr detachTable(ContextPtr context, const String & table_name) override;
+
+    ASTPtr getCreateTableQueryImpl(const String & name, ContextPtr context, bool throw_on_error) const override;
+    ASTPtr getCreateDatabaseQuery() const override;
+
+    String getTableDataPath(const String & table_name) const override;
+    String getTableDataPath(const ASTCreateQuery & query) const override;
+
+    UUID tryGetTableUUID(const String & table_name) const override;
+
+    void drop(ContextPtr context) override;
+
+    void alterTable(ContextPtr local_context, const StorageID & table_id, const StorageInMemoryMetadata & metadata) override;
+
+    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction & filter, const ContextPtr & local_context) const override;
+
+    void createTableRestoredFromBackup(const ASTPtr & create_table_query, ContextMutablePtr local_context, std::shared_ptr<IRestoreCoordination> restore_coordination, UInt64 timeout_ms) override;
+
+    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr context, const FilterByNameFunction & filter_by_table_name) const override;
+
+    bool empty() const override;
+
+    void shutdown() override;
+
+protected:
+    std::vector<DatabasePtr> databases;
+    Poco::Logger * log;
+};
+
+DatabasePtr CreateClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_);
+
+}
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
new file mode 100644
index 00000000000..0fcd843e737
--- /dev/null
+++ b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
@@ -0,0 +1,9 @@
+Test 1: check explicit and implicit call of the file table function
+explicit:
+4
+implicit:
+4
+Test 2: check FileSystem database
+4
+Test 3: check show database with FileSystem
+test02707
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
new file mode 100755
index 00000000000..4d8d7b1395a
--- /dev/null
+++ b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+dir=02707_clickhouse_local_tmp
+[[ -d $dir ]] && rm -r $dir
+mkdir $dir
+# Create temporary csv file for tests
+echo '"id","str","int","text"' > $dir/tmp.csv
+echo '1,"abc",123,"abacaba"' >> $dir/tmp.csv
+echo '2,"def",456,"bacabaa"' >> $dir/tmp.csv
+echo '3,"story",78912,"acabaab"' >> $dir/tmp.csv
+echo '4,"history",21321321,"cabaaba"' >> $dir/tmp.csv
+
+#################
+echo "Test 1: check explicit and implicit call of the file table function"
+
+echo "explicit:"
+$CLICKHOUSE_LOCAL -q 'SELECT COUNT(*) FROM file("02707_clickhouse_local_tmp/tmp.csv")'
+echo "implicit:"
+$CLICKHOUSE_LOCAL -q 'SELECT COUNT(*) FROM "02707_clickhouse_local_tmp/tmp.csv"'
+
+#################
+echo "Test 2: check FileSystem database"
+$CLICKHOUSE_LOCAL --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test;
+CREATE DATABASE test ENGINE = FileSystem('02707_clickhouse_local_tmp');
+SELECT COUNT(*) FROM test.\`tmp.csv\`;
+DROP DATABASE test;
+"""
+
+#################
+echo "Test 3: check show database with FileSystem"
+$CLICKHOUSE_LOCAL --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test02707;
+CREATE DATABASE test02707 ENGINE = FileSystem('02707_clickhouse_local_tmp');
+SHOW DATABASES;
+DROP DATABASE test02707;
+""" | grep "test02707"
+
+rm -r $dir
\ No newline at end of file

From 22be85d9764d6ebe3511313c9dadcbdf070c53ad Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 18 Apr 2023 02:42:30 +0200
Subject: [PATCH 037/722] renamed setting

---
 docs/en/operations/settings/settings.md       |  8 +++----
 .../functions/date-time-functions.md          |  2 +-
 docs/ru/operations/settings/settings.md       |  8 +++----
 .../functions/date-time-functions.md          |  2 +-
 src/Client/ClientBase.cpp                     |  5 +---
 src/Common/DateLUT.cpp                        |  2 +-
 src/Core/Settings.h                           |  2 +-
 src/Core/SettingsFields.cpp                   | 15 ++++++++++++
 src/Core/SettingsFields.h                     | 23 +++++++++++--------
 src/Interpreters/Context.cpp                  |  1 -
 src/Server/TCPHandler.cpp                     |  6 +----
 .../0_stateless/02681_timezone_setting.sql    | 12 +++++-----
 12 files changed, 48 insertions(+), 38 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 7caf3d4333f..dd81b07b9c0 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4008,9 +4008,9 @@ Default value: `0`.
 Use this setting only for backward compatibility if your use cases depend on old syntax.
 :::
 
-## timezone {#timezone}
+## session_timezone {#session_timezone}
 
-If specified, sets a implicit timezone (instead of server-default). All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
+If specified, sets an implicit timezone (instead of server-default). All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
 Examples:
 
 ```clickhouse
@@ -4020,13 +4020,13 @@ Europe/Berlin	Europe/Berlin
 ```
 
 ```clickhouse
-SELECT timeZone(), serverTimezone() SETTINGS timezone = 'Asia/Novosibirsk' FORMAT TSV
+SELECT timeZone(), serverTimezone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT TSV
 
 Asia/Novosibirsk	Europe/Berlin
 ```
 
 ```clickhouse
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'America/Denver' FORMAT TSV
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
 
 1999-12-13 07:23:23.123
 ```
diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index f96041996d4..c1b8d201745 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -26,7 +26,7 @@ SELECT
 
 ## timeZone
 
-Returns the default timezone of the server for current session. This can be modified using `SET timezone = 'New/Value'`
+Returns the default timezone of the server for current session. This can be modified using `SET session_timezone = 'New/Value'`
 If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise it produces a constant value.
 
 **Syntax**
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 1687e37dba2..fd4d1e11df7 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4075,9 +4075,9 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 
 Значение по умолчанию: `false`
 
-## timezone {#timezone}
+## session_timezone {#session_timezone}
 
-Задаёт значение часового пояса (timezone) по умолчанию для текущей сессии вместо часового пояса сервера. То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
+Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо часового пояса сервера. То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
 
 Примеры:
 ```clickhouse
@@ -4087,13 +4087,13 @@ Europe/Berlin	Europe/Berlin
 ```
 
 ```clickhouse
-SELECT timeZone(), serverTimezone() SETTINGS timezone = 'Asia/Novosibirsk' FORMAT TSV
+SELECT timeZone(), serverTimezone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT TSV
 
 Asia/Novosibirsk	Europe/Berlin
 ```
 
 ```clickhouse
-SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'America/Denver' FORMAT TSV
+SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
 
 1999-12-13 07:23:23.123
 ```
diff --git a/docs/ru/sql-reference/functions/date-time-functions.md b/docs/ru/sql-reference/functions/date-time-functions.md
index 132b54c1040..3e378c08308 100644
--- a/docs/ru/sql-reference/functions/date-time-functions.md
+++ b/docs/ru/sql-reference/functions/date-time-functions.md
@@ -26,7 +26,7 @@ SELECT
 
 ## timeZone {#timezone}
 
-Возвращает часовой пояс сервера, считающийся умолчанием для текущей сессии.
+Возвращает часовой пояс сервера, считающийся умолчанием для текущей сессии. Можно изменить значение с помощью `SET session_timezone = 'New/Timezone''`
 Если функция вызывается в контексте распределенной таблицы, то она генерирует обычный столбец со значениями, актуальными для каждого шарда. Иначе возвращается константа.
 
 **Синтаксис**
diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 2e82144e64d..5126777fa1e 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -451,12 +451,9 @@ void ClientBase::onData(Block & block, ASTPtr parsed_query)
     /// Also do not output too much data if we're fuzzing.
     if (block.rows() == 0 || (query_fuzzer_runs != 0 && processed_rows >= 100))
     {
-//        LogContextes("ClientBase::onData header", global_context);
         return;
     }
 
-//    LogContextes("ClientBase::onData DATA block", global_context);
-
     /// If results are written INTO OUTFILE, we can avoid clearing progress to avoid flicker.
     if (need_render_progress && tty_buf && (!select_into_file || select_into_file_and_stdout))
         progress_indication.clearProgressOutput(*tty_buf);
@@ -1075,7 +1072,7 @@ void ClientBase::onProgress(const Progress & value)
 void ClientBase::onTimezoneUpdate(const String & tz)
 {
     Settings settings;
-    settings.timezone = tz;
+    settings.session_timezone = tz;
     global_context->applySettingsChanges(settings.changes());
 }
 
diff --git a/src/Common/DateLUT.cpp b/src/Common/DateLUT.cpp
index 16bd69a20f8..f7e7df016cb 100644
--- a/src/Common/DateLUT.cpp
+++ b/src/Common/DateLUT.cpp
@@ -167,5 +167,5 @@ DateLUT & DateLUT::getInstance()
 
 std::string DateLUT::extractTimezoneFromContext(const DB::ContextPtr query_context)
 {
-    return query_context->getSettingsRef().timezone.value;
+    return query_context->getSettingsRef().session_timezone.value;
 }
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index b3e9f3fb220..837958aa5b0 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -734,7 +734,7 @@ class IColumn;
     M(Bool, keeper_map_strict_mode, false, "Enforce additional checks during operations on KeeperMap. E.g. throw an exception on an insert for already existing key", 0) \
     M(Bool, function_json_value_return_type_allow_nullable, false, "Allow function to return nullable type.", 0) \
     M(Bool, function_json_value_return_type_allow_complex, false, "Allow function to return complex type, such as: struct, array, map.", 0) \
-    M(Timezone, timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone.", 0) \
+    M(Timezone, session_timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone in current session.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index f4169aa0c64..65720056c8a 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -13,6 +13,7 @@
 
 #include <cmath>
 
+extern const char * auto_time_zones[];
 
 namespace DB
 {
@@ -26,6 +27,14 @@ namespace ErrorCodes
 
 namespace
 {
+    bool checkIsExitingTimeZone(const std::string_view timezone)
+    {
+        for (auto * it = auto_time_zones; *it; ++it)
+            if (timezone == *it)
+                return true;
+        return false;
+    }
+
     template <typename T>
     T stringToNumber(const String & str)
     {
@@ -463,6 +472,12 @@ void SettingFieldTimezone::readBinary(ReadBuffer & in)
     *this = std::move(str);
 }
 
+void SettingFieldTimezone::validateTimezone(std::string_view str)
+{
+    if (str != "" && !checkIsExitingTimeZone(str))
+        throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
+}
+
 String SettingFieldCustom::toString() const
 {
     return value.dump();
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 0ee3ddd4862..e3b18a606a1 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -2,7 +2,6 @@
 
 #include <Poco/Timespan.h>
 #include <Poco/URI.h>
-#include <cctz/time_zone.h>
 #include <base/types.h>
 #include <Core/Field.h>
 #include <Core/MultiEnum.h>
@@ -553,13 +552,16 @@ struct SettingFieldTimezone
     String value;
     bool changed = false;
 
-    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
+    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(str); value = str; }
+//    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
     explicit SettingFieldTimezone(const String & str) { validateTimezone(str); value = str; }
-    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
+//    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
+    explicit SettingFieldTimezone(String && str) { validateTimezone(str); value = std::move(str); }
     explicit SettingFieldTimezone(const char * str) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const Field & f) { const String & str = f.safeGet<const String &>(); validateTimezone(str); value = str; }
 
-    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
+//    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
+    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(str); value = str; changed = true; return *this; }
     SettingFieldTimezone & operator =(const String & str) { *this = std::string_view{str}; return *this; }
     SettingFieldTimezone & operator =(String && str) { validateTimezone(str); value = std::move(str); changed = true; return *this; }
     SettingFieldTimezone & operator =(const char * str) { *this = std::string_view{str}; return *this; }
@@ -575,12 +577,13 @@ struct SettingFieldTimezone
     void readBinary(ReadBuffer & in);
 
 private:
-    cctz::time_zone validated_tz;
-    void validateTimezone(const std::string & tz_str)
-    {
-        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
-            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
-    }
+    static void validateTimezone(std::string_view str);
+//    cctz::time_zone validated_tz;
+//    void validateTimezone(const std::string & tz_str)
+//    {
+//        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
+//            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
+//    }
 };
 
 /// Can keep a value of any type. Used for user-defined settings.
diff --git a/src/Interpreters/Context.cpp b/src/Interpreters/Context.cpp
index 82ecd87faa0..400eb570131 100644
--- a/src/Interpreters/Context.cpp
+++ b/src/Interpreters/Context.cpp
@@ -1680,7 +1680,6 @@ void Context::applySettingChange(const SettingChange & change)
 void Context::applySettingsChanges(const SettingsChanges & changes)
 {
     auto lock = getLock();
-
     for (const SettingChange & change : changes)
         applySettingChange(change);
     applySettingsQuirks(settings);
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index a875507d227..e44609529ba 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -183,11 +183,8 @@ void TCPHandler::runImpl()
     /// User will be authenticated here. It will also set settings from user profile into connection_context.
     try
     {
-        LOG_DEBUG(log, "Before receiveHello");
         receiveHello();
-        LOG_DEBUG(log, "Before sendHello");
         sendHello();
-        LOG_DEBUG(log, "Before receiveAddendum");
         if (client_tcp_protocol_version >= DBMS_MIN_PROTOCOL_VERSION_WITH_ADDENDUM)
             receiveAddendum();
 
@@ -465,7 +462,6 @@ void TCPHandler::runImpl()
                             sendSelectProfileEvents();
                             sendLogs();
 
-
                             return false;
                         };
 
@@ -1072,7 +1068,7 @@ void TCPHandler::sendTimezone()
     if (client_tcp_protocol_version < DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES)
         return;
 
-    const String & tz = query_context->getSettingsRef().timezone.toString();
+    const String & tz = query_context->getSettingsRef().session_timezone.toString();
 
     LOG_DEBUG(log, "TCPHandler::sendTimezone(): {}", tz);
     writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
diff --git a/tests/queries/0_stateless/02681_timezone_setting.sql b/tests/queries/0_stateless/02681_timezone_setting.sql
index 73afb4c029b..f66e8d2b646 100644
--- a/tests/queries/0_stateless/02681_timezone_setting.sql
+++ b/tests/queries/0_stateless/02681_timezone_setting.sql
@@ -1,11 +1,11 @@
-SET timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
+SET session_timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
 
-SET timezone = 'Asia/Novosibirsk';
+SET session_timezone = 'Asia/Novosibirsk';
 SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
-SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS timezone = 'Europe/Zurich';
+SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'Europe/Zurich';
 
-SET timezone = 'Asia/Manila';
+SET session_timezone = 'Asia/Manila';
 SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
 
-SELECT timezone(), timezoneOf(now()) SETTINGS timezone = 'Europe/Zurich' FORMAT TSV;
-SELECT timezone(), timezoneOf(now()) SETTINGS timezone = 'Pacific/Pitcairn' FORMAT TSV;
+SELECT timezone(), timezoneOf(now()) SETTINGS session_timezone = 'Europe/Zurich' FORMAT TSV;
+SELECT timezone(), timezoneOf(now()) SETTINGS session_timezone = 'Pacific/Pitcairn' FORMAT TSV;

From 0550b0640ce0020d4e4f0015447631c4b742ab13 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 18 Apr 2023 03:35:29 +0200
Subject: [PATCH 038/722] fix linking issue

---
 src/Core/SettingsFields.cpp | 15 ---------------
 src/Core/SettingsFields.h   | 23 ++++++++++-------------
 2 files changed, 10 insertions(+), 28 deletions(-)

diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 65720056c8a..f4169aa0c64 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -13,7 +13,6 @@
 
 #include <cmath>
 
-extern const char * auto_time_zones[];
 
 namespace DB
 {
@@ -27,14 +26,6 @@ namespace ErrorCodes
 
 namespace
 {
-    bool checkIsExitingTimeZone(const std::string_view timezone)
-    {
-        for (auto * it = auto_time_zones; *it; ++it)
-            if (timezone == *it)
-                return true;
-        return false;
-    }
-
     template <typename T>
     T stringToNumber(const String & str)
     {
@@ -472,12 +463,6 @@ void SettingFieldTimezone::readBinary(ReadBuffer & in)
     *this = std::move(str);
 }
 
-void SettingFieldTimezone::validateTimezone(std::string_view str)
-{
-    if (str != "" && !checkIsExitingTimeZone(str))
-        throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
-}
-
 String SettingFieldCustom::toString() const
 {
     return value.dump();
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index e3b18a606a1..0ee3ddd4862 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -2,6 +2,7 @@
 
 #include <Poco/Timespan.h>
 #include <Poco/URI.h>
+#include <cctz/time_zone.h>
 #include <base/types.h>
 #include <Core/Field.h>
 #include <Core/MultiEnum.h>
@@ -552,16 +553,13 @@ struct SettingFieldTimezone
     String value;
     bool changed = false;
 
-    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(str); value = str; }
-//    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
+    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
     explicit SettingFieldTimezone(const String & str) { validateTimezone(str); value = str; }
-//    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
-    explicit SettingFieldTimezone(String && str) { validateTimezone(str); value = std::move(str); }
+    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
     explicit SettingFieldTimezone(const char * str) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const Field & f) { const String & str = f.safeGet<const String &>(); validateTimezone(str); value = str; }
 
-//    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
-    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(str); value = str; changed = true; return *this; }
+    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
     SettingFieldTimezone & operator =(const String & str) { *this = std::string_view{str}; return *this; }
     SettingFieldTimezone & operator =(String && str) { validateTimezone(str); value = std::move(str); changed = true; return *this; }
     SettingFieldTimezone & operator =(const char * str) { *this = std::string_view{str}; return *this; }
@@ -577,13 +575,12 @@ struct SettingFieldTimezone
     void readBinary(ReadBuffer & in);
 
 private:
-    static void validateTimezone(std::string_view str);
-//    cctz::time_zone validated_tz;
-//    void validateTimezone(const std::string & tz_str)
-//    {
-//        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
-//            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
-//    }
+    cctz::time_zone validated_tz;
+    void validateTimezone(const std::string & tz_str)
+    {
+        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
+            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
+    }
 };
 
 /// Can keep a value of any type. Used for user-defined settings.

From 96553bc3d8e70d06e03191f4b848ed07c91e5c6a Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Sun, 16 Apr 2023 23:25:57 +0300
Subject: [PATCH 039/722] Fix style and tests

---
 src/Databases/DatabaseFactory.cpp             |  6 ++-
 src/Databases/DatabaseFileSystem.cpp          | 45 +++++++++++--------
 src/Databases/DatabasesOverlay.cpp            |  1 -
 ...ouse_local_implicit_file_table_function.sh | 14 +++---
 4 files changed, 38 insertions(+), 28 deletions(-)

diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index b023bb06ad1..9c13881fc7b 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -433,13 +433,15 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         return std::make_shared<DatabaseSQLite>(context, engine_define, create.attach, database_path);
     }
 #endif
-    else if (engine_name == "FileSystem") {
+    else if (engine_name == "FileSystem")
+    {
         const ASTFunction * engine = engine_define->engine;
 
         // If init_path is empty, then the current path from Poco will be used
         std::string init_path;
 
-        if (engine->arguments && engine->arguments->children.size() > 0) {
+        if (engine->arguments && !engine->arguments->children.empty())
+        {
             if (engine->arguments->children.size() != 1)
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "FileSystem database requires at most 1 argument: file_system_path");
 
diff --git a/src/Databases/DatabaseFileSystem.cpp b/src/Databases/DatabaseFileSystem.cpp
index 9e2273970c3..8b92ad8080a 100644
--- a/src/Databases/DatabaseFileSystem.cpp
+++ b/src/Databases/DatabaseFileSystem.cpp
@@ -59,23 +59,30 @@ StoragePtr DatabaseFileSystem::tryGetTable(const String & name, ContextPtr conte
 
     auto table_path = getTablePath(name);
 
-    // If the table doesn't exist in the tables map, check if the corresponding file exists
-    Poco::File table_file(table_path);
-    if (!table_file.exists())
+    try
+    {
+        // If the table doesn't exist in the tables map, check if the corresponding file exists
+        Poco::File table_file(table_path);
+        if (!table_file.exists())
+            return nullptr;
+
+        // If the file exists, create a new table using TableFunctionFile and return it.
+        auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
+
+        auto table_function = TableFunctionFactory::instance().get(args, context_);
+        if (!table_function)
+            return nullptr;
+
+        auto table_storage = table_function->execute(args, context_, name);
+        if (table_storage)
+            addTable(name, table_storage);
+
+        return table_storage;
+    }
+    catch (...)
+    {
         return nullptr;
-
-    // If the file exists, create a new table using TableFunctionFile and return it.
-    auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
-
-    auto table_function = TableFunctionFactory::instance().get(args, context_);
-    if (!table_function)
-        return nullptr;
-
-    auto table_storage = table_function->execute(args, context_, name);
-    if (table_storage)
-        addTable(name, table_storage);
-
-    return table_storage;
+    }
 }
 
 ASTPtr DatabaseFileSystem::getCreateDatabaseQuery() const
@@ -116,7 +123,8 @@ void DatabaseFileSystem::shutdown()
 /**
  * Returns an empty vector because the database is read-only and no tables can be backed up.
  */
-std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFileSystem::getTablesForBackup(const FilterByNameFunction&, const ContextPtr&) const {
+std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFileSystem::getTablesForBackup(const FilterByNameFunction&, const ContextPtr&) const
+{
     return {};
 }
 
@@ -125,7 +133,8 @@ std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFileSystem::getTablesForBacku
  * Returns an empty iterator because the database does not have its own tables
  * But only caches them for quick access.
  */
-DatabaseTablesIteratorPtr DatabaseFileSystem::getTablesIterator(ContextPtr, const FilterByNameFunction&) const {
+DatabaseTablesIteratorPtr DatabaseFileSystem::getTablesIterator(ContextPtr, const FilterByNameFunction&) const
+{
     return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
 }
 
diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
index 9c3d802df73..da26f9282a0 100644
--- a/src/Databases/DatabasesOverlay.cpp
+++ b/src/Databases/DatabasesOverlay.cpp
@@ -14,7 +14,6 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int NOT_IMPLEMENTED;
     extern const int LOGICAL_ERROR;
     extern const int CANNOT_GET_CREATE_TABLE_QUERY;
 }
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
index 4d8d7b1395a..eea1e47ba7f 100755
--- a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
+++ b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
@@ -4,8 +4,8 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CURDIR"/../shell_config.sh
 
-dir=02707_clickhouse_local_tmp
-[[ -d $dir ]] && rm -r $dir
+dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
+[[ -d $dir ]] && rm -rd $dir
 mkdir $dir
 # Create temporary csv file for tests
 echo '"id","str","int","text"' > $dir/tmp.csv
@@ -18,15 +18,15 @@ echo '4,"history",21321321,"cabaaba"' >> $dir/tmp.csv
 echo "Test 1: check explicit and implicit call of the file table function"
 
 echo "explicit:"
-$CLICKHOUSE_LOCAL -q 'SELECT COUNT(*) FROM file("02707_clickhouse_local_tmp/tmp.csv")'
+$CLICKHOUSE_LOCAL -q "SELECT COUNT(*) FROM file('${dir}/tmp.csv')"
 echo "implicit:"
-$CLICKHOUSE_LOCAL -q 'SELECT COUNT(*) FROM "02707_clickhouse_local_tmp/tmp.csv"'
+$CLICKHOUSE_LOCAL -q "SELECT COUNT(*) FROM \"${dir}/tmp.csv\""
 
 #################
 echo "Test 2: check FileSystem database"
 $CLICKHOUSE_LOCAL --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test;
-CREATE DATABASE test ENGINE = FileSystem('02707_clickhouse_local_tmp');
+CREATE DATABASE test ENGINE = FileSystem('${dir}');
 SELECT COUNT(*) FROM test.\`tmp.csv\`;
 DROP DATABASE test;
 """
@@ -35,9 +35,9 @@ DROP DATABASE test;
 echo "Test 3: check show database with FileSystem"
 $CLICKHOUSE_LOCAL --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test02707;
-CREATE DATABASE test02707 ENGINE = FileSystem('02707_clickhouse_local_tmp');
+CREATE DATABASE test02707 ENGINE = FileSystem('${dir}');
 SHOW DATABASES;
 DROP DATABASE test02707;
 """ | grep "test02707"
 
-rm -r $dir
\ No newline at end of file
+rm -rd $dir

From 1e8c0a2db9671f0862975499f16b923a49c3a2ec Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 19 Apr 2023 00:06:15 +0200
Subject: [PATCH 040/722] Lighter timezone validation

Reused external variable from src/Storages/System/StorageSystemTimeZones.generated.cpp
Required changes to CMakeLists of some standalone modules to link
properly
---
 programs/library-bridge/CMakeLists.txt  |  8 +++++++-
 programs/odbc-bridge/CMakeLists.txt     |  6 +++++-
 src/Core/SettingsFields.cpp             | 15 +++++++++++++++
 src/Core/SettingsFields.h               | 24 ++++++++++++++----------
 utils/check-marks/CMakeLists.txt        |  6 +++++-
 utils/keeper-data-dumper/CMakeLists.txt |  8 +++++++-
 utils/wal-dump/CMakeLists.txt           |  6 +++++-
 7 files changed, 58 insertions(+), 15 deletions(-)

diff --git a/programs/library-bridge/CMakeLists.txt b/programs/library-bridge/CMakeLists.txt
index 1cacc391ca5..97af7c3b22e 100644
--- a/programs/library-bridge/CMakeLists.txt
+++ b/programs/library-bridge/CMakeLists.txt
@@ -13,11 +13,17 @@ set (CLICKHOUSE_LIBRARY_BRIDGE_SOURCES
     library-bridge.cpp
 )
 
+set(CLICKHOUSE_LIBRARY_BRIDGE_EXTERNAL_SOURCES
+    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
+)
+
 if (OS_LINUX)
     set (CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--no-export-dynamic")
 endif ()
 
-clickhouse_add_executable(clickhouse-library-bridge ${CLICKHOUSE_LIBRARY_BRIDGE_SOURCES})
+clickhouse_add_executable(clickhouse-library-bridge
+                          ${CLICKHOUSE_LIBRARY_BRIDGE_SOURCES}
+                          ${CLICKHOUSE_LIBRARY_BRIDGE_EXTERNAL_SOURCES})
 
 target_link_libraries(clickhouse-library-bridge PRIVATE
     daemon
diff --git a/programs/odbc-bridge/CMakeLists.txt b/programs/odbc-bridge/CMakeLists.txt
index 118610e4dcd..bf1b42df026 100644
--- a/programs/odbc-bridge/CMakeLists.txt
+++ b/programs/odbc-bridge/CMakeLists.txt
@@ -15,13 +15,17 @@ set (CLICKHOUSE_ODBC_BRIDGE_SOURCES
     validateODBCConnectionString.cpp
 )
 
+set(ODBC_BRIDGE_EXTERNAL_SOURCES
+    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
+)
+
 if (OS_LINUX)
     # clickhouse-odbc-bridge is always a separate binary.
     # Reason: it must not export symbols from SSL, mariadb-client, etc. to not break ABI compatibility with ODBC drivers.
     set (CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--no-export-dynamic")
 endif ()
 
-clickhouse_add_executable(clickhouse-odbc-bridge ${CLICKHOUSE_ODBC_BRIDGE_SOURCES})
+clickhouse_add_executable(clickhouse-odbc-bridge ${CLICKHOUSE_ODBC_BRIDGE_SOURCES} ${ODBC_BRIDGE_EXTERNAL_SOURCES})
 
 target_link_libraries(clickhouse-odbc-bridge PRIVATE
     daemon
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index f4169aa0c64..65720056c8a 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -13,6 +13,7 @@
 
 #include <cmath>
 
+extern const char * auto_time_zones[];
 
 namespace DB
 {
@@ -26,6 +27,14 @@ namespace ErrorCodes
 
 namespace
 {
+    bool checkIsExitingTimeZone(const std::string_view timezone)
+    {
+        for (auto * it = auto_time_zones; *it; ++it)
+            if (timezone == *it)
+                return true;
+        return false;
+    }
+
     template <typename T>
     T stringToNumber(const String & str)
     {
@@ -463,6 +472,12 @@ void SettingFieldTimezone::readBinary(ReadBuffer & in)
     *this = std::move(str);
 }
 
+void SettingFieldTimezone::validateTimezone(std::string_view str)
+{
+    if (str != "" && !checkIsExitingTimeZone(str))
+        throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
+}
+
 String SettingFieldCustom::toString() const
 {
     return value.dump();
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 0ee3ddd4862..e78fef9f455 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -2,7 +2,7 @@
 
 #include <Poco/Timespan.h>
 #include <Poco/URI.h>
-#include <cctz/time_zone.h>
+//#include <cctz/time_zone.h>
 #include <base/types.h>
 #include <Core/Field.h>
 #include <Core/MultiEnum.h>
@@ -553,13 +553,16 @@ struct SettingFieldTimezone
     String value;
     bool changed = false;
 
-    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
+//    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
+    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const String & str) { validateTimezone(str); value = str; }
-    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
+//    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
+    explicit SettingFieldTimezone(String && str) { validateTimezone(str); value = std::move(str); }
     explicit SettingFieldTimezone(const char * str) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const Field & f) { const String & str = f.safeGet<const String &>(); validateTimezone(str); value = str; }
 
-    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
+//    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
+    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(str); value = str; changed = true; return *this; }
     SettingFieldTimezone & operator =(const String & str) { *this = std::string_view{str}; return *this; }
     SettingFieldTimezone & operator =(String && str) { validateTimezone(str); value = std::move(str); changed = true; return *this; }
     SettingFieldTimezone & operator =(const char * str) { *this = std::string_view{str}; return *this; }
@@ -575,12 +578,13 @@ struct SettingFieldTimezone
     void readBinary(ReadBuffer & in);
 
 private:
-    cctz::time_zone validated_tz;
-    void validateTimezone(const std::string & tz_str)
-    {
-        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
-            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
-    }
+//    cctz::time_zone validated_tz;
+//    void validateTimezone(const std::string & str)
+//    {
+//        if (!str.empty() && !cctz::load_time_zone(str, &validated_tz))
+//            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
+//    }
+    static void validateTimezone(std::string_view str);
 };
 
 /// Can keep a value of any type. Used for user-defined settings.
diff --git a/utils/check-marks/CMakeLists.txt b/utils/check-marks/CMakeLists.txt
index 05546a2989b..456fb3d7112 100644
--- a/utils/check-marks/CMakeLists.txt
+++ b/utils/check-marks/CMakeLists.txt
@@ -1,2 +1,6 @@
-clickhouse_add_executable (check-marks main.cpp)
+set(CHECK_MARKS_EXTERNAL_SOURCES
+    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
+)
+
+clickhouse_add_executable (check-marks ${CHECK_MARKS_EXTERNAL_SOURCES} main.cpp)
 target_link_libraries(check-marks PRIVATE dbms boost::program_options)
diff --git a/utils/keeper-data-dumper/CMakeLists.txt b/utils/keeper-data-dumper/CMakeLists.txt
index 1f55e50e68e..a6858a29e8b 100644
--- a/utils/keeper-data-dumper/CMakeLists.txt
+++ b/utils/keeper-data-dumper/CMakeLists.txt
@@ -1,2 +1,8 @@
-clickhouse_add_executable(keeper-data-dumper main.cpp)
+set(KEEPER_DATA_DUMPER_EXTERNAL_SOURCES
+    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
+)
+
+clickhouse_add_executable(keeper-data-dumper
+                          ${KEEPER_DATA_DUMPER_EXTERNAL_SOURCES}
+                          main.cpp)
 target_link_libraries(keeper-data-dumper PRIVATE dbms)
diff --git a/utils/wal-dump/CMakeLists.txt b/utils/wal-dump/CMakeLists.txt
index 3d59e95b4ca..754799a6faf 100644
--- a/utils/wal-dump/CMakeLists.txt
+++ b/utils/wal-dump/CMakeLists.txt
@@ -1,2 +1,6 @@
-clickhouse_add_executable (wal-dump main.cpp)
+set(WAL_DUMP_EXTERNAL_SOURCES
+    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
+)
+
+clickhouse_add_executable (wal-dump ${WAL_DUMP_EXTERNAL_SOURCES} main.cpp)
 target_link_libraries(wal-dump PRIVATE dbms boost::program_options)

From 24be7203d931b57a35241fec1abe31a9099ba096 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 19 Apr 2023 00:39:08 +0200
Subject: [PATCH 041/722] add errorcode reference

---
 src/Core/SettingsFields.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 65720056c8a..e952688a968 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -22,6 +22,7 @@ namespace ErrorCodes
     extern const int SIZE_OF_FIXED_STRING_DOESNT_MATCH;
     extern const int CANNOT_PARSE_BOOL;
     extern const int CANNOT_PARSE_NUMBER;
+    extern const int BAD_ARGUMENTS;
 }
 
 

From 542c09cb518988cf54261edbab691c459efa9a88 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 19 Apr 2023 01:35:49 +0200
Subject: [PATCH 042/722] fix keeper standalone linking

---
 programs/keeper/CMakeLists.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 761335fb707..ff2de3f581c 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -107,6 +107,8 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Daemon/GraphiteWriter.cpp
         ${CMAKE_CURRENT_BINARY_DIR}/../../src/Daemon/GitHash.generated.cpp
 
+        ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
+
         Keeper.cpp
         clickhouse-keeper.cpp
     )

From ce7dc8b123502aee8af1578d87133f8283c66a5b Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 19 Apr 2023 13:42:07 +0200
Subject: [PATCH 043/722] tidy

---
 src/Core/SettingsFields.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index e952688a968..6af38586ed8 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -475,7 +475,7 @@ void SettingFieldTimezone::readBinary(ReadBuffer & in)
 
 void SettingFieldTimezone::validateTimezone(std::string_view str)
 {
-    if (str != "" && !checkIsExitingTimeZone(str))
+    if (!str.empty() && !checkIsExitingTimeZone(str))
         throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
 }
 

From daae5025e8586156a016687672100a8ec0db6016 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 19 Apr 2023 14:45:51 +0200
Subject: [PATCH 044/722] small updates due to review

---
 docs/en/operations/settings/settings.md                | 1 +
 docs/en/sql-reference/functions/date-time-functions.md | 2 +-
 docs/ru/operations/settings/settings.md                | 1 +
 programs/client/Client.cpp                             | 2 +-
 src/Client/ClientBase.cpp                              | 5 -----
 5 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index dd81b07b9c0..2010f763c84 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4011,6 +4011,7 @@ Use this setting only for backward compatibility if your use cases depend on old
 ## session_timezone {#session_timezone}
 
 If specified, sets an implicit timezone (instead of server-default). All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
+Setting this to `''` (empty string) effectively resets implicit timezone to server timezone.
 Examples:
 
 ```clickhouse
diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index c1b8d201745..265ce676ef7 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -51,7 +51,7 @@ If it is executed in the context of a distributed table, then it generates a nor
 **Syntax**
 
 ``` sql
-timeZone()
+serverTimeZone()
 ```
 
 Alias: `ServerTimezone`, `servertimezone`.
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index fd4d1e11df7..8180f5435b8 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4078,6 +4078,7 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 ## session_timezone {#session_timezone}
 
 Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо часового пояса сервера. То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
+При значении настройки `''` (пустая строка), будет совпадать с часовым поясом сервера. 
 
 Примеры:
 ```clickhouse
diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 528c504e555..b760efc21d1 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -324,7 +324,7 @@ try
 
     {
         // All that just to set DB::CurrentThread::get().getGlobalContext()
-        // which is required for client timezone (pushed as from server) to work.
+        // which is required for client timezone (pushed from server) to work.
         auto thread_group = std::make_shared<ThreadGroup>();
         thread_status.attachToGroup(thread_group, false);
     }
diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 5126777fa1e..6df86db886b 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -78,11 +78,6 @@ namespace fs = std::filesystem;
 using namespace std::literals;
 
 
-namespace
-{
-using namespace DB;
-}
-
 namespace CurrentMetrics
 {
     extern const Metric MemoryTracking;

From 61f55930ceee99ce23cdab794ce77945f9a6ee1c Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Wed, 19 Apr 2023 15:46:17 +0300
Subject: [PATCH 045/722] Update docs/en/operations/settings/settings.md

Co-authored-by: Vasily Nemkov <V.Nemkov@gmail.com>
---
 docs/en/operations/settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 2010f763c84..366e7de8d28 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4034,7 +4034,7 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 
 Possible values:
 
--    Any valid timezone in `Region/Place` notation, e.g. `Europe/Berlin`
+-    Any timezone name from `system.time_zones`, e.g. `Europe/Berlin`, `UTC` or `Zulu`
 
 Default value: `''`.
 

From b281ceacbb4cc8f66a56b9bc12d5ab521098ce08 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 19 Apr 2023 14:47:57 +0200
Subject: [PATCH 046/722] Update docs/ru/operations/settings/settings.md

---
 docs/ru/operations/settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 8180f5435b8..f0f497b6254 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4101,6 +4101,6 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 
 Возможные значения:
 
--    Строка вида `Регион/Город`, например `Europe/Zurich`
+-    Любая зона из `system.time_zones`, например `Europe/Berlin`, `UTC` или `Zulu`
 
 Значение по умолчанию: `''`.

From b06d7355d597abdf6692b5c232fb12449d57aa5b Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Wed, 19 Apr 2023 17:39:40 +0300
Subject: [PATCH 047/722] Update src/Core/SettingsFields.h

Co-authored-by: Vasily Nemkov <V.Nemkov@gmail.com>
---
 src/Core/SettingsFields.h | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index e78fef9f455..8bd7370c980 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -2,7 +2,6 @@
 
 #include <Poco/Timespan.h>
 #include <Poco/URI.h>
-//#include <cctz/time_zone.h>
 #include <base/types.h>
 #include <Core/Field.h>
 #include <Core/MultiEnum.h>

From b81ce64fa23cf2d05edd488eeb1adbf981784a54 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Wed, 19 Apr 2023 17:39:52 +0300
Subject: [PATCH 048/722] Update src/Client/ClientBase.cpp

Co-authored-by: Vasily Nemkov <V.Nemkov@gmail.com>
---
 src/Client/ClientBase.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 6df86db886b..bd83246871b 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1531,9 +1531,9 @@ void ClientBase::receiveLogsAndProfileEvents(ASTPtr parsed_query)
 {
     auto packet_type = connection->checkPacket(0);
 
-    while (packet_type && (*packet_type == Protocol::Server::Log           ||
-                           *packet_type == Protocol::Server::ProfileEvents ||
-                           *packet_type == Protocol::Server::TimezoneUpdate))
+    while (packet_type && (*packet_type == Protocol::Server::Log
+            || *packet_type == Protocol::Server::ProfileEvents
+            || *packet_type == Protocol::Server::TimezoneUpdate))
     {
         receiveAndProcessPacket(parsed_query, false);
         packet_type = connection->checkPacket(0);

From 21d5846cabd0717184f44d98b8480fefc683e807 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Tue, 18 Apr 2023 18:12:11 +0300
Subject: [PATCH 049/722] Fix test

---
 .../02707_clickhouse_local_implicit_file_table_function.sh      | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
index eea1e47ba7f..24de0ad579c 100755
--- a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
+++ b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
@@ -7,6 +7,7 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
 [[ -d $dir ]] && rm -rd $dir
 mkdir $dir
+
 # Create temporary csv file for tests
 echo '"id","str","int","text"' > $dir/tmp.csv
 echo '1,"abc",123,"abacaba"' >> $dir/tmp.csv
@@ -40,4 +41,5 @@ SHOW DATABASES;
 DROP DATABASE test02707;
 """ | grep "test02707"
 
+# Remove temporary dir with files
 rm -rd $dir

From bf55f43e1933fdcbbc2ec85e5b0823c6a7e3eb5e Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 20 Apr 2023 02:53:42 +0200
Subject: [PATCH 050/722] update cmakelists

---
 src/CMakeLists.txt          | 5 +++++
 src/Core/SettingsFields.cpp | 4 ++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 76e5ef83e41..5ac3f6e1654 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -191,6 +191,11 @@ list (APPEND dbms_headers
     Dictionaries/DictionaryStructure.h
     Dictionaries/getDictionaryConfigurationFromAST.h)
 
+# Required for validation of Timezone in session_timezone setting.
+# This way we don't need to create timezone via cctz each time, but check against pregenerated char**
+list (APPEND dbms_sources
+        Storages/System/StorageSystemTimeZones.generated.cpp)
+
 if (NOT ENABLE_SSL)
     list (REMOVE_ITEM clickhouse_common_io_sources Common/OpenSSLHelpers.cpp)
     list (REMOVE_ITEM clickhouse_common_io_headers Common/OpenSSLHelpers.h)
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 6af38586ed8..c0556519563 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -28,7 +28,7 @@ namespace ErrorCodes
 
 namespace
 {
-    bool checkIsExitingTimeZone(const std::string_view timezone)
+    bool checkIsExistingTimeZone(const std::string_view timezone)
     {
         for (auto * it = auto_time_zones; *it; ++it)
             if (timezone == *it)
@@ -475,7 +475,7 @@ void SettingFieldTimezone::readBinary(ReadBuffer & in)
 
 void SettingFieldTimezone::validateTimezone(std::string_view str)
 {
-    if (!str.empty() && !checkIsExitingTimeZone(str))
+    if (!str.empty() && !checkIsExistingTimeZone(str))
         throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
 }
 

From f4af76ab8baee97c06cf1e53346da6107c7ccbbd Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 20 Apr 2023 11:58:51 +0200
Subject: [PATCH 051/722] cleanup cmakelists

---
 programs/library-bridge/CMakeLists.txt  | 7 +------
 programs/odbc-bridge/CMakeLists.txt     | 6 +-----
 utils/check-marks/CMakeLists.txt        | 6 +-----
 utils/keeper-data-dumper/CMakeLists.txt | 8 +-------
 utils/wal-dump/CMakeLists.txt           | 6 +-----
 5 files changed, 5 insertions(+), 28 deletions(-)

diff --git a/programs/library-bridge/CMakeLists.txt b/programs/library-bridge/CMakeLists.txt
index 97af7c3b22e..79497d5fb2e 100644
--- a/programs/library-bridge/CMakeLists.txt
+++ b/programs/library-bridge/CMakeLists.txt
@@ -13,17 +13,12 @@ set (CLICKHOUSE_LIBRARY_BRIDGE_SOURCES
     library-bridge.cpp
 )
 
-set(CLICKHOUSE_LIBRARY_BRIDGE_EXTERNAL_SOURCES
-    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
-)
-
 if (OS_LINUX)
     set (CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--no-export-dynamic")
 endif ()
 
 clickhouse_add_executable(clickhouse-library-bridge
-                          ${CLICKHOUSE_LIBRARY_BRIDGE_SOURCES}
-                          ${CLICKHOUSE_LIBRARY_BRIDGE_EXTERNAL_SOURCES})
+                          ${CLICKHOUSE_LIBRARY_BRIDGE_SOURCES})
 
 target_link_libraries(clickhouse-library-bridge PRIVATE
     daemon
diff --git a/programs/odbc-bridge/CMakeLists.txt b/programs/odbc-bridge/CMakeLists.txt
index bf1b42df026..118610e4dcd 100644
--- a/programs/odbc-bridge/CMakeLists.txt
+++ b/programs/odbc-bridge/CMakeLists.txt
@@ -15,17 +15,13 @@ set (CLICKHOUSE_ODBC_BRIDGE_SOURCES
     validateODBCConnectionString.cpp
 )
 
-set(ODBC_BRIDGE_EXTERNAL_SOURCES
-    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
-)
-
 if (OS_LINUX)
     # clickhouse-odbc-bridge is always a separate binary.
     # Reason: it must not export symbols from SSL, mariadb-client, etc. to not break ABI compatibility with ODBC drivers.
     set (CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--no-export-dynamic")
 endif ()
 
-clickhouse_add_executable(clickhouse-odbc-bridge ${CLICKHOUSE_ODBC_BRIDGE_SOURCES} ${ODBC_BRIDGE_EXTERNAL_SOURCES})
+clickhouse_add_executable(clickhouse-odbc-bridge ${CLICKHOUSE_ODBC_BRIDGE_SOURCES})
 
 target_link_libraries(clickhouse-odbc-bridge PRIVATE
     daemon
diff --git a/utils/check-marks/CMakeLists.txt b/utils/check-marks/CMakeLists.txt
index 456fb3d7112..05546a2989b 100644
--- a/utils/check-marks/CMakeLists.txt
+++ b/utils/check-marks/CMakeLists.txt
@@ -1,6 +1,2 @@
-set(CHECK_MARKS_EXTERNAL_SOURCES
-    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
-)
-
-clickhouse_add_executable (check-marks ${CHECK_MARKS_EXTERNAL_SOURCES} main.cpp)
+clickhouse_add_executable (check-marks main.cpp)
 target_link_libraries(check-marks PRIVATE dbms boost::program_options)
diff --git a/utils/keeper-data-dumper/CMakeLists.txt b/utils/keeper-data-dumper/CMakeLists.txt
index a6858a29e8b..1f55e50e68e 100644
--- a/utils/keeper-data-dumper/CMakeLists.txt
+++ b/utils/keeper-data-dumper/CMakeLists.txt
@@ -1,8 +1,2 @@
-set(KEEPER_DATA_DUMPER_EXTERNAL_SOURCES
-    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
-)
-
-clickhouse_add_executable(keeper-data-dumper
-                          ${KEEPER_DATA_DUMPER_EXTERNAL_SOURCES}
-                          main.cpp)
+clickhouse_add_executable(keeper-data-dumper main.cpp)
 target_link_libraries(keeper-data-dumper PRIVATE dbms)
diff --git a/utils/wal-dump/CMakeLists.txt b/utils/wal-dump/CMakeLists.txt
index 754799a6faf..3d59e95b4ca 100644
--- a/utils/wal-dump/CMakeLists.txt
+++ b/utils/wal-dump/CMakeLists.txt
@@ -1,6 +1,2 @@
-set(WAL_DUMP_EXTERNAL_SOURCES
-    ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
-)
-
-clickhouse_add_executable (wal-dump ${WAL_DUMP_EXTERNAL_SOURCES} main.cpp)
+clickhouse_add_executable (wal-dump main.cpp)
 target_link_libraries(wal-dump PRIVATE dbms boost::program_options)

From e37745811cd6000348655c7c42cdc25436a3090e Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 20 Apr 2023 12:04:12 +0200
Subject: [PATCH 052/722] style

---
 programs/library-bridge/CMakeLists.txt | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/programs/library-bridge/CMakeLists.txt b/programs/library-bridge/CMakeLists.txt
index 79497d5fb2e..1cacc391ca5 100644
--- a/programs/library-bridge/CMakeLists.txt
+++ b/programs/library-bridge/CMakeLists.txt
@@ -17,8 +17,7 @@ if (OS_LINUX)
     set (CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--no-export-dynamic")
 endif ()
 
-clickhouse_add_executable(clickhouse-library-bridge
-                          ${CLICKHOUSE_LIBRARY_BRIDGE_SOURCES})
+clickhouse_add_executable(clickhouse-library-bridge ${CLICKHOUSE_LIBRARY_BRIDGE_SOURCES})
 
 target_link_libraries(clickhouse-library-bridge PRIVATE
     daemon

From 2d2483d695f39fd8488e3667d77faaaa4177bd92 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Mon, 24 Apr 2023 21:50:40 +0300
Subject: [PATCH 053/722] Rename DatabaseFileSystem to DatabaseFilesystem

---
 src/Databases/DatabaseFactory.cpp             | 16 +++++++-------
 ...eFileSystem.cpp => DatabaseFilesystem.cpp} | 22 +++++++++----------
 ...abaseFileSystem.h => DatabaseFilesystem.h} |  8 +++----
 src/Databases/DatabasesOverlay.cpp            |  4 ++--
 ...cal_implicit_file_table_function.reference |  4 ++--
 ...ouse_local_implicit_file_table_function.sh |  8 +++----
 6 files changed, 31 insertions(+), 31 deletions(-)
 rename src/Databases/{DatabaseFileSystem.cpp => DatabaseFilesystem.cpp} (82%)
 rename src/Databases/{DatabaseFileSystem.h => DatabaseFilesystem.h} (83%)

diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 3356689d892..9950ab5bf45 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -3,11 +3,11 @@
 #include <filesystem>
 #include <Databases/DatabaseAtomic.h>
 #include <Databases/DatabaseDictionary.h>
+#include <Databases/DatabaseFilesystem.h>
 #include <Databases/DatabaseLazy.h>
 #include <Databases/DatabaseMemory.h>
 #include <Databases/DatabaseOrdinary.h>
 #include <Databases/DatabaseReplicated.h>
-#include <Databases/DatabaseFileSystem.h>
 #include <Interpreters/Context.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Parsers/ASTCreateQuery.h>
@@ -15,10 +15,10 @@
 #include <Parsers/ASTLiteral.h>
 #include <Parsers/queryToString.h>
 #include <Storages/NamedCollectionsHelpers.h>
-#include <Common/NamedCollections/NamedCollections.h>
-#include <Common/logger_useful.h>
 #include <Common/Macros.h>
+#include <Common/NamedCollections/NamedCollections.h>
 #include <Common/filesystemHelpers.h>
+#include <Common/logger_useful.h>
 
 #include "config.h"
 
@@ -133,13 +133,13 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
     static const std::unordered_set<std::string_view> database_engines{"Ordinary", "Atomic", "Memory",
         "Dictionary", "Lazy", "Replicated", "MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "FileSystem"};
+        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem"};
 
     if (!database_engines.contains(engine_name))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Database engine name `{}` does not exist", engine_name);
 
     static const std::unordered_set<std::string_view> engines_with_arguments{"MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "FileSystem"};
+        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem"};
 
     static const std::unordered_set<std::string_view> engines_with_table_overrides{"MaterializeMySQL", "MaterializedMySQL", "MaterializedPostgreSQL"};
     bool engine_may_have_arguments = engines_with_arguments.contains(engine_name);
@@ -433,7 +433,7 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         return std::make_shared<DatabaseSQLite>(context, engine_define, create.attach, database_path);
     }
 #endif
-    else if (engine_name == "FileSystem")
+    else if (engine_name == "Filesystem")
     {
         const ASTFunction * engine = engine_define->engine;
 
@@ -443,13 +443,13 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         if (engine->arguments && !engine->arguments->children.empty())
         {
             if (engine->arguments->children.size() != 1)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "FileSystem database requires at most 1 argument: file_system_path");
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Filesystem database requires at most 1 argument: filesystem_path");
 
             const auto & arguments = engine->arguments->children;
             init_path = safeGetLiteralValue<String>(arguments[0], engine_name);
         }
 
-        return std::make_shared<DatabaseFileSystem>(database_name, init_path, context);
+        return std::make_shared<DatabaseFilesystem>(database_name, init_path, context);
     }
 
     throw Exception(ErrorCodes::UNKNOWN_DATABASE_ENGINE, "Unknown database engine: {}", engine_name);
diff --git a/src/Databases/DatabaseFileSystem.cpp b/src/Databases/DatabaseFilesystem.cpp
similarity index 82%
rename from src/Databases/DatabaseFileSystem.cpp
rename to src/Databases/DatabaseFilesystem.cpp
index 8b92ad8080a..177b4717716 100644
--- a/src/Databases/DatabaseFileSystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -1,4 +1,4 @@
-#include <Databases/DatabaseFileSystem.h>
+#include <Databases/DatabaseFilesystem.h>
 
 #include <IO/Operators.h>
 #include <IO/WriteBufferFromString.h>
@@ -17,25 +17,25 @@
 namespace DB
 {
 
-DatabaseFileSystem::DatabaseFileSystem(const String & name_, const String & path_, ContextPtr context_)
+DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
     if (path.empty())
         path = Poco::Path::current();
 }
 
-std::string DatabaseFileSystem::getTablePath(const std::string& table_name) const
+std::string DatabaseFilesystem::getTablePath(const std::string& table_name) const
 {
     return Poco::Path(path, table_name).toString();
 }
 
-void DatabaseFileSystem::addTable(const std::string& table_name, StoragePtr table_storage) const
+void DatabaseFilesystem::addTable(const std::string& table_name, StoragePtr table_storage) const
 {
     std::lock_guard lock(mutex);
     loaded_tables.emplace(table_name, table_storage);
 }
 
-bool DatabaseFileSystem::isTableExist(const String & name, ContextPtr) const
+bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr) const
 {
     {
         std::lock_guard lock(mutex);
@@ -47,7 +47,7 @@ bool DatabaseFileSystem::isTableExist(const String & name, ContextPtr) const
     return table_file.exists() && table_file.isFile();
 }
 
-StoragePtr DatabaseFileSystem::tryGetTable(const String & name, ContextPtr context_) const
+StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const
 {
     // Check if the table exists in the loaded tables map
     {
@@ -85,12 +85,12 @@ StoragePtr DatabaseFileSystem::tryGetTable(const String & name, ContextPtr conte
     }
 }
 
-ASTPtr DatabaseFileSystem::getCreateDatabaseQuery() const
+ASTPtr DatabaseFilesystem::getCreateDatabaseQuery() const
 {
     auto settings = getContext()->getSettingsRef();
     ParserCreateQuery parser;
 
-    String query = "CREATE DATABASE " + backQuoteIfNeed(getDatabaseName()) + " ENGINE = FileSystem(" + backQuoteIfNeed(path) + ")";
+    const String query = fmt::format("CREATE DATABASE {} ENGINE = Filesystem({})", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(path));
     ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
 
     if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
@@ -102,7 +102,7 @@ ASTPtr DatabaseFileSystem::getCreateDatabaseQuery() const
     return ast;
 }
 
-void DatabaseFileSystem::shutdown()
+void DatabaseFilesystem::shutdown()
 {
     Tables tables_snapshot;
     {
@@ -123,7 +123,7 @@ void DatabaseFileSystem::shutdown()
 /**
  * Returns an empty vector because the database is read-only and no tables can be backed up.
  */
-std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFileSystem::getTablesForBackup(const FilterByNameFunction&, const ContextPtr&) const
+std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFilesystem::getTablesForBackup(const FilterByNameFunction&, const ContextPtr&) const
 {
     return {};
 }
@@ -133,7 +133,7 @@ std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFileSystem::getTablesForBacku
  * Returns an empty iterator because the database does not have its own tables
  * But only caches them for quick access.
  */
-DatabaseTablesIteratorPtr DatabaseFileSystem::getTablesIterator(ContextPtr, const FilterByNameFunction&) const
+DatabaseTablesIteratorPtr DatabaseFilesystem::getTablesIterator(ContextPtr, const FilterByNameFunction&) const
 {
     return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
 }
diff --git a/src/Databases/DatabaseFileSystem.h b/src/Databases/DatabaseFilesystem.h
similarity index 83%
rename from src/Databases/DatabaseFileSystem.h
rename to src/Databases/DatabaseFilesystem.h
index 474a7e78335..d5fdd528aa5 100644
--- a/src/Databases/DatabaseFileSystem.h
+++ b/src/Databases/DatabaseFilesystem.h
@@ -12,18 +12,18 @@ namespace DB
 class Context;
 
 /**
-  * DatabaseFileSystem allows to interact with files stored on the file system
+  * DatabaseFilesystem allows to interact with files stored on the file system
   * Uses TableFunctionFile to implicitly load file when a user requests the table, and provides read-only access to the data in the file
   * Tables are cached inside the database for quick access
   *
   * Used in clickhouse-local to access local files
   */
-class DatabaseFileSystem : public IDatabase, protected WithContext
+class DatabaseFilesystem : public IDatabase, protected WithContext
 {
 public:
-    DatabaseFileSystem(const String & name, const String & path, ContextPtr context);
+    DatabaseFilesystem(const String & name, const String & path, ContextPtr context);
 
-    String getEngineName() const override { return "FileSystem"; }
+    String getEngineName() const override { return "Filesystem"; }
 
     bool isTableExist(const String & name, ContextPtr context) const override;
 
diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
index da26f9282a0..3563fa715a6 100644
--- a/src/Databases/DatabasesOverlay.cpp
+++ b/src/Databases/DatabasesOverlay.cpp
@@ -4,8 +4,8 @@
 #include <Interpreters/InterpreterCreateQuery.h>
 #include <Common/typeid_cast.h>
 
+#include <Databases/DatabaseFilesystem.h>
 #include <Databases/DatabaseMemory.h>
-#include <Databases/DatabaseFileSystem.h>
 
 #include <Storages/IStorage_fwd.h>
 
@@ -258,7 +258,7 @@ DatabaseTablesIteratorPtr DatabasesOverlay::getTablesIterator(ContextPtr context
 DatabasePtr CreateClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_)
 {
     auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFileSystem>(name_, "", context_));
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFilesystem>(name_, "", context_));
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
     return databaseCombiner;
 }
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
index 0fcd843e737..ccc02ad4f34 100644
--- a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
+++ b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
@@ -3,7 +3,7 @@ explicit:
 4
 implicit:
 4
-Test 2: check FileSystem database
+Test 2: check Filesystem database
 4
-Test 3: check show database with FileSystem
+Test 3: check show database with Filesystem
 test02707
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
index 24de0ad579c..7c9095b3d8b 100755
--- a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
+++ b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
@@ -24,19 +24,19 @@ echo "implicit:"
 $CLICKHOUSE_LOCAL -q "SELECT COUNT(*) FROM \"${dir}/tmp.csv\""
 
 #################
-echo "Test 2: check FileSystem database"
+echo "Test 2: check Filesystem database"
 $CLICKHOUSE_LOCAL --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test;
-CREATE DATABASE test ENGINE = FileSystem('${dir}');
+CREATE DATABASE test ENGINE = Filesystem('${dir}');
 SELECT COUNT(*) FROM test.\`tmp.csv\`;
 DROP DATABASE test;
 """
 
 #################
-echo "Test 3: check show database with FileSystem"
+echo "Test 3: check show database with Filesystem"
 $CLICKHOUSE_LOCAL --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test02707;
-CREATE DATABASE test02707 ENGINE = FileSystem('${dir}');
+CREATE DATABASE test02707 ENGINE = Filesystem('${dir}');
 SHOW DATABASES;
 DROP DATABASE test02707;
 """ | grep "test02707"

From 79ca39d920fbc52e92f6bbc9496bde2cc1afec42 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Mon, 24 Apr 2023 22:26:16 +0300
Subject: [PATCH 054/722] Fixed exception messages

---
 src/Databases/DatabasesOverlay.cpp | 42 +++++++++++++++++++++++++-----
 1 file changed, 36 insertions(+), 6 deletions(-)

diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
index 3563fa715a6..c3af6d9305e 100644
--- a/src/Databases/DatabasesOverlay.cpp
+++ b/src/Databases/DatabasesOverlay.cpp
@@ -65,7 +65,12 @@ void DatabasesOverlay::createTable(ContextPtr context_, const String & table_nam
             continue;
         }
     }
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for CREATE TABLE {} query in Database{}", table_name, getEngineName());
+    throw Exception(
+        ErrorCodes::LOGICAL_ERROR,
+        "There is no databases for CREATE TABLE `{}` query in database `{}` (engine {})",
+        table_name,
+        getDatabaseName(),
+        getEngineName());
 }
 
 void DatabasesOverlay::dropTable(ContextPtr context_, const String & table_name, bool sync)
@@ -82,7 +87,12 @@ void DatabasesOverlay::dropTable(ContextPtr context_, const String & table_name,
             continue;
         }
     }
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for DROP TABLE {} query in Database{}", table_name, getEngineName());
+    throw Exception(
+        ErrorCodes::LOGICAL_ERROR,
+        "There is no databases for DROP TABLE `{}` query in database `{}` (engine {})",
+        table_name,
+        getDatabaseName(),
+        getEngineName());
 }
 
 void DatabasesOverlay::attachTable(
@@ -100,7 +110,12 @@ void DatabasesOverlay::attachTable(
             continue;
         }
     }
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for ATTACH TABLE query in Database{}", getEngineName());
+    throw Exception(
+        ErrorCodes::LOGICAL_ERROR,
+        "There is no databases for ATTACH TABLE `{}` query in database `{}` (engine {})",
+        table_name,
+        getDatabaseName(),
+        getEngineName());
 }
 
 StoragePtr DatabasesOverlay::detachTable(ContextPtr context_, const String & table_name)
@@ -119,7 +134,12 @@ StoragePtr DatabasesOverlay::detachTable(ContextPtr context_, const String & tab
             continue;
         }
     }
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for DETACH TABLE {} query in Database{}", table_name, getEngineName());
+    throw Exception(
+        ErrorCodes::LOGICAL_ERROR,
+        "There is no databases for DETACH TABLE `{}` query in database `{}` (engine {})",
+        table_name,
+        getDatabaseName(),
+        getEngineName());
 }
 
 ASTPtr DatabasesOverlay::getCreateTableQueryImpl(const String & name, ContextPtr context_, bool throw_on_error) const
@@ -132,7 +152,12 @@ ASTPtr DatabasesOverlay::getCreateTableQueryImpl(const String & name, ContextPtr
             break;
     }
     if (!result && throw_on_error)
-        throw Exception(ErrorCodes::CANNOT_GET_CREATE_TABLE_QUERY, "There is no metadata of table {} in Database{}", name, getEngineName());
+        throw Exception(
+            ErrorCodes::CANNOT_GET_CREATE_TABLE_QUERY,
+            "There is no metadata of table `{}` in database `{}` (engine {})",
+            name,
+            getDatabaseName(),
+            getEngineName());
     return result;
 }
 
@@ -201,7 +226,12 @@ void DatabasesOverlay::alterTable(ContextPtr local_context, const StorageID & ta
             continue;
         }
     }
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "There is no databases for alterTable in Database{}", getEngineName());
+    throw Exception(
+        ErrorCodes::LOGICAL_ERROR,
+        "There is no databases for ALTER TABLE `{}` query in database `{}` (engine {})",
+        table_id.table_name,
+        getDatabaseName(),
+        getEngineName());
 }
 
 std::vector<std::pair<ASTPtr, StoragePtr>>

From c9f8dd8bfd3d4123a0a7111f19d8863b19729d9a Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Mon, 24 Apr 2023 22:53:32 +0300
Subject: [PATCH 055/722] Replaced Poco::File with std::filesystem

---
 src/Databases/DatabaseFactory.cpp    |  2 +-
 src/Databases/DatabaseFilesystem.cpp | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 9950ab5bf45..8a50c31efc8 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -437,7 +437,7 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
     {
         const ASTFunction * engine = engine_define->engine;
 
-        // If init_path is empty, then the current path from Poco will be used
+        /// If init_path is empty, then the current path will be used
         std::string init_path;
 
         if (engine->arguments && !engine->arguments->children.empty())
diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 177b4717716..1decb273ae1 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -8,11 +8,12 @@
 #include <Parsers/ASTLiteral.h>
 #include <Parsers/ParserCreateQuery.h>
 #include <Parsers/parseQuery.h>
-#include <Poco/File.h>
-#include <Poco/Path.h>
 #include <Storages/IStorage.h>
 #include <TableFunctions/TableFunctionFactory.h>
 
+#include <filesystem>
+
+namespace fs = std::filesystem;
 
 namespace DB
 {
@@ -21,12 +22,12 @@ DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
     if (path.empty())
-        path = Poco::Path::current();
+        path = fs::current_path();
 }
 
 std::string DatabaseFilesystem::getTablePath(const std::string& table_name) const
 {
-    return Poco::Path(path, table_name).toString();
+    return fs::path(path) / table_name;
 }
 
 void DatabaseFilesystem::addTable(const std::string& table_name, StoragePtr table_storage) const
@@ -43,8 +44,8 @@ bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr) const
             return true;
     }
 
-    Poco::File table_file(getTablePath(name));
-    return table_file.exists() && table_file.isFile();
+    fs::path table_file_path(getTablePath(name));
+    return fs::exists(table_file_path) && fs::is_regular_file(table_file_path);
 }
 
 StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const
@@ -62,8 +63,7 @@ StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr conte
     try
     {
         // If the table doesn't exist in the tables map, check if the corresponding file exists
-        Poco::File table_file(table_path);
-        if (!table_file.exists())
+        if (!fs::exists(table_path) || !fs::is_regular_file(table_path))
             return nullptr;
 
         // If the file exists, create a new table using TableFunctionFile and return it.

From 26812f36fb73ca8a3f1c16a0db54dd4327f7dc6c Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Wed, 26 Apr 2023 01:13:29 +0300
Subject: [PATCH 056/722] Added read-only database setting; Fixed error
 messages for filesystem database; added tests

---
 src/Databases/DatabaseFilesystem.cpp          | 46 ++++++++-------
 src/Databases/DatabaseFilesystem.h            |  8 +++
 src/Databases/DatabasesOverlay.cpp            | 13 ++---
 src/Databases/IDatabase.h                     |  4 +-
 src/Interpreters/DatabaseCatalog.cpp          | 14 ++++-
 .../02722_database_filesystem.reference       | 12 ++++
 .../0_stateless/02722_database_filesystem.sh  | 58 +++++++++++++++++++
 7 files changed, 124 insertions(+), 31 deletions(-)
 create mode 100644 tests/queries/0_stateless/02722_database_filesystem.reference
 create mode 100755 tests/queries/0_stateless/02722_database_filesystem.sh

diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 1decb273ae1..106885e7c3e 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -21,8 +21,7 @@ namespace DB
 DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
-    if (path.empty())
-        path = fs::current_path();
+    path = fs::path(path).lexically_normal().string();
 }
 
 std::string DatabaseFilesystem::getTablePath(const std::string& table_name) const
@@ -48,7 +47,7 @@ bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr) const
     return fs::exists(table_file_path) && fs::is_regular_file(table_file_path);
 }
 
-StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const
+StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr context_) const
 {
     // Check if the table exists in the loaded tables map
     {
@@ -60,24 +59,31 @@ StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr conte
 
     auto table_path = getTablePath(name);
 
+    // If the file exists, create a new table using TableFunctionFile and return it.
+    auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
+
+    auto table_function = TableFunctionFactory::instance().get(args, context_);
+    if (!table_function)
+        return nullptr;
+
+    auto table_storage = table_function->execute(args, context_, name);
+    if (table_storage)
+        addTable(name, table_storage);
+
+    return table_storage;
+}
+
+StoragePtr DatabaseFilesystem::getTable(const String & name, ContextPtr context_) const
+{
+    if (auto storage = getTableImpl(name, context_))
+        return storage;
+    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
+}
+
+StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const {
     try
     {
-        // If the table doesn't exist in the tables map, check if the corresponding file exists
-        if (!fs::exists(table_path) || !fs::is_regular_file(table_path))
-            return nullptr;
-
-        // If the file exists, create a new table using TableFunctionFile and return it.
-        auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
-
-        auto table_function = TableFunctionFactory::instance().get(args, context_);
-        if (!table_function)
-            return nullptr;
-
-        auto table_storage = table_function->execute(args, context_, name);
-        if (table_storage)
-            addTable(name, table_storage);
-
-        return table_storage;
+        return getTable(name, context_);
     }
     catch (...)
     {
@@ -90,7 +96,7 @@ ASTPtr DatabaseFilesystem::getCreateDatabaseQuery() const
     auto settings = getContext()->getSettingsRef();
     ParserCreateQuery parser;
 
-    const String query = fmt::format("CREATE DATABASE {} ENGINE = Filesystem({})", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(path));
+    const String query = fmt::format("CREATE DATABASE {} ENGINE = Filesystem('{}')", backQuoteIfNeed(getDatabaseName()), path);
     ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
 
     if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
diff --git a/src/Databases/DatabaseFilesystem.h b/src/Databases/DatabaseFilesystem.h
index d5fdd528aa5..697511ac5b3 100644
--- a/src/Databases/DatabaseFilesystem.h
+++ b/src/Databases/DatabaseFilesystem.h
@@ -27,10 +27,14 @@ public:
 
     bool isTableExist(const String & name, ContextPtr context) const override;
 
+    StoragePtr getTable(const String & name, ContextPtr context) const override;
+
     StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
 
     bool empty() const override { return true; }
 
+    bool isReadOnly() const override { return true; }
+
     ASTPtr getCreateDatabaseQuery() const override;
 
     void shutdown() override;
@@ -39,9 +43,13 @@ public:
     DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
 
 protected:
+    StoragePtr getTableImpl(const String & name, ContextPtr context) const;
+
     std::string getTablePath(const std::string & table_name) const;
+
     void addTable(const std::string & table_name, StoragePtr table_storage) const;
 
+
 private:
     String path;
     mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
index c3af6d9305e..5a6a4fe5cc6 100644
--- a/src/Databases/DatabasesOverlay.cpp
+++ b/src/Databases/DatabasesOverlay.cpp
@@ -55,15 +55,11 @@ void DatabasesOverlay::createTable(ContextPtr context_, const String & table_nam
 {
     for (auto & db : databases)
     {
-        try
+        if (!db->isReadOnly())
         {
             db->createTable(context_, table_name, table, query);
             return;
         }
-        catch (...)
-        {
-            continue;
-        }
     }
     throw Exception(
         ErrorCodes::LOGICAL_ERROR,
@@ -218,8 +214,11 @@ void DatabasesOverlay::alterTable(ContextPtr local_context, const StorageID & ta
     {
         try
         {
-            db->alterTable(local_context, table_id, metadata);
-            return;
+            if (!db->isReadOnly())
+            {
+                db->alterTable(local_context, table_id, metadata);
+                return;
+            }
         }
         catch (...)
         {
diff --git a/src/Databases/IDatabase.h b/src/Databases/IDatabase.h
index 53a2f372814..6508e2ce060 100644
--- a/src/Databases/IDatabase.h
+++ b/src/Databases/IDatabase.h
@@ -170,7 +170,7 @@ public:
     /// Get the table for work. Return nullptr if there is no table.
     virtual StoragePtr tryGetTable(const String & name, ContextPtr context) const = 0;
 
-    StoragePtr getTable(const String & name, ContextPtr context) const;
+    virtual StoragePtr getTable(const String & name, ContextPtr context) const;
 
     virtual UUID tryGetTableUUID(const String & /*table_name*/) const { return UUIDHelpers::Nil; }
 
@@ -183,6 +183,8 @@ public:
     /// Is the database empty.
     virtual bool empty() const = 0;
 
+    virtual bool isReadOnly() const { return false; }
+
     /// Add the table to the database. Record its presence in the metadata.
     virtual void createTable(
         ContextPtr /*context*/,
diff --git a/src/Interpreters/DatabaseCatalog.cpp b/src/Interpreters/DatabaseCatalog.cpp
index 8d3fa91a7fe..f9e74fadcbd 100644
--- a/src/Interpreters/DatabaseCatalog.cpp
+++ b/src/Interpreters/DatabaseCatalog.cpp
@@ -338,9 +338,17 @@ DatabaseAndTable DatabaseCatalog::getTableImpl(
         database = it->second;
     }
 
-    auto table = database->tryGetTable(table_id.table_name, context_);
-    if (!table && exception)
-            exception->emplace(Exception(ErrorCodes::UNKNOWN_TABLE, "Table {} doesn't exist", table_id.getNameForLogs()));
+    StoragePtr table = nullptr;
+    try
+    {
+        table = database->getTable(table_id.table_name, context_);
+    }
+    catch (const Exception & e)
+    {
+        if (exception)
+            exception->emplace(*e.clone());
+    }
+
     if (!table)
         database = nullptr;
 
diff --git a/tests/queries/0_stateless/02722_database_filesystem.reference b/tests/queries/0_stateless/02722_database_filesystem.reference
new file mode 100644
index 00000000000..a583f1e2e3c
--- /dev/null
+++ b/tests/queries/0_stateless/02722_database_filesystem.reference
@@ -0,0 +1,12 @@
+Test 1: create filesystem database and check implicit calls
+0
+test1
+4
+4
+4
+Test 2: check DatabaseFilesystem access rights on server
+OK
+OK
+OK
+OK
+OK
diff --git a/tests/queries/0_stateless/02722_database_filesystem.sh b/tests/queries/0_stateless/02722_database_filesystem.sh
new file mode 100755
index 00000000000..0adeface438
--- /dev/null
+++ b/tests/queries/0_stateless/02722_database_filesystem.sh
@@ -0,0 +1,58 @@
+#!/usr/bin/env bash
+# Tags: no-parallel
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+# see 01658_read_file_to_stringcolumn.sh
+CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from file('nonexist.txt', 'CSV', 'val1 char')" 2>&1 | grep Exception | awk '{gsub("/nonexist.txt","",$9); print $9}')
+
+# Prepare data
+mkdir -p ${CLICKHOUSE_USER_FILES_PATH}/tmp/
+echo '"id","str","int","text"' > ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '1,"abc",123,"abacaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '2,"def",456,"bacabaa"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '3,"story",78912,"acabaab"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '4,"history",21321321,"cabaaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+
+tmp_dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
+[[ -d $tmp_dir ]] && rm -rd $tmp_dir
+mkdir $tmp_dir
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${tmp_dir}/tmp.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp/tmp.csv
+
+#################
+echo "Test 1: create filesystem database and check implicit calls"
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test1;
+CREATE DATABASE test1 ENGINE = Filesystem;
+"""
+echo $?
+${CLICKHOUSE_CLIENT} --query "SHOW DATABASES" | grep "test1"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp.csv\`;"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp/tmp.csv\`;"
+${CLICKHOUSE_LOCAL} -q "SELECT COUNT(*) FROM \"${tmp_dir}/tmp.csv\""
+
+#################
+echo "Test 2: check DatabaseFilesystem access rights on server"
+# Allows list files only inside user_files
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`../tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`/tmp/tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+
+${CLICKHOUSE_CLIENT} --multiline --multiquery --query """
+USE test1;
+SELECT COUNT(*) FROM \"../${tmp_dir}/tmp.csv\";
+""" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`../../../../../../tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test2;
+CREATE DATABASE test2 ENGINE = Filesystem('/tmp');
+SELECT COUNT(*) FROM test2.\`tmp.csv\`;
+""" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+
+# Clean
+${CLICKHOUSE_CLIENT} --query "DROP DATABASE test1;"
+${CLICKHOUSE_CLIENT} --query "DROP DATABASE test2;"
+rm -rd $tmp_dir
+rm -rd $CLICKHOUSE_USER_FILES_PATH

From 4606e660683992b630f9db952beda9b261f82d76 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Wed, 26 Apr 2023 11:06:01 +0300
Subject: [PATCH 057/722] Fix style

---
 src/Databases/DatabaseFilesystem.cpp | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 106885e7c3e..16aed185669 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -18,18 +18,23 @@ namespace fs = std::filesystem;
 namespace DB
 {
 
+namespace ErrorCodes
+{
+    extern const int UNKNOWN_TABLE;
+}
+
 DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
     path = fs::path(path).lexically_normal().string();
 }
 
-std::string DatabaseFilesystem::getTablePath(const std::string& table_name) const
+std::string DatabaseFilesystem::getTablePath(const std::string & table_name) const
 {
     return fs::path(path) / table_name;
 }
 
-void DatabaseFilesystem::addTable(const std::string& table_name, StoragePtr table_storage) const
+void DatabaseFilesystem::addTable(const std::string & table_name, StoragePtr table_storage) const
 {
     std::lock_guard lock(mutex);
     loaded_tables.emplace(table_name, table_storage);
@@ -80,7 +85,8 @@ StoragePtr DatabaseFilesystem::getTable(const String & name, ContextPtr context_
     throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
 }
 
-StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const {
+StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const
+{
     try
     {
         return getTable(name, context_);
@@ -127,9 +133,9 @@ void DatabaseFilesystem::shutdown()
 }
 
 /**
- * Returns an empty vector because the database is read-only and no tables can be backed up.
+ * Returns an empty vector because the database is read-only and no tables can be backed up
  */
-std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFilesystem::getTablesForBackup(const FilterByNameFunction&, const ContextPtr&) const
+std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFilesystem::getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const
 {
     return {};
 }
@@ -137,9 +143,9 @@ std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFilesystem::getTablesForBacku
 /**
  *
  * Returns an empty iterator because the database does not have its own tables
- * But only caches them for quick access.
+ * But only caches them for quick access
  */
-DatabaseTablesIteratorPtr DatabaseFilesystem::getTablesIterator(ContextPtr, const FilterByNameFunction&) const
+DatabaseTablesIteratorPtr DatabaseFilesystem::getTablesIterator(ContextPtr, const FilterByNameFunction &) const
 {
     return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
 }

From ca1501aeb4e9c7a1db131f4c24255bd24bd99059 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Wed, 26 Apr 2023 13:05:56 +0300
Subject: [PATCH 058/722] retrigger checks


From 1f90e9bde8ab740ae5fda958ca93f9c4abab6008 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Wed, 26 Apr 2023 14:37:41 +0300
Subject: [PATCH 059/722] retrigger checks


From e20f92ce0f6ef4d06813932025cdea10a361631c Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Thu, 27 Apr 2023 21:26:36 +0300
Subject: [PATCH 060/722] Fixed exceptions handling; Fixed style;

---
 programs/local/LocalServer.cpp       | 10 +++++-
 src/Databases/DatabaseFactory.cpp    |  2 +-
 src/Databases/DatabaseFilesystem.cpp | 48 +++++++++++++++++++++++----
 src/Databases/DatabasesOverlay.cpp   | 49 ++++++----------------------
 src/Databases/DatabasesOverlay.h     |  2 --
 5 files changed, 62 insertions(+), 49 deletions(-)

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 566d11791ca..4939997b323 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -8,6 +8,7 @@
 #include <Poco/Logger.h>
 #include <Poco/NullChannel.h>
 #include <Poco/SimpleFileChannel.h>
+#include <Databases/DatabaseFilesystem.h>
 #include <Databases/DatabaseMemory.h>
 #include <Databases/DatabasesOverlay.h>
 #include <Storages/System/attachSystemTables.h>
@@ -149,6 +150,13 @@ static DatabasePtr createMemoryDatabaseIfNotExists(ContextPtr context, const Str
     return system_database;
 }
 
+static DatabasePtr createClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_)
+{
+    auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFilesystem>(name_, "", context_));
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
+    return databaseCombiner;
+}
 
 /// If path is specified and not empty, will try to setup server environment and load existing metadata
 void LocalServer::tryInitPath()
@@ -648,7 +656,7 @@ void LocalServer::processConfig()
       *  if such tables will not be dropped, clickhouse-server will not be able to load them due to security reasons.
       */
     std::string default_database = config().getString("default_database", "_local");
-    DatabaseCatalog::instance().attachDatabase(default_database, CreateClickHouseLocalDatabaseOverlay(default_database, global_context));
+    DatabaseCatalog::instance().attachDatabase(default_database, createClickHouseLocalDatabaseOverlay(default_database, global_context));
     global_context->setCurrentDatabase(default_database);
     applyCmdOptions(global_context);
 
diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 8a50c31efc8..1be0d5dd7b2 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -443,7 +443,7 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         if (engine->arguments && !engine->arguments->children.empty())
         {
             if (engine->arguments->children.size() != 1)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Filesystem database requires at most 1 argument: filesystem_path");
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Filesystem database requires exactly 1 argument: filesystem_path");
 
             const auto & arguments = engine->arguments->children;
             init_path = safeGetLiteralValue<String>(arguments[0], engine_name);
diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 16aed185669..8275bdf6151 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -20,24 +20,42 @@ namespace DB
 
 namespace ErrorCodes
 {
+    extern const int LOGICAL_ERROR;
     extern const int UNKNOWN_TABLE;
+    extern const int DATABASE_ACCESS_DENIED;
+    extern const int BAD_ARGUMENTS;
 }
 
 DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
-    path = fs::path(path).lexically_normal().string();
+    fs::path user_files_path;
+    if (context_->getApplicationType() != Context::ApplicationType::LOCAL)
+        user_files_path = fs::canonical(fs::path(getContext()->getUserFilesPath()));
+
+    if (fs::path(path).is_relative())
+        path = user_files_path / path;
+
+    path = fs::absolute(path).lexically_normal().string();
 }
 
 std::string DatabaseFilesystem::getTablePath(const std::string & table_name) const
 {
-    return fs::path(path) / table_name;
+    fs::path table_path = fs::path(path) / table_name;
+    return table_path.lexically_normal().string();
 }
 
 void DatabaseFilesystem::addTable(const std::string & table_name, StoragePtr table_storage) const
 {
     std::lock_guard lock(mutex);
-    loaded_tables.emplace(table_name, table_storage);
+    auto [_, inserted] = loaded_tables.emplace(table_name, table_storage);
+    if (!inserted)
+        throw Exception(
+            ErrorCodes::LOGICAL_ERROR,
+            "Table with name `{}` already exists in database `{}` (engine {})",
+            table_name,
+            getDatabaseName(),
+            getEngineName());
 }
 
 bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr) const
@@ -62,8 +80,20 @@ StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr cont
             return it->second;
     }
 
+    // If run in Local mode, no need for path checking.
+    bool need_check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
+    std::string user_files_path = fs::canonical(fs::path(context_->getUserFilesPath())).string();
+
     auto table_path = getTablePath(name);
 
+    // Check access for file before checking its existence
+    if (need_check_path && table_path.find(user_files_path) != 0)
+        throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED, "File is not inside {}", user_files_path);
+
+    // If the table doesn't exist in the tables map, check if the corresponding file exists
+    if (!fs::exists(table_path) || !fs::is_regular_file(table_path))
+        return nullptr;
+
     // If the file exists, create a new table using TableFunctionFile and return it.
     auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
 
@@ -89,11 +119,17 @@ StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr conte
 {
     try
     {
-        return getTable(name, context_);
+        return getTableImpl(name, context_);
     }
-    catch (...)
+    catch (const Exception & e)
     {
-        return nullptr;
+        // Ignore exceptions thrown by TableFunctionFile and which indicate that there is no table
+        if (e.code() == ErrorCodes::BAD_ARGUMENTS)
+            return nullptr;
+        if (e.code() == ErrorCodes::DATABASE_ACCESS_DENIED)
+            return nullptr;
+
+        throw;
     }
 }
 
diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
index 5a6a4fe5cc6..b44a9798072 100644
--- a/src/Databases/DatabasesOverlay.cpp
+++ b/src/Databases/DatabasesOverlay.cpp
@@ -1,11 +1,9 @@
 #include <Databases/DatabasesOverlay.h>
 
+#include <Common/typeid_cast.h>
 #include <Interpreters/Context.h>
 #include <Interpreters/InterpreterCreateQuery.h>
-#include <Common/typeid_cast.h>
-
-#include <Databases/DatabaseFilesystem.h>
-#include <Databases/DatabaseMemory.h>
+#include <Parsers/ASTCreateQuery.h>
 
 #include <Storages/IStorage_fwd.h>
 
@@ -73,15 +71,11 @@ void DatabasesOverlay::dropTable(ContextPtr context_, const String & table_name,
 {
     for (auto & db : databases)
     {
-        try
+        if (db->isTableExist(table_name, context_))
         {
             db->dropTable(context_, table_name, sync);
             return;
         }
-        catch (...)
-        {
-            continue;
-        }
     }
     throw Exception(
         ErrorCodes::LOGICAL_ERROR,
@@ -119,16 +113,8 @@ StoragePtr DatabasesOverlay::detachTable(ContextPtr context_, const String & tab
     StoragePtr result = nullptr;
     for (auto & db : databases)
     {
-        try
-        {
-            result = db->detachTable(context_, table_name);
-            if (result)
-                return result;
-        }
-        catch (...)
-        {
-            continue;
-        }
+        if (db->isTableExist(table_name, context_))
+            return db->detachTable(context_, table_name);
     }
     throw Exception(
         ErrorCodes::LOGICAL_ERROR,
@@ -212,17 +198,10 @@ void DatabasesOverlay::alterTable(ContextPtr local_context, const StorageID & ta
 {
     for (auto & db : databases)
     {
-        try
+        if (!db->isReadOnly() && db->isTableExist(table_id.table_name, local_context))
         {
-            if (!db->isReadOnly())
-            {
-                db->alterTable(local_context, table_id, metadata);
-                return;
-            }
-        }
-        catch (...)
-        {
-            continue;
+            db->alterTable(local_context, table_id, metadata);
+            return;
         }
     }
     throw Exception(
@@ -239,8 +218,8 @@ DatabasesOverlay::getTablesForBackup(const FilterByNameFunction & filter, const
     std::vector<std::pair<ASTPtr, StoragePtr>> result;
     for (const auto & db : databases)
     {
-        auto dbBackup = db->getTablesForBackup(filter, local_context);
-        result.insert(result.end(), std::make_move_iterator(dbBackup.begin()), std::make_move_iterator(dbBackup.end()));
+        auto db_backup = db->getTablesForBackup(filter, local_context);
+        result.insert(result.end(), std::make_move_iterator(db_backup.begin()), std::make_move_iterator(db_backup.end()));
     }
     return result;
 }
@@ -284,12 +263,4 @@ DatabaseTablesIteratorPtr DatabasesOverlay::getTablesIterator(ContextPtr context
     return std::make_unique<DatabaseTablesSnapshotIterator>(std::move(tables), getDatabaseName());
 }
 
-DatabasePtr CreateClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_)
-{
-    auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFilesystem>(name_, "", context_));
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
-    return databaseCombiner;
-}
-
 }
diff --git a/src/Databases/DatabasesOverlay.h b/src/Databases/DatabasesOverlay.h
index 77f0085161b..0f31bbd6a47 100644
--- a/src/Databases/DatabasesOverlay.h
+++ b/src/Databases/DatabasesOverlay.h
@@ -63,6 +63,4 @@ protected:
     Poco::Logger * log;
 };
 
-DatabasePtr CreateClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_);
-
 }

From 57d852a60e804da746ce5e4cde2d56222afe677e Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Sun, 30 Apr 2023 14:46:11 +0300
Subject: [PATCH 061/722] Fixed table existence checking

---
 src/Databases/DatabaseFactory.cpp             |  2 +-
 src/Databases/DatabaseFilesystem.cpp          | 60 ++++++++++++++-----
 src/Databases/DatabaseFilesystem.h            |  2 +
 .../02722_database_filesystem.reference       |  5 +-
 .../0_stateless/02722_database_filesystem.sh  | 24 ++++++--
 5 files changed, 70 insertions(+), 23 deletions(-)

diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 1be0d5dd7b2..8a50c31efc8 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -443,7 +443,7 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         if (engine->arguments && !engine->arguments->children.empty())
         {
             if (engine->arguments->children.size() != 1)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Filesystem database requires exactly 1 argument: filesystem_path");
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Filesystem database requires at most 1 argument: filesystem_path");
 
             const auto & arguments = engine->arguments->children;
             init_path = safeGetLiteralValue<String>(arguments[0], engine_name);
diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 8275bdf6151..7f22b8a16a0 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -1,5 +1,6 @@
 #include <Databases/DatabaseFilesystem.h>
 
+#include <Common/filesystemHelpers.h>
 #include <IO/Operators.h>
 #include <IO/WriteBufferFromString.h>
 #include <Interpreters/Context.h>
@@ -24,19 +25,27 @@ namespace ErrorCodes
     extern const int UNKNOWN_TABLE;
     extern const int DATABASE_ACCESS_DENIED;
     extern const int BAD_ARGUMENTS;
+    extern const int FILE_DOESNT_EXIST;
 }
 
 DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
     fs::path user_files_path;
-    if (context_->getApplicationType() != Context::ApplicationType::LOCAL)
+    const auto & application_type = context_->getApplicationType();
+
+    if (application_type != Context::ApplicationType::LOCAL)
         user_files_path = fs::canonical(fs::path(getContext()->getUserFilesPath()));
 
     if (fs::path(path).is_relative())
         path = user_files_path / path;
+    else if (application_type != Context::ApplicationType::LOCAL && !pathStartsWith(fs::path(path), user_files_path))
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Path must be inside user-files path ({})", user_files_path.string());
 
     path = fs::absolute(path).lexically_normal().string();
+
+    if (!fs::exists(path))
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Path does not exist ({})", path);
 }
 
 std::string DatabaseFilesystem::getTablePath(const std::string & table_name) const
@@ -58,7 +67,32 @@ void DatabaseFilesystem::addTable(const std::string & table_name, StoragePtr tab
             getEngineName());
 }
 
-bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr) const
+bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const {
+    // If run in Local mode, no need for path checking.
+    bool need_check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
+    std::string user_files_path = fs::canonical(fs::path(context_->getUserFilesPath())).string();
+
+    // Check access for file before checking its existence
+    if (need_check_path && !fileOrSymlinkPathStartsWith(table_path, user_files_path))
+    {
+        if (throw_on_error)
+            throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED, "File is not inside {}", user_files_path);
+        else
+            return false;
+    }
+
+    // Check if the corresponding file exists
+    if (!fs::exists(table_path) || !fs::is_regular_file(table_path)) {
+        if (throw_on_error)
+            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "File does not exist ({})", table_path);
+        else
+            return false;
+    }
+
+    return true;
+}
+
+bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr context_) const
 {
     {
         std::lock_guard lock(mutex);
@@ -67,7 +101,8 @@ bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr) const
     }
 
     fs::path table_file_path(getTablePath(name));
-    return fs::exists(table_file_path) && fs::is_regular_file(table_file_path);
+
+    return checkTableFilePath(table_file_path, context_, false);
 }
 
 StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr context_) const
@@ -80,19 +115,9 @@ StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr cont
             return it->second;
     }
 
-    // If run in Local mode, no need for path checking.
-    bool need_check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
-    std::string user_files_path = fs::canonical(fs::path(context_->getUserFilesPath())).string();
-
     auto table_path = getTablePath(name);
 
-    // Check access for file before checking its existence
-    if (need_check_path && table_path.find(user_files_path) != 0)
-        throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED, "File is not inside {}", user_files_path);
-
-    // If the table doesn't exist in the tables map, check if the corresponding file exists
-    if (!fs::exists(table_path) || !fs::is_regular_file(table_path))
-        return nullptr;
+    checkTableFilePath(table_path, context_, true);
 
     // If the file exists, create a new table using TableFunctionFile and return it.
     auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
@@ -101,6 +126,7 @@ StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr cont
     if (!table_function)
         return nullptr;
 
+    // TableFunctionFile throws exceptions, if table cannot be created
     auto table_storage = table_function->execute(args, context_, name);
     if (table_storage)
         addTable(name, table_storage);
@@ -110,6 +136,7 @@ StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr cont
 
 StoragePtr DatabaseFilesystem::getTable(const String & name, ContextPtr context_) const
 {
+    // rethrow all exceptions from TableFunctionFile to show correct error to user
     if (auto storage = getTableImpl(name, context_))
         return storage;
     throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
@@ -123,11 +150,14 @@ StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr conte
     }
     catch (const Exception & e)
     {
-        // Ignore exceptions thrown by TableFunctionFile and which indicate that there is no table
+        // Ignore exceptions thrown by TableFunctionFile, which indicate that there is no table
+        // see tests/02722_database_filesystem.sh for more details
         if (e.code() == ErrorCodes::BAD_ARGUMENTS)
             return nullptr;
         if (e.code() == ErrorCodes::DATABASE_ACCESS_DENIED)
             return nullptr;
+        if (e.code() == ErrorCodes::FILE_DOESNT_EXIST)
+            return nullptr;
 
         throw;
     }
diff --git a/src/Databases/DatabaseFilesystem.h b/src/Databases/DatabaseFilesystem.h
index 697511ac5b3..3d2ad695cc6 100644
--- a/src/Databases/DatabaseFilesystem.h
+++ b/src/Databases/DatabaseFilesystem.h
@@ -49,6 +49,8 @@ protected:
 
     void addTable(const std::string & table_name, StoragePtr table_storage) const;
 
+    bool checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const;
+
 
 private:
     String path;
diff --git a/tests/queries/0_stateless/02722_database_filesystem.reference b/tests/queries/0_stateless/02722_database_filesystem.reference
index a583f1e2e3c..c65dda7933a 100644
--- a/tests/queries/0_stateless/02722_database_filesystem.reference
+++ b/tests/queries/0_stateless/02722_database_filesystem.reference
@@ -4,7 +4,10 @@ test1
 4
 4
 4
-Test 2: check DatabaseFilesystem access rights on server
+Test 2: check DatabaseFilesystem access rights and errors handling on server
+OK
+OK
+OK
 OK
 OK
 OK
diff --git a/tests/queries/0_stateless/02722_database_filesystem.sh b/tests/queries/0_stateless/02722_database_filesystem.sh
index 0adeface438..80f97af693e 100755
--- a/tests/queries/0_stateless/02722_database_filesystem.sh
+++ b/tests/queries/0_stateless/02722_database_filesystem.sh
@@ -21,6 +21,7 @@ tmp_dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
 mkdir $tmp_dir
 cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${tmp_dir}/tmp.csv
 cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp/tmp.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp.myext
 
 #################
 echo "Test 1: create filesystem database and check implicit calls"
@@ -35,24 +36,35 @@ ${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp/tmp.csv\`;"
 ${CLICKHOUSE_LOCAL} -q "SELECT COUNT(*) FROM \"${tmp_dir}/tmp.csv\""
 
 #################
-echo "Test 2: check DatabaseFilesystem access rights on server"
-# Allows list files only inside user_files
+echo "Test 2: check DatabaseFilesystem access rights and errors handling on server"
+# DATABASE_ACCESS_DENIED: Allows list files only inside user_files
 ${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`../tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
 ${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`/tmp/tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
-
 ${CLICKHOUSE_CLIENT} --multiline --multiquery --query """
 USE test1;
 SELECT COUNT(*) FROM \"../${tmp_dir}/tmp.csv\";
 """ 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
 ${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`../../../../../../tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+
+# BAD_ARGUMENTS: path should be inside user_files
 ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test2;
 CREATE DATABASE test2 ENGINE = Filesystem('/tmp');
-SELECT COUNT(*) FROM test2.\`tmp.csv\`;
-""" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
+""" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
+
+# BAD_ARGUMENTS: .../user_files/relative_unknown_dir does not exists
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test2;
+CREATE DATABASE test2 ENGINE = Filesystem('relative_unknown_dir');
+""" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
+
+# FILE_DOESNT_EXIST: unknown file
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp2.csv\`;" 2>&1| grep -F "Code: 107" > /dev/null && echo "OK"
+
+# BAD_ARGUMENTS: Cannot determine the file format by it's extension
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp.myext\`;" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
 
 # Clean
 ${CLICKHOUSE_CLIENT} --query "DROP DATABASE test1;"
-${CLICKHOUSE_CLIENT} --query "DROP DATABASE test2;"
 rm -rd $tmp_dir
 rm -rd $CLICKHOUSE_USER_FILES_PATH

From 6831eb20013aadeec451ac8fb94d894abbfccef9 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Sun, 30 Apr 2023 14:51:04 +0300
Subject: [PATCH 062/722] fix style

---
 src/Databases/DatabaseFilesystem.cpp | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 7f22b8a16a0..8de609f0ca2 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -1,6 +1,5 @@
 #include <Databases/DatabaseFilesystem.h>
 
-#include <Common/filesystemHelpers.h>
 #include <IO/Operators.h>
 #include <IO/WriteBufferFromString.h>
 #include <Interpreters/Context.h>
@@ -11,6 +10,7 @@
 #include <Parsers/parseQuery.h>
 #include <Storages/IStorage.h>
 #include <TableFunctions/TableFunctionFactory.h>
+#include <Common/filesystemHelpers.h>
 
 #include <filesystem>
 
@@ -67,7 +67,8 @@ void DatabaseFilesystem::addTable(const std::string & table_name, StoragePtr tab
             getEngineName());
 }
 
-bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const {
+bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const
+{
     // If run in Local mode, no need for path checking.
     bool need_check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
     std::string user_files_path = fs::canonical(fs::path(context_->getUserFilesPath())).string();
@@ -82,7 +83,8 @@ bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, Cont
     }
 
     // Check if the corresponding file exists
-    if (!fs::exists(table_path) || !fs::is_regular_file(table_path)) {
+    if (!fs::exists(table_path) || !fs::is_regular_file(table_path))
+    {
         if (throw_on_error)
             throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "File does not exist ({})", table_path);
         else

From 1846b76982828ed3223b25e2e5d6f5c8cee937eb Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Sun, 30 Apr 2023 23:13:42 +0300
Subject: [PATCH 063/722] Added DatabaseS3 with test

---
 programs/local/LocalServer.cpp                |   9 +
 src/Databases/DatabaseFactory.cpp             |  29 ++-
 src/Databases/DatabaseS3.cpp                  | 199 ++++++++++++++++++
 src/Databases/DatabaseS3.h                    |  63 ++++++
 .../0_stateless/02724_database_s3.reference   |  18 ++
 .../queries/0_stateless/02724_database_s3.sh  |  51 +++++
 6 files changed, 367 insertions(+), 2 deletions(-)
 create mode 100644 src/Databases/DatabaseS3.cpp
 create mode 100644 src/Databases/DatabaseS3.h
 create mode 100644 tests/queries/0_stateless/02724_database_s3.reference
 create mode 100755 tests/queries/0_stateless/02724_database_s3.sh

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 4939997b323..215a92e1944 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -51,6 +51,8 @@
 #include <base/argsToConfig.h>
 #include <filesystem>
 
+#include "config.h"
+
 #if defined(FUZZING_MODE)
     #include <Functions/getFuzzerData.h>
 #endif
@@ -59,6 +61,10 @@
 #   include <azure/storage/common/internal/xml_wrapper.hpp>
 #endif
 
+#if USE_AWS_S3
+#include <Databases/DatabaseS3.h>
+#endif
+
 namespace fs = std::filesystem;
 
 
@@ -155,6 +161,9 @@ static DatabasePtr createClickHouseLocalDatabaseOverlay(const String & name_, Co
     auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFilesystem>(name_, "", context_));
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
+#if USE_AWS_S3
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseS3>(name_, "", "", context_));
+#endif
     return databaseCombiner;
 }
 
diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 8a50c31efc8..b21435527a5 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -49,6 +49,10 @@
 #include <Databases/SQLite/DatabaseSQLite.h>
 #endif
 
+#if USE_AWS_S3
+#include <Databases/DatabaseS3.h>
+#endif
+
 namespace fs = std::filesystem;
 
 namespace DB
@@ -133,13 +137,13 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
     static const std::unordered_set<std::string_view> database_engines{"Ordinary", "Atomic", "Memory",
         "Dictionary", "Lazy", "Replicated", "MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem"};
+        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3"};
 
     if (!database_engines.contains(engine_name))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Database engine name `{}` does not exist", engine_name);
 
     static const std::unordered_set<std::string_view> engines_with_arguments{"MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem"};
+        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3"};
 
     static const std::unordered_set<std::string_view> engines_with_table_overrides{"MaterializeMySQL", "MaterializedMySQL", "MaterializedPostgreSQL"};
     bool engine_may_have_arguments = engines_with_arguments.contains(engine_name);
@@ -451,6 +455,27 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
         return std::make_shared<DatabaseFilesystem>(database_name, init_path, context);
     }
+#if USE_AWS_S3
+    else if (engine_name == "S3")
+    {
+        const ASTFunction * engine = engine_define->engine;
+
+        std::string key_id;
+        std::string secret_key;
+
+        if (engine->arguments && !engine->arguments->children.empty())
+        {
+            if (engine->arguments->children.size() != 2)
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "S3 database requires 0 or 2 argument: [access_key_id, secret_access_key]");
+
+            const auto & arguments = engine->arguments->children;
+            key_id = safeGetLiteralValue<String>(arguments[0], engine_name);
+            secret_key = safeGetLiteralValue<String>(arguments[1], engine_name);
+        }
+
+        return std::make_shared<DatabaseS3>(database_name, key_id, secret_key, context);
+    }
+#endif
 
     throw Exception(ErrorCodes::UNKNOWN_DATABASE_ENGINE, "Unknown database engine: {}", engine_name);
 }
diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
new file mode 100644
index 00000000000..d4412ba7973
--- /dev/null
+++ b/src/Databases/DatabaseS3.cpp
@@ -0,0 +1,199 @@
+#include "config.h"
+
+#if USE_AWS_S3
+
+#include <Databases/DatabaseS3.h>
+
+#include <IO/S3/URI.h>
+#include <Interpreters/Context.h>
+#include <Parsers/ASTCreateQuery.h>
+#include <Parsers/ASTFunction.h>
+#include <Parsers/ASTLiteral.h>
+#include <Parsers/ParserCreateQuery.h>
+#include <Parsers/parseQuery.h>
+#include <Storages/IStorage.h>
+#include <TableFunctions/TableFunctionFactory.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+    extern const int UNKNOWN_TABLE;
+    extern const int BAD_ARGUMENTS;
+    extern const int FILE_DOESNT_EXIST;
+    extern const int UNACCEPTABLE_URL;
+    extern const int S3_ERROR;
+}
+
+DatabaseS3::DatabaseS3(const String & name_, const String & key_id, const String & secret_key, ContextPtr context_)
+    : IDatabase(name_)
+    , WithContext(context_->getGlobalContext())
+    , access_key_id(key_id)
+    , secret_access_key(secret_key)
+    , log(&Poco::Logger::get("DatabaseS3(" + name_ + ")"))
+{
+}
+
+void DatabaseS3::addTable(const std::string & table_name, StoragePtr table_storage) const
+{
+    std::lock_guard lock(mutex);
+    auto [_, inserted] = loaded_tables.emplace(table_name, table_storage);
+    if (!inserted)
+        throw Exception(
+            ErrorCodes::LOGICAL_ERROR,
+            "Table with name `{}` already exists in database `{}` (engine {})",
+            table_name,
+            getDatabaseName(),
+            getEngineName());
+}
+
+bool DatabaseS3::checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const
+{
+    try
+    {
+        S3::URI uri(url);
+        context_->getGlobalContext()->getRemoteHostFilter().checkURL(uri.uri);
+    }
+    catch (...)
+    {
+        if (throw_on_error)
+            throw;
+        return false;
+    }
+    return true;
+}
+
+bool DatabaseS3::isTableExist(const String & name, ContextPtr context_) const
+{
+    std::lock_guard lock(mutex);
+    if (loaded_tables.find(name) != loaded_tables.end())
+        return true;
+
+    return checkUrl(name, context_, false);
+}
+
+StoragePtr DatabaseS3::getTableImpl(const String & url, ContextPtr context_) const
+{
+    // Check if the table exists in the loaded tables map
+    {
+        std::lock_guard lock(mutex);
+        auto it = loaded_tables.find(url);
+        if (it != loaded_tables.end())
+            return it->second;
+    }
+
+    checkUrl(url, context_, true);
+
+    // call TableFunctionS3
+    auto args = makeASTFunction(
+        "s3",
+        std::make_shared<ASTLiteral>(url),
+        std::make_shared<ASTLiteral>(access_key_id),
+        std::make_shared<ASTLiteral>(secret_access_key));
+
+    auto table_function = TableFunctionFactory::instance().get(args, context_);
+    if (!table_function)
+        return nullptr;
+
+    // TableFunctionS3 throws exceptions, if table cannot be created
+    auto table_storage = table_function->execute(args, context_, url);
+    if (table_storage)
+        addTable(url, table_storage);
+
+    return table_storage;
+}
+
+StoragePtr DatabaseS3::getTable(const String & name, ContextPtr context_) const
+{
+    // rethrow all exceptions from TableFunctionS3 to show correct error to user
+    if (auto storage = getTableImpl(name, context_))
+        return storage;
+    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
+}
+
+StoragePtr DatabaseS3::tryGetTable(const String & name, ContextPtr context_) const
+{
+    try
+    {
+        return getTableImpl(name, context_);
+    }
+    catch (const Exception & e)
+    {
+        // Ignore exceptions thrown by TableFunctionS3, which indicate that there is no table
+        if (e.code() == ErrorCodes::BAD_ARGUMENTS)
+            return nullptr;
+        if (e.code() == ErrorCodes::S3_ERROR)
+            return nullptr;
+        if (e.code() == ErrorCodes::FILE_DOESNT_EXIST)
+            return nullptr;
+        if (e.code() == ErrorCodes::UNACCEPTABLE_URL)
+            return nullptr;
+        throw;
+    }
+    catch (const Poco::URISyntaxException &)
+    {
+        return nullptr;
+    }
+}
+
+ASTPtr DatabaseS3::getCreateDatabaseQuery() const
+{
+    auto settings = getContext()->getSettingsRef();
+    ParserCreateQuery parser;
+
+    const String query = fmt::format("CREATE DATABASE {} ENGINE = S3('{}', '{}')",
+                                     backQuoteIfNeed(getDatabaseName()),
+                                     access_key_id,
+                                     secret_access_key);
+    ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
+
+    if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
+    {
+        auto & ast_create_query = ast->as<ASTCreateQuery &>();
+        ast_create_query.set(ast_create_query.comment, std::make_shared<ASTLiteral>(database_comment));
+    }
+
+    return ast;
+}
+
+void DatabaseS3::shutdown()
+{
+    Tables tables_snapshot;
+    {
+        std::lock_guard lock(mutex);
+        tables_snapshot = loaded_tables;
+    }
+
+    for (const auto & kv : tables_snapshot)
+    {
+        auto table_id = kv.second->getStorageID();
+        kv.second->flushAndShutdown();
+    }
+
+    std::lock_guard lock(mutex);
+    loaded_tables.clear();
+}
+
+/**
+ * Returns an empty vector because the database is read-only and no tables can be backed up
+ */
+std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseS3::getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const
+{
+    return {};
+}
+
+/**
+ *
+ * Returns an empty iterator because the database does not have its own tables
+ * But only caches them for quick access
+ */
+DatabaseTablesIteratorPtr DatabaseS3::getTablesIterator(ContextPtr, const FilterByNameFunction &) const
+{
+    return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
+}
+
+} // DB
+
+#endif
diff --git a/src/Databases/DatabaseS3.h b/src/Databases/DatabaseS3.h
new file mode 100644
index 00000000000..d5269e57f5a
--- /dev/null
+++ b/src/Databases/DatabaseS3.h
@@ -0,0 +1,63 @@
+#pragma once
+
+#include "config.h"
+
+#if USE_AWS_S3
+
+#include <mutex>
+#include <Databases/IDatabase.h>
+#include <Parsers/IAST.h>
+#include <Storages/IStorage_fwd.h>
+#include <base/types.h>
+
+namespace DB
+{
+
+class Context;
+
+/**
+  * DatabaseS3 provides access to data stored in S3
+  * Uses TableFunctionS3 to implicitly load file when a user requests the table, and provides read-only access to the data in the file
+  * Tables are cached inside the database for quick access
+  */
+class DatabaseS3 : public IDatabase, protected WithContext
+{
+public:
+    DatabaseS3(const String & name, const String & key_id, const String & secret_key, ContextPtr context);
+
+    String getEngineName() const override { return "S3"; }
+
+    bool isTableExist(const String & name, ContextPtr context) const override;
+
+    StoragePtr getTable(const String & name, ContextPtr context) const override;
+
+    StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
+
+    bool empty() const override { return true; }
+
+    bool isReadOnly() const override { return true; }
+
+    ASTPtr getCreateDatabaseQuery() const override;
+
+    void shutdown() override;
+
+    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
+    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
+
+protected:
+    StoragePtr getTableImpl(const String & url, ContextPtr context) const;
+
+    void addTable(const std::string & table_name, StoragePtr table_storage) const;
+
+    bool checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const;
+
+private:
+    const String access_key_id;
+    const String secret_access_key;
+    mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
+    Poco::Logger * log;
+};
+
+} // DB
+
+#endif
diff --git a/tests/queries/0_stateless/02724_database_s3.reference b/tests/queries/0_stateless/02724_database_s3.reference
new file mode 100644
index 00000000000..8a985913ff9
--- /dev/null
+++ b/tests/queries/0_stateless/02724_database_s3.reference
@@ -0,0 +1,18 @@
+Test 1: select from s3
+1	2	3
+4	5	6
+7	8	9
+0	0	0
+test1
+10	11	12
+13	14	15
+16	17	18
+0	0	0
+20	21	22
+23	24	25
+26	27	28
+0	0	0
+Test 2: check exceptions
+OK
+OK
+OK
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
new file mode 100755
index 00000000000..4f9df402040
--- /dev/null
+++ b/tests/queries/0_stateless/02724_database_s3.sh
@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest
+# Tag no-fasttest: Depends on AWS
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+#################
+echo "Test 1: select from s3"
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test1;
+CREATE DATABASE test1 ENGINE = S3;
+USE test1;
+SELECT * FROM \"http://localhost:11111/test/a.tsv\"
+"""
+${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test1
+${CLICKHOUSE_CLIENT} -q "DROP DATABASE test1;"
+
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test2;
+CREATE DATABASE test2 ENGINE = S3('test', 'testtest');
+USE test2;
+SELECT * FROM \"http://localhost:11111/test/b.tsv\"
+"""
+${CLICKHOUSE_CLIENT} -q "DROP DATABASE test2;"
+
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"http://localhost:11111/test/c.tsv\""
+
+#################
+echo "Test 2: check exceptions"
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"http://localhost:11111/test/c.myext\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK"
+
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test3;
+CREATE DATABASE test3 ENGINE = S3;
+USE test3;
+SELECT * FROM \"http://localhost:11111/test/a.myext\"
+""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK"
+
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+USE test3;
+SELECT * FROM \"abacaba\"
+""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK"
+
+# Cleanup
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test1;
+DROP DATABASE IF EXISTS test2;
+DROP DATABASE IF EXISTS test3;
+"""

From 3d1affbddb3de6c464f05459c1e9e5f34b6ff957 Mon Sep 17 00:00:00 2001
From: Aleksei Golub <alescha.golub97@yandex.ru>
Date: Mon, 1 May 2023 12:17:10 +0300
Subject: [PATCH 064/722] retrigger checks


From c1c69553741af4789170590f8a669d17f2dffbeb Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 26 Apr 2023 14:06:22 +0200
Subject: [PATCH 065/722] Deprecate delete-on-destroy.txt, do not create it any
 more

---
 src/Storages/MergeTree/IMergeTreeDataPart.cpp | 17 +----------------
 src/Storages/MergeTree/IMergeTreeDataPart.h   |  7 +++++--
 src/Storages/MergeTree/MergeTreeData.cpp      |  7 +++----
 3 files changed, 9 insertions(+), 22 deletions(-)

diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index 148cbf93948..d7f2f3ca7c7 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -953,24 +953,9 @@ void IMergeTreeDataPart::writeVersionMetadata(const VersionMetadata & version_,
     }
 }
 
-void IMergeTreeDataPart::writeDeleteOnDestroyMarker()
-{
-    static constexpr auto marker_path = "delete-on-destroy.txt";
-
-    try
-    {
-        getDataPartStorage().createFile(marker_path);
-    }
-    catch (Poco::Exception & e)
-    {
-        LOG_ERROR(storage.log, "{} (while creating DeleteOnDestroy marker: {})",
-            e.what(), (fs::path(getDataPartStorage().getFullPath()) / marker_path).string());
-    }
-}
-
 void IMergeTreeDataPart::removeDeleteOnDestroyMarker()
 {
-    getDataPartStorage().removeFileIfExists("delete-on-destroy.txt");
+    getDataPartStorage().removeFileIfExists(DELETE_ON_DESTROY_MARKER_FILE_NAME_DEPRECATED);
 }
 
 void IMergeTreeDataPart::removeVersionMetadata()
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.h b/src/Storages/MergeTree/IMergeTreeDataPart.h
index a36634d2cf9..f7bcaa263d6 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.h
@@ -381,7 +381,8 @@ public:
     /// default will be stored in this file.
     static inline constexpr auto DEFAULT_COMPRESSION_CODEC_FILE_NAME = "default_compression_codec.txt";
 
-    static inline constexpr auto DELETE_ON_DESTROY_MARKER_FILE_NAME = "delete-on-destroy.txt";
+    /// "delete-on-destroy.txt" is deprecated. It is no longer being created, only is removed.
+    static inline constexpr auto DELETE_ON_DESTROY_MARKER_FILE_NAME_DEPRECATED = "delete-on-destroy.txt";
 
     static inline constexpr auto UUID_FILE_NAME = "uuid.txt";
 
@@ -456,8 +457,10 @@ public:
 
     void writeChecksums(const MergeTreeDataPartChecksums & checksums_, const WriteSettings & settings);
 
-    void writeDeleteOnDestroyMarker();
+    /// "delete-on-destroy.txt" is deprecated. It is no longer being created, only is removed.
+    /// TODO: remove this method after some time.
     void removeDeleteOnDestroyMarker();
+
     /// It may look like a stupid joke. but these two methods are absolutely unrelated.
     /// This one is about removing file with metadata about part version (for transactions)
     void removeVersionMetadata();
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 83f5c0d359c..2def6fb08d3 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1214,7 +1214,7 @@ MergeTreeData::LoadPartResult MergeTreeData::loadDataPart(
         .build();
 
     String part_path = fs::path(relative_data_path) / part_name;
-    String marker_path = fs::path(part_path) / IMergeTreeDataPart::DELETE_ON_DESTROY_MARKER_FILE_NAME;
+    String marker_path = fs::path(part_path) / IMergeTreeDataPart::DELETE_ON_DESTROY_MARKER_FILE_NAME_DEPRECATED;
 
     if (part_disk_ptr->exists(marker_path))
     {
@@ -4410,7 +4410,6 @@ void MergeTreeData::swapActivePart(MergeTreeData::DataPartPtr part_copy)
             /// All other locks are taken in StorageReplicatedMergeTree
             lockSharedData(*part_copy);
 
-            asMutableDeletingPart(original_active_part)->writeDeleteOnDestroyMarker();
             return;
         }
     }
@@ -7174,7 +7173,7 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
         for (auto it = src_part->getDataPartStorage().iterate(); it->isValid(); it->next())
         {
             if (!files_to_copy_instead_of_hardlinks.contains(it->name())
-                && it->name() != IMergeTreeDataPart::DELETE_ON_DESTROY_MARKER_FILE_NAME
+                && it->name() != IMergeTreeDataPart::DELETE_ON_DESTROY_MARKER_FILE_NAME_DEPRECATED
                 && it->name() != IMergeTreeDataPart::TXN_VERSION_METADATA_FILE_NAME)
             {
                 hardlinked_files->hardlinks_from_source_part.insert(it->name());
@@ -7189,7 +7188,7 @@ std::pair<MergeTreeData::MutableDataPartPtr, scope_guard> MergeTreeData::cloneAn
             {
                 auto file_name_with_projection_prefix = fs::path(projection_storage.getPartDirectory()) / it->name();
                 if (!files_to_copy_instead_of_hardlinks.contains(file_name_with_projection_prefix)
-                    && it->name() != IMergeTreeDataPart::DELETE_ON_DESTROY_MARKER_FILE_NAME
+                    && it->name() != IMergeTreeDataPart::DELETE_ON_DESTROY_MARKER_FILE_NAME_DEPRECATED
                     && it->name() != IMergeTreeDataPart::TXN_VERSION_METADATA_FILE_NAME)
                 {
                     hardlinked_files->hardlinks_from_source_part.insert(file_name_with_projection_prefix);

From 64d232f1aa584b3eba5abf9fe02bfa9b0535701c Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Mon, 1 May 2023 18:00:26 +0000
Subject: [PATCH 066/722] Fix memory leak

---
 src/Interpreters/DatabaseCatalog.cpp                  | 2 +-
 tests/queries/0_stateless/02724_database_s3.reference | 6 +++---
 tests/queries/0_stateless/02724_database_s3.sh        | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/DatabaseCatalog.cpp b/src/Interpreters/DatabaseCatalog.cpp
index f9e74fadcbd..129323cd6b3 100644
--- a/src/Interpreters/DatabaseCatalog.cpp
+++ b/src/Interpreters/DatabaseCatalog.cpp
@@ -346,7 +346,7 @@ DatabaseAndTable DatabaseCatalog::getTableImpl(
     catch (const Exception & e)
     {
         if (exception)
-            exception->emplace(*e.clone());
+            exception->emplace(e);
     }
 
     if (!table)
diff --git a/tests/queries/0_stateless/02724_database_s3.reference b/tests/queries/0_stateless/02724_database_s3.reference
index 8a985913ff9..b3800a27305 100644
--- a/tests/queries/0_stateless/02724_database_s3.reference
+++ b/tests/queries/0_stateless/02724_database_s3.reference
@@ -8,9 +8,9 @@ test1
 13	14	15
 16	17	18
 0	0	0
-20	21	22
-23	24	25
-26	27	28
+10	11	12
+13	14	15
+16	17	18
 0	0	0
 Test 2: check exceptions
 OK
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
index 4f9df402040..9b539407884 100755
--- a/tests/queries/0_stateless/02724_database_s3.sh
+++ b/tests/queries/0_stateless/02724_database_s3.sh
@@ -25,7 +25,7 @@ SELECT * FROM \"http://localhost:11111/test/b.tsv\"
 """
 ${CLICKHOUSE_CLIENT} -q "DROP DATABASE test2;"
 
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"http://localhost:11111/test/c.tsv\""
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"http://localhost:11111/test/b.tsv\""
 
 #################
 echo "Test 2: check exceptions"

From 95522ad7a6486bdbe5861c4f65c3a0ffe9610372 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Mon, 1 May 2023 21:46:17 +0000
Subject: [PATCH 067/722] Added DatabaseHDFS

---
 programs/local/LocalServer.cpp                |   7 +
 src/Databases/DatabaseFactory.cpp             |  31 ++-
 src/Databases/DatabaseHDFS.cpp                | 228 ++++++++++++++++++
 src/Databases/DatabaseHDFS.h                  |  65 +++++
 .../0_stateless/02725_database_hdfs.reference |  16 ++
 .../0_stateless/02725_database_hdfs.sh        |  66 +++++
 6 files changed, 411 insertions(+), 2 deletions(-)
 create mode 100644 src/Databases/DatabaseHDFS.cpp
 create mode 100644 src/Databases/DatabaseHDFS.h
 create mode 100644 tests/queries/0_stateless/02725_database_hdfs.reference
 create mode 100755 tests/queries/0_stateless/02725_database_hdfs.sh

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 215a92e1944..0cf94892171 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -65,6 +65,10 @@
 #include <Databases/DatabaseS3.h>
 #endif
 
+#if USE_HDFS
+#include <Databases/DatabaseHDFS.h>
+#endif
+
 namespace fs = std::filesystem;
 
 
@@ -163,6 +167,9 @@ static DatabasePtr createClickHouseLocalDatabaseOverlay(const String & name_, Co
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
 #if USE_AWS_S3
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseS3>(name_, "", "", context_));
+#endif
+#if USE_HDFS
+    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseHDFS>(name_, "", context_));
 #endif
     return databaseCombiner;
 }
diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index b21435527a5..5c4256c8a9f 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -53,6 +53,10 @@
 #include <Databases/DatabaseS3.h>
 #endif
 
+#if USE_HDFS
+#include <Databases/DatabaseHDFS.h>
+#endif
+
 namespace fs = std::filesystem;
 
 namespace DB
@@ -137,13 +141,13 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
     static const std::unordered_set<std::string_view> database_engines{"Ordinary", "Atomic", "Memory",
         "Dictionary", "Lazy", "Replicated", "MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3"};
+        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3", "HDFS"};
 
     if (!database_engines.contains(engine_name))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Database engine name `{}` does not exist", engine_name);
 
     static const std::unordered_set<std::string_view> engines_with_arguments{"MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3"};
+        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3", "HDFS"};
 
     static const std::unordered_set<std::string_view> engines_with_table_overrides{"MaterializeMySQL", "MaterializedMySQL", "MaterializedPostgreSQL"};
     bool engine_may_have_arguments = engines_with_arguments.contains(engine_name);
@@ -437,6 +441,7 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
         return std::make_shared<DatabaseSQLite>(context, engine_define, create.attach, database_path);
     }
 #endif
+
     else if (engine_name == "Filesystem")
     {
         const ASTFunction * engine = engine_define->engine;
@@ -455,6 +460,7 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
         return std::make_shared<DatabaseFilesystem>(database_name, init_path, context);
     }
+
 #if USE_AWS_S3
     else if (engine_name == "S3")
     {
@@ -477,6 +483,27 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
     }
 #endif
 
+#if USE_HDFS
+    else if (engine_name == "HDFS")
+    {
+        const ASTFunction * engine = engine_define->engine;
+
+        /// If source_url is empty, then table name must contain full url
+        std::string source_url;
+
+        if (engine->arguments && !engine->arguments->children.empty())
+        {
+            if (engine->arguments->children.size() != 1)
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "HDFS database requires at most 1 argument: source_url");
+
+            const auto & arguments = engine->arguments->children;
+            source_url = safeGetLiteralValue<String>(arguments[0], engine_name);
+        }
+
+        return std::make_shared<DatabaseHDFS>(database_name, source_url, context);
+    }
+#endif
+
     throw Exception(ErrorCodes::UNKNOWN_DATABASE_ENGINE, "Unknown database engine: {}", engine_name);
 }
 
diff --git a/src/Databases/DatabaseHDFS.cpp b/src/Databases/DatabaseHDFS.cpp
new file mode 100644
index 00000000000..39c3f955bf5
--- /dev/null
+++ b/src/Databases/DatabaseHDFS.cpp
@@ -0,0 +1,228 @@
+#include "config.h"
+
+#if USE_HDFS
+
+#include <Databases/DatabaseHDFS.h>
+
+#include <Interpreters/Context.h>
+#include <Parsers/ASTCreateQuery.h>
+#include <Parsers/ASTFunction.h>
+#include <Parsers/ASTLiteral.h>
+#include <Parsers/parseQuery.h>
+#include <Parsers/ParserCreateQuery.h>
+#include <Storages/HDFS/HDFSCommon.h>
+#include <Storages/IStorage.h>
+#include <TableFunctions/TableFunctionFactory.h>
+
+#include <Poco/URI.h>
+#include <re2/re2.h>
+
+#include <filesystem>
+
+namespace fs = std::filesystem;
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+    extern const int UNKNOWN_TABLE;
+    extern const int BAD_ARGUMENTS;
+    extern const int FILE_DOESNT_EXIST;
+    extern const int UNACCEPTABLE_URL;
+    extern const int ACCESS_DENIED;
+    extern const int DATABASE_ACCESS_DENIED;
+    extern const int HDFS_ERROR;
+    extern const int CANNOT_EXTRACT_TABLE_STRUCTURE;
+}
+
+static constexpr std::string_view HDFS_HOST_REGEXP = "^hdfs://[^/]*";
+
+
+DatabaseHDFS::DatabaseHDFS(const String & name_, const String & source_url, ContextPtr context_)
+    : IDatabase(name_)
+    , WithContext(context_->getGlobalContext())
+    , source(source_url)
+    , log(&Poco::Logger::get("DatabaseHDFS(" + name_ + ")"))
+{
+    if (!source.empty())
+    {
+        if (!re2::RE2::FullMatch(source, std::string(HDFS_HOST_REGEXP)))
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs host: {}. It should have structure 'hdfs://<host_name>:<port>'", source);
+        context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(source));
+    }
+}
+
+void DatabaseHDFS::addTable(const std::string & table_name, StoragePtr table_storage) const
+{
+    std::lock_guard lock(mutex);
+    auto [_, inserted] = loaded_tables.emplace(table_name, table_storage);
+    if (!inserted)
+        throw Exception(
+            ErrorCodes::LOGICAL_ERROR,
+            "Table with name `{}` already exists in database `{}` (engine {})",
+            table_name,
+            getDatabaseName(),
+            getEngineName());
+}
+
+std::string DatabaseHDFS::getTablePath(const std::string & table_name) const
+{
+    if (table_name.starts_with("hdfs://"))
+        return table_name;
+    if (source.empty())
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs url: {}. It should have structure 'hdfs://<host_name>:<port>/path'", table_name);
+    return (fs::path(source) / table_name).string();
+}
+
+bool DatabaseHDFS::checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const
+{
+    try
+    {
+        checkHDFSURL(url);
+        context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(url));
+    }
+    catch (...)
+    {
+        if (throw_on_error)
+            throw;
+        return false;
+    }
+
+    return true;
+}
+
+bool DatabaseHDFS::isTableExist(const String & name, ContextPtr context_) const
+{
+    std::lock_guard lock(mutex);
+    if (loaded_tables.find(name) != loaded_tables.end())
+        return true;
+
+    return checkUrl(name, context_, false);
+}
+
+StoragePtr DatabaseHDFS::getTableImpl(const String & name, ContextPtr context_) const
+{
+    // Check if the table exists in the loaded tables map
+    {
+        std::lock_guard lock(mutex);
+        auto it = loaded_tables.find(name);
+        if (it != loaded_tables.end())
+            return it->second;
+    }
+
+    auto url = getTablePath(name);
+
+    checkUrl(url, context_, true);
+
+    // call TableFunctionHDFS
+    auto args = makeASTFunction("hdfs", std::make_shared<ASTLiteral>(url));
+
+    auto table_function = TableFunctionFactory::instance().get(args, context_);
+    if (!table_function)
+        return nullptr;
+
+    // TableFunctionHDFS throws exceptions, if table cannot be created
+    auto table_storage = table_function->execute(args, context_, name);
+    if (table_storage)
+        addTable(name, table_storage);
+
+    return table_storage;
+}
+
+StoragePtr DatabaseHDFS::getTable(const String & name, ContextPtr context_) const
+{
+    // rethrow all exceptions from TableFunctionHDFS to show correct error to user
+    if (auto storage = getTableImpl(name, context_))
+        return storage;
+    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
+}
+
+StoragePtr DatabaseHDFS::tryGetTable(const String & name, ContextPtr context_) const
+{
+    try
+    {
+        return getTableImpl(name, context_);
+    }
+    catch (const Exception & e)
+    {
+        // Ignore exceptions thrown by TableFunctionHDFS, which indicate that there is no table
+        if (e.code() == ErrorCodes::BAD_ARGUMENTS)
+            return nullptr;
+        if (e.code() == ErrorCodes::ACCESS_DENIED)
+            return nullptr;
+        if (e.code() == ErrorCodes::DATABASE_ACCESS_DENIED)
+            return nullptr;
+        if (e.code() == ErrorCodes::FILE_DOESNT_EXIST)
+            return nullptr;
+        if (e.code() == ErrorCodes::UNACCEPTABLE_URL)
+            return nullptr;
+        if (e.code() == ErrorCodes::HDFS_ERROR)
+            return nullptr;
+        if (e.code() == ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE)
+            return nullptr;
+        throw;
+    }
+    catch (const Poco::URISyntaxException &)
+    {
+        return nullptr;
+    }
+}
+
+ASTPtr DatabaseHDFS::getCreateDatabaseQuery() const
+{
+    auto settings = getContext()->getSettingsRef();
+    ParserCreateQuery parser;
+
+    const String query = fmt::format("CREATE DATABASE {} ENGINE = HDFS('{}')", backQuoteIfNeed(getDatabaseName()), source);
+    ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
+
+    if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
+    {
+        auto & ast_create_query = ast->as<ASTCreateQuery &>();
+        ast_create_query.set(ast_create_query.comment, std::make_shared<ASTLiteral>(database_comment));
+    }
+
+    return ast;
+}
+
+void DatabaseHDFS::shutdown()
+{
+    Tables tables_snapshot;
+    {
+        std::lock_guard lock(mutex);
+        tables_snapshot = loaded_tables;
+    }
+
+    for (const auto & kv : tables_snapshot)
+    {
+        auto table_id = kv.second->getStorageID();
+        kv.second->flushAndShutdown();
+    }
+
+    std::lock_guard lock(mutex);
+    loaded_tables.clear();
+}
+
+/**
+ * Returns an empty vector because the database is read-only and no tables can be backed up
+ */
+std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseHDFS::getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const
+{
+    return {};
+}
+
+/**
+ *
+ * Returns an empty iterator because the database does not have its own tables
+ * But only caches them for quick access
+ */
+DatabaseTablesIteratorPtr DatabaseHDFS::getTablesIterator(ContextPtr, const FilterByNameFunction &) const
+{
+    return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
+}
+
+} // DB
+
+#endif
diff --git a/src/Databases/DatabaseHDFS.h b/src/Databases/DatabaseHDFS.h
new file mode 100644
index 00000000000..4e2b8578fcd
--- /dev/null
+++ b/src/Databases/DatabaseHDFS.h
@@ -0,0 +1,65 @@
+#pragma once
+
+#include "config.h"
+
+#if USE_HDFS
+
+#include <mutex>
+#include <Databases/IDatabase.h>
+#include <Parsers/IAST.h>
+#include <Storages/IStorage_fwd.h>
+#include <base/types.h>
+
+namespace DB
+{
+
+class Context;
+
+/**
+  * DatabaseHDFS allows to interact with files stored on the file system
+  * Uses TableFunctionHDFS to implicitly load file when a user requests the table, and provides read-only access to the data in the file
+  * Tables are cached inside the database for quick access
+  */
+class DatabaseHDFS : public IDatabase, protected WithContext
+{
+public:
+    DatabaseHDFS(const String & name, const String & source_url, ContextPtr context);
+
+    String getEngineName() const override { return "S3"; }
+
+    bool isTableExist(const String & name, ContextPtr context) const override;
+
+    StoragePtr getTable(const String & name, ContextPtr context) const override;
+
+    StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
+
+    bool empty() const override { return true; }
+
+    bool isReadOnly() const override { return true; }
+
+    ASTPtr getCreateDatabaseQuery() const override;
+
+    void shutdown() override;
+
+    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
+    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
+
+protected:
+    StoragePtr getTableImpl(const String & url, ContextPtr context) const;
+
+    void addTable(const std::string & table_name, StoragePtr table_storage) const;
+
+    bool checkUrl(const std::string & name, ContextPtr context_, bool throw_on_error) const;
+
+    std::string getTablePath(const std::string & table_name) const;
+
+private:
+    const String source;
+
+    mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
+    Poco::Logger * log;
+};
+
+} // DB
+
+#endif
diff --git a/tests/queries/0_stateless/02725_database_hdfs.reference b/tests/queries/0_stateless/02725_database_hdfs.reference
new file mode 100644
index 00000000000..2a2e6c20aaa
--- /dev/null
+++ b/tests/queries/0_stateless/02725_database_hdfs.reference
@@ -0,0 +1,16 @@
+Test 1: select from hdfs database
+1	2	3
+test1
+1	2	3
+test2
+4	5	6
+Test 2: check exceptions
+OK0
+OK1
+OK2
+OK3
+OK4
+OK5
+OK6
+OK7
+OK8
diff --git a/tests/queries/0_stateless/02725_database_hdfs.sh b/tests/queries/0_stateless/02725_database_hdfs.sh
new file mode 100755
index 00000000000..ea16dd4024c
--- /dev/null
+++ b/tests/queries/0_stateless/02725_database_hdfs.sh
@@ -0,0 +1,66 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest, use-hdfs
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+# Prepare data
+${CLICKHOUSE_CLIENT} -q "insert into table function hdfs('hdfs://localhost:12222/test_02725_1.tsv', 'TSV', 'column1 UInt32, column2 UInt32, column3 UInt32') select 1, 2, 3 settings hdfs_truncate_on_insert=1;"
+${CLICKHOUSE_CLIENT} -q "insert into table function hdfs('hdfs://localhost:12222/test_02725_2.tsv', 'TSV', 'column1 UInt32, column2 UInt32, column3 UInt32') select 4, 5, 6 settings hdfs_truncate_on_insert=1;"
+
+#################
+echo "Test 1: select from hdfs database"
+
+# Database without specific host
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test1;
+CREATE DATABASE test1 ENGINE = HDFS;
+USE test1;
+SELECT * FROM \"hdfs://localhost:12222/test_02725_1.tsv\"
+"""
+${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test1
+
+# Database with host
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test2;
+CREATE DATABASE test2 ENGINE = HDFS('hdfs://localhost:12222');
+USE test2;
+SELECT * FROM \"test_02725_1.tsv\"
+"""
+${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test2
+
+# Check implicit call in clickhouse-local
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222/test_02725_2.tsv\""
+
+#################
+echo "Test 2: check exceptions"
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222/file.myext\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK0"
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222/test_02725_3.tsv\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK1"
+${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK2"
+
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test3;
+CREATE DATABASE test3 ENGINE = HDFS('abacaba');
+""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK3"
+
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test4;
+CREATE DATABASE test4 ENGINE = HDFS;
+USE test4;
+SELECT * FROM \"abacaba/file.tsv\"
+""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK4"
+
+${CLICKHOUSE_CLIENT} -q "SELECT * FROM test4.\`http://localhost:11111/test/a.tsv\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK5"
+${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/file.myext\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK6"
+${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/test_02725_3.tsv\`" 2>&1| grep -F "CANNOT_EXTRACT_TABLE_STRUCTURE" > /dev/null && echo "OK7"
+${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK8"
+
+
+# Cleanup
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test1;
+DROP DATABASE IF EXISTS test2;
+DROP DATABASE IF EXISTS test3;
+DROP DATABASE IF EXISTS test4;
+"""
\ No newline at end of file

From 82bb1e8bf2a3183179938629cc8f6aab3d876e87 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Tue, 2 May 2023 18:51:35 +0000
Subject: [PATCH 068/722] Fix build and try fix tests

---
 src/Databases/DatabaseHDFS.h                     | 4 ++--
 tests/queries/0_stateless/02724_database_s3.sh   | 2 +-
 tests/queries/0_stateless/02725_database_hdfs.sh | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Databases/DatabaseHDFS.h b/src/Databases/DatabaseHDFS.h
index 4e2b8578fcd..9a506c5c8ac 100644
--- a/src/Databases/DatabaseHDFS.h
+++ b/src/Databases/DatabaseHDFS.h
@@ -45,11 +45,11 @@ public:
     DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
 
 protected:
-    StoragePtr getTableImpl(const String & url, ContextPtr context) const;
+    StoragePtr getTableImpl(const String & name, ContextPtr context) const;
 
     void addTable(const std::string & table_name, StoragePtr table_storage) const;
 
-    bool checkUrl(const std::string & name, ContextPtr context_, bool throw_on_error) const;
+    bool checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const;
 
     std::string getTablePath(const std::string & table_name) const;
 
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
index 9b539407884..af858d140d7 100755
--- a/tests/queries/0_stateless/02724_database_s3.sh
+++ b/tests/queries/0_stateless/02724_database_s3.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest
+# Tags: no-fasttest, no-parallel
 # Tag no-fasttest: Depends on AWS
 
 CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
diff --git a/tests/queries/0_stateless/02725_database_hdfs.sh b/tests/queries/0_stateless/02725_database_hdfs.sh
index ea16dd4024c..8d4e982504a 100755
--- a/tests/queries/0_stateless/02725_database_hdfs.sh
+++ b/tests/queries/0_stateless/02725_database_hdfs.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest, use-hdfs
+# Tags: no-fasttest, use-hdfs, no-parallel
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From 58cb6c7837872ae4eb46eed84d5aa0d75607d661 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Tue, 2 May 2023 19:57:36 +0000
Subject: [PATCH 069/722] S3, HDFS only for explicit creation

---
 programs/local/LocalServer.cpp                 | 14 --------------
 .../0_stateless/02724_database_s3.reference    |  5 -----
 tests/queries/0_stateless/02724_database_s3.sh |  4 ----
 .../0_stateless/02725_database_hdfs.reference  |  4 ----
 .../queries/0_stateless/02725_database_hdfs.sh | 18 ++++++------------
 5 files changed, 6 insertions(+), 39 deletions(-)

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 0cf94892171..b413483686a 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -61,14 +61,6 @@
 #   include <azure/storage/common/internal/xml_wrapper.hpp>
 #endif
 
-#if USE_AWS_S3
-#include <Databases/DatabaseS3.h>
-#endif
-
-#if USE_HDFS
-#include <Databases/DatabaseHDFS.h>
-#endif
-
 namespace fs = std::filesystem;
 
 
@@ -165,12 +157,6 @@ static DatabasePtr createClickHouseLocalDatabaseOverlay(const String & name_, Co
     auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFilesystem>(name_, "", context_));
     databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
-#if USE_AWS_S3
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseS3>(name_, "", "", context_));
-#endif
-#if USE_HDFS
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseHDFS>(name_, "", context_));
-#endif
     return databaseCombiner;
 }
 
diff --git a/tests/queries/0_stateless/02724_database_s3.reference b/tests/queries/0_stateless/02724_database_s3.reference
index b3800a27305..72ba0e240b1 100644
--- a/tests/queries/0_stateless/02724_database_s3.reference
+++ b/tests/queries/0_stateless/02724_database_s3.reference
@@ -8,11 +8,6 @@ test1
 13	14	15
 16	17	18
 0	0	0
-10	11	12
-13	14	15
-16	17	18
-0	0	0
 Test 2: check exceptions
 OK
 OK
-OK
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
index af858d140d7..2758580a355 100755
--- a/tests/queries/0_stateless/02724_database_s3.sh
+++ b/tests/queries/0_stateless/02724_database_s3.sh
@@ -25,12 +25,8 @@ SELECT * FROM \"http://localhost:11111/test/b.tsv\"
 """
 ${CLICKHOUSE_CLIENT} -q "DROP DATABASE test2;"
 
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"http://localhost:11111/test/b.tsv\""
-
 #################
 echo "Test 2: check exceptions"
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"http://localhost:11111/test/c.myext\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK"
-
 ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test3;
 CREATE DATABASE test3 ENGINE = S3;
diff --git a/tests/queries/0_stateless/02725_database_hdfs.reference b/tests/queries/0_stateless/02725_database_hdfs.reference
index 2a2e6c20aaa..ef8adae2bbc 100644
--- a/tests/queries/0_stateless/02725_database_hdfs.reference
+++ b/tests/queries/0_stateless/02725_database_hdfs.reference
@@ -3,7 +3,6 @@ Test 1: select from hdfs database
 test1
 1	2	3
 test2
-4	5	6
 Test 2: check exceptions
 OK0
 OK1
@@ -11,6 +10,3 @@ OK2
 OK3
 OK4
 OK5
-OK6
-OK7
-OK8
diff --git a/tests/queries/0_stateless/02725_database_hdfs.sh b/tests/queries/0_stateless/02725_database_hdfs.sh
index 8d4e982504a..a78f3e6bbdc 100755
--- a/tests/queries/0_stateless/02725_database_hdfs.sh
+++ b/tests/queries/0_stateless/02725_database_hdfs.sh
@@ -30,31 +30,25 @@ SELECT * FROM \"test_02725_1.tsv\"
 """
 ${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test2
 
-# Check implicit call in clickhouse-local
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222/test_02725_2.tsv\""
-
 #################
 echo "Test 2: check exceptions"
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222/file.myext\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK0"
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222/test_02725_3.tsv\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK1"
-${CLICKHOUSE_LOCAL} --query "SELECT * FROM \"hdfs://localhost:12222\"" 2>&1| grep -F "UNKNOWN_TABLE" > /dev/null && echo "OK2"
 
 ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test3;
 CREATE DATABASE test3 ENGINE = HDFS('abacaba');
-""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK3"
+""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK0"
 
 ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test4;
 CREATE DATABASE test4 ENGINE = HDFS;
 USE test4;
 SELECT * FROM \"abacaba/file.tsv\"
-""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK4"
+""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK1"
 
-${CLICKHOUSE_CLIENT} -q "SELECT * FROM test4.\`http://localhost:11111/test/a.tsv\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK5"
-${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/file.myext\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK6"
-${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/test_02725_3.tsv\`" 2>&1| grep -F "CANNOT_EXTRACT_TABLE_STRUCTURE" > /dev/null && echo "OK7"
-${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK8"
+${CLICKHOUSE_CLIENT} -q "SELECT * FROM test4.\`http://localhost:11111/test/a.tsv\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK2"
+${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/file.myext\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK3"
+${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/test_02725_3.tsv\`" 2>&1| grep -F "CANNOT_EXTRACT_TABLE_STRUCTURE" > /dev/null && echo "OK4"
+${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK5"
 
 
 # Cleanup

From 963d6be120da9c00c583cec2a051f9386de47b0e Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Thu, 4 May 2023 16:44:08 +0000
Subject: [PATCH 070/722] Added configurations for DatabaseS3

---
 src/Databases/DatabaseFactory.cpp             |  13 +-
 src/Databases/DatabaseS3.cpp                  | 159 +++++++++++++++---
 src/Databases/DatabaseS3.h                    |  20 ++-
 tests/config/config.d/named_collection.xml    |   5 +
 .../0_stateless/02724_database_s3.reference   |  12 ++
 .../queries/0_stateless/02724_database_s3.sh  |  28 ++-
 6 files changed, 202 insertions(+), 35 deletions(-)

diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 5c4256c8a9f..41ca1de6a0e 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -466,20 +466,15 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
     {
         const ASTFunction * engine = engine_define->engine;
 
-        std::string key_id;
-        std::string secret_key;
+        DatabaseS3::Configuration config;
 
         if (engine->arguments && !engine->arguments->children.empty())
         {
-            if (engine->arguments->children.size() != 2)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "S3 database requires 0 or 2 argument: [access_key_id, secret_access_key]");
-
-            const auto & arguments = engine->arguments->children;
-            key_id = safeGetLiteralValue<String>(arguments[0], engine_name);
-            secret_key = safeGetLiteralValue<String>(arguments[1], engine_name);
+            ASTs & engine_args = engine->arguments->children;
+            config = DatabaseS3::parseArguments(engine_args, context);
         }
 
-        return std::make_shared<DatabaseS3>(database_name, key_id, secret_key, context);
+        return std::make_shared<DatabaseS3>(database_name, config, context);
     }
 #endif
 
diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
index d4412ba7973..f4aafc5d03a 100644
--- a/src/Databases/DatabaseS3.cpp
+++ b/src/Databases/DatabaseS3.cpp
@@ -4,19 +4,36 @@
 
 #include <Databases/DatabaseS3.h>
 
-#include <IO/S3/URI.h>
 #include <Interpreters/Context.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <IO/S3/URI.h>
 #include <Parsers/ASTCreateQuery.h>
 #include <Parsers/ASTFunction.h>
 #include <Parsers/ASTLiteral.h>
-#include <Parsers/ParserCreateQuery.h>
 #include <Parsers/parseQuery.h>
+#include <Parsers/ParserCreateQuery.h>
+#include <Storages/checkAndGetLiteralArgument.h>
 #include <Storages/IStorage.h>
+#include <Storages/NamedCollectionsHelpers.h>
 #include <TableFunctions/TableFunctionFactory.h>
 
+#include <boost/algorithm/string.hpp>
+#include <filesystem>
+
+#include "DatabaseS3.h"
+
+namespace fs = std::filesystem;
+
 namespace DB
 {
 
+static const std::unordered_set<std::string_view> optional_configuration_keys = {
+    "url",
+    "access_key_id",
+    "secret_access_key",
+    "no_sign_request"
+};
+
 namespace ErrorCodes
 {
     extern const int LOGICAL_ERROR;
@@ -25,13 +42,14 @@ namespace ErrorCodes
     extern const int FILE_DOESNT_EXIST;
     extern const int UNACCEPTABLE_URL;
     extern const int S3_ERROR;
+
+    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
 }
 
-DatabaseS3::DatabaseS3(const String & name_, const String & key_id, const String & secret_key, ContextPtr context_)
+DatabaseS3::DatabaseS3(const String & name_, const Configuration& config_, ContextPtr context_)
     : IDatabase(name_)
     , WithContext(context_->getGlobalContext())
-    , access_key_id(key_id)
-    , secret_access_key(secret_key)
+    , config(config_)
     , log(&Poco::Logger::get("DatabaseS3(" + name_ + ")"))
 {
 }
@@ -49,6 +67,20 @@ void DatabaseS3::addTable(const std::string & table_name, StoragePtr table_stora
             getEngineName());
 }
 
+std::string DatabaseS3::getFullUrl(const std::string & name) const
+{
+    try
+    {
+        S3::URI uri(name);
+    }
+    catch (...)
+    {
+        return (fs::path(config.url_prefix) / name).string();
+    }
+
+    return name;
+}
+
 bool DatabaseS3::checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const
 {
     try
@@ -71,36 +103,49 @@ bool DatabaseS3::isTableExist(const String & name, ContextPtr context_) const
     if (loaded_tables.find(name) != loaded_tables.end())
         return true;
 
-    return checkUrl(name, context_, false);
+    return checkUrl(getFullUrl(name), context_, false);
 }
 
-StoragePtr DatabaseS3::getTableImpl(const String & url, ContextPtr context_) const
+StoragePtr DatabaseS3::getTableImpl(const String & name, ContextPtr context_) const
 {
     // Check if the table exists in the loaded tables map
     {
         std::lock_guard lock(mutex);
-        auto it = loaded_tables.find(url);
+        auto it = loaded_tables.find(name);
         if (it != loaded_tables.end())
             return it->second;
     }
 
+    auto url = getFullUrl(name);
+
     checkUrl(url, context_, true);
 
     // call TableFunctionS3
-    auto args = makeASTFunction(
-        "s3",
-        std::make_shared<ASTLiteral>(url),
-        std::make_shared<ASTLiteral>(access_key_id),
-        std::make_shared<ASTLiteral>(secret_access_key));
+    auto function = std::make_shared<ASTFunction>();
 
-    auto table_function = TableFunctionFactory::instance().get(args, context_);
+    function->name = "s3";
+    function->arguments = std::make_shared<ASTExpressionList>();
+    function->children.push_back(function->arguments);
+
+    function->arguments->children.push_back(std::make_shared<ASTLiteral>(url));
+    if (config.no_sign_request)
+    {
+        function->arguments->children.push_back(std::make_shared<ASTLiteral>("NOSIGN"));
+    }
+    else if (config.access_key_id.has_value() && config.secret_access_key.has_value())
+    {
+        function->arguments->children.push_back(std::make_shared<ASTLiteral>(config.access_key_id.value()));
+        function->arguments->children.push_back(std::make_shared<ASTLiteral>(config.secret_access_key.value()));
+    }
+
+    auto table_function = TableFunctionFactory::instance().get(function, context_);
     if (!table_function)
         return nullptr;
 
     // TableFunctionS3 throws exceptions, if table cannot be created
-    auto table_storage = table_function->execute(args, context_, url);
+    auto table_storage = table_function->execute(function, context_, name);
     if (table_storage)
-        addTable(url, table_storage);
+        addTable(name, table_storage);
 
     return table_storage;
 }
@@ -143,10 +188,14 @@ ASTPtr DatabaseS3::getCreateDatabaseQuery() const
     auto settings = getContext()->getSettingsRef();
     ParserCreateQuery parser;
 
-    const String query = fmt::format("CREATE DATABASE {} ENGINE = S3('{}', '{}')",
-                                     backQuoteIfNeed(getDatabaseName()),
-                                     access_key_id,
-                                     secret_access_key);
+    std::string creation_args;
+    creation_args += fmt::format("'{}'", config.url_prefix);
+    if (config.no_sign_request)
+        creation_args += ", 'NOSIGN'";
+    else if (config.access_key_id.has_value() && config.secret_access_key.has_value())
+        creation_args += fmt::format(", '{}', '{}'", config.access_key_id.value(), config.secret_access_key.value());
+
+    const String query = fmt::format("CREATE DATABASE {} ENGINE = S3({})", backQuoteIfNeed(getDatabaseName()), creation_args);
     ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
 
     if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
@@ -176,6 +225,76 @@ void DatabaseS3::shutdown()
     loaded_tables.clear();
 }
 
+DatabaseS3::Configuration DatabaseS3::parseArguments(ASTs engine_args, ContextPtr context_)
+{
+    Configuration result;
+
+    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context_))
+    {
+        auto & collection = *named_collection;
+
+        validateNamedCollection(collection, {}, optional_configuration_keys);
+
+        result.url_prefix = collection.getOrDefault<String>("url", "");
+        result.no_sign_request = collection.getOrDefault<bool>("no_sign_request", false);
+
+        auto key_id = collection.getOrDefault<std::string>("access_key_id", "");
+        auto secret_key = collection.getOrDefault<std::string>("secret_access_key", "");
+
+        if (!key_id.empty())
+            result.access_key_id = key_id;
+
+        if (!secret_key.empty())
+            result.secret_access_key = secret_key;
+    }
+    else
+    {
+        auto supported_signature =
+            " - S3()\n"
+            " - S3('url')\n"
+            " - S3('url', 'NOSIGN')\n"
+            " - S3('url', 'access_key_id', 'secret_access_key')\n";
+        const auto error_message =
+            fmt::format("Engine DatabaseS3 must have the following arguments signature\n{}",  supported_signature);
+
+        for (auto & arg : engine_args)
+            arg = evaluateConstantExpressionOrIdentifierAsLiteral(arg, context_);
+
+        if (engine_args.size() > 3)
+            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, error_message.c_str());
+
+        if (engine_args.empty())
+            return result;
+
+        result.url_prefix = checkAndGetLiteralArgument<String>(engine_args[0], "url");
+
+        // url, NOSIGN
+        if (engine_args.size() == 2)
+        {
+            auto second_arg = checkAndGetLiteralArgument<String>(engine_args[1], "NOSIGN");
+            if (boost::iequals(second_arg, "NOSIGN"))
+                result.no_sign_request = true;
+            else
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, error_message.c_str());
+        }
+
+        // url, access_key_id, secret_access_key
+        if (engine_args.size() == 3)
+        {
+            auto key_id = checkAndGetLiteralArgument<String>(engine_args[1], "access_key_id");
+            auto secret_key = checkAndGetLiteralArgument<String>(engine_args[2], "secret_access_key");
+
+            if (key_id.empty() || secret_key.empty() || boost::iequals(key_id, "NOSIGN"))
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, error_message.c_str());
+
+            result.access_key_id = key_id;
+            result.secret_access_key = secret_key;
+        }
+    }
+
+    return result;
+}
+
 /**
  * Returns an empty vector because the database is read-only and no tables can be backed up
  */
diff --git a/src/Databases/DatabaseS3.h b/src/Databases/DatabaseS3.h
index d5269e57f5a..65f80dca2ba 100644
--- a/src/Databases/DatabaseS3.h
+++ b/src/Databases/DatabaseS3.h
@@ -23,7 +23,17 @@ class Context;
 class DatabaseS3 : public IDatabase, protected WithContext
 {
 public:
-    DatabaseS3(const String & name, const String & key_id, const String & secret_key, ContextPtr context);
+    struct Configuration
+    {
+        std::string url_prefix;
+
+        bool no_sign_request = false;
+
+        std::optional<std::string> access_key_id;
+        std::optional<std::string> secret_access_key;
+    };
+
+    DatabaseS3(const String & name, const Configuration& config, ContextPtr context);
 
     String getEngineName() const override { return "S3"; }
 
@@ -44,6 +54,8 @@ public:
     std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
     DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
 
+    static Configuration parseArguments(ASTs engine_args, ContextPtr context);
+
 protected:
     StoragePtr getTableImpl(const String & url, ContextPtr context) const;
 
@@ -51,9 +63,11 @@ protected:
 
     bool checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const;
 
+    std::string getFullUrl(const std::string & name) const;
+
 private:
-    const String access_key_id;
-    const String secret_access_key;
+    const Configuration config;
+
     mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
     Poco::Logger * log;
 };
diff --git a/tests/config/config.d/named_collection.xml b/tests/config/config.d/named_collection.xml
index 2e49c0c596f..5b716a7b8da 100644
--- a/tests/config/config.d/named_collection.xml
+++ b/tests/config/config.d/named_collection.xml
@@ -32,5 +32,10 @@
             <secret_access_key>testtest</secret_access_key>
             <structure>auto</structure>
         </s3_conn>
+        <s3_conn_db>
+            <url>http://localhost:11111/test/</url>
+            <access_key_id>test</access_key_id>
+            <secret_access_key>testtest</secret_access_key>
+        </s3_conn_db>
     </named_collections>
 </clickhouse>
diff --git a/tests/queries/0_stateless/02724_database_s3.reference b/tests/queries/0_stateless/02724_database_s3.reference
index 72ba0e240b1..811e38b7f2b 100644
--- a/tests/queries/0_stateless/02724_database_s3.reference
+++ b/tests/queries/0_stateless/02724_database_s3.reference
@@ -8,6 +8,18 @@ test1
 13	14	15
 16	17	18
 0	0	0
+10	11	12
+13	14	15
+16	17	18
+0	0	0
+1	2	3
+4	5	6
+7	8	9
+0	0	0
+10	11	12
+13	14	15
+16	17	18
+0	0	0
 Test 2: check exceptions
 OK
 OK
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
index 2758580a355..ac1b97beecf 100755
--- a/tests/queries/0_stateless/02724_database_s3.sh
+++ b/tests/queries/0_stateless/02724_database_s3.sh
@@ -15,15 +15,35 @@ USE test1;
 SELECT * FROM \"http://localhost:11111/test/a.tsv\"
 """
 ${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test1
-${CLICKHOUSE_CLIENT} -q "DROP DATABASE test1;"
 
+# check credentials with absolute path
 ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test2;
-CREATE DATABASE test2 ENGINE = S3('test', 'testtest');
+CREATE DATABASE test2 ENGINE = S3('', 'test', 'testtest');
 USE test2;
 SELECT * FROM \"http://localhost:11111/test/b.tsv\"
 """
-${CLICKHOUSE_CLIENT} -q "DROP DATABASE test2;"
+
+# check credentials with relative path
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test4;
+CREATE DATABASE test4 ENGINE = S3('http://localhost:11111/test', 'test', 'testtest');
+USE test4;
+SELECT * FROM \"b.tsv\"
+"""
+
+# check that database url_prefix is ignored if pass full url as table name
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+USE test4;
+SELECT * FROM \"http://localhost:11111/test/a.tsv\"
+"""
+
+# Check named collection loading
+${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
+DROP DATABASE IF EXISTS test5;
+CREATE DATABASE test5 ENGINE = S3(s3_conn_db);
+SELECT * FROM test5.\`b.tsv\`
+"""
 
 #################
 echo "Test 2: check exceptions"
@@ -44,4 +64,6 @@ ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test1;
 DROP DATABASE IF EXISTS test2;
 DROP DATABASE IF EXISTS test3;
+DROP DATABASE IF EXISTS test4;
+DROP DATABASE IF EXISTS test5;
 """

From f083372c0cd5618b07873e886078ac86aecf54cd Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Thu, 4 May 2023 16:46:51 +0000
Subject: [PATCH 071/722] remove extra include

---
 src/Databases/DatabaseS3.cpp | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
index f4aafc5d03a..5529f582572 100644
--- a/src/Databases/DatabaseS3.cpp
+++ b/src/Databases/DatabaseS3.cpp
@@ -20,8 +20,6 @@
 #include <boost/algorithm/string.hpp>
 #include <filesystem>
 
-#include "DatabaseS3.h"
-
 namespace fs = std::filesystem;
 
 namespace DB

From 814a3f04cd421c991e6976fa314f13e96e96069f Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Thu, 4 May 2023 17:12:35 +0000
Subject: [PATCH 072/722] fix style

---
 src/Databases/DatabaseS3.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
index 5529f582572..bc318ecd9bf 100644
--- a/src/Databases/DatabaseS3.cpp
+++ b/src/Databases/DatabaseS3.cpp
@@ -253,7 +253,7 @@ DatabaseS3::Configuration DatabaseS3::parseArguments(ASTs engine_args, ContextPt
             " - S3('url', 'NOSIGN')\n"
             " - S3('url', 'access_key_id', 'secret_access_key')\n";
         const auto error_message =
-            fmt::format("Engine DatabaseS3 must have the following arguments signature\n{}",  supported_signature);
+            fmt::format("Engine DatabaseS3 must have the following arguments signature\n{}", supported_signature);
 
         for (auto & arg : engine_args)
             arg = evaluateConstantExpressionOrIdentifierAsLiteral(arg, context_);

From 367583b96ea53a5203163a90e49581b2bdf225de Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Thu, 4 May 2023 17:38:41 +0000
Subject: [PATCH 073/722] retriger checks


From a218f010e85c0bc995df17f5416bee4bcd8e6148 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 5 May 2023 14:12:14 +0200
Subject: [PATCH 074/722] First portion of speedup

Do not generate DateLUT for each serialized and deserialized
date
---
 src/Common/LocalDate.h                           |  8 ++++----
 .../Serializations/SerializationDate.cpp         | 11 +++++++----
 src/DataTypes/Serializations/SerializationDate.h |  5 ++++-
 src/Functions/FunctionsConversion.h              | 12 ++++++------
 src/IO/ReadHelpers.h                             | 16 ++++++++--------
 src/IO/WriteHelpers.h                            |  8 ++++----
 6 files changed, 33 insertions(+), 27 deletions(-)

diff --git a/src/Common/LocalDate.h b/src/Common/LocalDate.h
index dc36f92bebf..4a383129ae4 100644
--- a/src/Common/LocalDate.h
+++ b/src/Common/LocalDate.h
@@ -61,17 +61,17 @@ public:
         init(time);
     }
 
-    LocalDate(DayNum day_num) /// NOLINT
+    LocalDate(DayNum day_num, const DateLUTImpl & time_zone = DateLUT::instance()) /// NOLINT
     {
-        const auto & values = DateLUT::instance().getValues(day_num);
+        const auto & values = time_zone.getValues(day_num);
         m_year  = values.year;
         m_month = values.month;
         m_day   = values.day_of_month;
     }
 
-    explicit LocalDate(ExtendedDayNum day_num)
+    explicit LocalDate(ExtendedDayNum day_num, const DateLUTImpl & time_zone = DateLUT::instance())
     {
-        const auto & values = DateLUT::instance().getValues(day_num);
+        const auto & values = time_zone.getValues(day_num);
         m_year  = values.year;
         m_month = values.month;
         m_day   = values.day_of_month;
diff --git a/src/DataTypes/Serializations/SerializationDate.cpp b/src/DataTypes/Serializations/SerializationDate.cpp
index 678817017e0..bc2057d549e 100644
--- a/src/DataTypes/Serializations/SerializationDate.cpp
+++ b/src/DataTypes/Serializations/SerializationDate.cpp
@@ -13,7 +13,7 @@ namespace DB
 
 void SerializationDate::serializeText(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const
 {
-    writeDateText(DayNum(assert_cast<const ColumnUInt16 &>(column).getData()[row_num]), ostr);
+    writeDateText(DayNum(assert_cast<const ColumnUInt16 &>(column).getData()[row_num]), ostr, time_zone);
 }
 
 void SerializationDate::deserializeWholeText(IColumn & column, ReadBuffer & istr, const FormatSettings & settings) const
@@ -26,7 +26,7 @@ void SerializationDate::deserializeWholeText(IColumn & column, ReadBuffer & istr
 void SerializationDate::deserializeTextEscaped(IColumn & column, ReadBuffer & istr, const FormatSettings &) const
 {
     DayNum x;
-    readDateText(x, istr);
+    readDateText(x, istr, time_zone);
     assert_cast<ColumnUInt16 &>(column).getData().push_back(x);
 }
 
@@ -46,7 +46,7 @@ void SerializationDate::deserializeTextQuoted(IColumn & column, ReadBuffer & ist
 {
     DayNum x;
     assertChar('\'', istr);
-    readDateText(x, istr);
+    readDateText(x, istr, time_zone);
     assertChar('\'', istr);
     assert_cast<ColumnUInt16 &>(column).getData().push_back(x);    /// It's important to do this at the end - for exception safety.
 }
@@ -62,7 +62,7 @@ void SerializationDate::deserializeTextJSON(IColumn & column, ReadBuffer & istr,
 {
     DayNum x;
     assertChar('"', istr);
-    readDateText(x, istr);
+    readDateText(x, istr, time_zone);
     assertChar('"', istr);
     assert_cast<ColumnUInt16 &>(column).getData().push_back(x);
 }
@@ -80,5 +80,8 @@ void SerializationDate::deserializeTextCSV(IColumn & column, ReadBuffer & istr,
     readCSV(value, istr);
     assert_cast<ColumnUInt16 &>(column).getData().push_back(value);
 }
+SerializationDate::SerializationDate(const TimezoneMixin & time_zone_) : TimezoneMixin(time_zone_)
+{
+}
 
 }
diff --git a/src/DataTypes/Serializations/SerializationDate.h b/src/DataTypes/Serializations/SerializationDate.h
index 099d7444c3d..c4e57470673 100644
--- a/src/DataTypes/Serializations/SerializationDate.h
+++ b/src/DataTypes/Serializations/SerializationDate.h
@@ -1,13 +1,16 @@
 #pragma once
 
 #include <DataTypes/Serializations/SerializationNumber.h>
+#include <DataTypes/TimezoneMixin.h>
 
 namespace DB
 {
 
-class SerializationDate final : public SerializationNumber<UInt16>
+class SerializationDate final : public SerializationNumber<UInt16>, public TimezoneMixin
 {
 public:
+    explicit SerializationDate(const TimezoneMixin & time_zone_ = TimezoneMixin());
+
     void serializeText(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
     void deserializeWholeText(IColumn & column, ReadBuffer & istr, const FormatSettings &) const override;
     void serializeTextEscaped(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 28002d34acc..645504df829 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -718,9 +718,9 @@ template <>
 struct FormatImpl<DataTypeDate>
 {
     template <typename ReturnType = void>
-    static ReturnType execute(const DataTypeDate::FieldType x, WriteBuffer & wb, const DataTypeDate *, const DateLUTImpl *)
+    static ReturnType execute(const DataTypeDate::FieldType x, WriteBuffer & wb, const DataTypeDate *, const DateLUTImpl * time_zone)
     {
-        writeDateText(DayNum(x), wb);
+        writeDateText(DayNum(x), wb, *time_zone);
         return ReturnType(true);
     }
 };
@@ -729,9 +729,9 @@ template <>
 struct FormatImpl<DataTypeDate32>
 {
     template <typename ReturnType = void>
-    static ReturnType execute(const DataTypeDate32::FieldType x, WriteBuffer & wb, const DataTypeDate32 *, const DateLUTImpl *)
+    static ReturnType execute(const DataTypeDate32::FieldType x, WriteBuffer & wb, const DataTypeDate32 *, const DateLUTImpl * time_zone)
     {
-        writeDateText(ExtendedDayNum(x), wb);
+        writeDateText(ExtendedDayNum(x), wb, *time_zone);
         return ReturnType(true);
     }
 };
@@ -830,8 +830,8 @@ struct ConvertImpl<FromDataType, DataTypeString, Name, ConvertDefaultBehaviorTag
         const auto & type = static_cast<const FromDataType &>(*col_with_type_and_name.type);
 
         const DateLUTImpl * time_zone = nullptr;
-        /// For argument of DateTime type, second argument with time zone could be specified.
-        if constexpr (std::is_same_v<FromDataType, DataTypeDateTime> || std::is_same_v<FromDataType, DataTypeDateTime64>)
+        /// For argument of Date or DateTime type, second argument with time zone could be specified.
+        if constexpr (std::is_same_v<FromDataType, DataTypeDateTime> || std::is_same_v<FromDataType, DataTypeDateTime64> || std::is_same_v<FromDataType, DataTypeDate>)
         {
             auto non_null_args = createBlockWithNestedColumns(arguments);
             time_zone = &extractTimeZoneFromFunctionArguments(non_null_args, 1, 0);
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 0b0a0640cb1..0127809c832 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -723,7 +723,7 @@ inline void convertToDayNum(DayNum & date, ExtendedDayNum & from)
 }
 
 template <typename ReturnType = void>
-inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf)
+inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
 {
     static constexpr bool throw_exception = std::is_same_v<ReturnType, void>;
 
@@ -734,13 +734,13 @@ inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf)
     else if (!readDateTextImpl<ReturnType>(local_date, buf))
         return false;
 
-    ExtendedDayNum ret = DateLUT::instance().makeDayNum(local_date.year(), local_date.month(), local_date.day());
+    ExtendedDayNum ret = date_lut.makeDayNum(local_date.year(), local_date.month(), local_date.day());
     convertToDayNum(date,ret);
     return ReturnType(true);
 }
 
 template <typename ReturnType = void>
-inline ReturnType readDateTextImpl(ExtendedDayNum & date, ReadBuffer & buf)
+inline ReturnType readDateTextImpl(ExtendedDayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
 {
     static constexpr bool throw_exception = std::is_same_v<ReturnType, void>;
 
@@ -752,7 +752,7 @@ inline ReturnType readDateTextImpl(ExtendedDayNum & date, ReadBuffer & buf)
         return false;
 
     /// When the parameter is out of rule or out of range, Date32 uses 1925-01-01 as the default value (-DateLUT::instance().getDayNumOffsetEpoch(), -16436) and Date uses 1970-01-01.
-    date = DateLUT::instance().makeDayNum(local_date.year(), local_date.month(), local_date.day(), -static_cast<Int32>(DateLUT::instance().getDayNumOffsetEpoch()));
+    date = date_lut.makeDayNum(local_date.year(), local_date.month(), local_date.day(), -static_cast<Int32>(date_lut.getDayNumOffsetEpoch()));
     return ReturnType(true);
 }
 
@@ -762,14 +762,14 @@ inline void readDateText(LocalDate & date, ReadBuffer & buf)
     readDateTextImpl<void>(date, buf);
 }
 
-inline void readDateText(DayNum & date, ReadBuffer & buf)
+inline void readDateText(DayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
 {
-    readDateTextImpl<void>(date, buf);
+    readDateTextImpl<void>(date, buf, date_lut);
 }
 
-inline void readDateText(ExtendedDayNum & date, ReadBuffer & buf)
+inline void readDateText(ExtendedDayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
 {
-    readDateTextImpl<void>(date, buf);
+    readDateTextImpl<void>(date, buf, date_lut);
 }
 
 inline bool tryReadDateText(LocalDate & date, ReadBuffer & buf)
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index e08e451e0a7..9ee11d3cc9f 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -694,15 +694,15 @@ inline void writeDateText(const LocalDate & date, WriteBuffer & buf)
 }
 
 template <char delimiter = '-'>
-inline void writeDateText(DayNum date, WriteBuffer & buf)
+inline void writeDateText(DayNum date, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
-    writeDateText<delimiter>(LocalDate(date), buf);
+    writeDateText<delimiter>(LocalDate(date, time_zone), buf);
 }
 
 template <char delimiter = '-'>
-inline void writeDateText(ExtendedDayNum date, WriteBuffer & buf)
+inline void writeDateText(ExtendedDayNum date, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
-    writeDateText<delimiter>(LocalDate(date), buf);
+    writeDateText<delimiter>(LocalDate(date, time_zone), buf);
 }
 
 /// In the format YYYY-MM-DD HH:MM:SS

From 2b08801ae9bc1ca456247282ebfe060a9df0bce4 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 5 May 2023 15:50:19 +0200
Subject: [PATCH 075/722] add timezone param

---
 src/IO/WriteHelpers.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index 9ee11d3cc9f..8a7cd72f79a 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -883,7 +883,7 @@ inline void writeText(is_enum auto x, WriteBuffer & buf) { writeText(magic_enum:
 
 inline void writeText(std::string_view x, WriteBuffer & buf) { writeString(x.data(), x.size(), buf); }
 
-inline void writeText(const DayNum & x, WriteBuffer & buf) { writeDateText(LocalDate(x), buf); }
+inline void writeText(const DayNum & x, WriteBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance()) { writeDateText(LocalDate(x, time_zone), buf); }
 inline void writeText(const LocalDate & x, WriteBuffer & buf) { writeDateText(x, buf); }
 inline void writeText(const LocalDateTime & x, WriteBuffer & buf) { writeDateTimeText(x, buf); }
 inline void writeText(const UUID & x, WriteBuffer & buf) { writeUUIDText(x, buf); }

From e1151f150f23e0bbcb52ae0a1a3ef01a0ecb97da Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Fri, 5 May 2023 18:37:25 +0000
Subject: [PATCH 076/722] Fix clang build errors

---
 src/Databases/DatabaseS3.cpp | 2 +-
 src/Databases/DatabaseS3.h   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
index bc318ecd9bf..96616426475 100644
--- a/src/Databases/DatabaseS3.cpp
+++ b/src/Databases/DatabaseS3.cpp
@@ -247,7 +247,7 @@ DatabaseS3::Configuration DatabaseS3::parseArguments(ASTs engine_args, ContextPt
     }
     else
     {
-        auto supported_signature =
+        const std::string supported_signature =
             " - S3()\n"
             " - S3('url')\n"
             " - S3('url', 'NOSIGN')\n"
diff --git a/src/Databases/DatabaseS3.h b/src/Databases/DatabaseS3.h
index 65f80dca2ba..4e6910566df 100644
--- a/src/Databases/DatabaseS3.h
+++ b/src/Databases/DatabaseS3.h
@@ -57,7 +57,7 @@ public:
     static Configuration parseArguments(ASTs engine_args, ContextPtr context);
 
 protected:
-    StoragePtr getTableImpl(const String & url, ContextPtr context) const;
+    StoragePtr getTableImpl(const String & name, ContextPtr context) const;
 
     void addTable(const std::string & table_name, StoragePtr table_storage) const;
 

From 18d1a4356d2ba1e7502d0ba207e6ac8f53fc3e02 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Fri, 5 May 2023 12:19:35 -0700
Subject: [PATCH 077/722] Change SHOW COLUMNS query to display MySQL types in
 MySQL Compatibility mode

This updates the SHOW COLUMN SQL query to display MySQL types when this
query is issued by a client connected via MySQL Compatibility port
---
 .../InterpreterShowColumnsQuery.cpp           |  78 ++++++-
 .../InterpreterShowColumnsQuery.h             |   1 +
 ...show_columns_mysql_compatibility.reference | 213 ++++++++++++++++++
 .../02726_show_columns_mysql_compatibility.sh | 115 ++++++++++
 4 files changed, 405 insertions(+), 2 deletions(-)
 create mode 100644 tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
 create mode 100755 tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh

diff --git a/src/Interpreters/InterpreterShowColumnsQuery.cpp b/src/Interpreters/InterpreterShowColumnsQuery.cpp
index 4474be21d8b..17ccafdd1ce 100644
--- a/src/Interpreters/InterpreterShowColumnsQuery.cpp
+++ b/src/Interpreters/InterpreterShowColumnsQuery.cpp
@@ -26,11 +26,17 @@ String InterpreterShowColumnsQuery::getRewrittenQuery()
 
     WriteBufferFromOwnString rewritten_query;
 
-    rewritten_query << "SELECT name AS field, type AS type, startsWith(type, 'Nullable') AS null, trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key, if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default, '' AS extra ";
-
     // TODO Interpret query.extended. It is supposed to show internal/virtual columns. Need to fetch virtual column names, see
     // IStorage::getVirtuals(). We can't easily do that via SQL.
 
+    // If connected via MySQL Compatibility mode, convert ClickHouse types to MySQL
+    if (getContext()->getClientInfo().interface == DB::ClientInfo::Interface::MYSQL)
+    {
+        rewritten_query << getMySQLQuery();
+    }
+    else {
+        rewritten_query << "SELECT name AS field, type AS type, startsWith(type, 'Nullable') AS null, trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key, if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default, '' AS extra ";
+    }
     if (query.full)
     {
         /// "Full" mode is mostly for MySQL compat
@@ -93,6 +99,74 @@ String InterpreterShowColumnsQuery::getRewrittenQuery()
 
 }
 
+String InterpreterShowColumnsQuery::getMySQLQuery()
+{
+    WriteBufferFromOwnString mysql_specific_query;
+
+    mysql_specific_query << "SELECT name AS field, "
+        << "CASE "
+        << "  WHEN startsWith(type, 'Nullable') THEN "
+        << "    CASE "
+        << "      WHEN substring(type, 10, length(type) - 10) IN ('UInt8', 'Int8') THEN 'tinyint' "
+        << "      WHEN substring(type, 10, length(type) - 10) IN ('UInt16', 'Int16') THEN 'smallint' "
+        << "      WHEN substring(type, 10, length(type) - 10) IN ('UInt32', 'Int32') THEN 'int' "
+        << "      WHEN substring(type, 10, length(type) - 10) IN ('UInt64', 'Int64', 'UInt128', 'Int128', 'UInt256', 'Int256') THEN 'bigint' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'Float32' THEN 'float' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'Float64' THEN 'double' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'Decimal%' THEN 'decimal' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'Boolean' THEN 'tinyint' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'String' THEN 'text' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'FixedString%' THEN 'text' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'Date%' THEN 'date' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'DateTime%' THEN 'datetime' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'JSON' THEN 'json' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'UUID' THEN 'binary' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'Enum%' THEN 'enum' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'LowCardinality%' THEN 'text' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'Array%' THEN 'json' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'Map%' THEN 'json' "
+        << "      WHEN substring(type, 10, length(type) - 10) IN ('SimpleAggregateFunction', 'AggregateFunction') THEN 'text' "
+        << "      WHEN substring(type, 10, length(type) - 10) = 'Nested' THEN 'json' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'Tuple%' THEN 'json' "
+        << "      WHEN substring(type, 10, length(type) - 10) LIKE 'IPv%' THEN 'text' "
+        << "      WHEN substring(type, 10, length(type) - 10) IN ('Expression', 'Set', 'Nothing', 'Interval') THEN 'text' "
+        << "      ELSE substring(type, 10, length(type) - 10) "
+        << "    END "
+        << "  ELSE "
+        << "    CASE "
+        << "      WHEN type IN ('UInt8', 'Int8') THEN 'tinyint' "
+        << "      WHEN type IN ('UInt16', 'Int16') THEN 'smallint' "
+        << "      WHEN type IN ('UInt32', 'Int32') THEN 'int' "
+        << "      WHEN type IN ('UInt64', 'Int64', 'UInt128', 'Int128', 'UInt256', 'Int256') THEN 'bigint' "
+        << "      WHEN type = 'Float32' THEN 'float' "
+        << "      WHEN type = 'Float64' THEN 'double' "
+        << "      WHEN type LIKE 'Decimal%' THEN 'decimal' "
+        << "      WHEN type = 'Boolean' THEN 'tinyint' "
+        << "      WHEN type = 'String' THEN 'text' "
+        << "      WHEN type LIKE 'FixedString%' THEN 'text' "
+        << "      WHEN type LIKE 'Date%' THEN 'date' "
+        << "      WHEN type LIKE 'DateTime%' THEN 'datetime' "
+        << "      WHEN type = 'JSON' THEN 'json' "
+        << "      WHEN type = 'UUID' THEN 'binary' "
+        << "      WHEN type LIKE 'Enum%' THEN 'enum' "
+        << "      WHEN type LIKE 'LowCardinality%' THEN 'text' "
+        << "      WHEN type LIKE 'Array%' THEN 'json' "
+        << "      WHEN type LIKE 'Map%' THEN 'json' "
+        << "      WHEN type IN ('SimpleAggregateFunction', 'AggregateFunction') THEN 'text' "
+        << "      WHEN type = 'Nested' THEN 'json' "
+        << "      WHEN type LIKE 'Tuple%' THEN 'json' "
+        << "      WHEN type LIKE 'IPv%' THEN 'text' "
+        << "      WHEN type IN ('Expression', 'Set', 'Nothing', 'Interval') THEN 'text' "
+        << "      ELSE type "
+        << "    END "
+        << "END AS type, "
+        << "startsWith(type, 'Nullable') AS null, "
+        << "trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key, "
+        << "if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default, "
+        << "'' AS extra ";
+
+    return mysql_specific_query.str();
+}
 
 BlockIO InterpreterShowColumnsQuery::execute()
 {
diff --git a/src/Interpreters/InterpreterShowColumnsQuery.h b/src/Interpreters/InterpreterShowColumnsQuery.h
index ee6dcabd97b..b843a163978 100644
--- a/src/Interpreters/InterpreterShowColumnsQuery.h
+++ b/src/Interpreters/InterpreterShowColumnsQuery.h
@@ -26,6 +26,7 @@ private:
     ASTPtr query_ptr;
 
     String getRewrittenQuery();
+    String getMySQLQuery();
 };
 
 
diff --git a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
new file mode 100644
index 00000000000..c9ad94a34c4
--- /dev/null
+++ b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
@@ -0,0 +1,213 @@
+Drop tables if they exist
+Create tab table 
+Create pseudo-random database name
+Create tab duplicate table
+Run MySQL test
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra	collation	comment	privileges
+array_value	json	0		NULL		NULL		
+boolean_value	tinyint	0		NULL		NULL		
+date32_value	date	0		NULL		NULL		
+date_value	date	0		NULL		NULL		
+datetime64_value	date	0		NULL		NULL		
+datetime_value	date	0		NULL		NULL		
+decimal_value	decimal	0		NULL		NULL		
+enum_value	enum	0		NULL		NULL		
+fixed_string_value	text	0		NULL		NULL		
+float32	float	0		NULL		NULL		
+float64	double	0		NULL		NULL		
+int32	int	0		NULL		NULL		
+ipv4_value	text	0		NULL		NULL		
+ipv6_value	text	0		NULL		NULL		
+json_value	text	0		NULL		NULL		
+low_cardinality	text	0		NULL		NULL		
+map_value	json	0		NULL		NULL		
+nested.nested_int	json	0		NULL		NULL		
+nested.nested_string	json	0		NULL		NULL		
+nullable_value	int	0		NULL		NULL		
+string_value	text	0		NULL		NULL		
+tuple_value	json	0		NULL		NULL		
+uint64	bigint	0	PRI SOR	NULL		NULL		
+uuid_value	binary	0		NULL		NULL		
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
diff --git a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh
new file mode 100755
index 00000000000..5324496edd3
--- /dev/null
+++ b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh
@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# This script tests the MySQL compatibility of the SHOW COLUMNS command in ClickHouse
+USER="default"
+PASSWORD=""
+HOST="127.0.0.1"
+PORT=9004
+
+# First run the clickhouse test to create the ClickHouse Tables
+
+echo "Drop tables if they exist"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
+
+echo "Create tab table "
+${CLICKHOUSE_LOCAL} --query "
+    CREATE TABLE tab
+    (
+        uint64 UInt64,
+        int32 Nullable(Int32),
+        float32 Float32,
+        float64 Float64,
+        decimal_value Decimal(10, 2),
+        boolean_value UInt8, -- Use 0 for false, 1 for true
+        string_value String,
+        fixed_string_value FixedString(10),
+        date_value Date,
+        date32_value Date32,
+        datetime_value DateTime,
+        datetime64_value DateTime64(3),
+        json_value String, -- Store JSON as a string
+        uuid_value UUID,
+        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
+        low_cardinality LowCardinality(String),
+        array_value Array(Int32),
+        map_value Map(String, Int32),
+        tuple_value Tuple(Int32, String),
+        nullable_value Nullable(Int32),
+        ipv4_value IPv4,
+        ipv6_value IPv6,
+        nested Nested
+        (
+            nested_int Int32,
+            nested_string String
+        )
+    ) ENGINE = MergeTree
+    ORDER BY uint64;
+    "
+
+
+echo "Create pseudo-random database name"
+${CLICKHOUSE_LOCAL} --query "CREATE DATABASE database_123456789abcde;"
+
+echo "Create tab duplicate table"
+${CLICKHOUSE_LOCAL} --query "
+    CREATE TABLE database_123456789abcde.tab
+    (
+        uint64 UInt64,
+        int32 Nullable(Int32),
+        float32 Float32,
+        float64 Float64,
+        decimal_value Decimal(10, 2),
+        boolean_value UInt8, -- Use 0 for false, 1 for true
+        string_value String,
+        fixed_string_value FixedString(10),
+        date_value Date,
+        date32_value Date32,
+        datetime_value DateTime,
+        datetime64_value DateTime64(3),
+        json_value String, -- Store JSON as a string
+        uuid_value UUID,
+        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
+        low_cardinality LowCardinality(String),
+        array_value Array(Int32),
+        map_value Map(String, Int32),
+        tuple_value Tuple(Int32, String),
+        nullable_value Nullable(Int32),
+        ipv4_value IPv4,
+        ipv6_value IPv6,
+        nested Nested
+        (
+            nested_int Int32,
+            nested_string String
+        )
+    ) ENGINE = MergeTree
+    ORDER BY uint64;
+    "
+
+# Write sql to temp file 
+TEMP_FILE=$(mktemp)
+
+cat <<EOT > $TEMP_FILE
+SHOW COLUMNS FROM tab;
+SHOW EXTENDED COLUMNS FROM tab;
+SHOW FULL COLUMNS FROM tab;
+SHOW COLUMNS FROM tab LIKE '%int%';
+SHOW COLUMNS FROM tab NOT LIKE '%int%';
+SHOW COLUMNS FROM tab ILIKE '%INT%';
+SHOW COLUMNS FROM tab NOT ILIKE '%INT%';
+SHOW COLUMNS FROM tab WHERE field LIKE '%int%';
+SHOW COLUMNS FROM tab LIMIT 1;
+SHOW COLUMNS FROM tab;
+SHOW COLUMNS FROM tab FROM database_123456789abcde;
+SHOW COLUMNS FROM database_123456789abcde.tab;
+DROP DATABASE database_123456789abcde;
+DROP TABLE tab;
+EOT
+
+# Now run the MySQL test script on the ClickHouse DB
+echo "Run MySQL test"
+mysql --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
+
+# Clean up the temp file
+rm $TEMP_FILE

From 3fedd683ef97e61ebcc17b2f8b38feb297fbc26c Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 8 May 2023 22:28:31 +0200
Subject: [PATCH 078/722] speedup vol. II

---
 .../Serializations/SerializationDate.cpp      |  2 +-
 src/Functions/FunctionsConversion.h           | 16 ++++----
 src/IO/ReadHelpers.h                          | 40 +++++++++++++++----
 3 files changed, 42 insertions(+), 16 deletions(-)

diff --git a/src/DataTypes/Serializations/SerializationDate.cpp b/src/DataTypes/Serializations/SerializationDate.cpp
index bc2057d549e..8b4956f7826 100644
--- a/src/DataTypes/Serializations/SerializationDate.cpp
+++ b/src/DataTypes/Serializations/SerializationDate.cpp
@@ -77,7 +77,7 @@ void SerializationDate::serializeTextCSV(const IColumn & column, size_t row_num,
 void SerializationDate::deserializeTextCSV(IColumn & column, ReadBuffer & istr, const FormatSettings &) const
 {
     DayNum value;
-    readCSV(value, istr);
+    readCSV(value, istr, time_zone);
     assert_cast<ColumnUInt16 &>(column).getData().push_back(value);
 }
 SerializationDate::SerializationDate(const TimezoneMixin & time_zone_) : TimezoneMixin(time_zone_)
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 0f2d49f2557..6af5c44eb5e 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -981,18 +981,18 @@ void parseImpl(typename DataType::FieldType & x, ReadBuffer & rb, const DateLUTI
 }
 
 template <>
-inline void parseImpl<DataTypeDate>(DataTypeDate::FieldType & x, ReadBuffer & rb, const DateLUTImpl *)
+inline void parseImpl<DataTypeDate>(DataTypeDate::FieldType & x, ReadBuffer & rb, const DateLUTImpl * time_zone)
 {
     DayNum tmp(0);
-    readDateText(tmp, rb);
+    readDateText(tmp, rb, *time_zone);
     x = tmp;
 }
 
 template <>
-inline void parseImpl<DataTypeDate32>(DataTypeDate32::FieldType & x, ReadBuffer & rb, const DateLUTImpl *)
+inline void parseImpl<DataTypeDate32>(DataTypeDate32::FieldType & x, ReadBuffer & rb, const DateLUTImpl * time_zone)
 {
     ExtendedDayNum tmp(0);
-    readDateText(tmp, rb);
+    readDateText(tmp, rb, *time_zone);
     x = tmp;
 }
 
@@ -1040,20 +1040,20 @@ bool tryParseImpl(typename DataType::FieldType & x, ReadBuffer & rb, const DateL
 }
 
 template <>
-inline bool tryParseImpl<DataTypeDate>(DataTypeDate::FieldType & x, ReadBuffer & rb, const DateLUTImpl *)
+inline bool tryParseImpl<DataTypeDate>(DataTypeDate::FieldType & x, ReadBuffer & rb, const DateLUTImpl * time_zone)
 {
     DayNum tmp(0);
-    if (!tryReadDateText(tmp, rb))
+    if (!tryReadDateText(tmp, rb, *time_zone))
         return false;
     x = tmp;
     return true;
 }
 
 template <>
-inline bool tryParseImpl<DataTypeDate32>(DataTypeDate32::FieldType & x, ReadBuffer & rb, const DateLUTImpl *)
+inline bool tryParseImpl<DataTypeDate32>(DataTypeDate32::FieldType & x, ReadBuffer & rb, const DateLUTImpl * time_zone)
 {
     ExtendedDayNum tmp(0);
-    if (!tryReadDateText(tmp, rb))
+    if (!tryReadDateText(tmp, rb, *time_zone))
         return false;
     x = tmp;
     return true;
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 16c28b89667..f9e21418a41 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -760,14 +760,14 @@ inline bool tryReadDateText(LocalDate & date, ReadBuffer & buf)
     return readDateTextImpl<bool>(date, buf);
 }
 
-inline bool tryReadDateText(DayNum & date, ReadBuffer & buf)
+inline bool tryReadDateText(DayNum & date, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
-    return readDateTextImpl<bool>(date, buf);
+    return readDateTextImpl<bool>(date, buf, time_zone);
 }
 
-inline bool tryReadDateText(ExtendedDayNum & date, ReadBuffer & buf)
+inline bool tryReadDateText(ExtendedDayNum & date, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance())
 {
-    return readDateTextImpl<bool>(date, buf);
+    return readDateTextImpl<bool>(date, buf, time_zone);
 }
 
 template <typename ReturnType = void>
@@ -1160,7 +1160,7 @@ inline void readText(is_floating_point auto & x, ReadBuffer & buf) { readFloatTe
 
 inline void readText(String & x, ReadBuffer & buf) { readEscapedString(x, buf); }
 inline void readText(LocalDate & x, ReadBuffer & buf) { readDateText(x, buf); }
-inline void readText(DayNum & x, ReadBuffer & buf) { readDateText(x, buf); }
+inline void readText(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance()) { readDateText(x, buf, time_zone); }
 inline void readText(LocalDateTime & x, ReadBuffer & buf) { readDateTimeText(x, buf); }
 inline void readText(UUID & x, ReadBuffer & buf) { readUUIDText(x, buf); }
 inline void readText(IPv4 & x, ReadBuffer & buf) { readIPv4Text(x, buf); }
@@ -1172,6 +1172,10 @@ template <typename T>
 requires is_arithmetic_v<T>
 inline void readQuoted(T & x, ReadBuffer & buf) { readText(x, buf); }
 
+template <typename T>
+requires is_arithmetic_v<T>
+inline void readQuoted(T & x, ReadBuffer & buf, const DateLUTImpl & time_zone) { readText(x, buf, time_zone); }
+
 inline void readQuoted(String & x, ReadBuffer & buf) { readQuotedString(x, buf); }
 
 inline void readQuoted(LocalDate & x, ReadBuffer & buf)
@@ -1214,6 +1218,10 @@ template <typename T>
 requires is_arithmetic_v<T>
 inline void readDoubleQuoted(T & x, ReadBuffer & buf) { readText(x, buf); }
 
+template <typename T>
+    requires is_arithmetic_v<T>
+inline void readDoubleQuoted(T & x, ReadBuffer & buf, const DateLUTImpl & time_zone) { readText(x, buf, time_zone); }
+
 inline void readDoubleQuoted(String & x, ReadBuffer & buf) { readDoubleQuotedString(x, buf); }
 
 inline void readDoubleQuoted(LocalDate & x, ReadBuffer & buf)
@@ -1230,7 +1238,7 @@ inline void readDoubleQuoted(LocalDateTime & x, ReadBuffer & buf)
     assertChar('"', buf);
 }
 
-/// CSV, for numbers, dates: quotes are optional, no special escaping rules.
+/// CSV for numbers: quotes are optional, no special escaping rules.
 template <typename T>
 inline void readCSVSimple(T & x, ReadBuffer & buf)
 {
@@ -1248,6 +1256,24 @@ inline void readCSVSimple(T & x, ReadBuffer & buf)
         assertChar(maybe_quote, buf);
 }
 
+// standalone overload for dates: to avoid instantiating DateLUTs while parsing other types
+template <typename T>
+inline void readCSVSimple(T & x, ReadBuffer & buf, const DateLUTImpl & time_zone)
+{
+    if (buf.eof()) [[unlikely]]
+        throwReadAfterEOF();
+
+    char maybe_quote = *buf.position();
+
+    if (maybe_quote == '\'' || maybe_quote == '\"')
+        ++buf.position();
+
+    readText(x, buf, time_zone);
+
+    if (maybe_quote == '\'' || maybe_quote == '\"')
+        assertChar(maybe_quote, buf);
+}
+
 template <typename T>
 requires is_arithmetic_v<T>
 inline void readCSV(T & x, ReadBuffer & buf)
@@ -1257,7 +1283,7 @@ inline void readCSV(T & x, ReadBuffer & buf)
 
 inline void readCSV(String & x, ReadBuffer & buf, const FormatSettings::CSV & settings) { readCSVString(x, buf, settings); }
 inline void readCSV(LocalDate & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
-inline void readCSV(DayNum & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
+inline void readCSV(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance()) { readCSVSimple(x, buf, time_zone); }
 inline void readCSV(LocalDateTime & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
 inline void readCSV(UUID & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
 inline void readCSV(IPv4 & x, ReadBuffer & buf) { readCSVSimple(x, buf); }

From 1751ccc7aca3830d21a06ec4f09bd28bf9254f79 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 9 May 2023 14:18:04 +0200
Subject: [PATCH 079/722] fix stateless

---
 src/Functions/FunctionsConversion.h | 15 ++++++++++++---
 src/IO/ReadHelpers.h                | 12 ++++++++----
 2 files changed, 20 insertions(+), 7 deletions(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 6af5c44eb5e..e0e188f68c2 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -439,7 +439,7 @@ struct ToDate32Transform32Or64Signed
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
-        static const Int32 daynum_min_offset = -static_cast<Int32>(DateLUT::instance().getDayNumOffsetEpoch());
+        static const Int32 daynum_min_offset = -static_cast<Int32>(time_zone.getDayNumOffsetEpoch());
         if (from < daynum_min_offset)
             return daynum_min_offset;
         return (from < DATE_LUT_MAX_EXTEND_DAY_NUM)
@@ -830,8 +830,11 @@ struct ConvertImpl<FromDataType, DataTypeString, Name, ConvertDefaultBehaviorTag
         const auto & type = static_cast<const FromDataType &>(*col_with_type_and_name.type);
 
         const DateLUTImpl * time_zone = nullptr;
+
+        if constexpr (std::is_same_v<FromDataType, DataTypeDate>)
+            time_zone = &DateLUT::instance();
         /// For argument of Date or DateTime type, second argument with time zone could be specified.
-        if constexpr (std::is_same_v<FromDataType, DataTypeDateTime> || std::is_same_v<FromDataType, DataTypeDateTime64> || std::is_same_v<FromDataType, DataTypeDate>)
+        if constexpr (std::is_same_v<FromDataType, DataTypeDateTime> || std::is_same_v<FromDataType, DataTypeDateTime64>)
         {
             auto non_null_args = createBlockWithNestedColumns(arguments);
             time_zone = &extractTimeZoneFromFunctionArguments(non_null_args, 1, 0);
@@ -1193,7 +1196,7 @@ struct ConvertThroughParsing
         const DateLUTImpl * local_time_zone [[maybe_unused]] = nullptr;
         const DateLUTImpl * utc_time_zone [[maybe_unused]] = nullptr;
 
-        /// For conversion to DateTime type, second argument with time zone could be specified.
+        /// For conversion to Date or DateTime type, second argument with time zone could be specified.
         if constexpr (std::is_same_v<ToDataType, DataTypeDateTime> || to_datetime64)
         {
             const auto result_type = removeNullable(res_type);
@@ -1206,6 +1209,12 @@ struct ConvertThroughParsing
             if constexpr (parsing_mode == ConvertFromStringParsingMode::BestEffort || parsing_mode == ConvertFromStringParsingMode::BestEffortUS)
                 utc_time_zone = &DateLUT::instance("UTC");
         }
+        else if constexpr (std::is_same_v<ToDataType, DataTypeDate> || std::is_same_v<ToDataType, DataTypeDate32>)
+        {
+            // Timezone is more or less dummy when parsing Date/Date32 from string.
+            local_time_zone = &DateLUT::instance();
+            utc_time_zone = &DateLUT::instance("UTC");
+        }
 
         const IColumn * col_from = arguments[0].column.get();
         const ColumnString * col_from_string = checkAndGetColumn<ColumnString>(col_from);
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index f9e21418a41..ea565d11914 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -718,7 +718,7 @@ inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf, const DateLU
         return false;
 
     ExtendedDayNum ret = date_lut.makeDayNum(local_date.year(), local_date.month(), local_date.day());
-    convertToDayNum(date,ret);
+    convertToDayNum(date, ret);
     return ReturnType(true);
 }
 
@@ -1159,8 +1159,11 @@ inline bool tryReadText(IPv6 & x, ReadBuffer & buf) { return tryReadIPv6Text(x,
 inline void readText(is_floating_point auto & x, ReadBuffer & buf) { readFloatText(x, buf); }
 
 inline void readText(String & x, ReadBuffer & buf) { readEscapedString(x, buf); }
+
+inline void readText(DayNum & x, ReadBuffer & buf) { readDateText(x, buf); }
+inline void readText(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone) { readDateText(x, buf, time_zone); }
+
 inline void readText(LocalDate & x, ReadBuffer & buf) { readDateText(x, buf); }
-inline void readText(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance()) { readDateText(x, buf, time_zone); }
 inline void readText(LocalDateTime & x, ReadBuffer & buf) { readDateTimeText(x, buf); }
 inline void readText(UUID & x, ReadBuffer & buf) { readUUIDText(x, buf); }
 inline void readText(IPv4 & x, ReadBuffer & buf) { readIPv4Text(x, buf); }
@@ -1219,7 +1222,7 @@ requires is_arithmetic_v<T>
 inline void readDoubleQuoted(T & x, ReadBuffer & buf) { readText(x, buf); }
 
 template <typename T>
-    requires is_arithmetic_v<T>
+requires is_arithmetic_v<T>
 inline void readDoubleQuoted(T & x, ReadBuffer & buf, const DateLUTImpl & time_zone) { readText(x, buf, time_zone); }
 
 inline void readDoubleQuoted(String & x, ReadBuffer & buf) { readDoubleQuotedString(x, buf); }
@@ -1283,7 +1286,8 @@ inline void readCSV(T & x, ReadBuffer & buf)
 
 inline void readCSV(String & x, ReadBuffer & buf, const FormatSettings::CSV & settings) { readCSVString(x, buf, settings); }
 inline void readCSV(LocalDate & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
-inline void readCSV(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance()) { readCSVSimple(x, buf, time_zone); }
+inline void readCSV(DayNum & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
+inline void readCSV(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone) { readCSVSimple(x, buf, time_zone); }
 inline void readCSV(LocalDateTime & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
 inline void readCSV(UUID & x, ReadBuffer & buf) { readCSVSimple(x, buf); }
 inline void readCSV(IPv4 & x, ReadBuffer & buf) { readCSVSimple(x, buf); }

From ddbad79c5e67518acebbacaad5be0cad3967ac67 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Fri, 5 May 2023 12:19:35 -0700
Subject: [PATCH 080/722] Change SHOW COLUMNS query to display MySQL types in
 MySQL Compatibility mode

This updates the SHOW COLUMN SQL query to display MySQL types when this
query is issued by a client connected via MySQL Compatibility port
---
 .../InterpreterShowColumnsQuery.cpp           |  76 +++++++
 .../InterpreterShowColumnsQuery.h             |   1 +
 ...show_columns_mysql_compatibility.reference | 213 ++++++++++++++++++
 .../02726_show_columns_mysql_compatibility.sh | 115 ++++++++++
 4 files changed, 405 insertions(+)
 create mode 100644 tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
 create mode 100755 tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh

diff --git a/src/Interpreters/InterpreterShowColumnsQuery.cpp b/src/Interpreters/InterpreterShowColumnsQuery.cpp
index c86d3c753c4..c545c621abb 100644
--- a/src/Interpreters/InterpreterShowColumnsQuery.cpp
+++ b/src/Interpreters/InterpreterShowColumnsQuery.cpp
@@ -45,6 +45,14 @@ SELECT
     // TODO Interpret query.extended. It is supposed to show internal/virtual columns. Need to fetch virtual column names, see
     // IStorage::getVirtuals(). We can't easily do that via SQL.
 
+    // If connected via MySQL Compatibility mode, convert ClickHouse types to MySQL
+    if (getContext()->getClientInfo().interface == DB::ClientInfo::Interface::MYSQL)
+    {
+        rewritten_query += getMySQLQuery();
+    }
+    else {
+        rewritten_query += "SELECT name AS field, type AS type, startsWith(type, 'Nullable') AS null, trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key, if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default, '' AS extra ";
+    }
     if (query.full)
     {
         /// "Full" mode is mostly for MySQL compat
@@ -88,6 +96,74 @@ WHERE
     return rewritten_query;
 }
 
+String InterpreterShowColumnsQuery::getMySQLQuery()
+{
+    String mysql_specific_query;
+
+    mysql_specific_query = R"(SELECT name AS field,
+        CASE
+          WHEN startsWith(type, 'Nullable') THEN
+            CASE
+              WHEN substring(type, 10, length(type) - 10) IN ('UInt8', 'Int8') THEN 'tinyint'
+              WHEN substring(type, 10, length(type) - 10) IN ('UInt16', 'Int16') THEN 'smallint'
+              WHEN substring(type, 10, length(type) - 10) IN ('UInt32', 'Int32') THEN 'int'
+              WHEN substring(type, 10, length(type) - 10) IN ('UInt64', 'Int64', 'UInt128', 'Int128', 'UInt256', 'Int256') THEN 'bigint'
+              WHEN substring(type, 10, length(type) - 10) = 'Float32' THEN 'float'
+              WHEN substring(type, 10, length(type) - 10) = 'Float64' THEN 'double'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'Decimal%' THEN 'decimal'
+              WHEN substring(type, 10, length(type) - 10) = 'Boolean' THEN 'tinyint'
+              WHEN substring(type, 10, length(type) - 10) = 'String' THEN 'text'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'FixedString%' THEN 'text'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'Date%' THEN 'date'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'DateTime%' THEN 'datetime'
+              WHEN substring(type, 10, length(type) - 10) = 'JSON' THEN 'json'
+              WHEN substring(type, 10, length(type) - 10) = 'UUID' THEN 'binary'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'Enum%' THEN 'enum'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'LowCardinality%' THEN 'text'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'Array%' THEN 'json'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'Map%' THEN 'json'
+              WHEN substring(type, 10, length(type) - 10) IN ('SimpleAggregateFunction', 'AggregateFunction') THEN 'text'
+              WHEN substring(type, 10, length(type) - 10) = 'Nested' THEN 'json'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'Tuple%' THEN 'json'
+              WHEN substring(type, 10, length(type) - 10) LIKE 'IPv%' THEN 'text'
+              WHEN substring(type, 10, length(type) - 10) IN ('Expression', 'Set', 'Nothing', 'Interval') THEN 'text'
+              ELSE substring(type, 10, length(type) - 10)
+            END
+          ELSE
+            CASE
+              WHEN type IN ('UInt8', 'Int8') THEN 'tinyint'
+              WHEN type IN ('UInt16', 'Int16') THEN 'smallint'
+              WHEN type IN ('UInt32', 'Int32') THEN 'int'
+              WHEN type IN ('UInt64', 'Int64', 'UInt128', 'Int128', 'UInt256', 'Int256') THEN 'bigint'
+              WHEN type = 'Float32' THEN 'float'
+              WHEN type = 'Float64' THEN 'double'
+              WHEN type LIKE 'Decimal%' THEN 'decimal'
+              WHEN type = 'Boolean' THEN 'tinyint'
+              WHEN type = 'String' THEN 'text'
+              WHEN type LIKE 'FixedString%' THEN 'text'
+              WHEN type LIKE 'Date%' THEN 'date'
+              WHEN type LIKE 'DateTime%' THEN 'datetime'
+              WHEN type = 'JSON' THEN 'json'
+              WHEN type = 'UUID' THEN 'binary'
+              WHEN type LIKE 'Enum%' THEN 'enum'
+              WHEN type LIKE 'LowCardinality%' THEN 'text'
+              WHEN type LIKE 'Array%' THEN 'json'
+              WHEN type LIKE 'Map%' THEN 'json'
+              WHEN type IN ('SimpleAggregateFunction', 'AggregateFunction') THEN 'text'
+              WHEN type = 'Nested' THEN 'json'
+              WHEN type LIKE 'Tuple%' THEN 'json'
+              WHEN type LIKE 'IPv%' THEN 'text'
+              WHEN type IN ('Expression', 'Set', 'Nothing', 'Interval') THEN 'text'
+              ELSE type
+            END
+        END AS type,
+        startsWith(type, 'Nullable') AS null,
+        trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key,
+        if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default,
+        '' AS extra )";
+
+    return mysql_specific_query.str();
+}
 
 BlockIO InterpreterShowColumnsQuery::execute()
 {
diff --git a/src/Interpreters/InterpreterShowColumnsQuery.h b/src/Interpreters/InterpreterShowColumnsQuery.h
index ee6dcabd97b..b843a163978 100644
--- a/src/Interpreters/InterpreterShowColumnsQuery.h
+++ b/src/Interpreters/InterpreterShowColumnsQuery.h
@@ -26,6 +26,7 @@ private:
     ASTPtr query_ptr;
 
     String getRewrittenQuery();
+    String getMySQLQuery();
 };
 
 
diff --git a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
new file mode 100644
index 00000000000..c9ad94a34c4
--- /dev/null
+++ b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
@@ -0,0 +1,213 @@
+Drop tables if they exist
+Create tab table 
+Create pseudo-random database name
+Create tab duplicate table
+Run MySQL test
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra	collation	comment	privileges
+array_value	json	0		NULL		NULL		
+boolean_value	tinyint	0		NULL		NULL		
+date32_value	date	0		NULL		NULL		
+date_value	date	0		NULL		NULL		
+datetime64_value	date	0		NULL		NULL		
+datetime_value	date	0		NULL		NULL		
+decimal_value	decimal	0		NULL		NULL		
+enum_value	enum	0		NULL		NULL		
+fixed_string_value	text	0		NULL		NULL		
+float32	float	0		NULL		NULL		
+float64	double	0		NULL		NULL		
+int32	int	0		NULL		NULL		
+ipv4_value	text	0		NULL		NULL		
+ipv6_value	text	0		NULL		NULL		
+json_value	text	0		NULL		NULL		
+low_cardinality	text	0		NULL		NULL		
+map_value	json	0		NULL		NULL		
+nested.nested_int	json	0		NULL		NULL		
+nested.nested_string	json	0		NULL		NULL		
+nullable_value	int	0		NULL		NULL		
+string_value	text	0		NULL		NULL		
+tuple_value	json	0		NULL		NULL		
+uint64	bigint	0	PRI SOR	NULL		NULL		
+uuid_value	binary	0		NULL		NULL		
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
+field	type	null	key	default	extra
+array_value	json	0		NULL	
+boolean_value	tinyint	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	date	0		NULL	
+datetime_value	date	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	text	0		NULL	
+low_cardinality	text	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	json	0		NULL	
+nested.nested_string	json	0		NULL	
+nullable_value	int	0		NULL	
+string_value	text	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint	0	PRI SOR	NULL	
+uuid_value	binary	0		NULL	
diff --git a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh
new file mode 100755
index 00000000000..5324496edd3
--- /dev/null
+++ b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh
@@ -0,0 +1,115 @@
+#!/bin/bash
+
+# This script tests the MySQL compatibility of the SHOW COLUMNS command in ClickHouse
+USER="default"
+PASSWORD=""
+HOST="127.0.0.1"
+PORT=9004
+
+# First run the clickhouse test to create the ClickHouse Tables
+
+echo "Drop tables if they exist"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
+
+echo "Create tab table "
+${CLICKHOUSE_LOCAL} --query "
+    CREATE TABLE tab
+    (
+        uint64 UInt64,
+        int32 Nullable(Int32),
+        float32 Float32,
+        float64 Float64,
+        decimal_value Decimal(10, 2),
+        boolean_value UInt8, -- Use 0 for false, 1 for true
+        string_value String,
+        fixed_string_value FixedString(10),
+        date_value Date,
+        date32_value Date32,
+        datetime_value DateTime,
+        datetime64_value DateTime64(3),
+        json_value String, -- Store JSON as a string
+        uuid_value UUID,
+        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
+        low_cardinality LowCardinality(String),
+        array_value Array(Int32),
+        map_value Map(String, Int32),
+        tuple_value Tuple(Int32, String),
+        nullable_value Nullable(Int32),
+        ipv4_value IPv4,
+        ipv6_value IPv6,
+        nested Nested
+        (
+            nested_int Int32,
+            nested_string String
+        )
+    ) ENGINE = MergeTree
+    ORDER BY uint64;
+    "
+
+
+echo "Create pseudo-random database name"
+${CLICKHOUSE_LOCAL} --query "CREATE DATABASE database_123456789abcde;"
+
+echo "Create tab duplicate table"
+${CLICKHOUSE_LOCAL} --query "
+    CREATE TABLE database_123456789abcde.tab
+    (
+        uint64 UInt64,
+        int32 Nullable(Int32),
+        float32 Float32,
+        float64 Float64,
+        decimal_value Decimal(10, 2),
+        boolean_value UInt8, -- Use 0 for false, 1 for true
+        string_value String,
+        fixed_string_value FixedString(10),
+        date_value Date,
+        date32_value Date32,
+        datetime_value DateTime,
+        datetime64_value DateTime64(3),
+        json_value String, -- Store JSON as a string
+        uuid_value UUID,
+        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
+        low_cardinality LowCardinality(String),
+        array_value Array(Int32),
+        map_value Map(String, Int32),
+        tuple_value Tuple(Int32, String),
+        nullable_value Nullable(Int32),
+        ipv4_value IPv4,
+        ipv6_value IPv6,
+        nested Nested
+        (
+            nested_int Int32,
+            nested_string String
+        )
+    ) ENGINE = MergeTree
+    ORDER BY uint64;
+    "
+
+# Write sql to temp file 
+TEMP_FILE=$(mktemp)
+
+cat <<EOT > $TEMP_FILE
+SHOW COLUMNS FROM tab;
+SHOW EXTENDED COLUMNS FROM tab;
+SHOW FULL COLUMNS FROM tab;
+SHOW COLUMNS FROM tab LIKE '%int%';
+SHOW COLUMNS FROM tab NOT LIKE '%int%';
+SHOW COLUMNS FROM tab ILIKE '%INT%';
+SHOW COLUMNS FROM tab NOT ILIKE '%INT%';
+SHOW COLUMNS FROM tab WHERE field LIKE '%int%';
+SHOW COLUMNS FROM tab LIMIT 1;
+SHOW COLUMNS FROM tab;
+SHOW COLUMNS FROM tab FROM database_123456789abcde;
+SHOW COLUMNS FROM database_123456789abcde.tab;
+DROP DATABASE database_123456789abcde;
+DROP TABLE tab;
+EOT
+
+# Now run the MySQL test script on the ClickHouse DB
+echo "Run MySQL test"
+mysql --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
+
+# Clean up the temp file
+rm $TEMP_FILE

From 297188ce583a94f9942f7fd141a85dbdcfdcd587 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 9 May 2023 22:37:25 +0200
Subject: [PATCH 081/722] fix Date32

---
 src/DataTypes/Serializations/SerializationDate32.cpp | 11 +++++++----
 src/DataTypes/Serializations/SerializationDate32.h   |  5 ++++-
 src/Functions/FunctionsConversion.h                  |  7 +++++--
 3 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/src/DataTypes/Serializations/SerializationDate32.cpp b/src/DataTypes/Serializations/SerializationDate32.cpp
index ef92202f89d..8dcaee8d266 100644
--- a/src/DataTypes/Serializations/SerializationDate32.cpp
+++ b/src/DataTypes/Serializations/SerializationDate32.cpp
@@ -11,7 +11,7 @@ namespace DB
 
 void SerializationDate32::serializeText(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const
 {
-    writeDateText(ExtendedDayNum(assert_cast<const ColumnInt32 &>(column).getData()[row_num]), ostr);
+    writeDateText(ExtendedDayNum(assert_cast<const ColumnInt32 &>(column).getData()[row_num]), ostr, time_zone);
 }
 
 void SerializationDate32::deserializeWholeText(IColumn & column, ReadBuffer & istr, const FormatSettings & settings) const
@@ -24,7 +24,7 @@ void SerializationDate32::deserializeWholeText(IColumn & column, ReadBuffer & is
 void SerializationDate32::deserializeTextEscaped(IColumn & column, ReadBuffer & istr, const FormatSettings &) const
 {
     ExtendedDayNum x;
-    readDateText(x, istr);
+    readDateText(x, istr, time_zone);
     assert_cast<ColumnInt32 &>(column).getData().push_back(x);
 }
 
@@ -44,7 +44,7 @@ void SerializationDate32::deserializeTextQuoted(IColumn & column, ReadBuffer & i
 {
     ExtendedDayNum x;
     assertChar('\'', istr);
-    readDateText(x, istr);
+    readDateText(x, istr, time_zone);
     assertChar('\'', istr);
     assert_cast<ColumnInt32 &>(column).getData().push_back(x);    /// It's important to do this at the end - for exception safety.
 }
@@ -60,7 +60,7 @@ void SerializationDate32::deserializeTextJSON(IColumn & column, ReadBuffer & ist
 {
     ExtendedDayNum x;
     assertChar('"', istr);
-    readDateText(x, istr);
+    readDateText(x, istr, time_zone);
     assertChar('"', istr);
     assert_cast<ColumnInt32 &>(column).getData().push_back(x);
 }
@@ -78,4 +78,7 @@ void SerializationDate32::deserializeTextCSV(IColumn & column, ReadBuffer & istr
     readCSV(value, istr);
     assert_cast<ColumnInt32 &>(column).getData().push_back(value.getExtenedDayNum());
 }
+SerializationDate32::SerializationDate32(const TimezoneMixin & time_zone_) : TimezoneMixin(time_zone_)
+{
+}
 }
diff --git a/src/DataTypes/Serializations/SerializationDate32.h b/src/DataTypes/Serializations/SerializationDate32.h
index 484b4f4a958..e8e8f1a74d6 100644
--- a/src/DataTypes/Serializations/SerializationDate32.h
+++ b/src/DataTypes/Serializations/SerializationDate32.h
@@ -1,12 +1,15 @@
 #pragma once
 
 #include <DataTypes/Serializations/SerializationNumber.h>
+#include <DataTypes/TimezoneMixin.h>
 
 namespace DB
 {
-class SerializationDate32 final : public SerializationNumber<Int32>
+class SerializationDate32 final : public SerializationNumber<Int32>, public TimezoneMixin
 {
 public:
+    explicit SerializationDate32(const TimezoneMixin & time_zone_ = TimezoneMixin());
+
     void serializeText(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
     void deserializeWholeText(IColumn & column, ReadBuffer & istr, const FormatSettings &) const override;
     void serializeTextEscaped(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index e0e188f68c2..2f751e72222 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -731,7 +731,10 @@ struct FormatImpl<DataTypeDate32>
     template <typename ReturnType = void>
     static ReturnType execute(const DataTypeDate32::FieldType x, WriteBuffer & wb, const DataTypeDate32 *, const DateLUTImpl * time_zone)
     {
+        std::cerr << "BEFORE: " << std::endl;
+        std::cerr << time_zone->getTimeZone() << std::endl;
         writeDateText(ExtendedDayNum(x), wb, *time_zone);
+        std::cerr << "AFTER" << std::endl;
         return ReturnType(true);
     }
 };
@@ -831,7 +834,7 @@ struct ConvertImpl<FromDataType, DataTypeString, Name, ConvertDefaultBehaviorTag
 
         const DateLUTImpl * time_zone = nullptr;
 
-        if constexpr (std::is_same_v<FromDataType, DataTypeDate>)
+        if constexpr (std::is_same_v<FromDataType, DataTypeDate> || std::is_same_v<FromDataType, DataTypeDate32>)
             time_zone = &DateLUT::instance();
         /// For argument of Date or DateTime type, second argument with time zone could be specified.
         if constexpr (std::is_same_v<FromDataType, DataTypeDateTime> || std::is_same_v<FromDataType, DataTypeDateTime64>)
@@ -1765,7 +1768,7 @@ public:
             || std::is_same_v<Name, NameToUnixTimestamp>
             // toDate(value[, timezone : String])
             || std::is_same_v<ToDataType, DataTypeDate> // TODO: shall we allow timestamp argument for toDate? DateTime knows nothing about timezones and this argument is ignored below.
-            // toDate(value[, timezone : String])
+            // toDate32(value[, timezone : String])
             || std::is_same_v<ToDataType, DataTypeDate32>
             // toDateTime(value[, timezone: String])
             || std::is_same_v<ToDataType, DataTypeDateTime>

From 8d0644e79301a9a0ccf67b66d44c43e4766d8aa7 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 9 May 2023 23:02:03 +0200
Subject: [PATCH 082/722] cleanup

---
 src/Functions/FunctionsConversion.h | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 2f751e72222..b10d9f4a31a 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -731,10 +731,7 @@ struct FormatImpl<DataTypeDate32>
     template <typename ReturnType = void>
     static ReturnType execute(const DataTypeDate32::FieldType x, WriteBuffer & wb, const DataTypeDate32 *, const DateLUTImpl * time_zone)
     {
-        std::cerr << "BEFORE: " << std::endl;
-        std::cerr << time_zone->getTimeZone() << std::endl;
         writeDateText(ExtendedDayNum(x), wb, *time_zone);
-        std::cerr << "AFTER" << std::endl;
         return ReturnType(true);
     }
 };

From ac7c54a4d3636c8616799fa8272f6da1ce6683fc Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Wed, 10 May 2023 18:39:38 +0000
Subject: [PATCH 083/722] Refactor CapnProto format to improve input/output
 performance

---
 src/Core/Settings.h                           |    2 +-
 src/Core/SettingsEnums.cpp                    |    8 +-
 src/Core/SettingsEnums.h                      |    2 +-
 src/Formats/CapnProtoSchema.cpp               |  298 ++++
 .../{CapnProtoUtils.h => CapnProtoSchema.h}   |   13 +-
 src/Formats/CapnProtoSerializer.cpp           | 1218 +++++++++++++++++
 src/Formats/CapnProtoSerializer.h             |   25 +
 src/Formats/CapnProtoUtils.cpp                |  734 ----------
 src/Formats/FormatSettings.h                  |    6 +-
 .../Formats/Impl/CapnProtoRowInputFormat.cpp  |  253 +---
 .../Formats/Impl/CapnProtoRowInputFormat.h    |    9 +-
 .../Formats/Impl/CapnProtoRowOutputFormat.cpp |  266 +---
 .../Formats/Impl/CapnProtoRowOutputFormat.h   |   17 +-
 .../Formats/Impl/ProtobufListInputFormat.cpp  |    9 +-
 .../Formats/Impl/ProtobufRowInputFormat.cpp   |    9 +-
 .../queries/0_stateless/02030_capnp_format.sh |    4 +-
 ...p_case_insensitive_names_matcing.reference |    1 +
 ...35_capnp_case_insensitive_names_matcing.sh |   10 +
 ...ing_and_writing_structure_fields.reference |    3 +
 ...36_reading_and_writing_structure_fields.sh |   24 +
 ...2735_case_insensitive_names_matching.capnp |   13 +
 .../02736_nested_structures.capnp             |   21 +
 22 files changed, 1686 insertions(+), 1259 deletions(-)
 create mode 100644 src/Formats/CapnProtoSchema.cpp
 rename src/Formats/{CapnProtoUtils.h => CapnProtoSchema.h} (59%)
 create mode 100644 src/Formats/CapnProtoSerializer.cpp
 create mode 100644 src/Formats/CapnProtoSerializer.h
 delete mode 100644 src/Formats/CapnProtoUtils.cpp
 create mode 100644 tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
 create mode 100755 tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
 create mode 100644 tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference
 create mode 100755 tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh
 create mode 100644 tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp
 create mode 100644 tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 1bea2c26392..269fa832f45 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -958,7 +958,7 @@ class IColumn;
     M(Bool, output_format_orc_string_as_string, false, "Use ORC String type instead of Binary for String columns", 0) \
     M(ORCCompression, output_format_orc_compression_method, "lz4", "Compression method for ORC output format. Supported codecs: lz4, snappy, zlib, zstd, none (uncompressed)", 0) \
     \
-    M(EnumComparingMode, format_capn_proto_enum_comparising_mode, FormatSettings::EnumComparingMode::BY_VALUES, "How to map ClickHouse Enum and CapnProto Enum", 0) \
+    M(CapnProtoEnumComparingMode, format_capn_proto_enum_comparising_mode, FormatSettings::CapnProtoEnumComparingMode::BY_VALUES, "How to map ClickHouse Enum and CapnProto Enum", 0) \
     \
     M(String, input_format_mysql_dump_table_name, "", "Name of the table in MySQL dump from which to read data", 0) \
     M(Bool, input_format_mysql_dump_map_column_names, true, "Match columns from table in MySQL dump and columns from ClickHouse table by names", 0) \
diff --git a/src/Core/SettingsEnums.cpp b/src/Core/SettingsEnums.cpp
index e0f16ea00db..a291a23c140 100644
--- a/src/Core/SettingsEnums.cpp
+++ b/src/Core/SettingsEnums.cpp
@@ -144,10 +144,10 @@ IMPLEMENT_SETTING_ENUM(TransactionsWaitCSNMode, ErrorCodes::BAD_ARGUMENTS,
      {"wait",           TransactionsWaitCSNMode::WAIT},
      {"wait_unknown",   TransactionsWaitCSNMode::WAIT_UNKNOWN}})
 
-IMPLEMENT_SETTING_ENUM(EnumComparingMode, ErrorCodes::BAD_ARGUMENTS,
-    {{"by_names",   FormatSettings::EnumComparingMode::BY_NAMES},
-     {"by_values",  FormatSettings::EnumComparingMode::BY_VALUES},
-     {"by_names_case_insensitive", FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE}})
+IMPLEMENT_SETTING_ENUM(CapnProtoEnumComparingMode, ErrorCodes::BAD_ARGUMENTS,
+    {{"by_names",   FormatSettings::CapnProtoEnumComparingMode::BY_NAMES},
+     {"by_values",  FormatSettings::CapnProtoEnumComparingMode::BY_VALUES},
+     {"by_names_case_insensitive", FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE}})
 
 IMPLEMENT_SETTING_ENUM(EscapingRule, ErrorCodes::BAD_ARGUMENTS,
     {{"None", FormatSettings::EscapingRule::None},
diff --git a/src/Core/SettingsEnums.h b/src/Core/SettingsEnums.h
index 3ae7bfaa673..1c5be910ef7 100644
--- a/src/Core/SettingsEnums.h
+++ b/src/Core/SettingsEnums.h
@@ -188,7 +188,7 @@ enum class TransactionsWaitCSNMode
 
 DECLARE_SETTING_ENUM(TransactionsWaitCSNMode)
 
-DECLARE_SETTING_ENUM_WITH_RENAME(EnumComparingMode, FormatSettings::EnumComparingMode)
+DECLARE_SETTING_ENUM_WITH_RENAME(CapnProtoEnumComparingMode, FormatSettings::CapnProtoEnumComparingMode)
 
 DECLARE_SETTING_ENUM_WITH_RENAME(EscapingRule, FormatSettings::EscapingRule)
 
diff --git a/src/Formats/CapnProtoSchema.cpp b/src/Formats/CapnProtoSchema.cpp
new file mode 100644
index 00000000000..22518d5061a
--- /dev/null
+++ b/src/Formats/CapnProtoSchema.cpp
@@ -0,0 +1,298 @@
+#include <Formats/CapnProtoSchema.h>
+
+#if USE_CAPNP
+
+#include <DataTypes/DataTypeArray.h>
+#include <DataTypes/DataTypeEnum.h>
+#include <DataTypes/DataTypeNullable.h>
+#include <DataTypes/DataTypeTuple.h>
+#include <DataTypes/DataTypesNumber.h>
+#include <DataTypes/DataTypeString.h>
+#include <DataTypes/IDataType.h>
+#include <Common/StringUtils/StringUtils.h>
+#include <boost/algorithm/string/join.hpp>
+#include <capnp/schema.h>
+#include <capnp/schema-parser.h>
+#include <fcntl.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int CANNOT_PARSE_CAPN_PROTO_SCHEMA;
+    extern const int BAD_TYPE_OF_FIELD;
+    extern const int FILE_DOESNT_EXIST;
+    extern const int UNKNOWN_EXCEPTION;
+    extern const int CAPN_PROTO_BAD_TYPE;
+    extern const int BAD_ARGUMENTS;
+}
+
+capnp::StructSchema CapnProtoSchemaParser::getMessageSchema(const FormatSchemaInfo & schema_info)
+{
+    capnp::ParsedSchema schema;
+    try
+    {
+        int fd;
+        KJ_SYSCALL(fd = open(schema_info.schemaDirectory().data(), O_RDONLY)); // NOLINT(bugprone-suspicious-semicolon)
+        auto schema_dir = kj::newDiskDirectory(kj::OsFileHandle(fd));
+        schema = impl.parseFromDirectory(*schema_dir, kj::Path::parse(schema_info.schemaPath()), {});
+    }
+    catch (const kj::Exception & e)
+    {
+        /// That's not good to determine the type of error by its description, but
+        /// this is the only way to do it here, because kj doesn't specify the type of error.
+        auto description = std::string_view(e.getDescription().cStr());
+        if (description.find("No such file or directory") != String::npos || description.find("no such directory") != String::npos)
+            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot open CapnProto schema, file {} doesn't exists", schema_info.absoluteSchemaPath());
+
+        if (description.find("Parse error") != String::npos)
+            throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA, "Cannot parse CapnProto schema {}:{}", schema_info.schemaPath(), e.getLine());
+
+        throw Exception(ErrorCodes::UNKNOWN_EXCEPTION,
+                        "Unknown exception while parsing CapnProto schema: {}, schema dir and file: {}, {}",
+                        description, schema_info.schemaDirectory(), schema_info.schemaPath());
+    }
+
+    auto message_maybe = schema.findNested(schema_info.messageName());
+    auto * message_schema = kj::_::readMaybe(message_maybe);
+    if (!message_schema)
+        throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA,
+                        "CapnProto schema doesn't contain message with name {}", schema_info.messageName());
+    return message_schema->asStruct();
+}
+
+bool checkIfStructContainsUnnamedUnion(const capnp::StructSchema & struct_schema)
+{
+    return struct_schema.getFields().size() != struct_schema.getNonUnionFields().size();
+}
+
+bool checkIfStructIsNamedUnion(const capnp::StructSchema & struct_schema)
+{
+    return struct_schema.getFields().size() == struct_schema.getUnionFields().size();
+}
+
+/// Get full name of type for better exception messages.
+String getCapnProtoFullTypeName(const capnp::Type & type)
+{
+    static const std::map<capnp::schema::Type::Which, String> capnp_simple_type_names =
+    {
+        {capnp::schema::Type::Which::BOOL, "Bool"},
+        {capnp::schema::Type::Which::VOID, "Void"},
+        {capnp::schema::Type::Which::INT8, "Int8"},
+        {capnp::schema::Type::Which::INT16, "Int16"},
+        {capnp::schema::Type::Which::INT32, "Int32"},
+        {capnp::schema::Type::Which::INT64, "Int64"},
+        {capnp::schema::Type::Which::UINT8, "UInt8"},
+        {capnp::schema::Type::Which::UINT16, "UInt16"},
+        {capnp::schema::Type::Which::UINT32, "UInt32"},
+        {capnp::schema::Type::Which::UINT64, "UInt64"},
+        {capnp::schema::Type::Which::FLOAT32, "Float32"},
+        {capnp::schema::Type::Which::FLOAT64, "Float64"},
+        {capnp::schema::Type::Which::TEXT, "Text"},
+        {capnp::schema::Type::Which::DATA, "Data"},
+        {capnp::schema::Type::Which::INTERFACE, "Interface"},
+        {capnp::schema::Type::Which::ANY_POINTER, "AnyPointer"},
+    };
+
+    switch (type.which())
+    {
+        case capnp::schema::Type::Which::STRUCT:
+        {
+            auto struct_schema = type.asStruct();
+
+            auto non_union_fields = struct_schema.getNonUnionFields();
+            std::vector<String> non_union_field_names;
+            for (auto nested_field : non_union_fields)
+                non_union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
+
+            auto union_fields = struct_schema.getUnionFields();
+            std::vector<String> union_field_names;
+            for (auto nested_field : union_fields)
+                union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
+
+            String union_name = "Union(" + boost::algorithm::join(union_field_names, ", ") + ")";
+            /// Check if the struct is a named union.
+            if (non_union_field_names.empty())
+                return union_name;
+
+            String type_name = "Struct(" + boost::algorithm::join(non_union_field_names, ", ");
+            /// Check if the struct contains unnamed union.
+            if (!union_field_names.empty())
+                type_name += ", " + union_name;
+            type_name += ")";
+            return type_name;
+        }
+        case capnp::schema::Type::Which::LIST:
+            return "List(" + getCapnProtoFullTypeName(type.asList().getElementType()) + ")";
+        case capnp::schema::Type::Which::ENUM:
+        {
+            auto enum_schema = type.asEnum();
+            String enum_name = "Enum(";
+            auto enumerants = enum_schema.getEnumerants();
+            for (unsigned i = 0; i != enumerants.size(); ++i)
+            {
+                enum_name += String(enumerants[i].getProto().getName()) + " = " + std::to_string(enumerants[i].getOrdinal());
+                if (i + 1 != enumerants.size())
+                    enum_name += ", ";
+            }
+            enum_name += ")";
+            return enum_name;
+        }
+        default:
+            auto it = capnp_simple_type_names.find(type.which());
+            if (it == capnp_simple_type_names.end())
+                throw Exception(ErrorCodes::BAD_TYPE_OF_FIELD, "Unknown CapnProto type");
+            return it->second;
+    }
+}
+
+namespace
+{
+
+    template <typename ValueType>
+    static DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
+    {
+        std::vector<std::pair<String, ValueType>> values;
+        for (auto enumerant : enumerants)
+            values.emplace_back(enumerant.getProto().getName(), ValueType(enumerant.getOrdinal()));
+        return std::make_shared<DataTypeEnum<ValueType>>(std::move(values));
+    }
+
+    static DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
+    {
+        auto enumerants = enum_schema.getEnumerants();
+        if (enumerants.size() < 128)
+            return getEnumDataTypeFromEnumerants<Int8>(enumerants);
+        if (enumerants.size() < 32768)
+            return getEnumDataTypeFromEnumerants<Int16>(enumerants);
+
+        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "ClickHouse supports only 8 and 16-bit Enums");
+    }
+
+    static DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::INT8:
+                return std::make_shared<DataTypeInt8>();
+            case capnp::schema::Type::INT16:
+                return std::make_shared<DataTypeInt16>();
+            case capnp::schema::Type::INT32:
+                return std::make_shared<DataTypeInt32>();
+            case capnp::schema::Type::INT64:
+                return std::make_shared<DataTypeInt64>();
+            case capnp::schema::Type::BOOL: [[fallthrough]];
+            case capnp::schema::Type::UINT8:
+                return std::make_shared<DataTypeUInt8>();
+            case capnp::schema::Type::UINT16:
+                return std::make_shared<DataTypeUInt16>();
+            case capnp::schema::Type::UINT32:
+                return std::make_shared<DataTypeUInt32>();
+            case capnp::schema::Type::UINT64:
+                return std::make_shared<DataTypeUInt64>();
+            case capnp::schema::Type::FLOAT32:
+                return std::make_shared<DataTypeFloat32>();
+            case capnp::schema::Type::FLOAT64:
+                return std::make_shared<DataTypeFloat64>();
+            case capnp::schema::Type::DATA: [[fallthrough]];
+            case capnp::schema::Type::TEXT:
+                return std::make_shared<DataTypeString>();
+            case capnp::schema::Type::ENUM:
+                return getEnumDataTypeFromEnumSchema(capnp_type.asEnum());
+            case capnp::schema::Type::LIST:
+            {
+                auto list_schema = capnp_type.asList();
+                auto nested_type = getDataTypeFromCapnProtoType(list_schema.getElementType(), skip_unsupported_fields);
+                if (!nested_type)
+                    return nullptr;
+                return std::make_shared<DataTypeArray>(nested_type);
+            }
+            case capnp::schema::Type::STRUCT:
+            {
+                auto struct_schema = capnp_type.asStruct();
+
+
+                if (struct_schema.getFields().size() == 0)
+                {
+                    if (skip_unsupported_fields)
+                        return nullptr;
+                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Empty messages are not supported");
+                }
+
+                /// Check if it can be Nullable.
+                if (checkIfStructIsNamedUnion(struct_schema))
+                {
+                    auto fields = struct_schema.getUnionFields();
+                    if (fields.size() != 2 || (!fields[0].getType().isVoid() && !fields[1].getType().isVoid()))
+                    {
+                        if (skip_unsupported_fields)
+                            return nullptr;
+                        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unions are not supported");
+                    }
+                    auto value_type = fields[0].getType().isVoid() ? fields[1].getType() : fields[0].getType();
+                    if (value_type.isStruct() || value_type.isList())
+                    {
+                        if (skip_unsupported_fields)
+                            return nullptr;
+                        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Tuples and Lists cannot be inside Nullable");
+                    }
+
+                    auto nested_type = getDataTypeFromCapnProtoType(value_type, skip_unsupported_fields);
+                    if (!nested_type)
+                        return nullptr;
+                    return std::make_shared<DataTypeNullable>(nested_type);
+                }
+
+                if (checkIfStructContainsUnnamedUnion(struct_schema))
+                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
+
+                /// Treat Struct as Tuple.
+                DataTypes nested_types;
+                Names nested_names;
+                for (auto field : struct_schema.getNonUnionFields())
+                {
+                    auto nested_type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
+                    if (!nested_type)
+                        continue;
+                    nested_names.push_back(field.getProto().getName());
+                    nested_types.push_back(nested_type);
+                }
+                if (nested_types.empty())
+                    return nullptr;
+                return std::make_shared<DataTypeTuple>(std::move(nested_types), std::move(nested_names));
+            }
+            default:
+            {
+                if (skip_unsupported_fields)
+                    return nullptr;
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unsupported CapnProtoType: {}", getCapnProtoFullTypeName(capnp_type));
+            }
+        }
+}
+
+}
+
+NamesAndTypesList capnProtoSchemaToCHSchema(const capnp::StructSchema & schema, bool skip_unsupported_fields)
+{
+    if (checkIfStructContainsUnnamedUnion(schema))
+        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
+
+    NamesAndTypesList names_and_types;
+    for (auto field : schema.getNonUnionFields())
+    {
+        auto name = field.getProto().getName();
+        auto type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
+        if (type)
+            names_and_types.emplace_back(name, type);
+    }
+    if (names_and_types.empty())
+        throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                        "Cannot convert CapnProto schema to ClickHouse table schema, all fields have unsupported types");
+
+    return names_and_types;
+}
+
+}
+
+#endif
diff --git a/src/Formats/CapnProtoUtils.h b/src/Formats/CapnProtoSchema.h
similarity index 59%
rename from src/Formats/CapnProtoUtils.h
rename to src/Formats/CapnProtoSchema.h
index 2d8cdb418d7..225f6f56207 100644
--- a/src/Formats/CapnProtoUtils.h
+++ b/src/Formats/CapnProtoSchema.h
@@ -30,17 +30,14 @@ public:
     capnp::StructSchema getMessageSchema(const FormatSchemaInfo & schema_info);
 };
 
-std::pair<String, String> splitCapnProtoFieldName(const String & name);
+bool checkIfStructContainsUnnamedUnion(const capnp::StructSchema & struct_schema);
+bool checkIfStructIsNamedUnion(const capnp::StructSchema & struct_schema);
 
-bool compareEnumNames(const String & first, const String & second, FormatSettings::EnumComparingMode mode);
-
-std::pair<capnp::DynamicStruct::Builder, capnp::StructSchema::Field> getStructBuilderAndFieldByColumnName(capnp::DynamicStruct::Builder struct_builder, const String & name);
-
-capnp::DynamicValue::Reader getReaderByColumnName(const capnp::DynamicStruct::Reader & struct_reader, const String & name);
-
-void checkCapnProtoSchemaStructure(const capnp::StructSchema & schema, const Block & header, FormatSettings::EnumComparingMode mode);
+/// Get full name of type for better exception messages.
+String getCapnProtoFullTypeName(const capnp::Type & type);
 
 NamesAndTypesList capnProtoSchemaToCHSchema(const capnp::StructSchema & schema, bool skip_unsupported_fields);
+
 }
 
 #endif
diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
new file mode 100644
index 00000000000..e0c8ae2a79a
--- /dev/null
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -0,0 +1,1218 @@
+#include <Formats/CapnProtoSerializer.h>
+#include <Formats/FormatSettings.h>
+#include <Formats/CapnProtoSchema.h>
+#include <DataTypes/DataTypeArray.h>
+#include <DataTypes/DataTypeEnum.h>
+#include <DataTypes/DataTypeLowCardinality.h>
+#include <DataTypes/DataTypeNullable.h>
+#include <DataTypes/DataTypeTuple.h>
+#include <DataTypes/DataTypesNumber.h>
+#include <DataTypes/DataTypeMap.h>
+#include <DataTypes/IDataType.h>
+#include <Columns/ColumnArray.h>
+#include <Columns/ColumnNullable.h>
+#include <Columns/ColumnString.h>
+#include <Columns/ColumnFixedString.h>
+#include <Columns/ColumnTuple.h>
+#include <Columns/ColumnLowCardinality.h>
+#include <Columns/ColumnsDateTime.h>
+#include <Columns/ColumnMap.h>
+
+#include <boost/algorithm/string.hpp>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int THERE_IS_NO_COLUMN;
+    extern const int BAD_TYPE_OF_FIELD;
+    extern const int CAPN_PROTO_BAD_CAST;
+    extern const int INCORRECT_DATA;
+    extern const int ILLEGAL_COLUMN;
+}
+
+namespace
+{
+    std::pair<String, String> splitFieldName(const String & name)
+    {
+        const auto * begin = name.data();
+        const auto * end = name.data() + name.size();
+        const auto * it = find_first_symbols<'_', '.'>(begin, end);
+        String first = String(begin, it);
+        String second = it == end ? "" : String(it + 1, end);
+        return {first, second};
+    }
+
+    std::optional<capnp::StructSchema::Field> findFieldByName(const capnp::StructSchema & struct_schema, const String & name)
+    {
+        const auto & fields = struct_schema.getFields();
+        for (auto field : fields)
+        {
+            auto field_name = String(field.getProto().getName());
+            if (boost::to_lower_copy(name) == boost::to_lower_copy(field_name))
+                return field;
+        }
+        return std::nullopt;
+    }
+
+    [[noreturn]] void throwCannotConvert(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type)
+    {
+        throw Exception(
+            ErrorCodes::CAPN_PROTO_BAD_CAST,
+            "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto type {}",
+            name,
+            type->getName(),
+            getCapnProtoFullTypeName(capnp_type));
+    }
+
+    struct FieldBuilder
+    {
+        virtual ~FieldBuilder() = default;
+    };
+
+    struct ListBuilder : public FieldBuilder
+    {
+        explicit ListBuilder(capnp::DynamicValue::Builder builder) : impl(builder.as<capnp::DynamicList>())
+        {
+        }
+
+        capnp::DynamicList::Builder impl;
+        std::vector<std::unique_ptr<FieldBuilder>> nested_builders;
+    };
+
+    struct StructBuilder : public FieldBuilder
+    {
+        explicit StructBuilder(capnp::DynamicValue::Builder builder, size_t fields_size) : impl(builder.as<capnp::DynamicStruct>()), field_builders(fields_size)
+        {
+        }
+
+        explicit StructBuilder(capnp::DynamicStruct::Builder struct_builder, size_t fields_size) : impl(std::move(struct_builder)), field_builders(fields_size)
+        {
+        }
+
+        capnp::DynamicStruct::Builder impl;
+        std::vector<std::unique_ptr<FieldBuilder>> field_builders;
+    };
+
+    std::unique_ptr<FieldBuilder> initStructFieldBuilderIfNeeded(const ColumnPtr & column, size_t row_num, capnp::DynamicStruct::Builder & struct_builder, const capnp::StructSchema::Field & field, const capnp::Type & capnp_type, size_t nested_fields_size)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::LIST:
+            {
+                const auto * array_column = assert_cast<const ColumnArray *>(column.get());
+                size_t size = array_column->getOffsets()[row_num] - array_column->getOffsets()[row_num - 1];
+                return std::make_unique<ListBuilder>(struct_builder.init(field, static_cast<unsigned>(size)));
+            }
+            case capnp::schema::Type::STRUCT:
+            {
+                return std::make_unique<StructBuilder>(struct_builder.init(field), nested_fields_size);
+            }
+            default:
+                return nullptr;
+        }
+    }
+
+    class ICapnProtoSerializer
+    {
+    public:
+        virtual std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * builder, size_t row_num) = 0;
+        virtual void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) = 0;
+
+        virtual ~ICapnProtoSerializer() = default;
+    };
+
+    template <typename NumericType, bool is_bool_data_type, capnp::DynamicValue::Type capnp_dynamic_type>
+    class CapnProtoIntegerSerializer : public ICapnProtoSerializer
+    {
+    public:
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::INT)
+                return capnp::DynamicValue::Reader(column->getInt(row_num));
+            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::UINT)
+                return capnp::DynamicValue::Reader(column->getUInt(row_num));
+            return capnp::DynamicValue::Reader(column->getBool(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            NumericType value;
+            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::INT)
+                value = static_cast<NumericType>(reader.as<Int64>());
+            else if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::UINT)
+                value = static_cast<NumericType>(reader.as<UInt64>());
+            else if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::BOOL)
+                value = static_cast<NumericType>(reader.as<bool>());
+
+            if constexpr (is_bool_data_type)
+                assert_cast<ColumnUInt8 &>(column).insertValue(static_cast<bool>(value));
+            else
+                assert_cast<ColumnVector<NumericType> &>(column).insertValue(value);
+        }
+    };
+
+    template <typename NumericType, bool is_bool_data_type = false>
+    static std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::INT8: [[fallthrough]];
+            case capnp::schema::Type::INT16: [[fallthrough]];
+            case capnp::schema::Type::INT32: [[fallthrough]];
+            case capnp::schema::Type::INT64:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::INT>>();
+            case capnp::schema::Type::UINT8: [[fallthrough]];
+            case capnp::schema::Type::UINT16: [[fallthrough]];
+            case capnp::schema::Type::UINT32: [[fallthrough]];
+            case capnp::schema::Type::UINT64:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::UINT>>();
+            case capnp::schema::Type::BOOL:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::BOOL>>();
+            default:
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+    }
+
+    template <typename NumericType>
+    class CapnProtoBigIntegerSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoBigIntegerSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(NumericType))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+
+    private:
+        DataTypePtr data_type;
+    };
+
+    template <typename FloatType>
+    class CapnProtoFloatSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoFloatSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isFloat32() && !capnp_type.isFloat64())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getFloat64(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnVector<FloatType> &>(column).insertValue(reader.as<FloatType>());
+        }
+    };
+
+    template <typename EnumType>
+    class CapnProtoEnumSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoEnumSerializer(
+            const DataTypePtr & data_type_,
+            const String & column_name,
+            const capnp::Type & capnp_type,
+            const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode_) : data_type(data_type_), enum_comparing_mode(enum_comparing_mode_)
+        {
+            if (!capnp_type.isEnum())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            bool to_lower = enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE;
+            const auto * enum_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            const auto & enum_values = dynamic_cast<const EnumValues<EnumType> &>(*enum_type);
+
+            enum_schema = capnp_type.asEnum();
+            auto enumerants = enum_schema.getEnumerants();
+            constexpr auto max_value = std::is_same_v<EnumType, Int8> ? INT8_MAX : INT16_MAX;
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+            {
+                /// In CapnProto Enum fields are numbered sequentially starting from zero.
+                if (enumerants.size() > max_value)
+                    throw Exception(
+                        ErrorCodes::CAPN_PROTO_BAD_CAST,
+                        "Enum from CapnProto schema contains values that are out of range for Clickhouse enum type {}",
+                        data_type->getName());
+
+                auto values = enum_values.getSetOfAllValues();
+                std::unordered_set<EnumType> capn_enum_values;
+                for (auto enumerant : enumerants)
+                    capn_enum_values.insert(EnumType(enumerant.getOrdinal()));
+                if (values != capn_enum_values)
+                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "The set of values in Enum from CapnProto schema is different from the set of values in ClickHouse Enum");
+            }
+            else
+            {
+                auto names = enum_values.getSetOfAllNames(to_lower);
+                std::unordered_set<String> capn_enum_names;
+
+                for (auto enumerant : enumerants)
+                {
+                    String name = enumerant.getProto().getName();
+                    capn_enum_names.insert(to_lower ? boost::algorithm::to_lower_copy(name) : name);
+                }
+
+                if (names != capn_enum_names)
+                    throw Exception(
+                        ErrorCodes::CAPN_PROTO_BAD_CAST,
+                        "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum");
+            }
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            const auto * enum_data_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                return capnp::DynamicValue::Reader(capnp::DynamicEnum(enum_schema, enum_value));
+
+            auto enum_name = enum_data_type->getNameForValue(enum_value);
+            for (const auto enumerant : enum_schema.getEnumerants())
+            {
+                if (compareEnumNames(String(enum_name), enumerant.getProto().getName(), enum_comparing_mode))
+                    return capnp::DynamicValue::Reader(capnp::DynamicEnum(enumerant));
+            }
+
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert CLickHouse Enum value to CapnProto Enum");
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto enum_value = reader.as<capnp::DynamicEnum>();
+            auto enumerant = *kj::_::readMaybe(enum_value.getEnumerant());
+            auto enum_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            DataTypePtr nested_type = std::make_shared<DataTypeNumber<EnumType>>();
+            switch (enum_comparing_mode)
+            {
+                case FormatSettings::CapnProtoEnumComparingMode::BY_VALUES:
+                {
+                    assert_cast<ColumnVector<EnumType> &>(column).insertValue(static_cast<EnumType>(enumerant.getOrdinal()));
+                    return;
+                }
+                case FormatSettings::CapnProtoEnumComparingMode::BY_NAMES:
+                {
+                    auto value = enum_type->getValue(String(enumerant.getProto().getName()));
+                    assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
+                    return;
+                }
+                case FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE:
+                {
+                    /// Find the same enum name case insensitive.
+                    String enum_name = enumerant.getProto().getName();
+                    for (auto & name : enum_type->getAllRegisteredNames())
+                    {
+                        if (compareEnumNames(name, enum_name, enum_comparing_mode))
+                        {
+                            assert_cast<ColumnVector<EnumType> &>(column).insertValue(enum_type->getValue(name));
+                            break;
+                        }
+                    }
+                    return;
+                }
+            }
+        }
+
+    private:
+        bool compareEnumNames(const String & first, const String & second, const FormatSettings::CapnProtoEnumComparingMode mode)
+        {
+            if (mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE)
+                return boost::algorithm::to_lower_copy(first) == boost::algorithm::to_lower_copy(second);
+            return first == second;
+        }
+
+        DataTypePtr data_type;
+        capnp::EnumSchema enum_schema;
+        const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode;
+    };
+
+    class CapnProtoDateSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDateSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isUInt16())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getUInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDate &>(column).insertValue(reader.as<UInt16>());
+        }
+    };
+
+    class CapnProtoDate32Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDate32Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isInt32())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDate32 &>(column).insertValue(reader.as<Int32>());
+        }
+    };
+
+    class CapnProtoDateTimeSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDateTimeSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isUInt32())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDateTime &>(column).insertValue(reader.as<UInt32>());
+        }
+    };
+
+    class CapnProtoDateTime64Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDateTime64Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isInt64())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDateTime64 &>(column).insertValue(reader.as<Int64>());
+        }
+    };
+
+    template <typename DecimalType>
+    class CapnProtoDecimalSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDecimalSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            auto which = WhichDataType(data_type);
+            if ((!capnp_type.isInt32() && which.isDecimal32()) || (!capnp_type.isInt64() && which.isDecimal64()))
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(reader.as<typename DecimalType::NativeType>());
+        }
+    };
+
+    template <typename DecimalType>
+    class CapnProtoBigDecimalSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoBigDecimalSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(DecimalType))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+
+    private:
+        DataTypePtr data_type;
+    };
+
+    template <bool is_binary>
+    class CapnProtoStringSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
+        {
+            if (!capnp_type.isData() && !capnp_type.isText())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+
+            if constexpr (is_binary)
+                return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+
+            /// For type TEXT data must be null-terminated, but in String column we always have 0 byte at the end of each value.
+            return capnp::DynamicValue::Reader(capnp::Text::Reader(data.data, data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            if constexpr (is_binary)
+            {
+                auto value = reader.as<capnp::Data>();
+                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+            else
+            {
+                auto value = reader.as<capnp::Text>();
+                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+        }
+
+    private:
+        capnp::Type capnp_type;
+    };
+
+    template <bool is_binary>
+    class CapnProtoFixedStringSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoFixedStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
+        {
+            if (!capnp_type.isData() && !capnp_type.isText())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            if constexpr (is_binary)
+                return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+
+            if (data.data[data.size - 1] == 0)
+                return capnp::DynamicValue::Reader(capnp::Text::Reader(reinterpret_cast<const char *>(data.data), data.size));
+
+            /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
+            /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
+            /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
+            /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
+            tmp_string = data.toString();
+            return capnp::DynamicValue::Reader(capnp::Text::Reader(reinterpret_cast<const char *>(tmp_string.data()), tmp_string.size()));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
+            if constexpr (is_binary)
+            {
+                auto value = reader.as<capnp::Data>();
+                if (value.size() > fixed_string_column.getN())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
+
+                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+            else
+            {
+                auto value = reader.as<capnp::Text>();
+                if (value.size() > fixed_string_column.getN())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
+
+                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+        }
+
+    private:
+        String tmp_string;
+        capnp::Type capnp_type;
+    };
+
+    class CapnProtoIPv4Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoIPv4Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isUInt32())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(assert_cast<const ColumnIPv4 &>(*column).getElement(row_num).toUnderType());
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(reader.as<UInt32>()));
+        }
+    };
+
+    class CapnProtoIPv6Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoIPv6Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(IPv6))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of IPv6 value: {}", value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+    };
+
+    class CapnProtoUUIDSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoUUIDSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(UUID))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of UUID value: {}", value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+    };
+
+    std::unique_ptr<ICapnProtoSerializer> createSerializer(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings);
+
+    class CapnProtoLowCardinalitySerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoLowCardinalitySerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            nested_serializer = createSerializer(assert_cast<const DataTypeLowCardinality &>(*data_type).getDictionaryType(), column_name, capnp_type, settings);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
+            size_t index = low_cardinality_column.getIndexAt(row_num);
+            const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
+            return nested_serializer->writeRow(dict_column, field_builder, index);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
+            auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
+            nested_serializer->readRow(*tmp_column, reader);
+            low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+    };
+
+    class CapnProtoNullableSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoNullableSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            if (!capnp_type.isStruct())
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type, got CapnProto type {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            /// Check that struct is a named union of type VOID and one arbitrary type.
+            auto struct_schema = capnp_type.asStruct();
+            if (!checkIfStructIsNamedUnion(struct_schema))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type."
+                    "Given CapnProto struct is not a named union: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            auto union_fields = struct_schema.getUnionFields();
+            if (union_fields.size() != 2)
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type."
+                    "Given CapnProto union have more than 2 fields: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            auto first = union_fields[0];
+            auto second = union_fields[1];
+            auto nested_type = assert_cast<const DataTypeNullable *>(data_type.get())->getNestedType();
+            if (first.getType().isVoid())
+            {
+                null_field = first;
+                nested_field = second;
+                nested_capnp_type = second.getType();
+                if (nested_capnp_type.isStruct())
+                    nested_fields_size = nested_capnp_type.asStruct().getFields().size();
+                nested_serializer = createSerializer(nested_type, column_name, nested_capnp_type, settings);
+            }
+            else if (second.getType().isVoid())
+            {
+                null_field = second;
+                nested_field = first;
+                nested_capnp_type = first.getType();
+                if (nested_capnp_type.isStruct())
+                    nested_fields_size = nested_capnp_type.asStruct().getFields().size();
+                nested_serializer = createSerializer(nested_type, column_name, nested_capnp_type, settings);
+            }
+            else
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type."
+                    "Given CapnProto union doesn't have field with type Void: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            assert(field_builder);
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            const auto & nullable_column = assert_cast<const ColumnNullable &>(*column);
+            if (nullable_column.isNullAt(row_num))
+            {
+                struct_builder.impl.set(null_field, capnp::Void());
+            }
+            else
+            {
+                struct_builder.impl.clear(nested_field);
+                const auto & nested_column = nullable_column.getNestedColumnPtr();
+                auto nested_field_builder = initStructFieldBuilderIfNeeded(nested_column, row_num, struct_builder.impl, nested_field, nested_capnp_type, nested_fields_size);
+                auto value = nested_serializer->writeRow(nested_column, nested_field_builder.get(), row_num);
+                if (value)
+                    struct_builder.impl.set(nested_field, *value);
+            }
+
+            return std::nullopt;
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            auto & nullable_column = assert_cast<ColumnNullable &>(column);
+            auto field = *kj::_::readMaybe(struct_reader.which());
+            if (field.getType().isVoid())
+                nullable_column.insertDefault();
+            else
+            {
+                auto & nested_column = nullable_column.getNestedColumn();
+                auto nested_reader = struct_reader.get(field);
+                nested_serializer->readRow(nested_column, nested_reader);
+                nullable_column.getNullMapData().push_back(0);
+            }
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+        capnp::StructSchema::Field null_field;
+        capnp::StructSchema::Field nested_field;
+        size_t nested_fields_size = 0;
+        capnp::Type nested_capnp_type;
+    };
+
+    class CapnProtoArraySerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoArraySerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            if (!capnp_type.isList())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            auto nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
+            element_type = capnp_type.asList().getElementType();
+            if (element_type.isStruct())
+                element_struct_fields = element_type.asStruct().getFields().size();
+            nested_serializer = createSerializer(nested_type, column_name, capnp_type.asList().getElementType(), settings);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            assert(field_builder);
+            auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
+            const auto * array_column = assert_cast<const ColumnArray *>(column.get());
+            const auto & nested_column = array_column->getDataPtr();
+            const auto & offsets = array_column->getOffsets();
+            auto offset = offsets[row_num - 1];
+            size_t size = offsets[row_num] - offset;
+            bool need_nested_builders = list_builder.nested_builders.empty();
+            for (unsigned i = 0; i != static_cast<unsigned>(size); ++i)
+            {
+                if (need_nested_builders)
+                {
+                    /// For nested lists we need to initialize nested list builder.
+                    if (element_type.isList())
+                    {
+                        const auto & nested_offset = checkAndGetColumn<ColumnArray>(*nested_column)->getOffsets();
+                        size_t nested_array_size = nested_offset[offset + i] - nested_offset[offset + i - 1];
+                        list_builder.nested_builders.emplace_back(std::make_unique<ListBuilder>(list_builder.impl.init(i, static_cast<unsigned>(nested_array_size))));
+                    }
+                    else if (element_type.isStruct())
+                    {
+                        list_builder.nested_builders.emplace_back(std::make_unique<StructBuilder>(list_builder.impl[i], element_struct_fields));
+                    }
+                    else
+                    {
+                        list_builder.nested_builders.emplace_back();
+                    }
+                }
+
+                auto value = nested_serializer->writeRow(nested_column, list_builder.nested_builders[i].get(), offset + i);
+                if (value)
+                    list_builder.impl.set(i, *value);
+            }
+
+            return std::nullopt;
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto list_reader = reader.as<capnp::DynamicList>();
+            auto & column_array = assert_cast<ColumnArray &>(column);
+            auto & offsets = column_array.getOffsets();
+            offsets.push_back(offsets.back() + list_reader.size());
+
+            auto & nested_column = column_array.getData();
+            for (const auto & nested_reader : list_reader)
+                nested_serializer->readRow(nested_column, nested_reader);
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+        capnp::Type element_type;
+        size_t element_struct_fields;
+    };
+
+    class CapnProtoMapSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoMapSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            /// We output/input Map type as follow CapnProto schema
+            ///
+            /// struct Map {
+            ///     struct Entry {
+            ///         key @0: Key;
+            ///         value @1: Value;
+            ///     }
+            ///     entries @0 :List(Entry);
+            /// }
+
+            if (!capnp_type.isStruct())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            auto struct_schema = capnp_type.asStruct();
+
+            if (checkIfStructContainsUnnamedUnion(struct_schema))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto Struct with unnamed union {}",
+                    column_name,
+                    data_type->getName(),
+                    getCapnProtoFullTypeName(capnp_type));
+
+            if (struct_schema.getFields().size() != 1)
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": Map type can be represented as a Struct with one list field, got struct: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            const auto & field_type = struct_schema.getFields()[0].getType();
+            if (!field_type.isList())
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": Map type can be represented as a Struct with one list field, got field: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(field_type));
+
+            auto list_element_type = field_type.asList().getElementType();
+            if (!list_element_type.isStruct())
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": Field of struct that represents Map should be a list of structs, got list of {}",
+                    column_name,
+                    getCapnProtoFullTypeName(list_element_type));
+
+            auto key_value_struct = list_element_type.asStruct();
+            if (checkIfStructContainsUnnamedUnion(key_value_struct))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": struct that represents Map entries is unnamed union: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(list_element_type));
+
+            if (key_value_struct.getFields().size() != 2)
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": struct that represents Map entries should contain only 2 fields, got struct {}",
+                    column_name,
+                    getCapnProtoFullTypeName(list_element_type));
+
+            const auto & map_type = assert_cast<const DataTypeMap &>(*data_type);
+            DataTypes types = {map_type.getKeyType(), map_type.getValueType()};
+            Names names = {"key", "value"};
+            auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(types, names));
+            entries_field = struct_schema.getFields()[0];
+            entries_capnp_type = entries_field.getType();
+            nested_serializer = createSerializer(entries_type, column_name, field_type, settings);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            assert(field_builder);
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
+            auto entries_builder = initStructFieldBuilderIfNeeded(entries_column, row_num, struct_builder.impl, entries_field, entries_capnp_type, 0);
+            nested_serializer->writeRow(entries_column, entries_builder.get(), row_num);
+            return std::nullopt;
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
+            nested_serializer->readRow(entries_column, struct_reader.get(entries_field));
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+        capnp::StructSchema::Field entries_field;
+        capnp::Type entries_capnp_type;
+    };
+
+    class CapnProtoStructureSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoStructureSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        {
+            if (checkIfStructIsNamedUnion(schema) || checkIfStructContainsUnnamedUnion(schema))
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Root CapnProto Struct cannot be named union/struct with unnamed union");
+
+            initialize(data_types, names, schema, settings);
+        }
+
+        CapnProtoStructureSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            if (!capnp_type.isStruct())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            auto struct_schema = capnp_type.asStruct();
+
+            if (checkIfStructIsNamedUnion(struct_schema) || checkIfStructContainsUnnamedUnion(struct_schema))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto named union/struct with unnamed union {}",
+                    column_name,
+                    data_type->getName(),
+                    getCapnProtoFullTypeName(capnp_type));
+
+            const auto * tuple_data_type = assert_cast<const DataTypeTuple *>(data_type.get());
+            auto nested_types = tuple_data_type->getElements();
+            Names nested_names;
+            bool have_explicit_names = tuple_data_type->haveExplicitNames();
+            auto structure_fields = struct_schema.getFields();
+            if (!have_explicit_names)
+            {
+                if (nested_types.size() != structure_fields.size())
+                    throw Exception(
+                        ErrorCodes::CAPN_PROTO_BAD_CAST,
+                        "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto type {}: Tuple and Struct have different sizes {} != {}",
+                        column_name,
+                        data_type->getName(),
+                        getCapnProtoFullTypeName(capnp_type),
+                        nested_types.size(),
+                        structure_fields.size());
+                nested_names.reserve(structure_fields.size());
+                for (auto field : structure_fields)
+                    nested_names.push_back(field.getProto().getName());
+            }
+            else
+            {
+                nested_names = tuple_data_type->getElementNames();
+            }
+
+            try
+            {
+                initialize(nested_types, nested_names, struct_schema, settings);
+            }
+            catch (Exception & e)
+            {
+                e.addMessage("(while converting column {})", column_name);
+                throw e;
+            }
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * builder, size_t row_num) override
+        {
+            assert(builder);
+            auto & struct_builder = assert_cast<StructBuilder &>(*builder);
+            if (auto tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+                writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
+            else
+                writeRow(Columns{column}, struct_builder, row_num);
+            return std::nullopt;
+        }
+
+        void writeRow(const Columns & columns, StructBuilder & struct_builder, size_t row_num)
+        {
+            for (size_t i = 0; i != columns.size(); ++i)
+            {
+                const auto & field = fields[i];
+                size_t field_index = field.getIndex();
+                if (likely(!struct_builder.field_builders[field_index]))
+                    struct_builder.field_builders[field_index] = initStructFieldBuilderIfNeeded(
+                        columns[i], row_num, struct_builder.impl, field, fields_types[i], nested_field_sizes[i]);
+
+                auto value = field_serializers[i]->writeRow(columns[i], struct_builder.field_builders[field_index].get(), row_num);
+                if (value)
+                    struct_builder.impl.set(field, *value);
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
+            {
+                for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
+                    field_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader.get(fields[i]));
+            }
+            else
+                field_serializers[0]->readRow(column, struct_reader.get(fields[0]));
+        }
+
+        void readRow(MutableColumns & columns, const capnp::DynamicStruct::Reader & reader)
+        {
+            for (size_t i = 0; i != columns.size(); ++i)
+                field_serializers[i]->readRow(*columns[i], reader.get(fields[i]));
+        }
+
+    private:
+        void initialize(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        {
+            field_serializers.reserve(data_types.size());
+            fields.reserve(data_types.size());
+            fields_types.reserve(data_types.size());
+            nested_field_sizes.reserve(data_types.size());
+            for (size_t i = 0; i != data_types.size(); ++i)
+            {
+                auto [field_name, _] = splitFieldName(names[i]);
+                auto field = findFieldByName(schema, field_name);
+                if (!field)
+                    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto schema doesn't contain field with name {}", field_name);
+
+                fields.push_back(*field);
+                auto capnp_type = field->getType();
+                fields_types.push_back(capnp_type);
+                nested_field_sizes.push_back(capnp_type.isStruct() ? capnp_type.asStruct().getFields().size() : 0);
+                field_serializers.push_back(createSerializer(data_types[i], names[i], capnp_type, settings));
+            }
+        }
+
+        std::vector<std::unique_ptr<ICapnProtoSerializer>> field_serializers;
+        std::vector<capnp::StructSchema::Field> fields;
+        std::vector<size_t> nested_field_sizes;
+        std::vector<capnp::Type> fields_types;
+    };
+
+    std::unique_ptr<ICapnProtoSerializer> createSerializer(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+    {
+        auto [field_name, nested_name] = splitFieldName(name);
+        if (!nested_name.empty() && !capnp_type.isList())
+        {
+            if (!capnp_type.isStruct())
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
+
+            return std::make_unique<CapnProtoStructureSerializer>(DataTypes{type}, Names{nested_name}, capnp_type.asStruct(), settings);
+        }
+
+        switch (type->getTypeId())
+        {
+            case TypeIndex::Int8:
+                return createIntegerSerializer<Int8>(type, name, capnp_type);
+            case TypeIndex::UInt8:
+                if (isBool(type))
+                    return createIntegerSerializer<UInt8, true>(type, name, capnp_type);
+                return createIntegerSerializer<UInt8>(type, name, capnp_type);
+            case TypeIndex::Int16:
+                return createIntegerSerializer<Int16>(type, name, capnp_type);
+            case TypeIndex::UInt16:
+                return createIntegerSerializer<UInt16>(type, name, capnp_type);
+            case TypeIndex::Int32:
+                return createIntegerSerializer<Int32>(type, name, capnp_type);
+            case TypeIndex::UInt32:
+                return createIntegerSerializer<UInt32>(type, name, capnp_type);
+            case TypeIndex::Int64:
+                return createIntegerSerializer<Int64>(type, name, capnp_type);
+            case TypeIndex::UInt64:
+                return createIntegerSerializer<UInt64>(type, name, capnp_type);
+            case TypeIndex::Int128:
+                return std::make_unique<CapnProtoBigIntegerSerializer<Int128>>(type, name, capnp_type);
+            case TypeIndex::UInt128:
+                return std::make_unique<CapnProtoBigIntegerSerializer<UInt128>>(type, name, capnp_type);
+            case TypeIndex::Int256:
+                return std::make_unique<CapnProtoBigIntegerSerializer<Int256>>(type, name, capnp_type);
+            case TypeIndex::UInt256:
+                return std::make_unique<CapnProtoBigIntegerSerializer<UInt256>>(type, name, capnp_type);
+            case TypeIndex::Float32:
+                return std::make_unique<CapnProtoFloatSerializer<Float32>>(type, name, capnp_type);
+            case TypeIndex::Float64:
+                return std::make_unique<CapnProtoFloatSerializer<Float64>>(type, name, capnp_type);
+            case TypeIndex::Date:
+                return std::make_unique<CapnProtoDateSerializer>(type, name, capnp_type);
+            case TypeIndex::Date32:
+                return std::make_unique<CapnProtoDate32Serializer>(type, name, capnp_type);
+            case TypeIndex::DateTime:
+                return std::make_unique<CapnProtoDateTimeSerializer>(type, name, capnp_type);
+            case TypeIndex::DateTime64:
+                return std::make_unique<CapnProtoDateTime64Serializer>(type, name, capnp_type);
+            case TypeIndex::Decimal32:
+                return std::make_unique<CapnProtoDecimalSerializer<Decimal32>>(type, name, capnp_type);
+            case TypeIndex::Decimal64:
+                return std::make_unique<CapnProtoDecimalSerializer<Decimal64>>(type, name, capnp_type);
+            case TypeIndex::Decimal128:
+                return std::make_unique<CapnProtoBigDecimalSerializer<Decimal128>>(type, name, capnp_type);
+            case TypeIndex::Decimal256:
+                return std::make_unique<CapnProtoBigDecimalSerializer<Decimal256>>(type, name, capnp_type);
+            case TypeIndex::IPv4:
+                return std::make_unique<CapnProtoIPv4Serializer>(type, name, capnp_type);
+            case TypeIndex::IPv6:
+                return std::make_unique<CapnProtoIPv6Serializer>(type, name, capnp_type);
+            case TypeIndex::UUID:
+                return std::make_unique<CapnProtoUUIDSerializer>(type, name, capnp_type);
+            case TypeIndex::Enum8:
+                return std::make_unique<CapnProtoEnumSerializer<Int8>>(type, name, capnp_type, settings.enum_comparing_mode);
+            case TypeIndex::Enum16:
+                return std::make_unique<CapnProtoEnumSerializer<Int16>>(type, name, capnp_type, settings.enum_comparing_mode);
+            case TypeIndex::String:
+                if (capnp_type.isData())
+                    return std::make_unique<CapnProtoStringSerializer<true>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoStringSerializer<false>>(type, name, capnp_type);
+            case TypeIndex::FixedString:
+                if (capnp_type.isData())
+                    return std::make_unique<CapnProtoFixedStringSerializer<true>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedStringSerializer<false>>(type, name, capnp_type);
+            case TypeIndex::LowCardinality:
+                return std::make_unique<CapnProtoLowCardinalitySerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Nullable:
+                return std::make_unique<CapnProtoNullableSerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Array:
+                return std::make_unique<CapnProtoArraySerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Map:
+                return std::make_unique<CapnProtoMapSerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Tuple:
+                return std::make_unique<CapnProtoStructureSerializer>(type, name, capnp_type, settings);
+            default:
+                throw Exception(ErrorCodes::ILLEGAL_COLUMN, "Type {} is not supported in CapnProto format", type->getName());
+        }
+    }
+}
+
+class CapnProtoSerializer::Impl
+{
+public:
+    Impl(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        : struct_serializer(std::make_unique<CapnProtoStructureSerializer>(data_types, names, schema, settings))
+        , fields_size(schema.getFields().size())
+    {
+    }
+
+    void writeRow(const Columns & columns, capnp::DynamicStruct::Builder builder, size_t row_num)
+    {
+        StructBuilder struct_builder(std::move(builder), fields_size);
+        struct_serializer->writeRow(columns, struct_builder, row_num);
+    }
+
+    void readRow(MutableColumns & columns, capnp::DynamicStruct::Reader & reader)
+    {
+        struct_serializer->readRow(columns, reader);
+    }
+
+private:
+    std::unique_ptr<CapnProtoStructureSerializer> struct_serializer;
+    size_t fields_size;
+};
+
+CapnProtoSerializer::CapnProtoSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+    : serializer_impl(std::make_unique<Impl>(data_types, names, schema, settings))
+{
+}
+
+void CapnProtoSerializer::writeRow(const Columns & columns, capnp::DynamicStruct::Builder builder, size_t row_num)
+{
+    serializer_impl->writeRow(columns, std::move(builder), row_num);
+}
+
+void CapnProtoSerializer::readRow(MutableColumns & columns, capnp::DynamicStruct::Reader & reader)
+{
+    serializer_impl->readRow(columns, reader);
+}
+
+CapnProtoSerializer::~CapnProtoSerializer() = default;
+
+}
diff --git a/src/Formats/CapnProtoSerializer.h b/src/Formats/CapnProtoSerializer.h
new file mode 100644
index 00000000000..efae797875b
--- /dev/null
+++ b/src/Formats/CapnProtoSerializer.h
@@ -0,0 +1,25 @@
+#pragma once
+
+#include <Core/Block.h>
+#include <capnp/dynamic.h>
+
+namespace DB
+{
+
+class CapnProtoSerializer
+{
+public:
+    CapnProtoSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings);
+
+    void writeRow(const Columns & columns, capnp::DynamicStruct::Builder builder, size_t row_num);
+
+    void readRow(MutableColumns & columns, capnp::DynamicStruct::Reader & reader);
+
+    ~CapnProtoSerializer();
+
+private:
+    class Impl;
+    std::unique_ptr<Impl> serializer_impl;
+};
+
+}
diff --git a/src/Formats/CapnProtoUtils.cpp b/src/Formats/CapnProtoUtils.cpp
deleted file mode 100644
index d6c032408bb..00000000000
--- a/src/Formats/CapnProtoUtils.cpp
+++ /dev/null
@@ -1,734 +0,0 @@
-#include <Formats/CapnProtoUtils.h>
-
-#if USE_CAPNP
-
-#include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeEnum.h>
-#include <DataTypes/DataTypeLowCardinality.h>
-#include <DataTypes/DataTypeNullable.h>
-#include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypesNumber.h>
-#include <DataTypes/DataTypeString.h>
-#include <DataTypes/DataTypeMap.h>
-#include <DataTypes/IDataType.h>
-#include <boost/algorithm/string.hpp>
-#include <boost/algorithm/string/join.hpp>
-#include <capnp/schema.h>
-#include <capnp/schema-parser.h>
-#include <fcntl.h>
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int CANNOT_PARSE_CAPN_PROTO_SCHEMA;
-    extern const int THERE_IS_NO_COLUMN;
-    extern const int BAD_TYPE_OF_FIELD;
-    extern const int CAPN_PROTO_BAD_CAST;
-    extern const int FILE_DOESNT_EXIST;
-    extern const int UNKNOWN_EXCEPTION;
-    extern const int INCORRECT_DATA;
-    extern const int CAPN_PROTO_BAD_TYPE;
-    extern const int BAD_ARGUMENTS;
-}
-
-std::pair<String, String> splitCapnProtoFieldName(const String & name)
-{
-    const auto * begin = name.data();
-    const auto * end = name.data() + name.size();
-    const auto * it = find_first_symbols<'_', '.'>(begin, end);
-    String first = String(begin, it);
-    String second = it == end ? "" : String(it + 1, end);
-    return {first, second};
-}
-
-capnp::StructSchema CapnProtoSchemaParser::getMessageSchema(const FormatSchemaInfo & schema_info)
-{
-    capnp::ParsedSchema schema;
-    try
-    {
-        int fd;
-        KJ_SYSCALL(fd = open(schema_info.schemaDirectory().data(), O_RDONLY)); // NOLINT(bugprone-suspicious-semicolon)
-        auto schema_dir = kj::newDiskDirectory(kj::OsFileHandle(fd));
-        schema = impl.parseFromDirectory(*schema_dir, kj::Path::parse(schema_info.schemaPath()), {});
-    }
-    catch (const kj::Exception & e)
-    {
-        /// That's not good to determine the type of error by its description, but
-        /// this is the only way to do it here, because kj doesn't specify the type of error.
-        auto description = std::string_view(e.getDescription().cStr());
-        if (description.find("No such file or directory") != String::npos || description.find("no such directory") != String::npos)
-            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot open CapnProto schema, file {} doesn't exists", schema_info.absoluteSchemaPath());
-
-        if (description.find("Parse error") != String::npos)
-            throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA, "Cannot parse CapnProto schema {}:{}", schema_info.schemaPath(), e.getLine());
-
-        throw Exception(ErrorCodes::UNKNOWN_EXCEPTION,
-                        "Unknown exception while parsing CapnProto schema: {}, schema dir and file: {}, {}",
-                        description, schema_info.schemaDirectory(), schema_info.schemaPath());
-    }
-
-    auto message_maybe = schema.findNested(schema_info.messageName());
-    auto * message_schema = kj::_::readMaybe(message_maybe);
-    if (!message_schema)
-        throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA,
-                        "CapnProto schema doesn't contain message with name {}", schema_info.messageName());
-    return message_schema->asStruct();
-}
-
-bool compareEnumNames(const String & first, const String & second, FormatSettings::EnumComparingMode mode)
-{
-    if (mode == FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE)
-        return boost::algorithm::to_lower_copy(first) == boost::algorithm::to_lower_copy(second);
-    return first == second;
-}
-
-static const std::map<capnp::schema::Type::Which, String> capnp_simple_type_names =
-{
-        {capnp::schema::Type::Which::BOOL, "Bool"},
-        {capnp::schema::Type::Which::VOID, "Void"},
-        {capnp::schema::Type::Which::INT8, "Int8"},
-        {capnp::schema::Type::Which::INT16, "Int16"},
-        {capnp::schema::Type::Which::INT32, "Int32"},
-        {capnp::schema::Type::Which::INT64, "Int64"},
-        {capnp::schema::Type::Which::UINT8, "UInt8"},
-        {capnp::schema::Type::Which::UINT16, "UInt16"},
-        {capnp::schema::Type::Which::UINT32, "UInt32"},
-        {capnp::schema::Type::Which::UINT64, "UInt64"},
-        {capnp::schema::Type::Which::FLOAT32, "Float32"},
-        {capnp::schema::Type::Which::FLOAT64, "Float64"},
-        {capnp::schema::Type::Which::TEXT, "Text"},
-        {capnp::schema::Type::Which::DATA, "Data"},
-        {capnp::schema::Type::Which::INTERFACE, "Interface"},
-        {capnp::schema::Type::Which::ANY_POINTER, "AnyPointer"},
-};
-
-static bool checkIfStructContainsUnnamedUnion(const capnp::StructSchema & struct_schema)
-{
-    return struct_schema.getFields().size() != struct_schema.getNonUnionFields().size();
-}
-
-static bool checkIfStructIsNamedUnion(const capnp::StructSchema & struct_schema)
-{
-    return struct_schema.getFields().size() == struct_schema.getUnionFields().size();
-}
-
-/// Get full name of type for better exception messages.
-static String getCapnProtoFullTypeName(const capnp::Type & type)
-{
-    switch (type.which())
-    {
-        case capnp::schema::Type::Which::STRUCT:
-        {
-            auto struct_schema = type.asStruct();
-
-            auto non_union_fields = struct_schema.getNonUnionFields();
-            std::vector<String> non_union_field_names;
-            for (auto nested_field : non_union_fields)
-                non_union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
-
-            auto union_fields = struct_schema.getUnionFields();
-            std::vector<String> union_field_names;
-            for (auto nested_field : union_fields)
-                union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
-
-            String union_name = "Union(" + boost::algorithm::join(union_field_names, ", ") + ")";
-            /// Check if the struct is a named union.
-            if (non_union_field_names.empty())
-                return union_name;
-
-            String type_name = "Struct(" + boost::algorithm::join(non_union_field_names, ", ");
-            /// Check if the struct contains unnamed union.
-            if (!union_field_names.empty())
-                type_name += ", " + union_name;
-            type_name += ")";
-            return type_name;
-        }
-        case capnp::schema::Type::Which::LIST:
-            return "List(" + getCapnProtoFullTypeName(type.asList().getElementType()) + ")";
-        case capnp::schema::Type::Which::ENUM:
-        {
-            auto enum_schema = type.asEnum();
-            String enum_name = "Enum(";
-            auto enumerants = enum_schema.getEnumerants();
-            for (unsigned i = 0; i != enumerants.size(); ++i)
-            {
-                enum_name += String(enumerants[i].getProto().getName()) + " = " + std::to_string(enumerants[i].getOrdinal());
-                if (i + 1 != enumerants.size())
-                    enum_name += ", ";
-            }
-            enum_name += ")";
-            return enum_name;
-        }
-        default:
-            auto it = capnp_simple_type_names.find(type.which());
-            if (it == capnp_simple_type_names.end())
-                throw Exception(ErrorCodes::BAD_TYPE_OF_FIELD, "Unknown CapnProto type");
-            return it->second;
-    }
-}
-
-template <typename Type>
-static bool checkEnums(const capnp::Type & capnp_type, const DataTypePtr column_type, FormatSettings::EnumComparingMode mode, UInt64 max_value, String & error_message)
-{
-    if (!capnp_type.isEnum())
-        return false;
-
-    auto enum_schema = capnp_type.asEnum();
-    bool to_lower = mode == FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE;
-    const auto * enum_type = assert_cast<const DataTypeEnum<Type> *>(column_type.get());
-    const auto & enum_values = dynamic_cast<const EnumValues<Type> &>(*enum_type);
-
-    auto enumerants = enum_schema.getEnumerants();
-    if (mode == FormatSettings::EnumComparingMode::BY_VALUES)
-    {
-        /// In CapnProto Enum fields are numbered sequentially starting from zero.
-        if (enumerants.size() > max_value)
-        {
-            error_message += "Enum from CapnProto schema contains values that is out of range for Clickhouse Enum";
-            return false;
-        }
-
-        auto values = enum_values.getSetOfAllValues();
-        std::unordered_set<Type> capn_enum_values;
-        for (auto enumerant : enumerants)
-            capn_enum_values.insert(Type(enumerant.getOrdinal()));
-        auto result = values == capn_enum_values;
-        if (!result)
-            error_message += "The set of values in Enum from CapnProto schema is different from the set of values in ClickHouse Enum";
-        return result;
-    }
-
-    auto names = enum_values.getSetOfAllNames(to_lower);
-    std::unordered_set<String> capn_enum_names;
-
-    for (auto enumerant : enumerants)
-    {
-        String name = enumerant.getProto().getName();
-        capn_enum_names.insert(to_lower ? boost::algorithm::to_lower_copy(name) : name);
-    }
-
-    auto result = names == capn_enum_names;
-    if (!result)
-        error_message += "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum";
-    return result;
-}
-
-static bool checkCapnProtoType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name);
-
-static bool checkNullableType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name)
-{
-    if (!capnp_type.isStruct())
-        return false;
-
-    /// Check that struct is a named union of type VOID and one arbitrary type.
-    auto struct_schema = capnp_type.asStruct();
-    if (!checkIfStructIsNamedUnion(struct_schema))
-        return false;
-
-    auto union_fields = struct_schema.getUnionFields();
-    if (union_fields.size() != 2)
-        return false;
-
-    auto first = union_fields[0];
-    auto second = union_fields[1];
-
-    auto nested_type = assert_cast<const DataTypeNullable *>(data_type.get())->getNestedType();
-    if (first.getType().isVoid())
-        return checkCapnProtoType(second.getType(), nested_type, mode, error_message, column_name);
-    if (second.getType().isVoid())
-        return checkCapnProtoType(first.getType(), nested_type, mode, error_message, column_name);
-    return false;
-}
-
-static bool checkTupleType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message)
-{
-    if (!capnp_type.isStruct())
-        return false;
-    auto struct_schema = capnp_type.asStruct();
-
-    if (checkIfStructIsNamedUnion(struct_schema))
-        return false;
-
-    if (checkIfStructContainsUnnamedUnion(struct_schema))
-    {
-        error_message += "CapnProto struct contains unnamed union";
-        return false;
-    }
-
-    const auto * tuple_data_type = assert_cast<const DataTypeTuple *>(data_type.get());
-    auto nested_types = tuple_data_type->getElements();
-    if (nested_types.size() != struct_schema.getFields().size())
-    {
-        error_message += "Tuple and Struct types have different sizes";
-        return false;
-    }
-
-    bool have_explicit_names = tuple_data_type->haveExplicitNames();
-    const auto & nested_names = tuple_data_type->getElementNames();
-    for (uint32_t i = 0; i != nested_names.size(); ++i)
-    {
-        if (have_explicit_names)
-        {
-            KJ_IF_MAYBE (field, struct_schema.findFieldByName(nested_names[i]))
-            {
-                if (!checkCapnProtoType(field->getType(), nested_types[tuple_data_type->getPositionByName(nested_names[i])], mode, error_message, nested_names[i]))
-                    return false;
-            }
-            else
-            {
-                error_message += "CapnProto struct doesn't contain a field with name " + nested_names[i];
-                return false;
-            }
-        }
-        else if (!checkCapnProtoType(struct_schema.getFields()[i].getType(), nested_types[tuple_data_type->getPositionByName(nested_names[i])], mode, error_message, nested_names[i]))
-            return false;
-    }
-
-    return true;
-}
-
-static bool checkArrayType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name)
-{
-    if (!capnp_type.isList())
-        return false;
-    auto list_schema = capnp_type.asList();
-    auto nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
-
-    auto [field_name, nested_name] = splitCapnProtoFieldName(column_name);
-    if (!nested_name.empty() && list_schema.getElementType().isStruct())
-    {
-        auto struct_schema = list_schema.getElementType().asStruct();
-        KJ_IF_MAYBE(field, struct_schema.findFieldByName(nested_name))
-            return checkCapnProtoType(field->getType(), nested_type, mode, error_message, nested_name);
-
-        error_message += "Element type of List {} doesn't contain field with name " + nested_name;
-        return false;
-    }
-
-    return checkCapnProtoType(list_schema.getElementType(), nested_type, mode, error_message, column_name);
-}
-
-static bool checkMapType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message)
-{
-    /// We output/input Map type as follow CapnProto schema
-    ///
-    /// struct Map {
-    ///     struct Entry {
-    ///         key @0: Key;
-    ///         value @1: Value;
-    ///     }
-    ///     entries @0 :List(Entry);
-    /// }
-
-    if (!capnp_type.isStruct())
-        return false;
-    auto struct_schema = capnp_type.asStruct();
-
-    if (checkIfStructContainsUnnamedUnion(struct_schema))
-    {
-        error_message += "CapnProto struct contains unnamed union";
-        return false;
-    }
-
-    if (struct_schema.getFields().size() != 1)
-    {
-        error_message += "CapnProto struct that represents Map type can contain only one field";
-        return false;
-    }
-
-    const auto & field_type = struct_schema.getFields()[0].getType();
-    if (!field_type.isList())
-    {
-        error_message += "Field of CapnProto struct that represents Map is not a list";
-        return false;
-    }
-
-    auto list_element_type = field_type.asList().getElementType();
-    if (!list_element_type.isStruct())
-    {
-        error_message += "Field of CapnProto struct that represents Map is not a list of structs";
-        return false;
-    }
-
-    auto key_value_struct = list_element_type.asStruct();
-    if (checkIfStructContainsUnnamedUnion(key_value_struct))
-    {
-        error_message += "CapnProto struct contains unnamed union";
-        return false;
-    }
-
-    if (key_value_struct.getFields().size() != 2)
-    {
-        error_message += "Key-value structure for Map struct should have exactly 2 fields";
-        return false;
-    }
-
-    const auto & map_type = assert_cast<const DataTypeMap &>(*data_type);
-    DataTypes types = {map_type.getKeyType(), map_type.getValueType()};
-    Names names = {"key", "value"};
-
-    for (size_t i = 0; i != types.size(); ++i)
-    {
-        KJ_IF_MAYBE(field, key_value_struct.findFieldByName(names[i]))
-        {
-            if (!checkCapnProtoType(field->getType(), types[i], mode, error_message, names[i]))
-                return false;
-        }
-        else
-        {
-            error_message += R"(Key-value structure for Map struct should have exactly 2 fields with names "key" and "value")";
-            return false;
-        }
-    }
-
-    return true;
-}
-
-static bool isCapnInteger(const capnp::Type & capnp_type)
-{
-    return capnp_type.isInt8() || capnp_type.isUInt8() || capnp_type.isInt16() || capnp_type.isUInt16() || capnp_type.isInt32()
-        || capnp_type.isUInt32() || capnp_type.isInt64() || capnp_type.isUInt64();
-}
-
-static bool checkCapnProtoType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name)
-{
-    switch (data_type->getTypeId())
-    {
-        case TypeIndex::UInt8:
-            return capnp_type.isBool() || isCapnInteger(capnp_type);
-        case TypeIndex::Int8: [[fallthrough]];
-        case TypeIndex::Int16: [[fallthrough]];
-        case TypeIndex::UInt16: [[fallthrough]];
-        case TypeIndex::Int32: [[fallthrough]];
-        case TypeIndex::UInt32: [[fallthrough]];
-        case TypeIndex::Int64: [[fallthrough]];
-        case TypeIndex::UInt64:
-            /// Allow integer conversions durin input/output.
-            return isCapnInteger(capnp_type);
-        case TypeIndex::Date:
-            return capnp_type.isUInt16();
-        case TypeIndex::DateTime: [[fallthrough]];
-        case TypeIndex::IPv4:
-            return capnp_type.isUInt32();
-        case TypeIndex::Date32: [[fallthrough]];
-        case TypeIndex::Decimal32:
-            return capnp_type.isInt32() || capnp_type.isUInt32();
-        case TypeIndex::DateTime64: [[fallthrough]];
-        case TypeIndex::Decimal64:
-            return capnp_type.isInt64() || capnp_type.isUInt64();
-        case TypeIndex::Float32:[[fallthrough]];
-        case TypeIndex::Float64:
-            /// Allow converting between Float32 and isFloat64
-            return capnp_type.isFloat32() || capnp_type.isFloat64();
-        case TypeIndex::Enum8:
-            return checkEnums<Int8>(capnp_type, data_type, mode, INT8_MAX, error_message);
-        case TypeIndex::Enum16:
-            return checkEnums<Int16>(capnp_type, data_type, mode, INT16_MAX, error_message);
-        case TypeIndex::Int128: [[fallthrough]];
-        case TypeIndex::UInt128: [[fallthrough]];
-        case TypeIndex::Int256: [[fallthrough]];
-        case TypeIndex::UInt256: [[fallthrough]];
-        case TypeIndex::Decimal128: [[fallthrough]];
-        case TypeIndex::Decimal256:
-            return capnp_type.isData();
-        case TypeIndex::Tuple:
-            return checkTupleType(capnp_type, data_type, mode, error_message);
-        case TypeIndex::Nullable:
-        {
-            auto result = checkNullableType(capnp_type, data_type, mode, error_message, column_name);
-            if (!result)
-                error_message += "Nullable can be represented only as a named union of type Void and nested type";
-            return result;
-        }
-        case TypeIndex::Array:
-            return checkArrayType(capnp_type, data_type, mode, error_message, column_name);
-        case TypeIndex::LowCardinality:
-            return checkCapnProtoType(capnp_type, assert_cast<const DataTypeLowCardinality *>(data_type.get())->getDictionaryType(), mode, error_message, column_name);
-        case TypeIndex::FixedString: [[fallthrough]];
-        case TypeIndex::IPv6: [[fallthrough]];
-        case TypeIndex::String:
-            return capnp_type.isText() || capnp_type.isData();
-        case TypeIndex::Map:
-            return checkMapType(capnp_type, data_type, mode, error_message);
-        default:
-            return false;
-    }
-}
-
-capnp::DynamicValue::Reader getReaderByColumnName(const capnp::DynamicStruct::Reader & struct_reader, const String & name)
-{
-    auto [field_name, nested_name] = splitCapnProtoFieldName(name);
-    KJ_IF_MAYBE(field, struct_reader.getSchema().findFieldByName(field_name))
-    {
-        capnp::DynamicValue::Reader field_reader;
-        try
-        {
-            field_reader = struct_reader.get(*field);
-        }
-        catch (const kj::Exception & e)
-        {
-            throw Exception(ErrorCodes::INCORRECT_DATA,
-                            "Cannot extract field value from struct by provided schema, error: "
-                            "{} Perhaps the data was generated by another schema", String(e.getDescription().cStr()));
-        }
-
-        if (nested_name.empty())
-            return field_reader;
-
-        /// Support reading Nested as List of Structs.
-        if (field_reader.getType() == capnp::DynamicValue::LIST)
-        {
-            auto list_schema = field->getType().asList();
-            if (!list_schema.getElementType().isStruct())
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Element type of List {} is not a struct", field_name);
-
-            auto struct_schema = list_schema.getElementType().asStruct();
-            KJ_IF_MAYBE(nested_field, struct_schema.findFieldByName(nested_name))
-                return field_reader;
-
-            throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Element type of List {} doesn't contain field with name \"{}\"", field_name, nested_name);
-        }
-
-        if (field_reader.getType() != capnp::DynamicValue::STRUCT)
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
-
-        return getReaderByColumnName(field_reader.as<capnp::DynamicStruct>(), nested_name);
-    }
-
-    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto struct doesn't contain field with name {}", field_name);
-}
-
-std::pair<capnp::DynamicStruct::Builder, capnp::StructSchema::Field> getStructBuilderAndFieldByColumnName(capnp::DynamicStruct::Builder struct_builder, const String & name)
-{
-    auto [field_name, nested_name] = splitCapnProtoFieldName(name);
-    KJ_IF_MAYBE(field, struct_builder.getSchema().findFieldByName(field_name))
-    {
-        if (nested_name.empty())
-            return {struct_builder, *field};
-
-        auto field_builder = struct_builder.get(*field);
-
-        /// Support reading Nested as List of Structs.
-        if (field_builder.getType() == capnp::DynamicValue::LIST)
-        {
-            auto list_schema = field->getType().asList();
-            if (!list_schema.getElementType().isStruct())
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Element type of List {} is not a struct", field_name);
-
-            auto struct_schema = list_schema.getElementType().asStruct();
-            KJ_IF_MAYBE(nested_field, struct_schema.findFieldByName(nested_name))
-                return {struct_builder, *field};
-
-            throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Element type of List {} doesn't contain field with name \"{}\"", field_name, nested_name);
-        }
-
-        if (field_builder.getType() != capnp::DynamicValue::STRUCT)
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
-
-        return getStructBuilderAndFieldByColumnName(field_builder.as<capnp::DynamicStruct>(), nested_name);
-    }
-
-    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto struct doesn't contain field with name {}", field_name);
-}
-
-static std::pair<capnp::StructSchema::Field, String> getFieldByName(const capnp::StructSchema & schema, const String & name)
-{
-    auto [field_name, nested_name] = splitCapnProtoFieldName(name);
-    KJ_IF_MAYBE(field, schema.findFieldByName(field_name))
-    {
-        if (nested_name.empty())
-            return {*field, name};
-
-        /// Support reading Nested as List of Structs.
-        if (field->getType().isList())
-        {
-            auto list_schema = field->getType().asList();
-            if (!list_schema.getElementType().isStruct())
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Element type of List {} is not a struct", field_name);
-
-            auto struct_schema = list_schema.getElementType().asStruct();
-            KJ_IF_MAYBE(nested_field, struct_schema.findFieldByName(nested_name))
-                return {*field, name};
-
-            throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Element type of List {} doesn't contain field with name \"{}\"", field_name, nested_name);
-        }
-
-        if (!field->getType().isStruct())
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
-
-        return getFieldByName(field->getType().asStruct(), nested_name);
-    }
-
-    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto schema doesn't contain field with name {}", field_name);
-}
-
-void checkCapnProtoSchemaStructure(const capnp::StructSchema & schema, const Block & header, FormatSettings::EnumComparingMode mode)
-{
-    /// Firstly check that struct doesn't contain unnamed union, because we don't support it.
-    if (checkIfStructContainsUnnamedUnion(schema))
-        throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Schema contains unnamed union that is not supported");
-    auto names_and_types = header.getNamesAndTypesList();
-    String additional_error_message;
-    for (auto & [name, type] : names_and_types)
-    {
-        auto [field, field_name] = getFieldByName(schema, name);
-        if (!checkCapnProtoType(field.getType(), type, mode, additional_error_message, field_name))
-        {
-            auto e = Exception(
-                ErrorCodes::CAPN_PROTO_BAD_CAST,
-                "Cannot convert ClickHouse type {} to CapnProto type {}",
-                type->getName(),
-                getCapnProtoFullTypeName(field.getType()));
-            if (!additional_error_message.empty())
-                e.addMessage(additional_error_message);
-            throw std::move(e);
-        }
-    }
-}
-
-template <typename ValueType>
-static DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
-{
-    std::vector<std::pair<String, ValueType>> values;
-    for (auto enumerant : enumerants)
-        values.emplace_back(enumerant.getProto().getName(), ValueType(enumerant.getOrdinal()));
-    return std::make_shared<DataTypeEnum<ValueType>>(std::move(values));
-}
-
-static DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
-{
-    auto enumerants = enum_schema.getEnumerants();
-    if (enumerants.size() < 128)
-        return getEnumDataTypeFromEnumerants<Int8>(enumerants);
-    if (enumerants.size() < 32768)
-        return getEnumDataTypeFromEnumerants<Int16>(enumerants);
-
-    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "ClickHouse supports only 8 and 16-bit Enums");
-}
-
-static DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
-{
-    switch (capnp_type.which())
-    {
-        case capnp::schema::Type::INT8:
-            return std::make_shared<DataTypeInt8>();
-        case capnp::schema::Type::INT16:
-            return std::make_shared<DataTypeInt16>();
-        case capnp::schema::Type::INT32:
-            return std::make_shared<DataTypeInt32>();
-        case capnp::schema::Type::INT64:
-            return std::make_shared<DataTypeInt64>();
-        case capnp::schema::Type::BOOL: [[fallthrough]];
-        case capnp::schema::Type::UINT8:
-            return std::make_shared<DataTypeUInt8>();
-        case capnp::schema::Type::UINT16:
-            return std::make_shared<DataTypeUInt16>();
-        case capnp::schema::Type::UINT32:
-            return std::make_shared<DataTypeUInt32>();
-        case capnp::schema::Type::UINT64:
-            return std::make_shared<DataTypeUInt64>();
-        case capnp::schema::Type::FLOAT32:
-            return std::make_shared<DataTypeFloat32>();
-        case capnp::schema::Type::FLOAT64:
-            return std::make_shared<DataTypeFloat64>();
-        case capnp::schema::Type::DATA: [[fallthrough]];
-        case capnp::schema::Type::TEXT:
-            return std::make_shared<DataTypeString>();
-        case capnp::schema::Type::ENUM:
-            return getEnumDataTypeFromEnumSchema(capnp_type.asEnum());
-        case capnp::schema::Type::LIST:
-        {
-            auto list_schema = capnp_type.asList();
-            auto nested_type = getDataTypeFromCapnProtoType(list_schema.getElementType(), skip_unsupported_fields);
-            if (!nested_type)
-                return nullptr;
-            return std::make_shared<DataTypeArray>(nested_type);
-        }
-        case capnp::schema::Type::STRUCT:
-        {
-            auto struct_schema = capnp_type.asStruct();
-
-
-            if (struct_schema.getFields().size() == 0)
-            {
-                if (skip_unsupported_fields)
-                    return nullptr;
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Empty messages are not supported");
-            }
-
-            /// Check if it can be Nullable.
-            if (checkIfStructIsNamedUnion(struct_schema))
-            {
-                auto fields = struct_schema.getUnionFields();
-                if (fields.size() != 2 || (!fields[0].getType().isVoid() && !fields[1].getType().isVoid()))
-                {
-                    if (skip_unsupported_fields)
-                        return nullptr;
-                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unions are not supported");
-                }
-                auto value_type = fields[0].getType().isVoid() ? fields[1].getType() : fields[0].getType();
-                if (value_type.isStruct() || value_type.isList())
-                {
-                    if (skip_unsupported_fields)
-                        return nullptr;
-                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Tuples and Lists cannot be inside Nullable");
-                }
-
-                auto nested_type = getDataTypeFromCapnProtoType(value_type, skip_unsupported_fields);
-                if (!nested_type)
-                    return nullptr;
-                return std::make_shared<DataTypeNullable>(nested_type);
-            }
-
-            if (checkIfStructContainsUnnamedUnion(struct_schema))
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
-
-            /// Treat Struct as Tuple.
-            DataTypes nested_types;
-            Names nested_names;
-            for (auto field : struct_schema.getNonUnionFields())
-            {
-                auto nested_type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
-                if (!nested_type)
-                    continue;
-                nested_names.push_back(field.getProto().getName());
-                nested_types.push_back(nested_type);
-            }
-            if (nested_types.empty())
-                return nullptr;
-            return std::make_shared<DataTypeTuple>(std::move(nested_types), std::move(nested_names));
-        }
-        default:
-        {
-            if (skip_unsupported_fields)
-                return nullptr;
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unsupported CapnProtoType: {}", getCapnProtoFullTypeName(capnp_type));
-        }
-    }
-}
-
-NamesAndTypesList capnProtoSchemaToCHSchema(const capnp::StructSchema & schema, bool skip_unsupported_fields)
-{
-    if (checkIfStructContainsUnnamedUnion(schema))
-        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
-
-    NamesAndTypesList names_and_types;
-    for (auto field : schema.getNonUnionFields())
-    {
-        auto name = field.getProto().getName();
-        auto type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
-        if (type)
-            names_and_types.emplace_back(name, type);
-    }
-    if (names_and_types.empty())
-        throw Exception(ErrorCodes::BAD_ARGUMENTS,
-                        "Cannot convert CapnProto schema to ClickHouse table schema, all fields have unsupported types");
-
-    return names_and_types;
-}
-
-}
-
-#endif
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index 3a2e818d540..384c6a725dc 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -325,16 +325,16 @@ struct FormatSettings
 
     /// For capnProto format we should determine how to
     /// compare ClickHouse Enum and Enum from schema.
-    enum class EnumComparingMode
+    enum class CapnProtoEnumComparingMode
     {
         BY_NAMES, // Names in enums should be the same, values can be different.
         BY_NAMES_CASE_INSENSITIVE, // Case-insensitive name comparison.
         BY_VALUES, // Values should be the same, names can be different.
     };
 
-    struct
+    struct CapnProto
     {
-        EnumComparingMode enum_comparing_mode = EnumComparingMode::BY_VALUES;
+        CapnProtoEnumComparingMode enum_comparing_mode = CapnProtoEnumComparingMode::BY_VALUES;
         bool skip_fields_with_unsupported_types_in_schema_inference = false;
     } capn_proto;
 
diff --git a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
index 2f84e9bde3c..e686ae86997 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
@@ -9,23 +9,6 @@
 #include <capnp/dynamic.h>
 #include <capnp/common.h>
 
-#include <Columns/ColumnsNumber.h>
-#include <Columns/ColumnArray.h>
-#include <Columns/ColumnTuple.h>
-#include <Columns/ColumnFixedString.h>
-#include <Columns/ColumnLowCardinality.h>
-#include <Columns/ColumnNullable.h>
-#include <Columns/ColumnDecimal.h>
-#include <Columns/ColumnMap.h>
-
-#include <DataTypes/DataTypeEnum.h>
-#include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeNullable.h>
-#include <DataTypes/DataTypesNumber.h>
-#include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypeLowCardinality.h>
-#include <DataTypes/DataTypeMap.h>
-
 namespace DB
 {
 
@@ -35,16 +18,14 @@ namespace ErrorCodes
     extern const int INCORRECT_DATA;
 }
 
-CapnProtoRowInputFormat::CapnProtoRowInputFormat(ReadBuffer & in_, Block header, Params params_, const FormatSchemaInfo & info, const FormatSettings & format_settings_)
-    : IRowInputFormat(std::move(header), in_, std::move(params_))
+CapnProtoRowInputFormat::CapnProtoRowInputFormat(ReadBuffer & in_, Block header_, Params params_, const FormatSchemaInfo & info, const FormatSettings & format_settings)
+    : IRowInputFormat(std::move(header_), in_, std::move(params_))
     , parser(std::make_shared<CapnProtoSchemaParser>())
-    , format_settings(format_settings_)
-    , column_types(getPort().getHeader().getDataTypes())
-    , column_names(getPort().getHeader().getNames())
 {
     // Parse the schema and fetch the root object
-    root = parser->getMessageSchema(info);
-    checkCapnProtoSchemaStructure(root, getPort().getHeader(), format_settings.capn_proto.enum_comparing_mode);
+    schema = parser->getMessageSchema(info);
+    const auto & header = getPort().getHeader();
+    serializer = std::make_unique<CapnProtoSerializer>(header.getDataTypes(), header.getNames(), schema, format_settings.capn_proto);
 }
 
 kj::Array<capnp::word> CapnProtoRowInputFormat::readMessage()
@@ -82,213 +63,6 @@ kj::Array<capnp::word> CapnProtoRowInputFormat::readMessage()
     return msg;
 }
 
-static void insertInteger(IColumn & column, const DataTypePtr & column_type, UInt64 value)
-{
-    switch (column_type->getTypeId())
-    {
-        case TypeIndex::Int8:
-            assert_cast<ColumnInt8 &>(column).insertValue(value);
-            break;
-        case TypeIndex::UInt8:
-            assert_cast<ColumnUInt8 &>(column).insertValue(value);
-            break;
-        case TypeIndex::Int16:
-            assert_cast<ColumnInt16 &>(column).insertValue(value);
-            break;
-        case TypeIndex::Date: [[fallthrough]];
-        case TypeIndex::UInt16:
-            assert_cast<ColumnUInt16 &>(column).insertValue(value);
-            break;
-        case TypeIndex::Int32:
-            assert_cast<ColumnInt32 &>(column).insertValue(static_cast<Int32>(value));
-            break;
-        case TypeIndex::DateTime: [[fallthrough]];
-        case TypeIndex::UInt32:
-            assert_cast<ColumnUInt32 &>(column).insertValue(static_cast<UInt32>(value));
-            break;
-        case TypeIndex::IPv4:
-            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(static_cast<UInt32>(value)));
-            break;
-        case TypeIndex::Int64:
-            assert_cast<ColumnInt64 &>(column).insertValue(value);
-            break;
-        case TypeIndex::UInt64:
-            assert_cast<ColumnUInt64 &>(column).insertValue(value);
-            break;
-        case TypeIndex::DateTime64:
-            assert_cast<ColumnDecimal<DateTime64> &>(column).insertValue(value);
-            break;
-        case TypeIndex::Decimal32:
-            assert_cast<ColumnDecimal<Decimal32> &>(column).insertValue(static_cast<Int32>(value));
-            break;
-        case TypeIndex::Decimal64:
-            assert_cast<ColumnDecimal<Decimal64> &>(column).insertValue(value);
-            break;
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Column type {} cannot be parsed from integer", column_type->getName());
-    }
-}
-
-static void insertFloat(IColumn & column, const DataTypePtr & column_type, Float64 value)
-{
-    switch (column_type->getTypeId())
-    {
-        case TypeIndex::Float32:
-            assert_cast<ColumnFloat32 &>(column).insertValue(static_cast<Float32>(value));
-            break;
-        case TypeIndex::Float64:
-            assert_cast<ColumnFloat64 &>(column).insertValue(value);
-            break;
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Column type is not a float.");
-    }
-}
-
-template <typename Value>
-static void insertData(IColumn & column, const DataTypePtr & column_type, Value value)
-{
-    if (column_type->haveMaximumSizeOfValue() && value.size() != column_type->getSizeOfValueInMemory())
-        throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", column_type->getName(), value.size());
-
-    column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-}
-
-template <typename ValueType>
-static void insertEnum(IColumn & column, const DataTypePtr & column_type, const capnp::DynamicEnum & enum_value, FormatSettings::EnumComparingMode enum_comparing_mode)
-{
-    auto enumerant = *kj::_::readMaybe(enum_value.getEnumerant());
-    auto enum_type = assert_cast<const DataTypeEnum<ValueType> *>(column_type.get());
-    DataTypePtr nested_type = std::make_shared<DataTypeNumber<ValueType>>();
-    switch (enum_comparing_mode)
-    {
-        case FormatSettings::EnumComparingMode::BY_VALUES:
-            insertInteger(column, nested_type, Int64(enumerant.getOrdinal()));
-            return;
-        case FormatSettings::EnumComparingMode::BY_NAMES:
-            insertInteger(column, nested_type, Int64(enum_type->getValue(String(enumerant.getProto().getName()))));
-            return;
-        case FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE:
-        {
-            /// Find the same enum name case insensitive.
-            String enum_name = enumerant.getProto().getName();
-            for (auto & name : enum_type->getAllRegisteredNames())
-            {
-                if (compareEnumNames(name, enum_name, enum_comparing_mode))
-                {
-                    insertInteger(column, nested_type, Int64(enum_type->getValue(name)));
-                    break;
-                }
-            }
-        }
-    }
-}
-
-static void insertValue(IColumn & column, const DataTypePtr & column_type, const String & column_name, const capnp::DynamicValue::Reader & value, FormatSettings::EnumComparingMode enum_comparing_mode)
-{
-    if (column_type->lowCardinality())
-    {
-        auto & lc_column = assert_cast<ColumnLowCardinality &>(column);
-        auto tmp_column = lc_column.getDictionary().getNestedColumn()->cloneEmpty();
-        auto dict_type = assert_cast<const DataTypeLowCardinality *>(column_type.get())->getDictionaryType();
-        insertValue(*tmp_column, dict_type, column_name, value, enum_comparing_mode);
-        lc_column.insertFromFullColumn(*tmp_column, 0);
-        return;
-    }
-
-    switch (value.getType())
-    {
-        case capnp::DynamicValue::Type::INT:
-            insertInteger(column, column_type, value.as<Int64>());
-            break;
-        case capnp::DynamicValue::Type::UINT:
-            insertInteger(column, column_type, value.as<UInt64>());
-            break;
-        case capnp::DynamicValue::Type::FLOAT:
-            insertFloat(column, column_type, value.as<Float64>());
-            break;
-        case capnp::DynamicValue::Type::BOOL:
-            insertInteger(column, column_type, UInt64(value.as<bool>()));
-            break;
-        case capnp::DynamicValue::Type::DATA:
-            insertData(column, column_type, value.as<capnp::Data>());
-            break;
-        case capnp::DynamicValue::Type::TEXT:
-            insertData(column, column_type, value.as<capnp::Text>());
-            break;
-        case capnp::DynamicValue::Type::ENUM:
-            if (column_type->getTypeId() == TypeIndex::Enum8)
-                insertEnum<Int8>(column, column_type, value.as<capnp::DynamicEnum>(), enum_comparing_mode);
-            else
-                insertEnum<Int16>(column, column_type, value.as<capnp::DynamicEnum>(), enum_comparing_mode);
-            break;
-        case capnp::DynamicValue::LIST:
-        {
-            auto list_value = value.as<capnp::DynamicList>();
-            auto & column_array = assert_cast<ColumnArray &>(column);
-            auto & offsets = column_array.getOffsets();
-            offsets.push_back(offsets.back() + list_value.size());
-
-            auto & nested_column = column_array.getData();
-            auto nested_type = assert_cast<const DataTypeArray *>(column_type.get())->getNestedType();
-            for (const auto & nested_value : list_value)
-                insertValue(nested_column, nested_type, column_name, nested_value, enum_comparing_mode);
-            break;
-        }
-        case capnp::DynamicValue::Type::STRUCT:
-        {
-            auto struct_value = value.as<capnp::DynamicStruct>();
-            if (column_type->isNullable())
-            {
-                auto & nullable_column = assert_cast<ColumnNullable &>(column);
-                auto field = *kj::_::readMaybe(struct_value.which());
-                if (field.getType().isVoid())
-                    nullable_column.insertDefault();
-                else
-                {
-                    auto & nested_column = nullable_column.getNestedColumn();
-                    auto nested_type = assert_cast<const DataTypeNullable *>(column_type.get())->getNestedType();
-                    auto nested_value = struct_value.get(field);
-                    insertValue(nested_column, nested_type, column_name, nested_value, enum_comparing_mode);
-                    nullable_column.getNullMapData().push_back(0);
-                }
-            }
-            else if (isTuple(column_type))
-            {
-                auto & tuple_column = assert_cast<ColumnTuple &>(column);
-                const auto * tuple_type = assert_cast<const DataTypeTuple *>(column_type.get());
-                bool have_explicit_names = tuple_type->haveExplicitNames();
-                auto struct_schema = struct_value.getSchema();
-                for (uint32_t i = 0; i != tuple_column.tupleSize(); ++i)
-                    insertValue(
-                        tuple_column.getColumn(i),
-                        tuple_type->getElements()[i],
-                        tuple_type->getElementNames()[i],
-                        struct_value.get(have_explicit_names ? struct_schema.getFieldByName(tuple_type->getElementNames()[i]) : struct_schema.getFields()[i]),
-                        enum_comparing_mode);
-            }
-            else if (isMap(column_type))
-            {
-                const auto & map_type = assert_cast<const DataTypeMap &>(*column_type);
-                DataTypes key_value_types = {map_type.getKeyType(), map_type.getValueType()};
-                Names key_value_names = {"key", "value"};
-                auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(key_value_types, key_value_names));
-                auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
-                auto entries_field = struct_value.getSchema().getFields()[0];
-                insertValue(entries_column, entries_type, column_name, struct_value.get(entries_field), enum_comparing_mode);
-            }
-            else
-            {
-                /// It can be nested column from Nested type.
-                auto [field_name, nested_name] = splitCapnProtoFieldName(column_name);
-                insertValue(column, column_type, nested_name, struct_value.get(nested_name), enum_comparing_mode);
-            }
-            break;
-        }
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected CapnProto value type.");
-    }
-}
-
 bool CapnProtoRowInputFormat::readRow(MutableColumns & columns, RowReadExtension &)
 {
     if (in->eof())
@@ -298,12 +72,8 @@ bool CapnProtoRowInputFormat::readRow(MutableColumns & columns, RowReadExtension
     {
         auto array = readMessage();
         capnp::FlatArrayMessageReader msg(array);
-        auto root_reader = msg.getRoot<capnp::DynamicStruct>(root);
-        for (size_t i = 0; i != columns.size(); ++i)
-        {
-            auto value = getReaderByColumnName(root_reader, column_names[i]);
-            insertValue(*columns[i], column_types[i], column_names[i], value, format_settings.capn_proto.enum_comparing_mode);
-        }
+        auto root_reader = msg.getRoot<capnp::DynamicStruct>(schema);
+        serializer->readRow(columns, root_reader);
     }
     catch (const kj::Exception & e)
     {
@@ -343,7 +113,14 @@ void registerInputFormatCapnProto(FormatFactory & factory)
     factory.markFormatSupportsSubsetOfColumns("CapnProto");
     factory.registerFileExtension("capnp", "CapnProto");
     factory.registerAdditionalInfoForSchemaCacheGetter(
-        "CapnProto", [](const FormatSettings & settings) { return fmt::format("format_schema={}", settings.schema.format_schema); });
+        "CapnProto",
+        [](const FormatSettings & settings)
+        {
+            return fmt::format(
+                "format_schema={}, skip_fields_with_unsupported_types_in_schema_inference={}",
+                settings.schema.format_schema,
+                settings.capn_proto.skip_fields_with_unsupported_types_in_schema_inference);
+        });
 }
 
 void registerCapnProtoSchemaReader(FormatFactory & factory)
diff --git a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h
index cf23f22b643..06e94da123f 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h
+++ b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h
@@ -4,7 +4,8 @@
 #if USE_CAPNP
 
 #include <Core/Block.h>
-#include <Formats/CapnProtoUtils.h>
+#include <Formats/CapnProtoSchema.h>
+#include <Formats/CapnProtoSerializer.h>
 #include <Processors/Formats/IRowInputFormat.h>
 #include <Processors/Formats/ISchemaReader.h>
 
@@ -33,10 +34,8 @@ private:
     kj::Array<capnp::word> readMessage();
 
     std::shared_ptr<CapnProtoSchemaParser> parser;
-    capnp::StructSchema root;
-    const FormatSettings format_settings;
-    DataTypes column_types;
-    Names column_names;
+    capnp::StructSchema schema;
+    std::unique_ptr<CapnProtoSerializer> serializer;
 };
 
 class CapnProtoSchemaReader : public IExternalSchemaReader
diff --git a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
index 0225680b396..7dd18be27f4 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
@@ -1,28 +1,13 @@
 #include <Processors/Formats/Impl/CapnProtoRowOutputFormat.h>
 #if USE_CAPNP
 
-#include <Formats/CapnProtoUtils.h>
+#include <Formats/CapnProtoSchema.h>
 #include <Formats/FormatSettings.h>
+#include <Formats/CapnProtoSerializer.h>
 #include <IO/WriteBuffer.h>
 #include <capnp/dynamic.h>
 #include <capnp/serialize-packed.h>
 
-#include <Columns/ColumnArray.h>
-#include <Columns/ColumnNullable.h>
-#include <Columns/ColumnString.h>
-#include <Columns/ColumnFixedString.h>
-#include <Columns/ColumnTuple.h>
-#include <Columns/ColumnLowCardinality.h>
-#include <Columns/ColumnDecimal.h>
-#include <Columns/ColumnMap.h>
-
-#include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeEnum.h>
-#include <DataTypes/DataTypeNullable.h>
-#include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypeLowCardinality.h>
-#include <DataTypes/DataTypeMap.h>
-
 namespace DB
 {
 
@@ -45,252 +30,25 @@ CapnProtoRowOutputFormat::CapnProtoRowOutputFormat(
     WriteBuffer & out_,
     const Block & header_,
     const FormatSchemaInfo & info,
-    const FormatSettings & format_settings_)
-    : IRowOutputFormat(header_, out_), column_names(header_.getNames()), column_types(header_.getDataTypes()), output_stream(std::make_unique<CapnProtoOutputStream>(out_)), format_settings(format_settings_)
+    const FormatSettings & format_settings)
+    : IRowOutputFormat(header_, out_)
+    , column_names(header_.getNames())
+    , column_types(header_.getDataTypes())
+    , output_stream(std::make_unique<CapnProtoOutputStream>(out_))
 {
     schema = schema_parser.getMessageSchema(info);
-    checkCapnProtoSchemaStructure(schema, getPort(PortKind::Main).getHeader(), format_settings.capn_proto.enum_comparing_mode);
-}
-
-template <typename EnumValue>
-static capnp::DynamicEnum getDynamicEnum(
-    const ColumnPtr & column,
-    const DataTypePtr & data_type,
-    size_t row_num,
-    const capnp::EnumSchema & enum_schema,
-    FormatSettings::EnumComparingMode mode)
-{
-    const auto * enum_data_type = assert_cast<const DataTypeEnum<EnumValue> *>(data_type.get());
-    EnumValue enum_value = column->getInt(row_num);
-    if (mode == FormatSettings::EnumComparingMode::BY_VALUES)
-        return capnp::DynamicEnum(enum_schema, enum_value);
-
-    auto enum_name = enum_data_type->getNameForValue(enum_value);
-    for (const auto enumerant : enum_schema.getEnumerants())
-    {
-        if (compareEnumNames(String(enum_name), enumerant.getProto().getName(), mode))
-            return capnp::DynamicEnum(enumerant);
-    }
-
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert CLickHouse Enum value to CapnProto Enum");
-}
-
-static capnp::DynamicValue::Builder initStructFieldBuilder(const ColumnPtr & column, size_t row_num, capnp::DynamicStruct::Builder & struct_builder, capnp::StructSchema::Field field)
-{
-    if (const auto * array_column = checkAndGetColumn<ColumnArray>(*column))
-    {
-        size_t size = array_column->getOffsets()[row_num] - array_column->getOffsets()[row_num - 1];
-        return struct_builder.init(field, static_cast<unsigned>(size));
-    }
-
-    if (field.getType().isStruct())
-        return struct_builder.init(field);
-
-    return struct_builder.get(field);
-}
-
-static std::optional<capnp::DynamicValue::Reader> convertToDynamicValue(
-    const ColumnPtr & column,
-    const DataTypePtr & data_type,
-    size_t row_num,
-    const String & column_name,
-    capnp::DynamicValue::Builder builder,
-    FormatSettings::EnumComparingMode enum_comparing_mode,
-    std::vector<std::unique_ptr<String>> & temporary_text_data_storage)
-{
-    /// Here we don't do any types validation, because we did it in CapnProtoRowOutputFormat constructor.
-
-    if (data_type->lowCardinality())
-    {
-        const auto * lc_column = assert_cast<const ColumnLowCardinality *>(column.get());
-        const auto & dict_type = assert_cast<const DataTypeLowCardinality *>(data_type.get())->getDictionaryType();
-        size_t index = lc_column->getIndexAt(row_num);
-        return convertToDynamicValue(lc_column->getDictionary().getNestedColumn(), dict_type, index, column_name, builder, enum_comparing_mode, temporary_text_data_storage);
-    }
-
-    switch (builder.getType())
-    {
-        case capnp::DynamicValue::Type::INT:
-            return capnp::DynamicValue::Reader(column->getInt(row_num));
-        case capnp::DynamicValue::Type::UINT:
-        {
-            /// IPv4 column doesn't support getUInt method.
-            if (isIPv4(data_type))
-                return capnp::DynamicValue::Reader(assert_cast<const ColumnIPv4 *>(column.get())->getElement(row_num));
-            return capnp::DynamicValue::Reader(column->getUInt(row_num));
-        }
-        case capnp::DynamicValue::Type::BOOL:
-            return capnp::DynamicValue::Reader(column->getBool(row_num));
-        case capnp::DynamicValue::Type::FLOAT:
-            return capnp::DynamicValue::Reader(column->getFloat64(row_num));
-        case capnp::DynamicValue::Type::ENUM:
-        {
-            auto enum_schema = builder.as<capnp::DynamicEnum>().getSchema();
-            if (data_type->getTypeId() == TypeIndex::Enum8)
-                return capnp::DynamicValue::Reader(
-                    getDynamicEnum<Int8>(column, data_type, row_num, enum_schema, enum_comparing_mode));
-            return capnp::DynamicValue::Reader(
-                    getDynamicEnum<Int16>(column, data_type, row_num, enum_schema, enum_comparing_mode));
-        }
-        case capnp::DynamicValue::Type::DATA:
-        {
-            auto data = column->getDataAt(row_num);
-            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
-        }
-        case capnp::DynamicValue::Type::TEXT:
-        {
-            /// In TEXT type data should be null-terminated, but ClickHouse String data could not be.
-            /// To make data null-terminated we should copy it to temporary String object, but
-            /// capnp::Text::Reader works only with pointer to the data and it's size, so we should
-            /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
-            /// To do this we store new String object in a temporary storage, passed in this function
-            /// by reference. We use unique_ptr<String> instead of just String to avoid pointers
-            /// invalidation on vector reallocation.
-            temporary_text_data_storage.push_back(std::make_unique<String>(column->getDataAt(row_num)));
-            auto & data = temporary_text_data_storage.back();
-            return capnp::DynamicValue::Reader(capnp::Text::Reader(data->data(), data->size()));
-        }
-        case capnp::DynamicValue::Type::STRUCT:
-        {
-            auto struct_builder = builder.as<capnp::DynamicStruct>();
-            auto nested_struct_schema = struct_builder.getSchema();
-            /// Struct can represent Tuple, Nullable (named union with two fields) or single column when it contains one nested column.
-            if (data_type->isNullable())
-            {
-                const auto * nullable_type = assert_cast<const DataTypeNullable *>(data_type.get());
-                const auto * nullable_column = assert_cast<const ColumnNullable *>(column.get());
-                auto fields = nested_struct_schema.getUnionFields();
-                if (nullable_column->isNullAt(row_num))
-                {
-                    auto null_field = fields[0].getType().isVoid() ? fields[0] : fields[1];
-                    struct_builder.set(null_field, capnp::Void());
-                }
-                else
-                {
-                    auto value_field = fields[0].getType().isVoid() ? fields[1] : fields[0];
-                    struct_builder.clear(value_field);
-                    const auto & nested_column = nullable_column->getNestedColumnPtr();
-                    auto value_builder = initStructFieldBuilder(nested_column, row_num, struct_builder, value_field);
-                    auto value = convertToDynamicValue(nested_column, nullable_type->getNestedType(), row_num, column_name, value_builder, enum_comparing_mode, temporary_text_data_storage);
-                    if (value)
-                        struct_builder.set(value_field, *value);
-                }
-            }
-            else if (isTuple(data_type))
-            {
-                const auto * tuple_data_type = assert_cast<const DataTypeTuple *>(data_type.get());
-                const auto & nested_types = tuple_data_type->getElements();
-                const auto & nested_names = tuple_data_type->getElementNames();
-                const auto & nested_columns = assert_cast<const ColumnTuple *>(column.get())->getColumns();
-                bool have_explicit_names = tuple_data_type->haveExplicitNames();
-                for (uint32_t i = 0; i != nested_names.size(); ++i)
-                {
-                    capnp::StructSchema::Field nested_field = have_explicit_names ? nested_struct_schema.getFieldByName(nested_names[i]) : nested_struct_schema.getFields()[i];
-                    auto field_builder = initStructFieldBuilder(nested_columns[i], row_num, struct_builder, nested_field);
-                    auto value = convertToDynamicValue(nested_columns[i], nested_types[i], row_num, nested_names[i], field_builder, enum_comparing_mode, temporary_text_data_storage);
-                    if (value)
-                        struct_builder.set(nested_field, *value);
-                }
-            }
-            else if (isMap(data_type))
-            {
-                /// We output Map type as follow CapnProto schema
-                ///
-                /// struct Map {
-                ///     struct Entry {
-                ///         key @0: Key;
-                ///         value @1: Value;
-                ///     }
-                ///     entries @0 :List(Entry);
-                /// }
-                ///
-                /// And we don't need to check that struct have this form here because we checked it before.
-                const auto & map_type = assert_cast<const DataTypeMap &>(*data_type);
-                DataTypes key_value_types = {map_type.getKeyType(), map_type.getValueType()};
-                Names key_value_names = {"key", "value"};
-                auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(key_value_types, key_value_names));
-
-                /// Nested column in Map is actually Array(Tuple), so we can output it according to "entries" field schema.
-                const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
-
-                auto entries_field = nested_struct_schema.getFields()[0];
-                auto field_builder = initStructFieldBuilder(entries_column, row_num, struct_builder, entries_field);
-                auto entries_value = convertToDynamicValue(entries_column, entries_type, row_num, column_name, field_builder, enum_comparing_mode, temporary_text_data_storage);
-                if (entries_value)
-                    struct_builder.set(entries_field, *entries_value);
-            }
-            else
-            {
-                /// It can be nested column from Nested type.
-                auto [field_name, nested_name] = splitCapnProtoFieldName(column_name);
-                auto nested_field = nested_struct_schema.getFieldByName(nested_name);
-                auto field_builder = initStructFieldBuilder(column, row_num, struct_builder, nested_field);
-                auto value = convertToDynamicValue(column, data_type, row_num, nested_name, field_builder, enum_comparing_mode, temporary_text_data_storage);
-                if (value)
-                    struct_builder.set(nested_field, *value);
-            }
-            return std::nullopt;
-        }
-        case capnp::DynamicValue::Type::LIST:
-        {
-            auto list_builder = builder.as<capnp::DynamicList>();
-            const auto * array_column = assert_cast<const ColumnArray *>(column.get());
-            const auto & nested_column = array_column->getDataPtr();
-            const auto & nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
-            const auto & offsets = array_column->getOffsets();
-            auto offset = offsets[row_num - 1];
-            size_t size = offsets[row_num] - offset;
-
-            const auto * nested_array_column = checkAndGetColumn<ColumnArray>(*nested_column);
-            for (unsigned i = 0; i != static_cast<unsigned>(size); ++i)
-            {
-                capnp::DynamicValue::Builder value_builder;
-                /// For nested arrays we need to initialize nested list builder.
-                if (nested_array_column)
-                {
-                    const auto & nested_offset = nested_array_column->getOffsets();
-                    size_t nested_array_size = nested_offset[offset + i] - nested_offset[offset + i - 1];
-                    value_builder = list_builder.init(i, static_cast<unsigned>(nested_array_size));
-                }
-                else
-                    value_builder = list_builder[i];
-
-                auto value = convertToDynamicValue(nested_column, nested_type, offset + i, column_name, value_builder, enum_comparing_mode, temporary_text_data_storage);
-                if (value)
-                    list_builder.set(i, *value);
-            }
-            return std::nullopt;
-        }
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected CapnProto type.");
-    }
+    const auto & header = getPort(PortKind::Main).getHeader();
+    serializer = std::make_unique<CapnProtoSerializer>(header.getDataTypes(), header.getNames(), schema, format_settings.capn_proto);
+    capnp::MallocMessageBuilder message;
 }
 
 void CapnProtoRowOutputFormat::write(const Columns & columns, size_t row_num)
 {
     capnp::MallocMessageBuilder message;
-    /// Temporary storage for data that will be outputted in fields with CapnProto type TEXT.
-    /// See comment in convertToDynamicValue() for more details.
-    std::vector<std::unique_ptr<String>> temporary_text_data_storage;
     capnp::DynamicStruct::Builder root = message.initRoot<capnp::DynamicStruct>(schema);
-
-    /// Some columns can share same field builder. For example when we have
-    /// column with Nested type that was flattened into several columns.
-    std::unordered_map<size_t, capnp::DynamicValue::Builder> field_builders;
-    for (size_t i = 0; i != columns.size(); ++i)
-    {
-        auto [struct_builder, field] = getStructBuilderAndFieldByColumnName(root, column_names[i]);
-        if (!field_builders.contains(field.getIndex()))
-        {
-            auto field_builder = initStructFieldBuilder(columns[i], row_num, struct_builder, field);
-            field_builders[field.getIndex()] = field_builder;
-        }
-        auto value = convertToDynamicValue(columns[i], column_types[i], row_num, column_names[i], field_builders[field.getIndex()], format_settings.capn_proto.enum_comparing_mode, temporary_text_data_storage);
-        if (value)
-            struct_builder.set(field, *value);
-    }
-
+    serializer->writeRow(columns, std::move(root), row_num);
     capnp::writeMessage(*output_stream, message);
+
 }
 
 void registerOutputFormatCapnProto(FormatFactory & factory)
diff --git a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h
index 5cc7099d4c7..dd9dcc6b340 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h
+++ b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h
@@ -3,15 +3,17 @@
 #include "config.h"
 #if USE_CAPNP
 
-#include <Processors/Formats/IRowOutputFormat.h>
-#include <Formats/FormatSchemaInfo.h>
-#include <Formats/CapnProtoUtils.h>
-#include <capnp/schema.h>
-#include <capnp/dynamic.h>
-#include <kj/io.h>
+#    include <Formats/CapnProtoSchema.h>
+#    include <Formats/CapnProtoSerializer.h>
+#    include <Formats/FormatSchemaInfo.h>
+#    include <Processors/Formats/IRowOutputFormat.h>
+#    include <capnp/dynamic.h>
+#    include <capnp/schema.h>
+#    include <kj/io.h>
 
 namespace DB
 {
+
 class CapnProtoOutputStream : public kj::OutputStream
 {
 public:
@@ -43,8 +45,9 @@ private:
     DataTypes column_types;
     capnp::StructSchema schema;
     std::unique_ptr<CapnProtoOutputStream> output_stream;
-    const FormatSettings format_settings;
     CapnProtoSchemaParser schema_parser;
+    std::unique_ptr<CapnProtoSerializer> serializer;
+
 };
 
 }
diff --git a/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp b/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp
index 9777f2361a2..6098923a195 100644
--- a/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp
@@ -88,7 +88,14 @@ void registerInputFormatProtobufList(FormatFactory & factory)
             });
     factory.markFormatSupportsSubsetOfColumns("ProtobufList");
     factory.registerAdditionalInfoForSchemaCacheGetter(
-        "ProtobufList", [](const FormatSettings & settings) { return fmt::format("format_schema={}", settings.schema.format_schema); });
+        "ProtobufList",
+        [](const FormatSettings & settings)
+        {
+            return fmt::format(
+                "format_schema={}, skip_fields_with_unsupported_types_in_schema_inference={}",
+                settings.schema.format_schema,
+                settings.protobuf.skip_fields_with_unsupported_types_in_schema_inference);
+        });
 }
 
 void registerProtobufListSchemaReader(FormatFactory & factory)
diff --git a/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp b/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp
index ee60501dba5..126f3673571 100644
--- a/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp
@@ -128,7 +128,14 @@ void registerProtobufSchemaReader(FormatFactory & factory)
 
     for (const auto & name : {"Protobuf", "ProtobufSingle"})
         factory.registerAdditionalInfoForSchemaCacheGetter(
-            name, [](const FormatSettings & settings) { return fmt::format("format_schema={}", settings.schema.format_schema); });
+            name,
+            [](const FormatSettings & settings)
+            {
+                return fmt::format(
+                    "format_schema={}, skip_fields_with_unsupported_types_in_schema_inference={}",
+                    settings.schema.format_schema,
+                    settings.protobuf.skip_fields_with_unsupported_types_in_schema_inference);
+            });
 }
 
 }
diff --git a/tests/queries/0_stateless/02030_capnp_format.sh b/tests/queries/0_stateless/02030_capnp_format.sh
index c15d6fe442e..625104fb590 100755
--- a/tests/queries/0_stateless/02030_capnp_format.sh
+++ b/tests/queries/0_stateless/02030_capnp_format.sh
@@ -96,8 +96,8 @@ $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a_b U
 
 $CLICKHOUSE_CLIENT --query="SELECT number AS a_b, number + 1 AS a_c_d, number + 2 AS a_c_e_f FROM numbers(5) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_nested_tuples:Message'" > $CAPN_PROTO_FILE
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(b UInt64, c Tuple(d UInt64, e Tuple(f UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'"
-$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(bb UInt64, c Tuple(d UInt64, e Tuple(f UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
-$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(b UInt64, c Tuple(d UInt64, e Tuple(ff UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(bb UInt64, c Tuple(d UInt64, e Tuple(f UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "THERE_IS_NO_COLUMN" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(b UInt64, c Tuple(d UInt64, e Tuple(ff UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "THERE_IS_NO_COLUMN" && echo 'OK' || echo 'FAIL';
 
 
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'string String') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_simple_types:Message'" 2>&1 | grep -F -q "INCORRECT_DATA" && echo 'OK' || echo 'FAIL';
diff --git a/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
new file mode 100644
index 00000000000..f34c857e2f6
--- /dev/null
+++ b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
@@ -0,0 +1 @@
+42	(42,42)
diff --git a/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
new file mode 100755
index 00000000000..c3835948437
--- /dev/null
+++ b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest, no-parallel, no-replicated-database
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+SCHEMADIR=$CURDIR/format_schemas
+$CLICKHOUSE_LOCAL -q "select 42 as Field1, (42, 42)::Tuple(Field1 UInt32, Field2 UInt32) as Nested format CapnProto settings format_schema='$SCHEMADIR/02735_case_insensitive_names_matching:Message'" | $CLICKHOUSE_LOCAL --input-format CapnProto --structure "Field1 UInt32, Nested Tuple(Field1 UInt32, Field2 UInt32)" -q "select * from table" --format_schema="$SCHEMADIR/02735_case_insensitive_names_matching:Message"
+
diff --git a/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference
new file mode 100644
index 00000000000..b6e6d485929
--- /dev/null
+++ b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference
@@ -0,0 +1,3 @@
+(42,(42,42),[(42,42),(24,24)])	[(42,(42,42),[(42,42),(24,24)]),(24,(24,24),[(24,24),(42,42)])]
+42	42	42
+[42,24]	[42,24]	[42,24]	[[42,24],[24,42]]	[[42,24],[24,42]]
diff --git a/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh
new file mode 100755
index 00000000000..c669be2ed33
--- /dev/null
+++ b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest, no-parallel, no-replicated-database
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+SCHEMADIR=$CURDIR/format_schemas
+DATA_FILE=02736_$CLICKHOUSE_TEST_UNIQUE_NAME.bin
+
+$CLICKHOUSE_LOCAL -q "select tuple(42, tuple(42, 42), [tuple(42, 42), tuple(24, 24)]) as nested, [tuple(42, tuple(42, 42), [tuple(42, 42), tuple(24, 24)]), tuple(24, tuple(24, 24), [tuple(24, 24), tuple(42, 42)])] as nestedList format CapnProto settings format_schema='$SCHEMADIR/02736_nested_structures:Message'" > $DATA_FILE
+
+$CLICKHOUSE_LOCAL -q "select * from file($DATA_FILE, CapnProto) settings format_schema='$SCHEMADIR/02736_nested_structures:Message'"
+
+$CLICKHOUSE_LOCAL -q "select 42 as nested_field1, 42 as nested_nested_field1, 42 as nested_nested_field2 format CapnProto settings format_schema='$SCHEMADIR/02736_nested_structures:Message'" > $DATA_FILE
+
+$CLICKHOUSE_LOCAL -q "select * from file($DATA_FILE, CapnProto, 'nested_field1 UInt32, nested_nested_field1 UInt32, nested_nested_field2 UInt32') settings format_schema='$SCHEMADIR/02736_nested_structures:Message'"
+
+$CLICKHOUSE_LOCAL -q "select [42, 24] as nestedList_field1, [42, 24] as nestedList_nested_field1, [42, 24] as nestedList_nested_field2, [[42, 24], [24, 42]] as nestedList_nestedList_field1, [[42, 24], [24, 42]] as nestedList_nestedList_field2 format CapnProto settings format_schema='$SCHEMADIR/02736_nested_structures:Message'" > $DATA_FILE
+
+$CLICKHOUSE_LOCAL -q "select * from file($DATA_FILE, CapnProto, 'nestedList_field1 Array(UInt32), nestedList_nested_field1 Array(UInt32), nestedList_nested_field2 Array(UInt32), nestedList_nestedList_field1 Array(Array(UInt32)), nestedList_nestedList_field2 Array(Array(UInt32))') settings format_schema='$SCHEMADIR/02736_nested_structures:Message'"
+
+rm $DATA_FILE
+
diff --git a/tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp b/tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp
new file mode 100644
index 00000000000..6b12aab081a
--- /dev/null
+++ b/tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp
@@ -0,0 +1,13 @@
+@0x9ef128e10a8010b8;
+
+struct Nested
+{
+    field1 @0 : UInt32;
+    field2 @1 : UInt32;
+}
+
+struct Message
+{
+    field1 @0 : UInt32;
+    nested @1 : Nested;
+}
diff --git a/tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp b/tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp
new file mode 100644
index 00000000000..a03eb27f383
--- /dev/null
+++ b/tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp
@@ -0,0 +1,21 @@
+@0x9ef128e10a8010b8;
+
+struct Nested2
+{
+    field1 @0 : UInt32;
+    field2 @1 : UInt32;
+}
+
+struct Nested
+{
+    field1 @0 : UInt32;
+    nested @1 : Nested2;
+    nestedList @2 : List(Nested2);
+}
+
+struct Message
+{
+    nested @0 : Nested;
+    nestedList @1 : List(Nested);
+}
+

From 167516b6b088dea2e6b44a6e81caf2c088f2481e Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 10 May 2023 21:07:56 +0200
Subject: [PATCH 084/722] Fix style

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index e0c8ae2a79a..c31623286d0 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -26,7 +26,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int THERE_IS_NO_COLUMN;
-    extern const int BAD_TYPE_OF_FIELD;
+    extern const int LOGICAL_ERROR;
     extern const int CAPN_PROTO_BAD_CAST;
     extern const int INCORRECT_DATA;
     extern const int ILLEGAL_COLUMN;
@@ -293,7 +293,7 @@ namespace
                     return capnp::DynamicValue::Reader(capnp::DynamicEnum(enumerant));
             }
 
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert CLickHouse Enum value to CapnProto Enum");
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert ClickHouse Enum value to CapnProto Enum");
         }
 
         void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override

From 344885dd27fbc652a5e93040ead764cf88232bbf Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 10 May 2023 21:08:12 +0200
Subject: [PATCH 085/722] Fix style

---
 src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
index e686ae86997..c056ee2b4a4 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
@@ -14,7 +14,6 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int LOGICAL_ERROR;
     extern const int INCORRECT_DATA;
 }
 

From e3cb1e40e4830d9b5499c2c410e1d12add4cc90f Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 10 May 2023 21:08:31 +0200
Subject: [PATCH 086/722] Fix style

---
 src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
index 7dd18be27f4..66a7160dd89 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
@@ -11,12 +11,6 @@
 namespace DB
 {
 
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-}
-
-
 CapnProtoOutputStream::CapnProtoOutputStream(WriteBuffer & out_) : out(out_)
 {
 }

From 07630ef43fd40f46dfba9adca487c3b69ca2ad3c Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 11 May 2023 01:10:34 +0200
Subject: [PATCH 087/722] upd

---
 src/Client/ClientBase.cpp | 4 +---
 src/Client/Connection.cpp | 8 ++++----
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 8b5db85fc02..fad9494ba4b 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1082,9 +1082,7 @@ void ClientBase::onProgress(const Progress & value)
 
 void ClientBase::onTimezoneUpdate(const String & tz)
 {
-    Settings settings;
-    settings.session_timezone = tz;
-    global_context->applySettingsChanges(settings.changes());
+    global_context->setSetting("session_timezone", tz);
 }
 
 
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index 062f05105aa..86585d805d9 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -355,10 +355,10 @@ void Connection::receiveHello()
             nonce.emplace(read_nonce);
         }
     }
-    else if (packet_type == Protocol::Server::TimezoneUpdate)
-    {
-        // skip this packet at hello, will receive and process it later
-    }
+//    else if (packet_type == Protocol::Server::TimezoneUpdate)
+//    {
+//        // skip this packet at hello, will receive and process it later
+//    }
     else if (packet_type == Protocol::Server::Exception)
         receiveException()->rethrow();
     else

From 58bdcc29315a712e1255c13d31669f4545de9edb Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Wed, 10 May 2023 23:55:13 +0000
Subject: [PATCH 088/722] allow to cast IPv6 to IPv4 for address in proper
 mapping block

---
 src/Functions/FunctionsConversion.h | 30 ++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 9c4085f9745..9cdd09780e3 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -57,6 +57,7 @@
 #include <Interpreters/Context.h>
 #include <Common/HashTable/HashMap.h>
 #include <DataTypes/DataTypeIPv4andIPv6.h>
+#include <Common/IPv6ToBinary.h>
 #include <Core/Types.h>
 
 
@@ -217,13 +218,13 @@ struct ConvertImpl
                 }
                 else if constexpr (
                     (std::is_same_v<FromDataType, DataTypeIPv4> != std::is_same_v<ToDataType, DataTypeIPv4>)
-                    && !(is_any_of<FromDataType, DataTypeUInt8, DataTypeUInt16, DataTypeUInt32, DataTypeUInt64> || is_any_of<ToDataType, DataTypeUInt32, DataTypeUInt64, DataTypeUInt128, DataTypeUInt256>)
+                    && !(is_any_of<FromDataType, DataTypeUInt8, DataTypeUInt16, DataTypeUInt32, DataTypeUInt64, DataTypeIPv6> || is_any_of<ToDataType, DataTypeUInt32, DataTypeUInt64, DataTypeUInt128, DataTypeUInt256>)
                 )
                 {
                     throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Conversion from {} to {} is not supported",
                                     TypeName<typename FromDataType::FieldType>, TypeName<typename ToDataType::FieldType>);
                 }
-                else if constexpr (std::is_same_v<FromDataType, DataTypeIPv6> != std::is_same_v<ToDataType, DataTypeIPv6>)
+                else if constexpr (std::is_same_v<FromDataType, DataTypeIPv6> != std::is_same_v<ToDataType, DataTypeIPv6> && !std::is_same_v<ToDataType, DataTypeIPv4>)
                 {
                     throw Exception(ErrorCodes::NOT_IMPLEMENTED,
                                     "Conversion between numeric types and IPv6 is not supported. "
@@ -304,7 +305,30 @@ struct ConvertImpl
                         }
                         else
                         {
-                            if constexpr (std::is_same_v<ToDataType, DataTypeIPv4> && std::is_same_v<FromDataType, DataTypeUInt64>)
+                            if constexpr (std::is_same_v<ToDataType, DataTypeIPv4> && std::is_same_v<FromDataType, DataTypeIPv6>)
+                            {
+                                const uint8_t ip4_cidr[] {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0x00, 0x00, 0x00, 0x00};
+                                const uint8_t * src = reinterpret_cast<const uint8_t *>(&vec_from[i].toUnderType());
+                                if (!matchIPv6Subnet(src, ip4_cidr, 96))
+                                    throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "IPv6 in column {} is not in IPv4 mapping block", named_from.column->getName());
+
+                                uint8_t * dst = reinterpret_cast<uint8_t *>(&vec_to[i].toUnderType());
+                                if constexpr (std::endian::native == std::endian::little)
+                                {
+                                    dst[0] = src[15];
+                                    dst[1] = src[14];
+                                    dst[2] = src[13];
+                                    dst[3] = src[12];
+                                }
+                                else
+                                {
+                                    dst[3] = src[15];
+                                    dst[2] = src[14];
+                                    dst[1] = src[13];
+                                    dst[0] = src[12];
+                                }
+                            }
+                            else if constexpr (std::is_same_v<ToDataType, DataTypeIPv4> && std::is_same_v<FromDataType, DataTypeUInt64>)
                                 vec_to[i] = static_cast<ToFieldType>(static_cast<IPv4::UnderlyingType>(vec_from[i]));
                             else
                                 vec_to[i] = static_cast<ToFieldType>(vec_from[i]);

From 288988b59912173883daa757fff394fc5f40b497 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 11 May 2023 12:08:50 +0000
Subject: [PATCH 089/722] Fix build

---
 src/Formats/CapnProtoSerializer.cpp | 6 ++++++
 src/Formats/CapnProtoSerializer.h   | 4 ++++
 2 files changed, 10 insertions(+)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index c31623286d0..00ccfc7717d 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -1,3 +1,7 @@
+#include "config.h"
+
+#if USE_CAPNP
+
 #include <Formats/CapnProtoSerializer.h>
 #include <Formats/FormatSettings.h>
 #include <Formats/CapnProtoSchema.h>
@@ -1216,3 +1220,5 @@ void CapnProtoSerializer::readRow(MutableColumns & columns, capnp::DynamicStruct
 CapnProtoSerializer::~CapnProtoSerializer() = default;
 
 }
+
+#endif
diff --git a/src/Formats/CapnProtoSerializer.h b/src/Formats/CapnProtoSerializer.h
index efae797875b..692f5e5301f 100644
--- a/src/Formats/CapnProtoSerializer.h
+++ b/src/Formats/CapnProtoSerializer.h
@@ -1,5 +1,7 @@
 #pragma once
 
+#if USE_CAPNP
+
 #include <Core/Block.h>
 #include <capnp/dynamic.h>
 
@@ -23,3 +25,5 @@ private:
 };
 
 }
+
+#endif

From 108e256578574b26f8adeb3916b15238f0557ee9 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Thu, 11 May 2023 16:17:52 +0000
Subject: [PATCH 090/722] allow to cast IPv4 to IPv6

---
 src/Functions/FunctionsConversion.h | 32 ++++++++++++++++++++++++-----
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 9cdd09780e3..5bf59f33cb5 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -218,13 +218,13 @@ struct ConvertImpl
                 }
                 else if constexpr (
                     (std::is_same_v<FromDataType, DataTypeIPv4> != std::is_same_v<ToDataType, DataTypeIPv4>)
-                    && !(is_any_of<FromDataType, DataTypeUInt8, DataTypeUInt16, DataTypeUInt32, DataTypeUInt64, DataTypeIPv6> || is_any_of<ToDataType, DataTypeUInt32, DataTypeUInt64, DataTypeUInt128, DataTypeUInt256>)
+                    && !(is_any_of<FromDataType, DataTypeUInt8, DataTypeUInt16, DataTypeUInt32, DataTypeUInt64, DataTypeIPv6> || is_any_of<ToDataType, DataTypeUInt32, DataTypeUInt64, DataTypeUInt128, DataTypeUInt256, DataTypeIPv6>)
                 )
                 {
                     throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Conversion from {} to {} is not supported",
                                     TypeName<typename FromDataType::FieldType>, TypeName<typename ToDataType::FieldType>);
                 }
-                else if constexpr (std::is_same_v<FromDataType, DataTypeIPv6> != std::is_same_v<ToDataType, DataTypeIPv6> && !std::is_same_v<ToDataType, DataTypeIPv4>)
+                else if constexpr (std::is_same_v<FromDataType, DataTypeIPv6> != std::is_same_v<ToDataType, DataTypeIPv6> && !(std::is_same_v<ToDataType, DataTypeIPv4> || std::is_same_v<FromDataType, DataTypeIPv4>))
                 {
                     throw Exception(ErrorCodes::NOT_IMPLEMENTED,
                                     "Conversion between numeric types and IPv6 is not supported. "
@@ -322,10 +322,32 @@ struct ConvertImpl
                                 }
                                 else
                                 {
-                                    dst[3] = src[15];
-                                    dst[2] = src[14];
-                                    dst[1] = src[13];
                                     dst[0] = src[12];
+                                    dst[1] = src[13];
+                                    dst[2] = src[14];
+                                    dst[3] = src[15];
+                                }
+                            }
+                            else if constexpr (std::is_same_v<ToDataType, DataTypeIPv6> && std::is_same_v<FromDataType, DataTypeIPv4>)
+                            {
+                                const uint8_t * src = reinterpret_cast<const uint8_t *>(&vec_from[i].toUnderType());
+                                uint8_t * dst = reinterpret_cast<uint8_t *>(&vec_to[i].toUnderType());
+                                std::memset(dst, '\0', IPV6_BINARY_LENGTH);
+                                dst[10] = dst[11] = 0xff;
+
+                                if constexpr (std::endian::native == std::endian::little)
+                                {
+                                    dst[12] = src[3];
+                                    dst[13] = src[2];
+                                    dst[14] = src[1];
+                                    dst[15] = src[0];
+                                }
+                                else
+                                {
+                                    dst[12] = src[0];
+                                    dst[13] = src[1];
+                                    dst[14] = src[2];
+                                    dst[15] = src[3];
                                 }
                             }
                             else if constexpr (std::is_same_v<ToDataType, DataTypeIPv4> && std::is_same_v<FromDataType, DataTypeUInt64>)

From 60b69601e9b1e3563eb43bf4ea1deee582e088fa Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 12 May 2023 00:27:11 +0200
Subject: [PATCH 091/722] update docs

---
 .../server-configuration-parameters/settings.md  |  4 ++++
 docs/en/operations/settings/settings.md          | 16 +++++++++++-----
 .../functions/date-time-functions.md             | 14 +++++++++++---
 .../server-configuration-parameters/settings.md  |  4 ++++
 docs/ru/operations/settings/settings.md          | 12 ++++++++----
 .../functions/date-time-functions.md             | 13 +++++++++++--
 6 files changed, 49 insertions(+), 14 deletions(-)

diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index e3ca04f5b9b..36ddf6faad0 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -1612,6 +1612,10 @@ The time zone is necessary for conversions between String and DateTime formats w
 <timezone>Asia/Istanbul</timezone>
 ```
 
+**See also**
+
+- [session_timezone](../settings/settings.md#session_timezone)
+
 ## tcp_port {#server_configuration_parameters-tcp_port}
 
 Port for communicating with clients over the TCP protocol.
diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index cc5f292f677..2a929acd5f2 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4036,23 +4036,25 @@ Use this setting only for backward compatibility if your use cases depend on old
 
 ## session_timezone {#session_timezone}
 
-If specified, sets an implicit timezone (instead of server-default). All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
-Setting this to `''` (empty string) effectively resets implicit timezone to server timezone.
+If specified, sets an implicit timezone (instead of [server default](../server-configuration-parameters/settimgs.md#server_configuration_parameters-timezone).
+All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
+A value of `''` (empty string) configures the session timezone to the server default timezone.
+
 Examples:
 
-```clickhouse
+```sql
 SELECT timeZone(), serverTimezone() FORMAT TSV
 
 Europe/Berlin	Europe/Berlin
 ```
 
-```clickhouse
+```sql
 SELECT timeZone(), serverTimezone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT TSV
 
 Asia/Novosibirsk	Europe/Berlin
 ```
 
-```clickhouse
+```sql
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
 
 1999-12-13 07:23:23.123
@@ -4064,6 +4066,10 @@ Possible values:
 
 Default value: `''`.
 
+**See also**
+
+- [timezone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone)
+
 ## final {#final}
 
 Automatically applies [FINAL](../../sql-reference/statements/select/from.md#final-modifier) modifier to all tables in a query, to tables where [FINAL](../../sql-reference/statements/select/from.md#final-modifier) is applicable, including joined tables and tables in sub-queries, and
diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index 596a2c509cd..9207a135c67 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -139,7 +139,7 @@ makeDateTime32(year, month, day, hour, minute, second[, fraction[, precision[, t
 
 ## timeZone
 
-Returns the default timezone of the server for current session. This can be modified using `SET session_timezone = 'New/Value'`
+Returns the default timezone of the current session, i.e. the value of setting [session_timezone](../../operations/settings/settings.md#session_timezone).
 If the function is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard, otherwise it produces a constant value.
 
 **Syntax**
@@ -156,9 +156,13 @@ Alias: `timezone`.
 
 Type: [String](../../sql-reference/data-types/string.md).
 
+**See also**
+
+- [serverTimeZone](#serverTimeZone)
+
 ## serverTimeZone
 
-Returns the actual timezone in which the server runs in.
+Returns the default timezone of the server, i.e. the value of setting [timezone](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
 If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise it produces a constant value.
 
 **Syntax**
@@ -175,6 +179,10 @@ Alias: `ServerTimezone`, `servertimezone`.
 
 Type: [String](../../sql-reference/data-types/string.md).
 
+**See also**
+
+- [timeZone](#timeZone)
+
 ## toTimeZone
 
 Converts a date or date with time to the specified time zone. Does not change the internal value (number of unix seconds) of the data, only the value's time zone attribute and the value's string representation changes.
@@ -408,7 +416,7 @@ Result:
 ```
 
 :::note
-The return type of `toStartOf*`, `toLastDayOfMonth`, `toMonday`, `timeSlot` functions described below is determined by the configuration parameter [enable_extended_results_for_datetime_functions](../../operations/settings/settings.md#enable-extended-results-for-datetime-functions) which is `0` by default.
+Thes return type of `toStartOf*`, `toLastDayOfMonth`, `toMonday`, `timeSlot` functions described below is determined by the configuration parameter [enable_extended_results_for_datetime_functions](../../operations/settings/settings.md#enable-extended-results-for-datetime-functions) which is `0` by default.
 
 Behavior for
 * `enable_extended_results_for_datetime_functions = 0`: Functions `toStartOfYear`, `toStartOfISOYear`, `toStartOfQuarter`, `toStartOfMonth`, `toStartOfWeek`, `toLastDayOfMonth`, `toMonday` return `Date` or `DateTime`. Functions `toStartOfDay`, `toStartOfHour`, `toStartOfFifteenMinutes`, `toStartOfTenMinutes`, `toStartOfFiveMinutes`, `toStartOfMinute`, `timeSlot` return `DateTime`. Though these functions can take values of the extended types `Date32` and `DateTime64` as an argument, passing them a time outside the normal range (year 1970 to 2149 for `Date` / 2106 for `DateTime`) will produce wrong results.
diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md
index 787153d4d19..33db6df0fdd 100644
--- a/docs/ru/operations/server-configuration-parameters/settings.md
+++ b/docs/ru/operations/server-configuration-parameters/settings.md
@@ -1355,6 +1355,10 @@ Parameters:
 <timezone>Europe/Moscow</timezone>
 ```
 
+**См. также**
+
+- [session_timezone](../settings/settings.md#session_timezone)
+
 ## tcp_port {#server_configuration_parameters-tcp_port}
 
 Порт для взаимодействия с клиентами по протоколу TCP.
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 585a3995afe..56bfbf8a57f 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4077,23 +4077,23 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 
 ## session_timezone {#session_timezone}
 
-Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо часового пояса сервера. То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
+Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо [часового пояса сервера](../server-configuration-parameters/settimgs.md#server_configuration_parameters-timezone). То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
 При значении настройки `''` (пустая строка), будет совпадать с часовым поясом сервера. 
 
 Примеры:
-```clickhouse
+```sql
 SELECT timeZone(), serverTimezone() FORMAT TSV
 
 Europe/Berlin	Europe/Berlin
 ```
 
-```clickhouse
+```sql
 SELECT timeZone(), serverTimezone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT TSV
 
 Asia/Novosibirsk	Europe/Berlin
 ```
 
-```clickhouse
+```sql
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
 
 1999-12-13 07:23:23.123
@@ -4104,3 +4104,7 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 -    Любая зона из `system.time_zones`, например `Europe/Berlin`, `UTC` или `Zulu`
 
 Значение по умолчанию: `''`.
+
+**Смотрите также**
+
+- [timezone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone)
\ No newline at end of file
diff --git a/docs/ru/sql-reference/functions/date-time-functions.md b/docs/ru/sql-reference/functions/date-time-functions.md
index 3e378c08308..2d9f96c3199 100644
--- a/docs/ru/sql-reference/functions/date-time-functions.md
+++ b/docs/ru/sql-reference/functions/date-time-functions.md
@@ -26,7 +26,8 @@ SELECT
 
 ## timeZone {#timezone}
 
-Возвращает часовой пояс сервера, считающийся умолчанием для текущей сессии. Можно изменить значение с помощью `SET session_timezone = 'New/Timezone''`
+Возвращает часовой пояс сервера, считающийся умолчанием для текущей сессии: значение параметра [session_timezone](../../operations/settings/settings.md#session_timezone), если установлено.
+
 Если функция вызывается в контексте распределенной таблицы, то она генерирует обычный столбец со значениями, актуальными для каждого шарда. Иначе возвращается константа.
 
 **Синтаксис**
@@ -43,9 +44,13 @@ timeZone()
 
 Тип: [String](../../sql-reference/data-types/string.md).
 
+**Смотрите также**
+
+- [serverTimeZone](#servertimezone)
+
 ## serverTimeZone {#servertimezone}
 
-Возвращает (истинный) часовой пояс сервера, в котором тот работает.
+Возвращает часовой пояс сервера по умолчанию, в т.ч. установленный [timezone](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone)
 Если функция вызывается в контексте распределенной таблицы, то она генерирует обычный столбец со значениями, актуальными для каждого шарда. Иначе возвращается константа.
 
 **Синтаксис**
@@ -62,6 +67,10 @@ serverTimeZone()
 
 Тип: [String](../../sql-reference/data-types/string.md).
 
+**Смотрите также**
+
+- [timeZone](#timezone)
+
 ## toTimeZone {#totimezone}
 
 Переводит дату или дату с временем в указанный часовой пояс. Часовой пояс - это атрибут типов `Date` и `DateTime`. Внутреннее значение (количество секунд) поля таблицы или результирующего столбца не изменяется, изменяется тип поля и, соответственно, его текстовое отображение.

From c3af36915f049794a9c44c55ebb6a6bc950eadc8 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 12 May 2023 01:29:34 +0200
Subject: [PATCH 092/722] fixed docs 2

---
 docs/en/operations/settings/settings.md              | 2 +-
 docs/ru/operations/settings/settings.md              | 2 +-
 src/DataTypes/Serializations/SerializationDate.cpp   | 3 ++-
 src/DataTypes/Serializations/SerializationDate.h     | 7 +++++--
 src/DataTypes/Serializations/SerializationDate32.cpp | 3 ++-
 src/DataTypes/Serializations/SerializationDate32.h   | 7 +++++--
 src/IO/ReadHelpers.h                                 | 3 +--
 7 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 2a929acd5f2..e796ea83a6f 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4036,7 +4036,7 @@ Use this setting only for backward compatibility if your use cases depend on old
 
 ## session_timezone {#session_timezone}
 
-If specified, sets an implicit timezone (instead of [server default](../server-configuration-parameters/settimgs.md#server_configuration_parameters-timezone).
+If specified, sets an implicit timezone (instead of [server default](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
 All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
 A value of `''` (empty string) configures the session timezone to the server default timezone.
 
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 56bfbf8a57f..98486847fd9 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4077,7 +4077,7 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 
 ## session_timezone {#session_timezone}
 
-Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо [часового пояса сервера](../server-configuration-parameters/settimgs.md#server_configuration_parameters-timezone). То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
+Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо [часового пояса сервера](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone). То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
 При значении настройки `''` (пустая строка), будет совпадать с часовым поясом сервера. 
 
 Примеры:
diff --git a/src/DataTypes/Serializations/SerializationDate.cpp b/src/DataTypes/Serializations/SerializationDate.cpp
index 8b4956f7826..1ed48fdd31d 100644
--- a/src/DataTypes/Serializations/SerializationDate.cpp
+++ b/src/DataTypes/Serializations/SerializationDate.cpp
@@ -80,7 +80,8 @@ void SerializationDate::deserializeTextCSV(IColumn & column, ReadBuffer & istr,
     readCSV(value, istr, time_zone);
     assert_cast<ColumnUInt16 &>(column).getData().push_back(value);
 }
-SerializationDate::SerializationDate(const TimezoneMixin & time_zone_) : TimezoneMixin(time_zone_)
+
+SerializationDate::SerializationDate(const DateLUTImpl & time_zone_) : time_zone(time_zone_)
 {
 }
 
diff --git a/src/DataTypes/Serializations/SerializationDate.h b/src/DataTypes/Serializations/SerializationDate.h
index c4e57470673..4d6a6fa36ec 100644
--- a/src/DataTypes/Serializations/SerializationDate.h
+++ b/src/DataTypes/Serializations/SerializationDate.h
@@ -6,10 +6,10 @@
 namespace DB
 {
 
-class SerializationDate final : public SerializationNumber<UInt16>, public TimezoneMixin
+class SerializationDate final : public SerializationNumber<UInt16>
 {
 public:
-    explicit SerializationDate(const TimezoneMixin & time_zone_ = TimezoneMixin());
+    explicit SerializationDate(const DateLUTImpl & time_zone_ = DateLUT::instance());
 
     void serializeText(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
     void deserializeWholeText(IColumn & column, ReadBuffer & istr, const FormatSettings &) const override;
@@ -21,6 +21,9 @@ public:
     void deserializeTextJSON(IColumn & column, ReadBuffer & istr, const FormatSettings &) const override;
     void serializeTextCSV(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
     void deserializeTextCSV(IColumn & column, ReadBuffer & istr, const FormatSettings & settings) const override;
+
+protected:
+    const DateLUTImpl & time_zone;
 };
 
 }
diff --git a/src/DataTypes/Serializations/SerializationDate32.cpp b/src/DataTypes/Serializations/SerializationDate32.cpp
index 8dcaee8d266..851710de839 100644
--- a/src/DataTypes/Serializations/SerializationDate32.cpp
+++ b/src/DataTypes/Serializations/SerializationDate32.cpp
@@ -78,7 +78,8 @@ void SerializationDate32::deserializeTextCSV(IColumn & column, ReadBuffer & istr
     readCSV(value, istr);
     assert_cast<ColumnInt32 &>(column).getData().push_back(value.getExtenedDayNum());
 }
-SerializationDate32::SerializationDate32(const TimezoneMixin & time_zone_) : TimezoneMixin(time_zone_)
+
+SerializationDate32::SerializationDate32(const DateLUTImpl & time_zone_) : time_zone(time_zone_)
 {
 }
 }
diff --git a/src/DataTypes/Serializations/SerializationDate32.h b/src/DataTypes/Serializations/SerializationDate32.h
index e8e8f1a74d6..6b6e5442240 100644
--- a/src/DataTypes/Serializations/SerializationDate32.h
+++ b/src/DataTypes/Serializations/SerializationDate32.h
@@ -5,10 +5,10 @@
 
 namespace DB
 {
-class SerializationDate32 final : public SerializationNumber<Int32>, public TimezoneMixin
+class SerializationDate32 final : public SerializationNumber<Int32>
 {
 public:
-    explicit SerializationDate32(const TimezoneMixin & time_zone_ = TimezoneMixin());
+    explicit SerializationDate32(const DateLUTImpl & time_zone_ = DateLUT::instance());
 
     void serializeText(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
     void deserializeWholeText(IColumn & column, ReadBuffer & istr, const FormatSettings &) const override;
@@ -20,5 +20,8 @@ public:
     void deserializeTextJSON(IColumn & column, ReadBuffer & istr, const FormatSettings &) const override;
     void serializeTextCSV(const IColumn & column, size_t row_num, WriteBuffer & ostr, const FormatSettings &) const override;
     void deserializeTextCSV(IColumn & column, ReadBuffer & istr, const FormatSettings & settings) const override;
+
+protected:
+    const DateLUTImpl & time_zone;
 };
 }
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index ea565d11914..3bd9275322e 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -1160,8 +1160,7 @@ inline void readText(is_floating_point auto & x, ReadBuffer & buf) { readFloatTe
 
 inline void readText(String & x, ReadBuffer & buf) { readEscapedString(x, buf); }
 
-inline void readText(DayNum & x, ReadBuffer & buf) { readDateText(x, buf); }
-inline void readText(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone) { readDateText(x, buf, time_zone); }
+inline void readText(DayNum & x, ReadBuffer & buf, const DateLUTImpl & time_zone = DateLUT::instance()) { readDateText(x, buf, time_zone); }
 
 inline void readText(LocalDate & x, ReadBuffer & buf) { readDateText(x, buf); }
 inline void readText(LocalDateTime & x, ReadBuffer & buf) { readDateTimeText(x, buf); }

From 1daa9811222c80f2d957556d32be4f3309034e4b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 12 May 2023 16:12:01 +0200
Subject: [PATCH 093/722] Fix special builds

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index 00ccfc7717d..091e70da656 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -1007,7 +1007,7 @@ namespace
             catch (Exception & e)
             {
                 e.addMessage("(while converting column {})", column_name);
-                throw e;
+                throw std::move(e);
             }
         }
 
@@ -1015,7 +1015,7 @@ namespace
         {
             assert(builder);
             auto & struct_builder = assert_cast<StructBuilder &>(*builder);
-            if (auto tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+            if (auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
                 writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
             else
                 writeRow(Columns{column}, struct_builder, row_num);

From 24067ea977b6e4484f68efba8858ba8d0ad1cd6b Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Fri, 12 May 2023 15:54:50 +0000
Subject: [PATCH 094/722] allow conversion for toIPv4OrDefault

---
 src/Functions/FunctionsCodingIP.h   | 81 +++++++++++++++++++++++++++++
 src/Functions/FunctionsConversion.h | 20 +++++++
 2 files changed, 101 insertions(+)

diff --git a/src/Functions/FunctionsCodingIP.h b/src/Functions/FunctionsCodingIP.h
index d02cc81f608..bd53fa7e043 100644
--- a/src/Functions/FunctionsCodingIP.h
+++ b/src/Functions/FunctionsCodingIP.h
@@ -2,6 +2,7 @@
 
 #include <type_traits>
 #include <Common/formatIPv6.h>
+#include <Common/IPv6ToBinary.h>
 
 #include <Columns/ColumnFixedString.h>
 #include <Columns/ColumnNullable.h>
@@ -16,6 +17,7 @@ namespace ErrorCodes
     extern const int CANNOT_PARSE_IPV4;
     extern const int CANNOT_PARSE_IPV6;
     extern const int ILLEGAL_COLUMN;
+    extern const int CANNOT_CONVERT_TYPE;
 }
 
 enum class IPStringToNumExceptionMode : uint8_t
@@ -296,4 +298,83 @@ ColumnPtr convertToIPv4(ColumnPtr column, const PaddedPODArray<UInt8> * null_map
     return col_res;
 }
 
+template <IPStringToNumExceptionMode exception_mode, typename ToColumn = ColumnIPv4>
+ColumnPtr convertIPv6ToIPv4(ColumnPtr column, const PaddedPODArray<UInt8> * null_map = nullptr)
+{
+    const ColumnIPv6 * column_ipv6 = checkAndGetColumn<ColumnIPv6>(column.get());
+
+    if (!column_ipv6)
+        throw Exception(ErrorCodes::ILLEGAL_COLUMN, "Illegal column type {}. Expected IPv6.", column->getName());
+
+    size_t column_size = column_ipv6->size();
+
+    ColumnUInt8::MutablePtr col_null_map_to;
+    ColumnUInt8::Container * vec_null_map_to = nullptr;
+
+    if constexpr (exception_mode == IPStringToNumExceptionMode::Null)
+    {
+        col_null_map_to = ColumnUInt8::create(column_size, false);
+        vec_null_map_to = &col_null_map_to->getData();
+    }
+
+    const uint8_t ip4_cidr[] {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0x00, 0x00, 0x00, 0x00};
+
+    auto col_res = ToColumn::create();
+    auto & vec_res = col_res->getData();
+    vec_res.resize(column_size);
+    const auto & vec_src = column_ipv6->getData();
+
+    for (size_t i = 0; i < vec_res.size(); ++i)
+    {
+        const uint8_t * src = reinterpret_cast<const uint8_t *>(&vec_src[i]);
+        uint8_t * dst = reinterpret_cast<uint8_t *>(&vec_res[i]);
+
+        if (null_map && (*null_map)[i])
+        {
+            std::memset(dst, '\0', IPV4_BINARY_LENGTH);
+            if constexpr (exception_mode == IPStringToNumExceptionMode::Null)
+                (*vec_null_map_to)[i] = true;
+            continue;
+        }
+
+        if (!matchIPv6Subnet(src, ip4_cidr, 96))
+        {
+            if constexpr (exception_mode == IPStringToNumExceptionMode::Throw)
+            {
+                throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "IPv6 in column {} is not in IPv4 mapping block", column->getName());
+            }
+            else if constexpr (exception_mode == IPStringToNumExceptionMode::Default)
+            {
+                std::memset(dst, '\0', IPV4_BINARY_LENGTH);
+            }
+            else if constexpr (exception_mode == IPStringToNumExceptionMode::Null)
+            {
+                (*vec_null_map_to)[i] = true;
+                std::memset(dst, '\0', IPV4_BINARY_LENGTH);
+            }
+            continue;
+        }
+
+        if constexpr (std::endian::native == std::endian::little)
+        {
+            dst[0] = src[15];
+            dst[1] = src[14];
+            dst[2] = src[13];
+            dst[3] = src[12];
+        }
+        else
+        {
+            dst[0] = src[12];
+            dst[1] = src[13];
+            dst[2] = src[14];
+            dst[3] = src[15];
+        }
+    }
+
+    if constexpr (exception_mode == IPStringToNumExceptionMode::Null)
+        return ColumnNullable::create(std::move(col_res), std::move(col_null_map_to));
+
+    return col_res;
+}
+
 }
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 5bf59f33cb5..4d4efc84df1 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -4035,6 +4035,26 @@ private:
                     return true;
                 }
             }
+            else if constexpr (WhichDataType(FromDataType::type_id).isIPv6() && WhichDataType(ToDataType::type_id).isIPv4())
+            {
+                ret = [cast_ipv4_ipv6_default_on_conversion_error_value, requested_result_is_nullable](
+                                ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type, const ColumnNullable * column_nullable, size_t)
+                        -> ColumnPtr
+                {
+                    if (!WhichDataType(result_type).isIPv4())
+                        throw Exception(
+                            ErrorCodes::TYPE_MISMATCH, "Wrong result type {}. Expected IPv4", result_type->getName());
+
+                    const auto * null_map = column_nullable ? &column_nullable->getNullMapData() : nullptr;
+                    if (cast_ipv4_ipv6_default_on_conversion_error_value || requested_result_is_nullable)
+                        return convertIPv6ToIPv4<IPStringToNumExceptionMode::Default>(arguments[0].column, null_map);
+                    else
+                        return convertIPv6ToIPv4<IPStringToNumExceptionMode::Throw>(arguments[0].column, null_map);
+                };
+
+                return true;
+            }
+
             if constexpr (WhichDataType(ToDataType::type_id).isStringOrFixedString())
             {
                 if (from_type->getCustomSerialization())

From 7698776d2aae48880e45d8a791b7474b5ef20999 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 12 May 2023 18:53:51 +0200
Subject: [PATCH 095/722] Fix special build

---
 src/Formats/CapnProtoSchema.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Formats/CapnProtoSchema.cpp b/src/Formats/CapnProtoSchema.cpp
index 22518d5061a..f9ab88d39ed 100644
--- a/src/Formats/CapnProtoSchema.cpp
+++ b/src/Formats/CapnProtoSchema.cpp
@@ -151,7 +151,7 @@ namespace
 {
 
     template <typename ValueType>
-    static DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
+    DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
     {
         std::vector<std::pair<String, ValueType>> values;
         for (auto enumerant : enumerants)
@@ -159,7 +159,7 @@ namespace
         return std::make_shared<DataTypeEnum<ValueType>>(std::move(values));
     }
 
-    static DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
+    DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
     {
         auto enumerants = enum_schema.getEnumerants();
         if (enumerants.size() < 128)
@@ -170,7 +170,7 @@ namespace
         throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "ClickHouse supports only 8 and 16-bit Enums");
     }
 
-    static DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
+    DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
     {
         switch (capnp_type.which())
         {

From c9f90fb9adba16ad1131a16d46a6efefdd532379 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 12 May 2023 18:54:38 +0200
Subject: [PATCH 096/722] Fix special build

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index 091e70da656..ff3880976c7 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -158,7 +158,7 @@ namespace
     };
 
     template <typename NumericType, bool is_bool_data_type = false>
-    static std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+    std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
     {
         switch (capnp_type.which())
         {
@@ -1015,7 +1015,7 @@ namespace
         {
             assert(builder);
             auto & struct_builder = assert_cast<StructBuilder &>(*builder);
-            if (auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+            if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
                 writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
             else
                 writeRow(Columns{column}, struct_builder, row_num);

From fc857aa2dbf297d2681af16ddfbafb47739db854 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <yakov@clickhouse.com>
Date: Mon, 15 May 2023 03:06:03 +0000
Subject: [PATCH 097/722] tests added

---
 .../queries/0_stateless/02234_cast_to_ip_address.reference | 4 ++++
 tests/queries/0_stateless/02234_cast_to_ip_address.sql     | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/tests/queries/0_stateless/02234_cast_to_ip_address.reference b/tests/queries/0_stateless/02234_cast_to_ip_address.reference
index 9023b36a9bf..fa9c6bd0f94 100644
--- a/tests/queries/0_stateless/02234_cast_to_ip_address.reference
+++ b/tests/queries/0_stateless/02234_cast_to_ip_address.reference
@@ -11,6 +11,10 @@ IPv4 functions
 127.0.0.1
 127.0.0.1
 --
+1.2.3.4
+1.2.3.4
+0.0.0.0
+--
 127.0.0.1
 --
 0
diff --git a/tests/queries/0_stateless/02234_cast_to_ip_address.sql b/tests/queries/0_stateless/02234_cast_to_ip_address.sql
index 6c65fe86cc9..28f1afff57f 100644
--- a/tests/queries/0_stateless/02234_cast_to_ip_address.sql
+++ b/tests/queries/0_stateless/02234_cast_to_ip_address.sql
@@ -20,6 +20,13 @@ SELECT toIPv4OrNull('127.0.0.1');
 
 SELECT '--';
 
+SELECT toIPv4(toIPv6('::ffff:1.2.3.4'));
+SELECT toIPv4(toIPv6('::afff:1.2.3.4')); --{serverError CANNOT_CONVERT_TYPE}
+SELECT toIPv4OrDefault(toIPv6('::ffff:1.2.3.4'));
+SELECT toIPv4OrDefault(toIPv6('::afff:1.2.3.4'));
+
+SELECT '--';
+
 SELECT cast('test' , 'IPv4'); --{serverError CANNOT_PARSE_IPV4}
 SELECT cast('127.0.0.1' , 'IPv4');
 

From e5aa3fcc8fdf8bbc45756728f11a9a55c2f17fb6 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 17 May 2023 19:09:13 +0000
Subject: [PATCH 098/722] Add queries with enabled analyzer

---
 .../0_stateless/01655_plan_optimizations.sh   | 44 ++++++++++++++++---
 1 file changed, 39 insertions(+), 5 deletions(-)

diff --git a/tests/queries/0_stateless/01655_plan_optimizations.sh b/tests/queries/0_stateless/01655_plan_optimizations.sh
index ec856c9bf27..7c299f9cc26 100755
--- a/tests/queries/0_stateless/01655_plan_optimizations.sh
+++ b/tests/queries/0_stateless/01655_plan_optimizations.sh
@@ -26,11 +26,17 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> filter should be pushed down after aggregating, column after aggregation is const"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1 select s, y, y != 0 from (select sum(x) as s, y from (
         select number as x, number + 1 as y from numbers(10)) group by y
     ) where y != 0
     settings enable_optimize_predicate_expression=0" | grep -o "Aggregating\|Filter\|COLUMN Const(UInt8) -> notEquals(y, 0)"
+echo "> (analyzer) filter should be pushed down after aggregating, column after aggregation is const"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1 select s, y, y != 0 from (select sum(x) as s, y from (
+        select number as x, number + 1 as y from numbers(10)) group by y
+    ) where y != 0
+    settings enable_optimize_predicate_expression=0" | grep -o "Aggregating\|Filter\|COLUMN Const(UInt8) -> notEquals(y_1, 0_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select s, y, y != 0 from (select sum(x) as s, y from (
         select number as x, number + 1 as y from numbers(10)) group by y
@@ -38,12 +44,19 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> one condition of filter should be pushed down after aggregating, other condition is aliased"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1 select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
     ) where y != 0 and s != 4
     settings enable_optimize_predicate_expression=0" |
     grep -o "Aggregating\|Filter column\|Filter column: notEquals(y, 0)\|ALIAS notEquals(s, 4) :: 1 -> and(notEquals(y, 0), notEquals(s, 4))"
+echo "> (analyzer) one condition of filter should be pushed down after aggregating, other condition is aliased"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1 select s, y from (
+        select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
+    ) where y != 0 and s != 4
+    settings enable_optimize_predicate_expression=0" |
+        grep -o "Aggregating\|Filter column\|Filter column: notEquals(y_1, 0_UInt8)\|ALIAS notEquals(s_0, 4_UInt8) :: 0 -> and(notEquals(y_1, 0_UInt8), notEquals(s_0, 4_UInt8))"
 $CLICKHOUSE_CLIENT -q "
     select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
@@ -51,12 +64,19 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> one condition of filter should be pushed down after aggregating, other condition is casted"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1 select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
     ) where y != 0 and s - 4
     settings enable_optimize_predicate_expression=0" |
     grep -o "Aggregating\|Filter column\|Filter column: notEquals(y, 0)\|FUNCTION and(minus(s, 4) :: 1, 1 :: 3) -> and(notEquals(y, 0), minus(s, 4)) UInt8 : 2"
+echo "> (analyzer) one condition of filter should be pushed down after aggregating, other condition is casted"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1 select s, y from (
+        select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
+    ) where y != 0 and s - 4
+    settings enable_optimize_predicate_expression=0" |
+        grep -o "Aggregating\|Filter column\|Filter column: notEquals(y_1, 0_UInt8)\|FUNCTION and(minus(s_0, 4_UInt8) :: 0, 1 :: 3) -> and(notEquals(y_1, 0_UInt8), minus(s_0, 4_UInt8)) UInt8 : 2"
 $CLICKHOUSE_CLIENT -q "
     select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
@@ -64,12 +84,19 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> one condition of filter should be pushed down after aggregating, other two conditions are ANDed"
-$CLICKHOUSE_CLIENT --convert_query_to_cnf=0 -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 --convert_query_to_cnf=0 -q "
     explain actions = 1 select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
     ) where y != 0 and s - 8 and s - 4
     settings enable_optimize_predicate_expression=0" |
     grep -o "Aggregating\|Filter column\|Filter column: notEquals(y, 0)\|FUNCTION and(minus(s, 8) :: 1, minus(s, 4) :: 2) -> and(notEquals(y, 0), minus(s, 8), minus(s, 4))"
+echo "> (analyzer) one condition of filter should be pushed down after aggregating, other two conditions are ANDed"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 --convert_query_to_cnf=0 -q "
+    explain actions = 1 select s, y from (
+        select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
+    ) where y != 0 and s - 8 and s - 4
+    settings enable_optimize_predicate_expression=0" |
+        grep -o "Aggregating\|Filter column\|Filter column: notEquals(y_1, 0_UInt8)\|FUNCTION and(minus(s_0, 8_UInt8) :: 0, minus(s_0, 4_UInt8) :: 2) -> and(notEquals(y_1, 0_UInt8), minus(s_0, 8_UInt8), minus(s_0, 4_UInt8))"
 $CLICKHOUSE_CLIENT -q "
     select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
@@ -77,12 +104,19 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> two conditions of filter should be pushed down after aggregating and ANDed, one condition is aliased"
-$CLICKHOUSE_CLIENT --convert_query_to_cnf=0 -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 --convert_query_to_cnf=0 -q "
     explain actions = 1 select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
     ) where y != 0 and s != 8 and y - 4
     settings enable_optimize_predicate_expression=0" |
     grep -o "Aggregating\|Filter column\|Filter column: and(notEquals(y, 0), minus(y, 4))\|ALIAS notEquals(s, 8) :: 1 -> and(notEquals(y, 0), notEquals(s, 8), minus(y, 4))"
+echo "> (analyzer) two conditions of filter should be pushed down after aggregating and ANDed, one condition is aliased"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 --convert_query_to_cnf=0 -q "
+    explain actions = 1 select s, y from (
+        select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y
+    ) where y != 0 and s != 8 and y - 4
+    settings enable_optimize_predicate_expression=0" |
+    grep -o "Aggregating\|Filter column\|Filter column: and(notEquals(y_1, 0_UInt8), minus(y_1, 4_UInt8))\|ALIAS notEquals(s_0, 8_UInt8) :: 0 -> and(notEquals(y_1, 0_UInt8), notEquals(s_0, 8_UInt8), minus(y_1, 4_UInt8))"
 $CLICKHOUSE_CLIENT -q "
     select s, y from (
         select sum(x) as s, y from (select number as x, number + 1 as y from numbers(10)) group by y

From c85c3afa1f50307d9a92d24559fe9628fe8cee37 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Sun, 7 May 2023 12:18:52 +0000
Subject: [PATCH 099/722] Added option to rename files, loaded via
 TableFunctionFile, after success processing

---
 src/Client/ClientBase.cpp                |  1 +
 src/Common/FileRenamer.cpp               | 99 ++++++++++++++++++++++++
 src/Common/FileRenamer.h                 | 39 ++++++++++
 src/Core/Settings.h                      |  2 +
 src/Storages/StorageFile.cpp             | 64 +++++++++++++++
 src/Storages/StorageFile.h               | 10 ++-
 src/TableFunctions/TableFunctionFile.cpp |  1 +
 7 files changed, 214 insertions(+), 2 deletions(-)
 create mode 100644 src/Common/FileRenamer.cpp
 create mode 100644 src/Common/FileRenamer.h

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 77a93a25e9b..571637c6005 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1361,6 +1361,7 @@ void ClientBase::sendData(Block & sample, const ColumnsDescription & columns_des
             columns_description_for_query,
             ConstraintsDescription{},
             String{},
+            {},
         };
         StoragePtr storage = std::make_shared<StorageFile>(in_file, global_context->getUserFilesPath(), args);
         storage->startup();
diff --git a/src/Common/FileRenamer.cpp b/src/Common/FileRenamer.cpp
new file mode 100644
index 00000000000..7a19c50a0d1
--- /dev/null
+++ b/src/Common/FileRenamer.cpp
@@ -0,0 +1,99 @@
+#include <Common/FileRenamer.h>
+
+#include <Common/DateLUT.h>
+#include <Common/Exception.h>
+
+#include <chrono>
+#include <filesystem>
+#include <format>
+#include <map>
+#include <re2/re2.h>
+#include <sstream>
+
+#include <boost/algorithm/string.hpp>
+#include <boost/algorithm/string/replace.hpp>
+
+namespace fs = std::filesystem;
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int BAD_ARGUMENTS;
+}
+
+FileRenamer::FileRenamer() = default;
+
+FileRenamer::FileRenamer(const String & renaming_rule)
+    : rule(renaming_rule)
+{
+    FileRenamer::validateRenamingRule(rule, true);
+}
+
+String FileRenamer::generateNewFilename(const String & filename) const
+{
+    // Split filename and extension
+    String file_base = fs::path(filename).stem();
+    String file_ext = fs::path(filename).extension();
+
+    // Get current timestamp in microseconds
+    String timestamp;
+    if (rule.find("%t") != String::npos)
+    {
+        auto now = std::chrono::system_clock::now();
+        std::stringstream ss;
+        ss << timeInMicroseconds(now);
+        timestamp = ss.str();
+    }
+
+    // Define placeholders and their corresponding values
+    std::map<String, String> placeholders =
+    {
+        {"%f", file_base},
+        {"%e", file_ext},
+        {"%t", timestamp},
+        {"%%", "%"}
+    };
+
+    // Replace placeholders with their actual values
+    String new_name = rule;
+    for (const auto & [placeholder, value] : placeholders)
+        boost::replace_all(new_name, placeholder, value);
+
+    return new_name;
+}
+
+bool FileRenamer::isEmpty() const
+{
+    return rule.empty();
+}
+
+bool FileRenamer::validateRenamingRule(const String & rule, bool throw_on_error)
+{
+    // Check if the rule contains invalid placeholders
+    re2::RE2 invalid_placeholder_pattern("^([^%]|%[fet%])*$");
+    if (!re2::RE2::FullMatch(rule, invalid_placeholder_pattern))
+    {
+        if (throw_on_error)
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid renaming rule: Allowed placeholders only %f, %e, %t, and %%");
+        return false;
+    }
+
+    // Replace valid placeholders with empty strings and count remaining percentage signs.
+    String replaced_rule = rule;
+    boost::replace_all(replaced_rule, "%f", "");
+    boost::replace_all(replaced_rule, "%e", "");
+    boost::replace_all(replaced_rule, "%t", "");
+    if (std::count(replaced_rule.begin(), replaced_rule.end(), '%') % 2)
+    {
+        if (throw_on_error)
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Invalid renaming rule: Odd number of consecutive percentage signs");
+        return false;
+    }
+
+    return true;
+}
+
+
+} // DB
diff --git a/src/Common/FileRenamer.h b/src/Common/FileRenamer.h
new file mode 100644
index 00000000000..c062978d6f6
--- /dev/null
+++ b/src/Common/FileRenamer.h
@@ -0,0 +1,39 @@
+#pragma once
+
+#include <string>
+#include <base/types.h>
+
+namespace DB
+{
+
+/**
+  * The FileRenamer class provides functionality for renaming files based on given pattern with placeholders
+  * The supported placeholders are:
+  *   %f - Original filename without extension ("sample")
+  *   %e - Original file extension with dot (".csv")
+  *   %t - Timestamp (in microseconds)
+  *   %% - Percentage sign ("%")
+  *
+  * Example:
+  *   Pattern             - "processed_%f_%t%e"
+  *   Original filename   - "sample.csv"
+  *   New filename        - "processed_sample_1683405960646224.csv"
+  */
+class FileRenamer
+{
+public:
+    FileRenamer();
+
+    FileRenamer(const String & renaming_rule);
+
+    String generateNewFilename(const String & filename) const;
+
+    bool isEmpty() const;
+
+    static bool validateRenamingRule(const String & rule, bool throw_on_error = false);
+
+private:
+    String rule;
+};
+
+} // DB
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 69546011770..d0ce641efb5 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -713,6 +713,8 @@ class IColumn;
     M(String, workload, "default", "Name of workload to be used to access resources", 0) \
     M(Milliseconds, storage_system_stack_trace_pipe_read_timeout_ms, 100, "Maximum time to read from a pipe for receiving information from the threads when querying the `system.stack_trace` table. This setting is used for testing purposes and not meant to be changed by users.", 0) \
     \
+    M(String, rename_files_after_processing, "", "Rename successfully processed files according to the specified pattern; Pattern can include the following placeholders: `%f` (original filename without extension), `%e` (file extension with dot), `%t` (current timestamp in µs), and `%%` (% sign)", 0) \
+    \
     M(Bool, parallelize_output_from_storages, true, "Parallelize output for reading step from storage. It allows parallelizing query processing right after reading from storage if possible", 0) \
     M(String, insert_deduplication_token, "", "If not empty, used for duplicate detection instead of data digest", 0) \
     M(String, ann_index_select_query_params, "", "Parameters passed to ANN indexes in SELECT queries, the format is 'param1=x, param2=y, ...'", 0) \
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 425fe6bee31..2ea8da1a873 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -40,6 +40,7 @@
 #include <Common/typeid_cast.h>
 #include <Common/parseGlobs.h>
 #include <Common/filesystemHelpers.h>
+#include <Common/logger_useful.h>
 #include <Common/ProfileEvents.h>
 
 #include <QueryPipeline/Pipe.h>
@@ -76,6 +77,7 @@ namespace ErrorCodes
     extern const int UNKNOWN_IDENTIFIER;
     extern const int INCORRECT_FILE_NAME;
     extern const int FILE_DOESNT_EXIST;
+    extern const int FILE_ALREADY_EXISTS;
     extern const int TIMEOUT_EXCEEDED;
     extern const int INCOMPATIBLE_COLUMNS;
     extern const int CANNOT_STAT;
@@ -460,6 +462,8 @@ StorageFile::StorageFile(const std::string & table_path_, const std::string & us
     else
         path_for_partitioned_write = table_path_;
 
+    file_renamer = FileRenamer(args.rename_after_processing);
+
     setStorageMetadata(args);
 }
 
@@ -593,9 +597,68 @@ public:
             shared_lock = std::shared_lock(storage->rwlock, getLockTimeout(context));
             if (!shared_lock)
                 throw Exception(ErrorCodes::TIMEOUT_EXCEEDED, "Lock timeout exceeded");
+            storage->readers_counter.fetch_add(1, std::memory_order_release);
         }
     }
 
+
+    /**
+      * If specified option --rename_files_after_processing and files created by TableFunctionFile
+      * Last reader will rename files according to specified patten if desctuctor of reader was called without uncaught exceptions
+      */
+    void beforeDestroy()
+    {
+        if (storage->file_renamer.isEmpty())
+            return;
+
+        int32_t cnt = storage->readers_counter.fetch_sub(1, std::memory_order_acq_rel);
+
+        if (std::uncaught_exceptions() == 0 && cnt == 1 && !storage->was_renamed)
+        {
+            shared_lock.unlock();
+            auto exclusive_lock = std::unique_lock{storage->rwlock, getLockTimeout(context)};
+
+            if (!exclusive_lock)
+                return;
+            if (storage->readers_counter.load(std::memory_order_acquire) != 0 || storage->was_renamed)
+                return;
+
+            for (auto & file_path_ref : storage->paths) {
+                try
+                {
+                    auto file_path = fs::path(file_path_ref);
+                    String new_filename = storage->file_renamer.generateNewFilename(file_path.filename().string());
+                    file_path.replace_filename(new_filename);
+
+                    // Normalize new path
+                    file_path = file_path.lexically_normal();
+
+                    // Checking access rights
+                    checkCreationIsAllowed(context, context->getUserFilesPath(), file_path, true);
+
+                    // Checking an existing of new file
+                    if (fs::exists(file_path))
+                        throw Exception(ErrorCodes::FILE_ALREADY_EXISTS, "File {} already exists", file_path.string());
+
+                    fs::rename(fs::path(file_path_ref), file_path);
+                    file_path_ref = file_path.string();
+                    storage->was_renamed = true;
+                }
+                catch (const std::exception & e)
+                {
+                    // Cannot throw exception from destructor, will write only error
+                    LOG_ERROR(&Poco::Logger::get("~StorageFileSource"), "Failed to rename file {}: {}", file_path_ref, e.what());
+                    continue;
+                }
+            }
+        }
+    }
+
+    ~StorageFileSource() override
+    {
+        beforeDestroy();
+    }
+
     String getName() const override
     {
         return storage->getName();
@@ -1217,6 +1280,7 @@ void registerStorageFile(StorageFactory & factory)
                 factory_args.columns,
                 factory_args.constraints,
                 factory_args.comment,
+                {},
             };
 
             ASTs & engine_args_ast = factory_args.engine_args;
diff --git a/src/Storages/StorageFile.h b/src/Storages/StorageFile.h
index 53ce7eeaaf6..0513864fd0f 100644
--- a/src/Storages/StorageFile.h
+++ b/src/Storages/StorageFile.h
@@ -2,12 +2,11 @@
 
 #include <Storages/IStorage.h>
 #include <Storages/Cache/SchemaCache.h>
-
+#include <Common/FileRenamer.h>
 
 #include <atomic>
 #include <shared_mutex>
 
-
 namespace DB
 {
 
@@ -23,6 +22,8 @@ public:
         const ColumnsDescription & columns;
         const ConstraintsDescription & constraints;
         const String & comment;
+
+        const std::string rename_after_processing;
     };
 
     /// From file descriptor
@@ -139,6 +140,11 @@ private:
     std::unique_ptr<ReadBuffer> read_buffer_from_fd;
     std::unique_ptr<ReadBuffer> peekable_read_buffer_from_fd;
     std::atomic<bool> has_peekable_read_buffer_from_fd = false;
+
+    // Counts the number of readers
+    std::atomic<int32_t> readers_counter = 0;
+    FileRenamer file_renamer;
+    bool was_renamed = false;
 };
 
 }
diff --git a/src/TableFunctions/TableFunctionFile.cpp b/src/TableFunctions/TableFunctionFile.cpp
index ff64bb3dc67..0e49f26db40 100644
--- a/src/TableFunctions/TableFunctionFile.cpp
+++ b/src/TableFunctions/TableFunctionFile.cpp
@@ -75,6 +75,7 @@ StoragePtr TableFunctionFile::getStorage(const String & source,
         columns,
         ConstraintsDescription{},
         String{},
+        global_context->getSettingsRef().rename_files_after_processing,
     };
     if (fd >= 0)
         return std::make_shared<StorageFile>(fd, args);

From 7b3964ff7a63ce6a4027f0dfb8f06c019239ac1c Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Sun, 7 May 2023 14:59:40 +0000
Subject: [PATCH 100/722] Added test

---
 .../02732_rename_after_processing.reference   | 17 ++++
 .../02732_rename_after_processing.sh          | 77 +++++++++++++++++++
 2 files changed, 94 insertions(+)
 create mode 100644 tests/queries/0_stateless/02732_rename_after_processing.reference
 create mode 100755 tests/queries/0_stateless/02732_rename_after_processing.sh

diff --git a/tests/queries/0_stateless/02732_rename_after_processing.reference b/tests/queries/0_stateless/02732_rename_after_processing.reference
new file mode 100644
index 00000000000..26e152f6b10
--- /dev/null
+++ b/tests/queries/0_stateless/02732_rename_after_processing.reference
@@ -0,0 +1,17 @@
+4
+processed_tmp1.csv
+OK
+10	10
+processed_tmp2.csv
+OK
+8
+processed_tmp3_1.csv
+processed_tmp3_2.csv
+OK
+OK
+4
+OK
+OK
+tmp5.csv
+OK
+tmp5.csv
diff --git a/tests/queries/0_stateless/02732_rename_after_processing.sh b/tests/queries/0_stateless/02732_rename_after_processing.sh
new file mode 100755
index 00000000000..05fbfb716ec
--- /dev/null
+++ b/tests/queries/0_stateless/02732_rename_after_processing.sh
@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+# Tags: no-parallel
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+# see 01658_read_file_to_stringcolumn.sh
+CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from file('nonexist.txt', 'CSV', 'val1 char')" 2>&1 | grep Exception | awk '{gsub("/nonexist.txt","",$9); print $9}')
+
+# Prepare data
+mkdir -p ${CLICKHOUSE_USER_FILES_PATH}
+echo '"id","str","int","text"' > ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '1,"abc",123,"abacaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '2,"def",456,"bacabaa"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '3,"story",78912,"acabaab"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+echo '4,"history",21321321,"cabaaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp1.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp2.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp3_1.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp3_2.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp4.csv
+cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv
+
+### Checking that renaming works
+
+# simple select
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('tmp1.csv')"
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp1.csv"
+if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp1.csv" ]; then
+  echo "OK"
+fi
+
+# select with multiple file() calls
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" --multiline -q  """
+SELECT
+    sum(a.id) as aid,
+    sum(b.id) as bid
+FROM file('tmp2.csv') AS a
+INNER JOIN file('tmp2.csv') AS b
+ON a.text = b.text
+"""
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp2.csv"
+if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp2.csv" ]; then
+  echo "OK"
+fi
+
+# rename multiple files
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('tmp3*.csv')"
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp3_1.csv"
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp3_2.csv"
+if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp3_1.csv" ]; then
+  echo "OK"
+fi
+if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp3_2.csv" ]; then
+  echo "OK"
+fi
+
+# check timestamp placeholder
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f_%t.csv" -q "SELECT COUNT(*) FROM file('tmp4.csv')"
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep -E "^processed_tmp4_[0-9]+\.csv$" > /dev/null && echo "OK"
+
+### Checking errors
+
+# cannot overwrite an existing file
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="tmp.csv" -q "SELECT COUNT(*) FROM file('tmp5.csv')" \
+    2>&1| grep "already exists" > /dev/null && echo "OK"
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep "tmp5.csv"
+
+# сannot move file from user_files
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="../%f%e" -q "SELECT COUNT(*) FROM file('tmp5.csv')" \
+    2>&1| grep "is not inside" > /dev/null && echo "OK"
+ls ${CLICKHOUSE_USER_FILES_PATH} | grep "tmp5.csv"
+
+# Clean
+rm -rd $CLICKHOUSE_USER_FILES_PATH
\ No newline at end of file

From 2b68a6a22a84329f639af953e1fdaad9a6e21584 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Sun, 7 May 2023 17:43:34 +0000
Subject: [PATCH 101/722] Fix style

---
 src/Common/FileRenamer.cpp                    |  5 +--
 src/Storages/StorageFile.cpp                  |  5 ++-
 .../02732_rename_after_processing.reference   |  8 ++--
 .../02732_rename_after_processing.sh          | 43 +++++++++++++------
 4 files changed, 39 insertions(+), 22 deletions(-)

diff --git a/src/Common/FileRenamer.cpp b/src/Common/FileRenamer.cpp
index 7a19c50a0d1..3473d543c00 100644
--- a/src/Common/FileRenamer.cpp
+++ b/src/Common/FileRenamer.cpp
@@ -8,7 +8,6 @@
 #include <format>
 #include <map>
 #include <re2/re2.h>
-#include <sstream>
 
 #include <boost/algorithm/string.hpp>
 #include <boost/algorithm/string/replace.hpp>
@@ -42,9 +41,7 @@ String FileRenamer::generateNewFilename(const String & filename) const
     if (rule.find("%t") != String::npos)
     {
         auto now = std::chrono::system_clock::now();
-        std::stringstream ss;
-        ss << timeInMicroseconds(now);
-        timestamp = ss.str();
+        timestamp = std::to_string(timeInMicroseconds(now));
     }
 
     // Define placeholders and their corresponding values
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 2ea8da1a873..06af0a00953 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -604,7 +604,7 @@ public:
 
     /**
       * If specified option --rename_files_after_processing and files created by TableFunctionFile
-      * Last reader will rename files according to specified patten if desctuctor of reader was called without uncaught exceptions
+      * Last reader will rename files according to specified pattern if desctuctor of reader was called without uncaught exceptions
       */
     void beforeDestroy()
     {
@@ -623,7 +623,8 @@ public:
             if (storage->readers_counter.load(std::memory_order_acquire) != 0 || storage->was_renamed)
                 return;
 
-            for (auto & file_path_ref : storage->paths) {
+            for (auto & file_path_ref : storage->paths)
+            {
                 try
                 {
                     auto file_path = fs::path(file_path_ref);
diff --git a/tests/queries/0_stateless/02732_rename_after_processing.reference b/tests/queries/0_stateless/02732_rename_after_processing.reference
index 26e152f6b10..2f6ccfc1c5e 100644
--- a/tests/queries/0_stateless/02732_rename_after_processing.reference
+++ b/tests/queries/0_stateless/02732_rename_after_processing.reference
@@ -1,14 +1,14 @@
 4
 processed_tmp1.csv
-OK
+!tmp1.csv
 10	10
 processed_tmp2.csv
-OK
+!tmp2.csv
 8
 processed_tmp3_1.csv
 processed_tmp3_2.csv
-OK
-OK
+!tmp3_1.csv
+!tmp3_2.csv
 4
 OK
 OK
diff --git a/tests/queries/0_stateless/02732_rename_after_processing.sh b/tests/queries/0_stateless/02732_rename_after_processing.sh
index 05fbfb716ec..93bad2eac7d 100755
--- a/tests/queries/0_stateless/02732_rename_after_processing.sh
+++ b/tests/queries/0_stateless/02732_rename_after_processing.sh
@@ -27,9 +27,11 @@ cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv
 
 # simple select
 ${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('tmp1.csv')"
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp1.csv"
+if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp1.csv" ]; then
+  echo "processed_tmp1.csv"
+fi
 if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp1.csv" ]; then
-  echo "OK"
+  echo "!tmp1.csv"
 fi
 
 # select with multiple file() calls
@@ -41,37 +43,54 @@ FROM file('tmp2.csv') AS a
 INNER JOIN file('tmp2.csv') AS b
 ON a.text = b.text
 """
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp2.csv"
+if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp2.csv" ]; then
+  echo "processed_tmp2.csv"
+fi
 if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp2.csv" ]; then
-  echo "OK"
+    echo "!tmp2.csv"
 fi
 
 # rename multiple files
 ${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('tmp3*.csv')"
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp3_1.csv"
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep "processed_tmp3_2.csv"
+if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp3_1.csv" ]; then
+    echo "processed_tmp3_1.csv"
+fi
+if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp3_2.csv" ]; then
+    echo "processed_tmp3_2.csv"
+fi
 if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp3_1.csv" ]; then
-  echo "OK"
+    echo "!tmp3_1.csv"
 fi
 if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp3_2.csv" ]; then
-  echo "OK"
+    echo "!tmp3_2.csv"
 fi
 
 # check timestamp placeholder
 ${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f_%t.csv" -q "SELECT COUNT(*) FROM file('tmp4.csv')"
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep -E "^processed_tmp4_[0-9]+\.csv$" > /dev/null && echo "OK"
+# ls ${CLICKHOUSE_USER_FILES_PATH} | grep -E "^processed_tmp4_[0-9]+\.csv$" > /dev/null && echo "OK"
+rg="processed_tmp4_[0-9]+\.csv"
+for x in "${CLICKHOUSE_USER_FILES_PATH}"/processed*; do
+    if [[ $x =~ $rg ]]; then
+        echo "OK"
+        break
+    fi;
+done
 
 ### Checking errors
 
 # cannot overwrite an existing file
 ${CLICKHOUSE_CLIENT} --rename-files-after-processing="tmp.csv" -q "SELECT COUNT(*) FROM file('tmp5.csv')" \
     2>&1| grep "already exists" > /dev/null && echo "OK"
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep "tmp5.csv"
+if [ -e "${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv" ]; then
+    echo "tmp5.csv"
+fi
 
 # сannot move file from user_files
 ${CLICKHOUSE_CLIENT} --rename-files-after-processing="../%f%e" -q "SELECT COUNT(*) FROM file('tmp5.csv')" \
     2>&1| grep "is not inside" > /dev/null && echo "OK"
-ls ${CLICKHOUSE_USER_FILES_PATH} | grep "tmp5.csv"
+if [ -e "${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv" ]; then
+    echo "tmp5.csv"
+fi
 
 # Clean
-rm -rd $CLICKHOUSE_USER_FILES_PATH
\ No newline at end of file
+rm -rd $CLICKHOUSE_USER_FILES_PATH

From eb7b48aab20172b79b1573c05c8a4baa02fe0804 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Tue, 16 May 2023 18:48:39 +0000
Subject: [PATCH 102/722] Fix test issues

---
 .../02732_rename_after_processing.reference   |  4 +
 .../02732_rename_after_processing.sh          | 85 +++++++++++--------
 2 files changed, 55 insertions(+), 34 deletions(-)

diff --git a/tests/queries/0_stateless/02732_rename_after_processing.reference b/tests/queries/0_stateless/02732_rename_after_processing.reference
index 2f6ccfc1c5e..39cdb677e09 100644
--- a/tests/queries/0_stateless/02732_rename_after_processing.reference
+++ b/tests/queries/0_stateless/02732_rename_after_processing.reference
@@ -15,3 +15,7 @@ OK
 tmp5.csv
 OK
 tmp5.csv
+OK
+tmp5.csv
+OK
+tmp5.csv
diff --git a/tests/queries/0_stateless/02732_rename_after_processing.sh b/tests/queries/0_stateless/02732_rename_after_processing.sh
index 93bad2eac7d..dbf2427d2dc 100755
--- a/tests/queries/0_stateless/02732_rename_after_processing.sh
+++ b/tests/queries/0_stateless/02732_rename_after_processing.sh
@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-# Tags: no-parallel
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
@@ -9,28 +8,30 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from file('nonexist.txt', 'CSV', 'val1 char')" 2>&1 | grep Exception | awk '{gsub("/nonexist.txt","",$9); print $9}')
 
 # Prepare data
-mkdir -p ${CLICKHOUSE_USER_FILES_PATH}
-echo '"id","str","int","text"' > ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '1,"abc",123,"abacaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '2,"def",456,"bacabaa"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '3,"story",78912,"acabaab"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '4,"history",21321321,"cabaaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+unique_name=${CLICKHOUSE_TEST_UNIQUE_NAME}
+tmp_dir=${CLICKHOUSE_USER_FILES_PATH}/${unique_name}
+mkdir -p $tmp_dir
+echo '"id","str","int","text"' > ${tmp_dir}/tmp.csv
+echo '1,"abc",123,"abacaba"' >> ${tmp_dir}/tmp.csv
+echo '2,"def",456,"bacabaa"' >> ${tmp_dir}/tmp.csv
+echo '3,"story",78912,"acabaab"' >> ${tmp_dir}/tmp.csv
+echo '4,"history",21321321,"cabaaba"' >> ${tmp_dir}/tmp.csv
 
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp1.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp2.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp3_1.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp3_2.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp4.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv
+cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp1.csv
+cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp2.csv
+cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp3_1.csv
+cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp3_2.csv
+cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp4.csv
+cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp5.csv
 
 ### Checking that renaming works
 
 # simple select
-${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('tmp1.csv')"
-if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp1.csv" ]; then
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp1.csv')"
+if [ -e "${tmp_dir}/processed_tmp1.csv" ]; then
   echo "processed_tmp1.csv"
 fi
-if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp1.csv" ]; then
+if [ ! -e "${tmp_dir}/tmp1.csv" ]; then
   echo "!tmp1.csv"
 fi
 
@@ -39,37 +40,37 @@ ${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" --multilin
 SELECT
     sum(a.id) as aid,
     sum(b.id) as bid
-FROM file('tmp2.csv') AS a
-INNER JOIN file('tmp2.csv') AS b
+FROM file('${unique_name}/tmp2.csv') AS a
+INNER JOIN file('${unique_name}/tmp2.csv') AS b
 ON a.text = b.text
 """
-if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp2.csv" ]; then
+if [ -e "${tmp_dir}/processed_tmp2.csv" ]; then
   echo "processed_tmp2.csv"
 fi
-if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp2.csv" ]; then
+if [ ! -e "${tmp_dir}/tmp2.csv" ]; then
     echo "!tmp2.csv"
 fi
 
 # rename multiple files
-${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('tmp3*.csv')"
-if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp3_1.csv" ]; then
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f%e" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp3*.csv')"
+if [ -e "${tmp_dir}/processed_tmp3_1.csv" ]; then
     echo "processed_tmp3_1.csv"
 fi
-if [ -e "${CLICKHOUSE_USER_FILES_PATH}/processed_tmp3_2.csv" ]; then
+if [ -e "${tmp_dir}/processed_tmp3_2.csv" ]; then
     echo "processed_tmp3_2.csv"
 fi
-if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp3_1.csv" ]; then
+if [ ! -e "${tmp_dir}/tmp3_1.csv" ]; then
     echo "!tmp3_1.csv"
 fi
-if [ ! -e "${CLICKHOUSE_USER_FILES_PATH}/tmp3_2.csv" ]; then
+if [ ! -e "${tmp_dir}/tmp3_2.csv" ]; then
     echo "!tmp3_2.csv"
 fi
 
 # check timestamp placeholder
-${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f_%t.csv" -q "SELECT COUNT(*) FROM file('tmp4.csv')"
-# ls ${CLICKHOUSE_USER_FILES_PATH} | grep -E "^processed_tmp4_[0-9]+\.csv$" > /dev/null && echo "OK"
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f_%t.csv" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp4.csv')"
+# ls ${tmp_dir} | grep -E "^processed_tmp4_[0-9]+\.csv$" > /dev/null && echo "OK"
 rg="processed_tmp4_[0-9]+\.csv"
-for x in "${CLICKHOUSE_USER_FILES_PATH}"/processed*; do
+for x in "${tmp_dir}"/processed*; do
     if [[ $x =~ $rg ]]; then
         echo "OK"
         break
@@ -79,18 +80,34 @@ done
 ### Checking errors
 
 # cannot overwrite an existing file
-${CLICKHOUSE_CLIENT} --rename-files-after-processing="tmp.csv" -q "SELECT COUNT(*) FROM file('tmp5.csv')" \
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="tmp.csv" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp5.csv')" \
     2>&1| grep "already exists" > /dev/null && echo "OK"
-if [ -e "${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv" ]; then
+if [ -e "${tmp_dir}/tmp5.csv" ]; then
     echo "tmp5.csv"
 fi
 
-# сannot move file from user_files
-${CLICKHOUSE_CLIENT} --rename-files-after-processing="../%f%e" -q "SELECT COUNT(*) FROM file('tmp5.csv')" \
+# сannot move file outside user_files
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="../../%f%e" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp5.csv')" \
     2>&1| grep "is not inside" > /dev/null && echo "OK"
-if [ -e "${CLICKHOUSE_USER_FILES_PATH}/tmp5.csv" ]; then
+if [ -e "${tmp_dir}/tmp5.csv" ]; then
+    echo "tmp5.csv"
+fi
+
+# check invalid placeholders
+
+# unknown type of placeholder (%k)
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f_%k" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp5.csv')" \
+    2>&1| grep "Allowed placeholders only" > /dev/null && echo "OK"
+if [ -e "${tmp_dir}/tmp5.csv" ]; then
+    echo "tmp5.csv"
+fi
+
+# dd number of consecutive percentage signs after replace valid placeholders
+${CLICKHOUSE_CLIENT} --rename-files-after-processing="processed_%f_%%%%e" -q "SELECT COUNT(*) FROM file('${unique_name}/tmp5.csv')" \
+    2>&1| grep "Odd number of consecutive percentage signs" > /dev/null && echo "OK"
+if [ -e "${tmp_dir}/tmp5.csv" ]; then
     echo "tmp5.csv"
 fi
 
 # Clean
-rm -rd $CLICKHOUSE_USER_FILES_PATH
+rm -rd $tmp_dir

From 5e33dd5d5c9eace011d4c729e3c760c017955de9 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Wed, 17 May 2023 19:14:46 +0000
Subject: [PATCH 103/722] Added chmod for tmp dir and files in test

---
 tests/queries/0_stateless/02732_rename_after_processing.sh | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/tests/queries/0_stateless/02732_rename_after_processing.sh b/tests/queries/0_stateless/02732_rename_after_processing.sh
index dbf2427d2dc..4c87070cd35 100755
--- a/tests/queries/0_stateless/02732_rename_after_processing.sh
+++ b/tests/queries/0_stateless/02732_rename_after_processing.sh
@@ -11,12 +11,18 @@ CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from
 unique_name=${CLICKHOUSE_TEST_UNIQUE_NAME}
 tmp_dir=${CLICKHOUSE_USER_FILES_PATH}/${unique_name}
 mkdir -p $tmp_dir
+rm -rf ${tmp_dir}/*
+
+chmod 777 ${tmp_dir}
+
 echo '"id","str","int","text"' > ${tmp_dir}/tmp.csv
 echo '1,"abc",123,"abacaba"' >> ${tmp_dir}/tmp.csv
 echo '2,"def",456,"bacabaa"' >> ${tmp_dir}/tmp.csv
 echo '3,"story",78912,"acabaab"' >> ${tmp_dir}/tmp.csv
 echo '4,"history",21321321,"cabaaba"' >> ${tmp_dir}/tmp.csv
 
+chmod 777 ${tmp_dir}/tmp.csv
+
 cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp1.csv
 cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp2.csv
 cp ${tmp_dir}/tmp.csv ${tmp_dir}/tmp3_1.csv

From 4550a705f97497607a627f5cca8f265b650abdc1 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Wed, 17 May 2023 19:49:17 +0000
Subject: [PATCH 104/722] Fix style

---
 tests/queries/0_stateless/02732_rename_after_processing.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02732_rename_after_processing.sh b/tests/queries/0_stateless/02732_rename_after_processing.sh
index 4c87070cd35..c4f80d3462b 100755
--- a/tests/queries/0_stateless/02732_rename_after_processing.sh
+++ b/tests/queries/0_stateless/02732_rename_after_processing.sh
@@ -11,7 +11,7 @@ CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from
 unique_name=${CLICKHOUSE_TEST_UNIQUE_NAME}
 tmp_dir=${CLICKHOUSE_USER_FILES_PATH}/${unique_name}
 mkdir -p $tmp_dir
-rm -rf ${tmp_dir}/*
+rm -rf ${tmp_dir:?}/*
 
 chmod 777 ${tmp_dir}
 

From 900d50633d9c541eff5ac05bdef19cd84e3d6c16 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Wed, 17 May 2023 20:15:26 +0000
Subject: [PATCH 105/722] retrigger checks


From 5368355c659ef2f502ea9787593700c1ae03067d Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Fri, 19 May 2023 16:05:51 +0000
Subject: [PATCH 106/722] Marked test as broken due to fail of the new analyzer

---
 tests/broken_tests.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index e61c1316e17..cef8f68b210 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -137,3 +137,4 @@
 01600_parts_types_metrics_long
 01287_max_execution_speed
 02703_row_policy_for_database
+02732_rename_after_processing

From f459ac5517bcac49c7e6d583fca827504d2b0aa1 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Sat, 20 May 2023 01:38:35 +0200
Subject: [PATCH 107/722] resolve ambiguity by adding a section to docs

---
 docs/en/operations/settings/settings.md | 20 ++++++++++++++++++++
 docs/ru/operations/settings/settings.md | 20 ++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index cf9209e182f..9cca1ee5ec3 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4077,6 +4077,26 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 1999-12-13 07:23:23.123
 ```
 
+:::warning
+The way this setting affects parsing of Date or DateTime types may seem non-obvious, see example and explanation below:
+:::
+
+```sql
+CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');
+
+SELECT *, timezone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
+0 rows in set.
+
+SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
+┌───────────────────d─┬─timezone()───────┐
+│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
+└─────────────────────┴──────────────────┘
+```
+
+This happens due to different parsing pipelines:
+  - `toDateTime('2000-01-01 00:00:00')` creates a new DateTime in a usual way, and thus `session_timezone` setting from query context is applied.
+  - `2000-01-01 00:00:00` is parsed to a DateTime inheriting type of `d` column, including DateTime's time zone, and `session_timezone` has no impact on this value.
+
 Possible values:
 
 -    Any timezone name from `system.time_zones`, e.g. `Europe/Berlin`, `UTC` or `Zulu`
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 98486847fd9..607082054cc 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4105,6 +4105,26 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 
 Значение по умолчанию: `''`.
 
+:::warning
+То, как этот параметр влияет на парсинг значений типа Date или DateTime, может показаться неочевидным. Пример и пояснение см. ниже:
+:::
+
+```sql
+CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');
+
+SELECT *, timezone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
+0 rows in set.
+
+SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
+┌───────────────────d─┬─timezone()───────┐
+│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
+└─────────────────────┴──────────────────┘
+```
+
+Это происходит из-за различного происхождения значения, используемого для сравнения:
+- `toDateTime('2000-01-01 00:00:00')` создаёт значение типа `DateTime` как и в любом другом случае, в том числе применяет параметр `session_timezone` из контекста запроса,
+- `2000-01-01 00:00:00` парсится в `DateTime` того же типа, что и колонка `d` (в том числе с той же `timezone`), и параметр `session_timezone` в данном случае не учитывается.
+
 **Смотрите также**
 
 - [timezone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone)
\ No newline at end of file

From af5793b26e0ee8fc02201f8d0439b5a15a019e7f Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Sat, 20 May 2023 16:38:45 +0200
Subject: [PATCH 108/722] fix incode docs

---
 src/Functions/serverConstants.cpp | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index 1460fc16265..9cd43be50c4 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -160,31 +160,33 @@ REGISTER_FUNCTION(TcpPort)
 
 REGISTER_FUNCTION(Timezone)
 {
-    factory.registerFunction<FunctionTimezone>({
-        R"(
+    factory.registerFunction<FunctionTimezone>(
+        FunctionDocumentation{
+        .description=R"(
 Returns the default timezone for current session.
 Used as default timezone for parsing DateTime|DateTime64 without explicitly specified timezone.
 Can be changed with SET timezone = 'New/Tz'
 
 [example:timezone]
-)",
-        Documentation::Examples{{"timezone", "SELECT timezone();"}},
-        Documentation::Categories{"Constant", "Miscellaneous"}
-    });
-    factory.registerAlias("timeZone", "timezone");
+    )",
+    .examples{{"timezone", "SELECT timezone();", ""}},
+    .categories{"Constant", "Miscellaneous"}
+});
+factory.registerAlias("timeZone", "timezone");
 }
 
 REGISTER_FUNCTION(ServerTimezone)
 {
-    factory.registerFunction<FunctionServerTimezone>({
-        R"(
+    factory.registerFunction<FunctionServerTimezone>(
+    FunctionDocumentation{
+        .description=R"(
 Returns the timezone name in which server operates.
 
 [example:serverTimezone]
-)",
-         Documentation::Examples{{"serverTimezone", "SELECT serverTimezone();"}},
-         Documentation::Categories{"Constant", "Miscellaneous"}
-    });
+    )",
+     .examples{{"serverTimezone", "SELECT serverTimezone();", ""}},
+     .categories{"Constant", "Miscellaneous"}
+});
     factory.registerAlias("serverTimeZone", "serverTimezone");
     factory.registerAlias("servertimezone", "serverTimezone");
 }

From 24320f8f93f56aa9a7088c4daf80a066facdc5b6 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Sun, 21 May 2023 15:58:29 +0000
Subject: [PATCH 109/722] fixed bad pattern in tests

---
 .../0_stateless/02722_database_filesystem.sh  | 29 ++++++++++---------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/tests/queries/0_stateless/02722_database_filesystem.sh b/tests/queries/0_stateless/02722_database_filesystem.sh
index 80f97af693e..7466141d3e3 100755
--- a/tests/queries/0_stateless/02722_database_filesystem.sh
+++ b/tests/queries/0_stateless/02722_database_filesystem.sh
@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-# Tags: no-parallel
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
@@ -9,19 +8,21 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from file('nonexist.txt', 'CSV', 'val1 char')" 2>&1 | grep Exception | awk '{gsub("/nonexist.txt","",$9); print $9}')
 
 # Prepare data
-mkdir -p ${CLICKHOUSE_USER_FILES_PATH}/tmp/
-echo '"id","str","int","text"' > ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '1,"abc",123,"abacaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '2,"def",456,"bacabaa"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '3,"story",78912,"acabaab"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
-echo '4,"history",21321321,"cabaaba"' >> ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv
+unique_name=${CLICKHOUSE_TEST_UNIQUE_NAME}
+user_files_tmp_dir=${CLICKHOUSE_USER_FILES_PATH}/${unique_name}
+mkdir -p ${user_files_tmp_dir}/tmp/
+echo '"id","str","int","text"' > ${user_files_tmp_dir}/tmp.csv
+echo '1,"abc",123,"abacaba"' >> ${user_files_tmp_dir}/tmp.csv
+echo '2,"def",456,"bacabaa"' >> ${user_files_tmp_dir}/tmp.csv
+echo '3,"story",78912,"acabaab"' >> ${user_files_tmp_dir}/tmp.csv
+echo '4,"history",21321321,"cabaaba"' >> ${user_files_tmp_dir}/tmp.csv
 
 tmp_dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
 [[ -d $tmp_dir ]] && rm -rd $tmp_dir
 mkdir $tmp_dir
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${tmp_dir}/tmp.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp/tmp.csv
-cp ${CLICKHOUSE_USER_FILES_PATH}/tmp.csv ${CLICKHOUSE_USER_FILES_PATH}/tmp.myext
+cp ${user_files_tmp_dir}/tmp.csv ${tmp_dir}/tmp.csv
+cp ${user_files_tmp_dir}/tmp.csv ${user_files_tmp_dir}/tmp/tmp.csv
+cp ${user_files_tmp_dir}/tmp.csv ${user_files_tmp_dir}/tmp.myext
 
 #################
 echo "Test 1: create filesystem database and check implicit calls"
@@ -31,8 +32,8 @@ CREATE DATABASE test1 ENGINE = Filesystem;
 """
 echo $?
 ${CLICKHOUSE_CLIENT} --query "SHOW DATABASES" | grep "test1"
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp.csv\`;"
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp/tmp.csv\`;"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`${unique_name}/tmp.csv\`;"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`${unique_name}/tmp/tmp.csv\`;"
 ${CLICKHOUSE_LOCAL} -q "SELECT COUNT(*) FROM \"${tmp_dir}/tmp.csv\""
 
 #################
@@ -62,9 +63,9 @@ CREATE DATABASE test2 ENGINE = Filesystem('relative_unknown_dir');
 ${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp2.csv\`;" 2>&1| grep -F "Code: 107" > /dev/null && echo "OK"
 
 # BAD_ARGUMENTS: Cannot determine the file format by it's extension
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp.myext\`;" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
+${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`${unique_name}/tmp.myext\`;" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
 
 # Clean
 ${CLICKHOUSE_CLIENT} --query "DROP DATABASE test1;"
 rm -rd $tmp_dir
-rm -rd $CLICKHOUSE_USER_FILES_PATH
+rm -rd $user_files_tmp_dir

From 8c816a5c4a97044b1d3d902145ef4eefecd7beb8 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 22 May 2023 01:00:40 +0200
Subject: [PATCH 110/722] update

---
 src/Common/DateLUT.h              | 37 ++++++++++++++++---------------
 src/Core/Settings.h               |  2 +-
 src/Functions/serverConstants.cpp |  4 +---
 src/IO/ReadHelpers.h              |  4 ++--
 4 files changed, 23 insertions(+), 24 deletions(-)

diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index 59b280240ea..23698331afe 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -17,30 +17,24 @@
 class DateLUT : private boost::noncopyable
 {
 public:
-    /// Return singleton DateLUTImpl instance for server's (native) time zone.
-    static ALWAYS_INLINE const DateLUTImpl & serverTimezoneInstance()
-    {
-        const auto & date_lut = getInstance();
-        return *date_lut.default_impl.load(std::memory_order_acquire);
-    }
-
-    /// Return singleton DateLUTImpl instance for timezone set by `timezone` setting for current session is used.
-    /// If it is not set, server's timezone (the one which server has) is being used.
+    /// Return singleton DateLUTImpl instance for session timezone.
+    /// The session timezone is configured by a session setting.
+    /// If not set (empty string), it is the server timezone.
     static ALWAYS_INLINE const DateLUTImpl & instance()
     {
         const auto & date_lut = getInstance();
 
         if (DB::CurrentThread::isInitialized())
         {
-            std::string effective_time_zone;
-            const auto query_context = DB::CurrentThread::get().getQueryContext();
+            std::string context_timezone;
+            const DB::ContextPtr query_context = DB::CurrentThread::get().getQueryContext();
 
             if (query_context)
             {
-                effective_time_zone = extractTimezoneFromContext(query_context);
+                context_timezone = extractTimezoneFromContext(query_context);
 
-                if (!effective_time_zone.empty())
-                    return date_lut.getImplementation(effective_time_zone);
+                if (!context_timezone.empty())
+                    return date_lut.getImplementation(context_timezone);
             }
 
             /// Timezone is passed in query_context, but on CH-Client we have no query context,
@@ -48,10 +42,10 @@ public:
             const auto global_context = DB::CurrentThread::get().getGlobalContext();
             if (global_context)
             {
-                effective_time_zone = extractTimezoneFromContext(global_context);
+                context_timezone = extractTimezoneFromContext(global_context);
 
-                if (!effective_time_zone.empty())
-                    return date_lut.getImplementation(effective_time_zone);
+                if (!context_timezone.empty())
+                    return date_lut.getImplementation(context_timezone);
             }
 
         }
@@ -67,6 +61,13 @@ public:
         return date_lut.getImplementation(time_zone);
     }
 
+    // Return singleton DateLUTImpl for the server time zone.
+    static ALWAYS_INLINE const DateLUTImpl & serverTimezoneInstance()
+    {
+        const auto & date_lut = getInstance();
+        return *date_lut.default_impl.load(std::memory_order_acquire);
+    }
+
     static void setDefaultTimezone(const std::string & time_zone)
     {
         auto & date_lut = getInstance();
@@ -80,7 +81,7 @@ protected:
 private:
     static DateLUT & getInstance();
 
-    static std::string extractTimezoneFromContext(const DB::ContextPtr query_context);
+    static std::string extractTimezoneFromContext(DB::ContextPtr query_context);
 
     const DateLUTImpl & getImplementation(const std::string & time_zone) const;
 
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 90063f8efd4..2d766e8e18f 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -747,7 +747,7 @@ class IColumn;
     M(Bool, allow_experimental_undrop_table_query, false, "Allow to use undrop query to restore dropped table in a limited time", 0) \
     M(Bool, keeper_map_strict_mode, false, "Enforce additional checks during operations on KeeperMap. E.g. throw an exception on an insert for already existing key", 0) \
     M(UInt64, extract_kvp_max_pairs_per_row, 1000, "Max number pairs that can be produced by extractKeyValuePairs function. Used to safeguard against consuming too much memory.", 0) \
-    M(Timezone, session_timezone, "", "Use specified timezone for interpreting Date and DateTime instead of server's timezone in current session.", 0) \
+    M(Timezone, session_timezone, "", "The default timezone for the current session. The server default timezone, if empty.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index 9cd43be50c4..d3e1e6e10fe 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -60,7 +60,7 @@ namespace
     };
 
 
-    /// Returns default timezone for current session.
+    /// Returns timezone for current session.
     class FunctionTimezone : public FunctionConstantBase<FunctionTimezone, String, DataTypeString>
     {
     public:
@@ -187,8 +187,6 @@ Returns the timezone name in which server operates.
      .examples{{"serverTimezone", "SELECT serverTimezone();", ""}},
      .categories{"Constant", "Miscellaneous"}
 });
-    factory.registerAlias("serverTimeZone", "serverTimezone");
-    factory.registerAlias("servertimezone", "serverTimezone");
 }
 
 REGISTER_FUNCTION(Uptime)
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 3bd9275322e..cbe18e11c9a 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -706,7 +706,7 @@ inline void convertToDayNum(DayNum & date, ExtendedDayNum & from)
 }
 
 template <typename ReturnType = void>
-inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
+inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut)
 {
     static constexpr bool throw_exception = std::is_same_v<ReturnType, void>;
 
@@ -723,7 +723,7 @@ inline ReturnType readDateTextImpl(DayNum & date, ReadBuffer & buf, const DateLU
 }
 
 template <typename ReturnType = void>
-inline ReturnType readDateTextImpl(ExtendedDayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut = DateLUT::instance())
+inline ReturnType readDateTextImpl(ExtendedDayNum & date, ReadBuffer & buf, const DateLUTImpl & date_lut)
 {
     static constexpr bool throw_exception = std::is_same_v<ReturnType, void>;
 

From 183f90e45a7601e5ad4af63b24dabfc506a637ae Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Mon, 22 May 2023 02:02:09 +0000
Subject: [PATCH 111/722] Update MongoDB protocol

---
 .../Foundation/include/Poco/BinaryReader.h    |   3 +
 .../Foundation/include/Poco/BinaryWriter.h    |   5 +
 base/poco/Foundation/src/BinaryReader.cpp     |  25 ++
 base/poco/Foundation/src/BinaryWriter.cpp     |  11 +-
 base/poco/MongoDB/CMakeLists.txt              |   1 +
 .../poco/MongoDB/include/Poco/MongoDB/Array.h |  36 +-
 .../MongoDB/include/Poco/MongoDB/Binary.h     |   2 +-
 .../MongoDB/include/Poco/MongoDB/Connection.h |  22 +-
 .../MongoDB/include/Poco/MongoDB/Cursor.h     |   3 +
 .../MongoDB/include/Poco/MongoDB/Database.h   |  83 +++-
 .../MongoDB/include/Poco/MongoDB/Document.h   |  27 +-
 .../MongoDB/include/Poco/MongoDB/Element.h    |   6 +-
 .../include/Poco/MongoDB/JavaScriptCode.h     |   2 +-
 .../include/Poco/MongoDB/MessageHeader.h      |  11 +-
 .../MongoDB/include/Poco/MongoDB/MongoDB.h    |  12 +
 .../MongoDB/include/Poco/MongoDB/ObjectId.h   |   2 +-
 .../include/Poco/MongoDB/OpMsgCursor.h        |  96 ++++
 .../include/Poco/MongoDB/OpMsgMessage.h       | 163 +++++++
 .../Poco/MongoDB/PoolableConnectionFactory.h  |  16 +
 .../include/Poco/MongoDB/RegularExpression.h  |   2 +-
 .../include/Poco/MongoDB/ResponseMessage.h    |   3 +
 base/poco/MongoDB/src/Array.cpp               |   4 +-
 base/poco/MongoDB/src/Connection.cpp          |  26 ++
 base/poco/MongoDB/src/Cursor.cpp              |   6 +
 base/poco/MongoDB/src/Database.cpp            |  48 +-
 base/poco/MongoDB/src/DeleteRequest.cpp       |   4 +-
 base/poco/MongoDB/src/Document.cpp            |  14 +-
 base/poco/MongoDB/src/Element.cpp             |   2 +-
 base/poco/MongoDB/src/GetMoreRequest.cpp      |   2 +-
 base/poco/MongoDB/src/InsertRequest.cpp       |   2 +-
 base/poco/MongoDB/src/KillCursorsRequest.cpp  |   2 +-
 base/poco/MongoDB/src/Message.cpp             |   2 +-
 base/poco/MongoDB/src/MessageHeader.cpp       |  12 +-
 base/poco/MongoDB/src/ObjectId.cpp            |   2 +-
 base/poco/MongoDB/src/OpMsgCursor.cpp         | 187 ++++++++
 base/poco/MongoDB/src/OpMsgMessage.cpp        | 412 ++++++++++++++++++
 base/poco/MongoDB/src/QueryRequest.cpp        |   6 +-
 base/poco/MongoDB/src/RegularExpression.cpp   |   4 +-
 base/poco/MongoDB/src/ReplicaSet.cpp          |   6 +-
 base/poco/MongoDB/src/RequestMessage.cpp      |   4 +-
 base/poco/MongoDB/src/ResponseMessage.cpp     |  20 +-
 base/poco/MongoDB/src/UpdateRequest.cpp       |   2 +-
 .../runner/compose/docker_compose_mongo.yml   |   2 +-
 .../compose/docker_compose_mongo_secure.yml   |   2 +-
 src/Dictionaries/MongoDBDictionarySource.cpp  |  15 +-
 src/Dictionaries/MongoDBDictionarySource.h    |   1 -
 src/Processors/Sources/MongoDBSource.cpp      |  76 +++-
 src/Processors/Sources/MongoDBSource.h        |  32 +-
 src/Storages/StorageMongoDB.cpp               |  34 +-
 .../integration/test_storage_mongodb/test.py  |  42 +-
 50 files changed, 1399 insertions(+), 103 deletions(-)
 create mode 100644 base/poco/MongoDB/include/Poco/MongoDB/OpMsgCursor.h
 create mode 100644 base/poco/MongoDB/include/Poco/MongoDB/OpMsgMessage.h
 create mode 100644 base/poco/MongoDB/src/OpMsgCursor.cpp
 create mode 100644 base/poco/MongoDB/src/OpMsgMessage.cpp

diff --git a/base/poco/Foundation/include/Poco/BinaryReader.h b/base/poco/Foundation/include/Poco/BinaryReader.h
index 4042b507a2f..2b9bca29944 100644
--- a/base/poco/Foundation/include/Poco/BinaryReader.h
+++ b/base/poco/Foundation/include/Poco/BinaryReader.h
@@ -117,6 +117,9 @@ public:
     void readRaw(char * buffer, std::streamsize length);
     /// Reads length bytes of raw data into buffer.
 
+    void readCString(std::string& value);
+		/// Reads zero-terminated C-string into value.
+
     void readBOM();
     /// Reads a byte-order mark from the stream and configures
     /// the reader for the encountered byte order.
diff --git a/base/poco/Foundation/include/Poco/BinaryWriter.h b/base/poco/Foundation/include/Poco/BinaryWriter.h
index aa280d4ccab..a35d76d84bc 100644
--- a/base/poco/Foundation/include/Poco/BinaryWriter.h
+++ b/base/poco/Foundation/include/Poco/BinaryWriter.h
@@ -56,6 +56,8 @@ public:
         LITTLE_ENDIAN_BYTE_ORDER = 3 /// little-endian byte-order
     };
 
+    static const std::streamsize	DEFAULT_MAX_CSTR_LENGTH { 1024 };
+
     BinaryWriter(std::ostream & ostr, StreamByteOrder byteOrder = NATIVE_BYTE_ORDER);
     /// Creates the BinaryWriter.
 
@@ -131,6 +133,9 @@ public:
     void writeRaw(const char * buffer, std::streamsize length);
     /// Writes length raw bytes from the given buffer to the stream.
 
+    void writeCString(const char* cString, std::streamsize maxLength = DEFAULT_MAX_CSTR_LENGTH);
+		/// Writes zero-terminated C-string.
+
     void writeBOM();
     /// Writes a byte-order mark to the stream. A byte order mark is
     /// a 16-bit integer with a value of 0xFEFF, written in host byte-order.
diff --git a/base/poco/Foundation/src/BinaryReader.cpp b/base/poco/Foundation/src/BinaryReader.cpp
index f2961e03966..37ec2bc9040 100644
--- a/base/poco/Foundation/src/BinaryReader.cpp
+++ b/base/poco/Foundation/src/BinaryReader.cpp
@@ -274,6 +274,31 @@ void BinaryReader::readRaw(char* buffer, std::streamsize length)
 }
 
 
+void BinaryReader::readCString(std::string& value)
+{
+	value.clear();
+	if (!_istr.good())
+	{
+		return;
+	}
+	value.reserve(256);
+	while (true)
+	{
+		char c;
+		_istr.get(c);
+		if (!_istr.good())
+		{
+			break;
+		}
+		if (c == '\0')
+		{
+			break;
+		}
+		value += c;
+	}
+}
+
+
 void BinaryReader::readBOM()
 {
 	UInt16 bom;
diff --git a/base/poco/Foundation/src/BinaryWriter.cpp b/base/poco/Foundation/src/BinaryWriter.cpp
index 6db5ab7cb90..c3fcabc4374 100644
--- a/base/poco/Foundation/src/BinaryWriter.cpp
+++ b/base/poco/Foundation/src/BinaryWriter.cpp
@@ -271,7 +271,7 @@ BinaryWriter& BinaryWriter::operator << (const std::string& value)
 BinaryWriter& BinaryWriter::operator << (const char* value)
 {
 	poco_check_ptr (value);
-	
+
 	if (_pTextConverter)
 	{
 		std::string converted;
@@ -332,6 +332,15 @@ void BinaryWriter::writeRaw(const char* buffer, std::streamsize length)
 }
 
 
+void BinaryWriter::writeCString(const char* cString, std::streamsize maxLength)
+{
+	const std::size_t len = ::strnlen(cString, maxLength);
+	writeRaw(cString, len);
+	static const char zero = '\0';
+	_ostr.write(&zero, sizeof(zero));
+}
+
+
 void BinaryWriter::writeBOM()
 {
 	UInt16 value = 0xFEFF;
diff --git a/base/poco/MongoDB/CMakeLists.txt b/base/poco/MongoDB/CMakeLists.txt
index 8f5c6be2cae..bb6f90ed8f5 100644
--- a/base/poco/MongoDB/CMakeLists.txt
+++ b/base/poco/MongoDB/CMakeLists.txt
@@ -13,3 +13,4 @@ target_compile_options (_poco_mongodb
 
 target_include_directories (_poco_mongodb SYSTEM PUBLIC "include")
 target_link_libraries (_poco_mongodb PUBLIC Poco::Net)
+
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Array.h b/base/poco/MongoDB/include/Poco/MongoDB/Array.h
index 4ed9cdd87ee..8a30c785b2d 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Array.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Array.h
@@ -33,7 +33,7 @@ namespace MongoDB
     /// This class represents a BSON Array.
     {
     public:
-        typedef SharedPtr<Array> Ptr;
+        using Ptr = SharedPtr<Array>;
 
         Array();
         /// Creates an empty Array.
@@ -41,8 +41,31 @@ namespace MongoDB
         virtual ~Array();
         /// Destroys the Array.
 
+        // Document template functions available for backward compatibility
+        using Document::add;
+        using Document::get;
+
         template <typename T>
-        T get(int pos) const
+        Document & add(T value)
+        /// Creates an element with the name from the current pos and value and
+        /// adds it to the array document.
+        ///
+        /// The active document is returned to allow chaining of the add methods.
+        {
+            return Document::add<T>(Poco::NumberFormatter::format(size()), value);
+        }
+
+        Document & add(const char * value)
+        /// Creates an element with a name from the current pos and value and
+        /// adds it to the array document.
+        ///
+        /// The active document is returned to allow chaining of the add methods.
+        {
+            return Document::add(Poco::NumberFormatter::format(size()), value);
+        }
+
+        template <typename T>
+        T get(std::size_t pos) const
         /// Returns the element at the given index and tries to convert
         /// it to the template type. If the element is not found, a
         /// Poco::NotFoundException will be thrown. If the element cannot be
@@ -52,7 +75,7 @@ namespace MongoDB
         }
 
         template <typename T>
-        T get(int pos, const T & deflt) const
+        T get(std::size_t pos, const T & deflt) const
         /// Returns the element at the given index and tries to convert
         /// it to the template type. If the element is not found, or
         /// has the wrong type, the deflt argument will be returned.
@@ -60,12 +83,12 @@ namespace MongoDB
             return Document::get<T>(Poco::NumberFormatter::format(pos), deflt);
         }
 
-        Element::Ptr get(int pos) const;
+        Element::Ptr get(std::size_t pos) const;
         /// Returns the element at the given index.
         /// An empty element will be returned if the element is not found.
 
         template <typename T>
-        bool isType(int pos) const
+        bool isType(std::size_t pos) const
         /// Returns true if the type of the element equals the TypeId of ElementTrait,
         /// otherwise false.
         {
@@ -74,6 +97,9 @@ namespace MongoDB
 
         std::string toString(int indent = 0) const;
         /// Returns a string representation of the Array.
+
+    private:
+        friend void BSONReader::read<Array::Ptr>(Array::Ptr & to);
     };
 
 
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Binary.h b/base/poco/MongoDB/include/Poco/MongoDB/Binary.h
index 1005cb000f5..aad8736e8b6 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Binary.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Binary.h
@@ -40,7 +40,7 @@ namespace MongoDB
     /// A Binary stores its data in a Poco::Buffer<unsigned char>.
     {
     public:
-        typedef SharedPtr<Binary> Ptr;
+        using Ptr = SharedPtr<Binary>;
 
         Binary();
         /// Creates an empty Binary with subtype 0.
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Connection.h b/base/poco/MongoDB/include/Poco/MongoDB/Connection.h
index dcb813b75bc..cf679d530aa 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Connection.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Connection.h
@@ -18,6 +18,7 @@
 #define MongoDB_Connection_INCLUDED
 
 
+#include "Poco/MongoDB/OpMsgMessage.h"
 #include "Poco/MongoDB/RequestMessage.h"
 #include "Poco/MongoDB/ResponseMessage.h"
 #include "Poco/Mutex.h"
@@ -39,7 +40,7 @@ namespace MongoDB
     /// for more information on the wire protocol.
     {
     public:
-        typedef Poco::SharedPtr<Connection> Ptr;
+        using Ptr = Poco::SharedPtr<Connection>;
 
         class MongoDB_API SocketFactory
         {
@@ -90,7 +91,7 @@ namespace MongoDB
 
         Poco::Net::SocketAddress address() const;
         /// Returns the address of the MongoDB server.
-        
+
         const std::string & uri() const;
         /// Returns the uri on which the connection was made.
 
@@ -145,6 +146,21 @@ namespace MongoDB
         /// Use this when a response is expected: only a "query" or "getmore"
         /// request will return a response.
 
+        void sendRequest(OpMsgMessage & request, OpMsgMessage & response);
+        /// Sends a request to the MongoDB server and receives the response
+        /// using newer wire protocol with OP_MSG.
+
+        void sendRequest(OpMsgMessage & request);
+        /// Sends an unacknowledged request to the MongoDB server using newer
+        /// wire protocol with OP_MSG.
+        /// No response is sent by the server.
+
+        void readResponse(OpMsgMessage & response);
+        /// Reads additional response data when previous message's flag moreToCome
+        /// indicates that server will send more data.
+        /// NOTE: See comments in OpMsgCursor code.
+
+
     protected:
         void connect();
 
@@ -164,7 +180,7 @@ namespace MongoDB
     }
     inline const std::string & Connection::uri() const
     {
-    	return _uri;
+        return _uri;
     }
 
 
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Cursor.h b/base/poco/MongoDB/include/Poco/MongoDB/Cursor.h
index 4aed9fe64fb..8849d737a62 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Cursor.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Cursor.h
@@ -40,6 +40,9 @@ namespace MongoDB
         Cursor(const std::string & fullCollectionName, QueryRequest::Flags flags = QueryRequest::QUERY_DEFAULT);
         /// Creates a Cursor for the given database and collection ("database.collection"), using the specified flags.
 
+        Cursor(const Document & aggregationResponse);
+        /// Creates a Cursor for the given aggregation query response.
+
         virtual ~Cursor();
         /// Destroys the Cursor.
 
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Database.h b/base/poco/MongoDB/include/Poco/MongoDB/Database.h
index 62aea632b08..3334a673df6 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Database.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Database.h
@@ -26,6 +26,8 @@
 #include "Poco/MongoDB/QueryRequest.h"
 #include "Poco/MongoDB/UpdateRequest.h"
 
+#include "Poco/MongoDB/OpMsgCursor.h"
+#include "Poco/MongoDB/OpMsgMessage.h"
 
 namespace Poco
 {
@@ -45,6 +47,9 @@ namespace MongoDB
         virtual ~Database();
         /// Destroys the Database.
 
+        const std::string & name() const;
+        /// Database name
+
         bool authenticate(
             Connection & connection,
             const std::string & username,
@@ -62,34 +67,49 @@ namespace MongoDB
         /// May throw a Poco::ProtocolException if authentication fails for a reason other than
         /// invalid credentials.
 
+        Document::Ptr queryBuildInfo(Connection & connection) const;
+        /// Queries server build info (all wire protocols)
+
+        Document::Ptr queryServerHello(Connection & connection) const;
+        /// Queries hello response from server (all wire protocols)
+
         Int64 count(Connection & connection, const std::string & collectionName) const;
-        /// Sends a count request for the given collection to MongoDB.
+        /// Sends a count request for the given collection to MongoDB. (old wire protocol)
         ///
         /// If the command fails, -1 is returned.
 
         Poco::SharedPtr<Poco::MongoDB::QueryRequest> createCommand() const;
-        /// Creates a QueryRequest for a command.
+        /// Creates a QueryRequest for a command. (old wire protocol)
 
         Poco::SharedPtr<Poco::MongoDB::QueryRequest> createCountRequest(const std::string & collectionName) const;
         /// Creates a QueryRequest to count the given collection.
-        /// The collectionname must not contain the database name.
+        /// The collectionname must not contain the database name. (old wire protocol)
 
         Poco::SharedPtr<Poco::MongoDB::DeleteRequest> createDeleteRequest(const std::string & collectionName) const;
         /// Creates a DeleteRequest to delete documents in the given collection.
-        /// The collectionname must not contain the database name.
+        /// The collectionname must not contain the database name. (old wire protocol)
 
         Poco::SharedPtr<Poco::MongoDB::InsertRequest> createInsertRequest(const std::string & collectionName) const;
         /// Creates an InsertRequest to insert new documents in the given collection.
-        /// The collectionname must not contain the database name.
+        /// The collectionname must not contain the database name. (old wire protocol)
 
         Poco::SharedPtr<Poco::MongoDB::QueryRequest> createQueryRequest(const std::string & collectionName) const;
-        /// Creates a QueryRequest.
+        /// Creates a QueryRequest. (old wire protocol)
         /// The collectionname must not contain the database name.
 
         Poco::SharedPtr<Poco::MongoDB::UpdateRequest> createUpdateRequest(const std::string & collectionName) const;
-        /// Creates an UpdateRequest.
+        /// Creates an UpdateRequest. (old wire protocol)
         /// The collectionname must not contain the database name.
 
+        Poco::SharedPtr<Poco::MongoDB::OpMsgMessage> createOpMsgMessage(const std::string & collectionName) const;
+        /// Creates OpMsgMessage. (new wire protocol)
+
+        Poco::SharedPtr<Poco::MongoDB::OpMsgMessage> createOpMsgMessage() const;
+        /// Creates OpMsgMessage for database commands that do not require collection as an argument. (new wire protocol)
+
+        Poco::SharedPtr<Poco::MongoDB::OpMsgCursor> createOpMsgCursor(const std::string & collectionName) const;
+        /// Creates OpMsgCursor. (new wire protocol)
+
         Poco::MongoDB::Document::Ptr ensureIndex(
             Connection & connection,
             const std::string & collection,
@@ -100,14 +120,16 @@ namespace MongoDB
             int version = 0,
             int ttl = 0);
         /// Creates an index. The document returned is the result of a getLastError call.
-        /// For more info look at the ensureIndex information on the MongoDB website.
+        /// For more info look at the ensureIndex information on the MongoDB website. (old wire protocol)
 
         Document::Ptr getLastErrorDoc(Connection & connection) const;
         /// Sends the getLastError command to the database and returns the error document.
+        /// (old wire protocol)
 
         std::string getLastError(Connection & connection) const;
         /// Sends the getLastError command to the database and returns the err element
         /// from the error document. When err is null, an empty string is returned.
+        /// (old wire protocol)
 
         static const std::string AUTH_MONGODB_CR;
         /// Default authentication mechanism prior to MongoDB 3.0.
@@ -115,6 +137,27 @@ namespace MongoDB
         static const std::string AUTH_SCRAM_SHA1;
         /// Default authentication mechanism for MongoDB 3.0.
 
+        enum WireVersion
+        /// Wire version as reported by the command hello.
+        /// See details in MongoDB github, repository specifications.
+        /// @see queryServerHello
+        {
+            VER_26 = 1,
+            VER_26_2 = 2,
+            VER_30 = 3,
+            VER_32 = 4,
+            VER_34 = 5,
+            VER_36 = 6, ///< First wire version that supports OP_MSG
+            VER_40 = 7,
+            VER_42 = 8,
+            VER_44 = 9,
+            VER_50 = 13,
+            VER_51 = 14, ///< First wire version that supports only OP_MSG
+            VER_52 = 15,
+            VER_53 = 16,
+            VER_60 = 17
+        };
+
     protected:
         bool authCR(Connection & connection, const std::string & username, const std::string & password);
         bool authSCRAM(Connection & connection, const std::string & username, const std::string & password);
@@ -127,6 +170,12 @@ namespace MongoDB
     //
     // inlines
     //
+    inline const std::string & Database::name() const
+    {
+        return _dbname;
+    }
+
+
     inline Poco::SharedPtr<Poco::MongoDB::QueryRequest> Database::createCommand() const
     {
         Poco::SharedPtr<Poco::MongoDB::QueryRequest> cmd = createQueryRequest("$cmd");
@@ -158,6 +207,24 @@ namespace MongoDB
         return new Poco::MongoDB::UpdateRequest(_dbname + '.' + collectionName);
     }
 
+    // -- New wire protocol commands
+
+    inline Poco::SharedPtr<Poco::MongoDB::OpMsgMessage> Database::createOpMsgMessage(const std::string & collectionName) const
+    {
+        return new Poco::MongoDB::OpMsgMessage(_dbname, collectionName);
+    }
+
+    inline Poco::SharedPtr<Poco::MongoDB::OpMsgMessage> Database::createOpMsgMessage() const
+    {
+        // Collection name for database commands is not needed.
+        return createOpMsgMessage("");
+    }
+
+    inline Poco::SharedPtr<Poco::MongoDB::OpMsgCursor> Database::createOpMsgCursor(const std::string & collectionName) const
+    {
+        return new Poco::MongoDB::OpMsgCursor(_dbname, collectionName);
+    }
+
 
 }
 } // namespace Poco::MongoDB
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Document.h b/base/poco/MongoDB/include/Poco/MongoDB/Document.h
index 12889663827..9e1df349e20 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Document.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Document.h
@@ -31,6 +31,7 @@ namespace Poco
 namespace MongoDB
 {
 
+    class Array;
 
     class ElementFindByName
     {
@@ -48,8 +49,8 @@ namespace MongoDB
     /// Represents a MongoDB (BSON) document.
     {
     public:
-        typedef SharedPtr<Document> Ptr;
-        typedef std::vector<Document::Ptr> Vector;
+        using Ptr = SharedPtr<Document>;
+        using Vector = std::vector<Document::Ptr>;
 
         Document();
         /// Creates an empty Document.
@@ -86,6 +87,10 @@ namespace MongoDB
         /// Unlike the other add methods, this method returns
         /// a reference to the new document.
 
+        Array & addNewArray(const std::string & name);
+        /// Create a new array and add it to this document.
+        /// Method returns a reference to the new array.
+
         void clear();
         /// Removes all elements from the document.
 
@@ -95,7 +100,7 @@ namespace MongoDB
         bool empty() const;
         /// Returns true if the document doesn't contain any documents.
 
-        bool exists(const std::string & name);
+        bool exists(const std::string & name) const;
         /// Returns true if the document has an element with the given name.
 
         template <typename T>
@@ -158,6 +163,9 @@ namespace MongoDB
         /// return an Int64. When the element is not found, a
         /// Poco::NotFoundException will be thrown.
 
+        bool remove(const std::string & name);
+        /// Removes an element from the document.
+
         template <typename T>
         bool isType(const std::string & name) const
         /// Returns true when the type of the element equals the TypeId of ElementTrait.
@@ -227,12 +235,23 @@ namespace MongoDB
     }
 
 
-    inline bool Document::exists(const std::string & name)
+    inline bool Document::exists(const std::string & name) const
     {
         return std::find_if(_elements.begin(), _elements.end(), ElementFindByName(name)) != _elements.end();
     }
 
 
+    inline bool Document::remove(const std::string & name)
+    {
+        auto it = std::find_if(_elements.begin(), _elements.end(), ElementFindByName(name));
+        if (it == _elements.end())
+            return false;
+
+        _elements.erase(it);
+        return true;
+    }
+
+
     inline std::size_t Document::size() const
     {
         return _elements.size();
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/Element.h b/base/poco/MongoDB/include/Poco/MongoDB/Element.h
index b5592bd0e0b..26525d7d02b 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/Element.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/Element.h
@@ -45,7 +45,7 @@ namespace MongoDB
     /// Represents an Element of a Document or an Array.
     {
     public:
-        typedef Poco::SharedPtr<Element> Ptr;
+        using Ptr = Poco::SharedPtr<Element>;
 
         explicit Element(const std::string & name);
         /// Creates the Element with the given name.
@@ -80,7 +80,7 @@ namespace MongoDB
     }
 
 
-    typedef std::list<Element::Ptr> ElementSet;
+    using ElementSet = std::list<Element::Ptr>;
 
 
     template <typename T>
@@ -266,7 +266,7 @@ namespace MongoDB
     }
 
 
-    typedef Nullable<unsigned char> NullValue;
+    using NullValue = Nullable<unsigned char>;
 
 
     // BSON Null Value
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/JavaScriptCode.h b/base/poco/MongoDB/include/Poco/MongoDB/JavaScriptCode.h
index df1edc16817..c0f584b7c19 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/JavaScriptCode.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/JavaScriptCode.h
@@ -35,7 +35,7 @@ namespace MongoDB
     /// Represents JavaScript type in BSON.
     {
     public:
-        typedef SharedPtr<JavaScriptCode> Ptr;
+        using Ptr = SharedPtr<JavaScriptCode>;
 
         JavaScriptCode();
         /// Creates an empty JavaScriptCode object.
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/MessageHeader.h b/base/poco/MongoDB/include/Poco/MongoDB/MessageHeader.h
index 2b88e30fc74..98f45e876c1 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/MessageHeader.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/MessageHeader.h
@@ -28,6 +28,9 @@ namespace MongoDB
 {
 
 
+    class Message; // Required to disambiguate friend declaration in MessageHeader.
+
+
     class MongoDB_API MessageHeader
     /// Represents the message header which is always prepended to a
     /// MongoDB request or response message.
@@ -37,14 +40,18 @@ namespace MongoDB
 
         enum OpCode
         {
+            // Opcodes deprecated in MongoDB 5.0
             OP_REPLY = 1,
-            OP_MSG = 1000,
             OP_UPDATE = 2001,
             OP_INSERT = 2002,
             OP_QUERY = 2004,
             OP_GET_MORE = 2005,
             OP_DELETE = 2006,
-            OP_KILL_CURSORS = 2007
+            OP_KILL_CURSORS = 2007,
+
+            /// Opcodes supported in MongoDB 5.1 and later
+            OP_COMPRESSED = 2012,
+            OP_MSG = 2013
         };
 
         explicit MessageHeader(OpCode);
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/MongoDB.h b/base/poco/MongoDB/include/Poco/MongoDB/MongoDB.h
index 253f1f8ab27..de246ddc9dd 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/MongoDB.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/MongoDB.h
@@ -33,6 +33,13 @@
 //
 
 
+#if defined(_WIN32) && defined(POCO_DLL)
+#    if defined(MongoDB_EXPORTS)
+#        define MongoDB_API __declspec(dllexport)
+#    else
+#        define MongoDB_API __declspec(dllimport)
+#    endif
+#endif
 
 
 #if !defined(MongoDB_API)
@@ -47,6 +54,11 @@
 //
 // Automatically link MongoDB library.
 //
+#if defined(_MSC_VER)
+#    if !defined(POCO_NO_AUTOMATIC_LIBS) && !defined(MongoDB_EXPORTS)
+#        pragma comment(lib, "PocoMongoDB" POCO_LIB_SUFFIX)
+#    endif
+#endif
 
 
 #endif // MongoDBMongoDB_INCLUDED
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/ObjectId.h b/base/poco/MongoDB/include/Poco/MongoDB/ObjectId.h
index 76bb190db48..8a335320ea0 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/ObjectId.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/ObjectId.h
@@ -44,7 +44,7 @@ namespace MongoDB
     /// as its value.
     {
     public:
-        typedef SharedPtr<ObjectId> Ptr;
+        using Ptr = SharedPtr<ObjectId>;
 
         explicit ObjectId(const std::string & id);
         /// Creates an ObjectId from a string.
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/OpMsgCursor.h b/base/poco/MongoDB/include/Poco/MongoDB/OpMsgCursor.h
new file mode 100644
index 00000000000..a465a71bb1c
--- /dev/null
+++ b/base/poco/MongoDB/include/Poco/MongoDB/OpMsgCursor.h
@@ -0,0 +1,96 @@
+//
+// OpMsgCursor.h
+//
+// Library: MongoDB
+// Package: MongoDB
+// Module:  OpMsgCursor
+//
+// Definition of the OpMsgCursor class.
+//
+// Copyright (c) 2012, Applied Informatics Software Engineering GmbH.
+// and Contributors.
+//
+// SPDX-License-Identifier:	BSL-1.0
+//
+
+
+#ifndef MongoDB_OpMsgCursor_INCLUDED
+#define MongoDB_OpMsgCursor_INCLUDED
+
+
+#include "Poco/MongoDB/Connection.h"
+#include "Poco/MongoDB/MongoDB.h"
+#include "Poco/MongoDB/OpMsgMessage.h"
+
+namespace Poco
+{
+namespace MongoDB
+{
+
+
+    class MongoDB_API OpMsgCursor : public Document
+    /// OpMsgCursor is an helper class for querying multiple documents using OpMsgMessage.
+    {
+    public:
+        OpMsgCursor(const std::string & dbname, const std::string & collectionName);
+        /// Creates a OpMsgCursor for the given database and collection.
+
+        virtual ~OpMsgCursor();
+        /// Destroys the OpMsgCursor.
+
+        void setEmptyFirstBatch(bool empty);
+        /// Empty first batch is used to get error response faster with little server processing
+
+        bool emptyFirstBatch() const;
+
+        void setBatchSize(Int32 batchSize);
+        /// Set non-default batch size
+
+        Int32 batchSize() const;
+        /// Current batch size (zero or negative number indicates default batch size)
+
+        Int64 cursorID() const;
+
+        OpMsgMessage & next(Connection & connection);
+        /// Tries to get the next documents. As long as response message has a
+        /// cursor ID next can be called to retrieve the next bunch of documents.
+        ///
+        /// The cursor must be killed (see kill()) when not all documents are needed.
+
+        OpMsgMessage & query();
+        /// Returns the associated query.
+
+        void kill(Connection & connection);
+        /// Kills the cursor and reset it so that it can be reused.
+
+    private:
+        OpMsgMessage _query;
+        OpMsgMessage _response;
+
+        bool _emptyFirstBatch{false};
+        Int32 _batchSize{-1};
+        /// Batch size used in the cursor. Zero or negative value means that default shall be used.
+
+        Int64 _cursorID{0};
+    };
+
+
+    //
+    // inlines
+    //
+    inline OpMsgMessage & OpMsgCursor::query()
+    {
+        return _query;
+    }
+
+    inline Int64 OpMsgCursor::cursorID() const
+    {
+        return _cursorID;
+    }
+
+
+}
+} // namespace Poco::MongoDB
+
+
+#endif // MongoDB_OpMsgCursor_INCLUDED
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/OpMsgMessage.h b/base/poco/MongoDB/include/Poco/MongoDB/OpMsgMessage.h
new file mode 100644
index 00000000000..699c7fc4e12
--- /dev/null
+++ b/base/poco/MongoDB/include/Poco/MongoDB/OpMsgMessage.h
@@ -0,0 +1,163 @@
+//
+// OpMsgMessage.h
+//
+// Library: MongoDB
+// Package: MongoDB
+// Module:  OpMsgMessage
+//
+// Definition of the OpMsgMessage class.
+//
+// Copyright (c) 2022, Applied Informatics Software Engineering GmbH.
+// and Contributors.
+//
+// SPDX-License-Identifier:	BSL-1.0
+//
+
+
+#ifndef MongoDB_OpMsgMessage_INCLUDED
+#define MongoDB_OpMsgMessage_INCLUDED
+
+
+#include "Poco/MongoDB/Document.h"
+#include "Poco/MongoDB/Message.h"
+#include "Poco/MongoDB/MongoDB.h"
+
+#include <string>
+
+namespace Poco
+{
+namespace MongoDB
+{
+
+
+    class MongoDB_API OpMsgMessage : public Message
+    /// This class represents a request/response (OP_MSG) to send requests and receive responses to/from MongoDB.
+    {
+    public:
+        // Constants for most often used MongoDB commands that can be sent using OP_MSG
+        // For complete list see: https://www.mongodb.com/docs/manual/reference/command/
+
+        // Query and write
+        static const std::string CMD_INSERT;
+        static const std::string CMD_DELETE;
+        static const std::string CMD_UPDATE;
+        static const std::string CMD_FIND;
+        static const std::string CMD_FIND_AND_MODIFY;
+        static const std::string CMD_GET_MORE;
+
+        // Aggregation
+        static const std::string CMD_AGGREGATE;
+        static const std::string CMD_COUNT;
+        static const std::string CMD_DISTINCT;
+        static const std::string CMD_MAP_REDUCE;
+
+        // Replication and administration
+        static const std::string CMD_HELLO;
+        static const std::string CMD_REPL_SET_GET_STATUS;
+        static const std::string CMD_REPL_SET_GET_CONFIG;
+
+        static const std::string CMD_CREATE;
+        static const std::string CMD_CREATE_INDEXES;
+        static const std::string CMD_DROP;
+        static const std::string CMD_DROP_DATABASE;
+        static const std::string CMD_KILL_CURSORS;
+        static const std::string CMD_LIST_DATABASES;
+        static const std::string CMD_LIST_INDEXES;
+
+        // Diagnostic
+        static const std::string CMD_BUILD_INFO;
+        static const std::string CMD_COLL_STATS;
+        static const std::string CMD_DB_STATS;
+        static const std::string CMD_HOST_INFO;
+
+
+        enum Flags : UInt32
+        {
+            MSG_FLAGS_DEFAULT = 0,
+
+            MSG_CHECKSUM_PRESENT = (1 << 0),
+
+            MSG_MORE_TO_COME = (1 << 1),
+            /// Sender will send another message and is not prepared for overlapping messages
+
+            MSG_EXHAUST_ALLOWED = (1 << 16)
+            /// Client is prepared for multiple replies (using the moreToCome bit) to this request
+        };
+
+        OpMsgMessage();
+        /// Creates an OpMsgMessage for response.
+
+        OpMsgMessage(const std::string & databaseName, const std::string & collectionName, UInt32 flags = MSG_FLAGS_DEFAULT);
+        /// Creates an OpMsgMessage for requests.
+
+        virtual ~OpMsgMessage();
+
+        const std::string & databaseName() const;
+
+        const std::string & collectionName() const;
+
+        void setCommandName(const std::string & command);
+        /// Sets the command name and clears the command document
+
+        void setCursor(Poco::Int64 cursorID, Poco::Int32 batchSize = -1);
+        /// Sets the command "getMore" for the cursor id with batch size (if it is not negative).
+
+        const std::string & commandName() const;
+        /// Current command name.
+
+        void setAcknowledgedRequest(bool ack);
+        /// Set false to create request that does not return response.
+        /// It has effect only for commands that write or delete documents.
+        /// Default is true (request returns acknowledge response).
+
+        bool acknowledgedRequest() const;
+
+        UInt32 flags() const;
+
+        Document & body();
+        /// Access to body document.
+        /// Additional query arguments shall be added after setting the command name.
+
+        const Document & body() const;
+
+        Document::Vector & documents();
+        /// Documents prepared for request or retrieved in response.
+
+        const Document::Vector & documents() const;
+        /// Documents prepared for request or retrieved in response.
+
+        bool responseOk() const;
+        /// Reads "ok" status from the response message.
+
+        void clear();
+        /// Clears the message.
+
+        void send(std::ostream & ostr);
+        /// Writes the request to stream.
+
+        void read(std::istream & istr);
+        /// Reads the response from the stream.
+
+    private:
+        enum PayloadType : UInt8
+        {
+            PAYLOAD_TYPE_0 = 0,
+            PAYLOAD_TYPE_1 = 1
+        };
+
+        std::string _databaseName;
+        std::string _collectionName;
+        UInt32 _flags{MSG_FLAGS_DEFAULT};
+        std::string _commandName;
+        bool _acknowledged{true};
+
+        Document _body;
+        Document::Vector _documents;
+    };
+
+
+}
+} // namespace Poco::MongoDB
+
+
+#endif // MongoDB_OpMsgMessage_INCLUDED
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/PoolableConnectionFactory.h b/base/poco/MongoDB/include/Poco/MongoDB/PoolableConnectionFactory.h
index 9d35c728e5e..53f4a5127ef 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/PoolableConnectionFactory.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/PoolableConnectionFactory.h
@@ -94,7 +94,23 @@ namespace MongoDB
 
         operator Connection::Ptr() { return _connection; }
 
+#if defined(POCO_ENABLE_CPP11)
+        // Disable copy to prevent unwanted release of resources: C++11 way
+        PooledConnection(const PooledConnection &) = delete;
+        PooledConnection & operator=(const PooledConnection &) = delete;
+
+        // Enable move semantics
+        PooledConnection(PooledConnection && other) = default;
+        PooledConnection & operator=(PooledConnection &&) = default;
+#endif
+
     private:
+#if !defined(POCO_ENABLE_CPP11)
+        // Disable copy to prevent unwanted release of resources: pre C++11 way
+        PooledConnection(const PooledConnection &);
+        PooledConnection & operator=(const PooledConnection &);
+#endif
+
         Poco::ObjectPool<Connection, Connection::Ptr> & _pool;
         Connection::Ptr _connection;
     };
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/RegularExpression.h b/base/poco/MongoDB/include/Poco/MongoDB/RegularExpression.h
index b9a8694d321..244b8c14163 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/RegularExpression.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/RegularExpression.h
@@ -33,7 +33,7 @@ namespace MongoDB
     /// Represents a regular expression in BSON format.
     {
     public:
-        typedef SharedPtr<RegularExpression> Ptr;
+        using Ptr = SharedPtr<RegularExpression>;
 
         RegularExpression();
         /// Creates an empty RegularExpression.
diff --git a/base/poco/MongoDB/include/Poco/MongoDB/ResponseMessage.h b/base/poco/MongoDB/include/Poco/MongoDB/ResponseMessage.h
index 132859cc75f..9cb92cb16c4 100644
--- a/base/poco/MongoDB/include/Poco/MongoDB/ResponseMessage.h
+++ b/base/poco/MongoDB/include/Poco/MongoDB/ResponseMessage.h
@@ -38,6 +38,9 @@ namespace MongoDB
         ResponseMessage();
         /// Creates an empty ResponseMessage.
 
+        ResponseMessage(const Int64 & cursorID);
+        /// Creates an ResponseMessage for existing cursor ID.
+
         virtual ~ResponseMessage();
         /// Destroys the ResponseMessage.
 
diff --git a/base/poco/MongoDB/src/Array.cpp b/base/poco/MongoDB/src/Array.cpp
index c6d96d1371d..6fff0994d82 100644
--- a/base/poco/MongoDB/src/Array.cpp
+++ b/base/poco/MongoDB/src/Array.cpp
@@ -20,7 +20,7 @@ namespace Poco {
 namespace MongoDB {
 
 
-Array::Array(): 
+Array::Array():
 	Document()
 {
 }
@@ -31,7 +31,7 @@ Array::~Array()
 }
 
 
-Element::Ptr Array::get(int pos) const
+Element::Ptr Array::get(std::size_t pos) const
 {
 	std::string name = Poco::NumberFormatter::format(pos);
 	return Document::get(name);
diff --git a/base/poco/MongoDB/src/Connection.cpp b/base/poco/MongoDB/src/Connection.cpp
index 38c31d2250a..fa20887054b 100644
--- a/base/poco/MongoDB/src/Connection.cpp
+++ b/base/poco/MongoDB/src/Connection.cpp
@@ -319,4 +319,30 @@ void Connection::sendRequest(RequestMessage& request, ResponseMessage& response)
 }
 
 
+void Connection::sendRequest(OpMsgMessage& request, OpMsgMessage& response)
+{
+	Poco::Net::SocketOutputStream sos(_socket);
+	request.send(sos);
+
+	response.clear();
+	readResponse(response);
+}
+
+
+void Connection::sendRequest(OpMsgMessage& request)
+{
+	request.setAcknowledgedRequest(false);
+	Poco::Net::SocketOutputStream sos(_socket);
+	request.send(sos);
+}
+
+
+void Connection::readResponse(OpMsgMessage& response)
+{
+	Poco::Net::SocketInputStream sis(_socket);
+	response.read(sis);
+}
+
+
+
 } } // Poco::MongoDB
diff --git a/base/poco/MongoDB/src/Cursor.cpp b/base/poco/MongoDB/src/Cursor.cpp
index 69031e0ab65..ef7a4ca961d 100644
--- a/base/poco/MongoDB/src/Cursor.cpp
+++ b/base/poco/MongoDB/src/Cursor.cpp
@@ -33,6 +33,12 @@ Cursor::Cursor(const std::string& fullCollectionName, QueryRequest::Flags flags)
 }
 
 
+Cursor::Cursor(const Document& aggregationResponse) :
+    _query(aggregationResponse.get<Poco::MongoDB::Document::Ptr>("cursor")->get<std::string>("ns")),
+    _response(aggregationResponse.get<Poco::MongoDB::Document::Ptr>("cursor")->get<Int64>("id"))
+{
+}
+
 Cursor::~Cursor()
 {
 	try
diff --git a/base/poco/MongoDB/src/Database.cpp b/base/poco/MongoDB/src/Database.cpp
index 2b31523bdc4..1a0d3cfe559 100644
--- a/base/poco/MongoDB/src/Database.cpp
+++ b/base/poco/MongoDB/src/Database.cpp
@@ -334,6 +334,50 @@ bool Database::authSCRAM(Connection& connection, const std::string& username, co
 }
 
 
+Document::Ptr Database::queryBuildInfo(Connection& connection) const
+{
+	// build info can be issued on "config" system database
+	Poco::SharedPtr<Poco::MongoDB::QueryRequest> request = createCommand();
+	request->selector().add("buildInfo", 1);
+
+	Poco::MongoDB::ResponseMessage response;
+	connection.sendRequest(*request, response);
+
+	Document::Ptr buildInfo;
+	if ( response.documents().size() > 0 )
+	{
+		buildInfo = response.documents()[0];
+	}
+	else
+	{
+		throw Poco::ProtocolException("Didn't get a response from the buildinfo command");
+	}
+	return buildInfo;
+}
+
+
+Document::Ptr Database::queryServerHello(Connection& connection) const
+{
+	// hello can be issued on "config" system database
+	Poco::SharedPtr<Poco::MongoDB::QueryRequest> request = createCommand();
+	request->selector().add("hello", 1);
+
+	Poco::MongoDB::ResponseMessage response;
+	connection.sendRequest(*request, response);
+
+	Document::Ptr hello;
+	if ( response.documents().size() > 0 )
+	{
+		hello = response.documents()[0];
+	}
+	else
+	{
+		throw Poco::ProtocolException("Didn't get a response from the hello command");
+	}
+	return hello;
+}
+
+
 Int64 Database::count(Connection& connection, const std::string& collectionName) const
 {
 	Poco::SharedPtr<Poco::MongoDB::QueryRequest> countRequest = createCountRequest(collectionName);
@@ -390,7 +434,7 @@ Document::Ptr Database::getLastErrorDoc(Connection& connection) const
 {
 	Document::Ptr errorDoc;
 
-	Poco::SharedPtr<Poco::MongoDB::QueryRequest> request = createQueryRequest("$cmd");
+	Poco::SharedPtr<Poco::MongoDB::QueryRequest> request = createCommand();
 	request->setNumberToReturn(1);
 	request->selector().add("getLastError", 1);
 
@@ -420,7 +464,7 @@ std::string Database::getLastError(Connection& connection) const
 
 Poco::SharedPtr<Poco::MongoDB::QueryRequest> Database::createCountRequest(const std::string& collectionName) const
 {
-	Poco::SharedPtr<Poco::MongoDB::QueryRequest> request = createQueryRequest("$cmd");
+	Poco::SharedPtr<Poco::MongoDB::QueryRequest> request = createCommand();
 	request->setNumberToReturn(1);
 	request->selector().add("count", collectionName);
 	return request;
diff --git a/base/poco/MongoDB/src/DeleteRequest.cpp b/base/poco/MongoDB/src/DeleteRequest.cpp
index 67a88c33302..ba75beb55fb 100644
--- a/base/poco/MongoDB/src/DeleteRequest.cpp
+++ b/base/poco/MongoDB/src/DeleteRequest.cpp
@@ -20,8 +20,8 @@ namespace MongoDB {
 
 
 DeleteRequest::DeleteRequest(const std::string& collectionName, DeleteRequest::Flags flags):
-	RequestMessage(MessageHeader::OP_DELETE), 
-	_flags(flags), 
+	RequestMessage(MessageHeader::OP_DELETE),
+	_flags(flags),
 	_fullCollectionName(collectionName),
 	_selector()
 {
diff --git a/base/poco/MongoDB/src/Document.cpp b/base/poco/MongoDB/src/Document.cpp
index 114fc993891..f7c5c9c5dc6 100644
--- a/base/poco/MongoDB/src/Document.cpp
+++ b/base/poco/MongoDB/src/Document.cpp
@@ -35,6 +35,14 @@ Document::~Document()
 }
 
 
+Array& Document::addNewArray(const std::string& name)
+{
+	Array::Ptr newArray = new Array();
+	add(name, newArray);
+	return *newArray;
+}
+
+
 Element::Ptr Document::get(const std::string& name) const
 {
 	Element::Ptr element;
@@ -84,7 +92,7 @@ void Document::read(BinaryReader& reader)
 	while (type != '\0')
 	{
 		Element::Ptr element;
-		
+
 		std::string name = BSONReader(reader).readCString();
 
 		switch (type)
@@ -198,7 +206,7 @@ void Document::write(BinaryWriter& writer)
 	else
 	{
 		std::stringstream sstream;
-		Poco::BinaryWriter tempWriter(sstream);
+		Poco::BinaryWriter tempWriter(sstream, BinaryWriter::LITTLE_ENDIAN_BYTE_ORDER);
 		for (ElementSet::iterator it = _elements.begin(); it != _elements.end(); ++it)
 		{
 			tempWriter << static_cast<unsigned char>((*it)->type());
@@ -207,7 +215,7 @@ void Document::write(BinaryWriter& writer)
 			element->write(tempWriter);
 		}
 		tempWriter.flush();
-		
+
 		Poco::Int32 len = static_cast<Poco::Int32>(5 + sstream.tellp()); /* 5 = sizeof(len) + 0-byte */
 		writer << len;
 		writer.writeRaw(sstream.str());
diff --git a/base/poco/MongoDB/src/Element.cpp b/base/poco/MongoDB/src/Element.cpp
index 89629e0503e..f91ce264493 100644
--- a/base/poco/MongoDB/src/Element.cpp
+++ b/base/poco/MongoDB/src/Element.cpp
@@ -24,7 +24,7 @@ Element::Element(const std::string& name) : _name(name)
 }
 
 
-Element::~Element() 
+Element::~Element()
 {
 }
 
diff --git a/base/poco/MongoDB/src/GetMoreRequest.cpp b/base/poco/MongoDB/src/GetMoreRequest.cpp
index f8a6b73c6ad..2c1f6909eb7 100644
--- a/base/poco/MongoDB/src/GetMoreRequest.cpp
+++ b/base/poco/MongoDB/src/GetMoreRequest.cpp
@@ -21,7 +21,7 @@ namespace MongoDB {
 
 
 GetMoreRequest::GetMoreRequest(const std::string& collectionName, Int64 cursorID):
-	RequestMessage(MessageHeader::OP_GET_MORE), 
+	RequestMessage(MessageHeader::OP_GET_MORE),
 	_fullCollectionName(collectionName),
 	_numberToReturn(100),
 	_cursorID(cursorID)
diff --git a/base/poco/MongoDB/src/InsertRequest.cpp b/base/poco/MongoDB/src/InsertRequest.cpp
index ec8dc9cf94a..65be5654b3e 100644
--- a/base/poco/MongoDB/src/InsertRequest.cpp
+++ b/base/poco/MongoDB/src/InsertRequest.cpp
@@ -20,7 +20,7 @@ namespace MongoDB {
 
 
 InsertRequest::InsertRequest(const std::string& collectionName, Flags flags):
-	RequestMessage(MessageHeader::OP_INSERT), 
+	RequestMessage(MessageHeader::OP_INSERT),
 	_flags(flags),
 	_fullCollectionName(collectionName)
 {
diff --git a/base/poco/MongoDB/src/KillCursorsRequest.cpp b/base/poco/MongoDB/src/KillCursorsRequest.cpp
index 6baa0e0be8f..448002aa16a 100644
--- a/base/poco/MongoDB/src/KillCursorsRequest.cpp
+++ b/base/poco/MongoDB/src/KillCursorsRequest.cpp
@@ -37,7 +37,7 @@ void KillCursorsRequest::buildRequest(BinaryWriter& writer)
 	for (std::vector<Int64>::iterator it = _cursors.begin(); it != _cursors.end(); ++it)
 	{
 		writer << *it;
-	}		
+	}
 }
 
 
diff --git a/base/poco/MongoDB/src/Message.cpp b/base/poco/MongoDB/src/Message.cpp
index c29d282d15a..7b1cb23bab6 100644
--- a/base/poco/MongoDB/src/Message.cpp
+++ b/base/poco/MongoDB/src/Message.cpp
@@ -19,7 +19,7 @@ namespace Poco {
 namespace MongoDB {
 
 
-Message::Message(MessageHeader::OpCode opcode): 
+Message::Message(MessageHeader::OpCode opcode):
 	_header(opcode)
 {
 }
diff --git a/base/poco/MongoDB/src/MessageHeader.cpp b/base/poco/MongoDB/src/MessageHeader.cpp
index 222121243db..b472bcec465 100644
--- a/base/poco/MongoDB/src/MessageHeader.cpp
+++ b/base/poco/MongoDB/src/MessageHeader.cpp
@@ -20,10 +20,10 @@ namespace Poco {
 namespace MongoDB {
 
 
-MessageHeader::MessageHeader(OpCode opCode): 
-	_messageLength(0), 
-	_requestID(0), 
-	_responseTo(0), 
+MessageHeader::MessageHeader(OpCode opCode):
+	_messageLength(0),
+	_requestID(0),
+	_responseTo(0),
 	_opCode(opCode)
 {
 }
@@ -42,7 +42,7 @@ void MessageHeader::read(BinaryReader& reader)
 
 	Int32 opCode;
 	reader >> opCode;
-	_opCode = (OpCode) opCode;
+	_opCode = static_cast<OpCode>(opCode);
 
 	if (!reader.good())
 	{
@@ -56,7 +56,7 @@ void MessageHeader::write(BinaryWriter& writer)
 	writer << _messageLength;
 	writer << _requestID;
 	writer << _responseTo;
-	writer << (Int32) _opCode;
+	writer << static_cast<Int32>(_opCode);
 }
 
 
diff --git a/base/poco/MongoDB/src/ObjectId.cpp b/base/poco/MongoDB/src/ObjectId.cpp
index 3065a2ffc30..0125c246c2d 100644
--- a/base/poco/MongoDB/src/ObjectId.cpp
+++ b/base/poco/MongoDB/src/ObjectId.cpp
@@ -32,7 +32,7 @@ ObjectId::ObjectId(const std::string& id)
 	poco_assert_dbg(id.size() == 24);
 
     const char* p = id.c_str();
-    for (std::size_t i = 0; i < 12; ++i) 
+    for (std::size_t i = 0; i < 12; ++i)
     {
 		_id[i] = fromHex(p);
 		p += 2;
diff --git a/base/poco/MongoDB/src/OpMsgCursor.cpp b/base/poco/MongoDB/src/OpMsgCursor.cpp
new file mode 100644
index 00000000000..bc95851ae33
--- /dev/null
+++ b/base/poco/MongoDB/src/OpMsgCursor.cpp
@@ -0,0 +1,187 @@
+//
+// OpMsgCursor.cpp
+//
+// Library: MongoDB
+// Package: MongoDB
+// Module:  OpMsgCursor
+//
+// Copyright (c) 2022, Applied Informatics Software Engineering GmbH.
+// and Contributors.
+//
+// SPDX-License-Identifier:	BSL-1.0
+//
+
+
+#include "Poco/MongoDB/OpMsgCursor.h"
+#include "Poco/MongoDB/Array.h"
+
+//
+// NOTE:
+//
+// MongoDB specification indicates that the flag MSG_EXHAUST_ALLOWED shall be
+// used in the request when the receiver is ready to receive multiple messages
+// without sending additional requests in between. Sender (MongoDB) indicates
+// that more messages follow with flag MSG_MORE_TO_COME.
+//
+// It seems that this does not work properly. MSG_MORE_TO_COME is set and reading
+// next messages sometimes works, however often the data is missing in response
+// or the message header contains wrong message length and reading blocks.
+// Opcode in the header is correct.
+//
+// Using MSG_EXHAUST_ALLOWED is therefore currently disabled.
+//
+// It seems that related JIRA ticket is:
+//
+// https://jira.mongodb.org/browse/SERVER-57297
+//
+// https://github.com/mongodb/specifications/blob/master/source/message/OP_MSG.rst
+//
+
+#define MONGODB_EXHAUST_ALLOWED_WORKS	false
+
+namespace Poco {
+namespace MongoDB {
+
+
+static const std::string keyCursor		{"cursor"};
+static const std::string keyFirstBatch	{"firstBatch"};
+static const std::string keyNextBatch	{"nextBatch"};
+
+static Poco::Int64 cursorIdFromResponse(const MongoDB::Document& doc);
+
+
+OpMsgCursor::OpMsgCursor(const std::string& db, const std::string& collection):
+#if MONGODB_EXHAUST_ALLOWED_WORKS
+	_query(db, collection, OpMsgMessage::MSG_EXHAUST_ALLOWED)
+#else
+	_query(db, collection)
+#endif
+{
+}
+
+OpMsgCursor::~OpMsgCursor()
+{
+	try
+	{
+		poco_assert_dbg(_cursorID == 0);
+	}
+	catch (...)
+	{
+	}
+}
+
+
+void OpMsgCursor::setEmptyFirstBatch(bool empty)
+{
+	_emptyFirstBatch = empty;
+}
+
+
+bool OpMsgCursor::emptyFirstBatch() const
+{
+	return _emptyFirstBatch;
+}
+
+
+void OpMsgCursor::setBatchSize(Int32 batchSize)
+{
+	_batchSize = batchSize;
+}
+
+
+Int32 OpMsgCursor::batchSize() const
+{
+	return _batchSize;
+}
+
+
+OpMsgMessage& OpMsgCursor::next(Connection& connection)
+{
+	if (_cursorID == 0)
+	{
+		_response.clear();
+
+		if (_emptyFirstBatch || _batchSize > 0)
+		{
+			Int32 bsize = _emptyFirstBatch ? 0 : _batchSize;
+			if (_query.commandName() == OpMsgMessage::CMD_FIND)
+			{
+				_query.body().add("batchSize", bsize);
+			}
+			else if (_query.commandName() == OpMsgMessage::CMD_AGGREGATE)
+			{
+				auto& cursorDoc = _query.body().addNewDocument("cursor");
+				cursorDoc.add("batchSize", bsize);
+			}
+		}
+
+		connection.sendRequest(_query, _response);
+
+		const auto& rdoc = _response.body();
+		_cursorID = cursorIdFromResponse(rdoc);
+	}
+	else
+	{
+#if MONGODB_EXHAUST_ALLOWED_WORKS
+		std::cout << "Response flags: " << _response.flags() << std::endl;
+		if (_response.flags() & OpMsgMessage::MSG_MORE_TO_COME)
+		{
+			std::cout << "More to come. Reading more response: " << std::endl;
+			_response.clear();
+			connection.readResponse(_response);
+		}
+		else
+#endif		
+		{
+			_response.clear();
+			_query.setCursor(_cursorID, _batchSize);
+			connection.sendRequest(_query, _response);
+		}
+	}
+
+	const auto& rdoc = _response.body();
+	_cursorID = cursorIdFromResponse(rdoc);
+
+	return _response;
+}
+
+
+void OpMsgCursor::kill(Connection& connection)
+{
+	_response.clear();
+	if (_cursorID != 0)
+	{
+		_query.setCommandName(OpMsgMessage::CMD_KILL_CURSORS);
+
+		MongoDB::Array::Ptr cursors = new MongoDB::Array();
+		cursors->add<Poco::Int64>(_cursorID);
+		_query.body().add("cursors", cursors);
+
+		connection.sendRequest(_query, _response);
+
+		const auto killed = _response.body().get<MongoDB::Array::Ptr>("cursorsKilled", nullptr);
+		if (!killed || killed->size() != 1 || killed->get<Poco::Int64>(0, -1) != _cursorID)
+		{
+			throw Poco::ProtocolException("Cursor not killed as expected: " + std::to_string(_cursorID));
+		}
+
+		_cursorID = 0;
+		_query.clear();
+		_response.clear();
+	}
+}
+
+
+Poco::Int64 cursorIdFromResponse(const MongoDB::Document& doc)
+{
+	Poco::Int64 id {0};
+	auto cursorDoc = doc.get<Document::Ptr>(keyCursor, nullptr);
+	if(cursorDoc)
+	{
+		id = cursorDoc->get<Poco::Int64>("id", 0);
+	}
+	return id;
+}
+
+
+} } // Namespace Poco::MongoDB
diff --git a/base/poco/MongoDB/src/OpMsgMessage.cpp b/base/poco/MongoDB/src/OpMsgMessage.cpp
new file mode 100644
index 00000000000..2b55772ca59
--- /dev/null
+++ b/base/poco/MongoDB/src/OpMsgMessage.cpp
@@ -0,0 +1,412 @@
+//
+// OpMsgMessage.cpp
+//
+// Library: MongoDB
+// Package: MongoDB
+// Module:  OpMsgMessage
+//
+// Copyright (c) 2022, Applied Informatics Software Engineering GmbH.
+// and Contributors.
+//
+// SPDX-License-Identifier:	BSL-1.0
+//
+
+#include "Poco/MongoDB/OpMsgMessage.h"
+#include "Poco/MongoDB/MessageHeader.h"
+#include "Poco/MongoDB/Array.h"
+#include "Poco/StreamCopier.h"
+#include "Poco/Logger.h"
+
+#define POCO_MONGODB_DUMP	false
+
+namespace Poco {
+namespace MongoDB {
+
+// Query and write
+const std::string OpMsgMessage::CMD_INSERT { "insert" };
+const std::string OpMsgMessage::CMD_DELETE { "delete" };
+const std::string OpMsgMessage::CMD_UPDATE { "update" };
+const std::string OpMsgMessage::CMD_FIND { "find" };
+const std::string OpMsgMessage::CMD_FIND_AND_MODIFY { "findAndModify" };
+const std::string OpMsgMessage::CMD_GET_MORE { "getMore" };
+
+// Aggregation
+const std::string OpMsgMessage::CMD_AGGREGATE { "aggregate" };
+const std::string OpMsgMessage::CMD_COUNT { "count" };
+const std::string OpMsgMessage::CMD_DISTINCT { "distinct" };
+const std::string OpMsgMessage::CMD_MAP_REDUCE { "mapReduce" };
+
+// Replication and administration 
+const std::string OpMsgMessage::CMD_HELLO { "hello" };
+const std::string OpMsgMessage::CMD_REPL_SET_GET_STATUS { "replSetGetStatus" };
+const std::string OpMsgMessage::CMD_REPL_SET_GET_CONFIG { "replSetGetConfig" };
+
+const std::string OpMsgMessage::CMD_CREATE { "create" };
+const std::string OpMsgMessage::CMD_CREATE_INDEXES { "createIndexes" };
+const std::string OpMsgMessage::CMD_DROP { "drop" };
+const std::string OpMsgMessage::CMD_DROP_DATABASE { "dropDatabase" };
+const std::string OpMsgMessage::CMD_KILL_CURSORS { "killCursors" };
+const std::string OpMsgMessage::CMD_LIST_DATABASES { "listDatabases" };
+const std::string OpMsgMessage::CMD_LIST_INDEXES { "listIndexes" };
+
+// Diagnostic
+const std::string OpMsgMessage::CMD_BUILD_INFO { "buildInfo" };
+const std::string OpMsgMessage::CMD_COLL_STATS { "collStats" };
+const std::string OpMsgMessage::CMD_DB_STATS { "dbStats" };
+const std::string OpMsgMessage::CMD_HOST_INFO { "hostInfo" };
+
+
+static const std::string& commandIdentifier(const std::string& command);
+	/// Commands have different names for the payload that is sent in a separate section
+
+
+static const std::string keyCursor		{"cursor"};
+static const std::string keyFirstBatch	{"firstBatch"};
+static const std::string keyNextBatch	{"nextBatch"};
+
+
+OpMsgMessage::OpMsgMessage() :
+	Message(MessageHeader::OP_MSG)
+{
+}
+
+
+OpMsgMessage::OpMsgMessage(const std::string& databaseName, const std::string& collectionName, UInt32 flags) :
+	Message(MessageHeader::OP_MSG),
+	_databaseName(databaseName),
+	_collectionName(collectionName),
+	_flags(flags)
+{
+}
+
+
+OpMsgMessage::~OpMsgMessage()
+{
+}
+
+const std::string& OpMsgMessage::databaseName() const
+{
+	return _databaseName;
+}
+
+
+const std::string& OpMsgMessage::collectionName() const
+{
+	return _collectionName;
+}
+
+
+void OpMsgMessage::setCommandName(const std::string& command)
+{
+	_commandName = command;
+	_body.clear();
+
+	// IMPORTANT: Command name must be first
+	if (_collectionName.empty())
+	{
+		// Collection is not specified. It is assumed that this particular command does 
+		// not need it.
+		_body.add(_commandName, Int32(1));
+	}
+	else
+	{
+		_body.add(_commandName, _collectionName);
+	}
+	_body.add("$db", _databaseName);
+}
+
+
+void OpMsgMessage::setCursor(Poco::Int64 cursorID, Poco::Int32 batchSize)
+{
+	_commandName = OpMsgMessage::CMD_GET_MORE;
+	_body.clear();
+
+	// IMPORTANT: Command name must be first
+	_body.add(_commandName, cursorID);
+	_body.add("$db", _databaseName);
+	_body.add("collection", _collectionName);
+	if (batchSize > 0)
+	{
+		_body.add("batchSize", batchSize);
+	}
+}
+
+
+const std::string& OpMsgMessage::commandName() const
+{
+	return _commandName;
+}
+
+
+void OpMsgMessage::setAcknowledgedRequest(bool ack)
+{
+	const auto& id = commandIdentifier(_commandName);
+	if (id.empty())
+		return;
+
+	_acknowledged = ack;
+
+	auto writeConcern = _body.get<Document::Ptr>("writeConcern", nullptr);
+	if (writeConcern)
+		writeConcern->remove("w");
+
+	if (ack)
+	{
+		_flags = _flags & (~MSG_MORE_TO_COME);
+	}
+	else
+	{
+		_flags = _flags | MSG_MORE_TO_COME;
+		if (!writeConcern)
+			_body.addNewDocument("writeConcern").add("w", 0);
+		else
+			writeConcern->add("w", 0);
+	}
+
+}
+
+
+bool OpMsgMessage::acknowledgedRequest() const
+{
+	return _acknowledged;
+}
+
+
+UInt32 OpMsgMessage::flags() const
+{
+	return _flags;
+}
+
+
+Document& OpMsgMessage::body()
+{
+	return _body;
+}
+
+
+const Document& OpMsgMessage::body() const
+{
+	return _body;
+}
+
+
+Document::Vector& OpMsgMessage::documents()
+{
+	return _documents;
+}
+
+
+const Document::Vector& OpMsgMessage::documents() const
+{
+	return _documents;
+}
+
+
+bool OpMsgMessage::responseOk() const
+{
+	Poco::Int64 ok {false};
+	if (_body.exists("ok"))
+	{
+		ok = _body.getInteger("ok");
+	}
+	return (ok != 0);
+}
+
+
+void OpMsgMessage::clear()
+{
+	_flags = MSG_FLAGS_DEFAULT;
+	_commandName.clear();
+	_body.clear();
+	_documents.clear();
+}
+
+
+void OpMsgMessage::send(std::ostream& ostr)
+{
+	BinaryWriter socketWriter(ostr, BinaryWriter::LITTLE_ENDIAN_BYTE_ORDER);
+
+	// Serialise the body
+	std::stringstream ss;
+	BinaryWriter writer(ss, BinaryWriter::LITTLE_ENDIAN_BYTE_ORDER);
+	writer << _flags;
+
+	writer << PAYLOAD_TYPE_0;
+	_body.write(writer);
+
+	if (!_documents.empty())
+	{
+		// Serialise attached documents
+
+		std::stringstream ssdoc;
+		BinaryWriter wdoc(ssdoc, BinaryWriter::LITTLE_ENDIAN_BYTE_ORDER);
+		for (auto& doc: _documents)
+		{
+			doc->write(wdoc);
+		}
+		wdoc.flush();
+
+		const std::string& identifier = commandIdentifier(_commandName);
+		const Poco::Int32 size = static_cast<Poco::Int32>(sizeof(size) + identifier.size() + 1 + ssdoc.tellp());
+		writer << PAYLOAD_TYPE_1;
+		writer << size;
+		writer.writeCString(identifier.c_str());
+		StreamCopier::copyStream(ssdoc, ss);
+	}
+	writer.flush();
+
+#if POCO_MONGODB_DUMP
+	const std::string section = ss.str();
+	std::string dump;
+	Logger::formatDump(dump, section.data(), section.length());
+	std::cout << dump << std::endl;
+#endif
+
+	messageLength(static_cast<Poco::Int32>(ss.tellp()));
+
+	_header.write(socketWriter);
+	StreamCopier::copyStream(ss, ostr);
+
+	ostr.flush();
+}
+
+
+void OpMsgMessage::read(std::istream& istr)
+{
+	std::string message;
+	{
+		BinaryReader reader(istr, BinaryReader::LITTLE_ENDIAN_BYTE_ORDER);
+		_header.read(reader);
+
+		poco_assert_dbg(_header.opCode() == _header.OP_MSG);
+
+		const std::streamsize remainingSize {_header.getMessageLength() - _header.MSG_HEADER_SIZE };
+		message.reserve(remainingSize);
+
+#if POCO_MONGODB_DUMP
+		std::cout
+			<< "Message hdr: " << _header.getMessageLength() << " " << remainingSize << " "
+			<< _header.opCode() << " " << _header.getRequestID() << " " << _header.responseTo()
+			<< std::endl;
+#endif
+		
+		reader.readRaw(remainingSize, message);
+
+#if POCO_MONGODB_DUMP
+		std::string dump;
+		Logger::formatDump(dump, message.data(), message.length());
+		std::cout << dump << std::endl;
+#endif
+	}
+	// Read complete message and then interpret it.
+
+	std::istringstream msgss(message);
+	BinaryReader reader(msgss, BinaryReader::LITTLE_ENDIAN_BYTE_ORDER);
+
+	Poco::UInt8 payloadType {0xFF};
+
+	reader >> _flags;
+	reader >> payloadType;
+	poco_assert_dbg(payloadType == PAYLOAD_TYPE_0);
+
+	_body.read(reader);
+
+	// Read next sections from the buffer
+	while (msgss.good())
+	{
+		// NOTE: Not tested yet with database, because it returns everything in the body.
+		// Does MongoDB ever return documents as Payload type 1?
+		reader >> payloadType;
+		if (!msgss.good())
+		{
+			break;
+		}
+		poco_assert_dbg(payloadType == PAYLOAD_TYPE_1);
+#if POCO_MONGODB_DUMP
+		std::cout << "section payload: " << payloadType << std::endl;
+#endif
+
+		Poco::Int32 sectionSize {0};
+		reader >> sectionSize;
+		poco_assert_dbg(sectionSize > 0);
+
+#if POCO_MONGODB_DUMP
+		std::cout << "section size: " << sectionSize << std::endl;
+#endif
+		std::streamoff offset = sectionSize - sizeof(sectionSize);
+		std::streampos endOfSection = msgss.tellg() + offset;
+
+		std::string identifier;
+		reader.readCString(identifier);
+#if POCO_MONGODB_DUMP
+		std::cout << "section identifier: " << identifier << std::endl;
+#endif
+
+		// Loop to read documents from this section.
+		while (msgss.tellg() < endOfSection)
+		{
+#if POCO_MONGODB_DUMP
+			std::cout << "section doc: " << msgss.tellg() << " " << endOfSection << std::endl;
+#endif
+			Document::Ptr doc = new Document();
+			doc->read(reader);
+			_documents.push_back(doc);
+			if (msgss.tellg() < 0)
+			{
+				break;
+			}
+		}
+	}
+
+	// Extract documents from the cursor batch if they are there.
+	MongoDB::Array::Ptr batch;
+	auto curDoc = _body.get<MongoDB::Document::Ptr>(keyCursor, nullptr);
+	if (curDoc)
+	{
+		batch = curDoc->get<MongoDB::Array::Ptr>(keyFirstBatch, nullptr);
+		if (!batch)
+		{
+			batch = curDoc->get<MongoDB::Array::Ptr>(keyNextBatch, nullptr);
+		}
+	}
+	if (batch)
+	{
+		for(std::size_t i = 0; i < batch->size(); i++)
+		{
+			const auto& d = batch->get<MongoDB::Document::Ptr>(i, nullptr);
+			if (d)
+			{
+				_documents.push_back(d);
+			}
+		}
+	}
+
+}
+
+const std::string& commandIdentifier(const std::string& command)
+{
+	// Names of identifiers for commands that send bulk documents in the request
+	// The identifier is set in the section type 1.
+	static std::map<std::string, std::string> identifiers {
+		{ OpMsgMessage::CMD_INSERT, "documents" },
+		{ OpMsgMessage::CMD_DELETE, "deletes" },
+		{ OpMsgMessage::CMD_UPDATE, "updates" },
+
+		// Not sure if create index can send document section
+		{ OpMsgMessage::CMD_CREATE_INDEXES, "indexes" }
+	};
+
+	const auto i = identifiers.find(command);
+	if (i != identifiers.end())
+	{
+		return i->second;
+	}
+
+	// This likely means that documents are incorrectly set for a command
+	// that does not send list of documents in section type 1.
+	static const std::string emptyIdentifier;
+	return emptyIdentifier;
+}
+
+
+} } // namespace Poco::MongoDB
diff --git a/base/poco/MongoDB/src/QueryRequest.cpp b/base/poco/MongoDB/src/QueryRequest.cpp
index 7044335ba30..6d7d23a8456 100644
--- a/base/poco/MongoDB/src/QueryRequest.cpp
+++ b/base/poco/MongoDB/src/QueryRequest.cpp
@@ -20,10 +20,10 @@ namespace MongoDB {
 
 
 QueryRequest::QueryRequest(const std::string& collectionName, QueryRequest::Flags flags):
-	RequestMessage(MessageHeader::OP_QUERY), 
-	_flags(flags), 
+	RequestMessage(MessageHeader::OP_QUERY),
+	_flags(flags),
 	_fullCollectionName(collectionName),
-	_numberToSkip(0), 
+	_numberToSkip(0),
 	_numberToReturn(100),
 	_selector(),
 	_returnFieldSelector()
diff --git a/base/poco/MongoDB/src/RegularExpression.cpp b/base/poco/MongoDB/src/RegularExpression.cpp
index e95e7da82e1..5f7eb6bb51b 100644
--- a/base/poco/MongoDB/src/RegularExpression.cpp
+++ b/base/poco/MongoDB/src/RegularExpression.cpp
@@ -25,8 +25,8 @@ RegularExpression::RegularExpression()
 }
 
 
-RegularExpression::RegularExpression(const std::string& pattern, const std::string& options): 
-	_pattern(pattern), 
+RegularExpression::RegularExpression(const std::string& pattern, const std::string& options):
+	_pattern(pattern),
 	_options(options)
 {
 }
diff --git a/base/poco/MongoDB/src/ReplicaSet.cpp b/base/poco/MongoDB/src/ReplicaSet.cpp
index b56fea49311..fce2f2bdada 100644
--- a/base/poco/MongoDB/src/ReplicaSet.cpp
+++ b/base/poco/MongoDB/src/ReplicaSet.cpp
@@ -21,7 +21,7 @@ namespace Poco {
 namespace MongoDB {
 
 
-ReplicaSet::ReplicaSet(const std::vector<Net::SocketAddress> &addresses): 
+ReplicaSet::ReplicaSet(const std::vector<Net::SocketAddress> &addresses):
 	_addresses(addresses)
 {
 }
@@ -81,8 +81,8 @@ Connection::Ptr ReplicaSet::isMaster(const Net::SocketAddress& address)
 	{
 		conn = 0;
 	}
-	
-	return 0; 
+
+	return 0;
 }
 
 
diff --git a/base/poco/MongoDB/src/RequestMessage.cpp b/base/poco/MongoDB/src/RequestMessage.cpp
index 6391d966198..999ed8a6ba1 100644
--- a/base/poco/MongoDB/src/RequestMessage.cpp
+++ b/base/poco/MongoDB/src/RequestMessage.cpp
@@ -21,7 +21,7 @@ namespace Poco {
 namespace MongoDB {
 
 
-RequestMessage::RequestMessage(MessageHeader::OpCode opcode): 
+RequestMessage::RequestMessage(MessageHeader::OpCode opcode):
 	Message(opcode)
 {
 }
@@ -35,7 +35,7 @@ RequestMessage::~RequestMessage()
 void RequestMessage::send(std::ostream& ostr)
 {
 	std::stringstream ss;
-	BinaryWriter requestWriter(ss);
+	BinaryWriter requestWriter(ss, BinaryWriter::LITTLE_ENDIAN_BYTE_ORDER);
 	buildRequest(requestWriter);
 	requestWriter.flush();
 
diff --git a/base/poco/MongoDB/src/ResponseMessage.cpp b/base/poco/MongoDB/src/ResponseMessage.cpp
index 3254ace63e6..e8216767494 100644
--- a/base/poco/MongoDB/src/ResponseMessage.cpp
+++ b/base/poco/MongoDB/src/ResponseMessage.cpp
@@ -21,10 +21,20 @@ namespace MongoDB {
 
 
 ResponseMessage::ResponseMessage():
-	Message(MessageHeader::OP_REPLY), 
-	_responseFlags(0), 
-	_cursorID(0), 
-	_startingFrom(0), 
+	Message(MessageHeader::OP_REPLY),
+	_responseFlags(0),
+	_cursorID(0),
+	_startingFrom(0),
+	_numberReturned(0)
+{
+}
+
+
+ResponseMessage::ResponseMessage(const Int64& cursorID):
+	Message(MessageHeader::OP_REPLY),
+	_responseFlags(0),
+	_cursorID(cursorID),
+	_startingFrom(0),
 	_numberReturned(0)
 {
 }
@@ -50,7 +60,7 @@ void ResponseMessage::read(std::istream& istr)
 	clear();
 
 	BinaryReader reader(istr, BinaryReader::LITTLE_ENDIAN_BYTE_ORDER);
-	
+
 	_header.read(reader);
 
 	reader >> _responseFlags;
diff --git a/base/poco/MongoDB/src/UpdateRequest.cpp b/base/poco/MongoDB/src/UpdateRequest.cpp
index 2af4621ff64..7477fc752d5 100644
--- a/base/poco/MongoDB/src/UpdateRequest.cpp
+++ b/base/poco/MongoDB/src/UpdateRequest.cpp
@@ -20,7 +20,7 @@ namespace MongoDB {
 
 
 UpdateRequest::UpdateRequest(const std::string& collectionName, UpdateRequest::Flags flags):
-	RequestMessage(MessageHeader::OP_UPDATE), 
+	RequestMessage(MessageHeader::OP_UPDATE),
 	_flags(flags),
 	_fullCollectionName(collectionName),
 	_selector(),
diff --git a/docker/test/integration/runner/compose/docker_compose_mongo.yml b/docker/test/integration/runner/compose/docker_compose_mongo.yml
index 9a6eae6ca8c..60361e9e98d 100644
--- a/docker/test/integration/runner/compose/docker_compose_mongo.yml
+++ b/docker/test/integration/runner/compose/docker_compose_mongo.yml
@@ -1,7 +1,7 @@
 version: '2.3'
 services:
     mongo1:
-        image: mongo:5.0
+        image: mongo:5.1
         restart: always
         environment:
             MONGO_INITDB_ROOT_USERNAME: root
diff --git a/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml b/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml
index 193e5d26568..f5b0ffed130 100644
--- a/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml
+++ b/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml
@@ -1,7 +1,7 @@
 version: '2.3'
 services:
     mongo1:
-        image: mongo:3.6
+        image: mongo:3.5
         restart: always
         environment:
             MONGO_INITDB_ROOT_USERNAME: root
diff --git a/src/Dictionaries/MongoDBDictionarySource.cpp b/src/Dictionaries/MongoDBDictionarySource.cpp
index b7e342f3c80..46910fa9f6a 100644
--- a/src/Dictionaries/MongoDBDictionarySource.cpp
+++ b/src/Dictionaries/MongoDBDictionarySource.cpp
@@ -170,7 +170,7 @@ MongoDBDictionarySource::~MongoDBDictionarySource() = default;
 
 QueryPipeline MongoDBDictionarySource::loadAll()
 {
-    return QueryPipeline(std::make_shared<MongoDBSource>(connection, createCursor(db, collection, sample_block), sample_block, max_block_size));
+    return QueryPipeline(std::make_shared<MongoDBSource>(connection, db, collection, Poco::MongoDB::Document{}, sample_block, max_block_size));
 }
 
 QueryPipeline MongoDBDictionarySource::loadIds(const std::vector<UInt64> & ids)
@@ -178,7 +178,7 @@ QueryPipeline MongoDBDictionarySource::loadIds(const std::vector<UInt64> & ids)
     if (!dict_struct.id)
         throw Exception(ErrorCodes::UNSUPPORTED_METHOD, "'id' is required for selective loading");
 
-    auto cursor = createCursor(db, collection, sample_block);
+    Poco::MongoDB::Document query;
 
     /** NOTE: While building array, Poco::MongoDB requires passing of different unused element names, along with values.
       * In general, Poco::MongoDB is quite inefficient and bulky.
@@ -188,9 +188,9 @@ QueryPipeline MongoDBDictionarySource::loadIds(const std::vector<UInt64> & ids)
     for (const UInt64 id : ids)
         ids_array->add(DB::toString(id), static_cast<Int32>(id));
 
-    cursor->query().selector().addNewDocument(dict_struct.id->name).add("$in", ids_array);
+    query.addNewDocument(dict_struct.id->name).add("$in", ids_array);
 
-    return QueryPipeline(std::make_shared<MongoDBSource>(connection, std::move(cursor), sample_block, max_block_size));
+    return QueryPipeline(std::make_shared<MongoDBSource>(connection, db, collection, query, sample_block, max_block_size));
 }
 
 
@@ -199,8 +199,7 @@ QueryPipeline MongoDBDictionarySource::loadKeys(const Columns & key_columns, con
     if (!dict_struct.key)
         throw Exception(ErrorCodes::UNSUPPORTED_METHOD, "'key' is required for selective loading");
 
-    auto cursor = createCursor(db, collection, sample_block);
-
+    Poco::MongoDB::Document query;
     Poco::MongoDB::Array::Ptr keys_array(new Poco::MongoDB::Array);
 
     for (const auto row_idx : requested_rows)
@@ -254,9 +253,9 @@ QueryPipeline MongoDBDictionarySource::loadKeys(const Columns & key_columns, con
     }
 
     /// If more than one key we should use $or
-    cursor->query().selector().add("$or", keys_array);
+    query.add("$or", keys_array);
 
-    return QueryPipeline(std::make_shared<MongoDBSource>(connection, std::move(cursor), sample_block, max_block_size));
+    return QueryPipeline(std::make_shared<MongoDBSource>(connection, db, collection, query, sample_block, max_block_size));
 }
 
 std::string MongoDBDictionarySource::toString() const
diff --git a/src/Dictionaries/MongoDBDictionarySource.h b/src/Dictionaries/MongoDBDictionarySource.h
index fefcb1bff9f..6d93bc6c090 100644
--- a/src/Dictionaries/MongoDBDictionarySource.h
+++ b/src/Dictionaries/MongoDBDictionarySource.h
@@ -16,7 +16,6 @@ namespace Util
 namespace MongoDB
 {
     class Connection;
-    class Cursor;
 }
 }
 
diff --git a/src/Processors/Sources/MongoDBSource.cpp b/src/Processors/Sources/MongoDBSource.cpp
index 279a842143f..94b9cb7ad64 100644
--- a/src/Processors/Sources/MongoDBSource.cpp
+++ b/src/Processors/Sources/MongoDBSource.cpp
@@ -3,10 +3,12 @@
 #include <string>
 #include <vector>
 
+#include <Poco/MongoDB/Array.h>
+#include <Poco/MongoDB/Database.h>
 #include <Poco/MongoDB/Connection.h>
 #include <Poco/MongoDB/Cursor.h>
+#include <Poco/MongoDB/OpMsgCursor.h>
 #include <Poco/MongoDB/ObjectId.h>
-#include <Poco/MongoDB/Array.h>
 
 #include <Columns/ColumnArray.h>
 #include <Columns/ColumnNullable.h>
@@ -365,27 +367,79 @@ namespace
 }
 
 
-std::unique_ptr<Poco::MongoDB::Cursor> createCursor(const std::string & database, const std::string & collection, const Block & sample_block_to_select)
+bool isMongoDBWireProtocolOld(Poco::MongoDB::Connection & connection_)
 {
-    auto cursor = std::make_unique<Poco::MongoDB::Cursor>(database, collection);
+    Poco::MongoDB::Database db("config");
+    Poco::MongoDB::Document::Ptr doc = db.queryServerHello(connection_);
+    auto _wireVersion = doc->getInteger("maxWireVersion");
+    return _wireVersion < Poco::MongoDB::Database::WireVersion::VER_36;
+}
+
+
+MongoDBCursor::MongoDBCursor(
+    const std::string & database,
+    const std::string & collection,
+    const Block & sample_block_to_select,
+    const Poco::MongoDB::Document & query,
+    Poco::MongoDB::Connection & connection)
+    : is_wire_protocol_old(isMongoDBWireProtocolOld(connection))
+{
+    Poco::MongoDB::Document projection;
 
     /// Looks like selecting _id column is implicit by default.
     if (!sample_block_to_select.has("_id"))
-        cursor->query().returnFieldSelector().add("_id", 0);
+        projection.add("_id", 0);
 
     for (const auto & column : sample_block_to_select)
-        cursor->query().returnFieldSelector().add(column.name, 1);
-    return cursor;
+        projection.add(column.name, 1);
+
+    if (is_wire_protocol_old)
+    {
+        old_cursor = std::make_unique<Poco::MongoDB::Cursor>(database, collection);
+        old_cursor->query().selector() = query;
+        old_cursor->query().returnFieldSelector() = projection;
+    }
+    else
+    {
+        new_cursor = std::make_unique<Poco::MongoDB::OpMsgCursor>(database, collection);
+        new_cursor->query().setCommandName(Poco::MongoDB::OpMsgMessage::CMD_FIND);
+        new_cursor->query().body().addNewDocument("filter") = query;
+        new_cursor->query().body().addNewDocument("projection") = projection;
+    }
 }
 
+Poco::MongoDB::Document::Vector MongoDBCursor::nextDocuments(Poco::MongoDB::Connection & connection)
+{
+    if (is_wire_protocol_old)
+    {
+        auto response = old_cursor->next(connection);
+        cursorID_ = response.cursorID();
+        return std::move(response.documents());
+    }
+    else
+    {
+        auto response = new_cursor->next(connection);
+        cursorID_ = new_cursor->cursorID();
+        return std::move(response.documents());
+    }
+}
+
+Int64 MongoDBCursor::cursorID()
+{
+    return cursorID_;
+}
+
+
 MongoDBSource::MongoDBSource(
     std::shared_ptr<Poco::MongoDB::Connection> & connection_,
-    std::unique_ptr<Poco::MongoDB::Cursor> cursor_,
+    const String & database_name_,
+    const String & collection_name_,
+    const Poco::MongoDB::Document & query_,
     const Block & sample_block,
     UInt64 max_block_size_)
     : ISource(sample_block.cloneEmpty())
     , connection(connection_)
-    , cursor{std::move(cursor_)}
+    , cursor(database_name_, collection_name_, sample_block, query_, *connection_)
     , max_block_size{max_block_size_}
 {
     description.init(sample_block);
@@ -412,9 +466,9 @@ Chunk MongoDBSource::generate()
     size_t num_rows = 0;
     while (num_rows < max_block_size)
     {
-        Poco::MongoDB::ResponseMessage & response = cursor->next(*connection);
+        auto documents = cursor.nextDocuments(*connection);
 
-        for (auto & document : response.documents())
+        for (auto & document : documents)
         {
             if (document->exists("ok") && document->exists("$err")
                 && document->exists("code") && document->getInteger("ok") == 0)
@@ -458,7 +512,7 @@ Chunk MongoDBSource::generate()
             }
         }
 
-        if (response.cursorID() == 0)
+        if (cursor.cursorID() == 0)
         {
             all_read = true;
             break;
diff --git a/src/Processors/Sources/MongoDBSource.h b/src/Processors/Sources/MongoDBSource.h
index d4681d2c05f..f816ccfd1c9 100644
--- a/src/Processors/Sources/MongoDBSource.h
+++ b/src/Processors/Sources/MongoDBSource.h
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <Poco/MongoDB/Element.h>
+#include <Poco/MongoDB/Array.h>
 
 #include <Core/Block.h>
 #include <Processors/ISource.h>
@@ -14,7 +15,9 @@ namespace Poco
 namespace MongoDB
 {
     class Connection;
+    class Document;
     class Cursor;
+    class OpMsgCursor;
 }
 }
 
@@ -30,7 +33,28 @@ struct MongoDBArrayInfo
 
 void authenticate(Poco::MongoDB::Connection & connection, const std::string & database, const std::string & user, const std::string & password);
 
-std::unique_ptr<Poco::MongoDB::Cursor> createCursor(const std::string & database, const std::string & collection, const Block & sample_block_to_select);
+bool isMongoDBWireProtocolOld(Poco::MongoDB::Connection & connection_);
+
+class MongoDBCursor
+{
+public:
+    MongoDBCursor(
+        const std::string & database,
+        const std::string & collection,
+        const Block & sample_block_to_select,
+        const Poco::MongoDB::Document & query,
+        Poco::MongoDB::Connection & connection);
+
+    Poco::MongoDB::Document::Vector nextDocuments(Poco::MongoDB::Connection & connection);
+
+    Int64 cursorID();
+
+private:
+    const bool is_wire_protocol_old;
+    std::unique_ptr<Poco::MongoDB::Cursor> old_cursor;
+    std::unique_ptr<Poco::MongoDB::OpMsgCursor> new_cursor;
+    Int64 cursorID_ = 0;
+};
 
 /// Converts MongoDB Cursor to a stream of Blocks
 class MongoDBSource final : public ISource
@@ -38,7 +62,9 @@ class MongoDBSource final : public ISource
 public:
     MongoDBSource(
         std::shared_ptr<Poco::MongoDB::Connection> & connection_,
-        std::unique_ptr<Poco::MongoDB::Cursor> cursor_,
+        const String & database_name_,
+        const String & collection_name_,
+        const Poco::MongoDB::Document & query_,
         const Block & sample_block,
         UInt64 max_block_size_);
 
@@ -50,7 +76,7 @@ private:
     Chunk generate() override;
 
     std::shared_ptr<Poco::MongoDB::Connection> connection;
-    std::unique_ptr<Poco::MongoDB::Cursor> cursor;
+    MongoDBCursor cursor;
     const UInt64 max_block_size;
     ExternalResultDescription description;
     bool all_read = false;
diff --git a/src/Storages/StorageMongoDB.cpp b/src/Storages/StorageMongoDB.cpp
index 63b8c2d00a1..2a1d7e80c07 100644
--- a/src/Storages/StorageMongoDB.cpp
+++ b/src/Storages/StorageMongoDB.cpp
@@ -99,6 +99,7 @@ public:
         , db_name(db_name_)
         , metadata_snapshot{metadata_snapshot_}
         , connection(connection_)
+        , is_wire_protocol_old(isMongoDBWireProtocolOld(*connection_))
     {
     }
 
@@ -107,7 +108,7 @@ public:
     void consume(Chunk chunk) override
     {
         Poco::MongoDB::Database db(db_name);
-        Poco::MongoDB::Document::Ptr index = new Poco::MongoDB::Document();
+        Poco::MongoDB::Document::Vector documents;
 
         auto block = getHeader().cloneWithColumns(chunk.detachColumns());
 
@@ -118,20 +119,35 @@ public:
         const auto data_types = block.getDataTypes();
         const auto data_names = block.getNames();
 
-        std::vector<std::string> row(num_cols);
+        documents.reserve(num_rows);
+
         for (const auto i : collections::range(0, num_rows))
         {
+            Poco::MongoDB::Document::Ptr document = new Poco::MongoDB::Document();
+
             for (const auto j : collections::range(0, num_cols))
             {
                 WriteBufferFromOwnString ostr;
                 data_types[j]->getDefaultSerialization()->serializeText(*columns[j], i, ostr, FormatSettings{});
-                row[j] = ostr.str();
-                index->add(data_names[j], row[j]);
+                document->add(data_names[j], ostr.str());
             }
+
+            documents.push_back(std::move(document));
+        }
+
+        if (is_wire_protocol_old)
+        {
+            Poco::SharedPtr<Poco::MongoDB::InsertRequest> insert_request = db.createInsertRequest(collection_name);
+            insert_request->documents() = std::move(documents);
+            connection->sendRequest(*insert_request);
+        }
+        else
+        {
+            Poco::SharedPtr<Poco::MongoDB::OpMsgMessage> insert_request = db.createOpMsgMessage(collection_name);
+            insert_request->setCommandName(Poco::MongoDB::OpMsgMessage::CMD_INSERT);
+            insert_request->documents() = std::move(documents);
+            connection->sendRequest(*insert_request);
         }
-        Poco::SharedPtr<Poco::MongoDB::InsertRequest> insert_request = db.createInsertRequest(collection_name);
-        insert_request->documents().push_back(index);
-        connection->sendRequest(*insert_request);
     }
 
 private:
@@ -139,6 +155,8 @@ private:
     String db_name;
     StorageMetadataPtr metadata_snapshot;
     std::shared_ptr<Poco::MongoDB::Connection> connection;
+
+    const bool is_wire_protocol_old;
 };
 
 
@@ -162,7 +180,7 @@ Pipe StorageMongoDB::read(
         sample_block.insert({ column_data.type, column_data.name });
     }
 
-    return Pipe(std::make_shared<MongoDBSource>(connection, createCursor(database_name, collection_name, sample_block), sample_block, max_block_size));
+    return Pipe(std::make_shared<MongoDBSource>(connection, database_name, collection_name, Poco::MongoDB::Document{}, sample_block, max_block_size));
 }
 
 SinkToStoragePtr StorageMongoDB::write(const ASTPtr & /* query */, const StorageMetadataPtr & metadata_snapshot, ContextPtr /* context */)
diff --git a/tests/integration/test_storage_mongodb/test.py b/tests/integration/test_storage_mongodb/test.py
index 6ba5520704d..e6e77c64515 100644
--- a/tests/integration/test_storage_mongodb/test.py
+++ b/tests/integration/test_storage_mongodb/test.py
@@ -71,6 +71,39 @@ def test_simple_select(started_cluster):
     simple_mongo_table.drop()
 
 
+def test_simple_select_from_view(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+    simple_mongo_table_view = db.create_collection(
+        "simple_table_view", viewOn="simple_table"
+    )
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo2:27017', 'test', 'simple_table_view', 'root', 'clickhouse')"
+    )
+
+    assert node.query("SELECT COUNT() FROM simple_mongo_table") == "100\n"
+    assert (
+        node.query("SELECT sum(key) FROM simple_mongo_table")
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query("SELECT data from simple_mongo_table where key = 42")
+        == hex(42 * 42) + "\n"
+    )
+    node.query("DROP TABLE simple_mongo_table")
+    simple_mongo_table_view.drop()
+    simple_mongo_table.drop()
+
+
 @pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
 def test_arrays(started_cluster):
     mongo_connection = get_mongo_connection(started_cluster)
@@ -411,13 +444,16 @@ def test_simple_insert_select(started_cluster):
     node.query(
         "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse')"
     )
-    node.query("INSERT INTO simple_mongo_table SELECT 1, 'kek'")
+    node.query(
+        "INSERT INTO simple_mongo_table SELECT number, 'kek' || toString(number) FROM numbers(10)"
+    )
 
     assert (
-        node.query("SELECT data from simple_mongo_table where key = 1").strip() == "kek"
+        node.query("SELECT data from simple_mongo_table where key = 7").strip()
+        == "kek7"
     )
     node.query("INSERT INTO simple_mongo_table(key) SELECT 12")
-    assert int(node.query("SELECT count() from simple_mongo_table")) == 2
+    assert int(node.query("SELECT count() from simple_mongo_table")) == 11
     assert (
         node.query("SELECT data from simple_mongo_table where key = 12").strip() == ""
     )

From 9ea0575ff8c7ac04d46ec93d012debf01eda55c5 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Mon, 22 May 2023 11:24:29 +0000
Subject: [PATCH 112/722] Update: rest tests which output is differ with
 enabled analyzer

---
 .../01655_plan_optimizations.reference        | 55 ++++++++++++++++-
 .../0_stateless/01655_plan_optimizations.sh   | 60 ++++++++++++++++---
 2 files changed, 107 insertions(+), 8 deletions(-)

diff --git a/tests/queries/0_stateless/01655_plan_optimizations.reference b/tests/queries/0_stateless/01655_plan_optimizations.reference
index 48d99647b43..9796d2e4f82 100644
--- a/tests/queries/0_stateless/01655_plan_optimizations.reference
+++ b/tests/queries/0_stateless/01655_plan_optimizations.reference
@@ -1,5 +1,4 @@
 Too many optimizations applied to query plan
-Too many optimizations applied to query plan
 > sipHash should be calculated after filtration
 FUNCTION sipHash64
 Filter column: equals
@@ -27,6 +26,11 @@ COLUMN Const(UInt8) -> notEquals(y, 0)
 Aggregating
 Filter
 Filter
+> (analyzer) filter should be pushed down after aggregating, column after aggregation is const
+COLUMN Const(UInt8) -> notEquals(y_1, 0_UInt8)
+Aggregating
+Filter
+Filter
 0	1	1
 1	2	1
 2	3	1
@@ -42,6 +46,11 @@ Filter column
 ALIAS notEquals(s, 4) :: 1 -> and(notEquals(y, 0), notEquals(s, 4))
 Aggregating
 Filter column: notEquals(y, 0)
+> (analyzer) one condition of filter should be pushed down after aggregating, other condition is aliased
+Filter column
+ALIAS notEquals(s_0, 4_UInt8) :: 0 -> and(notEquals(y_1, 0_UInt8), notEquals(s_0, 4_UInt8))
+Aggregating
+Filter column: notEquals(y_1, 0_UInt8)
 0	1
 1	2
 2	3
@@ -56,6 +65,11 @@ Filter column
 FUNCTION and(minus(s, 4) :: 1, 1 :: 3) -> and(notEquals(y, 0), minus(s, 4)) UInt8 : 2
 Aggregating
 Filter column: notEquals(y, 0)
+> (analyzer) one condition of filter should be pushed down after aggregating, other condition is casted
+Filter column
+FUNCTION and(minus(s_0, 4_UInt8) :: 0, 1 :: 3) -> and(notEquals(y_1, 0_UInt8), minus(s_0, 4_UInt8)) UInt8 : 2
+Aggregating
+Filter column: notEquals(y_1, 0_UInt8)
 0	1
 1	2
 2	3
@@ -70,6 +84,11 @@ Filter column
 FUNCTION and(minus(s, 8) :: 1, minus(s, 4) :: 2) -> and(notEquals(y, 0), minus(s, 8), minus(s, 4))
 Aggregating
 Filter column: notEquals(y, 0)
+> (analyzer) one condition of filter should be pushed down after aggregating, other two conditions are ANDed
+Filter column
+FUNCTION and(minus(s_0, 8_UInt8) :: 0, minus(s_0, 4_UInt8) :: 2) -> and(notEquals(y_1, 0_UInt8), minus(s_0, 8_UInt8), minus(s_0, 4_UInt8))
+Aggregating
+Filter column: notEquals(y_1, 0_UInt8)
 0	1
 1	2
 2	3
@@ -83,6 +102,11 @@ Filter column
 ALIAS notEquals(s, 8) :: 1 -> and(notEquals(y, 0), notEquals(s, 8), minus(y, 4))
 Aggregating
 Filter column: and(notEquals(y, 0), minus(y, 4))
+> (analyzer) two conditions of filter should be pushed down after aggregating and ANDed, one condition is aliased
+Filter column
+ALIAS notEquals(s_0, 8_UInt8) :: 0 -> and(notEquals(y_1, 0_UInt8), notEquals(s_0, 8_UInt8), minus(y_1, 4_UInt8))
+Aggregating
+Filter column: and(notEquals(y_1, 0_UInt8), minus(y_1, 4_UInt8))
 0	1
 1	2
 2	3
@@ -95,11 +119,19 @@ Filter column: and(notEquals(y, 0), minus(y, 4))
 Filter column: and(notEquals(y, 2), notEquals(x, 0))
 ARRAY JOIN x
 Filter column: notEquals(y, 2)
+> (analyzer) filter is split, one part is filtered before ARRAY JOIN
+Filter column: and(notEquals(y_1, 2_UInt8), notEquals(x_0, 0_UInt8))
+ARRAY JOIN x_0
+Filter column: notEquals(y_1, 2_UInt8)
 1	3
 > filter is pushed down before Distinct
 Distinct
 Distinct
 Filter column: notEquals(y, 2)
+> (analyzer) filter is pushed down before Distinct
+Distinct
+Distinct
+Filter column: notEquals(y_1, 2_UInt8)
 0	0
 0	1
 1	0
@@ -108,12 +140,20 @@ Filter column: notEquals(y, 2)
 Sorting
 Sorting
 Filter column: and(notEquals(x, 0), notEquals(y, 0))
+> (analyzer) filter is pushed down before sorting steps
+Sorting
+Sorting
+Filter column: and(notEquals(x_0, 0_UInt8), notEquals(y_1, 0_UInt8))
 1	2
 1	1
 > filter is pushed down before TOTALS HAVING and aggregating
 TotalsHaving
 Aggregating
 Filter column: notEquals(y, 2)
+> (analyzer) filter is pushed down before TOTALS HAVING and aggregating
+TotalsHaving
+Aggregating
+Filter column: notEquals(y_0, 2_UInt8)
 0	12
 1	15
 3	10
@@ -129,12 +169,18 @@ Filter
 Join
 Filter column: notEquals(number, 1)
 Join
+> (analyzer) one condition of filter is pushed down before LEFT JOIN
+Join
+Filter column: notEquals(l.number_0, 1_UInt8)
 0	0
 3	3
 > one condition of filter is pushed down before INNER JOIN
 Join
 Filter column: notEquals(number, 1)
 Join
+> (analyzer) one condition of filter is pushed down before INNER JOIN
+Join
+Filter column: notEquals(l.number_0, 1_UInt8)
 3	3
 > filter is pushed down before UNION
 Union
@@ -149,5 +195,12 @@ FUNCTION sipHash64
 Sorting
 Expression (Before ORDER BY)
 FUNCTION plus
+> (analyzer) function calculation should be done after sorting and limit (if possible)
+> Expression should be divided into two subexpressions and only one of them should be moved after Sorting
+Expression ((Project names + (Before ORDER BY + (Projection + Change column names to column identifiers)) [lifted up part]))
+FUNCTION sipHash64
+Sorting
+Expression ((Before ORDER BY + (Projection + Change column names to column identifiers)))
+FUNCTION plus
 > this query should be executed without throwing an exception
 0
diff --git a/tests/queries/0_stateless/01655_plan_optimizations.sh b/tests/queries/0_stateless/01655_plan_optimizations.sh
index 7c299f9cc26..d68c2c8b414 100755
--- a/tests/queries/0_stateless/01655_plan_optimizations.sh
+++ b/tests/queries/0_stateless/01655_plan_optimizations.sh
@@ -124,11 +124,17 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> filter is split, one part is filtered before ARRAY JOIN"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0  -q "
     explain actions = 1 select x, y from (
         select range(number) as x, number + 1 as y from numbers(3)
     ) array join x where y != 2 and x != 0" |
     grep -o "Filter column: and(notEquals(y, 2), notEquals(x, 0))\|ARRAY JOIN x\|Filter column: notEquals(y, 2)"
+echo "> (analyzer) filter is split, one part is filtered before ARRAY JOIN"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1 select x, y from (
+        select range(number) as x, number + 1 as y from numbers(3)
+    ) array join x where y != 2 and x != 0" |
+    grep -o "Filter column: and(notEquals(y_1, 2_UInt8), notEquals(x_0, 0_UInt8))\|ARRAY JOIN x_0\|Filter column: notEquals(y_1, 2_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select x, y from (
         select range(number) as x, number + 1 as y from numbers(3)
@@ -148,12 +154,19 @@ $CLICKHOUSE_CLIENT -q "
 #     settings enable_optimize_predicate_expression=0"
 
 echo "> filter is pushed down before Distinct"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1 select x, y from (
         select distinct x, y from (select number % 2 as x, number % 3 as y from numbers(10))
     ) where y != 2
     settings enable_optimize_predicate_expression=0" |
     grep -o "Distinct\|Filter column: notEquals(y, 2)"
+echo "> (analyzer) filter is pushed down before Distinct"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1 select x, y from (
+        select distinct x, y from (select number % 2 as x, number % 3 as y from numbers(10))
+    ) where y != 2
+    settings enable_optimize_predicate_expression=0" |
+    grep -o "Distinct\|Filter column: notEquals(y_1, 2_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select x, y from (
         select distinct x, y from (select number % 2 as x, number % 3 as y from numbers(10))
@@ -161,12 +174,19 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression=0"
 
 echo "> filter is pushed down before sorting steps"
-$CLICKHOUSE_CLIENT --convert_query_to_cnf=0 -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 --convert_query_to_cnf=0 -q "
     explain actions = 1 select x, y from (
         select number % 2 as x, number % 3 as y from numbers(6) order by y desc
     ) where x != 0 and y != 0
     settings enable_optimize_predicate_expression = 0" |
     grep -o "Sorting\|Filter column: and(notEquals(x, 0), notEquals(y, 0))"
+echo "> (analyzer) filter is pushed down before sorting steps"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 --convert_query_to_cnf=0 -q "
+    explain actions = 1 select x, y from (
+        select number % 2 as x, number % 3 as y from numbers(6) order by y desc
+    ) where x != 0 and y != 0
+    settings enable_optimize_predicate_expression = 0" |
+    grep -o "Sorting\|Filter column: and(notEquals(x_0, 0_UInt8), notEquals(y_1, 0_UInt8))"
 $CLICKHOUSE_CLIENT -q "
     select x, y from (
         select number % 2 as x, number % 3 as y from numbers(6) order by y desc
@@ -174,12 +194,19 @@ $CLICKHOUSE_CLIENT -q "
     settings enable_optimize_predicate_expression = 0"
 
 echo "> filter is pushed down before TOTALS HAVING and aggregating"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1 select * from (
         select y, sum(x) from (select number as x, number % 4 as y from numbers(10)) group by y with totals
     ) where y != 2
     settings enable_optimize_predicate_expression=0" |
     grep -o "TotalsHaving\|Aggregating\|Filter column: notEquals(y, 2)"
+echo "> (analyzer) filter is pushed down before TOTALS HAVING and aggregating"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1 select * from (
+        select y, sum(x) from (select number as x, number % 4 as y from numbers(10)) group by y with totals
+    ) where y != 2
+    settings enable_optimize_predicate_expression=0" |
+    grep -o "TotalsHaving\|Aggregating\|Filter column: notEquals(y_0, 2_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select * from (
         select y, sum(x) from (select number as x, number % 4 as y from numbers(10)) group by y with totals
@@ -197,24 +224,38 @@ $CLICKHOUSE_CLIENT -q "
     ) where number != 2 settings enable_optimize_predicate_expression=0"
 
 echo "> one condition of filter is pushed down before LEFT JOIN"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1
     select number as a, r.b from numbers(4) as l any left join (
         select number + 2 as b from numbers(3)
     ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" |
     grep -o "Join\|Filter column: notEquals(number, 1)"
+echo "> (analyzer) one condition of filter is pushed down before LEFT JOIN"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1
+    select number as a, r.b from numbers(4) as l any left join (
+        select number + 2 as b from numbers(3)
+    ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" |
+    grep -o "Join\|Filter column: notEquals(l.number_0, 1_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select number as a, r.b from numbers(4) as l any left join (
         select number + 2 as b from numbers(3)
     ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" | sort
 
 echo "> one condition of filter is pushed down before INNER JOIN"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
     explain actions = 1
     select number as a, r.b from numbers(4) as l any inner join (
         select number + 2 as b from numbers(3)
     ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" |
     grep -o "Join\|Filter column: notEquals(number, 1)"
+echo "> (analyzer) one condition of filter is pushed down before INNER JOIN"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
+    explain actions = 1
+    select number as a, r.b from numbers(4) as l any inner join (
+        select number + 2 as b from numbers(3)
+    ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" |
+        grep -o "Join\|Filter column: notEquals(l.number_0, 1_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select number as a, r.b from numbers(4) as l any inner join (
         select number + 2 as b from numbers(3)
@@ -233,7 +274,12 @@ $CLICKHOUSE_CLIENT -q "
 
 echo "> function calculation should be done after sorting and limit (if possible)"
 echo "> Expression should be divided into two subexpressions and only one of them should be moved after Sorting"
-$CLICKHOUSE_CLIENT -q "
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=0 -q "
+    explain actions = 1 select number as n, sipHash64(n) from numbers(100) order by number + 1 limit 5" |
+    sed 's/^ *//g' | grep -o "^ *\(Expression (.*Before ORDER BY.*)\|Sorting\|FUNCTION \w\+\)"
+echo "> (analyzer) function calculation should be done after sorting and limit (if possible)"
+echo "> Expression should be divided into two subexpressions and only one of them should be moved after Sorting"
+$CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
     explain actions = 1 select number as n, sipHash64(n) from numbers(100) order by number + 1 limit 5" |
     sed 's/^ *//g' | grep -o "^ *\(Expression (.*Before ORDER BY.*)\|Sorting\|FUNCTION \w\+\)"
 echo "> this query should be executed without throwing an exception"

From 90f4b1777832a8e6c3a343671be091c727f3e065 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Mon, 22 May 2023 15:45:18 +0000
Subject: [PATCH 113/722] Fix build & test

---
 .../test/integration/runner/compose/docker_compose_mongo.yml  | 4 ++--
 src/Processors/Sources/MongoDBSource.cpp                      | 2 +-
 src/Processors/Sources/MongoDBSource.h                        | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/docker/test/integration/runner/compose/docker_compose_mongo.yml b/docker/test/integration/runner/compose/docker_compose_mongo.yml
index 60361e9e98d..8cdcbc421e8 100644
--- a/docker/test/integration/runner/compose/docker_compose_mongo.yml
+++ b/docker/test/integration/runner/compose/docker_compose_mongo.yml
@@ -1,7 +1,7 @@
 version: '2.3'
 services:
     mongo1:
-        image: mongo:5.1
+        image: mongo:6.0
         restart: always
         environment:
             MONGO_INITDB_ROOT_USERNAME: root
@@ -11,7 +11,7 @@ services:
         command: --profile=2 --verbose
 
     mongo2:
-        image: mongo:5.0
+        image: mongo:6.0
         restart: always
         ports:
             - ${MONGO_NO_CRED_EXTERNAL_PORT:-27017}:${MONGO_NO_CRED_INTERNAL_PORT:-27017}
diff --git a/src/Processors/Sources/MongoDBSource.cpp b/src/Processors/Sources/MongoDBSource.cpp
index 94b9cb7ad64..74dfa13158c 100644
--- a/src/Processors/Sources/MongoDBSource.cpp
+++ b/src/Processors/Sources/MongoDBSource.cpp
@@ -424,7 +424,7 @@ Poco::MongoDB::Document::Vector MongoDBCursor::nextDocuments(Poco::MongoDB::Conn
     }
 }
 
-Int64 MongoDBCursor::cursorID()
+Int64 MongoDBCursor::cursorID() const
 {
     return cursorID_;
 }
diff --git a/src/Processors/Sources/MongoDBSource.h b/src/Processors/Sources/MongoDBSource.h
index f816ccfd1c9..2bc5481e20b 100644
--- a/src/Processors/Sources/MongoDBSource.h
+++ b/src/Processors/Sources/MongoDBSource.h
@@ -47,7 +47,7 @@ public:
 
     Poco::MongoDB::Document::Vector nextDocuments(Poco::MongoDB::Connection & connection);
 
-    Int64 cursorID();
+    Int64 cursorID() const;
 
 private:
     const bool is_wire_protocol_old;

From b8305503d89783b6700ae2c43f69b96798181b03 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 22 May 2023 19:07:18 +0200
Subject: [PATCH 114/722] more flexible cleanup thread scheduling

---
 base/base/interpolate.h                       |   5 +
 src/Storages/MergeTree/IMergeTreeDataPart.cpp |  10 +-
 src/Storages/MergeTree/IMergeTreeDataPart.h   |   3 +
 src/Storages/MergeTree/MergeTreeData.cpp      |  26 ++-
 src/Storages/MergeTree/MergeTreeData.h        |   6 +
 src/Storages/MergeTree/MergeTreeSettings.h    |   4 +-
 .../ReplicatedMergeTreeCleanupThread.cpp      | 171 +++++++++++++++---
 .../ReplicatedMergeTreeCleanupThread.h        |  28 ++-
 .../MergeTree/SimpleMergeSelector.cpp         |   8 +-
 src/Storages/StorageReplicatedMergeTree.cpp   |   9 +-
 src/Storages/StorageReplicatedMergeTree.h     |   4 +-
 tests/config/config.d/merge_tree.xml          |   2 +
 .../test.py                                   |   3 +-
 .../test_broken_part_during_merge/test.py     |   2 +-
 .../test.py                                   |   6 +-
 tests/integration/test_drop_replica/test.py   |  15 +-
 tests/integration/test_jbod_balancer/test.py  |   1 +
 tests/integration/test_jbod_ha/test.py        |   1 +
 tests/integration/test_lost_part/test.py      |   8 +-
 tests/integration/test_multiple_disks/test.py |   6 +-
 .../test_old_parts_finally_removed/test.py    |   5 +-
 .../test_parts_delete_zookeeper/test.py       |   2 +-
 .../integration/test_recovery_replica/test.py |   2 +-
 tests/integration/test_storage_nats/test.py   |   3 +-
 .../integration/test_storage_rabbitmq/test.py |   6 +-
 tests/integration/test_system_metrics/test.py |   4 +-
 tests/integration/test_ttl_replicated/test.py |   3 +-
 ..._replace_partition_from_table_zookeeper.sh |   8 +-
 .../00652_replicated_mutations_zookeeper.sh   |   6 +-
 ...ated_minimalistic_part_header_zookeeper.sh |   6 +-
 ...0953_zookeeper_suetin_deduplication_bug.sh |   2 +-
 .../00988_parallel_parts_removal.sql          |   4 +-
 ...tem_parts_race_condition_zookeeper_long.sh |  10 +-
 ...tem_parts_race_condition_drop_zookeeper.sh |   3 +-
 ...034_move_partition_from_table_zookeeper.sh |   6 +-
 ...ent_move_partition_from_table_zookeeper.sh |   3 +-
 ...076_parallel_alter_replicated_zookeeper.sh |   3 +-
 ...9_parallel_alter_detach_table_zookeeper.sh |   5 +-
 .../01103_optimize_drop_race_zookeeper.sh     |   4 +-
 .../0_stateless/01158_zookeeper_log_long.sql  |   2 +-
 ...nactive_replica_cleanup_nodes_zookeeper.sh |   6 +-
 ...e_condition_rename_clear_zookeeper_long.sh |   4 +-
 .../01509_parallel_quorum_and_merge_long.sh   |   3 +-
 ...nt_ttl_and_normal_merges_zookeeper_long.sh |   3 +-
 .../0_stateless/02067_lost_part_s3.sql        |  12 +-
 .../02370_lost_part_intersecting_merges.sh    |   2 +-
 .../02396_system_parts_race_condition_rm.sh   |   8 +-
 ...397_system_parts_race_condition_drop_rm.sh |   4 +-
 .../02432_s3_parallel_parts_cleanup.sql       |   4 +-
 .../02448_clone_replica_lost_part.sql         |   6 +-
 ..._projection_and_mutation_work_together.sql |   6 +-
 .../02515_cleanup_async_insert_block_ids.sh   |   2 +-
 52 files changed, 353 insertions(+), 112 deletions(-)

diff --git a/base/base/interpolate.h b/base/base/interpolate.h
index 1d4fc0b6257..4c27f70c95b 100644
--- a/base/base/interpolate.h
+++ b/base/base/interpolate.h
@@ -11,3 +11,8 @@ constexpr double interpolateExponential(double min, double max, double ratio)
     assert(min > 0 && ratio >= 0 && ratio <= 1);
     return min * std::pow(max / min, ratio);
 }
+
+constexpr double interpolateLinear(double min, double max, double ratio)
+{
+    return std::lerp(min, max, ratio);
+}
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index d27b03fff44..3d2b6ecc540 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -211,9 +211,9 @@ void IMergeTreeDataPart::MinMaxIndex::appendFiles(const MergeTreeData & data, St
 }
 
 
-static void incrementStateMetric(MergeTreeDataPartState state)
+void IMergeTreeDataPart::incrementStateMetric(MergeTreeDataPartState state_) const
 {
-    switch (state)
+    switch (state_)
     {
         case MergeTreeDataPartState::Temporary:
             CurrentMetrics::add(CurrentMetrics::PartsTemporary);
@@ -227,6 +227,7 @@ static void incrementStateMetric(MergeTreeDataPartState state)
             CurrentMetrics::add(CurrentMetrics::PartsCommitted);
             return;
         case MergeTreeDataPartState::Outdated:
+            storage.total_outdated_parts_count.fetch_add(1, std::memory_order_relaxed);
             CurrentMetrics::add(CurrentMetrics::PartsOutdated);
             return;
         case MergeTreeDataPartState::Deleting:
@@ -238,9 +239,9 @@ static void incrementStateMetric(MergeTreeDataPartState state)
     }
 }
 
-static void decrementStateMetric(MergeTreeDataPartState state)
+void IMergeTreeDataPart::decrementStateMetric(MergeTreeDataPartState state_) const
 {
-    switch (state)
+    switch (state_)
     {
         case MergeTreeDataPartState::Temporary:
             CurrentMetrics::sub(CurrentMetrics::PartsTemporary);
@@ -254,6 +255,7 @@ static void decrementStateMetric(MergeTreeDataPartState state)
             CurrentMetrics::sub(CurrentMetrics::PartsCommitted);
             return;
         case MergeTreeDataPartState::Outdated:
+            storage.total_outdated_parts_count.fetch_sub(1, std::memory_order_relaxed);
             CurrentMetrics::sub(CurrentMetrics::PartsOutdated);
             return;
         case MergeTreeDataPartState::Deleting:
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.h b/src/Storages/MergeTree/IMergeTreeDataPart.h
index 388d96314c0..ecc1523b6c0 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.h
@@ -623,6 +623,9 @@ private:
     /// for this column with default parameters.
     CompressionCodecPtr detectDefaultCompressionCodec() const;
 
+    void incrementStateMetric(MergeTreeDataPartState state) const;
+    void decrementStateMetric(MergeTreeDataPartState state) const;
+
     mutable MergeTreeDataPartState state{MergeTreeDataPartState::Temporary};
 
     /// This ugly flag is needed for debug assertions only
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index b21f44baeb5..5cfc4c577dc 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -81,6 +81,7 @@
 #include <boost/algorithm/string/join.hpp>
 
 #include <base/insertAtEnd.h>
+#include <base/interpolate.h>
 
 #include <algorithm>
 #include <atomic>
@@ -4311,6 +4312,29 @@ size_t MergeTreeData::getActivePartsCount() const
 }
 
 
+size_t MergeTreeData::getOutdatedPartsCount() const
+{
+    return total_outdated_parts_count.load(std::memory_order_relaxed);
+}
+
+size_t MergeTreeData::getNumberOfOutdatedPartsWithExpiredRemovalTime() const
+{
+    size_t res = 0;
+
+    auto time_now = time(nullptr);
+
+    auto parts_lock = lockParts();
+    auto outdated_parts_range = getDataPartsStateRange(DataPartState::Outdated);
+    for (const auto & part : outdated_parts_range)
+    {
+        auto part_remove_time = part->remove_time.load(std::memory_order_relaxed);
+        if (part_remove_time <= time_now && time_now - part_remove_time >= getSettings()->old_parts_lifetime.totalSeconds() && part.unique())
+            ++res;
+    }
+
+    return res;
+}
+
 std::pair<size_t, size_t> MergeTreeData::getMaxPartsCountAndSizeForPartitionWithState(DataPartState state) const
 {
     auto lock = lockParts();
@@ -4519,7 +4543,7 @@ void MergeTreeData::delayMutationOrThrowIfNeeded(Poco::Event * until, const Cont
         size_t allowed_mutations_over_threshold = num_mutations_to_throw - num_mutations_to_delay;
 
         double delay_factor = std::min(static_cast<double>(mutations_over_threshold) / allowed_mutations_over_threshold, 1.0);
-        size_t delay_milliseconds = static_cast<size_t>(std::lerp(settings->min_delay_to_mutate_ms, settings->max_delay_to_mutate_ms, delay_factor));
+        size_t delay_milliseconds = static_cast<size_t>(interpolateLinear(settings->min_delay_to_mutate_ms, settings->max_delay_to_mutate_ms, delay_factor));
 
         ProfileEvents::increment(ProfileEvents::DelayedMutations);
         ProfileEvents::increment(ProfileEvents::DelayedMutationsMilliseconds, delay_milliseconds);
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index 5488ce72631..4a71c24e6d3 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -532,6 +532,10 @@ public:
 
     size_t getActivePartsCount() const;
 
+    size_t getOutdatedPartsCount() const;
+
+    size_t getNumberOfOutdatedPartsWithExpiredRemovalTime() const;
+
     /// Returns a pair with: max number of parts in partition across partitions; sum size of parts inside that partition.
     /// (if there are multiple partitions with max number of parts, the sum size of parts is returned for arbitrary of them)
     std::pair<size_t, size_t> getMaxPartsCountAndSizeForPartitionWithState(DataPartState state) const;
@@ -1491,6 +1495,8 @@ private:
     std::atomic<size_t> total_active_size_rows = 0;
     std::atomic<size_t> total_active_size_parts = 0;
 
+    mutable std::atomic<size_t> total_outdated_parts_count = 0;
+
     // Record all query ids which access the table. It's guarded by `query_id_set_mutex` and is always mutable.
     mutable std::set<String> query_id_set TSA_GUARDED_BY(query_id_set_mutex);
     mutable std::mutex query_id_set_mutex;
diff --git a/src/Storages/MergeTree/MergeTreeSettings.h b/src/Storages/MergeTree/MergeTreeSettings.h
index c9e81ce9103..78d703e795c 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.h
+++ b/src/Storages/MergeTree/MergeTreeSettings.h
@@ -120,8 +120,10 @@ struct Settings;
     \
     /** Check delay of replicas settings. */ \
     M(UInt64, min_relative_delay_to_measure, 120, "Calculate relative replica delay only if absolute delay is not less that this value.", 0) \
-    M(UInt64, cleanup_delay_period, 30, "Period to clean old queue logs, blocks hashes and parts.", 0) \
+    M(UInt64, cleanup_delay_period, 30, "Minimum period to clean old queue logs, blocks hashes and parts.", 0) \
+    M(UInt64, max_cleanup_delay_period, 300, "Maximum period to clean old queue logs, blocks hashes and parts.", 0) \
     M(UInt64, cleanup_delay_period_random_add, 10, "Add uniformly distributed value from 0 to x seconds to cleanup_delay_period to avoid thundering herd effect and subsequent DoS of ZooKeeper in case of very large number of tables.", 0) \
+    M(UInt64, cleanup_thread_preferred_points_per_iteration, 150, "Preferred batch size for background cleanup (points are abstract but 1 point is approximately equivalent to 1 inserted block).", 0) \
     M(UInt64, min_relative_delay_to_close, 300, "Minimal delay from other replicas to close, stop serving requests and not return Ok during status check.", 0) \
     M(UInt64, min_absolute_delay_to_close, 0, "Minimal absolute delay to close, stop serving requests and not return Ok during status check.", 0) \
     M(UInt64, enable_vertical_merge_algorithm, 1, "Enable usage of Vertical merge algorithm.", 0) \
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp
index 0409cadc1e9..35a860ebb42 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp
@@ -25,19 +25,22 @@ ReplicatedMergeTreeCleanupThread::ReplicatedMergeTreeCleanupThread(StorageReplic
     : storage(storage_)
     , log_name(storage.getStorageID().getFullTableName() + " (ReplicatedMergeTreeCleanupThread)")
     , log(&Poco::Logger::get(log_name))
+    , sleep_ms(storage.getSettings()->cleanup_delay_period * 1000)
 {
     task = storage.getContext()->getSchedulePool().createTask(log_name, [this]{ run(); });
 }
 
 void ReplicatedMergeTreeCleanupThread::run()
 {
-    auto storage_settings = storage.getSettings();
-    const auto sleep_ms = storage_settings->cleanup_delay_period * 1000
-        + std::uniform_int_distribution<UInt64>(0, storage_settings->cleanup_delay_period_random_add * 1000)(rng);
+    SCOPE_EXIT({ is_running.store(false, std::memory_order_relaxed); });
+    is_running.store(true, std::memory_order_relaxed);
 
+    auto storage_settings = storage.getSettings();
+
+    Float32 cleanup_points = 0;
     try
     {
-        iterate();
+        cleanup_points = iterate();
     }
     catch (const Coordination::Exception & e)
     {
@@ -51,39 +54,144 @@ void ReplicatedMergeTreeCleanupThread::run()
         tryLogCurrentException(log, __PRETTY_FUNCTION__);
     }
 
+    UInt64 prev_timestamp = prev_cleanup_timestamp_ms.load(std::memory_order_relaxed);
+    UInt64 now_ms = clock_gettime_ns_adjusted(prev_timestamp * 1'000'000) / 1'000'000;
+
+    /// Do not adjust sleep_ms on the first run after starting the server
+    if (prev_timestamp && storage_settings->cleanup_thread_preferred_points_per_iteration)
+    {
+        /// We don't want to run the task too often when the table was barely changed and there's almost nothing to cleanup.
+        /// But we cannot simply sleep max_cleanup_delay_period (300s) when nothing was cleaned up and cleanup_delay_period (30s)
+        /// when we removed something, because inserting one part per 30s will lead to running cleanup each 30s just to remove one part.
+        /// So we need some interpolation based on preferred batch size.
+        auto expected_cleanup_points = storage_settings->cleanup_thread_preferred_points_per_iteration;
+
+        /// How long should we sleep to remove cleanup_thread_preferred_points_per_iteration on the next iteration?
+        Float32 ratio = cleanup_points / expected_cleanup_points;
+        if (ratio == 0)
+            sleep_ms = storage_settings->max_cleanup_delay_period * 1000;
+        else
+            sleep_ms = static_cast<UInt64>(sleep_ms / ratio);
+
+        if (sleep_ms < storage_settings->cleanup_delay_period * 1000)
+            sleep_ms = storage_settings->cleanup_delay_period * 1000;
+        if (storage_settings->max_cleanup_delay_period * 1000 < sleep_ms)
+            sleep_ms = storage_settings->max_cleanup_delay_period * 1000;
+
+        UInt64 interval_ms = now_ms - prev_timestamp;
+        LOG_TRACE(log, "Scheduling next cleanup after {}ms (points: {}, interval: {}ms, ratio: {}, points per minute: {})",
+                  sleep_ms, cleanup_points, interval_ms, ratio, cleanup_points / interval_ms * 60'000);
+    }
+    prev_cleanup_timestamp_ms.store(now_ms, std::memory_order_relaxed);
+
+    sleep_ms += std::uniform_int_distribution<UInt64>(0, storage_settings->cleanup_delay_period_random_add * 1000)(rng);
     task->scheduleAfter(sleep_ms);
 }
 
-
-void ReplicatedMergeTreeCleanupThread::iterate()
+void ReplicatedMergeTreeCleanupThread::wakeupEarlierIfNeeded()
 {
-    storage.clearOldPartsAndRemoveFromZK();
+    /// It may happen that the tables was idle for a long time, but then a user started to aggressively insert (or mutate) data.
+    /// In this case, sleep_ms was set to the highest possible value, the task is not going to wake up soon,
+    /// but the number of objects to clean up is growing. We need to wakeup the task earlier.
+    auto storage_settings = storage.getSettings();
+    if (!storage_settings->cleanup_thread_preferred_points_per_iteration)
+        return;
+
+    /// The number of other objects (logs, blocks, etc) is usually correlated with the number of Outdated parts.
+    /// Do not wake up unless we have too many.
+    size_t number_of_outdated_objects = storage.getOutdatedPartsCount();
+    if (number_of_outdated_objects < storage_settings->cleanup_thread_preferred_points_per_iteration * 2)
+        return;
+
+    /// A race condition is possible here, but it's okay
+    if (is_running.load(std::memory_order_relaxed))
+        return;
+
+    /// Do not re-check all parts too often (avoid constantly calling getNumberOfOutdatedPartsWithExpiredRemovalTime())
+    if (!wakeup_check_timer.compareAndRestart(storage_settings->cleanup_delay_period / 4))
+        return;
+
+    UInt64 prev_run_timestamp_ms = prev_cleanup_timestamp_ms.load(std::memory_order_relaxed);
+    UInt64 now_ms = clock_gettime_ns_adjusted(prev_run_timestamp_ms * 1'000'000) / 1'000'000;
+    if (!prev_run_timestamp_ms || now_ms <= prev_run_timestamp_ms)
+        return;
+
+    /// Don't run it more often than cleanup_delay_period
+    UInt64 seconds_passed = (now_ms - prev_run_timestamp_ms) / 1000;
+    if (seconds_passed < storage_settings->cleanup_delay_period)
+        return;
+
+    /// Do not count parts that cannot be removed anyway. Do not wake up unless we have too many.
+    number_of_outdated_objects = storage.getNumberOfOutdatedPartsWithExpiredRemovalTime();
+    if (number_of_outdated_objects < storage_settings->cleanup_thread_preferred_points_per_iteration * 2)
+        return;
+
+    LOG_TRACE(log, "Waking up cleanup thread because there are {} outdated objects and previous cleanup finished {}s ago",
+              number_of_outdated_objects, seconds_passed);
+
+    wakeup();
+}
+
+
+Float32 ReplicatedMergeTreeCleanupThread::iterate()
+{
+    size_t cleaned_logs = 0;
+    Float32 cleaned_blocks = 0;
+    size_t cleaned_other = 0;
+    size_t cleaned_part_like = 0;
+    size_t cleaned_parts = storage.clearOldPartsAndRemoveFromZK();
+
+    auto storage_settings = storage.getSettings();
 
     {
         auto lock = storage.lockForShare(RWLockImpl::NO_QUERY, storage.getSettings()->lock_acquire_timeout_for_background_operations);
         /// Both use relative_data_path which changes during rename, so we
         /// do it under share lock
-        storage.clearOldWriteAheadLogs();
-        storage.clearOldTemporaryDirectories(storage.getSettings()->temporary_directories_lifetime.totalSeconds());
+        cleaned_other += storage.clearOldWriteAheadLogs();
+        cleaned_part_like += storage.clearOldTemporaryDirectories(storage.getSettings()->temporary_directories_lifetime.totalSeconds());
         if (storage.getSettings()->merge_tree_enable_clear_old_broken_detached)
-            storage.clearOldBrokenPartsFromDetachedDirectory();
+            cleaned_part_like += storage.clearOldBrokenPartsFromDetachedDirectory();
     }
 
     /// This is loose condition: no problem if we actually had lost leadership at this moment
     ///  and two replicas will try to do cleanup simultaneously.
     if (storage.is_leader)
     {
-        clearOldLogs();
-        auto storage_settings = storage.getSettings();
-        clearOldBlocks("blocks", storage_settings->replicated_deduplication_window_seconds, storage_settings->replicated_deduplication_window, cached_block_stats_for_sync_inserts);
-        clearOldBlocks("async_blocks", storage_settings->replicated_deduplication_window_seconds_for_async_inserts, storage_settings->replicated_deduplication_window_for_async_inserts, cached_block_stats_for_async_inserts);
-        clearOldMutations();
-        storage.clearEmptyParts();
+        cleaned_logs = clearOldLogs();
+        size_t normal_blocks = clearOldBlocks("blocks", storage_settings->replicated_deduplication_window_seconds,
+                                   storage_settings->replicated_deduplication_window, cached_block_stats_for_sync_inserts);
+
+        size_t async_blocks = clearOldBlocks("async_blocks",
+                                   storage_settings->replicated_deduplication_window_seconds_for_async_inserts,
+                                   storage_settings->replicated_deduplication_window_for_async_inserts,
+                                   cached_block_stats_for_async_inserts);
+
+        /// Many async blocks are transformed into one ordinary block
+        Float32 async_blocks_per_block = static_cast<Float32>(storage_settings->replicated_deduplication_window) /
+            (storage_settings->replicated_deduplication_window_for_async_inserts + 1);
+        cleaned_blocks = (normal_blocks + async_blocks * async_blocks_per_block) / 2;
+
+        cleaned_other += clearOldMutations();
+        cleaned_part_like += storage.clearEmptyParts();
     }
+
+    /// We need to measure the number of removed objects somehow (for better scheduling),
+    /// but just summing the number of removed async blocks, logs, and empty parts does not make any sense.
+    /// So we are trying to (approximately) measure the number of inserted blocks/parts, so we will be able to compare apples to apples.
+
+    /// Each inserted block produces 3 objects that have to be cleaned up: one block, one log entry and one part.
+    /// A few new parts get merged together producing one log entry and one part.
+
+    /// Other objects (like mutations and WALs) are much more rare than Outdated parts (because mutations usually produce
+    /// many Outdated parts, and WALs usually contain many parts too). We count then as one part for simplicity.
+
+    constexpr Float32 parts_number_amplification = 1.3f;     /// Assuming we merge 4-5 parts each time
+    Float32 cleaned_inserted_parts = (cleaned_blocks + (cleaned_logs + cleaned_parts) / parts_number_amplification) / 3;
+    return cleaned_inserted_parts + cleaned_part_like + cleaned_other;
 }
 
 
-void ReplicatedMergeTreeCleanupThread::clearOldLogs()
+size_t ReplicatedMergeTreeCleanupThread::clearOldLogs()
 {
     auto zookeeper = storage.getZooKeeper();
     auto storage_settings = storage.getSettings();
@@ -102,7 +210,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldLogs()
     size_t min_replicated_logs_to_keep = static_cast<size_t>(storage_settings->min_replicated_logs_to_keep * ratio);
 
     if (static_cast<double>(children_count) < min_replicated_logs_to_keep)
-        return;
+        return 0;
 
     Strings replicas = zookeeper->getChildren(storage.zookeeper_path + "/replicas", &stat);
 
@@ -114,7 +222,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldLogs()
     Strings entries = zookeeper->getChildren(storage.zookeeper_path + "/log");
 
     if (entries.empty())
-        return;
+        return 0;
 
     ::sort(entries.begin(), entries.end());
 
@@ -227,7 +335,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldLogs()
     entries.erase(std::lower_bound(entries.begin(), entries.end(), "log-" + padIndex(min_saved_log_pointer)), entries.end());
 
     if (entries.empty())
-        return;
+        return 0;
 
     markLostReplicas(
         host_versions_lost_replicas,
@@ -268,6 +376,8 @@ void ReplicatedMergeTreeCleanupThread::clearOldLogs()
 
     if (i != 0)
         LOG_DEBUG(log, "Removed {} old log entries: {} - {}", i, entries[0], entries[i - 1]);
+
+    return i;
 }
 
 
@@ -323,7 +433,7 @@ struct ReplicatedMergeTreeCleanupThread::NodeWithStat
     }
 };
 
-void ReplicatedMergeTreeCleanupThread::clearOldBlocks(const String & blocks_dir_name, UInt64 window_seconds, UInt64 window_size, NodeCTimeAndVersionCache & cached_block_stats)
+size_t ReplicatedMergeTreeCleanupThread::clearOldBlocks(const String & blocks_dir_name, UInt64 window_seconds, UInt64 window_size, NodeCTimeAndVersionCache & cached_block_stats)
 {
     auto zookeeper = storage.getZooKeeper();
 
@@ -331,7 +441,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldBlocks(const String & blocks_dir_
     getBlocksSortedByTime(blocks_dir_name, *zookeeper, timed_blocks, cached_block_stats);
 
     if (timed_blocks.empty())
-        return;
+        return 0;
 
     /// Use ZooKeeper's first node (last according to time) timestamp as "current" time.
     Int64 current_time = timed_blocks.front().ctime;
@@ -350,7 +460,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldBlocks(const String & blocks_dir_
 
     auto num_nodes_to_delete = timed_blocks.end() - first_outdated_block;
     if (!num_nodes_to_delete)
-        return;
+        return 0;
 
     auto last_outdated_block = timed_blocks.end() - 1;
     LOG_TRACE(log, "Will clear {} old blocks from {} (ctime {}) to {} (ctime {})", num_nodes_to_delete,
@@ -388,6 +498,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldBlocks(const String & blocks_dir_
     }
 
     LOG_TRACE(log, "Cleared {} old blocks from ZooKeeper", num_nodes_to_delete);
+    return num_nodes_to_delete;
 }
 
 
@@ -456,17 +567,17 @@ void ReplicatedMergeTreeCleanupThread::getBlocksSortedByTime(const String & bloc
 }
 
 
-void ReplicatedMergeTreeCleanupThread::clearOldMutations()
+size_t ReplicatedMergeTreeCleanupThread::clearOldMutations()
 {
     auto storage_settings = storage.getSettings();
     if (!storage_settings->finished_mutations_to_keep)
-        return;
+        return 0;
 
     if (storage.queue.countFinishedMutations() <= storage_settings->finished_mutations_to_keep)
     {
         /// Not strictly necessary, but helps to avoid unnecessary ZooKeeper requests.
         /// If even this replica hasn't finished enough mutations yet, then we don't need to clean anything.
-        return;
+        return 0;
     }
 
     auto zookeeper = storage.getZooKeeper();
@@ -481,7 +592,7 @@ void ReplicatedMergeTreeCleanupThread::clearOldMutations()
         // No Need to check return value to delete mutations.
         zookeeper->tryGet(storage.zookeeper_path + "/replicas/" + replica + "/mutation_pointer", pointer);
         if (pointer.empty())
-            return; /// One replica hasn't done anything yet so we can't delete any mutations.
+            return 0; /// One replica hasn't done anything yet so we can't delete any mutations.
         min_pointer = std::min(parse<UInt64>(pointer), min_pointer);
     }
 
@@ -492,11 +603,11 @@ void ReplicatedMergeTreeCleanupThread::clearOldMutations()
     entries.erase(std::upper_bound(entries.begin(), entries.end(), padIndex(min_pointer)), entries.end());
     /// Do not remove last `storage_settings->finished_mutations_to_keep` entries.
     if (entries.size() <= storage_settings->finished_mutations_to_keep)
-        return;
+        return 0;
     entries.erase(entries.end() - storage_settings->finished_mutations_to_keep, entries.end());
 
     if (entries.empty())
-        return;
+        return 0;
 
     Coordination::Requests ops;
     size_t batch_start_i = 0;
@@ -526,6 +637,8 @@ void ReplicatedMergeTreeCleanupThread::clearOldMutations()
             ops.clear();
         }
     }
+
+    return entries.size();
 }
 
 }
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.h b/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.h
index 76b9ee4a575..57de7944970 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.h
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.h
@@ -4,6 +4,7 @@
 #include <Common/ZooKeeper/Types.h>
 #include <Common/ZooKeeper/ZooKeeper.h>
 #include <Common/randomSeed.h>
+#include <Common/Stopwatch.h>
 #include <Core/BackgroundSchedulePool.h>
 #include <thread>
 
@@ -31,6 +32,8 @@ public:
 
     void stop() { task->deactivate(); }
 
+    void wakeupEarlierIfNeeded();
+
 private:
     StorageReplicatedMergeTree & storage;
     String log_name;
@@ -38,11 +41,20 @@ private:
     BackgroundSchedulePool::TaskHolder task;
     pcg64 rng{randomSeed()};
 
-    void run();
-    void iterate();
+    UInt64 sleep_ms;
 
-    /// Remove old records from ZooKeeper.
-    void clearOldLogs();
+    std::atomic<UInt64> prev_cleanup_timestamp_ms = 0;
+    std::atomic<bool> is_running = false;
+
+    AtomicStopwatch wakeup_check_timer;
+
+    void run();
+
+    /// Returns a number this is directly proportional to the number of cleaned up blocks
+    Float32 iterate();
+
+    /// Remove old records from ZooKeeper. Returns the number of removed logs
+    size_t clearOldLogs();
 
     /// The replica is marked as "lost" if it is inactive and its log pointer
     ///  is far behind and we are not going to keep logs for it.
@@ -52,11 +64,11 @@ private:
                           size_t replicas_count, const zkutil::ZooKeeperPtr & zookeeper);
 
     using NodeCTimeAndVersionCache = std::map<String, std::pair<Int64, Int32>>;
-    /// Remove old block hashes from ZooKeeper. This is done by the leader replica.
-    void clearOldBlocks(const String & blocks_dir_name, UInt64 window_seconds, UInt64 window_size, NodeCTimeAndVersionCache & cached_block_stats);
+    /// Remove old block hashes from ZooKeeper. This is done by the leader replica. Returns the number of removed blocks
+    size_t clearOldBlocks(const String & blocks_dir_name, UInt64 window_seconds, UInt64 window_size, NodeCTimeAndVersionCache & cached_block_stats);
 
-    /// Remove old mutations that are done from ZooKeeper. This is done by the leader replica.
-    void clearOldMutations();
+    /// Remove old mutations that are done from ZooKeeper. This is done by the leader replica. Returns the number of removed mutations
+    size_t clearOldMutations();
 
     NodeCTimeAndVersionCache cached_block_stats_for_sync_inserts;
     NodeCTimeAndVersionCache cached_block_stats_for_async_inserts;
diff --git a/src/Storages/MergeTree/SimpleMergeSelector.cpp b/src/Storages/MergeTree/SimpleMergeSelector.cpp
index af3373fd175..7e7539f71d5 100644
--- a/src/Storages/MergeTree/SimpleMergeSelector.cpp
+++ b/src/Storages/MergeTree/SimpleMergeSelector.cpp
@@ -28,7 +28,7 @@ struct Estimator
         {
             double difference = std::abs(log2(static_cast<double>(sum_size) / size_prev_at_left));
             if (difference < settings.heuristic_to_align_parts_max_absolute_difference_in_powers_of_two)
-                current_score *= std::lerp(settings.heuristic_to_align_parts_max_score_adjustment, 1,
+                current_score *= interpolateLinear(settings.heuristic_to_align_parts_max_score_adjustment, 1,
                     difference / settings.heuristic_to_align_parts_max_absolute_difference_in_powers_of_two);
         }
 
@@ -115,8 +115,8 @@ bool allow(
 //    std::cerr << "size_normalized: " << size_normalized << "\n";
 
     /// Calculate boundaries for age
-    double min_age_to_lower_base = std::lerp(settings.min_age_to_lower_base_at_min_size, settings.min_age_to_lower_base_at_max_size, size_normalized);
-    double max_age_to_lower_base = std::lerp(settings.max_age_to_lower_base_at_min_size, settings.max_age_to_lower_base_at_max_size, size_normalized);
+    double min_age_to_lower_base = interpolateLinear(settings.min_age_to_lower_base_at_min_size, settings.min_age_to_lower_base_at_max_size, size_normalized);
+    double max_age_to_lower_base = interpolateLinear(settings.max_age_to_lower_base_at_min_size, settings.max_age_to_lower_base_at_max_size, size_normalized);
 
 //    std::cerr << "min_age_to_lower_base: " << min_age_to_lower_base << "\n";
 //    std::cerr << "max_age_to_lower_base: " << max_age_to_lower_base << "\n";
@@ -137,7 +137,7 @@ bool allow(
 
 //    std::cerr << "combined_ratio: " << combined_ratio << "\n";
 
-    double lowered_base = std::lerp(settings.base, 2.0, combined_ratio);
+    double lowered_base = interpolateLinear(settings.base, 2.0, combined_ratio);
 
 //    std::cerr << "------- lowered_base: " << lowered_base << "\n";
 
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index d9c8f09ccf1..2b948e1fd60 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -3147,6 +3147,8 @@ bool StorageReplicatedMergeTree::processQueueEntry(ReplicatedMergeTreeQueue::Sel
 
 bool StorageReplicatedMergeTree::scheduleDataProcessingJob(BackgroundJobsAssignee & assignee)
 {
+    cleanup_thread.wakeupEarlierIfNeeded();
+
     /// If replication queue is stopped exit immediately as we successfully executed the task
     if (queue.actions_blocker.isCancelled())
         return false;
@@ -6589,7 +6591,7 @@ bool StorageReplicatedMergeTree::hasLightweightDeletedMask() const
     return has_lightweight_delete_parts.load(std::memory_order_relaxed);
 }
 
-void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
+size_t StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
 {
     auto table_lock = lockForShare(
             RWLockImpl::NO_QUERY, getSettings()->lock_acquire_timeout_for_background_operations);
@@ -6598,8 +6600,9 @@ void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
     /// Now these parts are in Deleting state. If we fail to remove some of them we must roll them back to Outdated state.
     /// Otherwise they will not be deleted.
     DataPartsVector parts = grabOldParts();
+    size_t total_parts_to_remove = parts.size();
     if (parts.empty())
-        return;
+        return total_parts_to_remove;
 
     DataPartsVector parts_to_delete_only_from_filesystem;    // Only duplicates
     DataPartsVector parts_to_delete_completely;              // All parts except duplicates
@@ -6707,6 +6710,8 @@ void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
         /// Otherwise nobody will try to remove them again (see grabOldParts).
         delete_parts_from_fs_and_rollback_in_case_of_error(parts_to_remove_from_filesystem, "old");
     }
+
+    return total_parts_to_remove;
 }
 
 
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index 29b6a4d6817..01b86dd1425 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -342,8 +342,8 @@ public:
 private:
     std::atomic_bool are_restoring_replica {false};
 
-    /// Delete old parts from disk and from ZooKeeper.
-    void clearOldPartsAndRemoveFromZK();
+    /// Delete old parts from disk and from ZooKeeper. Returns the number of removed parts
+    size_t clearOldPartsAndRemoveFromZK();
 
     template<bool async_insert>
     friend class ReplicatedMergeTreeSinkImpl;
diff --git a/tests/config/config.d/merge_tree.xml b/tests/config/config.d/merge_tree.xml
index 43bdb6aa07b..5521e5ba515 100644
--- a/tests/config/config.d/merge_tree.xml
+++ b/tests/config/config.d/merge_tree.xml
@@ -1,5 +1,7 @@
 <clickhouse>
     <merge_tree>
         <number_of_free_entries_in_pool_to_execute_mutation>8</number_of_free_entries_in_pool_to_execute_mutation>
+        <max_cleanup_delay_period>60</max_cleanup_delay_period>
+        <cleanup_thread_preferred_points_per_iteration>10</cleanup_thread_preferred_points_per_iteration>
     </merge_tree>
 </clickhouse>
diff --git a/tests/integration/test_broken_detached_part_clean_up/test.py b/tests/integration/test_broken_detached_part_clean_up/test.py
index 5b18fa34494..9a70ebe0d48 100644
--- a/tests/integration/test_broken_detached_part_clean_up/test.py
+++ b/tests/integration/test_broken_detached_part_clean_up/test.py
@@ -141,7 +141,8 @@ def test_remove_broken_detached_part_replicated_merge_tree(started_cluster):
             merge_tree_enable_clear_old_broken_detached=1,
             merge_tree_clear_old_broken_detached_parts_ttl_timeout_seconds=5,
             cleanup_delay_period=1,
-            cleanup_delay_period_random_add=0;
+            cleanup_delay_period_random_add=0,
+            cleanup_thread_preferred_points_per_iteration=0;
         """
     )
 
diff --git a/tests/integration/test_broken_part_during_merge/test.py b/tests/integration/test_broken_part_during_merge/test.py
index f4110844466..26962236869 100644
--- a/tests/integration/test_broken_part_during_merge/test.py
+++ b/tests/integration/test_broken_part_during_merge/test.py
@@ -25,7 +25,7 @@ def test_merge_and_part_corruption(started_cluster):
         """
         CREATE TABLE replicated_mt(date Date, id UInt32, value Int32)
         ENGINE = ReplicatedMergeTree('/clickhouse/tables/replicated_mt', '{replica}') ORDER BY id 
-        SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1;
+        SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
             replica=node1.name
         )
diff --git a/tests/integration/test_consistant_parts_after_move_partition/test.py b/tests/integration/test_consistant_parts_after_move_partition/test.py
index 63a51472773..91fa884c093 100644
--- a/tests/integration/test_consistant_parts_after_move_partition/test.py
+++ b/tests/integration/test_consistant_parts_after_move_partition/test.py
@@ -14,11 +14,13 @@ def initialize_database(nodes, shard):
             CREATE TABLE `{database}`.src (p UInt64, d UInt64)
             ENGINE = ReplicatedMergeTree('/clickhouse/{database}/tables/test_consistent_shard1{shard}/replicated', '{replica}')
             ORDER BY d PARTITION BY p
-            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5,
+            cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             CREATE TABLE `{database}`.dest (p UInt64, d UInt64)
             ENGINE = ReplicatedMergeTree('/clickhouse/{database}/tables/test_consistent_shard2{shard}/replicated', '{replica}')
             ORDER BY d PARTITION BY p
-            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5,
+            cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
         """.format(
                 shard=shard, replica=node.name, database=CLICKHOUSE_DATABASE
             )
diff --git a/tests/integration/test_drop_replica/test.py b/tests/integration/test_drop_replica/test.py
index e87edb0a578..0941e664982 100644
--- a/tests/integration/test_drop_replica/test.py
+++ b/tests/integration/test_drop_replica/test.py
@@ -11,7 +11,8 @@ def fill_nodes(nodes, shard):
                 CREATE DATABASE test;
     
                 CREATE TABLE test.test_table(date Date, id UInt32)
-                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) 
+                SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
@@ -22,7 +23,8 @@ def fill_nodes(nodes, shard):
                 CREATE DATABASE test1;
     
                 CREATE TABLE test1.test_table(date Date, id UInt32)
-                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test1/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test1/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) 
+                SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
@@ -33,7 +35,8 @@ def fill_nodes(nodes, shard):
                 CREATE DATABASE test2;
     
                 CREATE TABLE test2.test_table(date Date, id UInt32)
-                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test2/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test2/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) 
+                SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
@@ -44,7 +47,8 @@ def fill_nodes(nodes, shard):
                 CREATE DATABASE test3;
     
                 CREATE TABLE test3.test_table(date Date, id UInt32)
-                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test3/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test3/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) 
+                SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
@@ -55,7 +59,8 @@ def fill_nodes(nodes, shard):
                 CREATE DATABASE test4;
     
                 CREATE TABLE test4.test_table(date Date, id UInt32)
-                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test4/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test4/{shard}/replicated/test_table', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) 
+                SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
diff --git a/tests/integration/test_jbod_balancer/test.py b/tests/integration/test_jbod_balancer/test.py
index df34a075d5a..4797eec5381 100644
--- a/tests/integration/test_jbod_balancer/test.py
+++ b/tests/integration/test_jbod_balancer/test.py
@@ -134,6 +134,7 @@ def test_replicated_balanced_merge_fetch(start_cluster):
                     old_parts_lifetime = 1,
                     cleanup_delay_period = 1,
                     cleanup_delay_period_random_add = 2,
+                    cleanup_thread_preferred_points_per_iteration=0,
                     min_bytes_to_rebalance_partition_over_jbod = 1024,
                     max_bytes_to_merge_at_max_space_in_pool = 4096
             """.format(
diff --git a/tests/integration/test_jbod_ha/test.py b/tests/integration/test_jbod_ha/test.py
index 5cbb5989ff3..033d751912a 100644
--- a/tests/integration/test_jbod_ha/test.py
+++ b/tests/integration/test_jbod_ha/test.py
@@ -58,6 +58,7 @@ def test_jbod_ha(start_cluster):
                     old_parts_lifetime = 1,
                     cleanup_delay_period = 1,
                     cleanup_delay_period_random_add = 2,
+                    cleanup_thread_preferred_points_per_iteration=0,
                     max_bytes_to_merge_at_max_space_in_pool = 4096
             """.format(
                     i
diff --git a/tests/integration/test_lost_part/test.py b/tests/integration/test_lost_part/test.py
index dd4c2105d55..44cd19fd1fb 100644
--- a/tests/integration/test_lost_part/test.py
+++ b/tests/integration/test_lost_part/test.py
@@ -42,7 +42,7 @@ def test_lost_part_same_replica(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt0 (id UInt64, date Date) ENGINE ReplicatedMergeTree('/clickhouse/tables/t', '{node.name}') ORDER BY tuple() PARTITION BY date "
-            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1"
+            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
         )
 
     node1.query("SYSTEM STOP MERGES mt0")
@@ -109,7 +109,7 @@ def test_lost_part_other_replica(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt1 (id UInt64) ENGINE ReplicatedMergeTree('/clickhouse/tables/t1', '{node.name}') ORDER BY tuple() "
-            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1"
+            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
         )
 
     node1.query("SYSTEM STOP MERGES mt1")
@@ -178,7 +178,7 @@ def test_lost_part_mutation(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt2 (id UInt64) ENGINE ReplicatedMergeTree('/clickhouse/tables/t2', '{node.name}') ORDER BY tuple() "
-            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1"
+            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
         )
 
     node1.query("SYSTEM STOP MERGES mt2")
@@ -241,7 +241,7 @@ def test_lost_last_part(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt3 (id UInt64, p String) ENGINE ReplicatedMergeTree('/clickhouse/tables/t3', '{node.name}') "
-            "ORDER BY tuple() PARTITION BY p SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1"
+            "ORDER BY tuple() PARTITION BY p SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
         )
 
     node1.query("SYSTEM STOP MERGES mt3")
diff --git a/tests/integration/test_multiple_disks/test.py b/tests/integration/test_multiple_disks/test.py
index 0e51df017b2..54e7f6dd8ee 100644
--- a/tests/integration/test_multiple_disks/test.py
+++ b/tests/integration/test_multiple_disks/test.py
@@ -1528,7 +1528,8 @@ def test_simple_replication_and_moves(start_cluster):
                     s1 String
                 ) ENGINE = ReplicatedMergeTree('/clickhouse/replicated_table_for_moves', '{}')
                 ORDER BY tuple()
-                SETTINGS storage_policy='moving_jbod_with_external', old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=2
+                SETTINGS storage_policy='moving_jbod_with_external', old_parts_lifetime=1,
+                cleanup_delay_period=1, cleanup_delay_period_random_add=2, cleanup_thread_preferred_points_per_iteration=0
             """.format(
                     i + 1
                 )
@@ -1609,7 +1610,8 @@ def test_download_appropriate_disk(start_cluster):
                     s1 String
                 ) ENGINE = ReplicatedMergeTree('/clickhouse/replicated_table_for_download', '{}')
                 ORDER BY tuple()
-                SETTINGS storage_policy='moving_jbod_with_external', old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=2
+                SETTINGS storage_policy='moving_jbod_with_external', old_parts_lifetime=1,
+                cleanup_delay_period=1, cleanup_delay_period_random_add=2, cleanup_thread_preferred_points_per_iteration=0
             """.format(
                     i + 1
                 )
diff --git a/tests/integration/test_old_parts_finally_removed/test.py b/tests/integration/test_old_parts_finally_removed/test.py
index 5347d433419..cbd701588d5 100644
--- a/tests/integration/test_old_parts_finally_removed/test.py
+++ b/tests/integration/test_old_parts_finally_removed/test.py
@@ -27,7 +27,8 @@ def started_cluster():
 
 def test_part_finally_removed(started_cluster):
     node1.query(
-        "CREATE TABLE drop_outdated_part (Key UInt64) ENGINE = ReplicatedMergeTree('/table/d', '1') ORDER BY tuple() SETTINGS old_parts_lifetime=10, cleanup_delay_period=10, cleanup_delay_period_random_add=1"
+        "CREATE TABLE drop_outdated_part (Key UInt64) ENGINE = ReplicatedMergeTree('/table/d', '1') ORDER BY tuple() "
+        "SETTINGS old_parts_lifetime=10, cleanup_delay_period=10, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
     )
     node1.query("INSERT INTO drop_outdated_part VALUES (1)")
 
@@ -44,7 +45,7 @@ def test_part_finally_removed(started_cluster):
     )
 
     node1.query(
-        "ALTER TABLE drop_outdated_part MODIFY SETTING old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1"
+        "ALTER TABLE drop_outdated_part MODIFY SETTING old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
     )
 
     for i in range(60):
diff --git a/tests/integration/test_parts_delete_zookeeper/test.py b/tests/integration/test_parts_delete_zookeeper/test.py
index a78aefa4595..9fd07e7b65d 100644
--- a/tests/integration/test_parts_delete_zookeeper/test.py
+++ b/tests/integration/test_parts_delete_zookeeper/test.py
@@ -21,7 +21,7 @@ def start_cluster():
             CREATE DATABASE test;
             CREATE TABLE test_table(date Date, id UInt32)
             ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/replicated', 'node1')
-            ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS old_parts_lifetime=4, cleanup_delay_period=1;
+            ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS old_parts_lifetime=4, cleanup_delay_period=1, cleanup_thread_preferred_points_per_iteration=0;
             """
         )
 
diff --git a/tests/integration/test_recovery_replica/test.py b/tests/integration/test_recovery_replica/test.py
index 0a63da4db22..582e018f5d2 100644
--- a/tests/integration/test_recovery_replica/test.py
+++ b/tests/integration/test_recovery_replica/test.py
@@ -4,7 +4,7 @@ import pytest
 from helpers.cluster import ClickHouseCluster
 from helpers.test_tools import assert_eq_with_retry
 
-SETTINGS = "SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0"
+SETTINGS = "SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0"
 
 
 def fill_nodes(nodes):
diff --git a/tests/integration/test_storage_nats/test.py b/tests/integration/test_storage_nats/test.py
index 1d7e046864b..4d7e4cf813d 100644
--- a/tests/integration/test_storage_nats/test.py
+++ b/tests/integration/test_storage_nats/test.py
@@ -931,7 +931,8 @@ def test_nats_overloaded_insert(nats_cluster):
         CREATE TABLE test.view_overload (key UInt64, value UInt64)
             ENGINE = MergeTree
             ORDER BY key
-            SETTINGS old_parts_lifetime=5, cleanup_delay_period=2, cleanup_delay_period_random_add=3;
+            SETTINGS old_parts_lifetime=5, cleanup_delay_period=2, cleanup_delay_period_random_add=3,
+            cleanup_thread_preferred_points_per_iteration=0;
         CREATE MATERIALIZED VIEW test.consumer_overload TO test.view_overload AS
             SELECT * FROM test.nats_consume;
     """
diff --git a/tests/integration/test_storage_rabbitmq/test.py b/tests/integration/test_storage_rabbitmq/test.py
index 4e1e28373e3..b4dcf86e0ba 100644
--- a/tests/integration/test_storage_rabbitmq/test.py
+++ b/tests/integration/test_storage_rabbitmq/test.py
@@ -642,7 +642,8 @@ def test_rabbitmq_sharding_between_queues_publish(rabbitmq_cluster):
         CREATE TABLE test.view (key UInt64, value UInt64, channel_id String)
             ENGINE = MergeTree
             ORDER BY key
-            SETTINGS old_parts_lifetime=5, cleanup_delay_period=2, cleanup_delay_period_random_add=3;
+            SETTINGS old_parts_lifetime=5, cleanup_delay_period=2, cleanup_delay_period_random_add=3,
+            cleanup_thread_preferred_points_per_iteration=0;
         CREATE MATERIALIZED VIEW test.consumer TO test.view AS
             SELECT *, _channel_id AS channel_id FROM test.rabbitmq;
     """
@@ -1116,7 +1117,8 @@ def test_rabbitmq_direct_exchange(rabbitmq_cluster):
         CREATE TABLE test.destination(key UInt64, value UInt64)
         ENGINE = MergeTree()
         ORDER BY key
-        SETTINGS old_parts_lifetime=5, cleanup_delay_period=2, cleanup_delay_period_random_add=3;
+        SETTINGS old_parts_lifetime=5, cleanup_delay_period=2, cleanup_delay_period_random_add=3,
+        cleanup_thread_preferred_points_per_iteration=0;
     """
     )
 
diff --git a/tests/integration/test_system_metrics/test.py b/tests/integration/test_system_metrics/test.py
index 9ebe198a109..338622b824e 100644
--- a/tests/integration/test_system_metrics/test.py
+++ b/tests/integration/test_system_metrics/test.py
@@ -13,7 +13,9 @@ def fill_nodes(nodes, shard):
                 CREATE DATABASE test;
 
                 CREATE TABLE test.test_table(date Date, id UInt32)
-                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test{shard}/replicated', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+                ENGINE = ReplicatedMergeTree('/clickhouse/tables/test{shard}/replicated', '{replica}') ORDER BY id PARTITION BY toYYYYMM(date) 
+                SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5,
+                cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
diff --git a/tests/integration/test_ttl_replicated/test.py b/tests/integration/test_ttl_replicated/test.py
index a3e7d6e4b8b..4ea4472b812 100644
--- a/tests/integration/test_ttl_replicated/test.py
+++ b/tests/integration/test_ttl_replicated/test.py
@@ -422,7 +422,8 @@ def test_ttl_empty_parts(started_cluster):
             ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_empty_parts', '{replica}')
             ORDER BY id
             SETTINGS max_bytes_to_merge_at_min_space_in_pool = 1, max_bytes_to_merge_at_max_space_in_pool = 1,
-                cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, old_parts_lifetime = 1
+                cleanup_delay_period = 1, cleanup_delay_period_random_add = 0,
+                cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime = 1
 
         """.format(
                 replica=node.name
diff --git a/tests/queries/0_stateless/00626_replace_partition_from_table_zookeeper.sh b/tests/queries/0_stateless/00626_replace_partition_from_table_zookeeper.sh
index a0a3416e406..399511db701 100755
--- a/tests/queries/0_stateless/00626_replace_partition_from_table_zookeeper.sh
+++ b/tests/queries/0_stateless/00626_replace_partition_from_table_zookeeper.sh
@@ -36,8 +36,12 @@ $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS dst_r1;"
 $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS dst_r2;"
 
 $CLICKHOUSE_CLIENT --query="CREATE TABLE src (p UInt64, k String, d UInt64) ENGINE = MergeTree PARTITION BY p ORDER BY k;"
-$CLICKHOUSE_CLIENT --query="CREATE TABLE dst_r1 (p UInt64, k String, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst_1', '1') PARTITION BY p ORDER BY k SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0;"
-$CLICKHOUSE_CLIENT --query="CREATE TABLE dst_r2 (p UInt64, k String, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst_1', '2') PARTITION BY p ORDER BY k SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0;"
+$CLICKHOUSE_CLIENT --query="CREATE TABLE dst_r1 (p UInt64, k String, d UInt64)
+ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst_1', '1') PARTITION BY p ORDER BY k
+SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
+$CLICKHOUSE_CLIENT --query="CREATE TABLE dst_r2 (p UInt64, k String, d UInt64)
+ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst_1', '2') PARTITION BY p ORDER BY k
+SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
 
 $CLICKHOUSE_CLIENT --query="INSERT INTO src VALUES (0, '0', 1);"
 $CLICKHOUSE_CLIENT --query="INSERT INTO src VALUES (1, '0', 1);"
diff --git a/tests/queries/0_stateless/00652_replicated_mutations_zookeeper.sh b/tests/queries/0_stateless/00652_replicated_mutations_zookeeper.sh
index 1f5bcbdc0d0..d8b1bdec328 100755
--- a/tests/queries/0_stateless/00652_replicated_mutations_zookeeper.sh
+++ b/tests/queries/0_stateless/00652_replicated_mutations_zookeeper.sh
@@ -56,11 +56,13 @@ ${CLICKHOUSE_CLIENT} --query="DROP TABLE IF EXISTS mutations_cleaner_r2 SYNC"
 ${CLICKHOUSE_CLIENT} --query="CREATE TABLE mutations_cleaner_r1(x UInt32) ENGINE ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/mutations_cleaner', 'r1') ORDER BY x SETTINGS \
     finished_mutations_to_keep = 2,
     cleanup_delay_period = 1,
-    cleanup_delay_period_random_add = 0"
+    cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0"
 ${CLICKHOUSE_CLIENT} --query="CREATE TABLE mutations_cleaner_r2(x UInt32) ENGINE ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/mutations_cleaner', 'r2') ORDER BY x SETTINGS \
     finished_mutations_to_keep = 2,
     cleanup_delay_period = 1,
-    cleanup_delay_period_random_add = 0"
+    cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0"
 
 # Insert some data
 ${CLICKHOUSE_CLIENT} --insert_keeper_fault_injection_probability=0 --query="INSERT INTO mutations_cleaner_r1(x) VALUES (1), (2), (3), (4), (5)"
diff --git a/tests/queries/0_stateless/00814_replicated_minimalistic_part_header_zookeeper.sh b/tests/queries/0_stateless/00814_replicated_minimalistic_part_header_zookeeper.sh
index 5fc3fa460e6..bab2304cec2 100755
--- a/tests/queries/0_stateless/00814_replicated_minimalistic_part_header_zookeeper.sh
+++ b/tests/queries/0_stateless/00814_replicated_minimalistic_part_header_zookeeper.sh
@@ -20,13 +20,15 @@ CREATE TABLE part_header_r1(x UInt32, y UInt32)
     SETTINGS use_minimalistic_part_header_in_zookeeper = 0,
              old_parts_lifetime = 1,
              cleanup_delay_period = 0,
-             cleanup_delay_period_random_add = 0;
+             cleanup_delay_period_random_add = 0,
+             cleanup_thread_preferred_points_per_iteration=0;
 CREATE TABLE part_header_r2(x UInt32, y UInt32)
     ENGINE ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/test_00814/part_header/{shard}', '2{replica}') ORDER BY x
     SETTINGS use_minimalistic_part_header_in_zookeeper = 1,
              old_parts_lifetime = 1,
              cleanup_delay_period = 0,
-             cleanup_delay_period_random_add = 0;
+             cleanup_delay_period_random_add = 0,
+             cleanup_thread_preferred_points_per_iteration=0;
 
 SELECT '*** Test fetches ***';
 INSERT INTO part_header_r1 VALUES (1, 1);
diff --git a/tests/queries/0_stateless/00953_zookeeper_suetin_deduplication_bug.sh b/tests/queries/0_stateless/00953_zookeeper_suetin_deduplication_bug.sh
index c713c7c4926..ad0146b9d99 100755
--- a/tests/queries/0_stateless/00953_zookeeper_suetin_deduplication_bug.sh
+++ b/tests/queries/0_stateless/00953_zookeeper_suetin_deduplication_bug.sh
@@ -22,7 +22,7 @@ CREATE TABLE elog (
 ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/elog/{shard}', '{replica}')
 PARTITION BY date
 ORDER BY (engine_id)
-SETTINGS replicated_deduplication_window = 2, cleanup_delay_period=4, cleanup_delay_period_random_add=0;"
+SETTINGS replicated_deduplication_window = 2, cleanup_delay_period=4, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
 
 $CLICKHOUSE_CLIENT --query="INSERT INTO elog VALUES (toDate('2018-10-01'), 1, 'hello')"
 $CLICKHOUSE_CLIENT --query="INSERT INTO elog VALUES (toDate('2018-10-01'), 2, 'hello')"
diff --git a/tests/queries/0_stateless/00988_parallel_parts_removal.sql b/tests/queries/0_stateless/00988_parallel_parts_removal.sql
index bff9bbe6d8d..5bd31ba1baa 100644
--- a/tests/queries/0_stateless/00988_parallel_parts_removal.sql
+++ b/tests/queries/0_stateless/00988_parallel_parts_removal.sql
@@ -1,6 +1,8 @@
 DROP TABLE IF EXISTS mt;
 
-CREATE TABLE mt (x UInt64) ENGINE = MergeTree ORDER BY x SETTINGS max_part_removal_threads = 16, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, old_parts_lifetime = 1, parts_to_delay_insert = 100000, parts_to_throw_insert = 100000;
+CREATE TABLE mt (x UInt64) ENGINE = MergeTree ORDER BY x
+    SETTINGS max_part_removal_threads = 16, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime = 1, parts_to_delay_insert = 100000, parts_to_throw_insert = 100000;
 
 SYSTEM STOP MERGES mt;
 
diff --git a/tests/queries/0_stateless/00992_system_parts_race_condition_zookeeper_long.sh b/tests/queries/0_stateless/00992_system_parts_race_condition_zookeeper_long.sh
index 5b1c50262bf..e0b7ab29924 100755
--- a/tests/queries/0_stateless/00992_system_parts_race_condition_zookeeper_long.sh
+++ b/tests/queries/0_stateless/00992_system_parts_race_condition_zookeeper_long.sh
@@ -13,8 +13,14 @@ $CLICKHOUSE_CLIENT -n -q "
     DROP TABLE IF EXISTS alter_table0;
     DROP TABLE IF EXISTS alter_table1;
 
-    CREATE TABLE alter_table0 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16)) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r1') ORDER BY a PARTITION BY b % 10 SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, replicated_max_mutations_in_one_entry = $(($RANDOM / 50 + 100));
-    CREATE TABLE alter_table1 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16)) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r2') ORDER BY a PARTITION BY b % 10 SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, replicated_max_mutations_in_one_entry = $(($RANDOM / 50 + 200));
+    CREATE TABLE alter_table0 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
+    ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r1') ORDER BY a PARTITION BY b % 10
+    SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0, replicated_max_mutations_in_one_entry = $(($RANDOM / 50 + 100));
+    CREATE TABLE alter_table1 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
+    ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r2') ORDER BY a PARTITION BY b % 10
+    SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0, replicated_max_mutations_in_one_entry = $(($RANDOM / 50 + 200));
 "
 
 function thread1()
diff --git a/tests/queries/0_stateless/00993_system_parts_race_condition_drop_zookeeper.sh b/tests/queries/0_stateless/00993_system_parts_race_condition_drop_zookeeper.sh
index f4f38ad9c83..811681794a5 100755
--- a/tests/queries/0_stateless/00993_system_parts_race_condition_drop_zookeeper.sh
+++ b/tests/queries/0_stateless/00993_system_parts_race_condition_drop_zookeeper.sh
@@ -58,7 +58,8 @@ function thread6()
         $CLICKHOUSE_CLIENT -n -q "DROP TABLE IF EXISTS alter_table_$REPLICA;
             CREATE TABLE alter_table_$REPLICA (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
             ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r_$REPLICA') ORDER BY a PARTITION BY b % 10
-            SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0, replicated_max_mutations_in_one_entry = $(($RANDOM / 50));";
+            SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0,
+            cleanup_thread_preferred_points_per_iteration=0, replicated_max_mutations_in_one_entry = $(($RANDOM / 50));";
         sleep 0.$RANDOM;
     done
 }
diff --git a/tests/queries/0_stateless/01034_move_partition_from_table_zookeeper.sh b/tests/queries/0_stateless/01034_move_partition_from_table_zookeeper.sh
index 5e9e69d999d..e0a84323dbd 100755
--- a/tests/queries/0_stateless/01034_move_partition_from_table_zookeeper.sh
+++ b/tests/queries/0_stateless/01034_move_partition_from_table_zookeeper.sh
@@ -28,7 +28,8 @@ $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS src;"
 $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS dst;"
 
 $CLICKHOUSE_CLIENT --query="CREATE TABLE src (p UInt64, k String, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/src1', '1') PARTITION BY p ORDER BY k;"
-$CLICKHOUSE_CLIENT --query="CREATE TABLE dst (p UInt64, k String, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst1', '1') PARTITION BY p ORDER BY k SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0;"
+$CLICKHOUSE_CLIENT --query="CREATE TABLE dst (p UInt64, k String, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst1', '1') PARTITION BY p ORDER BY k
+SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
 
 $CLICKHOUSE_CLIENT --query="INSERT INTO src VALUES (0, '0', 1);"
 $CLICKHOUSE_CLIENT --query="INSERT INTO src VALUES (1, '0', 1);"
@@ -58,7 +59,8 @@ $CLICKHOUSE_CLIENT --query="DROP TABLE dst;"
 $CLICKHOUSE_CLIENT --query="SELECT 'MOVE incompatible schema missing column';"
 
 $CLICKHOUSE_CLIENT --query="CREATE TABLE src (p UInt64, k String, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/src2', '1') PARTITION BY p ORDER BY (d, p);"
-$CLICKHOUSE_CLIENT --query="CREATE TABLE dst (p UInt64, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst2', '1') PARTITION BY p ORDER BY (d, p) SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0;"
+$CLICKHOUSE_CLIENT --query="CREATE TABLE dst (p UInt64, d UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst2', '1') PARTITION BY p ORDER BY (d, p)
+SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
 
 $CLICKHOUSE_CLIENT --query="INSERT INTO src VALUES (0, '0', 1);"
 $CLICKHOUSE_CLIENT --query="INSERT INTO src VALUES (1, '0', 1);"
diff --git a/tests/queries/0_stateless/01035_concurrent_move_partition_from_table_zookeeper.sh b/tests/queries/0_stateless/01035_concurrent_move_partition_from_table_zookeeper.sh
index 8ef03be02b6..06a460f3600 100755
--- a/tests/queries/0_stateless/01035_concurrent_move_partition_from_table_zookeeper.sh
+++ b/tests/queries/0_stateless/01035_concurrent_move_partition_from_table_zookeeper.sh
@@ -11,7 +11,8 @@ $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS src;"
 $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS dst;"
 
 $CLICKHOUSE_CLIENT --query="CREATE TABLE src (p UInt64, k String) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/src', '1') PARTITION BY p ORDER BY k;"
-$CLICKHOUSE_CLIENT --query="CREATE TABLE dst (p UInt64, k String) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst', '1') PARTITION BY p ORDER BY k SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0;"
+$CLICKHOUSE_CLIENT --query="CREATE TABLE dst (p UInt64, k String) ENGINE = ReplicatedMergeTree('/clickhouse/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/dst', '1') PARTITION BY p ORDER BY k
+SETTINGS old_parts_lifetime=1, cleanup_delay_period=1, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
 
 function thread1()
 {
diff --git a/tests/queries/0_stateless/01076_parallel_alter_replicated_zookeeper.sh b/tests/queries/0_stateless/01076_parallel_alter_replicated_zookeeper.sh
index 7f53bf2a627..5f69427c0cd 100755
--- a/tests/queries/0_stateless/01076_parallel_alter_replicated_zookeeper.sh
+++ b/tests/queries/0_stateless/01076_parallel_alter_replicated_zookeeper.sh
@@ -31,7 +31,8 @@ for i in $(seq $REPLICAS); do
                  max_replicated_merges_in_queue = 1000,
                  temporary_directories_lifetime = 10,
                  cleanup_delay_period = 3,
-                 cleanup_delay_period_random_add = 0"
+                 cleanup_delay_period_random_add = 0,
+                 cleanup_thread_preferred_points_per_iteration=0"
 done
 
 $CLICKHOUSE_CLIENT --query "INSERT INTO concurrent_mutate_mt_1 SELECT number, number + 10, toString(number) from numbers(10)"
diff --git a/tests/queries/0_stateless/01079_parallel_alter_detach_table_zookeeper.sh b/tests/queries/0_stateless/01079_parallel_alter_detach_table_zookeeper.sh
index aec27792603..e508b77a0c2 100755
--- a/tests/queries/0_stateless/01079_parallel_alter_detach_table_zookeeper.sh
+++ b/tests/queries/0_stateless/01079_parallel_alter_detach_table_zookeeper.sh
@@ -12,7 +12,10 @@ for i in $(seq $REPLICAS); do
 done
 
 for i in $(seq $REPLICAS); do
-    $CLICKHOUSE_CLIENT --query "CREATE TABLE concurrent_alter_detach_$i (key UInt64, value1 UInt8, value2 UInt8) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/concurrent_alter_detach', '$i') ORDER BY key SETTINGS max_replicated_mutations_in_queue=1000, number_of_free_entries_in_pool_to_execute_mutation=0,max_replicated_merges_in_queue=1000,temporary_directories_lifetime=10,cleanup_delay_period=3,cleanup_delay_period_random_add=0"
+    $CLICKHOUSE_CLIENT --query "CREATE TABLE concurrent_alter_detach_$i (key UInt64, value1 UInt8, value2 UInt8)
+    ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/concurrent_alter_detach', '$i') ORDER BY key
+    SETTINGS max_replicated_mutations_in_queue=1000, number_of_free_entries_in_pool_to_execute_mutation=0,max_replicated_merges_in_queue=1000,
+    temporary_directories_lifetime=10,cleanup_delay_period=3,cleanup_delay_period_random_add=0,cleanup_thread_preferred_points_per_iteration=0"
 done
 
 $CLICKHOUSE_CLIENT --query "INSERT INTO concurrent_alter_detach_1 SELECT number, number + 10, number from numbers(10)"
diff --git a/tests/queries/0_stateless/01103_optimize_drop_race_zookeeper.sh b/tests/queries/0_stateless/01103_optimize_drop_race_zookeeper.sh
index 95f8dfc0377..3461283b5ea 100755
--- a/tests/queries/0_stateless/01103_optimize_drop_race_zookeeper.sh
+++ b/tests/queries/0_stateless/01103_optimize_drop_race_zookeeper.sh
@@ -27,7 +27,9 @@ function thread3()
 {
     while true; do
         $CLICKHOUSE_CLIENT -n -q "DROP TABLE IF EXISTS concurrent_optimize_table;
-            CREATE TABLE concurrent_optimize_table (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16)) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/concurrent_optimize_table', '1') ORDER BY a PARTITION BY b % 10 SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0;";
+            CREATE TABLE concurrent_optimize_table (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
+            ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/concurrent_optimize_table', '1') ORDER BY a PARTITION BY b % 10
+            SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0, cleanup_thread_preferred_points_per_iteration=0;";
         sleep 0.$RANDOM;
         sleep 0.$RANDOM;
         sleep 0.$RANDOM;
diff --git a/tests/queries/0_stateless/01158_zookeeper_log_long.sql b/tests/queries/0_stateless/01158_zookeeper_log_long.sql
index 45771494af6..9b5ae7ad7c6 100644
--- a/tests/queries/0_stateless/01158_zookeeper_log_long.sql
+++ b/tests/queries/0_stateless/01158_zookeeper_log_long.sql
@@ -6,7 +6,7 @@ SET insert_keeper_fault_injection_probability=0; -- disable fault injection; par
 drop table if exists rmt sync;
 -- cleanup code will perform extra Exists
 -- (so the .reference will not match)
-create table rmt (n int) engine=ReplicatedMergeTree('/test/01158/{database}/rmt', '1') order by n settings cleanup_delay_period=86400, replicated_can_become_leader=0;
+create table rmt (n int) engine=ReplicatedMergeTree('/test/01158/{database}/rmt', '1') order by n settings cleanup_delay_period=86400, max_cleanup_delay_period=86400, replicated_can_become_leader=0;
 system sync replica rmt;
 insert into rmt values (1);
 insert into rmt values (1);
diff --git a/tests/queries/0_stateless/01396_inactive_replica_cleanup_nodes_zookeeper.sh b/tests/queries/0_stateless/01396_inactive_replica_cleanup_nodes_zookeeper.sh
index 411705e0469..2d761df998e 100755
--- a/tests/queries/0_stateless/01396_inactive_replica_cleanup_nodes_zookeeper.sh
+++ b/tests/queries/0_stateless/01396_inactive_replica_cleanup_nodes_zookeeper.sh
@@ -13,8 +13,10 @@ SCALE=5000
 $CLICKHOUSE_CLIENT -n --query "
     DROP TABLE IF EXISTS r1;
     DROP TABLE IF EXISTS r2;
-    CREATE TABLE r1 (x UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/{shard}', '1{replica}') ORDER BY x SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 1, parts_to_throw_insert = 100000, max_replicated_logs_to_keep = 10;
-    CREATE TABLE r2 (x UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/{shard}', '2{replica}') ORDER BY x SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 1, parts_to_throw_insert = 100000, max_replicated_logs_to_keep = 10;
+    CREATE TABLE r1 (x UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/{shard}', '1{replica}') ORDER BY x
+    SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 1, cleanup_thread_preferred_points_per_iteration=0, parts_to_throw_insert = 100000, max_replicated_logs_to_keep = 10;
+    CREATE TABLE r2 (x UInt64) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/{shard}', '2{replica}') ORDER BY x
+    SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 1, cleanup_thread_preferred_points_per_iteration=0, parts_to_throw_insert = 100000, max_replicated_logs_to_keep = 10;
     DETACH TABLE r2;
 "
 
diff --git a/tests/queries/0_stateless/01508_race_condition_rename_clear_zookeeper_long.sh b/tests/queries/0_stateless/01508_race_condition_rename_clear_zookeeper_long.sh
index 80318ba67fb..c3c87eeaf8b 100755
--- a/tests/queries/0_stateless/01508_race_condition_rename_clear_zookeeper_long.sh
+++ b/tests/queries/0_stateless/01508_race_condition_rename_clear_zookeeper_long.sh
@@ -8,7 +8,9 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 $CLICKHOUSE_CLIENT --query "DROP TABLE IF EXISTS table_for_renames0"
 $CLICKHOUSE_CLIENT --query "DROP TABLE IF EXISTS table_for_renames50"
 
-$CLICKHOUSE_CLIENT --query "CREATE TABLE table_for_renames0 (value UInt64, data String) ENGINE ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/concurrent_rename', '1') ORDER BY tuple() SETTINGS cleanup_delay_period = 1, cleanup_delay_period_random_add = 0"
+$CLICKHOUSE_CLIENT --query "CREATE TABLE table_for_renames0 (value UInt64, data String)
+ENGINE ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/concurrent_rename', '1') ORDER BY tuple()
+SETTINGS cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, cleanup_thread_preferred_points_per_iteration=0"
 
 $CLICKHOUSE_CLIENT --query "INSERT INTO table_for_renames0 SELECT number, toString(number) FROM numbers(1000)"
 
diff --git a/tests/queries/0_stateless/01509_parallel_quorum_and_merge_long.sh b/tests/queries/0_stateless/01509_parallel_quorum_and_merge_long.sh
index 445706e35bf..bf88ad0e0b2 100755
--- a/tests/queries/0_stateless/01509_parallel_quorum_and_merge_long.sh
+++ b/tests/queries/0_stateless/01509_parallel_quorum_and_merge_long.sh
@@ -13,7 +13,8 @@ $CLICKHOUSE_CLIENT -q "DROP TABLE IF EXISTS parallel_q1 SYNC"
 $CLICKHOUSE_CLIENT -q "DROP TABLE IF EXISTS parallel_q2 SYNC"
 
 
-$CLICKHOUSE_CLIENT -q "CREATE TABLE parallel_q1 (x UInt64) ENGINE=ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/parallel_q', 'r1') ORDER BY tuple() SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0"
+$CLICKHOUSE_CLIENT -q "CREATE TABLE parallel_q1 (x UInt64) ENGINE=ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/parallel_q', 'r1') ORDER BY tuple()
+SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0, cleanup_thread_preferred_points_per_iteration=0"
 
 $CLICKHOUSE_CLIENT -q "CREATE TABLE parallel_q2 (x UInt64) ENGINE=ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/parallel_q', 'r2') ORDER BY tuple() SETTINGS always_fetch_merged_part = 1"
 
diff --git a/tests/queries/0_stateless/01921_concurrent_ttl_and_normal_merges_zookeeper_long.sh b/tests/queries/0_stateless/01921_concurrent_ttl_and_normal_merges_zookeeper_long.sh
index a3682a3a74b..5e1600a0673 100755
--- a/tests/queries/0_stateless/01921_concurrent_ttl_and_normal_merges_zookeeper_long.sh
+++ b/tests/queries/0_stateless/01921_concurrent_ttl_and_normal_merges_zookeeper_long.sh
@@ -24,7 +24,8 @@ for i in $(seq 1 $NUM_REPLICAS); do
     ENGINE ReplicatedMergeTree('/test/01921_concurrent_ttl_and_normal_merges/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/ttl_table', '$i')
     ORDER BY tuple()
     TTL key + INTERVAL 1 SECOND
-    SETTINGS merge_with_ttl_timeout=1, max_replicated_merges_with_ttl_in_queue=100, max_number_of_merges_with_ttl_in_pool=100, cleanup_delay_period=1, cleanup_delay_period_random_add=0;"
+    SETTINGS merge_with_ttl_timeout=1, max_replicated_merges_with_ttl_in_queue=100, max_number_of_merges_with_ttl_in_pool=100,
+    cleanup_delay_period=1, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;"
 done
 
 function optimize_thread
diff --git a/tests/queries/0_stateless/02067_lost_part_s3.sql b/tests/queries/0_stateless/02067_lost_part_s3.sql
index 12afdcd4421..7df15ab33c4 100644
--- a/tests/queries/0_stateless/02067_lost_part_s3.sql
+++ b/tests/queries/0_stateless/02067_lost_part_s3.sql
@@ -4,11 +4,17 @@ DROP TABLE IF EXISTS partslost_0;
 DROP TABLE IF EXISTS partslost_1;
 DROP TABLE IF EXISTS partslost_2;
 
-CREATE TABLE partslost_0 (x String) ENGINE=ReplicatedMergeTree('/clickhouse/table/{database}_02067_lost/partslost', '0') ORDER BY tuple() SETTINGS min_rows_for_wide_part = 0, min_bytes_for_wide_part = 0, old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 1;
+CREATE TABLE partslost_0 (x String) ENGINE=ReplicatedMergeTree('/clickhouse/table/{database}_02067_lost/partslost', '0') ORDER BY tuple()
+    SETTINGS min_rows_for_wide_part = 0, min_bytes_for_wide_part = 0, old_parts_lifetime = 1,
+    cleanup_delay_period = 1, cleanup_delay_period_random_add = 1, cleanup_thread_preferred_points_per_iteration=0;
 
-CREATE TABLE partslost_1 (x String) ENGINE=ReplicatedMergeTree('/clickhouse/table/{database}_02067_lost/partslost', '1') ORDER BY tuple() SETTINGS min_rows_for_wide_part = 0, min_bytes_for_wide_part = 0, old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 1;
+CREATE TABLE partslost_1 (x String) ENGINE=ReplicatedMergeTree('/clickhouse/table/{database}_02067_lost/partslost', '1') ORDER BY tuple()
+    SETTINGS min_rows_for_wide_part = 0, min_bytes_for_wide_part = 0, old_parts_lifetime = 1,
+    cleanup_delay_period = 1, cleanup_delay_period_random_add = 1, cleanup_thread_preferred_points_per_iteration=0;
 
-CREATE TABLE partslost_2 (x String) ENGINE=ReplicatedMergeTree('/clickhouse/table/{database}_02067_lost/partslost', '2') ORDER BY tuple() SETTINGS min_rows_for_wide_part = 0, min_bytes_for_wide_part = 0, old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 1;
+CREATE TABLE partslost_2 (x String) ENGINE=ReplicatedMergeTree('/clickhouse/table/{database}_02067_lost/partslost', '2') ORDER BY tuple()
+    SETTINGS min_rows_for_wide_part = 0, min_bytes_for_wide_part = 0, old_parts_lifetime = 1,
+    cleanup_delay_period = 1, cleanup_delay_period_random_add = 1, cleanup_thread_preferred_points_per_iteration=0;
 
 
 INSERT INTO partslost_0 SELECT toString(number) AS x from system.numbers LIMIT 10000;
diff --git a/tests/queries/0_stateless/02370_lost_part_intersecting_merges.sh b/tests/queries/0_stateless/02370_lost_part_intersecting_merges.sh
index bc297cbb963..e34163d0502 100755
--- a/tests/queries/0_stateless/02370_lost_part_intersecting_merges.sh
+++ b/tests/queries/0_stateless/02370_lost_part_intersecting_merges.sh
@@ -9,7 +9,7 @@ $CLICKHOUSE_CLIENT -q "drop table if exists rmt1 sync;"
 $CLICKHOUSE_CLIENT -q "drop table if exists rmt2 sync;"
 
 $CLICKHOUSE_CLIENT -q "create table rmt1 (n int) engine=ReplicatedMergeTree('/test/02369/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/{database}', '1') order by n
-  settings cleanup_delay_period=0, cleanup_delay_period_random_add=0, old_parts_lifetime=0"
+  settings cleanup_delay_period=0, cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0"
 $CLICKHOUSE_CLIENT -q "create table rmt2 (n int) engine=ReplicatedMergeTree('/test/02369/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/{database}', '2') order by n"
 
 $CLICKHOUSE_CLIENT -q "system stop replicated sends rmt2"
diff --git a/tests/queries/0_stateless/02396_system_parts_race_condition_rm.sh b/tests/queries/0_stateless/02396_system_parts_race_condition_rm.sh
index 5df1a9ba095..e31a091ff45 100755
--- a/tests/queries/0_stateless/02396_system_parts_race_condition_rm.sh
+++ b/tests/queries/0_stateless/02396_system_parts_race_condition_rm.sh
@@ -15,8 +15,12 @@ $CLICKHOUSE_CLIENT -n -q "
     DROP TABLE IF EXISTS alter_table0;
     DROP TABLE IF EXISTS alter_table1;
 
-    CREATE TABLE alter_table0 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16)) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r1') ORDER BY a PARTITION BY b % 10 SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0;
-    CREATE TABLE alter_table1 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16)) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r2') ORDER BY a PARTITION BY b % 10 SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0
+    CREATE TABLE alter_table0 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
+    ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r1') ORDER BY a PARTITION BY b % 10
+    SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, cleanup_thread_preferred_points_per_iteration=0;
+    CREATE TABLE alter_table1 (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
+    ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r2') ORDER BY a PARTITION BY b % 10
+    SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 1, cleanup_delay_period_random_add = 0, cleanup_thread_preferred_points_per_iteration=0
 "
 
 function thread1()
diff --git a/tests/queries/0_stateless/02397_system_parts_race_condition_drop_rm.sh b/tests/queries/0_stateless/02397_system_parts_race_condition_drop_rm.sh
index 548179b94c9..39e513f6be4 100755
--- a/tests/queries/0_stateless/02397_system_parts_race_condition_drop_rm.sh
+++ b/tests/queries/0_stateless/02397_system_parts_race_condition_drop_rm.sh
@@ -58,7 +58,9 @@ function thread6()
     while true; do
         REPLICA=$(($RANDOM % 10))
         $CLICKHOUSE_CLIENT -n -q "DROP TABLE IF EXISTS alter_table_$REPLICA;
-            CREATE TABLE alter_table_$REPLICA (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16)) ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r_$REPLICA') ORDER BY a PARTITION BY b % 10 SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0;";
+            CREATE TABLE alter_table_$REPLICA (a UInt8, b Int16, c Float32, d String, e Array(UInt8), f Nullable(UUID), g Tuple(UInt8, UInt16))
+            ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/alter_table', 'r_$REPLICA') ORDER BY a PARTITION BY b % 10
+            SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0, cleanup_thread_preferred_points_per_iteration=0;";
         sleep 0.$RANDOM;
     done
 }
diff --git a/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql b/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql
index 88fb2cdf9b1..bab4bf7881c 100644
--- a/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql
+++ b/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql
@@ -8,7 +8,7 @@ drop table if exists rmt2;
 -- Disable compact parts, because we need hardlinks in mutations.
 create table rmt (n int, m int, k int) engine=ReplicatedMergeTree('/test/02432/{database}', '1') order by tuple()
     settings storage_policy = 's3_cache', allow_remote_fs_zero_copy_replication=1,
-        max_part_removal_threads=10, concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1,
+        max_part_removal_threads=10, concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,
         max_replicated_merges_in_queue=0, max_replicated_mutations_in_queue=0, min_bytes_for_wide_part=0, min_rows_for_wide_part=0;
 
 insert into rmt(n, m) values (1, 42);
@@ -38,7 +38,7 @@ select count(), sum(n), sum(m) from rmt;
 -- New table can assign merges/mutations and can remove old parts
 create table rmt2 (n int, m int, k String) engine=ReplicatedMergeTree('/test/02432/{database}', '2') order by tuple()
     settings storage_policy = 's3_cache', allow_remote_fs_zero_copy_replication=1,
-        max_part_removal_threads=10, concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1,
+        max_part_removal_threads=10, concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,
         min_bytes_for_wide_part=0, min_rows_for_wide_part=0, max_replicated_merges_in_queue=1,
         old_parts_lifetime=0;
 
diff --git a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
index 4befe952a14..44303a1c532 100644
--- a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
+++ b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
@@ -5,9 +5,11 @@ SET insert_keeper_fault_injection_probability=0; -- disable fault injection; par
 drop table if exists rmt1;
 drop table if exists rmt2;
 create table rmt1 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '1') order by tuple()
-    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1, old_parts_lifetime=0, max_parts_to_merge_at_once=4;
+    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
+    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4;
 create table rmt2 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '2') order by tuple()
-    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1, old_parts_lifetime=0, max_parts_to_merge_at_once=4;
+    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
+    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4;
 
 -- insert part only on one replica
 system stop replicated sends rmt1;
diff --git a/tests/queries/0_stateless/02494_zero_copy_and_projection_and_mutation_work_together.sql b/tests/queries/0_stateless/02494_zero_copy_and_projection_and_mutation_work_together.sql
index 98427874160..b4504a55643 100644
--- a/tests/queries/0_stateless/02494_zero_copy_and_projection_and_mutation_work_together.sql
+++ b/tests/queries/0_stateless/02494_zero_copy_and_projection_and_mutation_work_together.sql
@@ -24,7 +24,8 @@ CREATE TABLE wikistat1
 )
 ENGINE = ReplicatedMergeTree('/clickhouse/tables/{database}/02494_zero_copy_and_projection', '1')
 ORDER BY (path, time)
-SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0, allow_remote_fs_zero_copy_replication=1, min_bytes_for_wide_part=0;
+SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0, allow_remote_fs_zero_copy_replication=1, min_bytes_for_wide_part=0;
 
 CREATE TABLE wikistat2
 (
@@ -49,7 +50,8 @@ CREATE TABLE wikistat2
 )
 ENGINE = ReplicatedMergeTree('/clickhouse/tables/{database}/02494_zero_copy_and_projection', '2')
 ORDER BY (path, time)
-SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0, allow_remote_fs_zero_copy_replication=1, min_bytes_for_wide_part=0;
+SETTINGS old_parts_lifetime = 1, cleanup_delay_period = 0, cleanup_delay_period_random_add = 0,
+    cleanup_thread_preferred_points_per_iteration=0, allow_remote_fs_zero_copy_replication=1, min_bytes_for_wide_part=0;
 
 INSERT INTO wikistat1 SELECT toDateTime('2020-10-01 00:00:00'), 'hello', 'world', '/data/path', 10 from numbers(100);
 
diff --git a/tests/queries/0_stateless/02515_cleanup_async_insert_block_ids.sh b/tests/queries/0_stateless/02515_cleanup_async_insert_block_ids.sh
index 458a5e95faa..bc6e7eeb214 100755
--- a/tests/queries/0_stateless/02515_cleanup_async_insert_block_ids.sh
+++ b/tests/queries/0_stateless/02515_cleanup_async_insert_block_ids.sh
@@ -13,7 +13,7 @@ $CLICKHOUSE_CLIENT -n --query "
     CREATE TABLE t_async_insert_cleanup (
         KeyID UInt32
     ) Engine = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/t_async_insert_cleanup', '{replica}')
-    ORDER BY (KeyID) SETTINGS cleanup_delay_period = 1, cleanup_delay_period_random_add = 1, replicated_deduplication_window_for_async_inserts=10
+    ORDER BY (KeyID) SETTINGS cleanup_delay_period = 1, cleanup_delay_period_random_add = 1, cleanup_thread_preferred_points_per_iteration=0, replicated_deduplication_window_for_async_inserts=10
 "
 
 for i in {1..100}; do

From dbf08b25fb8f569a33dc3a8b05862af9e61eb72a Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 23 May 2023 01:25:17 +0200
Subject: [PATCH 115/722] better scheduling of merge selecting task

---
 src/Storages/MergeTree/MergeTreeSettings.cpp  |  24 +++
 src/Storages/MergeTree/MergeTreeSettings.h    |   4 +-
 .../ReplicatedMergeTreeCleanupThread.cpp      |   2 +-
 src/Storages/StorageMergeTree.cpp             |   3 +-
 src/Storages/StorageReplicatedMergeTree.cpp   | 198 +++++++++++-------
 src/Storages/StorageReplicatedMergeTree.h     |   2 +
 .../test.py                                   |   3 +-
 .../test_merge_tree_empty_parts/test.py       |   2 +-
 8 files changed, 157 insertions(+), 81 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeSettings.cpp b/src/Storages/MergeTree/MergeTreeSettings.cpp
index 479e50fdebb..6df841059b9 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.cpp
+++ b/src/Storages/MergeTree/MergeTreeSettings.cpp
@@ -175,5 +175,29 @@ void MergeTreeSettings::sanityCheck(size_t background_pool_tasks) const
             min_bytes_to_rebalance_partition_over_jbod,
             max_bytes_to_merge_at_max_space_in_pool / 1024);
     }
+
+    if (max_cleanup_delay_period < cleanup_delay_period)
+    {
+        throw Exception(
+            ErrorCodes::BAD_ARGUMENTS,
+            "The value of max_cleanup_delay_period setting ({}) must be greater than the value of cleanup_delay_period setting ({})",
+            max_cleanup_delay_period, cleanup_delay_period);
+    }
+
+    if (max_merge_selecting_sleep_ms < merge_selecting_sleep_ms)
+    {
+        throw Exception(
+            ErrorCodes::BAD_ARGUMENTS,
+            "The value of max_merge_selecting_sleep_ms setting ({}) must be greater than the value of merge_selecting_sleep_ms setting ({})",
+            max_merge_selecting_sleep_ms, merge_selecting_sleep_ms);
+    }
+
+    if (merge_selecting_sleep_slowdown_factor < 1.f)
+    {
+        throw Exception(
+            ErrorCodes::BAD_ARGUMENTS,
+            "The value of merge_selecting_sleep_slowdown_factor setting ({}) cannot be less than 1.0",
+            merge_selecting_sleep_slowdown_factor);
+    }
 }
 }
diff --git a/src/Storages/MergeTree/MergeTreeSettings.h b/src/Storages/MergeTree/MergeTreeSettings.h
index 78d703e795c..56860342038 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.h
+++ b/src/Storages/MergeTree/MergeTreeSettings.h
@@ -57,7 +57,9 @@ struct Settings;
     M(Bool, fsync_part_directory, false, "Do fsync for part directory after all part operations (writes, renames, etc.).", 0) \
     M(UInt64, non_replicated_deduplication_window, 0, "How many last blocks of hashes should be kept on disk (0 - disabled).", 0) \
     M(UInt64, max_parts_to_merge_at_once, 100, "Max amount of parts which can be merged at once (0 - disabled). Doesn't affect OPTIMIZE FINAL query.", 0) \
-    M(UInt64, merge_selecting_sleep_ms, 5000, "Sleep time for merge selecting when no part selected, a lower setting will trigger selecting tasks in background_schedule_pool frequently which result in large amount of requests to zookeeper in large-scale clusters", 0) \
+    M(UInt64, merge_selecting_sleep_ms, 5000, "Maximum sleep time for merge selecting, a lower setting will trigger selecting tasks in background_schedule_pool frequently which result in large amount of requests to zookeeper in large-scale clusters", 0) \
+    M(UInt64, max_merge_selecting_sleep_ms, 60000, "Maximum sleep time for merge selecting, a lower setting will trigger selecting tasks in background_schedule_pool frequently which result in large amount of requests to zookeeper in large-scale clusters", 0) \
+    M(Float, merge_selecting_sleep_slowdown_factor, 1.2f, "The sleep time for merge selecting task is multiplied by this factor when there's nothing to merge and divided when a merge was assigned", 0) \
     M(UInt64, merge_tree_clear_old_temporary_directories_interval_seconds, 60, "The period of executing the clear old temporary directories operation in background.", 0) \
     M(UInt64, merge_tree_clear_old_parts_interval_seconds, 1, "The period of executing the clear old parts operation in background.", 0) \
     M(UInt64, merge_tree_clear_old_broken_detached_parts_ttl_timeout_seconds, 1ULL * 3600 * 24 * 30, "Remove old broken detached parts in the background if they remained intouched for a specified by this setting period of time.", 0) \
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp
index 35a860ebb42..bcc4dc749fb 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeCleanupThread.cpp
@@ -108,7 +108,7 @@ void ReplicatedMergeTreeCleanupThread::wakeupEarlierIfNeeded()
         return;
 
     /// Do not re-check all parts too often (avoid constantly calling getNumberOfOutdatedPartsWithExpiredRemovalTime())
-    if (!wakeup_check_timer.compareAndRestart(storage_settings->cleanup_delay_period / 4))
+    if (!wakeup_check_timer.compareAndRestart(storage_settings->cleanup_delay_period / 4.0))
         return;
 
     UInt64 prev_run_timestamp_ms = prev_cleanup_timestamp_ms.load(std::memory_order_relaxed);
diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index 2c19d3ba122..cb8b78b4e0a 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -1298,8 +1298,7 @@ bool StorageMergeTree::scheduleDataProcessingJob(BackgroundJobsAssignee & assign
         /// which is equal or more fresh than commands themselves. In extremely rare case it can happen that we will have alter
         /// in between we took snapshot above and selected commands. That is why we take new snapshot here.
         auto task = std::make_shared<MutatePlainMergeTreeTask>(*this, getInMemoryMetadataPtr(), mutate_entry, shared_lock, common_assignee_trigger);
-        assignee.scheduleMergeMutateTask(task);
-        return true;
+        return assignee.scheduleMergeMutateTask(task);
     }
     if (has_mutations)
     {
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 0698ab7bf38..a6152c22148 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -4,6 +4,7 @@
 #include <ranges>
 
 #include <base/hex.h>
+#include <base/interpolate.h>
 #include <Common/Macros.h>
 #include <Common/MemoryTracker.h>
 #include <Common/ProfileEventsScope.h>
@@ -324,6 +325,7 @@ StorageReplicatedMergeTree::StorageReplicatedMergeTree(
 
     /// Will be activated if we will achieve leader state.
     merge_selecting_task->deactivate();
+    merge_selecting_sleep_ms = getSettings()->merge_selecting_sleep_ms;
 
     mutations_finalizing_task = getContext()->getSchedulePool().createTask(
         getStorageID().getFullTableName() + " (StorageReplicatedMergeTree::mutationsFinalizingTask)", [this] { mutationsFinalizingTask(); });
@@ -414,6 +416,19 @@ StorageReplicatedMergeTree::StorageReplicatedMergeTree(
 
     loadDataParts(skip_sanity_checks);
 
+    if (attach)
+    {
+        /// Provide better initial value of merge_selecting_sleep_ms on server startup
+        auto settings = getSettings();
+        size_t max_parts_in_partition = getMaxPartsCountAndSizeForPartition().first;
+        if (settings->parts_to_delay_insert && max_parts_in_partition < settings->parts_to_delay_insert)
+        {
+            Float64 ratio = 1.0 - static_cast<Float64>(max_parts_in_partition) / settings->parts_to_delay_insert;
+            merge_selecting_sleep_ms = static_cast<UInt64>(interpolateLinear(settings->merge_selecting_sleep_ms,
+                                                                             settings->max_merge_selecting_sleep_ms, ratio));
+        }
+    }
+
     if (!current_zookeeper)
     {
         if (!attach)
@@ -3237,7 +3252,15 @@ void StorageReplicatedMergeTree::mergeSelectingTask()
     const bool cleanup = (storage_settings_ptr->clean_deleted_rows != CleanDeletedRows::Never);
     CreateMergeEntryResult create_result = CreateMergeEntryResult::Other;
 
-    try
+    enum class AttemptStatus
+    {
+        EntryCreated,
+        NeedRetry,
+        Limited,
+        CannotSelect,
+    };
+
+    auto try_assign_merge = [&]() -> AttemptStatus
     {
         /// We must select parts for merge under merge_selecting_mutex because other threads
         /// (OPTIMIZE queries) can assign new merges.
@@ -3259,108 +3282,133 @@ void StorageReplicatedMergeTree::mergeSelectingTask()
                 "Current background tasks memory usage: {}.",
                 formatReadableSizeWithBinarySuffix(background_memory_tracker.getSoftLimit()),
                 formatReadableSizeWithBinarySuffix(background_memory_tracker.get()));
+            return AttemptStatus::Limited;
         }
-        else if (merges_and_mutations_sum >= storage_settings_ptr->max_replicated_merges_in_queue)
+
+        if (merges_and_mutations_sum >= storage_settings_ptr->max_replicated_merges_in_queue)
         {
             LOG_TRACE(log, "Number of queued merges ({}) and part mutations ({})"
                 " is greater than max_replicated_merges_in_queue ({}), so won't select new parts to merge or mutate.",
                 merges_and_mutations_queued.merges,
                 merges_and_mutations_queued.mutations,
                 storage_settings_ptr->max_replicated_merges_in_queue);
+            return AttemptStatus::Limited;
         }
-        else
+
+        UInt64 max_source_parts_size_for_merge = merger_mutator.getMaxSourcePartsSizeForMerge(
+            storage_settings_ptr->max_replicated_merges_in_queue, merges_and_mutations_sum);
+
+        UInt64 max_source_part_size_for_mutation = merger_mutator.getMaxSourcePartSizeForMutation();
+
+        bool merge_with_ttl_allowed = merges_and_mutations_queued.merges_with_ttl < storage_settings_ptr->max_replicated_merges_with_ttl_in_queue &&
+            getTotalMergesWithTTLInMergeList() < storage_settings_ptr->max_number_of_merges_with_ttl_in_pool;
+
+        auto future_merged_part = std::make_shared<FutureMergedMutatedPart>();
+        if (storage_settings.get()->assign_part_uuids)
+            future_merged_part->uuid = UUIDHelpers::generateV4();
+
+        bool can_assign_merge = max_source_parts_size_for_merge > 0;
+        PartitionIdsHint partitions_to_merge_in;
+        if (can_assign_merge)
         {
-            UInt64 max_source_parts_size_for_merge = merger_mutator.getMaxSourcePartsSizeForMerge(
-                storage_settings_ptr->max_replicated_merges_in_queue, merges_and_mutations_sum);
+            auto lightweight_merge_pred = LocalMergePredicate(queue);
+            partitions_to_merge_in = merger_mutator.getPartitionsThatMayBeMerged(
+                max_source_parts_size_for_merge, lightweight_merge_pred, merge_with_ttl_allowed, NO_TRANSACTION_PTR);
+            if (partitions_to_merge_in.empty())
+                can_assign_merge = false;
+            else
+                merge_pred.emplace(queue.getMergePredicate(zookeeper, partitions_to_merge_in));
+        }
 
-            UInt64 max_source_part_size_for_mutation = merger_mutator.getMaxSourcePartSizeForMutation();
+        if (can_assign_merge &&
+            merger_mutator.selectPartsToMerge(future_merged_part, false, max_source_parts_size_for_merge, *merge_pred,
+                                              merge_with_ttl_allowed, NO_TRANSACTION_PTR, nullptr, &partitions_to_merge_in) == SelectPartsDecision::SELECTED)
+        {
+            create_result = createLogEntryToMergeParts(
+                zookeeper,
+                future_merged_part->parts,
+                future_merged_part->name,
+                future_merged_part->uuid,
+                future_merged_part->part_format,
+                deduplicate,
+                deduplicate_by_columns,
+                cleanup,
+                nullptr,
+                merge_pred->getVersion(),
+                future_merged_part->merge_type);
 
-            bool merge_with_ttl_allowed = merges_and_mutations_queued.merges_with_ttl < storage_settings_ptr->max_replicated_merges_with_ttl_in_queue &&
-                getTotalMergesWithTTLInMergeList() < storage_settings_ptr->max_number_of_merges_with_ttl_in_pool;
 
-            auto future_merged_part = std::make_shared<FutureMergedMutatedPart>();
-            if (storage_settings.get()->assign_part_uuids)
-                future_merged_part->uuid = UUIDHelpers::generateV4();
+            if (create_result == CreateMergeEntryResult::Ok)
+                return AttemptStatus::EntryCreated;
+            if (create_result == CreateMergeEntryResult::LogUpdated)
+                return AttemptStatus::NeedRetry;
+        }
 
-            bool can_assign_merge = max_source_parts_size_for_merge > 0;
-            PartitionIdsHint partitions_to_merge_in;
-            if (can_assign_merge)
+        /// If there are many mutations in queue, it may happen, that we cannot enqueue enough merges to merge all new parts
+        if (max_source_part_size_for_mutation == 0 || merges_and_mutations_queued.mutations >= storage_settings_ptr->max_replicated_mutations_in_queue)
+            return AttemptStatus::Limited;
+
+        if (queue.countMutations() > 0)
+        {
+            /// We don't need the list of committing blocks to choose a part to mutate
+            if (!merge_pred)
+                merge_pred.emplace(queue.getMergePredicate(zookeeper, PartitionIdsHint{}));
+
+            /// Choose a part to mutate.
+            DataPartsVector data_parts = getDataPartsVectorForInternalUsage();
+            for (const auto & part : data_parts)
             {
-                auto lightweight_merge_pred = LocalMergePredicate(queue);
-                partitions_to_merge_in = merger_mutator.getPartitionsThatMayBeMerged(
-                    max_source_parts_size_for_merge, lightweight_merge_pred, merge_with_ttl_allowed, NO_TRANSACTION_PTR);
-                if (partitions_to_merge_in.empty())
-                    can_assign_merge = false;
-                else
-                    merge_pred.emplace(queue.getMergePredicate(zookeeper, partitions_to_merge_in));
-            }
+                if (part->getBytesOnDisk() > max_source_part_size_for_mutation)
+                    continue;
 
-            if (can_assign_merge &&
-                merger_mutator.selectPartsToMerge(future_merged_part, false, max_source_parts_size_for_merge, *merge_pred,
-                                                  merge_with_ttl_allowed, NO_TRANSACTION_PTR, nullptr, &partitions_to_merge_in) == SelectPartsDecision::SELECTED)
-            {
-                create_result = createLogEntryToMergeParts(
-                    zookeeper,
-                    future_merged_part->parts,
-                    future_merged_part->name,
+                std::optional<std::pair<Int64, int>> desired_mutation_version = merge_pred->getDesiredMutationVersion(part);
+                if (!desired_mutation_version)
+                    continue;
+
+                create_result = createLogEntryToMutatePart(
+                    *part,
                     future_merged_part->uuid,
-                    future_merged_part->part_format,
-                    deduplicate,
-                    deduplicate_by_columns,
-                    cleanup,
-                    nullptr,
-                    merge_pred->getVersion(),
-                    future_merged_part->merge_type);
-            }
-            /// If there are many mutations in queue, it may happen, that we cannot enqueue enough merges to merge all new parts
-            else if (max_source_part_size_for_mutation > 0 && queue.countMutations() > 0
-                     && merges_and_mutations_queued.mutations < storage_settings_ptr->max_replicated_mutations_in_queue)
-            {
-                /// We don't need the list of committing blocks to choose a part to mutate
-                if (!merge_pred)
-                    merge_pred.emplace(queue.getMergePredicate(zookeeper, PartitionIdsHint{}));
+                    desired_mutation_version->first,
+                    desired_mutation_version->second,
+                    merge_pred->getVersion());
 
-                /// Choose a part to mutate.
-                DataPartsVector data_parts = getDataPartsVectorForInternalUsage();
-                for (const auto & part : data_parts)
-                {
-                    if (part->getBytesOnDisk() > max_source_part_size_for_mutation)
-                        continue;
-
-                    std::optional<std::pair<Int64, int>> desired_mutation_version = merge_pred->getDesiredMutationVersion(part);
-                    if (!desired_mutation_version)
-                        continue;
-
-                    create_result = createLogEntryToMutatePart(
-                        *part,
-                        future_merged_part->uuid,
-                        desired_mutation_version->first,
-                        desired_mutation_version->second,
-                        merge_pred->getVersion());
-
-                    if (create_result == CreateMergeEntryResult::Ok ||
-                        create_result == CreateMergeEntryResult::LogUpdated)
-                        break;
-                }
+                if (create_result == CreateMergeEntryResult::Ok)
+                    return AttemptStatus::EntryCreated;
+                if (create_result == CreateMergeEntryResult::LogUpdated)
+                    return AttemptStatus::NeedRetry;
             }
         }
+
+        return AttemptStatus::CannotSelect;
+    };
+
+    AttemptStatus result = AttemptStatus::CannotSelect;
+    try
+    {
+        result = try_assign_merge();
     }
     catch (...)
     {
         tryLogCurrentException(log, __PRETTY_FUNCTION__);
     }
 
-    if (!is_leader)
-        return;
 
-    if (create_result != CreateMergeEntryResult::Ok
-        && create_result != CreateMergeEntryResult::LogUpdated)
-    {
-        merge_selecting_task->scheduleAfter(storage_settings_ptr->merge_selecting_sleep_ms);
-    }
+    if (result == AttemptStatus::EntryCreated || result == AttemptStatus::NeedRetry)
+        merge_selecting_sleep_ms = static_cast<UInt64>(merge_selecting_sleep_ms / storage_settings_ptr->merge_selecting_sleep_slowdown_factor);
+    else if (result == AttemptStatus::CannotSelect)
+        merge_selecting_sleep_ms = static_cast<UInt64>(merge_selecting_sleep_ms * storage_settings_ptr->merge_selecting_sleep_slowdown_factor);
+
+    if (merge_selecting_sleep_ms < storage_settings_ptr->merge_selecting_sleep_ms)
+        merge_selecting_sleep_ms = storage_settings_ptr->merge_selecting_sleep_ms;
+    if (merge_selecting_sleep_ms > storage_settings_ptr->max_merge_selecting_sleep_ms)
+        merge_selecting_sleep_ms = storage_settings_ptr->max_merge_selecting_sleep_ms;
+
+    if (result == AttemptStatus::EntryCreated)
+        merge_selecting_task->schedule();
     else
     {
-        merge_selecting_task->schedule();
+        LOG_TRACE(log, "Scheduling next merge selecting task after {}ms", merge_selecting_sleep_ms);
+        merge_selecting_task->scheduleAfter(merge_selecting_sleep_ms);
     }
 }
 
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index 01b86dd1425..5d877e4b7fa 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -456,6 +456,8 @@ private:
     /// It is acquired for each iteration of the selection of parts to merge or each OPTIMIZE query.
     std::mutex merge_selecting_mutex;
 
+    UInt64 merge_selecting_sleep_ms;
+
     /// A task that marks finished mutations as done.
     BackgroundSchedulePool::TaskHolder mutations_finalizing_task;
 
diff --git a/tests/integration/test_consistent_parts_after_clone_replica/test.py b/tests/integration/test_consistent_parts_after_clone_replica/test.py
index 0c907340090..2771a874d68 100644
--- a/tests/integration/test_consistent_parts_after_clone_replica/test.py
+++ b/tests/integration/test_consistent_parts_after_clone_replica/test.py
@@ -13,7 +13,8 @@ def fill_nodes(nodes, shard):
             CREATE TABLE test_table(date Date, id UInt32)
             ENGINE = ReplicatedMergeTree('/clickhouse/tables/test{shard}/replicated', '{replica}')
             ORDER BY id PARTITION BY toYYYYMM(date) 
-            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0,
+            cleanup_delay_period_random_add=0, cleanup_thread_preferred_points_per_iteration=0;
             """.format(
                 shard=shard, replica=node.name
             )
diff --git a/tests/integration/test_merge_tree_empty_parts/test.py b/tests/integration/test_merge_tree_empty_parts/test.py
index 0f611408a67..212c0577c13 100644
--- a/tests/integration/test_merge_tree_empty_parts/test.py
+++ b/tests/integration/test_merge_tree_empty_parts/test.py
@@ -27,7 +27,7 @@ def test_empty_parts_alter_delete(started_cluster):
         "CREATE TABLE empty_parts_delete (d Date, key UInt64, value String) "
         "ENGINE = ReplicatedMergeTree('/clickhouse/tables/empty_parts_delete', 'r1') "
         "PARTITION BY toYYYYMM(d) ORDER BY key "
-        "SETTINGS old_parts_lifetime = 1"
+        "SETTINGS old_parts_lifetime = 1, cleanup_delay_period=0, cleanup_thread_preferred_points_per_iteration=0"
     )
 
     node1.query("INSERT INTO empty_parts_delete VALUES (toDate('2020-10-10'), 1, 'a')")

From c9aa3042b50ae1b691149ec9012c1521b01705ac Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 23 May 2023 02:28:23 +0200
Subject: [PATCH 116/722] fix

---
 .../02427_mutate_and_zero_copy_replication_zookeeper.sql        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql b/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql
index 9b0a52b8dbd..e7e0f2f6c59 100644
--- a/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql
+++ b/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql
@@ -9,7 +9,7 @@ CREATE TABLE mutate_and_zero_copy_replication1
 )
 ENGINE ReplicatedMergeTree('/clickhouse/tables/{database}/test_02427_mutate_and_zero_copy_replication/alter', '1')
 ORDER BY tuple()
-SETTINGS old_parts_lifetime=0, cleanup_delay_period=300, cleanup_delay_period_random_add=300, min_bytes_for_wide_part = 0;
+SETTINGS old_parts_lifetime=0, cleanup_delay_period=300, max_cleanup_delay_period=300, cleanup_delay_period_random_add=300, min_bytes_for_wide_part = 0;
 
 CREATE TABLE mutate_and_zero_copy_replication2
 (

From 0fb9e63f76323ae60520df37e9a947c420664de9 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Tue, 23 May 2023 10:00:00 +0000
Subject: [PATCH 117/722] Fix and update broken_tests

---
 tests/broken_tests.txt                                       | 2 --
 tests/queries/0_stateless/01655_plan_optimizations.reference | 1 +
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index 0b4efacba0b..fc60b820f93 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -59,7 +59,6 @@
 01615_random_one_shard_insertion
 01624_soft_constraints
 01651_bugs_from_15889
-01655_plan_optimizations
 01656_test_query_log_factories_info
 01681_bloom_filter_nullable_column
 01700_system_zookeeper_path_in
@@ -101,7 +100,6 @@
 02354_annoy
 02366_union_decimal_conversion
 02375_rocksdb_with_filters
-02377_optimize_sorting_by_input_stream_properties_explain
 02382_join_and_filtering_set
 02402_merge_engine_with_view
 02404_memory_bound_merging
diff --git a/tests/queries/0_stateless/01655_plan_optimizations.reference b/tests/queries/0_stateless/01655_plan_optimizations.reference
index 9796d2e4f82..34ea2bc20a3 100644
--- a/tests/queries/0_stateless/01655_plan_optimizations.reference
+++ b/tests/queries/0_stateless/01655_plan_optimizations.reference
@@ -1,4 +1,5 @@
 Too many optimizations applied to query plan
+Too many optimizations applied to query plan
 > sipHash should be calculated after filtration
 FUNCTION sipHash64
 Filter column: equals

From 84a97ca04a0f22becab1459bb1e557fe1a6104a8 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 23 May 2023 12:18:41 +0200
Subject: [PATCH 118/722] fix

---
 .../02427_mutate_and_zero_copy_replication_zookeeper.sql        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql b/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql
index e7e0f2f6c59..e3c8583ccf4 100644
--- a/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql
+++ b/tests/queries/0_stateless/02427_mutate_and_zero_copy_replication_zookeeper.sql
@@ -19,7 +19,7 @@ CREATE TABLE mutate_and_zero_copy_replication2
 )
 ENGINE ReplicatedMergeTree('/clickhouse/tables/{database}/test_02427_mutate_and_zero_copy_replication/alter', '2')
 ORDER BY tuple()
-SETTINGS old_parts_lifetime=0, cleanup_delay_period=300, cleanup_delay_period_random_add=300;
+SETTINGS old_parts_lifetime=0, cleanup_delay_period=300,  max_cleanup_delay_period=300, cleanup_delay_period_random_add=300;
 
 
 INSERT INTO mutate_and_zero_copy_replication1 VALUES (1, '1', 1.0);

From f3b4959e059640a9b786f421b3fe42f9a1fb4be6 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 23 May 2023 19:37:35 +0200
Subject: [PATCH 119/722] fix

---
 src/Storages/StorageReplicatedMergeTree.cpp                | 7 +++++--
 tests/integration/test_merge_tree_empty_parts/test.py      | 2 +-
 .../queries/0_stateless/02448_clone_replica_lost_part.sql  | 1 +
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index a6152c22148..fc90ff550c7 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -3393,10 +3393,13 @@ void StorageReplicatedMergeTree::mergeSelectingTask()
     }
 
 
+    Float32 new_sleep_ms = merge_selecting_sleep_ms;
     if (result == AttemptStatus::EntryCreated || result == AttemptStatus::NeedRetry)
-        merge_selecting_sleep_ms = static_cast<UInt64>(merge_selecting_sleep_ms / storage_settings_ptr->merge_selecting_sleep_slowdown_factor);
+        new_sleep_ms /= storage_settings_ptr->merge_selecting_sleep_slowdown_factor;
     else if (result == AttemptStatus::CannotSelect)
-        merge_selecting_sleep_ms = static_cast<UInt64>(merge_selecting_sleep_ms * storage_settings_ptr->merge_selecting_sleep_slowdown_factor);
+        new_sleep_ms *= storage_settings_ptr->merge_selecting_sleep_slowdown_factor;
+    new_sleep_ms *= std::uniform_real_distribution<Float32>(1.f, 1.1f)(thread_local_rng);
+    merge_selecting_sleep_ms = static_cast<UInt64>(new_sleep_ms);
 
     if (merge_selecting_sleep_ms < storage_settings_ptr->merge_selecting_sleep_ms)
         merge_selecting_sleep_ms = storage_settings_ptr->merge_selecting_sleep_ms;
diff --git a/tests/integration/test_merge_tree_empty_parts/test.py b/tests/integration/test_merge_tree_empty_parts/test.py
index 212c0577c13..c6a96f3ed1b 100644
--- a/tests/integration/test_merge_tree_empty_parts/test.py
+++ b/tests/integration/test_merge_tree_empty_parts/test.py
@@ -48,7 +48,7 @@ def test_empty_parts_summing(started_cluster):
         "CREATE TABLE empty_parts_summing (d Date, key UInt64, value Int64) "
         "ENGINE = ReplicatedSummingMergeTree('/clickhouse/tables/empty_parts_summing', 'r1') "
         "PARTITION BY toYYYYMM(d) ORDER BY key "
-        "SETTINGS old_parts_lifetime = 1"
+        "SETTINGS old_parts_lifetime = 1, cleanup_delay_period=0, cleanup_thread_preferred_points_per_iteration=0"
     )
 
     node1.query("INSERT INTO empty_parts_summing VALUES (toDate('2020-10-10'), 1, 1)")
diff --git a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
index 44303a1c532..7ad25d75fbe 100644
--- a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
+++ b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
@@ -144,6 +144,7 @@ select sleep(2) format Null; -- increases probability of reproducing the issue
 -- rmt1 will mimic rmt2, but will not be able to fetch parts for a while
 system stop replicated sends rmt2;
 attach table rmt1;
+system sync replica rmt1;
 -- rmt1 should not show the value (200) from dropped part
 select throwIf(n = 200) from rmt1 format Null;
 select 11, arraySort(groupArray(n)) from rmt2;

From be49281044eba2be91c46666ce12a28da446585c Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Wed, 24 May 2023 00:48:09 +0000
Subject: [PATCH 120/722] Try to fix test

---
 .../test/integration/runner/compose/docker_compose_mongo.yml  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docker/test/integration/runner/compose/docker_compose_mongo.yml b/docker/test/integration/runner/compose/docker_compose_mongo.yml
index 8cdcbc421e8..9a6eae6ca8c 100644
--- a/docker/test/integration/runner/compose/docker_compose_mongo.yml
+++ b/docker/test/integration/runner/compose/docker_compose_mongo.yml
@@ -1,7 +1,7 @@
 version: '2.3'
 services:
     mongo1:
-        image: mongo:6.0
+        image: mongo:5.0
         restart: always
         environment:
             MONGO_INITDB_ROOT_USERNAME: root
@@ -11,7 +11,7 @@ services:
         command: --profile=2 --verbose
 
     mongo2:
-        image: mongo:6.0
+        image: mongo:5.0
         restart: always
         ports:
             - ${MONGO_NO_CRED_EXTERNAL_PORT:-27017}:${MONGO_NO_CRED_INTERNAL_PORT:-27017}

From 79c5aa23585efb20d410dccd8036af968525a71b Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Wed, 24 May 2023 06:52:22 +0000
Subject: [PATCH 121/722] Remove test from broken_tests.txt

---
 tests/broken_tests.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index cef8f68b210..e61c1316e17 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -137,4 +137,3 @@
 01600_parts_types_metrics_long
 01287_max_execution_speed
 02703_row_policy_for_database
-02732_rename_after_processing

From 242c3bc9a971b1f9b76df57b7df1ac5d176fe274 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 24 May 2023 16:01:28 +0200
Subject: [PATCH 122/722] fix

---
 tests/integration/test_ttl_replicated/test.py | 22 ++++++++-----------
 .../02448_clone_replica_lost_part.sql         |  7 +++---
 2 files changed, 13 insertions(+), 16 deletions(-)

diff --git a/tests/integration/test_ttl_replicated/test.py b/tests/integration/test_ttl_replicated/test.py
index 4ea4472b812..d78c00a9f9c 100644
--- a/tests/integration/test_ttl_replicated/test.py
+++ b/tests/integration/test_ttl_replicated/test.py
@@ -6,6 +6,7 @@ from helpers.cluster import ClickHouseCluster
 from helpers.test_tools import TSV, exec_query_with_retry
 from helpers.wait_for_helpers import wait_for_delete_inactive_parts
 from helpers.wait_for_helpers import wait_for_delete_empty_parts
+from helpers.test_tools import assert_eq_with_retry
 
 cluster = ClickHouseCluster(__file__)
 node1 = cluster.add_instance("node1", with_zookeeper=True)
@@ -66,7 +67,8 @@ def test_ttl_columns(started_cluster):
             """
                 CREATE TABLE test_ttl(date DateTime, id UInt32, a Int32 TTL date + INTERVAL 1 DAY, b Int32 TTL date + INTERVAL 1 MONTH)
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_columns', '{replica}')
-                ORDER BY id PARTITION BY toDayOfMonth(date) SETTINGS merge_with_ttl_timeout=0, min_bytes_for_wide_part=0;
+                ORDER BY id PARTITION BY toDayOfMonth(date)
+                SETTINGS merge_with_ttl_timeout=0, min_bytes_for_wide_part=0, , max_merge_selecting_sleep_ms=6000;
             """.format(
                 replica=node.name
             )
@@ -99,7 +101,7 @@ def test_merge_with_ttl_timeout(started_cluster):
                 CREATE TABLE {table}(date DateTime, id UInt32, a Int32 TTL date + INTERVAL 1 DAY, b Int32 TTL date + INTERVAL 1 MONTH)
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/{table}', '{replica}')
                 ORDER BY id PARTITION BY toDayOfMonth(date)
-                SETTINGS min_bytes_for_wide_part=0;
+                SETTINGS min_bytes_for_wide_part=0, max_merge_selecting_sleep_ms=6000;
             """.format(
                 replica=node.name, table=table
             )
@@ -134,14 +136,8 @@ def test_merge_with_ttl_timeout(started_cluster):
             )
         )
 
-    time.sleep(15)  # TTL merges shall not happen.
-
-    assert (
-        node1.query("SELECT countIf(a = 0) FROM {table}".format(table=table)) == "3\n"
-    )
-    assert (
-        node2.query("SELECT countIf(a = 0) FROM {table}".format(table=table)) == "3\n"
-    )
+    assert_eq_with_retry(node1, "SELECT countIf(a = 0) FROM {table}".format(table=table), "3\n")
+    assert_eq_with_retry(node2, "SELECT countIf(a = 0) FROM {table}".format(table=table), "3\n")
 
 
 def test_ttl_many_columns(started_cluster):
@@ -155,7 +151,7 @@ def test_ttl_many_columns(started_cluster):
                     _offset Int32 TTL date,
                     _partition Int32 TTL date)
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_2', '{replica}')
-                ORDER BY id PARTITION BY toDayOfMonth(date) SETTINGS merge_with_ttl_timeout=0;
+                ORDER BY id PARTITION BY toDayOfMonth(date) SETTINGS merge_with_ttl_timeout=0, max_merge_selecting_sleep_ms=6000;
             """.format(
                 replica=node.name
             )
@@ -213,7 +209,7 @@ def test_ttl_table(started_cluster, delete_suffix):
                 CREATE TABLE test_ttl(date DateTime, id UInt32)
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl', '{replica}')
                 ORDER BY id PARTITION BY toDayOfMonth(date)
-                TTL date + INTERVAL 1 DAY {delete_suffix} SETTINGS merge_with_ttl_timeout=0;
+                TTL date + INTERVAL 1 DAY {delete_suffix} SETTINGS merge_with_ttl_timeout=0, max_merge_selecting_sleep_ms=6000;
             """.format(
                 replica=node.name, delete_suffix=delete_suffix
             )
@@ -304,7 +300,7 @@ def test_ttl_double_delete_rule_returns_error(started_cluster):
             CREATE TABLE test_ttl(date DateTime, id UInt32)
             ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_double_delete', '{replica}')
             ORDER BY id PARTITION BY toDayOfMonth(date)
-            TTL date + INTERVAL 1 DAY, date + INTERVAL 2 DAY SETTINGS merge_with_ttl_timeout=0
+            TTL date + INTERVAL 1 DAY, date + INTERVAL 2 DAY SETTINGS merge_with_ttl_timeout=0, max_merge_selecting_sleep_ms=6000
         """.format(
                 replica=node1.name
             )
diff --git a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
index 7ad25d75fbe..1e99e1869cc 100644
--- a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
+++ b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
@@ -6,10 +6,12 @@ drop table if exists rmt1;
 drop table if exists rmt2;
 create table rmt1 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '1') order by tuple()
     settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
-    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4;
+    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4,
+    merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=500;
 create table rmt2 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '2') order by tuple()
     settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
-    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4;
+    cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4,
+    merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=500;
 
 -- insert part only on one replica
 system stop replicated sends rmt1;
@@ -144,7 +146,6 @@ select sleep(2) format Null; -- increases probability of reproducing the issue
 -- rmt1 will mimic rmt2, but will not be able to fetch parts for a while
 system stop replicated sends rmt2;
 attach table rmt1;
-system sync replica rmt1;
 -- rmt1 should not show the value (200) from dropped part
 select throwIf(n = 200) from rmt1 format Null;
 select 11, arraySort(groupArray(n)) from rmt2;

From a237b8b83958abbb6976fdb72f67790c54442195 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Wed, 24 May 2023 14:19:37 +0000
Subject: [PATCH 123/722] Automatic style fix

---
 tests/integration/test_ttl_replicated/test.py | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/tests/integration/test_ttl_replicated/test.py b/tests/integration/test_ttl_replicated/test.py
index d78c00a9f9c..d681e81df3a 100644
--- a/tests/integration/test_ttl_replicated/test.py
+++ b/tests/integration/test_ttl_replicated/test.py
@@ -136,8 +136,12 @@ def test_merge_with_ttl_timeout(started_cluster):
             )
         )
 
-    assert_eq_with_retry(node1, "SELECT countIf(a = 0) FROM {table}".format(table=table), "3\n")
-    assert_eq_with_retry(node2, "SELECT countIf(a = 0) FROM {table}".format(table=table), "3\n")
+    assert_eq_with_retry(
+        node1, "SELECT countIf(a = 0) FROM {table}".format(table=table), "3\n"
+    )
+    assert_eq_with_retry(
+        node2, "SELECT countIf(a = 0) FROM {table}".format(table=table), "3\n"
+    )
 
 
 def test_ttl_many_columns(started_cluster):

From 4c94b3d6bce6bf34a52e83f98b6fec312e4ba79b Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 24 May 2023 20:13:37 +0300
Subject: [PATCH 124/722] Update test.py

---
 tests/integration/test_ttl_replicated/test.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/integration/test_ttl_replicated/test.py b/tests/integration/test_ttl_replicated/test.py
index d681e81df3a..7ba5a4359c7 100644
--- a/tests/integration/test_ttl_replicated/test.py
+++ b/tests/integration/test_ttl_replicated/test.py
@@ -68,7 +68,7 @@ def test_ttl_columns(started_cluster):
                 CREATE TABLE test_ttl(date DateTime, id UInt32, a Int32 TTL date + INTERVAL 1 DAY, b Int32 TTL date + INTERVAL 1 MONTH)
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_columns', '{replica}')
                 ORDER BY id PARTITION BY toDayOfMonth(date)
-                SETTINGS merge_with_ttl_timeout=0, min_bytes_for_wide_part=0, , max_merge_selecting_sleep_ms=6000;
+                SETTINGS merge_with_ttl_timeout=0, min_bytes_for_wide_part=0, max_merge_selecting_sleep_ms=6000;
             """.format(
                 replica=node.name
             )

From e66f6272d1dc76859251fde165b2d2d9664dce8f Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Wed, 10 May 2023 18:39:38 +0000
Subject: [PATCH 125/722] Refactor CapnProto format to improve input/output
 performance

---
 src/Core/Settings.h                           |    2 +-
 src/Core/SettingsEnums.cpp                    |    8 +-
 src/Core/SettingsEnums.h                      |    2 +-
 src/Formats/CapnProtoSchema.cpp               |  298 ++++
 .../{CapnProtoUtils.h => CapnProtoSchema.h}   |   13 +-
 src/Formats/CapnProtoSerializer.cpp           | 1218 +++++++++++++++++
 src/Formats/CapnProtoSerializer.h             |   25 +
 src/Formats/CapnProtoUtils.cpp                |  734 ----------
 src/Formats/FormatSettings.h                  |    6 +-
 .../Formats/Impl/CapnProtoRowInputFormat.cpp  |  253 +---
 .../Formats/Impl/CapnProtoRowInputFormat.h    |    9 +-
 .../Formats/Impl/CapnProtoRowOutputFormat.cpp |  266 +---
 .../Formats/Impl/CapnProtoRowOutputFormat.h   |   17 +-
 .../Formats/Impl/ProtobufListInputFormat.cpp  |    9 +-
 .../Formats/Impl/ProtobufRowInputFormat.cpp   |    9 +-
 .../queries/0_stateless/02030_capnp_format.sh |    4 +-
 ...p_case_insensitive_names_matcing.reference |    1 +
 ...35_capnp_case_insensitive_names_matcing.sh |   10 +
 ...ing_and_writing_structure_fields.reference |    3 +
 ...36_reading_and_writing_structure_fields.sh |   24 +
 ...2735_case_insensitive_names_matching.capnp |   13 +
 .../02736_nested_structures.capnp             |   21 +
 22 files changed, 1686 insertions(+), 1259 deletions(-)
 create mode 100644 src/Formats/CapnProtoSchema.cpp
 rename src/Formats/{CapnProtoUtils.h => CapnProtoSchema.h} (59%)
 create mode 100644 src/Formats/CapnProtoSerializer.cpp
 create mode 100644 src/Formats/CapnProtoSerializer.h
 delete mode 100644 src/Formats/CapnProtoUtils.cpp
 create mode 100644 tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
 create mode 100755 tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
 create mode 100644 tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference
 create mode 100755 tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh
 create mode 100644 tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp
 create mode 100644 tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 1df0a8af24f..2863cc9d7a7 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -962,7 +962,7 @@ class IColumn;
     M(Bool, output_format_orc_string_as_string, false, "Use ORC String type instead of Binary for String columns", 0) \
     M(ORCCompression, output_format_orc_compression_method, "lz4", "Compression method for ORC output format. Supported codecs: lz4, snappy, zlib, zstd, none (uncompressed)", 0) \
     \
-    M(EnumComparingMode, format_capn_proto_enum_comparising_mode, FormatSettings::EnumComparingMode::BY_VALUES, "How to map ClickHouse Enum and CapnProto Enum", 0) \
+    M(CapnProtoEnumComparingMode, format_capn_proto_enum_comparising_mode, FormatSettings::CapnProtoEnumComparingMode::BY_VALUES, "How to map ClickHouse Enum and CapnProto Enum", 0) \
     \
     M(String, input_format_mysql_dump_table_name, "", "Name of the table in MySQL dump from which to read data", 0) \
     M(Bool, input_format_mysql_dump_map_column_names, true, "Match columns from table in MySQL dump and columns from ClickHouse table by names", 0) \
diff --git a/src/Core/SettingsEnums.cpp b/src/Core/SettingsEnums.cpp
index e0f16ea00db..a291a23c140 100644
--- a/src/Core/SettingsEnums.cpp
+++ b/src/Core/SettingsEnums.cpp
@@ -144,10 +144,10 @@ IMPLEMENT_SETTING_ENUM(TransactionsWaitCSNMode, ErrorCodes::BAD_ARGUMENTS,
      {"wait",           TransactionsWaitCSNMode::WAIT},
      {"wait_unknown",   TransactionsWaitCSNMode::WAIT_UNKNOWN}})
 
-IMPLEMENT_SETTING_ENUM(EnumComparingMode, ErrorCodes::BAD_ARGUMENTS,
-    {{"by_names",   FormatSettings::EnumComparingMode::BY_NAMES},
-     {"by_values",  FormatSettings::EnumComparingMode::BY_VALUES},
-     {"by_names_case_insensitive", FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE}})
+IMPLEMENT_SETTING_ENUM(CapnProtoEnumComparingMode, ErrorCodes::BAD_ARGUMENTS,
+    {{"by_names",   FormatSettings::CapnProtoEnumComparingMode::BY_NAMES},
+     {"by_values",  FormatSettings::CapnProtoEnumComparingMode::BY_VALUES},
+     {"by_names_case_insensitive", FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE}})
 
 IMPLEMENT_SETTING_ENUM(EscapingRule, ErrorCodes::BAD_ARGUMENTS,
     {{"None", FormatSettings::EscapingRule::None},
diff --git a/src/Core/SettingsEnums.h b/src/Core/SettingsEnums.h
index 3ae7bfaa673..1c5be910ef7 100644
--- a/src/Core/SettingsEnums.h
+++ b/src/Core/SettingsEnums.h
@@ -188,7 +188,7 @@ enum class TransactionsWaitCSNMode
 
 DECLARE_SETTING_ENUM(TransactionsWaitCSNMode)
 
-DECLARE_SETTING_ENUM_WITH_RENAME(EnumComparingMode, FormatSettings::EnumComparingMode)
+DECLARE_SETTING_ENUM_WITH_RENAME(CapnProtoEnumComparingMode, FormatSettings::CapnProtoEnumComparingMode)
 
 DECLARE_SETTING_ENUM_WITH_RENAME(EscapingRule, FormatSettings::EscapingRule)
 
diff --git a/src/Formats/CapnProtoSchema.cpp b/src/Formats/CapnProtoSchema.cpp
new file mode 100644
index 00000000000..22518d5061a
--- /dev/null
+++ b/src/Formats/CapnProtoSchema.cpp
@@ -0,0 +1,298 @@
+#include <Formats/CapnProtoSchema.h>
+
+#if USE_CAPNP
+
+#include <DataTypes/DataTypeArray.h>
+#include <DataTypes/DataTypeEnum.h>
+#include <DataTypes/DataTypeNullable.h>
+#include <DataTypes/DataTypeTuple.h>
+#include <DataTypes/DataTypesNumber.h>
+#include <DataTypes/DataTypeString.h>
+#include <DataTypes/IDataType.h>
+#include <Common/StringUtils/StringUtils.h>
+#include <boost/algorithm/string/join.hpp>
+#include <capnp/schema.h>
+#include <capnp/schema-parser.h>
+#include <fcntl.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int CANNOT_PARSE_CAPN_PROTO_SCHEMA;
+    extern const int BAD_TYPE_OF_FIELD;
+    extern const int FILE_DOESNT_EXIST;
+    extern const int UNKNOWN_EXCEPTION;
+    extern const int CAPN_PROTO_BAD_TYPE;
+    extern const int BAD_ARGUMENTS;
+}
+
+capnp::StructSchema CapnProtoSchemaParser::getMessageSchema(const FormatSchemaInfo & schema_info)
+{
+    capnp::ParsedSchema schema;
+    try
+    {
+        int fd;
+        KJ_SYSCALL(fd = open(schema_info.schemaDirectory().data(), O_RDONLY)); // NOLINT(bugprone-suspicious-semicolon)
+        auto schema_dir = kj::newDiskDirectory(kj::OsFileHandle(fd));
+        schema = impl.parseFromDirectory(*schema_dir, kj::Path::parse(schema_info.schemaPath()), {});
+    }
+    catch (const kj::Exception & e)
+    {
+        /// That's not good to determine the type of error by its description, but
+        /// this is the only way to do it here, because kj doesn't specify the type of error.
+        auto description = std::string_view(e.getDescription().cStr());
+        if (description.find("No such file or directory") != String::npos || description.find("no such directory") != String::npos)
+            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot open CapnProto schema, file {} doesn't exists", schema_info.absoluteSchemaPath());
+
+        if (description.find("Parse error") != String::npos)
+            throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA, "Cannot parse CapnProto schema {}:{}", schema_info.schemaPath(), e.getLine());
+
+        throw Exception(ErrorCodes::UNKNOWN_EXCEPTION,
+                        "Unknown exception while parsing CapnProto schema: {}, schema dir and file: {}, {}",
+                        description, schema_info.schemaDirectory(), schema_info.schemaPath());
+    }
+
+    auto message_maybe = schema.findNested(schema_info.messageName());
+    auto * message_schema = kj::_::readMaybe(message_maybe);
+    if (!message_schema)
+        throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA,
+                        "CapnProto schema doesn't contain message with name {}", schema_info.messageName());
+    return message_schema->asStruct();
+}
+
+bool checkIfStructContainsUnnamedUnion(const capnp::StructSchema & struct_schema)
+{
+    return struct_schema.getFields().size() != struct_schema.getNonUnionFields().size();
+}
+
+bool checkIfStructIsNamedUnion(const capnp::StructSchema & struct_schema)
+{
+    return struct_schema.getFields().size() == struct_schema.getUnionFields().size();
+}
+
+/// Get full name of type for better exception messages.
+String getCapnProtoFullTypeName(const capnp::Type & type)
+{
+    static const std::map<capnp::schema::Type::Which, String> capnp_simple_type_names =
+    {
+        {capnp::schema::Type::Which::BOOL, "Bool"},
+        {capnp::schema::Type::Which::VOID, "Void"},
+        {capnp::schema::Type::Which::INT8, "Int8"},
+        {capnp::schema::Type::Which::INT16, "Int16"},
+        {capnp::schema::Type::Which::INT32, "Int32"},
+        {capnp::schema::Type::Which::INT64, "Int64"},
+        {capnp::schema::Type::Which::UINT8, "UInt8"},
+        {capnp::schema::Type::Which::UINT16, "UInt16"},
+        {capnp::schema::Type::Which::UINT32, "UInt32"},
+        {capnp::schema::Type::Which::UINT64, "UInt64"},
+        {capnp::schema::Type::Which::FLOAT32, "Float32"},
+        {capnp::schema::Type::Which::FLOAT64, "Float64"},
+        {capnp::schema::Type::Which::TEXT, "Text"},
+        {capnp::schema::Type::Which::DATA, "Data"},
+        {capnp::schema::Type::Which::INTERFACE, "Interface"},
+        {capnp::schema::Type::Which::ANY_POINTER, "AnyPointer"},
+    };
+
+    switch (type.which())
+    {
+        case capnp::schema::Type::Which::STRUCT:
+        {
+            auto struct_schema = type.asStruct();
+
+            auto non_union_fields = struct_schema.getNonUnionFields();
+            std::vector<String> non_union_field_names;
+            for (auto nested_field : non_union_fields)
+                non_union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
+
+            auto union_fields = struct_schema.getUnionFields();
+            std::vector<String> union_field_names;
+            for (auto nested_field : union_fields)
+                union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
+
+            String union_name = "Union(" + boost::algorithm::join(union_field_names, ", ") + ")";
+            /// Check if the struct is a named union.
+            if (non_union_field_names.empty())
+                return union_name;
+
+            String type_name = "Struct(" + boost::algorithm::join(non_union_field_names, ", ");
+            /// Check if the struct contains unnamed union.
+            if (!union_field_names.empty())
+                type_name += ", " + union_name;
+            type_name += ")";
+            return type_name;
+        }
+        case capnp::schema::Type::Which::LIST:
+            return "List(" + getCapnProtoFullTypeName(type.asList().getElementType()) + ")";
+        case capnp::schema::Type::Which::ENUM:
+        {
+            auto enum_schema = type.asEnum();
+            String enum_name = "Enum(";
+            auto enumerants = enum_schema.getEnumerants();
+            for (unsigned i = 0; i != enumerants.size(); ++i)
+            {
+                enum_name += String(enumerants[i].getProto().getName()) + " = " + std::to_string(enumerants[i].getOrdinal());
+                if (i + 1 != enumerants.size())
+                    enum_name += ", ";
+            }
+            enum_name += ")";
+            return enum_name;
+        }
+        default:
+            auto it = capnp_simple_type_names.find(type.which());
+            if (it == capnp_simple_type_names.end())
+                throw Exception(ErrorCodes::BAD_TYPE_OF_FIELD, "Unknown CapnProto type");
+            return it->second;
+    }
+}
+
+namespace
+{
+
+    template <typename ValueType>
+    static DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
+    {
+        std::vector<std::pair<String, ValueType>> values;
+        for (auto enumerant : enumerants)
+            values.emplace_back(enumerant.getProto().getName(), ValueType(enumerant.getOrdinal()));
+        return std::make_shared<DataTypeEnum<ValueType>>(std::move(values));
+    }
+
+    static DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
+    {
+        auto enumerants = enum_schema.getEnumerants();
+        if (enumerants.size() < 128)
+            return getEnumDataTypeFromEnumerants<Int8>(enumerants);
+        if (enumerants.size() < 32768)
+            return getEnumDataTypeFromEnumerants<Int16>(enumerants);
+
+        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "ClickHouse supports only 8 and 16-bit Enums");
+    }
+
+    static DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::INT8:
+                return std::make_shared<DataTypeInt8>();
+            case capnp::schema::Type::INT16:
+                return std::make_shared<DataTypeInt16>();
+            case capnp::schema::Type::INT32:
+                return std::make_shared<DataTypeInt32>();
+            case capnp::schema::Type::INT64:
+                return std::make_shared<DataTypeInt64>();
+            case capnp::schema::Type::BOOL: [[fallthrough]];
+            case capnp::schema::Type::UINT8:
+                return std::make_shared<DataTypeUInt8>();
+            case capnp::schema::Type::UINT16:
+                return std::make_shared<DataTypeUInt16>();
+            case capnp::schema::Type::UINT32:
+                return std::make_shared<DataTypeUInt32>();
+            case capnp::schema::Type::UINT64:
+                return std::make_shared<DataTypeUInt64>();
+            case capnp::schema::Type::FLOAT32:
+                return std::make_shared<DataTypeFloat32>();
+            case capnp::schema::Type::FLOAT64:
+                return std::make_shared<DataTypeFloat64>();
+            case capnp::schema::Type::DATA: [[fallthrough]];
+            case capnp::schema::Type::TEXT:
+                return std::make_shared<DataTypeString>();
+            case capnp::schema::Type::ENUM:
+                return getEnumDataTypeFromEnumSchema(capnp_type.asEnum());
+            case capnp::schema::Type::LIST:
+            {
+                auto list_schema = capnp_type.asList();
+                auto nested_type = getDataTypeFromCapnProtoType(list_schema.getElementType(), skip_unsupported_fields);
+                if (!nested_type)
+                    return nullptr;
+                return std::make_shared<DataTypeArray>(nested_type);
+            }
+            case capnp::schema::Type::STRUCT:
+            {
+                auto struct_schema = capnp_type.asStruct();
+
+
+                if (struct_schema.getFields().size() == 0)
+                {
+                    if (skip_unsupported_fields)
+                        return nullptr;
+                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Empty messages are not supported");
+                }
+
+                /// Check if it can be Nullable.
+                if (checkIfStructIsNamedUnion(struct_schema))
+                {
+                    auto fields = struct_schema.getUnionFields();
+                    if (fields.size() != 2 || (!fields[0].getType().isVoid() && !fields[1].getType().isVoid()))
+                    {
+                        if (skip_unsupported_fields)
+                            return nullptr;
+                        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unions are not supported");
+                    }
+                    auto value_type = fields[0].getType().isVoid() ? fields[1].getType() : fields[0].getType();
+                    if (value_type.isStruct() || value_type.isList())
+                    {
+                        if (skip_unsupported_fields)
+                            return nullptr;
+                        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Tuples and Lists cannot be inside Nullable");
+                    }
+
+                    auto nested_type = getDataTypeFromCapnProtoType(value_type, skip_unsupported_fields);
+                    if (!nested_type)
+                        return nullptr;
+                    return std::make_shared<DataTypeNullable>(nested_type);
+                }
+
+                if (checkIfStructContainsUnnamedUnion(struct_schema))
+                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
+
+                /// Treat Struct as Tuple.
+                DataTypes nested_types;
+                Names nested_names;
+                for (auto field : struct_schema.getNonUnionFields())
+                {
+                    auto nested_type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
+                    if (!nested_type)
+                        continue;
+                    nested_names.push_back(field.getProto().getName());
+                    nested_types.push_back(nested_type);
+                }
+                if (nested_types.empty())
+                    return nullptr;
+                return std::make_shared<DataTypeTuple>(std::move(nested_types), std::move(nested_names));
+            }
+            default:
+            {
+                if (skip_unsupported_fields)
+                    return nullptr;
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unsupported CapnProtoType: {}", getCapnProtoFullTypeName(capnp_type));
+            }
+        }
+}
+
+}
+
+NamesAndTypesList capnProtoSchemaToCHSchema(const capnp::StructSchema & schema, bool skip_unsupported_fields)
+{
+    if (checkIfStructContainsUnnamedUnion(schema))
+        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
+
+    NamesAndTypesList names_and_types;
+    for (auto field : schema.getNonUnionFields())
+    {
+        auto name = field.getProto().getName();
+        auto type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
+        if (type)
+            names_and_types.emplace_back(name, type);
+    }
+    if (names_and_types.empty())
+        throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                        "Cannot convert CapnProto schema to ClickHouse table schema, all fields have unsupported types");
+
+    return names_and_types;
+}
+
+}
+
+#endif
diff --git a/src/Formats/CapnProtoUtils.h b/src/Formats/CapnProtoSchema.h
similarity index 59%
rename from src/Formats/CapnProtoUtils.h
rename to src/Formats/CapnProtoSchema.h
index 2d8cdb418d7..225f6f56207 100644
--- a/src/Formats/CapnProtoUtils.h
+++ b/src/Formats/CapnProtoSchema.h
@@ -30,17 +30,14 @@ public:
     capnp::StructSchema getMessageSchema(const FormatSchemaInfo & schema_info);
 };
 
-std::pair<String, String> splitCapnProtoFieldName(const String & name);
+bool checkIfStructContainsUnnamedUnion(const capnp::StructSchema & struct_schema);
+bool checkIfStructIsNamedUnion(const capnp::StructSchema & struct_schema);
 
-bool compareEnumNames(const String & first, const String & second, FormatSettings::EnumComparingMode mode);
-
-std::pair<capnp::DynamicStruct::Builder, capnp::StructSchema::Field> getStructBuilderAndFieldByColumnName(capnp::DynamicStruct::Builder struct_builder, const String & name);
-
-capnp::DynamicValue::Reader getReaderByColumnName(const capnp::DynamicStruct::Reader & struct_reader, const String & name);
-
-void checkCapnProtoSchemaStructure(const capnp::StructSchema & schema, const Block & header, FormatSettings::EnumComparingMode mode);
+/// Get full name of type for better exception messages.
+String getCapnProtoFullTypeName(const capnp::Type & type);
 
 NamesAndTypesList capnProtoSchemaToCHSchema(const capnp::StructSchema & schema, bool skip_unsupported_fields);
+
 }
 
 #endif
diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
new file mode 100644
index 00000000000..e0c8ae2a79a
--- /dev/null
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -0,0 +1,1218 @@
+#include <Formats/CapnProtoSerializer.h>
+#include <Formats/FormatSettings.h>
+#include <Formats/CapnProtoSchema.h>
+#include <DataTypes/DataTypeArray.h>
+#include <DataTypes/DataTypeEnum.h>
+#include <DataTypes/DataTypeLowCardinality.h>
+#include <DataTypes/DataTypeNullable.h>
+#include <DataTypes/DataTypeTuple.h>
+#include <DataTypes/DataTypesNumber.h>
+#include <DataTypes/DataTypeMap.h>
+#include <DataTypes/IDataType.h>
+#include <Columns/ColumnArray.h>
+#include <Columns/ColumnNullable.h>
+#include <Columns/ColumnString.h>
+#include <Columns/ColumnFixedString.h>
+#include <Columns/ColumnTuple.h>
+#include <Columns/ColumnLowCardinality.h>
+#include <Columns/ColumnsDateTime.h>
+#include <Columns/ColumnMap.h>
+
+#include <boost/algorithm/string.hpp>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int THERE_IS_NO_COLUMN;
+    extern const int BAD_TYPE_OF_FIELD;
+    extern const int CAPN_PROTO_BAD_CAST;
+    extern const int INCORRECT_DATA;
+    extern const int ILLEGAL_COLUMN;
+}
+
+namespace
+{
+    std::pair<String, String> splitFieldName(const String & name)
+    {
+        const auto * begin = name.data();
+        const auto * end = name.data() + name.size();
+        const auto * it = find_first_symbols<'_', '.'>(begin, end);
+        String first = String(begin, it);
+        String second = it == end ? "" : String(it + 1, end);
+        return {first, second};
+    }
+
+    std::optional<capnp::StructSchema::Field> findFieldByName(const capnp::StructSchema & struct_schema, const String & name)
+    {
+        const auto & fields = struct_schema.getFields();
+        for (auto field : fields)
+        {
+            auto field_name = String(field.getProto().getName());
+            if (boost::to_lower_copy(name) == boost::to_lower_copy(field_name))
+                return field;
+        }
+        return std::nullopt;
+    }
+
+    [[noreturn]] void throwCannotConvert(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type)
+    {
+        throw Exception(
+            ErrorCodes::CAPN_PROTO_BAD_CAST,
+            "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto type {}",
+            name,
+            type->getName(),
+            getCapnProtoFullTypeName(capnp_type));
+    }
+
+    struct FieldBuilder
+    {
+        virtual ~FieldBuilder() = default;
+    };
+
+    struct ListBuilder : public FieldBuilder
+    {
+        explicit ListBuilder(capnp::DynamicValue::Builder builder) : impl(builder.as<capnp::DynamicList>())
+        {
+        }
+
+        capnp::DynamicList::Builder impl;
+        std::vector<std::unique_ptr<FieldBuilder>> nested_builders;
+    };
+
+    struct StructBuilder : public FieldBuilder
+    {
+        explicit StructBuilder(capnp::DynamicValue::Builder builder, size_t fields_size) : impl(builder.as<capnp::DynamicStruct>()), field_builders(fields_size)
+        {
+        }
+
+        explicit StructBuilder(capnp::DynamicStruct::Builder struct_builder, size_t fields_size) : impl(std::move(struct_builder)), field_builders(fields_size)
+        {
+        }
+
+        capnp::DynamicStruct::Builder impl;
+        std::vector<std::unique_ptr<FieldBuilder>> field_builders;
+    };
+
+    std::unique_ptr<FieldBuilder> initStructFieldBuilderIfNeeded(const ColumnPtr & column, size_t row_num, capnp::DynamicStruct::Builder & struct_builder, const capnp::StructSchema::Field & field, const capnp::Type & capnp_type, size_t nested_fields_size)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::LIST:
+            {
+                const auto * array_column = assert_cast<const ColumnArray *>(column.get());
+                size_t size = array_column->getOffsets()[row_num] - array_column->getOffsets()[row_num - 1];
+                return std::make_unique<ListBuilder>(struct_builder.init(field, static_cast<unsigned>(size)));
+            }
+            case capnp::schema::Type::STRUCT:
+            {
+                return std::make_unique<StructBuilder>(struct_builder.init(field), nested_fields_size);
+            }
+            default:
+                return nullptr;
+        }
+    }
+
+    class ICapnProtoSerializer
+    {
+    public:
+        virtual std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * builder, size_t row_num) = 0;
+        virtual void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) = 0;
+
+        virtual ~ICapnProtoSerializer() = default;
+    };
+
+    template <typename NumericType, bool is_bool_data_type, capnp::DynamicValue::Type capnp_dynamic_type>
+    class CapnProtoIntegerSerializer : public ICapnProtoSerializer
+    {
+    public:
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::INT)
+                return capnp::DynamicValue::Reader(column->getInt(row_num));
+            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::UINT)
+                return capnp::DynamicValue::Reader(column->getUInt(row_num));
+            return capnp::DynamicValue::Reader(column->getBool(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            NumericType value;
+            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::INT)
+                value = static_cast<NumericType>(reader.as<Int64>());
+            else if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::UINT)
+                value = static_cast<NumericType>(reader.as<UInt64>());
+            else if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::BOOL)
+                value = static_cast<NumericType>(reader.as<bool>());
+
+            if constexpr (is_bool_data_type)
+                assert_cast<ColumnUInt8 &>(column).insertValue(static_cast<bool>(value));
+            else
+                assert_cast<ColumnVector<NumericType> &>(column).insertValue(value);
+        }
+    };
+
+    template <typename NumericType, bool is_bool_data_type = false>
+    static std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::INT8: [[fallthrough]];
+            case capnp::schema::Type::INT16: [[fallthrough]];
+            case capnp::schema::Type::INT32: [[fallthrough]];
+            case capnp::schema::Type::INT64:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::INT>>();
+            case capnp::schema::Type::UINT8: [[fallthrough]];
+            case capnp::schema::Type::UINT16: [[fallthrough]];
+            case capnp::schema::Type::UINT32: [[fallthrough]];
+            case capnp::schema::Type::UINT64:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::UINT>>();
+            case capnp::schema::Type::BOOL:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::BOOL>>();
+            default:
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+    }
+
+    template <typename NumericType>
+    class CapnProtoBigIntegerSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoBigIntegerSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(NumericType))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+
+    private:
+        DataTypePtr data_type;
+    };
+
+    template <typename FloatType>
+    class CapnProtoFloatSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoFloatSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isFloat32() && !capnp_type.isFloat64())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getFloat64(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnVector<FloatType> &>(column).insertValue(reader.as<FloatType>());
+        }
+    };
+
+    template <typename EnumType>
+    class CapnProtoEnumSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoEnumSerializer(
+            const DataTypePtr & data_type_,
+            const String & column_name,
+            const capnp::Type & capnp_type,
+            const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode_) : data_type(data_type_), enum_comparing_mode(enum_comparing_mode_)
+        {
+            if (!capnp_type.isEnum())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            bool to_lower = enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE;
+            const auto * enum_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            const auto & enum_values = dynamic_cast<const EnumValues<EnumType> &>(*enum_type);
+
+            enum_schema = capnp_type.asEnum();
+            auto enumerants = enum_schema.getEnumerants();
+            constexpr auto max_value = std::is_same_v<EnumType, Int8> ? INT8_MAX : INT16_MAX;
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+            {
+                /// In CapnProto Enum fields are numbered sequentially starting from zero.
+                if (enumerants.size() > max_value)
+                    throw Exception(
+                        ErrorCodes::CAPN_PROTO_BAD_CAST,
+                        "Enum from CapnProto schema contains values that are out of range for Clickhouse enum type {}",
+                        data_type->getName());
+
+                auto values = enum_values.getSetOfAllValues();
+                std::unordered_set<EnumType> capn_enum_values;
+                for (auto enumerant : enumerants)
+                    capn_enum_values.insert(EnumType(enumerant.getOrdinal()));
+                if (values != capn_enum_values)
+                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "The set of values in Enum from CapnProto schema is different from the set of values in ClickHouse Enum");
+            }
+            else
+            {
+                auto names = enum_values.getSetOfAllNames(to_lower);
+                std::unordered_set<String> capn_enum_names;
+
+                for (auto enumerant : enumerants)
+                {
+                    String name = enumerant.getProto().getName();
+                    capn_enum_names.insert(to_lower ? boost::algorithm::to_lower_copy(name) : name);
+                }
+
+                if (names != capn_enum_names)
+                    throw Exception(
+                        ErrorCodes::CAPN_PROTO_BAD_CAST,
+                        "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum");
+            }
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            const auto * enum_data_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                return capnp::DynamicValue::Reader(capnp::DynamicEnum(enum_schema, enum_value));
+
+            auto enum_name = enum_data_type->getNameForValue(enum_value);
+            for (const auto enumerant : enum_schema.getEnumerants())
+            {
+                if (compareEnumNames(String(enum_name), enumerant.getProto().getName(), enum_comparing_mode))
+                    return capnp::DynamicValue::Reader(capnp::DynamicEnum(enumerant));
+            }
+
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert CLickHouse Enum value to CapnProto Enum");
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto enum_value = reader.as<capnp::DynamicEnum>();
+            auto enumerant = *kj::_::readMaybe(enum_value.getEnumerant());
+            auto enum_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            DataTypePtr nested_type = std::make_shared<DataTypeNumber<EnumType>>();
+            switch (enum_comparing_mode)
+            {
+                case FormatSettings::CapnProtoEnumComparingMode::BY_VALUES:
+                {
+                    assert_cast<ColumnVector<EnumType> &>(column).insertValue(static_cast<EnumType>(enumerant.getOrdinal()));
+                    return;
+                }
+                case FormatSettings::CapnProtoEnumComparingMode::BY_NAMES:
+                {
+                    auto value = enum_type->getValue(String(enumerant.getProto().getName()));
+                    assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
+                    return;
+                }
+                case FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE:
+                {
+                    /// Find the same enum name case insensitive.
+                    String enum_name = enumerant.getProto().getName();
+                    for (auto & name : enum_type->getAllRegisteredNames())
+                    {
+                        if (compareEnumNames(name, enum_name, enum_comparing_mode))
+                        {
+                            assert_cast<ColumnVector<EnumType> &>(column).insertValue(enum_type->getValue(name));
+                            break;
+                        }
+                    }
+                    return;
+                }
+            }
+        }
+
+    private:
+        bool compareEnumNames(const String & first, const String & second, const FormatSettings::CapnProtoEnumComparingMode mode)
+        {
+            if (mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE)
+                return boost::algorithm::to_lower_copy(first) == boost::algorithm::to_lower_copy(second);
+            return first == second;
+        }
+
+        DataTypePtr data_type;
+        capnp::EnumSchema enum_schema;
+        const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode;
+    };
+
+    class CapnProtoDateSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDateSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isUInt16())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getUInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDate &>(column).insertValue(reader.as<UInt16>());
+        }
+    };
+
+    class CapnProtoDate32Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDate32Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isInt32())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDate32 &>(column).insertValue(reader.as<Int32>());
+        }
+    };
+
+    class CapnProtoDateTimeSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDateTimeSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isUInt32())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDateTime &>(column).insertValue(reader.as<UInt32>());
+        }
+    };
+
+    class CapnProtoDateTime64Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDateTime64Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isInt64())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDateTime64 &>(column).insertValue(reader.as<Int64>());
+        }
+    };
+
+    template <typename DecimalType>
+    class CapnProtoDecimalSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoDecimalSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            auto which = WhichDataType(data_type);
+            if ((!capnp_type.isInt32() && which.isDecimal32()) || (!capnp_type.isInt64() && which.isDecimal64()))
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(column->getInt(row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(reader.as<typename DecimalType::NativeType>());
+        }
+    };
+
+    template <typename DecimalType>
+    class CapnProtoBigDecimalSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoBigDecimalSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(DecimalType))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+
+    private:
+        DataTypePtr data_type;
+    };
+
+    template <bool is_binary>
+    class CapnProtoStringSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
+        {
+            if (!capnp_type.isData() && !capnp_type.isText())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+
+            if constexpr (is_binary)
+                return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+
+            /// For type TEXT data must be null-terminated, but in String column we always have 0 byte at the end of each value.
+            return capnp::DynamicValue::Reader(capnp::Text::Reader(data.data, data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            if constexpr (is_binary)
+            {
+                auto value = reader.as<capnp::Data>();
+                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+            else
+            {
+                auto value = reader.as<capnp::Text>();
+                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+        }
+
+    private:
+        capnp::Type capnp_type;
+    };
+
+    template <bool is_binary>
+    class CapnProtoFixedStringSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoFixedStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
+        {
+            if (!capnp_type.isData() && !capnp_type.isText())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            if constexpr (is_binary)
+                return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+
+            if (data.data[data.size - 1] == 0)
+                return capnp::DynamicValue::Reader(capnp::Text::Reader(reinterpret_cast<const char *>(data.data), data.size));
+
+            /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
+            /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
+            /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
+            /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
+            tmp_string = data.toString();
+            return capnp::DynamicValue::Reader(capnp::Text::Reader(reinterpret_cast<const char *>(tmp_string.data()), tmp_string.size()));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
+            if constexpr (is_binary)
+            {
+                auto value = reader.as<capnp::Data>();
+                if (value.size() > fixed_string_column.getN())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
+
+                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+            else
+            {
+                auto value = reader.as<capnp::Text>();
+                if (value.size() > fixed_string_column.getN())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
+
+                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+        }
+
+    private:
+        String tmp_string;
+        capnp::Type capnp_type;
+    };
+
+    class CapnProtoIPv4Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoIPv4Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isUInt32())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            return capnp::DynamicValue::Reader(assert_cast<const ColumnIPv4 &>(*column).getElement(row_num).toUnderType());
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(reader.as<UInt32>()));
+        }
+    };
+
+    class CapnProtoIPv6Serializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoIPv6Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(IPv6))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of IPv6 value: {}", value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+    };
+
+    class CapnProtoUUIDSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoUUIDSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto value = reader.as<capnp::Data>();
+            if (value.size() != sizeof(UUID))
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of UUID value: {}", value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+    };
+
+    std::unique_ptr<ICapnProtoSerializer> createSerializer(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings);
+
+    class CapnProtoLowCardinalitySerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoLowCardinalitySerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            nested_serializer = createSerializer(assert_cast<const DataTypeLowCardinality &>(*data_type).getDictionaryType(), column_name, capnp_type, settings);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
+            size_t index = low_cardinality_column.getIndexAt(row_num);
+            const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
+            return nested_serializer->writeRow(dict_column, field_builder, index);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
+            auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
+            nested_serializer->readRow(*tmp_column, reader);
+            low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+    };
+
+    class CapnProtoNullableSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoNullableSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            if (!capnp_type.isStruct())
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type, got CapnProto type {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            /// Check that struct is a named union of type VOID and one arbitrary type.
+            auto struct_schema = capnp_type.asStruct();
+            if (!checkIfStructIsNamedUnion(struct_schema))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type."
+                    "Given CapnProto struct is not a named union: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            auto union_fields = struct_schema.getUnionFields();
+            if (union_fields.size() != 2)
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type."
+                    "Given CapnProto union have more than 2 fields: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            auto first = union_fields[0];
+            auto second = union_fields[1];
+            auto nested_type = assert_cast<const DataTypeNullable *>(data_type.get())->getNestedType();
+            if (first.getType().isVoid())
+            {
+                null_field = first;
+                nested_field = second;
+                nested_capnp_type = second.getType();
+                if (nested_capnp_type.isStruct())
+                    nested_fields_size = nested_capnp_type.asStruct().getFields().size();
+                nested_serializer = createSerializer(nested_type, column_name, nested_capnp_type, settings);
+            }
+            else if (second.getType().isVoid())
+            {
+                null_field = second;
+                nested_field = first;
+                nested_capnp_type = first.getType();
+                if (nested_capnp_type.isStruct())
+                    nested_fields_size = nested_capnp_type.asStruct().getFields().size();
+                nested_serializer = createSerializer(nested_type, column_name, nested_capnp_type, settings);
+            }
+            else
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert column \"{}\": Nullable can be represented only as a named union of type Void and nested type."
+                    "Given CapnProto union doesn't have field with type Void: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            assert(field_builder);
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            const auto & nullable_column = assert_cast<const ColumnNullable &>(*column);
+            if (nullable_column.isNullAt(row_num))
+            {
+                struct_builder.impl.set(null_field, capnp::Void());
+            }
+            else
+            {
+                struct_builder.impl.clear(nested_field);
+                const auto & nested_column = nullable_column.getNestedColumnPtr();
+                auto nested_field_builder = initStructFieldBuilderIfNeeded(nested_column, row_num, struct_builder.impl, nested_field, nested_capnp_type, nested_fields_size);
+                auto value = nested_serializer->writeRow(nested_column, nested_field_builder.get(), row_num);
+                if (value)
+                    struct_builder.impl.set(nested_field, *value);
+            }
+
+            return std::nullopt;
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            auto & nullable_column = assert_cast<ColumnNullable &>(column);
+            auto field = *kj::_::readMaybe(struct_reader.which());
+            if (field.getType().isVoid())
+                nullable_column.insertDefault();
+            else
+            {
+                auto & nested_column = nullable_column.getNestedColumn();
+                auto nested_reader = struct_reader.get(field);
+                nested_serializer->readRow(nested_column, nested_reader);
+                nullable_column.getNullMapData().push_back(0);
+            }
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+        capnp::StructSchema::Field null_field;
+        capnp::StructSchema::Field nested_field;
+        size_t nested_fields_size = 0;
+        capnp::Type nested_capnp_type;
+    };
+
+    class CapnProtoArraySerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoArraySerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            if (!capnp_type.isList())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            auto nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
+            element_type = capnp_type.asList().getElementType();
+            if (element_type.isStruct())
+                element_struct_fields = element_type.asStruct().getFields().size();
+            nested_serializer = createSerializer(nested_type, column_name, capnp_type.asList().getElementType(), settings);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            assert(field_builder);
+            auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
+            const auto * array_column = assert_cast<const ColumnArray *>(column.get());
+            const auto & nested_column = array_column->getDataPtr();
+            const auto & offsets = array_column->getOffsets();
+            auto offset = offsets[row_num - 1];
+            size_t size = offsets[row_num] - offset;
+            bool need_nested_builders = list_builder.nested_builders.empty();
+            for (unsigned i = 0; i != static_cast<unsigned>(size); ++i)
+            {
+                if (need_nested_builders)
+                {
+                    /// For nested lists we need to initialize nested list builder.
+                    if (element_type.isList())
+                    {
+                        const auto & nested_offset = checkAndGetColumn<ColumnArray>(*nested_column)->getOffsets();
+                        size_t nested_array_size = nested_offset[offset + i] - nested_offset[offset + i - 1];
+                        list_builder.nested_builders.emplace_back(std::make_unique<ListBuilder>(list_builder.impl.init(i, static_cast<unsigned>(nested_array_size))));
+                    }
+                    else if (element_type.isStruct())
+                    {
+                        list_builder.nested_builders.emplace_back(std::make_unique<StructBuilder>(list_builder.impl[i], element_struct_fields));
+                    }
+                    else
+                    {
+                        list_builder.nested_builders.emplace_back();
+                    }
+                }
+
+                auto value = nested_serializer->writeRow(nested_column, list_builder.nested_builders[i].get(), offset + i);
+                if (value)
+                    list_builder.impl.set(i, *value);
+            }
+
+            return std::nullopt;
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto list_reader = reader.as<capnp::DynamicList>();
+            auto & column_array = assert_cast<ColumnArray &>(column);
+            auto & offsets = column_array.getOffsets();
+            offsets.push_back(offsets.back() + list_reader.size());
+
+            auto & nested_column = column_array.getData();
+            for (const auto & nested_reader : list_reader)
+                nested_serializer->readRow(nested_column, nested_reader);
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+        capnp::Type element_type;
+        size_t element_struct_fields;
+    };
+
+    class CapnProtoMapSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoMapSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            /// We output/input Map type as follow CapnProto schema
+            ///
+            /// struct Map {
+            ///     struct Entry {
+            ///         key @0: Key;
+            ///         value @1: Value;
+            ///     }
+            ///     entries @0 :List(Entry);
+            /// }
+
+            if (!capnp_type.isStruct())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            auto struct_schema = capnp_type.asStruct();
+
+            if (checkIfStructContainsUnnamedUnion(struct_schema))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto Struct with unnamed union {}",
+                    column_name,
+                    data_type->getName(),
+                    getCapnProtoFullTypeName(capnp_type));
+
+            if (struct_schema.getFields().size() != 1)
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": Map type can be represented as a Struct with one list field, got struct: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(capnp_type));
+
+            const auto & field_type = struct_schema.getFields()[0].getType();
+            if (!field_type.isList())
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": Map type can be represented as a Struct with one list field, got field: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(field_type));
+
+            auto list_element_type = field_type.asList().getElementType();
+            if (!list_element_type.isStruct())
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": Field of struct that represents Map should be a list of structs, got list of {}",
+                    column_name,
+                    getCapnProtoFullTypeName(list_element_type));
+
+            auto key_value_struct = list_element_type.asStruct();
+            if (checkIfStructContainsUnnamedUnion(key_value_struct))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": struct that represents Map entries is unnamed union: {}",
+                    column_name,
+                    getCapnProtoFullTypeName(list_element_type));
+
+            if (key_value_struct.getFields().size() != 2)
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\": struct that represents Map entries should contain only 2 fields, got struct {}",
+                    column_name,
+                    getCapnProtoFullTypeName(list_element_type));
+
+            const auto & map_type = assert_cast<const DataTypeMap &>(*data_type);
+            DataTypes types = {map_type.getKeyType(), map_type.getValueType()};
+            Names names = {"key", "value"};
+            auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(types, names));
+            entries_field = struct_schema.getFields()[0];
+            entries_capnp_type = entries_field.getType();
+            nested_serializer = createSerializer(entries_type, column_name, field_type, settings);
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        {
+            assert(field_builder);
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
+            auto entries_builder = initStructFieldBuilderIfNeeded(entries_column, row_num, struct_builder.impl, entries_field, entries_capnp_type, 0);
+            nested_serializer->writeRow(entries_column, entries_builder.get(), row_num);
+            return std::nullopt;
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
+            nested_serializer->readRow(entries_column, struct_reader.get(entries_field));
+        }
+
+    private:
+        std::unique_ptr<ICapnProtoSerializer> nested_serializer;
+        capnp::StructSchema::Field entries_field;
+        capnp::Type entries_capnp_type;
+    };
+
+    class CapnProtoStructureSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoStructureSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        {
+            if (checkIfStructIsNamedUnion(schema) || checkIfStructContainsUnnamedUnion(schema))
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Root CapnProto Struct cannot be named union/struct with unnamed union");
+
+            initialize(data_types, names, schema, settings);
+        }
+
+        CapnProtoStructureSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+        {
+            if (!capnp_type.isStruct())
+                throwCannotConvert(data_type, column_name, capnp_type);
+
+            auto struct_schema = capnp_type.asStruct();
+
+            if (checkIfStructIsNamedUnion(struct_schema) || checkIfStructContainsUnnamedUnion(struct_schema))
+                throw Exception(
+                    ErrorCodes::CAPN_PROTO_BAD_CAST,
+                    "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto named union/struct with unnamed union {}",
+                    column_name,
+                    data_type->getName(),
+                    getCapnProtoFullTypeName(capnp_type));
+
+            const auto * tuple_data_type = assert_cast<const DataTypeTuple *>(data_type.get());
+            auto nested_types = tuple_data_type->getElements();
+            Names nested_names;
+            bool have_explicit_names = tuple_data_type->haveExplicitNames();
+            auto structure_fields = struct_schema.getFields();
+            if (!have_explicit_names)
+            {
+                if (nested_types.size() != structure_fields.size())
+                    throw Exception(
+                        ErrorCodes::CAPN_PROTO_BAD_CAST,
+                        "Cannot convert ClickHouse column \"{}\" with type {} to CapnProto type {}: Tuple and Struct have different sizes {} != {}",
+                        column_name,
+                        data_type->getName(),
+                        getCapnProtoFullTypeName(capnp_type),
+                        nested_types.size(),
+                        structure_fields.size());
+                nested_names.reserve(structure_fields.size());
+                for (auto field : structure_fields)
+                    nested_names.push_back(field.getProto().getName());
+            }
+            else
+            {
+                nested_names = tuple_data_type->getElementNames();
+            }
+
+            try
+            {
+                initialize(nested_types, nested_names, struct_schema, settings);
+            }
+            catch (Exception & e)
+            {
+                e.addMessage("(while converting column {})", column_name);
+                throw e;
+            }
+        }
+
+        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * builder, size_t row_num) override
+        {
+            assert(builder);
+            auto & struct_builder = assert_cast<StructBuilder &>(*builder);
+            if (auto tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+                writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
+            else
+                writeRow(Columns{column}, struct_builder, row_num);
+            return std::nullopt;
+        }
+
+        void writeRow(const Columns & columns, StructBuilder & struct_builder, size_t row_num)
+        {
+            for (size_t i = 0; i != columns.size(); ++i)
+            {
+                const auto & field = fields[i];
+                size_t field_index = field.getIndex();
+                if (likely(!struct_builder.field_builders[field_index]))
+                    struct_builder.field_builders[field_index] = initStructFieldBuilderIfNeeded(
+                        columns[i], row_num, struct_builder.impl, field, fields_types[i], nested_field_sizes[i]);
+
+                auto value = field_serializers[i]->writeRow(columns[i], struct_builder.field_builders[field_index].get(), row_num);
+                if (value)
+                    struct_builder.impl.set(field, *value);
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        {
+            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
+            {
+                for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
+                    field_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader.get(fields[i]));
+            }
+            else
+                field_serializers[0]->readRow(column, struct_reader.get(fields[0]));
+        }
+
+        void readRow(MutableColumns & columns, const capnp::DynamicStruct::Reader & reader)
+        {
+            for (size_t i = 0; i != columns.size(); ++i)
+                field_serializers[i]->readRow(*columns[i], reader.get(fields[i]));
+        }
+
+    private:
+        void initialize(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        {
+            field_serializers.reserve(data_types.size());
+            fields.reserve(data_types.size());
+            fields_types.reserve(data_types.size());
+            nested_field_sizes.reserve(data_types.size());
+            for (size_t i = 0; i != data_types.size(); ++i)
+            {
+                auto [field_name, _] = splitFieldName(names[i]);
+                auto field = findFieldByName(schema, field_name);
+                if (!field)
+                    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto schema doesn't contain field with name {}", field_name);
+
+                fields.push_back(*field);
+                auto capnp_type = field->getType();
+                fields_types.push_back(capnp_type);
+                nested_field_sizes.push_back(capnp_type.isStruct() ? capnp_type.asStruct().getFields().size() : 0);
+                field_serializers.push_back(createSerializer(data_types[i], names[i], capnp_type, settings));
+            }
+        }
+
+        std::vector<std::unique_ptr<ICapnProtoSerializer>> field_serializers;
+        std::vector<capnp::StructSchema::Field> fields;
+        std::vector<size_t> nested_field_sizes;
+        std::vector<capnp::Type> fields_types;
+    };
+
+    std::unique_ptr<ICapnProtoSerializer> createSerializer(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
+    {
+        auto [field_name, nested_name] = splitFieldName(name);
+        if (!nested_name.empty() && !capnp_type.isList())
+        {
+            if (!capnp_type.isStruct())
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
+
+            return std::make_unique<CapnProtoStructureSerializer>(DataTypes{type}, Names{nested_name}, capnp_type.asStruct(), settings);
+        }
+
+        switch (type->getTypeId())
+        {
+            case TypeIndex::Int8:
+                return createIntegerSerializer<Int8>(type, name, capnp_type);
+            case TypeIndex::UInt8:
+                if (isBool(type))
+                    return createIntegerSerializer<UInt8, true>(type, name, capnp_type);
+                return createIntegerSerializer<UInt8>(type, name, capnp_type);
+            case TypeIndex::Int16:
+                return createIntegerSerializer<Int16>(type, name, capnp_type);
+            case TypeIndex::UInt16:
+                return createIntegerSerializer<UInt16>(type, name, capnp_type);
+            case TypeIndex::Int32:
+                return createIntegerSerializer<Int32>(type, name, capnp_type);
+            case TypeIndex::UInt32:
+                return createIntegerSerializer<UInt32>(type, name, capnp_type);
+            case TypeIndex::Int64:
+                return createIntegerSerializer<Int64>(type, name, capnp_type);
+            case TypeIndex::UInt64:
+                return createIntegerSerializer<UInt64>(type, name, capnp_type);
+            case TypeIndex::Int128:
+                return std::make_unique<CapnProtoBigIntegerSerializer<Int128>>(type, name, capnp_type);
+            case TypeIndex::UInt128:
+                return std::make_unique<CapnProtoBigIntegerSerializer<UInt128>>(type, name, capnp_type);
+            case TypeIndex::Int256:
+                return std::make_unique<CapnProtoBigIntegerSerializer<Int256>>(type, name, capnp_type);
+            case TypeIndex::UInt256:
+                return std::make_unique<CapnProtoBigIntegerSerializer<UInt256>>(type, name, capnp_type);
+            case TypeIndex::Float32:
+                return std::make_unique<CapnProtoFloatSerializer<Float32>>(type, name, capnp_type);
+            case TypeIndex::Float64:
+                return std::make_unique<CapnProtoFloatSerializer<Float64>>(type, name, capnp_type);
+            case TypeIndex::Date:
+                return std::make_unique<CapnProtoDateSerializer>(type, name, capnp_type);
+            case TypeIndex::Date32:
+                return std::make_unique<CapnProtoDate32Serializer>(type, name, capnp_type);
+            case TypeIndex::DateTime:
+                return std::make_unique<CapnProtoDateTimeSerializer>(type, name, capnp_type);
+            case TypeIndex::DateTime64:
+                return std::make_unique<CapnProtoDateTime64Serializer>(type, name, capnp_type);
+            case TypeIndex::Decimal32:
+                return std::make_unique<CapnProtoDecimalSerializer<Decimal32>>(type, name, capnp_type);
+            case TypeIndex::Decimal64:
+                return std::make_unique<CapnProtoDecimalSerializer<Decimal64>>(type, name, capnp_type);
+            case TypeIndex::Decimal128:
+                return std::make_unique<CapnProtoBigDecimalSerializer<Decimal128>>(type, name, capnp_type);
+            case TypeIndex::Decimal256:
+                return std::make_unique<CapnProtoBigDecimalSerializer<Decimal256>>(type, name, capnp_type);
+            case TypeIndex::IPv4:
+                return std::make_unique<CapnProtoIPv4Serializer>(type, name, capnp_type);
+            case TypeIndex::IPv6:
+                return std::make_unique<CapnProtoIPv6Serializer>(type, name, capnp_type);
+            case TypeIndex::UUID:
+                return std::make_unique<CapnProtoUUIDSerializer>(type, name, capnp_type);
+            case TypeIndex::Enum8:
+                return std::make_unique<CapnProtoEnumSerializer<Int8>>(type, name, capnp_type, settings.enum_comparing_mode);
+            case TypeIndex::Enum16:
+                return std::make_unique<CapnProtoEnumSerializer<Int16>>(type, name, capnp_type, settings.enum_comparing_mode);
+            case TypeIndex::String:
+                if (capnp_type.isData())
+                    return std::make_unique<CapnProtoStringSerializer<true>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoStringSerializer<false>>(type, name, capnp_type);
+            case TypeIndex::FixedString:
+                if (capnp_type.isData())
+                    return std::make_unique<CapnProtoFixedStringSerializer<true>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedStringSerializer<false>>(type, name, capnp_type);
+            case TypeIndex::LowCardinality:
+                return std::make_unique<CapnProtoLowCardinalitySerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Nullable:
+                return std::make_unique<CapnProtoNullableSerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Array:
+                return std::make_unique<CapnProtoArraySerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Map:
+                return std::make_unique<CapnProtoMapSerializer>(type, name, capnp_type, settings);
+            case TypeIndex::Tuple:
+                return std::make_unique<CapnProtoStructureSerializer>(type, name, capnp_type, settings);
+            default:
+                throw Exception(ErrorCodes::ILLEGAL_COLUMN, "Type {} is not supported in CapnProto format", type->getName());
+        }
+    }
+}
+
+class CapnProtoSerializer::Impl
+{
+public:
+    Impl(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        : struct_serializer(std::make_unique<CapnProtoStructureSerializer>(data_types, names, schema, settings))
+        , fields_size(schema.getFields().size())
+    {
+    }
+
+    void writeRow(const Columns & columns, capnp::DynamicStruct::Builder builder, size_t row_num)
+    {
+        StructBuilder struct_builder(std::move(builder), fields_size);
+        struct_serializer->writeRow(columns, struct_builder, row_num);
+    }
+
+    void readRow(MutableColumns & columns, capnp::DynamicStruct::Reader & reader)
+    {
+        struct_serializer->readRow(columns, reader);
+    }
+
+private:
+    std::unique_ptr<CapnProtoStructureSerializer> struct_serializer;
+    size_t fields_size;
+};
+
+CapnProtoSerializer::CapnProtoSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+    : serializer_impl(std::make_unique<Impl>(data_types, names, schema, settings))
+{
+}
+
+void CapnProtoSerializer::writeRow(const Columns & columns, capnp::DynamicStruct::Builder builder, size_t row_num)
+{
+    serializer_impl->writeRow(columns, std::move(builder), row_num);
+}
+
+void CapnProtoSerializer::readRow(MutableColumns & columns, capnp::DynamicStruct::Reader & reader)
+{
+    serializer_impl->readRow(columns, reader);
+}
+
+CapnProtoSerializer::~CapnProtoSerializer() = default;
+
+}
diff --git a/src/Formats/CapnProtoSerializer.h b/src/Formats/CapnProtoSerializer.h
new file mode 100644
index 00000000000..efae797875b
--- /dev/null
+++ b/src/Formats/CapnProtoSerializer.h
@@ -0,0 +1,25 @@
+#pragma once
+
+#include <Core/Block.h>
+#include <capnp/dynamic.h>
+
+namespace DB
+{
+
+class CapnProtoSerializer
+{
+public:
+    CapnProtoSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings);
+
+    void writeRow(const Columns & columns, capnp::DynamicStruct::Builder builder, size_t row_num);
+
+    void readRow(MutableColumns & columns, capnp::DynamicStruct::Reader & reader);
+
+    ~CapnProtoSerializer();
+
+private:
+    class Impl;
+    std::unique_ptr<Impl> serializer_impl;
+};
+
+}
diff --git a/src/Formats/CapnProtoUtils.cpp b/src/Formats/CapnProtoUtils.cpp
deleted file mode 100644
index d6c032408bb..00000000000
--- a/src/Formats/CapnProtoUtils.cpp
+++ /dev/null
@@ -1,734 +0,0 @@
-#include <Formats/CapnProtoUtils.h>
-
-#if USE_CAPNP
-
-#include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeEnum.h>
-#include <DataTypes/DataTypeLowCardinality.h>
-#include <DataTypes/DataTypeNullable.h>
-#include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypesNumber.h>
-#include <DataTypes/DataTypeString.h>
-#include <DataTypes/DataTypeMap.h>
-#include <DataTypes/IDataType.h>
-#include <boost/algorithm/string.hpp>
-#include <boost/algorithm/string/join.hpp>
-#include <capnp/schema.h>
-#include <capnp/schema-parser.h>
-#include <fcntl.h>
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int CANNOT_PARSE_CAPN_PROTO_SCHEMA;
-    extern const int THERE_IS_NO_COLUMN;
-    extern const int BAD_TYPE_OF_FIELD;
-    extern const int CAPN_PROTO_BAD_CAST;
-    extern const int FILE_DOESNT_EXIST;
-    extern const int UNKNOWN_EXCEPTION;
-    extern const int INCORRECT_DATA;
-    extern const int CAPN_PROTO_BAD_TYPE;
-    extern const int BAD_ARGUMENTS;
-}
-
-std::pair<String, String> splitCapnProtoFieldName(const String & name)
-{
-    const auto * begin = name.data();
-    const auto * end = name.data() + name.size();
-    const auto * it = find_first_symbols<'_', '.'>(begin, end);
-    String first = String(begin, it);
-    String second = it == end ? "" : String(it + 1, end);
-    return {first, second};
-}
-
-capnp::StructSchema CapnProtoSchemaParser::getMessageSchema(const FormatSchemaInfo & schema_info)
-{
-    capnp::ParsedSchema schema;
-    try
-    {
-        int fd;
-        KJ_SYSCALL(fd = open(schema_info.schemaDirectory().data(), O_RDONLY)); // NOLINT(bugprone-suspicious-semicolon)
-        auto schema_dir = kj::newDiskDirectory(kj::OsFileHandle(fd));
-        schema = impl.parseFromDirectory(*schema_dir, kj::Path::parse(schema_info.schemaPath()), {});
-    }
-    catch (const kj::Exception & e)
-    {
-        /// That's not good to determine the type of error by its description, but
-        /// this is the only way to do it here, because kj doesn't specify the type of error.
-        auto description = std::string_view(e.getDescription().cStr());
-        if (description.find("No such file or directory") != String::npos || description.find("no such directory") != String::npos)
-            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot open CapnProto schema, file {} doesn't exists", schema_info.absoluteSchemaPath());
-
-        if (description.find("Parse error") != String::npos)
-            throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA, "Cannot parse CapnProto schema {}:{}", schema_info.schemaPath(), e.getLine());
-
-        throw Exception(ErrorCodes::UNKNOWN_EXCEPTION,
-                        "Unknown exception while parsing CapnProto schema: {}, schema dir and file: {}, {}",
-                        description, schema_info.schemaDirectory(), schema_info.schemaPath());
-    }
-
-    auto message_maybe = schema.findNested(schema_info.messageName());
-    auto * message_schema = kj::_::readMaybe(message_maybe);
-    if (!message_schema)
-        throw Exception(ErrorCodes::CANNOT_PARSE_CAPN_PROTO_SCHEMA,
-                        "CapnProto schema doesn't contain message with name {}", schema_info.messageName());
-    return message_schema->asStruct();
-}
-
-bool compareEnumNames(const String & first, const String & second, FormatSettings::EnumComparingMode mode)
-{
-    if (mode == FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE)
-        return boost::algorithm::to_lower_copy(first) == boost::algorithm::to_lower_copy(second);
-    return first == second;
-}
-
-static const std::map<capnp::schema::Type::Which, String> capnp_simple_type_names =
-{
-        {capnp::schema::Type::Which::BOOL, "Bool"},
-        {capnp::schema::Type::Which::VOID, "Void"},
-        {capnp::schema::Type::Which::INT8, "Int8"},
-        {capnp::schema::Type::Which::INT16, "Int16"},
-        {capnp::schema::Type::Which::INT32, "Int32"},
-        {capnp::schema::Type::Which::INT64, "Int64"},
-        {capnp::schema::Type::Which::UINT8, "UInt8"},
-        {capnp::schema::Type::Which::UINT16, "UInt16"},
-        {capnp::schema::Type::Which::UINT32, "UInt32"},
-        {capnp::schema::Type::Which::UINT64, "UInt64"},
-        {capnp::schema::Type::Which::FLOAT32, "Float32"},
-        {capnp::schema::Type::Which::FLOAT64, "Float64"},
-        {capnp::schema::Type::Which::TEXT, "Text"},
-        {capnp::schema::Type::Which::DATA, "Data"},
-        {capnp::schema::Type::Which::INTERFACE, "Interface"},
-        {capnp::schema::Type::Which::ANY_POINTER, "AnyPointer"},
-};
-
-static bool checkIfStructContainsUnnamedUnion(const capnp::StructSchema & struct_schema)
-{
-    return struct_schema.getFields().size() != struct_schema.getNonUnionFields().size();
-}
-
-static bool checkIfStructIsNamedUnion(const capnp::StructSchema & struct_schema)
-{
-    return struct_schema.getFields().size() == struct_schema.getUnionFields().size();
-}
-
-/// Get full name of type for better exception messages.
-static String getCapnProtoFullTypeName(const capnp::Type & type)
-{
-    switch (type.which())
-    {
-        case capnp::schema::Type::Which::STRUCT:
-        {
-            auto struct_schema = type.asStruct();
-
-            auto non_union_fields = struct_schema.getNonUnionFields();
-            std::vector<String> non_union_field_names;
-            for (auto nested_field : non_union_fields)
-                non_union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
-
-            auto union_fields = struct_schema.getUnionFields();
-            std::vector<String> union_field_names;
-            for (auto nested_field : union_fields)
-                union_field_names.push_back(String(nested_field.getProto().getName()) + " " + getCapnProtoFullTypeName(nested_field.getType()));
-
-            String union_name = "Union(" + boost::algorithm::join(union_field_names, ", ") + ")";
-            /// Check if the struct is a named union.
-            if (non_union_field_names.empty())
-                return union_name;
-
-            String type_name = "Struct(" + boost::algorithm::join(non_union_field_names, ", ");
-            /// Check if the struct contains unnamed union.
-            if (!union_field_names.empty())
-                type_name += ", " + union_name;
-            type_name += ")";
-            return type_name;
-        }
-        case capnp::schema::Type::Which::LIST:
-            return "List(" + getCapnProtoFullTypeName(type.asList().getElementType()) + ")";
-        case capnp::schema::Type::Which::ENUM:
-        {
-            auto enum_schema = type.asEnum();
-            String enum_name = "Enum(";
-            auto enumerants = enum_schema.getEnumerants();
-            for (unsigned i = 0; i != enumerants.size(); ++i)
-            {
-                enum_name += String(enumerants[i].getProto().getName()) + " = " + std::to_string(enumerants[i].getOrdinal());
-                if (i + 1 != enumerants.size())
-                    enum_name += ", ";
-            }
-            enum_name += ")";
-            return enum_name;
-        }
-        default:
-            auto it = capnp_simple_type_names.find(type.which());
-            if (it == capnp_simple_type_names.end())
-                throw Exception(ErrorCodes::BAD_TYPE_OF_FIELD, "Unknown CapnProto type");
-            return it->second;
-    }
-}
-
-template <typename Type>
-static bool checkEnums(const capnp::Type & capnp_type, const DataTypePtr column_type, FormatSettings::EnumComparingMode mode, UInt64 max_value, String & error_message)
-{
-    if (!capnp_type.isEnum())
-        return false;
-
-    auto enum_schema = capnp_type.asEnum();
-    bool to_lower = mode == FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE;
-    const auto * enum_type = assert_cast<const DataTypeEnum<Type> *>(column_type.get());
-    const auto & enum_values = dynamic_cast<const EnumValues<Type> &>(*enum_type);
-
-    auto enumerants = enum_schema.getEnumerants();
-    if (mode == FormatSettings::EnumComparingMode::BY_VALUES)
-    {
-        /// In CapnProto Enum fields are numbered sequentially starting from zero.
-        if (enumerants.size() > max_value)
-        {
-            error_message += "Enum from CapnProto schema contains values that is out of range for Clickhouse Enum";
-            return false;
-        }
-
-        auto values = enum_values.getSetOfAllValues();
-        std::unordered_set<Type> capn_enum_values;
-        for (auto enumerant : enumerants)
-            capn_enum_values.insert(Type(enumerant.getOrdinal()));
-        auto result = values == capn_enum_values;
-        if (!result)
-            error_message += "The set of values in Enum from CapnProto schema is different from the set of values in ClickHouse Enum";
-        return result;
-    }
-
-    auto names = enum_values.getSetOfAllNames(to_lower);
-    std::unordered_set<String> capn_enum_names;
-
-    for (auto enumerant : enumerants)
-    {
-        String name = enumerant.getProto().getName();
-        capn_enum_names.insert(to_lower ? boost::algorithm::to_lower_copy(name) : name);
-    }
-
-    auto result = names == capn_enum_names;
-    if (!result)
-        error_message += "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum";
-    return result;
-}
-
-static bool checkCapnProtoType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name);
-
-static bool checkNullableType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name)
-{
-    if (!capnp_type.isStruct())
-        return false;
-
-    /// Check that struct is a named union of type VOID and one arbitrary type.
-    auto struct_schema = capnp_type.asStruct();
-    if (!checkIfStructIsNamedUnion(struct_schema))
-        return false;
-
-    auto union_fields = struct_schema.getUnionFields();
-    if (union_fields.size() != 2)
-        return false;
-
-    auto first = union_fields[0];
-    auto second = union_fields[1];
-
-    auto nested_type = assert_cast<const DataTypeNullable *>(data_type.get())->getNestedType();
-    if (first.getType().isVoid())
-        return checkCapnProtoType(second.getType(), nested_type, mode, error_message, column_name);
-    if (second.getType().isVoid())
-        return checkCapnProtoType(first.getType(), nested_type, mode, error_message, column_name);
-    return false;
-}
-
-static bool checkTupleType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message)
-{
-    if (!capnp_type.isStruct())
-        return false;
-    auto struct_schema = capnp_type.asStruct();
-
-    if (checkIfStructIsNamedUnion(struct_schema))
-        return false;
-
-    if (checkIfStructContainsUnnamedUnion(struct_schema))
-    {
-        error_message += "CapnProto struct contains unnamed union";
-        return false;
-    }
-
-    const auto * tuple_data_type = assert_cast<const DataTypeTuple *>(data_type.get());
-    auto nested_types = tuple_data_type->getElements();
-    if (nested_types.size() != struct_schema.getFields().size())
-    {
-        error_message += "Tuple and Struct types have different sizes";
-        return false;
-    }
-
-    bool have_explicit_names = tuple_data_type->haveExplicitNames();
-    const auto & nested_names = tuple_data_type->getElementNames();
-    for (uint32_t i = 0; i != nested_names.size(); ++i)
-    {
-        if (have_explicit_names)
-        {
-            KJ_IF_MAYBE (field, struct_schema.findFieldByName(nested_names[i]))
-            {
-                if (!checkCapnProtoType(field->getType(), nested_types[tuple_data_type->getPositionByName(nested_names[i])], mode, error_message, nested_names[i]))
-                    return false;
-            }
-            else
-            {
-                error_message += "CapnProto struct doesn't contain a field with name " + nested_names[i];
-                return false;
-            }
-        }
-        else if (!checkCapnProtoType(struct_schema.getFields()[i].getType(), nested_types[tuple_data_type->getPositionByName(nested_names[i])], mode, error_message, nested_names[i]))
-            return false;
-    }
-
-    return true;
-}
-
-static bool checkArrayType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name)
-{
-    if (!capnp_type.isList())
-        return false;
-    auto list_schema = capnp_type.asList();
-    auto nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
-
-    auto [field_name, nested_name] = splitCapnProtoFieldName(column_name);
-    if (!nested_name.empty() && list_schema.getElementType().isStruct())
-    {
-        auto struct_schema = list_schema.getElementType().asStruct();
-        KJ_IF_MAYBE(field, struct_schema.findFieldByName(nested_name))
-            return checkCapnProtoType(field->getType(), nested_type, mode, error_message, nested_name);
-
-        error_message += "Element type of List {} doesn't contain field with name " + nested_name;
-        return false;
-    }
-
-    return checkCapnProtoType(list_schema.getElementType(), nested_type, mode, error_message, column_name);
-}
-
-static bool checkMapType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message)
-{
-    /// We output/input Map type as follow CapnProto schema
-    ///
-    /// struct Map {
-    ///     struct Entry {
-    ///         key @0: Key;
-    ///         value @1: Value;
-    ///     }
-    ///     entries @0 :List(Entry);
-    /// }
-
-    if (!capnp_type.isStruct())
-        return false;
-    auto struct_schema = capnp_type.asStruct();
-
-    if (checkIfStructContainsUnnamedUnion(struct_schema))
-    {
-        error_message += "CapnProto struct contains unnamed union";
-        return false;
-    }
-
-    if (struct_schema.getFields().size() != 1)
-    {
-        error_message += "CapnProto struct that represents Map type can contain only one field";
-        return false;
-    }
-
-    const auto & field_type = struct_schema.getFields()[0].getType();
-    if (!field_type.isList())
-    {
-        error_message += "Field of CapnProto struct that represents Map is not a list";
-        return false;
-    }
-
-    auto list_element_type = field_type.asList().getElementType();
-    if (!list_element_type.isStruct())
-    {
-        error_message += "Field of CapnProto struct that represents Map is not a list of structs";
-        return false;
-    }
-
-    auto key_value_struct = list_element_type.asStruct();
-    if (checkIfStructContainsUnnamedUnion(key_value_struct))
-    {
-        error_message += "CapnProto struct contains unnamed union";
-        return false;
-    }
-
-    if (key_value_struct.getFields().size() != 2)
-    {
-        error_message += "Key-value structure for Map struct should have exactly 2 fields";
-        return false;
-    }
-
-    const auto & map_type = assert_cast<const DataTypeMap &>(*data_type);
-    DataTypes types = {map_type.getKeyType(), map_type.getValueType()};
-    Names names = {"key", "value"};
-
-    for (size_t i = 0; i != types.size(); ++i)
-    {
-        KJ_IF_MAYBE(field, key_value_struct.findFieldByName(names[i]))
-        {
-            if (!checkCapnProtoType(field->getType(), types[i], mode, error_message, names[i]))
-                return false;
-        }
-        else
-        {
-            error_message += R"(Key-value structure for Map struct should have exactly 2 fields with names "key" and "value")";
-            return false;
-        }
-    }
-
-    return true;
-}
-
-static bool isCapnInteger(const capnp::Type & capnp_type)
-{
-    return capnp_type.isInt8() || capnp_type.isUInt8() || capnp_type.isInt16() || capnp_type.isUInt16() || capnp_type.isInt32()
-        || capnp_type.isUInt32() || capnp_type.isInt64() || capnp_type.isUInt64();
-}
-
-static bool checkCapnProtoType(const capnp::Type & capnp_type, const DataTypePtr & data_type, FormatSettings::EnumComparingMode mode, String & error_message, const String & column_name)
-{
-    switch (data_type->getTypeId())
-    {
-        case TypeIndex::UInt8:
-            return capnp_type.isBool() || isCapnInteger(capnp_type);
-        case TypeIndex::Int8: [[fallthrough]];
-        case TypeIndex::Int16: [[fallthrough]];
-        case TypeIndex::UInt16: [[fallthrough]];
-        case TypeIndex::Int32: [[fallthrough]];
-        case TypeIndex::UInt32: [[fallthrough]];
-        case TypeIndex::Int64: [[fallthrough]];
-        case TypeIndex::UInt64:
-            /// Allow integer conversions durin input/output.
-            return isCapnInteger(capnp_type);
-        case TypeIndex::Date:
-            return capnp_type.isUInt16();
-        case TypeIndex::DateTime: [[fallthrough]];
-        case TypeIndex::IPv4:
-            return capnp_type.isUInt32();
-        case TypeIndex::Date32: [[fallthrough]];
-        case TypeIndex::Decimal32:
-            return capnp_type.isInt32() || capnp_type.isUInt32();
-        case TypeIndex::DateTime64: [[fallthrough]];
-        case TypeIndex::Decimal64:
-            return capnp_type.isInt64() || capnp_type.isUInt64();
-        case TypeIndex::Float32:[[fallthrough]];
-        case TypeIndex::Float64:
-            /// Allow converting between Float32 and isFloat64
-            return capnp_type.isFloat32() || capnp_type.isFloat64();
-        case TypeIndex::Enum8:
-            return checkEnums<Int8>(capnp_type, data_type, mode, INT8_MAX, error_message);
-        case TypeIndex::Enum16:
-            return checkEnums<Int16>(capnp_type, data_type, mode, INT16_MAX, error_message);
-        case TypeIndex::Int128: [[fallthrough]];
-        case TypeIndex::UInt128: [[fallthrough]];
-        case TypeIndex::Int256: [[fallthrough]];
-        case TypeIndex::UInt256: [[fallthrough]];
-        case TypeIndex::Decimal128: [[fallthrough]];
-        case TypeIndex::Decimal256:
-            return capnp_type.isData();
-        case TypeIndex::Tuple:
-            return checkTupleType(capnp_type, data_type, mode, error_message);
-        case TypeIndex::Nullable:
-        {
-            auto result = checkNullableType(capnp_type, data_type, mode, error_message, column_name);
-            if (!result)
-                error_message += "Nullable can be represented only as a named union of type Void and nested type";
-            return result;
-        }
-        case TypeIndex::Array:
-            return checkArrayType(capnp_type, data_type, mode, error_message, column_name);
-        case TypeIndex::LowCardinality:
-            return checkCapnProtoType(capnp_type, assert_cast<const DataTypeLowCardinality *>(data_type.get())->getDictionaryType(), mode, error_message, column_name);
-        case TypeIndex::FixedString: [[fallthrough]];
-        case TypeIndex::IPv6: [[fallthrough]];
-        case TypeIndex::String:
-            return capnp_type.isText() || capnp_type.isData();
-        case TypeIndex::Map:
-            return checkMapType(capnp_type, data_type, mode, error_message);
-        default:
-            return false;
-    }
-}
-
-capnp::DynamicValue::Reader getReaderByColumnName(const capnp::DynamicStruct::Reader & struct_reader, const String & name)
-{
-    auto [field_name, nested_name] = splitCapnProtoFieldName(name);
-    KJ_IF_MAYBE(field, struct_reader.getSchema().findFieldByName(field_name))
-    {
-        capnp::DynamicValue::Reader field_reader;
-        try
-        {
-            field_reader = struct_reader.get(*field);
-        }
-        catch (const kj::Exception & e)
-        {
-            throw Exception(ErrorCodes::INCORRECT_DATA,
-                            "Cannot extract field value from struct by provided schema, error: "
-                            "{} Perhaps the data was generated by another schema", String(e.getDescription().cStr()));
-        }
-
-        if (nested_name.empty())
-            return field_reader;
-
-        /// Support reading Nested as List of Structs.
-        if (field_reader.getType() == capnp::DynamicValue::LIST)
-        {
-            auto list_schema = field->getType().asList();
-            if (!list_schema.getElementType().isStruct())
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Element type of List {} is not a struct", field_name);
-
-            auto struct_schema = list_schema.getElementType().asStruct();
-            KJ_IF_MAYBE(nested_field, struct_schema.findFieldByName(nested_name))
-                return field_reader;
-
-            throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Element type of List {} doesn't contain field with name \"{}\"", field_name, nested_name);
-        }
-
-        if (field_reader.getType() != capnp::DynamicValue::STRUCT)
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
-
-        return getReaderByColumnName(field_reader.as<capnp::DynamicStruct>(), nested_name);
-    }
-
-    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto struct doesn't contain field with name {}", field_name);
-}
-
-std::pair<capnp::DynamicStruct::Builder, capnp::StructSchema::Field> getStructBuilderAndFieldByColumnName(capnp::DynamicStruct::Builder struct_builder, const String & name)
-{
-    auto [field_name, nested_name] = splitCapnProtoFieldName(name);
-    KJ_IF_MAYBE(field, struct_builder.getSchema().findFieldByName(field_name))
-    {
-        if (nested_name.empty())
-            return {struct_builder, *field};
-
-        auto field_builder = struct_builder.get(*field);
-
-        /// Support reading Nested as List of Structs.
-        if (field_builder.getType() == capnp::DynamicValue::LIST)
-        {
-            auto list_schema = field->getType().asList();
-            if (!list_schema.getElementType().isStruct())
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Element type of List {} is not a struct", field_name);
-
-            auto struct_schema = list_schema.getElementType().asStruct();
-            KJ_IF_MAYBE(nested_field, struct_schema.findFieldByName(nested_name))
-                return {struct_builder, *field};
-
-            throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Element type of List {} doesn't contain field with name \"{}\"", field_name, nested_name);
-        }
-
-        if (field_builder.getType() != capnp::DynamicValue::STRUCT)
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
-
-        return getStructBuilderAndFieldByColumnName(field_builder.as<capnp::DynamicStruct>(), nested_name);
-    }
-
-    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto struct doesn't contain field with name {}", field_name);
-}
-
-static std::pair<capnp::StructSchema::Field, String> getFieldByName(const capnp::StructSchema & schema, const String & name)
-{
-    auto [field_name, nested_name] = splitCapnProtoFieldName(name);
-    KJ_IF_MAYBE(field, schema.findFieldByName(field_name))
-    {
-        if (nested_name.empty())
-            return {*field, name};
-
-        /// Support reading Nested as List of Structs.
-        if (field->getType().isList())
-        {
-            auto list_schema = field->getType().asList();
-            if (!list_schema.getElementType().isStruct())
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Element type of List {} is not a struct", field_name);
-
-            auto struct_schema = list_schema.getElementType().asStruct();
-            KJ_IF_MAYBE(nested_field, struct_schema.findFieldByName(nested_name))
-                return {*field, name};
-
-            throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Element type of List {} doesn't contain field with name \"{}\"", field_name, nested_name);
-        }
-
-        if (!field->getType().isStruct())
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Field {} is not a struct", field_name);
-
-        return getFieldByName(field->getType().asStruct(), nested_name);
-    }
-
-    throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto schema doesn't contain field with name {}", field_name);
-}
-
-void checkCapnProtoSchemaStructure(const capnp::StructSchema & schema, const Block & header, FormatSettings::EnumComparingMode mode)
-{
-    /// Firstly check that struct doesn't contain unnamed union, because we don't support it.
-    if (checkIfStructContainsUnnamedUnion(schema))
-        throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Schema contains unnamed union that is not supported");
-    auto names_and_types = header.getNamesAndTypesList();
-    String additional_error_message;
-    for (auto & [name, type] : names_and_types)
-    {
-        auto [field, field_name] = getFieldByName(schema, name);
-        if (!checkCapnProtoType(field.getType(), type, mode, additional_error_message, field_name))
-        {
-            auto e = Exception(
-                ErrorCodes::CAPN_PROTO_BAD_CAST,
-                "Cannot convert ClickHouse type {} to CapnProto type {}",
-                type->getName(),
-                getCapnProtoFullTypeName(field.getType()));
-            if (!additional_error_message.empty())
-                e.addMessage(additional_error_message);
-            throw std::move(e);
-        }
-    }
-}
-
-template <typename ValueType>
-static DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
-{
-    std::vector<std::pair<String, ValueType>> values;
-    for (auto enumerant : enumerants)
-        values.emplace_back(enumerant.getProto().getName(), ValueType(enumerant.getOrdinal()));
-    return std::make_shared<DataTypeEnum<ValueType>>(std::move(values));
-}
-
-static DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
-{
-    auto enumerants = enum_schema.getEnumerants();
-    if (enumerants.size() < 128)
-        return getEnumDataTypeFromEnumerants<Int8>(enumerants);
-    if (enumerants.size() < 32768)
-        return getEnumDataTypeFromEnumerants<Int16>(enumerants);
-
-    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "ClickHouse supports only 8 and 16-bit Enums");
-}
-
-static DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
-{
-    switch (capnp_type.which())
-    {
-        case capnp::schema::Type::INT8:
-            return std::make_shared<DataTypeInt8>();
-        case capnp::schema::Type::INT16:
-            return std::make_shared<DataTypeInt16>();
-        case capnp::schema::Type::INT32:
-            return std::make_shared<DataTypeInt32>();
-        case capnp::schema::Type::INT64:
-            return std::make_shared<DataTypeInt64>();
-        case capnp::schema::Type::BOOL: [[fallthrough]];
-        case capnp::schema::Type::UINT8:
-            return std::make_shared<DataTypeUInt8>();
-        case capnp::schema::Type::UINT16:
-            return std::make_shared<DataTypeUInt16>();
-        case capnp::schema::Type::UINT32:
-            return std::make_shared<DataTypeUInt32>();
-        case capnp::schema::Type::UINT64:
-            return std::make_shared<DataTypeUInt64>();
-        case capnp::schema::Type::FLOAT32:
-            return std::make_shared<DataTypeFloat32>();
-        case capnp::schema::Type::FLOAT64:
-            return std::make_shared<DataTypeFloat64>();
-        case capnp::schema::Type::DATA: [[fallthrough]];
-        case capnp::schema::Type::TEXT:
-            return std::make_shared<DataTypeString>();
-        case capnp::schema::Type::ENUM:
-            return getEnumDataTypeFromEnumSchema(capnp_type.asEnum());
-        case capnp::schema::Type::LIST:
-        {
-            auto list_schema = capnp_type.asList();
-            auto nested_type = getDataTypeFromCapnProtoType(list_schema.getElementType(), skip_unsupported_fields);
-            if (!nested_type)
-                return nullptr;
-            return std::make_shared<DataTypeArray>(nested_type);
-        }
-        case capnp::schema::Type::STRUCT:
-        {
-            auto struct_schema = capnp_type.asStruct();
-
-
-            if (struct_schema.getFields().size() == 0)
-            {
-                if (skip_unsupported_fields)
-                    return nullptr;
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Empty messages are not supported");
-            }
-
-            /// Check if it can be Nullable.
-            if (checkIfStructIsNamedUnion(struct_schema))
-            {
-                auto fields = struct_schema.getUnionFields();
-                if (fields.size() != 2 || (!fields[0].getType().isVoid() && !fields[1].getType().isVoid()))
-                {
-                    if (skip_unsupported_fields)
-                        return nullptr;
-                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unions are not supported");
-                }
-                auto value_type = fields[0].getType().isVoid() ? fields[1].getType() : fields[0].getType();
-                if (value_type.isStruct() || value_type.isList())
-                {
-                    if (skip_unsupported_fields)
-                        return nullptr;
-                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Tuples and Lists cannot be inside Nullable");
-                }
-
-                auto nested_type = getDataTypeFromCapnProtoType(value_type, skip_unsupported_fields);
-                if (!nested_type)
-                    return nullptr;
-                return std::make_shared<DataTypeNullable>(nested_type);
-            }
-
-            if (checkIfStructContainsUnnamedUnion(struct_schema))
-                throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
-
-            /// Treat Struct as Tuple.
-            DataTypes nested_types;
-            Names nested_names;
-            for (auto field : struct_schema.getNonUnionFields())
-            {
-                auto nested_type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
-                if (!nested_type)
-                    continue;
-                nested_names.push_back(field.getProto().getName());
-                nested_types.push_back(nested_type);
-            }
-            if (nested_types.empty())
-                return nullptr;
-            return std::make_shared<DataTypeTuple>(std::move(nested_types), std::move(nested_names));
-        }
-        default:
-        {
-            if (skip_unsupported_fields)
-                return nullptr;
-            throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unsupported CapnProtoType: {}", getCapnProtoFullTypeName(capnp_type));
-        }
-    }
-}
-
-NamesAndTypesList capnProtoSchemaToCHSchema(const capnp::StructSchema & schema, bool skip_unsupported_fields)
-{
-    if (checkIfStructContainsUnnamedUnion(schema))
-        throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "Unnamed union is not supported");
-
-    NamesAndTypesList names_and_types;
-    for (auto field : schema.getNonUnionFields())
-    {
-        auto name = field.getProto().getName();
-        auto type = getDataTypeFromCapnProtoType(field.getType(), skip_unsupported_fields);
-        if (type)
-            names_and_types.emplace_back(name, type);
-    }
-    if (names_and_types.empty())
-        throw Exception(ErrorCodes::BAD_ARGUMENTS,
-                        "Cannot convert CapnProto schema to ClickHouse table schema, all fields have unsupported types");
-
-    return names_and_types;
-}
-
-}
-
-#endif
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index c88af650671..475d08e0fe3 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -325,16 +325,16 @@ struct FormatSettings
 
     /// For capnProto format we should determine how to
     /// compare ClickHouse Enum and Enum from schema.
-    enum class EnumComparingMode
+    enum class CapnProtoEnumComparingMode
     {
         BY_NAMES, // Names in enums should be the same, values can be different.
         BY_NAMES_CASE_INSENSITIVE, // Case-insensitive name comparison.
         BY_VALUES, // Values should be the same, names can be different.
     };
 
-    struct
+    struct CapnProto
     {
-        EnumComparingMode enum_comparing_mode = EnumComparingMode::BY_VALUES;
+        CapnProtoEnumComparingMode enum_comparing_mode = CapnProtoEnumComparingMode::BY_VALUES;
         bool skip_fields_with_unsupported_types_in_schema_inference = false;
     } capn_proto;
 
diff --git a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
index 2f84e9bde3c..e686ae86997 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
@@ -9,23 +9,6 @@
 #include <capnp/dynamic.h>
 #include <capnp/common.h>
 
-#include <Columns/ColumnsNumber.h>
-#include <Columns/ColumnArray.h>
-#include <Columns/ColumnTuple.h>
-#include <Columns/ColumnFixedString.h>
-#include <Columns/ColumnLowCardinality.h>
-#include <Columns/ColumnNullable.h>
-#include <Columns/ColumnDecimal.h>
-#include <Columns/ColumnMap.h>
-
-#include <DataTypes/DataTypeEnum.h>
-#include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeNullable.h>
-#include <DataTypes/DataTypesNumber.h>
-#include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypeLowCardinality.h>
-#include <DataTypes/DataTypeMap.h>
-
 namespace DB
 {
 
@@ -35,16 +18,14 @@ namespace ErrorCodes
     extern const int INCORRECT_DATA;
 }
 
-CapnProtoRowInputFormat::CapnProtoRowInputFormat(ReadBuffer & in_, Block header, Params params_, const FormatSchemaInfo & info, const FormatSettings & format_settings_)
-    : IRowInputFormat(std::move(header), in_, std::move(params_))
+CapnProtoRowInputFormat::CapnProtoRowInputFormat(ReadBuffer & in_, Block header_, Params params_, const FormatSchemaInfo & info, const FormatSettings & format_settings)
+    : IRowInputFormat(std::move(header_), in_, std::move(params_))
     , parser(std::make_shared<CapnProtoSchemaParser>())
-    , format_settings(format_settings_)
-    , column_types(getPort().getHeader().getDataTypes())
-    , column_names(getPort().getHeader().getNames())
 {
     // Parse the schema and fetch the root object
-    root = parser->getMessageSchema(info);
-    checkCapnProtoSchemaStructure(root, getPort().getHeader(), format_settings.capn_proto.enum_comparing_mode);
+    schema = parser->getMessageSchema(info);
+    const auto & header = getPort().getHeader();
+    serializer = std::make_unique<CapnProtoSerializer>(header.getDataTypes(), header.getNames(), schema, format_settings.capn_proto);
 }
 
 kj::Array<capnp::word> CapnProtoRowInputFormat::readMessage()
@@ -82,213 +63,6 @@ kj::Array<capnp::word> CapnProtoRowInputFormat::readMessage()
     return msg;
 }
 
-static void insertInteger(IColumn & column, const DataTypePtr & column_type, UInt64 value)
-{
-    switch (column_type->getTypeId())
-    {
-        case TypeIndex::Int8:
-            assert_cast<ColumnInt8 &>(column).insertValue(value);
-            break;
-        case TypeIndex::UInt8:
-            assert_cast<ColumnUInt8 &>(column).insertValue(value);
-            break;
-        case TypeIndex::Int16:
-            assert_cast<ColumnInt16 &>(column).insertValue(value);
-            break;
-        case TypeIndex::Date: [[fallthrough]];
-        case TypeIndex::UInt16:
-            assert_cast<ColumnUInt16 &>(column).insertValue(value);
-            break;
-        case TypeIndex::Int32:
-            assert_cast<ColumnInt32 &>(column).insertValue(static_cast<Int32>(value));
-            break;
-        case TypeIndex::DateTime: [[fallthrough]];
-        case TypeIndex::UInt32:
-            assert_cast<ColumnUInt32 &>(column).insertValue(static_cast<UInt32>(value));
-            break;
-        case TypeIndex::IPv4:
-            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(static_cast<UInt32>(value)));
-            break;
-        case TypeIndex::Int64:
-            assert_cast<ColumnInt64 &>(column).insertValue(value);
-            break;
-        case TypeIndex::UInt64:
-            assert_cast<ColumnUInt64 &>(column).insertValue(value);
-            break;
-        case TypeIndex::DateTime64:
-            assert_cast<ColumnDecimal<DateTime64> &>(column).insertValue(value);
-            break;
-        case TypeIndex::Decimal32:
-            assert_cast<ColumnDecimal<Decimal32> &>(column).insertValue(static_cast<Int32>(value));
-            break;
-        case TypeIndex::Decimal64:
-            assert_cast<ColumnDecimal<Decimal64> &>(column).insertValue(value);
-            break;
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Column type {} cannot be parsed from integer", column_type->getName());
-    }
-}
-
-static void insertFloat(IColumn & column, const DataTypePtr & column_type, Float64 value)
-{
-    switch (column_type->getTypeId())
-    {
-        case TypeIndex::Float32:
-            assert_cast<ColumnFloat32 &>(column).insertValue(static_cast<Float32>(value));
-            break;
-        case TypeIndex::Float64:
-            assert_cast<ColumnFloat64 &>(column).insertValue(value);
-            break;
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Column type is not a float.");
-    }
-}
-
-template <typename Value>
-static void insertData(IColumn & column, const DataTypePtr & column_type, Value value)
-{
-    if (column_type->haveMaximumSizeOfValue() && value.size() != column_type->getSizeOfValueInMemory())
-        throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", column_type->getName(), value.size());
-
-    column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-}
-
-template <typename ValueType>
-static void insertEnum(IColumn & column, const DataTypePtr & column_type, const capnp::DynamicEnum & enum_value, FormatSettings::EnumComparingMode enum_comparing_mode)
-{
-    auto enumerant = *kj::_::readMaybe(enum_value.getEnumerant());
-    auto enum_type = assert_cast<const DataTypeEnum<ValueType> *>(column_type.get());
-    DataTypePtr nested_type = std::make_shared<DataTypeNumber<ValueType>>();
-    switch (enum_comparing_mode)
-    {
-        case FormatSettings::EnumComparingMode::BY_VALUES:
-            insertInteger(column, nested_type, Int64(enumerant.getOrdinal()));
-            return;
-        case FormatSettings::EnumComparingMode::BY_NAMES:
-            insertInteger(column, nested_type, Int64(enum_type->getValue(String(enumerant.getProto().getName()))));
-            return;
-        case FormatSettings::EnumComparingMode::BY_NAMES_CASE_INSENSITIVE:
-        {
-            /// Find the same enum name case insensitive.
-            String enum_name = enumerant.getProto().getName();
-            for (auto & name : enum_type->getAllRegisteredNames())
-            {
-                if (compareEnumNames(name, enum_name, enum_comparing_mode))
-                {
-                    insertInteger(column, nested_type, Int64(enum_type->getValue(name)));
-                    break;
-                }
-            }
-        }
-    }
-}
-
-static void insertValue(IColumn & column, const DataTypePtr & column_type, const String & column_name, const capnp::DynamicValue::Reader & value, FormatSettings::EnumComparingMode enum_comparing_mode)
-{
-    if (column_type->lowCardinality())
-    {
-        auto & lc_column = assert_cast<ColumnLowCardinality &>(column);
-        auto tmp_column = lc_column.getDictionary().getNestedColumn()->cloneEmpty();
-        auto dict_type = assert_cast<const DataTypeLowCardinality *>(column_type.get())->getDictionaryType();
-        insertValue(*tmp_column, dict_type, column_name, value, enum_comparing_mode);
-        lc_column.insertFromFullColumn(*tmp_column, 0);
-        return;
-    }
-
-    switch (value.getType())
-    {
-        case capnp::DynamicValue::Type::INT:
-            insertInteger(column, column_type, value.as<Int64>());
-            break;
-        case capnp::DynamicValue::Type::UINT:
-            insertInteger(column, column_type, value.as<UInt64>());
-            break;
-        case capnp::DynamicValue::Type::FLOAT:
-            insertFloat(column, column_type, value.as<Float64>());
-            break;
-        case capnp::DynamicValue::Type::BOOL:
-            insertInteger(column, column_type, UInt64(value.as<bool>()));
-            break;
-        case capnp::DynamicValue::Type::DATA:
-            insertData(column, column_type, value.as<capnp::Data>());
-            break;
-        case capnp::DynamicValue::Type::TEXT:
-            insertData(column, column_type, value.as<capnp::Text>());
-            break;
-        case capnp::DynamicValue::Type::ENUM:
-            if (column_type->getTypeId() == TypeIndex::Enum8)
-                insertEnum<Int8>(column, column_type, value.as<capnp::DynamicEnum>(), enum_comparing_mode);
-            else
-                insertEnum<Int16>(column, column_type, value.as<capnp::DynamicEnum>(), enum_comparing_mode);
-            break;
-        case capnp::DynamicValue::LIST:
-        {
-            auto list_value = value.as<capnp::DynamicList>();
-            auto & column_array = assert_cast<ColumnArray &>(column);
-            auto & offsets = column_array.getOffsets();
-            offsets.push_back(offsets.back() + list_value.size());
-
-            auto & nested_column = column_array.getData();
-            auto nested_type = assert_cast<const DataTypeArray *>(column_type.get())->getNestedType();
-            for (const auto & nested_value : list_value)
-                insertValue(nested_column, nested_type, column_name, nested_value, enum_comparing_mode);
-            break;
-        }
-        case capnp::DynamicValue::Type::STRUCT:
-        {
-            auto struct_value = value.as<capnp::DynamicStruct>();
-            if (column_type->isNullable())
-            {
-                auto & nullable_column = assert_cast<ColumnNullable &>(column);
-                auto field = *kj::_::readMaybe(struct_value.which());
-                if (field.getType().isVoid())
-                    nullable_column.insertDefault();
-                else
-                {
-                    auto & nested_column = nullable_column.getNestedColumn();
-                    auto nested_type = assert_cast<const DataTypeNullable *>(column_type.get())->getNestedType();
-                    auto nested_value = struct_value.get(field);
-                    insertValue(nested_column, nested_type, column_name, nested_value, enum_comparing_mode);
-                    nullable_column.getNullMapData().push_back(0);
-                }
-            }
-            else if (isTuple(column_type))
-            {
-                auto & tuple_column = assert_cast<ColumnTuple &>(column);
-                const auto * tuple_type = assert_cast<const DataTypeTuple *>(column_type.get());
-                bool have_explicit_names = tuple_type->haveExplicitNames();
-                auto struct_schema = struct_value.getSchema();
-                for (uint32_t i = 0; i != tuple_column.tupleSize(); ++i)
-                    insertValue(
-                        tuple_column.getColumn(i),
-                        tuple_type->getElements()[i],
-                        tuple_type->getElementNames()[i],
-                        struct_value.get(have_explicit_names ? struct_schema.getFieldByName(tuple_type->getElementNames()[i]) : struct_schema.getFields()[i]),
-                        enum_comparing_mode);
-            }
-            else if (isMap(column_type))
-            {
-                const auto & map_type = assert_cast<const DataTypeMap &>(*column_type);
-                DataTypes key_value_types = {map_type.getKeyType(), map_type.getValueType()};
-                Names key_value_names = {"key", "value"};
-                auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(key_value_types, key_value_names));
-                auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
-                auto entries_field = struct_value.getSchema().getFields()[0];
-                insertValue(entries_column, entries_type, column_name, struct_value.get(entries_field), enum_comparing_mode);
-            }
-            else
-            {
-                /// It can be nested column from Nested type.
-                auto [field_name, nested_name] = splitCapnProtoFieldName(column_name);
-                insertValue(column, column_type, nested_name, struct_value.get(nested_name), enum_comparing_mode);
-            }
-            break;
-        }
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected CapnProto value type.");
-    }
-}
-
 bool CapnProtoRowInputFormat::readRow(MutableColumns & columns, RowReadExtension &)
 {
     if (in->eof())
@@ -298,12 +72,8 @@ bool CapnProtoRowInputFormat::readRow(MutableColumns & columns, RowReadExtension
     {
         auto array = readMessage();
         capnp::FlatArrayMessageReader msg(array);
-        auto root_reader = msg.getRoot<capnp::DynamicStruct>(root);
-        for (size_t i = 0; i != columns.size(); ++i)
-        {
-            auto value = getReaderByColumnName(root_reader, column_names[i]);
-            insertValue(*columns[i], column_types[i], column_names[i], value, format_settings.capn_proto.enum_comparing_mode);
-        }
+        auto root_reader = msg.getRoot<capnp::DynamicStruct>(schema);
+        serializer->readRow(columns, root_reader);
     }
     catch (const kj::Exception & e)
     {
@@ -343,7 +113,14 @@ void registerInputFormatCapnProto(FormatFactory & factory)
     factory.markFormatSupportsSubsetOfColumns("CapnProto");
     factory.registerFileExtension("capnp", "CapnProto");
     factory.registerAdditionalInfoForSchemaCacheGetter(
-        "CapnProto", [](const FormatSettings & settings) { return fmt::format("format_schema={}", settings.schema.format_schema); });
+        "CapnProto",
+        [](const FormatSettings & settings)
+        {
+            return fmt::format(
+                "format_schema={}, skip_fields_with_unsupported_types_in_schema_inference={}",
+                settings.schema.format_schema,
+                settings.capn_proto.skip_fields_with_unsupported_types_in_schema_inference);
+        });
 }
 
 void registerCapnProtoSchemaReader(FormatFactory & factory)
diff --git a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h
index cf23f22b643..06e94da123f 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h
+++ b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.h
@@ -4,7 +4,8 @@
 #if USE_CAPNP
 
 #include <Core/Block.h>
-#include <Formats/CapnProtoUtils.h>
+#include <Formats/CapnProtoSchema.h>
+#include <Formats/CapnProtoSerializer.h>
 #include <Processors/Formats/IRowInputFormat.h>
 #include <Processors/Formats/ISchemaReader.h>
 
@@ -33,10 +34,8 @@ private:
     kj::Array<capnp::word> readMessage();
 
     std::shared_ptr<CapnProtoSchemaParser> parser;
-    capnp::StructSchema root;
-    const FormatSettings format_settings;
-    DataTypes column_types;
-    Names column_names;
+    capnp::StructSchema schema;
+    std::unique_ptr<CapnProtoSerializer> serializer;
 };
 
 class CapnProtoSchemaReader : public IExternalSchemaReader
diff --git a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
index 0225680b396..7dd18be27f4 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
@@ -1,28 +1,13 @@
 #include <Processors/Formats/Impl/CapnProtoRowOutputFormat.h>
 #if USE_CAPNP
 
-#include <Formats/CapnProtoUtils.h>
+#include <Formats/CapnProtoSchema.h>
 #include <Formats/FormatSettings.h>
+#include <Formats/CapnProtoSerializer.h>
 #include <IO/WriteBuffer.h>
 #include <capnp/dynamic.h>
 #include <capnp/serialize-packed.h>
 
-#include <Columns/ColumnArray.h>
-#include <Columns/ColumnNullable.h>
-#include <Columns/ColumnString.h>
-#include <Columns/ColumnFixedString.h>
-#include <Columns/ColumnTuple.h>
-#include <Columns/ColumnLowCardinality.h>
-#include <Columns/ColumnDecimal.h>
-#include <Columns/ColumnMap.h>
-
-#include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypeEnum.h>
-#include <DataTypes/DataTypeNullable.h>
-#include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypeLowCardinality.h>
-#include <DataTypes/DataTypeMap.h>
-
 namespace DB
 {
 
@@ -45,252 +30,25 @@ CapnProtoRowOutputFormat::CapnProtoRowOutputFormat(
     WriteBuffer & out_,
     const Block & header_,
     const FormatSchemaInfo & info,
-    const FormatSettings & format_settings_)
-    : IRowOutputFormat(header_, out_), column_names(header_.getNames()), column_types(header_.getDataTypes()), output_stream(std::make_unique<CapnProtoOutputStream>(out_)), format_settings(format_settings_)
+    const FormatSettings & format_settings)
+    : IRowOutputFormat(header_, out_)
+    , column_names(header_.getNames())
+    , column_types(header_.getDataTypes())
+    , output_stream(std::make_unique<CapnProtoOutputStream>(out_))
 {
     schema = schema_parser.getMessageSchema(info);
-    checkCapnProtoSchemaStructure(schema, getPort(PortKind::Main).getHeader(), format_settings.capn_proto.enum_comparing_mode);
-}
-
-template <typename EnumValue>
-static capnp::DynamicEnum getDynamicEnum(
-    const ColumnPtr & column,
-    const DataTypePtr & data_type,
-    size_t row_num,
-    const capnp::EnumSchema & enum_schema,
-    FormatSettings::EnumComparingMode mode)
-{
-    const auto * enum_data_type = assert_cast<const DataTypeEnum<EnumValue> *>(data_type.get());
-    EnumValue enum_value = column->getInt(row_num);
-    if (mode == FormatSettings::EnumComparingMode::BY_VALUES)
-        return capnp::DynamicEnum(enum_schema, enum_value);
-
-    auto enum_name = enum_data_type->getNameForValue(enum_value);
-    for (const auto enumerant : enum_schema.getEnumerants())
-    {
-        if (compareEnumNames(String(enum_name), enumerant.getProto().getName(), mode))
-            return capnp::DynamicEnum(enumerant);
-    }
-
-    throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert CLickHouse Enum value to CapnProto Enum");
-}
-
-static capnp::DynamicValue::Builder initStructFieldBuilder(const ColumnPtr & column, size_t row_num, capnp::DynamicStruct::Builder & struct_builder, capnp::StructSchema::Field field)
-{
-    if (const auto * array_column = checkAndGetColumn<ColumnArray>(*column))
-    {
-        size_t size = array_column->getOffsets()[row_num] - array_column->getOffsets()[row_num - 1];
-        return struct_builder.init(field, static_cast<unsigned>(size));
-    }
-
-    if (field.getType().isStruct())
-        return struct_builder.init(field);
-
-    return struct_builder.get(field);
-}
-
-static std::optional<capnp::DynamicValue::Reader> convertToDynamicValue(
-    const ColumnPtr & column,
-    const DataTypePtr & data_type,
-    size_t row_num,
-    const String & column_name,
-    capnp::DynamicValue::Builder builder,
-    FormatSettings::EnumComparingMode enum_comparing_mode,
-    std::vector<std::unique_ptr<String>> & temporary_text_data_storage)
-{
-    /// Here we don't do any types validation, because we did it in CapnProtoRowOutputFormat constructor.
-
-    if (data_type->lowCardinality())
-    {
-        const auto * lc_column = assert_cast<const ColumnLowCardinality *>(column.get());
-        const auto & dict_type = assert_cast<const DataTypeLowCardinality *>(data_type.get())->getDictionaryType();
-        size_t index = lc_column->getIndexAt(row_num);
-        return convertToDynamicValue(lc_column->getDictionary().getNestedColumn(), dict_type, index, column_name, builder, enum_comparing_mode, temporary_text_data_storage);
-    }
-
-    switch (builder.getType())
-    {
-        case capnp::DynamicValue::Type::INT:
-            return capnp::DynamicValue::Reader(column->getInt(row_num));
-        case capnp::DynamicValue::Type::UINT:
-        {
-            /// IPv4 column doesn't support getUInt method.
-            if (isIPv4(data_type))
-                return capnp::DynamicValue::Reader(assert_cast<const ColumnIPv4 *>(column.get())->getElement(row_num));
-            return capnp::DynamicValue::Reader(column->getUInt(row_num));
-        }
-        case capnp::DynamicValue::Type::BOOL:
-            return capnp::DynamicValue::Reader(column->getBool(row_num));
-        case capnp::DynamicValue::Type::FLOAT:
-            return capnp::DynamicValue::Reader(column->getFloat64(row_num));
-        case capnp::DynamicValue::Type::ENUM:
-        {
-            auto enum_schema = builder.as<capnp::DynamicEnum>().getSchema();
-            if (data_type->getTypeId() == TypeIndex::Enum8)
-                return capnp::DynamicValue::Reader(
-                    getDynamicEnum<Int8>(column, data_type, row_num, enum_schema, enum_comparing_mode));
-            return capnp::DynamicValue::Reader(
-                    getDynamicEnum<Int16>(column, data_type, row_num, enum_schema, enum_comparing_mode));
-        }
-        case capnp::DynamicValue::Type::DATA:
-        {
-            auto data = column->getDataAt(row_num);
-            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
-        }
-        case capnp::DynamicValue::Type::TEXT:
-        {
-            /// In TEXT type data should be null-terminated, but ClickHouse String data could not be.
-            /// To make data null-terminated we should copy it to temporary String object, but
-            /// capnp::Text::Reader works only with pointer to the data and it's size, so we should
-            /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
-            /// To do this we store new String object in a temporary storage, passed in this function
-            /// by reference. We use unique_ptr<String> instead of just String to avoid pointers
-            /// invalidation on vector reallocation.
-            temporary_text_data_storage.push_back(std::make_unique<String>(column->getDataAt(row_num)));
-            auto & data = temporary_text_data_storage.back();
-            return capnp::DynamicValue::Reader(capnp::Text::Reader(data->data(), data->size()));
-        }
-        case capnp::DynamicValue::Type::STRUCT:
-        {
-            auto struct_builder = builder.as<capnp::DynamicStruct>();
-            auto nested_struct_schema = struct_builder.getSchema();
-            /// Struct can represent Tuple, Nullable (named union with two fields) or single column when it contains one nested column.
-            if (data_type->isNullable())
-            {
-                const auto * nullable_type = assert_cast<const DataTypeNullable *>(data_type.get());
-                const auto * nullable_column = assert_cast<const ColumnNullable *>(column.get());
-                auto fields = nested_struct_schema.getUnionFields();
-                if (nullable_column->isNullAt(row_num))
-                {
-                    auto null_field = fields[0].getType().isVoid() ? fields[0] : fields[1];
-                    struct_builder.set(null_field, capnp::Void());
-                }
-                else
-                {
-                    auto value_field = fields[0].getType().isVoid() ? fields[1] : fields[0];
-                    struct_builder.clear(value_field);
-                    const auto & nested_column = nullable_column->getNestedColumnPtr();
-                    auto value_builder = initStructFieldBuilder(nested_column, row_num, struct_builder, value_field);
-                    auto value = convertToDynamicValue(nested_column, nullable_type->getNestedType(), row_num, column_name, value_builder, enum_comparing_mode, temporary_text_data_storage);
-                    if (value)
-                        struct_builder.set(value_field, *value);
-                }
-            }
-            else if (isTuple(data_type))
-            {
-                const auto * tuple_data_type = assert_cast<const DataTypeTuple *>(data_type.get());
-                const auto & nested_types = tuple_data_type->getElements();
-                const auto & nested_names = tuple_data_type->getElementNames();
-                const auto & nested_columns = assert_cast<const ColumnTuple *>(column.get())->getColumns();
-                bool have_explicit_names = tuple_data_type->haveExplicitNames();
-                for (uint32_t i = 0; i != nested_names.size(); ++i)
-                {
-                    capnp::StructSchema::Field nested_field = have_explicit_names ? nested_struct_schema.getFieldByName(nested_names[i]) : nested_struct_schema.getFields()[i];
-                    auto field_builder = initStructFieldBuilder(nested_columns[i], row_num, struct_builder, nested_field);
-                    auto value = convertToDynamicValue(nested_columns[i], nested_types[i], row_num, nested_names[i], field_builder, enum_comparing_mode, temporary_text_data_storage);
-                    if (value)
-                        struct_builder.set(nested_field, *value);
-                }
-            }
-            else if (isMap(data_type))
-            {
-                /// We output Map type as follow CapnProto schema
-                ///
-                /// struct Map {
-                ///     struct Entry {
-                ///         key @0: Key;
-                ///         value @1: Value;
-                ///     }
-                ///     entries @0 :List(Entry);
-                /// }
-                ///
-                /// And we don't need to check that struct have this form here because we checked it before.
-                const auto & map_type = assert_cast<const DataTypeMap &>(*data_type);
-                DataTypes key_value_types = {map_type.getKeyType(), map_type.getValueType()};
-                Names key_value_names = {"key", "value"};
-                auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(key_value_types, key_value_names));
-
-                /// Nested column in Map is actually Array(Tuple), so we can output it according to "entries" field schema.
-                const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
-
-                auto entries_field = nested_struct_schema.getFields()[0];
-                auto field_builder = initStructFieldBuilder(entries_column, row_num, struct_builder, entries_field);
-                auto entries_value = convertToDynamicValue(entries_column, entries_type, row_num, column_name, field_builder, enum_comparing_mode, temporary_text_data_storage);
-                if (entries_value)
-                    struct_builder.set(entries_field, *entries_value);
-            }
-            else
-            {
-                /// It can be nested column from Nested type.
-                auto [field_name, nested_name] = splitCapnProtoFieldName(column_name);
-                auto nested_field = nested_struct_schema.getFieldByName(nested_name);
-                auto field_builder = initStructFieldBuilder(column, row_num, struct_builder, nested_field);
-                auto value = convertToDynamicValue(column, data_type, row_num, nested_name, field_builder, enum_comparing_mode, temporary_text_data_storage);
-                if (value)
-                    struct_builder.set(nested_field, *value);
-            }
-            return std::nullopt;
-        }
-        case capnp::DynamicValue::Type::LIST:
-        {
-            auto list_builder = builder.as<capnp::DynamicList>();
-            const auto * array_column = assert_cast<const ColumnArray *>(column.get());
-            const auto & nested_column = array_column->getDataPtr();
-            const auto & nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
-            const auto & offsets = array_column->getOffsets();
-            auto offset = offsets[row_num - 1];
-            size_t size = offsets[row_num] - offset;
-
-            const auto * nested_array_column = checkAndGetColumn<ColumnArray>(*nested_column);
-            for (unsigned i = 0; i != static_cast<unsigned>(size); ++i)
-            {
-                capnp::DynamicValue::Builder value_builder;
-                /// For nested arrays we need to initialize nested list builder.
-                if (nested_array_column)
-                {
-                    const auto & nested_offset = nested_array_column->getOffsets();
-                    size_t nested_array_size = nested_offset[offset + i] - nested_offset[offset + i - 1];
-                    value_builder = list_builder.init(i, static_cast<unsigned>(nested_array_size));
-                }
-                else
-                    value_builder = list_builder[i];
-
-                auto value = convertToDynamicValue(nested_column, nested_type, offset + i, column_name, value_builder, enum_comparing_mode, temporary_text_data_storage);
-                if (value)
-                    list_builder.set(i, *value);
-            }
-            return std::nullopt;
-        }
-        default:
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected CapnProto type.");
-    }
+    const auto & header = getPort(PortKind::Main).getHeader();
+    serializer = std::make_unique<CapnProtoSerializer>(header.getDataTypes(), header.getNames(), schema, format_settings.capn_proto);
+    capnp::MallocMessageBuilder message;
 }
 
 void CapnProtoRowOutputFormat::write(const Columns & columns, size_t row_num)
 {
     capnp::MallocMessageBuilder message;
-    /// Temporary storage for data that will be outputted in fields with CapnProto type TEXT.
-    /// See comment in convertToDynamicValue() for more details.
-    std::vector<std::unique_ptr<String>> temporary_text_data_storage;
     capnp::DynamicStruct::Builder root = message.initRoot<capnp::DynamicStruct>(schema);
-
-    /// Some columns can share same field builder. For example when we have
-    /// column with Nested type that was flattened into several columns.
-    std::unordered_map<size_t, capnp::DynamicValue::Builder> field_builders;
-    for (size_t i = 0; i != columns.size(); ++i)
-    {
-        auto [struct_builder, field] = getStructBuilderAndFieldByColumnName(root, column_names[i]);
-        if (!field_builders.contains(field.getIndex()))
-        {
-            auto field_builder = initStructFieldBuilder(columns[i], row_num, struct_builder, field);
-            field_builders[field.getIndex()] = field_builder;
-        }
-        auto value = convertToDynamicValue(columns[i], column_types[i], row_num, column_names[i], field_builders[field.getIndex()], format_settings.capn_proto.enum_comparing_mode, temporary_text_data_storage);
-        if (value)
-            struct_builder.set(field, *value);
-    }
-
+    serializer->writeRow(columns, std::move(root), row_num);
     capnp::writeMessage(*output_stream, message);
+
 }
 
 void registerOutputFormatCapnProto(FormatFactory & factory)
diff --git a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h
index 5cc7099d4c7..dd9dcc6b340 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h
+++ b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.h
@@ -3,15 +3,17 @@
 #include "config.h"
 #if USE_CAPNP
 
-#include <Processors/Formats/IRowOutputFormat.h>
-#include <Formats/FormatSchemaInfo.h>
-#include <Formats/CapnProtoUtils.h>
-#include <capnp/schema.h>
-#include <capnp/dynamic.h>
-#include <kj/io.h>
+#    include <Formats/CapnProtoSchema.h>
+#    include <Formats/CapnProtoSerializer.h>
+#    include <Formats/FormatSchemaInfo.h>
+#    include <Processors/Formats/IRowOutputFormat.h>
+#    include <capnp/dynamic.h>
+#    include <capnp/schema.h>
+#    include <kj/io.h>
 
 namespace DB
 {
+
 class CapnProtoOutputStream : public kj::OutputStream
 {
 public:
@@ -43,8 +45,9 @@ private:
     DataTypes column_types;
     capnp::StructSchema schema;
     std::unique_ptr<CapnProtoOutputStream> output_stream;
-    const FormatSettings format_settings;
     CapnProtoSchemaParser schema_parser;
+    std::unique_ptr<CapnProtoSerializer> serializer;
+
 };
 
 }
diff --git a/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp b/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp
index 9777f2361a2..6098923a195 100644
--- a/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ProtobufListInputFormat.cpp
@@ -88,7 +88,14 @@ void registerInputFormatProtobufList(FormatFactory & factory)
             });
     factory.markFormatSupportsSubsetOfColumns("ProtobufList");
     factory.registerAdditionalInfoForSchemaCacheGetter(
-        "ProtobufList", [](const FormatSettings & settings) { return fmt::format("format_schema={}", settings.schema.format_schema); });
+        "ProtobufList",
+        [](const FormatSettings & settings)
+        {
+            return fmt::format(
+                "format_schema={}, skip_fields_with_unsupported_types_in_schema_inference={}",
+                settings.schema.format_schema,
+                settings.protobuf.skip_fields_with_unsupported_types_in_schema_inference);
+        });
 }
 
 void registerProtobufListSchemaReader(FormatFactory & factory)
diff --git a/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp b/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp
index ee60501dba5..126f3673571 100644
--- a/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ProtobufRowInputFormat.cpp
@@ -128,7 +128,14 @@ void registerProtobufSchemaReader(FormatFactory & factory)
 
     for (const auto & name : {"Protobuf", "ProtobufSingle"})
         factory.registerAdditionalInfoForSchemaCacheGetter(
-            name, [](const FormatSettings & settings) { return fmt::format("format_schema={}", settings.schema.format_schema); });
+            name,
+            [](const FormatSettings & settings)
+            {
+                return fmt::format(
+                    "format_schema={}, skip_fields_with_unsupported_types_in_schema_inference={}",
+                    settings.schema.format_schema,
+                    settings.protobuf.skip_fields_with_unsupported_types_in_schema_inference);
+            });
 }
 
 }
diff --git a/tests/queries/0_stateless/02030_capnp_format.sh b/tests/queries/0_stateless/02030_capnp_format.sh
index c15d6fe442e..625104fb590 100755
--- a/tests/queries/0_stateless/02030_capnp_format.sh
+++ b/tests/queries/0_stateless/02030_capnp_format.sh
@@ -96,8 +96,8 @@ $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a_b U
 
 $CLICKHOUSE_CLIENT --query="SELECT number AS a_b, number + 1 AS a_c_d, number + 2 AS a_c_e_f FROM numbers(5) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_nested_tuples:Message'" > $CAPN_PROTO_FILE
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(b UInt64, c Tuple(d UInt64, e Tuple(f UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'"
-$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(bb UInt64, c Tuple(d UInt64, e Tuple(f UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
-$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(b UInt64, c Tuple(d UInt64, e Tuple(ff UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(bb UInt64, c Tuple(d UInt64, e Tuple(f UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "THERE_IS_NO_COLUMN" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'a Tuple(b UInt64, c Tuple(d UInt64, e Tuple(ff UInt64)))') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_nested_tuples:Message'" 2>&1 | grep -F -q "THERE_IS_NO_COLUMN" && echo 'OK' || echo 'FAIL';
 
 
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'string String') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_simple_types:Message'" 2>&1 | grep -F -q "INCORRECT_DATA" && echo 'OK' || echo 'FAIL';
diff --git a/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
new file mode 100644
index 00000000000..f34c857e2f6
--- /dev/null
+++ b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
@@ -0,0 +1 @@
+42	(42,42)
diff --git a/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
new file mode 100755
index 00000000000..c3835948437
--- /dev/null
+++ b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest, no-parallel, no-replicated-database
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+SCHEMADIR=$CURDIR/format_schemas
+$CLICKHOUSE_LOCAL -q "select 42 as Field1, (42, 42)::Tuple(Field1 UInt32, Field2 UInt32) as Nested format CapnProto settings format_schema='$SCHEMADIR/02735_case_insensitive_names_matching:Message'" | $CLICKHOUSE_LOCAL --input-format CapnProto --structure "Field1 UInt32, Nested Tuple(Field1 UInt32, Field2 UInt32)" -q "select * from table" --format_schema="$SCHEMADIR/02735_case_insensitive_names_matching:Message"
+
diff --git a/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference
new file mode 100644
index 00000000000..b6e6d485929
--- /dev/null
+++ b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.reference
@@ -0,0 +1,3 @@
+(42,(42,42),[(42,42),(24,24)])	[(42,(42,42),[(42,42),(24,24)]),(24,(24,24),[(24,24),(42,42)])]
+42	42	42
+[42,24]	[42,24]	[42,24]	[[42,24],[24,42]]	[[42,24],[24,42]]
diff --git a/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh
new file mode 100755
index 00000000000..c669be2ed33
--- /dev/null
+++ b/tests/queries/0_stateless/02736_reading_and_writing_structure_fields.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest, no-parallel, no-replicated-database
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+SCHEMADIR=$CURDIR/format_schemas
+DATA_FILE=02736_$CLICKHOUSE_TEST_UNIQUE_NAME.bin
+
+$CLICKHOUSE_LOCAL -q "select tuple(42, tuple(42, 42), [tuple(42, 42), tuple(24, 24)]) as nested, [tuple(42, tuple(42, 42), [tuple(42, 42), tuple(24, 24)]), tuple(24, tuple(24, 24), [tuple(24, 24), tuple(42, 42)])] as nestedList format CapnProto settings format_schema='$SCHEMADIR/02736_nested_structures:Message'" > $DATA_FILE
+
+$CLICKHOUSE_LOCAL -q "select * from file($DATA_FILE, CapnProto) settings format_schema='$SCHEMADIR/02736_nested_structures:Message'"
+
+$CLICKHOUSE_LOCAL -q "select 42 as nested_field1, 42 as nested_nested_field1, 42 as nested_nested_field2 format CapnProto settings format_schema='$SCHEMADIR/02736_nested_structures:Message'" > $DATA_FILE
+
+$CLICKHOUSE_LOCAL -q "select * from file($DATA_FILE, CapnProto, 'nested_field1 UInt32, nested_nested_field1 UInt32, nested_nested_field2 UInt32') settings format_schema='$SCHEMADIR/02736_nested_structures:Message'"
+
+$CLICKHOUSE_LOCAL -q "select [42, 24] as nestedList_field1, [42, 24] as nestedList_nested_field1, [42, 24] as nestedList_nested_field2, [[42, 24], [24, 42]] as nestedList_nestedList_field1, [[42, 24], [24, 42]] as nestedList_nestedList_field2 format CapnProto settings format_schema='$SCHEMADIR/02736_nested_structures:Message'" > $DATA_FILE
+
+$CLICKHOUSE_LOCAL -q "select * from file($DATA_FILE, CapnProto, 'nestedList_field1 Array(UInt32), nestedList_nested_field1 Array(UInt32), nestedList_nested_field2 Array(UInt32), nestedList_nestedList_field1 Array(Array(UInt32)), nestedList_nestedList_field2 Array(Array(UInt32))') settings format_schema='$SCHEMADIR/02736_nested_structures:Message'"
+
+rm $DATA_FILE
+
diff --git a/tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp b/tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp
new file mode 100644
index 00000000000..6b12aab081a
--- /dev/null
+++ b/tests/queries/0_stateless/format_schemas/02735_case_insensitive_names_matching.capnp
@@ -0,0 +1,13 @@
+@0x9ef128e10a8010b8;
+
+struct Nested
+{
+    field1 @0 : UInt32;
+    field2 @1 : UInt32;
+}
+
+struct Message
+{
+    field1 @0 : UInt32;
+    nested @1 : Nested;
+}
diff --git a/tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp b/tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp
new file mode 100644
index 00000000000..a03eb27f383
--- /dev/null
+++ b/tests/queries/0_stateless/format_schemas/02736_nested_structures.capnp
@@ -0,0 +1,21 @@
+@0x9ef128e10a8010b8;
+
+struct Nested2
+{
+    field1 @0 : UInt32;
+    field2 @1 : UInt32;
+}
+
+struct Nested
+{
+    field1 @0 : UInt32;
+    nested @1 : Nested2;
+    nestedList @2 : List(Nested2);
+}
+
+struct Message
+{
+    nested @0 : Nested;
+    nestedList @1 : List(Nested);
+}
+

From c2eada7ba7bd385281c140dbf225be7eee4f1ff2 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 10 May 2023 21:07:56 +0200
Subject: [PATCH 126/722] Fix style

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index e0c8ae2a79a..c31623286d0 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -26,7 +26,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int THERE_IS_NO_COLUMN;
-    extern const int BAD_TYPE_OF_FIELD;
+    extern const int LOGICAL_ERROR;
     extern const int CAPN_PROTO_BAD_CAST;
     extern const int INCORRECT_DATA;
     extern const int ILLEGAL_COLUMN;
@@ -293,7 +293,7 @@ namespace
                     return capnp::DynamicValue::Reader(capnp::DynamicEnum(enumerant));
             }
 
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert CLickHouse Enum value to CapnProto Enum");
+            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert ClickHouse Enum value to CapnProto Enum");
         }
 
         void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override

From cc7cfa050f5723fa4bfeca994a04784732950968 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 10 May 2023 21:08:12 +0200
Subject: [PATCH 127/722] Fix style

---
 src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
index e686ae86997..c056ee2b4a4 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowInputFormat.cpp
@@ -14,7 +14,6 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int LOGICAL_ERROR;
     extern const int INCORRECT_DATA;
 }
 

From 1347dc4ede100dbfc7240fa7ead23b13c924d202 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 10 May 2023 21:08:31 +0200
Subject: [PATCH 128/722] Fix style

---
 src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
index 7dd18be27f4..66a7160dd89 100644
--- a/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/CapnProtoRowOutputFormat.cpp
@@ -11,12 +11,6 @@
 namespace DB
 {
 
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-}
-
-
 CapnProtoOutputStream::CapnProtoOutputStream(WriteBuffer & out_) : out(out_)
 {
 }

From a89a8b8d50f8ff5c05ebbcdb83f19dcac6739dbf Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 11 May 2023 12:08:50 +0000
Subject: [PATCH 129/722] Fix build

---
 src/Formats/CapnProtoSerializer.cpp | 6 ++++++
 src/Formats/CapnProtoSerializer.h   | 4 ++++
 2 files changed, 10 insertions(+)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index c31623286d0..00ccfc7717d 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -1,3 +1,7 @@
+#include "config.h"
+
+#if USE_CAPNP
+
 #include <Formats/CapnProtoSerializer.h>
 #include <Formats/FormatSettings.h>
 #include <Formats/CapnProtoSchema.h>
@@ -1216,3 +1220,5 @@ void CapnProtoSerializer::readRow(MutableColumns & columns, capnp::DynamicStruct
 CapnProtoSerializer::~CapnProtoSerializer() = default;
 
 }
+
+#endif
diff --git a/src/Formats/CapnProtoSerializer.h b/src/Formats/CapnProtoSerializer.h
index efae797875b..692f5e5301f 100644
--- a/src/Formats/CapnProtoSerializer.h
+++ b/src/Formats/CapnProtoSerializer.h
@@ -1,5 +1,7 @@
 #pragma once
 
+#if USE_CAPNP
+
 #include <Core/Block.h>
 #include <capnp/dynamic.h>
 
@@ -23,3 +25,5 @@ private:
 };
 
 }
+
+#endif

From 5f1ca61d090b70ecee8f70d8e3656195e13f0ee9 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 12 May 2023 16:12:01 +0200
Subject: [PATCH 130/722] Fix special builds

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index 00ccfc7717d..091e70da656 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -1007,7 +1007,7 @@ namespace
             catch (Exception & e)
             {
                 e.addMessage("(while converting column {})", column_name);
-                throw e;
+                throw std::move(e);
             }
         }
 
@@ -1015,7 +1015,7 @@ namespace
         {
             assert(builder);
             auto & struct_builder = assert_cast<StructBuilder &>(*builder);
-            if (auto tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+            if (auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
                 writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
             else
                 writeRow(Columns{column}, struct_builder, row_num);

From 94ef08977ae88a48f95343a7b27abed6471efbe6 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 12 May 2023 18:53:51 +0200
Subject: [PATCH 131/722] Fix special build

---
 src/Formats/CapnProtoSchema.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Formats/CapnProtoSchema.cpp b/src/Formats/CapnProtoSchema.cpp
index 22518d5061a..f9ab88d39ed 100644
--- a/src/Formats/CapnProtoSchema.cpp
+++ b/src/Formats/CapnProtoSchema.cpp
@@ -151,7 +151,7 @@ namespace
 {
 
     template <typename ValueType>
-    static DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
+    DataTypePtr getEnumDataTypeFromEnumerants(const capnp::EnumSchema::EnumerantList & enumerants)
     {
         std::vector<std::pair<String, ValueType>> values;
         for (auto enumerant : enumerants)
@@ -159,7 +159,7 @@ namespace
         return std::make_shared<DataTypeEnum<ValueType>>(std::move(values));
     }
 
-    static DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
+    DataTypePtr getEnumDataTypeFromEnumSchema(const capnp::EnumSchema & enum_schema)
     {
         auto enumerants = enum_schema.getEnumerants();
         if (enumerants.size() < 128)
@@ -170,7 +170,7 @@ namespace
         throw Exception(ErrorCodes::CAPN_PROTO_BAD_TYPE, "ClickHouse supports only 8 and 16-bit Enums");
     }
 
-    static DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
+    DataTypePtr getDataTypeFromCapnProtoType(const capnp::Type & capnp_type, bool skip_unsupported_fields)
     {
         switch (capnp_type.which())
         {

From f76fc5e06682fb7931fc067bcbc38960e91dea7b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 12 May 2023 18:54:38 +0200
Subject: [PATCH 132/722] Fix special build

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index 091e70da656..ff3880976c7 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -158,7 +158,7 @@ namespace
     };
 
     template <typename NumericType, bool is_bool_data_type = false>
-    static std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+    std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
     {
         switch (capnp_type.which())
         {
@@ -1015,7 +1015,7 @@ namespace
         {
             assert(builder);
             auto & struct_builder = assert_cast<StructBuilder &>(*builder);
-            if (auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+            if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
                 writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
             else
                 writeRow(Columns{column}, struct_builder, row_num);

From f48845fa0d56dc81a44fd6314342849325d78b0b Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Thu, 25 May 2023 12:23:35 +0000
Subject: [PATCH 133/722] Fix test once again

---
 .../integration/runner/compose/docker_compose_mongo_secure.yml  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml b/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml
index f5b0ffed130..193e5d26568 100644
--- a/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml
+++ b/docker/test/integration/runner/compose/docker_compose_mongo_secure.yml
@@ -1,7 +1,7 @@
 version: '2.3'
 services:
     mongo1:
-        image: mongo:3.5
+        image: mongo:3.6
         restart: always
         environment:
             MONGO_INITDB_ROOT_USERNAME: root

From ea395e9554e29f5eaa73d9fcd632f87aa4371d42 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 25 May 2023 15:24:02 +0000
Subject: [PATCH 134/722] Make better

---
 src/Formats/CapnProtoSerializer.cpp | 1152 ++++++++++++++++++---------
 src/Formats/CapnProtoSerializer.h   |    1 +
 2 files changed, 757 insertions(+), 396 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index ff3880976c7..91e207a1846 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -10,7 +10,6 @@
 #include <DataTypes/DataTypeLowCardinality.h>
 #include <DataTypes/DataTypeNullable.h>
 #include <DataTypes/DataTypeTuple.h>
-#include <DataTypes/DataTypesNumber.h>
 #include <DataTypes/DataTypeMap.h>
 #include <DataTypes/IDataType.h>
 #include <Columns/ColumnArray.h>
@@ -77,7 +76,7 @@ namespace
 
     struct ListBuilder : public FieldBuilder
     {
-        explicit ListBuilder(capnp::DynamicValue::Builder builder) : impl(builder.as<capnp::DynamicList>())
+        explicit ListBuilder(capnp::DynamicValue::Builder builder, UInt32 elements_size) : impl(builder.as<capnp::DynamicList>()), nested_builders(elements_size)
         {
         }
 
@@ -87,10 +86,6 @@ namespace
 
     struct StructBuilder : public FieldBuilder
     {
-        explicit StructBuilder(capnp::DynamicValue::Builder builder, size_t fields_size) : impl(builder.as<capnp::DynamicStruct>()), field_builders(fields_size)
-        {
-        }
-
         explicit StructBuilder(capnp::DynamicStruct::Builder struct_builder, size_t fields_size) : impl(std::move(struct_builder)), field_builders(fields_size)
         {
         }
@@ -99,136 +94,144 @@ namespace
         std::vector<std::unique_ptr<FieldBuilder>> field_builders;
     };
 
-    std::unique_ptr<FieldBuilder> initStructFieldBuilderIfNeeded(const ColumnPtr & column, size_t row_num, capnp::DynamicStruct::Builder & struct_builder, const capnp::StructSchema::Field & field, const capnp::Type & capnp_type, size_t nested_fields_size)
-    {
-        switch (capnp_type.which())
-        {
-            case capnp::schema::Type::LIST:
-            {
-                const auto * array_column = assert_cast<const ColumnArray *>(column.get());
-                size_t size = array_column->getOffsets()[row_num] - array_column->getOffsets()[row_num - 1];
-                return std::make_unique<ListBuilder>(struct_builder.init(field, static_cast<unsigned>(size)));
-            }
-            case capnp::schema::Type::STRUCT:
-            {
-                return std::make_unique<StructBuilder>(struct_builder.init(field), nested_fields_size);
-            }
-            default:
-                return nullptr;
-        }
-    }
-
     class ICapnProtoSerializer
     {
     public:
-        virtual std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * builder, size_t row_num) = 0;
-        virtual void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) = 0;
+        virtual void writeRow(
+            const ColumnPtr & column,
+            std::unique_ptr<FieldBuilder> & builder,
+            capnp::DynamicStruct::Builder & parent_struct_builder,
+            UInt32 slot_offset,
+            size_t row_num) = 0;
+
+        virtual void writeRow(
+            const ColumnPtr & column,
+            std::unique_ptr<FieldBuilder> & builder,
+            capnp::DynamicList::Builder & parent_list_builder,
+            UInt32 array_index,
+            size_t row_num) = 0;
+
+        virtual void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) = 0;
+
+        virtual void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) = 0;
 
         virtual ~ICapnProtoSerializer() = default;
     };
 
-    template <typename NumericType, bool is_bool_data_type, capnp::DynamicValue::Type capnp_dynamic_type>
+    template <typename CHNumericType, typename CapnProtoNumericType, bool convert_to_bool_on_read>
     class CapnProtoIntegerSerializer : public ICapnProtoSerializer
     {
     public:
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::INT)
-                return capnp::DynamicValue::Reader(column->getInt(row_num));
-            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::UINT)
-                return capnp::DynamicValue::Reader(column->getUInt(row_num));
-            return capnp::DynamicValue::Reader(column->getBool(row_num));
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            CapnProtoNumericType value = static_cast<CapnProtoNumericType>(assert_cast<const ColumnVector<CHNumericType> &>(*column).getElement(row_num));
+            builder_impl.setDataField<CapnProtoNumericType>(slot_offset, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            NumericType value;
-            if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::INT)
-                value = static_cast<NumericType>(reader.as<Int64>());
-            else if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::UINT)
-                value = static_cast<NumericType>(reader.as<UInt64>());
-            else if constexpr (capnp_dynamic_type == capnp::DynamicValue::Type::BOOL)
-                value = static_cast<NumericType>(reader.as<bool>());
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            CapnProtoNumericType value = static_cast<CapnProtoNumericType>(assert_cast<const ColumnVector<CHNumericType> &>(*column).getElement(row_num));
+            builder_impl.setDataElement<CapnProtoNumericType>(array_index, value);
+        }
 
-            if constexpr (is_bool_data_type)
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            CapnProtoNumericType value = reader_impl.getDataField<CapnProtoNumericType>(slot_offset);
+            if constexpr (convert_to_bool_on_read)
                 assert_cast<ColumnUInt8 &>(column).insertValue(static_cast<bool>(value));
             else
-                assert_cast<ColumnVector<NumericType> &>(column).insertValue(value);
+                assert_cast<ColumnVector<CHNumericType> &>(column).insertValue(static_cast<CHNumericType>(value));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            CapnProtoNumericType value = reader_impl.getDataElement<CapnProtoNumericType>(array_index);
+            if constexpr (convert_to_bool_on_read)
+                assert_cast<ColumnUInt8 &>(column).insertValue(static_cast<bool>(value));
+            else
+                assert_cast<ColumnVector<CHNumericType> &>(column).insertValue(static_cast<CHNumericType>(value));
         }
     };
 
-    template <typename NumericType, bool is_bool_data_type = false>
+    template <typename NumericType, bool convert_to_bool_on_read = false>
     std::unique_ptr<ICapnProtoSerializer> createIntegerSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
     {
         switch (capnp_type.which())
         {
-            case capnp::schema::Type::INT8: [[fallthrough]];
-            case capnp::schema::Type::INT16: [[fallthrough]];
-            case capnp::schema::Type::INT32: [[fallthrough]];
+            case capnp::schema::Type::INT8:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, Int8, convert_to_bool_on_read>>();
+            case capnp::schema::Type::INT16:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, Int16, convert_to_bool_on_read>>();
+            case capnp::schema::Type::INT32:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, Int32, convert_to_bool_on_read>>();
             case capnp::schema::Type::INT64:
-                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::INT>>();
-            case capnp::schema::Type::UINT8: [[fallthrough]];
-            case capnp::schema::Type::UINT16: [[fallthrough]];
-            case capnp::schema::Type::UINT32: [[fallthrough]];
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, Int64, convert_to_bool_on_read>>();
+            case capnp::schema::Type::UINT8:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, UInt8, convert_to_bool_on_read>>();
+            case capnp::schema::Type::UINT16:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, UInt16, convert_to_bool_on_read>>();
+            case capnp::schema::Type::UINT32:
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, UInt32, convert_to_bool_on_read>>();
             case capnp::schema::Type::UINT64:
-                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::UINT>>();
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, UInt64, convert_to_bool_on_read>>();
             case capnp::schema::Type::BOOL:
-                return std::make_unique<CapnProtoIntegerSerializer<NumericType, is_bool_data_type, capnp::DynamicValue::Type::BOOL>>();
+                return std::make_unique<CapnProtoIntegerSerializer<NumericType, bool, convert_to_bool_on_read>>();
             default:
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
     }
 
-    template <typename NumericType>
-    class CapnProtoBigIntegerSerializer : public ICapnProtoSerializer
-    {
-    public:
-        CapnProtoBigIntegerSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
-        {
-            if (!capnp_type.isData())
-                throwCannotConvert(data_type, column_name, capnp_type);
-        }
-
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
-        {
-            auto data = column->getDataAt(row_num);
-            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
-        {
-            auto value = reader.as<capnp::Data>();
-            if (value.size() != sizeof(NumericType))
-                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
-
-            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-        }
-
-    private:
-        DataTypePtr data_type;
-    };
-
-    template <typename FloatType>
+    template <typename CHFloatType, typename CapnProtoFloatType>
     class CapnProtoFloatSerializer : public ICapnProtoSerializer
     {
     public:
-        CapnProtoFloatSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            if (!capnp_type.isFloat32() && !capnp_type.isFloat64())
-                throwCannotConvert(data_type, column_name, capnp_type);
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            CapnProtoFloatType value = static_cast<CapnProtoFloatType>(assert_cast<const ColumnVector<CHFloatType> &>(*column).getElement(row_num));
+            builder_impl.setDataField<CapnProtoFloatType>(slot_offset, value);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(column->getFloat64(row_num));
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            CapnProtoFloatType value = static_cast<CapnProtoFloatType>(assert_cast<const ColumnVector<CHFloatType> &>(*column).getElement(row_num));
+            builder_impl.setDataElement<CapnProtoFloatType>(array_index, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            assert_cast<ColumnVector<FloatType> &>(column).insertValue(reader.as<FloatType>());
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            CapnProtoFloatType value = reader_impl.getDataField<CapnProtoFloatType>(slot_offset);
+            assert_cast<ColumnVector<CHFloatType> &>(column).insertValue(static_cast<CHFloatType>(value));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            CapnProtoFloatType value = reader_impl.getDataElement<CapnProtoFloatType>(array_index);
+            assert_cast<ColumnVector<CHFloatType> &>(column).insertValue(static_cast<CHFloatType>(value));
         }
     };
 
+    template <typename FloatType>
+    std::unique_ptr<ICapnProtoSerializer> createFloatSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+    {
+        switch (capnp_type.which())
+        {
+            case capnp::schema::Type::FLOAT32:
+                return std::make_unique<CapnProtoFloatSerializer<FloatType, Float32>>();
+            case capnp::schema::Type::FLOAT64:
+                return std::make_unique<CapnProtoFloatSerializer<FloatType, Float64>>();
+            default:
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+    }
+
     template <typename EnumType>
     class CapnProtoEnumSerializer : public ICapnProtoSerializer
     {
@@ -267,86 +270,90 @@ namespace
             }
             else
             {
-                auto names = enum_values.getSetOfAllNames(to_lower);
-                std::unordered_set<String> capn_enum_names;
-
-                for (auto enumerant : enumerants)
-                {
-                    String name = enumerant.getProto().getName();
-                    capn_enum_names.insert(to_lower ? boost::algorithm::to_lower_copy(name) : name);
-                }
-
-                if (names != capn_enum_names)
+                auto all_values = enum_values.getValues();
+                if (all_values.size() != enumerants.size())
                     throw Exception(
                         ErrorCodes::CAPN_PROTO_BAD_CAST,
                         "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum");
+
+                std::unordered_map<String, EnumType> ch_name_to_value;
+                for (auto & [name, value] : all_values)
+                    ch_name_to_value[to_lower ? boost::algorithm::to_lower_copy(name) : name] = value;
+
+                for (auto enumerant : enumerants)
+                {
+                    String capnp_name = enumerant.getProto().getName();
+                    UInt16 capnp_value = enumerant.getOrdinal();
+                    auto it = ch_name_to_value.find(to_lower ? boost::algorithm::to_lower_copy(capnp_name) : capnp_name);
+                    if (it == ch_name_to_value.end())
+                        throw Exception(
+                            ErrorCodes::CAPN_PROTO_BAD_CAST,
+                            "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum");
+
+                    ch_to_capnp_values[it->second] = capnp_value;
+                    capnp_to_ch_values[capnp_value] = it->second;
+                }
             }
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            const auto * enum_data_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
             EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
+            UInt16 capnp_value;
             if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
-                return capnp::DynamicValue::Reader(capnp::DynamicEnum(enum_schema, enum_value));
+                capnp_value = static_cast<UInt16>(enum_value);
+            else
+                capnp_value = ch_to_capnp_values[enum_value];
 
-            auto enum_name = enum_data_type->getNameForValue(enum_value);
-            for (const auto enumerant : enum_schema.getEnumerants())
-            {
-                if (compareEnumNames(String(enum_name), enumerant.getProto().getName(), enum_comparing_mode))
-                    return capnp::DynamicValue::Reader(capnp::DynamicEnum(enumerant));
-            }
-
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot convert ClickHouse Enum value to CapnProto Enum");
+            builder_impl.setDataField<UInt16>(slot_offset, capnp_value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto enum_value = reader.as<capnp::DynamicEnum>();
-            auto enumerant = *kj::_::readMaybe(enum_value.getEnumerant());
-            auto enum_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
-            DataTypePtr nested_type = std::make_shared<DataTypeNumber<EnumType>>();
-            switch (enum_comparing_mode)
-            {
-                case FormatSettings::CapnProtoEnumComparingMode::BY_VALUES:
-                {
-                    assert_cast<ColumnVector<EnumType> &>(column).insertValue(static_cast<EnumType>(enumerant.getOrdinal()));
-                    return;
-                }
-                case FormatSettings::CapnProtoEnumComparingMode::BY_NAMES:
-                {
-                    auto value = enum_type->getValue(String(enumerant.getProto().getName()));
-                    assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
-                    return;
-                }
-                case FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE:
-                {
-                    /// Find the same enum name case insensitive.
-                    String enum_name = enumerant.getProto().getName();
-                    for (auto & name : enum_type->getAllRegisteredNames())
-                    {
-                        if (compareEnumNames(name, enum_name, enum_comparing_mode))
-                        {
-                            assert_cast<ColumnVector<EnumType> &>(column).insertValue(enum_type->getValue(name));
-                            break;
-                        }
-                    }
-                    return;
-                }
-            }
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
+            UInt16 capnp_value;
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                capnp_value = static_cast<UInt16>(enum_value);
+            else
+                capnp_value = ch_to_capnp_values[enum_value];
+
+            builder_impl.setDataElement<UInt16>(array_index, capnp_value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            UInt16 capnp_value = reader_impl.getDataField<UInt16>(slot_offset);
+            EnumType value;
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                value = static_cast<EnumType>(capnp_value);
+            else
+                value = capnp_to_ch_values[capnp_value];
+            
+            assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            UInt16 capnp_value = reader_impl.getDataElement<UInt16>(array_index);
+            EnumType value;
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                value = static_cast<EnumType>(capnp_value);
+            else
+                value = capnp_to_ch_values[capnp_value];
+            
+            assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
         }
 
     private:
-        bool compareEnumNames(const String & first, const String & second, const FormatSettings::CapnProtoEnumComparingMode mode)
-        {
-            if (mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE)
-                return boost::algorithm::to_lower_copy(first) == boost::algorithm::to_lower_copy(second);
-            return first == second;
-        }
-
         DataTypePtr data_type;
         capnp::EnumSchema enum_schema;
         const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode;
+        std::unordered_map<EnumType, UInt16> ch_to_capnp_values;
+        std::unordered_map<UInt16, EnumType> capnp_to_ch_values;
     };
 
     class CapnProtoDateSerializer : public ICapnProtoSerializer
@@ -358,14 +365,32 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(column->getUInt(row_num));
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            UInt16 value = assert_cast<const ColumnDate &>(*column).getElement(row_num);
+            builder_impl.setDataField<UInt16>(slot_offset, value);
+        }
+        
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            UInt16 value = assert_cast<const ColumnDate &>(*column).getElement(row_num);
+            builder_impl.setDataElement<UInt16>(array_index, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            assert_cast<ColumnDate &>(column).insertValue(reader.as<UInt16>());
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            UInt16 value = reader_impl.getDataField<UInt16>(slot_offset);
+            assert_cast<ColumnDate &>(column).insertValue(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            UInt16 value = reader_impl.getDataElement<UInt16>(array_index);
+            assert_cast<ColumnDate &>(column).insertValue(value);
         }
     };
 
@@ -378,14 +403,32 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(column->getInt(row_num));
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            Int32 value = assert_cast<const ColumnDate32 &>(*column).getElement(row_num);
+            builder_impl.setDataField<Int32>(slot_offset, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            assert_cast<ColumnDate32 &>(column).insertValue(reader.as<Int32>());
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            Int32 value = assert_cast<const ColumnDate32 &>(*column).getElement(row_num);
+            builder_impl.setDataElement<Int32>(array_index, value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            Int32 value = reader_impl.getDataField<Int32>(slot_offset);
+            assert_cast<ColumnDate32 &>(column).insertValue(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            Int32 value = reader_impl.getDataElement<Int32>(array_index);
+            assert_cast<ColumnDate32 &>(column).insertValue(value);
         }
     };
 
@@ -398,14 +441,32 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(column->getInt(row_num));
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            UInt32 value = assert_cast<const ColumnDateTime &>(*column).getElement(row_num);
+            builder_impl.setDataField<UInt32>(slot_offset, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            assert_cast<ColumnDateTime &>(column).insertValue(reader.as<UInt32>());
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            UInt32 value = assert_cast<const ColumnDateTime &>(*column).getElement(row_num);
+            builder_impl.setDataElement<UInt32>(array_index, value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            UInt32 value = reader_impl.getDataField<UInt32>(slot_offset);
+            assert_cast<ColumnDateTime &>(column).insertValue(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            UInt32 value = reader_impl.getDataElement<UInt32>(array_index);
+            assert_cast<ColumnDateTime &>(column).insertValue(value);
         }
     };
 
@@ -418,14 +479,32 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(column->getInt(row_num));
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            Int64 value = assert_cast<const ColumnDateTime64 &>(*column).getElement(row_num);
+            builder_impl.setDataField<Int64>(slot_offset, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            assert_cast<ColumnDateTime64 &>(column).insertValue(reader.as<Int64>());
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            Int64 value = assert_cast<const ColumnDateTime64 &>(*column).getElement(row_num);
+            builder_impl.setDataElement<Int64>(array_index, value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            Int64 value = reader_impl.getDataField<Int64>(slot_offset);
+            assert_cast<ColumnDateTime64 &>(column).insertValue(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            Int64 value = reader_impl.getDataElement<Int64>(array_index);
+            assert_cast<ColumnDateTime64 &>(column).insertValue(value);
         }
     };
 
@@ -433,6 +512,8 @@ namespace
     class CapnProtoDecimalSerializer : public ICapnProtoSerializer
     {
     public:
+        using NativeType = typename DecimalType::NativeType;
+
         CapnProtoDecimalSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
         {
             auto which = WhichDataType(data_type);
@@ -440,37 +521,79 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(column->getInt(row_num));
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            DecimalType value = assert_cast<const ColumnDecimal<DecimalType> &>(*column).getElement(row_num);
+            builder_impl.setDataField<NativeType>(slot_offset, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(reader.as<typename DecimalType::NativeType>());
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            DecimalType value = assert_cast<const ColumnDecimal<DecimalType> &>(*column).getElement(row_num);
+            builder_impl.setDataElement<NativeType>(array_index, value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            NativeType value = reader_impl.getDataField<NativeType>(slot_offset);
+            assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            NativeType value = reader_impl.getDataElement<NativeType>(array_index);
+            assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(value);
         }
     };
 
-    template <typename DecimalType>
-    class CapnProtoBigDecimalSerializer : public ICapnProtoSerializer
+    template <typename T>
+    class CapnProtoFixedSizeRawDataSerializer : public ICapnProtoSerializer
     {
+    private:
+        static constexpr size_t value_size = sizeof(T);
+
     public:
-        CapnProtoBigDecimalSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
+        CapnProtoFixedSizeRawDataSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
         {
             if (!capnp_type.isData())
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
             auto data = column->getDataAt(row_num);
-            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+            capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+            builder_impl.getPointerField(slot_offset).template setBlob<capnp::Data>(value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
         {
-            auto value = reader.as<capnp::Data>();
-            if (value.size() != sizeof(DecimalType))
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            auto data = column->getDataAt(row_num);
+            capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+            builder_impl.getPointerElement(array_index).setBlob<capnp::Data>(value);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            capnp::Data::Reader value = reader_impl.getPointerField(slot_offset).template getBlob<capnp::Data>(nullptr, 0);
+            if (value.size() != value_size)
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
+
+            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            capnp::Data::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0);
+            if (value.size() != value_size)
                 throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
 
             column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
@@ -484,39 +607,73 @@ namespace
     class CapnProtoStringSerializer : public ICapnProtoSerializer
     {
     public:
-        CapnProtoStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
+        CapnProtoStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
         {
             if (!capnp_type.isData() && !capnp_type.isText())
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
             auto data = column->getDataAt(row_num);
-
-            if constexpr (is_binary)
-                return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
-
-            /// For type TEXT data must be null-terminated, but in String column we always have 0 byte at the end of each value.
-            return capnp::DynamicValue::Reader(capnp::Text::Reader(data.data, data.size));
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
-        {
             if constexpr (is_binary)
             {
-                auto value = reader.as<capnp::Data>();
+                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+                builder_impl.getPointerField(slot_offset).setBlob<capnp::Data>(value);
+            }
+            else
+            {
+                capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
+                builder_impl.getPointerField(slot_offset).setBlob<capnp::Text>(value);
+            }
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
+        {
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            auto data = column->getDataAt(row_num);
+            if constexpr (is_binary)
+            {
+                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+                builder_impl.getPointerElement(array_index).setBlob<capnp::Data>(value);
+            }
+            else
+            {
+                capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
+                builder_impl.getPointerElement(array_index).setBlob<capnp::Text>(value);
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            if constexpr (is_binary)
+            {
+                capnp::Data::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Data>(nullptr, 0);
                 column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
             }
             else
             {
-                auto value = reader.as<capnp::Text>();
+                capnp::Text::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Text>(nullptr, 0);
                 column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
             }
         }
 
-    private:
-        capnp::Type capnp_type;
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            if constexpr (is_binary)
+            {
+                capnp::Data::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0);
+                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+            else
+            {
+                capnp::Text::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Text>(nullptr, 0);
+                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+        }
     };
 
     template <bool is_binary>
@@ -529,29 +686,71 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
             auto data = column->getDataAt(row_num);
             if constexpr (is_binary)
-                return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
-
-            if (data.data[data.size - 1] == 0)
-                return capnp::DynamicValue::Reader(capnp::Text::Reader(reinterpret_cast<const char *>(data.data), data.size));
-
-            /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
-            /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
-            /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
-            /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
-            tmp_string = data.toString();
-            return capnp::DynamicValue::Reader(capnp::Text::Reader(reinterpret_cast<const char *>(tmp_string.data()), tmp_string.size()));
+            {
+                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+                builder_impl.getPointerField(slot_offset).setBlob<capnp::Data>(value);
+            }
+            else
+            {
+                if (data.data[data.size - 1] == 0)
+                {
+                    capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
+                    builder_impl.getPointerField(slot_offset).setBlob<capnp::Text>(value);
+                }
+                else
+                {
+                    /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
+                    /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
+                    /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
+                    /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
+                    tmp_string = data.toString();
+                    capnp::Text::Reader value = capnp::Text::Reader(tmp_string.data(), tmp_string.size());
+                    builder_impl.getPointerField(slot_offset).setBlob<capnp::Text>(value);
+                }
+            }
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
         {
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            auto data = column->getDataAt(row_num);
+            if constexpr (is_binary)
+            {
+                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+                builder_impl.getPointerElement(array_index).setBlob<capnp::Data>(value);
+            }
+            else
+            {
+                if (data.data[data.size - 1] == 0)
+                {
+                    capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
+                    builder_impl.getPointerElement(array_index).setBlob<capnp::Text>(value);
+                }
+                else
+                {
+                    /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
+                    /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
+                    /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
+                    /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
+                    tmp_string = data.toString();
+                    capnp::Text::Reader value = capnp::Text::Reader(tmp_string.data(), tmp_string.size());
+                    builder_impl.getPointerElement(array_index).setBlob<capnp::Text>(value);
+                }
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
             auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
             if constexpr (is_binary)
             {
-                auto value = reader.as<capnp::Data>();
+                capnp::Data::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Data>(nullptr, 0);
                 if (value.size() > fixed_string_column.getN())
                     throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
 
@@ -559,7 +758,29 @@ namespace
             }
             else
             {
-                auto value = reader.as<capnp::Text>();
+                capnp::Text::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Text>(nullptr, 0);
+                if (value.size() > fixed_string_column.getN())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
+
+                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
+            if constexpr (is_binary)
+            {
+                capnp::Data::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0);
+                if (value.size() > fixed_string_column.getN())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
+
+                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            }
+            else
+            {
+                capnp::Text::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Text>(nullptr, 0);
                 if (value.size() > fixed_string_column.getN())
                     throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
 
@@ -581,64 +802,32 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            return capnp::DynamicValue::Reader(assert_cast<const ColumnIPv4 &>(*column).getElement(row_num).toUnderType());
+            auto & builder_impl = parent_struct_builder.getBuilderImpl();
+            UInt32 value = assert_cast<const ColumnIPv4 &>(*column).getElement(row_num);
+            builder_impl.setDataField<UInt32>(slot_offset, value);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(reader.as<UInt32>()));
-        }
-    };
-
-    class CapnProtoIPv6Serializer : public ICapnProtoSerializer
-    {
-    public:
-        CapnProtoIPv6Serializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
-        {
-            if (!capnp_type.isData())
-                throwCannotConvert(data_type, column_name, capnp_type);
+            auto & builder_impl = parent_list_builder.getBuilderImpl();
+            UInt32 value = assert_cast<const ColumnIPv4 &>(*column).getElement(row_num);
+            builder_impl.setDataElement<UInt32>(array_index, value);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            auto data = column->getDataAt(row_num);
-            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            UInt32 value = reader_impl.getDataField<UInt32>(slot_offset);
+            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(value));
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            auto value = reader.as<capnp::Data>();
-            if (value.size() != sizeof(IPv6))
-                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of IPv6 value: {}", value.size());
-
-            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-        }
-    };
-
-    class CapnProtoUUIDSerializer : public ICapnProtoSerializer
-    {
-    public:
-        CapnProtoUUIDSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
-        {
-            if (!capnp_type.isData())
-                throwCannotConvert(data_type, column_name, capnp_type);
-        }
-
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder *, size_t row_num) override
-        {
-            auto data = column->getDataAt(row_num);
-            return capnp::DynamicValue::Reader(capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size));
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
-        {
-            auto value = reader.as<capnp::Data>();
-            if (value.size() != sizeof(UUID))
-                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of UUID value: {}", value.size());
-
-            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            UInt32 value = reader_impl.getDataElement<UInt32>(array_index);
+            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(value));
         }
     };
 
@@ -652,19 +841,35 @@ namespace
             nested_serializer = createSerializer(assert_cast<const DataTypeLowCardinality &>(*data_type).getDictionaryType(), column_name, capnp_type, settings);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
             const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
             size_t index = low_cardinality_column.getIndexAt(row_num);
             const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
-            return nested_serializer->writeRow(dict_column, field_builder, index);
+            nested_serializer->writeRow(dict_column, field_builder, parent_struct_builder, slot_offset, index);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
+            size_t index = low_cardinality_column.getIndexAt(row_num);
+            const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
+            nested_serializer->writeRow(dict_column, field_builder, parent_list_builder, array_index, index);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
             auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
             auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
-            nested_serializer->readRow(*tmp_column, reader);
+            nested_serializer->readRow(*tmp_column, parent_struct_reader, slot_offset);
+            low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
+            auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
+            nested_serializer->readRow(*tmp_column, parent_list_reader, array_index);
             low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
         }
 
@@ -685,7 +890,10 @@ namespace
                     getCapnProtoFullTypeName(capnp_type));
 
             /// Check that struct is a named union of type VOID and one arbitrary type.
-            auto struct_schema = capnp_type.asStruct();
+            struct_schema = capnp_type.asStruct();
+            auto node = struct_schema.getProto().getStruct();
+            struct_size = capnp::_::StructSize(node.getDataWordCount(), node.getPointerCount());
+            discriminant_offset = node.getDiscriminantOffset();
             if (!checkIfStructIsNamedUnion(struct_schema))
                 throw Exception(
                     ErrorCodes::CAPN_PROTO_BAD_CAST,
@@ -706,23 +914,18 @@ namespace
             auto first = union_fields[0];
             auto second = union_fields[1];
             auto nested_type = assert_cast<const DataTypeNullable *>(data_type.get())->getNestedType();
+            nested_slot_offset = first.getProto().getSlot().getOffset(); /// Both fields have the same offset.
             if (first.getType().isVoid())
             {
-                null_field = first;
-                nested_field = second;
-                nested_capnp_type = second.getType();
-                if (nested_capnp_type.isStruct())
-                    nested_fields_size = nested_capnp_type.asStruct().getFields().size();
-                nested_serializer = createSerializer(nested_type, column_name, nested_capnp_type, settings);
+                nested_serializer = createSerializer(nested_type, column_name, second.getType(), settings);
+                null_discriminant = 0;
+                nested_discriminant = 1;
             }
             else if (second.getType().isVoid())
             {
-                null_field = second;
-                nested_field = first;
-                nested_capnp_type = first.getType();
-                if (nested_capnp_type.isStruct())
-                    nested_fields_size = nested_capnp_type.asStruct().getFields().size();
-                nested_serializer = createSerializer(nested_type, column_name, nested_capnp_type, settings);
+                nested_serializer = createSerializer(nested_type, column_name, first.getType(), settings);
+                null_discriminant = 1;
+                nested_discriminant = 0;
             }
             else
                 throw Exception(
@@ -733,50 +936,102 @@ namespace
                     getCapnProtoFullTypeName(capnp_type));
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            assert(field_builder);
+            if (!field_builder)
+            {
+                auto builder_impl = parent_struct_builder.getBuilderImpl();
+                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getPointerField(slot_offset).initStruct(struct_size));
+                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
+            }
+
             auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+
             const auto & nullable_column = assert_cast<const ColumnNullable &>(*column);
             if (nullable_column.isNullAt(row_num))
             {
-                struct_builder.impl.set(null_field, capnp::Void());
+                auto struct_builder_impl = struct_builder.impl.getBuilderImpl();
+                struct_builder_impl.setDataField<uint16_t>(discriminant_offset, null_discriminant);
+                struct_builder_impl.setDataField<capnp::Void>(nested_slot_offset, capnp::Void());
             }
             else
             {
-                struct_builder.impl.clear(nested_field);
                 const auto & nested_column = nullable_column.getNestedColumnPtr();
-                auto nested_field_builder = initStructFieldBuilderIfNeeded(nested_column, row_num, struct_builder.impl, nested_field, nested_capnp_type, nested_fields_size);
-                auto value = nested_serializer->writeRow(nested_column, nested_field_builder.get(), row_num);
-                if (value)
-                    struct_builder.impl.set(nested_field, *value);
+                struct_builder.impl.getBuilderImpl().setDataField<uint16_t>(discriminant_offset, nested_discriminant);
+                nested_serializer->writeRow(nested_column, struct_builder.field_builders[0], struct_builder.impl, nested_slot_offset, row_num);
             }
-
-            return std::nullopt;
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            if (!field_builder)
+            {
+                auto builder_impl = parent_list_builder.getBuilderImpl();
+                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getStructElement(array_index));
+                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
+            }
+
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+
+            const auto & nullable_column = assert_cast<const ColumnNullable &>(*column);
+            if (nullable_column.isNullAt(row_num))
+            {
+                auto struct_builder_impl = struct_builder.impl.getBuilderImpl();
+                struct_builder_impl.setDataField<uint16_t>(discriminant_offset, null_discriminant);
+                struct_builder_impl.setDataField<capnp::Void>(nested_slot_offset, capnp::Void());
+            }
+            else
+            {
+                const auto & nested_column = nullable_column.getNestedColumnPtr();
+                struct_builder.impl.getBuilderImpl().setDataField<uint16_t>(discriminant_offset, nested_discriminant);
+                nested_serializer->writeRow(nested_column, struct_builder.field_builders[0], struct_builder.impl, nested_slot_offset, row_num);
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            auto struct_reader = reader.as<capnp::DynamicStruct>();
             auto & nullable_column = assert_cast<ColumnNullable &>(column);
-            auto field = *kj::_::readMaybe(struct_reader.which());
-            if (field.getType().isVoid())
+            auto reader_impl = parent_struct_reader.getReaderImpl();
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getPointerField(slot_offset).getStruct(nullptr));
+
+            auto discriminant = struct_reader.getReaderImpl().getDataField<uint16_t>(discriminant_offset);
+
+            if (discriminant == null_discriminant)
                 nullable_column.insertDefault();
             else
             {
                 auto & nested_column = nullable_column.getNestedColumn();
-                auto nested_reader = struct_reader.get(field);
-                nested_serializer->readRow(nested_column, nested_reader);
+                nested_serializer->readRow(nested_column, struct_reader, nested_slot_offset);
+                nullable_column.getNullMapData().push_back(0);
+            }
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto & nullable_column = assert_cast<ColumnNullable &>(column);
+            auto reader_impl = parent_list_reader.getReaderImpl();
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getStructElement(array_index));
+
+            auto discriminant = struct_reader.getReaderImpl().getDataField<uint16_t>(discriminant_offset);
+
+            if (discriminant == null_discriminant)
+                nullable_column.insertDefault();
+            else
+            {
+                auto & nested_column = nullable_column.getNestedColumn();
+                nested_serializer->readRow(nested_column, struct_reader, nested_slot_offset);
                 nullable_column.getNullMapData().push_back(0);
             }
         }
 
     private:
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
-        capnp::StructSchema::Field null_field;
-        capnp::StructSchema::Field nested_field;
-        size_t nested_fields_size = 0;
-        capnp::Type nested_capnp_type;
+        capnp::StructSchema struct_schema;
+        capnp::_::StructSize struct_size;
+        UInt32 discriminant_offset;
+        UInt16 null_discriminant;
+        UInt16 nested_discriminant;
+        UInt32 nested_slot_offset;
     };
 
     class CapnProtoArraySerializer : public ICapnProtoSerializer
@@ -788,67 +1043,102 @@ namespace
                 throwCannotConvert(data_type, column_name, capnp_type);
 
             auto nested_type = assert_cast<const DataTypeArray *>(data_type.get())->getNestedType();
-            element_type = capnp_type.asList().getElementType();
+            list_schema = capnp_type.asList();
+            auto element_type = list_schema.getElementType();
+            element_size = capnp::elementSizeFor(element_type.which());
             if (element_type.isStruct())
-                element_struct_fields = element_type.asStruct().getFields().size();
+            {
+                element_is_struct = true;
+                auto node = element_type.asStruct().getProto().getStruct();
+                element_struct_size = capnp::_::StructSize(node.getDataWordCount(), node.getPointerCount());
+            }
+
             nested_serializer = createSerializer(nested_type, column_name, capnp_type.asList().getElementType(), settings);
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            assert(field_builder);
-            auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
             const auto * array_column = assert_cast<const ColumnArray *>(column.get());
             const auto & nested_column = array_column->getDataPtr();
             const auto & offsets = array_column->getOffsets();
             auto offset = offsets[row_num - 1];
-            size_t size = offsets[row_num] - offset;
-            bool need_nested_builders = list_builder.nested_builders.empty();
-            for (unsigned i = 0; i != static_cast<unsigned>(size); ++i)
-            {
-                if (need_nested_builders)
-                {
-                    /// For nested lists we need to initialize nested list builder.
-                    if (element_type.isList())
-                    {
-                        const auto & nested_offset = checkAndGetColumn<ColumnArray>(*nested_column)->getOffsets();
-                        size_t nested_array_size = nested_offset[offset + i] - nested_offset[offset + i - 1];
-                        list_builder.nested_builders.emplace_back(std::make_unique<ListBuilder>(list_builder.impl.init(i, static_cast<unsigned>(nested_array_size))));
-                    }
-                    else if (element_type.isStruct())
-                    {
-                        list_builder.nested_builders.emplace_back(std::make_unique<StructBuilder>(list_builder.impl[i], element_struct_fields));
-                    }
-                    else
-                    {
-                        list_builder.nested_builders.emplace_back();
-                    }
-                }
+            UInt32 size = static_cast<UInt32>(offsets[row_num] - offset);
 
-                auto value = nested_serializer->writeRow(nested_column, list_builder.nested_builders[i].get(), offset + i);
-                if (value)
-                    list_builder.impl.set(i, *value);
+            if (!field_builder)
+            {
+                auto builder_impl = parent_struct_builder.getBuilderImpl();
+                capnp::DynamicList::Builder list_builder_impl;
+                if (element_is_struct)
+                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerField(slot_offset).initStructList(size, element_struct_size));
+                else
+                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerField(slot_offset).initList(element_size, size));
+                field_builder = std::make_unique<ListBuilder>(std::move(list_builder_impl), size);
             }
 
-            return std::nullopt;
+            auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
+            for (UInt32 i = 0; i != size; ++i)
+                nested_serializer->writeRow(nested_column, list_builder.nested_builders[i], list_builder.impl, i, offset + i);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto list_reader = reader.as<capnp::DynamicList>();
+            const auto * array_column = assert_cast<const ColumnArray *>(column.get());
+            const auto & nested_column = array_column->getDataPtr();
+            const auto & offsets = array_column->getOffsets();
+            auto offset = offsets[row_num - 1];
+            UInt32 size = static_cast<UInt32>(offsets[row_num] - offset);
+
+            if (!field_builder)
+            {
+                auto builder_impl = parent_list_builder.getBuilderImpl();
+                capnp::DynamicList::Builder list_builder_impl;
+                if (element_is_struct)
+                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerElement(array_index).initStructList(size, element_struct_size));
+                else
+                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerElement(array_index).initList(element_size, size));
+                field_builder = std::make_unique<ListBuilder>(std::move(list_builder_impl), size);
+            }
+
+            auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
+            for (UInt32 i = 0; i != size; ++i)
+                nested_serializer->writeRow(nested_column, list_builder.nested_builders[i], list_builder.impl, i, offset + i);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            const auto & reader_impl = parent_struct_reader.getReaderImpl();
+            auto list_reader = capnp::DynamicList::Reader(list_schema, reader_impl.getPointerField(slot_offset).getList(element_size, nullptr));
+            UInt32 size = list_reader.size();
             auto & column_array = assert_cast<ColumnArray &>(column);
             auto & offsets = column_array.getOffsets();
             offsets.push_back(offsets.back() + list_reader.size());
 
             auto & nested_column = column_array.getData();
-            for (const auto & nested_reader : list_reader)
-                nested_serializer->readRow(nested_column, nested_reader);
+            for (UInt32 i = 0; i != size; ++i)
+                nested_serializer->readRow(nested_column, list_reader, i);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            const auto & reader_impl = parent_list_reader.getReaderImpl();
+            auto list_reader = capnp::DynamicList::Reader(list_schema, reader_impl.getPointerElement(array_index).getList(element_size, nullptr));
+            UInt32 size = list_reader.size();
+            auto & column_array = assert_cast<ColumnArray &>(column);
+            auto & offsets = column_array.getOffsets();
+            offsets.push_back(offsets.back() + list_reader.size());
+
+            auto & nested_column = column_array.getData();
+            for (UInt32 i = 0; i != size; ++i)
+                nested_serializer->readRow(nested_column, list_reader, i);
         }
 
     private:
+        capnp::ListSchema list_schema;
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
-        capnp::Type element_type;
-        size_t element_struct_fields;
+        capnp::ElementSize element_size;
+        capnp::_::StructSize element_struct_size;
+        bool element_is_struct = false;
+
     };
 
     class CapnProtoMapSerializer : public ICapnProtoSerializer
@@ -869,7 +1159,9 @@ namespace
             if (!capnp_type.isStruct())
                 throwCannotConvert(data_type, column_name, capnp_type);
 
-            auto struct_schema = capnp_type.asStruct();
+            struct_schema = capnp_type.asStruct();
+            auto node = struct_schema.getProto().getStruct();
+            struct_size = capnp::_::StructSize(node.getDataWordCount(), node.getPointerCount());
 
             if (checkIfStructContainsUnnamedUnion(struct_schema))
                 throw Exception(
@@ -921,43 +1213,70 @@ namespace
             DataTypes types = {map_type.getKeyType(), map_type.getValueType()};
             Names names = {"key", "value"};
             auto entries_type = std::make_shared<DataTypeArray>(std::make_shared<DataTypeTuple>(types, names));
-            entries_field = struct_schema.getFields()[0];
-            entries_capnp_type = entries_field.getType();
             nested_serializer = createSerializer(entries_type, column_name, field_type, settings);
+            entries_slot_offset = struct_schema.getFields()[0].getProto().getSlot().getOffset();
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * field_builder, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            assert(field_builder);
+            if (!field_builder)
+            {
+                auto builder_impl = parent_struct_builder.getBuilderImpl();
+                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getPointerField(slot_offset).initStruct(struct_size));
+                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
+            }
+
             auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
             const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
-            auto entries_builder = initStructFieldBuilderIfNeeded(entries_column, row_num, struct_builder.impl, entries_field, entries_capnp_type, 0);
-            nested_serializer->writeRow(entries_column, entries_builder.get(), row_num);
-            return std::nullopt;
+            nested_serializer->writeRow(entries_column, struct_builder.field_builders[0], struct_builder.impl, entries_slot_offset, row_num);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            if (!field_builder)
+            {
+                auto builder_impl = parent_list_builder.getBuilderImpl();
+                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getStructElement(array_index));
+                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
+            }
+
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
+            nested_serializer->writeRow(entries_column, struct_builder.field_builders[0], struct_builder.impl, entries_slot_offset, row_num);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            auto reader_impl = parent_struct_reader.getReaderImpl();
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getPointerField(slot_offset).getStruct(nullptr));
             auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
-            nested_serializer->readRow(entries_column, struct_reader.get(entries_field));
+            nested_serializer->readRow(entries_column, struct_reader, entries_slot_offset);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto reader_impl = parent_list_reader.getReaderImpl();
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getStructElement(array_index));
+            auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
+            nested_serializer->readRow(entries_column, struct_reader, entries_slot_offset);
         }
 
     private:
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
-        capnp::StructSchema::Field entries_field;
-        capnp::Type entries_capnp_type;
+        capnp::StructSchema struct_schema;
+        capnp::_::StructSize struct_size;
+        UInt32 entries_slot_offset;
     };
 
     class CapnProtoStructureSerializer : public ICapnProtoSerializer
     {
     public:
-        CapnProtoStructureSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        CapnProtoStructureSerializer(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings) : struct_schema(schema)
         {
             if (checkIfStructIsNamedUnion(schema) || checkIfStructContainsUnnamedUnion(schema))
                 throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Root CapnProto Struct cannot be named union/struct with unnamed union");
 
-            initialize(data_types, names, schema, settings);
+            initialize(data_types, names, settings);
         }
 
         CapnProtoStructureSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
@@ -965,7 +1284,7 @@ namespace
             if (!capnp_type.isStruct())
                 throwCannotConvert(data_type, column_name, capnp_type);
 
-            auto struct_schema = capnp_type.asStruct();
+            struct_schema = capnp_type.asStruct();
 
             if (checkIfStructIsNamedUnion(struct_schema) || checkIfStructContainsUnnamedUnion(struct_schema))
                 throw Exception(
@@ -1002,7 +1321,7 @@ namespace
 
             try
             {
-                initialize(nested_types, nested_names, struct_schema, settings);
+                initialize(nested_types, nested_names, settings);
             }
             catch (Exception & e)
             {
@@ -1011,77 +1330,118 @@ namespace
             }
         }
 
-        std::optional<capnp::DynamicValue::Reader> writeRow(const ColumnPtr & column, FieldBuilder * builder, size_t row_num) override
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            assert(builder);
-            auto & struct_builder = assert_cast<StructBuilder &>(*builder);
+            if (!field_builder)
+            {
+                auto builder_impl = parent_struct_builder.getBuilderImpl();
+                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getPointerField(slot_offset).initStruct(struct_size));
+                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), fields_count);
+            }
+
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
             if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
-                writeRow(tuple_column->getColumnsCopy(), struct_builder, row_num);
+            {
+                const auto & columns = tuple_column->getColumns();
+                for (size_t i = 0; i != columns.size(); ++i)
+                    fields_serializers[i]->writeRow(columns[i], struct_builder.field_builders[fields_indexes[i]], struct_builder.impl, fields_offsets[i], row_num);
+            }
             else
-                writeRow(Columns{column}, struct_builder, row_num);
-            return std::nullopt;
+            {
+                fields_serializers[0]->writeRow(column, struct_builder.field_builders[fields_indexes[0]], struct_builder.impl, fields_offsets[0], row_num);
+            }
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            if (!field_builder)
+            {
+                auto builder_impl = parent_list_builder.getBuilderImpl();
+                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getStructElement(array_index));
+                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), fields_count);
+            }
+
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+            {
+                const auto & columns = tuple_column->getColumns();
+                for (size_t i = 0; i != columns.size(); ++i)
+                    fields_serializers[i]->writeRow(columns[i], struct_builder.field_builders[fields_indexes[i]], struct_builder.impl, fields_offsets[i], row_num);
+            }
+            else
+            {
+                fields_serializers[0]->writeRow(column, struct_builder.field_builders[fields_indexes[0]], struct_builder.impl, fields_offsets[0], row_num);
+            }
         }
 
         void writeRow(const Columns & columns, StructBuilder & struct_builder, size_t row_num)
         {
             for (size_t i = 0; i != columns.size(); ++i)
-            {
-                const auto & field = fields[i];
-                size_t field_index = field.getIndex();
-                if (likely(!struct_builder.field_builders[field_index]))
-                    struct_builder.field_builders[field_index] = initStructFieldBuilderIfNeeded(
-                        columns[i], row_num, struct_builder.impl, field, fields_types[i], nested_field_sizes[i]);
-
-                auto value = field_serializers[i]->writeRow(columns[i], struct_builder.field_builders[field_index].get(), row_num);
-                if (value)
-                    struct_builder.impl.set(field, *value);
-            }
+                fields_serializers[i]->writeRow(columns[i], struct_builder.field_builders[fields_indexes[i]], struct_builder.impl, fields_offsets[i], row_num);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicValue::Reader & reader) override
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            auto struct_reader = reader.as<capnp::DynamicStruct>();
+            auto reader_impl = parent_struct_reader.getReaderImpl();
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getPointerField(slot_offset).getStruct(nullptr));
             if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
             {
                 for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
-                    field_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader.get(fields[i]));
+                    fields_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader, fields_offsets[i]);
             }
             else
-                field_serializers[0]->readRow(column, struct_reader.get(fields[0]));
+                fields_serializers[0]->readRow(column, struct_reader, fields_offsets[0]);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto reader_impl = parent_list_reader.getReaderImpl();
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getStructElement(array_index));
+            if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
+            {
+                for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
+                    fields_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader, fields_offsets[i]);
+            }
+            else
+                fields_serializers[0]->readRow(column, struct_reader, fields_offsets[0]);
         }
 
         void readRow(MutableColumns & columns, const capnp::DynamicStruct::Reader & reader)
         {
             for (size_t i = 0; i != columns.size(); ++i)
-                field_serializers[i]->readRow(*columns[i], reader.get(fields[i]));
+                fields_serializers[i]->readRow(*columns[i], reader, fields_offsets[i]);
         }
 
     private:
-        void initialize(const DataTypes & data_types, const Names & names, const capnp::StructSchema & schema, const FormatSettings::CapnProto & settings)
+        void initialize(const DataTypes & data_types, const Names & names, const FormatSettings::CapnProto & settings)
         {
-            field_serializers.reserve(data_types.size());
-            fields.reserve(data_types.size());
-            fields_types.reserve(data_types.size());
-            nested_field_sizes.reserve(data_types.size());
+            auto node = struct_schema.getProto().getStruct();
+            struct_size = capnp::_::StructSize(node.getDataWordCount(), node.getPointerCount());
+            fields_count = struct_schema.getFields().size();
+            fields_serializers.reserve(data_types.size());
+            fields_offsets.reserve(data_types.size());
+            fields_indexes.reserve(data_types.size());
             for (size_t i = 0; i != data_types.size(); ++i)
             {
                 auto [field_name, _] = splitFieldName(names[i]);
-                auto field = findFieldByName(schema, field_name);
+                auto field = findFieldByName(struct_schema, field_name);
                 if (!field)
                     throw Exception(ErrorCodes::THERE_IS_NO_COLUMN, "Capnproto schema doesn't contain field with name {}", field_name);
 
-                fields.push_back(*field);
                 auto capnp_type = field->getType();
-                fields_types.push_back(capnp_type);
-                nested_field_sizes.push_back(capnp_type.isStruct() ? capnp_type.asStruct().getFields().size() : 0);
-                field_serializers.push_back(createSerializer(data_types[i], names[i], capnp_type, settings));
+                fields_serializers.push_back(createSerializer(data_types[i], names[i], capnp_type, settings));
+                fields_offsets.push_back(field->getProto().getSlot().getOffset());
+                fields_indexes.push_back(field->getIndex());
             }
         }
 
-        std::vector<std::unique_ptr<ICapnProtoSerializer>> field_serializers;
-        std::vector<capnp::StructSchema::Field> fields;
-        std::vector<size_t> nested_field_sizes;
-        std::vector<capnp::Type> fields_types;
+        capnp::StructSchema struct_schema;
+        capnp::_::StructSize struct_size;
+        size_t fields_count;
+        std::vector<std::unique_ptr<ICapnProtoSerializer>> fields_serializers;
+        std::vector<UInt32> fields_offsets;
+        std::vector<size_t> fields_indexes;
+
     };
 
     std::unique_ptr<ICapnProtoSerializer> createSerializer(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings)
@@ -1116,17 +1476,17 @@ namespace
             case TypeIndex::UInt64:
                 return createIntegerSerializer<UInt64>(type, name, capnp_type);
             case TypeIndex::Int128:
-                return std::make_unique<CapnProtoBigIntegerSerializer<Int128>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<Int128>>(type, name, capnp_type);
             case TypeIndex::UInt128:
-                return std::make_unique<CapnProtoBigIntegerSerializer<UInt128>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<UInt128>>(type, name, capnp_type);
             case TypeIndex::Int256:
-                return std::make_unique<CapnProtoBigIntegerSerializer<Int256>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<Int256>>(type, name, capnp_type);
             case TypeIndex::UInt256:
-                return std::make_unique<CapnProtoBigIntegerSerializer<UInt256>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<UInt256>>(type, name, capnp_type);
             case TypeIndex::Float32:
-                return std::make_unique<CapnProtoFloatSerializer<Float32>>(type, name, capnp_type);
+                return createFloatSerializer<Float32>(type, name, capnp_type);
             case TypeIndex::Float64:
-                return std::make_unique<CapnProtoFloatSerializer<Float64>>(type, name, capnp_type);
+                return createFloatSerializer<Float64>(type, name, capnp_type);
             case TypeIndex::Date:
                 return std::make_unique<CapnProtoDateSerializer>(type, name, capnp_type);
             case TypeIndex::Date32:
@@ -1140,15 +1500,15 @@ namespace
             case TypeIndex::Decimal64:
                 return std::make_unique<CapnProtoDecimalSerializer<Decimal64>>(type, name, capnp_type);
             case TypeIndex::Decimal128:
-                return std::make_unique<CapnProtoBigDecimalSerializer<Decimal128>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<Decimal128>>(type, name, capnp_type);
             case TypeIndex::Decimal256:
-                return std::make_unique<CapnProtoBigDecimalSerializer<Decimal256>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<Decimal256>>(type, name, capnp_type);
             case TypeIndex::IPv4:
                 return std::make_unique<CapnProtoIPv4Serializer>(type, name, capnp_type);
             case TypeIndex::IPv6:
-                return std::make_unique<CapnProtoIPv6Serializer>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<IPv6>>(type, name, capnp_type);
             case TypeIndex::UUID:
-                return std::make_unique<CapnProtoUUIDSerializer>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedSizeRawDataSerializer<UUID>>(type, name, capnp_type);
             case TypeIndex::Enum8:
                 return std::make_unique<CapnProtoEnumSerializer<Int8>>(type, name, capnp_type, settings.enum_comparing_mode);
             case TypeIndex::Enum16:
diff --git a/src/Formats/CapnProtoSerializer.h b/src/Formats/CapnProtoSerializer.h
index 692f5e5301f..5bdd1a0e554 100644
--- a/src/Formats/CapnProtoSerializer.h
+++ b/src/Formats/CapnProtoSerializer.h
@@ -4,6 +4,7 @@
 
 #include <Core/Block.h>
 #include <capnp/dynamic.h>
+#include <Formats/FormatSettings.h>
 
 namespace DB
 {

From 36e8f13242edfd83e3650369b6b71bc9e8fc2e64 Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Thu, 25 May 2023 20:10:02 +0000
Subject: [PATCH 135/722] Added docs for feature

---
 docs/en/operations/settings/settings.md       | 26 +++++++++++++++++++
 docs/en/sql-reference/table-functions/file.md |  5 ++--
 docs/ru/operations/settings/settings.md       | 23 ++++++++++++++++
 docs/ru/sql-reference/table-functions/file.md |  1 +
 4 files changed, 53 insertions(+), 2 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 2239084a429..df9e8eb2fe2 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4200,6 +4200,32 @@ Possible values:
 
 Default value: `false`.
 
+## rename_files_after_processing
+
+- **Type:** String
+
+- **Default value:** Empty string
+
+This setting allows to specify renaming pattern for files processed by `file` table function. When option is set, all files read by `file` table function will be renamed according to specified pattern with placeholders, only if files processing was successful.
+
+### Placeholders
+
+- `%f` — Original filename without extension (e.g., "sample").
+- `%e` — Original file extension with dot (e.g., ".csv").
+- `%t` — Timestamp (in microseconds).
+- `%%` — Percentage sign ("%").
+
+### Example
+- Option: `--rename_files_after_processing="processed_%f_%t%e"`
+
+- Query: `SELECT * FROM file('sample.csv')`
+
+
+If reading `sample.csv` is successful, file will be renamed to `processed_sample_1683473210851438.csv`
+
+
+
+
 ## function_json_value_return_type_allow_complex
 
 Control whether allow to return complex type (such as: struct, array, map) for json_value function.
diff --git a/docs/en/sql-reference/table-functions/file.md b/docs/en/sql-reference/table-functions/file.md
index 28c2dc9f1f3..577e2e6aa1d 100644
--- a/docs/en/sql-reference/table-functions/file.md
+++ b/docs/en/sql-reference/table-functions/file.md
@@ -40,7 +40,7 @@ VALUES (1, 2, 3), (3, 2, 1), (1, 3, 2)
 As a result, the data is written into the file `test.tsv`:
 
 ```bash
-# cat /var/lib/clickhouse/user_files/test.tsv 
+# cat /var/lib/clickhouse/user_files/test.tsv
 1	2	3
 3	2	1
 1	3	2
@@ -163,7 +163,7 @@ Query the number of rows in all files of these two directories:
 SELECT count(*) FROM file('{some,another}_dir/*', 'TSV', 'name String, value UInt32');
 ```
 
-:::note    
+:::note
 If your listing of files contains number ranges with leading zeros, use the construction with braces for each digit separately or use `?`.
 :::
 
@@ -199,3 +199,4 @@ SELECT count(*) FROM file('big_dir/**/file002', 'CSV', 'name String, value UInt3
 **See Also**
 
 - [Virtual columns](/docs/en/engines/table-engines/index.md#table_engines-virtual_columns)
+- [Rename files after processing](/docs/en/operations/settings/settings.md#rename_files_after_processing)
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index fa3ea582c55..7cab607bb3b 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4064,3 +4064,26 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 Возможные значения:: `true`, `false`
 
 Значение по умолчанию: `false`
+
+## rename_files_after_processing
+
+- **Тип:** Строка
+
+- **Значение по умолчанию:** Пустая строка
+
+Этот параметр позволяет задать паттерн для переименования файлов, обрабатываемых табличной функцией `file`. Когда опция установлена, все файлы, прочитанные табличной функцией `file`, будут переименованы в соответствии с указанным шаблоном, если обработка и чтение файла завершились успешно.
+
+### Шаблон
+Шаблон поддерживает следующие виды плейсхолдеров:
+
+- `%f` — Исходное имя файла без расширения (например "sample").
+- `%e` — Оригинальное расширение файла с точкой (например ".csv").
+- `%t` — Текущее время (в микросекундах).
+- `%%` — Знак процента ("%").
+
+### Пример
+- Значение аргумента: `--rename_files_after_processing="processed_%f_%t%e"`
+
+- Запрос: `SELECT * FROM file('sample.csv')`
+
+Если чтение и обработка `sample.csv` прошли успешно, файл будет переименован в `processed_sample_1683473210851438.csv`.
diff --git a/docs/ru/sql-reference/table-functions/file.md b/docs/ru/sql-reference/table-functions/file.md
index 94bc734a8fb..0983c51d954 100644
--- a/docs/ru/sql-reference/table-functions/file.md
+++ b/docs/ru/sql-reference/table-functions/file.md
@@ -126,3 +126,4 @@ SELECT count(*) FROM file('big_dir/file{0..9}{0..9}{0..9}', 'CSV', 'name String,
 **Смотрите также**
 
 -   [Виртуальные столбцы](index.md#table_engines-virtual_columns)
+-   [Переименование файлов после обработки](/docs/ru/operations/settings/settings.md#rename_files_after_processing)

From d4cec1f0e0fa114f5e04dead6b90f51b3e292310 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 30 May 2023 01:30:01 +0200
Subject: [PATCH 136/722] fix client thread attachment + make better tests

---
 programs/client/Client.cpp                    |  1 +
 src/Client/ClientBase.cpp                     |  3 ---
 src/Client/Connection.cpp                     |  4 ---
 src/Common/ThreadStatus.h                     |  3 ++-
 src/DataTypes/DataTypeDateTime.h              |  4 ++-
 src/Server/TCPHandler.cpp                     |  2 +-
 .../02681_timezone_setting.reference          |  5 ----
 .../0_stateless/02681_timezone_setting.sql    | 11 --------
 .../02737_timezone_setting.reference          |  7 +++++
 .../0_stateless/02737_timezone_setting.sql    | 27 +++++++++++++++++++
 10 files changed, 41 insertions(+), 26 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02681_timezone_setting.reference
 delete mode 100644 tests/queries/0_stateless/02681_timezone_setting.sql
 create mode 100644 tests/queries/0_stateless/02737_timezone_setting.reference
 create mode 100644 tests/queries/0_stateless/02737_timezone_setting.sql

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 6b34bdbc5bb..231b7fd6d61 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -326,6 +326,7 @@ try
         // All that just to set DB::CurrentThread::get().getGlobalContext()
         // which is required for client timezone (pushed from server) to work.
         auto thread_group = std::make_shared<ThreadGroup>();
+        thread_group->global_context = global_context;
         thread_status.attachToGroup(thread_group, false);
     }
 
diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index fad9494ba4b..562c11680a1 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -448,9 +448,7 @@ void ClientBase::onData(Block & block, ASTPtr parsed_query)
     /// output_format, do not output it.
     /// Also do not output too much data if we're fuzzing.
     if (block.rows() == 0 || (query_fuzzer_runs != 0 && processed_rows >= 100))
-    {
         return;
-    }
 
     /// If results are written INTO OUTFILE, we can avoid clearing progress to avoid flicker.
     if (need_render_progress && tty_buf && (!select_into_file || select_into_file_and_stdout))
@@ -902,7 +900,6 @@ void ClientBase::processOrdinaryQuery(const String & query_to_execute, ASTPtr pa
 
             if (send_external_tables)
                 sendExternalTables(parsed_query);
-
             receiveResult(parsed_query, signals_before_stop, settings.partial_result_on_first_cancel);
 
             break;
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index 86585d805d9..457d90c5bd4 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -355,10 +355,6 @@ void Connection::receiveHello()
             nonce.emplace(read_nonce);
         }
     }
-//    else if (packet_type == Protocol::Server::TimezoneUpdate)
-//    {
-//        // skip this packet at hello, will receive and process it later
-//    }
     else if (packet_type == Protocol::Server::Exception)
         receiveException()->rethrow();
     else
diff --git a/src/Common/ThreadStatus.h b/src/Common/ThreadStatus.h
index 600dfc56d2b..400b55c2409 100644
--- a/src/Common/ThreadStatus.h
+++ b/src/Common/ThreadStatus.h
@@ -72,7 +72,8 @@ public:
 
     /// Set up at creation, no race when reading
     const ContextWeakPtr query_context;
-    const ContextWeakPtr global_context;
+    /// Cannot make it const -- we need to modify it in ch-client to process timezone from server
+    ContextWeakPtr global_context;
 
     const FatalErrorCallback fatal_error_callback;
 
diff --git a/src/DataTypes/DataTypeDateTime.h b/src/DataTypes/DataTypeDateTime.h
index 91a09ff7cb9..a4a05917ba5 100644
--- a/src/DataTypes/DataTypeDateTime.h
+++ b/src/DataTypes/DataTypeDateTime.h
@@ -21,7 +21,9 @@ namespace DB
   *  all types with different time zones are equivalent and may be used interchangingly.
   * Time zone only affects parsing and displaying in text formats.
   *
-  * If time zone is not specified (example: DateTime without parameter), then default time zone is used.
+  * If time zone is not specified (example: DateTime without parameter),
+  * then `session_timezone` setting value is used.
+  * If `session_timezone` is not set (or empty string), server default time zone is used.
   * Default time zone is server time zone, if server is doing transformations
   *  and if client is doing transformations, unless 'use_client_time_zone' setting is passed to client;
   * Server time zone is the time zone specified in 'timezone' parameter in configuration file,
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index d57a1c93dd7..c41eace68ba 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -1068,7 +1068,7 @@ void TCPHandler::sendTimezone()
     if (client_tcp_protocol_version < DBMS_MIN_PROTOCOL_VERSION_WITH_TIMEZONE_UPDATES)
         return;
 
-    const String & tz = query_context->getSettingsRef().session_timezone.toString();
+    const String & tz = query_context->getSettingsRef().session_timezone.value;
 
     LOG_DEBUG(log, "TCPHandler::sendTimezone(): {}", tz);
     writeVarUInt(Protocol::Server::TimezoneUpdate, *out);
diff --git a/tests/queries/0_stateless/02681_timezone_setting.reference b/tests/queries/0_stateless/02681_timezone_setting.reference
deleted file mode 100644
index 8850d77ab03..00000000000
--- a/tests/queries/0_stateless/02681_timezone_setting.reference
+++ /dev/null
@@ -1,5 +0,0 @@
-2022-12-12 17:23:23.123
-2022-12-12 23:23:23.123
-2022-12-12 22:23:23.123
-Europe/Zurich	Europe/Zurich
-Pacific/Pitcairn	Pacific/Pitcairn
diff --git a/tests/queries/0_stateless/02681_timezone_setting.sql b/tests/queries/0_stateless/02681_timezone_setting.sql
deleted file mode 100644
index f66e8d2b646..00000000000
--- a/tests/queries/0_stateless/02681_timezone_setting.sql
+++ /dev/null
@@ -1,11 +0,0 @@
-SET session_timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
-
-SET session_timezone = 'Asia/Novosibirsk';
-SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich');
-SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'Europe/Zurich';
-
-SET session_timezone = 'Asia/Manila';
-SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Asia/Novosibirsk');
-
-SELECT timezone(), timezoneOf(now()) SETTINGS session_timezone = 'Europe/Zurich' FORMAT TSV;
-SELECT timezone(), timezoneOf(now()) SETTINGS session_timezone = 'Pacific/Pitcairn' FORMAT TSV;
diff --git a/tests/queries/0_stateless/02737_timezone_setting.reference b/tests/queries/0_stateless/02737_timezone_setting.reference
new file mode 100644
index 00000000000..578aec4e316
--- /dev/null
+++ b/tests/queries/0_stateless/02737_timezone_setting.reference
@@ -0,0 +1,7 @@
+Pacific/Pitcairn	Pacific/Pitcairn
+Asia/Novosibirsk	Asia/Novosibirsk
+2022-12-12 17:23:23
+2022-12-13 07:23:23.123
+2002-12-12 23:23:23	2002-12-12 23:23:23
+2002-12-12 23:23:23.123	2002-12-12 23:23:23.123
+2000-01-01 01:00:00
diff --git a/tests/queries/0_stateless/02737_timezone_setting.sql b/tests/queries/0_stateless/02737_timezone_setting.sql
new file mode 100644
index 00000000000..87eeec0779b
--- /dev/null
+++ b/tests/queries/0_stateless/02737_timezone_setting.sql
@@ -0,0 +1,27 @@
+SET session_timezone = 'Абырвалг'; -- { serverError BAD_ARGUMENTS}
+
+SELECT timezone(), timezoneOf(now()) SETTINGS session_timezone = 'Pacific/Pitcairn';
+
+SET session_timezone = 'Asia/Novosibirsk';
+SELECT timezone(), timezoneOf(now());
+
+-- test simple queries
+SELECT toDateTime(toDateTime('2022-12-12 23:23:23'), 'Europe/Zurich');
+SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver';
+
+-- test proper serialization
+SELECT toDateTime('2002-12-12 23:23:23'), toString(toDateTime('2002-12-12 23:23:23')) SETTINGS session_timezone = 'Asia/Phnom_Penh';
+SELECT toDateTime64('2002-12-12 23:23:23.123', 3), toString(toDateTime64('2002-12-12 23:23:23.123', 3)) SETTINGS session_timezone = 'Asia/Phnom_Penh';
+
+-- Create a table and test that DateTimes are processed correctly on insert
+SET session_timezone='Asia/Novosibirsk';
+CREATE TABLE test_tz_setting (d DateTime('UTC')) Engine=Memory AS SELECT toDateTime('2000-01-01 00:00:00');
+INSERT INTO test_tz_setting VALUES ('2000-01-01 01:00:00'); -- this is parsed using timezone from `d` column
+INSERT INTO test_tz_setting VALUES (toDateTime('2000-01-02 02:00:00')); -- this is parsed using `session_timezone`
+
+-- Test parsing in WHERE filter, shall have the same logic as insert
+SELECT d FROM test_tz_setting WHERE d == '2000-01-01 01:00:00'; -- 1 row expected
+SELECT d FROM test_tz_setting WHERE d == toDateTime('2000-01-01 02:00:00'); -- 0 rows expected
+
+-- Cleanup table
+DROP TABLE test_tz_setting SYNC;
\ No newline at end of file

From c25980bcf4ecae8aaec15b75421b3a187b410ab2 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Tue, 30 May 2023 12:02:44 +0000
Subject: [PATCH 137/722] Trying to fix toDateOrDefault()

---
 src/Functions/FunctionsConversion.h                    |  7 +++++++
 .../01746_convert_type_with_default.reference          |  4 ++++
 .../0_stateless/01746_convert_type_with_default.sql    | 10 ++++++++++
 3 files changed, 21 insertions(+)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 940585d6d57..d3676349318 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -2882,6 +2882,13 @@ private:
                     return true;
                 }
 
+                if constexpr (IsDataTypeNumber<LeftDataType> && IsDataTypeDateOrDateTime<RightDataType>)
+                {
+                    result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::execute(
+                        arguments, result_type, input_rows_count);
+                    return true;
+                }
+
                 return false;
             });
 
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 9ebef9c4a8d..ec2a826982f 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -20,5 +20,9 @@
 2
 -1
 -2
+2023-05-30
+2023-05-30
+2023-05-30 14:38:20
+2023-05-30 14:38:20
 61f0c404-5cb3-11e7-907b-a6006ad3dba0
 59f0c404-5cb3-11e7-907b-a6006ad3dba0
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 0881e911466..9d7873081e5 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -26,5 +26,15 @@ select toUInt256OrDefault('1xx', cast(2 as UInt256));
 select toInt256OrDefault('-1', cast(-2 as Int256));
 select toInt256OrDefault('-1xx', cast(-2 as Int256));
 
+select toDateOrDefault('2023-05-30');
+select toDateOrDefault(19507);
+
+select toDateTimeOrDefault('2023-05-30 14:38:20');
+select toDateTimeOrDefault(1685457500);
+
 SELECT toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
 SELECT toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
+
+
+
+

From 6c9b7a710c083041b25159109e8cf786c5875ba0 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Tue, 30 May 2023 14:46:44 +0000
Subject: [PATCH 138/722] Added more tests for
 toDateOrDefault/toDateTimeOrDefault

---
 .../01746_convert_type_with_default.reference      |  8 ++++++++
 .../01746_convert_type_with_default.sql            | 14 +++++++++-----
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index ec2a826982f..235a88157c8 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -20,8 +20,16 @@
 2
 -1
 -2
+1970-01-01
 2023-05-30
 2023-05-30
+2023-05-30
+1970-01-01
+2023-05-30
+2023-05-30
+1970-01-01
+2023-05-30 14:38:20
+2023-05-30 14:38:20
 2023-05-30 14:38:20
 2023-05-30 14:38:20
 61f0c404-5cb3-11e7-907b-a6006ad3dba0
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 9d7873081e5..18b5ae60920 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -26,15 +26,19 @@ select toUInt256OrDefault('1xx', cast(2 as UInt256));
 select toInt256OrDefault('-1', cast(-2 as Int256));
 select toInt256OrDefault('-1xx', cast(-2 as Int256));
 
+select toDateOrDefault('2020-0x-02');
 select toDateOrDefault('2023-05-30');
+select toDateOrDefault('2023-05-30', '2000-01-01'::Date);
+select toDateOrDefault('2020-0x-02', '2023-05-30'::Date);
+select toDateOrDefault(-1);
 select toDateOrDefault(19507);
+select toDateOrDefault(19507, '2000-01-01'::Date);
+select toDateOrDefault(-1, '2000-01-01'::Date);
 
 select toDateTimeOrDefault('2023-05-30 14:38:20');
+select toDateTimeOrDefault('2023-05-30 14:38:20', 'UTC');
+select toDateTimeOrDefault('s2023', 'UTC', '2023-05-30 14:38:20'::DateTime('UTC'));
 select toDateTimeOrDefault(1685457500);
 
 SELECT toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
-SELECT toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
-
-
-
-
+SELECT toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
\ No newline at end of file

From c8bb1f64ad21dea5ba63fa8f2ea8434d90f9e823 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 30 May 2023 18:46:49 +0200
Subject: [PATCH 139/722] fix

---
 src/Storages/StorageReplicatedMergeTree.cpp |  3 +++
 tests/integration/test_lost_part/test.py    | 12 ++++++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index e71f5217c2b..35f75880ced 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -5469,6 +5469,7 @@ void StorageReplicatedMergeTree::alter(
     if (mutation_znode)
     {
         LOG_DEBUG(log, "Metadata changes applied. Will wait for data changes.");
+        merge_selecting_task->schedule();
         waitMutation(*mutation_znode, query_context->getSettingsRef().alter_sync);
         LOG_DEBUG(log, "Data changes applied.");
     }
@@ -6620,6 +6621,8 @@ void StorageReplicatedMergeTree::mutate(const MutationCommands & commands, Conte
             throw Coordination::Exception("Unable to create a mutation znode", rc);
     }
 
+    merge_selecting_task->schedule();
+
     waitMutation(mutation_entry.znode_name, query_context->getSettingsRef().mutations_sync);
 }
 
diff --git a/tests/integration/test_lost_part/test.py b/tests/integration/test_lost_part/test.py
index 44cd19fd1fb..0bc24268040 100644
--- a/tests/integration/test_lost_part/test.py
+++ b/tests/integration/test_lost_part/test.py
@@ -42,7 +42,8 @@ def test_lost_part_same_replica(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt0 (id UInt64, date Date) ENGINE ReplicatedMergeTree('/clickhouse/tables/t', '{node.name}') ORDER BY tuple() PARTITION BY date "
-            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
+            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,"
+            "merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=1000"
         )
 
     node1.query("SYSTEM STOP MERGES mt0")
@@ -109,7 +110,8 @@ def test_lost_part_other_replica(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt1 (id UInt64) ENGINE ReplicatedMergeTree('/clickhouse/tables/t1', '{node.name}') ORDER BY tuple() "
-            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
+            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,"
+            "merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=1000"
         )
 
     node1.query("SYSTEM STOP MERGES mt1")
@@ -178,7 +180,8 @@ def test_lost_part_mutation(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt2 (id UInt64) ENGINE ReplicatedMergeTree('/clickhouse/tables/t2', '{node.name}') ORDER BY tuple() "
-            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
+            "SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,"
+            "merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=1000"
         )
 
     node1.query("SYSTEM STOP MERGES mt2")
@@ -241,7 +244,8 @@ def test_lost_last_part(start_cluster):
     for node in [node1, node2]:
         node.query(
             f"CREATE TABLE mt3 (id UInt64, p String) ENGINE ReplicatedMergeTree('/clickhouse/tables/t3', '{node.name}') "
-            "ORDER BY tuple() PARTITION BY p SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0"
+            "ORDER BY tuple() PARTITION BY p SETTINGS cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,"
+            "merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=1000"
         )
 
     node1.query("SYSTEM STOP MERGES mt3")

From daaae3f573c03be49c9e015c249642034113374d Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Tue, 30 May 2023 19:11:26 +0000
Subject: [PATCH 140/722] Add toString() to fix time zone error

---
 tests/queries/0_stateless/01746_convert_type_with_default.sql | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 18b5ae60920..40e4798721b 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -37,7 +37,7 @@ select toDateOrDefault(-1, '2000-01-01'::Date);
 
 select toDateTimeOrDefault('2023-05-30 14:38:20');
 select toDateTimeOrDefault('2023-05-30 14:38:20', 'UTC');
-select toDateTimeOrDefault('s2023', 'UTC', '2023-05-30 14:38:20'::DateTime('UTC'));
+select toString(toDateTimeOrDefault('s2023', 'Asia/Istanbul', '2023-05-30 14:38:20'::DateTime('Asia/Istanbul')), 'Asia/Istanbul');
 select toDateTimeOrDefault(1685457500);
 
 SELECT toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));

From d4efbbfbd3ca954b83391c60afffe760cc602361 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 30 May 2023 19:32:24 +0000
Subject: [PATCH 141/722] Allow to skip empty files in file/s3/url/hdfs table
 functions

---
 src/Core/Settings.h                           |   4 +
 src/Storages/HDFS/StorageHDFS.cpp             | 113 +++++++++++-------
 src/Storages/HDFS/StorageHDFS.h               |  23 +++-
 src/Storages/HDFS/StorageHDFSCluster.cpp      |   2 +-
 src/Storages/StorageFile.cpp                  |  59 ++++++---
 src/Storages/StorageS3.cpp                    |  12 +-
 src/Storages/StorageURL.cpp                   |  43 ++++---
 src/Storages/StorageURL.h                     |   2 +-
 tests/integration/test_storage_hdfs/test.py   |  50 ++++++++
 tests/integration/test_storage_s3/test.py     |  55 +++++++++
 .../02771_skip_empty_files.reference          |   7 ++
 .../0_stateless/02771_skip_empty_files.sh     |  24 ++++
 12 files changed, 307 insertions(+), 87 deletions(-)
 create mode 100644 tests/queries/0_stateless/02771_skip_empty_files.reference
 create mode 100755 tests/queries/0_stateless/02771_skip_empty_files.sh

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 607be1522db..534cb629aa8 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -91,6 +91,7 @@ class IColumn;
     M(UInt64, s3_list_object_keys_size, 1000, "Maximum number of files that could be returned in batch by ListObject request", 0) \
     M(Bool, s3_truncate_on_insert, false, "Enables or disables truncate before insert in s3 engine tables.", 0) \
     M(Bool, s3_create_new_file_on_insert, false, "Enables or disables creating a new file on each insert in s3 engine tables", 0) \
+    M(Bool, s3_skip_empty_files, false, "Allow to skip empty files in s3 table engine", 0) \
     M(Bool, s3_check_objects_after_upload, false, "Check each uploaded object to s3 with head request to be sure that upload was successful", 0) \
     M(Bool, s3_allow_parallel_part_upload, true, "Use multiple threads for s3 multipart upload. It may lead to slightly higher memory usage", 0) \
     M(Bool, s3_throw_on_zero_files_match, false, "Throw an error, when ListObjects request cannot match any files", 0) \
@@ -99,6 +100,7 @@ class IColumn;
     M(UInt64, hdfs_replication, 0, "The actual number of replications can be specified when the hdfs file is created.", 0) \
     M(Bool, hdfs_truncate_on_insert, false, "Enables or disables truncate before insert in s3 engine tables", 0) \
     M(Bool, hdfs_create_new_file_on_insert, false, "Enables or disables creating a new file on each insert in hdfs engine tables", 0) \
+    M(Bool, hdfs_skip_empty_files, false, "Allow to skip empty files in hdfs table engine", 0) \
     M(UInt64, hsts_max_age, 0, "Expired time for hsts. 0 means disable HSTS.", 0) \
     M(Bool, extremes, false, "Calculate minimums and maximums of the result columns. They can be output in JSON-formats.", IMPORTANT) \
     M(Bool, use_uncompressed_cache, false, "Whether to use the cache of uncompressed blocks.", 0) \
@@ -602,6 +604,8 @@ class IColumn;
     M(Bool, engine_file_empty_if_not_exists, false, "Allows to select data from a file engine table without file", 0) \
     M(Bool, engine_file_truncate_on_insert, false, "Enables or disables truncate before insert in file engine tables", 0) \
     M(Bool, engine_file_allow_create_multiple_files, false, "Enables or disables creating a new file on each insert in file engine tables if format has suffix.", 0) \
+    M(Bool, engine_file_skip_empty_files, false, "Allows to skip empty files in file table engine", 0) \
+    M(Bool, engine_url_skip_empty_files, false, "Allows to skip empty files in url table engine", 0) \
     M(Bool, allow_experimental_database_replicated, false, "Allow to create databases with Replicated engine", 0) \
     M(UInt64, database_replicated_initial_query_timeout_sec, 300, "How long initial DDL query should wait for Replicated database to precess previous DDL queue entries", 0) \
     M(Bool, database_replicated_enforce_synchronous_settings, false, "Enforces synchronous waiting for some queries (see also database_atomic_wait_for_drop_and_detach_synchronously, mutation_sync, alter_sync). Not recommended to enable these settings.", 0) \
diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 19c0840149b..08114ed3cba 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -66,7 +66,7 @@ namespace
     /* Recursive directory listing with matched paths as a result.
      * Have the same method in StorageFile.
      */
-    Strings LSWithRegexpMatching(const String & path_for_ls, const HDFSFSPtr & fs, const String & for_match, std::unordered_map<String, time_t> * last_mod_times)
+    std::vector<StorageHDFS::PathWithInfo> LSWithRegexpMatching(const String & path_for_ls, const HDFSFSPtr & fs, const String & for_match)
     {
         const size_t first_glob = for_match.find_first_of("*?{");
 
@@ -88,7 +88,7 @@ namespace
             throw Exception(
                 ErrorCodes::ACCESS_DENIED, "Cannot list directory {}: {}", prefix_without_globs, String(hdfsGetLastError()));
         }
-        Strings result;
+        std::vector<StorageHDFS::PathWithInfo> result;
         if (!ls.file_info && ls.length > 0)
             throw Exception(ErrorCodes::LOGICAL_ERROR, "file_info shouldn't be null");
         for (int i = 0; i < ls.length; ++i)
@@ -102,17 +102,15 @@ namespace
             if (!is_directory && !looking_for_directory)
             {
                 if (re2::RE2::FullMatch(file_name, matcher))
-                {
-                    result.push_back(String(ls.file_info[i].mName));
-                    if (last_mod_times)
-                        (*last_mod_times)[result.back()] = ls.file_info[i].mLastMod;
-                }
+                    result.emplace_back(
+                        String(ls.file_info[i].mName),
+                        StorageHDFS::PathInfo{ls.file_info[i].mLastMod, static_cast<size_t>(ls.file_info[i].mSize)});
             }
             else if (is_directory && looking_for_directory)
             {
                 if (re2::RE2::FullMatch(file_name, matcher))
                 {
-                    Strings result_part = LSWithRegexpMatching(fs::path(full_path) / "", fs, suffix_with_globs.substr(next_slash), last_mod_times);
+                    std::vector<StorageHDFS::PathWithInfo> result_part = LSWithRegexpMatching(fs::path(full_path) / "", fs, suffix_with_globs.substr(next_slash));
                     /// Recursion depth is limited by pattern. '*' works only for depth = 1, for depth = 2 pattern path is '*/*'. So we do not need additional check.
                     std::move(result_part.begin(), result_part.end(), std::back_inserter(result));
                 }
@@ -135,12 +133,20 @@ namespace
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Storage HDFS requires valid URL to be set");
     }
 
-    std::vector<String> getPathsList(const String & path_from_uri, const String & uri_without_path, ContextPtr context, std::unordered_map<String, time_t> * last_mod_times = nullptr)
+    std::vector<StorageHDFS::PathWithInfo> getPathsList(const String & path_from_uri, const String & uri_without_path, ContextPtr context)
     {
         HDFSBuilderWrapper builder = createHDFSBuilder(uri_without_path + "/", context->getGlobalContext()->getConfigRef());
         HDFSFSPtr fs = createHDFSFS(builder.get());
 
-        return LSWithRegexpMatching("/", fs, path_from_uri, last_mod_times);
+        return LSWithRegexpMatching("/", fs, path_from_uri);
+    }
+
+    size_t getFileSize(const String & path_from_uri, const String & uri_without_path, ContextPtr context)
+    {
+        HDFSBuilderWrapper builder = createHDFSBuilder(uri_without_path + "/", context->getGlobalContext()->getConfigRef());
+        HDFSFSPtr fs = createHDFSFS(builder.get());
+        auto * info = hdfsGetPathInfo(fs.get(), path_from_uri.data());
+        return info->mSize;
     }
 }
 
@@ -199,9 +205,8 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
     ContextPtr ctx)
 {
     const auto [path_from_uri, uri_without_path] = getPathFromUriAndUriWithoutPath(uri);
-    std::unordered_map<String, time_t> last_mod_time;
-    auto paths = getPathsList(path_from_uri, uri, ctx, &last_mod_time);
-    if (paths.empty() && !FormatFactory::instance().checkIfFormatHasExternalSchemaReader(format))
+    auto paths_with_info = getPathsList(path_from_uri, uri, ctx);
+    if (paths_with_info.empty() && !FormatFactory::instance().checkIfFormatHasExternalSchemaReader(format))
         throw Exception(
             ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
             "Cannot extract table structure from {} format file, because there are no files in HDFS with provided path."
@@ -209,14 +214,27 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
 
     std::optional<ColumnsDescription> columns_from_cache;
     if (ctx->getSettingsRef().schema_inference_use_cache_for_hdfs)
-        columns_from_cache = tryGetColumnsFromCache(paths, path_from_uri, last_mod_time, format, ctx);
+        columns_from_cache = tryGetColumnsFromCache(paths_with_info, path_from_uri, format, ctx);
 
-    ReadBufferIterator read_buffer_iterator = [&, my_uri_without_path = uri_without_path, it = paths.begin()](ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
+    ReadBufferIterator read_buffer_iterator
+        = [&, my_uri_without_path = uri_without_path, it = paths_with_info.begin(), first = true](
+              ColumnsDescription & columns) mutable -> std::unique_ptr<ReadBuffer>
     {
-        if (it == paths.end())
+        if (it == paths_with_info.end())
+        {
+            if (first)
+                throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                                "Cannot extract table structure from {} format file, because all files are empty. "
+                                "You must specify table structure manually", format);
             return nullptr;
-        auto compression = chooseCompressionMethod(*it, compression_method);
-        auto impl = std::make_unique<ReadBufferFromHDFS>(my_uri_without_path, *it++, ctx->getGlobalContext()->getConfigRef(), ctx->getReadSettings());
+        }
+
+        auto path_with_info = *it++;
+        if (ctx->getSettingsRef().hdfs_skip_empty_files && path_with_info.info && path_with_info.info->size == 0)
+            return read_buffer_iterator(columns);
+
+        auto compression = chooseCompressionMethod(path_with_info.path, compression_method);
+        auto impl = std::make_unique<ReadBufferFromHDFS>(my_uri_without_path, path_with_info.path, ctx->getGlobalContext()->getConfigRef(), ctx->getReadSettings());
         const Int64 zstd_window_log_max = ctx->getSettingsRef().zstd_window_log_max;
         return wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
     };
@@ -225,10 +243,10 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
     if (columns_from_cache)
         columns = *columns_from_cache;
     else
-        columns = readSchemaFromFormat(format, std::nullopt, read_buffer_iterator, paths.size() > 1, ctx);
+        columns = readSchemaFromFormat(format, std::nullopt, read_buffer_iterator, paths_with_info.size() > 1, ctx);
 
     if (ctx->getSettingsRef().schema_inference_use_cache_for_hdfs)
-        addColumnsToCache(paths, path_from_uri, columns, format, ctx);
+        addColumnsToCache(paths_with_info, path_from_uri, columns, format, ctx);
 
     return columns;
 }
@@ -241,11 +259,11 @@ public:
         const auto [path_from_uri, uri_without_path] = getPathFromUriAndUriWithoutPath(uri);
         uris = getPathsList(path_from_uri, uri_without_path, context_);
         for (auto & elem : uris)
-            elem = uri_without_path + elem;
+            elem.path = uri_without_path + elem.path;
         uris_iter = uris.begin();
     }
 
-    String next()
+    StorageHDFS::PathWithInfo next()
     {
         std::lock_guard lock(mutex);
         if (uris_iter != uris.end())
@@ -258,8 +276,8 @@ public:
     }
 private:
     std::mutex mutex;
-    Strings uris;
-    Strings::iterator uris_iter;
+    std::vector<StorageHDFS::PathWithInfo> uris;
+    std::vector<StorageHDFS::PathWithInfo>::iterator uris_iter;
 };
 
 class HDFSSource::URISIterator::Impl
@@ -279,14 +297,14 @@ public:
         uris_iter = uris.begin();
     }
 
-    String next()
+    StorageHDFS::PathWithInfo next()
     {
         std::lock_guard lock(mutex);
         if (uris_iter == uris.end())
-            return "";
+            return {"", {}};
         auto key = *uris_iter;
         ++uris_iter;
-        return key;
+        return {key, {}};
     }
 
 private:
@@ -298,7 +316,7 @@ private:
 HDFSSource::DisclosedGlobIterator::DisclosedGlobIterator(ContextPtr context_, const String & uri)
     : pimpl(std::make_shared<HDFSSource::DisclosedGlobIterator::Impl>(context_, uri)) {}
 
-String HDFSSource::DisclosedGlobIterator::next()
+StorageHDFS::PathWithInfo HDFSSource::DisclosedGlobIterator::next()
 {
     return pimpl->next();
 }
@@ -308,7 +326,7 @@ HDFSSource::URISIterator::URISIterator(const std::vector<String> & uris_, Contex
 {
 }
 
-String HDFSSource::URISIterator::next()
+StorageHDFS::PathWithInfo HDFSSource::URISIterator::next()
 {
     return pimpl->next();
 }
@@ -343,12 +361,21 @@ HDFSSource::HDFSSource(
 
 bool HDFSSource::initialize()
 {
-    current_path = (*file_iterator)();
-    if (current_path.empty())
+    auto path_with_info = (*file_iterator)();
+    if (path_with_info.path.empty())
         return false;
 
+    current_path = path_with_info.path;
     const auto [path_from_uri, uri_without_path] = getPathFromUriAndUriWithoutPath(current_path);
 
+    if (getContext()->getSettingsRef().hdfs_skip_empty_files)
+    {
+        auto file_size = path_with_info.info ? path_with_info.info->size : getFileSize(path_from_uri, uri_without_path, getContext());
+        /// If file is empty and hdfs_skip_empty_files=1, skip it and go to the next file.
+        if (file_size == 0)
+            return initialize();
+    }
+
     auto compression = chooseCompressionMethod(path_from_uri, storage->compression_method);
     auto impl = std::make_unique<ReadBufferFromHDFS>(
         uri_without_path, path_from_uri, getContext()->getGlobalContext()->getConfigRef(), getContext()->getReadSettings());
@@ -553,8 +580,8 @@ Pipe StorageHDFS::read(
     if (distributed_processing)
     {
         iterator_wrapper = std::make_shared<HDFSSource::IteratorWrapper>(
-            [callback = context_->getReadTaskCallback()]() -> String {
-                return callback();
+            [callback = context_->getReadTaskCallback()]() -> StorageHDFS::PathWithInfo {
+                return StorageHDFS::PathWithInfo{callback(), std::nullopt};
         });
     }
     else if (is_path_with_globs)
@@ -761,24 +788,22 @@ SchemaCache & StorageHDFS::getSchemaCache(const ContextPtr & ctx)
 }
 
 std::optional<ColumnsDescription> StorageHDFS::tryGetColumnsFromCache(
-    const Strings & paths,
+    const std::vector<StorageHDFS::PathWithInfo> & paths_with_info,
     const String & uri_without_path,
-    std::unordered_map<String, time_t> & last_mod_time,
     const String & format_name,
     const ContextPtr & ctx)
 {
     auto & schema_cache = getSchemaCache(ctx);
-    for (const auto & path : paths)
+    for (const auto & path_with_info : paths_with_info)
     {
         auto get_last_mod_time = [&]() -> std::optional<time_t>
         {
-            auto it = last_mod_time.find(path);
-            if (it == last_mod_time.end())
-                return std::nullopt;
-            return it->second;
+            if (path_with_info.info)
+                return path_with_info.info->last_mod_time;
+            return std::nullopt;
         };
 
-        String url = fs::path(uri_without_path) / path;
+        String url = fs::path(uri_without_path) / path_with_info.path;
         auto cache_key = getKeyForSchemaCache(url, format_name, {}, ctx);
         auto columns = schema_cache.tryGet(cache_key, get_last_mod_time);
         if (columns)
@@ -789,7 +814,7 @@ std::optional<ColumnsDescription> StorageHDFS::tryGetColumnsFromCache(
 }
 
 void StorageHDFS::addColumnsToCache(
-    const Strings & paths,
+    const std::vector<StorageHDFS::PathWithInfo> & paths_with_info,
     const String & uri_without_path,
     const ColumnsDescription & columns,
     const String & format_name,
@@ -797,8 +822,8 @@ void StorageHDFS::addColumnsToCache(
 {
     auto & schema_cache = getSchemaCache(ctx);
     Strings sources;
-    sources.reserve(paths.size());
-    std::transform(paths.begin(), paths.end(), std::back_inserter(sources), [&](const String & path){ return fs::path(uri_without_path) / path; });
+    sources.reserve(paths_with_info.size());
+    std::transform(paths_with_info.begin(), paths_with_info.end(), std::back_inserter(sources), [&](const PathWithInfo & path_with_info){ return fs::path(uri_without_path) / path_with_info.path; });
     auto cache_keys = getKeysForSchemaCache(sources, format_name, {}, ctx);
     schema_cache.addMany(cache_keys, columns);
 }
diff --git a/src/Storages/HDFS/StorageHDFS.h b/src/Storages/HDFS/StorageHDFS.h
index b123834e981..87ad5aee6a3 100644
--- a/src/Storages/HDFS/StorageHDFS.h
+++ b/src/Storages/HDFS/StorageHDFS.h
@@ -18,6 +18,18 @@ namespace DB
 class StorageHDFS final : public IStorage, WithContext
 {
 public:
+    struct PathInfo
+    {
+        time_t last_mod_time;
+        size_t size;
+    };
+
+    struct PathWithInfo
+    {
+        String path;
+        std::optional<PathInfo> info;
+    };
+
     StorageHDFS(
         const String & uri_,
         const StorageID & table_id_,
@@ -72,14 +84,13 @@ protected:
 
 private:
     static std::optional<ColumnsDescription> tryGetColumnsFromCache(
-        const Strings & paths,
+        const std::vector<StorageHDFS::PathWithInfo> & paths_with_info,
         const String & uri_without_path,
-        std::unordered_map<String, time_t> & last_mod_time,
         const String & format_name,
         const ContextPtr & ctx);
 
     static void addColumnsToCache(
-        const Strings & paths,
+        const std::vector<StorageHDFS::PathWithInfo> & paths,
         const String & uri_without_path,
         const ColumnsDescription & columns,
         const String & format_name,
@@ -105,7 +116,7 @@ public:
     {
         public:
             DisclosedGlobIterator(ContextPtr context_, const String & uri_);
-            String next();
+            StorageHDFS::PathWithInfo next();
         private:
             class Impl;
             /// shared_ptr to have copy constructor
@@ -116,14 +127,14 @@ public:
     {
         public:
             URISIterator(const std::vector<String> & uris_, ContextPtr context);
-            String next();
+            StorageHDFS::PathWithInfo next();
         private:
             class Impl;
             /// shared_ptr to have copy constructor
             std::shared_ptr<Impl> pimpl;
     };
 
-    using IteratorWrapper = std::function<String()>;
+    using IteratorWrapper = std::function<StorageHDFS::PathWithInfo()>;
     using StorageHDFSPtr = std::shared_ptr<StorageHDFS>;
 
     static Block getHeader(Block sample_block, const std::vector<NameAndTypePair> & requested_virtual_columns);
diff --git a/src/Storages/HDFS/StorageHDFSCluster.cpp b/src/Storages/HDFS/StorageHDFSCluster.cpp
index 46e67b623e2..b98459aeee3 100644
--- a/src/Storages/HDFS/StorageHDFSCluster.cpp
+++ b/src/Storages/HDFS/StorageHDFSCluster.cpp
@@ -79,7 +79,7 @@ void StorageHDFSCluster::addColumnsStructureToQuery(ASTPtr & query, const String
 RemoteQueryExecutor::Extension StorageHDFSCluster::getTaskIteratorExtension(ASTPtr, const ContextPtr & context) const
 {
     auto iterator = std::make_shared<HDFSSource::DisclosedGlobIterator>(context, uri);
-    auto callback = std::make_shared<HDFSSource::IteratorWrapper>([iter = std::move(iterator)]() mutable -> String { return iter->next(); });
+    auto callback = std::make_shared<std::function<String()>>([iter = std::move(iterator)]() mutable -> String { return iter->next().path; });
     return RemoteQueryExecutor::Extension{.task_iterator = std::move(callback)};
 }
 
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 647f9511052..a20a4e63ba6 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -257,35 +257,40 @@ std::unique_ptr<ReadBuffer> selectReadBuffer(
     return res;
 }
 
-std::unique_ptr<ReadBuffer> createReadBuffer(
-    const String & current_path,
-    bool use_table_fd,
-    const String & storage_name,
-    int table_fd,
-    const String & compression_method,
-    ContextPtr context)
+struct stat getFileStat(const String & current_path, bool use_table_fd, int table_fd, const String & storage_name)
 {
-    CompressionMethod method;
-
     struct stat file_stat{};
-
     if (use_table_fd)
     {
         /// Check if file descriptor allows random reads (and reading it twice).
         if (0 != fstat(table_fd, &file_stat))
             throwFromErrno("Cannot stat table file descriptor, inside " + storage_name, ErrorCodes::CANNOT_STAT);
-
-        method = chooseCompressionMethod("", compression_method);
     }
     else
     {
         /// Check if file descriptor allows random reads (and reading it twice).
         if (0 != stat(current_path.c_str(), &file_stat))
             throwFromErrno("Cannot stat file " + current_path, ErrorCodes::CANNOT_STAT);
-
-        method = chooseCompressionMethod(current_path, compression_method);
     }
 
+    return file_stat;
+}
+
+std::unique_ptr<ReadBuffer> createReadBuffer(
+    const String & current_path,
+    const struct stat & file_stat,
+    bool use_table_fd,
+    int table_fd,
+    const String & compression_method,
+    ContextPtr context)
+{
+    CompressionMethod method;
+
+    if (use_table_fd)
+        method = chooseCompressionMethod("", compression_method);
+    else
+        method = chooseCompressionMethod(current_path, compression_method);
+
     std::unique_ptr<ReadBuffer> nested_buffer = selectReadBuffer(current_path, use_table_fd, table_fd, file_stat, context);
 
     /// For clickhouse-local and clickhouse-client add progress callback to display progress bar.
@@ -355,7 +360,8 @@ ColumnsDescription StorageFile::getTableStructureFromFileDescriptor(ContextPtr c
     {
         /// We will use PeekableReadBuffer to create a checkpoint, so we need a place
         /// where we can store the original read buffer.
-        read_buffer_from_fd = createReadBuffer("", true, getName(), table_fd, compression_method, context);
+        auto file_stat = getFileStat("", true, table_fd, getName());
+        read_buffer_from_fd = createReadBuffer("", file_stat, true, table_fd, compression_method, context);
         auto read_buf = std::make_unique<PeekableReadBuffer>(*read_buffer_from_fd);
         read_buf->setCheckpoint();
         return read_buf;
@@ -396,12 +402,24 @@ ColumnsDescription StorageFile::getTableStructureFromFile(
     if (context->getSettingsRef().schema_inference_use_cache_for_file)
         columns_from_cache = tryGetColumnsFromCache(paths, format, format_settings, context);
 
-    ReadBufferIterator read_buffer_iterator = [&, it = paths.begin()](ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
+    ReadBufferIterator read_buffer_iterator = [&, it = paths.begin(), first = true](ColumnsDescription & columns) mutable -> std::unique_ptr<ReadBuffer>
     {
         if (it == paths.end())
+        {
+            if (first)
+                throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                                "Cannot extract table structure from {} format file, because all files are empty. You must specify table structure manually",
+                                format);
             return nullptr;
+        }
 
-        return createReadBuffer(*it++, false, "File", -1, compression_method, context);
+        auto path = *it++;
+        auto file_stat = getFileStat(path, false, -1, "File");
+        if (context->getSettingsRef().engine_file_skip_empty_files && file_stat.st_size == 0)
+            return read_buffer_iterator(columns);
+
+        first = false;
+        return createReadBuffer(path, file_stat, false, -1, compression_method, context);
     };
 
     ColumnsDescription columns;
@@ -628,7 +646,12 @@ public:
                 }
 
                 if (!read_buf)
-                    read_buf = createReadBuffer(current_path, storage->use_table_fd, storage->getName(), storage->table_fd, storage->compression_method, context);
+                {
+                    auto file_stat = getFileStat(current_path, storage->use_table_fd, storage->table_fd, storage->getName());
+                    if (context->getSettingsRef().engine_file_skip_empty_files && file_stat.st_size == 0)
+                        continue;
+                    read_buf = createReadBuffer(current_path, file_stat, storage->use_table_fd, storage->table_fd, storage->compression_method, context);
+                }
 
                 const Settings & settings = context->getSettingsRef();
                 chassert(!storage->paths.empty());
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 2a2192d9cfe..9c4791020f2 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -573,6 +573,11 @@ StorageS3Source::ReaderHolder StorageS3Source::createReader()
         return {};
 
     size_t object_size = info ? info->size : S3::getObjectSize(*client, bucket, current_key, version_id, request_settings);
+
+    /// If object is empty and s3_skip_empty_files=1, skip it and go to the next key.
+    if (getContext()->getSettingsRef().s3_skip_empty_files && object_size == 0)
+        return createReader();
+
     auto compression_method = chooseCompressionMethod(current_key, compression_hint);
 
     InputFormatPtr input_format;
@@ -1456,7 +1461,7 @@ ColumnsDescription StorageS3::getTableStructureFromDataImpl(
 
     ReadBufferIterator read_buffer_iterator = [&, first = true](ColumnsDescription & cached_columns) mutable -> std::unique_ptr<ReadBuffer>
     {
-        auto [key, _] = (*file_iterator)();
+        auto [key, info] = (*file_iterator)();
 
         if (key.empty())
         {
@@ -1464,11 +1469,14 @@ ColumnsDescription StorageS3::getTableStructureFromDataImpl(
                 throw Exception(
                     ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
                     "Cannot extract table structure from {} format file, because there are no files with provided path "
-                    "in S3. You must specify table structure manually", configuration.format);
+                    "in S3 or all files are empty. You must specify table structure manually", configuration.format);
 
             return nullptr;
         }
 
+        if (ctx->getSettingsRef().s3_skip_empty_files && info->size == 0)
+            return read_buffer_iterator(cached_columns);
+
         /// S3 file iterator could get new keys after new iteration, check them in schema cache.
         if (ctx->getSettingsRef().schema_inference_use_cache_for_s3 && read_keys.size() > prev_read_keys_size)
         {
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index da8f6a151b2..706ce481a24 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -49,6 +49,7 @@ namespace ErrorCodes
     extern const int NETWORK_ERROR;
     extern const int BAD_ARGUMENTS;
     extern const int LOGICAL_ERROR;
+    extern const int CANNOT_EXTRACT_TABLE_STRUCTURE;
 }
 
 static constexpr auto bad_arguments_error_message = "Storage URL requires 1-4 arguments: "
@@ -242,15 +243,16 @@ StorageURLSource::StorageURLSource(
     auto headers = getHeaders(headers_);
 
     /// Lazy initialization. We should not perform requests in constructor, because we need to do it in query pipeline.
-    initialize = [=, this](const FailoverOptions & uri_options)
+    initialize = [=, this]()
     {
-        if (uri_options.empty())
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "Got empty url list");
+        const auto current_uri_options = (*uri_iterator)();
+        if (current_uri_options.empty())
+            return false;
 
-        auto first_option = uri_options.begin();
+        auto first_option = current_uri_options.begin();
         auto [actual_uri, buf_factory] = getFirstAvailableURIAndReadBuffer(
             first_option,
-            uri_options.end(),
+            current_uri_options.end(),
             context,
             params,
             http_method,
@@ -259,7 +261,11 @@ StorageURLSource::StorageURLSource(
             credentials,
             headers,
             glob_url,
-            uri_options.size() == 1);
+            current_uri_options.size() == 1);
+
+        /// If file is empty and engine_url_skip_empty_files=1, skip it and go to the next file.
+        if (context->getSettingsRef().engine_url_skip_empty_files && buf_factory->getFileSize() == 0)
+            return initialize();
 
         curr_uri = actual_uri;
 
@@ -292,6 +298,7 @@ StorageURLSource::StorageURLSource(
 
         pipeline = std::make_unique<QueryPipeline>(QueryPipelineBuilder::getPipeline(std::move(builder)));
         reader = std::make_unique<PullingPipelineExecutor>(*pipeline);
+        return true;
     };
 }
 
@@ -306,14 +313,8 @@ Chunk StorageURLSource::generate()
             break;
         }
 
-        if (!reader)
-        {
-            auto current_uri = (*uri_iterator)();
-            if (current_uri.empty())
-                return {};
-
-            initialize(current_uri);
-        }
+        if (!reader && !initialize())
+            return {};
 
         Chunk chunk;
         if (reader->pull(chunk))
@@ -592,10 +593,16 @@ ColumnsDescription IStorageURLBase::getTableStructureFromData(
     if (context->getSettingsRef().schema_inference_use_cache_for_url)
         columns_from_cache = tryGetColumnsFromCache(urls_to_check, headers, credentials, format, format_settings, context);
 
-    ReadBufferIterator read_buffer_iterator = [&, it = urls_to_check.cbegin()](ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
+    ReadBufferIterator read_buffer_iterator = [&, it = urls_to_check.cbegin(), first = true](ColumnsDescription & columns) mutable -> std::unique_ptr<ReadBuffer>
     {
         if (it == urls_to_check.cend())
+        {
+            if (first)
+                throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                            "Cannot extract table structure from {} format file, because all files are empty. "
+                            "You must specify table structure manually", format);
             return nullptr;
+        }
 
         auto [_, buf_factory] = StorageURLSource::getFirstAvailableURIAndReadBuffer(
             it,
@@ -609,7 +616,13 @@ ColumnsDescription IStorageURLBase::getTableStructureFromData(
             headers,
             false,
             false);
+
         ++it;
+
+        if (context->getSettingsRef().engine_url_skip_empty_files && buf_factory->getFileSize() == 0)
+            return read_buffer_iterator(columns);
+
+        first = false;
         return wrapReadBufferWithCompressionMethod(
             buf_factory->getReader(),
             compression_method,
diff --git a/src/Storages/StorageURL.h b/src/Storages/StorageURL.h
index d53b72105e4..4cd4b66e69a 100644
--- a/src/Storages/StorageURL.h
+++ b/src/Storages/StorageURL.h
@@ -197,7 +197,7 @@ public:
         bool delay_initialization);
 
 private:
-    using InitializeFunc = std::function<void(const FailoverOptions &)>;
+    using InitializeFunc = std::function<bool()>;
     InitializeFunc initialize;
 
     String name;
diff --git a/tests/integration/test_storage_hdfs/test.py b/tests/integration/test_storage_hdfs/test.py
index edf5344e887..5ac1d3bea6f 100644
--- a/tests/integration/test_storage_hdfs/test.py
+++ b/tests/integration/test_storage_hdfs/test.py
@@ -816,6 +816,56 @@ def test_hdfsCluster_unset_skip_unavailable_shards(started_cluster):
     )
 
 
+def test_skip_empty_files(started_cluster):
+    node = started_cluster.instances["node1"]
+
+    node.query(
+        f"insert into function hdfs('hdfs://hdfs1:9000/skip_empty_files1.parquet', TSVRaw) select * from numbers(0) settings hdfs_truncate_on_insert=1"
+    )
+
+    node.query(
+        f"insert into function hdfs('hdfs://hdfs1:9000/skip_empty_files2.parquet') select * from numbers(1) settings hdfs_truncate_on_insert=1"
+    )
+
+    node.query_and_get_error(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files1.parquet') settings hdfs_skip_empty_files=0"
+    )
+
+    node.query_and_get_error(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files1.parquet', auto, 'number UINt64') settings hdfs_skip_empty_files=0"
+    )
+
+    node.query_and_get_error(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files1.parquet') settings hdfs_skip_empty_files=1"
+    )
+
+    res = node.query(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files1.parquet', auto, 'number UInt64') settings hdfs_skip_empty_files=1"
+    )
+
+    assert len(res) == 0
+
+    node.query_and_get_error(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files*.parquet') settings hdfs_skip_empty_files=0"
+    )
+
+    node.query_and_get_error(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files*.parquet', auto, 'number UInt64') settings hdfs_skip_empty_files=0"
+    )
+
+    res = node.query(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files*.parquet') settings hdfs_skip_empty_files=1"
+    )
+
+    assert int(res) == 0
+
+    res = node.query(
+        f"select * from hdfs('hdfs://hdfs1:9000/skip_empty_files*.parquet', auto, 'number UInt64') settings hdfs_skip_empty_files=1"
+    )
+
+    assert int(res) == 0
+
+
 if __name__ == "__main__":
     cluster.start()
     input("Cluster created, press any key to destroy...")
diff --git a/tests/integration/test_storage_s3/test.py b/tests/integration/test_storage_s3/test.py
index d9ac70f51ad..516c8ed152a 100644
--- a/tests/integration/test_storage_s3/test.py
+++ b/tests/integration/test_storage_s3/test.py
@@ -1713,3 +1713,58 @@ def test_s3_list_objects_failure(started_cluster):
 
         assert ei.value.returncode == 243
         assert "Could not list objects" in ei.value.stderr
+
+
+def test_skip_empty_files(started_cluster):
+    bucket = started_cluster.minio_bucket
+    instance = started_cluster.instances["dummy"]
+
+
+    instance.query(
+        f"insert into function s3('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet', TSVRaw) select * from numbers(0) settings s3_truncate_on_insert=1"
+    )
+
+    instance.query(
+        f"insert into function s3('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files2.parquet') select * from numbers(1) settings s3_truncate_on_insert=1"
+    )
+    def test(engine, setting):
+        instance.query_and_get_error(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet') settings {setting}=0"
+        )
+    
+        instance.query_and_get_error(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet', auto, 'number UINt64') settings {setting}=0"
+        )
+    
+        instance.query_and_get_error(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet') settings {setting}=1"
+        )
+    
+        res = instance.query(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet', auto, 'number UInt64') settings {setting}=1"
+        )
+    
+        assert len(res) == 0
+
+        instance.query_and_get_error(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet') settings {setting}=0"
+        )
+    
+        instance.query_and_get_error(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet', auto, 'number UInt64') settings {setting}=0"
+        )
+    
+        res = instance.query(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet') settings {setting}=1"
+        )
+    
+        assert int(res) == 0
+    
+        res = instance.query(
+            f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet', auto, 'number UInt64') settings {setting}=1"
+        )
+    
+        assert int(res) == 0
+
+    test("s3", "s3_skip_empty_files")
+    test("url", "engine_url_skip_empty_files")
diff --git a/tests/queries/0_stateless/02771_skip_empty_files.reference b/tests/queries/0_stateless/02771_skip_empty_files.reference
new file mode 100644
index 00000000000..83f2e99acd0
--- /dev/null
+++ b/tests/queries/0_stateless/02771_skip_empty_files.reference
@@ -0,0 +1,7 @@
+1
+1
+1
+1
+1
+0
+0
diff --git a/tests/queries/0_stateless/02771_skip_empty_files.sh b/tests/queries/0_stateless/02771_skip_empty_files.sh
new file mode 100755
index 00000000000..99f43d7868a
--- /dev/null
+++ b/tests/queries/0_stateless/02771_skip_empty_files.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+FILE_PREFIX=$CLICKHOUSE_TEST_UNIQUE_NAME
+touch $FILE_PREFIX-1.parquet
+$CLICKHOUSE_LOCAL -q "select * from numbers(1) format Parquet" > $FILE_PREFIX-2.parquet
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-1.parquet') settings engine_file_skip_empty_files=0" 2>&1 | grep -c "CANNOT_EXTRACT_TABLE_STRUCTURE"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-1.parquet', auto, 'number UInt64') settings engine_file_skip_empty_files=0" 2>&1 | grep -c "Exception"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-1.parquet') settings engine_file_skip_empty_files=1" 2>&1 | grep -c "Exception"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-1.parquet', auto, 'number UInt64') settings engine_file_skip_empty_files=1"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet') settings engine_file_skip_empty_files=0" 2>&1 | grep -c "Exception"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet', auto, 'number UInt64') settings engine_file_skip_empty_files=0" 2>&1 | grep -c "Exception"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet') settings engine_file_skip_empty_files=1"
+$CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet', auto, 'number UInt64') settings engine_file_skip_empty_files=1"
+
+
+
+
+
+
+rm $FILE_PREFIX-*

From 38634cc5c5221a6ec646fc11dff34deda7c6b7d2 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Wed, 24 May 2023 13:49:18 +0100
Subject: [PATCH 142/722] Convert Clickhouse Types to MySQL types in
 Compatibility mode

This changes MySQL compatibility mode to display MySQL compatible types
---
 src/DataTypes/DataTypeAggregateFunction.h     |   1 +
 src/DataTypes/DataTypeArray.h                 |   4 +
 src/DataTypes/DataTypeDate.h                  |   1 +
 src/DataTypes/DataTypeDate32.h                |   1 +
 src/DataTypes/DataTypeDateTime.h              |   1 +
 src/DataTypes/DataTypeDateTime64.h            |   1 +
 src/DataTypes/DataTypeEnum.cpp                |  24 ++++
 src/DataTypes/DataTypeEnum.h                  |   3 +
 src/DataTypes/DataTypeFixedString.h           |   1 +
 src/DataTypes/DataTypeFunction.h              |   1 +
 src/DataTypes/DataTypeIPv4andIPv6.h           |   4 +
 src/DataTypes/DataTypeInterval.h              |   1 +
 src/DataTypes/DataTypeLowCardinality.h        |   2 +
 src/DataTypes/DataTypeMap.h                   |   1 +
 src/DataTypes/DataTypeNothing.h               |   2 +
 src/DataTypes/DataTypeNullable.h              |   1 +
 src/DataTypes/DataTypeNumberBase.cpp          |  17 +++
 src/DataTypes/DataTypeNumberBase.h            |   3 +
 src/DataTypes/DataTypeObject.h                |   1 +
 src/DataTypes/DataTypeSet.h                   |   2 +
 src/DataTypes/DataTypeString.h                |   3 +
 src/DataTypes/DataTypeTuple.h                 |   1 +
 src/DataTypes/DataTypeUUID.h                  |   2 +
 src/DataTypes/DataTypesDecimal.h              |   3 +
 src/DataTypes/IDataType.h                     |  10 ++
 src/Storages/System/StorageSystemColumns.cpp  |  15 ++-
 .../02740_show_columns_mysql_compatibility.sh | 116 ++++++++++++++++++
 27 files changed, 221 insertions(+), 1 deletion(-)
 create mode 100755 tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh

diff --git a/src/DataTypes/DataTypeAggregateFunction.h b/src/DataTypes/DataTypeAggregateFunction.h
index 2d712d9c686..697be13652c 100644
--- a/src/DataTypes/DataTypeAggregateFunction.h
+++ b/src/DataTypes/DataTypeAggregateFunction.h
@@ -45,6 +45,7 @@ public:
     String doGetName() const override;
     String getNameWithoutVersion() const;
     const char * getFamilyName() const override { return "AggregateFunction"; }
+    const char * getMySQLName() const override { return "text"; }
     TypeIndex getTypeId() const override { return TypeIndex::AggregateFunction; }
 
     Array getParameters() const { return parameters; }
diff --git a/src/DataTypes/DataTypeArray.h b/src/DataTypes/DataTypeArray.h
index 033a657c845..35462df9a4e 100644
--- a/src/DataTypes/DataTypeArray.h
+++ b/src/DataTypes/DataTypeArray.h
@@ -30,6 +30,10 @@ public:
     {
         return "Array";
     }
+    const char * getMySQLName() const override
+    {
+        return "string";
+    }
 
     bool canBeInsideNullable() const override
     {
diff --git a/src/DataTypes/DataTypeDate.h b/src/DataTypes/DataTypeDate.h
index 2f17207cc07..33bcb6123ff 100644
--- a/src/DataTypes/DataTypeDate.h
+++ b/src/DataTypes/DataTypeDate.h
@@ -13,6 +13,7 @@ public:
 
     TypeIndex getTypeId() const override { return TypeIndex::Date; }
     const char * getFamilyName() const override { return family_name; }
+    const char * getMySQLName() const override { return "date"; }
 
     bool canBeUsedAsVersion() const override { return true; }
     bool canBeInsideNullable() const override { return true; }
diff --git a/src/DataTypes/DataTypeDate32.h b/src/DataTypes/DataTypeDate32.h
index 9160b62dc15..56315f46e8c 100644
--- a/src/DataTypes/DataTypeDate32.h
+++ b/src/DataTypes/DataTypeDate32.h
@@ -13,6 +13,7 @@ public:
 
     TypeIndex getTypeId() const override { return TypeIndex::Date32; }
     const char * getFamilyName() const override { return family_name; }
+    const char * getMySQLName() const override { return "date"; }
 
     Field getDefault() const override
     {
diff --git a/src/DataTypes/DataTypeDateTime.h b/src/DataTypes/DataTypeDateTime.h
index 91a09ff7cb9..c868f92c311 100644
--- a/src/DataTypes/DataTypeDateTime.h
+++ b/src/DataTypes/DataTypeDateTime.h
@@ -36,6 +36,7 @@ public:
     static constexpr auto family_name = "DateTime";
 
     const char * getFamilyName() const override { return family_name; }
+    const char * getMySQLName() const override { return "datetime"; }
     String doGetName() const override;
     TypeIndex getTypeId() const override { return TypeIndex::DateTime; }
 
diff --git a/src/DataTypes/DataTypeDateTime64.h b/src/DataTypes/DataTypeDateTime64.h
index aaa99485040..8d317bb9430 100644
--- a/src/DataTypes/DataTypeDateTime64.h
+++ b/src/DataTypes/DataTypeDateTime64.h
@@ -28,6 +28,7 @@ public:
     DataTypeDateTime64(UInt32 scale_, const TimezoneMixin & time_zone_info);
 
     const char * getFamilyName() const override { return family_name; }
+    const char * getMySQLName() const override { return "datetime"; }
     std::string doGetName() const override;
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeEnum.cpp b/src/DataTypes/DataTypeEnum.cpp
index 3c3ac2ae4e2..bfed4d4d5a2 100644
--- a/src/DataTypes/DataTypeEnum.cpp
+++ b/src/DataTypes/DataTypeEnum.cpp
@@ -36,6 +36,29 @@ const char * DataTypeEnum<Type>::getFamilyName() const
     return EnumName<FieldType>::value;
 }
 
+template <typename Type>
+std::string DataTypeEnum<Type>::generateMySQLName(const Values & values)
+{
+    WriteBufferFromOwnString out;
+
+    writeString("enum", out);
+    writeChar('(', out);
+
+    auto first = true;
+    for (const auto & name_and_value : values)
+    {
+        if (!first)
+            writeString(", ", out);
+
+        first = false;
+
+        writeQuotedString(name_and_value.first, out);
+    }
+
+    writeChar(')', out);
+
+    return out.str();
+}
 
 template <typename Type>
 std::string DataTypeEnum<Type>::generateName(const Values & values)
@@ -67,6 +90,7 @@ template <typename Type>
 DataTypeEnum<Type>::DataTypeEnum(const Values & values_)
     : EnumValues<Type>(values_)
     , type_name(generateName(this->getValues()))
+    , my_sql_type_name(generateMySQLName(this->getValues()))
 {
 }
 
diff --git a/src/DataTypes/DataTypeEnum.h b/src/DataTypes/DataTypeEnum.h
index 2f607fc2aa6..c6e523adf96 100644
--- a/src/DataTypes/DataTypeEnum.h
+++ b/src/DataTypes/DataTypeEnum.h
@@ -45,13 +45,16 @@ public:
 
 private:
     std::string type_name;
+    std::string my_sql_type_name;
     static std::string generateName(const Values & values);
+    static std::string generateMySQLName(const Values & values);
 
 public:
     explicit DataTypeEnum(const Values & values_);
 
     std::string doGetName() const override { return type_name; }
     const char * getFamilyName() const override;
+    const char * getMySQLName() const override { return my_sql_type_name.c_str(); }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeFixedString.h b/src/DataTypes/DataTypeFixedString.h
index 8d114121c1a..eb09914ec9c 100644
--- a/src/DataTypes/DataTypeFixedString.h
+++ b/src/DataTypes/DataTypeFixedString.h
@@ -42,6 +42,7 @@ public:
     TypeIndex getTypeId() const override { return type_id; }
 
     const char * getFamilyName() const override { return "FixedString"; }
+    const char * getMySQLName() const override { return "text"; }
 
     size_t getN() const
     {
diff --git a/src/DataTypes/DataTypeFunction.h b/src/DataTypes/DataTypeFunction.h
index 888bcb6a775..f3423796126 100644
--- a/src/DataTypes/DataTypeFunction.h
+++ b/src/DataTypes/DataTypeFunction.h
@@ -24,6 +24,7 @@ public:
 
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Function"; }
+    const char * getMySQLName() const override { return "text"; }
     TypeIndex getTypeId() const override { return TypeIndex::Function; }
 
     const DataTypes & getArgumentTypes() const
diff --git a/src/DataTypes/DataTypeIPv4andIPv6.h b/src/DataTypes/DataTypeIPv4andIPv6.h
index ad70bdae933..8f7fe79793b 100644
--- a/src/DataTypes/DataTypeIPv4andIPv6.h
+++ b/src/DataTypes/DataTypeIPv4andIPv6.h
@@ -19,6 +19,8 @@ public:
     static constexpr auto type_id = TypeToTypeIndex<IPv4>;
 
     const char * getFamilyName() const override { return TypeName<IPv4>.data(); }
+    const char * getMySQLName() const override { return "text"; }
+
     TypeIndex getTypeId() const override { return type_id; }
 
     Field getDefault() const override { return IPv4{}; }
@@ -59,6 +61,8 @@ public:
     static constexpr auto type_id = TypeToTypeIndex<IPv6>;
 
     const char * getFamilyName() const override { return TypeName<IPv6>.data(); }
+    const char * getMySQLName() const override { return "text"; }
+
     TypeIndex getTypeId() const override { return type_id; }
 
     Field getDefault() const override { return IPv6{}; }
diff --git a/src/DataTypes/DataTypeInterval.h b/src/DataTypes/DataTypeInterval.h
index 05abe1d9b24..69a56e8aadd 100644
--- a/src/DataTypes/DataTypeInterval.h
+++ b/src/DataTypes/DataTypeInterval.h
@@ -26,6 +26,7 @@ public:
 
     std::string doGetName() const override { return fmt::format("Interval{}", kind.toString()); }
     const char * getFamilyName() const override { return "Interval"; }
+    const char * getMySQLName() const override { return "text"; }
     TypeIndex getTypeId() const override { return TypeIndex::Interval; }
 
     bool equals(const IDataType & rhs) const override;
diff --git a/src/DataTypes/DataTypeLowCardinality.h b/src/DataTypes/DataTypeLowCardinality.h
index d301a0f5443..6fd4344311c 100644
--- a/src/DataTypes/DataTypeLowCardinality.h
+++ b/src/DataTypes/DataTypeLowCardinality.h
@@ -22,6 +22,8 @@ public:
         return "LowCardinality(" + dictionary_type->getName() + ")";
     }
     const char * getFamilyName() const override { return "LowCardinality"; }
+    const char * getMySQLName() const override { return "text"; }
+
     TypeIndex getTypeId() const override { return TypeIndex::LowCardinality; }
 
     MutableColumnPtr createColumn() const override;
diff --git a/src/DataTypes/DataTypeMap.h b/src/DataTypes/DataTypeMap.h
index 4712f6bbdef..526dc321f44 100644
--- a/src/DataTypes/DataTypeMap.h
+++ b/src/DataTypes/DataTypeMap.h
@@ -30,6 +30,7 @@ public:
     TypeIndex getTypeId() const override { return TypeIndex::Map; }
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Map"; }
+    const char * getMySQLName() const override { return "json"; }
 
     bool canBeInsideNullable() const override { return false; }
 
diff --git a/src/DataTypes/DataTypeNothing.h b/src/DataTypes/DataTypeNothing.h
index c7d12388de9..fdef6026603 100644
--- a/src/DataTypes/DataTypeNothing.h
+++ b/src/DataTypes/DataTypeNothing.h
@@ -16,6 +16,8 @@ public:
     static constexpr bool is_parametric = false;
 
     const char * getFamilyName() const override { return "Nothing"; }
+    const char * getMySQLName() const override { return "text"; }
+
     TypeIndex getTypeId() const override { return TypeIndex::Nothing; }
 
     MutableColumnPtr createColumn() const override;
diff --git a/src/DataTypes/DataTypeNullable.h b/src/DataTypes/DataTypeNullable.h
index 06d46fb15ed..64b201d32b2 100644
--- a/src/DataTypes/DataTypeNullable.h
+++ b/src/DataTypes/DataTypeNullable.h
@@ -16,6 +16,7 @@ public:
     explicit DataTypeNullable(const DataTypePtr & nested_data_type_);
     std::string doGetName() const override { return "Nullable(" + nested_data_type->getName() + ")"; }
     const char * getFamilyName() const override { return "Nullable"; }
+    const char * getMySQLName() const override { return nested_data_type->getMySQLName(); }
     TypeIndex getTypeId() const override { return TypeIndex::Nullable; }
 
     MutableColumnPtr createColumn() const override;
diff --git a/src/DataTypes/DataTypeNumberBase.cpp b/src/DataTypes/DataTypeNumberBase.cpp
index f668a4c522e..cd5e73ac4a1 100644
--- a/src/DataTypes/DataTypeNumberBase.cpp
+++ b/src/DataTypes/DataTypeNumberBase.cpp
@@ -30,6 +30,23 @@ bool DataTypeNumberBase<T>::isValueRepresentedByUnsignedInteger() const
     return is_integer<T> && is_unsigned_v<T>;
 }
 
+template <typename T>
+const std::map<std::string, std::string> DataTypeNumberBase<T>::mysqlTypeMap = {
+    {"UInt8", "tinyint unsigned"},
+    {"UInt16", "smallint unsigned"},
+    {"UInt32", "mediumint unsigned"},
+    {"UInt64", "bigint unsigned"},
+    {"UInt128", "bigint unsigned"},
+    {"UInt256", "bigint unsigned"},
+    {"Int8", "tinyint"},
+    {"Int16", "smallint"},
+    {"Int32", "int"},
+    {"Int64", "bigint"},
+    {"Int128", "bigint"},
+    {"Int256", "bigint"},
+    {"Float32", "float"},
+    {"Float64", "double"},
+};
 
 /// Explicit template instantiations - to avoid code bloat in headers.
 template class DataTypeNumberBase<UInt8>;
diff --git a/src/DataTypes/DataTypeNumberBase.h b/src/DataTypes/DataTypeNumberBase.h
index 3a5b11c5124..b5c963cf245 100644
--- a/src/DataTypes/DataTypeNumberBase.h
+++ b/src/DataTypes/DataTypeNumberBase.h
@@ -20,11 +20,14 @@ public:
     static constexpr bool is_parametric = false;
     static constexpr auto family_name = TypeName<T>;
     static constexpr auto type_id = TypeToTypeIndex<T>;
+    // Create a map from the name of the type to the name of the type in MySQL.
+    static const std::map<std::string, std::string> mysqlTypeMap;
 
     using FieldType = T;
     using ColumnType = ColumnVector<T>;
 
     const char * getFamilyName() const override { return TypeName<T>.data(); }
+    const char * getMySQLName() const override { return mysqlTypeMap.at(TypeName<T>.data()).c_str(); }
     TypeIndex getTypeId() const override { return TypeToTypeIndex<T>; }
 
     Field getDefault() const override;
diff --git a/src/DataTypes/DataTypeObject.h b/src/DataTypes/DataTypeObject.h
index 937a9091371..8a2c36abcd7 100644
--- a/src/DataTypes/DataTypeObject.h
+++ b/src/DataTypes/DataTypeObject.h
@@ -23,6 +23,7 @@ public:
     DataTypeObject(const String & schema_format_, bool is_nullable_);
 
     const char * getFamilyName() const override { return "Object"; }
+    const char * getMySQLName() const override { return "json"; }
     String doGetName() const override;
     TypeIndex getTypeId() const override { return TypeIndex::Object; }
 
diff --git a/src/DataTypes/DataTypeSet.h b/src/DataTypes/DataTypeSet.h
index 7ddfeb9fe30..bdad638b5d5 100644
--- a/src/DataTypes/DataTypeSet.h
+++ b/src/DataTypes/DataTypeSet.h
@@ -15,6 +15,8 @@ class DataTypeSet final : public IDataTypeDummy
 public:
     static constexpr bool is_parametric = true;
     const char * getFamilyName() const override { return "Set"; }
+    const char * getMySQLName() const override { return "text"; }
+
     TypeIndex getTypeId() const override { return TypeIndex::Set; }
     bool equals(const IDataType & rhs) const override { return typeid(rhs) == typeid(*this); }
     bool isParametric() const override { return true; }
diff --git a/src/DataTypes/DataTypeString.h b/src/DataTypes/DataTypeString.h
index 5f3bde43a13..3ac739fe68c 100644
--- a/src/DataTypes/DataTypeString.h
+++ b/src/DataTypes/DataTypeString.h
@@ -21,6 +21,9 @@ public:
         return "String";
     }
 
+    // FIXME: string can contain arbitrary bytes, not only UTF-8 sequences
+    const char * getMySQLName() const override { return "text"; }
+
     TypeIndex getTypeId() const override { return type_id; }
 
     MutableColumnPtr createColumn() const override;
diff --git a/src/DataTypes/DataTypeTuple.h b/src/DataTypes/DataTypeTuple.h
index 152f21015f5..d264cc97f60 100644
--- a/src/DataTypes/DataTypeTuple.h
+++ b/src/DataTypes/DataTypeTuple.h
@@ -33,6 +33,7 @@ public:
     TypeIndex getTypeId() const override { return TypeIndex::Tuple; }
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Tuple"; }
+    const char * getMySQLName() const override { return "json"; }
 
     bool canBeInsideNullable() const override { return false; }
     bool supportsSparseSerialization() const override { return true; }
diff --git a/src/DataTypes/DataTypeUUID.h b/src/DataTypes/DataTypeUUID.h
index af9f1f35ca5..4d54db42b45 100644
--- a/src/DataTypes/DataTypeUUID.h
+++ b/src/DataTypes/DataTypeUUID.h
@@ -18,6 +18,8 @@ public:
     static constexpr auto type_id = TypeIndex::UUID;
 
     const char * getFamilyName() const override { return "UUID"; }
+    const char * getMySQLName() const override { return "char"; }
+
     TypeIndex getTypeId() const override { return type_id; }
 
     Field getDefault() const override;
diff --git a/src/DataTypes/DataTypesDecimal.h b/src/DataTypes/DataTypesDecimal.h
index 583f7ea804a..5c9405cb060 100644
--- a/src/DataTypes/DataTypesDecimal.h
+++ b/src/DataTypes/DataTypesDecimal.h
@@ -37,8 +37,11 @@ public:
     using Base::Base;
 
     static constexpr auto family_name = "Decimal";
+    static constexpr auto mysql_name = "decimal";
 
     const char * getFamilyName() const override { return family_name; }
+    const char * getMySQLName() const override { return mysql_name; }
+
     std::string doGetName() const override;
     TypeIndex getTypeId() const override { return TypeToTypeIndex<T>; }
     bool canBePromoted() const override { return true; }
diff --git a/src/DataTypes/IDataType.h b/src/DataTypes/IDataType.h
index 7cc18fea00c..2bed18897ce 100644
--- a/src/DataTypes/IDataType.h
+++ b/src/DataTypes/IDataType.h
@@ -71,10 +71,19 @@ public:
           return doGetName();
     }
 
+    /// MySQL equivalent Name of data type (examples: UInt64, Array(String)).
+    String getMySQLTypeName() const
+    {
+        if (custom_name)
+            return custom_name->getName();
+        else
+            return doGetMySQLName();
+    }
     DataTypePtr getPtr() const { return shared_from_this(); }
 
     /// Name of data type family (example: FixedString, Array).
     virtual const char * getFamilyName() const = 0;
+    virtual const char * getMySQLName() const = 0;
 
     /// Data type id. It's used for runtime type checks.
     virtual TypeIndex getTypeId() const = 0;
@@ -126,6 +135,7 @@ public:
 
 protected:
     virtual String doGetName() const { return getFamilyName(); }
+    virtual String doGetMySQLName() const { return getMySQLName(); }
     virtual SerializationPtr doGetDefaultSerialization() const = 0;
 
 public:
diff --git a/src/Storages/System/StorageSystemColumns.cpp b/src/Storages/System/StorageSystemColumns.cpp
index 18e7d269795..f391a392dbb 100644
--- a/src/Storages/System/StorageSystemColumns.cpp
+++ b/src/Storages/System/StorageSystemColumns.cpp
@@ -74,6 +74,7 @@ public:
         : ISource(header_)
         , columns_mask(std::move(columns_mask_)), max_block_size(max_block_size_)
         , databases(std::move(databases_)), tables(std::move(tables_)), storages(std::move(storages_))
+        , clientInfo(context->getClientInfo())
         , total_tables(tables->size()), access(context->getAccess())
         , query_id(context->getCurrentQueryId()), lock_acquire_timeout(context->getSettingsRef().lock_acquire_timeout)
     {
@@ -129,6 +130,17 @@ protected:
 
             bool check_access_for_columns = check_access_for_tables && !access->isGranted(AccessType::SHOW_COLUMNS, database_name, table_name);
 
+            auto get_type_name = [this](const IDataType& type) -> std::string
+            {
+                if (clientInfo.interface == DB::ClientInfo::Interface::MYSQL)
+                {
+                   return type.getMySQLTypeName();
+                }
+                else
+                {
+                    return type.getName();
+                }
+            };
             size_t position = 0;
             for (const auto & column : columns)
             {
@@ -146,7 +158,7 @@ protected:
                 if (columns_mask[src_index++])
                     res_columns[res_index++]->insert(column.name);
                 if (columns_mask[src_index++])
-                    res_columns[res_index++]->insert(column.type->getName());
+                    res_columns[res_index++]->insert(get_type_name(*column.type));
                 if (columns_mask[src_index++])
                     res_columns[res_index++]->insert(position);
 
@@ -281,6 +293,7 @@ private:
     ColumnPtr databases;
     ColumnPtr tables;
     Storages storages;
+    ClientInfo clientInfo;
     size_t db_table_num = 0;
     size_t total_tables;
     std::shared_ptr<const ContextAccess> access;
diff --git a/tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh
new file mode 100755
index 00000000000..7f828d35679
--- /dev/null
+++ b/tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh
@@ -0,0 +1,116 @@
+#!/bin/bash
+
+# This script tests the MySQL compatibility of the SHOW COLUMNS command in ClickHouse
+USER="default"
+PASSWORD=""
+HOST="127.0.0.1"
+PORT=9004
+
+# First run the clickhouse test to create the ClickHouse Tables
+
+echo "Drop tables if they exist"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
+${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
+
+echo "Create tab table "
+${CLICKHOUSE_LOCAL} --query "
+    CREATE TABLE tab
+    (
+        uint64 UInt64,
+        int32 Nullable(Int32),
+        float32 Float32,
+        float64 Float64,
+        decimal_value Decimal(10, 2),
+        boolean_value UInt8, -- Use 0 for false, 1 for true
+        string_value String,
+        fixed_string_value FixedString(10),
+        date_value Date,
+        date32_value Date32,
+        datetime_value DateTime,
+        datetime64_value DateTime64(3),
+        json_value String, -- Store JSON as a string
+        uuid_value UUID,
+        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
+        low_cardinality LowCardinality(String),
+        array_value Array(Int32),
+        map_value Map(String, Int32),
+        tuple_value Tuple(Int32, String),
+        nullable_value Nullable(Int32),
+        ipv4_value IPv4,
+        ipv6_value IPv6,
+        nested Nested
+        (
+            nested_int Int32,
+            nested_string String
+        )
+    ) ENGINE = MergeTree
+    ORDER BY uint64;
+    "
+
+
+echo "Create pseudo-random database name"
+${CLICKHOUSE_LOCAL} --query "CREATE DATABASE database_123456789abcde;"
+
+echo "Create tab duplicate table"
+${CLICKHOUSE_LOCAL} --query "
+    CREATE TABLE database_123456789abcde.tab
+    (
+        uint64 UInt64,
+        int32 Nullable(Int32),
+        float32 Float32,
+        float64 Float64,
+        decimal_value Decimal(10, 2),
+        boolean_value UInt8, -- Use 0 for false, 1 for true
+        string_value String,
+        fixed_string_value FixedString(10),
+        date_value Date,
+        date32_value Date32,
+        datetime_value DateTime,
+        datetime64_value DateTime64(3),
+        json_value String, -- Store JSON as a string
+        uuid_value UUID,
+        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
+        low_cardinality LowCardinality(String),
+        array_value Array(Int32),
+        map_value Map(String, Int32),
+        tuple_value Tuple(Int32, String),
+        nullable_value Nullable(Int32),
+        ipv4_value IPv4,
+        ipv6_value IPv6,
+        nested Nested
+        (
+            nested_int Int32,
+            nested_string String
+        )
+    ) ENGINE = MergeTree
+    ORDER BY uint64;
+    "
+
+# Write sql to temp file 
+TEMP_FILE=$(mktemp)
+
+cat <<EOT > $TEMP_FILE
+SHOW COLUMNS FROM tab;
+SHOW EXTENDED COLUMNS FROM tab;
+SHOW FULL COLUMNS FROM tab;
+SHOW COLUMNS FROM tab LIKE '%int%';
+SHOW COLUMNS FROM tab NOT LIKE '%int%';
+SHOW COLUMNS FROM tab ILIKE '%INT%';
+SHOW COLUMNS FROM tab NOT ILIKE '%INT%';
+SHOW COLUMNS FROM tab WHERE field LIKE '%int%';
+SHOW COLUMNS FROM tab LIMIT 1;
+SHOW COLUMNS FROM tab;
+SHOW COLUMNS FROM tab FROM database_123456789abcde;
+SHOW COLUMNS FROM database_123456789abcde.tab;
+DROP DATABASE database_123456789abcde;
+DROP TABLE tab;
+EOT
+
+# Now run the MySQL test script on the ClickHouse DB
+echo "Run MySQL test"
+mysql --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
+
+# Clean up the temp file
+rm $TEMP_FILE
+

From bd5a1ae2b97b66361e5b958811a6055f8f5cd2ae Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Tue, 30 May 2023 13:32:33 -0700
Subject: [PATCH 143/722] Revert "Change SHOW COLUMNS query to display MySQL
 types in MySQL Compatibility mode"

This reverts commit ddbad79c5e67518acebbacaad5be0cad3967ac67.
---
 .../InterpreterShowColumnsQuery.cpp           |  76 +------
 .../InterpreterShowColumnsQuery.h             |   1 -
 ...show_columns_mysql_compatibility.reference | 213 ------------------
 .../02726_show_columns_mysql_compatibility.sh | 115 ----------
 4 files changed, 3 insertions(+), 402 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
 delete mode 100755 tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh

diff --git a/src/Interpreters/InterpreterShowColumnsQuery.cpp b/src/Interpreters/InterpreterShowColumnsQuery.cpp
index 0ad93e37b58..c86d3c753c4 100644
--- a/src/Interpreters/InterpreterShowColumnsQuery.cpp
+++ b/src/Interpreters/InterpreterShowColumnsQuery.cpp
@@ -42,11 +42,9 @@ SELECT
     if (default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default,
     '' AS extra )";
 
-        rewritten_query += getMySQLQuery();
-    }
-    else {
-        rewritten_query += "SELECT name AS field, type AS type, startsWith(type, 'Nullable') AS null, trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key, if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default, '' AS extra ";
-    }
+    // TODO Interpret query.extended. It is supposed to show internal/virtual columns. Need to fetch virtual column names, see
+    // IStorage::getVirtuals(). We can't easily do that via SQL.
+
     if (query.full)
     {
         /// "Full" mode is mostly for MySQL compat
@@ -90,74 +88,6 @@ WHERE
     return rewritten_query;
 }
 
-String InterpreterShowColumnsQuery::getMySQLQuery()
-{
-    String mysql_specific_query;
-
-    mysql_specific_query = R"(SELECT name AS field,
-        CASE
-          WHEN startsWith(type, 'Nullable') THEN
-            CASE
-              WHEN substring(type, 10, length(type) - 10) IN ('UInt8', 'Int8') THEN 'tinyint'
-              WHEN substring(type, 10, length(type) - 10) IN ('UInt16', 'Int16') THEN 'smallint'
-              WHEN substring(type, 10, length(type) - 10) IN ('UInt32', 'Int32') THEN 'int'
-              WHEN substring(type, 10, length(type) - 10) IN ('UInt64', 'Int64', 'UInt128', 'Int128', 'UInt256', 'Int256') THEN 'bigint'
-              WHEN substring(type, 10, length(type) - 10) = 'Float32' THEN 'float'
-              WHEN substring(type, 10, length(type) - 10) = 'Float64' THEN 'double'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'Decimal%' THEN 'decimal'
-              WHEN substring(type, 10, length(type) - 10) = 'Boolean' THEN 'tinyint'
-              WHEN substring(type, 10, length(type) - 10) = 'String' THEN 'text'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'FixedString%' THEN 'text'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'Date%' THEN 'date'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'DateTime%' THEN 'datetime'
-              WHEN substring(type, 10, length(type) - 10) = 'JSON' THEN 'json'
-              WHEN substring(type, 10, length(type) - 10) = 'UUID' THEN 'binary'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'Enum%' THEN 'enum'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'LowCardinality%' THEN 'text'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'Array%' THEN 'json'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'Map%' THEN 'json'
-              WHEN substring(type, 10, length(type) - 10) IN ('SimpleAggregateFunction', 'AggregateFunction') THEN 'text'
-              WHEN substring(type, 10, length(type) - 10) = 'Nested' THEN 'json'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'Tuple%' THEN 'json'
-              WHEN substring(type, 10, length(type) - 10) LIKE 'IPv%' THEN 'text'
-              WHEN substring(type, 10, length(type) - 10) IN ('Expression', 'Set', 'Nothing', 'Interval') THEN 'text'
-              ELSE substring(type, 10, length(type) - 10)
-            END
-          ELSE
-            CASE
-              WHEN type IN ('UInt8', 'Int8') THEN 'tinyint'
-              WHEN type IN ('UInt16', 'Int16') THEN 'smallint'
-              WHEN type IN ('UInt32', 'Int32') THEN 'int'
-              WHEN type IN ('UInt64', 'Int64', 'UInt128', 'Int128', 'UInt256', 'Int256') THEN 'bigint'
-              WHEN type = 'Float32' THEN 'float'
-              WHEN type = 'Float64' THEN 'double'
-              WHEN type LIKE 'Decimal%' THEN 'decimal'
-              WHEN type = 'Boolean' THEN 'tinyint'
-              WHEN type = 'String' THEN 'text'
-              WHEN type LIKE 'FixedString%' THEN 'text'
-              WHEN type LIKE 'Date%' THEN 'date'
-              WHEN type LIKE 'DateTime%' THEN 'datetime'
-              WHEN type = 'JSON' THEN 'json'
-              WHEN type = 'UUID' THEN 'binary'
-              WHEN type LIKE 'Enum%' THEN 'enum'
-              WHEN type LIKE 'LowCardinality%' THEN 'text'
-              WHEN type LIKE 'Array%' THEN 'json'
-              WHEN type LIKE 'Map%' THEN 'json'
-              WHEN type IN ('SimpleAggregateFunction', 'AggregateFunction') THEN 'text'
-              WHEN type = 'Nested' THEN 'json'
-              WHEN type LIKE 'Tuple%' THEN 'json'
-              WHEN type LIKE 'IPv%' THEN 'text'
-              WHEN type IN ('Expression', 'Set', 'Nothing', 'Interval') THEN 'text'
-              ELSE type
-            END
-        END AS type,
-        startsWith(type, 'Nullable') AS null,
-        trim(concatWithSeparator(' ', if(is_in_primary_key, 'PRI', ''), if (is_in_sorting_key, 'SOR', ''))) AS key,
-        if(default_kind IN ('ALIAS', 'DEFAULT', 'MATERIALIZED'), default_expression, NULL) AS default,
-        '' AS extra )";
-
-    return mysql_specific_query.str();
-}
 
 BlockIO InterpreterShowColumnsQuery::execute()
 {
diff --git a/src/Interpreters/InterpreterShowColumnsQuery.h b/src/Interpreters/InterpreterShowColumnsQuery.h
index b843a163978..ee6dcabd97b 100644
--- a/src/Interpreters/InterpreterShowColumnsQuery.h
+++ b/src/Interpreters/InterpreterShowColumnsQuery.h
@@ -26,7 +26,6 @@ private:
     ASTPtr query_ptr;
 
     String getRewrittenQuery();
-    String getMySQLQuery();
 };
 
 
diff --git a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
deleted file mode 100644
index c9ad94a34c4..00000000000
--- a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.reference
+++ /dev/null
@@ -1,213 +0,0 @@
-Drop tables if they exist
-Create tab table 
-Create pseudo-random database name
-Create tab duplicate table
-Run MySQL test
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-uuid_value	binary	0		NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-uuid_value	binary	0		NULL	
-field	type	null	key	default	extra	collation	comment	privileges
-array_value	json	0		NULL		NULL		
-boolean_value	tinyint	0		NULL		NULL		
-date32_value	date	0		NULL		NULL		
-date_value	date	0		NULL		NULL		
-datetime64_value	date	0		NULL		NULL		
-datetime_value	date	0		NULL		NULL		
-decimal_value	decimal	0		NULL		NULL		
-enum_value	enum	0		NULL		NULL		
-fixed_string_value	text	0		NULL		NULL		
-float32	float	0		NULL		NULL		
-float64	double	0		NULL		NULL		
-int32	int	0		NULL		NULL		
-ipv4_value	text	0		NULL		NULL		
-ipv6_value	text	0		NULL		NULL		
-json_value	text	0		NULL		NULL		
-low_cardinality	text	0		NULL		NULL		
-map_value	json	0		NULL		NULL		
-nested.nested_int	json	0		NULL		NULL		
-nested.nested_string	json	0		NULL		NULL		
-nullable_value	int	0		NULL		NULL		
-string_value	text	0		NULL		NULL		
-tuple_value	json	0		NULL		NULL		
-uint64	bigint	0	PRI SOR	NULL		NULL		
-uuid_value	binary	0		NULL		NULL		
-field	type	null	key	default	extra
-int32	int	0		NULL	
-nested.nested_int	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uuid_value	binary	0		NULL	
-field	type	null	key	default	extra
-int32	int	0		NULL	
-nested.nested_int	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uuid_value	binary	0		NULL	
-field	type	null	key	default	extra
-int32	int	0		NULL	
-nested.nested_int	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-uuid_value	binary	0		NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-uuid_value	binary	0		NULL	
-field	type	null	key	default	extra
-array_value	json	0		NULL	
-boolean_value	tinyint	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	date	0		NULL	
-datetime_value	date	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	text	0		NULL	
-low_cardinality	text	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	json	0		NULL	
-nested.nested_string	json	0		NULL	
-nullable_value	int	0		NULL	
-string_value	text	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint	0	PRI SOR	NULL	
-uuid_value	binary	0		NULL	
diff --git a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh
deleted file mode 100755
index 5324496edd3..00000000000
--- a/tests/queries/0_stateless/02726_show_columns_mysql_compatibility.sh
+++ /dev/null
@@ -1,115 +0,0 @@
-#!/bin/bash
-
-# This script tests the MySQL compatibility of the SHOW COLUMNS command in ClickHouse
-USER="default"
-PASSWORD=""
-HOST="127.0.0.1"
-PORT=9004
-
-# First run the clickhouse test to create the ClickHouse Tables
-
-echo "Drop tables if they exist"
-${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
-${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
-${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
-
-echo "Create tab table "
-${CLICKHOUSE_LOCAL} --query "
-    CREATE TABLE tab
-    (
-        uint64 UInt64,
-        int32 Nullable(Int32),
-        float32 Float32,
-        float64 Float64,
-        decimal_value Decimal(10, 2),
-        boolean_value UInt8, -- Use 0 for false, 1 for true
-        string_value String,
-        fixed_string_value FixedString(10),
-        date_value Date,
-        date32_value Date32,
-        datetime_value DateTime,
-        datetime64_value DateTime64(3),
-        json_value String, -- Store JSON as a string
-        uuid_value UUID,
-        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
-        low_cardinality LowCardinality(String),
-        array_value Array(Int32),
-        map_value Map(String, Int32),
-        tuple_value Tuple(Int32, String),
-        nullable_value Nullable(Int32),
-        ipv4_value IPv4,
-        ipv6_value IPv6,
-        nested Nested
-        (
-            nested_int Int32,
-            nested_string String
-        )
-    ) ENGINE = MergeTree
-    ORDER BY uint64;
-    "
-
-
-echo "Create pseudo-random database name"
-${CLICKHOUSE_LOCAL} --query "CREATE DATABASE database_123456789abcde;"
-
-echo "Create tab duplicate table"
-${CLICKHOUSE_LOCAL} --query "
-    CREATE TABLE database_123456789abcde.tab
-    (
-        uint64 UInt64,
-        int32 Nullable(Int32),
-        float32 Float32,
-        float64 Float64,
-        decimal_value Decimal(10, 2),
-        boolean_value UInt8, -- Use 0 for false, 1 for true
-        string_value String,
-        fixed_string_value FixedString(10),
-        date_value Date,
-        date32_value Date32,
-        datetime_value DateTime,
-        datetime64_value DateTime64(3),
-        json_value String, -- Store JSON as a string
-        uuid_value UUID,
-        enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
-        low_cardinality LowCardinality(String),
-        array_value Array(Int32),
-        map_value Map(String, Int32),
-        tuple_value Tuple(Int32, String),
-        nullable_value Nullable(Int32),
-        ipv4_value IPv4,
-        ipv6_value IPv6,
-        nested Nested
-        (
-            nested_int Int32,
-            nested_string String
-        )
-    ) ENGINE = MergeTree
-    ORDER BY uint64;
-    "
-
-# Write sql to temp file 
-TEMP_FILE=$(mktemp)
-
-cat <<EOT > $TEMP_FILE
-SHOW COLUMNS FROM tab;
-SHOW EXTENDED COLUMNS FROM tab;
-SHOW FULL COLUMNS FROM tab;
-SHOW COLUMNS FROM tab LIKE '%int%';
-SHOW COLUMNS FROM tab NOT LIKE '%int%';
-SHOW COLUMNS FROM tab ILIKE '%INT%';
-SHOW COLUMNS FROM tab NOT ILIKE '%INT%';
-SHOW COLUMNS FROM tab WHERE field LIKE '%int%';
-SHOW COLUMNS FROM tab LIMIT 1;
-SHOW COLUMNS FROM tab;
-SHOW COLUMNS FROM tab FROM database_123456789abcde;
-SHOW COLUMNS FROM database_123456789abcde.tab;
-DROP DATABASE database_123456789abcde;
-DROP TABLE tab;
-EOT
-
-# Now run the MySQL test script on the ClickHouse DB
-echo "Run MySQL test"
-mysql --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
-
-# Clean up the temp file
-rm $TEMP_FILE

From e6e420da5517e61f2940cc9b349a62ed192e9822 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 31 May 2023 13:00:55 +0200
Subject: [PATCH 144/722] Add no-fasttest tag

---
 tests/queries/0_stateless/02771_skip_empty_files.sh | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/tests/queries/0_stateless/02771_skip_empty_files.sh b/tests/queries/0_stateless/02771_skip_empty_files.sh
index 99f43d7868a..2d1dc205dcd 100755
--- a/tests/queries/0_stateless/02771_skip_empty_files.sh
+++ b/tests/queries/0_stateless/02771_skip_empty_files.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Tags: no-fasttest
 
 CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
@@ -16,9 +17,4 @@ $CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet', auto, 'number
 $CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet') settings engine_file_skip_empty_files=1"
 $CLICKHOUSE_LOCAL -q "select * from file('$FILE_PREFIX-*.parquet', auto, 'number UInt64') settings engine_file_skip_empty_files=1"
 
-
-
-
-
-
 rm $FILE_PREFIX-*

From 444ce60aeb4cda9ac2e5c61bbc0ae03cc76cd2b2 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Wed, 31 May 2023 11:50:25 +0000
Subject: [PATCH 145/722] Add tests with explicit cast

---
 .../01746_convert_type_with_default.reference | 47 +++++++++++++-----
 .../01746_convert_type_with_default.sql       | 48 ++++++++++++++++---
 2 files changed, 77 insertions(+), 18 deletions(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 235a88157c8..892a12434b9 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -20,17 +20,40 @@
 2
 -1
 -2
-1970-01-01
-2023-05-30
-2023-05-30
-2023-05-30
-1970-01-01
-2023-05-30
-2023-05-30
-1970-01-01
-2023-05-30 14:38:20
-2023-05-30 14:38:20
-2023-05-30 14:38:20
-2023-05-30 14:38:20
 61f0c404-5cb3-11e7-907b-a6006ad3dba0
 59f0c404-5cb3-11e7-907b-a6006ad3dba0
+1970-01-01
+2023-05-30
+2023-05-30
+2023-05-30
+1970-01-01
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+1970-01-20
+2023-05-30
+1970-01-01
+2023-05-30 14:38:20
+2023-05-30 14:38:20
+2023-05-30 14:38:20
+2023-05-30 14:38:20
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
+1970-01-01 00:00:19
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 40e4798721b..9fdd92491a7 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -26,19 +26,55 @@ select toUInt256OrDefault('1xx', cast(2 as UInt256));
 select toInt256OrDefault('-1', cast(-2 as Int256));
 select toInt256OrDefault('-1xx', cast(-2 as Int256));
 
-select toDateOrDefault('2020-0x-02');
+SELECT toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
+SELECT toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
+
+select toDateOrDefault('1xxx');
 select toDateOrDefault('2023-05-30');
 select toDateOrDefault('2023-05-30', '2000-01-01'::Date);
-select toDateOrDefault('2020-0x-02', '2023-05-30'::Date);
+select toDateOrDefault('1xx', '2023-05-30'::Date);
 select toDateOrDefault(-1);
-select toDateOrDefault(19507);
+
+select toDateOrDefault(cast(19 as Int8));
+select toDateOrDefault(cast(19 as UInt8));
+
+select toDateOrDefault(cast(19 as Int16));
+select toDateOrDefault(cast(19 as UInt16));
+
+select toDateOrDefault(cast(19 as Int32));
+select toDateOrDefault(cast(19 as UInt32));
+
+select toDateOrDefault(cast(19 as Int64));
+select toDateOrDefault(cast(19 as UInt64));
+
+select toDateOrDefault(cast(19 as Int128));
+select toDateOrDefault(cast(19 as UInt128));
+
+select toDateOrDefault(cast(19 as Int256));
+select toDateOrDefault(cast(19 as UInt256));
+
 select toDateOrDefault(19507, '2000-01-01'::Date);
 select toDateOrDefault(-1, '2000-01-01'::Date);
 
 select toDateTimeOrDefault('2023-05-30 14:38:20');
 select toDateTimeOrDefault('2023-05-30 14:38:20', 'UTC');
-select toString(toDateTimeOrDefault('s2023', 'Asia/Istanbul', '2023-05-30 14:38:20'::DateTime('Asia/Istanbul')), 'Asia/Istanbul');
+select toString(toDateTimeOrDefault('1xxx', 'Asia/Istanbul', '2023-05-30 14:38:20'::DateTime('Asia/Istanbul')), 'Asia/Istanbul');
 select toDateTimeOrDefault(1685457500);
 
-SELECT toUUIDOrDefault('61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
-SELECT toUUIDOrDefault('-----61f0c404-5cb3-11e7-907b-a6006ad3dba0', cast('59f0c404-5cb3-11e7-907b-a6006ad3dba0' as UUID));
\ No newline at end of file
+select toDateTimeOrDefault(cast(19 as Int8));
+select toDateTimeOrDefault(cast(19 as UInt8));
+
+select toDateTimeOrDefault(cast(19 as Int16));
+select toDateTimeOrDefault(cast(19 as UInt16));
+
+select toDateTimeOrDefault(cast(19 as Int32));
+select toDateTimeOrDefault(cast(19 as UInt32));
+
+select toDateTimeOrDefault(cast(19 as Int64));
+select toDateTimeOrDefault(cast(19 as UInt64));
+
+select toDateTimeOrDefault(cast(19 as Int128));
+select toDateTimeOrDefault(cast(19 as UInt128));
+
+select toDateTimeOrDefault(cast(19 as Int256));
+select toDateTimeOrDefault(cast(19 as UInt256));
\ No newline at end of file

From 0d4ed32baca8eb2d897bcfd66eed0d04781af166 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <99031427+yakov-olkhovskiy@users.noreply.github.com>
Date: Wed, 31 May 2023 11:25:33 -0400
Subject: [PATCH 146/722] better exception message

---
 src/Functions/FunctionsCodingIP.h | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/Functions/FunctionsCodingIP.h b/src/Functions/FunctionsCodingIP.h
index bd53fa7e043..9d090abb736 100644
--- a/src/Functions/FunctionsCodingIP.h
+++ b/src/Functions/FunctionsCodingIP.h
@@ -341,7 +341,11 @@ ColumnPtr convertIPv6ToIPv4(ColumnPtr column, const PaddedPODArray<UInt8> * null
         {
             if constexpr (exception_mode == IPStringToNumExceptionMode::Throw)
             {
-                throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "IPv6 in column {} is not in IPv4 mapping block", column->getName());
+                char addr[IPV6_MAX_TEXT_LENGTH + 1] {};
+                char * paddr = addr;
+                formatIPv6(src, paddr);
+
+                throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "IPv6 {} in column {} is not in IPv4 mapping block", addr, column->getName());
             }
             else if constexpr (exception_mode == IPStringToNumExceptionMode::Default)
             {

From 3af7e0a6fa21d570f78fcf9366c299e3199d2b77 Mon Sep 17 00:00:00 2001
From: Yakov Olkhovskiy <99031427+yakov-olkhovskiy@users.noreply.github.com>
Date: Wed, 31 May 2023 11:26:58 -0400
Subject: [PATCH 147/722] better exception message

---
 src/Functions/FunctionsConversion.h | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 4d4efc84df1..6d22fb661c3 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -310,7 +310,13 @@ struct ConvertImpl
                                 const uint8_t ip4_cidr[] {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0x00, 0x00, 0x00, 0x00};
                                 const uint8_t * src = reinterpret_cast<const uint8_t *>(&vec_from[i].toUnderType());
                                 if (!matchIPv6Subnet(src, ip4_cidr, 96))
-                                    throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "IPv6 in column {} is not in IPv4 mapping block", named_from.column->getName());
+                                {
+                                    char addr[IPV6_MAX_TEXT_LENGTH + 1] {};
+                                    char * paddr = addr;
+                                    formatIPv6(src, paddr);
+
+                                    throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "IPv6 {} in column {} is not in IPv4 mapping block", addr, named_from.column->getName());
+                                }
 
                                 uint8_t * dst = reinterpret_cast<uint8_t *>(&vec_to[i].toUnderType());
                                 if constexpr (std::endian::native == std::endian::little)

From 3936c4dc52f24b477cfb5bf4821bb17626bd69df Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Wed, 31 May 2023 16:41:26 +0000
Subject: [PATCH 148/722] Try to fix fast tests (add timezone)

---
 .../01746_convert_type_with_default.sql       | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 9fdd92491a7..75e1510f330 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -58,23 +58,23 @@ select toDateOrDefault(-1, '2000-01-01'::Date);
 
 select toDateTimeOrDefault('2023-05-30 14:38:20');
 select toDateTimeOrDefault('2023-05-30 14:38:20', 'UTC');
-select toString(toDateTimeOrDefault('1xxx', 'Asia/Istanbul', '2023-05-30 14:38:20'::DateTime('Asia/Istanbul')), 'Asia/Istanbul');
-select toDateTimeOrDefault(1685457500);
+select toDateTimeOrDefault('1xxx', 'UTC', '2023-05-30 14:38:20'::DateTime('UTC'));
+select toDateTimeOrDefault(1685457500, 'UTC');
 
-select toDateTimeOrDefault(cast(19 as Int8));
-select toDateTimeOrDefault(cast(19 as UInt8));
+select toDateTimeOrDefault(cast(19 as Int8), 'UTC');
+select toDateTimeOrDefault(cast(19 as UInt8), 'UTC');
 
-select toDateTimeOrDefault(cast(19 as Int16));
-select toDateTimeOrDefault(cast(19 as UInt16));
+select toDateTimeOrDefault(cast(19 as Int16), 'UTC');
+select toDateTimeOrDefault(cast(19 as UInt16), 'UTC');
 
-select toDateTimeOrDefault(cast(19 as Int32));
-select toDateTimeOrDefault(cast(19 as UInt32));
+select toDateTimeOrDefault(cast(19 as Int32), 'UTC');
+select toDateTimeOrDefault(cast(19 as UInt32), 'UTC');
 
-select toDateTimeOrDefault(cast(19 as Int64));
-select toDateTimeOrDefault(cast(19 as UInt64));
+select toDateTimeOrDefault(cast(19 as Int64), 'UTC');
+select toDateTimeOrDefault(cast(19 as UInt64), 'UTC');
 
-select toDateTimeOrDefault(cast(19 as Int128));
-select toDateTimeOrDefault(cast(19 as UInt128));
+select toDateTimeOrDefault(cast(19 as Int128), 'UTC');
+select toDateTimeOrDefault(cast(19 as UInt128), 'UTC');
 
-select toDateTimeOrDefault(cast(19 as Int256));
-select toDateTimeOrDefault(cast(19 as UInt256));
\ No newline at end of file
+select toDateTimeOrDefault(cast(19 as Int256), 'UTC');
+select toDateTimeOrDefault(cast(19 as UInt256), 'UTC');
\ No newline at end of file

From 0b62be649f9974a4433897b39fb8a59e9e7f30f2 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Wed, 31 May 2023 17:52:29 +0000
Subject: [PATCH 149/722] Add docs, fix style

---
 .../table-engines/integrations/hdfs.md        |  6 ++
 .../engines/table-engines/integrations/s3.md  |  6 ++
 docs/en/engines/table-engines/special/file.md |  8 ++
 docs/en/engines/table-engines/special/url.md  |  4 +
 docs/en/operations/settings/settings.md       | 92 ++++++++++++++-----
 docs/en/sql-reference/table-functions/file.md | 12 ++-
 docs/en/sql-reference/table-functions/hdfs.md |  6 ++
 docs/en/sql-reference/table-functions/s3.md   |  6 ++
 docs/en/sql-reference/table-functions/url.md  |  4 +
 src/Storages/StorageURL.cpp                   |  4 -
 tests/integration/test_storage_s3/test.py     | 20 ++--
 11 files changed, 130 insertions(+), 38 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/hdfs.md b/docs/en/engines/table-engines/integrations/hdfs.md
index b9db0fae68f..b37ccb00ba6 100644
--- a/docs/en/engines/table-engines/integrations/hdfs.md
+++ b/docs/en/engines/table-engines/integrations/hdfs.md
@@ -233,6 +233,12 @@ libhdfs3 support HDFS namenode HA.
 - `_path` — Path to the file.
 - `_file` — Name of the file.
 
+## Storage Settings {#storage-settings}
+
+- [hdfs_truncate_on_insert](/docs/en/operations/settings/settings.md#hdfs-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
+- [hdfs_create_multiple_files](/docs/en/operations/settings/settings.md#hdfs_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
+- [hdfs_skip_empty_files](/docs/en/operations/settings/settings.md#hdfs_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+
 **See Also**
 
 - [Virtual columns](../../../engines/table-engines/index.md#table_engines-virtual_columns)
diff --git a/docs/en/engines/table-engines/integrations/s3.md b/docs/en/engines/table-engines/integrations/s3.md
index 595bc0c344f..e8d0ab6255d 100644
--- a/docs/en/engines/table-engines/integrations/s3.md
+++ b/docs/en/engines/table-engines/integrations/s3.md
@@ -127,6 +127,12 @@ CREATE TABLE table_with_asterisk (name String, value UInt32)
     ENGINE = S3('https://clickhouse-public-datasets.s3.amazonaws.com/my-bucket/{some,another}_folder/*', 'CSV');
 ```
 
+## Storage Settings {#storage-settings}
+
+- [s3_truncate_on_insert](/docs/en/operations/settings/settings.md#s3-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
+- [s3_create_multiple_files](/docs/en/operations/settings/settings.md#s3_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
+- [s3_skip_empty_files](/docs/en/operations/settings/settings.md#s3_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+
 ## S3-related Settings {#settings}
 
 The following settings can be set before query execution or placed into configuration file.
diff --git a/docs/en/engines/table-engines/special/file.md b/docs/en/engines/table-engines/special/file.md
index 9c4e87487b4..cf325961b6a 100644
--- a/docs/en/engines/table-engines/special/file.md
+++ b/docs/en/engines/table-engines/special/file.md
@@ -92,3 +92,11 @@ $ echo -e "1,2\n3,4" | clickhouse-local -q "CREATE TABLE table (a Int64, b Int64
 `PARTITION BY` — Optional.  It is possible to create separate files by partitioning the data on a partition key. In most cases, you don't need a partition key, and if it is needed you generally don't need a partition key more granular than by month. Partitioning does not speed up queries (in contrast to the ORDER BY expression). You should never use too granular partitioning. Don't partition your data by client identifiers or names (instead, make client identifier or name the first column in the ORDER BY expression).
 
 For partitioning by month, use the `toYYYYMM(date_column)` expression, where `date_column` is a column with a date of the type [Date](/docs/en/sql-reference/data-types/date.md). The partition names here have the `"YYYYMM"` format.
+
+## Settings {#settings}
+
+- [engine_file_empty_if_not_exists](/docs/en/operations/settings/settings.md#engine-file-emptyif-not-exists) - allows to select empty data from a file that doesn't exist. Disabled by default.
+- [engine_file_truncate_on_insert](/docs/en/operations/settings/settings.md#engine-file-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
+- [engine_file_allow_create_multiple_files](/docs/en/operations/settings/settings.md#engine_file_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
+- [engine_file_skip_empty_files](/docs/en/operations/settings/settings.md#engine_file_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+- [storage_file_read_method](/docs/en/operations/settings/settings.md#engine-file-emptyif-not-exists) - method of reading data from storage file, one of: read, pread, mmap (only for clickhouse-local). Default value: `pread` for clickhouse-server, `mmap` for clickhouse-local.
diff --git a/docs/en/engines/table-engines/special/url.md b/docs/en/engines/table-engines/special/url.md
index a4530767e11..26d4975954f 100644
--- a/docs/en/engines/table-engines/special/url.md
+++ b/docs/en/engines/table-engines/special/url.md
@@ -102,3 +102,7 @@ SELECT * FROM url_engine_table
 `PARTITION BY` — Optional.  It is possible to create separate files by partitioning the data on a partition key. In most cases, you don't need a partition key, and if it is needed you generally don't need a partition key more granular than by month. Partitioning does not speed up queries (in contrast to the ORDER BY expression). You should never use too granular partitioning. Don't partition your data by client identifiers or names (instead, make client identifier or name the first column in the ORDER BY expression).
 
 For partitioning by month, use the `toYYYYMM(date_column)` expression, where `date_column` is a column with a date of the type [Date](/docs/en/sql-reference/data-types/date.md). The partition names here have the `"YYYYMM"` format.
+
+## Storage Settings {#storage-settings}
+
+- [engine_url_skip_empty_files](/docs/en/operations/settings/settings.md#engine_url_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 4f3b4e43358..ac3e624387e 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3195,27 +3195,7 @@ Possible values:
 
 Default value: `0`.
 
-## s3_truncate_on_insert
-
-Enables or disables truncate before inserts in s3 engine tables. If disabled, an exception will be thrown on insert attempts if an S3 object already exists.
-
-Possible values:
-- 0 — `INSERT` query appends new data to the end of the file.
-- 1 — `INSERT` query replaces existing content of the file with the new data.
-
-Default value: `0`.
-
-## hdfs_truncate_on_insert
-
-Enables or disables truncation before an insert in hdfs engine tables. If disabled, an exception will be thrown on an attempt to insert if a file in HDFS already exists.
-
-Possible values:
-- 0 — `INSERT` query appends new data to the end of the file.
-- 1 — `INSERT` query replaces existing content of the file with the new data.
-
-Default value: `0`.
-
-## engine_file_allow_create_multiple_files
+## engine_file_allow_create_multiple_files {#engine_file_allow_create_multiple_files}
 
 Enables or disables creating a new file on each insert in file engine tables if the format has the suffix (`JSON`, `ORC`, `Parquet`, etc.). If enabled, on each insert a new file will be created with a name following this pattern:
 
@@ -3227,7 +3207,33 @@ Possible values:
 
 Default value: `0`.
 
-## s3_create_new_file_on_insert
+## engine_file_skip_empty_files {#engine_file_skip_empty_files}
+
+Enables or disables skipping empty files in [File](../../engines/table-engines/special/file.md) engine tables.
+
+Possible values:
+- 0 — `SELECT` throws an exception if empty file is not compatible with requested format.
+- 1 — `SELECT` returns empty result for empty file.
+
+Default value: `0`.
+
+## storage_file_read_method {#storage_file_read_method}
+
+Method of reading data from storage file, one of: `read`, `pread`, `mmap`. The mmap method does not apply to clickhouse-server (it's intended for clickhouse-local).
+
+Default value: `pread` for clickhouse-server, `mmap` for clickhouse-local.
+
+## s3_truncate_on_insert {#s3_truncate_on_insert}
+
+Enables or disables truncate before inserts in s3 engine tables. If disabled, an exception will be thrown on insert attempts if an S3 object already exists.
+
+Possible values:
+- 0 — `INSERT` query appends new data to the end of the file.
+- 1 — `INSERT` query replaces existing content of the file with the new data.
+
+Default value: `0`.
+
+## s3_create_new_file_on_insert {#s3_create_new_file_on_insert}
 
 Enables or disables creating a new file on each insert in s3 engine tables. If enabled, on each insert a new S3 object will be created with the key, similar to this pattern:
 
@@ -3239,7 +3245,27 @@ Possible values:
 
 Default value: `0`.
 
-## hdfs_create_new_file_on_insert
+## s3_skip_empty_files {#s3_skip_empty_files}
+
+Enables or disables skipping empty files in [S3](../../engines/table-engines/special/s3.md) engine tables.
+
+Possible values:
+- 0 — `SELECT` throws an exception if empty file is not compatible with requested format.
+- 1 — `SELECT` returns empty result for empty file.
+
+Default value: `0`.
+
+## hdfs_truncate_on_insert {#hdfs_truncate_on_insert}
+
+Enables or disables truncation before an insert in hdfs engine tables. If disabled, an exception will be thrown on an attempt to insert if a file in HDFS already exists.
+
+Possible values:
+- 0 — `INSERT` query appends new data to the end of the file.
+- 1 — `INSERT` query replaces existing content of the file with the new data.
+
+Default value: `0`.
+
+## hdfs_create_new_file_on_insert {#hdfs_create_new_file_on_insert
 
 Enables or disables creating a new file on each insert in HDFS engine tables. If enabled, on each insert a new HDFS file will be created with the name, similar to this pattern:
 
@@ -3251,6 +3277,26 @@ Possible values:
 
 Default value: `0`.
 
+## hdfs_skip_empty_files {#hdfs_skip_empty_files}
+
+Enables or disables skipping empty files in [HDFS](../../engines/table-engines/special/hdfs.md) engine tables.
+
+Possible values:
+- 0 — `SELECT` throws an exception if empty file is not compatible with requested format.
+- 1 — `SELECT` returns empty result for empty file.
+
+Default value: `0`.
+
+## engine_url_skip_empty_files {#engine_url_skip_empty_files}
+
+Enables or disables skipping empty files in [URL](../../engines/table-engines/special/url.md) engine tables.
+
+Possible values:
+- 0 — `SELECT` throws an exception if empty file is not compatible with requested format.
+- 1 — `SELECT` returns empty result for empty file.
+
+Default value: `0`.
+
 ## database_atomic_wait_for_drop_and_detach_synchronously {#database_atomic_wait_for_drop_and_detach_synchronously}
 
 Adds a modifier `SYNC` to all `DROP` and `DETACH` queries.
diff --git a/docs/en/sql-reference/table-functions/file.md b/docs/en/sql-reference/table-functions/file.md
index 28c2dc9f1f3..b1903c990b1 100644
--- a/docs/en/sql-reference/table-functions/file.md
+++ b/docs/en/sql-reference/table-functions/file.md
@@ -18,7 +18,7 @@ file(path [,format] [,structure] [,compression])
 
 **Parameters**
 
-- `path` — The relative path to the file from [user_files_path](/docs/en/operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path). Path to file support following globs in read-only mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc', 'def'` — strings.
+- `path` — The relative path to the file from [user_files_path](/docs/en/operations/server-configuration-parameters/settings.md/#server_configuration_parameters-user_files_path). Path to file support following globs in read-only mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc', 'def'` — strings.
 - `format` — The [format](/docs/en/interfaces/formats.md#formats) of the file.
 - `structure` — Structure of the table. Format: `'column1_name column1_type, column2_name column2_type, ...'`.
 - `compression` — The existing compression type when used in a `SELECT` query, or the desired compression type when used in an `INSERT` query.  The supported compression types are `gz`, `br`, `xz`, `zst`, `lz4`, and `bz2`.
@@ -196,6 +196,16 @@ SELECT count(*) FROM file('big_dir/**/file002', 'CSV', 'name String, value UInt3
 - `_path` — Path to the file.
 - `_file` — Name of the file.
 
+## Settings
+
+- [engine_file_empty_if_not_exists](/docs/en/operations/settings/settings.md#engine-file-emptyif-not-exists) - allows to select empty data from a file that doesn't exist. Disabled by default.
+- [engine_file_truncate_on_insert](/docs/en/operations/settings/settings.md#engine-file-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
+- [engine_file_allow_create_multiple_files](/docs/en/operations/settings/settings.md#engine_file_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
+- [engine_file_skip_empty_files](/docs/en/operations/settings/settings.md#engine_file_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+- [storage_file_read_method](/docs/en/operations/settings/settings.md#engine-file-emptyif-not-exists) - method of reading data from storage file, one of: read, pread, mmap (only for clickhouse-local). Default value: `pread` for clickhouse-server, `mmap` for clickhouse-local.
+
+
+
 **See Also**
 
 - [Virtual columns](/docs/en/engines/table-engines/index.md#table_engines-virtual_columns)
diff --git a/docs/en/sql-reference/table-functions/hdfs.md b/docs/en/sql-reference/table-functions/hdfs.md
index 6ba24211131..1b52e786de4 100644
--- a/docs/en/sql-reference/table-functions/hdfs.md
+++ b/docs/en/sql-reference/table-functions/hdfs.md
@@ -97,6 +97,12 @@ FROM hdfs('hdfs://hdfs1:9000/big_dir/file{0..9}{0..9}{0..9}', 'CSV', 'name Strin
 - `_path` — Path to the file.
 - `_file` — Name of the file.
 
+## Storage Settings {#storage-settings}
+
+- [hdfs_truncate_on_insert](/docs/en/operations/settings/settings.md#hdfs-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
+- [hdfs_create_multiple_files](/docs/en/operations/settings/settings.md#hdfs_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
+- [hdfs_skip_empty_files](/docs/en/operations/settings/settings.md#hdfs_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+
 **See Also**
 
 - [Virtual columns](../../engines/table-engines/index.md#table_engines-virtual_columns)
diff --git a/docs/en/sql-reference/table-functions/s3.md b/docs/en/sql-reference/table-functions/s3.md
index a9ddc286ec5..7068c208022 100644
--- a/docs/en/sql-reference/table-functions/s3.md
+++ b/docs/en/sql-reference/table-functions/s3.md
@@ -202,6 +202,12 @@ FROM s3(
 LIMIT 5;
 ```
 
+## Storage Settings {#storage-settings}
+
+- [s3_truncate_on_insert](/docs/en/operations/settings/settings.md#s3-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
+- [s3_create_multiple_files](/docs/en/operations/settings/settings.md#s3_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
+- [s3_skip_empty_files](/docs/en/operations/settings/settings.md#s3_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+
 **See Also**
 
 - [S3 engine](../../engines/table-engines/integrations/s3.md)
diff --git a/docs/en/sql-reference/table-functions/url.md b/docs/en/sql-reference/table-functions/url.md
index f157a850a12..ac4162c15de 100644
--- a/docs/en/sql-reference/table-functions/url.md
+++ b/docs/en/sql-reference/table-functions/url.md
@@ -53,6 +53,10 @@ Character `|` inside patterns is used to specify failover addresses. They are it
 - `_path` — Path to the `URL`.
 - `_file` — Resource name of the `URL`.
 
+## Storage Settings {#storage-settings}
+
+- [engine_url_skip_empty_files](/docs/en/operations/settings/settings.md#engine_url_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
+
 **See Also**
 
 - [Virtual columns](/docs/en/engines/table-engines/index.md#table_engines-virtual_columns)
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index 706ce481a24..e882138bf0d 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -14,10 +14,8 @@
 #include <Parsers/ASTIdentifier.h>
 
 #include <IO/ConnectionTimeouts.h>
-#include <IO/ParallelReadBuffer.h>
 #include <IO/WriteBufferFromHTTP.h>
 #include <IO/WriteHelpers.h>
-#include <IO/WithFileSize.h>
 
 #include <Formats/FormatFactory.h>
 #include <Formats/ReadSchemaUtils.h>
@@ -29,7 +27,6 @@
 #include <Common/ThreadStatus.h>
 #include <Common/parseRemoteDescription.h>
 #include <Common/NamedCollections/NamedCollections.h>
-#include <IO/HTTPCommon.h>
 #include <IO/ReadWriteBufferFromHTTP.h>
 #include <IO/HTTPHeaderEntries.h>
 
@@ -48,7 +45,6 @@ namespace ErrorCodes
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
     extern const int NETWORK_ERROR;
     extern const int BAD_ARGUMENTS;
-    extern const int LOGICAL_ERROR;
     extern const int CANNOT_EXTRACT_TABLE_STRUCTURE;
 }
 
diff --git a/tests/integration/test_storage_s3/test.py b/tests/integration/test_storage_s3/test.py
index 516c8ed152a..174cbad1de4 100644
--- a/tests/integration/test_storage_s3/test.py
+++ b/tests/integration/test_storage_s3/test.py
@@ -1719,7 +1719,6 @@ def test_skip_empty_files(started_cluster):
     bucket = started_cluster.minio_bucket
     instance = started_cluster.instances["dummy"]
 
-
     instance.query(
         f"insert into function s3('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet', TSVRaw) select * from numbers(0) settings s3_truncate_on_insert=1"
     )
@@ -1727,43 +1726,44 @@ def test_skip_empty_files(started_cluster):
     instance.query(
         f"insert into function s3('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files2.parquet') select * from numbers(1) settings s3_truncate_on_insert=1"
     )
+
     def test(engine, setting):
         instance.query_and_get_error(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet') settings {setting}=0"
         )
-    
+
         instance.query_and_get_error(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet', auto, 'number UINt64') settings {setting}=0"
         )
-    
+
         instance.query_and_get_error(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet') settings {setting}=1"
         )
-    
+
         res = instance.query(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files1.parquet', auto, 'number UInt64') settings {setting}=1"
         )
-    
+
         assert len(res) == 0
 
         instance.query_and_get_error(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet') settings {setting}=0"
         )
-    
+
         instance.query_and_get_error(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet', auto, 'number UInt64') settings {setting}=0"
         )
-    
+
         res = instance.query(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet') settings {setting}=1"
         )
-    
+
         assert int(res) == 0
-    
+
         res = instance.query(
             f"select * from {engine}('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1,2}}.parquet', auto, 'number UInt64') settings {setting}=1"
         )
-    
+
         assert int(res) == 0
 
     test("s3", "s3_skip_empty_files")

From c9626314f7e7b128eccfd5fca7e04c9ff1fc45c5 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Wed, 31 May 2023 19:22:44 +0000
Subject: [PATCH 150/722] Better

---
 contrib/capnproto                             |    2 +-
 src/Formats/CapnProtoSerializer.cpp           | 1028 ++++++++---------
 ...lumnsStructureToQueryWithClusterEngine.cpp |   52 +
 ...ColumnsStructureToQueryWithClusterEngine.h |   14 +
 4 files changed, 529 insertions(+), 567 deletions(-)
 create mode 100644 src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp
 create mode 100644 src/Storages/addColumnsStructureToQueryWithClusterEngine.h

diff --git a/contrib/capnproto b/contrib/capnproto
index dc8b50b9997..976209a6d18 160000
--- a/contrib/capnproto
+++ b/contrib/capnproto
@@ -1 +1 @@
-Subproject commit dc8b50b999777bcb23c89bb5907c785c3f654441
+Subproject commit 976209a6d18074804f60d18ef99b6a809d27dadf
diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index 91e207a1846..e36f5fa4947 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -94,9 +94,21 @@ namespace
         std::vector<std::unique_ptr<FieldBuilder>> field_builders;
     };
 
+    template <typename ParentBuilder>
+    std::unique_ptr<StructBuilder> initStructBuilder(ParentBuilder & parent_builder, UInt32 offset_or_index, const capnp::_::StructSize & struct_size, size_t elements, const capnp::StructSchema & schema)
+    {
+        capnp::DynamicStruct::Builder builder_impl;
+        if constexpr (std::is_same_v<ParentBuilder, capnp::DynamicStruct::Builder>)
+            builder_impl = capnp::DynamicStruct::Builder(schema, parent_builder.getBuilderImpl().getPointerField(offset_or_index).initStruct(struct_size));
+        else
+            builder_impl = capnp::DynamicStruct::Builder(schema, parent_builder.getBuilderImpl().getStructElement(offset_or_index));
+        return std::make_unique<StructBuilder>(std::move(builder_impl), elements);
+    }
+
     class ICapnProtoSerializer
     {
     public:
+        /// Write row as struct field.
         virtual void writeRow(
             const ColumnPtr & column,
             std::unique_ptr<FieldBuilder> & builder,
@@ -104,6 +116,7 @@ namespace
             UInt32 slot_offset,
             size_t row_num) = 0;
 
+        /// Write row as list element.
         virtual void writeRow(
             const ColumnPtr & column,
             std::unique_ptr<FieldBuilder> & builder,
@@ -111,8 +124,10 @@ namespace
             UInt32 array_index,
             size_t row_num) = 0;
 
+        /// Read row from struct field at slot_offset.
         virtual void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) = 0;
 
+        /// Read row from list element at array_index.
         virtual void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) = 0;
 
         virtual ~ICapnProtoSerializer() = default;
@@ -124,32 +139,32 @@ namespace
     public:
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            CapnProtoNumericType value = static_cast<CapnProtoNumericType>(assert_cast<const ColumnVector<CHNumericType> &>(*column).getElement(row_num));
-            builder_impl.setDataField<CapnProtoNumericType>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<CapnProtoNumericType>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            CapnProtoNumericType value = static_cast<CapnProtoNumericType>(assert_cast<const ColumnVector<CHNumericType> &>(*column).getElement(row_num));
-            builder_impl.setDataElement<CapnProtoNumericType>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<CapnProtoNumericType>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            CapnProtoNumericType value = reader_impl.getDataField<CapnProtoNumericType>(slot_offset);
-            if constexpr (convert_to_bool_on_read)
-                assert_cast<ColumnUInt8 &>(column).insertValue(static_cast<bool>(value));
-            else
-                assert_cast<ColumnVector<CHNumericType> &>(column).insertValue(static_cast<CHNumericType>(value));
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<CapnProtoNumericType>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            CapnProtoNumericType value = reader_impl.getDataElement<CapnProtoNumericType>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<CapnProtoNumericType>(array_index));
+        }
+
+    private:
+        CapnProtoNumericType getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return static_cast<CapnProtoNumericType>(assert_cast<const ColumnVector<CHNumericType> &>(*column).getElement(row_num));
+        }
+
+        void insertValue(IColumn & column, CapnProtoNumericType value)
+        {
             if constexpr (convert_to_bool_on_read)
                 assert_cast<ColumnUInt8 &>(column).insertValue(static_cast<bool>(value));
             else
@@ -191,29 +206,32 @@ namespace
     public:
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            CapnProtoFloatType value = static_cast<CapnProtoFloatType>(assert_cast<const ColumnVector<CHFloatType> &>(*column).getElement(row_num));
-            builder_impl.setDataField<CapnProtoFloatType>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<CapnProtoFloatType>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            CapnProtoFloatType value = static_cast<CapnProtoFloatType>(assert_cast<const ColumnVector<CHFloatType> &>(*column).getElement(row_num));
-            builder_impl.setDataElement<CapnProtoFloatType>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<CapnProtoFloatType>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            CapnProtoFloatType value = reader_impl.getDataField<CapnProtoFloatType>(slot_offset);
-            assert_cast<ColumnVector<CHFloatType> &>(column).insertValue(static_cast<CHFloatType>(value));
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<CapnProtoFloatType>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            CapnProtoFloatType value = reader_impl.getDataElement<CapnProtoFloatType>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<CapnProtoFloatType>(array_index));
+        }
+
+    private:
+        CapnProtoFloatType getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return static_cast<CapnProtoFloatType>(assert_cast<const ColumnVector<CHFloatType> &>(*column).getElement(row_num));
+        }
+
+        void insertValue(IColumn & column, CapnProtoFloatType value)
+        {
             assert_cast<ColumnVector<CHFloatType> &>(column).insertValue(static_cast<CHFloatType>(value));
         }
     };
@@ -298,57 +316,41 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
-            UInt16 capnp_value;
-            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
-                capnp_value = static_cast<UInt16>(enum_value);
-            else
-                capnp_value = ch_to_capnp_values[enum_value];
-
-            builder_impl.setDataField<UInt16>(slot_offset, capnp_value);
+            parent_struct_builder.getBuilderImpl().setDataField<UInt16>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
-            UInt16 capnp_value;
-            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
-                capnp_value = static_cast<UInt16>(enum_value);
-            else
-                capnp_value = ch_to_capnp_values[enum_value];
-
-            builder_impl.setDataElement<UInt16>(array_index, capnp_value);
+            parent_list_builder.getBuilderImpl().setDataElement<UInt16>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            UInt16 capnp_value = reader_impl.getDataField<UInt16>(slot_offset);
-            EnumType value;
-            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
-                value = static_cast<EnumType>(capnp_value);
-            else
-                value = capnp_to_ch_values[capnp_value];
-            
-            assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<UInt16>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            UInt16 capnp_value = reader_impl.getDataElement<UInt16>(array_index);
-            EnumType value;
-            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
-                value = static_cast<EnumType>(capnp_value);
-            else
-                value = capnp_to_ch_values[capnp_value];
-            
-            assert_cast<ColumnVector<EnumType> &>(column).insertValue(value);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<UInt16>(array_index));
         }
 
     private:
+        UInt16 getValue(const ColumnPtr & column, size_t row_num)
+        {
+            EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                return static_cast<UInt16>(enum_value);
+            return ch_to_capnp_values[enum_value];
+        }
+
+        void insertValue(IColumn & column, UInt16 capnp_enum_value)
+        {
+            if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+                assert_cast<ColumnVector<EnumType> &>(column).insertValue(static_cast<EnumType>(capnp_enum_value));
+            else
+                assert_cast<ColumnVector<EnumType> &>(column).insertValue(capnp_to_ch_values[capnp_enum_value]);
+        }
+
         DataTypePtr data_type;
         capnp::EnumSchema enum_schema;
         const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode;
@@ -367,29 +369,32 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            UInt16 value = assert_cast<const ColumnDate &>(*column).getElement(row_num);
-            builder_impl.setDataField<UInt16>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<UInt16>(slot_offset, getValue(column, row_num));
         }
         
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            UInt16 value = assert_cast<const ColumnDate &>(*column).getElement(row_num);
-            builder_impl.setDataElement<UInt16>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<UInt16>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            UInt16 value = reader_impl.getDataField<UInt16>(slot_offset);
-            assert_cast<ColumnDate &>(column).insertValue(value);
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<UInt16>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            UInt16 value = reader_impl.getDataElement<UInt16>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<UInt16>(array_index));
+        }
+
+    private:
+        UInt16 getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return assert_cast<const ColumnDate &>(*column).getElement(row_num);
+        }
+
+        void insertValue(IColumn & column, UInt16 value)
+        {
             assert_cast<ColumnDate &>(column).insertValue(value);
         }
     };
@@ -405,29 +410,32 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            Int32 value = assert_cast<const ColumnDate32 &>(*column).getElement(row_num);
-            builder_impl.setDataField<Int32>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<Int32>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            Int32 value = assert_cast<const ColumnDate32 &>(*column).getElement(row_num);
-            builder_impl.setDataElement<Int32>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<Int32>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            Int32 value = reader_impl.getDataField<Int32>(slot_offset);
-            assert_cast<ColumnDate32 &>(column).insertValue(value);
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<Int32>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            Int32 value = reader_impl.getDataElement<Int32>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<Int32>(array_index));
+        }
+
+    private:
+        Int32 getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return assert_cast<const ColumnDate32 &>(*column).getElement(row_num);
+        }
+
+        void insertValue(IColumn & column, Int32 value)
+        {
             assert_cast<ColumnDate32 &>(column).insertValue(value);
         }
     };
@@ -443,29 +451,32 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            UInt32 value = assert_cast<const ColumnDateTime &>(*column).getElement(row_num);
-            builder_impl.setDataField<UInt32>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<UInt32>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            UInt32 value = assert_cast<const ColumnDateTime &>(*column).getElement(row_num);
-            builder_impl.setDataElement<UInt32>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<UInt32>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            UInt32 value = reader_impl.getDataField<UInt32>(slot_offset);
-            assert_cast<ColumnDateTime &>(column).insertValue(value);
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<UInt32>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            UInt32 value = reader_impl.getDataElement<UInt32>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<UInt32>(array_index));
+        }
+
+    private:
+        UInt32 getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return assert_cast<const ColumnDateTime &>(*column).getElement(row_num);
+        }
+
+        void insertValue(IColumn & column, UInt32 value)
+        {
             assert_cast<ColumnDateTime &>(column).insertValue(value);
         }
     };
@@ -481,29 +492,32 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            Int64 value = assert_cast<const ColumnDateTime64 &>(*column).getElement(row_num);
-            builder_impl.setDataField<Int64>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<Int64>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            Int64 value = assert_cast<const ColumnDateTime64 &>(*column).getElement(row_num);
-            builder_impl.setDataElement<Int64>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<Int64>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            Int64 value = reader_impl.getDataField<Int64>(slot_offset);
-            assert_cast<ColumnDateTime64 &>(column).insertValue(value);
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<Int64>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            Int64 value = reader_impl.getDataElement<Int64>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<Int64>(array_index));
+        }
+
+    private:
+        Int64 getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return assert_cast<const ColumnDateTime64 &>(*column).getElement(row_num);
+        }
+
+        void insertValue(IColumn & column, Int64 value)
+        {
             assert_cast<ColumnDateTime64 &>(column).insertValue(value);
         }
     };
@@ -523,275 +537,36 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            DecimalType value = assert_cast<const ColumnDecimal<DecimalType> &>(*column).getElement(row_num);
-            builder_impl.setDataField<NativeType>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<NativeType>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            DecimalType value = assert_cast<const ColumnDecimal<DecimalType> &>(*column).getElement(row_num);
-            builder_impl.setDataElement<NativeType>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<NativeType>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            NativeType value = reader_impl.getDataField<NativeType>(slot_offset);
-            assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(value);
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<NativeType>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            NativeType value = reader_impl.getDataElement<NativeType>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<NativeType>(array_index));
+        }
+
+    private:
+        NativeType getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return assert_cast<const ColumnDecimal<DecimalType> &>(*column).getElement(row_num);
+        }
+
+        void insertValue(IColumn & column, NativeType value)
+        {
             assert_cast<ColumnDecimal<DecimalType> &>(column).insertValue(value);
         }
     };
 
-    template <typename T>
-    class CapnProtoFixedSizeRawDataSerializer : public ICapnProtoSerializer
-    {
-    private:
-        static constexpr size_t value_size = sizeof(T);
-
-    public:
-        CapnProtoFixedSizeRawDataSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
-        {
-            if (!capnp_type.isData())
-                throwCannotConvert(data_type, column_name, capnp_type);
-        }
-
-        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
-        {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            auto data = column->getDataAt(row_num);
-            capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
-            builder_impl.getPointerField(slot_offset).template setBlob<capnp::Data>(value);
-        }
-
-        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
-        {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            auto data = column->getDataAt(row_num);
-            capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
-            builder_impl.getPointerElement(array_index).setBlob<capnp::Data>(value);
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
-        {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            capnp::Data::Reader value = reader_impl.getPointerField(slot_offset).template getBlob<capnp::Data>(nullptr, 0);
-            if (value.size() != value_size)
-                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
-
-            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
-        {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            capnp::Data::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0);
-            if (value.size() != value_size)
-                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), value.size());
-
-            column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-        }
-
-    private:
-        DataTypePtr data_type;
-    };
-
-    template <bool is_binary>
-    class CapnProtoStringSerializer : public ICapnProtoSerializer
-    {
-    public:
-        CapnProtoStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
-        {
-            if (!capnp_type.isData() && !capnp_type.isText())
-                throwCannotConvert(data_type, column_name, capnp_type);
-        }
-
-        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
-        {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            auto data = column->getDataAt(row_num);
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
-                builder_impl.getPointerField(slot_offset).setBlob<capnp::Data>(value);
-            }
-            else
-            {
-                capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
-                builder_impl.getPointerField(slot_offset).setBlob<capnp::Text>(value);
-            }
-        }
-
-        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
-        {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            auto data = column->getDataAt(row_num);
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
-                builder_impl.getPointerElement(array_index).setBlob<capnp::Data>(value);
-            }
-            else
-            {
-                capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
-                builder_impl.getPointerElement(array_index).setBlob<capnp::Text>(value);
-            }
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
-        {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Data>(nullptr, 0);
-                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-            else
-            {
-                capnp::Text::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Text>(nullptr, 0);
-                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
-        {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0);
-                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-            else
-            {
-                capnp::Text::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Text>(nullptr, 0);
-                column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-        }
-    };
-
-    template <bool is_binary>
-    class CapnProtoFixedStringSerializer : public ICapnProtoSerializer
-    {
-    public:
-        CapnProtoFixedStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
-        {
-            if (!capnp_type.isData() && !capnp_type.isText())
-                throwCannotConvert(data_type, column_name, capnp_type);
-        }
-
-        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
-        {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            auto data = column->getDataAt(row_num);
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
-                builder_impl.getPointerField(slot_offset).setBlob<capnp::Data>(value);
-            }
-            else
-            {
-                if (data.data[data.size - 1] == 0)
-                {
-                    capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
-                    builder_impl.getPointerField(slot_offset).setBlob<capnp::Text>(value);
-                }
-                else
-                {
-                    /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
-                    /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
-                    /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
-                    /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
-                    tmp_string = data.toString();
-                    capnp::Text::Reader value = capnp::Text::Reader(tmp_string.data(), tmp_string.size());
-                    builder_impl.getPointerField(slot_offset).setBlob<capnp::Text>(value);
-                }
-            }
-        }
-
-        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
-        {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            auto data = column->getDataAt(row_num);
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
-                builder_impl.getPointerElement(array_index).setBlob<capnp::Data>(value);
-            }
-            else
-            {
-                if (data.data[data.size - 1] == 0)
-                {
-                    capnp::Text::Reader value = capnp::Text::Reader(data.data, data.size);
-                    builder_impl.getPointerElement(array_index).setBlob<capnp::Text>(value);
-                }
-                else
-                {
-                    /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
-                    /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
-                    /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
-                    /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
-                    tmp_string = data.toString();
-                    capnp::Text::Reader value = capnp::Text::Reader(tmp_string.data(), tmp_string.size());
-                    builder_impl.getPointerElement(array_index).setBlob<capnp::Text>(value);
-                }
-            }
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
-        {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Data>(nullptr, 0);
-                if (value.size() > fixed_string_column.getN())
-                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
-
-                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-            else
-            {
-                capnp::Text::Reader value = reader_impl.getPointerField(slot_offset).getBlob<capnp::Text>(nullptr, 0);
-                if (value.size() > fixed_string_column.getN())
-                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
-
-                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-        }
-
-        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
-        {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
-            if constexpr (is_binary)
-            {
-                capnp::Data::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0);
-                if (value.size() > fixed_string_column.getN())
-                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
-
-                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-            else
-            {
-                capnp::Text::Reader value = reader_impl.getPointerElement(array_index).getBlob<capnp::Text>(nullptr, 0);
-                if (value.size() > fixed_string_column.getN())
-                    throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", value.size(), fixed_string_column.getN());
-
-                fixed_string_column.insertData(reinterpret_cast<const char *>(value.begin()), value.size());
-            }
-        }
-
-    private:
-        String tmp_string;
-        capnp::Type capnp_type;
-    };
 
     class CapnProtoIPv4Serializer : public ICapnProtoSerializer
     {
@@ -804,33 +579,204 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            auto & builder_impl = parent_struct_builder.getBuilderImpl();
-            UInt32 value = assert_cast<const ColumnIPv4 &>(*column).getElement(row_num);
-            builder_impl.setDataField<UInt32>(slot_offset, value);
+            parent_struct_builder.getBuilderImpl().setDataField<UInt32>(slot_offset, getValue(column, row_num));
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            auto & builder_impl = parent_list_builder.getBuilderImpl();
-            UInt32 value = assert_cast<const ColumnIPv4 &>(*column).getElement(row_num);
-            builder_impl.setDataElement<UInt32>(array_index, value);
+            parent_list_builder.getBuilderImpl().setDataElement<UInt32>(array_index, getValue(column, row_num));
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            UInt32 value = reader_impl.getDataField<UInt32>(slot_offset);
-            assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(value));
+            insertValue(column, parent_struct_reader.getReaderImpl().getDataField<UInt32>(slot_offset));
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            UInt32 value = reader_impl.getDataElement<UInt32>(array_index);
+            insertValue(column, parent_list_reader.getReaderImpl().getDataElement<UInt32>(array_index));
+        }
+
+    private:
+        UInt32 getValue(const ColumnPtr & column, size_t row_num)
+        {
+            return assert_cast<const ColumnIPv4 &>(*column).getElement(row_num);
+        }
+
+        void insertValue(IColumn & column, UInt32 value)
+        {
             assert_cast<ColumnIPv4 &>(column).insertValue(IPv4(value));
         }
     };
 
+    template <typename T>
+    class CapnProtoFixedSizeRawDataSerializer : public ICapnProtoSerializer
+    {
+    private:
+        static constexpr size_t expected_value_size = sizeof(T);
+
+    public:
+        CapnProtoFixedSizeRawDataSerializer(const DataTypePtr & data_type_, const String & column_name, const capnp::Type & capnp_type) : data_type(data_type_)
+        {
+            if (!capnp_type.isData())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
+        {
+            parent_struct_builder.getBuilderImpl().getPointerField(slot_offset).setBlob<capnp::Data>(getData(column, row_num));
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
+        {
+            parent_struct_builder.getBuilderImpl().getPointerElement(array_index).setBlob<capnp::Data>(getData(column, row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            insertData(column, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getBlob<capnp::Data>(nullptr, 0));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            insertData(column, parent_list_reader.getReaderImpl().getPointerElement(array_index).getBlob<capnp::Data>(nullptr, 0));
+        }
+
+    private:
+        capnp::Data::Reader getData(const ColumnPtr & column, size_t row_num)
+        {
+            auto data = column->getDataAt(row_num);
+            return capnp::Data::Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+        }
+
+        void insertData(IColumn & column, capnp::Data::Reader data)
+        {
+            if (data.size() != expected_value_size)
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected size of {} value: {}", data_type->getName(), data.size());
+
+            column.insertData(reinterpret_cast<const char *>(data.begin()), data.size());
+        }
+
+        DataTypePtr data_type;
+    };
+
+    template <typename CapnpType>
+    class CapnProtoStringSerializer : public ICapnProtoSerializer
+    {
+    public:
+        CapnProtoStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type)
+        {
+            if (!capnp_type.isData() && !capnp_type.isText())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
+        {
+            parent_struct_builder.getBuilderImpl().getPointerField(slot_offset).setBlob<CapnpType>(getData(column, row_num));
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
+        {
+            parent_struct_builder.getBuilderImpl().getPointerElement(array_index).setBlob<CapnpType>(getData(column, row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            insertData(column, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getBlob<CapnpType>(nullptr, 0));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            insertData(column, parent_list_reader.getReaderImpl().getPointerElement(array_index).getBlob<CapnpType>(nullptr, 0));
+        }
+
+    private:
+        using Reader = typename CapnpType::Reader;
+
+        CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
+        {
+            auto data = column->getDataAt(row_num);
+            if constexpr (std::is_same_v<CapnpType, capnp::Data>)
+                return Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+            else
+                return Reader(data.data, data.size);
+        }
+
+        void insertData(IColumn & column, Reader data)
+        {
+            column.insertData(reinterpret_cast<const char *>(data.begin()), data.size());
+        }
+    };
+
+    template <typename CapnpType>
+    class CapnProtoFixedStringSerializer : public ICapnProtoSerializer
+    {
+    private:
+
+    public:
+        CapnProtoFixedStringSerializer(const DataTypePtr & data_type, const String & column_name, const capnp::Type & capnp_type_) : capnp_type(capnp_type_)
+        {
+            if (!capnp_type.isData() && !capnp_type.isText())
+                throwCannotConvert(data_type, column_name, capnp_type);
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
+        {
+            parent_struct_builder.getBuilderImpl().getPointerField(slot_offset).setBlob<CapnpType>(getData(column, row_num));
+        }
+
+        void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_struct_builder, UInt32 array_index, size_t row_num) override
+        {
+            parent_struct_builder.getBuilderImpl().getPointerElement(array_index).setBlob<CapnpType>(getData(column, row_num));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            insertData(column, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getBlob<CapnpType>(nullptr, 0));
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            insertData(column, parent_list_reader.getReaderImpl().getPointerElement(array_index).getBlob<CapnpType>(nullptr, 0));
+        }
+
+    private:
+        using Reader = typename CapnpType::Reader;
+
+        CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
+        {
+            auto data = column->getDataAt(row_num);
+            if constexpr (std::is_same_v<CapnpType, capnp::Data>)
+            {
+                return Reader(reinterpret_cast<const kj::byte *>(data.data), data.size);
+            }
+            else
+            {
+                if (data.data[data.size - 1] == 0)
+                    return Reader(data.data, data.size);
+
+                /// In TEXT type data should be null-terminated, but ClickHouse FixedString data could not be.
+                /// To make data null-terminated we should copy it to temporary String object and use it in capnp::Text::Reader.
+                /// Note that capnp::Text::Reader works only with pointer to the data and it's size, so we should
+                /// guarantee that new String object life time is longer than capnp::Text::Reader life time.
+                tmp_string = data.toString();
+                return Reader(tmp_string.data(), tmp_string.size());
+            }
+        }
+
+        void insertData(IColumn & column, Reader data)
+        {
+            auto & fixed_string_column = assert_cast<ColumnFixedString &>(column);
+            if (data.size() > fixed_string_column.getN())
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Cannot read data with size {} to FixedString with size {}", data.size(), fixed_string_column.getN());
+
+            fixed_string_column.insertData(reinterpret_cast<const char *>(data.begin()), data.size());
+        }
+
+        String tmp_string;
+        capnp::Type capnp_type;
+    };
+
     std::unique_ptr<ICapnProtoSerializer> createSerializer(const DataTypePtr & type, const String & name, const capnp::Type & capnp_type, const FormatSettings::CapnProto & settings);
 
     class CapnProtoLowCardinalitySerializer : public ICapnProtoSerializer
@@ -843,37 +789,43 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
-            size_t index = low_cardinality_column.getIndexAt(row_num);
-            const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
-            nested_serializer->writeRow(dict_column, field_builder, parent_struct_builder, slot_offset, index);
+            writeRowImpl(column, field_builder, parent_struct_builder, slot_offset, row_num);
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
-            size_t index = low_cardinality_column.getIndexAt(row_num);
-            const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
-            nested_serializer->writeRow(dict_column, field_builder, parent_list_builder, array_index, index);
+            writeRowImpl(column, field_builder, parent_list_builder, array_index, row_num);
         }
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
-            auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
-            nested_serializer->readRow(*tmp_column, parent_struct_reader, slot_offset);
-            low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
+            readRowImpl(column, parent_struct_reader, slot_offset);
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
-            auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
-            nested_serializer->readRow(*tmp_column, parent_list_reader, array_index);
-            low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
+            readRowImpl(column, parent_list_reader, array_index);
         }
 
     private:
+        template <typename ParentBuilder>
+        void writeRowImpl(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, ParentBuilder & parent_builder, UInt32 offset_or_index, size_t row_num)
+        {
+            const auto & low_cardinality_column = assert_cast<const ColumnLowCardinality &>(*column);
+            size_t index = low_cardinality_column.getIndexAt(row_num);
+            const auto & dict_column = low_cardinality_column.getDictionary().getNestedColumn();
+            nested_serializer->writeRow(dict_column, field_builder, parent_builder, offset_or_index, index);
+        }
+
+        template <typename ParentReader>
+        void readRowImpl(IColumn & column, const ParentReader & parent_reader, UInt32 offset_or_index)
+        {
+            auto & low_cardinality_column = assert_cast<ColumnLowCardinality &>(column);
+            auto tmp_column = low_cardinality_column.getDictionary().getNestedColumn()->cloneEmpty();
+            nested_serializer->readRow(*tmp_column, parent_reader, offset_or_index);
+            low_cardinality_column.insertFromFullColumn(*tmp_column, 0);
+        }
+
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
     };
 
@@ -938,38 +890,32 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            if (!field_builder)
-            {
-                auto builder_impl = parent_struct_builder.getBuilderImpl();
-                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getPointerField(slot_offset).initStruct(struct_size));
-                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
-            }
-
-            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
-
-            const auto & nullable_column = assert_cast<const ColumnNullable &>(*column);
-            if (nullable_column.isNullAt(row_num))
-            {
-                auto struct_builder_impl = struct_builder.impl.getBuilderImpl();
-                struct_builder_impl.setDataField<uint16_t>(discriminant_offset, null_discriminant);
-                struct_builder_impl.setDataField<capnp::Void>(nested_slot_offset, capnp::Void());
-            }
-            else
-            {
-                const auto & nested_column = nullable_column.getNestedColumnPtr();
-                struct_builder.impl.getBuilderImpl().setDataField<uint16_t>(discriminant_offset, nested_discriminant);
-                nested_serializer->writeRow(nested_column, struct_builder.field_builders[0], struct_builder.impl, nested_slot_offset, row_num);
-            }
+            writeRowImpl(column, field_builder, parent_struct_builder, slot_offset, row_num);
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            writeRowImpl(column, field_builder, parent_list_builder, array_index, row_num);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getStruct(nullptr));
+            readRowImpl(column, struct_reader);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, parent_list_reader.getReaderImpl().getStructElement(array_index));
+            readRowImpl(column, struct_reader);
+        }
+
+    private:
+        template <typename ParentBuilder>
+        void writeRowImpl(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, ParentBuilder & parent_builder, UInt32 offset_or_index, size_t row_num)
         {
             if (!field_builder)
-            {
-                auto builder_impl = parent_list_builder.getBuilderImpl();
-                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getStructElement(array_index));
-                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
-            }
+                field_builder = initStructBuilder(parent_builder, offset_or_index, struct_size, 1, struct_schema);
 
             auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
 
@@ -988,12 +934,9 @@ namespace
             }
         }
 
-        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        void readRowImpl(IColumn & column, capnp::DynamicStruct::Reader & struct_reader)
         {
             auto & nullable_column = assert_cast<ColumnNullable &>(column);
-            auto reader_impl = parent_struct_reader.getReaderImpl();
-            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getPointerField(slot_offset).getStruct(nullptr));
-
             auto discriminant = struct_reader.getReaderImpl().getDataField<uint16_t>(discriminant_offset);
 
             if (discriminant == null_discriminant)
@@ -1006,25 +949,7 @@ namespace
             }
         }
 
-        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
-        {
-            auto & nullable_column = assert_cast<ColumnNullable &>(column);
-            auto reader_impl = parent_list_reader.getReaderImpl();
-            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getStructElement(array_index));
 
-            auto discriminant = struct_reader.getReaderImpl().getDataField<uint16_t>(discriminant_offset);
-
-            if (discriminant == null_discriminant)
-                nullable_column.insertDefault();
-            else
-            {
-                auto & nested_column = nullable_column.getNestedColumn();
-                nested_serializer->readRow(nested_column, struct_reader, nested_slot_offset);
-                nullable_column.getNullMapData().push_back(0);
-            }
-        }
-
-    private:
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
         capnp::StructSchema struct_schema;
         capnp::_::StructSize struct_size;
@@ -1058,29 +983,29 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            const auto * array_column = assert_cast<const ColumnArray *>(column.get());
-            const auto & nested_column = array_column->getDataPtr();
-            const auto & offsets = array_column->getOffsets();
-            auto offset = offsets[row_num - 1];
-            UInt32 size = static_cast<UInt32>(offsets[row_num] - offset);
-
-            if (!field_builder)
-            {
-                auto builder_impl = parent_struct_builder.getBuilderImpl();
-                capnp::DynamicList::Builder list_builder_impl;
-                if (element_is_struct)
-                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerField(slot_offset).initStructList(size, element_struct_size));
-                else
-                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerField(slot_offset).initList(element_size, size));
-                field_builder = std::make_unique<ListBuilder>(std::move(list_builder_impl), size);
-            }
-
-            auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
-            for (UInt32 i = 0; i != size; ++i)
-                nested_serializer->writeRow(nested_column, list_builder.nested_builders[i], list_builder.impl, i, offset + i);
+            writeRowImpl(column, field_builder, parent_struct_builder, slot_offset, row_num);
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            writeRowImpl(column, field_builder, parent_list_builder, array_index, row_num);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            auto list_reader = capnp::DynamicList::Reader(list_schema, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getList(element_size, nullptr));
+            readRowImpl(column, list_reader);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto list_reader = capnp::DynamicList::Reader(list_schema, parent_list_reader.getReaderImpl().getPointerElement(array_index).getList(element_size, nullptr));
+            readRowImpl(column, list_reader);
+        }
+
+    private:
+        template <typename ParentBuilder>
+        void writeRowImpl(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, ParentBuilder & parent_builder, UInt32 offset_or_index, size_t row_num)
         {
             const auto * array_column = assert_cast<const ColumnArray *>(column.get());
             const auto & nested_column = array_column->getDataPtr();
@@ -1089,25 +1014,32 @@ namespace
             UInt32 size = static_cast<UInt32>(offsets[row_num] - offset);
 
             if (!field_builder)
-            {
-                auto builder_impl = parent_list_builder.getBuilderImpl();
-                capnp::DynamicList::Builder list_builder_impl;
-                if (element_is_struct)
-                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerElement(array_index).initStructList(size, element_struct_size));
-                else
-                    list_builder_impl = capnp::DynamicList::Builder(list_schema, builder_impl.getPointerElement(array_index).initList(element_size, size));
-                field_builder = std::make_unique<ListBuilder>(std::move(list_builder_impl), size);
-            }
+                field_builder = std::make_unique<ListBuilder>(capnp::DynamicList::Builder(list_schema, initListBuilder(parent_builder, offset_or_index, size)), size);
 
             auto & list_builder = assert_cast<ListBuilder &>(*field_builder);
             for (UInt32 i = 0; i != size; ++i)
                 nested_serializer->writeRow(nested_column, list_builder.nested_builders[i], list_builder.impl, i, offset + i);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        template <typename ParentBuilder>
+        capnp::_::ListBuilder initListBuilder(ParentBuilder & parent_builder, UInt32 offset_or_index, UInt32 size)
+        {
+            if (element_is_struct)
+            {
+                if constexpr (std::is_same_v<ParentBuilder, capnp::DynamicStruct::Builder>)
+                    return parent_builder.getBuilderImpl().getPointerField(offset_or_index).initStructList(size, element_struct_size);
+                else
+                    return parent_builder.getBuilderImpl().getPointerElement(offset_or_index).initStructList(size, element_struct_size);
+            }
+
+            if constexpr (std::is_same_v<ParentBuilder, capnp::DynamicStruct::Builder>)
+                return parent_builder.getBuilderImpl().getPointerField(offset_or_index).initList(element_size, size);
+            else
+                return parent_builder.getBuilderImpl().getPointerElement(offset_or_index).initList(element_size, size);
+        }
+
+        void readRowImpl(IColumn & column, const capnp::DynamicList::Reader & list_reader)
         {
-            const auto & reader_impl = parent_struct_reader.getReaderImpl();
-            auto list_reader = capnp::DynamicList::Reader(list_schema, reader_impl.getPointerField(slot_offset).getList(element_size, nullptr));
             UInt32 size = list_reader.size();
             auto & column_array = assert_cast<ColumnArray &>(column);
             auto & offsets = column_array.getOffsets();
@@ -1118,21 +1050,6 @@ namespace
                 nested_serializer->readRow(nested_column, list_reader, i);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
-        {
-            const auto & reader_impl = parent_list_reader.getReaderImpl();
-            auto list_reader = capnp::DynamicList::Reader(list_schema, reader_impl.getPointerElement(array_index).getList(element_size, nullptr));
-            UInt32 size = list_reader.size();
-            auto & column_array = assert_cast<ColumnArray &>(column);
-            auto & offsets = column_array.getOffsets();
-            offsets.push_back(offsets.back() + list_reader.size());
-
-            auto & nested_column = column_array.getData();
-            for (UInt32 i = 0; i != size; ++i)
-                nested_serializer->readRow(nested_column, list_reader, i);
-        }
-
-    private:
         capnp::ListSchema list_schema;
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
         capnp::ElementSize element_size;
@@ -1219,49 +1136,44 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            if (!field_builder)
-            {
-                auto builder_impl = parent_struct_builder.getBuilderImpl();
-                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getPointerField(slot_offset).initStruct(struct_size));
-                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
-            }
-
-            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
-            const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
-            nested_serializer->writeRow(entries_column, struct_builder.field_builders[0], struct_builder.impl, entries_slot_offset, row_num);
+            writeRowImpl(column, field_builder, parent_struct_builder, slot_offset, row_num);
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
+        {
+            writeRowImpl(column, field_builder, parent_list_builder, array_index, row_num);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        {
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getStruct(nullptr));
+            readRowImpl(column, struct_reader);
+        }
+
+        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
+        {
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, parent_list_reader.getReaderImpl().getStructElement(array_index));
+            readRowImpl(column, struct_reader);
+        }
+
+    private:
+        template <typename ParentBuilder>
+        void writeRowImpl(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, ParentBuilder & parent_builder, UInt32 offset_or_index, size_t row_num)
         {
             if (!field_builder)
-            {
-                auto builder_impl = parent_list_builder.getBuilderImpl();
-                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getStructElement(array_index));
-                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), 1);
-            }
+                field_builder = initStructBuilder(parent_builder, offset_or_index, struct_size, 1, struct_schema);
 
             auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
             const auto & entries_column = assert_cast<const ColumnMap *>(column.get())->getNestedColumnPtr();
             nested_serializer->writeRow(entries_column, struct_builder.field_builders[0], struct_builder.impl, entries_slot_offset, row_num);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
+        void readRowImpl(IColumn & column, const capnp::DynamicStruct::Reader & struct_reader)
         {
-            auto reader_impl = parent_struct_reader.getReaderImpl();
-            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getPointerField(slot_offset).getStruct(nullptr));
             auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
             nested_serializer->readRow(entries_column, struct_reader, entries_slot_offset);
         }
 
-        void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
-        {
-            auto reader_impl = parent_list_reader.getReaderImpl();
-            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getStructElement(array_index));
-            auto & entries_column = assert_cast<ColumnMap &>(column).getNestedColumn();
-            nested_serializer->readRow(entries_column, struct_reader, entries_slot_offset);
-        }
-
-    private:
         std::unique_ptr<ICapnProtoSerializer> nested_serializer;
         capnp::StructSchema struct_schema;
         capnp::_::StructSize struct_size;
@@ -1332,48 +1244,15 @@ namespace
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicStruct::Builder & parent_struct_builder, UInt32 slot_offset, size_t row_num) override
         {
-            if (!field_builder)
-            {
-                auto builder_impl = parent_struct_builder.getBuilderImpl();
-                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getPointerField(slot_offset).initStruct(struct_size));
-                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), fields_count);
-            }
-
-            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
-            if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
-            {
-                const auto & columns = tuple_column->getColumns();
-                for (size_t i = 0; i != columns.size(); ++i)
-                    fields_serializers[i]->writeRow(columns[i], struct_builder.field_builders[fields_indexes[i]], struct_builder.impl, fields_offsets[i], row_num);
-            }
-            else
-            {
-                fields_serializers[0]->writeRow(column, struct_builder.field_builders[fields_indexes[0]], struct_builder.impl, fields_offsets[0], row_num);
-            }
+            writeRowImpl(column, field_builder, parent_struct_builder, slot_offset, row_num);
         }
 
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
-            if (!field_builder)
-            {
-                auto builder_impl = parent_list_builder.getBuilderImpl();
-                auto struct_builder_impl = capnp::DynamicStruct::Builder(struct_schema, builder_impl.getStructElement(array_index));
-                field_builder = std::make_unique<StructBuilder>(std::move(struct_builder_impl), fields_count);
-            }
-
-            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
-            if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
-            {
-                const auto & columns = tuple_column->getColumns();
-                for (size_t i = 0; i != columns.size(); ++i)
-                    fields_serializers[i]->writeRow(columns[i], struct_builder.field_builders[fields_indexes[i]], struct_builder.impl, fields_offsets[i], row_num);
-            }
-            else
-            {
-                fields_serializers[0]->writeRow(column, struct_builder.field_builders[fields_indexes[0]], struct_builder.impl, fields_offsets[0], row_num);
-            }
+            writeRowImpl(column, field_builder, parent_list_builder, array_index, row_num);
         }
 
+        /// Method for writing root struct.
         void writeRow(const Columns & columns, StructBuilder & struct_builder, size_t row_num)
         {
             for (size_t i = 0; i != columns.size(); ++i)
@@ -1382,30 +1261,17 @@ namespace
 
         void readRow(IColumn & column, const capnp::DynamicStruct::Reader & parent_struct_reader, UInt32 slot_offset) override
         {
-            auto reader_impl = parent_struct_reader.getReaderImpl();
-            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getPointerField(slot_offset).getStruct(nullptr));
-            if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
-            {
-                for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
-                    fields_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader, fields_offsets[i]);
-            }
-            else
-                fields_serializers[0]->readRow(column, struct_reader, fields_offsets[0]);
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, parent_struct_reader.getReaderImpl().getPointerField(slot_offset).getStruct(nullptr));
+            readRowImpl(column, struct_reader);
         }
 
         void readRow(IColumn & column, const capnp::DynamicList::Reader & parent_list_reader, UInt32 array_index) override
         {
-            auto reader_impl = parent_list_reader.getReaderImpl();
-            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, reader_impl.getStructElement(array_index));
-            if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
-            {
-                for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
-                    fields_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader, fields_offsets[i]);
-            }
-            else
-                fields_serializers[0]->readRow(column, struct_reader, fields_offsets[0]);
+            auto struct_reader = capnp::DynamicStruct::Reader(struct_schema, parent_list_reader.getReaderImpl().getStructElement(array_index));
+            readRowImpl(column, struct_reader);
         }
 
+        /// Method for reading from root struct.
         void readRow(MutableColumns & columns, const capnp::DynamicStruct::Reader & reader)
         {
             for (size_t i = 0; i != columns.size(); ++i)
@@ -1435,6 +1301,36 @@ namespace
             }
         }
 
+        template <typename ParentBuilder>
+        void writeRowImpl(const ColumnPtr & column, std::unique_ptr<FieldBuilder> & field_builder, ParentBuilder & parent_builder, UInt32 offset_or_index, size_t row_num)
+        {
+            if (!field_builder)
+                field_builder = initStructBuilder(parent_builder, offset_or_index, struct_size, fields_count, struct_schema);
+
+            auto & struct_builder = assert_cast<StructBuilder &>(*field_builder);
+            if (const auto * tuple_column = typeid_cast<const ColumnTuple *>(column.get()))
+            {
+                const auto & columns = tuple_column->getColumns();
+                for (size_t i = 0; i != columns.size(); ++i)
+                    fields_serializers[i]->writeRow(columns[i], struct_builder.field_builders[fields_indexes[i]], struct_builder.impl, fields_offsets[i], row_num);
+            }
+            else
+            {
+                fields_serializers[0]->writeRow(column, struct_builder.field_builders[fields_indexes[0]], struct_builder.impl, fields_offsets[0], row_num);
+            }
+        }
+
+        void readRowImpl(IColumn & column, const capnp::DynamicStruct::Reader & struct_reader)
+        {
+            if (auto * tuple_column = typeid_cast<ColumnTuple *>(&column))
+            {
+                for (size_t i = 0; i != tuple_column->tupleSize(); ++i)
+                    fields_serializers[i]->readRow(tuple_column->getColumn(i), struct_reader, fields_offsets[i]);
+            }
+            else
+                fields_serializers[0]->readRow(column, struct_reader, fields_offsets[0]);
+        }
+
         capnp::StructSchema struct_schema;
         capnp::_::StructSize struct_size;
         size_t fields_count;
@@ -1515,12 +1411,12 @@ namespace
                 return std::make_unique<CapnProtoEnumSerializer<Int16>>(type, name, capnp_type, settings.enum_comparing_mode);
             case TypeIndex::String:
                 if (capnp_type.isData())
-                    return std::make_unique<CapnProtoStringSerializer<true>>(type, name, capnp_type);
-                return std::make_unique<CapnProtoStringSerializer<false>>(type, name, capnp_type);
+                    return std::make_unique<CapnProtoStringSerializer<capnp::Data>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoStringSerializer<capnp::Text>>(type, name, capnp_type);
             case TypeIndex::FixedString:
                 if (capnp_type.isData())
-                    return std::make_unique<CapnProtoFixedStringSerializer<true>>(type, name, capnp_type);
-                return std::make_unique<CapnProtoFixedStringSerializer<false>>(type, name, capnp_type);
+                    return std::make_unique<CapnProtoFixedStringSerializer<capnp::Data>>(type, name, capnp_type);
+                return std::make_unique<CapnProtoFixedStringSerializer<capnp::Text>>(type, name, capnp_type);
             case TypeIndex::LowCardinality:
                 return std::make_unique<CapnProtoLowCardinalitySerializer>(type, name, capnp_type, settings);
             case TypeIndex::Nullable:
diff --git a/src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp b/src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp
new file mode 100644
index 00000000000..106161ae620
--- /dev/null
+++ b/src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp
@@ -0,0 +1,52 @@
+#include <Storages/addColumnsStructureToQueryWithClusterEngine.h>
+#include <Parsers/ASTExpressionList.h>
+#include <Parsers/ASTSelectQuery.h>
+#include <Parsers/ASTTablesInSelectQuery.h>
+#include <Parsers/ASTFunction.h>
+#include <Parsers/ASTLiteral.h>
+#include <Parsers/queryToString.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
+
+ASTExpressionList * extractTableFunctionArgumentsFromSelectQuery(ASTPtr & query)
+{
+    auto * select_query = query->as<ASTSelectQuery>();
+    if (!select_query || !select_query->tables())
+        return nullptr;
+
+    auto * tables = select_query->tables()->as<ASTTablesInSelectQuery>();
+    auto * table_expression = tables->children[0]->as<ASTTablesInSelectQueryElement>()->table_expression->as<ASTTableExpression>();
+    if (!table_expression->table_function)
+        return nullptr;
+
+    auto * table_function = table_expression->table_function->as<ASTFunction>();
+    return table_function->arguments->as<ASTExpressionList>();
+}
+
+void addColumnsStructureToQueryWithClusterEngine(ASTPtr & query, const String & structure, size_t max_arguments, const String & function_name)
+{
+    ASTExpressionList * expression_list = extractTableFunctionArgumentsFromSelectQuery(query);
+    if (!expression_list)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected SELECT query from table function {}, got '{}'", function_name, queryToString(query));
+    auto structure_literal = std::make_shared<ASTLiteral>(structure);
+
+    if (expression_list->children.size() < 2 || expression_list->children.size() > max_arguments)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected 2 to {} arguments in {} table functions, got {}",
+                        function_name, max_arguments, expression_list->children.size());
+
+    if (expression_list->children.size() == 2 || expression_list->children.size() == max_arguments - 1)
+    {
+        auto format_literal = std::make_shared<ASTLiteral>("auto");
+        expression_list->children.push_back(format_literal);
+    }
+
+    expression_list->children.push_back(structure_literal);
+}
+
+}
diff --git a/src/Storages/addColumnsStructureToQueryWithClusterEngine.h b/src/Storages/addColumnsStructureToQueryWithClusterEngine.h
new file mode 100644
index 00000000000..5939f3f43aa
--- /dev/null
+++ b/src/Storages/addColumnsStructureToQueryWithClusterEngine.h
@@ -0,0 +1,14 @@
+#pragma once
+
+#include <Parsers/IAST.h>
+#include <Parsers/ASTExpressionList.h>
+
+namespace DB
+{
+
+ASTExpressionList * extractTableFunctionArgumentsFromSelectQuery(ASTPtr & query);
+
+/// Add structure argument for queries with s3Cluster/hdfsCluster table function.
+void addColumnsStructureToQueryWithClusterEngine(ASTPtr & query, const String & structure, size_t max_arguments, const String & function_name);
+
+}

From f2e076a4431e1515d46b039ef248ddd5fd33de81 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Wed, 31 May 2023 19:33:32 +0000
Subject: [PATCH 151/722] Implement big-endian support for the deterministic
 reservoir sampler

---
 .../ReservoirSamplerDeterministic.h           | 14 ++---
 src/Common/TransformEndianness.hpp            | 54 +++++++++++++++++++
 src/IO/ReadHelpers.h                          | 22 +-------
 src/IO/WriteHelpers.h                         | 22 +-------
 4 files changed, 65 insertions(+), 47 deletions(-)
 create mode 100644 src/Common/TransformEndianness.hpp

diff --git a/src/AggregateFunctions/ReservoirSamplerDeterministic.h b/src/AggregateFunctions/ReservoirSamplerDeterministic.h
index bde33260f5a..9dea821e839 100644
--- a/src/AggregateFunctions/ReservoirSamplerDeterministic.h
+++ b/src/AggregateFunctions/ReservoirSamplerDeterministic.h
@@ -157,8 +157,8 @@ public:
     void read(DB::ReadBuffer & buf)
     {
         size_t size = 0;
-        DB::readIntBinary<size_t>(size, buf);
-        DB::readIntBinary<size_t>(total_values, buf);
+        readBinaryLittleEndian(size, buf);
+        readBinaryLittleEndian(total_values, buf);
 
         /// Compatibility with old versions.
         if (size > total_values)
@@ -171,16 +171,16 @@ public:
 
         samples.resize(size);
         for (size_t i = 0; i < size; ++i)
-            DB::readPODBinary(samples[i], buf);
+            readBinaryLittleEndian(samples[i], buf);
 
         sorted = false;
     }
 
     void write(DB::WriteBuffer & buf) const
     {
-        size_t size = samples.size();
-        DB::writeIntBinary<size_t>(size, buf);
-        DB::writeIntBinary<size_t>(total_values, buf);
+        const auto size = samples.size();
+        writeBinaryLittleEndian(size, buf);
+        writeBinaryLittleEndian(total_values, buf);
 
         for (size_t i = 0; i < size; ++i)
         {
@@ -195,7 +195,7 @@ public:
             memset(&elem, 0, sizeof(elem));
             elem = samples[i];
 
-            DB::writePODBinary(elem, buf);
+            writeBinaryLittleEndian(elem, buf);
         }
     }
 
diff --git a/src/Common/TransformEndianness.hpp b/src/Common/TransformEndianness.hpp
new file mode 100644
index 00000000000..17cf441d17f
--- /dev/null
+++ b/src/Common/TransformEndianness.hpp
@@ -0,0 +1,54 @@
+#pragma once
+
+#include <base/Decimal_fwd.h>
+#include <base/extended_types.h>
+
+#include <utility>
+
+namespace DB
+{
+template <std::endian endian, typename T>
+    requires is_big_int_v<T>
+inline void transformEndianness(T & x)
+{
+    if constexpr (std::endian::native != endian)
+    {
+        std::ranges::transform(x.items, std::begin(x.items), [](auto& item) { return std::byteswap(item); });
+        std::ranges::reverse(x.items);
+    }
+}
+
+template <std::endian endian, typename T>
+    requires is_decimal<T> || std::is_floating_point_v<T>
+inline void transformEndianness(T & value)
+{
+    if constexpr (std::endian::native != endian)
+    {
+        auto * start = reinterpret_cast<std::byte *>(&value);
+        std::reverse(start, start + sizeof(T));
+    }
+}
+
+template <std::endian endian, typename T>
+    requires std::is_integral_v<T> && (sizeof(T) <= 8)
+inline void transformEndianness(T & value)
+{
+    if constexpr (endian != std::endian::native)
+        value = std::byteswap(value);
+}
+
+template <std::endian endian, typename T>
+    requires std::is_scoped_enum_v<T>
+inline void transformEndianness(T & x)
+{
+    using UnderlyingType = std::underlying_type_t<T>;
+    transformEndianness<endian>(reinterpret_cast<UnderlyingType &>(x));
+}
+
+template <std::endian endian, typename A, typename B>
+inline void transformEndianness(std::pair<A, B> & pair)
+{
+    transformEndianness<endian>(pair.first);
+    transformEndianness<endian>(pair.second);
+}
+}
diff --git a/src/IO/ReadHelpers.h b/src/IO/ReadHelpers.h
index 32338552b66..c42e992c807 100644
--- a/src/IO/ReadHelpers.h
+++ b/src/IO/ReadHelpers.h
@@ -15,6 +15,7 @@
 #include <Common/DateLUT.h>
 #include <Common/LocalDate.h>
 #include <Common/LocalDateTime.h>
+#include <Common/TransformEndianness.hpp>
 #include <base/StringRef.h>
 #include <base/arithmeticOverflow.h>
 #include <base/sort.h>
@@ -1098,30 +1099,11 @@ inline void readBinary(Decimal128 & x, ReadBuffer & buf) { readPODBinary(x, buf)
 inline void readBinary(Decimal256 & x, ReadBuffer & buf) { readPODBinary(x.value, buf); }
 inline void readBinary(LocalDate & x, ReadBuffer & buf) { readPODBinary(x, buf); }
 
-
 template <std::endian endian, typename T>
-requires is_arithmetic_v<T> && (sizeof(T) <= 8)
 inline void readBinaryEndian(T & x, ReadBuffer & buf)
 {
     readPODBinary(x, buf);
-    if constexpr (std::endian::native != endian)
-        x = std::byteswap(x);
-}
-
-template <std::endian endian, typename T>
-requires is_big_int_v<T>
-inline void readBinaryEndian(T & x, ReadBuffer & buf)
-{
-    if constexpr (std::endian::native == endian)
-    {
-        for (size_t i = 0; i != std::size(x.items); ++i)
-            readBinaryEndian<endian>(x.items[i], buf);
-    }
-    else
-    {
-        for (size_t i = 0; i != std::size(x.items); ++i)
-            readBinaryEndian<endian>(x.items[std::size(x.items) - i - 1], buf);
-    }
+    transformEndianness<endian>(x);
 }
 
 template <typename T>
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index cdbc952690c..26c999cb761 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -13,6 +13,7 @@
 #include <Common/DateLUT.h>
 #include <Common/LocalDate.h>
 #include <Common/LocalDateTime.h>
+#include <Common/TransformEndianness.hpp>
 #include <base/find_symbols.h>
 #include <base/StringRef.h>
 #include <base/DecomposedFloat.h>
@@ -1172,32 +1173,13 @@ inline void writeNullTerminatedString(const String & s, WriteBuffer & buffer)
     buffer.write(s.c_str(), s.size() + 1);
 }
 
-
 template <std::endian endian, typename T>
-requires is_arithmetic_v<T> && (sizeof(T) <= 8)
 inline void writeBinaryEndian(T x, WriteBuffer & buf)
 {
-    if constexpr (std::endian::native != endian)
-        x = std::byteswap(x);
+    transformEndianness<endian>(x);
     writePODBinary(x, buf);
 }
 
-template <std::endian endian, typename T>
-requires is_big_int_v<T>
-inline void writeBinaryEndian(const T & x, WriteBuffer & buf)
-{
-    if constexpr (std::endian::native == endian)
-    {
-        for (size_t i = 0; i != std::size(x.items); ++i)
-            writeBinaryEndian<endian>(x.items[i], buf);
-    }
-    else
-    {
-        for (size_t i = 0; i != std::size(x.items); ++i)
-            writeBinaryEndian<endian>(x.items[std::size(x.items) - i - 1], buf);
-    }
-}
-
 template <typename T>
 inline void writeBinaryLittleEndian(T x, WriteBuffer & buf)
 {

From 4b46486491a80ab7a0f2bd62d6c6e4fb606aa429 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 31 May 2023 21:52:58 +0200
Subject: [PATCH 152/722] Clean up

---
 ...lumnsStructureToQueryWithClusterEngine.cpp | 52 -------------------
 1 file changed, 52 deletions(-)
 delete mode 100644 src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp

diff --git a/src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp b/src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp
deleted file mode 100644
index 106161ae620..00000000000
--- a/src/Storages/addColumnsStructureToQueryWithClusterEngine.cpp
+++ /dev/null
@@ -1,52 +0,0 @@
-#include <Storages/addColumnsStructureToQueryWithClusterEngine.h>
-#include <Parsers/ASTExpressionList.h>
-#include <Parsers/ASTSelectQuery.h>
-#include <Parsers/ASTTablesInSelectQuery.h>
-#include <Parsers/ASTFunction.h>
-#include <Parsers/ASTLiteral.h>
-#include <Parsers/queryToString.h>
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-}
-
-ASTExpressionList * extractTableFunctionArgumentsFromSelectQuery(ASTPtr & query)
-{
-    auto * select_query = query->as<ASTSelectQuery>();
-    if (!select_query || !select_query->tables())
-        return nullptr;
-
-    auto * tables = select_query->tables()->as<ASTTablesInSelectQuery>();
-    auto * table_expression = tables->children[0]->as<ASTTablesInSelectQueryElement>()->table_expression->as<ASTTableExpression>();
-    if (!table_expression->table_function)
-        return nullptr;
-
-    auto * table_function = table_expression->table_function->as<ASTFunction>();
-    return table_function->arguments->as<ASTExpressionList>();
-}
-
-void addColumnsStructureToQueryWithClusterEngine(ASTPtr & query, const String & structure, size_t max_arguments, const String & function_name)
-{
-    ASTExpressionList * expression_list = extractTableFunctionArgumentsFromSelectQuery(query);
-    if (!expression_list)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected SELECT query from table function {}, got '{}'", function_name, queryToString(query));
-    auto structure_literal = std::make_shared<ASTLiteral>(structure);
-
-    if (expression_list->children.size() < 2 || expression_list->children.size() > max_arguments)
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected 2 to {} arguments in {} table functions, got {}",
-                        function_name, max_arguments, expression_list->children.size());
-
-    if (expression_list->children.size() == 2 || expression_list->children.size() == max_arguments - 1)
-    {
-        auto format_literal = std::make_shared<ASTLiteral>("auto");
-        expression_list->children.push_back(format_literal);
-    }
-
-    expression_list->children.push_back(structure_literal);
-}
-
-}

From 4987c4baaa0c10ed1114155a0d35db3953f34ab9 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 31 May 2023 21:53:21 +0200
Subject: [PATCH 153/722] Clean up

---
 .../addColumnsStructureToQueryWithClusterEngine.h  | 14 --------------
 1 file changed, 14 deletions(-)
 delete mode 100644 src/Storages/addColumnsStructureToQueryWithClusterEngine.h

diff --git a/src/Storages/addColumnsStructureToQueryWithClusterEngine.h b/src/Storages/addColumnsStructureToQueryWithClusterEngine.h
deleted file mode 100644
index 5939f3f43aa..00000000000
--- a/src/Storages/addColumnsStructureToQueryWithClusterEngine.h
+++ /dev/null
@@ -1,14 +0,0 @@
-#pragma once
-
-#include <Parsers/IAST.h>
-#include <Parsers/ASTExpressionList.h>
-
-namespace DB
-{
-
-ASTExpressionList * extractTableFunctionArgumentsFromSelectQuery(ASTPtr & query);
-
-/// Add structure argument for queries with s3Cluster/hdfsCluster table function.
-void addColumnsStructureToQueryWithClusterEngine(ASTPtr & query, const String & structure, size_t max_arguments, const String & function_name);
-
-}

From 8b34a30455fd42928e5c89c503a25cf5d02ccff8 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 31 May 2023 22:14:57 +0200
Subject: [PATCH 154/722] Fix style

---
 src/Formats/CapnProtoSerializer.cpp | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index e36f5fa4947..e99db23bb5e 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -29,7 +29,6 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int THERE_IS_NO_COLUMN;
-    extern const int LOGICAL_ERROR;
     extern const int CAPN_PROTO_BAD_CAST;
     extern const int INCORRECT_DATA;
     extern const int ILLEGAL_COLUMN;
@@ -371,7 +370,7 @@ namespace
         {
             parent_struct_builder.getBuilderImpl().setDataField<UInt16>(slot_offset, getValue(column, row_num));
         }
-        
+
         void writeRow(const ColumnPtr & column, std::unique_ptr<FieldBuilder> &, capnp::DynamicList::Builder & parent_list_builder, UInt32 array_index, size_t row_num) override
         {
             parent_list_builder.getBuilderImpl().setDataElement<UInt16>(array_index, getValue(column, row_num));

From 4ba08a5cbc960cace3dfcf32b3497855b3ffe6fd Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Wed, 31 May 2023 23:21:39 +0200
Subject: [PATCH 155/722] remove unused import

---
 src/DataTypes/Serializations/SerializationDate.h   | 2 +-
 src/DataTypes/Serializations/SerializationDate32.h | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/DataTypes/Serializations/SerializationDate.h b/src/DataTypes/Serializations/SerializationDate.h
index 4d6a6fa36ec..f751b06fba6 100644
--- a/src/DataTypes/Serializations/SerializationDate.h
+++ b/src/DataTypes/Serializations/SerializationDate.h
@@ -1,7 +1,7 @@
 #pragma once
 
 #include <DataTypes/Serializations/SerializationNumber.h>
-#include <DataTypes/TimezoneMixin.h>
+#include <Common/DateLUT.h>
 
 namespace DB
 {
diff --git a/src/DataTypes/Serializations/SerializationDate32.h b/src/DataTypes/Serializations/SerializationDate32.h
index 6b6e5442240..49560fb6c7d 100644
--- a/src/DataTypes/Serializations/SerializationDate32.h
+++ b/src/DataTypes/Serializations/SerializationDate32.h
@@ -1,7 +1,7 @@
 #pragma once
 
 #include <DataTypes/Serializations/SerializationNumber.h>
-#include <DataTypes/TimezoneMixin.h>
+#include <Common/DateLUT.h>
 
 namespace DB
 {

From 4c92bc7aadf354b713d6b8f3c24728d6172f1867 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Wed, 31 May 2023 15:30:26 -0700
Subject: [PATCH 156/722] Fix incompatible ClickHouse -> MySQL types for
 compability mode

This adjusts specific incompatible ClickHouse types to a format that can
be read and interpreted by MySQL (Ex: Int128 -> text)
---
 src/DataTypes/DataTypeArray.h                 |   2 +-
 src/DataTypes/DataTypeLowCardinality.cpp      |   3 +-
 src/DataTypes/DataTypeLowCardinality.h        |   4 +-
 src/DataTypes/DataTypeNumberBase.cpp          |   8 +-
 src/DataTypes/DataTypeString.h                |   2 +-
 ...show_columns_mysql_compatibility.reference | 229 ++++++++++++++++++
 ...02775_show_columns_mysql_compatibility.sh} |  23 +-
 7 files changed, 256 insertions(+), 15 deletions(-)
 create mode 100644 tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
 rename tests/queries/0_stateless/{02740_show_columns_mysql_compatibility.sh => 02775_show_columns_mysql_compatibility.sh} (80%)

diff --git a/src/DataTypes/DataTypeArray.h b/src/DataTypes/DataTypeArray.h
index 35462df9a4e..b031f411975 100644
--- a/src/DataTypes/DataTypeArray.h
+++ b/src/DataTypes/DataTypeArray.h
@@ -32,7 +32,7 @@ public:
     }
     const char * getMySQLName() const override
     {
-        return "string";
+        return "text";
     }
 
     bool canBeInsideNullable() const override
diff --git a/src/DataTypes/DataTypeLowCardinality.cpp b/src/DataTypes/DataTypeLowCardinality.cpp
index 8293455cabc..b1c32317015 100644
--- a/src/DataTypes/DataTypeLowCardinality.cpp
+++ b/src/DataTypes/DataTypeLowCardinality.cpp
@@ -28,7 +28,8 @@ namespace ErrorCodes
 }
 
 DataTypeLowCardinality::DataTypeLowCardinality(DataTypePtr dictionary_type_)
-        : dictionary_type(std::move(dictionary_type_))
+        : dictionary_type(std::move(dictionary_type_)),
+          mysql_name(dictionary_type->getMySQLName())
 {
     auto inner_type = dictionary_type;
     if (dictionary_type->isNullable())
diff --git a/src/DataTypes/DataTypeLowCardinality.h b/src/DataTypes/DataTypeLowCardinality.h
index 6fd4344311c..bcc39f58ff7 100644
--- a/src/DataTypes/DataTypeLowCardinality.h
+++ b/src/DataTypes/DataTypeLowCardinality.h
@@ -11,6 +11,8 @@ class DataTypeLowCardinality : public IDataType
 {
 private:
     DataTypePtr dictionary_type;
+    std::string mysql_name;
+
 
 public:
     explicit DataTypeLowCardinality(DataTypePtr dictionary_type_);
@@ -22,7 +24,7 @@ public:
         return "LowCardinality(" + dictionary_type->getName() + ")";
     }
     const char * getFamilyName() const override { return "LowCardinality"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getMySQLName() const override { return mysql_name.c_str(); }
 
     TypeIndex getTypeId() const override { return TypeIndex::LowCardinality; }
 
diff --git a/src/DataTypes/DataTypeNumberBase.cpp b/src/DataTypes/DataTypeNumberBase.cpp
index cd5e73ac4a1..7d200de7996 100644
--- a/src/DataTypes/DataTypeNumberBase.cpp
+++ b/src/DataTypes/DataTypeNumberBase.cpp
@@ -36,14 +36,14 @@ const std::map<std::string, std::string> DataTypeNumberBase<T>::mysqlTypeMap = {
     {"UInt16", "smallint unsigned"},
     {"UInt32", "mediumint unsigned"},
     {"UInt64", "bigint unsigned"},
-    {"UInt128", "bigint unsigned"},
-    {"UInt256", "bigint unsigned"},
+    {"UInt128", "text"},
+    {"UInt256", "text"},
     {"Int8", "tinyint"},
     {"Int16", "smallint"},
     {"Int32", "int"},
     {"Int64", "bigint"},
-    {"Int128", "bigint"},
-    {"Int256", "bigint"},
+    {"Int128", "text"},
+    {"Int256", "text"},
     {"Float32", "float"},
     {"Float64", "double"},
 };
diff --git a/src/DataTypes/DataTypeString.h b/src/DataTypes/DataTypeString.h
index 3ac739fe68c..bddfb4ae287 100644
--- a/src/DataTypes/DataTypeString.h
+++ b/src/DataTypes/DataTypeString.h
@@ -22,7 +22,7 @@ public:
     }
 
     // FIXME: string can contain arbitrary bytes, not only UTF-8 sequences
-    const char * getMySQLName() const override { return "text"; }
+    const char * getMySQLName() const override { return "blob"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
new file mode 100644
index 00000000000..96e542611c6
--- /dev/null
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
@@ -0,0 +1,229 @@
+Drop tables if they exist
+Create tab table 
+Create pseudo-random database name
+Create tab duplicate table
+Run MySQL test
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	text	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+uuid_value	char	0		NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	text	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+uuid_value	char	0		NULL	
+field	type	null	key	default	extra	collation	comment	privileges
+aggregate_function	text	0		NULL		NULL		
+array_value	text	0		NULL		NULL		
+boolean_value	tinyint unsigned	0		NULL		NULL		
+date32_value	date	0		NULL		NULL		
+date_value	date	0		NULL		NULL		
+datetime64_value	datetime	0		NULL		NULL		
+datetime_value	datetime	0		NULL		NULL		
+decimal_value	decimal	0		NULL		NULL		
+enum_value	enum('apple', 'banana', 'orange')	0		NULL		NULL		
+fixed_string_value	text	0		NULL		NULL		
+float32	float	0		NULL		NULL		
+float64	double	0		NULL		NULL		
+int32	int	0		NULL		NULL		
+ipv4_value	text	0		NULL		NULL		
+ipv6_value	text	0		NULL		NULL		
+json_value	json	0		NULL		NULL		
+low_cardinality	blob	0		NULL		NULL		
+low_cardinality_date	datetime	0		NULL		NULL		
+map_value	json	0		NULL		NULL		
+nested.nested_int	text	0		NULL		NULL		
+nested.nested_string	text	0		NULL		NULL		
+nullable_value	int	0		NULL		NULL		
+string_value	blob	0		NULL		NULL		
+tuple_value	json	0		NULL		NULL		
+uint64	bigint unsigned	0	PRI SOR	NULL		NULL		
+uuid_value	char	0		NULL		NULL		
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	text	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uuid_value	char	0		NULL	
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	text	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uuid_value	char	0		NULL	
+field	type	null	key	default	extra
+int32	int	0		NULL	
+nested.nested_int	text	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	text	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+uuid_value	char	0		NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	text	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+uuid_value	char	0		NULL	
+field	type	null	key	default	extra
+aggregate_function	text	0		NULL	
+array_value	text	0		NULL	
+boolean_value	tinyint unsigned	0		NULL	
+date32_value	date	0		NULL	
+date_value	date	0		NULL	
+datetime64_value	datetime	0		NULL	
+datetime_value	datetime	0		NULL	
+decimal_value	decimal	0		NULL	
+enum_value	enum('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	text	0		NULL	
+float32	float	0		NULL	
+float64	double	0		NULL	
+int32	int	0		NULL	
+ipv4_value	text	0		NULL	
+ipv6_value	text	0		NULL	
+json_value	json	0		NULL	
+low_cardinality	blob	0		NULL	
+low_cardinality_date	datetime	0		NULL	
+map_value	json	0		NULL	
+nested.nested_int	text	0		NULL	
+nested.nested_string	text	0		NULL	
+nullable_value	int	0		NULL	
+string_value	blob	0		NULL	
+tuple_value	json	0		NULL	
+uint64	bigint unsigned	0	PRI SOR	NULL	
+uuid_value	char	0		NULL	
diff --git a/tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
similarity index 80%
rename from tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh
rename to tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index 7f828d35679..a446c6e817e 100755
--- a/tests/queries/0_stateless/02740_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -13,8 +13,11 @@ ${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
 ${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
 ${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
 
+#${CLICKHOUSE_LOCAL} --query "SET allow_suspicious_low_cardinality_types = 1;"
 echo "Create tab table "
-${CLICKHOUSE_LOCAL} --query "
+${CLICKHOUSE_LOCAL} -n -q "
+    SET allow_suspicious_low_cardinality_types=1;
+    SET allow_experimental_object_type =1;
     CREATE TABLE tab
     (
         uint64 UInt64,
@@ -22,17 +25,19 @@ ${CLICKHOUSE_LOCAL} --query "
         float32 Float32,
         float64 Float64,
         decimal_value Decimal(10, 2),
-        boolean_value UInt8, -- Use 0 for false, 1 for true
+        boolean_value UInt8,
         string_value String,
         fixed_string_value FixedString(10),
         date_value Date,
         date32_value Date32,
         datetime_value DateTime,
         datetime64_value DateTime64(3),
-        json_value String, -- Store JSON as a string
+        json_value JSON,
         uuid_value UUID,
         enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
         low_cardinality LowCardinality(String),
+        low_cardinality_date LowCardinality(DateTime),
+        aggregate_function AggregateFunction(sum, Int32),
         array_value Array(Int32),
         map_value Map(String, Int32),
         tuple_value Tuple(Int32, String),
@@ -53,7 +58,9 @@ echo "Create pseudo-random database name"
 ${CLICKHOUSE_LOCAL} --query "CREATE DATABASE database_123456789abcde;"
 
 echo "Create tab duplicate table"
-${CLICKHOUSE_LOCAL} --query "
+${CLICKHOUSE_LOCAL} -n -q "
+    SET allow_suspicious_low_cardinality_types=1;
+    SET allow_experimental_object_type =1;
     CREATE TABLE database_123456789abcde.tab
     (
         uint64 UInt64,
@@ -61,17 +68,19 @@ ${CLICKHOUSE_LOCAL} --query "
         float32 Float32,
         float64 Float64,
         decimal_value Decimal(10, 2),
-        boolean_value UInt8, -- Use 0 for false, 1 for true
+        boolean_value UInt8,
         string_value String,
         fixed_string_value FixedString(10),
         date_value Date,
         date32_value Date32,
         datetime_value DateTime,
         datetime64_value DateTime64(3),
-        json_value String, -- Store JSON as a string
+        json_value JSON, 
         uuid_value UUID,
         enum_value Enum8('apple' = 1, 'banana' = 2, 'orange' = 3),
         low_cardinality LowCardinality(String),
+        low_cardinality_date LowCardinality(DateTime),
+        aggregate_function AggregateFunction(sum, Int32),
         array_value Array(Int32),
         map_value Map(String, Int32),
         tuple_value Tuple(Int32, String),
@@ -109,7 +118,7 @@ EOT
 
 # Now run the MySQL test script on the ClickHouse DB
 echo "Run MySQL test"
-mysql --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
+${MYSQL_CLIENT} --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
 
 # Clean up the temp file
 rm $TEMP_FILE

From 54d526c75c0934b36dd170660ff7222de24a5a13 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 1 Jun 2023 14:22:57 +0000
Subject: [PATCH 157/722] Add cast type supprt to DateTimeTransformImpl

---
 .../functions/type-conversion-functions.md    | 85 +++++++++++++++++++
 src/Functions/DateTimeTransforms.h            | 36 +++++++-
 src/Functions/FunctionsConversion.h           | 18 +++-
 .../0_stateless/01601_accurate_cast.reference |  4 +
 .../0_stateless/01601_accurate_cast.sql       | 10 +++
 5 files changed, 147 insertions(+), 6 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index c7c66cc771f..a6fc6cd4dfc 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -319,6 +319,49 @@ SELECT
 ## toDateOrNull
 
 ## toDateOrDefault
+Converts an input value to [Date](/docs/en/sql-reference/data-types/date.md) data type. 
+If unsuccessful, returns the lower border value supported by [Date](/docs/en/sql-reference/data-types/date.md). The default value can be specified as a second argument.
+Similar to [toDate](#todate).
+
+**Syntax**
+
+``` sql
+toDateOrDefault(expr [, default_value])
+```
+
+**Arguments**
+
+- `expr` — The value. [String](/docs/en/sql-reference/data-types/string.md), [Int](/docs/en/sql-reference/data-types/int-uint.md), [Date](/docs/en/sql-reference/data-types/date.md) or [DateTime](/docs/en/sql-reference/data-types/datetime.md). 
+- `default_value` — The default value. [Date](/docs/en/sql-reference/data-types/date.md) 
+
+If `expr` is a number and looks like a UNIX timestamp (is greater than 65535), it is interpreted as a DateTime, then truncated to Date in the current timezone. If `expr` is a number and it is smaller than 65536, it is interpreted as the number of days since 1970-01-01.
+
+**Returned value**
+
+- A calendar date. [Date](/docs/en/sql-reference/data-types/date.md)
+
+**Example**
+
+Query:
+
+``` sql
+SELECT
+    toDateOrDefault('2021-01-01', '2023-01-01'::Date),
+    toDateOrDefault('xx2021-01-01', '2023-01-01'::Date);
+```
+
+Result:
+
+```response
+┌─toDateOrDefault('2021-01-01', CAST('2023-01-01', 'Date'))─┬─toDateOrDefault('xx2021-01-01', CAST('2023-01-01', 'Date'))─┐
+│                                                2021-01-01 │                                                  2023-01-01 │
+└───────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────┘
+```
+
+**See Also**
+- [toDate](#todate)
+- [toDate32OrDefault](#todate32ordefault)
+
 
 ## toDateTime
 
@@ -327,6 +370,48 @@ SELECT
 ## toDateTimeOrNull
 
 ## toDateTimeOrDefault
+Converts an input value to [DateTime](/docs/en/sql-reference/data-types/datetime.md) data type. 
+If unsuccessful, returns the lower border value supported by [DateTime](/docs/en/sql-reference/data-types/datetime.md). The default value can be specified as a third argument.
+Similar to [toDateTime](#todatetime).
+
+**Syntax**
+
+``` sql
+toDateTimeOrDefault(expr, [, time_zone [, default_value]])
+```
+
+**Arguments**
+
+- `expr` — The value. [String](/docs/en/sql-reference/data-types/string.md), [Int](/docs/en/sql-reference/data-types/int-uint.md), [Date](/docs/en/sql-reference/data-types/date.md) or [DateTime](/docs/en/sql-reference/data-types/datetime.md). 
+- `time_zone` — Time zone.
+- `default_value` — The default value. [DateTime](/docs/en/sql-reference/data-types/datetime.md) 
+
+If `expr` is a number, it is interpreted as the number of seconds since the beginning of the Unix Epoch (as Unix timestamp).
+
+**Returned value**
+
+- A date time. [DateTime](/docs/en/sql-reference/data-types/datetime.md)
+
+**Example**
+
+Query:
+
+``` sql
+SELECT
+    toDateTimeOrDefault('2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC')),
+    toDateTimeOrDefault('xx2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC'));
+```
+
+Result:
+
+```response
+┌─toDateTimeOrDefault('2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┬─toDateTimeOrDefault('xx2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
+│                                                               2021-01-01 00:00:00 │                                                                 2023-01-01 00:00:00 │
+└───────────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+**See Also**
+- [toDateTime](#todatetime)
 
 ## toDate32
 
diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index f179d9fbe60..81b1ec2e356 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -21,6 +21,7 @@ namespace ErrorCodes
 {
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
     extern const int ILLEGAL_COLUMN;
+    extern const int CANNOT_CONVERT_TYPE;
 }
 
 /** Transformations.
@@ -1425,8 +1426,10 @@ struct ToDateTimeComponentsImpl
     using FactorTransform = ZeroTransform;
 };
 
+struct DateTimeAccurateConvertStrategyAdditions {};
+struct DateTimeAccurateOrNullConvertStrategyAdditions {};
 
-template <typename FromType, typename ToType, typename Transform, bool is_extended_result = false>
+template <typename FromType, typename ToType, typename Transform, bool is_extended_result = false, typename Additions = void *>
 struct Transformer
 {
     template <typename FromTypeVector, typename ToTypeVector>
@@ -1438,6 +1441,33 @@ struct Transformer
 
         for (size_t i = 0; i < size; ++i)
         {
+            constexpr bool transformHasExtraCheck = requires(const Transform& t)
+            {
+                t.ExtraCheck(vec_from[i], time_zone);
+            };
+    
+            if constexpr (transformHasExtraCheck)
+            {
+                // if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
+                //     || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+                {
+                    bool checked = transform.ExtraCheck(vec_from[i], time_zone);
+                    if (!checked)
+                    {
+                        if (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>)
+                        {
+                            // vec_to[i] = 0;
+                            // (*vec_null_map_to)[i] = true;
+                        }
+                        else
+                        {
+                            throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
+                                TypeName<ValueType>, TypeName<ValueType>);
+                        }
+                    }
+                }
+            }
+            
             if constexpr (is_extended_result)
                 vec_to[i] = static_cast<ValueType>(transform.executeExtendedResult(vec_from[i], time_zone));
             else
@@ -1446,14 +1476,14 @@ struct Transformer
     }
 };
 
-
 template <typename FromDataType, typename ToDataType, typename Transform, bool is_extended_result = false>
 struct DateTimeTransformImpl
 {
+    template <typename Additions = void *>
     static ColumnPtr execute(
         const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type, size_t /*input_rows_count*/, const Transform & transform = {})
     {
-        using Op = Transformer<typename FromDataType::FieldType, typename ToDataType::FieldType, Transform, is_extended_result>;
+        using Op = Transformer<typename FromDataType::FieldType, typename ToDataType::FieldType, Transform, is_extended_result, Additions>;
 
         const ColumnPtr source_col = arguments[0].column;
         if (const auto * sources = checkAndGetColumn<typename FromDataType::ColumnType>(source_col.get()))
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index d3676349318..d3ccbb82721 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -400,7 +400,11 @@ template <typename FromType, typename ToType>
 struct ToDateTransform8Or16Signed
 {
     static constexpr auto name = "toDate";
-
+    static NO_SANITIZE_UNDEFINED bool ExtraCheck(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+    
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)
@@ -2884,8 +2888,16 @@ private:
 
                 if constexpr (IsDataTypeNumber<LeftDataType> && IsDataTypeDateOrDateTime<RightDataType>)
                 {
-                    result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::execute(
-                        arguments, result_type, input_rows_count);
+                     if (wrapper_cast_type == CastType::accurate)
+                    {
+                        result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateConvertStrategyAdditions>(
+                            arguments, result_type, input_rows_count);
+                    }
+                    else
+                    {
+                        result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateOrNullConvertStrategyAdditions>(
+                            arguments, result_type, input_rows_count);
+                    }
                     return true;
                 }
 
diff --git a/tests/queries/0_stateless/01601_accurate_cast.reference b/tests/queries/0_stateless/01601_accurate_cast.reference
index c1e7feffbe6..b662319d263 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.reference
+++ b/tests/queries/0_stateless/01601_accurate_cast.reference
@@ -6,3 +6,7 @@
 5
 1
 12
+2023-05-30 14:38:20
+1970-01-01 00:00:19
+2023-05-30
+1970-01-20
\ No newline at end of file
diff --git a/tests/queries/0_stateless/01601_accurate_cast.sql b/tests/queries/0_stateless/01601_accurate_cast.sql
index b5fd4fb04a4..1ab98e26d1a 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.sql
+++ b/tests/queries/0_stateless/01601_accurate_cast.sql
@@ -22,3 +22,13 @@ SELECT accurateCast(-10, 'Decimal32(9)'); -- { serverError 407 }
 
 SELECT accurateCast('123', 'FixedString(2)'); -- { serverError 131 }
 SELECT accurateCast('12', 'FixedString(2)');
+
+SELECT accurateCast(-1, 'DateTime');   -- { serverError 70 }
+SELECT accurateCast('1xxx', 'DateTime');   -- { serverError 41 }
+SELECT accurateCast('2023-05-30 14:38:20', 'DateTime');
+SELECT accurateCast(19, 'DateTime');
+
+SELECT accurateCast(-1, 'Date');   -- { serverError 70 }
+SELECT accurateCast('1xxx', 'Date');   -- { serverError 70 }
+SELECT accurateCast('2023-05-30', 'Date');
+SELECT accurateCast(19, 'Date');

From 883350d5c221c22bef476a62857ae7e8f692dcbf Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 1 Jun 2023 14:51:03 +0000
Subject: [PATCH 158/722] Fix tests

---
 src/Formats/CapnProtoSchema.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Formats/CapnProtoSchema.cpp b/src/Formats/CapnProtoSchema.cpp
index f9ab88d39ed..559047a6f8d 100644
--- a/src/Formats/CapnProtoSchema.cpp
+++ b/src/Formats/CapnProtoSchema.cpp
@@ -43,7 +43,7 @@ capnp::StructSchema CapnProtoSchemaParser::getMessageSchema(const FormatSchemaIn
         /// That's not good to determine the type of error by its description, but
         /// this is the only way to do it here, because kj doesn't specify the type of error.
         auto description = std::string_view(e.getDescription().cStr());
-        if (description.find("No such file or directory") != String::npos || description.find("no such directory") != String::npos)
+        if (description.find("No such file or directory") != String::npos || description.find("no such directory") != String::npos || description.find("no such file") != String::npos)
             throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "Cannot open CapnProto schema, file {} doesn't exists", schema_info.absoluteSchemaPath());
 
         if (description.find("Parse error") != String::npos)

From f99a7366da356f145ee3ff124c4be80b4f5e903b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Thu, 1 Jun 2023 16:56:18 +0200
Subject: [PATCH 159/722] Fix tests

---
 src/Storages/HDFS/StorageHDFS.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 08114ed3cba..79b7b65adb4 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -233,6 +233,7 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
         if (ctx->getSettingsRef().hdfs_skip_empty_files && path_with_info.info && path_with_info.info->size == 0)
             return read_buffer_iterator(columns);
 
+        first = false;
         auto compression = chooseCompressionMethod(path_with_info.path, compression_method);
         auto impl = std::make_unique<ReadBufferFromHDFS>(my_uri_without_path, path_with_info.path, ctx->getGlobalContext()->getConfigRef(), ctx->getReadSettings());
         const Int64 zstd_window_log_max = ctx->getSettingsRef().zstd_window_log_max;

From 38abcd1c44bc580217081d9fb3d72a1dcd951fa3 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 1 Jun 2023 19:25:53 +0000
Subject: [PATCH 160/722] Add nullable support to DateTimeTransformImpl

---
 src/Functions/DateTimeTransforms.h            | 44 ++++++++++++------
 src/Functions/FunctionsConversion.h           | 46 ++++++++++++++++++-
 .../01556_accurate_cast_or_null.reference     |  8 ++++
 .../01556_accurate_cast_or_null.sql           | 10 ++++
 4 files changed, 93 insertions(+), 15 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 81b1ec2e356..0008b36071b 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -5,6 +5,8 @@
 #include <Common/Exception.h>
 #include <Common/DateLUTImpl.h>
 #include <Common/DateLUT.h>
+#include <Columns/ColumnNullable.h>
+#include <Columns/ColumnsNumber.h>
 #include <Columns/ColumnVector.h>
 #include <Columns/ColumnDecimal.h>
 #include <Functions/FunctionHelpers.h>
@@ -1433,7 +1435,8 @@ template <typename FromType, typename ToType, typename Transform, bool is_extend
 struct Transformer
 {
     template <typename FromTypeVector, typename ToTypeVector>
-    static void vector(const FromTypeVector & vec_from, ToTypeVector & vec_to, const DateLUTImpl & time_zone, const Transform & transform)
+    static void vector(const FromTypeVector & vec_from, ToTypeVector & vec_to, const DateLUTImpl & time_zone, const Transform & transform,
+        ColumnUInt8::Container * vec_null_map_to [[maybe_unused]])
     {
         using ValueType = typename ToTypeVector::value_type;
         size_t size = vec_from.size();
@@ -1441,28 +1444,30 @@ struct Transformer
 
         for (size_t i = 0; i < size; ++i)
         {
-            constexpr bool transformHasExtraCheck = requires(const Transform& t)
+            constexpr bool transformHasIsConvertible = requires(const Transform& t)
             {
-                t.ExtraCheck(vec_from[i], time_zone);
+                t.IsConvertible(vec_from[i], time_zone);
             };
     
-            if constexpr (transformHasExtraCheck)
+            if constexpr (transformHasIsConvertible)
             {
-                // if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
-                //     || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+                if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
+                    || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
                 {
-                    bool checked = transform.ExtraCheck(vec_from[i], time_zone);
+                    bool checked = transform.IsConvertible(vec_from[i], time_zone);
                     if (!checked)
                     {
-                        if (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>)
+                        if (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
                         {
-                            // vec_to[i] = 0;
-                            // (*vec_null_map_to)[i] = true;
+                            vec_to[i] = 0;
+                            if (vec_null_map_to)
+                                (*vec_null_map_to)[i] = true;
+                            continue;
                         }
                         else
                         {
                             throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
-                                TypeName<ValueType>, TypeName<ValueType>);
+                                TypeName<typename FromTypeVector::value_type>, TypeName<ValueType>);
                         }
                     }
                 }
@@ -1488,6 +1493,14 @@ struct DateTimeTransformImpl
         const ColumnPtr source_col = arguments[0].column;
         if (const auto * sources = checkAndGetColumn<typename FromDataType::ColumnType>(source_col.get()))
         {
+            ColumnUInt8::MutablePtr col_null_map_to;
+            ColumnUInt8::Container * vec_null_map_to [[maybe_unused]] = nullptr;
+            if constexpr (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+            {
+                col_null_map_to = ColumnUInt8::create(sources->getData().size(), false);
+                vec_null_map_to = &col_null_map_to->getData();
+            }
+            
             auto mutable_result_col = result_type->createColumn();
             auto * col_to = assert_cast<typename ToDataType::ColumnType *>(mutable_result_col.get());
 
@@ -1495,7 +1508,7 @@ struct DateTimeTransformImpl
             if (result_data_type.isDateTime() || result_data_type.isDateTime64())
             {
                 const auto & time_zone = dynamic_cast<const TimezoneMixin &>(*result_type).getTimeZone();
-                Op::vector(sources->getData(), col_to->getData(), time_zone, transform);
+                Op::vector(sources->getData(), col_to->getData(), time_zone, transform, vec_null_map_to);
             }
             else
             {
@@ -1504,7 +1517,12 @@ struct DateTimeTransformImpl
                     time_zone_argument_position = 2;
 
                 const DateLUTImpl & time_zone = extractTimeZoneFromFunctionArguments(arguments, time_zone_argument_position, 0);
-                Op::vector(sources->getData(), col_to->getData(), time_zone, transform);
+                Op::vector(sources->getData(), col_to->getData(), time_zone, transform, vec_null_map_to);
+            }
+
+            if (vec_null_map_to)
+            {
+                return ColumnNullable::create(std::move(mutable_result_col), std::move(col_null_map_to));
             }
 
             return mutable_result_col;
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index d3ccbb82721..4b25a59ecc6 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -370,6 +370,11 @@ struct ToDateTransform32Or64
 {
     static constexpr auto name = "toDate";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         // since converting to Date, no need in values outside of default LUT range.
@@ -384,6 +389,11 @@ struct ToDateTransform32Or64Signed
 {
     static constexpr auto name = "toDate";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         // TODO: decide narrow or extended range based on FromType
@@ -400,7 +410,8 @@ template <typename FromType, typename ToType>
 struct ToDateTransform8Or16Signed
 {
     static constexpr auto name = "toDate";
-    static NO_SANITIZE_UNDEFINED bool ExtraCheck(const FromType & from, const DateLUTImpl &)
+
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
         return from >= 0;
     }
@@ -423,6 +434,11 @@ struct ToDate32Transform32Or64
 {
     static constexpr auto name = "toDate32";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         return (from < DATE_LUT_MAX_EXTEND_DAY_NUM)
@@ -436,6 +452,11 @@ struct ToDate32Transform32Or64Signed
 {
     static constexpr auto name = "toDate32";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         static const Int32 daynum_min_offset = -static_cast<Int32>(DateLUT::instance().getDayNumOffsetEpoch());
@@ -452,6 +473,11 @@ struct ToDate32Transform8Or16Signed
 {
     static constexpr auto name = "toDate32";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         return from;
@@ -507,6 +533,11 @@ struct ToDateTimeTransform64
 {
     static constexpr auto name = "toDateTime";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         return static_cast<ToType>(std::min(time_t(from), time_t(0xFFFFFFFF)));
@@ -518,6 +549,11 @@ struct ToDateTimeTransformSigned
 {
     static constexpr auto name = "toDateTime";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)
@@ -531,6 +567,11 @@ struct ToDateTimeTransform64Signed
 {
     static constexpr auto name = "toDateTime";
 
+    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
+    {
+        return from >= 0;
+    }
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)
@@ -2886,7 +2927,8 @@ private:
                     return true;
                 }
 
-                if constexpr (IsDataTypeNumber<LeftDataType> && IsDataTypeDateOrDateTime<RightDataType>)
+                if constexpr (IsDataTypeNumber<LeftDataType>
+                    && (std::is_same_v<RightDataType, DataTypeDate> || std::is_same_v<RightDataType, DataTypeDateTime>))
                 {
                      if (wrapper_cast_type == CastType::accurate)
                     {
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
index b329aede01a..8429d5d0e64 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
@@ -30,3 +30,11 @@
 \N
 127
 \N
+\N
+\N
+2023-05-30 14:38:20
+1970-01-01 00:00:19
+\N
+\N
+2023-05-30
+1970-01-20
\ No newline at end of file
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
index b45bbe35662..a9038a1d230 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
@@ -35,3 +35,13 @@ SELECT accurateCastOrNull(nan, 'UInt64');
 SELECT accurateCastOrNull(nan, 'UInt256');
 
 SELECT accurateCastOrNull(number + 127, 'Int8') AS x FROM numbers (2) ORDER BY x;
+
+SELECT accurateCastOrNull(-1, 'DateTime');
+SELECT accurateCastOrNull('1xxx', 'DateTime');
+SELECT accurateCastOrNull('2023-05-30 14:38:20', 'DateTime');
+SELECT accurateCastOrNull(19, 'DateTime');
+
+SELECT accurateCastOrNull(-1, 'Date');
+SELECT accurateCastOrNull('1xxx', 'Date');
+SELECT accurateCastOrNull('2023-05-30', 'Date');
+SELECT accurateCastOrNull(19, 'Date');

From 11ead24bf9d0426e15a94d87746430f16035da20 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 1 Jun 2023 19:38:46 +0000
Subject: [PATCH 161/722] Fix tests after nullable fixing

---
 .../queries/0_stateless/01556_accurate_cast_or_null.reference  | 2 +-
 tests/queries/0_stateless/01601_accurate_cast.reference        | 2 +-
 tests/queries/0_stateless/01601_accurate_cast.sql              | 2 +-
 .../0_stateless/01746_convert_type_with_default.reference      | 3 ++-
 tests/queries/0_stateless/01746_convert_type_with_default.sql  | 3 ++-
 5 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
index 8429d5d0e64..cbdf72e9910 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
@@ -37,4 +37,4 @@
 \N
 \N
 2023-05-30
-1970-01-20
\ No newline at end of file
+1970-01-20
diff --git a/tests/queries/0_stateless/01601_accurate_cast.reference b/tests/queries/0_stateless/01601_accurate_cast.reference
index b662319d263..3c6dceb1f16 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.reference
+++ b/tests/queries/0_stateless/01601_accurate_cast.reference
@@ -9,4 +9,4 @@
 2023-05-30 14:38:20
 1970-01-01 00:00:19
 2023-05-30
-1970-01-20
\ No newline at end of file
+1970-01-20
diff --git a/tests/queries/0_stateless/01601_accurate_cast.sql b/tests/queries/0_stateless/01601_accurate_cast.sql
index 1ab98e26d1a..7611b1d96b9 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.sql
+++ b/tests/queries/0_stateless/01601_accurate_cast.sql
@@ -29,6 +29,6 @@ SELECT accurateCast('2023-05-30 14:38:20', 'DateTime');
 SELECT accurateCast(19, 'DateTime');
 
 SELECT accurateCast(-1, 'Date');   -- { serverError 70 }
-SELECT accurateCast('1xxx', 'Date');   -- { serverError 70 }
+SELECT accurateCast('1xxx', 'Date');   -- { serverError 38 }
 SELECT accurateCast('2023-05-30', 'Date');
 SELECT accurateCast(19, 'Date');
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 892a12434b9..85bf2064fdc 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -40,7 +40,8 @@
 1970-01-20
 1970-01-20
 2023-05-30
-1970-01-01
+2023-05-30
+2023-05-30 14:38:20
 2023-05-30 14:38:20
 2023-05-30 14:38:20
 2023-05-30 14:38:20
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 75e1510f330..1065eefa94d 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -54,12 +54,13 @@ select toDateOrDefault(cast(19 as Int256));
 select toDateOrDefault(cast(19 as UInt256));
 
 select toDateOrDefault(19507, '2000-01-01'::Date);
-select toDateOrDefault(-1, '2000-01-01'::Date);
+select toDateOrDefault(-1, '2023-05-30'::Date);
 
 select toDateTimeOrDefault('2023-05-30 14:38:20');
 select toDateTimeOrDefault('2023-05-30 14:38:20', 'UTC');
 select toDateTimeOrDefault('1xxx', 'UTC', '2023-05-30 14:38:20'::DateTime('UTC'));
 select toDateTimeOrDefault(1685457500, 'UTC');
+select toDateTimeOrDefault(-1, 'UTC', '2023-05-30 14:38:20'::DateTime('UTC'));
 
 select toDateTimeOrDefault(cast(19 as Int8), 'UTC');
 select toDateTimeOrDefault(cast(19 as UInt8), 'UTC');

From a22e80eed56ca0e6ab35ba0ad8c53c0a629a4839 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 1 Jun 2023 19:52:48 +0000
Subject: [PATCH 162/722] Remove whitespaces

---
 src/Functions/DateTimeTransforms.h  | 6 +++---
 src/Functions/FunctionsConversion.h | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 0008b36071b..9f8f4df2465 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -1448,7 +1448,7 @@ struct Transformer
             {
                 t.IsConvertible(vec_from[i], time_zone);
             };
-    
+
             if constexpr (transformHasIsConvertible)
             {
                 if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
@@ -1472,7 +1472,7 @@ struct Transformer
                     }
                 }
             }
-            
+
             if constexpr (is_extended_result)
                 vec_to[i] = static_cast<ValueType>(transform.executeExtendedResult(vec_from[i], time_zone));
             else
@@ -1500,7 +1500,7 @@ struct DateTimeTransformImpl
                 col_null_map_to = ColumnUInt8::create(sources->getData().size(), false);
                 vec_null_map_to = &col_null_map_to->getData();
             }
-            
+
             auto mutable_result_col = result_type->createColumn();
             auto * col_to = assert_cast<typename ToDataType::ColumnType *>(mutable_result_col.get());
 
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 4b25a59ecc6..d77090afe71 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -415,7 +415,7 @@ struct ToDateTransform8Or16Signed
     {
         return from >= 0;
     }
-    
+
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)

From 7398b22fa5fc10f015be31035a65f3e6f5bd379f Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 17 May 2023 10:42:52 +0800
Subject: [PATCH 163/722] Add redis storage

---
 src/CMakeLists.txt                            |   1 +
 src/Common/ErrorCodes.cpp                     |   1 +
 src/Storages/NamedCollectionsHelpers.h        |   4 +
 src/Storages/StorageRedis.cpp                 | 231 ++++++++++++++++++
 src/Storages/StorageRedis.h                   |  91 +++++++
 src/TableFunctions/TableFunctionRedis.cpp     |  88 +++++++
 src/TableFunctions/TableFunctionRedis.h       |  29 +++
 src/TableFunctions/registerTableFunctions.cpp |   1 +
 src/TableFunctions/registerTableFunctions.h   |   1 +
 9 files changed, 447 insertions(+)
 create mode 100644 src/Storages/StorageRedis.cpp
 create mode 100644 src/Storages/StorageRedis.h
 create mode 100644 src/TableFunctions/TableFunctionRedis.cpp
 create mode 100644 src/TableFunctions/TableFunctionRedis.h

diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 622e18d4ff7..6608d86b5ed 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -412,6 +412,7 @@ dbms_target_link_libraries (
         boost::system
         clickhouse_common_io
         Poco::MongoDB
+        Poco::Redis
 )
 
 if (TARGET ch::mysqlxx)
diff --git a/src/Common/ErrorCodes.cpp b/src/Common/ErrorCodes.cpp
index 83a7314ac7a..505cf0aac8f 100644
--- a/src/Common/ErrorCodes.cpp
+++ b/src/Common/ErrorCodes.cpp
@@ -580,6 +580,7 @@
     M(695, ASYNC_LOAD_FAILED) \
     M(696, ASYNC_LOAD_CANCELED) \
     M(697, CANNOT_RESTORE_TO_NONENCRYPTED_DISK) \
+    M(698, INVALID_REDIS_STORAGE_TYPE) \
     \
     M(999, KEEPER_EXCEPTION) \
     M(1000, POCO_EXCEPTION) \
diff --git a/src/Storages/NamedCollectionsHelpers.h b/src/Storages/NamedCollectionsHelpers.h
index 1473a3fbe48..d0d6a526f9b 100644
--- a/src/Storages/NamedCollectionsHelpers.h
+++ b/src/Storages/NamedCollectionsHelpers.h
@@ -36,6 +36,10 @@ struct MongoDBEqualKeysSet
     static constexpr std::array<std::pair<std::string_view, std::string_view>, 4> equal_keys{
         std::pair{"username", "user"}, std::pair{"database", "db"}, std::pair{"hostname", "host"}, std::pair{"table", "collection"}};
 };
+struct RedisEqualKeysSet
+{
+    static constexpr std::array<std::pair<std::string_view, std::string_view>, 4> equal_keys{std::pair{"hostname", "host"}};
+};
 
 template <typename EqualKeys> struct NamedCollectionValidateKey
 {
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
new file mode 100644
index 00000000000..1daeed255ea
--- /dev/null
+++ b/src/Storages/StorageRedis.cpp
@@ -0,0 +1,231 @@
+#include <Storages/NamedCollectionsHelpers.h>
+#include <Storages/StorageFactory.h>
+#include <Storages/StorageRedis.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+
+#include <unordered_set>
+#include <Core/Settings.h>
+#include <IO/Operators.h>
+#include <Interpreters/Context.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Parsers/ASTLiteral.h>
+#include <Processors/Sinks/SinkToStorage.h>
+#include <Processors/Sources/MongoDBSource.h>
+#include <QueryPipeline/Pipe.h>
+#include <Common/NamedCollections/NamedCollections.h>
+#include <Common/parseAddress.h>
+#include <Common/Exception.h>
+#include <IO/WriteHelpers.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
+    extern const int INVALID_REDIS_STORAGE_TYPE;
+    extern const int NOT_IMPLEMENTED;
+}
+
+StorageRedis::StorageRedis(
+    const StorageID & table_id_,
+    const Configuration & configuration_,
+    const ColumnsDescription & columns_,
+    const ConstraintsDescription & constraints_,
+    const String & comment_) : ta
+{
+
+}
+
+
+Pipe StorageRedis::read(
+    const Names & column_names,
+    const StorageSnapshotPtr & storage_snapshot,
+    SelectQueryInfo & /*query_info*/,
+    ContextPtr /*context*/,
+    QueryProcessingStage::Enum /*processed_stage*/,
+    size_t max_block_size,
+    size_t /*num_streams*/)
+{
+    connectIfNotConnected();
+
+    storage_snapshot->check(column_names);
+
+    Block sample_block;
+    for (const String & column_name : column_names)
+    {
+        auto column_data = storage_snapshot->metadata->getColumns().getPhysical(column_name);
+        sample_block.insert({column_data.type, column_data.name});
+    }
+
+    return Pipe(std::make_shared<MongoDBSource>(
+        connection, createCursor(database_name, collection_name, sample_block), sample_block, max_block_size));
+}
+
+
+SinkToStoragePtr StorageRedis::write(
+    const ASTPtr & /*query*/,
+    const StorageMetadataPtr & /*metadata_snapshot*/,
+    ContextPtr /*context*/)
+{
+    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Method write is unsupported for StorageRedis");
+}
+
+StorageRedis::Configuration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr context)
+{
+    Configuration configuration;
+
+    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
+    {
+        validateNamedCollection(
+            *named_collection,
+            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_id", "storage_type"},
+            {});
+
+        configuration.host = named_collection->getAny<String>({"host", "hostname"});
+        configuration.port = static_cast<UInt16>(named_collection->get<UInt32>("port"));
+        configuration.password = named_collection->get<String>("password");
+        configuration.db_id = named_collection->getAny<String>({"db_id"});
+        configuration.storage_type = toStorageType(named_collection->getOrDefault<String>("storage_type", ""));
+    }
+    else
+    {
+        for (auto & engine_arg : engine_args)
+            engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, context);
+
+        /// 6379 is the default Redis port.
+        auto parsed_host_port = parseAddress(checkAndGetLiteralArgument<String>(engine_args[0], "host:port"), 6379);
+
+        configuration.host = parsed_host_port.first;
+        configuration.port = parsed_host_port.second;
+        configuration.db_id = checkAndGetLiteralArgument<String>(engine_args[1], "db_id");
+        configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
+        configuration.storage_type = toStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+    }
+
+    context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
+
+    return configuration;
+}
+
+void StorageRedis::connectIfNotConnected()
+{
+
+}
+
+
+class StorageRedisSink : public SinkToStorage
+{
+public:
+    explicit StorageRedisSink(
+        const std::string & collection_name_,
+        const std::string & db_name_,
+        const StorageMetadataPtr & metadata_snapshot_,
+        std::shared_ptr<Poco::MongoDB::Connection> connection_)
+        : SinkToStorage(metadata_snapshot_->getSampleBlock())
+        , collection_name(collection_name_)
+        , db_name(db_name_)
+        , metadata_snapshot{metadata_snapshot_}
+        , connection(connection_)
+    {
+    }
+
+    String getName() const override { return "StorageRedisSink"; }
+
+    void consume(Chunk chunk) override
+    {
+        Poco::MongoDB::Database db(db_name);
+        Poco::MongoDB::Document::Ptr index = new Poco::MongoDB::Document();
+
+        auto block = getHeader().cloneWithColumns(chunk.detachColumns());
+
+        size_t num_rows = block.rows();
+        size_t num_cols = block.columns();
+
+        const auto columns = block.getColumns();
+        const auto data_types = block.getDataTypes();
+        const auto data_names = block.getNames();
+
+        std::vector<std::string> row(num_cols);
+        for (const auto i : collections::range(0, num_rows))
+        {
+            for (const auto j : collections::range(0, num_cols))
+            {
+                WriteBufferFromOwnString ostr;
+                data_types[j]->getDefaultSerialization()->serializeText(*columns[j], i, ostr, FormatSettings{});
+                row[j] = ostr.str();
+                index->add(data_names[j], row[j]);
+            }
+        }
+        Poco::SharedPtr<Poco::MongoDB::InsertRequest> insert_request = db.createInsertRequest(collection_name);
+        insert_request->documents().push_back(index);
+        connection->sendRequest(*insert_request);
+    }
+
+private:
+    String collection_name;
+    String db_name;
+    StorageMetadataPtr metadata_snapshot;
+    std::shared_ptr<Poco::MongoDB::Connection> connection;
+};
+
+
+using StorageType = StorageRedis::StorageType;
+
+String StorageRedis::toString(StorageType storage_type)
+{
+    static const std::unordered_map<StorageType, String> type_to_str_map
+        = {{StorageType::SIMPLE, "simple"},
+           {StorageType::LIST, "list"},
+           {StorageType::SET, "set"},
+           {StorageType::HASH, "hash"},
+           {StorageType::ZSET, "zset"}};
+
+    auto iter = type_to_str_map.find(storage_type);
+    return iter->second;
+}
+
+StorageType StorageRedis::toStorageType(const String & storage_type)
+{
+    static const std::unordered_map<std::string, StorageType> str_to_type_map
+        = {{"simple", StorageType::SIMPLE},
+           {"list", StorageType::LIST},
+           {"set", StorageType::SET},
+           {"hash", StorageType::HASH},
+           {"zset", StorageType::ZSET}};
+
+    auto iter = str_to_type_map.find(storage_type);
+    if (iter == str_to_type_map.end())
+    {
+        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "invalid redis storage type: {}", storage_type);
+    }
+    return iter->second;
+}
+
+void registerStorageRedis(StorageFactory & factory)
+{
+    factory.registerStorage(
+        "MongoDB",
+        [](const StorageFactory::Arguments & args)
+        {
+            auto configuration = StorageRedis::getConfiguration(args.engine_args, args.getLocalContext());
+
+            return std::make_shared<StorageRedis>(
+                args.table_id,
+                configuration.host,
+                configuration.port,
+                configuration.database,
+                configuration.table,
+                configuration.username,
+                configuration.password,
+                configuration.options,
+                args.columns,
+                args.constraints,
+                args.comment);
+        },
+        {
+            .source_access_type = AccessType::MONGO,
+        });
+}
+
+}
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
new file mode 100644
index 00000000000..8ba4ec831bb
--- /dev/null
+++ b/src/Storages/StorageRedis.h
@@ -0,0 +1,91 @@
+#pragma once
+
+#include <Poco/Redis/Redis.h>
+#include <Storages/IStorage.h>
+#include <Dictionaries/RedisSource.h>
+
+namespace DB
+{
+/* Implements storage in the Redis.
+ * Use ENGINE = Redis(host:port, db_id, password, storage_type);
+ * Read only.
+ */
+class StorageRedis : public IStorage
+{
+public:
+    enum class StorageType
+    {
+        SIMPLE,
+        LIST,
+        SET,
+        HASH,
+        ZSET
+    };
+
+    static String toString(StorageType storage_type);
+    static StorageType toStorageType(const String & storage_type);
+
+    struct Configuration
+    {
+        String host;
+        uint32_t port;
+        String db_id;
+        String password;
+        StorageType storage_type;
+    };
+
+    using RedisArray = Poco::Redis::Array;
+    using RedisCommand = Poco::Redis::Command;
+
+    using ClientPtr = std::unique_ptr<Poco::Redis::Client>;
+    using Pool = BorrowedObjectPool<ClientPtr>;
+    using PoolPtr = std::shared_ptr<Pool>;
+
+    struct Connection
+    {
+        Connection(PoolPtr pool_, ClientPtr client_);
+        ~Connection();
+
+        PoolPtr pool;
+        ClientPtr client;
+    };
+
+    using ConnectionPtr = std::unique_ptr<Connection>;
+
+    static Configuration getConfiguration(ASTs engine_args, ContextPtr context);
+
+    StorageRedis(
+        const StorageID & table_id_,
+        const Configuration & configuration_,
+        const ColumnsDescription & columns_,
+        const ConstraintsDescription & constraints_,
+        const String & comment_);
+
+    std::string getName() const override { return "Redis"; }
+
+    Pipe read(
+        const Names & column_names,
+        const StorageSnapshotPtr & storage_snapshot,
+        SelectQueryInfo & query_info,
+        ContextPtr context,
+        QueryProcessingStage::Enum processed_stage,
+        size_t max_block_size,
+        size_t num_streams) override;
+
+    SinkToStoragePtr write(
+        const ASTPtr & query,
+        const StorageMetadataPtr & /*metadata_snapshot*/,
+        ContextPtr context) override;
+
+private:
+    Configuration configuration;
+    StorageID table_id;
+    ColumnsDescription columns;
+    ConstraintsDescription constraints;
+    String comment;
+
+    std::shared_ptr<Connection> connection;
+    void connectIfNotConnected();
+};
+
+}
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
new file mode 100644
index 00000000000..9432f766aa8
--- /dev/null
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -0,0 +1,88 @@
+#include <TableFunctions/TableFunctionRedis.h>
+
+#include <Common/Exception.h>
+
+#include <Interpreters/Context.h>
+#include <Interpreters/evaluateConstantExpression.h>
+
+#include <Parsers/ASTFunction.h>
+#include <Parsers/ASTIdentifier.h>
+#include <Parsers/ASTLiteral.h>
+
+#include <Interpreters/parseColumnsListForTableFunction.h>
+#include <Storages/ColumnsDescription.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+#include <TableFunctions/TableFunctionFactory.h>
+#include <TableFunctions/registerTableFunctions.h>
+
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int BAD_ARGUMENTS;
+    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
+}
+
+
+StoragePtr TableFunctionRedis::executeImpl(
+    const ASTPtr & /*ast_function*/, ContextPtr context, const String & table_name, ColumnsDescription /*cached_columns*/) const
+{
+    auto columns = getActualTableStructure(context);
+    auto storage = std::make_shared<StorageRedis>(
+        StorageID(configuration->db_id, table_name), configuration, columns, ConstraintsDescription(), String{});// TODO
+    storage->startup();
+    return storage;
+}
+
+ColumnsDescription TableFunctionRedis::getActualTableStructure(ContextPtr context) const
+{
+    /// generate table structure by storage type.
+    String structure;
+    switch (configuration->storage_type)
+    {
+        case StorageRedis::StorageType::SIMPLE:
+            structure = "key String, value String";
+            break;
+        case StorageRedis::StorageType::HASH:
+            structure = "key String, field, String, value String";
+            break;
+        case StorageRedis::StorageType::LIST:
+            structure = "key String, value Array(String)";
+            break;
+        case StorageRedis::StorageType::SET:
+            structure = "key String, value Array(String)";
+            break;
+        case StorageRedis::StorageType::ZSET:
+            structure = "key String, value Array(String)";
+            break;
+    }
+    return parseColumnsListFromString(structure, context);
+}
+
+void TableFunctionRedis::parseArguments(const ASTPtr & ast_function, ContextPtr context)
+{
+    const auto & func_args = ast_function->as<ASTFunction &>();
+    if (!func_args.arguments)
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Table function 'redis' must have arguments.");
+
+    ASTs & args = func_args.arguments->children;
+
+    if (args.size() != 4)
+    {
+        throw Exception(
+            ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
+            "Table function 'Redis' requires from 4 parameters: "
+            "redis('host:port', db_id, 'password', 'storage_type')");
+    }
+    configuration = StorageRedis::getConfiguration(args, context);
+}
+
+
+void registerTableFunctionRedis(TableFunctionFactory & factory)
+{
+    factory.registerFunction<TableFunctionRedis>();
+}
+
+}
diff --git a/src/TableFunctions/TableFunctionRedis.h b/src/TableFunctions/TableFunctionRedis.h
new file mode 100644
index 00000000000..d333cd5a42f
--- /dev/null
+++ b/src/TableFunctions/TableFunctionRedis.h
@@ -0,0 +1,29 @@
+#pragma once
+
+#include <Storages/StorageRedis.h>
+#include <TableFunctions/ITableFunction.h>
+#include <Storages/ExternalDataSourceConfiguration.h>
+
+namespace DB
+{
+
+class TableFunctionRedis : public ITableFunction
+{
+public:
+    static constexpr auto name = "redis";
+    String getName() const override { return name; }
+
+private:
+    StoragePtr executeImpl(
+        const ASTPtr & ast_function, ContextPtr context,
+        const String & table_name, ColumnsDescription cached_columns) const override;
+
+    const char * getStorageTypeName() const override { return "Redis"; }
+
+    ColumnsDescription getActualTableStructure(ContextPtr context) const override;
+    void parseArguments(const ASTPtr & ast_function, ContextPtr context) override;
+
+    std::optional<StorageRedis::Configuration> configuration;
+};
+
+}
diff --git a/src/TableFunctions/registerTableFunctions.cpp b/src/TableFunctions/registerTableFunctions.cpp
index 4f3411df4c5..bfb83818f22 100644
--- a/src/TableFunctions/registerTableFunctions.cpp
+++ b/src/TableFunctions/registerTableFunctions.cpp
@@ -21,6 +21,7 @@ void registerTableFunctions()
     registerTableFunctionInput(factory);
     registerTableFunctionGenerate(factory);
     registerTableFunctionMongoDB(factory);
+    registerTableFunctionRedis(factory);
 
     registerTableFunctionMeiliSearch(factory);
 
diff --git a/src/TableFunctions/registerTableFunctions.h b/src/TableFunctions/registerTableFunctions.h
index c51522a5e99..cf0dee7f792 100644
--- a/src/TableFunctions/registerTableFunctions.h
+++ b/src/TableFunctions/registerTableFunctions.h
@@ -18,6 +18,7 @@ void registerTableFunctionValues(TableFunctionFactory & factory);
 void registerTableFunctionInput(TableFunctionFactory & factory);
 void registerTableFunctionGenerate(TableFunctionFactory & factory);
 void registerTableFunctionMongoDB(TableFunctionFactory & factory);
+void registerTableFunctionRedis(TableFunctionFactory & factory);
 
 void registerTableFunctionMeiliSearch(TableFunctionFactory & factory);
 

From e91867373cca6d91455b51af05575c48e6d1af9e Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Sat, 20 May 2023 11:48:57 +0800
Subject: [PATCH 164/722] Add table function Redis

---
 src/Access/Common/AccessType.h             |   1 +
 src/Dictionaries/RedisDictionarySource.cpp |  80 +----------
 src/Dictionaries/RedisDictionarySource.h   |  44 +-----
 src/Dictionaries/RedisSource.cpp           |   7 +-
 src/Dictionaries/RedisSource.h             |  19 +--
 src/Storages/RedisCommon.cpp               |  98 +++++++++++++
 src/Storages/RedisCommon.h                 |  61 ++++++++
 src/Storages/StorageRedis.cpp              | 156 +++++----------------
 src/Storages/StorageRedis.h                |  55 ++------
 src/Storages/registerStorages.cpp          |   2 +
 src/TableFunctions/TableFunctionRedis.cpp  |  28 ++--
 src/TableFunctions/TableFunctionRedis.h    |   2 +-
 12 files changed, 231 insertions(+), 322 deletions(-)
 create mode 100644 src/Storages/RedisCommon.cpp
 create mode 100644 src/Storages/RedisCommon.h

diff --git a/src/Access/Common/AccessType.h b/src/Access/Common/AccessType.h
index 6394c0279a7..78c341cdcb5 100644
--- a/src/Access/Common/AccessType.h
+++ b/src/Access/Common/AccessType.h
@@ -201,6 +201,7 @@ enum class AccessType
     M(URL, "", GLOBAL, SOURCES) \
     M(REMOTE, "", GLOBAL, SOURCES) \
     M(MONGO, "", GLOBAL, SOURCES) \
+    M(Redis, "", GLOBAL, SOURCES) \
     M(MEILISEARCH, "", GLOBAL, SOURCES) \
     M(MYSQL, "", GLOBAL, SOURCES) \
     M(POSTGRES, "", GLOBAL, SOURCES) \
diff --git a/src/Dictionaries/RedisDictionarySource.cpp b/src/Dictionaries/RedisDictionarySource.cpp
index 6e4c5d1d5d9..db27801a38e 100644
--- a/src/Dictionaries/RedisDictionarySource.cpp
+++ b/src/Dictionaries/RedisDictionarySource.cpp
@@ -3,10 +3,6 @@
 #include "DictionaryStructure.h"
 #include "registerDictionaries.h"
 
-#include <Poco/Redis/Array.h>
-#include <Poco/Redis/Client.h>
-#include <Poco/Redis/Command.h>
-#include <Poco/Redis/Type.h>
 #include <Poco/Util/AbstractConfiguration.h>
 #include <Interpreters/Context.h>
 #include <QueryPipeline/QueryPipeline.h>
@@ -52,7 +48,7 @@ namespace DB
             auto port = config.getUInt(redis_config_prefix + ".port");
             global_context->getRemoteHostFilter().checkHostAndPort(host, toString(port));
 
-            RedisDictionarySource::Configuration configuration =
+            RedisConfiguration configuration =
             {
                 .host = host,
                 .port = static_cast<UInt16>(port),
@@ -68,26 +64,13 @@ namespace DB
         factory.registerSource("redis", create_table_source);
     }
 
-    RedisDictionarySource::Connection::Connection(PoolPtr pool_, ClientPtr client_)
-        : pool(std::move(pool_)), client(std::move(client_))
-    {
-    }
-
-    RedisDictionarySource::Connection::~Connection()
-    {
-        pool->returnObject(std::move(client));
-    }
-
-    static constexpr size_t REDIS_MAX_BLOCK_SIZE = DEFAULT_BLOCK_SIZE;
-    static constexpr size_t REDIS_LOCK_ACQUIRE_TIMEOUT_MS = 5000;
-
     RedisDictionarySource::RedisDictionarySource(
         const DictionaryStructure & dict_struct_,
-        const Configuration & configuration_,
+        const RedisConfiguration & configuration_,
         const Block & sample_block_)
         : dict_struct{dict_struct_}
         , configuration(configuration_)
-        , pool(std::make_shared<Pool>(configuration.pool_size))
+        , pool(std::make_shared<RedisPool>(configuration.pool_size))
         , sample_block{sample_block_}
     {
         if (dict_struct.attributes.size() != 1)
@@ -139,7 +122,7 @@ namespace DB
 
     QueryPipeline RedisDictionarySource::loadAll()
     {
-        auto connection = getConnection();
+        auto connection = getRedisConnection(pool, configuration);
 
         RedisCommand command_for_keys("KEYS");
         command_for_keys << "*";
@@ -195,7 +178,7 @@ namespace DB
 
     QueryPipeline RedisDictionarySource::loadIds(const std::vector<UInt64> & ids)
     {
-        auto connection = getConnection();
+        auto connection = getRedisConnection(pool, configuration);
 
         if (configuration.storage_type == RedisStorageType::HASH_MAP)
             throw Exception(ErrorCodes::UNSUPPORTED_METHOD, "Cannot use loadIds with 'hash_map' storage type");
@@ -215,7 +198,7 @@ namespace DB
 
     QueryPipeline RedisDictionarySource::loadKeys(const Columns & key_columns, const std::vector<size_t> & requested_rows)
     {
-        auto connection = getConnection();
+        auto connection = getRedisConnection(pool, configuration);
 
         if (key_columns.size() != dict_struct.key->size())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "The size of key_columns does not equal to the size of dictionary key");
@@ -248,55 +231,4 @@ namespace DB
         return "Redis: " + configuration.host + ':' + DB::toString(configuration.port);
     }
 
-    RedisDictionarySource::ConnectionPtr RedisDictionarySource::getConnection() const
-    {
-        ClientPtr client;
-        bool ok = pool->tryBorrowObject(client,
-            [] { return std::make_unique<Poco::Redis::Client>(); },
-            REDIS_LOCK_ACQUIRE_TIMEOUT_MS);
-
-        if (!ok)
-            throw Exception(ErrorCodes::TIMEOUT_EXCEEDED,
-                "Could not get connection from pool, timeout exceeded {} seconds",
-                REDIS_LOCK_ACQUIRE_TIMEOUT_MS);
-
-        if (!client->isConnected())
-        {
-            try
-            {
-                client->connect(configuration.host, configuration.port);
-
-                if (!configuration.password.empty())
-                {
-                    RedisCommand command("AUTH");
-                    command << configuration.password;
-                    String reply = client->execute<String>(command);
-                    if (reply != "OK")
-                        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR,
-                            "Authentication failed with reason {}", reply);
-                }
-
-                if (configuration.db_index != 0)
-                {
-                    RedisCommand command("SELECT");
-                    command << std::to_string(configuration.db_index);
-                    String reply = client->execute<String>(command);
-                    if (reply != "OK")
-                        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR,
-                            "Selecting database with index {} failed with reason {}",
-                            configuration.db_index, reply);
-                }
-            }
-            catch (...)
-            {
-                if (client->isConnected())
-                    client->disconnect();
-
-                pool->returnObject(std::move(client));
-                throw;
-            }
-        }
-
-        return std::make_unique<Connection>(pool, std::move(client));
-    }
 }
diff --git a/src/Dictionaries/RedisDictionarySource.h b/src/Dictionaries/RedisDictionarySource.h
index 8fb6f93193b..c7786284dc4 100644
--- a/src/Dictionaries/RedisDictionarySource.h
+++ b/src/Dictionaries/RedisDictionarySource.h
@@ -5,6 +5,7 @@
 
 #include "DictionaryStructure.h"
 #include "IDictionarySource.h"
+#include <Storages/RedisCommon.h>
 
 namespace Poco
 {
@@ -23,47 +24,12 @@ namespace DB
         extern const int NOT_IMPLEMENTED;
     }
 
-    enum class RedisStorageType
-    {
-            SIMPLE,
-            HASH_MAP,
-            UNKNOWN
-    };
-
     class RedisDictionarySource final : public IDictionarySource
     {
     public:
-        using RedisArray = Poco::Redis::Array;
-        using RedisCommand = Poco::Redis::Command;
-
-        using ClientPtr = std::unique_ptr<Poco::Redis::Client>;
-        using Pool = BorrowedObjectPool<ClientPtr>;
-        using PoolPtr = std::shared_ptr<Pool>;
-
-        struct Configuration
-        {
-            const std::string host;
-            const UInt16 port;
-            const UInt32 db_index;
-            const std::string password;
-            const RedisStorageType storage_type;
-            const size_t pool_size;
-        };
-
-        struct Connection
-        {
-            Connection(PoolPtr pool_, ClientPtr client_);
-            ~Connection();
-
-            PoolPtr pool;
-            ClientPtr client;
-        };
-
-        using ConnectionPtr = std::unique_ptr<Connection>;
-
         RedisDictionarySource(
             const DictionaryStructure & dict_struct_,
-            const Configuration & configuration_,
+            const RedisConfiguration & configuration_,
             const Block & sample_block_);
 
         RedisDictionarySource(const RedisDictionarySource & other);
@@ -92,12 +58,10 @@ namespace DB
         std::string toString() const override;
 
     private:
-        ConnectionPtr getConnection() const;
-
         const DictionaryStructure dict_struct;
-        const Configuration configuration;
+        const RedisConfiguration configuration;
 
-        PoolPtr pool;
+        RedisPoolPtr pool;
         Block sample_block;
     };
 }
diff --git a/src/Dictionaries/RedisSource.cpp b/src/Dictionaries/RedisSource.cpp
index 4622f65a1a9..9abaf7f0ac5 100644
--- a/src/Dictionaries/RedisSource.cpp
+++ b/src/Dictionaries/RedisSource.cpp
@@ -3,11 +3,6 @@
 #include <string>
 #include <vector>
 
-#include <Poco/Redis/Array.h>
-#include <Poco/Redis/Client.h>
-#include <Poco/Redis/Command.h>
-#include <Poco/Redis/Type.h>
-
 #include <Columns/ColumnNullable.h>
 #include <Columns/ColumnString.h>
 #include <Columns/ColumnsNumber.h>
@@ -30,7 +25,7 @@ namespace DB
 
 
     RedisSource::RedisSource(
-        ConnectionPtr connection_,
+        RedisConnectionPtr connection_,
         const RedisArray & keys_,
         const RedisStorageType & storage_type_,
         const DB::Block & sample_block,
diff --git a/src/Dictionaries/RedisSource.h b/src/Dictionaries/RedisSource.h
index 0f8cc317003..4537e496061 100644
--- a/src/Dictionaries/RedisSource.h
+++ b/src/Dictionaries/RedisSource.h
@@ -6,29 +6,18 @@
 #include <Processors/ISource.h>
 #include <Poco/Redis/Array.h>
 #include <Poco/Redis/Type.h>
+#include <Storages/RedisCommon.h>
 #include "RedisDictionarySource.h"
 
-namespace Poco
-{
-    namespace Redis
-    {
-        class Client;
-    }
-}
-
 
 namespace DB
 {
     class RedisSource final : public ISource
     {
     public:
-        using RedisArray = Poco::Redis::Array;
-        using RedisBulkString = Poco::Redis::BulkString;
-        using ConnectionPtr = RedisDictionarySource::ConnectionPtr;
-
         RedisSource(
-            ConnectionPtr connection_,
-            const Poco::Redis::Array & keys_,
+            RedisConnectionPtr connection_,
+            const RedisArray & keys_,
             const RedisStorageType & storage_type_,
             const Block & sample_block,
             size_t max_block_size);
@@ -40,7 +29,7 @@ namespace DB
     private:
         Chunk generate() override;
 
-        ConnectionPtr connection;
+        RedisConnectionPtr connection;
         Poco::Redis::Array keys;
         RedisStorageType storage_type;
         const size_t max_block_size;
diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
new file mode 100644
index 00000000000..397189e7485
--- /dev/null
+++ b/src/Storages/RedisCommon.cpp
@@ -0,0 +1,98 @@
+#include "RedisCommon.h"
+#include <Common/Exception.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int INVALID_REDIS_STORAGE_TYPE;
+    extern const int INTERNAL_REDIS_ERROR;
+    extern const int TIMEOUT_EXCEEDED;
+}
+
+RedisConnection::RedisConnection(RedisPoolPtr pool_, RedisClientPtr client_)
+    : pool(std::move(pool_)), client(std::move(client_))
+{
+}
+
+RedisConnection::~RedisConnection()
+{
+    pool->returnObject(std::move(client));
+}
+
+String toString(RedisStorageType storage_type)
+{
+    static const std::unordered_map<RedisStorageType, String> type_to_str_map
+        = {{RedisStorageType::SIMPLE, "simple"}, {RedisStorageType::HASH_MAP, "hash_map"}};
+
+    auto iter = type_to_str_map.find(storage_type);
+    return iter->second;
+}
+
+RedisStorageType toRedisStorageType(const String & storage_type)
+{
+    static const std::unordered_map<std::string, RedisStorageType> str_to_type_map
+        = {{"simple", RedisStorageType::SIMPLE}, {"hash", RedisStorageType::HASH_MAP}};
+
+    auto iter = str_to_type_map.find(storage_type);
+    if (iter == str_to_type_map.end())
+    {
+        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "invalid redis storage type: {}", storage_type);
+    }
+    return iter->second;
+}
+
+RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguration & configuration)
+{
+    RedisClientPtr client;
+    bool ok = pool->tryBorrowObject(client,
+        [] { return std::make_unique<Poco::Redis::Client>(); },
+        REDIS_LOCK_ACQUIRE_TIMEOUT_MS);
+
+    if (!ok)
+        throw Exception(ErrorCodes::TIMEOUT_EXCEEDED,
+                        "Could not get connection from pool, timeout exceeded {} seconds",
+                        REDIS_LOCK_ACQUIRE_TIMEOUT_MS);
+
+    if (!client->isConnected())
+    {
+        try
+        {
+            client->connect(configuration.host, configuration.port);
+
+            if (!configuration.password.empty())
+            {
+                RedisCommand command("AUTH");
+                command << configuration.password;
+                String reply = client->execute<String>(command);
+                if (reply != "OK")
+                    throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR,
+                                    "Authentication failed with reason {}", reply);
+            }
+
+            if (configuration.db_index != 0)
+            {
+                RedisCommand command("SELECT");
+                command << std::to_string(configuration.db_index);
+                String reply = client->execute<String>(command);
+                if (reply != "OK")
+                    throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR,
+                                    "Selecting database with index {} failed with reason {}",
+                                    configuration.db_index, reply);
+            }
+        }
+        catch (...)
+        {
+            if (client->isConnected())
+                client->disconnect();
+
+            pool->returnObject(std::move(client));
+            throw;
+        }
+    }
+
+    return std::make_unique<RedisConnection>(pool, std::move(client));
+}
+
+}
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
new file mode 100644
index 00000000000..6069d3d9a0c
--- /dev/null
+++ b/src/Storages/RedisCommon.h
@@ -0,0 +1,61 @@
+#pragma once
+
+#include <Poco/Redis/Client.h>
+#include <Poco/Redis/Command.h>
+#include <Poco/Redis/Array.h>
+
+#include <Core/Defines.h>
+#include <base/BorrowedObjectPool.h>
+
+namespace DB
+{
+namespace ErrorCodes
+{
+    extern const int NOT_IMPLEMENTED;
+}
+
+static constexpr size_t REDIS_MAX_BLOCK_SIZE = DEFAULT_BLOCK_SIZE;
+static constexpr size_t REDIS_LOCK_ACQUIRE_TIMEOUT_MS = 5000;
+
+enum class RedisStorageType
+{
+    SIMPLE,
+    HASH_MAP,
+    UNKNOWN
+};
+
+String toString(RedisStorageType storage_type);
+RedisStorageType toRedisStorageType(const String & storage_type);
+
+struct RedisConfiguration
+{
+    String host;
+    uint32_t port;
+    uint32_t db_index;
+    String password;
+    RedisStorageType storage_type;
+    uint32_t pool_size;
+};
+
+using RedisArray = Poco::Redis::Array;
+using RedisCommand = Poco::Redis::Command;
+using RedisBulkString = Poco::Redis::BulkString;
+
+using RedisClientPtr = std::unique_ptr<Poco::Redis::Client>;
+using RedisPool = BorrowedObjectPool<RedisClientPtr>;
+using RedisPoolPtr = std::shared_ptr<RedisPool>;
+
+struct RedisConnection
+{
+    RedisConnection(RedisPoolPtr pool_, RedisClientPtr client_);
+    ~RedisConnection();
+
+    RedisPoolPtr pool;
+    RedisClientPtr client;
+};
+
+using RedisConnectionPtr = std::unique_ptr<RedisConnection>;
+
+RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguration & configuration) ;
+
+}
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 1daeed255ea..055617b6a96 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -1,6 +1,6 @@
-#include <Storages/NamedCollectionsHelpers.h>
-#include <Storages/StorageFactory.h>
 #include <Storages/StorageRedis.h>
+#include <Storages/StorageFactory.h>
+#include <Storages/NamedCollectionsHelpers.h>
 #include <Storages/checkAndGetLiteralArgument.h>
 
 #include <unordered_set>
@@ -10,7 +10,6 @@
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Parsers/ASTLiteral.h>
 #include <Processors/Sinks/SinkToStorage.h>
-#include <Processors/Sources/MongoDBSource.h>
 #include <QueryPipeline/Pipe.h>
 #include <Common/NamedCollections/NamedCollections.h>
 #include <Common/parseAddress.h>
@@ -23,21 +22,25 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
-    extern const int INVALID_REDIS_STORAGE_TYPE;
     extern const int NOT_IMPLEMENTED;
 }
 
 StorageRedis::StorageRedis(
     const StorageID & table_id_,
-    const Configuration & configuration_,
+    const RedisConfiguration & configuration_,
     const ColumnsDescription & columns_,
     const ConstraintsDescription & constraints_,
-    const String & comment_) : ta
+    const String & comment_)
+    : IStorage(table_id_)
+    , table_id(table_id_)
+    , configuration(configuration_)
+    , columns(columns_)
+    , constraints(constraints_)
+    , comment(comment_)
 {
-
+    pool = std::make_shared<RedisPool>(configuration.pool_size);
 }
 
-
 Pipe StorageRedis::read(
     const Names & column_names,
     const StorageSnapshotPtr & storage_snapshot,
@@ -47,7 +50,7 @@ Pipe StorageRedis::read(
     size_t max_block_size,
     size_t /*num_streams*/)
 {
-    connectIfNotConnected();
+    auto connection = getRedisConnection(pool, configuration);
 
     storage_snapshot->check(column_names);
 
@@ -58,8 +61,14 @@ Pipe StorageRedis::read(
         sample_block.insert({column_data.type, column_data.name});
     }
 
-    return Pipe(std::make_shared<MongoDBSource>(
-        connection, createCursor(database_name, collection_name, sample_block), sample_block, max_block_size));
+    RedisArray keys;
+    RedisCommand command_for_keys("KEYS");
+    /// generate keys by table name prefix
+    command_for_keys << table_id.getTableName() + ":" + toString(configuration.storage_type) + ":*";
+
+    /// Get only keys for specified storage type.
+    auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
+    return Pipe(std::make_shared<RedisSource>(std::move(connection), all_keys, configuration.storage_type, sample_block, max_block_size));
 }
 
 
@@ -71,22 +80,23 @@ SinkToStoragePtr StorageRedis::write(
     throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Method write is unsupported for StorageRedis");
 }
 
-StorageRedis::Configuration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr context)
+RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr context)
 {
-    Configuration configuration;
+    RedisConfiguration configuration;
 
     if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
     {
         validateNamedCollection(
             *named_collection,
-            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_id", "storage_type"},
+            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "storage_type"},
             {});
 
         configuration.host = named_collection->getAny<String>({"host", "hostname"});
-        configuration.port = static_cast<UInt16>(named_collection->get<UInt32>("port"));
+        configuration.port = static_cast<uint32_t>(named_collection->get<UInt64>("port"));
         configuration.password = named_collection->get<String>("password");
-        configuration.db_id = named_collection->getAny<String>({"db_id"});
-        configuration.storage_type = toStorageType(named_collection->getOrDefault<String>("storage_type", ""));
+        configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>({"db_index"}));
+        configuration.storage_type = toRedisStorageType(named_collection->getOrDefault<String>("storage_type", ""));
+        configuration.pool_size = 16; /// TODO
     }
     else
     {
@@ -98,133 +108,33 @@ StorageRedis::Configuration StorageRedis::getConfiguration(ASTs engine_args, Con
 
         configuration.host = parsed_host_port.first;
         configuration.port = parsed_host_port.second;
-        configuration.db_id = checkAndGetLiteralArgument<String>(engine_args[1], "db_id");
+        configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
         configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
-        configuration.storage_type = toStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+        configuration.storage_type = toRedisStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+        configuration.pool_size = 16; /// TODO
     }
 
     context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
-
     return configuration;
 }
 
-void StorageRedis::connectIfNotConnected()
-{
-
-}
-
-
-class StorageRedisSink : public SinkToStorage
-{
-public:
-    explicit StorageRedisSink(
-        const std::string & collection_name_,
-        const std::string & db_name_,
-        const StorageMetadataPtr & metadata_snapshot_,
-        std::shared_ptr<Poco::MongoDB::Connection> connection_)
-        : SinkToStorage(metadata_snapshot_->getSampleBlock())
-        , collection_name(collection_name_)
-        , db_name(db_name_)
-        , metadata_snapshot{metadata_snapshot_}
-        , connection(connection_)
-    {
-    }
-
-    String getName() const override { return "StorageRedisSink"; }
-
-    void consume(Chunk chunk) override
-    {
-        Poco::MongoDB::Database db(db_name);
-        Poco::MongoDB::Document::Ptr index = new Poco::MongoDB::Document();
-
-        auto block = getHeader().cloneWithColumns(chunk.detachColumns());
-
-        size_t num_rows = block.rows();
-        size_t num_cols = block.columns();
-
-        const auto columns = block.getColumns();
-        const auto data_types = block.getDataTypes();
-        const auto data_names = block.getNames();
-
-        std::vector<std::string> row(num_cols);
-        for (const auto i : collections::range(0, num_rows))
-        {
-            for (const auto j : collections::range(0, num_cols))
-            {
-                WriteBufferFromOwnString ostr;
-                data_types[j]->getDefaultSerialization()->serializeText(*columns[j], i, ostr, FormatSettings{});
-                row[j] = ostr.str();
-                index->add(data_names[j], row[j]);
-            }
-        }
-        Poco::SharedPtr<Poco::MongoDB::InsertRequest> insert_request = db.createInsertRequest(collection_name);
-        insert_request->documents().push_back(index);
-        connection->sendRequest(*insert_request);
-    }
-
-private:
-    String collection_name;
-    String db_name;
-    StorageMetadataPtr metadata_snapshot;
-    std::shared_ptr<Poco::MongoDB::Connection> connection;
-};
-
-
-using StorageType = StorageRedis::StorageType;
-
-String StorageRedis::toString(StorageType storage_type)
-{
-    static const std::unordered_map<StorageType, String> type_to_str_map
-        = {{StorageType::SIMPLE, "simple"},
-           {StorageType::LIST, "list"},
-           {StorageType::SET, "set"},
-           {StorageType::HASH, "hash"},
-           {StorageType::ZSET, "zset"}};
-
-    auto iter = type_to_str_map.find(storage_type);
-    return iter->second;
-}
-
-StorageType StorageRedis::toStorageType(const String & storage_type)
-{
-    static const std::unordered_map<std::string, StorageType> str_to_type_map
-        = {{"simple", StorageType::SIMPLE},
-           {"list", StorageType::LIST},
-           {"set", StorageType::SET},
-           {"hash", StorageType::HASH},
-           {"zset", StorageType::ZSET}};
-
-    auto iter = str_to_type_map.find(storage_type);
-    if (iter == str_to_type_map.end())
-    {
-        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "invalid redis storage type: {}", storage_type);
-    }
-    return iter->second;
-}
-
 void registerStorageRedis(StorageFactory & factory)
 {
     factory.registerStorage(
-        "MongoDB",
+        "Redis",
         [](const StorageFactory::Arguments & args)
         {
             auto configuration = StorageRedis::getConfiguration(args.engine_args, args.getLocalContext());
 
             return std::make_shared<StorageRedis>(
                 args.table_id,
-                configuration.host,
-                configuration.port,
-                configuration.database,
-                configuration.table,
-                configuration.username,
-                configuration.password,
-                configuration.options,
+                configuration,
                 args.columns,
                 args.constraints,
                 args.comment);
         },
         {
-            .source_access_type = AccessType::MONGO,
+            .source_access_type = AccessType::Redis,
         });
 }
 
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 8ba4ec831bb..60db75dd384 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -7,56 +7,15 @@
 namespace DB
 {
 /* Implements storage in the Redis.
- * Use ENGINE = Redis(host:port, db_id, password, storage_type);
+ * Use ENGINE = Redis(host:port, db_index, password, storage_type);
  * Read only.
  */
 class StorageRedis : public IStorage
 {
 public:
-    enum class StorageType
-    {
-        SIMPLE,
-        LIST,
-        SET,
-        HASH,
-        ZSET
-    };
-
-    static String toString(StorageType storage_type);
-    static StorageType toStorageType(const String & storage_type);
-
-    struct Configuration
-    {
-        String host;
-        uint32_t port;
-        String db_id;
-        String password;
-        StorageType storage_type;
-    };
-
-    using RedisArray = Poco::Redis::Array;
-    using RedisCommand = Poco::Redis::Command;
-
-    using ClientPtr = std::unique_ptr<Poco::Redis::Client>;
-    using Pool = BorrowedObjectPool<ClientPtr>;
-    using PoolPtr = std::shared_ptr<Pool>;
-
-    struct Connection
-    {
-        Connection(PoolPtr pool_, ClientPtr client_);
-        ~Connection();
-
-        PoolPtr pool;
-        ClientPtr client;
-    };
-
-    using ConnectionPtr = std::unique_ptr<Connection>;
-
-    static Configuration getConfiguration(ASTs engine_args, ContextPtr context);
-
     StorageRedis(
         const StorageID & table_id_,
-        const Configuration & configuration_,
+        const RedisConfiguration & configuration_,
         const ColumnsDescription & columns_,
         const ConstraintsDescription & constraints_,
         const String & comment_);
@@ -77,15 +36,17 @@ public:
         const StorageMetadataPtr & /*metadata_snapshot*/,
         ContextPtr context) override;
 
+    static RedisConfiguration getConfiguration(ASTs engine_args, ContextPtr context);
+
 private:
-    Configuration configuration;
     StorageID table_id;
+    RedisConfiguration configuration;
+
     ColumnsDescription columns;
     ConstraintsDescription constraints;
-    String comment;
 
-    std::shared_ptr<Connection> connection;
-    void connectIfNotConnected();
+    String comment;
+    RedisPoolPtr pool;
 };
 
 }
diff --git a/src/Storages/registerStorages.cpp b/src/Storages/registerStorages.cpp
index 8be176a5375..84994298b8e 100644
--- a/src/Storages/registerStorages.cpp
+++ b/src/Storages/registerStorages.cpp
@@ -59,6 +59,7 @@ void registerStorageMySQL(StorageFactory & factory);
 #endif
 
 void registerStorageMongoDB(StorageFactory & factory);
+void registerStorageRedis(StorageFactory & factory);
 
 
 #if USE_RDKAFKA
@@ -156,6 +157,7 @@ void registerStorages()
     #endif
 
     registerStorageMongoDB(factory);
+    registerStorageRedis(factory);
 
     #if USE_RDKAFKA
     registerStorageKafka(factory);
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index 9432f766aa8..db612806652 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -1,17 +1,15 @@
 #include <TableFunctions/TableFunctionRedis.h>
 
 #include <Common/Exception.h>
+#include <IO/WriteBuffer.h>
 
 #include <Interpreters/Context.h>
-#include <Interpreters/evaluateConstantExpression.h>
 
 #include <Parsers/ASTFunction.h>
 #include <Parsers/ASTIdentifier.h>
-#include <Parsers/ASTLiteral.h>
 
 #include <Interpreters/parseColumnsListForTableFunction.h>
 #include <Storages/ColumnsDescription.h>
-#include <Storages/checkAndGetLiteralArgument.h>
 #include <TableFunctions/TableFunctionFactory.h>
 #include <TableFunctions/registerTableFunctions.h>
 
@@ -23,6 +21,7 @@ namespace ErrorCodes
 {
     extern const int BAD_ARGUMENTS;
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
+    extern const int INVALID_REDIS_STORAGE_TYPE;
 }
 
 
@@ -31,7 +30,11 @@ StoragePtr TableFunctionRedis::executeImpl(
 {
     auto columns = getActualTableStructure(context);
     auto storage = std::make_shared<StorageRedis>(
-        StorageID(configuration->db_id, table_name), configuration, columns, ConstraintsDescription(), String{});// TODO
+        StorageID(toString(configuration->db_index), table_name), // TODO
+        *configuration,
+        columns,
+        ConstraintsDescription(),
+        String{});
     storage->startup();
     return storage;
 }
@@ -42,21 +45,14 @@ ColumnsDescription TableFunctionRedis::getActualTableStructure(ContextPtr contex
     String structure;
     switch (configuration->storage_type)
     {
-        case StorageRedis::StorageType::SIMPLE:
+        case RedisStorageType::SIMPLE:
             structure = "key String, value String";
             break;
-        case StorageRedis::StorageType::HASH:
+        case RedisStorageType::HASH_MAP:
             structure = "key String, field, String, value String";
             break;
-        case StorageRedis::StorageType::LIST:
-            structure = "key String, value Array(String)";
-            break;
-        case StorageRedis::StorageType::SET:
-            structure = "key String, value Array(String)";
-            break;
-        case StorageRedis::StorageType::ZSET:
-            structure = "key String, value Array(String)";
-            break;
+        case RedisStorageType::UNKNOWN:
+            throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "invalid redis storage type.");
     }
     return parseColumnsListFromString(structure, context);
 }
@@ -74,7 +70,7 @@ void TableFunctionRedis::parseArguments(const ASTPtr & ast_function, ContextPtr
         throw Exception(
             ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
             "Table function 'Redis' requires from 4 parameters: "
-            "redis('host:port', db_id, 'password', 'storage_type')");
+            "redis('host:port', db_index, 'password', 'storage_type')");
     }
     configuration = StorageRedis::getConfiguration(args, context);
 }
diff --git a/src/TableFunctions/TableFunctionRedis.h b/src/TableFunctions/TableFunctionRedis.h
index d333cd5a42f..5c6f483fda7 100644
--- a/src/TableFunctions/TableFunctionRedis.h
+++ b/src/TableFunctions/TableFunctionRedis.h
@@ -23,7 +23,7 @@ private:
     ColumnsDescription getActualTableStructure(ContextPtr context) const override;
     void parseArguments(const ASTPtr & ast_function, ContextPtr context) override;
 
-    std::optional<StorageRedis::Configuration> configuration;
+    std::optional<RedisConfiguration> configuration;
 };
 
 }

From 9a495cbf997d4c0c4ff00b9c75f958b5fa7292d6 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Tue, 23 May 2023 15:31:50 +0800
Subject: [PATCH 165/722] Push down filter into Redis

---
 src/Dictionaries/RedisDictionarySource.cpp |  43 +-----
 src/Dictionaries/RedisSource.cpp           |  52 +++++++-
 src/Dictionaries/RedisSource.h             |  10 ++
 src/Storages/RedisCommon.cpp               |  68 +++++++---
 src/Storages/RedisCommon.h                 |  28 +++-
 src/Storages/StorageRedis.cpp              | 144 ++++++++++++++++++---
 src/Storages/StorageRedis.h                |  11 +-
 src/TableFunctions/TableFunctionRedis.cpp  |  10 +-
 8 files changed, 271 insertions(+), 95 deletions(-)

diff --git a/src/Dictionaries/RedisDictionarySource.cpp b/src/Dictionaries/RedisDictionarySource.cpp
index db27801a38e..f96c9231827 100644
--- a/src/Dictionaries/RedisDictionarySource.cpp
+++ b/src/Dictionaries/RedisDictionarySource.cpp
@@ -105,21 +105,6 @@ namespace DB
 
     RedisDictionarySource::~RedisDictionarySource() = default;
 
-    static String storageTypeToKeyType(RedisStorageType type)
-    {
-        switch (type)
-        {
-            case RedisStorageType::SIMPLE:
-                return "string";
-            case RedisStorageType::HASH_MAP:
-                return "hash";
-            default:
-                return "none";
-        }
-
-        UNREACHABLE();
-    }
-
     QueryPipeline RedisDictionarySource::loadAll()
     {
         auto connection = getRedisConnection(pool, configuration);
@@ -142,33 +127,7 @@ namespace DB
 
         if (configuration.storage_type == RedisStorageType::HASH_MAP)
         {
-            RedisArray hkeys;
-            for (const auto & key : keys)
-            {
-                RedisCommand command_for_secondary_keys("HKEYS");
-                command_for_secondary_keys.addRedisType(key);
-
-                auto secondary_keys = connection->client->execute<RedisArray>(command_for_secondary_keys);
-
-                RedisArray primary_with_secondary;
-                primary_with_secondary.addRedisType(key);
-                for (const auto & secondary_key : secondary_keys)
-                {
-                    primary_with_secondary.addRedisType(secondary_key);
-                    /// Do not store more than max_block_size values for one request.
-                    if (primary_with_secondary.size() == REDIS_MAX_BLOCK_SIZE + 1)
-                    {
-                        hkeys.add(primary_with_secondary);
-                        primary_with_secondary.clear();
-                        primary_with_secondary.addRedisType(key);
-                    }
-                }
-
-                if (primary_with_secondary.size() > 1)
-                    hkeys.add(primary_with_secondary);
-            }
-
-            keys = hkeys;
+            keys = *getRedisHashMapKeys(connection, keys);
         }
 
         return QueryPipeline(std::make_shared<RedisSource>(
diff --git a/src/Dictionaries/RedisSource.cpp b/src/Dictionaries/RedisSource.cpp
index 9abaf7f0ac5..20e0838886c 100644
--- a/src/Dictionaries/RedisSource.cpp
+++ b/src/Dictionaries/RedisSource.cpp
@@ -30,11 +30,29 @@ namespace DB
         const RedisStorageType & storage_type_,
         const DB::Block & sample_block,
         size_t max_block_size_)
+        : ISource(sample_block), max_block_size(max_block_size_)// TODO
+    {
+            RedisColumnTypes columns_types_;
+            if (storage_type_ == RedisStorageType::HASH_MAP)
+                columns_types_ = REDIS_HASH_MAP_COLUMN_TYPES;
+            else
+                columns_types_ = REDIS_SIMPLE_COLUMN_TYPES;
+            RedisSource(std::move(connection_), keys_, storage_type_, sample_block, columns_types_, max_block_size_);
+    }
+
+    RedisSource::RedisSource(
+        RedisConnectionPtr connection_,
+        const RedisArray & keys_,
+        const RedisStorageType & storage_type_,
+        const DB::Block & sample_block,
+        const RedisColumnTypes & columns_types_,
+        size_t max_block_size_)
         : ISource(sample_block)
         , connection(std::move(connection_))
         , keys(keys_)
         , storage_type(storage_type_)
         , max_block_size{max_block_size_}
+        , columns_types(columns_types_)
     {
         description.init(sample_block);
     }
@@ -173,15 +191,27 @@ namespace DB
                 const auto & primary_key = keys_array.get<RedisBulkString>(0);
                 for (size_t i = 0; i < values.size(); ++i)
                 {
-                    const auto & secondary_key = keys_array.get<RedisBulkString>(i + 1);
                     const auto & value = values.get<RedisBulkString>(i);
+                    const auto & secondary_key = keys_array.get<RedisBulkString>(i + 1);
 
                     /// null string means 'no value for requested key'
                     if (!value.isNull())
                     {
-                        insert_value_by_idx(0, primary_key);
-                        insert_value_by_idx(1, secondary_key);
-                        insert_value_by_idx(2, value);
+                        for (size_t idx=0; idx<description.types.size(); idx++)
+                        {
+                            switch (columns_types[idx])
+                            {
+                                case RedisColumnType::KEY:
+                                    insert_value_by_idx(idx, primary_key);
+                                    break;
+                                case RedisColumnType::FIELD:
+                                    insert_value_by_idx(idx, secondary_key);
+                                    break;
+                                case RedisColumnType::VALUE:
+                                    insert_value_by_idx(idx, value);
+                                    break;
+                            }
+                        }
                         ++num_rows;
                     }
                 }
@@ -208,8 +238,18 @@ namespace DB
                 /// Null string means 'no value for requested key'
                 if (!value.isNull())
                 {
-                    insert_value_by_idx(0, key);
-                    insert_value_by_idx(1, value);
+                    for (size_t idx=0; idx<description.types.size(); idx++)
+                    {
+                        switch (columns_types[idx])
+                        {
+                            case RedisColumnType::KEY:
+                                insert_value_by_idx(idx, key);
+                                break;
+                            default:
+                                insert_value_by_idx(idx, value);
+                                break;
+                        }
+                    }
                 }
             }
             cursor += need_values;
diff --git a/src/Dictionaries/RedisSource.h b/src/Dictionaries/RedisSource.h
index 4537e496061..fe5a973d57c 100644
--- a/src/Dictionaries/RedisSource.h
+++ b/src/Dictionaries/RedisSource.h
@@ -15,11 +15,19 @@ namespace DB
     class RedisSource final : public ISource
     {
     public:
+        RedisSource(
+            RedisConnectionPtr connection_,
+            const RedisArray & keys_,
+            const RedisStorageType & storage_type_,
+            const DB::Block & sample_block,
+            size_t max_block_size);
+
         RedisSource(
             RedisConnectionPtr connection_,
             const RedisArray & keys_,
             const RedisStorageType & storage_type_,
             const Block & sample_block,
+            const RedisColumnTypes & columns_types_,
             size_t max_block_size);
 
         ~RedisSource() override;
@@ -34,6 +42,8 @@ namespace DB
         RedisStorageType storage_type;
         const size_t max_block_size;
         ExternalResultDescription description;
+        /// Types is corresponding to description.sample_block one by one
+        RedisColumnTypes columns_types;
         size_t cursor = 0;
         bool all_read = false;
     };
diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 397189e7485..b910759fe52 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -11,6 +11,9 @@ namespace ErrorCodes
     extern const int TIMEOUT_EXCEEDED;
 }
 
+RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES = {RedisColumnType::KEY, RedisColumnType::FIELD, RedisColumnType::VALUE};
+RedisColumnTypes REDIS_SIMPLE_COLUMN_TYPES = {RedisColumnType::KEY, RedisColumnType::VALUE};
+
 RedisConnection::RedisConnection(RedisPoolPtr pool_, RedisClientPtr client_)
     : pool(std::move(pool_)), client(std::move(client_))
 {
@@ -21,26 +24,27 @@ RedisConnection::~RedisConnection()
     pool->returnObject(std::move(client));
 }
 
-String toString(RedisStorageType storage_type)
+String storageTypeToKeyType(RedisStorageType storage_type)
 {
-    static const std::unordered_map<RedisStorageType, String> type_to_str_map
-        = {{RedisStorageType::SIMPLE, "simple"}, {RedisStorageType::HASH_MAP, "hash_map"}};
-
-    auto iter = type_to_str_map.find(storage_type);
-    return iter->second;
+    switch (storage_type)
+    {
+        case RedisStorageType::SIMPLE:
+            return "string";
+        case RedisStorageType::HASH_MAP:
+            return "hash";
+        default:
+            return "none";
+    }
 }
 
-RedisStorageType toRedisStorageType(const String & storage_type)
+RedisStorageType keyTypeToStorageType(const String & key_type)
 {
-    static const std::unordered_map<std::string, RedisStorageType> str_to_type_map
-        = {{"simple", RedisStorageType::SIMPLE}, {"hash", RedisStorageType::HASH_MAP}};
-
-    auto iter = str_to_type_map.find(storage_type);
-    if (iter == str_to_type_map.end())
-    {
-        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "invalid redis storage type: {}", storage_type);
-    }
-    return iter->second;
+    if (key_type == "string")
+        return RedisStorageType::SIMPLE;
+    else if (key_type == "hash")
+        return RedisStorageType::HASH_MAP;
+    else
+        return RedisStorageType::UNKNOWN;
 }
 
 RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguration & configuration)
@@ -95,4 +99,36 @@ RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguratio
     return std::make_unique<RedisConnection>(pool, std::move(client));
 }
 
+
+RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisArray & keys)
+{
+    RedisArrayPtr hkeys = std::make_shared<RedisArray>();
+    for (const auto & key : keys)
+    {
+        RedisCommand command_for_secondary_keys("HKEYS");
+        command_for_secondary_keys.addRedisType(key);
+
+        auto secondary_keys = connection->client->execute<RedisArray>(command_for_secondary_keys);
+
+        RedisArray primary_with_secondary;
+        primary_with_secondary.addRedisType(key);
+        for (const auto & secondary_key : secondary_keys)
+        {
+            primary_with_secondary.addRedisType(secondary_key);
+            /// Do not store more than max_block_size values for one request.
+            if (primary_with_secondary.size() == REDIS_MAX_BLOCK_SIZE + 1)
+            {
+                hkeys->add(primary_with_secondary);
+                primary_with_secondary.clear();
+                primary_with_secondary.addRedisType(key);
+            }
+        }
+
+        if (primary_with_secondary.size() > 1)
+            hkeys->add(primary_with_secondary);
+    }
+
+    return hkeys;
+}
+
 }
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 6069d3d9a0c..590ea1476c4 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -24,8 +24,23 @@ enum class RedisStorageType
     UNKNOWN
 };
 
-String toString(RedisStorageType storage_type);
-RedisStorageType toRedisStorageType(const String & storage_type);
+enum class RedisColumnType
+{
+    /// Redis key
+    KEY,
+    /// Redis map field
+    FIELD,
+    /// Redis value
+    VALUE
+};
+
+using RedisColumnTypes = std::vector<RedisColumnType>;
+
+extern RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES;
+extern RedisColumnTypes REDIS_SIMPLE_COLUMN_TYPES;
+
+String storageTypeToKeyType(RedisStorageType storage_type);
+RedisStorageType keyTypeToStorageType(const String & key_type);
 
 struct RedisConfiguration
 {
@@ -34,10 +49,13 @@ struct RedisConfiguration
     uint32_t db_index;
     String password;
     RedisStorageType storage_type;
+    /// column name of redis key
+    String key;// TODO remove
     uint32_t pool_size;
 };
 
 using RedisArray = Poco::Redis::Array;
+using RedisArrayPtr = std::shared_ptr<RedisArray>;
 using RedisCommand = Poco::Redis::Command;
 using RedisBulkString = Poco::Redis::BulkString;
 
@@ -56,6 +74,10 @@ struct RedisConnection
 
 using RedisConnectionPtr = std::unique_ptr<RedisConnection>;
 
-RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguration & configuration) ;
+RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguration & configuration);
+
+///get all redis hash key array
+///    eg: keys -> [key1, key2] and get [[key1, field1, field2], [key2, field1, field2]]
+RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisArray & keys);
 
 }
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 055617b6a96..45ebe0696d6 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -2,6 +2,7 @@
 #include <Storages/StorageFactory.h>
 #include <Storages/NamedCollectionsHelpers.h>
 #include <Storages/checkAndGetLiteralArgument.h>
+#include <Storages/KVStorageUtils.h>
 
 #include <unordered_set>
 #include <Core/Settings.h>
@@ -11,6 +12,7 @@
 #include <Parsers/ASTLiteral.h>
 #include <Processors/Sinks/SinkToStorage.h>
 #include <QueryPipeline/Pipe.h>
+#include <Common/logger_useful.h>
 #include <Common/NamedCollections/NamedCollections.h>
 #include <Common/parseAddress.h>
 #include <Common/Exception.h>
@@ -22,9 +24,33 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
+    extern const int INVALID_REDIS_STORAGE_TYPE;
     extern const int NOT_IMPLEMENTED;
 }
 
+namespace
+{
+    RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column)
+    {
+        String redis_col_key = all_columns.at(0);
+        if (column == redis_col_key)
+            return RedisColumnType::KEY;
+
+        if (storage_type == RedisStorageType::HASH_MAP)
+        {
+            String redis_col_field = all_columns.at(1);
+            if (column == redis_col_field)
+                return RedisColumnType::FIELD;
+            else
+                return RedisColumnType::VALUE;
+        }
+        else
+        {
+            return RedisColumnType::VALUE;
+        }
+    }
+}
+
 StorageRedis::StorageRedis(
     const StorageID & table_id_,
     const RedisConfiguration & configuration_,
@@ -34,41 +60,120 @@ StorageRedis::StorageRedis(
     : IStorage(table_id_)
     , table_id(table_id_)
     , configuration(configuration_)
-    , columns(columns_)
-    , constraints(constraints_)
-    , comment(comment_)
+    , log(&Poco::Logger::get("StorageRedis"))
 {
     pool = std::make_shared<RedisPool>(configuration.pool_size);
+    StorageInMemoryMetadata storage_metadata;
+    storage_metadata.setColumns(columns_);
+    storage_metadata.setConstraints(constraints_);
+    storage_metadata.setComment(comment_);
+    setInMemoryMetadata(storage_metadata);
 }
 
 Pipe StorageRedis::read(
     const Names & column_names,
     const StorageSnapshotPtr & storage_snapshot,
-    SelectQueryInfo & /*query_info*/,
-    ContextPtr /*context*/,
+    SelectQueryInfo & query_info,
+    ContextPtr context,
     QueryProcessingStage::Enum /*processed_stage*/,
     size_t max_block_size,
-    size_t /*num_streams*/)
+    size_t num_streams)
 {
+    LOG_INFO(log, "num_streams {}", num_streams);// TODO delete
     auto connection = getRedisConnection(pool, configuration);
 
     storage_snapshot->check(column_names);
 
     Block sample_block;
+    RedisColumnTypes redis_types;
+    auto all_columns = storage_snapshot->metadata->getColumns().getNamesOfPhysical();
+
     for (const String & column_name : column_names)
     {
         auto column_data = storage_snapshot->metadata->getColumns().getPhysical(column_name);
         sample_block.insert({column_data.type, column_data.name});
+        redis_types.push_back(getRedisColumnType(configuration.storage_type, all_columns, column_name));
+        LOG_INFO(log, "Request column: {}, Redis type: {}", column_data.name, *redis_types.crbegin()); // TODO delete
     }
 
-    RedisArray keys;
-    RedisCommand command_for_keys("KEYS");
-    /// generate keys by table name prefix
-    command_for_keys << table_id.getTableName() + ":" + toString(configuration.storage_type) + ":*";
+    FieldVectorPtr fields;
+    bool all_scan = false;
 
-    /// Get only keys for specified storage type.
-    auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
-    return Pipe(std::make_shared<RedisSource>(std::move(connection), all_keys, configuration.storage_type, sample_block, max_block_size));
+    String primary_key = all_columns.at(0);
+    auto primary_key_data_type = sample_block.getByName(primary_key).type;
+
+    std::tie(fields, all_scan) = getFilterKeys(primary_key, primary_key_data_type, query_info, context);
+
+    /// TODO hash_map hgetall
+    if (all_scan)
+    {
+        RedisCommand command_for_keys("KEYS");
+        /// generate keys by table name prefix
+        command_for_keys << table_id.getTableName() + ":" + toString(configuration.storage_type) + ":*";
+
+        auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
+
+        if (all_keys.size() == 0)
+            return {};
+
+        Pipes pipes;
+
+        size_t num_keys = all_keys.size();
+        size_t num_threads = std::min<size_t>(num_streams, all_keys.size());
+
+        assert(num_keys <= std::numeric_limits<uint32_t>::max());
+
+        for (size_t thread_idx = 0; thread_idx < num_threads; ++thread_idx)
+        {
+            size_t begin = num_keys * thread_idx / num_threads;
+            size_t end = num_keys * (thread_idx + 1) / num_threads;
+
+            RedisArray keys;
+            for (size_t pos=begin; pos<std::min(end, num_keys); pos++)
+                keys.add(all_keys.get<RedisBulkString>(pos));
+
+            if (configuration.storage_type == RedisStorageType::HASH_MAP)
+            {
+                keys = *getRedisHashMapKeys(connection, keys);
+            }
+
+            /// TODO reduce keys copy
+            pipes.emplace_back(std::make_shared<RedisSource>(
+                std::move(connection), keys, configuration.storage_type, sample_block, redis_types, max_block_size));
+        }
+        return Pipe::unitePipes(std::move(pipes));
+    }
+    else
+    {
+        if (fields->empty())
+            return {};
+
+        Pipes pipes;
+
+        size_t num_keys = fields->size();
+        size_t num_threads = std::min<size_t>(num_streams, fields->size());
+
+        assert(num_keys <= std::numeric_limits<uint32_t>::max());
+
+        for (size_t thread_idx = 0; thread_idx < num_threads; ++thread_idx)
+        {
+            size_t begin = num_keys * thread_idx / num_threads;
+            size_t end = num_keys * (thread_idx + 1) / num_threads;
+
+            RedisArray keys;
+            for (size_t pos=begin; pos<std::min(end, num_keys); pos++)
+                keys.add(fields->at(pos).get<String>());
+
+            if (configuration.storage_type == RedisStorageType::HASH_MAP)
+            {
+                keys = *getRedisHashMapKeys(connection, keys);
+            }
+
+            pipes.emplace_back(std::make_shared<RedisSource>(
+                std::move(connection), keys, configuration.storage_type, sample_block, redis_types, max_block_size));
+        }
+        return Pipe::unitePipes(std::move(pipes));
+    }
 }
 
 
@@ -88,15 +193,15 @@ RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr c
     {
         validateNamedCollection(
             *named_collection,
-            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "storage_type"},
+            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "storage_type", "pool_size"},
             {});
 
         configuration.host = named_collection->getAny<String>({"host", "hostname"});
         configuration.port = static_cast<uint32_t>(named_collection->get<UInt64>("port"));
         configuration.password = named_collection->get<String>("password");
         configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>({"db_index"}));
-        configuration.storage_type = toRedisStorageType(named_collection->getOrDefault<String>("storage_type", ""));
-        configuration.pool_size = 16; /// TODO
+        configuration.storage_type = keyTypeToStorageType(named_collection->getOrDefault<String>("storage_type", ""));
+        configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
     }
     else
     {
@@ -110,10 +215,13 @@ RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr c
         configuration.port = parsed_host_port.second;
         configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
         configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
-        configuration.storage_type = toRedisStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
-        configuration.pool_size = 16; /// TODO
+        configuration.storage_type = keyTypeToStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+        configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
     }
 
+    if (configuration.storage_type == RedisStorageType::UNKNOWN)
+        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type");
+
     context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
     return configuration;
 }
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 60db75dd384..1bffc6a64bf 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -7,8 +7,12 @@
 namespace DB
 {
 /* Implements storage in the Redis.
- * Use ENGINE = Redis(host:port, db_index, password, storage_type);
+ * Use ENGINE = Redis(host:port, db_index, password, storage_type, conn_pool_size);
  * Read only.
+ *
+ * Note If storage_type is
+ *      simple: there should be 2 columns and the first one is key in Redis, the second one is value.
+ *      hash_map: there should be 3 columns and the first one is key in Redis and the second is the field of Redis Map.
  */
 class StorageRedis : public IStorage
 {
@@ -42,10 +46,7 @@ private:
     StorageID table_id;
     RedisConfiguration configuration;
 
-    ColumnsDescription columns;
-    ConstraintsDescription constraints;
-
-    String comment;
+    Poco::Logger * log;
     RedisPoolPtr pool;
 };
 
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index db612806652..e410ad799a6 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -49,10 +49,10 @@ ColumnsDescription TableFunctionRedis::getActualTableStructure(ContextPtr contex
             structure = "key String, value String";
             break;
         case RedisStorageType::HASH_MAP:
-            structure = "key String, field, String, value String";
+            structure = "key String, field String, value String";
             break;
         case RedisStorageType::UNKNOWN:
-            throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "invalid redis storage type.");
+            throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type.");
     }
     return parseColumnsListFromString(structure, context);
 }
@@ -65,12 +65,12 @@ void TableFunctionRedis::parseArguments(const ASTPtr & ast_function, ContextPtr
 
     ASTs & args = func_args.arguments->children;
 
-    if (args.size() != 4)
+    if (args.size() != 5)
     {
         throw Exception(
             ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
-            "Table function 'Redis' requires from 4 parameters: "
-            "redis('host:port', db_index, 'password', 'storage_type')");
+            "Table function 'Redis' requires from 5 parameters: "
+            "redis('host:port', db_index, 'password', 'storage_type', 'pool_size')");
     }
     configuration = StorageRedis::getConfiguration(args, context);
 }

From 23d6c835d831b2fa9650c693370219ee1d1f9727 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Tue, 23 May 2023 16:42:46 +0800
Subject: [PATCH 166/722] fix poco redis array NPE

---
 src/Storages/RedisCommon.cpp  | 22 ++++++++++++++++++++++
 src/Storages/RedisCommon.h    |  7 ++++++-
 src/Storages/StorageRedis.cpp | 35 ++---------------------------------
 src/Storages/StorageRedis.h   |  4 ++--
 4 files changed, 32 insertions(+), 36 deletions(-)

diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index b910759fe52..0a13e40b1ec 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -109,6 +109,8 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
         command_for_secondary_keys.addRedisType(key);
 
         auto secondary_keys = connection->client->execute<RedisArray>(command_for_secondary_keys);
+        if (secondary_keys.isNull())
+            continue;
 
         RedisArray primary_with_secondary;
         primary_with_secondary.addRedisType(key);
@@ -131,4 +133,24 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
     return hkeys;
 }
 
+RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column)
+{
+    String redis_col_key = all_columns.at(0);
+    if (column == redis_col_key)
+        return RedisColumnType::KEY;
+
+    if (storage_type == RedisStorageType::HASH_MAP)
+    {
+        String redis_col_field = all_columns.at(1);
+        if (column == redis_col_field)
+            return RedisColumnType::FIELD;
+        else
+            return RedisColumnType::VALUE;
+    }
+    else
+    {
+        return RedisColumnType::VALUE;
+    }
+}
+
 }
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 590ea1476c4..384a02d76e4 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -6,6 +6,7 @@
 
 #include <Core/Defines.h>
 #include <base/BorrowedObjectPool.h>
+#include <Core/Names.h>
 
 namespace DB
 {
@@ -28,7 +29,7 @@ enum class RedisColumnType
 {
     /// Redis key
     KEY,
-    /// Redis map field
+    /// Redis hash field
     FIELD,
     /// Redis value
     VALUE
@@ -80,4 +81,8 @@ RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguratio
 ///    eg: keys -> [key1, key2] and get [[key1, field1, field2], [key2, field1, field2]]
 RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisArray & keys);
 
+/// Get RedisColumnType of a column, If storage_type is
+///     SIMPLE: all_columns must have 2 iterm and the first one is Redis key the second one is value
+///     HASH_MAP: all_columns must have 2 iterm and the first one is Redis key the second is field, the third is value.
+RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column);
 }
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 45ebe0696d6..0e1b3a24e4f 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -5,15 +5,11 @@
 #include <Storages/KVStorageUtils.h>
 
 #include <unordered_set>
-#include <Core/Settings.h>
-#include <IO/Operators.h>
-#include <Interpreters/Context.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Parsers/ASTLiteral.h>
 #include <Processors/Sinks/SinkToStorage.h>
 #include <QueryPipeline/Pipe.h>
 #include <Common/logger_useful.h>
-#include <Common/NamedCollections/NamedCollections.h>
 #include <Common/parseAddress.h>
 #include <Common/Exception.h>
 #include <IO/WriteHelpers.h>
@@ -28,29 +24,6 @@ namespace ErrorCodes
     extern const int NOT_IMPLEMENTED;
 }
 
-namespace
-{
-    RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column)
-    {
-        String redis_col_key = all_columns.at(0);
-        if (column == redis_col_key)
-            return RedisColumnType::KEY;
-
-        if (storage_type == RedisStorageType::HASH_MAP)
-        {
-            String redis_col_field = all_columns.at(1);
-            if (column == redis_col_field)
-                return RedisColumnType::FIELD;
-            else
-                return RedisColumnType::VALUE;
-        }
-        else
-        {
-            return RedisColumnType::VALUE;
-        }
-    }
-}
-
 StorageRedis::StorageRedis(
     const StorageID & table_id_,
     const RedisConfiguration & configuration_,
@@ -79,9 +52,7 @@ Pipe StorageRedis::read(
     size_t max_block_size,
     size_t num_streams)
 {
-    LOG_INFO(log, "num_streams {}", num_streams);// TODO delete
     auto connection = getRedisConnection(pool, configuration);
-
     storage_snapshot->check(column_names);
 
     Block sample_block;
@@ -93,7 +64,6 @@ Pipe StorageRedis::read(
         auto column_data = storage_snapshot->metadata->getColumns().getPhysical(column_name);
         sample_block.insert({column_data.type, column_data.name});
         redis_types.push_back(getRedisColumnType(configuration.storage_type, all_columns, column_name));
-        LOG_INFO(log, "Request column: {}, Redis type: {}", column_data.name, *redis_types.crbegin()); // TODO delete
     }
 
     FieldVectorPtr fields;
@@ -104,16 +74,15 @@ Pipe StorageRedis::read(
 
     std::tie(fields, all_scan) = getFilterKeys(primary_key, primary_key_data_type, query_info, context);
 
-    /// TODO hash_map hgetall
     if (all_scan)
     {
         RedisCommand command_for_keys("KEYS");
         /// generate keys by table name prefix
-        command_for_keys << table_id.getTableName() + ":" + toString(configuration.storage_type) + ":*";
+        command_for_keys << table_id.getTableName() + ":" + storageTypeToKeyType(configuration.storage_type) + ":*";
 
         auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
 
-        if (all_keys.size() == 0)
+        if (all_keys.isNull() || all_keys.size() == 0)
             return {};
 
         Pipes pipes;
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 1bffc6a64bf..2c6c6193982 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -11,8 +11,8 @@ namespace DB
  * Read only.
  *
  * Note If storage_type is
- *      simple: there should be 2 columns and the first one is key in Redis, the second one is value.
- *      hash_map: there should be 3 columns and the first one is key in Redis and the second is the field of Redis Map.
+ *      SIMPLE: there should be 2 columns and the first one is key in Redis, the second one is value.
+ *      HASH_MAP: there should be 3 columns and the first one is key in Redis and the second is the field of Redis Map.
  */
 class StorageRedis : public IStorage
 {

From ce203b5ce6cb2329a7a26bcb4999e040ecbdbf7d Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Tue, 23 May 2023 20:54:26 +0800
Subject: [PATCH 167/722] Check redis table structure

---
 src/Common/ErrorCodes.cpp                 |  1 +
 src/Dictionaries/RedisSource.cpp          |  5 +----
 src/Dictionaries/RedisSource.h            |  1 -
 src/Storages/RedisCommon.cpp              | 13 +++++++++++++
 src/Storages/RedisCommon.h                |  7 +++++--
 src/Storages/StorageRedis.cpp             | 20 ++++++++++++++++----
 src/TableFunctions/TableFunctionRedis.cpp |  6 ++++--
 7 files changed, 40 insertions(+), 13 deletions(-)

diff --git a/src/Common/ErrorCodes.cpp b/src/Common/ErrorCodes.cpp
index 505cf0aac8f..4c08d762df2 100644
--- a/src/Common/ErrorCodes.cpp
+++ b/src/Common/ErrorCodes.cpp
@@ -581,6 +581,7 @@
     M(696, ASYNC_LOAD_CANCELED) \
     M(697, CANNOT_RESTORE_TO_NONENCRYPTED_DISK) \
     M(698, INVALID_REDIS_STORAGE_TYPE) \
+    M(699, INVALID_REDIS_TABLE_STRUCTURE) \
     \
     M(999, KEEPER_EXCEPTION) \
     M(1000, POCO_EXCEPTION) \
diff --git a/src/Dictionaries/RedisSource.cpp b/src/Dictionaries/RedisSource.cpp
index 20e0838886c..27125077c10 100644
--- a/src/Dictionaries/RedisSource.cpp
+++ b/src/Dictionaries/RedisSource.cpp
@@ -1,15 +1,12 @@
 #include "RedisSource.h"
 
-#include <string>
 #include <vector>
-
 #include <Columns/ColumnNullable.h>
 #include <Columns/ColumnString.h>
 #include <Columns/ColumnsNumber.h>
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
-
-#include "DictionaryStructure.h"
+#include <IO/ReadBufferFromString.h>
 
 
 namespace DB
diff --git a/src/Dictionaries/RedisSource.h b/src/Dictionaries/RedisSource.h
index fe5a973d57c..e8e78db67bc 100644
--- a/src/Dictionaries/RedisSource.h
+++ b/src/Dictionaries/RedisSource.h
@@ -7,7 +7,6 @@
 #include <Poco/Redis/Array.h>
 #include <Poco/Redis/Type.h>
 #include <Storages/RedisCommon.h>
-#include "RedisDictionarySource.h"
 
 
 namespace DB
diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 0a13e40b1ec..916ac3b69bc 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -7,6 +7,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int INVALID_REDIS_STORAGE_TYPE;
+    extern const int INVALID_REDIS_TABLE_STRUCTURE;
     extern const int INTERNAL_REDIS_ERROR;
     extern const int TIMEOUT_EXCEEDED;
 }
@@ -153,4 +154,16 @@ RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names &
     }
 }
 
+void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration)
+{
+    /// TODO check data type
+    if (configuration.storage_type == RedisStorageType::HASH_MAP && columns.size() != 3)
+        throw Exception(ErrorCodes::INVALID_REDIS_TABLE_STRUCTURE,
+                        "Redis hash table must have 3 columns, but found {}", columns.size());
+
+    if (configuration.storage_type == RedisStorageType::SIMPLE && columns.size() != 2)
+        throw Exception(ErrorCodes::INVALID_REDIS_TABLE_STRUCTURE,
+                        "Redis string table must have 2 columns, but found {}", columns.size());
+}
+
 }
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 384a02d76e4..e663faa5fab 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -7,6 +7,7 @@
 #include <Core/Defines.h>
 #include <base/BorrowedObjectPool.h>
 #include <Core/Names.h>
+#include <Storages/ColumnsDescription.h>
 
 namespace DB
 {
@@ -50,8 +51,6 @@ struct RedisConfiguration
     uint32_t db_index;
     String password;
     RedisStorageType storage_type;
-    /// column name of redis key
-    String key;// TODO remove
     uint32_t pool_size;
 };
 
@@ -85,4 +84,8 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
 ///     SIMPLE: all_columns must have 2 iterm and the first one is Redis key the second one is value
 ///     HASH_MAP: all_columns must have 2 iterm and the first one is Redis key the second is field, the third is value.
 RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column);
+
+/// checking Redis table/table-function when creating
+void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration);
+
 }
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 0e1b3a24e4f..7721665e9dd 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -78,7 +78,8 @@ Pipe StorageRedis::read(
     {
         RedisCommand command_for_keys("KEYS");
         /// generate keys by table name prefix
-        command_for_keys << table_id.getTableName() + ":" + storageTypeToKeyType(configuration.storage_type) + ":*";
+//        command_for_keys << table_id.getTableName() + ":" + storageTypeToKeyType(configuration.storage_type) + ":*";
+        command_for_keys << "*";
 
         auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
 
@@ -90,6 +91,7 @@ Pipe StorageRedis::read(
         size_t num_keys = all_keys.size();
         size_t num_threads = std::min<size_t>(num_streams, all_keys.size());
 
+        num_threads = std::min<size_t>(num_threads, configuration.pool_size);
         assert(num_keys <= std::numeric_limits<uint32_t>::max());
 
         for (size_t thread_idx = 0; thread_idx < num_threads; ++thread_idx)
@@ -106,9 +108,12 @@ Pipe StorageRedis::read(
                 keys = *getRedisHashMapKeys(connection, keys);
             }
 
+            delete connection.release();
+
             /// TODO reduce keys copy
             pipes.emplace_back(std::make_shared<RedisSource>(
-                std::move(connection), keys, configuration.storage_type, sample_block, redis_types, max_block_size));
+                getRedisConnection(pool, configuration), keys,
+                configuration.storage_type, sample_block, redis_types, max_block_size));
         }
         return Pipe::unitePipes(std::move(pipes));
     }
@@ -122,6 +127,7 @@ Pipe StorageRedis::read(
         size_t num_keys = fields->size();
         size_t num_threads = std::min<size_t>(num_streams, fields->size());
 
+        num_threads = std::min<size_t>(num_threads, configuration.pool_size);
         assert(num_keys <= std::numeric_limits<uint32_t>::max());
 
         for (size_t thread_idx = 0; thread_idx < num_threads; ++thread_idx)
@@ -138,8 +144,11 @@ Pipe StorageRedis::read(
                 keys = *getRedisHashMapKeys(connection, keys);
             }
 
+            delete connection.release();
+
             pipes.emplace_back(std::make_shared<RedisSource>(
-                std::move(connection), keys, configuration.storage_type, sample_block, redis_types, max_block_size));
+                getRedisConnection(pool, configuration), keys,
+                configuration.storage_type, sample_block, redis_types, max_block_size));
         }
         return Pipe::unitePipes(std::move(pipes));
     }
@@ -151,9 +160,10 @@ SinkToStoragePtr StorageRedis::write(
     const StorageMetadataPtr & /*metadata_snapshot*/,
     ContextPtr /*context*/)
 {
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Method write is unsupported for StorageRedis");
+    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Write is unsupported for StorageRedis");
 }
 
+/// TODO make "password", "db_index", "storage_type", "pool_size" optional
 RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr context)
 {
     RedisConfiguration configuration;
@@ -203,6 +213,8 @@ void registerStorageRedis(StorageFactory & factory)
         {
             auto configuration = StorageRedis::getConfiguration(args.engine_args, args.getLocalContext());
 
+            checkRedisTableStructure(args.columns, configuration);
+
             return std::make_shared<StorageRedis>(
                 args.table_id,
                 configuration,
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index e410ad799a6..9e4a39b1b85 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -1,7 +1,6 @@
 #include <TableFunctions/TableFunctionRedis.h>
 
 #include <Common/Exception.h>
-#include <IO/WriteBuffer.h>
 
 #include <Interpreters/Context.h>
 
@@ -29,8 +28,10 @@ StoragePtr TableFunctionRedis::executeImpl(
     const ASTPtr & /*ast_function*/, ContextPtr context, const String & table_name, ColumnsDescription /*cached_columns*/) const
 {
     auto columns = getActualTableStructure(context);
+    checkRedisTableStructure(columns, *configuration);
+
     auto storage = std::make_shared<StorageRedis>(
-        StorageID(toString(configuration->db_index), table_name), // TODO
+        StorageID(toString(configuration->db_index), table_name),
         *configuration,
         columns,
         ConstraintsDescription(),
@@ -39,6 +40,7 @@ StoragePtr TableFunctionRedis::executeImpl(
     return storage;
 }
 
+/// TODO support user customized table structure
 ColumnsDescription TableFunctionRedis::getActualTableStructure(ContextPtr context) const
 {
     /// generate table structure by storage type.

From 40cc8d210792cd7a3e7f80f9ed9bf95fe938e9d8 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 24 May 2023 10:34:37 +0800
Subject: [PATCH 168/722] fix code style

---
 src/Dictionaries/RedisDictionarySource.cpp | 2 --
 src/Storages/RedisCommon.cpp               | 1 -
 src/Storages/RedisCommon.h                 | 5 -----
 src/Storages/StorageRedis.cpp              | 1 -
 4 files changed, 9 deletions(-)

diff --git a/src/Dictionaries/RedisDictionarySource.cpp b/src/Dictionaries/RedisDictionarySource.cpp
index f96c9231827..1056383bc84 100644
--- a/src/Dictionaries/RedisDictionarySource.cpp
+++ b/src/Dictionaries/RedisDictionarySource.cpp
@@ -17,9 +17,7 @@ namespace DB
     {
         extern const int UNSUPPORTED_METHOD;
         extern const int INVALID_CONFIG_PARAMETER;
-        extern const int INTERNAL_REDIS_ERROR;
         extern const int LOGICAL_ERROR;
-        extern const int TIMEOUT_EXCEEDED;
     }
 
     static RedisStorageType parseStorageType(const String & storage_type_str)
diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 916ac3b69bc..63a8d911bf0 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -6,7 +6,6 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int INVALID_REDIS_STORAGE_TYPE;
     extern const int INVALID_REDIS_TABLE_STRUCTURE;
     extern const int INTERNAL_REDIS_ERROR;
     extern const int TIMEOUT_EXCEEDED;
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index e663faa5fab..2668311125f 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -11,11 +11,6 @@
 
 namespace DB
 {
-namespace ErrorCodes
-{
-    extern const int NOT_IMPLEMENTED;
-}
-
 static constexpr size_t REDIS_MAX_BLOCK_SIZE = DEFAULT_BLOCK_SIZE;
 static constexpr size_t REDIS_LOCK_ACQUIRE_TIMEOUT_MS = 5000;
 
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 7721665e9dd..3d7721bdc0e 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -19,7 +19,6 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
     extern const int INVALID_REDIS_STORAGE_TYPE;
     extern const int NOT_IMPLEMENTED;
 }

From 70cfd7a222342bfd1d9a3ddb59eaa2391d014d28 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 24 May 2023 10:45:21 +0800
Subject: [PATCH 169/722] fix typos

---
 src/Storages/RedisCommon.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 2668311125f..348c2494632 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -76,8 +76,8 @@ RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguratio
 RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisArray & keys);
 
 /// Get RedisColumnType of a column, If storage_type is
-///     SIMPLE: all_columns must have 2 iterm and the first one is Redis key the second one is value
-///     HASH_MAP: all_columns must have 2 iterm and the first one is Redis key the second is field, the third is value.
+///     SIMPLE: all_columns must have 2 items and the first one is Redis key the second one is value
+///     HASH_MAP: all_columns must have 2 items and the first one is Redis key the second is field, the third is value.
 RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column);
 
 /// checking Redis table/table-function when creating

From d594bb1c7a3d6f0fe2ef4e27bb01e132ed82a8e7 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 24 May 2023 10:53:42 +0800
Subject: [PATCH 170/722] fix fast tests

---
 src/Access/Common/AccessType.h                                  | 2 +-
 tests/queries/0_stateless/01271_show_privileges.reference       | 2 +-
 .../0_stateless/02117_show_create_table_system.reference        | 2 +-
 .../02414_all_new_table_functions_must_be_documented.reference  | 1 +
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/Access/Common/AccessType.h b/src/Access/Common/AccessType.h
index 78c341cdcb5..c9cce610f2c 100644
--- a/src/Access/Common/AccessType.h
+++ b/src/Access/Common/AccessType.h
@@ -201,7 +201,7 @@ enum class AccessType
     M(URL, "", GLOBAL, SOURCES) \
     M(REMOTE, "", GLOBAL, SOURCES) \
     M(MONGO, "", GLOBAL, SOURCES) \
-    M(Redis, "", GLOBAL, SOURCES) \
+    M(REDIS, "", GLOBAL, SOURCES) \
     M(MEILISEARCH, "", GLOBAL, SOURCES) \
     M(MYSQL, "", GLOBAL, SOURCES) \
     M(POSTGRES, "", GLOBAL, SOURCES) \
diff --git a/tests/queries/0_stateless/01271_show_privileges.reference b/tests/queries/0_stateless/01271_show_privileges.reference
index ec245d8b9e0..5ada21e31f4 100644
--- a/tests/queries/0_stateless/01271_show_privileges.reference
+++ b/tests/queries/0_stateless/01271_show_privileges.reference
@@ -148,7 +148,7 @@ INTROSPECTION	['INTROSPECTION FUNCTIONS']	\N	ALL
 FILE	[]	GLOBAL	SOURCES
 URL	[]	GLOBAL	SOURCES
 REMOTE	[]	GLOBAL	SOURCES
-MONGO	[]	GLOBAL	SOURCES
+REDIS	[]	GLOBAL	SOURCES
 MEILISEARCH	[]	GLOBAL	SOURCES
 MYSQL	[]	GLOBAL	SOURCES
 POSTGRES	[]	GLOBAL	SOURCES
diff --git a/tests/queries/0_stateless/02117_show_create_table_system.reference b/tests/queries/0_stateless/02117_show_create_table_system.reference
index 09cc62dac00..724118f7bc1 100644
--- a/tests/queries/0_stateless/02117_show_create_table_system.reference
+++ b/tests/queries/0_stateless/02117_show_create_table_system.reference
@@ -297,7 +297,7 @@ CREATE TABLE system.grants
 (
     `user_name` Nullable(String),
     `role_name` Nullable(String),
-    `access_type` Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'MEILISEARCH' = 151, 'MYSQL' = 152, 'POSTGRES' = 153, 'SQLITE' = 154, 'ODBC' = 155, 'JDBC' = 156, 'HDFS' = 157, 'S3' = 158, 'HIVE' = 159, 'SOURCES' = 160, 'CLUSTER' = 161, 'ALL' = 162, 'NONE' = 163),
+    `access_type` Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'Redis' = 151, 'MEILISEARCH' = 152, 'MYSQL' = 153, 'POSTGRES' = 154, 'SQLITE' = 155, 'ODBC' = 156, 'JDBC' = 157, 'HDFS' = 158, 'S3' = 159, 'HIVE' = 160, 'SOURCES' = 161, 'CLUSTER' = 162, 'ALL' = 163, 'NONE' = 164),
     `database` Nullable(String),
     `table` Nullable(String),
     `column` Nullable(String),
diff --git a/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference b/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference
index 2277e19cf25..4f16e57d606 100644
--- a/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference
+++ b/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference
@@ -9,6 +9,7 @@ jdbc
 meilisearch
 merge
 mongodb
+redis
 null
 numbers
 numbers_mt

From b35867d907d39b790c9f8b3feb709cb9e76a6434 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 24 May 2023 18:06:42 +0800
Subject: [PATCH 171/722] unify storage type

---
 src/Dictionaries/RedisDictionarySource.cpp    |  10 -
 src/Dictionaries/RedisDictionarySource.h      |  10 -
 src/Storages/RedisCommon.cpp                  |  19 +-
 src/Storages/RedisCommon.h                    |   5 +-
 src/Storages/StorageRedis.cpp                 |   8 +-
 .../test_storage_redis/__init__.py            |   0
 .../configs/named_collections.xml             |  12 +
 .../configs_secure/config.d/ssl_conf.xml      |   8 +
 tests/integration/test_storage_redis/test.py  | 426 ++++++++++++++++++
 9 files changed, 464 insertions(+), 34 deletions(-)
 create mode 100644 tests/integration/test_storage_redis/__init__.py
 create mode 100644 tests/integration/test_storage_redis/configs/named_collections.xml
 create mode 100644 tests/integration/test_storage_redis/configs_secure/config.d/ssl_conf.xml
 create mode 100644 tests/integration/test_storage_redis/test.py

diff --git a/src/Dictionaries/RedisDictionarySource.cpp b/src/Dictionaries/RedisDictionarySource.cpp
index 1056383bc84..d28b7528d23 100644
--- a/src/Dictionaries/RedisDictionarySource.cpp
+++ b/src/Dictionaries/RedisDictionarySource.cpp
@@ -20,16 +20,6 @@ namespace DB
         extern const int LOGICAL_ERROR;
     }
 
-    static RedisStorageType parseStorageType(const String & storage_type_str)
-    {
-        if (storage_type_str == "hash_map")
-            return RedisStorageType::HASH_MAP;
-        else if (!storage_type_str.empty() && storage_type_str != "simple")
-            throw Exception(ErrorCodes::INVALID_CONFIG_PARAMETER, "Unknown storage type {} for Redis dictionary", storage_type_str);
-
-        return RedisStorageType::SIMPLE;
-    }
-
     void registerDictionarySourceRedis(DictionarySourceFactory & factory)
     {
         auto create_table_source = [=](const DictionaryStructure & dict_struct,
diff --git a/src/Dictionaries/RedisDictionarySource.h b/src/Dictionaries/RedisDictionarySource.h
index c7786284dc4..a55f220321d 100644
--- a/src/Dictionaries/RedisDictionarySource.h
+++ b/src/Dictionaries/RedisDictionarySource.h
@@ -7,16 +7,6 @@
 #include "IDictionarySource.h"
 #include <Storages/RedisCommon.h>
 
-namespace Poco
-{
-    namespace Redis
-    {
-        class Client;
-        class Array;
-        class Command;
-    }
-}
-
 namespace DB
 {
     namespace ErrorCodes
diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 63a8d911bf0..8cc94c45dae 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -9,6 +9,7 @@ namespace ErrorCodes
     extern const int INVALID_REDIS_TABLE_STRUCTURE;
     extern const int INTERNAL_REDIS_ERROR;
     extern const int TIMEOUT_EXCEEDED;
+    extern const int INVALID_REDIS_STORAGE_TYPE;
 }
 
 RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES = {RedisColumnType::KEY, RedisColumnType::FIELD, RedisColumnType::VALUE};
@@ -24,27 +25,27 @@ RedisConnection::~RedisConnection()
     pool->returnObject(std::move(client));
 }
 
-String storageTypeToKeyType(RedisStorageType storage_type)
+String serializeStorageType(RedisStorageType storage_type)
 {
     switch (storage_type)
     {
         case RedisStorageType::SIMPLE:
-            return "string";
+            return "simple";
         case RedisStorageType::HASH_MAP:
-            return "hash";
+            return "hash_map";
         default:
             return "none";
     }
 }
 
-RedisStorageType keyTypeToStorageType(const String & key_type)
+RedisStorageType parseStorageType(const String & storage_type_str)
 {
-    if (key_type == "string")
-        return RedisStorageType::SIMPLE;
-    else if (key_type == "hash")
+    if (storage_type_str == "hash_map")
         return RedisStorageType::HASH_MAP;
-    else
-        return RedisStorageType::UNKNOWN;
+    else if (!storage_type_str.empty() && storage_type_str != "simple")
+        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Unknown storage type {} for Redis dictionary", storage_type_str);
+
+    return RedisStorageType::SIMPLE;
 }
 
 RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguration & configuration)
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 348c2494632..02d0b435b9d 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -36,8 +36,11 @@ using RedisColumnTypes = std::vector<RedisColumnType>;
 extern RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES;
 extern RedisColumnTypes REDIS_SIMPLE_COLUMN_TYPES;
 
+/// storage type to Redis key type
 String storageTypeToKeyType(RedisStorageType storage_type);
-RedisStorageType keyTypeToStorageType(const String & key_type);
+
+RedisStorageType parseStorageType(const String & storage_type_str);
+String serializeStorageType(RedisStorageType storage_type);
 
 struct RedisConfiguration
 {
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 3d7721bdc0e..819ab01d733 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -77,7 +77,7 @@ Pipe StorageRedis::read(
     {
         RedisCommand command_for_keys("KEYS");
         /// generate keys by table name prefix
-//        command_for_keys << table_id.getTableName() + ":" + storageTypeToKeyType(configuration.storage_type) + ":*";
+//        command_for_keys << table_id.getTableName() + ":" + serializeStorageType(configuration.storage_type) + ":*";
         command_for_keys << "*";
 
         auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
@@ -178,7 +178,7 @@ RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr c
         configuration.port = static_cast<uint32_t>(named_collection->get<UInt64>("port"));
         configuration.password = named_collection->get<String>("password");
         configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>({"db_index"}));
-        configuration.storage_type = keyTypeToStorageType(named_collection->getOrDefault<String>("storage_type", ""));
+        configuration.storage_type = parseStorageType(named_collection->getOrDefault<String>("storage_type", ""));
         configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
     }
     else
@@ -193,7 +193,7 @@ RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr c
         configuration.port = parsed_host_port.second;
         configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
         configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
-        configuration.storage_type = keyTypeToStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+        configuration.storage_type = parseStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
         configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
     }
 
@@ -222,7 +222,7 @@ void registerStorageRedis(StorageFactory & factory)
                 args.comment);
         },
         {
-            .source_access_type = AccessType::Redis,
+            .source_access_type = AccessType::REDIS,
         });
 }
 
diff --git a/tests/integration/test_storage_redis/__init__.py b/tests/integration/test_storage_redis/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/integration/test_storage_redis/configs/named_collections.xml b/tests/integration/test_storage_redis/configs/named_collections.xml
new file mode 100644
index 00000000000..5f7db390982
--- /dev/null
+++ b/tests/integration/test_storage_redis/configs/named_collections.xml
@@ -0,0 +1,12 @@
+<clickhouse>
+    <named_collections>
+        <mongo1>
+            <user>root</user>
+            <password>clickhouse</password>
+            <host>mongo1</host>
+            <port>27017</port>
+            <database>test</database>
+            <collection>simple_table</collection>
+        </mongo1>
+    </named_collections>
+</clickhouse>
diff --git a/tests/integration/test_storage_redis/configs_secure/config.d/ssl_conf.xml b/tests/integration/test_storage_redis/configs_secure/config.d/ssl_conf.xml
new file mode 100644
index 00000000000..3efe98e7045
--- /dev/null
+++ b/tests/integration/test_storage_redis/configs_secure/config.d/ssl_conf.xml
@@ -0,0 +1,8 @@
+<clickhouse>
+    <openSSL>
+        <client>
+            <!-- For self-signed certificate -->
+            <verificationMode>none</verificationMode>
+        </client>
+    </openSSL>
+</clickhouse>
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
new file mode 100644
index 00000000000..6ba5520704d
--- /dev/null
+++ b/tests/integration/test_storage_redis/test.py
@@ -0,0 +1,426 @@
+import pymongo
+
+import pytest
+from helpers.client import QueryRuntimeException
+
+from helpers.cluster import ClickHouseCluster
+import datetime
+
+
+@pytest.fixture(scope="module")
+def started_cluster(request):
+    try:
+        cluster = ClickHouseCluster(__file__)
+        node = cluster.add_instance(
+            "node",
+            main_configs=[
+                "configs_secure/config.d/ssl_conf.xml",
+                "configs/named_collections.xml",
+            ],
+            with_mongo=True,
+            with_mongo_secure=request.param,
+        )
+        cluster.start()
+        yield cluster
+    finally:
+        cluster.shutdown()
+
+
+def get_mongo_connection(started_cluster, secure=False, with_credentials=True):
+    connection_str = ""
+    if with_credentials:
+        connection_str = "mongodb://root:clickhouse@localhost:{}".format(
+            started_cluster.mongo_port
+        )
+    else:
+        connection_str = "mongodb://localhost:{}".format(
+            started_cluster.mongo_no_cred_port
+        )
+    if secure:
+        connection_str += "/?tls=true&tlsAllowInvalidCertificates=true"
+    return pymongo.MongoClient(connection_str)
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_simple_select(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse')"
+    )
+
+    assert node.query("SELECT COUNT() FROM simple_mongo_table") == "100\n"
+    assert (
+        node.query("SELECT sum(key) FROM simple_mongo_table")
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query("SELECT data from simple_mongo_table where key = 42")
+        == hex(42 * 42) + "\n"
+    )
+    node.query("DROP TABLE simple_mongo_table")
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_arrays(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    arrays_mongo_table = db["arrays_table"]
+    data = []
+    for i in range(0, 100):
+        data.append(
+            {
+                "key": i,
+                "arr_int64": [-(i + 1), -(i + 2), -(i + 3)],
+                "arr_int32": [-(i + 1), -(i + 2), -(i + 3)],
+                "arr_int16": [-(i + 1), -(i + 2), -(i + 3)],
+                "arr_int8": [-(i + 1), -(i + 2), -(i + 3)],
+                "arr_uint64": [i + 1, i + 2, i + 3],
+                "arr_uint32": [i + 1, i + 2, i + 3],
+                "arr_uint16": [i + 1, i + 2, i + 3],
+                "arr_uint8": [i + 1, i + 2, i + 3],
+                "arr_float32": [i + 1.125, i + 2.5, i + 3.750],
+                "arr_float64": [i + 1.125, i + 2.5, i + 3.750],
+                "arr_date": [
+                    datetime.datetime(2002, 10, 27),
+                    datetime.datetime(2024, 1, 8),
+                ],
+                "arr_datetime": [
+                    datetime.datetime(2023, 3, 31, 6, 3, 12),
+                    datetime.datetime(1999, 2, 28, 12, 46, 34),
+                ],
+                "arr_string": [str(i + 1), str(i + 2), str(i + 3)],
+                "arr_uuid": [
+                    "f0e77736-91d1-48ce-8f01-15123ca1c7ed",
+                    "93376a07-c044-4281-a76e-ad27cf6973c5",
+                ],
+                "arr_arr_bool": [
+                    [True, False, True],
+                    [True],
+                    [],
+                    None,
+                    [False],
+                    [None],
+                ],
+                "arr_empty": [],
+                "arr_null": None,
+                "arr_nullable": None,
+            }
+        )
+
+    arrays_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "CREATE TABLE arrays_mongo_table("
+        "key UInt64,"
+        "arr_int64 Array(Int64),"
+        "arr_int32 Array(Int32),"
+        "arr_int16 Array(Int16),"
+        "arr_int8 Array(Int8),"
+        "arr_uint64 Array(UInt64),"
+        "arr_uint32 Array(UInt32),"
+        "arr_uint16 Array(UInt16),"
+        "arr_uint8 Array(UInt8),"
+        "arr_float32 Array(Float32),"
+        "arr_float64 Array(Float64),"
+        "arr_date Array(Date),"
+        "arr_datetime Array(DateTime),"
+        "arr_string Array(String),"
+        "arr_uuid Array(UUID),"
+        "arr_arr_bool Array(Array(Bool)),"
+        "arr_empty Array(UInt64),"
+        "arr_null Array(UInt64),"
+        "arr_arr_null Array(Array(UInt64)),"
+        "arr_nullable Array(Nullable(UInt64))"
+        ") ENGINE = MongoDB('mongo1:27017', 'test', 'arrays_table', 'root', 'clickhouse')"
+    )
+
+    assert node.query("SELECT COUNT() FROM arrays_mongo_table") == "100\n"
+
+    for column_name in ["arr_int64", "arr_int32", "arr_int16", "arr_int8"]:
+        assert (
+            node.query(f"SELECT {column_name} FROM arrays_mongo_table WHERE key = 42")
+            == "[-43,-44,-45]\n"
+        )
+
+    for column_name in ["arr_uint64", "arr_uint32", "arr_uint16", "arr_uint8"]:
+        assert (
+            node.query(f"SELECT {column_name} FROM arrays_mongo_table WHERE key = 42")
+            == "[43,44,45]\n"
+        )
+
+    for column_name in ["arr_float32", "arr_float64"]:
+        assert (
+            node.query(f"SELECT {column_name} FROM arrays_mongo_table WHERE key = 42")
+            == "[43.125,44.5,45.75]\n"
+        )
+
+    assert (
+        node.query(f"SELECT arr_date FROM arrays_mongo_table WHERE key = 42")
+        == "['2002-10-27','2024-01-08']\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_datetime FROM arrays_mongo_table WHERE key = 42")
+        == "['2023-03-31 06:03:12','1999-02-28 12:46:34']\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_string FROM arrays_mongo_table WHERE key = 42")
+        == "['43','44','45']\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_uuid FROM arrays_mongo_table WHERE key = 42")
+        == "['f0e77736-91d1-48ce-8f01-15123ca1c7ed','93376a07-c044-4281-a76e-ad27cf6973c5']\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_arr_bool FROM arrays_mongo_table WHERE key = 42")
+        == "[[true,false,true],[true],[],[],[false],[false]]\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_empty FROM arrays_mongo_table WHERE key = 42") == "[]\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_null FROM arrays_mongo_table WHERE key = 42") == "[]\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_arr_null FROM arrays_mongo_table WHERE key = 42")
+        == "[]\n"
+    )
+
+    assert (
+        node.query(f"SELECT arr_nullable FROM arrays_mongo_table WHERE key = 42")
+        == "[]\n"
+    )
+
+    node.query("DROP TABLE arrays_mongo_table")
+    arrays_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_complex_data_type(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    incomplete_mongo_table = db["complex_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i), "dict": {"a": i, "b": str(i)}})
+    incomplete_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "CREATE TABLE incomplete_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse')"
+    )
+
+    assert node.query("SELECT COUNT() FROM incomplete_mongo_table") == "100\n"
+    assert (
+        node.query("SELECT sum(key) FROM incomplete_mongo_table")
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query("SELECT data from incomplete_mongo_table where key = 42")
+        == hex(42 * 42) + "\n"
+    )
+    node.query("DROP TABLE incomplete_mongo_table")
+    incomplete_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_incorrect_data_type(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    strange_mongo_table = db["strange_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i), "aaaa": "Hello"})
+    strange_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "CREATE TABLE strange_mongo_table(key String, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'strange_table', 'root', 'clickhouse')"
+    )
+
+    with pytest.raises(QueryRuntimeException):
+        node.query("SELECT COUNT() FROM strange_mongo_table")
+
+    with pytest.raises(QueryRuntimeException):
+        node.query("SELECT uniq(key) FROM strange_mongo_table")
+
+    node.query(
+        "CREATE TABLE strange_mongo_table2(key UInt64, data String, bbbb String) ENGINE = MongoDB('mongo1:27017', 'test', 'strange_table', 'root', 'clickhouse')"
+    )
+
+    node.query("DROP TABLE strange_mongo_table")
+    node.query("DROP TABLE strange_mongo_table2")
+    strange_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [True], indirect=["started_cluster"])
+def test_secure_connection(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster, secure=True)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', 'ssl=true')"
+    )
+
+    assert node.query("SELECT COUNT() FROM simple_mongo_table") == "100\n"
+    assert (
+        node.query("SELECT sum(key) FROM simple_mongo_table")
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query("SELECT data from simple_mongo_table where key = 42")
+        == hex(42 * 42) + "\n"
+    )
+    node.query("DROP TABLE simple_mongo_table")
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_predefined_connection_configuration(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query("drop table if exists simple_mongo_table")
+    node.query(
+        "create table simple_mongo_table(key UInt64, data String) engine = MongoDB(mongo1)"
+    )
+    assert node.query("SELECT count() FROM simple_mongo_table") == "100\n"
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_no_credentials(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
+    db = mongo_connection["test"]
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "create table simple_mongo_table_2(key UInt64, data String) engine = MongoDB('mongo2:27017', 'test', 'simple_table', '', '')"
+    )
+    assert node.query("SELECT count() FROM simple_mongo_table_2") == "100\n"
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_auth_source(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
+    admin_db = mongo_connection["admin"]
+    admin_db.add_user(
+        "root",
+        "clickhouse",
+        roles=[{"role": "userAdminAnyDatabase", "db": "admin"}, "readWriteAnyDatabase"],
+    )
+    simple_mongo_table = admin_db["simple_table"]
+    data = []
+    for i in range(0, 50):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+    db = mongo_connection["test"]
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query(
+        "create table simple_mongo_table_fail(key UInt64, data String) engine = MongoDB('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse')"
+    )
+    node.query_and_get_error("SELECT count() FROM simple_mongo_table_fail")
+    node.query(
+        "create table simple_mongo_table_ok(key UInt64, data String) engine = MongoDB('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse', 'authSource=admin')"
+    )
+    assert node.query("SELECT count() FROM simple_mongo_table_ok") == "100\n"
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_missing_columns(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 10):
+        data.append({"key": i, "data": hex(i * i)})
+    for i in range(0, 10):
+        data.append({"key": i})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    node.query("drop table if exists simple_mongo_table")
+    node.query(
+        "create table simple_mongo_table(key UInt64, data Nullable(String)) engine = MongoDB(mongo1)"
+    )
+    result = node.query("SELECT count() FROM simple_mongo_table WHERE isNull(data)")
+    assert result == "10\n"
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_simple_insert_select(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+
+    node = started_cluster.instances["node"]
+    node.query("DROP TABLE IF EXISTS simple_mongo_table")
+    node.query(
+        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse')"
+    )
+    node.query("INSERT INTO simple_mongo_table SELECT 1, 'kek'")
+
+    assert (
+        node.query("SELECT data from simple_mongo_table where key = 1").strip() == "kek"
+    )
+    node.query("INSERT INTO simple_mongo_table(key) SELECT 12")
+    assert int(node.query("SELECT count() from simple_mongo_table")) == 2
+    assert (
+        node.query("SELECT data from simple_mongo_table where key = 12").strip() == ""
+    )
+
+    node.query("DROP TABLE simple_mongo_table")
+    simple_mongo_table.drop()

From 412d9ba259cb91243d28765326d65384a60e18cc Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 25 May 2023 12:33:07 +0800
Subject: [PATCH 172/722] add tests for redis storage

---
 src/Storages/RedisCommon.cpp                  |  15 +
 src/Storages/RedisCommon.h                    |   2 +-
 .../configs/named_collections.xml             |  12 -
 tests/integration/test_storage_redis/test.py  | 443 ++----------------
 .../test_table_function_redis/__init__.py     |   0
 .../configs_secure/config.d/ssl_conf.xml      |   0
 .../test_table_function_redis/test.py         | 276 +++++++++++
 7 files changed, 329 insertions(+), 419 deletions(-)
 delete mode 100644 tests/integration/test_storage_redis/configs/named_collections.xml
 create mode 100644 tests/integration/test_table_function_redis/__init__.py
 rename tests/integration/{test_storage_redis => test_table_function_redis}/configs_secure/config.d/ssl_conf.xml (100%)
 create mode 100644 tests/integration/test_table_function_redis/test.py

diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 8cc94c45dae..fc789057019 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -25,6 +25,21 @@ RedisConnection::~RedisConnection()
     pool->returnObject(std::move(client));
 }
 
+String storageTypeToKeyType(RedisStorageType type)
+{
+    switch (type)
+    {
+        case RedisStorageType::SIMPLE:
+            return "string";
+        case RedisStorageType::HASH_MAP:
+            return "hash";
+        default:
+            return "none";
+    }
+
+    UNREACHABLE();
+}
+
 String serializeStorageType(RedisStorageType storage_type)
 {
     switch (storage_type)
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 02d0b435b9d..d68f2567248 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -37,7 +37,7 @@ extern RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES;
 extern RedisColumnTypes REDIS_SIMPLE_COLUMN_TYPES;
 
 /// storage type to Redis key type
-String storageTypeToKeyType(RedisStorageType storage_type);
+String storageTypeToKeyType(RedisStorageType type);
 
 RedisStorageType parseStorageType(const String & storage_type_str);
 String serializeStorageType(RedisStorageType storage_type);
diff --git a/tests/integration/test_storage_redis/configs/named_collections.xml b/tests/integration/test_storage_redis/configs/named_collections.xml
deleted file mode 100644
index 5f7db390982..00000000000
--- a/tests/integration/test_storage_redis/configs/named_collections.xml
+++ /dev/null
@@ -1,12 +0,0 @@
-<clickhouse>
-    <named_collections>
-        <mongo1>
-            <user>root</user>
-            <password>clickhouse</password>
-            <host>mongo1</host>
-            <port>27017</port>
-            <database>test</database>
-            <collection>simple_table</collection>
-        </mongo1>
-    </named_collections>
-</clickhouse>
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index 6ba5520704d..4220563c229 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -1,426 +1,57 @@
-import pymongo
-
+import redis
 import pytest
-from helpers.client import QueryRuntimeException
-
 from helpers.cluster import ClickHouseCluster
-import datetime
+
+cluster = ClickHouseCluster(__file__)
+
+node = cluster.add_instance("node", with_redis=True)
 
 
 @pytest.fixture(scope="module")
-def started_cluster(request):
+def started_cluster():
     try:
-        cluster = ClickHouseCluster(__file__)
-        node = cluster.add_instance(
-            "node",
-            main_configs=[
-                "configs_secure/config.d/ssl_conf.xml",
-                "configs/named_collections.xml",
-            ],
-            with_mongo=True,
-            with_mongo_secure=request.param,
-        )
         cluster.start()
         yield cluster
     finally:
         cluster.shutdown()
 
 
-def get_mongo_connection(started_cluster, secure=False, with_credentials=True):
-    connection_str = ""
-    if with_credentials:
-        connection_str = "mongodb://root:clickhouse@localhost:{}".format(
-            started_cluster.mongo_port
-        )
-    else:
-        connection_str = "mongodb://localhost:{}".format(
-            started_cluster.mongo_no_cred_port
-        )
-    if secure:
-        connection_str += "/?tls=true&tlsAllowInvalidCertificates=true"
-    return pymongo.MongoClient(connection_str)
+def get_redis_connection(db_id=0):
+    client = redis.Redis(
+        host=node.name, port=started_cluster.redis_port, password="clickhouse", db=db_id
+    )
+    return client
 
 
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_simple_select(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
+def get_address():
+    return node.name + started_cluster.redis_port
 
-    node = started_cluster.instances["node"]
+
+@pytest.mark.parametrize("started_cluster")
+def test_storage_simple_select(started_cluster):
+    client = get_redis_connection()
+    address = get_address()
+
+    data = {}
+    for i in range(100):
+        data['key{}'.format(i)] = 'value{}'.format(i)
+
+    client.mset(data)
+
+    # create table
     node.query(
-        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse')"
+        f"""
+        CREATE TABLE test_storage_simple_select(
+            k String, 
+            v String
+        ) Engine=Redis('{address}', 0, '','simple', 10)
+        """
     )
 
-    assert node.query("SELECT COUNT() FROM simple_mongo_table") == "100\n"
-    assert (
-        node.query("SELECT sum(key) FROM simple_mongo_table")
-        == str(sum(range(0, 100))) + "\n"
-    )
+    select_query = "SELECT k, v from test_storage_simple_select where k='0' FORMAT Values"
+    assert (node.query(select_query) == "('0','0')")
 
-    assert (
-        node.query("SELECT data from simple_mongo_table where key = 42")
-        == hex(42 * 42) + "\n"
-    )
-    node.query("DROP TABLE simple_mongo_table")
-    simple_mongo_table.drop()
+    select_query = "SELECT * from test_storage_simple_select FORMAT Values"
+    assert (len(node.query(select_query)) == 100)
+    assert (node.query(select_query)[0] == "('0','0')")
 
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_arrays(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    arrays_mongo_table = db["arrays_table"]
-    data = []
-    for i in range(0, 100):
-        data.append(
-            {
-                "key": i,
-                "arr_int64": [-(i + 1), -(i + 2), -(i + 3)],
-                "arr_int32": [-(i + 1), -(i + 2), -(i + 3)],
-                "arr_int16": [-(i + 1), -(i + 2), -(i + 3)],
-                "arr_int8": [-(i + 1), -(i + 2), -(i + 3)],
-                "arr_uint64": [i + 1, i + 2, i + 3],
-                "arr_uint32": [i + 1, i + 2, i + 3],
-                "arr_uint16": [i + 1, i + 2, i + 3],
-                "arr_uint8": [i + 1, i + 2, i + 3],
-                "arr_float32": [i + 1.125, i + 2.5, i + 3.750],
-                "arr_float64": [i + 1.125, i + 2.5, i + 3.750],
-                "arr_date": [
-                    datetime.datetime(2002, 10, 27),
-                    datetime.datetime(2024, 1, 8),
-                ],
-                "arr_datetime": [
-                    datetime.datetime(2023, 3, 31, 6, 3, 12),
-                    datetime.datetime(1999, 2, 28, 12, 46, 34),
-                ],
-                "arr_string": [str(i + 1), str(i + 2), str(i + 3)],
-                "arr_uuid": [
-                    "f0e77736-91d1-48ce-8f01-15123ca1c7ed",
-                    "93376a07-c044-4281-a76e-ad27cf6973c5",
-                ],
-                "arr_arr_bool": [
-                    [True, False, True],
-                    [True],
-                    [],
-                    None,
-                    [False],
-                    [None],
-                ],
-                "arr_empty": [],
-                "arr_null": None,
-                "arr_nullable": None,
-            }
-        )
-
-    arrays_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query(
-        "CREATE TABLE arrays_mongo_table("
-        "key UInt64,"
-        "arr_int64 Array(Int64),"
-        "arr_int32 Array(Int32),"
-        "arr_int16 Array(Int16),"
-        "arr_int8 Array(Int8),"
-        "arr_uint64 Array(UInt64),"
-        "arr_uint32 Array(UInt32),"
-        "arr_uint16 Array(UInt16),"
-        "arr_uint8 Array(UInt8),"
-        "arr_float32 Array(Float32),"
-        "arr_float64 Array(Float64),"
-        "arr_date Array(Date),"
-        "arr_datetime Array(DateTime),"
-        "arr_string Array(String),"
-        "arr_uuid Array(UUID),"
-        "arr_arr_bool Array(Array(Bool)),"
-        "arr_empty Array(UInt64),"
-        "arr_null Array(UInt64),"
-        "arr_arr_null Array(Array(UInt64)),"
-        "arr_nullable Array(Nullable(UInt64))"
-        ") ENGINE = MongoDB('mongo1:27017', 'test', 'arrays_table', 'root', 'clickhouse')"
-    )
-
-    assert node.query("SELECT COUNT() FROM arrays_mongo_table") == "100\n"
-
-    for column_name in ["arr_int64", "arr_int32", "arr_int16", "arr_int8"]:
-        assert (
-            node.query(f"SELECT {column_name} FROM arrays_mongo_table WHERE key = 42")
-            == "[-43,-44,-45]\n"
-        )
-
-    for column_name in ["arr_uint64", "arr_uint32", "arr_uint16", "arr_uint8"]:
-        assert (
-            node.query(f"SELECT {column_name} FROM arrays_mongo_table WHERE key = 42")
-            == "[43,44,45]\n"
-        )
-
-    for column_name in ["arr_float32", "arr_float64"]:
-        assert (
-            node.query(f"SELECT {column_name} FROM arrays_mongo_table WHERE key = 42")
-            == "[43.125,44.5,45.75]\n"
-        )
-
-    assert (
-        node.query(f"SELECT arr_date FROM arrays_mongo_table WHERE key = 42")
-        == "['2002-10-27','2024-01-08']\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_datetime FROM arrays_mongo_table WHERE key = 42")
-        == "['2023-03-31 06:03:12','1999-02-28 12:46:34']\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_string FROM arrays_mongo_table WHERE key = 42")
-        == "['43','44','45']\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_uuid FROM arrays_mongo_table WHERE key = 42")
-        == "['f0e77736-91d1-48ce-8f01-15123ca1c7ed','93376a07-c044-4281-a76e-ad27cf6973c5']\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_arr_bool FROM arrays_mongo_table WHERE key = 42")
-        == "[[true,false,true],[true],[],[],[false],[false]]\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_empty FROM arrays_mongo_table WHERE key = 42") == "[]\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_null FROM arrays_mongo_table WHERE key = 42") == "[]\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_arr_null FROM arrays_mongo_table WHERE key = 42")
-        == "[]\n"
-    )
-
-    assert (
-        node.query(f"SELECT arr_nullable FROM arrays_mongo_table WHERE key = 42")
-        == "[]\n"
-    )
-
-    node.query("DROP TABLE arrays_mongo_table")
-    arrays_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_complex_data_type(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    incomplete_mongo_table = db["complex_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i), "dict": {"a": i, "b": str(i)}})
-    incomplete_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query(
-        "CREATE TABLE incomplete_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse')"
-    )
-
-    assert node.query("SELECT COUNT() FROM incomplete_mongo_table") == "100\n"
-    assert (
-        node.query("SELECT sum(key) FROM incomplete_mongo_table")
-        == str(sum(range(0, 100))) + "\n"
-    )
-
-    assert (
-        node.query("SELECT data from incomplete_mongo_table where key = 42")
-        == hex(42 * 42) + "\n"
-    )
-    node.query("DROP TABLE incomplete_mongo_table")
-    incomplete_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_incorrect_data_type(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    strange_mongo_table = db["strange_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i), "aaaa": "Hello"})
-    strange_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query(
-        "CREATE TABLE strange_mongo_table(key String, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'strange_table', 'root', 'clickhouse')"
-    )
-
-    with pytest.raises(QueryRuntimeException):
-        node.query("SELECT COUNT() FROM strange_mongo_table")
-
-    with pytest.raises(QueryRuntimeException):
-        node.query("SELECT uniq(key) FROM strange_mongo_table")
-
-    node.query(
-        "CREATE TABLE strange_mongo_table2(key UInt64, data String, bbbb String) ENGINE = MongoDB('mongo1:27017', 'test', 'strange_table', 'root', 'clickhouse')"
-    )
-
-    node.query("DROP TABLE strange_mongo_table")
-    node.query("DROP TABLE strange_mongo_table2")
-    strange_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [True], indirect=["started_cluster"])
-def test_secure_connection(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster, secure=True)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query(
-        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', 'ssl=true')"
-    )
-
-    assert node.query("SELECT COUNT() FROM simple_mongo_table") == "100\n"
-    assert (
-        node.query("SELECT sum(key) FROM simple_mongo_table")
-        == str(sum(range(0, 100))) + "\n"
-    )
-
-    assert (
-        node.query("SELECT data from simple_mongo_table where key = 42")
-        == hex(42 * 42) + "\n"
-    )
-    node.query("DROP TABLE simple_mongo_table")
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_predefined_connection_configuration(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query("drop table if exists simple_mongo_table")
-    node.query(
-        "create table simple_mongo_table(key UInt64, data String) engine = MongoDB(mongo1)"
-    )
-    assert node.query("SELECT count() FROM simple_mongo_table") == "100\n"
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_no_credentials(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
-    db = mongo_connection["test"]
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query(
-        "create table simple_mongo_table_2(key UInt64, data String) engine = MongoDB('mongo2:27017', 'test', 'simple_table', '', '')"
-    )
-    assert node.query("SELECT count() FROM simple_mongo_table_2") == "100\n"
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_auth_source(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
-    admin_db = mongo_connection["admin"]
-    admin_db.add_user(
-        "root",
-        "clickhouse",
-        roles=[{"role": "userAdminAnyDatabase", "db": "admin"}, "readWriteAnyDatabase"],
-    )
-    simple_mongo_table = admin_db["simple_table"]
-    data = []
-    for i in range(0, 50):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-    db = mongo_connection["test"]
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query(
-        "create table simple_mongo_table_fail(key UInt64, data String) engine = MongoDB('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse')"
-    )
-    node.query_and_get_error("SELECT count() FROM simple_mongo_table_fail")
-    node.query(
-        "create table simple_mongo_table_ok(key UInt64, data String) engine = MongoDB('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse', 'authSource=admin')"
-    )
-    assert node.query("SELECT count() FROM simple_mongo_table_ok") == "100\n"
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_missing_columns(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 10):
-        data.append({"key": i, "data": hex(i * i)})
-    for i in range(0, 10):
-        data.append({"key": i})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    node.query("drop table if exists simple_mongo_table")
-    node.query(
-        "create table simple_mongo_table(key UInt64, data Nullable(String)) engine = MongoDB(mongo1)"
-    )
-    result = node.query("SELECT count() FROM simple_mongo_table WHERE isNull(data)")
-    assert result == "10\n"
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_simple_insert_select(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-
-    node = started_cluster.instances["node"]
-    node.query("DROP TABLE IF EXISTS simple_mongo_table")
-    node.query(
-        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse')"
-    )
-    node.query("INSERT INTO simple_mongo_table SELECT 1, 'kek'")
-
-    assert (
-        node.query("SELECT data from simple_mongo_table where key = 1").strip() == "kek"
-    )
-    node.query("INSERT INTO simple_mongo_table(key) SELECT 12")
-    assert int(node.query("SELECT count() from simple_mongo_table")) == 2
-    assert (
-        node.query("SELECT data from simple_mongo_table where key = 12").strip() == ""
-    )
-
-    node.query("DROP TABLE simple_mongo_table")
-    simple_mongo_table.drop()
diff --git a/tests/integration/test_table_function_redis/__init__.py b/tests/integration/test_table_function_redis/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/integration/test_storage_redis/configs_secure/config.d/ssl_conf.xml b/tests/integration/test_table_function_redis/configs_secure/config.d/ssl_conf.xml
similarity index 100%
rename from tests/integration/test_storage_redis/configs_secure/config.d/ssl_conf.xml
rename to tests/integration/test_table_function_redis/configs_secure/config.d/ssl_conf.xml
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
new file mode 100644
index 00000000000..e0ad71b0079
--- /dev/null
+++ b/tests/integration/test_table_function_redis/test.py
@@ -0,0 +1,276 @@
+import pymongo
+
+import pytest
+from helpers.client import QueryRuntimeException
+
+from helpers.cluster import ClickHouseCluster
+
+
+@pytest.fixture(scope="module")
+def started_cluster(request):
+    try:
+        cluster = ClickHouseCluster(__file__)
+        node = cluster.add_instance(
+            "node",
+            with_mongo=True,
+            main_configs=[
+                "configs_secure/config.d/ssl_conf.xml",
+            ],
+            with_mongo_secure=request.param,
+        )
+        cluster.start()
+        yield cluster
+    finally:
+        cluster.shutdown()
+
+
+def get_mongo_connection(started_cluster, secure=False, with_credentials=True):
+    connection_str = ""
+    if with_credentials:
+        connection_str = "mongodb://root:clickhouse@localhost:{}".format(
+            started_cluster.mongo_port
+        )
+    else:
+        connection_str = "mongodb://localhost:{}".format(
+            started_cluster.mongo_no_cred_port
+        )
+    if secure:
+        connection_str += "/?tls=true&tlsAllowInvalidCertificates=true"
+    return pymongo.MongoClient(connection_str)
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_simple_select(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+
+    node = started_cluster.instances["node"]
+    for i in range(0, 100):
+        node.query(
+            "INSERT INTO FUNCTION mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String') (key, data) VALUES ({}, '{}')".format(
+                i, hex(i * i)
+            )
+        )
+    assert (
+        node.query(
+            "SELECT COUNT() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
+        )
+        == "100\n"
+    )
+    assert (
+        node.query(
+            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
+        )
+        == str(sum(range(0, 100))) + "\n"
+    )
+    assert (
+        node.query(
+            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', 'key UInt64, data String')"
+        )
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query(
+            "SELECT data from mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String') where key = 42"
+        )
+        == hex(42 * 42) + "\n"
+    )
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_complex_data_type(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    incomplete_mongo_table = db["complex_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i), "dict": {"a": i, "b": str(i)}})
+    incomplete_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+
+    assert (
+        node.query(
+            "SELECT COUNT() FROM mongodb('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse', structure='key UInt64, data String, dict Map(UInt64, String)')"
+        )
+        == "100\n"
+    )
+    assert (
+        node.query(
+            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse', structure='key UInt64, data String, dict Map(UInt64, String)')"
+        )
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query(
+            "SELECT data from mongodb('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse', structure='key UInt64, data String, dict Map(UInt64, String)') where key = 42"
+        )
+        == hex(42 * 42) + "\n"
+    )
+    incomplete_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_incorrect_data_type(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    strange_mongo_table = db["strange_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i), "aaaa": "Hello"})
+    strange_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+
+    with pytest.raises(QueryRuntimeException):
+        node.query(
+            "SELECT aaaa FROM mongodb('mongo1:27017', 'test', 'strange_table', 'root', 'clickhouse', structure='key UInt64, data String')"
+        )
+
+    strange_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [True], indirect=["started_cluster"])
+def test_secure_connection(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster, secure=True)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+
+    assert (
+        node.query(
+            "SELECT COUNT() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='ssl=true')"
+        )
+        == "100\n"
+    )
+    assert (
+        node.query(
+            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='ssl=true')"
+        )
+        == str(sum(range(0, 100))) + "\n"
+    )
+    assert (
+        node.query(
+            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', 'key UInt64, data String', 'ssl=true')"
+        )
+        == str(sum(range(0, 100))) + "\n"
+    )
+
+    assert (
+        node.query(
+            "SELECT data from mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='ssl=true') where key = 42"
+        )
+        == hex(42 * 42) + "\n"
+    )
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_predefined_connection_configuration(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    assert (
+        node.query(
+            "SELECT count() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
+        )
+        == "100\n"
+    )
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_no_credentials(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
+    db = mongo_connection["test"]
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    assert (
+        node.query(
+            "SELECT count() FROM mongodb('mongo2:27017', 'test', 'simple_table', '', '', structure='key UInt64, data String')"
+        )
+        == "100\n"
+    )
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_auth_source(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
+    admin_db = mongo_connection["admin"]
+    admin_db.add_user(
+        "root",
+        "clickhouse",
+        roles=[{"role": "userAdminAnyDatabase", "db": "admin"}, "readWriteAnyDatabase"],
+    )
+    simple_mongo_table = admin_db["simple_table"]
+    data = []
+    for i in range(0, 50):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+    db = mongo_connection["test"]
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 100):
+        data.append({"key": i, "data": hex(i * i)})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+
+    node.query_and_get_error(
+        "SELECT count() FROM mongodb('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
+    )
+
+    assert (
+        node.query(
+            "SELECT count() FROM mongodb('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='authSource=admin')"
+        )
+        == "100\n"
+    )
+    simple_mongo_table.drop()
+
+
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
+def test_missing_columns(started_cluster):
+    mongo_connection = get_mongo_connection(started_cluster)
+    db = mongo_connection["test"]
+    db.add_user("root", "clickhouse")
+    simple_mongo_table = db["simple_table"]
+    data = []
+    for i in range(0, 10):
+        data.append({"key": i, "data": hex(i * i)})
+    for i in range(0, 10):
+        data.append({"key": i})
+    simple_mongo_table.insert_many(data)
+
+    node = started_cluster.instances["node"]
+    result = node.query(
+        "SELECT count() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data Nullable(String)') WHERE isNull(data)"
+    )
+    assert result == "10\n"
+    simple_mongo_table.drop()

From 3281aec3357777845f3899d159c2282f07715073 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 25 May 2023 17:12:56 +0800
Subject: [PATCH 173/722] make some redis engine args optional

---
 src/Storages/StorageRedis.cpp | 30 +++++++++++++++++++++---------
 src/Storages/StorageRedis.h   |  2 +-
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 819ab01d733..0cc0e566d5c 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -166,6 +166,10 @@ SinkToStoragePtr StorageRedis::write(
 RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr context)
 {
     RedisConfiguration configuration;
+    configuration.db_index = 0;
+    configuration.password = "";
+    configuration.storage_type = RedisStorageType::SIMPLE;
+    configuration.pool_size = 10;
 
     if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
     {
@@ -175,11 +179,15 @@ RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr c
             {});
 
         configuration.host = named_collection->getAny<String>({"host", "hostname"});
-        configuration.port = static_cast<uint32_t>(named_collection->get<UInt64>("port"));
-        configuration.password = named_collection->get<String>("password");
-        configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>({"db_index"}));
-        configuration.storage_type = parseStorageType(named_collection->getOrDefault<String>("storage_type", ""));
-        configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
+        configuration.port = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("port", 6379));
+        if (engine_args.size() > 1)
+            configuration.password = named_collection->get<String>("password");
+        if (engine_args.size() > 2)
+            configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>("db_index"));
+        if (engine_args.size() > 3)
+            configuration.storage_type = parseStorageType(named_collection->get<String>("storage_type"));
+        if (engine_args.size() > 4)
+            configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
     }
     else
     {
@@ -191,10 +199,14 @@ RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr c
 
         configuration.host = parsed_host_port.first;
         configuration.port = parsed_host_port.second;
-        configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
-        configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
-        configuration.storage_type = parseStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
-        configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
+        if (engine_args.size() > 1)
+            configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
+        if (engine_args.size() > 2)
+            configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
+        if (engine_args.size() > 3)
+            configuration.storage_type = parseStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+        if (engine_args.size() > 4)
+            configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
     }
 
     if (configuration.storage_type == RedisStorageType::UNKNOWN)
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 2c6c6193982..1ae90b2d1ba 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -7,7 +7,7 @@
 namespace DB
 {
 /* Implements storage in the Redis.
- * Use ENGINE = Redis(host:port, db_index, password, storage_type, conn_pool_size);
+ * Use ENGINE = Redis(host:port, db_index, password, storage_type, pool_size);
  * Read only.
  *
  * Note If storage_type is

From 3c2b44747299b7b87d7e1e1c4219409ade1d7c34 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 25 May 2023 17:29:22 +0800
Subject: [PATCH 174/722] move get configuration to RedisCommon

---
 src/Storages/RedisCommon.cpp              | 57 ++++++++++++++++++++++-
 src/Storages/RedisCommon.h                |  3 ++
 src/Storages/StorageRedis.cpp             | 54 ---------------------
 src/Storages/StorageRedis.h               |  2 -
 src/TableFunctions/TableFunctionRedis.cpp |  2 +-
 5 files changed, 59 insertions(+), 59 deletions(-)

diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index fc789057019..0d33b9c7aa3 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -151,13 +151,13 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
 
 RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column)
 {
-    String redis_col_key = all_columns.at(0);
+    const String & redis_col_key = all_columns.at(0);
     if (column == redis_col_key)
         return RedisColumnType::KEY;
 
     if (storage_type == RedisStorageType::HASH_MAP)
     {
-        String redis_col_field = all_columns.at(1);
+        const String & redis_col_field = all_columns.at(1);
         if (column == redis_col_field)
             return RedisColumnType::FIELD;
         else
@@ -169,6 +169,59 @@ RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names &
     }
 }
 
+RedisConfiguration getRedisConfiguration(const ASTs & engine_args, ContextPtr context)
+{
+    RedisConfiguration configuration;
+    configuration.db_index = 0;
+    configuration.password = "";
+    configuration.storage_type = RedisStorageType::SIMPLE;
+    configuration.pool_size = 10;
+
+    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
+    {
+        validateNamedCollection(
+            *named_collection,
+            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "storage_type", "pool_size"},
+            {});
+
+        configuration.host = named_collection->getAny<String>({"host", "hostname"});
+        configuration.port = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("port", 6379));
+        if (engine_args.size() > 1)
+            configuration.password = named_collection->get<String>("password");
+        if (engine_args.size() > 2)
+            configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>("db_index"));
+        if (engine_args.size() > 3)
+            configuration.storage_type = parseStorageType(named_collection->get<String>("storage_type"));
+        if (engine_args.size() > 4)
+            configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
+    }
+    else
+    {
+        for (auto & engine_arg : engine_args)
+            engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, context);
+
+        /// 6379 is the default Redis port.
+        auto parsed_host_port = parseAddress(checkAndGetLiteralArgument<String>(engine_args[0], "host:port"), 6379);
+
+        configuration.host = parsed_host_port.first;
+        configuration.port = parsed_host_port.second;
+        if (engine_args.size() > 1)
+            configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
+        if (engine_args.size() > 2)
+            configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
+        if (engine_args.size() > 3)
+            configuration.storage_type = parseStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
+        if (engine_args.size() > 4)
+            configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
+    }
+
+    if (configuration.storage_type == RedisStorageType::UNKNOWN)
+        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type");
+
+    context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
+    return configuration;
+}
+
 void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration)
 {
     /// TODO check data type
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index d68f2567248..30e771d2471 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -83,6 +83,9 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
 ///     HASH_MAP: all_columns must have 2 items and the first one is Redis key the second is field, the third is value.
 RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column);
 
+/// parse redis table engine/function configuration from engine_args
+RedisConfiguration getRedisConfiguration(const ASTs & engine_args, ContextPtr context);
+
 /// checking Redis table/table-function when creating
 void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration);
 
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 0cc0e566d5c..5010aada8c4 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -162,60 +162,6 @@ SinkToStoragePtr StorageRedis::write(
     throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Write is unsupported for StorageRedis");
 }
 
-/// TODO make "password", "db_index", "storage_type", "pool_size" optional
-RedisConfiguration StorageRedis::getConfiguration(ASTs engine_args, ContextPtr context)
-{
-    RedisConfiguration configuration;
-    configuration.db_index = 0;
-    configuration.password = "";
-    configuration.storage_type = RedisStorageType::SIMPLE;
-    configuration.pool_size = 10;
-
-    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
-    {
-        validateNamedCollection(
-            *named_collection,
-            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "storage_type", "pool_size"},
-            {});
-
-        configuration.host = named_collection->getAny<String>({"host", "hostname"});
-        configuration.port = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("port", 6379));
-        if (engine_args.size() > 1)
-            configuration.password = named_collection->get<String>("password");
-        if (engine_args.size() > 2)
-            configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>("db_index"));
-        if (engine_args.size() > 3)
-            configuration.storage_type = parseStorageType(named_collection->get<String>("storage_type"));
-        if (engine_args.size() > 4)
-            configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
-    }
-    else
-    {
-        for (auto & engine_arg : engine_args)
-            engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, context);
-
-        /// 6379 is the default Redis port.
-        auto parsed_host_port = parseAddress(checkAndGetLiteralArgument<String>(engine_args[0], "host:port"), 6379);
-
-        configuration.host = parsed_host_port.first;
-        configuration.port = parsed_host_port.second;
-        if (engine_args.size() > 1)
-            configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
-        if (engine_args.size() > 2)
-            configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
-        if (engine_args.size() > 3)
-            configuration.storage_type = parseStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
-        if (engine_args.size() > 4)
-            configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
-    }
-
-    if (configuration.storage_type == RedisStorageType::UNKNOWN)
-        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type");
-
-    context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
-    return configuration;
-}
-
 void registerStorageRedis(StorageFactory & factory)
 {
     factory.registerStorage(
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 1ae90b2d1ba..619a83f3851 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -40,8 +40,6 @@ public:
         const StorageMetadataPtr & /*metadata_snapshot*/,
         ContextPtr context) override;
 
-    static RedisConfiguration getConfiguration(ASTs engine_args, ContextPtr context);
-
 private:
     StorageID table_id;
     RedisConfiguration configuration;
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index 9e4a39b1b85..cd08837aae2 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -74,7 +74,7 @@ void TableFunctionRedis::parseArguments(const ASTPtr & ast_function, ContextPtr
             "Table function 'Redis' requires from 5 parameters: "
             "redis('host:port', db_index, 'password', 'storage_type', 'pool_size')");
     }
-    configuration = StorageRedis::getConfiguration(args, context);
+    configuration = getRedisConfiguration(args, context);
 }
 
 

From ff961834d674a8ce099da43811eb2eedf3b0d011 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 25 May 2023 17:29:49 +0800
Subject: [PATCH 175/722] add tests to redis engine

---
 tests/integration/test_storage_redis/test.py | 151 +++++++++++++++++--
 1 file changed, 138 insertions(+), 13 deletions(-)

diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index 4220563c229..af01c2e9ff1 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -1,6 +1,11 @@
+import time
+
 import redis
 import pytest
+
+from helpers.client import QueryRuntimeException
 from helpers.cluster import ClickHouseCluster
+from helpers.test_tools import TSV
 
 cluster = ClickHouseCluster(__file__)
 
@@ -18,40 +23,160 @@ def started_cluster():
 
 def get_redis_connection(db_id=0):
     client = redis.Redis(
-        host=node.name, port=started_cluster.redis_port, password="clickhouse", db=db_id
+        host='localhost', port=cluster.redis_port, password="clickhouse", db=db_id
     )
     return client
 
 
-def get_address():
-    return node.name + started_cluster.redis_port
+def get_address_for_ch():
+    return cluster.redis_host + ':6379'
+
+
+def drop_table(table):
+    node.query(f"DROP TABLE IF EXISTS {table} SYNC");
 
 
-@pytest.mark.parametrize("started_cluster")
 def test_storage_simple_select(started_cluster):
     client = get_redis_connection()
-    address = get_address()
+    address = get_address_for_ch()
+
+    # clean all
+    client.flushall()
+    drop_table('test_storage_simple_select')
 
     data = {}
     for i in range(100):
-        data['key{}'.format(i)] = 'value{}'.format(i)
+        data[str(i)] = str(i)
 
     client.mset(data)
+    client.close()
 
     # create table
     node.query(
         f"""
         CREATE TABLE test_storage_simple_select(
             k String, 
-            v String
-        ) Engine=Redis('{address}', 0, '','simple', 10)
+            v UInt32
+        ) Engine=Redis('{address}', 0, 'clickhouse')
         """
     )
 
-    select_query = "SELECT k, v from test_storage_simple_select where k='0' FORMAT Values"
-    assert (node.query(select_query) == "('0','0')")
+    response = TSV.toMat(node.query("SELECT k, v from test_storage_simple_select where k='0' FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['0', '0'])
 
-    select_query = "SELECT * from test_storage_simple_select FORMAT Values"
-    assert (len(node.query(select_query)) == 100)
-    assert (node.query(select_query)[0] == "('0','0')")
+    response = TSV.toMat(node.query("SELECT * from test_storage_simple_select order by k FORMAT TSV"))
+    assert (len(response) == 100)
+    assert (response[0] == ['0', '0'])
+
+
+def test_storage_hash_map_select(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+
+    # clean all
+    client.flushall()
+    drop_table('test_storage_hash_map_select')
+
+    key = 'k'
+    data = {}
+    for i in range(100):
+        data[str(i)] = str(i)
+
+    client.hset(key, mapping=data)
+    client.close()
+
+    # create table
+    node.query(
+        f"""
+        CREATE TABLE test_storage_hash_map_select(
+            k String,
+            f String, 
+            v UInt32
+        ) Engine=Redis('{address}', 0, 'clickhouse','hash_map')
+        """
+    )
+
+    response = TSV.toMat(node.query("SELECT k, f, v from test_storage_hash_map_select where f='0' FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['k', '0', '0'])
+
+    response = TSV.toMat(node.query("SELECT * from test_storage_hash_map_select FORMAT TSV"))
+    assert (len(response) == 100)
+    assert (response[0] == ['k', '0', '0'])
+
+
+def test_create_table(started_cluster):
+    address = get_address_for_ch()
+
+    # simple creation
+    drop_table('test_create_table')
+    node.query(
+        f"""
+        CREATE TABLE test_create_table(
+            k String,
+            v UInt32
+        ) Engine=Redis('{address}')
+        """
+    )
+
+    # simple creation with full engine args
+    drop_table('test_create_table')
+    node.query(
+        f"""
+        CREATE TABLE test_create_table(
+            k String,
+            v UInt32
+        ) Engine=Redis('{address}', 0, 'clickhouse','simple', 10)
+        """
+    )
+
+    drop_table('test_create_table')
+    node.query(
+        f"""
+        CREATE TABLE test_create_table(
+            k String,
+            f String,
+            v UInt32
+        ) Engine=Redis('{address}', 0, 'clickhouse','hash_map', 10)
+        """
+    )
+
+    # illegal columns
+    drop_table('test_create_table')
+    with pytest.raises(QueryRuntimeException):
+        node.query(
+            f"""
+            CREATE TABLE test_create_table(
+                k String,
+                f String,
+                v UInt32
+            ) Engine=Redis('{address}', 0, 'clickhouse','simple', 10)
+            """
+        )
+
+    drop_table('test_create_table')
+    with pytest.raises(QueryRuntimeException):
+        node.query(
+            f"""
+            CREATE TABLE test_create_table(
+                k String,
+                f String,
+                v UInt32,
+                n UInt32
+            ) Engine=Redis('{address}', 0, 'clickhouse','hash_map', 10)
+            """
+        )
+
+    # illegal storage type
+    drop_table('test_create_table')
+    with pytest.raises(QueryRuntimeException):
+        node.query(
+            f"""
+            CREATE TABLE test_create_table(
+                k String,
+                v UInt32
+            ) Engine=Redis('{address}', 0, 'clickhouse','not_exist', 10)
+            """
+        )
 

From 8c822a7edfb919844a94a46485dfeebbf9caad57 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Fri, 26 May 2023 10:34:37 +0800
Subject: [PATCH 176/722] add tests to redis engine

---
 src/Storages/RedisCommon.cpp                  |   6 +-
 src/Storages/RedisCommon.h                    |   2 +-
 src/Storages/StorageRedis.cpp                 |   2 +-
 src/TableFunctions/TableFunctionRedis.cpp     |  40 +-
 src/TableFunctions/TableFunctionRedis.h       |   1 +
 tests/integration/test_storage_redis/test.py  |   9 +-
 .../configs_secure/config.d/ssl_conf.xml      |   8 -
 .../test_table_function_redis/test.py         | 385 ++++++------------
 8 files changed, 166 insertions(+), 287 deletions(-)
 delete mode 100644 tests/integration/test_table_function_redis/configs_secure/config.d/ssl_conf.xml

diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 0d33b9c7aa3..86312f49f41 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -1,5 +1,9 @@
 #include "RedisCommon.h"
 #include <Common/Exception.h>
+#include <Common/parseAddress.h>
+#include <Storages/NamedCollectionsHelpers.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Storages/checkAndGetLiteralArgument.h>
 
 namespace DB
 {
@@ -169,7 +173,7 @@ RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names &
     }
 }
 
-RedisConfiguration getRedisConfiguration(const ASTs & engine_args, ContextPtr context)
+RedisConfiguration getRedisConfiguration(ASTs & engine_args, ContextPtr context)
 {
     RedisConfiguration configuration;
     configuration.db_index = 0;
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 30e771d2471..c378006f7a5 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -84,7 +84,7 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
 RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column);
 
 /// parse redis table engine/function configuration from engine_args
-RedisConfiguration getRedisConfiguration(const ASTs & engine_args, ContextPtr context);
+RedisConfiguration getRedisConfiguration(ASTs & engine_args, ContextPtr context);
 
 /// checking Redis table/table-function when creating
 void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration);
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 5010aada8c4..cd1cd06b4c4 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -168,7 +168,7 @@ void registerStorageRedis(StorageFactory & factory)
         "Redis",
         [](const StorageFactory::Arguments & args)
         {
-            auto configuration = StorageRedis::getConfiguration(args.engine_args, args.getLocalContext());
+            auto configuration = getRedisConfiguration(args.engine_args, args.getLocalContext());
 
             checkRedisTableStructure(args.columns, configuration);
 
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index cd08837aae2..f90a30af8a1 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -11,6 +11,7 @@
 #include <Storages/ColumnsDescription.h>
 #include <TableFunctions/TableFunctionFactory.h>
 #include <TableFunctions/registerTableFunctions.h>
+#include <Storages/checkAndGetLiteralArgument.h>
 
 
 namespace DB
@@ -43,19 +44,6 @@ StoragePtr TableFunctionRedis::executeImpl(
 /// TODO support user customized table structure
 ColumnsDescription TableFunctionRedis::getActualTableStructure(ContextPtr context) const
 {
-    /// generate table structure by storage type.
-    String structure;
-    switch (configuration->storage_type)
-    {
-        case RedisStorageType::SIMPLE:
-            structure = "key String, value String";
-            break;
-        case RedisStorageType::HASH_MAP:
-            structure = "key String, field String, value String";
-            break;
-        case RedisStorageType::UNKNOWN:
-            throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type.");
-    }
     return parseColumnsListFromString(structure, context);
 }
 
@@ -66,15 +54,25 @@ void TableFunctionRedis::parseArguments(const ASTPtr & ast_function, ContextPtr
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Table function 'redis' must have arguments.");
 
     ASTs & args = func_args.arguments->children;
-
-    if (args.size() != 5)
-    {
-        throw Exception(
-            ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH,
-            "Table function 'Redis' requires from 5 parameters: "
-            "redis('host:port', db_index, 'password', 'storage_type', 'pool_size')");
-    }
     configuration = getRedisConfiguration(args, context);
+
+    if (args.size() > 5)
+        structure = checkAndGetLiteralArgument<String>(args[5], "structure");
+
+    if (structure.empty())
+    {
+        switch (configuration->storage_type)
+        {
+            case RedisStorageType::SIMPLE:
+                structure = "key String, value String";
+                break;
+            case RedisStorageType::HASH_MAP:
+                structure = "key String, field String, value String";
+                break;
+            case RedisStorageType::UNKNOWN:
+                throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type.");
+        }
+    }
 }
 
 
diff --git a/src/TableFunctions/TableFunctionRedis.h b/src/TableFunctions/TableFunctionRedis.h
index 5c6f483fda7..1328d54a2a6 100644
--- a/src/TableFunctions/TableFunctionRedis.h
+++ b/src/TableFunctions/TableFunctionRedis.h
@@ -24,6 +24,7 @@ private:
     void parseArguments(const ASTPtr & ast_function, ContextPtr context) override;
 
     std::optional<RedisConfiguration> configuration;
+    String structure;
 };
 
 }
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index af01c2e9ff1..d4fbdaddd7f 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -1,5 +1,6 @@
 import time
 
+## sudo -H pip install redis
 import redis
 import pytest
 
@@ -61,11 +62,11 @@ def test_storage_simple_select(started_cluster):
         """
     )
 
-    response = TSV.toMat(node.query("SELECT k, v from test_storage_simple_select where k='0' FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT k, v FROM test_storage_simple_select WHERE k='0' FORMAT TSV"))
     assert (len(response) == 1)
     assert (response[0] == ['0', '0'])
 
-    response = TSV.toMat(node.query("SELECT * from test_storage_simple_select order by k FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT * FROM test_storage_simple_select ORDER BY k FORMAT TSV"))
     assert (len(response) == 100)
     assert (response[0] == ['0', '0'])
 
@@ -97,11 +98,11 @@ def test_storage_hash_map_select(started_cluster):
         """
     )
 
-    response = TSV.toMat(node.query("SELECT k, f, v from test_storage_hash_map_select where f='0' FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT k, f, v FROM test_storage_hash_map_select WHERE f='0' FORMAT TSV"))
     assert (len(response) == 1)
     assert (response[0] == ['k', '0', '0'])
 
-    response = TSV.toMat(node.query("SELECT * from test_storage_hash_map_select FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT * FROM test_storage_hash_map_select ORDER BY f FORMAT TSV"))
     assert (len(response) == 100)
     assert (response[0] == ['k', '0', '0'])
 
diff --git a/tests/integration/test_table_function_redis/configs_secure/config.d/ssl_conf.xml b/tests/integration/test_table_function_redis/configs_secure/config.d/ssl_conf.xml
deleted file mode 100644
index 3efe98e7045..00000000000
--- a/tests/integration/test_table_function_redis/configs_secure/config.d/ssl_conf.xml
+++ /dev/null
@@ -1,8 +0,0 @@
-<clickhouse>
-    <openSSL>
-        <client>
-            <!-- For self-signed certificate -->
-            <verificationMode>none</verificationMode>
-        </client>
-    </openSSL>
-</clickhouse>
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
index e0ad71b0079..e53022095c9 100644
--- a/tests/integration/test_table_function_redis/test.py
+++ b/tests/integration/test_table_function_redis/test.py
@@ -1,276 +1,159 @@
-import pymongo
+import time
 
+import redis
 import pytest
-from helpers.client import QueryRuntimeException
 
+from helpers.client import QueryRuntimeException
 from helpers.cluster import ClickHouseCluster
+from helpers.test_tools import TSV
+
+cluster = ClickHouseCluster(__file__)
+
+node = cluster.add_instance("node", with_redis=True)
 
 
 @pytest.fixture(scope="module")
-def started_cluster(request):
+def started_cluster():
     try:
-        cluster = ClickHouseCluster(__file__)
-        node = cluster.add_instance(
-            "node",
-            with_mongo=True,
-            main_configs=[
-                "configs_secure/config.d/ssl_conf.xml",
-            ],
-            with_mongo_secure=request.param,
-        )
         cluster.start()
         yield cluster
     finally:
         cluster.shutdown()
 
 
-def get_mongo_connection(started_cluster, secure=False, with_credentials=True):
-    connection_str = ""
-    if with_credentials:
-        connection_str = "mongodb://root:clickhouse@localhost:{}".format(
-            started_cluster.mongo_port
-        )
-    else:
-        connection_str = "mongodb://localhost:{}".format(
-            started_cluster.mongo_no_cred_port
-        )
-    if secure:
-        connection_str += "/?tls=true&tlsAllowInvalidCertificates=true"
-    return pymongo.MongoClient(connection_str)
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_simple_select(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-
-    node = started_cluster.instances["node"]
-    for i in range(0, 100):
-        node.query(
-            "INSERT INTO FUNCTION mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String') (key, data) VALUES ({}, '{}')".format(
-                i, hex(i * i)
-            )
-        )
-    assert (
-        node.query(
-            "SELECT COUNT() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
-        )
-        == "100\n"
+def get_redis_connection(db_id=0):
+    client = redis.Redis(
+        host='localhost', port=cluster.redis_port, password="clickhouse", db=db_id
     )
-    assert (
-        node.query(
-            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
-        )
-        == str(sum(range(0, 100))) + "\n"
-    )
-    assert (
-        node.query(
-            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', 'key UInt64, data String')"
-        )
-        == str(sum(range(0, 100))) + "\n"
-    )
-
-    assert (
-        node.query(
-            "SELECT data from mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String') where key = 42"
-        )
-        == hex(42 * 42) + "\n"
-    )
-    simple_mongo_table.drop()
+    return client
 
 
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_complex_data_type(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    incomplete_mongo_table = db["complex_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i), "dict": {"a": i, "b": str(i)}})
-    incomplete_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-
-    assert (
-        node.query(
-            "SELECT COUNT() FROM mongodb('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse', structure='key UInt64, data String, dict Map(UInt64, String)')"
-        )
-        == "100\n"
-    )
-    assert (
-        node.query(
-            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse', structure='key UInt64, data String, dict Map(UInt64, String)')"
-        )
-        == str(sum(range(0, 100))) + "\n"
-    )
-
-    assert (
-        node.query(
-            "SELECT data from mongodb('mongo1:27017', 'test', 'complex_table', 'root', 'clickhouse', structure='key UInt64, data String, dict Map(UInt64, String)') where key = 42"
-        )
-        == hex(42 * 42) + "\n"
-    )
-    incomplete_mongo_table.drop()
+def get_address_for_ch():
+    return cluster.redis_host + ':6379'
 
 
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_incorrect_data_type(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    strange_mongo_table = db["strange_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i), "aaaa": "Hello"})
-    strange_mongo_table.insert_many(data)
+def test_storage_simple(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
 
-    node = started_cluster.instances["node"]
+    # clean all
+    client.flushall()
 
+    data = {}
+    for i in range(100):
+        data[str(i)] = str(i)
+
+    client.mset(data)
+    client.close()
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT 
+            key, value 
+        FROM 
+            redis('{address}', 0, 'clickhouse') 
+        WHERE 
+            key='0' 
+        FORMAT TSV
+        """))
+
+    assert (len(response) == 1)
+    assert (response[0] == ['0', '0'])
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT 
+            * 
+        FROM 
+            redis('{address}', 0, 'clickhouse') 
+        ORDER BY 
+            key 
+        FORMAT TSV
+        """))
+
+    assert (len(response) == 100)
+    assert (response[0] == ['0', '0'])
+
+
+def test_storage_hash_map(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+
+    # clean all
+    client.flushall()
+
+    key = 'k'
+    data = {}
+    for i in range(100):
+        data[str(i)] = str(i)
+
+    client.hset(key, mapping=data)
+    client.close()
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT 
+            key, field, value
+        FROM 
+            redis('{address}', 0, 'clickhouse','hash_map') 
+        WHERE 
+            field='0' 
+        FORMAT TSV
+        """))
+
+    assert (len(response) == 1)
+    assert (response[0] == ['k', '0', '0'])
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT 
+            *
+        FROM 
+            redis('{address}', 0, 'clickhouse','hash_map') 
+        ORDER BY 
+            field 
+        FORMAT TSV
+        """))
+
+    assert (len(response) == 100)
+    assert (response[0] == ['k', '0', '0'])
+
+
+def test_customized_table_structure(started_cluster):
+    address = get_address_for_ch()
+
+    node.query(
+        f"""
+        SELECT 
+            *
+        FROM 
+            redis('{address}', 0, 'clickhouse', "simple", 10, "k String, v UInt8") 
+        """)
+
+    node.query(
+        f"""
+            SELECT 
+                *
+            FROM 
+                redis('{address}', 0, 'clickhouse', "hash_map", 10, "k String, f UInt8, v String") 
+            """)
+
+    # illegal columns
     with pytest.raises(QueryRuntimeException):
         node.query(
-            "SELECT aaaa FROM mongodb('mongo1:27017', 'test', 'strange_table', 'root', 'clickhouse', structure='key UInt64, data String')"
-        )
+            f"""
+            SELECT 
+                *
+            FROM 
+                redis('{address}', 0, 'clickhouse', "hash_map", 10, "k String, v String") 
+            """)
 
-    strange_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [True], indirect=["started_cluster"])
-def test_secure_connection(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster, secure=True)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-
-    assert (
+    # illegal data type
+    with pytest.raises(QueryRuntimeException):
         node.query(
-            "SELECT COUNT() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='ssl=true')"
-        )
-        == "100\n"
-    )
-    assert (
-        node.query(
-            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='ssl=true')"
-        )
-        == str(sum(range(0, 100))) + "\n"
-    )
-    assert (
-        node.query(
-            "SELECT sum(key) FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', 'key UInt64, data String', 'ssl=true')"
-        )
-        == str(sum(range(0, 100))) + "\n"
-    )
-
-    assert (
-        node.query(
-            "SELECT data from mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='ssl=true') where key = 42"
-        )
-        == hex(42 * 42) + "\n"
-    )
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_predefined_connection_configuration(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    assert (
-        node.query(
-            "SELECT count() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
-        )
-        == "100\n"
-    )
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_no_credentials(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
-    db = mongo_connection["test"]
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    assert (
-        node.query(
-            "SELECT count() FROM mongodb('mongo2:27017', 'test', 'simple_table', '', '', structure='key UInt64, data String')"
-        )
-        == "100\n"
-    )
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_auth_source(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster, with_credentials=False)
-    admin_db = mongo_connection["admin"]
-    admin_db.add_user(
-        "root",
-        "clickhouse",
-        roles=[{"role": "userAdminAnyDatabase", "db": "admin"}, "readWriteAnyDatabase"],
-    )
-    simple_mongo_table = admin_db["simple_table"]
-    data = []
-    for i in range(0, 50):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-    db = mongo_connection["test"]
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 100):
-        data.append({"key": i, "data": hex(i * i)})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-
-    node.query_and_get_error(
-        "SELECT count() FROM mongodb('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String')"
-    )
-
-    assert (
-        node.query(
-            "SELECT count() FROM mongodb('mongo2:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data String', options='authSource=admin')"
-        )
-        == "100\n"
-    )
-    simple_mongo_table.drop()
-
-
-@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
-def test_missing_columns(started_cluster):
-    mongo_connection = get_mongo_connection(started_cluster)
-    db = mongo_connection["test"]
-    db.add_user("root", "clickhouse")
-    simple_mongo_table = db["simple_table"]
-    data = []
-    for i in range(0, 10):
-        data.append({"key": i, "data": hex(i * i)})
-    for i in range(0, 10):
-        data.append({"key": i})
-    simple_mongo_table.insert_many(data)
-
-    node = started_cluster.instances["node"]
-    result = node.query(
-        "SELECT count() FROM mongodb('mongo1:27017', 'test', 'simple_table', 'root', 'clickhouse', structure='key UInt64, data Nullable(String)') WHERE isNull(data)"
-    )
-    assert result == "10\n"
-    simple_mongo_table.drop()
+            f"""
+            SELECT 
+                *
+            FROM 
+                redis('{address}', 0, 'clickhouse', "simple", 10, "k Ss, v String") 
+            """)

From 357df40c8f6af947223fc54360340e86016e4eae Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Mon, 29 May 2023 15:22:29 +0800
Subject: [PATCH 177/722] fix tests

---
 src/Dictionaries/RedisSource.cpp              |  8 ++-
 src/Storages/StorageRedis.cpp                 | 14 ++++-
 tests/integration/test_storage_redis/test.py  |  1 +
 .../test_table_function_redis/test.py         | 60 +++++++++++++++++++
 4 files changed, 78 insertions(+), 5 deletions(-)

diff --git a/src/Dictionaries/RedisSource.cpp b/src/Dictionaries/RedisSource.cpp
index 27125077c10..261242c627f 100644
--- a/src/Dictionaries/RedisSource.cpp
+++ b/src/Dictionaries/RedisSource.cpp
@@ -27,14 +27,18 @@ namespace DB
         const RedisStorageType & storage_type_,
         const DB::Block & sample_block,
         size_t max_block_size_)
-        : ISource(sample_block), max_block_size(max_block_size_)// TODO
+        : ISource(sample_block)
+        , connection(std::move(connection_))
+        , keys(keys_)
+        , storage_type(storage_type_)
+        , max_block_size{max_block_size_}
     {
             RedisColumnTypes columns_types_;
             if (storage_type_ == RedisStorageType::HASH_MAP)
                 columns_types_ = REDIS_HASH_MAP_COLUMN_TYPES;
             else
                 columns_types_ = REDIS_SIMPLE_COLUMN_TYPES;
-            RedisSource(std::move(connection_), keys_, storage_type_, sample_block, columns_types_, max_block_size_);
+            description.init(sample_block);
     }
 
     RedisSource::RedisSource(
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index cd1cd06b4c4..e670012d060 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -75,9 +75,8 @@ Pipe StorageRedis::read(
 
     if (all_scan)
     {
+        /// TODO use scan to avoid performance issue
         RedisCommand command_for_keys("KEYS");
-        /// generate keys by table name prefix
-//        command_for_keys << table_id.getTableName() + ":" + serializeStorageType(configuration.storage_type) + ":*";
         command_for_keys << "*";
 
         auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
@@ -136,7 +135,16 @@ Pipe StorageRedis::read(
 
             RedisArray keys;
             for (size_t pos=begin; pos<std::min(end, num_keys); pos++)
-                keys.add(fields->at(pos).get<String>());
+            {
+                if (WhichDataType(*primary_key_data_type).isStringOrFixedString())
+                {
+                    keys.add(fields->at(pos).get<String>());
+                }
+                else
+                {
+                    keys.add(toString(fields->at(pos))); /// TODO redis source deserialize
+                }
+            }
 
             if (configuration.storage_type == RedisStorageType::HASH_MAP)
             {
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index d4fbdaddd7f..19e7b4e5340 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -181,3 +181,4 @@ def test_create_table(started_cluster):
             """
         )
 
+
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
index e53022095c9..7c342690027 100644
--- a/tests/integration/test_table_function_redis/test.py
+++ b/tests/integration/test_table_function_redis/test.py
@@ -157,3 +157,63 @@ def test_customized_table_structure(started_cluster):
             FROM 
                 redis('{address}', 0, 'clickhouse', "simple", 10, "k Ss, v String") 
             """)
+
+
+def test_data_type(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+
+    # string
+    client.flushall()
+    client.set('0', '0')
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT
+            *
+        FROM
+            redis('{address}', 0, 'clickhouse', 'simple', 10, "k String, v UInt8")
+        WHERE
+            k='0'
+        FORMAT TSV
+        """))
+
+    assert (len(response) == 1)
+    assert (response[0] == ['0', '0'])
+
+    # number
+    client.flushall()
+    client.set('0', '0')
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT
+            *
+        FROM
+            redis('{address}', 0, 'clickhouse', 'simple', 10, "k UInt8, v UInt8")
+        WHERE
+            k=0
+        FORMAT TSV
+        """))
+
+    assert (len(response) == 1)
+    assert (response[0] == ['0', '0'])
+
+    # datetime
+    client.flushall()
+    client.set('2023-06-01 00:00:00', '0')
+
+    response = TSV.toMat(node.query(
+        f"""
+        SELECT
+            *
+        FROM
+            redis('{address}', 0, 'clickhouse', 'simple', 10, "k DateTime, v UInt8")
+        WHERE
+            k='2023-06-01 00:00:00'
+        FORMAT TSV
+        """))
+
+    # TODO open
+    # assert (len(response) == 1)
+    # assert (response[0] == ['2023-06-01 00:00:00', '0'])

From f4f939162dcd3b6814a9e4a288f5e0a0538ae283 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Tue, 30 May 2023 20:31:23 +0800
Subject: [PATCH 178/722] new redis engine schema design

---
 src/Dictionaries/RedisDictionarySource.cpp    |   4 +-
 src/Dictionaries/RedisSource.cpp              |  58 +--
 src/Dictionaries/RedisSource.h                |  10 -
 src/Storages/KVStorageUtils.cpp               |   2 +-
 src/Storages/RedisCommon.cpp                  |  91 +---
 src/Storages/RedisCommon.h                    |  33 +-
 src/Storages/StorageFactory.h                 |   3 +-
 src/Storages/StorageRedis.cpp                 | 425 +++++++++++++-----
 src/Storages/StorageRedis.h                   |  43 +-
 src/TableFunctions/TableFunctionRedis.cpp     |  60 ++-
 src/TableFunctions/TableFunctionRedis.h       |   6 +-
 tests/integration/test_storage_redis/test.py  | 101 +++--
 .../test_table_function_redis/test.py         | 141 +++---
 13 files changed, 535 insertions(+), 442 deletions(-)

diff --git a/src/Dictionaries/RedisDictionarySource.cpp b/src/Dictionaries/RedisDictionarySource.cpp
index d28b7528d23..c52c3425d1b 100644
--- a/src/Dictionaries/RedisDictionarySource.cpp
+++ b/src/Dictionaries/RedisDictionarySource.cpp
@@ -40,10 +40,10 @@ namespace DB
             {
                 .host = host,
                 .port = static_cast<UInt16>(port),
-                .db_index = config.getUInt(redis_config_prefix + ".db_index", 0),
+                .db_index = config.getUInt(redis_config_prefix + ".db_index", DEFAULT_REDIS_DB_INDEX),
                 .password = config.getString(redis_config_prefix + ".password", ""),
                 .storage_type = parseStorageType(config.getString(redis_config_prefix + ".storage_type", "")),
-                .pool_size = config.getUInt(redis_config_prefix + ".pool_size", 16),
+                .pool_size = config.getUInt(redis_config_prefix + ".pool_size", DEFAULT_REDIS_POOL_SIZE),
             };
 
             return std::make_unique<RedisDictionarySource>(dict_struct, configuration, sample_block);
diff --git a/src/Dictionaries/RedisSource.cpp b/src/Dictionaries/RedisSource.cpp
index 261242c627f..5d8a475cad4 100644
--- a/src/Dictionaries/RedisSource.cpp
+++ b/src/Dictionaries/RedisSource.cpp
@@ -21,7 +21,7 @@ namespace DB
     }
 
 
-    RedisSource::RedisSource(
+        RedisSource::RedisSource(
         RedisConnectionPtr connection_,
         const RedisArray & keys_,
         const RedisStorageType & storage_type_,
@@ -32,28 +32,6 @@ namespace DB
         , keys(keys_)
         , storage_type(storage_type_)
         , max_block_size{max_block_size_}
-    {
-            RedisColumnTypes columns_types_;
-            if (storage_type_ == RedisStorageType::HASH_MAP)
-                columns_types_ = REDIS_HASH_MAP_COLUMN_TYPES;
-            else
-                columns_types_ = REDIS_SIMPLE_COLUMN_TYPES;
-            description.init(sample_block);
-    }
-
-    RedisSource::RedisSource(
-        RedisConnectionPtr connection_,
-        const RedisArray & keys_,
-        const RedisStorageType & storage_type_,
-        const DB::Block & sample_block,
-        const RedisColumnTypes & columns_types_,
-        size_t max_block_size_)
-        : ISource(sample_block)
-        , connection(std::move(connection_))
-        , keys(keys_)
-        , storage_type(storage_type_)
-        , max_block_size{max_block_size_}
-        , columns_types(columns_types_)
     {
         description.init(sample_block);
     }
@@ -192,27 +170,15 @@ namespace DB
                 const auto & primary_key = keys_array.get<RedisBulkString>(0);
                 for (size_t i = 0; i < values.size(); ++i)
                 {
-                    const auto & value = values.get<RedisBulkString>(i);
                     const auto & secondary_key = keys_array.get<RedisBulkString>(i + 1);
+                    const auto & value = values.get<RedisBulkString>(i);
 
                     /// null string means 'no value for requested key'
                     if (!value.isNull())
                     {
-                        for (size_t idx=0; idx<description.types.size(); idx++)
-                        {
-                            switch (columns_types[idx])
-                            {
-                                case RedisColumnType::KEY:
-                                    insert_value_by_idx(idx, primary_key);
-                                    break;
-                                case RedisColumnType::FIELD:
-                                    insert_value_by_idx(idx, secondary_key);
-                                    break;
-                                case RedisColumnType::VALUE:
-                                    insert_value_by_idx(idx, value);
-                                    break;
-                            }
-                        }
+                        insert_value_by_idx(0, primary_key);
+                        insert_value_by_idx(1, secondary_key);
+                        insert_value_by_idx(2, value);
                         ++num_rows;
                     }
                 }
@@ -239,18 +205,8 @@ namespace DB
                 /// Null string means 'no value for requested key'
                 if (!value.isNull())
                 {
-                    for (size_t idx=0; idx<description.types.size(); idx++)
-                    {
-                        switch (columns_types[idx])
-                        {
-                            case RedisColumnType::KEY:
-                                insert_value_by_idx(idx, key);
-                                break;
-                            default:
-                                insert_value_by_idx(idx, value);
-                                break;
-                        }
-                    }
+                    insert_value_by_idx(0, key);
+                    insert_value_by_idx(1, value);
                 }
             }
             cursor += need_values;
diff --git a/src/Dictionaries/RedisSource.h b/src/Dictionaries/RedisSource.h
index e8e78db67bc..9aa2b0ddba4 100644
--- a/src/Dictionaries/RedisSource.h
+++ b/src/Dictionaries/RedisSource.h
@@ -21,14 +21,6 @@ namespace DB
             const DB::Block & sample_block,
             size_t max_block_size);
 
-        RedisSource(
-            RedisConnectionPtr connection_,
-            const RedisArray & keys_,
-            const RedisStorageType & storage_type_,
-            const Block & sample_block,
-            const RedisColumnTypes & columns_types_,
-            size_t max_block_size);
-
         ~RedisSource() override;
 
         String getName() const override { return "Redis"; }
@@ -41,8 +33,6 @@ namespace DB
         RedisStorageType storage_type;
         const size_t max_block_size;
         ExternalResultDescription description;
-        /// Types is corresponding to description.sample_block one by one
-        RedisColumnTypes columns_types;
         size_t cursor = 0;
         bool all_read = false;
     };
diff --git a/src/Storages/KVStorageUtils.cpp b/src/Storages/KVStorageUtils.cpp
index d5563108ad7..370327e4c7e 100644
--- a/src/Storages/KVStorageUtils.cpp
+++ b/src/Storages/KVStorageUtils.cpp
@@ -175,7 +175,7 @@ std::vector<std::string> serializeKeysToRawString(const ColumnWithTypeAndName &
     return result;
 }
 
-/// In current implementation rocks db can have key with only one column.
+/// In current implementation rocks db/redis can have key with only one column.
 size_t getPrimaryKeyPos(const Block & header, const Names & primary_key)
 {
     if (primary_key.size() != 1)
diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index 86312f49f41..ba7c02fdac5 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -1,9 +1,7 @@
 #include "RedisCommon.h"
 #include <Common/Exception.h>
 #include <Common/parseAddress.h>
-#include <Storages/NamedCollectionsHelpers.h>
 #include <Interpreters/evaluateConstantExpression.h>
-#include <Storages/checkAndGetLiteralArgument.h>
 
 namespace DB
 {
@@ -13,12 +11,10 @@ namespace ErrorCodes
     extern const int INVALID_REDIS_TABLE_STRUCTURE;
     extern const int INTERNAL_REDIS_ERROR;
     extern const int TIMEOUT_EXCEEDED;
+    extern const int BAD_ARGUMENTS;
     extern const int INVALID_REDIS_STORAGE_TYPE;
 }
 
-RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES = {RedisColumnType::KEY, RedisColumnType::FIELD, RedisColumnType::VALUE};
-RedisColumnTypes REDIS_SIMPLE_COLUMN_TYPES = {RedisColumnType::KEY, RedisColumnType::VALUE};
-
 RedisConnection::RedisConnection(RedisPoolPtr pool_, RedisClientPtr client_)
     : pool(std::move(pool_)), client(std::move(client_))
 {
@@ -153,89 +149,4 @@ RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisAr
     return hkeys;
 }
 
-RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column)
-{
-    const String & redis_col_key = all_columns.at(0);
-    if (column == redis_col_key)
-        return RedisColumnType::KEY;
-
-    if (storage_type == RedisStorageType::HASH_MAP)
-    {
-        const String & redis_col_field = all_columns.at(1);
-        if (column == redis_col_field)
-            return RedisColumnType::FIELD;
-        else
-            return RedisColumnType::VALUE;
-    }
-    else
-    {
-        return RedisColumnType::VALUE;
-    }
-}
-
-RedisConfiguration getRedisConfiguration(ASTs & engine_args, ContextPtr context)
-{
-    RedisConfiguration configuration;
-    configuration.db_index = 0;
-    configuration.password = "";
-    configuration.storage_type = RedisStorageType::SIMPLE;
-    configuration.pool_size = 10;
-
-    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
-    {
-        validateNamedCollection(
-            *named_collection,
-            ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "storage_type", "pool_size"},
-            {});
-
-        configuration.host = named_collection->getAny<String>({"host", "hostname"});
-        configuration.port = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("port", 6379));
-        if (engine_args.size() > 1)
-            configuration.password = named_collection->get<String>("password");
-        if (engine_args.size() > 2)
-            configuration.db_index = static_cast<uint32_t>(named_collection->get<UInt64>("db_index"));
-        if (engine_args.size() > 3)
-            configuration.storage_type = parseStorageType(named_collection->get<String>("storage_type"));
-        if (engine_args.size() > 4)
-            configuration.pool_size = static_cast<uint32_t>(named_collection->get<UInt64>("pool_size"));
-    }
-    else
-    {
-        for (auto & engine_arg : engine_args)
-            engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, context);
-
-        /// 6379 is the default Redis port.
-        auto parsed_host_port = parseAddress(checkAndGetLiteralArgument<String>(engine_args[0], "host:port"), 6379);
-
-        configuration.host = parsed_host_port.first;
-        configuration.port = parsed_host_port.second;
-        if (engine_args.size() > 1)
-            configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
-        if (engine_args.size() > 2)
-            configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
-        if (engine_args.size() > 3)
-            configuration.storage_type = parseStorageType(checkAndGetLiteralArgument<String>(engine_args[3], "storage_type"));
-        if (engine_args.size() > 4)
-            configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[4], "pool_size"));
-    }
-
-    if (configuration.storage_type == RedisStorageType::UNKNOWN)
-        throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type");
-
-    context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
-    return configuration;
-}
-
-void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration)
-{
-    /// TODO check data type
-    if (configuration.storage_type == RedisStorageType::HASH_MAP && columns.size() != 3)
-        throw Exception(ErrorCodes::INVALID_REDIS_TABLE_STRUCTURE,
-                        "Redis hash table must have 3 columns, but found {}", columns.size());
-
-    if (configuration.storage_type == RedisStorageType::SIMPLE && columns.size() != 2)
-        throw Exception(ErrorCodes::INVALID_REDIS_TABLE_STRUCTURE,
-                        "Redis string table must have 2 columns, but found {}", columns.size());
-}
-
 }
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index c378006f7a5..cb551a9a11a 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -8,6 +8,7 @@
 #include <base/BorrowedObjectPool.h>
 #include <Core/Names.h>
 #include <Storages/ColumnsDescription.h>
+#include <Storages/StorageFactory.h>
 
 namespace DB
 {
@@ -21,20 +22,6 @@ enum class RedisStorageType
     UNKNOWN
 };
 
-enum class RedisColumnType
-{
-    /// Redis key
-    KEY,
-    /// Redis hash field
-    FIELD,
-    /// Redis value
-    VALUE
-};
-
-using RedisColumnTypes = std::vector<RedisColumnType>;
-
-extern RedisColumnTypes REDIS_HASH_MAP_COLUMN_TYPES;
-extern RedisColumnTypes REDIS_SIMPLE_COLUMN_TYPES;
 
 /// storage type to Redis key type
 String storageTypeToKeyType(RedisStorageType type);
@@ -52,6 +39,10 @@ struct RedisConfiguration
     uint32_t pool_size;
 };
 
+static uint32_t DEFAULT_REDIS_DB_INDEX = 0;
+static uint32_t DEFAULT_REDIS_POOL_SIZE = 16;
+static String DEFAULT_REDIS_PASSWORD;
+
 using RedisArray = Poco::Redis::Array;
 using RedisArrayPtr = std::shared_ptr<RedisArray>;
 using RedisCommand = Poco::Redis::Command;
@@ -61,6 +52,9 @@ using RedisClientPtr = std::unique_ptr<Poco::Redis::Client>;
 using RedisPool = BorrowedObjectPool<RedisClientPtr>;
 using RedisPoolPtr = std::shared_ptr<RedisPool>;
 
+/// Redis scan interator
+using RedisIterator = int64_t;
+
 struct RedisConnection
 {
     RedisConnection(RedisPoolPtr pool_, RedisClientPtr client_);
@@ -78,15 +72,4 @@ RedisConnectionPtr getRedisConnection(RedisPoolPtr pool, const RedisConfiguratio
 ///    eg: keys -> [key1, key2] and get [[key1, field1, field2], [key2, field1, field2]]
 RedisArrayPtr getRedisHashMapKeys(const RedisConnectionPtr & connection, RedisArray & keys);
 
-/// Get RedisColumnType of a column, If storage_type is
-///     SIMPLE: all_columns must have 2 items and the first one is Redis key the second one is value
-///     HASH_MAP: all_columns must have 2 items and the first one is Redis key the second is field, the third is value.
-RedisColumnType getRedisColumnType(RedisStorageType storage_type, const Names & all_columns, const String & column);
-
-/// parse redis table engine/function configuration from engine_args
-RedisConfiguration getRedisConfiguration(ASTs & engine_args, ContextPtr context);
-
-/// checking Redis table/table-function when creating
-void checkRedisTableStructure(const ColumnsDescription & columns, const RedisConfiguration & configuration);
-
 }
diff --git a/src/Storages/StorageFactory.h b/src/Storages/StorageFactory.h
index 77309541374..f1c1c237393 100644
--- a/src/Storages/StorageFactory.h
+++ b/src/Storages/StorageFactory.h
@@ -2,6 +2,7 @@
 
 #include <Common/NamePrompter.h>
 #include <Parsers/IAST_fwd.h>
+#include <Parsers/ASTCreateQuery.h>
 #include <Storages/ColumnsDescription.h>
 #include <Storages/ConstraintsDescription.h>
 #include <Storages/IStorage_fwd.h>
@@ -14,8 +15,6 @@ namespace DB
 {
 
 class Context;
-class ASTCreateQuery;
-class ASTStorage;
 struct StorageID;
 
 
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index e670012d060..ceed448b4a7 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -1,11 +1,9 @@
 #include <Storages/StorageRedis.h>
 #include <Storages/StorageFactory.h>
 #include <Storages/NamedCollectionsHelpers.h>
-#include <Storages/checkAndGetLiteralArgument.h>
 #include <Storages/KVStorageUtils.h>
 
 #include <unordered_set>
-#include <Interpreters/evaluateConstantExpression.h>
 #include <Parsers/ASTLiteral.h>
 #include <Processors/Sinks/SinkToStorage.h>
 #include <QueryPipeline/Pipe.h>
@@ -13,32 +11,142 @@
 #include <Common/parseAddress.h>
 #include <Common/Exception.h>
 #include <IO/WriteHelpers.h>
+#include <Parsers/ASTCreateQuery.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+#include <Storages/StorageInMemoryMetadata.h>
+#include <Storages/KeyDescription.h>
 
 namespace DB
 {
 
 namespace ErrorCodes
 {
-    extern const int INVALID_REDIS_STORAGE_TYPE;
     extern const int NOT_IMPLEMENTED;
 }
 
+class RedisDataSource : public ISource
+{
+public:
+    RedisDataSource(
+        StorageRedis & storage_,
+        const Block & header,
+        FieldVectorPtr keys_,
+        FieldVector::const_iterator begin_,
+        FieldVector::const_iterator end_,
+        const size_t max_block_size_)
+        : ISource(header)
+        , storage(storage_)
+        , primary_key_pos(getPrimaryKeyPos(header, storage.getPrimaryKey()))
+        , keys(keys_)
+        , begin(begin_)
+        , end(end_)
+        , it(begin)
+        , max_block_size(max_block_size_)
+    {
+    }
+
+    RedisDataSource(
+        StorageRedis & storage_,
+        const Block & header,
+        const size_t max_block_size_,
+        const String & pattern_ = "*")
+        : ISource(header)
+        , storage(storage_)
+        , primary_key_pos(getPrimaryKeyPos(header, storage.getPrimaryKey()))
+        , iterator(-1)
+        , pattern(pattern_)
+        , max_block_size(max_block_size_)
+    {
+    }
+
+    String getName() const override { return storage.getName(); }
+
+    Chunk generate() override
+    {
+        if (keys)
+            return generateWithKeys();
+        return generateFullScan();
+    }
+
+    Chunk generateWithKeys()
+    {
+        const auto & sample_block = getPort().getHeader();
+        if (it >= end)
+        {
+            it = {};
+            return {};
+        }
+
+        const auto & key_column_type = sample_block.getByName(storage.getPrimaryKey().at(0)).type;
+        auto raw_keys = serializeKeysToRawString(it, end, key_column_type, max_block_size);
+        return storage.getBySerializedKeys(raw_keys, nullptr);
+    }
+
+    Chunk generateFullScan()
+    {
+        /// redis scan ending
+        if (iterator == 0)
+            return {};
+
+        RedisArray scan_keys;
+        RedisIterator next_iterator;
+
+        std::tie(next_iterator, scan_keys) = storage.scan(iterator == -1 ? 0 : iterator, pattern, max_block_size);
+        iterator = next_iterator;
+
+        /// redis scan can return nothing
+        if (scan_keys.isNull() || scan_keys.size() == 0)
+            return generateFullScan();
+
+        const auto & sample_block = getPort().getHeader();
+        MutableColumns columns = sample_block.cloneEmptyColumns();
+
+        RedisArray values = storage.multiGet(scan_keys);
+        for (size_t i = 0; i<scan_keys.size() && !values.get<RedisBulkString>(i).isNull(); i++)
+        {
+            fillColumns(scan_keys.get<RedisBulkString>(i).value(),
+                values.get<RedisBulkString>(i).value(),
+                primary_key_pos, sample_block, columns
+            );
+        }
+
+        Block block = sample_block.cloneWithColumns(std::move(columns));
+        return Chunk(block.getColumns(), block.rows());
+    }
+
+private:
+    StorageRedis & storage;
+
+    size_t primary_key_pos;
+
+    /// For key scan
+    FieldVectorPtr keys = nullptr;
+    FieldVector::const_iterator begin;
+    FieldVector::const_iterator end;
+    FieldVector::const_iterator it;
+
+    /// For full scan
+    RedisIterator iterator;
+    String pattern;
+
+    const size_t max_block_size;
+};
+
 StorageRedis::StorageRedis(
     const StorageID & table_id_,
     const RedisConfiguration & configuration_,
-    const ColumnsDescription & columns_,
-    const ConstraintsDescription & constraints_,
-    const String & comment_)
+    ContextPtr context_,
+    const StorageInMemoryMetadata & storage_metadata,
+    const String & primary_key_)
     : IStorage(table_id_)
+    , WithContext(context_->getGlobalContext())
     , table_id(table_id_)
     , configuration(configuration_)
     , log(&Poco::Logger::get("StorageRedis"))
+    , primary_key(primary_key_)
 {
     pool = std::make_shared<RedisPool>(configuration.pool_size);
-    StorageInMemoryMetadata storage_metadata;
-    storage_metadata.setColumns(columns_);
-    storage_metadata.setConstraints(constraints_);
-    storage_metadata.setComment(comment_);
     setInMemoryMetadata(storage_metadata);
 }
 
@@ -46,84 +154,37 @@ Pipe StorageRedis::read(
     const Names & column_names,
     const StorageSnapshotPtr & storage_snapshot,
     SelectQueryInfo & query_info,
-    ContextPtr context,
+    ContextPtr context_,
     QueryProcessingStage::Enum /*processed_stage*/,
     size_t max_block_size,
     size_t num_streams)
 {
-    auto connection = getRedisConnection(pool, configuration);
     storage_snapshot->check(column_names);
 
-    Block sample_block;
-    RedisColumnTypes redis_types;
-    auto all_columns = storage_snapshot->metadata->getColumns().getNamesOfPhysical();
-
-    for (const String & column_name : column_names)
-    {
-        auto column_data = storage_snapshot->metadata->getColumns().getPhysical(column_name);
-        sample_block.insert({column_data.type, column_data.name});
-        redis_types.push_back(getRedisColumnType(configuration.storage_type, all_columns, column_name));
-    }
-
-    FieldVectorPtr fields;
+    FieldVectorPtr keys;
     bool all_scan = false;
 
-    String primary_key = all_columns.at(0);
-    auto primary_key_data_type = sample_block.getByName(primary_key).type;
+    Block header = storage_snapshot->metadata->getSampleBlock();
+    auto primary_key_data_type = header.getByName(primary_key).type;
 
-    std::tie(fields, all_scan) = getFilterKeys(primary_key, primary_key_data_type, query_info, context);
+    std::tie(keys, all_scan) = getFilterKeys(primary_key, primary_key_data_type, query_info, context_);
 
     if (all_scan)
     {
-        /// TODO use scan to avoid performance issue
-        RedisCommand command_for_keys("KEYS");
-        command_for_keys << "*";
-
-        auto all_keys = connection->client->execute<RedisArray>(command_for_keys);
-
-        if (all_keys.isNull() || all_keys.size() == 0)
-            return {};
-
-        Pipes pipes;
-
-        size_t num_keys = all_keys.size();
-        size_t num_threads = std::min<size_t>(num_streams, all_keys.size());
-
-        num_threads = std::min<size_t>(num_threads, configuration.pool_size);
-        assert(num_keys <= std::numeric_limits<uint32_t>::max());
-
-        for (size_t thread_idx = 0; thread_idx < num_threads; ++thread_idx)
-        {
-            size_t begin = num_keys * thread_idx / num_threads;
-            size_t end = num_keys * (thread_idx + 1) / num_threads;
-
-            RedisArray keys;
-            for (size_t pos=begin; pos<std::min(end, num_keys); pos++)
-                keys.add(all_keys.get<RedisBulkString>(pos));
-
-            if (configuration.storage_type == RedisStorageType::HASH_MAP)
-            {
-                keys = *getRedisHashMapKeys(connection, keys);
-            }
-
-            delete connection.release();
-
-            /// TODO reduce keys copy
-            pipes.emplace_back(std::make_shared<RedisSource>(
-                getRedisConnection(pool, configuration), keys,
-                configuration.storage_type, sample_block, redis_types, max_block_size));
-        }
-        return Pipe::unitePipes(std::move(pipes));
+        return Pipe(std::make_shared<RedisDataSource>(*this, header, max_block_size));
     }
     else
     {
-        if (fields->empty())
+        if (keys->empty())
             return {};
 
         Pipes pipes;
 
-        size_t num_keys = fields->size();
-        size_t num_threads = std::min<size_t>(num_streams, fields->size());
+        ::sort(keys->begin(), keys->end());
+        keys->erase(std::unique(keys->begin(), keys->end()), keys->end());
+
+        size_t num_keys = keys->size();
+        size_t num_threads = std::min<size_t>(num_streams, keys->size());
 
         num_threads = std::min<size_t>(num_threads, configuration.pool_size);
         assert(num_keys <= std::numeric_limits<uint32_t>::max());
@@ -133,34 +194,191 @@ Pipe StorageRedis::read(
             size_t begin = num_keys * thread_idx / num_threads;
             size_t end = num_keys * (thread_idx + 1) / num_threads;
 
-            RedisArray keys;
-            for (size_t pos=begin; pos<std::min(end, num_keys); pos++)
-            {
-                if (WhichDataType(*primary_key_data_type).isStringOrFixedString())
-                {
-                    keys.add(fields->at(pos).get<String>());
-                }
-                else
-                {
-                    keys.add(toString(fields->at(pos))); /// TODO redis source deserialize
-                }
-            }
-
-            if (configuration.storage_type == RedisStorageType::HASH_MAP)
-            {
-                keys = *getRedisHashMapKeys(connection, keys);
-            }
-
-            delete connection.release();
-
-            pipes.emplace_back(std::make_shared<RedisSource>(
-                getRedisConnection(pool, configuration), keys,
-                configuration.storage_type, sample_block, redis_types, max_block_size));
+            pipes.emplace_back(std::make_shared<RedisDataSource>(
+                *this, header, keys, keys->begin() + begin, keys->begin() + end, max_block_size));
         }
         return Pipe::unitePipes(std::move(pipes));
     }
 }
 
+namespace
+{
+    //  host:port, db_index, password, pool_size
+    RedisConfiguration getRedisConfiguration(ASTs & engine_args, ContextPtr context)
+    {
+        RedisConfiguration configuration;
+
+        if (engine_args.size() < 1)
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad arguments count when creating Redis table engine");
+
+        if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
+        {
+            validateNamedCollection(
+                *named_collection,
+                ValidateKeysMultiset<RedisEqualKeysSet>{"host", "port", "hostname", "password", "db_index", "pool_size"},
+                {});
+
+            configuration.host = named_collection->getAny<String>({"host", "hostname"});
+            configuration.port = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("port", 6379));
+            configuration.password = named_collection->getOrDefault<String>("password", DEFAULT_REDIS_PASSWORD);
+            configuration.db_index = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("db_index", DEFAULT_REDIS_DB_INDEX));
+            configuration.pool_size = static_cast<uint32_t>(named_collection->getOrDefault<UInt64>("pool_size", DEFAULT_REDIS_POOL_SIZE));
+        }
+        else
+        {
+            for (auto & engine_arg : engine_args)
+                engine_arg = evaluateConstantExpressionOrIdentifierAsLiteral(engine_arg, context);
+
+            /// 6379 is the default Redis port.
+            auto parsed_host_port = parseAddress(checkAndGetLiteralArgument<String>(engine_args[0], "host:port"), 6379);
+            configuration.host = parsed_host_port.first;
+            configuration.port = parsed_host_port.second;
+
+            if (engine_args.size() > 1)
+                configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[1], "db_index"));
+            else
+                configuration.db_index = DEFAULT_REDIS_DB_INDEX;
+            if (engine_args.size() > 2)
+                configuration.password = checkAndGetLiteralArgument<String>(engine_args[2], "password");
+            else
+                configuration.password = DEFAULT_REDIS_PASSWORD;
+            if (engine_args.size() > 3)
+                configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(engine_args[3], "pool_size"));
+            else
+                configuration.pool_size = DEFAULT_REDIS_POOL_SIZE;
+        }
+
+        context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
+        return configuration;
+    }
+
+    StoragePtr createStorageRedis(const StorageFactory::Arguments & args)
+    {
+        auto configuration = getRedisConfiguration(args.engine_args, args.getLocalContext());
+
+        StorageInMemoryMetadata metadata;
+        metadata.setColumns(args.columns);
+        metadata.setConstraints(args.constraints);
+        metadata.setComment(args.comment);
+
+        if (!args.storage_def->primary_key)
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "StorageRedis must require one column in primary key");
+
+        auto primary_key_desc = KeyDescription::getKeyFromAST(args.storage_def->primary_key->ptr(), metadata.columns, args.getContext());
+        auto primary_key_names = primary_key_desc.expression->getRequiredColumns();
+
+        if (primary_key_names.size() != 1)
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "StorageRedis must require one column in primary key");
+        }
+
+        return std::make_shared<StorageRedis>(
+            args.table_id,
+            configuration,
+            args.getContext(),
+            metadata,
+            primary_key_names[0]);
+    }
+}
+
+Chunk StorageRedis::getBySerializedKeys(
+    const std::vector<std::string> & keys,
+    PaddedPODArray<UInt8> * null_map) const
+{
+    RedisArray redis_keys;
+    for (const auto & key : keys)
+        redis_keys.add(key);
+    return getBySerializedKeys(redis_keys, null_map);
+}
+
+Chunk StorageRedis::getBySerializedKeys(
+    const RedisArray & keys,
+    PaddedPODArray<UInt8> * null_map) const
+{
+    Block sample_block = getInMemoryMetadataPtr()->getSampleBlock();
+
+    size_t primary_key_pos = getPrimaryKeyPos(sample_block, getPrimaryKey());
+    MutableColumns columns = sample_block.cloneEmptyColumns();
+
+    RedisArray values = multiGet(keys);
+    if (values.isNull() || values.size() == 0)
+        return {};
+
+    if (null_map)
+    {
+        null_map->clear();
+        null_map->resize_fill(keys.size(), 1);
+    }
+
+    for (size_t i = 0; i < values.size(); ++i)
+    {
+        if (!values.get<RedisBulkString>(i).isNull())
+        {
+            fillColumns(keys.get<RedisBulkString>(i).value(),
+                values.get<RedisBulkString>(i).value(),
+                primary_key_pos, sample_block, columns
+            );
+        }
+        else /// key not found
+        {
+            if (null_map)
+            {
+                (*null_map)[i] = 0;
+                for (size_t col_idx = 0; col_idx < sample_block.columns(); ++col_idx)
+                {
+                    columns[col_idx]->insert(sample_block.getByPosition(col_idx).type->getDefault());
+                }
+            }
+        }
+    }
+
+    size_t num_rows = columns.at(0)->size();
+    return Chunk(std::move(columns), num_rows);
+}
+
+std::pair<RedisIterator, RedisArray> StorageRedis::scan(RedisIterator iterator, const String & pattern, const uint64_t max_count)
+{
+    auto connection = getRedisConnection(pool, configuration);
+    RedisCommand scan("SCAN");
+    scan << toString(iterator) << "MATCH" << pattern << "COUNT" << toString(max_count);
+
+    const auto & result = connection->client->execute<RedisArray>(scan);
+    RedisIterator next = parse<RedisIterator>(result.get<RedisBulkString>(0).value());
+
+    return {next, result.get<RedisArray>(1)};
+}
+
+RedisArray StorageRedis::multiGet(const RedisArray & keys) const
+{
+    auto connection = getRedisConnection(pool, configuration);
+
+    RedisCommand cmd_mget("MGET");
+    for (size_t i = 0; i < keys.size(); ++i)
+        cmd_mget.add(keys.get<RedisBulkString>(i));
+
+    return connection->client->execute<RedisArray>(cmd_mget);
+}
+
+Chunk StorageRedis::getByKeys(
+    const ColumnsWithTypeAndName & keys,
+    PaddedPODArray<UInt8> & null_map,
+    const Names &) const
+{
+    if (keys.size() != 1)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "StorageRedis supports only one key, got: {}", keys.size());
+
+    auto raw_keys = serializeKeysToRawString(keys[0]);
+
+    if (raw_keys.size() != keys[0].column->size())
+        throw DB::Exception(ErrorCodes::LOGICAL_ERROR, "Assertion failed: {} != {}", raw_keys.size(), keys[0].column->size());
+
+    return getBySerializedKeys(raw_keys, &null_map);
+}
+
+Block StorageRedis::getSampleBlock(const Names &) const
+{
+    return getInMemoryMetadataPtr()->getSampleBlock();
+}
 
 SinkToStoragePtr StorageRedis::write(
     const ASTPtr & /*query*/,
@@ -172,24 +390,13 @@ SinkToStoragePtr StorageRedis::write(
 
 void registerStorageRedis(StorageFactory & factory)
 {
-    factory.registerStorage(
-        "Redis",
-        [](const StorageFactory::Arguments & args)
-        {
-            auto configuration = getRedisConfiguration(args.engine_args, args.getLocalContext());
+    StorageFactory::StorageFeatures features{
+        .supports_sort_order = true,
+        .supports_parallel_insert = true,
+        .source_access_type = AccessType::REDIS,
+    };
 
-            checkRedisTableStructure(args.columns, configuration);
-
-            return std::make_shared<StorageRedis>(
-                args.table_id,
-                configuration,
-                args.columns,
-                args.constraints,
-                args.comment);
-        },
-        {
-            .source_access_type = AccessType::REDIS,
-        });
+    factory.registerStorage("Redis", createStorageRedis, features);
 }
 
 }
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 619a83f3851..4a0418e6091 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -2,27 +2,24 @@
 
 #include <Poco/Redis/Redis.h>
 #include <Storages/IStorage.h>
-#include <Dictionaries/RedisSource.h>
+#include <Storages/RedisCommon.h>
+#include <Interpreters/IKeyValueEntity.h>
+#include <Interpreters/Context_fwd.h>
 
 namespace DB
 {
 /* Implements storage in the Redis.
- * Use ENGINE = Redis(host:port, db_index, password, storage_type, pool_size);
- * Read only.
- *
- * Note If storage_type is
- *      SIMPLE: there should be 2 columns and the first one is key in Redis, the second one is value.
- *      HASH_MAP: there should be 3 columns and the first one is key in Redis and the second is the field of Redis Map.
+ * Use ENGINE = Redis(host:port[, db_index[, password[, pool_size]]]) PRIMARY KEY(key);
  */
-class StorageRedis : public IStorage
+class StorageRedis : public IStorage, public IKeyValueEntity, WithContext
 {
 public:
     StorageRedis(
         const StorageID & table_id_,
         const RedisConfiguration & configuration_,
-        const ColumnsDescription & columns_,
-        const ConstraintsDescription & constraints_,
-        const String & comment_);
+        ContextPtr context_,
+        const StorageInMemoryMetadata & storage_metadata,
+        const String & primary_key_);
 
     std::string getName() const override { return "Redis"; }
 
@@ -30,7 +27,7 @@ public:
         const Names & column_names,
         const StorageSnapshotPtr & storage_snapshot,
         SelectQueryInfo & query_info,
-        ContextPtr context,
+        ContextPtr context_,
         QueryProcessingStage::Enum processed_stage,
         size_t max_block_size,
         size_t num_streams) override;
@@ -40,12 +37,34 @@ public:
         const StorageMetadataPtr & /*metadata_snapshot*/,
         ContextPtr context) override;
 
+    Names getPrimaryKey() const override { return {primary_key}; }
+
+    /// Return chunk with data for given serialized keys.
+    /// If out_null_map is passed, fill it with 1/0 depending on key was/wasn't found. Result chunk may contain default values.
+    /// If out_null_map is not passed. Not found rows excluded from result chunk.
+    Chunk getBySerializedKeys(
+        const std::vector<std::string> & keys,
+        PaddedPODArray<UInt8> * out_null_map) const;
+
+    Chunk getBySerializedKeys(
+        const RedisArray & keys,
+        PaddedPODArray<UInt8> * out_null_map) const;
+
+    std::pair<RedisIterator, RedisArray> scan(RedisIterator iterator, const String & pattern, const uint64_t max_count);
+
+    RedisArray multiGet(const RedisArray & keys) const;
+
+    Chunk getByKeys(const ColumnsWithTypeAndName & keys, PaddedPODArray<UInt8> & null_map, const Names &) const override;
+
+    Block getSampleBlock(const Names &) const override;
 private:
     StorageID table_id;
     RedisConfiguration configuration;
 
     Poco::Logger * log;
     RedisPoolPtr pool;
+
+    const String primary_key;
 };
 
 }
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index f90a30af8a1..3db174fbcd8 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -1,6 +1,7 @@
 #include <TableFunctions/TableFunctionRedis.h>
 
 #include <Common/Exception.h>
+#include <Common/parseAddress.h>
 
 #include <Interpreters/Context.h>
 
@@ -12,6 +13,8 @@
 #include <TableFunctions/TableFunctionFactory.h>
 #include <TableFunctions/registerTableFunctions.h>
 #include <Storages/checkAndGetLiteralArgument.h>
+#include <Interpreters/evaluateConstantExpression.h>
+
 
 
 namespace DB
@@ -21,7 +24,6 @@ namespace ErrorCodes
 {
     extern const int BAD_ARGUMENTS;
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
-    extern const int INVALID_REDIS_STORAGE_TYPE;
 }
 
 
@@ -29,19 +31,16 @@ StoragePtr TableFunctionRedis::executeImpl(
     const ASTPtr & /*ast_function*/, ContextPtr context, const String & table_name, ColumnsDescription /*cached_columns*/) const
 {
     auto columns = getActualTableStructure(context);
-    checkRedisTableStructure(columns, *configuration);
+
+    StorageInMemoryMetadata metadata;
+    metadata.setColumns(columns);
 
     auto storage = std::make_shared<StorageRedis>(
-        StorageID(toString(configuration->db_index), table_name),
-        *configuration,
-        columns,
-        ConstraintsDescription(),
-        String{});
+        StorageID(toString(configuration.db_index), table_name), configuration, context, metadata, primary_key);
     storage->startup();
     return storage;
 }
 
-/// TODO support user customized table structure
 ColumnsDescription TableFunctionRedis::getActualTableStructure(ContextPtr context) const
 {
     return parseColumnsListFromString(structure, context);
@@ -54,25 +53,38 @@ void TableFunctionRedis::parseArguments(const ASTPtr & ast_function, ContextPtr
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Table function 'redis' must have arguments.");
 
     ASTs & args = func_args.arguments->children;
-    configuration = getRedisConfiguration(args, context);
 
+    if (args.size() < 3)
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad arguments count when creating Redis table function");
+
+    for (auto & arg : args)
+        arg = evaluateConstantExpressionOrIdentifierAsLiteral(arg, context);
+
+    auto parsed_host_port = parseAddress(checkAndGetLiteralArgument<String>(args[0], "host:port"), 6379);
+    configuration.host = parsed_host_port.first;
+    configuration.port = parsed_host_port.second;
+
+    primary_key = checkAndGetLiteralArgument<String>(args[1], "key");
+    structure = checkAndGetLiteralArgument<String>(args[2], "structure");
+
+    if (args.size() > 3)
+        configuration.db_index = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(args[3], "db_index"));
+    else
+        configuration.db_index = DEFAULT_REDIS_DB_INDEX;
+    if (args.size() > 4)
+        configuration.password = checkAndGetLiteralArgument<String>(args[4], "password");
+    else
+        configuration.password = DEFAULT_REDIS_PASSWORD;
     if (args.size() > 5)
-        structure = checkAndGetLiteralArgument<String>(args[5], "structure");
+        configuration.pool_size = static_cast<uint32_t>(checkAndGetLiteralArgument<UInt64>(args[5], "pool_size"));
+    else
+        configuration.pool_size = DEFAULT_REDIS_POOL_SIZE;
 
-    if (structure.empty())
-    {
-        switch (configuration->storage_type)
-        {
-            case RedisStorageType::SIMPLE:
-                structure = "key String, value String";
-                break;
-            case RedisStorageType::HASH_MAP:
-                structure = "key String, field String, value String";
-                break;
-            case RedisStorageType::UNKNOWN:
-                throw Exception(ErrorCodes::INVALID_REDIS_STORAGE_TYPE, "Invalid Redis storage type.");
-        }
-    }
+    context->getRemoteHostFilter().checkHostAndPort(configuration.host, toString(configuration.port));
+
+    auto columns = parseColumnsListFromString(structure, context);
+    if (!columns.has(primary_key))
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad arguments redis table function structure should contains key.");
 }
 
 
diff --git a/src/TableFunctions/TableFunctionRedis.h b/src/TableFunctions/TableFunctionRedis.h
index 1328d54a2a6..b985a89e3d7 100644
--- a/src/TableFunctions/TableFunctionRedis.h
+++ b/src/TableFunctions/TableFunctionRedis.h
@@ -7,6 +7,9 @@
 namespace DB
 {
 
+/* Implements Redis table function.
+ * Use redis(host:port, key, structure[, db_index[, password[, pool_size]]]);
+ */
 class TableFunctionRedis : public ITableFunction
 {
 public:
@@ -23,8 +26,9 @@ private:
     ColumnsDescription getActualTableStructure(ContextPtr context) const override;
     void parseArguments(const ASTPtr & ast_function, ContextPtr context) override;
 
-    std::optional<RedisConfiguration> configuration;
+    RedisConfiguration configuration;
     String structure;
+    String primary_key;
 };
 
 }
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index 19e7b4e5340..1f65a9df2f3 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -3,6 +3,8 @@ import time
 ## sudo -H pip install redis
 import redis
 import pytest
+import struct
+import sys
 
 from helpers.client import QueryRuntimeException
 from helpers.cluster import ClickHouseCluster
@@ -37,17 +39,50 @@ def drop_table(table):
     node.query(f"DROP TABLE IF EXISTS {table} SYNC");
 
 
-def test_storage_simple_select(started_cluster):
+# see SerializationString.serializeBinary
+def serialize_binary_for_string(x):
+    var_uint_max = (1 << 63) - 1
+    buf = bytearray()
+    # write length
+    length = len(x)
+    # length = (length << 1) ^ (length >> 63)
+    if length > var_uint_max:
+        raise ValueError("Value too large for varint encoding")
+    for i in range(9):
+        byte = length & 0x7F
+        if length > 0x7F:
+            byte |= 0x80
+        buf += (bytes([byte]))
+        length >>= 7
+        if not length:
+            break
+    # write data
+    buf += x.encode('utf-8')
+    return bytes(buf)
+
+
+# see SerializationNumber.serializeBinary
+def serialize_binary_for_uint32(x):
+    buf = bytearray()
+    packed_num = struct.pack('I', x)
+    buf += packed_num
+    if sys.byteorder != 'little':
+        buf.reverse()
+    return bytes(buf)
+
+
+def test_simple_select(started_cluster):
     client = get_redis_connection()
     address = get_address_for_ch()
 
     # clean all
     client.flushall()
-    drop_table('test_storage_simple_select')
+    drop_table('test_simple_select')
 
     data = {}
     for i in range(100):
-        data[str(i)] = str(i)
+        packed = serialize_binary_for_string(str(i))
+        data[packed] = packed
 
     client.mset(data)
     client.close()
@@ -55,56 +90,55 @@ def test_storage_simple_select(started_cluster):
     # create table
     node.query(
         f"""
-        CREATE TABLE test_storage_simple_select(
+        CREATE TABLE test_simple_select(
             k String, 
-            v UInt32
-        ) Engine=Redis('{address}', 0, 'clickhouse')
+            v String
+        ) Engine=Redis('{address}', 0, 'clickhouse') PRIMARY KEY (k)
         """
     )
 
-    response = TSV.toMat(node.query("SELECT k, v FROM test_storage_simple_select WHERE k='0' FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT k, v FROM test_simple_select WHERE k='0' FORMAT TSV"))
     assert (len(response) == 1)
     assert (response[0] == ['0', '0'])
 
-    response = TSV.toMat(node.query("SELECT * FROM test_storage_simple_select ORDER BY k FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT * FROM test_simple_select ORDER BY k FORMAT TSV"))
     assert (len(response) == 100)
     assert (response[0] == ['0', '0'])
 
 
-def test_storage_hash_map_select(started_cluster):
+def test_select_int(started_cluster):
     client = get_redis_connection()
     address = get_address_for_ch()
 
     # clean all
     client.flushall()
-    drop_table('test_storage_hash_map_select')
+    drop_table('test_select_int')
 
-    key = 'k'
     data = {}
     for i in range(100):
-        data[str(i)] = str(i)
+        packed = serialize_binary_for_uint32(i)
+        data[packed] = packed
 
-    client.hset(key, mapping=data)
+    client.mset(data)
     client.close()
 
     # create table
     node.query(
         f"""
-        CREATE TABLE test_storage_hash_map_select(
-            k String,
-            f String, 
+        CREATE TABLE test_select_int(
+            k UInt32, 
             v UInt32
-        ) Engine=Redis('{address}', 0, 'clickhouse','hash_map')
+        ) Engine=Redis('{address}', 0, 'clickhouse') PRIMARY KEY (k)
         """
     )
 
-    response = TSV.toMat(node.query("SELECT k, f, v FROM test_storage_hash_map_select WHERE f='0' FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT k, v FROM test_select_int WHERE k=0 FORMAT TSV"))
     assert (len(response) == 1)
-    assert (response[0] == ['k', '0', '0'])
+    assert (response[0] == ['0', '0'])
 
-    response = TSV.toMat(node.query("SELECT * FROM test_storage_hash_map_select ORDER BY f FORMAT TSV"))
+    response = TSV.toMat(node.query("SELECT * FROM test_select_int ORDER BY k FORMAT TSV"))
     assert (len(response) == 100)
-    assert (response[0] == ['k', '0', '0'])
+    assert (response[0] == ['0', '0'])
 
 
 def test_create_table(started_cluster):
@@ -117,7 +151,7 @@ def test_create_table(started_cluster):
         CREATE TABLE test_create_table(
             k String,
             v UInt32
-        ) Engine=Redis('{address}')
+        ) Engine=Redis('{address}') PRIMARY KEY (k)
         """
     )
 
@@ -128,7 +162,7 @@ def test_create_table(started_cluster):
         CREATE TABLE test_create_table(
             k String,
             v UInt32
-        ) Engine=Redis('{address}', 0, 'clickhouse','simple', 10)
+        ) Engine=Redis('{address}', 0, 'clickhouse', 10) PRIMARY KEY (k)
         """
     )
 
@@ -139,11 +173,10 @@ def test_create_table(started_cluster):
             k String,
             f String,
             v UInt32
-        ) Engine=Redis('{address}', 0, 'clickhouse','hash_map', 10)
+        ) Engine=Redis('{address}', 0, 'clickhouse', 10) PRIMARY KEY (k)
         """
     )
 
-    # illegal columns
     drop_table('test_create_table')
     with pytest.raises(QueryRuntimeException):
         node.query(
@@ -152,7 +185,7 @@ def test_create_table(started_cluster):
                 k String,
                 f String,
                 v UInt32
-            ) Engine=Redis('{address}', 0, 'clickhouse','simple', 10)
+            ) Engine=Redis('{address}', 0, 'clickhouse', 10) PRIMARY KEY ()
             """
         )
 
@@ -163,22 +196,8 @@ def test_create_table(started_cluster):
             CREATE TABLE test_create_table(
                 k String,
                 f String,
-                v UInt32,
-                n UInt32
-            ) Engine=Redis('{address}', 0, 'clickhouse','hash_map', 10)
-            """
-        )
-
-    # illegal storage type
-    drop_table('test_create_table')
-    with pytest.raises(QueryRuntimeException):
-        node.query(
-            f"""
-            CREATE TABLE test_create_table(
-                k String,
                 v UInt32
-            ) Engine=Redis('{address}', 0, 'clickhouse','not_exist', 10)
+            ) Engine=Redis('{address}', 0, 'clickhouse', 10)
             """
         )
 
-
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
index 7c342690027..111276ec6dc 100644
--- a/tests/integration/test_table_function_redis/test.py
+++ b/tests/integration/test_table_function_redis/test.py
@@ -1,7 +1,9 @@
-import time
+import datetime
 
 import redis
 import pytest
+import sys
+import struct
 
 from helpers.client import QueryRuntimeException
 from helpers.cluster import ClickHouseCluster
@@ -32,7 +34,39 @@ def get_address_for_ch():
     return cluster.redis_host + ':6379'
 
 
-def test_storage_simple(started_cluster):
+# see SerializationString.serializeBinary
+def serialize_binary_for_string(x):
+    var_uint_max = (1 << 63) - 1
+    buf = bytearray()
+    # write length
+    length = len(x)
+    # length = (length << 1) ^ (length >> 63)
+    if length > var_uint_max:
+        raise ValueError("Value too large for varint encoding")
+    for i in range(9):
+        byte = length & 0x7F
+        if length > 0x7F:
+            byte |= 0x80
+        buf += (bytes([byte]))
+        length >>= 7
+        if not length:
+            break
+    # write data
+    buf += x.encode('utf-8')
+    return bytes(buf)
+
+
+# see SerializationNumber.serializeBinary
+def serialize_binary_for_uint32(x):
+    buf = bytearray()
+    packed_num = struct.pack('I', x)
+    buf += packed_num
+    if sys.byteorder != 'little':
+        buf.reverse()
+    return bytes(buf)
+
+
+def test_simple_select(started_cluster):
     client = get_redis_connection()
     address = get_address_for_ch()
 
@@ -41,7 +75,8 @@ def test_storage_simple(started_cluster):
 
     data = {}
     for i in range(100):
-        data[str(i)] = str(i)
+        packed = serialize_binary_for_string(str(i))
+        data[packed] = packed
 
     client.mset(data)
     client.close()
@@ -51,7 +86,7 @@ def test_storage_simple(started_cluster):
         SELECT 
             key, value 
         FROM 
-            redis('{address}', 0, 'clickhouse') 
+            redis('{address}', 'key', 'key String, value String', 0, 'clickhouse', 10) 
         WHERE 
             key='0' 
         FORMAT TSV
@@ -65,7 +100,7 @@ def test_storage_simple(started_cluster):
         SELECT 
             * 
         FROM 
-            redis('{address}', 0, 'clickhouse') 
+            redis('{address}', 'key', 'key String, value String', 0, 'clickhouse', 10) 
         ORDER BY 
             key 
         FORMAT TSV
@@ -75,79 +110,22 @@ def test_storage_simple(started_cluster):
     assert (response[0] == ['0', '0'])
 
 
-def test_storage_hash_map(started_cluster):
+def test_create_table(started_cluster):
     client = get_redis_connection()
     address = get_address_for_ch()
 
     # clean all
     client.flushall()
-
-    key = 'k'
-    data = {}
-    for i in range(100):
-        data[str(i)] = str(i)
-
-    client.hset(key, mapping=data)
     client.close()
 
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT 
-            key, field, value
-        FROM 
-            redis('{address}', 0, 'clickhouse','hash_map') 
-        WHERE 
-            field='0' 
-        FORMAT TSV
-        """))
-
-    assert (len(response) == 1)
-    assert (response[0] == ['k', '0', '0'])
-
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT 
-            *
-        FROM 
-            redis('{address}', 0, 'clickhouse','hash_map') 
-        ORDER BY 
-            field 
-        FORMAT TSV
-        """))
-
-    assert (len(response) == 100)
-    assert (response[0] == ['k', '0', '0'])
-
-
-def test_customized_table_structure(started_cluster):
-    address = get_address_for_ch()
-
     node.query(
         f"""
         SELECT 
             *
         FROM 
-            redis('{address}', 0, 'clickhouse', "simple", 10, "k String, v UInt8") 
+            redis('{address}', 'k', 'k String, v UInt32', 0, 'clickhouse', 10) 
         """)
 
-    node.query(
-        f"""
-            SELECT 
-                *
-            FROM 
-                redis('{address}', 0, 'clickhouse', "hash_map", 10, "k String, f UInt8, v String") 
-            """)
-
-    # illegal columns
-    with pytest.raises(QueryRuntimeException):
-        node.query(
-            f"""
-            SELECT 
-                *
-            FROM 
-                redis('{address}', 0, 'clickhouse', "hash_map", 10, "k String, v String") 
-            """)
-
     # illegal data type
     with pytest.raises(QueryRuntimeException):
         node.query(
@@ -155,7 +133,17 @@ def test_customized_table_structure(started_cluster):
             SELECT 
                 *
             FROM 
-                redis('{address}', 0, 'clickhouse', "simple", 10, "k Ss, v String") 
+                redis('{address}', 'k', 'k not_exist_type, v String', 0, 'clickhouse', 10) 
+            """)
+
+    # illegal key
+    with pytest.raises(QueryRuntimeException):
+        node.query(
+            f"""
+            SELECT 
+                *
+            FROM 
+                redis('{address}', 'not_exist_key', 'k not_exist_type, v String', 0, 'clickhouse', 10) 
             """)
 
 
@@ -165,14 +153,15 @@ def test_data_type(started_cluster):
 
     # string
     client.flushall()
-    client.set('0', '0')
+    value = serialize_binary_for_string('0')
+    client.set(value, value)
 
     response = TSV.toMat(node.query(
         f"""
         SELECT
             *
         FROM
-            redis('{address}', 0, 'clickhouse', 'simple', 10, "k String, v UInt8")
+            redis('{address}', 'k', 'k String, v String', 0, 'clickhouse', 10)
         WHERE
             k='0'
         FORMAT TSV
@@ -183,14 +172,15 @@ def test_data_type(started_cluster):
 
     # number
     client.flushall()
-    client.set('0', '0')
+    value = serialize_binary_for_uint32(0)
+    client.set(value, value)
 
     response = TSV.toMat(node.query(
         f"""
         SELECT
             *
         FROM
-            redis('{address}', 0, 'clickhouse', 'simple', 10, "k UInt8, v UInt8")
+            redis('{address}', 'k', 'k UInt32, v UInt32', 0, 'clickhouse', 10)
         WHERE
             k=0
         FORMAT TSV
@@ -201,19 +191,22 @@ def test_data_type(started_cluster):
 
     # datetime
     client.flushall()
-    client.set('2023-06-01 00:00:00', '0')
+    # clickhouse store datatime as uint32 in internal
+    dt = datetime.datetime(2023, 6, 1, 0, 0, 0)
+    seconds_since_epoch = dt.timestamp()
+    value = serialize_binary_for_uint32(int(seconds_since_epoch))
+    client.set(value, value)
 
     response = TSV.toMat(node.query(
         f"""
         SELECT
             *
         FROM
-            redis('{address}', 0, 'clickhouse', 'simple', 10, "k DateTime, v UInt8")
+            redis('{address}', 'k', 'k DateTime, v DateTime', 0, 'clickhouse', 10)
         WHERE
             k='2023-06-01 00:00:00'
         FORMAT TSV
         """))
 
-    # TODO open
-    # assert (len(response) == 1)
-    # assert (response[0] == ['2023-06-01 00:00:00', '0'])
+    assert (len(response) == 1)
+    assert (response[0] == ['2023-06-01 00:00:00', '2023-06-01 00:00:00'])

From 1df1dfc3e54b9e9b2b0f05a516ffc83ff3147c76 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 14:31:06 +0800
Subject: [PATCH 179/722] add update/delete/insert to redis storage

---
 src/Storages/RedisCommon.h                   |   4 +-
 src/Storages/StorageRedis.cpp                | 198 ++++++++++++++++++-
 src/Storages/StorageRedis.h                  |  14 +-
 tests/integration/test_storage_redis/test.py | 135 ++++++++++++-
 4 files changed, 344 insertions(+), 7 deletions(-)

diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index cb551a9a11a..49c21c3277f 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -43,10 +43,12 @@ static uint32_t DEFAULT_REDIS_DB_INDEX = 0;
 static uint32_t DEFAULT_REDIS_POOL_SIZE = 16;
 static String DEFAULT_REDIS_PASSWORD;
 
+using RedisCommand = Poco::Redis::Command;
 using RedisArray = Poco::Redis::Array;
 using RedisArrayPtr = std::shared_ptr<RedisArray>;
-using RedisCommand = Poco::Redis::Command;
 using RedisBulkString = Poco::Redis::BulkString;
+using RedisSimpleString = String;
+using RedisInteger = Int64;
 
 using RedisClientPtr = std::unique_ptr<Poco::Redis::Client>;
 using RedisPool = BorrowedObjectPool<RedisClientPtr>;
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index ceed448b4a7..f9a25470e2d 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -13,9 +13,12 @@
 #include <IO/WriteHelpers.h>
 #include <Parsers/ASTCreateQuery.h>
 #include <Interpreters/evaluateConstantExpression.h>
+#include <Interpreters/MutationsInterpreter.h>
 #include <Storages/checkAndGetLiteralArgument.h>
 #include <Storages/StorageInMemoryMetadata.h>
 #include <Storages/KeyDescription.h>
+#include <QueryPipeline/QueryPipelineBuilder.h>
+#include <Processors/Executors/PullingPipelineExecutor.h>
 
 namespace DB
 {
@@ -23,6 +26,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int NOT_IMPLEMENTED;
+    extern const int INTERNAL_REDIS_ERROR;
 }
 
 class RedisDataSource : public ISource
@@ -133,6 +137,64 @@ private:
     const size_t max_block_size;
 };
 
+
+class RedisSink : public SinkToStorage
+{
+public:
+    RedisSink(
+        StorageRedis & storage_,
+        const StorageMetadataPtr & metadata_snapshot_);
+
+    void consume(Chunk chunk) override;
+    String getName() const override { return "RedisSink"; }
+
+private:
+    StorageRedis & storage;
+    StorageMetadataPtr metadata_snapshot;
+    size_t primary_key_pos = 0;
+};
+
+RedisSink::RedisSink(
+    StorageRedis & storage_,
+    const StorageMetadataPtr & metadata_snapshot_)
+    : SinkToStorage(metadata_snapshot_->getSampleBlock())
+    , storage(storage_)
+    , metadata_snapshot(metadata_snapshot_)
+{
+    for (const auto & column : getHeader())
+    {
+        if (column.name == storage.getPrimaryKey()[0])
+            break;
+        ++primary_key_pos;
+    }
+}
+
+void RedisSink::consume(Chunk chunk)
+{
+    auto rows = chunk.getNumRows();
+    auto block = getHeader().cloneWithColumns(chunk.detachColumns());
+
+    WriteBufferFromOwnString wb_key;
+    WriteBufferFromOwnString wb_value;
+
+    RedisArray data;
+    for (size_t i = 0; i < rows; ++i)
+    {
+        wb_key.restart();
+        wb_value.restart();
+
+        size_t idx = 0;
+        for (const auto & elem : block)
+        {
+            elem.type->getDefaultSerialization()->serializeBinary(*elem.column, i, idx == primary_key_pos ? wb_key : wb_value, {});
+            ++idx;
+        }
+        data.add(wb_key.str());
+        data.add(wb_value.str());
+    }
+    storage.multiSet(data);
+}
+
 StorageRedis::StorageRedis(
     const StorageID & table_id_,
     const RedisConfiguration & configuration_,
@@ -336,7 +398,7 @@ Chunk StorageRedis::getBySerializedKeys(
     return Chunk(std::move(columns), num_rows);
 }
 
-std::pair<RedisIterator, RedisArray> StorageRedis::scan(RedisIterator iterator, const String & pattern, const uint64_t max_count)
+std::pair<RedisIterator, RedisArray> StorageRedis::scan(RedisIterator iterator, const String & pattern, uint64_t max_count)
 {
     auto connection = getRedisConnection(pool, configuration);
     RedisCommand scan("SCAN");
@@ -359,6 +421,36 @@ RedisArray StorageRedis::multiGet(const RedisArray & keys) const
     return connection->client->execute<RedisArray>(cmd_mget);
 }
 
+void StorageRedis::multiSet(const RedisArray & data) const
+{
+    auto connection = getRedisConnection(pool, configuration);
+
+    RedisCommand cmd_mget("MSET");
+    for (size_t i = 0; i < data.size(); ++i)
+        cmd_mget.add(data.get<RedisBulkString>(i));
+
+    auto ret = connection->client->execute<RedisSimpleString>(cmd_mget);
+    if (ret != "OK")
+        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR, "Fail to write to redis table {}, for {}",
+                        table_id.getFullNameNotQuoted(), ret);
+}
+
+RedisInteger StorageRedis::multiDelete(const RedisArray & keys) const
+{
+    auto connection = getRedisConnection(pool, configuration);
+
+    RedisCommand cmd("DEL");
+    for (size_t i = 0; i < keys.size(); ++i)
+        cmd.add(keys.get<RedisBulkString>(i));
+
+    auto ret = connection->client->execute<RedisInteger>(cmd);
+    if (ret != static_cast<RedisInteger>(keys.size()))
+        LOG_DEBUG(log, "Try to delete {} rows but actually deleted {} rows from redis table {}.",
+                  keys.size(), ret, table_id.getFullNameNotQuoted());
+
+    return ret;
+}
+
 Chunk StorageRedis::getByKeys(
     const ColumnsWithTypeAndName & keys,
     PaddedPODArray<UInt8> & null_map,
@@ -382,10 +474,110 @@ Block StorageRedis::getSampleBlock(const Names &) const
 
 SinkToStoragePtr StorageRedis::write(
     const ASTPtr & /*query*/,
-    const StorageMetadataPtr & /*metadata_snapshot*/,
+    const StorageMetadataPtr & metadata_snapshot,
     ContextPtr /*context*/)
 {
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Write is unsupported for StorageRedis");
+    return std::make_shared<RedisSink>(*this, metadata_snapshot);
+}
+
+/// TODO use scan to reduce latency
+void StorageRedis::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
+{
+    auto connection = getRedisConnection(pool, configuration);
+
+    RedisCommand cmd_flush_db("FLUSHDB");
+    cmd_flush_db << toString(configuration.db_index);
+    auto ret = connection->client->execute<RedisBulkString>(cmd_flush_db);
+
+    if (ret.isNull() || ret.value() != "OK")
+        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR, "Fail to truncate redis table {}, for {}", table_id.getFullNameNotQuoted(), ret.value());
+}
+
+void StorageRedis::checkMutationIsPossible(const MutationCommands & commands, const Settings & /* settings */) const
+{
+    if (commands.empty())
+        return;
+
+    if (commands.size() > 1)
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mutations cannot be combined for StorageRedis");
+
+    const auto command_type = commands.front().type;
+    if (command_type != MutationCommand::Type::UPDATE && command_type != MutationCommand::Type::DELETE)
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Only DELETE and UPDATE mutation supported for StorageRedis");
+}
+
+void StorageRedis::mutate(const MutationCommands & commands, ContextPtr context_)
+{
+    if (commands.empty())
+        return;
+
+    assert(commands.size() == 1);
+
+    auto metadata_snapshot = getInMemoryMetadataPtr();
+    auto storage = getStorageID();
+    auto storage_ptr = DatabaseCatalog::instance().getTable(storage, context_);
+
+    if (commands.front().type == MutationCommand::Type::DELETE)
+    {
+        auto interpreter = std::make_unique<MutationsInterpreter>(
+            storage_ptr,
+            metadata_snapshot,
+            commands,
+            context_,
+            /*can_execute_*/ true,
+            /*return_all_columns_*/ true,
+            /*return_mutated_rows*/ true);
+        auto pipeline = QueryPipelineBuilder::getPipeline(interpreter->execute());
+        PullingPipelineExecutor executor(pipeline);
+
+        auto sink = std::make_shared<RedisSink>(*this, metadata_snapshot);
+
+        auto header = interpreter->getUpdatedHeader();
+        auto primary_key_pos = header.getPositionByName(primary_key);
+
+        Block block;
+        while (executor.pull(block))
+        {
+            auto & column_type_name = block.getByPosition(primary_key_pos);
+
+            auto column = column_type_name.column;
+            auto size = column->size();
+
+            RedisArray keys;
+            WriteBufferFromOwnString wb_key;
+            for (size_t i = 0; i < size; ++i)
+            {
+                wb_key.restart();
+                column_type_name.type->getDefaultSerialization()->serializeBinary(*column, i, wb_key, {});
+                keys.add(wb_key.str());
+            }
+            multiDelete(keys);
+        }
+        return;
+    }
+
+    assert(commands.front().type == MutationCommand::Type::UPDATE);
+    if (commands.front().column_to_update_expression.contains(primary_key))
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Primary key cannot be updated (cannot update column {})", primary_key);
+
+    auto interpreter = std::make_unique<MutationsInterpreter>(
+        storage_ptr,
+        metadata_snapshot,
+        commands,
+        context_,
+        /*can_execute_*/ true,
+        /*return_all_columns*/ true,
+        /*return_mutated_rows*/ true);
+    auto pipeline = QueryPipelineBuilder::getPipeline(interpreter->execute());
+    PullingPipelineExecutor executor(pipeline);
+
+    auto sink = std::make_shared<RedisSink>(*this, metadata_snapshot);
+
+    Block block;
+    while (executor.pull(block))
+    {
+        sink->consume(Chunk{block.getColumns(), block.rows()});
+    }
 }
 
 void registerStorageRedis(StorageFactory & factory)
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index 4a0418e6091..a4ab9a6aa4e 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -5,6 +5,7 @@
 #include <Storages/RedisCommon.h>
 #include <Interpreters/IKeyValueEntity.h>
 #include <Interpreters/Context_fwd.h>
+#include <Storages/MutationCommands.h>
 
 namespace DB
 {
@@ -37,6 +38,14 @@ public:
         const StorageMetadataPtr & /*metadata_snapshot*/,
         ContextPtr context) override;
 
+    void truncate(const ASTPtr &,
+        const StorageMetadataPtr & metadata_snapshot,
+        ContextPtr,
+        TableExclusiveLockHolder &) override;
+
+    void checkMutationIsPossible(const MutationCommands & commands, const Settings & settings) const override;
+    void mutate(const MutationCommands &, ContextPtr) override;
+
     Names getPrimaryKey() const override { return {primary_key}; }
 
     /// Return chunk with data for given serialized keys.
@@ -50,13 +59,16 @@ public:
         const RedisArray & keys,
         PaddedPODArray<UInt8> * out_null_map) const;
 
-    std::pair<RedisIterator, RedisArray> scan(RedisIterator iterator, const String & pattern, const uint64_t max_count);
+    std::pair<RedisIterator, RedisArray> scan(RedisIterator iterator, const String & pattern, uint64_t max_count);
 
     RedisArray multiGet(const RedisArray & keys) const;
+    void multiSet(const RedisArray & data) const;
+    RedisInteger multiDelete(const RedisArray & keys) const;
 
     Chunk getByKeys(const ColumnsWithTypeAndName & keys, PaddedPODArray<UInt8> & null_map, const Names &) const override;
 
     Block getSampleBlock(const Names &) const override;
+
 private:
     StorageID table_id;
     RedisConfiguration configuration;
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index 1f65a9df2f3..e77de99c649 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -1,5 +1,3 @@
-import time
-
 ## sudo -H pip install redis
 import redis
 import pytest
@@ -201,3 +199,136 @@ def test_create_table(started_cluster):
             """
         )
 
+
+def test_simple_insert(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+
+    # clean all
+    client.flushall()
+    drop_table('test_simple_insert')
+
+    node.query(
+        f"""
+        CREATE TABLE test_simple_insert(
+            k UInt32, 
+            m DateTime,
+            n String
+        ) Engine=Redis('{address}', 0, 'clickhouse') PRIMARY KEY (k)
+        """
+    )
+
+    node.query(
+        """
+        INSERT INTO test_simple_insert Values 
+        (1, '2023-06-01 00:00:00', 'lili'), (2, '2023-06-02 00:00:00', 'lucy')
+        """
+    )
+
+    response = node.query("SELECT COUNT(*) FROM test_simple_insert FORMAT Values")
+    assert (response == '(2)')
+
+    response = TSV.toMat(node.query("SELECT k, m, n FROM test_simple_insert WHERE k=1 FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['1', '2023-06-01 00:00:00', 'lili'])
+
+    response = TSV.toMat(node.query("SELECT k, m, n FROM test_simple_insert WHERE m='2023-06-01 00:00:00' FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['1', '2023-06-01 00:00:00', 'lili'])
+
+    response = TSV.toMat(node.query("SELECT k, m, n FROM test_simple_insert WHERE n='lili' FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['1', '2023-06-01 00:00:00', 'lili'])
+
+
+def test_update(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+    # clean all
+    client.flushall()
+    drop_table('test_update')
+
+    node.query(
+        f"""
+        CREATE TABLE test_update(
+            k UInt32, 
+            m DateTime,
+            n String
+        ) Engine=Redis('{address}', 0, 'clickhouse') PRIMARY KEY (k)
+        """
+    )
+
+    node.query(
+        """
+        INSERT INTO test_update Values 
+        (1, '2023-06-01 00:00:00', 'lili'), (2, '2023-06-02 00:00:00', 'lucy')
+        """
+    )
+
+    response = node.query(
+        """
+        ALTER TABLE test_update UPDATE m='2023-06-03 00:00:00' WHERE k=1
+        """
+    )
+
+    print("update response: ",  response)
+
+    response = TSV.toMat(node.query("SELECT k, m, n FROM test_update WHERE k=1 FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['1', '2023-06-03 00:00:00', 'lili'])
+
+    # can not update key
+    with pytest.raises(QueryRuntimeException):
+        node.query(
+            """
+            ALTER TABLE test_update UPDATE k=2 WHERE k=1
+            """
+        )
+
+
+def test_delete(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+
+    # clean all
+    client.flushall()
+    drop_table('test_delete')
+
+    node.query(
+        f"""
+        CREATE TABLE test_delete(
+            k UInt32, 
+            m DateTime,
+            n String
+        ) Engine=Redis('{address}', 0, 'clickhouse') PRIMARY KEY (k)
+        """
+    )
+
+    node.query(
+        """
+        INSERT INTO test_delete Values 
+        (1, '2023-06-01 00:00:00', 'lili'), (2, '2023-06-02 00:00:00', 'lucy')
+        """
+    )
+
+    response = node.query(
+        """
+        ALTER TABLE test_delete DELETE WHERE k=1
+        """
+    )
+
+    print("delete response: ",  response)
+
+    response = TSV.toMat(node.query("SELECT k, m, n FROM test_delete FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['2', '2023-06-02 00:00:00', 'lucy'])
+
+    response = node.query(
+        """
+        ALTER TABLE test_delete DELETE WHERE m='2023-06-02 00:00:00'
+        """
+    )
+
+    response = TSV.toMat(node.query("SELECT k, m, n FROM test_delete FORMAT TSV"))
+    assert (len(response) == 0)
+

From 010670457359862da5622baa24d50f0d5bf42557 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 16:31:06 +0800
Subject: [PATCH 180/722] add truncate to redis storage

---
 src/Storages/StorageRedis.cpp                | 11 +++---
 tests/integration/test_storage_redis/test.py | 37 ++++++++++++++++++++
 2 files changed, 43 insertions(+), 5 deletions(-)

diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index f9a25470e2d..dd33f6e6839 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -87,6 +87,7 @@ public:
         return storage.getBySerializedKeys(raw_keys, nullptr);
     }
 
+    /// TODO scan may get duplicated keys
     Chunk generateFullScan()
     {
         /// redis scan ending
@@ -480,17 +481,16 @@ SinkToStoragePtr StorageRedis::write(
     return std::make_shared<RedisSink>(*this, metadata_snapshot);
 }
 
-/// TODO use scan to reduce latency
 void StorageRedis::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
 {
     auto connection = getRedisConnection(pool, configuration);
 
     RedisCommand cmd_flush_db("FLUSHDB");
-    cmd_flush_db << toString(configuration.db_index);
-    auto ret = connection->client->execute<RedisBulkString>(cmd_flush_db);
+    cmd_flush_db.add("ASYNC");
+    auto ret = connection->client->execute<RedisSimpleString>(cmd_flush_db);
 
-    if (ret.isNull() || ret.value() != "OK")
-        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR, "Fail to truncate redis table {}, for {}", table_id.getFullNameNotQuoted(), ret.value());
+    if (ret != "OK")
+        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR, "Fail to truncate redis table {}, for {}", table_id.getFullNameNotQuoted(), ret);
 }
 
 void StorageRedis::checkMutationIsPossible(const MutationCommands & commands, const Settings & /* settings */) const
@@ -580,6 +580,7 @@ void StorageRedis::mutate(const MutationCommands & commands, ContextPtr context_
     }
 }
 
+/// TODO support ttl
 void registerStorageRedis(StorageFactory & factory)
 {
     StorageFactory::StorageFeatures features{
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index e77de99c649..ad1b0ada068 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -332,3 +332,40 @@ def test_delete(started_cluster):
     response = TSV.toMat(node.query("SELECT k, m, n FROM test_delete FORMAT TSV"))
     assert (len(response) == 0)
 
+
+def test_truncate(started_cluster):
+    client = get_redis_connection()
+    address = get_address_for_ch()
+    # clean all
+    client.flushall()
+    drop_table('test_truncate')
+
+    node.query(
+        f"""
+        CREATE TABLE test_truncate(
+            k UInt32, 
+            m DateTime,
+            n String
+        ) Engine=Redis('{address}', 0, 'clickhouse') PRIMARY KEY (k)
+        """
+    )
+
+    node.query(
+        """
+        INSERT INTO test_truncate Values 
+        (1, '2023-06-01 00:00:00', 'lili'), (2, '2023-06-02 00:00:00', 'lucy')
+        """
+    )
+
+    response = node.query(
+        """
+        TRUNCATE TABLE test_truncate
+        """
+    )
+
+    print("truncate table response: ",  response)
+
+    response = TSV.toMat(node.query("SELECT COUNT(*) FROM test_truncate FORMAT TSV"))
+    assert (len(response) == 1)
+    assert (response[0] == ['0'])
+

From bcf22c1ec79fad247be8c48f4bada508ef0d8063 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 18:15:38 +0800
Subject: [PATCH 181/722] fix code style

---
 src/Storages/RedisCommon.cpp                  |   2 -
 src/Storages/RedisCommon.h                    |   2 +-
 src/Storages/StorageRedis.cpp                 |   3 +-
 src/TableFunctions/TableFunctionRedis.cpp     |   3 -
 tests/integration/test_storage_redis/test.py  | 119 ++++++++++--------
 .../test_table_function_redis/test.py         |  34 ++---
 6 files changed, 89 insertions(+), 74 deletions(-)

diff --git a/src/Storages/RedisCommon.cpp b/src/Storages/RedisCommon.cpp
index ba7c02fdac5..a0534a9e23b 100644
--- a/src/Storages/RedisCommon.cpp
+++ b/src/Storages/RedisCommon.cpp
@@ -8,10 +8,8 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int INVALID_REDIS_TABLE_STRUCTURE;
     extern const int INTERNAL_REDIS_ERROR;
     extern const int TIMEOUT_EXCEEDED;
-    extern const int BAD_ARGUMENTS;
     extern const int INVALID_REDIS_STORAGE_TYPE;
 }
 
diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index 49c21c3277f..cf39be20ba9 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -54,7 +54,7 @@ using RedisClientPtr = std::unique_ptr<Poco::Redis::Client>;
 using RedisPool = BorrowedObjectPool<RedisClientPtr>;
 using RedisPoolPtr = std::shared_ptr<RedisPool>;
 
-/// Redis scan interator
+/// Redis scan iterator
 using RedisIterator = int64_t;
 
 struct RedisConnection
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index dd33f6e6839..b17528c7eae 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -25,7 +25,8 @@ namespace DB
 
 namespace ErrorCodes
 {
-    extern const int NOT_IMPLEMENTED;
+    extern const int BAD_ARGUMENTS;
+    extern const int LOGICAL_ERROR;
     extern const int INTERNAL_REDIS_ERROR;
 }
 
diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index 3db174fbcd8..bf147c08776 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -16,17 +16,14 @@
 #include <Interpreters/evaluateConstantExpression.h>
 
 
-
 namespace DB
 {
 
 namespace ErrorCodes
 {
     extern const int BAD_ARGUMENTS;
-    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
 }
 
-
 StoragePtr TableFunctionRedis::executeImpl(
     const ASTPtr & /*ast_function*/, ContextPtr context, const String & table_name, ColumnsDescription /*cached_columns*/) const
 {
diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index ad1b0ada068..66d34ebc711 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -24,17 +24,17 @@ def started_cluster():
 
 def get_redis_connection(db_id=0):
     client = redis.Redis(
-        host='localhost', port=cluster.redis_port, password="clickhouse", db=db_id
+        host="localhost", port=cluster.redis_port, password="clickhouse", db=db_id
     )
     return client
 
 
 def get_address_for_ch():
-    return cluster.redis_host + ':6379'
+    return cluster.redis_host + ":6379"
 
 
 def drop_table(table):
-    node.query(f"DROP TABLE IF EXISTS {table} SYNC");
+    node.query(f"DROP TABLE IF EXISTS {table} SYNC")
 
 
 # see SerializationString.serializeBinary
@@ -50,21 +50,21 @@ def serialize_binary_for_string(x):
         byte = length & 0x7F
         if length > 0x7F:
             byte |= 0x80
-        buf += (bytes([byte]))
+        buf += bytes([byte])
         length >>= 7
         if not length:
             break
     # write data
-    buf += x.encode('utf-8')
+    buf += x.encode("utf-8")
     return bytes(buf)
 
 
 # see SerializationNumber.serializeBinary
 def serialize_binary_for_uint32(x):
     buf = bytearray()
-    packed_num = struct.pack('I', x)
+    packed_num = struct.pack("I", x)
     buf += packed_num
-    if sys.byteorder != 'little':
+    if sys.byteorder != "little":
         buf.reverse()
     return bytes(buf)
 
@@ -75,7 +75,7 @@ def test_simple_select(started_cluster):
 
     # clean all
     client.flushall()
-    drop_table('test_simple_select')
+    drop_table("test_simple_select")
 
     data = {}
     for i in range(100):
@@ -95,13 +95,17 @@ def test_simple_select(started_cluster):
         """
     )
 
-    response = TSV.toMat(node.query("SELECT k, v FROM test_simple_select WHERE k='0' FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['0', '0'])
+    response = TSV.toMat(
+        node.query("SELECT k, v FROM test_simple_select WHERE k='0' FORMAT TSV")
+    )
+    assert len(response) == 1
+    assert response[0] == ["0", "0"]
 
-    response = TSV.toMat(node.query("SELECT * FROM test_simple_select ORDER BY k FORMAT TSV"))
-    assert (len(response) == 100)
-    assert (response[0] == ['0', '0'])
+    response = TSV.toMat(
+        node.query("SELECT * FROM test_simple_select ORDER BY k FORMAT TSV")
+    )
+    assert len(response) == 100
+    assert response[0] == ["0", "0"]
 
 
 def test_select_int(started_cluster):
@@ -110,7 +114,7 @@ def test_select_int(started_cluster):
 
     # clean all
     client.flushall()
-    drop_table('test_select_int')
+    drop_table("test_select_int")
 
     data = {}
     for i in range(100):
@@ -130,20 +134,25 @@ def test_select_int(started_cluster):
         """
     )
 
-    response = TSV.toMat(node.query("SELECT k, v FROM test_select_int WHERE k=0 FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['0', '0'])
+    response = TSV.toMat(
+        node.query("SELECT k, v FROM test_select_int WHERE k=0 FORMAT TSV")
+    )
+    assert len(response) == 1
+    assert response[0] == ["0", "0"]
+
+    response = TSV.toMat(
+        node.query("SELECT * FROM test_select_int ORDER BY k FORMAT TSV")
+    )
+    assert len(response) == 100
+    assert response[0] == ["0", "0"]
 
-    response = TSV.toMat(node.query("SELECT * FROM test_select_int ORDER BY k FORMAT TSV"))
-    assert (len(response) == 100)
-    assert (response[0] == ['0', '0'])
 
 
 def test_create_table(started_cluster):
     address = get_address_for_ch()
 
     # simple creation
-    drop_table('test_create_table')
+    drop_table("test_create_table")
     node.query(
         f"""
         CREATE TABLE test_create_table(
@@ -154,7 +163,7 @@ def test_create_table(started_cluster):
     )
 
     # simple creation with full engine args
-    drop_table('test_create_table')
+    drop_table("test_create_table")
     node.query(
         f"""
         CREATE TABLE test_create_table(
@@ -164,7 +173,7 @@ def test_create_table(started_cluster):
         """
     )
 
-    drop_table('test_create_table')
+    drop_table("test_create_table")
     node.query(
         f"""
         CREATE TABLE test_create_table(
@@ -175,7 +184,7 @@ def test_create_table(started_cluster):
         """
     )
 
-    drop_table('test_create_table')
+    drop_table("test_create_table")
     with pytest.raises(QueryRuntimeException):
         node.query(
             f"""
@@ -187,7 +196,7 @@ def test_create_table(started_cluster):
             """
         )
 
-    drop_table('test_create_table')
+    drop_table("test_create_table")
     with pytest.raises(QueryRuntimeException):
         node.query(
             f"""
@@ -226,19 +235,27 @@ def test_simple_insert(started_cluster):
     )
 
     response = node.query("SELECT COUNT(*) FROM test_simple_insert FORMAT Values")
-    assert (response == '(2)')
+    assert response == "(2)"
 
-    response = TSV.toMat(node.query("SELECT k, m, n FROM test_simple_insert WHERE k=1 FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['1', '2023-06-01 00:00:00', 'lili'])
+    response = TSV.toMat(
+        node.query("SELECT k, m, n FROM test_simple_insert WHERE k=1 FORMAT TSV")
+    )
+    assert len(response) == 1
+    assert response[0] == ["1", "2023-06-01 00:00:00", "lili"]
 
-    response = TSV.toMat(node.query("SELECT k, m, n FROM test_simple_insert WHERE m='2023-06-01 00:00:00' FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['1', '2023-06-01 00:00:00', 'lili'])
+    response = TSV.toMat(
+        node.query(
+            "SELECT k, m, n FROM test_simple_insert WHERE m='2023-06-01 00:00:00' FORMAT TSV"
+        )
+    )
+    assert len(response) == 1
+    assert response[0] == ["1", "2023-06-01 00:00:00", "lili"]
 
-    response = TSV.toMat(node.query("SELECT k, m, n FROM test_simple_insert WHERE n='lili' FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['1', '2023-06-01 00:00:00', 'lili'])
+    response = TSV.toMat(
+        node.query("SELECT k, m, n FROM test_simple_insert WHERE n='lili' FORMAT TSV")
+    )
+    assert len(response) == 1
+    assert response[0] == ["1", "2023-06-01 00:00:00", "lili"]
 
 
 def test_update(started_cluster):
@@ -246,7 +263,7 @@ def test_update(started_cluster):
     address = get_address_for_ch()
     # clean all
     client.flushall()
-    drop_table('test_update')
+    drop_table("test_update")
 
     node.query(
         f"""
@@ -271,11 +288,13 @@ def test_update(started_cluster):
         """
     )
 
-    print("update response: ",  response)
+    print("update response: ", response)
 
-    response = TSV.toMat(node.query("SELECT k, m, n FROM test_update WHERE k=1 FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['1', '2023-06-03 00:00:00', 'lili'])
+    response = TSV.toMat(
+        node.query("SELECT k, m, n FROM test_update WHERE k=1 FORMAT TSV")
+    )
+    assert len(response) == 1
+    assert response[0] == ["1", "2023-06-03 00:00:00", "lili"]
 
     # can not update key
     with pytest.raises(QueryRuntimeException):
@@ -292,7 +311,7 @@ def test_delete(started_cluster):
 
     # clean all
     client.flushall()
-    drop_table('test_delete')
+    drop_table("test_delete")
 
     node.query(
         f"""
@@ -317,11 +336,11 @@ def test_delete(started_cluster):
         """
     )
 
-    print("delete response: ",  response)
+    print("delete response: ", response)
 
     response = TSV.toMat(node.query("SELECT k, m, n FROM test_delete FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['2', '2023-06-02 00:00:00', 'lucy'])
+    assert len(response) == 1
+    assert response[0] == ["2", "2023-06-02 00:00:00", "lucy"]
 
     response = node.query(
         """
@@ -330,7 +349,7 @@ def test_delete(started_cluster):
     )
 
     response = TSV.toMat(node.query("SELECT k, m, n FROM test_delete FORMAT TSV"))
-    assert (len(response) == 0)
+    assert len(response) == 0
 
 
 def test_truncate(started_cluster):
@@ -338,7 +357,7 @@ def test_truncate(started_cluster):
     address = get_address_for_ch()
     # clean all
     client.flushall()
-    drop_table('test_truncate')
+    drop_table("test_truncate")
 
     node.query(
         f"""
@@ -363,9 +382,9 @@ def test_truncate(started_cluster):
         """
     )
 
-    print("truncate table response: ",  response)
+    print("truncate table response: ", response)
 
     response = TSV.toMat(node.query("SELECT COUNT(*) FROM test_truncate FORMAT TSV"))
-    assert (len(response) == 1)
-    assert (response[0] == ['0'])
+    assert len(response) == 1
+    assert esponse[0] == ["0"]
 
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
index 111276ec6dc..772e6d28141 100644
--- a/tests/integration/test_table_function_redis/test.py
+++ b/tests/integration/test_table_function_redis/test.py
@@ -25,13 +25,13 @@ def started_cluster():
 
 def get_redis_connection(db_id=0):
     client = redis.Redis(
-        host='localhost', port=cluster.redis_port, password="clickhouse", db=db_id
+        host="localhost", port=cluster.redis_port, password="clickhouse", db=db_id
     )
     return client
 
 
 def get_address_for_ch():
-    return cluster.redis_host + ':6379'
+    return cluster.redis_host + ":6379"
 
 
 # see SerializationString.serializeBinary
@@ -47,21 +47,21 @@ def serialize_binary_for_string(x):
         byte = length & 0x7F
         if length > 0x7F:
             byte |= 0x80
-        buf += (bytes([byte]))
+        buf += bytes([byte])
         length >>= 7
         if not length:
             break
     # write data
-    buf += x.encode('utf-8')
+    buf += x.encode("utf-8")
     return bytes(buf)
 
 
 # see SerializationNumber.serializeBinary
 def serialize_binary_for_uint32(x):
     buf = bytearray()
-    packed_num = struct.pack('I', x)
+    packed_num = struct.pack("I", x)
     buf += packed_num
-    if sys.byteorder != 'little':
+    if sys.byteorder != "little":
         buf.reverse()
     return bytes(buf)
 
@@ -92,8 +92,8 @@ def test_simple_select(started_cluster):
         FORMAT TSV
         """))
 
-    assert (len(response) == 1)
-    assert (response[0] == ['0', '0'])
+    assert len(response) == 1
+    assert response[0] == ["0", "0"]
 
     response = TSV.toMat(node.query(
         f"""
@@ -106,8 +106,8 @@ def test_simple_select(started_cluster):
         FORMAT TSV
         """))
 
-    assert (len(response) == 100)
-    assert (response[0] == ['0', '0'])
+    assert len(response) == 100
+    assert response[0] == ["0", "0"]
 
 
 def test_create_table(started_cluster):
@@ -153,7 +153,7 @@ def test_data_type(started_cluster):
 
     # string
     client.flushall()
-    value = serialize_binary_for_string('0')
+    value = serialize_binary_for_string("0")
     client.set(value, value)
 
     response = TSV.toMat(node.query(
@@ -167,8 +167,8 @@ def test_data_type(started_cluster):
         FORMAT TSV
         """))
 
-    assert (len(response) == 1)
-    assert (response[0] == ['0', '0'])
+    assert len(response) == 1
+    assert response[0] == ["0", "0"]
 
     # number
     client.flushall()
@@ -186,8 +186,8 @@ def test_data_type(started_cluster):
         FORMAT TSV
         """))
 
-    assert (len(response) == 1)
-    assert (response[0] == ['0', '0'])
+    assert len(response) == 1
+    assert response[0] == ["0", "0"]
 
     # datetime
     client.flushall()
@@ -208,5 +208,5 @@ def test_data_type(started_cluster):
         FORMAT TSV
         """))
 
-    assert (len(response) == 1)
-    assert (response[0] == ['2023-06-01 00:00:00', '2023-06-01 00:00:00'])
+    assert len(response) == 1
+    assert response[0] == ["2023-06-01 00:00:00", "2023-06-01 00:00:00"]

From 7cc37ab4b877dca8dcb76e328e39c8a62995cd0b Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 19:35:17 +0800
Subject: [PATCH 182/722] add redis table engine/function docs

---
 docs/en/engines/table-engines/index.md        |   1 +
 .../table-engines/integrations/index.md       |   1 +
 .../table-engines/integrations/redis.md       | 111 ++++++++++++++++++
 .../en/sql-reference/table-functions/redis.md |  67 +++++++++++
 4 files changed, 180 insertions(+)
 create mode 100644 docs/en/engines/table-engines/integrations/redis.md
 create mode 100644 docs/en/sql-reference/table-functions/redis.md

diff --git a/docs/en/engines/table-engines/index.md b/docs/en/engines/table-engines/index.md
index d7c582164de..bd704d0e87e 100644
--- a/docs/en/engines/table-engines/index.md
+++ b/docs/en/engines/table-engines/index.md
@@ -53,6 +53,7 @@ Engines in the family:
 - [JDBC](../../engines/table-engines/integrations/jdbc.md)
 - [MySQL](../../engines/table-engines/integrations/mysql.md)
 - [MongoDB](../../engines/table-engines/integrations/mongodb.md)
+- [Redis](../../engines/table-engines/integrations/redis.md)
 - [HDFS](../../engines/table-engines/integrations/hdfs.md)
 - [S3](../../engines/table-engines/integrations/s3.md)
 - [Kafka](../../engines/table-engines/integrations/kafka.md)
diff --git a/docs/en/engines/table-engines/integrations/index.md b/docs/en/engines/table-engines/integrations/index.md
index b321a644d32..93691a8adad 100644
--- a/docs/en/engines/table-engines/integrations/index.md
+++ b/docs/en/engines/table-engines/integrations/index.md
@@ -14,6 +14,7 @@ List of supported integrations:
 - [JDBC](../../../engines/table-engines/integrations/jdbc.md)
 - [MySQL](../../../engines/table-engines/integrations/mysql.md)
 - [MongoDB](../../../engines/table-engines/integrations/mongodb.md)
+- [Redis](../../../engines/table-engines/integrations/redis.md)
 - [HDFS](../../../engines/table-engines/integrations/hdfs.md)
 - [S3](../../../engines/table-engines/integrations/s3.md)
 - [Kafka](../../../engines/table-engines/integrations/kafka.md)
diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
new file mode 100644
index 00000000000..8e5a974c459
--- /dev/null
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -0,0 +1,111 @@
+---
+slug: /en/sql-reference/table-functions/redis
+sidebar_position: 43
+sidebar_label: Redis
+---
+
+# Redis
+
+This engine allows integrating ClickHouse with [Redis](https://redis.io/).
+
+## Creating a Table {#creating-a-table}
+
+``` sql
+CREATE TABLE [IF NOT EXISTS] [db.]table_name
+(
+    name1 [type1],
+    name2 [type2],
+    ...
+) ENGINE = Redis(host:port[, db_index[, password[, pool_size]]]) PRIMARY KEY(primary_key_name);
+```
+
+**Engine Parameters**
+
+- `host:port` — Redis server address, you can ignore port and default Redis port 6379 will be used.
+
+- `db_index` — Redis db index range from 0 to 15, default is 0.
+
+- `password` — User password, default is blank string.
+
+- `pool_size` — Redis max connection pool size, default is 16.
+
+- `primary_key_name` - any column name in the column list.
+
+- `primary` must be specified, it supports only one column in the primary key. The primary key will be serialized in binary as a Redis key.
+
+- columns other than the primary key will be serialized in binary as Redis value in corresponding order.
+  
+- queries with key equals or in filtering will be optimized to multi keys lookup from Redis. If queries without filtering key full table scan will happen which is a heavy operation.
+
+## Usage Example {#usage-example}
+
+Create a table in ClickHouse which allows to read data from Redis:
+
+``` sql
+CREATE TABLE redis_table
+(
+    `k` String,
+    `m` String,
+    `n` UInt32
+)
+ENGINE = Redis('redis1:6379') PRIMARY KEY(k);
+```
+
+Insert:
+
+```sql
+INSERT INTO redis_table Values('1', 1, '1', 1.0), ('2', 2, '2', 2.0);
+```
+
+Query:
+
+``` sql
+SELECT COUNT(*) FROM redis_table;
+```
+
+``` text
+┌─count()─┐
+│       2 │
+└─────────┘
+```
+
+``` sql
+SELECT * FROM redis_table WHERE key='1';
+```
+
+```text
+┌─key─┬─v1─┬─v2─┬─v3─┐
+│ 1   │  1 │ 1  │  1 │
+└─────┴────┴────┴────┘
+```
+
+``` sql
+SELECT * FROM redis_table WHERE v1=2;
+```
+
+```text
+┌─key─┬─v1─┬─v2─┬─v3─┐
+│ 2   │  2 │ 2  │  2 │
+└─────┴────┴────┴────┘
+```
+
+Update:
+
+Note that the primary key cannot be updated.
+
+```sql
+ALTER TABLE redis_table UPDATE v1=2 WHERE key='1';
+```
+
+Delete:
+
+```sql
+ALTER TABLE redis_table DELETE WHERE key='1';
+```
+
+Truncate:
+
+Redis engine will flush db asynchronously.
+```sql
+TRUNCATE TABLE redis_table;
+```
diff --git a/docs/en/sql-reference/table-functions/redis.md b/docs/en/sql-reference/table-functions/redis.md
new file mode 100644
index 00000000000..5b32f118fb8
--- /dev/null
+++ b/docs/en/sql-reference/table-functions/redis.md
@@ -0,0 +1,67 @@
+---
+slug: /en/sql-reference/table-functions/redis
+sidebar_position: 10
+sidebar_label: Redis
+---
+
+# Redis
+
+This table function allows integrating ClickHouse with [Redis](https://redis.io/).
+
+**Syntax**
+
+```sql
+redis(host:port, key, structure[, db_index[, password[, pool_size]]])
+```
+
+**Arguments**
+
+- `host:port` — Redis server address, you can ignore port and default Redis port 6379 will be used.
+
+- `key` — any column name in the column list.
+
+- `structure` — The schema for the ClickHouse table returned from this function.
+
+- `db_index` — Redis db index range from 0 to 15, default is 0.
+
+- `password` — User password, default is blank string.
+
+- `pool_size` — Redis max connection pool size, default is 16.
+
+- `primary` must be specified, it supports only one column in the primary key. The primary key will be serialized in binary as a Redis key.
+
+- columns other than the primary key will be serialized in binary as Redis value in corresponding order.
+  
+- queries with key equals or in filtering will be optimized to multi keys lookup from Redis. If queries without filtering key full table scan will happen which is a heavy operation.
+
+
+**Returned Value**
+
+A table object with key as Redis key, other columns packaged together as Redis value.
+
+## Usage Example {#usage-example}
+
+Create a table in ClickHouse which allows to read data from Redis:
+
+``` sql
+CREATE TABLE redis_table
+(
+    `k` String,
+    `m` String,
+    `n` UInt32
+)
+ENGINE = Redis('redis1:6379') PRIMARY KEY(k);
+```
+
+```sql
+SELECT * FROM redis(
+    'redis1:6379',
+    'key',
+    'key String, v1 String, v2 UInt32'
+)
+```
+
+**See Also**
+
+- [The `Redis` table engine](/docs/en/engines/table-engines/integrations/redis.md)
+- [Using redis as a dictionary source](/docs/en/sql-reference/dictionaries/index.md#redis)

From 4302ba44d46107a7e72b5f31fa948b52b0c9c40b Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 20:32:34 +0800
Subject: [PATCH 183/722] fix code style

---
 tests/integration/test_storage_redis/test.py  |   6 +-
 .../test_table_function_redis/test.py         | 121 ++++++++++--------
 2 files changed, 71 insertions(+), 56 deletions(-)

diff --git a/tests/integration/test_storage_redis/test.py b/tests/integration/test_storage_redis/test.py
index 66d34ebc711..2fd97b9bebd 100644
--- a/tests/integration/test_storage_redis/test.py
+++ b/tests/integration/test_storage_redis/test.py
@@ -147,7 +147,6 @@ def test_select_int(started_cluster):
     assert response[0] == ["0", "0"]
 
 
-
 def test_create_table(started_cluster):
     address = get_address_for_ch()
 
@@ -215,7 +214,7 @@ def test_simple_insert(started_cluster):
 
     # clean all
     client.flushall()
-    drop_table('test_simple_insert')
+    drop_table("test_simple_insert")
 
     node.query(
         f"""
@@ -386,5 +385,4 @@ def test_truncate(started_cluster):
 
     response = TSV.toMat(node.query("SELECT COUNT(*) FROM test_truncate FORMAT TSV"))
     assert len(response) == 1
-    assert esponse[0] == ["0"]
-
+    assert response[0] == ["0"]
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
index 772e6d28141..8e9dd66d9e5 100644
--- a/tests/integration/test_table_function_redis/test.py
+++ b/tests/integration/test_table_function_redis/test.py
@@ -81,30 +81,36 @@ def test_simple_select(started_cluster):
     client.mset(data)
     client.close()
 
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT 
-            key, value 
-        FROM 
-            redis('{address}', 'key', 'key String, value String', 0, 'clickhouse', 10) 
-        WHERE 
-            key='0' 
-        FORMAT TSV
-        """))
+    response = TSV.toMat(
+        node.query(
+            f"""
+            SELECT 
+                key, value 
+            FROM 
+                redis('{address}', 'key', 'key String, value String', 0, 'clickhouse', 10) 
+            WHERE 
+                key='0' 
+            FORMAT TSV
+            """
+        )
+    )
 
     assert len(response) == 1
     assert response[0] == ["0", "0"]
 
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT 
-            * 
-        FROM 
-            redis('{address}', 'key', 'key String, value String', 0, 'clickhouse', 10) 
-        ORDER BY 
-            key 
-        FORMAT TSV
-        """))
+    response = TSV.toMat(
+        node.query(
+            f"""
+            SELECT 
+                * 
+            FROM 
+                redis('{address}', 'key', 'key String, value String', 0, 'clickhouse', 10) 
+            ORDER BY 
+                key 
+            FORMAT TSV
+            """
+        )
+    )
 
     assert len(response) == 100
     assert response[0] == ["0", "0"]
@@ -124,7 +130,8 @@ def test_create_table(started_cluster):
             *
         FROM 
             redis('{address}', 'k', 'k String, v UInt32', 0, 'clickhouse', 10) 
-        """)
+        """
+    )
 
     # illegal data type
     with pytest.raises(QueryRuntimeException):
@@ -134,7 +141,8 @@ def test_create_table(started_cluster):
                 *
             FROM 
                 redis('{address}', 'k', 'k not_exist_type, v String', 0, 'clickhouse', 10) 
-            """)
+            """
+        )
 
     # illegal key
     with pytest.raises(QueryRuntimeException):
@@ -156,16 +164,19 @@ def test_data_type(started_cluster):
     value = serialize_binary_for_string("0")
     client.set(value, value)
 
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT
-            *
-        FROM
-            redis('{address}', 'k', 'k String, v String', 0, 'clickhouse', 10)
-        WHERE
-            k='0'
-        FORMAT TSV
-        """))
+    response = TSV.toMat(
+        node.query(
+            f"""
+            SELECT
+                *
+            FROM
+                redis('{address}', 'k', 'k String, v String', 0, 'clickhouse', 10)
+            WHERE
+                k='0'
+            FORMAT TSV
+            """
+        )
+    )
 
     assert len(response) == 1
     assert response[0] == ["0", "0"]
@@ -175,16 +186,19 @@ def test_data_type(started_cluster):
     value = serialize_binary_for_uint32(0)
     client.set(value, value)
 
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT
-            *
-        FROM
-            redis('{address}', 'k', 'k UInt32, v UInt32', 0, 'clickhouse', 10)
-        WHERE
-            k=0
-        FORMAT TSV
-        """))
+    response = TSV.toMat(
+        node.query(
+            f"""
+            SELECT
+                *
+            FROM
+                redis('{address}', 'k', 'k UInt32, v UInt32', 0, 'clickhouse', 10)
+            WHERE
+                k=0
+            FORMAT TSV
+            """
+        )
+    )
 
     assert len(response) == 1
     assert response[0] == ["0", "0"]
@@ -197,16 +211,19 @@ def test_data_type(started_cluster):
     value = serialize_binary_for_uint32(int(seconds_since_epoch))
     client.set(value, value)
 
-    response = TSV.toMat(node.query(
-        f"""
-        SELECT
-            *
-        FROM
-            redis('{address}', 'k', 'k DateTime, v DateTime', 0, 'clickhouse', 10)
-        WHERE
-            k='2023-06-01 00:00:00'
-        FORMAT TSV
-        """))
+    response = TSV.toMat(
+        node.query(
+            f"""
+            SELECT
+                *
+            FROM
+                redis('{address}', 'k', 'k DateTime, v DateTime', 0, 'clickhouse', 10)
+            WHERE
+                k='2023-06-01 00:00:00'
+            FORMAT TSV
+            """
+        )
+    )
 
     assert len(response) == 1
     assert response[0] == ["2023-06-01 00:00:00", "2023-06-01 00:00:00"]

From 119c2200a95563e6814042618c4f3365bf7386fb Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 22:23:09 +0800
Subject: [PATCH 184/722] fix merged error

---
 src/Storages/StorageRedis.cpp                    | 16 ++++++++++------
 .../test_table_function_redis/test.py            |  3 ++-
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index b17528c7eae..973a77a5f98 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -520,14 +520,16 @@ void StorageRedis::mutate(const MutationCommands & commands, ContextPtr context_
 
     if (commands.front().type == MutationCommand::Type::DELETE)
     {
+        MutationsInterpreter::Settings settings(true);
+        settings.return_all_columns = true;
+        settings.return_mutated_rows = true;
+
         auto interpreter = std::make_unique<MutationsInterpreter>(
             storage_ptr,
             metadata_snapshot,
             commands,
             context_,
-            /*can_execute_*/ true,
-            /*return_all_columns_*/ true,
-            /*return_mutated_rows*/ true);
+            settings);
         auto pipeline = QueryPipelineBuilder::getPipeline(interpreter->execute());
         PullingPipelineExecutor executor(pipeline);
 
@@ -561,14 +563,16 @@ void StorageRedis::mutate(const MutationCommands & commands, ContextPtr context_
     if (commands.front().column_to_update_expression.contains(primary_key))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Primary key cannot be updated (cannot update column {})", primary_key);
 
+    MutationsInterpreter::Settings settings(true);
+    settings.return_all_columns = true;
+    settings.return_mutated_rows = true;
+
     auto interpreter = std::make_unique<MutationsInterpreter>(
         storage_ptr,
         metadata_snapshot,
         commands,
         context_,
-        /*can_execute_*/ true,
-        /*return_all_columns*/ true,
-        /*return_mutated_rows*/ true);
+        settings);
     auto pipeline = QueryPipelineBuilder::getPipeline(interpreter->execute());
     PullingPipelineExecutor executor(pipeline);
 
diff --git a/tests/integration/test_table_function_redis/test.py b/tests/integration/test_table_function_redis/test.py
index 8e9dd66d9e5..f4bcebe2f90 100644
--- a/tests/integration/test_table_function_redis/test.py
+++ b/tests/integration/test_table_function_redis/test.py
@@ -152,7 +152,8 @@ def test_create_table(started_cluster):
                 *
             FROM 
                 redis('{address}', 'not_exist_key', 'k not_exist_type, v String', 0, 'clickhouse', 10) 
-            """)
+            """
+        )
 
 
 def test_data_type(started_cluster):

From e6d1b3c35141d7f20e17fd1b823df4c86b7f6c29 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 31 May 2023 23:55:41 +0800
Subject: [PATCH 185/722] little fix

---
 src/Dictionaries/RedisDictionarySource.cpp |   2 +-
 src/Dictionaries/RedisSource.cpp           |   2 +-
 src/Storages/StorageRedis.cpp              | 113 ++++++++-------------
 3 files changed, 45 insertions(+), 72 deletions(-)

diff --git a/src/Dictionaries/RedisDictionarySource.cpp b/src/Dictionaries/RedisDictionarySource.cpp
index c52c3425d1b..1736cdff306 100644
--- a/src/Dictionaries/RedisDictionarySource.cpp
+++ b/src/Dictionaries/RedisDictionarySource.cpp
@@ -41,7 +41,7 @@ namespace DB
                 .host = host,
                 .port = static_cast<UInt16>(port),
                 .db_index = config.getUInt(redis_config_prefix + ".db_index", DEFAULT_REDIS_DB_INDEX),
-                .password = config.getString(redis_config_prefix + ".password", ""),
+                .password = config.getString(redis_config_prefix + ".password", DEFAULT_REDIS_PASSWORD),
                 .storage_type = parseStorageType(config.getString(redis_config_prefix + ".storage_type", "")),
                 .pool_size = config.getUInt(redis_config_prefix + ".pool_size", DEFAULT_REDIS_POOL_SIZE),
             };
diff --git a/src/Dictionaries/RedisSource.cpp b/src/Dictionaries/RedisSource.cpp
index 5d8a475cad4..719c0278707 100644
--- a/src/Dictionaries/RedisSource.cpp
+++ b/src/Dictionaries/RedisSource.cpp
@@ -21,7 +21,7 @@ namespace DB
     }
 
 
-        RedisSource::RedisSource(
+    RedisSource::RedisSource(
         RedisConnectionPtr connection_,
         const RedisArray & keys_,
         const RedisStorageType & storage_type_,
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 973a77a5f98..64e5c1ad5f7 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -1,24 +1,25 @@
-#include <Storages/StorageRedis.h>
-#include <Storages/StorageFactory.h>
-#include <Storages/NamedCollectionsHelpers.h>
-#include <Storages/KVStorageUtils.h>
-
 #include <unordered_set>
+#include <IO/WriteHelpers.h>
+#include <Interpreters/MutationsInterpreter.h>
+#include <Interpreters/evaluateConstantExpression.h>
+#include <Parsers/ASTCreateQuery.h>
 #include <Parsers/ASTLiteral.h>
+#include <Processors/Executors/PullingPipelineExecutor.h>
 #include <Processors/Sinks/SinkToStorage.h>
 #include <QueryPipeline/Pipe.h>
+#include <QueryPipeline/QueryPipelineBuilder.h>
+
+#include <Storages/KVStorageUtils.h>
+#include <Storages/KeyDescription.h>
+#include <Storages/NamedCollectionsHelpers.h>
+#include <Storages/StorageFactory.h>
+#include <Storages/StorageInMemoryMetadata.h>
+#include <Storages/StorageRedis.h>
+#include <Storages/checkAndGetLiteralArgument.h>
+
+#include <Common/Exception.h>
 #include <Common/logger_useful.h>
 #include <Common/parseAddress.h>
-#include <Common/Exception.h>
-#include <IO/WriteHelpers.h>
-#include <Parsers/ASTCreateQuery.h>
-#include <Interpreters/evaluateConstantExpression.h>
-#include <Interpreters/MutationsInterpreter.h>
-#include <Storages/checkAndGetLiteralArgument.h>
-#include <Storages/StorageInMemoryMetadata.h>
-#include <Storages/KeyDescription.h>
-#include <QueryPipeline/QueryPipelineBuilder.h>
-#include <Processors/Executors/PullingPipelineExecutor.h>
 
 namespace DB
 {
@@ -51,11 +52,7 @@ public:
     {
     }
 
-    RedisDataSource(
-        StorageRedis & storage_,
-        const Block & header,
-        const size_t max_block_size_,
-        const String & pattern_ = "*")
+    RedisDataSource(StorageRedis & storage_, const Block & header, const size_t max_block_size_, const String & pattern_ = "*")
         : ISource(header)
         , storage(storage_)
         , primary_key_pos(getPrimaryKeyPos(header, storage.getPrimaryKey()))
@@ -85,6 +82,7 @@ public:
 
         const auto & key_column_type = sample_block.getByName(storage.getPrimaryKey().at(0)).type;
         auto raw_keys = serializeKeysToRawString(it, end, key_column_type, max_block_size);
+
         return storage.getBySerializedKeys(raw_keys, nullptr);
     }
 
@@ -109,11 +107,11 @@ public:
         MutableColumns columns = sample_block.cloneEmptyColumns();
 
         RedisArray values = storage.multiGet(scan_keys);
-        for (size_t i = 0; i<scan_keys.size() && !values.get<RedisBulkString>(i).isNull(); i++)
+        for (size_t i = 0; i < scan_keys.size() && !values.get<RedisBulkString>(i).isNull(); i++)
         {
             fillColumns(scan_keys.get<RedisBulkString>(i).value(),
-                values.get<RedisBulkString>(i).value(),
-                primary_key_pos, sample_block, columns
+                        values.get<RedisBulkString>(i).value(),
+                        primary_key_pos, sample_block, columns
             );
         }
 
@@ -143,9 +141,7 @@ private:
 class RedisSink : public SinkToStorage
 {
 public:
-    RedisSink(
-        StorageRedis & storage_,
-        const StorageMetadataPtr & metadata_snapshot_);
+    RedisSink(StorageRedis & storage_, const StorageMetadataPtr & metadata_snapshot_);
 
     void consume(Chunk chunk) override;
     String getName() const override { return "RedisSink"; }
@@ -156,9 +152,7 @@ private:
     size_t primary_key_pos = 0;
 };
 
-RedisSink::RedisSink(
-    StorageRedis & storage_,
-    const StorageMetadataPtr & metadata_snapshot_)
+RedisSink::RedisSink(StorageRedis & storage_, const StorageMetadataPtr & metadata_snapshot_)
     : SinkToStorage(metadata_snapshot_->getSampleBlock())
     , storage(storage_)
     , metadata_snapshot(metadata_snapshot_)
@@ -194,6 +188,7 @@ void RedisSink::consume(Chunk chunk)
         data.add(wb_key.str());
         data.add(wb_value.str());
     }
+
     storage.multiSet(data);
 }
 
@@ -258,8 +253,8 @@ Pipe StorageRedis::read(
             size_t begin = num_keys * thread_idx / num_threads;
             size_t end = num_keys * (thread_idx + 1) / num_threads;
 
-            pipes.emplace_back(std::make_shared<RedisDataSource>(
-                *this, header, keys, keys->begin() + begin, keys->begin() + end, max_block_size));
+            pipes.emplace_back(
+                std::make_shared<RedisDataSource>(*this, header, keys, keys->begin() + begin, keys->begin() + end, max_block_size));
         }
         return Pipe::unitePipes(std::move(pipes));
     }
@@ -272,7 +267,7 @@ namespace
     {
         RedisConfiguration configuration;
 
-        if (engine_args.size() < 1)
+        if (engine_args.empty())
             throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad arguments count when creating Redis table engine");
 
         if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context))
@@ -336,18 +331,11 @@ namespace
             throw Exception(ErrorCodes::BAD_ARGUMENTS, "StorageRedis must require one column in primary key");
         }
 
-        return std::make_shared<StorageRedis>(
-            args.table_id,
-            configuration,
-            args.getContext(),
-            metadata,
-            primary_key_names[0]);
+        return std::make_shared<StorageRedis>(args.table_id, configuration, args.getContext(), metadata, primary_key_names[0]);
     }
 }
 
-Chunk StorageRedis::getBySerializedKeys(
-    const std::vector<std::string> & keys,
-    PaddedPODArray<UInt8> * null_map) const
+Chunk StorageRedis::getBySerializedKeys(const std::vector<std::string> & keys, PaddedPODArray<UInt8> * null_map) const
 {
     RedisArray redis_keys;
     for (const auto & key : keys)
@@ -355,9 +343,7 @@ Chunk StorageRedis::getBySerializedKeys(
     return getBySerializedKeys(redis_keys, null_map);
 }
 
-Chunk StorageRedis::getBySerializedKeys(
-    const RedisArray & keys,
-    PaddedPODArray<UInt8> * null_map) const
+Chunk StorageRedis::getBySerializedKeys(const RedisArray & keys, PaddedPODArray<UInt8> * null_map) const
 {
     Block sample_block = getInMemoryMetadataPtr()->getSampleBlock();
 
@@ -379,8 +365,8 @@ Chunk StorageRedis::getBySerializedKeys(
         if (!values.get<RedisBulkString>(i).isNull())
         {
             fillColumns(keys.get<RedisBulkString>(i).value(),
-                values.get<RedisBulkString>(i).value(),
-                primary_key_pos, sample_block, columns
+                        values.get<RedisBulkString>(i).value(),
+                        primary_key_pos, sample_block, columns
             );
         }
         else /// key not found
@@ -433,8 +419,7 @@ void StorageRedis::multiSet(const RedisArray & data) const
 
     auto ret = connection->client->execute<RedisSimpleString>(cmd_mget);
     if (ret != "OK")
-        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR, "Fail to write to redis table {}, for {}",
-                        table_id.getFullNameNotQuoted(), ret);
+        throw Exception(ErrorCodes::INTERNAL_REDIS_ERROR, "Fail to write to redis table {}, for {}", table_id.getFullNameNotQuoted(), ret);
 }
 
 RedisInteger StorageRedis::multiDelete(const RedisArray & keys) const
@@ -447,16 +432,17 @@ RedisInteger StorageRedis::multiDelete(const RedisArray & keys) const
 
     auto ret = connection->client->execute<RedisInteger>(cmd);
     if (ret != static_cast<RedisInteger>(keys.size()))
-        LOG_DEBUG(log, "Try to delete {} rows but actually deleted {} rows from redis table {}.",
-                  keys.size(), ret, table_id.getFullNameNotQuoted());
+        LOG_DEBUG(
+            log,
+            "Try to delete {} rows but actually deleted {} rows from redis table {}.",
+            keys.size(),
+            ret,
+            table_id.getFullNameNotQuoted());
 
     return ret;
 }
 
-Chunk StorageRedis::getByKeys(
-    const ColumnsWithTypeAndName & keys,
-    PaddedPODArray<UInt8> & null_map,
-    const Names &) const
+Chunk StorageRedis::getByKeys(const ColumnsWithTypeAndName & keys, PaddedPODArray<UInt8> & null_map, const Names &) const
 {
     if (keys.size() != 1)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "StorageRedis supports only one key, got: {}", keys.size());
@@ -474,10 +460,7 @@ Block StorageRedis::getSampleBlock(const Names &) const
     return getInMemoryMetadataPtr()->getSampleBlock();
 }
 
-SinkToStoragePtr StorageRedis::write(
-    const ASTPtr & /*query*/,
-    const StorageMetadataPtr & metadata_snapshot,
-    ContextPtr /*context*/)
+SinkToStoragePtr StorageRedis::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/)
 {
     return std::make_shared<RedisSink>(*this, metadata_snapshot);
 }
@@ -524,12 +507,7 @@ void StorageRedis::mutate(const MutationCommands & commands, ContextPtr context_
         settings.return_all_columns = true;
         settings.return_mutated_rows = true;
 
-        auto interpreter = std::make_unique<MutationsInterpreter>(
-            storage_ptr,
-            metadata_snapshot,
-            commands,
-            context_,
-            settings);
+        auto interpreter = std::make_unique<MutationsInterpreter>(storage_ptr, metadata_snapshot, commands, context_, settings);
         auto pipeline = QueryPipelineBuilder::getPipeline(interpreter->execute());
         PullingPipelineExecutor executor(pipeline);
 
@@ -567,12 +545,7 @@ void StorageRedis::mutate(const MutationCommands & commands, ContextPtr context_
     settings.return_all_columns = true;
     settings.return_mutated_rows = true;
 
-    auto interpreter = std::make_unique<MutationsInterpreter>(
-        storage_ptr,
-        metadata_snapshot,
-        commands,
-        context_,
-        settings);
+    auto interpreter = std::make_unique<MutationsInterpreter>(storage_ptr, metadata_snapshot, commands, context_, settings);
     auto pipeline = QueryPipelineBuilder::getPipeline(interpreter->execute());
     PullingPipelineExecutor executor(pipeline);
 

From dc6102392785f6368c13ea59a5c0f5273425567c Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 1 Jun 2023 14:36:03 +0800
Subject: [PATCH 186/722] add sync mode to redis storage truncate

---
 docs/en/engines/table-engines/integrations/redis.md    |  5 +++--
 src/Storages/StorageRedis.cpp                          | 10 ++++++++--
 .../02117_show_create_table_system.reference           |  6 +++---
 ...ll_new_table_functions_must_be_documented.reference |  2 +-
 4 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index 8e5a974c459..6cfc60c836c 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -105,7 +105,8 @@ ALTER TABLE redis_table DELETE WHERE key='1';
 
 Truncate:
 
-Redis engine will flush db asynchronously.
+Flush Redis db asynchronously. Also `Truncate` support SYNC mode.
+
 ```sql
-TRUNCATE TABLE redis_table;
+TRUNCATE TABLE redis_table SYNC;
 ```
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 64e5c1ad5f7..97f1dbce6da 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -8,6 +8,7 @@
 #include <Processors/Sinks/SinkToStorage.h>
 #include <QueryPipeline/Pipe.h>
 #include <QueryPipeline/QueryPipelineBuilder.h>
+#include <Parsers/ASTDropQuery.h>
 
 #include <Storages/KVStorageUtils.h>
 #include <Storages/KeyDescription.h>
@@ -465,12 +466,17 @@ SinkToStoragePtr StorageRedis::write(const ASTPtr & /*query*/, const StorageMeta
     return std::make_shared<RedisSink>(*this, metadata_snapshot);
 }
 
-void StorageRedis::truncate(const ASTPtr &, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
+void StorageRedis::truncate(const ASTPtr & query, const StorageMetadataPtr &, ContextPtr, TableExclusiveLockHolder &)
 {
     auto connection = getRedisConnection(pool, configuration);
 
+    auto * truncate_query = query->as<ASTDropQuery>();
+    assert(truncate_query != nullptr);
+
     RedisCommand cmd_flush_db("FLUSHDB");
-    cmd_flush_db.add("ASYNC");
+    if (!truncate_query->sync)
+        cmd_flush_db.add("ASYNC");
+
     auto ret = connection->client->execute<RedisSimpleString>(cmd_flush_db);
 
     if (ret != "OK")
diff --git a/tests/queries/0_stateless/02117_show_create_table_system.reference b/tests/queries/0_stateless/02117_show_create_table_system.reference
index 724118f7bc1..10149bfc7bf 100644
--- a/tests/queries/0_stateless/02117_show_create_table_system.reference
+++ b/tests/queries/0_stateless/02117_show_create_table_system.reference
@@ -297,7 +297,7 @@ CREATE TABLE system.grants
 (
     `user_name` Nullable(String),
     `role_name` Nullable(String),
-    `access_type` Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'Redis' = 151, 'MEILISEARCH' = 152, 'MYSQL' = 153, 'POSTGRES' = 154, 'SQLITE' = 155, 'ODBC' = 156, 'JDBC' = 157, 'HDFS' = 158, 'S3' = 159, 'HIVE' = 160, 'SOURCES' = 161, 'CLUSTER' = 162, 'ALL' = 163, 'NONE' = 164),
+    `access_type` Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'REDIS' = 151, 'MEILISEARCH' = 152, 'MYSQL' = 153, 'POSTGRES' = 154, 'SQLITE' = 155, 'ODBC' = 156, 'JDBC' = 157, 'HDFS' = 158, 'S3' = 159, 'HIVE' = 160, 'SOURCES' = 161, 'CLUSTER' = 162, 'ALL' = 163, 'NONE' = 164),
     `database` Nullable(String),
     `table` Nullable(String),
     `column` Nullable(String),
@@ -581,10 +581,10 @@ ENGINE = SystemPartsColumns
 COMMENT 'SYSTEM TABLE is built on the fly.'
 CREATE TABLE system.privileges
 (
-    `privilege` Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'MEILISEARCH' = 151, 'MYSQL' = 152, 'POSTGRES' = 153, 'SQLITE' = 154, 'ODBC' = 155, 'JDBC' = 156, 'HDFS' = 157, 'S3' = 158, 'HIVE' = 159, 'SOURCES' = 160, 'CLUSTER' = 161, 'ALL' = 162, 'NONE' = 163),
+    `privilege` Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'REDIS' = 151, 'MEILISEARCH' = 152, 'MYSQL' = 153, 'POSTGRES' = 154, 'SQLITE' = 155, 'ODBC' = 156, 'JDBC' = 157, 'HDFS' = 158, 'S3' = 159, 'HIVE' = 160, 'SOURCES' = 161, 'CLUSTER' = 162, 'ALL' = 163, 'NONE' = 164),
     `aliases` Array(String),
     `level` Nullable(Enum8('GLOBAL' = 0, 'DATABASE' = 1, 'TABLE' = 2, 'DICTIONARY' = 3, 'VIEW' = 4, 'COLUMN' = 5, 'NAMED_COLLECTION' = 6)),
-    `parent_group` Nullable(Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'MEILISEARCH' = 151, 'MYSQL' = 152, 'POSTGRES' = 153, 'SQLITE' = 154, 'ODBC' = 155, 'JDBC' = 156, 'HDFS' = 157, 'S3' = 158, 'HIVE' = 159, 'SOURCES' = 160, 'CLUSTER' = 161, 'ALL' = 162, 'NONE' = 163))
+    `parent_group` Nullable(Enum16('SHOW DATABASES' = 0, 'SHOW TABLES' = 1, 'SHOW COLUMNS' = 2, 'SHOW DICTIONARIES' = 3, 'SHOW' = 4, 'SHOW FILESYSTEM CACHES' = 5, 'SELECT' = 6, 'INSERT' = 7, 'ALTER UPDATE' = 8, 'ALTER DELETE' = 9, 'ALTER ADD COLUMN' = 10, 'ALTER MODIFY COLUMN' = 11, 'ALTER DROP COLUMN' = 12, 'ALTER COMMENT COLUMN' = 13, 'ALTER CLEAR COLUMN' = 14, 'ALTER RENAME COLUMN' = 15, 'ALTER MATERIALIZE COLUMN' = 16, 'ALTER COLUMN' = 17, 'ALTER MODIFY COMMENT' = 18, 'ALTER ORDER BY' = 19, 'ALTER SAMPLE BY' = 20, 'ALTER ADD INDEX' = 21, 'ALTER DROP INDEX' = 22, 'ALTER MATERIALIZE INDEX' = 23, 'ALTER CLEAR INDEX' = 24, 'ALTER INDEX' = 25, 'ALTER ADD PROJECTION' = 26, 'ALTER DROP PROJECTION' = 27, 'ALTER MATERIALIZE PROJECTION' = 28, 'ALTER CLEAR PROJECTION' = 29, 'ALTER PROJECTION' = 30, 'ALTER ADD CONSTRAINT' = 31, 'ALTER DROP CONSTRAINT' = 32, 'ALTER CONSTRAINT' = 33, 'ALTER TTL' = 34, 'ALTER MATERIALIZE TTL' = 35, 'ALTER SETTINGS' = 36, 'ALTER MOVE PARTITION' = 37, 'ALTER FETCH PARTITION' = 38, 'ALTER FREEZE PARTITION' = 39, 'ALTER DATABASE SETTINGS' = 40, 'ALTER NAMED COLLECTION' = 41, 'ALTER TABLE' = 42, 'ALTER DATABASE' = 43, 'ALTER VIEW REFRESH' = 44, 'ALTER VIEW MODIFY QUERY' = 45, 'ALTER VIEW' = 46, 'ALTER' = 47, 'CREATE DATABASE' = 48, 'CREATE TABLE' = 49, 'CREATE VIEW' = 50, 'CREATE DICTIONARY' = 51, 'CREATE TEMPORARY TABLE' = 52, 'CREATE ARBITRARY TEMPORARY TABLE' = 53, 'CREATE FUNCTION' = 54, 'CREATE NAMED COLLECTION' = 55, 'CREATE' = 56, 'DROP DATABASE' = 57, 'DROP TABLE' = 58, 'DROP VIEW' = 59, 'DROP DICTIONARY' = 60, 'DROP FUNCTION' = 61, 'DROP NAMED COLLECTION' = 62, 'DROP' = 63, 'UNDROP TABLE' = 64, 'TRUNCATE' = 65, 'OPTIMIZE' = 66, 'BACKUP' = 67, 'KILL QUERY' = 68, 'KILL TRANSACTION' = 69, 'MOVE PARTITION BETWEEN SHARDS' = 70, 'CREATE USER' = 71, 'ALTER USER' = 72, 'DROP USER' = 73, 'CREATE ROLE' = 74, 'ALTER ROLE' = 75, 'DROP ROLE' = 76, 'ROLE ADMIN' = 77, 'CREATE ROW POLICY' = 78, 'ALTER ROW POLICY' = 79, 'DROP ROW POLICY' = 80, 'CREATE QUOTA' = 81, 'ALTER QUOTA' = 82, 'DROP QUOTA' = 83, 'CREATE SETTINGS PROFILE' = 84, 'ALTER SETTINGS PROFILE' = 85, 'DROP SETTINGS PROFILE' = 86, 'SHOW USERS' = 87, 'SHOW ROLES' = 88, 'SHOW ROW POLICIES' = 89, 'SHOW QUOTAS' = 90, 'SHOW SETTINGS PROFILES' = 91, 'SHOW ACCESS' = 92, 'ACCESS MANAGEMENT' = 93, 'SHOW NAMED COLLECTIONS' = 94, 'SHOW NAMED COLLECTIONS SECRETS' = 95, 'NAMED COLLECTION CONTROL' = 96, 'SYSTEM SHUTDOWN' = 97, 'SYSTEM DROP DNS CACHE' = 98, 'SYSTEM DROP MARK CACHE' = 99, 'SYSTEM DROP UNCOMPRESSED CACHE' = 100, 'SYSTEM DROP MMAP CACHE' = 101, 'SYSTEM DROP QUERY CACHE' = 102, 'SYSTEM DROP COMPILED EXPRESSION CACHE' = 103, 'SYSTEM DROP FILESYSTEM CACHE' = 104, 'SYSTEM DROP SCHEMA CACHE' = 105, 'SYSTEM DROP S3 CLIENT CACHE' = 106, 'SYSTEM DROP CACHE' = 107, 'SYSTEM RELOAD CONFIG' = 108, 'SYSTEM RELOAD USERS' = 109, 'SYSTEM RELOAD SYMBOLS' = 110, 'SYSTEM RELOAD DICTIONARY' = 111, 'SYSTEM RELOAD MODEL' = 112, 'SYSTEM RELOAD FUNCTION' = 113, 'SYSTEM RELOAD EMBEDDED DICTIONARIES' = 114, 'SYSTEM RELOAD' = 115, 'SYSTEM RESTART DISK' = 116, 'SYSTEM MERGES' = 117, 'SYSTEM TTL MERGES' = 118, 'SYSTEM FETCHES' = 119, 'SYSTEM MOVES' = 120, 'SYSTEM DISTRIBUTED SENDS' = 121, 'SYSTEM REPLICATED SENDS' = 122, 'SYSTEM SENDS' = 123, 'SYSTEM REPLICATION QUEUES' = 124, 'SYSTEM DROP REPLICA' = 125, 'SYSTEM SYNC REPLICA' = 126, 'SYSTEM RESTART REPLICA' = 127, 'SYSTEM RESTORE REPLICA' = 128, 'SYSTEM WAIT LOADING PARTS' = 129, 'SYSTEM SYNC DATABASE REPLICA' = 130, 'SYSTEM SYNC TRANSACTION LOG' = 131, 'SYSTEM SYNC FILE CACHE' = 132, 'SYSTEM FLUSH DISTRIBUTED' = 133, 'SYSTEM FLUSH LOGS' = 134, 'SYSTEM FLUSH' = 135, 'SYSTEM THREAD FUZZER' = 136, 'SYSTEM UNFREEZE' = 137, 'SYSTEM FAILPOINT' = 138, 'SYSTEM' = 139, 'dictGet' = 140, 'displaySecretsInShowAndSelect' = 141, 'addressToLine' = 142, 'addressToLineWithInlines' = 143, 'addressToSymbol' = 144, 'demangle' = 145, 'INTROSPECTION' = 146, 'FILE' = 147, 'URL' = 148, 'REMOTE' = 149, 'MONGO' = 150, 'REDIS' = 151, 'MEILISEARCH' = 152, 'MYSQL' = 153, 'POSTGRES' = 154, 'SQLITE' = 155, 'ODBC' = 156, 'JDBC' = 157, 'HDFS' = 158, 'S3' = 159, 'HIVE' = 160, 'SOURCES' = 161, 'CLUSTER' = 162, 'ALL' = 163, 'NONE' = 164))
 )
 ENGINE = SystemPrivileges
 COMMENT 'SYSTEM TABLE is built on the fly.'
diff --git a/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference b/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference
index 4f16e57d606..bc83e626207 100644
--- a/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference
+++ b/tests/queries/0_stateless/02414_all_new_table_functions_must_be_documented.reference
@@ -9,11 +9,11 @@ jdbc
 meilisearch
 merge
 mongodb
-redis
 null
 numbers
 numbers_mt
 odbc
+redis
 remote
 remoteSecure
 url

From ee363920f804107c6b8d96b746364cb252c6ae8e Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 1 Jun 2023 15:34:21 +0800
Subject: [PATCH 187/722] fix fast test

---
 tests/queries/0_stateless/01271_show_privileges.reference | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/queries/0_stateless/01271_show_privileges.reference b/tests/queries/0_stateless/01271_show_privileges.reference
index 5ada21e31f4..2c98b8cc190 100644
--- a/tests/queries/0_stateless/01271_show_privileges.reference
+++ b/tests/queries/0_stateless/01271_show_privileges.reference
@@ -148,6 +148,7 @@ INTROSPECTION	['INTROSPECTION FUNCTIONS']	\N	ALL
 FILE	[]	GLOBAL	SOURCES
 URL	[]	GLOBAL	SOURCES
 REMOTE	[]	GLOBAL	SOURCES
+MONGO	[]	GLOBAL	SOURCES
 REDIS	[]	GLOBAL	SOURCES
 MEILISEARCH	[]	GLOBAL	SOURCES
 MYSQL	[]	GLOBAL	SOURCES

From ef6fde8264557a737fdc47a0486805f07b489abd Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Thu, 1 Jun 2023 19:28:13 +0800
Subject: [PATCH 188/722] fix build error for dwrwin

---
 src/Storages/RedisCommon.h | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Storages/RedisCommon.h b/src/Storages/RedisCommon.h
index cf39be20ba9..4cc358e6536 100644
--- a/src/Storages/RedisCommon.h
+++ b/src/Storages/RedisCommon.h
@@ -3,6 +3,7 @@
 #include <Poco/Redis/Client.h>
 #include <Poco/Redis/Command.h>
 #include <Poco/Redis/Array.h>
+#include <Poco/Types.h>
 
 #include <Core/Defines.h>
 #include <base/BorrowedObjectPool.h>
@@ -48,7 +49,7 @@ using RedisArray = Poco::Redis::Array;
 using RedisArrayPtr = std::shared_ptr<RedisArray>;
 using RedisBulkString = Poco::Redis::BulkString;
 using RedisSimpleString = String;
-using RedisInteger = Int64;
+using RedisInteger = Poco::Int64;
 
 using RedisClientPtr = std::unique_ptr<Poco::Redis::Client>;
 using RedisPool = BorrowedObjectPool<RedisClientPtr>;

From b01db870d8335ea0bdc9f4462b42c61c389774f7 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Fri, 2 Jun 2023 10:04:16 +0800
Subject: [PATCH 189/722] normalize redis table function db name

---
 src/TableFunctions/TableFunctionRedis.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/TableFunctions/TableFunctionRedis.cpp b/src/TableFunctions/TableFunctionRedis.cpp
index bf147c08776..ec659ae61e0 100644
--- a/src/TableFunctions/TableFunctionRedis.cpp
+++ b/src/TableFunctions/TableFunctionRedis.cpp
@@ -32,8 +32,9 @@ StoragePtr TableFunctionRedis::executeImpl(
     StorageInMemoryMetadata metadata;
     metadata.setColumns(columns);
 
+    String db_name = "redis" + getDatabaseName() + "_db_" + toString(configuration.db_index);
     auto storage = std::make_shared<StorageRedis>(
-        StorageID(toString(configuration.db_index), table_name), configuration, context, metadata, primary_key);
+        StorageID(db_name, table_name), configuration, context, metadata, primary_key);
     storage->startup();
     return storage;
 }

From 8a10baec7f73d1e40fbd018daed0f1786d95442a Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 2 Jun 2023 06:25:00 +0000
Subject: [PATCH 190/722] Add dateTime range check

---
 src/Functions/FunctionsConversion.h           | 38 +++++++++----------
 .../01556_accurate_cast_or_null.reference     |  1 +
 .../01556_accurate_cast_or_null.sql           |  5 ++-
 .../0_stateless/01601_accurate_cast.sql       |  4 +-
 4 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index d77090afe71..d5b5f6ae28a 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -365,6 +365,12 @@ template <typename Name> struct ConvertImpl<DataTypeDate32, DataTypeDateTime, Na
 
 /// Implementation of toDate function.
 
+template <typename FromType>
+static bool CheckDateRange(const FromType & value)
+{
+    return value >= 0 && value <= DATE_LUT_MAX_DAY_NUM;
+}
+
 template <typename FromType, typename ToType>
 struct ToDateTransform32Or64
 {
@@ -372,7 +378,7 @@ struct ToDateTransform32Or64
 
     static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
-        return from >= 0;
+        return CheckDateRange(from);
     }
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
@@ -391,7 +397,7 @@ struct ToDateTransform32Or64Signed
 
     static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
-        return from >= 0;
+        return CheckDateRange(from);
     }
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
@@ -413,7 +419,7 @@ struct ToDateTransform8Or16Signed
 
     static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
-        return from >= 0;
+        return CheckDateRange(from);
     }
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
@@ -434,11 +440,6 @@ struct ToDate32Transform32Or64
 {
     static constexpr auto name = "toDate32";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return from >= 0;
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         return (from < DATE_LUT_MAX_EXTEND_DAY_NUM)
@@ -452,11 +453,6 @@ struct ToDate32Transform32Or64Signed
 {
     static constexpr auto name = "toDate32";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return from >= 0;
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         static const Int32 daynum_min_offset = -static_cast<Int32>(DateLUT::instance().getDayNumOffsetEpoch());
@@ -473,11 +469,6 @@ struct ToDate32Transform8Or16Signed
 {
     static constexpr auto name = "toDate32";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return from >= 0;
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         return from;
@@ -527,6 +518,11 @@ template <typename Name> struct ConvertImpl<DataTypeFloat32, DataTypeDate32, Nam
 template <typename Name> struct ConvertImpl<DataTypeFloat64, DataTypeDate32, Name, ConvertDefaultBehaviorTag>
     : DateTimeTransformImpl<DataTypeFloat64, DataTypeDate32, ToDate32Transform32Or64Signed<Float64, Int32>> {};
 
+template <typename FromType>
+static bool CheckDateTimeRange(const FromType & value)
+{
+    return value >= 0 && value <= 0xFFFFFFFF;
+}
 
 template <typename FromType, typename ToType>
 struct ToDateTimeTransform64
@@ -535,7 +531,7 @@ struct ToDateTimeTransform64
 
     static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
-        return from >= 0;
+        return CheckDateTimeRange(from);
     }
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
@@ -551,7 +547,7 @@ struct ToDateTimeTransformSigned
 
     static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
-        return from >= 0;
+        return CheckDateTimeRange(from);
     }
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
@@ -569,7 +565,7 @@ struct ToDateTimeTransform64Signed
 
     static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
     {
-        return from >= 0;
+        return CheckDateTimeRange(from);
     }
 
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
index cbdf72e9910..21faa830636 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
@@ -32,6 +32,7 @@
 \N
 \N
 \N
+\N
 2023-05-30 14:38:20
 1970-01-01 00:00:19
 \N
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
index a9038a1d230..3f57358576e 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
@@ -37,9 +37,10 @@ SELECT accurateCastOrNull(nan, 'UInt256');
 SELECT accurateCastOrNull(number + 127, 'Int8') AS x FROM numbers (2) ORDER BY x;
 
 SELECT accurateCastOrNull(-1, 'DateTime');
+SELECT accurateCastOrNull(5000000000, 'DateTime');
 SELECT accurateCastOrNull('1xxx', 'DateTime');
-SELECT accurateCastOrNull('2023-05-30 14:38:20', 'DateTime');
-SELECT accurateCastOrNull(19, 'DateTime');
+select toString(accurateCastOrNull('2023-05-30 14:38:20', 'DateTime'), timezone());
+SELECT toString(accurateCastOrNull(19, 'DateTime'), 'UTC');
 
 SELECT accurateCastOrNull(-1, 'Date');
 SELECT accurateCastOrNull('1xxx', 'Date');
diff --git a/tests/queries/0_stateless/01601_accurate_cast.sql b/tests/queries/0_stateless/01601_accurate_cast.sql
index 7611b1d96b9..f7f4d588ccc 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.sql
+++ b/tests/queries/0_stateless/01601_accurate_cast.sql
@@ -24,11 +24,13 @@ SELECT accurateCast('123', 'FixedString(2)'); -- { serverError 131 }
 SELECT accurateCast('12', 'FixedString(2)');
 
 SELECT accurateCast(-1, 'DateTime');   -- { serverError 70 }
+SELECT accurateCast(5000000000, 'DateTime');   -- { serverError 70 }
 SELECT accurateCast('1xxx', 'DateTime');   -- { serverError 41 }
 SELECT accurateCast('2023-05-30 14:38:20', 'DateTime');
-SELECT accurateCast(19, 'DateTime');
+SELECT toString(accurateCast(19, 'DateTime'), 'UTC');
 
 SELECT accurateCast(-1, 'Date');   -- { serverError 70 }
+SELECT accurateCast(999999, 'Date');   -- { serverError 70 }
 SELECT accurateCast('1xxx', 'Date');   -- { serverError 38 }
 SELECT accurateCast('2023-05-30', 'Date');
 SELECT accurateCast(19, 'Date');

From c7088a8180a245311885899e702e668719159123 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 2 Jun 2023 07:26:55 +0000
Subject: [PATCH 191/722] Trying to fix build

---
 src/Functions/FunctionsConversion.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index d5b5f6ae28a..6aa5843ff65 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -521,7 +521,7 @@ template <typename Name> struct ConvertImpl<DataTypeFloat64, DataTypeDate32, Nam
 template <typename FromType>
 static bool CheckDateTimeRange(const FromType & value)
 {
-    return value >= 0 && value <= 0xFFFFFFFF;
+    return value >= 0 && value <= 0xFFFFFFFFL;
 }
 
 template <typename FromType, typename ToType>

From 2f08b6738f307c7e04886a879632e1183b40b725 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Thu, 1 Jun 2023 18:34:00 +0200
Subject: [PATCH 192/722] Support parallel replicas with the analyzer

---
 src/Storages/StorageReplicatedMergeTree.cpp   | 15 ++++--
 ...02771_parallel_replicas_analyzer.reference | 12 +++++
 .../02771_parallel_replicas_analyzer.sql      | 52 +++++++++++++++++++
 3 files changed, 75 insertions(+), 4 deletions(-)
 create mode 100644 tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference
 create mode 100644 tests/queries/0_stateless/02771_parallel_replicas_analyzer.sql

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 56896f88423..893e976d432 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -77,16 +77,17 @@
 #include <IO/Operators.h>
 #include <IO/ConnectionTimeouts.h>
 
-#include <Interpreters/ClusterProxy/executeQuery.h>
 #include <Interpreters/ClusterProxy/SelectStreamFactory.h>
+#include <Interpreters/ClusterProxy/executeQuery.h>
 #include <Interpreters/Context.h>
 #include <Interpreters/DDLTask.h>
 #include <Interpreters/InterpreterAlterQuery.h>
 #include <Interpreters/InterpreterSelectQuery.h>
+#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
 #include <Interpreters/InterserverCredentials.h>
+#include <Interpreters/JoinedTables.h>
 #include <Interpreters/PartLog.h>
 #include <Interpreters/SelectQueryOptions.h>
-#include <Interpreters/JoinedTables.h>
 
 
 #include <Backups/BackupEntriesCollector.h>
@@ -4707,8 +4708,14 @@ void StorageReplicatedMergeTree::read(
 
         auto cluster = local_context->getCluster(local_context->getSettingsRef().cluster_for_parallel_replicas);
 
-        Block header =
-            InterpreterSelectQuery(modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze()).getSampleBlock();
+        Block header;
+
+        if (local_context->getSettingsRef().allow_experimental_analyzer)
+            header = InterpreterSelectQueryAnalyzer::getSampleBlock(
+                modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze());
+        else
+            header
+                = InterpreterSelectQuery(modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze()).getSampleBlock();
 
         ClusterProxy::SelectStreamFactory select_stream_factory =
             ClusterProxy::SelectStreamFactory(
diff --git a/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference b/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference
new file mode 100644
index 00000000000..4e93c530f7b
--- /dev/null
+++ b/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference
@@ -0,0 +1,12 @@
+-8888150036649430454
+-2788931093724180887
+-75175454385331084
+368066018677693974
+821735343441964030
+2804162938822577320
+4357435422797280898
+5935810273536892891
+7885388429666205427
+8124171311239967992
+1	1	-- Simple query with analyzer and pure parallel replicas\nSELECT number\nFROM join_inner_table__fuzz_146_replicated\n    SETTINGS\n    allow_experimental_analyzer = 1,\n    max_parallel_replicas = 2,\n    cluster_for_parallel_replicas = \'test_cluster_one_shard_three_replicas_localhost\',\n    allow_experimental_parallel_reading_from_replicas = 1,\n    use_hedged_requests = 0;
+0	2	SELECT `default`.`join_inner_table__fuzz_146_replicated`.`number` AS `number` FROM `default`.`join_inner_table__fuzz_146_replicated`
diff --git a/tests/queries/0_stateless/02771_parallel_replicas_analyzer.sql b/tests/queries/0_stateless/02771_parallel_replicas_analyzer.sql
new file mode 100644
index 00000000000..35089c0cedb
--- /dev/null
+++ b/tests/queries/0_stateless/02771_parallel_replicas_analyzer.sql
@@ -0,0 +1,52 @@
+-- Tags: zookeeper
+
+CREATE TABLE join_inner_table__fuzz_146_replicated
+(
+    `id` UUID,
+    `key` String,
+    `number` Int64,
+    `value1` String,
+    `value2` String,
+    `time` Nullable(Int64)
+)
+ENGINE = ReplicatedMergeTree('/clickhouse/tables/{database}/join_inner_table__fuzz_146_replicated', '{replica}')
+ORDER BY (id, number, key)
+SETTINGS index_granularity = 8192;
+
+INSERT INTO join_inner_table__fuzz_146_replicated
+    SELECT CAST('833c9e22-c245-4eb5-8745-117a9a1f26b1', 'UUID') AS id, CAST(rowNumberInAllBlocks(), 'String') AS key, *
+    FROM generateRandom('number Int64, value1 String, value2 String, time Int64', 1, 10, 2) LIMIT 10;
+
+-- Simple query with analyzer and pure parallel replicas
+SELECT number
+FROM join_inner_table__fuzz_146_replicated
+    SETTINGS
+    allow_experimental_analyzer = 1,
+    max_parallel_replicas = 2,
+    cluster_for_parallel_replicas = 'test_cluster_one_shard_three_replicas_localhost',
+    allow_experimental_parallel_reading_from_replicas = 1,
+    use_hedged_requests = 0;
+
+SYSTEM FLUSH LOGS;
+-- There should be 2 different queries
+-- The initial query
+-- The query sent to each replica (which should appear 2 times as we are setting max_parallel_replicas to 2)
+SELECT
+        is_initial_query,
+        count() as c, query,
+FROM system.query_log
+WHERE
+        event_date >= yesterday()
+  AND type = 'QueryFinish'
+  AND initial_query_id =
+      (
+          SELECT query_id
+          FROM system.query_log
+          WHERE
+                  current_database = currentDatabase()
+            AND event_date >= yesterday()
+            AND type = 'QueryFinish'
+            AND query LIKE '-- Simple query with analyzer and pure parallel replicas%'
+      )
+GROUP BY is_initial_query, query
+ORDER BY is_initial_query DESC, c, query;

From fa5f890a7ad43fde1cd75d6c07170a6df3ec119d Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 2 Jun 2023 12:03:50 +0000
Subject: [PATCH 193/722] Added ru function descriptions (docs)

---
 .../functions/type-conversion-functions.md    |  2 +-
 .../functions/type-conversion-functions.md    | 86 +++++++++++++++++++
 src/Functions/DateTimeTransforms.h            |  7 +-
 3 files changed, 92 insertions(+), 3 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index a6fc6cd4dfc..eb210863c32 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -383,7 +383,7 @@ toDateTimeOrDefault(expr, [, time_zone [, default_value]])
 **Arguments**
 
 - `expr` — The value. [String](/docs/en/sql-reference/data-types/string.md), [Int](/docs/en/sql-reference/data-types/int-uint.md), [Date](/docs/en/sql-reference/data-types/date.md) or [DateTime](/docs/en/sql-reference/data-types/datetime.md). 
-- `time_zone` — Time zone.
+- `time_zone` — Time zone. [String](/docs/en/sql-reference/data-types/string.md).
 - `default_value` — The default value. [DateTime](/docs/en/sql-reference/data-types/datetime.md) 
 
 If `expr` is a number, it is interpreted as the number of seconds since the beginning of the Unix Epoch (as Unix timestamp).
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index 298b7bbc93e..67d1732d34e 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -173,6 +173,49 @@ Cиноним: `DATE`.
 
 ## toDateOrDefault {#todateordefault}
 
+Конвертирует аргумент в значение [Date](/docs/ru/sql-reference/data-types/date.md) data type. 
+Если получен недопустимый аргумент, то возвращает значение по умолчанию (нижняя граница [Date](/docs/ru/sql-reference/data-types/date.md). Значение по умолчанию может быть указано вторым аргументом.
+Похожа на [toDate](#todate).
+
+**Синтаксис**
+
+``` sql
+toDateOrDefault(expr [, default_value])
+```
+
+**Аргументы**
+
+- `expr` — Значение для преобразования. [String](/docs/ru/sql-reference/data-types/string.md), [Int](/docs/ru/sql-reference/data-types/int-uint.md), [Date](/docs/ru/sql-reference/data-types/date.md) или [DateTime](/docs/ru/sql-reference/data-types/datetime.md). 
+- `default_value` — Значение по умолчанию. [Date](/docs/ru/sql-reference/data-types/date.md) 
+
+Если `expr` является числом выглядит как UNIX timestamp (больше чем 65535), оно интерпретируется как DateTime, затем обрезается до Date учитывавая текущую часовой пояс. Если `expr` является числом и меньше чем 65536, оно интерпретируется как количество дней с 1970-01-01.
+
+**Возвращаемое значение**
+
+- Календарная дата. [Date](/docs/ru/sql-reference/data-types/date.md).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT
+    toDateOrDefault('2021-01-01', '2023-01-01'::Date),
+    toDateOrDefault('xx2021-01-01', '2023-01-01'::Date);
+```
+
+Результат:
+
+```response
+┌─toDateOrDefault('2021-01-01', CAST('2023-01-01', 'Date'))─┬─toDateOrDefault('xx2021-01-01', CAST('2023-01-01', 'Date'))─┐
+│                                                2021-01-01 │                                                  2023-01-01 │
+└───────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────┘
+```
+
+**Смотрите также**
+- [toDate](#todate)
+- [toDate32OrDefault](#todate32ordefault)
+
 ## toDateTime {#todatetime}
 
 ## toDateTimeOrZero {#todatetimeorzero}
@@ -181,6 +224,49 @@ Cиноним: `DATE`.
 
 ## toDateTimeOrDefault {#todatetimeordefault}
 
+Конвертирует аргумент в значение [DateTime](/docs/ru/sql-reference/data-types/datetime.md). 
+Если получен недопустимый аргумент, то возвращает значение по умолчанию (нижняя граница [DateTime](/docs/ru/sql-reference/data-types/datetime.md)). Значение по умолчанию может быть указано третьим аргументом.
+Похожа на [toDateTime](#todatetime).
+
+**Синтаксис**
+
+``` sql
+toDateTimeOrDefault(expr, [, time_zone [, default_value]])
+```
+
+**Аргументы**
+
+- `expr` — Значение для преобразования. [String](/docs/ru/sql-reference/data-types/string.md), [Int](/docs/ru/sql-reference/data-types/int-uint.md), [Date](/docs/ru/sql-reference/data-types/date.md) или [DateTime](/docs/ru/sql-reference/data-types/datetime.md). 
+- `time_zone` — Часовой пояс. [String](/docs/ru/sql-reference/data-types/string.md).
+- `default_value` — Значение по умолчанию. [DateTime](/docs/ru/sql-reference/data-types/datetime.md) 
+
+Если `expr` является числом, оно интерпретируется как количество секунд от начала unix эпохи.
+
+**Возвращаемое значение**
+
+- Время. [DateTime](/docs/ru/sql-reference/data-types/datetime.md)
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT
+    toDateTimeOrDefault('2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC')),
+    toDateTimeOrDefault('xx2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC'));
+```
+
+Результат:
+
+```response
+┌─toDateTimeOrDefault('2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┬─toDateTimeOrDefault('xx2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
+│                                                               2021-01-01 00:00:00 │                                                                 2023-01-01 00:00:00 │
+└───────────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────┘
+```
+
+**Смотрите также**
+- [toDateTime](#todatetime)
+
 ## toDate32 {#todate32}
 
 Конвертирует аргумент в значение типа [Date32](../../sql-reference/data-types/date32.md). Если значение выходит за границы диапазона, возвращается пограничное значение `Date32`. Если аргумент имеет тип [Date](../../sql-reference/data-types/date.md), учитываются границы типа `Date`.
diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 9f8f4df2465..d154dd9ffa2 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -1520,9 +1520,12 @@ struct DateTimeTransformImpl
                 Op::vector(sources->getData(), col_to->getData(), time_zone, transform, vec_null_map_to);
             }
 
-            if (vec_null_map_to)
+            if constexpr (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
             {
-                return ColumnNullable::create(std::move(mutable_result_col), std::move(col_null_map_to));
+                if (vec_null_map_to)
+                {
+                    return ColumnNullable::create(std::move(mutable_result_col), std::move(col_null_map_to));
+                }
             }
 
             return mutable_result_col;

From c1958c8bed68529c04c37a4b81d139088da3f2f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Fri, 2 Jun 2023 14:24:32 +0200
Subject: [PATCH 194/722] Remove 02764_parallel_replicas_plain_merge_tree from
 list of broken tests

---
 tests/broken_tests.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index 02935712325..96219323700 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -135,6 +135,5 @@
 02703_row_policy_for_database
 02721_url_cluster
 02534_s3_cluster_insert_select_schema_inference
-02764_parallel_replicas_plain_merge_tree
 02765_parallel_replicas_final_modifier
 

From 897325967841cbd24de32f3a136ceb26385b75b9 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 2 Jun 2023 15:00:24 +0000
Subject: [PATCH 195/722] Test attach gdb in stateless tests

---
 docker/test/stateless/run.sh | 39 ++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index 5d0a7b50741..dfee7d84cde 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -85,6 +85,45 @@ fi
 
 sleep 5
 
+# Set follow-fork-mode to parent, because we attach to clickhouse-server, not to watchdog
+# and clickhouse-server can do fork-exec, for example, to run some bridge.
+# Do not set nostop noprint for all signals, because some it may cause gdb to hang,
+# explicitly ignore non-fatal signals that are used by server.
+# Number of SIGRTMIN can be determined only in runtime.
+RTMIN=$(kill -l SIGRTMIN)
+echo "
+set follow-fork-mode parent
+handle SIGHUP nostop noprint pass
+handle SIGINT nostop noprint pass
+handle SIGQUIT nostop noprint pass
+handle SIGPIPE nostop noprint pass
+handle SIGTERM nostop noprint pass
+handle SIGUSR1 nostop noprint pass
+handle SIGUSR2 nostop noprint pass
+handle SIG$RTMIN nostop noprint pass
+info signals
+continue
+backtrace full
+thread apply all backtrace full
+info registers
+disassemble /s
+up
+disassemble /s
+up
+disassemble /s
+p \"done\"
+detach
+quit
+" > script.gdb
+
+# FIXME Hung check may work incorrectly because of attached gdb
+# 1. False positives are possible
+# 2. We cannot attach another gdb to get stacktraces if some queries hung
+gdb -batch -command script.gdb -p "$(cat /var/run/clickhouse-server/clickhouse-server.pid)" | ts '%Y-%m-%d %H:%M:%S' >> /test_output/gdb.log &
+sleep 5
+# gdb will send SIGSTOP, spend some time loading debug info and then send SIGCONT, wait for it (up to send_timeout, 300s)
+time clickhouse-client --query "SELECT 'Connected to clickhouse-server after attaching gdb'" ||:
+
 function run_tests()
 {
     set -x

From 423afec70542c266187d49cf571d5f6bb4324977 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Fri, 2 Jun 2023 10:05:38 -0700
Subject: [PATCH 196/722] Change case and function name for MySQL Compatible
 types

This changes the function name for MySQL Compatible types from getMySQLName to getSQLCompatibleName and changes the casing of the types to upper
---
 src/DataTypes/DataTypeAggregateFunction.h     |   2 +-
 src/DataTypes/DataTypeArray.h                 |   4 +-
 src/DataTypes/DataTypeDate.h                  |   2 +-
 src/DataTypes/DataTypeDate32.h                |   2 +-
 src/DataTypes/DataTypeDateTime.h              |   2 +-
 src/DataTypes/DataTypeDateTime64.h            |   2 +-
 src/DataTypes/DataTypeEnum.cpp                |   2 +-
 src/DataTypes/DataTypeEnum.h                  |   2 +-
 src/DataTypes/DataTypeFixedString.h           |   2 +-
 src/DataTypes/DataTypeFunction.h              |   2 +-
 src/DataTypes/DataTypeIPv4andIPv6.h           |   4 +-
 src/DataTypes/DataTypeInterval.h              |   2 +-
 src/DataTypes/DataTypeLowCardinality.cpp      |   2 +-
 src/DataTypes/DataTypeLowCardinality.h        |   2 +-
 src/DataTypes/DataTypeMap.h                   |   2 +-
 src/DataTypes/DataTypeNothing.h               |   2 +-
 src/DataTypes/DataTypeNullable.h              |   2 +-
 src/DataTypes/DataTypeNumberBase.cpp          |  28 +-
 src/DataTypes/DataTypeNumberBase.h            |   2 +-
 src/DataTypes/DataTypeObject.h                |   2 +-
 src/DataTypes/DataTypeSet.h                   |   2 +-
 src/DataTypes/DataTypeString.h                |   2 +-
 src/DataTypes/DataTypeTuple.h                 |   2 +-
 src/DataTypes/DataTypeUUID.h                  |   2 +-
 src/DataTypes/DataTypesDecimal.h              |   4 +-
 src/DataTypes/IDataType.h                     |   4 +-
 ...show_columns_mysql_compatibility.reference | 424 +++++++++---------
 .../02775_show_columns_mysql_compatibility.sh |   6 +-
 28 files changed, 260 insertions(+), 256 deletions(-)

diff --git a/src/DataTypes/DataTypeAggregateFunction.h b/src/DataTypes/DataTypeAggregateFunction.h
index 697be13652c..13ca3508580 100644
--- a/src/DataTypes/DataTypeAggregateFunction.h
+++ b/src/DataTypes/DataTypeAggregateFunction.h
@@ -45,7 +45,7 @@ public:
     String doGetName() const override;
     String getNameWithoutVersion() const;
     const char * getFamilyName() const override { return "AggregateFunction"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
     TypeIndex getTypeId() const override { return TypeIndex::AggregateFunction; }
 
     Array getParameters() const { return parameters; }
diff --git a/src/DataTypes/DataTypeArray.h b/src/DataTypes/DataTypeArray.h
index b031f411975..528062b60be 100644
--- a/src/DataTypes/DataTypeArray.h
+++ b/src/DataTypes/DataTypeArray.h
@@ -30,9 +30,9 @@ public:
     {
         return "Array";
     }
-    const char * getMySQLName() const override
+    const char * getSQLCompatibleName() const override
     {
-        return "text";
+        return "TEXT";
     }
 
     bool canBeInsideNullable() const override
diff --git a/src/DataTypes/DataTypeDate.h b/src/DataTypes/DataTypeDate.h
index 33bcb6123ff..7b622ae04a3 100644
--- a/src/DataTypes/DataTypeDate.h
+++ b/src/DataTypes/DataTypeDate.h
@@ -13,7 +13,7 @@ public:
 
     TypeIndex getTypeId() const override { return TypeIndex::Date; }
     const char * getFamilyName() const override { return family_name; }
-    const char * getMySQLName() const override { return "date"; }
+    const char * getSQLCompatibleName() const override { return "DATE"; }
 
     bool canBeUsedAsVersion() const override { return true; }
     bool canBeInsideNullable() const override { return true; }
diff --git a/src/DataTypes/DataTypeDate32.h b/src/DataTypes/DataTypeDate32.h
index 56315f46e8c..65b0ec7407e 100644
--- a/src/DataTypes/DataTypeDate32.h
+++ b/src/DataTypes/DataTypeDate32.h
@@ -13,7 +13,7 @@ public:
 
     TypeIndex getTypeId() const override { return TypeIndex::Date32; }
     const char * getFamilyName() const override { return family_name; }
-    const char * getMySQLName() const override { return "date"; }
+    const char * getSQLCompatibleName() const override { return "DATE"; }
 
     Field getDefault() const override
     {
diff --git a/src/DataTypes/DataTypeDateTime.h b/src/DataTypes/DataTypeDateTime.h
index c868f92c311..2facc758f90 100644
--- a/src/DataTypes/DataTypeDateTime.h
+++ b/src/DataTypes/DataTypeDateTime.h
@@ -36,7 +36,7 @@ public:
     static constexpr auto family_name = "DateTime";
 
     const char * getFamilyName() const override { return family_name; }
-    const char * getMySQLName() const override { return "datetime"; }
+    const char * getSQLCompatibleName() const override { return "DATETIME"; }
     String doGetName() const override;
     TypeIndex getTypeId() const override { return TypeIndex::DateTime; }
 
diff --git a/src/DataTypes/DataTypeDateTime64.h b/src/DataTypes/DataTypeDateTime64.h
index 8d317bb9430..b836b84918f 100644
--- a/src/DataTypes/DataTypeDateTime64.h
+++ b/src/DataTypes/DataTypeDateTime64.h
@@ -28,7 +28,7 @@ public:
     DataTypeDateTime64(UInt32 scale_, const TimezoneMixin & time_zone_info);
 
     const char * getFamilyName() const override { return family_name; }
-    const char * getMySQLName() const override { return "datetime"; }
+    const char * getSQLCompatibleName() const override { return "DATETIME"; }
     std::string doGetName() const override;
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeEnum.cpp b/src/DataTypes/DataTypeEnum.cpp
index bfed4d4d5a2..24a3976179d 100644
--- a/src/DataTypes/DataTypeEnum.cpp
+++ b/src/DataTypes/DataTypeEnum.cpp
@@ -41,7 +41,7 @@ std::string DataTypeEnum<Type>::generateMySQLName(const Values & values)
 {
     WriteBufferFromOwnString out;
 
-    writeString("enum", out);
+    writeString("ENUM", out);
     writeChar('(', out);
 
     auto first = true;
diff --git a/src/DataTypes/DataTypeEnum.h b/src/DataTypes/DataTypeEnum.h
index c6e523adf96..2cdaa2db06c 100644
--- a/src/DataTypes/DataTypeEnum.h
+++ b/src/DataTypes/DataTypeEnum.h
@@ -54,7 +54,7 @@ public:
 
     std::string doGetName() const override { return type_name; }
     const char * getFamilyName() const override;
-    const char * getMySQLName() const override { return my_sql_type_name.c_str(); }
+    const char * getSQLCompatibleName() const override { return my_sql_type_name.c_str(); }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeFixedString.h b/src/DataTypes/DataTypeFixedString.h
index eb09914ec9c..2900efd5a34 100644
--- a/src/DataTypes/DataTypeFixedString.h
+++ b/src/DataTypes/DataTypeFixedString.h
@@ -42,7 +42,7 @@ public:
     TypeIndex getTypeId() const override { return type_id; }
 
     const char * getFamilyName() const override { return "FixedString"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
 
     size_t getN() const
     {
diff --git a/src/DataTypes/DataTypeFunction.h b/src/DataTypes/DataTypeFunction.h
index f3423796126..df59f7738b2 100644
--- a/src/DataTypes/DataTypeFunction.h
+++ b/src/DataTypes/DataTypeFunction.h
@@ -24,7 +24,7 @@ public:
 
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Function"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
     TypeIndex getTypeId() const override { return TypeIndex::Function; }
 
     const DataTypes & getArgumentTypes() const
diff --git a/src/DataTypes/DataTypeIPv4andIPv6.h b/src/DataTypes/DataTypeIPv4andIPv6.h
index 8f7fe79793b..be0ebb90f3c 100644
--- a/src/DataTypes/DataTypeIPv4andIPv6.h
+++ b/src/DataTypes/DataTypeIPv4andIPv6.h
@@ -19,7 +19,7 @@ public:
     static constexpr auto type_id = TypeToTypeIndex<IPv4>;
 
     const char * getFamilyName() const override { return TypeName<IPv4>.data(); }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
@@ -61,7 +61,7 @@ public:
     static constexpr auto type_id = TypeToTypeIndex<IPv6>;
 
     const char * getFamilyName() const override { return TypeName<IPv6>.data(); }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeInterval.h b/src/DataTypes/DataTypeInterval.h
index 69a56e8aadd..ee2157431dd 100644
--- a/src/DataTypes/DataTypeInterval.h
+++ b/src/DataTypes/DataTypeInterval.h
@@ -26,7 +26,7 @@ public:
 
     std::string doGetName() const override { return fmt::format("Interval{}", kind.toString()); }
     const char * getFamilyName() const override { return "Interval"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
     TypeIndex getTypeId() const override { return TypeIndex::Interval; }
 
     bool equals(const IDataType & rhs) const override;
diff --git a/src/DataTypes/DataTypeLowCardinality.cpp b/src/DataTypes/DataTypeLowCardinality.cpp
index b1c32317015..e59613e6974 100644
--- a/src/DataTypes/DataTypeLowCardinality.cpp
+++ b/src/DataTypes/DataTypeLowCardinality.cpp
@@ -29,7 +29,7 @@ namespace ErrorCodes
 
 DataTypeLowCardinality::DataTypeLowCardinality(DataTypePtr dictionary_type_)
         : dictionary_type(std::move(dictionary_type_)),
-          mysql_name(dictionary_type->getMySQLName())
+          mysql_name(dictionary_type->getSQLCompatibleName())
 {
     auto inner_type = dictionary_type;
     if (dictionary_type->isNullable())
diff --git a/src/DataTypes/DataTypeLowCardinality.h b/src/DataTypes/DataTypeLowCardinality.h
index bcc39f58ff7..4dee8565568 100644
--- a/src/DataTypes/DataTypeLowCardinality.h
+++ b/src/DataTypes/DataTypeLowCardinality.h
@@ -24,7 +24,7 @@ public:
         return "LowCardinality(" + dictionary_type->getName() + ")";
     }
     const char * getFamilyName() const override { return "LowCardinality"; }
-    const char * getMySQLName() const override { return mysql_name.c_str(); }
+    const char * getSQLCompatibleName() const override { return mysql_name.c_str(); }
 
     TypeIndex getTypeId() const override { return TypeIndex::LowCardinality; }
 
diff --git a/src/DataTypes/DataTypeMap.h b/src/DataTypes/DataTypeMap.h
index 526dc321f44..299119f1759 100644
--- a/src/DataTypes/DataTypeMap.h
+++ b/src/DataTypes/DataTypeMap.h
@@ -30,7 +30,7 @@ public:
     TypeIndex getTypeId() const override { return TypeIndex::Map; }
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Map"; }
-    const char * getMySQLName() const override { return "json"; }
+    const char * getSQLCompatibleName() const override { return "JSON"; }
 
     bool canBeInsideNullable() const override { return false; }
 
diff --git a/src/DataTypes/DataTypeNothing.h b/src/DataTypes/DataTypeNothing.h
index fdef6026603..b35ced5dcb3 100644
--- a/src/DataTypes/DataTypeNothing.h
+++ b/src/DataTypes/DataTypeNothing.h
@@ -16,7 +16,7 @@ public:
     static constexpr bool is_parametric = false;
 
     const char * getFamilyName() const override { return "Nothing"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return TypeIndex::Nothing; }
 
diff --git a/src/DataTypes/DataTypeNullable.h b/src/DataTypes/DataTypeNullable.h
index 64b201d32b2..b5fe1bb2dd9 100644
--- a/src/DataTypes/DataTypeNullable.h
+++ b/src/DataTypes/DataTypeNullable.h
@@ -16,7 +16,7 @@ public:
     explicit DataTypeNullable(const DataTypePtr & nested_data_type_);
     std::string doGetName() const override { return "Nullable(" + nested_data_type->getName() + ")"; }
     const char * getFamilyName() const override { return "Nullable"; }
-    const char * getMySQLName() const override { return nested_data_type->getMySQLName(); }
+    const char * getSQLCompatibleName() const override { return nested_data_type->getSQLCompatibleName(); }
     TypeIndex getTypeId() const override { return TypeIndex::Nullable; }
 
     MutableColumnPtr createColumn() const override;
diff --git a/src/DataTypes/DataTypeNumberBase.cpp b/src/DataTypes/DataTypeNumberBase.cpp
index 7d200de7996..db654448e83 100644
--- a/src/DataTypes/DataTypeNumberBase.cpp
+++ b/src/DataTypes/DataTypeNumberBase.cpp
@@ -32,20 +32,20 @@ bool DataTypeNumberBase<T>::isValueRepresentedByUnsignedInteger() const
 
 template <typename T>
 const std::map<std::string, std::string> DataTypeNumberBase<T>::mysqlTypeMap = {
-    {"UInt8", "tinyint unsigned"},
-    {"UInt16", "smallint unsigned"},
-    {"UInt32", "mediumint unsigned"},
-    {"UInt64", "bigint unsigned"},
-    {"UInt128", "text"},
-    {"UInt256", "text"},
-    {"Int8", "tinyint"},
-    {"Int16", "smallint"},
-    {"Int32", "int"},
-    {"Int64", "bigint"},
-    {"Int128", "text"},
-    {"Int256", "text"},
-    {"Float32", "float"},
-    {"Float64", "double"},
+    {"UInt8", "TINYINT UNSIGNED"},
+    {"UInt16", "SMALLINT UNSIGNED"},
+    {"UInt32", "MEDIUMINT UNSIGNEd"},
+    {"UInt64", "BIGINT UNSIGNED"},
+    {"UInt128", "TEXT"},
+    {"UInt256", "TEXT"},
+    {"Int8", "TINYINT"},
+    {"Int16", "SMALLINT"},
+    {"Int32", "INT"},
+    {"Int64", "BIGINT"},
+    {"Int128", "TEXT"},
+    {"Int256", "TEXT"},
+    {"Float32", "FLOAT"},
+    {"Float64", "DOUBLE"},
 };
 
 /// Explicit template instantiations - to avoid code bloat in headers.
diff --git a/src/DataTypes/DataTypeNumberBase.h b/src/DataTypes/DataTypeNumberBase.h
index b5c963cf245..1a855a974f0 100644
--- a/src/DataTypes/DataTypeNumberBase.h
+++ b/src/DataTypes/DataTypeNumberBase.h
@@ -27,7 +27,7 @@ public:
     using ColumnType = ColumnVector<T>;
 
     const char * getFamilyName() const override { return TypeName<T>.data(); }
-    const char * getMySQLName() const override { return mysqlTypeMap.at(TypeName<T>.data()).c_str(); }
+    const char * getSQLCompatibleName() const override { return mysqlTypeMap.at(TypeName<T>.data()).c_str(); }
     TypeIndex getTypeId() const override { return TypeToTypeIndex<T>; }
 
     Field getDefault() const override;
diff --git a/src/DataTypes/DataTypeObject.h b/src/DataTypes/DataTypeObject.h
index 8a2c36abcd7..618c7389758 100644
--- a/src/DataTypes/DataTypeObject.h
+++ b/src/DataTypes/DataTypeObject.h
@@ -23,7 +23,7 @@ public:
     DataTypeObject(const String & schema_format_, bool is_nullable_);
 
     const char * getFamilyName() const override { return "Object"; }
-    const char * getMySQLName() const override { return "json"; }
+    const char * getSQLCompatibleName() const override { return "JSON"; }
     String doGetName() const override;
     TypeIndex getTypeId() const override { return TypeIndex::Object; }
 
diff --git a/src/DataTypes/DataTypeSet.h b/src/DataTypes/DataTypeSet.h
index bdad638b5d5..916b4f071a5 100644
--- a/src/DataTypes/DataTypeSet.h
+++ b/src/DataTypes/DataTypeSet.h
@@ -15,7 +15,7 @@ class DataTypeSet final : public IDataTypeDummy
 public:
     static constexpr bool is_parametric = true;
     const char * getFamilyName() const override { return "Set"; }
-    const char * getMySQLName() const override { return "text"; }
+    const char * getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return TypeIndex::Set; }
     bool equals(const IDataType & rhs) const override { return typeid(rhs) == typeid(*this); }
diff --git a/src/DataTypes/DataTypeString.h b/src/DataTypes/DataTypeString.h
index bddfb4ae287..338b3846266 100644
--- a/src/DataTypes/DataTypeString.h
+++ b/src/DataTypes/DataTypeString.h
@@ -22,7 +22,7 @@ public:
     }
 
     // FIXME: string can contain arbitrary bytes, not only UTF-8 sequences
-    const char * getMySQLName() const override { return "blob"; }
+    const char * getSQLCompatibleName() const override { return "BLOB"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeTuple.h b/src/DataTypes/DataTypeTuple.h
index d264cc97f60..93fa87b1332 100644
--- a/src/DataTypes/DataTypeTuple.h
+++ b/src/DataTypes/DataTypeTuple.h
@@ -33,7 +33,7 @@ public:
     TypeIndex getTypeId() const override { return TypeIndex::Tuple; }
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Tuple"; }
-    const char * getMySQLName() const override { return "json"; }
+    const char * getSQLCompatibleName() const override { return "JSON"; }
 
     bool canBeInsideNullable() const override { return false; }
     bool supportsSparseSerialization() const override { return true; }
diff --git a/src/DataTypes/DataTypeUUID.h b/src/DataTypes/DataTypeUUID.h
index 4d54db42b45..bbf35074df3 100644
--- a/src/DataTypes/DataTypeUUID.h
+++ b/src/DataTypes/DataTypeUUID.h
@@ -18,7 +18,7 @@ public:
     static constexpr auto type_id = TypeIndex::UUID;
 
     const char * getFamilyName() const override { return "UUID"; }
-    const char * getMySQLName() const override { return "char"; }
+    const char * getSQLCompatibleName() const override { return "CHAR"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypesDecimal.h b/src/DataTypes/DataTypesDecimal.h
index 5c9405cb060..6f3bf582aeb 100644
--- a/src/DataTypes/DataTypesDecimal.h
+++ b/src/DataTypes/DataTypesDecimal.h
@@ -37,10 +37,10 @@ public:
     using Base::Base;
 
     static constexpr auto family_name = "Decimal";
-    static constexpr auto mysql_name = "decimal";
+    static constexpr auto mysql_name = "DECIMAL";
 
     const char * getFamilyName() const override { return family_name; }
-    const char * getMySQLName() const override { return mysql_name; }
+    const char * getSQLCompatibleName() const override { return mysql_name; }
 
     std::string doGetName() const override;
     TypeIndex getTypeId() const override { return TypeToTypeIndex<T>; }
diff --git a/src/DataTypes/IDataType.h b/src/DataTypes/IDataType.h
index 2bed18897ce..93fdbab05ef 100644
--- a/src/DataTypes/IDataType.h
+++ b/src/DataTypes/IDataType.h
@@ -83,7 +83,7 @@ public:
 
     /// Name of data type family (example: FixedString, Array).
     virtual const char * getFamilyName() const = 0;
-    virtual const char * getMySQLName() const = 0;
+    virtual const char * getSQLCompatibleName() const = 0;
 
     /// Data type id. It's used for runtime type checks.
     virtual TypeIndex getTypeId() const = 0;
@@ -135,7 +135,7 @@ public:
 
 protected:
     virtual String doGetName() const { return getFamilyName(); }
-    virtual String doGetMySQLName() const { return getMySQLName(); }
+    virtual String doGetMySQLName() const { return getSQLCompatibleName(); }
     virtual SerializationPtr doGetDefaultSerialization() const = 0;
 
 public:
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
index 96e542611c6..1742cd9c90c 100644
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
@@ -4,226 +4,226 @@ Create pseudo-random database name
 Create tab duplicate table
 Run MySQL test
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	text	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+int32	INT	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	text	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+int32	INT	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra	collation	comment	privileges
-aggregate_function	text	0		NULL		NULL		
-array_value	text	0		NULL		NULL		
-boolean_value	tinyint unsigned	0		NULL		NULL		
-date32_value	date	0		NULL		NULL		
-date_value	date	0		NULL		NULL		
-datetime64_value	datetime	0		NULL		NULL		
-datetime_value	datetime	0		NULL		NULL		
-decimal_value	decimal	0		NULL		NULL		
-enum_value	enum('apple', 'banana', 'orange')	0		NULL		NULL		
-fixed_string_value	text	0		NULL		NULL		
-float32	float	0		NULL		NULL		
-float64	double	0		NULL		NULL		
-int32	int	0		NULL		NULL		
-ipv4_value	text	0		NULL		NULL		
-ipv6_value	text	0		NULL		NULL		
-json_value	json	0		NULL		NULL		
-low_cardinality	blob	0		NULL		NULL		
-low_cardinality_date	datetime	0		NULL		NULL		
-map_value	json	0		NULL		NULL		
-nested.nested_int	text	0		NULL		NULL		
-nested.nested_string	text	0		NULL		NULL		
-nullable_value	int	0		NULL		NULL		
-string_value	blob	0		NULL		NULL		
-tuple_value	json	0		NULL		NULL		
-uint64	bigint unsigned	0	PRI SOR	NULL		NULL		
-uuid_value	char	0		NULL		NULL		
+aggregate_function	TEXT	0		NULL		NULL		
+array_value	TEXT	0		NULL		NULL		
+boolean_value	TINYINT UNSIGNED	0		NULL		NULL		
+date32_value	DATE	0		NULL		NULL		
+date_value	DATE	0		NULL		NULL		
+datetime64_value	DATETIME	0		NULL		NULL		
+datetime_value	DATETIME	0		NULL		NULL		
+decimal_value	DECIMAL	0		NULL		NULL		
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL		NULL		
+fixed_string_value	TEXT	0		NULL		NULL		
+float32	FLOAT	0		NULL		NULL		
+float64	DOUBLE	0		NULL		NULL		
+int32	INT	0		NULL		NULL		
+ipv4_value	TEXT	0		NULL		NULL		
+ipv6_value	TEXT	0		NULL		NULL		
+json_value	JSON	0		NULL		NULL		
+low_cardinality	BLOB	0		NULL		NULL		
+low_cardinality_date	DATETIME	0		NULL		NULL		
+map_value	JSON	0		NULL		NULL		
+nested.nested_int	TEXT	0		NULL		NULL		
+nested.nested_string	TEXT	0		NULL		NULL		
+nullable_value	INT	0		NULL		NULL		
+string_value	BLOB	0		NULL		NULL		
+tuple_value	JSON	0		NULL		NULL		
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL		NULL		
+uuid_value	CHAR	0		NULL		NULL		
 field	type	null	key	default	extra
-int32	int	0		NULL	
-nested.nested_int	text	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
+int32	INT	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-int32	int	0		NULL	
-nested.nested_int	text	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
+int32	INT	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-int32	int	0		NULL	
-nested.nested_int	text	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
+int32	INT	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
+aggregate_function	TEXT	0		NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	text	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+int32	INT	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	text	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+int32	INT	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-aggregate_function	text	0		NULL	
-array_value	text	0		NULL	
-boolean_value	tinyint unsigned	0		NULL	
-date32_value	date	0		NULL	
-date_value	date	0		NULL	
-datetime64_value	datetime	0		NULL	
-datetime_value	datetime	0		NULL	
-decimal_value	decimal	0		NULL	
-enum_value	enum('apple', 'banana', 'orange')	0		NULL	
-fixed_string_value	text	0		NULL	
-float32	float	0		NULL	
-float64	double	0		NULL	
-int32	int	0		NULL	
-ipv4_value	text	0		NULL	
-ipv6_value	text	0		NULL	
-json_value	json	0		NULL	
-low_cardinality	blob	0		NULL	
-low_cardinality_date	datetime	0		NULL	
-map_value	json	0		NULL	
-nested.nested_int	text	0		NULL	
-nested.nested_string	text	0		NULL	
-nullable_value	int	0		NULL	
-string_value	blob	0		NULL	
-tuple_value	json	0		NULL	
-uint64	bigint unsigned	0	PRI SOR	NULL	
-uuid_value	char	0		NULL	
+aggregate_function	TEXT	0		NULL	
+array_value	TEXT	0		NULL	
+boolean_value	TINYINT UNSIGNED	0		NULL	
+date32_value	DATE	0		NULL	
+date_value	DATE	0		NULL	
+datetime64_value	DATETIME	0		NULL	
+datetime_value	DATETIME	0		NULL	
+decimal_value	DECIMAL	0		NULL	
+enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
+fixed_string_value	TEXT	0		NULL	
+float32	FLOAT	0		NULL	
+float64	DOUBLE	0		NULL	
+int32	INT	0		NULL	
+ipv4_value	TEXT	0		NULL	
+ipv6_value	TEXT	0		NULL	
+json_value	JSON	0		NULL	
+low_cardinality	BLOB	0		NULL	
+low_cardinality_date	DATETIME	0		NULL	
+map_value	JSON	0		NULL	
+nested.nested_int	TEXT	0		NULL	
+nested.nested_string	TEXT	0		NULL	
+nullable_value	INT	0		NULL	
+string_value	BLOB	0		NULL	
+tuple_value	JSON	0		NULL	
+uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uuid_value	CHAR	0		NULL	
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index a446c6e817e..fd1ad92f060 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -1,4 +1,8 @@
-#!/bin/bash
+#!/usr/bin/env bash
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
 
 # This script tests the MySQL compatibility of the SHOW COLUMNS command in ClickHouse
 USER="default"

From 97bd3f048316b421966b2e4d6ced8258808fdefe Mon Sep 17 00:00:00 2001
From: Amos Bird <amosbird@gmail.com>
Date: Mon, 22 May 2023 23:25:59 +0800
Subject: [PATCH 197/722] Proper mutation of skip indices and projections

---
 src/Interpreters/MutationsInterpreter.cpp     |  93 ++++-
 src/Interpreters/MutationsInterpreter.h       |   1 +
 src/Storages/MergeTree/IMergeTreeDataPart.cpp |  25 +-
 src/Storages/MergeTree/IMergeTreeDataPart.h   |   2 +-
 src/Storages/MergeTree/MergeTreeData.cpp      |  14 +-
 src/Storages/MergeTree/MergeTreeData.h        |   6 +-
 .../MergeTree/MergeTreeDataWriter.cpp         |  20 +-
 src/Storages/MergeTree/MutateTask.cpp         | 366 +++++++++---------
 src/Storages/StorageInMemoryMetadata.cpp      |  16 +-
 src/Storages/StorageInMemoryMetadata.h        |   9 +-
 ...ith_skip_indices_and_projections.reference |   0
 ...part_with_skip_indices_and_projections.sql |  31 ++
 12 files changed, 359 insertions(+), 224 deletions(-)
 create mode 100644 tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.reference
 create mode 100644 tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.sql

diff --git a/src/Interpreters/MutationsInterpreter.cpp b/src/Interpreters/MutationsInterpreter.cpp
index 713ebade1d5..791018a3f38 100644
--- a/src/Interpreters/MutationsInterpreter.cpp
+++ b/src/Interpreters/MutationsInterpreter.cpp
@@ -109,13 +109,16 @@ QueryTreeNodePtr prepareQueryAffectedQueryTree(const std::vector<MutationCommand
     return query_tree;
 }
 
-ColumnDependencies getAllColumnDependencies(const StorageMetadataPtr & metadata_snapshot, const NameSet & updated_columns)
+ColumnDependencies getAllColumnDependencies(
+    const StorageMetadataPtr & metadata_snapshot,
+    const NameSet & updated_columns,
+    const std::function<bool(const String & file_name)> & has_index_or_projection)
 {
     NameSet new_updated_columns = updated_columns;
     ColumnDependencies dependencies;
     while (!new_updated_columns.empty())
     {
-        auto new_dependencies = metadata_snapshot->getColumnDependencies(new_updated_columns, true);
+        auto new_dependencies = metadata_snapshot->getColumnDependencies(new_updated_columns, true, has_index_or_projection);
         new_updated_columns.clear();
         for (const auto & dependency : new_dependencies)
         {
@@ -288,6 +291,11 @@ bool MutationsInterpreter::Source::materializeTTLRecalculateOnly() const
     return data && data->getSettings()->materialize_ttl_recalculate_only;
 }
 
+bool MutationsInterpreter::Source::hasIndexOrProjection(const String & file_name) const
+{
+    return part && part->checksums.has(file_name);
+}
+
 static Names getAvailableColumnsWithVirtuals(StorageMetadataPtr metadata_snapshot, const IStorage & storage)
 {
     auto all_columns = metadata_snapshot->getColumns().getNamesOfPhysical();
@@ -524,8 +532,54 @@ void MutationsInterpreter::prepare(bool dry_run)
         validateUpdateColumns(source, metadata_snapshot, updated_columns, column_to_affected_materialized);
     }
 
+    for (const auto & [_, names] : column_to_affected_materialized)
+        updated_columns.insert(names.begin(), names.end());
+
+    std::function<bool(const String & file_name)> has_index_or_projection
+        = [&](const String & file_name) { return source.hasIndexOrProjection(file_name); };
+
     if (settings.recalculate_dependencies_of_updated_columns)
-        dependencies = getAllColumnDependencies(metadata_snapshot, updated_columns);
+        dependencies = getAllColumnDependencies(metadata_snapshot, updated_columns, has_index_or_projection);
+
+    for (const auto & index : metadata_snapshot->getSecondaryIndices())
+    {
+        if (source.hasIndexOrProjection("skp_idx_" + index.name + ".idx") || source.hasIndexOrProjection("skp_idx_" + index.name + ".idx2"))
+        {
+            // If some dependent columns gets mutated
+            bool mutate = false;
+            const auto & index_cols = index.expression->getRequiredColumns();
+            for (const auto & col : index_cols)
+            {
+                if (updated_columns.contains(col))
+                {
+                    mutate = true;
+                    break;
+                }
+            }
+            if (mutate)
+                materialized_indices.insert(index.name);
+        }
+    }
+
+    for (const auto & projection : metadata_snapshot->getProjections())
+    {
+        if (source.hasIndexOrProjection(projection.getDirectoryName()))
+        {
+            // If some dependent columns gets mutated
+            bool mutate = false;
+            const auto & projection_cols = projection.required_columns;
+            for (const auto & col : projection_cols)
+            {
+                if (updated_columns.contains(col))
+                {
+                    mutate = true;
+                    break;
+                }
+            }
+            if (mutate)
+                materialized_projections.insert(projection.name);
+        }
+    }
 
     std::vector<String> read_columns;
     /// First, break a sequence of commands into stages.
@@ -680,20 +734,27 @@ void MutationsInterpreter::prepare(bool dry_run)
             if (it == std::cend(indices_desc))
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unknown index: {}", command.index_name);
 
-            auto query = (*it).expression_list_ast->clone();
-            auto syntax_result = TreeRewriter(context).analyze(query, all_columns);
-            const auto required_columns = syntax_result->requiredSourceColumns();
-            for (const auto & column : required_columns)
-                dependencies.emplace(column, ColumnDependency::SKIP_INDEX);
-            materialized_indices.emplace(command.index_name);
+            if (!source.hasIndexOrProjection("skp_idx_" + it->name + ".idx")
+                && !source.hasIndexOrProjection("skp_idx_" + it->name + ".idx2"))
+            {
+                auto query = (*it).expression_list_ast->clone();
+                auto syntax_result = TreeRewriter(context).analyze(query, all_columns);
+                const auto required_columns = syntax_result->requiredSourceColumns();
+                for (const auto & column : required_columns)
+                    dependencies.emplace(column, ColumnDependency::SKIP_INDEX);
+                materialized_indices.emplace(command.index_name);
+            }
         }
         else if (command.type == MutationCommand::MATERIALIZE_PROJECTION)
         {
             mutation_kind.set(MutationKind::MUTATE_INDEX_PROJECTION);
             const auto & projection = projections_desc.get(command.projection_name);
-            for (const auto & column : projection.required_columns)
-                dependencies.emplace(column, ColumnDependency::PROJECTION);
-            materialized_projections.emplace(command.projection_name);
+            if (!source.hasIndexOrProjection(projection.getDirectoryName()))
+            {
+                for (const auto & column : projection.required_columns)
+                    dependencies.emplace(column, ColumnDependency::PROJECTION);
+                materialized_projections.emplace(command.projection_name);
+            }
         }
         else if (command.type == MutationCommand::DROP_INDEX)
         {
@@ -712,7 +773,8 @@ void MutationsInterpreter::prepare(bool dry_run)
             {
                 // just recalculate ttl_infos without remove expired data
                 auto all_columns_vec = all_columns.getNames();
-                auto new_dependencies = metadata_snapshot->getColumnDependencies(NameSet(all_columns_vec.begin(), all_columns_vec.end()), false);
+                auto new_dependencies = metadata_snapshot->getColumnDependencies(
+                    NameSet(all_columns_vec.begin(), all_columns_vec.end()), false, has_index_or_projection);
                 for (const auto & dependency : new_dependencies)
                 {
                     if (dependency.kind == ColumnDependency::TTL_EXPRESSION)
@@ -737,7 +799,8 @@ void MutationsInterpreter::prepare(bool dry_run)
                 }
 
                 auto all_columns_vec = all_columns.getNames();
-                auto all_dependencies = getAllColumnDependencies(metadata_snapshot, NameSet(all_columns_vec.begin(), all_columns_vec.end()));
+                auto all_dependencies = getAllColumnDependencies(
+                    metadata_snapshot, NameSet(all_columns_vec.begin(), all_columns_vec.end()), has_index_or_projection);
 
                 for (const auto & dependency : all_dependencies)
                 {
@@ -746,7 +809,7 @@ void MutationsInterpreter::prepare(bool dry_run)
                 }
 
                 /// Recalc only skip indices and projections of columns which could be updated by TTL.
-                auto new_dependencies = metadata_snapshot->getColumnDependencies(new_updated_columns, true);
+                auto new_dependencies = metadata_snapshot->getColumnDependencies(new_updated_columns, true, has_index_or_projection);
                 for (const auto & dependency : new_dependencies)
                 {
                     if (dependency.kind == ColumnDependency::SKIP_INDEX || dependency.kind == ColumnDependency::PROJECTION)
diff --git a/src/Interpreters/MutationsInterpreter.h b/src/Interpreters/MutationsInterpreter.h
index 49ba07641d9..d783b503531 100644
--- a/src/Interpreters/MutationsInterpreter.h
+++ b/src/Interpreters/MutationsInterpreter.h
@@ -120,6 +120,7 @@ public:
         bool supportsLightweightDelete() const;
         bool hasLightweightDeleteMask() const;
         bool materializeTTLRecalculateOnly() const;
+        bool hasIndexOrProjection(const String & file_name) const;
 
         void read(
             Stage & first_stage,
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index d27b03fff44..ca814a2afd5 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -632,7 +632,7 @@ void IMergeTreeDataPart::loadColumnsChecksumsIndexes(bool require_columns_checks
         if (!parent_part)
         {
             loadTTLInfos();
-            loadProjections(require_columns_checksums, check_consistency);
+            loadProjections(require_columns_checksums, check_consistency, false /* if_not_loaded */);
         }
 
         if (check_consistency)
@@ -690,13 +690,13 @@ void IMergeTreeDataPart::addProjectionPart(
     const String & projection_name,
     std::shared_ptr<IMergeTreeDataPart> && projection_part)
 {
-    /// Here should be a check that projection we are trying to add
-    /// does not exist, but unfortunately this check fails in tests.
-    /// TODO: fix.
+    if (hasProjection(projection_name))
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Projection part {} in part {} is already loaded. This is a bug", projection_name, name);
+
     projection_parts[projection_name] = std::move(projection_part);
 }
 
-void IMergeTreeDataPart::loadProjections(bool require_columns_checksums, bool check_consistency)
+void IMergeTreeDataPart::loadProjections(bool require_columns_checksums, bool check_consistency, bool if_not_loaded)
 {
     auto metadata_snapshot = storage.getInMemoryMetadataPtr();
     for (const auto & projection : metadata_snapshot->projections)
@@ -704,9 +704,18 @@ void IMergeTreeDataPart::loadProjections(bool require_columns_checksums, bool ch
         auto path = projection.name + ".proj";
         if (getDataPartStorage().exists(path))
         {
-            auto part = getProjectionPartBuilder(projection.name).withPartFormatFromDisk().build();
-            part->loadColumnsChecksumsIndexes(require_columns_checksums, check_consistency);
-            addProjectionPart(projection.name, std::move(part));
+            if (hasProjection(projection.name))
+            {
+                if (!if_not_loaded)
+                    throw Exception(
+                        ErrorCodes::LOGICAL_ERROR, "Projection part {} in part {} is already loaded. This is a bug", projection.name, name);
+            }
+            else
+            {
+                auto part = getProjectionPartBuilder(projection.name).withPartFormatFromDisk().build();
+                part->loadColumnsChecksumsIndexes(require_columns_checksums, check_consistency);
+                addProjectionPart(projection.name, std::move(part));
+            }
         }
     }
 }
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.h b/src/Storages/MergeTree/IMergeTreeDataPart.h
index 411de3af982..b6b6d8c6693 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.h
@@ -388,7 +388,7 @@ public:
 
     bool hasProjection(const String & projection_name) const { return projection_parts.contains(projection_name); }
 
-    void loadProjections(bool require_columns_checksums, bool check_consistency);
+    void loadProjections(bool require_columns_checksums, bool check_consistency, bool if_not_loaded = false);
 
     /// Return set of metadata file names without checksums. For example,
     /// columns.txt or checksums.txt itself.
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 32665429051..0115ce07b2c 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -605,14 +605,14 @@ namespace
 
 ExpressionActionsPtr getCombinedIndicesExpression(
     const KeyDescription & key,
-    const IndicesDescription & indices,
+    const MergeTreeIndices & indices,
     const ColumnsDescription & columns,
     ContextPtr context)
 {
     ASTPtr combined_expr_list = key.expression_list_ast->clone();
 
     for (const auto & index : indices)
-        for (const auto & index_expr : index.expression_list_ast->children)
+        for (const auto & index_expr : index->index.expression_list_ast->children)
             combined_expr_list->children.push_back(index_expr->clone());
 
     auto syntax_result = TreeRewriter(context).analyze(combined_expr_list, columns.getAllPhysical());
@@ -644,14 +644,16 @@ DataTypes MergeTreeData::getMinMaxColumnsTypes(const KeyDescription & partition_
     return {};
 }
 
-ExpressionActionsPtr MergeTreeData::getPrimaryKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot) const
+ExpressionActionsPtr
+MergeTreeData::getPrimaryKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot, const MergeTreeIndices & indices) const
 {
-    return getCombinedIndicesExpression(metadata_snapshot->getPrimaryKey(), metadata_snapshot->getSecondaryIndices(), metadata_snapshot->getColumns(), getContext());
+    return getCombinedIndicesExpression(metadata_snapshot->getPrimaryKey(), indices, metadata_snapshot->getColumns(), getContext());
 }
 
-ExpressionActionsPtr MergeTreeData::getSortingKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot) const
+ExpressionActionsPtr
+MergeTreeData::getSortingKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot, const MergeTreeIndices & indices) const
 {
-    return getCombinedIndicesExpression(metadata_snapshot->getSortingKey(), metadata_snapshot->getSecondaryIndices(), metadata_snapshot->getColumns(), getContext());
+    return getCombinedIndicesExpression(metadata_snapshot->getSortingKey(), indices, metadata_snapshot->getColumns(), getContext());
 }
 
 
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index 1c41de6fa19..6fd9d223f32 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -956,8 +956,10 @@ public:
     /// Get column types required for partition key
     static DataTypes getMinMaxColumnsTypes(const KeyDescription & partition_key);
 
-    ExpressionActionsPtr getPrimaryKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot) const;
-    ExpressionActionsPtr getSortingKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot) const;
+    ExpressionActionsPtr
+    getPrimaryKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot, const MergeTreeIndices & indices) const;
+    ExpressionActionsPtr
+    getSortingKeyAndSkipIndicesExpression(const StorageMetadataPtr & metadata_snapshot, const MergeTreeIndices & indices) const;
 
     /// Get compression codec for part according to TTL rules and <compression>
     /// section from config.xml.
diff --git a/src/Storages/MergeTree/MergeTreeDataWriter.cpp b/src/Storages/MergeTree/MergeTreeDataWriter.cpp
index db486b163eb..6ff4d6be870 100644
--- a/src/Storages/MergeTree/MergeTreeDataWriter.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataWriter.cpp
@@ -398,9 +398,11 @@ MergeTreeDataWriter::TemporaryPart MergeTreeDataWriter::writeTempPartImpl(
 
     temp_part.temporary_directory_lock = data.getTemporaryPartDirectoryHolder(part_dir);
 
+    auto indices = MergeTreeIndexFactory::instance().getMany(metadata_snapshot->getSecondaryIndices());
+
     /// If we need to calculate some columns to sort.
     if (metadata_snapshot->hasSortingKey() || metadata_snapshot->hasSecondaryIndices())
-        data.getSortingKeyAndSkipIndicesExpression(metadata_snapshot)->execute(block);
+        data.getSortingKeyAndSkipIndicesExpression(metadata_snapshot, indices)->execute(block);
 
     Names sort_columns = metadata_snapshot->getSortingKeyColumns();
     SortDescription sort_description;
@@ -517,10 +519,16 @@ MergeTreeDataWriter::TemporaryPart MergeTreeDataWriter::writeTempPartImpl(
     ///  either default lz4 or compression method with zero thresholds on absolute and relative part size.
     auto compression_codec = data.getContext()->chooseCompressionCodec(0, 0);
 
-    const auto & index_factory = MergeTreeIndexFactory::instance();
-    auto out = std::make_unique<MergedBlockOutputStream>(new_data_part, metadata_snapshot, columns,
-        index_factory.getMany(metadata_snapshot->getSecondaryIndices()), compression_codec,
-        context->getCurrentTransaction(), false, false, context->getWriteSettings());
+    auto out = std::make_unique<MergedBlockOutputStream>(
+        new_data_part,
+        metadata_snapshot,
+        columns,
+        indices,
+        compression_codec,
+        context->getCurrentTransaction(),
+        false,
+        false,
+        context->getWriteSettings());
 
     out->writeWithPermutation(block, perm_ptr);
 
@@ -606,7 +614,7 @@ MergeTreeDataWriter::TemporaryPart MergeTreeDataWriter::writeProjectionPartImpl(
 
     /// If we need to calculate some columns to sort.
     if (metadata_snapshot->hasSortingKey() || metadata_snapshot->hasSecondaryIndices())
-        data.getSortingKeyAndSkipIndicesExpression(metadata_snapshot)->execute(block);
+        data.getSortingKeyAndSkipIndicesExpression(metadata_snapshot, {})->execute(block);
 
     Names sort_columns = metadata_snapshot->getSortingKeyColumns();
     SortDescription sort_description;
diff --git a/src/Storages/MergeTree/MutateTask.cpp b/src/Storages/MergeTree/MutateTask.cpp
index 76096d00641..d65897ac97d 100644
--- a/src/Storages/MergeTree/MutateTask.cpp
+++ b/src/Storages/MergeTree/MutateTask.cpp
@@ -200,8 +200,7 @@ static void splitAndModifyMutationCommands(
             {
                 for_file_renames.push_back(command);
             }
-            /// If we don't have this column in source part, than we don't need
-            /// to materialize it
+            /// If we don't have this column in source part, we don't need to materialize it.
             else if (part_columns.has(command.column_name))
             {
                 if (command.type == MutationCommand::Type::READ_COLUMN)
@@ -438,51 +437,13 @@ static ExecuteTTLType shouldExecuteTTL(const StorageMetadataPtr & metadata_snaps
 }
 
 
-/// Get skip indices, that should exists in the resulting data part.
-static MergeTreeIndices getIndicesForNewDataPart(
-    const IndicesDescription & all_indices,
-    const MutationCommands & commands_for_removes)
-{
-    NameSet removed_indices;
-    for (const auto & command : commands_for_removes)
-        if (command.type == MutationCommand::DROP_INDEX)
-            removed_indices.insert(command.column_name);
-
-    MergeTreeIndices new_indices;
-    for (const auto & index : all_indices)
-        if (!removed_indices.contains(index.name))
-            new_indices.push_back(MergeTreeIndexFactory::instance().get(index));
-
-    return new_indices;
-}
-
-static std::vector<ProjectionDescriptionRawPtr> getProjectionsForNewDataPart(
-    const ProjectionsDescription & all_projections,
-    const MutationCommands & commands_for_removes)
-{
-    NameSet removed_projections;
-    for (const auto & command : commands_for_removes)
-        if (command.type == MutationCommand::DROP_PROJECTION)
-            removed_projections.insert(command.column_name);
-
-    std::vector<ProjectionDescriptionRawPtr> new_projections;
-    for (const auto & projection : all_projections)
-        if (!removed_projections.contains(projection.name))
-            new_projections.push_back(&projection);
-
-    return new_projections;
-}
-
-
 /// Return set of indices which should be recalculated during mutation also
 /// wraps input stream into additional expression stream
 static std::set<MergeTreeIndexPtr> getIndicesToRecalculate(
     QueryPipelineBuilder & builder,
-    const NameSet & updated_columns,
     const StorageMetadataPtr & metadata_snapshot,
     ContextPtr context,
-    const NameSet & materialized_indices,
-    const MergeTreeData::DataPartPtr & source_part)
+    const NameSet & materialized_indices)
 {
     /// Checks if columns used in skipping indexes modified.
     const auto & index_factory = MergeTreeIndexFactory::instance();
@@ -492,11 +453,7 @@ static std::set<MergeTreeIndexPtr> getIndicesToRecalculate(
 
     for (const auto & index : indices)
     {
-        bool has_index =
-            source_part->checksums.has(INDEX_FILE_PREFIX + index.name + ".idx") ||
-            source_part->checksums.has(INDEX_FILE_PREFIX + index.name + ".idx2");
-        // If we ask to materialize and it already exists
-        if (!has_index && materialized_indices.contains(index.name))
+        if (materialized_indices.contains(index.name))
         {
             if (indices_to_recalc.insert(index_factory.get(index)).second)
             {
@@ -505,26 +462,6 @@ static std::set<MergeTreeIndexPtr> getIndicesToRecalculate(
                     indices_recalc_expr_list->children.push_back(expr->clone());
             }
         }
-        // If some dependent columns gets mutated
-        else
-        {
-            bool mutate = false;
-            const auto & index_cols = index.expression->getRequiredColumns();
-            for (const auto & col : index_cols)
-            {
-                if (updated_columns.contains(col))
-                {
-                    mutate = true;
-                    break;
-                }
-            }
-            if (mutate && indices_to_recalc.insert(index_factory.get(index)).second)
-            {
-                ASTPtr expr_list = index.expression_list_ast->clone();
-                for (const auto & expr : expr_list->children)
-                    indices_recalc_expr_list->children.push_back(expr->clone());
-            }
-        }
     }
 
     if (!indices_to_recalc.empty() && builder.initialized())
@@ -545,37 +482,15 @@ static std::set<MergeTreeIndexPtr> getIndicesToRecalculate(
     return indices_to_recalc;
 }
 
-std::set<ProjectionDescriptionRawPtr> getProjectionsToRecalculate(
-    const NameSet & updated_columns,
+static std::set<ProjectionDescriptionRawPtr> getProjectionsToRecalculate(
     const StorageMetadataPtr & metadata_snapshot,
-    const NameSet & materialized_projections,
-    const MergeTreeData::DataPartPtr & source_part)
+    const NameSet & materialized_projections)
 {
-    /// Checks if columns used in projections modified.
     std::set<ProjectionDescriptionRawPtr> projections_to_recalc;
     for (const auto & projection : metadata_snapshot->getProjections())
     {
-        // If we ask to materialize and it doesn't exist
-        if (!source_part->checksums.has(projection.name + ".proj") && materialized_projections.contains(projection.name))
-        {
+        if (materialized_projections.contains(projection.name))
             projections_to_recalc.insert(&projection);
-        }
-        else
-        {
-            // If some dependent columns gets mutated
-            bool mutate = false;
-            const auto & projection_cols = projection.required_columns;
-            for (const auto & col : projection_cols)
-            {
-                if (updated_columns.contains(col))
-                {
-                    mutate = true;
-                    break;
-                }
-            }
-            if (mutate)
-                projections_to_recalc.insert(&projection);
-        }
     }
     return projections_to_recalc;
 }
@@ -618,33 +533,6 @@ static NameSet collectFilesToSkip(
     /// Do not hardlink this file because it's always rewritten at the end of mutation.
     files_to_skip.insert(IMergeTreeDataPart::SERIALIZATION_FILE_NAME);
 
-    auto new_stream_counts = getStreamCounts(new_part, new_part->getColumns().getNames());
-    auto source_updated_stream_counts = getStreamCounts(source_part, updated_header.getNames());
-    auto new_updated_stream_counts = getStreamCounts(new_part, updated_header.getNames());
-
-    /// Skip all modified files in new part.
-    for (const auto & [stream_name, _] : new_updated_stream_counts)
-    {
-        files_to_skip.insert(stream_name + ".bin");
-        files_to_skip.insert(stream_name + mrk_extension);
-    }
-
-    /// Skip files that we read from source part and do not write in new part.
-    /// E.g. ALTER MODIFY from LowCardinality(String) to String.
-    for (const auto & [stream_name, _] : source_updated_stream_counts)
-    {
-        /// If we read shared stream and do not write it
-        /// (e.g. while ALTER MODIFY COLUMN from array of Nested type to String),
-        /// we need to hardlink its files, because they will be lost otherwise.
-        bool need_hardlink = new_updated_stream_counts[stream_name] == 0 && new_stream_counts[stream_name] != 0;
-
-        if (!need_hardlink)
-        {
-            files_to_skip.insert(stream_name + ".bin");
-            files_to_skip.insert(stream_name + mrk_extension);
-        }
-    }
-
     for (const auto & index : indices_to_recalc)
     {
         /// Since MinMax index has .idx2 extension, we need to add correct extension.
@@ -655,6 +543,36 @@ static NameSet collectFilesToSkip(
     for (const auto & projection : projections_to_recalc)
         files_to_skip.insert(projection->getDirectoryName());
 
+    if (isWidePart(source_part))
+    {
+        auto new_stream_counts = getStreamCounts(new_part, new_part->getColumns().getNames());
+        auto source_updated_stream_counts = getStreamCounts(source_part, updated_header.getNames());
+        auto new_updated_stream_counts = getStreamCounts(new_part, updated_header.getNames());
+
+        /// Skip all modified files in new part.
+        for (const auto & [stream_name, _] : new_updated_stream_counts)
+        {
+            files_to_skip.insert(stream_name + ".bin");
+            files_to_skip.insert(stream_name + mrk_extension);
+        }
+
+        /// Skip files that we read from source part and do not write in new part.
+        /// E.g. ALTER MODIFY from LowCardinality(String) to String.
+        for (const auto & [stream_name, _] : source_updated_stream_counts)
+        {
+            /// If we read shared stream and do not write it
+            /// (e.g. while ALTER MODIFY COLUMN from array of Nested type to String),
+            /// we need to hardlink its files, because they will be lost otherwise.
+            bool need_hardlink = new_updated_stream_counts[stream_name] == 0 && new_stream_counts[stream_name] != 0;
+
+            if (!need_hardlink)
+            {
+                files_to_skip.insert(stream_name + ".bin");
+                files_to_skip.insert(stream_name + mrk_extension);
+            }
+        }
+    }
+
     return files_to_skip;
 }
 
@@ -701,57 +619,60 @@ static NameToNameVector collectFilesForRenames(
             if (source_part->checksums.has(command.column_name + ".proj"))
                 add_rename(command.column_name + ".proj", "");
         }
-        else if (command.type == MutationCommand::Type::DROP_COLUMN)
+        else if (isWidePart(source_part))
         {
-            ISerialization::StreamCallback callback = [&](const ISerialization::SubstreamPath & substream_path)
+            if (command.type == MutationCommand::Type::DROP_COLUMN)
             {
-                String stream_name = ISerialization::getFileNameForStream({command.column_name, command.data_type}, substream_path);
-                /// Delete files if they are no longer shared with another column.
-                if (--stream_counts[stream_name] == 0)
+                ISerialization::StreamCallback callback = [&](const ISerialization::SubstreamPath & substream_path)
                 {
-                    add_rename(stream_name + ".bin", "");
-                    add_rename(stream_name + mrk_extension, "");
-                }
-            };
+                    String stream_name = ISerialization::getFileNameForStream({command.column_name, command.data_type}, substream_path);
+                    /// Delete files if they are no longer shared with another column.
+                    if (--stream_counts[stream_name] == 0)
+                    {
+                        add_rename(stream_name + ".bin", "");
+                        add_rename(stream_name + mrk_extension, "");
+                    }
+                };
 
-            if (auto serialization = source_part->tryGetSerialization(command.column_name))
-                serialization->enumerateStreams(callback);
-        }
-        else if (command.type == MutationCommand::Type::RENAME_COLUMN)
-        {
-            String escaped_name_from = escapeForFileName(command.column_name);
-            String escaped_name_to = escapeForFileName(command.rename_to);
-
-            ISerialization::StreamCallback callback = [&](const ISerialization::SubstreamPath & substream_path)
+                if (auto serialization = source_part->tryGetSerialization(command.column_name))
+                    serialization->enumerateStreams(callback);
+            }
+            else if (command.type == MutationCommand::Type::RENAME_COLUMN)
             {
-                String stream_from = ISerialization::getFileNameForStream(command.column_name, substream_path);
-                String stream_to = boost::replace_first_copy(stream_from, escaped_name_from, escaped_name_to);
+                String escaped_name_from = escapeForFileName(command.column_name);
+                String escaped_name_to = escapeForFileName(command.rename_to);
 
-                if (stream_from != stream_to)
+                ISerialization::StreamCallback callback = [&](const ISerialization::SubstreamPath & substream_path)
                 {
-                    add_rename(stream_from + ".bin", stream_to + ".bin");
-                    add_rename(stream_from + mrk_extension, stream_to + mrk_extension);
-                }
-            };
+                    String stream_from = ISerialization::getFileNameForStream(command.column_name, substream_path);
+                    String stream_to = boost::replace_first_copy(stream_from, escaped_name_from, escaped_name_to);
 
-            if (auto serialization = source_part->tryGetSerialization(command.column_name))
-                serialization->enumerateStreams(callback);
-        }
-        else if (command.type == MutationCommand::Type::READ_COLUMN)
-        {
-            /// Remove files for streams that exist in source_part,
-            /// but were removed in new_part by MODIFY COLUMN from
-            /// type with higher number of streams (e.g. LowCardinality -> String).
+                    if (stream_from != stream_to)
+                    {
+                        add_rename(stream_from + ".bin", stream_to + ".bin");
+                        add_rename(stream_from + mrk_extension, stream_to + mrk_extension);
+                    }
+                };
 
-            auto old_streams = getStreamCounts(source_part, source_part->getColumns().getNames());
-            auto new_streams = getStreamCounts(new_part, source_part->getColumns().getNames());
-
-            for (const auto & [old_stream, _] : old_streams)
+                if (auto serialization = source_part->tryGetSerialization(command.column_name))
+                    serialization->enumerateStreams(callback);
+            }
+            else if (command.type == MutationCommand::Type::READ_COLUMN)
             {
-                if (!new_streams.contains(old_stream) && --stream_counts[old_stream] == 0)
+                /// Remove files for streams that exist in source_part,
+                /// but were removed in new_part by MODIFY COLUMN from
+                /// type with higher number of streams (e.g. LowCardinality -> String).
+
+                auto old_streams = getStreamCounts(source_part, source_part->getColumns().getNames());
+                auto new_streams = getStreamCounts(new_part, source_part->getColumns().getNames());
+
+                for (const auto & [old_stream, _] : old_streams)
                 {
-                    add_rename(old_stream + ".bin", "");
-                    add_rename(old_stream + mrk_extension, "");
+                    if (!new_streams.contains(old_stream) && --stream_counts[old_stream] == 0)
+                    {
+                        add_rename(old_stream + ".bin", "");
+                        add_rename(old_stream + mrk_extension, "");
+                    }
                 }
             }
         }
@@ -851,11 +772,8 @@ void finalizeMutatedPart(
     new_data_part->minmax_idx = source_part->minmax_idx;
     new_data_part->modification_time = time(nullptr);
 
-    /// This line should not be here because at that moment
-    /// of executing of mutation all projections should be loaded.
-    /// But unfortunately without it some tests fail.
-    /// TODO: fix.
-    new_data_part->loadProjections(false, false);
+    /// Load rest projections which are hardlinked
+    new_data_part->loadProjections(false, false, true /* if_not_loaded */);
 
     /// All information about sizes is stored in checksums.
     /// It doesn't make sense to touch filesystem for sizes.
@@ -917,9 +835,9 @@ struct MutationContext
     std::vector<ProjectionDescriptionRawPtr> projections_to_build;
     IMergeTreeDataPart::MinMaxIndexPtr minmax_idx{nullptr};
 
-    NameSet updated_columns;
     std::set<MergeTreeIndexPtr> indices_to_recalc;
     std::set<ProjectionDescriptionRawPtr> projections_to_recalc;
+    MergeTreeData::DataPart::Checksums existing_indices_checksums;
     NameSet files_to_skip;
     NameToNameVector files_to_rename;
 
@@ -1331,10 +1249,102 @@ private:
         /// (which is locked in shared mode when input streams are created) and when inserting new data
         /// the order is reverse. This annoys TSan even though one lock is locked in shared mode and thus
         /// deadlock is impossible.
-        ctx->compression_codec = ctx->data->getCompressionCodecForPart(ctx->source_part->getBytesOnDisk(), ctx->source_part->ttl_infos, ctx->time_of_mutation);
+        ctx->compression_codec
+            = ctx->data->getCompressionCodecForPart(ctx->source_part->getBytesOnDisk(), ctx->source_part->ttl_infos, ctx->time_of_mutation);
 
-        auto skip_part_indices = MutationHelpers::getIndicesForNewDataPart(ctx->metadata_snapshot->getSecondaryIndices(), ctx->for_file_renames);
-        ctx->projections_to_build = MutationHelpers::getProjectionsForNewDataPart(ctx->metadata_snapshot->getProjections(), ctx->for_file_renames);
+        NameSet entries_to_hardlink;
+
+        NameSet removed_indices;
+        for (const auto & command : ctx->for_file_renames)
+        {
+            if (command.type == MutationCommand::DROP_INDEX)
+                removed_indices.insert(command.column_name);
+        }
+
+        const auto & indices = ctx->metadata_snapshot->getSecondaryIndices();
+        MergeTreeIndices skip_indices;
+        for (const auto & idx : indices)
+        {
+            if (removed_indices.contains(idx.name))
+                continue;
+
+            if (ctx->materialized_indices.contains(idx.name))
+                skip_indices.push_back(MergeTreeIndexFactory::instance().get(idx));
+
+            auto hardlink_index = [&](const String & idx_name)
+            {
+                if (ctx->source_part->checksums.has(idx_name))
+                {
+                    auto it = ctx->source_part->checksums.files.find(idx_name);
+                    if (it != ctx->source_part->checksums.files.end())
+                    {
+                        entries_to_hardlink.insert(idx_name);
+                        ctx->existing_indices_checksums.addFile(idx_name, it->second.file_size, it->second.file_hash);
+                    }
+                }
+            };
+            hardlink_index(INDEX_FILE_PREFIX + idx.name + ".idx");
+            hardlink_index(INDEX_FILE_PREFIX + idx.name + ".idx2");
+        }
+
+        NameSet removed_projections;
+        for (const auto & command : ctx->for_file_renames)
+        {
+            if (command.type == MutationCommand::DROP_PROJECTION)
+                removed_projections.insert(command.column_name);
+        }
+
+        const auto & projections = ctx->metadata_snapshot->getProjections();
+        for (const auto & projection : projections)
+        {
+            if (removed_projections.contains(projection.name))
+                continue;
+
+            if (ctx->materialized_projections.contains(projection.name))
+                ctx->projections_to_build.push_back(&projection);
+
+            if (ctx->source_part->checksums.has(projection.getDirectoryName()))
+                entries_to_hardlink.insert(projection.getDirectoryName());
+        }
+
+        NameSet hardlinked_files;
+        /// Create hardlinks for unchanged files
+        for (auto it = ctx->source_part->getDataPartStorage().iterate(); it->isValid(); it->next())
+        {
+            if (!entries_to_hardlink.contains(it->name()))
+                continue;
+
+            if (it->isFile())
+            {
+                ctx->new_data_part->getDataPartStorage().createHardLinkFrom(
+                    ctx->source_part->getDataPartStorage(), it->name(), it->name());
+                hardlinked_files.insert(it->name());
+            }
+            else
+            {
+                // it's a projection part directory
+                ctx->new_data_part->getDataPartStorage().createProjection(it->name());
+
+                auto projection_data_part_storage_src = ctx->source_part->getDataPartStorage().getProjection(it->name());
+                auto projection_data_part_storage_dst = ctx->new_data_part->getDataPartStorage().getProjection(it->name());
+
+                for (auto p_it = projection_data_part_storage_src->iterate(); p_it->isValid(); p_it->next())
+                {
+                    projection_data_part_storage_dst->createHardLinkFrom(
+                        *projection_data_part_storage_src, p_it->name(), p_it->name());
+
+                    auto file_name_with_projection_prefix = fs::path(projection_data_part_storage_src->getPartDirectory()) / p_it->name();
+                    hardlinked_files.insert(file_name_with_projection_prefix);
+                }
+            }
+        }
+
+        /// Tracking of hardlinked files required for zero-copy replication.
+        /// We don't remove them when we delete last copy of source part because
+        /// new part can use them.
+        ctx->hardlinked_files.source_table_shared_id = ctx->source_part->storage.getTableSharedID();
+        ctx->hardlinked_files.source_part_name = ctx->source_part->name;
+        ctx->hardlinked_files.hardlinks_from_source_part = std::move(hardlinked_files);
 
         if (!ctx->mutating_pipeline_builder.initialized())
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot mutate part columns with uninitialized mutations stream. It's a bug");
@@ -1343,8 +1353,8 @@ private:
 
         if (ctx->metadata_snapshot->hasPrimaryKey() || ctx->metadata_snapshot->hasSecondaryIndices())
         {
-            builder.addTransform(
-                std::make_shared<ExpressionTransform>(builder.getHeader(), ctx->data->getPrimaryKeyAndSkipIndicesExpression(ctx->metadata_snapshot)));
+            builder.addTransform(std::make_shared<ExpressionTransform>(
+                            builder.getHeader(), ctx->data->getPrimaryKeyAndSkipIndicesExpression(ctx->metadata_snapshot, skip_indices)));
 
             builder.addTransform(std::make_shared<MaterializingTransform>(builder.getHeader()));
         }
@@ -1361,7 +1371,7 @@ private:
             ctx->new_data_part,
             ctx->metadata_snapshot,
             ctx->new_data_part->getColumns(),
-            skip_part_indices,
+            skip_indices,
             ctx->compression_codec,
             ctx->txn,
             /*reset_columns=*/ true,
@@ -1381,10 +1391,12 @@ private:
     void finalize()
     {
         ctx->new_data_part->minmax_idx = std::move(ctx->minmax_idx);
+        ctx->new_data_part->loadProjections(false, false, true /* if_not_loaded */);
         ctx->mutating_executor.reset();
         ctx->mutating_pipeline.reset();
 
-        static_pointer_cast<MergedBlockOutputStream>(ctx->out)->finalizePart(ctx->new_data_part, ctx->need_sync);
+        static_pointer_cast<MergedBlockOutputStream>(ctx->out)->finalizePart(
+            ctx->new_data_part, ctx->need_sync, nullptr, &ctx->existing_indices_checksums);
         ctx->out.reset();
     }
 
@@ -1530,7 +1542,7 @@ private:
         /// new part can use them.
         ctx->hardlinked_files.source_table_shared_id = ctx->source_part->storage.getTableSharedID();
         ctx->hardlinked_files.source_part_name = ctx->source_part->name;
-        ctx->hardlinked_files.hardlinks_from_source_part = hardlinked_files;
+        ctx->hardlinked_files.hardlinks_from_source_part = std::move(hardlinked_files);
 
         (*ctx->mutate_entry)->columns_written = ctx->storage_columns.size() - ctx->updated_header.columns();
 
@@ -1878,14 +1890,10 @@ bool MutateTask::prepare()
     }
     else /// TODO: check that we modify only non-key columns in this case.
     {
-        /// We will modify only some of the columns. Other columns and key values can be copied as-is.
-        for (const auto & name_type : ctx->updated_header.getNamesAndTypesList())
-            ctx->updated_columns.emplace(name_type.name);
-
         ctx->indices_to_recalc = MutationHelpers::getIndicesToRecalculate(
-            ctx->mutating_pipeline_builder, ctx->updated_columns, ctx->metadata_snapshot, ctx->context, ctx->materialized_indices, ctx->source_part);
-        ctx->projections_to_recalc = MutationHelpers::getProjectionsToRecalculate(
-            ctx->updated_columns, ctx->metadata_snapshot, ctx->materialized_projections, ctx->source_part);
+            ctx->mutating_pipeline_builder, ctx->metadata_snapshot, ctx->context, ctx->materialized_indices);
+
+        ctx->projections_to_recalc = MutationHelpers::getProjectionsToRecalculate(ctx->metadata_snapshot, ctx->materialized_projections);
 
         ctx->files_to_skip = MutationHelpers::collectFilesToSkip(
             ctx->source_part,
diff --git a/src/Storages/StorageInMemoryMetadata.cpp b/src/Storages/StorageInMemoryMetadata.cpp
index 45abd4bebef..afe75349864 100644
--- a/src/Storages/StorageInMemoryMetadata.cpp
+++ b/src/Storages/StorageInMemoryMetadata.cpp
@@ -236,7 +236,10 @@ bool StorageInMemoryMetadata::hasAnyGroupByTTL() const
     return !table_ttl.group_by_ttl.empty();
 }
 
-ColumnDependencies StorageInMemoryMetadata::getColumnDependencies(const NameSet & updated_columns, bool include_ttl_target) const
+ColumnDependencies StorageInMemoryMetadata::getColumnDependencies(
+    const NameSet & updated_columns,
+    bool include_ttl_target,
+    const std::function<bool(const String & file_name)> & has_indice_or_projection) const
 {
     if (updated_columns.empty())
         return {};
@@ -264,10 +267,16 @@ ColumnDependencies StorageInMemoryMetadata::getColumnDependencies(const NameSet
     };
 
     for (const auto & index : getSecondaryIndices())
-        add_dependent_columns(index.expression, indices_columns);
+    {
+        if (has_indice_or_projection("skp_idx_" + index.name + ".idx") || has_indice_or_projection("skp_idx_" + index.name + ".idx2"))
+            add_dependent_columns(index.expression, indices_columns);
+    }
 
     for (const auto & projection : getProjections())
-        add_dependent_columns(&projection, projections_columns);
+    {
+        if (has_indice_or_projection(projection.getDirectoryName()))
+            add_dependent_columns(&projection, projections_columns);
+    }
 
     auto add_for_rows_ttl = [&](const auto & expression, auto & to_set)
     {
@@ -312,7 +321,6 @@ ColumnDependencies StorageInMemoryMetadata::getColumnDependencies(const NameSet
         res.emplace(column, ColumnDependency::TTL_TARGET);
 
     return res;
-
 }
 
 Block StorageInMemoryMetadata::getSampleBlockInsertable() const
diff --git a/src/Storages/StorageInMemoryMetadata.h b/src/Storages/StorageInMemoryMetadata.h
index 25618c5b03f..4ed7eb8bf29 100644
--- a/src/Storages/StorageInMemoryMetadata.h
+++ b/src/Storages/StorageInMemoryMetadata.h
@@ -147,9 +147,12 @@ struct StorageInMemoryMetadata
     TTLDescriptions getGroupByTTLs() const;
     bool hasAnyGroupByTTL() const;
 
-    /// Returns columns, which will be needed to calculate dependencies (skip
-    /// indices, TTL expressions) if we update @updated_columns set of columns.
-    ColumnDependencies getColumnDependencies(const NameSet & updated_columns, bool include_ttl_target) const;
+    /// Returns columns, which will be needed to calculate dependencies (skip indices, projections,
+    /// TTL expressions) if we update @updated_columns set of columns.
+    ColumnDependencies getColumnDependencies(
+        const NameSet & updated_columns,
+        bool include_ttl_target,
+        const std::function<bool(const String & file_name)> & has_indice_or_projection) const;
 
     /// Block with ordinary + materialized columns.
     Block getSampleBlock() const;
diff --git a/tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.reference b/tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.sql b/tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.sql
new file mode 100644
index 00000000000..bb9825fe5a0
--- /dev/null
+++ b/tests/queries/0_stateless/02763_mutate_compact_part_with_skip_indices_and_projections.sql
@@ -0,0 +1,31 @@
+DROP TABLE IF EXISTS test;
+
+CREATE TABLE test ( col1 Int64, dt Date ) ENGINE = MergeTree PARTITION BY dt ORDER BY tuple();
+
+INSERT INTO test FORMAT Values (1, today());
+
+ALTER TABLE test ADD COLUMN col2 String;
+
+ALTER TABLE test ADD INDEX i1 (col1, col2) TYPE set(100) GRANULARITY 1;
+
+ALTER TABLE test MATERIALIZE INDEX i1;
+
+ALTER TABLE test ADD COLUMN col3 String;
+
+ALTER TABLE test DROP COLUMN col3;
+
+DROP TABLE IF EXISTS test;
+
+CREATE TABLE test ( col1 Int64, dt Date ) ENGINE = MergeTree PARTITION BY dt ORDER BY tuple();
+
+INSERT INTO test FORMAT Values (1, today());
+
+ALTER TABLE test ADD COLUMN col2 String;
+
+ALTER TABLE test ADD PROJECTION p1 ( SELECT col2, sum(col1) GROUP BY col2 );
+
+ALTER TABLE test MATERIALIZE PROJECTION p1;
+
+ALTER TABLE test ADD COLUMN col3 String;
+
+ALTER TABLE test DROP COLUMN col3;

From 92b2200c55f27eefceb610535e813e62bd49ffce Mon Sep 17 00:00:00 2001
From: Amos Bird <amosbird@gmail.com>
Date: Tue, 23 May 2023 20:46:50 +0800
Subject: [PATCH 198/722] mutation stages can be empty

---
 src/Interpreters/MutationsInterpreter.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Interpreters/MutationsInterpreter.cpp b/src/Interpreters/MutationsInterpreter.cpp
index 791018a3f38..1059e1fdae5 100644
--- a/src/Interpreters/MutationsInterpreter.cpp
+++ b/src/Interpreters/MutationsInterpreter.cpp
@@ -901,6 +901,11 @@ void MutationsInterpreter::prepare(bool dry_run)
         }
     }
 
+    /// Stages might be empty when we materialize skip indices or projections which don't add any
+    /// column dependencies.
+    if (stages.empty())
+        stages.emplace_back(context);
+
     is_prepared = true;
     prepareMutationStages(stages, dry_run);
 }

From e24c9267bc12026ff3acde78675464a17f6d5cc1 Mon Sep 17 00:00:00 2001
From: Amos Bird <amosbird@gmail.com>
Date: Sun, 4 Jun 2023 20:06:27 +0800
Subject: [PATCH 199/722] fix

---
 src/Interpreters/MutationsInterpreter.cpp | 68 +++++++++--------------
 src/Storages/MergeTree/MutateTask.cpp     | 39 +++++++------
 2 files changed, 47 insertions(+), 60 deletions(-)

diff --git a/src/Interpreters/MutationsInterpreter.cpp b/src/Interpreters/MutationsInterpreter.cpp
index 1059e1fdae5..25bb3fc5e82 100644
--- a/src/Interpreters/MutationsInterpreter.cpp
+++ b/src/Interpreters/MutationsInterpreter.cpp
@@ -532,55 +532,12 @@ void MutationsInterpreter::prepare(bool dry_run)
         validateUpdateColumns(source, metadata_snapshot, updated_columns, column_to_affected_materialized);
     }
 
-    for (const auto & [_, names] : column_to_affected_materialized)
-        updated_columns.insert(names.begin(), names.end());
-
     std::function<bool(const String & file_name)> has_index_or_projection
         = [&](const String & file_name) { return source.hasIndexOrProjection(file_name); };
 
     if (settings.recalculate_dependencies_of_updated_columns)
         dependencies = getAllColumnDependencies(metadata_snapshot, updated_columns, has_index_or_projection);
 
-    for (const auto & index : metadata_snapshot->getSecondaryIndices())
-    {
-        if (source.hasIndexOrProjection("skp_idx_" + index.name + ".idx") || source.hasIndexOrProjection("skp_idx_" + index.name + ".idx2"))
-        {
-            // If some dependent columns gets mutated
-            bool mutate = false;
-            const auto & index_cols = index.expression->getRequiredColumns();
-            for (const auto & col : index_cols)
-            {
-                if (updated_columns.contains(col))
-                {
-                    mutate = true;
-                    break;
-                }
-            }
-            if (mutate)
-                materialized_indices.insert(index.name);
-        }
-    }
-
-    for (const auto & projection : metadata_snapshot->getProjections())
-    {
-        if (source.hasIndexOrProjection(projection.getDirectoryName()))
-        {
-            // If some dependent columns gets mutated
-            bool mutate = false;
-            const auto & projection_cols = projection.required_columns;
-            for (const auto & col : projection_cols)
-            {
-                if (updated_columns.contains(col))
-                {
-                    mutate = true;
-                    break;
-                }
-            }
-            if (mutate)
-                materialized_projections.insert(projection.name);
-        }
-    }
-
     std::vector<String> read_columns;
     /// First, break a sequence of commands into stages.
     for (auto & command : commands)
@@ -869,6 +826,31 @@ void MutationsInterpreter::prepare(bool dry_run)
             for (const auto & column : changed_columns)
                 stages.back().column_to_updated.emplace(
                     column, std::make_shared<ASTIdentifier>(column));
+
+            for (const auto & index : metadata_snapshot->getSecondaryIndices())
+            {
+                if (source.hasIndexOrProjection("skp_idx_" + index.name + ".idx")
+                    || source.hasIndexOrProjection("skp_idx_" + index.name + ".idx2"))
+                {
+                    const auto & index_cols = index.expression->getRequiredColumns();
+                    bool changed = std::any_of(
+                        index_cols.begin(), index_cols.end(), [&](const auto & col) { return changed_columns.contains(col); });
+                    if (changed)
+                        materialized_indices.insert(index.name);
+                }
+            }
+
+            for (const auto & projection : metadata_snapshot->getProjections())
+            {
+                if (source.hasIndexOrProjection(projection.getDirectoryName()))
+                {
+                    const auto & projection_cols = projection.required_columns;
+                    bool changed = std::any_of(
+                        projection_cols.begin(), projection_cols.end(), [&](const auto & col) { return changed_columns.contains(col); });
+                    if (changed)
+                        materialized_projections.insert(projection.name);
+                }
+            }
         }
 
         if (!unchanged_columns.empty())
diff --git a/src/Storages/MergeTree/MutateTask.cpp b/src/Storages/MergeTree/MutateTask.cpp
index d65897ac97d..7031027002d 100644
--- a/src/Storages/MergeTree/MutateTask.cpp
+++ b/src/Storages/MergeTree/MutateTask.cpp
@@ -1269,22 +1269,23 @@ private:
                 continue;
 
             if (ctx->materialized_indices.contains(idx.name))
-                skip_indices.push_back(MergeTreeIndexFactory::instance().get(idx));
-
-            auto hardlink_index = [&](const String & idx_name)
             {
-                if (ctx->source_part->checksums.has(idx_name))
+                skip_indices.push_back(MergeTreeIndexFactory::instance().get(idx));
+            }
+            else
+            {
+                auto prefix = fmt::format("{}{}.", INDEX_FILE_PREFIX, idx.name);
+                auto it = ctx->source_part->checksums.files.upper_bound(prefix);
+                while (it != ctx->source_part->checksums.files.end())
                 {
-                    auto it = ctx->source_part->checksums.files.find(idx_name);
-                    if (it != ctx->source_part->checksums.files.end())
-                    {
-                        entries_to_hardlink.insert(idx_name);
-                        ctx->existing_indices_checksums.addFile(idx_name, it->second.file_size, it->second.file_hash);
-                    }
+                    if (!startsWith(it->first, prefix))
+                        break;
+
+                    entries_to_hardlink.insert(it->first);
+                    ctx->existing_indices_checksums.addFile(it->first, it->second.file_size, it->second.file_hash);
+                    ++it;
                 }
-            };
-            hardlink_index(INDEX_FILE_PREFIX + idx.name + ".idx");
-            hardlink_index(INDEX_FILE_PREFIX + idx.name + ".idx2");
+            }
         }
 
         NameSet removed_projections;
@@ -1301,10 +1302,14 @@ private:
                 continue;
 
             if (ctx->materialized_projections.contains(projection.name))
+            {
                 ctx->projections_to_build.push_back(&projection);
-
-            if (ctx->source_part->checksums.has(projection.getDirectoryName()))
-                entries_to_hardlink.insert(projection.getDirectoryName());
+            }
+            else
+            {
+                if (ctx->source_part->checksums.has(projection.getDirectoryName()))
+                    entries_to_hardlink.insert(projection.getDirectoryName());
+            }
         }
 
         NameSet hardlinked_files;
@@ -1354,7 +1359,7 @@ private:
         if (ctx->metadata_snapshot->hasPrimaryKey() || ctx->metadata_snapshot->hasSecondaryIndices())
         {
             builder.addTransform(std::make_shared<ExpressionTransform>(
-                            builder.getHeader(), ctx->data->getPrimaryKeyAndSkipIndicesExpression(ctx->metadata_snapshot, skip_indices)));
+                builder.getHeader(), ctx->data->getPrimaryKeyAndSkipIndicesExpression(ctx->metadata_snapshot, skip_indices)));
 
             builder.addTransform(std::make_shared<MaterializingTransform>(builder.getHeader()));
         }

From a66f68e5df5584cf08a42ff6dd12b4e935f2cb3a Mon Sep 17 00:00:00 2001
From: Amos Bird <amosbird@gmail.com>
Date: Mon, 5 Jun 2023 01:48:13 +0800
Subject: [PATCH 200/722] fix again

---
 src/Interpreters/MutationsInterpreter.cpp | 58 ++++++++++++-----------
 1 file changed, 31 insertions(+), 27 deletions(-)

diff --git a/src/Interpreters/MutationsInterpreter.cpp b/src/Interpreters/MutationsInterpreter.cpp
index 25bb3fc5e82..25c52ad8925 100644
--- a/src/Interpreters/MutationsInterpreter.cpp
+++ b/src/Interpreters/MutationsInterpreter.cpp
@@ -38,6 +38,7 @@
 #include <Analyzer/TableNode.h>
 #include <Interpreters/InterpreterSelectQueryAnalyzer.h>
 #include <Parsers/makeASTForLogicalFunction.h>
+#include <Common/logger_useful.h>
 
 
 namespace DB
@@ -804,10 +805,10 @@ void MutationsInterpreter::prepare(bool dry_run)
     /// We care about affected indices and projections because we also need to rewrite them
     /// when one of index columns updated or filtered with delete.
     /// The same about columns, that are needed for calculation of TTL expressions.
+    NameSet changed_columns;
+    NameSet unchanged_columns;
     if (!dependencies.empty())
     {
-        NameSet changed_columns;
-        NameSet unchanged_columns;
         for (const auto & dependency : dependencies)
         {
             if (dependency.isReadOnly())
@@ -826,31 +827,6 @@ void MutationsInterpreter::prepare(bool dry_run)
             for (const auto & column : changed_columns)
                 stages.back().column_to_updated.emplace(
                     column, std::make_shared<ASTIdentifier>(column));
-
-            for (const auto & index : metadata_snapshot->getSecondaryIndices())
-            {
-                if (source.hasIndexOrProjection("skp_idx_" + index.name + ".idx")
-                    || source.hasIndexOrProjection("skp_idx_" + index.name + ".idx2"))
-                {
-                    const auto & index_cols = index.expression->getRequiredColumns();
-                    bool changed = std::any_of(
-                        index_cols.begin(), index_cols.end(), [&](const auto & col) { return changed_columns.contains(col); });
-                    if (changed)
-                        materialized_indices.insert(index.name);
-                }
-            }
-
-            for (const auto & projection : metadata_snapshot->getProjections())
-            {
-                if (source.hasIndexOrProjection(projection.getDirectoryName()))
-                {
-                    const auto & projection_cols = projection.required_columns;
-                    bool changed = std::any_of(
-                        projection_cols.begin(), projection_cols.end(), [&](const auto & col) { return changed_columns.contains(col); });
-                    if (changed)
-                        materialized_projections.insert(projection.name);
-                }
-            }
         }
 
         if (!unchanged_columns.empty())
@@ -883,6 +859,34 @@ void MutationsInterpreter::prepare(bool dry_run)
         }
     }
 
+    for (const auto & index : metadata_snapshot->getSecondaryIndices())
+    {
+        if (source.hasIndexOrProjection("skp_idx_" + index.name + ".idx") || source.hasIndexOrProjection("skp_idx_" + index.name + ".idx2"))
+        {
+            const auto & index_cols = index.expression->getRequiredColumns();
+            bool changed = std::any_of(
+                index_cols.begin(),
+                index_cols.end(),
+                [&](const auto & col) { return updated_columns.contains(col) || changed_columns.contains(col); });
+            if (changed)
+                materialized_indices.insert(index.name);
+        }
+    }
+
+    for (const auto & projection : metadata_snapshot->getProjections())
+    {
+        if (source.hasIndexOrProjection(projection.getDirectoryName()))
+        {
+            const auto & projection_cols = projection.required_columns;
+            bool changed = std::any_of(
+                projection_cols.begin(),
+                projection_cols.end(),
+                [&](const auto & col) { return updated_columns.contains(col) || changed_columns.contains(col); });
+            if (changed)
+                materialized_projections.insert(projection.name);
+        }
+    }
+
     /// Stages might be empty when we materialize skip indices or projections which don't add any
     /// column dependencies.
     if (stages.empty())

From 2cc457141ed83a50c7a6e4dc395325c6fd4a898d Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 15:32:54 -0300
Subject: [PATCH 201/722] clean documentation of ip4 ip6 from domains

---
 docs/en/interfaces/formats.md                 | 34 +++++++++----------
 docs/en/operations/system-tables/query_log.md |  4 +--
 .../system-tables/query_thread_log.md         |  4 +--
 .../operations/system-tables/session_log.md   |  2 +-
 .../operations/system-tables/zookeeper_log.md |  2 +-
 docs/en/sql-reference/data-types/index.md     |  2 +-
 .../data-types/{domains => }/ipv4.md          | 27 +++------------
 .../data-types/{domains => }/ipv6.md          | 29 +++-------------
 .../functions/ip-address-functions.md         |  6 ++--
 docs/redirects.txt                            | 10 +++---
 10 files changed, 41 insertions(+), 79 deletions(-)
 rename docs/en/sql-reference/data-types/{domains => }/ipv4.md (60%)
 rename docs/en/sql-reference/data-types/{domains => }/ipv6.md (61%)

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index 2ab9e8caec4..d75fb32b571 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -1292,8 +1292,8 @@ For output it uses the following correspondence between ClickHouse types and BSO
 | [Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                                   | `\x04` array                                                                                                  |
 | [Named Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                             | `\x03` document                                                                                               |
 | [Map](/docs/en/sql-reference/data-types/map.md)                                                                       | `\x03` document                                                                                               |
-| [IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)                                                             | `\x10` int32                                                                                                  |
-| [IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                             | `\x05` binary, `\x00` binary subtype                                                                          |
+| [IPv4](/docs/en/sql-reference/data-types/ipv4.md)                                                                     | `\x10` int32                                                                                                  |
+| [IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                                     | `\x05` binary, `\x00` binary subtype                                                                          |
 
 For input it uses the following correspondence between BSON types and ClickHouse types:
 
@@ -1303,7 +1303,7 @@ For input it uses the following correspondence between BSON types and ClickHouse
 | `\x02` string                            | [String](/docs/en/sql-reference/data-types/string.md)/[FixedString](/docs/en/sql-reference/data-types/fixedstring.md)                                                                                                                       |
 | `\x03` document                          | [Map](/docs/en/sql-reference/data-types/map.md)/[Named Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                                                                                                   |
 | `\x04` array                             | [Array](/docs/en/sql-reference/data-types/array.md)/[Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                                                                                                     |
-| `\x05` binary, `\x00` binary subtype     | [String](/docs/en/sql-reference/data-types/string.md)/[FixedString](/docs/en/sql-reference/data-types/fixedstring.md)/[IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                             |
+| `\x05` binary, `\x00` binary subtype     | [String](/docs/en/sql-reference/data-types/string.md)/[FixedString](/docs/en/sql-reference/data-types/fixedstring.md)/[IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                             |
 | `\x05` binary, `\x02` old binary subtype | [String](/docs/en/sql-reference/data-types/string.md)/[FixedString](/docs/en/sql-reference/data-types/fixedstring.md)                                                                                                                       |
 | `\x05` binary, `\x03` old uuid subtype   | [UUID](/docs/en/sql-reference/data-types/uuid.md)                                                                                                                                                                                           |
 | `\x05` binary, `\x04` uuid subtype       | [UUID](/docs/en/sql-reference/data-types/uuid.md)                                                                                                                                                                                           |
@@ -1313,7 +1313,7 @@ For input it uses the following correspondence between BSON types and ClickHouse
 | `\x0A` null value                        | [NULL](/docs/en/sql-reference/data-types/nullable.md)                                                                                                                                                                                       |
 | `\x0D` JavaScript code                   | [String](/docs/en/sql-reference/data-types/string.md)/[FixedString](/docs/en/sql-reference/data-types/fixedstring.md)                                                                                                                       |
 | `\x0E` symbol                            | [String](/docs/en/sql-reference/data-types/string.md)/[FixedString](/docs/en/sql-reference/data-types/fixedstring.md)                                                                                                                       |
-| `\x10` int32                             | [Int32/UInt32](/docs/en/sql-reference/data-types/int-uint.md)/[Decimal32](/docs/en/sql-reference/data-types/decimal.md)/[IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)/[Enum8/Enum16](/docs/en/sql-reference/data-types/enum.md) |
+| `\x10` int32                             | [Int32/UInt32](/docs/en/sql-reference/data-types/int-uint.md)/[Decimal32](/docs/en/sql-reference/data-types/decimal.md)/[IPv4](/docs/en/sql-reference/data-types/ipv4.md)/[Enum8/Enum16](/docs/en/sql-reference/data-types/enum.md) |
 | `\x12` int64                             | [Int64/UInt64](/docs/en/sql-reference/data-types/int-uint.md)/[Decimal64](/docs/en/sql-reference/data-types/decimal.md)/[DateTime64](/docs/en/sql-reference/data-types/datetime64.md)                                                       |
 
 Other BSON types are not supported. Also, it performs conversion between different integer types (for example, you can insert BSON int32 value into ClickHouse UInt8).
@@ -1663,8 +1663,8 @@ The table below shows supported data types and how they match ClickHouse [data t
 | `ENUM`                                               | [Enum(8/16)](/docs/en/sql-reference/data-types/enum.md)                                                                                                                        | `ENUM`                                               |
 | `LIST`                                               | [Array](/docs/en/sql-reference/data-types/array.md)                                                                                                                            | `LIST`                                               |
 | `STRUCT`                                             | [Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                                                                                            | `STRUCT`                                             |
-| `UINT32`                                             | [IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)                                                                                                                      | `UINT32`                                             |
-| `DATA`                                               | [IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                                                                                      | `DATA`                                               |
+| `UINT32`                                             | [IPv4](/docs/en/sql-reference/data-types/ipv4.md)                                                                                                                              | `UINT32`                                             |
+| `DATA`                                               | [IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                                                                                              | `DATA`                                               |
 | `DATA`                                               | [Int128/UInt128/Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                                                                                                 | `DATA`                                               |
 | `DATA`                                               | [Decimal128/Decimal256](/docs/en/sql-reference/data-types/decimal.md)                                                                                                          | `DATA`                                               |
 | `STRUCT(entries LIST(STRUCT(key Key, value Value)))` | [Map](/docs/en/sql-reference/data-types/map.md)                                                                                                                                | `STRUCT(entries LIST(STRUCT(key Key, value Value)))` |
@@ -1866,8 +1866,8 @@ The table below shows supported data types and how they match ClickHouse [data t
 | `long (timestamp-millis)` \**               | [DateTime64(3)](/docs/en/sql-reference/data-types/datetime.md)                                                                | `long (timestamp-millis)` \** |
 | `long (timestamp-micros)` \**               | [DateTime64(6)](/docs/en/sql-reference/data-types/datetime.md)                                                                | `long (timestamp-micros)` \** |
 | `bytes (decimal)`  \**                      | [DateTime64(N)](/docs/en/sql-reference/data-types/datetime.md)                                                                | `bytes (decimal)`  \**        |
-| `int`                                       | [IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)                                                                     | `int`                         |
-| `fixed(16)`                                 | [IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                                     | `fixed(16)`                   |
+| `int`                                       | [IPv4](/docs/en/sql-reference/data-types/ipv4.md)                                                                             | `int`                         |
+| `fixed(16)`                                 | [IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                                             | `fixed(16)`                   |
 | `bytes (decimal)` \**                       | [Decimal(P, S)](/docs/en/sql-reference/data-types/decimal.md)                                                                 | `bytes (decimal)` \**         |
 | `string (uuid)` \**                         | [UUID](/docs/en/sql-reference/data-types/uuid.md)                                                                             | `string (uuid)` \**           |
 | `fixed(16)`                                 | [Int128/UInt128](/docs/en/sql-reference/data-types/int-uint.md)                                                               | `fixed(16)`                   |
@@ -2001,9 +2001,9 @@ The table below shows supported data types and how they match ClickHouse [data t
 | `LIST`                                        | [Array](/docs/en/sql-reference/data-types/array.md)                                                        | `LIST`                        |
 | `STRUCT`                                      | [Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                        | `STRUCT`                      |
 | `MAP`                                         | [Map](/docs/en/sql-reference/data-types/map.md)                                                            | `MAP`                         |
-| `UINT32`                                      | [IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)                                                  | `UINT32`                      |
-| `FIXED_LENGTH_BYTE_ARRAY`, `BINARY`           | [IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                  | `FIXED_LENGTH_BYTE_ARRAY`     |
-| `FIXED_LENGTH_BYTE_ARRAY`, `BINARY`           | [Int128/UInt128/Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                     | `FIXED_LENGTH_BYTE_ARRAY`     |
+| `UINT32`                                      | [IPv4](/docs/en/sql-reference/data-types/ipv4.md)                                                          | `UINT32`                      |
+| `FIXED_LENGTH_BYTE_ARRAY`, `BINARY`           | [IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                          | `FIXED_LENGTH_BYTE_ARRAY`     |
+| `FIXED_LENGTH_BYTE_ARRAY`, `BINARY`           | [Int128/UInt128/Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                             | `FIXED_LENGTH_BYTE_ARRAY`     |
 
 Arrays can be nested and can have a value of the `Nullable` type as an argument. `Tuple` and `Map` types also can be nested.
 
@@ -2057,7 +2057,7 @@ Special format for reading Parquet file metadata (https://parquet.apache.org/doc
   - logical_type - column logical type
   - compression - compression used for this column
   - total_uncompressed_size - total uncompressed bytes size of the column, calculated as the sum of total_uncompressed_size of the column from all row groups
-  - total_compressed_size - total compressed bytes size of the column,  calculated as the sum of total_compressed_size of the column from all row groups 
+  - total_compressed_size - total compressed bytes size of the column,  calculated as the sum of total_compressed_size of the column from all row groups
   - space_saved - percent of space saved by compression, calculated as (1 - total_compressed_size/total_uncompressed_size).
   - encodings - the list of encodings used for this column
 - row_groups - the list of row groups metadata with the next structure:
@@ -2204,9 +2204,9 @@ The table below shows supported data types and how they match ClickHouse [data t
 | `LIST`                                  | [Array](/docs/en/sql-reference/data-types/array.md)                                                        | `LIST`                     |
 | `STRUCT`                                | [Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                        | `STRUCT`                   |
 | `MAP`                                   | [Map](/docs/en/sql-reference/data-types/map.md)                                                            | `MAP`                      |
-| `UINT32`                                | [IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)                                                  | `UINT32`                   |
-| `FIXED_SIZE_BINARY`, `BINARY`           | [IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                  | `FIXED_SIZE_BINARY`        |
-| `FIXED_SIZE_BINARY`, `BINARY`           | [Int128/UInt128/Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                     | `FIXED_SIZE_BINARY`        |
+| `UINT32`                                | [IPv4](/docs/en/sql-reference/data-types/ipv4.md)                                                          | `UINT32`                   |
+| `FIXED_SIZE_BINARY`, `BINARY`           | [IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                          | `FIXED_SIZE_BINARY`        |
+| `FIXED_SIZE_BINARY`, `BINARY`           | [Int128/UInt128/Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                             | `FIXED_SIZE_BINARY`        |
 
 Arrays can be nested and can have a value of the `Nullable` type as an argument. `Tuple` and `Map` types also can be nested.
 
@@ -2272,7 +2272,7 @@ The table below shows supported data types and how they match ClickHouse [data t
 | `Struct`                              | [Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                               | `Struct`                 |
 | `Map`                                 | [Map](/docs/en/sql-reference/data-types/map.md)                                                                   | `Map`                    |
 | `Int`                                 | [IPv4](/docs/en/sql-reference/data-types/int-uint.md)                                                             | `Int`                    |
-| `Binary`                              | [IPv6](/docs/en/sql-reference/data-types/domains/ipv6.md)                                                         | `Binary`                 |
+| `Binary`                              | [IPv6](/docs/en/sql-reference/data-types/ipv6.md)                                                                 | `Binary`                 |
 | `Binary`                              | [Int128/UInt128/Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                                    | `Binary`                 |
 | `Binary`                              | [Decimal256](/docs/en/sql-reference/data-types/decimal.md)                                                        | `Binary`                 |
 
@@ -2485,7 +2485,7 @@ ClickHouse supports reading and writing [MessagePack](https://msgpack.org/) data
 | `uint 64`                                                          | [DateTime64](/docs/en/sql-reference/data-types/datetime.md)                                             | `uint 64`                        |
 | `fixarray`, `array 16`, `array 32`                                 | [Array](/docs/en/sql-reference/data-types/array.md)/[Tuple](/docs/en/sql-reference/data-types/tuple.md) | `fixarray`, `array 16`, `array 32` |
 | `fixmap`, `map 16`, `map 32`                                       | [Map](/docs/en/sql-reference/data-types/map.md)                                                         | `fixmap`, `map 16`, `map 32`     |
-| `uint 32`                                                          | [IPv4](/docs/en/sql-reference/data-types/domains/ipv4.md)                                               | `uint 32`                        |
+| `uint 32`                                                          | [IPv4](/docs/en/sql-reference/data-types/ipv4.md)                                                       | `uint 32`                        |
 | `bin 8`                                                            | [String](/docs/en/sql-reference/data-types/string.md)                                                   | `bin 8`                          |
 | `int 8`                                                            | [Enum8](/docs/en/sql-reference/data-types/enum.md)                                                      | `int 8`                          |
 | `bin 8`                                                            | [(U)Int128/(U)Int256](/docs/en/sql-reference/data-types/int-uint.md)                                    | `bin 8`                          |
diff --git a/docs/en/operations/system-tables/query_log.md b/docs/en/operations/system-tables/query_log.md
index 71e1452cef1..b9fdd19c643 100644
--- a/docs/en/operations/system-tables/query_log.md
+++ b/docs/en/operations/system-tables/query_log.md
@@ -71,11 +71,11 @@ Columns:
     - 0 — Query was initiated by another query as part of distributed query execution.
 - `user` ([String](../../sql-reference/data-types/string.md)) — Name of the user who initiated the current query.
 - `query_id` ([String](../../sql-reference/data-types/string.md)) — ID of the query.
-- `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP address that was used to make the query.
+- `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP address that was used to make the query.
 - `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — The client port that was used to make the query.
 - `initial_user` ([String](../../sql-reference/data-types/string.md)) — Name of the user who ran the initial query (for distributed query execution).
 - `initial_query_id` ([String](../../sql-reference/data-types/string.md)) — ID of the initial query (for distributed query execution).
-- `initial_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP address that the parent query was launched from.
+- `initial_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP address that the parent query was launched from.
 - `initial_port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — The client port that was used to make the parent query.
 - `initial_query_start_time` ([DateTime](../../sql-reference/data-types/datetime.md)) — Initial query starting time (for distributed query execution).
 - `initial_query_start_time_microseconds` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — Initial query starting time with microseconds precision (for distributed query execution).
diff --git a/docs/en/operations/system-tables/query_thread_log.md b/docs/en/operations/system-tables/query_thread_log.md
index cdd23bb15db..a6d5632ade9 100644
--- a/docs/en/operations/system-tables/query_thread_log.md
+++ b/docs/en/operations/system-tables/query_thread_log.md
@@ -40,11 +40,11 @@ Columns:
     - 0 — Query was initiated by another query for distributed query execution.
 - `user` ([String](../../sql-reference/data-types/string.md)) — Name of the user who initiated the current query.
 - `query_id` ([String](../../sql-reference/data-types/string.md)) — ID of the query.
-- `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP address that was used to make the query.
+- `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP address that was used to make the query.
 - `port` ([UInt16](../../sql-reference/data-types/int-uint.md#uint-ranges)) — The client port that was used to make the query.
 - `initial_user` ([String](../../sql-reference/data-types/string.md)) — Name of the user who ran the initial query (for distributed query execution).
 - `initial_query_id` ([String](../../sql-reference/data-types/string.md)) — ID of the initial query (for distributed query execution).
-- `initial_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP address that the parent query was launched from.
+- `initial_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP address that the parent query was launched from.
 - `initial_port` ([UInt16](../../sql-reference/data-types/int-uint.md#uint-ranges)) — The client port that was used to make the parent query.
 - `interface` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Interface that the query was initiated from. Possible values:
     - 1 — TCP.
diff --git a/docs/en/operations/system-tables/session_log.md b/docs/en/operations/system-tables/session_log.md
index 661d34677e4..5b1a2b2a489 100644
--- a/docs/en/operations/system-tables/session_log.md
+++ b/docs/en/operations/system-tables/session_log.md
@@ -28,7 +28,7 @@ Columns:
 - `profiles` ([Array](../../sql-reference/data-types/array.md)([LowCardinality(String)](../../sql-reference/data-types/lowcardinality.md))) — The list of profiles set for all roles and/or users.
 - `roles` ([Array](../../sql-reference/data-types/array.md)([LowCardinality(String)](../../sql-reference/data-types/lowcardinality.md))) — The list of roles to which the profile is applied.
 - `settings` ([Array](../../sql-reference/data-types/array.md)([Tuple](../../sql-reference/data-types/tuple.md)([LowCardinality(String)](../../sql-reference/data-types/lowcardinality.md), [String](../../sql-reference/data-types/string.md)))) — Settings that were changed when the client logged in/out.
-- `client_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — The IP address that was used to log in/out.
+- `client_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — The IP address that was used to log in/out.
 - `client_port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — The client port that was used to log in/out.
 - `interface` ([Enum8](../../sql-reference/data-types/enum.md)) — The interface from which the login was initiated. Possible values:
     - `TCP`
diff --git a/docs/en/operations/system-tables/zookeeper_log.md b/docs/en/operations/system-tables/zookeeper_log.md
index b7cc4e22cd6..dce5be29f62 100644
--- a/docs/en/operations/system-tables/zookeeper_log.md
+++ b/docs/en/operations/system-tables/zookeeper_log.md
@@ -15,7 +15,7 @@ Columns with request parameters:
     - `Finalize` — The connection is lost, no response was received.
 - `event_date` ([Date](../../sql-reference/data-types/date.md)) — The date when the event happened.
 - `event_time` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — The date and time when the event happened.
-- `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP address of ZooKeeper server that was used to make the request.
+- `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP address of ZooKeeper server that was used to make the request.
 - `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — The port of ZooKeeper server that was used to make the request.
 - `session_id` ([Int64](../../sql-reference/data-types/int-uint.md)) — The session ID that the ZooKeeper server sets for each connection.
 - `xid` ([Int32](../../sql-reference/data-types/int-uint.md)) — The ID of the request within the session. This is usually a sequential request number. It is the same for the request row and the paired `response`/`finalize` row.
diff --git a/docs/en/sql-reference/data-types/index.md b/docs/en/sql-reference/data-types/index.md
index 508307a0543..ffd063590fa 100644
--- a/docs/en/sql-reference/data-types/index.md
+++ b/docs/en/sql-reference/data-types/index.md
@@ -28,6 +28,6 @@ ClickHouse data types include:
 - **Nested data structures**: A [`Nested` data structure](./nested-data-structures/index.md) is like a table inside a cell
 - **Tuples**: A [`Tuple` of elements](./tuple.md), each having an individual type.
 - **Nullable**: [`Nullable`](./nullable.md) allows you to store a value as `NULL` when a value is "missing" (instead of the column settings its default value for the data type)
-- **IP addresses**: use [`IPv4`](./domains/ipv4.md) and [`IPv6`](./domains/ipv6.md) to efficiently store IP addresses
+- **IP addresses**: use [`IPv4`](./ipv4.md) and [`IPv6`](./ipv6.md) to efficiently store IP addresses
 - **Geo types**: for [geographical data](./geo.md), including `Point`, `Ring`, `Polygon` and `MultiPolygon`
 - **Special data types**: including [`Expression`](./special-data-types/expression.md), [`Set`](./special-data-types/set.md), [`Nothing`](./special-data-types/nothing.md) and [`Interval`](./special-data-types/interval.md)
diff --git a/docs/en/sql-reference/data-types/domains/ipv4.md b/docs/en/sql-reference/data-types/ipv4.md
similarity index 60%
rename from docs/en/sql-reference/data-types/domains/ipv4.md
rename to docs/en/sql-reference/data-types/ipv4.md
index b34814211fc..288806f47b3 100644
--- a/docs/en/sql-reference/data-types/domains/ipv4.md
+++ b/docs/en/sql-reference/data-types/ipv4.md
@@ -1,12 +1,12 @@
 ---
-slug: /en/sql-reference/data-types/domains/ipv4
+slug: /en/sql-reference/data-types/ipv4
 sidebar_position: 59
 sidebar_label: IPv4
 ---
 
 ## IPv4
 
-`IPv4` is a domain based on `UInt32` type and serves as a typed replacement for storing IPv4 values. It provides compact storage with the human-friendly input-output format and column type information on inspection.
+IPv4 addresses. Stored in 4 bytes as UInt32.
 
 ### Basic Usage
 
@@ -57,25 +57,6 @@ SELECT toTypeName(from), hex(from) FROM hits LIMIT 1;
 └──────────────────┴───────────┘
 ```
 
-Domain values are not implicitly convertible to types other than `UInt32`.
-If you want to convert `IPv4` value to a string, you have to do that explicitly with `IPv4NumToString()` function:
+**See Also**
 
-``` sql
-SELECT toTypeName(s), IPv4NumToString(from) as s FROM hits LIMIT 1;
-```
-
-    ┌─toTypeName(IPv4NumToString(from))─┬─s──────────────┐
-    │ String                            │ 183.247.232.58 │
-    └───────────────────────────────────┴────────────────┘
-
-Or cast to a `UInt32` value:
-
-``` sql
-SELECT toTypeName(i), CAST(from as UInt32) as i FROM hits LIMIT 1;
-```
-
-``` text
-┌─toTypeName(CAST(from, 'UInt32'))─┬──────────i─┐
-│ UInt32                           │ 3086477370 │
-└──────────────────────────────────┴────────────┘
-```
+- [Functions for Working with IPv4 and IPv6 Addresses](../functions/ip-address-functions.md)
diff --git a/docs/en/sql-reference/data-types/domains/ipv6.md b/docs/en/sql-reference/data-types/ipv6.md
similarity index 61%
rename from docs/en/sql-reference/data-types/domains/ipv6.md
rename to docs/en/sql-reference/data-types/ipv6.md
index dcb22e3cb6d..284a1f80854 100644
--- a/docs/en/sql-reference/data-types/domains/ipv6.md
+++ b/docs/en/sql-reference/data-types/ipv6.md
@@ -1,12 +1,12 @@
 ---
-slug: /en/sql-reference/data-types/domains/ipv6
+slug: /en/sql-reference/data-types/ipv6
 sidebar_position: 60
 sidebar_label: IPv6
 ---
 
 ## IPv6
 
-`IPv6` is a domain based on `FixedString(16)` type and serves as a typed replacement for storing IPv6 values. It provides compact storage with the human-friendly input-output format and column type information on inspection.
+IPv6 addresses. Stored in 16 bytes as UInt128.
 
 ### Basic Usage
 
@@ -57,27 +57,6 @@ SELECT toTypeName(from), hex(from) FROM hits LIMIT 1;
 └──────────────────┴──────────────────────────────────┘
 ```
 
-Domain values are not implicitly convertible to types other than `FixedString(16)`.
-If you want to convert `IPv6` value to a string, you have to do that explicitly with `IPv6NumToString()` function:
+**See Also**
 
-``` sql
-SELECT toTypeName(s), IPv6NumToString(from) as s FROM hits LIMIT 1;
-```
-
-``` text
-┌─toTypeName(IPv6NumToString(from))─┬─s─────────────────────────────┐
-│ String                            │ 2001:44c8:129:2632:33:0:252:2 │
-└───────────────────────────────────┴───────────────────────────────┘
-```
-
-Or cast to a `FixedString(16)` value:
-
-``` sql
-SELECT toTypeName(i), CAST(from as FixedString(16)) as i FROM hits LIMIT 1;
-```
-
-``` text
-┌─toTypeName(CAST(from, 'FixedString(16)'))─┬─i───────┐
-│ FixedString(16)                           │  ��� │
-└───────────────────────────────────────────┴─────────┘
-```
+- [Functions for Working with IPv4 and IPv6 Addresses](../functions/ip-address-functions.md)
diff --git a/docs/en/sql-reference/functions/ip-address-functions.md b/docs/en/sql-reference/functions/ip-address-functions.md
index 0dc1db1161b..33c788a632e 100644
--- a/docs/en/sql-reference/functions/ip-address-functions.md
+++ b/docs/en/sql-reference/functions/ip-address-functions.md
@@ -248,7 +248,7 @@ SELECT IPv6CIDRToRange(toIPv6('2001:0db8:0000:85a3:0000:0000:ac1f:8001'), 32);
 
 ## toIPv4(string)
 
-An alias to `IPv4StringToNum()` that takes a string form of IPv4 address and returns value of [IPv4](../../sql-reference/data-types/domains/ipv4.md) type, which is binary equal to value returned by `IPv4StringToNum()`.
+An alias to `IPv4StringToNum()` that takes a string form of IPv4 address and returns value of [IPv4](../../sql-reference/data-types/ipv4.md) type, which is binary equal to value returned by `IPv4StringToNum()`.
 
 ``` sql
 WITH
@@ -296,7 +296,7 @@ Same as `toIPv6`, but if the IPv6 address has an invalid format, it returns null
 
 ## toIPv6
 
-Converts a string form of IPv6 address to [IPv6](../../sql-reference/data-types/domains/ipv6.md) type. If the IPv6 address has an invalid format, returns an empty value.
+Converts a string form of IPv6 address to [IPv6](../../sql-reference/data-types/ipv6.md) type. If the IPv6 address has an invalid format, returns an empty value.
 Similar to [IPv6StringToNum](#ipv6stringtonums) function, which converts IPv6 address to binary format.
 
 If the input string contains a valid IPv4 address, then the IPv6 equivalent of the IPv4 address is returned.
@@ -315,7 +315,7 @@ toIPv6(string)
 
 - IP address.
 
-Type: [IPv6](../../sql-reference/data-types/domains/ipv6.md).
+Type: [IPv6](../../sql-reference/data-types/ipv6.md).
 
 **Examples**
 
diff --git a/docs/redirects.txt b/docs/redirects.txt
index cea138f7237..3abc8df2b7f 100644
--- a/docs/redirects.txt
+++ b/docs/redirects.txt
@@ -14,7 +14,7 @@ data_types/datetime.md sql-reference/data-types/datetime.md
 data_types/datetime64.md sql-reference/data-types/datetime64.md
 data_types/decimal.md sql-reference/data-types/decimal.md
 data_types/domains/ipv4.md sql-reference/data-types/domains/ipv4.md
-data_types/domains/ipv6.md sql-reference/data-types/domains/ipv6.md
+data_types/domains/ipv6.md sql-reference/data-types/ipv6.md
 data_types/domains/overview.md sql-reference/data-types/domains/overview.md
 data_types/enum.md sql-reference/data-types/enum.md
 data_types/fixedstring.md sql-reference/data-types/fixedstring.md
@@ -162,7 +162,7 @@ interfaces/third-party/client_libraries.md interfaces/third-party/client-librari
 interfaces/third-party_client_libraries.md interfaces/third-party/client-libraries.md
 interfaces/third-party_gui.md interfaces/third-party/gui.md
 interfaces/third_party/index.md interfaces/third-party/index.md
-introduction/index.md 
+introduction/index.md
 introduction/distinctive_features.md introduction/distinctive-features.md
 introduction/features_considered_disadvantages.md introduction/distinctive-features.md
 introduction/possible_silly_questions.md faq/general.md
@@ -305,8 +305,10 @@ sql_reference/data_types/datetime.md sql-reference/data-types/datetime.md
 sql_reference/data_types/datetime64.md sql-reference/data-types/datetime64.md
 sql_reference/data_types/decimal.md sql-reference/data-types/decimal.md
 sql_reference/data_types/domains/index.md sql-reference/data-types/domains/index.md
-sql_reference/data_types/domains/ipv4.md sql-reference/data-types/domains/ipv4.md
-sql_reference/data_types/domains/ipv6.md sql-reference/data-types/domains/ipv6.md
+sql_reference/data_types/domains/ipv4.md sql-reference/data-types/ipv4.md
+sql_reference/data-types/domains/ipv4.md sql-reference/data-types/ipv4.md
+sql_reference/data_types/domains/ipv6.md sql-reference/data-types/ipv6.md
+sql_reference/data-types/domains/ipv6.md sql-reference/data-types/ipv6.md
 sql_reference/data_types/domains/overview.md sql-reference/data-types/domains/overview.md
 sql_reference/data_types/enum.md sql-reference/data-types/enum.md
 sql_reference/data_types/fixedstring.md sql-reference/data-types/fixedstring.md

From 2923d57757cd28dde82d8edd762c1912129a68e4 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 15:37:32 -0300
Subject: [PATCH 202/722] Update redirects.txt

---
 docs/redirects.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/redirects.txt b/docs/redirects.txt
index 3abc8df2b7f..98d6f6b8f7c 100644
--- a/docs/redirects.txt
+++ b/docs/redirects.txt
@@ -13,7 +13,7 @@ data_types/date.md sql-reference/data-types/date.md
 data_types/datetime.md sql-reference/data-types/datetime.md
 data_types/datetime64.md sql-reference/data-types/datetime64.md
 data_types/decimal.md sql-reference/data-types/decimal.md
-data_types/domains/ipv4.md sql-reference/data-types/domains/ipv4.md
+data_types/domains/ipv4.md sql-reference/data-types/ipv4.md
 data_types/domains/ipv6.md sql-reference/data-types/ipv6.md
 data_types/domains/overview.md sql-reference/data-types/domains/overview.md
 data_types/enum.md sql-reference/data-types/enum.md

From aa35689cb10dbdbab0c8475a7f92b8978e6eb6b8 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 19:39:30 -0300
Subject: [PATCH 203/722] fix links in other lang-s

---
 docs/ru/operations/system-tables/query_log.md           | 4 ++--
 docs/ru/operations/system-tables/query_thread_log.md    | 4 ++--
 docs/ru/operations/system-tables/session_log.md         | 2 +-
 docs/ru/operations/system-tables/zookeeper_log.md       | 2 +-
 docs/ru/sql-reference/data-types/{domains => }/ipv4.md  | 2 +-
 docs/ru/sql-reference/data-types/{domains => }/ipv6.md  | 2 +-
 docs/ru/sql-reference/functions/ip-address-functions.md | 4 ++--
 docs/zh/operations/system-tables/query_log.md           | 4 ++--
 docs/zh/operations/system-tables/query_thread_log.md    | 4 ++--
 docs/zh/operations/system-tables/zookeeper_log.md       | 2 +-
 docs/zh/sql-reference/data-types/{domains => }/ipv4.md  | 2 +-
 docs/zh/sql-reference/data-types/{domains => }/ipv6.md  | 2 +-
 12 files changed, 17 insertions(+), 17 deletions(-)
 rename docs/ru/sql-reference/data-types/{domains => }/ipv4.md (98%)
 rename docs/ru/sql-reference/data-types/{domains => }/ipv6.md (98%)
 rename docs/zh/sql-reference/data-types/{domains => }/ipv4.md (98%)
 rename docs/zh/sql-reference/data-types/{domains => }/ipv6.md (98%)

diff --git a/docs/ru/operations/system-tables/query_log.md b/docs/ru/operations/system-tables/query_log.md
index a55528bd829..8f858c14fb1 100644
--- a/docs/ru/operations/system-tables/query_log.md
+++ b/docs/ru/operations/system-tables/query_log.md
@@ -69,11 +69,11 @@ ClickHouse не удаляет данные из таблица автомати
     -   0 — запрос был инициирован другим запросом при выполнении распределенного запроса.
 -   `user` ([String](../../sql-reference/data-types/string.md)) — пользователь, запустивший текущий запрос.
 -   `query_id` ([String](../../sql-reference/data-types/string.md)) — ID запроса.
--   `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP адрес, с которого пришел запрос.
+-   `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP адрес, с которого пришел запрос.
 -   `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — порт, с которого клиент сделал запрос
 -   `initial_user` ([String](../../sql-reference/data-types/string.md)) — пользователь, запустивший первоначальный запрос (для распределенных запросов).
 -   `initial_query_id` ([String](../../sql-reference/data-types/string.md)) — ID родительского запроса.
--   `initial_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP адрес, с которого пришел родительский запрос.
+-   `initial_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP адрес, с которого пришел родительский запрос.
 -   `initial_port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — порт, с которого клиент сделал родительский запрос.
 -   `initial_query_start_time` ([DateTime](../../sql-reference/data-types/datetime.md)) — время начала обработки запроса (для распределенных запросов).
 -   `initial_query_start_time_microseconds` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — время начала обработки запроса с точностью до микросекунд (для распределенных запросов).
diff --git a/docs/ru/operations/system-tables/query_thread_log.md b/docs/ru/operations/system-tables/query_thread_log.md
index c9aabb02cad..1a256e1657a 100644
--- a/docs/ru/operations/system-tables/query_thread_log.md
+++ b/docs/ru/operations/system-tables/query_thread_log.md
@@ -39,11 +39,11 @@ ClickHouse не удаляет данные из таблицы автомати
     -   0 — запрос был инициирован другим запросом при распределенном запросе.
 -   `user` ([String](../../sql-reference/data-types/string.md)) — пользователь, запустивший текущий запрос.
 -   `query_id` ([String](../../sql-reference/data-types/string.md)) — ID запроса.
--   `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP адрес, с которого пришел запрос.
+-   `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP адрес, с которого пришел запрос.
 -   `port` ([UInt16](../../sql-reference/data-types/int-uint.md#uint-ranges)) — порт, с которого пришел запрос.
 -   `initial_user` ([String](../../sql-reference/data-types/string.md)) — пользователь, запустивший первоначальный запрос (для распределенных запросов).
 -   `initial_query_id` ([String](../../sql-reference/data-types/string.md)) — ID родительского запроса.
--   `initial_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP адрес, с которого пришел родительский запрос.
+-   `initial_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP адрес, с которого пришел родительский запрос.
 -   `initial_port` ([UInt16](../../sql-reference/data-types/int-uint.md#uint-ranges)) — порт, пришел родительский запрос.
 -   `interface` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — интерфейс, с которого ушёл запрос. Возможные значения:
     -   1 — TCP.
diff --git a/docs/ru/operations/system-tables/session_log.md b/docs/ru/operations/system-tables/session_log.md
index 1f313e7815a..5849cb51ab4 100644
--- a/docs/ru/operations/system-tables/session_log.md
+++ b/docs/ru/operations/system-tables/session_log.md
@@ -27,7 +27,7 @@ slug: /ru/operations/system-tables/session_log
 -   `profiles` ([Array](../../sql-reference/data-types/array.md)([LowCardinality(String)](../../sql-reference/data-types/lowcardinality.md))) — список профилей, установленных для всех ролей и (или) пользователей.
 -   `roles` ([Array](../../sql-reference/data-types/array.md)([LowCardinality(String)](../../sql-reference/data-types/lowcardinality.md))) — список ролей, к которым применяется данный профиль.
 -   `settings` ([Array](../../sql-reference/data-types/array.md)([Tuple](../../sql-reference/data-types/tuple.md)([LowCardinality(String)](../../sql-reference/data-types/lowcardinality.md), [String](../../sql-reference/data-types/string.md)))) — настройки, которые были изменены при входе или выходе клиента из системы.
--   `client_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP-адрес, который использовался для входа или выхода из системы.
+-   `client_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP-адрес, который использовался для входа или выхода из системы.
 -   `client_port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — порт клиента, который использовался для входа или выхода из системы.
 -   `interface` ([Enum8](../../sql-reference/data-types/enum.md)) — интерфейс, с которого был инициирован вход в систему. Возможные значения:
     -   `TCP`
diff --git a/docs/ru/operations/system-tables/zookeeper_log.md b/docs/ru/operations/system-tables/zookeeper_log.md
index ccbdd5110ad..9874cb3a269 100644
--- a/docs/ru/operations/system-tables/zookeeper_log.md
+++ b/docs/ru/operations/system-tables/zookeeper_log.md
@@ -15,7 +15,7 @@ slug: /ru/operations/system-tables/zookeeper_log
     -   `Finalize` — соединение разорвано, ответ не получен.
 -   `event_date` ([Date](../../sql-reference/data-types/date.md)) — дата, когда произошло событие.
 -   `event_time` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — дата и время, когда произошло событие.
--   `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — IP адрес сервера ZooKeeper, с которого был сделан запрос.
+-   `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — IP адрес сервера ZooKeeper, с которого был сделан запрос.
 -   `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — порт сервера ZooKeeper, с которого был сделан запрос.
 -   `session_id` ([Int64](../../sql-reference/data-types/int-uint.md)) — идентификатор сессии, который сервер ZooKeeper создает для каждого соединения.
 -   `xid` ([Int32](../../sql-reference/data-types/int-uint.md)) — идентификатор запроса внутри сессии. Обычно это последовательный номер запроса, одинаковый у строки запроса и у парной строки `response`/`finalize`.
diff --git a/docs/ru/sql-reference/data-types/domains/ipv4.md b/docs/ru/sql-reference/data-types/ipv4.md
similarity index 98%
rename from docs/ru/sql-reference/data-types/domains/ipv4.md
rename to docs/ru/sql-reference/data-types/ipv4.md
index 57a19e282ae..8d308785eea 100644
--- a/docs/ru/sql-reference/data-types/domains/ipv4.md
+++ b/docs/ru/sql-reference/data-types/ipv4.md
@@ -1,5 +1,5 @@
 ---
-slug: /ru/sql-reference/data-types/domains/ipv4
+slug: /ru/sql-reference/data-types/ipv4
 sidebar_position: 59
 sidebar_label: IPv4
 ---
diff --git a/docs/ru/sql-reference/data-types/domains/ipv6.md b/docs/ru/sql-reference/data-types/ipv6.md
similarity index 98%
rename from docs/ru/sql-reference/data-types/domains/ipv6.md
rename to docs/ru/sql-reference/data-types/ipv6.md
index fdfb26f68c1..808068ce90a 100644
--- a/docs/ru/sql-reference/data-types/domains/ipv6.md
+++ b/docs/ru/sql-reference/data-types/ipv6.md
@@ -1,5 +1,5 @@
 ---
-slug: /ru/sql-reference/data-types/domains/ipv6
+slug: /ru/sql-reference/data-types/ipv6
 sidebar_position: 60
 sidebar_label: IPv6
 ---
diff --git a/docs/ru/sql-reference/functions/ip-address-functions.md b/docs/ru/sql-reference/functions/ip-address-functions.md
index 96d4b737c88..d1a72b82b67 100644
--- a/docs/ru/sql-reference/functions/ip-address-functions.md
+++ b/docs/ru/sql-reference/functions/ip-address-functions.md
@@ -265,7 +265,7 @@ SELECT
 
 ## toIPv6 {#toipv6string}
 
-Приводит строку с адресом в формате IPv6 к типу [IPv6](../../sql-reference/data-types/domains/ipv6.md). Возвращает пустое значение, если входящая строка не является корректным IP адресом.
+Приводит строку с адресом в формате IPv6 к типу [IPv6](../../sql-reference/data-types/ipv6.md). Возвращает пустое значение, если входящая строка не является корректным IP адресом.
 Похоже на функцию [IPv6StringToNum](#ipv6stringtonums), которая представляет адрес IPv6 в двоичном виде.
 
 Если входящая строка содержит корректный IPv4 адрес, функция возвращает его IPv6 эквивалент.
@@ -284,7 +284,7 @@ toIPv6(string)
 
 -   IP адрес.
 
-Тип: [IPv6](../../sql-reference/data-types/domains/ipv6.md).
+Тип: [IPv6](../../sql-reference/data-types/ipv6.md).
 
 **Примеры**
 
diff --git a/docs/zh/operations/system-tables/query_log.md b/docs/zh/operations/system-tables/query_log.md
index 7149282dfcc..0ba669906cb 100644
--- a/docs/zh/operations/system-tables/query_log.md
+++ b/docs/zh/operations/system-tables/query_log.md
@@ -60,11 +60,11 @@ ClickHouse不会自动从表中删除数据。更多详情请看 [introduction](
     -   0 — 由另一个查询发起的，作为分布式查询的一部分.
 -   `user` ([String](../../sql-reference/data-types/string.md)) — 发起查询的用户.
 -   `query_id` ([String](../../sql-reference/data-types/string.md)) — 查询ID.
--   `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — 发起查询的客户端IP地址.
+-   `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — 发起查询的客户端IP地址.
 -   `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — 发起查询的客户端端口.
 -   `initial_user` ([String](../../sql-reference/data-types/string.md)) — 初始查询的用户名（用于分布式查询执行）.
 -   `initial_query_id` ([String](../../sql-reference/data-types/string.md)) — 运行初始查询的ID（用于分布式查询执行）.
--   `initial_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — 运行父查询的IP地址.
+-   `initial_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — 运行父查询的IP地址.
 -   `initial_port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — 发起父查询的客户端端口.
 -   `interface` ([UInt8](../../sql-reference/data-types/int-uint.md)) — 发起查询的接口. 可能的值:
     -   1 — TCP.
diff --git a/docs/zh/operations/system-tables/query_thread_log.md b/docs/zh/operations/system-tables/query_thread_log.md
index 8a41c1501a6..c4b7e2f1043 100644
--- a/docs/zh/operations/system-tables/query_thread_log.md
+++ b/docs/zh/operations/system-tables/query_thread_log.md
@@ -36,11 +36,11 @@ ClickHouse不会自动从表中删除数据。 欲了解更多详情，请参照
     -   0 — 由其他查询发起的分布式查询。
 -   `user` ([字符串](../../sql-reference/data-types/string.md)) — 发起查询的用户名。
 -   `query_id` ([字符串](../../sql-reference/data-types/string.md)) — 查询的ID。
--   `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — 发起查询的IP地址。
+-   `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — 发起查询的IP地址。
 -   `port` ([UInt16](../../sql-reference/data-types/int-uint.md#uint-ranges)) — 发起查询的端口。
 -   `initial_user` ([字符串](../../sql-reference/data-types/string.md)) — 首次发起查询的用户名（对于分布式查询）。
 -   `initial_query_id` ([字符串](../../sql-reference/data-types/string.md)) — 首次发起查询的ID（对于分布式查询）。
--   `initial_address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — 发起该查询的父查询IP地址。
+-   `initial_address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — 发起该查询的父查询IP地址。
 -   `initial_port` ([UInt16](../../sql-reference/data-types/int-uint.md#uint-ranges)) — 发起该查询的父查询端口。
 -   `interface` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — 发起查询的界面，可能的值:
     -   1 — TCP.
diff --git a/docs/zh/operations/system-tables/zookeeper_log.md b/docs/zh/operations/system-tables/zookeeper_log.md
index 59dcdaecdc1..ebc51a2e79d 100644
--- a/docs/zh/operations/system-tables/zookeeper_log.md
+++ b/docs/zh/operations/system-tables/zookeeper_log.md
@@ -15,7 +15,7 @@ slug: /zh/operations/system-tables/zookeeper_log
     -   `Finalize` — 连接丢失, 未收到响应.
 -   `event_date` ([Date](../../sql-reference/data-types/date.md)) — 事件发生的日期.
 -   `event_time` ([DateTime64](../../sql-reference/data-types/datetime64.md)) — 事件发生的日期和时间.
--   `address` ([IPv6](../../sql-reference/data-types/domains/ipv6.md)) — 用于发出请求的 ZooKeeper 服务器的 IP 地址.
+-   `address` ([IPv6](../../sql-reference/data-types/ipv6.md)) — 用于发出请求的 ZooKeeper 服务器的 IP 地址.
 -   `port` ([UInt16](../../sql-reference/data-types/int-uint.md)) — 用于发出请求的 ZooKeeper 服务器的端口.
 -   `session_id` ([Int64](../../sql-reference/data-types/int-uint.md)) — ZooKeeper 服务器为每个连接设置的会话 ID.
 -   `xid` ([Int32](../../sql-reference/data-types/int-uint.md)) — 会话中请求的 ID. 这通常是一个连续的请求编号. 请求行和配对的 `response`/`finalize` 行相同.
diff --git a/docs/zh/sql-reference/data-types/domains/ipv4.md b/docs/zh/sql-reference/data-types/ipv4.md
similarity index 98%
rename from docs/zh/sql-reference/data-types/domains/ipv4.md
rename to docs/zh/sql-reference/data-types/ipv4.md
index 69e17b2f617..b89af974b87 100644
--- a/docs/zh/sql-reference/data-types/domains/ipv4.md
+++ b/docs/zh/sql-reference/data-types/ipv4.md
@@ -1,5 +1,5 @@
 ---
-slug: /zh/sql-reference/data-types/domains/ipv4
+slug: /zh/sql-reference/data-types/ipv4
 ---
 ## IPv4 {#ipv4}
 
diff --git a/docs/zh/sql-reference/data-types/domains/ipv6.md b/docs/zh/sql-reference/data-types/ipv6.md
similarity index 98%
rename from docs/zh/sql-reference/data-types/domains/ipv6.md
rename to docs/zh/sql-reference/data-types/ipv6.md
index 9dd88692c37..3896bb873d8 100644
--- a/docs/zh/sql-reference/data-types/domains/ipv6.md
+++ b/docs/zh/sql-reference/data-types/ipv6.md
@@ -1,5 +1,5 @@
 ---
-slug: /zh/sql-reference/data-types/domains/ipv6
+slug: /zh/sql-reference/data-types/ipv6
 ---
 ## IPv6 {#ipv6}
 

From 2e187e0a0eae7f0109c6af30bd6baad0e75c9b71 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Sun, 4 Jun 2023 20:12:35 -0300
Subject: [PATCH 204/722] try to fix redirect

---
 docs/redirects.txt                       |  2 --
 docs/ru/sql-reference/data-types/ipv4.md | 27 +++---------------------
 2 files changed, 3 insertions(+), 26 deletions(-)

diff --git a/docs/redirects.txt b/docs/redirects.txt
index 98d6f6b8f7c..ddfc66aa48b 100644
--- a/docs/redirects.txt
+++ b/docs/redirects.txt
@@ -306,9 +306,7 @@ sql_reference/data_types/datetime64.md sql-reference/data-types/datetime64.md
 sql_reference/data_types/decimal.md sql-reference/data-types/decimal.md
 sql_reference/data_types/domains/index.md sql-reference/data-types/domains/index.md
 sql_reference/data_types/domains/ipv4.md sql-reference/data-types/ipv4.md
-sql_reference/data-types/domains/ipv4.md sql-reference/data-types/ipv4.md
 sql_reference/data_types/domains/ipv6.md sql-reference/data-types/ipv6.md
-sql_reference/data-types/domains/ipv6.md sql-reference/data-types/ipv6.md
 sql_reference/data_types/domains/overview.md sql-reference/data-types/domains/overview.md
 sql_reference/data_types/enum.md sql-reference/data-types/enum.md
 sql_reference/data_types/fixedstring.md sql-reference/data-types/fixedstring.md
diff --git a/docs/ru/sql-reference/data-types/ipv4.md b/docs/ru/sql-reference/data-types/ipv4.md
index 8d308785eea..5cb977c64c9 100644
--- a/docs/ru/sql-reference/data-types/ipv4.md
+++ b/docs/ru/sql-reference/data-types/ipv4.md
@@ -6,7 +6,7 @@ sidebar_label: IPv4
 
 ## IPv4 {#ipv4}
 
-`IPv4` — это домен, базирующийся на типе данных `UInt32` предназначенный для хранения адресов IPv4. Он обеспечивает компактное хранение данных с удобным для человека форматом ввода-вывода, и явно отображаемым типом данных в структуре таблицы.
+IPv4-адреса. Хранится в 4 байтах как UInt32.
 
 ### Применение {#primenenie}
 
@@ -57,27 +57,6 @@ SELECT toTypeName(from), hex(from) FROM hits LIMIT 1;
 └──────────────────┴───────────┘
 ```
 
-Значения с доменным типом данных не преобразуются неявно в другие типы данных, кроме `UInt32`.
-Если необходимо преобразовать значение типа `IPv4` в строку, то это необходимо делать явно с помощью функции `IPv4NumToString()`:
+**См. также**
 
-``` sql
-SELECT toTypeName(s), IPv4NumToString(from) AS s FROM hits LIMIT 1;
-```
-
-``` text
-┌─toTypeName(IPv4NumToString(from))─┬─s──────────────┐
-│ String                            │ 183.247.232.58 │
-└───────────────────────────────────┴────────────────┘
-```
-
-Или приводить к типу данных `UInt32`:
-
-``` sql
-SELECT toTypeName(i), CAST(from AS UInt32) AS i FROM hits LIMIT 1;
-```
-
-``` text
-┌─toTypeName(CAST(from, 'UInt32'))─┬──────────i─┐
-│ UInt32                           │ 3086477370 │
-└──────────────────────────────────┴────────────┘
-```
+- [Functions for Working with IPv4 and IPv6 Addresses](../functions/ip-address-functions.md)

From fe1354f22184181c3ed996e0928509917bdc5f7d Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 5 Jun 2023 12:32:08 +0000
Subject: [PATCH 205/722] Analyzer: Do not apply Query Tree optimizations on
 shards

---
 src/Interpreters/InterpreterSelectQueryAnalyzer.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp b/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp
index 98f70c25dcd..4f2f05dc7eb 100644
--- a/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp
+++ b/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp
@@ -135,7 +135,8 @@ QueryTreeNodePtr buildQueryTreeAndRunPasses(const ASTPtr & query,
     QueryTreePassManager query_tree_pass_manager(context);
     addQueryTreePasses(query_tree_pass_manager);
 
-    if (select_query_options.ignore_ast_optimizations)
+    if (select_query_options.ignore_ast_optimizations
+        || context->getClientInfo().query_kind == ClientInfo::QueryKind::SECONDARY_QUERY)
         query_tree_pass_manager.run(query_tree, 1 /*up_to_pass_index*/);
     else
         query_tree_pass_manager.run(query_tree);

From 5fb4f1fc614a749bd0706e5dcd952224e821bf77 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 5 Jun 2023 06:55:34 -0700
Subject: [PATCH 206/722] Implement review comments

---
 .../ReservoirSamplerDeterministic.h           |  2 +-
 src/Common/TransformEndianness.hpp            | 35 ++++++++++++-------
 2 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/src/AggregateFunctions/ReservoirSamplerDeterministic.h b/src/AggregateFunctions/ReservoirSamplerDeterministic.h
index 9dea821e839..b1a39a5dcc5 100644
--- a/src/AggregateFunctions/ReservoirSamplerDeterministic.h
+++ b/src/AggregateFunctions/ReservoirSamplerDeterministic.h
@@ -178,7 +178,7 @@ public:
 
     void write(DB::WriteBuffer & buf) const
     {
-        const auto size = samples.size();
+        const size_t size = samples.size();
         writeBinaryLittleEndian(size, buf);
         writeBinaryLittleEndian(total_values, buf);
 
diff --git a/src/Common/TransformEndianness.hpp b/src/Common/TransformEndianness.hpp
index 17cf441d17f..228490d24a1 100644
--- a/src/Common/TransformEndianness.hpp
+++ b/src/Common/TransformEndianness.hpp
@@ -8,18 +8,35 @@
 namespace DB
 {
 template <std::endian endian, typename T>
-    requires is_big_int_v<T>
+requires std::is_integral_v<T>
+inline void transformEndianness(T & value)
+{
+    if constexpr (endian != std::endian::native)
+        value = std::byteswap(value);
+}
+
+template <std::endian endian, typename T>
+requires is_big_int_v<T>
 inline void transformEndianness(T & x)
 {
     if constexpr (std::endian::native != endian)
     {
-        std::ranges::transform(x.items, std::begin(x.items), [](auto& item) { return std::byteswap(item); });
-        std::ranges::reverse(x.items);
+        auto & items = x.items;
+        std::transform(std::begin(items), std::end(items), std::begin(items), [](auto & item) { return std::byteswap(item); });
+        std::reverse(std::begin(items), std::end(items));
     }
 }
 
 template <std::endian endian, typename T>
-    requires is_decimal<T> || std::is_floating_point_v<T>
+requires is_decimal<T>
+inline void transformEndianness(T & x)
+{
+    if constexpr (std::endian::native != endian)
+        transformEndianness<endian>(x.value);
+}
+
+template <std::endian endian, typename T>
+requires std::is_floating_point_v<T>
 inline void transformEndianness(T & value)
 {
     if constexpr (std::endian::native != endian)
@@ -30,15 +47,7 @@ inline void transformEndianness(T & value)
 }
 
 template <std::endian endian, typename T>
-    requires std::is_integral_v<T> && (sizeof(T) <= 8)
-inline void transformEndianness(T & value)
-{
-    if constexpr (endian != std::endian::native)
-        value = std::byteswap(value);
-}
-
-template <std::endian endian, typename T>
-    requires std::is_scoped_enum_v<T>
+requires std::is_scoped_enum_v<T>
 inline void transformEndianness(T & x)
 {
     using UnderlyingType = std::underlying_type_t<T>;

From 50430ed304d8a4d4ce2bafc66bc1b7b74afec678 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 5 Jun 2023 06:55:52 -0700
Subject: [PATCH 207/722] Configure rule for concepts requires clause

---
 .clang-format | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.clang-format b/.clang-format
index 2da3911dced..893d9c613f1 100644
--- a/.clang-format
+++ b/.clang-format
@@ -74,6 +74,7 @@ ConstructorInitializerIndentWidth: 4
 ContinuationIndentWidth: 4
 DerivePointerAlignment: false
 DisableFormat: false
+IndentRequiresClause: false
 IndentWidth: 4
 IndentWrappedFunctionNames: false
 MacroBlockBegin: ''

From 33e51d4f3b25aa1af5dedf751b5fec5229dc6eac Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 15:22:04 +0000
Subject: [PATCH 208/722] Add setting to limit the number of bytes to read in
 schema inference

---
 docs/en/interfaces/schema-inference.md        | 16 +++++++------
 .../operations/settings/settings-formats.md   |  6 +++++
 src/Core/Settings.h                           |  1 +
 src/Formats/EscapingRuleUtils.cpp             |  3 ++-
 src/Formats/FormatFactory.cpp                 |  1 +
 src/Formats/FormatSettings.h                  |  3 ++-
 src/Formats/ReadSchemaUtils.cpp               | 14 +++++++----
 src/Processors/Formats/ISchemaReader.cpp      | 24 +++++++++++--------
 src/Processors/Formats/ISchemaReader.h        |  9 +++++--
 .../Impl/JSONColumnsBlockInputFormat.cpp      |  2 +-
 .../Impl/JSONColumnsBlockInputFormatBase.cpp  | 12 ++++++----
 .../Impl/JSONColumnsBlockInputFormatBase.h    | 16 +++++++++++--
 .../JSONCompactColumnsBlockInputFormat.cpp    |  2 +-
 ...ytes_to_read_in_schema_inference.reference |  1 +
 ..._max_bytes_to_read_in_schema_inference.sql |  4 ++++
 15 files changed, 80 insertions(+), 34 deletions(-)
 create mode 100644 tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.reference
 create mode 100644 tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.sql

diff --git a/docs/en/interfaces/schema-inference.md b/docs/en/interfaces/schema-inference.md
index c448d0aee47..a757a032b7d 100644
--- a/docs/en/interfaces/schema-inference.md
+++ b/docs/en/interfaces/schema-inference.md
@@ -329,8 +329,8 @@ SELECT count() FROM system.schema_inference_cache WHERE storage='S3'
 ## Text formats {#text-formats}
 
 For text formats, ClickHouse reads the data row by row, extracts column values according to the format,
-and then uses some recursive parsers and heuristics to determine the type for each value. The maximum number of rows read from the data in schema inference
-is controlled by the setting `input_format_max_rows_to_read_for_schema_inference` with default value 25000.
+and then uses some recursive parsers and heuristics to determine the type for each value. The maximum number of rows and bytes read from the data in schema inference
+is controlled by the settings `input_format_max_rows_to_read_for_schema_inference` (25000 by default) and `input_format_max_bytes_to_read_for_schema_inference` (32Mb by default).
 By default, all inferred types are [Nullable](../sql-reference/data-types/nullable.md), but you can change this by setting `schema_inference_make_columns_nullable` (see examples in the [settings](#settings-for-text-formats) section).
 
 ### JSON formats {#json-formats}
@@ -1144,13 +1144,15 @@ Line: value_1=2, value_2="Some string 2", value_3="[4, 5, NULL]"$$)
 
 ### Settings for text formats {#settings-for-text-formats}
 
-#### input_format_max_rows_to_read_for_schema_inference
+#### input_format_max_rows_to_read_for_schema_inference/input_format_max_bytes_to_read_for_schema_inference
 
-This setting controls the maximum number of rows to be read while schema inference.
-The more rows are read, the more time is spent on schema inference, but the greater the chance to
+These settings control the amount of data to be read while schema inference.
+The more rows/bytes are read, the more time is spent on schema inference, but the greater the chance to
 correctly determine the types (especially when the data contains a lot of nulls).
 
-Default value: `25000`.
+Default values:
+-   `25000` for `input_format_max_rows_to_read_for_schema_inference`.
+-   `33554432` (32 Mb) for `input_format_max_bytes_to_read_for_schema_inference`.
 
 #### column_names_for_schema_inference
 
@@ -1623,7 +1625,7 @@ In schema inference for CapnProto format ClickHouse uses the following type matc
 ## Strong-typed binary formats {#strong-typed-binary-formats}
 
 In such formats, each serialized value contains information about its type (and possibly about its name), but there is no information about the whole table.
-In schema inference for such formats, ClickHouse reads data row by row (up to `input_format_max_rows_to_read_for_schema_inference` rows) and extracts
+In schema inference for such formats, ClickHouse reads data row by row (up to `input_format_max_rows_to_read_for_schema_inference` rows or `input_format_max_bytes_to_read_for_schema_inference` bytes) and extracts
 the type (and possibly name) for each value from the data and then converts these types to ClickHouse types.
 
 ### MsgPack {#msgpack}
diff --git a/docs/en/operations/settings/settings-formats.md b/docs/en/operations/settings/settings-formats.md
index 65038d3a256..e4a8c916bcf 100644
--- a/docs/en/operations/settings/settings-formats.md
+++ b/docs/en/operations/settings/settings-formats.md
@@ -137,6 +137,12 @@ The maximum rows of data to read for automatic schema inference.
 
 Default value: `25'000`.
 
+## input_format_max_bytes_to_read_for_schema_inference {#input_format_max_bytes_to_read_for_schema_inference}
+
+The maximum amount of data in bytes to read for automatic schema inference.
+
+Default value: `33554432` (32 Mb).
+
 ## column_names_for_schema_inference {#column_names_for_schema_inference}
 
 The list of column names to use in schema inference for formats without column names. The format: 'column1,column2,column3,...'
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 67c92a0be8b..f1e6c518f30 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -844,6 +844,7 @@ class IColumn;
     M(UInt64, input_format_msgpack_number_of_columns, 0, "The number of columns in inserted MsgPack data. Used for automatic schema inference from data.", 0) \
     M(MsgPackUUIDRepresentation, output_format_msgpack_uuid_representation, FormatSettings::MsgPackUUIDRepresentation::EXT, "The way how to output UUID in MsgPack format.", 0) \
     M(UInt64, input_format_max_rows_to_read_for_schema_inference, 25000, "The maximum rows of data to read for automatic schema inference", 0) \
+    M(UInt64, input_format_max_bytes_to_read_for_schema_inference, 32 * 1024 * 1024, "The maximum bytes of data to read for automatic schema inference", 0) \
     M(Bool, input_format_csv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in CSV format", 0) \
     M(Bool, input_format_tsv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in TSV format", 0) \
     M(Bool, input_format_csv_detect_header, true, "Automatically detect header with names and types in CSV format", 0) \
diff --git a/src/Formats/EscapingRuleUtils.cpp b/src/Formats/EscapingRuleUtils.cpp
index 804f32e4b46..9f744218da2 100644
--- a/src/Formats/EscapingRuleUtils.cpp
+++ b/src/Formats/EscapingRuleUtils.cpp
@@ -408,9 +408,10 @@ DataTypes getDefaultDataTypeForEscapingRules(const std::vector<FormatSettings::E
 String getAdditionalFormatInfoForAllRowBasedFormats(const FormatSettings & settings)
 {
     return fmt::format(
-        "schema_inference_hints={}, max_rows_to_read_for_schema_inference={}, schema_inference_make_columns_nullable={}",
+        "schema_inference_hints={}, max_rows_to_read_for_schema_inference={}, max_bytes_to_read_for_schema_inference={}, schema_inference_make_columns_nullable={}",
         settings.schema_inference_hints,
         settings.max_rows_to_read_for_schema_inference,
+        settings.max_bytes_to_read_for_schema_inference,
         settings.schema_inference_make_columns_nullable);
 }
 
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index 586e1bb7251..9486bc011ba 100644
--- a/src/Formats/FormatFactory.cpp
+++ b/src/Formats/FormatFactory.cpp
@@ -182,6 +182,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.msgpack.number_of_columns = settings.input_format_msgpack_number_of_columns;
     format_settings.msgpack.output_uuid_representation = settings.output_format_msgpack_uuid_representation;
     format_settings.max_rows_to_read_for_schema_inference = settings.input_format_max_rows_to_read_for_schema_inference;
+    format_settings.max_bytes_to_read_for_schema_inference = settings.input_format_max_rows_to_read_for_schema_inference;
     format_settings.column_names_for_schema_inference = settings.column_names_for_schema_inference;
     format_settings.schema_inference_hints = settings.schema_inference_hints;
     format_settings.schema_inference_make_columns_nullable = settings.schema_inference_make_columns_nullable;
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index e332bd749a1..d4b40c5a6ec 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -36,7 +36,8 @@ struct FormatSettings
     bool defaults_for_omitted_fields = true;
 
     bool seekable_read = true;
-    UInt64 max_rows_to_read_for_schema_inference = 100;
+    UInt64 max_rows_to_read_for_schema_inference = 25000;
+    UInt64 max_bytes_to_read_for_schema_inference = 32 * 1024 * 1024;
 
     String column_names_for_schema_inference;
     String schema_inference_hints;
diff --git a/src/Formats/ReadSchemaUtils.cpp b/src/Formats/ReadSchemaUtils.cpp
index 61683b226ee..cbfa05bfba6 100644
--- a/src/Formats/ReadSchemaUtils.cpp
+++ b/src/Formats/ReadSchemaUtils.cpp
@@ -75,6 +75,8 @@ ColumnsDescription readSchemaFromFormat(
         SchemaReaderPtr schema_reader;
         size_t max_rows_to_read = format_settings ? format_settings->max_rows_to_read_for_schema_inference
                                                   : context->getSettingsRef().input_format_max_rows_to_read_for_schema_inference;
+        size_t max_bytes_to_read = format_settings ? format_settings->max_bytes_to_read_for_schema_inference
+                                                                             : context->getSettingsRef().input_format_max_bytes_to_read_for_schema_inference;
         size_t iterations = 0;
         ColumnsDescription cached_columns;
         while (true)
@@ -120,7 +122,7 @@ ColumnsDescription readSchemaFromFormat(
             try
             {
                 schema_reader = FormatFactory::instance().getSchemaReader(format_name, *buf, context, format_settings);
-                schema_reader->setMaxRowsToRead(max_rows_to_read);
+                schema_reader->setMaxRowsAndBytesToRead(max_rows_to_read, max_bytes_to_read);
                 names_and_types = schema_reader->readSchema();
                 break;
             }
@@ -132,10 +134,14 @@ ColumnsDescription readSchemaFromFormat(
                     size_t rows_read = schema_reader->getNumRowsRead();
                     assert(rows_read <= max_rows_to_read);
                     max_rows_to_read -= schema_reader->getNumRowsRead();
-                    if (rows_read != 0 && max_rows_to_read == 0)
+                    size_t bytes_read = buf->count();
+                    /// We could exceed max_bytes_to_read a bit to complete row parsing.
+                    max_bytes_to_read -= std::min(bytes_read, max_bytes_to_read);
+                    if (rows_read != 0 && (max_rows_to_read == 0 || max_bytes_to_read == 0))
                     {
-                        exception_message += "\nTo increase the maximum number of rows to read for structure determination, use setting "
-                                             "input_format_max_rows_to_read_for_schema_inference";
+                        exception_message += "\nTo increase the maximum number of rows/bytes to read for structure determination, use setting "
+                                             "input_format_max_rows_to_read_for_schema_inference/input_format_max_bytes_to_read_for_schema_inference";
+
                         if (iterations > 1)
                         {
                             exception_messages += "\n" + exception_message;
diff --git a/src/Processors/Formats/ISchemaReader.cpp b/src/Processors/Formats/ISchemaReader.cpp
index c96cb373a2d..9f26a3543d0 100644
--- a/src/Processors/Formats/ISchemaReader.cpp
+++ b/src/Processors/Formats/ISchemaReader.cpp
@@ -57,11 +57,15 @@ void checkFinalInferredType(
 }
 
 IIRowSchemaReader::IIRowSchemaReader(ReadBuffer & in_, const FormatSettings & format_settings_, DataTypePtr default_type_)
-    : ISchemaReader(in_), default_type(default_type_), hints_str(format_settings_.schema_inference_hints), format_settings(format_settings_)
+    : ISchemaReader(in_)
+    , max_rows_to_read(format_settings_.max_rows_to_read_for_schema_inference)
+    , max_bytes_to_read(format_settings_.max_bytes_to_read_for_schema_inference)
+    , default_type(default_type_)
+    , hints_str(format_settings_.schema_inference_hints)
+    , format_settings(format_settings_)
 {
 }
 
-
 void IIRowSchemaReader::setContext(ContextPtr & context)
 {
     ColumnsDescription columns;
@@ -99,11 +103,11 @@ IRowSchemaReader::IRowSchemaReader(ReadBuffer & in_, const FormatSettings & form
 
 NamesAndTypesList IRowSchemaReader::readSchema()
 {
-    if (max_rows_to_read == 0)
+    if (max_rows_to_read == 0 || max_bytes_to_read == 0)
         throw Exception(
             ErrorCodes::BAD_ARGUMENTS,
-            "Cannot read rows to determine the schema, the maximum number of rows to read is set to 0. "
-            "Most likely setting input_format_max_rows_to_read_for_schema_inference is set to 0");
+            "Cannot read rows to determine the schema, the maximum number of rows (or bytes) to read is set to 0. "
+            "Most likely setting input_format_max_rows_to_read_for_schema_inference or input_format_max_bytes_to_read_for_schema_inference is set to 0");
 
     DataTypes data_types = readRowAndGetDataTypes();
 
@@ -143,7 +147,7 @@ NamesAndTypesList IRowSchemaReader::readSchema()
             data_types[i] = hint_it->second;
     }
 
-    for (rows_read = 1; rows_read < max_rows_to_read; ++rows_read)
+    for (rows_read = 1; rows_read < max_rows_to_read && in.count() < max_bytes_to_read; ++rows_read)
     {
         DataTypes new_data_types = readRowAndGetDataTypes();
         if (new_data_types.empty())
@@ -220,11 +224,11 @@ IRowWithNamesSchemaReader::IRowWithNamesSchemaReader(ReadBuffer & in_, const For
 
 NamesAndTypesList IRowWithNamesSchemaReader::readSchema()
 {
-    if (max_rows_to_read == 0)
+    if (max_rows_to_read == 0 || max_bytes_to_read == 0)
         throw Exception(
             ErrorCodes::BAD_ARGUMENTS,
-            "Cannot read rows to determine the schema, the maximum number of rows to read is set to 0. "
-            "Most likely setting input_format_max_rows_to_read_for_schema_inference is set to 0");
+            "Cannot read rows to determine the schema, the maximum number of rows (or bytes) to read is set to 0. "
+            "Most likely setting input_format_max_rows_to_read_for_schema_inference or input_format_max_bytes_to_read_for_schema_inference is set to 0");
 
     bool eof = false;
     auto names_and_types = readRowAndGetNamesAndDataTypes(eof);
@@ -245,7 +249,7 @@ NamesAndTypesList IRowWithNamesSchemaReader::readSchema()
         names_order.push_back(name);
     }
 
-    for (rows_read = 1; rows_read < max_rows_to_read; ++rows_read)
+    for (rows_read = 1; rows_read < max_rows_to_read && in.count() < max_bytes_to_read; ++rows_read)
     {
         auto new_names_and_types = readRowAndGetNamesAndDataTypes(eof);
         if (eof)
diff --git a/src/Processors/Formats/ISchemaReader.h b/src/Processors/Formats/ISchemaReader.h
index 78b34a07840..40702198a57 100644
--- a/src/Processors/Formats/ISchemaReader.h
+++ b/src/Processors/Formats/ISchemaReader.h
@@ -32,7 +32,7 @@ public:
     virtual bool needContext() const { return false; }
     virtual void setContext(ContextPtr &) {}
 
-    virtual void setMaxRowsToRead(size_t) {}
+    virtual void setMaxRowsAndBytesToRead(size_t, size_t) {}
     virtual size_t getNumRowsRead() const { return 0; }
 
     virtual ~ISchemaReader() = default;
@@ -54,12 +54,17 @@ public:
     virtual void transformTypesIfNeeded(DataTypePtr & type, DataTypePtr & new_type);
 
 protected:
-    void setMaxRowsToRead(size_t max_rows) override { max_rows_to_read = max_rows; }
+    void setMaxRowsAndBytesToRead(size_t max_rows, size_t max_bytes) override
+    {
+        max_rows_to_read = max_rows;
+        max_bytes_to_read = max_bytes;
+    }
     size_t getNumRowsRead() const override { return rows_read; }
 
     virtual void transformFinalTypeIfNeeded(DataTypePtr &) {}
 
     size_t max_rows_to_read;
+    size_t max_bytes_to_read;
     size_t rows_read = 0;
     DataTypePtr default_type;
     String hints_str;
diff --git a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormat.cpp b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormat.cpp
index 8d4c4b0c6cf..3d003658e64 100644
--- a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormat.cpp
@@ -55,7 +55,7 @@ void registerJSONColumnsSchemaReader(FormatFactory & factory)
     );
     factory.registerAdditionalInfoForSchemaCacheGetter("JSONColumns", [](const FormatSettings & settings)
     {
-        return getAdditionalFormatInfoByEscapingRule(settings, FormatSettings::EscapingRule::JSON);
+        return getAdditionalFormatInfoForAllRowBasedFormats(settings) + getAdditionalFormatInfoByEscapingRule(settings, FormatSettings::EscapingRule::JSON);
     });
 }
 
diff --git a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp
index 2e264c59f56..84a07ebc8fb 100644
--- a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp
+++ b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp
@@ -176,6 +176,8 @@ JSONColumnsSchemaReaderBase::JSONColumnsSchemaReaderBase(
     , hints_str(format_settings_.schema_inference_hints)
     , reader(std::move(reader_))
     , column_names_from_settings(splitColumnNames(format_settings_.column_names_for_schema_inference))
+    , max_rows_to_read(format_settings_.max_rows_to_read_for_schema_inference)
+    , max_bytes_to_read(format_settings_.max_bytes_to_read_for_schema_inference)
 {
 }
 
@@ -196,12 +198,12 @@ void JSONColumnsSchemaReaderBase::transformTypesIfNeeded(DataTypePtr & type, Dat
 
 NamesAndTypesList JSONColumnsSchemaReaderBase::readSchema()
 {
-    size_t total_rows_read = 0;
     std::unordered_map<String, DataTypePtr> names_to_types;
     std::vector<String> names_order;
     /// Read data block by block and determine the type for each column
-    /// until max_rows_to_read_for_schema_inference is reached.
-    while (total_rows_read < format_settings.max_rows_to_read_for_schema_inference)
+    /// until max_rows_to_read/max_bytes_to_read is reached.
+    /// Note that we can exceed max_bytes_to_read to compete block parsing.
+    while (total_rows_read < max_rows_to_read && in.count() < max_bytes_to_read)
     {
         if (in.eof())
             break;
@@ -268,7 +270,7 @@ NamesAndTypesList JSONColumnsSchemaReaderBase::readSchema()
     return result;
 }
 
-DataTypePtr JSONColumnsSchemaReaderBase::readColumnAndGetDataType(const String & column_name, size_t & rows_read, size_t max_rows_to_read)
+DataTypePtr JSONColumnsSchemaReaderBase::readColumnAndGetDataType(const String & column_name, size_t & rows_read, size_t max_rows)
 {
     /// Check for empty column.
     if (reader->checkColumnEnd())
@@ -279,7 +281,7 @@ DataTypePtr JSONColumnsSchemaReaderBase::readColumnAndGetDataType(const String &
     do
     {
         /// If we reached max_rows_to_read, skip the rest part of this column.
-        if (rows_read == max_rows_to_read)
+        if (rows_read == max_rows)
         {
             reader->skipColumn();
             break;
diff --git a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h
index 2babc0734f9..886c8841540 100644
--- a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h
+++ b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h
@@ -82,11 +82,19 @@ public:
     bool needContext() const override { return !hints_str.empty(); }
     void setContext(ContextPtr & ctx) override;
 
+    void setMaxRowsAndBytesToRead(size_t max_rows, size_t max_bytes) override
+    {
+        max_rows_to_read = max_rows;
+        max_bytes_to_read = max_bytes;
+    }
+
+    size_t getNumRowsRead() const override { return total_rows_read; }
+
 private:
     NamesAndTypesList readSchema() override;
 
-    /// Read whole column in the block (up to max_rows_to_read rows) and extract the data type.
-    DataTypePtr readColumnAndGetDataType(const String & column_name, size_t & rows_read, size_t max_rows_to_read);
+    /// Read whole column in the block (up to max_rows rows) and extract the data type.
+    DataTypePtr readColumnAndGetDataType(const String & column_name, size_t & rows_read, size_t max_rows);
 
     const FormatSettings format_settings;
     String hints_str;
@@ -95,6 +103,10 @@ private:
     std::unique_ptr<JSONColumnsReaderBase> reader;
     Names column_names_from_settings;
     JSONInferenceInfo inference_info;
+
+    size_t total_rows_read = 0;
+    size_t max_rows_to_read;
+    size_t max_bytes_to_read;
 };
 
 }
diff --git a/src/Processors/Formats/Impl/JSONCompactColumnsBlockInputFormat.cpp b/src/Processors/Formats/Impl/JSONCompactColumnsBlockInputFormat.cpp
index ade18d21892..09df7beaa73 100644
--- a/src/Processors/Formats/Impl/JSONCompactColumnsBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/JSONCompactColumnsBlockInputFormat.cpp
@@ -53,7 +53,7 @@ void registerJSONCompactColumnsSchemaReader(FormatFactory & factory)
     );
     factory.registerAdditionalInfoForSchemaCacheGetter("JSONCompactColumns", [](const FormatSettings & settings)
     {
-        auto result = getAdditionalFormatInfoByEscapingRule(settings, FormatSettings::EscapingRule::JSON);
+        auto result = getAdditionalFormatInfoForAllRowBasedFormats(settings) + getAdditionalFormatInfoByEscapingRule(settings, FormatSettings::EscapingRule::JSON);
         return result + fmt::format(", column_names_for_schema_inference={}", settings.column_names_for_schema_inference);
     });
 }
diff --git a/tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.reference b/tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.reference
new file mode 100644
index 00000000000..d45098ddc0f
--- /dev/null
+++ b/tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.reference
@@ -0,0 +1 @@
+a	Nullable(Int64)					
diff --git a/tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.sql b/tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.sql
new file mode 100644
index 00000000000..9dbf176472d
--- /dev/null
+++ b/tests/queries/0_stateless/02783_max_bytes_to_read_in_schema_inference.sql
@@ -0,0 +1,4 @@
+set input_format_max_rows_to_read_for_schema_inference=2;
+desc format('JSONEachRow', '{"a" : null}, {"a" : 42}') settings input_format_max_bytes_to_read_for_schema_inference=10; -- {serverError ONLY_NULLS_WHILE_READING_SCHEMA}
+desc format('JSONEachRow', '{"a" : null}, {"a" : 42}') settings input_format_max_bytes_to_read_for_schema_inference=20;
+

From 79cbebaf0dcc98b947a78dcfa490493cf18f076b Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 5 Jun 2023 15:34:04 +0000
Subject: [PATCH 209/722] Remove unnecessary conditional expression

---
 src/Common/TransformEndianness.hpp | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/Common/TransformEndianness.hpp b/src/Common/TransformEndianness.hpp
index 228490d24a1..4d690d75d9e 100644
--- a/src/Common/TransformEndianness.hpp
+++ b/src/Common/TransformEndianness.hpp
@@ -31,8 +31,7 @@ template <std::endian endian, typename T>
 requires is_decimal<T>
 inline void transformEndianness(T & x)
 {
-    if constexpr (std::endian::native != endian)
-        transformEndianness<endian>(x.value);
+    transformEndianness<endian>(x.value);
 }
 
 template <std::endian endian, typename T>

From 67af505ed63fc49d253f67f75b814dcf551e3a2c Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 17:04:55 +0000
Subject: [PATCH 210/722] Respect setting input_format_as_default in schema
 inference

---
 src/Processors/Formats/ISchemaReader.cpp                 | 6 ++++++
 .../02784_schema_inference_null_as_default.reference     | 9 +++++++++
 .../02784_schema_inference_null_as_default.sql           | 7 +++++++
 3 files changed, 22 insertions(+)
 create mode 100644 tests/queries/0_stateless/02784_schema_inference_null_as_default.reference
 create mode 100644 tests/queries/0_stateless/02784_schema_inference_null_as_default.sql

diff --git a/src/Processors/Formats/ISchemaReader.cpp b/src/Processors/Formats/ISchemaReader.cpp
index c96cb373a2d..0cb6499f423 100644
--- a/src/Processors/Formats/ISchemaReader.cpp
+++ b/src/Processors/Formats/ISchemaReader.cpp
@@ -1,6 +1,7 @@
 #include <Processors/Formats/ISchemaReader.h>
 #include <Formats/SchemaInferenceUtils.h>
 #include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypeNullable.h>
 #include <Common/logger_useful.h>
 #include <Interpreters/parseColumnsListForTableFunction.h>
 #include <boost/algorithm/string.hpp>
@@ -54,6 +55,11 @@ void checkFinalInferredType(
 
     if (settings.schema_inference_make_columns_nullable)
         type = makeNullableRecursively(type);
+    /// In case when data for some column could contain nulls and regular values,
+    /// resulting inferred type is Nullable.
+    /// If input_format_null_as_default is enabled, we should remove Nullable type.
+    else if (settings.null_as_default)
+        type = removeNullable(type);
 }
 
 IIRowSchemaReader::IIRowSchemaReader(ReadBuffer & in_, const FormatSettings & format_settings_, DataTypePtr default_type_)
diff --git a/tests/queries/0_stateless/02784_schema_inference_null_as_default.reference b/tests/queries/0_stateless/02784_schema_inference_null_as_default.reference
new file mode 100644
index 00000000000..c83819ab2e2
--- /dev/null
+++ b/tests/queries/0_stateless/02784_schema_inference_null_as_default.reference
@@ -0,0 +1,9 @@
+x	Nullable(Int64)					
+\N
+42
+x	Nullable(Int64)					
+\N
+42
+x	Int64					
+0
+42
diff --git a/tests/queries/0_stateless/02784_schema_inference_null_as_default.sql b/tests/queries/0_stateless/02784_schema_inference_null_as_default.sql
new file mode 100644
index 00000000000..9c9f99d8283
--- /dev/null
+++ b/tests/queries/0_stateless/02784_schema_inference_null_as_default.sql
@@ -0,0 +1,7 @@
+desc format(JSONEachRow, '{"x" : null}, {"x" : 42}') settings schema_inference_make_columns_nullable=1;
+select * from format(JSONEachRow, '{"x" : null}, {"x" : 42}') settings schema_inference_make_columns_nullable=1;
+desc format(JSONEachRow, '{"x" : null}, {"x" : 42}') settings schema_inference_make_columns_nullable=0, input_format_null_as_default=0;
+select * from format(JSONEachRow, '{"x" : null}, {"x" : 42}') settings schema_inference_make_columns_nullable=0, input_format_null_as_default=0;
+desc format(JSONEachRow, '{"x" : null}, {"x" : 42}') settings schema_inference_make_columns_nullable=0, input_format_null_as_default=1;
+select * from format(JSONEachRow, '{"x" : null}, {"x" : 42}') settings schema_inference_make_columns_nullable=0, input_format_null_as_default=1;
+

From 028e48dfa716c7e7aa9f5e3df56adb563d653b02 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 17:33:10 +0000
Subject: [PATCH 211/722] Update docs

---
 docs/en/interfaces/schema-inference.md | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/en/interfaces/schema-inference.md b/docs/en/interfaces/schema-inference.md
index c448d0aee47..bef858eaba0 100644
--- a/docs/en/interfaces/schema-inference.md
+++ b/docs/en/interfaces/schema-inference.md
@@ -1192,7 +1192,7 @@ DESC format(JSONEachRow, '{"id" : 1, "age" : 25, "name" : "Josh", "status" : nul
 #### schema_inference_make_columns_nullable
 
 Controls making inferred types `Nullable` in schema inference for formats without information about nullability.
-If the setting is enabled, all inferred type will be `Nullable`, if disabled, the inferred type will be `Nullable` only if the column contains `NULL` in a sample that is parsed during schema inference.
+If the setting is enabled, all inferred type will be `Nullable`, if disabled, the inferred type will be `Nullable` only if `input_format_null_as_default` is disabled and the column contains `NULL` in a sample that is parsed during schema inference.
 
 Enabled by default.
 
@@ -1215,7 +1215,8 @@ DESC format(JSONEachRow, $$
 └─────────┴─────────────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
 ```
 ```sql
-SET schema_inference_make_columns_nullable = 0
+SET schema_inference_make_columns_nullable = 0;
+SET input_format_null_as_default = 0;    
 DESC format(JSONEachRow, $$
                                 {"id" :  1, "age" :  25, "name" : "Josh", "status" : null, "hobbies" : ["football", "cooking"]}
                                 {"id" :  2, "age" :  19, "name" :  "Alan", "status" : "married", "hobbies" :  ["tennis", "art"]}
@@ -1232,6 +1233,25 @@ DESC format(JSONEachRow, $$
 └─────────┴──────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
 ```
 
+```sql
+SET schema_inference_make_columns_nullable = 0;
+SET input_format_null_as_default = 1;    
+DESC format(JSONEachRow, $$
+                                {"id" :  1, "age" :  25, "name" : "Josh", "status" : null, "hobbies" : ["football", "cooking"]}
+                                {"id" :  2, "age" :  19, "name" :  "Alan", "status" : "married", "hobbies" :  ["tennis", "art"]}
+                         $$)
+```
+```response
+
+┌─name────┬─type──────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
+│ id      │ Int64         │              │                    │         │                  │                │
+│ age     │ Int64         │              │                    │         │                  │                │
+│ name    │ String        │              │                    │         │                  │                │
+│ status  │ String        │              │                    │         │                  │                │
+│ hobbies │ Array(String) │              │                    │         │                  │                │
+└─────────┴───────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
+```
+
 #### input_format_try_infer_integers
 
 If enabled, ClickHouse will try to infer integers instead of floats in schema inference for text formats.

From ad85faabd1941b891b406225ecf7c6b568c8328f Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Mon, 5 Jun 2023 16:09:53 +0000
Subject: [PATCH 212/722] Fix test

---
 tests/integration/test_storage_mongodb/test.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/integration/test_storage_mongodb/test.py b/tests/integration/test_storage_mongodb/test.py
index e6e77c64515..6ce71fb91fa 100644
--- a/tests/integration/test_storage_mongodb/test.py
+++ b/tests/integration/test_storage_mongodb/test.py
@@ -71,6 +71,7 @@ def test_simple_select(started_cluster):
     simple_mongo_table.drop()
 
 
+@pytest.mark.parametrize("started_cluster", [False], indirect=["started_cluster"])
 def test_simple_select_from_view(started_cluster):
     mongo_connection = get_mongo_connection(started_cluster)
     db = mongo_connection["test"]
@@ -86,7 +87,7 @@ def test_simple_select_from_view(started_cluster):
 
     node = started_cluster.instances["node"]
     node.query(
-        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo2:27017', 'test', 'simple_table_view', 'root', 'clickhouse')"
+        "CREATE TABLE simple_mongo_table(key UInt64, data String) ENGINE = MongoDB('mongo1:27017', 'test', 'simple_table_view', 'root', 'clickhouse')"
     )
 
     assert node.query("SELECT COUNT() FROM simple_mongo_table") == "100\n"

From e8c6c7967b38ebdd467fb9c04966419731b5a689 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 5 Jun 2023 18:21:40 +0000
Subject: [PATCH 213/722] Move attaching gdb to separate lib

---
 docker/test/stateless/run.sh | 41 +++--------------------------------
 tests/ci/attach_gdb.lib      | 42 ++++++++++++++++++++++++++++++++++++
 tests/ci/stress_tests.lib    | 41 +++--------------------------------
 3 files changed, 48 insertions(+), 76 deletions(-)
 create mode 100644 tests/ci/attach_gdb.lib

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index dfee7d84cde..df650b37cc6 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -15,6 +15,8 @@ dpkg -i package_folder/clickhouse-client_*.deb
 
 ln -s /usr/share/clickhouse-test/clickhouse-test /usr/bin/clickhouse-test
 
+source /usr/share/clickhouse-test/ci/attach_gdb.lib
+
 # install test configs
 /usr/share/clickhouse-test/config/install.sh
 
@@ -85,44 +87,7 @@ fi
 
 sleep 5
 
-# Set follow-fork-mode to parent, because we attach to clickhouse-server, not to watchdog
-# and clickhouse-server can do fork-exec, for example, to run some bridge.
-# Do not set nostop noprint for all signals, because some it may cause gdb to hang,
-# explicitly ignore non-fatal signals that are used by server.
-# Number of SIGRTMIN can be determined only in runtime.
-RTMIN=$(kill -l SIGRTMIN)
-echo "
-set follow-fork-mode parent
-handle SIGHUP nostop noprint pass
-handle SIGINT nostop noprint pass
-handle SIGQUIT nostop noprint pass
-handle SIGPIPE nostop noprint pass
-handle SIGTERM nostop noprint pass
-handle SIGUSR1 nostop noprint pass
-handle SIGUSR2 nostop noprint pass
-handle SIG$RTMIN nostop noprint pass
-info signals
-continue
-backtrace full
-thread apply all backtrace full
-info registers
-disassemble /s
-up
-disassemble /s
-up
-disassemble /s
-p \"done\"
-detach
-quit
-" > script.gdb
-
-# FIXME Hung check may work incorrectly because of attached gdb
-# 1. False positives are possible
-# 2. We cannot attach another gdb to get stacktraces if some queries hung
-gdb -batch -command script.gdb -p "$(cat /var/run/clickhouse-server/clickhouse-server.pid)" | ts '%Y-%m-%d %H:%M:%S' >> /test_output/gdb.log &
-sleep 5
-# gdb will send SIGSTOP, spend some time loading debug info and then send SIGCONT, wait for it (up to send_timeout, 300s)
-time clickhouse-client --query "SELECT 'Connected to clickhouse-server after attaching gdb'" ||:
+attach_gdb_to_clickhouse
 
 function run_tests()
 {
diff --git a/tests/ci/attach_gdb.lib b/tests/ci/attach_gdb.lib
new file mode 100644
index 00000000000..2df6243f796
--- /dev/null
+++ b/tests/ci/attach_gdb.lib
@@ -0,0 +1,42 @@
+#!/bin/bash
+
+function attach_gdb_to_clickhouse()
+{
+    # Set follow-fork-mode to parent, because we attach to clickhouse-server, not to watchdog
+    # and clickhouse-server can do fork-exec, for example, to run some bridge.
+    # Do not set nostop noprint for all signals, because some it may cause gdb to hang,
+    # explicitly ignore non-fatal signals that are used by server.
+    # Number of SIGRTMIN can be determined only in runtime.
+    RTMIN=$(kill -l SIGRTMIN)
+  echo "
+set follow-fork-mode parent
+handle SIGHUP nostop noprint pass
+handle SIGINT nostop noprint pass
+handle SIGQUIT nostop noprint pass
+handle SIGPIPE nostop noprint pass
+handle SIGTERM nostop noprint pass
+handle SIGUSR1 nostop noprint pass
+handle SIGUSR2 nostop noprint pass
+handle SIG$RTMIN nostop noprint pass
+info signals
+continue
+backtrace full
+thread apply all backtrace full
+info registers
+disassemble /s
+up
+disassemble /s
+up
+disassemble /s
+p \"done\"
+detach
+quit
+" > script.gdb
+
+    # FIXME Hung check may work incorrectly because of attached gdb
+    # We cannot attach another gdb to get stacktraces if some queries hung
+    gdb -batch -command script.gdb -p "$(cat /var/run/clickhouse-server/clickhouse-server.pid)" | ts '%Y-%m-%d %H:%M:%S' >> /test_output/gdb.log &
+    sleep 5
+    # gdb will send SIGSTOP, spend some time loading debug info and then send SIGCONT, wait for it (up to send_timeout, 300s)
+    time clickhouse-client --query "SELECT 'Connected to clickhouse-server after attaching gdb'" ||:
+}
diff --git a/tests/ci/stress_tests.lib b/tests/ci/stress_tests.lib
index 04df50b3248..2b8ac77b952 100644
--- a/tests/ci/stress_tests.lib
+++ b/tests/ci/stress_tests.lib
@@ -9,6 +9,8 @@ FAIL="\tFAIL\t\\N\t"
 FAILURE_CONTEXT_LINES=100
 FAILURE_CONTEXT_MAX_LINE_WIDTH=300
 
+source attach_gdb.lib
+
 function escaped()
 {
     # That's the simplest way I found to escape a string in bash. Yep, bash is the most convenient programming language.
@@ -184,44 +186,7 @@ function start()
         counter=$((counter + 1))
     done
 
-    # Set follow-fork-mode to parent, because we attach to clickhouse-server, not to watchdog
-    # and clickhouse-server can do fork-exec, for example, to run some bridge.
-    # Do not set nostop noprint for all signals, because some it may cause gdb to hang,
-    # explicitly ignore non-fatal signals that are used by server.
-    # Number of SIGRTMIN can be determined only in runtime.
-    RTMIN=$(kill -l SIGRTMIN)
-    echo "
-set follow-fork-mode parent
-handle SIGHUP nostop noprint pass
-handle SIGINT nostop noprint pass
-handle SIGQUIT nostop noprint pass
-handle SIGPIPE nostop noprint pass
-handle SIGTERM nostop noprint pass
-handle SIGUSR1 nostop noprint pass
-handle SIGUSR2 nostop noprint pass
-handle SIG$RTMIN nostop noprint pass
-info signals
-continue
-backtrace full
-thread apply all backtrace full
-info registers
-disassemble /s
-up
-disassemble /s
-up
-disassemble /s
-p \"done\"
-detach
-quit
-" > script.gdb
-
-    # FIXME Hung check may work incorrectly because of attached gdb
-    # 1. False positives are possible
-    # 2. We cannot attach another gdb to get stacktraces if some queries hung
-    gdb -batch -command script.gdb -p "$(cat /var/run/clickhouse-server/clickhouse-server.pid)" | ts '%Y-%m-%d %H:%M:%S' >> /test_output/gdb.log &
-    sleep 5
-    # gdb will send SIGSTOP, spend some time loading debug info and then send SIGCONT, wait for it (up to send_timeout, 300s)
-    time clickhouse-client --query "SELECT 'Connected to clickhouse-server after attaching gdb'" ||:
+    attach_gdb_to_clickhouse
 }
 
 function check_server_start()

From 59095c445d7a48ae12ac48c8748d4b48699a1274 Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Mon, 5 Jun 2023 20:44:20 +0200
Subject: [PATCH 214/722] Revert "Revert "make filter push down through cross
 join""

---
 .../Optimizations/filterPushDown.cpp          |  6 +++---
 .../01763_filter_push_down_bugs.reference     | 19 +++++++++++++++++++
 .../01763_filter_push_down_bugs.sql           | 19 +++++++++++++++++++
 3 files changed, 41 insertions(+), 3 deletions(-)

diff --git a/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp b/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
index 37bc894339f..db29038999b 100644
--- a/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
+++ b/src/Processors/QueryPlan/Optimizations/filterPushDown.cpp
@@ -272,7 +272,7 @@ size_t tryPushDownFilter(QueryPlan::Node * parent_node, QueryPlan::Nodes & nodes
     {
         /// If totals step has HAVING expression, skip it for now.
         /// TODO:
-        /// We can merge HAVING expression with current filer.
+        /// We can merge HAVING expression with current filter.
         /// Also, we can push down part of HAVING which depend only on aggregation keys.
         if (totals_having->getActions())
             return 0;
@@ -323,9 +323,9 @@ size_t tryPushDownFilter(QueryPlan::Node * parent_node, QueryPlan::Nodes & nodes
         {
             const auto & table_join = join ? join->getJoin()->getTableJoin() : filled_join->getJoin()->getTableJoin();
 
-            /// Only inner and left(/right) join are supported. Other types may generate default values for left table keys.
+            /// Only inner, cross and left(/right) join are supported. Other types may generate default values for left table keys.
             /// So, if we push down a condition like `key != 0`, not all rows may be filtered.
-            if (table_join.kind() != JoinKind::Inner && table_join.kind() != kind)
+            if (table_join.kind() != JoinKind::Inner && table_join.kind() != JoinKind::Cross && table_join.kind() != kind)
                 return 0;
 
             bool is_left = kind == JoinKind::Left;
diff --git a/tests/queries/0_stateless/01763_filter_push_down_bugs.reference b/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
index 5aa2e645509..7df35e2948d 100644
--- a/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
+++ b/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
@@ -6,3 +6,22 @@ String1_0	String2_0	String3_0	String4_0	1
 String1_0	String2_0	String3_0	String4_0	1
 1	[0,1,2]
 1
+Expression ((Projection + Before ORDER BY))
+  Filter (WHERE)
+    Join (JOIN FillRightFirst)
+      Filter (( + Before JOIN))
+        ReadFromMergeTree (default.t1)
+        Indexes:
+          PrimaryKey
+            Keys: 
+              id
+            Condition: (id in [101, 101])
+            Parts: 1/1
+            Granules: 1/1
+      Expression ((Joined actions + (Rename joined columns + (Projection + Before ORDER BY))))
+        ReadFromMergeTree (default.t2)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 1/1
diff --git a/tests/queries/0_stateless/01763_filter_push_down_bugs.sql b/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
index 1058bf75144..2ee249b5ce7 100644
--- a/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
+++ b/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
@@ -38,6 +38,25 @@ DROP TABLE IF EXISTS Test;
 
 select x, y from (select [0, 1, 2] as y, 1 as a, 2 as b) array join y as x where a = 1 and b = 2 and (x = 1 or x != 1) and x = 1;
 
+DROP TABLE IF EXISTS t;
 create table t(a UInt8) engine=MergeTree order by a;
 insert into t select * from numbers(2);
 select a from t t1 join t t2 on t1.a = t2.a where t1.a;
+DROP TABLE IF EXISTS t;
+
+DROP TABLE IF EXISTS t1;
+DROP TABLE IF EXISTS t2;
+CREATE TABLE t1 (id Int64, create_time DateTime) ENGINE = MergeTree ORDER BY id;
+CREATE TABLE t2 (delete_time DateTime) ENGINE = MergeTree ORDER BY delete_time;
+
+insert into t1 values (101, '2023-05-28 00:00:00'), (102, '2023-05-28 00:00:00');
+insert into t2 values ('2023-05-31 00:00:00');
+
+EXPLAIN indexes=1 SELECT id, delete_time FROM t1
+ CROSS JOIN (
+    SELECT delete_time
+    FROM t2
+) AS d WHERE create_time < delete_time AND id = 101;
+
+DROP TABLE IF EXISTS t1;
+DROP TABLE IF EXISTS t2;

From fd39616e780ac216fd07aa2625119a65c85661ee Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Mon, 5 Jun 2023 22:09:32 +0200
Subject: [PATCH 215/722] suppress some tests for analyzer

---
 tests/queries/0_stateless/01479_cross_join_9855.sql       | 4 ++--
 tests/queries/0_stateless/01763_filter_push_down_bugs.sql | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/01479_cross_join_9855.sql b/tests/queries/0_stateless/01479_cross_join_9855.sql
index 6dc76f22057..9dcf209a1cd 100644
--- a/tests/queries/0_stateless/01479_cross_join_9855.sql
+++ b/tests/queries/0_stateless/01479_cross_join_9855.sql
@@ -2,8 +2,8 @@ SET cross_to_inner_join_rewrite = 1;
 
 SELECT count()
 FROM numbers(4) AS n1, numbers(3) AS n2
-WHERE n1.number > (select avg(n.number) from numbers(3) n);
+WHERE n1.number > (select avg(n.number) from numbers(3) n) SETTINGS allow_experimental_analyzer=0;
 
 SELECT count()
 FROM numbers(4) AS n1, numbers(3) AS n2, numbers(6) AS n3
-WHERE n1.number > (select avg(n.number) from numbers(3) n);
+WHERE n1.number > (select avg(n.number) from numbers(3) n) SETTINGS allow_experimental_analyzer=0;
diff --git a/tests/queries/0_stateless/01763_filter_push_down_bugs.sql b/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
index 2ee249b5ce7..5f7f4379714 100644
--- a/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
+++ b/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
@@ -56,7 +56,7 @@ EXPLAIN indexes=1 SELECT id, delete_time FROM t1
  CROSS JOIN (
     SELECT delete_time
     FROM t2
-) AS d WHERE create_time < delete_time AND id = 101;
+) AS d WHERE create_time < delete_time AND id = 101 SETTINGS allow_experimental_analyzer=0;
 
 DROP TABLE IF EXISTS t1;
 DROP TABLE IF EXISTS t2;

From 495482cdb2b6a6a2d272c50bb3995b0409f7fb91 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Mon, 5 Jun 2023 15:22:29 -0700
Subject: [PATCH 216/722] Refactor ClickHouse->MySQL Type conversion and add
 configuration setting to trigger type conversion

---
 src/Core/Settings.h                           |   1 +
 src/DataTypes/DataTypeAggregateFunction.h     |   2 +-
 src/DataTypes/DataTypeArray.h                 |   2 +-
 src/DataTypes/DataTypeDate.h                  |   2 +-
 src/DataTypes/DataTypeDate32.h                |   2 +-
 src/DataTypes/DataTypeDateTime.h              |   2 +-
 src/DataTypes/DataTypeDateTime64.h            |   2 +-
 src/DataTypes/DataTypeEnum.cpp                |   1 -
 src/DataTypes/DataTypeEnum.h                  |   3 +-
 src/DataTypes/DataTypeFixedString.h           |   3 +-
 src/DataTypes/DataTypeFunction.h              |   2 +-
 src/DataTypes/DataTypeIPv4andIPv6.h           |   4 +-
 src/DataTypes/DataTypeInterval.h              |   2 +-
 src/DataTypes/DataTypeLowCardinality.cpp      |   3 +-
 src/DataTypes/DataTypeLowCardinality.h        |   3 +-
 src/DataTypes/DataTypeMap.h                   |   2 +-
 src/DataTypes/DataTypeNothing.h               |   2 +-
 src/DataTypes/DataTypeNullable.h              |   2 +-
 src/DataTypes/DataTypeNumberBase.cpp          |  67 +++++--
 src/DataTypes/DataTypeNumberBase.h            |   4 +-
 src/DataTypes/DataTypeObject.h                |   2 +-
 src/DataTypes/DataTypeSet.h                   |   2 +-
 src/DataTypes/DataTypeString.h                |   3 +-
 src/DataTypes/DataTypeTuple.h                 |   2 +-
 src/DataTypes/DataTypeUUID.h                  |   2 +-
 src/DataTypes/DataTypesDecimal.cpp            |   5 +
 src/DataTypes/DataTypesDecimal.h              |   3 +-
 src/DataTypes/IDataType.h                     |  12 +-
 src/Storages/System/StorageSystemColumns.cpp  |  11 +-
 ...show_columns_mysql_compatibility.reference | 187 +++++++++++++++---
 .../02775_show_columns_mysql_compatibility.sh |  31 ++-
 31 files changed, 278 insertions(+), 93 deletions(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 67c92a0be8b..1ce30ff121f 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -190,6 +190,7 @@ class IColumn;
     M(Bool, allow_experimental_inverted_index, false, "If it is set to true, allow to use experimental inverted index.", 0) \
     \
     M(UInt64, mysql_max_rows_to_insert, 65536, "The maximum number of rows in MySQL batch insertion of the MySQL storage engine", 0) \
+    M(Bool, output_format_mysql_types, false, "Use MySQL converted types when connected via MySQL compatibility", 0) \
     \
     M(UInt64, optimize_min_equality_disjunction_chain_length, 3, "The minimum length of the expression `expr = x1 OR ... expr = xN` for optimization ", 0) \
     \
diff --git a/src/DataTypes/DataTypeAggregateFunction.h b/src/DataTypes/DataTypeAggregateFunction.h
index 13ca3508580..83c9f10f407 100644
--- a/src/DataTypes/DataTypeAggregateFunction.h
+++ b/src/DataTypes/DataTypeAggregateFunction.h
@@ -45,7 +45,7 @@ public:
     String doGetName() const override;
     String getNameWithoutVersion() const;
     const char * getFamilyName() const override { return "AggregateFunction"; }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
     TypeIndex getTypeId() const override { return TypeIndex::AggregateFunction; }
 
     Array getParameters() const { return parameters; }
diff --git a/src/DataTypes/DataTypeArray.h b/src/DataTypes/DataTypeArray.h
index 528062b60be..2714ca1d023 100644
--- a/src/DataTypes/DataTypeArray.h
+++ b/src/DataTypes/DataTypeArray.h
@@ -30,7 +30,7 @@ public:
     {
         return "Array";
     }
-    const char * getSQLCompatibleName() const override
+    String getSQLCompatibleName() const override
     {
         return "TEXT";
     }
diff --git a/src/DataTypes/DataTypeDate.h b/src/DataTypes/DataTypeDate.h
index 7b622ae04a3..0d557cad5f0 100644
--- a/src/DataTypes/DataTypeDate.h
+++ b/src/DataTypes/DataTypeDate.h
@@ -13,7 +13,7 @@ public:
 
     TypeIndex getTypeId() const override { return TypeIndex::Date; }
     const char * getFamilyName() const override { return family_name; }
-    const char * getSQLCompatibleName() const override { return "DATE"; }
+    String getSQLCompatibleName() const override { return "DATE"; }
 
     bool canBeUsedAsVersion() const override { return true; }
     bool canBeInsideNullable() const override { return true; }
diff --git a/src/DataTypes/DataTypeDate32.h b/src/DataTypes/DataTypeDate32.h
index 65b0ec7407e..0879a404179 100644
--- a/src/DataTypes/DataTypeDate32.h
+++ b/src/DataTypes/DataTypeDate32.h
@@ -13,7 +13,7 @@ public:
 
     TypeIndex getTypeId() const override { return TypeIndex::Date32; }
     const char * getFamilyName() const override { return family_name; }
-    const char * getSQLCompatibleName() const override { return "DATE"; }
+    String getSQLCompatibleName() const override { return "DATE"; }
 
     Field getDefault() const override
     {
diff --git a/src/DataTypes/DataTypeDateTime.h b/src/DataTypes/DataTypeDateTime.h
index 2facc758f90..edc8b016490 100644
--- a/src/DataTypes/DataTypeDateTime.h
+++ b/src/DataTypes/DataTypeDateTime.h
@@ -36,7 +36,7 @@ public:
     static constexpr auto family_name = "DateTime";
 
     const char * getFamilyName() const override { return family_name; }
-    const char * getSQLCompatibleName() const override { return "DATETIME"; }
+    String getSQLCompatibleName() const override { return "DATETIME"; }
     String doGetName() const override;
     TypeIndex getTypeId() const override { return TypeIndex::DateTime; }
 
diff --git a/src/DataTypes/DataTypeDateTime64.h b/src/DataTypes/DataTypeDateTime64.h
index b836b84918f..e786cc09f28 100644
--- a/src/DataTypes/DataTypeDateTime64.h
+++ b/src/DataTypes/DataTypeDateTime64.h
@@ -28,7 +28,7 @@ public:
     DataTypeDateTime64(UInt32 scale_, const TimezoneMixin & time_zone_info);
 
     const char * getFamilyName() const override { return family_name; }
-    const char * getSQLCompatibleName() const override { return "DATETIME"; }
+    String getSQLCompatibleName() const override { return "DATETIME"; }
     std::string doGetName() const override;
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeEnum.cpp b/src/DataTypes/DataTypeEnum.cpp
index 24a3976179d..1750ae785bf 100644
--- a/src/DataTypes/DataTypeEnum.cpp
+++ b/src/DataTypes/DataTypeEnum.cpp
@@ -90,7 +90,6 @@ template <typename Type>
 DataTypeEnum<Type>::DataTypeEnum(const Values & values_)
     : EnumValues<Type>(values_)
     , type_name(generateName(this->getValues()))
-    , my_sql_type_name(generateMySQLName(this->getValues()))
 {
 }
 
diff --git a/src/DataTypes/DataTypeEnum.h b/src/DataTypes/DataTypeEnum.h
index 2cdaa2db06c..d148f753c82 100644
--- a/src/DataTypes/DataTypeEnum.h
+++ b/src/DataTypes/DataTypeEnum.h
@@ -45,7 +45,6 @@ public:
 
 private:
     std::string type_name;
-    std::string my_sql_type_name;
     static std::string generateName(const Values & values);
     static std::string generateMySQLName(const Values & values);
 
@@ -54,7 +53,7 @@ public:
 
     std::string doGetName() const override { return type_name; }
     const char * getFamilyName() const override;
-    const char * getSQLCompatibleName() const override { return my_sql_type_name.c_str(); }
+    String getSQLCompatibleName() const override { return generateMySQLName(this->getValues()); }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeFixedString.h b/src/DataTypes/DataTypeFixedString.h
index 2900efd5a34..22ec793208d 100644
--- a/src/DataTypes/DataTypeFixedString.h
+++ b/src/DataTypes/DataTypeFixedString.h
@@ -42,7 +42,8 @@ public:
     TypeIndex getTypeId() const override { return type_id; }
 
     const char * getFamilyName() const override { return "FixedString"; }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    /// Use TEXT for compatibility with MySQL to allow arbitrary bytes.
+    String getSQLCompatibleName() const override { return "TEXT"; }
 
     size_t getN() const
     {
diff --git a/src/DataTypes/DataTypeFunction.h b/src/DataTypes/DataTypeFunction.h
index df59f7738b2..b57c0587dde 100644
--- a/src/DataTypes/DataTypeFunction.h
+++ b/src/DataTypes/DataTypeFunction.h
@@ -24,7 +24,7 @@ public:
 
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Function"; }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
     TypeIndex getTypeId() const override { return TypeIndex::Function; }
 
     const DataTypes & getArgumentTypes() const
diff --git a/src/DataTypes/DataTypeIPv4andIPv6.h b/src/DataTypes/DataTypeIPv4andIPv6.h
index be0ebb90f3c..487ce04f67c 100644
--- a/src/DataTypes/DataTypeIPv4andIPv6.h
+++ b/src/DataTypes/DataTypeIPv4andIPv6.h
@@ -19,7 +19,7 @@ public:
     static constexpr auto type_id = TypeToTypeIndex<IPv4>;
 
     const char * getFamilyName() const override { return TypeName<IPv4>.data(); }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
@@ -61,7 +61,7 @@ public:
     static constexpr auto type_id = TypeToTypeIndex<IPv6>;
 
     const char * getFamilyName() const override { return TypeName<IPv6>.data(); }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeInterval.h b/src/DataTypes/DataTypeInterval.h
index ee2157431dd..7de56c13b56 100644
--- a/src/DataTypes/DataTypeInterval.h
+++ b/src/DataTypes/DataTypeInterval.h
@@ -26,7 +26,7 @@ public:
 
     std::string doGetName() const override { return fmt::format("Interval{}", kind.toString()); }
     const char * getFamilyName() const override { return "Interval"; }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
     TypeIndex getTypeId() const override { return TypeIndex::Interval; }
 
     bool equals(const IDataType & rhs) const override;
diff --git a/src/DataTypes/DataTypeLowCardinality.cpp b/src/DataTypes/DataTypeLowCardinality.cpp
index e59613e6974..8293455cabc 100644
--- a/src/DataTypes/DataTypeLowCardinality.cpp
+++ b/src/DataTypes/DataTypeLowCardinality.cpp
@@ -28,8 +28,7 @@ namespace ErrorCodes
 }
 
 DataTypeLowCardinality::DataTypeLowCardinality(DataTypePtr dictionary_type_)
-        : dictionary_type(std::move(dictionary_type_)),
-          mysql_name(dictionary_type->getSQLCompatibleName())
+        : dictionary_type(std::move(dictionary_type_))
 {
     auto inner_type = dictionary_type;
     if (dictionary_type->isNullable())
diff --git a/src/DataTypes/DataTypeLowCardinality.h b/src/DataTypes/DataTypeLowCardinality.h
index 4dee8565568..f6d8d07a312 100644
--- a/src/DataTypes/DataTypeLowCardinality.h
+++ b/src/DataTypes/DataTypeLowCardinality.h
@@ -11,7 +11,6 @@ class DataTypeLowCardinality : public IDataType
 {
 private:
     DataTypePtr dictionary_type;
-    std::string mysql_name;
 
 
 public:
@@ -24,7 +23,7 @@ public:
         return "LowCardinality(" + dictionary_type->getName() + ")";
     }
     const char * getFamilyName() const override { return "LowCardinality"; }
-    const char * getSQLCompatibleName() const override { return mysql_name.c_str(); }
+    String getSQLCompatibleName() const override { return dictionary_type->getSQLCompatibleName(); }
 
     TypeIndex getTypeId() const override { return TypeIndex::LowCardinality; }
 
diff --git a/src/DataTypes/DataTypeMap.h b/src/DataTypes/DataTypeMap.h
index 299119f1759..294c5d7ac77 100644
--- a/src/DataTypes/DataTypeMap.h
+++ b/src/DataTypes/DataTypeMap.h
@@ -30,7 +30,7 @@ public:
     TypeIndex getTypeId() const override { return TypeIndex::Map; }
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Map"; }
-    const char * getSQLCompatibleName() const override { return "JSON"; }
+    String getSQLCompatibleName() const override { return "JSON"; }
 
     bool canBeInsideNullable() const override { return false; }
 
diff --git a/src/DataTypes/DataTypeNothing.h b/src/DataTypes/DataTypeNothing.h
index b35ced5dcb3..c3a7e2d09f0 100644
--- a/src/DataTypes/DataTypeNothing.h
+++ b/src/DataTypes/DataTypeNothing.h
@@ -16,7 +16,7 @@ public:
     static constexpr bool is_parametric = false;
 
     const char * getFamilyName() const override { return "Nothing"; }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return TypeIndex::Nothing; }
 
diff --git a/src/DataTypes/DataTypeNullable.h b/src/DataTypes/DataTypeNullable.h
index b5fe1bb2dd9..e3165414c07 100644
--- a/src/DataTypes/DataTypeNullable.h
+++ b/src/DataTypes/DataTypeNullable.h
@@ -16,7 +16,7 @@ public:
     explicit DataTypeNullable(const DataTypePtr & nested_data_type_);
     std::string doGetName() const override { return "Nullable(" + nested_data_type->getName() + ")"; }
     const char * getFamilyName() const override { return "Nullable"; }
-    const char * getSQLCompatibleName() const override { return nested_data_type->getSQLCompatibleName(); }
+    String getSQLCompatibleName() const override { return nested_data_type->getSQLCompatibleName(); }
     TypeIndex getTypeId() const override { return TypeIndex::Nullable; }
 
     MutableColumnPtr createColumn() const override;
diff --git a/src/DataTypes/DataTypeNumberBase.cpp b/src/DataTypes/DataTypeNumberBase.cpp
index db654448e83..e4c0fb96483 100644
--- a/src/DataTypes/DataTypeNumberBase.cpp
+++ b/src/DataTypes/DataTypeNumberBase.cpp
@@ -11,6 +11,55 @@ Field DataTypeNumberBase<T>::getDefault() const
 {
     return NearestFieldType<FieldType>();
 }
+template <typename T>
+String DataTypeNumberBase<T>::getSQLCompatibleName() const
+{
+    if constexpr (std::is_same_v<T, Int8>)
+    {
+        return "TINYINT";
+    }
+    else if constexpr (std::is_same_v<T, Int16>)
+    {
+        return "SMALLINT";
+    }
+    else if constexpr (std::is_same_v<T, Int32>)
+    {
+        return "INTEGER";
+    }
+    else if constexpr (std::is_same_v<T, Int64>)
+    {
+        return "BIGINT";
+    }
+    else if constexpr (std::is_same_v<T, UInt8>)
+    {
+        return "TINYINT UNSIGNED";
+    }
+    else if constexpr (std::is_same_v<T, UInt16>)
+    {
+        return "SMALLINT UNSIGNED";
+    }
+    else if constexpr (std::is_same_v<T, UInt32>)
+    {
+        return "INTEGER UNSIGNED";
+    }
+    else if constexpr (std::is_same_v<T, UInt64>)
+    {
+        return "BIGINT UNSIGNED";
+    }
+    else if constexpr (std::is_same_v<T, Float32>)
+    {
+        return "FLOAT";
+    }
+    else if constexpr (std::is_same_v<T, Float64>)
+    {
+        return "DOUBLE";
+    }
+    /// Unsupported types are converted to TEXT
+    else
+    {
+        return "TEXT";
+    }
+}
 
 template <typename T>
 MutableColumnPtr DataTypeNumberBase<T>::createColumn() const
@@ -30,24 +79,6 @@ bool DataTypeNumberBase<T>::isValueRepresentedByUnsignedInteger() const
     return is_integer<T> && is_unsigned_v<T>;
 }
 
-template <typename T>
-const std::map<std::string, std::string> DataTypeNumberBase<T>::mysqlTypeMap = {
-    {"UInt8", "TINYINT UNSIGNED"},
-    {"UInt16", "SMALLINT UNSIGNED"},
-    {"UInt32", "MEDIUMINT UNSIGNEd"},
-    {"UInt64", "BIGINT UNSIGNED"},
-    {"UInt128", "TEXT"},
-    {"UInt256", "TEXT"},
-    {"Int8", "TINYINT"},
-    {"Int16", "SMALLINT"},
-    {"Int32", "INT"},
-    {"Int64", "BIGINT"},
-    {"Int128", "TEXT"},
-    {"Int256", "TEXT"},
-    {"Float32", "FLOAT"},
-    {"Float64", "DOUBLE"},
-};
-
 /// Explicit template instantiations - to avoid code bloat in headers.
 template class DataTypeNumberBase<UInt8>;
 template class DataTypeNumberBase<UInt16>;
diff --git a/src/DataTypes/DataTypeNumberBase.h b/src/DataTypes/DataTypeNumberBase.h
index 1a855a974f0..d902c62505e 100644
--- a/src/DataTypes/DataTypeNumberBase.h
+++ b/src/DataTypes/DataTypeNumberBase.h
@@ -20,14 +20,12 @@ public:
     static constexpr bool is_parametric = false;
     static constexpr auto family_name = TypeName<T>;
     static constexpr auto type_id = TypeToTypeIndex<T>;
-    // Create a map from the name of the type to the name of the type in MySQL.
-    static const std::map<std::string, std::string> mysqlTypeMap;
 
     using FieldType = T;
     using ColumnType = ColumnVector<T>;
 
     const char * getFamilyName() const override { return TypeName<T>.data(); }
-    const char * getSQLCompatibleName() const override { return mysqlTypeMap.at(TypeName<T>.data()).c_str(); }
+    String getSQLCompatibleName() const override;
     TypeIndex getTypeId() const override { return TypeToTypeIndex<T>; }
 
     Field getDefault() const override;
diff --git a/src/DataTypes/DataTypeObject.h b/src/DataTypes/DataTypeObject.h
index 618c7389758..2e1e5398f7e 100644
--- a/src/DataTypes/DataTypeObject.h
+++ b/src/DataTypes/DataTypeObject.h
@@ -23,7 +23,7 @@ public:
     DataTypeObject(const String & schema_format_, bool is_nullable_);
 
     const char * getFamilyName() const override { return "Object"; }
-    const char * getSQLCompatibleName() const override { return "JSON"; }
+    String getSQLCompatibleName() const override { return "JSON"; }
     String doGetName() const override;
     TypeIndex getTypeId() const override { return TypeIndex::Object; }
 
diff --git a/src/DataTypes/DataTypeSet.h b/src/DataTypes/DataTypeSet.h
index 916b4f071a5..d88d76b31be 100644
--- a/src/DataTypes/DataTypeSet.h
+++ b/src/DataTypes/DataTypeSet.h
@@ -15,7 +15,7 @@ class DataTypeSet final : public IDataTypeDummy
 public:
     static constexpr bool is_parametric = true;
     const char * getFamilyName() const override { return "Set"; }
-    const char * getSQLCompatibleName() const override { return "TEXT"; }
+    String getSQLCompatibleName() const override { return "TEXT"; }
 
     TypeIndex getTypeId() const override { return TypeIndex::Set; }
     bool equals(const IDataType & rhs) const override { return typeid(rhs) == typeid(*this); }
diff --git a/src/DataTypes/DataTypeString.h b/src/DataTypes/DataTypeString.h
index 338b3846266..c39fa90f6e7 100644
--- a/src/DataTypes/DataTypeString.h
+++ b/src/DataTypes/DataTypeString.h
@@ -21,8 +21,7 @@ public:
         return "String";
     }
 
-    // FIXME: string can contain arbitrary bytes, not only UTF-8 sequences
-    const char * getSQLCompatibleName() const override { return "BLOB"; }
+    String getSQLCompatibleName() const override { return "BLOB"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypeTuple.h b/src/DataTypes/DataTypeTuple.h
index 93fa87b1332..ea05e6ae59b 100644
--- a/src/DataTypes/DataTypeTuple.h
+++ b/src/DataTypes/DataTypeTuple.h
@@ -33,7 +33,7 @@ public:
     TypeIndex getTypeId() const override { return TypeIndex::Tuple; }
     std::string doGetName() const override;
     const char * getFamilyName() const override { return "Tuple"; }
-    const char * getSQLCompatibleName() const override { return "JSON"; }
+    String getSQLCompatibleName() const override { return "JSON"; }
 
     bool canBeInsideNullable() const override { return false; }
     bool supportsSparseSerialization() const override { return true; }
diff --git a/src/DataTypes/DataTypeUUID.h b/src/DataTypes/DataTypeUUID.h
index bbf35074df3..8664c3bcfd1 100644
--- a/src/DataTypes/DataTypeUUID.h
+++ b/src/DataTypes/DataTypeUUID.h
@@ -18,7 +18,7 @@ public:
     static constexpr auto type_id = TypeIndex::UUID;
 
     const char * getFamilyName() const override { return "UUID"; }
-    const char * getSQLCompatibleName() const override { return "CHAR"; }
+    String getSQLCompatibleName() const override { return "CHAR"; }
 
     TypeIndex getTypeId() const override { return type_id; }
 
diff --git a/src/DataTypes/DataTypesDecimal.cpp b/src/DataTypes/DataTypesDecimal.cpp
index 1c2a63371ee..fa044d4ac9c 100644
--- a/src/DataTypes/DataTypesDecimal.cpp
+++ b/src/DataTypes/DataTypesDecimal.cpp
@@ -28,6 +28,11 @@ std::string DataTypeDecimal<T>::doGetName() const
     return fmt::format("Decimal({}, {})", this->precision, this->scale);
 }
 
+template <is_decimal T>
+std::string DataTypeDecimal<T>::getSQLCompatibleName() const
+{
+    return fmt::format("DECIMAL({}, {})", this->precision, this->scale);
+}
 
 template <is_decimal T>
 bool DataTypeDecimal<T>::equals(const IDataType & rhs) const
diff --git a/src/DataTypes/DataTypesDecimal.h b/src/DataTypes/DataTypesDecimal.h
index 6f3bf582aeb..5e4cfab7928 100644
--- a/src/DataTypes/DataTypesDecimal.h
+++ b/src/DataTypes/DataTypesDecimal.h
@@ -37,10 +37,9 @@ public:
     using Base::Base;
 
     static constexpr auto family_name = "Decimal";
-    static constexpr auto mysql_name = "DECIMAL";
 
     const char * getFamilyName() const override { return family_name; }
-    const char * getSQLCompatibleName() const override { return mysql_name; }
+    String getSQLCompatibleName() const override;
 
     std::string doGetName() const override;
     TypeIndex getTypeId() const override { return TypeToTypeIndex<T>; }
diff --git a/src/DataTypes/IDataType.h b/src/DataTypes/IDataType.h
index 93fdbab05ef..51a9ecef0cc 100644
--- a/src/DataTypes/IDataType.h
+++ b/src/DataTypes/IDataType.h
@@ -71,19 +71,12 @@ public:
           return doGetName();
     }
 
-    /// MySQL equivalent Name of data type (examples: UInt64, Array(String)).
-    String getMySQLTypeName() const
-    {
-        if (custom_name)
-            return custom_name->getName();
-        else
-            return doGetMySQLName();
-    }
     DataTypePtr getPtr() const { return shared_from_this(); }
 
     /// Name of data type family (example: FixedString, Array).
     virtual const char * getFamilyName() const = 0;
-    virtual const char * getSQLCompatibleName() const = 0;
+    /// Name of corresponding data type in MySQL (exampe: Bigint, Blob, etc)
+    virtual String getSQLCompatibleName() const = 0;
 
     /// Data type id. It's used for runtime type checks.
     virtual TypeIndex getTypeId() const = 0;
@@ -135,7 +128,6 @@ public:
 
 protected:
     virtual String doGetName() const { return getFamilyName(); }
-    virtual String doGetMySQLName() const { return getSQLCompatibleName(); }
     virtual SerializationPtr doGetDefaultSerialization() const = 0;
 
 public:
diff --git a/src/Storages/System/StorageSystemColumns.cpp b/src/Storages/System/StorageSystemColumns.cpp
index f391a392dbb..684c35709a4 100644
--- a/src/Storages/System/StorageSystemColumns.cpp
+++ b/src/Storages/System/StorageSystemColumns.cpp
@@ -74,7 +74,8 @@ public:
         : ISource(header_)
         , columns_mask(std::move(columns_mask_)), max_block_size(max_block_size_)
         , databases(std::move(databases_)), tables(std::move(tables_)), storages(std::move(storages_))
-        , clientInfo(context->getClientInfo())
+        , client_info_interface(context->getClientInfo().interface)
+        , use_mysql_types(context->getSettingsRef().output_format_mysql_types)
         , total_tables(tables->size()), access(context->getAccess())
         , query_id(context->getCurrentQueryId()), lock_acquire_timeout(context->getSettingsRef().lock_acquire_timeout)
     {
@@ -132,9 +133,10 @@ protected:
 
             auto get_type_name = [this](const IDataType& type) -> std::string
             {
-                if (clientInfo.interface == DB::ClientInfo::Interface::MYSQL)
+                // Check if the output_format_mysql_types setting is enabled and client is connected via MySQL protocol
+                if (use_mysql_types && client_info_interface == DB::ClientInfo::Interface::MYSQL)
                 {
-                   return type.getMySQLTypeName();
+                    return type.getSQLCompatibleName();
                 }
                 else
                 {
@@ -293,7 +295,8 @@ private:
     ColumnPtr databases;
     ColumnPtr tables;
     Storages storages;
-    ClientInfo clientInfo;
+    ClientInfo::Interface client_info_interface;
+    bool use_mysql_types;
     size_t db_table_num = 0;
     size_t total_tables;
     std::shared_ptr<const ContextAccess> access;
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
index 1742cd9c90c..68e7be9ae6f 100644
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.reference
@@ -4,6 +4,44 @@ Create pseudo-random database name
 Create tab duplicate table
 Run MySQL test
 field	type	null	key	default	extra
+aggregate_function	AggregateFunction(sum, Int32)	0		NULL	
+array_value	Array(Int32)	0		NULL	
+boolean_value	UInt8	0		NULL	
+date32_value	Date32	0		NULL	
+date_value	Date	0		NULL	
+datetime64_value	DateTime64(3)	0		NULL	
+datetime_value	DateTime	0		NULL	
+decimal_value	Decimal(10, 2)	0		NULL	
+enum_value	Enum8('apple' = 1, 'banana' = 2, 'orange' = 3)	0		NULL	
+fixed_string_value	FixedString(10)	0		NULL	
+float32	Float32	0		NULL	
+float64	Float64	0		NULL	
+int128	Int128	0		NULL	
+int16	Int16	0		NULL	
+int256	Int256	0		NULL	
+int32	Int32	0		NULL	
+int64	Int64	0		NULL	
+int8	Int8	0		NULL	
+ipv4_value	IPv4	0		NULL	
+ipv6_value	IPv6	0		NULL	
+json_value	Object('json')	0		NULL	
+low_cardinality	LowCardinality(String)	0		NULL	
+low_cardinality_date	LowCardinality(DateTime)	0		NULL	
+map_value	Map(String, Int32)	0		NULL	
+nested.nested_int	Array(Int32)	0		NULL	
+nested.nested_string	Array(String)	0		NULL	
+nint32	Nullable(Int32)	1		NULL	
+nullable_value	Nullable(Int32)	1		NULL	
+string_value	String	0		NULL	
+tuple_value	Tuple(Int32, String)	0		NULL	
+uint128	UInt128	0		NULL	
+uint16	UInt16	0		NULL	
+uint256	UInt256	0		NULL	
+uint32	UInt32	0		NULL	
+uint64	UInt64	0	PRI SOR	NULL	
+uint8	UInt8	0		NULL	
+uuid_value	UUID	0		NULL	
+field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
 array_value	TEXT	0		NULL	
 boolean_value	TINYINT UNSIGNED	0		NULL	
@@ -11,12 +49,17 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
 float64	DOUBLE	0		NULL	
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 ipv4_value	TEXT	0		NULL	
 ipv6_value	TEXT	0		NULL	
 json_value	JSON	0		NULL	
@@ -25,10 +68,16 @@ low_cardinality_date	DATETIME	0		NULL
 map_value	JSON	0		NULL	
 nested.nested_int	TEXT	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nint32	INTEGER	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
@@ -38,12 +87,17 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
 float64	DOUBLE	0		NULL	
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 ipv4_value	TEXT	0		NULL	
 ipv6_value	TEXT	0		NULL	
 json_value	JSON	0		NULL	
@@ -52,10 +106,16 @@ low_cardinality_date	DATETIME	0		NULL
 map_value	JSON	0		NULL	
 nested.nested_int	TEXT	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nint32	INTEGER	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra	collation	comment	privileges
 aggregate_function	TEXT	0		NULL		NULL		
@@ -65,12 +125,17 @@ date32_value	DATE	0		NULL		NULL
 date_value	DATE	0		NULL		NULL		
 datetime64_value	DATETIME	0		NULL		NULL		
 datetime_value	DATETIME	0		NULL		NULL		
-decimal_value	DECIMAL	0		NULL		NULL		
+decimal_value	DECIMAL(10, 2)	0		NULL		NULL		
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL		NULL		
 fixed_string_value	TEXT	0		NULL		NULL		
 float32	FLOAT	0		NULL		NULL		
 float64	DOUBLE	0		NULL		NULL		
-int32	INT	0		NULL		NULL		
+int128	TEXT	0		NULL		NULL		
+int16	SMALLINT	0		NULL		NULL		
+int256	TEXT	0		NULL		NULL		
+int32	INTEGER	0		NULL		NULL		
+int64	BIGINT	0		NULL		NULL		
+int8	TINYINT	0		NULL		NULL		
 ipv4_value	TEXT	0		NULL		NULL		
 ipv6_value	TEXT	0		NULL		NULL		
 json_value	JSON	0		NULL		NULL		
@@ -79,15 +144,32 @@ low_cardinality_date	DATETIME	0		NULL		NULL
 map_value	JSON	0		NULL		NULL		
 nested.nested_int	TEXT	0		NULL		NULL		
 nested.nested_string	TEXT	0		NULL		NULL		
-nullable_value	INT	0		NULL		NULL		
+nint32	INTEGER	0		NULL		NULL		
+nullable_value	INTEGER	0		NULL		NULL		
 string_value	BLOB	0		NULL		NULL		
 tuple_value	JSON	0		NULL		NULL		
+uint128	TEXT	0		NULL		NULL		
+uint16	SMALLINT UNSIGNED	0		NULL		NULL		
+uint256	TEXT	0		NULL		NULL		
+uint32	INTEGER UNSIGNED	0		NULL		NULL		
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL		NULL		
+uint8	TINYINT UNSIGNED	0		NULL		NULL		
 uuid_value	CHAR	0		NULL		NULL		
 field	type	null	key	default	extra
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 nested.nested_int	TEXT	0		NULL	
+nint32	INTEGER	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
 array_value	TEXT	0		NULL	
@@ -96,7 +178,7 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
@@ -108,14 +190,25 @@ low_cardinality	BLOB	0		NULL
 low_cardinality_date	DATETIME	0		NULL	
 map_value	JSON	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
 uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 nested.nested_int	TEXT	0		NULL	
+nint32	INTEGER	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
 array_value	TEXT	0		NULL	
@@ -124,7 +217,7 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
@@ -136,14 +229,25 @@ low_cardinality	BLOB	0		NULL
 low_cardinality_date	DATETIME	0		NULL	
 map_value	JSON	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
 uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 nested.nested_int	TEXT	0		NULL	
+nint32	INTEGER	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
 field	type	null	key	default	extra
@@ -154,12 +258,17 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
 float64	DOUBLE	0		NULL	
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 ipv4_value	TEXT	0		NULL	
 ipv6_value	TEXT	0		NULL	
 json_value	JSON	0		NULL	
@@ -168,10 +277,16 @@ low_cardinality_date	DATETIME	0		NULL
 map_value	JSON	0		NULL	
 nested.nested_int	TEXT	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nint32	INTEGER	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
@@ -181,12 +296,17 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
 float64	DOUBLE	0		NULL	
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 ipv4_value	TEXT	0		NULL	
 ipv6_value	TEXT	0		NULL	
 json_value	JSON	0		NULL	
@@ -195,10 +315,16 @@ low_cardinality_date	DATETIME	0		NULL
 map_value	JSON	0		NULL	
 nested.nested_int	TEXT	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nint32	INTEGER	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 uuid_value	CHAR	0		NULL	
 field	type	null	key	default	extra
 aggregate_function	TEXT	0		NULL	
@@ -208,12 +334,17 @@ date32_value	DATE	0		NULL
 date_value	DATE	0		NULL	
 datetime64_value	DATETIME	0		NULL	
 datetime_value	DATETIME	0		NULL	
-decimal_value	DECIMAL	0		NULL	
+decimal_value	DECIMAL(10, 2)	0		NULL	
 enum_value	ENUM('apple', 'banana', 'orange')	0		NULL	
 fixed_string_value	TEXT	0		NULL	
 float32	FLOAT	0		NULL	
 float64	DOUBLE	0		NULL	
-int32	INT	0		NULL	
+int128	TEXT	0		NULL	
+int16	SMALLINT	0		NULL	
+int256	TEXT	0		NULL	
+int32	INTEGER	0		NULL	
+int64	BIGINT	0		NULL	
+int8	TINYINT	0		NULL	
 ipv4_value	TEXT	0		NULL	
 ipv6_value	TEXT	0		NULL	
 json_value	JSON	0		NULL	
@@ -222,8 +353,14 @@ low_cardinality_date	DATETIME	0		NULL
 map_value	JSON	0		NULL	
 nested.nested_int	TEXT	0		NULL	
 nested.nested_string	TEXT	0		NULL	
-nullable_value	INT	0		NULL	
+nint32	INTEGER	0		NULL	
+nullable_value	INTEGER	0		NULL	
 string_value	BLOB	0		NULL	
 tuple_value	JSON	0		NULL	
+uint128	TEXT	0		NULL	
+uint16	SMALLINT UNSIGNED	0		NULL	
+uint256	TEXT	0		NULL	
+uint32	INTEGER UNSIGNED	0		NULL	
 uint64	BIGINT UNSIGNED	0	PRI SOR	NULL	
+uint8	TINYINT UNSIGNED	0		NULL	
 uuid_value	CHAR	0		NULL	
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index fd1ad92f060..938102cb5fc 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -17,15 +17,25 @@ ${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
 ${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
 ${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
 
-#${CLICKHOUSE_LOCAL} --query "SET allow_suspicious_low_cardinality_types = 1;"
 echo "Create tab table "
 ${CLICKHOUSE_LOCAL} -n -q "
     SET allow_suspicious_low_cardinality_types=1;
-    SET allow_experimental_object_type =1;
+    SET allow_experimental_object_type=1;
     CREATE TABLE tab
     (
+        uint8 UInt8,
+        uint16 UInt16,
+        uint32 UInt32,
         uint64 UInt64,
-        int32 Nullable(Int32),
+        uint128 UInt128,
+        uint256 UInt256,
+        int8 Int8,
+        int16 Int16,
+        int32 Int32,
+        int64 Int64,
+        int128 Int128,
+        int256 Int256,
+        nint32 Nullable(Int32),
         float32 Float32,
         float64 Float64,
         decimal_value Decimal(10, 2),
@@ -67,8 +77,19 @@ ${CLICKHOUSE_LOCAL} -n -q "
     SET allow_experimental_object_type =1;
     CREATE TABLE database_123456789abcde.tab
     (
+        uint8 UInt8,
+        uint16 UInt16,
+        uint32 UInt32,
         uint64 UInt64,
-        int32 Nullable(Int32),
+        uint128 UInt128,
+        uint256 UInt256,
+        int8 Int8,
+        int16 Int16,
+        int32 Int32,
+        int64 Int64,
+        int128 Int128,
+        int256 Int256,
+        nint32 Nullable(Int32),
         float32 Float32,
         float64 Float64,
         decimal_value Decimal(10, 2),
@@ -105,6 +126,8 @@ TEMP_FILE=$(mktemp)
 
 cat <<EOT > $TEMP_FILE
 SHOW COLUMNS FROM tab;
+SET output_format_mysql_types=1;
+SHOW COLUMNS FROM tab;
 SHOW EXTENDED COLUMNS FROM tab;
 SHOW FULL COLUMNS FROM tab;
 SHOW COLUMNS FROM tab LIKE '%int%';

From 6d25e5a0d75325ddeee2be0d689da6ea4395fccc Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Tue, 6 Jun 2023 07:37:14 +0300
Subject: [PATCH 217/722] Substitute missing year in
 parseDateTimeBestEffortImpl()

---
 src/IO/parseDateTimeBestEffort.cpp | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/IO/parseDateTimeBestEffort.cpp b/src/IO/parseDateTimeBestEffort.cpp
index b370bee6f3f..f753e3c0b4e 100644
--- a/src/IO/parseDateTimeBestEffort.cpp
+++ b/src/IO/parseDateTimeBestEffort.cpp
@@ -578,12 +578,16 @@ ReturnType parseDateTimeBestEffortImpl(
     if (!year && !month && !day_of_month && !has_time)
         return on_error(ErrorCodes::CANNOT_PARSE_DATETIME, "Cannot read DateTime: neither Date nor Time was parsed successfully");
 
-    if (!year)
-        year = 2000;
-    if (!month)
-        month = 1;
     if (!day_of_month)
         day_of_month = 1;
+    if (!month)
+        month = 1;
+    if (!year)
+    {
+        time_t now = time(nullptr);
+        UInt16 curr_year = local_time_zone.toYear(now);
+        year = now < local_time_zone.makeDateTime(year, month, day_of_month, hour, minute, second) ? curr_year - 1 : curr_year;
+    }
 
     auto is_leap_year = (year % 400 == 0) || (year % 100 != 0 && year % 4 == 0);
 

From 3f77b778e368c1c5e3cd3012d54107193094502b Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Tue, 6 Jun 2023 11:42:45 +0300
Subject: [PATCH 218/722] Fix runtime bug

---
 src/IO/parseDateTimeBestEffort.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/IO/parseDateTimeBestEffort.cpp b/src/IO/parseDateTimeBestEffort.cpp
index f753e3c0b4e..6bdba251c36 100644
--- a/src/IO/parseDateTimeBestEffort.cpp
+++ b/src/IO/parseDateTimeBestEffort.cpp
@@ -586,7 +586,7 @@ ReturnType parseDateTimeBestEffortImpl(
     {
         time_t now = time(nullptr);
         UInt16 curr_year = local_time_zone.toYear(now);
-        year = now < local_time_zone.makeDateTime(year, month, day_of_month, hour, minute, second) ? curr_year - 1 : curr_year;
+        year = now < local_time_zone.makeDateTime(curr_year, month, day_of_month, hour, minute, second) ? curr_year - 1 : curr_year;
     }
 
     auto is_leap_year = (year % 400 == 0) || (year % 100 != 0 && year % 4 == 0);

From 5b3cece42eb540f5b05d04faa7fe3de7cd1ccb86 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Tue, 6 Jun 2023 12:23:00 +0200
Subject: [PATCH 219/722] Fix shellcheck

---
 docker/test/stateless/run.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index df650b37cc6..c0acb0291a4 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -15,6 +15,7 @@ dpkg -i package_folder/clickhouse-client_*.deb
 
 ln -s /usr/share/clickhouse-test/clickhouse-test /usr/bin/clickhouse-test
 
+# shellcheck disable=SC1091
 source /usr/share/clickhouse-test/ci/attach_gdb.lib
 
 # install test configs

From 8d044e8880a588a7854a6f6e2513226a6335ff48 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 6 Jun 2023 10:57:13 +0000
Subject: [PATCH 220/722] Increase max array size in group bitmap

---
 src/AggregateFunctions/AggregateFunctionGroupBitmapData.h | 2 +-
 tests/queries/0_stateless/02782_bitmap_overflow.reference | 0
 tests/queries/0_stateless/02782_bitmap_overflow.sql       | 2 ++
 3 files changed, 3 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02782_bitmap_overflow.reference
 create mode 100644 tests/queries/0_stateless/02782_bitmap_overflow.sql

diff --git a/src/AggregateFunctions/AggregateFunctionGroupBitmapData.h b/src/AggregateFunctions/AggregateFunctionGroupBitmapData.h
index d99f0bf16ee..7ea1ebe7749 100644
--- a/src/AggregateFunctions/AggregateFunctionGroupBitmapData.h
+++ b/src/AggregateFunctions/AggregateFunctionGroupBitmapData.h
@@ -122,7 +122,7 @@ public:
             size_t size;
             readVarUInt(size, in);
 
-            static constexpr size_t max_size = 1_GiB;
+            static constexpr size_t max_size = 100_GiB;
 
             if (size == 0)
                 throw Exception(ErrorCodes::INCORRECT_DATA, "Incorrect size (0) in groupBitmap.");
diff --git a/tests/queries/0_stateless/02782_bitmap_overflow.reference b/tests/queries/0_stateless/02782_bitmap_overflow.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02782_bitmap_overflow.sql b/tests/queries/0_stateless/02782_bitmap_overflow.sql
new file mode 100644
index 00000000000..656a3e7c144
--- /dev/null
+++ b/tests/queries/0_stateless/02782_bitmap_overflow.sql
@@ -0,0 +1,2 @@
+select unhex('0181808080908380808000')::AggregateFunction(groupBitmap, UInt64); -- {serverError TOO_LARGE_ARRAY_SIZE}
+

From cf886d8ced474a1a80a985587af251a39701d1b2 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Tue, 6 Jun 2023 11:08:21 +0000
Subject: [PATCH 221/722] Remove IsConvertible()

---
 src/Functions/DateTimeTransforms.h  | 46 +++++++++++++++--------------
 src/Functions/FunctionsConversion.h | 41 -------------------------
 2 files changed, 24 insertions(+), 63 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index d154dd9ffa2..823272e0324 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -1444,31 +1444,33 @@ struct Transformer
 
         for (size_t i = 0; i < size; ++i)
         {
-            constexpr bool transformHasIsConvertible = requires(const Transform& t)
+            if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
+                || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
             {
-                t.IsConvertible(vec_from[i], time_zone);
-            };
+                bool check_range_result = true;
 
-            if constexpr (transformHasIsConvertible)
-            {
-                if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
-                    || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+                if constexpr (std::is_same_v<ToType, DataTypeDate>)
                 {
-                    bool checked = transform.IsConvertible(vec_from[i], time_zone);
-                    if (!checked)
+                    check_range_result = vec_from[i] >= 0 && vec_from[i] <= DATE_LUT_MAX_DAY_NUM;
+                }
+                else if constexpr (std::is_same_v<ToType, DataTypeDateTime>)
+                {
+                    check_range_result = vec_from[i] >= 0 && vec_from[i] <= 0xFFFFFFFFL;
+                }
+
+                if (!check_range_result)
+                {
+                    if (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
                     {
-                        if (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
-                        {
-                            vec_to[i] = 0;
-                            if (vec_null_map_to)
-                                (*vec_null_map_to)[i] = true;
-                            continue;
-                        }
-                        else
-                        {
-                            throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
-                                TypeName<typename FromTypeVector::value_type>, TypeName<ValueType>);
-                        }
+                        vec_to[i] = 0;
+                        if (vec_null_map_to)
+                            (*vec_null_map_to)[i] = true;
+                        continue;
+                    }
+                    else
+                    {
+                        throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
+                            TypeName<FromType>, TypeName<ToType>);
                     }
                 }
             }
@@ -1488,7 +1490,7 @@ struct DateTimeTransformImpl
     static ColumnPtr execute(
         const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type, size_t /*input_rows_count*/, const Transform & transform = {})
     {
-        using Op = Transformer<typename FromDataType::FieldType, typename ToDataType::FieldType, Transform, is_extended_result, Additions>;
+        using Op = Transformer<FromDataType, ToDataType, Transform, is_extended_result, Additions>;
 
         const ColumnPtr source_col = arguments[0].column;
         if (const auto * sources = checkAndGetColumn<typename FromDataType::ColumnType>(source_col.get()))
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 6aa5843ff65..3a8ddcc9094 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -365,22 +365,11 @@ template <typename Name> struct ConvertImpl<DataTypeDate32, DataTypeDateTime, Na
 
 /// Implementation of toDate function.
 
-template <typename FromType>
-static bool CheckDateRange(const FromType & value)
-{
-    return value >= 0 && value <= DATE_LUT_MAX_DAY_NUM;
-}
-
 template <typename FromType, typename ToType>
 struct ToDateTransform32Or64
 {
     static constexpr auto name = "toDate";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return CheckDateRange(from);
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         // since converting to Date, no need in values outside of default LUT range.
@@ -395,11 +384,6 @@ struct ToDateTransform32Or64Signed
 {
     static constexpr auto name = "toDate";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return CheckDateRange(from);
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl & time_zone)
     {
         // TODO: decide narrow or extended range based on FromType
@@ -417,11 +401,6 @@ struct ToDateTransform8Or16Signed
 {
     static constexpr auto name = "toDate";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return CheckDateRange(from);
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)
@@ -518,22 +497,12 @@ template <typename Name> struct ConvertImpl<DataTypeFloat32, DataTypeDate32, Nam
 template <typename Name> struct ConvertImpl<DataTypeFloat64, DataTypeDate32, Name, ConvertDefaultBehaviorTag>
     : DateTimeTransformImpl<DataTypeFloat64, DataTypeDate32, ToDate32Transform32Or64Signed<Float64, Int32>> {};
 
-template <typename FromType>
-static bool CheckDateTimeRange(const FromType & value)
-{
-    return value >= 0 && value <= 0xFFFFFFFFL;
-}
 
 template <typename FromType, typename ToType>
 struct ToDateTimeTransform64
 {
     static constexpr auto name = "toDateTime";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return CheckDateTimeRange(from);
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         return static_cast<ToType>(std::min(time_t(from), time_t(0xFFFFFFFF)));
@@ -545,11 +514,6 @@ struct ToDateTimeTransformSigned
 {
     static constexpr auto name = "toDateTime";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return CheckDateTimeRange(from);
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)
@@ -563,11 +527,6 @@ struct ToDateTimeTransform64Signed
 {
     static constexpr auto name = "toDateTime";
 
-    static NO_SANITIZE_UNDEFINED bool IsConvertible(const FromType & from, const DateLUTImpl &)
-    {
-        return CheckDateTimeRange(from);
-    }
-
     static NO_SANITIZE_UNDEFINED ToType execute(const FromType & from, const DateLUTImpl &)
     {
         if (from < 0)

From 6b41a02f7fbdd46ee2774651fea3518d26844407 Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Tue, 6 Jun 2023 13:14:52 +0200
Subject: [PATCH 222/722] resolve tests

---
 src/Client/Suggest.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Client/Suggest.cpp b/src/Client/Suggest.cpp
index 4ffa828dd40..e249aa1bb04 100644
--- a/src/Client/Suggest.cpp
+++ b/src/Client/Suggest.cpp
@@ -101,7 +101,9 @@ static String getLoadSuggestionQuery(Int32 suggestion_limit, bool basic_suggesti
         add_column("name", "columns", true, suggestion_limit);
     }
 
-    query = "SELECT DISTINCT arrayJoin(extractAll(name, '[\\\\w_]{2,}')) AS res FROM (" + query + ") WHERE notEmpty(res)";
+    /// FIXME: Forbid this query using new analyzer because of bug https://github.com/ClickHouse/ClickHouse/pull/50430#issuecomment-1576860893
+    /// We should remove this restriction after resolving this bug.
+    query = "SELECT DISTINCT arrayJoin(extractAll(name, '[\\\\w_]{2,}')) AS res FROM (" + query + ") WHERE notEmpty(res) SETTINGS allow_experimental_analyzer=0";
     return query;
 }
 

From f096bfcad29b95ea02f720f0becd5931c5b7eb37 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Tue, 6 Jun 2023 15:47:34 +0300
Subject: [PATCH 223/722] Adjust 00569_parse_date_time_best_effort and
 01543_parse_datetime_besteffort_or_null_empty_string to the new feature

---
 .../00569_parse_date_time_best_effort.reference           | 8 ++++----
 .../0_stateless/00569_parse_date_time_best_effort.sql     | 8 ++++----
 ...543_parse_datetime_besteffort_or_null_empty_string.sql | 2 +-
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/tests/queries/0_stateless/00569_parse_date_time_best_effort.reference b/tests/queries/0_stateless/00569_parse_date_time_best_effort.reference
index ad7c17b7717..0729a7628f2 100644
--- a/tests/queries/0_stateless/00569_parse_date_time_best_effort.reference
+++ b/tests/queries/0_stateless/00569_parse_date_time_best_effort.reference
@@ -2,8 +2,8 @@
 
  0                                                ᴺᵁᴸᴸ   1970-01-01 00:00:00 
  0000                                             ᴺᵁᴸᴸ   1970-01-01 00:00:00 
- 00:00:00                          2000-01-01 00:00:00   2000-01-01 00:00:00 
- 01:00:00                          2000-01-01 01:00:00   2000-01-01 01:00:00 
+ 2000-01-01 00:00:00               2000-01-01 00:00:00   2000-01-01 00:00:00 
+ 2000-01-01 01:00:00               2000-01-01 01:00:00   2000-01-01 01:00:00 
  02/01/17 010203 MSK               2017-01-01 22:02:03   2017-01-01 22:02:03 
  02/01/17 010203 MSK+0100          2017-01-01 21:02:03   2017-01-01 21:02:03 
  02/01/17 010203 UTC+0300          2017-01-01 22:02:03   2017-01-01 22:02:03 
@@ -11,13 +11,13 @@
  02/01/1970 010203Z                1970-01-02 01:02:03   1970-01-02 01:02:03 
  02/01/70 010203Z                  1970-01-02 01:02:03   1970-01-02 01:02:03 
  11 Feb 2018 06:40:50 +0300        2018-02-11 03:40:50   2018-02-11 03:40:50 
- 17 Apr 2 1:2:3                    2000-04-17 01:02:03   2000-04-17 01:02:03 
+ 17 Apr 2000 2 1:2:3               2000-04-17 01:02:03   2000-04-17 01:02:03 
  19700102 01:00:00                 1970-01-02 01:00:00   1970-01-02 01:00:00 
  1970010201:00:00                                 ᴺᵁᴸᴸ   1970-01-01 00:00:00 
  19700102010203                    1970-01-02 01:02:03   1970-01-02 01:02:03 
  19700102010203Z                   1970-01-02 01:02:03   1970-01-02 01:02:03 
  1970/01/02 010203Z                1970-01-02 01:02:03   1970-01-02 01:02:03 
- 20                                2000-01-20 00:00:00   2000-01-20 00:00:00 
+ 20 2000                           2000-01-20 00:00:00   2000-01-20 00:00:00 
  201                                              ᴺᵁᴸᴸ   1970-01-01 00:00:00 
  20160101                          2016-01-01 00:00:00   2016-01-01 00:00:00 
  2016-01-01                        2016-01-01 00:00:00   2016-01-01 00:00:00 
diff --git a/tests/queries/0_stateless/00569_parse_date_time_best_effort.sql b/tests/queries/0_stateless/00569_parse_date_time_best_effort.sql
index 5f71efa1485..511addb4e4d 100644
--- a/tests/queries/0_stateless/00569_parse_date_time_best_effort.sql
+++ b/tests/queries/0_stateless/00569_parse_date_time_best_effort.sql
@@ -7,8 +7,8 @@ FROM
     SELECT arrayJoin([
 '0',
 '0000',
-'00:00:00',
-'01:00:00',
+'2000-01-01 00:00:00',
+'2000-01-01 01:00:00',
 '02/01/17 010203 MSK',
 '02/01/17 010203 MSK+0100',
 '02/01/17 010203 UTC+0300',
@@ -16,13 +16,13 @@ FROM
 '02/01/1970 010203Z',
 '02/01/70 010203Z',
 '11 Feb 2018 06:40:50 +0300',
-'17 Apr 2 1:2:3',
+'17 Apr 2000 2 1:2:3',
 '19700102 01:00:00',
 '1970010201:00:00',
 '19700102010203',
 '19700102010203Z',
 '1970/01/02 010203Z',
-'20',
+'20 2000',
 '201',
 '20160101',
 '2016-01-01',
diff --git a/tests/queries/0_stateless/01543_parse_datetime_besteffort_or_null_empty_string.sql b/tests/queries/0_stateless/01543_parse_datetime_besteffort_or_null_empty_string.sql
index ad14c4ede06..7098028963d 100644
--- a/tests/queries/0_stateless/01543_parse_datetime_besteffort_or_null_empty_string.sql
+++ b/tests/queries/0_stateless/01543_parse_datetime_besteffort_or_null_empty_string.sql
@@ -4,7 +4,7 @@ SELECT parseDateTimeBestEffortOrNull('2020-01-01 11:01:01 am');
 SELECT parseDateTimeBestEffortOrNull('2020-01-01 11:01:01 pm');
 SELECT parseDateTimeBestEffortOrNull('2020-01-01 12:01:01 am');
 SELECT parseDateTimeBestEffortOrNull('2020-01-01 12:01:01 pm');
-SELECT parseDateTimeBestEffortOrNull('01:01:01');
+SELECT parseDateTimeBestEffortOrNull('2000-01-01 01:01:01');
 SELECT parseDateTimeBestEffortOrNull('20100');
 SELECT parseDateTimeBestEffortOrNull('0100:0100:0000');
 SELECT parseDateTimeBestEffortOrNull('x');

From 5ffbe2d9d4de6e47268be38ac84e5de45faded49 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 6 Jun 2023 10:14:31 -0300
Subject: [PATCH 224/722] Update docs/en/sql-reference/data-types/ipv6.md

Co-authored-by: Yakov Olkhovskiy <99031427+yakov-olkhovskiy@users.noreply.github.com>
---
 docs/en/sql-reference/data-types/ipv6.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/data-types/ipv6.md b/docs/en/sql-reference/data-types/ipv6.md
index 284a1f80854..97959308b58 100644
--- a/docs/en/sql-reference/data-types/ipv6.md
+++ b/docs/en/sql-reference/data-types/ipv6.md
@@ -6,7 +6,7 @@ sidebar_label: IPv6
 
 ## IPv6
 
-IPv6 addresses. Stored in 16 bytes as UInt128.
+IPv6 addresses. Stored in 16 bytes as UInt128 big-endian.
 
 ### Basic Usage
 

From df50833b709ea862ea49f24763c74cf898b10907 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 6 Jun 2023 17:33:05 +0000
Subject: [PATCH 225/722] Allow to skip trailing empty lines in
 CSV/TSV/CustomeSeparated formats

---
 docs/en/interfaces/formats.md                  |  6 +++++-
 .../en/operations/settings/settings-formats.md | 18 ++++++++++++++++++
 src/Core/Settings.h                            |  3 +++
 src/Formats/FormatFactory.cpp                  |  3 +++
 src/Formats/FormatSettings.h                   |  3 +++
 .../Formats/Impl/CSVRowInputFormat.cpp         | 14 ++++++++++++++
 .../Formats/Impl/CSVRowInputFormat.h           |  1 +
 .../Impl/CustomSeparatedRowInputFormat.cpp     |  4 ++++
 .../Impl/TabSeparatedRowInputFormat.cpp        | 14 ++++++++++++++
 .../Formats/Impl/TabSeparatedRowInputFormat.h  |  2 ++
 ..._custom_skip_trailing_empty_lines.reference |  3 +++
 ...sv_csv_custom_skip_trailing_empty_lines.sql | 12 ++++++++++++
 12 files changed, 82 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.reference
 create mode 100644 tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.sql

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index 2ab9e8caec4..70479b8ac71 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -193,6 +193,7 @@ SELECT * FROM nestedt FORMAT TSV
 - [output_format_tsv_crlf_end_of_line](/docs/en/operations/settings/settings-formats.md/#output_format_tsv_crlf_end_of_line) - if it is set true, end of line in TSV output format will be `\r\n` instead of `\n`. Default value - `false`.
 - [input_format_tsv_skip_first_lines](/docs/en/operations/settings/settings-formats.md/#input_format_tsv_skip_first_lines) - skip specified number of lines at the beginning of data. Default value - `0`.
 - [input_format_tsv_detect_header](/docs/en/operations/settings/settings-formats.md/#input_format_tsv_detect_header) - automatically detect header with names and types in TSV format. Default value - `true`.
+- [input_format_tsv_skip_trailing_empty_lines](/docs/en/operations/settings/settings-formats.md/#input_format_tsv_skip_trailing_empty_lines) - skip trailing empty lines at the end of data. Default value - `false`.
 
 ## TabSeparatedRaw {#tabseparatedraw}
 
@@ -467,6 +468,7 @@ The CSV format supports the output of totals and extremes the same way as `TabSe
 - [output_format_csv_crlf_end_of_line](/docs/en/operations/settings/settings-formats.md/#output_format_csv_crlf_end_of_line) - if it is set to true, end of line in CSV output format will be `\r\n` instead of `\n`. Default value - `false`.
 - [input_format_csv_skip_first_lines](/docs/en/operations/settings/settings-formats.md/#input_format_csv_skip_first_lines) - skip the specified number of lines at the beginning of data. Default value - `0`.
 - [input_format_csv_detect_header](/docs/en/operations/settings/settings-formats.md/#input_format_csv_detect_header) - automatically detect header with names and types in CSV format. Default value - `true`.
+- [input_format_csv_skip_trailing_empty_lines](/docs/en/operations/settings/settings-formats.md/#input_format_csv_skip_trailing_empty_lines) - skip trailing empty lines at the end of data. Default value - `false`.
 
 ## CSVWithNames {#csvwithnames}
 
@@ -494,7 +496,9 @@ the types from input data will be compared with the types of the corresponding c
 
 Similar to [Template](#format-template), but it prints or reads all names and types of columns and uses escaping rule from [format_custom_escaping_rule](/docs/en/operations/settings/settings-formats.md/#format_custom_escaping_rule) setting and delimiters from [format_custom_field_delimiter](/docs/en/operations/settings/settings-formats.md/#format_custom_field_delimiter), [format_custom_row_before_delimiter](/docs/en/operations/settings/settings-formats.md/#format_custom_row_before_delimiter), [format_custom_row_after_delimiter](/docs/en/operations/settings/settings-formats.md/#format_custom_row_after_delimiter), [format_custom_row_between_delimiter](/docs/en/operations/settings/settings-formats.md/#format_custom_row_between_delimiter), [format_custom_result_before_delimiter](/docs/en/operations/settings/settings-formats.md/#format_custom_result_before_delimiter) and [format_custom_result_after_delimiter](/docs/en/operations/settings/settings-formats.md/#format_custom_result_after_delimiter) settings, not from format strings.
 
-If setting [input_format_custom_detect_header](/docs/en/operations/settings/settings.md/#input_format_custom_detect_header) is enabled, ClickHouse will automatically detect header with names and types if any.
+If setting [input_format_custom_detect_header](/docs/en/operations/settings/settings-formats.md/#input_format_custom_detect_header) is enabled, ClickHouse will automatically detect header with names and types if any.
+
+If setting [input_format_tsv_skip_trailing_empty_lines](/docs/en/operations/settings/settings-formats.md/#input_format_custom_detect_header) is enabled, trailing empty lines at the end of file will be skipped.
 
 There is also `CustomSeparatedIgnoreSpaces` format, which is similar to [TemplateIgnoreSpaces](#templateignorespaces).
 
diff --git a/docs/en/operations/settings/settings-formats.md b/docs/en/operations/settings/settings-formats.md
index 65038d3a256..a1a75446c37 100644
--- a/docs/en/operations/settings/settings-formats.md
+++ b/docs/en/operations/settings/settings-formats.md
@@ -728,6 +728,12 @@ My NULL
 My NULL
 ```
 
+### input_format_tsv_skip_trailing_empty_lines {input_format_tsv_skip_trailing_empty_lines}
+
+When enabled, trailing empty lines at the end of TSV file will be skipped.
+
+Disabled by default.
+
 ## CSV format settings {#csv-format-settings}
 
 ### format_csv_delimiter {#format_csv_delimiter}
@@ -882,6 +888,12 @@ My NULL
 My NULL
 ```
 
+### input_format_csv_skip_trailing_empty_lines {input_format_csv_skip_trailing_empty_lines}
+
+When enabled, trailing empty lines at the end of CSV file will be skipped.
+
+Disabled by default.
+
 ## Values format settings {#values-format-settings}
 
 ### input_format_values_interpret_expressions {#input_format_values_interpret_expressions}
@@ -1443,6 +1455,12 @@ Sets the character that is interpreted as a suffix after the result set for [Cus
 
 Default value: `''`.
 
+### input_format_custom_skip_trailing_empty_lines {input_format_custom_skip_trailing_empty_lines}
+
+When enabled, trailing empty lines at the end of file in CustomSeparated format will be skipped.
+
+Disabled by default.
+
 ## Regexp format settings {#regexp-format-settings}
 
 ### format_regexp_escaping_rule {#format_regexp_escaping_rule}
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 67c92a0be8b..f688811028e 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -873,6 +873,9 @@ class IColumn;
     M(Bool, output_format_protobuf_nullables_with_google_wrappers, false, "When serializing Nullable columns with Google wrappers, serialize default values as empty wrappers. If turned off, default and null values are not serialized", 0) \
     M(UInt64, input_format_csv_skip_first_lines, 0, "Skip specified number of lines at the beginning of data in CSV format", 0) \
     M(UInt64, input_format_tsv_skip_first_lines, 0, "Skip specified number of lines at the beginning of data in TSV format", 0) \
+    M(Bool, input_format_csv_skip_trailing_empty_lines, false, "Skip trailing empty lines in CSV format", 0) \
+    M(Bool, input_format_tsv_skip_trailing_empty_lines, false, "Skip trailing empty lines in TSV format", 0) \
+    M(Bool, input_format_custom_skip_trailing_empty_lines, false, "Skip trailing empty lines in CustomSeparated format", 0) \
     \
     M(Bool, input_format_native_allow_types_conversion, true, "Allow data types conversion in Native input format", 0) \
     \
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index 586e1bb7251..021ccd35602 100644
--- a/src/Formats/FormatFactory.cpp
+++ b/src/Formats/FormatFactory.cpp
@@ -69,6 +69,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.csv.use_best_effort_in_schema_inference = settings.input_format_csv_use_best_effort_in_schema_inference;
     format_settings.csv.skip_first_lines = settings.input_format_csv_skip_first_lines;
     format_settings.csv.try_detect_header = settings.input_format_csv_detect_header;
+    format_settings.csv.skip_trailing_empty_lines = settings.input_format_csv_skip_trailing_empty_lines;
     format_settings.hive_text.fields_delimiter = settings.input_format_hive_text_fields_delimiter;
     format_settings.hive_text.collection_items_delimiter = settings.input_format_hive_text_collection_items_delimiter;
     format_settings.hive_text.map_keys_delimiter = settings.input_format_hive_text_map_keys_delimiter;
@@ -80,6 +81,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.custom.row_before_delimiter = settings.format_custom_row_before_delimiter;
     format_settings.custom.row_between_delimiter = settings.format_custom_row_between_delimiter;
     format_settings.custom.try_detect_header = settings.input_format_custom_detect_header;
+    format_settings.custom.skip_trailing_empty_lines = settings.input_format_custom_skip_trailing_empty_lines;
     format_settings.date_time_input_format = settings.date_time_input_format;
     format_settings.date_time_output_format = settings.date_time_output_format;
     format_settings.input_format_ipv4_default_on_conversion_error = settings.input_format_ipv4_default_on_conversion_error;
@@ -149,6 +151,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.tsv.use_best_effort_in_schema_inference = settings.input_format_tsv_use_best_effort_in_schema_inference;
     format_settings.tsv.skip_first_lines = settings.input_format_tsv_skip_first_lines;
     format_settings.tsv.try_detect_header = settings.input_format_tsv_detect_header;
+    format_settings.tsv.skip_trailing_empty_lines = settings.input_format_tsv_skip_trailing_empty_lines;
     format_settings.values.accurate_types_of_literals = settings.input_format_values_accurate_types_of_literals;
     format_settings.values.deduce_templates_of_expressions = settings.input_format_values_deduce_templates_of_expressions;
     format_settings.values.interpret_expressions = settings.input_format_values_interpret_expressions;
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index e332bd749a1..9d6cd384b68 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -136,6 +136,7 @@ struct FormatSettings
         UInt64 skip_first_lines = 0;
         String custom_delimiter;
         bool try_detect_header = true;
+        bool skip_trailing_empty_lines = false;
     } csv;
 
     struct HiveText
@@ -156,6 +157,7 @@ struct FormatSettings
         std::string field_delimiter;
         EscapingRule escaping_rule = EscapingRule::Escaped;
         bool try_detect_header = true;
+        bool skip_trailing_empty_lines = false;
     } custom;
 
     struct
@@ -291,6 +293,7 @@ struct FormatSettings
         bool use_best_effort_in_schema_inference = true;
         UInt64 skip_first_lines = 0;
         bool try_detect_header = true;
+        bool skip_trailing_empty_lines = false;
     } tsv;
 
     struct
diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index de955d81651..f01f20a0a3c 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -322,6 +322,20 @@ void CSVFormatReader::setReadBuffer(ReadBuffer & in_)
     FormatWithNamesAndTypesReader::setReadBuffer(*buf);
 }
 
+bool CSVFormatReader::checkForSuffix()
+{
+    if (!format_settings.csv.skip_trailing_empty_lines)
+        return buf->eof();
+
+    PeekableReadBufferCheckpoint checkpoint(*buf);
+    while (checkChar('\n', *buf) || checkChar('\r', *buf));
+    if (buf->eof())
+        return true;
+
+    buf->rollbackToCheckpoint();
+    return false;
+}
+
 CSVSchemaReader::CSVSchemaReader(ReadBuffer & in_, bool with_names_, bool with_types_, const FormatSettings & format_settings_)
     : FormatWithNamesAndTypesSchemaReader(
         buf,
diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.h b/src/Processors/Formats/Impl/CSVRowInputFormat.h
index f51f674e4af..0c8099a216c 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.h
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.h
@@ -75,6 +75,7 @@ public:
     std::vector<String> readRow() { return readRowImpl<false>(); }
     std::vector<String> readRowForHeaderDetection() override { return readHeaderRow(); }
 
+    bool checkForSuffix() override;
 
     template <bool is_header>
     std::vector<String> readRowImpl();
diff --git a/src/Processors/Formats/Impl/CustomSeparatedRowInputFormat.cpp b/src/Processors/Formats/Impl/CustomSeparatedRowInputFormat.cpp
index 1c2efe3a41d..1e67db79a2c 100644
--- a/src/Processors/Formats/Impl/CustomSeparatedRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CustomSeparatedRowInputFormat.cpp
@@ -283,6 +283,8 @@ bool CustomSeparatedFormatReader::checkForSuffixImpl(bool check_eof)
 
         /// Allow optional \n before eof.
         checkChar('\n', *buf);
+        if (format_settings.custom.skip_trailing_empty_lines)
+            while (checkChar('\n', *buf) || checkChar('\r', *buf));
         return buf->eof();
     }
 
@@ -294,6 +296,8 @@ bool CustomSeparatedFormatReader::checkForSuffixImpl(bool check_eof)
 
         /// Allow optional \n before eof.
         checkChar('\n', *buf);
+        if (format_settings.custom.skip_trailing_empty_lines)
+            while (checkChar('\n', *buf) || checkChar('\r', *buf));
         if (buf->eof())
             return true;
     }
diff --git a/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.cpp b/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.cpp
index af5f1f90732..2239c8539e3 100644
--- a/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.cpp
@@ -286,6 +286,20 @@ void TabSeparatedFormatReader::setReadBuffer(ReadBuffer & in_)
     FormatWithNamesAndTypesReader::setReadBuffer(*buf);
 }
 
+bool TabSeparatedFormatReader::checkForSuffix()
+{
+    if (!format_settings.tsv.skip_trailing_empty_lines)
+        return buf->eof();
+
+    PeekableReadBufferCheckpoint checkpoint(*buf);
+    while (checkChar('\n', *buf) || checkChar('\r', *buf));
+    if (buf->eof())
+        return true;
+
+    buf->rollbackToCheckpoint();
+    return false;
+}
+
 TabSeparatedSchemaReader::TabSeparatedSchemaReader(
     ReadBuffer & in_, bool with_names_, bool with_types_, bool is_raw_, const FormatSettings & format_settings_)
     : FormatWithNamesAndTypesSchemaReader(
diff --git a/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.h b/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.h
index 0f4bff8d7d0..8df57675cf5 100644
--- a/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.h
+++ b/src/Processors/Formats/Impl/TabSeparatedRowInputFormat.h
@@ -75,6 +75,8 @@ public:
 
     void setReadBuffer(ReadBuffer & in_) override;
 
+    bool checkForSuffix() override;
+
 private:
     template <bool is_header>
     std::vector<String> readRowImpl();
diff --git a/tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.reference b/tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.reference
new file mode 100644
index 00000000000..37e32ce62ee
--- /dev/null
+++ b/tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.reference
@@ -0,0 +1,3 @@
+1	2
+1	2
+1	2
diff --git a/tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.sql b/tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.sql
new file mode 100644
index 00000000000..917a434cd58
--- /dev/null
+++ b/tests/queries/0_stateless/02771_tsv_csv_custom_skip_trailing_empty_lines.sql
@@ -0,0 +1,12 @@
+select * from format(TSV, 'x UInt32, y UInt32', '1\t2\n\n') settings input_format_tsv_skip_trailing_empty_lines=0; -- {serverError CANNOT_PARSE_INPUT_ASSERTION_FAILED}
+select * from format(TSV, 'x UInt32, y UInt32', '1\t2\n\n') settings input_format_tsv_skip_trailing_empty_lines=1;
+select * from format(TSV, 'x UInt32, y UInt32', '1\t2\n\n1\t2\n') settings input_format_tsv_skip_trailing_empty_lines=1; -- {serverError CANNOT_PARSE_INPUT_ASSERTION_FAILED}
+
+select * from format(CSV, 'x UInt32, y UInt32', '1,2\n\n') settings input_format_csv_skip_trailing_empty_lines=0; -- {serverError CANNOT_PARSE_INPUT_ASSERTION_FAILED}
+select * from format(CSV, 'x UInt32, y UInt32', '1,2\n\n') settings input_format_csv_skip_trailing_empty_lines=1;
+select * from format(CSV, 'x UInt32, y UInt32', '1,2\n\n1,2\n') settings input_format_csv_skip_trailing_empty_lines=1; -- {serverError CANNOT_PARSE_INPUT_ASSERTION_FAILED}
+
+select * from format(CustomSeparated, 'x UInt32, y UInt32', '1\t2\n\n\n') settings input_format_custom_skip_trailing_empty_lines=0; -- {serverError CANNOT_PARSE_INPUT_ASSERTION_FAILED}
+select * from format(CustomSeparated, 'x UInt32, y UInt32', '1\t2\n\n\n') settings input_format_custom_skip_trailing_empty_lines=1;
+select * from format(CustomSeparated, 'x UInt32, y UInt32', '1\t2\n\n\n1\t2\n\n\n') settings input_format_custom_skip_trailing_empty_lines=1; -- {serverError CANNOT_PARSE_INPUT_ASSERTION_FAILED}
+

From 23a30268369c3166965d34815fd963db33740a64 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 7 Jun 2023 03:16:29 +0000
Subject: [PATCH 226/722] Implemented connection string

---
 docs/en/interfaces/cli.md                     | 110 +++++++++
 docs/ru/interfaces/cli.md                     | 110 +++++++++
 programs/client/Client.cpp                    |  13 +-
 src/Client/ConnectionString.cpp               | 219 ++++++++++++++++++
 src/Client/ConnectionString.h                 |  22 ++
 .../02784_connection_string.reference         | 125 ++++++++++
 .../0_stateless/02784_connection_string.sh    | 156 +++++++++++++
 7 files changed, 753 insertions(+), 2 deletions(-)
 create mode 100644 src/Client/ConnectionString.cpp
 create mode 100644 src/Client/ConnectionString.h
 create mode 100644 tests/queries/0_stateless/02784_connection_string.reference
 create mode 100755 tests/queries/0_stateless/02784_connection_string.sh

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index f670d464006..5255657ddfd 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -158,6 +158,116 @@ $ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" -q "SELECT * FROM
 $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --query "SELECT {col:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"
 ```
 
+## Connection string {#connection_string}
+
+The connection string for clickhouse-client is presented in URI format:
+
+```text
+clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
+```
+
+where user_info is: ```user[:password]```
+and hosts_and_ports is a list of values: ```[host][:port],[host][:port]``` Port is not mandatory.
+and query_parameters is a list of parameter[=value]: ```param_name[=value]&param_name[=value]...``` value may not be required for some of parameters.
+
+Allowed query_parameters keys:
+
+- **secure** or shorthanded **s** - no value. If specified, client will connect to the server over a secure connection (TLS). See **secure** in [command-line-options](#command-line-options)
+
+These examples illustrate valid connection strings for clickhouse-client:
+
+```text
+clickhouse:
+clickhouse://localhost
+clickhouse://localhost:9000
+clickhouse://localhost/default
+clickhouse://default@localhost
+clickhouse://user:password@localhost
+clickhouse://user_name@localhost/some_database?secure
+clickhouse://host1:9000,host2:5000/some_database
+```
+
+The host component can either be an IP address or a host name. Put an IPv6 address in square brackets to specify it:
+
+```text
+clickhouse://[2001:db8::1234]
+```
+
+If user or/and password are not specified, default values will be used.
+If host is not specified, the default host will be used (localhost).
+If port is not specified, the default port will be used (9000).
+If database is not specified, the default database will be used.
+
+User, password, and database can be specified in the connection string either in --user command line option.
+
+The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except **--host(h)** and **--port**.
+
+### Multiple hosts {#connection_string_multiple_hosts}
+
+URI allows multiple hosts to be connected to, and the client will try to connect to those hosts using the order from URI and command line options. The hosts and ports in the URI accept comma-separated lists of values.
+
+If more than one host is supplied, or if a single host name is translated to more than one address, each host and address will be attempted one at a time until one is successful. The remaining hosts after successful connection in the list are not tried.
+
+### Percent encoding {#connection_string_uri_percent_encoding}
+
+Hosts, user name, password, database and query parameters should be [Percent-Encoded](https://en.wikipedia.org/wiki/URL_encoding) if values contain URI invalid characters.
+
+### Examples {#connection_string_examples}
+
+Connect to localhost using port 9000 and executes the query "SELECT 1".
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" --query "SELECT 1"
+```
+
+Connect to localhost using port 9000 in interactive, multiline mode.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" -m
+```
+
+Connect to localhost using port 9000 in interactive mode with the user specified in --user option.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" --user default
+```
+
+Connect to localhost using port 9000 in interactive mode with database 'my_database' specified in command line option
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" --database my_database
+```
+
+Connect to localhost using port 9000 in interactive mode with the database specified in the connection string.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000/my_database"
+```
+
+Connect to localhost using port 9000 in interactive mode with a database specified in the connection string and a secure connection using shorthanded 's' URI parameter.
+
+```bash
+clickhouse-client "clickhouse://localhost/my_database?s"
+```
+
+Connect to default host using the default port, default user, and default database.
+
+``` bash
+clickhouse-client "clickhouse:"
+```
+
+Connect to the default host using the default port, using user user_name and no password.
+
+``` bash
+clickhouse-client "clickhouse://user_name@"
+```
+
+Connect to localhost using email user name. Symbol '@' is percent encoded to '%40'.
+
+``` bash
+clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"
+```
+
 ## Configuring {#interfaces_cli_configuration}
 
 You can pass parameters to `clickhouse-client` (all parameters have a default value) using:
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index 4c22eae0207..06642800cc6 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -110,6 +110,116 @@ $ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" -q "SELECT * FROM
 $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --query "SELECT {col:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"
 ```
 
+## Строка подключения {#connection_string}
+
+Строка подключения для clickhouse-client представлена в формате URI:
+
+```text
+clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
+```
+
+где user_info - это: ```user[:password]```
+hosts_and_ports - это список значений: ```[host][:port],[host][:port]```. Port может быть не задан.
+query_parameters - это список пар ключ[=значение]: ```param_name[=value]&param_name[=value]...```. Значение может быть пустым
+
+Допустимые ключи query_parameters:
+
+- **secure** или сокращенно **s** - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. **secure** в [command-line-options](#command-line-options).
+
+Эти примеры иллюстрируют допустимые строки подключения для clickhouse-client:
+
+```text
+clickhouse:
+clickhouse://localhost
+clickhouse://localhost:9000
+clickhouse://localhost/default
+clickhouse://default@localhost
+clickhouse://user:password@localhost
+clickhouse://имя_пользователя@localhost/some_database?secure
+clickhouse://host1:9000,host2:5000/some_database
+```
+
+Параметр host может быть либо IP-адресом, либо именем хоста. Для указания IPv6-адреса поместите его в квадратные скобки:
+
+```text
+clickhouse://[2001:db8::1234]
+```
+
+Если пользователь или/и пароль не указаны, будут использоваться значения по умолчанию.
+Если host не указан, будет использован хост по умолчанию (localhost).
+Если port не указан, будет использоваться порт по умолчанию (9000).
+Если база данных не указана, будет использоваться база данных по умолчанию (default).
+
+Пользователь, пароль и база данных могут быть указаны в строке подключения либо в опциях командной строки --user, --password, --database.
+
+Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме **--host(h)** и **--port**.
+
+### Несколько хостов {#connection_string_multiple_hosts}
+
+URI позволяет подключаться к нескольким хостам, и клиент будет пытаться подключиться к этим хостам, используя порядок из URI и опций командной строки. Хосты и порты в URI принимают списки значений, разделенные запятыми.
+
+Если указано более одного хоста или если одно имя хоста транслируется в несколько адресов, Клиент будет будет пытаться подключится к каждому хосту и адресу в порядке в котором они встречаются в URI И опциях клиента, пока не будет установлено соединение. Соединение разрывается, если соединение установлено и аутентификация прошла успешно, остальные хосты в списке игнорируются.
+
+### Кодирование URI {#connection_string_uri_percent_encoding}
+
+Хосты, имя пользователя, пароль, имя базы данных, и параметры запроса должны быть [закодированы](https://ru.wikipedia.org/wiki/URL#%D0%9A%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_URL), если значения содержат невалидные символы URI.
+
+### Примеры {#connection_string_examples}
+
+Подключиться к localhost через порт 9000 и выполнить запрос "SELECT 1"
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" --query "SELECT 1"
+```
+
+Подключиться к localhost через порт 9000 в интерактивном, многострочном режиме.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" -m
+```
+
+Подключиться к localhost через порт 9000 в интерактивном режиме с пользователем default, указанным в опции --user.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" --user default
+```
+
+Подключиться к localhost, используя порт 9000 в интерактивном режиме с базой данных 'my_database', указанной в опции командной строки.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000" --database my_database
+```
+
+Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных my_database, указанной в строке подключения.
+
+``` bash
+clickhouse-client "clickhouse://localhost:9000/my_database"
+```
+
+Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных, указанной в строке подключения, и безопасным соединением с использованием сокращенного параметра URI 's'.
+
+``` bash
+clickhouse-client "clickhouse://localhost/my_database?s"
+```
+
+Подключиться к хосту по умолчанию с использованием порта по умолчанию, пользователя по умолчанию, и базы данных по умолчанию.
+
+``` bash
+clickhouse-client "clickhouse:"
+```
+
+Подключиться к хосту по умолчанию через порт по умолчанию, используя имя пользователя user_name без пароля.
+
+``` bash
+clickhouse-client "clickhouse://user_name@"
+```
+
+Подключиться к localhost, используя электронную почту, как имя пользователя. Символ '@' закодирован как '%40'.
+
+``` bash
+clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"
+```
+
 ## Конфигурирование {#interfaces_cli_configuration}
 
 В `clickhouse-client` можно передавать различные параметры (все параметры имеют значения по умолчанию) с помощью:
diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 32a07284d26..e513314387f 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -5,13 +5,13 @@
 #include <iostream>
 #include <iomanip>
 #include <optional>
-#include <string_view>
 #include <Common/scope_guard_safe.h>
 #include <boost/program_options.hpp>
 #include <boost/algorithm/string/replace.hpp>
 #include <filesystem>
 #include <string>
 #include "Client.h"
+#include "Client/ConnectionString.h"
 #include "Core/Protocol.h"
 #include "Parsers/formatAST.h"
 
@@ -1248,6 +1248,9 @@ void Client::readArguments(
     std::vector<Arguments> & external_tables_arguments,
     std::vector<Arguments> & hosts_and_ports_arguments)
 {
+    bool has_connection_string = argc >= 2 && tryParseConnectionString(std::string_view(argv[1]), common_arguments, hosts_and_ports_arguments);
+    int start_argument_index = has_connection_string ? 2 : 1;
+
     /** We allow different groups of arguments:
         * - common arguments;
         * - arguments for any number of external tables each in form "--external args...",
@@ -1260,7 +1263,7 @@ void Client::readArguments(
     std::string prev_host_arg;
     std::string prev_port_arg;
 
-    for (int arg_num = 1; arg_num < argc; ++arg_num)
+    for (int arg_num = start_argument_index; arg_num < argc; ++arg_num)
     {
         std::string_view arg = argv[arg_num];
 
@@ -1322,6 +1325,9 @@ void Client::readArguments(
             }
             else if (arg.starts_with("--host") || arg.starts_with("-h"))
             {
+                if (has_connection_string)
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing connection string and --host/--port client arguments is prohibited");
+
                 std::string host_arg;
                 /// --host host
                 if (arg == "--host" || arg == "-h")
@@ -1353,6 +1359,9 @@ void Client::readArguments(
             }
             else if (arg.starts_with("--port"))
             {
+                if (has_connection_string)
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing connection string and --host/--port client arguments is prohibited");
+
                 auto port_arg = String{arg};
                 /// --port port
                 if (arg == "--port")
diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
new file mode 100644
index 00000000000..a8b87726a65
--- /dev/null
+++ b/src/Client/ConnectionString.cpp
@@ -0,0 +1,219 @@
+#include "ConnectionString.h"
+
+#include <Common/Exception.h>
+#include <Poco/Exception.h>
+#include <Poco/URI.h>
+
+#include <array>
+#include <iostream>
+#include <string>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int BAD_ARGUMENTS;
+}
+
+}
+
+namespace
+{
+
+using namespace std::string_literals;
+using namespace std::literals::string_view_literals;
+
+constexpr auto CONNECTION_URI_SCHEME = "clickhouse:"sv;
+
+void uriDecode(std::string & uri_encoded_string, bool plus_as_space)
+{
+    std::string temp;
+    Poco::URI::decode(uri_encoded_string, temp, plus_as_space);
+    std::swap(temp, uri_encoded_string);
+}
+
+void getHostAndPort(const Poco::URI & uri, std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
+{
+    auto host = uri.getHost();
+    std::vector<std::string> host_and_port;
+    if (!host.empty())
+    {
+        uriDecode(host, false);
+        host_and_port.push_back("--host="s + host);
+    }
+
+    // Port can be written without host (":9000"). Empty host name equals to default host.
+    auto port = uri.getPort();
+    if (port != 0)
+        host_and_port.push_back("--port="s + std::to_string(port));
+
+    if (!host_and_port.empty())
+        hosts_and_ports_arguments.push_back(std::move(host_and_port));
+}
+
+void getHostAndPort(
+    Poco::URI & uri,
+    std::vector<std::vector<std::string>> & hosts_and_ports_arguments,
+    const char * host_begin,
+    const char * host_end,
+    const char * right_part_start,
+    const char * connection_string_end)
+{
+    // User info does not matter in sub URI
+    std::string uri_string = {CONNECTION_URI_SCHEME.begin(), CONNECTION_URI_SCHEME.end()};
+    if (host_begin != nullptr && host_begin != host_end)
+    {
+        uri_string.append("//");
+        uri_string.append(host_begin, host_end);
+    }
+
+    // Right part from string includes '/database?[params]'
+    uri_string.append(right_part_start, connection_string_end);
+    try
+    {
+        uri = Poco::URI(uri_string);
+    }
+    catch (const Poco::URISyntaxException & invalid_uri_exception)
+    {
+        throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS,
+                            "Invalid connection string syntax {}: {}", uri_string, invalid_uri_exception.what());
+    }
+
+    getHostAndPort(uri, hosts_and_ports_arguments);
+}
+
+std::string makeArgument(const std::string & connection_string_parameter_name)
+{
+    return (connection_string_parameter_name.size() == 1 ? "-"s : "--"s) + connection_string_parameter_name;
+}
+
+}
+
+namespace DB
+{
+
+bool tryParseConnectionString(
+    std::string_view connection_string,
+    std::vector<std::string> & common_arguments,
+    std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
+{
+    if (!connection_string.starts_with(CONNECTION_URI_SCHEME))
+        return false;
+
+    if (connection_string.size() == CONNECTION_URI_SCHEME.size())
+        return true;
+
+    auto offset = CONNECTION_URI_SCHEME.size();
+    if ((connection_string.substr(offset).starts_with("//")))
+        offset += 2;
+
+    auto hosts_end_pos = std::string_view::npos;
+    auto hosts_or_user_info_end_pos = connection_string.find_first_of("?/@", offset);
+
+    auto has_user_info = hosts_or_user_info_end_pos != std::string_view::npos && connection_string[hosts_or_user_info_end_pos] == '@';
+    if (has_user_info)
+    {
+        // Move offset right after user info
+        offset = hosts_or_user_info_end_pos + 1;
+        hosts_end_pos = connection_string.find_first_of("?/@", offset);
+        // Several '@' symbols in connection string is prohibited.
+        // If user name contains '@' then it should be percent-encoded.
+        // several users: 'usr1@host1,@usr2@host2' is invalid.
+        if (hosts_end_pos != std::string_view::npos && connection_string[hosts_end_pos] == '@')
+        {
+            throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                            "Symbols '@' in URI in password or user name should be percent-encoded. Individual user names for different hosts also prohibited. {}",
+                            connection_string);
+        }
+    }
+    else
+        hosts_end_pos = hosts_or_user_info_end_pos;
+
+    auto hosts_end = hosts_end_pos != std::string_view::npos ? connection_string.begin() + hosts_end_pos
+                                                             : connection_string.end();
+
+    try
+    {
+        // Poco::URI doesn't support several hosts in URI.
+        // Split string clickhouse:[user_info]host1:port1, ... , hostN:portN[database]?[query_parameters]
+        // into multiple string for each host:
+        // clickhouse:[user_info]host1:port1[database]?[query_parameters]
+        // ...
+        // clickhouse:[user_info]hostN:portN[database]?[query_parameters]
+        Poco::URI uri;
+        auto last_host_begin = connection_string.begin() + offset;
+        for (auto it = last_host_begin; it != hosts_end; ++it)
+        {
+            if (*it == ',')
+            {
+                getHostAndPort(uri, hosts_and_ports_arguments, last_host_begin, it, hosts_end, connection_string.end());
+                last_host_begin = it + 1;
+            }
+        }
+
+        if (uri.empty())
+        {
+            // URI has no host specified
+            uri = std::string{connection_string.begin(), connection_string.end()};
+            getHostAndPort(uri, hosts_and_ports_arguments);
+        }
+        else
+            getHostAndPort(uri, hosts_and_ports_arguments, last_host_begin, hosts_end, hosts_end, connection_string.end());
+
+        Poco::URI::QueryParameters params = uri.getQueryParameters();
+        for (const auto & param : params)
+        {
+            if (param.first == "secure" || param.first == "s")
+            {
+                if (!param.second.empty())
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "secure URI argument does not require value");
+
+                common_arguments.push_back(makeArgument(param.first));
+            }
+            else
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "URI argument {} is unknown", param.first);
+        }
+
+        auto user_info = uri.getUserInfo();
+        if (!user_info.empty())
+        {
+            // Poco::URI doesn't decode user name/password by default.
+            // But ClickHouse allows to have users with email user name like: 'john@some_mail.com'
+            // john@some_mail.com should be percent-encoded: 'john%40some_mail.com'
+            uriDecode(user_info, true);
+            std::string::size_type pos = user_info.find(':');
+            if (pos != std::string::npos)
+            {
+                common_arguments.push_back("--user");
+                common_arguments.push_back(user_info.substr(0, pos));
+
+                ++pos; // Skip ':'
+                common_arguments.push_back("--password");
+                common_arguments.push_back(user_info.substr(pos));
+            }
+            else
+            {
+                common_arguments.push_back("--user");
+                common_arguments.push_back(user_info);
+            }
+        }
+
+        const auto & database_name = uri.getPath();
+        size_t start_symbol = database_name.size() > 0u && database_name[0] == '/' ? 1u : 0u;
+        if (database_name.size() > start_symbol)
+        {
+            common_arguments.push_back("--database");
+            common_arguments.push_back(start_symbol == 0u ? database_name : database_name.substr(start_symbol));
+        }
+    }
+    catch (const Poco::URISyntaxException & invalid_uri_exception)
+    {
+        throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS,
+                            "Invalid connection string {}: {}", connection_string, invalid_uri_exception.what());
+    }
+
+    return true;
+}
+
+}
diff --git a/src/Client/ConnectionString.h b/src/Client/ConnectionString.h
new file mode 100644
index 00000000000..aafb1139b00
--- /dev/null
+++ b/src/Client/ConnectionString.h
@@ -0,0 +1,22 @@
+#pragma once
+
+#include <string>
+#include <string_view>
+#include <vector>
+
+namespace DB
+{
+/** Tries to parse ClickHouse connection string.
+ * if @connection_string starts with 'clickhouse:' then connection string will be parsed
+ * and converted into a set of arguments for the client.
+ * Connection string format is similar to URI "clickhouse:[//[user_info@][hosts_and_ports]][/dbname][?query_parameters]"
+ * with the difference that hosts_and_ports can contain multiple hosts separated by ','.
+ * example: clickhouse://user@host1:port1,host2:port2
+ * @return returns true if there is a URI, false otherwise.
+ * @exception throws DB::Exception if URI has valid scheme (clickhouse:), but invalid internals.
+*/
+bool tryParseConnectionString(
+    std::string_view connection_string,
+    std::vector<std::string> & common_arguments,
+    std::vector<std::vector<std::string>> & hosts_and_ports_arguments);
+}
diff --git a/tests/queries/0_stateless/02784_connection_string.reference b/tests/queries/0_stateless/02784_connection_string.reference
new file mode 100644
index 00000000000..6a36abae8e0
--- /dev/null
+++ b/tests/queries/0_stateless/02784_connection_string.reference
@@ -0,0 +1,125 @@
+0
+1
+2
+3
+4
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43
+44
+45
+46
+47
+48
+49
+50
+51
+52
+53
+54
+55
+56
+57
+58
+59
+60
+61
+62
+63
+64
+65
+66
+67
+68
+500
+501
+502
+1000
+1001
+1002
+1003
+Bad arguments
+Bad arguments
+Bad arguments
+Bad arguments
+Bad arguments
+Bad arguments
+Bad arguments
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+BAD_ARGUMENTS
+Authentication failed
+Authentication failed
diff --git a/tests/queries/0_stateless/02784_connection_string.sh b/tests/queries/0_stateless/02784_connection_string.sh
new file mode 100755
index 00000000000..fce93fdad74
--- /dev/null
+++ b/tests/queries/0_stateless/02784_connection_string.sh
@@ -0,0 +1,156 @@
+#!/usr/bin/env bash
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+USER_INFOS=('default' '')
+HOSTS_PORTS=("$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP" "$CLICKHOUSE_HOST" "$CLICKHOUSE_HOST:" ":$CLICKHOUSE_PORT_TCP"  "127.0.0.1" "127.0.0.1:$CLICKHOUSE_PORT_TCP" "$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP,invalid_host:9000" "[0000:0000:0000:0000:0000:0000:0000:0001]" "[::1]"  "[::1]:$CLICKHOUSE_PORT_TCP" "" )
+DATABASES=("$CLICKHOUSE_DATABASE" "")
+
+TEST_INDEX=0
+
+function runClient() 
+{
+    $CLICKHOUSE_CLIENT_BINARY "$@" -q "SELECT $TEST_INDEX" --log_comment 02766_connection_string.sh --send_logs_level=warning
+    ((++TEST_INDEX))
+}
+
+function testConnectionString() 
+{
+    if [ "$database" == "" ]; then
+        runClient "clickhouse:$1"
+        runClient "clickhouse:$1/"
+    else
+        runClient "clickhouse:$1/$database"
+    fi
+}
+
+function testConnectionWithUserName() 
+{
+if [ "$user_info" == "" ] && [ "$host_port" == "" ]; then
+        testConnectionString "//"
+        testConnectionString ""
+    else
+        testConnectionString "//$user_info@$host_port"
+    fi
+}
+
+for user_info in "${USER_INFOS[@]}"
+do
+    for host_port in "${HOSTS_PORTS[@]}"
+    do
+        for database in "${DATABASES[@]}"
+        do
+            testConnectionWithUserName
+        done
+    done
+done
+
+# Specific user and password
+TEST_INDEX=500
+TEST_USER_NAME="test_user_02771_$$"
+TEST_USER_EMAIL_NAME="test_user_02771_$$@some_mail.com"
+TEST_USER_EMAIL_NAME_ENCODED="test_user_02771_$$%40some_mail.com"
+
+TEST_USER_PASSWORD="zyx%$&abc" 
+# %, $, & percent encoded
+TEST_USER_PASSWORD_ENCODED="zyx%25%24%26abc" 
+
+$CLICKHOUSE_CLIENT -q "CREATE USER '$TEST_USER_NAME'"
+$CLICKHOUSE_CLIENT -q "CREATE USER '$TEST_USER_EMAIL_NAME' IDENTIFIED WITH plaintext_password BY '$TEST_USER_PASSWORD'"
+
+runClient "clickhouse://$TEST_USER_NAME@$CLICKHOUSE_HOST/$CLICKHOUSE_DATABASE"
+runClient "clickhouse://$TEST_USER_EMAIL_NAME_ENCODED:$TEST_USER_PASSWORD_ENCODED@$CLICKHOUSE_HOST/$CLICKHOUSE_DATABASE"
+
+$CLICKHOUSE_CLIENT -q "DROP USER '$TEST_USER_NAME'"
+$CLICKHOUSE_CLIENT -q "DROP USER '$TEST_USER_EMAIL_NAME'"
+
+# Percent-encoded database in non-ascii symbols 
+UTF8_DATABASE="БазаДанных_$$"
+UTF8_DATABASE_PERCENT_ENCODED="%D0%91%D0%B0%D0%B7%D0%B0%D0%94%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_$$"
+$CLICKHOUSE_CLIENT -q "CREATE DATABASE IF NOT EXISTS \`$UTF8_DATABASE\`"
+runClient "clickhouse://default@$CLICKHOUSE_HOST/$UTF8_DATABASE_PERCENT_ENCODED"
+$CLICKHOUSE_CLIENT -q "DROP DATABASE IF EXISTS \`$UTF8_DATABASE\`"
+
+# clickhouse-client extra options cases 
+TEST_INDEX=1000
+
+runClient "clickhouse://$CLICKHOUSE_HOST/" --user 'default'
+runClient "clickhouse://$CLICKHOUSE_HOST/default" --user 'default'
+runClient "clickhouse:" --database "$CLICKHOUSE_DATABASE"
+
+# User 'default' and default host
+runClient "clickhouse://default@"
+
+# Invalid URI cases
+TEST_INDEX=10000
+runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --user 'default' 2>&1 | grep -o 'Bad arguments'
+runClient "clickhouse://default:pswrd@$CLICKHOUSE_HOST/" --user 'default' 2>&1 | grep -o 'Bad arguments'
+runClient "clickhouse://default:pswrd@$CLICKHOUSE_HOST/" --password 'pswrd' 2>&1 | grep -o 'Bad arguments'
+runClient "clickhouse:///$CLICKHOUSE_DATABASE" --database "$CLICKHOUSE_DATABASE" 2>&1 | grep -o 'Bad arguments'
+runClient "clickhouse://$CLICKHOUSE_HOST/$CLICKHOUSE_DATABASE" --database "$CLICKHOUSE_DATABASE" 2>&1 | grep -o 'Bad arguments'
+runClient "clickhouse://$CLICKHOUSE_HOST/$CLICKHOUSE_DATABASE?s" --database "$CLICKHOUSE_DATABASE" 2>&1 | grep -o 'Bad arguments'
+runClient "clickhouse:/$CLICKHOUSE_DATABASE?s" --database "$CLICKHOUSE_DATABASE" 2>&1 | grep -o 'Bad arguments'
+
+runClient "http://" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "click_house:" 2>&1 | grep -o 'BAD_ARGUMENTS'
+
+TEST_INDEX=1000087
+# Using connection string prohibits to use --host and --port options
+runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --host "$CLICKHOUSE_HOST" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://:@$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:///" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:///?" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://:/?" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:" --database "$CLICKHOUSE_DATABASE" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS' 
+
+# Space is used in connection string (This is prohibited).
+runClient " clickhouse:" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse: " 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://host1 /" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://host1, host2/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://host1 ,host2/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://host1 host2/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://host1/ database:" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://user :password@host1" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://user: password@host1" 2>&1 | grep -o 'BAD_ARGUMENTS'
+
+# Query is not first argument
+runClient --multiline "clickhouse://default:@$CLICKHOUSE_HOST/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+# Query used as the first and the second argument of client
+runClient "clickhouse://default:@$CLICKHOUSE_HOST/" "clickhouse://default:@$CLICKHOUSE_HOST/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+
+# Invalid hosts
+runClient "clickhouse://host1,,," 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://," 2>&1 | grep -o 'BAD_ARGUMENTS'
+
+# Invalid parameters
+runClient "clickhouse:?invalid_parameter" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:?invalid_parameter&secure" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:?s&invalid_parameter" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:?s&invalid_parameter=val" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:?invalid_parameter=arg" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse:?invalid_parameter=arg&s" 2>&1 | grep -o 'BAD_ARGUMENTS'
+# Several users prohibited
+runClient "clickhouse://user1@localhost,default@localhost/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+# Using '@' in user name is prohibited. User name should be percent-encoded.
+runClient "clickhouse://my_mail@email.com@host/" 2>&1 | grep -o 'BAD_ARGUMENTS'
+
+# Wrong input cases 
+TEST_INDEX=100000
+# Invalid user name
+runClient "clickhouse://non_exist_user@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" 2>&1 | grep -o 'Authentication failed'
+# Invalid password
+runClient "clickhouse://default:invalid_password@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" 2>&1 | grep -o 'Authentication failed'

From 17754bf6941aa0754db2bb2de5c7098f890c2898 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 7 Jun 2023 05:59:13 +0000
Subject: [PATCH 227/722] minor changes in documentation

---
 docs/en/interfaces/cli.md | 4 ++--
 docs/ru/interfaces/cli.md | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index 5255657ddfd..94f1fbf9e41 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -168,7 +168,7 @@ clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
 
 where user_info is: ```user[:password]```
 and hosts_and_ports is a list of values: ```[host][:port],[host][:port]``` Port is not mandatory.
-and query_parameters is a list of parameter[=value]: ```param_name[=value]&param_name[=value]...``` value may not be required for some of parameters.
+and query_parameters is a list of parameter[=value]: ```param_name[=value]&param_name[=value]...``` value may not be required for some of parameters. Parameter names are case sensitive.
 
 Allowed query_parameters keys:
 
@@ -198,7 +198,7 @@ If host is not specified, the default host will be used (localhost).
 If port is not specified, the default port will be used (9000).
 If database is not specified, the default database will be used.
 
-User, password, and database can be specified in the connection string either in --user command line option.
+User, password, and database can be specified in the connection string either in --user, --password, --database command line options.
 
 The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except **--host(h)** and **--port**.
 
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index 06642800cc6..30cd9757ebb 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -120,7 +120,8 @@ clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
 
 где user_info - это: ```user[:password]```
 hosts_and_ports - это список значений: ```[host][:port],[host][:port]```. Port может быть не задан.
-query_parameters - это список пар ключ[=значение]: ```param_name[=value]&param_name[=value]...```. Значение может быть пустым
+query_parameters - это список пар ключ[=значение]: ```param_name[=value]&param_name[=value]...```. Значение может быть пустым.
+Имена параметров чувствительны к регистру.
 
 Допустимые ключи query_parameters:
 

From 4a0ccc25d21e9f333057a421bd8009d648df17ae Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 7 Jun 2023 06:15:10 +0000
Subject: [PATCH 228/722] Minor improvement

---
 src/Client/ConnectionString.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index a8b87726a65..7d76deb6238 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -61,7 +61,7 @@ void getHostAndPort(
     const char * connection_string_end)
 {
     // User info does not matter in sub URI
-    std::string uri_string = {CONNECTION_URI_SCHEME.begin(), CONNECTION_URI_SCHEME.end()};
+    auto uri_string = std::string(CONNECTION_URI_SCHEME);
     if (host_begin != nullptr && host_begin != host_end)
     {
         uri_string.append("//");

From aaa4d0367e9d51cd5308a7d5a02fd8333e9e7bb1 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 7 Jun 2023 06:29:14 +0000
Subject: [PATCH 229/722] Minor improvement for connection string

---
 src/Client/ConnectionString.cpp | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index 7d76deb6238..aeb1c1dca02 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -55,21 +55,19 @@ void getHostAndPort(const Poco::URI & uri, std::vector<std::vector<std::string>>
 void getHostAndPort(
     Poco::URI & uri,
     std::vector<std::vector<std::string>> & hosts_and_ports_arguments,
-    const char * host_begin,
-    const char * host_end,
-    const char * right_part_start,
-    const char * connection_string_end)
+    std::string_view host_and_port,
+    std::string_view right_part)
 {
     // User info does not matter in sub URI
     auto uri_string = std::string(CONNECTION_URI_SCHEME);
-    if (host_begin != nullptr && host_begin != host_end)
+    if (!host_and_port.empty())
     {
         uri_string.append("//");
-        uri_string.append(host_begin, host_end);
+        uri_string.append(host_and_port);
     }
 
     // Right part from string includes '/database?[params]'
-    uri_string.append(right_part_start, connection_string_end);
+    uri_string.append(right_part);
     try
     {
         uri = Poco::URI(uri_string);
@@ -147,7 +145,7 @@ bool tryParseConnectionString(
         {
             if (*it == ',')
             {
-                getHostAndPort(uri, hosts_and_ports_arguments, last_host_begin, it, hosts_end, connection_string.end());
+                getHostAndPort(uri, hosts_and_ports_arguments, {last_host_begin, it}, {hosts_end, connection_string.end()});
                 last_host_begin = it + 1;
             }
         }
@@ -159,7 +157,7 @@ bool tryParseConnectionString(
             getHostAndPort(uri, hosts_and_ports_arguments);
         }
         else
-            getHostAndPort(uri, hosts_and_ports_arguments, last_host_begin, hosts_end, hosts_end, connection_string.end());
+            getHostAndPort(uri, hosts_and_ports_arguments, {last_host_begin, hosts_end}, {hosts_end, connection_string.end()});
 
         Poco::URI::QueryParameters params = uri.getQueryParameters();
         for (const auto & param : params)

From db1c03d6db270a4a6b059d4b7f09c5d264f13081 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Fri, 2 Jun 2023 15:54:39 +0000
Subject: [PATCH 230/722] Cleanup moving parts

---
 src/Storages/MergeTree/MergeTreeData.cpp      | 26 +++++++++-----
 src/Storages/MergeTree/MergeTreeData.h        |  1 +
 .../MergeTree/MergeTreePartsMover.cpp         | 36 ++++++++++++++-----
 src/Storages/MergeTree/MergeTreePartsMover.h  | 10 +++++-
 4 files changed, 55 insertions(+), 18 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index e806e1bb93f..047f063cb7c 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1998,8 +1998,18 @@ static bool isOldPartDirectory(const DiskPtr & disk, const String & directory_pa
     return true;
 }
 
-
 size_t MergeTreeData::clearOldTemporaryDirectories(size_t custom_directories_lifetime_seconds, const NameSet & valid_prefixes)
+{
+    size_t cleared_count = 0;
+
+    cleared_count += clearOldTemporaryDirectories(relative_data_path, custom_directories_lifetime_seconds, valid_prefixes);
+
+    /// Clear _all_ parts from the `moving` directory
+    cleared_count += clearOldTemporaryDirectories(fs::path(relative_data_path) / "moving", custom_directories_lifetime_seconds, {""});
+    return cleared_count;
+}
+
+size_t MergeTreeData::clearOldTemporaryDirectories(const String & root_path, size_t custom_directories_lifetime_seconds, const NameSet & valid_prefixes)
 {
     /// If the method is already called from another thread, then we don't need to do anything.
     std::unique_lock lock(clear_old_temporary_directories_mutex, std::defer_lock);
@@ -2018,7 +2028,7 @@ size_t MergeTreeData::clearOldTemporaryDirectories(size_t custom_directories_lif
         if (disk->isBroken())
             continue;
 
-        for (auto it = disk->iterateDirectory(relative_data_path); it->isValid(); it->next())
+        for (auto it = disk->iterateDirectory(root_path); it->isValid(); it->next())
         {
             const std::string & basename = it->name();
             bool start_with_valid_prefix = false;
@@ -7802,7 +7812,7 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
     for (const auto & moving_part : moving_tagger->parts_to_move)
     {
         Stopwatch stopwatch;
-        MutableDataPartPtr cloned_part;
+        MergeTreePartsMover::TemporaryClonedPart cloned_part;
         ProfileEventsScope profile_events_scope;
 
         auto write_part_log = [&](const ExecutionStatus & execution_status)
@@ -7812,7 +7822,7 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
                 execution_status,
                 stopwatch.elapsed(),
                 moving_part.part->name,
-                cloned_part,
+                cloned_part.part,
                 {moving_part.part},
                 nullptr,
                 profile_events_scope.getSnapshot());
@@ -7854,7 +7864,7 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
                         if (lock->isLocked())
                         {
                             cloned_part = parts_mover.clonePart(moving_part);
-                            parts_mover.swapClonedPart(cloned_part);
+                            parts_mover.swapClonedPart(cloned_part.part);
                             break;
                         }
                         else if (wait_for_move_if_zero_copy)
@@ -7881,15 +7891,15 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
             else /// Ordinary move as it should be
             {
                 cloned_part = parts_mover.clonePart(moving_part);
-                parts_mover.swapClonedPart(cloned_part);
+                parts_mover.swapClonedPart(cloned_part.part);
             }
             write_part_log({});
         }
         catch (...)
         {
             write_part_log(ExecutionStatus::fromCurrentException("", true));
-            if (cloned_part)
-                cloned_part->remove();
+            if (cloned_part.part)
+                cloned_part.part->remove();
 
             throw;
         }
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index 2f254f9a787..444bd8f47ac 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -676,6 +676,7 @@ public:
     /// Delete all directories which names begin with "tmp"
     /// Must be called with locked lockForShare() because it's using relative_data_path.
     size_t clearOldTemporaryDirectories(size_t custom_directories_lifetime_seconds, const NameSet & valid_prefixes = {"tmp_", "tmp-fetch_"});
+    size_t clearOldTemporaryDirectories(const String & root_path, size_t custom_directories_lifetime_seconds, const NameSet & valid_prefixes);
 
     size_t clearEmptyParts();
 
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.cpp b/src/Storages/MergeTree/MergeTreePartsMover.cpp
index e1da57744b3..08815fa1f0c 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.cpp
+++ b/src/Storages/MergeTree/MergeTreePartsMover.cpp
@@ -11,6 +11,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int ABORTED;
+    extern const int DIRECTORY_ALREADY_EXISTS;
 }
 
 namespace
@@ -203,7 +204,7 @@ bool MergeTreePartsMover::selectPartsForMove(
         return false;
 }
 
-MergeTreeMutableDataPartPtr MergeTreePartsMover::clonePart(const MergeTreeMoveEntry & moving_part) const
+MergeTreePartsMover::TemporaryClonedPart MergeTreePartsMover::clonePart(const MergeTreeMoveEntry & moving_part) const
 {
     if (moves_blocker.isCancelled())
         throw Exception(ErrorCodes::ABORTED, "Cancelled moving parts.");
@@ -222,8 +223,10 @@ MergeTreeMutableDataPartPtr MergeTreePartsMover::clonePart(const MergeTreeMoveEn
         String relative_path = part->getDataPartStorage().getPartDirectory();
         if (disk->exists(path_to_clone + relative_path))
         {
-            LOG_WARNING(log, "Path {} already exists. Will remove it and clone again.", fullPath(disk, path_to_clone + relative_path));
-            disk->removeRecursive(fs::path(path_to_clone) / relative_path / "");
+            throw Exception(ErrorCodes::DIRECTORY_ALREADY_EXISTS,
+                "Cannot clone part {} from '{}' to '{}': path '{}' already exists",
+                part->name, part->getDataPartStorage().getDiskName(), disk->getName(),
+                fullPath(disk, path_to_clone + relative_path));
         }
 
         disk->createDirectories(path_to_clone);
@@ -240,14 +243,22 @@ MergeTreeMutableDataPartPtr MergeTreePartsMover::clonePart(const MergeTreeMoveEn
     {
         cloned_part_storage = part->makeCloneOnDisk(disk, MergeTreeData::MOVING_DIR_NAME);
     }
+    String data_part_directory = cloned_part_storage->getFullPath();
+
+    TemporaryClonedPart cloned_part;
+    cloned_part.temporary_directory_lock = data->getTemporaryPartDirectoryHolder(data_part_directory);
 
     MergeTreeDataPartBuilder builder(*data, part->name, cloned_part_storage);
-    auto cloned_part = std::move(builder).withPartFormatFromDisk().build();
-    LOG_TRACE(log, "Part {} was cloned to {}", part->name, cloned_part->getDataPartStorage().getFullPath());
+    cloned_part.part = std::move(builder).withPartFormatFromDisk().build();
 
-    cloned_part->loadColumnsChecksumsIndexes(true, true);
-    cloned_part->loadVersionMetadata();
-    cloned_part->modification_time = cloned_part->getDataPartStorage().getLastModified().epochTime();
+    String part_directory = cloned_part.part->getDataPartStorage().getFullPath();
+
+    LOG_TRACE(log, "Part {} was cloned to {}", part->name, data_part_directory);
+
+    cloned_part.part->loadColumnsChecksumsIndexes(true, true);
+    cloned_part.part->loadVersionMetadata();
+    cloned_part.part->modification_time = cloned_part.part->getDataPartStorage().getLastModified().epochTime();
+    cloned_part.part->is_temp = true;
     return cloned_part;
 }
 
@@ -262,10 +273,17 @@ void MergeTreePartsMover::swapClonedPart(const MergeTreeMutableDataPartPtr & clo
     /// It's ok, because we don't block moving parts for merges or mutations
     if (!active_part || active_part->name != cloned_part->name)
     {
-        LOG_INFO(log, "Failed to swap {}. Active part doesn't exist. Possible it was merged or mutated. Will remove copy on path '{}'.", cloned_part->name, cloned_part->getDataPartStorage().getFullPath());
+        LOG_INFO(log,
+            "Failed to swap {}. Active part doesn't exist (containing part {}). "
+            "Possible it was merged or mutated. Will remove copy on path '{}'",
+            cloned_part->name,
+            active_part ? active_part->name : "doesn't exist",
+            cloned_part->getDataPartStorage().getFullPath());
         return;
     }
 
+    cloned_part->is_temp = false;
+
     /// Don't remove new directory but throw an error because it may contain part which is currently in use.
     cloned_part->renameTo(active_part->name, false);
 
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.h b/src/Storages/MergeTree/MergeTreePartsMover.h
index 1cee98bcba9..dde2ff1a630 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.h
+++ b/src/Storages/MergeTree/MergeTreePartsMover.h
@@ -3,6 +3,7 @@
 #include <functional>
 #include <optional>
 #include <vector>
+#include <base/scope_guard.h>
 #include <Disks/StoragePolicy.h>
 #include <Storages/MergeTree/IMergeTreeDataPart.h>
 #include <Storages/MergeTree/MovesList.h>
@@ -43,12 +44,19 @@ private:
     using AllowedMovingPredicate = std::function<bool(const std::shared_ptr<const IMergeTreeDataPart> &, String * reason)>;
 
 public:
+
     explicit MergeTreePartsMover(MergeTreeData * data_)
         : data(data_)
         , log(&Poco::Logger::get("MergeTreePartsMover"))
     {
     }
 
+    struct TemporaryClonedPart
+    {
+        MergeTreeMutableDataPartPtr part;
+        scope_guard temporary_directory_lock;
+    };
+
     /// Select parts for background moves according to storage_policy configuration.
     /// Returns true if at least one part was selected for move.
     bool selectPartsForMove(
@@ -57,7 +65,7 @@ public:
         const std::lock_guard<std::mutex> & moving_parts_lock);
 
     /// Copies part to selected reservation in detached folder. Throws exception if part already exists.
-    MergeTreeMutableDataPartPtr clonePart(const MergeTreeMoveEntry & moving_part) const;
+    TemporaryClonedPart clonePart(const MergeTreeMoveEntry & moving_part) const;
 
     /// Replaces cloned part from detached directory into active data parts set.
     /// Replacing part changes state to DeleteOnDestroy and will be removed from disk after destructor of

From 19bb802b04cb9c31585b24f6ebe4765f0dc46c87 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Fri, 2 Jun 2023 17:41:16 +0000
Subject: [PATCH 231/722] Set temporary_directories_lifetime to integration
 tests with MOVE

---
 .../test_consistant_parts_after_move_partition/test.py        | 2 +-
 tests/integration/test_encrypted_disk/test.py                 | 2 +-
 tests/integration/test_merge_tree_azure_blob_storage/test.py  | 1 +
 tests/integration/test_merge_tree_hdfs/test.py                | 3 ++-
 tests/integration/test_merge_tree_s3/test.py                  | 1 +
 .../test_move_partition_to_disk_on_cluster/test.py            | 2 +-
 .../configs/config.d/storage_configuration.xml                | 4 ++++
 .../configs/config.d/storage_configuration.xml                | 3 ++-
 .../test_replicated_merge_tree_hdfs_zero_copy/test.py         | 2 +-
 tests/integration/test_s3_zero_copy_replication/test.py       | 2 +-
 tests/integration/test_ttl_move/test.py                       | 2 +-
 tests/integration/test_zero_copy_fetch/test.py                | 2 +-
 12 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/tests/integration/test_consistant_parts_after_move_partition/test.py b/tests/integration/test_consistant_parts_after_move_partition/test.py
index 63a51472773..0b19e194e0e 100644
--- a/tests/integration/test_consistant_parts_after_move_partition/test.py
+++ b/tests/integration/test_consistant_parts_after_move_partition/test.py
@@ -18,7 +18,7 @@ def initialize_database(nodes, shard):
             CREATE TABLE `{database}`.dest (p UInt64, d UInt64)
             ENGINE = ReplicatedMergeTree('/clickhouse/{database}/tables/test_consistent_shard2{shard}/replicated', '{replica}')
             ORDER BY d PARTITION BY p
-            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0;
+            SETTINGS min_replicated_logs_to_keep=3, max_replicated_logs_to_keep=5, cleanup_delay_period=0, cleanup_delay_period_random_add=0, temporary_directories_lifetime=1;
         """.format(
                 shard=shard, replica=node.name, database=CLICKHOUSE_DATABASE
             )
diff --git a/tests/integration/test_encrypted_disk/test.py b/tests/integration/test_encrypted_disk/test.py
index 9f5415f4bea..fbf2b59785b 100644
--- a/tests/integration/test_encrypted_disk/test.py
+++ b/tests/integration/test_encrypted_disk/test.py
@@ -96,7 +96,7 @@ def test_part_move(policy, destination_disks):
             data String
         ) ENGINE=MergeTree()
         ORDER BY id
-        SETTINGS storage_policy='{}'
+        SETTINGS storage_policy='{}', temporary_directories_lifetime=1
         """.format(
             policy
         )
diff --git a/tests/integration/test_merge_tree_azure_blob_storage/test.py b/tests/integration/test_merge_tree_azure_blob_storage/test.py
index 8bf4df17c39..761b5257a34 100644
--- a/tests/integration/test_merge_tree_azure_blob_storage/test.py
+++ b/tests/integration/test_merge_tree_azure_blob_storage/test.py
@@ -66,6 +66,7 @@ def create_table(node, table_name, **additional_settings):
         "storage_policy": "blob_storage_policy",
         "old_parts_lifetime": 1,
         "index_granularity": 512,
+        "temporary_directories_lifetime": 1,
     }
     settings.update(additional_settings)
 
diff --git a/tests/integration/test_merge_tree_hdfs/test.py b/tests/integration/test_merge_tree_hdfs/test.py
index c79986c34f0..d1a145c00c1 100644
--- a/tests/integration/test_merge_tree_hdfs/test.py
+++ b/tests/integration/test_merge_tree_hdfs/test.py
@@ -29,7 +29,8 @@ def create_table(cluster, table_name, additional_settings=None):
         SETTINGS
             storage_policy='hdfs',
             old_parts_lifetime=0,
-            index_granularity=512
+            index_granularity=512,
+            temporary_directories_lifetime=1
         """.format(
         table_name
     )
diff --git a/tests/integration/test_merge_tree_s3/test.py b/tests/integration/test_merge_tree_s3/test.py
index 2ccd517923a..3ab31f4728b 100644
--- a/tests/integration/test_merge_tree_s3/test.py
+++ b/tests/integration/test_merge_tree_s3/test.py
@@ -75,6 +75,7 @@ def create_table(node, table_name, **additional_settings):
         "storage_policy": "s3",
         "old_parts_lifetime": 0,
         "index_granularity": 512,
+        "temporary_directories_lifetime": 1,
     }
     settings.update(additional_settings)
 
diff --git a/tests/integration/test_move_partition_to_disk_on_cluster/test.py b/tests/integration/test_move_partition_to_disk_on_cluster/test.py
index 90753fc8ce3..c639e080cdf 100644
--- a/tests/integration/test_move_partition_to_disk_on_cluster/test.py
+++ b/tests/integration/test_move_partition_to_disk_on_cluster/test.py
@@ -46,7 +46,7 @@ def test_move_partition_to_disk_on_cluster(start_cluster):
             "(x UInt64) "
             "ENGINE=ReplicatedMergeTree('/clickhouse/tables/test_local_table', '{replica}') "
             "ORDER BY tuple()"
-            "SETTINGS storage_policy = 'jbod_with_external';",
+            "SETTINGS storage_policy = 'jbod_with_external', temporary_directories_lifetime=1;",
         )
 
     node1.query("INSERT INTO test_local_table VALUES (0)")
diff --git a/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml b/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml
index ef40bfb0a0e..e7a87fb77b1 100644
--- a/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml
+++ b/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml
@@ -123,4 +123,8 @@
 
 </storage_configuration>
 
+<merge_tree>
+    <temporary_directories_lifetime>1</temporary_directories_lifetime>
+</merge_tree>
+
 </clickhouse>
diff --git a/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml b/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml
index da297e40037..12a598c64b5 100644
--- a/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml
+++ b/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml
@@ -24,9 +24,10 @@
         </default_with_external>
     </policies>
 </storage_configuration>
-    
+
 <merge_tree>
     <min_bytes_for_wide_part>0</min_bytes_for_wide_part>
+    <temporary_directories_lifetime>1</temporary_directories_lifetime>
 </merge_tree>
 
 </clickhouse>
diff --git a/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/test.py b/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/test.py
index bd1c890950a..eb3d62eb718 100644
--- a/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/test.py
+++ b/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/test.py
@@ -128,7 +128,7 @@ def test_hdfs_zero_copy_replication_single_move(cluster, storage_policy, init_ob
             CREATE TABLE single_node_move_test (dt DateTime, id Int64)
             ENGINE=ReplicatedMergeTree('/clickhouse/tables/{cluster}/{shard}/single_node_move_test', '{replica}')
             ORDER BY (dt, id)
-            SETTINGS storage_policy='$policy'
+            SETTINGS storage_policy='$policy',temporary_directories_lifetime=1
             """
             ).substitute(policy=storage_policy)
         )
diff --git a/tests/integration/test_s3_zero_copy_replication/test.py b/tests/integration/test_s3_zero_copy_replication/test.py
index 100f062de2f..bc13c127610 100644
--- a/tests/integration/test_s3_zero_copy_replication/test.py
+++ b/tests/integration/test_s3_zero_copy_replication/test.py
@@ -163,7 +163,7 @@ def test_s3_zero_copy_on_hybrid_storage(started_cluster):
         CREATE TABLE hybrid_test ON CLUSTER test_cluster (id UInt32, value String)
         ENGINE=ReplicatedMergeTree('/clickhouse/tables/hybrid_test', '{}')
         ORDER BY id
-        SETTINGS storage_policy='hybrid'
+        SETTINGS storage_policy='hybrid',temporary_directories_lifetime=1
         """.format(
             "{replica}"
         )
diff --git a/tests/integration/test_ttl_move/test.py b/tests/integration/test_ttl_move/test.py
index 7635d784fef..a2f28e21666 100644
--- a/tests/integration/test_ttl_move/test.py
+++ b/tests/integration/test_ttl_move/test.py
@@ -1549,7 +1549,7 @@ def test_double_move_while_select(started_cluster, name, positive):
             ) ENGINE = MergeTree
             ORDER BY tuple()
             PARTITION BY n
-            SETTINGS storage_policy='small_jbod_with_external'
+            SETTINGS storage_policy='small_jbod_with_external',temporary_directories_lifetime=1
         """.format(
                 name=name
             )
diff --git a/tests/integration/test_zero_copy_fetch/test.py b/tests/integration/test_zero_copy_fetch/test.py
index 9b9aa5e0da7..4f3d42096c3 100644
--- a/tests/integration/test_zero_copy_fetch/test.py
+++ b/tests/integration/test_zero_copy_fetch/test.py
@@ -45,7 +45,7 @@ CREATE TABLE test1 (EventDate Date, CounterID UInt32)
 ENGINE = ReplicatedMergeTree('/clickhouse-tables/test1', 'r1')
 PARTITION BY toMonday(EventDate)
 ORDER BY (CounterID, EventDate)
-SETTINGS index_granularity = 8192, storage_policy = 's3'"""
+SETTINGS index_granularity = 8192, storage_policy = 's3', temporary_directories_lifetime=1"""
     )
 
     node1.query(

From 09fecace434aaeb1c54049f94a855a2843766145 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Fri, 2 Jun 2023 17:43:08 +0000
Subject: [PATCH 232/722] upd

---
 src/Storages/MergeTree/MergeTreeData.cpp       | 3 ---
 src/Storages/MergeTree/MergeTreePartsMover.cpp | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 047f063cb7c..0e542aa3407 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -7898,9 +7898,6 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
         catch (...)
         {
             write_part_log(ExecutionStatus::fromCurrentException("", true));
-            if (cloned_part.part)
-                cloned_part.part->remove();
-
             throw;
         }
     }
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.cpp b/src/Storages/MergeTree/MergeTreePartsMover.cpp
index 08815fa1f0c..2c3b3d1a621 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.cpp
+++ b/src/Storages/MergeTree/MergeTreePartsMover.cpp
@@ -255,10 +255,10 @@ MergeTreePartsMover::TemporaryClonedPart MergeTreePartsMover::clonePart(const Me
 
     LOG_TRACE(log, "Part {} was cloned to {}", part->name, data_part_directory);
 
+    cloned_part.part->is_temp = true;
     cloned_part.part->loadColumnsChecksumsIndexes(true, true);
     cloned_part.part->loadVersionMetadata();
     cloned_part.part->modification_time = cloned_part.part->getDataPartStorage().getLastModified().epochTime();
-    cloned_part.part->is_temp = true;
     return cloned_part;
 }
 

From 80f918d4b77cbad22aeb0371ac2f7881fe603550 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Mon, 5 Jun 2023 18:22:41 +0000
Subject: [PATCH 233/722] Fixes for cleanup moving parts

---
 src/Storages/MergeTree/IMergeTreeDataPart.cpp | 13 ++++++--
 src/Storages/MergeTree/MergeTreeData.cpp      |  4 +--
 .../MergeTree/MergeTreePartsMover.cpp         | 31 +++++++++----------
 src/Storages/MergeTree/MergeTreePartsMover.h  |  2 +-
 4 files changed, 28 insertions(+), 22 deletions(-)

diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index d27b03fff44..9084b5790af 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -492,13 +492,17 @@ void IMergeTreeDataPart::removeIfNeeded()
 
         if (is_temp)
         {
-            String file_name = fileName(getDataPartStorage().getPartDirectory());
+            const auto & part_directory = getDataPartStorage().getPartDirectory();
+
+            String file_name = fileName(part_directory);
 
             if (file_name.empty())
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "relative_path {} of part {} is invalid or not set",
                                 getDataPartStorage().getPartDirectory(), name);
 
-            if (!startsWith(file_name, "tmp") && !endsWith(file_name, ".tmp_proj"))
+            const auto part_parent_directory = directoryPath(part_directory);
+            bool is_moving_part = part_parent_directory.ends_with("moving/");
+            if (!startsWith(file_name, "tmp") && !endsWith(file_name, ".tmp_proj") && !is_moving_part)
             {
                 LOG_ERROR(
                     storage.log,
@@ -507,6 +511,11 @@ void IMergeTreeDataPart::removeIfNeeded()
                     path);
                 return;
             }
+
+            if (is_moving_part)
+            {
+                LOG_TRACE(storage.log, "Removing unneeded moved part from {}", path);
+            }
         }
 
         remove();
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 0e542aa3407..7fe3efaf6d5 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -7864,7 +7864,7 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
                         if (lock->isLocked())
                         {
                             cloned_part = parts_mover.clonePart(moving_part);
-                            parts_mover.swapClonedPart(cloned_part.part);
+                            parts_mover.swapClonedPart(cloned_part);
                             break;
                         }
                         else if (wait_for_move_if_zero_copy)
@@ -7891,7 +7891,7 @@ MovePartsOutcome MergeTreeData::moveParts(const CurrentlyMovingPartsTaggerPtr &
             else /// Ordinary move as it should be
             {
                 cloned_part = parts_mover.clonePart(moving_part);
-                parts_mover.swapClonedPart(cloned_part.part);
+                parts_mover.swapClonedPart(cloned_part);
             }
             write_part_log({});
         }
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.cpp b/src/Storages/MergeTree/MergeTreePartsMover.cpp
index 2c3b3d1a621..656167de986 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.cpp
+++ b/src/Storages/MergeTree/MergeTreePartsMover.cpp
@@ -213,6 +213,8 @@ MergeTreePartsMover::TemporaryClonedPart MergeTreePartsMover::clonePart(const Me
     auto part = moving_part.part;
     auto disk = moving_part.reserved_space->getDisk();
     LOG_DEBUG(log, "Cloning part {} from '{}' to '{}'", part->name, part->getDataPartStorage().getDiskName(), disk->getName());
+    TemporaryClonedPart cloned_part;
+    cloned_part.temporary_directory_lock = data->getTemporaryPartDirectoryHolder(part->name);
 
     MutableDataPartStoragePtr cloned_part_storage;
     if (disk->supportZeroCopyReplication() && settings->allow_remote_fs_zero_copy_replication)
@@ -243,17 +245,10 @@ MergeTreePartsMover::TemporaryClonedPart MergeTreePartsMover::clonePart(const Me
     {
         cloned_part_storage = part->makeCloneOnDisk(disk, MergeTreeData::MOVING_DIR_NAME);
     }
-    String data_part_directory = cloned_part_storage->getFullPath();
-
-    TemporaryClonedPart cloned_part;
-    cloned_part.temporary_directory_lock = data->getTemporaryPartDirectoryHolder(data_part_directory);
 
     MergeTreeDataPartBuilder builder(*data, part->name, cloned_part_storage);
     cloned_part.part = std::move(builder).withPartFormatFromDisk().build();
-
-    String part_directory = cloned_part.part->getDataPartStorage().getFullPath();
-
-    LOG_TRACE(log, "Part {} was cloned to {}", part->name, data_part_directory);
+    LOG_TRACE(log, "Part {} was cloned to {}", part->name, cloned_part.part->getDataPartStorage().getFullPath());
 
     cloned_part.part->is_temp = true;
     cloned_part.part->loadColumnsChecksumsIndexes(true, true);
@@ -263,34 +258,36 @@ MergeTreePartsMover::TemporaryClonedPart MergeTreePartsMover::clonePart(const Me
 }
 
 
-void MergeTreePartsMover::swapClonedPart(const MergeTreeMutableDataPartPtr & cloned_part) const
+void MergeTreePartsMover::swapClonedPart(TemporaryClonedPart & cloned_part) const
 {
     if (moves_blocker.isCancelled())
         throw Exception(ErrorCodes::ABORTED, "Cancelled moving parts.");
 
-    auto active_part = data->getActiveContainingPart(cloned_part->name);
+    auto active_part = data->getActiveContainingPart(cloned_part.part->name);
 
     /// It's ok, because we don't block moving parts for merges or mutations
-    if (!active_part || active_part->name != cloned_part->name)
+    if (!active_part || active_part->name != cloned_part.part->name)
     {
         LOG_INFO(log,
             "Failed to swap {}. Active part doesn't exist (containing part {}). "
             "Possible it was merged or mutated. Will remove copy on path '{}'",
-            cloned_part->name,
+            cloned_part.part->name,
             active_part ? active_part->name : "doesn't exist",
-            cloned_part->getDataPartStorage().getFullPath());
+            cloned_part.part->getDataPartStorage().getFullPath());
         return;
     }
 
-    cloned_part->is_temp = false;
+    cloned_part.part->is_temp = false;
 
     /// Don't remove new directory but throw an error because it may contain part which is currently in use.
-    cloned_part->renameTo(active_part->name, false);
+    cloned_part.part->renameTo(active_part->name, false);
 
     /// TODO what happen if server goes down here?
-    data->swapActivePart(cloned_part);
+    data->swapActivePart(cloned_part.part);
 
-    LOG_TRACE(log, "Part {} was moved to {}", cloned_part->name, cloned_part->getDataPartStorage().getFullPath());
+    LOG_TRACE(log, "Part {} was moved to {}", cloned_part.part->name, cloned_part.part->getDataPartStorage().getFullPath());
+
+    cloned_part.temporary_directory_lock = {};
 }
 
 }
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.h b/src/Storages/MergeTree/MergeTreePartsMover.h
index dde2ff1a630..82fd271ee5f 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.h
+++ b/src/Storages/MergeTree/MergeTreePartsMover.h
@@ -72,7 +72,7 @@ public:
     /// IMergeTreeDataPart called. If replacing part doesn't exists or not active (committed) than
     /// cloned part will be removed and log message will be reported. It may happen in case of concurrent
     /// merge or mutation.
-    void swapClonedPart(const MergeTreeMutableDataPartPtr & cloned_parts) const;
+    void swapClonedPart(TemporaryClonedPart & cloned_part) const;
 
     /// Can stop background moves and moves from queries
     ActionBlocker moves_blocker;

From b410a4d44ce6f1ac1048efb565f87bae0e97c183 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Mon, 5 Jun 2023 18:23:24 +0000
Subject: [PATCH 234/722] Add test test_alter_moving_garbage

---
 .../test_alter_moving_garbage/__init__.py     |  0
 .../configs/config.d/storage_conf.xml         | 26 ++++++
 .../configs/config.xml                        |  7 ++
 .../test_alter_moving_garbage/test.py         | 90 +++++++++++++++++++
 4 files changed, 123 insertions(+)
 create mode 100644 tests/integration/test_alter_moving_garbage/__init__.py
 create mode 100644 tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
 create mode 100644 tests/integration/test_alter_moving_garbage/configs/config.xml
 create mode 100644 tests/integration/test_alter_moving_garbage/test.py

diff --git a/tests/integration/test_alter_moving_garbage/__init__.py b/tests/integration/test_alter_moving_garbage/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml b/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
new file mode 100644
index 00000000000..659f59a41b2
--- /dev/null
+++ b/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
@@ -0,0 +1,26 @@
+<clickhouse>
+    <!-- allow_remote_fs_zero_copy_replication -->
+
+    <storage_configuration>
+        <disks>
+            <s3>
+                <type>s3</type>
+                <endpoint>http://minio1:9001/root/data/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+            </s3>
+        </disks>
+        <policies>
+            <two_disks>
+                <volumes>
+                    <default>
+                        <disk>default</disk>
+                    </default>
+                    <external>
+                        <disk>s3</disk>
+                    </external>
+                </volumes>
+            </two_disks>
+        </policies>
+    </storage_configuration>
+</clickhouse>
diff --git a/tests/integration/test_alter_moving_garbage/configs/config.xml b/tests/integration/test_alter_moving_garbage/configs/config.xml
new file mode 100644
index 00000000000..f4be5ab6b7c
--- /dev/null
+++ b/tests/integration/test_alter_moving_garbage/configs/config.xml
@@ -0,0 +1,7 @@
+<clickhouse>
+    <tcp_port>9000</tcp_port>
+    <listen_host>127.0.0.1</listen_host>
+    <max_concurrent_queries>500</max_concurrent_queries>
+    <path>./clickhouse/</path>
+    <users_config>users.xml</users_config>
+</clickhouse>
diff --git a/tests/integration/test_alter_moving_garbage/test.py b/tests/integration/test_alter_moving_garbage/test.py
new file mode 100644
index 00000000000..b369c9ad377
--- /dev/null
+++ b/tests/integration/test_alter_moving_garbage/test.py
@@ -0,0 +1,90 @@
+import logging
+import time
+
+import pytest
+import threading
+
+from helpers.client import QueryRuntimeException
+from helpers.cluster import ClickHouseCluster
+
+
+@pytest.fixture(scope="module")
+def cluster():
+    try:
+        cluster = ClickHouseCluster(__file__)
+        cluster.add_instance(
+            "node1",
+            main_configs=[
+                "configs/config.d/storage_conf.xml",
+            ],
+            with_minio=True,
+        )
+        logging.info("Starting cluster...")
+        cluster.start()
+        logging.info("Cluster started")
+
+        yield cluster
+    finally:
+        cluster.shutdown()
+
+
+def create_table(node, table_name, **additional_settings):
+    settings = {
+        "storage_policy": "two_disks",
+        "old_parts_lifetime": 1,
+        "index_granularity": 512,
+        "temporary_directories_lifetime": 0,
+        "merge_tree_clear_old_temporary_directories_interval_seconds": 1,
+    }
+    settings.update(additional_settings)
+
+    create_table_statement = f"""
+        CREATE TABLE {table_name} (
+            dt Date,
+            id Int64,
+            data String,
+            INDEX min_max (id) TYPE minmax GRANULARITY 3
+        ) ENGINE=MergeTree()
+        PARTITION BY dt
+        ORDER BY (dt, id)
+        SETTINGS {",".join((k+"="+repr(v) for k, v in settings.items()))}"""
+
+    node.query(create_table_statement)
+
+
+def test_create_table(cluster):
+    node = cluster.instances["node1"]
+    create_table(node, "test_table")
+    node.query(
+        "INSERT INTO test_table SELECT toDate('2021-01-01') + INTERVAL number % 10 DAY, number, toString(sipHash64(number)) FROM numbers(100_000)"
+    )
+
+    stop_alter = False
+
+    def alter():
+        d = 0
+        node.query(f"ALTER TABLE test_table ADD COLUMN col0 String")
+        while not stop_alter:
+            d = d + 1
+            node.query(f"DELETE FROM test_table WHERE id < {d}")
+            time.sleep(0.1)
+
+    alter_thread = threading.Thread(target=alter)
+    alter_thread.start()
+
+    for i in range(1, 10):
+        partition = f"2021-01-{i:02d}"
+        try:
+            node.query(
+                f"ALTER TABLE test_table MOVE PARTITION '{partition}' TO DISK 's3'",
+            )
+        except QueryRuntimeException as e:
+            # PART_IS_TEMPORARILY_LOCKED
+            assert 384 == e.returncode
+            continue
+
+        # clear old temporary directories wakes up every 1 second
+        time.sleep(0.5)
+
+    stop_alter = True
+    alter_thread.join()

From ea1aa4bd9e312a36b578fff3ec3573ff0844d9d5 Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Wed, 7 Jun 2023 16:02:16 +0200
Subject: [PATCH 235/722] update comment

---
 src/Client/Suggest.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Client/Suggest.cpp b/src/Client/Suggest.cpp
index e249aa1bb04..4e38add0ef5 100644
--- a/src/Client/Suggest.cpp
+++ b/src/Client/Suggest.cpp
@@ -101,7 +101,7 @@ static String getLoadSuggestionQuery(Int32 suggestion_limit, bool basic_suggesti
         add_column("name", "columns", true, suggestion_limit);
     }
 
-    /// FIXME: Forbid this query using new analyzer because of bug https://github.com/ClickHouse/ClickHouse/pull/50430#issuecomment-1576860893
+    /// FIXME: Forbid this query using new analyzer because of bug https://github.com/ClickHouse/ClickHouse/issues/50669
     /// We should remove this restriction after resolving this bug.
     query = "SELECT DISTINCT arrayJoin(extractAll(name, '[\\\\w_]{2,}')) AS res FROM (" + query + ") WHERE notEmpty(res) SETTINGS allow_experimental_analyzer=0";
     return query;

From 4fd64a28b20966246743ec6408a3018e8724249e Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Wed, 7 Jun 2023 16:07:18 +0200
Subject: [PATCH 236/722] and add more tests

---
 .../01763_filter_push_down_bugs.reference     | 23 +++++++++++++++----
 .../01763_filter_push_down_bugs.sql           |  6 +++++
 2 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/01763_filter_push_down_bugs.reference b/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
index 7df35e2948d..db9cd7a2d16 100644
--- a/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
+++ b/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
@@ -9,13 +9,11 @@ String1_0	String2_0	String3_0	String4_0	1
 Expression ((Projection + Before ORDER BY))
   Filter (WHERE)
     Join (JOIN FillRightFirst)
-      Filter (( + Before JOIN))
+      Expression (Before JOIN)
         ReadFromMergeTree (default.t1)
         Indexes:
           PrimaryKey
-            Keys: 
-              id
-            Condition: (id in [101, 101])
+            Condition: true
             Parts: 1/1
             Granules: 1/1
       Expression ((Joined actions + (Rename joined columns + (Projection + Before ORDER BY))))
@@ -25,3 +23,20 @@ Expression ((Projection + Before ORDER BY))
             Condition: true
             Parts: 1/1
             Granules: 1/1
+Expression ((Project names + Projection))
+  Filter ((WHERE + DROP unused columns after JOIN))
+    Join (JOIN FillRightFirst)
+      Expression (Change column names to column identifiers)
+        ReadFromMergeTree (default.t1)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 1/1
+      Expression ((Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers))))
+        ReadFromMergeTree (default.t2)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 1/1
diff --git a/tests/queries/0_stateless/01763_filter_push_down_bugs.sql b/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
index 5f7f4379714..9a5ef4727c5 100644
--- a/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
+++ b/tests/queries/0_stateless/01763_filter_push_down_bugs.sql
@@ -58,5 +58,11 @@ EXPLAIN indexes=1 SELECT id, delete_time FROM t1
     FROM t2
 ) AS d WHERE create_time < delete_time AND id = 101 SETTINGS allow_experimental_analyzer=0;
 
+EXPLAIN indexes=1 SELECT id, delete_time FROM t1
+ CROSS JOIN (
+    SELECT delete_time
+    FROM t2
+) AS d WHERE create_time < delete_time AND id = 101 SETTINGS allow_experimental_analyzer=1;
+
 DROP TABLE IF EXISTS t1;
 DROP TABLE IF EXISTS t2;

From 0dd75d7648d3ba12b9593b312ce428e1b12799f8 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Wed, 7 Jun 2023 17:50:20 +0300
Subject: [PATCH 237/722] Add 02783_parseDateTimeBestEffort_syslog test

---
 ...3_parseDateTimeBestEffort_syslog.reference | 20 +++++
 .../02783_parseDateTimeBestEffort_syslog.sql  | 83 +++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
 create mode 100644 tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql

diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
new file mode 100644
index 00000000000..7409b413260
--- /dev/null
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
@@ -0,0 +1,20 @@
+parseDateTimeBestEffort
+ dt_ref                            res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc
+
+ Jun  7 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00 
+ Jun  7 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00 
+parseDateTimeBestEffortUS
+ dt_ref                            res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc
+
+ Jun  7 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00 
+ Jun  7 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00 
+parseDateTime64BestEffort
+ dt_ref                                res                   res_sam                   res_auc                  res_null              res_null_sam              res_null_auc                  res_zero              res_zero_sam              res_zero_auc
+
+ Jun  7 04:55:00   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000 
+ Jun  7 04:56:00   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000 
+parseDateTime64BestEffortUS
+ dt_ref                                res                   res_sam                   res_auc                  res_null              res_null_sam              res_null_auc                  res_zero              res_zero_sam              res_zero_auc
+
+ Jun  7 04:55:00   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000 
+ Jun  7 04:56:00   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000 
diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
new file mode 100644
index 00000000000..91ae230205b
--- /dev/null
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
@@ -0,0 +1,83 @@
+SELECT 'parseDateTimeBestEffort';
+
+WITH
+    now() AS ts_now,
+    '2023-06-07 04:55:30' AS ref_point,
+    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
+    formatDateTime(ts_around, '%b %e %T') AS dt_curr
+SELECT
+    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
+    parseDateTimeBestEffort(dt_curr) - impedimenta AS res,
+    parseDateTimeBestEffort(dt_curr, 'US/Samoa') - impedimenta AS res_sam,
+    parseDateTimeBestEffort(dt_curr, 'Pacific/Auckland') - impedimenta AS res_auc,
+    parseDateTimeBestEffortOrNull(dt_curr) - impedimenta AS res_null,
+    parseDateTimeBestEffortOrNull(dt_curr, 'US/Samoa') - impedimenta AS res_null_sam,
+    parseDateTimeBestEffortOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_null_auc,
+    parseDateTimeBestEffortOrZero(dt_curr) - impedimenta AS res_zero,
+    parseDateTimeBestEffortOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_zero_sam,
+    parseDateTimeBestEffortOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_zero_auc
+FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
+FORMAT PrettySpaceNoEscapes;
+
+SELECT 'parseDateTimeBestEffortUS';
+
+WITH
+    now() AS ts_now,
+    '2023-06-07 04:55:30' AS ref_point,
+    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
+    formatDateTime(ts_around, '%b %e %T') AS dt_curr
+SELECT
+    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
+    parseDateTimeBestEffortUS(dt_curr) - impedimenta AS res,
+    parseDateTimeBestEffortUS(dt_curr, 'US/Samoa') - impedimenta AS res_sam,
+    parseDateTimeBestEffortUS(dt_curr, 'Pacific/Auckland') - impedimenta AS res_auc,
+    parseDateTimeBestEffortUSOrNull(dt_curr) - impedimenta AS res_null,
+    parseDateTimeBestEffortUSOrNull(dt_curr, 'US/Samoa') - impedimenta AS res_null_sam,
+    parseDateTimeBestEffortUSOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_null_auc,
+    parseDateTimeBestEffortUSOrZero(dt_curr) - impedimenta AS res_zero,
+    parseDateTimeBestEffortUSOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_zero_sam,
+    parseDateTimeBestEffortUSOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_zero_auc
+FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
+FORMAT PrettySpaceNoEscapes;
+
+SELECT 'parseDateTime64BestEffort';
+
+WITH
+    now() AS ts_now,
+    '2023-06-07 04:55:30' AS ref_point,
+    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
+    formatDateTime(ts_around, '%b %e %T') AS dt_curr
+SELECT
+    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
+    parseDateTime64BestEffort(dt_curr) - impedimenta AS res,
+    parseDateTime64BestEffort(dt_curr, 3, 'US/Samoa') - impedimenta AS res_sam,
+    parseDateTime64BestEffort(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_auc,
+    parseDateTime64BestEffortOrNull(dt_curr) - impedimenta AS res_null,
+    parseDateTime64BestEffortOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res_null_sam,
+    parseDateTime64BestEffortOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_null_auc,
+    parseDateTime64BestEffortOrZero(dt_curr) - impedimenta AS res_zero,
+    parseDateTime64BestEffortOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res_zero_sam,
+    parseDateTime64BestEffortOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_zero_auc
+FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
+FORMAT PrettySpaceNoEscapes;
+
+SELECT 'parseDateTime64BestEffortUS';
+
+WITH
+    now() AS ts_now,
+    '2023-06-07 04:55:30' AS ref_point,
+    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
+    formatDateTime(ts_around, '%b %e %T') AS dt_curr
+SELECT
+    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
+    parseDateTime64BestEffortUS(dt_curr) - impedimenta AS res,
+    parseDateTime64BestEffortUS(dt_curr, 3, 'US/Samoa') - impedimenta AS res_sam,
+    parseDateTime64BestEffortUS(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_auc,
+    parseDateTime64BestEffortUSOrNull(dt_curr) - impedimenta AS res_null,
+    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res_null_sam,
+    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_null_auc,
+    parseDateTime64BestEffortUSOrZero(dt_curr) - impedimenta AS res_zero,
+    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res_zero_sam,
+    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_zero_auc
+FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
+FORMAT PrettySpaceNoEscapes;

From b567dc2a1dce59d3ced34463601e63326d56aa50 Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Wed, 7 Jun 2023 17:48:06 +0200
Subject: [PATCH 238/722] fix test

---
 .../0_stateless/01763_filter_push_down_bugs.reference  | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/01763_filter_push_down_bugs.reference b/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
index db9cd7a2d16..c8045dd26f5 100644
--- a/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
+++ b/tests/queries/0_stateless/01763_filter_push_down_bugs.reference
@@ -9,11 +9,13 @@ String1_0	String2_0	String3_0	String4_0	1
 Expression ((Projection + Before ORDER BY))
   Filter (WHERE)
     Join (JOIN FillRightFirst)
-      Expression (Before JOIN)
+      Filter (( + Before JOIN))
         ReadFromMergeTree (default.t1)
         Indexes:
           PrimaryKey
-            Condition: true
+            Keys: 
+              id
+            Condition: (id in [101, 101])
             Parts: 1/1
             Granules: 1/1
       Expression ((Joined actions + (Rename joined columns + (Projection + Before ORDER BY))))
@@ -30,7 +32,9 @@ Expression ((Project names + Projection))
         ReadFromMergeTree (default.t1)
         Indexes:
           PrimaryKey
-            Condition: true
+            Keys: 
+              id
+            Condition: (id in [101, 101])
             Parts: 1/1
             Granules: 1/1
       Expression ((Change column names to column identifiers + (Project names + (Projection + Change column names to column identifiers))))

From 2df0e0c66962ce91e47eb4c98bae4fabe1ce9cc1 Mon Sep 17 00:00:00 2001
From: serxa <sergei@clickhouse.com>
Date: Wed, 7 Jun 2023 16:25:52 +0000
Subject: [PATCH 239/722] Unify priorities for connections

---
 src/Client/ConnectionPool.cpp                     |  4 ++--
 src/Client/ConnectionPool.h                       | 13 +++++++------
 src/Client/ConnectionPoolWithFailover.cpp         |  2 +-
 src/Client/ConnectionPoolWithFailover.h           |  2 +-
 src/Common/GetPriorityForLoadBalancing.cpp        | 15 ++++++++-------
 src/Common/GetPriorityForLoadBalancing.h          |  2 +-
 src/Common/PoolWithFailoverBase.h                 |  9 +++++----
 src/Common/ZooKeeper/ZooKeeper.cpp                |  2 +-
 src/Common/ZooKeeper/ZooKeeper.h                  |  2 +-
 src/Databases/DatabaseReplicated.cpp              |  2 +-
 src/Functions/hasColumnInTable.cpp                |  2 +-
 .../tests/gtest_resource_manager_static.cpp       |  4 ++--
 src/Interpreters/Cluster.cpp                      |  2 +-
 src/Interpreters/Cluster.h                        |  5 +++--
 src/Interpreters/ClusterDiscovery.cpp             |  2 +-
 src/TableFunctions/TableFunctionRemote.cpp        |  2 +-
 16 files changed, 37 insertions(+), 33 deletions(-)

diff --git a/src/Client/ConnectionPool.cpp b/src/Client/ConnectionPool.cpp
index 8433b0833fa..5cabb1465d1 100644
--- a/src/Client/ConnectionPool.cpp
+++ b/src/Client/ConnectionPool.cpp
@@ -18,7 +18,7 @@ ConnectionPoolPtr ConnectionPoolFactory::get(
     String client_name,
     Protocol::Compression compression,
     Protocol::Secure secure,
-    Int64 priority)
+    Priority priority)
 {
     Key key{
         max_connections, host, port, default_database, user, password, quota_key, cluster, cluster_secret, client_name, compression, secure, priority};
@@ -74,7 +74,7 @@ size_t ConnectionPoolFactory::KeyHash::operator()(const ConnectionPoolFactory::K
     hash_combine(seed, hash_value(k.client_name));
     hash_combine(seed, hash_value(k.compression));
     hash_combine(seed, hash_value(k.secure));
-    hash_combine(seed, hash_value(k.priority));
+    hash_combine(seed, hash_value(k.priority.value));
     return seed;
 }
 
diff --git a/src/Client/ConnectionPool.h b/src/Client/ConnectionPool.h
index aacd0a063c7..b6d03daacfb 100644
--- a/src/Client/ConnectionPool.h
+++ b/src/Client/ConnectionPool.h
@@ -1,6 +1,7 @@
 #pragma once
 
 #include <Common/PoolBase.h>
+#include <Common/Priority.h>
 #include <Client/Connection.h>
 #include <IO/ConnectionTimeouts.h>
 #include <Core/Settings.h>
@@ -34,7 +35,7 @@ public:
                       const Settings * settings = nullptr,
                       bool force_connected = true) = 0;
 
-    virtual Int64 getPriority() const { return 1; }
+    virtual Priority getPriority() const { return Priority{1}; }
 };
 
 using ConnectionPoolPtr = std::shared_ptr<IConnectionPool>;
@@ -60,7 +61,7 @@ public:
             const String & client_name_,
             Protocol::Compression compression_,
             Protocol::Secure secure_,
-            Int64 priority_ = 1)
+            Priority priority_ = Priority{1})
        : Base(max_connections_,
         &Poco::Logger::get("ConnectionPool (" + host_ + ":" + toString(port_) + ")")),
         host(host_),
@@ -103,7 +104,7 @@ public:
         return host + ":" + toString(port);
     }
 
-    Int64 getPriority() const override
+    Priority getPriority() const override
     {
         return priority;
     }
@@ -134,7 +135,7 @@ private:
     String client_name;
     Protocol::Compression compression; /// Whether to compress data when interacting with the server.
     Protocol::Secure secure;           /// Whether to encrypt data when interacting with the server.
-    Int64 priority;                    /// priority from <remote_servers>
+    Priority priority;                 /// priority from <remote_servers>
 };
 
 /**
@@ -157,7 +158,7 @@ public:
         String client_name;
         Protocol::Compression compression;
         Protocol::Secure secure;
-        Int64 priority;
+        Priority priority;
     };
 
     struct KeyHash
@@ -180,7 +181,7 @@ public:
         String client_name,
         Protocol::Compression compression,
         Protocol::Secure secure,
-        Int64 priority);
+        Priority priority);
 private:
     mutable std::mutex mutex;
     using ConnectionPoolWeakPtr = std::weak_ptr<IConnectionPool>;
diff --git a/src/Client/ConnectionPoolWithFailover.cpp b/src/Client/ConnectionPoolWithFailover.cpp
index 129bc10bc27..feb4c01c374 100644
--- a/src/Client/ConnectionPoolWithFailover.cpp
+++ b/src/Client/ConnectionPoolWithFailover.cpp
@@ -71,7 +71,7 @@ IConnectionPool::Entry ConnectionPoolWithFailover::get(const ConnectionTimeouts
     return Base::get(max_ignored_errors, fallback_to_stale_replicas, try_get_entry, get_priority);
 }
 
-Int64 ConnectionPoolWithFailover::getPriority() const
+Priority ConnectionPoolWithFailover::getPriority() const
 {
     return (*std::max_element(nested_pools.begin(), nested_pools.end(), [](const auto & a, const auto & b)
     {
diff --git a/src/Client/ConnectionPoolWithFailover.h b/src/Client/ConnectionPoolWithFailover.h
index 0273ce41589..75a0dafd977 100644
--- a/src/Client/ConnectionPoolWithFailover.h
+++ b/src/Client/ConnectionPoolWithFailover.h
@@ -48,7 +48,7 @@ public:
               const Settings * settings,
               bool force_connected) override; /// From IConnectionPool
 
-    Int64 getPriority() const override; /// From IConnectionPool
+    Priority getPriority() const override; /// From IConnectionPool
 
     /** Allocates up to the specified number of connections to work.
       * Connections provide access to different replicas of one shard.
diff --git a/src/Common/GetPriorityForLoadBalancing.cpp b/src/Common/GetPriorityForLoadBalancing.cpp
index 5da60fb1bae..c4d36acc70c 100644
--- a/src/Common/GetPriorityForLoadBalancing.cpp
+++ b/src/Common/GetPriorityForLoadBalancing.cpp
@@ -1,4 +1,5 @@
 #include <Common/GetPriorityForLoadBalancing.h>
+#include <Common/Priority.h>
 
 namespace DB
 {
@@ -8,23 +9,23 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-std::function<size_t(size_t index)> GetPriorityForLoadBalancing::getPriorityFunc(LoadBalancing load_balance, size_t offset, size_t pool_size) const
+std::function<Priority(size_t index)> GetPriorityForLoadBalancing::getPriorityFunc(LoadBalancing load_balance, size_t offset, size_t pool_size) const
 {
-    std::function<size_t(size_t index)> get_priority;
+    std::function<Priority(size_t index)> get_priority;
     switch (load_balance)
     {
         case LoadBalancing::NEAREST_HOSTNAME:
             if (hostname_differences.empty())
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "It's a bug: hostname_differences is not initialized");
-            get_priority = [this](size_t i) { return hostname_differences[i]; };
+            get_priority = [this](size_t i) { return Priority{static_cast<Int64>(hostname_differences[i])}; };
             break;
         case LoadBalancing::IN_ORDER:
-            get_priority = [](size_t i) { return i; };
+            get_priority = [](size_t i) { return Priority{static_cast<Int64>(i)}; };
             break;
         case LoadBalancing::RANDOM:
             break;
         case LoadBalancing::FIRST_OR_RANDOM:
-            get_priority = [offset](size_t i) -> size_t { return i != offset; };
+            get_priority = [offset](size_t i) { return i != offset ? Priority{1} : Priority{0}; };
             break;
         case LoadBalancing::ROUND_ROBIN:
             if (last_used >= pool_size)
@@ -38,8 +39,8 @@ std::function<size_t(size_t index)> GetPriorityForLoadBalancing::getPriorityFunc
              * */
             get_priority = [this, pool_size](size_t i)
             {
-                ++i;
-                return i < last_used ? pool_size - i : i - last_used;
+                ++i; // To make `i` indexing start with 1 instead of 0 as `last_used` does
+                return Priority{static_cast<Int64>(i < last_used ? pool_size - i : i - last_used)};
             };
             break;
     }
diff --git a/src/Common/GetPriorityForLoadBalancing.h b/src/Common/GetPriorityForLoadBalancing.h
index e57b02b5e90..8052185ac13 100644
--- a/src/Common/GetPriorityForLoadBalancing.h
+++ b/src/Common/GetPriorityForLoadBalancing.h
@@ -21,7 +21,7 @@ public:
         return !(*this == other);
     }
 
-    std::function<size_t(size_t index)> getPriorityFunc(LoadBalancing load_balance, size_t offset, size_t pool_size) const;
+    std::function<Priority(size_t index)> getPriorityFunc(LoadBalancing load_balance, size_t offset, size_t pool_size) const;
 
     std::vector<size_t> hostname_differences; /// Distances from name of this host to the names of hosts of pools.
 
diff --git a/src/Common/PoolWithFailoverBase.h b/src/Common/PoolWithFailoverBase.h
index 646e10d6443..c6f44a7701a 100644
--- a/src/Common/PoolWithFailoverBase.h
+++ b/src/Common/PoolWithFailoverBase.h
@@ -13,6 +13,7 @@
 #include <Common/NetException.h>
 #include <Common/Exception.h>
 #include <Common/randomSeed.h>
+#include <Common/Priority.h>
 
 
 namespace DB
@@ -34,7 +35,7 @@ namespace ProfileEvents
 /// This class provides a pool with fault tolerance. It is used for pooling of connections to replicated DB.
 /// Initialized by several PoolBase objects.
 /// When a connection is requested, tries to create or choose an alive connection from one of the nested pools.
-/// Pools are tried in the order consistent with lexicographical order of (error count, priority, random number) tuples.
+/// Pools are tried in the order consistent with lexicographical order of (error count, slowdown count, config priority, priority, random number) tuples.
 /// Number of tries for a single pool is limited by max_tries parameter.
 /// The client can set nested pool priority by passing a GetPriority functor.
 ///
@@ -113,7 +114,7 @@ public:
 
     /// The client can provide this functor to affect load balancing - the index of a pool is passed to
     /// this functor. The pools with lower result value will be tried first.
-    using GetPriorityFunc = std::function<size_t(size_t index)>;
+    using GetPriorityFunc = std::function<Priority(size_t index)>;
 
     /// Returns at least min_entries and at most max_entries connections (at most one connection per nested pool).
     /// The method will throw if it is unable to get min_entries alive connections or
@@ -336,9 +337,9 @@ struct PoolWithFailoverBase<TNestedPool>::PoolState
     /// The number of slowdowns that led to changing replica in HedgedRequestsFactory
     UInt64 slowdown_count = 0;
     /// Priority from the <remote_server> configuration.
-    Int64 config_priority = 1;
+    Priority config_priority{1};
     /// Priority from the GetPriorityFunc.
-    Int64 priority = 0;
+    Priority priority{0};
     UInt64 random = 0;
 
     void randomize()
diff --git a/src/Common/ZooKeeper/ZooKeeper.cpp b/src/Common/ZooKeeper/ZooKeeper.cpp
index a587ad6caf4..62807fe2433 100644
--- a/src/Common/ZooKeeper/ZooKeeper.cpp
+++ b/src/Common/ZooKeeper/ZooKeeper.cpp
@@ -179,7 +179,7 @@ ZooKeeper::ZooKeeper(const Poco::Util::AbstractConfiguration & config, const std
 
 std::vector<ShuffleHost> ZooKeeper::shuffleHosts() const
 {
-    std::function<size_t(size_t index)> get_priority = args.get_priority_load_balancing.getPriorityFunc(args.get_priority_load_balancing.load_balancing, 0, args.hosts.size());
+    std::function<Priority(size_t index)> get_priority = args.get_priority_load_balancing.getPriorityFunc(args.get_priority_load_balancing.load_balancing, 0, args.hosts.size());
     std::vector<ShuffleHost> shuffle_hosts;
     for (size_t i = 0; i < args.hosts.size(); ++i)
     {
diff --git a/src/Common/ZooKeeper/ZooKeeper.h b/src/Common/ZooKeeper/ZooKeeper.h
index 96f9914b597..d48ca0a4ef5 100644
--- a/src/Common/ZooKeeper/ZooKeeper.h
+++ b/src/Common/ZooKeeper/ZooKeeper.h
@@ -49,7 +49,7 @@ constexpr size_t MULTI_BATCH_SIZE = 100;
 struct ShuffleHost
 {
     String host;
-    Int64 priority = 0;
+    Priority priority;
     UInt64 random = 0;
 
     void randomize()
diff --git a/src/Databases/DatabaseReplicated.cpp b/src/Databases/DatabaseReplicated.cpp
index 9bbf5b9565d..583607bda1d 100644
--- a/src/Databases/DatabaseReplicated.cpp
+++ b/src/Databases/DatabaseReplicated.cpp
@@ -252,7 +252,7 @@ ClusterPtr DatabaseReplicated::getClusterImpl() const
         treat_local_as_remote,
         treat_local_port_as_remote,
         cluster_auth_info.cluster_secure_connection,
-        /*priority=*/ 1,
+        Priority{1},
         TSA_SUPPRESS_WARNING_FOR_READ(database_name),     /// FIXME
         cluster_auth_info.cluster_secret};
 
diff --git a/src/Functions/hasColumnInTable.cpp b/src/Functions/hasColumnInTable.cpp
index 4676b4083b7..66ed515e490 100644
--- a/src/Functions/hasColumnInTable.cpp
+++ b/src/Functions/hasColumnInTable.cpp
@@ -137,7 +137,7 @@ ColumnPtr FunctionHasColumnInTable::executeImpl(const ColumnsWithTypeAndName & a
             treat_local_as_remote,
             treat_local_port_as_remote,
             /* secure= */ false,
-            /* priority= */ 1,
+            /* priority= */ Priority{1},
             /* cluster_name= */ "",
             /* password= */ ""
         };
diff --git a/src/IO/Resource/tests/gtest_resource_manager_static.cpp b/src/IO/Resource/tests/gtest_resource_manager_static.cpp
index 091f6923714..976eac41a49 100644
--- a/src/IO/Resource/tests/gtest_resource_manager_static.cpp
+++ b/src/IO/Resource/tests/gtest_resource_manager_static.cpp
@@ -44,8 +44,8 @@ TEST(IOResourceStaticResourceManager, Smoke)
 
 TEST(IOResourceStaticResourceManager, Prioritization)
 {
-    std::optional<Int64> last_priority;
-    auto check = [&] (Int64 priority)
+    std::optional<Priority> last_priority;
+    auto check = [&] (Priority priority)
     {
         // Lock is not required here because this is called during request execution and we have max_requests = 1
         if (last_priority)
diff --git a/src/Interpreters/Cluster.cpp b/src/Interpreters/Cluster.cpp
index 8c30dbe230f..edbef77ef02 100644
--- a/src/Interpreters/Cluster.cpp
+++ b/src/Interpreters/Cluster.cpp
@@ -108,7 +108,7 @@ Cluster::Address::Address(
     password = config.getString(config_prefix + ".password", "");
     default_database = config.getString(config_prefix + ".default_database", "");
     secure = ConfigHelper::getBool(config, config_prefix + ".secure", false, /* empty_as */true) ? Protocol::Secure::Enable : Protocol::Secure::Disable;
-    priority = config.getInt(config_prefix + ".priority", 1);
+    priority = Priority{config.getInt(config_prefix + ".priority", 1)};
 
     const char * port_type = secure == Protocol::Secure::Enable ? "tcp_port_secure" : "tcp_port";
     auto default_port = config.getInt(port_type, 0);
diff --git a/src/Interpreters/Cluster.h b/src/Interpreters/Cluster.h
index 4798384f29c..de10a445d01 100644
--- a/src/Interpreters/Cluster.h
+++ b/src/Interpreters/Cluster.h
@@ -4,6 +4,7 @@
 #include <Client/ConnectionPoolWithFailover.h>
 #include <Common/Macros.h>
 #include <Common/MultiVersion.h>
+#include <Common/Priority.h>
 
 #include <Poco/Net/SocketAddress.h>
 
@@ -44,7 +45,7 @@ struct ClusterConnectionParameters
     bool treat_local_as_remote;
     bool treat_local_port_as_remote;
     bool secure = false;
-    Int64 priority = 1;
+    Priority priority{1};
     String cluster_name;
     String cluster_secret;
 };
@@ -131,7 +132,7 @@ public:
         Protocol::Compression compression = Protocol::Compression::Enable;
         Protocol::Secure secure = Protocol::Secure::Disable;
 
-        Int64 priority = 1;
+        Priority priority{1};
 
         Address() = default;
 
diff --git a/src/Interpreters/ClusterDiscovery.cpp b/src/Interpreters/ClusterDiscovery.cpp
index 884e3b87343..553488edf50 100644
--- a/src/Interpreters/ClusterDiscovery.cpp
+++ b/src/Interpreters/ClusterDiscovery.cpp
@@ -246,7 +246,7 @@ ClusterPtr ClusterDiscovery::makeCluster(const ClusterInfo & cluster_info)
         /* treat_local_as_remote= */ false,
         /* treat_local_port_as_remote= */ false, /// should be set only for clickhouse-local, but cluster discovery is not used there
         /* secure= */ secure,
-        /* priority= */ 1,
+        /* priority= */ Priority{1},
         /* cluster_name= */ "",
         /* password= */ ""};
     auto cluster = std::make_shared<Cluster>(
diff --git a/src/TableFunctions/TableFunctionRemote.cpp b/src/TableFunctions/TableFunctionRemote.cpp
index b2f09adf773..4143014a7b3 100644
--- a/src/TableFunctions/TableFunctionRemote.cpp
+++ b/src/TableFunctions/TableFunctionRemote.cpp
@@ -262,7 +262,7 @@ void TableFunctionRemote::parseArguments(const ASTPtr & ast_function, ContextPtr
             treat_local_as_remote,
             treat_local_port_as_remote,
             secure,
-            /* priority= */ 1,
+            /* priority= */ Priority{1},
             /* cluster_name= */ "",
             /* password= */ ""
         };

From 32372967e9814e629cbad2ce2ff57f82aba86e97 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 7 Jun 2023 16:55:14 +0200
Subject: [PATCH 240/722] fix

---
 src/Storages/StorageReplicatedMergeTree.cpp            | 10 +++-------
 src/Storages/StorageReplicatedMergeTree.h              |  2 +-
 .../0_stateless/02432_s3_parallel_parts_cleanup.sql    |  6 +-----
 .../0_stateless/02448_clone_replica_lost_part.sql      |  9 ++++++---
 4 files changed, 11 insertions(+), 16 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 6edd7531ec1..36bc3476e91 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -6743,14 +6743,12 @@ size_t StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZK()
     if (parts.empty())
         return total_parts_to_remove;
 
-    size_t res = 0;
-    NOEXCEPT_SCOPE({ res = clearOldPartsAndRemoveFromZKImpl(zookeeper, std::move(parts)); });
-    return res;
+    NOEXCEPT_SCOPE({ clearOldPartsAndRemoveFromZKImpl(zookeeper, std::move(parts)); });
+    return total_parts_to_remove;
 }
 
-size_t StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZKImpl(zkutil::ZooKeeperPtr zookeeper, DataPartsVector && parts)
+void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZKImpl(zkutil::ZooKeeperPtr zookeeper, DataPartsVector && parts)
 {
-
     DataPartsVector parts_to_delete_only_from_filesystem;    // Only duplicates
     DataPartsVector parts_to_delete_completely;              // All parts except duplicates
     DataPartsVector parts_to_retry_deletion;                 // Parts that should be retried due to network problems
@@ -6861,8 +6859,6 @@ size_t StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZKImpl(zkutil::ZooK
         /// Otherwise nobody will try to remove them again (see grabOldParts).
         delete_parts_from_fs_and_rollback_in_case_of_error(parts_to_remove_from_filesystem, "old");
     }
-
-    return total_parts_to_remove;
 }
 
 
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index 368d7d1b948..290266ca00c 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -344,7 +344,7 @@ private:
 
     /// Delete old parts from disk and from ZooKeeper. Returns the number of removed parts
     size_t clearOldPartsAndRemoveFromZK();
-    size_t clearOldPartsAndRemoveFromZKImpl(zkutil::ZooKeeperPtr zookeeper, DataPartsVector && parts);
+    void clearOldPartsAndRemoveFromZKImpl(zkutil::ZooKeeperPtr zookeeper, DataPartsVector && parts);
 
     template<bool async_insert>
     friend class ReplicatedMergeTreeSinkImpl;
diff --git a/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql b/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql
index 3f8aa545298..948ec9e9e8a 100644
--- a/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql
+++ b/tests/queries/0_stateless/02432_s3_parallel_parts_cleanup.sql
@@ -38,11 +38,7 @@ select count(), sum(n), sum(m) from rmt;
 -- New table can assign merges/mutations and can remove old parts
 create table rmt2 (n int, m int, k String) engine=ReplicatedMergeTree('/test/02432/{database}', '2') order by tuple()
     settings storage_policy = 's3_cache', allow_remote_fs_zero_copy_replication=1,
-<<<<<<< HEAD
-        max_part_removal_threads=10, concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,
-=======
-        concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1,
->>>>>>> master
+        concurrent_part_removal_threshold=1, cleanup_delay_period=1, cleanup_delay_period_random_add=1, cleanup_thread_preferred_points_per_iteration=0,
         min_bytes_for_wide_part=0, min_rows_for_wide_part=0, max_replicated_merges_in_queue=1,
         old_parts_lifetime=0;
 
diff --git a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
index 1e99e1869cc..eb4d0f255a7 100644
--- a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
+++ b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
@@ -7,11 +7,11 @@ drop table if exists rmt2;
 create table rmt1 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '1') order by tuple()
     settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
     cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4,
-    merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=500;
+    merge_selecting_sleep_ms=1000, max_merge_selecting_sleep_ms=2000;
 create table rmt2 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '2') order by tuple()
     settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
     cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4,
-    merge_selecting_sleep_ms=100, max_merge_selecting_sleep_ms=500;
+    merge_selecting_sleep_ms=1000, max_merge_selecting_sleep_ms=2000;
 
 -- insert part only on one replica
 system stop replicated sends rmt1;
@@ -141,7 +141,10 @@ system sync replica rmt2;
 -- merge through gap
 optimize table rmt2;
 -- give it a chance to cleanup log
-select sleep(2) format Null; -- increases probability of reproducing the issue
+
+select sleepEachRow(2) from url('http://localhost:8123/?param_tries={1..10}&query=' || encodeURLComponent(
+            'select value from system.zookeeper where path=''//test/02448/' || currentDatabase() || '/rmt/replicas/1/is_lost'' and value=''1'''
+    ), 'LineAsString', 's String') settings max_threads=1 format Null;
 
 -- rmt1 will mimic rmt2, but will not be able to fetch parts for a while
 system stop replicated sends rmt2;

From 6f6d806f927ba1e2c539a92e78906334bee20ce4 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Tue, 6 Jun 2023 15:17:06 +0000
Subject: [PATCH 241/722] Upd test test_alter_moving_garbage

---
 .../configs/config.d/storage_conf.xml         |  2 --
 .../test_alter_moving_garbage/test.py         | 31 +++++++++++++------
 2 files changed, 21 insertions(+), 12 deletions(-)

diff --git a/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml b/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
index 659f59a41b2..f6898ed1d7e 100644
--- a/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
+++ b/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
@@ -1,6 +1,4 @@
 <clickhouse>
-    <!-- allow_remote_fs_zero_copy_replication -->
-
     <storage_configuration>
         <disks>
             <s3>
diff --git a/tests/integration/test_alter_moving_garbage/test.py b/tests/integration/test_alter_moving_garbage/test.py
index b369c9ad377..4a42b73b8d4 100644
--- a/tests/integration/test_alter_moving_garbage/test.py
+++ b/tests/integration/test_alter_moving_garbage/test.py
@@ -28,7 +28,7 @@ def cluster():
         cluster.shutdown()
 
 
-def create_table(node, table_name, **additional_settings):
+def create_table(node, table_name, additional_settings):
     settings = {
         "storage_policy": "two_disks",
         "old_parts_lifetime": 1,
@@ -52,21 +52,32 @@ def create_table(node, table_name, **additional_settings):
     node.query(create_table_statement)
 
 
-def test_create_table(cluster):
+@pytest.mark.parametrize("allow_remote_fs_zero_copy_replication", [False, True])
+def test_create_table(cluster, allow_remote_fs_zero_copy_replication):
     node = cluster.instances["node1"]
-    create_table(node, "test_table")
+
+    additional_settings = {}
+    table_name = "test_table"
+
+    if allow_remote_fs_zero_copy_replication:
+        # different names for logs readability
+        table_name = "test_table_zero_copy"
+        additional_settings["allow_remote_fs_zero_copy_replication"] = 1
+
+    create_table(node, table_name, additional_settings)
+
     node.query(
-        "INSERT INTO test_table SELECT toDate('2021-01-01') + INTERVAL number % 10 DAY, number, toString(sipHash64(number)) FROM numbers(100_000)"
+        f"INSERT INTO {table_name} SELECT toDate('2021-01-01') + INTERVAL number % 10 DAY, number, toString(sipHash64(number)) FROM numbers(100_000)"
     )
 
     stop_alter = False
 
     def alter():
         d = 0
-        node.query(f"ALTER TABLE test_table ADD COLUMN col0 String")
+        node.query(f"ALTER TABLE {table_name} ADD COLUMN col0 String")
         while not stop_alter:
             d = d + 1
-            node.query(f"DELETE FROM test_table WHERE id < {d}")
+            node.query(f"DELETE FROM {table_name} WHERE id < {d}")
             time.sleep(0.1)
 
     alter_thread = threading.Thread(target=alter)
@@ -76,12 +87,12 @@ def test_create_table(cluster):
         partition = f"2021-01-{i:02d}"
         try:
             node.query(
-                f"ALTER TABLE test_table MOVE PARTITION '{partition}' TO DISK 's3'",
+                f"ALTER TABLE {table_name} MOVE PARTITION '{partition}' TO DISK 's3'",
             )
         except QueryRuntimeException as e:
-            # PART_IS_TEMPORARILY_LOCKED
-            assert 384 == e.returncode
-            continue
+            if "PART_IS_TEMPORARILY_LOCKED" in str(e):
+                continue
+            raise e
 
         # clear old temporary directories wakes up every 1 second
         time.sleep(0.5)

From 989540e5b1ae4c10605e7609a7906e789ad755a4 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Wed, 7 Jun 2023 17:37:32 +0000
Subject: [PATCH 242/722] Upd test_alter_moving_garbage: use replicated engine

---
 .../configs/config.d/remote_servers.xml       | 16 +++
 .../test_alter_moving_garbage/test.py         | 99 ++++++++++++++-----
 2 files changed, 88 insertions(+), 27 deletions(-)
 create mode 100644 tests/integration/test_alter_moving_garbage/configs/config.d/remote_servers.xml

diff --git a/tests/integration/test_alter_moving_garbage/configs/config.d/remote_servers.xml b/tests/integration/test_alter_moving_garbage/configs/config.d/remote_servers.xml
new file mode 100644
index 00000000000..45713eaed59
--- /dev/null
+++ b/tests/integration/test_alter_moving_garbage/configs/config.d/remote_servers.xml
@@ -0,0 +1,16 @@
+<clickhouse>
+    <remote_servers>
+        <test_cluster>
+            <shard>
+                <replica>
+                    <host>node1</host>
+                    <port>9000</port>
+                </replica>
+                <replica>
+                    <host>node2</host>
+                    <port>9000</port>
+                </replica>
+            </shard>
+        </test_cluster>
+    </remote_servers>
+</clickhouse>
diff --git a/tests/integration/test_alter_moving_garbage/test.py b/tests/integration/test_alter_moving_garbage/test.py
index 4a42b73b8d4..dc3f6c35ead 100644
--- a/tests/integration/test_alter_moving_garbage/test.py
+++ b/tests/integration/test_alter_moving_garbage/test.py
@@ -3,22 +3,29 @@ import time
 
 import pytest
 import threading
+import random
 
 from helpers.client import QueryRuntimeException
 from helpers.cluster import ClickHouseCluster
 
+# two replicas in remote_servers.xml
+REPLICA_COUNT = 2
 
 @pytest.fixture(scope="module")
 def cluster():
     try:
         cluster = ClickHouseCluster(__file__)
-        cluster.add_instance(
-            "node1",
-            main_configs=[
-                "configs/config.d/storage_conf.xml",
-            ],
-            with_minio=True,
-        )
+        for i in range(1, REPLICA_COUNT + 1):
+            cluster.add_instance(
+                f"node{i}",
+                main_configs=[
+                    "configs/config.d/storage_conf.xml",
+                    "configs/config.d/remote_servers.xml",
+                ],
+                with_minio=True,
+                with_zookeeper=True,
+            )
+
         logging.info("Starting cluster...")
         cluster.start()
         logging.info("Cluster started")
@@ -28,7 +35,7 @@ def cluster():
         cluster.shutdown()
 
 
-def create_table(node, table_name, additional_settings):
+def create_table(node, table_name, replicated, additional_settings):
     settings = {
         "storage_policy": "two_disks",
         "old_parts_lifetime": 1,
@@ -38,55 +45,91 @@ def create_table(node, table_name, additional_settings):
     }
     settings.update(additional_settings)
 
+    table_engine = (
+        f"ReplicatedMergeTree('/clickhouse/tables/0/{table_name}', '{node.name}')"
+        if replicated
+        else "MergeTree()"
+    )
+
     create_table_statement = f"""
         CREATE TABLE {table_name} (
             dt Date,
             id Int64,
             data String,
             INDEX min_max (id) TYPE minmax GRANULARITY 3
-        ) ENGINE=MergeTree()
+        ) ENGINE = {table_engine}
         PARTITION BY dt
         ORDER BY (dt, id)
         SETTINGS {",".join((k+"="+repr(v) for k, v in settings.items()))}"""
 
-    node.query(create_table_statement)
+    if replicated:
+        node.query_with_retry(create_table_statement)
+    else:
+        node.query(create_table_statement)
 
 
-@pytest.mark.parametrize("allow_remote_fs_zero_copy_replication", [False, True])
-def test_create_table(cluster, allow_remote_fs_zero_copy_replication):
-    node = cluster.instances["node1"]
+@pytest.mark.parametrize(
+    "allow_remote_fs_zero_copy_replication,replicated_engine",
+    [(False, False), (False, True), (True, True)],
+)
+def test_create_table(
+    cluster, allow_remote_fs_zero_copy_replication, replicated_engine
+):
+    if replicated_engine:
+        nodes = list(cluster.instances.values())
+    else:
+        nodes = [cluster.instances["node1"]]
 
     additional_settings = {}
-    table_name = "test_table"
 
+    # different names for logs readability
+    table_name = "test_table"
     if allow_remote_fs_zero_copy_replication:
-        # different names for logs readability
         table_name = "test_table_zero_copy"
         additional_settings["allow_remote_fs_zero_copy_replication"] = 1
+    if replicated_engine:
+        table_name = table_name + "_replicated"
 
-    create_table(node, table_name, additional_settings)
+    for node in nodes:
+        create_table(node, table_name, replicated_engine, additional_settings)
 
-    node.query(
-        f"INSERT INTO {table_name} SELECT toDate('2021-01-01') + INTERVAL number % 10 DAY, number, toString(sipHash64(number)) FROM numbers(100_000)"
-    )
+    for i in range(1, 11):
+        partition = f"2021-01-{i:02d}"
+        random.choice(nodes).query(
+            f"INSERT INTO {table_name} SELECT toDate('{partition}'), number as id, toString(sipHash64(number, {i})) FROM numbers(10_000)"
+        )
+
+    def check_count():
+        if replicated_engine:
+            return random.choice(nodes).query_with_retry(
+                f"SELECT countDistinct(dt, data) FROM clusterAllReplicas(test_cluster, default.{table_name}) WHERE id % 100 = 0"
+            )
+        else:
+            return random.choice(nodes).query(
+                f"SELECT countDistinct(dt, data) FROM {table_name} WHERE id % 100 = 0"
+            )
+
+    assert check_count() == "1000\n"
 
     stop_alter = False
 
     def alter():
-        d = 0
-        node.query(f"ALTER TABLE {table_name} ADD COLUMN col0 String")
-        while not stop_alter:
-            d = d + 1
-            node.query(f"DELETE FROM {table_name} WHERE id < {d}")
+        random.choice(nodes).query(f"ALTER TABLE {table_name} ADD COLUMN col0 String")
+        for d in range(1, 100):
+            if stop_alter:
+                break
+            # I managed to reproduce issue with DELETE, but it can be any other lightweight mutation
+            # Do not delete rows with id % 100 = 0, because they are used in check_count to check that data is not corrupted
+            random.choice(nodes).query(f"DELETE FROM {table_name} WHERE id % 100 = {d}")
             time.sleep(0.1)
 
     alter_thread = threading.Thread(target=alter)
     alter_thread.start()
 
-    for i in range(1, 10):
+    for i in range(1, 11):
         partition = f"2021-01-{i:02d}"
         try:
-            node.query(
+            random.choice(nodes).query(
                 f"ALTER TABLE {table_name} MOVE PARTITION '{partition}' TO DISK 's3'",
             )
         except QueryRuntimeException as e:
@@ -94,8 +137,10 @@ def test_create_table(cluster, allow_remote_fs_zero_copy_replication):
                 continue
             raise e
 
-        # clear old temporary directories wakes up every 1 second
+        # Function to clear old temporary directories wakes up every 1 second, sleep to make sure it is called
         time.sleep(0.5)
 
     stop_alter = True
     alter_thread.join()
+
+    assert check_count() == "1000\n"

From d3eb0805d44564fbbf093c5c1d39fbad532b0f59 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 7 Jun 2023 23:28:19 +0000
Subject: [PATCH 243/722] clang-tidy run + changes in docs

---
 docs/en/interfaces/cli.md       | 12 ++++++------
 docs/ru/interfaces/cli.md       | 10 +++++-----
 src/Client/ConnectionString.cpp | 23 ++++++++++++-----------
 3 files changed, 23 insertions(+), 22 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index 94f1fbf9e41..ba54694faa9 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -198,9 +198,9 @@ If host is not specified, the default host will be used (localhost).
 If port is not specified, the default port will be used (9000).
 If database is not specified, the default database will be used.
 
-User, password, and database can be specified in the connection string either in --user, --password, --database command line options.
+User, password, and database can be specified in the connection string either in `--user`, `--password`, `--database` command line options.
 
-The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except **--host(h)** and **--port**.
+The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except `--host(h)` and `--port`.
 
 ### Multiple hosts {#connection_string_multiple_hosts}
 
@@ -226,25 +226,25 @@ Connect to localhost using port 9000 in interactive, multiline mode.
 clickhouse-client "clickhouse://localhost:9000" -m
 ```
 
-Connect to localhost using port 9000 in interactive mode with the user specified in --user option.
+Connect to localhost using port 9000 in interactive mode with the user specified in `--user` option.
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000" --user default
 ```
 
-Connect to localhost using port 9000 in interactive mode with database 'my_database' specified in command line option
+Connect to localhost using port 9000 in interactive mode to `my_database` database specified in command line option
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000" --database my_database
 ```
 
-Connect to localhost using port 9000 in interactive mode with the database specified in the connection string.
+Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the connection string.
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000/my_database"
 ```
 
-Connect to localhost using port 9000 in interactive mode with a database specified in the connection string and a secure connection using shorthanded 's' URI parameter.
+Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the connection string and a secure connection using shorthanded 's' URI parameter.
 
 ```bash
 clickhouse-client "clickhouse://localhost/my_database?s"
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index 30cd9757ebb..5f119ad9544 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -151,9 +151,9 @@ clickhouse://[2001:db8::1234]
 Если port не указан, будет использоваться порт по умолчанию (9000).
 Если база данных не указана, будет использоваться база данных по умолчанию (default).
 
-Пользователь, пароль и база данных могут быть указаны в строке подключения либо в опциях командной строки --user, --password, --database.
+Пользователь, пароль и база данных могут быть указаны в строке подключения либо в опциях командной строки `--user`, `--password`, `--database`.
 
-Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме **--host(h)** и **--port**.
+Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме `--host (h)` и `--port`.
 
 ### Несколько хостов {#connection_string_multiple_hosts}
 
@@ -185,19 +185,19 @@ clickhouse-client "clickhouse://localhost:9000" -m
 clickhouse-client "clickhouse://localhost:9000" --user default
 ```
 
-Подключиться к localhost, используя порт 9000 в интерактивном режиме с базой данных 'my_database', указанной в опции командной строки.
+Подключиться к localhost, используя порт 9000 в интерактивном режиме с базой данных `my_database`, указанной в опции командной строки.
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000" --database my_database
 ```
 
-Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных my_database, указанной в строке подключения.
+Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных `my_database`, указанной в строке подключения.
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000/my_database"
 ```
 
-Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных, указанной в строке подключения, и безопасным соединением с использованием сокращенного параметра URI 's'.
+Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных `my_database`, указанной в строке подключения, и безопасным соединением, используя короткий вариант команды URI 's'.
 
 ``` bash
 clickhouse-client "clickhouse://localhost/my_database?s"
diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index aeb1c1dca02..95fec5b52ee 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -128,20 +128,21 @@ bool tryParseConnectionString(
     else
         hosts_end_pos = hosts_or_user_info_end_pos;
 
-    auto hosts_end = hosts_end_pos != std::string_view::npos ? connection_string.begin() + hosts_end_pos
-                                                             : connection_string.end();
+    const auto * hosts_end = hosts_end_pos != std::string_view::npos ? connection_string.begin() + hosts_end_pos
+                                                                     : connection_string.end();
 
     try
     {
-        // Poco::URI doesn't support several hosts in URI.
-        // Split string clickhouse:[user_info]host1:port1, ... , hostN:portN[database]?[query_parameters]
-        // into multiple string for each host:
-        // clickhouse:[user_info]host1:port1[database]?[query_parameters]
-        // ...
-        // clickhouse:[user_info]hostN:portN[database]?[query_parameters]
+        /** Poco::URI doesn't support several hosts in URI.
+          * Split string clickhouse:[user_info]host1:port1, ... , hostN:portN[database]?[query_parameters]
+          * into multiple string for each host:
+          * clickhouse:[user_info]host1:port1[database]?[query_parameters]
+          * ...
+          * clickhouse:[user_info]hostN:portN[database]?[query_parameters]
+          */
         Poco::URI uri;
-        auto last_host_begin = connection_string.begin() + offset;
-        for (auto it = last_host_begin; it != hosts_end; ++it)
+        const auto * last_host_begin = connection_string.begin() + offset;
+        for (const auto * it = last_host_begin; it != hosts_end; ++it)
         {
             if (*it == ',')
             {
@@ -198,7 +199,7 @@ bool tryParseConnectionString(
         }
 
         const auto & database_name = uri.getPath();
-        size_t start_symbol = database_name.size() > 0u && database_name[0] == '/' ? 1u : 0u;
+        size_t start_symbol = !database_name.empty() && database_name[0] == '/' ? 1u : 0u;
         if (database_name.size() > start_symbol)
         {
             common_arguments.push_back("--database");

From cf24d70bfd54dd45606ad1c53a136495c317bb9f Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Thu, 8 Jun 2023 02:20:50 +0000
Subject: [PATCH 244/722] minor documentation changes

---
 docs/en/interfaces/cli.md | 18 +++++++++---------
 docs/ru/interfaces/cli.md | 10 +++++-----
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index ba54694faa9..c36887672c7 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -166,13 +166,13 @@ The connection string for clickhouse-client is presented in URI format:
 clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
 ```
 
-where user_info is: ```user[:password]```
-and hosts_and_ports is a list of values: ```[host][:port],[host][:port]``` Port is not mandatory.
-and query_parameters is a list of parameter[=value]: ```param_name[=value]&param_name[=value]...``` value may not be required for some of parameters. Parameter names are case sensitive.
+where user_info is: `user[:password]`
+and hosts_and_ports is a list of values: `[host][:port],[host][:port]` Port is not mandatory.
+and query_parameters is a list of parameter[=value]: `param_name[=value]&param_name[=value]...` value may not be required for some of the parameters. Parameter names are case sensitive.
 
 Allowed query_parameters keys:
 
-- **secure** or shorthanded **s** - no value. If specified, client will connect to the server over a secure connection (TLS). See **secure** in [command-line-options](#command-line-options)
+- `secure` or shorthanded `s` - no value. If specified, client will connect to the server over a secure connection (TLS). See `secure` in [command-line-options](#command-line-options)
 
 These examples illustrate valid connection strings for clickhouse-client:
 
@@ -210,11 +210,11 @@ If more than one host is supplied, or if a single host name is translated to mor
 
 ### Percent encoding {#connection_string_uri_percent_encoding}
 
-Hosts, user name, password, database and query parameters should be [Percent-Encoded](https://en.wikipedia.org/wiki/URL_encoding) if values contain URI invalid characters.
+Hosts, user name, password, database, and query parameters should be [Percent-Encoded](https://en.wikipedia.org/wiki/URL_encoding) if values contain invalid URI characters.
 
 ### Examples {#connection_string_examples}
 
-Connect to localhost using port 9000 and executes the query "SELECT 1".
+Connect to localhost using port 9000 and execute the query "SELECT 1".
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000" --query "SELECT 1"
@@ -232,7 +232,7 @@ Connect to localhost using port 9000 in interactive mode with the user specified
 clickhouse-client "clickhouse://localhost:9000" --user default
 ```
 
-Connect to localhost using port 9000 in interactive mode to `my_database` database specified in command line option
+Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the command line option.
 
 ``` bash
 clickhouse-client "clickhouse://localhost:9000" --database my_database
@@ -250,7 +250,7 @@ Connect to localhost using port 9000 in interactive mode to `my_database` databa
 clickhouse-client "clickhouse://localhost/my_database?s"
 ```
 
-Connect to default host using the default port, default user, and default database.
+Connect to default host using default port, default user, and default database.
 
 ``` bash
 clickhouse-client "clickhouse:"
@@ -262,7 +262,7 @@ Connect to the default host using the default port, using user user_name and no
 clickhouse-client "clickhouse://user_name@"
 ```
 
-Connect to localhost using email user name. Symbol '@' is percent encoded to '%40'.
+Connect to localhost using email as the user name. `@` symbol is percent encoded to `%40`.
 
 ``` bash
 clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index 5f119ad9544..801a72e48ec 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -118,14 +118,14 @@ $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="numbe
 clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
 ```
 
-где user_info - это: ```user[:password]```
-hosts_and_ports - это список значений: ```[host][:port],[host][:port]```. Port может быть не задан.
-query_parameters - это список пар ключ[=значение]: ```param_name[=value]&param_name[=value]...```. Значение может быть пустым.
+где user_info - это: `user[:password]`
+hosts_and_ports - это список значений: `[host][:port],[host][:port]`. Port может быть не задан.
+query_parameters - это список пар ключ[=значение]: `param_name[=value]&param_name[=value]...`. Значение может быть пустым.
 Имена параметров чувствительны к регистру.
 
 Допустимые ключи query_parameters:
 
-- **secure** или сокращенно **s** - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. **secure** в [command-line-options](#command-line-options).
+- `secure` или сокращенно `s` - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. `secure` в [command-line-options](#command-line-options).
 
 Эти примеры иллюстрируют допустимые строки подключения для clickhouse-client:
 
@@ -215,7 +215,7 @@ clickhouse-client "clickhouse:"
 clickhouse-client "clickhouse://user_name@"
 ```
 
-Подключиться к localhost, используя электронную почту, как имя пользователя. Символ '@' закодирован как '%40'.
+Подключиться к localhost, используя электронную почту, как имя пользователя. Символ `@` закодирован как `%40`.
 
 ``` bash
 clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"

From 7263769d20a30747f7a80a45a6def3abf41cccfa Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 8 Jun 2023 06:12:54 +0000
Subject: [PATCH 245/722] Add constexpr / fix date check

---
 src/Functions/DateTimeTransforms.h                        | 8 ++------
 .../0_stateless/01746_convert_type_with_default.reference | 1 -
 .../0_stateless/01746_convert_type_with_default.sql       | 1 -
 3 files changed, 2 insertions(+), 8 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 823272e0324..09b0d71daf8 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -1449,18 +1449,14 @@ struct Transformer
             {
                 bool check_range_result = true;
 
-                if constexpr (std::is_same_v<ToType, DataTypeDate>)
-                {
-                    check_range_result = vec_from[i] >= 0 && vec_from[i] <= DATE_LUT_MAX_DAY_NUM;
-                }
-                else if constexpr (std::is_same_v<ToType, DataTypeDateTime>)
+                if constexpr (std::is_same_v<ToType, DataTypeDate> || std::is_same_v<ToType, DataTypeDateTime>)
                 {
                     check_range_result = vec_from[i] >= 0 && vec_from[i] <= 0xFFFFFFFFL;
                 }
 
                 if (!check_range_result)
                 {
-                    if (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+                    if constexpr (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
                     {
                         vec_to[i] = 0;
                         if (vec_null_map_to)
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 85bf2064fdc..959ee29b5e7 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -45,7 +45,6 @@
 2023-05-30 14:38:20
 2023-05-30 14:38:20
 2023-05-30 14:38:20
-2023-05-30 14:38:20
 1970-01-01 00:00:19
 1970-01-01 00:00:19
 1970-01-01 00:00:19
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 1065eefa94d..099652a8a39 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -56,7 +56,6 @@ select toDateOrDefault(cast(19 as UInt256));
 select toDateOrDefault(19507, '2000-01-01'::Date);
 select toDateOrDefault(-1, '2023-05-30'::Date);
 
-select toDateTimeOrDefault('2023-05-30 14:38:20');
 select toDateTimeOrDefault('2023-05-30 14:38:20', 'UTC');
 select toDateTimeOrDefault('1xxx', 'UTC', '2023-05-30 14:38:20'::DateTime('UTC'));
 select toDateTimeOrDefault(1685457500, 'UTC');

From f5816c27aa3c675c3cd02ce292675d2214e5e56f Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 8 Jun 2023 06:20:14 +0000
Subject: [PATCH 246/722] Use hex value in tests

---
 tests/queries/0_stateless/01601_accurate_cast.sql | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/01601_accurate_cast.sql b/tests/queries/0_stateless/01601_accurate_cast.sql
index f7f4d588ccc..5555129f0ad 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.sql
+++ b/tests/queries/0_stateless/01601_accurate_cast.sql
@@ -24,13 +24,13 @@ SELECT accurateCast('123', 'FixedString(2)'); -- { serverError 131 }
 SELECT accurateCast('12', 'FixedString(2)');
 
 SELECT accurateCast(-1, 'DateTime');   -- { serverError 70 }
-SELECT accurateCast(5000000000, 'DateTime');   -- { serverError 70 }
+SELECT accurateCast(0xFFFFFFFF + 1, 'DateTime');   -- { serverError 70 }
 SELECT accurateCast('1xxx', 'DateTime');   -- { serverError 41 }
 SELECT accurateCast('2023-05-30 14:38:20', 'DateTime');
 SELECT toString(accurateCast(19, 'DateTime'), 'UTC');
 
 SELECT accurateCast(-1, 'Date');   -- { serverError 70 }
-SELECT accurateCast(999999, 'Date');   -- { serverError 70 }
+SELECT accurateCast(0xFFFFFFFF + 1, 'Date');   -- { serverError 70 }
 SELECT accurateCast('1xxx', 'Date');   -- { serverError 38 }
 SELECT accurateCast('2023-05-30', 'Date');
 SELECT accurateCast(19, 'Date');

From 17a560cca7cd5bb71bf673fafea76695855b3c6a Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Thu, 8 Jun 2023 09:11:02 +0000
Subject: [PATCH 247/722] Add datetime test

---
 .../0_stateless/01746_convert_type_with_default.reference      | 2 ++
 tests/queries/0_stateless/01746_convert_type_with_default.sql  | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 959ee29b5e7..541580d67f5 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -39,6 +39,8 @@
 1970-01-20
 1970-01-20
 1970-01-20
+2149-06-06
+1970-01-01
 2023-05-30
 2023-05-30
 2023-05-30 14:38:20
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 099652a8a39..2620780cfb9 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -53,6 +53,9 @@ select toDateOrDefault(cast(19 as UInt128));
 select toDateOrDefault(cast(19 as Int256));
 select toDateOrDefault(cast(19 as UInt256));
 
+select toDateOrDefault(65535);
+select toDateOrDefault(65536);
+
 select toDateOrDefault(19507, '2000-01-01'::Date);
 select toDateOrDefault(-1, '2023-05-30'::Date);
 

From 44c68ffdab34642192f16fb1f9ecb9bf96bdd73b Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 8 Jun 2023 10:17:02 +0000
Subject: [PATCH 248/722] Add config param allow_remove_stale_moving_parts

---
 src/Storages/MergeTree/MergeTreeData.cpp          | 15 +++++++++++++--
 src/Storages/MergeTree/MergeTreeData.h            |  3 +++
 src/Storages/MergeTree/MergeTreePartsMover.cpp    |  7 ++++---
 .../configs/config.d/storage_conf.xml             |  2 ++
 .../configs/remote_servers.xml                    |  1 +
 .../test_encrypted_disk/configs/storage.xml       |  1 +
 .../configs/config.xml                            |  1 +
 .../configs/config.d/storage_conf.xml             |  1 +
 .../test_merge_tree_s3/configs/config.xml         |  1 +
 .../configs/config.d/storage_configuration.xml    |  1 +
 .../configs/config.d/storage_configuration.xml    |  1 +
 .../configs/config.d/storage_configuration.xml    |  1 +
 .../configs/config.d/storage_conf.xml             |  1 +
 .../configs/config.d/s3.xml                       |  1 +
 .../configs/config.d/storage_configuration.xml    |  1 +
 .../test_zero_copy_fetch/configs/storage_conf.xml |  1 +
 16 files changed, 34 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 7fe3efaf6d5..9ce4e55e341 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -19,6 +19,7 @@
 #include <Common/CurrentMetrics.h>
 #include <Common/ThreadFuzzer.h>
 #include <Common/getNumberOfPhysicalCPUCores.h>
+#include <Common/Config/ConfigHelper.h>
 #include <Compression/CompressedReadBuffer.h>
 #include <Core/QueryProcessingStage.h>
 #include <DataTypes/DataTypeEnum.h>
@@ -1998,14 +1999,19 @@ static bool isOldPartDirectory(const DiskPtr & disk, const String & directory_pa
     return true;
 }
 
+
 size_t MergeTreeData::clearOldTemporaryDirectories(size_t custom_directories_lifetime_seconds, const NameSet & valid_prefixes)
 {
     size_t cleared_count = 0;
 
     cleared_count += clearOldTemporaryDirectories(relative_data_path, custom_directories_lifetime_seconds, valid_prefixes);
 
-    /// Clear _all_ parts from the `moving` directory
-    cleared_count += clearOldTemporaryDirectories(fs::path(relative_data_path) / "moving", custom_directories_lifetime_seconds, {""});
+    if (allowRemoveStaleMovingParts())
+    {
+        /// Clear _all_ parts from the `moving` directory
+        cleared_count += clearOldTemporaryDirectories(fs::path(relative_data_path) / "moving", custom_directories_lifetime_seconds, {""});
+    }
+
     return cleared_count;
 }
 
@@ -8412,6 +8418,11 @@ MergeTreeData::MutableDataPartPtr MergeTreeData::createEmptyPart(
     return new_data_part;
 }
 
+bool MergeTreeData::allowRemoveStaleMovingParts() const
+{
+    return ConfigHelper::getBool(getContext()->getConfigRef(), "allow_remove_stale_moving_parts");
+}
+
 CurrentlySubmergingEmergingTagger::~CurrentlySubmergingEmergingTagger()
 {
     std::lock_guard lock(storage.currently_submerging_emerging_mutex);
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index 444bd8f47ac..8755ffebd7e 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -1060,6 +1060,9 @@ public:
     void waitForOutdatedPartsToBeLoaded() const;
     bool canUsePolymorphicParts() const;
 
+    /// TODO: make enabled by default in the next release if no problems found.
+    bool allowRemoveStaleMovingParts() const;
+
 protected:
     friend class IMergeTreeDataPart;
     friend class MergeTreeDataMergerMutator;
diff --git a/src/Storages/MergeTree/MergeTreePartsMover.cpp b/src/Storages/MergeTree/MergeTreePartsMover.cpp
index 656167de986..8fa4ac6c78a 100644
--- a/src/Storages/MergeTree/MergeTreePartsMover.cpp
+++ b/src/Storages/MergeTree/MergeTreePartsMover.cpp
@@ -250,7 +250,7 @@ MergeTreePartsMover::TemporaryClonedPart MergeTreePartsMover::clonePart(const Me
     cloned_part.part = std::move(builder).withPartFormatFromDisk().build();
     LOG_TRACE(log, "Part {} was cloned to {}", part->name, cloned_part.part->getDataPartStorage().getFullPath());
 
-    cloned_part.part->is_temp = true;
+    cloned_part.part->is_temp = data->allowRemoveStaleMovingParts();
     cloned_part.part->loadColumnsChecksumsIndexes(true, true);
     cloned_part.part->loadVersionMetadata();
     cloned_part.part->modification_time = cloned_part.part->getDataPartStorage().getLastModified().epochTime();
@@ -270,10 +270,11 @@ void MergeTreePartsMover::swapClonedPart(TemporaryClonedPart & cloned_part) cons
     {
         LOG_INFO(log,
             "Failed to swap {}. Active part doesn't exist (containing part {}). "
-            "Possible it was merged or mutated. Will remove copy on path '{}'",
+            "Possible it was merged or mutated. Part on path '{}' {}",
             cloned_part.part->name,
             active_part ? active_part->name : "doesn't exist",
-            cloned_part.part->getDataPartStorage().getFullPath());
+            cloned_part.part->getDataPartStorage().getFullPath(),
+            data->allowRemoveStaleMovingParts() ? "will be removed" : "will remain intact (set <allow_remove_stale_moving_parts> in config.xml, exercise caution when using)");
         return;
     }
 
diff --git a/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml b/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
index f6898ed1d7e..1450a459257 100644
--- a/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
+++ b/tests/integration/test_alter_moving_garbage/configs/config.d/storage_conf.xml
@@ -21,4 +21,6 @@
             </two_disks>
         </policies>
     </storage_configuration>
+
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_consistant_parts_after_move_partition/configs/remote_servers.xml b/tests/integration/test_consistant_parts_after_move_partition/configs/remote_servers.xml
index 3d4ccd584b1..f22b7dc4032 100644
--- a/tests/integration/test_consistant_parts_after_move_partition/configs/remote_servers.xml
+++ b/tests/integration/test_consistant_parts_after_move_partition/configs/remote_servers.xml
@@ -16,4 +16,5 @@
             </shard>
         </test_cluster>
     </remote_servers>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_encrypted_disk/configs/storage.xml b/tests/integration/test_encrypted_disk/configs/storage.xml
index 1e48c80d50f..2b84e0d6daa 100644
--- a/tests/integration/test_encrypted_disk/configs/storage.xml
+++ b/tests/integration/test_encrypted_disk/configs/storage.xml
@@ -105,4 +105,5 @@
             </s3_encrypted_cache_policy>
          </policies>
     </storage_configuration>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_merge_tree_azure_blob_storage/configs/config.xml b/tests/integration/test_merge_tree_azure_blob_storage/configs/config.xml
index feb537ebbce..a6e0d26f695 100644
--- a/tests/integration/test_merge_tree_azure_blob_storage/configs/config.xml
+++ b/tests/integration/test_merge_tree_azure_blob_storage/configs/config.xml
@@ -15,4 +15,5 @@
     <max_concurrent_queries>500</max_concurrent_queries>
     <path>./clickhouse/</path>
     <users_config>users.xml</users_config>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_merge_tree_hdfs/configs/config.d/storage_conf.xml b/tests/integration/test_merge_tree_hdfs/configs/config.d/storage_conf.xml
index 890c396ed95..858d77e9ea0 100644
--- a/tests/integration/test_merge_tree_hdfs/configs/config.d/storage_conf.xml
+++ b/tests/integration/test_merge_tree_hdfs/configs/config.d/storage_conf.xml
@@ -29,4 +29,5 @@
     <merge_tree>
         <min_bytes_for_wide_part>0</min_bytes_for_wide_part>
     </merge_tree>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_merge_tree_s3/configs/config.xml b/tests/integration/test_merge_tree_s3/configs/config.xml
index 314f23f5788..a25da96215e 100644
--- a/tests/integration/test_merge_tree_s3/configs/config.xml
+++ b/tests/integration/test_merge_tree_s3/configs/config.xml
@@ -8,4 +8,5 @@
     </s3>
 
     <enable_system_unfreeze>true</enable_system_unfreeze>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_move_partition_to_disk_on_cluster/configs/config.d/storage_configuration.xml b/tests/integration/test_move_partition_to_disk_on_cluster/configs/config.d/storage_configuration.xml
index 3289186c175..cd2f0867c61 100644
--- a/tests/integration/test_move_partition_to_disk_on_cluster/configs/config.d/storage_configuration.xml
+++ b/tests/integration/test_move_partition_to_disk_on_cluster/configs/config.d/storage_configuration.xml
@@ -24,5 +24,6 @@
     </policies>
 
 </storage_configuration>
+<allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 
 </clickhouse>
diff --git a/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml b/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml
index e7a87fb77b1..033699f4634 100644
--- a/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml
+++ b/tests/integration/test_multiple_disks/configs/config.d/storage_configuration.xml
@@ -122,6 +122,7 @@
     </policies>
 
 </storage_configuration>
+<allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 
 <merge_tree>
     <temporary_directories_lifetime>1</temporary_directories_lifetime>
diff --git a/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml b/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml
index 12a598c64b5..65cac905e9a 100644
--- a/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml
+++ b/tests/integration/test_rename_column/configs/config.d/storage_configuration.xml
@@ -29,5 +29,6 @@
     <min_bytes_for_wide_part>0</min_bytes_for_wide_part>
     <temporary_directories_lifetime>1</temporary_directories_lifetime>
 </merge_tree>
+<allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 
 </clickhouse>
diff --git a/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/configs/config.d/storage_conf.xml b/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/configs/config.d/storage_conf.xml
index cb444c728c9..bb4aba94e0b 100644
--- a/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/configs/config.d/storage_conf.xml
+++ b/tests/integration/test_replicated_merge_tree_hdfs_zero_copy/configs/config.d/storage_conf.xml
@@ -89,4 +89,5 @@
         <cluster>test_cluster</cluster>
         <shard>1</shard>
     </macros>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_s3_zero_copy_replication/configs/config.d/s3.xml b/tests/integration/test_s3_zero_copy_replication/configs/config.d/s3.xml
index f7d9efc2cae..63162c3c19b 100644
--- a/tests/integration/test_s3_zero_copy_replication/configs/config.d/s3.xml
+++ b/tests/integration/test_s3_zero_copy_replication/configs/config.d/s3.xml
@@ -93,4 +93,5 @@
         <cluster>test_cluster</cluster>
     </macros>
 
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_ttl_move/configs/config.d/storage_configuration.xml b/tests/integration/test_ttl_move/configs/config.d/storage_configuration.xml
index ae1dc9dd038..09e6fc99411 100644
--- a/tests/integration/test_ttl_move/configs/config.d/storage_configuration.xml
+++ b/tests/integration/test_ttl_move/configs/config.d/storage_configuration.xml
@@ -107,4 +107,5 @@
 
 </storage_configuration>
 
+<allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>
diff --git a/tests/integration/test_zero_copy_fetch/configs/storage_conf.xml b/tests/integration/test_zero_copy_fetch/configs/storage_conf.xml
index b3ce0735a3c..9e9dab6a972 100644
--- a/tests/integration/test_zero_copy_fetch/configs/storage_conf.xml
+++ b/tests/integration/test_zero_copy_fetch/configs/storage_conf.xml
@@ -38,4 +38,5 @@
     <merge_tree>
         <allow_remote_fs_zero_copy_replication>true</allow_remote_fs_zero_copy_replication>
     </merge_tree>
+    <allow_remove_stale_moving_parts>true</allow_remove_stale_moving_parts>
 </clickhouse>

From ac638615aeace304b6a196e68561d73a03e86344 Mon Sep 17 00:00:00 2001
From: vdimir <vdimir@clickhouse.com>
Date: Thu, 8 Jun 2023 10:29:01 +0000
Subject: [PATCH 249/722] Upd test_alter_moving_garbage

---
 .../test_alter_moving_garbage/test.py         | 39 ++++++++++++-------
 1 file changed, 24 insertions(+), 15 deletions(-)

diff --git a/tests/integration/test_alter_moving_garbage/test.py b/tests/integration/test_alter_moving_garbage/test.py
index dc3f6c35ead..330df3ac490 100644
--- a/tests/integration/test_alter_moving_garbage/test.py
+++ b/tests/integration/test_alter_moving_garbage/test.py
@@ -11,6 +11,7 @@ from helpers.cluster import ClickHouseCluster
 # two replicas in remote_servers.xml
 REPLICA_COUNT = 2
 
+
 @pytest.fixture(scope="module")
 def cluster():
     try:
@@ -82,7 +83,7 @@ def test_create_table(
 
     additional_settings = {}
 
-    # different names for logs readability
+    # Different names for logs readability
     table_name = "test_table"
     if allow_remote_fs_zero_copy_replication:
         table_name = "test_table_zero_copy"
@@ -99,17 +100,7 @@ def test_create_table(
             f"INSERT INTO {table_name} SELECT toDate('{partition}'), number as id, toString(sipHash64(number, {i})) FROM numbers(10_000)"
         )
 
-    def check_count():
-        if replicated_engine:
-            return random.choice(nodes).query_with_retry(
-                f"SELECT countDistinct(dt, data) FROM clusterAllReplicas(test_cluster, default.{table_name}) WHERE id % 100 = 0"
-            )
-        else:
-            return random.choice(nodes).query(
-                f"SELECT countDistinct(dt, data) FROM {table_name} WHERE id % 100 = 0"
-            )
-
-    assert check_count() == "1000\n"
+    # Run ALTER in parallel with moving parts
 
     stop_alter = False
 
@@ -118,9 +109,14 @@ def test_create_table(
         for d in range(1, 100):
             if stop_alter:
                 break
-            # I managed to reproduce issue with DELETE, but it can be any other lightweight mutation
-            # Do not delete rows with id % 100 = 0, because they are used in check_count to check that data is not corrupted
+
+            # Some lightweight mutation should change moving part before it is swapped, then we will have to cleanup it.
+            # Messages `Failed to swap {}. Active part doesn't exist` should appear in logs.
+            #
+            # I managed to reproduce issue with DELETE (`ALTER TABLE {table_name} ADD/DROP COLUMN` also works on real s3 instead of minio)
+            # Note: do not delete rows with id % 100 = 0, because they are used in `check_count` to use them in check that data is not corrupted
             random.choice(nodes).query(f"DELETE FROM {table_name} WHERE id % 100 = {d}")
+
             time.sleep(0.1)
 
     alter_thread = threading.Thread(target=alter)
@@ -143,4 +139,17 @@ def test_create_table(
     stop_alter = True
     alter_thread.join()
 
-    assert check_count() == "1000\n"
+    # Check that no data was lost
+
+    data_digest = None
+    if replicated_engine:
+        # We don't know what data was replicated, so we need to check all replicas and take unique values
+        data_digest = random.choice(nodes).query_with_retry(
+            f"SELECT countDistinct(dt, data) FROM clusterAllReplicas(test_cluster, default.{table_name}) WHERE id % 100 == 0"
+        )
+    else:
+        data_digest = random.choice(nodes).query(
+            f"SELECT countDistinct(dt, data) FROM {table_name} WHERE id % 100 == 0"
+        )
+
+    assert data_digest == "1000\n"

From e66531affac094567d95d038cfbf8c9ca90027ae Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Thu, 8 Jun 2023 12:50:26 +0200
Subject: [PATCH 250/722] Update test

---
 tests/queries/0_stateless/02782_bitmap_overflow.sql | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/tests/queries/0_stateless/02782_bitmap_overflow.sql b/tests/queries/0_stateless/02782_bitmap_overflow.sql
index 656a3e7c144..71ddce5c3b9 100644
--- a/tests/queries/0_stateless/02782_bitmap_overflow.sql
+++ b/tests/queries/0_stateless/02782_bitmap_overflow.sql
@@ -1,2 +1,4 @@
+-- Tags: no-msan, no-asan
+
 select unhex('0181808080908380808000')::AggregateFunction(groupBitmap, UInt64); -- {serverError TOO_LARGE_ARRAY_SIZE}
 

From 44ee530b4d50ed09c39133fb81e827e6c3402a31 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 8 Jun 2023 11:04:01 +0000
Subject: [PATCH 251/722] Kill gdb in clickhouse-test before getting
 stacktraces

---
 tests/clickhouse-test | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/tests/clickhouse-test b/tests/clickhouse-test
index d8fad77b95c..a7ec7b15e16 100755
--- a/tests/clickhouse-test
+++ b/tests/clickhouse-test
@@ -340,9 +340,22 @@ def get_transactions_list(args):
         return f"Cannot get list of transactions: {e}"
 
 
+def kill_gdb():
+    for i in range(5):
+        code = subprocess.call("kill -TERM $(pidof gdb)", shell=True, stderr=subprocess.STDOUT, timeout=30)
+        if code != 0:
+            time.sleep(i)
+        else:
+            break
+
 # collect server stacktraces using gdb
 def get_stacktraces_from_gdb(server_pid):
     try:
+        # We could attach gdb to clickhouse-server before running some tests
+        # to print stacktraces of all crashes even if clickhouse cannot print it for some reason.
+        # We should kill existing gdb if any before starting new one.
+        kill_gdb()
+
         cmd = f"gdb -batch -ex 'thread apply all backtrace' -p {server_pid}"
         return subprocess.check_output(cmd, shell=True).decode("utf-8")
     except Exception as e:

From 54414be47b33f352bea49ee51cc2502f1f41b21d Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 8 Jun 2023 11:14:43 +0000
Subject: [PATCH 252/722] Better

---
 tests/clickhouse-test | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/tests/clickhouse-test b/tests/clickhouse-test
index a7ec7b15e16..56cf2f0ce0f 100755
--- a/tests/clickhouse-test
+++ b/tests/clickhouse-test
@@ -340,9 +340,14 @@ def get_transactions_list(args):
         return f"Cannot get list of transactions: {e}"
 
 
-def kill_gdb():
+def kill_gdb_if_any():
+    # Check if we have running gdb.
+    code = subprocess.call("pidof gdb", shell=True)
+    if code != 0:
+        return
+
     for i in range(5):
-        code = subprocess.call("kill -TERM $(pidof gdb)", shell=True, stderr=subprocess.STDOUT, timeout=30)
+        code = subprocess.call("kill -TERM $(pidof gdb)", shell=True, timeout=30)
         if code != 0:
             time.sleep(i)
         else:
@@ -354,7 +359,7 @@ def get_stacktraces_from_gdb(server_pid):
         # We could attach gdb to clickhouse-server before running some tests
         # to print stacktraces of all crashes even if clickhouse cannot print it for some reason.
         # We should kill existing gdb if any before starting new one.
-        kill_gdb()
+        kill_gdb_if_any()
 
         cmd = f"gdb -batch -ex 'thread apply all backtrace' -p {server_pid}"
         return subprocess.check_output(cmd, shell=True).decode("utf-8")

From 7079b4c885656fba788400002f012d3ff43e01de Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Thu, 8 Jun 2023 12:40:16 +0300
Subject: [PATCH 253/722] ReverseTransform small improvement

---
 src/Processors/Transforms/ReverseTransform.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Processors/Transforms/ReverseTransform.cpp b/src/Processors/Transforms/ReverseTransform.cpp
index 98f2bf54aa5..66b774ab50d 100644
--- a/src/Processors/Transforms/ReverseTransform.cpp
+++ b/src/Processors/Transforms/ReverseTransform.cpp
@@ -6,11 +6,11 @@ namespace DB
 
 void ReverseTransform::transform(Chunk & chunk)
 {
-    IColumn::Permutation permutation;
-
     size_t num_rows = chunk.getNumRows();
+    IColumn::Permutation permutation(num_rows);
+
     for (size_t i = 0; i < num_rows; ++i)
-        permutation.emplace_back(num_rows - 1 - i);
+        permutation[i] = num_rows - 1 - i;
 
     auto columns = chunk.detachColumns();
 

From 1cbcd2f2ef4032cfb718433befbd8742c1e4b9cf Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 8 Jun 2023 13:39:05 +0200
Subject: [PATCH 254/722] Refactor reading from object storages

---
 src/Disks/IO/ReadBufferFromRemoteFSGather.cpp |  59 ++++++---
 src/Disks/IO/ReadBufferFromRemoteFSGather.h   |  10 +-
 src/Disks/IO/ReadBufferFromWebServer.h        |   2 -
 .../IO/ReadIndirectBufferFromRemoteFS.cpp     | 118 ------------------
 src/Disks/IO/ReadIndirectBufferFromRemoteFS.h |  46 -------
 .../AzureBlobStorage/AzureObjectStorage.cpp   |  44 ++++---
 .../AzureBlobStorage/AzureObjectStorage.h     |   1 -
 .../ObjectStorages/HDFS/HDFSObjectStorage.cpp |   8 +-
 .../Local/LocalObjectStorage.cpp              |  39 +++---
 .../ObjectStorages/S3/S3ObjectStorage.cpp     |  45 ++++---
 .../ObjectStorages/Web/WebObjectStorage.cpp   |  43 ++++---
 src/IO/SeekAvoidingReadBuffer.cpp             |  35 ------
 src/IO/SeekAvoidingReadBuffer.h               |  26 ----
 src/Storages/StorageS3.cpp                    |   2 +-
 14 files changed, 149 insertions(+), 329 deletions(-)
 delete mode 100644 src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
 delete mode 100644 src/Disks/IO/ReadIndirectBufferFromRemoteFS.h
 delete mode 100644 src/IO/SeekAvoidingReadBuffer.cpp
 delete mode 100644 src/IO/SeekAvoidingReadBuffer.h

diff --git a/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp b/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
index 04030fe5f8f..eb9c509e459 100644
--- a/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
+++ b/src/Disks/IO/ReadBufferFromRemoteFSGather.cpp
@@ -22,13 +22,15 @@ ReadBufferFromRemoteFSGather::ReadBufferFromRemoteFSGather(
     ReadBufferCreator && read_buffer_creator_,
     const StoredObjects & blobs_to_read_,
     const ReadSettings & settings_,
-    std::shared_ptr<FilesystemCacheLog> cache_log_)
-    : ReadBufferFromFileBase(0, nullptr, 0)
+    std::shared_ptr<FilesystemCacheLog> cache_log_,
+    bool use_external_buffer_)
+    : ReadBufferFromFileBase(use_external_buffer_ ? 0 : settings_.remote_fs_buffer_size, nullptr, 0)
     , settings(settings_)
     , blobs_to_read(blobs_to_read_)
     , read_buffer_creator(std::move(read_buffer_creator_))
     , cache_log(settings.enable_filesystem_cache_log ? cache_log_ : nullptr)
     , query_id(CurrentThread::isInitialized() && CurrentThread::get().getQueryContext() != nullptr ? CurrentThread::getQueryId() : "")
+    , use_external_buffer(use_external_buffer_)
     , log(&Poco::Logger::get("ReadBufferFromRemoteFSGather"))
 {
     if (!blobs_to_read.empty())
@@ -36,7 +38,9 @@ ReadBufferFromRemoteFSGather::ReadBufferFromRemoteFSGather(
 
     with_cache = settings.remote_fs_cache
         && settings.enable_filesystem_cache
-        && (!query_id.empty() || settings.read_from_filesystem_cache_if_exists_otherwise_bypass_cache || !settings.avoid_readthrough_cache_outside_query_context);
+        && (!query_id.empty()
+            || settings.read_from_filesystem_cache_if_exists_otherwise_bypass_cache
+            || !settings.avoid_readthrough_cache_outside_query_context);
 }
 
 SeekableReadBufferPtr ReadBufferFromRemoteFSGather::createImplementationBuffer(const StoredObject & object)
@@ -235,22 +239,49 @@ void ReadBufferFromRemoteFSGather::reset()
 
 off_t ReadBufferFromRemoteFSGather::seek(off_t offset, int whence)
 {
-    if (whence != SEEK_SET)
-        throw Exception(ErrorCodes::CANNOT_SEEK_THROUGH_FILE, "Only seeking with SEEK_SET is allowed");
+    if (offset == getPosition() && whence == SEEK_SET)
+        return offset;
+
+    if (whence != SEEK_SET)
+        throw Exception(ErrorCodes::CANNOT_SEEK_THROUGH_FILE, "Only SEEK_SET mode is allowed.");
+
+    if (use_external_buffer)
+    {
+        /// In case use_external_buffer == true, the buffer manages seeks itself.
+        reset();
+    }
+    else
+    {
+        if (!working_buffer.empty()
+            && static_cast<size_t>(offset) >= file_offset_of_buffer_end - working_buffer.size()
+            && static_cast<size_t>(offset) < file_offset_of_buffer_end)
+        {
+            pos = working_buffer.end() - (file_offset_of_buffer_end - offset);
+            assert(pos >= working_buffer.begin());
+            assert(pos < working_buffer.end());
+
+            return getPosition();
+        }
+
+        off_t position = getPosition();
+        if (current_buf && offset > position)
+        {
+            size_t diff = offset - position;
+            if (diff < settings.remote_read_min_bytes_for_seek)
+            {
+                ignore(diff);
+                return offset;
+            }
+        }
+
+        resetWorkingBuffer();
+        reset();
+    }
 
-    reset();
     file_offset_of_buffer_end = offset;
     return file_offset_of_buffer_end;
 }
 
-size_t ReadBufferFromRemoteFSGather::getImplementationBufferOffset() const
-{
-    if (!current_buf)
-        return file_offset_of_buffer_end;
-
-    return current_buf->getFileOffsetOfBufferEnd();
-}
-
 ReadBufferFromRemoteFSGather::~ReadBufferFromRemoteFSGather()
 {
     if (!with_cache)
diff --git a/src/Disks/IO/ReadBufferFromRemoteFSGather.h b/src/Disks/IO/ReadBufferFromRemoteFSGather.h
index 39b81d6f9ac..cb98ac6d9f3 100644
--- a/src/Disks/IO/ReadBufferFromRemoteFSGather.h
+++ b/src/Disks/IO/ReadBufferFromRemoteFSGather.h
@@ -27,7 +27,8 @@ public:
         ReadBufferCreator && read_buffer_creator_,
         const StoredObjects & blobs_to_read_,
         const ReadSettings & settings_,
-        std::shared_ptr<FilesystemCacheLog> cache_log_);
+        std::shared_ptr<FilesystemCacheLog> cache_log_,
+        bool use_external_buffer_);
 
     ~ReadBufferFromRemoteFSGather() override;
 
@@ -37,16 +38,14 @@ public:
 
     void setReadUntilPosition(size_t position) override;
 
+    void setReadUntilEnd() override { return setReadUntilPosition(getFileSize()); }
+
     IAsynchronousReader::Result readInto(char * data, size_t size, size_t offset, size_t ignore) override;
 
     size_t getFileSize() override { return getTotalSize(blobs_to_read); }
 
     size_t getFileOffsetOfBufferEnd() const override { return file_offset_of_buffer_end; }
 
-    bool initialized() const { return current_buf != nullptr; }
-
-    size_t getImplementationBufferOffset() const;
-
     off_t seek(off_t offset, int whence) override;
 
     off_t getPosition() override { return file_offset_of_buffer_end - available() + bytes_to_ignore; }
@@ -71,6 +70,7 @@ private:
     const ReadBufferCreator read_buffer_creator;
     const std::shared_ptr<FilesystemCacheLog> cache_log;
     const String query_id;
+    const bool use_external_buffer;
     bool with_cache;
 
     size_t read_until_position = 0;
diff --git a/src/Disks/IO/ReadBufferFromWebServer.h b/src/Disks/IO/ReadBufferFromWebServer.h
index dd9cf63224f..fa899cf2c5e 100644
--- a/src/Disks/IO/ReadBufferFromWebServer.h
+++ b/src/Disks/IO/ReadBufferFromWebServer.h
@@ -12,8 +12,6 @@ namespace DB
 
 /* Read buffer, which reads via http, but is used as ReadBufferFromFileBase.
  * Used to read files, hosted on a web server with static files.
- *
- * Usage: ReadIndirectBufferFromRemoteFS -> SeekAvoidingReadBuffer -> ReadBufferFromWebServer -> ReadWriteBufferFromHTTP.
  */
 class ReadBufferFromWebServer : public ReadBufferFromFileBase
 {
diff --git a/src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp b/src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
deleted file mode 100644
index a559b47f2cc..00000000000
--- a/src/Disks/IO/ReadIndirectBufferFromRemoteFS.cpp
+++ /dev/null
@@ -1,118 +0,0 @@
-#include "ReadIndirectBufferFromRemoteFS.h"
-
-#include <Disks/IO/ReadBufferFromRemoteFSGather.h>
-
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int CANNOT_SEEK_THROUGH_FILE;
-}
-
-
-ReadIndirectBufferFromRemoteFS::ReadIndirectBufferFromRemoteFS(
-    std::shared_ptr<ReadBufferFromRemoteFSGather> impl_, const ReadSettings & settings)
-    : ReadBufferFromFileBase(settings.remote_fs_buffer_size, nullptr, 0)
-    , impl(impl_)
-    , read_settings(settings)
-{
-}
-
-size_t ReadIndirectBufferFromRemoteFS::getFileSize()
-{
-    return impl->getFileSize();
-}
-
-off_t ReadIndirectBufferFromRemoteFS::getPosition()
-{
-    return impl->file_offset_of_buffer_end - available();
-}
-
-
-String ReadIndirectBufferFromRemoteFS::getFileName() const
-{
-    return impl->getFileName();
-}
-
-
-void ReadIndirectBufferFromRemoteFS::setReadUntilPosition(size_t position)
-{
-    impl->setReadUntilPosition(position);
-}
-
-
-void ReadIndirectBufferFromRemoteFS::setReadUntilEnd()
-{
-    impl->setReadUntilPosition(impl->getFileSize());
-}
-
-
-off_t ReadIndirectBufferFromRemoteFS::seek(off_t offset_, int whence)
-{
-    if (whence == SEEK_CUR)
-    {
-        /// If position within current working buffer - shift pos.
-        if (!working_buffer.empty() && size_t(getPosition() + offset_) < impl->file_offset_of_buffer_end)
-        {
-            pos += offset_;
-            return getPosition();
-        }
-        else
-        {
-            impl->file_offset_of_buffer_end += offset_;
-        }
-    }
-    else if (whence == SEEK_SET)
-    {
-        /// If position within current working buffer - shift pos.
-        if (!working_buffer.empty()
-            && size_t(offset_) >= impl->file_offset_of_buffer_end - working_buffer.size()
-            && size_t(offset_) < impl->file_offset_of_buffer_end)
-        {
-            pos = working_buffer.end() - (impl->file_offset_of_buffer_end - offset_);
-            return getPosition();
-        }
-        else
-        {
-            impl->file_offset_of_buffer_end = offset_;
-        }
-    }
-    else
-        throw Exception(ErrorCodes::CANNOT_SEEK_THROUGH_FILE, "Only SEEK_SET or SEEK_CUR modes are allowed.");
-
-    impl->seek(impl->file_offset_of_buffer_end, SEEK_SET);
-    resetWorkingBuffer();
-
-    file_offset_of_buffer_end = impl->file_offset_of_buffer_end;
-    return impl->file_offset_of_buffer_end;
-}
-
-
-bool ReadIndirectBufferFromRemoteFS::nextImpl()
-{
-    chassert(internal_buffer.size() == read_settings.remote_fs_buffer_size);
-    chassert(file_offset_of_buffer_end <= impl->getFileSize());
-
-    auto [size, offset, _] = impl->readInto(internal_buffer.begin(), internal_buffer.size(), file_offset_of_buffer_end, /* ignore */0);
-
-    chassert(offset <= size);
-    chassert(size <= internal_buffer.size());
-
-    size_t bytes_read = size - offset;
-    if (bytes_read)
-        working_buffer = Buffer(internal_buffer.begin() + offset, internal_buffer.begin() + size);
-
-    file_offset_of_buffer_end = impl->getFileOffsetOfBufferEnd();
-
-    /// In case of multiple files for the same file in clickhouse (i.e. log family)
-    /// file_offset_of_buffer_end will not match getImplementationBufferOffset()
-    /// so we use [impl->getImplementationBufferOffset(), impl->getFileSize()]
-    chassert(file_offset_of_buffer_end >= impl->getImplementationBufferOffset());
-    chassert(file_offset_of_buffer_end <= impl->getFileSize());
-
-    return bytes_read;
-}
-
-}
diff --git a/src/Disks/IO/ReadIndirectBufferFromRemoteFS.h b/src/Disks/IO/ReadIndirectBufferFromRemoteFS.h
deleted file mode 100644
index 19647b1fa39..00000000000
--- a/src/Disks/IO/ReadIndirectBufferFromRemoteFS.h
+++ /dev/null
@@ -1,46 +0,0 @@
-#pragma once
-
-#include "config.h"
-#include <IO/ReadBufferFromFile.h>
-#include <IO/ReadSettings.h>
-#include <utility>
-
-
-namespace DB
-{
-
-class ReadBufferFromRemoteFSGather;
-
-/**
-* Reads data from S3/HDFS/Web using stored paths in metadata.
-* There is asynchronous version of this class -- AsynchronousReadIndirectBufferFromRemoteFS.
-*/
-class ReadIndirectBufferFromRemoteFS : public ReadBufferFromFileBase
-{
-
-public:
-    explicit ReadIndirectBufferFromRemoteFS(std::shared_ptr<ReadBufferFromRemoteFSGather> impl_, const ReadSettings & settings);
-
-    off_t seek(off_t offset_, int whence) override;
-
-    off_t getPosition() override;
-
-    String getFileName() const override;
-
-    void setReadUntilPosition(size_t position) override;
-
-    void setReadUntilEnd() override;
-
-    size_t getFileSize() override;
-
-private:
-    bool nextImpl() override;
-
-    std::shared_ptr<ReadBufferFromRemoteFSGather> impl;
-
-    ReadSettings read_settings;
-
-    size_t file_offset_of_buffer_end = 0;
-};
-
-}
diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
index 23a0da39dd3..3636c5780fb 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.cpp
@@ -6,7 +6,6 @@
 #include <Common/getRandomASCIIString.h>
 #include <Disks/IO/ReadBufferFromAzureBlobStorage.h>
 #include <Disks/IO/WriteBufferFromAzureBlobStorage.h>
-#include <IO/SeekAvoidingReadBuffer.h>
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
 #include <Disks/IO/AsynchronousBoundedReadBuffer.h>
 
@@ -218,24 +217,33 @@ std::unique_ptr<ReadBufferFromFileBase> AzureObjectStorage::readObjects( /// NOL
             read_until_position);
     };
 
-    auto reader_impl = std::make_unique<ReadBufferFromRemoteFSGather>(
-        std::move(read_buffer_creator),
-        objects,
-        disk_read_settings,
-        global_context->getFilesystemCacheLog());
+    switch (read_settings.remote_fs_method)
+    {
+        case RemoteFSReadMethod::read:
+        {
+            return std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator),
+                objects,
+                disk_read_settings,
+                global_context->getFilesystemCacheLog(),
+                /* use_external_buffer */false);
 
-    if (disk_read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
-    {
-        auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
-        return std::make_unique<AsynchronousBoundedReadBuffer>(
-            std::move(reader_impl), reader, disk_read_settings,
-            global_context->getAsyncReadCounters(),
-            global_context->getFilesystemReadPrefetchesLog());
-    }
-    else
-    {
-        auto buf = std::make_unique<ReadIndirectBufferFromRemoteFS>(std::move(reader_impl), disk_read_settings);
-        return std::make_unique<SeekAvoidingReadBuffer>(std::move(buf), settings_ptr->min_bytes_for_seek);
+        }
+        case RemoteFSReadMethod::threadpool:
+        {
+            auto impl = std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator),
+                objects,
+                disk_read_settings,
+                global_context->getFilesystemCacheLog(),
+                /* use_external_buffer */true);
+
+            auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
+            return std::make_unique<AsynchronousBoundedReadBuffer>(
+                std::move(impl), reader, disk_read_settings,
+                global_context->getAsyncReadCounters(),
+                global_context->getFilesystemReadPrefetchesLog());
+        }
     }
 }
 
diff --git a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
index 5b08ceb80e3..2fbd1514abd 100644
--- a/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
+++ b/src/Disks/ObjectStorages/AzureBlobStorage/AzureObjectStorage.h
@@ -5,7 +5,6 @@
 
 #include <Disks/ObjectStorages/DiskObjectStorageCommon.h>
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
-#include <Disks/IO/ReadIndirectBufferFromRemoteFS.h>
 #include <Disks/ObjectStorages/IObjectStorage.h>
 #include <Common/MultiVersion.h>
 
diff --git a/src/Disks/ObjectStorages/HDFS/HDFSObjectStorage.cpp b/src/Disks/ObjectStorages/HDFS/HDFSObjectStorage.cpp
index a3092bc6f12..60230ce2fb0 100644
--- a/src/Disks/ObjectStorages/HDFS/HDFSObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/HDFS/HDFSObjectStorage.cpp
@@ -1,13 +1,10 @@
 #include <Disks/ObjectStorages/HDFS/HDFSObjectStorage.h>
 
-#include <IO/SeekAvoidingReadBuffer.h>
 #include <IO/copyData.h>
-
 #include <Storages/HDFS/WriteBufferFromHDFS.h>
 #include <Storages/HDFS/HDFSCommon.h>
 
 #include <Storages/HDFS/ReadBufferFromHDFS.h>
-#include <Disks/IO/ReadIndirectBufferFromRemoteFS.h>
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
 #include <Common/getRandomASCIIString.h>
 
@@ -72,9 +69,8 @@ std::unique_ptr<ReadBufferFromFileBase> HDFSObjectStorage::readObjects( /// NOLI
             hdfs_uri, hdfs_path, config, disk_read_settings, /* read_until_position */0, /* use_external_buffer */true);
     };
 
-    auto hdfs_impl = std::make_unique<ReadBufferFromRemoteFSGather>(std::move(read_buffer_creator), objects, disk_read_settings, nullptr);
-    auto buf = std::make_unique<ReadIndirectBufferFromRemoteFS>(std::move(hdfs_impl), read_settings);
-    return std::make_unique<SeekAvoidingReadBuffer>(std::move(buf), settings->min_bytes_for_seek);
+    return std::make_unique<ReadBufferFromRemoteFSGather>(
+        std::move(read_buffer_creator), objects, disk_read_settings, nullptr, /* use_external_buffer */false);
 }
 
 std::unique_ptr<WriteBufferFromFileBase> HDFSObjectStorage::writeObject( /// NOLINT
diff --git a/src/Disks/ObjectStorages/Local/LocalObjectStorage.cpp b/src/Disks/ObjectStorages/Local/LocalObjectStorage.cpp
index 05c0c8f3961..69ccf309096 100644
--- a/src/Disks/ObjectStorages/Local/LocalObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/Local/LocalObjectStorage.cpp
@@ -4,11 +4,9 @@
 #include <Interpreters/Context.h>
 #include <Common/filesystemHelpers.h>
 #include <Common/logger_useful.h>
-#include <Disks/IO/ReadIndirectBufferFromRemoteFS.h>
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
 #include <Disks/IO/createReadBufferFromFileBase.h>
 #include <Disks/IO/AsynchronousBoundedReadBuffer.h>
-#include <IO/SeekAvoidingReadBuffer.h>
 #include <IO/WriteBufferFromFile.h>
 #include <IO/copyData.h>
 #include <Common/getRandomASCIIString.h>
@@ -59,25 +57,26 @@ std::unique_ptr<ReadBufferFromFileBase> LocalObjectStorage::readObjects( /// NOL
         return createReadBufferFromFileBase(file_path, modified_settings, read_hint, file_size);
     };
 
-    auto impl = std::make_unique<ReadBufferFromRemoteFSGather>(
-        std::move(read_buffer_creator), objects, modified_settings,
-        global_context->getFilesystemCacheLog());
+    switch (read_settings.remote_fs_method)
+    {
+        case RemoteFSReadMethod::read:
+        {
+            return std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator), objects, modified_settings,
+                global_context->getFilesystemCacheLog(), /* use_external_buffer */false);
+        }
+        case RemoteFSReadMethod::threadpool:
+        {
+            auto impl = std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator), objects, modified_settings,
+                global_context->getFilesystemCacheLog(), /* use_external_buffer */true);
 
-    /// We use `remove_fs_method` (not `local_fs_method`) because we are about to use
-    /// AsynchronousBoundedReadBuffer which works by the remote_fs_* settings.
-    if (modified_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
-    {
-        auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
-        return std::make_unique<AsynchronousBoundedReadBuffer>(
-            std::move(impl), reader, modified_settings,
-            global_context->getAsyncReadCounters(),
-            global_context->getFilesystemReadPrefetchesLog());
-    }
-    else
-    {
-        auto buf = std::make_unique<ReadIndirectBufferFromRemoteFS>(std::move(impl), modified_settings);
-        return std::make_unique<SeekAvoidingReadBuffer>(
-            std::move(buf), modified_settings.remote_read_min_bytes_for_seek);
+            auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
+            return std::make_unique<AsynchronousBoundedReadBuffer>(
+                std::move(impl), reader, read_settings,
+                global_context->getAsyncReadCounters(),
+                global_context->getFilesystemReadPrefetchesLog());
+        }
     }
 }
 
diff --git a/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp b/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
index d19be20f920..e48924326e1 100644
--- a/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/S3/S3ObjectStorage.cpp
@@ -8,11 +8,9 @@
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
 #include <Disks/ObjectStorages/DiskObjectStorageCommon.h>
 #include <Disks/IO/AsynchronousBoundedReadBuffer.h>
-#include <Disks/IO/ReadIndirectBufferFromRemoteFS.h>
 #include <Disks/IO/ThreadPoolRemoteFSReader.h>
 #include <IO/WriteBufferFromS3.h>
 #include <IO/ReadBufferFromS3.h>
-#include <IO/SeekAvoidingReadBuffer.h>
 #include <IO/S3/getObjectInfo.h>
 #include <IO/S3/copyS3File.h>
 #include <Interpreters/Context.h>
@@ -182,24 +180,33 @@ std::unique_ptr<ReadBufferFromFileBase> S3ObjectStorage::readObjects( /// NOLINT
             /* restricted_seek */true);
     };
 
-    auto s3_impl = std::make_unique<ReadBufferFromRemoteFSGather>(
-        std::move(read_buffer_creator),
-        objects,
-        disk_read_settings,
-        global_context->getFilesystemCacheLog());
+    switch (read_settings.remote_fs_method)
+    {
+        case RemoteFSReadMethod::read:
+        {
+            return std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator),
+                objects,
+                disk_read_settings,
+                global_context->getFilesystemCacheLog(),
+                /* use_external_buffer */false);
 
-    if (read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
-    {
-        auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
-        return std::make_unique<AsynchronousBoundedReadBuffer>(
-            std::move(s3_impl), reader, disk_read_settings,
-            global_context->getAsyncReadCounters(),
-            global_context->getFilesystemReadPrefetchesLog());
-    }
-    else
-    {
-        auto buf = std::make_unique<ReadIndirectBufferFromRemoteFS>(std::move(s3_impl), disk_read_settings);
-        return std::make_unique<SeekAvoidingReadBuffer>(std::move(buf), settings_ptr->min_bytes_for_seek);
+        }
+        case RemoteFSReadMethod::threadpool:
+        {
+            auto impl = std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator),
+                objects,
+                disk_read_settings,
+                global_context->getFilesystemCacheLog(),
+                /* use_external_buffer */true);
+
+            auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
+            return std::make_unique<AsynchronousBoundedReadBuffer>(
+                std::move(impl), reader, disk_read_settings,
+                global_context->getAsyncReadCounters(),
+                global_context->getFilesystemReadPrefetchesLog());
+        }
     }
 }
 
diff --git a/src/Disks/ObjectStorages/Web/WebObjectStorage.cpp b/src/Disks/ObjectStorages/Web/WebObjectStorage.cpp
index 4f34f3eed9c..690a0d3372c 100644
--- a/src/Disks/ObjectStorages/Web/WebObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/Web/WebObjectStorage.cpp
@@ -4,11 +4,9 @@
 #include <Common/escapeForFileName.h>
 
 #include <IO/ReadWriteBufferFromHTTP.h>
-#include <IO/SeekAvoidingReadBuffer.h>
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
 
-#include <Disks/IO/ReadIndirectBufferFromRemoteFS.h>
 #include <Disks/IO/AsynchronousBoundedReadBuffer.h>
 #include <Disks/IO/ReadBufferFromRemoteFSGather.h>
 #include <Disks/IO/ReadBufferFromWebServer.h>
@@ -181,24 +179,33 @@ std::unique_ptr<ReadBufferFromFileBase> WebObjectStorage::readObject( /// NOLINT
      };
 
     auto global_context = Context::getGlobalContextInstance();
-    auto web_impl = std::make_unique<ReadBufferFromRemoteFSGather>(
-        std::move(read_buffer_creator),
-        StoredObjects{object},
-        read_settings,
-        global_context->getFilesystemCacheLog());
 
-    if (read_settings.remote_fs_method == RemoteFSReadMethod::threadpool)
+    switch (read_settings.remote_fs_method)
     {
-        auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
-        return std::make_unique<AsynchronousBoundedReadBuffer>(
-            std::move(web_impl), reader, read_settings,
-            global_context->getAsyncReadCounters(),
-            global_context->getFilesystemReadPrefetchesLog());
-    }
-    else
-    {
-        auto buf = std::make_unique<ReadIndirectBufferFromRemoteFS>(std::move(web_impl), read_settings);
-        return std::make_unique<SeekAvoidingReadBuffer>(std::move(buf), min_bytes_for_seek);
+        case RemoteFSReadMethod::read:
+        {
+            return std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator),
+                StoredObjects{object},
+                read_settings,
+                global_context->getFilesystemCacheLog(),
+                /* use_external_buffer */false);
+        }
+        case RemoteFSReadMethod::threadpool:
+        {
+            auto impl = std::make_unique<ReadBufferFromRemoteFSGather>(
+                std::move(read_buffer_creator),
+                StoredObjects{object},
+                read_settings,
+                global_context->getFilesystemCacheLog(),
+                /* use_external_buffer */true);
+
+            auto & reader = global_context->getThreadPoolReader(FilesystemReaderType::ASYNCHRONOUS_REMOTE_FS_READER);
+            return std::make_unique<AsynchronousBoundedReadBuffer>(
+                std::move(impl), reader, read_settings,
+                global_context->getAsyncReadCounters(),
+                global_context->getFilesystemReadPrefetchesLog());
+        }
     }
 }
 
diff --git a/src/IO/SeekAvoidingReadBuffer.cpp b/src/IO/SeekAvoidingReadBuffer.cpp
deleted file mode 100644
index 4d6406d8ddf..00000000000
--- a/src/IO/SeekAvoidingReadBuffer.cpp
+++ /dev/null
@@ -1,35 +0,0 @@
-#include <IO/SeekAvoidingReadBuffer.h>
-
-
-namespace DB
-{
-
-SeekAvoidingReadBuffer::SeekAvoidingReadBuffer(std::unique_ptr<ReadBufferFromFileBase> impl_, UInt64 min_bytes_for_seek_)
-    : ReadBufferFromFileDecorator(std::move(impl_))
-    , min_bytes_for_seek(min_bytes_for_seek_)
-{
-}
-
-
-off_t SeekAvoidingReadBuffer::seek(off_t off, int whence)
-{
-    off_t position = getPosition();
-
-    if (whence == SEEK_CUR)
-    {
-        off += position;
-        whence = SEEK_SET;
-    }
-
-    if (whence == SEEK_SET && off >= position && off < position + static_cast<off_t>(min_bytes_for_seek))
-    {
-        swap(*impl);
-        impl->ignore(off - position);
-        swap(*impl);
-        return off;
-    }
-
-    return ReadBufferFromFileDecorator::seek(off, whence);
-}
-
-}
diff --git a/src/IO/SeekAvoidingReadBuffer.h b/src/IO/SeekAvoidingReadBuffer.h
deleted file mode 100644
index 716d7c5046c..00000000000
--- a/src/IO/SeekAvoidingReadBuffer.h
+++ /dev/null
@@ -1,26 +0,0 @@
-#pragma once
-
-#include <IO/ReadBufferFromFileDecorator.h>
-
-
-namespace DB
-{
-
-/// `SeekAvoidingReadBuffer` prefers sequential reads over seeks within specified window.
-/// It is useful in network and spinning disk storage media when seek is relatively expensive
-/// operation.
-/// See also: `merge_tree_min_rows_for_seek`.
-class SeekAvoidingReadBuffer : public ReadBufferFromFileDecorator
-{
-public:
-    SeekAvoidingReadBuffer(std::unique_ptr<ReadBufferFromFileBase> impl_, UInt64 min_bytes_for_seek_);
-
-    off_t seek(off_t off, int whence) override;
-
-    void prefetch(Priority priority) override { impl->prefetch(priority); }
-
-private:
-    UInt64 min_bytes_for_seek; /// Minimum positive seek offset which shall be executed using seek operation.
-};
-
-}
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index c3ed0f1af16..8bab596901c 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -657,7 +657,7 @@ std::unique_ptr<ReadBuffer> StorageS3Source::createAsyncS3ReadBuffer(
         std::move(read_buffer_creator),
         StoredObjects{StoredObject{key, object_size}},
         read_settings,
-        /* cache_log */nullptr);
+        /* cache_log */nullptr, /* use_external_buffer */true);
 
     auto modified_settings{read_settings};
     /// FIXME: Changing this setting to default value breaks something around parquet reading

From 48e1b21aabd8ef642c1bcab7ba863f8c61123723 Mon Sep 17 00:00:00 2001
From: kevinyhzou <kevinyunhe8@gmail.com>
Date: Thu, 8 Jun 2023 20:34:30 +0800
Subject: [PATCH 255/722] Add feature to support read csv by space & tab
 delimiter

---
 src/Core/Settings.h                           |  1 +
 src/Formats/FormatFactory.cpp                 |  1 +
 src/Formats/FormatSettings.h                  |  1 +
 .../Formats/Impl/CSVRowInputFormat.cpp        | 36 ++++++++++---------
 ...h_whitespace_tab_field_delimiter.reference |  2 ++
 ...ext_with_whitespace_tab_field_delimiter.sh | 18 ++++++++++
 .../data_csv/csv_with_space_delimiter.csv     |  1 +
 .../data_csv/csv_with_tab_delimiter.csv       |  1 +
 8 files changed, 45 insertions(+), 16 deletions(-)
 create mode 100644 tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference
 create mode 100755 tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
 create mode 100644 tests/queries/0_stateless/data_csv/csv_with_space_delimiter.csv
 create mode 100644 tests/queries/0_stateless/data_csv/csv_with_tab_delimiter.csv

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index a87e321bed2..45641e76689 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -850,6 +850,7 @@ class IColumn;
     M(Bool, input_format_csv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in CSV format", 0) \
     M(Bool, input_format_tsv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in TSV format", 0) \
     M(Bool, input_format_csv_detect_header, true, "Automatically detect header with names and types in CSV format", 0) \
+    M(Bool, input_format_csv_skip_whitespaces_tabs, true, "Skips spaces and tabs(\\t) characters in the CSV strings", 0) \
     M(Bool, input_format_csv_trim_whitespaces, true, "Trims spaces and tabs (\\t) characters at the beginning and end in CSV strings", 0) \
     M(Bool, input_format_tsv_detect_header, true, "Automatically detect header with names and types in TSV format", 0) \
     M(Bool, input_format_custom_detect_header, true, "Automatically detect header with names and types in CustomSeparated format", 0) \
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index 39b28e025a6..73a7d4f73f2 100644
--- a/src/Formats/FormatFactory.cpp
+++ b/src/Formats/FormatFactory.cpp
@@ -70,6 +70,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.csv.skip_first_lines = settings.input_format_csv_skip_first_lines;
     format_settings.csv.try_detect_header = settings.input_format_csv_detect_header;
     format_settings.csv.trim_whitespaces = settings.input_format_csv_trim_whitespaces;
+    format_settings.csv.skip_whitespaces_tabs = settings.input_format_csv_skip_whitespaces_tabs;
     format_settings.hive_text.fields_delimiter = settings.input_format_hive_text_fields_delimiter;
     format_settings.hive_text.collection_items_delimiter = settings.input_format_hive_text_collection_items_delimiter;
     format_settings.hive_text.map_keys_delimiter = settings.input_format_hive_text_map_keys_delimiter;
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index 6b4caffbf43..434389e31a1 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -137,6 +137,7 @@ struct FormatSettings
         String custom_delimiter;
         bool try_detect_header = true;
         bool trim_whitespaces = true;
+        bool skip_whitespaces_tabs = true;
     } csv;
 
     struct HiveText
diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index 8b4dbbffe1d..4094285e1ad 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -25,10 +25,10 @@ namespace ErrorCodes
 
 namespace
 {
-    void checkBadDelimiter(char delimiter)
+    void checkBadDelimiter(char delimiter, bool skip_whitespaces_tabs)
     {
         constexpr std::string_view bad_delimiters = " \t\"'.UL";
-        if (bad_delimiters.find(delimiter) != std::string_view::npos)
+        if (bad_delimiters.find(delimiter) != std::string_view::npos && skip_whitespaces_tabs)
             throw Exception(
                 ErrorCodes::BAD_ARGUMENTS,
                 "CSV format may not work correctly with delimiter '{}'. Try use CustomSeparated format instead",
@@ -68,7 +68,7 @@ CSVRowInputFormat::CSVRowInputFormat(
         format_settings_.csv.try_detect_header),
     buf(std::move(in_))
 {
-    checkBadDelimiter(format_settings_.csv.delimiter);
+    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.skip_whitespaces_tabs);
 }
 
 CSVRowInputFormat::CSVRowInputFormat(
@@ -90,7 +90,7 @@ CSVRowInputFormat::CSVRowInputFormat(
         format_settings_.csv.try_detect_header),
     buf(std::move(in_))
 {
-    checkBadDelimiter(format_settings_.csv.delimiter);
+    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.skip_whitespaces_tabs);
 }
 
 void CSVRowInputFormat::syncAfterError()
@@ -134,8 +134,12 @@ static void skipEndOfLine(ReadBuffer & in)
 }
 
 /// Skip `whitespace` symbols allowed in CSV.
-static inline void skipWhitespacesAndTabs(ReadBuffer & in)
+static inline void skipWhitespacesAndTabs(ReadBuffer & in, const bool & skip_whitespaces_tabs)
 {
+    if (!skip_whitespaces_tabs)
+    {
+        return;
+    }
     while (!in.eof() && (*in.position() == ' ' || *in.position() == '\t'))
         ++in.position();
 }
@@ -146,7 +150,7 @@ CSVFormatReader::CSVFormatReader(PeekableReadBuffer & buf_, const FormatSettings
 
 void CSVFormatReader::skipFieldDelimiter()
 {
-    skipWhitespacesAndTabs(*buf);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
     assertChar(format_settings.csv.delimiter, *buf);
 }
 
@@ -154,7 +158,7 @@ template <bool read_string>
 String CSVFormatReader::readCSVFieldIntoString()
 {
     if (format_settings.csv.trim_whitespaces) [[likely]]
-        skipWhitespacesAndTabs(*buf);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
 
     String field;
     if constexpr (read_string)
@@ -166,14 +170,14 @@ String CSVFormatReader::readCSVFieldIntoString()
 
 void CSVFormatReader::skipField()
 {
-    skipWhitespacesAndTabs(*buf);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
     NullOutput out;
     readCSVStringInto(out, *buf, format_settings.csv);
 }
 
 void CSVFormatReader::skipRowEndDelimiter()
 {
-    skipWhitespacesAndTabs(*buf);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
 
     if (buf->eof())
         return;
@@ -182,7 +186,7 @@ void CSVFormatReader::skipRowEndDelimiter()
     if (*buf->position() == format_settings.csv.delimiter)
         ++buf->position();
 
-    skipWhitespacesAndTabs(*buf);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
     if (buf->eof())
         return;
 
@@ -194,7 +198,7 @@ void CSVFormatReader::skipHeaderRow()
     do
     {
         skipField();
-        skipWhitespacesAndTabs(*buf);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
     } while (checkChar(format_settings.csv.delimiter, *buf));
 
     skipRowEndDelimiter();
@@ -207,7 +211,7 @@ std::vector<String> CSVFormatReader::readRowImpl()
     do
     {
         fields.push_back(readCSVFieldIntoString<is_header>());
-        skipWhitespacesAndTabs(*buf);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
     } while (checkChar(format_settings.csv.delimiter, *buf));
 
     skipRowEndDelimiter();
@@ -220,7 +224,7 @@ bool CSVFormatReader::parseFieldDelimiterWithDiagnosticInfo(WriteBuffer & out)
 
     try
     {
-        skipWhitespacesAndTabs(*buf);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
         assertChar(delimiter, *buf);
     }
     catch (const DB::Exception &)
@@ -246,7 +250,7 @@ bool CSVFormatReader::parseFieldDelimiterWithDiagnosticInfo(WriteBuffer & out)
 
 bool CSVFormatReader::parseRowEndWithDiagnosticInfo(WriteBuffer & out)
 {
-    skipWhitespacesAndTabs(*buf);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
 
     if (buf->eof())
         return true;
@@ -255,7 +259,7 @@ bool CSVFormatReader::parseRowEndWithDiagnosticInfo(WriteBuffer & out)
     if (*buf->position() == format_settings.csv.delimiter)
     {
         ++buf->position();
-        skipWhitespacesAndTabs(*buf);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
         if (buf->eof())
             return true;
     }
@@ -283,7 +287,7 @@ bool CSVFormatReader::readField(
     const String & /*column_name*/)
 {
     if (format_settings.csv.trim_whitespaces || !isStringOrFixedString(removeNullable(type))) [[likely]]
-        skipWhitespacesAndTabs(*buf);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
 
     const bool at_delimiter = !buf->eof() && *buf->position() == format_settings.csv.delimiter;
     const bool at_last_column_line_end = is_last_file_column && (buf->eof() || *buf->position() == '\n' || *buf->position() == '\r');
diff --git a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference
new file mode 100644
index 00000000000..531391394a7
--- /dev/null
+++ b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference
@@ -0,0 +1,2 @@
+1 a b
+2 c d
diff --git a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
new file mode 100755
index 00000000000..19d343c352f
--- /dev/null
+++ b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+# NOTE: this sh wrapper is required because of shell_config
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+$CLICKHOUSE_CLIENT -q "drop table if exists test_whitespace"
+$CLICKHOUSE_CLIENT -q "drop table if exists test_tab"
+$CLICKHOUSE_CLIENT -q "create table test_whitespace (x UInt32, y String, z String) engine=MergeTree order by x"
+$CLICKHOUSE_CLIENT -q "create table test_tab (x UInt32, y String, z String) engine=MergeTree order by x"
+$CUR_DIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
+$CUR_DIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
+$CLICKHOUSE_CLIENT -q "select * from test_whitespace"
+$CLICKHOUSE_CLIENT -q "select * from test_tab"
+$CLICKHOUSE_CLIENT -q "drop table test_whitespace"
+$CLICKHOUSE_CLIENT -q "drop table test_tab"; 
diff --git a/tests/queries/0_stateless/data_csv/csv_with_space_delimiter.csv b/tests/queries/0_stateless/data_csv/csv_with_space_delimiter.csv
new file mode 100644
index 00000000000..967f8ae450e
--- /dev/null
+++ b/tests/queries/0_stateless/data_csv/csv_with_space_delimiter.csv
@@ -0,0 +1 @@
+1 a b
diff --git a/tests/queries/0_stateless/data_csv/csv_with_tab_delimiter.csv b/tests/queries/0_stateless/data_csv/csv_with_tab_delimiter.csv
new file mode 100644
index 00000000000..f3b63950ea8
--- /dev/null
+++ b/tests/queries/0_stateless/data_csv/csv_with_tab_delimiter.csv
@@ -0,0 +1 @@
+2	c	d

From f4202963ad04f52da3aa0ada96c6151cfadd4a69 Mon Sep 17 00:00:00 2001
From: kevinyhzou <kevinyunhe8@gmail.com>
Date: Thu, 8 Jun 2023 21:06:38 +0800
Subject: [PATCH 256/722] test modify

---
 .../02785_text_with_whitespace_tab_field_delimiter.sh         | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
index 19d343c352f..e3f61262674 100755
--- a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
+++ b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
@@ -10,8 +10,8 @@ $CLICKHOUSE_CLIENT -q "drop table if exists test_whitespace"
 $CLICKHOUSE_CLIENT -q "drop table if exists test_tab"
 $CLICKHOUSE_CLIENT -q "create table test_whitespace (x UInt32, y String, z String) engine=MergeTree order by x"
 $CLICKHOUSE_CLIENT -q "create table test_tab (x UInt32, y String, z String) engine=MergeTree order by x"
-$CUR_DIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
-$CUR_DIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
+cat $CURDIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
+cat $CURDIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
 $CLICKHOUSE_CLIENT -q "select * from test_whitespace"
 $CLICKHOUSE_CLIENT -q "select * from test_tab"
 $CLICKHOUSE_CLIENT -q "drop table test_whitespace"

From fa877f456185b5de5b5f2e36e775acdb8dec7f31 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 8 Jun 2023 16:05:14 +0200
Subject: [PATCH 257/722] cosmetic changes

---
 src/Common/DateLUT.h   |  2 +-
 src/Common/LocalDate.h | 13 +++++--------
 2 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index 23698331afe..833b2291254 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -39,7 +39,7 @@ public:
 
             /// Timezone is passed in query_context, but on CH-Client we have no query context,
             /// and each time we modify client's global context
-            const auto global_context = DB::CurrentThread::get().getGlobalContext();
+            const DB::ContextPtr global_context = DB::CurrentThread::get().getGlobalContext();
             if (global_context)
             {
                 context_timezone = extractTimezoneFromContext(global_context);
diff --git a/src/Common/LocalDate.h b/src/Common/LocalDate.h
index 4a383129ae4..2331a40fd12 100644
--- a/src/Common/LocalDate.h
+++ b/src/Common/LocalDate.h
@@ -24,9 +24,8 @@ private:
     unsigned char m_month;
     unsigned char m_day;
 
-    void init(time_t time)
+    void init(time_t time, const DateLUTImpl & date_lut)
     {
-        const auto & date_lut = DateLUT::instance();
         const auto & values = date_lut.getValues(time);
 
         m_year = values.year;
@@ -56,9 +55,9 @@ private:
     }
 
 public:
-    explicit LocalDate(time_t time)
+    explicit LocalDate(time_t time, const DateLUTImpl & time_zone = DateLUT::instance())
     {
-        init(time);
+        init(time, time_zone);
     }
 
     LocalDate(DayNum day_num, const DateLUTImpl & time_zone = DateLUT::instance()) /// NOLINT
@@ -99,15 +98,13 @@ public:
     LocalDate(const LocalDate &) noexcept = default;
     LocalDate & operator= (const LocalDate &) noexcept = default;
 
-    DayNum getDayNum() const
+    DayNum getDayNum(const DateLUTImpl & lut = DateLUT::instance()) const
     {
-        const auto & lut = DateLUT::instance();
         return DayNum(lut.makeDayNum(m_year, m_month, m_day).toUnderType());
     }
 
-    ExtendedDayNum  getExtenedDayNum() const
+    ExtendedDayNum getExtenedDayNum(const DateLUTImpl & lut = DateLUT::instance()) const
     {
-        const auto & lut = DateLUT::instance();
         return ExtendedDayNum (lut.makeDayNum(m_year, m_month, m_day).toUnderType());
     }
 

From 9f61c786ed67ae571384f90ef934bb839ab20e0a Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 8 Jun 2023 17:25:53 +0300
Subject: [PATCH 258/722] Amend the tests

---
 ...3_parseDateTimeBestEffort_syslog.reference | 21 +---
 .../02783_parseDateTimeBestEffort_syslog.sql  | 97 ++++++-------------
 2 files changed, 34 insertions(+), 84 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
index 7409b413260..63e7e367941 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
@@ -1,20 +1,5 @@
 parseDateTimeBestEffort
- dt_ref                            res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc
+ dt_ref                            res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc                res_us            res_us_sam            res_us_auc           res_us_null       res_us_null_sam       res_us_null_auc           res_us_zero       res_us_zero_sam       res_us_zero_auc                     res64                 res64_sam                 res64_auc                res64_null            res64_null_sam            res64_null_auc                res64_zero            res64_zero_sam            res64_zero_auc                  res64_us              res64_us_sam              res64_us_auc             res64_us_null         res64_us_null_sam         res64_us_null_auc             res64_us_zero         res64_us_zero_sam         res64_us_zero_auc
 
- Jun  7 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00 
- Jun  7 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00 
-parseDateTimeBestEffortUS
- dt_ref                            res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc
-
- Jun  7 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00   2023-06-07 04:55:00   2022-06-07 04:55:00   2023-06-07 04:55:00 
- Jun  7 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00   2022-06-07 04:56:00   2022-06-07 04:56:00   2023-06-07 04:56:00 
-parseDateTime64BestEffort
- dt_ref                                res                   res_sam                   res_auc                  res_null              res_null_sam              res_null_auc                  res_zero              res_zero_sam              res_zero_auc
-
- Jun  7 04:55:00   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000 
- Jun  7 04:56:00   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000 
-parseDateTime64BestEffortUS
- dt_ref                                res                   res_sam                   res_auc                  res_null              res_null_sam              res_null_auc                  res_zero              res_zero_sam              res_zero_auc
-
- Jun  7 04:55:00   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000   2023-06-07 04:55:00.000   2022-06-07 04:55:00.000   2023-06-07 04:55:00.000 
- Jun  7 04:56:00   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000   2022-06-07 04:56:00.000   2022-06-07 04:56:00.000   2023-06-07 04:56:00.000 
+ Jun  6 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000 
+ Jun  8 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000 
diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
index 91ae230205b..59211d3e6a0 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
@@ -1,8 +1,9 @@
 SELECT 'parseDateTimeBestEffort';
 
 WITH
+    86400 AS secs_in_day,
     now() AS ts_now,
-    '2023-06-07 04:55:30' AS ref_point,
+    '2023-06-07' AS ref_point,
     dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
     formatDateTime(ts_around, '%b %e %T') AS dt_curr
 SELECT
@@ -15,69 +16,33 @@ SELECT
     parseDateTimeBestEffortOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_null_auc,
     parseDateTimeBestEffortOrZero(dt_curr) - impedimenta AS res_zero,
     parseDateTimeBestEffortOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_zero_sam,
-    parseDateTimeBestEffortOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_zero_auc
-FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
-FORMAT PrettySpaceNoEscapes;
-
-SELECT 'parseDateTimeBestEffortUS';
-
-WITH
-    now() AS ts_now,
-    '2023-06-07 04:55:30' AS ref_point,
-    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
-    formatDateTime(ts_around, '%b %e %T') AS dt_curr
-SELECT
-    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
-    parseDateTimeBestEffortUS(dt_curr) - impedimenta AS res,
-    parseDateTimeBestEffortUS(dt_curr, 'US/Samoa') - impedimenta AS res_sam,
-    parseDateTimeBestEffortUS(dt_curr, 'Pacific/Auckland') - impedimenta AS res_auc,
-    parseDateTimeBestEffortUSOrNull(dt_curr) - impedimenta AS res_null,
-    parseDateTimeBestEffortUSOrNull(dt_curr, 'US/Samoa') - impedimenta AS res_null_sam,
-    parseDateTimeBestEffortUSOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_null_auc,
-    parseDateTimeBestEffortUSOrZero(dt_curr) - impedimenta AS res_zero,
-    parseDateTimeBestEffortUSOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_zero_sam,
-    parseDateTimeBestEffortUSOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_zero_auc
-FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
-FORMAT PrettySpaceNoEscapes;
-
-SELECT 'parseDateTime64BestEffort';
-
-WITH
-    now() AS ts_now,
-    '2023-06-07 04:55:30' AS ref_point,
-    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
-    formatDateTime(ts_around, '%b %e %T') AS dt_curr
-SELECT
-    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
-    parseDateTime64BestEffort(dt_curr) - impedimenta AS res,
-    parseDateTime64BestEffort(dt_curr, 3, 'US/Samoa') - impedimenta AS res_sam,
-    parseDateTime64BestEffort(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_auc,
-    parseDateTime64BestEffortOrNull(dt_curr) - impedimenta AS res_null,
-    parseDateTime64BestEffortOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res_null_sam,
-    parseDateTime64BestEffortOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_null_auc,
-    parseDateTime64BestEffortOrZero(dt_curr) - impedimenta AS res_zero,
-    parseDateTime64BestEffortOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res_zero_sam,
-    parseDateTime64BestEffortOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_zero_auc
-FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
-FORMAT PrettySpaceNoEscapes;
-
-SELECT 'parseDateTime64BestEffortUS';
-
-WITH
-    now() AS ts_now,
-    '2023-06-07 04:55:30' AS ref_point,
-    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
-    formatDateTime(ts_around, '%b %e %T') AS dt_curr
-SELECT
-    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
-    parseDateTime64BestEffortUS(dt_curr) - impedimenta AS res,
-    parseDateTime64BestEffortUS(dt_curr, 3, 'US/Samoa') - impedimenta AS res_sam,
-    parseDateTime64BestEffortUS(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_auc,
-    parseDateTime64BestEffortUSOrNull(dt_curr) - impedimenta AS res_null,
-    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res_null_sam,
-    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_null_auc,
-    parseDateTime64BestEffortUSOrZero(dt_curr) - impedimenta AS res_zero,
-    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res_zero_sam,
-    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res_zero_auc
-FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around)
+    parseDateTimeBestEffortOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_zero_auc,
+    parseDateTimeBestEffortUS(dt_curr) - impedimenta AS res_us,
+    parseDateTimeBestEffortUS(dt_curr, 'US/Samoa') - impedimenta AS res_us_sam,
+    parseDateTimeBestEffortUS(dt_curr, 'Pacific/Auckland') - impedimenta AS res_us_auc,
+    parseDateTimeBestEffortUSOrNull(dt_curr) - impedimenta AS res_us_null,
+    parseDateTimeBestEffortUSOrNull(dt_curr, 'US/Samoa') - impedimenta AS res_us_null_sam,
+    parseDateTimeBestEffortUSOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_us_null_auc,
+    parseDateTimeBestEffortUSOrZero(dt_curr) - impedimenta AS res_us_zero,
+    parseDateTimeBestEffortUSOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_us_zero_sam,
+    parseDateTimeBestEffortUSOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_us_zero_auc,
+    parseDateTime64BestEffort(dt_curr) - impedimenta AS res64,
+    parseDateTime64BestEffort(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_sam,
+    parseDateTime64BestEffort(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_auc,
+    parseDateTime64BestEffortOrNull(dt_curr) - impedimenta AS res64_null,
+    parseDateTime64BestEffortOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_null_sam,
+    parseDateTime64BestEffortOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_null_auc,
+    parseDateTime64BestEffortOrZero(dt_curr) - impedimenta AS res64_zero,
+    parseDateTime64BestEffortOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_zero_sam,
+    parseDateTime64BestEffortOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_zero_auc,
+    parseDateTime64BestEffortUS(dt_curr) - impedimenta AS res64_us,
+    parseDateTime64BestEffortUS(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_us_sam,
+    parseDateTime64BestEffortUS(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_us_auc,
+    parseDateTime64BestEffortUSOrNull(dt_curr) - impedimenta AS res64_us_null,
+    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_us_null_sam,
+    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_us_null_auc,
+    parseDateTime64BestEffortUSOrZero(dt_curr) - impedimenta AS res64_us_zero,
+    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_us_zero_sam,
+    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_us_zero_auc
+FROM (SELECT arrayJoin([ts_now - secs_in_day, ts_now + secs_in_day]) AS ts_around)
 FORMAT PrettySpaceNoEscapes;

From b8178088d020d956cdf27d390f3d3b7a72a813e8 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 8 Jun 2023 08:10:40 +0000
Subject: [PATCH 259/722] Misc Annoy fixes

---
 .../mergetree-family/annindexes.md            | 169 +++++---
 .../mergetree-family/mergetree.md             |   2 +-
 src/Parsers/ParserCreateIndexQuery.cpp        |  11 +-
 src/Parsers/ParserCreateQuery.cpp             |  12 +-
 ...pproximateNearestNeighborIndexesCommon.cpp |   2 +-
 .../ApproximateNearestNeighborIndexesCommon.h |   4 +-
 .../MergeTree/MergeTreeIndexAnnoy.cpp         |  43 +-
 src/Storages/MergeTree/MergeTreeIndexAnnoy.h  |  16 +-
 .../0_stateless/02354_annoy_index.reference   | 260 ++++++------
 .../queries/0_stateless/02354_annoy_index.sql | 371 +++++++++++-------
 .../aspell-ignore/en/aspell-dict.txt          |   3 +
 11 files changed, 548 insertions(+), 345 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index f600f9a015c..2b0b77a0735 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -1,104 +1,142 @@
 # Approximate Nearest Neighbor Search Indexes [experimental] {#table_engines-ANNIndex}
 
-Nearest neighborhood search refers to the problem of finding the point(s) with the smallest distance to a given point in an n-dimensional
-space. Since exact search is in practice usually typically too slow, the task is often solved with approximate algorithms. A popular use
-case of of neighbor search is finding similar pictures (texts) for a given picture (text). Pictures (texts) can be decomposed into
-[embeddings](https://cloud.google.com/architecture/overview-extracting-and-serving-feature-embeddings-for-machine-learning), and instead of
-comparing pictures (texts) pixel-by-pixel (character-by-character), only the embeddings are compared.
+Nearest neighborhood search is the problem of finding the M closest points for a given point in an N-dimensional vector space. The most
+straightforward approach to solve this problem is a brute force search where the distance between all points in the vector space and the
+reference point is computed. This method guarantees perfect accuracy but it is usually too slow for practical applications. Thus, nearest
+neighborhood search problems are often solved with [approximative algorithms](https://github.com/erikbern/ann-benchmarks). Approximative
+nearest neighborhood search techniques, in conjunction with [embedding
+methods](https://cloud.google.com/architecture/overview-extracting-and-serving-feature-embeddings-for-machine-learning) allow to search huge
+amounts of media (pictures, songs, articles, etc.) in milliseconds.
 
-In terms of SQL, the problem can be expressed as follows:
+Blogs:
+- [Vector Search with ClickHouse - Part 1](https://clickhouse.com/blog/vector-search-clickhouse-p1)
+- [Vector Search with ClickHouse - Part 2](https://clickhouse.com/blog/vector-search-clickhouse-p2)
+
+
+In terms of SQL, the nearest neighborhood problem can be expressed as follows:
 
 ``` sql
 SELECT *
 FROM table
-WHERE L2Distance(column, Point) < MaxDistance
+ORDER BY Distance(vectors, Point)
 LIMIT N
 ```
 
+`vectors` contains N-dimensional values of type [Array](../../../sql-reference/data-types/array.md) or
+[Tuple](../../../sql-reference/data-types/tuple.md), for example embeddings. Function `Distance` computes the distance between two vectors.
+Often, the the Euclidean (L2) distance is chosen as distance function but [other
+distance functions](/docs/en/sql-reference/functions/distance-functions.md) are also possible. `Point` is the reference point, e.g. `(0.17,
+0.33, ...)`, and `N` limits the number of search results.
+
+An alternative formulation of the nearest neighborhood search problem looks as follows:
+
 ``` sql
 SELECT *
 FROM table
-ORDER BY L2Distance(column, Point)
+WHERE Distance(vectors, Point) < MaxDistance
 LIMIT N
 ```
 
-The queries are expensive because the L2 (Euclidean) distance between `Point` and all points in `column` and must be computed. To speed this process up, Approximate Nearest Neighbor Search Indexes (ANN indexes) store a compact representation of the search space (using clustering, search trees, etc.) which allows to compute an approximate answer quickly.
+While the first query returns the top-`N` closest points to the reference point, the second query returns all points closer to the reference
+point than a maximally allowed radius `MaxDistance`. Parameter `N` limits the number of returned values which is useful for situations where
+`MaxDistance` is difficult to determine in advance.
 
-# Creating ANN Indexes
+With brute force search, both queries are expensive (linear in the number of points) because the distance between all points in `vectors` and
+`Point` must be computed. To speed this process up, Approximate Nearest Neighbor Search Indexes (ANN indexes) store a compact representation
+of the search space (using clustering, search trees, etc.) which allows to compute an approximate answer much quicker (in sub-linear time).
 
-As long as ANN indexes are experimental, you first need to `SET allow_experimental_annoy_index = 1`.
+# Creating and Using ANN Indexes
 
-Syntax to create an ANN index over an `Array` column:
+Syntax to create an ANN index over an [Array](../../../sql-reference/data-types/array.md) column:
 
 ```sql
 CREATE TABLE table
 (
   `id` Int64,
-  `embedding` Array(Float32),
-  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY <N>
+  `vectors` Array(Float32),
+  INDEX <ann_index_name> vectors TYPE <ann_index_type>(<ann_index_parameters>) [GRANULARITY <N>]
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
-Syntax to create an ANN index over a `Tuple` column:
+Syntax to create an ANN index over a [Tuple](../../../sql-reference/data-types/tuple.md) column:
 
 ```sql
 CREATE TABLE table
 (
   `id` Int64,
-  `embedding` Tuple(Float32[, Float32[, ...]]),
-  INDEX <ann_index_name> embedding TYPE <ann_index_type>(<ann_index_parameters>) GRANULARITY <N>
+  `vectors` Tuple(Float32[, Float32[, ...]]),
+  INDEX <ann_index_name> vectors TYPE <ann_index_type>(<ann_index_parameters>) [GRANULARITY <N>]
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
-ANN indexes are built during column insertion and merge and `INSERT` and `OPTIMIZE` statements will be slower than for ordinary tables. ANNIndexes are ideally used only with immutable or rarely changed data, respectively there are much more read requests than write requests.
-
-Similar to regular skip indexes, ANN indexes are constructed over granules and each indexed block consists of `GRANULARITY = <N>`-many
-granules. For example, if the primary index granularity of the table is 8192 (setting `index_granularity = 8192`) and `GRANULARITY = 2`,
-then each indexed block will consist of 16384 rows. However, unlike skip indexes, ANN indexes are not only able to skip the entire indexed
-block, they are able to skip individual granules in indexed blocks. As a result, the `GRANULARITY` parameter has a different meaning in ANN
-indexes than in normal skip indexes. Basically, the bigger `GRANULARITY` is chosen, the more data is provided to a single ANN index, and the
-higher the chance that with the right hyper parameters, the index will remember the data structure better.
-
-# Using ANN Indexes
+ANN indexes are built during column insertion and merge. As a result, `INSERT` and `OPTIMIZE` statements will be slower than for ordinary
+tables. ANNIndexes are ideally used only with immutable or rarely changed data, respectively when are far more read requests than write
+requests.
 
 ANN indexes support two types of queries:
 
-- WHERE queries:
-
-   ``` sql
-   SELECT *
-   FROM table
-   WHERE DistanceFunction(column, Point) < MaxDistance
-   LIMIT N
-   ```
-
 - ORDER BY queries:
 
   ``` sql
   SELECT *
   FROM table
   [WHERE ...]
-  ORDER BY DistanceFunction(column, Point)
+  ORDER BY Distance(vectors, Point)
   LIMIT N
   ```
 
-`DistanceFunction` is a [distance function](/docs/en/sql-reference/functions/distance-functions.md), `Point` is a reference vector (e.g. `(0.17, 0.33, ...)`) and `MaxDistance` is a floating point value which restricts the size of the neighbourhood.
+- WHERE queries:
+
+   ``` sql
+   SELECT *
+   FROM table
+   WHERE Distance(vectors, Point) < MaxDistance
+   LIMIT N
+   ```
 
 :::tip
-To avoid writing out large vectors, you can use [query parameters](/docs/en//interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters), e.g.
+To avoid writing out large vectors, you can use [query
+parameters](/docs/en//interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters), e.g.
 
 ```bash
-clickhouse-client --param_vec='hello' --query="SELECT * FROM table WHERE L2Distance(embedding, {vec: Array(Float32)}) < 1.0"
+clickhouse-client --param_vec='hello' --query="SELECT * FROM table WHERE L2Distance(vectors, {vec: Array(Float32)}) < 1.0"
 ```
 :::
 
-ANN indexes cannot speed up queries that contain both a `WHERE DistanceFunction(column, Point) < MaxDistance` and an `ORDER BY DistanceFunction(column, Point)` clause. Also, the approximate algorithms used to determine the nearest neighbors require a limit, hence queries that use an ANN index must have a `LIMIT` clause.
+**Restrictions**: Queries that contain both a `WHERE Distance(vectors, Point) < MaxDistance` and an `ORDER BY Distance(vectors, Point)`
+clause cannot use ANN indexes. Also, the approximate algorithms used to determine the nearest neighbors require a limit, hence queries
+without `LIMIT` clause cannot utilize ANN indexes. Also ANN indexes are only used if the query has a `LIMIT` value smaller than setting
+`max_limit_for_ann_queries` (default: 1 million rows). This is a safeguard to prevent large memory allocations by external libraries for
+approximate neighbor search.
+
+**Differences to Skip Indexes** Similar to regular [skip indexes](https://clickhouse.com/docs/en/optimize/skipping-indexes), ANN indexes are
+constructed over granules and each indexed block consists of `GRANULARITY = <N>`-many granules (`<N>` = 1 by default for normal skip
+indexes). For example, if the primary index granularity of the table is 8192 (setting `index_granularity = 8192`) and `GRANULARITY = 2`,
+then each indexed block will contain 16384 rows. However, data structures and algorithms for approximate neighborhood search (usually
+provided by external libraries) are inherently row-oriented. They store a compact representation of a set of rows and also return rows for
+ANN queries. This causes some rather unintuitive differences in the way ANN indexes behave compared to normal skip indexes.
+
+When a user defines a ANN index on a column, ClickHouse internally creates a ANN "sub-index" for each index block. The sub-index is "local"
+in the sense that it only knows about the rows of its containing index block. In the previous example and assuming that a column has 65536
+rows, we obtain four index blocks (spanning eight granules) and a ANN sub-index for each index block. A sub-index is theoretically able to
+return the rows with the N closest points within its index block directly. However, since ClickHouse loads data from disk to memory at the
+granularity of granules, sub-indexes extrapolate matching rows to granule granularity. This is different from regular skip indexes which
+skip data at the granularity of index blocks.
+
+The `GRANULARITY` parameter determines how many ANN sub-indexes are created. Bigger `GRANULARITY` values mean fewer but larger ANN
+sub-indexes, up to the point where a column (or a column part) has only a single sub-index. In that case, the sub-index has a "global" view of
+all column rows and can directly return all granules of the column (part) with relevant rows (there are at at most `LIMIT <N>`-many
+such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a brute-force distance
+calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to `LIMIT N`-many granules.
+As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases equally good, only the
+processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall back to a smaller
+`GRANULARITY` values only in case of problems like excessive memory consumption of the ANN structures. If no `GRANULARITY` was specified for
+ANN indexes, the default value is 100 million.
 
-An ANN index is only used if the query has a `LIMIT` value smaller than setting `max_limit_for_ann_queries` (default: 1 million rows). This is a safety measure which helps to avoid large memory consumption by external libraries for approximate neighbor search.
 
 # Available ANN Indexes
 
@@ -106,51 +144,68 @@ An ANN index is only used if the query has a `LIMIT` value smaller than setting
 
 ## Annoy {#annoy}
 
-(currently disabled on ARM due to memory safety problems with the algorithm)
+Annoy indexes are currently experimental, to use them you first need to `SET allow_experimental_annoy_index = 1`. They are also currently
+disabled on ARM due to memory safety problems with the algorithm.
 
-This type of ANN index implements [the Annoy algorithm](https://github.com/spotify/annoy) which uses a recursive division of the space in random linear surfaces (lines in 2D, planes in 3D etc.).
+This type of ANN index implements [the Annoy algorithm](https://github.com/spotify/annoy) which is based on a recursive division of the
+space in random linear surfaces (lines in 2D, planes in 3D etc.).
 
-Syntax to create a Annoy index over a `Array` column:
+<div class='vimeo-container'>
+  <iframe src="//www.youtube.com/watch?v=QkCCyLW0ehU"
+    width="640"
+    height="360"
+    frameborder="0"
+    allow="autoplay;
+    fullscreen;
+    picture-in-picture"
+    allowfullscreen>
+  </iframe>
+</div>
+
+Syntax to create an Annoy index over an [Array](../../../sql-reference/data-types/array.md) column:
 
 ```sql
 CREATE TABLE table
 (
   id Int64,
-  embedding Array(Float32),
-  INDEX <ann_index_name> embedding TYPE annoy([DistanceName[, NumTrees]]) GRANULARITY N
+  vectors Array(Float32),
+  INDEX <ann_index_name> vectors TYPE annoy([Distance[, NumTrees]]) [GRANULARITY N]
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
-Syntax to create a Annoy index over a `Tuple` column:
+Syntax to create an ANN index over a [Tuple](../../../sql-reference/data-types/tuple.md) column:
 
 ```sql
 CREATE TABLE table
 (
   id Int64,
-  embedding Tuple(Float32[, Float32[, ...]]),
-  INDEX <ann_index_name> embedding TYPE annoy([DistanceName[, NumTrees]]) GRANULARITY N
+  vectors Tuple(Float32[, Float32[, ...]]),
+  INDEX <ann_index_name> vectors TYPE annoy([Distance[, NumTrees]]) [GRANULARITY N]
 )
 ENGINE = MergeTree
 ORDER BY id;
 ```
 
-Parameter `DistanceName` is name of a distance function (default `L2Distance`). Annoy currently supports `L2Distance` and `cosineDistance` as distance functions. Parameter `NumTrees` (default: 100) is the number of trees which the algorithm will create. Higher values of `NumTree` mean slower `CREATE` and `SELECT` statements (approximately linearly), but increase the accuracy of search results.
+Annoy currently supports `L2Distance` and `cosineDistance` as distance function `Distance`. If no distance function was specified during
+index creation, `L2Distance` is used as default. Parameter `NumTrees` is the number of trees which the algorithm creates (default if not
+specified: 100). Higher values of `NumTree` mean more accurate search results but slower index creation / query times (approximately
+linearly) as well as larger index sizes.
 
 :::note
-Indexes over columns of type `Array` will generally work faster than indexes on `Tuple` columns. All arrays **must** have same length. Use [CONSTRAINT](/docs/en/sql-reference/statements/create/table.md#constraints) to avoid errors. For example, `CONSTRAINT constraint_name_1 CHECK length(embedding) = 256`.
+Indexes over columns of type `Array` will generally work faster than indexes on `Tuple` columns. All arrays **must** have same length. Use
+[CONSTRAINT](/docs/en/sql-reference/statements/create/table.md#constraints) to avoid errors. For example, `CONSTRAINT constraint_name_1
+CHECK length(vectors) = 256`.
 :::
 
-Setting `annoy_index_search_k_nodes` (default: `NumTrees * LIMIT`) determines how many tree nodes are inspected during SELECTs. It can be used to
-balance runtime and accuracy at runtime.
-
-Example:
+Setting `annoy_index_search_k_nodes` (default: `NumTrees * LIMIT`) determines how many tree nodes are inspected during SELECTs. Larger
+values mean more accurate results at the cost of longer query runtime:
 
 ``` sql
 SELECT *
 FROM table_name [WHERE ...]
-ORDER BY L2Distance(column, Point)
+ORDER BY L2Distance(vectors, Point)
 LIMIT N
 SETTINGS annoy_index_search_k_nodes=100
 ```
diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index 07f706af91d..61276110138 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -491,7 +491,7 @@ Syntax: `tokenbf_v1(size_of_bloom_filter_in_bytes, number_of_hash_functions, ran
 
 #### Special-purpose
 
-- An experimental index to support approximate nearest neighbor (ANN) search. See [here](annindexes.md) for details.
+- Experimental indexes to support approximate nearest neighbor (ANN) search. See [here](annindexes.md) for details.
 - An experimental inverted index to support full-text search. See [here](invertedindexes.md) for details.
 
 ### Functions Support {#functions-support}
diff --git a/src/Parsers/ParserCreateIndexQuery.cpp b/src/Parsers/ParserCreateIndexQuery.cpp
index 7323c5da141..57afd3fb99e 100644
--- a/src/Parsers/ParserCreateIndexQuery.cpp
+++ b/src/Parsers/ParserCreateIndexQuery.cpp
@@ -46,7 +46,16 @@ bool ParserCreateIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected
     index->part_of_create_index_query = true;
     index->set(index->expr, expr);
     index->set(index->type, type);
-    index->granularity = granularity ? granularity->as<ASTLiteral &>().value.safeGet<UInt64>() : 1;
+
+    if (granularity)
+        index->granularity = granularity->as<ASTLiteral &>().value.safeGet<UInt64>();
+    else
+    {
+        if (index->type->name == "annoy")
+            index->granularity = 100'000'000;
+        else
+            index->granularity = 1;
+    }
     node = index;
 
     return true;
diff --git a/src/Parsers/ParserCreateQuery.cpp b/src/Parsers/ParserCreateQuery.cpp
index f975e8ba3c8..c6273f369b1 100644
--- a/src/Parsers/ParserCreateQuery.cpp
+++ b/src/Parsers/ParserCreateQuery.cpp
@@ -141,7 +141,17 @@ bool ParserIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected & expe
     index->name = name->as<ASTIdentifier &>().name();
     index->set(index->expr, expr);
     index->set(index->type, type);
-    index->granularity = granularity ? granularity->as<ASTLiteral &>().value.safeGet<UInt64>() : 1;
+
+    if (granularity)
+        index->granularity = granularity->as<ASTLiteral &>().value.safeGet<UInt64>();
+    else
+    {
+        if (index->type->name == "annoy")
+            index->granularity = 100'000'000;
+        else
+            index->granularity = 1;
+    }
+
     node = index;
 
     return true;
diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
index bf277c55863..69e54dd5f0c 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.cpp
@@ -88,7 +88,7 @@ std::vector<float> ApproximateNearestNeighborCondition::getReferenceVector() con
     throw Exception(ErrorCodes::LOGICAL_ERROR, "Reference vector was requested for useless or uninitialized index.");
 }
 
-size_t ApproximateNearestNeighborCondition::getNumOfDimensions() const
+size_t ApproximateNearestNeighborCondition::getDimensions() const
 {
     if (index_is_useful && query_information.has_value())
         return query_information->reference_vector.size();
diff --git a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
index 4fb95c3f492..310890eba1e 100644
--- a/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
+++ b/src/Storages/MergeTree/ApproximateNearestNeighborIndexesCommon.h
@@ -90,8 +90,8 @@ public:
     /// Distance should be calculated regarding to referenceVector
     std::vector<float> getReferenceVector() const;
 
-    /// Reference vector's dimension size
-    size_t getNumOfDimensions() const;
+    /// Reference vector's dimension count
+    size_t getDimensions() const;
 
     String getColumnName() const;
 
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
index 1a28f28f746..f77cfe4fed0 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.cpp
@@ -27,13 +27,13 @@ namespace ErrorCodes
 
 
 template <typename Distance>
-AnnoyIndexWithSerialization<Distance>::AnnoyIndexWithSerialization(uint64_t dim)
-    : Base::AnnoyIndex(dim)
+AnnoyIndexWithSerialization<Distance>::AnnoyIndexWithSerialization(size_t dimensions)
+    : Base::AnnoyIndex(dimensions)
 {
 }
 
 template<typename Distance>
-void AnnoyIndexWithSerialization<Distance>::serialize(WriteBuffer& ostr) const
+void AnnoyIndexWithSerialization<Distance>::serialize(WriteBuffer & ostr) const
 {
     chassert(Base::_built);
     writeIntBinary(Base::_s, ostr);
@@ -43,11 +43,11 @@ void AnnoyIndexWithSerialization<Distance>::serialize(WriteBuffer& ostr) const
     writeIntBinary(Base::_K, ostr);
     writeIntBinary(Base::_seed, ostr);
     writeVectorBinary(Base::_roots, ostr);
-    ostr.write(reinterpret_cast<const char*>(Base::_nodes), Base::_s * Base::_n_nodes);
+    ostr.write(reinterpret_cast<const char *>(Base::_nodes), Base::_s * Base::_n_nodes);
 }
 
 template<typename Distance>
-void AnnoyIndexWithSerialization<Distance>::deserialize(ReadBuffer& istr)
+void AnnoyIndexWithSerialization<Distance>::deserialize(ReadBuffer & istr)
 {
     chassert(!Base::_built);
     readIntBinary(Base::_s, istr);
@@ -69,7 +69,7 @@ void AnnoyIndexWithSerialization<Distance>::deserialize(ReadBuffer& istr)
 }
 
 template<typename Distance>
-uint64_t AnnoyIndexWithSerialization<Distance>::getNumOfDimensions() const
+size_t AnnoyIndexWithSerialization<Distance>::getDimensions() const
 {
     return Base::get_f();
 }
@@ -97,14 +97,14 @@ void MergeTreeIndexGranuleAnnoy<Distance>::serializeBinary(WriteBuffer & ostr) c
 {
     /// Number of dimensions is required in the index constructor,
     /// so it must be written and read separately from the other part
-    writeIntBinary(index->getNumOfDimensions(), ostr); // write dimension
+    writeIntBinary(static_cast<UInt64>(index->getDimensions()), ostr); // write dimension
     index->serialize(ostr);
 }
 
 template <typename Distance>
 void MergeTreeIndexGranuleAnnoy<Distance>::deserializeBinary(ReadBuffer & istr, MergeTreeIndexVersion /*version*/)
 {
-    uint64_t dimension;
+    UInt64 dimension;
     readIntBinary(dimension, istr);
     index = std::make_shared<AnnoyIndexWithSerialization<Distance>>(dimension);
     index->deserialize(istr);
@@ -114,7 +114,7 @@ template <typename Distance>
 MergeTreeIndexAggregatorAnnoy<Distance>::MergeTreeIndexAggregatorAnnoy(
     const String & index_name_,
     const Block & index_sample_block_,
-    uint64_t trees_)
+    UInt64 trees_)
     : index_name(index_name_)
     , index_sample_block(index_sample_block_)
     , trees(trees_)
@@ -251,10 +251,10 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
 
     const AnnoyIndexWithSerializationPtr<Distance> annoy = granule->index;
 
-    if (ann_condition.getNumOfDimensions() != annoy->getNumOfDimensions())
+    if (ann_condition.getDimensions() != annoy->getDimensions())
         throw Exception(ErrorCodes::INCORRECT_QUERY, "The dimension of the space in the request ({}) "
                         "does not match the dimension in the index ({})",
-                        ann_condition.getNumOfDimensions(), annoy->getNumOfDimensions());
+                        ann_condition.getDimensions(), annoy->getDimensions());
 
     std::vector<UInt64> neighbors; /// indexes of dots which were closest to the reference vector
     std::vector<Float32> distances;
@@ -281,7 +281,7 @@ std::vector<size_t> MergeTreeIndexConditionAnnoy::getUsefulRangesImpl(MergeTreeI
     return granule_numbers;
 }
 
-MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String & distance_function_)
+MergeTreeIndexAnnoy::MergeTreeIndexAnnoy(const IndexDescription & index_, UInt64 trees_, const String & distance_function_)
     : IMergeTreeIndex(index_)
     , trees(trees_)
     , distance_function(distance_function_)
@@ -320,9 +320,9 @@ MergeTreeIndexPtr annoyIndexCreator(const IndexDescription & index)
     if (!index.arguments.empty())
         distance_function = index.arguments[0].get<String>();
 
-    uint64_t trees = default_trees;
+    UInt64 trees = default_trees;
     if (index.arguments.size() > 1)
-        trees = index.arguments[1].get<uint64_t>();
+        trees = index.arguments[1].get<UInt64>();
 
     return std::make_shared<MergeTreeIndexAnnoy>(index, trees, distance_function);
 }
@@ -338,7 +338,7 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
         throw Exception(ErrorCodes::INCORRECT_QUERY, "Distance function argument of Annoy index must be of type String");
 
     if (index.arguments.size() > 1 && index.arguments[1].getType() != Field::Types::UInt64)
-        throw Exception(ErrorCodes::INCORRECT_QUERY, "Number of trees argument of Annoy index must be UInt64");
+        throw Exception(ErrorCodes::INCORRECT_QUERY, "Number of trees argument of Annoy index must be of type UInt64");
 
     /// Check that the index is created on a single column
 
@@ -351,17 +351,16 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     {
         String distance_name = index.arguments[0].get<String>();
         if (distance_name != "L2Distance" && distance_name != "cosineDistance")
-            throw Exception(ErrorCodes::INCORRECT_DATA, "Annoy index supports only distance functions 'L2Distance' and 'cosineDistance'. Given distance function: {}", distance_name);
+            throw Exception(ErrorCodes::INCORRECT_DATA, "Annoy index only supports distance functions 'L2Distance' and 'cosineDistance'");
     }
 
     /// Check data type of indexed column:
 
-    auto throw_unsupported_underlying_column_exception = [](DataTypePtr data_type)
+    auto throw_unsupported_underlying_column_exception = []()
     {
         throw Exception(
             ErrorCodes::ILLEGAL_COLUMN,
-            "Annoy indexes can only be created on columns of type Array(Float32) and Tuple(Float32). Given type: {}",
-            data_type->getName());
+            "Annoy indexes can only be created on columns of type Array(Float32) and Tuple(Float32)");
     };
 
     DataTypePtr data_type = index.sample_block.getDataTypes()[0];
@@ -370,7 +369,7 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
     {
         TypeIndex nested_type_index = data_type_array->getNestedType()->getTypeId();
         if (!WhichDataType(nested_type_index).isFloat32())
-            throw_unsupported_underlying_column_exception(data_type);
+            throw_unsupported_underlying_column_exception();
     }
     else if (const auto * data_type_tuple = typeid_cast<const DataTypeTuple *>(data_type.get()))
     {
@@ -379,11 +378,11 @@ void annoyIndexValidator(const IndexDescription & index, bool /* attach */)
         {
             TypeIndex nested_type_index = inner_type->getTypeId();
             if (!WhichDataType(nested_type_index).isFloat32())
-                throw_unsupported_underlying_column_exception(data_type);
+                throw_unsupported_underlying_column_exception();
         }
     }
     else
-        throw_unsupported_underlying_column_exception(data_type);
+        throw_unsupported_underlying_column_exception();
 }
 
 }
diff --git a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
index 5204ff07b27..cfc3b7519b8 100644
--- a/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
+++ b/src/Storages/MergeTree/MergeTreeIndexAnnoy.h
@@ -16,10 +16,10 @@ class AnnoyIndexWithSerialization : public Annoy::AnnoyIndex<UInt64, Float32, Di
     using Base = Annoy::AnnoyIndex<UInt64, Float32, Distance, Annoy::Kiss64Random, Annoy::AnnoyIndexMultiThreadedBuildPolicy>;
 
 public:
-    explicit AnnoyIndexWithSerialization(uint64_t dim);
-    void serialize(WriteBuffer& ostr) const;
-    void deserialize(ReadBuffer& istr);
-    uint64_t getNumOfDimensions() const;
+    explicit AnnoyIndexWithSerialization(size_t dimensions);
+    void serialize(WriteBuffer & ostr) const;
+    void deserialize(ReadBuffer & istr);
+    size_t getDimensions() const;
 };
 
 template <typename Distance>
@@ -46,7 +46,7 @@ struct MergeTreeIndexGranuleAnnoy final : public IMergeTreeIndexGranule
 template <typename Distance>
 struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
 {
-    MergeTreeIndexAggregatorAnnoy(const String & index_name_, const Block & index_sample_block, uint64_t trees);
+    MergeTreeIndexAggregatorAnnoy(const String & index_name_, const Block & index_sample_block, UInt64 trees);
     ~MergeTreeIndexAggregatorAnnoy() override = default;
 
     bool empty() const override { return !index || index->get_n_items() == 0; }
@@ -55,7 +55,7 @@ struct MergeTreeIndexAggregatorAnnoy final : IMergeTreeIndexAggregator
 
     const String index_name;
     const Block index_sample_block;
-    const uint64_t trees;
+    const UInt64 trees;
     AnnoyIndexWithSerializationPtr<Distance> index;
 };
 
@@ -89,7 +89,7 @@ class MergeTreeIndexAnnoy : public IMergeTreeIndex
 {
 public:
 
-    MergeTreeIndexAnnoy(const IndexDescription & index_, uint64_t trees_, const String & distance_function_);
+    MergeTreeIndexAnnoy(const IndexDescription & index_, UInt64 trees_, const String & distance_function_);
 
     ~MergeTreeIndexAnnoy() override = default;
 
@@ -100,7 +100,7 @@ public:
     bool mayBenefitFromIndexForIn(const ASTPtr & /*node*/) const override { return false; }
 
 private:
-    const uint64_t trees;
+    const UInt64 trees;
     const String distance_function;
 };
 
diff --git a/tests/queries/0_stateless/02354_annoy_index.reference b/tests/queries/0_stateless/02354_annoy_index.reference
index 45515bc7733..5e01a6e566e 100644
--- a/tests/queries/0_stateless/02354_annoy_index.reference
+++ b/tests/queries/0_stateless/02354_annoy_index.reference
@@ -1,118 +1,144 @@
---- Test with Array ---
-WHERE type, L2Distance
-1	[0,0,10]
-2	[0,0,10.5]
-3	[0,0,9.5]
-4	[0,0,9.7]
-5	[0,0,10.2]
-ORDER BY type, L2Distance
-1	[0,0,10]
-5	[0,0,10.2]
-4	[0,0,9.7]
-WHERE type, L2Distance, check that index is used
-Expression ((Projection + Before ORDER BY))
-  Limit (preliminary LIMIT (without OFFSET))
-    ReadFromMergeTree (default.tab)
-    Indexes:
-      PrimaryKey
-        Condition: true
-        Parts: 1/1
-        Granules: 3/3
-      Skip
-        Name: annoy_index
-        Description: annoy GRANULARITY 1
-        Parts: 1/1
-        Granules: 1/3
-ORDER BY type, L2Distance, check that index is used
-Expression (Projection)
-  Limit (preliminary LIMIT (without OFFSET))
-    Sorting (Sorting for ORDER BY)
-      Expression (Before ORDER BY)
-        ReadFromMergeTree (default.tab)
-        Indexes:
-          PrimaryKey
-            Condition: true
-            Parts: 1/1
-            Granules: 3/3
-          Skip
-            Name: annoy_index
-            Description: annoy GRANULARITY 1
-            Parts: 1/1
-            Granules: 3/3
-parameter annoy_index_search_k_nodes
-parameter max_limit_for_ann_queries
-Expression (Projection)
-  Limit (preliminary LIMIT (without OFFSET))
-    Sorting (Sorting for ORDER BY)
-      Expression (Before ORDER BY)
-        ReadFromMergeTree (default.tab)
-        Indexes:
-          PrimaryKey
-            Condition: true
-            Parts: 1/1
-            Granules: 3/3
---- Test with Tuple ---
-WHERE type, L2Distance
-1	(0,0,10)
-2	(0,0,10.5)
-3	(0,0,9.5)
-4	(0,0,9.7)
-5	(0,0,10.2)
-ORDER BY type, L2Distance
-1	(0,0,10)
-5	(0,0,10.2)
-4	(0,0,9.7)
-WHERE type, L2Distance, check that index is used
-Expression ((Projection + Before ORDER BY))
-  Limit (preliminary LIMIT (without OFFSET))
-    ReadFromMergeTree (default.tab)
-    Indexes:
-      PrimaryKey
-        Condition: true
-        Parts: 1/1
-        Granules: 3/3
-      Skip
-        Name: annoy_index
-        Description: annoy GRANULARITY 1
-        Parts: 1/1
-        Granules: 1/3
-ORDER BY type, L2Distance, check that index is used
-Expression (Projection)
-  Limit (preliminary LIMIT (without OFFSET))
-    Sorting (Sorting for ORDER BY)
-      Expression (Before ORDER BY)
-        ReadFromMergeTree (default.tab)
-        Indexes:
-          PrimaryKey
-            Condition: true
-            Parts: 1/1
-            Granules: 3/3
-          Skip
-            Name: annoy_index
-            Description: annoy GRANULARITY 1
-            Parts: 1/1
-            Granules: 3/3
-parameter annoy_index_search_k_nodes
-parameter max_limit_for_ann_queries
-Expression (Projection)
-  Limit (preliminary LIMIT (without OFFSET))
-    Sorting (Sorting for ORDER BY)
-      Expression (Before ORDER BY)
-        ReadFromMergeTree (default.tab)
-        Indexes:
-          PrimaryKey
-            Condition: true
-            Parts: 1/1
-            Granules: 3/3
---- Test alternative metric (cosine distance) and non-default NumTrees ---
-WHERE type, L2Distance
-1	[0,0,10]
-2	[0,0,10.5]
-3	[0,0,9.5]
-4	[0,0,9.7]
-5	[0,0,10.2]
-ORDER BY type, L2Distance
-1	[0,0,10]
-5	[0,0,10.2]
-4	[0,0,9.7]
 --- Negative tests ---
+--- Test default GRANULARITY (should be 100 mio. for annoy)---
+CREATE TABLE default.tab\n(\n    `id` Int32,\n    `vector` Array(Float32),\n    INDEX annoy_index vector TYPE annoy GRANULARITY 100000000\n)\nENGINE = MergeTree\nORDER BY id\nSETTINGS index_granularity = 8192
+CREATE TABLE default.tab\n(\n    `id` Int32,\n    `vector` Array(Float32),\n    INDEX annoy_index vector TYPE annoy GRANULARITY 100000000\n)\nENGINE = MergeTree\nORDER BY id\nSETTINGS index_granularity = 8192
+--- Test with Array, GRANULARITY = 1, index_granularity = 5 ---
+WHERE type, L2Distance, check that index is used
+Expression ((Projection + Before ORDER BY))
+  Limit (preliminary LIMIT (without OFFSET))
+    ReadFromMergeTree (default.tab)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 3/3
+      Skip
+        Name: annoy_index
+        Description: annoy GRANULARITY 1
+        Parts: 1/1
+        Granules: 1/3
+ORDER BY type, L2Distance, check that index is used
+Expression (Projection)
+  Limit (preliminary LIMIT (without OFFSET))
+    Sorting (Sorting for ORDER BY)
+      Expression (Before ORDER BY)
+        ReadFromMergeTree (default.tab)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 3/3
+          Skip
+            Name: annoy_index
+            Description: annoy GRANULARITY 1
+            Parts: 1/1
+            Granules: 3/3
+Reference ARRAYs with non-matching dimension are rejected
+Special case: MaximumDistance is negative
+WHERE type, L2Distance
+Special case: setting annoy_index_search_k_nodes
+Special case: setting max_limit_for_ann_queries
+Expression (Projection)
+  Limit (preliminary LIMIT (without OFFSET))
+    Sorting (Sorting for ORDER BY)
+      Expression (Before ORDER BY)
+        ReadFromMergeTree (default.tab)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 3/3
+--- Test with Tuple, GRANULARITY = 1, index_granularity = 5 ---
+WHERE type, L2Distance, check that index is used
+Expression ((Projection + Before ORDER BY))
+  Limit (preliminary LIMIT (without OFFSET))
+    ReadFromMergeTree (default.tab)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 3/3
+      Skip
+        Name: annoy_index
+        Description: annoy GRANULARITY 1
+        Parts: 1/1
+        Granules: 1/3
+ORDER BY type, L2Distance, check that index is used
+Expression (Projection)
+  Limit (preliminary LIMIT (without OFFSET))
+    Sorting (Sorting for ORDER BY)
+      Expression (Before ORDER BY)
+        ReadFromMergeTree (default.tab)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 3/3
+          Skip
+            Name: annoy_index
+            Description: annoy GRANULARITY 1
+            Parts: 1/1
+            Granules: 3/3
+--- Test non-default metric (cosine distance) + non-default NumTrees (200) ---
+--- Test with Array, GRANULARITY = 2, index_granularity = 4 ---
+WHERE type, L2Distance, check that index is used
+Expression ((Projection + Before ORDER BY))
+  Limit (preliminary LIMIT (without OFFSET))
+    ReadFromMergeTree (default.tab)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 4/4
+      Skip
+        Name: annoy_index
+        Description: annoy GRANULARITY 2
+        Parts: 0/1
+        Granules: 2/4
+ORDER BY type, L2Distance, check that index is used
+Expression (Projection)
+  Limit (preliminary LIMIT (without OFFSET))
+    Sorting (Sorting for ORDER BY)
+      Expression (Before ORDER BY)
+        ReadFromMergeTree (default.tab)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 4/4
+          Skip
+            Name: annoy_index
+            Description: annoy GRANULARITY 2
+            Parts: 1/1
+            Granules: 4/4
+--- Test with Array, GRANULARITY = 4, index_granularity = 4 ---
+WHERE type, L2Distance, check that index is used
+Expression ((Projection + Before ORDER BY))
+  Limit (preliminary LIMIT (without OFFSET))
+    ReadFromMergeTree (default.tab)
+    Indexes:
+      PrimaryKey
+        Condition: true
+        Parts: 1/1
+        Granules: 4/4
+      Skip
+        Name: annoy_index
+        Description: annoy GRANULARITY 4
+        Parts: 0/1
+        Granules: 3/4
+ORDER BY type, L2Distance, check that index is used
+Expression (Projection)
+  Limit (preliminary LIMIT (without OFFSET))
+    Sorting (Sorting for ORDER BY)
+      Expression (Before ORDER BY)
+        ReadFromMergeTree (default.tab)
+        Indexes:
+          PrimaryKey
+            Condition: true
+            Parts: 1/1
+            Granules: 4/4
+          Skip
+            Name: annoy_index
+            Description: annoy GRANULARITY 4
+            Parts: 1/1
+            Granules: 4/4
diff --git a/tests/queries/0_stateless/02354_annoy_index.sql b/tests/queries/0_stateless/02354_annoy_index.sql
index abee5e8a6e4..fefb51dfcc9 100644
--- a/tests/queries/0_stateless/02354_annoy_index.sql
+++ b/tests/queries/0_stateless/02354_annoy_index.sql
@@ -1,150 +1,251 @@
--- Tags: disabled, no-fasttest, no-ubsan, no-cpu-aarch64, no-upgrade-check
+-- Tags: no-fasttest, no-ubsan, no-cpu-aarch64, no-upgrade-check
 
 SET allow_experimental_annoy_index = 1;
-
-SELECT '--- Test with Array ---';
-
-DROP TABLE IF EXISTS tab;
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy()) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity=5;
-INSERT INTO tab VALUES (1, [0.0, 0.0, 10.0]), (2, [0.0, 0.0, 10.5]), (3, [0.0, 0.0, 9.5]), (4, [0.0, 0.0, 9.7]), (5, [0.0, 0.0, 10.2]), (6, [10.0, 0.0, 0.0]), (7, [9.5, 0.0, 0.0]), (8, [9.7, 0.0, 0.0]), (9, [10.2, 0.0, 0.0]), (10, [10.5, 0.0, 0.0]), (11, [0.0, 10.0, 0.0]), (12, [0.0, 9.5, 0.0]), (13, [0.0, 9.7, 0.0]), (14, [0.0, 10.2, 0.0]), (15, [0.0, 10.5, 0.0]);
-
-SELECT 'WHERE type, L2Distance';
-SELECT *
-FROM tab
-WHERE L2Distance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 5;
-
-SELECT 'ORDER BY type, L2Distance';
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-
--- Produces different error code with analyzer, TODO: check
--- SELECT 'Reference ARRAYs with non-matching dimension are rejected';
--- SELECT *
--- FROM tab
--- ORDER BY L2Distance(embedding, [0.0, 0.0])
--- LIMIT 3; -- { serverError INCORRECT_QUERY }
-
-SELECT 'WHERE type, L2Distance, check that index is used';
-EXPLAIN indexes=1
-SELECT *
-FROM tab
-WHERE L2Distance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 5;
-
-SELECT 'ORDER BY type, L2Distance, check that index is used';
-EXPLAIN indexes=1
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-
-SELECT 'parameter annoy_index_search_k_nodes';
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, [5.3, 7.3, 2.1])
-LIMIT 5
-SETTINGS annoy_index_search_k_nodes=0; -- searches zero nodes --> no results
-
-SELECT 'parameter max_limit_for_ann_queries';
-EXPLAIN indexes=1
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, [5.3, 7.3, 2.1])
-LIMIT 5
-SETTINGS max_limit_for_ann_queries=2; -- doesn't use the ann index
-
-DROP TABLE tab;
-
-SELECT '--- Test with Tuple ---';
-
-CREATE TABLE tab(id Int32, embedding Tuple(Float32, Float32, Float32), INDEX annoy_index embedding TYPE annoy()) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity=5;
-INSERT INTO tab VALUES (1, (0.0, 0.0, 10.0)), (2, (0.0, 0.0, 10.5)), (3, (0.0, 0.0, 9.5)), (4, (0.0, 0.0, 9.7)), (5, (0.0, 0.0, 10.2)), (6, (10.0, 0.0, 0.0)), (7, (9.5, 0.0, 0.0)), (8, (9.7, 0.0, 0.0)), (9, (10.2, 0.0, 0.0)), (10, (10.5, 0.0, 0.0)), (11, (0.0, 10.0, 0.0)), (12, (0.0, 9.5, 0.0)), (13, (0.0, 9.7, 0.0)), (14, (0.0, 10.2, 0.0)), (15, (0.0, 10.5, 0.0));
-
-SELECT 'WHERE type, L2Distance';
-SELECT *
-FROM tab
-WHERE L2Distance(embedding, (0.0, 0.0, 10.0)) < 1.0
-LIMIT 5;
-
-SELECT 'ORDER BY type, L2Distance';
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, (0.0, 0.0, 10.0))
-LIMIT 3;
-
-SELECT 'WHERE type, L2Distance, check that index is used';
-EXPLAIN indexes=1
-SELECT *
-FROM tab
-WHERE L2Distance(embedding, (0.0, 0.0, 10.0)) < 1.0
-LIMIT 5;
-
-SELECT 'ORDER BY type, L2Distance, check that index is used';
-EXPLAIN indexes=1
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, (0.0, 0.0, 10.0))
-LIMIT 3;
-
-SELECT 'parameter annoy_index_search_k_nodes';
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, (5.3, 7.3, 2.1))
-LIMIT 5
-SETTINGS annoy_index_search_k_nodes=0; -- searches zero nodes --> no results
-
-SELECT 'parameter max_limit_for_ann_queries';
-EXPLAIN indexes=1
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, (5.3, 7.3, 2.1))
-LIMIT 5
-SETTINGS max_limit_for_ann_queries=2; -- doesn't use the ann index
-
-DROP TABLE tab;
-
-SELECT '--- Test alternative metric (cosine distance) and non-default NumTrees ---';
-
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy('cosineDistance', 200)) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity=5;
-INSERT INTO tab VALUES (1, [0.0, 0.0, 10.0]), (2, [0.0, 0.0, 10.5]), (3, [0.0, 0.0, 9.5]), (4, [0.0, 0.0, 9.7]), (5, [0.0, 0.0, 10.2]), (6, [10.0, 0.0, 0.0]), (7, [9.5, 0.0, 0.0]), (8, [9.7, 0.0, 0.0]), (9, [10.2, 0.0, 0.0]), (10, [10.5, 0.0, 0.0]), (11, [0.0, 10.0, 0.0]), (12, [0.0, 9.5, 0.0]), (13, [0.0, 9.7, 0.0]), (14, [0.0, 10.2, 0.0]), (15, [0.0, 10.5, 0.0]);
-
-SELECT 'WHERE type, L2Distance';
-SELECT *
-FROM tab
-WHERE L2Distance(embedding, [0.0, 0.0, 10.0]) < 1.0
-LIMIT 5;
-
-SELECT 'ORDER BY type, L2Distance';
-SELECT *
-FROM tab
-ORDER BY L2Distance(embedding, [0.0, 0.0, 10.0])
-LIMIT 3;
-
-DROP TABLE tab;
+SET allow_experimental_analyzer = 0;
 
 SELECT '--- Negative tests ---';
 
+DROP TABLE IF EXISTS tab;
+
 -- must have at most 2 arguments
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy('too', 'many', 'arguments')) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy('too', 'many', 'arguments')) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
 
 -- first argument (distance_function) must be String
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy(3)) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy(3)) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
 
 -- 2nd argument (number of trees) must be UInt64
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy('L2Distance', 'not an UInt64')) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
-
--- reject unsupported distance functions
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index embedding TYPE annoy('wormholeDistance')) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_DATA }
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy('L2Distance', 'not an UInt64')) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_QUERY }
 
 -- must be created on single column
-CREATE TABLE tab(id Int32, embedding Array(Float32), INDEX annoy_index (embedding, id) TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_NUMBER_OF_COLUMNS }
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index (vector, id) TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_NUMBER_OF_COLUMNS }
+
+-- reject unsupported distance functions
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy('wormholeDistance')) ENGINE = MergeTree ORDER BY id; -- { serverError INCORRECT_DATA }
 
 -- must be created on Array/Tuple(Float32) columns
 SET allow_suspicious_low_cardinality_types = 1;
-CREATE TABLE tab(id Int32, embedding Float32, INDEX annoy_index embedding TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
-CREATE TABLE tab(id Int32, embedding Array(Float64), INDEX annoy_index embedding TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
-CREATE TABLE tab(id Int32, embedding LowCardinality(Float32), INDEX annoy_index embedding TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
-CREATE TABLE tab(id Int32, embedding Nullable(Float32), INDEX annoy_index embedding TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
+CREATE TABLE tab(id Int32, vector Float32, INDEX annoy_index vector TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
+CREATE TABLE tab(id Int32, vector Array(Float64), INDEX annoy_index vector TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
+CREATE TABLE tab(id Int32, vector Tuple(Float64), INDEX annoy_index vector TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
+CREATE TABLE tab(id Int32, vector LowCardinality(Float32), INDEX annoy_index vector TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
+CREATE TABLE tab(id Int32, vector Nullable(Float32), INDEX annoy_index vector TYPE annoy()) ENGINE = MergeTree ORDER BY id; -- { serverError ILLEGAL_COLUMN }
+
+SELECT '--- Test default GRANULARITY (should be 100 mio. for annoy)---';
+
+CREATE TABLE tab (id Int32, vector Array(Float32), INDEX annoy_index(vector) TYPE annoy) ENGINE=MergeTree ORDER BY id;
+SHOW CREATE TABLE tab;
+DROP TABLE tab;
+
+CREATE TABLE tab (id Int32, vector Array(Float32)) ENGINE=MergeTree ORDER BY id;
+ALTER TABLE tab ADD INDEX annoy_index(vector) TYPE annoy;
+SHOW CREATE TABLE tab;
+
+DROP TABLE tab;
+
+SELECT '--- Test with Array, GRANULARITY = 1, index_granularity = 5 ---';
+
+DROP TABLE IF EXISTS tab;
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy() GRANULARITY 1) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity = 5;
+INSERT INTO tab VALUES (1, [0.0, 0.0, 10.0]), (2, [0.0, 0.0, 10.5]), (3, [0.0, 0.0, 9.5]), (4, [0.0, 0.0, 9.7]), (5, [0.0, 0.0, 10.2]), (6, [10.0, 0.0, 0.0]), (7, [9.5, 0.0, 0.0]), (8, [9.7, 0.0, 0.0]), (9, [10.2, 0.0, 0.0]), (10, [10.5, 0.0, 0.0]), (11, [0.0, 10.0, 0.0]), (12, [0.0, 9.5, 0.0]), (13, [0.0, 9.7, 0.0]), (14, [0.0, 10.2, 0.0]), (15, [0.0, 10.5, 0.0]);
+
+-- rows = 15, index_granularity = 5, GRANULARITY = 1 gives 3 annoy-indexed blocks (each comprising a single granule)
+-- condition 'L2Distance(vector, reference_vector) < 1.0' ensures that only one annoy-indexed block produces results --> "Granules: 1/3"
+
+-- See (*) why commented out
+-- SELECT 'WHERE type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- WHERE L2Distance(vector, [0.0, 0.0, 10.0]) < 1.0
+-- LIMIT 3;
+
+SELECT 'WHERE type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+WHERE L2Distance(vector, [0.0, 0.0, 10.0]) < 1.0
+LIMIT 3;
+
+-- See (*) why commented out
+-- SELECT 'ORDER BY type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- ORDER BY L2Distance(vector, [0.0, 0.0, 10.0])
+-- LIMIT 3;
+
+SELECT 'ORDER BY type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, [0.0, 0.0, 10.0])
+LIMIT 3;
+
+-- Test special cases. Corresponding special case tests are omitted from later tests.
+
+SELECT 'Reference ARRAYs with non-matching dimension are rejected';
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, [0.0, 0.0])
+LIMIT 3; -- { serverError INCORRECT_QUERY }
+
+SELECT 'Special case: MaximumDistance is negative';
+SELECT 'WHERE type, L2Distance';
+SELECT *
+FROM tab
+WHERE L2Distance(vector, [0.0, 0.0, 10.0]) < -1.0
+LIMIT 3; -- { serverError INCORRECT_QUERY }
+
+SELECT 'Special case: setting annoy_index_search_k_nodes';
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, [5.3, 7.3, 2.1])
+LIMIT 3
+SETTINGS annoy_index_search_k_nodes=0; -- searches zero nodes --> no results
+
+SELECT 'Special case: setting max_limit_for_ann_queries';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, [5.3, 7.3, 2.1])
+LIMIT 3
+SETTINGS max_limit_for_ann_queries=2; -- doesn't use the ann index
+
+DROP TABLE tab;
+
+-- Test Tuple embeddings. Triggers different logic than Array inside MergeTreeIndexAnnoy but the same logic as Array above MergeTreeIndexAnnoy.
+-- Therefore test Tuple case just once.
+
+SELECT '--- Test with Tuple, GRANULARITY = 1, index_granularity = 5 ---';
+
+CREATE TABLE tab(id Int32, vector Tuple(Float32, Float32, Float32), INDEX annoy_index vector TYPE annoy() GRANULARITY 1) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity = 5;
+INSERT INTO tab VALUES (1, (0.0, 0.0, 10.0)), (2, (0.0, 0.0, 10.5)), (3, (0.0, 0.0, 9.5)), (4, (0.0, 0.0, 9.7)), (5, (0.0, 0.0, 10.2)), (6, (10.0, 0.0, 0.0)), (7, (9.5, 0.0, 0.0)), (8, (9.7, 0.0, 0.0)), (9, (10.2, 0.0, 0.0)), (10, (10.5, 0.0, 0.0)), (11, (0.0, 10.0, 0.0)), (12, (0.0, 9.5, 0.0)), (13, (0.0, 9.7, 0.0)), (14, (0.0, 10.2, 0.0)), (15, (0.0, 10.5, 0.0));
+
+-- See (*) why commented out
+-- SELECT 'WHERE type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- WHERE L2Distance(vector, (0.0, 0.0, 10.0)) < 1.0
+-- LIMIT 3;
+
+SELECT 'WHERE type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+WHERE L2Distance(vector, (0.0, 0.0, 10.0)) < 1.0
+LIMIT 3;
+
+-- See (*) why commented out
+-- SELECT 'ORDER BY type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- ORDER BY L2Distance(vector, (0.0, 0.0, 10.0))
+-- LIMIT 3;
+
+SELECT 'ORDER BY type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, (0.0, 0.0, 10.0))
+LIMIT 3;
+
+DROP TABLE tab;
+
+-- Not a systematic test, just to make sure no bad things happen
+SELECT '--- Test non-default metric (cosine distance) + non-default NumTrees (200) ---';
+
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy('cosineDistance', 200) GRANULARITY 1) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity = 5;
+INSERT INTO tab VALUES (1, [0.0, 0.0, 10.0]), (2, [0.0, 0.0, 10.5]), (3, [0.0, 0.0, 9.5]), (4, [0.0, 0.0, 9.7]), (5, [0.0, 0.0, 10.2]), (6, [10.0, 0.0, 0.0]), (7, [9.5, 0.0, 0.0]), (8, [9.7, 0.0, 0.0]), (9, [10.2, 0.0, 0.0]), (10, [10.5, 0.0, 0.0]), (11, [0.0, 10.0, 0.0]), (12, [0.0, 9.5, 0.0]), (13, [0.0, 9.7, 0.0]), (14, [0.0, 10.2, 0.0]), (15, [0.0, 10.5, 0.0]);
+
+-- See (*) why commented out
+-- SELECT 'WHERE type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- WHERE L2Distance(vector, [0.0, 0.0, 10.0]) < 1.0
+-- LIMIT 3;
+
+-- See (*) why commented out
+-- SELECT 'ORDER BY type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- ORDER BY L2Distance(vector, [0.0, 0.0, 10.0])
+-- LIMIT 3;
+
+DROP TABLE tab;
+
+SELECT '--- Test with Array, GRANULARITY = 2, index_granularity = 4 ---';
+
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy() GRANULARITY 2) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity = 4;
+INSERT INTO tab VALUES (1, [0.0, 0.0, 10.0, 0.0]), (2, [0.0, 0.0, 10.5, 0.0]), (3, [0.0, 0.0, 9.5, 0.0]), (4, [0.0, 0.0, 9.7, 0.0]), (5, [10.0, 0.0, 0.0, 0.0]), (6, [9.5, 0.0, 0.0, 0.0]), (7, [9.7, 0.0, 0.0, 0.0]), (8, [10.2, 0.0, 0.0, 0.0]), (9, [0.0, 10.0, 0.0, 0.0]), (10, [0.0, 9.5, 0.0, 0.0]), (11, [0.0, 9.7, 0.0, 0.0]), (12, [0.0, 9.7, 0.0, 0.0]), (13, [0.0, 0.0, 0.0, 10.3]), (14, [0.0, 0.0, 0.0, 9.5]), (15, [0.0, 0.0, 0.0, 10.0]), (16, [0.0, 0.0, 0.0, 10.5]);
+
+-- rows = 16, index_granularity = 4, GRANULARITY = 2 gives 2 annoy-indexed blocks (each comprising two granules)
+-- condition 'L2Distance(vector, reference_vector) < 1.0' ensures that only one annoy-indexed block produces results --> "Granules: 2/4"
+
+-- See (*) why commented out
+-- SELECT 'WHERE type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- WHERE L2Distance(vector, [10.0, 0.0, 10.0, 0.0]) < 5.0
+-- LIMIT 3;
+
+SELECT 'WHERE type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+WHERE L2Distance(vector, [10.0, 0.0, 10.0, 0.0]) < 5.0
+LIMIT 3;
+
+-- See (*) why commented out
+-- SELECT 'ORDER BY type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- ORDER BY L2Distance(vector, [10.0, 0.0, 10.0, 0.0])
+-- LIMIT 3;
+
+SELECT 'ORDER BY type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, [10.0, 0.0, 10.0, 0.0])
+LIMIT 3;
+
+DROP TABLE tab;
+
+SELECT '--- Test with Array, GRANULARITY = 4, index_granularity = 4 ---';
+
+CREATE TABLE tab(id Int32, vector Array(Float32), INDEX annoy_index vector TYPE annoy() GRANULARITY 4) ENGINE = MergeTree ORDER BY id SETTINGS index_granularity = 4;
+INSERT INTO tab VALUES (1, [0.0, 0.0, 10.0, 0.0]), (2, [0.0, 0.0, 10.5, 0.0]), (3, [0.0, 0.0, 9.5, 0.0]), (4, [0.0, 0.0, 9.7, 0.0]), (5, [10.0, 0.0, 0.0, 0.0]), (6, [9.5, 0.0, 0.0, 0.0]), (7, [9.7, 0.0, 0.0, 0.0]), (8, [10.2, 0.0, 0.0, 0.0]), (9, [0.0, 10.0, 0.0, 0.0]), (10, [0.0, 9.5, 0.0, 0.0]), (11, [0.0, 9.7, 0.0, 0.0]), (12, [0.0, 9.7, 0.0, 0.0]), (13, [0.0, 0.0, 0.0, 10.3]), (14, [0.0, 0.0, 0.0, 9.5]), (15, [0.0, 0.0, 0.0, 10.0]), (16, [0.0, 0.0, 0.0, 10.5]);
+
+-- rows = 16, index_granularity = 4, GRANULARITY = 4 gives a single annoy-indexed block (comprising all granules)
+-- no two matches happen to be located in the same granule, so with LIMIT = 3, we'll get "Granules: 2/4"
+
+-- See (*) why commented out
+-- SELECT 'WHERE type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- WHERE L2Distance(vector, [10.0, 0.0, 10.0, 0.0]) < 5.0
+-- LIMIT 3;
+
+SELECT 'WHERE type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+WHERE L2Distance(vector, [10.0, 0.0, 10.0, 0.0]) < 5.0
+LIMIT 3;
+
+-- See (*) why commented out
+-- SELECT 'ORDER BY type, L2Distance';
+-- SELECT *
+-- FROM tab
+-- ORDER BY L2Distance(vector, [10.0, 0.0, 10.0, 0.0])
+-- LIMIT 3;
+
+SELECT 'ORDER BY type, L2Distance, check that index is used';
+EXPLAIN indexes=1
+SELECT *
+FROM tab
+ORDER BY L2Distance(vector, [10.0, 0.0, 10.0, 0.0])
+LIMIT 3;
+
+DROP TABLE tab;
+
+-- (*) Storage and search in Annoy indexes is inherently random. Tests which check for exact row matches would be unstable. Therefore,
+-- comment them out.
diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index d6cef1883f4..021855e399f 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -26,6 +26,7 @@ AlertManager
 Alexey
 AnyEvent
 AppleClang
+Approximative
 ArrayJoin
 ArrowStream
 AsyncInsertCacheSize
@@ -1005,6 +1006,7 @@ anyLast
 anyheavy
 anylast
 appendTrailingCharIfAbsent
+approximative
 argMax
 argMin
 argmax
@@ -2419,6 +2421,7 @@ unescaping
 unhex
 unicode
 unidimensional
+unintuitive
 uniq
 uniqCombined
 uniqExact

From 4d4e5c690e446db23f8a1ef7fc1e577df93e9373 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 8 Jun 2023 17:10:51 +0200
Subject: [PATCH 260/722] update docs spelling check failed

---
 docs/en/operations/settings/settings.md                | 2 +-
 docs/en/sql-reference/functions/date-time-functions.md | 4 +---
 utils/check-style/aspell-ignore/en/aspell-dict.txt     | 1 +
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 77c9238e4c7..6c9c8349519 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4116,7 +4116,7 @@ SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS sessi
 
 This happens due to different parsing pipelines:
   - `toDateTime('2000-01-01 00:00:00')` creates a new DateTime in a usual way, and thus `session_timezone` setting from query context is applied.
-  - `2000-01-01 00:00:00` is parsed to a DateTime inheriting type of `d` column, including DateTime's time zone, and `session_timezone` has no impact on this value.
+  - `2000-01-01 00:00:00` is parsed to a DateTime inheriting type of `d` column, including its time zone, and `session_timezone` has no impact on this value.
 
 Possible values:
 
diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index 1a5b0dcabf9..89ac6d438ff 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -163,7 +163,7 @@ Type: [String](../../sql-reference/data-types/string.md).
 ## serverTimeZone
 
 Returns the default timezone of the server, i.e. the value of setting [timezone](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
-If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise it produces a constant value.
+If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise, it produces a constant value.
 
 **Syntax**
 
@@ -171,8 +171,6 @@ If it is executed in the context of a distributed table, then it generates a nor
 serverTimeZone()
 ```
 
-Alias: `ServerTimezone`, `servertimezone`.
-
 **Returned value**
 
 -   Timezone.
diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index ded7a4643a9..8301579b6a8 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -484,6 +484,7 @@ russian
 rw
 sasl
 schemas
+servertimezone
 simdjson
 skippingerrors
 sparsehash

From ea9d0f6c3c94ae6fef1bb552958455c7ab9b25e7 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 8 Jun 2023 18:18:12 +0200
Subject: [PATCH 261/722] Fix

---
 .../IO/CachedOnDiskReadBufferFromFile.cpp     | 55 +++++++++----------
 1 file changed, 27 insertions(+), 28 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 6bf72434580..6317aba20e9 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -1038,34 +1038,6 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
 
     current_file_segment_counters.increment(ProfileEvents::FileSegmentUsedBytes, available());
 
-    // No necessary because of the SCOPE_EXIT above, but useful for logging below.
-    if (download_current_segment)
-        file_segment.completePartAndResetDownloader();
-
-    chassert(!file_segment.isDownloader());
-
-    LOG_TEST(
-        log,
-        "Key: {}. Returning with {} bytes, buffer position: {} (offset: {}, predownloaded: {}), "
-        "buffer available: {}, current range: {}, file offset of buffer end: {}, impl offset: {}, file segment state: {}, "
-        "current write offset: {}, read_type: {}, reading until position: {}, started with offset: {}, "
-        "remaining ranges: {}",
-        cache_key.toString(),
-        working_buffer.size(),
-        getPosition(),
-        offset(),
-        needed_to_predownload,
-        available(),
-        current_read_range.toString(),
-        file_offset_of_buffer_end,
-        implementation_buffer->getFileOffsetOfBufferEnd(),
-        FileSegment::stateToString(file_segment.state()),
-        file_segment.getCurrentWriteOffset(false),
-        toString(read_type),
-        read_until_position,
-        first_offset,
-        file_segments->toString());
-
     if (size == 0 && file_offset_of_buffer_end < read_until_position)
     {
         size_t cache_file_size = getFileSizeFromReadBuffer(*implementation_buffer);
@@ -1086,6 +1058,33 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
             file_segment.getInfoForLog());
     }
 
+    // No necessary because of the SCOPE_EXIT above, but useful for logging below.
+    if (download_current_segment)
+        file_segment.completePartAndResetDownloader();
+
+    chassert(!file_segment.isDownloader());
+
+    LOG_TEST(
+        log,
+        "Key: {}. Returning with {} bytes, buffer position: {} (offset: {}, predownloaded: {}), "
+        "buffer available: {}, current range: {}, file offset of buffer end: {}, file segment state: {}, "
+        "current write offset: {}, read_type: {}, reading until position: {}, started with offset: {}, "
+        "remaining ranges: {}",
+        cache_key.toString(),
+        working_buffer.size(),
+        getPosition(),
+        offset(),
+        needed_to_predownload,
+        available(),
+        current_read_range.toString(),
+        file_offset_of_buffer_end,
+        FileSegment::stateToString(file_segment.state()),
+        file_segment.getCurrentWriteOffset(false),
+        toString(read_type),
+        read_until_position,
+        first_offset,
+        file_segments->toString());
+
     return result;
 }
 

From a1b1e12e5bb5d6a1937f9081eb43374afef60f9b Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Thu, 8 Jun 2023 18:38:51 +0200
Subject: [PATCH 262/722] upd spell

---
 docs/en/sql-reference/functions/date-time-functions.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index 89ac6d438ff..62bbb84053a 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -158,9 +158,9 @@ Type: [String](../../sql-reference/data-types/string.md).
 
 **See also**
 
-- [serverTimeZone](#serverTimeZone)
+- [serverTimezone](#serverTimeZone)
 
-## serverTimeZone
+## serverTimezone
 
 Returns the default timezone of the server, i.e. the value of setting [timezone](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
 If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise, it produces a constant value.

From f34937687e6316b11fb2d61b95f818fd4828a9ce Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Thu, 8 Jun 2023 18:00:54 +0000
Subject: [PATCH 263/722] enable settings for mutation throttling by default

---
 src/Storages/MergeTree/MergeTreeSettings.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeSettings.h b/src/Storages/MergeTree/MergeTreeSettings.h
index 33aea358078..a3d475b74b2 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.h
+++ b/src/Storages/MergeTree/MergeTreeSettings.h
@@ -67,8 +67,8 @@ struct Settings;
     M(Bool, remove_rolled_back_parts_immediately, 1, "Setting for an incomplete experimental feature.", 0) \
     M(CleanDeletedRows, clean_deleted_rows, CleanDeletedRows::Never, "Is the Replicated Merge cleanup has to be done automatically at each merge or manually (possible values are 'Always'/'Never' (default))", 0) \
     M(UInt64, replicated_max_mutations_in_one_entry, 10000, "Max number of mutation commands that can be merged together and executed in one MUTATE_PART entry (0 means unlimited)", 0) \
-    M(UInt64, number_of_mutations_to_delay, 0, "If table has at least that many unfinished mutations, artificially slow down mutations of table. Disabled if set to 0", 0) \
-    M(UInt64, number_of_mutations_to_throw, 0, "If table has at least that many unfinished mutations, throw 'Too many mutations' exception. Disabled if set to 0", 0) \
+    M(UInt64, number_of_mutations_to_delay, 500, "If table has at least that many unfinished mutations, artificially slow down mutations of table. Disabled if set to 0", 0) \
+    M(UInt64, number_of_mutations_to_throw, 1000, "If table has at least that many unfinished mutations, throw 'Too many mutations' exception. Disabled if set to 0", 0) \
     M(UInt64, min_delay_to_mutate_ms, 10, "Min delay of mutating MergeTree table in milliseconds, if there are a lot of unfinished mutations", 0) \
     M(UInt64, max_delay_to_mutate_ms, 1000, "Max delay of mutating MergeTree table in milliseconds, if there are a lot of unfinished mutations", 0) \
     \

From a2355673d8349f4a689f46a354c335a7647a5c59 Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Thu, 8 Jun 2023 21:18:29 +0000
Subject: [PATCH 264/722] fix tests

---
 tests/queries/0_stateless/02125_many_mutations.sh   | 2 +-
 tests/queries/0_stateless/02125_many_mutations_2.sh | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02125_many_mutations.sh b/tests/queries/0_stateless/02125_many_mutations.sh
index 7a89e5f7c4f..c3108df5ae3 100755
--- a/tests/queries/0_stateless/02125_many_mutations.sh
+++ b/tests/queries/0_stateless/02125_many_mutations.sh
@@ -5,7 +5,7 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CURDIR"/../shell_config.sh
 
-$CLICKHOUSE_CLIENT -q "create table many_mutations (x UInt32, y UInt32) engine = MergeTree order by x"
+$CLICKHOUSE_CLIENT -q "create table many_mutations (x UInt32, y UInt32) engine = MergeTree order by x settings number_of_mutations_to_delay = 0, number_of_mutations_to_throw = 0"
 $CLICKHOUSE_CLIENT -q "insert into many_mutations values (0, 0), (1, 1)"
 $CLICKHOUSE_CLIENT -q "system stop merges many_mutations"
 
diff --git a/tests/queries/0_stateless/02125_many_mutations_2.sh b/tests/queries/0_stateless/02125_many_mutations_2.sh
index df170a402c6..52866a54974 100755
--- a/tests/queries/0_stateless/02125_many_mutations_2.sh
+++ b/tests/queries/0_stateless/02125_many_mutations_2.sh
@@ -5,7 +5,7 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CURDIR"/../shell_config.sh
 
-$CLICKHOUSE_CLIENT -q "create table many_mutations (x UInt32, y UInt32) engine = MergeTree order by x"
+$CLICKHOUSE_CLIENT -q "create table many_mutations (x UInt32, y UInt32) engine = MergeTree order by x settings number_of_mutations_to_delay = 0, number_of_mutations_to_throw = 0"
 $CLICKHOUSE_CLIENT -q "insert into many_mutations select number, number + 1 from numbers(2000)"
 $CLICKHOUSE_CLIENT -q "system stop merges many_mutations"
 

From 7578203b46b1657373fc27a5f05e56531581916b Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Fri, 9 Jun 2023 03:44:43 +0000
Subject: [PATCH 265/722] Changes after review

---
 docs/en/interfaces/cli.md       | 240 +++++++++++++++++---------------
 docs/ru/interfaces/cli.md       | 235 ++++++++++++++++---------------
 programs/client/Client.cpp      |   4 +-
 src/Client/ConnectionString.cpp |  49 ++++---
 4 files changed, 281 insertions(+), 247 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index c36887672c7..2126c538c5d 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -158,116 +158,6 @@ $ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" -q "SELECT * FROM
 $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --query "SELECT {col:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"
 ```
 
-## Connection string {#connection_string}
-
-The connection string for clickhouse-client is presented in URI format:
-
-```text
-clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
-```
-
-where user_info is: `user[:password]`
-and hosts_and_ports is a list of values: `[host][:port],[host][:port]` Port is not mandatory.
-and query_parameters is a list of parameter[=value]: `param_name[=value]&param_name[=value]...` value may not be required for some of the parameters. Parameter names are case sensitive.
-
-Allowed query_parameters keys:
-
-- `secure` or shorthanded `s` - no value. If specified, client will connect to the server over a secure connection (TLS). See `secure` in [command-line-options](#command-line-options)
-
-These examples illustrate valid connection strings for clickhouse-client:
-
-```text
-clickhouse:
-clickhouse://localhost
-clickhouse://localhost:9000
-clickhouse://localhost/default
-clickhouse://default@localhost
-clickhouse://user:password@localhost
-clickhouse://user_name@localhost/some_database?secure
-clickhouse://host1:9000,host2:5000/some_database
-```
-
-The host component can either be an IP address or a host name. Put an IPv6 address in square brackets to specify it:
-
-```text
-clickhouse://[2001:db8::1234]
-```
-
-If user or/and password are not specified, default values will be used.
-If host is not specified, the default host will be used (localhost).
-If port is not specified, the default port will be used (9000).
-If database is not specified, the default database will be used.
-
-User, password, and database can be specified in the connection string either in `--user`, `--password`, `--database` command line options.
-
-The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except `--host(h)` and `--port`.
-
-### Multiple hosts {#connection_string_multiple_hosts}
-
-URI allows multiple hosts to be connected to, and the client will try to connect to those hosts using the order from URI and command line options. The hosts and ports in the URI accept comma-separated lists of values.
-
-If more than one host is supplied, or if a single host name is translated to more than one address, each host and address will be attempted one at a time until one is successful. The remaining hosts after successful connection in the list are not tried.
-
-### Percent encoding {#connection_string_uri_percent_encoding}
-
-Hosts, user name, password, database, and query parameters should be [Percent-Encoded](https://en.wikipedia.org/wiki/URL_encoding) if values contain invalid URI characters.
-
-### Examples {#connection_string_examples}
-
-Connect to localhost using port 9000 and execute the query "SELECT 1".
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" --query "SELECT 1"
-```
-
-Connect to localhost using port 9000 in interactive, multiline mode.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" -m
-```
-
-Connect to localhost using port 9000 in interactive mode with the user specified in `--user` option.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" --user default
-```
-
-Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the command line option.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" --database my_database
-```
-
-Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the connection string.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000/my_database"
-```
-
-Connect to localhost using port 9000 in interactive mode to `my_database` database specified in the connection string and a secure connection using shorthanded 's' URI parameter.
-
-```bash
-clickhouse-client "clickhouse://localhost/my_database?s"
-```
-
-Connect to default host using default port, default user, and default database.
-
-``` bash
-clickhouse-client "clickhouse:"
-```
-
-Connect to the default host using the default port, using user user_name and no password.
-
-``` bash
-clickhouse-client "clickhouse://user_name@"
-```
-
-Connect to localhost using email as the user name. `@` symbol is percent encoded to `%40`.
-
-``` bash
-clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"
-```
-
 ## Configuring {#interfaces_cli_configuration}
 
 You can pass parameters to `clickhouse-client` (all parameters have a default value) using:
@@ -304,7 +194,135 @@ You can pass parameters to `clickhouse-client` (all parameters have a default va
 - `--print-profile-events` – Print `ProfileEvents` packets.
 - `--profile-events-delay-ms` – Delay between printing `ProfileEvents` packets (-1 - print only totals, 0 - print every single packet).
 
-Since version 20.5, `clickhouse-client` has automatic syntax highlighting (always enabled).
+Instead of --host, --port, --user and --password options, ClickHouse client also supports connection strings.
+
+
+## Connection string {#connection_string}
+
+clickhouse-client alternatively supports connecting to clickhouse server using a connection string similar to [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). It has the following syntax:
+
+```text
+clickhouse:[//[user_info@][hosts_and_ports]][/database][?query_parameters]
+```
+
+Where
+
+- `user_spec` - (optional) is a user and an optional password,
+- `hostspec` - (optional) is a list of hosts and optional ports `host[:port] [, host:[port]], ...`,
+- `database` - (optional) is the database name,
+- `paramspec` - (optional) is a list of key-value pairs `param1=value1[,&param2=value2], ...`. For some parameters, no value is required. Parameter names and values are case-sensitive.
+
+
+
+The host component can either be an IP address or a host name. Put an IPv6 address in square brackets to specify it:
+
+```text
+clickhouse://[2001:db8::1234]
+```
+
+If user is not specified, `default` user without password will be used.
+If host is not specified, the `localhost` will be used (localhost).
+If port is not specified, `9000` will be used as port.
+If database is not specified, the `default` database will be used.
+
+If the user name, password or database was specified in the connection string, it cannot be specified using `--user`, `--password` or `--database` (and vice versa).
+
+The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except `--host(h)` and `--port`.
+
+### Multiple hosts {#connection_string_multiple_hosts}
+
+URI allows multiple hosts to be connected to. Connection strings can contain multiple hosts. ClickHouse-client will try to connect to these hosts in order (i.e. from left to right). After the connection is established, no attempt to connect to the remaining hosts is made.
+
+### Allowed query_parameters keys {#connection_string_query_parameters}
+
+- `secure` or shorthanded `s` - no value. If specified, client will connect to the server over a secure connection (TLS). See `secure` in [command-line-options](#command-line-options)
+
+### Percent encoding {#connection_string_uri_percent_encoding}
+
+Non-US ASCII characters in the user name, password, hosts, database or query parameters must be [percent-encoded](https://en.wikipedia.org/wiki/URL_encoding).
+
+### Examples {#connection_string_examples}
+
+Connect to localhost using port 9000 and execute the query "SELECT 1".
+
+``` bash
+clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"
+```
+
+Connect to localhost using user `john` with password `secret`, host `127.0.0.1` and port `9000`
+
+``` bash
+clickhouse-client clickhouse://john:secret@127.0.0.1:9000
+```
+
+Connect to localhost using default user, host with IPV6 address `[::1]` and port `9000`.
+
+``` bash
+clickhouse-client clickhouse://[::1]:9000
+```
+
+Connect to localhost using default user, host with IPV6 address `[2001:db8:3333:4444:5555:6666:7777:8888]` and port `9000`.
+
+``` bash
+clickhouse-client clickhouse://[2001:db8:3333:4444:5555:6666:7777:8888]:9000
+```
+
+Connect to localhost using port 9000 in multiline mode.
+
+``` bash
+clickhouse-client clickhouse://localhost:9000 '-m'
+```
+
+Connect to localhost using port 9000 with the user `default`.
+
+``` bash
+clickhouse-client clickhouse://default@localhost:9000 --user default
+
+# equivalent to:
+clickhouse-client clickhouse://localhost:9000 --user default
+```
+
+Connect to localhost using port 9000 to `my_database` database.
+
+``` bash
+clickhouse-client clickhouse://localhost:9000/my_database
+
+# equivalent to:
+clickhouse-client clickhouse://localhost:9000 --database my_database
+```
+
+Connect to localhost using port 9000 to `my_database` database specified in the connection string and a secure connection using shorthanded 's' URI parameter.
+
+```bash
+clickhouse-client clickhouse://localhost/my_database?s
+
+# equivalent to:
+clickhouse-client clickhouse://localhost/my_database -s
+```
+
+Connect to default host using default port, default user, and default database.
+
+``` bash
+clickhouse-client clickhouse:
+```
+
+Connect to the default host using the default port, using user user_name and no password.
+
+``` bash
+clickhouse-client clickhouse://user_name@
+```
+
+Connect to localhost using email as the user name. `@` symbol is percent encoded to `%40`.
+
+``` bash
+clickhouse-client clickhouse://some_user%40some_mail.com@localhost:9000
+```
+
+Connect to one of provides hosts: `192.168.1.15`, `192.168.1.25`.
+
+``` bash
+clickhouse-client clickhouse://192.168.1.15,192.168.1.25 
+```
 
 ### Configuration Files {#configuration_files}
 
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index 801a72e48ec..f86ccb42356 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -110,117 +110,6 @@ $ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" -q "SELECT * FROM
 $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --query "SELECT {col:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"
 ```
 
-## Строка подключения {#connection_string}
-
-Строка подключения для clickhouse-client представлена в формате URI:
-
-```text
-clickhouse://[user_info@][hosts_and_ports][/dbname][?query_parameters]
-```
-
-где user_info - это: `user[:password]`
-hosts_and_ports - это список значений: `[host][:port],[host][:port]`. Port может быть не задан.
-query_parameters - это список пар ключ[=значение]: `param_name[=value]&param_name[=value]...`. Значение может быть пустым.
-Имена параметров чувствительны к регистру.
-
-Допустимые ключи query_parameters:
-
-- `secure` или сокращенно `s` - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. `secure` в [command-line-options](#command-line-options).
-
-Эти примеры иллюстрируют допустимые строки подключения для clickhouse-client:
-
-```text
-clickhouse:
-clickhouse://localhost
-clickhouse://localhost:9000
-clickhouse://localhost/default
-clickhouse://default@localhost
-clickhouse://user:password@localhost
-clickhouse://имя_пользователя@localhost/some_database?secure
-clickhouse://host1:9000,host2:5000/some_database
-```
-
-Параметр host может быть либо IP-адресом, либо именем хоста. Для указания IPv6-адреса поместите его в квадратные скобки:
-
-```text
-clickhouse://[2001:db8::1234]
-```
-
-Если пользователь или/и пароль не указаны, будут использоваться значения по умолчанию.
-Если host не указан, будет использован хост по умолчанию (localhost).
-Если port не указан, будет использоваться порт по умолчанию (9000).
-Если база данных не указана, будет использоваться база данных по умолчанию (default).
-
-Пользователь, пароль и база данных могут быть указаны в строке подключения либо в опциях командной строки `--user`, `--password`, `--database`.
-
-Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме `--host (h)` и `--port`.
-
-### Несколько хостов {#connection_string_multiple_hosts}
-
-URI позволяет подключаться к нескольким хостам, и клиент будет пытаться подключиться к этим хостам, используя порядок из URI и опций командной строки. Хосты и порты в URI принимают списки значений, разделенные запятыми.
-
-Если указано более одного хоста или если одно имя хоста транслируется в несколько адресов, Клиент будет будет пытаться подключится к каждому хосту и адресу в порядке в котором они встречаются в URI И опциях клиента, пока не будет установлено соединение. Соединение разрывается, если соединение установлено и аутентификация прошла успешно, остальные хосты в списке игнорируются.
-
-### Кодирование URI {#connection_string_uri_percent_encoding}
-
-Хосты, имя пользователя, пароль, имя базы данных, и параметры запроса должны быть [закодированы](https://ru.wikipedia.org/wiki/URL#%D0%9A%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_URL), если значения содержат невалидные символы URI.
-
-### Примеры {#connection_string_examples}
-
-Подключиться к localhost через порт 9000 и выполнить запрос "SELECT 1"
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" --query "SELECT 1"
-```
-
-Подключиться к localhost через порт 9000 в интерактивном, многострочном режиме.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" -m
-```
-
-Подключиться к localhost через порт 9000 в интерактивном режиме с пользователем default, указанным в опции --user.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" --user default
-```
-
-Подключиться к localhost, используя порт 9000 в интерактивном режиме с базой данных `my_database`, указанной в опции командной строки.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000" --database my_database
-```
-
-Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных `my_database`, указанной в строке подключения.
-
-``` bash
-clickhouse-client "clickhouse://localhost:9000/my_database"
-```
-
-Подключиться к localhost через порт 9000 в интерактивном режиме с базой данных `my_database`, указанной в строке подключения, и безопасным соединением, используя короткий вариант команды URI 's'.
-
-``` bash
-clickhouse-client "clickhouse://localhost/my_database?s"
-```
-
-Подключиться к хосту по умолчанию с использованием порта по умолчанию, пользователя по умолчанию, и базы данных по умолчанию.
-
-``` bash
-clickhouse-client "clickhouse:"
-```
-
-Подключиться к хосту по умолчанию через порт по умолчанию, используя имя пользователя user_name без пароля.
-
-``` bash
-clickhouse-client "clickhouse://user_name@"
-```
-
-Подключиться к localhost, используя электронную почту, как имя пользователя. Символ `@` закодирован как `%40`.
-
-``` bash
-clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"
-```
-
 ## Конфигурирование {#interfaces_cli_configuration}
 
 В `clickhouse-client` можно передавать различные параметры (все параметры имеют значения по умолчанию) с помощью:
@@ -253,7 +142,129 @@ clickhouse-client "clickhouse://some_user%40some_mail.com@localhost:9000"
 -   `--history_file` - путь к файлу с историей команд.
 -   `--param_<name>` — значение параметра для [запроса с параметрами](#cli-queries-with-parameters).
 
-Начиная с версии 20.5, в `clickhouse-client` есть автоматическая подсветка синтаксиса (включена всегда).
+## Строка подключения {#connection_string}
+
+clickhouse-client также поддерживает подключение к серверу clickhouse с помощью строки подключения, аналогичной [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). Она имеет следующий синтаксис:
+
+```text
+clickhouse:[//[user_info@][hosts_and_ports]][/database][?query_parameters]
+```
+
+Где
+
+- `user_spec` - (необязательно) - это пользователь и необязательный пароль,
+- `hostspec` - (необязательно) - список хостов и необязательных портов. `host[:port] [, host:[port]], ...`,
+- `database` - (необязательно) - это имя базы данных,
+- `paramspec` - (опционально) список пар ключ-значение `param1=value1[,&param2=value2], ...`. Для некоторых параметров значение не требуется. Имена и значения параметров чувствительны к регистру.
+
+Параметр host может быть либо IP-адресом, либо именем хоста. Для указания IPv6-адреса поместите его в квадратные скобки:
+
+```text
+clickhouse://[2001:db8::1234]
+```
+
+Если user не указан, будут использоваться имя пользователя `default`.
+Если host не указан, будет использован хост `localhost`.
+Если port не указан, будет использоваться порт `9000`.
+Если база данных не указана, будет использоваться база данных `default`.
+
+Если имя пользователя, пароль или база данных были указаны в строке подключения, их нельзя указать с помощью `--user`, `--password` или `--database` (и наоборот).
+
+Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме `--host (h)` и `--port`.
+
+### Несколько хостов {#connection_string_multiple_hosts}
+
+URI позволяет подключаться к нескольким хостам. Строки подключения могут содержать несколько хостов. ClickHouse-client будет пытаться подключиться к этим хостам по порядку (т.е. слева направо). После установления соединения попытки подключения к оставшимся хостам не предпринимаются.
+
+### Допустимые ключи query_parameters {#connection_string_query_parameters}
+
+- `secure` или сокращенно `s` - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. `secure` в [command-line-options](#command-line-options).
+
+### Кодирование URI {#connection_string_uri_percent_encoding}
+
+Не US ASCII символы в имени пользователя, пароле, хостах, базе данных или параметрах запроса должны быть [закодированы](https://ru.wikipedia.org/wiki/URL#%D0%9A%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_URL).
+
+### Примеры {#connection_string_examples}
+
+Подключиться к localhost через порт 9000 и выполнить запрос "SELECT 1"
+
+``` bash
+clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"
+```
+Подключиться к localhost, используя пользователя `john` с паролем `secret`, хост `127.0.0.1` и порт `9000`
+
+``bash
+clickhouse-client clickhouse://john:secret@127.0.0.1:9000
+```
+
+Подключиться к localhost, используя пользователя по умолчанию, хост с IPV6 адресом `[::1]` и порт `9000`.
+
+``` bash
+clickhouse-client clickhouse://[::1]:9000
+```
+
+Подключиться к localhost, используя пользователя по умолчанию, хост с IPV6 адресом `[2001:db8:3333:4444:5555:6666:7777:8888]` и портом `9000`.
+
+`` bash
+clickhouse-client clickhouse://[2001:db8:3333:4444:5555:6666:7777:8888]:9000
+```
+
+Подключиться к localhost через порт 9000  многострочном режиме.
+
+``` bash
+clickhouse-client clickhouse://localhost:9000 '-m'
+```
+
+Подключиться к localhost через порт 9000 с пользователем default.
+
+``` bash
+clickhouse-client clickhouse://default@localhost:9000
+
+# Эквивалетно:
+clickhouse-client clickhouse://localhost:9000 --user default
+```
+
+Подключиться к localhost через порт 9000 с базой данных `my_database`
+
+``` bash
+clickhouse-client clickhouse://localhost:9000/my_database
+
+# Эквивалетно:
+clickhouse-client clickhouse://localhost:9000 --database my_database
+```
+
+Подключиться к localhost через порт 9000 с базой данных `my_database`, указанной в строке подключения, используя безопасным соединением  при помощи короткого варианта параметра URI 's'.
+
+``` bash
+clickhouse-client clickhouse://localhost/my_database?s
+
+# Эквивалетно:
+clickhouse-client clickhouse://localhost/my_database -s
+```
+
+Подключиться к хосту по умолчанию с использованием порта по умолчанию, пользователя по умолчанию, и базы данных по умолчанию.
+
+``` bash
+clickhouse-client clickhouse:
+```
+
+Подключиться к хосту по умолчанию через порт по умолчанию, используя имя пользователя user_name без пароля.
+
+``` bash
+clickhouse-client clickhouse://user_name@
+```
+
+Подключиться к localhost, используя электронную почту, как имя пользователя. Символ `@` закодирован как `%40`.
+
+``` bash
+clickhouse-client clickhouse://some_user%40some_mail.com@localhost:9000
+```
+
+Подключится к одному из хостов: `192.168.1.15`, `192.168.1.25`.
+
+``` bash
+clickhouse-client clickhouse://192.168.1.15,192.168.1.25 
+```
 
 ### Конфигурационные файлы {#configuration_files}
 
diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index e513314387f..1429853e333 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -1326,7 +1326,7 @@ void Client::readArguments(
             else if (arg.starts_with("--host") || arg.starts_with("-h"))
             {
                 if (has_connection_string)
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing connection string and --host/--port client arguments is prohibited");
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing a connection string and --host argument is prohibited");
 
                 std::string host_arg;
                 /// --host host
@@ -1360,7 +1360,7 @@ void Client::readArguments(
             else if (arg.starts_with("--port"))
             {
                 if (has_connection_string)
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing connection string and --host/--port client arguments is prohibited");
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing a connection string and --port argument is prohibited");
 
                 auto port_arg = String{arg};
                 /// --port port
diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index 95fec5b52ee..2e475a1f49d 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -26,21 +26,20 @@ using namespace std::literals::string_view_literals;
 
 constexpr auto CONNECTION_URI_SCHEME = "clickhouse:"sv;
 
-void uriDecode(std::string & uri_encoded_string, bool plus_as_space)
+std::string uriDecode(const std::string & uri_encoded_string, bool plus_as_space)
 {
-    std::string temp;
-    Poco::URI::decode(uri_encoded_string, temp, plus_as_space);
-    std::swap(temp, uri_encoded_string);
+    std::string decoded_string;
+    Poco::URI::decode(uri_encoded_string, decoded_string, plus_as_space);
+    return decoded_string;
 }
 
 void getHostAndPort(const Poco::URI & uri, std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
 {
-    auto host = uri.getHost();
     std::vector<std::string> host_and_port;
+    auto host = uri.getHost();
     if (!host.empty())
     {
-        uriDecode(host, false);
-        host_and_port.push_back("--host="s + host);
+        host_and_port.push_back("--host="s + uriDecode(host, false));
     }
 
     // Port can be written without host (":9000"). Empty host name equals to default host.
@@ -52,7 +51,7 @@ void getHostAndPort(const Poco::URI & uri, std::vector<std::vector<std::string>>
         hosts_and_ports_arguments.push_back(std::move(host_and_port));
 }
 
-void getHostAndPort(
+void buildConnectionString(
     Poco::URI & uri,
     std::vector<std::vector<std::string>> & hosts_and_ports_arguments,
     std::string_view host_and_port,
@@ -96,13 +95,13 @@ bool tryParseConnectionString(
     std::vector<std::string> & common_arguments,
     std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
 {
+    if (connection_string == CONNECTION_URI_SCHEME)
+        return true;
+
     if (!connection_string.starts_with(CONNECTION_URI_SCHEME))
         return false;
 
-    if (connection_string.size() == CONNECTION_URI_SCHEME.size())
-        return true;
-
-    auto offset = CONNECTION_URI_SCHEME.size();
+    size_t offset = CONNECTION_URI_SCHEME.size();
     if ((connection_string.substr(offset).starts_with("//")))
         offset += 2;
 
@@ -146,7 +145,7 @@ bool tryParseConnectionString(
         {
             if (*it == ',')
             {
-                getHostAndPort(uri, hosts_and_ports_arguments, {last_host_begin, it}, {hosts_end, connection_string.end()});
+                buildConnectionString(uri, hosts_and_ports_arguments, {last_host_begin, it}, {hosts_end, connection_string.end()});
                 last_host_begin = it + 1;
             }
         }
@@ -154,11 +153,11 @@ bool tryParseConnectionString(
         if (uri.empty())
         {
             // URI has no host specified
-            uri = std::string{connection_string.begin(), connection_string.end()};
+            uri = std::string(connection_string);
             getHostAndPort(uri, hosts_and_ports_arguments);
         }
         else
-            getHostAndPort(uri, hosts_and_ports_arguments, {last_host_begin, hosts_end}, {hosts_end, connection_string.end()});
+            buildConnectionString(uri, hosts_and_ports_arguments, {last_host_begin, hosts_end}, {hosts_end, connection_string.end()});
 
         Poco::URI::QueryParameters params = uri.getQueryParameters();
         for (const auto & param : params)
@@ -166,12 +165,12 @@ bool tryParseConnectionString(
             if (param.first == "secure" || param.first == "s")
             {
                 if (!param.second.empty())
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "secure URI argument does not require value");
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "secure URI query parameter does not require value");
 
                 common_arguments.push_back(makeArgument(param.first));
             }
             else
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "URI argument {} is unknown", param.first);
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "URI query parameter {} is unknown", param.first);
         }
 
         auto user_info = uri.getUserInfo();
@@ -180,21 +179,27 @@ bool tryParseConnectionString(
             // Poco::URI doesn't decode user name/password by default.
             // But ClickHouse allows to have users with email user name like: 'john@some_mail.com'
             // john@some_mail.com should be percent-encoded: 'john%40some_mail.com'
-            uriDecode(user_info, true);
             std::string::size_type pos = user_info.find(':');
             if (pos != std::string::npos)
             {
                 common_arguments.push_back("--user");
-                common_arguments.push_back(user_info.substr(0, pos));
+                common_arguments.push_back(uriDecode(user_info.substr(0, pos), true));
 
                 ++pos; // Skip ':'
                 common_arguments.push_back("--password");
-                common_arguments.push_back(user_info.substr(pos));
+                if (user_info.size() > pos + 1)
+                    common_arguments.push_back(uriDecode(user_info.substr(pos), true));
+                else
+                {
+                    // in case of user_info == 'user:', ':' is specified, but password is empty
+                    // then add password argument "\n" which means: Ask user for a password.
+                    common_arguments.push_back("\n");
+                }
             }
             else
             {
                 common_arguments.push_back("--user");
-                common_arguments.push_back(user_info);
+                common_arguments.push_back(uriDecode(user_info, true));
             }
         }
 
@@ -209,7 +214,7 @@ bool tryParseConnectionString(
     catch (const Poco::URISyntaxException & invalid_uri_exception)
     {
         throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS,
-                            "Invalid connection string {}: {}", connection_string, invalid_uri_exception.what());
+                            "Invalid connection string '{}': {}", connection_string, invalid_uri_exception.what());
     }
 
     return true;

From d15b7372942040863e6241f9d299b846c2513495 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Fri, 9 Jun 2023 03:54:29 +0000
Subject: [PATCH 266/722] Minor renaming

---
 docs/en/interfaces/cli.md | 2 +-
 docs/ru/interfaces/cli.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index 2126c538c5d..fc24bdcad68 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -199,7 +199,7 @@ Instead of --host, --port, --user and --password options, ClickHouse client also
 
 ## Connection string {#connection_string}
 
-clickhouse-client alternatively supports connecting to clickhouse server using a connection string similar to [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). It has the following syntax:
+clickhouse-client alternatively supports connecting to clickhouse server using a connection string similar to [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). It has the following syntax:
 
 ```text
 clickhouse:[//[user_info@][hosts_and_ports]][/database][?query_parameters]
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index f86ccb42356..ee29b122afb 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -144,7 +144,7 @@ $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="numbe
 
 ## Строка подключения {#connection_string}
 
-clickhouse-client также поддерживает подключение к серверу clickhouse с помощью строки подключения, аналогичной [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). Она имеет следующий синтаксис:
+clickhouse-client также поддерживает подключение к серверу clickhouse с помощью строки подключения, аналогичной [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). Она имеет следующий синтаксис:
 
 ```text
 clickhouse:[//[user_info@][hosts_and_ports]][/database][?query_parameters]

From 094d661701cc83d84ebcf4bbaffeff47e0f7c547 Mon Sep 17 00:00:00 2001
From: YalalovSM <39567223+YalalovSM@users.noreply.github.com>
Date: Fri, 9 Jun 2023 09:26:00 +0500
Subject: [PATCH 267/722] Update projection.md

Document using keywords IF EXISTS/IF NOT EXISTS with projections
---
 docs/en/sql-reference/statements/alter/projection.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/sql-reference/statements/alter/projection.md b/docs/en/sql-reference/statements/alter/projection.md
index 030e9352a00..b7399442d41 100644
--- a/docs/en/sql-reference/statements/alter/projection.md
+++ b/docs/en/sql-reference/statements/alter/projection.md
@@ -142,11 +142,11 @@ The following operations with [projections](/docs/en/engines/table-engines/merge
 
 ## ADD PROJECTION
 
-`ALTER TABLE [db].name ADD PROJECTION name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )` - Adds projection description to tables metadata.
+`ALTER TABLE [db].name ADD PROJECTION [IF NOT EXISTS] name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )` - Adds projection description to tables metadata.
 
 ## DROP PROJECTION
 
-`ALTER TABLE [db].name DROP PROJECTION name` - Removes projection description from tables metadata and deletes projection files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db].name DROP PROJECTION [IF EXISTS] name` - Removes projection description from tables metadata and deletes projection files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 ## MATERIALIZE PROJECTION
 
@@ -154,7 +154,7 @@ The following operations with [projections](/docs/en/engines/table-engines/merge
 
 ## CLEAR PROJECTION
 
-`ALTER TABLE [db.]table CLEAR PROJECTION name IN PARTITION partition_name` - Deletes projection files from disk without removing description. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db.]table CLEAR PROJECTION [IF EXISTS] name IN PARTITION partition_name` - Deletes projection files from disk without removing description. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 
 The commands `ADD`, `DROP` and `CLEAR` are lightweight in a sense that they only change metadata or remove files.

From 95c0b942c141493f8997fb807b4ff72c34b8292b Mon Sep 17 00:00:00 2001
From: YalalovSM <39567223+YalalovSM@users.noreply.github.com>
Date: Fri, 9 Jun 2023 10:37:20 +0500
Subject: [PATCH 268/722] Update projection.md

---
 docs/ru/sql-reference/statements/alter/projection.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/ru/sql-reference/statements/alter/projection.md b/docs/ru/sql-reference/statements/alter/projection.md
index 63b068611ec..33e52b93add 100644
--- a/docs/ru/sql-reference/statements/alter/projection.md
+++ b/docs/ru/sql-reference/statements/alter/projection.md
@@ -8,13 +8,13 @@ sidebar_label: PROJECTION
 
 Доступны следующие операции с [проекциями](../../../engines/table-engines/mergetree-family/mergetree.md#projections):
 
--   `ALTER TABLE [db].name ADD PROJECTION name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )` — добавляет описание проекции в метаданные.
+-   `ALTER TABLE [db].name ADD PROJECTION [IF NOT EXISTS] name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )` — добавляет описание проекции в метаданные.
 
--   `ALTER TABLE [db].name DROP PROJECTION name` — удаляет описание проекции из метаданных и удаляет файлы проекции с диска.
+-   `ALTER TABLE [db].name DROP PROJECTION [IF EXISTS] name` — удаляет описание проекции из метаданных и удаляет файлы проекции с диска.
 
 -   `ALTER TABLE [db.]table MATERIALIZE PROJECTION name IN PARTITION partition_name` — перестраивает проекцию в указанной партиции. Реализовано как [мутация](../../../sql-reference/statements/alter/index.md#mutations).
 
--   `ALTER TABLE [db.]table CLEAR PROJECTION name IN PARTITION partition_name` — удаляет файлы проекции с диска без удаления описания.
+-   `ALTER TABLE [db.]table CLEAR PROJECTION [IF EXISTS] name IN PARTITION partition_name` — удаляет файлы проекции с диска без удаления описания.
 
 Команды `ADD`, `DROP` и `CLEAR` — легковесны, поскольку они только меняют метаданные или удаляют файлы.
 
@@ -22,4 +22,4 @@ sidebar_label: PROJECTION
 
     :::note
     Манипуляции с проекциями поддерживаются только для таблиц с движком [`*MergeTree`](../../../engines/table-engines/mergetree-family/mergetree.md) (включая [replicated](../../../engines/table-engines/mergetree-family/replication.md) варианты).
-    :::
\ No newline at end of file
+    :::

From d0938e95e68551c51f54407abe30bbd35534bf2e Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Fri, 9 Jun 2023 06:40:57 +0000
Subject: [PATCH 269/722] prohibited to use --connection

---
 programs/client/Client.cpp      |  9 +++------
 src/Client/ConnectionString.cpp | 19 +++++++++++++++++++
 src/Client/ConnectionString.h   |  5 +++++
 3 files changed, 27 insertions(+), 6 deletions(-)

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 1429853e333..a49447dff69 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -1267,6 +1267,9 @@ void Client::readArguments(
     {
         std::string_view arg = argv[arg_num];
 
+        if (has_connection_string)
+            validateConnectionStringClientOption(arg);
+
         if (arg == "--external")
         {
             in_external_group = true;
@@ -1325,9 +1328,6 @@ void Client::readArguments(
             }
             else if (arg.starts_with("--host") || arg.starts_with("-h"))
             {
-                if (has_connection_string)
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing a connection string and --host argument is prohibited");
-
                 std::string host_arg;
                 /// --host host
                 if (arg == "--host" || arg == "-h")
@@ -1359,9 +1359,6 @@ void Client::readArguments(
             }
             else if (arg.starts_with("--port"))
             {
-                if (has_connection_string)
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "Mixing a connection string and --port argument is prohibited");
-
                 auto port_arg = String{arg};
                 /// --port port
                 if (arg == "--port")
diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index 2e475a1f49d..b9658772e2e 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -7,6 +7,7 @@
 #include <array>
 #include <iostream>
 #include <string>
+#include <unordered_map>
 
 namespace DB
 {
@@ -26,6 +27,15 @@ using namespace std::literals::string_view_literals;
 
 constexpr auto CONNECTION_URI_SCHEME = "clickhouse:"sv;
 
+const std::unordered_map<std::string_view, std::string_view> PROHIBITED_CLIENT_OPTIONS = 
+{
+   /// Client option, client option long name
+   {"-h", "--host"},
+   {"--host", "--host"},
+   {"--port", "--port"},
+   {"--connection", "--connection"},
+};
+
 std::string uriDecode(const std::string & uri_encoded_string, bool plus_as_space)
 {
     std::string decoded_string;
@@ -220,4 +230,13 @@ bool tryParseConnectionString(
     return true;
 }
 
+void validateConnectionStringClientOption(std::string_view command_line_option)
+{
+    const auto prohibited_option_iter = PROHIBITED_CLIENT_OPTIONS.find(command_line_option);
+    if (prohibited_option_iter != PROHIBITED_CLIENT_OPTIONS.end())
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, 
+                        "Mixing a connection string and {} option is prohibited", 
+                        prohibited_option_iter->second);
+}
+
 }
diff --git a/src/Client/ConnectionString.h b/src/Client/ConnectionString.h
index aafb1139b00..ce72de9edf6 100644
--- a/src/Client/ConnectionString.h
+++ b/src/Client/ConnectionString.h
@@ -19,4 +19,9 @@ bool tryParseConnectionString(
     std::string_view connection_string,
     std::vector<std::string> & common_arguments,
     std::vector<std::vector<std::string>> & hosts_and_ports_arguments);
+
+// throws DB::Exception with BAD_ARGUMENTS if the given command line argument is allowed
+// to be used with the connection string
+void validateConnectionStringClientOption(std::string_view command_line_option);
+
 }

From b8fc25ab239fbf8c82f589b175e386ceed737c26 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Fri, 9 Jun 2023 06:51:34 +0000
Subject: [PATCH 270/722] minor update

---
 src/Client/ConnectionString.cpp | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index b9658772e2e..e1f39369b2a 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -27,13 +27,12 @@ using namespace std::literals::string_view_literals;
 
 constexpr auto CONNECTION_URI_SCHEME = "clickhouse:"sv;
 
-const std::unordered_map<std::string_view, std::string_view> PROHIBITED_CLIENT_OPTIONS = 
-{
-   /// Client option, client option long name
-   {"-h", "--host"},
-   {"--host", "--host"},
-   {"--port", "--port"},
-   {"--connection", "--connection"},
+const std::unordered_map<std::string_view, std::string_view> PROHIBITED_CLIENT_OPTIONS = {
+    /// Client option, client option long name
+    {"-h", "--host"},
+    {"--host", "--host"},
+    {"--port", "--port"},
+    {"--connection", "--connection"},
 };
 
 std::string uriDecode(const std::string & uri_encoded_string, bool plus_as_space)
@@ -234,9 +233,8 @@ void validateConnectionStringClientOption(std::string_view command_line_option)
 {
     const auto prohibited_option_iter = PROHIBITED_CLIENT_OPTIONS.find(command_line_option);
     if (prohibited_option_iter != PROHIBITED_CLIENT_OPTIONS.end())
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, 
-                        "Mixing a connection string and {} option is prohibited", 
-                        prohibited_option_iter->second);
+        throw Exception(
+            ErrorCodes::BAD_ARGUMENTS, "Mixing a connection string and {} option is prohibited", prohibited_option_iter->second);
 }
 
 }

From 5c76a8882ef644ca924c5653cdad14e7cfa94270 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 9 Jun 2023 09:12:07 +0000
Subject: [PATCH 271/722] Fix docs by pull request comments

---
 .../functions/type-conversion-functions.md    | 177 +++++++++++-----
 .../functions/type-conversion-functions.md    | 199 ++++++++++++++----
 2 files changed, 288 insertions(+), 88 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index a021fed195d..c634a3da27e 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -33,7 +33,7 @@ SELECT
     toTypeName(toNullable('') AS val) AS source_type,
     toTypeName(toString(val)) AS to_type_result_type,
     toTypeName(CAST(val, 'String')) AS cast_result_type
-    
+
 ┌─source_type──────┬─to_type_result_type─┬─cast_result_type─┐
 │ Nullable(String) │ Nullable(String)    │ String           │
 └──────────────────┴─────────────────────┴──────────────────┘
@@ -203,7 +203,7 @@ Result:
 
 ## toDate
 
-Converts the argument to [Date](/docs/en/sql-reference/data-types/date.md) data type. 
+Converts the argument to [Date](/docs/en/sql-reference/data-types/date.md) data type.
 
 If the argument is [DateTime](/docs/en/sql-reference/data-types/datetime.md) or [DateTime64](/docs/en/sql-reference/data-types/datetime64.md), it truncates it and leaves the date component of the DateTime:
 
@@ -232,7 +232,7 @@ SELECT
 │ 2022-12-30 │ Date                             │
 └────────────┴──────────────────────────────────┘
 
-1 row in set. Elapsed: 0.001 sec. 
+1 row in set. Elapsed: 0.001 sec.
 ```
 
 ```sql
@@ -314,14 +314,52 @@ SELECT
 └─────────────────────┴───────────────┴─────────────┴─────────────────────┘
 ```
 
+
 ## toDateOrZero
 
+The same as [toDate](#todate) but returns lower boundery of [Date](/docs/en/sql-reference/data-types/date.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT toDateOrZero('2022-12-30'), toDateOrZero('');
+```
+
+Result:
+
+```response
+┌─toDateOrZero('2022-12-30')─┬─toDateOrZero('')─┐
+│                 2022-12-30 │       1970-01-01 │
+└────────────────────────────┴──────────────────┘
+```
+
+
 ## toDateOrNull
 
+The same as [toDate](#todate) but returns `NULL` if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT toDateOrNull('2022-12-30'), toDateOrNull('');
+```
+
+Result:
+
+```response
+┌─toDateOrNull('2022-12-30')─┬─toDateOrNull('')─┐
+│                 2022-12-30 │             ᴺᵁᴸᴸ │
+└────────────────────────────┴──────────────────┘
+```
+
+
 ## toDateOrDefault
-Converts an input value to [Date](/docs/en/sql-reference/data-types/date.md) data type. 
-If unsuccessful, returns the lower border value supported by [Date](/docs/en/sql-reference/data-types/date.md). The default value can be specified as a second argument.
-Similar to [toDate](#todate).
+
+Like [toDate](#todate) but if unsuccessful, returns a default value which is either the second argument (if specified), or otherwise the lower boundery of [Date](/docs/en/sql-reference/data-types/date.md).
 
 **Syntax**
 
@@ -329,62 +367,37 @@ Similar to [toDate](#todate).
 toDateOrDefault(expr [, default_value])
 ```
 
-**Arguments**
-
-- `expr` — The value. [String](/docs/en/sql-reference/data-types/string.md), [Int](/docs/en/sql-reference/data-types/int-uint.md), [Date](/docs/en/sql-reference/data-types/date.md) or [DateTime](/docs/en/sql-reference/data-types/datetime.md). 
-- `default_value` — The default value. [Date](/docs/en/sql-reference/data-types/date.md) 
-
-If `expr` is a number and looks like a UNIX timestamp (is greater than 65535), it is interpreted as a DateTime, then truncated to Date in the current timezone. If `expr` is a number and it is smaller than 65536, it is interpreted as the number of days since 1970-01-01.
-
-**Returned value**
-
-- A calendar date. [Date](/docs/en/sql-reference/data-types/date.md)
-
 **Example**
 
 Query:
 
 ``` sql
-SELECT
-    toDateOrDefault('2021-01-01', '2023-01-01'::Date),
-    toDateOrDefault('xx2021-01-01', '2023-01-01'::Date);
+SELECT toDateOrDefault('2022-12-30'), toDateOrDefault('', '2023-01-01'::Date);
 ```
 
 Result:
 
 ```response
-┌─toDateOrDefault('2021-01-01', CAST('2023-01-01', 'Date'))─┬─toDateOrDefault('xx2021-01-01', CAST('2023-01-01', 'Date'))─┐
-│                                                2021-01-01 │                                                  2023-01-01 │
-└───────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────┘
+┌─toDateOrDefault('2022-12-30')─┬─toDateOrDefault('', CAST('2023-01-01', 'Date'))─┐
+│                    2022-12-30 │                                      2023-01-01 │
+└───────────────────────────────┴─────────────────────────────────────────────────┘
 ```
 
-**See Also**
-- [toDate](#todate)
-- [toDate32OrDefault](#todate32ordefault)
-
 
 ## toDateTime
 
-## toDateTimeOrZero
-
-## toDateTimeOrNull
-
-## toDateTimeOrDefault
-Converts an input value to [DateTime](/docs/en/sql-reference/data-types/datetime.md) data type. 
-If unsuccessful, returns the lower border value supported by [DateTime](/docs/en/sql-reference/data-types/datetime.md). The default value can be specified as a third argument.
-Similar to [toDateTime](#todatetime).
+Converts an input value to [DateTime](/docs/en/sql-reference/data-types/datetime.md).
 
 **Syntax**
 
 ``` sql
-toDateTimeOrDefault(expr, [, time_zone [, default_value]])
+toDateTime(expr[, time_zone ])
 ```
 
 **Arguments**
 
-- `expr` — The value. [String](/docs/en/sql-reference/data-types/string.md), [Int](/docs/en/sql-reference/data-types/int-uint.md), [Date](/docs/en/sql-reference/data-types/date.md) or [DateTime](/docs/en/sql-reference/data-types/datetime.md). 
+- `expr` — The value. [String](/docs/en/sql-reference/data-types/string.md), [Int](/docs/en/sql-reference/data-types/int-uint.md), [Date](/docs/en/sql-reference/data-types/date.md) or [DateTime](/docs/en/sql-reference/data-types/datetime.md).
 - `time_zone` — Time zone. [String](/docs/en/sql-reference/data-types/string.md).
-- `default_value` — The default value. [DateTime](/docs/en/sql-reference/data-types/datetime.md) 
 
 If `expr` is a number, it is interpreted as the number of seconds since the beginning of the Unix Epoch (as Unix timestamp).
 
@@ -397,21 +410,86 @@ If `expr` is a number, it is interpreted as the number of seconds since the begi
 Query:
 
 ``` sql
-SELECT
-    toDateTimeOrDefault('2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC')),
-    toDateTimeOrDefault('xx2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC'));
+SELECT toDateTime('2022-12-30 13:44:17'), toDateTime(1685457500, 'UTC');
 ```
 
 Result:
 
 ```response
-┌─toDateTimeOrDefault('2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┬─toDateTimeOrDefault('xx2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
-│                                                               2021-01-01 00:00:00 │                                                                 2023-01-01 00:00:00 │
-└───────────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────┘
+┌─toDateTime('2022-12-30 13:44:17')─┬─toDateTime(1685457500, 'UTC')─┐
+│               2022-12-30 13:44:17 │           2023-05-30 14:38:20 │
+└───────────────────────────────────┴───────────────────────────────┘
+```
+
+
+## toDateTimeOrZero
+
+The same as [toDateTime](#todate) but returns lower boundery of [Date](/docs/en/sql-reference/data-types/date.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT toDateTimeOrZero('2022-12-30 13:44:17'), toDateTimeOrZero('');
+```
+
+Result:
+
+```response
+┌─toDateTimeOrZero('2022-12-30 13:44:17')─┬─toDateTimeOrZero('')─┐
+│                     2022-12-30 13:44:17 │  1970-01-01 00:00:00 │
+└─────────────────────────────────────────┴──────────────────────┘
+```
+
+
+## toDateTimeOrNull
+
+The same as [toDateTime](#todatetime) but returns `NULL` if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+
+**Example**
+
+Query:
+
+``` sql
+SELECT toDateTimeOrNull('2022-12-30 13:44:17'), toDateTimeOrNull('');
+```
+
+Result:
+
+```response
+┌─toDateTimeOrNull('2022-12-30 13:44:17')─┬─toDateTimeOrNull('')─┐
+│                     2022-12-30 13:44:17 │                 ᴺᵁᴸᴸ │
+└─────────────────────────────────────────┴──────────────────────┘
+```
+
+
+## toDateTimeOrDefault
+
+Like [toDateTime](#todatetime) but if unsuccessful, returns a default value which is either the third argument (if specified), or otherwise the lower boundery of [DateTime](/docs/en/sql-reference/data-types/datetime.md).
+
+**Syntax**
+
+``` sql
+toDateTimeOrDefault(expr [, time_zone [, default_value]])
+```
+
+**Example**
+
+Query:
+
+``` sql
+SELECT toDateTimeOrDefault('2022-12-30 13:44:17'), toDateTimeOrDefault('', 'UTC', '2023-01-01'::DateTime('UTC'));
+```
+
+Result:
+
+```response
+┌─toDateTimeOrDefault('2022-12-30 13:44:17')─┬─toDateTimeOrDefault('', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
+│                        2022-12-30 13:44:17 │                                                     2023-01-01 00:00:00 │
+└────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────┘
 ```
 
-**See Also**
-- [toDateTime](#todatetime)
 
 ## toDate32
 
@@ -604,6 +682,11 @@ SELECT toDateTime64('2019-01-01 00:00:00', 3, 'Asia/Istanbul') AS value, toTypeN
 └─────────────────────────┴─────────────────────────────────────────────────────────────────────┘
 ```
 
+## toDateTime64OrZero
+
+## toDateTime64OrNull
+
+## toDateTime64OrDefault
 
 ## toDecimal(32\|64\|128\|256)
 
@@ -1332,7 +1415,7 @@ Returns DateTime values parsed from input string according to a MySQL style form
 **Supported format specifiers**
 
 All format specifiers listed in [formatDateTime](/docs/en/sql-reference/functions/date-time-functions.md#date_time_functions-formatDateTime) except:
-- %Q: Quarter (1-4) 
+- %Q: Quarter (1-4)
 
 **Example**
 
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index 67d1732d34e..d43b5415114 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -165,28 +165,17 @@ SELECT toUInt64(nan), toUInt32(-32), toUInt16('16'), toUInt8(8.8);
 
 ## toDate {#todate}
 
-Cиноним: `DATE`.
-
-## toDateOrZero {#todateorzero}
-
-## toDateOrNull {#todateornull}
-
-## toDateOrDefault {#todateordefault}
-
-Конвертирует аргумент в значение [Date](/docs/ru/sql-reference/data-types/date.md) data type. 
-Если получен недопустимый аргумент, то возвращает значение по умолчанию (нижняя граница [Date](/docs/ru/sql-reference/data-types/date.md). Значение по умолчанию может быть указано вторым аргументом.
-Похожа на [toDate](#todate).
+Конвертирует аргумент в значение [Date](/docs/ru/sql-reference/data-types/date.md).
 
 **Синтаксис**
 
 ``` sql
-toDateOrDefault(expr [, default_value])
+toDate(expr)
 ```
 
 **Аргументы**
 
-- `expr` — Значение для преобразования. [String](/docs/ru/sql-reference/data-types/string.md), [Int](/docs/ru/sql-reference/data-types/int-uint.md), [Date](/docs/ru/sql-reference/data-types/date.md) или [DateTime](/docs/ru/sql-reference/data-types/datetime.md). 
-- `default_value` — Значение по умолчанию. [Date](/docs/ru/sql-reference/data-types/date.md) 
+- `expr` — Значение для преобразования. [String](/docs/ru/sql-reference/data-types/string.md), [Int](/docs/ru/sql-reference/data-types/int-uint.md), [Date](/docs/ru/sql-reference/data-types/date.md) или [DateTime](/docs/ru/sql-reference/data-types/datetime.md).
 
 Если `expr` является числом выглядит как UNIX timestamp (больше чем 65535), оно интерпретируется как DateTime, затем обрезается до Date учитывавая текущую часовой пояс. Если `expr` является числом и меньше чем 65536, оно интерпретируется как количество дней с 1970-01-01.
 
@@ -199,46 +188,101 @@ toDateOrDefault(expr [, default_value])
 Запрос:
 
 ``` sql
-SELECT
-    toDateOrDefault('2021-01-01', '2023-01-01'::Date),
-    toDateOrDefault('xx2021-01-01', '2023-01-01'::Date);
+SELECT toDate('2022-12-30'), toDate(1685457500);
 ```
 
 Результат:
 
 ```response
-┌─toDateOrDefault('2021-01-01', CAST('2023-01-01', 'Date'))─┬─toDateOrDefault('xx2021-01-01', CAST('2023-01-01', 'Date'))─┐
-│                                                2021-01-01 │                                                  2023-01-01 │
-└───────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────┘
+┌─toDate('2022-12-30')─┬─toDate(1685457500)─┐
+│           2022-12-30 │         2023-05-30 │
+└──────────────────────┴────────────────────┘
 ```
 
-**Смотрите также**
-- [toDate](#todate)
-- [toDate32OrDefault](#todate32ordefault)
 
-## toDateTime {#todatetime}
+## toDateOrZero {#todateorzero}
 
-## toDateTimeOrZero {#todatetimeorzero}
+Как [toDate](#todate), но в случае неудачи возвращает нижнюю границу [Date](/docs/ru/sql-reference/data-types/date.md)). Поддерживается только аргумент типа [String](/docs/ru/sql-reference/data-types/string.md).
 
-## toDateTimeOrNull {#todatetimeornull}
+**Пример**
 
-## toDateTimeOrDefault {#todatetimeordefault}
+Запрос:
 
-Конвертирует аргумент в значение [DateTime](/docs/ru/sql-reference/data-types/datetime.md). 
-Если получен недопустимый аргумент, то возвращает значение по умолчанию (нижняя граница [DateTime](/docs/ru/sql-reference/data-types/datetime.md)). Значение по умолчанию может быть указано третьим аргументом.
-Похожа на [toDateTime](#todatetime).
+``` sql
+SELECT toDateOrZero('2022-12-30'), toDateOrZero('');
+```
+
+Результат:
+
+```response
+┌─toDateOrZero('2022-12-30')─┬─toDateOrZero('')─┐
+│                 2022-12-30 │       1970-01-01 │
+└────────────────────────────┴──────────────────┘
+```
+
+
+## toDateOrNull {#todateornull}
+
+Как [toDate](#todate), но в случае неудачи возвращает `NULL`. Поддерживается только аргумент типа [String](/docs/ru/sql-reference/data-types/string.md).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT toDateOrNull('2022-12-30'), toDateOrNull('');
+```
+
+Результат:
+
+```response
+┌─toDateOrNull('2022-12-30')─┬─toDateOrNull('')─┐
+│                 2022-12-30 │             ᴺᵁᴸᴸ │
+└────────────────────────────┴──────────────────┘
+```
+
+
+## toDateOrDefault {#todateordefault}
+
+Как [toDate](#todate), но в случае неудачи возвращает значение по умолчанию (или второй аргумент (если указан), или нижняя граница [Date](/docs/ru/sql-reference/data-types/date.md)).
 
 **Синтаксис**
 
 ``` sql
-toDateTimeOrDefault(expr, [, time_zone [, default_value]])
+toDateOrDefault(expr [, default_value])
+```
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT toDateOrDefault('2022-12-30'), toDateOrDefault('', '2023-01-01'::Date);
+```
+
+Результат:
+
+```response
+┌─toDateOrDefault('2022-12-30')─┬─toDateOrDefault('', CAST('2023-01-01', 'Date'))─┐
+│                    2022-12-30 │                                      2023-01-01 │
+└───────────────────────────────┴─────────────────────────────────────────────────┘
+```
+
+
+## toDateTime {#todatetime}
+
+Конвертирует аргумент в значение [DateTime](/docs/ru/sql-reference/data-types/datetime.md).
+
+**Синтаксис**
+
+``` sql
+toDateTime(expr[, time_zone ])
 ```
 
 **Аргументы**
 
-- `expr` — Значение для преобразования. [String](/docs/ru/sql-reference/data-types/string.md), [Int](/docs/ru/sql-reference/data-types/int-uint.md), [Date](/docs/ru/sql-reference/data-types/date.md) или [DateTime](/docs/ru/sql-reference/data-types/datetime.md). 
+- `expr` — Значение для преобразования. [String](/docs/ru/sql-reference/data-types/string.md), [Int](/docs/ru/sql-reference/data-types/int-uint.md), [Date](/docs/ru/sql-reference/data-types/date.md) или [DateTime](/docs/ru/sql-reference/data-types/datetime.md).
 - `time_zone` — Часовой пояс. [String](/docs/ru/sql-reference/data-types/string.md).
-- `default_value` — Значение по умолчанию. [DateTime](/docs/ru/sql-reference/data-types/datetime.md) 
 
 Если `expr` является числом, оно интерпретируется как количество секунд от начала unix эпохи.
 
@@ -251,21 +295,86 @@ toDateTimeOrDefault(expr, [, time_zone [, default_value]])
 Запрос:
 
 ``` sql
-SELECT
-    toDateTimeOrDefault('2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC')),
-    toDateTimeOrDefault('xx2021-01-01', 'UTC', '2023-01-01'::DateTime('UTC'));
+SELECT toDateTime('2022-12-30 13:44:17'), toDateTime(1685457500, 'UTC');
 ```
 
 Результат:
 
 ```response
-┌─toDateTimeOrDefault('2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┬─toDateTimeOrDefault('xx2021-01-01', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
-│                                                               2021-01-01 00:00:00 │                                                                 2023-01-01 00:00:00 │
-└───────────────────────────────────────────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────────────────┘
+┌─toDateTime('2022-12-30 13:44:17')─┬─toDateTime(1685457500, 'UTC')─┐
+│               2022-12-30 13:44:17 │           2023-05-30 14:38:20 │
+└───────────────────────────────────┴───────────────────────────────┘
+```
+
+
+## toDateTimeOrZero {#todatetimeorzero}
+
+Как [toDateTime](#todatetime), но в случае неудачи возвращает нижнюю границу [DateTime](/docs/ru/sql-reference/data-types/datetime.md)). Поддерживается только аргумент типа [String](/docs/ru/sql-reference/data-types/string.md).
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT toDateTimeOrZero('2022-12-30 13:44:17'), toDateTimeOrZero('');
+```
+
+Результат:
+
+```response
+┌─toDateTimeOrZero('2022-12-30 13:44:17')─┬─toDateTimeOrZero('')─┐
+│                     2022-12-30 13:44:17 │  1970-01-01 00:00:00 │
+└─────────────────────────────────────────┴──────────────────────┘
+```
+
+
+## toDateTimeOrNull {#todatetimeornull}
+
+Как [toDateTime](#todatetime), но в случае неудачи возвращает `NULL`. Поддерживается только аргумент типа [String](/docs/ru/sql-reference/data-types/string.md).
+
+**Example**
+
+Query:
+
+``` sql
+SELECT toDateTimeOrNull('2022-12-30 13:44:17'), toDateTimeOrNull('');
+```
+
+Result:
+
+```response
+┌─toDateTimeOrNull('2022-12-30 13:44:17')─┬─toDateTimeOrNull('')─┐
+│                     2022-12-30 13:44:17 │                 ᴺᵁᴸᴸ │
+└─────────────────────────────────────────┴──────────────────────┘
+```
+
+
+## toDateTimeOrDefault {#todatetimeordefault}
+
+Как [toDateTime](#todatetime), но в случае неудачи возвращает значение по умолчанию (или третий аргумент (если указан), или нижняя граница [DateTime](/docs/ru/sql-reference/data-types/datetime.md)).
+
+**Синтаксис**
+
+``` sql
+toDateTimeOrDefault(expr, [, time_zone [, default_value]])
+```
+
+**Пример**
+
+Запрос:
+
+``` sql
+SELECT toDateTimeOrDefault('2022-12-30 13:44:17'), toDateTimeOrDefault('', 'UTC', '2023-01-01'::DateTime('UTC'));
+```
+
+Результат:
+
+```response
+┌─toDateTimeOrDefault('2022-12-30 13:44:17')─┬─toDateTimeOrDefault('', 'UTC', CAST('2023-01-01', 'DateTime(\'UTC\')'))─┐
+│                        2022-12-30 13:44:17 │                                                     2023-01-01 00:00:00 │
+└────────────────────────────────────────────┴─────────────────────────────────────────────────────────────────────────┘
 ```
 
-**Смотрите также**
-- [toDateTime](#todatetime)
 
 ## toDate32 {#todate32}
 
@@ -387,6 +496,14 @@ SELECT
 └─────────────────────────────────────────────────────────┴───────────────────────────────────────────────────────────┘
 ```
 
+## toDateTime64
+
+## toDateTime64OrZero
+
+## toDateTime64OrNull
+
+## toDateTime64OrDefault
+
 ## toDecimal(32\|64\|128\|256) {#todecimal3264128}
 
 Преобразует `value` к типу данных [Decimal](../../sql-reference/functions/type-conversion-functions.md) с точностью `S`. `value` может быть числом или строкой. Параметр `S` (scale) задаёт число десятичных знаков.

From ab8365630b3ee50120e67664ca4ecbab1afcc4c3 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 9 Jun 2023 09:19:21 +0000
Subject: [PATCH 272/722] Reject logs containing unknown operation

---
 contrib/NuRaft                          |  2 +-
 src/Coordination/Changelog.cpp          |  3 +-
 src/Coordination/Changelog.h            |  2 +-
 src/Coordination/KeeperServer.cpp       | 39 +++++++++++++++++++++----
 src/Coordination/KeeperStateMachine.cpp |  5 ++--
 5 files changed, 39 insertions(+), 12 deletions(-)

diff --git a/contrib/NuRaft b/contrib/NuRaft
index b56784be1ae..f43d10dbc97 160000
--- a/contrib/NuRaft
+++ b/contrib/NuRaft
@@ -1 +1 @@
-Subproject commit b56784be1aec568fb72aff47f281097c017623cb
+Subproject commit f43d10dbc977a63f11dfb3afdd010fcf7ad89950
diff --git a/src/Coordination/Changelog.cpp b/src/Coordination/Changelog.cpp
index 894fd93cfa7..c0dfbc2cbc3 100644
--- a/src/Coordination/Changelog.cpp
+++ b/src/Coordination/Changelog.cpp
@@ -13,6 +13,7 @@
 #include <Common/logger_useful.h>
 #include <IO/WriteBufferFromFile.h>
 #include <base/errnoToString.h>
+#include <libnuraft/log_val_type.hxx>
 
 
 namespace DB
@@ -479,7 +480,7 @@ public:
                     continue;
 
                 /// Create log entry for read data
-                auto log_entry = nuraft::cs_new<nuraft::log_entry>(record.header.term, record.blob, record.header.value_type);
+                auto log_entry = nuraft::cs_new<nuraft::log_entry>(record.header.term, record.blob, static_cast<nuraft::log_val_type>(record.header.value_type));
                 if (result.first_read_index == 0)
                     result.first_read_index = record.header.index;
 
diff --git a/src/Coordination/Changelog.h b/src/Coordination/Changelog.h
index 56b0475ba8b..3c09370182d 100644
--- a/src/Coordination/Changelog.h
+++ b/src/Coordination/Changelog.h
@@ -39,7 +39,7 @@ struct ChangelogRecordHeader
     ChangelogVersion version = CURRENT_CHANGELOG_VERSION;
     uint64_t index = 0; /// entry log number
     uint64_t term = 0;
-    nuraft::log_val_type value_type{};
+    int32_t value_type{};
     uint64_t blob_size = 0;
 };
 
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 45db9e85fa5..6e47412cd3a 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -21,6 +21,7 @@
 #include <libnuraft/raft_server.hxx>
 #include <Poco/Util/AbstractConfiguration.h>
 #include <Poco/Util/Application.h>
+#include <Common/Exception.h>
 #include <Common/LockMemoryExceptionInThread.h>
 #include <Common/ZooKeeper/ZooKeeperIO.h>
 #include <Common/Stopwatch.h>
@@ -607,12 +608,30 @@ nuraft::cb_func::ReturnCode KeeperServer::callbackFunc(nuraft::cb_func::Type typ
         }
     }
 
+    const auto follower_preappend = [&](const auto & entry)
+    {
+        if (entry->get_val_type() != nuraft::app_log)
+            return nuraft::cb_func::ReturnCode::Ok;
+
+        try
+        {
+            state_machine->parseRequest(entry->get_buf(), /*final=*/false);
+        }
+        catch (...)
+        {
+            tryLogCurrentException(log, "Failed to parse request from log entry");
+            throw;
+        }
+        return nuraft::cb_func::ReturnCode::Ok;
+
+    };
+
     if (initialized_flag)
     {
         switch (type)
         {
             // This event is called before a single log is appended to the entry on the leader node
-            case nuraft::cb_func::PreAppendLog:
+            case nuraft::cb_func::PreAppendLogLeader:
             {
                 // we are relying on the fact that request are being processed under a mutex
                 // and not a RW lock
@@ -665,7 +684,12 @@ nuraft::cb_func::ReturnCode KeeperServer::callbackFunc(nuraft::cb_func::Type typ
                 if (request_for_session->digest->version != KeeperStorage::NO_DIGEST)
                     writeIntBinary(request_for_session->digest->value, write_buf);
 
-                break;
+                return nuraft::cb_func::ReturnCode::Ok;
+            }
+            case nuraft::cb_func::PreAppendLogFollower:
+            {
+                const auto & entry = *static_cast<LogEntryPtr *>(param->ctx);
+                return follower_preappend(entry);
             }
             case nuraft::cb_func::AppendLogFailed:
             {
@@ -678,13 +702,11 @@ nuraft::cb_func::ReturnCode KeeperServer::callbackFunc(nuraft::cb_func::Type typ
                 auto & entry_buf = entry->get_buf();
                 auto request_for_session = state_machine->parseRequest(entry_buf, true);
                 state_machine->rollbackRequest(*request_for_session, true);
-                break;
+                return nuraft::cb_func::ReturnCode::Ok;
             }
             default:
-                break;
+                return nuraft::cb_func::ReturnCode::Ok;
         }
-
-        return nuraft::cb_func::ReturnCode::Ok;
     }
 
     size_t last_commited = state_machine->last_commit_index();
@@ -737,6 +759,11 @@ nuraft::cb_func::ReturnCode KeeperServer::callbackFunc(nuraft::cb_func::Type typ
             initial_batch_committed = true;
             return nuraft::cb_func::ReturnCode::Ok;
         }
+        case nuraft::cb_func::PreAppendLogFollower:
+        {
+            const auto & entry = *static_cast<LogEntryPtr *>(param->ctx);
+            return follower_preappend(entry);
+        }
         default: /// ignore other events
             return nuraft::cb_func::ReturnCode::Ok;
     }
diff --git a/src/Coordination/KeeperStateMachine.cpp b/src/Coordination/KeeperStateMachine.cpp
index 65abee44050..7d251ad48b9 100644
--- a/src/Coordination/KeeperStateMachine.cpp
+++ b/src/Coordination/KeeperStateMachine.cpp
@@ -272,9 +272,8 @@ bool KeeperStateMachine::preprocess(const KeeperStorage::RequestForSession & req
     }
     catch (...)
     {
-        tryLogCurrentException(__PRETTY_FUNCTION__);
-        rollbackRequestNoLock(request_for_session, true);
-        throw;
+        tryLogCurrentException(__PRETTY_FUNCTION__, "Failed to preprocess stored log, aborting to avoid inconsistent state");
+        std::abort();
     }
 
     if (keeper_context->digest_enabled && request_for_session.digest)

From de70e322cf93d5f10a01bbc7d7aa8f4798755214 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 9 Jun 2023 10:29:44 +0000
Subject: [PATCH 273/722] Fix by pull request comments

---
 src/Functions/DateTimeTransforms.h            | 35 ++++++++---------
 src/Functions/FunctionsConversion.h           |  2 +-
 .../01556_accurate_cast_or_null.reference     |  2 +
 .../01556_accurate_cast_or_null.sql           |  2 +
 .../0_stateless/01601_accurate_cast.sql       | 38 +++++++++----------
 5 files changed, 40 insertions(+), 39 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 09b0d71daf8..1d3ec1bd368 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -1436,7 +1436,7 @@ struct Transformer
 {
     template <typename FromTypeVector, typename ToTypeVector>
     static void vector(const FromTypeVector & vec_from, ToTypeVector & vec_to, const DateLUTImpl & time_zone, const Transform & transform,
-        ColumnUInt8::Container * vec_null_map_to [[maybe_unused]])
+        [[maybe_unused]] ColumnUInt8::Container * vec_null_map_to)
     {
         using ValueType = typename ToTypeVector::value_type;
         size_t size = vec_from.size();
@@ -1444,29 +1444,26 @@ struct Transformer
 
         for (size_t i = 0; i < size; ++i)
         {
-            if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
-                || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+            if constexpr (std::is_same_v<ToType, DataTypeDate> || std::is_same_v<ToType, DataTypeDateTime>)
             {
-                bool check_range_result = true;
-
-                if constexpr (std::is_same_v<ToType, DataTypeDate> || std::is_same_v<ToType, DataTypeDateTime>)
+                if constexpr (std::is_same_v<Additions, DateTimeAccurateConvertStrategyAdditions>
+                    || std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
                 {
-                    check_range_result = vec_from[i] >= 0 && vec_from[i] <= 0xFFFFFFFFL;
-                }
+                    bool is_valid_input = vec_from[i] >= 0 && vec_from[i] <= 0xFFFFFFFFL;
 
-                if (!check_range_result)
-                {
-                    if constexpr (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+                    if (!is_valid_input)
                     {
-                        vec_to[i] = 0;
-                        if (vec_null_map_to)
+                        if constexpr (std::is_same_v<Additions, DateTimeAccurateOrNullConvertStrategyAdditions>)
+                        {
+                            vec_to[i] = 0;
                             (*vec_null_map_to)[i] = true;
-                        continue;
-                    }
-                    else
-                    {
-                        throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
-                            TypeName<FromType>, TypeName<ToType>);
+                            continue;
+                        }
+                        else
+                        {
+                            throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
+                                TypeName<FromType>, TypeName<ToType>);
+                        }
                     }
                 }
             }
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 3a8ddcc9094..ea8efada21d 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -2885,7 +2885,7 @@ private:
                 if constexpr (IsDataTypeNumber<LeftDataType>
                     && (std::is_same_v<RightDataType, DataTypeDate> || std::is_same_v<RightDataType, DataTypeDateTime>))
                 {
-                     if (wrapper_cast_type == CastType::accurate)
+                    if (wrapper_cast_type == CastType::accurate)
                     {
                         result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateConvertStrategyAdditions>(
                             arguments, result_type, input_rows_count);
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
index 21faa830636..3bff125068a 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
@@ -35,6 +35,8 @@
 \N
 2023-05-30 14:38:20
 1970-01-01 00:00:19
+1970-01-01 19:26:40
+\N
 \N
 \N
 2023-05-30
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
index 3f57358576e..3266198d930 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
@@ -41,8 +41,10 @@ SELECT accurateCastOrNull(5000000000, 'DateTime');
 SELECT accurateCastOrNull('1xxx', 'DateTime');
 select toString(accurateCastOrNull('2023-05-30 14:38:20', 'DateTime'), timezone());
 SELECT toString(accurateCastOrNull(19, 'DateTime'), 'UTC');
+SELECT toString(accurateCastOrNull(70000, 'DateTime'), 'UTC');
 
 SELECT accurateCastOrNull(-1, 'Date');
+SELECT accurateCastOrNull(5000000000, 'Date');
 SELECT accurateCastOrNull('1xxx', 'Date');
 SELECT accurateCastOrNull('2023-05-30', 'Date');
 SELECT accurateCastOrNull(19, 'Date');
diff --git a/tests/queries/0_stateless/01601_accurate_cast.sql b/tests/queries/0_stateless/01601_accurate_cast.sql
index 5555129f0ad..2108e42df05 100644
--- a/tests/queries/0_stateless/01601_accurate_cast.sql
+++ b/tests/queries/0_stateless/01601_accurate_cast.sql
@@ -1,36 +1,36 @@
-SELECT accurateCast(-1, 'UInt8'); -- { serverError 70 }
+SELECT accurateCast(-1, 'UInt8'); -- { serverError CANNOT_CONVERT_TYPE }
 SELECT accurateCast(5, 'UInt8');
-SELECT accurateCast(257, 'UInt8'); -- { serverError 70 }
-SELECT accurateCast(-1, 'UInt16'); -- { serverError 70 }
+SELECT accurateCast(257, 'UInt8'); -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast(-1, 'UInt16'); -- { serverError CANNOT_CONVERT_TYPE }
 SELECT accurateCast(5, 'UInt16');
-SELECT accurateCast(65536, 'UInt16'); -- { serverError 70 }
-SELECT accurateCast(-1, 'UInt32'); -- { serverError 70 }
+SELECT accurateCast(65536, 'UInt16'); -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast(-1, 'UInt32'); -- { serverError CANNOT_CONVERT_TYPE }
 SELECT accurateCast(5, 'UInt32');
-SELECT accurateCast(4294967296, 'UInt32'); -- { serverError 70 }
-SELECT accurateCast(-1, 'UInt64'); -- { serverError 70 }
+SELECT accurateCast(4294967296, 'UInt32'); -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast(-1, 'UInt64'); -- { serverError CANNOT_CONVERT_TYPE }
 SELECT accurateCast(5, 'UInt64');
-SELECT accurateCast(-1, 'UInt256'); -- { serverError 70 }
+SELECT accurateCast(-1, 'UInt256'); -- { serverError CANNOT_CONVERT_TYPE }
 SELECT accurateCast(5, 'UInt256');
 
-SELECT accurateCast(-129, 'Int8'); -- { serverError 70 }
+SELECT accurateCast(-129, 'Int8'); -- { serverError CANNOT_CONVERT_TYPE }
 SELECT accurateCast(5, 'Int8');
-SELECT accurateCast(128, 'Int8'); -- { serverError 70 }
+SELECT accurateCast(128, 'Int8'); -- { serverError CANNOT_CONVERT_TYPE }
 
-SELECT accurateCast(10, 'Decimal32(9)'); -- { serverError 407 }
+SELECT accurateCast(10, 'Decimal32(9)'); -- { serverError DECIMAL_OVERFLOW }
 SELECT accurateCast(1, 'Decimal32(9)');
-SELECT accurateCast(-10, 'Decimal32(9)'); -- { serverError 407 }
+SELECT accurateCast(-10, 'Decimal32(9)'); -- { serverError DECIMAL_OVERFLOW }
 
-SELECT accurateCast('123', 'FixedString(2)'); -- { serverError 131 }
+SELECT accurateCast('123', 'FixedString(2)'); -- { serverError TOO_LARGE_STRING_SIZE }
 SELECT accurateCast('12', 'FixedString(2)');
 
-SELECT accurateCast(-1, 'DateTime');   -- { serverError 70 }
-SELECT accurateCast(0xFFFFFFFF + 1, 'DateTime');   -- { serverError 70 }
-SELECT accurateCast('1xxx', 'DateTime');   -- { serverError 41 }
+SELECT accurateCast(-1, 'DateTime');   -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast(0xFFFFFFFF + 1, 'DateTime');   -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast('1xxx', 'DateTime');   -- { serverError CANNOT_PARSE_DATETIME }
 SELECT accurateCast('2023-05-30 14:38:20', 'DateTime');
 SELECT toString(accurateCast(19, 'DateTime'), 'UTC');
 
-SELECT accurateCast(-1, 'Date');   -- { serverError 70 }
-SELECT accurateCast(0xFFFFFFFF + 1, 'Date');   -- { serverError 70 }
-SELECT accurateCast('1xxx', 'Date');   -- { serverError 38 }
+SELECT accurateCast(-1, 'Date');   -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast(0xFFFFFFFF + 1, 'Date');   -- { serverError CANNOT_CONVERT_TYPE }
+SELECT accurateCast('1xxx', 'Date');   -- { serverError CANNOT_PARSE_DATE }
 SELECT accurateCast('2023-05-30', 'Date');
 SELECT accurateCast(19, 'Date');

From 7a02a70ad4239e920c6e23b9bc2bcc0a5c5db58b Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 9 Jun 2023 11:11:49 +0000
Subject: [PATCH 274/722] Add value to exceptions text

---
 src/Functions/DateTimeTransforms.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 1d3ec1bd368..019e0c42cde 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -1461,8 +1461,8 @@ struct Transformer
                         }
                         else
                         {
-                            throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value in column {} cannot be safely converted into type {}",
-                                TypeName<FromType>, TypeName<ToType>);
+                            throw Exception(ErrorCodes::CANNOT_CONVERT_TYPE, "Value {} cannot be safely converted into type {}",
+                                vec_from[i], TypeName<ValueType>);
                         }
                     }
                 }

From f437d5d8b51b69347eecb79a0af878bfd2707d9d Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 9 Jun 2023 11:27:27 +0000
Subject: [PATCH 275/722] Fix toDateTimeOrZero description

---
 docs/en/sql-reference/functions/type-conversion-functions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index c634a3da27e..28db7e6e677 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -424,7 +424,7 @@ Result:
 
 ## toDateTimeOrZero
 
-The same as [toDateTime](#todate) but returns lower boundery of [Date](/docs/en/sql-reference/data-types/date.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+The same as [toDateTime](#todatetime) but returns lower boundery of [DateTime](/docs/en/sql-reference/data-types/datetime.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
 
 **Example**
 

From 2d220bd8411607521fb6a2767b568352a2cae127 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Fri, 9 Jun 2023 11:38:50 +0000
Subject: [PATCH 276/722] Fix NuRaft

---
 contrib/NuRaft | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/NuRaft b/contrib/NuRaft
index f43d10dbc97..8f267da1a91 160000
--- a/contrib/NuRaft
+++ b/contrib/NuRaft
@@ -1 +1 @@
-Subproject commit f43d10dbc977a63f11dfb3afdd010fcf7ad89950
+Subproject commit 8f267da1a91310bd152af755b0178cfd38c646c7

From 32d781c058321b3c2ee0b21b17a2cbb87a9a3e23 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 9 Jun 2023 14:51:26 +0300
Subject: [PATCH 277/722] Align the documentation with the new feature

---
 docs/en/sql-reference/functions/type-conversion-functions.md | 4 +++-
 docs/ru/sql-reference/functions/type-conversion-functions.md | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index f6c99b168ac..dad3cfb4cc5 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -1343,6 +1343,7 @@ parseDateTimeBestEffort(time_string [, time_zone])
 - A string with a date, but no time component: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` etc.
 - A string with a day and time: `DD`, `DD hh`, `DD hh:mm`. In this case `YYYY-MM` are substituted as `2000-01`.
 - A string that includes the date and time along with time zone offset information: `YYYY-MM-DD hh:mm:ss ±h:mm`, etc. For example, `2020-12-12 17:36:00 -5:00`.
+- A string that includes the date and time in a [syslog](https://datatracker.ietf.org/doc/html/rfc3164) datetime format. For example, `Jun  9 14:20:32`.
 
 For all of the formats with separator the function parses months names expressed by their full name or by the first three letters of a month name. Examples: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
 
@@ -1428,10 +1429,11 @@ Result:
 
 **See Also**
 
-- [RFC 1123](https://tools.ietf.org/html/rfc1123)
+- [RFC 1123](https://datatracker.ietf.org/doc/html/rfc1123)
 - [toDate](#todate)
 - [toDateTime](#todatetime)
 - [ISO 8601 announcement by @xkcd](https://xkcd.com/1179/)
+- [RFC 3164](https://datatracker.ietf.org/doc/html/rfc3164)
 
 ## parseDateTimeBestEffortUS
 
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index 298b7bbc93e..03e3adfbdca 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -1022,6 +1022,7 @@ parseDateTimeBestEffort(time_string[, time_zone])
 -   Строка с датой, но без времени: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` и т.д.
 -   Строка с временем, и с днём: `DD`, `DD hh`, `DD hh:mm`. В этом случае `YYYY-MM` принимается равным `2000-01`.
 -   Строка, содержащая дату и время вместе с информацией о часовом поясе: `YYYY-MM-DD hh:mm:ss ±h:mm`, и т.д. Например, `2020-12-12 17:36:00 -5:00`.
+-   Строка, содержащая дату и время в формате [syslog](https://datatracker.ietf.org/doc/html/rfc3164). Например, `Jun  9 14:20:32`.
 
 Для всех форматов с разделителями функция распознаёт названия месяцев, выраженных в виде полного англоязычного имени месяца или в виде первых трёх символов имени месяца. Примеры: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
 
@@ -1108,9 +1109,10 @@ SELECT parseDateTimeBestEffort('10 20:19');
 **Смотрите также**
 
 -   [Информация о формате ISO 8601 от @xkcd](https://xkcd.com/1179/)
--   [RFC 1123](https://tools.ietf.org/html/rfc1123)
+-   [RFC 1123](https://datatracker.ietf.org/doc/html/rfc1123)
 -   [toDate](#todate)
 -   [toDateTime](#todatetime)
+-   [RFC 3164](https://datatracker.ietf.org/doc/html/rfc3164)
 
 ## parseDateTimeBestEffortUS {#parsedatetimebesteffortUS}
 

From b740a08b6e508ccee08efc7e2ca83e8d7192e3ef Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 9 Jun 2023 15:05:23 +0300
Subject: [PATCH 278/722] Fix the docs

---
 docs/en/sql-reference/functions/type-conversion-functions.md | 2 +-
 docs/ru/sql-reference/functions/type-conversion-functions.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index dad3cfb4cc5..8e186844c93 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -1343,7 +1343,7 @@ parseDateTimeBestEffort(time_string [, time_zone])
 - A string with a date, but no time component: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` etc.
 - A string with a day and time: `DD`, `DD hh`, `DD hh:mm`. In this case `YYYY-MM` are substituted as `2000-01`.
 - A string that includes the date and time along with time zone offset information: `YYYY-MM-DD hh:mm:ss ±h:mm`, etc. For example, `2020-12-12 17:36:00 -5:00`.
-- A string that includes the date and time in a [syslog](https://datatracker.ietf.org/doc/html/rfc3164) datetime format. For example, `Jun  9 14:20:32`.
+- A string that includes the date and time in the [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164) format. For example, `Jun  9 14:20:32`.
 
 For all of the formats with separator the function parses months names expressed by their full name or by the first three letters of a month name. Examples: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
 
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index 03e3adfbdca..93ca6b410c8 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -1022,7 +1022,7 @@ parseDateTimeBestEffort(time_string[, time_zone])
 -   Строка с датой, но без времени: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` и т.д.
 -   Строка с временем, и с днём: `DD`, `DD hh`, `DD hh:mm`. В этом случае `YYYY-MM` принимается равным `2000-01`.
 -   Строка, содержащая дату и время вместе с информацией о часовом поясе: `YYYY-MM-DD hh:mm:ss ±h:mm`, и т.д. Например, `2020-12-12 17:36:00 -5:00`.
--   Строка, содержащая дату и время в формате [syslog](https://datatracker.ietf.org/doc/html/rfc3164). Например, `Jun  9 14:20:32`.
+-   Строка, содержащая дату и время в формате [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164). Например, `Jun  9 14:20:32`.
 
 Для всех форматов с разделителями функция распознаёт названия месяцев, выраженных в виде полного англоязычного имени месяца или в виде первых трёх символов имени месяца. Примеры: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
 

From d0c2c1dbad9da978246fe6c9105a62a972041cd8 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Fri, 9 Jun 2023 12:06:43 +0000
Subject: [PATCH 279/722] Add test and reorder if's

---
 src/Functions/FunctionsConversion.h           | 49 ++++++++++---------
 .../01556_accurate_cast_or_null.reference     |  1 +
 .../01556_accurate_cast_or_null.sql           |  1 +
 3 files changed, 27 insertions(+), 24 deletions(-)

diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index ea8efada21d..e44a3bdaa2e 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -2866,36 +2866,37 @@ private:
                 using LeftDataType = typename Types::LeftType;
                 using RightDataType = typename Types::RightType;
 
-                if constexpr (IsDataTypeNumber<LeftDataType> && IsDataTypeNumber<RightDataType>)
+                if constexpr (IsDataTypeNumber<LeftDataType>)
                 {
-                    if (wrapper_cast_type == CastType::accurate)
+                    if constexpr (IsDataTypeNumber<RightDataType>)
                     {
-                        result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::execute(
-                            arguments, result_type, input_rows_count, AccurateConvertStrategyAdditions());
-                    }
-                    else
-                    {
-                        result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::execute(
-                            arguments, result_type, input_rows_count, AccurateOrNullConvertStrategyAdditions());
+                        if (wrapper_cast_type == CastType::accurate)
+                        {
+                            result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::execute(
+                                arguments, result_type, input_rows_count, AccurateConvertStrategyAdditions());
+                        }
+                        else
+                        {
+                            result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::execute(
+                                arguments, result_type, input_rows_count, AccurateOrNullConvertStrategyAdditions());
+                        }
+                        return true;
                     }
 
-                    return true;
-                }
-
-                if constexpr (IsDataTypeNumber<LeftDataType>
-                    && (std::is_same_v<RightDataType, DataTypeDate> || std::is_same_v<RightDataType, DataTypeDateTime>))
-                {
-                    if (wrapper_cast_type == CastType::accurate)
+                    if constexpr (std::is_same_v<RightDataType, DataTypeDate> || std::is_same_v<RightDataType, DataTypeDateTime>)
                     {
-                        result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateConvertStrategyAdditions>(
-                            arguments, result_type, input_rows_count);
+                        if (wrapper_cast_type == CastType::accurate)
+                        {
+                            result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateConvertStrategyAdditions>(
+                                arguments, result_type, input_rows_count);
+                        }
+                        else
+                        {
+                            result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateOrNullConvertStrategyAdditions>(
+                                arguments, result_type, input_rows_count);
+                        }
+                        return true;
                     }
-                    else
-                    {
-                        result_column = ConvertImpl<LeftDataType, RightDataType, FunctionName>::template execute<DateTimeAccurateOrNullConvertStrategyAdditions>(
-                            arguments, result_type, input_rows_count);
-                    }
-                    return true;
                 }
 
                 return false;
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
index 3bff125068a..31a9c37421e 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.reference
@@ -40,4 +40,5 @@
 \N
 \N
 2023-05-30
+2149-06-06
 1970-01-20
diff --git a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
index 3266198d930..f00f6ef837f 100644
--- a/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
+++ b/tests/queries/0_stateless/01556_accurate_cast_or_null.sql
@@ -47,4 +47,5 @@ SELECT accurateCastOrNull(-1, 'Date');
 SELECT accurateCastOrNull(5000000000, 'Date');
 SELECT accurateCastOrNull('1xxx', 'Date');
 SELECT accurateCastOrNull('2023-05-30', 'Date');
+SELECT accurateCastOrNull('2180-01-01', 'Date');
 SELECT accurateCastOrNull(19, 'Date');

From a21bd4ec62825172d859424be0687e127d36b4c0 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 9 Jun 2023 15:33:51 +0300
Subject: [PATCH 280/722] Elucidate the syslog case in the documentation

---
 docs/en/sql-reference/functions/type-conversion-functions.md | 3 ++-
 docs/ru/sql-reference/functions/type-conversion-functions.md | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index 8e186844c93..e62cf89a6b2 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -1341,11 +1341,12 @@ parseDateTimeBestEffort(time_string [, time_zone])
 - A string containing 9..10 digit [unix timestamp](https://en.wikipedia.org/wiki/Unix_time).
 - A string with a date and a time component: `YYYYMMDDhhmmss`, `DD/MM/YYYY hh:mm:ss`, `DD-MM-YY hh:mm`, `YYYY-MM-DD hh:mm:ss`, etc.
 - A string with a date, but no time component: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` etc.
-- A string with a day and time: `DD`, `DD hh`, `DD hh:mm`. In this case `YYYY-MM` are substituted as `2000-01`.
+- A string with a day and time: `DD`, `DD hh`, `DD hh:mm`. In this case `MM` is substituted by `01`.
 - A string that includes the date and time along with time zone offset information: `YYYY-MM-DD hh:mm:ss ±h:mm`, etc. For example, `2020-12-12 17:36:00 -5:00`.
 - A string that includes the date and time in the [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164) format. For example, `Jun  9 14:20:32`.
 
 For all of the formats with separator the function parses months names expressed by their full name or by the first three letters of a month name. Examples: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
+If the year is not specified, it is considered to be equal to the current year. If the resulting date and time happens to be ahead of the current moment even by a second, the current year is substituted by the previous one.
 
 **Returned value**
 
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index 93ca6b410c8..6de55757b64 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -1020,11 +1020,12 @@ parseDateTimeBestEffort(time_string[, time_zone])
 -   [Unix timestamp](https://ru.wikipedia.org/wiki/Unix-время) в строковом представлении. 9 или 10 символов.
 -   Строка с датой и временем: `YYYYMMDDhhmmss`, `DD/MM/YYYY hh:mm:ss`, `DD-MM-YY hh:mm`, `YYYY-MM-DD hh:mm:ss`, etc.
 -   Строка с датой, но без времени: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` и т.д.
--   Строка с временем, и с днём: `DD`, `DD hh`, `DD hh:mm`. В этом случае `YYYY-MM` принимается равным `2000-01`.
+-   Строка с временем, и с днём: `DD`, `DD hh`, `DD hh:mm`. В этом случае `MM` принимается равным `01`.
 -   Строка, содержащая дату и время вместе с информацией о часовом поясе: `YYYY-MM-DD hh:mm:ss ±h:mm`, и т.д. Например, `2020-12-12 17:36:00 -5:00`.
 -   Строка, содержащая дату и время в формате [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164). Например, `Jun  9 14:20:32`.
 
 Для всех форматов с разделителями функция распознаёт названия месяцев, выраженных в виде полного англоязычного имени месяца или в виде первых трёх символов имени месяца. Примеры: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
+Если год не указан, вместо него подставляется текущий год. Если в результате получается будущее время, хотя бы на одну секунду впереди, текущий год заменяется на прошлый.
 
 **Возвращаемое значение**
 

From 056ca4f555fbbf4463de5be8642a2c01b6759192 Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Wed, 24 May 2023 13:26:15 -0400
Subject: [PATCH 281/722] Add extensive testing cases for deflate qpl codec

---
 .../sql-reference/statements/create/table.md  |  2 +-
 src/Client/Connection.cpp                     |  2 +-
 src/Compression/CompressionCodecDeflateQpl.h  |  3 +-
 src/Compression/CompressionFactory.h          |  4 +-
 .../CompressionFactoryAdditions.cpp           | 14 ++--
 src/Compression/ICompressionCodec.h           |  3 +
 src/Core/Settings.h                           |  1 +
 src/Interpreters/InterpreterCreateQuery.cpp   |  3 +-
 src/Server/TCPHandler.cpp                     |  2 +-
 src/Storages/AlterCommands.cpp                |  8 +--
 src/Storages/ColumnsDescription.cpp           |  2 +-
 src/Storages/Distributed/DistributedSink.cpp  |  2 +-
 src/Storages/TTLDescription.cpp               |  2 +-
 .../deflateqpl_compression_by_default.xml     | 11 ++++
 .../configs/enable_deflateqpl_codec.xml       |  7 ++
 .../test_non_default_compression/test.py      | 65 ++++++++++++++++++-
 ...04_test_alter_compression_codecs.reference | 31 ++++++---
 .../00804_test_alter_compression_codecs.sql   | 28 +++++---
 18 files changed, 153 insertions(+), 37 deletions(-)
 create mode 100644 tests/integration/test_non_default_compression/configs/deflateqpl_compression_by_default.xml
 create mode 100644 tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml

diff --git a/docs/en/sql-reference/statements/create/table.md b/docs/en/sql-reference/statements/create/table.md
index de44a001472..b0865ad2896 100644
--- a/docs/en/sql-reference/statements/create/table.md
+++ b/docs/en/sql-reference/statements/create/table.md
@@ -380,7 +380,7 @@ High compression levels are useful for asymmetric scenarios, like compress once,
 
 `DEFLATE_QPL` — [Deflate compression algorithm](https://github.com/intel/qpl) implemented by Intel® Query Processing Library. Some limitations apply:
 
-- DEFLATE_QPL is experimental and can only be used after setting configuration parameter `allow_experimental_codecs=1`.
+- DEFLATE_QPL is disabled by default and can only be used after setting configuration parameter `enable_qpl_deflate=1`.
 - DEFLATE_QPL requires a ClickHouse build compiled with SSE 4.2 instructions (by default, this is the case). Refer to [Build Clickhouse with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Build-Clickhouse-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL works best if the system has a Intel® IAA (In-Memory Analytics Accelerator) offloading device. Refer to [Accelerator Configuration](https://intel.github.io/qpl/documentation/get_started_docs/installation.html#accelerator-configuration) and [Benchmark with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Run-Benchmark-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL-compressed data can only be transferred between ClickHouse nodes compiled with SSE 4.2 enabled.
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index 2350a5039ab..68bc3b39a56 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -588,7 +588,7 @@ void Connection::sendQuery(
         if (method == "ZSTD")
             level = settings->network_zstd_compression_level;
 
-        CompressionCodecFactory::instance().validateCodec(method, level, !settings->allow_suspicious_codecs, settings->allow_experimental_codecs);
+        CompressionCodecFactory::instance().validateCodec(method, level, !settings->allow_suspicious_codecs, settings->allow_experimental_codecs, settings->enable_qpl_deflate);
         compression_codec = CompressionCodecFactory::instance().get(method, level);
     }
     else
diff --git a/src/Compression/CompressionCodecDeflateQpl.h b/src/Compression/CompressionCodecDeflateQpl.h
index 7a1a764295d..13aa8733b54 100644
--- a/src/Compression/CompressionCodecDeflateQpl.h
+++ b/src/Compression/CompressionCodecDeflateQpl.h
@@ -98,7 +98,8 @@ public:
 protected:
     bool isCompression() const override { return true; }
     bool isGenericCompression() const override { return true; }
-    bool isExperimental() const override { return true; }
+    bool isExperimental() const override { return false; }
+    bool isDeflateQplCompression() const override { return true; }
 
     UInt32 doCompressData(const char * source, UInt32 source_size, char * dest) const override;
     void doDecompressData(const char * source, UInt32 source_size, char * dest, UInt32 uncompressed_size) const override;
diff --git a/src/Compression/CompressionFactory.h b/src/Compression/CompressionFactory.h
index a4451f9ed2e..1fdaf4f1c71 100644
--- a/src/Compression/CompressionFactory.h
+++ b/src/Compression/CompressionFactory.h
@@ -40,10 +40,10 @@ public:
     CompressionCodecPtr getDefaultCodec() const;
 
     /// Validate codecs AST specified by user and parses codecs description (substitute default parameters)
-    ASTPtr validateCodecAndGetPreprocessedAST(const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs) const;
+    ASTPtr validateCodecAndGetPreprocessedAST(const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const;
 
     /// Validate codecs AST specified by user
-    void validateCodec(const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs) const;
+    void validateCodec(const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const;
 
     /// Get codec by AST and possible column_type. Some codecs can use
     /// information about type to improve inner settings, but every codec should
diff --git a/src/Compression/CompressionFactoryAdditions.cpp b/src/Compression/CompressionFactoryAdditions.cpp
index 978a0fe5069..2630326238a 100644
--- a/src/Compression/CompressionFactoryAdditions.cpp
+++ b/src/Compression/CompressionFactoryAdditions.cpp
@@ -34,7 +34,7 @@ namespace ErrorCodes
 
 
 void CompressionCodecFactory::validateCodec(
-    const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs) const
+    const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const
 {
     if (family_name.empty())
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Compression codec name cannot be empty");
@@ -43,13 +43,13 @@ void CompressionCodecFactory::validateCodec(
     {
         auto literal = std::make_shared<ASTLiteral>(static_cast<UInt64>(*level));
         validateCodecAndGetPreprocessedAST(makeASTFunction("CODEC", makeASTFunction(Poco::toUpper(family_name), literal)),
-            {}, sanity_check, allow_experimental_codecs);
+            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate);
     }
     else
     {
         auto identifier = std::make_shared<ASTIdentifier>(Poco::toUpper(family_name));
         validateCodecAndGetPreprocessedAST(makeASTFunction("CODEC", identifier),
-            {}, sanity_check, allow_experimental_codecs);
+            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate);
     }
 }
 
@@ -77,7 +77,7 @@ bool innerDataTypeIsFloat(const DataTypePtr & type)
 }
 
 ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
-    const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs) const
+    const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const
 {
     if (const auto * func = ast->as<ASTFunction>())
     {
@@ -159,6 +159,12 @@ ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
                         " You can enable it with the 'allow_experimental_codecs' setting.",
                         codec_family_name);
 
+                if (!enable_qpl_deflate && result_codec->isDeflateQplCompression())
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                        "Codec {} is disabled by default."
+                        " You can enable it with the 'enable_qpl_deflate' setting.",
+                        codec_family_name);
+
                 codecs_descriptions->children.emplace_back(result_codec->getCodecDesc());
             }
 
diff --git a/src/Compression/ICompressionCodec.h b/src/Compression/ICompressionCodec.h
index 44835ac19cb..d92ad3fc718 100644
--- a/src/Compression/ICompressionCodec.h
+++ b/src/Compression/ICompressionCodec.h
@@ -112,6 +112,9 @@ public:
     /// If it does nothing.
     virtual bool isNone() const { return false; }
 
+    /// This is a knob for Deflate QPL codec.
+    virtual bool isDeflateQplCompression() const { return false; }
+
 protected:
     /// This is used for fuzz testing
     friend int LLVMFuzzerTestOneInput(const uint8_t * data, size_t size);
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 464b9168a4c..c6a2069e6ae 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -319,6 +319,7 @@ class IColumn;
     M(Bool, allow_distributed_ddl, true, "If it is set to true, then a user is allowed to executed distributed DDL queries.", 0) \
     M(Bool, allow_suspicious_codecs, false, "If it is set to true, allow to specify meaningless compression codecs.", 0) \
     M(Bool, allow_experimental_codecs, false, "If it is set to true, allow to specify experimental compression codecs (but we don't have those yet and this option does nothing).", 0) \
+    M(Bool, enable_qpl_deflate, false, "If it is set to true, allow to use deflate_qpl for compression.", 0) \
     M(UInt64, query_profiler_real_time_period_ns, QUERY_PROFILER_DEFAULT_SAMPLE_RATE_NS, "Period for real clock timer of query profiler (in nanoseconds). Set 0 value to turn off the real clock query profiler. Recommended value is at least 10000000 (100 times a second) for single queries or 1000000000 (once a second) for cluster-wide profiling.", 0) \
     M(UInt64, query_profiler_cpu_time_period_ns, QUERY_PROFILER_DEFAULT_SAMPLE_RATE_NS, "Period for CPU clock timer of query profiler (in nanoseconds). Set 0 value to turn off the CPU clock query profiler. Recommended value is at least 10000000 (100 times a second) for single queries or 1000000000 (once a second) for cluster-wide profiling.", 0) \
     M(Bool, metrics_perf_events_enabled, false, "If enabled, some of the perf events will be measured throughout queries' execution.", 0) \
diff --git a/src/Interpreters/InterpreterCreateQuery.cpp b/src/Interpreters/InterpreterCreateQuery.cpp
index ab9e1fb04d6..5c22b46b360 100644
--- a/src/Interpreters/InterpreterCreateQuery.cpp
+++ b/src/Interpreters/InterpreterCreateQuery.cpp
@@ -571,6 +571,7 @@ ColumnsDescription InterpreterCreateQuery::getColumnsDescription(
 
     bool sanity_check_compression_codecs = !attach && !context_->getSettingsRef().allow_suspicious_codecs;
     bool allow_experimental_codecs = attach || context_->getSettingsRef().allow_experimental_codecs;
+    bool enable_qpl_deflate = attach || context_->getSettingsRef().enable_qpl_deflate;
 
     ColumnsDescription res;
     auto name_type_it = column_names_and_types.begin();
@@ -631,7 +632,7 @@ ColumnsDescription InterpreterCreateQuery::getColumnsDescription(
             if (col_decl.default_specifier == "ALIAS")
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cannot specify codec for column type ALIAS");
             column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(
-                col_decl.codec, column.type, sanity_check_compression_codecs, allow_experimental_codecs);
+                col_decl.codec, column.type, sanity_check_compression_codecs, allow_experimental_codecs, enable_qpl_deflate);
         }
 
         if (col_decl.ttl)
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 1ded7d97248..96c585e7d16 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -1775,7 +1775,7 @@ void TCPHandler::initBlockOutput(const Block & block)
 
             if (state.compression == Protocol::Compression::Enable)
             {
-                CompressionCodecFactory::instance().validateCodec(method, level, !query_settings.allow_suspicious_codecs, query_settings.allow_experimental_codecs);
+                CompressionCodecFactory::instance().validateCodec(method, level, !query_settings.allow_suspicious_codecs, query_settings.allow_experimental_codecs, query_settings.enable_qpl_deflate);
 
                 state.maybe_compressed_out = std::make_shared<CompressedWriteBuffer>(
                     *out, CompressionCodecFactory::instance().get(method, level));
diff --git a/src/Storages/AlterCommands.cpp b/src/Storages/AlterCommands.cpp
index 5fd823b9e01..ecbddfc3e2a 100644
--- a/src/Storages/AlterCommands.cpp
+++ b/src/Storages/AlterCommands.cpp
@@ -388,7 +388,7 @@ void AlterCommand::apply(StorageInMemoryMetadata & metadata, ContextPtr context)
             column.comment = *comment;
 
         if (codec)
-            column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(codec, data_type, false, true);
+            column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(codec, data_type, false, true, true);
 
         column.ttl = ttl;
 
@@ -429,7 +429,7 @@ void AlterCommand::apply(StorageInMemoryMetadata & metadata, ContextPtr context)
             else
             {
                 if (codec)
-                    column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(codec, data_type ? data_type : column.type, false, true);
+                    column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(codec, data_type ? data_type : column.type, false, true, true);
 
                 if (comment)
                     column.comment = *comment;
@@ -1067,7 +1067,7 @@ void AlterCommands::validate(const StoragePtr & table, ContextPtr context) const
                                 "this column name is reserved for lightweight delete feature", backQuote(column_name));
 
             if (command.codec)
-                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs);
+                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate);
 
             all_columns.add(ColumnDescription(column_name, command.data_type));
         }
@@ -1093,7 +1093,7 @@ void AlterCommands::validate(const StoragePtr & table, ContextPtr context) const
             {
                 if (all_columns.hasAlias(column_name))
                     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cannot specify codec for column type ALIAS");
-                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs);
+                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate);
             }
             auto column_default = all_columns.getDefault(column_name);
             if (column_default)
diff --git a/src/Storages/ColumnsDescription.cpp b/src/Storages/ColumnsDescription.cpp
index 8eabae7929c..045afd7e6e6 100644
--- a/src/Storages/ColumnsDescription.cpp
+++ b/src/Storages/ColumnsDescription.cpp
@@ -130,7 +130,7 @@ void ColumnDescription::readText(ReadBuffer & buf)
                 comment = col_ast->comment->as<ASTLiteral &>().value.get<String>();
 
             if (col_ast->codec)
-                codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(col_ast->codec, type, false, true);
+                codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(col_ast->codec, type, false, true, true);
 
             if (col_ast->ttl)
                 ttl = col_ast->ttl;
diff --git a/src/Storages/Distributed/DistributedSink.cpp b/src/Storages/Distributed/DistributedSink.cpp
index 720a951299a..ce1dbde8eae 100644
--- a/src/Storages/Distributed/DistributedSink.cpp
+++ b/src/Storages/Distributed/DistributedSink.cpp
@@ -733,7 +733,7 @@ void DistributedSink::writeToShard(const Cluster::ShardInfo & shard_info, const
     if (compression_method == "ZSTD")
         compression_level = settings.network_zstd_compression_level;
 
-    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs);
+    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enable_qpl_deflate);
     CompressionCodecPtr compression_codec = CompressionCodecFactory::instance().get(compression_method, compression_level);
 
     /// tmp directory is used to ensure atomicity of transactions
diff --git a/src/Storages/TTLDescription.cpp b/src/Storages/TTLDescription.cpp
index e1a80800630..f5209cbdff6 100644
--- a/src/Storages/TTLDescription.cpp
+++ b/src/Storages/TTLDescription.cpp
@@ -285,7 +285,7 @@ TTLDescription TTLDescription::getTTLFromAST(
         {
             result.recompression_codec =
                 CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(
-                    ttl_element->recompression_codec, {}, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs);
+                    ttl_element->recompression_codec, {}, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate);
         }
     }
 
diff --git a/tests/integration/test_non_default_compression/configs/deflateqpl_compression_by_default.xml b/tests/integration/test_non_default_compression/configs/deflateqpl_compression_by_default.xml
new file mode 100644
index 00000000000..2ad6a0f1eff
--- /dev/null
+++ b/tests/integration/test_non_default_compression/configs/deflateqpl_compression_by_default.xml
@@ -0,0 +1,11 @@
+<clickhouse>
+    <compression>
+        <case>
+            <!-- Conditions. All must be satisfied simultaneously. Some conditions may not be specified. -->
+            <min_part_size>0</min_part_size>         <!-- The minimum size of a part in bytes. -->
+            <min_part_size_ratio>0</min_part_size_ratio>    <!-- The minimum size of the part relative to all the data in the table. -->
+            <!-- Which compression method to choose. -->
+            <method>deflate_qpl</method>
+        </case>
+    </compression>
+</clickhouse>
diff --git a/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml b/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
new file mode 100644
index 00000000000..46e9e43ca27
--- /dev/null
+++ b/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
@@ -0,0 +1,7 @@
+<clickhouse>
+    <profiles>
+        <default>
+            <enable_qpl_deflate>1</enable_qpl_deflate>
+        </default>
+    </profiles>
+</clickhouse>
diff --git a/tests/integration/test_non_default_compression/test.py b/tests/integration/test_non_default_compression/test.py
index e0a67a5db95..e69b32daae0 100644
--- a/tests/integration/test_non_default_compression/test.py
+++ b/tests/integration/test_non_default_compression/test.py
@@ -41,7 +41,14 @@ node6 = cluster.add_instance(
     main_configs=["configs/allow_experimental_codecs.xml"],
     user_configs=["configs/allow_suspicious_codecs.xml"],
 )
-
+node7 = cluster.add_instance(
+    "node7",
+    main_configs=["configs/deflateqpl_compression_by_default.xml"],
+    user_configs=[
+        "configs/enable_deflateqpl_codec.xml",
+        "configs/allow_suspicious_codecs.xml",
+    ],
+)
 
 @pytest.fixture(scope="module")
 def start_cluster():
@@ -244,3 +251,59 @@ def test_uncompressed_cache_plus_zstd_codec(start_cluster):
         )
         == "10000\n"
     )
+
+def test_preconfigured_deflateqpl_codec(start_cluster):
+    node7.query(
+        """
+    CREATE TABLE compression_codec_multiple_with_key (
+        somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), DEFLATE_QPL),
+        id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, DEFLATE_QPL),
+        data String CODEC(ZSTD(2), LZ4HC, NONE, LZ4, LZ4, DEFLATE_QPL),
+        somecolumn Float64
+    ) ENGINE = MergeTree() PARTITION BY somedate ORDER BY id SETTINGS index_granularity = 2;
+    """
+    )
+    node7.query(
+        "INSERT INTO compression_codec_multiple_with_key VALUES(toDate('2018-10-12'), 100000, 'hello', 88.88), (toDate('2018-10-12'), 100002, 'world', 99.99), (toDate('2018-10-12'), 1111, '!', 777.777)"
+    )
+    assert (
+        node7.query(
+           "SELECT COUNT(*) FROM compression_codec_multiple_with_key WHERE id % 2 == 0"
+        )
+        == "2\n"
+    )
+    assert (
+        node7.query(
+            "SELECT DISTINCT somecolumn FROM compression_codec_multiple_with_key ORDER BY id"
+        )
+        == "777.777\n88.88\n99.99\n"
+    )
+    assert (
+        node7.query(
+            "SELECT data FROM compression_codec_multiple_with_key WHERE id >= 1112 AND somedate = toDate('2018-10-12') AND somecolumn <= 100"
+        )
+        == "hello\nworld\n"
+    )
+
+    node7.query(
+        "INSERT INTO compression_codec_multiple_with_key SELECT toDate('2018-10-12'), number, toString(number), 1.0 FROM system.numbers LIMIT 10000"
+    )
+
+    assert (
+        node7.query(
+            "SELECT COUNT(id) FROM compression_codec_multiple_with_key WHERE id % 10 == 0"
+        )
+        == "1001\n"
+    )
+    assert (
+        node7.query(
+            "SELECT SUM(somecolumn) FROM compression_codec_multiple_with_key"
+        )
+        == str(777.777 + 88.88 + 99.99 + 1.0 * 10000) + "\n"
+    )
+    assert (
+        node7.query(
+            "SELECT count(*) FROM compression_codec_multiple_with_key GROUP BY somedate"
+        )
+        == "10003\n"
+    )
diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference b/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
index cfbfadf1e67..a6afe11126c 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
@@ -12,13 +12,7 @@ CODEC(NONE)
 2018-01-01	4	4
 2018-01-01	5	5
 2018-01-01	6	6
-2018-01-01	1	default_value
-2018-01-01	2	default_value
-2018-01-01	3	3
-2018-01-01	4	4
-2018-01-01	5	5
-2018-01-01	6	6
-CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, NONE)
+CODEC(DEFLATE_QPL)
 2018-01-01	1	default_value
 2018-01-01	2	default_value
 2018-01-01	3	3
@@ -27,7 +21,26 @@ CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, NONE)
 2018-01-01	6	6
 2018-01-01	7	7
 2018-01-01	8	8
-CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, NONE)
-CODEC(NONE, LZ4, LZ4HC(0), ZSTD(1))
+2018-01-01	1	default_value
+2018-01-01	2	default_value
+2018-01-01	3	3
+2018-01-01	4	4
+2018-01-01	5	5
+2018-01-01	6	6
+2018-01-01	7	7
+2018-01-01	8	8
+CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, DEFLATE_QPL, NONE)
+2018-01-01	1	default_value
+2018-01-01	2	default_value
+2018-01-01	3	3
+2018-01-01	4	4
+2018-01-01	5	5
+2018-01-01	6	6
+2018-01-01	7	7
+2018-01-01	8	8
+2018-01-01	9	9
+2018-01-01	10	10
+CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, DEFLATE_QPL, NONE)
+CODEC(NONE, LZ4, LZ4HC(0), ZSTD(1), DEFLATE_QPL)
 2
 1
diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
index 85e5f8b63ad..40a8bb4c7cb 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
@@ -25,15 +25,23 @@ INSERT INTO alter_compression_codec VALUES('2018-01-01', 5, '5');
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 6, '6');
 SELECT * FROM alter_compression_codec ORDER BY id;
 
-OPTIMIZE TABLE alter_compression_codec FINAL;
-SELECT * FROM alter_compression_codec ORDER BY id;
-
-SET allow_suspicious_codecs = 1;
-ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(ZSTD, LZ4HC, LZ4, LZ4, NONE);
+SET enable_qpl_deflate = 1;
+ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(DEFLATE_QPL);
 SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
 
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 7, '7');
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 8, '8');
+SELECT * FROM alter_compression_codec ORDER BY id;
+
+OPTIMIZE TABLE alter_compression_codec FINAL;
+SELECT * FROM alter_compression_codec ORDER BY id;
+
+SET allow_suspicious_codecs = 1;
+ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(ZSTD, LZ4HC, LZ4, LZ4, DEFLATE_QPL, NONE);
+SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
+
+INSERT INTO alter_compression_codec VALUES('2018-01-01', 9, '9');
+INSERT INTO alter_compression_codec VALUES('2018-01-01', 10, '10');
 OPTIMIZE TABLE alter_compression_codec FINAL;
 SELECT * FROM alter_compression_codec ORDER BY id;
 
@@ -54,15 +62,17 @@ ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01
 
 ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(ZSTD(100)); -- { serverError 433 }
 
+ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(DEFLATE_QPL(100)); -- { serverError 378 }
+
 DROP TABLE IF EXISTS alter_bad_codec;
 
 DROP TABLE IF EXISTS large_alter_table_00804;
 DROP TABLE IF EXISTS store_of_hash_00804;
 
 CREATE TABLE large_alter_table_00804 (
-    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12)),
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC),
-    data String CODEC(ZSTD(2), LZ4HC, NONE, LZ4, LZ4)
+    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), DEFLATE_QPL),
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, DEFLATE_QPL),
+    data String CODEC(ZSTD(2), LZ4HC, NONE, LZ4, LZ4, DEFLATE_QPL)
 ) ENGINE = MergeTree() PARTITION BY somedate ORDER BY id SETTINGS index_granularity = 2, index_granularity_bytes = '10Mi', min_bytes_for_wide_part = 0;
 
 INSERT INTO large_alter_table_00804 SELECT toDate('2019-01-01'), number, toString(number + rand()) FROM system.numbers LIMIT 300000;
@@ -71,7 +81,7 @@ CREATE TABLE store_of_hash_00804 (hash UInt64) ENGINE = Memory();
 
 INSERT INTO store_of_hash_00804 SELECT sum(cityHash64(*)) FROM large_alter_table_00804;
 
-ALTER TABLE large_alter_table_00804 MODIFY COLUMN data CODEC(NONE, LZ4, LZ4HC, ZSTD);
+ALTER TABLE large_alter_table_00804 MODIFY COLUMN data CODEC(NONE, LZ4, LZ4HC, ZSTD, DEFLATE_QPL);
 
 OPTIMIZE TABLE large_alter_table_00804;
 

From d85bc02388317ed4b2743814bcc217baf1652971 Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Wed, 24 May 2023 15:08:23 -0400
Subject: [PATCH 282/722] add function test for deflate_qpl

---
 ...4_test_custom_compression_codecs.reference |  8 ++--
 .../00804_test_custom_compression_codecs.sql  | 45 +++++++++++--------
 ...m_compression_codes_log_storages.reference | 20 ++++-----
 ..._custom_compression_codes_log_storages.sql | 41 +++++++++--------
 ...st_deflate_qpl_codec_compression.reference |  4 ++
 ...804_test_deflate_qpl_codec_compression.sql | 32 +++++++++++++
 ...804_test_delta_codec_compression.reference |  2 +
 .../00804_test_delta_codec_compression.sql    | 38 ++++++++++++++++
 8 files changed, 140 insertions(+), 50 deletions(-)
 create mode 100644 tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
 create mode 100644 tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql

diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference b/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
index 7bd91e5a69b..a9cbe3d32d3 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
@@ -1,6 +1,6 @@
-1	hello	2018-12-14	1.1	aaa	5
-2	world	2018-12-15	2.2	bbb	6
-3	!	2018-12-16	3.3	ccc	7
+1	hello	2018-12-14	1.1	aaa	5	qpl11	11
+2	world	2018-12-15	2.2	bbb	6	qpl22	22
+3	!	2018-12-16	3.3	ccc	7	qpl33	33
 2
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
@@ -9,7 +9,7 @@
 10003
 274972506.6
 9175437371954010821
-CREATE TABLE default.compression_codec_multiple_more_types\n(\n    `id` Decimal(38, 13) CODEC(ZSTD(1), LZ4, ZSTD(1), ZSTD(1), Delta(2), Delta(4), Delta(1), LZ4HC(0)),\n    `data` FixedString(12) CODEC(ZSTD(1), ZSTD(1), NONE, NONE, NONE, LZ4HC(0)),\n    `ddd.age` Array(UInt8) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8)),\n    `ddd.Name` Array(String) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8))\n)\nENGINE = MergeTree\nORDER BY tuple()\nSETTINGS index_granularity = 8192
+CREATE TABLE default.compression_codec_multiple_more_types\n(\n    `id` Decimal(38, 13) CODEC(ZSTD(1), LZ4, ZSTD(1), ZSTD(1), Delta(2), Delta(4), Delta(1), LZ4HC(0), DEFLATE_QPL),\n    `data` FixedString(12) CODEC(ZSTD(1), ZSTD(1), NONE, NONE, NONE, LZ4HC(0), DEFLATE_QPL),\n    `ddd.age` Array(UInt8) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8), DEFLATE_QPL),\n    `ddd.Name` Array(String) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8), DEFLATE_QPL)\n)\nENGINE = MergeTree\nORDER BY tuple()\nSETTINGS index_granularity = 8192
 1.5555555555555	hello world!	[77]	['John']
 7.1	xxxxxxxxxxxx	[127]	['Henry']
 !
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
index c080c2fc98e..44a0daada27 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
@@ -1,5 +1,6 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
+SET enable_qpl_deflate = 1;
 
 DROP TABLE IF EXISTS compression_codec;
 
@@ -9,18 +10,20 @@ CREATE TABLE compression_codec(
     ddd Date CODEC(NONE),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
-    othernum Int64 CODEC(Delta)
+    othernum Int64 CODEC(Delta),
+    qplstr String CODEC(DEFLATE_QPL),
+    qplnum UInt32 CODEC(DEFLATE_QPL),
 ) ENGINE = MergeTree() ORDER BY tuple();
 
-INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5);
-INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6);
-INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7);
+INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
+INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6,'qpl22', 22);
+INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
 
 SELECT * FROM compression_codec ORDER BY id;
 
 OPTIMIZE TABLE compression_codec FINAL;
 
-INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8);
+INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
 
 DETACH TABLE compression_codec;
 ATTACH TABLE compression_codec;
@@ -31,25 +34,31 @@ DROP TABLE IF EXISTS compression_codec;
 
 DROP TABLE IF EXISTS bad_codec;
 DROP TABLE IF EXISTS params_when_no_params;
+DROP TABLE IF EXISTS params_when_no_params2;
 DROP TABLE IF EXISTS too_many_params;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_1;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_2;
+DROP TABLE IF EXISTS codec_multiple_direct_specification_3;
 DROP TABLE IF EXISTS delta_bad_params1;
 DROP TABLE IF EXISTS delta_bad_params2;
 
 CREATE TABLE bad_codec(id UInt64 CODEC(adssadads)) ENGINE = MergeTree() order by tuple(); -- { serverError 432 }
 CREATE TABLE too_many_params(id UInt64 CODEC(ZSTD(2,3,4,5))) ENGINE = MergeTree() order by tuple(); -- { serverError 431 }
 CREATE TABLE params_when_no_params(id UInt64 CODEC(LZ4(1))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 378 }
+CREATE TABLE params_when_no_params2(id UInt64 CODEC(DEFLATE_QPL(1))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 378 }
 CREATE TABLE codec_multiple_direct_specification_1(id UInt64 CODEC(MULTIPLE(LZ4, ZSTD))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 432 }
 CREATE TABLE codec_multiple_direct_specification_2(id UInt64 CODEC(multiple(LZ4, ZSTD))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 432 }
+CREATE TABLE codec_multiple_direct_specification_3(id UInt64 CODEC(multiple(LZ4, DEFLATE_QPL))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 432 }
 CREATE TABLE delta_bad_params1(id UInt64 CODEC(Delta(3))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 433 }
 CREATE TABLE delta_bad_params2(id UInt64 CODEC(Delta(16))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 433 }
 
 DROP TABLE IF EXISTS bad_codec;
 DROP TABLE IF EXISTS params_when_no_params;
+DROP TABLE IF EXISTS params_when_no_params2;
 DROP TABLE IF EXISTS too_many_params;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_1;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_2;
+DROP TABLE IF EXISTS codec_multiple_direct_specification_3;
 DROP TABLE IF EXISTS delta_bad_params1;
 DROP TABLE IF EXISTS delta_bad_params2;
 
@@ -58,10 +67,10 @@ DROP TABLE IF EXISTS compression_codec_multiple;
 SET network_compression_method = 'lz4hc';
 
 CREATE TABLE compression_codec_multiple (
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4)),
-    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8)),
-    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC),
-    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD)
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4), DEFLATE_QPL),
+    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8), DEFLATE_QPL),
+    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC, DEFLATE_QPL),
+    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD, DEFLATE_QPL)
 ) ENGINE = MergeTree() ORDER BY tuple();
 
 INSERT INTO compression_codec_multiple VALUES (1, 'world', toDate('2018-10-05'), 1.1), (2, 'hello', toDate('2018-10-01'), 2.2), (3, 'buy', toDate('2018-10-11'), 3.3);
@@ -85,15 +94,15 @@ SELECT sum(cityHash64(*)) FROM compression_codec_multiple;
 DROP TABLE IF EXISTS compression_codec_multiple_more_types;
 
 CREATE TABLE compression_codec_multiple_more_types (
-    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC),
-    data FixedString(12) CODEC(ZSTD, ZSTD, Delta, Delta, Delta, NONE, NONE, NONE, LZ4HC),
-    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8))
+    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC, DEFLATE_QPL),
+    data FixedString(12) CODEC(ZSTD, ZSTD, Delta, Delta, Delta, NONE, NONE, NONE, LZ4HC, DEFLATE_QPL),
+    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8), DEFLATE_QPL)
 ) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 36 }
 
 CREATE TABLE compression_codec_multiple_more_types (
-    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC),
-    data FixedString(12) CODEC(ZSTD, ZSTD, NONE, NONE, NONE, LZ4HC),
-    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8))
+    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC, DEFLATE_QPL),
+    data FixedString(12) CODEC(ZSTD, ZSTD, NONE, NONE, NONE, LZ4HC, DEFLATE_QPL),
+    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8), DEFLATE_QPL)
 ) ENGINE = MergeTree() ORDER BY tuple();
 
 SHOW CREATE TABLE compression_codec_multiple_more_types;
@@ -109,9 +118,9 @@ SET network_compression_method = 'zstd';
 SET network_zstd_compression_level = 5;
 
 CREATE TABLE compression_codec_multiple_with_key (
-    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), Delta, Delta),
-    id UInt64 CODEC(LZ4, ZSTD, Delta, NONE, LZ4HC, Delta),
-    data String CODEC(ZSTD(2), Delta(1), LZ4HC, NONE, LZ4, LZ4)
+    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), Delta, Delta, DEFLATE_QPL),
+    id UInt64 CODEC(LZ4, ZSTD, Delta, NONE, LZ4HC, Delta, DEFLATE_QPL),
+    data String CODEC(ZSTD(2), Delta(1), LZ4HC, NONE, LZ4, LZ4, DEFLATE_QPL)
 ) ENGINE = MergeTree() PARTITION BY somedate ORDER BY id SETTINGS index_granularity = 2, index_granularity_bytes = '10Mi';
 
 
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference
index 8145ca99829..d64b8a77eed 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference
@@ -1,9 +1,9 @@
-CREATE TABLE default.compression_codec_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8))\n)\nENGINE = Log
-1	hello	2018-12-14	1.1	aaa	5
-2	world	2018-12-15	2.2	bbb	6
-3	!	2018-12-16	3.3	ccc	7
+CREATE TABLE default.compression_codec_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8)),\n    `qplstr` String CODEC(DEFLATE_QPL),\n    `qplnum` UInt32 CODEC(DEFLATE_QPL)\n)\nENGINE = Log
+1	hello	2018-12-14	1.1	aaa	5	qpl11	11
+2	world	2018-12-15	2.2	bbb	6	qpl22	22
+3	!	2018-12-16	3.3	ccc	7	qpl33	33
 2
-CREATE TABLE default.compression_codec_multiple_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4)),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8)),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0)),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1))\n)\nENGINE = Log
+CREATE TABLE default.compression_codec_multiple_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4), DEFLATE_QPL),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8), DEFLATE_QPL),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0), DEFLATE_QPL),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1), DEFLATE_QPL)\n)\nENGINE = Log
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
 3	buy	2018-10-11	3.3
@@ -11,12 +11,12 @@ CREATE TABLE default.compression_codec_multiple_log\n(\n    `id` UInt64 CODEC(LZ
 10003
 274972506.6
 9175437371954010821
-CREATE TABLE default.compression_codec_tiny_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8))\n)\nENGINE = TinyLog
-1	hello	2018-12-14	1.1	aaa	5
-2	world	2018-12-15	2.2	bbb	6
-3	!	2018-12-16	3.3	ccc	7
+CREATE TABLE default.compression_codec_tiny_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8)),\n    `qplstr` String CODEC(DEFLATE_QPL),\n    `qplnum` UInt32 CODEC(DEFLATE_QPL)\n)\nENGINE = TinyLog
+1	hello	2018-12-14	1.1	aaa	5	qpl11	11
+2	world	2018-12-15	2.2	bbb	6	qpl22	22
+3	!	2018-12-16	3.3	ccc	7	qpl33	33
 2
-CREATE TABLE default.compression_codec_multiple_tiny_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4)),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8)),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0)),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1))\n)\nENGINE = TinyLog
+CREATE TABLE default.compression_codec_multiple_tiny_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4), DEFLATE_QPL),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8), DEFLATE_QPL),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0), DEFLATE_QPL),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1), DEFLATE_QPL)\n)\nENGINE = TinyLog
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
 3	buy	2018-10-11	3.3
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
index fba6a216762..113f26732e7 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
@@ -1,5 +1,6 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
+SET enable_qpl_deflate = 1;
 
 -- copy-paste for storage log
 
@@ -11,18 +12,20 @@ CREATE TABLE compression_codec_log(
     ddd Date CODEC(NONE),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
-    othernum Int64 CODEC(Delta)
+    othernum Int64 CODEC(Delta),
+    qplstr String CODEC(DEFLATE_QPL),
+    qplnum UInt32 CODEC(DEFLATE_QPL),
 ) ENGINE = Log();
 
 SHOW CREATE TABLE compression_codec_log;
 
-INSERT INTO compression_codec_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5);
-INSERT INTO compression_codec_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6);
-INSERT INTO compression_codec_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7);
+INSERT INTO compression_codec_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
+INSERT INTO compression_codec_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6,'qpl22', 22);
+INSERT INTO compression_codec_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
 
 SELECT * FROM compression_codec_log ORDER BY id;
 
-INSERT INTO compression_codec_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8);
+INSERT INTO compression_codec_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
 
 DETACH TABLE compression_codec_log;
 ATTACH TABLE compression_codec_log;
@@ -34,10 +37,10 @@ DROP TABLE IF EXISTS compression_codec_log;
 DROP TABLE IF EXISTS compression_codec_multiple_log;
 
 CREATE TABLE compression_codec_multiple_log (
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4)),
-    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8)),
-    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC),
-    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD)
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4), DEFLATE_QPL),
+    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8), DEFLATE_QPL),
+    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC, DEFLATE_QPL),
+    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD, DEFLATE_QPL)
 ) ENGINE = Log();
 
 SHOW CREATE TABLE compression_codec_multiple_log;
@@ -69,18 +72,20 @@ CREATE TABLE compression_codec_tiny_log(
     ddd Date CODEC(NONE),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
-    othernum Int64 CODEC(Delta)
+    othernum Int64 CODEC(Delta),
+    qplstr String CODEC(DEFLATE_QPL),
+    qplnum UInt32 CODEC(DEFLATE_QPL),
 ) ENGINE = TinyLog();
 
 SHOW CREATE TABLE compression_codec_tiny_log;
 
-INSERT INTO compression_codec_tiny_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5);
-INSERT INTO compression_codec_tiny_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6);
-INSERT INTO compression_codec_tiny_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7);
+INSERT INTO compression_codec_tiny_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
+INSERT INTO compression_codec_tiny_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6, 'qpl22', 22);
+INSERT INTO compression_codec_tiny_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
 
 SELECT * FROM compression_codec_tiny_log ORDER BY id;
 
-INSERT INTO compression_codec_tiny_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8);
+INSERT INTO compression_codec_tiny_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
 
 DETACH TABLE compression_codec_tiny_log;
 ATTACH TABLE compression_codec_tiny_log;
@@ -92,10 +97,10 @@ DROP TABLE IF EXISTS compression_codec_tiny_log;
 DROP TABLE IF EXISTS compression_codec_multiple_tiny_log;
 
 CREATE TABLE compression_codec_multiple_tiny_log (
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4)),
-    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8)),
-    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC),
-    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD)
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4), DEFLATE_QPL),
+    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8), DEFLATE_QPL),
+    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC, DEFLATE_QPL),
+    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD, DEFLATE_QPL)
 ) ENGINE = TinyLog();
 
 SHOW CREATE TABLE compression_codec_multiple_tiny_log;
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
new file mode 100644
index 00000000000..88d274d9cba
--- /dev/null
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
@@ -0,0 +1,4 @@
+1	hello	2018-12-14	1.1	aaa	5	qpl11	11
+2	world	2018-12-15	2.2	bbb	6	qpl22	22
+3	!	2018-12-16	3.3	ccc	7	qpl33	33
+2
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
new file mode 100644
index 00000000000..fe23e49804d
--- /dev/null
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -0,0 +1,32 @@
+SET send_logs_level = 'fatal';
+SET enable_qpl_deflate = 1;
+
+DROP TABLE IF EXISTS compression_codec;
+
+CREATE TABLE compression_codec(
+    id UInt64 CODEC(DEFLATE_QPL),
+    data String CODEC(DEFLATE_QPL),
+    ddd Date CODEC(DEFLATE_QPL),
+    somenum Float64 CODEC(DEFLATE_QPL),
+    somestr FixedString(3) CODEC(DEFLATE_QPL),
+    othernum Int64 CODEC(DEFLATE_QPL),
+    qplstr String CODEC(DEFLATE_QPL),
+    qplnum UInt32 CODEC(DEFLATE_QPL),
+) ENGINE = MergeTree() ORDER BY tuple();
+
+INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
+INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6,'qpl22', 22);
+INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
+
+SELECT * FROM compression_codec ORDER BY id;
+
+OPTIMIZE TABLE compression_codec FINAL;
+
+INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
+
+DETACH TABLE compression_codec;
+ATTACH TABLE compression_codec;
+
+SELECT count(*) FROM compression_codec WHERE id = 2 GROUP BY id;
+
+DROP TABLE IF EXISTS compression_codec;
diff --git a/tests/queries/0_stateless/00804_test_delta_codec_compression.reference b/tests/queries/0_stateless/00804_test_delta_codec_compression.reference
index 949d37ed27a..37f9d4901b3 100644
--- a/tests/queries/0_stateless/00804_test_delta_codec_compression.reference
+++ b/tests/queries/0_stateless/00804_test_delta_codec_compression.reference
@@ -4,3 +4,5 @@
 1
 32
 1
+17
+1
diff --git a/tests/queries/0_stateless/00804_test_delta_codec_compression.sql b/tests/queries/0_stateless/00804_test_delta_codec_compression.sql
index 25988f6474b..f9805246662 100644
--- a/tests/queries/0_stateless/00804_test_delta_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_delta_codec_compression.sql
@@ -115,3 +115,41 @@ USING(key);
 
 DROP TABLE IF EXISTS delta_codec_string;
 DROP TABLE IF EXISTS default_codec_string;
+
+SET enable_qpl_deflate = 1;
+DROP TABLE IF EXISTS delta_codec_string_qpl;
+DROP TABLE IF EXISTS default_codec_string_qpl;
+
+CREATE TABLE delta_codec_string_qpl
+(
+    id Float64 Codec(Delta, DEFLATE_QPL)
+) ENGINE MergeTree() ORDER BY tuple() SETTINGS min_bytes_for_wide_part = 0, compress_marks = false, compress_primary_key=false;
+
+CREATE TABLE default_codec_string_qpl
+(
+    id Float64 Codec(DEFLATE_QPL)
+) ENGINE MergeTree() ORDER BY tuple() SETTINGS min_bytes_for_wide_part = 0, compress_marks = false, compress_primary_key=false;
+
+INSERT INTO delta_codec_string_qpl SELECT concat(toString(number), toString(number % 100)) FROM numbers(1547510400, 500000);
+INSERT INTO default_codec_string_qpl SELECT * from delta_codec_string_qpl;
+
+OPTIMIZE TABLE delta_codec_string_qpl FINAL;
+OPTIMIZE TABLE default_codec_string_qpl FINAL;
+
+SELECT
+    floor(big_size / small_size) as ratio
+FROM
+    (SELECT 1 AS key, sum(bytes_on_disk) AS small_size FROM system.parts WHERE database = currentDatabase() and table = 'delta_codec_string_qpl' and active)
+INNER JOIN
+    (SELECT 1 AS key, sum(bytes_on_disk) as big_size FROM system.parts WHERE database = currentDatabase() and table = 'default_codec_string_qpl' and active) USING(key);
+
+SELECT
+    small_hash == big_hash
+FROM
+    (SELECT 1 AS key, sum(cityHash64(*)) AS small_hash FROM delta_codec_string_qpl)
+INNER JOIN
+    (SELECT 1 AS key, sum(cityHash64(*)) AS big_hash FROM default_codec_string_qpl)
+USING(key);
+
+DROP TABLE IF EXISTS delta_codec_string_qpl;
+DROP TABLE IF EXISTS default_codec_string_qpl;

From 31173ab55b0926f634c2fbfc06f7d2f34410a4ff Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Wed, 24 May 2023 15:15:40 -0400
Subject: [PATCH 283/722] add sections of deflate_qpl for stress test and
 performance test

---
 tests/ci/stress.py                        | 1 +
 tests/performance/codecs_float_insert.xml | 2 ++
 tests/performance/codecs_float_select.xml | 2 ++
 tests/performance/codecs_int_insert.xml   | 2 ++
 tests/performance/codecs_int_select.xml   | 2 ++
 5 files changed, 9 insertions(+)

diff --git a/tests/ci/stress.py b/tests/ci/stress.py
index b9044874071..b95cac9044e 100755
--- a/tests/ci/stress.py
+++ b/tests/ci/stress.py
@@ -20,6 +20,7 @@ def get_options(i, upgrade_check):
             '''--db-engine="Replicated('/test/db/test_{}', 's1', 'r1')"'''.format(i)
         )
         client_options.append("allow_experimental_database_replicated=1")
+        client_options.append("enable_qpl_deflate=1")
 
     # If database name is not specified, new database is created for each functional test.
     # Run some threads with one database for all tests.
diff --git a/tests/performance/codecs_float_insert.xml b/tests/performance/codecs_float_insert.xml
index 64325d30189..25291f7f499 100644
--- a/tests/performance/codecs_float_insert.xml
+++ b/tests/performance/codecs_float_insert.xml
@@ -1,6 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
+        <enable_deflate_qpl >1</enable_deflate_qpl >
     </settings>
 
     <substitutions>
@@ -10,6 +11,7 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
+                <value>DEFLATE_QPL</value>
                 <value>DoubleDelta</value>
                 <value>Gorilla</value>
                 <value>FPC</value>
diff --git a/tests/performance/codecs_float_select.xml b/tests/performance/codecs_float_select.xml
index 325c140d9a0..bb67987c75e 100644
--- a/tests/performance/codecs_float_select.xml
+++ b/tests/performance/codecs_float_select.xml
@@ -1,6 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
+        <enable_deflate_qpl >1</enable_deflate_qpl >
     </settings>
 
     <substitutions>
@@ -10,6 +11,7 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
+                <value>DEFLATE_QPL</value>
                 <value>DoubleDelta</value>
                 <value>Gorilla</value>
                 <value>FPC</value>
diff --git a/tests/performance/codecs_int_insert.xml b/tests/performance/codecs_int_insert.xml
index 618e20160f8..1db9ee8f746 100644
--- a/tests/performance/codecs_int_insert.xml
+++ b/tests/performance/codecs_int_insert.xml
@@ -1,6 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
+        <enable_deflate_qpl >1</enable_deflate_qpl >
     </settings>
 
     <substitutions>
@@ -10,6 +11,7 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
+                <value>DEFLATE_QPL</value>
                 <value>Delta</value>
                 <value>T64</value>
                 <value>DoubleDelta</value>
diff --git a/tests/performance/codecs_int_select.xml b/tests/performance/codecs_int_select.xml
index 62c1ee16e7b..5dc7ab48704 100644
--- a/tests/performance/codecs_int_select.xml
+++ b/tests/performance/codecs_int_select.xml
@@ -1,6 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
+        <enable_deflate_qpl >1</enable_deflate_qpl >
     </settings>
 
     <substitutions>
@@ -10,6 +11,7 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
+                <value>DEFLATE_QPL</value>
                 <value>Delta</value>
                 <value>T64</value>
                 <value>DoubleDelta</value>

From cbdb408ec8330c8ce469c68e979ca208c76d0629 Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Fri, 26 May 2023 12:15:34 -0400
Subject: [PATCH 284/722] add USE_QPL for buildoptions

---
 src/Storages/System/StorageSystemBuildOptions.cpp.in | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Storages/System/StorageSystemBuildOptions.cpp.in b/src/Storages/System/StorageSystemBuildOptions.cpp.in
index 3465e47449b..c2a188e7750 100644
--- a/src/Storages/System/StorageSystemBuildOptions.cpp.in
+++ b/src/Storages/System/StorageSystemBuildOptions.cpp.in
@@ -68,6 +68,7 @@ const char * auto_config_build[]
     "GIT_BRANCH", R"IRjaNsZIL9Yh7FQ4(@GIT_BRANCH@)IRjaNsZIL9Yh7FQ4",
     "GIT_DATE", "@GIT_DATE@",
     "GIT_COMMIT_SUBJECT", R"Gi17KJMlbGCjErEN(@GIT_COMMIT_SUBJECT@)Gi17KJMlbGCjErEN",
+    "USE_QPL", "@ENABLE_QPL@",
 
     nullptr, nullptr
 };

From f1192d59afa7ee2271d7ee6b5cb9d98bb27254a0 Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Thu, 1 Jun 2023 12:42:22 -0400
Subject: [PATCH 285/722] refine patch according to comments

---
 .../sql-reference/statements/create/table.md  |  2 +-
 src/Client/Connection.cpp                     |  2 +-
 src/Compression/CompressionFactory.h          |  4 +-
 .../CompressionFactoryAdditions.cpp           | 12 +++---
 src/Compression/ICompressionCodec.h           |  6 +--
 src/Core/Settings.h                           |  2 +-
 src/Interpreters/InterpreterCreateQuery.cpp   |  4 +-
 src/Server/TCPHandler.cpp                     |  2 +-
 src/Storages/AlterCommands.cpp                |  4 +-
 src/Storages/Distributed/DistributedSink.cpp  |  2 +-
 src/Storages/TTLDescription.cpp               |  2 +-
 tests/ci/stress.py                            |  2 +-
 .../configs/enable_deflateqpl_codec.xml       |  2 +-
 .../test_non_default_compression/test.py      | 32 ++++++++--------
 tests/performance/codecs_float_insert.xml     |  3 +-
 tests/performance/codecs_float_select.xml     |  3 +-
 tests/performance/codecs_int_insert.xml       |  3 +-
 tests/performance/codecs_int_select.xml       |  3 +-
 ...04_test_alter_compression_codecs.reference |  4 +-
 .../00804_test_alter_compression_codecs.sql   | 10 ++---
 ...4_test_custom_compression_codecs.reference |  6 +--
 .../00804_test_custom_compression_codecs.sql  | 13 +++----
 ..._custom_compression_codes_log_storages.sql |  2 +-
 ...st_deflate_qpl_codec_compression.reference |  6 +--
 ...804_test_deflate_qpl_codec_compression.sql | 16 ++++----
 ...804_test_delta_codec_compression.reference |  2 -
 .../00804_test_delta_codec_compression.sql    | 38 -------------------
 27 files changed, 71 insertions(+), 116 deletions(-)

diff --git a/docs/en/sql-reference/statements/create/table.md b/docs/en/sql-reference/statements/create/table.md
index b0865ad2896..d0e17410791 100644
--- a/docs/en/sql-reference/statements/create/table.md
+++ b/docs/en/sql-reference/statements/create/table.md
@@ -380,7 +380,7 @@ High compression levels are useful for asymmetric scenarios, like compress once,
 
 `DEFLATE_QPL` — [Deflate compression algorithm](https://github.com/intel/qpl) implemented by Intel® Query Processing Library. Some limitations apply:
 
-- DEFLATE_QPL is disabled by default and can only be used after setting configuration parameter `enable_qpl_deflate=1`.
+- DEFLATE_QPL is disabled by default and can only be used after setting configuration parameter `enable_qpl_deflate_codec=1`.
 - DEFLATE_QPL requires a ClickHouse build compiled with SSE 4.2 instructions (by default, this is the case). Refer to [Build Clickhouse with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Build-Clickhouse-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL works best if the system has a Intel® IAA (In-Memory Analytics Accelerator) offloading device. Refer to [Accelerator Configuration](https://intel.github.io/qpl/documentation/get_started_docs/installation.html#accelerator-configuration) and [Benchmark with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Run-Benchmark-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL-compressed data can only be transferred between ClickHouse nodes compiled with SSE 4.2 enabled.
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index 68bc3b39a56..ac8e6654e84 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -588,7 +588,7 @@ void Connection::sendQuery(
         if (method == "ZSTD")
             level = settings->network_zstd_compression_level;
 
-        CompressionCodecFactory::instance().validateCodec(method, level, !settings->allow_suspicious_codecs, settings->allow_experimental_codecs, settings->enable_qpl_deflate);
+        CompressionCodecFactory::instance().validateCodec(method, level, !settings->allow_suspicious_codecs, settings->allow_experimental_codecs, settings->enable_qpl_deflate_codec);
         compression_codec = CompressionCodecFactory::instance().get(method, level);
     }
     else
diff --git a/src/Compression/CompressionFactory.h b/src/Compression/CompressionFactory.h
index 1fdaf4f1c71..e020e51bb09 100644
--- a/src/Compression/CompressionFactory.h
+++ b/src/Compression/CompressionFactory.h
@@ -40,10 +40,10 @@ public:
     CompressionCodecPtr getDefaultCodec() const;
 
     /// Validate codecs AST specified by user and parses codecs description (substitute default parameters)
-    ASTPtr validateCodecAndGetPreprocessedAST(const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const;
+    ASTPtr validateCodecAndGetPreprocessedAST(const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const;
 
     /// Validate codecs AST specified by user
-    void validateCodec(const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const;
+    void validateCodec(const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const;
 
     /// Get codec by AST and possible column_type. Some codecs can use
     /// information about type to improve inner settings, but every codec should
diff --git a/src/Compression/CompressionFactoryAdditions.cpp b/src/Compression/CompressionFactoryAdditions.cpp
index 2630326238a..b4a2d96cf39 100644
--- a/src/Compression/CompressionFactoryAdditions.cpp
+++ b/src/Compression/CompressionFactoryAdditions.cpp
@@ -34,7 +34,7 @@ namespace ErrorCodes
 
 
 void CompressionCodecFactory::validateCodec(
-    const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const
+    const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const
 {
     if (family_name.empty())
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Compression codec name cannot be empty");
@@ -43,13 +43,13 @@ void CompressionCodecFactory::validateCodec(
     {
         auto literal = std::make_shared<ASTLiteral>(static_cast<UInt64>(*level));
         validateCodecAndGetPreprocessedAST(makeASTFunction("CODEC", makeASTFunction(Poco::toUpper(family_name), literal)),
-            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate);
+            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate_codec);
     }
     else
     {
         auto identifier = std::make_shared<ASTIdentifier>(Poco::toUpper(family_name));
         validateCodecAndGetPreprocessedAST(makeASTFunction("CODEC", identifier),
-            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate);
+            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate_codec);
     }
 }
 
@@ -77,7 +77,7 @@ bool innerDataTypeIsFloat(const DataTypePtr & type)
 }
 
 ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
-    const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate) const
+    const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const
 {
     if (const auto * func = ast->as<ASTFunction>())
     {
@@ -159,10 +159,10 @@ ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
                         " You can enable it with the 'allow_experimental_codecs' setting.",
                         codec_family_name);
 
-                if (!enable_qpl_deflate && result_codec->isDeflateQplCompression())
+                if (!enable_qpl_deflate_codec && result_codec->isDeflateQplCompression())
                     throw Exception(ErrorCodes::BAD_ARGUMENTS,
                         "Codec {} is disabled by default."
-                        " You can enable it with the 'enable_qpl_deflate' setting.",
+                        " You can enable it with the 'enable_qpl_deflate_codec' setting.",
                         codec_family_name);
 
                 codecs_descriptions->children.emplace_back(result_codec->getCodecDesc());
diff --git a/src/Compression/ICompressionCodec.h b/src/Compression/ICompressionCodec.h
index d92ad3fc718..f7e8f4e43d2 100644
--- a/src/Compression/ICompressionCodec.h
+++ b/src/Compression/ICompressionCodec.h
@@ -109,12 +109,12 @@ public:
     /// It will not be allowed to use unless the user will turn off the safety switch.
     virtual bool isExperimental() const { return false; }
 
-    /// If it does nothing.
-    virtual bool isNone() const { return false; }
-
     /// This is a knob for Deflate QPL codec.
     virtual bool isDeflateQplCompression() const { return false; }
 
+    /// If it does nothing.
+    virtual bool isNone() const { return false; }
+
 protected:
     /// This is used for fuzz testing
     friend int LLVMFuzzerTestOneInput(const uint8_t * data, size_t size);
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index c6a2069e6ae..4aae8f5d572 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -319,7 +319,7 @@ class IColumn;
     M(Bool, allow_distributed_ddl, true, "If it is set to true, then a user is allowed to executed distributed DDL queries.", 0) \
     M(Bool, allow_suspicious_codecs, false, "If it is set to true, allow to specify meaningless compression codecs.", 0) \
     M(Bool, allow_experimental_codecs, false, "If it is set to true, allow to specify experimental compression codecs (but we don't have those yet and this option does nothing).", 0) \
-    M(Bool, enable_qpl_deflate, false, "If it is set to true, allow to use deflate_qpl for compression.", 0) \
+    M(Bool, enable_qpl_deflate_codec, false, "If it is set to true, allow usage of the DEFLATE_QPL codec.", 0) \
     M(UInt64, query_profiler_real_time_period_ns, QUERY_PROFILER_DEFAULT_SAMPLE_RATE_NS, "Period for real clock timer of query profiler (in nanoseconds). Set 0 value to turn off the real clock query profiler. Recommended value is at least 10000000 (100 times a second) for single queries or 1000000000 (once a second) for cluster-wide profiling.", 0) \
     M(UInt64, query_profiler_cpu_time_period_ns, QUERY_PROFILER_DEFAULT_SAMPLE_RATE_NS, "Period for CPU clock timer of query profiler (in nanoseconds). Set 0 value to turn off the CPU clock query profiler. Recommended value is at least 10000000 (100 times a second) for single queries or 1000000000 (once a second) for cluster-wide profiling.", 0) \
     M(Bool, metrics_perf_events_enabled, false, "If enabled, some of the perf events will be measured throughout queries' execution.", 0) \
diff --git a/src/Interpreters/InterpreterCreateQuery.cpp b/src/Interpreters/InterpreterCreateQuery.cpp
index 5c22b46b360..ddb53bbbfaa 100644
--- a/src/Interpreters/InterpreterCreateQuery.cpp
+++ b/src/Interpreters/InterpreterCreateQuery.cpp
@@ -571,7 +571,7 @@ ColumnsDescription InterpreterCreateQuery::getColumnsDescription(
 
     bool sanity_check_compression_codecs = !attach && !context_->getSettingsRef().allow_suspicious_codecs;
     bool allow_experimental_codecs = attach || context_->getSettingsRef().allow_experimental_codecs;
-    bool enable_qpl_deflate = attach || context_->getSettingsRef().enable_qpl_deflate;
+    bool enable_qpl_deflate_codec = attach || context_->getSettingsRef().enable_qpl_deflate_codec;
 
     ColumnsDescription res;
     auto name_type_it = column_names_and_types.begin();
@@ -632,7 +632,7 @@ ColumnsDescription InterpreterCreateQuery::getColumnsDescription(
             if (col_decl.default_specifier == "ALIAS")
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cannot specify codec for column type ALIAS");
             column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(
-                col_decl.codec, column.type, sanity_check_compression_codecs, allow_experimental_codecs, enable_qpl_deflate);
+                col_decl.codec, column.type, sanity_check_compression_codecs, allow_experimental_codecs, enable_qpl_deflate_codec);
         }
 
         if (col_decl.ttl)
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 96c585e7d16..b43fef9dd54 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -1775,7 +1775,7 @@ void TCPHandler::initBlockOutput(const Block & block)
 
             if (state.compression == Protocol::Compression::Enable)
             {
-                CompressionCodecFactory::instance().validateCodec(method, level, !query_settings.allow_suspicious_codecs, query_settings.allow_experimental_codecs, query_settings.enable_qpl_deflate);
+                CompressionCodecFactory::instance().validateCodec(method, level, !query_settings.allow_suspicious_codecs, query_settings.allow_experimental_codecs, query_settings.enable_qpl_deflate_codec);
 
                 state.maybe_compressed_out = std::make_shared<CompressedWriteBuffer>(
                     *out, CompressionCodecFactory::instance().get(method, level));
diff --git a/src/Storages/AlterCommands.cpp b/src/Storages/AlterCommands.cpp
index ecbddfc3e2a..73d7be8dc56 100644
--- a/src/Storages/AlterCommands.cpp
+++ b/src/Storages/AlterCommands.cpp
@@ -1067,7 +1067,7 @@ void AlterCommands::validate(const StoragePtr & table, ContextPtr context) const
                                 "this column name is reserved for lightweight delete feature", backQuote(column_name));
 
             if (command.codec)
-                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate);
+                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate_codec);
 
             all_columns.add(ColumnDescription(column_name, command.data_type));
         }
@@ -1093,7 +1093,7 @@ void AlterCommands::validate(const StoragePtr & table, ContextPtr context) const
             {
                 if (all_columns.hasAlias(column_name))
                     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cannot specify codec for column type ALIAS");
-                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate);
+                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate_codec);
             }
             auto column_default = all_columns.getDefault(column_name);
             if (column_default)
diff --git a/src/Storages/Distributed/DistributedSink.cpp b/src/Storages/Distributed/DistributedSink.cpp
index ce1dbde8eae..e383890d1f7 100644
--- a/src/Storages/Distributed/DistributedSink.cpp
+++ b/src/Storages/Distributed/DistributedSink.cpp
@@ -733,7 +733,7 @@ void DistributedSink::writeToShard(const Cluster::ShardInfo & shard_info, const
     if (compression_method == "ZSTD")
         compression_level = settings.network_zstd_compression_level;
 
-    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enable_qpl_deflate);
+    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enable_qpl_deflate_codec);
     CompressionCodecPtr compression_codec = CompressionCodecFactory::instance().get(compression_method, compression_level);
 
     /// tmp directory is used to ensure atomicity of transactions
diff --git a/src/Storages/TTLDescription.cpp b/src/Storages/TTLDescription.cpp
index f5209cbdff6..a437465b3fe 100644
--- a/src/Storages/TTLDescription.cpp
+++ b/src/Storages/TTLDescription.cpp
@@ -285,7 +285,7 @@ TTLDescription TTLDescription::getTTLFromAST(
         {
             result.recompression_codec =
                 CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(
-                    ttl_element->recompression_codec, {}, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate);
+                    ttl_element->recompression_codec, {}, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate_codec);
         }
     }
 
diff --git a/tests/ci/stress.py b/tests/ci/stress.py
index b95cac9044e..e5ceb251d0f 100755
--- a/tests/ci/stress.py
+++ b/tests/ci/stress.py
@@ -20,7 +20,7 @@ def get_options(i, upgrade_check):
             '''--db-engine="Replicated('/test/db/test_{}', 's1', 'r1')"'''.format(i)
         )
         client_options.append("allow_experimental_database_replicated=1")
-        client_options.append("enable_qpl_deflate=1")
+        client_options.append("enable_qpl_deflate_codec=1")
 
     # If database name is not specified, new database is created for each functional test.
     # Run some threads with one database for all tests.
diff --git a/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml b/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
index 46e9e43ca27..521b0fd663c 100644
--- a/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
+++ b/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
@@ -1,7 +1,7 @@
 <clickhouse>
     <profiles>
         <default>
-            <enable_qpl_deflate>1</enable_qpl_deflate>
+            <enable_qpl_deflate_codec>1</enable_qpl_deflate_codec>
         </default>
     </profiles>
 </clickhouse>
diff --git a/tests/integration/test_non_default_compression/test.py b/tests/integration/test_non_default_compression/test.py
index e69b32daae0..e1a9c1ae540 100644
--- a/tests/integration/test_non_default_compression/test.py
+++ b/tests/integration/test_non_default_compression/test.py
@@ -38,16 +38,16 @@ node5 = cluster.add_instance(
 )
 node6 = cluster.add_instance(
     "node6",
-    main_configs=["configs/allow_experimental_codecs.xml"],
-    user_configs=["configs/allow_suspicious_codecs.xml"],
+    main_configs=["configs/deflateqpl_compression_by_default.xml"],
+    user_configs=[
+        "configs/allow_suspicious_codecs.xml",
+        "configs/enable_deflateqpl_codec.xml",
+    ],
 )
 node7 = cluster.add_instance(
     "node7",
-    main_configs=["configs/deflateqpl_compression_by_default.xml"],
-    user_configs=[
-        "configs/enable_deflateqpl_codec.xml",
-        "configs/allow_suspicious_codecs.xml",
-    ],
+    main_configs=["configs/allow_experimental_codecs.xml"],
+    user_configs=["configs/allow_suspicious_codecs.xml"],
 )
 
 @pytest.fixture(scope="module")
@@ -253,7 +253,7 @@ def test_uncompressed_cache_plus_zstd_codec(start_cluster):
     )
 
 def test_preconfigured_deflateqpl_codec(start_cluster):
-    node7.query(
+    node6.query(
         """
     CREATE TABLE compression_codec_multiple_with_key (
         somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), DEFLATE_QPL),
@@ -263,46 +263,46 @@ def test_preconfigured_deflateqpl_codec(start_cluster):
     ) ENGINE = MergeTree() PARTITION BY somedate ORDER BY id SETTINGS index_granularity = 2;
     """
     )
-    node7.query(
+    node6.query(
         "INSERT INTO compression_codec_multiple_with_key VALUES(toDate('2018-10-12'), 100000, 'hello', 88.88), (toDate('2018-10-12'), 100002, 'world', 99.99), (toDate('2018-10-12'), 1111, '!', 777.777)"
     )
     assert (
-        node7.query(
+        node6.query(
            "SELECT COUNT(*) FROM compression_codec_multiple_with_key WHERE id % 2 == 0"
         )
         == "2\n"
     )
     assert (
-        node7.query(
+        node6.query(
             "SELECT DISTINCT somecolumn FROM compression_codec_multiple_with_key ORDER BY id"
         )
         == "777.777\n88.88\n99.99\n"
     )
     assert (
-        node7.query(
+        node6.query(
             "SELECT data FROM compression_codec_multiple_with_key WHERE id >= 1112 AND somedate = toDate('2018-10-12') AND somecolumn <= 100"
         )
         == "hello\nworld\n"
     )
 
-    node7.query(
+    node6.query(
         "INSERT INTO compression_codec_multiple_with_key SELECT toDate('2018-10-12'), number, toString(number), 1.0 FROM system.numbers LIMIT 10000"
     )
 
     assert (
-        node7.query(
+        node6.query(
             "SELECT COUNT(id) FROM compression_codec_multiple_with_key WHERE id % 10 == 0"
         )
         == "1001\n"
     )
     assert (
-        node7.query(
+        node6.query(
             "SELECT SUM(somecolumn) FROM compression_codec_multiple_with_key"
         )
         == str(777.777 + 88.88 + 99.99 + 1.0 * 10000) + "\n"
     )
     assert (
-        node7.query(
+        node6.query(
             "SELECT count(*) FROM compression_codec_multiple_with_key GROUP BY somedate"
         )
         == "10003\n"
diff --git a/tests/performance/codecs_float_insert.xml b/tests/performance/codecs_float_insert.xml
index 25291f7f499..be0935ad4cf 100644
--- a/tests/performance/codecs_float_insert.xml
+++ b/tests/performance/codecs_float_insert.xml
@@ -1,7 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl >1</enable_deflate_qpl >
+        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>
@@ -11,7 +11,6 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
-                <value>DEFLATE_QPL</value>
                 <value>DoubleDelta</value>
                 <value>Gorilla</value>
                 <value>FPC</value>
diff --git a/tests/performance/codecs_float_select.xml b/tests/performance/codecs_float_select.xml
index bb67987c75e..844ab4508d8 100644
--- a/tests/performance/codecs_float_select.xml
+++ b/tests/performance/codecs_float_select.xml
@@ -1,7 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl >1</enable_deflate_qpl >
+        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>
@@ -11,7 +11,6 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
-                <value>DEFLATE_QPL</value>
                 <value>DoubleDelta</value>
                 <value>Gorilla</value>
                 <value>FPC</value>
diff --git a/tests/performance/codecs_int_insert.xml b/tests/performance/codecs_int_insert.xml
index 1db9ee8f746..d5f12810118 100644
--- a/tests/performance/codecs_int_insert.xml
+++ b/tests/performance/codecs_int_insert.xml
@@ -1,7 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl >1</enable_deflate_qpl >
+        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>
@@ -11,7 +11,6 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
-                <value>DEFLATE_QPL</value>
                 <value>Delta</value>
                 <value>T64</value>
                 <value>DoubleDelta</value>
diff --git a/tests/performance/codecs_int_select.xml b/tests/performance/codecs_int_select.xml
index 5dc7ab48704..06b2c2a73f3 100644
--- a/tests/performance/codecs_int_select.xml
+++ b/tests/performance/codecs_int_select.xml
@@ -1,7 +1,7 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl >1</enable_deflate_qpl >
+        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>
@@ -11,7 +11,6 @@
                 <value>NONE</value> <!-- as a baseline -->
                 <value>LZ4</value>
                 <value>ZSTD</value>
-                <value>DEFLATE_QPL</value>
                 <value>Delta</value>
                 <value>T64</value>
                 <value>DoubleDelta</value>
diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference b/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
index a6afe11126c..5c77a102740 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
@@ -12,15 +12,13 @@ CODEC(NONE)
 2018-01-01	4	4
 2018-01-01	5	5
 2018-01-01	6	6
-CODEC(DEFLATE_QPL)
 2018-01-01	1	default_value
 2018-01-01	2	default_value
 2018-01-01	3	3
 2018-01-01	4	4
 2018-01-01	5	5
 2018-01-01	6	6
-2018-01-01	7	7
-2018-01-01	8	8
+CODEC(DEFLATE_QPL)
 2018-01-01	1	default_value
 2018-01-01	2	default_value
 2018-01-01	3	3
diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
index 40a8bb4c7cb..5b8b73270a2 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
@@ -25,7 +25,10 @@ INSERT INTO alter_compression_codec VALUES('2018-01-01', 5, '5');
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 6, '6');
 SELECT * FROM alter_compression_codec ORDER BY id;
 
-SET enable_qpl_deflate = 1;
+OPTIMIZE TABLE alter_compression_codec FINAL;
+SELECT * FROM alter_compression_codec ORDER BY id;
+
+SET enable_qpl_deflate_codec = 1;
 ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(DEFLATE_QPL);
 SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
 
@@ -33,9 +36,6 @@ INSERT INTO alter_compression_codec VALUES('2018-01-01', 7, '7');
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 8, '8');
 SELECT * FROM alter_compression_codec ORDER BY id;
 
-OPTIMIZE TABLE alter_compression_codec FINAL;
-SELECT * FROM alter_compression_codec ORDER BY id;
-
 SET allow_suspicious_codecs = 1;
 ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(ZSTD, LZ4HC, LZ4, LZ4, DEFLATE_QPL, NONE);
 SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
@@ -62,7 +62,7 @@ ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01
 
 ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(ZSTD(100)); -- { serverError 433 }
 
-ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(DEFLATE_QPL(100)); -- { serverError 378 }
+ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(DEFLATE_QPL(100)); -- { serverError DATA_TYPE_CANNOT_HAVE_ARGUMENTS }
 
 DROP TABLE IF EXISTS alter_bad_codec;
 
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference b/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
index a9cbe3d32d3..8b51d65004a 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
@@ -1,6 +1,6 @@
-1	hello	2018-12-14	1.1	aaa	5	qpl11	11
-2	world	2018-12-15	2.2	bbb	6	qpl22	22
-3	!	2018-12-16	3.3	ccc	7	qpl33	33
+1	hello	2018-12-14	2018-12-14	1.1	aaa	5
+2	world	2018-12-15	2018-12-15	2.2	bbb	6
+3	!	2018-12-16	2018-12-16	3.3	ccc	7
 2
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
index 44a0daada27..47ec268bfec 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
@@ -1,6 +1,6 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
-SET enable_qpl_deflate = 1;
+SET enable_qpl_deflate_codec = 1;
 
 DROP TABLE IF EXISTS compression_codec;
 
@@ -8,22 +8,21 @@ CREATE TABLE compression_codec(
     id UInt64 CODEC(LZ4),
     data String CODEC(ZSTD),
     ddd Date CODEC(NONE),
+    ddd32 Date32 CODEC(DEFLATE_QPL),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
     othernum Int64 CODEC(Delta),
-    qplstr String CODEC(DEFLATE_QPL),
-    qplnum UInt32 CODEC(DEFLATE_QPL),
 ) ENGINE = MergeTree() ORDER BY tuple();
 
-INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
-INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6,'qpl22', 22);
-INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
+INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), toDate32('2018-12-14'), 1.1, 'aaa', 5);
+INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), toDate32('2018-12-15'), 2.2, 'bbb', 6);
+INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), toDate32('2018-12-16'), 3.3, 'ccc', 7);
 
 SELECT * FROM compression_codec ORDER BY id;
 
 OPTIMIZE TABLE compression_codec FINAL;
 
-INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
+INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), toDate32('2018-12-13'), 4.4, 'ddd', 8);
 
 DETACH TABLE compression_codec;
 ATTACH TABLE compression_codec;
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
index 113f26732e7..bcd09277824 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
@@ -1,6 +1,6 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
-SET enable_qpl_deflate = 1;
+SET enable_qpl_deflate_codec = 1;
 
 -- copy-paste for storage log
 
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
index 88d274d9cba..276747f8233 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
@@ -1,4 +1,4 @@
-1	hello	2018-12-14	1.1	aaa	5	qpl11	11
-2	world	2018-12-15	2.2	bbb	6	qpl22	22
-3	!	2018-12-16	3.3	ccc	7	qpl33	33
+1	hello	2018-12-14	2018-12-14	1.1	aaa	5	[1,2,3]	{'k1':1,'k2':2}	(1,2)
+2	world	2018-12-15	2018-12-15	2.2	bbb	6	[4,5,6]	{'k3':3,'k4':4}	(3,4)
+3	!	2018-12-16	2018-12-16	3.3	ccc	7	[7,8,9]	{'k5':5,'k6':6}	(5,6)
 2
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index fe23e49804d..64e66d47522 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -1,5 +1,5 @@
 SET send_logs_level = 'fatal';
-SET enable_qpl_deflate = 1;
+SET enable_qpl_deflate_codec = 1;
 
 DROP TABLE IF EXISTS compression_codec;
 
@@ -7,22 +7,24 @@ CREATE TABLE compression_codec(
     id UInt64 CODEC(DEFLATE_QPL),
     data String CODEC(DEFLATE_QPL),
     ddd Date CODEC(DEFLATE_QPL),
+    ddd32 Date32 CODEC(DEFLATE_QPL),
     somenum Float64 CODEC(DEFLATE_QPL),
     somestr FixedString(3) CODEC(DEFLATE_QPL),
     othernum Int64 CODEC(DEFLATE_QPL),
-    qplstr String CODEC(DEFLATE_QPL),
-    qplnum UInt32 CODEC(DEFLATE_QPL),
+    somearray Array(UInt8) CODEC(DEFLATE_QPL),
+    somemap Map(String, UInt32) CODEC(DEFLATE_QPL),
+    sometuple Tuple(UInt16, UInt64) CODEC(DEFLATE_QPL),
 ) ENGINE = MergeTree() ORDER BY tuple();
 
-INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
-INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6,'qpl22', 22);
-INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
+INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), toDate32('2018-12-14'), 1.1, 'aaa', 5, [1,2,3], map('k1',1,'k2',2), tuple(1,2));
+INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), toDate32('2018-12-15'), 2.2, 'bbb', 6, [4,5,6], map('k3',3,'k4',4), tuple(3,4));
+INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), toDate32('2018-12-16'), 3.3, 'ccc', 7, [7,8,9], map('k5',5,'k6',6), tuple(5,6));
 
 SELECT * FROM compression_codec ORDER BY id;
 
 OPTIMIZE TABLE compression_codec FINAL;
 
-INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
+INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), toDate32('2018-12-13'), 4.4, 'ddd', 8, [10,11,12], map('k7',7,'k8',8), tuple(7,8));
 
 DETACH TABLE compression_codec;
 ATTACH TABLE compression_codec;
diff --git a/tests/queries/0_stateless/00804_test_delta_codec_compression.reference b/tests/queries/0_stateless/00804_test_delta_codec_compression.reference
index 37f9d4901b3..949d37ed27a 100644
--- a/tests/queries/0_stateless/00804_test_delta_codec_compression.reference
+++ b/tests/queries/0_stateless/00804_test_delta_codec_compression.reference
@@ -4,5 +4,3 @@
 1
 32
 1
-17
-1
diff --git a/tests/queries/0_stateless/00804_test_delta_codec_compression.sql b/tests/queries/0_stateless/00804_test_delta_codec_compression.sql
index f9805246662..25988f6474b 100644
--- a/tests/queries/0_stateless/00804_test_delta_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_delta_codec_compression.sql
@@ -115,41 +115,3 @@ USING(key);
 
 DROP TABLE IF EXISTS delta_codec_string;
 DROP TABLE IF EXISTS default_codec_string;
-
-SET enable_qpl_deflate = 1;
-DROP TABLE IF EXISTS delta_codec_string_qpl;
-DROP TABLE IF EXISTS default_codec_string_qpl;
-
-CREATE TABLE delta_codec_string_qpl
-(
-    id Float64 Codec(Delta, DEFLATE_QPL)
-) ENGINE MergeTree() ORDER BY tuple() SETTINGS min_bytes_for_wide_part = 0, compress_marks = false, compress_primary_key=false;
-
-CREATE TABLE default_codec_string_qpl
-(
-    id Float64 Codec(DEFLATE_QPL)
-) ENGINE MergeTree() ORDER BY tuple() SETTINGS min_bytes_for_wide_part = 0, compress_marks = false, compress_primary_key=false;
-
-INSERT INTO delta_codec_string_qpl SELECT concat(toString(number), toString(number % 100)) FROM numbers(1547510400, 500000);
-INSERT INTO default_codec_string_qpl SELECT * from delta_codec_string_qpl;
-
-OPTIMIZE TABLE delta_codec_string_qpl FINAL;
-OPTIMIZE TABLE default_codec_string_qpl FINAL;
-
-SELECT
-    floor(big_size / small_size) as ratio
-FROM
-    (SELECT 1 AS key, sum(bytes_on_disk) AS small_size FROM system.parts WHERE database = currentDatabase() and table = 'delta_codec_string_qpl' and active)
-INNER JOIN
-    (SELECT 1 AS key, sum(bytes_on_disk) as big_size FROM system.parts WHERE database = currentDatabase() and table = 'default_codec_string_qpl' and active) USING(key);
-
-SELECT
-    small_hash == big_hash
-FROM
-    (SELECT 1 AS key, sum(cityHash64(*)) AS small_hash FROM delta_codec_string_qpl)
-INNER JOIN
-    (SELECT 1 AS key, sum(cityHash64(*)) AS big_hash FROM default_codec_string_qpl)
-USING(key);
-
-DROP TABLE IF EXISTS delta_codec_string_qpl;
-DROP TABLE IF EXISTS default_codec_string_qpl;

From aae281eb7df6ce8e00d872d3ef0d0558781a5f1a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 1 Jun 2023 15:49:52 +0200
Subject: [PATCH 286/722] Update codecs_float_insert.xml

---
 tests/performance/codecs_float_insert.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/performance/codecs_float_insert.xml b/tests/performance/codecs_float_insert.xml
index be0935ad4cf..64325d30189 100644
--- a/tests/performance/codecs_float_insert.xml
+++ b/tests/performance/codecs_float_insert.xml
@@ -1,7 +1,6 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>

From dc93b6324ee505228b96791db629b7437f6db931 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 1 Jun 2023 15:50:28 +0200
Subject: [PATCH 287/722] Update codecs_float_select.xml

---
 tests/performance/codecs_float_select.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/performance/codecs_float_select.xml b/tests/performance/codecs_float_select.xml
index 844ab4508d8..325c140d9a0 100644
--- a/tests/performance/codecs_float_select.xml
+++ b/tests/performance/codecs_float_select.xml
@@ -1,7 +1,6 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>

From 7043db669e4e445764d99cd749cfef99d3f437cf Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 1 Jun 2023 15:50:40 +0200
Subject: [PATCH 288/722] Update codecs_int_insert.xml

---
 tests/performance/codecs_int_insert.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/performance/codecs_int_insert.xml b/tests/performance/codecs_int_insert.xml
index d5f12810118..618e20160f8 100644
--- a/tests/performance/codecs_int_insert.xml
+++ b/tests/performance/codecs_int_insert.xml
@@ -1,7 +1,6 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>

From 4d7364af97893c4457a86a064628ff478d900c05 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 1 Jun 2023 15:50:49 +0200
Subject: [PATCH 289/722] Update codecs_int_select.xml

---
 tests/performance/codecs_int_select.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/performance/codecs_int_select.xml b/tests/performance/codecs_int_select.xml
index 06b2c2a73f3..62c1ee16e7b 100644
--- a/tests/performance/codecs_int_select.xml
+++ b/tests/performance/codecs_int_select.xml
@@ -1,7 +1,6 @@
 <test>
     <settings>
         <allow_suspicious_codecs>1</allow_suspicious_codecs>
-        <enable_deflate_qpl>1</enable_deflate_qpl>
     </settings>
 
     <substitutions>

From 1f928f2d3d0eea55ff1743cea386162fd87fed92 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 1 Jun 2023 15:53:48 +0200
Subject: [PATCH 290/722] Update StorageSystemBuildOptions.cpp.in

---
 src/Storages/System/StorageSystemBuildOptions.cpp.in | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/System/StorageSystemBuildOptions.cpp.in b/src/Storages/System/StorageSystemBuildOptions.cpp.in
index c2a188e7750..c2d35c96ce5 100644
--- a/src/Storages/System/StorageSystemBuildOptions.cpp.in
+++ b/src/Storages/System/StorageSystemBuildOptions.cpp.in
@@ -64,11 +64,11 @@ const char * auto_config_build[]
     "USE_ARROW", "@USE_ARROW@",
     "USE_ORC", "@USE_ORC@",
     "USE_MSGPACK", "@USE_MSGPACK@",
+    "USE_QPL", "@ENABLE_QPL@",
     "GIT_HASH", "@GIT_HASH@",
     "GIT_BRANCH", R"IRjaNsZIL9Yh7FQ4(@GIT_BRANCH@)IRjaNsZIL9Yh7FQ4",
     "GIT_DATE", "@GIT_DATE@",
     "GIT_COMMIT_SUBJECT", R"Gi17KJMlbGCjErEN(@GIT_COMMIT_SUBJECT@)Gi17KJMlbGCjErEN",
-    "USE_QPL", "@ENABLE_QPL@",
 
     nullptr, nullptr
 };

From 1aa158909e434438733504d2dbcd9ea9d113e41b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 9 Jun 2023 12:38:38 +0000
Subject: [PATCH 291/722] enable_qpl_deflate_codec --> enable_deflate_qpl_codec

---
 docs/en/sql-reference/statements/create/table.md     |  2 +-
 src/Client/Connection.cpp                            |  2 +-
 src/Compression/CompressionFactory.h                 |  4 ++--
 src/Compression/CompressionFactoryAdditions.cpp      | 12 ++++++------
 src/Core/Settings.h                                  |  2 +-
 src/Interpreters/InterpreterCreateQuery.cpp          |  4 ++--
 src/Server/TCPHandler.cpp                            |  2 +-
 src/Storages/AlterCommands.cpp                       |  4 ++--
 src/Storages/Distributed/DistributedSink.cpp         |  2 +-
 src/Storages/TTLDescription.cpp                      |  2 +-
 tests/ci/stress.py                                   |  2 +-
 .../configs/enable_deflateqpl_codec.xml              |  2 +-
 .../00804_test_alter_compression_codecs.sql          |  2 +-
 .../00804_test_custom_compression_codecs.sql         |  2 +-
 ...04_test_custom_compression_codes_log_storages.sql |  2 +-
 .../00804_test_deflate_qpl_codec_compression.sql     |  2 +-
 16 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/docs/en/sql-reference/statements/create/table.md b/docs/en/sql-reference/statements/create/table.md
index d0e17410791..496ecdbda7b 100644
--- a/docs/en/sql-reference/statements/create/table.md
+++ b/docs/en/sql-reference/statements/create/table.md
@@ -380,7 +380,7 @@ High compression levels are useful for asymmetric scenarios, like compress once,
 
 `DEFLATE_QPL` — [Deflate compression algorithm](https://github.com/intel/qpl) implemented by Intel® Query Processing Library. Some limitations apply:
 
-- DEFLATE_QPL is disabled by default and can only be used after setting configuration parameter `enable_qpl_deflate_codec=1`.
+- DEFLATE_QPL is disabled by default and can only be used after setting configuration parameter `enable_deflate_qpl_codec = 1`.
 - DEFLATE_QPL requires a ClickHouse build compiled with SSE 4.2 instructions (by default, this is the case). Refer to [Build Clickhouse with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Build-Clickhouse-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL works best if the system has a Intel® IAA (In-Memory Analytics Accelerator) offloading device. Refer to [Accelerator Configuration](https://intel.github.io/qpl/documentation/get_started_docs/installation.html#accelerator-configuration) and [Benchmark with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Run-Benchmark-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL-compressed data can only be transferred between ClickHouse nodes compiled with SSE 4.2 enabled.
diff --git a/src/Client/Connection.cpp b/src/Client/Connection.cpp
index ac8e6654e84..636532ade4b 100644
--- a/src/Client/Connection.cpp
+++ b/src/Client/Connection.cpp
@@ -588,7 +588,7 @@ void Connection::sendQuery(
         if (method == "ZSTD")
             level = settings->network_zstd_compression_level;
 
-        CompressionCodecFactory::instance().validateCodec(method, level, !settings->allow_suspicious_codecs, settings->allow_experimental_codecs, settings->enable_qpl_deflate_codec);
+        CompressionCodecFactory::instance().validateCodec(method, level, !settings->allow_suspicious_codecs, settings->allow_experimental_codecs, settings->enable_deflate_qpl_codec);
         compression_codec = CompressionCodecFactory::instance().get(method, level);
     }
     else
diff --git a/src/Compression/CompressionFactory.h b/src/Compression/CompressionFactory.h
index e020e51bb09..4f2627587a3 100644
--- a/src/Compression/CompressionFactory.h
+++ b/src/Compression/CompressionFactory.h
@@ -40,10 +40,10 @@ public:
     CompressionCodecPtr getDefaultCodec() const;
 
     /// Validate codecs AST specified by user and parses codecs description (substitute default parameters)
-    ASTPtr validateCodecAndGetPreprocessedAST(const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const;
+    ASTPtr validateCodecAndGetPreprocessedAST(const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_deflate_qpl_codec) const;
 
     /// Validate codecs AST specified by user
-    void validateCodec(const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const;
+    void validateCodec(const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_deflate_qpl_codec) const;
 
     /// Get codec by AST and possible column_type. Some codecs can use
     /// information about type to improve inner settings, but every codec should
diff --git a/src/Compression/CompressionFactoryAdditions.cpp b/src/Compression/CompressionFactoryAdditions.cpp
index b4a2d96cf39..46f7e2653c2 100644
--- a/src/Compression/CompressionFactoryAdditions.cpp
+++ b/src/Compression/CompressionFactoryAdditions.cpp
@@ -34,7 +34,7 @@ namespace ErrorCodes
 
 
 void CompressionCodecFactory::validateCodec(
-    const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const
+    const String & family_name, std::optional<int> level, bool sanity_check, bool allow_experimental_codecs, bool enable_deflate_qpl_codec) const
 {
     if (family_name.empty())
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Compression codec name cannot be empty");
@@ -43,13 +43,13 @@ void CompressionCodecFactory::validateCodec(
     {
         auto literal = std::make_shared<ASTLiteral>(static_cast<UInt64>(*level));
         validateCodecAndGetPreprocessedAST(makeASTFunction("CODEC", makeASTFunction(Poco::toUpper(family_name), literal)),
-            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate_codec);
+            {}, sanity_check, allow_experimental_codecs, enable_deflate_qpl_codec);
     }
     else
     {
         auto identifier = std::make_shared<ASTIdentifier>(Poco::toUpper(family_name));
         validateCodecAndGetPreprocessedAST(makeASTFunction("CODEC", identifier),
-            {}, sanity_check, allow_experimental_codecs, enable_qpl_deflate_codec);
+            {}, sanity_check, allow_experimental_codecs, enable_deflate_qpl_codec);
     }
 }
 
@@ -77,7 +77,7 @@ bool innerDataTypeIsFloat(const DataTypePtr & type)
 }
 
 ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
-    const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_qpl_deflate_codec) const
+    const ASTPtr & ast, const DataTypePtr & column_type, bool sanity_check, bool allow_experimental_codecs, bool enable_deflate_qpl_codec) const
 {
     if (const auto * func = ast->as<ASTFunction>())
     {
@@ -159,10 +159,10 @@ ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
                         " You can enable it with the 'allow_experimental_codecs' setting.",
                         codec_family_name);
 
-                if (!enable_qpl_deflate_codec && result_codec->isDeflateQplCompression())
+                if (!enable_deflate_qpl_codec && result_codec->isDeflateQplCompression())
                     throw Exception(ErrorCodes::BAD_ARGUMENTS,
                         "Codec {} is disabled by default."
-                        " You can enable it with the 'enable_qpl_deflate_codec' setting.",
+                        " You can enable it with the 'enable_deflate_qpl_codec' setting.",
                         codec_family_name);
 
                 codecs_descriptions->children.emplace_back(result_codec->getCodecDesc());
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 4aae8f5d572..e0034174597 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -319,7 +319,7 @@ class IColumn;
     M(Bool, allow_distributed_ddl, true, "If it is set to true, then a user is allowed to executed distributed DDL queries.", 0) \
     M(Bool, allow_suspicious_codecs, false, "If it is set to true, allow to specify meaningless compression codecs.", 0) \
     M(Bool, allow_experimental_codecs, false, "If it is set to true, allow to specify experimental compression codecs (but we don't have those yet and this option does nothing).", 0) \
-    M(Bool, enable_qpl_deflate_codec, false, "If it is set to true, allow usage of the DEFLATE_QPL codec.", 0) \
+    M(Bool, enable_deflate_qpl_codec, false, "Enable/disable the DEFLATE_QPL codec.", 0) \
     M(UInt64, query_profiler_real_time_period_ns, QUERY_PROFILER_DEFAULT_SAMPLE_RATE_NS, "Period for real clock timer of query profiler (in nanoseconds). Set 0 value to turn off the real clock query profiler. Recommended value is at least 10000000 (100 times a second) for single queries or 1000000000 (once a second) for cluster-wide profiling.", 0) \
     M(UInt64, query_profiler_cpu_time_period_ns, QUERY_PROFILER_DEFAULT_SAMPLE_RATE_NS, "Period for CPU clock timer of query profiler (in nanoseconds). Set 0 value to turn off the CPU clock query profiler. Recommended value is at least 10000000 (100 times a second) for single queries or 1000000000 (once a second) for cluster-wide profiling.", 0) \
     M(Bool, metrics_perf_events_enabled, false, "If enabled, some of the perf events will be measured throughout queries' execution.", 0) \
diff --git a/src/Interpreters/InterpreterCreateQuery.cpp b/src/Interpreters/InterpreterCreateQuery.cpp
index ddb53bbbfaa..d0bb3dd389f 100644
--- a/src/Interpreters/InterpreterCreateQuery.cpp
+++ b/src/Interpreters/InterpreterCreateQuery.cpp
@@ -571,7 +571,7 @@ ColumnsDescription InterpreterCreateQuery::getColumnsDescription(
 
     bool sanity_check_compression_codecs = !attach && !context_->getSettingsRef().allow_suspicious_codecs;
     bool allow_experimental_codecs = attach || context_->getSettingsRef().allow_experimental_codecs;
-    bool enable_qpl_deflate_codec = attach || context_->getSettingsRef().enable_qpl_deflate_codec;
+    bool enable_deflate_qpl_codec = attach || context_->getSettingsRef().enable_deflate_qpl_codec;
 
     ColumnsDescription res;
     auto name_type_it = column_names_and_types.begin();
@@ -632,7 +632,7 @@ ColumnsDescription InterpreterCreateQuery::getColumnsDescription(
             if (col_decl.default_specifier == "ALIAS")
                 throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cannot specify codec for column type ALIAS");
             column.codec = CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(
-                col_decl.codec, column.type, sanity_check_compression_codecs, allow_experimental_codecs, enable_qpl_deflate_codec);
+                col_decl.codec, column.type, sanity_check_compression_codecs, allow_experimental_codecs, enable_deflate_qpl_codec);
         }
 
         if (col_decl.ttl)
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index b43fef9dd54..50e9d50e2f6 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -1775,7 +1775,7 @@ void TCPHandler::initBlockOutput(const Block & block)
 
             if (state.compression == Protocol::Compression::Enable)
             {
-                CompressionCodecFactory::instance().validateCodec(method, level, !query_settings.allow_suspicious_codecs, query_settings.allow_experimental_codecs, query_settings.enable_qpl_deflate_codec);
+                CompressionCodecFactory::instance().validateCodec(method, level, !query_settings.allow_suspicious_codecs, query_settings.allow_experimental_codecs, query_settings.enable_deflate_qpl_codec);
 
                 state.maybe_compressed_out = std::make_shared<CompressedWriteBuffer>(
                     *out, CompressionCodecFactory::instance().get(method, level));
diff --git a/src/Storages/AlterCommands.cpp b/src/Storages/AlterCommands.cpp
index 73d7be8dc56..a9247f9b898 100644
--- a/src/Storages/AlterCommands.cpp
+++ b/src/Storages/AlterCommands.cpp
@@ -1067,7 +1067,7 @@ void AlterCommands::validate(const StoragePtr & table, ContextPtr context) const
                                 "this column name is reserved for lightweight delete feature", backQuote(column_name));
 
             if (command.codec)
-                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate_codec);
+                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_deflate_qpl_codec);
 
             all_columns.add(ColumnDescription(column_name, command.data_type));
         }
@@ -1093,7 +1093,7 @@ void AlterCommands::validate(const StoragePtr & table, ContextPtr context) const
             {
                 if (all_columns.hasAlias(column_name))
                     throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cannot specify codec for column type ALIAS");
-                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate_codec);
+                CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(command.codec, command.data_type, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_deflate_qpl_codec);
             }
             auto column_default = all_columns.getDefault(column_name);
             if (column_default)
diff --git a/src/Storages/Distributed/DistributedSink.cpp b/src/Storages/Distributed/DistributedSink.cpp
index e383890d1f7..1e1c911920e 100644
--- a/src/Storages/Distributed/DistributedSink.cpp
+++ b/src/Storages/Distributed/DistributedSink.cpp
@@ -733,7 +733,7 @@ void DistributedSink::writeToShard(const Cluster::ShardInfo & shard_info, const
     if (compression_method == "ZSTD")
         compression_level = settings.network_zstd_compression_level;
 
-    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enable_qpl_deflate_codec);
+    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enale_deflate_qpl_codec);
     CompressionCodecPtr compression_codec = CompressionCodecFactory::instance().get(compression_method, compression_level);
 
     /// tmp directory is used to ensure atomicity of transactions
diff --git a/src/Storages/TTLDescription.cpp b/src/Storages/TTLDescription.cpp
index a437465b3fe..f601fed06ac 100644
--- a/src/Storages/TTLDescription.cpp
+++ b/src/Storages/TTLDescription.cpp
@@ -285,7 +285,7 @@ TTLDescription TTLDescription::getTTLFromAST(
         {
             result.recompression_codec =
                 CompressionCodecFactory::instance().validateCodecAndGetPreprocessedAST(
-                    ttl_element->recompression_codec, {}, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_qpl_deflate_codec);
+                    ttl_element->recompression_codec, {}, !context->getSettingsRef().allow_suspicious_codecs, context->getSettingsRef().allow_experimental_codecs, context->getSettingsRef().enable_deflate_qpl_codec);
         }
     }
 
diff --git a/tests/ci/stress.py b/tests/ci/stress.py
index e5ceb251d0f..6d17384c63f 100755
--- a/tests/ci/stress.py
+++ b/tests/ci/stress.py
@@ -20,7 +20,7 @@ def get_options(i, upgrade_check):
             '''--db-engine="Replicated('/test/db/test_{}', 's1', 'r1')"'''.format(i)
         )
         client_options.append("allow_experimental_database_replicated=1")
-        client_options.append("enable_qpl_deflate_codec=1")
+        client_options.append("enable_deflate_qpl_codec=1")
 
     # If database name is not specified, new database is created for each functional test.
     # Run some threads with one database for all tests.
diff --git a/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml b/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
index 521b0fd663c..24e101e0e3f 100644
--- a/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
+++ b/tests/integration/test_non_default_compression/configs/enable_deflateqpl_codec.xml
@@ -1,7 +1,7 @@
 <clickhouse>
     <profiles>
         <default>
-            <enable_qpl_deflate_codec>1</enable_qpl_deflate_codec>
+            <enable_deflate_qpl_codec>1</enable_deflate_qpl_codec>
         </default>
     </profiles>
 </clickhouse>
diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
index 5b8b73270a2..fd9855e82d3 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
@@ -28,7 +28,7 @@ SELECT * FROM alter_compression_codec ORDER BY id;
 OPTIMIZE TABLE alter_compression_codec FINAL;
 SELECT * FROM alter_compression_codec ORDER BY id;
 
-SET enable_qpl_deflate_codec = 1;
+SET enable_deflate_qpl_codec = 1;
 ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(DEFLATE_QPL);
 SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
 
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
index 47ec268bfec..89e77f758a7 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
@@ -1,6 +1,6 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
-SET enable_qpl_deflate_codec = 1;
+SET enable_deflate_qpl_codec = 1;
 
 DROP TABLE IF EXISTS compression_codec;
 
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
index bcd09277824..a629df2666d 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
@@ -1,6 +1,6 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
-SET enable_qpl_deflate_codec = 1;
+SET enable_deflate_qpl_codec = 1;
 
 -- copy-paste for storage log
 
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index 64e66d47522..5a56fc0d576 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -1,5 +1,5 @@
 SET send_logs_level = 'fatal';
-SET enable_qpl_deflate_codec = 1;
+SET enable_deflate_qpl_codec = 1;
 
 DROP TABLE IF EXISTS compression_codec;
 

From 3c1b02a37bfa349fbf3af86277c9ad3ae0eadc1c Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 9 Jun 2023 15:43:36 +0300
Subject: [PATCH 292/722] Rectify the existing example of the year omission

---
 .../sql-reference/functions/type-conversion-functions.md  | 8 ++++----
 .../sql-reference/functions/type-conversion-functions.md  | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index e62cf89a6b2..f1e2785285c 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -1417,15 +1417,15 @@ Result:
 Query:
 
 ``` sql
-SELECT parseDateTimeBestEffort('10 20:19');
+SELECT toYear(now()) as year, parseDateTimeBestEffort('10 20:19');
 ```
 
 Result:
 
 ```response
-┌─parseDateTimeBestEffort('10 20:19')─┐
-│                 2000-01-10 20:19:00 │
-└─────────────────────────────────────┘
+┌─year─┬─parseDateTimeBestEffort('10 20:19')─┐
+│ 2023 │                 2023-01-10 20:19:00 │
+└──────┴─────────────────────────────────────┘
 ```
 
 **See Also**
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index 6de55757b64..b763ee2b3ac 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -1096,15 +1096,15 @@ AS parseDateTimeBestEffort;
 Запрос:
 
 ``` sql
-SELECT parseDateTimeBestEffort('10 20:19');
+SELECT toYear(now()) as year, parseDateTimeBestEffort('10 20:19');
 ```
 
 Результат:
 
 ``` text
-┌─parseDateTimeBestEffort('10 20:19')─┐
-│                 2000-01-10 20:19:00 │
-└─────────────────────────────────────┘
+┌─year─┬─parseDateTimeBestEffort('10 20:19')─┐
+│ 2023 │                 2023-01-10 20:19:00 │
+└──────┴─────────────────────────────────────┘
 ```
 
 **Смотрите также**

From 47b0c2a862c282b642a81ce0f0287c5059d717dc Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 9 Jun 2023 13:01:36 +0000
Subject: [PATCH 293/722] Make better

---
 src/Formats/CapnProtoSerializer.cpp           | 117 +++++++++++++-----
 .../0_stateless/02030_capnp_format.reference  |  11 ++
 .../queries/0_stateless/02030_capnp_format.sh |  13 +-
 ...case_insensitive_names_matching.reference} |   0
 ..._capnp_case_insensitive_names_matching.sh} |   0
 5 files changed, 110 insertions(+), 31 deletions(-)
 rename tests/queries/0_stateless/{02735_capnp_case_insensitive_names_matcing.reference => 02735_capnp_case_insensitive_names_matching.reference} (100%)
 rename tests/queries/0_stateless/{02735_capnp_case_insensitive_names_matcing.sh => 02735_capnp_case_insensitive_names_matching.sh} (100%)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index e99db23bb5e..f51f8c4b933 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -110,7 +110,7 @@ namespace
         /// Write row as struct field.
         virtual void writeRow(
             const ColumnPtr & column,
-            std::unique_ptr<FieldBuilder> & builder,
+            std::unique_ptr<FieldBuilder> & builder, /// Maybe unused for simple types, needed to initialize structs and lists.
             capnp::DynamicStruct::Builder & parent_struct_builder,
             UInt32 slot_offset,
             size_t row_num) = 0;
@@ -118,7 +118,7 @@ namespace
         /// Write row as list element.
         virtual void writeRow(
             const ColumnPtr & column,
-            std::unique_ptr<FieldBuilder> & builder,
+            std::unique_ptr<FieldBuilder> & builder, /// Maybe unused for simple types, needed to initialize structs and lists.
             capnp::DynamicList::Builder & parent_list_builder,
             UInt32 array_index,
             size_t row_num) = 0;
@@ -262,54 +262,93 @@ namespace
             if (!capnp_type.isEnum())
                 throwCannotConvert(data_type, column_name, capnp_type);
 
-            bool to_lower = enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE;
             const auto * enum_type = assert_cast<const DataTypeEnum<EnumType> *>(data_type.get());
             const auto & enum_values = dynamic_cast<const EnumValues<EnumType> &>(*enum_type);
 
             enum_schema = capnp_type.asEnum();
             auto enumerants = enum_schema.getEnumerants();
-            constexpr auto max_value = std::is_same_v<EnumType, Int8> ? INT8_MAX : INT16_MAX;
             if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
             {
-                /// In CapnProto Enum fields are numbered sequentially starting from zero.
-                if (enumerants.size() > max_value)
-                    throw Exception(
-                        ErrorCodes::CAPN_PROTO_BAD_CAST,
-                        "Enum from CapnProto schema contains values that are out of range for Clickhouse enum type {}",
-                        data_type->getName());
-
-                auto values = enum_values.getSetOfAllValues();
-                std::unordered_set<EnumType> capn_enum_values;
+                auto ch_enum_values = enum_values.getSetOfAllValues();
+                std::unordered_set<UInt16> capn_enum_values;
                 for (auto enumerant : enumerants)
-                    capn_enum_values.insert(EnumType(enumerant.getOrdinal()));
-                if (values != capn_enum_values)
-                    throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "The set of values in Enum from CapnProto schema is different from the set of values in ClickHouse Enum");
+                    capn_enum_values.insert(enumerant.getOrdinal());
+
+                /// Check if ClickHouse values is a superset of CapnProto values.
+                ch_enum_is_superset = true;
+                /// In CapnProto Enum fields are numbered sequentially starting from zero.
+                /// Check if max CapnProto value exceeds max ClickHouse value.
+                constexpr auto max_value = std::is_same_v<EnumType, Int8> ? INT8_MAX : INT16_MAX;
+                if (enumerants.size() > max_value)
+                {
+                    ch_enum_is_superset = false;
+                }
+                else
+                {
+                    for (auto capnp_value : capn_enum_values)
+                    {
+                        if (!ch_enum_values.contains(static_cast<EnumType>(capnp_value)))
+                        {
+                            ch_enum_is_superset = false;
+                            break;
+                        }
+                    }
+                }
+
+                /// Check if CapnProto values is a superset of ClickHouse values.
+                capnp_enum_is_superset = true;
+                for (auto ch_value : ch_enum_values)
+                {
+                    /// Capnp doesn't support negative enum values.
+                    if (ch_value < 0 || !capn_enum_values.contains(static_cast<UInt16>(ch_value)))
+                    {
+                        capnp_enum_is_superset = false;
+                        break;
+                    }
+                }
             }
             else
             {
-                auto all_values = enum_values.getValues();
-                if (all_values.size() != enumerants.size())
-                    throw Exception(
-                        ErrorCodes::CAPN_PROTO_BAD_CAST,
-                        "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum");
+                bool to_lower = enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE;
 
+                auto all_values = enum_values.getValues();
                 std::unordered_map<String, EnumType> ch_name_to_value;
                 for (auto & [name, value] : all_values)
                     ch_name_to_value[to_lower ? boost::algorithm::to_lower_copy(name) : name] = value;
 
+                std::unordered_map<String, UInt16> capnp_name_to_value;
                 for (auto enumerant : enumerants)
                 {
                     String capnp_name = enumerant.getProto().getName();
-                    UInt16 capnp_value = enumerant.getOrdinal();
-                    auto it = ch_name_to_value.find(to_lower ? boost::algorithm::to_lower_copy(capnp_name) : capnp_name);
-                    if (it == ch_name_to_value.end())
-                        throw Exception(
-                            ErrorCodes::CAPN_PROTO_BAD_CAST,
-                            "The set of names in Enum from CapnProto schema is different from the set of names in ClickHouse Enum");
+                    capnp_name_to_value[to_lower ? boost::algorithm::to_lower_copy(capnp_name) : capnp_name] = enumerant.getOrdinal();
+                }
 
-                    ch_to_capnp_values[it->second] = capnp_value;
+                /// Check if ClickHouse names is a superset of CapnProto names.
+                ch_enum_is_superset = true;
+                for (auto & [capnp_name, capnp_value] : capnp_name_to_value)
+                {
+                    auto it = ch_name_to_value.find(capnp_name);
+                    if (it == ch_name_to_value.end())
+                    {
+                        ch_enum_is_superset = false;
+                        break;
+                    }
                     capnp_to_ch_values[capnp_value] = it->second;
                 }
+
+                /// Check if CapnProto names is a superset of ClickHouse names.
+                capnp_enum_is_superset = true;
+
+                for (auto & [ch_name, ch_value] : ch_name_to_value)
+                {
+                    auto it = capnp_name_to_value.find(ch_name);
+                    if (it == capnp_name_to_value.end())
+                    {
+                        capnp_enum_is_superset = false;
+                        break;
+                    }
+                    ch_to_capnp_values[ch_value] = it->second;
+                }
             }
         }
 
@@ -336,23 +375,43 @@ namespace
     private:
         UInt16 getValue(const ColumnPtr & column, size_t row_num)
         {
+            if (!capnp_enum_is_superset)
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Cannot convert ClickHouse enum to CapnProto enum: CapnProto enum values/names is not a superset of ClickHouse enum values/names");
+
             EnumType enum_value = assert_cast<const ColumnVector<EnumType> &>(*column).getElement(row_num);
             if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
                 return static_cast<UInt16>(enum_value);
-            return ch_to_capnp_values[enum_value];
+            auto it = ch_to_capnp_values.find(enum_value);
+            if (it == ch_to_capnp_values.end())
+                throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected value {} in ClickHouse enum", enum_value);
+
+            return it->second;
         }
 
         void insertValue(IColumn & column, UInt16 capnp_enum_value)
         {
+            if (!ch_enum_is_superset)
+                throw Exception(ErrorCodes::CAPN_PROTO_BAD_CAST, "Cannot convert CapnProto enum to ClickHouse enum: ClickHouse enum values/names is not a superset of CapnProto enum values/names");
+
             if (enum_comparing_mode == FormatSettings::CapnProtoEnumComparingMode::BY_VALUES)
+            {
                 assert_cast<ColumnVector<EnumType> &>(column).insertValue(static_cast<EnumType>(capnp_enum_value));
+            }
             else
+            {
+                auto it = capnp_to_ch_values.find(capnp_enum_value);
+                if (it == capnp_to_ch_values.end())
+                    throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected value {} in CapnProto enum", capnp_enum_value);
+
                 assert_cast<ColumnVector<EnumType> &>(column).insertValue(capnp_to_ch_values[capnp_enum_value]);
+            }
         }
 
         DataTypePtr data_type;
         capnp::EnumSchema enum_schema;
         const FormatSettings::CapnProtoEnumComparingMode enum_comparing_mode;
+        bool ch_enum_is_superset;
+        bool capnp_enum_is_superset;
         std::unordered_map<EnumType, UInt16> ch_to_capnp_values;
         std::unordered_map<UInt16, EnumType> capnp_to_ch_values;
     };
diff --git a/tests/queries/0_stateless/02030_capnp_format.reference b/tests/queries/0_stateless/02030_capnp_format.reference
index 2b2307bfc6a..e08b1eb1271 100644
--- a/tests/queries/0_stateless/02030_capnp_format.reference
+++ b/tests/queries/0_stateless/02030_capnp_format.reference
@@ -12,6 +12,9 @@
 \N	[NULL,NULL,42]	(NULL)
 1	[1,NULL,2]	(1)
 \N	[NULL,NULL,42]	(NULL)
+OK
+OK
+OK
 one
 two
 tHrEe
@@ -21,6 +24,14 @@ threE
 first
 second
 third
+first
+second
+third
+OK
+one
+two
+tHrEe
+OK
 OK
 OK
 OK
diff --git a/tests/queries/0_stateless/02030_capnp_format.sh b/tests/queries/0_stateless/02030_capnp_format.sh
index 625104fb590..b4484ca3766 100755
--- a/tests/queries/0_stateless/02030_capnp_format.sh
+++ b/tests/queries/0_stateless/02030_capnp_format.sh
@@ -71,16 +71,25 @@ $CLICKHOUSE_CLIENT --query="DROP TABLE capnp_nullable"
 
 
 $CLICKHOUSE_CLIENT --query="SELECT CAST(number, 'Enum(\'one\' = 0, \'two\' = 1, \'tHrEe\' = 2)') AS value FROM numbers(3) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_enum:Message'" > $CAPN_PROTO_FILE
+$CLICKHOUSE_CLIENT --query="SELECT CAST(number % 2, 'Enum(\'one\' = 0, \'two\' = 1, \'tHrEe\' = 2, \'four\' = 4)') AS value FROM numbers(3) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT CAST(number % 2, 'Enum(\'one\' = 0, \'two\' = 1, \'tHrEe\' = 2, \'four\' = 4)') AS value FROM numbers(3) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names_case_insensitive'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT CAST(number % 2, 'Enum(\'one\' = 0, \'two\' = 1, \'tHrEe\' = 2, \'four\' = 4)') AS value FROM numbers(3) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_values'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
 
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'one\' = 1, \'two\' = 2, \'tHrEe\' = 3)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names'"
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'oNe\' = 1, \'tWo\' = 2, \'threE\' = 3)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names_case_insensitive'"
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'first\' = 0, \'second\' = 1, \'third\' = 2)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_values'"
-
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'first\' = 0, \'second\' = 1, \'third\' = 2)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_values'"
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'one\' = 0, \'two\' = 1, \'three\' = 2)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
-$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'one\' = 0, \'two\' = 1, \'tHrEe\' = 2, \'four\' = 3)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'one\' = 0, \'two\' = 1, \'tHrEe\' = 2, \'four\' = 3)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names'"
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'one\' = 1, \'two\' = 2, \'tHrEe\' = 3)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_values'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
 $CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'first\' = 1, \'two\' = 2, \'three\' = 3)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names_case_insensitive'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
 
+$CLICKHOUSE_CLIENT --query="SELECT CAST(number % 2, 'Enum(\'one\' = 0, \'two\' = 1)') AS value FROM numbers(3) FORMAT CapnProto SETTINGS format_schema='$CLIENT_SCHEMADIR/02030_capnp_enum:Message'" > $CAPN_PROTO_FILE
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'first\' = 0, \'two\' = 1)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_values'"  2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'first\' = 0, \'two\' = 1)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names'"  2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+$CLICKHOUSE_CLIENT --query="SELECT * FROM file('data.capnp', 'CapnProto', 'value Enum(\'first\' = 0, \'two\' = 1)') SETTINGS format_schema='$SERVER_SCHEMADIR/02030_capnp_enum:Message', format_capn_proto_enum_comparising_mode='by_names_case_insensitive'" 2>&1 | grep -F -q "CAPN_PROTO_BAD_CAST" && echo 'OK' || echo 'FAIL';
+
+
 $CLICKHOUSE_CLIENT --query="DROP TABLE IF EXISTS capnp_low_cardinality"
 $CLICKHOUSE_CLIENT --query="CREATE TABLE capnp_low_cardinality (lc1 LowCardinality(String), lc2 LowCardinality(Nullable(String)), lc3 Array(LowCardinality(Nullable(String)))) ENGINE=Memory"
 $CLICKHOUSE_CLIENT --query="INSERT INTO capnp_low_cardinality VALUES ('one', 'two', ['one', Null, 'two', Null]), ('two', Null, [Null])"
diff --git a/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matching.reference
similarity index 100%
rename from tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.reference
rename to tests/queries/0_stateless/02735_capnp_case_insensitive_names_matching.reference
diff --git a/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh b/tests/queries/0_stateless/02735_capnp_case_insensitive_names_matching.sh
similarity index 100%
rename from tests/queries/0_stateless/02735_capnp_case_insensitive_names_matcing.sh
rename to tests/queries/0_stateless/02735_capnp_case_insensitive_names_matching.sh

From 9b70836b6c2b7f90ed04c41f90ad9ba3473dbe59 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 9 Jun 2023 16:07:07 +0300
Subject: [PATCH 294/722] Add a syslog format example to the documentation

---
 .../functions/type-conversion-functions.md    | 22 +++++++++++++++++++
 .../functions/type-conversion-functions.md    | 22 +++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index f1e2785285c..9c079bd9515 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -1428,6 +1428,28 @@ Result:
 └──────┴─────────────────────────────────────┘
 ```
 
+Query:
+
+``` sql
+WITH
+    now() AS ts_now,
+    formatDateTime(ts_around, '%b %e %T') AS syslog_arg
+SELECT
+    ts_now,
+    syslog_arg,
+    parseDateTimeBestEffort(syslog_arg)
+FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around);
+```
+
+Result:
+
+```response
+┌──────────────ts_now─┬─syslog_arg──────┬─parseDateTimeBestEffort(syslog_arg)─┐
+│ 2023-06-09 16:04:30 │ Jun  9 16:04:00 │                 2023-06-09 16:04:00 │
+│ 2023-06-09 16:04:30 │ Jun  9 16:05:00 │                 2022-06-09 16:05:00 │
+└─────────────────────┴─────────────────┴─────────────────────────────────────┘
+```
+
 **See Also**
 
 - [RFC 1123](https://datatracker.ietf.org/doc/html/rfc1123)
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index b763ee2b3ac..6e93a5e0acf 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -1107,6 +1107,28 @@ SELECT toYear(now()) as year, parseDateTimeBestEffort('10 20:19');
 └──────┴─────────────────────────────────────┘
 ```
 
+Запрос:
+
+``` sql
+WITH
+    now() AS ts_now,
+    formatDateTime(ts_around, '%b %e %T') AS syslog_arg
+SELECT
+    ts_now,
+    syslog_arg,
+    parseDateTimeBestEffort(syslog_arg)
+FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around);
+```
+
+Результат:
+
+``` text
+┌──────────────ts_now─┬─syslog_arg──────┬─parseDateTimeBestEffort(syslog_arg)─┐
+│ 2023-06-09 16:04:30 │ Jun  9 16:04:00 │                 2023-06-09 16:04:00 │
+│ 2023-06-09 16:04:30 │ Jun  9 16:05:00 │                 2022-06-09 16:05:00 │
+└─────────────────────┴─────────────────┴─────────────────────────────────────┘
+```
+
 **Смотрите также**
 
 -   [Информация о формате ISO 8601 от @xkcd](https://xkcd.com/1179/)

From 5af06f8c08a70298e217d3a8909a5ed8d412f474 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 9 Jun 2023 16:11:52 +0300
Subject: [PATCH 295/722] Amend the test infinitesimally

---
 .../0_stateless/02783_parseDateTimeBestEffort_syslog.reference  | 2 +-
 .../0_stateless/02783_parseDateTimeBestEffort_syslog.sql        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
index 63e7e367941..3ec93143e0e 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
@@ -1,5 +1,5 @@
 parseDateTimeBestEffort
- dt_ref                            res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc                res_us            res_us_sam            res_us_auc           res_us_null       res_us_null_sam       res_us_null_auc           res_us_zero       res_us_zero_sam       res_us_zero_auc                     res64                 res64_sam                 res64_auc                res64_null            res64_null_sam            res64_null_auc                res64_zero            res64_zero_sam            res64_zero_auc                  res64_us              res64_us_sam              res64_us_auc             res64_us_null         res64_us_null_sam         res64_us_null_auc             res64_us_zero         res64_us_zero_sam         res64_us_zero_auc
+ around_June_7                     res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc                res_us            res_us_sam            res_us_auc           res_us_null       res_us_null_sam       res_us_null_auc           res_us_zero       res_us_zero_sam       res_us_zero_auc                     res64                 res64_sam                 res64_auc                res64_null            res64_null_sam            res64_null_auc                res64_zero            res64_zero_sam            res64_zero_auc                  res64_us              res64_us_sam              res64_us_auc             res64_us_null         res64_us_null_sam         res64_us_null_auc             res64_us_zero         res64_us_zero_sam         res64_us_zero_auc
 
  Jun  6 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000 
  Jun  8 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000 
diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
index 59211d3e6a0..52975cb5bbf 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
@@ -7,7 +7,7 @@ WITH
     dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
     formatDateTime(ts_around, '%b %e %T') AS dt_curr
 SELECT
-    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS dt_ref,
+    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS around_June_7,
     parseDateTimeBestEffort(dt_curr) - impedimenta AS res,
     parseDateTimeBestEffort(dt_curr, 'US/Samoa') - impedimenta AS res_sam,
     parseDateTimeBestEffort(dt_curr, 'Pacific/Auckland') - impedimenta AS res_auc,

From f8791a0ea393120dbfba8eec8627edbc8d00deb8 Mon Sep 17 00:00:00 2001
From: Jordi Villar <jrdi.villar@gmail.com>
Date: Fri, 9 Jun 2023 15:36:48 +0200
Subject: [PATCH 296/722] SummingMergeTree support for DateTime64

---
 src/DataTypes/DataTypeDateTime64.h                   |  2 ++
 .../02785_summing_merge_tree_datetime64.reference    |  1 +
 .../02785_summing_merge_tree_datetime64.sql          | 12 ++++++++++++
 3 files changed, 15 insertions(+)
 create mode 100644 tests/queries/0_stateless/02785_summing_merge_tree_datetime64.reference
 create mode 100644 tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql

diff --git a/src/DataTypes/DataTypeDateTime64.h b/src/DataTypes/DataTypeDateTime64.h
index aaa99485040..64cedd798d1 100644
--- a/src/DataTypes/DataTypeDateTime64.h
+++ b/src/DataTypes/DataTypeDateTime64.h
@@ -37,6 +37,8 @@ public:
 
     bool canBeUsedAsVersion() const override { return true; }
 
+    bool isSummable() const override { return false; }
+
 protected:
     SerializationPtr doGetDefaultSerialization() const override;
 };
diff --git a/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.reference b/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.reference
new file mode 100644
index 00000000000..d395c4d6a0f
--- /dev/null
+++ b/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.reference
@@ -0,0 +1 @@
+1	2023-05-01 23:55:55.100	15
diff --git a/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql b/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql
new file mode 100644
index 00000000000..1ed930ebbc7
--- /dev/null
+++ b/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql
@@ -0,0 +1,12 @@
+DROP TABLE IF EXISTS summing_merge_tree_datetime64;
+
+CREATE TABLE summing_merge_tree_datetime64 ( `pk` UInt64, `timestamp` DateTime64(3), `value` UInt64 )
+ENGINE = SummingMergeTree() ORDER BY pk;
+
+INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100' timestamp, 1 value;
+INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100' timestamp, 2 value;
+INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100' timestamp, 3 value;
+INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100' timestamp, 4 value;
+INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100' timestamp, 5 value;
+
+SELECT * FROM summing_merge_tree_datetime64 FINAL;

From 13798f8b07f2550ec73323ce8596a276155aa367 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Fri, 9 Jun 2023 19:52:49 +0300
Subject: [PATCH 297/722] Update MergeTreeData.cpp

---
 src/Storages/MergeTree/MergeTreeData.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 9cca471fddb..23351423d49 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1252,6 +1252,10 @@ MergeTreeData::LoadPartResult MergeTreeData::loadDataPart(
         mark_broken();
         return res;
     }
+    catch (const Poco::TimeoutException &)
+    {
+        throw;
+    }
     catch (...)
     {
         mark_broken();

From a8b579a85618f57f0fd6316d16d28677dfeb0d8b Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Fri, 9 Jun 2023 19:28:06 +0200
Subject: [PATCH 298/722] Rename azure_blob_storage to azureBlobStorage

---
 .../table-functions/azure_blob_storage.md     |  2 +-
 .../TableFunctionAzureBlobStorage.cpp         |  2 +-
 .../TableFunctionAzureBlobStorage.h           |  2 +-
 .../test_storage_azure_blob_storage/test.py   | 22 +++++++++----------
 4 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/docs/en/sql-reference/table-functions/azure_blob_storage.md b/docs/en/sql-reference/table-functions/azure_blob_storage.md
index f86307b3b85..6091aab5f9d 100644
--- a/docs/en/sql-reference/table-functions/azure_blob_storage.md
+++ b/docs/en/sql-reference/table-functions/azure_blob_storage.md
@@ -5,7 +5,7 @@ sidebar_label: azure_blob_storage
 keywords: [azure blob storage]
 ---
 
-# azure\_blob\_storage Table Function
+# azureBlobStorage Table Function
 
 Provides a table-like interface to select/insert files in [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs). This table function is similar to the [s3 function](../../sql-reference/table-functions/s3.md).
 
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
index 38d9362894a..d2a96173491 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.cpp
@@ -246,7 +246,7 @@ void registerTableFunctionAzureBlobStorage(TableFunctionFactory & factory)
     factory.registerFunction<TableFunctionAzureBlobStorage>(
         {.documentation
          = {.description=R"(The table function can be used to read the data stored on Azure Blob Storage.)",
-            .examples{{"azure_blob_storage", "SELECT * FROM  azure_blob_storage(connection, container, blob_path, format, structure)", ""}}},
+            .examples{{"azureBlobStorage", "SELECT * FROM  azureBlobStorage(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])", ""}}},
          .allow_readonly = false});
 }
 
diff --git a/src/TableFunctions/TableFunctionAzureBlobStorage.h b/src/TableFunctions/TableFunctionAzureBlobStorage.h
index 0bb872de3f3..0ac3f9771c7 100644
--- a/src/TableFunctions/TableFunctionAzureBlobStorage.h
+++ b/src/TableFunctions/TableFunctionAzureBlobStorage.h
@@ -18,7 +18,7 @@ class Context;
 class TableFunctionAzureBlobStorage : public ITableFunction
 {
 public:
-    static constexpr auto name = "azure_blob_storage";
+    static constexpr auto name = "azureBlobStorage";
     static constexpr auto signature = "- connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure]\n";
 
     static size_t getMaxNumberOfArguments() { return 8; }
diff --git a/tests/integration/test_storage_azure_blob_storage/test.py b/tests/integration/test_storage_azure_blob_storage/test.py
index f0934d3aa80..f9d337b6d86 100644
--- a/tests/integration/test_storage_azure_blob_storage/test.py
+++ b/tests/integration/test_storage_azure_blob_storage/test.py
@@ -466,7 +466,7 @@ def test_simple_write_account_string_table_function(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "INSERT INTO TABLE FUNCTION azure_blob_storage('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write_tf.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', 'key UInt64, data String') VALUES (1, 'a')",
+        "INSERT INTO TABLE FUNCTION azureBlobStorage('http://azurite1:10000/devstoreaccount1', 'cont', 'test_simple_write_tf.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', 'key UInt64, data String') VALUES (1, 'a')",
     )
     print(get_azure_file_content("test_simple_write_tf.csv"))
     assert get_azure_file_content("test_simple_write_tf.csv") == '1,"a"\n'
@@ -476,7 +476,7 @@ def test_simple_write_connection_string_table_function(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "INSERT INTO TABLE FUNCTION azure_blob_storage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_connection_tf.csv', 'CSV', 'auto', 'key UInt64, data String') VALUES (1, 'a')",
+        "INSERT INTO TABLE FUNCTION azureBlobStorage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1;', 'cont', 'test_simple_write_connection_tf.csv', 'CSV', 'auto', 'key UInt64, data String') VALUES (1, 'a')",
     )
     print(get_azure_file_content("test_simple_write_connection_tf.csv"))
     assert get_azure_file_content("test_simple_write_connection_tf.csv") == '1,"a"\n'
@@ -486,7 +486,7 @@ def test_simple_write_named_collection_1_table_function(cluster):
     node = cluster.instances["node"]
     azure_query(
         node,
-        "INSERT INTO TABLE FUNCTION azure_blob_storage(azure_conf1) VALUES (1, 'a')",
+        "INSERT INTO TABLE FUNCTION azureBlobStorage(azure_conf1) VALUES (1, 'a')",
     )
     print(get_azure_file_content("test_simple_write_named.csv"))
     assert get_azure_file_content("test_simple_write_named.csv") == '1,"a"\n'
@@ -507,7 +507,7 @@ def test_simple_write_named_collection_2_table_function(cluster):
 
     azure_query(
         node,
-        "INSERT INTO TABLE FUNCTION azure_blob_storage(azure_conf2, container='cont', blob_path='test_simple_write_named_2_tf.csv', format='CSV', structure='key UInt64, data String') VALUES (1, 'a')",
+        "INSERT INTO TABLE FUNCTION azureBlobStorage(azure_conf2, container='cont', blob_path='test_simple_write_named_2_tf.csv', format='CSV', structure='key UInt64, data String') VALUES (1, 'a')",
     )
     print(get_azure_file_content("test_simple_write_named_2_tf.csv"))
     assert get_azure_file_content("test_simple_write_named_2_tf.csv") == '1,"a"\n'
@@ -529,9 +529,9 @@ def test_put_get_with_globs_tf(cluster):
 
             azure_query(
                 node,
-                f"INSERT INTO TABLE FUNCTION azure_blob_storage(azure_conf2, container='cont', blob_path='{path}', format='CSV', compression='auto', structure='{table_format}') VALUES {values}",
+                f"INSERT INTO TABLE FUNCTION azureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSV', compression='auto', structure='{table_format}') VALUES {values}",
             )
-    query = f"select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from azure_blob_storage(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV', structure='{table_format}')"
+    query = f"select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from azureBlobStorage(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv', format='CSV', structure='{table_format}')"
     assert azure_query(node, query).splitlines() == [
         "450\t450\t900\t0.csv\t{bucket}/{max_path}".format(
             bucket="cont", max_path=max_path
@@ -543,10 +543,10 @@ def test_schema_inference_no_globs_tf(cluster):
     node = cluster.instances["node"]  # type: ClickHouseInstance
     table_format = "column1 UInt32, column2 String, column3 UInt32"
 
-    query = f"insert into table function azure_blob_storage(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs_tf.csv', format='CSVWithNames', structure='{table_format}') SELECT number, toString(number), number * number FROM numbers(1000)"
+    query = f"insert into table function azureBlobStorage(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs_tf.csv', format='CSVWithNames', structure='{table_format}') SELECT number, toString(number), number * number FROM numbers(1000)"
     azure_query(node, query)
 
-    query = "select sum(column1), sum(length(column2)), sum(column3), min(_file), max(_path) from azure_blob_storage(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs_tf.csv')"
+    query = "select sum(column1), sum(length(column2)), sum(column3), min(_file), max(_path) from azureBlobStorage(azure_conf2, container='cont', blob_path='test_schema_inference_no_globs_tf.csv')"
     assert azure_query(node, query).splitlines() == [
         "499500\t2890\t332833500\ttest_schema_inference_no_globs_tf.csv\tcont/test_schema_inference_no_globs_tf.csv"
     ]
@@ -566,10 +566,10 @@ def test_schema_inference_from_globs_tf(cluster):
             max_path = max(path, max_path)
             values = f"({i},{j},{i + j})"
 
-            query = f"insert into table function azure_blob_storage(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames', structure='{table_format}') VALUES {values}"
+            query = f"insert into table function azureBlobStorage(azure_conf2, container='cont', blob_path='{path}', format='CSVWithNames', structure='{table_format}') VALUES {values}"
             azure_query(node, query)
 
-    query = f"select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from azure_blob_storage(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')"
+    query = f"select sum(column1), sum(column2), sum(column3), min(_file), max(_path) from azureBlobStorage(azure_conf2, container='cont', blob_path='{unique_prefix}/*_{{a,b,c,d}}/?.csv')"
     assert azure_query(node, query).splitlines() == [
         "450\t450\t900\t0.csv\t{bucket}/{max_path}".format(
             bucket="cont", max_path=max_path
@@ -586,7 +586,7 @@ def test_partition_by_tf(cluster):
 
     azure_query(
         node,
-        f"INSERT INTO TABLE FUNCTION azure_blob_storage('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', '{table_format}') PARTITION BY {partition_by} VALUES {values}",
+        f"INSERT INTO TABLE FUNCTION azureBlobStorage('http://azurite1:10000/devstoreaccount1', 'cont', '{filename}', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 'CSV', 'auto', '{table_format}') PARTITION BY {partition_by} VALUES {values}",
     )
 
     assert "1,2,3\n" == get_azure_file_content("test_tf_3.csv")

From e662fa01d0a1455aa2a625fd342ef8e7e998f34f Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Fri, 9 Jun 2023 20:21:57 +0200
Subject: [PATCH 299/722] Added azureBlobStorage to aspell-dict.txt

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index d6cef1883f4..a01b67b26b1 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1081,6 +1081,7 @@ avgweighted
 avro
 avx
 aws
+azureBlobStorage
 backend
 backoff
 backticks

From f0d4ce4770a00a8c0cd9857a485fc8bbc124a95b Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 9 Jun 2023 22:05:21 +0300
Subject: [PATCH 300/722] Update 02785_summing_merge_tree_datetime64.sql

---
 .../queries/0_stateless/02785_summing_merge_tree_datetime64.sql  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql b/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql
index 1ed930ebbc7..db00f189330 100644
--- a/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql
+++ b/tests/queries/0_stateless/02785_summing_merge_tree_datetime64.sql
@@ -10,3 +10,4 @@ INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100'
 INSERT INTO summing_merge_tree_datetime64 SELECT 1 pk, '2023-05-01 23:55:55.100' timestamp, 5 value;
 
 SELECT * FROM summing_merge_tree_datetime64 FINAL;
+DROP TABLE summing_merge_tree_datetime64;

From c538506f2e3ba0716dcc2f13f63bb4edc1f6f33e Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 9 Jun 2023 20:50:17 +0000
Subject: [PATCH 301/722] More fixes

---
 docs/en/sql-reference/statements/create/table.md | 4 ++++
 src/Compression/CompressionCodecDeflateQpl.h     | 3 +--
 src/Compression/CompressionFactoryAdditions.cpp  | 2 +-
 src/Compression/ICompressionCodec.h              | 4 ++--
 src/Storages/Distributed/DistributedSink.cpp     | 2 +-
 5 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/docs/en/sql-reference/statements/create/table.md b/docs/en/sql-reference/statements/create/table.md
index 496ecdbda7b..1a72f89fb1f 100644
--- a/docs/en/sql-reference/statements/create/table.md
+++ b/docs/en/sql-reference/statements/create/table.md
@@ -385,6 +385,10 @@ High compression levels are useful for asymmetric scenarios, like compress once,
 - DEFLATE_QPL works best if the system has a Intel® IAA (In-Memory Analytics Accelerator) offloading device. Refer to [Accelerator Configuration](https://intel.github.io/qpl/documentation/get_started_docs/installation.html#accelerator-configuration) and [Benchmark with DEFLATE_QPL](/docs/en/development/building_and_benchmarking_deflate_qpl.md/#Run-Benchmark-with-DEFLATE_QPL) for more details.
 - DEFLATE_QPL-compressed data can only be transferred between ClickHouse nodes compiled with SSE 4.2 enabled.
 
+:::note
+DEFLATE_QPL is not available in ClickHouse Cloud.
+:::
+
 ### Specialized Codecs
 
 These codecs are designed to make compression more effective by using specific features of data. Some of these codecs do not compress data themself. Instead, they prepare the data for a common purpose codec, which compresses it better than without this preparation.
diff --git a/src/Compression/CompressionCodecDeflateQpl.h b/src/Compression/CompressionCodecDeflateQpl.h
index 13aa8733b54..8d73568707e 100644
--- a/src/Compression/CompressionCodecDeflateQpl.h
+++ b/src/Compression/CompressionCodecDeflateQpl.h
@@ -98,8 +98,7 @@ public:
 protected:
     bool isCompression() const override { return true; }
     bool isGenericCompression() const override { return true; }
-    bool isExperimental() const override { return false; }
-    bool isDeflateQplCompression() const override { return true; }
+    bool isDeflateQpl() const override { return true; }
 
     UInt32 doCompressData(const char * source, UInt32 source_size, char * dest) const override;
     void doDecompressData(const char * source, UInt32 source_size, char * dest, UInt32 uncompressed_size) const override;
diff --git a/src/Compression/CompressionFactoryAdditions.cpp b/src/Compression/CompressionFactoryAdditions.cpp
index 46f7e2653c2..98e9e7480da 100644
--- a/src/Compression/CompressionFactoryAdditions.cpp
+++ b/src/Compression/CompressionFactoryAdditions.cpp
@@ -159,7 +159,7 @@ ASTPtr CompressionCodecFactory::validateCodecAndGetPreprocessedAST(
                         " You can enable it with the 'allow_experimental_codecs' setting.",
                         codec_family_name);
 
-                if (!enable_deflate_qpl_codec && result_codec->isDeflateQplCompression())
+                if (!enable_deflate_qpl_codec && result_codec->isDeflateQpl())
                     throw Exception(ErrorCodes::BAD_ARGUMENTS,
                         "Codec {} is disabled by default."
                         " You can enable it with the 'enable_deflate_qpl_codec' setting.",
diff --git a/src/Compression/ICompressionCodec.h b/src/Compression/ICompressionCodec.h
index f7e8f4e43d2..6630838fa64 100644
--- a/src/Compression/ICompressionCodec.h
+++ b/src/Compression/ICompressionCodec.h
@@ -109,8 +109,8 @@ public:
     /// It will not be allowed to use unless the user will turn off the safety switch.
     virtual bool isExperimental() const { return false; }
 
-    /// This is a knob for Deflate QPL codec.
-    virtual bool isDeflateQplCompression() const { return false; }
+    /// Is this the DEFLATE_QPL codec?
+    virtual bool isDeflateQpl() const { return false; }
 
     /// If it does nothing.
     virtual bool isNone() const { return false; }
diff --git a/src/Storages/Distributed/DistributedSink.cpp b/src/Storages/Distributed/DistributedSink.cpp
index 1e1c911920e..875764f7633 100644
--- a/src/Storages/Distributed/DistributedSink.cpp
+++ b/src/Storages/Distributed/DistributedSink.cpp
@@ -733,7 +733,7 @@ void DistributedSink::writeToShard(const Cluster::ShardInfo & shard_info, const
     if (compression_method == "ZSTD")
         compression_level = settings.network_zstd_compression_level;
 
-    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enale_deflate_qpl_codec);
+    CompressionCodecFactory::instance().validateCodec(compression_method, compression_level, !settings.allow_suspicious_codecs, settings.allow_experimental_codecs, settings.enable_deflate_qpl_codec);
     CompressionCodecPtr compression_codec = CompressionCodecFactory::instance().get(compression_method, compression_level);
 
     /// tmp directory is used to ensure atomicity of transactions

From c71edb6c798163ad50a077a19a3bf74eb57ba212 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Fri, 9 Jun 2023 17:29:42 +0000
Subject: [PATCH 302/722] Fix style

---
 src/Processors/Sources/MongoDBSource.cpp | 10 +++++-----
 src/Processors/Sources/MongoDBSource.h   |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Processors/Sources/MongoDBSource.cpp b/src/Processors/Sources/MongoDBSource.cpp
index 74dfa13158c..cd4db416a29 100644
--- a/src/Processors/Sources/MongoDBSource.cpp
+++ b/src/Processors/Sources/MongoDBSource.cpp
@@ -371,8 +371,8 @@ bool isMongoDBWireProtocolOld(Poco::MongoDB::Connection & connection_)
 {
     Poco::MongoDB::Database db("config");
     Poco::MongoDB::Document::Ptr doc = db.queryServerHello(connection_);
-    auto _wireVersion = doc->getInteger("maxWireVersion");
-    return _wireVersion < Poco::MongoDB::Database::WireVersion::VER_36;
+    auto wire_version = doc->getInteger("maxWireVersion");
+    return wire_version < Poco::MongoDB::Database::WireVersion::VER_36;
 }
 
 
@@ -413,20 +413,20 @@ Poco::MongoDB::Document::Vector MongoDBCursor::nextDocuments(Poco::MongoDB::Conn
     if (is_wire_protocol_old)
     {
         auto response = old_cursor->next(connection);
-        cursorID_ = response.cursorID();
+        cursor_id = response.cursorID();
         return std::move(response.documents());
     }
     else
     {
         auto response = new_cursor->next(connection);
-        cursorID_ = new_cursor->cursorID();
+        cursor_id = new_cursor->cursorID();
         return std::move(response.documents());
     }
 }
 
 Int64 MongoDBCursor::cursorID() const
 {
-    return cursorID_;
+    return cursor_id;
 }
 
 
diff --git a/src/Processors/Sources/MongoDBSource.h b/src/Processors/Sources/MongoDBSource.h
index 2bc5481e20b..0e95d42c028 100644
--- a/src/Processors/Sources/MongoDBSource.h
+++ b/src/Processors/Sources/MongoDBSource.h
@@ -53,7 +53,7 @@ private:
     const bool is_wire_protocol_old;
     std::unique_ptr<Poco::MongoDB::Cursor> old_cursor;
     std::unique_ptr<Poco::MongoDB::OpMsgCursor> new_cursor;
-    Int64 cursorID_ = 0;
+    Int64 cursor_id = 0;
 };
 
 /// Converts MongoDB Cursor to a stream of Blocks

From 96d7b2efc9c0d4f40b919c5036fcfbe7445d10a1 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Fri, 9 Jun 2023 13:50:30 -0700
Subject: [PATCH 303/722] Disable fasttest for MySQL Compatibility Type
 Conversion and refactor style for DataTypeNumberBase

---
 src/DataTypes/DataTypeNumberBase.cpp          | 22 -------------------
 .../02775_show_columns_mysql_compatibility.sh |  1 +
 2 files changed, 1 insertion(+), 22 deletions(-)

diff --git a/src/DataTypes/DataTypeNumberBase.cpp b/src/DataTypes/DataTypeNumberBase.cpp
index e4c0fb96483..4cefc4945c6 100644
--- a/src/DataTypes/DataTypeNumberBase.cpp
+++ b/src/DataTypes/DataTypeNumberBase.cpp
@@ -15,50 +15,28 @@ template <typename T>
 String DataTypeNumberBase<T>::getSQLCompatibleName() const
 {
     if constexpr (std::is_same_v<T, Int8>)
-    {
         return "TINYINT";
-    }
     else if constexpr (std::is_same_v<T, Int16>)
-    {
         return "SMALLINT";
-    }
     else if constexpr (std::is_same_v<T, Int32>)
-    {
         return "INTEGER";
-    }
     else if constexpr (std::is_same_v<T, Int64>)
-    {
         return "BIGINT";
-    }
     else if constexpr (std::is_same_v<T, UInt8>)
-    {
         return "TINYINT UNSIGNED";
-    }
     else if constexpr (std::is_same_v<T, UInt16>)
-    {
         return "SMALLINT UNSIGNED";
-    }
     else if constexpr (std::is_same_v<T, UInt32>)
-    {
         return "INTEGER UNSIGNED";
-    }
     else if constexpr (std::is_same_v<T, UInt64>)
-    {
         return "BIGINT UNSIGNED";
-    }
     else if constexpr (std::is_same_v<T, Float32>)
-    {
         return "FLOAT";
-    }
     else if constexpr (std::is_same_v<T, Float64>)
-    {
         return "DOUBLE";
-    }
     /// Unsupported types are converted to TEXT
     else
-    {
         return "TEXT";
-    }
 }
 
 template <typename T>
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index 938102cb5fc..6a546c47a38 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Tags: no-fasttest
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From 20b66689f3c912757540c4e91589b7ffd6fe3593 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Sat, 10 Jun 2023 13:34:51 +0200
Subject: [PATCH 304/722] Fix test

---
 docker/test/upgrade/run.sh | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docker/test/upgrade/run.sh b/docker/test/upgrade/run.sh
index bd0c59a12cd..8353d03fc69 100644
--- a/docker/test/upgrade/run.sh
+++ b/docker/test/upgrade/run.sh
@@ -59,12 +59,6 @@ install_packages previous_release_package_folder
 # available for dump via clickhouse-local
 configure
 
-# local_blob_storage disk type does not exist in older versions
-sudo cat /etc/clickhouse-server/config.d/storage_conf.xml \
-  | sed "s|<type>local_blob_storage</type>|<type>local</type>|" \
-  > /etc/clickhouse-server/config.d/storage_conf.xml.tmp
-sudo mv /etc/clickhouse-server/config.d/storage_conf.xml.tmp /etc/clickhouse-server/config.d/storage_conf.xml
-
 # it contains some new settings, but we can safely remove it
 rm /etc/clickhouse-server/config.d/merge_tree.xml
 

From ff96c4c0d8898c15e1aea876267c65ec8b0c69f0 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 10 Jun 2023 12:09:47 +0000
Subject: [PATCH 305/722] Fix black

---
 tests/integration/test_non_default_compression/test.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/integration/test_non_default_compression/test.py b/tests/integration/test_non_default_compression/test.py
index e1a9c1ae540..18e2eb43813 100644
--- a/tests/integration/test_non_default_compression/test.py
+++ b/tests/integration/test_non_default_compression/test.py
@@ -50,6 +50,7 @@ node7 = cluster.add_instance(
     user_configs=["configs/allow_suspicious_codecs.xml"],
 )
 
+
 @pytest.fixture(scope="module")
 def start_cluster():
     try:
@@ -252,6 +253,7 @@ def test_uncompressed_cache_plus_zstd_codec(start_cluster):
         == "10000\n"
     )
 
+
 def test_preconfigured_deflateqpl_codec(start_cluster):
     node6.query(
         """
@@ -268,7 +270,7 @@ def test_preconfigured_deflateqpl_codec(start_cluster):
     )
     assert (
         node6.query(
-           "SELECT COUNT(*) FROM compression_codec_multiple_with_key WHERE id % 2 == 0"
+            "SELECT COUNT(*) FROM compression_codec_multiple_with_key WHERE id % 2 == 0"
         )
         == "2\n"
     )
@@ -296,9 +298,7 @@ def test_preconfigured_deflateqpl_codec(start_cluster):
         == "1001\n"
     )
     assert (
-        node6.query(
-            "SELECT SUM(somecolumn) FROM compression_codec_multiple_with_key"
-        )
+        node6.query("SELECT SUM(somecolumn) FROM compression_codec_multiple_with_key")
         == str(777.777 + 88.88 + 99.99 + 1.0 * 10000) + "\n"
     )
     assert (

From 1f3e923528c25ddab273243fa80a6d0838c568c7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 15:23:41 +0300
Subject: [PATCH 306/722] Update CHANGELOG.md

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb08a8ec100..7142ad26e15 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -31,7 +31,7 @@
 * Introduces new keyword `INTO OUTFILE 'file.txt' APPEND`. [#48880](https://github.com/ClickHouse/ClickHouse/pull/48880) ([alekar](https://github.com/alekar)).
 * Added `system.zookeeper_connection` table that shows information about Keeper connections. [#45245](https://github.com/ClickHouse/ClickHouse/pull/45245) ([mateng915](https://github.com/mateng0915)).
 * Add new function `generateRandomStructure` that generates random table structure. It can be used in combination with table function `generateRandom`. [#47409](https://github.com/ClickHouse/ClickHouse/pull/47409) ([Kruglov Pavel](https://github.com/Avogar)).
-* Allow the use of `CASE` without an `ELSE` branch and extended `transform` to deal with more types. Also fix some issues that made transform() return incorrect results when decimal types were mixed with other numeric types. [#48300](https://github.com/ClickHouse/ClickHouse/pull/48300) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+* Allow the use of `CASE` without an `ELSE` branch and extended `transform` to deal with more types. Also fix some issues that made transform() return incorrect results when decimal types were mixed with other numeric types. [#48300](https://github.com/ClickHouse/ClickHouse/pull/48300) ([Salvatore Mesoraca](https://github.com/aiven-sal)). This closes #2655. This closes #9596. This closes #38666.
 * Added [server-side encryption using KMS keys](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html) with S3 tables, and the `header` setting with S3 disks. Closes [#48723](https://github.com/ClickHouse/ClickHouse/issues/48723). [#48724](https://github.com/ClickHouse/ClickHouse/pull/48724) ([Johann Gan](https://github.com/johanngan)).
 * Add MemoryTracker for the background tasks (merges and mutation). Introduces `merges_mutations_memory_usage_soft_limit` and `merges_mutations_memory_usage_to_ram_ratio` settings that represent the soft memory limit for merges and mutations. If this limit is reached ClickHouse won't schedule new merge or mutation tasks. Also `MergesMutationsMemoryTracking` metric is introduced to allow observing current memory usage of background tasks. Resubmit [#46089](https://github.com/ClickHouse/ClickHouse/issues/46089). Closes [#48774](https://github.com/ClickHouse/ClickHouse/issues/48774). [#48787](https://github.com/ClickHouse/ClickHouse/pull/48787) ([Dmitry Novik](https://github.com/novikd)).
 * Function `dotProduct` work for array. [#49050](https://github.com/ClickHouse/ClickHouse/pull/49050) ([FFFFFFFHHHHHHH](https://github.com/FFFFFFFHHHHHHH)).

From 818e081162e77045468d8349ad5c438b261b02d5 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 14:30:36 +0200
Subject: [PATCH 307/722] Fill gaps on the dashboard

---
 programs/server/dashboard.html | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/programs/server/dashboard.html b/programs/server/dashboard.html
index 97b35ec97c4..951b7db3aa3 100644
--- a/programs/server/dashboard.html
+++ b/programs/server/dashboard.html
@@ -449,7 +449,7 @@ let queries = [
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "CPU Usage (cores)",
@@ -457,7 +457,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Queries Running",
@@ -465,7 +465,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Merges Running",
@@ -473,7 +473,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Selected Bytes/second",
@@ -481,7 +481,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "IO Wait",
@@ -489,7 +489,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "CPU Wait",
@@ -497,7 +497,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "OS CPU Usage (Userspace)",
@@ -506,7 +506,7 @@ FROM system.asynchronous_metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 AND metric = 'OSUserTimeNormalized'
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "OS CPU Usage (Kernel)",
@@ -515,7 +515,7 @@ FROM system.asynchronous_metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 AND metric = 'OSSystemTimeNormalized'
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Read From Disk",
@@ -523,7 +523,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Read From Filesystem",
@@ -531,7 +531,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Memory (tracked)",
@@ -539,7 +539,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Load Average (15 minutes)",
@@ -548,7 +548,7 @@ FROM system.asynchronous_metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 AND metric = 'LoadAverage15'
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Selected Rows/second",
@@ -556,7 +556,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Inserted Rows/second",
@@ -564,7 +564,7 @@ ORDER BY t`
 FROM system.metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Total MergeTree Parts",
@@ -573,7 +573,7 @@ FROM system.asynchronous_metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 AND metric = 'TotalPartsOfMergeTreeTables'
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     },
     {
       "title": "Max Parts For Partition",
@@ -582,7 +582,7 @@ FROM system.asynchronous_metric_log
 WHERE event_date >= toDate(now() - {seconds:UInt32}) AND event_time >= now() - {seconds:UInt32}
 AND metric = 'MaxPartCountForPartition'
 GROUP BY t
-ORDER BY t`
+ORDER BY t WITH FILL STEP {rounding:UInt32}`
     }
 ];
 

From dc4a2fb07d29a4fe5818a42aa6c17be9bd59ccb7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 14:47:24 +0200
Subject: [PATCH 308/722] Add tests for function "transform"

---
 .../02786_transform_float.reference           | 10 +++++
 .../0_stateless/02786_transform_float.sql     |  3 ++
 .../02787_transform_null.reference            |  9 +++++
 .../0_stateless/02787_transform_null.sql      | 40 +++++++++++++++++++
 4 files changed, 62 insertions(+)
 create mode 100644 tests/queries/0_stateless/02786_transform_float.reference
 create mode 100644 tests/queries/0_stateless/02786_transform_float.sql
 create mode 100644 tests/queries/0_stateless/02787_transform_null.reference
 create mode 100644 tests/queries/0_stateless/02787_transform_null.sql

diff --git a/tests/queries/0_stateless/02786_transform_float.reference b/tests/queries/0_stateless/02786_transform_float.reference
new file mode 100644
index 00000000000..3fbb2492f2e
--- /dev/null
+++ b/tests/queries/0_stateless/02786_transform_float.reference
@@ -0,0 +1,10 @@
+1
+1
+1
+---
+1
+1
+1
+1
+1
+1
diff --git a/tests/queries/0_stateless/02786_transform_float.sql b/tests/queries/0_stateless/02786_transform_float.sql
new file mode 100644
index 00000000000..4229425b084
--- /dev/null
+++ b/tests/queries/0_stateless/02786_transform_float.sql
@@ -0,0 +1,3 @@
+select transform(number, [1], [toFloat32(1)], toFloat32(1)) from numbers(3);
+SELECT '---';
+select transform(number, [3], [toFloat32(1)], toFloat32(1)) from numbers(6);
diff --git a/tests/queries/0_stateless/02787_transform_null.reference b/tests/queries/0_stateless/02787_transform_null.reference
new file mode 100644
index 00000000000..a650dbbd173
--- /dev/null
+++ b/tests/queries/0_stateless/02787_transform_null.reference
@@ -0,0 +1,9 @@
+ZERO
+ZERO
+ONE
+ONE
+a
+a
+	\N	0	\N	0	\N
+1	1	1	\N	1	1
+a	\N	3	3	3	3
diff --git a/tests/queries/0_stateless/02787_transform_null.sql b/tests/queries/0_stateless/02787_transform_null.sql
new file mode 100644
index 00000000000..64a771f0f4b
--- /dev/null
+++ b/tests/queries/0_stateless/02787_transform_null.sql
@@ -0,0 +1,40 @@
+SELECT transform(0, [0, 1], ['ZERO', 'ONE'], 'DEFAULT') AS result;
+SELECT transform(0, [0, 1], ['ZERO', 'ONE'], NULL) AS result;
+
+SELECT CASE 1
+  WHEN 0 THEN 'ZERO'
+  WHEN 1 THEN 'ONE'
+  ELSE 'NONE'
+END AS result;
+
+SELECT CASE 1
+  WHEN 0 THEN NULL
+  WHEN 1 THEN 'ONE'
+  ELSE 'NONE'
+END AS result;
+
+select 
+    case 1 
+        when 1 then 'a' 
+        else 'b'
+    end value;
+
+select 
+    case 1 
+        when 1 then 'a' 
+    end value;
+
+SELECT
+    d,
+    toInt16OrNull(d),
+    caseWithExpression(d, 'a', 3, toInt16OrZero(d)) AS case_zero,
+    caseWithExpression(d, 'a', 3, toInt16OrNull(d)) AS case_null,
+    if(d = 'a', 3, toInt16OrZero(d)) AS if_zero,
+    if(d = 'a', 3, toInt16OrNull(d)) AS if_null
+FROM
+(
+    SELECT arrayJoin(['', '1', 'a']) AS d
+)
+ORDER BY
+    case_zero ASC,
+    d ASC;

From a614aa3b03b365c769f955f22b788181a8cf36ab Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@gmail.com>
Date: Sat, 10 Jun 2023 16:06:37 +0200
Subject: [PATCH 309/722] More leftovers

---
 docker/test/upgrade/run.sh | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/docker/test/upgrade/run.sh b/docker/test/upgrade/run.sh
index 8353d03fc69..6f7d3999f1d 100644
--- a/docker/test/upgrade/run.sh
+++ b/docker/test/upgrade/run.sh
@@ -86,11 +86,6 @@ export USE_S3_STORAGE_FOR_MERGE_TREE=1
 export ZOOKEEPER_FAULT_INJECTION=0
 configure
 
-sudo cat /etc/clickhouse-server/config.d/storage_conf.xml \
-  | sed "s|<type>local_blob_storage</type>|<type>local</type>|" \
-  > /etc/clickhouse-server/config.d/storage_conf.xml.tmp
-sudo mv /etc/clickhouse-server/config.d/storage_conf.xml.tmp /etc/clickhouse-server/config.d/storage_conf.xml
-
 # it contains some new settings, but we can safely remove it
 rm /etc/clickhouse-server/config.d/merge_tree.xml
 

From cb8c20722b8976fe0bc402498667b02c2585cc02 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Sat, 10 Jun 2023 08:35:51 -0700
Subject: [PATCH 310/722] Rename setting and description for MySQL compatible
 types This renames the setting for MySQL compatible types from
 output_format_mysql_types to use_mysql_types_in_show_columns

---
 src/Core/Settings.h                                           | 2 +-
 src/Storages/System/StorageSystemColumns.cpp                  | 4 ++--
 .../0_stateless/02775_show_columns_mysql_compatibility.sh     | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index b72fc037fbb..d47015ebb39 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -196,7 +196,7 @@ class IColumn;
     M(Bool, allow_experimental_inverted_index, false, "If it is set to true, allow to use experimental inverted index.", 0) \
     \
     M(UInt64, mysql_max_rows_to_insert, 65536, "The maximum number of rows in MySQL batch insertion of the MySQL storage engine", 0) \
-    M(Bool, output_format_mysql_types, false, "Use MySQL converted types when connected via MySQL compatibility", 0) \
+    M(Bool, use_mysql_types_in_show_columns, false, "Use MySQL converted types when connected via MySQL compatibility for show columns query", 0) \
     \
     M(UInt64, optimize_min_equality_disjunction_chain_length, 3, "The minimum length of the expression `expr = x1 OR ... expr = xN` for optimization ", 0) \
     \
diff --git a/src/Storages/System/StorageSystemColumns.cpp b/src/Storages/System/StorageSystemColumns.cpp
index 684c35709a4..e4ca6a15138 100644
--- a/src/Storages/System/StorageSystemColumns.cpp
+++ b/src/Storages/System/StorageSystemColumns.cpp
@@ -75,7 +75,7 @@ public:
         , columns_mask(std::move(columns_mask_)), max_block_size(max_block_size_)
         , databases(std::move(databases_)), tables(std::move(tables_)), storages(std::move(storages_))
         , client_info_interface(context->getClientInfo().interface)
-        , use_mysql_types(context->getSettingsRef().output_format_mysql_types)
+        , use_mysql_types(context->getSettingsRef().use_mysql_types_in_show_columns)
         , total_tables(tables->size()), access(context->getAccess())
         , query_id(context->getCurrentQueryId()), lock_acquire_timeout(context->getSettingsRef().lock_acquire_timeout)
     {
@@ -133,7 +133,7 @@ protected:
 
             auto get_type_name = [this](const IDataType& type) -> std::string
             {
-                // Check if the output_format_mysql_types setting is enabled and client is connected via MySQL protocol
+                // Check if the use_mysql_types_in_show_columns setting is enabled and client is connected via MySQL protocol
                 if (use_mysql_types && client_info_interface == DB::ClientInfo::Interface::MYSQL)
                 {
                     return type.getSQLCompatibleName();
diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index 6a546c47a38..51c9da2a842 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -127,7 +127,7 @@ TEMP_FILE=$(mktemp)
 
 cat <<EOT > $TEMP_FILE
 SHOW COLUMNS FROM tab;
-SET output_format_mysql_types=1;
+SET use_mysql_types_in_show_columns=1;
 SHOW COLUMNS FROM tab;
 SHOW EXTENDED COLUMNS FROM tab;
 SHOW FULL COLUMNS FROM tab;

From 7cb6f3c72279878db1ad65c5ea9670287cc42d16 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 17:43:42 +0200
Subject: [PATCH 311/722] Rename Cpu to CPU and Cfs to CFS

---
 src/Common/AsynchronousMetrics.cpp | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/Common/AsynchronousMetrics.cpp b/src/Common/AsynchronousMetrics.cpp
index 6821647a180..531f0b04aa1 100644
--- a/src/Common/AsynchronousMetrics.cpp
+++ b/src/Common/AsynchronousMetrics.cpp
@@ -962,8 +962,8 @@ void AsynchronousMetrics::update(TimePoint update_time)
                 period = std::stoull(field2);
             }
 
-            new_values["CGroupCpuCfsPeriod"] = { period, "The CFS period of CPU cgroup."};
-            new_values["CGroupCpuCfsQuota"] = { quota, "The CFS quota of CPU cgroup. If stated zero, the quota is max."};
+            new_values["CGroupCPUCFSPeriod"] = { period, "The CFS period of CPU cgroup."};
+            new_values["CGroupCPUCFSQuota"] = { quota, "The CFS quota of CPU cgroup. If stated zero, the quota is max."};
         }
         catch (...)
         {
@@ -982,8 +982,8 @@ void AsynchronousMetrics::update(TimePoint update_time)
             tryReadText(quota, *cgroupcpu_cfs_quota);
             tryReadText(period, *cgroupcpu_cfs_period);
 
-            new_values["CGroupCpuCfsPeriod"] = { period, "The CFS period of CPU cgroup."};
-            new_values["CGroupCpuCfsQuota"] = { quota, "The CFS quota of CPU cgroup. If stated zero, the quota is max."};
+            new_values["CGroupCPUCFSPeriod"] = { period, "The CFS period of CPU cgroup."};
+            new_values["CGroupCPUCFSQuota"] = { quota, "The CFS quota of CPU cgroup. If stated zero, the quota is max."};
         }
         catch (...)
         {

From e785c6796d8c1694e0f820e15772fa59bf31cbf0 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 17:54:46 +0200
Subject: [PATCH 312/722] Replace CGroups CPU metrics to one

---
 src/Common/AsynchronousMetrics.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Common/AsynchronousMetrics.cpp b/src/Common/AsynchronousMetrics.cpp
index 531f0b04aa1..c610034a6b0 100644
--- a/src/Common/AsynchronousMetrics.cpp
+++ b/src/Common/AsynchronousMetrics.cpp
@@ -939,7 +939,8 @@ void AsynchronousMetrics::update(TimePoint update_time)
 
     if (cgroupcpu_max)
     {
-        try {
+        try
+        {
             cgroupcpu_max->rewind();
 
             uint64_t quota = 0;
@@ -962,8 +963,7 @@ void AsynchronousMetrics::update(TimePoint update_time)
                 period = std::stoull(field2);
             }
 
-            new_values["CGroupCPUCFSPeriod"] = { period, "The CFS period of CPU cgroup."};
-            new_values["CGroupCPUCFSQuota"] = { quota, "The CFS quota of CPU cgroup. If stated zero, the quota is max."};
+            new_values["CGroupMaxCPU"] = { static_cast<Float64>(quota) / period, "The maximum number of CPU cores according to CGroups."};
         }
         catch (...)
         {
@@ -972,7 +972,8 @@ void AsynchronousMetrics::update(TimePoint update_time)
     }
     else if (cgroupcpu_cfs_quota && cgroupcpu_cfs_period)
     {
-        try {
+        try
+        {
             cgroupcpu_cfs_quota->rewind();
             cgroupcpu_cfs_period->rewind();
 
@@ -982,8 +983,7 @@ void AsynchronousMetrics::update(TimePoint update_time)
             tryReadText(quota, *cgroupcpu_cfs_quota);
             tryReadText(period, *cgroupcpu_cfs_period);
 
-            new_values["CGroupCPUCFSPeriod"] = { period, "The CFS period of CPU cgroup."};
-            new_values["CGroupCPUCFSQuota"] = { quota, "The CFS quota of CPU cgroup. If stated zero, the quota is max."};
+            new_values["CGroupMaxCPU"] = { static_cast<Float64>(quota) / period, "The maximum number of CPU cores according to CGroups."};
         }
         catch (...)
         {

From a91b84e60c1904bdd6fe7bdfd82869ad07e6bb94 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 18:00:47 +0200
Subject: [PATCH 313/722] Slightly better

---
 src/Common/AsynchronousMetrics.cpp | 116 +++++++++++++++--------------
 1 file changed, 62 insertions(+), 54 deletions(-)

diff --git a/src/Common/AsynchronousMetrics.cpp b/src/Common/AsynchronousMetrics.cpp
index c610034a6b0..de9800aa896 100644
--- a/src/Common/AsynchronousMetrics.cpp
+++ b/src/Common/AsynchronousMetrics.cpp
@@ -727,6 +727,68 @@ void AsynchronousMetrics::update(TimePoint update_time)
         }
     }
 
+    Float64 max_cpu_cgroups = 0;
+    if (cgroupcpu_max)
+    {
+        try
+        {
+            cgroupcpu_max->rewind();
+
+            uint64_t quota = 0;
+            uint64_t period = 0;
+
+            std::string line;
+            readText(line, *cgroupcpu_max);
+
+            auto space = line.find(' ');
+
+            if (line.rfind("max", space) == std::string::npos)
+            {
+                auto field1 = line.substr(0, space);
+                quota = std::stoull(field1);
+            }
+
+            if (space != std::string::npos)
+            {
+                auto field2 = line.substr(space + 1);
+                period = std::stoull(field2);
+            }
+
+            if (quota > 0 && period > 0)
+                max_cpu_cgroups = static_cast<Float64>(quota) / period;
+        }
+        catch (...)
+        {
+            tryLogCurrentException(__PRETTY_FUNCTION__);
+        }
+    }
+    else if (cgroupcpu_cfs_quota && cgroupcpu_cfs_period)
+    {
+        try
+        {
+            cgroupcpu_cfs_quota->rewind();
+            cgroupcpu_cfs_period->rewind();
+
+            uint64_t quota = 0;
+            uint64_t period = 0;
+
+            tryReadText(quota, *cgroupcpu_cfs_quota);
+            tryReadText(period, *cgroupcpu_cfs_period);
+
+            if (quota > 0 && period > 0)
+                max_cpu_cgroups = static_cast<Float64>(quota) / period;
+        }
+        catch (...)
+        {
+            tryLogCurrentException(__PRETTY_FUNCTION__);
+        }
+    }
+
+    if (max_cpu_cgroups > 0)
+    {
+        new_values["CGroupMaxCPU"] = { max_cpu_cgroups, "The maximum number of CPU cores according to CGroups."};
+    }
+
     if (proc_stat)
     {
         try
@@ -937,60 +999,6 @@ void AsynchronousMetrics::update(TimePoint update_time)
         }
     }
 
-    if (cgroupcpu_max)
-    {
-        try
-        {
-            cgroupcpu_max->rewind();
-
-            uint64_t quota = 0;
-            uint64_t period = 0;
-
-            std::string line;
-            readText(line, *cgroupcpu_max);
-
-            auto space = line.find(' ');
-
-            if (line.rfind("max", space) == std::string::npos)
-            {
-                auto field1 = line.substr(0, space);
-                quota = std::stoull(field1);
-            }
-
-            if (space != std::string::npos)
-            {
-                auto field2 = line.substr(space + 1);
-                period = std::stoull(field2);
-            }
-
-            new_values["CGroupMaxCPU"] = { static_cast<Float64>(quota) / period, "The maximum number of CPU cores according to CGroups."};
-        }
-        catch (...)
-        {
-            tryLogCurrentException(__PRETTY_FUNCTION__);
-        }
-    }
-    else if (cgroupcpu_cfs_quota && cgroupcpu_cfs_period)
-    {
-        try
-        {
-            cgroupcpu_cfs_quota->rewind();
-            cgroupcpu_cfs_period->rewind();
-
-            uint64_t quota = 0;
-            uint64_t period = 0;
-
-            tryReadText(quota, *cgroupcpu_cfs_quota);
-            tryReadText(period, *cgroupcpu_cfs_period);
-
-            new_values["CGroupMaxCPU"] = { static_cast<Float64>(quota) / period, "The maximum number of CPU cores according to CGroups."};
-        }
-        catch (...)
-        {
-            tryLogCurrentException(__PRETTY_FUNCTION__);
-        }
-    }
-
     if (meminfo)
     {
         try

From ddd2257cf51edf0cf0fb264b1d010e7436d7e94b Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 10 Jun 2023 18:03:17 +0200
Subject: [PATCH 314/722] Normalize with respect to CGroups

---
 src/Common/AsynchronousMetrics.cpp | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/src/Common/AsynchronousMetrics.cpp b/src/Common/AsynchronousMetrics.cpp
index de9800aa896..36c87010fa5 100644
--- a/src/Common/AsynchronousMetrics.cpp
+++ b/src/Common/AsynchronousMetrics.cpp
@@ -933,36 +933,38 @@ void AsynchronousMetrics::update(TimePoint update_time)
                 /// Also write values normalized to 0..1 by diving to the number of CPUs.
                 /// These values are good to be averaged across the cluster of non-uniform servers.
 
-                if (num_cpus)
+                Float64 num_cpus_to_normalize = max_cpu_cgroups > 0 ? max_cpu_cgroups : num_cpus;
+
+                if (num_cpus_to_normalize > 0)
                 {
-                    new_values["OSUserTimeNormalized"] = { delta_values_all_cpus.user * multiplier / num_cpus,
+                    new_values["OSUserTimeNormalized"] = { delta_values_all_cpus.user * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSUserTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSNiceTimeNormalized"] = { delta_values_all_cpus.nice * multiplier / num_cpus,
+                    new_values["OSNiceTimeNormalized"] = { delta_values_all_cpus.nice * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSNiceTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSSystemTimeNormalized"] = { delta_values_all_cpus.system * multiplier / num_cpus,
+                    new_values["OSSystemTimeNormalized"] = { delta_values_all_cpus.system * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSSystemTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSIdleTimeNormalized"] = { delta_values_all_cpus.idle * multiplier / num_cpus,
+                    new_values["OSIdleTimeNormalized"] = { delta_values_all_cpus.idle * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSIdleTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSIOWaitTimeNormalized"] = { delta_values_all_cpus.iowait * multiplier / num_cpus,
+                    new_values["OSIOWaitTimeNormalized"] = { delta_values_all_cpus.iowait * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSIOWaitTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSIrqTimeNormalized"] = { delta_values_all_cpus.irq * multiplier / num_cpus,
+                    new_values["OSIrqTimeNormalized"] = { delta_values_all_cpus.irq * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSIrqTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSSoftIrqTimeNormalized"] = { delta_values_all_cpus.softirq * multiplier / num_cpus,
+                    new_values["OSSoftIrqTimeNormalized"] = { delta_values_all_cpus.softirq * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSSoftIrqTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSStealTimeNormalized"] = { delta_values_all_cpus.steal * multiplier / num_cpus,
+                    new_values["OSStealTimeNormalized"] = { delta_values_all_cpus.steal * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSStealTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSGuestTimeNormalized"] = { delta_values_all_cpus.guest * multiplier / num_cpus,
+                    new_values["OSGuestTimeNormalized"] = { delta_values_all_cpus.guest * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSGuestTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
-                    new_values["OSGuestNiceTimeNormalized"] = { delta_values_all_cpus.guest_nice * multiplier / num_cpus,
+                    new_values["OSGuestNiceTimeNormalized"] = { delta_values_all_cpus.guest_nice * multiplier / num_cpus_to_normalize,
                         "The value is similar to `OSGuestNiceTime` but divided to the number of CPU cores to be measured in the [0..1] interval regardless of the number of cores."
                         " This allows you to average the values of this metric across multiple servers in a cluster even if the number of cores is non-uniform, and still get the average resource utilization metric."};
                 }

From 72b9d75a84476d7ee402de8a160f8a22b9ccdb59 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 10 Jun 2023 12:53:02 +0000
Subject: [PATCH 315/722] Add compat setting for non-const timezones

SQL function toTimezone() converts a Date or DateTime into another
timezone. The problem is that the timezone is part of the Date /
DateTime type but not part of the internal representation (value). This
led to the fact that toTimeZone() wqith non-const timezones produced
wrong and misleading results until #48471 (shipped with v23.4) enforced
a const timezone.

Unfortunately, this PR also broke existing table definitions with
non-const timezones, e.g. in ALIAS expressions. So while #48471
addressed the issue appropriately, it is really backwards-incompatible.

This PR adds a setting to toggle the behavior and makes it also part of
the compatibility profile.
---
 src/Core/Settings.h                           |  1 +
 src/Core/SettingsChangesHistory.h             |  1 +
 .../FunctionDateOrDateTimeAddInterval.h       |  4 +-
 .../FunctionDateOrDateTimeToDateOrDate32.h    |  2 +-
 ...tionDateOrDateTimeToDateTimeOrDateTime64.h |  2 +-
 .../FunctionDateOrDateTimeToSomething.h       |  4 +-
 src/Functions/FunctionSnowflake.h             | 17 ++++--
 src/Functions/FunctionUnixTimestamp64.h       | 13 +++--
 src/Functions/FunctionsConversion.h           | 10 ++--
 src/Functions/FunctionsTimeWindow.cpp         |  4 +-
 src/Functions/date_trunc.cpp                  |  2 +-
 .../extractTimeZoneFromFunctionArguments.cpp  |  5 +-
 .../extractTimeZoneFromFunctionArguments.h    | 10 +++-
 src/Functions/fromUnixTimestamp64Micro.cpp    |  4 +-
 src/Functions/fromUnixTimestamp64Milli.cpp    |  4 +-
 src/Functions/fromUnixTimestamp64Nano.cpp     |  4 +-
 src/Functions/now.cpp                         | 12 +++--
 src/Functions/now64.cpp                       | 10 +++-
 src/Functions/nowInBlock.cpp                  | 12 +++--
 src/Functions/snowflake.cpp                   |  8 +--
 src/Functions/timeSlots.cpp                   |  4 +-
 src/Functions/toStartOfInterval.cpp           |  4 +-
 src/Functions/toTimezone.cpp                  | 11 +++-
 .../00515_enhanced_time_zones.reference       |  7 +++
 .../0_stateless/00515_enhanced_time_zones.sql | 54 ++++++++++++++-----
 25 files changed, 147 insertions(+), 62 deletions(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 464b9168a4c..d2e6a470a91 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -147,6 +147,7 @@ class IColumn;
     M(Bool, enable_memory_bound_merging_of_aggregation_results, true, "Enable memory bound merging strategy for aggregation.", 0) \
     M(Bool, enable_positional_arguments, true, "Enable positional arguments in ORDER BY, GROUP BY and LIMIT BY", 0) \
     M(Bool, enable_extended_results_for_datetime_functions, false, "Enable date functions like toLastDayOfMonth return Date32 results (instead of Date results) for Date32/DateTime64 arguments.", 0) \
+    M(Bool, allow_nonconst_timezone_arguments, false, "Allow non-const timezone arguments in certain time-related functions like toTimeZone(), fromUnixTimestamp*(), snowflakeToDateTime*()", 0) \
     \
     M(Bool, group_by_use_nulls, false, "Treat columns mentioned in ROLLUP, CUBE or GROUPING SETS as Nullable", 0) \
     \
diff --git a/src/Core/SettingsChangesHistory.h b/src/Core/SettingsChangesHistory.h
index c0f10b13282..9fd45ac16d6 100644
--- a/src/Core/SettingsChangesHistory.h
+++ b/src/Core/SettingsChangesHistory.h
@@ -85,6 +85,7 @@ static std::map<ClickHouseVersion, SettingsChangesHistory::SettingsChanges> sett
               {"use_with_fill_by_sorting_prefix", false, true, "Columns preceding WITH FILL columns in ORDER BY clause form sorting prefix. Rows with different values in sorting prefix are filled independently"},
               {"output_format_parquet_compliant_nested_types", false, true, "Change an internal field name in output Parquet file schema."}}},
     {"23.4", {{"allow_suspicious_indices", true, false, "If true, index can defined with identical expressions"},
+              {"allow_nonconst_timezone_arguments", true, false, "Allow non-const timezone arguments in certain time-related functions like toTimeZone(), fromUnixTimestamp*(), snowflakeToDateTime*()."},
               {"connect_timeout_with_failover_ms", 50, 1000, "Increase default connect timeout because of async connect"},
               {"connect_timeout_with_failover_secure_ms", 100, 1000, "Increase default secure connect timeout because of async connect"},
               {"hedged_connection_timeout_ms", 100, 50, "Start new connection in hedged requests after 50 ms instead of 100 to correspond with previous connect timeout"}}},
diff --git a/src/Functions/FunctionDateOrDateTimeAddInterval.h b/src/Functions/FunctionDateOrDateTimeAddInterval.h
index 507dc37e266..1546c24d30c 100644
--- a/src/Functions/FunctionDateOrDateTimeAddInterval.h
+++ b/src/Functions/FunctionDateOrDateTimeAddInterval.h
@@ -679,7 +679,7 @@ public:
         }
         else if constexpr (std::is_same_v<ResultDataType, DataTypeDateTime>)
         {
-            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 0));
+            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 0, false));
         }
         else if constexpr (std::is_same_v<ResultDataType, DataTypeDateTime64>)
         {
@@ -696,7 +696,7 @@ public:
                     return {};
                 });
 
-            auto timezone = extractTimeZoneNameFromFunctionArguments(arguments, 2, 0);
+            auto timezone = extractTimeZoneNameFromFunctionArguments(arguments, 2, 0, false);
             if (const auto* datetime64_type = typeid_cast<const DataTypeDateTime64 *>(arguments[0].type.get()))
             {
                 const auto from_scale = datetime64_type->getScale();
diff --git a/src/Functions/FunctionDateOrDateTimeToDateOrDate32.h b/src/Functions/FunctionDateOrDateTimeToDateOrDate32.h
index 8e006b93b98..6eb3e534b62 100644
--- a/src/Functions/FunctionDateOrDateTimeToDateOrDate32.h
+++ b/src/Functions/FunctionDateOrDateTimeToDateOrDate32.h
@@ -36,7 +36,7 @@ public:
         /// If the time zone is specified but empty, throw an exception.
         /// only validate the time_zone part if the number of arguments is 2.
         if ((which.isDateTime() || which.isDateTime64()) && arguments.size() == 2
-            && extractTimeZoneNameFromFunctionArguments(arguments, 1, 0).empty())
+            && extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, false).empty())
             throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
                 "Function {} supports a 2nd argument (optional) that must be a valid time zone",
                 this->getName());
diff --git a/src/Functions/FunctionDateOrDateTimeToDateTimeOrDateTime64.h b/src/Functions/FunctionDateOrDateTimeToDateTimeOrDateTime64.h
index 3d1f0f192cf..9f1066fd687 100644
--- a/src/Functions/FunctionDateOrDateTimeToDateTimeOrDateTime64.h
+++ b/src/Functions/FunctionDateOrDateTimeToDateTimeOrDateTime64.h
@@ -34,7 +34,7 @@ public:
 
         WhichDataType which(from_type);
 
-        std::string time_zone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+        std::string time_zone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, false);
 
         /// If the time zone is specified but empty, throw an exception.
         /// only validate the time_zone part if the number of arguments is 2.
diff --git a/src/Functions/FunctionDateOrDateTimeToSomething.h b/src/Functions/FunctionDateOrDateTimeToSomething.h
index 47433d13e0b..82818cc3d2b 100644
--- a/src/Functions/FunctionDateOrDateTimeToSomething.h
+++ b/src/Functions/FunctionDateOrDateTimeToSomething.h
@@ -24,7 +24,7 @@ public:
         /// If the time zone is specified but empty, throw an exception.
         if constexpr (std::is_same_v<ToDataType, DataTypeDateTime>)
         {
-            std::string time_zone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+            std::string time_zone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, false);
             /// only validate the time_zone part if the number of arguments is 2. This is mainly
             /// to accommodate functions like toStartOfDay(today()), toStartOfDay(yesterday()) etc.
             if (arguments.size() == 2 && time_zone.empty())
@@ -53,7 +53,7 @@ public:
                 scale = std::max(source_scale, static_cast<Int64>(9));
             }
 
-            return std::make_shared<ToDataType>(scale, extractTimeZoneNameFromFunctionArguments(arguments, 1, 0));
+            return std::make_shared<ToDataType>(scale, extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, false));
         }
         else
             return std::make_shared<ToDataType>();
diff --git a/src/Functions/FunctionSnowflake.h b/src/Functions/FunctionSnowflake.h
index 998db98890a..ce3a48269b4 100644
--- a/src/Functions/FunctionSnowflake.h
+++ b/src/Functions/FunctionSnowflake.h
@@ -6,6 +6,7 @@
 #include <DataTypes/DataTypeDateTime64.h>
 #include <DataTypes/DataTypesNumber.h>
 #include <Columns/ColumnsNumber.h>
+#include <Interpreters/Context.h>
 
 #include <base/arithmeticOverflow.h>
 
@@ -72,9 +73,13 @@ class FunctionSnowflakeToDateTime : public IFunction
 {
 private:
     const char * name;
+    const bool allow_nonconst_timezone_arguments;
 
 public:
-    explicit FunctionSnowflakeToDateTime(const char * name_) : name(name_) { }
+    explicit FunctionSnowflakeToDateTime(const char * name_, ContextPtr context)
+        : name(name_)
+        , allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     String getName() const override { return name; }
     size_t getNumberOfArguments() const override { return 0; }
@@ -92,7 +97,7 @@ public:
 
         std::string timezone;
         if (arguments.size() == 2)
-            timezone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+            timezone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, allow_nonconst_timezone_arguments);
 
         return std::make_shared<DataTypeDateTime>(timezone);
     }
@@ -162,9 +167,13 @@ class FunctionSnowflakeToDateTime64 : public IFunction
 {
 private:
     const char * name;
+    const bool allow_nonconst_timezone_arguments;
 
 public:
-    explicit FunctionSnowflakeToDateTime64(const char * name_) : name(name_) { }
+    explicit FunctionSnowflakeToDateTime64(const char * name_, ContextPtr context)
+        : name(name_)
+        , allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     String getName() const override { return name; }
     size_t getNumberOfArguments() const override { return 0; }
@@ -182,7 +191,7 @@ public:
 
         std::string timezone;
         if (arguments.size() == 2)
-            timezone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+            timezone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, allow_nonconst_timezone_arguments);
 
         return std::make_shared<DataTypeDateTime64>(3, timezone);
     }
diff --git a/src/Functions/FunctionUnixTimestamp64.h b/src/Functions/FunctionUnixTimestamp64.h
index 7519e46f9dc..58a23f7266e 100644
--- a/src/Functions/FunctionUnixTimestamp64.h
+++ b/src/Functions/FunctionUnixTimestamp64.h
@@ -6,6 +6,7 @@
 #include <DataTypes/DataTypeDateTime64.h>
 #include <DataTypes/DataTypesNumber.h>
 #include <Columns/ColumnsNumber.h>
+#include <Interpreters/Context.h>
 
 #include <base/arithmeticOverflow.h>
 
@@ -99,11 +100,13 @@ class FunctionFromUnixTimestamp64 : public IFunction
 private:
     size_t target_scale;
     const char * name;
+    const bool allow_nonconst_timezone_arguments;
 public:
-    FunctionFromUnixTimestamp64(size_t target_scale_, const char * name_)
-        : target_scale(target_scale_), name(name_)
-    {
-    }
+    FunctionFromUnixTimestamp64(size_t target_scale_, const char * name_, ContextPtr context)
+        : target_scale(target_scale_)
+        , name(name_)
+        , allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     String getName() const override { return name; }
     size_t getNumberOfArguments() const override { return 0; }
@@ -121,7 +124,7 @@ public:
 
         std::string timezone;
         if (arguments.size() == 2)
-            timezone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+            timezone = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, allow_nonconst_timezone_arguments);
 
         return std::make_shared<DataTypeDateTime64>(target_scale, timezone);
     }
diff --git a/src/Functions/FunctionsConversion.h b/src/Functions/FunctionsConversion.h
index 940585d6d57..87229b8ad04 100644
--- a/src/Functions/FunctionsConversion.h
+++ b/src/Functions/FunctionsConversion.h
@@ -1796,13 +1796,13 @@ public:
 
                 if (to_datetime64 || scale != 0) /// toDateTime('xxxx-xx-xx xx:xx:xx', 0) return DateTime
                     return std::make_shared<DataTypeDateTime64>(scale,
-                        extractTimeZoneNameFromFunctionArguments(arguments, timezone_arg_position, 0));
+                        extractTimeZoneNameFromFunctionArguments(arguments, timezone_arg_position, 0, false));
 
-                return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, timezone_arg_position, 0));
+                return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, timezone_arg_position, 0, false));
             }
 
             if constexpr (std::is_same_v<ToDataType, DataTypeDateTime>)
-                return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, timezone_arg_position, 0));
+                return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, timezone_arg_position, 0, false));
             else if constexpr (std::is_same_v<ToDataType, DataTypeDateTime64>)
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "Unexpected branch in code of conversion function: it is a bug.");
             else
@@ -2067,7 +2067,7 @@ public:
             UInt64 scale = to_datetime64 ? DataTypeDateTime64::default_scale : 0;
             if (arguments.size() > 1)
                 scale = extractToDecimalScale(arguments[1]);
-            const auto timezone = extractTimeZoneNameFromFunctionArguments(arguments, 2, 0);
+            const auto timezone = extractTimeZoneNameFromFunctionArguments(arguments, 2, 0, false);
 
             res = scale == 0 ? res = std::make_shared<DataTypeDateTime>(timezone) : std::make_shared<DataTypeDateTime64>(scale, timezone);
         }
@@ -2117,7 +2117,7 @@ public:
             }
 
             if constexpr (std::is_same_v<ToDataType, DataTypeDateTime>)
-                res = std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 1, 0));
+                res = std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, false));
             else if constexpr (std::is_same_v<ToDataType, DataTypeDateTime64>)
                 throw Exception(ErrorCodes::LOGICAL_ERROR, "LOGICAL ERROR: It is a bug.");
             else if constexpr (to_decimal)
diff --git a/src/Functions/FunctionsTimeWindow.cpp b/src/Functions/FunctionsTimeWindow.cpp
index 8a57a4da692..231e8b6fa77 100644
--- a/src/Functions/FunctionsTimeWindow.cpp
+++ b/src/Functions/FunctionsTimeWindow.cpp
@@ -138,7 +138,7 @@ struct TimeWindowImpl<TUMBLE>
         if (result_type_is_date)
             data_type = std::make_shared<DataTypeDate>();
         else
-            data_type = std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 0));
+            data_type = std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 0, false));
 
         return std::make_shared<DataTypeTuple>(DataTypes{data_type, data_type});
     }
@@ -322,7 +322,7 @@ struct TimeWindowImpl<HOP>
         if (result_type_is_date)
             data_type = std::make_shared<DataTypeDate>();
         else
-            data_type = std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 3, 0));
+            data_type = std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 3, 0, false));
         return std::make_shared<DataTypeTuple>(DataTypes{data_type, data_type});
     }
 
diff --git a/src/Functions/date_trunc.cpp b/src/Functions/date_trunc.cpp
index 016b8f4da5e..414512fc4f8 100644
--- a/src/Functions/date_trunc.cpp
+++ b/src/Functions/date_trunc.cpp
@@ -107,7 +107,7 @@ public:
         if (result_type_is_date)
             return std::make_shared<DataTypeDate>();
         else
-            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 1));
+            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 1, false));
     }
 
     bool useDefaultImplementationForConstants() const override { return true; }
diff --git a/src/Functions/extractTimeZoneFromFunctionArguments.cpp b/src/Functions/extractTimeZoneFromFunctionArguments.cpp
index 7ed240fdbcf..7168c68c9c9 100644
--- a/src/Functions/extractTimeZoneFromFunctionArguments.cpp
+++ b/src/Functions/extractTimeZoneFromFunctionArguments.cpp
@@ -30,10 +30,11 @@ std::string extractTimeZoneNameFromColumn(const IColumn * column, const String &
 }
 
 
-std::string extractTimeZoneNameFromFunctionArguments(const ColumnsWithTypeAndName & arguments, size_t time_zone_arg_num, size_t datetime_arg_num)
+std::string extractTimeZoneNameFromFunctionArguments(const ColumnsWithTypeAndName & arguments, size_t time_zone_arg_num, size_t datetime_arg_num, bool allow_nonconst_timezone_arguments)
 {
     /// Explicit time zone may be passed in last argument.
-    if (arguments.size() == time_zone_arg_num + 1)
+    if ((arguments.size() == time_zone_arg_num + 1)
+       && (!allow_nonconst_timezone_arguments || arguments[time_zone_arg_num].column))
     {
         return extractTimeZoneNameFromColumn(arguments[time_zone_arg_num].column.get(), arguments[time_zone_arg_num].name);
     }
diff --git a/src/Functions/extractTimeZoneFromFunctionArguments.h b/src/Functions/extractTimeZoneFromFunctionArguments.h
index 858be40def7..3c012c64c49 100644
--- a/src/Functions/extractTimeZoneFromFunctionArguments.h
+++ b/src/Functions/extractTimeZoneFromFunctionArguments.h
@@ -16,8 +16,16 @@ std::string extractTimeZoneNameFromColumn(const IColumn * column, const String &
 
 /// Determine working timezone either from optional argument with time zone name or from time zone in DateTime type of argument.
 /// Returns empty string if default time zone should be used.
+///
+/// Parameter allow_nonconst_timezone_arguments toggles if non-const timezone function arguments are accepted (legacy behavior) or not. The
+/// problem with the old behavior is that the timezone is part of the type, and not part of the value. This lead to confusion and unexpected
+/// results.
+/// - For new functions, set allow_nonconst_timezone_arguments = false.
+/// - For existing functions
+///    - which disallow non-const timezone arguments anyways (e.g. getArgumentsThatAreAlwaysConstant()), set allow_nonconst_timezone_arguments = false,
+///    - which allow non-const timezone arguments, set allow_nonconst_timezone_arguments according to the corresponding setting.
 std::string extractTimeZoneNameFromFunctionArguments(
-    const ColumnsWithTypeAndName & arguments, size_t time_zone_arg_num, size_t datetime_arg_num);
+    const ColumnsWithTypeAndName & arguments, size_t time_zone_arg_num, size_t datetime_arg_num, bool allow_nonconst_timezone_arguments);
 
 const DateLUTImpl & extractTimeZoneFromFunctionArguments(
     const ColumnsWithTypeAndName & arguments, size_t time_zone_arg_num, size_t datetime_arg_num);
diff --git a/src/Functions/fromUnixTimestamp64Micro.cpp b/src/Functions/fromUnixTimestamp64Micro.cpp
index 70dcbcd1d4b..191e2137a0d 100644
--- a/src/Functions/fromUnixTimestamp64Micro.cpp
+++ b/src/Functions/fromUnixTimestamp64Micro.cpp
@@ -7,8 +7,8 @@ namespace DB
 REGISTER_FUNCTION(FromUnixTimestamp64Micro)
 {
     factory.registerFunction("fromUnixTimestamp64Micro",
-        [](ContextPtr){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
-            std::make_shared<FunctionFromUnixTimestamp64>(6, "fromUnixTimestamp64Micro")); });
+        [](ContextPtr context){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+            std::make_shared<FunctionFromUnixTimestamp64>(6, "fromUnixTimestamp64Micro", context)); });
 }
 
 }
diff --git a/src/Functions/fromUnixTimestamp64Milli.cpp b/src/Functions/fromUnixTimestamp64Milli.cpp
index 532013dfe5f..c6d4fcd30a2 100644
--- a/src/Functions/fromUnixTimestamp64Milli.cpp
+++ b/src/Functions/fromUnixTimestamp64Milli.cpp
@@ -7,8 +7,8 @@ namespace DB
 REGISTER_FUNCTION(FromUnixTimestamp64Milli)
 {
     factory.registerFunction("fromUnixTimestamp64Milli",
-        [](ContextPtr){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
-            std::make_shared<FunctionFromUnixTimestamp64>(3, "fromUnixTimestamp64Milli")); });
+        [](ContextPtr context){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+            std::make_shared<FunctionFromUnixTimestamp64>(3, "fromUnixTimestamp64Milli", context)); });
 }
 
 }
diff --git a/src/Functions/fromUnixTimestamp64Nano.cpp b/src/Functions/fromUnixTimestamp64Nano.cpp
index 96afdda0fa8..2b5a7addbfc 100644
--- a/src/Functions/fromUnixTimestamp64Nano.cpp
+++ b/src/Functions/fromUnixTimestamp64Nano.cpp
@@ -7,8 +7,8 @@ namespace DB
 REGISTER_FUNCTION(FromUnixTimestamp64Nano)
 {
     factory.registerFunction("fromUnixTimestamp64Nano",
-        [](ContextPtr){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
-            std::make_shared<FunctionFromUnixTimestamp64>(9, "fromUnixTimestamp64Nano")); });
+        [](ContextPtr context){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+            std::make_shared<FunctionFromUnixTimestamp64>(9, "fromUnixTimestamp64Nano", context)); });
 }
 
 }
diff --git a/src/Functions/now.cpp b/src/Functions/now.cpp
index 3c3bff1524f..d3a94379a61 100644
--- a/src/Functions/now.cpp
+++ b/src/Functions/now.cpp
@@ -5,6 +5,7 @@
 #include <Functions/FunctionFactory.h>
 #include <Functions/IFunction.h>
 #include <Functions/extractTimeZoneFromFunctionArguments.h>
+#include <Interpreters/Context.h>
 
 namespace DB
 {
@@ -87,7 +88,10 @@ public:
     bool isVariadic() const override { return true; }
 
     size_t getNumberOfArguments() const override { return 0; }
-    static FunctionOverloadResolverPtr create(ContextPtr) { return std::make_unique<NowOverloadResolver>(); }
+    static FunctionOverloadResolverPtr create(ContextPtr context) { return std::make_unique<NowOverloadResolver>(context); }
+    explicit NowOverloadResolver(ContextPtr context)
+        : allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     DataTypePtr getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const override
     {
@@ -102,7 +106,7 @@ public:
         }
         if (arguments.size() == 1)
         {
-            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 0, 0));
+            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 0, 0, allow_nonconst_timezone_arguments));
         }
         return std::make_shared<DataTypeDateTime>();
     }
@@ -121,10 +125,12 @@ public:
         if (arguments.size() == 1)
             return std::make_unique<FunctionBaseNow>(
                 time(nullptr), DataTypes{arguments.front().type},
-                std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 0, 0)));
+                std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 0, 0, allow_nonconst_timezone_arguments)));
 
         return std::make_unique<FunctionBaseNow>(time(nullptr), DataTypes(), std::make_shared<DataTypeDateTime>());
     }
+private:
+    const bool allow_nonconst_timezone_arguments;
 };
 
 }
diff --git a/src/Functions/now64.cpp b/src/Functions/now64.cpp
index f29b73061d9..349b8c71145 100644
--- a/src/Functions/now64.cpp
+++ b/src/Functions/now64.cpp
@@ -5,6 +5,7 @@
 #include <Functions/FunctionFactory.h>
 #include <Functions/extractTimeZoneFromFunctionArguments.h>
 #include <DataTypes/DataTypeNullable.h>
+#include <Interpreters/Context.h>
 
 #include <Common/assert_cast.h>
 
@@ -115,7 +116,10 @@ public:
     bool isVariadic() const override { return true; }
 
     size_t getNumberOfArguments() const override { return 0; }
-    static FunctionOverloadResolverPtr create(ContextPtr) { return std::make_unique<Now64OverloadResolver>(); }
+    static FunctionOverloadResolverPtr create(ContextPtr context) { return std::make_unique<Now64OverloadResolver>(context); }
+    explicit Now64OverloadResolver(ContextPtr context)
+        : allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     DataTypePtr getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const override
     {
@@ -137,7 +141,7 @@ public:
         }
         if (arguments.size() == 2)
         {
-            timezone_name = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+            timezone_name = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, allow_nonconst_timezone_arguments);
         }
 
         return std::make_shared<DataTypeDateTime64>(scale, timezone_name);
@@ -157,6 +161,8 @@ public:
 
         return std::make_unique<FunctionBaseNow64>(nowSubsecond(scale), std::move(arg_types), result_type);
     }
+private:
+    const bool allow_nonconst_timezone_arguments;
 };
 
 }
diff --git a/src/Functions/nowInBlock.cpp b/src/Functions/nowInBlock.cpp
index dfb3ed7c34a..0d5f9c45780 100644
--- a/src/Functions/nowInBlock.cpp
+++ b/src/Functions/nowInBlock.cpp
@@ -4,6 +4,7 @@
 #include <DataTypes/DataTypeDateTime.h>
 #include <Columns/ColumnsDateTime.h>
 #include <Columns/ColumnVector.h>
+#include <Interpreters/Context.h>
 
 
 namespace DB
@@ -25,10 +26,13 @@ class FunctionNowInBlock : public IFunction
 {
 public:
     static constexpr auto name = "nowInBlock";
-    static FunctionPtr create(ContextPtr)
+    static FunctionPtr create(ContextPtr context)
     {
-        return std::make_shared<FunctionNowInBlock>();
+        return std::make_shared<FunctionNowInBlock>(context);
     }
+    explicit FunctionNowInBlock(ContextPtr context)
+        : allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     String getName() const override
     {
@@ -68,7 +72,7 @@ public:
         }
         if (arguments.size() == 1)
         {
-            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 0, 0));
+            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 0, 0, allow_nonconst_timezone_arguments));
         }
         return std::make_shared<DataTypeDateTime>();
     }
@@ -77,6 +81,8 @@ public:
     {
         return ColumnDateTime::create(input_rows_count, static_cast<UInt32>(time(nullptr)));
     }
+private:
+    const bool allow_nonconst_timezone_arguments;
 };
 
 }
diff --git a/src/Functions/snowflake.cpp b/src/Functions/snowflake.cpp
index 4849d6512ca..ca78945acb9 100644
--- a/src/Functions/snowflake.cpp
+++ b/src/Functions/snowflake.cpp
@@ -21,14 +21,14 @@ REGISTER_FUNCTION(DateTime64ToSnowflake)
 REGISTER_FUNCTION(SnowflakeToDateTime)
 {
     factory.registerFunction("snowflakeToDateTime",
-        [](ContextPtr){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
-            std::make_shared<FunctionSnowflakeToDateTime>("snowflakeToDateTime")); });
+        [](ContextPtr context ){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+            std::make_shared<FunctionSnowflakeToDateTime>("snowflakeToDateTime", context)); });
 }
 REGISTER_FUNCTION(SnowflakeToDateTime64)
 {
     factory.registerFunction("snowflakeToDateTime64",
-        [](ContextPtr){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
-            std::make_shared<FunctionSnowflakeToDateTime64>("snowflakeToDateTime64")); });
+        [](ContextPtr context){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+            std::make_shared<FunctionSnowflakeToDateTime64>("snowflakeToDateTime64", context)); });
 }
 
 }
diff --git a/src/Functions/timeSlots.cpp b/src/Functions/timeSlots.cpp
index 568ab5e5a47..040495ab023 100644
--- a/src/Functions/timeSlots.cpp
+++ b/src/Functions/timeSlots.cpp
@@ -270,14 +270,14 @@ public:
         /// Note that there is no explicit time zone argument for this function (we specify 2 as an argument number with explicit time zone).
         if (WhichDataType(arguments[0].type).isDateTime())
         {
-            return std::make_shared<DataTypeArray>(std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 3, 0)));
+            return std::make_shared<DataTypeArray>(std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 3, 0, false)));
         }
         else
         {
             auto start_time_scale = assert_cast<const DataTypeDateTime64 &>(*arguments[0].type).getScale();
             auto duration_scale = assert_cast<const DataTypeDecimal64 &>(*arguments[1].type).getScale();
             return std::make_shared<DataTypeArray>(
-                std::make_shared<DataTypeDateTime64>(std::max(start_time_scale, duration_scale), extractTimeZoneNameFromFunctionArguments(arguments, 3, 0)));
+                std::make_shared<DataTypeDateTime64>(std::max(start_time_scale, duration_scale), extractTimeZoneNameFromFunctionArguments(arguments, 3, 0, false)));
         }
 
     }
diff --git a/src/Functions/toStartOfInterval.cpp b/src/Functions/toStartOfInterval.cpp
index c0220f1aed2..649242d0d86 100644
--- a/src/Functions/toStartOfInterval.cpp
+++ b/src/Functions/toStartOfInterval.cpp
@@ -384,7 +384,7 @@ public:
         if (result_type_is_date)
             return std::make_shared<DataTypeDate>();
         else if (result_type_is_datetime)
-            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 0));
+            return std::make_shared<DataTypeDateTime>(extractTimeZoneNameFromFunctionArguments(arguments, 2, 0, false));
         else
         {
             auto scale = 0;
@@ -396,7 +396,7 @@ public:
             else if (interval_type->getKind() == IntervalKind::Millisecond)
                 scale = 3;
 
-            return std::make_shared<DataTypeDateTime64>(scale, extractTimeZoneNameFromFunctionArguments(arguments, 2, 0));
+            return std::make_shared<DataTypeDateTime64>(scale, extractTimeZoneNameFromFunctionArguments(arguments, 2, 0, false));
         }
 
     }
diff --git a/src/Functions/toTimezone.cpp b/src/Functions/toTimezone.cpp
index 0a54e5a86b7..a0d90351898 100644
--- a/src/Functions/toTimezone.cpp
+++ b/src/Functions/toTimezone.cpp
@@ -5,6 +5,8 @@
 #include <Functions/FunctionFactory.h>
 #include <Functions/extractTimeZoneFromFunctionArguments.h>
 
+#include <Interpreters/Context.h>
+
 #include <IO/WriteHelpers.h>
 #include <Common/assert_cast.h>
 
@@ -84,7 +86,10 @@ public:
     String getName() const override { return name; }
 
     size_t getNumberOfArguments() const override { return 2; }
-    static FunctionOverloadResolverPtr create(ContextPtr) { return std::make_unique<ToTimeZoneOverloadResolver>(); }
+    static FunctionOverloadResolverPtr create(ContextPtr context) { return std::make_unique<ToTimeZoneOverloadResolver>(context); }
+    explicit ToTimeZoneOverloadResolver(ContextPtr context)
+        : allow_nonconst_timezone_arguments(context->getSettings().allow_nonconst_timezone_arguments)
+    {}
 
     DataTypePtr getReturnTypeImpl(const ColumnsWithTypeAndName & arguments) const override
     {
@@ -98,7 +103,7 @@ public:
             throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal type {} of argument of function {}. "
                 "Should be DateTime or DateTime64", arguments[0].type->getName(), getName());
 
-        String time_zone_name = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0);
+        String time_zone_name = extractTimeZoneNameFromFunctionArguments(arguments, 1, 0, allow_nonconst_timezone_arguments);
 
         if (which_type.isDateTime())
             return std::make_shared<DataTypeDateTime>(time_zone_name);
@@ -119,6 +124,8 @@ public:
 
         return std::make_unique<FunctionBaseToTimeZone>(is_constant_timezone, data_types, result_type);
     }
+private:
+    const bool allow_nonconst_timezone_arguments;
 };
 
 }
diff --git a/tests/queries/0_stateless/00515_enhanced_time_zones.reference b/tests/queries/0_stateless/00515_enhanced_time_zones.reference
index ad0dae35c45..2ee2c3eac81 100644
--- a/tests/queries/0_stateless/00515_enhanced_time_zones.reference
+++ b/tests/queries/0_stateless/00515_enhanced_time_zones.reference
@@ -16,3 +16,10 @@
 2017-11-05 08:07:47
 2017-11-05 10:37:47
 2017-11-05 10:37:47
+-- Test const/non-const timezone arguments --
+Asia/Kolkata	2017-11-05 08:07:47
+42	Asia/Kolkata	1970-01-01 00:00:00.042
+42	Asia/Kolkata	1970-01-01 00:00:00.000042
+42	Asia/Kolkata	1970-01-01 00:00:00.000000042
+42	Asia/Kolkata	2010-11-04 01:42:54
+42	Asia/Kolkata	2010-11-04 01:42:54.657
diff --git a/tests/queries/0_stateless/00515_enhanced_time_zones.sql b/tests/queries/0_stateless/00515_enhanced_time_zones.sql
index f719ff70d7a..7659b6e4603 100644
--- a/tests/queries/0_stateless/00515_enhanced_time_zones.sql
+++ b/tests/queries/0_stateless/00515_enhanced_time_zones.sql
@@ -21,16 +21,46 @@ SELECT toString(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'));
 SELECT toString(toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), 'Asia/Kolkata'));
 SELECT toString(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), 'Asia/Kolkata');
 
-SELECT toTimeZone(dt, tz) FROM (
-    SELECT toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul') AS dt, arrayJoin(['Asia/Kolkata', 'UTC']) AS tz
-); -- { serverError ILLEGAL_COLUMN }
-SELECT materialize('Asia/Kolkata') t, toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), t); -- { serverError ILLEGAL_COLUMN }
+SELECT '-- Test const/non-const timezone arguments --';
 
-CREATE TEMPORARY TABLE tmp AS SELECT arrayJoin(['Europe/Istanbul', 'Asia/Istanbul']);
-SELECT toTimeZone(now(), (*,).1) FROM tmp; -- { serverError ILLEGAL_COLUMN }
-SELECT now((*,).1) FROM tmp; -- { serverError ILLEGAL_COLUMN }
-SELECT now64(1, (*,).1) FROM tmp; -- { serverError ILLEGAL_COLUMN }
-SELECT toStartOfInterval(now(), INTERVAL 3 HOUR, (*,).1) FROM tmp; -- { serverError ILLEGAL_COLUMN }
-SELECT snowflakeToDateTime(toInt64(123), (*,).1) FROM tmp; -- { serverError ILLEGAL_COLUMN }
-SELECT toUnixTimestamp(now(), (*,).1) FROM tmp; -- { serverError ILLEGAL_COLUMN }
-SELECT toDateTimeOrDefault('2023-04-12 16:43:32', (*,).1, now()) FROM tmp; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize('Asia/Kolkata') tz, toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize('Asia/Kolkata') tz, toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize('Asia/Kolkata') tz, now(tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+-- SELECT materialize('Asia/Kolkata') tz, now(tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize('Asia/Kolkata') tz, now64(9, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+-- SELECT materialize('Asia/Kolkata') tz, now64(9, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize('Asia/Kolkata') tz, nowInBlock(tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+-- SELECT materialize('Asia/Kolkata') tz, nowInBlock(tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Milli(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Milli(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Micro(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Micro(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Nano(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Nano(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime(ts, tz) settings allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime(ts, tz) settings allow_nonconst_timezone_arguments = 1;
+
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime64(ts, tz) settings allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime64(ts, tz) settings allow_nonconst_timezone_arguments = 1;
+
+-- test for a related bug:
+
+DROP TABLE IF EXISTS tab;
+
+SET allow_nonconst_timezone_arguments = 1;
+
+CREATE TABLE tab (`country` LowCardinality(FixedString(7)) DEFAULT 'unknown', `city` LowCardinality(String) DEFAULT 'unknown', `region` LowCardinality(String) DEFAULT 'unknown', `continent` LowCardinality(FixedString(7)) DEFAULT 'unknown', `is_eu_country` Bool, `date` DateTime CODEC(DoubleDelta, LZ4), `viewer_date` DateTime ALIAS toTimezone(date, timezone), `device_browser` LowCardinality(String) DEFAULT 'unknown', `metro_code` LowCardinality(String) DEFAULT 'unknown', `domain` String DEFAULT 'unknown', `device_platform` LowCardinality(String) DEFAULT 'unknown', `device_type` LowCardinality(String) DEFAULT 'unknown', `device_vendor` LowCardinality(String) DEFAULT 'unknown', `ip` FixedString(39) DEFAULT 'unknown', `lat` Decimal(8, 6) CODEC(T64), `lng` Decimal(9, 6) CODEC(T64), `asset_id` String DEFAULT 'unknown', `is_personalized` Bool, `metric` String, `origin` String DEFAULT 'unknown', `product_id` UInt64 CODEC(T64), `referer` String DEFAULT 'unknown', `server_side` Int8 CODEC(T64), `third_party_id` String DEFAULT 'unknown', `partner_slug` LowCardinality(FixedString(10)) DEFAULT 'unknown', `user_agent` String DEFAULT 'unknown', `user_id` UUID, `zip` FixedString(10) DEFAULT 'unknown', `timezone` LowCardinality(String), `as_organization` LowCardinality(String) DEFAULT 'unknown', `content_cat` Array(String), `playback_method` LowCardinality(String) DEFAULT 'unknown', `store_id` LowCardinality(String) DEFAULT 'unknown', `store_url` String DEFAULT 'unknown', `timestamp` Nullable(DateTime), `ad_count` Int8 CODEC(T64), `ad_type` LowCardinality(FixedString(10)) DEFAULT 'unknown', `ad_categories` Array(FixedString(8)), `blocked_ad_categories` Array(FixedString(8)), `break_max_ad_length` Int8 CODEC(T64), `break_max_ads` Int8 CODEC(T64), `break_max_duration` Int8 CODEC(T64), `break_min_ad_length` Int8 CODEC(T64), `break_position` LowCardinality(FixedString(18)) DEFAULT 'unknown', `media_playhead` String DEFAULT 'unknown', `placement_type` Int8 CODEC(T64), `transaction_id` String, `universal_ad_id` Array(String), `client_ua` LowCardinality(String) DEFAULT 'unknown', `device_ip` FixedString(39) DEFAULT 'unknown', `device_ua` LowCardinality(String) DEFAULT 'unknown', `ifa` String, `ifa_type` LowCardinality(String) DEFAULT 'unknown', `vast_lat` Decimal(8, 6) CODEC(T64), `vast_long` Decimal(9, 6) CODEC(T64), `server_ua` String DEFAULT 'unknown', `app_bundle` String DEFAULT 'unknown', `page_url` String DEFAULT 'unknown', `api_framework` Array(UInt8), `click_type` LowCardinality(String), `extensions` Array(String), `media_mime` Array(String), `om_id_partner` LowCardinality(String) DEFAULT 'unknown', `player_capabilities` Array(FixedString(12)), `vast_versions` Array(UInt8), `verification_vendors` Array(String), `ad_play_head` String DEFAULT 'unknown', `ad_serving_id` String DEFAULT 'unknown', `asset_uri` String DEFAULT 'unknown', `content_id` String DEFAULT 'unknown', `content_uri` String DEFAULT 'unknown', `inventory_state` Array(FixedString(14)), `player_size` Array(UInt8), `player_state` Array(FixedString(12)), `pod_sequence` Int8 CODEC(T64), `click_position` Array(UInt32), `error_code` Int16 CODEC(T64), `error_reason` Int8 CODEC(T64), `gdpr_consent` String DEFAULT 'unknown', `limited_tracking` Bool, `regulations` String DEFAULT 'unknown', `content_category` Array(String), PROJECTION projection_TPAG_VAST_date (SELECT * ORDER BY toYYYYMMDD(date), metric, product_id, asset_id)) ENGINE = MergeTree ORDER BY (product_id, metric, asset_id, toYYYYMMDD(date));
+
+DETACH TABLE tab;
+
+ATTACH TABLE tab SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+ATTACH TABLE tab SETTINGS allow_nonconst_timezone_arguments = 1;
+
+DROP TABLE tab;

From ffb941624bc971886212e0745716e79688a154a1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sat, 10 Jun 2023 17:01:44 +0000
Subject: [PATCH 316/722] Exclude some tests with QPL from fasttest

---
 .../0_stateless/00804_test_alter_compression_codecs.sql        | 3 +++
 .../0_stateless/00804_test_custom_compression_codecs.sql       | 3 +++
 .../00804_test_custom_compression_codes_log_storages.sql       | 3 +++
 .../0_stateless/00804_test_deflate_qpl_codec_compression.sql   | 3 +++
 4 files changed, 12 insertions(+)

diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
index fd9855e82d3..eb1abda9a21 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
@@ -1,3 +1,6 @@
+--Tags: no-fasttest
+-- no-fasttest because DEFLATE_QPL isn't available in fasttest
+
 SET send_logs_level = 'fatal';
 
 DROP TABLE IF EXISTS alter_compression_codec;
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
index 89e77f758a7..df74620a201 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
@@ -1,3 +1,6 @@
+--Tags: no-fasttest
+-- no-fasttest because DEFLATE_QPL isn't available in fasttest
+
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
 SET enable_deflate_qpl_codec = 1;
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
index a629df2666d..67c0074c58f 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
@@ -1,3 +1,6 @@
+--Tags: no-fasttest
+-- no-fasttest because DEFLATE_QPL isn't available in fasttest
+
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
 SET enable_deflate_qpl_codec = 1;
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index 5a56fc0d576..a46272112a9 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -1,3 +1,6 @@
+--Tags: no-fasttest
+-- no-fasttest because DEFLATE_QPL isn't available in fasttest
+
 SET send_logs_level = 'fatal';
 SET enable_deflate_qpl_codec = 1;
 

From a3da7c8ebe33977cacf6f67f5b1a75833de9aa64 Mon Sep 17 00:00:00 2001
From: Antonio Andelic <antonio@clickhouse.com>
Date: Sat, 10 Jun 2023 17:20:29 +0000
Subject: [PATCH 317/722] Merged NuRaft

---
 contrib/NuRaft | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/NuRaft b/contrib/NuRaft
index 8f267da1a91..491eaf592d9 160000
--- a/contrib/NuRaft
+++ b/contrib/NuRaft
@@ -1 +1 @@
-Subproject commit 8f267da1a91310bd152af755b0178cfd38c646c7
+Subproject commit 491eaf592d950e0e37accbe8b3f217e068c9fecf

From 296b11a1aeaa069b56fb2befd3b933c984b20a1b Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Sat, 10 Jun 2023 20:56:54 +0000
Subject: [PATCH 318/722] Update version_date.tsv and changelogs after
 v23.5.2.7-stable

---
 docker/keeper/Dockerfile             |  2 +-
 docker/server/Dockerfile.alpine      |  2 +-
 docker/server/Dockerfile.ubuntu      |  2 +-
 docs/changelogs/v23.5.2.7-stable.md  | 18 ++++++++++++++++++
 utils/list-versions/version_date.tsv |  1 +
 5 files changed, 22 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v23.5.2.7-stable.md

diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 7190ef4d649..44967af4b32 100644
--- a/docker/keeper/Dockerfile
+++ b/docker/keeper/Dockerfile
@@ -32,7 +32,7 @@ RUN arch=${TARGETARCH:-amd64} \
     esac
 
 ARG REPOSITORY="https://s3.amazonaws.com/clickhouse-builds/22.4/31c367d3cd3aefd316778601ff6565119fe36682/package_release"
-ARG VERSION="23.5.1.3174"
+ARG VERSION="23.5.2.7"
 ARG PACKAGES="clickhouse-keeper"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.alpine b/docker/server/Dockerfile.alpine
index ca966b16a2d..8ab9bf7b077 100644
--- a/docker/server/Dockerfile.alpine
+++ b/docker/server/Dockerfile.alpine
@@ -33,7 +33,7 @@ RUN arch=${TARGETARCH:-amd64} \
 # lts / testing / prestable / etc
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="https://packages.clickhouse.com/tgz/${REPO_CHANNEL}"
-ARG VERSION="23.5.1.3174"
+ARG VERSION="23.5.2.7"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index c82ac592120..b3b0cfe1510 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -22,7 +22,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.1.3174"
+ARG VERSION="23.5.2.7"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # set non-empty deb_location_url url to create a docker image
diff --git a/docs/changelogs/v23.5.2.7-stable.md b/docs/changelogs/v23.5.2.7-stable.md
new file mode 100644
index 00000000000..2e4931c64e0
--- /dev/null
+++ b/docs/changelogs/v23.5.2.7-stable.md
@@ -0,0 +1,18 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.5.2.7-stable (5751aa1ab9f) FIXME as compared to v23.5.1.3174-stable (2fec796e73e)
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Do not read all the columns from right GLOBAL JOIN table. [#50721](https://github.com/ClickHouse/ClickHouse/pull/50721) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Fix build for aarch64 (temporary disable azure) [#50770](https://github.com/ClickHouse/ClickHouse/pull/50770) ([alesapin](https://github.com/alesapin)).
+* Rename azure_blob_storage to azureBlobStorage [#50812](https://github.com/ClickHouse/ClickHouse/pull/50812) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 2aeeb5db35c..4647bcb4af1 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,3 +1,4 @@
+v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27

From 78c32a204ce656c278433fed92fb535584b8ee3b Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Sat, 10 Jun 2023 23:00:59 +0200
Subject: [PATCH 319/722] Updated docs for azureBlobStorage Table function &
 engine

---
 .../integrations/azureBlobStorage.md          | 28 ++++++++
 .../table-functions/azureBlobStorage.md       | 70 +++++++++++++++++++
 .../table-functions/azure_blob_storage.md     | 11 ---
 3 files changed, 98 insertions(+), 11 deletions(-)
 create mode 100644 docs/en/engines/table-engines/integrations/azureBlobStorage.md
 create mode 100644 docs/en/sql-reference/table-functions/azureBlobStorage.md
 delete mode 100644 docs/en/sql-reference/table-functions/azure_blob_storage.md

diff --git a/docs/en/engines/table-engines/integrations/azureBlobStorage.md b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
new file mode 100644
index 00000000000..b1c6169592b
--- /dev/null
+++ b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
@@ -0,0 +1,28 @@
+---
+slug: /en/engines/table-engines/integrations/azureBlobStorage
+sidebar_position: 7
+sidebar_label: AzureBlobStorage
+---
+
+# AzureBlobStorage Table Engine
+
+This engine provides integration with  [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs) ecosystem.
+
+## Create Table {#creating-a-table}
+
+``` sql
+CREATE TABLE azure_blob_storage_table (name String, value UInt32)
+    ENGINE = AzureBlobStorage(connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression])
+    [PARTITION BY expr]
+    [SETTINGS ...]
+```
+
+**Engine parameters**
+
+- `connection_string|storage_account_url` — connection_string includes account name & key ([Create connection string](https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json&bc=%2Fazure%2Fstorage%2Fblobs%2Fbreadcrumb%2Ftoc.json#configure-a-connection-string-for-an-azure-storage-account)) or you could also provide the storage account url here and account name & account key as separate parameters (see parameters account_name & account_key)
+- `container_name` - Container name
+- `blobpath` - file path. Supports following wildcards in readonly mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc'`, `'def'` — strings.
+- `account_name` - if storage_account_url is used, then account name can be specified here
+- `account_key` - if storage_account_url is used, then account key can be specified here
+- `format` — The [format](../../interfaces/formats.md#formats) of the file.
+- `compression` — Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. By default, it will autodetect compression by file extension. (same as setting to `auto`).
diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
new file mode 100644
index 00000000000..f8a9016bd15
--- /dev/null
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -0,0 +1,70 @@
+---
+slug: /en/sql-reference/table-functions/azure_blob_storage
+sidebar_position: 45
+sidebar_label: azure_blob_storage
+keywords: [azure blob storage]
+---
+
+# azure\_blob\_storage Table Function
+
+Provides a table-like interface to select/insert files in [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs). This table function is similar to the [s3 function](../../sql-reference/table-functions/s3.md).
+
+**Syntax**
+
+``` sql
+azureBlobStorage(- connection_string|storage_account_url, container_name, blobpath, [account_name, account_key, format, compression, structure])
+```
+
+**Arguments**
+
+- `connection_string|storage_account_url` — connection_string includes account name & key ([Create connection string](https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json&bc=%2Fazure%2Fstorage%2Fblobs%2Fbreadcrumb%2Ftoc.json#configure-a-connection-string-for-an-azure-storage-account)) or you could also provide the storage account url here and account name & account key as separate parameters (see parameters account_name & account_key)
+- `container_name` - Container name
+- `blobpath` - file path. Supports following wildcards in readonly mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc'`, `'def'` — strings.
+- `account_name` - if storage_account_url is used, then account name can be specified here
+- `account_key` - if storage_account_url is used, then account key can be specified here
+- `format` — The [format](../../interfaces/formats.md#formats) of the file.
+- `compression` — Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. By default, it will autodetect compression by file extension. (same as setting to `auto`).
+- `structure` — Structure of the table. Format `'column1_name column1_type, column2_name column2_type, ...'`.
+
+**Returned value**
+
+A table with the specified structure for reading or writing data in the specified file.
+
+**Examples**
+
+Write data into azure blob storage using the following :
+
+```sql
+INSERT INTO TABLE FUNCTION azureBlobStorage('http://azurite1:10000/devstoreaccount1', 
+    'test_container', 'test_{_partition_id}.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==',
+    'CSV', 'auto', 'column1 UInt32, column2 UInt32, column3 UInt32') PARTITION BY column3 VALUES (1, 2, 3), (3, 2, 1), (78, 43, 3);
+```
+
+And then it can be read using 
+
+```sql
+SELECT * FROM azureBlobStorage('http://azurite1:10000/devstoreaccount1', 
+    'test_container', 'test_1.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 
+    'CSV', 'auto', 'column1 UInt32, column2 UInt32, column3 UInt32');
+```
+
+```response
+┌───column1─┬────column2─┬───column3─┐
+│     3     │       2    │      1    │
+└───────────┴────────────┴───────────┘
+```
+
+or with storage_account_url
+
+```sql
+SELECT count(*) FROM azureBlobStorage('DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;EndPointSuffix=core.windows.net',
+    'test_container', 'test_3.csv', 'CSV', 'auto' , 'column1 UInt32, column2 UInt32, column3 UInt32');
+```
+
+``` text
+┌─count()─┐
+│      2  │
+└─────────┘
+```
+
+ 
\ No newline at end of file
diff --git a/docs/en/sql-reference/table-functions/azure_blob_storage.md b/docs/en/sql-reference/table-functions/azure_blob_storage.md
deleted file mode 100644
index 6091aab5f9d..00000000000
--- a/docs/en/sql-reference/table-functions/azure_blob_storage.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-slug: /en/sql-reference/table-functions/azure_blob_storage
-sidebar_position: 45
-sidebar_label: azure_blob_storage
-keywords: [azure blob storage]
----
-
-# azureBlobStorage Table Function
-
-Provides a table-like interface to select/insert files in [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs). This table function is similar to the [s3 function](../../sql-reference/table-functions/s3.md).
-

From 05d4baf1e7186c902c9e44fe0f16e9cbbc18e5c0 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Sat, 10 Jun 2023 18:20:39 -0400
Subject: [PATCH 320/722] edits

---
 .../integrations/azureBlobStorage.md          | 15 +++++++------
 .../table-engines/integrations/index.md       | 21 +------------------
 .../table-functions/azureBlobStorage.md       |  5 +++--
 3 files changed, 13 insertions(+), 28 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/azureBlobStorage.md b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
index b1c6169592b..82b26e79579 100644
--- a/docs/en/engines/table-engines/integrations/azureBlobStorage.md
+++ b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
@@ -1,14 +1,13 @@
 ---
 slug: /en/engines/table-engines/integrations/azureBlobStorage
-sidebar_position: 7
-sidebar_label: AzureBlobStorage
+sidebar_label: Azure Blob Storage
 ---
 
 # AzureBlobStorage Table Engine
 
-This engine provides integration with  [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs) ecosystem.
+This engine provides an integration with [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs) ecosystem.
 
-## Create Table {#creating-a-table}
+## Create Table
 
 ``` sql
 CREATE TABLE azure_blob_storage_table (name String, value UInt32)
@@ -17,12 +16,16 @@ CREATE TABLE azure_blob_storage_table (name String, value UInt32)
     [SETTINGS ...]
 ```
 
-**Engine parameters**
+### Engine parameters
 
 - `connection_string|storage_account_url` — connection_string includes account name & key ([Create connection string](https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string?toc=%2Fazure%2Fstorage%2Fblobs%2Ftoc.json&bc=%2Fazure%2Fstorage%2Fblobs%2Fbreadcrumb%2Ftoc.json#configure-a-connection-string-for-an-azure-storage-account)) or you could also provide the storage account url here and account name & account key as separate parameters (see parameters account_name & account_key)
 - `container_name` - Container name
 - `blobpath` - file path. Supports following wildcards in readonly mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc'`, `'def'` — strings.
 - `account_name` - if storage_account_url is used, then account name can be specified here
 - `account_key` - if storage_account_url is used, then account key can be specified here
-- `format` — The [format](../../interfaces/formats.md#formats) of the file.
+- `format` — The [format](/docs/en/interfaces/formats.md) of the file.
 - `compression` — Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. By default, it will autodetect compression by file extension. (same as setting to `auto`).
+
+## See also
+
+[Azure Blob Storage Table Function](/docs/en/sql-reference/table-functions/azureBlobStorage.md)
diff --git a/docs/en/engines/table-engines/integrations/index.md b/docs/en/engines/table-engines/integrations/index.md
index b321a644d32..b9171d9033b 100644
--- a/docs/en/engines/table-engines/integrations/index.md
+++ b/docs/en/engines/table-engines/integrations/index.md
@@ -6,24 +6,5 @@ sidebar_label:  Integrations
 
 # Table Engines for Integrations
 
-ClickHouse provides various means for integrating with external systems, including table engines. Like with all other table engines, the configuration is done using `CREATE TABLE` or `ALTER TABLE` queries. Then from a user perspective, the configured integration looks like a normal table, but queries to it are proxied to the external system. This transparent querying is one of the key advantages of this approach over alternative integration methods, like dictionaries or table functions, which require to use custom query methods on each use.
+ClickHouse provides various means for integrating with external systems, including table engines. Like with all other table engines, the configuration is done using `CREATE TABLE` or `ALTER TABLE` queries. Then from a user perspective, the configured integration looks like a normal table, but queries to it are proxied to the external system. This transparent querying is one of the key advantages of this approach over alternative integration methods, like dictionaries or table functions, which require the use of custom query methods on each use.
 
-List of supported integrations:
-
-- [ODBC](../../../engines/table-engines/integrations/odbc.md)
-- [JDBC](../../../engines/table-engines/integrations/jdbc.md)
-- [MySQL](../../../engines/table-engines/integrations/mysql.md)
-- [MongoDB](../../../engines/table-engines/integrations/mongodb.md)
-- [HDFS](../../../engines/table-engines/integrations/hdfs.md)
-- [S3](../../../engines/table-engines/integrations/s3.md)
-- [Kafka](../../../engines/table-engines/integrations/kafka.md)
-- [EmbeddedRocksDB](../../../engines/table-engines/integrations/embedded-rocksdb.md)
-- [RabbitMQ](../../../engines/table-engines/integrations/rabbitmq.md)
-- [PostgreSQL](../../../engines/table-engines/integrations/postgresql.md)
-- [SQLite](../../../engines/table-engines/integrations/sqlite.md)
-- [Hive](../../../engines/table-engines/integrations/hive.md)
-- [ExternalDistributed](../../../engines/table-engines/integrations/ExternalDistributed.md)
-- [MaterializedPostgreSQL](../../../engines/table-engines/integrations/materialized-postgresql.md)
-- [NATS](../../../engines/table-engines/integrations/nats.md)
-- [DeltaLake](../../../engines/table-engines/integrations/deltalake.md)
-- [Hudi](../../../engines/table-engines/integrations/hudi.md)
diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
index f8a9016bd15..b79137cb786 100644
--- a/docs/en/sql-reference/table-functions/azureBlobStorage.md
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -1,6 +1,5 @@
 ---
 slug: /en/sql-reference/table-functions/azure_blob_storage
-sidebar_position: 45
 sidebar_label: azure_blob_storage
 keywords: [azure blob storage]
 ---
@@ -67,4 +66,6 @@ SELECT count(*) FROM azureBlobStorage('DefaultEndpointsProtocol=https;AccountNam
 └─────────┘
 ```
 
- 
\ No newline at end of file
+**See Also**
+
+- [AzureBlogStorage Table Engine](/docs/en/engines/table-engines/integrations/azureBlobStorage.md)

From 2146c356081fbe1b43da41ad4c739262f1db60c1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sun, 11 Jun 2023 07:40:39 +0000
Subject: [PATCH 321/722] Fix style

---
 src/Functions/snowflake.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Functions/snowflake.cpp b/src/Functions/snowflake.cpp
index ca78945acb9..c18f1c03332 100644
--- a/src/Functions/snowflake.cpp
+++ b/src/Functions/snowflake.cpp
@@ -21,7 +21,7 @@ REGISTER_FUNCTION(DateTime64ToSnowflake)
 REGISTER_FUNCTION(SnowflakeToDateTime)
 {
     factory.registerFunction("snowflakeToDateTime",
-        [](ContextPtr context ){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+        [](ContextPtr context){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
             std::make_shared<FunctionSnowflakeToDateTime>("snowflakeToDateTime", context)); });
 }
 REGISTER_FUNCTION(SnowflakeToDateTime64)

From e6c2a6d13db4604442f84e8e2cacf6bc617fc42e Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Sun, 11 Jun 2023 09:55:20 +0200
Subject: [PATCH 322/722] Added example for table engine and fixed typos

---
 .../integrations/azureBlobStorage.md          | 20 +++++++++++++++++++
 .../table-functions/azureBlobStorage.md       |  4 ++--
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/azureBlobStorage.md b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
index 82b26e79579..b8e621fd513 100644
--- a/docs/en/engines/table-engines/integrations/azureBlobStorage.md
+++ b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
@@ -26,6 +26,26 @@ CREATE TABLE azure_blob_storage_table (name String, value UInt32)
 - `format` — The [format](/docs/en/interfaces/formats.md) of the file.
 - `compression` — Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. By default, it will autodetect compression by file extension. (same as setting to `auto`).
 
+**Example**
+
+``` sql
+CREATE TABLE test_table (key UInt64, data String) 
+    ENGINE = AzureBlobStorage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 
+    'test_container', 'test_table', 'CSV');
+
+INSERT INTO test_table VALUES (1, 'a'), (2, 'b'), (3, 'c');
+
+SELECT * FROM test_table;
+```
+
+```text
+┌─key──┬─data──┐
+│  1   │   a   │
+│  2   │   b   │
+│  3   │   c   │
+└──────┴───────┘
+```
+
 ## See also
 
 [Azure Blob Storage Table Function](/docs/en/sql-reference/table-functions/azureBlobStorage.md)
diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
index b79137cb786..369bf7a964d 100644
--- a/docs/en/sql-reference/table-functions/azureBlobStorage.md
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -53,7 +53,7 @@ SELECT * FROM azureBlobStorage('http://azurite1:10000/devstoreaccount1',
 └───────────┴────────────┴───────────┘
 ```
 
-or with storage_account_url
+or using connection_string
 
 ```sql
 SELECT count(*) FROM azureBlobStorage('DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;EndPointSuffix=core.windows.net',
@@ -68,4 +68,4 @@ SELECT count(*) FROM azureBlobStorage('DefaultEndpointsProtocol=https;AccountNam
 
 **See Also**
 
-- [AzureBlogStorage Table Engine](/docs/en/engines/table-engines/integrations/azureBlobStorage.md)
+- [AzureBlobStorage Table Engine](/docs/en/engines/table-engines/integrations/azureBlobStorage.md)

From e9d539f4bd72d94cef27ed7f1a8a34cd6fa08322 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Sun, 11 Jun 2023 10:05:52 +0200
Subject: [PATCH 323/722] Updated changelog with azureBlobStorage table
 function & engine entry

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7142ad26e15..72372c8fac4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -21,6 +21,7 @@
 * Setting `enable_memory_bound_merging_of_aggregation_results` is enabled by default. If you update from version prior to 22.12, we recommend to set this flag to `false` until update is finished. [#50319](https://github.com/ClickHouse/ClickHouse/pull/50319) ([Nikita Taranov](https://github.com/nickitat)).
 
 #### New Feature
+* Added storage engine AzureBlobStorage and azureBlobStorage table function. The supported set of features is very similar to storage/table function S3 [#50604] (https://github.com/ClickHouse/ClickHouse/pull/50604) ([alesapin](https://github.com/alesapin)) ([SmitaRKulkarni](https://github.com/SmitaRKulkarni).
 * Added native ClickHouse Keeper CLI Client, it is available as `clickhouse keeper-client` [#47414](https://github.com/ClickHouse/ClickHouse/pull/47414) ([pufit](https://github.com/pufit)).
 * Add `urlCluster` table function. Refactor all *Cluster table functions to reduce code duplication. Make schema inference work for all possible *Cluster function signatures and for named collections. Closes [#38499](https://github.com/ClickHouse/ClickHouse/issues/38499). [#45427](https://github.com/ClickHouse/ClickHouse/pull/45427) ([attack204](https://github.com/attack204)), Pavel Kruglov.
 * The query cache can now be used for production workloads. [#47977](https://github.com/ClickHouse/ClickHouse/pull/47977) ([Robert Schulze](https://github.com/rschu1ze)). The query cache can now support queries with totals and extremes modifier. [#48853](https://github.com/ClickHouse/ClickHouse/pull/48853) ([Robert Schulze](https://github.com/rschu1ze)). Make `allow_experimental_query_cache` setting as obsolete for backward-compatibility. It was removed in https://github.com/ClickHouse/ClickHouse/pull/47977. [#49934](https://github.com/ClickHouse/ClickHouse/pull/49934) ([Timur Solodovnikov](https://github.com/tsolodov)).

From b4bc28b6de86c569bcdfe8d2de0e21ce1717a8c7 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 11 Jun 2023 16:48:29 +0300
Subject: [PATCH 324/722] Update easy_tasks_sorted_ru.md

---
 tests/instructions/easy_tasks_sorted_ru.md | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/tests/instructions/easy_tasks_sorted_ru.md b/tests/instructions/easy_tasks_sorted_ru.md
index a98a5766ffe..09ea48d0bd9 100644
--- a/tests/instructions/easy_tasks_sorted_ru.md
+++ b/tests/instructions/easy_tasks_sorted_ru.md
@@ -6,7 +6,7 @@
 
 Делаем `chmod 000 /etc/clickhouse-client/config.xml` и смотрим, что получится.
 
-## Уменьшать max_memory_usage, если на сервере мало оперативки.
+## + Уменьшать max_memory_usage, если на сервере мало оперативки.
 
 Смотрим, сколько на сервере оперативки. Если `max_memory_usage`, `max_memory_usage_for_all_queries` ограничены, но больше 90% (настройка) от имеющейся оперативки, то уменьшать их и выводить предупреждение в лог..
 
@@ -42,10 +42,12 @@ void memoryBitAnd(const char * a, const char * b, char * result, size_t size);
 
 В ClickHouse есть возможность указать collation для сортировки строк. Это не работает для `Nullable(String)`.
 
-## Запретить чтение значений типа AggregateFunction по-умолчанию и добавить настройку.
+## + Запретить чтение значений типа AggregateFunction по-умолчанию и добавить настройку.
 
 Состояния агрегатных функций могут быть записаны в дамп и считаны из него. Но десериализация состояний агрегатных функций небезопасна. Аккуратно выбранные пользовательские данные могут привести к segfault или порче памяти. Поэтому нужно просто сделать настройку, которая запрещает читать AggregateFunction из пользовательских данных.
 
+Upd: сделали по-другому: теперь всё безопасно.
+
 ## + В статистику jemalloc добавить информацию по arenas.
 
 В `system.asynchronous_metrics` - суммарный размер арен.
@@ -56,9 +58,9 @@ void memoryBitAnd(const char * a, const char * b, char * result, size_t size);
 
 Как cache, но без кэша — всегда прямой запрос в источник.
 
-## Функции randomFixedString, randomBinaryString, fuzzBits, fuzzBytes.
+## + Функции randomFixedString, randomBinaryString, fuzzBits, fuzzBytes.
 
-## Агрегатные функции для статистических тестов (e.g. тест нормальности распределения) и статистик.
+## + Агрегатные функции для статистических тестов (e.g. тест нормальности распределения) и статистик.
 
 ## + Функции создания и обновления состояния агрегатной функции по одному кортежу аргументов.
 
@@ -119,11 +121,11 @@ position с конца строки.
 
 Добавляем счётчики всех ошибок (ErrorCodes) по аналогии с ProfileEvents. Кроме количества запоминаем также время последней ошибки, стек трейс, сообщение. Добавляем системную таблицу system.errors. Отправка в Graphite.
 
-## Добавить Lizard, LZSSE и density в качестве вариантов алгоритмов сжатия.
+## + Добавить Lizard, LZSSE и density в качестве вариантов алгоритмов сжатия.
 
 Экспериментальные алгоритмы сжатия. Сейчас ClickHouse поддерживает только lz4 и zstd.
 
-## Запрос CREATE OR REPLACE TABLE
+## + Запрос CREATE OR REPLACE TABLE
 
 Атомарно удаляет таблицу перед созданием новой, если такая была.
 
@@ -149,12 +151,16 @@ https://clickhouse.com/docs/en/query_language/create/#create-table
 
 Запретить модификацию данных в партиции. На партицию ставится флаг, что она заблокирована. В неё нельзя делать INSERT и ALTER. С файлов снимается доступ на запись.
 
+Upd: не нужно.
+
 ## Настройка join_use_nulls: поддержка для LEFT ARRAY JOIN.
 
-## Внешние словари из Aerospike/Couchbase/Cassandra (на выбор).
+## + Внешние словари из Aerospike/Couchbase/Cassandra (на выбор).
 
 Подключить одну из key-value БД как источник.
 
+Upd: сделали Redis, Cassandra, MongoDB.
+
 ## + Движок таблиц Mongo, табличная функция mongo.
 
 Возможность легко импортировать данные из MongoDB.
@@ -181,7 +187,7 @@ https://clickhouse.com/docs/en/operations/table_engines/external_data/
 
 Не работает, если открыть clickhouse-client в интерактивном режиме и делать несколько запросов.
 
-## Настройка для возможности получить частичный результат при cancel-е.
+## + Настройка для возможности получить частичный результат при cancel-е.
 
 Хотим по Ctrl+C получить те данные, которые успели обработаться.
 

From 6bdbcd3f436f7f55e0ab71e24d0c96df072d0003 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sun, 11 Jun 2023 14:26:13 +0000
Subject: [PATCH 325/722] Stabilize tests

---
 .../00515_enhanced_time_zones.reference       | 26 ++++++++---
 .../0_stateless/00515_enhanced_time_zones.sql | 45 ++++++++++---------
 2 files changed, 44 insertions(+), 27 deletions(-)

diff --git a/tests/queries/0_stateless/00515_enhanced_time_zones.reference b/tests/queries/0_stateless/00515_enhanced_time_zones.reference
index 2ee2c3eac81..2555c885558 100644
--- a/tests/queries/0_stateless/00515_enhanced_time_zones.reference
+++ b/tests/queries/0_stateless/00515_enhanced_time_zones.reference
@@ -16,10 +16,22 @@
 2017-11-05 08:07:47
 2017-11-05 10:37:47
 2017-11-05 10:37:47
--- Test const/non-const timezone arguments --
-Asia/Kolkata	2017-11-05 08:07:47
-42	Asia/Kolkata	1970-01-01 00:00:00.042
-42	Asia/Kolkata	1970-01-01 00:00:00.000042
-42	Asia/Kolkata	1970-01-01 00:00:00.000000042
-42	Asia/Kolkata	2010-11-04 01:42:54
-42	Asia/Kolkata	2010-11-04 01:42:54.657
+-- Test const timezone arguments --
+42
+43
+42
+43
+42
+43
+42
+43
+42
+43
+42
+43
+42
+43
+42
+43
+42
+43
diff --git a/tests/queries/0_stateless/00515_enhanced_time_zones.sql b/tests/queries/0_stateless/00515_enhanced_time_zones.sql
index 7659b6e4603..5f40cfb53c1 100644
--- a/tests/queries/0_stateless/00515_enhanced_time_zones.sql
+++ b/tests/queries/0_stateless/00515_enhanced_time_zones.sql
@@ -21,38 +21,43 @@ SELECT toString(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'));
 SELECT toString(toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), 'Asia/Kolkata'));
 SELECT toString(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), 'Asia/Kolkata');
 
-SELECT '-- Test const/non-const timezone arguments --';
+SELECT '-- Test const timezone arguments --';
 
-SELECT materialize('Asia/Kolkata') tz, toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
-SELECT materialize('Asia/Kolkata') tz, toTimeZone(toDateTime('2017-11-05 08:07:47', 'Asia/Istanbul'), tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+DROP TABLE IF EXISTS tab;
 
-SELECT materialize('Asia/Kolkata') tz, now(tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
--- SELECT materialize('Asia/Kolkata') tz, now(tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+CREATE TABLE tab (val Int64, tz String) engine=Log;
+INSERT INTO tab VALUES (42, 'Asia/Singapore') (43, 'Asia/Tokyo');
 
-SELECT materialize('Asia/Kolkata') tz, now64(9, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
--- SELECT materialize('Asia/Kolkata') tz, now64(9, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE now(tz) != toDateTime('2000-01-01 00:00:00') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE now(tz) != toDateTime('2000-01-01 00:00:00') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
 
-SELECT materialize('Asia/Kolkata') tz, nowInBlock(tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
--- SELECT materialize('Asia/Kolkata') tz, nowInBlock(tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE now64(9, tz) != toDateTime64('2000-01-01 00:00:00', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE now64(9, tz) != toDateTime64('2000-01-01 00:00:00', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
 
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Milli(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Milli(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE nowInBlock(tz) != toDateTime('2000-01-01 00:00:00') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE nowInBlock(tz) != toDateTime('2000-01-01 00:00:00') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
 
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Micro(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Micro(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE toTimeZone(toDateTime(val), tz) != toDateTime('2023-06-11 14:14:14') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE toTimeZone(toDateTime(val), tz) != toDateTime('2023-06-11 14:14:14') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1; 
 
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Nano(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, fromUnixTimestamp64Nano(ts, tz) SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE fromUnixTimestamp64Milli(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE fromUnixTimestamp64Milli(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
 
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime(ts, tz) settings allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime(ts, tz) settings allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE fromUnixTimestamp64Micro(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE fromUnixTimestamp64Micro(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
 
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime64(ts, tz) settings allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
-SELECT materialize(42::Int64) ts, materialize('Asia/Kolkata') tz, snowflakeToDateTime64(ts, tz) settings allow_nonconst_timezone_arguments = 1;
+SELECT val FROM tab WHERE fromUnixTimestamp64Nano(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE fromUnixTimestamp64Nano(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT val FROM tab WHERE snowflakeToDateTime(val, tz) != toDateTime('2023-06-11 14:14:14') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE snowflakeToDateTime(val, tz) != toDateTime('2023-06-11 14:14:14') ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
+
+SELECT val FROM tab WHERE snowflakeToDateTime64(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 0; -- { serverError ILLEGAL_COLUMN }
+SELECT val FROM tab WHERE snowflakeToDateTime64(val, tz) != toDateTime64('2023-06-11 14:14:14', 6) ORDER BY val SETTINGS allow_nonconst_timezone_arguments = 1;
 
 -- test for a related bug:
 
-DROP TABLE IF EXISTS tab;
+DROP TABLE tab;
 
 SET allow_nonconst_timezone_arguments = 1;
 

From 48e03ac92a457d612dd8b2e4838dce1e47e51109 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sun, 11 Jun 2023 14:33:21 +0000
Subject: [PATCH 326/722] Revert "Exclude some tests with QPL from fasttest"

This reverts commit ffb941624bc971886212e0745716e79688a154a1.
---
 .../0_stateless/00804_test_alter_compression_codecs.sql        | 3 ---
 .../0_stateless/00804_test_custom_compression_codecs.sql       | 3 ---
 .../00804_test_custom_compression_codes_log_storages.sql       | 3 ---
 .../0_stateless/00804_test_deflate_qpl_codec_compression.sql   | 3 ---
 4 files changed, 12 deletions(-)

diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
index eb1abda9a21..fd9855e82d3 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
@@ -1,6 +1,3 @@
---Tags: no-fasttest
--- no-fasttest because DEFLATE_QPL isn't available in fasttest
-
 SET send_logs_level = 'fatal';
 
 DROP TABLE IF EXISTS alter_compression_codec;
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
index df74620a201..89e77f758a7 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
@@ -1,6 +1,3 @@
---Tags: no-fasttest
--- no-fasttest because DEFLATE_QPL isn't available in fasttest
-
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
 SET enable_deflate_qpl_codec = 1;
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
index 67c0074c58f..a629df2666d 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
@@ -1,6 +1,3 @@
---Tags: no-fasttest
--- no-fasttest because DEFLATE_QPL isn't available in fasttest
-
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
 SET enable_deflate_qpl_codec = 1;
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index a46272112a9..5a56fc0d576 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -1,6 +1,3 @@
---Tags: no-fasttest
--- no-fasttest because DEFLATE_QPL isn't available in fasttest
-
 SET send_logs_level = 'fatal';
 SET enable_deflate_qpl_codec = 1;
 

From d228411f41eabf7e443fbbb2f4148880a3da78fa Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sun, 11 Jun 2023 14:39:15 +0000
Subject: [PATCH 327/722] Reset modified tests

---
 ...04_test_alter_compression_codecs.reference | 17 ++-----
 .../00804_test_alter_compression_codecs.sql   | 22 +++-------
 ...4_test_custom_compression_codecs.reference |  8 ++--
 .../00804_test_custom_compression_codecs.sql  | 44 ++++++++-----------
 ...m_compression_codes_log_storages.reference | 20 ++++-----
 ..._custom_compression_codes_log_storages.sql | 41 ++++++++---------
 ...804_test_deflate_qpl_codec_compression.sql |  4 ++
 7 files changed, 63 insertions(+), 93 deletions(-)

diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference b/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
index 5c77a102740..cfbfadf1e67 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.reference
@@ -18,7 +18,7 @@ CODEC(NONE)
 2018-01-01	4	4
 2018-01-01	5	5
 2018-01-01	6	6
-CODEC(DEFLATE_QPL)
+CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, NONE)
 2018-01-01	1	default_value
 2018-01-01	2	default_value
 2018-01-01	3	3
@@ -27,18 +27,7 @@ CODEC(DEFLATE_QPL)
 2018-01-01	6	6
 2018-01-01	7	7
 2018-01-01	8	8
-CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, DEFLATE_QPL, NONE)
-2018-01-01	1	default_value
-2018-01-01	2	default_value
-2018-01-01	3	3
-2018-01-01	4	4
-2018-01-01	5	5
-2018-01-01	6	6
-2018-01-01	7	7
-2018-01-01	8	8
-2018-01-01	9	9
-2018-01-01	10	10
-CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, DEFLATE_QPL, NONE)
-CODEC(NONE, LZ4, LZ4HC(0), ZSTD(1), DEFLATE_QPL)
+CODEC(ZSTD(1), LZ4HC(0), LZ4, LZ4, NONE)
+CODEC(NONE, LZ4, LZ4HC(0), ZSTD(1))
 2
 1
diff --git a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
index fd9855e82d3..85e5f8b63ad 100644
--- a/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_alter_compression_codecs.sql
@@ -28,20 +28,12 @@ SELECT * FROM alter_compression_codec ORDER BY id;
 OPTIMIZE TABLE alter_compression_codec FINAL;
 SELECT * FROM alter_compression_codec ORDER BY id;
 
-SET enable_deflate_qpl_codec = 1;
-ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(DEFLATE_QPL);
+SET allow_suspicious_codecs = 1;
+ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(ZSTD, LZ4HC, LZ4, LZ4, NONE);
 SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
 
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 7, '7');
 INSERT INTO alter_compression_codec VALUES('2018-01-01', 8, '8');
-SELECT * FROM alter_compression_codec ORDER BY id;
-
-SET allow_suspicious_codecs = 1;
-ALTER TABLE alter_compression_codec MODIFY COLUMN alter_column CODEC(ZSTD, LZ4HC, LZ4, LZ4, DEFLATE_QPL, NONE);
-SELECT compression_codec FROM system.columns WHERE database = currentDatabase() AND table = 'alter_compression_codec' AND name = 'alter_column';
-
-INSERT INTO alter_compression_codec VALUES('2018-01-01', 9, '9');
-INSERT INTO alter_compression_codec VALUES('2018-01-01', 10, '10');
 OPTIMIZE TABLE alter_compression_codec FINAL;
 SELECT * FROM alter_compression_codec ORDER BY id;
 
@@ -62,17 +54,15 @@ ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01
 
 ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(ZSTD(100)); -- { serverError 433 }
 
-ALTER TABLE alter_bad_codec ADD COLUMN alter_column DateTime DEFAULT '2019-01-01 00:00:00' CODEC(DEFLATE_QPL(100)); -- { serverError DATA_TYPE_CANNOT_HAVE_ARGUMENTS }
-
 DROP TABLE IF EXISTS alter_bad_codec;
 
 DROP TABLE IF EXISTS large_alter_table_00804;
 DROP TABLE IF EXISTS store_of_hash_00804;
 
 CREATE TABLE large_alter_table_00804 (
-    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), DEFLATE_QPL),
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, DEFLATE_QPL),
-    data String CODEC(ZSTD(2), LZ4HC, NONE, LZ4, LZ4, DEFLATE_QPL)
+    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12)),
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC),
+    data String CODEC(ZSTD(2), LZ4HC, NONE, LZ4, LZ4)
 ) ENGINE = MergeTree() PARTITION BY somedate ORDER BY id SETTINGS index_granularity = 2, index_granularity_bytes = '10Mi', min_bytes_for_wide_part = 0;
 
 INSERT INTO large_alter_table_00804 SELECT toDate('2019-01-01'), number, toString(number + rand()) FROM system.numbers LIMIT 300000;
@@ -81,7 +71,7 @@ CREATE TABLE store_of_hash_00804 (hash UInt64) ENGINE = Memory();
 
 INSERT INTO store_of_hash_00804 SELECT sum(cityHash64(*)) FROM large_alter_table_00804;
 
-ALTER TABLE large_alter_table_00804 MODIFY COLUMN data CODEC(NONE, LZ4, LZ4HC, ZSTD, DEFLATE_QPL);
+ALTER TABLE large_alter_table_00804 MODIFY COLUMN data CODEC(NONE, LZ4, LZ4HC, ZSTD);
 
 OPTIMIZE TABLE large_alter_table_00804;
 
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference b/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
index 8b51d65004a..7bd91e5a69b 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.reference
@@ -1,6 +1,6 @@
-1	hello	2018-12-14	2018-12-14	1.1	aaa	5
-2	world	2018-12-15	2018-12-15	2.2	bbb	6
-3	!	2018-12-16	2018-12-16	3.3	ccc	7
+1	hello	2018-12-14	1.1	aaa	5
+2	world	2018-12-15	2.2	bbb	6
+3	!	2018-12-16	3.3	ccc	7
 2
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
@@ -9,7 +9,7 @@
 10003
 274972506.6
 9175437371954010821
-CREATE TABLE default.compression_codec_multiple_more_types\n(\n    `id` Decimal(38, 13) CODEC(ZSTD(1), LZ4, ZSTD(1), ZSTD(1), Delta(2), Delta(4), Delta(1), LZ4HC(0), DEFLATE_QPL),\n    `data` FixedString(12) CODEC(ZSTD(1), ZSTD(1), NONE, NONE, NONE, LZ4HC(0), DEFLATE_QPL),\n    `ddd.age` Array(UInt8) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8), DEFLATE_QPL),\n    `ddd.Name` Array(String) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8), DEFLATE_QPL)\n)\nENGINE = MergeTree\nORDER BY tuple()\nSETTINGS index_granularity = 8192
+CREATE TABLE default.compression_codec_multiple_more_types\n(\n    `id` Decimal(38, 13) CODEC(ZSTD(1), LZ4, ZSTD(1), ZSTD(1), Delta(2), Delta(4), Delta(1), LZ4HC(0)),\n    `data` FixedString(12) CODEC(ZSTD(1), ZSTD(1), NONE, NONE, NONE, LZ4HC(0)),\n    `ddd.age` Array(UInt8) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8)),\n    `ddd.Name` Array(String) CODEC(LZ4, LZ4HC(0), NONE, NONE, NONE, ZSTD(1), Delta(8))\n)\nENGINE = MergeTree\nORDER BY tuple()\nSETTINGS index_granularity = 8192
 1.5555555555555	hello world!	[77]	['John']
 7.1	xxxxxxxxxxxx	[127]	['Henry']
 !
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
index 89e77f758a7..c080c2fc98e 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codecs.sql
@@ -1,6 +1,5 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
-SET enable_deflate_qpl_codec = 1;
 
 DROP TABLE IF EXISTS compression_codec;
 
@@ -8,21 +7,20 @@ CREATE TABLE compression_codec(
     id UInt64 CODEC(LZ4),
     data String CODEC(ZSTD),
     ddd Date CODEC(NONE),
-    ddd32 Date32 CODEC(DEFLATE_QPL),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
-    othernum Int64 CODEC(Delta),
+    othernum Int64 CODEC(Delta)
 ) ENGINE = MergeTree() ORDER BY tuple();
 
-INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), toDate32('2018-12-14'), 1.1, 'aaa', 5);
-INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), toDate32('2018-12-15'), 2.2, 'bbb', 6);
-INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), toDate32('2018-12-16'), 3.3, 'ccc', 7);
+INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5);
+INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6);
+INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7);
 
 SELECT * FROM compression_codec ORDER BY id;
 
 OPTIMIZE TABLE compression_codec FINAL;
 
-INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), toDate32('2018-12-13'), 4.4, 'ddd', 8);
+INSERT INTO compression_codec VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8);
 
 DETACH TABLE compression_codec;
 ATTACH TABLE compression_codec;
@@ -33,31 +31,25 @@ DROP TABLE IF EXISTS compression_codec;
 
 DROP TABLE IF EXISTS bad_codec;
 DROP TABLE IF EXISTS params_when_no_params;
-DROP TABLE IF EXISTS params_when_no_params2;
 DROP TABLE IF EXISTS too_many_params;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_1;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_2;
-DROP TABLE IF EXISTS codec_multiple_direct_specification_3;
 DROP TABLE IF EXISTS delta_bad_params1;
 DROP TABLE IF EXISTS delta_bad_params2;
 
 CREATE TABLE bad_codec(id UInt64 CODEC(adssadads)) ENGINE = MergeTree() order by tuple(); -- { serverError 432 }
 CREATE TABLE too_many_params(id UInt64 CODEC(ZSTD(2,3,4,5))) ENGINE = MergeTree() order by tuple(); -- { serverError 431 }
 CREATE TABLE params_when_no_params(id UInt64 CODEC(LZ4(1))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 378 }
-CREATE TABLE params_when_no_params2(id UInt64 CODEC(DEFLATE_QPL(1))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 378 }
 CREATE TABLE codec_multiple_direct_specification_1(id UInt64 CODEC(MULTIPLE(LZ4, ZSTD))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 432 }
 CREATE TABLE codec_multiple_direct_specification_2(id UInt64 CODEC(multiple(LZ4, ZSTD))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 432 }
-CREATE TABLE codec_multiple_direct_specification_3(id UInt64 CODEC(multiple(LZ4, DEFLATE_QPL))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 432 }
 CREATE TABLE delta_bad_params1(id UInt64 CODEC(Delta(3))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 433 }
 CREATE TABLE delta_bad_params2(id UInt64 CODEC(Delta(16))) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 433 }
 
 DROP TABLE IF EXISTS bad_codec;
 DROP TABLE IF EXISTS params_when_no_params;
-DROP TABLE IF EXISTS params_when_no_params2;
 DROP TABLE IF EXISTS too_many_params;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_1;
 DROP TABLE IF EXISTS codec_multiple_direct_specification_2;
-DROP TABLE IF EXISTS codec_multiple_direct_specification_3;
 DROP TABLE IF EXISTS delta_bad_params1;
 DROP TABLE IF EXISTS delta_bad_params2;
 
@@ -66,10 +58,10 @@ DROP TABLE IF EXISTS compression_codec_multiple;
 SET network_compression_method = 'lz4hc';
 
 CREATE TABLE compression_codec_multiple (
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4), DEFLATE_QPL),
-    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8), DEFLATE_QPL),
-    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC, DEFLATE_QPL),
-    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD, DEFLATE_QPL)
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4)),
+    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8)),
+    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC),
+    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD)
 ) ENGINE = MergeTree() ORDER BY tuple();
 
 INSERT INTO compression_codec_multiple VALUES (1, 'world', toDate('2018-10-05'), 1.1), (2, 'hello', toDate('2018-10-01'), 2.2), (3, 'buy', toDate('2018-10-11'), 3.3);
@@ -93,15 +85,15 @@ SELECT sum(cityHash64(*)) FROM compression_codec_multiple;
 DROP TABLE IF EXISTS compression_codec_multiple_more_types;
 
 CREATE TABLE compression_codec_multiple_more_types (
-    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC, DEFLATE_QPL),
-    data FixedString(12) CODEC(ZSTD, ZSTD, Delta, Delta, Delta, NONE, NONE, NONE, LZ4HC, DEFLATE_QPL),
-    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8), DEFLATE_QPL)
+    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC),
+    data FixedString(12) CODEC(ZSTD, ZSTD, Delta, Delta, Delta, NONE, NONE, NONE, LZ4HC),
+    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8))
 ) ENGINE = MergeTree() ORDER BY tuple(); -- { serverError 36 }
 
 CREATE TABLE compression_codec_multiple_more_types (
-    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC, DEFLATE_QPL),
-    data FixedString(12) CODEC(ZSTD, ZSTD, NONE, NONE, NONE, LZ4HC, DEFLATE_QPL),
-    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8), DEFLATE_QPL)
+    id Decimal128(13) CODEC(ZSTD, LZ4, ZSTD, ZSTD, Delta(2), Delta(4), Delta(1), LZ4HC),
+    data FixedString(12) CODEC(ZSTD, ZSTD, NONE, NONE, NONE, LZ4HC),
+    ddd Nested (age UInt8, Name String) CODEC(LZ4, LZ4HC, NONE, NONE, NONE, ZSTD, Delta(8))
 ) ENGINE = MergeTree() ORDER BY tuple();
 
 SHOW CREATE TABLE compression_codec_multiple_more_types;
@@ -117,9 +109,9 @@ SET network_compression_method = 'zstd';
 SET network_zstd_compression_level = 5;
 
 CREATE TABLE compression_codec_multiple_with_key (
-    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), Delta, Delta, DEFLATE_QPL),
-    id UInt64 CODEC(LZ4, ZSTD, Delta, NONE, LZ4HC, Delta, DEFLATE_QPL),
-    data String CODEC(ZSTD(2), Delta(1), LZ4HC, NONE, LZ4, LZ4, DEFLATE_QPL)
+    somedate Date CODEC(ZSTD, ZSTD, ZSTD(12), LZ4HC(12), Delta, Delta),
+    id UInt64 CODEC(LZ4, ZSTD, Delta, NONE, LZ4HC, Delta),
+    data String CODEC(ZSTD(2), Delta(1), LZ4HC, NONE, LZ4, LZ4)
 ) ENGINE = MergeTree() PARTITION BY somedate ORDER BY id SETTINGS index_granularity = 2, index_granularity_bytes = '10Mi';
 
 
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference
index d64b8a77eed..8145ca99829 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.reference
@@ -1,9 +1,9 @@
-CREATE TABLE default.compression_codec_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8)),\n    `qplstr` String CODEC(DEFLATE_QPL),\n    `qplnum` UInt32 CODEC(DEFLATE_QPL)\n)\nENGINE = Log
-1	hello	2018-12-14	1.1	aaa	5	qpl11	11
-2	world	2018-12-15	2.2	bbb	6	qpl22	22
-3	!	2018-12-16	3.3	ccc	7	qpl33	33
+CREATE TABLE default.compression_codec_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8))\n)\nENGINE = Log
+1	hello	2018-12-14	1.1	aaa	5
+2	world	2018-12-15	2.2	bbb	6
+3	!	2018-12-16	3.3	ccc	7
 2
-CREATE TABLE default.compression_codec_multiple_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4), DEFLATE_QPL),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8), DEFLATE_QPL),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0), DEFLATE_QPL),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1), DEFLATE_QPL)\n)\nENGINE = Log
+CREATE TABLE default.compression_codec_multiple_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4)),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8)),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0)),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1))\n)\nENGINE = Log
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
 3	buy	2018-10-11	3.3
@@ -11,12 +11,12 @@ CREATE TABLE default.compression_codec_multiple_log\n(\n    `id` UInt64 CODEC(LZ
 10003
 274972506.6
 9175437371954010821
-CREATE TABLE default.compression_codec_tiny_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8)),\n    `qplstr` String CODEC(DEFLATE_QPL),\n    `qplnum` UInt32 CODEC(DEFLATE_QPL)\n)\nENGINE = TinyLog
-1	hello	2018-12-14	1.1	aaa	5	qpl11	11
-2	world	2018-12-15	2.2	bbb	6	qpl22	22
-3	!	2018-12-16	3.3	ccc	7	qpl33	33
+CREATE TABLE default.compression_codec_tiny_log\n(\n    `id` UInt64 CODEC(LZ4),\n    `data` String CODEC(ZSTD(1)),\n    `ddd` Date CODEC(NONE),\n    `somenum` Float64 CODEC(ZSTD(2)),\n    `somestr` FixedString(3) CODEC(LZ4HC(7)),\n    `othernum` Int64 CODEC(Delta(8))\n)\nENGINE = TinyLog
+1	hello	2018-12-14	1.1	aaa	5
+2	world	2018-12-15	2.2	bbb	6
+3	!	2018-12-16	3.3	ccc	7
 2
-CREATE TABLE default.compression_codec_multiple_tiny_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4), DEFLATE_QPL),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8), DEFLATE_QPL),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0), DEFLATE_QPL),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1), DEFLATE_QPL)\n)\nENGINE = TinyLog
+CREATE TABLE default.compression_codec_multiple_tiny_log\n(\n    `id` UInt64 CODEC(LZ4, ZSTD(1), NONE, LZ4HC(0), Delta(4)),\n    `data` String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC(0), LZ4, LZ4, Delta(8)),\n    `ddd` Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD(1), LZ4HC(0), LZ4HC(0)),\n    `somenum` Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD(1))\n)\nENGINE = TinyLog
 1	world	2018-10-05	1.1
 2	hello	2018-10-01	2.2
 3	buy	2018-10-11	3.3
diff --git a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
index a629df2666d..fba6a216762 100644
--- a/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
+++ b/tests/queries/0_stateless/00804_test_custom_compression_codes_log_storages.sql
@@ -1,6 +1,5 @@
 SET send_logs_level = 'fatal';
 SET allow_suspicious_codecs = 1;
-SET enable_deflate_qpl_codec = 1;
 
 -- copy-paste for storage log
 
@@ -12,20 +11,18 @@ CREATE TABLE compression_codec_log(
     ddd Date CODEC(NONE),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
-    othernum Int64 CODEC(Delta),
-    qplstr String CODEC(DEFLATE_QPL),
-    qplnum UInt32 CODEC(DEFLATE_QPL),
+    othernum Int64 CODEC(Delta)
 ) ENGINE = Log();
 
 SHOW CREATE TABLE compression_codec_log;
 
-INSERT INTO compression_codec_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
-INSERT INTO compression_codec_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6,'qpl22', 22);
-INSERT INTO compression_codec_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
+INSERT INTO compression_codec_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5);
+INSERT INTO compression_codec_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6);
+INSERT INTO compression_codec_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7);
 
 SELECT * FROM compression_codec_log ORDER BY id;
 
-INSERT INTO compression_codec_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
+INSERT INTO compression_codec_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8);
 
 DETACH TABLE compression_codec_log;
 ATTACH TABLE compression_codec_log;
@@ -37,10 +34,10 @@ DROP TABLE IF EXISTS compression_codec_log;
 DROP TABLE IF EXISTS compression_codec_multiple_log;
 
 CREATE TABLE compression_codec_multiple_log (
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4), DEFLATE_QPL),
-    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8), DEFLATE_QPL),
-    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC, DEFLATE_QPL),
-    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD, DEFLATE_QPL)
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4)),
+    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8)),
+    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC),
+    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD)
 ) ENGINE = Log();
 
 SHOW CREATE TABLE compression_codec_multiple_log;
@@ -72,20 +69,18 @@ CREATE TABLE compression_codec_tiny_log(
     ddd Date CODEC(NONE),
     somenum Float64 CODEC(ZSTD(2)),
     somestr FixedString(3) CODEC(LZ4HC(7)),
-    othernum Int64 CODEC(Delta),
-    qplstr String CODEC(DEFLATE_QPL),
-    qplnum UInt32 CODEC(DEFLATE_QPL),
+    othernum Int64 CODEC(Delta)
 ) ENGINE = TinyLog();
 
 SHOW CREATE TABLE compression_codec_tiny_log;
 
-INSERT INTO compression_codec_tiny_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5, 'qpl11', 11);
-INSERT INTO compression_codec_tiny_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6, 'qpl22', 22);
-INSERT INTO compression_codec_tiny_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7, 'qpl33', 33);
+INSERT INTO compression_codec_tiny_log VALUES(1, 'hello', toDate('2018-12-14'), 1.1, 'aaa', 5);
+INSERT INTO compression_codec_tiny_log VALUES(2, 'world', toDate('2018-12-15'), 2.2, 'bbb', 6);
+INSERT INTO compression_codec_tiny_log VALUES(3, '!', toDate('2018-12-16'), 3.3, 'ccc', 7);
 
 SELECT * FROM compression_codec_tiny_log ORDER BY id;
 
-INSERT INTO compression_codec_tiny_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8, 'qpl44', 44);
+INSERT INTO compression_codec_tiny_log VALUES(2, '', toDate('2018-12-13'), 4.4, 'ddd', 8);
 
 DETACH TABLE compression_codec_tiny_log;
 ATTACH TABLE compression_codec_tiny_log;
@@ -97,10 +92,10 @@ DROP TABLE IF EXISTS compression_codec_tiny_log;
 DROP TABLE IF EXISTS compression_codec_multiple_tiny_log;
 
 CREATE TABLE compression_codec_multiple_tiny_log (
-    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4), DEFLATE_QPL),
-    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8), DEFLATE_QPL),
-    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC, DEFLATE_QPL),
-    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD, DEFLATE_QPL)
+    id UInt64 CODEC(LZ4, ZSTD, NONE, LZ4HC, Delta(4)),
+    data String CODEC(ZSTD(2), NONE, Delta(2), LZ4HC, LZ4, LZ4, Delta(8)),
+    ddd Date CODEC(NONE, NONE, NONE, Delta(1), LZ4, ZSTD, LZ4HC, LZ4HC),
+    somenum Float64 CODEC(Delta(4), LZ4, LZ4, ZSTD(2), LZ4HC(5), ZSTD(3), ZSTD)
 ) ENGINE = TinyLog();
 
 SHOW CREATE TABLE compression_codec_multiple_tiny_log;
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index 5a56fc0d576..78c57013eeb 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -1,3 +1,7 @@
+--Tags: no-fasttest, no-cpu-aarch64
+-- no-fasttest because DEFLATE_QPL isn't available in fasttest
+-- no-cpu-aarch64 because DEFLATE_QPL is x86-only
+
 SET send_logs_level = 'fatal';
 SET enable_deflate_qpl_codec = 1;
 

From d72751be27ba5f69337a0039f41e577c05a3ae7f Mon Sep 17 00:00:00 2001
From: alekseygolub <aleksey.golub97@mail.ru>
Date: Sun, 11 Jun 2023 15:01:45 +0000
Subject: [PATCH 328/722] Added cache invalidation; Fix issues

---
 src/Databases/DatabaseFactory.cpp             |  5 +--
 src/Databases/DatabaseFilesystem.cpp          | 40 ++++++++++++++-----
 src/Databases/DatabaseFilesystem.h            |  8 +++-
 src/Databases/DatabaseHDFS.cpp                |  6 +++
 src/Databases/DatabaseHDFS.h                  |  5 ++-
 src/Databases/DatabaseS3.cpp                  | 14 +++----
 src/Databases/DatabaseS3.h                    |  5 ++-
 .../0_stateless/02724_database_s3.reference   |  4 --
 .../queries/0_stateless/02724_database_s3.sh  |  6 ---
 9 files changed, 59 insertions(+), 34 deletions(-)

diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 26952cc574e..9d90c61bb41 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -15,10 +15,9 @@
 #include <Parsers/ASTLiteral.h>
 #include <Parsers/queryToString.h>
 #include <Storages/NamedCollectionsHelpers.h>
-#include <Common/Macros.h>
-#include <Common/NamedCollections/NamedCollections.h>
-#include <Common/filesystemHelpers.h>
 #include <Common/logger_useful.h>
+#include <Common/Macros.h>
+#include <Common/filesystemHelpers.h>
 
 #include "config.h"
 
diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index 8de609f0ca2..cf45240a5f0 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -94,14 +94,32 @@ bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, Cont
     return true;
 }
 
-bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr context_) const
+StoragePtr DatabaseFilesystem::tryGetTableFromCache(const std::string & name) const
 {
+    StoragePtr table = nullptr;
     {
         std::lock_guard lock(mutex);
-        if (loaded_tables.find(name) != loaded_tables.end())
-            return true;
+        auto it = loaded_tables.find(name);
+        if (it != loaded_tables.end())
+            table = it->second;
     }
 
+    // invalidate cache if file no longer exists
+    if (table && !fs::exists(getTablePath(name)))
+    {
+        std::lock_guard lock(mutex);
+        loaded_tables.erase(name);
+        return nullptr;
+    }
+
+    return table;
+}
+
+bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr context_) const
+{
+    if (tryGetTableFromCache(name))
+        return true;
+
     fs::path table_file_path(getTablePath(name));
 
     return checkTableFilePath(table_file_path, context_, false);
@@ -109,13 +127,9 @@ bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr context_)
 
 StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr context_) const
 {
-    // Check if the table exists in the loaded tables map
-    {
-        std::lock_guard lock(mutex);
-        auto it = loaded_tables.find(name);
-        if (it != loaded_tables.end())
-            return it->second;
-    }
+    // Check if table exists in loaded tables map
+    if (auto table = tryGetTableFromCache(name))
+        return table;
 
     auto table_path = getTablePath(name);
 
@@ -165,6 +179,12 @@ StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr conte
     }
 }
 
+bool DatabaseFilesystem::empty() const
+{
+    std::lock_guard lock(mutex);
+    return loaded_tables.empty();
+}
+
 ASTPtr DatabaseFilesystem::getCreateDatabaseQuery() const
 {
     auto settings = getContext()->getSettingsRef();
diff --git a/src/Databases/DatabaseFilesystem.h b/src/Databases/DatabaseFilesystem.h
index 3d2ad695cc6..350ebfe37a3 100644
--- a/src/Databases/DatabaseFilesystem.h
+++ b/src/Databases/DatabaseFilesystem.h
@@ -31,7 +31,10 @@ public:
 
     StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
 
-    bool empty() const override { return true; }
+    // Contains only temporary tables
+    bool shouldBeEmptyOnDetach() const override { return false; }
+
+    bool empty() const override;
 
     bool isReadOnly() const override { return true; }
 
@@ -45,13 +48,14 @@ public:
 protected:
     StoragePtr getTableImpl(const String & name, ContextPtr context) const;
 
+    StoragePtr tryGetTableFromCache(const std::string & name) const;
+
     std::string getTablePath(const std::string & table_name) const;
 
     void addTable(const std::string & table_name, StoragePtr table_storage) const;
 
     bool checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const;
 
-
 private:
     String path;
     mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
diff --git a/src/Databases/DatabaseHDFS.cpp b/src/Databases/DatabaseHDFS.cpp
index 39c3f955bf5..34cb337cdbe 100644
--- a/src/Databases/DatabaseHDFS.cpp
+++ b/src/Databases/DatabaseHDFS.cpp
@@ -170,6 +170,12 @@ StoragePtr DatabaseHDFS::tryGetTable(const String & name, ContextPtr context_) c
     }
 }
 
+bool DatabaseHDFS::empty() const
+{
+    std::lock_guard lock(mutex);
+    return loaded_tables.empty();
+}
+
 ASTPtr DatabaseHDFS::getCreateDatabaseQuery() const
 {
     auto settings = getContext()->getSettingsRef();
diff --git a/src/Databases/DatabaseHDFS.h b/src/Databases/DatabaseHDFS.h
index 9a506c5c8ac..c7071370b5e 100644
--- a/src/Databases/DatabaseHDFS.h
+++ b/src/Databases/DatabaseHDFS.h
@@ -33,7 +33,10 @@ public:
 
     StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
 
-    bool empty() const override { return true; }
+    // Contains only temporary tables
+    bool shouldBeEmptyOnDetach() const override { return false; }
+
+    bool empty() const override;
 
     bool isReadOnly() const override { return true; }
 
diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
index 96616426475..46f8a67687d 100644
--- a/src/Databases/DatabaseS3.cpp
+++ b/src/Databases/DatabaseS3.cpp
@@ -67,14 +67,8 @@ void DatabaseS3::addTable(const std::string & table_name, StoragePtr table_stora
 
 std::string DatabaseS3::getFullUrl(const std::string & name) const
 {
-    try
-    {
-        S3::URI uri(name);
-    }
-    catch (...)
-    {
+    if (!config.url_prefix.empty())
         return (fs::path(config.url_prefix) / name).string();
-    }
 
     return name;
 }
@@ -181,6 +175,12 @@ StoragePtr DatabaseS3::tryGetTable(const String & name, ContextPtr context_) con
     }
 }
 
+bool DatabaseS3::empty() const
+{
+    std::lock_guard lock(mutex);
+    return loaded_tables.empty();
+}
+
 ASTPtr DatabaseS3::getCreateDatabaseQuery() const
 {
     auto settings = getContext()->getSettingsRef();
diff --git a/src/Databases/DatabaseS3.h b/src/Databases/DatabaseS3.h
index 4e6910566df..f494925b09b 100644
--- a/src/Databases/DatabaseS3.h
+++ b/src/Databases/DatabaseS3.h
@@ -43,7 +43,10 @@ public:
 
     StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
 
-    bool empty() const override { return true; }
+    // Contains only temporary tables
+    bool shouldBeEmptyOnDetach() const override { return false; }
+
+    bool empty() const override;
 
     bool isReadOnly() const override { return true; }
 
diff --git a/tests/queries/0_stateless/02724_database_s3.reference b/tests/queries/0_stateless/02724_database_s3.reference
index 811e38b7f2b..425cca6a077 100644
--- a/tests/queries/0_stateless/02724_database_s3.reference
+++ b/tests/queries/0_stateless/02724_database_s3.reference
@@ -12,10 +12,6 @@ test1
 13	14	15
 16	17	18
 0	0	0
-1	2	3
-4	5	6
-7	8	9
-0	0	0
 10	11	12
 13	14	15
 16	17	18
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
index ac1b97beecf..79199b43571 100755
--- a/tests/queries/0_stateless/02724_database_s3.sh
+++ b/tests/queries/0_stateless/02724_database_s3.sh
@@ -32,12 +32,6 @@ USE test4;
 SELECT * FROM \"b.tsv\"
 """
 
-# check that database url_prefix is ignored if pass full url as table name
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-USE test4;
-SELECT * FROM \"http://localhost:11111/test/a.tsv\"
-"""
-
 # Check named collection loading
 ${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
 DROP DATABASE IF EXISTS test5;

From 2419a7b90fd1effd8ebf8b5b4741a0325447cdec Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Sun, 11 Jun 2023 15:16:52 +0000
Subject: [PATCH 329/722] Fix tests

---
 .../00804_test_deflate_qpl_codec_compression.reference   | 2 ++
 .../00804_test_deflate_qpl_codec_compression.sql         | 9 ++++++++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
index 276747f8233..a2178f5eda7 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.reference
@@ -1,4 +1,6 @@
+CREATE TABLE default.compression_codec\n(\n    `id` UInt64 CODEC(DEFLATE_QPL),\n    `data` String CODEC(DEFLATE_QPL),\n    `ddd` Date CODEC(DEFLATE_QPL),\n    `ddd32` Date32 CODEC(DEFLATE_QPL),\n    `somenum` Float64 CODEC(DEFLATE_QPL),\n    `somestr` FixedString(3) CODEC(DEFLATE_QPL),\n    `othernum` Int64 CODEC(DEFLATE_QPL),\n    `somearray` Array(UInt8) CODEC(DEFLATE_QPL),\n    `somemap` Map(String, UInt32) CODEC(DEFLATE_QPL),\n    `sometuple` Tuple(UInt16, UInt64) CODEC(DEFLATE_QPL)\n)\nENGINE = MergeTree\nORDER BY tuple()\nSETTINGS index_granularity = 8192
 1	hello	2018-12-14	2018-12-14	1.1	aaa	5	[1,2,3]	{'k1':1,'k2':2}	(1,2)
 2	world	2018-12-15	2018-12-15	2.2	bbb	6	[4,5,6]	{'k3':3,'k4':4}	(3,4)
 3	!	2018-12-16	2018-12-16	3.3	ccc	7	[7,8,9]	{'k5':5,'k6':6}	(5,6)
 2
+10001
diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index 78c57013eeb..ff3c1812c86 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -2,7 +2,8 @@
 -- no-fasttest because DEFLATE_QPL isn't available in fasttest
 -- no-cpu-aarch64 because DEFLATE_QPL is x86-only
 
-SET send_logs_level = 'fatal';
+-- A bunch of random DDLs to test the DEFLATE_QPL codec.
+
 SET enable_deflate_qpl_codec = 1;
 
 DROP TABLE IF EXISTS compression_codec;
@@ -20,6 +21,8 @@ CREATE TABLE compression_codec(
     sometuple Tuple(UInt16, UInt64) CODEC(DEFLATE_QPL),
 ) ENGINE = MergeTree() ORDER BY tuple();
 
+SHOW CREATE TABLE compression_codec;
+
 INSERT INTO compression_codec VALUES(1, 'hello', toDate('2018-12-14'), toDate32('2018-12-14'), 1.1, 'aaa', 5, [1,2,3], map('k1',1,'k2',2), tuple(1,2));
 INSERT INTO compression_codec VALUES(2, 'world', toDate('2018-12-15'), toDate32('2018-12-15'), 2.2, 'bbb', 6, [4,5,6], map('k3',3,'k4',4), tuple(3,4));
 INSERT INTO compression_codec VALUES(3, '!', toDate('2018-12-16'), toDate32('2018-12-16'), 3.3, 'ccc', 7, [7,8,9], map('k5',5,'k6',6), tuple(5,6));
@@ -35,4 +38,8 @@ ATTACH TABLE compression_codec;
 
 SELECT count(*) FROM compression_codec WHERE id = 2 GROUP BY id;
 
+INSERT INTO compression_codec SELECT 3, '!', toDate('2018-12-16'), toDate32('2018-12-16'), 3.3, 'ccc', 7, [7,8,9], map('k5',5,'k6',6), tuple(5,6) FROM system.numbers LIMIT 10000;
+
+SELECT count(*) FROM compression_codec WHERE id = 3 GROUP BY id;
+
 DROP TABLE IF EXISTS compression_codec;

From 598501011f5cbedb42188b2f828c055d44a0fcd8 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 11 Jun 2023 17:51:54 +0200
Subject: [PATCH 330/722] Relax "too many parts" further

---
 programs/server/Server.cpp                         |  1 -
 src/Loggers/OwnPatternFormatter.cpp                |  1 -
 src/Storages/MergeTree/MergeTreeData.cpp           | 10 +++++-----
 src/Storages/MergeTree/MergeTreeData.h             |  2 +-
 src/Storages/MergeTree/MergeTreeSettings.h         |  6 +++---
 src/Storages/MergeTree/MergeTreeSink.cpp           |  9 +++++++--
 src/Storages/MergeTree/MergeTreeSink.h             |  3 ++-
 src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp |  9 +++++++--
 src/Storages/MergeTree/ReplicatedMergeTreeSink.h   |  1 +
 9 files changed, 26 insertions(+), 16 deletions(-)

diff --git a/programs/server/Server.cpp b/programs/server/Server.cpp
index d0fc8aca5e8..cfef7f0a94a 100644
--- a/programs/server/Server.cpp
+++ b/programs/server/Server.cpp
@@ -1705,7 +1705,6 @@ try
 #endif
 
         /// Must be done after initialization of `servers`, because async_metrics will access `servers` variable from its thread.
-
         async_metrics.start();
 
         {
diff --git a/src/Loggers/OwnPatternFormatter.cpp b/src/Loggers/OwnPatternFormatter.cpp
index ccf6c479b80..0c2256aaa1b 100644
--- a/src/Loggers/OwnPatternFormatter.cpp
+++ b/src/Loggers/OwnPatternFormatter.cpp
@@ -4,7 +4,6 @@
 #include <IO/WriteBufferFromString.h>
 #include <IO/WriteHelpers.h>
 #include <Common/HashTable/Hash.h>
-#include <Interpreters/InternalTextLogsQueue.h>
 #include <base/terminalColors.h>
 
 
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 9cca471fddb..b42d130bf62 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -4315,14 +4315,14 @@ std::optional<Int64> MergeTreeData::getMinPartDataVersion() const
 }
 
 
-void MergeTreeData::delayInsertOrThrowIfNeeded(Poco::Event * until, const ContextPtr & query_context) const
+void MergeTreeData::delayInsertOrThrowIfNeeded(Poco::Event * until, const ContextPtr & query_context, bool allow_throw) const
 {
     const auto settings = getSettings();
     const auto & query_settings = query_context->getSettingsRef();
     const size_t parts_count_in_total = getActivePartsCount();
 
-    /// check if have too many parts in total
-    if (parts_count_in_total >= settings->max_parts_in_total)
+    /// Check if we have too many parts in total
+    if (allow_throw && parts_count_in_total >= settings->max_parts_in_total)
     {
         ProfileEvents::increment(ProfileEvents::RejectedInserts);
         throw Exception(
@@ -4338,7 +4338,7 @@ void MergeTreeData::delayInsertOrThrowIfNeeded(Poco::Event * until, const Contex
         if (settings->inactive_parts_to_throw_insert > 0 || settings->inactive_parts_to_delay_insert > 0)
             outdated_parts_count_in_partition = getMaxOutdatedPartsCountForPartition();
 
-        if (settings->inactive_parts_to_throw_insert > 0 && outdated_parts_count_in_partition >= settings->inactive_parts_to_throw_insert)
+        if (allow_throw && settings->inactive_parts_to_throw_insert > 0 && outdated_parts_count_in_partition >= settings->inactive_parts_to_throw_insert)
         {
             ProfileEvents::increment(ProfileEvents::RejectedInserts);
             throw Exception(
@@ -4362,7 +4362,7 @@ void MergeTreeData::delayInsertOrThrowIfNeeded(Poco::Event * until, const Contex
         bool parts_are_large_enough_in_average
             = settings->max_avg_part_size_for_too_many_parts && average_part_size > settings->max_avg_part_size_for_too_many_parts;
 
-        if (parts_count_in_partition >= active_parts_to_throw_insert && !parts_are_large_enough_in_average)
+        if (allow_throw && parts_count_in_partition >= active_parts_to_throw_insert && !parts_are_large_enough_in_average)
         {
             ProfileEvents::increment(ProfileEvents::RejectedInserts);
             throw Exception(
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index b1e1e43bd0b..ebda82eeaed 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -557,7 +557,7 @@ public:
     /// If the table contains too many active parts, sleep for a while to give them time to merge.
     /// If until is non-null, wake up from the sleep earlier if the event happened.
     /// The decision to delay or throw is made according to settings 'parts_to_delay_insert' and 'parts_to_throw_insert'.
-    void delayInsertOrThrowIfNeeded(Poco::Event * until, const ContextPtr & query_context) const;
+    void delayInsertOrThrowIfNeeded(Poco::Event * until, const ContextPtr & query_context, bool allow_throw) const;
 
     /// If the table contains too many unfinished mutations, sleep for a while to give them time to execute.
     /// If until is non-null, wake up from the sleep earlier if the event happened.
diff --git a/src/Storages/MergeTree/MergeTreeSettings.h b/src/Storages/MergeTree/MergeTreeSettings.h
index 33aea358078..082b84be575 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.h
+++ b/src/Storages/MergeTree/MergeTreeSettings.h
@@ -73,11 +73,11 @@ struct Settings;
     M(UInt64, max_delay_to_mutate_ms, 1000, "Max delay of mutating MergeTree table in milliseconds, if there are a lot of unfinished mutations", 0) \
     \
     /** Inserts settings. */ \
-    M(UInt64, parts_to_delay_insert, 150, "If table contains at least that many active parts in single partition, artificially slow down insert into table. Disabled if set to 0", 0) \
+    M(UInt64, parts_to_delay_insert, 1000, "If table contains at least that many active parts in single partition, artificially slow down insert into table. Disabled if set to 0", 0) \
     M(UInt64, inactive_parts_to_delay_insert, 0, "If table contains at least that many inactive parts in single partition, artificially slow down insert into table.", 0) \
-    M(UInt64, parts_to_throw_insert, 300, "If more than this number active parts in single partition, throw 'Too many parts ...' exception.", 0) \
+    M(UInt64, parts_to_throw_insert, 3000, "If more than this number active parts in single partition, throw 'Too many parts ...' exception.", 0) \
     M(UInt64, inactive_parts_to_throw_insert, 0, "If more than this number inactive parts in single partition, throw 'Too many inactive parts ...' exception.", 0) \
-    M(UInt64, max_avg_part_size_for_too_many_parts, 10ULL * 1024 * 1024 * 1024, "The 'too many parts' check according to 'parts_to_delay_insert' and 'parts_to_throw_insert' will be active only if the average part size (in the relevant partition) is not larger than the specified threshold. If it is larger than the specified threshold, the INSERTs will be neither delayed or rejected. This allows to have hundreds of terabytes in a single table on a single server if the parts are successfully merged to larger parts. This does not affect the thresholds on inactive parts or total parts.", 0) \
+    M(UInt64, max_avg_part_size_for_too_many_parts, 1ULL * 1024 * 1024 * 1024, "The 'too many parts' check according to 'parts_to_delay_insert' and 'parts_to_throw_insert' will be active only if the average part size (in the relevant partition) is not larger than the specified threshold. If it is larger than the specified threshold, the INSERTs will be neither delayed or rejected. This allows to have hundreds of terabytes in a single table on a single server if the parts are successfully merged to larger parts. This does not affect the thresholds on inactive parts or total parts.", 0) \
     M(UInt64, max_delay_to_insert, 1, "Max delay of inserting data into MergeTree table in seconds, if there are a lot of unmerged parts in single partition.", 0) \
     M(UInt64, min_delay_to_insert_ms, 10, "Min delay of inserting data into MergeTree table in milliseconds, if there are a lot of unmerged parts in single partition.", 0) \
     M(UInt64, max_parts_in_total, 100000, "If more than this number active parts in all partitions in total, throw 'Too many parts ...' exception.", 0) \
diff --git a/src/Storages/MergeTree/MergeTreeSink.cpp b/src/Storages/MergeTree/MergeTreeSink.cpp
index d62fe5024f4..36816904a81 100644
--- a/src/Storages/MergeTree/MergeTreeSink.cpp
+++ b/src/Storages/MergeTree/MergeTreeSink.cpp
@@ -45,9 +45,9 @@ MergeTreeSink::MergeTreeSink(
 
 void MergeTreeSink::onStart()
 {
-    /// Only check "too many parts" before write,
+    /// It's only allowed to throw "too many parts" before write,
     /// because interrupting long-running INSERT query in the middle is not convenient for users.
-    storage.delayInsertOrThrowIfNeeded(nullptr, context);
+    storage.delayInsertOrThrowIfNeeded(nullptr, context, true);
 }
 
 void MergeTreeSink::onFinish()
@@ -57,6 +57,9 @@ void MergeTreeSink::onFinish()
 
 void MergeTreeSink::consume(Chunk chunk)
 {
+    if (num_blocks_processed > 0)
+        storage.delayInsertOrThrowIfNeeded(nullptr, context, false);
+
     auto block = getHeader().cloneWithColumns(chunk.detachColumns());
     if (!storage_snapshot->object_columns.empty())
         convertDynamicColumnsToTuples(block, storage_snapshot);
@@ -136,6 +139,8 @@ void MergeTreeSink::consume(Chunk chunk)
     finishDelayedChunk();
     delayed_chunk = std::make_unique<MergeTreeSink::DelayedChunk>();
     delayed_chunk->partitions = std::move(partitions);
+
+    ++num_blocks_processed;
 }
 
 void MergeTreeSink::finishDelayedChunk()
diff --git a/src/Storages/MergeTree/MergeTreeSink.h b/src/Storages/MergeTree/MergeTreeSink.h
index 68f11d86a25..07ab3850df2 100644
--- a/src/Storages/MergeTree/MergeTreeSink.h
+++ b/src/Storages/MergeTree/MergeTreeSink.h
@@ -35,7 +35,8 @@ private:
     size_t max_parts_per_block;
     ContextPtr context;
     StorageSnapshotPtr storage_snapshot;
-    uint64_t chunk_dedup_seqnum = 0; /// input chunk ordinal number in case of dedup token
+    UInt64 chunk_dedup_seqnum = 0; /// input chunk ordinal number in case of dedup token
+    UInt64 num_blocks_processed = 0;
 
     /// We can delay processing for previous chunk and start writing a new one.
     struct DelayedChunk;
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index 28dad454afe..5fbd72ccddc 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -367,6 +367,9 @@ size_t ReplicatedMergeTreeSinkImpl<async_insert>::checkQuorumPrecondition(const
 template<bool async_insert>
 void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
 {
+    if (num_blocks_processed > 0)
+        storage.delayInsertOrThrowIfNeeded(&storage.partial_shutdown_event, context, false);
+
     auto block = getHeader().cloneWithColumns(chunk.detachColumns());
 
     const auto & settings = context->getSettingsRef();
@@ -512,6 +515,8 @@ void ReplicatedMergeTreeSinkImpl<async_insert>::consume(Chunk chunk)
     /// TODO: we can also delay commit if there is no MVs.
     if (!settings.deduplicate_blocks_in_dependent_materialized_views)
         finishDelayedChunk(zookeeper);
+
+    ++num_blocks_processed;
 }
 
 template<>
@@ -1136,9 +1141,9 @@ std::pair<std::vector<String>, bool> ReplicatedMergeTreeSinkImpl<async_insert>::
 template<bool async_insert>
 void ReplicatedMergeTreeSinkImpl<async_insert>::onStart()
 {
-    /// Only check "too many parts" before write,
+    /// It's only allowed to throw "too many parts" before write,
     /// because interrupting long-running INSERT query in the middle is not convenient for users.
-    storage.delayInsertOrThrowIfNeeded(&storage.partial_shutdown_event, context);
+    storage.delayInsertOrThrowIfNeeded(&storage.partial_shutdown_event, context, true);
 }
 
 template<bool async_insert>
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.h b/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
index 8d9e2e14129..868590efa25 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.h
@@ -123,6 +123,7 @@ private:
     bool quorum_parallel = false;
     const bool deduplicate = true;
     bool last_block_is_duplicate = false;
+    UInt64 num_blocks_processed = 0;
 
     using Logger = Poco::Logger;
     Poco::Logger * log;

From 61fa6944145f851e156943db678e0657a0d6fb42 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Sun, 11 Jun 2023 19:03:57 +0000
Subject: [PATCH 331/722] Fix boundery -> boundary in docs

---
 .../sql-reference/functions/type-conversion-functions.md  | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index 28db7e6e677..9258b6d6026 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -317,7 +317,7 @@ SELECT
 
 ## toDateOrZero
 
-The same as [toDate](#todate) but returns lower boundery of [Date](/docs/en/sql-reference/data-types/date.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+The same as [toDate](#todate) but returns lower boundary of [Date](/docs/en/sql-reference/data-types/date.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
 
 **Example**
 
@@ -359,7 +359,7 @@ Result:
 
 ## toDateOrDefault
 
-Like [toDate](#todate) but if unsuccessful, returns a default value which is either the second argument (if specified), or otherwise the lower boundery of [Date](/docs/en/sql-reference/data-types/date.md).
+Like [toDate](#todate) but if unsuccessful, returns a default value which is either the second argument (if specified), or otherwise the lower boundary of [Date](/docs/en/sql-reference/data-types/date.md).
 
 **Syntax**
 
@@ -424,7 +424,7 @@ Result:
 
 ## toDateTimeOrZero
 
-The same as [toDateTime](#todatetime) but returns lower boundery of [DateTime](/docs/en/sql-reference/data-types/datetime.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
+The same as [toDateTime](#todatetime) but returns lower boundary of [DateTime](/docs/en/sql-reference/data-types/datetime.md) if an invalid argument is received. Only [String](/docs/en/sql-reference/data-types/string.md) argument is supported.
 
 **Example**
 
@@ -466,7 +466,7 @@ Result:
 
 ## toDateTimeOrDefault
 
-Like [toDateTime](#todatetime) but if unsuccessful, returns a default value which is either the third argument (if specified), or otherwise the lower boundery of [DateTime](/docs/en/sql-reference/data-types/datetime.md).
+Like [toDateTime](#todatetime) but if unsuccessful, returns a default value which is either the third argument (if specified), or otherwise the lower boundary of [DateTime](/docs/en/sql-reference/data-types/datetime.md).
 
 **Syntax**
 

From 3797a4202cb3da6bf20684149d24931e72fbd239 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Sun, 11 Jun 2023 23:38:31 +0300
Subject: [PATCH 332/722] Update MergeTreeData.cpp

---
 src/Storages/MergeTree/MergeTreeData.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 23351423d49..8a69c8ff75c 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1252,6 +1252,10 @@ MergeTreeData::LoadPartResult MergeTreeData::loadDataPart(
         mark_broken();
         return res;
     }
+    catch (const Poco::NetException &)
+    {
+        throw;
+    }
     catch (const Poco::TimeoutException &)
     {
         throw;

From 7bcaf8b233e91a11fe0d82daaf265d20c8279906 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Mon, 12 Jun 2023 10:15:32 +0800
Subject: [PATCH 333/722] fix build error

---
 src/Storages/StorageRedis.cpp | 6 +++++-
 src/Storages/StorageRedis.h   | 3 ++-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 97f1dbce6da..68c71cac508 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -461,7 +461,11 @@ Block StorageRedis::getSampleBlock(const Names &) const
     return getInMemoryMetadataPtr()->getSampleBlock();
 }
 
-SinkToStoragePtr StorageRedis::write(const ASTPtr & /*query*/, const StorageMetadataPtr & metadata_snapshot, ContextPtr /*context*/)
+SinkToStoragePtr StorageRedis::write(
+    const ASTPtr & /*query*/, 
+    const StorageMetadataPtr & metadata_snapshot,
+    ContextPtr /*context*/,
+    bool /*async_insert*/)
 {
     return std::make_shared<RedisSink>(*this, metadata_snapshot);
 }
diff --git a/src/Storages/StorageRedis.h b/src/Storages/StorageRedis.h
index a4ab9a6aa4e..a525a4ed7de 100644
--- a/src/Storages/StorageRedis.h
+++ b/src/Storages/StorageRedis.h
@@ -36,7 +36,8 @@ public:
     SinkToStoragePtr write(
         const ASTPtr & query,
         const StorageMetadataPtr & /*metadata_snapshot*/,
-        ContextPtr context) override;
+        ContextPtr context,
+        bool /*async_insert*/) override;
 
     void truncate(const ASTPtr &,
         const StorageMetadataPtr & metadata_snapshot,

From a9d4d5194972daa1dcecf80b388c6ccb127f92d0 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Mon, 12 Jun 2023 10:16:02 +0800
Subject: [PATCH 334/722] add word redis to aspell-dict

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index a01b67b26b1..e594962ec44 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -2044,6 +2044,7 @@ reconnection
 recurse
 redash
 reddit
+redis
 redisstreams
 refcounter
 regexpExtract

From ef40c029a5617b9abfee6fb4525de9aeca2fcf73 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Mon, 12 Jun 2023 11:54:42 +0800
Subject: [PATCH 335/722] fix style

---
 src/Storages/StorageRedis.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 68c71cac508..71c84443d8e 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -462,7 +462,7 @@ Block StorageRedis::getSampleBlock(const Names &) const
 }
 
 SinkToStoragePtr StorageRedis::write(
-    const ASTPtr & /*query*/, 
+    const ASTPtr & /*query*/,
     const StorageMetadataPtr & metadata_snapshot,
     ContextPtr /*context*/,
     bool /*async_insert*/)

From 911f8ad8dc68d126cedebd3e990ea185ed3c41b1 Mon Sep 17 00:00:00 2001
From: kevinyhzou <kevinyunhe8@gmail.com>
Date: Mon, 12 Jun 2023 11:57:52 +0800
Subject: [PATCH 336/722] use whitespace or tab as field delimiter

---
 docs/en/interfaces/formats.md                 |  1 +
 .../operations/settings/settings-formats.md   | 32 +++++++++++++++++
 src/Core/Settings.h                           |  2 +-
 src/Formats/FormatFactory.cpp                 |  2 +-
 src/Formats/FormatSettings.h                  |  2 +-
 .../Formats/Impl/CSVRowInputFormat.cpp        | 34 +++++++++----------
 ...h_whitespace_tab_field_delimiter.reference |  4 +--
 ...ext_with_whitespace_tab_field_delimiter.sh |  4 +--
 8 files changed, 57 insertions(+), 24 deletions(-)

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index f19fd94dcd8..57962c1d730 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -468,6 +468,7 @@ The CSV format supports the output of totals and extremes the same way as `TabSe
 - [input_format_csv_skip_first_lines](/docs/en/operations/settings/settings-formats.md/#input_format_csv_skip_first_lines) - skip the specified number of lines at the beginning of data. Default value - `0`.
 - [input_format_csv_detect_header](/docs/en/operations/settings/settings-formats.md/#input_format_csv_detect_header) - automatically detect header with names and types in CSV format. Default value - `true`.
 - [input_format_csv_trim_whitespaces](/docs/en/operations/settings/settings-formats.md/#input_format_csv_trim_whitespaces) - trim spaces and tabs in non-quoted CSV strings. Default value - `true`.
+- [input_format_csv_use_whitespace_tab_as_delimiter](/docs/en/operations/settings/settings-formats.md/# input_format_csv_use_whitespace_tab_as_delimiter) - use whitespace or tab as field delimiter in CSV strings. Default value - `false`.
 
 ## CSVWithNames {#csvwithnames}
 
diff --git a/docs/en/operations/settings/settings-formats.md b/docs/en/operations/settings/settings-formats.md
index 025e9f889f3..0e30c8f319e 100644
--- a/docs/en/operations/settings/settings-formats.md
+++ b/docs/en/operations/settings/settings-formats.md
@@ -914,6 +914,38 @@ Result
 "  string  "
 ```
 
+### input_format_csv_use_whitespace_tab_as_delimiter {#input_format_csv_use_whitespace_tab_as_delimiter}
+
+Use whitespace or tab as field delimiter in CSV strings.
+
+Default value: `false`.
+
+**Examples**
+
+Query
+
+```bash
+echo 'a b' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_use_whitespace_tab_as_delimiter=true --format_csv_delimiter=' '
+```
+
+Result
+
+```text
+a  b
+```
+
+Query
+
+```bash
+echo 'a         b' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_use_whitespace_tab_as_delimiter=true --format_csv_delimiter='\t'
+```
+
+Result
+
+```text
+a  b
+```
+
 ## Values format settings {#values-format-settings}
 
 ### input_format_values_interpret_expressions {#input_format_values_interpret_expressions}
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 45641e76689..4306ac855a3 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -850,7 +850,7 @@ class IColumn;
     M(Bool, input_format_csv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in CSV format", 0) \
     M(Bool, input_format_tsv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in TSV format", 0) \
     M(Bool, input_format_csv_detect_header, true, "Automatically detect header with names and types in CSV format", 0) \
-    M(Bool, input_format_csv_skip_whitespaces_tabs, true, "Skips spaces and tabs(\\t) characters in the CSV strings", 0) \
+    M(Bool, input_format_csv_use_whitespace_tab_as_delimiter, false, "Use spaces and tabs(\\t) as field delimiter in the CSV strings", 0) \
     M(Bool, input_format_csv_trim_whitespaces, true, "Trims spaces and tabs (\\t) characters at the beginning and end in CSV strings", 0) \
     M(Bool, input_format_tsv_detect_header, true, "Automatically detect header with names and types in TSV format", 0) \
     M(Bool, input_format_custom_detect_header, true, "Automatically detect header with names and types in CustomSeparated format", 0) \
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index 73a7d4f73f2..33ecddfc223 100644
--- a/src/Formats/FormatFactory.cpp
+++ b/src/Formats/FormatFactory.cpp
@@ -70,7 +70,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.csv.skip_first_lines = settings.input_format_csv_skip_first_lines;
     format_settings.csv.try_detect_header = settings.input_format_csv_detect_header;
     format_settings.csv.trim_whitespaces = settings.input_format_csv_trim_whitespaces;
-    format_settings.csv.skip_whitespaces_tabs = settings.input_format_csv_skip_whitespaces_tabs;
+    format_settings.csv.use_whitespace_tab_as_delimiter = settings.input_format_csv_use_whitespace_tab_as_delimiter;
     format_settings.hive_text.fields_delimiter = settings.input_format_hive_text_fields_delimiter;
     format_settings.hive_text.collection_items_delimiter = settings.input_format_hive_text_collection_items_delimiter;
     format_settings.hive_text.map_keys_delimiter = settings.input_format_hive_text_map_keys_delimiter;
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index 434389e31a1..72d60e8423e 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -137,7 +137,7 @@ struct FormatSettings
         String custom_delimiter;
         bool try_detect_header = true;
         bool trim_whitespaces = true;
-        bool skip_whitespaces_tabs = true;
+        bool use_whitespace_tab_as_delimiter = false;
     } csv;
 
     struct HiveText
diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index 4094285e1ad..b8d3413f863 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -25,10 +25,10 @@ namespace ErrorCodes
 
 namespace
 {
-    void checkBadDelimiter(char delimiter, bool skip_whitespaces_tabs)
+    void checkBadDelimiter(char delimiter, bool use_whitespace_tab_as_delimiter)
     {
         constexpr std::string_view bad_delimiters = " \t\"'.UL";
-        if (bad_delimiters.find(delimiter) != std::string_view::npos && skip_whitespaces_tabs)
+        if (bad_delimiters.find(delimiter) != std::string_view::npos && !use_whitespace_tab_as_delimiter)
             throw Exception(
                 ErrorCodes::BAD_ARGUMENTS,
                 "CSV format may not work correctly with delimiter '{}'. Try use CustomSeparated format instead",
@@ -68,7 +68,7 @@ CSVRowInputFormat::CSVRowInputFormat(
         format_settings_.csv.try_detect_header),
     buf(std::move(in_))
 {
-    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.skip_whitespaces_tabs);
+    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.use_whitespace_tab_as_delimiter);
 }
 
 CSVRowInputFormat::CSVRowInputFormat(
@@ -90,7 +90,7 @@ CSVRowInputFormat::CSVRowInputFormat(
         format_settings_.csv.try_detect_header),
     buf(std::move(in_))
 {
-    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.skip_whitespaces_tabs);
+    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.use_whitespace_tab_as_delimiter);
 }
 
 void CSVRowInputFormat::syncAfterError()
@@ -134,9 +134,9 @@ static void skipEndOfLine(ReadBuffer & in)
 }
 
 /// Skip `whitespace` symbols allowed in CSV.
-static inline void skipWhitespacesAndTabs(ReadBuffer & in, const bool & skip_whitespaces_tabs)
+static inline void skipWhitespacesAndTabs(ReadBuffer & in, const bool & use_whitespace_tab_as_delimiter)
 {
-    if (!skip_whitespaces_tabs)
+    if (use_whitespace_tab_as_delimiter)
     {
         return;
     }
@@ -150,7 +150,7 @@ CSVFormatReader::CSVFormatReader(PeekableReadBuffer & buf_, const FormatSettings
 
 void CSVFormatReader::skipFieldDelimiter()
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
     assertChar(format_settings.csv.delimiter, *buf);
 }
 
@@ -158,7 +158,7 @@ template <bool read_string>
 String CSVFormatReader::readCSVFieldIntoString()
 {
     if (format_settings.csv.trim_whitespaces) [[likely]]
-        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
 
     String field;
     if constexpr (read_string)
@@ -170,14 +170,14 @@ String CSVFormatReader::readCSVFieldIntoString()
 
 void CSVFormatReader::skipField()
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
     NullOutput out;
     readCSVStringInto(out, *buf, format_settings.csv);
 }
 
 void CSVFormatReader::skipRowEndDelimiter()
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
 
     if (buf->eof())
         return;
@@ -186,7 +186,7 @@ void CSVFormatReader::skipRowEndDelimiter()
     if (*buf->position() == format_settings.csv.delimiter)
         ++buf->position();
 
-    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
     if (buf->eof())
         return;
 
@@ -198,7 +198,7 @@ void CSVFormatReader::skipHeaderRow()
     do
     {
         skipField();
-        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
     } while (checkChar(format_settings.csv.delimiter, *buf));
 
     skipRowEndDelimiter();
@@ -211,7 +211,7 @@ std::vector<String> CSVFormatReader::readRowImpl()
     do
     {
         fields.push_back(readCSVFieldIntoString<is_header>());
-        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
     } while (checkChar(format_settings.csv.delimiter, *buf));
 
     skipRowEndDelimiter();
@@ -224,7 +224,7 @@ bool CSVFormatReader::parseFieldDelimiterWithDiagnosticInfo(WriteBuffer & out)
 
     try
     {
-        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
         assertChar(delimiter, *buf);
     }
     catch (const DB::Exception &)
@@ -250,7 +250,7 @@ bool CSVFormatReader::parseFieldDelimiterWithDiagnosticInfo(WriteBuffer & out)
 
 bool CSVFormatReader::parseRowEndWithDiagnosticInfo(WriteBuffer & out)
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
 
     if (buf->eof())
         return true;
@@ -259,7 +259,7 @@ bool CSVFormatReader::parseRowEndWithDiagnosticInfo(WriteBuffer & out)
     if (*buf->position() == format_settings.csv.delimiter)
     {
         ++buf->position();
-        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
         if (buf->eof())
             return true;
     }
@@ -287,7 +287,7 @@ bool CSVFormatReader::readField(
     const String & /*column_name*/)
 {
     if (format_settings.csv.trim_whitespaces || !isStringOrFixedString(removeNullable(type))) [[likely]]
-        skipWhitespacesAndTabs(*buf, format_settings.csv.skip_whitespaces_tabs);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
 
     const bool at_delimiter = !buf->eof() && *buf->position() == format_settings.csv.delimiter;
     const bool at_last_column_line_end = is_last_file_column && (buf->eof() || *buf->position() == '\n' || *buf->position() == '\r');
diff --git a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference
index 531391394a7..228436130dc 100644
--- a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference
+++ b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.reference
@@ -1,2 +1,2 @@
-1 a b
-2 c d
+1	a	b
+2	c	d
diff --git a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
index e3f61262674..deb6e317aac 100755
--- a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
+++ b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
@@ -10,8 +10,8 @@ $CLICKHOUSE_CLIENT -q "drop table if exists test_whitespace"
 $CLICKHOUSE_CLIENT -q "drop table if exists test_tab"
 $CLICKHOUSE_CLIENT -q "create table test_whitespace (x UInt32, y String, z String) engine=MergeTree order by x"
 $CLICKHOUSE_CLIENT -q "create table test_tab (x UInt32, y String, z String) engine=MergeTree order by x"
-cat $CURDIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
-cat $CURDIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_skip_whitespaces_tabs=false FORMAT CSV"
+cat $CURDIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_use_whitespace_tab_as_delimiter=true FORMAT CSV"
+cat $CURDIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_use_whitespace_tab_as_delimiter=true FORMAT CSV"
 $CLICKHOUSE_CLIENT -q "select * from test_whitespace"
 $CLICKHOUSE_CLIENT -q "select * from test_tab"
 $CLICKHOUSE_CLIENT -q "drop table test_whitespace"

From 1af062a53214168345838f79cba53ecb11cbc41e Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 12 Jun 2023 08:04:55 +0000
Subject: [PATCH 337/722] Un-flake 00804_test_deflate_qpl_codec_compression

---
 .../0_stateless/00804_test_deflate_qpl_codec_compression.sql  | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
index ff3c1812c86..8a256567e80 100644
--- a/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
+++ b/tests/queries/0_stateless/00804_test_deflate_qpl_codec_compression.sql
@@ -6,6 +6,10 @@
 
 SET enable_deflate_qpl_codec = 1;
 
+-- Suppress test failures because stderr contains warning "Initialization of hardware-assisted DeflateQpl failed, falling
+-- back to software DeflateQpl coded."
+SET send_logs_level = 'fatal';
+
 DROP TABLE IF EXISTS compression_codec;
 
 CREATE TABLE compression_codec(

From c378c3fcbbb678e96f5bc11958295f4dd1b4b6ba Mon Sep 17 00:00:00 2001
From: Julian Maicher <julian.maicher@gmail.com>
Date: Mon, 12 Jun 2023 10:29:46 +0200
Subject: [PATCH 338/722] Fix type of LDAP server params hash in cache entry

In 1ed7ad57d91db198ca94085a2c56372fb813543a, we switched from (`size_t`, usually 64bit) to SipHash (128bit) and forgot to change the type of the cache entry. This broke the caching of successful LDAP authentication requests (verification cooldown).

Fixes #50864
---
 src/Access/ExternalAuthenticators.h | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Access/ExternalAuthenticators.h b/src/Access/ExternalAuthenticators.h
index bf928c18d5b..7b47c9351fd 100644
--- a/src/Access/ExternalAuthenticators.h
+++ b/src/Access/ExternalAuthenticators.h
@@ -5,6 +5,7 @@
 #include <Access/GSSAcceptor.h>
 #include <base/defines.h>
 #include <base/types.h>
+#include <base/extended_types.h>
 
 #include <chrono>
 #include <map>
@@ -42,7 +43,7 @@ public:
 private:
     struct LDAPCacheEntry
     {
-        std::size_t last_successful_params_hash = 0;
+        UInt128 last_successful_params_hash = 0;
         std::chrono::steady_clock::time_point last_successful_authentication_timestamp;
         LDAPClient::SearchResultsList last_successful_role_search_results;
     };

From 6b2c33b1e478f175bec55e41a7ca8054807bb4fa Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 12 Jun 2023 09:16:22 +0000
Subject: [PATCH 339/722] Document x86 / ARM prerequisites for Docker image

---
 docker/server/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docker/server/README.md b/docker/server/README.md
index e6c9ee51fa7..46d30f252b4 100644
--- a/docker/server/README.md
+++ b/docker/server/README.md
@@ -16,6 +16,10 @@ For more information and documentation see https://clickhouse.com/.
 - The tag `head` is built from the latest commit to the default branch.
 - Each tag has optional `-alpine` suffix to reflect that it's built on top of `alpine`.
 
+Compatibility
+- The amd64 image requires support for [SSE3 instructions](https://en.wikipedia.org/wiki/SSE3). Virtually all x86 CPUs after 2005 support SSE3.
+- The arm64 image requires support for the [ARMv8.2-A architecture](https://en.wikipedia.org/wiki/AArch64#ARMv8.2-A). Most ARM CPUs after 2017 support ARMv8.2-A. A notable exception is Raspberry Pi 4 from 2019 whose CPU only supports ARMv8.0-A.
+
 ## How to use this image
 
 ### start server instance

From a7408170c8bce6be3d4849fc3614834d8f646298 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <mr.felixoid@gmail.com>
Date: Mon, 12 Jun 2023 11:21:43 +0200
Subject: [PATCH 340/722] Use H3

---
 docker/server/README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docker/server/README.md b/docker/server/README.md
index 46d30f252b4..67646a262f5 100644
--- a/docker/server/README.md
+++ b/docker/server/README.md
@@ -16,7 +16,8 @@ For more information and documentation see https://clickhouse.com/.
 - The tag `head` is built from the latest commit to the default branch.
 - Each tag has optional `-alpine` suffix to reflect that it's built on top of `alpine`.
 
-Compatibility
+### Compatibility
+
 - The amd64 image requires support for [SSE3 instructions](https://en.wikipedia.org/wiki/SSE3). Virtually all x86 CPUs after 2005 support SSE3.
 - The arm64 image requires support for the [ARMv8.2-A architecture](https://en.wikipedia.org/wiki/AArch64#ARMv8.2-A). Most ARM CPUs after 2017 support ARMv8.2-A. A notable exception is Raspberry Pi 4 from 2019 whose CPU only supports ARMv8.0-A.
 

From 676ba2fbde78ec9ada09a45c0453e0cd96a3ab01 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 12 Jun 2023 12:30:38 +0300
Subject: [PATCH 341/722] Update MergeTreeData.cpp

---
 src/Storages/MergeTree/MergeTreeData.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 8a69c8ff75c..ee06056985a 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -99,6 +99,7 @@
 
 #include <fmt/format.h>
 #include <Poco/Logger.h>
+#include <Poco/Net/NetException.h>
 
 template <>
 struct fmt::formatter<DB::DataPartPtr> : fmt::formatter<std::string>

From c85344f83b8c1568e67ef45fdcb55b0ec0c07a8b Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Mon, 12 Jun 2023 10:02:44 +0000
Subject: [PATCH 342/722] Try to fix test (becouse timezone randomization)

---
 .../0_stateless/01746_convert_type_with_default.reference       | 2 +-
 tests/queries/0_stateless/01746_convert_type_with_default.sql   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 541580d67f5..e5aa42e6116 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -40,7 +40,7 @@
 1970-01-20
 1970-01-20
 2149-06-06
-1970-01-01
+1970-01-02
 2023-05-30
 2023-05-30
 2023-05-30 14:38:20
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index 2620780cfb9..e6e420ae4c0 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -54,7 +54,7 @@ select toDateOrDefault(cast(19 as Int256));
 select toDateOrDefault(cast(19 as UInt256));
 
 select toDateOrDefault(65535);
-select toDateOrDefault(65536);
+select toDateOrDefault(122400);
 
 select toDateOrDefault(19507, '2000-01-01'::Date);
 select toDateOrDefault(-1, '2023-05-30'::Date);

From 5cec4c3161b84e32341ef723dc8cea2b38343b69 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 12 Jun 2023 11:34:40 +0000
Subject: [PATCH 343/722] Fallback to parsing big integer from String instead
 of exception in Parquet format

---
 src/Processors/Formats/Impl/ArrowColumnToCHColumn.cpp    | 9 +++------
 .../02786_parquet_big_integer_compatibility.reference    | 1 +
 .../02786_parquet_big_integer_compatibility.sh           | 9 +++++++++
 3 files changed, 13 insertions(+), 6 deletions(-)
 create mode 100644 tests/queries/0_stateless/02786_parquet_big_integer_compatibility.reference
 create mode 100755 tests/queries/0_stateless/02786_parquet_big_integer_compatibility.sh

diff --git a/src/Processors/Formats/Impl/ArrowColumnToCHColumn.cpp b/src/Processors/Formats/Impl/ArrowColumnToCHColumn.cpp
index 0b4700c9d4c..5a7306111a5 100644
--- a/src/Processors/Formats/Impl/ArrowColumnToCHColumn.cpp
+++ b/src/Processors/Formats/Impl/ArrowColumnToCHColumn.cpp
@@ -202,13 +202,10 @@ static ColumnWithTypeAndName readColumnWithBigNumberFromBinaryData(std::shared_p
 
         for (size_t i = 0; i != chunk_length; ++i)
         {
+            /// If at least one value size is not equal to the size if big integer, fallback to reading String column and further cast to result type.
             if (!chunk.IsNull(i) && chunk.value_length(i) != sizeof(ValueType))
-                throw Exception(
-                    ErrorCodes::BAD_ARGUMENTS,
-                    "Cannot insert data into {} column from binary value, expected data with size {}, got {}",
-                    column_type->getName(),
-                    sizeof(ValueType),
-                    chunk.value_length(i));
+                return readColumnWithStringData<arrow::BinaryArray>(arrow_column, column_name);
+
             total_size += chunk_length;
         }
     }
diff --git a/tests/queries/0_stateless/02786_parquet_big_integer_compatibility.reference b/tests/queries/0_stateless/02786_parquet_big_integer_compatibility.reference
new file mode 100644
index 00000000000..7764974255b
--- /dev/null
+++ b/tests/queries/0_stateless/02786_parquet_big_integer_compatibility.reference
@@ -0,0 +1 @@
+424242424242424242424242424242424242424242424242424242
diff --git a/tests/queries/0_stateless/02786_parquet_big_integer_compatibility.sh b/tests/queries/0_stateless/02786_parquet_big_integer_compatibility.sh
new file mode 100755
index 00000000000..8865b2e7aab
--- /dev/null
+++ b/tests/queries/0_stateless/02786_parquet_big_integer_compatibility.sh
@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+$CLICKHOUSE_LOCAL -q "select toString(424242424242424242424242424242424242424242424242424242::UInt256) as x format Parquet" | $CLICKHOUSE_LOCAL --input-format=Parquet --structure='x UInt256' -q "select * from table"
+

From 24d70a2afd70a10a709fffe942b4e759d406f93b Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Mon, 12 Jun 2023 13:37:59 +0200
Subject: [PATCH 344/722] Fix

---
 src/Formats/CapnProtoSerializer.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index f51f8c4b933..b306cca4f94 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -403,7 +403,7 @@ namespace
                 if (it == capnp_to_ch_values.end())
                     throw Exception(ErrorCodes::INCORRECT_DATA, "Unexpected value {} in CapnProto enum", capnp_enum_value);
 
-                assert_cast<ColumnVector<EnumType> &>(column).insertValue(capnp_to_ch_values[capnp_enum_value]);
+                assert_cast<ColumnVector<EnumType> &>(column).insertValue(it->second);
             }
         }
 

From 42393b51ee1747e838c71196a29eb305fca6257c Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Mon, 12 Jun 2023 13:45:00 +0200
Subject: [PATCH 345/722] Fix style

---
 tests/clickhouse-test | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/clickhouse-test b/tests/clickhouse-test
index 56cf2f0ce0f..9242ca8a0b0 100755
--- a/tests/clickhouse-test
+++ b/tests/clickhouse-test
@@ -349,10 +349,11 @@ def kill_gdb_if_any():
     for i in range(5):
         code = subprocess.call("kill -TERM $(pidof gdb)", shell=True, timeout=30)
         if code != 0:
-            time.sleep(i)
+            sleep(i)
         else:
             break
 
+
 # collect server stacktraces using gdb
 def get_stacktraces_from_gdb(server_pid):
     try:

From 17a6512cdc80c0a14f4570c12df520deff05550c Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Mon, 12 Jun 2023 13:53:20 +0200
Subject: [PATCH 346/722] Delete bad test

---
 tests/queries/0_stateless/02782_bitmap_overflow.sql | 4 ----
 1 file changed, 4 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02782_bitmap_overflow.sql

diff --git a/tests/queries/0_stateless/02782_bitmap_overflow.sql b/tests/queries/0_stateless/02782_bitmap_overflow.sql
deleted file mode 100644
index 71ddce5c3b9..00000000000
--- a/tests/queries/0_stateless/02782_bitmap_overflow.sql
+++ /dev/null
@@ -1,4 +0,0 @@
--- Tags: no-msan, no-asan
-
-select unhex('0181808080908380808000')::AggregateFunction(groupBitmap, UInt64); -- {serverError TOO_LARGE_ARRAY_SIZE}
-

From d100a2031cd51f51e7320d62f683e7bf8520083c Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Mon, 12 Jun 2023 13:53:44 +0200
Subject: [PATCH 347/722] Delete bad test

---
 tests/queries/0_stateless/02782_bitmap_overflow.reference | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02782_bitmap_overflow.reference

diff --git a/tests/queries/0_stateless/02782_bitmap_overflow.reference b/tests/queries/0_stateless/02782_bitmap_overflow.reference
deleted file mode 100644
index e69de29bb2d..00000000000

From 1c8371e1db7c1bfbc9a98d2cf33b1450e5c3547a Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 12 Jun 2023 12:13:10 +0000
Subject: [PATCH 348/722] Update version_date.tsv and changelogs after
 v22.8.18.31-lts

---
 docs/changelogs/v22.8.18.31-lts.md   | 32 ++++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  1 +
 2 files changed, 33 insertions(+)
 create mode 100644 docs/changelogs/v22.8.18.31-lts.md

diff --git a/docs/changelogs/v22.8.18.31-lts.md b/docs/changelogs/v22.8.18.31-lts.md
new file mode 100644
index 00000000000..709bb926f8a
--- /dev/null
+++ b/docs/changelogs/v22.8.18.31-lts.md
@@ -0,0 +1,32 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v22.8.18.31-lts (4de7a95a544) FIXME as compared to v22.8.17.17-lts (df7f2ef0b41)
+
+#### Performance Improvement
+* Backported in [#49214](https://github.com/ClickHouse/ClickHouse/issues/49214): Fixed excessive reading in queries with `FINAL`. [#47801](https://github.com/ClickHouse/ClickHouse/pull/47801) ([Nikita Taranov](https://github.com/nickitat)).
+
+#### Build/Testing/Packaging Improvement
+* Backported in [#49079](https://github.com/ClickHouse/ClickHouse/issues/49079): Update time zones. The following were updated: Africa/Cairo, Africa/Casablanca, Africa/El_Aaiun, America/Bogota, America/Cambridge_Bay, America/Ciudad_Juarez, America/Godthab, America/Inuvik, America/Iqaluit, America/Nuuk, America/Ojinaga, America/Pangnirtung, America/Rankin_Inlet, America/Resolute, America/Whitehorse, America/Yellowknife, Asia/Gaza, Asia/Hebron, Asia/Kuala_Lumpur, Asia/Singapore, Canada/Yukon, Egypt, Europe/Kirov, Europe/Volgograd, Singapore. [#48572](https://github.com/ClickHouse/ClickHouse/pull/48572) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix bad cast from LowCardinality column when using short circuit function execution [#43311](https://github.com/ClickHouse/ClickHouse/pull/43311) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix msan issue in randomStringUTF8(<uneven number>) [#49750](https://github.com/ClickHouse/ClickHouse/pull/49750) ([Robert Schulze](https://github.com/rschu1ze)).
+* JIT compilation not equals NaN fix [#50056](https://github.com/ClickHouse/ClickHouse/pull/50056) ([Maksim Kita](https://github.com/kitaisreal)).
+* Fix crash with `multiIf` and constant condition and nullable arguments [#50123](https://github.com/ClickHouse/ClickHouse/pull/50123) ([Anton Popov](https://github.com/CurtizJ)).
+* Fixed type conversion from Date/Date32 to DateTime64 when querying with DateTime64 index [#50280](https://github.com/ClickHouse/ClickHouse/pull/50280) ([Lucas Chang](https://github.com/lucas-tubi)).
+* Fix Keeper deadlock on exception when preprocessing requests. [#50387](https://github.com/ClickHouse/ClickHouse/pull/50387) ([frinkr](https://github.com/frinkr)).
+* Fix Log family table return wrong rows count after truncate [#50585](https://github.com/ClickHouse/ClickHouse/pull/50585) ([flynn](https://github.com/ucasfl)).
+* Do not read all the columns from right GLOBAL JOIN table. [#50721](https://github.com/ClickHouse/ClickHouse/pull/50721) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Improve test reports [#49151](https://github.com/ClickHouse/ClickHouse/pull/49151) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Update github.com/distribution/distribution [#50114](https://github.com/ClickHouse/ClickHouse/pull/50114) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Catch issues with dockerd during the build [#50700](https://github.com/ClickHouse/ClickHouse/pull/50700) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 4647bcb4af1..dce6aadbff4 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -44,6 +44,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04
 v22.8.15.23-lts	2023-03-10

From d177cfceca3af796f7e5cab3adb421212d9856f0 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 12 Jun 2023 12:17:11 +0000
Subject: [PATCH 349/722] Update version_date.tsv and changelogs after
 v23.3.3.52-lts

---
 docs/changelogs/v23.3.3.52-lts.md    | 45 ++++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  2 ++
 2 files changed, 47 insertions(+)
 create mode 100644 docs/changelogs/v23.3.3.52-lts.md

diff --git a/docs/changelogs/v23.3.3.52-lts.md b/docs/changelogs/v23.3.3.52-lts.md
new file mode 100644
index 00000000000..f845e14eb78
--- /dev/null
+++ b/docs/changelogs/v23.3.3.52-lts.md
@@ -0,0 +1,45 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.3.3.52-lts (cb963c474db) FIXME as compared to v23.3.2.37-lts (1b144bcd101)
+
+#### Improvement
+* Backported in [#49954](https://github.com/ClickHouse/ClickHouse/issues/49954): Add support for (an unusual) case where the arguments in the `IN` operator are single-element tuples. [#49844](https://github.com/ClickHouse/ClickHouse/pull/49844) ([MikhailBurdukov](https://github.com/MikhailBurdukov)).
+
+#### Build/Testing/Packaging Improvement
+* Backported in [#49210](https://github.com/ClickHouse/ClickHouse/issues/49210): Fix glibc compatibility check: replace `preadv` from musl. [#49144](https://github.com/ClickHouse/ClickHouse/pull/49144) ([alesapin](https://github.com/alesapin)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix aggregate empty string error [#48999](https://github.com/ClickHouse/ClickHouse/pull/48999) ([LiuNeng](https://github.com/liuneng1994)).
+* Fix key not found error for queries with multiple StorageJoin [#49137](https://github.com/ClickHouse/ClickHouse/pull/49137) ([vdimir](https://github.com/vdimir)).
+* Fix race on Outdated parts loading [#49223](https://github.com/ClickHouse/ClickHouse/pull/49223) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix bug in DISTINCT [#49628](https://github.com/ClickHouse/ClickHouse/pull/49628) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix msan issue in randomStringUTF8(<uneven number>) [#49750](https://github.com/ClickHouse/ClickHouse/pull/49750) ([Robert Schulze](https://github.com/rschu1ze)).
+* fix `is_prefix` in OptimizeRegularExpression [#49919](https://github.com/ClickHouse/ClickHouse/pull/49919) ([Han Fei](https://github.com/hanfei1991)).
+* Fix IPv6 encoding in protobuf [#49933](https://github.com/ClickHouse/ClickHouse/pull/49933) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Avoid deadlock when starting table in attach thread of `ReplicatedMergeTree` [#50026](https://github.com/ClickHouse/ClickHouse/pull/50026) ([Antonio Andelic](https://github.com/antonio2368)).
+* JIT compilation not equals NaN fix [#50056](https://github.com/ClickHouse/ClickHouse/pull/50056) ([Maksim Kita](https://github.com/kitaisreal)).
+* Fix crash with `multiIf` and constant condition and nullable arguments [#50123](https://github.com/ClickHouse/ClickHouse/pull/50123) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix reconnecting of HTTPS session when target host IP was changed [#50240](https://github.com/ClickHouse/ClickHouse/pull/50240) ([Aleksei Filatov](https://github.com/aalexfvk)).
+* Fixed type conversion from Date/Date32 to DateTime64 when querying with DateTime64 index [#50280](https://github.com/ClickHouse/ClickHouse/pull/50280) ([Lucas Chang](https://github.com/lucas-tubi)).
+* Fix Keeper deadlock on exception when preprocessing requests. [#50387](https://github.com/ClickHouse/ClickHouse/pull/50387) ([frinkr](https://github.com/frinkr)).
+* Fix incorrect constant folding [#50536](https://github.com/ClickHouse/ClickHouse/pull/50536) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix Log family table return wrong rows count after truncate [#50585](https://github.com/ClickHouse/ClickHouse/pull/50585) ([flynn](https://github.com/ucasfl)).
+* Fix bug in `uniqExact` parallel merging [#50590](https://github.com/ClickHouse/ClickHouse/pull/50590) ([Nikita Taranov](https://github.com/nickitat)).
+* Do not read all the columns from right GLOBAL JOIN table. [#50721](https://github.com/ClickHouse/ClickHouse/pull/50721) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Implement status comment [#48468](https://github.com/ClickHouse/ClickHouse/pull/48468) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Update curl to 8.0.1 (for CVEs) [#48765](https://github.com/ClickHouse/ClickHouse/pull/48765) ([Boris Kuschel](https://github.com/bkuschel)).
+* Improve test reports [#49151](https://github.com/ClickHouse/ClickHouse/pull/49151) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Fallback auth gh api [#49314](https://github.com/ClickHouse/ClickHouse/pull/49314) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Improve CI: status commit, auth for get_gh_api [#49388](https://github.com/ClickHouse/ClickHouse/pull/49388) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Update github.com/distribution/distribution [#50114](https://github.com/ClickHouse/ClickHouse/pull/50114) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Catch issues with dockerd during the build [#50700](https://github.com/ClickHouse/ClickHouse/pull/50700) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 4647bcb4af1..411dcd81957 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -2,6 +2,7 @@ v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
 v23.2.7.32-stable	2023-06-09
@@ -44,6 +45,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04
 v22.8.15.23-lts	2023-03-10

From 11fbc01de5bc5840f6d91c1e9b0d10bf25387bd9 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Mon, 12 Jun 2023 12:37:47 +0000
Subject: [PATCH 350/722] Update version_date.tsv and changelogs after
 v23.4.3.48-stable

---
 docs/changelogs/v23.4.3.48-stable.md | 42 ++++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  3 ++
 2 files changed, 45 insertions(+)
 create mode 100644 docs/changelogs/v23.4.3.48-stable.md

diff --git a/docs/changelogs/v23.4.3.48-stable.md b/docs/changelogs/v23.4.3.48-stable.md
new file mode 100644
index 00000000000..8bafd22bfbd
--- /dev/null
+++ b/docs/changelogs/v23.4.3.48-stable.md
@@ -0,0 +1,42 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.4.3.48-stable (d9199f8d3cc) FIXME as compared to v23.4.2.11-stable (b6442320f9d)
+
+#### Backward Incompatible Change
+* Backported in [#49981](https://github.com/ClickHouse/ClickHouse/issues/49981): Revert "`groupArray` returns cannot be nullable" (due to binary compatibility breakage for `groupArray`/`groupArrayLast`/`groupArraySample` over `Nullable` types, which likely will lead to `TOO_LARGE_ARRAY_SIZE` or `CANNOT_READ_ALL_DATA`). [#49971](https://github.com/ClickHouse/ClickHouse/pull/49971) ([Azat Khuzhin](https://github.com/azat)).
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix key not found error for queries with multiple StorageJoin [#49137](https://github.com/ClickHouse/ClickHouse/pull/49137) ([vdimir](https://github.com/vdimir)).
+* Fix fuzz bug when subquery set is not built when reading from remote() [#49425](https://github.com/ClickHouse/ClickHouse/pull/49425) ([Alexander Gololobov](https://github.com/davenger)).
+* Fix postgres database setting [#49481](https://github.com/ClickHouse/ClickHouse/pull/49481) ([Mal Curtis](https://github.com/snikch)).
+* Fix AsynchronousReadIndirectBufferFromRemoteFS breaking on short seeks [#49525](https://github.com/ClickHouse/ClickHouse/pull/49525) ([Michael Kolupaev](https://github.com/al13n321)).
+* Fix bug in DISTINCT [#49628](https://github.com/ClickHouse/ClickHouse/pull/49628) ([Alexey Milovidov](https://github.com/alexey-milovidov)).
+* Fix assert in SpanHolder::finish() with fibers [#49673](https://github.com/ClickHouse/ClickHouse/pull/49673) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fix msan issue in randomStringUTF8(<uneven number>) [#49750](https://github.com/ClickHouse/ClickHouse/pull/49750) ([Robert Schulze](https://github.com/rschu1ze)).
+* fix `is_prefix` in OptimizeRegularExpression [#49919](https://github.com/ClickHouse/ClickHouse/pull/49919) ([Han Fei](https://github.com/hanfei1991)).
+* Fix IPv6 encoding in protobuf [#49933](https://github.com/ClickHouse/ClickHouse/pull/49933) ([Yakov Olkhovskiy](https://github.com/yakov-olkhovskiy)).
+* Avoid deadlock when starting table in attach thread of `ReplicatedMergeTree` [#50026](https://github.com/ClickHouse/ClickHouse/pull/50026) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix assert in SpanHolder::finish() with fibers attempt 2 [#50034](https://github.com/ClickHouse/ClickHouse/pull/50034) ([Kruglov Pavel](https://github.com/Avogar)).
+* JIT compilation not equals NaN fix [#50056](https://github.com/ClickHouse/ClickHouse/pull/50056) ([Maksim Kita](https://github.com/kitaisreal)).
+* Fix crashing in case of Replicated database without arguments [#50058](https://github.com/ClickHouse/ClickHouse/pull/50058) ([Azat Khuzhin](https://github.com/azat)).
+* Fix crash with `multiIf` and constant condition and nullable arguments [#50123](https://github.com/ClickHouse/ClickHouse/pull/50123) ([Anton Popov](https://github.com/CurtizJ)).
+* Fix iceberg metadata parsing [#50232](https://github.com/ClickHouse/ClickHouse/pull/50232) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix bugs in Poco sockets in non-blocking mode, use true non-blocking sockets [#50252](https://github.com/ClickHouse/ClickHouse/pull/50252) ([Kruglov Pavel](https://github.com/Avogar)).
+* Fixed type conversion from Date/Date32 to DateTime64 when querying with DateTime64 index [#50280](https://github.com/ClickHouse/ClickHouse/pull/50280) ([Lucas Chang](https://github.com/lucas-tubi)).
+* Fix Keeper deadlock on exception when preprocessing requests. [#50387](https://github.com/ClickHouse/ClickHouse/pull/50387) ([frinkr](https://github.com/frinkr)).
+* Fix Log family table return wrong rows count after truncate [#50585](https://github.com/ClickHouse/ClickHouse/pull/50585) ([flynn](https://github.com/ucasfl)).
+* Fix bug in `uniqExact` parallel merging [#50590](https://github.com/ClickHouse/ClickHouse/pull/50590) ([Nikita Taranov](https://github.com/nickitat)).
+* Do not read all the columns from right GLOBAL JOIN table. [#50721](https://github.com/ClickHouse/ClickHouse/pull/50721) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Improve CI: status commit, auth for get_gh_api [#49388](https://github.com/ClickHouse/ClickHouse/pull/49388) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Update github.com/distribution/distribution [#50114](https://github.com/ClickHouse/ClickHouse/pull/50114) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Catch issues with dockerd during the build [#50700](https://github.com/ClickHouse/ClickHouse/pull/50700) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 4647bcb4af1..6afce99612f 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,7 +1,9 @@
 v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
+v23.4.3.48-stable	2023-06-12
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
 v23.2.7.32-stable	2023-06-09
@@ -44,6 +46,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04
 v22.8.15.23-lts	2023-03-10

From 5db3b393d825e5597f204b9ff2ca67abf89e4045 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 12 Jun 2023 16:22:33 +0300
Subject: [PATCH 351/722] Update MergeTreeData.cpp

---
 src/Storages/MergeTree/MergeTreeData.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index ee06056985a..5833955726f 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1253,7 +1253,7 @@ MergeTreeData::LoadPartResult MergeTreeData::loadDataPart(
         mark_broken();
         return res;
     }
-    catch (const Poco::NetException &)
+    catch (const Poco::Net::NetException &)
     {
         throw;
     }

From b5b8c7086b43fbf3de9293196bfb7097e3888b58 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 12 Jun 2023 13:43:53 +0000
Subject: [PATCH 352/722] Update broken tests list

---
 tests/broken_tests.txt | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index b1fa18c44dd..d49b4f391e5 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -11,7 +11,6 @@
 00927_asof_joins
 00940_order_by_read_in_order_query_plan
 00945_bloom_filter_index
-00952_input_function
 00979_set_index_not
 00981_in_subquery_with_tuple
 01049_join_low_card_bug_long
@@ -21,14 +20,12 @@
 01072_optimize_skip_unused_shards_const_expr_eval
 01083_expressions_in_engine_arguments
 01086_odbc_roundtrip
-01152_cross_replication
 01155_rename_move_materialized_view
 01173_transaction_control_queries
 01211_optimize_skip_unused_shards_type_mismatch
 01213_optimize_skip_unused_shards_DISTINCT
 01214_test_storage_merge_aliases_with_where
 01231_distributed_aggregation_memory_efficient_mix_levels
-01232_extremes
 01244_optimize_distributed_group_by_sharding_key
 01247_optimize_distributed_group_by_sharding_key_dist_on_dist
 01268_mv_scalars
@@ -50,7 +47,6 @@
 01585_use_index_for_global_in
 01585_use_index_for_global_in_with_null
 01586_columns_pruning
-01615_random_one_shard_insertion
 01624_soft_constraints
 01651_bugs_from_15889
 01655_plan_optimizations
@@ -79,7 +75,6 @@
 01952_optimize_distributed_group_by_sharding_key
 02000_join_on_const
 02001_shard_num_shard_count
-02024_join_on_or_long
 02131_used_row_policies_in_query_log
 02139_MV_with_scalar_subquery
 02174_cte_scalar_cache_mv
@@ -88,14 +83,11 @@
 02302_s3_file_pruning
 02317_distinct_in_order_optimization_explain
 02341_global_join_cte
-02343_aggregation_pipeline
 02345_implicit_transaction
-02346_additional_filters_distr
 02352_grouby_shadows_arg
 02354_annoy
 02366_union_decimal_conversion
 02375_rocksdb_with_filters
-02377_optimize_sorting_by_input_stream_properties_explain
 02382_join_and_filtering_set
 02402_merge_engine_with_view
 02404_memory_bound_merging
@@ -112,7 +104,6 @@
 02575_merge_prewhere_different_default_kind
 02713_array_low_cardinality_string
 02707_skip_index_with_in
-02324_map_combinator_bug
 02241_join_rocksdb_bs
 02003_WithMergeableStateAfterAggregationAndLimit_LIMIT_BY_LIMIT_OFFSET
 01115_join_with_dictionary
@@ -120,7 +111,6 @@
 00917_multiple_joins_denny_crane
 00725_join_on_bug_1
 00636_partition_key_parts_pruning
-00261_storage_aliases_and_array_join
 01825_type_json_multiple_files
 01281_group_by_limit_memory_tracking
 02723_zookeeper_name

From 01c7d2fe719f9b9ed59fce58d5e9dec44167e42f Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 12 Jun 2023 16:53:26 +0300
Subject: [PATCH 353/722] Prostpone check of outdated parts (#50676)

* prostpone check of outdated parts

* Update ReplicatedMergeTreePartCheckThread.cpp
---
 .../ReplicatedMergeTreePartCheckThread.cpp       | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp b/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
index 0882ff5a0bc..7bb8d9d758e 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
@@ -344,6 +344,22 @@ CheckResult ReplicatedMergeTreePartCheckThread::checkPart(const String & part_na
 
     LOG_TRACE(log, "Part {} in zookeeper: {}, locally: {}", part_name, exists_in_zookeeper, part != nullptr);
 
+    if (exists_in_zookeeper && !part)
+    {
+        auto outdated = storage.getPartIfExists(part_name, {MergeTreeDataPartState::Outdated, MergeTreeDataPartState::Deleting});
+        if (outdated)
+        {
+            /// We cannot rely on exists_in_zookeeper, because the cleanup thread is probably going to remove it from ZooKeeper
+            /// Also, it will avoid "Cannot commit empty part: Part ... (state Outdated) already exists, but it will be deleted soon"
+            LOG_WARNING(log, "Part {} is Outdated, will wait for cleanup thread to handle it and check again later", part_name);
+            time_t lifetime = time(nullptr) - outdated->remove_time;
+            time_t max_lifetime = storage.getSettings()->old_parts_lifetime.totalSeconds();
+            time_t delay = lifetime >= max_lifetime ? 0 : max_lifetime - lifetime;
+            enqueuePart(part_name, delay + 30);
+            return {part_name, true, "Part is Outdated, will recheck later"};
+        }
+    }
+
     /// We do not have this or a covering part.
     if (!part)
     {

From d45f07743c3f27276740b3bac7200f7cad90292e Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Mon, 12 Jun 2023 13:54:07 +0000
Subject: [PATCH 354/722] fix  getting number of mutations

---
 src/Storages/StorageMergeTree.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index a2a46229660..233b37c74a9 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -1358,7 +1358,7 @@ size_t StorageMergeTree::getNumberOfUnfinishedMutations() const
     size_t count = 0;
     for (const auto & [version, _] : current_mutations_by_version | std::views::reverse)
     {
-        auto status = getIncompleteMutationsStatusUnlocked(version, lock);
+        auto status = getIncompleteMutationsStatusUnlocked(version, lock, nullptr, true);
         if (!status)
             continue;
 

From 26c9bda14410e6f589c843a664635db9ab02b15e Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 12 Jun 2023 13:51:46 +0000
Subject: [PATCH 355/722] Add a comment

---
 src/Interpreters/InterpreterSelectQueryAnalyzer.cpp | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp b/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp
index 4f2f05dc7eb..8db1d27c073 100644
--- a/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp
+++ b/src/Interpreters/InterpreterSelectQueryAnalyzer.cpp
@@ -135,6 +135,8 @@ QueryTreeNodePtr buildQueryTreeAndRunPasses(const ASTPtr & query,
     QueryTreePassManager query_tree_pass_manager(context);
     addQueryTreePasses(query_tree_pass_manager);
 
+    /// We should not apply any query tree level optimizations on shards
+    /// because it can lead to a changed header.
     if (select_query_options.ignore_ast_optimizations
         || context->getClientInfo().query_kind == ClientInfo::QueryKind::SECONDARY_QUERY)
         query_tree_pass_manager.run(query_tree, 1 /*up_to_pass_index*/);

From 41ece306cf02519e97697d1a65bd3003d8cbe898 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 12 Jun 2023 13:53:46 +0000
Subject: [PATCH 356/722] Update broken_tests.txt

---
 tests/broken_tests.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/broken_tests.txt b/tests/broken_tests.txt
index b1fa18c44dd..3b888223b78 100644
--- a/tests/broken_tests.txt
+++ b/tests/broken_tests.txt
@@ -106,7 +106,6 @@
 02458_use_structure_from_insertion_table
 02479_race_condition_between_insert_and_droppin_mv
 02493_inconsistent_hex_and_binary_number
-02494_optimize_group_by_function_keys_and_alias_columns
 02521_aggregation_by_partitions
 02554_fix_grouping_sets_predicate_push_down
 02575_merge_prewhere_different_default_kind

From 07eb7b7d664778342e0b44049041c160ac868d94 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 12 Jun 2023 11:03:50 -0300
Subject: [PATCH 357/722] Update settings.md

---
 docs/en/operations/settings/settings.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 2c9679c940d..8104478deff 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -1957,6 +1957,10 @@ Default value: empty string (disabled)
 For the replicated tables by default the only 100 of the most recent inserts for each partition are deduplicated (see [replicated_deduplication_window](merge-tree-settings.md/#replicated-deduplication-window), [replicated_deduplication_window_seconds](merge-tree-settings.md/#replicated-deduplication-window-seconds)).
 For not replicated tables see [non_replicated_deduplication_window](merge-tree-settings.md/#non-replicated-deduplication-window).
 
+:::note
+`insert_deduplication_token` works on a partition level (the same as `insert_deduplication` checksum). Multiple partitions can have the same `insert_deduplication_token`.
+:::
+
 Example:
 
 ```sql

From 252a10c670977c93b8808d8b98a8679714d6e9a3 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Mon, 12 Jun 2023 08:19:06 -0700
Subject: [PATCH 358/722] Add "no-parallel" tag to MySQL Compatible Types test
 to fix test issue

---
 .../0_stateless/02775_show_columns_mysql_compatibility.sh       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index 51c9da2a842..e324926e2e7 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-fasttest
+# Tags: no-fasttest, no-parallel
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From 5aa05667677669a17d6356fd884c7da35478d280 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Mon, 12 Jun 2023 17:24:34 +0200
Subject: [PATCH 359/722] Fix checking the lock file too often while writing a
 backup.

---
 src/Backups/BackupImpl.cpp | 6 ++----
 src/Backups/BackupImpl.h   | 1 +
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/Backups/BackupImpl.cpp b/src/Backups/BackupImpl.cpp
index 306236534b6..82793f44739 100644
--- a/src/Backups/BackupImpl.cpp
+++ b/src/Backups/BackupImpl.cpp
@@ -144,6 +144,7 @@ void BackupImpl::open(const ContextPtr & context)
         if (!uuid)
             uuid = UUIDHelpers::generateV4();
         lock_file_name = use_archive ? (archive_params.archive_name + ".lock") : ".lock";
+        lock_file_before_first_file_checked = false;
         writing_finalized = false;
 
         /// Check that we can write a backup there and create the lock file to own this destination.
@@ -833,13 +834,10 @@ void BackupImpl::writeFile(const BackupFileInfo & info, BackupEntryPtr entry)
     if (writing_finalized)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Backup is already finalized");
 
-    bool should_check_lock_file = false;
     {
         std::lock_guard lock{mutex};
         ++num_files;
         total_size += info.size;
-        if (!num_entries)
-            should_check_lock_file = true;
     }
 
     auto src_disk = entry->getDisk();
@@ -859,7 +857,7 @@ void BackupImpl::writeFile(const BackupFileInfo & info, BackupEntryPtr entry)
         return;
     }
 
-    if (!should_check_lock_file)
+    if (!lock_file_before_first_file_checked.exchange(true))
         checkLockFile(true);
 
     /// NOTE: `mutex` must be unlocked during copying otherwise writing will be in one thread maximum and hence slow.
diff --git a/src/Backups/BackupImpl.h b/src/Backups/BackupImpl.h
index 7e95d156162..3ab11228892 100644
--- a/src/Backups/BackupImpl.h
+++ b/src/Backups/BackupImpl.h
@@ -141,6 +141,7 @@ private:
     std::shared_ptr<IArchiveReader> archive_reader;
     std::shared_ptr<IArchiveWriter> archive_writer;
     String lock_file_name;
+    std::atomic<bool> lock_file_before_first_file_checked = false;
 
     bool writing_finalized = false;
     bool deduplicate_files = true;

From 65d83e45cb177cc3abfec088e31da44fca357c95 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 12 Jun 2023 16:21:28 +0000
Subject: [PATCH 360/722] Fix crash in snowflakeToDateTime(), follow-up to
 #50834

---
 src/Functions/FunctionSnowflake.h              | 18 +++++++++++++-----
 .../01942_snowflakeToDateTime.reference        |  1 +
 .../0_stateless/01942_snowflakeToDateTime.sql  |  4 +++-
 3 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/src/Functions/FunctionSnowflake.h b/src/Functions/FunctionSnowflake.h
index ce3a48269b4..0a47534c47d 100644
--- a/src/Functions/FunctionSnowflake.h
+++ b/src/Functions/FunctionSnowflake.h
@@ -5,6 +5,7 @@
 #include <Functions/FunctionHelpers.h>
 #include <DataTypes/DataTypeDateTime64.h>
 #include <DataTypes/DataTypesNumber.h>
+#include <Columns/ColumnConst.h>
 #include <Columns/ColumnsNumber.h>
 #include <Interpreters/Context.h>
 
@@ -110,12 +111,19 @@ public:
         auto res_column = ColumnUInt32::create(input_rows_count);
         auto & result_data = res_column->getData();
 
-        const auto & source_data = typeid_cast<const ColumnInt64 &>(col).getData();
-
-        for (size_t i = 0; i < input_rows_count; ++i)
+        if (const auto * src_non_const = typeid_cast<const ColumnInt64 *>(&col))
         {
-            result_data[i] = static_cast<UInt32>(
-                ((source_data[i] >> time_shift) + snowflake_epoch) / 1000);
+            const auto & source_data = src_non_const->getData();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                result_data[i] = static_cast<UInt32>(
+                    ((source_data[i] >> time_shift) + snowflake_epoch) / 1000);
+        }
+        else if (const auto * src_const = typeid_cast<const ColumnConst *>(&col))
+        {
+            Int64 src_val = src_const->getValue<Int64>();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                result_data[i] = static_cast<UInt32>(
+                    ((src_val >> time_shift) + snowflake_epoch) / 1000);
         }
         return res_column;
     }
diff --git a/tests/queries/0_stateless/01942_snowflakeToDateTime.reference b/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
index bed18023f6a..fa00a22bc63 100644
--- a/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
+++ b/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
@@ -1,3 +1,4 @@
 const column
 UTC	1426860704886947840	2021-08-15 10:57:56	DateTime(\'UTC\')	2021-08-15 10:57:56.492	DateTime64(3, \'UTC\')
 Asia/Shanghai	1426860704886947840	2021-08-15 18:57:56	DateTime(\'Asia/Shanghai\')	2021-08-15 18:57:56.492	DateTime64(3, \'Asia/Shanghai\')
+Asia/Singapore	2010-11-04 01:42:54
diff --git a/tests/queries/0_stateless/01942_snowflakeToDateTime.sql b/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
index f6f171afabf..3efccdddb2d 100644
--- a/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
+++ b/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
@@ -29,4 +29,6 @@ SELECT
 	snowflakeToDateTime(i64, tz) as dt,
 	toTypeName(dt),
 	snowflakeToDateTime64(i64, tz) as dt64,
-	toTypeName(dt64);
\ No newline at end of file
+	toTypeName(dt64);
+
+SELECT materialize('Asia/Singapore') a, snowflakeToDateTime(649::Int64, a) settings allow_nonconst_timezone_arguments = 1

From 326a3a3e8d719aebdc9ef9ee79f8b5fc8645183e Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 12 Jun 2023 16:46:10 +0000
Subject: [PATCH 361/722] Use query tree to rewrite the query

---
 src/Storages/StorageDistributed.cpp           | 335 +---------------
 src/Storages/StorageReplicatedMergeTree.cpp   |  22 +-
 src/Storages/buildQueryTreeForShard.cpp       | 372 ++++++++++++++++++
 src/Storages/buildQueryTreeForShard.h         |  15 +
 ...02771_parallel_replicas_analyzer.reference |   2 +-
 5 files changed, 406 insertions(+), 340 deletions(-)
 create mode 100644 src/Storages/buildQueryTreeForShard.cpp
 create mode 100644 src/Storages/buildQueryTreeForShard.h

diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index b91ad0b963a..1ec45ce3d57 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -81,6 +81,7 @@
 #include <TableFunctions/TableFunctionView.h>
 #include <TableFunctions/TableFunctionFactory.h>
 
+#include <Storages/buildQueryTreeForShard.h>
 #include <Storages/IStorageCluster.h>
 
 #include <Processors/Executors/PushingPipelineExecutor.h>
@@ -650,264 +651,6 @@ StorageSnapshotPtr StorageDistributed::getStorageSnapshotForQuery(
 namespace
 {
 
-/// Visitor that collect column source to columns mapping from query and all subqueries
-class CollectColumnSourceToColumnsVisitor : public InDepthQueryTreeVisitor<CollectColumnSourceToColumnsVisitor>
-{
-public:
-    struct Columns
-    {
-        NameSet column_names;
-        NamesAndTypes columns;
-
-        void addColumn(NameAndTypePair column)
-        {
-            if (column_names.contains(column.name))
-                return;
-
-            column_names.insert(column.name);
-            columns.push_back(std::move(column));
-        }
-    };
-
-    const std::unordered_map<QueryTreeNodePtr, Columns> & getColumnSourceToColumns() const
-    {
-        return column_source_to_columns;
-    }
-
-    void visitImpl(QueryTreeNodePtr & node)
-    {
-        auto * column_node = node->as<ColumnNode>();
-        if (!column_node)
-            return;
-
-        auto column_source = column_node->getColumnSourceOrNull();
-        if (!column_source)
-            return;
-
-        auto it = column_source_to_columns.find(column_source);
-        if (it == column_source_to_columns.end())
-        {
-            auto [insert_it, _] = column_source_to_columns.emplace(column_source, Columns());
-            it = insert_it;
-        }
-
-        it->second.addColumn(column_node->getColumn());
-    }
-
-private:
-    std::unordered_map<QueryTreeNodePtr, Columns> column_source_to_columns;
-};
-
-/** Visitor that rewrites IN and JOINs in query and all subqueries according to distributed_product_mode and
-  * prefer_global_in_and_join settings.
-  *
-  * Additionally collects GLOBAL JOIN and GLOBAL IN query nodes.
-  *
-  * If distributed_product_mode = deny, then visitor throws exception if there are multiple distributed tables.
-  * If distributed_product_mode = local, then visitor collects replacement map for tables that must be replaced
-  * with local tables.
-  * If distributed_product_mode = global or prefer_global_in_and_join setting is true, then visitor rewrites JOINs and IN functions that
-  * contain distributed tables to GLOBAL JOINs and GLOBAL IN functions.
-  * If distributed_product_mode = allow, then visitor does not rewrite query if there are multiple distributed tables.
-  */
-class DistributedProductModeRewriteInJoinVisitor : public InDepthQueryTreeVisitorWithContext<DistributedProductModeRewriteInJoinVisitor>
-{
-public:
-    using Base = InDepthQueryTreeVisitorWithContext<DistributedProductModeRewriteInJoinVisitor>;
-    using Base::Base;
-
-    explicit DistributedProductModeRewriteInJoinVisitor(const ContextPtr & context_)
-        : Base(context_)
-    {}
-
-    struct InFunctionOrJoin
-    {
-        QueryTreeNodePtr query_node;
-        size_t subquery_depth = 0;
-    };
-
-    const std::unordered_map<const IQueryTreeNode *, QueryTreeNodePtr> & getReplacementMap() const
-    {
-        return replacement_map;
-    }
-
-    const std::vector<InFunctionOrJoin> & getGlobalInOrJoinNodes() const
-    {
-        return global_in_or_join_nodes;
-    }
-
-    static bool needChildVisit(QueryTreeNodePtr & parent, QueryTreeNodePtr & child)
-    {
-        auto * function_node = parent->as<FunctionNode>();
-        if (function_node && isNameOfGlobalInFunction(function_node->getFunctionName()))
-            return false;
-
-        auto * join_node = parent->as<JoinNode>();
-        if (join_node && join_node->getLocality() == JoinLocality::Global && join_node->getRightTableExpression() == child)
-            return false;
-
-        return true;
-    }
-
-    void visitImpl(QueryTreeNodePtr & node)
-    {
-        auto * function_node = node->as<FunctionNode>();
-        auto * join_node = node->as<JoinNode>();
-
-        if ((function_node && isNameOfGlobalInFunction(function_node->getFunctionName())) ||
-            (join_node && join_node->getLocality() == JoinLocality::Global))
-        {
-            InFunctionOrJoin in_function_or_join_entry;
-            in_function_or_join_entry.query_node = node;
-            in_function_or_join_entry.subquery_depth = getSubqueryDepth();
-            global_in_or_join_nodes.push_back(std::move(in_function_or_join_entry));
-            return;
-        }
-
-        if ((function_node && isNameOfLocalInFunction(function_node->getFunctionName())) ||
-            (join_node && join_node->getLocality() != JoinLocality::Global))
-        {
-            InFunctionOrJoin in_function_or_join_entry;
-            in_function_or_join_entry.query_node = node;
-            in_function_or_join_entry.subquery_depth = getSubqueryDepth();
-            in_function_or_join_stack.push_back(in_function_or_join_entry);
-            return;
-        }
-
-        if (node->getNodeType() == QueryTreeNodeType::TABLE)
-            tryRewriteTableNodeIfNeeded(node);
-    }
-
-    void leaveImpl(QueryTreeNodePtr & node)
-    {
-        if (!in_function_or_join_stack.empty() && node.get() == in_function_or_join_stack.back().query_node.get())
-            in_function_or_join_stack.pop_back();
-    }
-
-private:
-    void tryRewriteTableNodeIfNeeded(const QueryTreeNodePtr & table_node)
-    {
-        const auto & table_node_typed = table_node->as<TableNode &>();
-        const auto * distributed_storage = typeid_cast<const StorageDistributed *>(table_node_typed.getStorage().get());
-        if (!distributed_storage)
-            return;
-
-        bool distributed_valid_for_rewrite = distributed_storage->getShardCount() >= 2;
-        if (!distributed_valid_for_rewrite)
-            return;
-
-        auto distributed_product_mode = getSettings().distributed_product_mode;
-
-        if (distributed_product_mode == DistributedProductMode::LOCAL)
-        {
-            StorageID remote_storage_id = StorageID{distributed_storage->getRemoteDatabaseName(),
-                distributed_storage->getRemoteTableName()};
-            auto resolved_remote_storage_id = getContext()->resolveStorageID(remote_storage_id);
-            const auto & distributed_storage_columns = table_node_typed.getStorageSnapshot()->metadata->getColumns();
-            auto storage = std::make_shared<StorageDummy>(resolved_remote_storage_id, distributed_storage_columns);
-            auto replacement_table_expression = std::make_shared<TableNode>(std::move(storage), getContext());
-            replacement_map.emplace(table_node.get(), std::move(replacement_table_expression));
-        }
-        else if ((distributed_product_mode == DistributedProductMode::GLOBAL || getSettings().prefer_global_in_and_join) &&
-            !in_function_or_join_stack.empty())
-        {
-            auto * in_or_join_node_to_modify = in_function_or_join_stack.back().query_node.get();
-
-            if (auto * in_function_to_modify = in_or_join_node_to_modify->as<FunctionNode>())
-            {
-                auto global_in_function_name = getGlobalInFunctionNameForLocalInFunctionName(in_function_to_modify->getFunctionName());
-                auto global_in_function_resolver = FunctionFactory::instance().get(global_in_function_name, getContext());
-                in_function_to_modify->resolveAsFunction(global_in_function_resolver->build(in_function_to_modify->getArgumentColumns()));
-            }
-            else if (auto * join_node_to_modify = in_or_join_node_to_modify->as<JoinNode>())
-            {
-                join_node_to_modify->setLocality(JoinLocality::Global);
-            }
-
-            global_in_or_join_nodes.push_back(in_function_or_join_stack.back());
-        }
-        else if (distributed_product_mode == DistributedProductMode::ALLOW)
-        {
-            return;
-        }
-        else if (distributed_product_mode == DistributedProductMode::DENY)
-        {
-            throw Exception(ErrorCodes::DISTRIBUTED_IN_JOIN_SUBQUERY_DENIED,
-                "Double-distributed IN/JOIN subqueries is denied (distributed_product_mode = 'deny'). "
-                "You may rewrite query to use local tables "
-                "in subqueries, or use GLOBAL keyword, or set distributed_product_mode to suitable value.");
-        }
-    }
-
-    std::vector<InFunctionOrJoin> in_function_or_join_stack;
-    std::unordered_map<const IQueryTreeNode *, QueryTreeNodePtr> replacement_map;
-    std::vector<InFunctionOrJoin> global_in_or_join_nodes;
-};
-
-/** Execute subquery node and put result in mutable context temporary table.
-  * Returns table node that is initialized with temporary table storage.
-  */
-TableNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
-    ContextMutablePtr & mutable_context,
-    size_t subquery_depth)
-{
-    auto subquery_hash = subquery_node->getTreeHash();
-    String temporary_table_name = fmt::format("_data_{}_{}", subquery_hash.first, subquery_hash.second);
-
-    const auto & external_tables = mutable_context->getExternalTables();
-    auto external_table_it = external_tables.find(temporary_table_name);
-    if (external_table_it != external_tables.end())
-    {
-        auto temporary_table_expression_node = std::make_shared<TableNode>(external_table_it->second, mutable_context);
-        temporary_table_expression_node->setTemporaryTableName(temporary_table_name);
-        return temporary_table_expression_node;
-    }
-
-    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth, true /*is_subquery*/);
-    auto context_copy = Context::createCopy(mutable_context);
-    updateContextForSubqueryExecution(context_copy);
-
-    InterpreterSelectQueryAnalyzer interpreter(subquery_node, context_copy, subquery_options);
-    auto & query_plan = interpreter.getQueryPlan();
-
-    auto sample_block_with_unique_names = query_plan.getCurrentDataStream().header;
-    makeUniqueColumnNamesInBlock(sample_block_with_unique_names);
-
-    if (!blocksHaveEqualStructure(sample_block_with_unique_names, query_plan.getCurrentDataStream().header))
-    {
-        auto actions_dag = ActionsDAG::makeConvertingActions(
-            query_plan.getCurrentDataStream().header.getColumnsWithTypeAndName(),
-            sample_block_with_unique_names.getColumnsWithTypeAndName(),
-            ActionsDAG::MatchColumnsMode::Position);
-        auto converting_step = std::make_unique<ExpressionStep>(query_plan.getCurrentDataStream(), std::move(actions_dag));
-        query_plan.addStep(std::move(converting_step));
-    }
-
-    Block sample = interpreter.getSampleBlock();
-    NamesAndTypesList columns = sample.getNamesAndTypesList();
-
-    auto external_storage_holder = TemporaryTableHolder(
-        mutable_context,
-        ColumnsDescription{columns},
-        ConstraintsDescription{},
-        nullptr /*query*/,
-        true /*create_for_global_subquery*/);
-
-    StoragePtr external_storage = external_storage_holder.getTable();
-    auto temporary_table_expression_node = std::make_shared<TableNode>(external_storage, mutable_context);
-    temporary_table_expression_node->setTemporaryTableName(temporary_table_name);
-
-    auto table_out = external_storage->write({}, external_storage->getInMemoryMetadataPtr(), mutable_context, /*async_insert=*/false);
-    auto io = interpreter.execute();
-    io.pipeline.complete(std::move(table_out));
-    CompletedPipelineExecutor executor(io.pipeline);
-    executor.execute();
-
-    mutable_context->addExternalTable(temporary_table_name, std::move(external_storage_holder));
-
-    return temporary_table_expression_node;
-}
-
 QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
     const StorageSnapshotPtr & distributed_storage_snapshot,
     const StorageID & remote_storage_id,
@@ -963,81 +706,7 @@ QueryTreeNodePtr buildQueryTreeDistributed(SelectQueryInfo & query_info,
 
     auto query_tree_to_modify = query_info.query_tree->cloneAndReplace(query_info.table_expression, std::move(replacement_table_expression));
 
-    CollectColumnSourceToColumnsVisitor collect_column_source_to_columns_visitor;
-    collect_column_source_to_columns_visitor.visit(query_tree_to_modify);
-
-    const auto & column_source_to_columns = collect_column_source_to_columns_visitor.getColumnSourceToColumns();
-
-    DistributedProductModeRewriteInJoinVisitor visitor(query_info.planner_context->getQueryContext());
-    visitor.visit(query_tree_to_modify);
-
-    auto replacement_map = visitor.getReplacementMap();
-    const auto & global_in_or_join_nodes = visitor.getGlobalInOrJoinNodes();
-
-    for (const auto & global_in_or_join_node : global_in_or_join_nodes)
-    {
-        if (auto * join_node = global_in_or_join_node.query_node->as<JoinNode>())
-        {
-            auto join_right_table_expression = join_node->getRightTableExpression();
-            auto join_right_table_expression_node_type = join_right_table_expression->getNodeType();
-
-            QueryTreeNodePtr subquery_node;
-
-            if (join_right_table_expression_node_type == QueryTreeNodeType::QUERY ||
-                join_right_table_expression_node_type == QueryTreeNodeType::UNION)
-            {
-                subquery_node = join_right_table_expression;
-            }
-            else if (join_right_table_expression_node_type == QueryTreeNodeType::TABLE ||
-                join_right_table_expression_node_type == QueryTreeNodeType::TABLE_FUNCTION)
-            {
-                const auto & columns = column_source_to_columns.at(join_right_table_expression).columns;
-                subquery_node = buildSubqueryToReadColumnsFromTableExpression(columns,
-                    join_right_table_expression,
-                    planner_context->getQueryContext());
-            }
-            else
-            {
-                throw Exception(ErrorCodes::LOGICAL_ERROR,
-                    "Expected JOIN right table expression to be table, table function, query or union node. Actual {}",
-                    join_right_table_expression->formatASTForErrorMessage());
-            }
-
-            auto temporary_table_expression_node = executeSubqueryNode(subquery_node,
-                planner_context->getMutableQueryContext(),
-                global_in_or_join_node.subquery_depth);
-            temporary_table_expression_node->setAlias(join_right_table_expression->getAlias());
-
-            replacement_map.emplace(join_right_table_expression.get(), std::move(temporary_table_expression_node));
-            continue;
-        }
-        else if (auto * in_function_node = global_in_or_join_node.query_node->as<FunctionNode>())
-        {
-            auto & in_function_subquery_node = in_function_node->getArguments().getNodes().at(1);
-            auto in_function_node_type = in_function_subquery_node->getNodeType();
-            if (in_function_node_type != QueryTreeNodeType::QUERY && in_function_node_type != QueryTreeNodeType::UNION)
-                continue;
-
-            auto temporary_table_expression_node = executeSubqueryNode(in_function_subquery_node,
-                planner_context->getMutableQueryContext(),
-                global_in_or_join_node.subquery_depth);
-
-            in_function_subquery_node = std::move(temporary_table_expression_node);
-        }
-        else
-        {
-            throw Exception(ErrorCodes::LOGICAL_ERROR,
-                "Expected global IN or JOIN query node. Actual {}",
-                global_in_or_join_node.query_node->formatASTForErrorMessage());
-        }
-    }
-
-    if (!replacement_map.empty())
-        query_tree_to_modify = query_tree_to_modify->cloneAndReplace(replacement_map);
-
-    removeGroupingFunctionSpecializations(query_tree_to_modify);
-
-    return query_tree_to_modify;
+    return buildQueryTreeForShard(query_info, query_tree_to_modify);
 }
 
 }
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 61d1442df92..fafb3b124f2 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -21,6 +21,7 @@
 
 #include <base/sort.h>
 
+#include <Storages/buildQueryTreeForShard.h>
 #include <Storages/AlterCommands.h>
 #include <Storages/ColumnsDescription.h>
 #include <Storages/Freeze.h>
@@ -74,6 +75,8 @@
 #include <Processors/QueryPlan/ReadFromPreparedSource.h>
 #include <Processors/Sinks/EmptySink.h>
 
+#include <Planner/Utils.h>
+
 #include <IO/ReadBufferFromString.h>
 #include <IO/Operators.h>
 #include <IO/ConnectionTimeouts.h>
@@ -4734,20 +4737,27 @@ void StorageReplicatedMergeTree::read(
     {
         auto table_id = getStorageID();
 
-        const auto & modified_query_ast =  ClusterProxy::rewriteSelectQuery(
-            local_context, query_info.query,
-            table_id.database_name, table_id.table_name, /*remote_table_function_ptr*/nullptr);
-
-        auto cluster = local_context->getCluster(local_context->getSettingsRef().cluster_for_parallel_replicas);
+        ASTPtr modified_query_ast;
 
         Block header;
 
         if (local_context->getSettingsRef().allow_experimental_analyzer)
+        {
+            auto modified_query_tree = buildQueryTreeForShard(query_info, query_info.query_tree);
+
             header = InterpreterSelectQueryAnalyzer::getSampleBlock(
-                modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze());
+                modified_query_tree, local_context, SelectQueryOptions(processed_stage).analyze());
+            modified_query_ast = queryNodeToSelectQuery(modified_query_tree);
+        }
         else
+        {
             header
                 = InterpreterSelectQuery(modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze()).getSampleBlock();
+            modified_query_ast = ClusterProxy::rewriteSelectQuery(local_context, query_info.query,
+                table_id.database_name, table_id.table_name, /*remote_table_function_ptr*/nullptr);
+        }
+
+        auto cluster = local_context->getCluster(local_context->getSettingsRef().cluster_for_parallel_replicas);
 
         ClusterProxy::SelectStreamFactory select_stream_factory =
             ClusterProxy::SelectStreamFactory(
diff --git a/src/Storages/buildQueryTreeForShard.cpp b/src/Storages/buildQueryTreeForShard.cpp
new file mode 100644
index 00000000000..a42d67d9aa7
--- /dev/null
+++ b/src/Storages/buildQueryTreeForShard.cpp
@@ -0,0 +1,372 @@
+#include <Storages/buildQueryTreeForShard.h>
+
+#include <Analyzer/ColumnNode.h>
+#include <Analyzer/FunctionNode.h>
+#include <Analyzer/IQueryTreeNode.h>
+#include <Analyzer/InDepthQueryTreeVisitor.h>
+#include <Analyzer/TableNode.h>
+#include <Analyzer/JoinNode.h>
+#include <Analyzer/Utils.h>
+#include <Functions/FunctionFactory.h>
+#include <Interpreters/InterpreterSelectQueryAnalyzer.h>
+#include <Storages/removeGroupingFunctionSpecializations.h>
+#include <Storages/StorageDistributed.h>
+#include <Storages/StorageDummy.h>
+#include <Planner/Utils.h>
+#include <Processors/Executors/CompletedPipelineExecutor.h>
+#include <Processors/QueryPlan/ExpressionStep.h>
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int DISTRIBUTED_IN_JOIN_SUBQUERY_DENIED;
+}
+
+namespace
+{
+
+/// Visitor that collect column source to columns mapping from query and all subqueries
+class CollectColumnSourceToColumnsVisitor : public InDepthQueryTreeVisitor<CollectColumnSourceToColumnsVisitor>
+{
+public:
+    struct Columns
+    {
+        NameSet column_names;
+        NamesAndTypes columns;
+
+        void addColumn(NameAndTypePair column)
+        {
+            if (column_names.contains(column.name))
+                return;
+
+            column_names.insert(column.name);
+            columns.push_back(std::move(column));
+        }
+    };
+
+    const std::unordered_map<QueryTreeNodePtr, Columns> & getColumnSourceToColumns() const
+    {
+        return column_source_to_columns;
+    }
+
+    void visitImpl(QueryTreeNodePtr & node)
+    {
+        auto * column_node = node->as<ColumnNode>();
+        if (!column_node)
+            return;
+
+        auto column_source = column_node->getColumnSourceOrNull();
+        if (!column_source)
+            return;
+
+        auto it = column_source_to_columns.find(column_source);
+        if (it == column_source_to_columns.end())
+        {
+            auto [insert_it, _] = column_source_to_columns.emplace(column_source, Columns());
+            it = insert_it;
+        }
+
+        it->second.addColumn(column_node->getColumn());
+    }
+
+private:
+    std::unordered_map<QueryTreeNodePtr, Columns> column_source_to_columns;
+};
+
+/** Visitor that rewrites IN and JOINs in query and all subqueries according to distributed_product_mode and
+  * prefer_global_in_and_join settings.
+  *
+  * Additionally collects GLOBAL JOIN and GLOBAL IN query nodes.
+  *
+  * If distributed_product_mode = deny, then visitor throws exception if there are multiple distributed tables.
+  * If distributed_product_mode = local, then visitor collects replacement map for tables that must be replaced
+  * with local tables.
+  * If distributed_product_mode = global or prefer_global_in_and_join setting is true, then visitor rewrites JOINs and IN functions that
+  * contain distributed tables to GLOBAL JOINs and GLOBAL IN functions.
+  * If distributed_product_mode = allow, then visitor does not rewrite query if there are multiple distributed tables.
+  */
+class DistributedProductModeRewriteInJoinVisitor : public InDepthQueryTreeVisitorWithContext<DistributedProductModeRewriteInJoinVisitor>
+{
+public:
+    using Base = InDepthQueryTreeVisitorWithContext<DistributedProductModeRewriteInJoinVisitor>;
+    using Base::Base;
+
+    explicit DistributedProductModeRewriteInJoinVisitor(const ContextPtr & context_)
+        : Base(context_)
+    {}
+
+    struct InFunctionOrJoin
+    {
+        QueryTreeNodePtr query_node;
+        size_t subquery_depth = 0;
+    };
+
+    const std::unordered_map<const IQueryTreeNode *, QueryTreeNodePtr> & getReplacementMap() const
+    {
+        return replacement_map;
+    }
+
+    const std::vector<InFunctionOrJoin> & getGlobalInOrJoinNodes() const
+    {
+        return global_in_or_join_nodes;
+    }
+
+    static bool needChildVisit(QueryTreeNodePtr & parent, QueryTreeNodePtr & child)
+    {
+        auto * function_node = parent->as<FunctionNode>();
+        if (function_node && isNameOfGlobalInFunction(function_node->getFunctionName()))
+            return false;
+
+        auto * join_node = parent->as<JoinNode>();
+        if (join_node && join_node->getLocality() == JoinLocality::Global && join_node->getRightTableExpression() == child)
+            return false;
+
+        return true;
+    }
+
+    void visitImpl(QueryTreeNodePtr & node)
+    {
+        auto * function_node = node->as<FunctionNode>();
+        auto * join_node = node->as<JoinNode>();
+
+        if ((function_node && isNameOfGlobalInFunction(function_node->getFunctionName())) ||
+            (join_node && join_node->getLocality() == JoinLocality::Global))
+        {
+            InFunctionOrJoin in_function_or_join_entry;
+            in_function_or_join_entry.query_node = node;
+            in_function_or_join_entry.subquery_depth = getSubqueryDepth();
+            global_in_or_join_nodes.push_back(std::move(in_function_or_join_entry));
+            return;
+        }
+
+        if ((function_node && isNameOfLocalInFunction(function_node->getFunctionName())) ||
+            (join_node && join_node->getLocality() != JoinLocality::Global))
+        {
+            InFunctionOrJoin in_function_or_join_entry;
+            in_function_or_join_entry.query_node = node;
+            in_function_or_join_entry.subquery_depth = getSubqueryDepth();
+            in_function_or_join_stack.push_back(in_function_or_join_entry);
+            return;
+        }
+
+        if (node->getNodeType() == QueryTreeNodeType::TABLE)
+            tryRewriteTableNodeIfNeeded(node);
+    }
+
+    void leaveImpl(QueryTreeNodePtr & node)
+    {
+        if (!in_function_or_join_stack.empty() && node.get() == in_function_or_join_stack.back().query_node.get())
+            in_function_or_join_stack.pop_back();
+    }
+
+private:
+    void tryRewriteTableNodeIfNeeded(const QueryTreeNodePtr & table_node)
+    {
+        const auto & table_node_typed = table_node->as<TableNode &>();
+        const auto * distributed_storage = typeid_cast<const StorageDistributed *>(table_node_typed.getStorage().get());
+        if (!distributed_storage)
+            return;
+
+        bool distributed_valid_for_rewrite = distributed_storage->getShardCount() >= 2;
+        if (!distributed_valid_for_rewrite)
+            return;
+
+        auto distributed_product_mode = getSettings().distributed_product_mode;
+
+        if (distributed_product_mode == DistributedProductMode::LOCAL)
+        {
+            StorageID remote_storage_id = StorageID{distributed_storage->getRemoteDatabaseName(),
+                distributed_storage->getRemoteTableName()};
+            auto resolved_remote_storage_id = getContext()->resolveStorageID(remote_storage_id);
+            const auto & distributed_storage_columns = table_node_typed.getStorageSnapshot()->metadata->getColumns();
+            auto storage = std::make_shared<StorageDummy>(resolved_remote_storage_id, distributed_storage_columns);
+            auto replacement_table_expression = std::make_shared<TableNode>(std::move(storage), getContext());
+            replacement_map.emplace(table_node.get(), std::move(replacement_table_expression));
+        }
+        else if ((distributed_product_mode == DistributedProductMode::GLOBAL || getSettings().prefer_global_in_and_join) &&
+            !in_function_or_join_stack.empty())
+        {
+            auto * in_or_join_node_to_modify = in_function_or_join_stack.back().query_node.get();
+
+            if (auto * in_function_to_modify = in_or_join_node_to_modify->as<FunctionNode>())
+            {
+                auto global_in_function_name = getGlobalInFunctionNameForLocalInFunctionName(in_function_to_modify->getFunctionName());
+                auto global_in_function_resolver = FunctionFactory::instance().get(global_in_function_name, getContext());
+                in_function_to_modify->resolveAsFunction(global_in_function_resolver->build(in_function_to_modify->getArgumentColumns()));
+            }
+            else if (auto * join_node_to_modify = in_or_join_node_to_modify->as<JoinNode>())
+            {
+                join_node_to_modify->setLocality(JoinLocality::Global);
+            }
+
+            global_in_or_join_nodes.push_back(in_function_or_join_stack.back());
+        }
+        else if (distributed_product_mode == DistributedProductMode::ALLOW)
+        {
+            return;
+        }
+        else if (distributed_product_mode == DistributedProductMode::DENY)
+        {
+            throw Exception(ErrorCodes::DISTRIBUTED_IN_JOIN_SUBQUERY_DENIED,
+                "Double-distributed IN/JOIN subqueries is denied (distributed_product_mode = 'deny'). "
+                "You may rewrite query to use local tables "
+                "in subqueries, or use GLOBAL keyword, or set distributed_product_mode to suitable value.");
+        }
+    }
+
+    std::vector<InFunctionOrJoin> in_function_or_join_stack;
+    std::unordered_map<const IQueryTreeNode *, QueryTreeNodePtr> replacement_map;
+    std::vector<InFunctionOrJoin> global_in_or_join_nodes;
+};
+
+/** Execute subquery node and put result in mutable context temporary table.
+  * Returns table node that is initialized with temporary table storage.
+  */
+TableNodePtr executeSubqueryNode(const QueryTreeNodePtr & subquery_node,
+    ContextMutablePtr & mutable_context,
+    size_t subquery_depth)
+{
+    auto subquery_hash = subquery_node->getTreeHash();
+    String temporary_table_name = fmt::format("_data_{}_{}", subquery_hash.first, subquery_hash.second);
+
+    const auto & external_tables = mutable_context->getExternalTables();
+    auto external_table_it = external_tables.find(temporary_table_name);
+    if (external_table_it != external_tables.end())
+    {
+        auto temporary_table_expression_node = std::make_shared<TableNode>(external_table_it->second, mutable_context);
+        temporary_table_expression_node->setTemporaryTableName(temporary_table_name);
+        return temporary_table_expression_node;
+    }
+
+    auto subquery_options = SelectQueryOptions(QueryProcessingStage::Complete, subquery_depth, true /*is_subquery*/);
+    auto context_copy = Context::createCopy(mutable_context);
+    updateContextForSubqueryExecution(context_copy);
+
+    InterpreterSelectQueryAnalyzer interpreter(subquery_node, context_copy, subquery_options);
+    auto & query_plan = interpreter.getQueryPlan();
+
+    auto sample_block_with_unique_names = query_plan.getCurrentDataStream().header;
+    makeUniqueColumnNamesInBlock(sample_block_with_unique_names);
+
+    if (!blocksHaveEqualStructure(sample_block_with_unique_names, query_plan.getCurrentDataStream().header))
+    {
+        auto actions_dag = ActionsDAG::makeConvertingActions(
+            query_plan.getCurrentDataStream().header.getColumnsWithTypeAndName(),
+            sample_block_with_unique_names.getColumnsWithTypeAndName(),
+            ActionsDAG::MatchColumnsMode::Position);
+        auto converting_step = std::make_unique<ExpressionStep>(query_plan.getCurrentDataStream(), std::move(actions_dag));
+        query_plan.addStep(std::move(converting_step));
+    }
+
+    Block sample = interpreter.getSampleBlock();
+    NamesAndTypesList columns = sample.getNamesAndTypesList();
+
+    auto external_storage_holder = TemporaryTableHolder(
+        mutable_context,
+        ColumnsDescription{columns},
+        ConstraintsDescription{},
+        nullptr /*query*/,
+        true /*create_for_global_subquery*/);
+
+    StoragePtr external_storage = external_storage_holder.getTable();
+    auto temporary_table_expression_node = std::make_shared<TableNode>(external_storage, mutable_context);
+    temporary_table_expression_node->setTemporaryTableName(temporary_table_name);
+
+    auto table_out = external_storage->write({}, external_storage->getInMemoryMetadataPtr(), mutable_context, /*async_insert=*/false);
+    auto io = interpreter.execute();
+    io.pipeline.complete(std::move(table_out));
+    CompletedPipelineExecutor executor(io.pipeline);
+    executor.execute();
+
+    mutable_context->addExternalTable(temporary_table_name, std::move(external_storage_holder));
+
+    return temporary_table_expression_node;
+}
+
+}
+
+QueryTreeNodePtr buildQueryTreeForShard(SelectQueryInfo & query_info, QueryTreeNodePtr query_tree_to_modify)
+{
+    auto & planner_context = query_info.planner_context;
+    const auto & query_context = planner_context->getQueryContext();
+
+    CollectColumnSourceToColumnsVisitor collect_column_source_to_columns_visitor;
+    collect_column_source_to_columns_visitor.visit(query_tree_to_modify);
+
+    const auto & column_source_to_columns = collect_column_source_to_columns_visitor.getColumnSourceToColumns();
+
+    DistributedProductModeRewriteInJoinVisitor visitor(query_info.planner_context->getQueryContext());
+    visitor.visit(query_tree_to_modify);
+
+    auto replacement_map = visitor.getReplacementMap();
+    const auto & global_in_or_join_nodes = visitor.getGlobalInOrJoinNodes();
+
+    for (const auto & global_in_or_join_node : global_in_or_join_nodes)
+    {
+        if (auto * join_node = global_in_or_join_node.query_node->as<JoinNode>())
+        {
+            auto join_right_table_expression = join_node->getRightTableExpression();
+            auto join_right_table_expression_node_type = join_right_table_expression->getNodeType();
+
+            QueryTreeNodePtr subquery_node;
+
+            if (join_right_table_expression_node_type == QueryTreeNodeType::QUERY ||
+                join_right_table_expression_node_type == QueryTreeNodeType::UNION)
+            {
+                subquery_node = join_right_table_expression;
+            }
+            else if (join_right_table_expression_node_type == QueryTreeNodeType::TABLE ||
+                join_right_table_expression_node_type == QueryTreeNodeType::TABLE_FUNCTION)
+            {
+                const auto & columns = column_source_to_columns.at(join_right_table_expression).columns;
+                subquery_node = buildSubqueryToReadColumnsFromTableExpression(columns,
+                    join_right_table_expression,
+                    planner_context->getQueryContext());
+            }
+            else
+            {
+                throw Exception(ErrorCodes::LOGICAL_ERROR,
+                    "Expected JOIN right table expression to be table, table function, query or union node. Actual {}",
+                    join_right_table_expression->formatASTForErrorMessage());
+            }
+
+            auto temporary_table_expression_node = executeSubqueryNode(subquery_node,
+                planner_context->getMutableQueryContext(),
+                global_in_or_join_node.subquery_depth);
+            temporary_table_expression_node->setAlias(join_right_table_expression->getAlias());
+
+            replacement_map.emplace(join_right_table_expression.get(), std::move(temporary_table_expression_node));
+            continue;
+        }
+        else if (auto * in_function_node = global_in_or_join_node.query_node->as<FunctionNode>())
+        {
+            auto & in_function_subquery_node = in_function_node->getArguments().getNodes().at(1);
+            auto in_function_node_type = in_function_subquery_node->getNodeType();
+            if (in_function_node_type != QueryTreeNodeType::QUERY && in_function_node_type != QueryTreeNodeType::UNION)
+                continue;
+
+            auto temporary_table_expression_node = executeSubqueryNode(in_function_subquery_node,
+                planner_context->getMutableQueryContext(),
+                global_in_or_join_node.subquery_depth);
+
+            in_function_subquery_node = std::move(temporary_table_expression_node);
+        }
+        else
+        {
+            throw Exception(ErrorCodes::LOGICAL_ERROR,
+                "Expected global IN or JOIN query node. Actual {}",
+                global_in_or_join_node.query_node->formatASTForErrorMessage());
+        }
+    }
+
+    if (!replacement_map.empty())
+        query_tree_to_modify = query_tree_to_modify->cloneAndReplace(replacement_map);
+
+    removeGroupingFunctionSpecializations(query_tree_to_modify);
+
+    return query_tree_to_modify;
+}
+
+}
diff --git a/src/Storages/buildQueryTreeForShard.h b/src/Storages/buildQueryTreeForShard.h
new file mode 100644
index 00000000000..05d63faeb9f
--- /dev/null
+++ b/src/Storages/buildQueryTreeForShard.h
@@ -0,0 +1,15 @@
+#pragma once
+
+#include <memory>
+
+namespace DB
+{
+
+struct SelectQueryInfo;
+
+class IQueryTreeNode;
+using QueryTreeNodePtr = std::shared_ptr<IQueryTreeNode>;
+
+QueryTreeNodePtr buildQueryTreeForShard(SelectQueryInfo & query_info, QueryTreeNodePtr query_tree_to_modify);
+
+}
diff --git a/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference b/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference
index 4e93c530f7b..f688db940d9 100644
--- a/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference
+++ b/tests/queries/0_stateless/02771_parallel_replicas_analyzer.reference
@@ -9,4 +9,4 @@
 7885388429666205427
 8124171311239967992
 1	1	-- Simple query with analyzer and pure parallel replicas\nSELECT number\nFROM join_inner_table__fuzz_146_replicated\n    SETTINGS\n    allow_experimental_analyzer = 1,\n    max_parallel_replicas = 2,\n    cluster_for_parallel_replicas = \'test_cluster_one_shard_three_replicas_localhost\',\n    allow_experimental_parallel_reading_from_replicas = 1,\n    use_hedged_requests = 0;
-0	2	SELECT `default`.`join_inner_table__fuzz_146_replicated`.`number` AS `number` FROM `default`.`join_inner_table__fuzz_146_replicated`
+0	2	SELECT `join_inner_table__fuzz_146_replicated`.`number` AS `number` FROM `default`.`join_inner_table__fuzz_146_replicated` SETTINGS allow_experimental_analyzer = 1, max_parallel_replicas = 2, cluster_for_parallel_replicas = \'test_cluster_one_shard_three_replicas_localhost\', allow_experimental_parallel_reading_from_replicas = 1, use_hedged_requests = 0

From d05f89f8f5ec3793256cae1557e2af60650290cf Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Mon, 12 Jun 2023 17:33:15 +0000
Subject: [PATCH 362/722] Fix style

---
 src/Storages/StorageDistributed.cpp     | 1 -
 src/Storages/buildQueryTreeForShard.cpp | 1 +
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/StorageDistributed.cpp b/src/Storages/StorageDistributed.cpp
index 1ec45ce3d57..0472ce6f832 100644
--- a/src/Storages/StorageDistributed.cpp
+++ b/src/Storages/StorageDistributed.cpp
@@ -154,7 +154,6 @@ namespace ErrorCodes
     extern const int DISTRIBUTED_TOO_MANY_PENDING_BYTES;
     extern const int ARGUMENT_OUT_OF_BOUND;
     extern const int TOO_LARGE_DISTRIBUTED_DEPTH;
-    extern const int DISTRIBUTED_IN_JOIN_SUBQUERY_DENIED;
 }
 
 namespace ActionLocks
diff --git a/src/Storages/buildQueryTreeForShard.cpp b/src/Storages/buildQueryTreeForShard.cpp
index a42d67d9aa7..fa4730cbe84 100644
--- a/src/Storages/buildQueryTreeForShard.cpp
+++ b/src/Storages/buildQueryTreeForShard.cpp
@@ -21,6 +21,7 @@ namespace DB
 
 namespace ErrorCodes
 {
+    extern const int LOGICAL_ERROR;
     extern const int DISTRIBUTED_IN_JOIN_SUBQUERY_DENIED;
 }
 

From a4285d56b22aafe453309ce728c7380666626576 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Wed, 31 May 2023 12:37:46 -0700
Subject: [PATCH 363/722] Fix compilation error on big-endian platforms

---
 src/Functions/FunctionsCodingIP.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Functions/FunctionsCodingIP.cpp b/src/Functions/FunctionsCodingIP.cpp
index 2671418fc7b..897b24d90e0 100644
--- a/src/Functions/FunctionsCodingIP.cpp
+++ b/src/Functions/FunctionsCodingIP.cpp
@@ -580,7 +580,7 @@ private:
 #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
             unalignedStoreLittleEndian<UInt64>(buf + 8, 0x00000000FFFF0000ull | (static_cast<UInt64>(ntohl(in)) << 32));
 #else
-            unalignedStoreLittleEndian<UInt64>(buf + 8, 0x00000000FFFF0000ull | (static_cast<UInt64>(__builtin_bswap32(in))) << 32));
+            unalignedStoreLittleEndian<UInt64>(buf + 8, 0x00000000FFFF0000ull | (static_cast<UInt64>(std::byteswap(in))) << 32);
 #endif
     }
 };

From edb4a644b1ef9fdcba7f53c60ed37438d610ae9a Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Thu, 8 Jun 2023 10:21:24 -0400
Subject: [PATCH 364/722] Update FunctionsCodingIP.cpp

---
 src/Functions/FunctionsCodingIP.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Functions/FunctionsCodingIP.cpp b/src/Functions/FunctionsCodingIP.cpp
index 897b24d90e0..7bdbac6531d 100644
--- a/src/Functions/FunctionsCodingIP.cpp
+++ b/src/Functions/FunctionsCodingIP.cpp
@@ -580,7 +580,7 @@ private:
 #if __BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__
             unalignedStoreLittleEndian<UInt64>(buf + 8, 0x00000000FFFF0000ull | (static_cast<UInt64>(ntohl(in)) << 32));
 #else
-            unalignedStoreLittleEndian<UInt64>(buf + 8, 0x00000000FFFF0000ull | (static_cast<UInt64>(std::byteswap(in))) << 32);
+            unalignedStoreLittleEndian<UInt64>(buf + 8, 0x00000000FFFF0000ull | (static_cast<UInt64>(std::byteswap(in)) << 32));
 #endif
     }
 };

From e6e8576864421bd2db043d269dfe65d1bf4f85aa Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Mon, 12 Jun 2023 17:04:33 -0300
Subject: [PATCH 365/722] Update mergetree.md

---
 docs/en/engines/table-engines/mergetree-family/mergetree.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index 61276110138..dbde1a90f67 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -1138,7 +1138,7 @@ These parameters define the cache layer:
 
 Cache parameters:
 - `path` — The path where metadata for the cache is stored.
-- `max_size` — The size (amount of memory) that the cache can grow to.
+- `max_size` — The size (amount of disk space) that the cache can grow to.
 
 :::tip
 There are several other cache parameters that you can use to tune your storage, see [using local cache](/docs/en/operations/storing-data.md/#using-local-cache) for the details.

From 4f39ee51ae867b219735290125f8dc91d461abf6 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Mon, 12 Jun 2023 20:06:57 +0000
Subject: [PATCH 366/722] Update Annoy docs

---
 .../mergetree-family/annindexes.md            | 20 +++++++++----------
 src/Parsers/ASTIndexDeclaration.h             |  3 +++
 src/Parsers/ParserCreateIndexQuery.cpp        |  4 ++--
 src/Parsers/ParserCreateQuery.cpp             |  4 ++--
 4 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 2b0b77a0735..16e244077a7 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -100,7 +100,7 @@ ANN indexes support two types of queries:
 
 :::tip
 To avoid writing out large vectors, you can use [query
-parameters](/docs/en//interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters), e.g.
+parameters](/docs/en/interfaces/cli.md#queries-with-parameters-cli-queries-with-parameters), e.g.
 
 ```bash
 clickhouse-client --param_vec='hello' --query="SELECT * FROM table WHERE L2Distance(vectors, {vec: Array(Float32)}) < 1.0"
@@ -128,14 +128,14 @@ granularity of granules, sub-indexes extrapolate matching rows to granule granul
 skip data at the granularity of index blocks.
 
 The `GRANULARITY` parameter determines how many ANN sub-indexes are created. Bigger `GRANULARITY` values mean fewer but larger ANN
-sub-indexes, up to the point where a column (or a column part) has only a single sub-index. In that case, the sub-index has a "global" view of
-all column rows and can directly return all granules of the column (part) with relevant rows (there are at at most `LIMIT <N>`-many
-such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a brute-force distance
-calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to `LIMIT N`-many granules.
-As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases equally good, only the
-processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall back to a smaller
-`GRANULARITY` values only in case of problems like excessive memory consumption of the ANN structures. If no `GRANULARITY` was specified for
-ANN indexes, the default value is 100 million.
+sub-indexes, up to the point where a column (or a column's data part) has only a single sub-index. In that case, the sub-index has a
+"global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most `LIMIT
+<N>`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
+brute-force distance calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to
+`LIMIT N`-many granules. As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases
+equally good, only the processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall
+back to a smaller `GRANULARITY` values only in case of problems like excessive memory consumption of the ANN structures. If no `GRANULARITY`
+was specified for ANN indexes, the default value is 100 million.
 
 
 # Available ANN Indexes
@@ -204,7 +204,7 @@ values mean more accurate results at the cost of longer query runtime:
 
 ``` sql
 SELECT *
-FROM table_name [WHERE ...]
+FROM table_name
 ORDER BY L2Distance(vectors, Point)
 LIMIT N
 SETTINGS annoy_index_search_k_nodes=100
diff --git a/src/Parsers/ASTIndexDeclaration.h b/src/Parsers/ASTIndexDeclaration.h
index bd52a611f3f..6ed241f75ab 100644
--- a/src/Parsers/ASTIndexDeclaration.h
+++ b/src/Parsers/ASTIndexDeclaration.h
@@ -12,6 +12,9 @@ class ASTFunction;
 class ASTIndexDeclaration : public IAST
 {
 public:
+    static const auto DEFAULT_INDEX_GRANULARITY = 1uz;
+    static const auto DEFAULT_ANNOY_INDEX_GRANULARITY = 100'000'000uz;
+
     String name;
     IAST * expr;
     ASTFunction * type;
diff --git a/src/Parsers/ParserCreateIndexQuery.cpp b/src/Parsers/ParserCreateIndexQuery.cpp
index 57afd3fb99e..f231573b920 100644
--- a/src/Parsers/ParserCreateIndexQuery.cpp
+++ b/src/Parsers/ParserCreateIndexQuery.cpp
@@ -52,9 +52,9 @@ bool ParserCreateIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected
     else
     {
         if (index->type->name == "annoy")
-            index->granularity = 100'000'000;
+            index->granularity = ASTIndexDeclaration::DEFAULT_ANNOY_INDEX_GRANULARITY;
         else
-            index->granularity = 1;
+            index->granularity = ASTIndexDeclaration::DEFAULT_INDEX_GRANULARITY;
     }
     node = index;
 
diff --git a/src/Parsers/ParserCreateQuery.cpp b/src/Parsers/ParserCreateQuery.cpp
index c6273f369b1..adf3513ba40 100644
--- a/src/Parsers/ParserCreateQuery.cpp
+++ b/src/Parsers/ParserCreateQuery.cpp
@@ -147,9 +147,9 @@ bool ParserIndexDeclaration::parseImpl(Pos & pos, ASTPtr & node, Expected & expe
     else
     {
         if (index->type->name == "annoy")
-            index->granularity = 100'000'000;
+            index->granularity = ASTIndexDeclaration::DEFAULT_ANNOY_INDEX_GRANULARITY;
         else
-            index->granularity = 1;
+            index->granularity = ASTIndexDeclaration::DEFAULT_INDEX_GRANULARITY;
     }
 
     node = index;

From 002c15823c26c3e0c577a4dd8ec8f319b3120a78 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 12 Jun 2023 16:44:46 -0700
Subject: [PATCH 367/722] Perform in-place endianness transform because of
 padding

---
 src/AggregateFunctions/ReservoirSamplerDeterministic.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/AggregateFunctions/ReservoirSamplerDeterministic.h b/src/AggregateFunctions/ReservoirSamplerDeterministic.h
index b1a39a5dcc5..25d3b182654 100644
--- a/src/AggregateFunctions/ReservoirSamplerDeterministic.h
+++ b/src/AggregateFunctions/ReservoirSamplerDeterministic.h
@@ -190,12 +190,12 @@ public:
             /// Here we ensure that padding is zero without changing the protocol.
             /// TODO: After implementation of "versioning aggregate function state",
             /// change the serialization format.
-
             Element elem;
             memset(&elem, 0, sizeof(elem));
             elem = samples[i];
 
-            writeBinaryLittleEndian(elem, buf);
+            DB::transformEndianness<std::endian::little>(elem);
+            DB::writeString(reinterpret_cast<const char*>(&elem), sizeof(elem), buf);
         }
     }
 

From 959fde4491e33586916efcf689ba1a4b361e6865 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Tue, 13 Jun 2023 09:33:38 +0800
Subject: [PATCH 368/722] add notifications in docs

---
 docs/en/engines/table-engines/integrations/redis.md | 9 ++++++++-
 src/Storages/StorageRedis.cpp                       | 7 +++++--
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index 6cfc60c836c..68235a89d33 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -6,7 +6,7 @@ sidebar_label: Redis
 
 # Redis
 
-This engine allows integrating ClickHouse with [Redis](https://redis.io/).
+This engine allows integrating ClickHouse with [Redis](https://redis.io/). For Redis takes kv model, we strongly recommend you only query it in a point way, such as `where k=xx` or `where k in (xx, xx)`.
 
 ## Creating a Table {#creating-a-table}
 
@@ -110,3 +110,10 @@ Flush Redis db asynchronously. Also `Truncate` support SYNC mode.
 ```sql
 TRUNCATE TABLE redis_table SYNC;
 ```
+
+
+## Limitations {#limitations}
+
+Redis engine also support scanning query, such as `where k > xx`, but it has some limitations:
+1. Scanning query may produce some duplicated keys in a very rare case when it is rehashing, details see [Redis Scan](https://github.com/redis/redis/blob/e4d183afd33e0b2e6e8d1c79a832f678a04a7886/src/dict.c#L1186-L1269)
+2. During the scanning keys could be created and deleted, so the resulting dataset can not represent a valid point in time.
diff --git a/src/Storages/StorageRedis.cpp b/src/Storages/StorageRedis.cpp
index 71c84443d8e..ddb1b62c7b0 100644
--- a/src/Storages/StorageRedis.cpp
+++ b/src/Storages/StorageRedis.cpp
@@ -3,12 +3,12 @@
 #include <Interpreters/MutationsInterpreter.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Parsers/ASTCreateQuery.h>
+#include <Parsers/ASTDropQuery.h>
 #include <Parsers/ASTLiteral.h>
 #include <Processors/Executors/PullingPipelineExecutor.h>
 #include <Processors/Sinks/SinkToStorage.h>
 #include <QueryPipeline/Pipe.h>
 #include <QueryPipeline/QueryPipelineBuilder.h>
-#include <Parsers/ASTDropQuery.h>
 
 #include <Storages/KVStorageUtils.h>
 #include <Storages/KeyDescription.h>
@@ -19,6 +19,7 @@
 #include <Storages/checkAndGetLiteralArgument.h>
 
 #include <Common/Exception.h>
+#include <Common/checkStackSize.h>
 #include <Common/logger_useful.h>
 #include <Common/parseAddress.h>
 
@@ -87,9 +88,11 @@ public:
         return storage.getBySerializedKeys(raw_keys, nullptr);
     }
 
-    /// TODO scan may get duplicated keys
+    /// TODO scan may get duplicated keys when Redis is rehashing, it is a very rare case.
     Chunk generateFullScan()
     {
+        checkStackSize();
+
         /// redis scan ending
         if (iterator == 0)
             return {};

From 2395b25f9e8828ea1adbf6d303832a1ea7ee97a8 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Tue, 13 Jun 2023 01:55:34 +0000
Subject: [PATCH 369/722] Changes after review

---
 docs/en/interfaces/cli.md                      | 18 +++++++++++-------
 docs/ru/interfaces/cli.md                      | 14 +++++++++-----
 src/Client/ConnectionString.cpp                |  6 +++---
 .../02784_connection_string.reference          |  1 +
 .../0_stateless/02784_connection_string.sh     |  3 +++
 5 files changed, 27 insertions(+), 15 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index fc24bdcad68..6736d05e65f 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -202,15 +202,16 @@ Instead of --host, --port, --user and --password options, ClickHouse client also
 clickhouse-client alternatively supports connecting to clickhouse server using a connection string similar to [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). It has the following syntax:
 
 ```text
-clickhouse:[//[user_info@][hosts_and_ports]][/database][?query_parameters]
+clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters]
 ```
 
 Where
 
-- `user_spec` - (optional) is a user and an optional password,
-- `hostspec` - (optional) is a list of hosts and optional ports `host[:port] [, host:[port]], ...`,
+- `user` - (optional) is a user name,
+- `password` - (optional) is a user password. If `:` is specified and the password is blank, the client will prompt for the user's password.
+- `hosts_and_ports` - (optional) is a list of hosts and optional ports `host[:port] [, host:[port]], ...`,
 - `database` - (optional) is the database name,
-- `paramspec` - (optional) is a list of key-value pairs `param1=value1[,&param2=value2], ...`. For some parameters, no value is required. Parameter names and values are case-sensitive.
+- `query_parameters` - (optional) is a list of key-value pairs `param1=value1[,&param2=value2], ...`. For some parameters, no value is required. Parameter names and values are case-sensitive.
 
 
 
@@ -239,7 +240,7 @@ URI allows multiple hosts to be connected to. Connection strings can contain mul
 
 ### Percent encoding {#connection_string_uri_percent_encoding}
 
-Non-US ASCII characters in the user name, password, hosts, database or query parameters must be [percent-encoded](https://en.wikipedia.org/wiki/URL_encoding).
+Non-US ASCII, spaces and special characters, and special characters in the `user`, `password`, `hosts`, `database` and `query parameters` must be [percent-encoded](https://en.wikipedia.org/wiki/URL_encoding).
 
 ### Examples {#connection_string_examples}
 
@@ -306,10 +307,13 @@ Connect to default host using default port, default user, and default database.
 clickhouse-client clickhouse:
 ```
 
-Connect to the default host using the default port, using user user_name and no password.
+Connect to the default host using the default port, using user `my_user` and no password.
 
 ``` bash
-clickhouse-client clickhouse://user_name@
+clickhouse-client clickhouse://my_user@
+
+# Using a blank password between : and @ means to asking user to enter the password before starting the connection.
+clickhouse-client clickhouse://my_user:@
 ```
 
 Connect to localhost using email as the user name. `@` symbol is percent encoded to `%40`.
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index ee29b122afb..794ac60ec83 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -147,12 +147,13 @@ $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="numbe
 clickhouse-client также поддерживает подключение к серверу clickhouse с помощью строки подключения, аналогичной [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). Она имеет следующий синтаксис:
 
 ```text
-clickhouse:[//[user_info@][hosts_and_ports]][/database][?query_parameters]
+clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters]
 ```
 
 Где
 
-- `user_spec` - (необязательно) - это пользователь и необязательный пароль,
+- `user` - (необязательно) - это имя пользователя,
+- `password` - (необязательно) - Пароль пользователя. Если символ `:` укаказан, и пароль пуст, то клиент запросит ввести пользователя пароль.
 - `hostspec` - (необязательно) - список хостов и необязательных портов. `host[:port] [, host:[port]], ...`,
 - `database` - (необязательно) - это имя базы данных,
 - `paramspec` - (опционально) список пар ключ-значение `param1=value1[,&param2=value2], ...`. Для некоторых параметров значение не требуется. Имена и значения параметров чувствительны к регистру.
@@ -182,7 +183,7 @@ URI позволяет подключаться к нескольким хост
 
 ### Кодирование URI {#connection_string_uri_percent_encoding}
 
-Не US ASCII символы в имени пользователя, пароле, хостах, базе данных или параметрах запроса должны быть [закодированы](https://ru.wikipedia.org/wiki/URL#%D0%9A%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_URL).
+Не US ASCII и специальные символы в имени пользователя, пароле, хостах, базе данных и параметрах запроса должны быть [закодированы](https://ru.wikipedia.org/wiki/URL#%D0%9A%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_URL).
 
 ### Примеры {#connection_string_examples}
 
@@ -248,10 +249,13 @@ clickhouse-client clickhouse://localhost/my_database -s
 clickhouse-client clickhouse:
 ```
 
-Подключиться к хосту по умолчанию через порт по умолчанию, используя имя пользователя user_name без пароля.
+Подключиться к хосту по умолчанию через порт по умолчанию, используя имя пользователя `my_user` без пароля.
 
 ``` bash
-clickhouse-client clickhouse://user_name@
+clickhouse-client clickhouse://my_user@
+
+# Использование пустого пароля между : и @ означает, что пользователь должен ввести пароль перед началом соединения.
+clickhouse-client clickhouse://my_user:@
 ```
 
 Подключиться к localhost, используя электронную почту, как имя пользователя. Символ `@` закодирован как `%40`.
diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index e1f39369b2a..8f0a0980f51 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -142,11 +142,11 @@ bool tryParseConnectionString(
     try
     {
         /** Poco::URI doesn't support several hosts in URI.
-          * Split string clickhouse:[user_info]host1:port1, ... , hostN:portN[database]?[query_parameters]
+          * Split string clickhouse:[user[:password]@]host1:port1, ... , hostN:portN[database]?[query_parameters]
           * into multiple string for each host:
-          * clickhouse:[user_info]host1:port1[database]?[query_parameters]
+          * clickhouse:[user[:password]@]host1:port1[database]?[query_parameters]
           * ...
-          * clickhouse:[user_info]hostN:portN[database]?[query_parameters]
+          * clickhouse:[user[:password]@]hostN:portN[database]?[query_parameters]
           */
         Poco::URI uri;
         const auto * last_host_begin = connection_string.begin() + offset;
diff --git a/tests/queries/0_stateless/02784_connection_string.reference b/tests/queries/0_stateless/02784_connection_string.reference
index 6a36abae8e0..9d58d485a14 100644
--- a/tests/queries/0_stateless/02784_connection_string.reference
+++ b/tests/queries/0_stateless/02784_connection_string.reference
@@ -121,5 +121,6 @@ BAD_ARGUMENTS
 BAD_ARGUMENTS
 BAD_ARGUMENTS
 BAD_ARGUMENTS
+BAD_ARGUMENTS
 Authentication failed
 Authentication failed
diff --git a/tests/queries/0_stateless/02784_connection_string.sh b/tests/queries/0_stateless/02784_connection_string.sh
index fce93fdad74..042f5b2108d 100755
--- a/tests/queries/0_stateless/02784_connection_string.sh
+++ b/tests/queries/0_stateless/02784_connection_string.sh
@@ -116,6 +116,9 @@ runClient "clickhouse:///?" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HO
 runClient "clickhouse://:/?" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse:" --database "$CLICKHOUSE_DATABASE" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS' 
 
+# Using clickhouse-client and connection is prohibited
+runClient "clickhouse:" --connection "connection" 2>&1 | grep -o 'BAD_ARGUMENTS'
+
 # Space is used in connection string (This is prohibited).
 runClient " clickhouse:" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse: " 2>&1 | grep -o 'BAD_ARGUMENTS'

From 6839a1318c8a656c20e7a1ed8e256fd51408820e Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Tue, 13 Jun 2023 04:03:30 +0000
Subject: [PATCH 370/722] minor changes in docs

---
 docs/en/interfaces/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index 6736d05e65f..b5134ea30c0 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -240,7 +240,7 @@ URI allows multiple hosts to be connected to. Connection strings can contain mul
 
 ### Percent encoding {#connection_string_uri_percent_encoding}
 
-Non-US ASCII, spaces and special characters, and special characters in the `user`, `password`, `hosts`, `database` and `query parameters` must be [percent-encoded](https://en.wikipedia.org/wiki/URL_encoding).
+Non-US ASCII, spaces and special characters in the `user`, `password`, `hosts`, `database` and `query parameters` must be [percent-encoded](https://en.wikipedia.org/wiki/URL_encoding).
 
 ### Examples {#connection_string_examples}
 

From a3ff5df205ae8353395023ee4ef0bf83bee31458 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Tue, 13 Jun 2023 09:16:06 +0300
Subject: [PATCH 371/722] Remove reduntant header SELECT from the test

---
 .../0_stateless/02783_parseDateTimeBestEffort_syslog.reference  | 1 -
 .../0_stateless/02783_parseDateTimeBestEffort_syslog.sql        | 2 --
 2 files changed, 3 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
index 3ec93143e0e..ee75d68bff4 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
@@ -1,4 +1,3 @@
-parseDateTimeBestEffort
  around_June_7                     res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc                res_us            res_us_sam            res_us_auc           res_us_null       res_us_null_sam       res_us_null_auc           res_us_zero       res_us_zero_sam       res_us_zero_auc                     res64                 res64_sam                 res64_auc                res64_null            res64_null_sam            res64_null_auc                res64_zero            res64_zero_sam            res64_zero_auc                  res64_us              res64_us_sam              res64_us_auc             res64_us_null         res64_us_null_sam         res64_us_null_auc             res64_us_zero         res64_us_zero_sam         res64_us_zero_auc
 
  Jun  6 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000 
diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
index 52975cb5bbf..742ae03ddab 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
@@ -1,5 +1,3 @@
-SELECT 'parseDateTimeBestEffort';
-
 WITH
     86400 AS secs_in_day,
     now() AS ts_now,

From 879db5098a80d8c8c391296b672332a3367f6ac9 Mon Sep 17 00:00:00 2001
From: Val Doroshchuk <valbok@gmail.com>
Date: Mon, 12 Jun 2023 13:47:38 +0200
Subject: [PATCH 372/722] MaterializedMySQL: Add test_named_collections

---
 .../configs/users.xml                         |  1 +
 .../materialize_with_ddl.py                   | 31 +++++++++++++++++++
 .../test_materialized_mysql_database/test.py  |  6 ++++
 3 files changed, 38 insertions(+)

diff --git a/tests/integration/test_materialized_mysql_database/configs/users.xml b/tests/integration/test_materialized_mysql_database/configs/users.xml
index 3669fbb46ba..7a7529c94bb 100644
--- a/tests/integration/test_materialized_mysql_database/configs/users.xml
+++ b/tests/integration/test_materialized_mysql_database/configs/users.xml
@@ -14,6 +14,7 @@
                 <ip>::/0</ip>
             </networks>
             <profile>default</profile>
+            <named_collection_control>1</named_collection_control>
         </default>
     </users>
 </clickhouse>
diff --git a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
index 2bbbe9a3f13..7fdb73ea1f3 100644
--- a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
+++ b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
@@ -2265,3 +2265,34 @@ def dropddl(clickhouse_node, mysql_node, mysql_host):
     )
     mysql_node.query(f"DROP DATABASE {db}")
     clickhouse_node.query(f"DROP DATABASE {db}")
+
+
+def named_collections(clickhouse_node, mysql_node, service_name):
+    db = "named_collections"
+    mysql_node.query(f"DROP DATABASE IF EXISTS {db}")
+    clickhouse_node.query(f"DROP DATABASE IF EXISTS {db}")
+    mysql_node.query(f"CREATE DATABASE {db}")
+    mysql_node.query(
+        f"CREATE TABLE {db}.t1 (id INT PRIMARY KEY, name VARCHAR(64), val INT)"
+    )
+    mysql_node.query(
+        f"INSERT INTO {db}.t1 (id, name, val) VALUES (1, 'a', 1), (2, 'b', 2)"
+    )
+
+    clickhouse_node.query(
+        f"""CREATE NAMED COLLECTION {db} AS
+            user = 'root',
+            password = 'clickhouse',
+            host = '{service_name}',
+            port = 3306,
+            database = '{db}'
+            """
+    )
+    clickhouse_node.query(f"CREATE DATABASE {db} ENGINE = MaterializedMySQL({db})")
+    check_query(
+        clickhouse_node,
+        f"/* expect: (1, 'a', 1), (2, 'b', 2) */ SELECT * FROM {db}.t1",
+        "1\ta\t1\n2\tb\t2\n",
+    )
+    clickhouse_node.query(f"DROP DATABASE IF EXISTS {db}")
+    mysql_node.query(f"DROP DATABASE IF EXISTS {db}")
diff --git a/tests/integration/test_materialized_mysql_database/test.py b/tests/integration/test_materialized_mysql_database/test.py
index a22d73061ae..5272fb2ff8c 100644
--- a/tests/integration/test_materialized_mysql_database/test.py
+++ b/tests/integration/test_materialized_mysql_database/test.py
@@ -523,3 +523,9 @@ def test_materialized_database_mysql_drop_ddl(
 ):
     materialize_with_ddl.dropddl(clickhouse_node, started_mysql_8_0, "mysql80")
     materialize_with_ddl.dropddl(clickhouse_node, started_mysql_5_7, "mysql57")
+
+
+def test_named_collections(started_cluster, started_mysql_8_0, clickhouse_node):
+    materialize_with_ddl.named_collections(
+        clickhouse_node, started_mysql_8_0, "mysql80"
+    )

From 2c018f5261553dd6106639f22c148fbdd61d8fc4 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Sat, 3 Jun 2023 20:59:04 +0200
Subject: [PATCH 373/722] do not call finalize after exception

---
 src/Storages/StorageS3.cpp                    |  11 +-
 tests/integration/helpers/client.py           |   2 +
 tests/integration/helpers/cluster.py          |   2 +
 .../integration/helpers/s3_mocks/broken_s3.py | 241 +++++++++++++++---
 .../test_checking_s3_blobs_paranoid/test.py   |  98 ++++++-
 tests/integration/test_merge_tree_s3/test.py  | 222 +++++++++++++++-
 6 files changed, 530 insertions(+), 46 deletions(-)

diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index f1a7bcb71a2..dfa5ea2667a 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -794,7 +794,7 @@ public:
     void onException() override
     {
         std::lock_guard lock(cancel_mutex);
-        finalize();
+        release();
     }
 
     void onFinish() override
@@ -824,6 +824,15 @@ private:
         }
     }
 
+    void release()
+    {
+        if (!writer)
+            return;
+
+        writer.reset();
+        write_buf.reset();
+    }
+
     Block sample_block;
     std::optional<FormatSettings> format_settings;
     std::unique_ptr<WriteBuffer> write_buf;
diff --git a/tests/integration/helpers/client.py b/tests/integration/helpers/client.py
index c2676ac08a6..fdeedb9a80d 100644
--- a/tests/integration/helpers/client.py
+++ b/tests/integration/helpers/client.py
@@ -121,6 +121,7 @@ class Client:
         user=None,
         password=None,
         database=None,
+        query_id=None,
     ):
         return self.get_query_request(
             sql,
@@ -130,6 +131,7 @@ class Client:
             user=user,
             password=password,
             database=database,
+            query_id=query_id,
         ).get_error()
 
     @stacktraces_on_timeout_decorator
diff --git a/tests/integration/helpers/cluster.py b/tests/integration/helpers/cluster.py
index f57ebf40e54..c77e67062a1 100644
--- a/tests/integration/helpers/cluster.py
+++ b/tests/integration/helpers/cluster.py
@@ -3376,6 +3376,7 @@ class ClickHouseInstance:
         user=None,
         password=None,
         database=None,
+        query_id=None,
     ):
         logging.debug(f"Executing query {sql} on {self.name}")
         return self.client.query_and_get_error(
@@ -3386,6 +3387,7 @@ class ClickHouseInstance:
             user=user,
             password=password,
             database=database,
+            query_id=query_id,
         )
 
     def query_and_get_error_with_retry(
diff --git a/tests/integration/helpers/s3_mocks/broken_s3.py b/tests/integration/helpers/s3_mocks/broken_s3.py
index 026a3c6f515..8ff4f9e9203 100644
--- a/tests/integration/helpers/s3_mocks/broken_s3.py
+++ b/tests/integration/helpers/s3_mocks/broken_s3.py
@@ -6,10 +6,10 @@ import time
 import urllib.parse
 import http.server
 import socketserver
+import string
 
 
-UPSTREAM_HOST = "minio1"
-UPSTREAM_PORT = 9001
+INF_COUNT = 100000000
 
 
 class MockControl:
@@ -28,31 +28,88 @@ class MockControl:
             ],
             nothrow=True,
         )
-        assert response == "OK"
+        assert response == "OK", response
+
+    def setup_error_at_object_upload(self, count=None, after=None):
+        url = f"http://localhost:{self._port}/mock_settings/error_at_object_upload?nothing=1"
+
+        if count is not None:
+            url += f"&count={count}"
+
+        if after is not None:
+            url += f"&after={after}"
 
-    def setup_fail_upload(self, part_length):
         response = self._cluster.exec_in_container(
             self._cluster.get_container_id(self._container),
             [
                 "curl",
                 "-s",
-                f"http://localhost:{self._port}/mock_settings/error_at_put?when_length_bigger={part_length}",
+                url,
             ],
             nothrow=True,
         )
-        assert response == "OK"
+        assert response == "OK", response
+
+    def setup_error_at_part_upload(self, count=None, after=None):
+        url = f"http://localhost:{self._port}/mock_settings/error_at_part_upload?nothing=1"
+
+        if count is not None:
+            url += f"&count={count}"
+
+        if after is not None:
+            url += f"&after={after}"
 
-    def setup_fake_upload(self, part_length):
         response = self._cluster.exec_in_container(
             self._cluster.get_container_id(self._container),
             [
                 "curl",
                 "-s",
-                f"http://localhost:{self._port}/mock_settings/fake_put?when_length_bigger={part_length}",
+                url,
             ],
             nothrow=True,
         )
-        assert response == "OK"
+        assert response == "OK", response
+
+    def setup_error_at_create_multi_part_upload(self, count=None):
+        url = f"http://localhost:{self._port}/mock_settings/error_at_create_multi_part_upload"
+
+        if count is not None:
+            url += f"?count={count}"
+
+        response = self._cluster.exec_in_container(
+            self._cluster.get_container_id(self._container),
+            [
+                "curl",
+                "-s",
+                url,
+            ],
+            nothrow=True,
+        )
+        assert response == "OK", response
+
+    def setup_fake_puts(self, part_length):
+        response = self._cluster.exec_in_container(
+            self._cluster.get_container_id(self._container),
+            [
+                "curl",
+                "-s",
+                f"http://localhost:{self._port}/mock_settings/fake_puts?when_length_bigger={part_length}",
+            ],
+            nothrow=True,
+        )
+        assert response == "OK", response
+
+    def setup_fake_multpartuploads(self):
+        response = self._cluster.exec_in_container(
+            self._cluster.get_container_id(self._container),
+            [
+                "curl",
+                "-s",
+                f"http://localhost:{self._port}/mock_settings/setup_fake_multpartuploads?",
+            ],
+            nothrow=True,
+        )
+        assert response == "OK", response
 
     def setup_slow_answers(
         self, minimal_length=0, timeout=None, probability=None, count=None
@@ -77,7 +134,7 @@ class MockControl:
             ["curl", "-s", url],
             nothrow=True,
         )
-        assert response == "OK"
+        assert response == "OK", response
 
 
 class _ServerRuntime:
@@ -88,7 +145,7 @@ class _ServerRuntime:
             self.probability = probability_ if probability_ is not None else 1
             self.timeout = timeout_ if timeout_ is not None else 0.1
             self.minimal_length = minimal_length_ if minimal_length_ is not None else 0
-            self.count = count_ if count_ is not None else 2**32
+            self.count = count_ if count_ is not None else INF_COUNT
 
         def __str__(self):
             return (
@@ -109,12 +166,32 @@ class _ServerRuntime:
                         return _runtime.slow_put.timeout
             return None
 
+    class CountAfter:
+        def __init__(self, count_=None, after_=None):
+            self.count = count_ if count_ is not None else INF_COUNT
+            self.after = after_ if after_ is not None else 0
+
+        def __str__(self):
+            return f"count:{self.count} after:{self.after}"
+
+        def has_effect(self):
+            if self.after:
+                self.after -= 1
+            if self.after == 0:
+                if self.count:
+                    self.count -= 1
+                    return True
+            return False
+
     def __init__(self):
         self.lock = threading.Lock()
-        self.error_at_put_when_length_bigger = None
+        self.error_at_part_upload = None
+        self.error_at_object_upload = None
         self.fake_put_when_length_bigger = None
         self.fake_uploads = dict()
         self.slow_put = None
+        self.fake_multipart_upload = None
+        self.error_at_create_multi_part_upload = None
 
     def register_fake_upload(self, upload_id, key):
         with self.lock:
@@ -127,10 +204,14 @@ class _ServerRuntime:
         return False
 
     def reset(self):
-        self.error_at_put_when_length_bigger = None
-        self.fake_put_when_length_bigger = None
-        self.fake_uploads = dict()
-        self.slow_put = None
+        with self.lock:
+            self.error_at_part_upload = None
+            self.error_at_object_upload = None
+            self.fake_put_when_length_bigger = None
+            self.fake_uploads = dict()
+            self.slow_put = None
+            self.fake_multipart_upload = None
+            self.error_at_create_multi_part_upload = None
 
 
 _runtime = _ServerRuntime()
@@ -141,6 +222,13 @@ def _and_then(value, func):
     return None if value is None else func(value)
 
 
+def get_random_string(length):
+    # choose from all lowercase letter
+    letters = string.ascii_lowercase
+    result_str = "".join(random.choice(letters) for i in range(length))
+    return result_str
+
+
 class RequestHandler(http.server.BaseHTTPRequestHandler):
     def _ok(self):
         self.send_response(200)
@@ -166,19 +254,30 @@ class RequestHandler(http.server.BaseHTTPRequestHandler):
         self._read_out()
 
         self.send_response(307)
-        url = f"http://{UPSTREAM_HOST}:{UPSTREAM_PORT}{self.path}"
+        url = (
+            f"http://{self.server.upstream_host}:{self.server.upstream_port}{self.path}"
+        )
         self.send_header("Location", url)
         self.end_headers()
         self.wfile.write(b"Redirected")
 
     def _error(self, data):
         self._read_out()
-
         self.send_response(500)
         self.send_header("Content-Type", "text/xml")
         self.end_headers()
         self.wfile.write(bytes(data, "UTF-8"))
 
+    def _error_expected_500(self):
+        self._error(
+            '<?xml version="1.0" encoding="UTF-8"?>'
+            "<Error>"
+            "<Code>ExpectedError</Code>"
+            "<Message>mock s3 injected error</Message>"
+            "<RequestId>txfbd566d03042474888193-00608d7537</RequestId>"
+            "</Error>"
+        )
+
     def _fake_put_ok(self):
         self._read_out()
 
@@ -188,6 +287,28 @@ class RequestHandler(http.server.BaseHTTPRequestHandler):
         self.send_header("Content-Length", 0)
         self.end_headers()
 
+    def _fake_uploads(self, path, upload_id):
+        self._read_out()
+
+        parts = [x for x in path.split("/") if x]
+        bucket = parts[0]
+        key = "/".join(parts[1:])
+        data = (
+            '<?xml version="1.0" encoding="UTF-8"?>\n'
+            "<InitiateMultipartUploadResult>\n"
+            f"<Bucket>{bucket}</Bucket>"
+            f"<Key>{key}</Key>"
+            f"<UploadId>{upload_id}</UploadId>"
+            "</InitiateMultipartUploadResult>"
+        )
+
+        self.send_response(200)
+        self.send_header("Content-Type", "text/xml")
+        self.send_header("Content-Length", len(data))
+        self.end_headers()
+
+        self.wfile.write(bytes(data, "UTF-8"))
+
     def _fake_post_ok(self, path):
         self._read_out()
 
@@ -219,18 +340,29 @@ class RequestHandler(http.server.BaseHTTPRequestHandler):
         if len(path) < 2:
             return self._error("_mock_settings: wrong command")
 
-        if path[1] == "error_at_put":
+        if path[1] == "error_at_part_upload":
             params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
-            _runtime.error_at_put_when_length_bigger = int(
-                params.get("when_length_bigger", [1024 * 1024])[0]
+            _runtime.error_at_part_upload = _ServerRuntime.CountAfter(
+                count_=_and_then(params.get("count", [None])[0], int),
+                after_=_and_then(params.get("after", [None])[0], int),
             )
             return self._ok()
-        if path[1] == "fake_put":
+
+        if path[1] == "error_at_object_upload":
+            params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
+            _runtime.error_at_object_upload = _ServerRuntime.CountAfter(
+                count_=_and_then(params.get("count", [None])[0], int),
+                after_=_and_then(params.get("after", [None])[0], int),
+            )
+            return self._ok()
+
+        if path[1] == "fake_puts":
             params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
             _runtime.fake_put_when_length_bigger = int(
                 params.get("when_length_bigger", [1024 * 1024])[0]
             )
             return self._ok()
+
         if path[1] == "slow_put":
             params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
             _runtime.slow_put = _ServerRuntime.SlowPut(
@@ -241,6 +373,18 @@ class RequestHandler(http.server.BaseHTTPRequestHandler):
             )
             self.log_message("set slow put %s", _runtime.slow_put)
             return self._ok()
+
+        if path[1] == "setup_fake_multpartuploads":
+            _runtime.fake_multipart_upload = True
+            return self._ok()
+
+        if path[1] == "error_at_create_multi_part_upload":
+            params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
+            _runtime.error_at_create_multi_part_upload = int(
+                params.get("count", [INF_COUNT])[0]
+            )
+            return self._ok()
+
         if path[1] == "reset":
             _runtime.reset()
             return self._ok()
@@ -265,33 +409,42 @@ class RequestHandler(http.server.BaseHTTPRequestHandler):
                 self.log_message("slow put %s", timeout)
                 time.sleep(timeout)
 
-        if _runtime.error_at_put_when_length_bigger is not None:
-            if content_length > _runtime.error_at_put_when_length_bigger:
-                return self._error(
-                    '<?xml version="1.0" encoding="UTF-8"?>'
-                    "<Error>"
-                    "<Code>ExpectedError</Code>"
-                    "<Message>mock s3 injected error</Message>"
-                    "<RequestId>txfbd566d03042474888193-00608d7537</RequestId>"
-                    "</Error>"
-                )
-
         parts = urllib.parse.urlsplit(self.path)
         params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
         upload_id = params.get("uploadId", [None])[0]
-        if _runtime.fake_put_when_length_bigger is not None:
-            if content_length > _runtime.fake_put_when_length_bigger:
-                if upload_id is not None:
-                    _runtime.register_fake_upload(upload_id, parts.path)
-                return self._fake_put_ok()
+
+        if upload_id is not None:
+            if _runtime.error_at_part_upload is not None:
+                if _runtime.error_at_part_upload.has_effect():
+                    return self._error_expected_500()
+            if _runtime.fake_multipart_upload:
+                if _runtime.is_fake_upload(upload_id, parts.path):
+                    return self._fake_put_ok()
+        else:
+            if _runtime.error_at_object_upload is not None:
+                if _runtime.error_at_object_upload.has_effect():
+                    return self._error_expected_500()
+            if _runtime.fake_put_when_length_bigger is not None:
+                if content_length > _runtime.fake_put_when_length_bigger:
+                    return self._fake_put_ok()
 
         return self._redirect()
 
     def do_POST(self):
         parts = urllib.parse.urlsplit(self.path)
-        params = urllib.parse.parse_qs(parts.query, keep_blank_values=False)
-        upload_id = params.get("uploadId", [None])[0]
+        params = urllib.parse.parse_qs(parts.query, keep_blank_values=True)
+        uploads = params.get("uploads", [None])[0]
+        if uploads is not None:
+            if _runtime.error_at_create_multi_part_upload:
+                _runtime.error_at_create_multi_part_upload -= 1
+                return self._error_expected_500()
 
+            if _runtime.fake_multipart_upload:
+                upload_id = get_random_string(5)
+                _runtime.register_fake_upload(upload_id, parts.path)
+                return self._fake_uploads(parts.path, upload_id)
+
+        upload_id = params.get("uploadId", [None])[0]
         if _runtime.is_fake_upload(upload_id, parts.path):
             return self._fake_post_ok(parts.path)
 
@@ -307,7 +460,15 @@ class RequestHandler(http.server.BaseHTTPRequestHandler):
 class _ThreadedHTTPServer(socketserver.ThreadingMixIn, http.server.HTTPServer):
     """Handle requests in a separate thread."""
 
+    def set_upstream(self, upstream_host, upstream_port):
+        self.upstream_host = upstream_host
+        self.upstream_port = upstream_port
+
 
 if __name__ == "__main__":
     httpd = _ThreadedHTTPServer(("0.0.0.0", int(sys.argv[1])), RequestHandler)
+    if len(sys.argv) == 4:
+        httpd.set_upstream(sys.argv[2], sys.argv[3])
+    else:
+        httpd.set_upstream("minio1", 9001)
     httpd.serve_forever()
diff --git a/tests/integration/test_checking_s3_blobs_paranoid/test.py b/tests/integration/test_checking_s3_blobs_paranoid/test.py
index 042d57a0c43..c0f184815c9 100644
--- a/tests/integration/test_checking_s3_blobs_paranoid/test.py
+++ b/tests/integration/test_checking_s3_blobs_paranoid/test.py
@@ -54,7 +54,7 @@ def test_upload_after_check_works(cluster, broken_s3):
         """
     )
 
-    broken_s3.setup_fake_upload(1)
+    broken_s3.setup_fake_puts(1)
 
     error = node.query_and_get_error(
         "INSERT INTO s3_upload_after_check_works VALUES (1, 'Hello')"
@@ -63,3 +63,99 @@ def test_upload_after_check_works(cluster, broken_s3):
     assert "Code: 499" in error, error
     assert "Immediately after upload" in error, error
     assert "suddenly disappeared" in error, error
+
+
+def get_counters(node, query_id, log_type="ExceptionWhileProcessing"):
+    node.query("SYSTEM FLUSH LOGS")
+    return [
+        int(x)
+        for x in node.query(
+            f"""
+                SELECT
+                    ProfileEvents['S3CreateMultipartUpload'],
+                    ProfileEvents['S3UploadPart'],
+                    ProfileEvents['S3WriteRequestsErrors']
+                FROM system.query_log
+                WHERE query_id='{query_id}'
+                    AND type='{log_type}'
+                """
+        ).split()
+        if x
+    ]
+
+
+def test_upload_s3_fail_create_multi_part_upload(cluster, broken_s3):
+    node = cluster.instances["node"]
+
+    broken_s3.setup_error_at_create_multi_part_upload()
+
+    insert_query_id = "INSERT_INTO_TABLE_FUNCTION_FAIL_CREATE_MPU"
+    error = node.query_and_get_error(
+        """
+        INSERT INTO
+            TABLE FUNCTION s3(
+                'http://resolver:8083/root/data/test_upload_s3_fail_create_multi_part_upload',
+                'minio', 'minio123',
+                'CSV', auto, 'none'
+            )
+        SELECT
+            *
+        FROM system.numbers
+        LIMIT 100000000
+        SETTINGS
+            s3_max_single_part_upload_size=100,
+            s3_min_upload_part_size=100
+        """,
+        query_id=insert_query_id,
+    )
+
+    assert "Code: 499" in error, error
+    assert "mock s3 injected error" in error, error
+    assert "DB::WriteBufferFromS3::createMultipartUpload()" in error, error
+
+    count_create_multi_part_uploads, count_upload_parts, count_s3_errors = get_counters(
+        node, insert_query_id
+    )
+    assert count_create_multi_part_uploads == 1
+    assert count_upload_parts == 0
+    assert count_s3_errors == 1
+
+
+def test_upload_s3_fail_upload_part_when_multi_part_upload(cluster, broken_s3):
+    node = cluster.instances["node"]
+
+    broken_s3.setup_fake_multpartuploads()
+    broken_s3.setup_error_at_part_upload(count=1, after=2)
+
+    insert_query_id = "INSERT_INTO_TABLE_FUNCTION_FAIL_UPLOAD_PART"
+    error = node.query_and_get_error(
+        """
+        INSERT INTO
+            TABLE FUNCTION s3(
+                'http://resolver:8083/root/data/test_upload_s3_fail_upload_part_when_multi_part_upload',
+                'minio', 'minio123',
+                'CSV', auto, 'none'
+            )
+        SELECT
+            *
+        FROM system.numbers
+        LIMIT 100000000
+        SETTINGS
+            s3_max_single_part_upload_size=100,
+            s3_min_upload_part_size=100
+        """,
+        query_id=insert_query_id,
+    )
+
+    assert "Code: 499" in error, error
+    assert "mock s3 injected error" in error, error
+    assert "DB::WriteBufferFromS3::writePart" in error, error
+
+    count_create_multi_part_uploads, count_upload_parts, count_s3_errors = get_counters(
+        node, insert_query_id
+    )
+    assert count_create_multi_part_uploads == 1
+    assert count_upload_parts >= 2
+    assert (
+        count_s3_errors == 2
+    )  # the second is cancel multipart upload, s3_mock just redirects this request
diff --git a/tests/integration/test_merge_tree_s3/test.py b/tests/integration/test_merge_tree_s3/test.py
index 2ccd517923a..f3f44f1452c 100644
--- a/tests/integration/test_merge_tree_s3/test.py
+++ b/tests/integration/test_merge_tree_s3/test.py
@@ -862,7 +862,9 @@ def test_merge_canceled_by_s3_errors(cluster, broken_s3, node_name, storage_poli
     min_key = node.query("SELECT min(key) FROM test_merge_canceled_by_s3_errors")
     assert int(min_key) == 0, min_key
 
-    broken_s3.setup_fail_upload(50000)
+    broken_s3.setup_error_at_object_upload()
+    broken_s3.setup_fake_multpartuploads()
+    broken_s3.setup_error_at_part_upload()
 
     node.query("SYSTEM START MERGES test_merge_canceled_by_s3_errors")
 
@@ -905,7 +907,7 @@ def test_merge_canceled_by_s3_errors_when_move(cluster, broken_s3, node_name):
         settings={"materialize_ttl_after_modify": 0},
     )
 
-    broken_s3.setup_fail_upload(10000)
+    broken_s3.setup_error_at_object_upload(count=1, after=1)
 
     node.query("SYSTEM START MERGES merge_canceled_by_s3_errors_when_move")
 
@@ -941,7 +943,7 @@ def test_s3_engine_heavy_write_check_mem(
         " ENGINE S3('http://resolver:8083/root/data/test-upload.csv', 'minio', 'minio123', 'CSV')",
     )
 
-    broken_s3.setup_fake_upload(1000)
+    broken_s3.setup_fake_multpartuploads()
     broken_s3.setup_slow_answers(10 * 1024 * 1024, timeout=15, count=10)
 
     query_id = f"INSERT_INTO_S3_ENGINE_QUERY_ID_{in_flight}"
@@ -987,7 +989,7 @@ def test_s3_disk_heavy_write_check_mem(cluster, broken_s3, node_name):
     )
     node.query("SYSTEM STOP MERGES s3_test")
 
-    broken_s3.setup_fake_upload(1000)
+    broken_s3.setup_fake_multpartuploads()
     broken_s3.setup_slow_answers(10 * 1024 * 1024, timeout=10, count=50)
 
     query_id = f"INSERT_INTO_S3_DISK_QUERY_ID"
@@ -1013,3 +1015,215 @@ def test_s3_disk_heavy_write_check_mem(cluster, broken_s3, node_name):
     assert int(result) > 0.8 * memory
 
     check_no_objects_after_drop(cluster, node_name=node_name)
+
+
+def get_memory_usage(node, query_id):
+    node.query("SYSTEM FLUSH LOGS")
+    memory_usage = node.query(
+        "SELECT memory_usage"
+        " FROM system.query_log"
+        f" WHERE query_id='{query_id}'"
+        "   AND type='QueryFinish'"
+    )
+    return int(memory_usage)
+
+
+def get_memory_usages(node, query_ids):
+    node.query("SYSTEM FLUSH LOGS")
+    result = []
+    for query_id in query_ids:
+        memory_usage = node.query(
+            "SELECT memory_usage"
+            " FROM system.query_log"
+            f" WHERE query_id='{query_id}'"
+            "   AND type='QueryFinish'"
+        )
+        result.append(int(memory_usage))
+    return result
+
+
+@pytest.mark.parametrize("node_name", ["node"])
+def test_heavy_insert_select_check_memory(cluster, broken_s3, node_name):
+    node = cluster.instances[node_name]
+
+    node.query(
+        """
+        CREATE TABLE central_query_log
+        (
+            control_plane_id UUID,
+            pod_id LowCardinality(String),
+            scrape_ts_microseconds DateTime64(6) CODEC(Delta(8), LZ4),
+            event_date Date,
+            event_time DateTime,
+            payload Array(String),
+            payload_01 String,
+            payload_02 String,
+            payload_03 String,
+            payload_04 String,
+            payload_05 String,
+            payload_06 String,
+            payload_07 String,
+            payload_08 String,
+            payload_09 String,
+            payload_10 String,
+            payload_11 String,
+            payload_12 String,
+            payload_13 String,
+            payload_14 String,
+            payload_15 String,
+            payload_16 String,
+            payload_17 String,
+            payload_18 String,
+            payload_19 String
+        )
+        ENGINE=MergeTree()
+        PARTITION BY toYYYYMM(event_date)
+        ORDER BY (control_plane_id, event_date, pod_id)
+        SETTINGS
+            storage_policy='s3'
+        """
+    )
+
+    node.query("SYSTEM STOP MERGES central_query_log")
+
+    write_count = 2
+    write_query_ids = []
+    for x in range(write_count):
+        query_id = f"INSERT_INTO_TABLE_RANDOM_DATA_QUERY_ID_{x}"
+        write_query_ids.append(query_id)
+        node.query(
+            """
+            INSERT INTO central_query_log
+            SELECT
+                control_plane_id,
+                pod_id,
+                toStartOfHour(event_time) + toIntervalSecond(randUniform(0,60)) as scrape_ts_microseconds,
+                toDate(event_time) as event_date,
+                event_time,
+                payload,
+                payload[1] as payload_01,
+                payload[2] as payload_02,
+                payload[3] as payload_03,
+                payload[4] as payload_04,
+                payload[5] as payload_05,
+                payload[6] as payload_06,
+                payload[7] as payload_07,
+                payload[8] as payload_08,
+                payload[9] as payload_09,
+                payload[10] as payload_10,
+                payload[11] as payload_11,
+                payload[12] as payload_12,
+                payload[13] as payload_13,
+                payload[14] as payload_14,
+                payload[15] as payload_15,
+                payload[16] as payload_16,
+                payload[17] as payload_17,
+                payload[18] as payload_18,
+                payload[19] as payload_19
+            FROM
+            (
+                SELECT
+                    control_plane_id,
+                    substring(payload[1], 1, 5) as pod_id,
+                    toDateTime('2022-12-12 00:00:00')
+                        + toIntervalDay(floor(randUniform(0,3)))
+                        + toIntervalHour(floor(randUniform(0,24)))
+                        + toIntervalSecond(floor(randUniform(0,60)))
+                        as event_time,
+                    payload
+                FROM
+                    generateRandom(
+                        'control_plane_id UUID, payload Array(String)',
+                        NULL,
+                        100,
+                        100
+                    )
+                LIMIT 10000
+            )
+            SETTINGS
+                max_insert_block_size=256000000,
+                min_insert_block_size_rows=1000000,
+                min_insert_block_size_bytes=256000000
+            """,
+            query_id=query_id,
+        )
+
+    memory = 845346116
+    for memory_usage, query_id in zip(
+        get_memory_usages(node, write_query_ids), write_query_ids
+    ):
+        assert int(memory_usage) < 1.2 * memory, f"{memory_usage} : {query_id}"
+        assert int(memory_usage) > 0.8 * memory, f"{memory_usage} : {query_id}"
+
+    broken_s3.setup_slow_answers(minimal_length=1000, timeout=5, count=20)
+    broken_s3.setup_fake_multpartuploads()
+
+    insert_query_id = f"INSERT_INTO_S3_FUNCTION_QUERY_ID"
+    node.query(
+        """
+        INSERT INTO
+            TABLE FUNCTION s3(
+                'http://resolver:8083/root/data/test-upload_{_partition_id}.csv.gz',
+                'minio', 'minio123',
+                'CSV', auto, 'gzip'
+            )
+        PARTITION BY formatDateTime(subtractHours(toDateTime('2022-12-13 00:00:00'), 1),'%Y-%m-%d_%H:00')
+        WITH toDateTime('2022-12-13 00:00:00') as time_point
+        SELECT
+            *
+        FROM central_query_log
+        WHERE
+            event_date >= subtractDays(toDate(time_point), 1)
+            AND scrape_ts_microseconds >= subtractHours(toStartOfHour(time_point), 12)
+            AND scrape_ts_microseconds < toStartOfDay(time_point)
+        SETTINGS
+            s3_max_inflight_parts_for_one_file=1
+        """,
+        query_id=insert_query_id,
+    )
+
+    query_id = f"SELECT_QUERY_ID"
+    total = node.query(
+        """
+        SELECT
+            count()
+        FROM central_query_log
+        """,
+        query_id=query_id,
+    )
+    assert int(total) == 10000 * write_count
+
+    query_id = f"SELECT_WHERE_QUERY_ID"
+    selected = node.query(
+        """
+        WITH toDateTime('2022-12-13 00:00:00') as time_point
+        SELECT
+            count()
+        FROM central_query_log
+        WHERE
+            event_date >= subtractDays(toDate(time_point), 1)
+            AND scrape_ts_microseconds >= subtractHours(toStartOfHour(time_point), 12)
+            AND scrape_ts_microseconds < toStartOfDay(time_point)
+        """,
+        query_id=query_id,
+    )
+    assert int(selected) < 4500, selected
+    assert int(selected) > 2500, selected
+
+    node.query("SYSTEM FLUSH LOGS")
+    profile_events = node.query(
+        f"""
+        SELECT ProfileEvents
+            FROM system.query_log
+            WHERE query_id='{insert_query_id}'
+            AND type='QueryFinish'
+        """
+    )
+
+    memory_usage = get_memory_usage(node, insert_query_id)
+    memory = 123507857
+    assert int(memory_usage) < 1.2 * memory, f"{memory_usage} {profile_events}"
+    assert int(memory_usage) > 0.8 * memory, f"{memory_usage} {profile_events}"
+
+    node.query(f"DROP TABLE IF EXISTS central_query_log SYNC")
+    remove_all_s3_objects(cluster)

From 9c939b2f3db3b47116d739a3b81ab7c353e6e0bf Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 13 Jun 2023 10:54:54 +0200
Subject: [PATCH 374/722] Fix heading and sidebar for azureBlobStorage table
 function

---
 docs/en/sql-reference/table-functions/azureBlobStorage.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
index 369bf7a964d..7a362710b9c 100644
--- a/docs/en/sql-reference/table-functions/azureBlobStorage.md
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -1,10 +1,10 @@
 ---
 slug: /en/sql-reference/table-functions/azure_blob_storage
-sidebar_label: azure_blob_storage
+sidebar_label: azureBlobStorage
 keywords: [azure blob storage]
 ---
 
-# azure\_blob\_storage Table Function
+# azureBlobStorage Table Function
 
 Provides a table-like interface to select/insert files in [Azure Blob Storage](https://azure.microsoft.com/en-us/products/storage/blobs). This table function is similar to the [s3 function](../../sql-reference/table-functions/s3.md).
 

From 79bc8847333f6e8e3653e63b1fed6a063bfb6302 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 13 Jun 2023 08:54:25 +0000
Subject: [PATCH 375/722] Stabilize tests

---
 src/Functions/FunctionSnowflake.h             | 58 ++++++++++---------
 .../01942_snowflakeToDateTime.reference       |  3 +-
 .../0_stateless/01942_snowflakeToDateTime.sql | 10 +++-
 3 files changed, 41 insertions(+), 30 deletions(-)

diff --git a/src/Functions/FunctionSnowflake.h b/src/Functions/FunctionSnowflake.h
index 0a47534c47d..ace2fc54f09 100644
--- a/src/Functions/FunctionSnowflake.h
+++ b/src/Functions/FunctionSnowflake.h
@@ -54,22 +54,19 @@ public:
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override
     {
         const auto & src = arguments[0];
-        const auto & col = *src.column;
+        const auto & src_column = *src.column;
 
         auto res_column = ColumnInt64::create(input_rows_count);
-        auto & result_data = res_column->getData();
+        auto & res_data = res_column->getData();
 
-        const auto & source_data = typeid_cast<const ColumnUInt32 &>(col).getData();
+        const auto & src_data = typeid_cast<const ColumnDecimal<DateTime64> &>(src_column).getData();
         for (size_t i = 0; i < input_rows_count; ++i)
-        {
-            result_data[i] = (Int64(source_data[i]) * 1000 - snowflake_epoch) << time_shift;
-        }
+            res_data[i] = (UInt32(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
 
         return res_column;
     }
 };
 
-
 class FunctionSnowflakeToDateTime : public IFunction
 {
 private:
@@ -106,23 +103,23 @@ public:
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override
     {
         const auto & src = arguments[0];
-        const auto & col = *src.column;
+        const auto & src_column = *src.column;
 
         auto res_column = ColumnUInt32::create(input_rows_count);
-        auto & result_data = res_column->getData();
+        auto & res_data = res_column->getData();
 
-        if (const auto * src_non_const = typeid_cast<const ColumnInt64 *>(&col))
+        if (const auto * src_column_non_const = typeid_cast<const ColumnInt64 *>(&src_column))
         {
-            const auto & source_data = src_non_const->getData();
+            const auto & src_data = src_column_non_const->getData();
             for (size_t i = 0; i < input_rows_count; ++i)
-                result_data[i] = static_cast<UInt32>(
-                    ((source_data[i] >> time_shift) + snowflake_epoch) / 1000);
+                res_data[i] = static_cast<UInt32>(
+                    ((src_data[i] >> time_shift) + snowflake_epoch) / 1000);
         }
-        else if (const auto * src_const = typeid_cast<const ColumnConst *>(&col))
+        else if (const auto * src_column_const = typeid_cast<const ColumnConst *>(&src_column))
         {
-            Int64 src_val = src_const->getValue<Int64>();
+            Int64 src_val = src_column_const->getValue<Int64>();
             for (size_t i = 0; i < input_rows_count; ++i)
-                result_data[i] = static_cast<UInt32>(
+                res_data[i] = static_cast<UInt32>(
                     ((src_val >> time_shift) + snowflake_epoch) / 1000);
         }
         return res_column;
@@ -155,16 +152,14 @@ public:
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override
     {
         const auto & src = arguments[0];
-        const auto & col = *src.column;
+        const auto & src_column = *src.column;
 
         auto res_column = ColumnInt64::create(input_rows_count);
-        auto & result_data = res_column->getData();
+        auto & res_data = res_column->getData();
 
-        const auto & source_data = typeid_cast<const ColumnDecimal<DateTime64> &>(col).getData();
+        const auto & src_data = typeid_cast<const ColumnDecimal<DateTime64> &>(src_column).getData();
         for (size_t i = 0; i < input_rows_count; ++i)
-        {
-            result_data[i] = (source_data[i] - snowflake_epoch) << time_shift;
-        }
+            res_data[i] = (src_data[i] - snowflake_epoch) << time_shift;
 
         return res_column;
     }
@@ -207,17 +202,24 @@ public:
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t input_rows_count) const override
     {
         const auto & src = arguments[0];
-        const auto & col = *src.column;
+        const auto & src_column = *src.column;
 
         auto res_column = ColumnDecimal<DateTime64>::create(input_rows_count, 3);
-        auto & result_data = res_column->getData();
+        auto & res_data = res_column->getData();
 
-        const auto & source_data = typeid_cast<const ColumnInt64 &>(col).getData();
-
-        for (size_t i = 0; i < input_rows_count; ++i)
+        if (const auto * src_column_non_const = typeid_cast<const ColumnInt64 *>(&src_column))
         {
-            result_data[i] = (source_data[i] >> time_shift) + snowflake_epoch;
+            const auto & src_data = src_column_non_const->getData();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                res_data[i] = (src_data[i] >> time_shift) + snowflake_epoch;
         }
+        else if (const auto * src_column_const = typeid_cast<const ColumnConst *>(&src_column))
+        {
+            Int64 src_val = src_column_const->getValue<Int64>();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                res_data[i] = (src_val >> time_shift) + snowflake_epoch;
+        }
+
         return res_column;
     }
 };
diff --git a/tests/queries/0_stateless/01942_snowflakeToDateTime.reference b/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
index fa00a22bc63..e1d141fe450 100644
--- a/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
+++ b/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
@@ -1,4 +1,5 @@
 const column
 UTC	1426860704886947840	2021-08-15 10:57:56	DateTime(\'UTC\')	2021-08-15 10:57:56.492	DateTime64(3, \'UTC\')
 Asia/Shanghai	1426860704886947840	2021-08-15 18:57:56	DateTime(\'Asia/Shanghai\')	2021-08-15 18:57:56.492	DateTime64(3, \'Asia/Shanghai\')
-Asia/Singapore	2010-11-04 01:42:54
+Asia/Singapore	42
+Asia/Singapore	42
diff --git a/tests/queries/0_stateless/01942_snowflakeToDateTime.sql b/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
index 3efccdddb2d..2ad03f2a4f5 100644
--- a/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
+++ b/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
@@ -31,4 +31,12 @@ SELECT
 	snowflakeToDateTime64(i64, tz) as dt64,
 	toTypeName(dt64);
 
-SELECT materialize('Asia/Singapore') a, snowflakeToDateTime(649::Int64, a) settings allow_nonconst_timezone_arguments = 1
+
+DROP TABLE IF EXISTS tab;
+CREATE TABLE tab(tz String, val Int64) engine=Log;
+INSERT INTO tab VALUES ('Asia/Singapore', 42);
+
+SELECT * FROM tab WHERE snowflakeToDateTime(42::Int64, tz) != now() SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT * FROM tab WHERE snowflakeToDateTime64(42::Int64, tz) != now() SETTINGS allow_nonconst_timezone_arguments = 1;
+
+DROP TABLE tab;

From 2d0dc2c8f5c329a4da12ccb1db601d5edf2044cd Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 13 Jun 2023 08:59:34 +0000
Subject: [PATCH 376/722] Minor: Switch column order

---
 .../0_stateless/01942_snowflakeToDateTime.reference       | 4 ++--
 tests/queries/0_stateless/01942_snowflakeToDateTime.sql   | 8 ++++----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/tests/queries/0_stateless/01942_snowflakeToDateTime.reference b/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
index e1d141fe450..83fae3ef809 100644
--- a/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
+++ b/tests/queries/0_stateless/01942_snowflakeToDateTime.reference
@@ -1,5 +1,5 @@
 const column
 UTC	1426860704886947840	2021-08-15 10:57:56	DateTime(\'UTC\')	2021-08-15 10:57:56.492	DateTime64(3, \'UTC\')
 Asia/Shanghai	1426860704886947840	2021-08-15 18:57:56	DateTime(\'Asia/Shanghai\')	2021-08-15 18:57:56.492	DateTime64(3, \'Asia/Shanghai\')
-Asia/Singapore	42
-Asia/Singapore	42
+1
+1
diff --git a/tests/queries/0_stateless/01942_snowflakeToDateTime.sql b/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
index 2ad03f2a4f5..0092eca848c 100644
--- a/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
+++ b/tests/queries/0_stateless/01942_snowflakeToDateTime.sql
@@ -33,10 +33,10 @@ SELECT
 
 
 DROP TABLE IF EXISTS tab;
-CREATE TABLE tab(tz String, val Int64) engine=Log;
-INSERT INTO tab VALUES ('Asia/Singapore', 42);
+CREATE TABLE tab(val Int64, tz String) engine=Log;
+INSERT INTO tab VALUES (42, 'Asia/Singapore');
 
-SELECT * FROM tab WHERE snowflakeToDateTime(42::Int64, tz) != now() SETTINGS allow_nonconst_timezone_arguments = 1;
-SELECT * FROM tab WHERE snowflakeToDateTime64(42::Int64, tz) != now() SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT 1 FROM tab WHERE snowflakeToDateTime(42::Int64, tz) != now() SETTINGS allow_nonconst_timezone_arguments = 1;
+SELECT 1 FROM tab WHERE snowflakeToDateTime64(42::Int64, tz) != now() SETTINGS allow_nonconst_timezone_arguments = 1;
 
 DROP TABLE tab;

From 72f28321295187ddf40d02a887be3106f6ec4ac3 Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Tue, 13 Jun 2023 02:07:05 -0700
Subject: [PATCH 377/722] Slightly more information in error message about
 cached disk (#50897)

---
 src/Disks/ObjectStorages/Cached/registerDiskCache.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/Disks/ObjectStorages/Cached/registerDiskCache.cpp b/src/Disks/ObjectStorages/Cached/registerDiskCache.cpp
index 779ec6120f8..2b40fa9c21b 100644
--- a/src/Disks/ObjectStorages/Cached/registerDiskCache.cpp
+++ b/src/Disks/ObjectStorages/Cached/registerDiskCache.cpp
@@ -48,7 +48,9 @@ void registerDiskCache(DiskFactory & factory, bool /* global_skip_access_check *
         auto cache = FileCacheFactory::instance().getOrCreate(name, file_cache_settings);
         auto disk = disk_it->second;
         if (!dynamic_cast<const DiskObjectStorage *>(disk.get()))
-            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Cached disk is allowed only on top of object storage");
+            throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                "Cannot wrap disk `{}` with cache layer `{}`: cached disk is allowed only on top of object storage",
+                disk_name, name);
 
         auto disk_object_storage = disk->createDiskObjectStorage();
 

From 0ab3dc92618f8a7d1accd8f2e1cc21f851dead80 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Tue, 13 Jun 2023 11:25:13 +0200
Subject: [PATCH 378/722] A bit safer UserDefinedSQLFunctionVisitor (#50913)

* Update UserDefinedSQLFunctionVisitor.cpp

* Update UserDefinedSQLFunctionVisitor.cpp

---------

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 src/Functions/UserDefined/UserDefinedSQLFunctionVisitor.cpp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/Functions/UserDefined/UserDefinedSQLFunctionVisitor.cpp b/src/Functions/UserDefined/UserDefinedSQLFunctionVisitor.cpp
index 57cc45cc75d..597e4efe35e 100644
--- a/src/Functions/UserDefined/UserDefinedSQLFunctionVisitor.cpp
+++ b/src/Functions/UserDefined/UserDefinedSQLFunctionVisitor.cpp
@@ -25,6 +25,12 @@ namespace ErrorCodes
 
 void UserDefinedSQLFunctionVisitor::visit(ASTPtr & ast)
 {
+    if (!ast)
+    {
+        chassert(false);
+        return;
+    }
+
     const auto visit_child_with_shared_ptr = [&](ASTPtr & child)
     {
         if (!child)

From e5de6cde244f530c0f7d3ec1acad462025430e58 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Tue, 13 Jun 2023 11:37:24 +0000
Subject: [PATCH 379/722] Update after #50097

---
 tests/queries/0_stateless/01655_plan_optimizations.reference | 4 ++--
 tests/queries/0_stateless/01655_plan_optimizations.sh        | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/01655_plan_optimizations.reference b/tests/queries/0_stateless/01655_plan_optimizations.reference
index 34ea2bc20a3..be42a656c66 100644
--- a/tests/queries/0_stateless/01655_plan_optimizations.reference
+++ b/tests/queries/0_stateless/01655_plan_optimizations.reference
@@ -172,7 +172,7 @@ Filter column: notEquals(number, 1)
 Join
 > (analyzer) one condition of filter is pushed down before LEFT JOIN
 Join
-Filter column: notEquals(l.number_0, 1_UInt8)
+Filter column: notEquals(number_0, 1_UInt8)
 0	0
 3	3
 > one condition of filter is pushed down before INNER JOIN
@@ -181,7 +181,7 @@ Filter column: notEquals(number, 1)
 Join
 > (analyzer) one condition of filter is pushed down before INNER JOIN
 Join
-Filter column: notEquals(l.number_0, 1_UInt8)
+Filter column: notEquals(number_0, 1_UInt8)
 3	3
 > filter is pushed down before UNION
 Union
diff --git a/tests/queries/0_stateless/01655_plan_optimizations.sh b/tests/queries/0_stateless/01655_plan_optimizations.sh
index d68c2c8b414..a765a6ea4fa 100755
--- a/tests/queries/0_stateless/01655_plan_optimizations.sh
+++ b/tests/queries/0_stateless/01655_plan_optimizations.sh
@@ -236,7 +236,7 @@ $CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
     select number as a, r.b from numbers(4) as l any left join (
         select number + 2 as b from numbers(3)
     ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" |
-    grep -o "Join\|Filter column: notEquals(l.number_0, 1_UInt8)"
+    grep -o "Join\|Filter column: notEquals(number_0, 1_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select number as a, r.b from numbers(4) as l any left join (
         select number + 2 as b from numbers(3)
@@ -255,7 +255,7 @@ $CLICKHOUSE_CLIENT --allow_experimental_analyzer=1 -q "
     select number as a, r.b from numbers(4) as l any inner join (
         select number + 2 as b from numbers(3)
     ) as r on a = r.b where a != 1 and b != 2 settings enable_optimize_predicate_expression = 0" |
-        grep -o "Join\|Filter column: notEquals(l.number_0, 1_UInt8)"
+        grep -o "Join\|Filter column: notEquals(number_0, 1_UInt8)"
 $CLICKHOUSE_CLIENT -q "
     select number as a, r.b from numbers(4) as l any inner join (
         select number + 2 as b from numbers(3)

From a8b68a877aae945dee4e37b28e320a967a38f9f2 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Tue, 13 Jun 2023 14:37:33 +0300
Subject: [PATCH 380/722] Rename the 'time shift' variable in the test to make
 it more clear

---
 .../02783_parseDateTimeBestEffort_syslog.sql  | 76 +++++++++----------
 1 file changed, 38 insertions(+), 38 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
index 742ae03ddab..f3ca78e8310 100644
--- a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
@@ -2,45 +2,45 @@ WITH
     86400 AS secs_in_day,
     now() AS ts_now,
     '2023-06-07' AS ref_point,
-    dateDiff('second', toDateTime(ref_point), ts_now) AS impedimenta,
+    dateDiff('second', toDateTime(ref_point), ts_now) AS time_shift,
     formatDateTime(ts_around, '%b %e %T') AS dt_curr
 SELECT
-    formatDateTime(ts_around - impedimenta, '%b %e %H:%i:%s') AS around_June_7,
-    parseDateTimeBestEffort(dt_curr) - impedimenta AS res,
-    parseDateTimeBestEffort(dt_curr, 'US/Samoa') - impedimenta AS res_sam,
-    parseDateTimeBestEffort(dt_curr, 'Pacific/Auckland') - impedimenta AS res_auc,
-    parseDateTimeBestEffortOrNull(dt_curr) - impedimenta AS res_null,
-    parseDateTimeBestEffortOrNull(dt_curr, 'US/Samoa') - impedimenta AS res_null_sam,
-    parseDateTimeBestEffortOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_null_auc,
-    parseDateTimeBestEffortOrZero(dt_curr) - impedimenta AS res_zero,
-    parseDateTimeBestEffortOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_zero_sam,
-    parseDateTimeBestEffortOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_zero_auc,
-    parseDateTimeBestEffortUS(dt_curr) - impedimenta AS res_us,
-    parseDateTimeBestEffortUS(dt_curr, 'US/Samoa') - impedimenta AS res_us_sam,
-    parseDateTimeBestEffortUS(dt_curr, 'Pacific/Auckland') - impedimenta AS res_us_auc,
-    parseDateTimeBestEffortUSOrNull(dt_curr) - impedimenta AS res_us_null,
-    parseDateTimeBestEffortUSOrNull(dt_curr, 'US/Samoa') - impedimenta AS res_us_null_sam,
-    parseDateTimeBestEffortUSOrNull(dt_curr, 'Pacific/Auckland') - impedimenta AS res_us_null_auc,
-    parseDateTimeBestEffortUSOrZero(dt_curr) - impedimenta AS res_us_zero,
-    parseDateTimeBestEffortUSOrZero(dt_curr, 'US/Samoa') - impedimenta AS res_us_zero_sam,
-    parseDateTimeBestEffortUSOrZero(dt_curr, 'Pacific/Auckland') - impedimenta AS res_us_zero_auc,
-    parseDateTime64BestEffort(dt_curr) - impedimenta AS res64,
-    parseDateTime64BestEffort(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_sam,
-    parseDateTime64BestEffort(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_auc,
-    parseDateTime64BestEffortOrNull(dt_curr) - impedimenta AS res64_null,
-    parseDateTime64BestEffortOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_null_sam,
-    parseDateTime64BestEffortOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_null_auc,
-    parseDateTime64BestEffortOrZero(dt_curr) - impedimenta AS res64_zero,
-    parseDateTime64BestEffortOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_zero_sam,
-    parseDateTime64BestEffortOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_zero_auc,
-    parseDateTime64BestEffortUS(dt_curr) - impedimenta AS res64_us,
-    parseDateTime64BestEffortUS(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_us_sam,
-    parseDateTime64BestEffortUS(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_us_auc,
-    parseDateTime64BestEffortUSOrNull(dt_curr) - impedimenta AS res64_us_null,
-    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_us_null_sam,
-    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_us_null_auc,
-    parseDateTime64BestEffortUSOrZero(dt_curr) - impedimenta AS res64_us_zero,
-    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'US/Samoa') - impedimenta AS res64_us_zero_sam,
-    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'Pacific/Auckland') - impedimenta AS res64_us_zero_auc
+    formatDateTime(ts_around - time_shift, '%b %e %H:%i:%s') AS around_June_7,
+    parseDateTimeBestEffort(dt_curr) - time_shift AS res,
+    parseDateTimeBestEffort(dt_curr, 'US/Samoa') - time_shift AS res_sam,
+    parseDateTimeBestEffort(dt_curr, 'Pacific/Auckland') - time_shift AS res_auc,
+    parseDateTimeBestEffortOrNull(dt_curr) - time_shift AS res_null,
+    parseDateTimeBestEffortOrNull(dt_curr, 'US/Samoa') - time_shift AS res_null_sam,
+    parseDateTimeBestEffortOrNull(dt_curr, 'Pacific/Auckland') - time_shift AS res_null_auc,
+    parseDateTimeBestEffortOrZero(dt_curr) - time_shift AS res_zero,
+    parseDateTimeBestEffortOrZero(dt_curr, 'US/Samoa') - time_shift AS res_zero_sam,
+    parseDateTimeBestEffortOrZero(dt_curr, 'Pacific/Auckland') - time_shift AS res_zero_auc,
+    parseDateTimeBestEffortUS(dt_curr) - time_shift AS res_us,
+    parseDateTimeBestEffortUS(dt_curr, 'US/Samoa') - time_shift AS res_us_sam,
+    parseDateTimeBestEffortUS(dt_curr, 'Pacific/Auckland') - time_shift AS res_us_auc,
+    parseDateTimeBestEffortUSOrNull(dt_curr) - time_shift AS res_us_null,
+    parseDateTimeBestEffortUSOrNull(dt_curr, 'US/Samoa') - time_shift AS res_us_null_sam,
+    parseDateTimeBestEffortUSOrNull(dt_curr, 'Pacific/Auckland') - time_shift AS res_us_null_auc,
+    parseDateTimeBestEffortUSOrZero(dt_curr) - time_shift AS res_us_zero,
+    parseDateTimeBestEffortUSOrZero(dt_curr, 'US/Samoa') - time_shift AS res_us_zero_sam,
+    parseDateTimeBestEffortUSOrZero(dt_curr, 'Pacific/Auckland') - time_shift AS res_us_zero_auc,
+    parseDateTime64BestEffort(dt_curr) - time_shift AS res64,
+    parseDateTime64BestEffort(dt_curr, 3, 'US/Samoa') - time_shift AS res64_sam,
+    parseDateTime64BestEffort(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_auc,
+    parseDateTime64BestEffortOrNull(dt_curr) - time_shift AS res64_null,
+    parseDateTime64BestEffortOrNull(dt_curr, 3, 'US/Samoa') - time_shift AS res64_null_sam,
+    parseDateTime64BestEffortOrNull(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_null_auc,
+    parseDateTime64BestEffortOrZero(dt_curr) - time_shift AS res64_zero,
+    parseDateTime64BestEffortOrZero(dt_curr, 3, 'US/Samoa') - time_shift AS res64_zero_sam,
+    parseDateTime64BestEffortOrZero(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_zero_auc,
+    parseDateTime64BestEffortUS(dt_curr) - time_shift AS res64_us,
+    parseDateTime64BestEffortUS(dt_curr, 3, 'US/Samoa') - time_shift AS res64_us_sam,
+    parseDateTime64BestEffortUS(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_us_auc,
+    parseDateTime64BestEffortUSOrNull(dt_curr) - time_shift AS res64_us_null,
+    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'US/Samoa') - time_shift AS res64_us_null_sam,
+    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_us_null_auc,
+    parseDateTime64BestEffortUSOrZero(dt_curr) - time_shift AS res64_us_zero,
+    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'US/Samoa') - time_shift AS res64_us_zero_sam,
+    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
 FROM (SELECT arrayJoin([ts_now - secs_in_day, ts_now + secs_in_day]) AS ts_around)
 FORMAT PrettySpaceNoEscapes;

From 38151f9c767d12b18e26ccc236244bc929c326bb Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Tue, 13 Jun 2023 14:59:38 +0300
Subject: [PATCH 381/722] Rename the test to the snake_case after the Team
 Lead's review

---
 ...g.reference => 02783_parsedatetimebesteffort_syslog.reference} | 0
 ...Effort_syslog.sql => 02783_parsedatetimebesteffort_syslog.sql} | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename tests/queries/0_stateless/{02783_parseDateTimeBestEffort_syslog.reference => 02783_parsedatetimebesteffort_syslog.reference} (100%)
 rename tests/queries/0_stateless/{02783_parseDateTimeBestEffort_syslog.sql => 02783_parsedatetimebesteffort_syslog.sql} (100%)

diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
similarity index 100%
rename from tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.reference
rename to tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
diff --git a/tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
similarity index 100%
rename from tests/queries/0_stateless/02783_parseDateTimeBestEffort_syslog.sql
rename to tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql

From 3e3b8ff5f6b78c6ddd202d154ea9101625c561f1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 13 Jun 2023 09:14:15 +0000
Subject: [PATCH 382/722] More robustness

---
 src/Functions/FunctionSnowflake.h | 40 ++++++++++++++++++++++++++-----
 1 file changed, 34 insertions(+), 6 deletions(-)

diff --git a/src/Functions/FunctionSnowflake.h b/src/Functions/FunctionSnowflake.h
index ace2fc54f09..c7ec6dca27f 100644
--- a/src/Functions/FunctionSnowflake.h
+++ b/src/Functions/FunctionSnowflake.h
@@ -6,6 +6,7 @@
 #include <DataTypes/DataTypeDateTime64.h>
 #include <DataTypes/DataTypesNumber.h>
 #include <Columns/ColumnConst.h>
+#include <Columns/ColumnsDateTime.h>
 #include <Columns/ColumnsNumber.h>
 #include <Interpreters/Context.h>
 
@@ -59,9 +60,20 @@ public:
         auto res_column = ColumnInt64::create(input_rows_count);
         auto & res_data = res_column->getData();
 
-        const auto & src_data = typeid_cast<const ColumnDecimal<DateTime64> &>(src_column).getData();
-        for (size_t i = 0; i < input_rows_count; ++i)
-            res_data[i] = (UInt32(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
+        if (const auto * src_column_non_const = typeid_cast<const ColumnDateTime *>(&src_column))
+        {
+            const auto & src_data = src_column_non_const->getData();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                res_data[i] = (UInt32(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
+        }
+        else if (const auto * src_column_const = typeid_cast<const ColumnConst *>(&src_column))
+        {
+            UInt32 src_val = src_column_const->getValue<UInt32>();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                res_data[i] = (src_val * 1000 - snowflake_epoch) << time_shift;
+        }
+        else
+            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal argument for function {}", name);
 
         return res_column;
     }
@@ -122,6 +134,9 @@ public:
                 res_data[i] = static_cast<UInt32>(
                     ((src_val >> time_shift) + snowflake_epoch) / 1000);
         }
+        else
+            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal argument for function {}", name);
+
         return res_column;
     }
 };
@@ -157,9 +172,20 @@ public:
         auto res_column = ColumnInt64::create(input_rows_count);
         auto & res_data = res_column->getData();
 
-        const auto & src_data = typeid_cast<const ColumnDecimal<DateTime64> &>(src_column).getData();
-        for (size_t i = 0; i < input_rows_count; ++i)
-            res_data[i] = (src_data[i] - snowflake_epoch) << time_shift;
+        if (const auto * src_column_non_const = typeid_cast<const ColumnDateTime64 *>(&src_column))
+        {
+            const auto & src_data = src_column_non_const->getData();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                res_data[i] = (UInt32(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
+        }
+        else if (const auto * src_column_const = typeid_cast<const ColumnConst *>(&src_column))
+        {
+            UInt32 src_val = src_column_const->getValue<UInt32>();
+            for (size_t i = 0; i < input_rows_count; ++i)
+                res_data[i] = (src_val * 1000 - snowflake_epoch) << time_shift;
+        }
+        else
+            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal argument for function {}", name);
 
         return res_column;
     }
@@ -219,6 +245,8 @@ public:
             for (size_t i = 0; i < input_rows_count; ++i)
                 res_data[i] = (src_val >> time_shift) + snowflake_epoch;
         }
+        else
+            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal argument for function {}", name);
 
         return res_column;
     }

From eddd932636fdb16802ec0b541a7cb927abcc05ff Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Tue, 13 Jun 2023 12:34:26 +0000
Subject: [PATCH 383/722] Do not apply projection if read-in-order was enabled.

---
 .../Optimizations/projectionsCommon.cpp       |  3 ++
 .../QueryPlan/ReadFromMergeTree.cpp           |  5 ++
 src/Processors/QueryPlan/ReadFromMergeTree.h  |  1 +
 ...84_projections_read_in_order_bug.reference |  0
 .../02784_projections_read_in_order_bug.sql   | 48 +++++++++++++++++++
 5 files changed, 57 insertions(+)
 create mode 100644 tests/queries/0_stateless/02784_projections_read_in_order_bug.reference
 create mode 100644 tests/queries/0_stateless/02784_projections_read_in_order_bug.sql

diff --git a/src/Processors/QueryPlan/Optimizations/projectionsCommon.cpp b/src/Processors/QueryPlan/Optimizations/projectionsCommon.cpp
index 2f73e14b2a0..cb76ffa84ba 100644
--- a/src/Processors/QueryPlan/Optimizations/projectionsCommon.cpp
+++ b/src/Processors/QueryPlan/Optimizations/projectionsCommon.cpp
@@ -38,6 +38,9 @@ bool canUseProjectionForReadingStep(ReadFromMergeTree * reading)
     if (reading->isParallelReadingEnabled())
         return false;
 
+    if (reading->readsInOrder())
+        return false;
+
     // Currently projection don't support deduplication when moving parts between shards.
     if (reading->getContext()->getSettingsRef().allow_experimental_query_deduplication)
         return false;
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.cpp b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
index 2415507a6eb..3c38ecbbd3f 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.cpp
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.cpp
@@ -1427,6 +1427,11 @@ bool ReadFromMergeTree::requestReadingInOrder(size_t prefix_size, int direction,
     return true;
 }
 
+bool ReadFromMergeTree::readsInOrder() const
+{
+    return reader_settings.read_in_order;
+}
+
 void ReadFromMergeTree::updatePrewhereInfo(const PrewhereInfoPtr & prewhere_info_value)
 {
     query_info.prewhere_info = prewhere_info_value;
diff --git a/src/Processors/QueryPlan/ReadFromMergeTree.h b/src/Processors/QueryPlan/ReadFromMergeTree.h
index 45beaaaf013..99cbe9d9e50 100644
--- a/src/Processors/QueryPlan/ReadFromMergeTree.h
+++ b/src/Processors/QueryPlan/ReadFromMergeTree.h
@@ -161,6 +161,7 @@ public:
 
     /// Returns `false` if requested reading cannot be performed.
     bool requestReadingInOrder(size_t prefix_size, int direction, size_t limit);
+    bool readsInOrder() const;
 
     void updatePrewhereInfo(const PrewhereInfoPtr & prewhere_info_value);
 
diff --git a/tests/queries/0_stateless/02784_projections_read_in_order_bug.reference b/tests/queries/0_stateless/02784_projections_read_in_order_bug.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql b/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
new file mode 100644
index 00000000000..52a3a6127ac
--- /dev/null
+++ b/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
@@ -0,0 +1,48 @@
+create table events (
+    `organisation_id` UUID,
+    `session_id` UUID,
+    `id` UUID DEFAULT generateUUIDv4(),
+    `timestamp` UInt64,
+    `payload` String,
+    `customer_id` UUID,
+    `call_id` String,
+    PROJECTION events_by_session_and_org
+    (
+        SELECT *
+        ORDER BY
+            organisation_id,
+            session_id,
+            timestamp
+    ),
+    PROJECTION events_by_session
+    (
+        SELECT *
+        ORDER BY
+            session_id,
+            timestamp
+    ),
+    PROJECTION events_by_session_and_customer
+    (
+        SELECT *
+        ORDER BY
+            customer_id,
+            session_id,
+            timestamp
+    ),
+    PROJECTION events_by_call_id
+    (
+        SELECT *
+        ORDER BY
+            call_id,
+            timestamp
+    )) engine = MergeTree order by (organisation_id, session_id, timestamp) settings index_granularity = 3;
+
+
+#insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02'), toString(0), reinterpretAsUUID(0), toString(0));
+#insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02'), toString(0), reinterpretAsUUID(0), toString(0));
+
+insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0));
+insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0));
+
+set read_in_order_two_level_merge_threshold=1;
+SELECT id, timestamp, payload FROM events WHERE (organisation_id = reinterpretAsUUID(1)) AND (session_id = reinterpretAsUUID(0)) ORDER BY timestamp, payload, id ASC;

From 1a4b7e8ebec920943a39c484576f147c130b00ec Mon Sep 17 00:00:00 2001
From: Val Doroshchuk <valbok@gmail.com>
Date: Tue, 13 Jun 2023 14:36:31 +0200
Subject: [PATCH 384/722] MaterializedMySQL: Add missing DROP DATABASE for
 tests

---
 .../materialize_with_ddl.py                           | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
index 2bbbe9a3f13..7efb9ac54a9 100644
--- a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
+++ b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
@@ -1476,6 +1476,9 @@ def utf8mb4_test(clickhouse_node, mysql_node, service_name):
         "1\t\U0001F984\n2\t\u2601\n",
     )
 
+    clickhouse_node.query("DROP DATABASE utf8mb4_test")
+    mysql_node.query("DROP DATABASE utf8mb4_test")
+
 
 def system_parts_test(clickhouse_node, mysql_node, service_name):
     mysql_node.query("DROP DATABASE IF EXISTS system_parts_test")
@@ -1504,6 +1507,9 @@ def system_parts_test(clickhouse_node, mysql_node, service_name):
     clickhouse_node.query("OPTIMIZE TABLE system_parts_test.test")
     check_active_parts(1)
 
+    clickhouse_node.query("DROP DATABASE system_parts_test")
+    mysql_node.query("DROP DATABASE system_parts_test")
+
 
 def multi_table_update_test(clickhouse_node, mysql_node, service_name):
     mysql_node.query("DROP DATABASE IF EXISTS multi_table_update")
@@ -1529,6 +1535,8 @@ def multi_table_update_test(clickhouse_node, mysql_node, service_name):
 
     check_query(clickhouse_node, "SELECT * FROM multi_table_update.a", "1\tbaz\n")
     check_query(clickhouse_node, "SELECT * FROM multi_table_update.b", "1\tquux\n")
+    clickhouse_node.query("DROP DATABASE multi_table_update")
+    mysql_node.query("DROP DATABASE multi_table_update")
 
 
 def system_tables_test(clickhouse_node, mysql_node, service_name):
@@ -1549,6 +1557,9 @@ def system_tables_test(clickhouse_node, mysql_node, service_name):
         "intDiv(id, 4294967)\tid\tid\n",
     )
 
+    clickhouse_node.query("DROP DATABASE system_tables_test")
+    mysql_node.query("DROP DATABASE system_tables_test")
+
 
 def materialize_with_column_comments_test(clickhouse_node, mysql_node, service_name):
     mysql_node.query("DROP DATABASE IF EXISTS materialize_with_column_comments_test")

From f4ed10c0a28b52f140f542c7ab0b21e1edf9a0c0 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <mrnovikd@gmail.com>
Date: Tue, 13 Jun 2023 14:44:39 +0200
Subject: [PATCH 385/722] Update src/Storages/StorageReplicatedMergeTree.cpp

---
 src/Storages/StorageReplicatedMergeTree.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index fafb3b124f2..84eae32495d 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -4751,10 +4751,10 @@ void StorageReplicatedMergeTree::read(
         }
         else
         {
-            header
-                = InterpreterSelectQuery(modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze()).getSampleBlock();
             modified_query_ast = ClusterProxy::rewriteSelectQuery(local_context, query_info.query,
                 table_id.database_name, table_id.table_name, /*remote_table_function_ptr*/nullptr);
+            header
+                = InterpreterSelectQuery(modified_query_ast, local_context, SelectQueryOptions(processed_stage).analyze()).getSampleBlock();
         }
 
         auto cluster = local_context->getCluster(local_context->getSettingsRef().cluster_for_parallel_replicas);

From 46c23b3f8d185bf79cb819c2beff0216ca73c4bd Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 13 Jun 2023 15:46:54 +0200
Subject: [PATCH 386/722] Fixed docs check fails

---
 docs/en/sql-reference/table-functions/azureBlobStorage.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
index 7a362710b9c..8587d9839b8 100644
--- a/docs/en/sql-reference/table-functions/azureBlobStorage.md
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -1,5 +1,5 @@
 ---
-slug: /en/sql-reference/table-functions/azure_blob_storage
+slug: /en/sql-reference/table-functions/azureBlobStorageg
 sidebar_label: azureBlobStorage
 keywords: [azure blob storage]
 ---

From ab020f9311eea0f657f57493e14191e75e51f8af Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 13 Jun 2023 15:48:42 +0200
Subject: [PATCH 387/722] Fixed typo

---
 docs/en/sql-reference/table-functions/azureBlobStorage.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
index 8587d9839b8..5175aabd5d1 100644
--- a/docs/en/sql-reference/table-functions/azureBlobStorage.md
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -1,5 +1,5 @@
 ---
-slug: /en/sql-reference/table-functions/azureBlobStorageg
+slug: /en/sql-reference/table-functions/azureBlobStorage
 sidebar_label: azureBlobStorage
 keywords: [azure blob storage]
 ---

From 3a2fa65075ab32a04a377cef632dd1679dea02b0 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 13 Jun 2023 16:02:54 +0200
Subject: [PATCH 388/722] fix 'Illegal column timezone' in stress tests

---
 docker/test/upgrade/run.sh                 | 6 ++----
 tests/config/install.sh                    | 1 +
 tests/config/users.d/nonconst_timezone.xml | 7 +++++++
 3 files changed, 10 insertions(+), 4 deletions(-)
 create mode 100644 tests/config/users.d/nonconst_timezone.xml

diff --git a/docker/test/upgrade/run.sh b/docker/test/upgrade/run.sh
index 6f7d3999f1d..951c443c30d 100644
--- a/docker/test/upgrade/run.sh
+++ b/docker/test/upgrade/run.sh
@@ -59,8 +59,7 @@ install_packages previous_release_package_folder
 # available for dump via clickhouse-local
 configure
 
-# it contains some new settings, but we can safely remove it
-rm /etc/clickhouse-server/config.d/merge_tree.xml
+rm /etc/clickhouse-server/users.d/nonconst_timezone.xml
 
 start
 stop
@@ -86,8 +85,7 @@ export USE_S3_STORAGE_FOR_MERGE_TREE=1
 export ZOOKEEPER_FAULT_INJECTION=0
 configure
 
-# it contains some new settings, but we can safely remove it
-rm /etc/clickhouse-server/config.d/merge_tree.xml
+rm /etc/clickhouse-server/users.d/nonconst_timezone.xml
 
 start
 
diff --git a/tests/config/install.sh b/tests/config/install.sh
index efa5a9c086e..b2153db1b2c 100755
--- a/tests/config/install.sh
+++ b/tests/config/install.sh
@@ -78,6 +78,7 @@ ln -sf $SRC_PATH/users.d/enable_blobs_check.xml $DEST_SERVER_PATH/users.d/
 ln -sf $SRC_PATH/users.d/marks.xml $DEST_SERVER_PATH/users.d/
 ln -sf $SRC_PATH/users.d/insert_keeper_retries.xml $DEST_SERVER_PATH/users.d/
 ln -sf $SRC_PATH/users.d/prefetch_settings.xml $DEST_SERVER_PATH/users.d/
+ln -sf $SRC_PATH/users.d/nonconst_timezone.xml $DEST_SERVER_PATH/users.d/
 
 if [[ -n "$USE_NEW_ANALYZER" ]] && [[ "$USE_NEW_ANALYZER" -eq 1 ]]; then
     ln -sf $SRC_PATH/users.d/analyzer.xml $DEST_SERVER_PATH/users.d/
diff --git a/tests/config/users.d/nonconst_timezone.xml b/tests/config/users.d/nonconst_timezone.xml
new file mode 100644
index 00000000000..c7e9de5ab69
--- /dev/null
+++ b/tests/config/users.d/nonconst_timezone.xml
@@ -0,0 +1,7 @@
+<clickhouse>
+    <profiles>
+        <default>
+            <allow_nonconst_timezone_arguments>1</allow_nonconst_timezone_arguments>
+        </default>
+    </profiles>
+</clickhouse>

From 8ea7560d898879e74887e042aca0a6c60031191b Mon Sep 17 00:00:00 2001
From: Val Doroshchuk <valbok@gmail.com>
Date: Tue, 13 Jun 2023 16:28:53 +0200
Subject: [PATCH 389/722] MaterializedMySQL: Add additional test case to
 insert_with_modify_binlog_checksum (#50884)

---
 .../materialize_with_ddl.py                     | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
index 2bbbe9a3f13..f5c28832f79 100644
--- a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
+++ b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
@@ -1050,6 +1050,8 @@ def select_without_columns(clickhouse_node, mysql_node, service_name):
 
 
 def insert_with_modify_binlog_checksum(clickhouse_node, mysql_node, service_name):
+    clickhouse_node.query("DROP DATABASE IF EXISTS test_checksum")
+    mysql_node.query("DROP DATABASE IF EXISTS test_checksum")
     mysql_node.query("CREATE DATABASE test_checksum")
     mysql_node.query("CREATE TABLE test_checksum.t (a INT PRIMARY KEY, b varchar(200))")
     clickhouse_node.query(
@@ -1081,6 +1083,21 @@ def insert_with_modify_binlog_checksum(clickhouse_node, mysql_node, service_name
         "1\t1111\n2\t2222\n3\t3333\n",
     )
 
+    clickhouse_node.query("DROP DATABASE test_checksum")
+    mysql_node.query("SET GLOBAL binlog_checksum=NONE")
+    clickhouse_node.query(
+        "CREATE DATABASE test_checksum ENGINE = MaterializeMySQL('{}:3306', 'test_checksum', 'root', 'clickhouse')".format(
+            service_name
+        )
+    )
+    check_query(clickhouse_node, "SHOW TABLES FROM test_checksum FORMAT TSV", "t\n")
+    mysql_node.query("INSERT INTO test_checksum.t VALUES(4, '4444')")
+    check_query(
+        clickhouse_node,
+        "SELECT * FROM test_checksum.t ORDER BY a FORMAT TSV",
+        "1\t1111\n2\t2222\n3\t3333\n4\t4444\n",
+    )
+
     clickhouse_node.query("DROP DATABASE test_checksum")
     mysql_node.query("DROP DATABASE test_checksum")
 

From c253c70510008eda1fc3aadb72cf5c8a92e875bb Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Tue, 13 Jun 2023 16:33:36 +0200
Subject: [PATCH 390/722] Fix for  MDXContent

---
 docs/en/engines/table-engines/mergetree-family/annindexes.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 16e244077a7..6b9c3d6157f 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -202,10 +202,10 @@ CHECK length(vectors) = 256`.
 Setting `annoy_index_search_k_nodes` (default: `NumTrees * LIMIT`) determines how many tree nodes are inspected during SELECTs. Larger
 values mean more accurate results at the cost of longer query runtime:
 
-``` sql
+```sql
 SELECT *
 FROM table_name
 ORDER BY L2Distance(vectors, Point)
 LIMIT N
-SETTINGS annoy_index_search_k_nodes=100
+SETTINGS annoy_index_search_k_nodes=100;
 ```

From 263be33297a2ada5e5c5281924b56e5ffaa3f80f Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 16:37:52 +0200
Subject: [PATCH 391/722] Fix tests for throttling by allowing more margin of
 error for trottling event

Right now 02703_max_local_write_bandwidth is flaky, and the reason I
believe is that the server spent spent sometime somewhere else, which
means that the throttler will sleep less.

But what is important here is that the overall query duration time
matches the expectation, so it is OK to match the
LocalWriteThrottlerSleepMicroseconds/LocalReadThrottlerSleepMicroseconds
with some error rate.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 tests/queries/0_stateless/02703_max_local_read_bandwidth.sh  | 2 +-
 tests/queries/0_stateless/02703_max_local_write_bandwidth.sh | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02703_max_local_read_bandwidth.sh b/tests/queries/0_stateless/02703_max_local_read_bandwidth.sh
index d47e2f363bd..c78cd202f1b 100755
--- a/tests/queries/0_stateless/02703_max_local_read_bandwidth.sh
+++ b/tests/queries/0_stateless/02703_max_local_read_bandwidth.sh
@@ -32,7 +32,7 @@ for read_method in "${read_methods[@]}"; do
             query_duration_ms >= 7e3,
             ProfileEvents['ReadBufferFromFileDescriptorReadBytes'] > 8e6,
             ProfileEvents['LocalReadThrottlerBytes'] > 8e6,
-            ProfileEvents['LocalReadThrottlerSleepMicroseconds'] > 7e6*0.9
+            ProfileEvents['LocalReadThrottlerSleepMicroseconds'] > 7e6*0.5
         FROM system.query_log
         WHERE current_database = '$CLICKHOUSE_DATABASE' AND query_id = '$query_id' AND type != 'QueryStart'
     "
diff --git a/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh b/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh
index 41165d35d37..ccde0903278 100755
--- a/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh
+++ b/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh
@@ -19,7 +19,7 @@ $CLICKHOUSE_CLIENT -nm -q "
         query_duration_ms >= 7e3,
         ProfileEvents['WriteBufferFromFileDescriptorWriteBytes'] > 8e6,
         ProfileEvents['LocalWriteThrottlerBytes'] > 8e6,
-        ProfileEvents['LocalWriteThrottlerSleepMicroseconds'] > 7e6*0.9
+        ProfileEvents['LocalWriteThrottlerSleepMicroseconds'] > 7e6*0.5
     FROM system.query_log
     WHERE current_database = '$CLICKHOUSE_DATABASE' AND query_id = '$query_id' AND type != 'QueryStart'
 "

From 0f4e3a34e846c3a635456dbc8cafa3c12c91155b Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <KochetovNicolai@users.noreply.github.com>
Date: Tue, 13 Jun 2023 16:42:30 +0200
Subject: [PATCH 392/722] Update 02784_projections_read_in_order_bug.sql

---
 .../0_stateless/02784_projections_read_in_order_bug.sql       | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql b/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
index 52a3a6127ac..9595fc9ae08 100644
--- a/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
+++ b/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
@@ -37,10 +37,6 @@ create table events (
             timestamp
     )) engine = MergeTree order by (organisation_id, session_id, timestamp) settings index_granularity = 3;
 
-
-#insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02'), toString(0), reinterpretAsUUID(0), toString(0));
-#insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), now(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02'), toString(0), reinterpretAsUUID(0), toString(0));
-
 insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0));
 insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0));
 

From 52a460df67f38f92e67316115fde6139cb1c7937 Mon Sep 17 00:00:00 2001
From: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
Date: Tue, 13 Jun 2023 16:43:35 +0200
Subject: [PATCH 393/722] Tests with parallel replicas are no more "always
 green" (#50896)

---
 src/Interpreters/InterpreterSelectQuery.cpp   |  6 +--
 tests/ci/functional_test_check.py             | 42 +++++--------------
 .../1_stateful/00013_sorting_of_nested.sql    |  3 --
 .../1_stateful/00022_merge_prewhere.sql       |  2 -
 .../1_stateful/00042_any_left_join.sql        |  2 -
 .../1_stateful/00043_any_left_join.sql        |  2 -
 .../1_stateful/00044_any_left_join_string.sql |  2 -
 .../1_stateful/00063_loyalty_joins.sql        |  2 -
 .../00065_loyalty_with_storage_join.sql       |  2 -
 tests/queries/1_stateful/00074_full_join.sql  |  2 -
 .../1_stateful/00075_left_array_join.sql      |  2 -
 ...0079_array_join_not_used_joined_column.sql |  2 -
 .../1_stateful/00080_array_join_and_union.sql |  2 -
 .../1_stateful/00084_external_aggregation.sql |  2 -
 tests/queries/1_stateful/00092_obfuscator.sh  |  3 +-
 .../1_stateful/00096_obfuscator_save_load.sh  |  2 -
 .../00146_aggregate_function_uniq.sql         |  2 -
 .../00149_quantiles_timing_distributed.sql    |  2 +-
 .../00152_insert_different_granularity.sql    |  2 +-
 ...00156_max_execution_speed_sample_merge.sql |  3 --
 .../1_stateful/00166_explain_estimate.sql     |  2 +-
 tests/queries/1_stateful/00170_s3_cache.sql   |  2 +-
 ...0171_grouping_aggregated_transform_bug.sql |  2 +-
 23 files changed, 19 insertions(+), 74 deletions(-)

diff --git a/src/Interpreters/InterpreterSelectQuery.cpp b/src/Interpreters/InterpreterSelectQuery.cpp
index e84a400a220..1f95b1ebf9f 100644
--- a/src/Interpreters/InterpreterSelectQuery.cpp
+++ b/src/Interpreters/InterpreterSelectQuery.cpp
@@ -477,7 +477,7 @@ InterpreterSelectQuery::InterpreterSelectQuery(
     /// Check support for JOIN for parallel replicas with custom key
     if (joined_tables.tablesCount() > 1 && !settings.parallel_replicas_custom_key.value.empty())
     {
-        LOG_WARNING(log, "JOINs are not supported with parallel_replicas_custom_key. Query will be executed without using them.");
+        LOG_DEBUG(log, "JOINs are not supported with parallel_replicas_custom_key. Query will be executed without using them.");
         context->setSetting("parallel_replicas_custom_key", String{""});
     }
 
@@ -487,7 +487,7 @@ InterpreterSelectQuery::InterpreterSelectQuery(
     {
         if (settings.allow_experimental_parallel_reading_from_replicas == 1)
         {
-            LOG_WARNING(log, "FINAL modifier is not supported with parallel replicas. Query will be executed without using them.");
+            LOG_DEBUG(log, "FINAL modifier is not supported with parallel replicas. Query will be executed without using them.");
             context->setSetting("allow_experimental_parallel_reading_from_replicas", Field(0));
             context->setSetting("parallel_replicas_custom_key", String{""});
         }
@@ -503,7 +503,7 @@ InterpreterSelectQuery::InterpreterSelectQuery(
     {
         if (settings.allow_experimental_parallel_reading_from_replicas == 1)
         {
-            LOG_WARNING(log, "To use parallel replicas with plain MergeTree tables please enable setting `parallel_replicas_for_non_replicated_merge_tree`. For now query will be executed without using them.");
+            LOG_DEBUG(log, "To use parallel replicas with plain MergeTree tables please enable setting `parallel_replicas_for_non_replicated_merge_tree`. For now query will be executed without using them.");
             context->setSetting("allow_experimental_parallel_reading_from_replicas", Field(0));
         }
         else if (settings.allow_experimental_parallel_reading_from_replicas == 2)
diff --git a/tests/ci/functional_test_check.py b/tests/ci/functional_test_check.py
index 037bb13f1f8..864c3a81acf 100644
--- a/tests/ci/functional_test_check.py
+++ b/tests/ci/functional_test_check.py
@@ -378,34 +378,16 @@ def main():
 
     print(f"::notice:: {check_name} Report url: {report_url}")
     if args.post_commit_status == "commit_status":
-        if "parallelreplicas" in check_name.lower():
-            post_commit_status(
-                commit,
-                "success",
-                report_url,
-                description,
-                check_name_with_group,
-                pr_info,
-            )
-        else:
-            post_commit_status(
-                commit, state, report_url, description, check_name_with_group, pr_info
-            )
+        post_commit_status(
+            commit, state, report_url, description, check_name_with_group, pr_info
+        )
     elif args.post_commit_status == "file":
-        if "parallelreplicas" in check_name.lower():
-            post_commit_status_to_file(
-                post_commit_path,
-                description,
-                "success",
-                report_url,
-            )
-        else:
-            post_commit_status_to_file(
-                post_commit_path,
-                description,
-                state,
-                report_url,
-            )
+        post_commit_status_to_file(
+            post_commit_path,
+            description,
+            state,
+            report_url,
+        )
     else:
         raise Exception(
             f'Unknown post_commit_status option "{args.post_commit_status}"'
@@ -423,11 +405,7 @@ def main():
     ch_helper.insert_events_into(db="default", table="checks", events=prepared_events)
 
     if state != "success":
-        # Parallel replicas are always green for now
-        if (
-            FORCE_TESTS_LABEL in pr_info.labels
-            or "parallelreplicas" in check_name.lower()
-        ):
+        if FORCE_TESTS_LABEL in pr_info.labels:
             print(f"'{FORCE_TESTS_LABEL}' enabled, will report success")
         else:
             sys.exit(1)
diff --git a/tests/queries/1_stateful/00013_sorting_of_nested.sql b/tests/queries/1_stateful/00013_sorting_of_nested.sql
index f97120e2b98..7f4a5002a7b 100644
--- a/tests/queries/1_stateful/00013_sorting_of_nested.sql
+++ b/tests/queries/1_stateful/00013_sorting_of_nested.sql
@@ -1,4 +1 @@
--- Tags: no-parallel-replicas
-
 SELECT ParsedParams.Key1 FROM test.visits FINAL WHERE VisitID != 0 AND notEmpty(ParsedParams.Key1) ORDER BY VisitID LIMIT 10
-
diff --git a/tests/queries/1_stateful/00022_merge_prewhere.sql b/tests/queries/1_stateful/00022_merge_prewhere.sql
index 400a896d5a8..74a3677b68e 100644
--- a/tests/queries/1_stateful/00022_merge_prewhere.sql
+++ b/tests/queries/1_stateful/00022_merge_prewhere.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 DROP TABLE IF EXISTS test.merge_hits;
 CREATE TABLE IF NOT EXISTS test.merge_hits AS test.hits ENGINE = Merge(test, '^hits$');
 SELECT count() FROM test.merge_hits WHERE AdvEngineID = 2;
diff --git a/tests/queries/1_stateful/00042_any_left_join.sql b/tests/queries/1_stateful/00042_any_left_join.sql
index c7c0f0f987a..b87cf88f007 100644
--- a/tests/queries/1_stateful/00042_any_left_join.sql
+++ b/tests/queries/1_stateful/00042_any_left_join.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 SELECT
     EventDate,
     hits,
diff --git a/tests/queries/1_stateful/00043_any_left_join.sql b/tests/queries/1_stateful/00043_any_left_join.sql
index 6b8cce54051..704d38f727a 100644
--- a/tests/queries/1_stateful/00043_any_left_join.sql
+++ b/tests/queries/1_stateful/00043_any_left_join.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 SELECT
     EventDate,
     count() AS hits,
diff --git a/tests/queries/1_stateful/00044_any_left_join_string.sql b/tests/queries/1_stateful/00044_any_left_join_string.sql
index ceb7a1c1783..a4f2e9e1b96 100644
--- a/tests/queries/1_stateful/00044_any_left_join_string.sql
+++ b/tests/queries/1_stateful/00044_any_left_join_string.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 SELECT
     domain,
     hits,
diff --git a/tests/queries/1_stateful/00063_loyalty_joins.sql b/tests/queries/1_stateful/00063_loyalty_joins.sql
index 44f0767a87a..44b575cab85 100644
--- a/tests/queries/1_stateful/00063_loyalty_joins.sql
+++ b/tests/queries/1_stateful/00063_loyalty_joins.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 SET any_join_distinct_right_table_keys = 1;
 SET joined_subquery_requires_alias = 0;
 
diff --git a/tests/queries/1_stateful/00065_loyalty_with_storage_join.sql b/tests/queries/1_stateful/00065_loyalty_with_storage_join.sql
index 35f0c7b60b9..a0f41f8aa8d 100644
--- a/tests/queries/1_stateful/00065_loyalty_with_storage_join.sql
+++ b/tests/queries/1_stateful/00065_loyalty_with_storage_join.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 USE test;
 
 DROP TABLE IF EXISTS join;
diff --git a/tests/queries/1_stateful/00074_full_join.sql b/tests/queries/1_stateful/00074_full_join.sql
index c1d9e4be1a4..f049be2a74d 100644
--- a/tests/queries/1_stateful/00074_full_join.sql
+++ b/tests/queries/1_stateful/00074_full_join.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 set any_join_distinct_right_table_keys = 1;
 set joined_subquery_requires_alias = 0;
 
diff --git a/tests/queries/1_stateful/00075_left_array_join.sql b/tests/queries/1_stateful/00075_left_array_join.sql
index 3540d791157..1fd045a26bf 100644
--- a/tests/queries/1_stateful/00075_left_array_join.sql
+++ b/tests/queries/1_stateful/00075_left_array_join.sql
@@ -1,4 +1,2 @@
--- Tags: no-parallel-replicas
-
 SELECT UserID, EventTime::DateTime('Asia/Dubai'), pp.Key1, pp.Key2, ParsedParams.Key1 FROM test.hits ARRAY JOIN ParsedParams AS pp WHERE CounterID = 1704509 ORDER BY UserID, EventTime, pp.Key1, pp.Key2 LIMIT 100;
 SELECT UserID, EventTime::DateTime('Asia/Dubai'), pp.Key1, pp.Key2, ParsedParams.Key1 FROM test.hits LEFT ARRAY JOIN ParsedParams AS pp WHERE CounterID = 1704509 ORDER BY UserID, EventTime, pp.Key1, pp.Key2 LIMIT 100;
diff --git a/tests/queries/1_stateful/00079_array_join_not_used_joined_column.sql b/tests/queries/1_stateful/00079_array_join_not_used_joined_column.sql
index 9431e1cf596..8e6742bb1e1 100644
--- a/tests/queries/1_stateful/00079_array_join_not_used_joined_column.sql
+++ b/tests/queries/1_stateful/00079_array_join_not_used_joined_column.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 SELECT PP.Key1 AS `ym:s:paramsLevel1`, sum(arrayAll(`x_1` -> `x_1`= '', ParsedParams.Key2)) AS `ym:s:visits` FROM test.hits ARRAY JOIN ParsedParams AS `PP`  WHERE CounterID = 1704509 GROUP BY `ym:s:paramsLevel1` ORDER BY PP.Key1, `ym:s:visits` LIMIT 0, 100;
 SELECT PP.Key1 AS x1, ParsedParams.Key2 AS x2 FROM test.hits ARRAY JOIN ParsedParams AS PP WHERE CounterID = 1704509 ORDER BY x1, x2 LIMIT 10;
 SELECT ParsedParams.Key2 AS x FROM test.hits ARRAY JOIN ParsedParams AS PP ORDER BY x DESC LIMIT 10;
diff --git a/tests/queries/1_stateful/00080_array_join_and_union.sql b/tests/queries/1_stateful/00080_array_join_and_union.sql
index 2f2e5e9324f..d9aa1cc17cc 100644
--- a/tests/queries/1_stateful/00080_array_join_and_union.sql
+++ b/tests/queries/1_stateful/00080_array_join_and_union.sql
@@ -1,3 +1 @@
--- Tags: no-parallel-replicas
-
 SELECT count() FROM (SELECT Goals.ID FROM test.visits ARRAY JOIN Goals WHERE CounterID = 842440 LIMIT 10 UNION ALL SELECT Goals.ID FROM test.visits ARRAY JOIN Goals WHERE CounterID = 842440 LIMIT 10);
diff --git a/tests/queries/1_stateful/00084_external_aggregation.sql b/tests/queries/1_stateful/00084_external_aggregation.sql
index 330aa158cf7..b3922eae049 100644
--- a/tests/queries/1_stateful/00084_external_aggregation.sql
+++ b/tests/queries/1_stateful/00084_external_aggregation.sql
@@ -1,5 +1,3 @@
--- Tags: no-random-settings, no-parallel-replicas
-
 SET max_bytes_before_external_group_by = 200000000;
 
 SET max_memory_usage = 1500000000;
diff --git a/tests/queries/1_stateful/00092_obfuscator.sh b/tests/queries/1_stateful/00092_obfuscator.sh
index f19473f01ac..f9e0098a46c 100755
--- a/tests/queries/1_stateful/00092_obfuscator.sh
+++ b/tests/queries/1_stateful/00092_obfuscator.sh
@@ -1,6 +1,5 @@
 #!/usr/bin/env bash
-# Tags: no-parallel-replicas
-# clickhouse-local may not work with parallel replicas
+
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
diff --git a/tests/queries/1_stateful/00096_obfuscator_save_load.sh b/tests/queries/1_stateful/00096_obfuscator_save_load.sh
index 1bb212e1bba..a88dfcdb9b9 100755
--- a/tests/queries/1_stateful/00096_obfuscator_save_load.sh
+++ b/tests/queries/1_stateful/00096_obfuscator_save_load.sh
@@ -1,6 +1,4 @@
 #!/usr/bin/env bash
-# Tags: no-parallel-replicas
-# clickhouse-local may not work with parallel replicas
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
diff --git a/tests/queries/1_stateful/00146_aggregate_function_uniq.sql b/tests/queries/1_stateful/00146_aggregate_function_uniq.sql
index 2cab6e70d22..fd3fde7636d 100644
--- a/tests/queries/1_stateful/00146_aggregate_function_uniq.sql
+++ b/tests/queries/1_stateful/00146_aggregate_function_uniq.sql
@@ -1,5 +1,3 @@
--- Tags: no-parallel-replicas
-
 SELECT RegionID, uniqHLL12(WatchID) AS X FROM remote('127.0.0.{1,2}', test, hits) GROUP BY RegionID HAVING X > 100000 ORDER BY RegionID ASC;
 SELECT RegionID, uniqCombined(WatchID) AS X FROM remote('127.0.0.{1,2}', test, hits) GROUP BY RegionID HAVING X > 100000 ORDER BY RegionID ASC;
 SELECT abs(uniq(WatchID) - uniqExact(WatchID)) FROM test.hits;
diff --git a/tests/queries/1_stateful/00149_quantiles_timing_distributed.sql b/tests/queries/1_stateful/00149_quantiles_timing_distributed.sql
index 5d2476226ba..6f910646fb7 100644
--- a/tests/queries/1_stateful/00149_quantiles_timing_distributed.sql
+++ b/tests/queries/1_stateful/00149_quantiles_timing_distributed.sql
@@ -1,4 +1,4 @@
--- Tags: distributed, no-parallel-replicas
+-- Tags: distributed
 
 SELECT sum(cityHash64(*)) FROM (SELECT CounterID, quantileTiming(0.5)(SendTiming), count() FROM remote('127.0.0.{1,2,3,4,5,6,7,8,9,10}', test.hits) WHERE SendTiming != -1 GROUP BY CounterID);
 SELECT sum(cityHash64(*)) FROM (SELECT CounterID, quantileTiming(0.5)(SendTiming), count() FROM remote('127.0.0.{1,2,3,4,5,6,7,8,9,10}', test.hits) WHERE SendTiming != -1 GROUP BY CounterID) SETTINGS optimize_aggregation_in_order = 1;
diff --git a/tests/queries/1_stateful/00152_insert_different_granularity.sql b/tests/queries/1_stateful/00152_insert_different_granularity.sql
index 35483149498..294d71b384b 100644
--- a/tests/queries/1_stateful/00152_insert_different_granularity.sql
+++ b/tests/queries/1_stateful/00152_insert_different_granularity.sql
@@ -1,4 +1,4 @@
--- Tags: no-tsan, no-replicated-database, no-parallel, no-parallel-replicas
+-- Tags: no-tsan, no-replicated-database, no-parallel
 -- Tag no-replicated-database: Fails due to additional replicas or shards
 
 DROP TABLE IF EXISTS fixed_granularity_table;
diff --git a/tests/queries/1_stateful/00156_max_execution_speed_sample_merge.sql b/tests/queries/1_stateful/00156_max_execution_speed_sample_merge.sql
index 32079111f6c..e325c18200b 100644
--- a/tests/queries/1_stateful/00156_max_execution_speed_sample_merge.sql
+++ b/tests/queries/1_stateful/00156_max_execution_speed_sample_merge.sql
@@ -1,6 +1,3 @@
--- Tags: no-parallel-replicas
--- Merge tables doesn't work with parallel replicas currently
-
 SET max_execution_speed = 4000000, timeout_before_checking_execution_speed = 0;
 
 CREATE TEMPORARY TABLE times (t DateTime);
diff --git a/tests/queries/1_stateful/00166_explain_estimate.sql b/tests/queries/1_stateful/00166_explain_estimate.sql
index abac92ecb2e..c4071271736 100644
--- a/tests/queries/1_stateful/00166_explain_estimate.sql
+++ b/tests/queries/1_stateful/00166_explain_estimate.sql
@@ -1,4 +1,4 @@
--- Tags: no-replicated-database, no-parallel-replicas
+-- Tags: no-replicated-database
 -- Tag no-replicated-database: Requires investigation
 
 EXPLAIN ESTIMATE SELECT count() FROM test.hits WHERE CounterID = 29103473;
diff --git a/tests/queries/1_stateful/00170_s3_cache.sql b/tests/queries/1_stateful/00170_s3_cache.sql
index 43e85af0bc3..23663a1844d 100644
--- a/tests/queries/1_stateful/00170_s3_cache.sql
+++ b/tests/queries/1_stateful/00170_s3_cache.sql
@@ -1,4 +1,4 @@
--- Tags: no-parallel, no-random-settings, no-parallel-replicas
+-- Tags: no-parallel, no-random-settings
 
 -- { echo }
 
diff --git a/tests/queries/1_stateful/00171_grouping_aggregated_transform_bug.sql b/tests/queries/1_stateful/00171_grouping_aggregated_transform_bug.sql
index 07788af927e..7068780a1b1 100644
--- a/tests/queries/1_stateful/00171_grouping_aggregated_transform_bug.sql
+++ b/tests/queries/1_stateful/00171_grouping_aggregated_transform_bug.sql
@@ -1,4 +1,4 @@
--- Tags: distributed, no-parallel-replicas
+-- Tags: distributed
 
 SELECT sum(cityHash64(*)) FROM (SELECT CounterID, quantileTiming(0.5)(SendTiming), count() FROM remote('127.0.0.{1,2,3,4,5,6,7,8,9,10}', test.hits) WHERE SendTiming != -1 GROUP BY CounterID) SETTINGS max_block_size = 63169;
 SELECT sum(cityHash64(*)) FROM (SELECT CounterID, quantileTiming(0.5)(SendTiming), count() FROM remote('127.0.0.{1,2,3,4,5,6,7,8,9,10}', test.hits) WHERE SendTiming != -1 GROUP BY CounterID) SETTINGS optimize_aggregation_in_order = 1, max_block_size = 63169;

From 2e1f56ae336e198d8f388ce815292ec049a7fdc5 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 13 Jun 2023 14:43:50 +0000
Subject: [PATCH 394/722] Address comments

---
 docs/en/engines/table-engines/special/file.md |   2 +-
 docs/en/operations/settings/settings.md       |   6 +-
 docs/en/sql-reference/table-functions/file.md |   2 +-
 src/Storages/HDFS/StorageHDFS.cpp             |  90 ++++++++--------
 src/Storages/StorageFile.cpp                  |  29 ++---
 src/Storages/StorageS3.cpp                    |  92 +++++++++-------
 src/Storages/StorageURL.cpp                   | 101 ++++++++++--------
 src/Storages/StorageURL.h                     |   2 +-
 8 files changed, 177 insertions(+), 147 deletions(-)

diff --git a/docs/en/engines/table-engines/special/file.md b/docs/en/engines/table-engines/special/file.md
index cf325961b6a..27945b30c03 100644
--- a/docs/en/engines/table-engines/special/file.md
+++ b/docs/en/engines/table-engines/special/file.md
@@ -99,4 +99,4 @@ For partitioning by month, use the `toYYYYMM(date_column)` expression, where `da
 - [engine_file_truncate_on_insert](/docs/en/operations/settings/settings.md#engine-file-truncate-on-insert) - allows to truncate file before insert into it. Disabled by default.
 - [engine_file_allow_create_multiple_files](/docs/en/operations/settings/settings.md#engine_file_allow_create_multiple_files) - allows to create a new file on each insert if format has suffix. Disabled by default.
 - [engine_file_skip_empty_files](/docs/en/operations/settings/settings.md#engine_file_skip_empty_files) - allows to skip empty files while reading. Disabled by default.
-- [storage_file_read_method](/docs/en/operations/settings/settings.md#engine-file-emptyif-not-exists) - method of reading data from storage file, one of: read, pread, mmap (only for clickhouse-local). Default value: `pread` for clickhouse-server, `mmap` for clickhouse-local.
+- [storage_file_read_method](/docs/en/operations/settings/settings.md#engine-file-emptyif-not-exists) - method of reading data from storage file, one of: `read`, `pread`, `mmap`. The mmap method does not apply to clickhouse-server (it's intended for clickhouse-local). Default value: `pread` for clickhouse-server, `mmap` for clickhouse-local.
diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index a138f8f5515..7a28e33bf90 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3332,7 +3332,7 @@ Enables or disables creating a new file on each insert in file engine tables if
 
 Possible values:
 - 0 — `INSERT` query appends new data to the end of the file.
-- 1 — `INSERT` query replaces existing content of the file with the new data.
+- 1 — `INSERT` query creates a new file.
 
 Default value: `0`.
 
@@ -3370,7 +3370,7 @@ initial: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`, etc.
 
 Possible values:
 - 0 — `INSERT` query appends new data to the end of the file.
-- 1 — `INSERT` query replaces existing content of the file with the new data.
+- 1 — `INSERT` query creates a new file.
 
 Default value: `0`.
 
@@ -3402,7 +3402,7 @@ initial: `data.Parquet.gz` -> `data.1.Parquet.gz` -> `data.2.Parquet.gz`, etc.
 
 Possible values:
 - 0 — `INSERT` query appends new data to the end of the file.
-- 1 — `INSERT` query replaces existing content of the file with the new data.
+- 1 — `INSERT` query creates a new file.
 
 Default value: `0`.
 
diff --git a/docs/en/sql-reference/table-functions/file.md b/docs/en/sql-reference/table-functions/file.md
index 749aafb6d00..f25da96fddb 100644
--- a/docs/en/sql-reference/table-functions/file.md
+++ b/docs/en/sql-reference/table-functions/file.md
@@ -18,7 +18,7 @@ file(path [,format] [,structure] [,compression])
 
 **Parameters**
 
-- `path` — The relative path to the file from [user_files_path](/docs/en/operations/server-configuration-parameters/settings.md/#server_configuration_parameters-user_files_path). Path to file support following globs in read-only mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc', 'def'` — strings.
+- `path` — The relative path to the file from [user_files_path](/docs/en/operations/server-configuration-parameters/settings.md#server_configuration_parameters-user_files_path). Path to file support following globs in read-only mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc', 'def'` — strings.
 - `format` — The [format](/docs/en/interfaces/formats.md#formats) of the file.
 - `structure` — Structure of the table. Format: `'column1_name column1_type, column2_name column2_type, ...'`.
 - `compression` — The existing compression type when used in a `SELECT` query, or the desired compression type when used in an `INSERT` query.  The supported compression types are `gz`, `br`, `xz`, `zst`, `lz4`, and `bz2`.
diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 9ea1d805db5..dd3e8fecfaa 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -140,14 +140,6 @@ namespace
 
         return LSWithRegexpMatching("/", fs, path_from_uri);
     }
-
-    size_t getFileSize(const String & path_from_uri, const String & uri_without_path, ContextPtr context)
-    {
-        HDFSBuilderWrapper builder = createHDFSBuilder(uri_without_path + "/", context->getGlobalContext()->getConfigRef());
-        HDFSFSPtr fs = createHDFSFS(builder.get());
-        auto * info = hdfsGetPathInfo(fs.get(), path_from_uri.data());
-        return info->mSize;
-    }
 }
 
 StorageHDFS::StorageHDFS(
@@ -218,26 +210,36 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
 
     ReadBufferIterator read_buffer_iterator
         = [&, my_uri_without_path = uri_without_path, it = paths_with_info.begin(), first = true](
-              ColumnsDescription & columns) mutable -> std::unique_ptr<ReadBuffer>
+              ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
     {
-        if (it == paths_with_info.end())
+        PathWithInfo path_with_info;
+        std::unique_ptr<ReadBuffer> buf;
+        while (true)
         {
-            if (first)
-                throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
-                                "Cannot extract table structure from {} format file, because all files are empty. "
-                                "You must specify table structure manually", format);
-            return nullptr;
+            if (it == paths_with_info.end())
+            {
+                if (first)
+                    throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                                    "Cannot extract table structure from {} format file, because all files are empty. "
+                                    "You must specify table structure manually", format);
+                return nullptr;
+            }
+
+            path_with_info = *it++;
+            if (ctx->getSettingsRef().hdfs_skip_empty_files && path_with_info.info && path_with_info.info->size == 0)
+                continue;
+
+            auto compression = chooseCompressionMethod(path_with_info.path, compression_method);
+            auto impl = std::make_unique<ReadBufferFromHDFS>(my_uri_without_path, path_with_info.path, ctx->getGlobalContext()->getConfigRef(), ctx->getReadSettings());
+            const Int64 zstd_window_log_max = ctx->getSettingsRef().zstd_window_log_max;
+            buf = wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
+
+            if (!ctx->getSettingsRef().hdfs_skip_empty_files || !buf->eof())
+            {
+                first = false;
+                return buf;
+            }
         }
-
-        auto path_with_info = *it++;
-        if (ctx->getSettingsRef().hdfs_skip_empty_files && path_with_info.info && path_with_info.info->size == 0)
-            return read_buffer_iterator(columns);
-
-        first = false;
-        auto compression = chooseCompressionMethod(path_with_info.path, compression_method);
-        auto impl = std::make_unique<ReadBufferFromHDFS>(my_uri_without_path, path_with_info.path, ctx->getGlobalContext()->getConfigRef(), ctx->getReadSettings());
-        const Int64 zstd_window_log_max = ctx->getSettingsRef().zstd_window_log_max;
-        return wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
     };
 
     ColumnsDescription columns;
@@ -362,26 +364,28 @@ HDFSSource::HDFSSource(
 
 bool HDFSSource::initialize()
 {
-    auto path_with_info = (*file_iterator)();
-    if (path_with_info.path.empty())
-        return false;
-
-    current_path = path_with_info.path;
-    const auto [path_from_uri, uri_without_path] = getPathFromUriAndUriWithoutPath(current_path);
-
-    if (getContext()->getSettingsRef().hdfs_skip_empty_files)
+    StorageHDFS::PathWithInfo path_with_info;
+    bool skip_empty_files = getContext()->getSettingsRef().hdfs_skip_empty_files;
+    while (true)
     {
-        auto file_size = path_with_info.info ? path_with_info.info->size : getFileSize(path_from_uri, uri_without_path, getContext());
-        /// If file is empty and hdfs_skip_empty_files=1, skip it and go to the next file.
-        if (file_size == 0)
-            return initialize();
-    }
+        path_with_info = (*file_iterator)();
+        if (path_with_info.path.empty())
+            return false;
 
-    auto compression = chooseCompressionMethod(path_from_uri, storage->compression_method);
-    auto impl = std::make_unique<ReadBufferFromHDFS>(
-        uri_without_path, path_from_uri, getContext()->getGlobalContext()->getConfigRef(), getContext()->getReadSettings());
-    const Int64 zstd_window_log_max = getContext()->getSettingsRef().zstd_window_log_max;
-    read_buf = wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
+        if (path_with_info.info && skip_empty_files && path_with_info.info->size == 0)
+            continue;
+
+        current_path = path_with_info.path;
+        const auto [path_from_uri, uri_without_path] = getPathFromUriAndUriWithoutPath(current_path);
+
+        auto compression = chooseCompressionMethod(path_from_uri, storage->compression_method);
+        auto impl = std::make_unique<ReadBufferFromHDFS>(
+            uri_without_path, path_from_uri, getContext()->getGlobalContext()->getConfigRef(), getContext()->getReadSettings());
+        const Int64 zstd_window_log_max = getContext()->getSettingsRef().zstd_window_log_max;
+        read_buf = wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
+        if (!skip_empty_files || !read_buf->eof())
+            break;
+    }
 
     auto input_format = getContext()->getInputFormat(storage->format_name, *read_buf, block_for_format, max_block_size);
 
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 7fc143a6122..06f9d071706 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -404,21 +404,26 @@ ColumnsDescription StorageFile::getTableStructureFromFile(
     if (context->getSettingsRef().schema_inference_use_cache_for_file)
         columns_from_cache = tryGetColumnsFromCache(paths, format, format_settings, context);
 
-    ReadBufferIterator read_buffer_iterator = [&, it = paths.begin(), first = true](ColumnsDescription & columns) mutable -> std::unique_ptr<ReadBuffer>
+    ReadBufferIterator read_buffer_iterator = [&, it = paths.begin(), first = true](ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
     {
-        if (it == paths.end())
+        String path;
+        struct stat file_stat;
+        do
         {
-            if (first)
-                throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
-                                "Cannot extract table structure from {} format file, because all files are empty. You must specify table structure manually",
-                                format);
-            return nullptr;
-        }
+            if (it == paths.end())
+            {
+                if (first)
+                    throw Exception(
+                        ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                        "Cannot extract table structure from {} format file, because all files are empty. You must specify table structure manually",
+                        format);
+                return nullptr;
+            }
 
-        auto path = *it++;
-        auto file_stat = getFileStat(path, false, -1, "File");
-        if (context->getSettingsRef().engine_file_skip_empty_files && file_stat.st_size == 0)
-            return read_buffer_iterator(columns);
+            path = *it++;
+            file_stat = getFileStat(path, false, -1, "File");
+        }
+        while (context->getSettingsRef().engine_file_skip_empty_files && file_stat.st_size == 0);
 
         first = false;
         return createReadBuffer(path, file_stat, false, -1, compression_method, context);
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index c30973d99e1..5c5895744ac 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -575,19 +575,21 @@ StorageS3Source::StorageS3Source(
 
 StorageS3Source::ReaderHolder StorageS3Source::createReader()
 {
-    auto [current_key, info] = (*file_iterator)();
-    if (current_key.empty())
-        return {};
+    KeyWithInfo key_with_info;
+    size_t object_size;
+    do
+    {
+        key_with_info = (*file_iterator)();
+        if (key_with_info.key.empty())
+            return {};
 
-    size_t object_size = info ? info->size : S3::getObjectSize(*client, bucket, current_key, version_id, request_settings);
+        object_size = key_with_info.info ? key_with_info.info->size : S3::getObjectSize(*client, bucket, key_with_info.key, version_id, request_settings);
+    }
+    while (getContext()->getSettingsRef().s3_skip_empty_files && object_size == 0);
 
-    /// If object is empty and s3_skip_empty_files=1, skip it and go to the next key.
-    if (getContext()->getSettingsRef().s3_skip_empty_files && object_size == 0)
-        return createReader();
+    auto compression_method = chooseCompressionMethod(key_with_info.key, compression_hint);
 
-    auto compression_method = chooseCompressionMethod(current_key, compression_hint);
-
-    auto read_buf = createS3ReadBuffer(current_key, object_size);
+    auto read_buf = createS3ReadBuffer(key_with_info.key, object_size);
     auto input_format = FormatFactory::instance().getInput(
             format, *read_buf, sample_block, getContext(), max_block_size,
             format_settings, std::nullopt, std::nullopt,
@@ -606,7 +608,7 @@ StorageS3Source::ReaderHolder StorageS3Source::createReader()
     auto pipeline = std::make_unique<QueryPipeline>(QueryPipelineBuilder::getPipeline(std::move(builder)));
     auto current_reader = std::make_unique<PullingPipelineExecutor>(*pipeline);
 
-    return ReaderHolder{fs::path(bucket) / current_key, std::move(read_buf), std::move(pipeline), std::move(current_reader)};
+    return ReaderHolder{fs::path(bucket) / key_with_info.key, std::move(read_buf), std::move(pipeline), std::move(current_reader)};
 }
 
 std::future<StorageS3Source::ReaderHolder> StorageS3Source::createReaderAsync()
@@ -1451,41 +1453,53 @@ ColumnsDescription StorageS3::getTableStructureFromDataImpl(
 
     ReadBufferIterator read_buffer_iterator = [&, first = true](ColumnsDescription & cached_columns) mutable -> std::unique_ptr<ReadBuffer>
     {
-        auto [key, info] = (*file_iterator)();
+        StorageS3Source::KeyWithInfo key_with_info;
+        std::unique_ptr<ReadBuffer> buf;
 
-        if (key.empty())
+        while (true)
         {
-            if (first)
-                throw Exception(
-                    ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
-                    "Cannot extract table structure from {} format file, because there are no files with provided path "
-                    "in S3 or all files are empty. You must specify table structure manually", configuration.format);
+            key_with_info = (*file_iterator)();
 
-            return nullptr;
-        }
-
-        if (ctx->getSettingsRef().s3_skip_empty_files && info->size == 0)
-            return read_buffer_iterator(cached_columns);
-
-        /// S3 file iterator could get new keys after new iteration, check them in schema cache.
-        if (ctx->getSettingsRef().schema_inference_use_cache_for_s3 && read_keys.size() > prev_read_keys_size)
-        {
-            columns_from_cache = tryGetColumnsFromCache(read_keys.begin() + prev_read_keys_size, read_keys.end(), configuration, format_settings, ctx);
-            prev_read_keys_size = read_keys.size();
-            if (columns_from_cache)
+            if (key_with_info.key.empty())
             {
-                cached_columns = *columns_from_cache;
+                if (first)
+                    throw Exception(
+                        ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                        "Cannot extract table structure from {} format file, because there are no files with provided path "
+                        "in S3 or all files are empty. You must specify table structure manually",
+                        configuration.format);
+
                 return nullptr;
             }
-        }
 
-        first = false;
-        int zstd_window_log_max = static_cast<int>(ctx->getSettingsRef().zstd_window_log_max);
-        return wrapReadBufferWithCompressionMethod(
-            std::make_unique<ReadBufferFromS3>(
-                configuration.client, configuration.url.bucket, key, configuration.url.version_id, configuration.request_settings, ctx->getReadSettings()),
-            chooseCompressionMethod(key, configuration.compression_method),
-            zstd_window_log_max);
+            /// S3 file iterator could get new keys after new iteration, check them in schema cache.
+            if (ctx->getSettingsRef().schema_inference_use_cache_for_s3 && read_keys.size() > prev_read_keys_size)
+            {
+                columns_from_cache = tryGetColumnsFromCache(read_keys.begin() + prev_read_keys_size, read_keys.end(), configuration, format_settings, ctx);
+                prev_read_keys_size = read_keys.size();
+                if (columns_from_cache)
+                {
+                    cached_columns = *columns_from_cache;
+                    return nullptr;
+                }
+            }
+
+            if (ctx->getSettingsRef().s3_skip_empty_files && key_with_info.info && key_with_info.info->size == 0)
+                continue;
+
+            int zstd_window_log_max = static_cast<int>(ctx->getSettingsRef().zstd_window_log_max);
+            buf = wrapReadBufferWithCompressionMethod(
+                std::make_unique<ReadBufferFromS3>(
+                    configuration.client, configuration.url.bucket, key_with_info.key, configuration.url.version_id, configuration.request_settings, ctx->getReadSettings()),
+                chooseCompressionMethod(key_with_info.key, configuration.compression_method),
+                zstd_window_log_max);
+
+            if (!ctx->getSettingsRef().s3_skip_empty_files || !buf->eof())
+            {
+                first = false;
+                return buf;
+            }
+        }
     };
 
     ColumnsDescription columns;
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index fc5525b42d2..4e75a4d54cb 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -241,30 +241,34 @@ StorageURLSource::StorageURLSource(
     /// Lazy initialization. We should not perform requests in constructor, because we need to do it in query pipeline.
     initialize = [=, this]()
     {
-        const auto current_uri_options = (*uri_iterator)();
-        if (current_uri_options.empty())
-            return false;
+        std::vector<String> current_uri_options;
+        std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> uri_and_buf;
+        do
+        {
+            current_uri_options = (*uri_iterator)();
+            if (current_uri_options.empty())
+                return false;
 
-        auto first_option = uri_options.begin();
-        auto [actual_uri, buf] = getFirstAvailableURIAndReadBuffer(
-            first_option,
-            current_uri_options.end(),
-            context,
-            params,
-            http_method,
-            callback,
-            timeouts,
-            credentials,
-            headers,
-            glob_url,
-            current_uri_options.size() == 1);
+            auto first_option = current_uri_options.cbegin();
+            uri_and_buf = getFirstAvailableURIAndReadBuffer(
+                first_option,
+                current_uri_options.end(),
+                context,
+                params,
+                http_method,
+                callback,
+                timeouts,
+                credentials,
+                headers,
+                glob_url,
+                current_uri_options.size() == 1);
 
-        /// If file is empty and engine_url_skip_empty_files=1, skip it and go to the next file.
-        if (context->getSettingsRef().engine_url_skip_empty_files && getFileSizeFromReadBuffer(*buf) == 0)
-            return initialize();
+            /// If file is empty and engine_url_skip_empty_files=1, skip it and go to the next file.
+        }
+        while (context->getSettingsRef().engine_url_skip_empty_files && uri_and_buf.second->eof());
 
-        curr_uri = actual_uri;
-        read_buf = std::move(buf);
+        curr_uri = uri_and_buf.first;
+        read_buf = std::move(uri_and_buf.second);
 
         try
         {
@@ -347,7 +351,7 @@ Chunk StorageURLSource::generate()
     return {};
 }
 
-std::tuple<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> StorageURLSource::getFirstAvailableURIAndReadBuffer(
+std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> StorageURLSource::getFirstAvailableURIAndReadBuffer(
     std::vector<String>::const_iterator & option,
     const std::vector<String>::const_iterator & end,
     ContextPtr context,
@@ -590,38 +594,41 @@ ColumnsDescription IStorageURLBase::getTableStructureFromData(
     if (context->getSettingsRef().schema_inference_use_cache_for_url)
         columns_from_cache = tryGetColumnsFromCache(urls_to_check, headers, credentials, format, format_settings, context);
 
-    ReadBufferIterator read_buffer_iterator = [&, it = urls_to_check.cbegin(), first = true](ColumnsDescription & columns) mutable -> std::unique_ptr<ReadBuffer>
+    ReadBufferIterator read_buffer_iterator = [&, it = urls_to_check.cbegin(), first = true](ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
     {
-        if (it == urls_to_check.cend())
+        std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> uri_and_buf;
+        do
         {
-            if (first)
-                throw Exception(ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
-                            "Cannot extract table structure from {} format file, because all files are empty. "
-                            "You must specify table structure manually", format);
-            return nullptr;
-        }
+            if (it == urls_to_check.cend())
+            {
+                if (first)
+                    throw Exception(
+                        ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE,
+                        "Cannot extract table structure from {} format file, because all files are empty. "
+                        "You must specify table structure manually",
+                        format);
+                return nullptr;
+            }
 
-        auto [_, buf] = StorageURLSource::getFirstAvailableURIAndReadBuffer(
-            it,
-            urls_to_check.cend(),
-            context,
-            {},
-            Poco::Net::HTTPRequest::HTTP_GET,
-            {},
-            getHTTPTimeouts(context),
-            credentials,
-            headers,
-            false,
-            false);
+            uri_and_buf = StorageURLSource::getFirstAvailableURIAndReadBuffer(
+                it,
+                urls_to_check.cend(),
+                context,
+                {},
+                Poco::Net::HTTPRequest::HTTP_GET,
+                {},
+                getHTTPTimeouts(context),
+                credentials,
+                headers,
+                false,
+                false);
 
-        ++it;
-
-        if (context->getSettingsRef().engine_url_skip_empty_files && buf_factory->getFileSize() == 0)
-            return read_buffer_iterator(columns);
+            ++it;
+        } while (context->getSettingsRef().engine_url_skip_empty_files && uri_and_buf.second->eof());
 
         first = false;
         return wrapReadBufferWithCompressionMethod(
-            std::move(buf),
+            std::move(uri_and_buf.second),
             compression_method,
             static_cast<int>(context->getSettingsRef().zstd_window_log_max));
     };
diff --git a/src/Storages/StorageURL.h b/src/Storages/StorageURL.h
index 50928ed6962..a5c1174377b 100644
--- a/src/Storages/StorageURL.h
+++ b/src/Storages/StorageURL.h
@@ -183,7 +183,7 @@ public:
 
     static Block getHeader(Block sample_block, const std::vector<NameAndTypePair> & requested_virtual_columns);
 
-    static std::tuple<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> getFirstAvailableURIAndReadBuffer(
+    static std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> getFirstAvailableURIAndReadBuffer(
         std::vector<String>::const_iterator & option,
         const std::vector<String>::const_iterator & end,
         ContextPtr context,

From 46fbe7fb26d06abdb8f5e21f00d5dd215a084b9b Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 13 Jun 2023 15:01:51 +0000
Subject: [PATCH 395/722] 01746_convert_type_with_default: Temporarily disable
 flaky test

---
 .../0_stateless/01746_convert_type_with_default.reference     | 1 -
 tests/queries/0_stateless/01746_convert_type_with_default.sql | 4 ++--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index e5aa42e6116..0edea4de31e 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -40,7 +40,6 @@
 1970-01-20
 1970-01-20
 2149-06-06
-1970-01-02
 2023-05-30
 2023-05-30
 2023-05-30 14:38:20
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index e6e420ae4c0..c74b185f7fd 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -54,7 +54,7 @@ select toDateOrDefault(cast(19 as Int256));
 select toDateOrDefault(cast(19 as UInt256));
 
 select toDateOrDefault(65535);
-select toDateOrDefault(122400);
+-- select toDateOrDefault(122400);
 
 select toDateOrDefault(19507, '2000-01-01'::Date);
 select toDateOrDefault(-1, '2023-05-30'::Date);
@@ -80,4 +80,4 @@ select toDateTimeOrDefault(cast(19 as Int128), 'UTC');
 select toDateTimeOrDefault(cast(19 as UInt128), 'UTC');
 
 select toDateTimeOrDefault(cast(19 as Int256), 'UTC');
-select toDateTimeOrDefault(cast(19 as UInt256), 'UTC');
\ No newline at end of file
+select toDateTimeOrDefault(cast(19 as UInt256), 'UTC');

From 57cdd3a25d25ca8274e3b68cf75cbaa9bf94daa7 Mon Sep 17 00:00:00 2001
From: rfraposa <richraposa@gmail.com>
Date: Tue, 13 Jun 2023 09:13:13 -0600
Subject: [PATCH 396/722] Update annindexes.md

---
 .../table-engines/mergetree-family/annindexes.md     | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 16e244077a7..fe971571419 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -54,7 +54,7 @@ CREATE TABLE table
 (
   `id` Int64,
   `vectors` Array(Float32),
-  INDEX <ann_index_name> vectors TYPE <ann_index_type>(<ann_index_parameters>) [GRANULARITY <N>]
+  INDEX [ann_index_name vectors TYPE [ann_index_type]([ann_index_parameters]) [GRANULARITY [N]]
 )
 ENGINE = MergeTree
 ORDER BY id;
@@ -67,7 +67,7 @@ CREATE TABLE table
 (
   `id` Int64,
   `vectors` Tuple(Float32[, Float32[, ...]]),
-  INDEX <ann_index_name> vectors TYPE <ann_index_type>(<ann_index_parameters>) [GRANULARITY <N>]
+  INDEX [ann_index_name] vectors TYPE [ann_index_type]([ann_index_parameters]) [GRANULARITY [N]]
 )
 ENGINE = MergeTree
 ORDER BY id;
@@ -114,7 +114,7 @@ without `LIMIT` clause cannot utilize ANN indexes. Also ANN indexes are only use
 approximate neighbor search.
 
 **Differences to Skip Indexes** Similar to regular [skip indexes](https://clickhouse.com/docs/en/optimize/skipping-indexes), ANN indexes are
-constructed over granules and each indexed block consists of `GRANULARITY = <N>`-many granules (`<N>` = 1 by default for normal skip
+constructed over granules and each indexed block consists of `GRANULARITY = [N]`-many granules (`[N]` = 1 by default for normal skip
 indexes). For example, if the primary index granularity of the table is 8192 (setting `index_granularity = 8192`) and `GRANULARITY = 2`,
 then each indexed block will contain 16384 rows. However, data structures and algorithms for approximate neighborhood search (usually
 provided by external libraries) are inherently row-oriented. They store a compact representation of a set of rows and also return rows for
@@ -130,7 +130,7 @@ skip data at the granularity of index blocks.
 The `GRANULARITY` parameter determines how many ANN sub-indexes are created. Bigger `GRANULARITY` values mean fewer but larger ANN
 sub-indexes, up to the point where a column (or a column's data part) has only a single sub-index. In that case, the sub-index has a
 "global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most `LIMIT
-<N>`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
+[N]`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
 brute-force distance calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to
 `LIMIT N`-many granules. As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases
 equally good, only the processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall
@@ -169,7 +169,7 @@ CREATE TABLE table
 (
   id Int64,
   vectors Array(Float32),
-  INDEX <ann_index_name> vectors TYPE annoy([Distance[, NumTrees]]) [GRANULARITY N]
+  INDEX [ann_index_name] vectors TYPE annoy([Distance[, NumTrees]]) [GRANULARITY N]
 )
 ENGINE = MergeTree
 ORDER BY id;
@@ -182,7 +182,7 @@ CREATE TABLE table
 (
   id Int64,
   vectors Tuple(Float32[, Float32[, ...]]),
-  INDEX <ann_index_name> vectors TYPE annoy([Distance[, NumTrees]]) [GRANULARITY N]
+  INDEX [ann_index_name] vectors TYPE annoy([Distance[, NumTrees]]) [GRANULARITY N]
 )
 ENGINE = MergeTree
 ORDER BY id;

From 20ea87e527eb76bb296a46f0deab59abdd4a4325 Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Tue, 13 Jun 2023 11:17:33 -0400
Subject: [PATCH 397/722] Update annindexes.md

Don't break code snippets across lines.
---
 docs/en/engines/table-engines/mergetree-family/annindexes.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 16e244077a7..20e49f1c34c 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -129,8 +129,8 @@ skip data at the granularity of index blocks.
 
 The `GRANULARITY` parameter determines how many ANN sub-indexes are created. Bigger `GRANULARITY` values mean fewer but larger ANN
 sub-indexes, up to the point where a column (or a column's data part) has only a single sub-index. In that case, the sub-index has a
-"global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most `LIMIT
-<N>`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
+"global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most 
+`LIMIT <N>`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
 brute-force distance calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to
 `LIMIT N`-many granules. As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases
 equally good, only the processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall

From b850f1b9995d981d7ec047df8261fec302d3020a Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Tue, 13 Jun 2023 11:26:12 -0400
Subject: [PATCH 398/722] fix broken line

---
 docs/en/engines/table-engines/mergetree-family/annindexes.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index fe971571419..71e7e008bf2 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -129,8 +129,7 @@ skip data at the granularity of index blocks.
 
 The `GRANULARITY` parameter determines how many ANN sub-indexes are created. Bigger `GRANULARITY` values mean fewer but larger ANN
 sub-indexes, up to the point where a column (or a column's data part) has only a single sub-index. In that case, the sub-index has a
-"global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most `LIMIT
-[N]`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
+"global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most `LIMIT [N]`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
 brute-force distance calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to
 `LIMIT N`-many granules. As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases
 equally good, only the processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall

From 76f69f2b44ba23dbb0afd50f26dd3fd62352a381 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Tue, 13 Jun 2023 15:52:06 +0000
Subject: [PATCH 399/722] Revert overengineering

---
 src/Functions/FunctionSnowflake.h | 34 ++++++-------------------------
 1 file changed, 6 insertions(+), 28 deletions(-)

diff --git a/src/Functions/FunctionSnowflake.h b/src/Functions/FunctionSnowflake.h
index c7ec6dca27f..b57e21e9a50 100644
--- a/src/Functions/FunctionSnowflake.h
+++ b/src/Functions/FunctionSnowflake.h
@@ -60,20 +60,9 @@ public:
         auto res_column = ColumnInt64::create(input_rows_count);
         auto & res_data = res_column->getData();
 
-        if (const auto * src_column_non_const = typeid_cast<const ColumnDateTime *>(&src_column))
-        {
-            const auto & src_data = src_column_non_const->getData();
-            for (size_t i = 0; i < input_rows_count; ++i)
-                res_data[i] = (UInt32(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
-        }
-        else if (const auto * src_column_const = typeid_cast<const ColumnConst *>(&src_column))
-        {
-            UInt32 src_val = src_column_const->getValue<UInt32>();
-            for (size_t i = 0; i < input_rows_count; ++i)
-                res_data[i] = (src_val * 1000 - snowflake_epoch) << time_shift;
-        }
-        else
-            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal argument for function {}", name);
+        const auto & src_data = typeid_cast<const ColumnUInt32 &>(src_column).getData();
+        for (size_t i = 0; i < input_rows_count; ++i)
+            res_data[i] = (Int64(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
 
         return res_column;
     }
@@ -172,20 +161,9 @@ public:
         auto res_column = ColumnInt64::create(input_rows_count);
         auto & res_data = res_column->getData();
 
-        if (const auto * src_column_non_const = typeid_cast<const ColumnDateTime64 *>(&src_column))
-        {
-            const auto & src_data = src_column_non_const->getData();
-            for (size_t i = 0; i < input_rows_count; ++i)
-                res_data[i] = (UInt32(src_data[i]) * 1000 - snowflake_epoch) << time_shift;
-        }
-        else if (const auto * src_column_const = typeid_cast<const ColumnConst *>(&src_column))
-        {
-            UInt32 src_val = src_column_const->getValue<UInt32>();
-            for (size_t i = 0; i < input_rows_count; ++i)
-                res_data[i] = (src_val * 1000 - snowflake_epoch) << time_shift;
-        }
-        else
-            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT, "Illegal argument for function {}", name);
+        const auto & src_data = typeid_cast<const ColumnDecimal<DateTime64> &>(src_column).getData();
+        for (size_t i = 0; i < input_rows_count; ++i)
+            res_data[i] = (src_data[i] - snowflake_epoch) << time_shift;
 
         return res_column;
     }

From 0bc624dc0291896001d45408e5316d23e28b3cc1 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 13 Jun 2023 17:53:19 +0200
Subject: [PATCH 400/722] Fix the statless tests image for old commits

---
 docker/test/stateless/run.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docker/test/stateless/run.sh b/docker/test/stateless/run.sh
index c0acb0291a4..21cb3168083 100755
--- a/docker/test/stateless/run.sh
+++ b/docker/test/stateless/run.sh
@@ -16,7 +16,7 @@ dpkg -i package_folder/clickhouse-client_*.deb
 ln -s /usr/share/clickhouse-test/clickhouse-test /usr/bin/clickhouse-test
 
 # shellcheck disable=SC1091
-source /usr/share/clickhouse-test/ci/attach_gdb.lib
+source /usr/share/clickhouse-test/ci/attach_gdb.lib || true  # FIXME: to not break old builds, clean on 2023-09-01
 
 # install test configs
 /usr/share/clickhouse-test/config/install.sh
@@ -88,7 +88,7 @@ fi
 
 sleep 5
 
-attach_gdb_to_clickhouse
+attach_gdb_to_clickhouse || true  # FIXME: to not break old builds, clean on 2023-09-01
 
 function run_tests()
 {

From a01056f67c787e069ca173cb63fafbfc5c6e5c96 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 14 Jun 2023 02:33:48 +1000
Subject: [PATCH 401/722] Update orc submodule

---
 contrib/orc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/orc b/contrib/orc
index c5d7755ba0b..f2c191f9653 160000
--- a/contrib/orc
+++ b/contrib/orc
@@ -1 +1 @@
-Subproject commit c5d7755ba0b9a95631c8daea4d094101f26ec761
+Subproject commit f2c191f9653a5ddbca016e024ca0fb61508f5eeb

From 945981e5f69145908aef64819da58725ca8e67e4 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 16:12:33 +0200
Subject: [PATCH 402/722] Fix tests sanity checks

In #43147 the "tests" had been added to EXCLUDE_DIRS, and the reason for
this is that there was some C++ code to ignore [1], however it also
ignores snaity check for query_log.

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/43147/63de577172ee024a08e76db69f5000568673db48/style_check.html

v2: check-style: ignore $EXCLUDE_DIRS for some other sanity checks of tests
Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 utils/check-style/check-style | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/utils/check-style/check-style b/utils/check-style/check-style
index afaf2ee6d48..bd3ee8e02d6 100755
--- a/utils/check-style/check-style
+++ b/utils/check-style/check-style
@@ -13,7 +13,7 @@
 #  and then to run formatter only for the specified files.
 
 ROOT_PATH=$(git rev-parse --show-toplevel)
-EXCLUDE_DIRS='build/|integration/|widechar_width/|glibc-compatibility/|poco/|memcpy/|consistent-hashing|benchmark|tests/|utils/keeper-bench/example.yaml'
+EXCLUDE_DIRS='build/|integration/|widechar_width/|glibc-compatibility/|poco/|memcpy/|consistent-hashing|benchmark|tests/.*.cpp|utils/keeper-bench/example.yaml'
 
 # From [1]:
 #     But since array_to_string_internal() in array.c still loops over array
@@ -163,14 +163,12 @@ find $ROOT_PATH -not -path $ROOT_PATH'/contrib*' \( -name '*.yaml' -or -name '*.
 
 # Tests should not be named with "fail" in their names. It makes looking at the results less convenient.
 find $ROOT_PATH/tests/queries -iname '*fail*' |
-    grep -vP $EXCLUDE_DIRS |
     grep . && echo 'Tests should not be named with "fail" in their names. It makes looking at the results less convenient when you search for "fail" substring in browser.'
 
 # Queries to system.query_log/system.query_thread_log should have current_database = currentDatabase() condition
 # NOTE: it is not that accurate, but at least something.
 tests_with_query_log=( $(
     find $ROOT_PATH/tests/queries -iname '*.sql' -or -iname '*.sh' -or -iname '*.py' -or -iname '*.j2' |
-        grep -vP $EXCLUDE_DIRS |
         xargs grep --with-filename -e system.query_log -e system.query_thread_log | cut -d: -f1 | sort -u
 ) )
 for test_case in "${tests_with_query_log[@]}"; do
@@ -205,7 +203,6 @@ tables_with_database_column=(
 # NOTE: it is not that accuate, but at least something.
 tests_with_database_column=( $(
     find $ROOT_PATH/tests/queries -iname '*.sql' -or -iname '*.sh' -or -iname '*.py' -or -iname '*.j2' |
-        grep -vP $EXCLUDE_DIRS |
         xargs grep --with-filename $(printf -- "-e %s " "${tables_with_database_column[@]}") |
         grep -v -e ':--' -e ':#' |
         cut -d: -f1 | sort -u
@@ -225,7 +222,6 @@ done
 # NOTE: it is not that accuate, but at least something.
 tests_with_replicated_merge_tree=( $(
     find $ROOT_PATH/tests/queries -iname '*.sql' -or -iname '*.sh' -or -iname '*.py' -or -iname '*.j2' |
-        grep -vP $EXCLUDE_DIRS |
         xargs grep --with-filename -e "Replicated.*MergeTree[ ]*(.*" | cut -d: -f1 | sort -u
 ) )
 for test_case in "${tests_with_replicated_merge_tree[@]}"; do

From dc6810601a65cf15a87459cdc72e5258d69949d2 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 16:15:30 +0200
Subject: [PATCH 403/722] Remove DROP TABEL system.query_log from tests

This is a very ugly hack that breaks artifacts, since after this
query_log is incomplete in artifacts.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../02494_query_cache_case_agnostic_matching.sql       |  4 ++--
 .../0_stateless/02494_query_cache_events.reference     |  1 +
 tests/queries/0_stateless/02494_query_cache_events.sql |  9 +++++----
 .../0_stateless/02494_query_cache_normalize_ast.sql    |  4 ++--
 .../02494_query_cache_passive_usage.reference          |  1 +
 .../0_stateless/02494_query_cache_passive_usage.sql    | 10 +++++-----
 6 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/tests/queries/0_stateless/02494_query_cache_case_agnostic_matching.sql b/tests/queries/0_stateless/02494_query_cache_case_agnostic_matching.sql
index 9f26d7759de..7dbd79059af 100644
--- a/tests/queries/0_stateless/02494_query_cache_case_agnostic_matching.sql
+++ b/tests/queries/0_stateless/02494_query_cache_case_agnostic_matching.sql
@@ -1,9 +1,8 @@
 -- Tags: no-parallel
 -- Tag no-parallel: Messes with internal cache
 
--- Start with empty query cache (QC) and query log
+-- Start with empty query cache (QC)
 SYSTEM DROP QUERY CACHE;
-DROP TABLE system.query_log SYNC;
 
 -- Insert an entry into the query cache.
 SELECT 1 SETTINGS use_query_cache = true;
@@ -22,6 +21,7 @@ SYSTEM FLUSH LOGS;
 SELECT ProfileEvents['QueryCacheHits'], ProfileEvents['QueryCacheMisses']
 FROM system.query_log
 WHERE type = 'QueryFinish'
+  AND current_database = currentDatabase()
   AND query = 'select 1 SETTINGS use_query_cache = true;';
 
 SYSTEM DROP QUERY CACHE;
diff --git a/tests/queries/0_stateless/02494_query_cache_events.reference b/tests/queries/0_stateless/02494_query_cache_events.reference
index db60d3699e0..9bcd2820f27 100644
--- a/tests/queries/0_stateless/02494_query_cache_events.reference
+++ b/tests/queries/0_stateless/02494_query_cache_events.reference
@@ -3,4 +3,5 @@
 0	1
 ---
 1
+0	1
 1	0
diff --git a/tests/queries/0_stateless/02494_query_cache_events.sql b/tests/queries/0_stateless/02494_query_cache_events.sql
index 900b68f5eb2..05c0acad4b8 100644
--- a/tests/queries/0_stateless/02494_query_cache_events.sql
+++ b/tests/queries/0_stateless/02494_query_cache_events.sql
@@ -1,9 +1,8 @@
 -- Tags: no-parallel
 -- Tag no-parallel: Messes with internal cache
 
--- Start with empty query cache QC and query log
+-- Start with empty query cache QC
 SYSTEM DROP QUERY CACHE;
-DROP TABLE system.query_log SYNC;
 
 -- Run a query with QC on. The first execution is a QC miss.
 SELECT '---';
@@ -13,6 +12,7 @@ SYSTEM FLUSH LOGS;
 SELECT ProfileEvents['QueryCacheHits'], ProfileEvents['QueryCacheMisses']
 FROM system.query_log
 WHERE type = 'QueryFinish'
+  AND current_database = currentDatabase()
   AND query = 'SELECT 1 SETTINGS use_query_cache = true;';
 
 
@@ -20,11 +20,12 @@ WHERE type = 'QueryFinish'
 SELECT '---';
 SELECT 1 SETTINGS use_query_cache = true;
 
-DROP TABLE system.query_log SYNC;
 SYSTEM FLUSH LOGS;
 SELECT ProfileEvents['QueryCacheHits'], ProfileEvents['QueryCacheMisses']
 FROM system.query_log
 WHERE type = 'QueryFinish'
-  AND query = 'SELECT 1 SETTINGS use_query_cache = true;';
+  AND current_database = currentDatabase()
+  AND query = 'SELECT 1 SETTINGS use_query_cache = true;'
+ORDER BY event_time_microseconds;
 
 SYSTEM DROP QUERY CACHE;
diff --git a/tests/queries/0_stateless/02494_query_cache_normalize_ast.sql b/tests/queries/0_stateless/02494_query_cache_normalize_ast.sql
index 5fd09eb935b..1dbb3ef8158 100644
--- a/tests/queries/0_stateless/02494_query_cache_normalize_ast.sql
+++ b/tests/queries/0_stateless/02494_query_cache_normalize_ast.sql
@@ -1,9 +1,8 @@
 -- Tags: no-parallel
 -- Tag no-parallel: Messes with internal cache
 
--- Start with empty query cache (QC) and query log.
+-- Start with empty query cache (QC)
 SYSTEM DROP QUERY CACHE;
-DROP TABLE system.query_log SYNC;
 
 -- Run query whose result gets cached in the query cache.
 -- Besides "use_query_cache", pass two more knobs (one QC-specific knob and one non-QC-specific knob). We just care
@@ -24,6 +23,7 @@ SYSTEM FLUSH LOGS;
 SELECT ProfileEvents['QueryCacheHits'], ProfileEvents['QueryCacheMisses']
 FROM system.query_log
 WHERE type = 'QueryFinish'
+  AND current_database = currentDatabase()
   AND query = 'SELECT 1 SETTINGS use_query_cache = true, enable_writes_to_query_cache = false, max_threads = 16;';
 
 SYSTEM DROP QUERY CACHE;
diff --git a/tests/queries/0_stateless/02494_query_cache_passive_usage.reference b/tests/queries/0_stateless/02494_query_cache_passive_usage.reference
index edff09773d1..8b73647196e 100644
--- a/tests/queries/0_stateless/02494_query_cache_passive_usage.reference
+++ b/tests/queries/0_stateless/02494_query_cache_passive_usage.reference
@@ -9,4 +9,5 @@
 -----
 1
 1
+0	1
 1	0
diff --git a/tests/queries/0_stateless/02494_query_cache_passive_usage.sql b/tests/queries/0_stateless/02494_query_cache_passive_usage.sql
index 6143b5f7083..f0d2f6398a8 100644
--- a/tests/queries/0_stateless/02494_query_cache_passive_usage.sql
+++ b/tests/queries/0_stateless/02494_query_cache_passive_usage.sql
@@ -22,10 +22,7 @@ SELECT COUNT(*) FROM system.query_cache;
 
 SELECT '-----';
 
--- Run same query with passive mode again. There must still be one entry in the QC and we must have a QC hit.
-
--- Get rid of log of previous SELECT
-DROP TABLE system.query_log SYNC;
+/* Run same query with passive mode again. There must still be one entry in the QC and we must have a QC hit. */
 
 SELECT 1 SETTINGS use_query_cache = true, enable_writes_to_query_cache = false;
 SELECT COUNT(*) FROM system.query_cache;
@@ -34,6 +31,9 @@ SYSTEM FLUSH LOGS;
 SELECT ProfileEvents['QueryCacheHits'], ProfileEvents['QueryCacheMisses']
 FROM system.query_log
 WHERE type = 'QueryFinish'
-  AND query = 'SELECT 1 SETTINGS use_query_cache = true, enable_writes_to_query_cache = false;';
+  AND current_database = currentDatabase()
+  /* NOTE: client incorrectly join comments from the previous line into query, hence LIKE */
+  AND query LIKE '%\nSELECT 1 SETTINGS use_query_cache = true, enable_writes_to_query_cache = false;'
+ORDER BY event_time_microseconds;
 
 SYSTEM DROP QUERY CACHE;

From 35825bc7d672974fc9219ca7e3608a32d0cd73bc Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 16:48:28 +0200
Subject: [PATCH 404/722] Increase line-length limit for yamlllint

CI reports [1]:

  /ClickHouse/tests/queries/0_stateless/data_ua_parser/browser.yaml
    713:301   warning  line too long (328 > 300 characters)  (line-length)

  /ClickHouse/tests/queries/0_stateless/data_ua_parser/device.yaml
    2606:301  warning  line too long (529 > 300 characters)  (line-length)
    2616:301  warning  line too long (348 > 300 characters)  (line-length)
    2630:301  warning  line too long (377 > 300 characters)  (line-length)
    2637:301  warning  line too long (447 > 300 characters)  (line-length)

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/50934/be4555c3226298d956ff650fab477d67bf73ba83/style_check/style_output.txt

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .yamllint | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/.yamllint b/.yamllint
index fe161e71849..9d6550ac960 100644
--- a/.yamllint
+++ b/.yamllint
@@ -6,8 +6,10 @@ rules:
         level: warning
         indent-sequences: consistent
     line-length:
-        # there are some bash -c "", so this is OK
-        max: 300
+        # there are:
+        # - bash -c "", so this is OK
+        # - yaml in tests
+        max: 1000
         level: warning
     comments:
         min-spaces-from-content: 1

From 77775c6074601e49d44349f3d397229354571592 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 16:49:45 +0200
Subject: [PATCH 405/722] Rename 02701_fail_on_invalid_having to
 02701_invalid_having_NOT_AN_AGGREGATE

To remove "fail" from the test name, which is prohibited

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 ....reference => 02701_invalid_having_NOT_AN_AGGREGATE.reference} | 0
 ...valid_having.sql => 02701_invalid_having_NOT_AN_AGGREGATE.sql} | 0
 2 files changed, 0 insertions(+), 0 deletions(-)
 rename tests/queries/0_stateless/{02701_fail_on_invalid_having.reference => 02701_invalid_having_NOT_AN_AGGREGATE.reference} (100%)
 rename tests/queries/0_stateless/{02701_fail_on_invalid_having.sql => 02701_invalid_having_NOT_AN_AGGREGATE.sql} (100%)

diff --git a/tests/queries/0_stateless/02701_fail_on_invalid_having.reference b/tests/queries/0_stateless/02701_invalid_having_NOT_AN_AGGREGATE.reference
similarity index 100%
rename from tests/queries/0_stateless/02701_fail_on_invalid_having.reference
rename to tests/queries/0_stateless/02701_invalid_having_NOT_AN_AGGREGATE.reference
diff --git a/tests/queries/0_stateless/02701_fail_on_invalid_having.sql b/tests/queries/0_stateless/02701_invalid_having_NOT_AN_AGGREGATE.sql
similarity index 100%
rename from tests/queries/0_stateless/02701_fail_on_invalid_having.sql
rename to tests/queries/0_stateless/02701_invalid_having_NOT_AN_AGGREGATE.sql

From 0444aa2fda48f59be08bef6482b06754f1cb2c0b Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 16:50:43 +0200
Subject: [PATCH 406/722] tests: add missing current_database condition for
 query_log

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 tests/queries/0_stateless/02483_elapsed_time.sh                 | 2 +-
 .../queries/0_stateless/02499_monotonicity_toUnixTimestamp64.sh | 2 +-
 .../0_stateless/02521_incorrect_dealy_for_insert_bug_44902.sh   | 2 +-
 .../queries/0_stateless/02578_parameterized_rename_queries.sql  | 1 +
 tests/queries/0_stateless/02585_query_status_deadlock.sh        | 2 +-
 tests/queries/0_stateless/02681_undrop_query.sql                | 2 +-
 tests/queries/0_stateless/02761_ddl_initial_query_id.sh         | 2 ++
 .../02783_parallel_replicas_trivial_count_optimization.sh       | 2 +-
 tests/queries/1_stateful/00177_memory_bound_merging.sh          | 2 ++
 9 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/tests/queries/0_stateless/02483_elapsed_time.sh b/tests/queries/0_stateless/02483_elapsed_time.sh
index 608299eb01b..e3b983129fb 100755
--- a/tests/queries/0_stateless/02483_elapsed_time.sh
+++ b/tests/queries/0_stateless/02483_elapsed_time.sh
@@ -25,7 +25,7 @@ QUERY_ID="${CLICKHOUSE_DATABASE}_$(date +%s)_02883_q1"
 ${CLICKHOUSE_CLIENT} -m --query "$EXCEPTION_BEFORE_START_QUERY" --query_id="$QUERY_ID" >/dev/null 2>&1
 
 ${CLICKHOUSE_CLIENT} --query "SYSTEM FLUSH LOGS"
-${CLICKHOUSE_CLIENT} --query "SELECT type == 'ExceptionBeforeStart' as expected_type, query_duration_ms <= 1000 as elapsed_more_than_one_second FROM system.query_log WHERE query_id='$QUERY_ID'"
+${CLICKHOUSE_CLIENT} --query "SELECT type == 'ExceptionBeforeStart' as expected_type, query_duration_ms <= 1000 as elapsed_more_than_one_second FROM system.query_log WHERE current_database = '$CLICKHOUSE_DATABASE' AND query_id='$QUERY_ID'"
 
 # Now we test with a query that will take 1+ seconds. The CLI should show that as part of the output format
 OK_QUERY_JSON="
diff --git a/tests/queries/0_stateless/02499_monotonicity_toUnixTimestamp64.sh b/tests/queries/0_stateless/02499_monotonicity_toUnixTimestamp64.sh
index 1223d7957b5..5d787aa0d8e 100755
--- a/tests/queries/0_stateless/02499_monotonicity_toUnixTimestamp64.sh
+++ b/tests/queries/0_stateless/02499_monotonicity_toUnixTimestamp64.sh
@@ -18,5 +18,5 @@ query_id="${CLICKHOUSE_DATABASE}_02499_$RANDOM$RANDOM"
 $CLICKHOUSE_CLIENT --query_id="$query_id" -q "select ts from t order by toUnixTimestamp64Nano(ts) limit 10 format Null settings max_block_size = $max_block_size, optimize_read_in_order = 1;"
 
 $CLICKHOUSE_CLIENT -q "system flush logs;"
-$CLICKHOUSE_CLIENT --param_query_id="$query_id" -q "select read_rows <= $max_block_size from system.query_log where event_date >= yesterday() and query_id = {query_id:String} and type = 'QueryFinish';"
+$CLICKHOUSE_CLIENT --param_query_id="$query_id" -q "select read_rows <= $max_block_size from system.query_log where event_date >= yesterday() and current_database = '$CLICKHOUSE_DATABASE' and query_id = {query_id:String} and type = 'QueryFinish';"
 
diff --git a/tests/queries/0_stateless/02521_incorrect_dealy_for_insert_bug_44902.sh b/tests/queries/0_stateless/02521_incorrect_dealy_for_insert_bug_44902.sh
index 5f91ef19a5a..0ae44ec0c01 100755
--- a/tests/queries/0_stateless/02521_incorrect_dealy_for_insert_bug_44902.sh
+++ b/tests/queries/0_stateless/02521_incorrect_dealy_for_insert_bug_44902.sh
@@ -16,7 +16,7 @@ do
     query_id="${CLICKHOUSE_DATABASE}_02521_${i}_$RANDOM$RANDOM"
     $CLICKHOUSE_CLIENT --query_id="$query_id" -q "INSERT INTO test_02521_insert_delay SELECT number, toString(number) FROM numbers(${i}, 1)"
     $CLICKHOUSE_CLIENT -q "SYSTEM FLUSH LOGS"
-    $CLICKHOUSE_CLIENT --param_query_id="$query_id" -q "select ProfileEvents['DelayedInsertsMilliseconds'] as delay from system.query_log where event_date >= yesterday() and query_id = {query_id:String} order by delay desc limit 1"
+    $CLICKHOUSE_CLIENT --param_query_id="$query_id" -q "select ProfileEvents['DelayedInsertsMilliseconds'] as delay from system.query_log where event_date >= yesterday() and current_database = '$CLICKHOUSE_DATABASE' and query_id = {query_id:String} order by delay desc limit 1"
 done
 
 $CLICKHOUSE_CLIENT -q "INSERT INTO test_02521_insert_delay VALUES(0, 'This query throws error')" 2>&1 | grep -o 'TOO_MANY_PARTS' | head -n 1
diff --git a/tests/queries/0_stateless/02578_parameterized_rename_queries.sql b/tests/queries/0_stateless/02578_parameterized_rename_queries.sql
index eecb282083f..de36f8ae3b5 100644
--- a/tests/queries/0_stateless/02578_parameterized_rename_queries.sql
+++ b/tests/queries/0_stateless/02578_parameterized_rename_queries.sql
@@ -24,6 +24,7 @@ SET param_new_tbl_name = 02661_t1;
 CREATE TABLE {new_db_name:Identifier}.{old_tbl_name:Identifier} (a UInt64) ENGINE = MergeTree ORDER BY tuple();
 RENAME TABLE {new_db_name:Identifier}.{old_tbl_name:Identifier} TO {new_db_name:Identifier}.{new_tbl_name:Identifier};
 
+-- NOTE: no 'database = currentDatabase()' on purpose
 SELECT name FROM system.tables WHERE name = {new_tbl_name:String};
 
 -- Case 3: RENAME DICTIONARY
diff --git a/tests/queries/0_stateless/02585_query_status_deadlock.sh b/tests/queries/0_stateless/02585_query_status_deadlock.sh
index 227ecb1c1b2..9eb6eff8cd0 100755
--- a/tests/queries/0_stateless/02585_query_status_deadlock.sh
+++ b/tests/queries/0_stateless/02585_query_status_deadlock.sh
@@ -14,7 +14,7 @@ $CLICKHOUSE_CLIENT -q "SYSTEM FLUSH LOGS"
 
 while true
 do
-    res=$($CLICKHOUSE_CLIENT -q "select query, event_time from system.query_log where query_id = '$QUERY_ID' and query like 'select%' limit 1")
+    res=$($CLICKHOUSE_CLIENT -q "select query, event_time from system.query_log where query_id = '$QUERY_ID' and current_database = '$CLICKHOUSE_DATABASE' and query like 'select%' limit 1")
     if [ -n "$res" ]; then
         break
     fi
diff --git a/tests/queries/0_stateless/02681_undrop_query.sql b/tests/queries/0_stateless/02681_undrop_query.sql
index ead1a8bb305..39ca1548d53 100644
--- a/tests/queries/0_stateless/02681_undrop_query.sql
+++ b/tests/queries/0_stateless/02681_undrop_query.sql
@@ -21,7 +21,7 @@ detach table 02681_undrop_detach;
 undrop table 02681_undrop_detach; -- { serverError 57 }
 attach table 02681_undrop_detach;
 alter table 02681_undrop_detach update num = 2 where id = 1;
-select command from system.mutations where table='02681_undrop_detach' limit 1;
+select command from system.mutations where table='02681_undrop_detach' and database=currentDatabase() limit 1;
 drop table 02681_undrop_detach sync;
 
 select 'test MergeTree with cluster';
diff --git a/tests/queries/0_stateless/02761_ddl_initial_query_id.sh b/tests/queries/0_stateless/02761_ddl_initial_query_id.sh
index e9a315b812b..b8b35ef01f7 100755
--- a/tests/queries/0_stateless/02761_ddl_initial_query_id.sh
+++ b/tests/queries/0_stateless/02761_ddl_initial_query_id.sh
@@ -21,4 +21,6 @@ $CLICKHOUSE_CLIENT -q "SYSTEM FLUSH LOGS"
 # - replace() is required to avoid non deterministic behaviour of
 #   normalizeQuery() that replaces the identifier with "?" only if it has more
 #   then two numbers.
+#
+# NOTE: no current_database = '$CLICKHOUSE_DATABASE' filter on purpose (since ON CLUSTER queries does not have current_database passed)
 $CLICKHOUSE_CLIENT -q "SELECT normalizeQuery(replace(query, currentDatabase(), 'default')) FROM system.query_log WHERE initial_query_id = '$query_id' AND type != 'QueryStart' ORDER BY event_time_microseconds"
diff --git a/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.sh b/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.sh
index 4c29e513183..6210ef2e8b6 100755
--- a/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.sh
+++ b/tests/queries/0_stateless/02783_parallel_replicas_trivial_count_optimization.sh
@@ -12,7 +12,7 @@ function has_used_parallel_replicas () {
             sumIf(read_rows, is_initial_query) as read_rows,
             sumIf(read_bytes, is_initial_query) as read_bytes
         FROM system.query_log
-    WHERE event_date >= yesterday() and initial_query_id LIKE '$1%'
+    WHERE event_date >= yesterday() and initial_query_id LIKE '$1%' AND current_database = '$CLICKHOUSE_DATABASE'
     GROUP BY initial_query_id
     ORDER BY min(event_time_microseconds) ASC
     FORMAT TSV"
diff --git a/tests/queries/1_stateful/00177_memory_bound_merging.sh b/tests/queries/1_stateful/00177_memory_bound_merging.sh
index 008422be108..774f005b8eb 100755
--- a/tests/queries/1_stateful/00177_memory_bound_merging.sh
+++ b/tests/queries/1_stateful/00177_memory_bound_merging.sh
@@ -12,6 +12,8 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 check_replicas_read_in_order() {
     # to check this we actually look for at least one log message from MergeTreeInOrderSelectProcessor.
     # hopefully logger's names are a bit more stable than log messages itself
+    #
+    # NOTE: lack of "current_database = '$CLICKHOUSE_DATABASE'" filter is made on purpose
     $CLICKHOUSE_CLIENT -nq "
         SYSTEM FLUSH LOGS;
 

From bb971fd7b7fd5bc400bbe28d16867c9dc337fb17 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 17:02:24 +0200
Subject: [PATCH 407/722] check-style: allow {database} for ReplicatedMergeTree
 as well

CLICKHOUSE_TEST_ZOOKEEPER_PREFIX is a {test_name}_{database}, but
actually {database} should be enough, since it is uniq for each test run.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 utils/check-style/check-style | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/utils/check-style/check-style b/utils/check-style/check-style
index bd3ee8e02d6..e7c06fefee2 100755
--- a/utils/check-style/check-style
+++ b/utils/check-style/check-style
@@ -229,7 +229,7 @@ for test_case in "${tests_with_replicated_merge_tree[@]}"; do
         *.gen.*)
             ;;
         *.sh)
-            test_case_zk_prefix="\$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX"
+            test_case_zk_prefix="\(\$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX\|{database}\)"
             grep -q -e "Replicated.*MergeTree[ ]*(.*$test_case_zk_prefix" "$test_case" || echo "Replicated.*MergeTree should contain '$test_case_zk_prefix' in zookeeper path to avoid overlaps ($test_case)"
             ;;
         *.sql|*.sql.j2)

From 1bc5598aa77bb5a7dcffc26b090bb0f45cb83abb Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Tue, 13 Jun 2023 18:02:25 +0200
Subject: [PATCH 408/722] impl

---
 src/Disks/IO/AsynchronousBoundedReadBuffer.cpp | 5 ++---
 src/Disks/IO/ReadBufferFromRemoteFSGather.h    | 2 ++
 src/IO/SeekableReadBuffer.h                    | 4 ++++
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/src/Disks/IO/AsynchronousBoundedReadBuffer.cpp b/src/Disks/IO/AsynchronousBoundedReadBuffer.cpp
index d75ec9f09e0..f9bd68222ae 100644
--- a/src/Disks/IO/AsynchronousBoundedReadBuffer.cpp
+++ b/src/Disks/IO/AsynchronousBoundedReadBuffer.cpp
@@ -301,9 +301,8 @@ off_t AsynchronousBoundedReadBuffer::seek(off_t offset, int whence)
     * Lazy ignore. Save number of bytes to ignore and ignore it either for prefetch buffer or current buffer.
     * Note: we read in range [file_offset_of_buffer_end, read_until_position).
     */
-    if (file_offset_of_buffer_end && read_until_position && new_pos < *read_until_position
-        && new_pos > file_offset_of_buffer_end
-        && new_pos < file_offset_of_buffer_end + read_settings.remote_read_min_bytes_for_seek)
+    if (!impl->seekIsCheap() && file_offset_of_buffer_end && read_until_position && new_pos < *read_until_position
+        && new_pos > file_offset_of_buffer_end && new_pos < file_offset_of_buffer_end + read_settings.remote_read_min_bytes_for_seek)
     {
         ProfileEvents::increment(ProfileEvents::RemoteFSLazySeeks);
         bytes_to_ignore = new_pos - file_offset_of_buffer_end;
diff --git a/src/Disks/IO/ReadBufferFromRemoteFSGather.h b/src/Disks/IO/ReadBufferFromRemoteFSGather.h
index cb98ac6d9f3..272ed2b3ac1 100644
--- a/src/Disks/IO/ReadBufferFromRemoteFSGather.h
+++ b/src/Disks/IO/ReadBufferFromRemoteFSGather.h
@@ -50,6 +50,8 @@ public:
 
     off_t getPosition() override { return file_offset_of_buffer_end - available() + bytes_to_ignore; }
 
+    bool seekIsCheap() override { return !current_buf; }
+
 private:
     SeekableReadBufferPtr createImplementationBuffer(const StoredObject & object);
 
diff --git a/src/IO/SeekableReadBuffer.h b/src/IO/SeekableReadBuffer.h
index 8ced9d752de..5770948be20 100644
--- a/src/IO/SeekableReadBuffer.h
+++ b/src/IO/SeekableReadBuffer.h
@@ -83,6 +83,10 @@ public:
 
     /// Checks if readBigAt() is allowed. May be slow, may throw (e.g. it may do an HTTP request or an fstat).
     virtual bool supportsReadAt() { return false; }
+
+    /// We do some tricks to avoid seek cost. E.g we read more data and than ignore it (see remote_read_min_bytes_for_seek).
+    /// Sometimes however seek is basically free because underlying read buffer wasn't yet initialised (or re-initialised after reset).
+    virtual bool seekIsCheap() { return false; }
 };
 
 

From 994228ab209d3dae408c43e135e2391e4a6b5112 Mon Sep 17 00:00:00 2001
From: Dmitry Kardymon <d.kardymon@arenadata.io>
Date: Tue, 13 Jun 2023 20:54:02 +0000
Subject: [PATCH 409/722] Uncomment flaky test

---
 .../0_stateless/01746_convert_type_with_default.reference       | 1 +
 tests/queries/0_stateless/01746_convert_type_with_default.sql   | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.reference b/tests/queries/0_stateless/01746_convert_type_with_default.reference
index 0edea4de31e..e00156cd3c5 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.reference
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.reference
@@ -40,6 +40,7 @@
 1970-01-20
 1970-01-20
 2149-06-06
+1
 2023-05-30
 2023-05-30
 2023-05-30 14:38:20
diff --git a/tests/queries/0_stateless/01746_convert_type_with_default.sql b/tests/queries/0_stateless/01746_convert_type_with_default.sql
index c74b185f7fd..5ef7718784d 100644
--- a/tests/queries/0_stateless/01746_convert_type_with_default.sql
+++ b/tests/queries/0_stateless/01746_convert_type_with_default.sql
@@ -54,7 +54,7 @@ select toDateOrDefault(cast(19 as Int256));
 select toDateOrDefault(cast(19 as UInt256));
 
 select toDateOrDefault(65535);
--- select toDateOrDefault(122400);
+select toDateOrDefault(65536) in ('1970-01-01', '1970-01-02');
 
 select toDateOrDefault(19507, '2000-01-01'::Date);
 select toDateOrDefault(-1, '2023-05-30'::Date);

From a570b00bdf76118e53de34a3337a66683b55fcb7 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 13 Jun 2023 19:19:34 -0300
Subject: [PATCH 410/722] Update README.md

---
 docker/server/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docker/server/README.md b/docker/server/README.md
index 67646a262f5..6aec001064e 100644
--- a/docker/server/README.md
+++ b/docker/server/README.md
@@ -20,6 +20,7 @@ For more information and documentation see https://clickhouse.com/.
 
 - The amd64 image requires support for [SSE3 instructions](https://en.wikipedia.org/wiki/SSE3). Virtually all x86 CPUs after 2005 support SSE3.
 - The arm64 image requires support for the [ARMv8.2-A architecture](https://en.wikipedia.org/wiki/AArch64#ARMv8.2-A). Most ARM CPUs after 2017 support ARMv8.2-A. A notable exception is Raspberry Pi 4 from 2019 whose CPU only supports ARMv8.0-A.
+- Since Clickhouse 23.3 Ubuntu image started to use `ubuntu:22.04` as a base image it requiers docker version >= `20.10.10`, overwise use `docker run --privileged`.
 
 ## How to use this image
 

From d8d570081031f4851c33737618d907d69a3b14e8 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 13 Jun 2023 19:24:36 -0300
Subject: [PATCH 411/722] Update README.md

---
 docker/server/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/server/README.md b/docker/server/README.md
index 6aec001064e..0c89f834fcd 100644
--- a/docker/server/README.md
+++ b/docker/server/README.md
@@ -20,7 +20,7 @@ For more information and documentation see https://clickhouse.com/.
 
 - The amd64 image requires support for [SSE3 instructions](https://en.wikipedia.org/wiki/SSE3). Virtually all x86 CPUs after 2005 support SSE3.
 - The arm64 image requires support for the [ARMv8.2-A architecture](https://en.wikipedia.org/wiki/AArch64#ARMv8.2-A). Most ARM CPUs after 2017 support ARMv8.2-A. A notable exception is Raspberry Pi 4 from 2019 whose CPU only supports ARMv8.0-A.
-- Since Clickhouse 23.3 Ubuntu image started to use `ubuntu:22.04` as a base image it requiers docker version >= `20.10.10`, overwise use `docker run --privileged`.
+- Since Clickhouse 23.3 Ubuntu image started to use `ubuntu:22.04` as a base image it requiers docker version >= `20.10.10`, overwise use `docker run --privileged`. Alternativly try Clickhouse Alpine image.
 
 ## How to use this image
 

From 404a52432c59a4b833d093e2e344916f4cb62de5 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 13 Jun 2023 19:39:23 -0300
Subject: [PATCH 412/722] Update README.md

---
 docker/server/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/server/README.md b/docker/server/README.md
index 0c89f834fcd..18dce492123 100644
--- a/docker/server/README.md
+++ b/docker/server/README.md
@@ -20,7 +20,7 @@ For more information and documentation see https://clickhouse.com/.
 
 - The amd64 image requires support for [SSE3 instructions](https://en.wikipedia.org/wiki/SSE3). Virtually all x86 CPUs after 2005 support SSE3.
 - The arm64 image requires support for the [ARMv8.2-A architecture](https://en.wikipedia.org/wiki/AArch64#ARMv8.2-A). Most ARM CPUs after 2017 support ARMv8.2-A. A notable exception is Raspberry Pi 4 from 2019 whose CPU only supports ARMv8.0-A.
-- Since Clickhouse 23.3 Ubuntu image started to use `ubuntu:22.04` as a base image it requiers docker version >= `20.10.10`, overwise use `docker run --privileged`. Alternativly try Clickhouse Alpine image.
+- Since the Clickhouse 23.3 Ubuntu image started using `ubuntu:22.04` as its base image, it requires docker version >= `20.10.10`, or use `docker run -- privileged` instead. Alternatively, try the Clickhouse Alpine image.
 
 ## How to use this image
 

From 86075dbae49f8acda2819fc6b8640631ccf1f3fe Mon Sep 17 00:00:00 2001
From: Rich Raposa <richraposa@gmail.com>
Date: Tue, 13 Jun 2023 16:40:14 -0600
Subject: [PATCH 413/722] Update azureBlobStorage.md

---
 docs/en/engines/table-engines/integrations/azureBlobStorage.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/integrations/azureBlobStorage.md b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
index b8e621fd513..14fbf0c068e 100644
--- a/docs/en/engines/table-engines/integrations/azureBlobStorage.md
+++ b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
@@ -48,4 +48,4 @@ SELECT * FROM test_table;
 
 ## See also
 
-[Azure Blob Storage Table Function](/docs/en/sql-reference/table-functions/azureBlobStorage.md)
+[Azure Blob Storage Table Function](/docs/en/sql-reference/table-functions/azureBlobStorage)

From 49082bfe8919a4f7113e96eccde94c4fa2d74017 Mon Sep 17 00:00:00 2001
From: JackyWoo <wuchienchao@qq.com>
Date: Wed, 14 Jun 2023 09:00:50 +0800
Subject: [PATCH 414/722] fix typos in redis.md

---
 docs/en/engines/table-engines/integrations/redis.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index 68235a89d33..a78942ab7bb 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -114,6 +114,6 @@ TRUNCATE TABLE redis_table SYNC;
 
 ## Limitations {#limitations}
 
-Redis engine also support scanning query, such as `where k > xx`, but it has some limitations:
-1. Scanning query may produce some duplicated keys in a very rare case when it is rehashing, details see [Redis Scan](https://github.com/redis/redis/blob/e4d183afd33e0b2e6e8d1c79a832f678a04a7886/src/dict.c#L1186-L1269)
-2. During the scanning keys could be created and deleted, so the resulting dataset can not represent a valid point in time.
+Redis engine also supports scanning queries, such as `where k > xx`, but it has some limitations:
+1. Scanning query may produce some duplicated keys in a very rare case when it is rehashing. See details in [Redis Scan](https://github.com/redis/redis/blob/e4d183afd33e0b2e6e8d1c79a832f678a04a7886/src/dict.c#L1186-L1269)
+2. During the scanning, keys could be created and deleted, so the resulting dataset can not represent a valid point in time.

From c05bcf56058597e180bfb65532e76dbe6c1639da Mon Sep 17 00:00:00 2001
From: pufit <pufit@clickhouse.com>
Date: Tue, 13 Jun 2023 21:09:30 -0400
Subject: [PATCH 415/722] Fix keeper-client help message

---
 programs/keeper-client/KeeperClient.cpp | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/programs/keeper-client/KeeperClient.cpp b/programs/keeper-client/KeeperClient.cpp
index f38da1b72aa..f41dca1e27a 100644
--- a/programs/keeper-client/KeeperClient.cpp
+++ b/programs/keeper-client/KeeperClient.cpp
@@ -127,42 +127,42 @@ void KeeperClient::defineOptions(Poco::Util::OptionSet & options)
 
     options.addOption(
         Poco::Util::Option("host", "h", "server hostname. default `localhost`")
-            .argument("host")
+            .argument("<host>")
             .binding("host"));
 
     options.addOption(
         Poco::Util::Option("port", "p", "server port. default `2181`")
-            .argument("port")
+            .argument("<port>")
             .binding("port"));
 
     options.addOption(
         Poco::Util::Option("query", "q", "will execute given query, then exit.")
-            .argument("query")
+            .argument("<query>")
             .binding("query"));
 
     options.addOption(
         Poco::Util::Option("connection-timeout", "", "set connection timeout in seconds. default 10s.")
-            .argument("connection-timeout")
+            .argument("<seconds>")
             .binding("connection-timeout"));
 
     options.addOption(
         Poco::Util::Option("session-timeout", "", "set session timeout in seconds. default 10s.")
-            .argument("session-timeout")
+            .argument("<seconds>")
             .binding("session-timeout"));
 
     options.addOption(
         Poco::Util::Option("operation-timeout", "", "set operation timeout in seconds. default 10s.")
-            .argument("operation-timeout")
+            .argument("<seconds>")
             .binding("operation-timeout"));
 
     options.addOption(
         Poco::Util::Option("history-file", "", "set path of history file. default `~/.keeper-client-history`")
-            .argument("history-file")
+            .argument("<file>")
             .binding("history-file"));
 
     options.addOption(
         Poco::Util::Option("log-level", "", "set log level")
-            .argument("log-level")
+            .argument("<level>")
             .binding("log-level"));
 }
 

From f1b5d47ce27c053e76722d7827c49fb4aa78ac0e Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 14 Jun 2023 01:15:45 +0000
Subject: [PATCH 416/722] corrections after second review iteration

---
 docs/en/interfaces/cli.md                     | 37 ++++++++-----------
 docs/ru/interfaces/cli.md                     | 32 +++++++---------
 programs/client/Client.cpp                    |  2 +-
 src/Client/ConnectionString.cpp               | 31 ++++++++--------
 src/Client/ConnectionString.h                 | 12 +++---
 .../0_stateless/02784_connection_string.sh    |  6 +--
 6 files changed, 54 insertions(+), 66 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index b5134ea30c0..e2c7dc1e608 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -194,7 +194,7 @@ You can pass parameters to `clickhouse-client` (all parameters have a default va
 - `--print-profile-events` – Print `ProfileEvents` packets.
 - `--profile-events-delay-ms` – Delay between printing `ProfileEvents` packets (-1 - print only totals, 0 - print every single packet).
 
-Instead of --host, --port, --user and --password options, ClickHouse client also supports connection strings.
+Instead of `--host`, `--port`, `--user` and `--password` options, ClickHouse client also supports connection strings (see next section).
 
 
 ## Connection string {#connection_string}
@@ -213,28 +213,27 @@ Where
 - `database` - (optional) is the database name,
 - `query_parameters` - (optional) is a list of key-value pairs `param1=value1[,&param2=value2], ...`. For some parameters, no value is required. Parameter names and values are case-sensitive.
 
+If no user is specified, `default` user without password will be used.
+If no host is specified, the `localhost` will be used (localhost).
+If no port is specified is not specified, `9000` will be used as port.
+If no database is specified, the `default` database will be used.
 
+If the user name, password or database was specified in the connection string, it cannot be specified using `--user`, `--password` or `--database` (and vice versa).
 
-The host component can either be an IP address or a host name. Put an IPv6 address in square brackets to specify it:
+The host component can either be an a host name and IP address. Put an IPv6 address in square brackets to specify it:
 
 ```text
 clickhouse://[2001:db8::1234]
 ```
 
-If user is not specified, `default` user without password will be used.
-If host is not specified, the `localhost` will be used (localhost).
-If port is not specified, `9000` will be used as port.
-If database is not specified, the `default` database will be used.
-
-If the user name, password or database was specified in the connection string, it cannot be specified using `--user`, `--password` or `--database` (and vice versa).
-
-The connection string must be specified in the first argument of clickhouse-client. The connection string can be combined with other [command-line-options](#command-line-options) except `--host(h)` and `--port`.
-
-### Multiple hosts {#connection_string_multiple_hosts}
-
 URI allows multiple hosts to be connected to. Connection strings can contain multiple hosts. ClickHouse-client will try to connect to these hosts in order (i.e. from left to right). After the connection is established, no attempt to connect to the remaining hosts is made.
 
-### Allowed query_parameters keys {#connection_string_query_parameters}
+
+
+
+The connection string must be specified as the first argument of clickhouse-client. The connection string can be combined with arbitrary other [command-line-options](#command-line-options) except `--host/-h` and `--port`.
+
+The following keys are allowed for component `query_parameter`:
 
 - `secure` or shorthanded `s` - no value. If specified, client will connect to the server over a secure connection (TLS). See `secure` in [command-line-options](#command-line-options)
 
@@ -244,7 +243,7 @@ Non-US ASCII, spaces and special characters in the `user`, `password`, `hosts`,
 
 ### Examples {#connection_string_examples}
 
-Connect to localhost using port 9000 and execute the query "SELECT 1".
+Connect to localhost using port 9000 and execute the query `SELECT 1`.
 
 ``` bash
 clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"
@@ -262,12 +261,6 @@ Connect to localhost using default user, host with IPV6 address `[::1]` and port
 clickhouse-client clickhouse://[::1]:9000
 ```
 
-Connect to localhost using default user, host with IPV6 address `[2001:db8:3333:4444:5555:6666:7777:8888]` and port `9000`.
-
-``` bash
-clickhouse-client clickhouse://[2001:db8:3333:4444:5555:6666:7777:8888]:9000
-```
-
 Connect to localhost using port 9000 in multiline mode.
 
 ``` bash
@@ -277,7 +270,7 @@ clickhouse-client clickhouse://localhost:9000 '-m'
 Connect to localhost using port 9000 with the user `default`.
 
 ``` bash
-clickhouse-client clickhouse://default@localhost:9000 --user default
+clickhouse-client clickhouse://default@localhost:9000
 
 # equivalent to:
 clickhouse-client clickhouse://localhost:9000 --user default
diff --git a/docs/ru/interfaces/cli.md b/docs/ru/interfaces/cli.md
index 794ac60ec83..aa6ae3629e8 100644
--- a/docs/ru/interfaces/cli.md
+++ b/docs/ru/interfaces/cli.md
@@ -142,6 +142,8 @@ $ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="numbe
 -   `--history_file` - путь к файлу с историей команд.
 -   `--param_<name>` — значение параметра для [запроса с параметрами](#cli-queries-with-parameters).
 
+Вместо параметров `--host`, `--port`, `--user` и `--password` клиент ClickHouse также поддерживает строки подключения (смотри следующий раздел).
+
 ## Строка подключения {#connection_string}
 
 clickhouse-client также поддерживает подключение к серверу clickhouse с помощью строки подключения, аналогичной [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING), [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). Она имеет следующий синтаксис:
@@ -154,15 +156,9 @@ clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters]
 
 - `user` - (необязательно) - это имя пользователя,
 - `password` - (необязательно) - Пароль пользователя. Если символ `:` укаказан, и пароль пуст, то клиент запросит ввести пользователя пароль.
-- `hostspec` - (необязательно) - список хостов и необязательных портов. `host[:port] [, host:[port]], ...`,
+- `hosts_and_ports` - (необязательно) - список хостов и необязательных портов. `host[:port] [, host:[port]], ...`,
 - `database` - (необязательно) - это имя базы данных,
-- `paramspec` - (опционально) список пар ключ-значение `param1=value1[,&param2=value2], ...`. Для некоторых параметров значение не требуется. Имена и значения параметров чувствительны к регистру.
-
-Параметр host может быть либо IP-адресом, либо именем хоста. Для указания IPv6-адреса поместите его в квадратные скобки:
-
-```text
-clickhouse://[2001:db8::1234]
-```
+- `query_parameters` - (опционально) список пар ключ-значение `param1=value1[,&param2=value2], ...`. Для некоторых параметров значение не требуется. Имена и значения параметров чувствительны к регистру.
 
 Если user не указан, будут использоваться имя пользователя `default`.
 Если host не указан, будет использован хост `localhost`.
@@ -171,13 +167,19 @@ clickhouse://[2001:db8::1234]
 
 Если имя пользователя, пароль или база данных были указаны в строке подключения, их нельзя указать с помощью `--user`, `--password` или `--database` (и наоборот).
 
-Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме `--host (h)` и `--port`.
+Параметр host может быть либо именем хоста, либо IP-адресом. Для указания IPv6-адреса поместите его в квадратные скобки:
 
-### Несколько хостов {#connection_string_multiple_hosts}
+```text
+clickhouse://[2001:db8::1234]
+```
 
 URI позволяет подключаться к нескольким хостам. Строки подключения могут содержать несколько хостов. ClickHouse-client будет пытаться подключиться к этим хостам по порядку (т.е. слева направо). После установления соединения попытки подключения к оставшимся хостам не предпринимаются.
 
-### Допустимые ключи query_parameters {#connection_string_query_parameters}
+
+
+Строка подключения должна быть указана в первом аргументе clickhouse-client. Строка подключения может комбинироваться с другими [параметрами командной строки] (#command-line-options) кроме `--host/-h` и `--port`.
+
+Для компонента `query_parameter` разрешены следующие ключи:
 
 - `secure` или сокращенно `s` - без значение. Если параметр указан, то соединение с сервером будет осуществляться по защищенному каналу (TLS). См. `secure` в [command-line-options](#command-line-options).
 
@@ -187,7 +189,7 @@ URI позволяет подключаться к нескольким хост
 
 ### Примеры {#connection_string_examples}
 
-Подключиться к localhost через порт 9000 и выполнить запрос "SELECT 1"
+Подключиться к localhost через порт 9000 и выполнить запрос `SELECT 1`
 
 ``` bash
 clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"
@@ -204,12 +206,6 @@ clickhouse-client clickhouse://john:secret@127.0.0.1:9000
 clickhouse-client clickhouse://[::1]:9000
 ```
 
-Подключиться к localhost, используя пользователя по умолчанию, хост с IPV6 адресом `[2001:db8:3333:4444:5555:6666:7777:8888]` и портом `9000`.
-
-`` bash
-clickhouse-client clickhouse://[2001:db8:3333:4444:5555:6666:7777:8888]:9000
-```
-
 Подключиться к localhost через порт 9000  многострочном режиме.
 
 ``` bash
diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index a49447dff69..6c3df3520e9 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -1268,7 +1268,7 @@ void Client::readArguments(
         std::string_view arg = argv[arg_num];
 
         if (has_connection_string)
-            validateConnectionStringClientOption(arg);
+            checkIfCmdLineOptionCanBeUsedWithConnectionString(arg);
 
         if (arg == "--external")
         {
diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index 8f0a0980f51..62090487490 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -45,26 +45,26 @@ std::string uriDecode(const std::string & uri_encoded_string, bool plus_as_space
 void getHostAndPort(const Poco::URI & uri, std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
 {
     std::vector<std::string> host_and_port;
-    auto host = uri.getHost();
+    const auto& host = uri.getHost();
     if (!host.empty())
     {
-        host_and_port.push_back("--host="s + uriDecode(host, false));
+        host_and_port.push_back("--host=" + uriDecode(host, false));
     }
 
     // Port can be written without host (":9000"). Empty host name equals to default host.
     auto port = uri.getPort();
     if (port != 0)
-        host_and_port.push_back("--port="s + std::to_string(port));
+        host_and_port.push_back("--port=" + std::to_string(port));
 
     if (!host_and_port.empty())
         hosts_and_ports_arguments.push_back(std::move(host_and_port));
 }
 
 void buildConnectionString(
-    Poco::URI & uri,
-    std::vector<std::vector<std::string>> & hosts_and_ports_arguments,
     std::string_view host_and_port,
-    std::string_view right_part)
+    std::string_view right_part,
+    Poco::URI & uri,
+    std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
 {
     // User info does not matter in sub URI
     auto uri_string = std::string(CONNECTION_URI_SCHEME);
@@ -154,7 +154,7 @@ bool tryParseConnectionString(
         {
             if (*it == ',')
             {
-                buildConnectionString(uri, hosts_and_ports_arguments, {last_host_begin, it}, {hosts_end, connection_string.end()});
+                buildConnectionString({last_host_begin, it}, {hosts_end, connection_string.end()}, uri, hosts_and_ports_arguments);
                 last_host_begin = it + 1;
             }
         }
@@ -166,7 +166,7 @@ bool tryParseConnectionString(
             getHostAndPort(uri, hosts_and_ports_arguments);
         }
         else
-            buildConnectionString(uri, hosts_and_ports_arguments, {last_host_begin, hosts_end}, {hosts_end, connection_string.end()});
+            buildConnectionString({last_host_begin, hosts_end}, {hosts_end, connection_string.end()}, uri, hosts_and_ports_arguments);
 
         Poco::URI::QueryParameters params = uri.getQueryParameters();
         for (const auto & param : params)
@@ -174,12 +174,12 @@ bool tryParseConnectionString(
             if (param.first == "secure" || param.first == "s")
             {
                 if (!param.second.empty())
-                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "secure URI query parameter does not require value");
+                    throw Exception(ErrorCodes::BAD_ARGUMENTS, "secure URI query parameter does not allow value");
 
                 common_arguments.push_back(makeArgument(param.first));
             }
             else
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "URI query parameter {} is unknown", param.first);
+                throw Exception(ErrorCodes::BAD_ARGUMENTS, "URI query parameter {} is not supported", param.first);
         }
 
         auto user_info = uri.getUserInfo();
@@ -188,7 +188,7 @@ bool tryParseConnectionString(
             // Poco::URI doesn't decode user name/password by default.
             // But ClickHouse allows to have users with email user name like: 'john@some_mail.com'
             // john@some_mail.com should be percent-encoded: 'john%40some_mail.com'
-            std::string::size_type pos = user_info.find(':');
+            size_t pos = user_info.find(':');
             if (pos != std::string::npos)
             {
                 common_arguments.push_back("--user");
@@ -229,12 +229,11 @@ bool tryParseConnectionString(
     return true;
 }
 
-void validateConnectionStringClientOption(std::string_view command_line_option)
+void checkIfCmdLineOptionCanBeUsedWithConnectionString(std::string_view command_line_option)
 {
-    const auto prohibited_option_iter = PROHIBITED_CLIENT_OPTIONS.find(command_line_option);
-    if (prohibited_option_iter != PROHIBITED_CLIENT_OPTIONS.end())
-        throw Exception(
-            ErrorCodes::BAD_ARGUMENTS, "Mixing a connection string and {} option is prohibited", prohibited_option_iter->second);
+    if (PROHIBITED_CLIENT_OPTIONS.contains(command_line_option))
+        throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                        "Mixing a connection string and {} option is prohibited", PROHIBITED_CLIENT_OPTIONS.at(command_line_option));
 }
 
 }
diff --git a/src/Client/ConnectionString.h b/src/Client/ConnectionString.h
index ce72de9edf6..ad63e9cda3d 100644
--- a/src/Client/ConnectionString.h
+++ b/src/Client/ConnectionString.h
@@ -9,19 +9,19 @@ namespace DB
 /** Tries to parse ClickHouse connection string.
  * if @connection_string starts with 'clickhouse:' then connection string will be parsed
  * and converted into a set of arguments for the client.
- * Connection string format is similar to URI "clickhouse:[//[user_info@][hosts_and_ports]][/dbname][?query_parameters]"
+ * Connection string format is similar to URI "clickhouse:[//[user[:password]@][hosts_and_ports]][/dbname][?query_parameters]"
  * with the difference that hosts_and_ports can contain multiple hosts separated by ','.
  * example: clickhouse://user@host1:port1,host2:port2
- * @return returns true if there is a URI, false otherwise.
- * @exception throws DB::Exception if URI has valid scheme (clickhouse:), but invalid internals.
+ * @return Returns false if no connection string was specified. If a connection string was specified, returns true if it is valid, and throws an exception if it is invalid.
+ * @exception Throws DB::Exception if URI has valid scheme (clickhouse:), but invalid internals.
 */
 bool tryParseConnectionString(
     std::string_view connection_string,
     std::vector<std::string> & common_arguments,
     std::vector<std::vector<std::string>> & hosts_and_ports_arguments);
 
-// throws DB::Exception with BAD_ARGUMENTS if the given command line argument is allowed
-// to be used with the connection string
-void validateConnectionStringClientOption(std::string_view command_line_option);
+// Throws DB::Exception with BAD_ARGUMENTS if the given command line argument
+// is not allowed to be used with a connection string.
+void checkIfCmdLineOptionCanBeUsedWithConnectionString(std::string_view command_line_option);
 
 }
diff --git a/tests/queries/0_stateless/02784_connection_string.sh b/tests/queries/0_stateless/02784_connection_string.sh
index 042f5b2108d..8353ac5b1e4 100755
--- a/tests/queries/0_stateless/02784_connection_string.sh
+++ b/tests/queries/0_stateless/02784_connection_string.sh
@@ -99,7 +99,6 @@ runClient "click_house:" 2>&1 | grep -o 'BAD_ARGUMENTS'
 TEST_INDEX=1000087
 # Using connection string prohibits to use --host and --port options
 runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
-runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://default:@$CLICKHOUSE_HOST:$CLICKHOUSE_PORT_TCP/" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
@@ -109,6 +108,7 @@ runClient "clickhouse://default:@$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP
 runClient "clickhouse://$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://:@$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://$CLICKHOUSE_HOST/" --port "$CLICKHOUSE_PORT_TCP" 2>&1 | grep -o 'BAD_ARGUMENTS'
+runClient "clickhouse://" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse:" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse:///" --port "$CLICKHOUSE_PORT_TCP" --host "$CLICKHOUSE_HOST" 2>&1 | grep -o 'BAD_ARGUMENTS'
@@ -130,9 +130,9 @@ runClient "clickhouse://host1/ database:" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://user :password@host1" 2>&1 | grep -o 'BAD_ARGUMENTS'
 runClient "clickhouse://user: password@host1" 2>&1 | grep -o 'BAD_ARGUMENTS'
 
-# Query is not first argument
+# Connection string is not first argument
 runClient --multiline "clickhouse://default:@$CLICKHOUSE_HOST/" 2>&1 | grep -o 'BAD_ARGUMENTS'
-# Query used as the first and the second argument of client
+# Connection string used as the first and the second argument of client
 runClient "clickhouse://default:@$CLICKHOUSE_HOST/" "clickhouse://default:@$CLICKHOUSE_HOST/" 2>&1 | grep -o 'BAD_ARGUMENTS'
 
 # Invalid hosts

From 29b9cba75c18e23f9ee2eb589e5a69e7f46a5054 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 14 Jun 2023 11:31:09 +1000
Subject: [PATCH 417/722] Update CMakeLists.txt with help from Nikita

---
 contrib/arrow-cmake/CMakeLists.txt | 68 +++++++++++++++++++++++-------
 1 file changed, 52 insertions(+), 16 deletions(-)

diff --git a/contrib/arrow-cmake/CMakeLists.txt b/contrib/arrow-cmake/CMakeLists.txt
index 16198887075..5fe942d1cd0 100644
--- a/contrib/arrow-cmake/CMakeLists.txt
+++ b/contrib/arrow-cmake/CMakeLists.txt
@@ -116,43 +116,79 @@ configure_file("${ORC_SOURCE_SRC_DIR}/Adaptor.hh.in" "${ORC_BUILD_INCLUDE_DIR}/A
 # ARROW_ORC + adapters/orc/CMakefiles
 set(ORC_SRCS
         "${CMAKE_CURRENT_BINARY_DIR}/orc_proto.pb.h"
-        "${ORC_SOURCE_SRC_DIR}/sargs/ExpressionTree.cc"
-        "${ORC_SOURCE_SRC_DIR}/sargs/Literal.cc"
-        "${ORC_SOURCE_SRC_DIR}/sargs/PredicateLeaf.cc"
-        "${ORC_SOURCE_SRC_DIR}/sargs/SargsApplier.cc"
-        "${ORC_SOURCE_SRC_DIR}/sargs/SearchArgument.cc"
-        "${ORC_SOURCE_SRC_DIR}/sargs/TruthValue.cc"
-        "${ORC_SOURCE_SRC_DIR}/Exceptions.cc"
-        "${ORC_SOURCE_SRC_DIR}/OrcFile.cc"
-        "${ORC_SOURCE_SRC_DIR}/Reader.cc"
+        "${ORC_ADDITION_SOURCE_DIR}/orc_proto.pb.cc"
+        "${ORC_SOURCE_SRC_DIR}/Adaptor.cc"
+        "${ORC_SOURCE_SRC_DIR}/Adaptor.hh.in"
+        "${ORC_SOURCE_SRC_DIR}/BlockBuffer.cc"
+        "${ORC_SOURCE_SRC_DIR}/BlockBuffer.hh"
+        "${ORC_SOURCE_SRC_DIR}/BloomFilter.cc"
+        "${ORC_SOURCE_SRC_DIR}/BloomFilter.hh"
+        "${ORC_SOURCE_SRC_DIR}/Bpacking.hh"
+        "${ORC_SOURCE_SRC_DIR}/BpackingDefault.cc"
+        "${ORC_SOURCE_SRC_DIR}/BpackingDefault.hh"
         "${ORC_SOURCE_SRC_DIR}/ByteRLE.cc"
+        "${ORC_SOURCE_SRC_DIR}/ByteRLE.hh"
+        "${ORC_SOURCE_SRC_DIR}/CMakeLists.txt"
         "${ORC_SOURCE_SRC_DIR}/ColumnPrinter.cc"
         "${ORC_SOURCE_SRC_DIR}/ColumnReader.cc"
+        "${ORC_SOURCE_SRC_DIR}/ColumnReader.hh"
         "${ORC_SOURCE_SRC_DIR}/ColumnWriter.cc"
+        "${ORC_SOURCE_SRC_DIR}/ColumnWriter.hh"
         "${ORC_SOURCE_SRC_DIR}/Common.cc"
         "${ORC_SOURCE_SRC_DIR}/Compression.cc"
+        "${ORC_SOURCE_SRC_DIR}/Compression.hh"
+        "${ORC_SOURCE_SRC_DIR}/ConvertColumnReader.cc"
+        "${ORC_SOURCE_SRC_DIR}/ConvertColumnReader.hh"
+        "${ORC_SOURCE_SRC_DIR}/CpuInfoUtil.cc"
+        "${ORC_SOURCE_SRC_DIR}/CpuInfoUtil.hh"
+        "${ORC_SOURCE_SRC_DIR}/Dispatch.hh"
+        "${ORC_SOURCE_SRC_DIR}/Exceptions.cc"
         "${ORC_SOURCE_SRC_DIR}/Int128.cc"
         "${ORC_SOURCE_SRC_DIR}/LzoDecompressor.cc"
+        "${ORC_SOURCE_SRC_DIR}/LzoDecompressor.hh"
         "${ORC_SOURCE_SRC_DIR}/MemoryPool.cc"
+        "${ORC_SOURCE_SRC_DIR}/Murmur3.cc"
+        "${ORC_SOURCE_SRC_DIR}/Murmur3.hh"
+        "${ORC_SOURCE_SRC_DIR}/Options.hh"
+        "${ORC_SOURCE_SRC_DIR}/OrcFile.cc"
         "${ORC_SOURCE_SRC_DIR}/RLE.cc"
+        "${ORC_SOURCE_SRC_DIR}/RLE.hh"
+        "${ORC_SOURCE_SRC_DIR}/RLEV2Util.cc"
+        "${ORC_SOURCE_SRC_DIR}/RLEV2Util.hh"
         "${ORC_SOURCE_SRC_DIR}/RLEv1.cc"
+        "${ORC_SOURCE_SRC_DIR}/RLEv1.hh"
+        "${ORC_SOURCE_SRC_DIR}/RLEv2.hh"
+        "${ORC_SOURCE_SRC_DIR}/Reader.cc"
+        "${ORC_SOURCE_SRC_DIR}/Reader.hh"
         "${ORC_SOURCE_SRC_DIR}/RleDecoderV2.cc"
         "${ORC_SOURCE_SRC_DIR}/RleEncoderV2.cc"
-        "${ORC_SOURCE_SRC_DIR}/RLEV2Util.cc"
+        "${ORC_SOURCE_SRC_DIR}/SchemaEvolution.cc"
+        "${ORC_SOURCE_SRC_DIR}/SchemaEvolution.hh"
         "${ORC_SOURCE_SRC_DIR}/Statistics.cc"
+        "${ORC_SOURCE_SRC_DIR}/Statistics.hh"
         "${ORC_SOURCE_SRC_DIR}/StripeStream.cc"
+        "${ORC_SOURCE_SRC_DIR}/StripeStream.hh"
         "${ORC_SOURCE_SRC_DIR}/Timezone.cc"
+        "${ORC_SOURCE_SRC_DIR}/Timezone.hh"
         "${ORC_SOURCE_SRC_DIR}/TypeImpl.cc"
+        "${ORC_SOURCE_SRC_DIR}/TypeImpl.hh"
+        "${ORC_SOURCE_SRC_DIR}/Utils.hh"
         "${ORC_SOURCE_SRC_DIR}/Vector.cc"
         "${ORC_SOURCE_SRC_DIR}/Writer.cc"
-        "${ORC_SOURCE_SRC_DIR}/Adaptor.cc"
-        "${ORC_SOURCE_SRC_DIR}/BloomFilter.cc"
-        "${ORC_SOURCE_SRC_DIR}/Murmur3.cc"
-        "${ORC_SOURCE_SRC_DIR}/BlockBuffer.cc"
-        "${ORC_SOURCE_SRC_DIR}/wrap/orc-proto-wrapper.cc"
         "${ORC_SOURCE_SRC_DIR}/io/InputStream.cc"
+        "${ORC_SOURCE_SRC_DIR}/io/InputStream.hh"
         "${ORC_SOURCE_SRC_DIR}/io/OutputStream.cc"
-        "${ORC_ADDITION_SOURCE_DIR}/orc_proto.pb.cc"
+        "${ORC_SOURCE_SRC_DIR}/io/OutputStream.hh"
+        "${ORC_SOURCE_SRC_DIR}/sargs/ExpressionTree.cc"
+        "${ORC_SOURCE_SRC_DIR}/sargs/ExpressionTree.hh"
+        "${ORC_SOURCE_SRC_DIR}/sargs/Literal.cc"
+        "${ORC_SOURCE_SRC_DIR}/sargs/PredicateLeaf.cc"
+        "${ORC_SOURCE_SRC_DIR}/sargs/PredicateLeaf.hh"
+        "${ORC_SOURCE_SRC_DIR}/sargs/SargsApplier.cc"
+        "${ORC_SOURCE_SRC_DIR}/sargs/SargsApplier.hh"
+        "${ORC_SOURCE_SRC_DIR}/sargs/SearchArgument.cc"
+        "${ORC_SOURCE_SRC_DIR}/sargs/SearchArgument.hh"
+        "${ORC_SOURCE_SRC_DIR}/sargs/TruthValue.cc"
         )
 
 add_library(_orc ${ORC_SRCS})

From 1f76d0874398f4985bb00dd16caf68a772c95502 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 14 Jun 2023 01:37:58 +0000
Subject: [PATCH 418/722] fixed --password "" --password issue

---
 programs/client/Client.cpp                         | 14 +++++++-------
 .../01317_no_password_in_command_line.reference    |  1 +
 .../01317_no_password_in_command_line.sh           |  2 ++
 3 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 32a07284d26..1e2696b4910 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -977,13 +977,7 @@ void Client::addOptions(OptionsDescription & options_description)
         ("connection", po::value<std::string>(), "connection to use (from the client config), by default connection name is hostname")
         ("secure,s", "Use TLS connection")
         ("user,u", po::value<std::string>()->default_value("default"), "user")
-        /** If "--password [value]" is used but the value is omitted, the bad argument exception will be thrown.
-            * implicit_value is used to avoid this exception (to allow user to type just "--password")
-            * Since currently boost provides no way to check if a value has been set implicitly for an option,
-            * the "\n" is used to distinguish this case because there is hardly a chance a user would use "\n"
-            * as the password.
-            */
-        ("password", po::value<std::string>()->implicit_value("\n", ""), "password")
+        ("password", po::value<std::string>(), "password")
         ("ask-password", "ask-password")
         ("quota_key", po::value<std::string>(), "A string to differentiate quotas when the user have keyed quotas configured on server")
 
@@ -1391,6 +1385,12 @@ void Client::readArguments(
                 arg = argv[arg_num];
                 addMultiquery(arg, common_arguments);
             }
+            else if (arg == "--password" && ((arg_num + 1) >= argc || std::string_view(argv[arg_num + 1]).starts_with('-')))
+            {
+                common_arguments.emplace_back(arg);
+                // Add implicit value to the password. '\n' means client should ask user for password.
+                common_arguments.emplace_back("\n");
+            }
             else
                 common_arguments.emplace_back(arg);
         }
diff --git a/tests/queries/0_stateless/01317_no_password_in_command_line.reference b/tests/queries/0_stateless/01317_no_password_in_command_line.reference
index e69de29bb2d..8f2f637d5e3 100644
--- a/tests/queries/0_stateless/01317_no_password_in_command_line.reference
+++ b/tests/queries/0_stateless/01317_no_password_in_command_line.reference
@@ -0,0 +1 @@
+Bad arguments
diff --git a/tests/queries/0_stateless/01317_no_password_in_command_line.sh b/tests/queries/0_stateless/01317_no_password_in_command_line.sh
index 7f2e91201a3..fc5b8997636 100755
--- a/tests/queries/0_stateless/01317_no_password_in_command_line.sh
+++ b/tests/queries/0_stateless/01317_no_password_in_command_line.sh
@@ -45,3 +45,5 @@ ps u --no-header $bg_query | grep -F -- '--password' | grep -F hello ||:
 grep -F -- '--password' < "/proc/$bg_query/comm" | grep -F hello ||:
 $CLICKHOUSE_CLIENT --format Null --param_query_id "$query_id" -q "KILL QUERY WHERE query_id = {query_id:String} SYNC"
 wait
+
+$CLICKHOUSE_CLIENT --user "$user" --password=hello --password -q 'select currentUser()' 2>&1 | grep -o 'Bad arguments'

From f3b99156aca66e5df89181d224ae05a28f80f257 Mon Sep 17 00:00:00 2001
From: kevinyhzou <kevinyunhe8@gmail.com>
Date: Wed, 14 Jun 2023 10:48:21 +0800
Subject: [PATCH 419/722] review fix

---
 docs/en/interfaces/formats.md                 |  2 +-
 .../operations/settings/settings-formats.md   |  8 ++--
 src/Core/Settings.h                           |  2 +-
 src/Formats/FormatFactory.cpp                 |  2 +-
 src/Formats/FormatSettings.h                  |  2 +-
 .../Formats/Impl/CSVRowInputFormat.cpp        | 38 ++++++++++---------
 ...ext_with_whitespace_tab_field_delimiter.sh |  4 +-
 7 files changed, 31 insertions(+), 27 deletions(-)

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index 57962c1d730..da1ba17cbb7 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -468,7 +468,7 @@ The CSV format supports the output of totals and extremes the same way as `TabSe
 - [input_format_csv_skip_first_lines](/docs/en/operations/settings/settings-formats.md/#input_format_csv_skip_first_lines) - skip the specified number of lines at the beginning of data. Default value - `0`.
 - [input_format_csv_detect_header](/docs/en/operations/settings/settings-formats.md/#input_format_csv_detect_header) - automatically detect header with names and types in CSV format. Default value - `true`.
 - [input_format_csv_trim_whitespaces](/docs/en/operations/settings/settings-formats.md/#input_format_csv_trim_whitespaces) - trim spaces and tabs in non-quoted CSV strings. Default value - `true`.
-- [input_format_csv_use_whitespace_tab_as_delimiter](/docs/en/operations/settings/settings-formats.md/# input_format_csv_use_whitespace_tab_as_delimiter) - use whitespace or tab as field delimiter in CSV strings. Default value - `false`.
+- [input_format_csv_allow_whitespace_or_tab_as_delimiter](/docs/en/operations/settings/settings-formats.md/# input_format_csv_allow_whitespace_or_tab_as_delimiter) - Allow to use whitespace or tab as field delimiter in CSV strings. Default value - `false`.
 
 ## CSVWithNames {#csvwithnames}
 
diff --git a/docs/en/operations/settings/settings-formats.md b/docs/en/operations/settings/settings-formats.md
index 0e30c8f319e..daf27622d3a 100644
--- a/docs/en/operations/settings/settings-formats.md
+++ b/docs/en/operations/settings/settings-formats.md
@@ -914,9 +914,9 @@ Result
 "  string  "
 ```
 
-### input_format_csv_use_whitespace_tab_as_delimiter {#input_format_csv_use_whitespace_tab_as_delimiter}
+### input_format_csv_allow_whitespace_or_tab_as_delimiter {#input_format_csv_allow_whitespace_or_tab_as_delimiter}
 
-Use whitespace or tab as field delimiter in CSV strings.
+Allow to use whitespace or tab as field delimiter in CSV strings.
 
 Default value: `false`.
 
@@ -925,7 +925,7 @@ Default value: `false`.
 Query
 
 ```bash
-echo 'a b' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_use_whitespace_tab_as_delimiter=true --format_csv_delimiter=' '
+echo 'a b' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_allow_whitespace_or_tab_as_delimiter=true --format_csv_delimiter=' '
 ```
 
 Result
@@ -937,7 +937,7 @@ a  b
 Query
 
 ```bash
-echo 'a         b' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_use_whitespace_tab_as_delimiter=true --format_csv_delimiter='\t'
+echo 'a         b' | ./clickhouse local -q  "select * from table FORMAT CSV" --input-format="CSV" --input_format_csv_allow_whitespace_or_tab_as_delimiter=true --format_csv_delimiter='\t'
 ```
 
 Result
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 4306ac855a3..1d889d8b0c3 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -850,7 +850,7 @@ class IColumn;
     M(Bool, input_format_csv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in CSV format", 0) \
     M(Bool, input_format_tsv_use_best_effort_in_schema_inference, true, "Use some tweaks and heuristics to infer schema in TSV format", 0) \
     M(Bool, input_format_csv_detect_header, true, "Automatically detect header with names and types in CSV format", 0) \
-    M(Bool, input_format_csv_use_whitespace_tab_as_delimiter, false, "Use spaces and tabs(\\t) as field delimiter in the CSV strings", 0) \
+    M(Bool, input_format_csv_allow_whitespace_or_tab_as_delimiter, false, "Allow to use spaces and tabs(\\t) as field delimiter in the CSV strings", 0) \
     M(Bool, input_format_csv_trim_whitespaces, true, "Trims spaces and tabs (\\t) characters at the beginning and end in CSV strings", 0) \
     M(Bool, input_format_tsv_detect_header, true, "Automatically detect header with names and types in TSV format", 0) \
     M(Bool, input_format_custom_detect_header, true, "Automatically detect header with names and types in CustomSeparated format", 0) \
diff --git a/src/Formats/FormatFactory.cpp b/src/Formats/FormatFactory.cpp
index 33ecddfc223..81528937b13 100644
--- a/src/Formats/FormatFactory.cpp
+++ b/src/Formats/FormatFactory.cpp
@@ -70,7 +70,7 @@ FormatSettings getFormatSettings(ContextPtr context, const Settings & settings)
     format_settings.csv.skip_first_lines = settings.input_format_csv_skip_first_lines;
     format_settings.csv.try_detect_header = settings.input_format_csv_detect_header;
     format_settings.csv.trim_whitespaces = settings.input_format_csv_trim_whitespaces;
-    format_settings.csv.use_whitespace_tab_as_delimiter = settings.input_format_csv_use_whitespace_tab_as_delimiter;
+    format_settings.csv.allow_whitespace_or_tab_as_delimiter = settings.input_format_csv_allow_whitespace_or_tab_as_delimiter;
     format_settings.hive_text.fields_delimiter = settings.input_format_hive_text_fields_delimiter;
     format_settings.hive_text.collection_items_delimiter = settings.input_format_hive_text_collection_items_delimiter;
     format_settings.hive_text.map_keys_delimiter = settings.input_format_hive_text_map_keys_delimiter;
diff --git a/src/Formats/FormatSettings.h b/src/Formats/FormatSettings.h
index 72d60e8423e..5dc1a14a12c 100644
--- a/src/Formats/FormatSettings.h
+++ b/src/Formats/FormatSettings.h
@@ -137,7 +137,7 @@ struct FormatSettings
         String custom_delimiter;
         bool try_detect_header = true;
         bool trim_whitespaces = true;
-        bool use_whitespace_tab_as_delimiter = false;
+        bool allow_whitespace_or_tab_as_delimiter = false;
     } csv;
 
     struct HiveText
diff --git a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
index b8d3413f863..181949b3bb7 100644
--- a/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
+++ b/src/Processors/Formats/Impl/CSVRowInputFormat.cpp
@@ -25,10 +25,14 @@ namespace ErrorCodes
 
 namespace
 {
-    void checkBadDelimiter(char delimiter, bool use_whitespace_tab_as_delimiter)
+    void checkBadDelimiter(char delimiter, bool allow_whitespace_or_tab_as_delimiter)
     {
+        if ((delimiter == ' ' || delimiter == '\t') && allow_whitespace_or_tab_as_delimiter)
+        {
+            return;
+        }
         constexpr std::string_view bad_delimiters = " \t\"'.UL";
-        if (bad_delimiters.find(delimiter) != std::string_view::npos && !use_whitespace_tab_as_delimiter)
+        if (bad_delimiters.find(delimiter) != std::string_view::npos)
             throw Exception(
                 ErrorCodes::BAD_ARGUMENTS,
                 "CSV format may not work correctly with delimiter '{}'. Try use CustomSeparated format instead",
@@ -68,7 +72,7 @@ CSVRowInputFormat::CSVRowInputFormat(
         format_settings_.csv.try_detect_header),
     buf(std::move(in_))
 {
-    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.use_whitespace_tab_as_delimiter);
+    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.allow_whitespace_or_tab_as_delimiter);
 }
 
 CSVRowInputFormat::CSVRowInputFormat(
@@ -90,7 +94,7 @@ CSVRowInputFormat::CSVRowInputFormat(
         format_settings_.csv.try_detect_header),
     buf(std::move(in_))
 {
-    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.use_whitespace_tab_as_delimiter);
+    checkBadDelimiter(format_settings_.csv.delimiter, format_settings_.csv.allow_whitespace_or_tab_as_delimiter);
 }
 
 void CSVRowInputFormat::syncAfterError()
@@ -134,9 +138,9 @@ static void skipEndOfLine(ReadBuffer & in)
 }
 
 /// Skip `whitespace` symbols allowed in CSV.
-static inline void skipWhitespacesAndTabs(ReadBuffer & in, const bool & use_whitespace_tab_as_delimiter)
+static inline void skipWhitespacesAndTabs(ReadBuffer & in, const bool & allow_whitespace_or_tab_as_delimiter)
 {
-    if (use_whitespace_tab_as_delimiter)
+    if (allow_whitespace_or_tab_as_delimiter)
     {
         return;
     }
@@ -150,7 +154,7 @@ CSVFormatReader::CSVFormatReader(PeekableReadBuffer & buf_, const FormatSettings
 
 void CSVFormatReader::skipFieldDelimiter()
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
     assertChar(format_settings.csv.delimiter, *buf);
 }
 
@@ -158,7 +162,7 @@ template <bool read_string>
 String CSVFormatReader::readCSVFieldIntoString()
 {
     if (format_settings.csv.trim_whitespaces) [[likely]]
-        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
 
     String field;
     if constexpr (read_string)
@@ -170,14 +174,14 @@ String CSVFormatReader::readCSVFieldIntoString()
 
 void CSVFormatReader::skipField()
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
     NullOutput out;
     readCSVStringInto(out, *buf, format_settings.csv);
 }
 
 void CSVFormatReader::skipRowEndDelimiter()
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
 
     if (buf->eof())
         return;
@@ -186,7 +190,7 @@ void CSVFormatReader::skipRowEndDelimiter()
     if (*buf->position() == format_settings.csv.delimiter)
         ++buf->position();
 
-    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
     if (buf->eof())
         return;
 
@@ -198,7 +202,7 @@ void CSVFormatReader::skipHeaderRow()
     do
     {
         skipField();
-        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
     } while (checkChar(format_settings.csv.delimiter, *buf));
 
     skipRowEndDelimiter();
@@ -211,7 +215,7 @@ std::vector<String> CSVFormatReader::readRowImpl()
     do
     {
         fields.push_back(readCSVFieldIntoString<is_header>());
-        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
     } while (checkChar(format_settings.csv.delimiter, *buf));
 
     skipRowEndDelimiter();
@@ -224,7 +228,7 @@ bool CSVFormatReader::parseFieldDelimiterWithDiagnosticInfo(WriteBuffer & out)
 
     try
     {
-        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
         assertChar(delimiter, *buf);
     }
     catch (const DB::Exception &)
@@ -250,7 +254,7 @@ bool CSVFormatReader::parseFieldDelimiterWithDiagnosticInfo(WriteBuffer & out)
 
 bool CSVFormatReader::parseRowEndWithDiagnosticInfo(WriteBuffer & out)
 {
-    skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+    skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
 
     if (buf->eof())
         return true;
@@ -259,7 +263,7 @@ bool CSVFormatReader::parseRowEndWithDiagnosticInfo(WriteBuffer & out)
     if (*buf->position() == format_settings.csv.delimiter)
     {
         ++buf->position();
-        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
         if (buf->eof())
             return true;
     }
@@ -287,7 +291,7 @@ bool CSVFormatReader::readField(
     const String & /*column_name*/)
 {
     if (format_settings.csv.trim_whitespaces || !isStringOrFixedString(removeNullable(type))) [[likely]]
-        skipWhitespacesAndTabs(*buf, format_settings.csv.use_whitespace_tab_as_delimiter);
+        skipWhitespacesAndTabs(*buf, format_settings.csv.allow_whitespace_or_tab_as_delimiter);
 
     const bool at_delimiter = !buf->eof() && *buf->position() == format_settings.csv.delimiter;
     const bool at_last_column_line_end = is_last_file_column && (buf->eof() || *buf->position() == '\n' || *buf->position() == '\r');
diff --git a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
index deb6e317aac..6fca95cb839 100755
--- a/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
+++ b/tests/queries/0_stateless/02785_text_with_whitespace_tab_field_delimiter.sh
@@ -10,8 +10,8 @@ $CLICKHOUSE_CLIENT -q "drop table if exists test_whitespace"
 $CLICKHOUSE_CLIENT -q "drop table if exists test_tab"
 $CLICKHOUSE_CLIENT -q "create table test_whitespace (x UInt32, y String, z String) engine=MergeTree order by x"
 $CLICKHOUSE_CLIENT -q "create table test_tab (x UInt32, y String, z String) engine=MergeTree order by x"
-cat $CURDIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_use_whitespace_tab_as_delimiter=true FORMAT CSV"
-cat $CURDIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_use_whitespace_tab_as_delimiter=true FORMAT CSV"
+cat $CURDIR/data_csv/csv_with_space_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_whitespace SETTINGS format_csv_delimiter=' ', input_format_csv_allow_whitespace_or_tab_as_delimiter=true FORMAT CSV"
+cat $CURDIR/data_csv/csv_with_tab_delimiter.csv | ${CLICKHOUSE_CLIENT} -q "INSERT INTO test_tab SETTINGS format_csv_delimiter='\t', input_format_csv_allow_whitespace_or_tab_as_delimiter=true FORMAT CSV"
 $CLICKHOUSE_CLIENT -q "select * from test_whitespace"
 $CLICKHOUSE_CLIENT -q "select * from test_tab"
 $CLICKHOUSE_CLIENT -q "drop table test_whitespace"

From 6ffdfb8b6b8656dfb2ef004349a3cad82dd03e1f Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 14 Jun 2023 13:29:05 +1000
Subject: [PATCH 420/722] test removing CpuInfoUtil.cc and see if build breaks
 :p

---
 contrib/arrow-cmake/CMakeLists.txt | 2 --
 1 file changed, 2 deletions(-)

diff --git a/contrib/arrow-cmake/CMakeLists.txt b/contrib/arrow-cmake/CMakeLists.txt
index 5fe942d1cd0..01e9fc5fca9 100644
--- a/contrib/arrow-cmake/CMakeLists.txt
+++ b/contrib/arrow-cmake/CMakeLists.txt
@@ -139,8 +139,6 @@ set(ORC_SRCS
         "${ORC_SOURCE_SRC_DIR}/Compression.hh"
         "${ORC_SOURCE_SRC_DIR}/ConvertColumnReader.cc"
         "${ORC_SOURCE_SRC_DIR}/ConvertColumnReader.hh"
-        "${ORC_SOURCE_SRC_DIR}/CpuInfoUtil.cc"
-        "${ORC_SOURCE_SRC_DIR}/CpuInfoUtil.hh"
         "${ORC_SOURCE_SRC_DIR}/Dispatch.hh"
         "${ORC_SOURCE_SRC_DIR}/Exceptions.cc"
         "${ORC_SOURCE_SRC_DIR}/Int128.cc"

From 868c3bd45d8585b03a9afce76e0e7466e675c420 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 14 Jun 2023 04:29:08 +0000
Subject: [PATCH 421/722] minor change

---
 src/Client/ConnectionString.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Client/ConnectionString.cpp b/src/Client/ConnectionString.cpp
index 62090487490..f4a4e73c198 100644
--- a/src/Client/ConnectionString.cpp
+++ b/src/Client/ConnectionString.cpp
@@ -45,7 +45,7 @@ std::string uriDecode(const std::string & uri_encoded_string, bool plus_as_space
 void getHostAndPort(const Poco::URI & uri, std::vector<std::vector<std::string>> & hosts_and_ports_arguments)
 {
     std::vector<std::string> host_and_port;
-    const auto& host = uri.getHost();
+    const std::string & host = uri.getHost();
     if (!host.empty())
     {
         host_and_port.push_back("--host=" + uriDecode(host, false));

From e281026e0085048e8d35d8cca78cc346501ee974 Mon Sep 17 00:00:00 2001
From: Chang Chen <baibaichen@gmail.com>
Date: Wed, 14 Jun 2023 12:29:55 +0800
Subject: [PATCH 422/722] fix build issue on clang 15

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index b306cca4f94..8373c95599f 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -751,7 +751,7 @@ namespace
     private:
         using Reader = typename CapnpType::Reader;
 
-        CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
+        typename CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
         {
             auto data = column->getDataAt(row_num);
             if constexpr (std::is_same_v<CapnpType, capnp::Data>)
@@ -801,7 +801,7 @@ namespace
     private:
         using Reader = typename CapnpType::Reader;
 
-        CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
+        typename CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
         {
             auto data = column->getDataAt(row_num);
             if constexpr (std::is_same_v<CapnpType, capnp::Data>)

From 4db8fa39c7904661a7aac6aa62ee4f0e44092369 Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 14 Jun 2023 04:38:46 +0000
Subject: [PATCH 423/722] Removed extra lines

---
 docs/en/interfaces/cli.md | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/docs/en/interfaces/cli.md b/docs/en/interfaces/cli.md
index e2c7dc1e608..8779dd1a544 100644
--- a/docs/en/interfaces/cli.md
+++ b/docs/en/interfaces/cli.md
@@ -228,9 +228,6 @@ clickhouse://[2001:db8::1234]
 
 URI allows multiple hosts to be connected to. Connection strings can contain multiple hosts. ClickHouse-client will try to connect to these hosts in order (i.e. from left to right). After the connection is established, no attempt to connect to the remaining hosts is made.
 
-
-
-
 The connection string must be specified as the first argument of clickhouse-client. The connection string can be combined with arbitrary other [command-line-options](#command-line-options) except `--host/-h` and `--port`.
 
 The following keys are allowed for component `query_parameter`:

From 08cd94e826ce6af55135517d8abcbc72f4b270fb Mon Sep 17 00:00:00 2001
From: Derek Chia <derek.chia@clickhouse.com>
Date: Wed, 14 Jun 2023 12:57:50 +0800
Subject: [PATCH 424/722] Update delete.md

LWD is not supported in table with projection
---
 docs/en/sql-reference/statements/delete.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/en/sql-reference/statements/delete.md b/docs/en/sql-reference/statements/delete.md
index fa9f08e225f..5522c50d624 100644
--- a/docs/en/sql-reference/statements/delete.md
+++ b/docs/en/sql-reference/statements/delete.md
@@ -55,6 +55,9 @@ With the described implementation now we can see what can negatively affect 'DEL
 - Table having a very large number of data parts
 - Having a lot of data in Compact parts—in a Compact part, all columns are stored in one file.
 
+:::note
+Lightweight delete does not work for tables with projection as rows in projection may be affected and require the projection to be rebuilt. Rebuilding projection makes the deletion not lightweight, so this is not supported. 
+:::
 
 ## Related content
 

From f74c585426f0f6dd7f2ce440193cda2c43a9f9d9 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 14 Jun 2023 07:46:11 +0200
Subject: [PATCH 425/722] Typos

---
 .../0_stateless/02784_projections_read_in_order_bug.sql       | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql b/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
index 9595fc9ae08..6bf287a3d77 100644
--- a/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
+++ b/tests/queries/0_stateless/02784_projections_read_in_order_bug.sql
@@ -37,8 +37,8 @@ create table events (
             timestamp
     )) engine = MergeTree order by (organisation_id, session_id, timestamp) settings index_granularity = 3;
 
-insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0));
-insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0),  toDateTime('2022-02-02', 'UTC')(), toString(0), reinterpretAsUUID(0), toString(0));
+insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0));
+insert into events values (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(0), reinterpretAsUUID(1), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(1), reinterpretAsUUID(0), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0)), (reinterpretAsUUID(3), reinterpretAsUUID(2), reinterpretAsUUID(0), toDateTime('2022-02-02', 'UTC'), toString(0), reinterpretAsUUID(0), toString(0));
 
 set read_in_order_two_level_merge_threshold=1;
 SELECT id, timestamp, payload FROM events WHERE (organisation_id = reinterpretAsUUID(1)) AND (session_id = reinterpretAsUUID(0)) ORDER BY timestamp, payload, id ASC;

From 86694847c66a170781e5a561940c05e0221966d0 Mon Sep 17 00:00:00 2001
From: Chang Chen <baibaichen@gmail.com>
Date: Wed, 14 Jun 2023 15:22:32 +0800
Subject: [PATCH 426/722] using Reader instead of typename CapnpType::Reader

---
 src/Formats/CapnProtoSerializer.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Formats/CapnProtoSerializer.cpp b/src/Formats/CapnProtoSerializer.cpp
index 8373c95599f..6f7254ab2aa 100644
--- a/src/Formats/CapnProtoSerializer.cpp
+++ b/src/Formats/CapnProtoSerializer.cpp
@@ -751,7 +751,7 @@ namespace
     private:
         using Reader = typename CapnpType::Reader;
 
-        typename CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
+        Reader getData(const ColumnPtr & column, size_t row_num)
         {
             auto data = column->getDataAt(row_num);
             if constexpr (std::is_same_v<CapnpType, capnp::Data>)
@@ -801,7 +801,7 @@ namespace
     private:
         using Reader = typename CapnpType::Reader;
 
-        typename CapnpType::Reader getData(const ColumnPtr & column, size_t row_num)
+        Reader getData(const ColumnPtr & column, size_t row_num)
         {
             auto data = column->getDataAt(row_num);
             if constexpr (std::is_same_v<CapnpType, capnp::Data>)

From b1f0a91b788e2ef89cd5848168e8357d6da13f0a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 14 Jun 2023 07:48:08 +0000
Subject: [PATCH 427/722] Docs: Fix embedded video link

---
 docs/en/engines/table-engines/mergetree-family/annindexes.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index d8a0193ff66..80e47e76ce0 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -152,7 +152,7 @@ This type of ANN index implements [the Annoy algorithm](https://github.com/spoti
 space in random linear surfaces (lines in 2D, planes in 3D etc.).
 
 <div class='vimeo-container'>
-  <iframe src="//www.youtube.com/watch?v=QkCCyLW0ehU"
+  <iframe src="//www.youtube.com/embed/QkCCyLW0ehU"
     width="640"
     height="360"
     frameborder="0"

From f4cfb9e3705649a410bb92d703ef3c74865b6aec Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 14 Jun 2023 07:50:26 +0000
Subject: [PATCH 428/722] Fix line break

---
 docs/en/engines/table-engines/mergetree-family/annindexes.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/annindexes.md b/docs/en/engines/table-engines/mergetree-family/annindexes.md
index 80e47e76ce0..4a4ebb47bdc 100644
--- a/docs/en/engines/table-engines/mergetree-family/annindexes.md
+++ b/docs/en/engines/table-engines/mergetree-family/annindexes.md
@@ -131,7 +131,6 @@ The `GRANULARITY` parameter determines how many ANN sub-indexes are created. Big
 sub-indexes, up to the point where a column (or a column's data part) has only a single sub-index. In that case, the sub-index has a
 "global" view of all column rows and can directly return all granules of the column (part) with relevant rows (there are at most 
 `LIMIT [N]`-many such granules). In a second step, ClickHouse will load these granules and identify the actually best rows by performing a
-
 brute-force distance calculation over all rows of the granules. With a small `GRANULARITY` value, each of the sub-indexes returns up to
 `LIMIT N`-many granules. As a result, more granules need to be loaded and post-filtered. Note that the search accuracy is with both cases
 equally good, only the processing performance differs. It is generally recommended to use a large `GRANULARITY` for ANN indexes and fall

From ab6ac6beb19ae23d0676f7626c6fa9b72353de3e Mon Sep 17 00:00:00 2001
From: Nikolai Kochetov <nik-kochetov@yandex-team.ru>
Date: Wed, 14 Jun 2023 08:37:18 +0000
Subject: [PATCH 429/722] Fixing a test.

---
 .../0_stateless/02784_projections_read_in_order_bug.reference | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tests/queries/0_stateless/02784_projections_read_in_order_bug.reference b/tests/queries/0_stateless/02784_projections_read_in_order_bug.reference
index e69de29bb2d..6110bc68aae 100644
--- a/tests/queries/0_stateless/02784_projections_read_in_order_bug.reference
+++ b/tests/queries/0_stateless/02784_projections_read_in_order_bug.reference
@@ -0,0 +1,4 @@
+00000000-0000-0000-0000-000000000000	1643760000	0
+00000000-0000-0000-0000-000000000000	1643760000	0
+00000000-0000-0000-0000-000000000000	1643760000	0
+00000000-0000-0000-0000-000000000000	1643760000	0

From 197c76107eaa6ecd7ad00391d86854d7e8b3fcc8 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 14 Jun 2023 18:38:09 +1000
Subject: [PATCH 430/722] Re-added CpuInfoUtil to CMakeList.txt

---
 contrib/arrow-cmake/CMakeLists.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/contrib/arrow-cmake/CMakeLists.txt b/contrib/arrow-cmake/CMakeLists.txt
index 01e9fc5fca9..5fe942d1cd0 100644
--- a/contrib/arrow-cmake/CMakeLists.txt
+++ b/contrib/arrow-cmake/CMakeLists.txt
@@ -139,6 +139,8 @@ set(ORC_SRCS
         "${ORC_SOURCE_SRC_DIR}/Compression.hh"
         "${ORC_SOURCE_SRC_DIR}/ConvertColumnReader.cc"
         "${ORC_SOURCE_SRC_DIR}/ConvertColumnReader.hh"
+        "${ORC_SOURCE_SRC_DIR}/CpuInfoUtil.cc"
+        "${ORC_SOURCE_SRC_DIR}/CpuInfoUtil.hh"
         "${ORC_SOURCE_SRC_DIR}/Dispatch.hh"
         "${ORC_SOURCE_SRC_DIR}/Exceptions.cc"
         "${ORC_SOURCE_SRC_DIR}/Int128.cc"

From 2a3ef3941eb1bfd3ddb39378a8cb84a9b16d6b88 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 11:31:28 +0200
Subject: [PATCH 431/722] Fix

---
 .../DataLakes/IcebergMetadataParser.cpp       | 33 ++++++++++++-------
 1 file changed, 21 insertions(+), 12 deletions(-)

diff --git a/src/Storages/DataLakes/IcebergMetadataParser.cpp b/src/Storages/DataLakes/IcebergMetadataParser.cpp
index 144dace2fc1..42155b6cd24 100644
--- a/src/Storages/DataLakes/IcebergMetadataParser.cpp
+++ b/src/Storages/DataLakes/IcebergMetadataParser.cpp
@@ -184,11 +184,17 @@ struct IcebergMetadataParser<Configuration, MetadataReadHelper>::Impl
      * Manifest file has the following format: '/iceberg_data/db/table_name/metadata/c87bfec7-d36c-4075-ad04-600b6b0f2020-m0.avro'
      *
      * `manifest file` is different in format version V1 and V2 and has the following contents:
-     * Format version V1:
+     *                        v1     v2
+     * status                 req    req
+     * snapshot_id            req    opt
+     * sequence_number               opt
+     * file_sequence_number          opt
+     * data_file              req    req
+     * Example format version V1:
      * ┌─status─┬─────────snapshot_id─┬─data_file───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
      * │      1 │ 2819310504515118887 │ ('/iceberg_data/db/table_name/data/00000-1-3edca534-15a0-4f74-8a28-4733e0bf1270-00001.parquet','PARQUET',(),100,1070,67108864,[(1,233),(2,210)],[(1,100),(2,100)],[(1,0),(2,0)],[],[(1,'\0'),(2,'0')],[(1,'c'),(2,'99')],NULL,[4],0) │
      * └────────┴─────────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
-     * Format version V2:
+     * Example format version V2:
      * ┌─status─┬─────────snapshot_id─┬─sequence_number─┬─file_sequence_number─┬─data_file───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
      * │      1 │ 5887006101709926452 │            ᴺᵁᴸᴸ │                 ᴺᵁᴸᴸ │ (0,'/iceberg_data/db/table_name/data/00000-1-c8045c90-8799-4eac-b957-79a0484e223c-00001.parquet','PARQUET',(),100,1070,[(1,233),(2,210)],[(1,100),(2,100)],[(1,0),(2,0)],[],[(1,'\0'),(2,'0')],[(1,'c'),(2,'99')],NULL,[4],[],0) │
      * └────────┴─────────────────────┴─────────────────┴──────────────────────┴─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
@@ -209,22 +215,25 @@ struct IcebergMetadataParser<Configuration, MetadataReadHelper>::Impl
             auto buffer = MetadataReadHelper::createReadBuffer(manifest_file, context, configuration);
             auto file_reader = std::make_unique<avro::DataFileReaderBase>(std::make_unique<AvroInputStreamReadBufferAdapter>(*buffer));
 
-            avro::NodePtr node;
-            if (metadata.format_version == 1)
-                node = file_reader->dataSchema().root()->leafAt(2);
-            else if (metadata.format_version == 2)
-                node = file_reader->dataSchema().root()->leafAt(4);
-            else
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Unexpected format version: {}", metadata.format_version);
+            avro::NodePtr root_node = file_reader->dataSchema().root();
+            int leaves_num = static_cast<int>(root_node->leaves());
+            if (leaves_num < 2)
+            {
+                throw Exception(
+                    ErrorCodes::BAD_ARGUMENTS,
+                    "Unexpected number of columns {}. Expected at least 2",
+                    root_node->leaves());
+            }
 
-            if (node->type() != avro::Type::AVRO_RECORD)
+            avro::NodePtr data_file_node = root_node->leafAt(leaves_num - 1);
+            if (data_file_node->type() != avro::Type::AVRO_RECORD)
             {
                 throw Exception(
                     ErrorCodes::ILLEGAL_COLUMN,
                     "The parsed column from Avro file of `data_file` field should be Tuple type, got {}",
-                    node->type());
+                    data_file_node->type());
             }
-            auto data_type = AvroSchemaReader::avroNodeToDataType(node);
+            auto data_type = AvroSchemaReader::avroNodeToDataType(data_file_node);
             const auto columns = parseAvro(*file_reader, data_type, manifest_path, getFormatSettings(context));
             const auto col_tuple = typeid_cast<ColumnTuple *>(columns.at(0).get());
 

From 47a6db596e49034be1e1eed976cd95de31f71e70 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 11:37:57 +0200
Subject: [PATCH 432/722] Better

---
 src/Storages/DataLakes/IcebergMetadataParser.cpp | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/Storages/DataLakes/IcebergMetadataParser.cpp b/src/Storages/DataLakes/IcebergMetadataParser.cpp
index 42155b6cd24..3820bb08247 100644
--- a/src/Storages/DataLakes/IcebergMetadataParser.cpp
+++ b/src/Storages/DataLakes/IcebergMetadataParser.cpp
@@ -216,16 +216,17 @@ struct IcebergMetadataParser<Configuration, MetadataReadHelper>::Impl
             auto file_reader = std::make_unique<avro::DataFileReaderBase>(std::make_unique<AvroInputStreamReadBufferAdapter>(*buffer));
 
             avro::NodePtr root_node = file_reader->dataSchema().root();
-            int leaves_num = static_cast<int>(root_node->leaves());
-            if (leaves_num < 2)
+            size_t leaves_num = root_node->leaves();
+            size_t expected_min_num = metadata.format_version == 1 ? 3 : 2;
+            if (leaves_num < expected_min_num)
             {
                 throw Exception(
                     ErrorCodes::BAD_ARGUMENTS,
-                    "Unexpected number of columns {}. Expected at least 2",
-                    root_node->leaves());
+                    "Unexpected number of columns {}. Expected at least {}",
+                    root_node->leaves(), expected_min_num);
             }
 
-            avro::NodePtr data_file_node = root_node->leafAt(leaves_num - 1);
+            avro::NodePtr data_file_node = root_node->leafAt(static_cast<int>(leaves_num) - 1);
             if (data_file_node->type() != avro::Type::AVRO_RECORD)
             {
                 throw Exception(

From 827ac17dc2a882e6ef9a41080d6305f99090f48c Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 14 Jun 2023 12:59:06 +0200
Subject: [PATCH 433/722] Fix

---
 src/Storages/StorageS3.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 8bab596901c..4f649420a72 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -460,7 +460,7 @@ public:
         for (auto && key : all_keys)
         {
             std::optional<S3::ObjectInfo> info;
-            if (need_total_size)
+            if (need_total_size && all_keys.size() == 1)
             {
                 info = S3::getObjectInfo(client_, bucket, key, version_id_, request_settings_);
                 total_size += info->size;

From a00e42f75b97d4bd70857c7c67568aef371d58cb Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Wed, 14 Jun 2023 13:00:47 +0200
Subject: [PATCH 434/722] Fix erroneous sort_description propagation in
 CreatingSets (#50955)

---
 src/Processors/QueryPlan/CreatingSetsStep.cpp |  2 +-
 ...788_fix_logical_error_in_sorting.reference |  0
 .../02788_fix_logical_error_in_sorting.sql    | 77 +++++++++++++++++++
 3 files changed, 78 insertions(+), 1 deletion(-)
 create mode 100644 tests/queries/0_stateless/02788_fix_logical_error_in_sorting.reference
 create mode 100644 tests/queries/0_stateless/02788_fix_logical_error_in_sorting.sql

diff --git a/src/Processors/QueryPlan/CreatingSetsStep.cpp b/src/Processors/QueryPlan/CreatingSetsStep.cpp
index b5d773d889f..459092c88ad 100644
--- a/src/Processors/QueryPlan/CreatingSetsStep.cpp
+++ b/src/Processors/QueryPlan/CreatingSetsStep.cpp
@@ -80,7 +80,7 @@ CreatingSetsStep::CreatingSetsStep(DataStreams input_streams_)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "CreatingSetsStep cannot be created with no inputs");
 
     input_streams = std::move(input_streams_);
-    output_stream = input_streams.front();
+    output_stream = DataStream{input_streams.front().header};
 
     for (size_t i = 1; i < input_streams.size(); ++i)
         if (input_streams[i].header)
diff --git a/tests/queries/0_stateless/02788_fix_logical_error_in_sorting.reference b/tests/queries/0_stateless/02788_fix_logical_error_in_sorting.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02788_fix_logical_error_in_sorting.sql b/tests/queries/0_stateless/02788_fix_logical_error_in_sorting.sql
new file mode 100644
index 00000000000..1ff68191800
--- /dev/null
+++ b/tests/queries/0_stateless/02788_fix_logical_error_in_sorting.sql
@@ -0,0 +1,77 @@
+CREATE TABLE session_events
+(
+    clientId UInt64,
+    sessionId String,
+    pageId UInt64,
+    eventNumber UInt64,
+    timestamp UInt64,
+    type LowCardinality(String),
+    data String
+)
+ENGINE = MergeTree
+PARTITION BY toYYYYMM(toDate(pageId / 1000))
+ORDER BY (clientId, sessionId, pageId, timestamp);
+
+CREATE TABLE event_types
+(
+    type String,
+    active Int16
+)
+ENGINE = MergeTree
+PARTITION BY substring(type, 1, 1)
+ORDER BY (type, active);
+
+SYSTEM STOP MERGES session_events;
+SYSTEM STOP MERGES event_types;
+
+INSERT INTO session_events SELECT
+    141,
+    '693de636-6d9b-47b7-b52a-33bd303b6255',
+    1686053240314,
+    number,
+    number,
+    toString(number % 10),
+    ''
+FROM numbers_mt(100000);
+
+INSERT INTO session_events SELECT
+    141,
+    '693de636-6d9b-47b7-b52a-33bd303b6255',
+    1686053240314,
+    number,
+    number,
+    toString(number % 10),
+    ''
+FROM numbers_mt(100000);
+
+INSERT INTO event_types SELECT
+    toString(number % 10),
+    number % 2
+FROM numbers(20);
+
+SET optimize_sorting_by_input_stream_properties = 1;
+
+-- We check only that no exception was thrown
+EXPLAIN PIPELINE
+SELECT
+    pageId,
+    [prev_active_ts, timestamp] AS inactivity_timestamps,
+    timestamp - prev_active_ts AS inactive_duration,
+    timestamp
+FROM
+(
+    SELECT
+        pageId,
+        timestamp,
+        neighbor(timestamp, -1) AS prev_active_ts
+    FROM session_events
+    WHERE (type IN (
+        SELECT type
+        FROM event_types
+        WHERE active = 1
+    )) AND (sessionId = '693de636-6d9b-47b7-b52a-33bd303b6255') AND (session_events.clientId = 141) AND (pageId = 1686053240314)
+    ORDER BY timestamp ASC
+)
+WHERE runningDifference(timestamp) >= 500
+ORDER BY timestamp ASC
+FORMAT Null;

From e7c5991b39db0ea88842b1c58cef3b42c771fb0e Mon Sep 17 00:00:00 2001
From: Val Doroshchuk <valbok@gmail.com>
Date: Wed, 14 Jun 2023 13:19:26 +0200
Subject: [PATCH 435/722] MaterializedMySQL: Keep parenthesises for empty table
 overrides

Empty table overrides are formatted without any parenthesises,
but they are required by a parser,
and it is not possible to parse empty table overrides without it.

:) CREATE DATABASE db ... TABLE OVERRIDE t1()

CREATE DATABASE db
...
TABLE OVERRIDE `t1`

This query will be saved to metadata and ClickHouse will not be able to start up, since
table overrides require ().
---
 src/Parsers/ASTTableOverrides.cpp                    |  2 --
 src/Parsers/tests/gtest_Parser.cpp                   |  2 +-
 .../materialize_with_ddl.py                          | 12 ++++++++++++
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/src/Parsers/ASTTableOverrides.cpp b/src/Parsers/ASTTableOverrides.cpp
index af846a5dd43..ccb485f6c69 100644
--- a/src/Parsers/ASTTableOverrides.cpp
+++ b/src/Parsers/ASTTableOverrides.cpp
@@ -36,8 +36,6 @@ void ASTTableOverride::formatImpl(const FormatSettings & settings_, FormatState
         settings.ostr << hl_keyword << "TABLE OVERRIDE " << hl_none;
         ASTIdentifier(table_name).formatImpl(settings, state, frame);
     }
-    if (!columns && (!storage || storage->children.empty()))
-        return;
     auto override_frame = frame;
     if (is_standalone)
     {
diff --git a/src/Parsers/tests/gtest_Parser.cpp b/src/Parsers/tests/gtest_Parser.cpp
index 19872c4189a..2795de64b1d 100644
--- a/src/Parsers/tests/gtest_Parser.cpp
+++ b/src/Parsers/tests/gtest_Parser.cpp
@@ -215,7 +215,7 @@ INSTANTIATE_TEST_SUITE_P(ParserCreateDatabaseQuery, ParserTest,
         },
         {
             "CREATE DATABASE db ENGINE=Foo TABLE OVERRIDE `tbl` (), TABLE OVERRIDE a (COLUMNS (_created DateTime MATERIALIZED now())), TABLE OVERRIDE b (PARTITION BY rand())",
-            "CREATE DATABASE db\nENGINE = Foo\nTABLE OVERRIDE `tbl`,\nTABLE OVERRIDE `a`\n(\n    COLUMNS\n    (\n        `_created` DateTime MATERIALIZED now()\n    )\n),\nTABLE OVERRIDE `b`\n(\n    PARTITION BY rand()\n)"
+            "CREATE DATABASE db\nENGINE = Foo\nTABLE OVERRIDE `tbl`\n(\n\n),\nTABLE OVERRIDE `a`\n(\n    COLUMNS\n    (\n        `_created` DateTime MATERIALIZED now()\n    )\n),\nTABLE OVERRIDE `b`\n(\n    PARTITION BY rand()\n)"
         },
         {
             "CREATE DATABASE db ENGINE=MaterializeMySQL('addr:port', 'db', 'user', 'pw') TABLE OVERRIDE tbl (COLUMNS (id UUID) PARTITION BY toYYYYMM(created))",
diff --git a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
index f5c28832f79..5e846b6d907 100644
--- a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
+++ b/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
@@ -2031,6 +2031,18 @@ def table_overrides(clickhouse_node, mysql_node, service_name):
             f"{explain_with_table_func} {testcase[0]}"
         )
 
+    clickhouse_node.query("DROP DATABASE IF EXISTS table_overrides")
+    # Check empty table overrides
+    clickhouse_node.query(
+        f"""
+        CREATE DATABASE table_overrides ENGINE=MaterializeMySQL('{service_name}:3306', 'table_overrides', 'root', 'clickhouse')
+        TABLE OVERRIDE t1 ()
+    """
+    )
+    check_query(clickhouse_node, "SELECT count() FROM table_overrides.t1", "1001\n")
+    show_db = clickhouse_node.query("SHOW CREATE DATABASE table_overrides")
+    assert "TABLE OVERRIDE `t1`\\n(\\n\\n)" in show_db, show_db
+
     clickhouse_node.query("DROP DATABASE IF EXISTS table_overrides")
     mysql_node.query("DROP DATABASE IF EXISTS table_overrides")
 

From 7d59af1f776f9868f5b45c0c78e9e5a49d118dd3 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Wed, 14 Jun 2023 13:19:03 +0200
Subject: [PATCH 436/722] test compressed write to S3

---
 src/IO/BrotliWriteBuffer.cpp                  |  5 +---
 src/IO/BrotliWriteBuffer.h                    |  1 +
 src/IO/Bzip2WriteBuffer.cpp                   |  5 +---
 src/IO/LZMADeflatingWriteBuffer.cpp           |  5 ----
 src/IO/LZMADeflatingWriteBuffer.h             |  2 --
 src/IO/Lz4DeflatingWriteBuffer.cpp            | 15 +++++-----
 src/IO/Lz4DeflatingWriteBuffer.h              |  2 --
 src/IO/ZlibDeflatingWriteBuffer.cpp           | 12 --------
 src/IO/ZlibDeflatingWriteBuffer.h             |  2 --
 src/IO/ZstdDeflatingWriteBuffer.cpp           |  6 ----
 src/IO/ZstdDeflatingWriteBuffer.h             |  2 --
 .../test_checking_s3_blobs_paranoid/test.py   | 28 ++++++++++++-------
 12 files changed, 29 insertions(+), 56 deletions(-)

diff --git a/src/IO/BrotliWriteBuffer.cpp b/src/IO/BrotliWriteBuffer.cpp
index 47426d62a6e..a19c6770dad 100644
--- a/src/IO/BrotliWriteBuffer.cpp
+++ b/src/IO/BrotliWriteBuffer.cpp
@@ -42,10 +42,7 @@ BrotliWriteBuffer::BrotliWriteBuffer(std::unique_ptr<WriteBuffer> out_, int comp
     BrotliEncoderSetParameter(brotli->state, BROTLI_PARAM_LGWIN, 24);
 }
 
-BrotliWriteBuffer::~BrotliWriteBuffer()
-{
-    finalize();
-}
+BrotliWriteBuffer::~BrotliWriteBuffer() = default;
 
 void BrotliWriteBuffer::nextImpl()
 {
diff --git a/src/IO/BrotliWriteBuffer.h b/src/IO/BrotliWriteBuffer.h
index e03fa1507ba..8cbc78bd9e7 100644
--- a/src/IO/BrotliWriteBuffer.h
+++ b/src/IO/BrotliWriteBuffer.h
@@ -27,6 +27,7 @@ private:
     class BrotliStateWrapper;
     std::unique_ptr<BrotliStateWrapper> brotli;
 
+
     size_t in_available;
     const uint8_t * in_data;
 
diff --git a/src/IO/Bzip2WriteBuffer.cpp b/src/IO/Bzip2WriteBuffer.cpp
index 4b6bed70d35..b84cbdd1e41 100644
--- a/src/IO/Bzip2WriteBuffer.cpp
+++ b/src/IO/Bzip2WriteBuffer.cpp
@@ -45,10 +45,7 @@ Bzip2WriteBuffer::Bzip2WriteBuffer(std::unique_ptr<WriteBuffer> out_, int compre
 {
 }
 
-Bzip2WriteBuffer::~Bzip2WriteBuffer()
-{
-    finalize();
-}
+Bzip2WriteBuffer::~Bzip2WriteBuffer() = default;
 
 void Bzip2WriteBuffer::nextImpl()
 {
diff --git a/src/IO/LZMADeflatingWriteBuffer.cpp b/src/IO/LZMADeflatingWriteBuffer.cpp
index 30e247b1016..c534a247bc3 100644
--- a/src/IO/LZMADeflatingWriteBuffer.cpp
+++ b/src/IO/LZMADeflatingWriteBuffer.cpp
@@ -44,11 +44,6 @@ LZMADeflatingWriteBuffer::LZMADeflatingWriteBuffer(
             LZMA_VERSION_STRING);
 }
 
-LZMADeflatingWriteBuffer::~LZMADeflatingWriteBuffer()
-{
-    finalize();
-}
-
 void LZMADeflatingWriteBuffer::nextImpl()
 {
     if (!offset())
diff --git a/src/IO/LZMADeflatingWriteBuffer.h b/src/IO/LZMADeflatingWriteBuffer.h
index 2e135455e00..5a0864d6071 100644
--- a/src/IO/LZMADeflatingWriteBuffer.h
+++ b/src/IO/LZMADeflatingWriteBuffer.h
@@ -21,8 +21,6 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
-    ~LZMADeflatingWriteBuffer() override;
-
 private:
     void nextImpl() override;
 
diff --git a/src/IO/Lz4DeflatingWriteBuffer.cpp b/src/IO/Lz4DeflatingWriteBuffer.cpp
index c3a1b8282c3..32241cb3b1a 100644
--- a/src/IO/Lz4DeflatingWriteBuffer.cpp
+++ b/src/IO/Lz4DeflatingWriteBuffer.cpp
@@ -40,11 +40,6 @@ Lz4DeflatingWriteBuffer::Lz4DeflatingWriteBuffer(
             LZ4F_VERSION);
 }
 
-Lz4DeflatingWriteBuffer::~Lz4DeflatingWriteBuffer()
-{
-    finalize();
-}
-
 void Lz4DeflatingWriteBuffer::nextImpl()
 {
     if (!offset())
@@ -107,8 +102,14 @@ void Lz4DeflatingWriteBuffer::nextImpl()
             if (LZ4F_isError(compressed_size))
                 throw Exception(
                     ErrorCodes::LZ4_ENCODER_FAILED,
-                    "LZ4 failed to encode stream. LZ4F version: {}",
-                    LZ4F_VERSION);
+                    "LZ4 failed to encode stream. LZ4F version: {}, CodeName: {},"
+                    " in_capacity: {}, out_capacity: {}, cur_buffer_size: {}, min_compressed_block_size: {}",
+                    LZ4F_VERSION,
+                    LZ4F_getErrorName(compressed_size),
+                    in_capacity,
+                    out_capacity,
+                    cur_buffer_size,
+                    min_compressed_block_size);
 
             in_capacity -= cur_buffer_size;
             in_data = reinterpret_cast<void *>(working_buffer.end() - in_capacity);
diff --git a/src/IO/Lz4DeflatingWriteBuffer.h b/src/IO/Lz4DeflatingWriteBuffer.h
index 68873b5f8ee..a6440f8854f 100644
--- a/src/IO/Lz4DeflatingWriteBuffer.h
+++ b/src/IO/Lz4DeflatingWriteBuffer.h
@@ -21,8 +21,6 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
-    ~Lz4DeflatingWriteBuffer() override;
-
 private:
     void nextImpl() override;
 
diff --git a/src/IO/ZlibDeflatingWriteBuffer.cpp b/src/IO/ZlibDeflatingWriteBuffer.cpp
index 43bb0405555..d433bdbecd2 100644
--- a/src/IO/ZlibDeflatingWriteBuffer.cpp
+++ b/src/IO/ZlibDeflatingWriteBuffer.cpp
@@ -72,18 +72,6 @@ void ZlibDeflatingWriteBuffer::nextImpl()
     }
 }
 
-ZlibDeflatingWriteBuffer::~ZlibDeflatingWriteBuffer()
-{
-    try
-    {
-        finalize();
-    }
-    catch (...)
-    {
-        tryLogCurrentException(__PRETTY_FUNCTION__);
-    }
-}
-
 void ZlibDeflatingWriteBuffer::finalizeBefore()
 {
     next();
diff --git a/src/IO/ZlibDeflatingWriteBuffer.h b/src/IO/ZlibDeflatingWriteBuffer.h
index 58e709b54e6..05d6e528a23 100644
--- a/src/IO/ZlibDeflatingWriteBuffer.h
+++ b/src/IO/ZlibDeflatingWriteBuffer.h
@@ -24,8 +24,6 @@ public:
             char * existing_memory = nullptr,
             size_t alignment = 0);
 
-    ~ZlibDeflatingWriteBuffer() override;
-
 private:
     void nextImpl() override;
 
diff --git a/src/IO/ZstdDeflatingWriteBuffer.cpp b/src/IO/ZstdDeflatingWriteBuffer.cpp
index c6d2ffc39f9..097647cbafc 100644
--- a/src/IO/ZstdDeflatingWriteBuffer.cpp
+++ b/src/IO/ZstdDeflatingWriteBuffer.cpp
@@ -30,12 +30,6 @@ ZstdDeflatingWriteBuffer::ZstdDeflatingWriteBuffer(
     output = {nullptr, 0, 0};
 }
 
-
-ZstdDeflatingWriteBuffer::~ZstdDeflatingWriteBuffer()
-{
-    finalize();
-}
-
 void ZstdDeflatingWriteBuffer::nextImpl()
 {
     if (!offset())
diff --git a/src/IO/ZstdDeflatingWriteBuffer.h b/src/IO/ZstdDeflatingWriteBuffer.h
index ba83c18d354..11e34e2890f 100644
--- a/src/IO/ZstdDeflatingWriteBuffer.h
+++ b/src/IO/ZstdDeflatingWriteBuffer.h
@@ -21,8 +21,6 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
-    ~ZstdDeflatingWriteBuffer() override;
-
     void sync() override
     {
         out->sync();
diff --git a/tests/integration/test_checking_s3_blobs_paranoid/test.py b/tests/integration/test_checking_s3_blobs_paranoid/test.py
index c0f184815c9..244ca8a2c81 100644
--- a/tests/integration/test_checking_s3_blobs_paranoid/test.py
+++ b/tests/integration/test_checking_s3_blobs_paranoid/test.py
@@ -84,19 +84,23 @@ def get_counters(node, query_id, log_type="ExceptionWhileProcessing"):
     ]
 
 
-def test_upload_s3_fail_create_multi_part_upload(cluster, broken_s3):
+#  Add "lz4" compression method in the list after https://github.com/ClickHouse/ClickHouse/issues/50975 is fixed
+@pytest.mark.parametrize(
+    "compression", ["none", "gzip", "br", "xz", "zstd", "bz2", "deflate"]
+)
+def test_upload_s3_fail_create_multi_part_upload(cluster, broken_s3, compression):
     node = cluster.instances["node"]
 
     broken_s3.setup_error_at_create_multi_part_upload()
 
-    insert_query_id = "INSERT_INTO_TABLE_FUNCTION_FAIL_CREATE_MPU"
+    insert_query_id = f"INSERT_INTO_TABLE_FUNCTION_FAIL_CREATE_MPU_{compression}"
     error = node.query_and_get_error(
-        """
+        f"""
         INSERT INTO
             TABLE FUNCTION s3(
                 'http://resolver:8083/root/data/test_upload_s3_fail_create_multi_part_upload',
                 'minio', 'minio123',
-                'CSV', auto, 'none'
+                'CSV', auto, '{compression}'
             )
         SELECT
             *
@@ -111,7 +115,6 @@ def test_upload_s3_fail_create_multi_part_upload(cluster, broken_s3):
 
     assert "Code: 499" in error, error
     assert "mock s3 injected error" in error, error
-    assert "DB::WriteBufferFromS3::createMultipartUpload()" in error, error
 
     count_create_multi_part_uploads, count_upload_parts, count_s3_errors = get_counters(
         node, insert_query_id
@@ -121,20 +124,26 @@ def test_upload_s3_fail_create_multi_part_upload(cluster, broken_s3):
     assert count_s3_errors == 1
 
 
-def test_upload_s3_fail_upload_part_when_multi_part_upload(cluster, broken_s3):
+#  Add "lz4" compression method in the list after https://github.com/ClickHouse/ClickHouse/issues/50975 is fixed
+@pytest.mark.parametrize(
+    "compression", ["none", "gzip", "br", "xz", "zstd", "bz2", "deflate"]
+)
+def test_upload_s3_fail_upload_part_when_multi_part_upload(
+    cluster, broken_s3, compression
+):
     node = cluster.instances["node"]
 
     broken_s3.setup_fake_multpartuploads()
     broken_s3.setup_error_at_part_upload(count=1, after=2)
 
-    insert_query_id = "INSERT_INTO_TABLE_FUNCTION_FAIL_UPLOAD_PART"
+    insert_query_id = f"INSERT_INTO_TABLE_FUNCTION_FAIL_UPLOAD_PART_{compression}"
     error = node.query_and_get_error(
-        """
+        f"""
         INSERT INTO
             TABLE FUNCTION s3(
                 'http://resolver:8083/root/data/test_upload_s3_fail_upload_part_when_multi_part_upload',
                 'minio', 'minio123',
-                'CSV', auto, 'none'
+                'CSV', auto, '{compression}'
             )
         SELECT
             *
@@ -149,7 +158,6 @@ def test_upload_s3_fail_upload_part_when_multi_part_upload(cluster, broken_s3):
 
     assert "Code: 499" in error, error
     assert "mock s3 injected error" in error, error
-    assert "DB::WriteBufferFromS3::writePart" in error, error
 
     count_create_multi_part_uploads, count_upload_parts, count_s3_errors = get_counters(
         node, insert_query_id

From 811f6c1532d854e0c29f33c452723ca2e7e45971 Mon Sep 17 00:00:00 2001
From: Derek Chia <derek.chia@clickhouse.com>
Date: Wed, 14 Jun 2023 20:50:47 +0800
Subject: [PATCH 437/722] Update delete.md

---
 docs/en/sql-reference/statements/delete.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/delete.md b/docs/en/sql-reference/statements/delete.md
index 5522c50d624..87a6d4d92d8 100644
--- a/docs/en/sql-reference/statements/delete.md
+++ b/docs/en/sql-reference/statements/delete.md
@@ -56,7 +56,7 @@ With the described implementation now we can see what can negatively affect 'DEL
 - Having a lot of data in Compact parts—in a Compact part, all columns are stored in one file.
 
 :::note
-Lightweight delete does not work for tables with projection as rows in projection may be affected and require the projection to be rebuilt. Rebuilding projection makes the deletion not lightweight, so this is not supported. 
+Currently, Lightweight delete does not work for tables with projection as rows in projection may be affected and require the projection to be rebuilt. Rebuilding projection makes the deletion not lightweight, so this is not supported. 
 :::
 
 ## Related content

From 85db1eb6fcb4313d40b2c6a80e46d257fd44f7d1 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 14 Jun 2023 14:55:11 +0200
Subject: [PATCH 438/722] Change submodule capnproto to it's fork in ClickHouse

---
 .gitmodules | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitmodules b/.gitmodules
index 8bf4f6e8975..151dc28c55b 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -19,7 +19,7 @@
 	url = https://github.com/google/googletest
 [submodule "contrib/capnproto"]
 	path = contrib/capnproto
-	url = https://github.com/capnproto/capnproto
+	url = https://github.com/ClickHouse/capnproto
 [submodule "contrib/double-conversion"]
 	path = contrib/double-conversion
 	url = https://github.com/google/double-conversion

From c49bde89615dddbfda33f23a99babe4e0c21225c Mon Sep 17 00:00:00 2001
From: Thom O'Connor <thom@clickhouse.com>
Date: Wed, 14 Jun 2023 07:11:28 -0600
Subject: [PATCH 439/722] Update postgresql.md

Updated PostgreSQL documentation to better show example of using PostgreSQL() table engine for SELECT and INSERT, vs. copying data via postgresql() table function for copying data into ClickHouse
---
 .../table-engines/integrations/postgresql.md  | 22 ++++++++++++++-----
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/postgresql.md b/docs/en/engines/table-engines/integrations/postgresql.md
index 51b3048706f..aa8b4d074bc 100644
--- a/docs/en/engines/table-engines/integrations/postgresql.md
+++ b/docs/en/engines/table-engines/integrations/postgresql.md
@@ -136,7 +136,7 @@ postgresql> SELECT * FROM test;
 
 ### Creating Table in ClickHouse, and connecting to  PostgreSQL table created above
 
-This example uses the [PostgreSQL table engine](/docs/en/engines/table-engines/integrations/postgresql.md) to connect the ClickHouse table to the PostgreSQL table:
+This example uses the [PostgreSQL table engine](/docs/en/engines/table-engines/integrations/postgresql.md) to connect the ClickHouse table to the PostgreSQL table and use both SELECT and INSERT statements to the PostgreSQL database:
 
 ``` sql
 CREATE TABLE default.postgresql_table
@@ -150,10 +150,20 @@ ENGINE = PostgreSQL('localhost:5432', 'public', 'test', 'postges_user', 'postgre
 
 ### Inserting initial data from PostgreSQL table into ClickHouse table, using a SELECT query
 
-The [postgresql table function](/docs/en/sql-reference/table-functions/postgresql.md) copies the data from PostgreSQL to ClickHouse, which is often used for improving the query performance of the data by querying or performing analytics in ClickHouse rather than in PostgreSQL, or can also be used for migrating data from PostgreSQL to ClickHouse:
+The [postgresql table function](/docs/en/sql-reference/table-functions/postgresql.md) copies the data from PostgreSQL to ClickHouse, which is often used for improving the query performance of the data by querying or performing analytics in ClickHouse rather than in PostgreSQL, or can also be used for migrating data from PostgreSQL to ClickHouse. Since we will be copying the data from PostgreSQL to ClickHouse, we will use a MergeTree table engine in ClickHouse and call it postgresql_copy:
 
 ``` sql
-INSERT INTO default.postgresql_table
+CREATE TABLE default.postgresql_copy
+(
+    `float_nullable` Nullable(Float32),
+    `str` String,
+    `int_id` Int32
+)
+ENGINE = MergeTree;
+```
+
+``` sql
+INSERT INTO default.postgresql_copy
 SELECT * FROM postgresql('localhost:5432', 'public', 'test', 'postges_user', 'postgres_password');
 ```
 
@@ -164,13 +174,13 @@ If then performing ongoing synchronization between the PostgreSQL table and Clic
 This would require keeping track of the max ID or timestamp previously added, such as the following:
 
 ``` sql
-SELECT max(`int_id`) AS maxIntID FROM default.postgresql_table;
+SELECT max(`int_id`) AS maxIntID FROM default.postgresql_copy;
 ```
 
 Then inserting values from PostgreSQL table greater than the max
 
 ``` sql
-INSERT INTO default.postgresql_table
+INSERT INTO default.postgresql_copy
 SELECT * FROM postgresql('localhost:5432', 'public', 'test', 'postges_user', 'postgres_password');
 WHERE int_id > maxIntID;
 ```
@@ -178,7 +188,7 @@ WHERE int_id > maxIntID;
 ### Selecting data from the resulting ClickHouse table
 
 ``` sql
-SELECT * FROM postgresql_table WHERE str IN ('test');
+SELECT * FROM postgresql_copy WHERE str IN ('test');
 ```
 
 ``` text

From 37245783abb01f63bf02d5ca445064b56bd92414 Mon Sep 17 00:00:00 2001
From: Thom O'Connor <thom@clickhouse.com>
Date: Wed, 14 Jun 2023 08:03:18 -0600
Subject: [PATCH 440/722] Update mysql.md

Updating mysql table function with example for copying data from MySQL into a ClickHouse MergeTree table
---
 .../en/sql-reference/table-functions/mysql.md | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/docs/en/sql-reference/table-functions/mysql.md b/docs/en/sql-reference/table-functions/mysql.md
index 8d7656365f5..269a50ec8b7 100644
--- a/docs/en/sql-reference/table-functions/mysql.md
+++ b/docs/en/sql-reference/table-functions/mysql.md
@@ -107,6 +107,30 @@ SELECT * FROM mysql('localhost:3306', 'test', 'test', 'bayonet', '123');
 └────────┴───────┘
 ```
 
+Copying data from MySQL table into ClickHouse table:
+
+```sql
+CREATE TABLE mysql_copy
+(
+   `id` UInt64,
+   `datetime` DateTime('UTC'),
+   `description` String,
+)
+ENGINE = MergeTree
+ORDER BY (id,datetime);
+
+INSERT INTO mysql_copy
+SELECT * FROM mysql('host:port', 'database', 'table', 'user', 'password');
+```
+
+Or if copying only an incremental batch from MySQL based on the max current id:
+
+```sql
+INSERT INTO mysql_copy
+SELECT * FROM mysql('host:port', 'database', 'table', 'user', 'password')
+WHERE id > (SELECT max(id) from mysql_copy);
+```
+
 **See Also**
 
 - [The ‘MySQL’ table engine](../../engines/table-engines/integrations/mysql.md)

From 95a2f6bec6f11b6b1b8637c65191566a4df1c837 Mon Sep 17 00:00:00 2001
From: Dmitry Novik <n0vik@clickhouse.com>
Date: Wed, 14 Jun 2023 15:05:12 +0000
Subject: [PATCH 441/722] Attempt to make 01281_group_by_limit_memory_tracking
 not-flaky

---
 .../0_stateless/01281_group_by_limit_memory_tracking.sh    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/01281_group_by_limit_memory_tracking.sh b/tests/queries/0_stateless/01281_group_by_limit_memory_tracking.sh
index 06f195f865f..e83e49dffef 100755
--- a/tests/queries/0_stateless/01281_group_by_limit_memory_tracking.sh
+++ b/tests/queries/0_stateless/01281_group_by_limit_memory_tracking.sh
@@ -23,7 +23,7 @@ set -o pipefail
 
 function execute_null()
 {
-    ${CLICKHOUSE_CLIENT} --format Null -n "$@"
+    ${CLICKHOUSE_CLIENT} -u u01281 --format Null -n "$@"
 }
 
 function execute_group_by()
@@ -46,6 +46,10 @@ function execute_group_by()
     execute_null "${opts[@]}" <<<'SELECT uniq(number) FROM numbers_mt(1e6) GROUP BY number % 5e5 LIMIT 10'
 }
 
+${CLICKHOUSE_CLIENT} -q 'DROP USER IF EXISTS u01281'
+${CLICKHOUSE_CLIENT} -q 'CREATE USER IF NOT EXISTS u01281 IDENTIFIED WITH no_password'
+${CLICKHOUSE_CLIENT} -q 'GRANT ALL ON *.* TO u01281'
+
 # This is needed to keep at least one running query for user for the time of test.
 execute_null <<<'SELECT sleep(3)' &
 execute_group_by
@@ -55,3 +59,4 @@ wait
 
 # Reset max_memory_usage_for_user, so it will not affect other tests
 ${CLICKHOUSE_CLIENT} --max_memory_usage_for_user=0 -q "SELECT 1 FORMAT Null"
+${CLICKHOUSE_CLIENT} -q 'DROP USER IF EXISTS u01281'

From 035334fc156111340cd106d0d092bed9fb503589 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Wed, 14 Jun 2023 18:06:36 +0200
Subject: [PATCH 442/722] tests: mark 02585_query_status_deadlock as long

CI: https://s3.amazonaws.com/clickhouse-test-reports/50934/bb971fd7b7fd5bc400bbe28d16867c9dc337fb17/stateless_tests_flaky_check__asan_.html
Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 tests/queries/0_stateless/02585_query_status_deadlock.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/queries/0_stateless/02585_query_status_deadlock.sh b/tests/queries/0_stateless/02585_query_status_deadlock.sh
index 9eb6eff8cd0..e3e34109cdb 100755
--- a/tests/queries/0_stateless/02585_query_status_deadlock.sh
+++ b/tests/queries/0_stateless/02585_query_status_deadlock.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Tags: long
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From 3e419730c34022e8fcdbeeef71bb8669d1561b27 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Wed, 24 May 2023 19:19:18 +0200
Subject: [PATCH 443/722] Disable parallelize_output_from_storages for
 processing MATERIALIZED VIEWs

Adding more processors for parallelize_output_from_storages is not a
costless operation (I've experienced some issues in production because
of this), and it is not easy to fix in a normal way, so let's disable it
for now.

Before this patch:
- INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=1, min_insert_block_size_rows=1000
  0 rows in set. Elapsed: 3.648 sec. Processed 20.00 million rows, 120.00 MB (5.48 million rows/s., 32.90 MB/s.)

- INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=0, min_insert_block_size_rows=1000
  0 rows in set. Elapsed: 1.851 sec. Processed 20.00 million rows, 120.00 MB (10.80 million rows/s., 64.82 MB/s.)

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../Transforms/buildPushingToViewsChain.cpp          |  4 ++++
 ...ialized_view_parallelize_output_from_storages.xml | 12 ++++++++++++
 2 files changed, 16 insertions(+)
 create mode 100644 tests/performance/materialized_view_parallelize_output_from_storages.xml

diff --git a/src/Processors/Transforms/buildPushingToViewsChain.cpp b/src/Processors/Transforms/buildPushingToViewsChain.cpp
index 0d33f250b5d..43085690519 100644
--- a/src/Processors/Transforms/buildPushingToViewsChain.cpp
+++ b/src/Processors/Transforms/buildPushingToViewsChain.cpp
@@ -245,6 +245,10 @@ Chain buildPushingToViewsChain(
         if (disable_deduplication_for_children)
             insert_context->setSetting("insert_deduplicate", Field{false});
 
+        // Processing of blocks for MVs is done block by block, and there will
+        // be no parallel reading after (plus it is not a costless operation)
+        select_context->setSetting("parallelize_output_from_storages", Field{false});
+
         // Separate min_insert_block_size_rows/min_insert_block_size_bytes for children
         if (insert_settings.min_insert_block_size_rows_for_materialized_views)
             insert_context->setSetting("min_insert_block_size_rows", insert_settings.min_insert_block_size_rows_for_materialized_views.value);
diff --git a/tests/performance/materialized_view_parallelize_output_from_storages.xml b/tests/performance/materialized_view_parallelize_output_from_storages.xml
new file mode 100644
index 00000000000..eea92886b26
--- /dev/null
+++ b/tests/performance/materialized_view_parallelize_output_from_storages.xml
@@ -0,0 +1,12 @@
+<test>
+    <create_query>CREATE TABLE input (key Int) Engine=Null</create_query>
+    <create_query>CREATE TABLE output (key Int) Engine=Null</create_query>
+    <create_query>CREATE MATERIALIZED VIEW mv TO output AS SELECT * FROM input WHERE key > 10</create_query>
+
+    <query>INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=0, min_insert_block_size_rows=1000</query>
+    <query>INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=1, min_insert_block_size_rows=1000</query>
+
+    <drop_query>DROP TABLE IF EXISTS mv</drop_query>
+    <drop_query>DROP TABLE IF EXISTS input</drop_query>
+    <drop_query>DROP TABLE IF EXISTS output</drop_query>
+</test>

From 3c4f638bd7d9eb946aa6eb5e325c94707a702dcf Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Thu, 25 May 2023 07:22:00 +0200
Subject: [PATCH 444/722] Disable parallelize_output_from_storages for storages
 with only one block

    $ clickhouse-benchmark -i 10000 -d 0 --parallelize_output_from_storages=0 -q "select * from values('foo')"
    Loaded 1 queries.

    Queries executed: 10000.

    localhost:9000, queries 10000, QPS: 2800.490, RPS: 2800.490, MiB/s: 0.032, result RPS: 2800.490, result MiB/s: 0.032.

    0.000%          0.000 sec.
    10.000%         0.000 sec.
    20.000%         0.000 sec.
    30.000%         0.000 sec.
    40.000%         0.000 sec.
    50.000%         0.000 sec.
    60.000%         0.000 sec.
    70.000%         0.000 sec.
    80.000%         0.000 sec.
    90.000%         0.000 sec.
    95.000%         0.000 sec.
    99.000%         0.001 sec.
    99.900%         0.001 sec.
    99.990%         0.001 sec.

    $ clickhouse-benchmark -i 10000 -d 0 --parallelize_output_from_storages=1 -q "select * from values('foo')"
    Loaded 1 queries.

    Queries executed: 10000.

    localhost:9000, queries 10000, QPS: 1259.805, RPS: 1259.805, MiB/s: 0.014, result RPS: 1259.805, result MiB/s: 0.014.

    0.000%          0.001 sec.
    10.000%         0.001 sec.
    20.000%         0.001 sec.
    30.000%         0.001 sec.
    40.000%         0.001 sec.
    50.000%         0.001 sec.
    60.000%         0.001 sec.
    70.000%         0.001 sec.
    80.000%         0.001 sec.
    90.000%         0.001 sec.
    95.000%         0.001 sec.
    99.000%         0.001 sec.
    99.900%         0.001 sec.
    99.990%         0.003 sec.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 src/Storages/StorageValues.h                       | 2 ++
 src/Storages/System/IStorageSystemOneBlock.h       | 2 ++
 src/Storages/System/StorageSystemDisks.h           | 2 ++
 src/Storages/System/StorageSystemPartsBase.h       | 2 ++
 src/Storages/System/StorageSystemRemoteDataPaths.h | 2 ++
 src/Storages/System/StorageSystemReplicas.h        | 2 ++
 src/Storages/System/StorageSystemStackTrace.h      | 2 ++
 src/Storages/System/StorageSystemStoragePolicies.h | 2 ++
 src/Storages/System/StorageSystemZooKeeper.h       | 1 +
 9 files changed, 17 insertions(+)

diff --git a/src/Storages/StorageValues.h b/src/Storages/StorageValues.h
index 55222903797..af1c134077b 100644
--- a/src/Storages/StorageValues.h
+++ b/src/Storages/StorageValues.h
@@ -36,6 +36,8 @@ public:
     /// FIXME probably it should return false, but StorageValues is used in ExecutingInnerQueryFromViewTransform (whatever it is)
     bool supportsTransactions() const override { return true; }
 
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
+
 private:
     Block res_block;
     NamesAndTypesList virtuals;
diff --git a/src/Storages/System/IStorageSystemOneBlock.h b/src/Storages/System/IStorageSystemOneBlock.h
index 63b9a443f95..051bd8c69be 100644
--- a/src/Storages/System/IStorageSystemOneBlock.h
+++ b/src/Storages/System/IStorageSystemOneBlock.h
@@ -61,6 +61,8 @@ public:
 
     bool isSystemStorage() const override { return true; }
 
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
+
     static NamesAndAliases getNamesAndAliases() { return {}; }
 };
 
diff --git a/src/Storages/System/StorageSystemDisks.h b/src/Storages/System/StorageSystemDisks.h
index 06cc7e8d4e2..d36e33a01d5 100644
--- a/src/Storages/System/StorageSystemDisks.h
+++ b/src/Storages/System/StorageSystemDisks.h
@@ -30,6 +30,8 @@ public:
         size_t num_streams) override;
 
     bool isSystemStorage() const override { return true; }
+
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemPartsBase.h b/src/Storages/System/StorageSystemPartsBase.h
index c3d2e64b303..d061a7cccf5 100644
--- a/src/Storages/System/StorageSystemPartsBase.h
+++ b/src/Storages/System/StorageSystemPartsBase.h
@@ -69,6 +69,8 @@ public:
 
     bool isSystemStorage() const override { return true; }
 
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
+
 private:
     static bool hasStateColumn(const Names & column_names, const StorageSnapshotPtr & storage_snapshot);
 
diff --git a/src/Storages/System/StorageSystemRemoteDataPaths.h b/src/Storages/System/StorageSystemRemoteDataPaths.h
index 7e883d144ef..0708f9bc7a3 100644
--- a/src/Storages/System/StorageSystemRemoteDataPaths.h
+++ b/src/Storages/System/StorageSystemRemoteDataPaths.h
@@ -22,6 +22,8 @@ public:
         QueryProcessingStage::Enum processed_stage,
         size_t max_block_size,
         size_t num_streams) override;
+
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemReplicas.h b/src/Storages/System/StorageSystemReplicas.h
index e9c29dec0fd..5799e931b13 100644
--- a/src/Storages/System/StorageSystemReplicas.h
+++ b/src/Storages/System/StorageSystemReplicas.h
@@ -28,6 +28,8 @@ public:
         size_t num_streams) override;
 
     bool isSystemStorage() const override { return true; }
+
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemStackTrace.h b/src/Storages/System/StorageSystemStackTrace.h
index 9133a86aa55..c03dbdd6c74 100644
--- a/src/Storages/System/StorageSystemStackTrace.h
+++ b/src/Storages/System/StorageSystemStackTrace.h
@@ -37,6 +37,8 @@ public:
 
     bool isSystemStorage() const override { return true; }
 
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
+
 protected:
     mutable std::mutex mutex;
     Poco::Logger * log;
diff --git a/src/Storages/System/StorageSystemStoragePolicies.h b/src/Storages/System/StorageSystemStoragePolicies.h
index afc729c8368..29d1c30a15e 100644
--- a/src/Storages/System/StorageSystemStoragePolicies.h
+++ b/src/Storages/System/StorageSystemStoragePolicies.h
@@ -30,6 +30,8 @@ public:
         size_t num_streams) override;
 
     bool isSystemStorage() const override { return true; }
+
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemZooKeeper.h b/src/Storages/System/StorageSystemZooKeeper.h
index a016d3ad74c..49645094cad 100644
--- a/src/Storages/System/StorageSystemZooKeeper.h
+++ b/src/Storages/System/StorageSystemZooKeeper.h
@@ -35,6 +35,7 @@ public:
     bool isSystemStorage() const override { return true; }
     bool supportsIndexForIn() const override { return true; }
     bool mayBenefitFromIndexForIn(const ASTPtr & node, ContextPtr, const StorageMetadataPtr &) const override;
+    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }

From 5caa3a9e80328ac9090658903e47ccd3491d66cc Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Wed, 7 Jun 2023 18:15:23 +0200
Subject: [PATCH 445/722] Adjust min_insert_block_size_rows for
 materialized_view_parallelize_output_from_storages

Otherwise it is too slow for perf tests on CI [1].

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/50214/e287ec50920c7cadabea6ec19ef14b353345ac93/performance_comparison_[3_4]/report.html

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../materialized_view_parallelize_output_from_storages.xml    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/performance/materialized_view_parallelize_output_from_storages.xml b/tests/performance/materialized_view_parallelize_output_from_storages.xml
index eea92886b26..ca2cd199690 100644
--- a/tests/performance/materialized_view_parallelize_output_from_storages.xml
+++ b/tests/performance/materialized_view_parallelize_output_from_storages.xml
@@ -3,8 +3,8 @@
     <create_query>CREATE TABLE output (key Int) Engine=Null</create_query>
     <create_query>CREATE MATERIALIZED VIEW mv TO output AS SELECT * FROM input WHERE key > 10</create_query>
 
-    <query>INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=0, min_insert_block_size_rows=1000</query>
-    <query>INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=1, min_insert_block_size_rows=1000</query>
+    <query>INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=0, min_insert_block_size_rows=10000</query>
+    <query>INSERT INTO input SELECT * FROM numbers(10e6) SETTINGS parallelize_output_from_storages=1, min_insert_block_size_rows=10000</query>
 
     <drop_query>DROP TABLE IF EXISTS mv</drop_query>
     <drop_query>DROP TABLE IF EXISTS input</drop_query>

From e9c9db93354391b6268e39a7a6b5f5508acad19c Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Tue, 13 Jun 2023 15:09:30 +0200
Subject: [PATCH 446/722] Disable parallelize_output_from_storages for all
 system tables

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 src/Storages/IStorage.h                            | 9 +++++----
 src/Storages/System/IStorageSystemOneBlock.h       | 2 --
 src/Storages/System/StorageSystemDisks.h           | 2 --
 src/Storages/System/StorageSystemNumbers.h         | 2 --
 src/Storages/System/StorageSystemOne.h             | 2 --
 src/Storages/System/StorageSystemPartsBase.h       | 2 --
 src/Storages/System/StorageSystemRemoteDataPaths.h | 2 --
 src/Storages/System/StorageSystemReplicas.h        | 2 --
 src/Storages/System/StorageSystemStackTrace.h      | 2 --
 src/Storages/System/StorageSystemStoragePolicies.h | 2 --
 src/Storages/System/StorageSystemZeros.h           | 2 --
 src/Storages/System/StorageSystemZooKeeper.h       | 1 -
 12 files changed, 5 insertions(+), 25 deletions(-)

diff --git a/src/Storages/IStorage.h b/src/Storages/IStorage.h
index d44772850fd..b262d88db57 100644
--- a/src/Storages/IStorage.h
+++ b/src/Storages/IStorage.h
@@ -376,10 +376,11 @@ private:
     /// even when the storage returned only one stream of data for reading?
     /// It is beneficial, for example, when you read from a file quickly,
     /// but then do heavy computations on returned blocks.
-    /// This is enabled by default, but in some cases shouldn't be done.
-    /// For example, when you read from system.numbers instead of system.numbers_mt,
-    /// you still expect the data to be processed sequentially.
-    virtual bool parallelizeOutputAfterReading(ContextPtr) const { return true; }
+    ///
+    /// This is enabled by default, but in some cases shouldn't be done (for
+    /// example it is disabled for all system tables, since it is pretty
+    /// useless).
+    virtual bool parallelizeOutputAfterReading(ContextPtr) const { return !isSystemStorage(); }
 
 public:
     /// Other version of read which adds reading step to query plan.
diff --git a/src/Storages/System/IStorageSystemOneBlock.h b/src/Storages/System/IStorageSystemOneBlock.h
index 051bd8c69be..63b9a443f95 100644
--- a/src/Storages/System/IStorageSystemOneBlock.h
+++ b/src/Storages/System/IStorageSystemOneBlock.h
@@ -61,8 +61,6 @@ public:
 
     bool isSystemStorage() const override { return true; }
 
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
-
     static NamesAndAliases getNamesAndAliases() { return {}; }
 };
 
diff --git a/src/Storages/System/StorageSystemDisks.h b/src/Storages/System/StorageSystemDisks.h
index d36e33a01d5..06cc7e8d4e2 100644
--- a/src/Storages/System/StorageSystemDisks.h
+++ b/src/Storages/System/StorageSystemDisks.h
@@ -30,8 +30,6 @@ public:
         size_t num_streams) override;
 
     bool isSystemStorage() const override { return true; }
-
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemNumbers.h b/src/Storages/System/StorageSystemNumbers.h
index 80590718d03..acddac681ef 100644
--- a/src/Storages/System/StorageSystemNumbers.h
+++ b/src/Storages/System/StorageSystemNumbers.h
@@ -40,8 +40,6 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
-
     bool hasEvenlyDistributedRead() const override { return true; }
     bool isSystemStorage() const override { return true; }
     bool supportsTransactions() const override { return true; }
diff --git a/src/Storages/System/StorageSystemOne.h b/src/Storages/System/StorageSystemOne.h
index e3b6e1d5f78..d8a26f1def4 100644
--- a/src/Storages/System/StorageSystemOne.h
+++ b/src/Storages/System/StorageSystemOne.h
@@ -30,8 +30,6 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
-
     bool isSystemStorage() const override { return true; }
 
     bool supportsTransactions() const override { return true; }
diff --git a/src/Storages/System/StorageSystemPartsBase.h b/src/Storages/System/StorageSystemPartsBase.h
index d061a7cccf5..c3d2e64b303 100644
--- a/src/Storages/System/StorageSystemPartsBase.h
+++ b/src/Storages/System/StorageSystemPartsBase.h
@@ -69,8 +69,6 @@ public:
 
     bool isSystemStorage() const override { return true; }
 
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
-
 private:
     static bool hasStateColumn(const Names & column_names, const StorageSnapshotPtr & storage_snapshot);
 
diff --git a/src/Storages/System/StorageSystemRemoteDataPaths.h b/src/Storages/System/StorageSystemRemoteDataPaths.h
index 0708f9bc7a3..7e883d144ef 100644
--- a/src/Storages/System/StorageSystemRemoteDataPaths.h
+++ b/src/Storages/System/StorageSystemRemoteDataPaths.h
@@ -22,8 +22,6 @@ public:
         QueryProcessingStage::Enum processed_stage,
         size_t max_block_size,
         size_t num_streams) override;
-
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemReplicas.h b/src/Storages/System/StorageSystemReplicas.h
index 5799e931b13..e9c29dec0fd 100644
--- a/src/Storages/System/StorageSystemReplicas.h
+++ b/src/Storages/System/StorageSystemReplicas.h
@@ -28,8 +28,6 @@ public:
         size_t num_streams) override;
 
     bool isSystemStorage() const override { return true; }
-
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemStackTrace.h b/src/Storages/System/StorageSystemStackTrace.h
index c03dbdd6c74..9133a86aa55 100644
--- a/src/Storages/System/StorageSystemStackTrace.h
+++ b/src/Storages/System/StorageSystemStackTrace.h
@@ -37,8 +37,6 @@ public:
 
     bool isSystemStorage() const override { return true; }
 
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
-
 protected:
     mutable std::mutex mutex;
     Poco::Logger * log;
diff --git a/src/Storages/System/StorageSystemStoragePolicies.h b/src/Storages/System/StorageSystemStoragePolicies.h
index 29d1c30a15e..afc729c8368 100644
--- a/src/Storages/System/StorageSystemStoragePolicies.h
+++ b/src/Storages/System/StorageSystemStoragePolicies.h
@@ -30,8 +30,6 @@ public:
         size_t num_streams) override;
 
     bool isSystemStorage() const override { return true; }
-
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }
diff --git a/src/Storages/System/StorageSystemZeros.h b/src/Storages/System/StorageSystemZeros.h
index 84b4b752aae..64443a3cfd6 100644
--- a/src/Storages/System/StorageSystemZeros.h
+++ b/src/Storages/System/StorageSystemZeros.h
@@ -31,8 +31,6 @@ public:
         size_t max_block_size,
         size_t num_streams) override;
 
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
-
     bool hasEvenlyDistributedRead() const override { return true; }
     bool isSystemStorage() const override { return true; }
     bool supportsTransactions() const override { return true; }
diff --git a/src/Storages/System/StorageSystemZooKeeper.h b/src/Storages/System/StorageSystemZooKeeper.h
index 49645094cad..a016d3ad74c 100644
--- a/src/Storages/System/StorageSystemZooKeeper.h
+++ b/src/Storages/System/StorageSystemZooKeeper.h
@@ -35,7 +35,6 @@ public:
     bool isSystemStorage() const override { return true; }
     bool supportsIndexForIn() const override { return true; }
     bool mayBenefitFromIndexForIn(const ASTPtr & node, ContextPtr, const StorageMetadataPtr &) const override;
-    bool parallelizeOutputAfterReading(ContextPtr) const override { return false; }
 };
 
 }

From 45328a41e81be49e7755a091d68433e2e232ff11 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Wed, 14 Jun 2023 09:31:21 -0700
Subject: [PATCH 447/722] Fix test for MySQL Compatible Types to use
 clickhouse_client rather than clickhouse_local

---
 .../02775_show_columns_mysql_compatibility.sh | 20 +++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index e324926e2e7..9aa199e8913 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -14,12 +14,12 @@ PORT=9004
 # First run the clickhouse test to create the ClickHouse Tables
 
 echo "Drop tables if they exist"
-${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS tab"
-${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde"
-${CLICKHOUSE_LOCAL} --query "DROP TABLE IF EXISTS database_123456789abcde.tab"
+${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS tab"
+${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS database_123456789abcdef"
+${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS database_123456789abcdef.tab"
 
 echo "Create tab table "
-${CLICKHOUSE_LOCAL} -n -q "
+${CLICKHOUSE_CLIENT} -n -q "
     SET allow_suspicious_low_cardinality_types=1;
     SET allow_experimental_object_type=1;
     CREATE TABLE tab
@@ -70,13 +70,13 @@ ${CLICKHOUSE_LOCAL} -n -q "
 
 
 echo "Create pseudo-random database name"
-${CLICKHOUSE_LOCAL} --query "CREATE DATABASE database_123456789abcde;"
+${CLICKHOUSE_CLIENT} --query "CREATE DATABASE database_123456789abcdef;"
 
 echo "Create tab duplicate table"
-${CLICKHOUSE_LOCAL} -n -q "
+${CLICKHOUSE_CLIENT} -n -q "
     SET allow_suspicious_low_cardinality_types=1;
     SET allow_experimental_object_type =1;
-    CREATE TABLE database_123456789abcde.tab
+    CREATE TABLE database_123456789abcdef.tab
     (
         uint8 UInt8,
         uint16 UInt16,
@@ -138,9 +138,9 @@ SHOW COLUMNS FROM tab NOT ILIKE '%INT%';
 SHOW COLUMNS FROM tab WHERE field LIKE '%int%';
 SHOW COLUMNS FROM tab LIMIT 1;
 SHOW COLUMNS FROM tab;
-SHOW COLUMNS FROM tab FROM database_123456789abcde;
-SHOW COLUMNS FROM database_123456789abcde.tab;
-DROP DATABASE database_123456789abcde;
+SHOW COLUMNS FROM tab FROM database_123456789abcdef;
+SHOW COLUMNS FROM database_123456789abcdef.tab;
+DROP DATABASE database_123456789abcdef;
 DROP TABLE tab;
 EOT
 

From 69594862c9cd9b598164cf2f8afd9161f5d3f445 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Wed, 14 Jun 2023 09:34:56 -0700
Subject: [PATCH 448/722] Fix test for MySQL Compatible types (drop database
 properly)

---
 .../0_stateless/02775_show_columns_mysql_compatibility.sh       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index 9aa199e8913..89881a4cf60 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -15,7 +15,7 @@ PORT=9004
 
 echo "Drop tables if they exist"
 ${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS tab"
-${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS database_123456789abcdef"
+${CLICKHOUSE_CLIENT} --query "DROP DATABASE IF EXISTS database_123456789abcdef"
 ${CLICKHOUSE_CLIENT} --query "DROP TABLE IF EXISTS database_123456789abcdef.tab"
 
 echo "Create tab table "

From fb304c0b0567ce34e2ea399f7c3a1d1c43729129 Mon Sep 17 00:00:00 2001
From: Thom O'Connor <thom@clickhouse.com>
Date: Wed, 14 Jun 2023 10:39:55 -0600
Subject: [PATCH 449/722] Update postgresql.md

Fix table definition by adding ORDER BY() statement
---
 docs/en/engines/table-engines/integrations/postgresql.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/integrations/postgresql.md b/docs/en/engines/table-engines/integrations/postgresql.md
index aa8b4d074bc..8eab6fdb421 100644
--- a/docs/en/engines/table-engines/integrations/postgresql.md
+++ b/docs/en/engines/table-engines/integrations/postgresql.md
@@ -159,7 +159,8 @@ CREATE TABLE default.postgresql_copy
     `str` String,
     `int_id` Int32
 )
-ENGINE = MergeTree;
+ENGINE = MergeTree
+ORDER BY (int_id);
 ```
 
 ``` sql

From df1d16a165f421b366e8422523ec7cbb3ef85771 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 14 Jun 2023 17:11:10 +0000
Subject: [PATCH 450/722] Fix flaky 02561_null_as_default_more_formats

---
 .../0_stateless/02561_null_as_default_more_formats.sh       | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02561_null_as_default_more_formats.sh b/tests/queries/0_stateless/02561_null_as_default_more_formats.sh
index eacd8e964a6..0c4848d8eba 100755
--- a/tests/queries/0_stateless/02561_null_as_default_more_formats.sh
+++ b/tests/queries/0_stateless/02561_null_as_default_more_formats.sh
@@ -7,15 +7,19 @@ CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 
 $CLICKHOUSE_CLIENT -q "drop table if exists test"
 $CLICKHOUSE_CLIENT -q "create table test (x UInt64 default 42, y UInt64, z LowCardinality(String) default '42') engine=Memory";
+uid=$RANDOM$RANDOM
 for format in Parquet Arrow ORC Avro MsgPack Native
 do
+    data_file=02561_null_as_default_more_formats_$uid.$format
     echo $format
-    $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format" | $CLICKHOUSE_CLIENT -q "insert into test settings input_format_null_as_default=0 format $format" 2>&1 | grep "Exception" -c
+    $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format" > $data_file
+    $CLICKHOUSE_CLIENT -q "insert into test from infile '$data_file' settings input_format_null_as_default=0 format $format" 2>&1 | grep "Exception" -c
     $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format settings output_format_arrow_low_cardinality_as_dictionary=1" | $CLICKHOUSE_CLIENT -q "insert into test settings input_format_null_as_default=1, input_format_defaults_for_omitted_fields=0 format $format"
     $CLICKHOUSE_CLIENT -q "select * from test"
     $CLICKHOUSE_CLIENT -q "truncate table test"
     $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format settings output_format_arrow_low_cardinality_as_dictionary=1" | $CLICKHOUSE_CLIENT -q "insert into test settings input_format_null_as_default=1, input_format_defaults_for_omitted_fields=1 format $format"
     $CLICKHOUSE_CLIENT -q "select * from test"
     $CLICKHOUSE_CLIENT -q "truncate table test"
+    rm $data_file
 done
 

From bb7ec69b903f19b7f599e2fead5a2e70c4a5a768 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 14 Jun 2023 19:38:03 +0200
Subject: [PATCH 451/722] Fix flaky test_seekable_formats

---
 tests/integration/test_storage_s3/test.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/integration/test_storage_s3/test.py b/tests/integration/test_storage_s3/test.py
index f983bd618e3..aad74a25484 100644
--- a/tests/integration/test_storage_s3/test.py
+++ b/tests/integration/test_storage_s3/test.py
@@ -1011,7 +1011,7 @@ def test_seekable_formats(started_cluster):
     )
 
     result = instance.query(
-        f"SELECT count() FROM {table_function} SETTINGS max_memory_usage='60M'"
+        f"SELECT count() FROM {table_function} SETTINGS max_memory_usage='60M', max_download_threads=1"
     )
     assert int(result) == 1500000
 

From 145f7c928ea7edd0c00a7808137134b6fbbfde06 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 14 Jun 2023 17:48:40 +0000
Subject: [PATCH 452/722] Use CLICKHOUSE_TEST_UNIQUE_NAME for data file

+ comment
---
 .../0_stateless/02561_null_as_default_more_formats.sh    | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/02561_null_as_default_more_formats.sh b/tests/queries/0_stateless/02561_null_as_default_more_formats.sh
index 0c4848d8eba..603f8b33618 100755
--- a/tests/queries/0_stateless/02561_null_as_default_more_formats.sh
+++ b/tests/queries/0_stateless/02561_null_as_default_more_formats.sh
@@ -7,19 +7,22 @@ CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 
 $CLICKHOUSE_CLIENT -q "drop table if exists test"
 $CLICKHOUSE_CLIENT -q "create table test (x UInt64 default 42, y UInt64, z LowCardinality(String) default '42') engine=Memory";
-uid=$RANDOM$RANDOM
 for format in Parquet Arrow ORC Avro MsgPack Native
 do
-    data_file=02561_null_as_default_more_formats_$uid.$format
     echo $format
+    # insert data by using file, not a pipe (stdout->stdin)
+    # the insert query is intended to fail (close the pipe), and it can happen before select process finishes writing to the pipe
+    # so, it will lead to 'Broken pipe' error, see #49177
+    data_file=$CLICKHOUSE_TEST_UNIQUE_NAME.$format
     $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format" > $data_file
     $CLICKHOUSE_CLIENT -q "insert into test from infile '$data_file' settings input_format_null_as_default=0 format $format" 2>&1 | grep "Exception" -c
+    rm $data_file
+
     $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format settings output_format_arrow_low_cardinality_as_dictionary=1" | $CLICKHOUSE_CLIENT -q "insert into test settings input_format_null_as_default=1, input_format_defaults_for_omitted_fields=0 format $format"
     $CLICKHOUSE_CLIENT -q "select * from test"
     $CLICKHOUSE_CLIENT -q "truncate table test"
     $CLICKHOUSE_CLIENT -q "select number % 2 ? NULL : number as x, x as y, CAST(number % 2 ? NULL : toString(number), 'LowCardinality(Nullable(String))') as z from numbers(2) format $format settings output_format_arrow_low_cardinality_as_dictionary=1" | $CLICKHOUSE_CLIENT -q "insert into test settings input_format_null_as_default=1, input_format_defaults_for_omitted_fields=1 format $format"
     $CLICKHOUSE_CLIENT -q "select * from test"
     $CLICKHOUSE_CLIENT -q "truncate table test"
-    rm $data_file
 done
 

From 6366940a37841114f2060272b37d9e1beef7d0c3 Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@clickhouse.com>
Date: Wed, 14 Jun 2023 16:27:17 +0200
Subject: [PATCH 453/722] Use hash_of_all_files from system.parts to check
 identity of parts during on-cluster backups.

---
 .../BackupCoordinationReplicatedTables.cpp    |  9 ++-
 src/Storages/MergeTree/MergeTreeData.cpp      | 12 ++--
 src/Storages/MergeTree/MergeTreeData.h        | 10 +++-
 src/Storages/StorageMergeTree.cpp             |  5 +-
 src/Storages/StorageReplicatedMergeTree.cpp   | 56 +++++--------------
 5 files changed, 38 insertions(+), 54 deletions(-)

diff --git a/src/Backups/BackupCoordinationReplicatedTables.cpp b/src/Backups/BackupCoordinationReplicatedTables.cpp
index 87de1c7ec75..1cbb88acb82 100644
--- a/src/Backups/BackupCoordinationReplicatedTables.cpp
+++ b/src/Backups/BackupCoordinationReplicatedTables.cpp
@@ -185,11 +185,10 @@ void BackupCoordinationReplicatedTables::addPartNames(PartNamesForTableReplica &
                 const String & other_replica_name = **other.replica_names.begin();
                 throw Exception(
                     ErrorCodes::CANNOT_BACKUP_TABLE,
-                    "Table {} on replica {} has part {} which is different from the part on replica {}. Must be the same",
-                    table_name_for_logs,
-                    replica_name,
-                    part_name,
-                    other_replica_name);
+                    "Table {} on replica {} has part {} different from the part on replica {} "
+                    "(checksum '{}' on replica {} != checksum '{}' on replica {})",
+                    table_name_for_logs, replica_name, part_name, other_replica_name,
+                    getHexUIntLowercase(checksum), replica_name, getHexUIntLowercase(other.checksum), other_replica_name);
             }
         }
 
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index c94fa573b5b..ff0b77f641b 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -5118,14 +5118,13 @@ Pipe MergeTreeData::alterPartition(
     return {};
 }
 
-
-BackupEntries MergeTreeData::backupParts(
+MergeTreeData::PartsBackupEntries MergeTreeData::backupParts(
     const DataPartsVector & data_parts,
     const String & data_path_in_backup,
     const BackupSettings & backup_settings,
     const ContextPtr & local_context)
 {
-    BackupEntries backup_entries;
+    MergeTreeData::PartsBackupEntries res;
     std::map<DiskPtr, std::shared_ptr<TemporaryFileOnDisk>> temp_dirs;
     TableLockHolder table_lock;
     ReadSettings read_settings = local_context->getBackupReadSettings();
@@ -5190,10 +5189,13 @@ BackupEntries MergeTreeData::backupParts(
                 wrapBackupEntriesWith(backup_entries_from_part, storage_and_part);
         }
 
-        insertAtEnd(backup_entries, std::move(backup_entries_from_part));
+        auto & part_backup_entries = res.emplace_back();
+        part_backup_entries.part_name = part->name;
+        part_backup_entries.part_checksum = part->checksums.getTotalChecksumUInt128();
+        part_backup_entries.backup_entries = std::move(backup_entries_from_part);
     }
 
-    return backup_entries;
+    return res;
 }
 
 void MergeTreeData::restoreDataFromBackup(RestorerFromBackup & restorer, const String & data_path_in_backup, const std::optional<ASTs> & partitions)
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index def58ba2760..9aa07998745 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -1324,8 +1324,16 @@ protected:
     /// Moves part to specified space, used in ALTER ... MOVE ... queries
     MovePartsOutcome movePartsToSpace(const DataPartsVector & parts, SpacePtr space);
 
+    struct PartBackupEntries
+    {
+        String part_name;
+        UInt128 part_checksum; /// same as MinimalisticDataPartChecksums::hash_of_all_files
+        BackupEntries backup_entries;
+    };
+    using PartsBackupEntries = std::vector<PartBackupEntries>;
+
     /// Makes backup entries to backup the parts of this table.
-    BackupEntries backupParts(const DataPartsVector & data_parts, const String & data_path_in_backup, const BackupSettings & backup_settings, const ContextPtr & local_context);
+    PartsBackupEntries backupParts(const DataPartsVector & data_parts, const String & data_path_in_backup, const BackupSettings & backup_settings, const ContextPtr & local_context);
 
     class RestoredPartsHolder;
 
diff --git a/src/Storages/StorageMergeTree.cpp b/src/Storages/StorageMergeTree.cpp
index a2a46229660..63ffe026d3c 100644
--- a/src/Storages/StorageMergeTree.cpp
+++ b/src/Storages/StorageMergeTree.cpp
@@ -2160,7 +2160,10 @@ void StorageMergeTree::backupData(BackupEntriesCollector & backup_entries_collec
     for (const auto & data_part : data_parts)
         min_data_version = std::min(min_data_version, data_part->info.getDataVersion() + 1);
 
-    backup_entries_collector.addBackupEntries(backupParts(data_parts, data_path_in_backup, backup_settings, local_context));
+    auto parts_backup_entries = backupParts(data_parts, data_path_in_backup, backup_settings, local_context);
+    for (auto & part_backup_entries : parts_backup_entries)
+        backup_entries_collector.addBackupEntries(std::move(part_backup_entries.backup_entries));
+
     backup_entries_collector.addBackupEntries(backupMutations(min_data_version, data_path_in_backup));
 }
 
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index f9c9e958258..c5e61f8a244 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -9343,45 +9343,17 @@ void StorageReplicatedMergeTree::backupData(
     else
         data_parts = getVisibleDataPartsVector(local_context);
 
-    auto backup_entries = backupParts(data_parts, /* data_path_in_backup */ "", backup_settings, local_context);
+    auto parts_backup_entries = backupParts(data_parts, /* data_path_in_backup */ "", backup_settings, local_context);
 
     auto coordination = backup_entries_collector.getBackupCoordination();
     String shared_id = getTableSharedID();
     coordination->addReplicatedDataPath(shared_id, data_path_in_backup);
 
-    std::unordered_map<String, SipHash> part_names_with_hashes_calculating;
-    for (auto & [relative_path, backup_entry] : backup_entries)
-    {
-        size_t slash_pos = relative_path.find('/');
-        if (slash_pos != String::npos)
-        {
-            String part_name = relative_path.substr(0, slash_pos);
-            if (MergeTreePartInfo::tryParsePartName(part_name, MERGE_TREE_DATA_MIN_FORMAT_VERSION_WITH_CUSTOM_PARTITIONING))
-            {
-                auto & hash = part_names_with_hashes_calculating[part_name];
-                if (relative_path.ends_with(".bin"))
-                {
-                    hash.update(relative_path);
-                    hash.update(backup_entry->getSize());
-                    hash.update(backup_entry->getChecksum());
-                }
-                continue;
-            }
-        }
-        /// Not a part name, probably error.
-        throw Exception(ErrorCodes::LOGICAL_ERROR, "{} doesn't follow the format <part_name>/<path>", quoteString(relative_path));
-    }
-
-    std::vector<IBackupCoordination::PartNameAndChecksum> part_names_with_hashes;
-    part_names_with_hashes.reserve(part_names_with_hashes_calculating.size());
-    for (auto & [part_name, hash] : part_names_with_hashes_calculating)
-    {
-        UInt128 checksum;
-        hash.get128(checksum);
-        auto & part_name_with_hash = part_names_with_hashes.emplace_back();
-        part_name_with_hash.part_name = part_name;
-        part_name_with_hash.checksum = checksum;
-    }
+    using PartNameAndChecksum = IBackupCoordination::PartNameAndChecksum;
+    std::vector<PartNameAndChecksum> part_names_with_hashes;
+    part_names_with_hashes.reserve(parts_backup_entries.size());
+    for (const auto & part_backup_entries : parts_backup_entries)
+        part_names_with_hashes.emplace_back(PartNameAndChecksum{part_backup_entries.part_name, part_backup_entries.part_checksum});
 
     /// Send our list of part names to the coordination (to compare with other replicas).
     coordination->addReplicatedPartNames(shared_id, getStorageID().getFullTableName(), getReplicaName(), part_names_with_hashes);
@@ -9409,7 +9381,7 @@ void StorageReplicatedMergeTree::backupData(
     auto post_collecting_task = [shared_id,
                                  my_replica_name = getReplicaName(),
                                  coordination,
-                                 my_backup_entries = std::move(backup_entries),
+                                 parts_backup_entries = std::move(parts_backup_entries),
                                  &backup_entries_collector]()
     {
         Strings data_paths = coordination->getReplicatedDataPaths(shared_id);
@@ -9421,14 +9393,14 @@ void StorageReplicatedMergeTree::backupData(
         Strings part_names = coordination->getReplicatedPartNames(shared_id, my_replica_name);
         std::unordered_set<std::string_view> part_names_set{part_names.begin(), part_names.end()};
 
-        for (const auto & [relative_path, backup_entry] : my_backup_entries)
+        for (const auto & part_backup_entries : parts_backup_entries)
         {
-            size_t slash_pos = relative_path.find('/');
-            String part_name = relative_path.substr(0, slash_pos);
-            if (!part_names_set.contains(part_name))
-                continue;
-            for (const auto & data_path : data_paths_fs)
-                backup_entries_collector.addBackupEntry(data_path / relative_path, backup_entry);
+            if (part_names_set.contains(part_backup_entries.part_name))
+            {
+                for (const auto & [relative_path, backup_entry] : part_backup_entries.backup_entries)
+                    for (const auto & data_path : data_paths_fs)
+                        backup_entries_collector.addBackupEntry(data_path / relative_path, backup_entry);
+            }
         }
 
         auto mutation_infos = coordination->getReplicatedMutations(shared_id, my_replica_name);

From fcadb851c83ea35dd6ecae208c27dc3dc4fecf0b Mon Sep 17 00:00:00 2001
From: Jiebin Sun <jiebin.sun@intel.com>
Date: Thu, 15 Jun 2023 03:22:09 +0800
Subject: [PATCH 454/722] Maintain per-thread timer_id rather than
 create/delete frequently (#48778)

* Maintain per-thread timer_id rather than create/delete frequently

The QueryProfiler will frequently create/delete timer_id globally, which
will result in heavy kernel lock contention.
The idea is to maintain thread-local timer_id. Before create the
timer_id, it should check whether there is a timer_id already. And we
could stop the timer by timer_settime() rather than delete the timer_id
with timer_delete().

Apply the patch and run clickbench on latest 65d671b7c72c ClickHouse with
SPR 112 x 2 vCPUs. Query 4, 0, 5, 3, 15, 32 have 17.5%, 14.4%, 8.3%, 7.9%,
7.1%, 5.8% performance gain. The overall geomean has got 2.5%
performance gain.

Signed-off-by: Jiebin Sun <jiebin.sun@intel.com>

* Pack the timer and delete the timer_id when thread terminates

Pack the timer and related methods into the class. Delete the timer_id
when the thread terminates.

According to the issue (ClickHouse#49965),
all of the SSB queries benefit from this optimization, some have even got
improved by ~30% and the overall QPS could be significantly improved by ~18%.

Signed-off-by: Jiebin Sun <jiebin.sun@intel.com>

* Update src/Common/QueryProfiler.cpp

Co-authored-by: Azat Khuzhin <a3at.mail@gmail.com>

* Update src/Common/QueryProfiler.cpp

Co-authored-by: Azat Khuzhin <a3at.mail@gmail.com>

* Fix the review issue of QueryProfiler Timer from PR
https://github.com/ClickHouse/ClickHouse/pull/48778.

Signed-off-by: Jiebin Sun <jiebin.sun@intel.com>

* Update src/Common/QueryProfiler.cpp

Co-authored-by: Azat Khuzhin <a3at.mail@gmail.com>

* Add two separate CurrentMetrics for created and active timers
in QueryProfiler.

Signed-off-by: Jiebin Sun <jiebin.sun@intel.com>

---------

Signed-off-by: Jiebin Sun <jiebin.sun@intel.com>
Co-authored-by: Azat Khuzhin <a3at.mail@gmail.com>
Co-authored-by: Nikita Taranov <nikita.taranov@clickhouse.com>
---
 src/Common/CurrentMetrics.cpp |   5 +-
 src/Common/QueryProfiler.cpp  | 189 ++++++++++++++++++++++------------
 src/Common/QueryProfiler.h    |  26 ++++-
 3 files changed, 152 insertions(+), 68 deletions(-)

diff --git a/src/Common/CurrentMetrics.cpp b/src/Common/CurrentMetrics.cpp
index 61725d079bf..f2ddb7a84c0 100644
--- a/src/Common/CurrentMetrics.cpp
+++ b/src/Common/CurrentMetrics.cpp
@@ -197,8 +197,9 @@
     M(IOUringInFlightEvents, "Number of io_uring SQEs in flight") \
     M(ReadTaskRequestsSent, "The current number of callback requests in flight from the remote server back to the initiator server to choose the read task (for s3Cluster table function and similar). Measured on the remote server side.") \
     M(MergeTreeReadTaskRequestsSent, "The current number of callback requests in flight from the remote server back to the initiator server to choose the read task (for MergeTree tables). Measured on the remote server side.") \
-    M(MergeTreeAllRangesAnnouncementsSent, "The current number of announcement being sent in flight from the remote server to the initiator server about the set of data parts (for MergeTree tables). Measured on the remote server side.")
-
+    M(MergeTreeAllRangesAnnouncementsSent, "The current number of announcement being sent in flight from the remote server to the initiator server about the set of data parts (for MergeTree tables). Measured on the remote server side.") \
+    M(CreatedTimersInQueryProfiler, "Number of Created thread local timers in QueryProfiler") \
+    M(ActiveTimersInQueryProfiler, "Number of Active thread local timers in QueryProfiler")
 
 namespace CurrentMetrics
 {
diff --git a/src/Common/QueryProfiler.cpp b/src/Common/QueryProfiler.cpp
index e1af3ad7724..085c8fb8af4 100644
--- a/src/Common/QueryProfiler.cpp
+++ b/src/Common/QueryProfiler.cpp
@@ -2,6 +2,7 @@
 
 #include <IO/WriteHelpers.h>
 #include <Common/TraceSender.h>
+#include <Common/CurrentMetrics.h>
 #include <Common/Exception.h>
 #include <Common/StackTrace.h>
 #include <Common/thread_local_rng.h>
@@ -12,6 +13,11 @@
 
 #include <random>
 
+namespace CurrentMetrics
+{
+    extern const Metric CreatedTimersInQueryProfiler;
+    extern const Metric ActiveTimersInQueryProfiler;
+}
 
 namespace ProfileEvents
 {
@@ -85,48 +91,14 @@ namespace ErrorCodes
     extern const int NOT_IMPLEMENTED;
 }
 
-template <typename ProfilerImpl>
-QueryProfilerBase<ProfilerImpl>::QueryProfilerBase(UInt64 thread_id, int clock_type, UInt32 period, int pause_signal_)
-    : log(&Poco::Logger::get("QueryProfiler"))
-    , pause_signal(pause_signal_)
+#if USE_UNWIND
+Timer::Timer()
+    : log(&Poco::Logger::get("Timer"))
+{}
+
+void Timer::createIfNecessary(UInt64 thread_id, int clock_type, int pause_signal)
 {
-#if defined(SANITIZER)
-    UNUSED(thread_id);
-    UNUSED(clock_type);
-    UNUSED(period);
-    UNUSED(pause_signal);
-
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "QueryProfiler disabled because they cannot work under sanitizers");
-#elif !USE_UNWIND
-    UNUSED(thread_id);
-    UNUSED(clock_type);
-    UNUSED(period);
-    UNUSED(pause_signal);
-
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "QueryProfiler cannot work with stock libunwind");
-#else
-    /// Sanity check.
-    if (!hasPHDRCache())
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "QueryProfiler cannot be used without PHDR cache, that is not available for TSan build");
-
-    /// Too high frequency can introduce infinite busy loop of signal handlers. We will limit maximum frequency (with 1000 signals per second).
-    if (period < 1000000)
-        period = 1000000;
-
-    struct sigaction sa{};
-    sa.sa_sigaction = ProfilerImpl::signalHandler;
-    sa.sa_flags = SA_SIGINFO | SA_RESTART;
-
-    if (sigemptyset(&sa.sa_mask))
-        throwFromErrno("Failed to clean signal mask for query profiler", ErrorCodes::CANNOT_MANIPULATE_SIGSET);
-
-    if (sigaddset(&sa.sa_mask, pause_signal))
-        throwFromErrno("Failed to add signal to mask for query profiler", ErrorCodes::CANNOT_MANIPULATE_SIGSET);
-
-    if (sigaction(pause_signal, &sa, nullptr))
-        throwFromErrno("Failed to setup signal handler for query profiler", ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
-
-    try
+    if (!timer_id)
     {
         struct sigevent sev {};
         sev.sigev_notify = SIGEV_THREAD_ID;
@@ -151,25 +123,117 @@ QueryProfilerBase<ProfilerImpl>::QueryProfilerBase(UInt64 thread_id, int clock_t
             throwFromErrno("Failed to create thread timer", ErrorCodes::CANNOT_CREATE_TIMER);
         }
         timer_id.emplace(local_timer_id);
+        CurrentMetrics::add(CurrentMetrics::CreatedTimersInQueryProfiler);
+    }
+}
 
-        /// Randomize offset as uniform random value from 0 to period - 1.
-        /// It will allow to sample short queries even if timer period is large.
-        /// (For example, with period of 1 second, query with 50 ms duration will be sampled with 1 / 20 probability).
-        /// It also helps to avoid interference (moire).
-        UInt32 period_rand = std::uniform_int_distribution<UInt32>(0, period)(thread_local_rng);
+void Timer::set(UInt32 period)
+{
+    /// Too high frequency can introduce infinite busy loop of signal handlers. We will limit maximum frequency (with 1000 signals per second).
+    if (period < 1000000)
+        period = 1000000;
+    /// Randomize offset as uniform random value from 0 to period - 1.
+    /// It will allow to sample short queries even if timer period is large.
+    /// (For example, with period of 1 second, query with 50 ms duration will be sampled with 1 / 20 probability).
+    /// It also helps to avoid interference (moire).
+    UInt32 period_rand = std::uniform_int_distribution<UInt32>(0, period)(thread_local_rng);
 
-        struct timespec interval{.tv_sec = period / TIMER_PRECISION, .tv_nsec = period % TIMER_PRECISION};
-        struct timespec offset{.tv_sec = period_rand / TIMER_PRECISION, .tv_nsec = period_rand % TIMER_PRECISION};
+    struct timespec interval{.tv_sec = period / TIMER_PRECISION, .tv_nsec = period % TIMER_PRECISION};
+    struct timespec offset{.tv_sec = period_rand / TIMER_PRECISION, .tv_nsec = period_rand % TIMER_PRECISION};
 
-        struct itimerspec timer_spec = {.it_interval = interval, .it_value = offset};
-        if (timer_settime(*timer_id, 0, &timer_spec, nullptr))
-            throwFromErrno("Failed to set thread timer period", ErrorCodes::CANNOT_SET_TIMER_PERIOD);
+    struct itimerspec timer_spec = {.it_interval = interval, .it_value = offset};
+    if (timer_settime(*timer_id, 0, &timer_spec, nullptr))
+        throwFromErrno("Failed to set thread timer period", ErrorCodes::CANNOT_SET_TIMER_PERIOD);
+    CurrentMetrics::add(CurrentMetrics::ActiveTimersInQueryProfiler);
+}
 
+void Timer::stop()
+{
+    if (timer_id)
+    {
+        struct timespec stop_timer{.tv_sec = 0, .tv_nsec = 0};
+        struct itimerspec timer_spec = {.it_interval = stop_timer, .it_value = stop_timer};
+        int err = timer_settime(*timer_id, 0, &timer_spec, nullptr);
+        if (err)
+            LOG_ERROR(log, "Failed to stop query profiler timer {}", errnoToString());
+        chassert(!err && "Failed to stop query profiler timer");
+        CurrentMetrics::sub(CurrentMetrics::ActiveTimersInQueryProfiler);
+    }
+}
+
+Timer::~Timer()
+{
+    try
+    {
+        cleanup();
+    }
+    catch (...)
+    {
+        tryLogCurrentException(log);
+    }
+}
+
+void Timer::cleanup()
+{
+    if (timer_id)
+    {
+        int err = timer_delete(*timer_id);
+        if (err)
+            LOG_ERROR(log, "Failed to delete query profiler timer {}", errnoToString());
+        chassert(!err && "Failed to delete query profiler timer");
+
+        timer_id.reset();
+        CurrentMetrics::sub(CurrentMetrics::CreatedTimersInQueryProfiler);
+    }
+}
+#endif
+
+template <typename ProfilerImpl>
+QueryProfilerBase<ProfilerImpl>::QueryProfilerBase(UInt64 thread_id, int clock_type, UInt32 period, int pause_signal_)
+    : log(&Poco::Logger::get("QueryProfiler"))
+    , pause_signal(pause_signal_)
+{
+#if defined(SANITIZER)
+    UNUSED(thread_id);
+    UNUSED(clock_type);
+    UNUSED(period);
+    UNUSED(pause_signal);
+
+    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "QueryProfiler disabled because they cannot work under sanitizers");
+#elif !USE_UNWIND
+    UNUSED(thread_id);
+    UNUSED(clock_type);
+    UNUSED(period);
+    UNUSED(pause_signal);
+
+    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "QueryProfiler cannot work with stock libunwind");
+#else
+    /// Sanity check.
+    if (!hasPHDRCache())
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "QueryProfiler cannot be used without PHDR cache, that is not available for TSan build");
+
+    struct sigaction sa{};
+    sa.sa_sigaction = ProfilerImpl::signalHandler;
+    sa.sa_flags = SA_SIGINFO | SA_RESTART;
+
+    if (sigemptyset(&sa.sa_mask))
+        throwFromErrno("Failed to clean signal mask for query profiler", ErrorCodes::CANNOT_MANIPULATE_SIGSET);
+
+    if (sigaddset(&sa.sa_mask, pause_signal))
+        throwFromErrno("Failed to add signal to mask for query profiler", ErrorCodes::CANNOT_MANIPULATE_SIGSET);
+
+    if (sigaction(pause_signal, &sa, nullptr))
+        throwFromErrno("Failed to setup signal handler for query profiler", ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
+
+    try
+    {
+        timer.createIfNecessary(thread_id, clock_type, pause_signal);
+        timer.set(period);
         signal_handler_disarmed = false;
     }
     catch (...)
     {
-        tryCleanup();
+        timer.cleanup();
         throw;
     }
 #endif
@@ -178,22 +242,21 @@ QueryProfilerBase<ProfilerImpl>::QueryProfilerBase(UInt64 thread_id, int clock_t
 template <typename ProfilerImpl>
 QueryProfilerBase<ProfilerImpl>::~QueryProfilerBase()
 {
-    tryCleanup();
+    try
+    {
+        cleanup();
+    }
+    catch (...)
+    {
+        tryLogCurrentException(log);
+    }
 }
 
 template <typename ProfilerImpl>
-void QueryProfilerBase<ProfilerImpl>::tryCleanup()
+void QueryProfilerBase<ProfilerImpl>::cleanup()
 {
 #if USE_UNWIND
-    if (timer_id.has_value())
-    {
-        int err = timer_delete(*timer_id);
-        if (err)
-            LOG_ERROR(log, "Failed to delete query profiler timer {}", errnoToString());
-        chassert(!err && "Failed to delete query profiler timer");
-        timer_id.reset();
-    }
-
+    timer.stop();
     signal_handler_disarmed = true;
 #endif
 }
diff --git a/src/Common/QueryProfiler.h b/src/Common/QueryProfiler.h
index fb2f470b6d6..6a9ed10e315 100644
--- a/src/Common/QueryProfiler.h
+++ b/src/Common/QueryProfiler.h
@@ -27,6 +27,27 @@ namespace DB
   * Destructor tries to unset timer and restore previous signal handler.
   * Note that signal handler implementation is defined by template parameter. See QueryProfilerReal and QueryProfilerCPU.
   */
+
+#if USE_UNWIND
+class Timer
+{
+public:
+    Timer();
+    Timer(const Timer &) = delete;
+    Timer & operator = (const Timer &) = delete;
+    ~Timer();
+
+    void createIfNecessary(UInt64 thread_id, int clock_type, int pause_signal);
+    void set(UInt32 period);
+    void stop();
+    void cleanup();
+
+private:
+    Poco::Logger * log;
+    std::optional<timer_t> timer_id;
+};
+#endif
+
 template <typename ProfilerImpl>
 class QueryProfilerBase
 {
@@ -35,13 +56,12 @@ public:
     ~QueryProfilerBase();
 
 private:
-    void tryCleanup();
+    void cleanup();
 
     Poco::Logger * log;
 
 #if USE_UNWIND
-    /// Timer id from timer_create(2)
-    std::optional<timer_t> timer_id;
+    inline static thread_local Timer timer = Timer();
 #endif
 
     /// Pause signal to interrupt threads to get traces

From 87904976edc57ba13e011ae01e000602f653f776 Mon Sep 17 00:00:00 2001
From: tpanetti <Thomas.Panetti@clickhouse.com>
Date: Wed, 14 Jun 2023 13:04:20 -0700
Subject: [PATCH 455/722] Fix test for MySQL Compatible Types (suppress
 password warning)

---
 .../0_stateless/02775_show_columns_mysql_compatibility.sh       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
index 89881a4cf60..c86519b6f5d 100755
--- a/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
+++ b/tests/queries/0_stateless/02775_show_columns_mysql_compatibility.sh
@@ -146,7 +146,7 @@ EOT
 
 # Now run the MySQL test script on the ClickHouse DB
 echo "Run MySQL test"
-${MYSQL_CLIENT} --user="$USER" --password="$PASSWORD" --host="$HOST" --port="$PORT" < $TEMP_FILE
+MYSQL_PWD=$PASSWORD ${MYSQL_CLIENT} --user="$USER" --host="$HOST" --port="$PORT" < $TEMP_FILE
 
 # Clean up the temp file
 rm $TEMP_FILE

From 40d4508a72d232aca4d0cfa652315729cc898aeb Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 14 Jun 2023 17:32:03 -0400
Subject: [PATCH 456/722] catch ru changelog up to 2023

---
 docs/ru/whats-new/changelog/2017.mdx       |  2 +-
 docs/ru/whats-new/changelog/2018.mdx       |  2 +-
 docs/ru/whats-new/changelog/2019.mdx       |  2 +-
 docs/ru/whats-new/changelog/2020.mdx       |  2 +-
 docs/ru/whats-new/changelog/2021.mdx       |  2 +-
 docs/ru/whats-new/changelog/2022.mdx       | 10 ++++++++++
 docs/ru/whats-new/changelog/_category_.yml |  4 ++--
 docs/ru/whats-new/changelog/index.mdx      |  4 ++--
 8 files changed, 19 insertions(+), 9 deletions(-)
 create mode 100644 docs/ru/whats-new/changelog/2022.mdx

diff --git a/docs/ru/whats-new/changelog/2017.mdx b/docs/ru/whats-new/changelog/2017.mdx
index 9d1c7220f3d..93df717ea8f 100644
--- a/docs/ru/whats-new/changelog/2017.mdx
+++ b/docs/ru/whats-new/changelog/2017.mdx
@@ -1,6 +1,6 @@
 ---
 slug: /ru/whats-new/changelog/2017
-sidebar_position: 6
+sidebar_position: 60
 sidebar_label: 2017
 title: 2017 Changelog
 ---
diff --git a/docs/ru/whats-new/changelog/2018.mdx b/docs/ru/whats-new/changelog/2018.mdx
index fb804afa293..fdb26416c27 100644
--- a/docs/ru/whats-new/changelog/2018.mdx
+++ b/docs/ru/whats-new/changelog/2018.mdx
@@ -1,6 +1,6 @@
 ---
 slug: /ru/whats-new/changelog/2018
-sidebar_position: 5
+sidebar_position: 50
 sidebar_label: 2018
 title: 2018 Changelog
 ---
diff --git a/docs/ru/whats-new/changelog/2019.mdx b/docs/ru/whats-new/changelog/2019.mdx
index caea40f6077..ff025ab7aa7 100644
--- a/docs/ru/whats-new/changelog/2019.mdx
+++ b/docs/ru/whats-new/changelog/2019.mdx
@@ -1,6 +1,6 @@
 ---
 slug: /ru/whats-new/changelog/2019
-sidebar_position: 4
+sidebar_position: 40
 sidebar_label: 2019
 title: 2019 Changelog
 ---
diff --git a/docs/ru/whats-new/changelog/2020.mdx b/docs/ru/whats-new/changelog/2020.mdx
index 51943785a4a..aa53b0a09d9 100644
--- a/docs/ru/whats-new/changelog/2020.mdx
+++ b/docs/ru/whats-new/changelog/2020.mdx
@@ -1,6 +1,6 @@
 ---
 slug: /ru/whats-new/changelog/2020
-sidebar_position: 3
+sidebar_position: 30
 sidebar_label: 2020
 title: 2020 Changelog
 ---
diff --git a/docs/ru/whats-new/changelog/2021.mdx b/docs/ru/whats-new/changelog/2021.mdx
index d517bad19e6..97b44b4321e 100644
--- a/docs/ru/whats-new/changelog/2021.mdx
+++ b/docs/ru/whats-new/changelog/2021.mdx
@@ -1,6 +1,6 @@
 ---
 slug: /ru/whats-new/changelog/2021
-sidebar_position: 2
+sidebar_position: 20
 sidebar_label: 2021
 title: 2021 Changelog
 ---
diff --git a/docs/ru/whats-new/changelog/2022.mdx b/docs/ru/whats-new/changelog/2022.mdx
new file mode 100644
index 00000000000..c70fbfda355
--- /dev/null
+++ b/docs/ru/whats-new/changelog/2022.mdx
@@ -0,0 +1,10 @@
+---
+slug: /ru/whats-new/changelog/2022
+sidebar_position: 10
+sidebar_label: 2022
+title: 2022 Changelog
+---
+
+import Changelog from '@site/docs/en/whats-new/changelog/2022.md';
+
+<Changelog />
diff --git a/docs/ru/whats-new/changelog/_category_.yml b/docs/ru/whats-new/changelog/_category_.yml
index 7a496eace66..5be70a51ac0 100644
--- a/docs/ru/whats-new/changelog/_category_.yml
+++ b/docs/ru/whats-new/changelog/_category_.yml
@@ -2,5 +2,5 @@ label: 'Changelog'
 collapsible: true
 collapsed: true
 link:
-  type: doc
-  id: ru/whats-new/changelog/index
+  type: generated-index
+  title: Changelog
diff --git a/docs/ru/whats-new/changelog/index.mdx b/docs/ru/whats-new/changelog/index.mdx
index 311be3be313..b69bf91b300 100644
--- a/docs/ru/whats-new/changelog/index.mdx
+++ b/docs/ru/whats-new/changelog/index.mdx
@@ -1,7 +1,7 @@
 ---
 sidebar_position: 1
-sidebar_label: 2022
-title: 2022 Changelog
+sidebar_label: 2023
+title: 2023 Changelog
 slug: /ru/whats-new/changelog/index
 ---
 

From 005e7d3b27a4f212cae081475c6bfffc0fcee1b9 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 14 Jun 2023 17:40:29 -0400
Subject: [PATCH 457/722] Chinese also

---
 docs/zh/whats-new/changelog/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/zh/whats-new/changelog/index.md b/docs/zh/whats-new/changelog/index.md
index 8fd19a0f1d8..3df4e40b204 100644
--- a/docs/zh/whats-new/changelog/index.md
+++ b/docs/zh/whats-new/changelog/index.md
@@ -6,4 +6,4 @@ sidebar_label:  Changelog
 
 # Changelog
 
-You can view the latest Changelog at [https://clickhouse.com/docs/en/whats-new/changelog/](https://clickhouse.com/docs/en/whats-new/changelog/)
\ No newline at end of file
+You can view the latest Changelog at [https://clickhouse.com/docs/en/whats-new/changelog/](/docs/en/whats-new/changelog/index.md)

From e75cb90b7d66b136cc4d51aebb73ed0387565df2 Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Wed, 14 Jun 2023 17:56:34 -0400
Subject: [PATCH 458/722] Update gcs.md

fix nav

closes https://github.com/ClickHouse/clickhouse-docs/issues/1230
---
 docs/en/sql-reference/table-functions/gcs.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/table-functions/gcs.md b/docs/en/sql-reference/table-functions/gcs.md
index bfa7f36fa48..8574f3ecb9c 100644
--- a/docs/en/sql-reference/table-functions/gcs.md
+++ b/docs/en/sql-reference/table-functions/gcs.md
@@ -1,7 +1,7 @@
 ---
 slug: /en/sql-reference/table-functions/gcs
 sidebar_position: 45
-sidebar_label: s3
+sidebar_label: gcs
 keywords: [gcs, bucket]
 ---
 

From 93e0e2c7cfd4b472c4e9afe5751a05dd764f9882 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Wed, 14 Jun 2023 19:04:20 -0300
Subject: [PATCH 459/722] Update mergetree.md

---
 docs/en/engines/table-engines/mergetree-family/mergetree.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/engines/table-engines/mergetree-family/mergetree.md b/docs/en/engines/table-engines/mergetree-family/mergetree.md
index dbde1a90f67..42454af6feb 100644
--- a/docs/en/engines/table-engines/mergetree-family/mergetree.md
+++ b/docs/en/engines/table-engines/mergetree-family/mergetree.md
@@ -853,7 +853,7 @@ Tags:
 - `max_data_part_size_bytes` — the maximum size of a part that can be stored on any of the volume’s disks. If the a size of a merged part estimated to be bigger than `max_data_part_size_bytes` then this part will be written to a next volume. Basically this feature allows to keep new/small parts on a hot (SSD) volume and move them to a cold (HDD) volume when they reach large size. Do not use this setting if your policy has only one volume.
 - `move_factor` — when the amount of available space gets lower than this factor, data automatically starts to move on the next volume if any (by default, 0.1). ClickHouse sorts existing parts by size from largest to smallest (in descending order) and selects parts with the total size that is sufficient to meet the `move_factor` condition. If the total size of all parts is insufficient, all parts will be moved.
 - `prefer_not_to_merge` — Disables merging of data parts on this volume. When this setting is enabled, merging data on this volume is not allowed. This allows controlling how ClickHouse works with slow disks.
-- `perform_ttl_move_on_insert` — Disables TTL move on data part INSERT. By default if we insert a data part that already expired by the TTL move rule it immediately goes to a volume/disk declared in move rule. This can significantly slowdown insert in case if destination volume/disk is slow (e.g. S3).
+- `perform_ttl_move_on_insert` — Disables TTL move on data part INSERT. By default (if enabled) if we insert a data part that already expired by the TTL move rule it immediately goes to a volume/disk declared in move rule. This can significantly slowdown insert in case if destination volume/disk is slow (e.g. S3). If disabled then already expired data part is written into a default volume and then right after moved to TTL volume.
 - `load_balancing` - Policy for disk balancing, `round_robin` or `least_used`.
 
 Configuration examples:

From badde0fde2a2f8134f8491dd4b28ead45d016d1f Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Sat, 10 Jun 2023 01:00:50 +0000
Subject: [PATCH 460/722] Print git hash when crashing

---
 src/Daemon/BaseDaemon.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index 4780dfed4b2..4dd6809d726 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -275,8 +275,8 @@ private:
     {
         size_t pos = message.find('\n');
 
-        LOG_FATAL(log, "(version {}{}, build id: {}) (from thread {}) {}",
-            VERSION_STRING, VERSION_OFFICIAL, daemon.build_id, thread_num, message.substr(0, pos));
+        LOG_FATAL(log, "(version {}{}, build id: {}, git hash: {}) (from thread {}) {}",
+            VERSION_STRING, VERSION_OFFICIAL, daemon.build_id, daemon.git_hash, thread_num, message.substr(0, pos));
 
         /// Print trace from std::terminate exception line-by-line to make it easy for grep.
         while (pos != std::string_view::npos)
@@ -332,14 +332,14 @@ private:
 
         if (query_id.empty())
         {
-            LOG_FATAL(log, "(version {}{}, build id: {}) (from thread {}) (no query) Received signal {} ({})",
-                VERSION_STRING, VERSION_OFFICIAL, daemon.build_id,
+            LOG_FATAL(log, "(version {}{}, build id: {}, git hash: {}) (from thread {}) (no query) Received signal {} ({})",
+                VERSION_STRING, VERSION_OFFICIAL, daemon.build_id, daemon.git_hash,
                 thread_num, signal_description, sig);
         }
         else
         {
-            LOG_FATAL(log, "(version {}{}, build id: {}) (from thread {}) (query_id: {}) (query: {}) Received signal {} ({})",
-                VERSION_STRING, VERSION_OFFICIAL, daemon.build_id,
+            LOG_FATAL(log, "(version {}{}, build id: {}, git hash: {}) (from thread {}) (query_id: {}) (query: {}) Received signal {} ({})",
+                VERSION_STRING, VERSION_OFFICIAL, daemon.build_id, daemon.git_hash,
                 thread_num, query_id, query, signal_description, sig);
         }
 

From 75e6b4475dd624b7f0650c8388bb9253020fb25f Mon Sep 17 00:00:00 2001
From: Alexey Gerasimchuck <a.gerasimchuck@arenadata.io>
Date: Wed, 14 Jun 2023 22:35:38 +0000
Subject: [PATCH 461/722] corrections after review

---
 programs/client/Client.cpp | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 8044ce434a8..54b091700b2 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -1394,7 +1394,9 @@ void Client::readArguments(
             else if (arg == "--password" && ((arg_num + 1) >= argc || std::string_view(argv[arg_num + 1]).starts_with('-')))
             {
                 common_arguments.emplace_back(arg);
-                // Add implicit value to the password. '\n' means client should ask user for password.
+                /// No password was provided by user. Add '\n' as implicit password,
+                /// which encodes that client should ask user for the password.
+                /// '\n' is used because there is hardly a chance that a user would use '\n' as a password.
                 common_arguments.emplace_back("\n");
             }
             else

From 11dfd35cd71e1af62499c3e89967d5b2524353f4 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 15 Jun 2023 10:45:18 +0300
Subject: [PATCH 462/722] Amend the docs following the reviewer's pointers

---
 .../functions/type-conversion-functions.md             | 10 +++++-----
 .../functions/type-conversion-functions.md             | 10 +++++-----
 2 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/en/sql-reference/functions/type-conversion-functions.md b/docs/en/sql-reference/functions/type-conversion-functions.md
index 679ef6e0a42..214c885bc0e 100644
--- a/docs/en/sql-reference/functions/type-conversion-functions.md
+++ b/docs/en/sql-reference/functions/type-conversion-functions.md
@@ -1511,10 +1511,10 @@ parseDateTimeBestEffort(time_string [, time_zone])
 - A string with a date, but no time component: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` etc.
 - A string with a day and time: `DD`, `DD hh`, `DD hh:mm`. In this case `MM` is substituted by `01`.
 - A string that includes the date and time along with time zone offset information: `YYYY-MM-DD hh:mm:ss ±h:mm`, etc. For example, `2020-12-12 17:36:00 -5:00`.
-- A string that includes the date and time in the [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164) format. For example, `Jun  9 14:20:32`.
+- A [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164#section-4.1.2): `Mmm dd hh:mm:ss`. For example, `Jun  9 14:20:32`.
 
 For all of the formats with separator the function parses months names expressed by their full name or by the first three letters of a month name. Examples: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
-If the year is not specified, it is considered to be equal to the current year. If the resulting date and time happens to be ahead of the current moment even by a second, the current year is substituted by the previous one.
+If the year is not specified, it is considered to be equal to the current year. If the resulting DateTime happen to be in the future (even by a second after the current moment), then the current year is substituted by the previous year.
 
 **Returned value**
 
@@ -1613,8 +1613,8 @@ Result:
 
 ```response
 ┌──────────────ts_now─┬─syslog_arg──────┬─parseDateTimeBestEffort(syslog_arg)─┐
-│ 2023-06-09 16:04:30 │ Jun  9 16:04:00 │                 2023-06-09 16:04:00 │
-│ 2023-06-09 16:04:30 │ Jun  9 16:05:00 │                 2022-06-09 16:05:00 │
+│ 2023-06-30 23:59:30 │ Jun 30 23:59:00 │                 2023-06-30 23:59:00 │
+│ 2023-06-30 23:59:30 │ Jul  1 00:00:00 │                 2022-07-01 00:00:00 │
 └─────────────────────┴─────────────────┴─────────────────────────────────────┘
 ```
 
@@ -1624,7 +1624,7 @@ Result:
 - [toDate](#todate)
 - [toDateTime](#todatetime)
 - [ISO 8601 announcement by @xkcd](https://xkcd.com/1179/)
-- [RFC 3164](https://datatracker.ietf.org/doc/html/rfc3164)
+- [RFC 3164](https://datatracker.ietf.org/doc/html/rfc3164#section-4.1.2)
 
 ## parseDateTimeBestEffortUS
 
diff --git a/docs/ru/sql-reference/functions/type-conversion-functions.md b/docs/ru/sql-reference/functions/type-conversion-functions.md
index f856c42f8b2..d5e6246fe9e 100644
--- a/docs/ru/sql-reference/functions/type-conversion-functions.md
+++ b/docs/ru/sql-reference/functions/type-conversion-functions.md
@@ -1225,10 +1225,10 @@ parseDateTimeBestEffort(time_string[, time_zone])
 -   Строка с датой, но без времени: `YYYY`, `YYYYMM`, `YYYY*MM`, `DD/MM/YYYY`, `DD-MM-YY` и т.д.
 -   Строка с временем, и с днём: `DD`, `DD hh`, `DD hh:mm`. В этом случае `MM` принимается равным `01`.
 -   Строка, содержащая дату и время вместе с информацией о часовом поясе: `YYYY-MM-DD hh:mm:ss ±h:mm`, и т.д. Например, `2020-12-12 17:36:00 -5:00`.
--   Строка, содержащая дату и время в формате [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164). Например, `Jun  9 14:20:32`.
+-   Строка, содержащая дату и время в формате [syslog timestamp](https://datatracker.ietf.org/doc/html/rfc3164#section-4.1.2): `Mmm dd hh:mm:ss`. Например, `Jun  9 14:20:32`.
 
 Для всех форматов с разделителями функция распознаёт названия месяцев, выраженных в виде полного англоязычного имени месяца или в виде первых трёх символов имени месяца. Примеры: `24/DEC/18`, `24-Dec-18`, `01-September-2018`.
-Если год не указан, вместо него подставляется текущий год. Если в результате получается будущее время, хотя бы на одну секунду впереди, текущий год заменяется на прошлый.
+Если год не указан, вместо него подставляется текущий год. Если в результате получается будущее время (даже на одну секунду впереди текущего момента времени), то текущий год заменяется на прошлый.
 
 **Возвращаемое значение**
 
@@ -1327,8 +1327,8 @@ FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around);
 
 ``` text
 ┌──────────────ts_now─┬─syslog_arg──────┬─parseDateTimeBestEffort(syslog_arg)─┐
-│ 2023-06-09 16:04:30 │ Jun  9 16:04:00 │                 2023-06-09 16:04:00 │
-│ 2023-06-09 16:04:30 │ Jun  9 16:05:00 │                 2022-06-09 16:05:00 │
+│ 2023-06-30 23:59:30 │ Jun 30 23:59:00 │                 2023-06-30 23:59:00 │
+│ 2023-06-30 23:59:30 │ Jul  1 00:00:00 │                 2022-07-01 00:00:00 │
 └─────────────────────┴─────────────────┴─────────────────────────────────────┘
 ```
 
@@ -1338,7 +1338,7 @@ FROM (SELECT arrayJoin([ts_now - 30, ts_now + 30]) AS ts_around);
 -   [RFC 1123](https://datatracker.ietf.org/doc/html/rfc1123)
 -   [toDate](#todate)
 -   [toDateTime](#todatetime)
--   [RFC 3164](https://datatracker.ietf.org/doc/html/rfc3164)
+-   [RFC 3164](https://datatracker.ietf.org/doc/html/rfc3164#section-4.1.2)
 
 ## parseDateTimeBestEffortUS {#parsedatetimebesteffortUS}
 

From 5026e0f49220a155ccb0676f4d750d6617b13ba5 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 15 Jun 2023 10:47:22 +0300
Subject: [PATCH 463/722] Tackle the test's flakiness

---
 ...3_parsedatetimebesteffort_syslog.reference |  89 ++++++++++-
 .../02783_parsedatetimebesteffort_syslog.sql  | 144 ++++++++++++------
 2 files changed, 185 insertions(+), 48 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
index ee75d68bff4..ec995426032 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
@@ -1,4 +1,85 @@
- around_June_7                     res               res_sam               res_auc              res_null          res_null_sam          res_null_auc              res_zero          res_zero_sam          res_zero_auc                res_us            res_us_sam            res_us_auc           res_us_null       res_us_null_sam       res_us_null_auc           res_us_zero       res_us_zero_sam       res_us_zero_auc                     res64                 res64_sam                 res64_auc                res64_null            res64_null_sam            res64_null_auc                res64_zero            res64_zero_sam            res64_zero_auc                  res64_us              res64_us_sam              res64_us_auc             res64_us_null         res64_us_null_sam         res64_us_null_auc             res64_us_zero         res64_us_zero_sam         res64_us_zero_auc
-
- Jun  6 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000   2023-06-06 00:00:00.000 
- Jun  8 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000   2022-06-08 00:00:00.000 
+The reference time point is 2023-05-31 23:30:00
+───────────────────────────────
+Before the reference time point
+───────────────────────────────
+Row 1:
+──────
+syslog_arg:        May 31 22:30:00
+res:               2023-05-31 22:30:00
+res_sam:           2022-05-31 22:30:00
+res_auc:           2023-05-31 22:30:00
+res_null:          2023-05-31 22:30:00
+res_null_sam:      2022-05-31 22:30:00
+res_null_auc:      2023-05-31 22:30:00
+res_zero:          2023-05-31 22:30:00
+res_zero_sam:      2022-05-31 22:30:00
+res_zero_auc:      2023-05-31 22:30:00
+res_us:            2023-05-31 22:30:00
+res_us_sam:        2022-05-31 22:30:00
+res_us_auc:        2023-05-31 22:30:00
+res_us_null:       2023-05-31 22:30:00
+res_us_null_sam:   2022-05-31 22:30:00
+res_us_null_auc:   2023-05-31 22:30:00
+res_us_zero:       2023-05-31 22:30:00
+res_us_zero_sam:   2022-05-31 22:30:00
+res_us_zero_auc:   2023-05-31 22:30:00
+res64:             2023-05-31 22:30:00.000
+res64_sam:         2022-05-31 22:30:00.000
+res64_auc:         2023-05-31 22:30:00.000
+res64_null:        2023-05-31 22:30:00.000
+res64_null_sam:    2022-05-31 22:30:00.000
+res64_null_auc:    2023-05-31 22:30:00.000
+res64_zero:        2023-05-31 22:30:00.000
+res64_zero_sam:    2022-05-31 22:30:00.000
+res64_zero_auc:    2023-05-31 22:30:00.000
+res64_us:          2023-05-31 22:30:00.000
+res64_us_sam:      2022-05-31 22:30:00.000
+res64_us_auc:      2023-05-31 22:30:00.000
+res64_us_null:     2023-05-31 22:30:00.000
+res64_us_null_sam: 2022-05-31 22:30:00.000
+res64_us_null_auc: 2023-05-31 22:30:00.000
+res64_us_zero:     2023-05-31 22:30:00.000
+res64_us_zero_sam: 2022-05-31 22:30:00.000
+res64_us_zero_auc: 2023-05-31 22:30:00.000
+──────────────────────────────
+After the reference time point
+──────────────────────────────
+Row 1:
+──────
+syslog_arg:        Jun  1 00:30:00
+res:               2022-06-01 00:30:00
+res_sam:           2022-06-01 00:30:00
+res_auc:           2023-06-01 00:30:00
+res_null:          2022-06-01 00:30:00
+res_null_sam:      2022-06-01 00:30:00
+res_null_auc:      2023-06-01 00:30:00
+res_zero:          2022-06-01 00:30:00
+res_zero_sam:      2022-06-01 00:30:00
+res_zero_auc:      2023-06-01 00:30:00
+res_us:            2022-06-01 00:30:00
+res_us_sam:        2022-06-01 00:30:00
+res_us_auc:        2023-06-01 00:30:00
+res_us_null:       2022-06-01 00:30:00
+res_us_null_sam:   2022-06-01 00:30:00
+res_us_null_auc:   2023-06-01 00:30:00
+res_us_zero:       2022-06-01 00:30:00
+res_us_zero_sam:   2022-06-01 00:30:00
+res_us_zero_auc:   2023-06-01 00:30:00
+res64:             2022-06-01 00:30:00.000
+res64_sam:         2022-06-01 00:30:00.000
+res64_auc:         2023-06-01 00:30:00.000
+res64_null:        2022-06-01 00:30:00.000
+res64_null_sam:    2022-06-01 00:30:00.000
+res64_null_auc:    2023-06-01 00:30:00.000
+res64_zero:        2022-06-01 00:30:00.000
+res64_zero_sam:    2022-06-01 00:30:00.000
+res64_zero_auc:    2023-06-01 00:30:00.000
+res64_us:          2022-06-01 00:30:00.000
+res64_us_sam:      2022-06-01 00:30:00.000
+res64_us_auc:      2023-06-01 00:30:00.000
+res64_us_null:     2022-06-01 00:30:00.000
+res64_us_null_sam: 2022-06-01 00:30:00.000
+res64_us_null_auc: 2023-06-01 00:30:00.000
+res64_us_zero:     2022-06-01 00:30:00.000
+res64_us_zero_sam: 2022-06-01 00:30:00.000
+res64_us_zero_auc: 2023-06-01 00:30:00.000
diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
index f3ca78e8310..bc0f28e9fc5 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
@@ -1,46 +1,102 @@
+SELECT 'The reference time point is 2023-05-31 23:30:00';
+SELECT '───────────────────────────────';
+SELECT 'Before the reference time point';
+SELECT '───────────────────────────────';
+
 WITH
-    86400 AS secs_in_day,
-    now() AS ts_now,
-    '2023-06-07' AS ref_point,
-    dateDiff('second', toDateTime(ref_point), ts_now) AS time_shift,
-    formatDateTime(ts_around, '%b %e %T') AS dt_curr
+    3600 AS delta,
+    toDateTime('2023-05-31 23:30:00') AS dt_ref,
+    now() AS dt_now, 
+    dt_now - delta as dt_before,
+    dateDiff('second', dt_ref, dt_now) AS time_shift,
+    formatDateTime(dt_before, '%b %e %T') AS syslog_before
 SELECT
-    formatDateTime(ts_around - time_shift, '%b %e %H:%i:%s') AS around_June_7,
-    parseDateTimeBestEffort(dt_curr) - time_shift AS res,
-    parseDateTimeBestEffort(dt_curr, 'US/Samoa') - time_shift AS res_sam,
-    parseDateTimeBestEffort(dt_curr, 'Pacific/Auckland') - time_shift AS res_auc,
-    parseDateTimeBestEffortOrNull(dt_curr) - time_shift AS res_null,
-    parseDateTimeBestEffortOrNull(dt_curr, 'US/Samoa') - time_shift AS res_null_sam,
-    parseDateTimeBestEffortOrNull(dt_curr, 'Pacific/Auckland') - time_shift AS res_null_auc,
-    parseDateTimeBestEffortOrZero(dt_curr) - time_shift AS res_zero,
-    parseDateTimeBestEffortOrZero(dt_curr, 'US/Samoa') - time_shift AS res_zero_sam,
-    parseDateTimeBestEffortOrZero(dt_curr, 'Pacific/Auckland') - time_shift AS res_zero_auc,
-    parseDateTimeBestEffortUS(dt_curr) - time_shift AS res_us,
-    parseDateTimeBestEffortUS(dt_curr, 'US/Samoa') - time_shift AS res_us_sam,
-    parseDateTimeBestEffortUS(dt_curr, 'Pacific/Auckland') - time_shift AS res_us_auc,
-    parseDateTimeBestEffortUSOrNull(dt_curr) - time_shift AS res_us_null,
-    parseDateTimeBestEffortUSOrNull(dt_curr, 'US/Samoa') - time_shift AS res_us_null_sam,
-    parseDateTimeBestEffortUSOrNull(dt_curr, 'Pacific/Auckland') - time_shift AS res_us_null_auc,
-    parseDateTimeBestEffortUSOrZero(dt_curr) - time_shift AS res_us_zero,
-    parseDateTimeBestEffortUSOrZero(dt_curr, 'US/Samoa') - time_shift AS res_us_zero_sam,
-    parseDateTimeBestEffortUSOrZero(dt_curr, 'Pacific/Auckland') - time_shift AS res_us_zero_auc,
-    parseDateTime64BestEffort(dt_curr) - time_shift AS res64,
-    parseDateTime64BestEffort(dt_curr, 3, 'US/Samoa') - time_shift AS res64_sam,
-    parseDateTime64BestEffort(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_auc,
-    parseDateTime64BestEffortOrNull(dt_curr) - time_shift AS res64_null,
-    parseDateTime64BestEffortOrNull(dt_curr, 3, 'US/Samoa') - time_shift AS res64_null_sam,
-    parseDateTime64BestEffortOrNull(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_null_auc,
-    parseDateTime64BestEffortOrZero(dt_curr) - time_shift AS res64_zero,
-    parseDateTime64BestEffortOrZero(dt_curr, 3, 'US/Samoa') - time_shift AS res64_zero_sam,
-    parseDateTime64BestEffortOrZero(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_zero_auc,
-    parseDateTime64BestEffortUS(dt_curr) - time_shift AS res64_us,
-    parseDateTime64BestEffortUS(dt_curr, 3, 'US/Samoa') - time_shift AS res64_us_sam,
-    parseDateTime64BestEffortUS(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_us_auc,
-    parseDateTime64BestEffortUSOrNull(dt_curr) - time_shift AS res64_us_null,
-    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'US/Samoa') - time_shift AS res64_us_null_sam,
-    parseDateTime64BestEffortUSOrNull(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_us_null_auc,
-    parseDateTime64BestEffortUSOrZero(dt_curr) - time_shift AS res64_us_zero,
-    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'US/Samoa') - time_shift AS res64_us_zero_sam,
-    parseDateTime64BestEffortUSOrZero(dt_curr, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
-FROM (SELECT arrayJoin([ts_now - secs_in_day, ts_now + secs_in_day]) AS ts_around)
-FORMAT PrettySpaceNoEscapes;
+    formatDateTime(dt_before - time_shift, '%b %e %T') AS syslog_arg,
+    parseDateTimeBestEffort(syslog_before) - time_shift AS res,
+    parseDateTimeBestEffort(syslog_before, 'US/Samoa') - time_shift AS res_sam,
+    parseDateTimeBestEffort(syslog_before, 'Pacific/Auckland') - time_shift AS res_auc,
+    parseDateTimeBestEffortOrNull(syslog_before) - time_shift AS res_null,
+    parseDateTimeBestEffortOrNull(syslog_before, 'US/Samoa') - time_shift AS res_null_sam,
+    parseDateTimeBestEffortOrNull(syslog_before, 'Pacific/Auckland') - time_shift AS res_null_auc,
+    parseDateTimeBestEffortOrZero(syslog_before) - time_shift AS res_zero,
+    parseDateTimeBestEffortOrZero(syslog_before, 'US/Samoa') - time_shift AS res_zero_sam,
+    parseDateTimeBestEffortOrZero(syslog_before, 'Pacific/Auckland') - time_shift AS res_zero_auc,
+    parseDateTimeBestEffortUS(syslog_before) - time_shift AS res_us,
+    parseDateTimeBestEffortUS(syslog_before, 'US/Samoa') - time_shift AS res_us_sam,
+    parseDateTimeBestEffortUS(syslog_before, 'Pacific/Auckland') - time_shift AS res_us_auc,
+    parseDateTimeBestEffortUSOrNull(syslog_before) - time_shift AS res_us_null,
+    parseDateTimeBestEffortUSOrNull(syslog_before, 'US/Samoa') - time_shift AS res_us_null_sam,
+    parseDateTimeBestEffortUSOrNull(syslog_before, 'Pacific/Auckland') - time_shift AS res_us_null_auc,
+    parseDateTimeBestEffortUSOrZero(syslog_before) - time_shift AS res_us_zero,
+    parseDateTimeBestEffortUSOrZero(syslog_before, 'US/Samoa') - time_shift AS res_us_zero_sam,
+    parseDateTimeBestEffortUSOrZero(syslog_before, 'Pacific/Auckland') - time_shift AS res_us_zero_auc,
+    parseDateTime64BestEffort(syslog_before) - time_shift AS res64,
+    parseDateTime64BestEffort(syslog_before, 3, 'US/Samoa') - time_shift AS res64_sam,
+    parseDateTime64BestEffort(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_auc,
+    parseDateTime64BestEffortOrNull(syslog_before) - time_shift AS res64_null,
+    parseDateTime64BestEffortOrNull(syslog_before, 3, 'US/Samoa') - time_shift AS res64_null_sam,
+    parseDateTime64BestEffortOrNull(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_null_auc,
+    parseDateTime64BestEffortOrZero(syslog_before) - time_shift AS res64_zero,
+    parseDateTime64BestEffortOrZero(syslog_before, 3, 'US/Samoa') - time_shift AS res64_zero_sam,
+    parseDateTime64BestEffortOrZero(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_zero_auc,
+    parseDateTime64BestEffortUS(syslog_before) - time_shift AS res64_us,
+    parseDateTime64BestEffortUS(syslog_before, 3, 'US/Samoa') - time_shift AS res64_us_sam,
+    parseDateTime64BestEffortUS(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_auc,
+    parseDateTime64BestEffortUSOrNull(syslog_before) - time_shift AS res64_us_null,
+    parseDateTime64BestEffortUSOrNull(syslog_before, 3, 'US/Samoa') - time_shift AS res64_us_null_sam,
+    parseDateTime64BestEffortUSOrNull(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_null_auc,
+    parseDateTime64BestEffortUSOrZero(syslog_before) - time_shift AS res64_us_zero,
+    parseDateTime64BestEffortUSOrZero(syslog_before, 3, 'US/Samoa') - time_shift AS res64_us_zero_sam,
+    parseDateTime64BestEffortUSOrZero(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
+FORMAT Vertical;
+
+SELECT '──────────────────────────────';
+SELECT 'After the reference time point';
+SELECT '──────────────────────────────';
+
+WITH
+    3600 AS delta,
+    toDateTime('2023-05-31 23:30:00') AS dt_ref,
+    now() AS dt_now, 
+    dt_now + delta as dt_after,
+    dateDiff('second', dt_ref, dt_now) AS time_shift,
+    formatDateTime(dt_after, '%b %e %T') AS syslog_after
+SELECT
+    formatDateTime(dt_after - time_shift, '%b %e %T') AS syslog_arg,
+    parseDateTimeBestEffort(syslog_after) - time_shift AS res,
+    parseDateTimeBestEffort(syslog_after, 'US/Samoa') - time_shift AS res_sam,
+    parseDateTimeBestEffort(syslog_after, 'Pacific/Auckland') - time_shift AS res_auc,
+    parseDateTimeBestEffortOrNull(syslog_after) - time_shift AS res_null,
+    parseDateTimeBestEffortOrNull(syslog_after, 'US/Samoa') - time_shift AS res_null_sam,
+    parseDateTimeBestEffortOrNull(syslog_after, 'Pacific/Auckland') - time_shift AS res_null_auc,
+    parseDateTimeBestEffortOrZero(syslog_after) - time_shift AS res_zero,
+    parseDateTimeBestEffortOrZero(syslog_after, 'US/Samoa') - time_shift AS res_zero_sam,
+    parseDateTimeBestEffortOrZero(syslog_after, 'Pacific/Auckland') - time_shift AS res_zero_auc,
+    parseDateTimeBestEffortUS(syslog_after) - time_shift AS res_us,
+    parseDateTimeBestEffortUS(syslog_after, 'US/Samoa') - time_shift AS res_us_sam,
+    parseDateTimeBestEffortUS(syslog_after, 'Pacific/Auckland') - time_shift AS res_us_auc,
+    parseDateTimeBestEffortUSOrNull(syslog_after) - time_shift AS res_us_null,
+    parseDateTimeBestEffortUSOrNull(syslog_after, 'US/Samoa') - time_shift AS res_us_null_sam,
+    parseDateTimeBestEffortUSOrNull(syslog_after, 'Pacific/Auckland') - time_shift AS res_us_null_auc,
+    parseDateTimeBestEffortUSOrZero(syslog_after) - time_shift AS res_us_zero,
+    parseDateTimeBestEffortUSOrZero(syslog_after, 'US/Samoa') - time_shift AS res_us_zero_sam,
+    parseDateTimeBestEffortUSOrZero(syslog_after, 'Pacific/Auckland') - time_shift AS res_us_zero_auc,
+    parseDateTime64BestEffort(syslog_after) - time_shift AS res64,
+    parseDateTime64BestEffort(syslog_after, 3, 'US/Samoa') - time_shift AS res64_sam,
+    parseDateTime64BestEffort(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_auc,
+    parseDateTime64BestEffortOrNull(syslog_after) - time_shift AS res64_null,
+    parseDateTime64BestEffortOrNull(syslog_after, 3, 'US/Samoa') - time_shift AS res64_null_sam,
+    parseDateTime64BestEffortOrNull(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_null_auc,
+    parseDateTime64BestEffortOrZero(syslog_after) - time_shift AS res64_zero,
+    parseDateTime64BestEffortOrZero(syslog_after, 3, 'US/Samoa') - time_shift AS res64_zero_sam,
+    parseDateTime64BestEffortOrZero(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_zero_auc,
+    parseDateTime64BestEffortUS(syslog_after) - time_shift AS res64_us,
+    parseDateTime64BestEffortUS(syslog_after, 3, 'US/Samoa') - time_shift AS res64_us_sam,
+    parseDateTime64BestEffortUS(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_us_auc,
+    parseDateTime64BestEffortUSOrNull(syslog_after) - time_shift AS res64_us_null,
+    parseDateTime64BestEffortUSOrNull(syslog_after, 3, 'US/Samoa') - time_shift AS res64_us_null_sam,
+    parseDateTime64BestEffortUSOrNull(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_us_null_auc,
+    parseDateTime64BestEffortUSOrZero(syslog_after) - time_shift AS res64_us_zero,
+    parseDateTime64BestEffortUSOrZero(syslog_after, 3, 'US/Samoa') - time_shift AS res64_us_zero_sam,
+    parseDateTime64BestEffortUSOrZero(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
+FORMAT Vertical;

From fe0bc992bfa98ef5645be0205cfb913ce0140f52 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 15 Jun 2023 10:58:24 +0300
Subject: [PATCH 464/722] Move the reference time point to the border of June

---
 ...3_parsedatetimebesteffort_syslog.reference | 150 +++++++++---------
 .../02783_parsedatetimebesteffort_syslog.sql  |   6 +-
 2 files changed, 78 insertions(+), 78 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
index ec995426032..d342c2ba509 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
@@ -1,85 +1,85 @@
-The reference time point is 2023-05-31 23:30:00
+The reference time point is 2023-06-30 23:59:30
 ───────────────────────────────
 Before the reference time point
 ───────────────────────────────
 Row 1:
 ──────
-syslog_arg:        May 31 22:30:00
-res:               2023-05-31 22:30:00
-res_sam:           2022-05-31 22:30:00
-res_auc:           2023-05-31 22:30:00
-res_null:          2023-05-31 22:30:00
-res_null_sam:      2022-05-31 22:30:00
-res_null_auc:      2023-05-31 22:30:00
-res_zero:          2023-05-31 22:30:00
-res_zero_sam:      2022-05-31 22:30:00
-res_zero_auc:      2023-05-31 22:30:00
-res_us:            2023-05-31 22:30:00
-res_us_sam:        2022-05-31 22:30:00
-res_us_auc:        2023-05-31 22:30:00
-res_us_null:       2023-05-31 22:30:00
-res_us_null_sam:   2022-05-31 22:30:00
-res_us_null_auc:   2023-05-31 22:30:00
-res_us_zero:       2023-05-31 22:30:00
-res_us_zero_sam:   2022-05-31 22:30:00
-res_us_zero_auc:   2023-05-31 22:30:00
-res64:             2023-05-31 22:30:00.000
-res64_sam:         2022-05-31 22:30:00.000
-res64_auc:         2023-05-31 22:30:00.000
-res64_null:        2023-05-31 22:30:00.000
-res64_null_sam:    2022-05-31 22:30:00.000
-res64_null_auc:    2023-05-31 22:30:00.000
-res64_zero:        2023-05-31 22:30:00.000
-res64_zero_sam:    2022-05-31 22:30:00.000
-res64_zero_auc:    2023-05-31 22:30:00.000
-res64_us:          2023-05-31 22:30:00.000
-res64_us_sam:      2022-05-31 22:30:00.000
-res64_us_auc:      2023-05-31 22:30:00.000
-res64_us_null:     2023-05-31 22:30:00.000
-res64_us_null_sam: 2022-05-31 22:30:00.000
-res64_us_null_auc: 2023-05-31 22:30:00.000
-res64_us_zero:     2023-05-31 22:30:00.000
-res64_us_zero_sam: 2022-05-31 22:30:00.000
-res64_us_zero_auc: 2023-05-31 22:30:00.000
+syslog_arg:        Jun 30 22:59:30
+res:               2023-06-30 22:59:30
+res_sam:           2022-06-30 22:59:30
+res_auc:           2023-06-30 22:59:30
+res_null:          2023-06-30 22:59:30
+res_null_sam:      2022-06-30 22:59:30
+res_null_auc:      2023-06-30 22:59:30
+res_zero:          2023-06-30 22:59:30
+res_zero_sam:      2022-06-30 22:59:30
+res_zero_auc:      2023-06-30 22:59:30
+res_us:            2023-06-30 22:59:30
+res_us_sam:        2022-06-30 22:59:30
+res_us_auc:        2023-06-30 22:59:30
+res_us_null:       2023-06-30 22:59:30
+res_us_null_sam:   2022-06-30 22:59:30
+res_us_null_auc:   2023-06-30 22:59:30
+res_us_zero:       2023-06-30 22:59:30
+res_us_zero_sam:   2022-06-30 22:59:30
+res_us_zero_auc:   2023-06-30 22:59:30
+res64:             2023-06-30 22:59:30.000
+res64_sam:         2022-06-30 22:59:30.000
+res64_auc:         2023-06-30 22:59:30.000
+res64_null:        2023-06-30 22:59:30.000
+res64_null_sam:    2022-06-30 22:59:30.000
+res64_null_auc:    2023-06-30 22:59:30.000
+res64_zero:        2023-06-30 22:59:30.000
+res64_zero_sam:    2022-06-30 22:59:30.000
+res64_zero_auc:    2023-06-30 22:59:30.000
+res64_us:          2023-06-30 22:59:30.000
+res64_us_sam:      2022-06-30 22:59:30.000
+res64_us_auc:      2023-06-30 22:59:30.000
+res64_us_null:     2023-06-30 22:59:30.000
+res64_us_null_sam: 2022-06-30 22:59:30.000
+res64_us_null_auc: 2023-06-30 22:59:30.000
+res64_us_zero:     2023-06-30 22:59:30.000
+res64_us_zero_sam: 2022-06-30 22:59:30.000
+res64_us_zero_auc: 2023-06-30 22:59:30.000
 ──────────────────────────────
 After the reference time point
 ──────────────────────────────
 Row 1:
 ──────
-syslog_arg:        Jun  1 00:30:00
-res:               2022-06-01 00:30:00
-res_sam:           2022-06-01 00:30:00
-res_auc:           2023-06-01 00:30:00
-res_null:          2022-06-01 00:30:00
-res_null_sam:      2022-06-01 00:30:00
-res_null_auc:      2023-06-01 00:30:00
-res_zero:          2022-06-01 00:30:00
-res_zero_sam:      2022-06-01 00:30:00
-res_zero_auc:      2023-06-01 00:30:00
-res_us:            2022-06-01 00:30:00
-res_us_sam:        2022-06-01 00:30:00
-res_us_auc:        2023-06-01 00:30:00
-res_us_null:       2022-06-01 00:30:00
-res_us_null_sam:   2022-06-01 00:30:00
-res_us_null_auc:   2023-06-01 00:30:00
-res_us_zero:       2022-06-01 00:30:00
-res_us_zero_sam:   2022-06-01 00:30:00
-res_us_zero_auc:   2023-06-01 00:30:00
-res64:             2022-06-01 00:30:00.000
-res64_sam:         2022-06-01 00:30:00.000
-res64_auc:         2023-06-01 00:30:00.000
-res64_null:        2022-06-01 00:30:00.000
-res64_null_sam:    2022-06-01 00:30:00.000
-res64_null_auc:    2023-06-01 00:30:00.000
-res64_zero:        2022-06-01 00:30:00.000
-res64_zero_sam:    2022-06-01 00:30:00.000
-res64_zero_auc:    2023-06-01 00:30:00.000
-res64_us:          2022-06-01 00:30:00.000
-res64_us_sam:      2022-06-01 00:30:00.000
-res64_us_auc:      2023-06-01 00:30:00.000
-res64_us_null:     2022-06-01 00:30:00.000
-res64_us_null_sam: 2022-06-01 00:30:00.000
-res64_us_null_auc: 2023-06-01 00:30:00.000
-res64_us_zero:     2022-06-01 00:30:00.000
-res64_us_zero_sam: 2022-06-01 00:30:00.000
-res64_us_zero_auc: 2023-06-01 00:30:00.000
+syslog_arg:        Jul  1 00:59:30
+res:               2022-07-01 00:59:30
+res_sam:           2022-07-01 00:59:30
+res_auc:           2023-07-01 00:59:30
+res_null:          2022-07-01 00:59:30
+res_null_sam:      2022-07-01 00:59:30
+res_null_auc:      2023-07-01 00:59:30
+res_zero:          2022-07-01 00:59:30
+res_zero_sam:      2022-07-01 00:59:30
+res_zero_auc:      2023-07-01 00:59:30
+res_us:            2022-07-01 00:59:30
+res_us_sam:        2022-07-01 00:59:30
+res_us_auc:        2023-07-01 00:59:30
+res_us_null:       2022-07-01 00:59:30
+res_us_null_sam:   2022-07-01 00:59:30
+res_us_null_auc:   2023-07-01 00:59:30
+res_us_zero:       2022-07-01 00:59:30
+res_us_zero_sam:   2022-07-01 00:59:30
+res_us_zero_auc:   2023-07-01 00:59:30
+res64:             2022-07-01 00:59:30.000
+res64_sam:         2022-07-01 00:59:30.000
+res64_auc:         2023-07-01 00:59:30.000
+res64_null:        2022-07-01 00:59:30.000
+res64_null_sam:    2022-07-01 00:59:30.000
+res64_null_auc:    2023-07-01 00:59:30.000
+res64_zero:        2022-07-01 00:59:30.000
+res64_zero_sam:    2022-07-01 00:59:30.000
+res64_zero_auc:    2023-07-01 00:59:30.000
+res64_us:          2022-07-01 00:59:30.000
+res64_us_sam:      2022-07-01 00:59:30.000
+res64_us_auc:      2023-07-01 00:59:30.000
+res64_us_null:     2022-07-01 00:59:30.000
+res64_us_null_sam: 2022-07-01 00:59:30.000
+res64_us_null_auc: 2023-07-01 00:59:30.000
+res64_us_zero:     2022-07-01 00:59:30.000
+res64_us_zero_sam: 2022-07-01 00:59:30.000
+res64_us_zero_auc: 2023-07-01 00:59:30.000
diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
index bc0f28e9fc5..2ea4f0d7236 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
@@ -1,11 +1,11 @@
-SELECT 'The reference time point is 2023-05-31 23:30:00';
+SELECT 'The reference time point is 2023-06-30 23:59:30';
 SELECT '───────────────────────────────';
 SELECT 'Before the reference time point';
 SELECT '───────────────────────────────';
 
 WITH
     3600 AS delta,
-    toDateTime('2023-05-31 23:30:00') AS dt_ref,
+    toDateTime('2023-06-30 23:59:30') AS dt_ref,
     now() AS dt_now, 
     dt_now - delta as dt_before,
     dateDiff('second', dt_ref, dt_now) AS time_shift,
@@ -56,7 +56,7 @@ SELECT '────────────────────────
 
 WITH
     3600 AS delta,
-    toDateTime('2023-05-31 23:30:00') AS dt_ref,
+    toDateTime('2023-06-30 23:59:30') AS dt_ref,
     now() AS dt_now, 
     dt_now + delta as dt_after,
     dateDiff('second', dt_ref, dt_now) AS time_shift,

From 72ef15e03f62cb2f20a40c5769659272de911933 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 15 Jun 2023 11:04:15 +0300
Subject: [PATCH 465/722] Shrink the test half-interval to a minute

---
 ...3_parsedatetimebesteffort_syslog.reference | 148 +++++++++---------
 .../02783_parsedatetimebesteffort_syslog.sql  |   8 +-
 2 files changed, 78 insertions(+), 78 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
index d342c2ba509..d78680fe5b7 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
@@ -4,82 +4,82 @@ Before the reference time point
 ───────────────────────────────
 Row 1:
 ──────
-syslog_arg:        Jun 30 22:59:30
-res:               2023-06-30 22:59:30
-res_sam:           2022-06-30 22:59:30
-res_auc:           2023-06-30 22:59:30
-res_null:          2023-06-30 22:59:30
-res_null_sam:      2022-06-30 22:59:30
-res_null_auc:      2023-06-30 22:59:30
-res_zero:          2023-06-30 22:59:30
-res_zero_sam:      2022-06-30 22:59:30
-res_zero_auc:      2023-06-30 22:59:30
-res_us:            2023-06-30 22:59:30
-res_us_sam:        2022-06-30 22:59:30
-res_us_auc:        2023-06-30 22:59:30
-res_us_null:       2023-06-30 22:59:30
-res_us_null_sam:   2022-06-30 22:59:30
-res_us_null_auc:   2023-06-30 22:59:30
-res_us_zero:       2023-06-30 22:59:30
-res_us_zero_sam:   2022-06-30 22:59:30
-res_us_zero_auc:   2023-06-30 22:59:30
-res64:             2023-06-30 22:59:30.000
-res64_sam:         2022-06-30 22:59:30.000
-res64_auc:         2023-06-30 22:59:30.000
-res64_null:        2023-06-30 22:59:30.000
-res64_null_sam:    2022-06-30 22:59:30.000
-res64_null_auc:    2023-06-30 22:59:30.000
-res64_zero:        2023-06-30 22:59:30.000
-res64_zero_sam:    2022-06-30 22:59:30.000
-res64_zero_auc:    2023-06-30 22:59:30.000
-res64_us:          2023-06-30 22:59:30.000
-res64_us_sam:      2022-06-30 22:59:30.000
-res64_us_auc:      2023-06-30 22:59:30.000
-res64_us_null:     2023-06-30 22:59:30.000
-res64_us_null_sam: 2022-06-30 22:59:30.000
-res64_us_null_auc: 2023-06-30 22:59:30.000
-res64_us_zero:     2023-06-30 22:59:30.000
-res64_us_zero_sam: 2022-06-30 22:59:30.000
-res64_us_zero_auc: 2023-06-30 22:59:30.000
+syslog_arg:        Jun 30 23:58:30
+res:               2023-06-30 23:58:30
+res_sam:           2022-06-30 23:58:30
+res_auc:           2023-06-30 23:58:30
+res_null:          2023-06-30 23:58:30
+res_null_sam:      2022-06-30 23:58:30
+res_null_auc:      2023-06-30 23:58:30
+res_zero:          2023-06-30 23:58:30
+res_zero_sam:      2022-06-30 23:58:30
+res_zero_auc:      2023-06-30 23:58:30
+res_us:            2023-06-30 23:58:30
+res_us_sam:        2022-06-30 23:58:30
+res_us_auc:        2023-06-30 23:58:30
+res_us_null:       2023-06-30 23:58:30
+res_us_null_sam:   2022-06-30 23:58:30
+res_us_null_auc:   2023-06-30 23:58:30
+res_us_zero:       2023-06-30 23:58:30
+res_us_zero_sam:   2022-06-30 23:58:30
+res_us_zero_auc:   2023-06-30 23:58:30
+res64:             2023-06-30 23:58:30.000
+res64_sam:         2022-06-30 23:58:30.000
+res64_auc:         2023-06-30 23:58:30.000
+res64_null:        2023-06-30 23:58:30.000
+res64_null_sam:    2022-06-30 23:58:30.000
+res64_null_auc:    2023-06-30 23:58:30.000
+res64_zero:        2023-06-30 23:58:30.000
+res64_zero_sam:    2022-06-30 23:58:30.000
+res64_zero_auc:    2023-06-30 23:58:30.000
+res64_us:          2023-06-30 23:58:30.000
+res64_us_sam:      2022-06-30 23:58:30.000
+res64_us_auc:      2023-06-30 23:58:30.000
+res64_us_null:     2023-06-30 23:58:30.000
+res64_us_null_sam: 2022-06-30 23:58:30.000
+res64_us_null_auc: 2023-06-30 23:58:30.000
+res64_us_zero:     2023-06-30 23:58:30.000
+res64_us_zero_sam: 2022-06-30 23:58:30.000
+res64_us_zero_auc: 2023-06-30 23:58:30.000
 ──────────────────────────────
 After the reference time point
 ──────────────────────────────
 Row 1:
 ──────
-syslog_arg:        Jul  1 00:59:30
-res:               2022-07-01 00:59:30
-res_sam:           2022-07-01 00:59:30
-res_auc:           2023-07-01 00:59:30
-res_null:          2022-07-01 00:59:30
-res_null_sam:      2022-07-01 00:59:30
-res_null_auc:      2023-07-01 00:59:30
-res_zero:          2022-07-01 00:59:30
-res_zero_sam:      2022-07-01 00:59:30
-res_zero_auc:      2023-07-01 00:59:30
-res_us:            2022-07-01 00:59:30
-res_us_sam:        2022-07-01 00:59:30
-res_us_auc:        2023-07-01 00:59:30
-res_us_null:       2022-07-01 00:59:30
-res_us_null_sam:   2022-07-01 00:59:30
-res_us_null_auc:   2023-07-01 00:59:30
-res_us_zero:       2022-07-01 00:59:30
-res_us_zero_sam:   2022-07-01 00:59:30
-res_us_zero_auc:   2023-07-01 00:59:30
-res64:             2022-07-01 00:59:30.000
-res64_sam:         2022-07-01 00:59:30.000
-res64_auc:         2023-07-01 00:59:30.000
-res64_null:        2022-07-01 00:59:30.000
-res64_null_sam:    2022-07-01 00:59:30.000
-res64_null_auc:    2023-07-01 00:59:30.000
-res64_zero:        2022-07-01 00:59:30.000
-res64_zero_sam:    2022-07-01 00:59:30.000
-res64_zero_auc:    2023-07-01 00:59:30.000
-res64_us:          2022-07-01 00:59:30.000
-res64_us_sam:      2022-07-01 00:59:30.000
-res64_us_auc:      2023-07-01 00:59:30.000
-res64_us_null:     2022-07-01 00:59:30.000
-res64_us_null_sam: 2022-07-01 00:59:30.000
-res64_us_null_auc: 2023-07-01 00:59:30.000
-res64_us_zero:     2022-07-01 00:59:30.000
-res64_us_zero_sam: 2022-07-01 00:59:30.000
-res64_us_zero_auc: 2023-07-01 00:59:30.000
+syslog_arg:        Jul  1 00:00:30
+res:               2022-07-01 00:00:30
+res_sam:           2022-07-01 00:00:30
+res_auc:           2023-07-01 00:00:30
+res_null:          2022-07-01 00:00:30
+res_null_sam:      2022-07-01 00:00:30
+res_null_auc:      2023-07-01 00:00:30
+res_zero:          2022-07-01 00:00:30
+res_zero_sam:      2022-07-01 00:00:30
+res_zero_auc:      2023-07-01 00:00:30
+res_us:            2022-07-01 00:00:30
+res_us_sam:        2022-07-01 00:00:30
+res_us_auc:        2023-07-01 00:00:30
+res_us_null:       2022-07-01 00:00:30
+res_us_null_sam:   2022-07-01 00:00:30
+res_us_null_auc:   2023-07-01 00:00:30
+res_us_zero:       2022-07-01 00:00:30
+res_us_zero_sam:   2022-07-01 00:00:30
+res_us_zero_auc:   2023-07-01 00:00:30
+res64:             2022-07-01 00:00:30.000
+res64_sam:         2022-07-01 00:00:30.000
+res64_auc:         2023-07-01 00:00:30.000
+res64_null:        2022-07-01 00:00:30.000
+res64_null_sam:    2022-07-01 00:00:30.000
+res64_null_auc:    2023-07-01 00:00:30.000
+res64_zero:        2022-07-01 00:00:30.000
+res64_zero_sam:    2022-07-01 00:00:30.000
+res64_zero_auc:    2023-07-01 00:00:30.000
+res64_us:          2022-07-01 00:00:30.000
+res64_us_sam:      2022-07-01 00:00:30.000
+res64_us_auc:      2023-07-01 00:00:30.000
+res64_us_null:     2022-07-01 00:00:30.000
+res64_us_null_sam: 2022-07-01 00:00:30.000
+res64_us_null_auc: 2023-07-01 00:00:30.000
+res64_us_zero:     2022-07-01 00:00:30.000
+res64_us_zero_sam: 2022-07-01 00:00:30.000
+res64_us_zero_auc: 2023-07-01 00:00:30.000
diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
index 2ea4f0d7236..9c28104bfbc 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
@@ -4,11 +4,11 @@ SELECT 'Before the reference time point';
 SELECT '───────────────────────────────';
 
 WITH
-    3600 AS delta,
+    60 AS delta,
     toDateTime('2023-06-30 23:59:30') AS dt_ref,
     now() AS dt_now, 
     dt_now - delta as dt_before,
-    dateDiff('second', dt_ref, dt_now) AS time_shift,
+    dateDiff(SECOND, dt_ref, dt_now) AS time_shift,
     formatDateTime(dt_before, '%b %e %T') AS syslog_before
 SELECT
     formatDateTime(dt_before - time_shift, '%b %e %T') AS syslog_arg,
@@ -55,11 +55,11 @@ SELECT 'After the reference time point';
 SELECT '──────────────────────────────';
 
 WITH
-    3600 AS delta,
+    60 AS delta,
     toDateTime('2023-06-30 23:59:30') AS dt_ref,
     now() AS dt_now, 
     dt_now + delta as dt_after,
-    dateDiff('second', dt_ref, dt_now) AS time_shift,
+    dateDiff(SECOND, dt_ref, dt_now) AS time_shift,
     formatDateTime(dt_after, '%b %e %T') AS syslog_after
 SELECT
     formatDateTime(dt_after - time_shift, '%b %e %T') AS syslog_arg,

From c899f6b68dcfe58a147b24cfef805450fc9bc9f9 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 15 Jun 2023 11:12:22 +0300
Subject: [PATCH 466/722] Use int the test explicit date_add() and date_sub()
 instead of + and -.

---
 .../0_stateless/02783_parsedatetimebesteffort_syslog.sql    | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
index 9c28104bfbc..1feb7322b0a 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
@@ -4,10 +4,9 @@ SELECT 'Before the reference time point';
 SELECT '───────────────────────────────';
 
 WITH
-    60 AS delta,
     toDateTime('2023-06-30 23:59:30') AS dt_ref,
     now() AS dt_now, 
-    dt_now - delta as dt_before,
+    date_sub(MINUTE, 1, dt_now) as dt_before,
     dateDiff(SECOND, dt_ref, dt_now) AS time_shift,
     formatDateTime(dt_before, '%b %e %T') AS syslog_before
 SELECT
@@ -55,10 +54,9 @@ SELECT 'After the reference time point';
 SELECT '──────────────────────────────';
 
 WITH
-    60 AS delta,
     toDateTime('2023-06-30 23:59:30') AS dt_ref,
     now() AS dt_now, 
-    dt_now + delta as dt_after,
+    date_add(MINUTE, 1, dt_now) as dt_after,
     dateDiff(SECOND, dt_ref, dt_now) AS time_shift,
     formatDateTime(dt_after, '%b %e %T') AS syslog_after
 SELECT

From bd1623326312261b8b8b440ebcc5d8afe502aca0 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Thu, 15 Jun 2023 11:17:13 +0300
Subject: [PATCH 467/722] Add more clear remarks to the test

---
 .../02783_parsedatetimebesteffort_syslog.reference   | 12 ++++++------
 .../02783_parsedatetimebesteffort_syslog.sql         | 12 ++++++------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
index d78680fe5b7..0840054b1d3 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
@@ -1,7 +1,7 @@
 The reference time point is 2023-06-30 23:59:30
-───────────────────────────────
-Before the reference time point
-───────────────────────────────
+───────────────────────────────────────────────
+The argument is before the reference time point
+───────────────────────────────────────────────
 Row 1:
 ──────
 syslog_arg:        Jun 30 23:58:30
@@ -41,9 +41,9 @@ res64_us_null_auc: 2023-06-30 23:58:30.000
 res64_us_zero:     2023-06-30 23:58:30.000
 res64_us_zero_sam: 2022-06-30 23:58:30.000
 res64_us_zero_auc: 2023-06-30 23:58:30.000
-──────────────────────────────
-After the reference time point
-──────────────────────────────
+──────────────────────────────────────────────
+The argument is after the reference time point
+──────────────────────────────────────────────
 Row 1:
 ──────
 syslog_arg:        Jul  1 00:00:30
diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
index 1feb7322b0a..fc38500c41a 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
@@ -1,7 +1,7 @@
 SELECT 'The reference time point is 2023-06-30 23:59:30';
-SELECT '───────────────────────────────';
-SELECT 'Before the reference time point';
-SELECT '───────────────────────────────';
+SELECT '───────────────────────────────────────────────';
+SELECT 'The argument is before the reference time point';
+SELECT '───────────────────────────────────────────────';
 
 WITH
     toDateTime('2023-06-30 23:59:30') AS dt_ref,
@@ -49,9 +49,9 @@ SELECT
     parseDateTime64BestEffortUSOrZero(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
 FORMAT Vertical;
 
-SELECT '──────────────────────────────';
-SELECT 'After the reference time point';
-SELECT '──────────────────────────────';
+SELECT '──────────────────────────────────────────────';
+SELECT 'The argument is after the reference time point';
+SELECT '──────────────────────────────────────────────';
 
 WITH
     toDateTime('2023-06-30 23:59:30') AS dt_ref,

From c786fbf8bd8a4152336e79aa0933a1c23dd20d6b Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Thu, 15 Jun 2023 10:22:02 +0200
Subject: [PATCH 468/722] Add comment

---
 src/Storages/StorageS3.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 4f649420a72..5c83740e834 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -460,6 +460,9 @@ public:
         for (auto && key : all_keys)
         {
             std::optional<S3::ObjectInfo> info;
+            /// In case all_keys.size() > 1, avoid getting object info now
+            /// (it will be done anyway eventually, but with delay and in parallel).
+            /// But progress bar will not work in this case.
             if (need_total_size && all_keys.size() == 1)
             {
                 info = S3::getObjectInfo(client_, bucket, key, version_id_, request_settings_);

From a018d9ca1122130054045c3d274c80393f119c5c Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 14 Jun 2023 21:41:32 +0200
Subject: [PATCH 469/722] try to fix false-positive 'part is lost forever'

---
 src/Storages/MergeTree/MergeTreeData.cpp      |  3 +
 src/Storages/MergeTree/MergeTreeData.h        |  3 +
 src/Storages/StorageReplicatedMergeTree.cpp   | 88 ++++++++++++++++++-
 src/Storages/StorageReplicatedMergeTree.h     |  2 +
 ...ync_broken_outdated_part_loading.reference |  5 ++
 ...2444_async_broken_outdated_part_loading.sh | 35 ++++++++
 6 files changed, 133 insertions(+), 3 deletions(-)
 create mode 100644 tests/queries/0_stateless/02444_async_broken_outdated_part_loading.reference
 create mode 100755 tests/queries/0_stateless/02444_async_broken_outdated_part_loading.sh

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index c94fa573b5b..9106e14e591 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1916,7 +1916,10 @@ try
 
             ++num_loaded_parts;
             if (res.is_broken)
+            {
+                forcefullyRemoveBrokenOutdatedPartFromZooKeeperBeforeDetaching(part->name);
                 res.part->renameToDetached("broken-on-start"); /// detached parts must not have '_' in prefixes
+            }
             else if (res.part->is_duplicate)
                 res.part->remove();
             else
diff --git a/src/Storages/MergeTree/MergeTreeData.h b/src/Storages/MergeTree/MergeTreeData.h
index def58ba2760..ffcf6be4fa1 100644
--- a/src/Storages/MergeTree/MergeTreeData.h
+++ b/src/Storages/MergeTree/MergeTreeData.h
@@ -646,6 +646,9 @@ public:
     /// For active parts it's unsafe because this method modifies fields of part (rename) while some other thread can try to read it.
     void forcefullyMovePartToDetachedAndRemoveFromMemory(const DataPartPtr & part, const String & prefix = "", bool restore_covered = false);
 
+    /// This method should not be here, but async loading of Outdated parts is implemented in MergeTreeData
+    virtual void forcefullyRemoveBrokenOutdatedPartFromZooKeeperBeforeDetaching(const String & /*part_name*/) {}
+
     /// Outdate broken part, set remove time to zero (remove as fast as possible) and make clone in detached directory.
     void outdateBrokenPartAndCloneToDetached(const DataPartPtr & part, const String & prefix);
 
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index f9c9e958258..1a35865223d 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -1226,12 +1226,53 @@ static time_t tryGetPartCreateTime(zkutil::ZooKeeperPtr & zookeeper, const Strin
     return res;
 }
 
+static void paranoidCheckForCoveredPartsInZooKeeperOnStart(const StorageReplicatedMergeTree * storage, const Strings & parts_in_zk,
+                                                           MergeTreeDataFormatVersion format_version, Poco::Logger * log)
+{
+#ifdef ABORT_ON_LOGICAL_ERROR
+    constexpr bool paranoid_check_for_covered_parts_default = true;
+#else
+    constexpr bool paranoid_check_for_covered_parts_default = false;
+#endif
+
+    bool paranoid_check_for_covered_parts = Context::getGlobalContextInstance()->getConfigRef().getBool(
+        "replicated_merge_tree_paranoid_check_on_startup", paranoid_check_for_covered_parts_default);
+    if (!paranoid_check_for_covered_parts)
+        return;
+
+    ActiveDataPartSet active_set(format_version);
+    for (const auto & part_name : parts_in_zk)
+        active_set.add(part_name);
+
+    const auto disks = storage->getStoragePolicy()->getDisks();
+    auto path = storage->getRelativeDataPath();
+
+    for (const auto & part_name : parts_in_zk)
+    {
+        String covering_part = active_set.getContainingPart(part_name);
+        if (part_name == covering_part)
+            continue;
+
+        bool found = false;
+        for (const DiskPtr & disk : disks)
+            if (disk->exists(fs::path(path) / part_name))
+                found = true;
+
+        if (!found)
+        {
+            LOG_WARNING(log, "Part {} exists in ZooKeeper and covered by another part in ZooKeeper ({}), but doesn't exist on any disk. "
+                        "It may cause false-positive 'part is lost forever' messages", part_name, covering_part);
+            chassert(false);
+        }
+    }
+}
 
 void StorageReplicatedMergeTree::checkParts(bool skip_sanity_checks)
 {
     auto zookeeper = getZooKeeper();
 
     Strings expected_parts_vec = zookeeper->getChildren(fs::path(replica_path) / "parts");
+    paranoidCheckForCoveredPartsInZooKeeperOnStart(this, expected_parts_vec, format_version, log);
 
     /// Parts in ZK.
     NameSet expected_parts(expected_parts_vec.begin(), expected_parts_vec.end());
@@ -6805,6 +6846,31 @@ void StorageReplicatedMergeTree::clearOldPartsAndRemoveFromZKImpl(zkutil::ZooKee
 }
 
 
+void StorageReplicatedMergeTree::forcefullyRemoveBrokenOutdatedPartFromZooKeeperBeforeDetaching(const String & part_name)
+{
+    /// An outdated part is broken and we are going to move it do detached/
+    /// But we need to remove it from ZooKeeper as well. Otherwise it will be considered as "lost forever".
+
+    /// Since the part is Outdated, it should be safe to remove it, but it's still dangerous.
+    /// It could became Outdated because it was merged/mutated (so we have a covering part) or because it was dropped.
+    /// But DROP [PART]ITION waits for all Outdated parts to be loaded, so it's not the case.
+
+    auto zookeeper = getZooKeeper();
+    String part_path = replica_path + "/parts/" + part_name;
+    if (!zookeeper->exists(part_path))
+        return;
+
+    auto part = getActiveContainingPart(part_name);
+    if (!part)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Outdated part {} is broken and going to be detached, "
+                        "but there's no active covering part, so we are not sure that it can be safely removed from ZooKeeper "
+                        "(path: {})", part_name, part_path);
+
+    LOG_WARNING(log, "Outdated part {} is broken and going to be detached, removing it from ZooKeeper. The part is covered by {}",
+                part_name, part->name);
+    removePartsFromZooKeeperWithRetries({part_name}, /* infinite retries */ 0);
+}
+
 void StorageReplicatedMergeTree::removePartsFromZooKeeperWithRetries(PartsToRemoveFromZooKeeper & parts, size_t max_retries)
 {
     Strings part_names_to_remove;
@@ -7166,6 +7232,7 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
         }
 
         Coordination::Responses op_results;
+        DataPartsVector parts_holder;
 
         try
         {
@@ -7215,7 +7282,10 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
                 auto data_parts_lock = lockParts();
                 transaction.commit(&data_parts_lock);
                 if (replace)
+                {
+                    parts_holder = getDataPartsVectorInPartitionForInternalUsage(MergeTreeDataPartState::Active, drop_range.partition_id, &data_parts_lock);
                     removePartsInRangeFromWorkingSet(NO_TRANSACTION_RAW, drop_range, data_parts_lock);
+                }
             }
 
             PartLog::addNewParts(getContext(), PartLog::createPartLogEntries(dst_parts, watch.elapsed(), profile_events_scope.getSnapshot()));
@@ -7235,11 +7305,15 @@ void StorageReplicatedMergeTree::replacePartitionFrom(
         for (auto & lock : ephemeral_locks)
             lock.assumeUnlocked();
 
-        cleanup_thread.wakeup();
-
         lock2.reset();
         lock1.reset();
 
+        /// We need to pull the DROP_RANGE before cleaning the replaced parts (otherwise CHeckThread may decide that parts are lost)
+        queue.pullLogsToQueue(getZooKeeperAndAssertNotReadonly(), {}, ReplicatedMergeTreeQueue::SYNC);
+        parts_holder.clear();
+        cleanup_thread.wakeup();
+
+
         waitForLogEntryToBeProcessedIfNecessary(entry, query_context);
 
         return;
@@ -7405,6 +7479,8 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
 
         Coordination::Responses op_results;
 
+        /// We should hold replaced parts until we actually create DROP_RANGE in ZooKeeper
+        DataPartsVector parts_holder;
         try
         {
             Coordination::Requests ops;
@@ -7439,6 +7515,7 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
                 else
                     zkutil::KeeperMultiException::check(code, ops, op_results);
 
+                parts_holder = getDataPartsVectorInPartitionForInternalUsage(MergeTreeDataPartState::Active, drop_range.partition_id, &src_data_parts_lock);
                 removePartsInRangeFromWorkingSet(NO_TRANSACTION_RAW, drop_range, src_data_parts_lock);
                 transaction.commit(&src_data_parts_lock);
             }
@@ -7461,7 +7538,6 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
         for (auto & lock : ephemeral_locks)
             lock.assumeUnlocked();
 
-        cleanup_thread.wakeup();
         lock2.reset();
 
         dest_table_storage->waitForLogEntryToBeProcessedIfNecessary(entry, query_context);
@@ -7480,6 +7556,12 @@ void StorageReplicatedMergeTree::movePartitionToTable(const StoragePtr & dest_ta
         entry_delete.znode_name = log_znode_path.substr(log_znode_path.find_last_of('/') + 1);
 
         lock1.reset();
+
+        /// We need to pull the DROP_RANGE before cleaning the replaced parts (otherwise CHeckThread may decide that parts are lost)
+        queue.pullLogsToQueue(getZooKeeperAndAssertNotReadonly(), {}, ReplicatedMergeTreeQueue::SYNC);
+        parts_holder.clear();
+        cleanup_thread.wakeup();
+
         waitForLogEntryToBeProcessedIfNecessary(entry_delete, query_context);
 
         /// Cleaning possibly stored information about parts from /quorum/last_part node in ZooKeeper.
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index c0d9e36a8a7..2d736a4e015 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -579,6 +579,8 @@ private:
     void removePartsFromZooKeeperWithRetries(const Strings & part_names, size_t max_retries = 5);
     void removePartsFromZooKeeperWithRetries(PartsToRemoveFromZooKeeper & parts, size_t max_retries = 5);
 
+    void forcefullyRemoveBrokenOutdatedPartFromZooKeeperBeforeDetaching(const String & part_name) override;
+
     /// Removes a part from ZooKeeper and adds a task to the queue to download it. It is supposed to do this with broken parts.
     void removePartAndEnqueueFetch(const String & part_name, bool storage_init);
 
diff --git a/tests/queries/0_stateless/02444_async_broken_outdated_part_loading.reference b/tests/queries/0_stateless/02444_async_broken_outdated_part_loading.reference
new file mode 100644
index 00000000000..389b1b4ec25
--- /dev/null
+++ b/tests/queries/0_stateless/02444_async_broken_outdated_part_loading.reference
@@ -0,0 +1,5 @@
+1	1	all_0_1_1
+1	2	all_0_1_1
+0
+2	1	all_0_1_1
+2	2	all_0_1_1
diff --git a/tests/queries/0_stateless/02444_async_broken_outdated_part_loading.sh b/tests/queries/0_stateless/02444_async_broken_outdated_part_loading.sh
new file mode 100755
index 00000000000..d24c6afcef3
--- /dev/null
+++ b/tests/queries/0_stateless/02444_async_broken_outdated_part_loading.sh
@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Tags: long, zookeeper
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+$CLICKHOUSE_CLIENT -q "drop table if exists rmt sync;"
+$CLICKHOUSE_CLIENT -q "create table rmt (n int) engine=ReplicatedMergeTree('/test/02444/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/rmt', '1') order by n"
+
+$CLICKHOUSE_CLIENT --insert_keeper_fault_injection_probability=0 -q "insert into rmt values (1);"
+$CLICKHOUSE_CLIENT --insert_keeper_fault_injection_probability=0 -q "insert into rmt values (2);"
+
+$CLICKHOUSE_CLIENT -q "system sync replica rmt pull;"
+$CLICKHOUSE_CLIENT --optimize_throw_if_noop=1 -q "optimize table rmt final"
+$CLICKHOUSE_CLIENT -q "system sync replica rmt;"
+$CLICKHOUSE_CLIENT -q "select 1, *, _part from rmt order by n;"
+
+path=$($CLICKHOUSE_CLIENT -q "select path from system.parts where database='$CLICKHOUSE_DATABASE' and table='rmt' and name='all_1_1_0'")
+# ensure that path is absolute before removing
+$CLICKHOUSE_CLIENT -q "select throwIf(substring('$path', 1, 1) != '/', 'Path is relative: $path')" || exit
+rm -f "$path/*.bin"
+
+$CLICKHOUSE_CLIENT -q "detach table rmt sync;"
+$CLICKHOUSE_CLIENT -q "attach table rmt;"
+$CLICKHOUSE_CLIENT -q "select 2, *, _part from rmt order by n;"
+
+$CLICKHOUSE_CLIENT -q "truncate table rmt;"
+
+$CLICKHOUSE_CLIENT -q "detach table rmt sync;"
+$CLICKHOUSE_CLIENT -q "attach table rmt;"
+
+$CLICKHOUSE_CLIENT -q "SELECT table, lost_part_count FROM system.replicas WHERE database=currentDatabase() AND lost_part_count!=0";
+
+$CLICKHOUSE_CLIENT -q "drop table rmt sync;"

From 6fc94797305535d8e01d32031d8dcdf53b65ac2d Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 15 Jun 2023 13:51:42 +0300
Subject: [PATCH 470/722] Update settings.md (#51007)

---
 docs/en/operations/server-configuration-parameters/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index 3398c7afb67..83756097cfa 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -202,7 +202,7 @@ Default: 15
 
 ## dns_max_consecutive_failures
 
-Max connection failures before dropping host from ClickHouse DNS cache
+Max consecutive resolving failures before dropping a host from ClickHouse DNS cache
 
 Type: UInt32
 

From 07203a4542033af7300ecf4c688b9e1ea62502fe Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 15 Jun 2023 14:05:01 +0200
Subject: [PATCH 471/722] Fix a versions' tweak for tagged commits, improve
 version_helper

---
 tests/ci/git_helper.py     | 11 ++++++++++-
 tests/ci/version_helper.py | 22 ++++++++++++++--------
 2 files changed, 24 insertions(+), 9 deletions(-)

diff --git a/tests/ci/git_helper.py b/tests/ci/git_helper.py
index eb5e835eab3..a9f2bf9b1cc 100644
--- a/tests/ci/git_helper.py
+++ b/tests/ci/git_helper.py
@@ -171,7 +171,16 @@ class Git:
         if not self.latest_tag.endswith("-testing"):
             # When we are on the tag, we still need to have tweak=1 to not
             # break cmake with versions like 12.13.14.0
-            return self.commits_since_tag or TWEAK
+            if not self.commits_since_tag:
+                # We are in a tagged commit. The tweak should match the
+                # current version's value
+                version = self.latest_tag.split("-", maxsplit=1)[0]
+                try:
+                    return int(version.split(".")[-1])
+                except ValueError:
+                    # There are no tags, or a wrong tag. Return default
+                    return TWEAK
+            return self.commits_since_tag
 
         version = self.latest_tag.split("-", maxsplit=1)[0]
         return int(version.split(".")[-1]) + self.commits_since_tag
diff --git a/tests/ci/version_helper.py b/tests/ci/version_helper.py
index 372974f4eda..15229c3d21d 100755
--- a/tests/ci/version_helper.py
+++ b/tests/ci/version_helper.py
@@ -335,6 +335,7 @@ def main():
         "--version-type",
         "-t",
         choices=VersionType.VALID,
+        default=VersionType.TESTING,
         help="optional parameter to generate DESCRIBE",
     )
     parser.add_argument(
@@ -344,10 +345,16 @@ def main():
         help="if the ENV variables should be exported",
     )
     parser.add_argument(
-        "--update",
-        "-u",
+        "--update-part",
         choices=("major", "minor", "patch"),
-        help="the version part to update, tweak is always calculated from commits",
+        help="the version part to update, tweak is always calculated from commits, "
+        "implies `--update-cmake`",
+    )
+    parser.add_argument(
+        "--update-cmake",
+        "-u",
+        action="store_true",
+        help=f"is update for {FILE_WITH_VERSION_PATH} is needed or not",
     )
     parser.add_argument(
         "--update-contributors",
@@ -364,13 +371,12 @@ def main():
 
     version = get_version_from_repo(args.version_path, Git(True))
 
-    if args.update:
-        version = version.update(args.update)
+    if args.update_part:
+        version = version.update(args.update_part)
 
-    if args.version_type:
-        version.with_description(args.version_type)
+    version.with_description(args.version_type)
 
-    if args.update:
+    if args.update_part or args.update_cmake:
         update_cmake_version(version)
 
     for k, v in version.as_dict().items():

From 2ac95ccfce6e01072b9719b710f726e46c111a4c Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 15 Jun 2023 14:36:15 +0200
Subject: [PATCH 472/722] Adjust version_helper test cases to proper tags

---
 tests/ci/version_test.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/tests/ci/version_test.py b/tests/ci/version_test.py
index abd0f9349f4..978edcc093e 100644
--- a/tests/ci/version_test.py
+++ b/tests/ci/version_test.py
@@ -11,11 +11,11 @@ class TestFunctions(unittest.TestCase):
         cases = (
             ("0.0.0.0", vh.get_version_from_string("0.0.0.0")),
             ("1.1.1.2", vh.get_version_from_string("1.1.1.2")),
-            ("v1.1.1.2-lts", vh.get_version_from_string("1.1.1.2")),
-            ("v1.1.1.2-prestable", vh.get_version_from_string("1.1.1.2")),
-            ("v1.1.1.2-stable", vh.get_version_from_string("1.1.1.2")),
-            ("v1.1.1.2-testing", vh.get_version_from_string("1.1.1.2")),
-            ("refs/tags/v1.1.1.2-testing", vh.get_version_from_string("1.1.1.2")),
+            ("v11.1.1.2-lts", vh.get_version_from_string("11.1.1.2")),
+            ("v01.1.1.2-prestable", vh.get_version_from_string("1.1.1.2")),
+            ("v21.1.1.2-stable", vh.get_version_from_string("21.1.1.2")),
+            ("v31.1.1.2-testing", vh.get_version_from_string("31.1.1.2")),
+            ("refs/tags/v31.1.1.2-testing", vh.get_version_from_string("31.1.1.2")),
         )
         for test_case in cases:
             version = vh.version_arg(test_case[0])
@@ -25,6 +25,7 @@ class TestFunctions(unittest.TestCase):
             "1.1.1.a",
             "1.1.1.1.1",
             "1.1.1.2-testing",
+            "v1.1.1.2-testing",
             "v1.1.1.2-testin",
             "refs/tags/v1.1.1.2-testin",
         )

From 870f3d1270fe6d92a8b8e81282a4d54a5f19686c Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Thu, 15 Jun 2023 12:59:46 +0000
Subject: [PATCH 473/722] Fix comments

---
 src/Storages/HDFS/StorageHDFS.cpp         | 20 +++++++++-----------
 src/Storages/StorageS3.cpp                | 16 ++++------------
 src/Storages/StorageURL.cpp               | 12 ++++++++++++
 tests/integration/test_storage_s3/test.py | 12 ++++++++++++
 4 files changed, 37 insertions(+), 23 deletions(-)

diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index dd3e8fecfaa..3a96d68dc2e 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -213,7 +213,6 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
               ColumnsDescription &) mutable -> std::unique_ptr<ReadBuffer>
     {
         PathWithInfo path_with_info;
-        std::unique_ptr<ReadBuffer> buf;
         while (true)
         {
             if (it == paths_with_info.end())
@@ -231,13 +230,11 @@ ColumnsDescription StorageHDFS::getTableStructureFromData(
 
             auto compression = chooseCompressionMethod(path_with_info.path, compression_method);
             auto impl = std::make_unique<ReadBufferFromHDFS>(my_uri_without_path, path_with_info.path, ctx->getGlobalContext()->getConfigRef(), ctx->getReadSettings());
-            const Int64 zstd_window_log_max = ctx->getSettingsRef().zstd_window_log_max;
-            buf = wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
-
-            if (!ctx->getSettingsRef().hdfs_skip_empty_files || !buf->eof())
+            if (!ctx->getSettingsRef().hdfs_skip_empty_files || !impl->eof())
             {
+                const Int64 zstd_window_log_max = ctx->getSettingsRef().zstd_window_log_max;
                 first = false;
-                return buf;
+                return wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
             }
         }
     };
@@ -364,11 +361,10 @@ HDFSSource::HDFSSource(
 
 bool HDFSSource::initialize()
 {
-    StorageHDFS::PathWithInfo path_with_info;
     bool skip_empty_files = getContext()->getSettingsRef().hdfs_skip_empty_files;
     while (true)
     {
-        path_with_info = (*file_iterator)();
+        auto path_with_info = (*file_iterator)();
         if (path_with_info.path.empty())
             return false;
 
@@ -381,10 +377,12 @@ bool HDFSSource::initialize()
         auto compression = chooseCompressionMethod(path_from_uri, storage->compression_method);
         auto impl = std::make_unique<ReadBufferFromHDFS>(
             uri_without_path, path_from_uri, getContext()->getGlobalContext()->getConfigRef(), getContext()->getReadSettings());
-        const Int64 zstd_window_log_max = getContext()->getSettingsRef().zstd_window_log_max;
-        read_buf = wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
-        if (!skip_empty_files || !read_buf->eof())
+        if (!skip_empty_files || !impl->eof())
+        {
+            const Int64 zstd_window_log_max = getContext()->getSettingsRef().zstd_window_log_max;
+            read_buf = wrapReadBufferWithCompressionMethod(std::move(impl), compression, static_cast<int>(zstd_window_log_max));
             break;
+        }
     }
 
     auto input_format = getContext()->getInputFormat(storage->format_name, *read_buf, block_for_format, max_block_size);
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 5c5895744ac..7af280aac95 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -1453,12 +1453,9 @@ ColumnsDescription StorageS3::getTableStructureFromDataImpl(
 
     ReadBufferIterator read_buffer_iterator = [&, first = true](ColumnsDescription & cached_columns) mutable -> std::unique_ptr<ReadBuffer>
     {
-        StorageS3Source::KeyWithInfo key_with_info;
-        std::unique_ptr<ReadBuffer> buf;
-
         while (true)
         {
-            key_with_info = (*file_iterator)();
+            auto key_with_info = (*file_iterator)();
 
             if (key_with_info.key.empty())
             {
@@ -1488,16 +1485,11 @@ ColumnsDescription StorageS3::getTableStructureFromDataImpl(
                 continue;
 
             int zstd_window_log_max = static_cast<int>(ctx->getSettingsRef().zstd_window_log_max);
-            buf = wrapReadBufferWithCompressionMethod(
-                std::make_unique<ReadBufferFromS3>(
-                    configuration.client, configuration.url.bucket, key_with_info.key, configuration.url.version_id, configuration.request_settings, ctx->getReadSettings()),
-                chooseCompressionMethod(key_with_info.key, configuration.compression_method),
-                zstd_window_log_max);
-
-            if (!ctx->getSettingsRef().s3_skip_empty_files || !buf->eof())
+            auto impl = std::make_unique<ReadBufferFromS3>(configuration.client, configuration.url.bucket, key_with_info.key, configuration.url.version_id, configuration.request_settings, ctx->getReadSettings());
+            if (!ctx->getSettingsRef().s3_skip_empty_files || !impl->eof())
             {
                 first = false;
-                return buf;
+                return wrapReadBufferWithCompressionMethod(std::move(impl), chooseCompressionMethod(key_with_info.key, configuration.compression_method), zstd_window_log_max);
             }
         }
     };
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index 4e75a4d54cb..dbb6bbaac3a 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -368,6 +368,7 @@ std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> StorageURLSource:
     ReadSettings read_settings = context->getReadSettings();
 
     size_t options = std::distance(option, end);
+    std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> last_skipped_empty_res;
     for (; option != end; ++option)
     {
         bool skip_url_not_found_error = glob_url && read_settings.http_skip_not_found_url_for_globs && option == std::prev(end);
@@ -397,6 +398,12 @@ std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> StorageURLSource:
                 /* use_external_buffer */ false,
                 /* skip_url_not_found_error */ skip_url_not_found_error);
 
+            if (context->getSettingsRef().engine_url_skip_empty_files && res->eof() && option != std::prev(end))
+            {
+                last_skipped_empty_res = {request_uri, std::move(res)};
+                continue;
+            }
+
             return std::make_tuple(request_uri, std::move(res));
         }
         catch (...)
@@ -413,6 +420,11 @@ std::pair<Poco::URI, std::unique_ptr<ReadWriteBufferFromHTTP>> StorageURLSource:
         }
     }
 
+    /// If all options are unreachable except empty ones that we skipped,
+    /// return last empty result. It will be skipped later.
+    if (last_skipped_empty_res.second)
+        return last_skipped_empty_res;
+
     throw Exception(ErrorCodes::NETWORK_ERROR, "All uri ({}) options are unreachable: {}", options, first_exception_message);
 }
 
diff --git a/tests/integration/test_storage_s3/test.py b/tests/integration/test_storage_s3/test.py
index 357f78119ac..3867d6441e7 100644
--- a/tests/integration/test_storage_s3/test.py
+++ b/tests/integration/test_storage_s3/test.py
@@ -1768,3 +1768,15 @@ def test_skip_empty_files(started_cluster):
 
     test("s3", "s3_skip_empty_files")
     test("url", "engine_url_skip_empty_files")
+
+    res = instance.query(
+        f"select * from url('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{1|2}}.parquet') settings engine_url_skip_empty_files=1"
+    )
+
+    assert int(res) == 0
+
+    res = instance.query(
+        f"select * from url('http://{started_cluster.minio_host}:{started_cluster.minio_port}/{bucket}/skip_empty_files{{11|1|22}}.parquet') settings engine_url_skip_empty_files=1"
+    )
+
+    assert len(res.strip()) == 0

From dc0a224f52edf40bf53f3d4cd7c9dc289a7d0903 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 15 Jun 2023 15:05:17 +0200
Subject: [PATCH 474/722] fix

---
 src/Storages/MergeTree/MergeTreeData.cpp          |  2 +-
 .../configs/compat.xml                            |  4 ++++
 .../test_lost_part_during_startup/test.py         |  9 ++++++++-
 .../test_ttl_replicated/configs/compat.xml        |  4 ++++
 tests/integration/test_ttl_replicated/test.py     | 15 ++++++++++++---
 .../configs/compat.xml                            |  4 ++++
 .../test_version_update_after_mutation/test.py    |  9 +++++++++
 7 files changed, 42 insertions(+), 5 deletions(-)
 create mode 100644 tests/integration/test_lost_part_during_startup/configs/compat.xml
 create mode 100644 tests/integration/test_ttl_replicated/configs/compat.xml
 create mode 100644 tests/integration/test_version_update_after_mutation/configs/compat.xml

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 9106e14e591..2e52ec3855c 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1917,7 +1917,7 @@ try
             ++num_loaded_parts;
             if (res.is_broken)
             {
-                forcefullyRemoveBrokenOutdatedPartFromZooKeeperBeforeDetaching(part->name);
+                forcefullyRemoveBrokenOutdatedPartFromZooKeeperBeforeDetaching(res.part->name);
                 res.part->renameToDetached("broken-on-start"); /// detached parts must not have '_' in prefixes
             }
             else if (res.part->is_duplicate)
diff --git a/tests/integration/test_lost_part_during_startup/configs/compat.xml b/tests/integration/test_lost_part_during_startup/configs/compat.xml
new file mode 100644
index 00000000000..c919eaf6146
--- /dev/null
+++ b/tests/integration/test_lost_part_during_startup/configs/compat.xml
@@ -0,0 +1,4 @@
+<clickhouse>
+    <replicated_merge_tree_paranoid_check_on_drop_range>0</replicated_merge_tree_paranoid_check_on_drop_range>
+    <replicated_merge_tree_paranoid_check_on_startup>0</replicated_merge_tree_paranoid_check_on_startup>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_lost_part_during_startup/test.py b/tests/integration/test_lost_part_during_startup/test.py
index de21d64c8aa..a013ec5d48d 100644
--- a/tests/integration/test_lost_part_during_startup/test.py
+++ b/tests/integration/test_lost_part_during_startup/test.py
@@ -6,7 +6,14 @@ from helpers.cluster import ClickHouseCluster
 
 cluster = ClickHouseCluster(__file__)
 node1 = cluster.add_instance("node1", with_zookeeper=True, stay_alive=True)
-node2 = cluster.add_instance("node2", with_zookeeper=True, stay_alive=True)
+node2 = cluster.add_instance(
+    "node2",
+    with_zookeeper=True,
+    stay_alive=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
+)
 
 
 @pytest.fixture(scope="module")
diff --git a/tests/integration/test_ttl_replicated/configs/compat.xml b/tests/integration/test_ttl_replicated/configs/compat.xml
new file mode 100644
index 00000000000..c919eaf6146
--- /dev/null
+++ b/tests/integration/test_ttl_replicated/configs/compat.xml
@@ -0,0 +1,4 @@
+<clickhouse>
+    <replicated_merge_tree_paranoid_check_on_drop_range>0</replicated_merge_tree_paranoid_check_on_drop_range>
+    <replicated_merge_tree_paranoid_check_on_startup>0</replicated_merge_tree_paranoid_check_on_startup>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_ttl_replicated/test.py b/tests/integration/test_ttl_replicated/test.py
index 39d66d857ff..05eab7a952f 100644
--- a/tests/integration/test_ttl_replicated/test.py
+++ b/tests/integration/test_ttl_replicated/test.py
@@ -19,6 +19,9 @@ node4 = cluster.add_instance(
     tag="20.12.4.5",
     stay_alive=True,
     with_installed_binary=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
 )
 
 node5 = cluster.add_instance(
@@ -28,6 +31,9 @@ node5 = cluster.add_instance(
     tag="20.12.4.5",
     stay_alive=True,
     with_installed_binary=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
 )
 node6 = cluster.add_instance(
     "node6",
@@ -36,6 +42,9 @@ node6 = cluster.add_instance(
     tag="20.12.4.5",
     stay_alive=True,
     with_installed_binary=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
 )
 
 
@@ -517,7 +526,7 @@ def test_ttl_compatibility(started_cluster, node_left, node_right, num_run):
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_delete_{suff}', '{replica}')
                 ORDER BY id PARTITION BY toDayOfMonth(date)
                 TTL date + INTERVAL 3 SECOND
-                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100, remove_empty_parts=0
+                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100
             """.format(
                 suff=num_run, replica=node.name
             )
@@ -529,7 +538,7 @@ def test_ttl_compatibility(started_cluster, node_left, node_right, num_run):
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_group_by_{suff}', '{replica}')
                 ORDER BY id PARTITION BY toDayOfMonth(date)
                 TTL date + INTERVAL 3 SECOND GROUP BY id SET val = sum(val)
-                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100, remove_empty_parts=0
+                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100
             """.format(
                 suff=num_run, replica=node.name
             )
@@ -541,7 +550,7 @@ def test_ttl_compatibility(started_cluster, node_left, node_right, num_run):
                 ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/test_ttl_where_{suff}', '{replica}')
                 ORDER BY id PARTITION BY toDayOfMonth(date)
                 TTL date + INTERVAL 3 SECOND DELETE WHERE id % 2 = 1
-                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100, remove_empty_parts=0
+                SETTINGS max_number_of_merges_with_ttl_in_pool=100, max_replicated_merges_with_ttl_in_queue=100
             """.format(
                 suff=num_run, replica=node.name
             )
diff --git a/tests/integration/test_version_update_after_mutation/configs/compat.xml b/tests/integration/test_version_update_after_mutation/configs/compat.xml
new file mode 100644
index 00000000000..c919eaf6146
--- /dev/null
+++ b/tests/integration/test_version_update_after_mutation/configs/compat.xml
@@ -0,0 +1,4 @@
+<clickhouse>
+    <replicated_merge_tree_paranoid_check_on_drop_range>0</replicated_merge_tree_paranoid_check_on_drop_range>
+    <replicated_merge_tree_paranoid_check_on_startup>0</replicated_merge_tree_paranoid_check_on_startup>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_version_update_after_mutation/test.py b/tests/integration/test_version_update_after_mutation/test.py
index 17b70ba7c84..c80205d48c1 100644
--- a/tests/integration/test_version_update_after_mutation/test.py
+++ b/tests/integration/test_version_update_after_mutation/test.py
@@ -13,6 +13,9 @@ node1 = cluster.add_instance(
     tag="20.4.9.110",
     with_installed_binary=True,
     stay_alive=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
 )
 node2 = cluster.add_instance(
     "node2",
@@ -21,6 +24,9 @@ node2 = cluster.add_instance(
     tag="20.4.9.110",
     with_installed_binary=True,
     stay_alive=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
 )
 node3 = cluster.add_instance(
     "node3",
@@ -29,6 +35,9 @@ node3 = cluster.add_instance(
     tag="20.4.9.110",
     with_installed_binary=True,
     stay_alive=True,
+    main_configs=[
+        "configs/compat.xml",
+    ],
 )
 
 

From eb2a5c31a3e6bf67bf8975df2a13e2e368691220 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 15 Jun 2023 15:11:30 +0200
Subject: [PATCH 475/722] Do not mock git_helper.Git, suppress `git describe`
 error for ignore_no_tags

---
 tests/ci/docker_test.py | 9 ++-------
 tests/ci/git_helper.py  | 7 ++++---
 2 files changed, 6 insertions(+), 10 deletions(-)

diff --git a/tests/ci/docker_test.py b/tests/ci/docker_test.py
index 9d68f436439..d5d27f73694 100644
--- a/tests/ci/docker_test.py
+++ b/tests/ci/docker_test.py
@@ -10,9 +10,8 @@ from pr_info import PRInfo
 from report import TestResult
 import docker_images_check as di
 
-with patch("git_helper.Git"):
-    from version_helper import get_version_from_string
-    import docker_server as ds
+from version_helper import get_version_from_string
+import docker_server as ds
 
 # di.logging.basicConfig(level=di.logging.INFO)
 
@@ -312,7 +311,3 @@ class TestDockerServer(unittest.TestCase):
         for case in cases_equal:
             release = ds.auto_release_type(case[0], "auto")
             self.assertEqual(case[1], release)
-
-
-if __name__ == "__main__":
-    unittest.main()
diff --git a/tests/ci/git_helper.py b/tests/ci/git_helper.py
index a9f2bf9b1cc..ab1caa42660 100644
--- a/tests/ci/git_helper.py
+++ b/tests/ci/git_helper.py
@@ -126,15 +126,16 @@ class Git:
         # Format should match TAG_REGEXP
         if self._ignore_no_tags and is_shallow():
             try:
-                self._update_tags()
+                self._update_tags(True)
             except subprocess.CalledProcessError:
                 pass
 
             return
         self._update_tags()
 
-    def _update_tags(self):
-        self.latest_tag = self.run("git describe --tags --abbrev=0")
+    def _update_tags(self, suppress_stderr: bool = False) -> None:
+        stderr = subprocess.DEVNULL if suppress_stderr else None
+        self.latest_tag = self.run("git describe --tags --abbrev=0", stderr=stderr)
         # Format should be: {latest_tag}-{commits_since_tag}-g{sha_short}
         self.description = self.run("git describe --tags --long")
         self.commits_since_tag = int(

From 17602475997444e1627a47000cf2eed4c9c585b7 Mon Sep 17 00:00:00 2001
From: Zhiguo Zhou <zhiguo.zhou@intel.com>
Date: Tue, 13 Jun 2023 21:41:08 +0800
Subject: [PATCH 476/722] Add tests in date_predicate_optimizations

This commit adds tests of toYear/toYYYYMM for all of the date
types, including Date, Date32, DateTime and DateTime64, to ensure
the optimization for the date or datetime filter would not break
the queries. The test data are especially selected around the margins
of a year or a month.
---
 ...783_date_predicate_optimizations.reference | 52 +++++++++++++
 .../02783_date_predicate_optimizations.sql    | 76 +++++++++++++++++++
 2 files changed, 128 insertions(+)

diff --git a/tests/queries/0_stateless/02783_date_predicate_optimizations.reference b/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
index cd689b93034..872a5dd1d7d 100644
--- a/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
+++ b/tests/queries/0_stateless/02783_date_predicate_optimizations.reference
@@ -1,2 +1,54 @@
 2021-12-31 23:00:00	0
 2021-12-31 23:00:00	0
+Date
+2
+3
+2
+4
+1
+3
+3
+2
+1
+4
+1
+4
+DateTime
+2
+3
+2
+4
+1
+3
+3
+2
+1
+4
+1
+4
+Date32
+2
+3
+2
+4
+1
+3
+3
+2
+1
+4
+1
+4
+DateTime64
+2
+3
+2
+4
+1
+3
+3
+2
+1
+4
+1
+4
diff --git a/tests/queries/0_stateless/02783_date_predicate_optimizations.sql b/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
index abb13f1005e..0a2fa6cc93b 100644
--- a/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
+++ b/tests/queries/0_stateless/02783_date_predicate_optimizations.sql
@@ -11,3 +11,79 @@ INSERT INTO source values ('2021-12-31 23:00:00', 0);
 
 SELECT * FROM source WHERE toYYYYMM(ts) = 202112;
 SELECT * FROM source WHERE toYear(ts) = 2021;
+
+DROP TABLE IF EXISTS source;
+CREATE TABLE source
+(
+    `dt` Date,
+    `ts` DateTime,
+    `dt_32` Date32,
+    `ts_64` DateTime64(3),
+    `n` Int32
+)
+ENGINE = MergeTree
+PARTITION BY toYYYYMM(ts)
+ORDER BY tuple();
+
+INSERT INTO source values ('2022-12-31', '2022-12-31 23:59:59', '2022-12-31', '2022-12-31 23:59:59.123', 0);
+INSERT INTO source values ('2023-01-01', '2023-01-01 00:00:00', '2023-01-01', '2023-01-01 00:00:00.000', 1);
+INSERT INTO source values ('2023-12-01', '2023-12-01 00:00:00', '2023-12-01', '2023-12-01 00:00:00.000', 2);
+INSERT INTO source values ('2023-12-31', '2023-12-31 23:59:59', '2023-12-31', '2023-12-31 23:59:59.123', 3);
+INSERT INTO source values ('2024-01-01', '2024-01-01 00:00:00', '2024-01-01', '2024-01-01 00:00:00.000', 4);
+
+SELECT 'Date';
+SELECT count(*) FROM source WHERE toYYYYMM(dt) = 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt) <> 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt) < 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt) <= 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt) > 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt) >= 202312;
+SELECT count(*) FROM source WHERE toYear(dt) = 2023;
+SELECT count(*) FROM source WHERE toYear(dt) <> 2023;
+SELECT count(*) FROM source WHERE toYear(dt) < 2023;
+SELECT count(*) FROM source WHERE toYear(dt) <= 2023;
+SELECT count(*) FROM source WHERE toYear(dt) > 2023;
+SELECT count(*) FROM source WHERE toYear(dt) >= 2023;
+
+SELECT 'DateTime';
+SELECT count(*) FROM source WHERE toYYYYMM(ts) = 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts) <> 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts) < 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts) <= 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts) > 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts) >= 202312;
+SELECT count(*) FROM source WHERE toYear(ts) = 2023;
+SELECT count(*) FROM source WHERE toYear(ts) <> 2023;
+SELECT count(*) FROM source WHERE toYear(ts) < 2023;
+SELECT count(*) FROM source WHERE toYear(ts) <= 2023;
+SELECT count(*) FROM source WHERE toYear(ts) > 2023;
+SELECT count(*) FROM source WHERE toYear(ts) >= 2023;
+
+SELECT 'Date32';
+SELECT count(*) FROM source WHERE toYYYYMM(dt_32) = 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt_32) <> 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt_32) < 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt_32) <= 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt_32) > 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(dt_32) >= 202312;
+SELECT count(*) FROM source WHERE toYear(dt_32) = 2023;
+SELECT count(*) FROM source WHERE toYear(dt_32) <> 2023;
+SELECT count(*) FROM source WHERE toYear(dt_32) < 2023;
+SELECT count(*) FROM source WHERE toYear(dt_32) <= 2023;
+SELECT count(*) FROM source WHERE toYear(dt_32) > 2023;
+SELECT count(*) FROM source WHERE toYear(dt_32) >= 2023;
+
+SELECT 'DateTime64';
+SELECT count(*) FROM source WHERE toYYYYMM(ts_64) = 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts_64) <> 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts_64) < 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts_64) <= 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts_64) > 202312;
+SELECT count(*) FROM source WHERE toYYYYMM(ts_64) >= 202312;
+SELECT count(*) FROM source WHERE toYear(ts_64) = 2023;
+SELECT count(*) FROM source WHERE toYear(ts_64) <> 2023;
+SELECT count(*) FROM source WHERE toYear(ts_64) < 2023;
+SELECT count(*) FROM source WHERE toYear(ts_64) <= 2023;
+SELECT count(*) FROM source WHERE toYear(ts_64) > 2023;
+SELECT count(*) FROM source WHERE toYear(ts_64) >= 2023;
+DROP TABLE source;

From d14299eb094e35810d163b0f7657a4a2da78b3d2 Mon Sep 17 00:00:00 2001
From: Zhiguo Zhou <zhiguo.zhou@intel.com>
Date: Tue, 13 Jun 2023 22:40:06 +0800
Subject: [PATCH 477/722] The general optimization of predicates with
 date/datetime converters

As is suggested in issue #15257, the function preimage is a general
solution to the optimization problem with predicates containing the
date and datetime converters. This commit implements the idea by
adding the new methods, hasInformationAboutPreimage and getPreimage,
to IFunction/IFunctionBase, and having the specific convert functions
define their own preimage. Moreover, we added a new pass in the
TreeOptimizer and a new AST visitor for in-place rewriting the AST
with the converters' preimage.

Specifically, the optimization is applied to toYear and toYYYYMM.
---
 src/Functions/DateTimeTransforms.h            | 172 ++++++++++++++++
 .../FunctionDateOrDateTimeToSomething.h       |   7 +
 src/Functions/IFunction.h                     |  23 ++-
 src/Functions/IFunctionAdaptors.h             |   7 +
 ...OrDateTimeConverterWithPreimageVisitor.cpp | 188 ++++++++++++++++++
 ...teOrDateTimeConverterWithPreimageVisitor.h |  37 ++++
 src/Interpreters/TreeOptimizer.cpp            |  19 ++
 ...dicate_optimizations_ast_rewrite.reference |  87 ++++++++
 ...te_predicate_optimizations_ast_rewrite.sql |  47 +++++
 9 files changed, 586 insertions(+), 1 deletion(-)
 create mode 100644 src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
 create mode 100644 src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h
 create mode 100644 tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.reference
 create mode 100644 tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.sql

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 019e0c42cde..38beaeb6c82 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -322,6 +322,11 @@ struct ToTimeImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToDateImpl;
 };
@@ -393,6 +398,11 @@ struct ToStartOfSecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -440,6 +450,11 @@ struct ToStartOfMillisecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -483,6 +498,11 @@ struct ToStartOfMicrosecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -520,6 +540,11 @@ struct ToStartOfNanosecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -718,6 +743,28 @@ struct ToYearImpl
         return time_zone.toYear(DayNum(d));
     }
 
+    static inline bool hasPreimage() { return true; }
+
+    static inline RangeOrNull getPreimage(const IDataType & type, const Field & point)
+    {
+        if (point.getType() != Field::Types::UInt64) return std::nullopt;
+
+        auto year = point.get<UInt64>();
+        if (year < DATE_LUT_MIN_YEAR || year >= DATE_LUT_MAX_YEAR) return std::nullopt;
+
+        const DateLUTImpl & date_lut = DateLUT::instance();
+
+        auto start_time = date_lut.makeDateTime(year, 1, 1, 0, 0, 0);
+        auto end_time = date_lut.addYears(start_time, 1);
+
+        if (isDateOrDate32(type) || isDateTime(type) || isDateTime64(type))
+            return {std::make_pair(Field(start_time), Field(end_time))};
+        else
+            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
+                "Illegal type {} of argument of function {}. Should be Date, Date32, DateTime or DateTime64",
+                type.getName(), name);
+    }
+
     using FactorTransform = ZeroTransform;
 };
 
@@ -791,6 +838,11 @@ struct ToQuarterImpl
     {
         return time_zone.toQuarter(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -815,6 +867,11 @@ struct ToMonthImpl
     {
         return time_zone.toMonth(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -840,6 +897,11 @@ struct ToDayOfMonthImpl
         return time_zone.toDayOfMonth(DayNum(d));
     }
 
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
     using FactorTransform = ToStartOfMonthImpl;
 };
 
@@ -887,6 +949,11 @@ struct ToDayOfYearImpl
     {
         return time_zone.toDayOfYear(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -911,6 +978,11 @@ struct ToHourImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToDateImpl;
 };
@@ -939,6 +1011,11 @@ struct TimezoneOffsetImpl
         throwDateTimeIsNotSupported(name);
     }
 
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
     using FactorTransform = ToTimeImpl;
 };
 
@@ -962,6 +1039,11 @@ struct ToMinuteImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToStartOfHourImpl;
 };
@@ -986,6 +1068,11 @@ struct ToSecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToStartOfMinuteImpl;
 };
@@ -1010,6 +1097,11 @@ struct ToISOYearImpl
     {
         return time_zone.toISOYear(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1066,6 +1158,11 @@ struct ToISOWeekImpl
     {
         return time_zone.toISOWeek(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ToISOYearImpl;
 };
@@ -1108,6 +1205,11 @@ struct ToRelativeYearNumImpl
     {
         return time_zone.toYear(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1139,6 +1241,11 @@ struct ToRelativeQuarterNumImpl
     {
         return time_zone.toRelativeQuarterNum(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1170,6 +1277,11 @@ struct ToRelativeMonthNumImpl
     {
         return time_zone.toRelativeMonthNum(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1201,6 +1313,11 @@ struct ToRelativeWeekNumImpl
     {
         return time_zone.toRelativeWeekNum(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1232,6 +1349,11 @@ struct ToRelativeDayNumImpl
     {
         return static_cast<DayNum>(d);
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1269,6 +1391,11 @@ struct ToRelativeHourNumImpl
         else
             return static_cast<UInt32>(time_zone.toRelativeHourNum(DayNum(d)));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1300,6 +1427,11 @@ struct ToRelativeMinuteNumImpl
     {
         return static_cast<UInt32>(time_zone.toRelativeMinuteNum(DayNum(d)));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1328,6 +1460,11 @@ struct ToRelativeSecondNumImpl
     {
         return static_cast<UInt32>(time_zone.fromDayNum(DayNum(d)));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1352,6 +1489,31 @@ struct ToYYYYMMImpl
     {
         return time_zone.toNumYYYYMM(DayNum(d));
     }
+    static inline bool hasPreimage() { return true; }
+
+    static inline RangeOrNull getPreimage(const IDataType & type, const Field & point)
+    {
+        if (point.getType() != Field::Types::UInt64) return std::nullopt;
+
+        auto year_month = point.get<UInt64>();
+        auto year = year_month / 100;
+        auto month = year_month % 100;
+
+        if (year < DATE_LUT_MIN_YEAR || year > DATE_LUT_MAX_YEAR || month < 1 || month > 12 || (year == DATE_LUT_MAX_YEAR && month == 12))
+            return std::nullopt;
+
+        const DateLUTImpl & date_lut = DateLUT::instance();
+
+        auto start_time = date_lut.makeDateTime(year, month, 1, 0, 0, 0);
+        auto end_time = date_lut.addMonths(start_time, 1);
+
+        if (isDateOrDate32(type) || isDateTime(type) || isDateTime64(type))
+            return {std::make_pair(Field(start_time), Field(end_time))};
+        else
+            throw Exception(ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT,
+                "Illegal type {} of argument of function {}. Should be Date, Date32, DateTime or DateTime64",
+                type.getName(), name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1376,6 +1538,11 @@ struct ToYYYYMMDDImpl
     {
         return time_zone.toNumYYYYMMDD(DayNum(d));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1400,6 +1567,11 @@ struct ToYYYYMMDDhhmmssImpl
     {
         return time_zone.toNumYYYYMMDDhhmmss(time_zone.toDate(DayNum(d)));
     }
+    static inline bool hasPreimage() { return false; }
+    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
+    }
 
     using FactorTransform = ZeroTransform;
 };
diff --git a/src/Functions/FunctionDateOrDateTimeToSomething.h b/src/Functions/FunctionDateOrDateTimeToSomething.h
index 82818cc3d2b..11f75dd3ee1 100644
--- a/src/Functions/FunctionDateOrDateTimeToSomething.h
+++ b/src/Functions/FunctionDateOrDateTimeToSomething.h
@@ -83,6 +83,13 @@ public:
                 arguments[0].type->getName(), this->getName());
     }
 
+    bool hasInformationAboutPreimage() const override { return Transform::hasPreimage(); }
+
+    RangeOrNull getPreimage(const IDataType & type, const Field & point) const override
+    {
+        return Transform::getPreimage(type, point);
+    }
+
 };
 
 }
diff --git a/src/Functions/IFunction.h b/src/Functions/IFunction.h
index b613ddb8987..cf2dcc9617e 100644
--- a/src/Functions/IFunction.h
+++ b/src/Functions/IFunction.h
@@ -2,6 +2,7 @@
 
 #include <Core/ColumnNumbers.h>
 #include <Core/ColumnsWithTypeAndName.h>
+#include <Core/Field.h>
 #include <Core/Names.h>
 #include <Core/IResolvedFunction.h>
 #include <Common/Exception.h>
@@ -30,7 +31,8 @@ namespace ErrorCodes
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
 }
 
-class Field;
+/// A left-closed and right-open interval representing the preimage of a function.
+using RangeOrNull = std::optional<std::pair<Field, Field>>;
 
 /// The simplest executable object.
 /// Motivation:
@@ -230,6 +232,12 @@ public:
       */
     virtual bool hasInformationAboutMonotonicity() const { return false; }
 
+    /** Lets you know if the function has its definition of preimage.
+      * This is used to work with predicate optimizations, where the comparison between
+      * f(x) and a constant c could be converted to the comparison between x and f's preimage [b, e).
+      */
+    virtual bool hasInformationAboutPreimage() const { return false; }
+
     struct ShortCircuitSettings
     {
         /// Should we enable lazy execution for the first argument of short-circuit function?
@@ -283,6 +291,14 @@ public:
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its monotonicity", getName());
     }
 
+    /** Get the preimage of a function in the form of a left-closed and right-open interval. Call only if hasInformationAboutPreimage.
+      * std::nullopt might be returned if the point (a single value) is invalid for this function.
+      */
+    virtual RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/) const
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", getName());
+    }
+
 };
 
 using FunctionBasePtr = std::shared_ptr<const IFunctionBase>;
@@ -472,12 +488,17 @@ public:
     virtual bool isSuitableForShortCircuitArgumentsExecution(const DataTypesWithConstInfo & /*arguments*/) const = 0;
 
     virtual bool hasInformationAboutMonotonicity() const { return false; }
+    virtual bool hasInformationAboutPreimage() const { return false; }
 
     using Monotonicity = IFunctionBase::Monotonicity;
     virtual Monotonicity getMonotonicityForRange(const IDataType & /*type*/, const Field & /*left*/, const Field & /*right*/) const
     {
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its monotonicity", getName());
     }
+    virtual RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/) const
+    {
+        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", getName());
+    }
 
     /// For non-variadic functions, return number of arguments; otherwise return zero (that should be ignored).
     virtual size_t getNumberOfArguments() const = 0;
diff --git a/src/Functions/IFunctionAdaptors.h b/src/Functions/IFunctionAdaptors.h
index eb2350d9b5e..4ecb45167cc 100644
--- a/src/Functions/IFunctionAdaptors.h
+++ b/src/Functions/IFunctionAdaptors.h
@@ -90,10 +90,17 @@ public:
 
     bool hasInformationAboutMonotonicity() const override { return function->hasInformationAboutMonotonicity(); }
 
+    bool hasInformationAboutPreimage() const override { return function->hasInformationAboutPreimage(); }
+
     Monotonicity getMonotonicityForRange(const IDataType & type, const Field & left, const Field & right) const override
     {
         return function->getMonotonicityForRange(type, left, right);
     }
+
+    RangeOrNull getPreimage(const IDataType & type, const Field & point) const override
+    {
+        return function->getPreimage(type, point);
+    }
 private:
     std::shared_ptr<IFunction> function;
     DataTypes arguments;
diff --git a/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp b/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
new file mode 100644
index 00000000000..b209f4774f7
--- /dev/null
+++ b/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
@@ -0,0 +1,188 @@
+#include <Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h>
+
+#include <Core/Field.h>
+#include <Core/NamesAndTypes.h>
+#include <Common/DateLUT.h>
+#include <Common/DateLUTImpl.h>
+#include <Functions/FunctionFactory.h>
+#include <Interpreters/IdentifierSemantic.h>
+#include <Parsers/ASTIdentifier.h>
+#include <Parsers/ASTLiteral.h>
+#include <Parsers/ASTFunction.h>
+
+
+namespace DB
+{
+
+/** Given a monotonic non-decreasing function f(x), which satisfies f(x) = c for any value x within [b, e).
+ *  We could convert it into its equivalent form, x >= b AND x < e, which is free from the invocation of the function.
+ *  And we could apply the similar transformation to other comparisons. The suggested transformations list:
+ *
+ *  f(x) == c -> x >= b AND x <  e
+ *  f(x) != c -> x <  b OR  x >= e
+ *  f(x) >  c -> x >= e
+ *  f(x) >= c -> x >= b
+ *  f(x) <  c -> x <  b
+ *  f(x) <= c -> x <  e
+ *
+ *  This function generates a new AST with the transformed relation.
+ */
+ASTPtr generateOptimizedDateFilterAST(const String & comparator, const NameAndTypePair & column, const std::pair<Field, Field>& range)
+{
+    const DateLUTImpl & date_lut = DateLUT::instance();
+
+    const String & column_name = column.name;
+    String start_date_or_date_time;
+    String end_date_or_date_time;
+
+    if (isDateOrDate32(column.type.get()))
+    {
+        start_date_or_date_time = date_lut.dateToString(range.first.get<DateLUTImpl::Time>());
+        end_date_or_date_time = date_lut.dateToString(range.second.get<DateLUTImpl::Time>());
+    }
+    else if (isDateTime(column.type.get()) || isDateTime64(column.type.get()))
+    {
+        start_date_or_date_time = date_lut.timeToString(range.first.get<DateLUTImpl::Time>());
+        end_date_or_date_time = date_lut.timeToString(range.second.get<DateLUTImpl::Time>());
+    }
+    else [[unlikely]] return {};
+
+    if (comparator == "equals")
+    {
+        return makeASTFunction("and",
+                                makeASTFunction("greaterOrEquals",
+                                            std::make_shared<ASTIdentifier>(column_name),
+                                            std::make_shared<ASTLiteral>(start_date_or_date_time)
+                                            ),
+                                makeASTFunction("less",
+                                            std::make_shared<ASTIdentifier>(column_name),
+                                            std::make_shared<ASTLiteral>(end_date_or_date_time)
+                                            )
+                                );
+    }
+    else if (comparator == "notEquals")
+    {
+        return makeASTFunction("or",
+                                makeASTFunction("less",
+                                            std::make_shared<ASTIdentifier>(column_name),
+                                            std::make_shared<ASTLiteral>(start_date_or_date_time)
+                                            ),
+                                makeASTFunction("greaterOrEquals",
+                                            std::make_shared<ASTIdentifier>(column_name),
+                                            std::make_shared<ASTLiteral>(end_date_or_date_time)
+                                            )
+                                );
+    }
+    else if (comparator == "greater")
+    {
+        return makeASTFunction("greaterOrEquals",
+                    std::make_shared<ASTIdentifier>(column_name),
+                    std::make_shared<ASTLiteral>(end_date_or_date_time)
+                    );
+    }
+    else if (comparator == "lessOrEquals")
+    {
+        return makeASTFunction("less",
+                    std::make_shared<ASTIdentifier>(column_name),
+                    std::make_shared<ASTLiteral>(end_date_or_date_time)
+                    );
+    }
+    else // comparator == "less" || comparator == "greaterOrEquals"
+    {
+        return makeASTFunction(comparator,
+                    std::make_shared<ASTIdentifier>(column_name),
+                    std::make_shared<ASTLiteral>(start_date_or_date_time)
+                    );
+    }
+}
+
+void OptimizeDateOrDateTimeConverterWithPreimageMatcher::visit(const ASTFunction & function, ASTPtr & ast, const Data & data)
+{
+    const static std::unordered_map<String, String> swap_relations = {
+        {"equals", "equals"},
+        {"notEquals", "notEquals"},
+        {"less", "greater"},
+        {"greater", "less"},
+        {"lessOrEquals", "greaterOrEquals"},
+        {"greaterOrEquals", "lessOrEquals"},
+    };
+
+    if (!swap_relations.contains(function.name)) return;
+
+    if (!function.arguments || function.arguments->children.size() != 2) return;
+
+    size_t func_id = function.arguments->children.size();
+
+    for (size_t i = 0; i < function.arguments->children.size(); i++)
+    {
+        if (const auto * func = function.arguments->children[i]->as<ASTFunction>())
+        {
+            func_id = i;
+        }
+    }
+
+    if (func_id == function.arguments->children.size()) return;
+
+    size_t literal_id = 1 - func_id;
+    const auto * literal = function.arguments->children[literal_id]->as<ASTLiteral>();
+
+    if (!literal || literal->value.getType() != Field::Types::UInt64) return;
+
+    String comparator = literal_id > func_id ? function.name : swap_relations.at(function.name);
+
+    const auto * ast_func = function.arguments->children[func_id]->as<ASTFunction>();
+    /// Currently we only handle single-argument functions.
+    if (!ast_func || !ast_func->arguments || ast_func->arguments->children.size() != 1) return;
+
+    const auto * column_id = ast_func->arguments->children.at(0)->as<ASTIdentifier>();
+    if (!column_id) return;
+
+    auto pos = IdentifierSemantic::getMembership(*column_id);
+    if (!pos)
+        pos = IdentifierSemantic::chooseTableColumnMatch(*column_id, data.tables, true);
+    if (!pos)
+        return;
+
+    if (*pos >= data.tables.size())
+        return;
+
+    auto data_type_and_name = data.tables[*pos].columns.tryGetByName(column_id->shortName());
+    if (!data_type_and_name) return;
+
+    const auto & converter = FunctionFactory::instance().tryGet(ast_func->name, data.context);
+    if (!converter) return;
+
+    ColumnsWithTypeAndName args;
+    args.emplace_back(data_type_and_name->type, "tmp");
+    auto converter_base = converter->build(args);
+    if (!converter_base || !converter_base->hasInformationAboutPreimage()) return;
+
+    auto preimage_range = converter_base->getPreimage(*(data_type_and_name->type), literal->value);
+    if (!preimage_range) return;
+
+    const auto new_ast = generateOptimizedDateFilterAST(comparator, *data_type_and_name, *preimage_range);
+    if (!new_ast) return;
+
+    ast = new_ast;
+}
+
+bool OptimizeDateOrDateTimeConverterWithPreimageMatcher::needChildVisit(ASTPtr & ast, ASTPtr & /*child*/)
+{
+    const static std::unordered_set<String> relations = {
+        "equals",
+        "notEquals",
+        "less",
+        "greater",
+        "lessOrEquals",
+        "greaterOrEquals",
+    };
+
+    if (const auto * ast_function = ast->as<ASTFunction>())
+    {
+        return !relations.contains(ast_function->name);
+    }
+
+    return true;
+}
+
+}
diff --git a/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h b/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h
new file mode 100644
index 00000000000..778fa462364
--- /dev/null
+++ b/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h
@@ -0,0 +1,37 @@
+#pragma once
+
+#include <Interpreters/DatabaseAndTableWithAlias.h>
+#include <Interpreters/InDepthNodeVisitor.h>
+
+namespace DB
+{
+
+class ASTFunction;
+
+/** Replace predicate having Date/DateTime converters with their preimages to improve performance.
+ *  Given a Date column c, toYear(c) = 2023 -> c >= '2023-01-01' AND c < '2024-01-01'
+ *  Or if c is a DateTime column, toYear(c) = 2023 -> c >= '2023-01-01 00:00:00' AND c < '2024-01-01 00:00:00'.
+ *  The similar optimization also applies to other converters.
+ */
+class OptimizeDateOrDateTimeConverterWithPreimageMatcher
+{
+public:
+    struct Data
+    {
+        const TablesWithColumns & tables;
+        ContextPtr context;
+    };
+
+    static void visit(ASTPtr & ast, Data & data)
+    {
+        if (const auto * ast_function = ast->as<ASTFunction>())
+            visit(*ast_function, ast, data);
+    }
+
+    static void visit(const ASTFunction & function, ASTPtr & ast, const Data & data);
+
+    static bool needChildVisit(ASTPtr & ast, ASTPtr & child);
+};
+
+using OptimizeDateOrDateTimeConverterWithPreimageVisitor = InDepthNodeVisitor<OptimizeDateOrDateTimeConverterWithPreimageMatcher, true>;
+}
diff --git a/src/Interpreters/TreeOptimizer.cpp b/src/Interpreters/TreeOptimizer.cpp
index c38b3c79026..fd4d2c9d846 100644
--- a/src/Interpreters/TreeOptimizer.cpp
+++ b/src/Interpreters/TreeOptimizer.cpp
@@ -25,6 +25,7 @@
 #include <Interpreters/GatherFunctionQuantileVisitor.h>
 #include <Interpreters/RewriteSumIfFunctionVisitor.h>
 #include <Interpreters/RewriteArrayExistsFunctionVisitor.h>
+#include <Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.h>
 
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
@@ -677,6 +678,21 @@ void optimizeInjectiveFunctionsInsideUniq(ASTPtr & query, ContextPtr context)
     RemoveInjectiveFunctionsVisitor(data).visit(query);
 }
 
+void optimizeDateFilters(ASTSelectQuery * select_query, const std::vector<TableWithColumnNamesAndTypes> & tables_with_columns, ContextPtr context)
+{
+    /// Predicates in HAVING clause has been moved to WHERE clause.
+    if (select_query->where())
+    {
+        OptimizeDateOrDateTimeConverterWithPreimageVisitor::Data data{tables_with_columns, context};
+        OptimizeDateOrDateTimeConverterWithPreimageVisitor(data).visit(select_query->refWhere());
+    }
+    if (select_query->prewhere())
+    {
+        OptimizeDateOrDateTimeConverterWithPreimageVisitor::Data data{tables_with_columns, context};
+        OptimizeDateOrDateTimeConverterWithPreimageVisitor(data).visit(select_query->refPrewhere());
+    }
+}
+
 void transformIfStringsIntoEnum(ASTPtr & query)
 {
     std::unordered_set<String> function_names = {"if", "transform"};
@@ -780,6 +796,9 @@ void TreeOptimizer::apply(ASTPtr & query, TreeRewriterResult & result,
                 tables_with_columns, result.storage_snapshot->metadata, result.storage);
     }
 
+    /// Rewrite date filters to avoid the calls of converters such as toYear, toYYYYMM, etc.
+    optimizeDateFilters(select_query, tables_with_columns, context);
+
     /// GROUP BY injective function elimination.
     optimizeGroupBy(select_query, context);
 
diff --git a/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.reference b/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.reference
new file mode 100644
index 00000000000..9235e7e106a
--- /dev/null
+++ b/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.reference
@@ -0,0 +1,87 @@
+SELECT value1
+FROM date_t
+WHERE ((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((date1 < \'1993-01-01\') OR (date1 >= \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 < \'1993-01-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 >= \'1994-01-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 < \'1994-01-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 >= \'1993-01-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((date1 >= \'1993-01-01\') AND (date1 < \'1998-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\')) OR ((date1 >= \'1994-01-01\') AND (date1 < \'1995-01-01\'))) AND ((id >= 1) AND (id <= 3))
+SELECT
+    value1,
+    toYear(date1) AS year1
+FROM date_t
+WHERE ((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 < \'1993-01-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+PREWHERE (date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\')
+WHERE ((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((id >= 1) AND (id <= 3)) AND ((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\'))
+SELECT value1
+FROM date_t
+WHERE (toYYYYMM(date1) = 199300) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (toYYYYMM(date1) = 199313) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((date1 >= \'1993-12-01\') AND (date1 < \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((date1 >= \'1992-03-01\') AND (date1 < \'1992-04-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((date1 < \'1992-03-01\') OR (date1 >= \'1992-04-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 < \'1992-03-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 >= \'1992-04-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 < \'1992-04-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE (date1 >= \'1992-03-01\') AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date_t
+WHERE ((date1 >= \'1992-03-01\') OR ((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\'))) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM datetime_t
+WHERE ((date1 >= \'1993-01-01 00:00:00\') AND (date1 < \'1994-01-01 00:00:00\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM datetime_t
+WHERE ((date1 >= \'1993-12-01 00:00:00\') AND (date1 < \'1994-01-01 00:00:00\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date32_t
+WHERE ((date1 >= \'1993-01-01\') AND (date1 < \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM date32_t
+WHERE ((date1 >= \'1993-12-01\') AND (date1 < \'1994-01-01\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM datetime64_t
+WHERE ((date1 >= \'1993-01-01 00:00:00\') AND (date1 < \'1994-01-01 00:00:00\')) AND ((id >= 1) AND (id <= 3))
+SELECT value1
+FROM datetime64_t
+WHERE ((date1 >= \'1993-12-01 00:00:00\') AND (date1 < \'1994-01-01 00:00:00\')) AND ((id >= 1) AND (id <= 3))
diff --git a/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.sql b/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.sql
new file mode 100644
index 00000000000..266be59b0a3
--- /dev/null
+++ b/tests/queries/0_stateless/02785_date_predicate_optimizations_ast_rewrite.sql
@@ -0,0 +1,47 @@
+DROP TABLE IF EXISTS date_t;
+CREATE TABLE date_t (id UInt32, value1 String, date1 Date) ENGINE ReplacingMergeTree() ORDER BY id;
+
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) = 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) <> 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) < 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) > 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) <= 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) >= 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYear(date1) BETWEEN 1993 AND 1997 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE (toYear(date1) = 1993 OR toYear(date1) = 1994) AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1, toYear(date1) as year1 FROM date_t WHERE year1 = 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE 1993 > toYear(date1) AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t PREWHERE toYear(date1) = 1993 WHERE id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE id BETWEEN 1 AND 3 HAVING toYear(date1) = 1993;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) = 199300 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) = 199313 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) = 199312 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) = 199203 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) <> 199203 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) < 199203 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) > 199203 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) <= 199203 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE toYYYYMM(date1) >= 199203 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date_t WHERE (toYYYYMM(date1) >= 199203 OR toYear(date1) = 1993) AND id BETWEEN 1 AND 3;
+DROP TABLE date_t;
+
+DROP TABLE IF EXISTS datetime_t;
+CREATE TABLE datetime_t (id UInt32, value1 String, date1 Datetime) ENGINE ReplacingMergeTree() ORDER BY id;
+
+EXPLAIN SYNTAX SELECT value1 FROM datetime_t WHERE toYear(date1) = 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM datetime_t WHERE toYYYYMM(date1) = 199312 AND id BETWEEN 1 AND 3;
+DROP TABLE datetime_t;
+
+DROP TABLE IF EXISTS date32_t;
+CREATE TABLE date32_t (id UInt32, value1 String, date1 Date32) ENGINE ReplacingMergeTree() ORDER BY id;
+
+EXPLAIN SYNTAX SELECT value1 FROM date32_t WHERE toYear(date1) = 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM date32_t WHERE toYYYYMM(date1) = 199312 AND id BETWEEN 1 AND 3;
+DROP TABLE date32_t;
+
+DROP TABLE IF EXISTS datetime64_t;
+CREATE TABLE datetime64_t (id UInt32, value1 String, date1 Datetime64) ENGINE ReplacingMergeTree() ORDER BY id;
+
+EXPLAIN SYNTAX SELECT value1 FROM datetime64_t WHERE toYear(date1) = 1993 AND id BETWEEN 1 AND 3;
+EXPLAIN SYNTAX SELECT value1 FROM datetime64_t WHERE toYYYYMM(date1) = 199312 AND id BETWEEN 1 AND 3;
+DROP TABLE datetime64_t;

From 9e81b2fd5d508bc52efeb7d050aeb9ff3a832400 Mon Sep 17 00:00:00 2001
From: Han Fei <hanfei19910905@gmail.com>
Date: Tue, 13 Jun 2023 22:34:17 +0200
Subject: [PATCH 478/722] fix style

---
 src/Functions/DateTimeTransforms.h | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 38beaeb6c82..4d377dff720 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -24,6 +24,7 @@ namespace ErrorCodes
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
     extern const int ILLEGAL_COLUMN;
     extern const int CANNOT_CONVERT_TYPE;
+    extern const int NOT_IMPLEMENTED;
 }
 
 /** Transformations.

From d780d0bab1ba791d3976aa9cdd54ef791cb80845 Mon Sep 17 00:00:00 2001
From: Zhiguo Zhou <zhiguo.zhou@intel.com>
Date: Wed, 14 Jun 2023 22:39:03 +0800
Subject: [PATCH 479/722] fix style

Move error throws in Transform to FunctionDateOrDateTimeToSomething.
---
 src/Functions/DateTimeTransforms.h            | 155 +++---------------
 .../FunctionDateOrDateTimeToSomething.h       |   8 +-
 2 files changed, 34 insertions(+), 129 deletions(-)

diff --git a/src/Functions/DateTimeTransforms.h b/src/Functions/DateTimeTransforms.h
index 4d377dff720..84c71c89b11 100644
--- a/src/Functions/DateTimeTransforms.h
+++ b/src/Functions/DateTimeTransforms.h
@@ -24,7 +24,6 @@ namespace ErrorCodes
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
     extern const int ILLEGAL_COLUMN;
     extern const int CANNOT_CONVERT_TYPE;
-    extern const int NOT_IMPLEMENTED;
 }
 
 /** Transformations.
@@ -323,11 +322,7 @@ struct ToTimeImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToDateImpl;
 };
@@ -399,11 +394,7 @@ struct ToStartOfSecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -451,11 +442,7 @@ struct ToStartOfMillisecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -499,11 +486,7 @@ struct ToStartOfMicrosecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -541,11 +524,7 @@ struct ToStartOfNanosecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -744,7 +723,7 @@ struct ToYearImpl
         return time_zone.toYear(DayNum(d));
     }
 
-    static inline bool hasPreimage() { return true; }
+    static inline constexpr bool hasPreimage() { return true; }
 
     static inline RangeOrNull getPreimage(const IDataType & type, const Field & point)
     {
@@ -839,11 +818,7 @@ struct ToQuarterImpl
     {
         return time_zone.toQuarter(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -868,11 +843,7 @@ struct ToMonthImpl
     {
         return time_zone.toMonth(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -898,11 +869,7 @@ struct ToDayOfMonthImpl
         return time_zone.toDayOfMonth(DayNum(d));
     }
 
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
     using FactorTransform = ToStartOfMonthImpl;
 };
 
@@ -950,11 +917,7 @@ struct ToDayOfYearImpl
     {
         return time_zone.toDayOfYear(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfYearImpl;
 };
@@ -979,11 +942,7 @@ struct ToHourImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToDateImpl;
 };
@@ -1012,11 +971,7 @@ struct TimezoneOffsetImpl
         throwDateTimeIsNotSupported(name);
     }
 
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
     using FactorTransform = ToTimeImpl;
 };
 
@@ -1040,11 +995,7 @@ struct ToMinuteImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfHourImpl;
 };
@@ -1069,11 +1020,7 @@ struct ToSecondImpl
     {
         throwDateTimeIsNotSupported(name);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToStartOfMinuteImpl;
 };
@@ -1098,11 +1045,7 @@ struct ToISOYearImpl
     {
         return time_zone.toISOYear(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1159,11 +1102,7 @@ struct ToISOWeekImpl
     {
         return time_zone.toISOWeek(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ToISOYearImpl;
 };
@@ -1206,11 +1145,7 @@ struct ToRelativeYearNumImpl
     {
         return time_zone.toYear(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1242,11 +1177,7 @@ struct ToRelativeQuarterNumImpl
     {
         return time_zone.toRelativeQuarterNum(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1278,11 +1209,7 @@ struct ToRelativeMonthNumImpl
     {
         return time_zone.toRelativeMonthNum(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1314,11 +1241,7 @@ struct ToRelativeWeekNumImpl
     {
         return time_zone.toRelativeWeekNum(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1350,11 +1273,7 @@ struct ToRelativeDayNumImpl
     {
         return static_cast<DayNum>(d);
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1392,11 +1311,7 @@ struct ToRelativeHourNumImpl
         else
             return static_cast<UInt32>(time_zone.toRelativeHourNum(DayNum(d)));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1428,11 +1343,7 @@ struct ToRelativeMinuteNumImpl
     {
         return static_cast<UInt32>(time_zone.toRelativeMinuteNum(DayNum(d)));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1461,11 +1372,7 @@ struct ToRelativeSecondNumImpl
     {
         return static_cast<UInt32>(time_zone.fromDayNum(DayNum(d)));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1490,7 +1397,7 @@ struct ToYYYYMMImpl
     {
         return time_zone.toNumYYYYMM(DayNum(d));
     }
-    static inline bool hasPreimage() { return true; }
+    static inline constexpr bool hasPreimage() { return true; }
 
     static inline RangeOrNull getPreimage(const IDataType & type, const Field & point)
     {
@@ -1539,11 +1446,7 @@ struct ToYYYYMMDDImpl
     {
         return time_zone.toNumYYYYMMDD(DayNum(d));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
@@ -1568,11 +1471,7 @@ struct ToYYYYMMDDhhmmssImpl
     {
         return time_zone.toNumYYYYMMDDhhmmss(time_zone.toDate(DayNum(d)));
     }
-    static inline bool hasPreimage() { return false; }
-    static inline RangeOrNull getPreimage(const IDataType & /*type*/, const Field & /*point*/)
-    {
-        throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Function {} has no information about its preimage", name);
-    }
+    static inline constexpr bool hasPreimage() { return false; }
 
     using FactorTransform = ZeroTransform;
 };
diff --git a/src/Functions/FunctionDateOrDateTimeToSomething.h b/src/Functions/FunctionDateOrDateTimeToSomething.h
index 11f75dd3ee1..d98b788c7d7 100644
--- a/src/Functions/FunctionDateOrDateTimeToSomething.h
+++ b/src/Functions/FunctionDateOrDateTimeToSomething.h
@@ -7,6 +7,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
+    extern const int NOT_IMPLEMENTED;
 }
 
 /// See DateTimeTransforms.h
@@ -87,7 +88,12 @@ public:
 
     RangeOrNull getPreimage(const IDataType & type, const Field & point) const override
     {
-        return Transform::getPreimage(type, point);
+        if constexpr (Transform::hasPreimage())
+            return Transform::getPreimage(type, point);
+        else
+            throw Exception(ErrorCodes::NOT_IMPLEMENTED,
+                "Function {} has no information about its preimage",
+                Transform::name);
     }
 
 };

From ff6629d1d12441a2dc0266331f8b65cba7da2746 Mon Sep 17 00:00:00 2001
From: Zhiguo Zhou <zhiguo.zhou@intel.com>
Date: Thu, 15 Jun 2023 21:35:09 +0800
Subject: [PATCH 480/722] Enhance safety of function
 generateOptimizedDateFilterAST

This commit checks the corner case where the comparator is none
of equals, notEquals, less, lessOrEquals, greater, greaterOrEquals,
and throws LOGICAL_ERROR exception if so.
---
 ...zeDateOrDateTimeConverterWithPreimageVisitor.cpp | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp b/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
index b209f4774f7..a377bb4bba6 100644
--- a/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
+++ b/src/Interpreters/OptimizeDateOrDateTimeConverterWithPreimageVisitor.cpp
@@ -14,6 +14,11 @@
 namespace DB
 {
 
+namespace ErrorCodes
+{
+    extern const int LOGICAL_ERROR;
+}
+
 /** Given a monotonic non-decreasing function f(x), which satisfies f(x) = c for any value x within [b, e).
  *  We could convert it into its equivalent form, x >= b AND x < e, which is free from the invocation of the function.
  *  And we could apply the similar transformation to other comparisons. The suggested transformations list:
@@ -87,13 +92,19 @@ ASTPtr generateOptimizedDateFilterAST(const String & comparator, const NameAndTy
                     std::make_shared<ASTLiteral>(end_date_or_date_time)
                     );
     }
-    else // comparator == "less" || comparator == "greaterOrEquals"
+    else if (comparator == "less" || comparator == "greaterOrEquals")
     {
         return makeASTFunction(comparator,
                     std::make_shared<ASTIdentifier>(column_name),
                     std::make_shared<ASTLiteral>(start_date_or_date_time)
                     );
     }
+    else [[unlikely]]
+    {
+        throw Exception(ErrorCodes::LOGICAL_ERROR,
+            "Expected equals, notEquals, less, lessOrEquals, greater, greaterOrEquals. Actual {}",
+            comparator);
+    }
 }
 
 void OptimizeDateOrDateTimeConverterWithPreimageMatcher::visit(const ASTFunction & function, ASTPtr & ast, const Data & data)

From d136e64c989c7416ef2990e12ff45b4d57bb71af Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Thu, 15 Jun 2023 16:16:39 +0200
Subject: [PATCH 481/722] Update backup.md

---
 docs/en/operations/backup.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/en/operations/backup.md b/docs/en/operations/backup.md
index 6da61833c12..c3ddee07d0b 100644
--- a/docs/en/operations/backup.md
+++ b/docs/en/operations/backup.md
@@ -83,6 +83,7 @@ The BACKUP and RESTORE statements take a list of DATABASE and TABLE names, a des
     - [`compression_method`](/docs/en/sql-reference/statements/create/table.md/#column-compression-codecs) and compression_level
     - `password` for the file on disk
     - `base_backup`: the destination of the previous backup of this source.  For example, `Disk('backups', '1.zip')`
+    - `structure_only`: if enabled, allows to only backup or restore the CREATE statements without the data of tables
 
 ### Usage examples
 
@@ -398,4 +399,4 @@ To disallow concurrent backup/restore, you can use these settings respectively.
 ```
 
 The default value for both is true, so by default concurrent backup/restores are allowed.
-When these settings are false on a cluster, only 1 backup/restore is allowed to run on a cluster at a time.
\ No newline at end of file
+When these settings are false on a cluster, only 1 backup/restore is allowed to run on a cluster at a time.

From e01e0d53a9dab480b307de43153019a3252cf39e Mon Sep 17 00:00:00 2001
From: pufit <pufit@clickhouse.com>
Date: Tue, 13 Jun 2023 20:23:39 -0400
Subject: [PATCH 482/722] Add embedded keeper-client to keeper standalone
 binary

---
 programs/CMakeLists.txt               | 11 +++++++++--
 programs/keeper/CMakeLists.txt        | 16 ++++++++++++++++
 programs/keeper/Keeper.cpp            |  7 ++++++-
 programs/keeper/clickhouse-keeper.cpp | 24 ++++++++++++++++++++++++
 4 files changed, 55 insertions(+), 3 deletions(-)

diff --git a/programs/CMakeLists.txt b/programs/CMakeLists.txt
index c00d1f5349f..eb4a898d472 100644
--- a/programs/CMakeLists.txt
+++ b/programs/CMakeLists.txt
@@ -409,8 +409,15 @@ if (ENABLE_CLICKHOUSE_KEEPER_CONVERTER)
     list(APPEND CLICKHOUSE_BUNDLE clickhouse-keeper-converter)
 endif ()
 if (ENABLE_CLICKHOUSE_KEEPER_CLIENT)
-    add_custom_target (clickhouse-keeper-client ALL COMMAND ${CMAKE_COMMAND} -E create_symlink clickhouse clickhouse-keeper-client DEPENDS clickhouse)
-    install (FILES "${CMAKE_CURRENT_BINARY_DIR}/clickhouse-keeper-client" DESTINATION ${CMAKE_INSTALL_BINDIR} COMPONENT clickhouse)
+    if (NOT BUILD_STANDALONE_KEEPER)
+        add_custom_target (clickhouse-keeper-client ALL COMMAND ${CMAKE_COMMAND} -E create_symlink clickhouse clickhouse-keeper-client DEPENDS clickhouse)
+        install (FILES "${CMAKE_CURRENT_BINARY_DIR}/clickhouse-keeper-client" DESTINATION ${CMAKE_INSTALL_BINDIR} COMPONENT clickhouse)
+    # symlink to standalone keeper binary
+    else ()
+        add_custom_target (clickhouse-keeper-client ALL COMMAND ${CMAKE_COMMAND} -E create_symlink clickhouse-keeper clickhouse-keeper-client DEPENDS clickhouse-keeper)
+        install (FILES "${CMAKE_CURRENT_BINARY_DIR}/clickhouse-keeper-client" DESTINATION "${CMAKE_INSTALL_BINDIR}" COMPONENT clickhouse-keeper)
+    endif ()
+
     list(APPEND CLICKHOUSE_BUNDLE clickhouse-keeper-client)
 endif ()
 if (ENABLE_CLICKHOUSE_DISKS)
diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 1f1138f49eb..8bde1db019c 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -112,6 +112,18 @@ if (BUILD_STANDALONE_KEEPER)
         clickhouse-keeper.cpp
     )
 
+    # List of resources for clickhouse-keeper client
+    if (ENABLE_CLICKHOUSE_KEEPER_CLIENT)
+        list(APPEND CLICKHOUSE_KEEPER_STANDALONE_SOURCES
+            ${CMAKE_CURRENT_SOURCE_DIR}/../../programs/keeper-client/KeeperClient.cpp
+            ${CMAKE_CURRENT_SOURCE_DIR}/../../programs/keeper-client/Commands.cpp
+            ${CMAKE_CURRENT_SOURCE_DIR}/../../programs/keeper-client/Parser.cpp
+
+            ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Client/LineReader.cpp
+            ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Client/ReplxxLineReader.cpp
+        )
+    endif()
+
     clickhouse_add_executable(clickhouse-keeper ${CLICKHOUSE_KEEPER_STANDALONE_SOURCES})
 
     # Remove some redundant dependencies
@@ -122,6 +134,10 @@ if (BUILD_STANDALONE_KEEPER)
     target_include_directories(clickhouse-keeper PUBLIC "${CMAKE_CURRENT_BINARY_DIR}/../../src/Core/include") # uses some includes from core
     target_include_directories(clickhouse-keeper PUBLIC "${CMAKE_CURRENT_BINARY_DIR}/../../src") # uses some includes from common
 
+    if (ENABLE_CLICKHOUSE_KEEPER_CLIENT AND TARGET ch_rust::skim)
+        target_link_libraries(clickhouse-keeper PRIVATE ch_rust::skim)
+    endif()
+
     target_link_libraries(clickhouse-keeper
         PRIVATE
             ch_contrib::abseil_swiss_tables
diff --git a/programs/keeper/Keeper.cpp b/programs/keeper/Keeper.cpp
index 7633465c5e5..cc32b46c6e7 100644
--- a/programs/keeper/Keeper.cpp
+++ b/programs/keeper/Keeper.cpp
@@ -34,6 +34,8 @@
 #include "Core/Defines.h"
 #include "config.h"
 #include "config_version.h"
+#include "config_tools.h"
+
 
 #if USE_SSL
 #    include <Poco/Net/Context.h>
@@ -131,7 +133,10 @@ int Keeper::run()
     if (config().hasOption("help"))
     {
         Poco::Util::HelpFormatter help_formatter(Keeper::options());
-        auto header_str = fmt::format("{} [OPTION] [-- [ARG]...]\n"
+        auto header_str = fmt::format("{0} [OPTION] [-- [ARG]...]\n"
+#if ENABLE_CLICKHOUSE_KEEPER_CLIENT
+                                      "{0} client [OPTION]\n"
+#endif
                                       "positional arguments can be used to rewrite config.xml properties, for example, --http_port=8010",
                                       commandName());
         help_formatter.setHeader(header_str);
diff --git a/programs/keeper/clickhouse-keeper.cpp b/programs/keeper/clickhouse-keeper.cpp
index baa673f79ee..be2686d936b 100644
--- a/programs/keeper/clickhouse-keeper.cpp
+++ b/programs/keeper/clickhouse-keeper.cpp
@@ -1,6 +1,30 @@
+#include <Common/StringUtils/StringUtils.h>
+#include "config_tools.h"
+
+
 int mainEntryClickHouseKeeper(int argc, char ** argv);
 
+#if ENABLE_CLICKHOUSE_KEEPER_CLIENT
+int mainEntryClickHouseKeeperClient(int argc, char ** argv);
+#endif
+
 int main(int argc_, char ** argv_)
 {
+#if ENABLE_CLICKHOUSE_KEEPER_CLIENT
+
+    if (argc_ >= 2)
+    {
+        /// 'clickhouse-keeper --client ...' and 'clickhouse-keeper client ...' are OK
+        if (strcmp(argv_[1], "--client") == 0 || strcmp(argv_[1], "client") == 0)
+        {
+            argv_[1] = argv_[0];
+            return mainEntryClickHouseKeeperClient(--argc_, argv_ + 1);
+        }
+    }
+
+    if (argc_ > 0 && (strcmp(argv_[0], "clickhouse-keeper-client") == 0 || endsWith(argv_[0], "/clickhouse-keeper-client")))
+        return mainEntryClickHouseKeeperClient(argc_, argv_);
+#endif
+
     return mainEntryClickHouseKeeper(argc_, argv_);
 }

From 6cc4f76707b196b0f02938671f62c9bb3d267faa Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 15 Jun 2023 18:37:45 +0200
Subject: [PATCH 483/722] fix

---
 .../integration/test_merge_tree_load_parts/configs/compat.xml | 4 ++++
 tests/integration/test_merge_tree_load_parts/test.py          | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)
 create mode 100644 tests/integration/test_merge_tree_load_parts/configs/compat.xml

diff --git a/tests/integration/test_merge_tree_load_parts/configs/compat.xml b/tests/integration/test_merge_tree_load_parts/configs/compat.xml
new file mode 100644
index 00000000000..c919eaf6146
--- /dev/null
+++ b/tests/integration/test_merge_tree_load_parts/configs/compat.xml
@@ -0,0 +1,4 @@
+<clickhouse>
+    <replicated_merge_tree_paranoid_check_on_drop_range>0</replicated_merge_tree_paranoid_check_on_drop_range>
+    <replicated_merge_tree_paranoid_check_on_startup>0</replicated_merge_tree_paranoid_check_on_startup>
+</clickhouse>
\ No newline at end of file
diff --git a/tests/integration/test_merge_tree_load_parts/test.py b/tests/integration/test_merge_tree_load_parts/test.py
index 118c31ea864..968225887ad 100644
--- a/tests/integration/test_merge_tree_load_parts/test.py
+++ b/tests/integration/test_merge_tree_load_parts/test.py
@@ -9,7 +9,7 @@ cluster = helpers.cluster.ClickHouseCluster(__file__)
 
 node1 = cluster.add_instance(
     "node1",
-    main_configs=["configs/fast_background_pool.xml"],
+    main_configs=["configs/fast_background_pool.xml", "configs/compat.xml"],
     with_zookeeper=True,
     stay_alive=True,
 )

From f08fd758fa81b3b6c617f00fd16a6645055173ba Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Thu, 15 Jun 2023 18:45:10 +0200
Subject: [PATCH 484/722] Make multiple parallel list requests

---
 .../System/StorageSystemZooKeeper.cpp         | 144 +++++++++++-------
 1 file changed, 87 insertions(+), 57 deletions(-)

diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index cef2feedcc5..e5ea401f2eb 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -9,6 +9,7 @@
 #include <Parsers/ASTExpressionList.h>
 #include <Parsers/ASTFunction.h>
 #include <Interpreters/Context.h>
+#include <Interpreters/ProcessList.h>
 #include <Interpreters/evaluateConstantExpression.h>
 #include <Common/ZooKeeper/ZooKeeper.h>
 #include <Common/typeid_cast.h>
@@ -426,78 +427,107 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
                         "or path IN ('path1','path2'...) or path IN (subquery) "
                         "in WHERE clause unless `set allow_unrestricted_reads_from_keeper = 'true'`.");
 
+    const Int64 max_inflight_requests = std::max<Int64>(1, context->getSettingsRef().max_download_threads.value);
+
+    struct ListTask
+    {
+        String path;
+        ZkPathType path_type;
+        String prefix;
+        String path_corrected;
+        std::future<Coordination::ListResponse> future;
+    };
+    std::vector<ListTask> list_tasks;
     std::unordered_set<String> added;
     while (!paths.empty())
     {
-        auto [path, path_type] = std::move(paths.front());
-        paths.pop_front();
-
-        String prefix;
-        if (path_type == ZkPathType::Prefix)
+        list_tasks.clear();
+        while (!paths.empty() && static_cast<Int64>(list_tasks.size()) < max_inflight_requests)
         {
-            prefix = path;
-            size_t last_slash = prefix.rfind('/');
-            path = prefix.substr(0, last_slash == String::npos ? 0 : last_slash);
-        }
+            auto [path, path_type] = std::move(paths.front());
+            paths.pop_front();
 
-        String path_corrected = pathCorrected(path);
-
-        /// Node can be deleted concurrently. It's Ok, we don't provide any
-        /// consistency guarantees for system.zookeeper table.
-        zkutil::Strings nodes;
-        zookeeper->tryGetChildren(path_corrected, nodes);
-
-        String path_part = path_corrected;
-        if (path_part == "/")
-            path_part.clear();
-
-        if (!prefix.empty())
-        {
-            // Remove nodes that do not match specified prefix
-            std::erase_if(nodes, [&prefix, &path_part] (const String & node)
+            ListTask task;
+            task.path = path;
+            task.path_type = path_type;
+            if (path_type == ZkPathType::Prefix)
             {
-                return (path_part + '/' + node).substr(0, prefix.size()) != prefix;
-            });
+                task.prefix = path;
+                size_t last_slash = task.prefix.rfind('/');
+                path = task.prefix.substr(0, last_slash == String::npos ? 0 : last_slash);
+            }
+
+            task.path_corrected = pathCorrected(path);
+
+            task.future = zookeeper->asyncTryGetChildren(task.path_corrected);
+            list_tasks.emplace_back(std::move(task));
         }
 
-        std::vector<std::future<Coordination::GetResponse>> futures;
-        futures.reserve(nodes.size());
-        for (const String & node : nodes)
-            futures.push_back(zookeeper->asyncTryGet(path_part + '/' + node));
-
-        for (size_t i = 0, size = nodes.size(); i < size; ++i)
+        for (auto & task : list_tasks)
         {
-            auto res = futures[i].get();
-            if (res.error == Coordination::Error::ZNONODE)
-                continue; /// Node was deleted meanwhile.
+            context->getProcessListElement()->checkTimeLimit();
+            auto list_result = task.future.get();
 
-            // Deduplication
-            String key = path_part + '/' + nodes[i];
-            if (auto [it, inserted] = added.emplace(key); !inserted)
+            /// Node can be deleted concurrently. It's Ok, we don't provide any
+            /// consistency guarantees for system.zookeeper table.
+            if (list_result.error == Coordination::Error::ZNONODE)
                 continue;
 
-            const Coordination::Stat & stat = res.stat;
+            Strings nodes = std::move(list_result.names);
 
-            size_t col_num = 0;
-            res_columns[col_num++]->insert(nodes[i]);
-            res_columns[col_num++]->insert(res.data);
-            res_columns[col_num++]->insert(stat.czxid);
-            res_columns[col_num++]->insert(stat.mzxid);
-            res_columns[col_num++]->insert(UInt64(stat.ctime / 1000));
-            res_columns[col_num++]->insert(UInt64(stat.mtime / 1000));
-            res_columns[col_num++]->insert(stat.version);
-            res_columns[col_num++]->insert(stat.cversion);
-            res_columns[col_num++]->insert(stat.aversion);
-            res_columns[col_num++]->insert(stat.ephemeralOwner);
-            res_columns[col_num++]->insert(stat.dataLength);
-            res_columns[col_num++]->insert(stat.numChildren);
-            res_columns[col_num++]->insert(stat.pzxid);
-            res_columns[col_num++]->insert(
-                path); /// This is the original path. In order to process the request, condition in WHERE should be triggered.
+            String path_part = task.path_corrected;
+            if (path_part == "/")
+                path_part.clear();
 
-            if (path_type != ZkPathType::Exact && res.stat.numChildren > 0)
+            if (!task.prefix.empty())
             {
-                paths.emplace_back(key, ZkPathType::Recurse);
+                // Remove nodes that do not match specified prefix
+                std::erase_if(nodes, [&task, &path_part] (const String & node)
+                {
+                    return (path_part + '/' + node).substr(0, task.prefix.size()) != task.prefix;
+                });
+            }
+
+            std::vector<std::future<Coordination::GetResponse>> futures;
+            futures.reserve(nodes.size());
+            for (const String & node : nodes)
+                futures.push_back(zookeeper->asyncTryGet(path_part + '/' + node));
+
+            for (size_t i = 0, size = nodes.size(); i < size; ++i)
+            {
+                context->getProcessListElement()->checkTimeLimit();
+                auto res = futures[i].get();
+                if (res.error == Coordination::Error::ZNONODE)
+                    continue; /// Node was deleted meanwhile.
+
+                // Deduplication
+                String key = path_part + '/' + nodes[i];
+                if (auto [it, inserted] = added.emplace(key); !inserted)
+                    continue;
+
+                const Coordination::Stat & stat = res.stat;
+
+                size_t col_num = 0;
+                res_columns[col_num++]->insert(nodes[i]);
+                res_columns[col_num++]->insert(res.data);
+                res_columns[col_num++]->insert(stat.czxid);
+                res_columns[col_num++]->insert(stat.mzxid);
+                res_columns[col_num++]->insert(UInt64(stat.ctime / 1000));
+                res_columns[col_num++]->insert(UInt64(stat.mtime / 1000));
+                res_columns[col_num++]->insert(stat.version);
+                res_columns[col_num++]->insert(stat.cversion);
+                res_columns[col_num++]->insert(stat.aversion);
+                res_columns[col_num++]->insert(stat.ephemeralOwner);
+                res_columns[col_num++]->insert(stat.dataLength);
+                res_columns[col_num++]->insert(stat.numChildren);
+                res_columns[col_num++]->insert(stat.pzxid);
+                res_columns[col_num++]->insert(
+                    task.path); /// This is the original path. In order to process the request, condition in WHERE should be triggered.
+
+                if (task.path_type != ZkPathType::Exact && res.stat.numChildren > 0)
+                {
+                    paths.emplace_back(key, ZkPathType::Recurse);
+                }
             }
         }
     }

From 353b57f13ffb1d5e7388c387eb929723cbcf245c Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 15 Jun 2023 19:56:06 +0200
Subject: [PATCH 485/722] an optimiation for alters and replicated db

---
 src/Common/DNSResolver.cpp                    |  2 +-
 src/Databases/DatabaseReplicated.cpp          | 49 +++++++++++++--
 ...45_replicated_db_alter_partition.reference | 20 +++++++
 .../02445_replicated_db_alter_partition.sh    | 59 +++++++++++++++++++
 4 files changed, 123 insertions(+), 7 deletions(-)
 create mode 100644 tests/queries/0_stateless/02445_replicated_db_alter_partition.reference
 create mode 100755 tests/queries/0_stateless/02445_replicated_db_alter_partition.sh

diff --git a/src/Common/DNSResolver.cpp b/src/Common/DNSResolver.cpp
index b6a68bdfb45..a8ff347f399 100644
--- a/src/Common/DNSResolver.cpp
+++ b/src/Common/DNSResolver.cpp
@@ -104,7 +104,7 @@ DNSResolver::IPAddresses hostByName(const std::string & host)
     }
     catch (const Poco::Net::DNSException & e)
     {
-        LOG_ERROR(&Poco::Logger::get("DNSResolver"), "Cannot resolve host ({}), error {}: {}.", host, e.code(), e.name());
+        LOG_WARNING(&Poco::Logger::get("DNSResolver"), "Cannot resolve host ({}), error {}: {}.", host, e.code(), e.name());
         addresses.clear();
     }
 
diff --git a/src/Databases/DatabaseReplicated.cpp b/src/Databases/DatabaseReplicated.cpp
index 9bbf5b9565d..e8d515f1932 100644
--- a/src/Databases/DatabaseReplicated.cpp
+++ b/src/Databases/DatabaseReplicated.cpp
@@ -36,6 +36,7 @@
 #include <Parsers/ParserCreateQuery.h>
 #include <Parsers/queryToString.h>
 #include <Storages/StorageKeeperMap.h>
+#include <Storages/AlterCommands.h>
 
 namespace DB
 {
@@ -1441,9 +1442,49 @@ bool DatabaseReplicated::shouldReplicateQuery(const ContextPtr & query_context,
         return table->as<StorageKeeperMap>() != nullptr;
     };
 
+    const auto is_replicated_table = [&](const ASTPtr & ast)
+    {
+        auto table_id = query_context->resolveStorageID(ast, Context::ResolveOrdinary);
+        StoragePtr table = DatabaseCatalog::instance().getTable(table_id, query_context);
+
+        return table->supportsReplication();
+    };
+
+    const auto has_many_shards = [&]()
+    {
+        /// If there is only 1 shard then there is no need to replicate some queries.
+        auto current_cluster = tryGetCluster();
+        return
+            !current_cluster || /// Couldn't get the cluster, so we don't know how many shards there are.
+            current_cluster->getShardsInfo().size() > 1;
+    };
+
     /// Some ALTERs are not replicated on database level
     if (const auto * alter = query_ptr->as<const ASTAlterQuery>())
-        return !alter->isAttachAlter() && !alter->isFetchAlter() && !alter->isDropPartitionAlter() && !is_keeper_map_table(query_ptr);
+    {
+        if (alter->isAttachAlter() || alter->isFetchAlter() || alter->isDropPartitionAlter() || is_keeper_map_table(query_ptr))
+            return false;
+
+        if (has_many_shards() || !is_replicated_table(query_ptr))
+            return true;
+
+        try
+        {
+            /// Metadata alter should go through database
+            for (const auto & child : alter->command_list->children)
+                if (AlterCommand::parse(child->as<ASTAlterCommand>()))
+                    return true;
+
+            /// It's ALTER PARTITION or mutation, doesn't involve database
+            return false;
+        }
+        catch (...)
+        {
+            tryLogCurrentException(log);
+        }
+
+        return true;
+    }
 
     /// DROP DATABASE is not replicated
     if (const auto * drop = query_ptr->as<const ASTDropQuery>())
@@ -1459,11 +1500,7 @@ bool DatabaseReplicated::shouldReplicateQuery(const ContextPtr & query_context,
         if (is_keeper_map_table(query_ptr))
             return false;
 
-        /// If there is only 1 shard then there is no need to replicate DELETE query.
-        auto current_cluster = tryGetCluster();
-        return
-            !current_cluster || /// Couldn't get the cluster, so we don't know how many shards there are.
-            current_cluster->getShardsInfo().size() > 1;
+        return has_many_shards() || !is_replicated_table(query_ptr);
     }
 
     return true;
diff --git a/tests/queries/0_stateless/02445_replicated_db_alter_partition.reference b/tests/queries/0_stateless/02445_replicated_db_alter_partition.reference
new file mode 100644
index 00000000000..e95b2e817e2
--- /dev/null
+++ b/tests/queries/0_stateless/02445_replicated_db_alter_partition.reference
@@ -0,0 +1,20 @@
+not allowed to execute ALTERs of different types
+not allowed to execute ALTERs of different types
+not allowed to execute ALTERs of different types
+not allowed to execute ALTERs of different types
+TIMEOUT_EXCEEDED
+TIMEOUT_EXCEEDED
+TIMEOUT_EXCEEDED
+TIMEOUT_EXCEEDED
+not allowed to execute ALTERs of different types
+not allowed to execute ALTERs of different types
+not allowed to execute ALTERs of different types
+not allowed to execute ALTERs of different types
+TIMEOUT_EXCEEDED
+1	0
+1	2
+TIMEOUT_EXCEEDED
+2	0
+TIMEOUT_EXCEEDED
+3	0
+3	0
diff --git a/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh b/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
new file mode 100755
index 00000000000..092f8541b86
--- /dev/null
+++ b/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+db="rdb_$CLICKHOUSE_DATABASE"
+db2="${db}_2"
+db3="${db}_3"
+
+$CLICKHOUSE_CLIENT --allow_experimental_database_replicated=1 -q "create database $db engine=Replicated('/test/$CLICKHOUSE_DATABASE/rdb', 's1', 'r1')"
+
+$CLICKHOUSE_CLIENT -q "create table $db.mt (n int) engine=MergeTree order by tuple()"
+$CLICKHOUSE_CLIENT -q "create table $db.rmt (n int) engine=ReplicatedMergeTree order by tuple()"
+
+$CLICKHOUSE_CLIENT -q "insert into $db.rmt values (0), (1)"
+$CLICKHOUSE_CLIENT -q "insert into $db.mt values (0), (1)"
+
+$CLICKHOUSE_CLIENT --allow_experimental_database_replicated=1 -q "create database $db2 engine=Replicated('/test/$CLICKHOUSE_DATABASE/rdb', 's1', 'r2')"
+$CLICKHOUSE_CLIENT --allow_experimental_database_replicated=1 -q "create database $db3 engine=Replicated('/test/$CLICKHOUSE_DATABASE/rdb', 's2', 'r1')"
+
+$CLICKHOUSE_CLIENT -q "alter table $db.mt drop partition id 'all', add column m int" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+$CLICKHOUSE_CLIENT -q "alter table $db.rmt drop partition id 'all', add column m int" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+
+$CLICKHOUSE_CLIENT -q "alter table $db.mt drop partition id 'all', update n = 2 where 1" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+$CLICKHOUSE_CLIENT -q "alter table $db.rmt drop partition id 'all', update n = 2 where 1" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "delete from $db.mt where n=2" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "delete from $db.rmt where n=2" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "alter table $db.mt update n=2 where n=3" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "alter table $db.rmt update n=2 where n=3" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+
+$CLICKHOUSE_CLIENT -q "drop database $db3"
+# now there's only one shard
+
+$CLICKHOUSE_CLIENT -q "alter table $db.mt drop partition id 'all', add column m int" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+$CLICKHOUSE_CLIENT -q "alter table $db.rmt drop partition id 'all', add column m int" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+
+$CLICKHOUSE_CLIENT -q "alter table $db.mt drop partition id 'all', update n = 2 where 1" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+$CLICKHOUSE_CLIENT -q "alter table $db.rmt drop partition id 'all', update n = 2 where 1" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
+
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "alter table $db.mt update n=2 where n=1" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+$CLICKHOUSE_CLIENT -q "alter table $db.rmt update n=2 where n=1"
+
+$CLICKHOUSE_CLIENT -q "select 1, * from $db.rmt order by n"
+
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "delete from $db.mt where n=2" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "delete from $db.rmt where n=2"
+
+$CLICKHOUSE_CLIENT -q "select 2, * from $db.rmt order by n"
+
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "delete from $db.mt where n=2" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
+$CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "alter table $db.rmt attach partition id 'all' from $db.mt"
+
+$CLICKHOUSE_CLIENT -q "select 3, * from $db.rmt order by n"
+
+$CLICKHOUSE_CLIENT -q "drop database $db2"
+$CLICKHOUSE_CLIENT -q "drop database $db"

From baae6437ee494a0f08bd4e73b5a1369ed90484eb Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 15 Jun 2023 22:35:13 +0300
Subject: [PATCH 486/722] Update 02445_replicated_db_alter_partition.sh

---
 .../0_stateless/02445_replicated_db_alter_partition.sh        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh b/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
index 092f8541b86..349a2ecc925 100755
--- a/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
+++ b/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
@@ -10,8 +10,8 @@ db3="${db}_3"
 
 $CLICKHOUSE_CLIENT --allow_experimental_database_replicated=1 -q "create database $db engine=Replicated('/test/$CLICKHOUSE_DATABASE/rdb', 's1', 'r1')"
 
-$CLICKHOUSE_CLIENT -q "create table $db.mt (n int) engine=MergeTree order by tuple()"
-$CLICKHOUSE_CLIENT -q "create table $db.rmt (n int) engine=ReplicatedMergeTree order by tuple()"
+$CLICKHOUSE_CLIENT --distributed_ddl_output_mode=none -q "create table $db.mt (n int) engine=MergeTree order by tuple()"
+$CLICKHOUSE_CLIENT --distributed_ddl_output_mode=none -q "create table $db.rmt (n int) engine=ReplicatedMergeTree order by tuple()"
 
 $CLICKHOUSE_CLIENT -q "insert into $db.rmt values (0), (1)"
 $CLICKHOUSE_CLIENT -q "insert into $db.mt values (0), (1)"

From 59201ee3be3c1aaf0e79ed7ce036b2a9d10abef4 Mon Sep 17 00:00:00 2001
From: Rich Raposa <richraposa@gmail.com>
Date: Thu, 15 Jun 2023 15:26:44 -0600
Subject: [PATCH 487/722] Fix redis table function page for nav

---
 docs/en/sql-reference/table-functions/redis.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/en/sql-reference/table-functions/redis.md b/docs/en/sql-reference/table-functions/redis.md
index 5b32f118fb8..3efbe3520a7 100644
--- a/docs/en/sql-reference/table-functions/redis.md
+++ b/docs/en/sql-reference/table-functions/redis.md
@@ -1,10 +1,10 @@
 ---
 slug: /en/sql-reference/table-functions/redis
-sidebar_position: 10
-sidebar_label: Redis
+sidebar_position: 43
+sidebar_label: redis
 ---
 
-# Redis
+# redis
 
 This table function allows integrating ClickHouse with [Redis](https://redis.io/).
 

From 60ab05e86fbef9dbf89b8c1aaa49241b297f0be0 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 16 Jun 2023 00:28:09 +0200
Subject: [PATCH 488/722] Sqlancer has changed master to main

---
 docker/test/sqlancer/Dockerfile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docker/test/sqlancer/Dockerfile b/docker/test/sqlancer/Dockerfile
index a68b626eb66..7f79cdd6226 100644
--- a/docker/test/sqlancer/Dockerfile
+++ b/docker/test/sqlancer/Dockerfile
@@ -12,9 +12,9 @@ RUN apt-get update --yes && \
 # We need to get the repository's HEAD each time despite, so we invalidate layers' cache
 ARG CACHE_INVALIDATOR=0
 RUN mkdir /sqlancer && \
-	wget -q -O- https://github.com/sqlancer/sqlancer/archive/master.tar.gz | \
+	wget -q -O- https://github.com/sqlancer/sqlancer/archive/main.tar.gz | \
 		tar zx -C /sqlancer && \
-	cd /sqlancer/sqlancer-master && \
+	cd /sqlancer/sqlancer-main && \
 	mvn package -DskipTests && \
 	rm -r /root/.m2
 

From 5d4a3ac0c6c70828d89f3c91a8d87f8bc5842c7e Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 16 Jun 2023 00:44:42 +0200
Subject: [PATCH 489/722] Do not spam sqlancer build log

---
 docker/test/sqlancer/Dockerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docker/test/sqlancer/Dockerfile b/docker/test/sqlancer/Dockerfile
index 7f79cdd6226..5977044345e 100644
--- a/docker/test/sqlancer/Dockerfile
+++ b/docker/test/sqlancer/Dockerfile
@@ -15,7 +15,7 @@ RUN mkdir /sqlancer && \
 	wget -q -O- https://github.com/sqlancer/sqlancer/archive/main.tar.gz | \
 		tar zx -C /sqlancer && \
 	cd /sqlancer/sqlancer-main && \
-	mvn package -DskipTests && \
+	mvn --no-transfer-progress package -DskipTests && \
 	rm -r /root/.m2
 
 COPY run.sh /

From e60506f41bbe699ac7572d9b5868ca49dd5288ed Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 16 Jun 2023 02:16:04 +0200
Subject: [PATCH 490/722] changes requested in review

---
 docs/en/operations/settings/settings.md       | 28 +++++++++++--------
 .../functions/date-time-functions.md          | 12 ++++----
 docs/ru/operations/settings/settings.md       |  7 +++--
 .../functions/date-time-functions.md          |  2 +-
 programs/client/Client.cpp                    |  2 +-
 src/Common/DateLUT.cpp                        |  2 +-
 src/Common/DateLUT.h                          | 16 +++++------
 src/Common/ThreadStatus.h                     |  3 +-
 src/Core/SettingsFields.h                     |  9 ------
 src/Functions/serverConstants.cpp             |  5 ++--
 .../0_stateless/02737_timezone_setting.sql    |  5 ++--
 11 files changed, 45 insertions(+), 46 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 1bd6e44154e..6aebff8101d 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4205,9 +4205,18 @@ Use this setting only for backward compatibility if your use cases depend on old
 
 ## session_timezone {#session_timezone}
 
-If specified, sets an implicit timezone (instead of [server default](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
-All DateTime/DateTime64 values (and/or functions results) that have no explicit timezone specified are treated as having this timezone instead of default.
-A value of `''` (empty string) configures the session timezone to the server default timezone.
+Sets the implicit time zone of the current session or query.
+The implicit time zone is the time zone applied to values of type DateTime/DateTime64 which have no explicitly specified time zone. 
+The setting takes precedence over the globally configured (server-level) implicit time zone.
+A value of '' (empty string) means that the implicit time zone of session or query is equal to the [server default time zone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
+
+You can use functions `timeZone()` and `serverTimezone()` to get the session default and server time zones respectively.
+
+Possible values:
+
+-    Any timezone name from `system.time_zones`, e.g. `Europe/Berlin`, `UTC` or `Zulu`
+
+Default value: `''`.
 
 Examples:
 
@@ -4223,6 +4232,7 @@ SELECT timeZone(), serverTimezone() SETTINGS session_timezone = 'Asia/Novosibirs
 Asia/Novosibirsk	Europe/Berlin
 ```
 
+Assign session time zone 'America/Denver' to the inner DateTime without explicitly specified time zone:
 ```sql
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
 
@@ -4230,7 +4240,8 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 ```
 
 :::warning
-The way this setting affects parsing of Date or DateTime types may seem non-obvious, see example and explanation below:
+Not all functions that parse DateTime/DateTime64 respect `session_timezone`. This can lead to subtle errors. 
+See the following example and explanation.
 :::
 
 ```sql
@@ -4246,14 +4257,9 @@ SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS sessi
 ```
 
 This happens due to different parsing pipelines:
-  - `toDateTime('2000-01-01 00:00:00')` creates a new DateTime in a usual way, and thus `session_timezone` setting from query context is applied.
-  - `2000-01-01 00:00:00` is parsed to a DateTime inheriting type of `d` column, including its time zone, and `session_timezone` has no impact on this value.
 
-Possible values:
-
--    Any timezone name from `system.time_zones`, e.g. `Europe/Berlin`, `UTC` or `Zulu`
-
-Default value: `''`.
+- `toDateTime()` without explicitly given timezone used in the first `SELECT` query honors setting `session_timezone` and the global timezone.
+- In the second query, a DateTime is parsed from a String, and inherits the type and time zone of the existing column`d`. Thus, setting `session_timezone` and the global timezone are not honored.
 
 **See also**
 
diff --git a/docs/en/sql-reference/functions/date-time-functions.md b/docs/en/sql-reference/functions/date-time-functions.md
index 62bbb84053a..3f61e7a214d 100644
--- a/docs/en/sql-reference/functions/date-time-functions.md
+++ b/docs/en/sql-reference/functions/date-time-functions.md
@@ -139,7 +139,7 @@ makeDateTime32(year, month, day, hour, minute, second[, fraction[, precision[, t
 
 ## timeZone
 
-Returns the default timezone of the current session, i.e. the value of setting [session_timezone](../../operations/settings/settings.md#session_timezone).
+Returns the timezone of the current session, i.e. the value of setting [session_timezone](../../operations/settings/settings.md#session_timezone).
 If the function is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard, otherwise it produces a constant value.
 
 **Syntax**
@@ -158,12 +158,12 @@ Type: [String](../../sql-reference/data-types/string.md).
 
 **See also**
 
-- [serverTimezone](#serverTimeZone)
+- [serverTimeZone](#serverTimeZone)
 
-## serverTimezone
+## serverTimeZone
 
-Returns the default timezone of the server, i.e. the value of setting [timezone](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
-If it is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise, it produces a constant value.
+Returns the timezone of the server, i.e. the value of setting [timezone](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
+If the function is executed in the context of a distributed table, then it generates a normal column with values relevant to each shard. Otherwise, it produces a constant value.
 
 **Syntax**
 
@@ -171,6 +171,8 @@ If it is executed in the context of a distributed table, then it generates a nor
 serverTimeZone()
 ```
 
+Alias: `serverTimezone`.
+
 **Returned value**
 
 -   Timezone.
diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 510a7bc837c..09e8eb25fe1 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4158,7 +4158,8 @@ SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 Значение по умолчанию: `''`.
 
 :::warning
-То, как этот параметр влияет на парсинг значений типа Date или DateTime, может показаться неочевидным. Пример и пояснение см. ниже:
+Иногда при формировании значений типа `DateTime` и `DateTime64` параметр  `session_timezone` может быть проигнорирован.
+Это может привести к путанице. Пример и пояснение см. ниже.
 :::
 
 ```sql
@@ -4174,8 +4175,8 @@ SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS sessi
 ```
 
 Это происходит из-за различного происхождения значения, используемого для сравнения:
-- `toDateTime('2000-01-01 00:00:00')` создаёт значение типа `DateTime` как и в любом другом случае, в том числе применяет параметр `session_timezone` из контекста запроса,
-- `2000-01-01 00:00:00` парсится в `DateTime` того же типа, что и колонка `d` (в том числе с той же `timezone`), и параметр `session_timezone` в данном случае не учитывается.
+- В первом запросе функция `toDateTime()`, создавая значение типа `DateTime`, принимает во внимание параметр `session_timezone` из контекста запроса;
+- Во втором запросе `DateTime` формируется из строки неявно, наследуя тип колонки `d` (в том числе и числовой пояс), и параметр `session_timezone` игнорируется.
 
 **Смотрите также**
 
diff --git a/docs/ru/sql-reference/functions/date-time-functions.md b/docs/ru/sql-reference/functions/date-time-functions.md
index 1ae368d71fc..17ab04b7799 100644
--- a/docs/ru/sql-reference/functions/date-time-functions.md
+++ b/docs/ru/sql-reference/functions/date-time-functions.md
@@ -59,7 +59,7 @@ timeZone()
 serverTimeZone()
 ```
 
-Синонимы: `servertimezone`, `serverTimezone`.
+Синонимы: `serverTimezone`.
 
 **Возвращаемое значение**
 
diff --git a/programs/client/Client.cpp b/programs/client/Client.cpp
index 9b670c105b6..97ade0ad28b 100644
--- a/programs/client/Client.cpp
+++ b/programs/client/Client.cpp
@@ -326,7 +326,7 @@ try
         // All that just to set DB::CurrentThread::get().getGlobalContext()
         // which is required for client timezone (pushed from server) to work.
         auto thread_group = std::make_shared<ThreadGroup>();
-        thread_group->global_context = global_context;
+        const_cast<ContextWeakPtr&>(thread_group->global_context) = global_context;
         thread_status.attachToGroup(thread_group, false);
     }
 
diff --git a/src/Common/DateLUT.cpp b/src/Common/DateLUT.cpp
index f7e7df016cb..2b261a28469 100644
--- a/src/Common/DateLUT.cpp
+++ b/src/Common/DateLUT.cpp
@@ -165,7 +165,7 @@ DateLUT & DateLUT::getInstance()
     return ret;
 }
 
-std::string DateLUT::extractTimezoneFromContext(const DB::ContextPtr query_context)
+std::string DateLUT::extractTimezoneFromContext(DB::ContextPtr query_context)
 {
     return query_context->getSettingsRef().session_timezone.value;
 }
diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index 833b2291254..d17cbef80ee 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -26,15 +26,15 @@ public:
 
         if (DB::CurrentThread::isInitialized())
         {
-            std::string context_timezone;
+            std::string timezone_from_context;
             const DB::ContextPtr query_context = DB::CurrentThread::get().getQueryContext();
 
             if (query_context)
             {
-                context_timezone = extractTimezoneFromContext(query_context);
+                timezone_from_context = extractTimezoneFromContext(query_context);
 
-                if (!context_timezone.empty())
-                    return date_lut.getImplementation(context_timezone);
+                if (!timezone_from_context.empty())
+                    return date_lut.getImplementation(timezone_from_context);
             }
 
             /// Timezone is passed in query_context, but on CH-Client we have no query context,
@@ -42,14 +42,14 @@ public:
             const DB::ContextPtr global_context = DB::CurrentThread::get().getGlobalContext();
             if (global_context)
             {
-                context_timezone = extractTimezoneFromContext(global_context);
+                timezone_from_context = extractTimezoneFromContext(global_context);
 
-                if (!context_timezone.empty())
-                    return date_lut.getImplementation(context_timezone);
+                if (!timezone_from_context.empty())
+                    return date_lut.getImplementation(timezone_from_context);
             }
 
         }
-        return *date_lut.default_impl.load(std::memory_order_acquire);
+        return serverTimezoneInstance();
     }
 
     static ALWAYS_INLINE const DateLUTImpl & instance(const std::string & time_zone)
diff --git a/src/Common/ThreadStatus.h b/src/Common/ThreadStatus.h
index 54849db8e95..061959d9f1f 100644
--- a/src/Common/ThreadStatus.h
+++ b/src/Common/ThreadStatus.h
@@ -71,8 +71,7 @@ public:
 
     /// Set up at creation, no race when reading
     const ContextWeakPtr query_context;
-    /// Cannot make it const -- we need to modify it in ch-client to process timezone from server
-    ContextWeakPtr global_context;
+    const ContextWeakPtr global_context;
 
     const FatalErrorCallback fatal_error_callback;
 
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 8bd7370c980..ac7c9740143 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -552,15 +552,12 @@ struct SettingFieldTimezone
     String value;
     bool changed = false;
 
-//    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
     explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const String & str) { validateTimezone(str); value = str; }
-//    explicit SettingFieldTimezone(String && str) { validateTimezone(std::string(str)); value = std::move(str); }
     explicit SettingFieldTimezone(String && str) { validateTimezone(str); value = std::move(str); }
     explicit SettingFieldTimezone(const char * str) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const Field & f) { const String & str = f.safeGet<const String &>(); validateTimezone(str); value = str; }
 
-//    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
     SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(str); value = str; changed = true; return *this; }
     SettingFieldTimezone & operator =(const String & str) { *this = std::string_view{str}; return *this; }
     SettingFieldTimezone & operator =(String && str) { validateTimezone(str); value = std::move(str); changed = true; return *this; }
@@ -577,12 +574,6 @@ struct SettingFieldTimezone
     void readBinary(ReadBuffer & in);
 
 private:
-//    cctz::time_zone validated_tz;
-//    void validateTimezone(const std::string & str)
-//    {
-//        if (!str.empty() && !cctz::load_time_zone(str, &validated_tz))
-//            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
-//    }
     static void validateTimezone(std::string_view str);
 };
 
diff --git a/src/Functions/serverConstants.cpp b/src/Functions/serverConstants.cpp
index d3e1e6e10fe..0fda53414de 100644
--- a/src/Functions/serverConstants.cpp
+++ b/src/Functions/serverConstants.cpp
@@ -66,7 +66,7 @@ namespace
     public:
         static constexpr auto name = "timezone";
         static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionTimezone>(context); }
-        explicit FunctionTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::instance().getTimeZone()}, context->isDistributed()) {}
+        explicit FunctionTimezone(ContextPtr context) : FunctionConstantBase(DateLUT::instance().getTimeZone(), context->isDistributed()) {}
     };
 
     /// Returns the server time zone (timezone in which server runs).
@@ -75,7 +75,7 @@ namespace
     public:
         static constexpr auto name = "serverTimezone";
         static FunctionPtr create(ContextPtr context) { return std::make_shared<FunctionServerTimezone>(context); }
-        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(String{DateLUT::serverTimezoneInstance().getTimeZone()}, context->isDistributed()) {}
+        explicit FunctionServerTimezone(ContextPtr context) : FunctionConstantBase(DateLUT::serverTimezoneInstance().getTimeZone(), context->isDistributed()) {}
     };
 
 
@@ -187,6 +187,7 @@ Returns the timezone name in which server operates.
      .examples{{"serverTimezone", "SELECT serverTimezone();", ""}},
      .categories{"Constant", "Miscellaneous"}
 });
+    factory.registerAlias("serverTimeZone", "serverTimezone");
 }
 
 REGISTER_FUNCTION(Uptime)
diff --git a/tests/queries/0_stateless/02737_timezone_setting.sql b/tests/queries/0_stateless/02737_timezone_setting.sql
index 87eeec0779b..a345e596193 100644
--- a/tests/queries/0_stateless/02737_timezone_setting.sql
+++ b/tests/queries/0_stateless/02737_timezone_setting.sql
@@ -10,11 +10,10 @@ SELECT toDateTime(toDateTime('2022-12-12 23:23:23'), 'Europe/Zurich');
 SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver';
 
 -- test proper serialization
-SELECT toDateTime('2002-12-12 23:23:23'), toString(toDateTime('2002-12-12 23:23:23')) SETTINGS session_timezone = 'Asia/Phnom_Penh';
-SELECT toDateTime64('2002-12-12 23:23:23.123', 3), toString(toDateTime64('2002-12-12 23:23:23.123', 3)) SETTINGS session_timezone = 'Asia/Phnom_Penh';
+SELECT toDateTime('2002-12-12 23:23:23') AS dt, toString(dt) SETTINGS session_timezone = 'Asia/Phnom_Penh';
+SELECT toDateTime64('2002-12-12 23:23:23.123', 3)as dt64, toString(dt64) SETTINGS session_timezone = 'Asia/Phnom_Penh';
 
 -- Create a table and test that DateTimes are processed correctly on insert
-SET session_timezone='Asia/Novosibirsk';
 CREATE TABLE test_tz_setting (d DateTime('UTC')) Engine=Memory AS SELECT toDateTime('2000-01-01 00:00:00');
 INSERT INTO test_tz_setting VALUES ('2000-01-01 01:00:00'); -- this is parsed using timezone from `d` column
 INSERT INTO test_tz_setting VALUES (toDateTime('2000-01-02 02:00:00')); -- this is parsed using `session_timezone`

From 24e2bae7bd3457bcdd404dde6e3f95a29fcdaed6 Mon Sep 17 00:00:00 2001
From: Val Doroshchuk <valbok@gmail.com>
Date: Fri, 16 Jun 2023 09:41:12 +0200
Subject: [PATCH 491/722] MaterializedMySQL: Rename materialize_with_ddl.py ->
 materialized_with_ddl.py

Make it more consistent to current names.
Keep some tests with `ENGINE = MaterializeMySQL` to test BC.
---
 ...e_with_ddl.py => materialized_with_ddl.py} |  80 ++++-----
 .../test_materialized_mysql_database/test.py  | 154 +++++++++---------
 2 files changed, 117 insertions(+), 117 deletions(-)
 rename tests/integration/test_materialized_mysql_database/{materialize_with_ddl.py => materialized_with_ddl.py} (96%)

diff --git a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py b/tests/integration/test_materialized_mysql_database/materialized_with_ddl.py
similarity index 96%
rename from tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
rename to tests/integration/test_materialized_mysql_database/materialized_with_ddl.py
index 327d94c03a2..8cf9e67bf63 100644
--- a/tests/integration/test_materialized_mysql_database/materialize_with_ddl.py
+++ b/tests/integration/test_materialized_mysql_database/materialized_with_ddl.py
@@ -423,7 +423,7 @@ def drop_table_with_materialized_mysql_database(
     mysql_node.query("DROP DATABASE test_database_drop")
 
 
-def create_table_like_with_materialize_mysql_database(
+def create_table_like_with_materialized_mysql_database(
     clickhouse_node, mysql_node, service_name
 ):
     mysql_node.query("DROP DATABASE IF EXISTS create_like")
@@ -1578,49 +1578,49 @@ def system_tables_test(clickhouse_node, mysql_node, service_name):
     mysql_node.query("DROP DATABASE system_tables_test")
 
 
-def materialize_with_column_comments_test(clickhouse_node, mysql_node, service_name):
-    mysql_node.query("DROP DATABASE IF EXISTS materialize_with_column_comments_test")
+def materialized_with_column_comments_test(clickhouse_node, mysql_node, service_name):
+    mysql_node.query("DROP DATABASE IF EXISTS materialized_with_column_comments_test")
     clickhouse_node.query(
-        "DROP DATABASE IF EXISTS materialize_with_column_comments_test"
+        "DROP DATABASE IF EXISTS materialized_with_column_comments_test"
     )
-    mysql_node.query("CREATE DATABASE materialize_with_column_comments_test")
+    mysql_node.query("CREATE DATABASE materialized_with_column_comments_test")
     mysql_node.query(
-        "CREATE TABLE materialize_with_column_comments_test.test (id int NOT NULL PRIMARY KEY, value VARCHAR(255) COMMENT 'test comment') ENGINE=InnoDB"
+        "CREATE TABLE materialized_with_column_comments_test.test (id int NOT NULL PRIMARY KEY, value VARCHAR(255) COMMENT 'test comment') ENGINE=InnoDB"
     )
     clickhouse_node.query(
-        "CREATE DATABASE materialize_with_column_comments_test ENGINE = MaterializedMySQL('{}:3306', 'materialize_with_column_comments_test', 'root', 'clickhouse')".format(
+        "CREATE DATABASE materialized_with_column_comments_test ENGINE = MaterializedMySQL('{}:3306', 'materialized_with_column_comments_test', 'root', 'clickhouse')".format(
             service_name
         )
     )
     check_query(
         clickhouse_node,
-        "DESCRIBE TABLE materialize_with_column_comments_test.test",
+        "DESCRIBE TABLE materialized_with_column_comments_test.test",
         "id\tInt32\t\t\t\t\t\nvalue\tNullable(String)\t\t\ttest comment\t\t\n_sign\tInt8\tMATERIALIZED\t1\t\t\t\n_version\tUInt64\tMATERIALIZED\t1\t\t\t\n",
     )
     mysql_node.query(
-        "ALTER TABLE materialize_with_column_comments_test.test MODIFY value VARCHAR(255) COMMENT 'comment test'"
+        "ALTER TABLE materialized_with_column_comments_test.test MODIFY value VARCHAR(255) COMMENT 'comment test'"
     )
     check_query(
         clickhouse_node,
-        "DESCRIBE TABLE materialize_with_column_comments_test.test",
+        "DESCRIBE TABLE materialized_with_column_comments_test.test",
         "id\tInt32\t\t\t\t\t\nvalue\tNullable(String)\t\t\tcomment test\t\t\n_sign\tInt8\tMATERIALIZED\t1\t\t\t\n_version\tUInt64\tMATERIALIZED\t1\t\t\t\n",
     )
     mysql_node.query(
-        "ALTER TABLE materialize_with_column_comments_test.test ADD value2 int COMMENT 'test comment 2'"
+        "ALTER TABLE materialized_with_column_comments_test.test ADD value2 int COMMENT 'test comment 2'"
     )
     check_query(
         clickhouse_node,
-        "DESCRIBE TABLE materialize_with_column_comments_test.test",
+        "DESCRIBE TABLE materialized_with_column_comments_test.test",
         "id\tInt32\t\t\t\t\t\nvalue\tNullable(String)\t\t\tcomment test\t\t\nvalue2\tNullable(Int32)\t\t\ttest comment 2\t\t\n_sign\tInt8\tMATERIALIZED\t1\t\t\t\n_version\tUInt64\tMATERIALIZED\t1\t\t\t\n",
     )
-    clickhouse_node.query("DROP DATABASE materialize_with_column_comments_test")
-    mysql_node.query("DROP DATABASE materialize_with_column_comments_test")
+    clickhouse_node.query("DROP DATABASE materialized_with_column_comments_test")
+    mysql_node.query("DROP DATABASE materialized_with_column_comments_test")
 
 
-def materialize_with_enum8_test(clickhouse_node, mysql_node, service_name):
-    mysql_node.query("DROP DATABASE IF EXISTS materialize_with_enum8_test")
-    clickhouse_node.query("DROP DATABASE IF EXISTS materialize_with_enum8_test")
-    mysql_node.query("CREATE DATABASE materialize_with_enum8_test")
+def materialized_with_enum8_test(clickhouse_node, mysql_node, service_name):
+    mysql_node.query("DROP DATABASE IF EXISTS materialized_with_enum8_test")
+    clickhouse_node.query("DROP DATABASE IF EXISTS materialized_with_enum8_test")
+    mysql_node.query("CREATE DATABASE materialized_with_enum8_test")
     enum8_values_count = 127
     enum8_values = ""
     enum8_values_with_backslash = ""
@@ -1632,46 +1632,46 @@ def materialize_with_enum8_test(clickhouse_node, mysql_node, service_name):
         "\\'" + str(enum8_values_count) + "\\' = " + str(enum8_values_count)
     )
     mysql_node.query(
-        "CREATE TABLE materialize_with_enum8_test.test (id int NOT NULL PRIMARY KEY, value ENUM("
+        "CREATE TABLE materialized_with_enum8_test.test (id int NOT NULL PRIMARY KEY, value ENUM("
         + enum8_values
         + ")) ENGINE=InnoDB"
     )
     mysql_node.query(
-        "INSERT INTO materialize_with_enum8_test.test (id, value) VALUES (1, '1'),(2, '2')"
+        "INSERT INTO materialized_with_enum8_test.test (id, value) VALUES (1, '1'),(2, '2')"
     )
     clickhouse_node.query(
-        "CREATE DATABASE materialize_with_enum8_test ENGINE = MaterializedMySQL('{}:3306', 'materialize_with_enum8_test', 'root', 'clickhouse')".format(
+        "CREATE DATABASE materialized_with_enum8_test ENGINE = MaterializedMySQL('{}:3306', 'materialized_with_enum8_test', 'root', 'clickhouse')".format(
             service_name
         )
     )
     check_query(
         clickhouse_node,
-        "SELECT value FROM materialize_with_enum8_test.test ORDER BY id",
+        "SELECT value FROM materialized_with_enum8_test.test ORDER BY id",
         "1\n2\n",
     )
     mysql_node.query(
-        "INSERT INTO materialize_with_enum8_test.test (id, value) VALUES (3, '127')"
+        "INSERT INTO materialized_with_enum8_test.test (id, value) VALUES (3, '127')"
     )
     check_query(
         clickhouse_node,
-        "SELECT value FROM materialize_with_enum8_test.test ORDER BY id",
+        "SELECT value FROM materialized_with_enum8_test.test ORDER BY id",
         "1\n2\n127\n",
     )
     check_query(
         clickhouse_node,
-        "DESCRIBE TABLE materialize_with_enum8_test.test",
+        "DESCRIBE TABLE materialized_with_enum8_test.test",
         "id\tInt32\t\t\t\t\t\nvalue\tNullable(Enum8("
         + enum8_values_with_backslash
         + "))\t\t\t\t\t\n_sign\tInt8\tMATERIALIZED\t1\t\t\t\n_version\tUInt64\tMATERIALIZED\t1\t\t\t\n",
     )
-    clickhouse_node.query("DROP DATABASE materialize_with_enum8_test")
-    mysql_node.query("DROP DATABASE materialize_with_enum8_test")
+    clickhouse_node.query("DROP DATABASE materialized_with_enum8_test")
+    mysql_node.query("DROP DATABASE materialized_with_enum8_test")
 
 
-def materialize_with_enum16_test(clickhouse_node, mysql_node, service_name):
-    mysql_node.query("DROP DATABASE IF EXISTS materialize_with_enum16_test")
-    clickhouse_node.query("DROP DATABASE IF EXISTS materialize_with_enum16_test")
-    mysql_node.query("CREATE DATABASE materialize_with_enum16_test")
+def materialized_with_enum16_test(clickhouse_node, mysql_node, service_name):
+    mysql_node.query("DROP DATABASE IF EXISTS materialized_with_enum16_test")
+    clickhouse_node.query("DROP DATABASE IF EXISTS materialized_with_enum16_test")
+    mysql_node.query("CREATE DATABASE materialized_with_enum16_test")
     enum16_values_count = 600
     enum16_values = ""
     enum16_values_with_backslash = ""
@@ -1683,40 +1683,40 @@ def materialize_with_enum16_test(clickhouse_node, mysql_node, service_name):
         "\\'" + str(enum16_values_count) + "\\' = " + str(enum16_values_count)
     )
     mysql_node.query(
-        "CREATE TABLE materialize_with_enum16_test.test (id int NOT NULL PRIMARY KEY, value ENUM("
+        "CREATE TABLE materialized_with_enum16_test.test (id int NOT NULL PRIMARY KEY, value ENUM("
         + enum16_values
         + ")) ENGINE=InnoDB"
     )
     mysql_node.query(
-        "INSERT INTO materialize_with_enum16_test.test (id, value) VALUES (1, '1'),(2, '2')"
+        "INSERT INTO materialized_with_enum16_test.test (id, value) VALUES (1, '1'),(2, '2')"
     )
     clickhouse_node.query(
-        "CREATE DATABASE materialize_with_enum16_test ENGINE = MaterializedMySQL('{}:3306', 'materialize_with_enum16_test', 'root', 'clickhouse')".format(
+        "CREATE DATABASE materialized_with_enum16_test ENGINE = MaterializedMySQL('{}:3306', 'materialized_with_enum16_test', 'root', 'clickhouse')".format(
             service_name
         )
     )
     check_query(
         clickhouse_node,
-        "SELECT value FROM materialize_with_enum16_test.test ORDER BY id",
+        "SELECT value FROM materialized_with_enum16_test.test ORDER BY id",
         "1\n2\n",
     )
     mysql_node.query(
-        "INSERT INTO materialize_with_enum16_test.test (id, value) VALUES (3, '500')"
+        "INSERT INTO materialized_with_enum16_test.test (id, value) VALUES (3, '500')"
     )
     check_query(
         clickhouse_node,
-        "SELECT value FROM materialize_with_enum16_test.test ORDER BY id",
+        "SELECT value FROM materialized_with_enum16_test.test ORDER BY id",
         "1\n2\n500\n",
     )
     check_query(
         clickhouse_node,
-        "DESCRIBE TABLE materialize_with_enum16_test.test",
+        "DESCRIBE TABLE materialized_with_enum16_test.test",
         "id\tInt32\t\t\t\t\t\nvalue\tNullable(Enum16("
         + enum16_values_with_backslash
         + "))\t\t\t\t\t\n_sign\tInt8\tMATERIALIZED\t1\t\t\t\n_version\tUInt64\tMATERIALIZED\t1\t\t\t\n",
     )
-    clickhouse_node.query("DROP DATABASE materialize_with_enum16_test")
-    mysql_node.query("DROP DATABASE materialize_with_enum16_test")
+    clickhouse_node.query("DROP DATABASE materialized_with_enum16_test")
+    mysql_node.query("DROP DATABASE materialized_with_enum16_test")
 
 
 def alter_enum8_to_enum16_test(clickhouse_node, mysql_node, service_name):
diff --git a/tests/integration/test_materialized_mysql_database/test.py b/tests/integration/test_materialized_mysql_database/test.py
index 5272fb2ff8c..21316d1a474 100644
--- a/tests/integration/test_materialized_mysql_database/test.py
+++ b/tests/integration/test_materialized_mysql_database/test.py
@@ -14,7 +14,7 @@ from helpers.cluster import (
 import docker
 import logging
 
-from . import materialize_with_ddl
+from . import materialized_with_ddl
 
 DOCKER_COMPOSE_PATH = get_docker_compose_path()
 
@@ -152,16 +152,16 @@ def clickhouse_node():
 def test_materialized_database_dml_with_mysql_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node: ClickHouseInstance
 ):
-    materialize_with_ddl.dml_with_materialized_mysql_database(
+    materialized_with_ddl.dml_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.materialized_mysql_database_with_views(
+    materialized_with_ddl.materialized_mysql_database_with_views(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.materialized_mysql_database_with_datetime_and_decimal(
+    materialized_with_ddl.materialized_mysql_database_with_datetime_and_decimal(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.move_to_prewhere_and_column_filtering(
+    materialized_with_ddl.move_to_prewhere_and_column_filtering(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -169,16 +169,16 @@ def test_materialized_database_dml_with_mysql_5_7(
 def test_materialized_database_dml_with_mysql_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.dml_with_materialized_mysql_database(
+    materialized_with_ddl.dml_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialized_mysql_database_with_views(
+    materialized_with_ddl.materialized_mysql_database_with_views(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialized_mysql_database_with_datetime_and_decimal(
+    materialized_with_ddl.materialized_mysql_database_with_datetime_and_decimal(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.move_to_prewhere_and_column_filtering(
+    materialized_with_ddl.move_to_prewhere_and_column_filtering(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -186,30 +186,30 @@ def test_materialized_database_dml_with_mysql_8_0(
 def test_materialized_database_ddl_with_mysql_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.drop_table_with_materialized_mysql_database(
+    materialized_with_ddl.drop_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.create_table_with_materialized_mysql_database(
+    materialized_with_ddl.create_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.rename_table_with_materialized_mysql_database(
+    materialized_with_ddl.rename_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.alter_add_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_add_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.alter_drop_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_drop_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
     # mysql 5.7 cannot support alter rename column
-    # materialize_with_ddl.alter_rename_column_with_materialized_mysql_database(clickhouse_node, started_mysql_5_7, "mysql57")
-    materialize_with_ddl.alter_rename_table_with_materialized_mysql_database(
+    # materialized_with_ddl.alter_rename_column_with_materialized_mysql_database(clickhouse_node, started_mysql_5_7, "mysql57")
+    materialized_with_ddl.alter_rename_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.alter_modify_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_modify_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.create_table_like_with_materialize_mysql_database(
+    materialized_with_ddl.create_table_like_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -217,31 +217,31 @@ def test_materialized_database_ddl_with_mysql_5_7(
 def test_materialized_database_ddl_with_mysql_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.drop_table_with_materialized_mysql_database(
+    materialized_with_ddl.drop_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.create_table_with_materialized_mysql_database(
+    materialized_with_ddl.create_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.rename_table_with_materialized_mysql_database(
+    materialized_with_ddl.rename_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.alter_add_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_add_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.alter_drop_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_drop_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.alter_rename_table_with_materialized_mysql_database(
+    materialized_with_ddl.alter_rename_table_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.alter_rename_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_rename_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.alter_modify_column_with_materialized_mysql_database(
+    materialized_with_ddl.alter_modify_column_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.create_table_like_with_materialize_mysql_database(
+    materialized_with_ddl.create_table_like_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -249,7 +249,7 @@ def test_materialized_database_ddl_with_mysql_8_0(
 def test_materialized_database_ddl_with_empty_transaction_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.query_event_with_empty_transaction(
+    materialized_with_ddl.query_event_with_empty_transaction(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -257,7 +257,7 @@ def test_materialized_database_ddl_with_empty_transaction_5_7(
 def test_materialized_database_ddl_with_empty_transaction_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.query_event_with_empty_transaction(
+    materialized_with_ddl.query_event_with_empty_transaction(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -265,7 +265,7 @@ def test_materialized_database_ddl_with_empty_transaction_8_0(
 def test_select_without_columns_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.select_without_columns(
+    materialized_with_ddl.select_without_columns(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -273,7 +273,7 @@ def test_select_without_columns_5_7(
 def test_select_without_columns_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.select_without_columns(
+    materialized_with_ddl.select_without_columns(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -281,7 +281,7 @@ def test_select_without_columns_8_0(
 def test_insert_with_modify_binlog_checksum_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.insert_with_modify_binlog_checksum(
+    materialized_with_ddl.insert_with_modify_binlog_checksum(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -289,7 +289,7 @@ def test_insert_with_modify_binlog_checksum_5_7(
 def test_insert_with_modify_binlog_checksum_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.insert_with_modify_binlog_checksum(
+    materialized_with_ddl.insert_with_modify_binlog_checksum(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -297,7 +297,7 @@ def test_insert_with_modify_binlog_checksum_8_0(
 def test_materialized_database_err_sync_user_privs_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.err_sync_user_privs_with_materialized_mysql_database(
+    materialized_with_ddl.err_sync_user_privs_with_materialized_mysql_database(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -305,19 +305,19 @@ def test_materialized_database_err_sync_user_privs_5_7(
 def test_materialized_database_err_sync_user_privs_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.err_sync_user_privs_with_materialized_mysql_database(
+    materialized_with_ddl.err_sync_user_privs_with_materialized_mysql_database(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
 
 def test_network_partition_5_7(started_cluster, started_mysql_5_7, clickhouse_node):
-    materialize_with_ddl.network_partition_test(
+    materialized_with_ddl.network_partition_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
 
 def test_network_partition_8_0(started_cluster, started_mysql_8_0, clickhouse_node):
-    materialize_with_ddl.network_partition_test(
+    materialized_with_ddl.network_partition_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -325,7 +325,7 @@ def test_network_partition_8_0(started_cluster, started_mysql_8_0, clickhouse_no
 def test_mysql_kill_sync_thread_restore_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.mysql_kill_sync_thread_restore_test(
+    materialized_with_ddl.mysql_kill_sync_thread_restore_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -333,7 +333,7 @@ def test_mysql_kill_sync_thread_restore_5_7(
 def test_mysql_kill_sync_thread_restore_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.mysql_kill_sync_thread_restore_test(
+    materialized_with_ddl.mysql_kill_sync_thread_restore_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -341,7 +341,7 @@ def test_mysql_kill_sync_thread_restore_8_0(
 def test_mysql_killed_while_insert_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.mysql_killed_while_insert(
+    materialized_with_ddl.mysql_killed_while_insert(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -349,7 +349,7 @@ def test_mysql_killed_while_insert_5_7(
 def test_mysql_killed_while_insert_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.mysql_killed_while_insert(
+    materialized_with_ddl.mysql_killed_while_insert(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -357,7 +357,7 @@ def test_mysql_killed_while_insert_8_0(
 def test_clickhouse_killed_while_insert_5_7(
     started_cluster, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.clickhouse_killed_while_insert(
+    materialized_with_ddl.clickhouse_killed_while_insert(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -365,7 +365,7 @@ def test_clickhouse_killed_while_insert_5_7(
 def test_clickhouse_killed_while_insert_8_0(
     started_cluster, started_mysql_8_0, clickhouse_node
 ):
-    materialize_with_ddl.clickhouse_killed_while_insert(
+    materialized_with_ddl.clickhouse_killed_while_insert(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -373,12 +373,12 @@ def test_clickhouse_killed_while_insert_8_0(
 def test_utf8mb4(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.utf8mb4_test(clickhouse_node, started_mysql_5_7, "mysql57")
-    materialize_with_ddl.utf8mb4_test(clickhouse_node, started_mysql_8_0, "mysql80")
+    materialized_with_ddl.utf8mb4_test(clickhouse_node, started_mysql_5_7, "mysql57")
+    materialized_with_ddl.utf8mb4_test(clickhouse_node, started_mysql_8_0, "mysql80")
 
 
 def test_system_parts_table(started_cluster, started_mysql_8_0, clickhouse_node):
-    materialize_with_ddl.system_parts_test(
+    materialized_with_ddl.system_parts_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -386,10 +386,10 @@ def test_system_parts_table(started_cluster, started_mysql_8_0, clickhouse_node)
 def test_multi_table_update(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.multi_table_update_test(
+    materialized_with_ddl.multi_table_update_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.multi_table_update_test(
+    materialized_with_ddl.multi_table_update_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -397,10 +397,10 @@ def test_multi_table_update(
 def test_system_tables_table(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.system_tables_test(
+    materialized_with_ddl.system_tables_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.system_tables_test(
+    materialized_with_ddl.system_tables_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -408,10 +408,10 @@ def test_system_tables_table(
 def test_materialized_with_column_comments(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.materialize_with_column_comments_test(
+    materialized_with_ddl.materialized_with_column_comments_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.materialize_with_column_comments_test(
+    materialized_with_ddl.materialized_with_column_comments_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -419,22 +419,22 @@ def test_materialized_with_column_comments(
 def test_materialized_with_enum(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.materialize_with_enum8_test(
+    materialized_with_ddl.materialized_with_enum8_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.materialize_with_enum16_test(
+    materialized_with_ddl.materialized_with_enum16_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.alter_enum8_to_enum16_test(
+    materialized_with_ddl.alter_enum8_to_enum16_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.materialize_with_enum8_test(
+    materialized_with_ddl.materialized_with_enum8_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialize_with_enum16_test(
+    materialized_with_ddl.materialized_with_enum16_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.alter_enum8_to_enum16_test(
+    materialized_with_ddl.alter_enum8_to_enum16_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -445,10 +445,10 @@ def test_materialized_with_enum(
 def test_mysql_settings(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.mysql_settings_test(
+    materialized_with_ddl.mysql_settings_test(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
-    materialize_with_ddl.mysql_settings_test(
+    materialized_with_ddl.mysql_settings_test(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
 
@@ -456,10 +456,10 @@ def test_mysql_settings(
 def test_large_transaction(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.materialized_mysql_large_transaction(
+    materialized_with_ddl.materialized_mysql_large_transaction(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialized_mysql_large_transaction(
+    materialized_with_ddl.materialized_mysql_large_transaction(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -467,24 +467,24 @@ def test_large_transaction(
 def test_table_table(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.table_table(clickhouse_node, started_mysql_8_0, "mysql80")
-    materialize_with_ddl.table_table(clickhouse_node, started_mysql_5_7, "mysql57")
+    materialized_with_ddl.table_table(clickhouse_node, started_mysql_8_0, "mysql80")
+    materialized_with_ddl.table_table(clickhouse_node, started_mysql_5_7, "mysql57")
 
 
 def test_table_overrides(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.table_overrides(clickhouse_node, started_mysql_5_7, "mysql57")
-    materialize_with_ddl.table_overrides(clickhouse_node, started_mysql_8_0, "mysql80")
+    materialized_with_ddl.table_overrides(clickhouse_node, started_mysql_5_7, "mysql57")
+    materialized_with_ddl.table_overrides(clickhouse_node, started_mysql_8_0, "mysql80")
 
 
 def test_materialized_database_support_all_kinds_of_mysql_datatype(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.materialized_database_support_all_kinds_of_mysql_datatype(
+    materialized_with_ddl.materialized_database_support_all_kinds_of_mysql_datatype(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialized_database_support_all_kinds_of_mysql_datatype(
+    materialized_with_ddl.materialized_database_support_all_kinds_of_mysql_datatype(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -492,10 +492,10 @@ def test_materialized_database_support_all_kinds_of_mysql_datatype(
 def test_materialized_database_settings_materialized_mysql_tables_list(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.materialized_database_settings_materialized_mysql_tables_list(
+    materialized_with_ddl.materialized_database_settings_materialized_mysql_tables_list(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialized_database_settings_materialized_mysql_tables_list(
+    materialized_with_ddl.materialized_database_settings_materialized_mysql_tables_list(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -503,10 +503,10 @@ def test_materialized_database_settings_materialized_mysql_tables_list(
 def test_materialized_database_mysql_date_type_to_date32(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.materialized_database_mysql_date_type_to_date32(
+    materialized_with_ddl.materialized_database_mysql_date_type_to_date32(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )
-    materialize_with_ddl.materialized_database_mysql_date_type_to_date32(
+    materialized_with_ddl.materialized_database_mysql_date_type_to_date32(
         clickhouse_node, started_mysql_5_7, "mysql57"
     )
 
@@ -514,18 +514,18 @@ def test_materialized_database_mysql_date_type_to_date32(
 def test_savepoint_query(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.savepoint(clickhouse_node, started_mysql_8_0, "mysql80")
-    materialize_with_ddl.savepoint(clickhouse_node, started_mysql_5_7, "mysql57")
+    materialized_with_ddl.savepoint(clickhouse_node, started_mysql_8_0, "mysql80")
+    materialized_with_ddl.savepoint(clickhouse_node, started_mysql_5_7, "mysql57")
 
 
 def test_materialized_database_mysql_drop_ddl(
     started_cluster, started_mysql_8_0, started_mysql_5_7, clickhouse_node
 ):
-    materialize_with_ddl.dropddl(clickhouse_node, started_mysql_8_0, "mysql80")
-    materialize_with_ddl.dropddl(clickhouse_node, started_mysql_5_7, "mysql57")
+    materialized_with_ddl.dropddl(clickhouse_node, started_mysql_8_0, "mysql80")
+    materialized_with_ddl.dropddl(clickhouse_node, started_mysql_5_7, "mysql57")
 
 
 def test_named_collections(started_cluster, started_mysql_8_0, clickhouse_node):
-    materialize_with_ddl.named_collections(
+    materialized_with_ddl.named_collections(
         clickhouse_node, started_mysql_8_0, "mysql80"
     )

From 79222bace2bb2732f247aa8e6700cde9b2e30040 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 16 Jun 2023 11:11:47 +0200
Subject: [PATCH 492/722] fix style

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index acc8fa76211..a94521b2a88 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -2133,6 +2133,7 @@ seektable
 sequenceCount
 sequenceMatch
 sequenceNextNode
+serverTimeZone
 serverTimezone
 serverUUID
 sessionCacheSize

From 99607dc795c201b6993a4c50f6a412790c3a80bc Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Fri, 16 Jun 2023 12:17:07 +0300
Subject: [PATCH 493/722] Update 02737_timezone_setting.sql

---
 tests/queries/0_stateless/02737_timezone_setting.sql | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/queries/0_stateless/02737_timezone_setting.sql b/tests/queries/0_stateless/02737_timezone_setting.sql
index a345e596193..8543e2a2c82 100644
--- a/tests/queries/0_stateless/02737_timezone_setting.sql
+++ b/tests/queries/0_stateless/02737_timezone_setting.sql
@@ -11,7 +11,7 @@ SELECT toDateTime64(toDateTime64('2022-12-12 23:23:23.123', 3), 3, 'Europe/Zuric
 
 -- test proper serialization
 SELECT toDateTime('2002-12-12 23:23:23') AS dt, toString(dt) SETTINGS session_timezone = 'Asia/Phnom_Penh';
-SELECT toDateTime64('2002-12-12 23:23:23.123', 3)as dt64, toString(dt64) SETTINGS session_timezone = 'Asia/Phnom_Penh';
+SELECT toDateTime64('2002-12-12 23:23:23.123', 3) AS dt64, toString(dt64) SETTINGS session_timezone = 'Asia/Phnom_Penh';
 
 -- Create a table and test that DateTimes are processed correctly on insert
 CREATE TABLE test_tz_setting (d DateTime('UTC')) Engine=Memory AS SELECT toDateTime('2000-01-01 00:00:00');
@@ -23,4 +23,4 @@ SELECT d FROM test_tz_setting WHERE d == '2000-01-01 01:00:00'; -- 1 row expecte
 SELECT d FROM test_tz_setting WHERE d == toDateTime('2000-01-01 02:00:00'); -- 0 rows expected
 
 -- Cleanup table
-DROP TABLE test_tz_setting SYNC;
\ No newline at end of file
+DROP TABLE test_tz_setting SYNC;

From d065fb756d6736a8551139166fb2f835d1bb0b20 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Fri, 16 Jun 2023 12:24:19 +0300
Subject: [PATCH 494/722] Update settings.md

---
 docs/ru/operations/settings/settings.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 754f9d071f2..5c2b564537b 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4132,6 +4132,8 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо [часового пояса сервера](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone). То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
 При значении настройки `''` (пустая строка), будет совпадать с часовым поясом сервера. 
 
+Функции `timeZone()` and `serverTimezone()` возвращают часовой пояс текущей сессии и сервера соответственно.
+
 Примеры:
 ```sql
 SELECT timeZone(), serverTimezone() FORMAT TSV

From 66d86a9ea21ec8980eba214cbe4d40b2e0921f30 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Fri, 16 Jun 2023 12:33:37 +0300
Subject: [PATCH 495/722] Update settings.md

---
 docs/ru/operations/settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
index 5c2b564537b..f83d05ff710 100644
--- a/docs/ru/operations/settings/settings.md
+++ b/docs/ru/operations/settings/settings.md
@@ -4129,7 +4129,7 @@ SELECT sum(number) FROM numbers(10000000000) SETTINGS partial_result_on_first_ca
 
 ## session_timezone {#session_timezone}
 
-Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо [часового пояса сервера](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone). То есть, все значения DateTime/DateTime64, для которых явно не задан параметр timezone, будут интерпретированы как относящиеся к указанной зоне.
+Задаёт значение часового пояса (session_timezone) по умолчанию для текущей сессии вместо [часового пояса сервера](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone). То есть, все значения DateTime/DateTime64, для которых явно не задан часовой пояс, будут интерпретированы как относящиеся к указанной зоне.
 При значении настройки `''` (пустая строка), будет совпадать с часовым поясом сервера. 
 
 Функции `timeZone()` and `serverTimezone()` возвращают часовой пояс текущей сессии и сервера соответственно.

From d745180ef6ad0057efbf2f054783e84a1ef1ea3a Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 16 Jun 2023 11:41:08 +0200
Subject: [PATCH 496/722] Update settings.md

---
 docs/en/operations/settings/settings.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 733bbf67a45..88dc54a8caa 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4210,13 +4210,13 @@ Use this setting only for backward compatibility if your use cases depend on old
 Sets the implicit time zone of the current session or query.
 The implicit time zone is the time zone applied to values of type DateTime/DateTime64 which have no explicitly specified time zone. 
 The setting takes precedence over the globally configured (server-level) implicit time zone.
-A value of '' (empty string) means that the implicit time zone of session or query is equal to the [server default time zone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
+A value of '' (empty string) means that the implicit time zone of the current session or query is equal to the [server default time zone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
 
-You can use functions `timeZone()` and `serverTimezone()` to get the session default and server time zones respectively.
+You can use functions `timeZone()` and `serverTimezone()` to get the session time zone and server time zone.
 
 Possible values:
 
--    Any timezone name from `system.time_zones`, e.g. `Europe/Berlin`, `UTC` or `Zulu`
+-    Any time zone name from `system.time_zones`, e.g. `Europe/Berlin`, `UTC` or `Zulu`
 
 Default value: `''`.
 
@@ -4235,6 +4235,7 @@ Asia/Novosibirsk	Europe/Berlin
 ```
 
 Assign session time zone 'America/Denver' to the inner DateTime without explicitly specified time zone:
+
 ```sql
 SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
 
@@ -4260,8 +4261,8 @@ SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS sessi
 
 This happens due to different parsing pipelines:
 
-- `toDateTime()` without explicitly given timezone used in the first `SELECT` query honors setting `session_timezone` and the global timezone.
-- In the second query, a DateTime is parsed from a String, and inherits the type and time zone of the existing column`d`. Thus, setting `session_timezone` and the global timezone are not honored.
+- `toDateTime()` without explicitly given time zone used in the first `SELECT` query honors setting `session_timezone` and the global time zone.
+- In the second query, a DateTime is parsed from a String, and inherits the type and time zone of the existing column`d`. Thus, setting `session_timezone` and the global time zone are not honored.
 
 **See also**
 

From 2cca632e83d88ca5cf359f7d3cf002c037ca7dc1 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 16 Jun 2023 11:42:22 +0200
Subject: [PATCH 497/722] Update settings.md

---
 docs/en/operations/settings/settings.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 88dc54a8caa..c8558c6cda8 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4212,7 +4212,7 @@ The implicit time zone is the time zone applied to values of type DateTime/DateT
 The setting takes precedence over the globally configured (server-level) implicit time zone.
 A value of '' (empty string) means that the implicit time zone of the current session or query is equal to the [server default time zone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
 
-You can use functions `timeZone()` and `serverTimezone()` to get the session time zone and server time zone.
+You can use functions `timeZone()` and `serverTimeZone()` to get the session time zone and server time zone.
 
 Possible values:
 
@@ -4223,13 +4223,13 @@ Default value: `''`.
 Examples:
 
 ```sql
-SELECT timeZone(), serverTimezone() FORMAT TSV
+SELECT timeZone(), serverTimeZone() FORMAT TSV
 
 Europe/Berlin	Europe/Berlin
 ```
 
 ```sql
-SELECT timeZone(), serverTimezone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT TSV
+SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT TSV
 
 Asia/Novosibirsk	Europe/Berlin
 ```
@@ -4250,10 +4250,10 @@ See the following example and explanation.
 ```sql
 CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');
 
-SELECT *, timezone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
+SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
 0 rows in set.
 
-SELECT *, timezone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
+SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
 ┌───────────────────d─┬─timezone()───────┐
 │ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
 └─────────────────────┴──────────────────┘

From a622f1b16c2e9e2053fbeea963ac66ae59c01478 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 16 Jun 2023 11:42:58 +0200
Subject: [PATCH 498/722] Update settings.md

---
 docs/en/operations/settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index c8558c6cda8..bdd9684982c 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4254,7 +4254,7 @@ SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SE
 0 rows in set.
 
 SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
-┌───────────────────d─┬─timezone()───────┐
+┌───────────────────d─┬─timeZone()───────┐
 │ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
 └─────────────────────┴──────────────────┘
 ```

From 0e6ec3e21f08ec8255a0b5ddb11e6a6055733961 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 16 Jun 2023 11:44:47 +0200
Subject: [PATCH 499/722] Update settings.md

---
 docs/en/operations/settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index bdd9684982c..d0ecbedba71 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -4210,7 +4210,7 @@ Use this setting only for backward compatibility if your use cases depend on old
 Sets the implicit time zone of the current session or query.
 The implicit time zone is the time zone applied to values of type DateTime/DateTime64 which have no explicitly specified time zone. 
 The setting takes precedence over the globally configured (server-level) implicit time zone.
-A value of '' (empty string) means that the implicit time zone of the current session or query is equal to the [server default time zone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
+A value of '' (empty string) means that the implicit time zone of the current session or query is equal to the [server time zone](../server-configuration-parameters/settings.md#server_configuration_parameters-timezone).
 
 You can use functions `timeZone()` and `serverTimeZone()` to get the session time zone and server time zone.
 

From 112a3e6aca8ad22971c27bdd3927fed4d22d1f2a Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Fri, 16 Jun 2023 12:19:01 +0200
Subject: [PATCH 500/722] revert tz validation optimization

---
 programs/keeper/CMakeLists.txt |  2 --
 src/CMakeLists.txt             |  5 -----
 src/Core/SettingsFields.cpp    | 16 ----------------
 src/Core/SettingsFields.h      | 12 +++++++++---
 4 files changed, 9 insertions(+), 26 deletions(-)

diff --git a/programs/keeper/CMakeLists.txt b/programs/keeper/CMakeLists.txt
index 3fb8126ed03..1f1138f49eb 100644
--- a/programs/keeper/CMakeLists.txt
+++ b/programs/keeper/CMakeLists.txt
@@ -108,8 +108,6 @@ if (BUILD_STANDALONE_KEEPER)
         ${CMAKE_CURRENT_SOURCE_DIR}/../../src/Daemon/GraphiteWriter.cpp
         ${CMAKE_CURRENT_BINARY_DIR}/../../src/Daemon/GitHash.generated.cpp
 
-        ${CMAKE_CURRENT_BINARY_DIR}/../../src/Storages/System/StorageSystemTimeZones.generated.cpp
-
         Keeper.cpp
         clickhouse-keeper.cpp
     )
diff --git a/src/CMakeLists.txt b/src/CMakeLists.txt
index 18858f446a4..ca428fbff3a 100644
--- a/src/CMakeLists.txt
+++ b/src/CMakeLists.txt
@@ -192,11 +192,6 @@ list (APPEND dbms_headers
     Dictionaries/DictionaryStructure.h
     Dictionaries/getDictionaryConfigurationFromAST.h)
 
-# Required for validation of Timezone in session_timezone setting.
-# This way we don't need to create timezone via cctz each time, but check against pregenerated char**
-list (APPEND dbms_sources
-        Storages/System/StorageSystemTimeZones.generated.cpp)
-
 if (NOT ENABLE_SSL)
     list (REMOVE_ITEM clickhouse_common_io_sources Common/OpenSSLHelpers.cpp)
     list (REMOVE_ITEM clickhouse_common_io_headers Common/OpenSSLHelpers.h)
diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 834c677d38e..9c7dac5fef4 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -13,8 +13,6 @@
 
 #include <cmath>
 
-extern const char * auto_time_zones[];
-
 namespace DB
 {
 namespace ErrorCodes
@@ -28,14 +26,6 @@ namespace ErrorCodes
 
 namespace
 {
-    bool checkIsExistingTimeZone(const std::string_view timezone)
-    {
-        for (auto * it = auto_time_zones; *it; ++it)
-            if (timezone == *it)
-                return true;
-        return false;
-    }
-
     template <typename T>
     T stringToNumber(const String & str)
     {
@@ -473,12 +463,6 @@ void SettingFieldTimezone::readBinary(ReadBuffer & in)
     *this = std::move(str);
 }
 
-void SettingFieldTimezone::validateTimezone(std::string_view str)
-{
-    if (!str.empty() && !checkIsExistingTimeZone(str))
-        throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", str);
-}
-
 String SettingFieldCustom::toString() const
 {
     return value.dump();
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index ac7c9740143..17b64474c04 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -6,6 +6,7 @@
 #include <Core/Field.h>
 #include <Core/MultiEnum.h>
 #include <boost/range/adaptor/map.hpp>
+#include <cctz/time_zone.h>
 #include <chrono>
 #include <unordered_map>
 #include <string_view>
@@ -552,13 +553,13 @@ struct SettingFieldTimezone
     String value;
     bool changed = false;
 
-    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(str); value = str; }
+    explicit SettingFieldTimezone(std::string_view str = {}) { validateTimezone(std::string(str)); value = str; }
     explicit SettingFieldTimezone(const String & str) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(String && str) { validateTimezone(str); value = std::move(str); }
     explicit SettingFieldTimezone(const char * str) { validateTimezone(str); value = str; }
     explicit SettingFieldTimezone(const Field & f) { const String & str = f.safeGet<const String &>(); validateTimezone(str); value = str; }
 
-    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(str); value = str; changed = true; return *this; }
+    SettingFieldTimezone & operator =(std::string_view str) { validateTimezone(std::string(str)); value = str; changed = true; return *this; }
     SettingFieldTimezone & operator =(const String & str) { *this = std::string_view{str}; return *this; }
     SettingFieldTimezone & operator =(String && str) { validateTimezone(str); value = std::move(str); changed = true; return *this; }
     SettingFieldTimezone & operator =(const char * str) { *this = std::string_view{str}; return *this; }
@@ -574,7 +575,12 @@ struct SettingFieldTimezone
     void readBinary(ReadBuffer & in);
 
 private:
-    static void validateTimezone(std::string_view str);
+    static cctz::time_zone validated_tz;
+    static void validateTimezone(const std::string & tz_str)
+    {
+        if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
+            throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
+    }
 };
 
 /// Can keep a value of any type. Used for user-defined settings.

From b3476e53fc86d800ec274e78597aaecb6be8f687 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Fri, 16 Jun 2023 13:44:17 +0300
Subject: [PATCH 501/722] Update SettingsFields.cpp

---
 src/Core/SettingsFields.cpp | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/Core/SettingsFields.cpp b/src/Core/SettingsFields.cpp
index 9c7dac5fef4..a0f643f8d30 100644
--- a/src/Core/SettingsFields.cpp
+++ b/src/Core/SettingsFields.cpp
@@ -20,7 +20,6 @@ namespace ErrorCodes
     extern const int SIZE_OF_FIXED_STRING_DOESNT_MATCH;
     extern const int CANNOT_PARSE_BOOL;
     extern const int CANNOT_PARSE_NUMBER;
-    extern const int BAD_ARGUMENTS;
 }
 
 

From ee5ca7337efb76d89fbd87a9f2d58dfe5b01e9d6 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 16 Jun 2023 12:51:31 +0200
Subject: [PATCH 502/722] Add reset to Stopwatch, improve codebrowser report

---
 tests/ci/codebrowser_check.py | 36 +++++++++++++++++++++++------------
 tests/ci/stopwatch.py         |  7 +++++--
 2 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/tests/ci/codebrowser_check.py b/tests/ci/codebrowser_check.py
index 2dba5176c8b..a3414156bba 100644
--- a/tests/ci/codebrowser_check.py
+++ b/tests/ci/codebrowser_check.py
@@ -87,25 +87,37 @@ def main():
 
     report_path = result_path / "html_report"
     logging.info("Report path %s", report_path)
+
     s3_path_prefix = "codebrowser"
+    index_template = (
+        f'<a href="{S3_DOWNLOAD}/{S3_TEST_REPORTS_BUCKET}/{s3_path_prefix}/index.html">'
+        "{}</a>"
+    )
+    additional_logs = [path.absolute() for path in result_path.glob("*.log")]
+    test_results = [
+        TestResult(
+            index_template.format("Generate codebrowser site"),
+            state,
+            stopwatch.duration_seconds,
+            additional_logs,
+        )
+    ]
+
     if state == "success":
+        stopwatch.reset()
         _ = s3_helper.fast_parallel_upload_dir(
             report_path, s3_path_prefix, S3_TEST_REPORTS_BUCKET
         )
-
-    index_html = (
-        f'<a href="{S3_DOWNLOAD}/{S3_TEST_REPORTS_BUCKET}/codebrowser/index.html">'
-        "Generate codebrowser site</a>"
-    )
-
-    additional_logs = [path.absolute() for path in result_path.glob("*.log")]
-
-    test_results = [
-        TestResult(index_html, state, stopwatch.duration_seconds, additional_logs)
-    ]
+        test_results.append(
+            TestResult(
+                index_template.format("Upload codebrowser site"),
+                state,
+                stopwatch.duration_seconds,
+            )
+        )
 
     # Check if the run log contains `FATAL Error:`, that means the code problem
-    stopwatch = Stopwatch()
+    stopwatch.reset()
     fatal_error = "FATAL Error:"
     logging.info("Search for '%s' in %s", fatal_error, run_log_path)
     with open(run_log_path, "r", encoding="utf-8") as rlfd:
diff --git a/tests/ci/stopwatch.py b/tests/ci/stopwatch.py
index 1ab6737530c..a63eb954a4d 100644
--- a/tests/ci/stopwatch.py
+++ b/tests/ci/stopwatch.py
@@ -5,8 +5,7 @@ import datetime
 
 class Stopwatch:
     def __init__(self):
-        self.start_time = datetime.datetime.utcnow()
-        self.start_time_str_value = self.start_time.strftime("%Y-%m-%d %H:%M:%S")
+        self.reset()
 
     @property
     def duration_seconds(self) -> float:
@@ -15,3 +14,7 @@ class Stopwatch:
     @property
     def start_time_str(self) -> str:
         return self.start_time_str_value
+
+    def reset(self) -> None:
+        self.start_time = datetime.datetime.utcnow()
+        self.start_time_str_value = self.start_time.strftime("%Y-%m-%d %H:%M:%S")

From 5e3233f0e47d659035175d87d87a09825dbadc85 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 16 Jun 2023 12:57:03 +0200
Subject: [PATCH 503/722] Increase woboq job timeout

---
 .github/workflows/woboq.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/woboq.yml b/.github/workflows/woboq.yml
index bdfbc8fef9c..1ef729af30a 100644
--- a/.github/workflows/woboq.yml
+++ b/.github/workflows/woboq.yml
@@ -12,6 +12,7 @@ jobs:
   # don't use dockerhub push because this image updates so rarely
   WoboqCodebrowser:
     runs-on: [self-hosted, style-checker]
+    timeout-minutes: 420  # the task is pretty heavy, so there's an additional hour
     steps:
       - name: Set envs
         run: |

From f576f1cf0bb5bab9098363e091540e2395a6488d Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Fri, 16 Jun 2023 14:31:15 +0300
Subject: [PATCH 504/722] Update 02445_replicated_db_alter_partition.sh

---
 .../queries/0_stateless/02445_replicated_db_alter_partition.sh  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh b/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
index 349a2ecc925..e07737225db 100755
--- a/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
+++ b/tests/queries/0_stateless/02445_replicated_db_alter_partition.sh
@@ -41,7 +41,7 @@ $CLICKHOUSE_CLIENT -q "alter table $db.mt drop partition id 'all', update n = 2
 $CLICKHOUSE_CLIENT -q "alter table $db.rmt drop partition id 'all', update n = 2 where 1" 2>&1| grep -Eo "not allowed to execute ALTERs of different types" | head -1
 
 $CLICKHOUSE_CLIENT --distributed_ddl_task_timeout=3 -q "alter table $db.mt update n=2 where n=1" 2>&1| grep -Eo "TIMEOUT_EXCEEDED" | head -1
-$CLICKHOUSE_CLIENT -q "alter table $db.rmt update n=2 where n=1"
+$CLICKHOUSE_CLIENT -q "alter table $db.rmt update n=2 where n=1 settings mutations_sync=1"
 
 $CLICKHOUSE_CLIENT -q "select 1, * from $db.rmt order by n"
 

From 1f47bb77162c7567a0791be7e4620be529555565 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 16 Jun 2023 13:45:46 +0200
Subject: [PATCH 505/722] Fix docs

---
 docs/en/operations/settings/settings.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index 1e1a2764b9b..f0668c1d58f 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -3380,7 +3380,7 @@ Default value: `0`.
 
 ## s3_skip_empty_files {#s3_skip_empty_files}
 
-Enables or disables skipping empty files in [S3](../../engines/table-engines/special/s3.md) engine tables.
+Enables or disables skipping empty files in [S3](../../engines/table-engines/integrations/s3.md) engine tables.
 
 Possible values:
 - 0 — `SELECT` throws an exception if empty file is not compatible with requested format.
@@ -3412,7 +3412,7 @@ Default value: `0`.
 
 ## hdfs_skip_empty_files {#hdfs_skip_empty_files}
 
-Enables or disables skipping empty files in [HDFS](../../engines/table-engines/special/hdfs.md) engine tables.
+Enables or disables skipping empty files in [HDFS](../../engines/table-engines/integrations/hdfs.md) engine tables.
 
 Possible values:
 - 0 — `SELECT` throws an exception if empty file is not compatible with requested format.

From 43e572bd84d8e83a0fb54ce457bbfc2506b42d59 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Fri, 16 Jun 2023 14:55:34 +0300
Subject: [PATCH 506/722] typo in SettingsFields.h

---
 src/Core/SettingsFields.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 17b64474c04..45c62d0072a 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -575,9 +575,9 @@ struct SettingFieldTimezone
     void readBinary(ReadBuffer & in);
 
 private:
-    static cctz::time_zone validated_tz;
-    static void validateTimezone(const std::string & tz_str)
+    void validateTimezone(const std::string & tz_str)
     {
+        cctz::time_zone validated_tz;
         if (!tz_str.empty() && !cctz::load_time_zone(tz_str, &validated_tz))
             throw DB::Exception(DB::ErrorCodes::BAD_ARGUMENTS, "Invalid time zone: {}", tz_str);
     }

From f7638de2132fceec1da3b92303608a1b0c29f2ae Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@yandex.ru>
Date: Fri, 16 Jun 2023 15:32:30 +0200
Subject: [PATCH 507/722] Fix crash in BackupCoordinationStageSync::setError().
 (#51012)

---
 src/Backups/BackupCoordinationStageSync.cpp | 3 +++
 src/Backups/BackupsWorker.cpp               | 3 +--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/Backups/BackupCoordinationStageSync.cpp b/src/Backups/BackupCoordinationStageSync.cpp
index 3d8c283f084..ebddbb8b82f 100644
--- a/src/Backups/BackupCoordinationStageSync.cpp
+++ b/src/Backups/BackupCoordinationStageSync.cpp
@@ -85,6 +85,9 @@ void BackupCoordinationStageSync::setError(const String & current_host, const Ex
         writeException(exception, buf, true);
         zookeeper->createIfNotExists(zookeeper_path + "/error", buf.str());
 
+        /// When backup/restore fails, it removes the nodes from Zookeeper.
+        /// Sometimes it fails to remove all nodes. It's possible that it removes /error node, but fails to remove /stage node,
+        /// so the following line tries to preserve the error status.
         auto code = zookeeper->trySet(zookeeper_path, Stage::ERROR);
         if (code != Coordination::Error::ZOK)
             throw zkutil::KeeperException(code, zookeeper_path);
diff --git a/src/Backups/BackupsWorker.cpp b/src/Backups/BackupsWorker.cpp
index 0a6482fb7de..53a076705c4 100644
--- a/src/Backups/BackupsWorker.cpp
+++ b/src/Backups/BackupsWorker.cpp
@@ -152,8 +152,7 @@ namespace
         }
         catch (...)
         {
-            if (coordination)
-                coordination->setError(Exception(getCurrentExceptionMessageAndPattern(true, true), getCurrentExceptionCode()));
+            sendExceptionToCoordination(coordination, Exception(getCurrentExceptionMessageAndPattern(true, true), getCurrentExceptionCode()));
         }
     }
 

From 38ed92c8f40869c9b4ba66a5192cb6ee490c423a Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Fri, 16 Jun 2023 15:53:29 +0200
Subject: [PATCH 508/722] Update Avro format docs

---
 docs/en/interfaces/formats.md | 25 ++++++++++++++++++++++---
 1 file changed, 22 insertions(+), 3 deletions(-)

diff --git a/docs/en/interfaces/formats.md b/docs/en/interfaces/formats.md
index 94d480d8308..5fd2b82375f 100644
--- a/docs/en/interfaces/formats.md
+++ b/docs/en/interfaces/formats.md
@@ -1878,13 +1878,13 @@ The table below shows supported data types and how they match ClickHouse [data t
 | `string (uuid)` \**                         | [UUID](/docs/en/sql-reference/data-types/uuid.md)                                                                             | `string (uuid)` \**           |
 | `fixed(16)`                                 | [Int128/UInt128](/docs/en/sql-reference/data-types/int-uint.md)                                                               | `fixed(16)`                   |
 | `fixed(32)`                                 | [Int256/UInt256](/docs/en/sql-reference/data-types/int-uint.md)                                                               | `fixed(32)`                   |
+| `record`                                    | [Tuple](/docs/en/sql-reference/data-types/tuple.md)                                                                           | `record`                      |
+
 
 
 \* `bytes` is default, controlled by [output_format_avro_string_column_pattern](/docs/en/operations/settings/settings-formats.md/#output_format_avro_string_column_pattern)
 \** [Avro logical types](https://avro.apache.org/docs/current/spec.html#Logical+Types)
 
-Unsupported Avro data types: `record` (non-root), `map`
-
 Unsupported Avro logical data types: `time-millis`, `time-micros`, `duration`
 
 ### Inserting Data {#inserting-data-1}
@@ -1923,7 +1923,26 @@ Output Avro file compression and sync interval can be configured with [output_fo
 
 Using the ClickHouse [DESCRIBE](/docs/en/sql-reference/statements/describe-table) function, you can quickly view the inferred format of an Avro file like the following example. This example includes the URL of a publicly accessible Avro file in the ClickHouse S3 public bucket:
 
-``` DESCRIBE url('https://clickhouse-public-datasets.s3.eu-central-1.amazonaws.com/hits.avro','Avro');
+```
+DESCRIBE url('https://clickhouse-public-datasets.s3.eu-central-1.amazonaws.com/hits.avro','Avro);
+```
+```
+┌─name───────────────────────┬─type────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
+│ WatchID                    │ Int64           │              │                    │         │                  │                │
+│ JavaEnable                 │ Int32           │              │                    │         │                  │                │
+│ Title                      │ String          │              │                    │         │                  │                │
+│ GoodEvent                  │ Int32           │              │                    │         │                  │                │
+│ EventTime                  │ Int32           │              │                    │         │                  │                │
+│ EventDate                  │ Date32          │              │                    │         │                  │                │
+│ CounterID                  │ Int32           │              │                    │         │                  │                │
+│ ClientIP                   │ Int32           │              │                    │         │                  │                │
+│ ClientIP6                  │ FixedString(16) │              │                    │         │                  │                │
+│ RegionID                   │ Int32           │              │                    │         │                  │                │
+...
+│ IslandID                   │ FixedString(16) │              │                    │         │                  │                │
+│ RequestNum                 │ Int32           │              │                    │         │                  │                │
+│ RequestTry                 │ Int32           │              │                    │         │                  │                │
+└────────────────────────────┴─────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
 ```
 
 ## AvroConfluent {#data-format-avro-confluent}

From 9a4962bd6847fac0c67a8a7abb03a383cc6b5dc1 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Wed, 31 May 2023 15:47:00 +0200
Subject: [PATCH 509/722] add error log message when no finalize called before
 d-tor

---
 src/IO/WriteBuffer.h         | 28 ++++++++++++++++++++++++----
 src/IO/WriteBufferFromS3.cpp | 13 +++++++------
 2 files changed, 31 insertions(+), 10 deletions(-)

diff --git a/src/IO/WriteBuffer.h b/src/IO/WriteBuffer.h
index 2c891e17d9a..261a26c93d0 100644
--- a/src/IO/WriteBuffer.h
+++ b/src/IO/WriteBuffer.h
@@ -8,6 +8,7 @@
 
 #include <Common/Exception.h>
 #include <Common/LockMemoryExceptionInThread.h>
+#include <Common/logger_useful.h>
 #include <IO/BufferBase.h>
 
 
@@ -63,10 +64,29 @@ public:
         pos = working_buffer.begin();
     }
 
-    /** it is desirable in the derived classes to place the finalize() call in the destructor,
-      * so that the last data is written (if finalize() wasn't called explicitly)
-      */
-    virtual ~WriteBuffer() = default;
+    /// Calling finalize() in the destructor of derived classes is a bad practice.
+    /// This causes objects to be left on the remote FS when a write operation is rolled back.
+    /// Do call finalize() explicitly, before this call you have no guarantee that the file has been written
+    virtual ~WriteBuffer()
+    {
+        // That destructor could be call with finalized=false in case of exceptions
+        if (!finalized)
+        {
+            /// It is totally OK to destroy instance without finalization when an exception occurs
+            /// However it is suspicious to destroy instance without finalization at the green path
+            if (!std::uncaught_exceptions())
+            {
+                Poco::Logger * log = &Poco::Logger::get("WriteBuffer");
+                LOG_ERROR(
+                    log,
+                    "WriteBufferFromS3 is not finalized in destructor. "
+                    "No exceptions in flight are detected. "
+                    "The file might not be written at all or might be truncated. "
+                    "Stack trace: {}",
+                    StackTrace().toString());
+            }
+        }
+    }
 
     inline void nextIfAtEnd()
     {
diff --git a/src/IO/WriteBufferFromS3.cpp b/src/IO/WriteBufferFromS3.cpp
index 990505adfb3..ebab9b323b8 100644
--- a/src/IO/WriteBufferFromS3.cpp
+++ b/src/IO/WriteBufferFromS3.cpp
@@ -235,14 +235,15 @@ WriteBufferFromS3::~WriteBufferFromS3()
 {
     LOG_TRACE(log, "Close WriteBufferFromS3. {}.", getLogDetails());
 
-    // That destructor could be call with finalized=false in case of exceptions
+    /// That destructor could be call with finalized=false in case of exceptions
     if (!finalized)
     {
-        LOG_INFO(log,
-                 "WriteBufferFromS3 is not finalized in destructor. "
-                 "It could be if an exception occurs. File is not written to S3. "
-                 "{}.",
-                 getLogDetails());
+        LOG_INFO(
+            log,
+            "WriteBufferFromS3 is not finalized in destructor. "
+            "The file might not be written to S3. "
+            "{}.",
+            getLogDetails());
     }
 
     task_tracker->safeWaitAll();

From 1cb02e27106801671059e8afa51f76913a0c5d94 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Thu, 1 Jun 2023 19:00:47 +0200
Subject: [PATCH 510/722] do call finalize for all buffers

---
 src/Columns/ColumnAggregateFunction.cpp       |  1 +
 src/Common/ShellCommand.cpp                   |  4 ++-
 src/Coordination/KeeperServer.cpp             |  4 ++-
 src/Core/MySQL/IMySQLWritePacket.cpp          |  2 +-
 src/Functions/blockSerializedSize.cpp         |  1 +
 src/Functions/dateName.cpp                    |  4 ++-
 src/IO/HashingWriteBuffer.h                   |  1 +
 src/IO/NullWriteBuffer.cpp                    |  4 +--
 src/IO/NullWriteBuffer.h                      |  7 +++--
 src/IO/WriteBuffer.h                          | 27 ++++++++++++++++---
 .../gtest_DateTime64_parsing_and_writing.cpp  |  3 ++-
 src/Processors/Formats/Impl/NullFormat.cpp    |  4 ++-
 src/Processors/Formats/Impl/NullFormat.h      |  6 +++--
 .../Impl/ParallelFormattingOutputFormat.cpp   |  1 +
 .../Impl/ParallelFormattingOutputFormat.h     |  1 +
 src/Processors/Formats/LazyOutputFormat.cpp   |  2 +-
 src/Processors/Formats/LazyOutputFormat.h     |  2 +-
 .../Formats/PullingOutputFormat.cpp           |  7 ++++-
 src/Processors/Formats/PullingOutputFormat.h  |  9 +++----
 src/Storages/MergeTree/IMergeTreeDataPart.cpp |  2 +-
 .../MergeTreeDataPartWriterCompact.cpp        | 21 ++++++++++-----
 .../MergeTreeDataPartWriterOnDisk.cpp         | 16 +++++------
 src/Storages/MergeTree/MergeTreePartition.cpp |  4 ++-
 .../MergeTree/MergedBlockOutputStream.cpp     |  7 +++--
 24 files changed, 99 insertions(+), 41 deletions(-)

diff --git a/src/Columns/ColumnAggregateFunction.cpp b/src/Columns/ColumnAggregateFunction.cpp
index e521262acd2..62ec324455e 100644
--- a/src/Columns/ColumnAggregateFunction.cpp
+++ b/src/Columns/ColumnAggregateFunction.cpp
@@ -528,6 +528,7 @@ StringRef ColumnAggregateFunction::serializeValueIntoArena(size_t n, Arena & are
 {
     WriteBufferFromArena out(arena, begin);
     func->serialize(data[n], out, version);
+    out.finalize();
     return out.complete();
 }
 
diff --git a/src/Common/ShellCommand.cpp b/src/Common/ShellCommand.cpp
index 0616ac6303c..533e73c7adb 100644
--- a/src/Common/ShellCommand.cpp
+++ b/src/Common/ShellCommand.cpp
@@ -260,7 +260,7 @@ std::unique_ptr<ShellCommand> ShellCommand::executeDirect(const ShellCommand::Co
 
     std::vector<char *> argv(arguments.size() + 2);
     std::vector<char> argv_data(argv_sum_size);
-    WriteBuffer writer(argv_data.data(), argv_sum_size);
+    WriteBufferFromPointer writer(argv_data.data(), argv_sum_size);
 
     argv[0] = writer.position();
     writer.write(path.data(), path.size() + 1);
@@ -271,6 +271,8 @@ std::unique_ptr<ShellCommand> ShellCommand::executeDirect(const ShellCommand::Co
         writer.write(arguments[i].data(), arguments[i].size() + 1);
     }
 
+    writer.finalize();
+
     argv[arguments.size() + 1] = nullptr;
 
     return executeImpl(path.data(), argv.data(), config);
diff --git a/src/Coordination/KeeperServer.cpp b/src/Coordination/KeeperServer.cpp
index 6e47412cd3a..fda76c52684 100644
--- a/src/Coordination/KeeperServer.cpp
+++ b/src/Coordination/KeeperServer.cpp
@@ -674,7 +674,7 @@ nuraft::cb_func::ReturnCode KeeperServer::callbackFunc(nuraft::cb_func::Type typ
 
                 auto * buffer_start = reinterpret_cast<BufferBase::Position>(entry_buf->data_begin() + entry_buf->size() - write_buffer_header_size);
 
-                WriteBuffer write_buf(buffer_start, write_buffer_header_size);
+                WriteBufferFromPointer write_buf(buffer_start, write_buffer_header_size);
 
                 if (serialization_version < KeeperStateMachine::ZooKeeperLogSerializationVersion::WITH_TIME)
                     writeIntBinary(request_for_session->time, write_buf);
@@ -684,6 +684,8 @@ nuraft::cb_func::ReturnCode KeeperServer::callbackFunc(nuraft::cb_func::Type typ
                 if (request_for_session->digest->version != KeeperStorage::NO_DIGEST)
                     writeIntBinary(request_for_session->digest->value, write_buf);
 
+                write_buf.finalize();
+
                 return nuraft::cb_func::ReturnCode::Ok;
             }
             case nuraft::cb_func::PreAppendLogFollower:
diff --git a/src/Core/MySQL/IMySQLWritePacket.cpp b/src/Core/MySQL/IMySQLWritePacket.cpp
index b5c95717a9b..fd27603d6a8 100644
--- a/src/Core/MySQL/IMySQLWritePacket.cpp
+++ b/src/Core/MySQL/IMySQLWritePacket.cpp
@@ -16,7 +16,7 @@ void IMySQLWritePacket::writePayload(WriteBuffer & buffer, uint8_t & sequence_id
 {
     MySQLPacketPayloadWriteBuffer buf(buffer, getPayloadSize(), sequence_id);
     writePayloadImpl(buf);
-    buf.next();
+    buf.finalize();
     if (buf.remainingPayloadSize())
     {
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Incomplete payload. Written {} bytes, expected {} bytes.",
diff --git a/src/Functions/blockSerializedSize.cpp b/src/Functions/blockSerializedSize.cpp
index 35be65f3fed..8cfa3b8a4e3 100644
--- a/src/Functions/blockSerializedSize.cpp
+++ b/src/Functions/blockSerializedSize.cpp
@@ -60,6 +60,7 @@ public:
             settings, state);
         serialization->serializeBinaryBulkStateSuffix(settings, state);
 
+        out.finalize();
         return out.count();
     }
 };
diff --git a/src/Functions/dateName.cpp b/src/Functions/dateName.cpp
index bfb190b9a08..4d7a4f0b53d 100644
--- a/src/Functions/dateName.cpp
+++ b/src/Functions/dateName.cpp
@@ -170,7 +170,7 @@ public:
 
         auto * begin = reinterpret_cast<char *>(result_column_data.data());
 
-        WriteBuffer buffer(begin, result_column_data.size());
+        WriteBufferFromPointer buffer(begin, result_column_data.size());
 
         using TimeType = DateTypeToTimeType<DataType>;
         callOnDatePartWriter<TimeType>(date_part, [&](const auto & writer)
@@ -195,6 +195,8 @@ public:
 
         result_column_data.resize(buffer.position() - begin);
 
+        buffer.finalize();
+
         return result_column;
     }
 
diff --git a/src/IO/HashingWriteBuffer.h b/src/IO/HashingWriteBuffer.h
index 8edfa45a6be..a201d0dab4d 100644
--- a/src/IO/HashingWriteBuffer.h
+++ b/src/IO/HashingWriteBuffer.h
@@ -85,6 +85,7 @@ public:
     uint128 getHash()
     {
         next();
+        chassert(finalized);
         return IHashingBuffer<WriteBuffer>::getHash();
     }
 };
diff --git a/src/IO/NullWriteBuffer.cpp b/src/IO/NullWriteBuffer.cpp
index 035259d48c9..295c53ef7c7 100644
--- a/src/IO/NullWriteBuffer.cpp
+++ b/src/IO/NullWriteBuffer.cpp
@@ -4,8 +4,8 @@
 namespace DB
 {
 
-NullWriteBuffer::NullWriteBuffer(size_t buf_size, char * existing_memory, size_t alignment)
-    : BufferWithOwnMemory<WriteBuffer>(buf_size, existing_memory, alignment)
+NullWriteBuffer::NullWriteBuffer()
+    : WriteBuffer(data, sizeof(data))
 {
 }
 
diff --git a/src/IO/NullWriteBuffer.h b/src/IO/NullWriteBuffer.h
index 615a9bf5cef..f14c74ff720 100644
--- a/src/IO/NullWriteBuffer.h
+++ b/src/IO/NullWriteBuffer.h
@@ -8,11 +8,14 @@ namespace DB
 {
 
 /// Simply do nothing, can be used to measure amount of written bytes.
-class NullWriteBuffer : public BufferWithOwnMemory<WriteBuffer>, boost::noncopyable
+class NullWriteBuffer : public WriteBuffer, boost::noncopyable
 {
 public:
-    explicit NullWriteBuffer(size_t buf_size = 16<<10, char * existing_memory = nullptr, size_t alignment = false);
+    NullWriteBuffer();
     void nextImpl() override;
+
+private:
+    char data[128];
 };
 
 }
diff --git a/src/IO/WriteBuffer.h b/src/IO/WriteBuffer.h
index 261a26c93d0..9d74eecaec9 100644
--- a/src/IO/WriteBuffer.h
+++ b/src/IO/WriteBuffer.h
@@ -33,7 +33,6 @@ class WriteBuffer : public BufferBase
 public:
     using BufferBase::set;
     using BufferBase::position;
-    WriteBuffer(Position ptr, size_t size) : BufferBase(ptr, size, 0) {}
     void set(Position ptr, size_t size) { BufferBase::set(ptr, size, 0); }
 
     /** write the data in the buffer (from the beginning of the buffer to the current position);
@@ -70,7 +69,7 @@ public:
     virtual ~WriteBuffer()
     {
         // That destructor could be call with finalized=false in case of exceptions
-        if (!finalized)
+        if (count() > 0 && !finalized)
         {
             /// It is totally OK to destroy instance without finalization when an exception occurs
             /// However it is suspicious to destroy instance without finalization at the green path
@@ -164,6 +163,8 @@ public:
     }
 
 protected:
+    WriteBuffer(Position ptr, size_t size) : BufferBase(ptr, size, 0) {}
+
     virtual void finalizeImpl()
     {
         next();
@@ -175,11 +176,31 @@ private:
     /** Write the data in the buffer (from the beginning of the buffer to the current position).
       * Throw an exception if something is wrong.
       */
-    virtual void nextImpl() { throw Exception(ErrorCodes::CANNOT_WRITE_AFTER_END_OF_BUFFER, "Cannot write after end of buffer."); }
+    virtual void nextImpl()
+    {
+        throw Exception(ErrorCodes::CANNOT_WRITE_AFTER_END_OF_BUFFER, "Cannot write after end of buffer.");
+    }
 };
 
 
 using WriteBufferPtr = std::shared_ptr<WriteBuffer>;
 
 
+class WriteBufferFromPointer : public WriteBuffer
+{
+public:
+    WriteBufferFromPointer(Position ptr, size_t size) : WriteBuffer(ptr, size) {}
+
+private:
+    virtual void finalizeImpl() override
+    {
+        /// no op
+    }
+
+    virtual void sync() override
+    {
+        /// no on
+    }
+};
+
 }
diff --git a/src/IO/tests/gtest_DateTime64_parsing_and_writing.cpp b/src/IO/tests/gtest_DateTime64_parsing_and_writing.cpp
index 697851b217a..6dd6ea67125 100644
--- a/src/IO/tests/gtest_DateTime64_parsing_and_writing.cpp
+++ b/src/IO/tests/gtest_DateTime64_parsing_and_writing.cpp
@@ -59,8 +59,9 @@ TEST_P(DateTime64StringWriteTest, WriteText)
 
     PaddedPODArray<char> actual_string(param.string.size() * 2, '\0'); // TODO: detect overflows
 
-    WriteBuffer write_buffer(actual_string.data(), actual_string.size());
+    WriteBufferFromPointer write_buffer(actual_string.data(), actual_string.size());
     EXPECT_NO_THROW(writeDateTimeText(param.dt64, param.scale, write_buffer, param.timezone));
+    write_buffer.finalize();
 
     EXPECT_STREQ(param.string.data(), actual_string.data());
 }
diff --git a/src/Processors/Formats/Impl/NullFormat.cpp b/src/Processors/Formats/Impl/NullFormat.cpp
index 59514be9abc..4bd2249ac16 100644
--- a/src/Processors/Formats/Impl/NullFormat.cpp
+++ b/src/Processors/Formats/Impl/NullFormat.cpp
@@ -6,7 +6,9 @@
 namespace DB
 {
 
-WriteBuffer NullOutputFormat::empty_buffer(nullptr, 0);
+WriteBufferFromPointer NullOutputFormat::empty_buffer(nullptr, 0);
+
+NullOutputFormat::NullOutputFormat(const Block & header) : IOutputFormat(header, empty_buffer) {}
 
 void registerOutputFormatNull(FormatFactory & factory)
 {
diff --git a/src/Processors/Formats/Impl/NullFormat.h b/src/Processors/Formats/Impl/NullFormat.h
index 7aa9102790f..3362131c4d3 100644
--- a/src/Processors/Formats/Impl/NullFormat.h
+++ b/src/Processors/Formats/Impl/NullFormat.h
@@ -4,10 +4,12 @@
 namespace DB
 {
 
+class WriteBufferFromPointer;
+
 class NullOutputFormat final : public IOutputFormat
 {
 public:
-    explicit NullOutputFormat(const Block & header) : IOutputFormat(header, empty_buffer) {}
+    explicit NullOutputFormat(const Block & header);
 
     String getName() const override { return "Null"; }
 
@@ -15,7 +17,7 @@ protected:
     void consume(Chunk) override {}
 
 private:
-    static WriteBuffer empty_buffer;
+    static WriteBufferFromPointer empty_buffer;
 };
 
 }
diff --git a/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp b/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp
index 62ee4e4a48d..212a404825d 100644
--- a/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp
@@ -224,6 +224,7 @@ namespace DB
 
             /// Flush all the data to handmade buffer.
             formatter->flush();
+            out_buffer.finalize();
             unit.actual_memory_size = out_buffer.getActualSize();
 
             {
diff --git a/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.h b/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.h
index fddcd059be5..490f033b87e 100644
--- a/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.h
+++ b/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.h
@@ -87,6 +87,7 @@ public:
 
         NullWriteBuffer buf;
         save_totals_and_extremes_in_statistics = internal_formatter_creator(buf)->areTotalsAndExtremesUsedInFinalize();
+        buf.finalize();
 
         /// Just heuristic. We need one thread for collecting, one thread for receiving chunks
         /// and n threads for formatting.
diff --git a/src/Processors/Formats/LazyOutputFormat.cpp b/src/Processors/Formats/LazyOutputFormat.cpp
index 792d805eac3..4f6b10dd068 100644
--- a/src/Processors/Formats/LazyOutputFormat.cpp
+++ b/src/Processors/Formats/LazyOutputFormat.cpp
@@ -5,7 +5,7 @@
 namespace DB
 {
 
-WriteBuffer LazyOutputFormat::out(nullptr, 0);
+WriteBufferFromPointer LazyOutputFormat::out(nullptr, 0);
 
 Chunk LazyOutputFormat::getChunk(UInt64 milliseconds)
 {
diff --git a/src/Processors/Formats/LazyOutputFormat.h b/src/Processors/Formats/LazyOutputFormat.h
index b539a8494c7..9cf609ed2d7 100644
--- a/src/Processors/Formats/LazyOutputFormat.h
+++ b/src/Processors/Formats/LazyOutputFormat.h
@@ -57,7 +57,7 @@ private:
     Chunk extremes;
 
     /// Is not used.
-    static WriteBuffer out;
+    static WriteBufferFromPointer out;
 
     ProfileInfo info;
 };
diff --git a/src/Processors/Formats/PullingOutputFormat.cpp b/src/Processors/Formats/PullingOutputFormat.cpp
index c2036ce37c9..b2378e62d34 100644
--- a/src/Processors/Formats/PullingOutputFormat.cpp
+++ b/src/Processors/Formats/PullingOutputFormat.cpp
@@ -9,7 +9,12 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-WriteBuffer PullingOutputFormat::out(nullptr, 0);
+WriteBufferFromPointer PullingOutputFormat::out(nullptr, 0);
+
+PullingOutputFormat::PullingOutputFormat(const Block & header, std::atomic_bool & consume_data_flag_)
+    : IOutputFormat(header, out)
+    , has_data_flag(consume_data_flag_)
+{}
 
 void PullingOutputFormat::consume(Chunk chunk)
 {
diff --git a/src/Processors/Formats/PullingOutputFormat.h b/src/Processors/Formats/PullingOutputFormat.h
index a231b7679f3..a8efb8dd962 100644
--- a/src/Processors/Formats/PullingOutputFormat.h
+++ b/src/Processors/Formats/PullingOutputFormat.h
@@ -5,14 +5,13 @@
 namespace DB
 {
 
+class WriteBufferFromPointer;
+
 /// Output format which is used in PullingPipelineExecutor.
 class PullingOutputFormat : public IOutputFormat
 {
 public:
-    explicit PullingOutputFormat(const Block & header, std::atomic_bool & consume_data_flag_)
-        : IOutputFormat(header, out)
-        , has_data_flag(consume_data_flag_)
-    {}
+    PullingOutputFormat(const Block & header, std::atomic_bool & consume_data_flag_);
 
     String getName() const override { return "PullingOutputFormat"; }
 
@@ -41,7 +40,7 @@ private:
     ProfileInfo info;
 
     /// Is not used.
-    static WriteBuffer out;
+    static WriteBufferFromPointer out;
 };
 
 }
diff --git a/src/Storages/MergeTree/IMergeTreeDataPart.cpp b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
index 6a871c4bb5f..eb16fedb014 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPart.cpp
+++ b/src/Storages/MergeTree/IMergeTreeDataPart.cpp
@@ -138,7 +138,7 @@ IMergeTreeDataPart::MinMaxIndex::WrittenFiles IMergeTreeDataPart::MinMaxIndex::s
         HashingWriteBuffer out_hashing(*out);
         serialization->serializeBinary(hyperrectangle[i].left, out_hashing, {});
         serialization->serializeBinary(hyperrectangle[i].right, out_hashing, {});
-        out_hashing.next();
+        out_hashing.finalize();
         out_checksums.files[file_name].file_size = out_hashing.count();
         out_checksums.files[file_name].file_hash = out_hashing.getHash();
         out->preFinalize();
diff --git a/src/Storages/MergeTree/MergeTreeDataPartWriterCompact.cpp b/src/Storages/MergeTree/MergeTreeDataPartWriterCompact.cpp
index 0b650eb9f16..5e1da21da5b 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartWriterCompact.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartWriterCompact.cpp
@@ -276,14 +276,23 @@ void MergeTreeDataPartWriterCompact::fillDataChecksums(IMergeTreeDataPart::Check
         writeIntBinary(static_cast<UInt64>(0), marks_out);
     }
 
+    for (const auto & [_, stream] : streams_by_codec)
+    {
+        stream->hashing_buf.finalize();
+        stream->compressed_buf.finalize();
+    }
+
+    plain_hashing.finalize();
+
     plain_file->next();
 
     if (marks_source_hashing)
-        marks_source_hashing->next();
+        marks_source_hashing->finalize();
     if (marks_compressor)
-        marks_compressor->next();
+        marks_compressor->finalize();
+
+    marks_file_hashing->finalize();
 
-    marks_file_hashing->next();
     addToChecksums(checksums);
 
     plain_file->preFinalize();
@@ -292,14 +301,14 @@ void MergeTreeDataPartWriterCompact::fillDataChecksums(IMergeTreeDataPart::Check
 
 void MergeTreeDataPartWriterCompact::finishDataSerialization(bool sync)
 {
-    plain_file->finalize();
-    marks_file->finalize();
-
     if (sync)
     {
         plain_file->sync();
         marks_file->sync();
     }
+
+    plain_file->finalize();
+    marks_file->finalize();
 }
 
 static void fillIndexGranularityImpl(
diff --git a/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp b/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
index b0101bb962c..fc12255a323 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
@@ -13,17 +13,17 @@ namespace ErrorCodes
 
 void MergeTreeDataPartWriterOnDisk::Stream::preFinalize()
 {
-    compressed_hashing.next();
-    compressor.next();
-    plain_hashing.next();
+    compressed_hashing.finalize();
+    compressor.finalize();
+    plain_hashing.finalize();
 
     if (compress_marks)
     {
-        marks_compressed_hashing.next();
-        marks_compressor.next();
+        marks_compressed_hashing.finalize();
+        marks_compressor.finalize();
     }
 
-    marks_hashing.next();
+    marks_hashing.finalize();
 
     plain_file->preFinalize();
     marks_file->preFinalize();
@@ -347,9 +347,9 @@ void MergeTreeDataPartWriterOnDisk::fillPrimaryIndexChecksums(MergeTreeData::Dat
         }
 
         if (compress_primary_key)
-            index_source_hashing_stream->next();
+            index_source_hashing_stream->finalize();
 
-        index_file_hashing_stream->next();
+        index_file_hashing_stream->finalize();
 
         String index_name = "primary" + getIndexExtension(compress_primary_key);
         if (compress_primary_key)
diff --git a/src/Storages/MergeTree/MergeTreePartition.cpp b/src/Storages/MergeTree/MergeTreePartition.cpp
index 1626018f1c1..62ad658730e 100644
--- a/src/Storages/MergeTree/MergeTreePartition.cpp
+++ b/src/Storages/MergeTree/MergeTreePartition.cpp
@@ -435,9 +435,11 @@ std::unique_ptr<WriteBufferFromFileBase> MergeTreePartition::store(const Block &
         partition_key_sample.getByPosition(i).type->getDefaultSerialization()->serializeBinary(value[i], out_hashing, {});
     }
 
-    out_hashing.next();
+    out_hashing.finalize();
+
     checksums.files["partition.dat"].file_size = out_hashing.count();
     checksums.files["partition.dat"].file_hash = out_hashing.getHash();
+
     out->preFinalize();
     return out;
 }
diff --git a/src/Storages/MergeTree/MergedBlockOutputStream.cpp b/src/Storages/MergeTree/MergedBlockOutputStream.cpp
index c93ad135835..bfd9e92b4eb 100644
--- a/src/Storages/MergeTree/MergedBlockOutputStream.cpp
+++ b/src/Storages/MergeTree/MergedBlockOutputStream.cpp
@@ -201,7 +201,7 @@ MergedBlockOutputStream::WrittenFiles MergedBlockOutputStream::finalizePartOnDis
             auto count_out = new_part->getDataPartStorage().writeFile("count.txt", 4096, write_settings);
             HashingWriteBuffer count_out_hashing(*count_out);
             writeIntText(rows_count, count_out_hashing);
-            count_out_hashing.next();
+            count_out_hashing.finalize();
             checksums.files["count.txt"].file_size = count_out_hashing.count();
             checksums.files["count.txt"].file_hash = count_out_hashing.getHash();
             count_out->preFinalize();
@@ -215,6 +215,7 @@ MergedBlockOutputStream::WrittenFiles MergedBlockOutputStream::finalizePartOnDis
             auto out = new_part->getDataPartStorage().writeFile(IMergeTreeDataPart::UUID_FILE_NAME, 4096, write_settings);
             HashingWriteBuffer out_hashing(*out);
             writeUUIDText(new_part->uuid, out_hashing);
+            out_hashing.finalize();
             checksums.files[IMergeTreeDataPart::UUID_FILE_NAME].file_size = out_hashing.count();
             checksums.files[IMergeTreeDataPart::UUID_FILE_NAME].file_hash = out_hashing.getHash();
             out->preFinalize();
@@ -241,7 +242,7 @@ MergedBlockOutputStream::WrittenFiles MergedBlockOutputStream::finalizePartOnDis
             auto count_out = new_part->getDataPartStorage().writeFile("count.txt", 4096, write_settings);
             HashingWriteBuffer count_out_hashing(*count_out);
             writeIntText(rows_count, count_out_hashing);
-            count_out_hashing.next();
+            count_out_hashing.finalize();
             checksums.files["count.txt"].file_size = count_out_hashing.count();
             checksums.files["count.txt"].file_hash = count_out_hashing.getHash();
             count_out->preFinalize();
@@ -255,6 +256,7 @@ MergedBlockOutputStream::WrittenFiles MergedBlockOutputStream::finalizePartOnDis
         auto out = new_part->getDataPartStorage().writeFile("ttl.txt", 4096, write_settings);
         HashingWriteBuffer out_hashing(*out);
         new_part->ttl_infos.write(out_hashing);
+        out_hashing.finalize();
         checksums.files["ttl.txt"].file_size = out_hashing.count();
         checksums.files["ttl.txt"].file_hash = out_hashing.getHash();
         out->preFinalize();
@@ -266,6 +268,7 @@ MergedBlockOutputStream::WrittenFiles MergedBlockOutputStream::finalizePartOnDis
         auto out = new_part->getDataPartStorage().writeFile(IMergeTreeDataPart::SERIALIZATION_FILE_NAME, 4096, write_settings);
         HashingWriteBuffer out_hashing(*out);
         new_part->getSerializationInfos().writeJSON(out_hashing);
+        out_hashing.finalize();
         checksums.files[IMergeTreeDataPart::SERIALIZATION_FILE_NAME].file_size = out_hashing.count();
         checksums.files[IMergeTreeDataPart::SERIALIZATION_FILE_NAME].file_hash = out_hashing.getHash();
         out->preFinalize();

From d21fc22607fb29fe5cce608eecd0d980f7ab160f Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Fri, 2 Jun 2023 15:50:35 +0200
Subject: [PATCH 511/722] fix 02428_combinators_with_over_statement

---
 src/IO/WriteBufferFromArena.h | 4 ++++
 tests/clickhouse-test         | 5 ++++-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/IO/WriteBufferFromArena.h b/src/IO/WriteBufferFromArena.h
index 8445307d179..8e9276496b5 100644
--- a/src/IO/WriteBufferFromArena.h
+++ b/src/IO/WriteBufferFromArena.h
@@ -63,6 +63,10 @@ private:
         internalBuffer() = Buffer(const_cast<char *>(begin), end);
         buffer() = Buffer(continuation, end);
     }
+
+    /// it is super strange,
+    /// but addition next call changes the data in serializeValueIntoArena result
+    virtual void finalizeImpl() override { /* no op */ }
 };
 
 }
diff --git a/tests/clickhouse-test b/tests/clickhouse-test
index 9242ca8a0b0..82aa3639179 100755
--- a/tests/clickhouse-test
+++ b/tests/clickhouse-test
@@ -992,7 +992,10 @@ class TestCase:
 
                 if os.path.isfile(self.stdout_file):
                     description += ", result:\n\n"
-                    description += trim_for_log(open(self.stdout_file).read())
+                    with open(self.stdout_file, "rb") as f:
+                        description += trim_for_log(
+                            f.read().decode("utf-8", errors="ignore")
+                        )
                     description += "\n"
 
                 description += f"\nstdout:\n{stdout}\n"

From b428f88f228cbe948f78815c1a67c20e29f98818 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Sat, 3 Jun 2023 21:01:28 +0200
Subject: [PATCH 512/722] finalize hashing buffer

---
 src/Storages/MergeTree/DataPartsExchange.cpp | 2 ++
 src/Storages/MergeTree/MutateTask.cpp        | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/src/Storages/MergeTree/DataPartsExchange.cpp b/src/Storages/MergeTree/DataPartsExchange.cpp
index 357d48ae466..23bbc1c7f9d 100644
--- a/src/Storages/MergeTree/DataPartsExchange.cpp
+++ b/src/Storages/MergeTree/DataPartsExchange.cpp
@@ -325,6 +325,7 @@ MergeTreeData::DataPart::Checksums Service::sendPartFromDisk(
         auto file_in = desc.input_buffer_getter();
         HashingWriteBuffer hashing_out(out);
         copyDataWithThrottler(*file_in, hashing_out, blocker.getCounter(), data.getSendsThrottler());
+        hashing_out.finalize();
 
         if (blocker.isCancelled())
             throw Exception(ErrorCodes::ABORTED, "Transferring part to replica was cancelled");
@@ -779,6 +780,7 @@ void Fetcher::downloadBaseOrProjectionPartToDisk(
         written_files.emplace_back(output_buffer_getter(*data_part_storage, file_name, file_size));
         HashingWriteBuffer hashing_out(*written_files.back());
         copyDataWithThrottler(in, hashing_out, file_size, blocker.getCounter(), throttler);
+        hashing_out.finalize();
 
         if (blocker.isCancelled())
         {
diff --git a/src/Storages/MergeTree/MutateTask.cpp b/src/Storages/MergeTree/MutateTask.cpp
index f588530a2ca..b98b0844ee7 100644
--- a/src/Storages/MergeTree/MutateTask.cpp
+++ b/src/Storages/MergeTree/MutateTask.cpp
@@ -706,6 +706,7 @@ void finalizeMutatedPart(
         auto out = new_data_part->getDataPartStorage().writeFile(IMergeTreeDataPart::UUID_FILE_NAME, 4096, context->getWriteSettings());
         HashingWriteBuffer out_hashing(*out);
         writeUUIDText(new_data_part->uuid, out_hashing);
+        out_hashing.finalize();
         new_data_part->checksums.files[IMergeTreeDataPart::UUID_FILE_NAME].file_size = out_hashing.count();
         new_data_part->checksums.files[IMergeTreeDataPart::UUID_FILE_NAME].file_hash = out_hashing.getHash();
         written_files.push_back(std::move(out));
@@ -717,6 +718,7 @@ void finalizeMutatedPart(
         auto out_ttl = new_data_part->getDataPartStorage().writeFile("ttl.txt", 4096, context->getWriteSettings());
         HashingWriteBuffer out_hashing(*out_ttl);
         new_data_part->ttl_infos.write(out_hashing);
+        out_hashing.finalize();
         new_data_part->checksums.files["ttl.txt"].file_size = out_hashing.count();
         new_data_part->checksums.files["ttl.txt"].file_hash = out_hashing.getHash();
         written_files.push_back(std::move(out_ttl));
@@ -727,6 +729,7 @@ void finalizeMutatedPart(
         auto out_serialization = new_data_part->getDataPartStorage().writeFile(IMergeTreeDataPart::SERIALIZATION_FILE_NAME, 4096, context->getWriteSettings());
         HashingWriteBuffer out_hashing(*out_serialization);
         new_data_part->getSerializationInfos().writeJSON(out_hashing);
+        out_hashing.finalize();
         new_data_part->checksums.files[IMergeTreeDataPart::SERIALIZATION_FILE_NAME].file_size = out_hashing.count();
         new_data_part->checksums.files[IMergeTreeDataPart::SERIALIZATION_FILE_NAME].file_hash = out_hashing.getHash();
         written_files.push_back(std::move(out_serialization));

From cf31fdb4d5c1cc7d887d4d1cd46d8aacbf9f0991 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Wed, 14 Jun 2023 15:33:01 +0200
Subject: [PATCH 513/722] no finalize at d-tor in compression

---
 src/Client/ClientBase.cpp           |  4 ++--
 src/Functions/addressToLine.cpp     |  1 +
 src/IO/BrotliWriteBuffer.cpp        |  5 +----
 src/IO/Bzip2WriteBuffer.cpp         |  5 +----
 src/IO/LZMADeflatingWriteBuffer.cpp |  5 +----
 src/IO/Lz4DeflatingWriteBuffer.cpp  |  5 +----
 src/IO/WriteBuffer.h                |  2 +-
 src/IO/ZlibDeflatingWriteBuffer.cpp | 12 +-----------
 src/IO/ZstdDeflatingWriteBuffer.cpp |  5 +----
 src/Server/HTTPHandler.cpp          |  6 ++++++
 10 files changed, 16 insertions(+), 34 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 6f295c11070..52c1175fb3e 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1179,13 +1179,13 @@ void ClientBase::resetOutput()
 
     if (out_file_buf)
     {
-        out_file_buf->next();
+        out_file_buf->finalize();
         out_file_buf.reset();
     }
 
     if (out_logs_buf)
     {
-        out_logs_buf->next();
+        out_logs_buf->finalize();
         out_logs_buf.reset();
     }
 
diff --git a/src/Functions/addressToLine.cpp b/src/Functions/addressToLine.cpp
index 42f9be23c38..771c85cabf6 100644
--- a/src/Functions/addressToLine.cpp
+++ b/src/Functions/addressToLine.cpp
@@ -52,6 +52,7 @@ protected:
         writeChar(':', out);
         writeIntText(location.line, out);
 
+        out.finalize();
         result = out.complete();
     }
 };
diff --git a/src/IO/BrotliWriteBuffer.cpp b/src/IO/BrotliWriteBuffer.cpp
index 47426d62a6e..a19c6770dad 100644
--- a/src/IO/BrotliWriteBuffer.cpp
+++ b/src/IO/BrotliWriteBuffer.cpp
@@ -42,10 +42,7 @@ BrotliWriteBuffer::BrotliWriteBuffer(std::unique_ptr<WriteBuffer> out_, int comp
     BrotliEncoderSetParameter(brotli->state, BROTLI_PARAM_LGWIN, 24);
 }
 
-BrotliWriteBuffer::~BrotliWriteBuffer()
-{
-    finalize();
-}
+BrotliWriteBuffer::~BrotliWriteBuffer() = default;
 
 void BrotliWriteBuffer::nextImpl()
 {
diff --git a/src/IO/Bzip2WriteBuffer.cpp b/src/IO/Bzip2WriteBuffer.cpp
index 4b6bed70d35..b84cbdd1e41 100644
--- a/src/IO/Bzip2WriteBuffer.cpp
+++ b/src/IO/Bzip2WriteBuffer.cpp
@@ -45,10 +45,7 @@ Bzip2WriteBuffer::Bzip2WriteBuffer(std::unique_ptr<WriteBuffer> out_, int compre
 {
 }
 
-Bzip2WriteBuffer::~Bzip2WriteBuffer()
-{
-    finalize();
-}
+Bzip2WriteBuffer::~Bzip2WriteBuffer() = default;
 
 void Bzip2WriteBuffer::nextImpl()
 {
diff --git a/src/IO/LZMADeflatingWriteBuffer.cpp b/src/IO/LZMADeflatingWriteBuffer.cpp
index 30e247b1016..c70ec1507cb 100644
--- a/src/IO/LZMADeflatingWriteBuffer.cpp
+++ b/src/IO/LZMADeflatingWriteBuffer.cpp
@@ -44,10 +44,7 @@ LZMADeflatingWriteBuffer::LZMADeflatingWriteBuffer(
             LZMA_VERSION_STRING);
 }
 
-LZMADeflatingWriteBuffer::~LZMADeflatingWriteBuffer()
-{
-    finalize();
-}
+LZMADeflatingWriteBuffer::~LZMADeflatingWriteBuffer() = default;
 
 void LZMADeflatingWriteBuffer::nextImpl()
 {
diff --git a/src/IO/Lz4DeflatingWriteBuffer.cpp b/src/IO/Lz4DeflatingWriteBuffer.cpp
index c3a1b8282c3..27c945f92cf 100644
--- a/src/IO/Lz4DeflatingWriteBuffer.cpp
+++ b/src/IO/Lz4DeflatingWriteBuffer.cpp
@@ -40,10 +40,7 @@ Lz4DeflatingWriteBuffer::Lz4DeflatingWriteBuffer(
             LZ4F_VERSION);
 }
 
-Lz4DeflatingWriteBuffer::~Lz4DeflatingWriteBuffer()
-{
-    finalize();
-}
+Lz4DeflatingWriteBuffer::~Lz4DeflatingWriteBuffer() = default;
 
 void Lz4DeflatingWriteBuffer::nextImpl()
 {
diff --git a/src/IO/WriteBuffer.h b/src/IO/WriteBuffer.h
index 9d74eecaec9..4093384f9a2 100644
--- a/src/IO/WriteBuffer.h
+++ b/src/IO/WriteBuffer.h
@@ -78,7 +78,7 @@ public:
                 Poco::Logger * log = &Poco::Logger::get("WriteBuffer");
                 LOG_ERROR(
                     log,
-                    "WriteBufferFromS3 is not finalized in destructor. "
+                    "WriteBuffer is not finalized in destructor. "
                     "No exceptions in flight are detected. "
                     "The file might not be written at all or might be truncated. "
                     "Stack trace: {}",
diff --git a/src/IO/ZlibDeflatingWriteBuffer.cpp b/src/IO/ZlibDeflatingWriteBuffer.cpp
index 43bb0405555..5455adcb7c9 100644
--- a/src/IO/ZlibDeflatingWriteBuffer.cpp
+++ b/src/IO/ZlibDeflatingWriteBuffer.cpp
@@ -72,17 +72,7 @@ void ZlibDeflatingWriteBuffer::nextImpl()
     }
 }
 
-ZlibDeflatingWriteBuffer::~ZlibDeflatingWriteBuffer()
-{
-    try
-    {
-        finalize();
-    }
-    catch (...)
-    {
-        tryLogCurrentException(__PRETTY_FUNCTION__);
-    }
-}
+ZlibDeflatingWriteBuffer::~ZlibDeflatingWriteBuffer() = default;
 
 void ZlibDeflatingWriteBuffer::finalizeBefore()
 {
diff --git a/src/IO/ZstdDeflatingWriteBuffer.cpp b/src/IO/ZstdDeflatingWriteBuffer.cpp
index c6d2ffc39f9..295b933dbc4 100644
--- a/src/IO/ZstdDeflatingWriteBuffer.cpp
+++ b/src/IO/ZstdDeflatingWriteBuffer.cpp
@@ -31,10 +31,7 @@ ZstdDeflatingWriteBuffer::ZstdDeflatingWriteBuffer(
 }
 
 
-ZstdDeflatingWriteBuffer::~ZstdDeflatingWriteBuffer()
-{
-    finalize();
-}
+ZstdDeflatingWriteBuffer::~ZstdDeflatingWriteBuffer() = default;
 
 void ZstdDeflatingWriteBuffer::nextImpl()
 {
diff --git a/src/Server/HTTPHandler.cpp b/src/Server/HTTPHandler.cpp
index 5a2bf0bad6c..e185b002c5b 100644
--- a/src/Server/HTTPHandler.cpp
+++ b/src/Server/HTTPHandler.cpp
@@ -900,7 +900,13 @@ try
     {
         /// Destroy CascadeBuffer to actualize buffers' positions and reset extra references
         if (used_output.hasDelayed())
+        {
+            if (used_output.out_maybe_delayed_and_compressed)
+            {
+                used_output.out_maybe_delayed_and_compressed->finalize();
+            }
             used_output.out_maybe_delayed_and_compressed.reset();
+        }
 
         /// Send the error message into already used (and possibly compressed) stream.
         /// Note that the error message will possibly be sent after some data.

From 47484faace2a844c7495dc613ba1e10173545961 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Fri, 16 Jun 2023 16:34:50 +0200
Subject: [PATCH 514/722] do abort/cancel/deletion merge/mutate task with
 exception context

---
 src/IO/HashingWriteBuffer.h                   |   1 -
 src/IO/WriteBuffer.cpp                        |  33 +++++
 src/IO/WriteBuffer.h                          |  26 +---
 src/IO/WriteBufferFromFileBase.h              |   1 -
 .../MergeTree/MergePlainMergeTreeTask.cpp     |   1 -
 .../MergeTree/MergeTreeBackgroundExecutor.cpp | 139 ++++++++++--------
 .../MergeTreeDataPartWriterOnDisk.cpp         |   3 +
 .../MergeTree/MergedBlockOutputStream.h       |   1 -
 .../MergeTree/MutatePlainMergeTreeTask.cpp    |   1 -
 9 files changed, 117 insertions(+), 89 deletions(-)
 create mode 100644 src/IO/WriteBuffer.cpp

diff --git a/src/IO/HashingWriteBuffer.h b/src/IO/HashingWriteBuffer.h
index a201d0dab4d..8edfa45a6be 100644
--- a/src/IO/HashingWriteBuffer.h
+++ b/src/IO/HashingWriteBuffer.h
@@ -85,7 +85,6 @@ public:
     uint128 getHash()
     {
         next();
-        chassert(finalized);
         return IHashingBuffer<WriteBuffer>::getHash();
     }
 };
diff --git a/src/IO/WriteBuffer.cpp b/src/IO/WriteBuffer.cpp
new file mode 100644
index 00000000000..61fdd31e16a
--- /dev/null
+++ b/src/IO/WriteBuffer.cpp
@@ -0,0 +1,33 @@
+#include "WriteBuffer.h"
+
+#include <Common/logger_useful.h>
+
+namespace DB
+{
+
+/// Calling finalize() in the destructor of derived classes is a bad practice.
+/// This causes objects to be left on the remote FS when a write operation is rolled back.
+/// Do call finalize() explicitly, before this call you have no guarantee that the file has been written
+WriteBuffer::~WriteBuffer()
+{
+    // That destructor could be call with finalized=false in case of exceptions
+    if (count() > 0 && !finalized)
+    {
+        /// It is totally OK to destroy instance without finalization when an exception occurs
+        /// However it is suspicious to destroy instance without finalization at the green path
+        if (!std::uncaught_exceptions() && std::current_exception() == nullptr)
+        {
+            Poco::Logger * log = &Poco::Logger::get("WriteBuffer");
+            LOG_ERROR(
+                log,
+                "WriteBuffer is not finalized when destructor is called. "
+                "No exceptions in flight are detected. "
+                "The file might not be written at all or might be truncated. "
+                "Stack trace: {}",
+                StackTrace().toString());
+            chassert(false && "WriteBuffer is not finalized in destructor.");
+        }
+    }
+}
+
+}
diff --git a/src/IO/WriteBuffer.h b/src/IO/WriteBuffer.h
index 4093384f9a2..ea032302235 100644
--- a/src/IO/WriteBuffer.h
+++ b/src/IO/WriteBuffer.h
@@ -8,7 +8,6 @@
 
 #include <Common/Exception.h>
 #include <Common/LockMemoryExceptionInThread.h>
-#include <Common/logger_useful.h>
 #include <IO/BufferBase.h>
 
 
@@ -64,28 +63,7 @@ public:
     }
 
     /// Calling finalize() in the destructor of derived classes is a bad practice.
-    /// This causes objects to be left on the remote FS when a write operation is rolled back.
-    /// Do call finalize() explicitly, before this call you have no guarantee that the file has been written
-    virtual ~WriteBuffer()
-    {
-        // That destructor could be call with finalized=false in case of exceptions
-        if (count() > 0 && !finalized)
-        {
-            /// It is totally OK to destroy instance without finalization when an exception occurs
-            /// However it is suspicious to destroy instance without finalization at the green path
-            if (!std::uncaught_exceptions())
-            {
-                Poco::Logger * log = &Poco::Logger::get("WriteBuffer");
-                LOG_ERROR(
-                    log,
-                    "WriteBuffer is not finalized in destructor. "
-                    "No exceptions in flight are detected. "
-                    "The file might not be written at all or might be truncated. "
-                    "Stack trace: {}",
-                    StackTrace().toString());
-            }
-        }
-    }
+    virtual ~WriteBuffer();
 
     inline void nextIfAtEnd()
     {
@@ -114,7 +92,6 @@ public:
         }
     }
 
-
     inline void write(char x)
     {
         if (finalized)
@@ -140,7 +117,6 @@ public:
         if (finalized)
             return;
 
-        /// finalize() is often called from destructors.
         LockMemoryExceptionInThread lock(VariableContext::Global);
         try
         {
diff --git a/src/IO/WriteBufferFromFileBase.h b/src/IO/WriteBufferFromFileBase.h
index d35b69a7df7..d6e2144bccf 100644
--- a/src/IO/WriteBufferFromFileBase.h
+++ b/src/IO/WriteBufferFromFileBase.h
@@ -13,7 +13,6 @@ class WriteBufferFromFileBase : public BufferWithOwnMemory<WriteBuffer>
 {
 public:
     WriteBufferFromFileBase(size_t buf_size, char * existing_memory, size_t alignment);
-    ~WriteBufferFromFileBase() override = default;
 
     void sync() override = 0;
     virtual std::string getFileName() const = 0;
diff --git a/src/Storages/MergeTree/MergePlainMergeTreeTask.cpp b/src/Storages/MergeTree/MergePlainMergeTreeTask.cpp
index 871672c442b..9302bdf11de 100644
--- a/src/Storages/MergeTree/MergePlainMergeTreeTask.cpp
+++ b/src/Storages/MergeTree/MergePlainMergeTreeTask.cpp
@@ -27,7 +27,6 @@ void MergePlainMergeTreeTask::onCompleted()
     task_result_callback(delay);
 }
 
-
 bool MergePlainMergeTreeTask::executeStep()
 {
     /// All metrics will be saved in the thread_group, including all scheduled tasks.
diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index 6512aad9260..bbb3373ec07 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -177,47 +177,50 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
         active.erase(std::remove(active.begin(), active.end(), item), active.end());
     };
 
-    bool need_execute_again = false;
-
-    try
+    auto print_task_exception = [&]()
     {
-        ALLOW_ALLOCATIONS_IN_SCOPE;
-        need_execute_again = item->task->executeStep();
-    }
-    catch (const Exception & e)
-    {
-        NOEXCEPT_SCOPE({
-            ALLOW_ALLOCATIONS_IN_SCOPE;
-            if (e.code() == ErrorCodes::ABORTED)    /// Cancelled merging parts is not an error - log as info.
-                LOG_INFO(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
-            else
-                tryLogCurrentException(__PRETTY_FUNCTION__);
-        });
-    }
-    catch (...)
-    {
-        NOEXCEPT_SCOPE({
-            ALLOW_ALLOCATIONS_IN_SCOPE;
-            tryLogCurrentException(__PRETTY_FUNCTION__);
-        });
-    }
-
-    if (need_execute_again)
-    {
-        std::lock_guard guard(mutex);
-        erase_from_active();
-
-        if (item->is_currently_deleting)
+        std::exception_ptr ex = std::current_exception();
+        try
+        {
+            std::rethrow_exception(ex);
+        }
+        catch (const Exception & e)
         {
             NOEXCEPT_SCOPE({
                 ALLOW_ALLOCATIONS_IN_SCOPE;
-                item->task.reset();
+                /// Cancelled merging parts is not an error - log as info.
+                if (e.code() == ErrorCodes::ABORTED)
+                    LOG_INFO(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
+                else
+                    tryLogCurrentException(__PRETTY_FUNCTION__);
             });
-            item->is_done.set();
-            item = nullptr;
-            return;
         }
+        catch (...)
+        {
+            NOEXCEPT_SCOPE({
+                ALLOW_ALLOCATIONS_IN_SCOPE;
+                tryLogCurrentException(__PRETTY_FUNCTION__);
+            });
+        }
+    };
 
+    auto on_task_done = [&]() TSA_REQUIRES(mutex)
+    {
+        /// We have to call reset() under a lock, otherwise a race is possible.
+        /// Imagine, that task is finally completed (last execution returned false),
+        /// we removed the task from both queues, but still have pointer.
+        /// The thread that shutdowns storage will scan queues in order to find some tasks to wait for, but will find nothing.
+        /// So, the destructor of a task and the destructor of a storage will be executed concurrently.
+        NOEXCEPT_SCOPE({
+            ALLOW_ALLOCATIONS_IN_SCOPE;
+            item->task.reset();
+        });
+        item->is_done.set();
+        item = nullptr;
+    };
+
+    auto on_task_restart = [&]() TSA_REQUIRES(mutex)
+    {
         /// After the `guard` destruction `item` has to be in moved from state
         /// Not to own the object it points to.
         /// Otherwise the destruction of the task won't be ordered with the destruction of the
@@ -226,8 +229,9 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
         has_tasks.notify_one();
         item = nullptr;
         return;
-    }
+    };
 
+    auto release_task = [&]()
     {
         std::lock_guard guard(mutex);
         erase_from_active();
@@ -241,39 +245,56 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
             /// But it is rather safe, because we have try...catch block here, and another one in ThreadPool.
             item->task->onCompleted();
         }
-        catch (const Exception & e)
-        {
-            NOEXCEPT_SCOPE({
-                ALLOW_ALLOCATIONS_IN_SCOPE;
-                if (e.code() == ErrorCodes::ABORTED)    /// Cancelled merging parts is not an error - log as info.
-                    LOG_INFO(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
-                else
-                    tryLogCurrentException(__PRETTY_FUNCTION__);
-            });
-        }
         catch (...)
         {
-            NOEXCEPT_SCOPE({
-                ALLOW_ALLOCATIONS_IN_SCOPE;
-                tryLogCurrentException(__PRETTY_FUNCTION__);
-            });
+            print_task_exception();
         }
 
+        return on_task_done();
+    };
 
-        /// We have to call reset() under a lock, otherwise a race is possible.
-        /// Imagine, that task is finally completed (last execution returned false),
-        /// we removed the task from both queues, but still have pointer.
-        /// The thread that shutdowns storage will scan queues in order to find some tasks to wait for, but will find nothing.
-        /// So, the destructor of a task and the destructor of a storage will be executed concurrently.
+    bool need_execute_again = false;
+
+    try
+    {
+        ALLOW_ALLOCATIONS_IN_SCOPE;
+        need_execute_again = item->task->executeStep();
+    }
+    catch (...)
+    {
+        print_task_exception();
+        /// Release the task with exception context.
+        /// An exception context is needed to proper delete write buffers without finalization
+        release_task();
+        return;
+    }
+
+    if (!need_execute_again)
+    {
+        release_task();
+        return;
+    }
+
+    {
+        std::lock_guard guard(mutex);
+        erase_from_active();
+
+        if (item->is_currently_deleting)
         {
-            NOEXCEPT_SCOPE({
+            try
+            {
                 ALLOW_ALLOCATIONS_IN_SCOPE;
-                item->task.reset();
-            });
+                /// An exception context is needed to proper delete write buffers without finalization
+                throw Exception(ErrorCodes::ABORTED, "Storage is about to be deleted. Done task as if it was aborted.");
+            }
+            catch (...)
+            {
+                print_task_exception();
+                return on_task_done();
+            }
         }
 
-        item->is_done.set();
-        item = nullptr;
+        on_task_restart();
     }
 }
 
diff --git a/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp b/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
index fc12255a323..a28778b6fff 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
@@ -347,7 +347,10 @@ void MergeTreeDataPartWriterOnDisk::fillPrimaryIndexChecksums(MergeTreeData::Dat
         }
 
         if (compress_primary_key)
+        {
             index_source_hashing_stream->finalize();
+            index_compressor_stream->finalize();
+        }
 
         index_file_hashing_stream->finalize();
 
diff --git a/src/Storages/MergeTree/MergedBlockOutputStream.h b/src/Storages/MergeTree/MergedBlockOutputStream.h
index f3a5653a880..20e6de5a99b 100644
--- a/src/Storages/MergeTree/MergedBlockOutputStream.h
+++ b/src/Storages/MergeTree/MergedBlockOutputStream.h
@@ -48,7 +48,6 @@ public:
         Finalizer & operator=(Finalizer &&) noexcept;
         ~Finalizer();
 
-
         void finish();
     };
 
diff --git a/src/Storages/MergeTree/MutatePlainMergeTreeTask.cpp b/src/Storages/MergeTree/MutatePlainMergeTreeTask.cpp
index 04effdb8894..3180431d31b 100644
--- a/src/Storages/MergeTree/MutatePlainMergeTreeTask.cpp
+++ b/src/Storages/MergeTree/MutatePlainMergeTreeTask.cpp
@@ -24,7 +24,6 @@ void MutatePlainMergeTreeTask::onCompleted()
     task_result_callback(delay);
 }
 
-
 void MutatePlainMergeTreeTask::prepare()
 {
     future_part = merge_mutate_entry->future_part;

From 841d58f6babb7b6b21a425696264d2c9dfbdc422 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Fri, 16 Jun 2023 16:58:01 +0200
Subject: [PATCH 515/722] Small fix in `MergeTreePrefetchedReadPool`

---
 src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp b/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp
index 63a205a1a61..97586346c8f 100644
--- a/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp
+++ b/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp
@@ -494,7 +494,7 @@ MergeTreePrefetchedReadPool::ThreadsTasks MergeTreePrefetchedReadPool::createThr
     ThreadsTasks result_threads_tasks;
     for (size_t i = 0, part_idx = 0; i < threads && part_idx < parts_infos.size(); ++i)
     {
-        auto need_marks = min_marks_per_thread;
+        ssize_t need_marks = min_marks_per_thread;
 
         /// Priority is given according to the prefetch number for each thread,
         /// e.g. the first task of each thread has the same priority and is greater
@@ -515,7 +515,7 @@ MergeTreePrefetchedReadPool::ThreadsTasks MergeTreePrefetchedReadPool::createThr
             }
 
             MarkRanges ranges_to_get_from_part;
-            size_t marks_to_get_from_part = std::min(need_marks, marks_in_part);
+            size_t marks_to_get_from_part = std::min<size_t>(need_marks, marks_in_part);
 
             /// Split by prefetch step even if !allow_prefetch below. Because it will allow
             /// to make a better distribution of tasks which did not fill into memory limit

From 6b49968bc4bceb4865217d8259ea3c970d65176f Mon Sep 17 00:00:00 2001
From: Salvatore Mesoraca <salvatore.mesoraca@aiven.io>
Date: Fri, 16 Jun 2023 17:08:20 +0200
Subject: [PATCH 516/722] Generate safe IVs

IVs should never be re-used when using CTR.
The previous implementation had a 50% probability to generate
an IV that was already used after 65536 generations.
This happens because std::mt19937 is seeded using a 32bit integer
and returns a 32 bits integer.
Because of the birthday problem, collisions have a 50% chance after
only 2^16 IV's generations.
CH uses one IV per file and, for most use cases, 65k files are
not as many as they seem.
Also, the initial entropy is gathered using std::random_device
which is "best-effort" and it's allowed by the standard to
return a fixed sequence of numbers.
---
 src/IO/FileEncryptionCommon.cpp | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/src/IO/FileEncryptionCommon.cpp b/src/IO/FileEncryptionCommon.cpp
index 5529c813c40..6f4db4975f7 100644
--- a/src/IO/FileEncryptionCommon.cpp
+++ b/src/IO/FileEncryptionCommon.cpp
@@ -8,10 +8,11 @@
 #include <Common/SipHash.h>
 #include <Common/safe_cast.h>
 
-#include <boost/algorithm/string/predicate.hpp>
-#include <cassert>
-#include <random>
+#    include <cassert>
+#    include <boost/algorithm/string/predicate.hpp>
 
+#    include <openssl/err.h>
+#    include <openssl/rand.h>
 
 namespace DB
 {
@@ -20,6 +21,7 @@ namespace ErrorCodes
 {
     extern const int BAD_ARGUMENTS;
     extern const int DATA_ENCRYPTION_ERROR;
+    extern const int OPENSSL_ERROR;
 }
 
 namespace FileEncryption
@@ -260,12 +262,11 @@ void InitVector::write(WriteBuffer & out) const
 
 InitVector InitVector::random()
 {
-    std::random_device rd;
-    std::mt19937 gen{rd()};
-    std::uniform_int_distribution<UInt128::base_type> dis;
     UInt128 counter;
-    for (auto & i : counter.items)
-        i = dis(gen);
+    auto * buf = reinterpret_cast<unsigned char *>(counter.items);
+    auto ret = RAND_bytes(buf, sizeof(counter.items));
+    if (ret != 1)
+        throw Exception(DB::ErrorCodes::OPENSSL_ERROR, "OpenSSL error code: {}", ERR_get_error());
     return InitVector{counter};
 }
 

From 3209ebe34bd6f3a2ee8609afef6f84c9055b4ab0 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 16 Jun 2023 15:51:18 +0000
Subject: [PATCH 517/722] Improve progress bar for file/s3/hdfs/url table
 functions. Step 1

---
 src/IO/WithFileSize.cpp                       | 32 +++++++++++++++++++
 src/IO/WithFileSize.h                         |  5 +++
 src/Processors/Formats/IInputFormat.h         |  2 ++
 src/Processors/Formats/IRowInputFormat.cpp    |  2 ++
 src/Processors/Formats/IRowInputFormat.h      |  3 ++
 .../Formats/Impl/ArrowBlockInputFormat.cpp    |  7 +++-
 .../Formats/Impl/ArrowBlockInputFormat.h      |  3 ++
 .../Impl/JSONColumnsBlockInputFormatBase.cpp  |  3 ++
 .../Impl/JSONColumnsBlockInputFormatBase.h    |  3 ++
 src/Processors/Formats/Impl/NativeFormat.cpp  |  6 ++++
 .../Formats/Impl/ORCBlockInputFormat.cpp      |  1 +
 .../Formats/Impl/ORCBlockInputFormat.h        |  3 ++
 .../Impl/ParallelParsingInputFormat.cpp       |  8 +++++
 .../Formats/Impl/ParallelParsingInputFormat.h |  5 +++
 .../Formats/Impl/ParquetBlockInputFormat.cpp  |  7 +++-
 .../Formats/Impl/ParquetBlockInputFormat.h    |  7 ++++
 .../Formats/Impl/ValuesBlockInputFormat.cpp   |  3 ++
 .../Formats/Impl/ValuesBlockInputFormat.h     |  2 ++
 src/Storages/HDFS/StorageHDFS.cpp             | 24 ++++++++++++--
 src/Storages/HDFS/StorageHDFS.h               |  9 ++++++
 src/Storages/ReadFromStorageProgress.cpp      |  7 ++--
 src/Storages/ReadFromStorageProgress.h        |  3 +-
 src/Storages/StorageAzureBlob.cpp             | 23 ++++++++++---
 src/Storages/StorageAzureBlob.h               |  9 ++++++
 src/Storages/StorageFile.cpp                  | 26 +++++++++++----
 src/Storages/StorageS3.cpp                    | 22 ++++++++++---
 src/Storages/StorageS3.h                      |  9 ++++++
 src/Storages/StorageURL.cpp                   | 22 ++++++++++---
 src/Storages/StorageURL.h                     |  2 ++
 29 files changed, 230 insertions(+), 28 deletions(-)

diff --git a/src/IO/WithFileSize.cpp b/src/IO/WithFileSize.cpp
index 28542db7a73..3660d962c08 100644
--- a/src/IO/WithFileSize.cpp
+++ b/src/IO/WithFileSize.cpp
@@ -3,6 +3,7 @@
 #include <IO/CompressedReadBufferWrapper.h>
 #include <IO/ParallelReadBuffer.h>
 #include <IO/ReadBufferFromFileDecorator.h>
+#include <IO/PeekableReadBuffer.h>
 
 namespace DB
 {
@@ -37,6 +38,18 @@ size_t getFileSizeFromReadBuffer(ReadBuffer & in)
     return getFileSize(in);
 }
 
+std::optional<size_t> tryGetFileSizeFromReadBuffer(ReadBuffer & in)
+{
+    try
+    {
+        return getFileSizeFromReadBuffer(in);
+    }
+    catch (...)
+    {
+        return std::nullopt;
+    }
+}
+
 bool isBufferWithFileSize(const ReadBuffer & in)
 {
     if (const auto * delegate = dynamic_cast<const ReadBufferFromFileDecorator *>(&in))
@@ -51,4 +64,23 @@ bool isBufferWithFileSize(const ReadBuffer & in)
     return dynamic_cast<const WithFileSize *>(&in) != nullptr;
 }
 
+size_t getDataOffsetMaybeCompressed(const ReadBuffer & in)
+{
+    if (const auto * delegate = dynamic_cast<const ReadBufferFromFileDecorator *>(&in))
+    {
+        return getDataOffsetMaybeCompressed(delegate->getWrappedReadBuffer());
+    }
+    else if (const auto * compressed = dynamic_cast<const CompressedReadBufferWrapper *>(&in))
+    {
+        return getDataOffsetMaybeCompressed(compressed->getWrappedReadBuffer());
+    }
+    else if (const auto * peekable = dynamic_cast<const PeekableReadBuffer *>(&in))
+    {
+        return getDataOffsetMaybeCompressed(peekable->getSubBuffer());
+    }
+
+    return in.count();
+}
+
+
 }
diff --git a/src/IO/WithFileSize.h b/src/IO/WithFileSize.h
index 060626faed2..0ae3af98ea0 100644
--- a/src/IO/WithFileSize.h
+++ b/src/IO/WithFileSize.h
@@ -18,4 +18,9 @@ bool isBufferWithFileSize(const ReadBuffer & in);
 
 size_t getFileSizeFromReadBuffer(ReadBuffer & in);
 
+/// Return nullopt if couldn't find out file size;
+std::optional<size_t> tryGetFileSizeFromReadBuffer(ReadBuffer & in);
+
+size_t getDataOffsetMaybeCompressed(const ReadBuffer & in);
+
 }
diff --git a/src/Processors/Formats/IInputFormat.h b/src/Processors/Formats/IInputFormat.h
index a5a39a5f5b4..86f892b630d 100644
--- a/src/Processors/Formats/IInputFormat.h
+++ b/src/Processors/Formats/IInputFormat.h
@@ -53,6 +53,8 @@ public:
 
     void setErrorsLogger(const InputFormatErrorsLoggerPtr & errors_logger_) { errors_logger = errors_logger_; }
 
+    virtual size_t getApproxBytesReadForChunk() const { return 0; }
+
 protected:
     ColumnMappingPtr column_mapping{};
 
diff --git a/src/Processors/Formats/IRowInputFormat.cpp b/src/Processors/Formats/IRowInputFormat.cpp
index 2686a44806d..0728aecf61f 100644
--- a/src/Processors/Formats/IRowInputFormat.cpp
+++ b/src/Processors/Formats/IRowInputFormat.cpp
@@ -96,6 +96,7 @@ Chunk IRowInputFormat::generate()
     block_missing_values.clear();
 
     size_t num_rows = 0;
+    size_t chunk_start_offset = getDataOffsetMaybeCompressed(getReadBuffer());
 
     try
     {
@@ -242,6 +243,7 @@ Chunk IRowInputFormat::generate()
         column->finalize();
 
     Chunk chunk(std::move(columns), num_rows);
+    approx_bytes_read_for_chunk = getDataOffsetMaybeCompressed(getReadBuffer()) - chunk_start_offset;
     return chunk;
 }
 
diff --git a/src/Processors/Formats/IRowInputFormat.h b/src/Processors/Formats/IRowInputFormat.h
index a11462549ff..b7b1b0b29a6 100644
--- a/src/Processors/Formats/IRowInputFormat.h
+++ b/src/Processors/Formats/IRowInputFormat.h
@@ -74,6 +74,8 @@ protected:
 
     size_t getTotalRows() const { return total_rows; }
 
+    size_t getApproxBytesReadForChunk() const override { return approx_bytes_read_for_chunk; }
+
     Serializations serializations;
 
 private:
@@ -83,6 +85,7 @@ private:
     size_t num_errors = 0;
 
     BlockMissingValues block_missing_values;
+    size_t approx_bytes_read_for_chunk;
 };
 
 }
diff --git a/src/Processors/Formats/Impl/ArrowBlockInputFormat.cpp b/src/Processors/Formats/Impl/ArrowBlockInputFormat.cpp
index ef1a4d9754d..2fadc09e80f 100644
--- a/src/Processors/Formats/Impl/ArrowBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ArrowBlockInputFormat.cpp
@@ -33,7 +33,7 @@ Chunk ArrowBlockInputFormat::generate()
     Chunk res;
     block_missing_values.clear();
     arrow::Result<std::shared_ptr<arrow::RecordBatch>> batch_result;
-
+    size_t batch_start = getDataOffsetMaybeCompressed(*in);
     if (stream)
     {
         if (!stream_reader)
@@ -76,6 +76,11 @@ Chunk ArrowBlockInputFormat::generate()
     BlockMissingValues * block_missing_values_ptr = format_settings.defaults_for_omitted_fields ? &block_missing_values : nullptr;
     arrow_column_to_ch_column->arrowTableToCHChunk(res, *table_result, (*table_result)->num_rows(), block_missing_values_ptr);
 
+    /// There is no easy way to get original record batch size from Arrow metadata.
+    /// Let's just use the number of bytes read from read buffer.
+    auto batch_end = getDataOffsetMaybeCompressed(*in);
+    if (batch_end > batch_start)
+        approx_bytes_read_for_chunk = batch_end - batch_start;
     return res;
 }
 
diff --git a/src/Processors/Formats/Impl/ArrowBlockInputFormat.h b/src/Processors/Formats/Impl/ArrowBlockInputFormat.h
index 3db76777891..df77994c3d5 100644
--- a/src/Processors/Formats/Impl/ArrowBlockInputFormat.h
+++ b/src/Processors/Formats/Impl/ArrowBlockInputFormat.h
@@ -27,6 +27,8 @@ public:
 
     const BlockMissingValues & getMissingValues() const override;
 
+    size_t getApproxBytesReadForChunk() const override { return approx_bytes_read_for_chunk; }
+
 private:
     Chunk generate() override;
 
@@ -48,6 +50,7 @@ private:
     int record_batch_current = 0;
 
     BlockMissingValues block_missing_values;
+    size_t approx_bytes_read_for_chunk;
 
     const FormatSettings format_settings;
 
diff --git a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp
index 84a07ebc8fb..3cdeb0199b3 100644
--- a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp
+++ b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.cpp
@@ -117,6 +117,7 @@ Chunk JSONColumnsBlockInputFormatBase::generate()
     if (reader->checkChunkEnd())
         return Chunk(std::move(columns), 0);
 
+    size_t chunk_start = getDataOffsetMaybeCompressed(*in);
     std::vector<UInt8> seen_columns(columns.size(), 0);
     Int64 rows = -1;
     size_t iteration = 0;
@@ -151,6 +152,8 @@ Chunk JSONColumnsBlockInputFormatBase::generate()
     }
     while (!reader->checkChunkEndOrSkipColumnDelimiter());
 
+    approx_bytes_read_for_chunk = getDataOffsetMaybeCompressed(*in) - chunk_start;
+
     if (rows <= 0)
         return Chunk(std::move(columns), 0);
 
diff --git a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h
index 886c8841540..5ab20c796ea 100644
--- a/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h
+++ b/src/Processors/Formats/Impl/JSONColumnsBlockInputFormatBase.h
@@ -53,6 +53,8 @@ public:
 
     const BlockMissingValues & getMissingValues() const override { return block_missing_values; }
 
+    size_t getApproxBytesReadForChunk() const override { return approx_bytes_read_for_chunk; }
+
 protected:
     Chunk generate() override;
 
@@ -65,6 +67,7 @@ protected:
     Serializations serializations;
     std::unique_ptr<JSONColumnsReaderBase> reader;
     BlockMissingValues block_missing_values;
+    size_t approx_bytes_read_for_chunk;
 };
 
 
diff --git a/src/Processors/Formats/Impl/NativeFormat.cpp b/src/Processors/Formats/Impl/NativeFormat.cpp
index cf1fecca810..f8c9a39eedf 100644
--- a/src/Processors/Formats/Impl/NativeFormat.cpp
+++ b/src/Processors/Formats/Impl/NativeFormat.cpp
@@ -38,7 +38,10 @@ public:
     Chunk generate() override
     {
         block_missing_values.clear();
+        size_t block_start = getDataOffsetMaybeCompressed(*in);
         auto block = reader->read();
+        approx_bytes_read_for_chunk = getDataOffsetMaybeCompressed(*in) - block_start;
+
         if (!block)
             return {};
 
@@ -57,10 +60,13 @@ public:
 
     const BlockMissingValues & getMissingValues() const override { return block_missing_values; }
 
+    size_t getApproxBytesReadForChunk() const override { return approx_bytes_read_for_chunk; }
+
 private:
     std::unique_ptr<NativeReader> reader;
     Block header;
     BlockMissingValues block_missing_values;
+    size_t approx_bytes_read_for_chunk;
 };
 
 class NativeOutputFormat final : public IOutputFormat
diff --git a/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp b/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp
index 5cbe2e24359..5e3c70bb1ef 100644
--- a/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp
@@ -71,6 +71,7 @@ Chunk ORCBlockInputFormat::generate()
     /// Otherwise fill the missing columns with zero values of its type.
     BlockMissingValues * block_missing_values_ptr = format_settings.defaults_for_omitted_fields ? &block_missing_values : nullptr;
     arrow_column_to_ch_column->arrowTableToCHChunk(res, table, num_rows, block_missing_values_ptr);
+    approx_bytes_read_for_chunk = file_reader->GetRawORCReader()->getStripe(stripe_current)->getDataLength();
     return res;
 }
 
diff --git a/src/Processors/Formats/Impl/ORCBlockInputFormat.h b/src/Processors/Formats/Impl/ORCBlockInputFormat.h
index 3d8bc781278..98561e72e61 100644
--- a/src/Processors/Formats/Impl/ORCBlockInputFormat.h
+++ b/src/Processors/Formats/Impl/ORCBlockInputFormat.h
@@ -29,6 +29,8 @@ public:
 
     const BlockMissingValues & getMissingValues() const override;
 
+    size_t getApproxBytesReadForChunk() const override { return approx_bytes_read_for_chunk; }
+
 protected:
     Chunk generate() override;
 
@@ -50,6 +52,7 @@ private:
     std::vector<int> include_indices;
 
     BlockMissingValues block_missing_values;
+    size_t approx_bytes_read_for_chunk;
 
     const FormatSettings format_settings;
     const std::unordered_set<int> & skip_stripes;
diff --git a/src/Processors/Formats/Impl/ParallelParsingInputFormat.cpp b/src/Processors/Formats/Impl/ParallelParsingInputFormat.cpp
index f4d619a263b..06d5c80281f 100644
--- a/src/Processors/Formats/Impl/ParallelParsingInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ParallelParsingInputFormat.cpp
@@ -39,8 +39,10 @@ void ParallelParsingInputFormat::segmentatorThreadFunction(ThreadGroupPtr thread
             // Segmentating the original input.
             unit.segment.resize(0);
 
+            size_t segment_start = getDataOffsetMaybeCompressed(*in);
             auto [have_more_data, currently_read_rows] = file_segmentation_engine(*in, unit.segment, min_chunk_bytes, max_block_size);
 
+            unit.original_segment_size = getDataOffsetMaybeCompressed(*in) - segment_start;
             unit.offset = successfully_read_rows_count;
             successfully_read_rows_count += currently_read_rows;
 
@@ -108,6 +110,11 @@ void ParallelParsingInputFormat::parserThreadFunction(ThreadGroupPtr thread_grou
             /// NOLINTNEXTLINE(bugprone-use-after-move, hicpp-invalid-access-moved)
             unit.chunk_ext.chunk.emplace_back(std::move(chunk));
             unit.chunk_ext.block_missing_values.emplace_back(parser.getMissingValues());
+            size_t approx_chunk_size = input_format->getApproxBytesReadForChunk();
+            /// We could decompress data during file segmentation.
+            /// Correct chunk size using original segment size.
+            approx_chunk_size = static_cast<size_t>(std::ceil(static_cast<double>(approx_chunk_size) / unit.segment.size() * unit.original_segment_size));
+            unit.chunk_ext.approx_chunk_sizes.push_back(approx_chunk_size);
         }
 
         /// Extract column_mapping from first parser to propagate it to others
@@ -237,6 +244,7 @@ Chunk ParallelParsingInputFormat::generate()
 
     Chunk res = std::move(unit.chunk_ext.chunk.at(*next_block_in_current_unit));
     last_block_missing_values = std::move(unit.chunk_ext.block_missing_values[*next_block_in_current_unit]);
+    last_approx_bytes_read_for_chunk = unit.chunk_ext.approx_chunk_sizes.at(*next_block_in_current_unit);
 
     next_block_in_current_unit.value() += 1;
 
diff --git a/src/Processors/Formats/Impl/ParallelParsingInputFormat.h b/src/Processors/Formats/Impl/ParallelParsingInputFormat.h
index 6b084962710..4495680f5b2 100644
--- a/src/Processors/Formats/Impl/ParallelParsingInputFormat.h
+++ b/src/Processors/Formats/Impl/ParallelParsingInputFormat.h
@@ -126,6 +126,8 @@ public:
         return last_block_missing_values;
     }
 
+    size_t getApproxBytesReadForChunk() const override { return last_approx_bytes_read_for_chunk; }
+
     String getName() const override final { return "ParallelParsingBlockInputFormat"; }
 
 private:
@@ -200,6 +202,7 @@ private:
     const size_t max_block_size;
 
     BlockMissingValues last_block_missing_values;
+    size_t last_approx_bytes_read_for_chunk;
 
     /// Non-atomic because it is used in one thread.
     std::optional<size_t> next_block_in_current_unit;
@@ -245,6 +248,7 @@ private:
     {
         std::vector<Chunk> chunk;
         std::vector<BlockMissingValues> block_missing_values;
+        std::vector<size_t> approx_chunk_sizes;
     };
 
     struct ProcessingUnit
@@ -256,6 +260,7 @@ private:
 
         ChunkExt chunk_ext;
         Memory<> segment;
+        size_t original_segment_size;
         std::atomic<ProcessingUnitStatus> status;
         /// Needed for better exception message.
         size_t offset = 0;
diff --git a/src/Processors/Formats/Impl/ParquetBlockInputFormat.cpp b/src/Processors/Formats/Impl/ParquetBlockInputFormat.cpp
index 2f3c68aa481..3dde8ad6a6c 100644
--- a/src/Processors/Formats/Impl/ParquetBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ParquetBlockInputFormat.cpp
@@ -147,6 +147,9 @@ void ParquetBlockInputFormat::initializeRowGroupReader(size_t row_group_idx)
         format_settings.parquet.allow_missing_columns,
         format_settings.null_as_default,
         format_settings.parquet.case_insensitive_column_matching);
+
+    row_group.row_group_bytes_uncompressed = metadata->RowGroup(static_cast<int>(row_group_idx))->total_compressed_size();
+    row_group.row_group_rows = metadata->RowGroup(static_cast<int>(row_group_idx))->num_rows();
 }
 
 void ParquetBlockInputFormat::scheduleRowGroup(size_t row_group_idx)
@@ -253,7 +256,8 @@ void ParquetBlockInputFormat::decodeOneChunk(size_t row_group_idx, std::unique_l
 
     auto tmp_table = arrow::Table::FromRecordBatches({*batch});
 
-    PendingChunk res = {.chunk_idx = row_group.next_chunk_idx, .row_group_idx = row_group_idx};
+    size_t approx_chunk_original_size = static_cast<size_t>(std::ceil(static_cast<double>(row_group.row_group_bytes_uncompressed) / row_group.row_group_rows * (*tmp_table)->num_rows()));
+    PendingChunk res = {.chunk_idx = row_group.next_chunk_idx, .row_group_idx = row_group_idx, .approx_original_chunk_size = approx_chunk_original_size};
 
     /// If defaults_for_omitted_fields is true, calculate the default values from default expression for omitted fields.
     /// Otherwise fill the missing columns with zero values of its type.
@@ -327,6 +331,7 @@ Chunk ParquetBlockInputFormat::generate()
             scheduleMoreWorkIfNeeded(chunk.row_group_idx);
 
             previous_block_missing_values = std::move(chunk.block_missing_values);
+            previous_approx_bytes_read_for_chunk = chunk.approx_original_chunk_size;
             return std::move(chunk.chunk);
         }
 
diff --git a/src/Processors/Formats/Impl/ParquetBlockInputFormat.h b/src/Processors/Formats/Impl/ParquetBlockInputFormat.h
index ad7074547fc..a14c51f8b9f 100644
--- a/src/Processors/Formats/Impl/ParquetBlockInputFormat.h
+++ b/src/Processors/Formats/Impl/ParquetBlockInputFormat.h
@@ -60,6 +60,8 @@ public:
 
     const BlockMissingValues & getMissingValues() const override;
 
+    size_t getApproxBytesReadForChunk() const override { return previous_approx_bytes_read_for_chunk; }
+
 private:
     Chunk generate() override;
 
@@ -200,6 +202,9 @@ private:
         size_t next_chunk_idx = 0;
         size_t num_pending_chunks = 0;
 
+        size_t row_group_bytes_uncompressed = 0;
+        size_t row_group_rows = 0;
+
         // These are only used by the decoding thread, so don't require locking the mutex.
         std::unique_ptr<parquet::arrow::FileReader> file_reader;
         std::shared_ptr<arrow::RecordBatchReader> record_batch_reader;
@@ -213,6 +218,7 @@ private:
         BlockMissingValues block_missing_values;
         size_t chunk_idx; // within row group
         size_t row_group_idx;
+        size_t approx_original_chunk_size;
 
         // For priority_queue.
         // In ordered mode we deliver strictly in order of increasing row group idx,
@@ -267,6 +273,7 @@ private:
     std::unique_ptr<ThreadPool> pool;
 
     BlockMissingValues previous_block_missing_values;
+    size_t previous_approx_bytes_read_for_chunk;
 
     std::exception_ptr background_exception = nullptr;
     std::atomic<int> is_stopped{0};
diff --git a/src/Processors/Formats/Impl/ValuesBlockInputFormat.cpp b/src/Processors/Formats/Impl/ValuesBlockInputFormat.cpp
index ad4e259d874..d61e723fd75 100644
--- a/src/Processors/Formats/Impl/ValuesBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ValuesBlockInputFormat.cpp
@@ -61,6 +61,7 @@ Chunk ValuesBlockInputFormat::generate()
     const Block & header = getPort().getHeader();
     MutableColumns columns = header.cloneEmptyColumns();
     block_missing_values.clear();
+    size_t chunk_start = getDataOffsetMaybeCompressed(*buf);
 
     for (size_t rows_in_block = 0; rows_in_block < params.max_block_size; ++rows_in_block)
     {
@@ -79,6 +80,8 @@ Chunk ValuesBlockInputFormat::generate()
         }
     }
 
+    approx_bytes_read_for_chunk = getDataOffsetMaybeCompressed(*buf) - chunk_start;
+
     /// Evaluate expressions, which were parsed using templates, if any
     for (size_t i = 0; i < columns.size(); ++i)
     {
diff --git a/src/Processors/Formats/Impl/ValuesBlockInputFormat.h b/src/Processors/Formats/Impl/ValuesBlockInputFormat.h
index 9abade72af1..d540a24fa70 100644
--- a/src/Processors/Formats/Impl/ValuesBlockInputFormat.h
+++ b/src/Processors/Formats/Impl/ValuesBlockInputFormat.h
@@ -40,6 +40,7 @@ public:
 
     const BlockMissingValues & getMissingValues() const override { return block_missing_values; }
 
+    size_t getApproxBytesReadForChunk() const override { return approx_bytes_read_for_chunk; }
 private:
     ValuesBlockInputFormat(std::unique_ptr<PeekableReadBuffer> buf_, const Block & header_, const RowInputFormatParams & params_,
                            const FormatSettings & format_settings_);
@@ -95,6 +96,7 @@ private:
     Serializations serializations;
 
     BlockMissingValues block_missing_values;
+    size_t approx_bytes_read_for_chunk;
 };
 
 class ValuesSchemaReader : public IRowSchemaReader
diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 3a96d68dc2e..6a0ecdf1585 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -30,6 +30,7 @@
 #include <Storages/PartitionedSink.h>
 #include <Storages/getVirtualsForStorage.h>
 #include <Storages/checkAndGetLiteralArgument.h>
+#include <Storages/ReadFromStorageProgress.h>
 
 #include <Formats/ReadSchemaUtils.h>
 #include <Formats/FormatFactory.h>
@@ -362,9 +363,10 @@ HDFSSource::HDFSSource(
 bool HDFSSource::initialize()
 {
     bool skip_empty_files = getContext()->getSettingsRef().hdfs_skip_empty_files;
+    StorageHDFS::PathWithInfo path_with_info;
     while (true)
     {
-        auto path_with_info = (*file_iterator)();
+        path_with_info = (*file_iterator)();
         if (path_with_info.path.empty())
             return false;
 
@@ -385,7 +387,17 @@ bool HDFSSource::initialize()
         }
     }
 
-    auto input_format = getContext()->getInputFormat(storage->format_name, *read_buf, block_for_format, max_block_size);
+    current_path = path_with_info.path;
+
+    if (path_with_info.info && path_with_info.info->size)
+    {
+        /// Adjust total_rows_approx_accumulated with new total size.
+        if (total_files_size)
+            total_rows_approx_accumulated = static_cast<size_t>(std::ceil(static_cast<double>(total_files_size + path_with_info.info->size) / total_files_size * total_rows_approx_accumulated));
+        total_files_size += path_with_info.info->size;
+    }
+
+    input_format = getContext()->getInputFormat(storage->format_name, *read_buf, block_for_format, max_block_size);
 
     QueryPipelineBuilder builder;
     builder.init(Pipe(input_format));
@@ -423,6 +435,14 @@ Chunk HDFSSource::generate()
             Columns columns = chunk.getColumns();
             UInt64 num_rows = chunk.getNumRows();
 
+            if (num_rows && total_files_size)
+            {
+                size_t chunk_size = input_format->getApproxBytesReadForChunk();
+                if (!chunk_size)
+                    chunk_size = chunk.bytes();
+                updateRowsProgressApprox(*this, num_rows, chunk_size, total_files_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
+            }
+
             for (const auto & virtual_column : requested_virtual_columns)
             {
                 if (virtual_column.name == "_path")
diff --git a/src/Storages/HDFS/StorageHDFS.h b/src/Storages/HDFS/StorageHDFS.h
index bdf3fabadbc..74801b68f73 100644
--- a/src/Storages/HDFS/StorageHDFS.h
+++ b/src/Storages/HDFS/StorageHDFS.h
@@ -11,6 +11,9 @@
 
 namespace DB
 {
+
+class IInputFormat;
+
 /**
  * This class represents table engine for external hdfs files.
  * Read method is supported for now.
@@ -161,10 +164,16 @@ private:
     ColumnsDescription columns_description;
 
     std::unique_ptr<ReadBuffer> read_buf;
+    std::shared_ptr<IInputFormat> input_format;
     std::unique_ptr<QueryPipeline> pipeline;
     std::unique_ptr<PullingPipelineExecutor> reader;
     String current_path;
 
+    UInt64 total_rows_approx_max = 0;
+    size_t total_rows_count_times = 0;
+    UInt64 total_rows_approx_accumulated = 0;
+    size_t total_files_size = 0;
+
     /// Recreate ReadBuffer and PullingPipelineExecutor for each file.
     bool initialize();
 };
diff --git a/src/Storages/ReadFromStorageProgress.cpp b/src/Storages/ReadFromStorageProgress.cpp
index 48e64d7968b..8ad1cf92209 100644
--- a/src/Storages/ReadFromStorageProgress.cpp
+++ b/src/Storages/ReadFromStorageProgress.cpp
@@ -7,7 +7,8 @@ namespace DB
 
 void updateRowsProgressApprox(
     ISource & source,
-    const Chunk & chunk,
+    size_t num_rows,
+    UInt64 chunk_bytes_size,
     UInt64 total_result_size,
     UInt64 & total_rows_approx_accumulated,
     size_t & total_rows_count_times,
@@ -16,8 +17,6 @@ void updateRowsProgressApprox(
     if (!total_result_size)
         return;
 
-    const size_t num_rows = chunk.getNumRows();
-
     if (!num_rows)
         return;
 
@@ -32,7 +31,7 @@ void updateRowsProgressApprox(
         }
     }
 
-    const auto bytes_per_row = std::ceil(static_cast<double>(chunk.bytes()) / num_rows);
+    const auto bytes_per_row = std::ceil(static_cast<double>(chunk_bytes_size) / num_rows);
     size_t total_rows_approx = static_cast<size_t>(std::ceil(static_cast<double>(total_result_size) / bytes_per_row));
     total_rows_approx_accumulated += total_rows_approx;
     ++total_rows_count_times;
diff --git a/src/Storages/ReadFromStorageProgress.h b/src/Storages/ReadFromStorageProgress.h
index 9f45845ac6e..bc1367cc2e7 100644
--- a/src/Storages/ReadFromStorageProgress.h
+++ b/src/Storages/ReadFromStorageProgress.h
@@ -9,7 +9,8 @@ class Chunk;
 
 void updateRowsProgressApprox(
     ISource & source,
-    const Chunk & chunk,
+    size_t num_rows,
+    size_t chunk_bytes_size,
     UInt64 total_result_size,
     UInt64 & total_rows_approx_accumulated,
     size_t & total_rows_count_times,
diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 3ee176a68b7..336c4eaed9b 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -1013,11 +1013,13 @@ Chunk StorageAzureBlobSource::generate()
             UInt64 num_rows = chunk.getNumRows();
 
             const auto & file_path = reader.getPath();
-            size_t total_size = file_iterator->getTotalSize();
-            if (num_rows && total_size)
+            if (num_rows && total_objects_size)
             {
+                size_t chunk_size = reader.getFormat()->getApproxBytesReadForChunk();
+                if (!chunk_size)
+                    chunk_size = chunk.bytes();
                 updateRowsProgressApprox(
-                    *this, chunk, total_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
+                    *this, num_rows, chunk_size, total_objects_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
             }
 
             for (const auto & virtual_column : requested_virtual_columns)
@@ -1044,6 +1046,13 @@ Chunk StorageAzureBlobSource::generate()
         if (!reader)
             break;
 
+        size_t object_size = tryGetFileSizeFromReadBuffer(*reader.getReadBuffer()).value_or(0);
+        /// Adjust total_rows_approx_accumulated with new total size.
+        if (total_objects_size)
+            total_rows_approx_accumulated = static_cast<size_t>(
+                std::ceil(static_cast<double>(total_objects_size + object_size) / total_objects_size * total_rows_approx_accumulated));
+        total_objects_size += object_size;
+
         /// Even if task is finished the thread may be not freed in pool.
         /// So wait until it will be freed before scheduling a new task.
         create_reader_pool.wait();
@@ -1092,7 +1101,13 @@ StorageAzureBlobSource::StorageAzureBlobSource(
 {
     reader = createReader();
     if (reader)
+    {
+        const auto & read_buf = reader.getReadBuffer();
+        if (read_buf)
+            total_objects_size = tryGetFileSizeFromReadBuffer(*reader.getReadBuffer()).value_or(0);
+
         reader_future = createReaderAsync();
+    }
 }
 
 
@@ -1134,7 +1149,7 @@ StorageAzureBlobSource::ReaderHolder StorageAzureBlobSource::createReader()
     auto pipeline = std::make_unique<QueryPipeline>(QueryPipelineBuilder::getPipeline(std::move(builder)));
     auto current_reader = std::make_unique<PullingPipelineExecutor>(*pipeline);
 
-    return ReaderHolder{fs::path(container) / current_key, std::move(read_buf), std::move(pipeline), std::move(current_reader)};
+    return ReaderHolder{fs::path(container) / current_key, std::move(read_buf), input_format, std::move(pipeline), std::move(current_reader)};
 }
 
 std::future<StorageAzureBlobSource::ReaderHolder> StorageAzureBlobSource::createReaderAsync()
diff --git a/src/Storages/StorageAzureBlob.h b/src/Storages/StorageAzureBlob.h
index e2001fa24ae..25c791f1700 100644
--- a/src/Storages/StorageAzureBlob.h
+++ b/src/Storages/StorageAzureBlob.h
@@ -225,10 +225,12 @@ private:
         ReaderHolder(
             String path_,
             std::unique_ptr<ReadBuffer> read_buf_,
+            std::shared_ptr<IInputFormat> input_format_,
             std::unique_ptr<QueryPipeline> pipeline_,
             std::unique_ptr<PullingPipelineExecutor> reader_)
             : path(std::move(path_))
             , read_buf(std::move(read_buf_))
+            , input_format(input_format_)
             , pipeline(std::move(pipeline_))
             , reader(std::move(reader_))
         {
@@ -249,6 +251,7 @@ private:
             /// reader uses pipeline, pipeline uses read_buf.
             reader = std::move(other.reader);
             pipeline = std::move(other.pipeline);
+            input_format = std::move(other.input_format);
             read_buf = std::move(other.read_buf);
             path = std::move(other.path);
             return *this;
@@ -259,9 +262,14 @@ private:
         const PullingPipelineExecutor * operator->() const { return reader.get(); }
         const String & getPath() const { return path; }
 
+        const std::unique_ptr<ReadBuffer> & getReadBuffer() const { return read_buf; }
+
+        const std::shared_ptr<IInputFormat> & getFormat() const { return input_format; }
+
     private:
         String path;
         std::unique_ptr<ReadBuffer> read_buf;
+        std::shared_ptr<IInputFormat> input_format;
         std::unique_ptr<QueryPipeline> pipeline;
         std::unique_ptr<PullingPipelineExecutor> reader;
     };
@@ -277,6 +285,7 @@ private:
     UInt64 total_rows_approx_max = 0;
     size_t total_rows_count_times = 0;
     UInt64 total_rows_approx_accumulated = 0;
+    size_t total_objects_size = 0;
 
     /// Recreate ReadBuffer and Pipeline for each file.
     ReaderHolder createReader();
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 06f9d071706..cd7309f4ad9 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -722,20 +722,25 @@ public:
                     read_buf = createReadBuffer(current_path, file_stat, storage->use_table_fd, storage->table_fd, storage->compression_method, context);
                 }
 
+                size_t file_size = tryGetFileSizeFromReadBuffer(*read_buf).value_or(0);
+                /// Adjust total_rows_approx_accumulated with new total size.
+                if (total_files_size)
+                    total_rows_approx_accumulated = static_cast<size_t>(std::ceil(static_cast<double>(total_files_size + file_size) / total_files_size * total_rows_approx_accumulated));
+                total_files_size += file_size;
+
                 const Settings & settings = context->getSettingsRef();
                 chassert(!storage->paths.empty());
                 const auto max_parsing_threads = std::max<size_t>(settings.max_threads/ storage->paths.size(), 1UL);
-                auto format
-                    = context->getInputFormat(storage->format_name, *read_buf, block_for_format, max_block_size, storage->format_settings, max_parsing_threads);
+                input_format = context->getInputFormat(storage->format_name, *read_buf, block_for_format, max_block_size, storage->format_settings, max_parsing_threads);
 
                 QueryPipelineBuilder builder;
-                builder.init(Pipe(format));
+                builder.init(Pipe(input_format));
 
                 if (columns_description.hasDefaults())
                 {
                     builder.addSimpleTransform([&](const Block & header)
                     {
-                        return std::make_shared<AddingDefaultsTransform>(header, columns_description, *format, context);
+                        return std::make_shared<AddingDefaultsTransform>(header, columns_description, *input_format, context);
                     });
                 }
 
@@ -765,10 +770,13 @@ public:
                     chunk.addColumn(column->convertToFullColumnIfConst());
                 }
 
-                if (num_rows)
+                if (num_rows && total_files_size)
                 {
+                    size_t chunk_size = input_format->getApproxBytesReadForChunk();
+                    if (!chunk_size)
+                        chunk_size = chunk.bytes();
                     updateRowsProgressApprox(
-                        *this, chunk, files_info->total_bytes_to_read, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
+                        *this, num_rows, chunk_size, total_files_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
                 }
                 return chunk;
             }
@@ -794,6 +802,7 @@ private:
     String current_path;
     Block sample_block;
     std::unique_ptr<ReadBuffer> read_buf;
+    InputFormatPtr input_format;
     std::unique_ptr<QueryPipeline> pipeline;
     std::unique_ptr<PullingPipelineExecutor> reader;
 
@@ -810,6 +819,8 @@ private:
     UInt64 total_rows_approx_accumulated = 0;
     size_t total_rows_count_times = 0;
     UInt64 total_rows_approx_max = 0;
+
+    size_t total_files_size = 0;
 };
 
 
@@ -862,7 +873,10 @@ Pipe StorageFile::read(
     auto progress_callback = context->getFileProgressCallback();
 
     if (progress_callback)
+    {
+        LOG_DEBUG(&Poco::Logger::get("StorageFile"), "Set total_bytes_to_read {}", total_bytes_to_read);
         progress_callback(FileProgress(0, total_bytes_to_read));
+    }
 
     for (size_t i = 0; i < num_streams; ++i)
     {
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 71464d75f25..f4791e45e2b 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -573,7 +573,10 @@ StorageS3Source::StorageS3Source(
 {
     reader = createReader();
     if (reader)
+    {
+        total_objects_size = tryGetFileSizeFromReadBuffer(*reader.getReadBuffer()).value_or(0);
         reader_future = createReaderAsync();
+    }
 }
 
 StorageS3Source::ReaderHolder StorageS3Source::createReader()
@@ -611,7 +614,7 @@ StorageS3Source::ReaderHolder StorageS3Source::createReader()
     auto pipeline = std::make_unique<QueryPipeline>(QueryPipelineBuilder::getPipeline(std::move(builder)));
     auto current_reader = std::make_unique<PullingPipelineExecutor>(*pipeline);
 
-    return ReaderHolder{fs::path(bucket) / key_with_info.key, std::move(read_buf), std::move(pipeline), std::move(current_reader)};
+    return ReaderHolder{fs::path(bucket) / key_with_info.key, std::move(read_buf), input_format, std::move(pipeline), std::move(current_reader)};
 }
 
 std::future<StorageS3Source::ReaderHolder> StorageS3Source::createReaderAsync()
@@ -712,11 +715,13 @@ Chunk StorageS3Source::generate()
             UInt64 num_rows = chunk.getNumRows();
 
             const auto & file_path = reader.getPath();
-            size_t total_size = file_iterator->getTotalSize();
-            if (num_rows && total_size)
+
+            if (num_rows && total_objects_size)
             {
-                updateRowsProgressApprox(
-                    *this, chunk, total_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
+                size_t chunk_size = reader.getFormat()->getApproxBytesReadForChunk();
+                if (!chunk_size)
+                    chunk_size = chunk.bytes();
+                updateRowsProgressApprox(*this, num_rows, chunk_size, total_objects_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
             }
 
             for (const auto & virtual_column : requested_virtual_columns)
@@ -743,6 +748,13 @@ Chunk StorageS3Source::generate()
         if (!reader)
             break;
 
+        size_t object_size = tryGetFileSizeFromReadBuffer(*reader.getReadBuffer()).value_or(0);
+        /// Adjust total_rows_approx_accumulated with new total size.
+        if (total_objects_size)
+            total_rows_approx_accumulated = static_cast<size_t>(
+                std::ceil(static_cast<double>(total_objects_size + object_size) / total_objects_size * total_rows_approx_accumulated));
+        total_objects_size += object_size;
+
         /// Even if task is finished the thread may be not freed in pool.
         /// So wait until it will be freed before scheduling a new task.
         create_reader_pool.wait();
diff --git a/src/Storages/StorageS3.h b/src/Storages/StorageS3.h
index 9c2728c785d..13053833623 100644
--- a/src/Storages/StorageS3.h
+++ b/src/Storages/StorageS3.h
@@ -163,10 +163,12 @@ private:
         ReaderHolder(
             String path_,
             std::unique_ptr<ReadBuffer> read_buf_,
+            std::shared_ptr<IInputFormat> input_format_,
             std::unique_ptr<QueryPipeline> pipeline_,
             std::unique_ptr<PullingPipelineExecutor> reader_)
             : path(std::move(path_))
             , read_buf(std::move(read_buf_))
+            , input_format(input_format_)
             , pipeline(std::move(pipeline_))
             , reader(std::move(reader_))
         {
@@ -187,11 +189,16 @@ private:
             /// reader uses pipeline, pipeline uses read_buf.
             reader = std::move(other.reader);
             pipeline = std::move(other.pipeline);
+            input_format = std::move(other.input_format);
             read_buf = std::move(other.read_buf);
             path = std::move(other.path);
             return *this;
         }
 
+        const std::unique_ptr<ReadBuffer> & getReadBuffer() const { return read_buf; }
+
+        const std::shared_ptr<IInputFormat> & getFormat() const { return input_format; }
+
         explicit operator bool() const { return reader != nullptr; }
         PullingPipelineExecutor * operator->() { return reader.get(); }
         const PullingPipelineExecutor * operator->() const { return reader.get(); }
@@ -200,6 +207,7 @@ private:
     private:
         String path;
         std::unique_ptr<ReadBuffer> read_buf;
+        std::shared_ptr<IInputFormat> input_format;
         std::unique_ptr<QueryPipeline> pipeline;
         std::unique_ptr<PullingPipelineExecutor> reader;
     };
@@ -219,6 +227,7 @@ private:
     UInt64 total_rows_approx_max = 0;
     size_t total_rows_count_times = 0;
     UInt64 total_rows_approx_accumulated = 0;
+    size_t total_objects_size = 0;
 
     /// Recreate ReadBuffer and Pipeline for each file.
     ReaderHolder createReader();
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index dbb6bbaac3a..1d6aed204cb 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -270,17 +270,26 @@ StorageURLSource::StorageURLSource(
         curr_uri = uri_and_buf.first;
         read_buf = std::move(uri_and_buf.second);
 
+        size_t file_size = 0;
         try
         {
-            total_size += getFileSizeFromReadBuffer(*read_buf);
+            file_size = getFileSizeFromReadBuffer(*read_buf);
         }
         catch (...)
         {
-            // we simply continue without total_size
+            // we simply continue without updating total_size
+        }
+
+        if (file_size)
+        {
+            /// Adjust total_rows_approx_accumulated with new total size.
+            if (total_size)
+                total_rows_approx_accumulated = static_cast<size_t>(std::ceil(static_cast<double>(total_size + file_size) / total_size * total_rows_approx_accumulated));
+            total_size += file_size;
         }
 
         // TODO: Pass max_parsing_threads and max_download_threads adjusted for num_streams.
-        auto input_format = FormatFactory::instance().getInput(
+        input_format = FormatFactory::instance().getInput(
             format,
             *read_buf,
             sample_block,
@@ -323,8 +332,13 @@ Chunk StorageURLSource::generate()
         {
             UInt64 num_rows = chunk.getNumRows();
             if (num_rows && total_size)
+            {
+                size_t chunk_size = input_format->getApproxBytesReadForChunk();
+                if (!chunk_size)
+                    chunk_size = chunk.bytes();
                 updateRowsProgressApprox(
-                    *this, chunk, total_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
+                    *this, num_rows, chunk_size, total_size, total_rows_approx_accumulated, total_rows_count_times, total_rows_approx_max);
+            }
 
             const String & path{curr_uri.getPath()};
 
diff --git a/src/Storages/StorageURL.h b/src/Storages/StorageURL.h
index a5c1174377b..e3305cda89e 100644
--- a/src/Storages/StorageURL.h
+++ b/src/Storages/StorageURL.h
@@ -19,6 +19,7 @@ namespace DB
 class IOutputFormat;
 using OutputFormatPtr = std::shared_ptr<IOutputFormat>;
 
+class IInputFormat;
 struct ConnectionTimeouts;
 class NamedCollection;
 class PullingPipelineExecutor;
@@ -206,6 +207,7 @@ private:
     Poco::URI curr_uri;
 
     std::unique_ptr<ReadBuffer> read_buf;
+    std::shared_ptr<IInputFormat> input_format;
     std::unique_ptr<QueryPipeline> pipeline;
     std::unique_ptr<PullingPipelineExecutor> reader;
 

From 56789af0fa25aeaf6545ec6915e930ff70f8b913 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Fri, 16 Jun 2023 15:55:05 +0000
Subject: [PATCH 518/722] Remove loggig

---
 src/Storages/StorageFile.cpp | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index cd7309f4ad9..df358bd784d 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -873,10 +873,7 @@ Pipe StorageFile::read(
     auto progress_callback = context->getFileProgressCallback();
 
     if (progress_callback)
-    {
-        LOG_DEBUG(&Poco::Logger::get("StorageFile"), "Set total_bytes_to_read {}", total_bytes_to_read);
         progress_callback(FileProgress(0, total_bytes_to_read));
-    }
 
     for (size_t i = 0; i < num_streams; ++i)
     {

From e20cea8901163752d9a524562087889c6646637a Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Mon, 29 May 2023 10:39:38 -0700
Subject: [PATCH 519/722] Implement endianness-independent serialization for
 quantileTiming

---
 src/AggregateFunctions/QuantileTiming.h | 30 ++++++++++++-------------
 src/IO/WriteHelpers.h                   |  4 ++--
 2 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/src/AggregateFunctions/QuantileTiming.h b/src/AggregateFunctions/QuantileTiming.h
index de6607b2527..1d73453bc67 100644
--- a/src/AggregateFunctions/QuantileTiming.h
+++ b/src/AggregateFunctions/QuantileTiming.h
@@ -78,14 +78,14 @@ namespace detail
 
         void serialize(WriteBuffer & buf) const
         {
-            writeBinary(count, buf);
+            writeBinaryLittleEndian(count, buf);
             buf.write(reinterpret_cast<const char *>(elems), count * sizeof(elems[0]));
         }
 
         void deserialize(ReadBuffer & buf)
         {
             UInt16 new_count = 0;
-            readBinary(new_count, buf);
+            readBinaryLittleEndian(new_count, buf);
             if (new_count > TINY_MAX_ELEMS)
                 throw Exception(ErrorCodes::INCORRECT_DATA, "The number of elements {} for the 'tiny' kind of quantileTiming is exceeding the maximum of {}", new_count, TINY_MAX_ELEMS);
             buf.readStrict(reinterpret_cast<char *>(elems), new_count * sizeof(elems[0]));
@@ -164,14 +164,14 @@ namespace detail
 
         void serialize(WriteBuffer & buf) const
         {
-            writeBinary(elems.size(), buf);
+            writeBinaryLittleEndian(elems.size(), buf);
             buf.write(reinterpret_cast<const char *>(elems.data()), elems.size() * sizeof(elems[0]));
         }
 
         void deserialize(ReadBuffer & buf)
         {
             size_t size = 0;
-            readBinary(size, buf);
+            readBinaryLittleEndian(size, buf);
             if (size > 10'000)
                 throw Exception(ErrorCodes::INCORRECT_DATA, "The number of elements {} for the 'medium' kind of quantileTiming is too large", size);
 
@@ -341,7 +341,7 @@ namespace detail
 
         void serialize(WriteBuffer & buf) const
         {
-            writeBinary(count, buf);
+            writeBinaryLittleEndian(count, buf);
 
             if (count * 2 > SMALL_THRESHOLD + BIG_SIZE)
             {
@@ -356,8 +356,8 @@ namespace detail
                 {
                     if (count_small[i])
                     {
-                        writeBinary(UInt16(i), buf);
-                        writeBinary(count_small[i], buf);
+                        writeBinaryLittleEndian(UInt16(i), buf);
+                        writeBinaryLittleEndian(count_small[i], buf);
                     }
                 }
 
@@ -365,19 +365,19 @@ namespace detail
                 {
                     if (count_big[i])
                     {
-                        writeBinary(UInt16(i + SMALL_THRESHOLD), buf);
-                        writeBinary(count_big[i], buf);
+                        writeBinaryLittleEndian(UInt16(i + SMALL_THRESHOLD), buf);
+                        writeBinaryLittleEndian(count_big[i], buf);
                     }
                 }
 
                 /// Symbolizes end of data.
-                writeBinary(UInt16(BIG_THRESHOLD), buf);
+                writeBinaryLittleEndian(UInt16(BIG_THRESHOLD), buf);
             }
         }
 
         void deserialize(ReadBuffer & buf)
         {
-            readBinary(count, buf);
+            readBinaryLittleEndian(count, buf);
 
             if (count * 2 > SMALL_THRESHOLD + BIG_SIZE)
             {
@@ -388,12 +388,12 @@ namespace detail
                 while (true)
                 {
                     UInt16 index = 0;
-                    readBinary(index, buf);
+                    readBinaryLittleEndian(index, buf);
                     if (index == BIG_THRESHOLD)
                         break;
 
                     UInt64 elem_count = 0;
-                    readBinary(elem_count, buf);
+                    readBinaryLittleEndian(elem_count, buf);
 
                     if (index < SMALL_THRESHOLD)
                         count_small[index] = elem_count;
@@ -692,7 +692,7 @@ public:
     void serialize(WriteBuffer & buf) const
     {
         auto kind = which();
-        DB::writePODBinary(kind, buf);
+        writeBinaryLittleEndian(kind, buf);
 
         if (kind == Kind::Tiny)
             tiny.serialize(buf);
@@ -706,7 +706,7 @@ public:
     void deserialize(ReadBuffer & buf)
     {
         Kind kind;
-        DB::readPODBinary(kind, buf);
+        readBinaryLittleEndian(kind, buf);
 
         if (kind == Kind::Tiny)
         {
diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index 3d1a5aa49ef..2ee1e1651f6 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -1183,13 +1183,13 @@ inline void writeBinaryEndian(T x, WriteBuffer & buf)
 }
 
 template <typename T>
-inline void writeBinaryLittleEndian(T x, WriteBuffer & buf)
+inline void writeBinaryLittleEndian(const T & x, WriteBuffer & buf)
 {
     writeBinaryEndian<std::endian::little>(x, buf);
 }
 
 template <typename T>
-inline void writeBinaryBigEndian(T x, WriteBuffer & buf)
+inline void writeBinaryBigEndian(const T & x, WriteBuffer & buf)
 {
     writeBinaryEndian<std::endian::big>(x, buf);
 }

From 8289d8fefa37d5854b344055b377c393a4c48dfb Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Fri, 16 Jun 2023 18:46:07 +0200
Subject: [PATCH 520/722] Fix for part_names_mutex used after destruction

---
 src/Storages/MergeTree/MergeTreeData.cpp | 50 +++++++++++-------------
 1 file changed, 23 insertions(+), 27 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 20de0694a6a..365dc1a502b 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1433,6 +1433,21 @@ MergeTreeData::LoadPartResult MergeTreeData::loadDataPartWithRetries(
     UNREACHABLE();
 }
 
+/// Wait for all tasks to finish and rethrow the first exception if any.
+/// The tasks access local variables of the caller function, so we can't just rethrow the first exception until all other tasks are finished.
+void waitForAllToFinishAndRethrowFirstError(std::vector<std::future<void>> & futures)
+{
+    /// First wait for all tasks to finish.
+    for (auto & future : futures)
+        future.wait();
+
+    /// Now rethrow the first exception if any.
+    for (auto & future : futures)
+        future.get();
+
+    futures.clear();
+}
+
 std::vector<MergeTreeData::LoadPartResult> MergeTreeData::loadDataPartsFromDisk(PartLoadingTreeNodes & parts_to_load)
 {
     const size_t num_parts = parts_to_load.size();
@@ -1463,10 +1478,8 @@ std::vector<MergeTreeData::LoadPartResult> MergeTreeData::loadDataPartsFromDisk(
             if (are_parts_to_load_empty)
             {
                 /// Wait for all scheduled tasks.
-                /// We have to use .get() method to rethrow any exception that could occur.
-                for (auto & future: parts_futures)
-                    future.get();
-                parts_futures.clear();
+                waitForAllToFinishAndRethrowFirstError(parts_futures);
+
                 /// At this point it is possible, that some other parts appeared in the queue for processing (parts_to_load),
                 /// because we added them from inside the pool.
                 /// So we need to recheck it.
@@ -1660,10 +1673,7 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
     }
 
     /// For iteration to be completed
-    /// Any exception will be re-thrown.
-    for (auto & future : disks_futures)
-        future.get();
-    disks_futures.clear();
+    waitForAllToFinishAndRethrowFirstError(disks_futures);
 
     PartLoadingTree::PartLoadingInfos parts_to_load;
     for (auto & disk_parts : parts_to_load_by_disk)
@@ -1773,10 +1783,7 @@ void MergeTreeData::loadDataParts(bool skip_sanity_checks)
         }
 
         /// For for iteration to be completed
-        /// Any exception will be re-thrown.
-        for (auto & future : wal_disks_futures)
-            future.get();
-        wal_disks_futures.clear();
+        waitForAllToFinishAndRethrowFirstError(wal_disks_futures);
 
         MutableDataPartsVector parts_from_wal;
         for (auto & disk_wal_parts : disks_wal_parts)
@@ -1891,9 +1898,7 @@ try
             {
                 /// Wait for every scheduled task
                 /// In case of any exception it will be re-thrown and server will be terminated.
-                for (auto & future : parts_futures)
-                    future.get();
-                parts_futures.clear();
+                waitForAllToFinishAndRethrowFirstError(parts_futures);
 
                 LOG_DEBUG(log,
                     "Stopped loading outdated data parts because task was canceled. "
@@ -2443,10 +2448,7 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
             }, Priority{0}));
         }
 
-        /// Any exception will be re-thrown.
-        for (auto & future : parts_to_remove_futures)
-            future.get();
-        parts_to_remove_futures.clear();
+        waitForAllToFinishAndRethrowFirstError(parts_to_remove_futures);
 
         return;
     }
@@ -2602,10 +2604,7 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
 
     independent_ranges = split_into_independent_ranges(excluded_parts, /* split_times */ 0);
 
-    /// Any exception will be re-thrown.
-    for (auto & future : part_removal_futures)
-        future.get();
-    part_removal_futures.clear();
+    waitForAllToFinishAndRethrowFirstError(part_removal_futures);
 
     for (size_t i = 0; i < independent_ranges.infos.size(); ++i)
     {
@@ -2614,10 +2613,7 @@ void MergeTreeData::clearPartsFromFilesystemImpl(const DataPartsVector & parts_t
         schedule_parts_removal(range, std::move(parts_in_range));
     }
 
-    /// Any exception will be re-thrown.
-    for (auto & future : part_removal_futures)
-        future.get();
-    part_removal_futures.clear();
+    waitForAllToFinishAndRethrowFirstError(part_removal_futures);
 
     if (parts_to_remove.size() != sum_of_ranges + excluded_parts.size())
         throw Exception(ErrorCodes::LOGICAL_ERROR,

From e8d4dedbcc76ec2a85b64aa9f2d47b74f666bbd5 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Fri, 16 Jun 2023 19:52:52 +0200
Subject: [PATCH 521/722] fix build and tests

---
 src/IO/WriteBufferFromFile.cpp    |  2 +-
 src/QueryPipeline/BlockIO.cpp     | 16 +++++++++-------
 src/Storages/HDFS/StorageHDFS.cpp |  4 ++--
 3 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/src/IO/WriteBufferFromFile.cpp b/src/IO/WriteBufferFromFile.cpp
index e58f1e3a60c..97059ff8f48 100644
--- a/src/IO/WriteBufferFromFile.cpp
+++ b/src/IO/WriteBufferFromFile.cpp
@@ -103,7 +103,7 @@ void WriteBufferFromFile::close()
     if (fd < 0)
         return;
 
-    next();
+    finalize();
 
     if (0 != ::close(fd))
         throw Exception(ErrorCodes::CANNOT_CLOSE_FILE, "Cannot close file");
diff --git a/src/QueryPipeline/BlockIO.cpp b/src/QueryPipeline/BlockIO.cpp
index 231c369707e..76da01bee0e 100644
--- a/src/QueryPipeline/BlockIO.cpp
+++ b/src/QueryPipeline/BlockIO.cpp
@@ -71,19 +71,21 @@ void BlockIO::onCancelOrConnectionLoss()
 {
     /// Query was not finished gracefully, so we should call exception_callback
     /// But we don't have a real exception
-    if (exception_callback)
+    try
     {
-        try
-        {
-            throw Exception(ErrorCodes::QUERY_WAS_CANCELLED, "Query was cancelled or a client has unexpectedly dropped the connection");
-        }
-        catch (...)
+        throw Exception(ErrorCodes::QUERY_WAS_CANCELLED, "Query was cancelled or a client has unexpectedly dropped the connection");
+    }
+    catch (...)
+    {
+        if (exception_callback)
         {
             exception_callback(/* log_error */ false);
         }
+
+        /// destroy pipeline and write buffers with an exception context
+        pipeline.reset();
     }
 
-    pipeline.reset();
 }
 
 void BlockIO::setAllDataSent() const
diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 3a96d68dc2e..af7162094c8 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -102,9 +102,9 @@ namespace
             if (!is_directory && !looking_for_directory)
             {
                 if (re2::RE2::FullMatch(file_name, matcher))
-                    result.emplace_back(
+                    result.push_back(StorageHDFS::PathWithInfo{
                         String(ls.file_info[i].mName),
-                        StorageHDFS::PathInfo{ls.file_info[i].mLastMod, static_cast<size_t>(ls.file_info[i].mSize)});
+                        StorageHDFS::PathInfo{ls.file_info[i].mLastMod, static_cast<size_t>(ls.file_info[i].mSize)}});
             }
             else if (is_directory && looking_for_directory)
             {

From c2900177a2a3386c998a86019cccff909b1b029d Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Fri, 16 Jun 2023 06:52:11 +0000
Subject: [PATCH 522/722] Fix race condition in ColumnLowCardinality caused by
 subtly broken copy-on-write for the dictionary

---
 src/Columns/ColumnLowCardinality.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Columns/ColumnLowCardinality.h b/src/Columns/ColumnLowCardinality.h
index a5c056153bb..86ab3d153e9 100644
--- a/src/Columns/ColumnLowCardinality.h
+++ b/src/Columns/ColumnLowCardinality.h
@@ -340,7 +340,7 @@ private:
         explicit Dictionary(MutableColumnPtr && column_unique, bool is_shared);
         explicit Dictionary(ColumnPtr column_unique, bool is_shared);
 
-        const ColumnPtr & getColumnUniquePtr() const { return column_unique; }
+        const WrappedPtr & getColumnUniquePtr() const { return column_unique; }
         WrappedPtr & getColumnUniquePtr() { return column_unique; }
 
         const IColumnUnique & getColumnUnique() const { return static_cast<const IColumnUnique &>(*column_unique); }

From 10d597676c81cb25da8e0b4bea2f4ed9a0c650d8 Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Fri, 16 Jun 2023 07:16:50 +0000
Subject: [PATCH 523/722] Refactor IColumn::forEachSubcolumn to make it
 slightly harder to implement incorrectly

---
 contrib/jemalloc-cmake/CMakeLists.txt         |  2 +-
 src/Columns/ColumnArray.h                     |  4 +-
 src/Columns/ColumnLowCardinality.h            |  4 +-
 src/Columns/ColumnMap.cpp                     |  4 +-
 src/Columns/ColumnMap.h                       |  4 +-
 src/Columns/ColumnNullable.h                  |  4 +-
 src/Columns/ColumnObject.cpp                  | 12 +++---
 src/Columns/ColumnObject.h                    |  4 +-
 src/Columns/ColumnSparse.cpp                  |  4 +-
 src/Columns/ColumnSparse.h                    |  4 +-
 src/Columns/ColumnString.cpp                  | 20 ++++-----
 src/Columns/ColumnTuple.cpp                   |  8 ++--
 src/Columns/ColumnTuple.h                     |  4 +-
 src/Columns/IColumn.cpp                       | 12 +++---
 src/Columns/IColumn.h                         | 18 ++++----
 .../SerializationLowCardinality.cpp           | 43 -------------------
 16 files changed, 55 insertions(+), 96 deletions(-)

diff --git a/contrib/jemalloc-cmake/CMakeLists.txt b/contrib/jemalloc-cmake/CMakeLists.txt
index d5ea69d4926..97f723bb540 100644
--- a/contrib/jemalloc-cmake/CMakeLists.txt
+++ b/contrib/jemalloc-cmake/CMakeLists.txt
@@ -4,7 +4,7 @@ if (SANITIZE OR NOT (
 ))
     if (ENABLE_JEMALLOC)
         message (${RECONFIGURE_MESSAGE_LEVEL}
-                 "jemalloc is disabled implicitly: it doesn't work with sanitizers and can only be used with x86_64, aarch64, or ppc64le Linux or FreeBSD builds and RelWithDebInfo macOS builds.")
+                 "jemalloc is disabled implicitly: it doesn't work with sanitizers and can only be used with x86_64, aarch64, or ppc64le Linux or FreeBSD builds and RelWithDebInfo macOS builds. Use -DENABLE_JEMALLOC=0")
     endif ()
     set (ENABLE_JEMALLOC OFF)
 else ()
diff --git a/src/Columns/ColumnArray.h b/src/Columns/ColumnArray.h
index e60c388831d..f011d9a607b 100644
--- a/src/Columns/ColumnArray.h
+++ b/src/Columns/ColumnArray.h
@@ -151,13 +151,13 @@ public:
 
     ColumnPtr compress() const override;
 
-    void forEachSubcolumn(ColumnCallback callback) const override
+    void forEachSubcolumn(MutableColumnCallback callback) override
     {
         callback(offsets);
         callback(data);
     }
 
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override
     {
         callback(*offsets);
         offsets->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnLowCardinality.h b/src/Columns/ColumnLowCardinality.h
index 86ab3d153e9..dcd07ff3b34 100644
--- a/src/Columns/ColumnLowCardinality.h
+++ b/src/Columns/ColumnLowCardinality.h
@@ -166,7 +166,7 @@ public:
     size_t byteSizeAt(size_t n) const override { return getDictionary().byteSizeAt(getIndexes().getUInt(n)); }
     size_t allocatedBytes() const override { return idx.getPositions()->allocatedBytes() + getDictionary().allocatedBytes(); }
 
-    void forEachSubcolumn(ColumnCallback callback) const override
+    void forEachSubcolumn(MutableColumnCallback callback) override
     {
         callback(idx.getPositionsPtr());
 
@@ -175,7 +175,7 @@ public:
             callback(dictionary.getColumnUniquePtr());
     }
 
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override
     {
         callback(*idx.getPositionsPtr());
         idx.getPositionsPtr()->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnMap.cpp b/src/Columns/ColumnMap.cpp
index 7f5693bf470..797700e87b0 100644
--- a/src/Columns/ColumnMap.cpp
+++ b/src/Columns/ColumnMap.cpp
@@ -273,12 +273,12 @@ void ColumnMap::getExtremes(Field & min, Field & max) const
     max = std::move(map_max_value);
 }
 
-void ColumnMap::forEachSubcolumn(ColumnCallback callback) const
+void ColumnMap::forEachSubcolumn(MutableColumnCallback callback)
 {
     callback(nested);
 }
 
-void ColumnMap::forEachSubcolumnRecursively(RecursiveColumnCallback callback) const
+void ColumnMap::forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback)
 {
     callback(*nested);
     nested->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnMap.h b/src/Columns/ColumnMap.h
index a11905fcaa0..e5bc26127df 100644
--- a/src/Columns/ColumnMap.h
+++ b/src/Columns/ColumnMap.h
@@ -88,8 +88,8 @@ public:
     size_t byteSizeAt(size_t n) const override;
     size_t allocatedBytes() const override;
     void protect() override;
-    void forEachSubcolumn(ColumnCallback callback) const override;
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override;
+    void forEachSubcolumn(MutableColumnCallback callback) override;
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override;
     bool structureEquals(const IColumn & rhs) const override;
     double getRatioOfDefaultRows(double sample_ratio) const override;
     UInt64 getNumberOfDefaultRows() const override;
diff --git a/src/Columns/ColumnNullable.h b/src/Columns/ColumnNullable.h
index 47afd982b1e..bc95eca69b9 100644
--- a/src/Columns/ColumnNullable.h
+++ b/src/Columns/ColumnNullable.h
@@ -130,13 +130,13 @@ public:
 
     ColumnPtr compress() const override;
 
-    void forEachSubcolumn(ColumnCallback callback) const override
+    void forEachSubcolumn(MutableColumnCallback callback) override
     {
         callback(nested_column);
         callback(null_map);
     }
 
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override
     {
         callback(*nested_column);
         nested_column->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnObject.cpp b/src/Columns/ColumnObject.cpp
index b2adf9e0059..07872774559 100644
--- a/src/Columns/ColumnObject.cpp
+++ b/src/Columns/ColumnObject.cpp
@@ -664,18 +664,18 @@ size_t ColumnObject::allocatedBytes() const
     return res;
 }
 
-void ColumnObject::forEachSubcolumn(ColumnCallback callback) const
+void ColumnObject::forEachSubcolumn(MutableColumnCallback callback)
 {
-    for (const auto & entry : subcolumns)
-        for (const auto & part : entry->data.data)
+    for (auto & entry : subcolumns)
+        for (auto & part : entry->data.data)
             callback(part);
 }
 
-void ColumnObject::forEachSubcolumnRecursively(RecursiveColumnCallback callback) const
+void ColumnObject::forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback)
 {
-    for (const auto & entry : subcolumns)
+    for (auto & entry : subcolumns)
     {
-        for (const auto & part : entry->data.data)
+        for (auto & part : entry->data.data)
         {
             callback(*part);
             part->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnObject.h b/src/Columns/ColumnObject.h
index 91920908542..bc5a6b69bb0 100644
--- a/src/Columns/ColumnObject.h
+++ b/src/Columns/ColumnObject.h
@@ -206,8 +206,8 @@ public:
     size_t size() const override;
     size_t byteSize() const override;
     size_t allocatedBytes() const override;
-    void forEachSubcolumn(ColumnCallback callback) const override;
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override;
+    void forEachSubcolumn(MutableColumnCallback callback) override;
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override;
     void insert(const Field & field) override;
     void insertDefault() override;
     void insertFrom(const IColumn & src, size_t n) override;
diff --git a/src/Columns/ColumnSparse.cpp b/src/Columns/ColumnSparse.cpp
index 9e4609ab4b5..0cad2c2d36b 100644
--- a/src/Columns/ColumnSparse.cpp
+++ b/src/Columns/ColumnSparse.cpp
@@ -751,13 +751,13 @@ bool ColumnSparse::structureEquals(const IColumn & rhs) const
     return false;
 }
 
-void ColumnSparse::forEachSubcolumn(ColumnCallback callback) const
+void ColumnSparse::forEachSubcolumn(MutableColumnCallback callback)
 {
     callback(values);
     callback(offsets);
 }
 
-void ColumnSparse::forEachSubcolumnRecursively(RecursiveColumnCallback callback) const
+void ColumnSparse::forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback)
 {
     callback(*values);
     values->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnSparse.h b/src/Columns/ColumnSparse.h
index d4eb13bf208..26e05655f60 100644
--- a/src/Columns/ColumnSparse.h
+++ b/src/Columns/ColumnSparse.h
@@ -140,8 +140,8 @@ public:
 
     ColumnPtr compress() const override;
 
-    void forEachSubcolumn(ColumnCallback callback) const override;
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override;
+    void forEachSubcolumn(MutableColumnCallback callback) override;
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override;
 
     bool structureEquals(const IColumn & rhs) const override;
 
diff --git a/src/Columns/ColumnString.cpp b/src/Columns/ColumnString.cpp
index de96c57700b..38c7b2c0dd6 100644
--- a/src/Columns/ColumnString.cpp
+++ b/src/Columns/ColumnString.cpp
@@ -31,14 +31,12 @@ ColumnString::ColumnString(const ColumnString & src)
     offsets(src.offsets.begin(), src.offsets.end()),
     chars(src.chars.begin(), src.chars.end())
 {
-    if (!offsets.empty())
-    {
-        Offset last_offset = offsets.back();
-
-        /// This will also prevent possible overflow in offset.
-        if (chars.size() != last_offset)
-            throw Exception(ErrorCodes::LOGICAL_ERROR, "String offsets has data inconsistent with chars array");
-    }
+    Offset last_offset = offsets.empty() ? 0 : offsets.back();
+    /// This will also prevent possible overflow in offset.
+    if (last_offset != chars.size())
+        throw Exception(ErrorCodes::LOGICAL_ERROR,
+            "String offsets has data inconsistent with chars array. Last offset: {}, array length: {}",
+            last_offset, chars.size());
 }
 
 
@@ -157,6 +155,7 @@ ColumnPtr ColumnString::filter(const Filter & filt, ssize_t result_size_hint) co
     Offsets & res_offsets = res->offsets;
 
     filterArraysImpl<UInt8>(chars, offsets, res_chars, res_offsets, filt, result_size_hint);
+
     return res;
 }
 
@@ -571,10 +570,11 @@ void ColumnString::protect()
 
 void ColumnString::validate() const
 {
-    if (!offsets.empty() && offsets.back() != chars.size())
+    Offset last_offset = offsets.empty() ? 0 : offsets.back();
+    if (last_offset != chars.size())
         throw Exception(ErrorCodes::LOGICAL_ERROR,
                         "ColumnString validation failed: size mismatch (internal logical error) {} != {}",
-                        offsets.back(), chars.size());
+                        last_offset, chars.size());
 }
 
 }
diff --git a/src/Columns/ColumnTuple.cpp b/src/Columns/ColumnTuple.cpp
index 9f659aa7a7c..9702d275114 100644
--- a/src/Columns/ColumnTuple.cpp
+++ b/src/Columns/ColumnTuple.cpp
@@ -495,15 +495,15 @@ void ColumnTuple::getExtremes(Field & min, Field & max) const
     max = max_tuple;
 }
 
-void ColumnTuple::forEachSubcolumn(ColumnCallback callback) const
+void ColumnTuple::forEachSubcolumn(MutableColumnCallback callback)
 {
-    for (const auto & column : columns)
+    for (auto & column : columns)
         callback(column);
 }
 
-void ColumnTuple::forEachSubcolumnRecursively(RecursiveColumnCallback callback) const
+void ColumnTuple::forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback)
 {
-    for (const auto & column : columns)
+    for (auto & column : columns)
     {
         callback(*column);
         column->forEachSubcolumnRecursively(callback);
diff --git a/src/Columns/ColumnTuple.h b/src/Columns/ColumnTuple.h
index 281fd94d893..e7dee9b8ff9 100644
--- a/src/Columns/ColumnTuple.h
+++ b/src/Columns/ColumnTuple.h
@@ -96,8 +96,8 @@ public:
     size_t byteSizeAt(size_t n) const override;
     size_t allocatedBytes() const override;
     void protect() override;
-    void forEachSubcolumn(ColumnCallback callback) const override;
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override;
+    void forEachSubcolumn(MutableColumnCallback callback) override;
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override;
     bool structureEquals(const IColumn & rhs) const override;
     bool isCollationSupported() const override;
     ColumnPtr compress() const override;
diff --git a/src/Columns/IColumn.cpp b/src/Columns/IColumn.cpp
index 46f07cffa9e..7923bca6354 100644
--- a/src/Columns/IColumn.cpp
+++ b/src/Columns/IColumn.cpp
@@ -62,19 +62,19 @@ ColumnPtr IColumn::createWithOffsets(const Offsets & offsets, const Field & defa
     return res;
 }
 
-void IColumn::forEachSubcolumn(MutableColumnCallback callback)
+void IColumn::forEachSubcolumn(ColumnCallback callback) const
 {
-    std::as_const(*this).forEachSubcolumn([&callback](const WrappedPtr & subcolumn)
+    const_cast<IColumn*>(this)->forEachSubcolumn([&callback](WrappedPtr & subcolumn)
     {
-        callback(const_cast<WrappedPtr &>(subcolumn));
+        callback(std::as_const(subcolumn));
     });
 }
 
-void IColumn::forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback)
+void IColumn::forEachSubcolumnRecursively(RecursiveColumnCallback callback) const
 {
-    std::as_const(*this).forEachSubcolumnRecursively([&callback](const IColumn & subcolumn)
+    const_cast<IColumn*>(this)->forEachSubcolumnRecursively([&callback](IColumn & subcolumn)
     {
-        callback(const_cast<IColumn &>(subcolumn));
+        callback(std::as_const(subcolumn));
     });
 }
 
diff --git a/src/Columns/IColumn.h b/src/Columns/IColumn.h
index 633bb384fb8..b4eaf5c28f5 100644
--- a/src/Columns/IColumn.h
+++ b/src/Columns/IColumn.h
@@ -418,21 +418,23 @@ public:
     /// If the column contains subcolumns (such as Array, Nullable, etc), do callback on them.
     /// Shallow: doesn't do recursive calls; don't do call for itself.
 
-    using ColumnCallback = std::function<void(const WrappedPtr &)>;
-    virtual void forEachSubcolumn(ColumnCallback) const {}
-
     using MutableColumnCallback = std::function<void(WrappedPtr &)>;
-    virtual void forEachSubcolumn(MutableColumnCallback callback);
+    virtual void forEachSubcolumn(MutableColumnCallback) {}
+
+    /// Default implementation calls the mutable overload using const_cast.
+    using ColumnCallback = std::function<void(const WrappedPtr &)>;
+    virtual void forEachSubcolumn(ColumnCallback) const;
 
     /// Similar to forEachSubcolumn but it also do recursive calls.
     /// In recursive calls it's prohibited to replace pointers
     /// to subcolumns, so we use another callback function.
 
-    using RecursiveColumnCallback = std::function<void(const IColumn &)>;
-    virtual void forEachSubcolumnRecursively(RecursiveColumnCallback) const {}
-
     using RecursiveMutableColumnCallback = std::function<void(IColumn &)>;
-    virtual void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback);
+    virtual void forEachSubcolumnRecursively(RecursiveMutableColumnCallback) {}
+
+    /// Default implementation calls the mutable overload using const_cast.
+    using RecursiveColumnCallback = std::function<void(const IColumn &)>;
+    virtual void forEachSubcolumnRecursively(RecursiveColumnCallback) const;
 
     /// Columns have equal structure.
     /// If true - you can use "compareAt", "insertFrom", etc. methods.
diff --git a/src/DataTypes/Serializations/SerializationLowCardinality.cpp b/src/DataTypes/Serializations/SerializationLowCardinality.cpp
index 90b51c1a6f2..aba77c8d431 100644
--- a/src/DataTypes/Serializations/SerializationLowCardinality.cpp
+++ b/src/DataTypes/Serializations/SerializationLowCardinality.cpp
@@ -300,49 +300,6 @@ namespace
         MutableColumnPtr additional_keys_map;
     };
 
-    template <typename T>
-    IndexMapsWithAdditionalKeys mapIndexWithAdditionalKeysRef(PaddedPODArray<T> & index, size_t dict_size)
-    {
-        PaddedPODArray<T> copy(index.cbegin(), index.cend());
-
-        HashMap<T, T> dict_map;
-        HashMap<T, T> add_keys_map;
-
-        for (auto val : index)
-        {
-            if (val < dict_size)
-                dict_map.insert({val, dict_map.size()});
-            else
-                add_keys_map.insert({val, add_keys_map.size()});
-        }
-
-        auto dictionary_map = ColumnVector<T>::create(dict_map.size());
-        auto additional_keys_map = ColumnVector<T>::create(add_keys_map.size());
-        auto & dict_data = dictionary_map->getData();
-        auto & add_keys_data = additional_keys_map->getData();
-
-        for (auto val : dict_map)
-            dict_data[val.second] = val.first;
-
-        for (auto val : add_keys_map)
-            add_keys_data[val.second] = val.first - dict_size;
-
-        for (auto & val : index)
-            val = val < dict_size ? dict_map[val]
-                                  : add_keys_map[val] + dict_map.size();
-
-        for (size_t i = 0; i < index.size(); ++i)
-        {
-            T expected = index[i] < dict_data.size() ? dict_data[index[i]]
-                                                     : add_keys_data[index[i] - dict_data.size()] + dict_size;
-            if (expected != copy[i])
-                throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected {}, but got {}", toString(expected), toString(copy[i]));
-
-        }
-
-        return {std::move(dictionary_map), std::move(additional_keys_map)};
-    }
-
     template <typename T>
     IndexMapsWithAdditionalKeys mapIndexWithAdditionalKeys(PaddedPODArray<T> & index, size_t dict_size)
     {

From 5f8ef275139d77d66ba7b6a7b729528c43f4b1e2 Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Fri, 16 Jun 2023 14:37:01 -0400
Subject: [PATCH 524/722] initialize buffer with memset

---
 src/Compression/CompressionCodecDeflateQpl.cpp | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/Compression/CompressionCodecDeflateQpl.cpp b/src/Compression/CompressionCodecDeflateQpl.cpp
index 60efbd96f8f..7da79b5f90d 100644
--- a/src/Compression/CompressionCodecDeflateQpl.cpp
+++ b/src/Compression/CompressionCodecDeflateQpl.cpp
@@ -382,6 +382,9 @@ UInt32 CompressionCodecDeflateQpl::getMaxCompressedDataSize(UInt32 uncompressed_
 
 UInt32 CompressionCodecDeflateQpl::doCompressData(const char * source, UInt32 source_size, char * dest) const
 {
+#if defined(MEMORY_SANITIZER)
+    memset(dest, 0 , getMaxCompressedDataSize(source_size));
+#endif
     Int32 res = HardwareCodecDeflateQpl::RET_ERROR;
     if (DeflateQplJobHWPool::instance().isJobPoolReady())
         res = hw_codec->doCompressData(source, source_size, dest, getMaxCompressedDataSize(source_size));
@@ -392,6 +395,9 @@ UInt32 CompressionCodecDeflateQpl::doCompressData(const char * source, UInt32 so
 
 void CompressionCodecDeflateQpl::doDecompressData(const char * source, UInt32 source_size, char * dest, UInt32 uncompressed_size) const
 {
+#if defined(MEMORY_SANITIZER)
+    memset(dest, 0 , uncompressed_size);
+#endif
     switch (getDecompressMode())
     {
         case CodecMode::Synchronous:

From bfd3154190350d7dc0269c90062541f6936a2b84 Mon Sep 17 00:00:00 2001
From: Victor Krasnov <v.krasnov@arenadata.io>
Date: Fri, 16 Jun 2023 22:00:16 +0300
Subject: [PATCH 525/722] Remove time zones from the test
 02783_parsedatetimebesteffort_syslog

---
 ...3_parsedatetimebesteffort_syslog.reference | 100 +++++-------------
 .../02783_parsedatetimebesteffort_syslog.sql  |  52 +--------
 2 files changed, 28 insertions(+), 124 deletions(-)

diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
index 0840054b1d3..1340b3affe3 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.reference
@@ -4,82 +4,34 @@ The argument is before the reference time point
 ───────────────────────────────────────────────
 Row 1:
 ──────
-syslog_arg:        Jun 30 23:58:30
-res:               2023-06-30 23:58:30
-res_sam:           2022-06-30 23:58:30
-res_auc:           2023-06-30 23:58:30
-res_null:          2023-06-30 23:58:30
-res_null_sam:      2022-06-30 23:58:30
-res_null_auc:      2023-06-30 23:58:30
-res_zero:          2023-06-30 23:58:30
-res_zero_sam:      2022-06-30 23:58:30
-res_zero_auc:      2023-06-30 23:58:30
-res_us:            2023-06-30 23:58:30
-res_us_sam:        2022-06-30 23:58:30
-res_us_auc:        2023-06-30 23:58:30
-res_us_null:       2023-06-30 23:58:30
-res_us_null_sam:   2022-06-30 23:58:30
-res_us_null_auc:   2023-06-30 23:58:30
-res_us_zero:       2023-06-30 23:58:30
-res_us_zero_sam:   2022-06-30 23:58:30
-res_us_zero_auc:   2023-06-30 23:58:30
-res64:             2023-06-30 23:58:30.000
-res64_sam:         2022-06-30 23:58:30.000
-res64_auc:         2023-06-30 23:58:30.000
-res64_null:        2023-06-30 23:58:30.000
-res64_null_sam:    2022-06-30 23:58:30.000
-res64_null_auc:    2023-06-30 23:58:30.000
-res64_zero:        2023-06-30 23:58:30.000
-res64_zero_sam:    2022-06-30 23:58:30.000
-res64_zero_auc:    2023-06-30 23:58:30.000
-res64_us:          2023-06-30 23:58:30.000
-res64_us_sam:      2022-06-30 23:58:30.000
-res64_us_auc:      2023-06-30 23:58:30.000
-res64_us_null:     2023-06-30 23:58:30.000
-res64_us_null_sam: 2022-06-30 23:58:30.000
-res64_us_null_auc: 2023-06-30 23:58:30.000
-res64_us_zero:     2023-06-30 23:58:30.000
-res64_us_zero_sam: 2022-06-30 23:58:30.000
-res64_us_zero_auc: 2023-06-30 23:58:30.000
+syslog_arg:    Jun 30 23:58:30
+res:           2023-06-30 23:58:30
+res_null:      2023-06-30 23:58:30
+res_zero:      2023-06-30 23:58:30
+res_us:        2023-06-30 23:58:30
+res_us_null:   2023-06-30 23:58:30
+res_us_zero:   2023-06-30 23:58:30
+res64:         2023-06-30 23:58:30.000
+res64_null:    2023-06-30 23:58:30.000
+res64_zero:    2023-06-30 23:58:30.000
+res64_us:      2023-06-30 23:58:30.000
+res64_us_null: 2023-06-30 23:58:30.000
+res64_us_zero: 2023-06-30 23:58:30.000
 ──────────────────────────────────────────────
 The argument is after the reference time point
 ──────────────────────────────────────────────
 Row 1:
 ──────
-syslog_arg:        Jul  1 00:00:30
-res:               2022-07-01 00:00:30
-res_sam:           2022-07-01 00:00:30
-res_auc:           2023-07-01 00:00:30
-res_null:          2022-07-01 00:00:30
-res_null_sam:      2022-07-01 00:00:30
-res_null_auc:      2023-07-01 00:00:30
-res_zero:          2022-07-01 00:00:30
-res_zero_sam:      2022-07-01 00:00:30
-res_zero_auc:      2023-07-01 00:00:30
-res_us:            2022-07-01 00:00:30
-res_us_sam:        2022-07-01 00:00:30
-res_us_auc:        2023-07-01 00:00:30
-res_us_null:       2022-07-01 00:00:30
-res_us_null_sam:   2022-07-01 00:00:30
-res_us_null_auc:   2023-07-01 00:00:30
-res_us_zero:       2022-07-01 00:00:30
-res_us_zero_sam:   2022-07-01 00:00:30
-res_us_zero_auc:   2023-07-01 00:00:30
-res64:             2022-07-01 00:00:30.000
-res64_sam:         2022-07-01 00:00:30.000
-res64_auc:         2023-07-01 00:00:30.000
-res64_null:        2022-07-01 00:00:30.000
-res64_null_sam:    2022-07-01 00:00:30.000
-res64_null_auc:    2023-07-01 00:00:30.000
-res64_zero:        2022-07-01 00:00:30.000
-res64_zero_sam:    2022-07-01 00:00:30.000
-res64_zero_auc:    2023-07-01 00:00:30.000
-res64_us:          2022-07-01 00:00:30.000
-res64_us_sam:      2022-07-01 00:00:30.000
-res64_us_auc:      2023-07-01 00:00:30.000
-res64_us_null:     2022-07-01 00:00:30.000
-res64_us_null_sam: 2022-07-01 00:00:30.000
-res64_us_null_auc: 2023-07-01 00:00:30.000
-res64_us_zero:     2022-07-01 00:00:30.000
-res64_us_zero_sam: 2022-07-01 00:00:30.000
-res64_us_zero_auc: 2023-07-01 00:00:30.000
+syslog_arg:    Jul  1 00:00:30
+res:           2022-07-01 00:00:30
+res_null:      2022-07-01 00:00:30
+res_zero:      2022-07-01 00:00:30
+res_us:        2022-07-01 00:00:30
+res_us_null:   2022-07-01 00:00:30
+res_us_zero:   2022-07-01 00:00:30
+res64:         2022-07-01 00:00:30.000
+res64_null:    2022-07-01 00:00:30.000
+res64_zero:    2022-07-01 00:00:30.000
+res64_us:      2022-07-01 00:00:30.000
+res64_us_null: 2022-07-01 00:00:30.000
+res64_us_zero: 2022-07-01 00:00:30.000
diff --git a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
index fc38500c41a..38e495fdd4e 100644
--- a/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
+++ b/tests/queries/0_stateless/02783_parsedatetimebesteffort_syslog.sql
@@ -12,41 +12,17 @@ WITH
 SELECT
     formatDateTime(dt_before - time_shift, '%b %e %T') AS syslog_arg,
     parseDateTimeBestEffort(syslog_before) - time_shift AS res,
-    parseDateTimeBestEffort(syslog_before, 'US/Samoa') - time_shift AS res_sam,
-    parseDateTimeBestEffort(syslog_before, 'Pacific/Auckland') - time_shift AS res_auc,
     parseDateTimeBestEffortOrNull(syslog_before) - time_shift AS res_null,
-    parseDateTimeBestEffortOrNull(syslog_before, 'US/Samoa') - time_shift AS res_null_sam,
-    parseDateTimeBestEffortOrNull(syslog_before, 'Pacific/Auckland') - time_shift AS res_null_auc,
     parseDateTimeBestEffortOrZero(syslog_before) - time_shift AS res_zero,
-    parseDateTimeBestEffortOrZero(syslog_before, 'US/Samoa') - time_shift AS res_zero_sam,
-    parseDateTimeBestEffortOrZero(syslog_before, 'Pacific/Auckland') - time_shift AS res_zero_auc,
     parseDateTimeBestEffortUS(syslog_before) - time_shift AS res_us,
-    parseDateTimeBestEffortUS(syslog_before, 'US/Samoa') - time_shift AS res_us_sam,
-    parseDateTimeBestEffortUS(syslog_before, 'Pacific/Auckland') - time_shift AS res_us_auc,
     parseDateTimeBestEffortUSOrNull(syslog_before) - time_shift AS res_us_null,
-    parseDateTimeBestEffortUSOrNull(syslog_before, 'US/Samoa') - time_shift AS res_us_null_sam,
-    parseDateTimeBestEffortUSOrNull(syslog_before, 'Pacific/Auckland') - time_shift AS res_us_null_auc,
     parseDateTimeBestEffortUSOrZero(syslog_before) - time_shift AS res_us_zero,
-    parseDateTimeBestEffortUSOrZero(syslog_before, 'US/Samoa') - time_shift AS res_us_zero_sam,
-    parseDateTimeBestEffortUSOrZero(syslog_before, 'Pacific/Auckland') - time_shift AS res_us_zero_auc,
     parseDateTime64BestEffort(syslog_before) - time_shift AS res64,
-    parseDateTime64BestEffort(syslog_before, 3, 'US/Samoa') - time_shift AS res64_sam,
-    parseDateTime64BestEffort(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_auc,
     parseDateTime64BestEffortOrNull(syslog_before) - time_shift AS res64_null,
-    parseDateTime64BestEffortOrNull(syslog_before, 3, 'US/Samoa') - time_shift AS res64_null_sam,
-    parseDateTime64BestEffortOrNull(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_null_auc,
     parseDateTime64BestEffortOrZero(syslog_before) - time_shift AS res64_zero,
-    parseDateTime64BestEffortOrZero(syslog_before, 3, 'US/Samoa') - time_shift AS res64_zero_sam,
-    parseDateTime64BestEffortOrZero(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_zero_auc,
     parseDateTime64BestEffortUS(syslog_before) - time_shift AS res64_us,
-    parseDateTime64BestEffortUS(syslog_before, 3, 'US/Samoa') - time_shift AS res64_us_sam,
-    parseDateTime64BestEffortUS(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_auc,
     parseDateTime64BestEffortUSOrNull(syslog_before) - time_shift AS res64_us_null,
-    parseDateTime64BestEffortUSOrNull(syslog_before, 3, 'US/Samoa') - time_shift AS res64_us_null_sam,
-    parseDateTime64BestEffortUSOrNull(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_null_auc,
-    parseDateTime64BestEffortUSOrZero(syslog_before) - time_shift AS res64_us_zero,
-    parseDateTime64BestEffortUSOrZero(syslog_before, 3, 'US/Samoa') - time_shift AS res64_us_zero_sam,
-    parseDateTime64BestEffortUSOrZero(syslog_before, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
+    parseDateTime64BestEffortUSOrZero(syslog_before) - time_shift AS res64_us_zero
 FORMAT Vertical;
 
 SELECT '──────────────────────────────────────────────';
@@ -62,39 +38,15 @@ WITH
 SELECT
     formatDateTime(dt_after - time_shift, '%b %e %T') AS syslog_arg,
     parseDateTimeBestEffort(syslog_after) - time_shift AS res,
-    parseDateTimeBestEffort(syslog_after, 'US/Samoa') - time_shift AS res_sam,
-    parseDateTimeBestEffort(syslog_after, 'Pacific/Auckland') - time_shift AS res_auc,
     parseDateTimeBestEffortOrNull(syslog_after) - time_shift AS res_null,
-    parseDateTimeBestEffortOrNull(syslog_after, 'US/Samoa') - time_shift AS res_null_sam,
-    parseDateTimeBestEffortOrNull(syslog_after, 'Pacific/Auckland') - time_shift AS res_null_auc,
     parseDateTimeBestEffortOrZero(syslog_after) - time_shift AS res_zero,
-    parseDateTimeBestEffortOrZero(syslog_after, 'US/Samoa') - time_shift AS res_zero_sam,
-    parseDateTimeBestEffortOrZero(syslog_after, 'Pacific/Auckland') - time_shift AS res_zero_auc,
     parseDateTimeBestEffortUS(syslog_after) - time_shift AS res_us,
-    parseDateTimeBestEffortUS(syslog_after, 'US/Samoa') - time_shift AS res_us_sam,
-    parseDateTimeBestEffortUS(syslog_after, 'Pacific/Auckland') - time_shift AS res_us_auc,
     parseDateTimeBestEffortUSOrNull(syslog_after) - time_shift AS res_us_null,
-    parseDateTimeBestEffortUSOrNull(syslog_after, 'US/Samoa') - time_shift AS res_us_null_sam,
-    parseDateTimeBestEffortUSOrNull(syslog_after, 'Pacific/Auckland') - time_shift AS res_us_null_auc,
     parseDateTimeBestEffortUSOrZero(syslog_after) - time_shift AS res_us_zero,
-    parseDateTimeBestEffortUSOrZero(syslog_after, 'US/Samoa') - time_shift AS res_us_zero_sam,
-    parseDateTimeBestEffortUSOrZero(syslog_after, 'Pacific/Auckland') - time_shift AS res_us_zero_auc,
     parseDateTime64BestEffort(syslog_after) - time_shift AS res64,
-    parseDateTime64BestEffort(syslog_after, 3, 'US/Samoa') - time_shift AS res64_sam,
-    parseDateTime64BestEffort(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_auc,
     parseDateTime64BestEffortOrNull(syslog_after) - time_shift AS res64_null,
-    parseDateTime64BestEffortOrNull(syslog_after, 3, 'US/Samoa') - time_shift AS res64_null_sam,
-    parseDateTime64BestEffortOrNull(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_null_auc,
     parseDateTime64BestEffortOrZero(syslog_after) - time_shift AS res64_zero,
-    parseDateTime64BestEffortOrZero(syslog_after, 3, 'US/Samoa') - time_shift AS res64_zero_sam,
-    parseDateTime64BestEffortOrZero(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_zero_auc,
     parseDateTime64BestEffortUS(syslog_after) - time_shift AS res64_us,
-    parseDateTime64BestEffortUS(syslog_after, 3, 'US/Samoa') - time_shift AS res64_us_sam,
-    parseDateTime64BestEffortUS(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_us_auc,
     parseDateTime64BestEffortUSOrNull(syslog_after) - time_shift AS res64_us_null,
-    parseDateTime64BestEffortUSOrNull(syslog_after, 3, 'US/Samoa') - time_shift AS res64_us_null_sam,
-    parseDateTime64BestEffortUSOrNull(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_us_null_auc,
-    parseDateTime64BestEffortUSOrZero(syslog_after) - time_shift AS res64_us_zero,
-    parseDateTime64BestEffortUSOrZero(syslog_after, 3, 'US/Samoa') - time_shift AS res64_us_zero_sam,
-    parseDateTime64BestEffortUSOrZero(syslog_after, 3, 'Pacific/Auckland') - time_shift AS res64_us_zero_auc
+    parseDateTime64BestEffortUSOrZero(syslog_after) - time_shift AS res64_us_zero
 FORMAT Vertical;

From d94e47a930daa8ef92ff02c5fb31c13f01bb67d6 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 16 Jun 2023 23:07:19 +0200
Subject: [PATCH 526/722] Compatibility with clang-17

---
 src/Storages/StorageReplicatedMergeTree.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index a2953230d98..5eeb87a4de1 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -9463,7 +9463,7 @@ void StorageReplicatedMergeTree::backupData(
     auto post_collecting_task = [shared_id,
                                  my_replica_name = getReplicaName(),
                                  coordination,
-                                 parts_backup_entries = std::move(parts_backup_entries),
+                                 my_parts_backup_entries = std::move(parts_backup_entries),
                                  &backup_entries_collector]()
     {
         Strings data_paths = coordination->getReplicatedDataPaths(shared_id);
@@ -9475,7 +9475,7 @@ void StorageReplicatedMergeTree::backupData(
         Strings part_names = coordination->getReplicatedPartNames(shared_id, my_replica_name);
         std::unordered_set<std::string_view> part_names_set{part_names.begin(), part_names.end()};
 
-        for (const auto & part_backup_entries : parts_backup_entries)
+        for (const auto & part_backup_entries : my_parts_backup_entries)
         {
             if (part_names_set.contains(part_backup_entries.part_name))
             {

From a18dc73271f8800d91de20d400845cbe87d8b1cb Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 16 Jun 2023 23:12:01 +0200
Subject: [PATCH 527/722] Fix error

---
 src/Storages/MergeTree/MergeTreeData.cpp | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index 90b78eb2fc2..3583ffffecf 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -4426,18 +4426,17 @@ void MergeTreeData::delayInsertOrThrowIfNeeded(Poco::Event * until, const Contex
                 allowed_parts_over_threshold = settings->inactive_parts_to_throw_insert - settings->inactive_parts_to_delay_insert;
         }
 
-        if (allowed_parts_over_threshold == 0 || parts_over_threshold > allowed_parts_over_threshold) [[unlikely]]
-            throw Exception(
-                ErrorCodes::LOGICAL_ERROR,
-                "Incorrect calculation of {} parts over threshold: allowed_parts_over_threshold={}, parts_over_threshold={}",
-                (use_active_parts_threshold ? "active" : "inactive"),
-                allowed_parts_over_threshold,
-                parts_over_threshold);
-
         const UInt64 max_delay_milliseconds = (settings->max_delay_to_insert > 0 ? settings->max_delay_to_insert * 1000 : 1000);
-        double delay_factor = static_cast<double>(parts_over_threshold) / allowed_parts_over_threshold;
-        const UInt64 min_delay_milliseconds = settings->min_delay_to_insert_ms;
-        delay_milliseconds = std::max(min_delay_milliseconds, static_cast<UInt64>(max_delay_milliseconds * delay_factor));
+        if (allowed_parts_over_threshold == 0 || parts_over_threshold > allowed_parts_over_threshold)
+        {
+            delay_milliseconds = max_delay_milliseconds;
+        }
+        else
+        {
+            double delay_factor = static_cast<double>(parts_over_threshold) / allowed_parts_over_threshold;
+            const UInt64 min_delay_milliseconds = settings->min_delay_to_insert_ms;
+            delay_milliseconds = std::max(min_delay_milliseconds, static_cast<UInt64>(max_delay_milliseconds * delay_factor));
+        }
     }
 
     ProfileEvents::increment(ProfileEvents::DelayedInserts);

From 06ee2ca153e060b17557030b7119f0ad62a4fe99 Mon Sep 17 00:00:00 2001
From: rfraposa <richraposa@gmail.com>
Date: Fri, 16 Jun 2023 15:22:47 -0600
Subject: [PATCH 528/722] Update redis.md

---
 docs/en/engines/table-engines/integrations/redis.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index a78942ab7bb..c1e88e7e92e 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -1,5 +1,5 @@
 ---
-slug: /en/sql-reference/table-functions/redis
+slug: /en/engines/table-engines/integrations/redis
 sidebar_position: 43
 sidebar_label: Redis
 ---
@@ -34,7 +34,7 @@ CREATE TABLE [IF NOT EXISTS] [db.]table_name
 - `primary` must be specified, it supports only one column in the primary key. The primary key will be serialized in binary as a Redis key.
 
 - columns other than the primary key will be serialized in binary as Redis value in corresponding order.
-  
+
 - queries with key equals or in filtering will be optimized to multi keys lookup from Redis. If queries without filtering key full table scan will happen which is a heavy operation.
 
 ## Usage Example {#usage-example}

From f412ba572d1d128cce251ddb4b324b084e002959 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 17 Jun 2023 00:46:48 +0300
Subject: [PATCH 529/722] Update 02722_database_filesystem.sh

---
 tests/queries/0_stateless/02722_database_filesystem.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/queries/0_stateless/02722_database_filesystem.sh b/tests/queries/0_stateless/02722_database_filesystem.sh
index 7466141d3e3..4ff659ee746 100755
--- a/tests/queries/0_stateless/02722_database_filesystem.sh
+++ b/tests/queries/0_stateless/02722_database_filesystem.sh
@@ -1,4 +1,5 @@
 #!/usr/bin/env bash
+# Tags: no-parallel
 
 CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh

From b902f5d045a70153ab49f34cf31850323ff2f9c8 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Sat, 17 Jun 2023 01:54:38 +0200
Subject: [PATCH 530/722] Small style corrections

---
 src/Databases/DatabaseFilesystem.cpp | 94 +++++++++++++++-------------
 src/Databases/DatabaseFilesystem.h   | 14 +++--
 src/Databases/DatabaseHDFS.cpp       | 50 +++++++--------
 src/Databases/DatabaseHDFS.h         | 12 ++--
 src/Databases/DatabaseS3.cpp         | 44 ++++++-------
 src/Databases/DatabaseS3.h           |  9 +--
 6 files changed, 114 insertions(+), 109 deletions(-)

diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
index cf45240a5f0..001aa1f9ef6 100644
--- a/src/Databases/DatabaseFilesystem.cpp
+++ b/src/Databases/DatabaseFilesystem.cpp
@@ -31,21 +31,22 @@ namespace ErrorCodes
 DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
     : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
 {
-    fs::path user_files_path;
-    const auto & application_type = context_->getApplicationType();
-
-    if (application_type != Context::ApplicationType::LOCAL)
-        user_files_path = fs::canonical(fs::path(getContext()->getUserFilesPath()));
+    bool is_local = context_->getApplicationType() == Context::ApplicationType::LOCAL;
+    fs::path user_files_path = is_local ? "" : fs::canonical(getContext()->getUserFilesPath());
 
     if (fs::path(path).is_relative())
+    {
         path = user_files_path / path;
-    else if (application_type != Context::ApplicationType::LOCAL && !pathStartsWith(fs::path(path), user_files_path))
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Path must be inside user-files path ({})", user_files_path.string());
-
-    path = fs::absolute(path).lexically_normal().string();
+    }
+    else if (!is_local && !pathStartsWith(fs::path(path), user_files_path))
+    {
+        throw Exception(ErrorCodes::BAD_ARGUMENTS,
+                        "Path must be inside user-files path: {}", user_files_path.string());
+    }
 
+    path = fs::absolute(path).lexically_normal();
     if (!fs::exists(path))
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Path does not exist ({})", path);
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Path does not exist: {}", path);
 }
 
 std::string DatabaseFilesystem::getTablePath(const std::string & table_name) const
@@ -62,19 +63,17 @@ void DatabaseFilesystem::addTable(const std::string & table_name, StoragePtr tab
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "Table with name `{}` already exists in database `{}` (engine {})",
-            table_name,
-            getDatabaseName(),
-            getEngineName());
+            table_name, getDatabaseName(), getEngineName());
 }
 
 bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const
 {
-    // If run in Local mode, no need for path checking.
-    bool need_check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
-    std::string user_files_path = fs::canonical(fs::path(context_->getUserFilesPath())).string();
+    /// If run in Local mode, no need for path checking.
+    bool check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
+    const auto & user_files_path = context_->getUserFilesPath();
 
-    // Check access for file before checking its existence
-    if (need_check_path && !fileOrSymlinkPathStartsWith(table_path, user_files_path))
+    /// Check access for file before checking its existence.
+    if (check_path && !fileOrSymlinkPathStartsWith(table_path, user_files_path))
     {
         if (throw_on_error)
             throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED, "File is not inside {}", user_files_path);
@@ -82,11 +81,20 @@ bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, Cont
             return false;
     }
 
-    // Check if the corresponding file exists
-    if (!fs::exists(table_path) || !fs::is_regular_file(table_path))
+    /// Check if the corresponding file exists.
+    if (!fs::exists(table_path))
     {
         if (throw_on_error)
-            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "File does not exist ({})", table_path);
+            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "File does not exist: {}", table_path);
+        else
+            return false;
+    }
+
+    if (!fs::is_regular_file(table_path))
+    {
+        if (throw_on_error)
+            throw Exception(ErrorCodes::FILE_DOESNT_EXIST,
+                            "File is directory, but expected a file: {}", table_path);
         else
             return false;
     }
@@ -104,7 +112,7 @@ StoragePtr DatabaseFilesystem::tryGetTableFromCache(const std::string & name) co
             table = it->second;
     }
 
-    // invalidate cache if file no longer exists
+    /// Invalidate cache if file no longer exists.
     if (table && !fs::exists(getTablePath(name)))
     {
         std::lock_guard lock(mutex);
@@ -120,29 +128,26 @@ bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr context_)
     if (tryGetTableFromCache(name))
         return true;
 
-    fs::path table_file_path(getTablePath(name));
-
-    return checkTableFilePath(table_file_path, context_, false);
+    return checkTableFilePath(getTablePath(name), context_, /* throw_on_error */false);
 }
 
 StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr context_) const
 {
-    // Check if table exists in loaded tables map
+    /// Check if table exists in loaded tables map.
     if (auto table = tryGetTableFromCache(name))
         return table;
 
     auto table_path = getTablePath(name);
+    checkTableFilePath(table_path, context_, /* throw_on_error */true);
 
-    checkTableFilePath(table_path, context_, true);
-
-    // If the file exists, create a new table using TableFunctionFile and return it.
+    /// If the file exists, create a new table using TableFunctionFile and return it.
     auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
 
     auto table_function = TableFunctionFactory::instance().get(args, context_);
     if (!table_function)
         return nullptr;
 
-    // TableFunctionFile throws exceptions, if table cannot be created
+    /// TableFunctionFile throws exceptions, if table cannot be created.
     auto table_storage = table_function->execute(args, context_, name);
     if (table_storage)
         addTable(name, table_storage);
@@ -152,10 +157,12 @@ StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr cont
 
 StoragePtr DatabaseFilesystem::getTable(const String & name, ContextPtr context_) const
 {
-    // rethrow all exceptions from TableFunctionFile to show correct error to user
+    /// getTableImpl can throw exceptions, do not catch them to show correct error to user.
     if (auto storage = getTableImpl(name, context_))
         return storage;
-    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
+
+    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist",
+                    backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
 }
 
 StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const
@@ -166,15 +173,14 @@ StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr conte
     }
     catch (const Exception & e)
     {
-        // Ignore exceptions thrown by TableFunctionFile, which indicate that there is no table
-        // see tests/02722_database_filesystem.sh for more details
-        if (e.code() == ErrorCodes::BAD_ARGUMENTS)
+        /// Ignore exceptions thrown by TableFunctionFile, which indicate that there is no table
+        /// see tests/02722_database_filesystem.sh for more details.
+        if (e.code() == ErrorCodes::BAD_ARGUMENTS
+            || e.code() == ErrorCodes::DATABASE_ACCESS_DENIED
+            || e.code() == ErrorCodes::FILE_DOESNT_EXIST)
+        {
             return nullptr;
-        if (e.code() == ErrorCodes::DATABASE_ACCESS_DENIED)
-            return nullptr;
-        if (e.code() == ErrorCodes::FILE_DOESNT_EXIST)
-            return nullptr;
-
+        }
         throw;
     }
 }
@@ -187,10 +193,10 @@ bool DatabaseFilesystem::empty() const
 
 ASTPtr DatabaseFilesystem::getCreateDatabaseQuery() const
 {
-    auto settings = getContext()->getSettingsRef();
-    ParserCreateQuery parser;
-
+    const auto & settings = getContext()->getSettingsRef();
     const String query = fmt::format("CREATE DATABASE {} ENGINE = Filesystem('{}')", backQuoteIfNeed(getDatabaseName()), path);
+
+    ParserCreateQuery parser;
     ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
 
     if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
@@ -238,4 +244,4 @@ DatabaseTablesIteratorPtr DatabaseFilesystem::getTablesIterator(ContextPtr, cons
     return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
 }
 
-} // DB
+}
diff --git a/src/Databases/DatabaseFilesystem.h b/src/Databases/DatabaseFilesystem.h
index 350ebfe37a3..5e32342d58f 100644
--- a/src/Databases/DatabaseFilesystem.h
+++ b/src/Databases/DatabaseFilesystem.h
@@ -12,11 +12,13 @@ namespace DB
 class Context;
 
 /**
-  * DatabaseFilesystem allows to interact with files stored on the file system
-  * Uses TableFunctionFile to implicitly load file when a user requests the table, and provides read-only access to the data in the file
+  * DatabaseFilesystem allows to interact with files stored on the local filesystem.
+  * Uses TableFunctionFile to implicitly load file when a user requests the table,
+  * and provides a read-only access to the data in the file.
   * Tables are cached inside the database for quick access
   *
-  * Used in clickhouse-local to access local files
+  * Used in clickhouse-local to access local files.
+  * For clickhouse-server requires allows to access file only fron user_files directory.
   */
 class DatabaseFilesystem : public IDatabase, protected WithContext
 {
@@ -31,8 +33,7 @@ public:
 
     StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
 
-    // Contains only temporary tables
-    bool shouldBeEmptyOnDetach() const override { return false; }
+    bool shouldBeEmptyOnDetach() const override { return false; } /// Contains only temporary tables.
 
     bool empty() const override;
 
@@ -43,6 +44,7 @@ public:
     void shutdown() override;
 
     std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
+
     DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
 
 protected:
@@ -62,4 +64,4 @@ private:
     Poco::Logger * log;
 };
 
-} // DB
+}
diff --git a/src/Databases/DatabaseHDFS.cpp b/src/Databases/DatabaseHDFS.cpp
index 34cb337cdbe..1a0145b9015 100644
--- a/src/Databases/DatabaseHDFS.cpp
+++ b/src/Databases/DatabaseHDFS.cpp
@@ -49,7 +49,9 @@ DatabaseHDFS::DatabaseHDFS(const String & name_, const String & source_url, Cont
     if (!source.empty())
     {
         if (!re2::RE2::FullMatch(source, std::string(HDFS_HOST_REGEXP)))
-            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs host: {}. It should have structure 'hdfs://<host_name>:<port>'", source);
+            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs host: {}. "
+                            "It should have structure 'hdfs://<host_name>:<port>'", source);
+
         context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(source));
     }
 }
@@ -62,18 +64,19 @@ void DatabaseHDFS::addTable(const std::string & table_name, StoragePtr table_sto
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "Table with name `{}` already exists in database `{}` (engine {})",
-            table_name,
-            getDatabaseName(),
-            getEngineName());
+            table_name, getDatabaseName(), getEngineName());
 }
 
 std::string DatabaseHDFS::getTablePath(const std::string & table_name) const
 {
     if (table_name.starts_with("hdfs://"))
         return table_name;
+
     if (source.empty())
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs url: {}. It should have structure 'hdfs://<host_name>:<port>/path'", table_name);
-    return (fs::path(source) / table_name).string();
+        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs url: {}. "
+                        "It should have structure 'hdfs://<host_name>:<port>/path'", table_name);
+
+    return fs::path(source) / table_name;
 }
 
 bool DatabaseHDFS::checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const
@@ -104,7 +107,7 @@ bool DatabaseHDFS::isTableExist(const String & name, ContextPtr context_) const
 
 StoragePtr DatabaseHDFS::getTableImpl(const String & name, ContextPtr context_) const
 {
-    // Check if the table exists in the loaded tables map
+    /// Check if the table exists in the loaded tables map.
     {
         std::lock_guard lock(mutex);
         auto it = loaded_tables.find(name);
@@ -116,14 +119,13 @@ StoragePtr DatabaseHDFS::getTableImpl(const String & name, ContextPtr context_)
 
     checkUrl(url, context_, true);
 
-    // call TableFunctionHDFS
     auto args = makeASTFunction("hdfs", std::make_shared<ASTLiteral>(url));
 
     auto table_function = TableFunctionFactory::instance().get(args, context_);
     if (!table_function)
         return nullptr;
 
-    // TableFunctionHDFS throws exceptions, if table cannot be created
+    /// TableFunctionHDFS throws exceptions, if table cannot be created.
     auto table_storage = table_function->execute(args, context_, name);
     if (table_storage)
         addTable(name, table_storage);
@@ -133,10 +135,12 @@ StoragePtr DatabaseHDFS::getTableImpl(const String & name, ContextPtr context_)
 
 StoragePtr DatabaseHDFS::getTable(const String & name, ContextPtr context_) const
 {
-    // rethrow all exceptions from TableFunctionHDFS to show correct error to user
+    /// Rethrow all exceptions from TableFunctionHDFS to show correct error to user.
     if (auto storage = getTableImpl(name, context_))
         return storage;
-    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
+
+    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist",
+                    backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
 }
 
 StoragePtr DatabaseHDFS::tryGetTable(const String & name, ContextPtr context_) const
@@ -148,20 +152,16 @@ StoragePtr DatabaseHDFS::tryGetTable(const String & name, ContextPtr context_) c
     catch (const Exception & e)
     {
         // Ignore exceptions thrown by TableFunctionHDFS, which indicate that there is no table
-        if (e.code() == ErrorCodes::BAD_ARGUMENTS)
-            return nullptr;
-        if (e.code() == ErrorCodes::ACCESS_DENIED)
-            return nullptr;
-        if (e.code() == ErrorCodes::DATABASE_ACCESS_DENIED)
-            return nullptr;
-        if (e.code() == ErrorCodes::FILE_DOESNT_EXIST)
-            return nullptr;
-        if (e.code() == ErrorCodes::UNACCEPTABLE_URL)
-            return nullptr;
-        if (e.code() == ErrorCodes::HDFS_ERROR)
-            return nullptr;
-        if (e.code() == ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE)
+        if (e.code() == ErrorCodes::BAD_ARGUMENTS
+            || e.code() == ErrorCodes::ACCESS_DENIED
+            || e.code() == ErrorCodes::DATABASE_ACCESS_DENIED
+            || e.code() == ErrorCodes::FILE_DOESNT_EXIST
+            || e.code() == ErrorCodes::UNACCEPTABLE_URL
+            || e.code() == ErrorCodes::HDFS_ERROR
+            || e.code() == ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE)
+        {
             return nullptr;
+        }
         throw;
     }
     catch (const Poco::URISyntaxException &)
@@ -178,7 +178,7 @@ bool DatabaseHDFS::empty() const
 
 ASTPtr DatabaseHDFS::getCreateDatabaseQuery() const
 {
-    auto settings = getContext()->getSettingsRef();
+    const auto & settings = getContext()->getSettingsRef();
     ParserCreateQuery parser;
 
     const String query = fmt::format("CREATE DATABASE {} ENGINE = HDFS('{}')", backQuoteIfNeed(getDatabaseName()), source);
diff --git a/src/Databases/DatabaseHDFS.h b/src/Databases/DatabaseHDFS.h
index c7071370b5e..957b2080135 100644
--- a/src/Databases/DatabaseHDFS.h
+++ b/src/Databases/DatabaseHDFS.h
@@ -16,9 +16,10 @@ namespace DB
 class Context;
 
 /**
-  * DatabaseHDFS allows to interact with files stored on the file system
-  * Uses TableFunctionHDFS to implicitly load file when a user requests the table, and provides read-only access to the data in the file
-  * Tables are cached inside the database for quick access
+  * DatabaseHDFS allows to interact with files stored on the file system.
+  * Uses TableFunctionHDFS to implicitly load file when a user requests the table,
+  * and provides read-only access to the data in the file.
+  * Tables are cached inside the database for quick access.
   */
 class DatabaseHDFS : public IDatabase, protected WithContext
 {
@@ -33,8 +34,7 @@ public:
 
     StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
 
-    // Contains only temporary tables
-    bool shouldBeEmptyOnDetach() const override { return false; }
+    bool shouldBeEmptyOnDetach() const override { return false; } /// Contains only temporary tables.
 
     bool empty() const override;
 
@@ -63,6 +63,6 @@ private:
     Poco::Logger * log;
 };
 
-} // DB
+}
 
 #endif
diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
index 46f8a67687d..11655f5f100 100644
--- a/src/Databases/DatabaseS3.cpp
+++ b/src/Databases/DatabaseS3.cpp
@@ -60,15 +60,13 @@ void DatabaseS3::addTable(const std::string & table_name, StoragePtr table_stora
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "Table with name `{}` already exists in database `{}` (engine {})",
-            table_name,
-            getDatabaseName(),
-            getEngineName());
+            table_name, getDatabaseName(), getEngineName());
 }
 
 std::string DatabaseS3::getFullUrl(const std::string & name) const
 {
     if (!config.url_prefix.empty())
-        return (fs::path(config.url_prefix) / name).string();
+        return fs::path(config.url_prefix) / name;
 
     return name;
 }
@@ -100,7 +98,7 @@ bool DatabaseS3::isTableExist(const String & name, ContextPtr context_) const
 
 StoragePtr DatabaseS3::getTableImpl(const String & name, ContextPtr context_) const
 {
-    // Check if the table exists in the loaded tables map
+    /// Check if the table exists in the loaded tables map.
     {
         std::lock_guard lock(mutex);
         auto it = loaded_tables.find(name);
@@ -109,12 +107,9 @@ StoragePtr DatabaseS3::getTableImpl(const String & name, ContextPtr context_) co
     }
 
     auto url = getFullUrl(name);
+    checkUrl(url, context_, /* throw_on_error */true);
 
-    checkUrl(url, context_, true);
-
-    // call TableFunctionS3
     auto function = std::make_shared<ASTFunction>();
-
     function->name = "s3";
     function->arguments = std::make_shared<ASTExpressionList>();
     function->children.push_back(function->arguments);
@@ -134,7 +129,7 @@ StoragePtr DatabaseS3::getTableImpl(const String & name, ContextPtr context_) co
     if (!table_function)
         return nullptr;
 
-    // TableFunctionS3 throws exceptions, if table cannot be created
+    /// TableFunctionS3 throws exceptions, if table cannot be created.
     auto table_storage = table_function->execute(function, context_, name);
     if (table_storage)
         addTable(name, table_storage);
@@ -144,10 +139,12 @@ StoragePtr DatabaseS3::getTableImpl(const String & name, ContextPtr context_) co
 
 StoragePtr DatabaseS3::getTable(const String & name, ContextPtr context_) const
 {
-    // rethrow all exceptions from TableFunctionS3 to show correct error to user
+    /// Rethrow all exceptions from TableFunctionS3 to show correct error to user.
     if (auto storage = getTableImpl(name, context_))
         return storage;
-    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist", backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
+
+    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist",
+                    backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
 }
 
 StoragePtr DatabaseS3::tryGetTable(const String & name, ContextPtr context_) const
@@ -158,15 +155,14 @@ StoragePtr DatabaseS3::tryGetTable(const String & name, ContextPtr context_) con
     }
     catch (const Exception & e)
     {
-        // Ignore exceptions thrown by TableFunctionS3, which indicate that there is no table
-        if (e.code() == ErrorCodes::BAD_ARGUMENTS)
-            return nullptr;
-        if (e.code() == ErrorCodes::S3_ERROR)
-            return nullptr;
-        if (e.code() == ErrorCodes::FILE_DOESNT_EXIST)
-            return nullptr;
-        if (e.code() == ErrorCodes::UNACCEPTABLE_URL)
+        /// Ignore exceptions thrown by TableFunctionS3, which indicate that there is no table.
+        if (e.code() == ErrorCodes::BAD_ARGUMENTS
+            || e.code() == ErrorCodes::S3_ERROR
+            || e.code() == ErrorCodes::FILE_DOESNT_EXIST
+            || e.code() == ErrorCodes::UNACCEPTABLE_URL)
+        {
             return nullptr;
+        }
         throw;
     }
     catch (const Poco::URISyntaxException &)
@@ -183,7 +179,7 @@ bool DatabaseS3::empty() const
 
 ASTPtr DatabaseS3::getCreateDatabaseQuery() const
 {
-    auto settings = getContext()->getSettingsRef();
+    const auto & settings = getContext()->getSettingsRef();
     ParserCreateQuery parser;
 
     std::string creation_args;
@@ -236,8 +232,8 @@ DatabaseS3::Configuration DatabaseS3::parseArguments(ASTs engine_args, ContextPt
         result.url_prefix = collection.getOrDefault<String>("url", "");
         result.no_sign_request = collection.getOrDefault<bool>("no_sign_request", false);
 
-        auto key_id = collection.getOrDefault<std::string>("access_key_id", "");
-        auto secret_key = collection.getOrDefault<std::string>("secret_access_key", "");
+        auto key_id = collection.getOrDefault<String>("access_key_id", "");
+        auto secret_key = collection.getOrDefault<String>("secret_access_key", "");
 
         if (!key_id.empty())
             result.access_key_id = key_id;
@@ -311,6 +307,6 @@ DatabaseTablesIteratorPtr DatabaseS3::getTablesIterator(ContextPtr, const Filter
     return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
 }
 
-} // DB
+}
 
 #endif
diff --git a/src/Databases/DatabaseS3.h b/src/Databases/DatabaseS3.h
index f494925b09b..8297ae4e02d 100644
--- a/src/Databases/DatabaseS3.h
+++ b/src/Databases/DatabaseS3.h
@@ -16,9 +16,10 @@ namespace DB
 class Context;
 
 /**
-  * DatabaseS3 provides access to data stored in S3
-  * Uses TableFunctionS3 to implicitly load file when a user requests the table, and provides read-only access to the data in the file
-  * Tables are cached inside the database for quick access
+  * DatabaseS3 provides access to data stored in S3.
+  * Uses TableFunctionS3 to implicitly load file when a user requests the table,
+  * and provides read-only access to the data in the file.
+  * Tables are cached inside the database for quick access.
   */
 class DatabaseS3 : public IDatabase, protected WithContext
 {
@@ -75,6 +76,6 @@ private:
     Poco::Logger * log;
 };
 
-} // DB
+}
 
 #endif

From 74f2dea57b1141f62a591e3ff77c866dd60fd395 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Sat, 17 Jun 2023 02:11:48 +0200
Subject: [PATCH 531/722] Fix typo

---
 src/Databases/DatabaseFilesystem.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Databases/DatabaseFilesystem.h b/src/Databases/DatabaseFilesystem.h
index 5e32342d58f..7fe620401dc 100644
--- a/src/Databases/DatabaseFilesystem.h
+++ b/src/Databases/DatabaseFilesystem.h
@@ -18,7 +18,7 @@ class Context;
   * Tables are cached inside the database for quick access
   *
   * Used in clickhouse-local to access local files.
-  * For clickhouse-server requires allows to access file only fron user_files directory.
+  * For clickhouse-server requires allows to access file only from user_files directory.
   */
 class DatabaseFilesystem : public IDatabase, protected WithContext
 {

From c5536e4906f41b2e340b1e3bfc634d2ed0ddda9e Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Fri, 16 Jun 2023 18:42:08 +0000
Subject: [PATCH 532/722] Fix ColumnConst::forEachSubcolumn

---
 src/Columns/ColumnConst.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Columns/ColumnConst.h b/src/Columns/ColumnConst.h
index fcdcd2ce224..f769dd6cc2a 100644
--- a/src/Columns/ColumnConst.h
+++ b/src/Columns/ColumnConst.h
@@ -230,12 +230,12 @@ public:
         data->getExtremes(min, max);
     }
 
-    void forEachSubcolumn(ColumnCallback callback) const override
+    void forEachSubcolumn(MutableColumnCallback callback) override
     {
         callback(data);
     }
 
-    void forEachSubcolumnRecursively(RecursiveColumnCallback callback) const override
+    void forEachSubcolumnRecursively(RecursiveMutableColumnCallback callback) override
     {
         callback(*data);
         data->forEachSubcolumnRecursively(callback);

From 03baa19e885772190e9b8f348840b50cf2350dca Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Fri, 9 Jun 2023 21:58:25 +0000
Subject: [PATCH 533/722] Fix ParallelReadBuffer seek

---
 src/IO/ParallelReadBuffer.cpp                       |  5 +++--
 ...quet_s3.reference => 02731_formats_s3.reference} |  1 +
 tests/queries/0_stateless/02731_formats_s3.sql      | 13 +++++++++++++
 tests/queries/0_stateless/02731_parquet_s3.sql      |  7 -------
 4 files changed, 17 insertions(+), 9 deletions(-)
 rename tests/queries/0_stateless/{02731_parquet_s3.reference => 02731_formats_s3.reference} (58%)
 create mode 100644 tests/queries/0_stateless/02731_formats_s3.sql
 delete mode 100644 tests/queries/0_stateless/02731_parquet_s3.sql

diff --git a/src/IO/ParallelReadBuffer.cpp b/src/IO/ParallelReadBuffer.cpp
index 07240ab3a4f..fd228336093 100644
--- a/src/IO/ParallelReadBuffer.cpp
+++ b/src/IO/ParallelReadBuffer.cpp
@@ -125,9 +125,10 @@ off_t ParallelReadBuffer::seek(off_t offset, int whence)
             if (w->bytes_produced > diff)
             {
                 working_buffer = internal_buffer = Buffer(
-                    w->segment.data() + diff, w->segment.data() + w->bytes_produced);
+                    w->segment.data(), w->segment.data() + w->bytes_produced);
+                pos = working_buffer.begin() + diff;
                 w->bytes_consumed = w->bytes_produced;
-                current_position += w->start_offset + w->bytes_consumed;
+                current_position = w->start_offset + w->bytes_consumed;
                 addReaders();
                 return offset;
             }
diff --git a/tests/queries/0_stateless/02731_parquet_s3.reference b/tests/queries/0_stateless/02731_formats_s3.reference
similarity index 58%
rename from tests/queries/0_stateless/02731_parquet_s3.reference
rename to tests/queries/0_stateless/02731_formats_s3.reference
index 5a5aaeb0068..85abd7f379c 100644
--- a/tests/queries/0_stateless/02731_parquet_s3.reference
+++ b/tests/queries/0_stateless/02731_formats_s3.reference
@@ -1 +1,2 @@
 12639441726720293784
+49999995000000
diff --git a/tests/queries/0_stateless/02731_formats_s3.sql b/tests/queries/0_stateless/02731_formats_s3.sql
new file mode 100644
index 00000000000..3fc3451803a
--- /dev/null
+++ b/tests/queries/0_stateless/02731_formats_s3.sql
@@ -0,0 +1,13 @@
+-- Tags: no-fasttest
+-- Tag no-fasttest: Depends on AWS
+
+-- Reading from s3 a parquet file of size between ~1 MB and ~2 MB was broken at some point
+-- (bug in CachedOnDiskReadBufferFromFile).
+insert into function s3(s3_conn, filename='test_02731_parquet.parquet') select cityHash64(number) from numbers(170000) settings s3_truncate_on_insert=1;
+
+select sum(*) from s3(s3_conn, filename='test_02731_parquet.parquet') settings remote_filesystem_read_method='threadpool', remote_filesystem_read_prefetch=1;
+
+-- Reading from s3 of arrow files of ~40 MB was broken at some point (but in ParallelReadBuffer).
+insert into function s3(s3_conn, filename='test_02731_arrow.arrow') select * from numbers(10000000) settings s3_truncate_on_insert=1;
+
+select sum(*) from s3(s3_conn, filename='test_02731_arrow.arrow') settings remote_filesystem_read_method='read', max_download_buffer_size = 10485760;
diff --git a/tests/queries/0_stateless/02731_parquet_s3.sql b/tests/queries/0_stateless/02731_parquet_s3.sql
deleted file mode 100644
index 3c3f11f535b..00000000000
--- a/tests/queries/0_stateless/02731_parquet_s3.sql
+++ /dev/null
@@ -1,7 +0,0 @@
--- Tags: no-fasttest
--- Tag no-fasttest: Depends on AWS
-
--- Reading from s3 a parquet file of size between ~1 MB and ~2 MB was broken at some point.
-insert into function s3(s3_conn, filename='test_02731_parquet_s3.parquet') select cityHash64(number) from numbers(170000) settings s3_truncate_on_insert=1;
-
-select sum(*) from s3(s3_conn, filename='test_02731_parquet_s3.parquet') settings remote_filesystem_read_method='threadpool', remote_filesystem_read_prefetch=1;

From 41563e43a85caa5d51f3de54496094d480746f36 Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Wed, 14 Jun 2023 19:36:35 +0000
Subject: [PATCH 534/722] Put test files into data_minio instead of generating
 them in the test

---
 .../0_stateless/02731_formats_s3.reference    |   2 +-
 .../queries/0_stateless/02731_formats_s3.sql  |  11 ++++-------
 .../0_stateless/data_minio/02731.arrow        | Bin 0 -> 4006162 bytes
 .../0_stateless/data_minio/02731.parquet      | Bin 0 -> 1645684 bytes
 4 files changed, 5 insertions(+), 8 deletions(-)
 create mode 100644 tests/queries/0_stateless/data_minio/02731.arrow
 create mode 100644 tests/queries/0_stateless/data_minio/02731.parquet

diff --git a/tests/queries/0_stateless/02731_formats_s3.reference b/tests/queries/0_stateless/02731_formats_s3.reference
index 85abd7f379c..dda2f3383fc 100644
--- a/tests/queries/0_stateless/02731_formats_s3.reference
+++ b/tests/queries/0_stateless/02731_formats_s3.reference
@@ -1,2 +1,2 @@
 12639441726720293784
-49999995000000
+499999500000
diff --git a/tests/queries/0_stateless/02731_formats_s3.sql b/tests/queries/0_stateless/02731_formats_s3.sql
index 3fc3451803a..e54a1c10b5d 100644
--- a/tests/queries/0_stateless/02731_formats_s3.sql
+++ b/tests/queries/0_stateless/02731_formats_s3.sql
@@ -3,11 +3,8 @@
 
 -- Reading from s3 a parquet file of size between ~1 MB and ~2 MB was broken at some point
 -- (bug in CachedOnDiskReadBufferFromFile).
-insert into function s3(s3_conn, filename='test_02731_parquet.parquet') select cityHash64(number) from numbers(170000) settings s3_truncate_on_insert=1;
+select sum(*) from s3(s3_conn, filename='02731.parquet') settings remote_filesystem_read_method='threadpool', remote_filesystem_read_prefetch=1;
 
-select sum(*) from s3(s3_conn, filename='test_02731_parquet.parquet') settings remote_filesystem_read_method='threadpool', remote_filesystem_read_prefetch=1;
-
--- Reading from s3 of arrow files of ~40 MB was broken at some point (but in ParallelReadBuffer).
-insert into function s3(s3_conn, filename='test_02731_arrow.arrow') select * from numbers(10000000) settings s3_truncate_on_insert=1;
-
-select sum(*) from s3(s3_conn, filename='test_02731_arrow.arrow') settings remote_filesystem_read_method='read', max_download_buffer_size = 10485760;
+-- Reading from s3 of arrow files of ~40 MB (max_download_buffer_size * 4) was broken at some point
+-- (bug in ParallelReadBuffer).
+select sum(*) from s3(s3_conn, filename='02731.arrow') settings remote_filesystem_read_method='read', max_download_buffer_size = 1048576;
diff --git a/tests/queries/0_stateless/data_minio/02731.arrow b/tests/queries/0_stateless/data_minio/02731.arrow
new file mode 100644
index 0000000000000000000000000000000000000000..ee1046403657f11449049bf0456b16ac6cd979e9
GIT binary patch
literal 4006162
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

literal 0
HcmV?d00001

diff --git a/tests/queries/0_stateless/data_minio/02731.parquet b/tests/queries/0_stateless/data_minio/02731.parquet
new file mode 100644
index 0000000000000000000000000000000000000000..8300a18642a52311b46e5ae6272f72e3de9280d9
GIT binary patch
literal 1645684
zcmeF&!<H!8t^m-oZQHiJ%eHOXwr$(CZQHhO*Sr7m&T6HZF+0gfvg8F78Bsw{{r&v`
zQH%Ti0j2*JBA@~w0RY_p{rCP8_)p+Jf&T>l6ZlWyKY{-Q{uB65;6H)?1pX8FPvHNZ
z03Z{aGuJL2vJk_*#Z$4=WTHs4j4H@*^!F!-ChyE!d<eql#xU^7xE0;<#HIe2>Jr5|
z`{C*Ga((!CoQ(gecZaZ8-JkuQZlMAXj_Wm=H1CNBqOq*OrAsyx$VMP9yjG((bb{-#
zs26!2$6aB_W78$Ht)U_{v-4V6_1rAEp^${Afo&JN`3WasYsK`;ZVmPZJIY~i9j9Vq
zT?4(ElFu;+*aOB)0@_t-!ZIP_)wtZ`zArJ?o=)^y^9=WKhM@+}J<+8$33Q%8CdLBx
zW<tyMkdrLJa_02vGIkKpgLKN4Yvg5BIW-DKkQ=<5yyFy8J6&eo8U%0pU2FK>Zds?%
z<8MB&I2tNeC>dbLiK<p{n>L=&HB3IWF^g`Idc$Hq!&ioMuM~c-{UEMiqBnMBXpX6a
zd@D4Za;pAFYhI71_v_!UFy(}~@SFtCP*Da2{*B~~OCAbA04NySEUL$SU!LCC+qnUz
ztZ;&V{Z!q0m&4z|?2F$@Y6$1q`INo4aU-`=jkkRW*vat1pp~tz)&P^?w_@g{7{HAl
z-X=4fIL`_H6FydV9CGVL5_>=~tGdcH?Nk&QDY)67;veXDN38!Hd`(7r!Nu8;5-6ck
z4#qcddsGH<6~&e<)ykPq6BI8JX$d$9<wqb8C`QRvVuiIYG&=Ke&{?VG4Tw6-2(R|j
zM=7{VdZc#aoJqNaNb0?1e5w$<OT3V<OlQ4J)eM`egB2#9)6&0K9o{~prRcDTj=UgW
zHhs-G$^3VS<@IUTKYGF|FM)nWCBPTZWa6&CfaD_YW<x|VCl;T?VdT0wmIF9WIrdfz
zMWs>dSiIts317v|+Uw4ERT0Qk1+zSXSo)CI0QGm8N{<}3^cBy4r?v>>@66!%-mj&P
z=qDG2982MvGPIKTiw=D~7BFOJPGyU%Ow^JNlPqdeAump3?vR35=z9engdmka<_&|3
zt2{I?QbM<9t!PMWa!&F2B4^1Qfd2}e15glJIm0P`_ZsNwNG$gcOZnnpM7z;IFQ12L
zCL~tX$j=ji7A4h?EdtPY8k>fH4ixYuLoMV;{WmuKnQ)E*CVjJGj6q58!5VCW{*k9+
zl+o#5?CRu7xqwza;u7%;v8*a*lpY94-Q>dhaQVvZTE>2p`|A1fw=g;mCDVf}^&tG!
zwv=B_H&t0wY#Q?Y$_lM)M@N<Dz`P%f<xpk0JF!>cZ`s_a6cu!@TZruBzg{O()ZFB0
zjX;j+9|q*v&&-MD57yRt(8My3XFzIO$h(0xdObH?0eiJ9P+J;aH^%S1)<Cc}+p)sq
zJ+4>6m)GKz7U*JWVPIu=X`Vc~r;17#m^|pS+nd3yb}YxQnCmYXrPu~y^(59amiC{q
zQ84uVjkzGt*pumVz?~}sDHdhDi&D+GYh?N*C{--DV*df{*|QHgEtG(eac>}TYpa=6
zz-RV?k{-#9gk@5D8%=PPX7^iovq+ij`aWE2P>&QK=;}>9FK2UEb!Svn|7#p7f<SdN
zj|+U8r@8`R6G=dOFVmH5QhwQM7(mLnFh;($@%^<Uo-&s_?yg&BJ#n)-td)RkKdA!F
z0AG#}n9NbP+Z#&ZMhV($VU7kB0aR~zK^$Ab{imiIi2wk5eJ%xYho|Di?zZfqmB3GL
zeV4)<Q6+hy?hvkxYwVs+CXT6<aV$DhMt_Ika<Di8w#!LS3I2qX_>xsU{Cv_};hsGh
z_X7=l4+lC6@8IX{?8b=3mZ}|ADQ82YC<rAJX?Jm$N^+T*LX-}hgPh<bNdQB95zlFS
z&~Ou!0xz36&185YZI0oigCXA0aZ(Ye{QGTs6j<#B=fPh;(-BW<Jb!D|kwm$E3=Yyw
z4A9>XT%7^}naugc$b33mCvc9a|4zC}X|@^F7iztGcHZ*?qefZJlsk7dT)+;R#Yg4K
zmivSPFSU|pH3!9C>LlbEP^!4YLPu`-pt;9;*&1|%k<>?8X1&(t6F3o4cB~;D^~TYq
zr$%HQ=>x7NyZR9YW`1nfyPGU&i1<clllzG_sCfG~;oa@UV%Pz?euLK_DuaQ!)pZ9Y
zcj)nIUr%EgTV9mBu44s4-(yhY*^2~`Mq+1yhfCN<&FuX!)(K{;zJ@<-+dg{~k3S+Y
zw$SK$Nf1Fz$nw7NB9hD(cFbimA5bRSP(45(Wg46PZGVbY>2{*gj#Np^6sf(bFl__O
zCF<x5gJD4gvhp>GOepcrp7k(z3exz+Ufn-RaVS3w5<>nsXCSC{g9VgD@eSu0SbbZr
zV@t?p)t+fy4UnVY2PSLO&la^!T1mGo^D}dUQd5o^3u+6xW8L=d`WhN8?~}xwoyuD5
z!NDD}Cw!KAc?z!g8ID+<)(z_@=i;iYV?4pm!6b1(+HK5NEdr=R=9$%Q4WmP}_opDZ
z+8RiQPkvmh2E`r7sCa21tB#Nbtu=c9b9#9pI!DW(Ub?ERBOGyCFj*93?j{>%d>OOb
zGRaac$d|k|xfk&^4hpKYmffp+2Ry5E`oRoaIK6LlmJ!7~hBw~rhfxUI(te-kYQp75
z>{F3R>#xD<1T9=(0%pM00~`60I9OrFR6}{ss?onj!bM;RkMfr<`Mi1FG2k=ujW-%~
zJ#F+$d5)fGR{Yaiv;3ewo{DVkB0u~@cm>S}qq<+Ub#W9hY}vAXp;A+KavKK>KhB~U
z_mD_#XCl-1vdpXeW0+;8JA$)8K4EuIl%SJSh|24><)&BKz`)EZhNjuy9T~bKoOudQ
z?{KKF>!3L_s`A2{!8QKP;uD0FI$-&V#hMk;P9&oKZ;>=c+McAj*vy^$M#E6evc~I|
z#u>Ftsy`22JZkxqhSk9pXvo`Zdv$RLd@7LLBsp>_4&E>YtKYqer+2<H0qze&2k~r<
zWWV=$a!pha(oXGl%!0o(LjTXY*T;RD>O)}_=ch~RGa1jx>*;?v8&GeFu;hmrB@^jA
z>qk9pS%}0!ZT2f(RW&L|h2n1Rbe^n*h4{de1vHVWv6sLbHRaFIeUX@lb<I{-M<oSa
zTvwh%5FAj#l>&AjBzS-Xpg??^eefeq>!N+l#*Gyj<BR0}t287&ERyb0h&bCb`Nz`S
z+ArkAQ)8ROF3hlXJ)TjMW2Tm~qDbdNUL`9=|H<U+Lia@22`{KS4d(f;_HwI%znUSn
ziIR)kNs)l}(%r(ZUiEVpeTR{ek#GA&c<050F&}WX>HO#5th6J5(O!V9M|<}r$K}|(
zY2APK@_;LQCJaW~i#SVT_jg1>4{bG~a}f}!VN`H<dH~$EQQ~70Ki%9N_we@lw@YR#
z2`5Y8-s^R8_m3jWU-ZLVI#i9bOdI`lZZ5gJNw4;cS*^R+kFk5hlKc#yrPrVhB5!EA
z3wy^z${k|;7d1%f@ID$tEV<{=z~$?Fr-re5imDw4`AUvn#2xzM9e}tno7<t>`B`_e
zIu#uWbe+}Ug_UGmk3a-1+W$)eve)6VQ5$ku@b(j%_$}N56dfe5kG02^SWL3(*T4ey
zeRn#GEK~QF{p6L6J9qL|aPspUw;+**AqKi^WkudrB_PE)o8u$DVm6C$1G@z}Np62i
z`5l$nyl&cS?AdI(E{L0Jm!sVjuD!0+2<dcahmz26Vcqm-x==IRXWYjA<hT2s*4h$x
zW_nIj6IGS@-OE9r`}2(m{htV>Q@-ZJdL5M@2I-ssLXIRy5Ql74^!&z#lqf-2U}ILK
z_=;0x_c0IsD5X{Owz9l1@MObM$()P`6cXu%-$y{ukHLg=+);m>&xZ_t#S~@~^nztx
zU8rVqz#fDorBa2?0f^hssX)y}1|<wiS1;}HM6?B%<7Xn@y7Jv-s?2or@W+H(5?M8b
znaJ&IjB>^M{Vn#(E9^6ZsF|hu41*;_Cz?XvdsBqNQaiWP->eDN?W0MWk^YKx5`1WJ
z_|e@4v;2pLm*kYmUCcg9;ymX!t~6qXFc^UQlv_2X_71mZzF9=6NDxm`=8Jz6z+VB#
zA@t%p9s{(F;AuPF0^b+6`%{^{JJCPEVbf=%oAKoXYxY^ld6quN4N1g^<b7@Fgk~Yh
zz?}CS-E}gifG_l<(<UA~`J>?&#=ekW2df#pZY>wz)&QFWP*?B_M~U?B^QTYsX4l;b
zrQb00LNFVZr^GAI(T$@9V&PoVKRmk&+l!#3ODBWuxY`>F4VD=w3E7{KkPKT8;T;Nx
z)_^74THJVAKruWd1i^)+f<__h<a(rmW(}aXGcn&KDI`nB)g!Zdk3SOVnAG0LnjNqo
zQYIWJjFl(}4&KjG8S*-NT0`OlS}}hAF?R1`o4i|fWR29Je*%d0$H)aSMIGF`fSQ6`
zfC~`Ux41Zv)#aYlgz*$vK5%syKp~W046^>2^LF<(SZ*#7Jb8iPl1>>8RGz7M=nQ2X
zDl~E=v(OjoN|?0tBISkRNg%%Ab6}h|==g=T;)c<B`^rK{vyYF{RwW~@i(E#`g<HQ$
zNA5Yy?2gxBjL{jz9#?{}O+=*F_g>=V2_+<Ko~m$WgKD2Z+?!SyF=*g{*3+ljspyV`
zM{JE6$DSwI-N<{tC>EX>I^sUGXS+cDRZ!%4{?)_h``vFe&yEWb;HIVJQ5hAA!3+UD
z`rPxP$nOO=_Z}K8aJ(A_)*Ia2EF~F%?HZ!Hn^M;l86J}^87e(Qj|6qVr_2FGk+Ml<
zk+pIJ9jMTWFL;N?Q1%qXoG$s{2(EW=A&f3o-6kTw1D8g{l~-#<Krz-S+(DXuGgt2H
zE<M{|Sv0O#u^gaKi<yi1f1Q#kIY5s7No|WzQm(_sl|9i@fpIHk>(t^&5?n0)hC_<o
z*gs)i_*JK)-~HDf04+0>%LXL}9&Rf&JP4jCU=_S^U7R9VaHemzqcbaSQ){BNt=aE{
z91u6hLaa}Sc3Vnxf<$PJucy6fI$3!|)x=bCRr5)=7M$}!bLb3%6(sZw{6*xiuCp7W
z9b8De<%ozfvc8Hf_&ogGqo4~^QZtB<kVV!%5uj}E>NRW$*R4OBK!}R83X5yW<g4wn
zI0$I$q~QJ4NENk(7SO+hZLTy&Oz+zv8~pUso0>EW)@wg;ViaEMGw&xxYYgsv2aqd~
z*OO8o><}{@K8Y(B2{0J%2}4#1Y`+0IzLkTZzCC~F1QJ=){RR{$u`gv3NqNGBP);Tp
zrx1-LFoxMnZj^o1dxQr2z+Ye~)VXU3aIHzWFy<H;8J2aK`K3t6(ToWy*9lvgFxmrs
zx!u7~3kvm(GWK~+9^Fu7Xh~&xAcA)wY!x3a9dDbrzUwd05w1=f?P9_hxccN0-1ywc
z@q^?cRJ1Sg|4<@v(~*j<(o;q9<Aro7cL#!idRPN=VF2;aDKfA*5u^OZmfBk9eTB97
z$-Yr2a2H-M2mKY|C4f+#9_81UZp-JO`YU;K1<aE?9eIH0j2{$!DtZG-EExK|Yu!!Q
zn%0qW>Ob?v{-)At(GkH?bDh)dVQvJbRc%D?jVP=*(Co74TrpA@!Rye}S*Yzli_foh
zQ-x)dMOO}Ez57kEXu`^!m#MsH2a6vl69PtHExH_1#i6XbNQXou!kOfs;}78vcBD@Y
z8qFogb2+_l!uAsECguY=3(A@bGZ@ZHt|9g_vs@r<isQD{B?Ad8UWjvUr!VgEt_&Cz
zEcn`{o99yo4lhKr$$yFs!+M*O7gg1xcOtU%It4J@r%h^KKHRD#+pRK#JNhgfsL<Z@
zb<bjGH~NZ#F6B4VSug>9Q%w+5478726ofPd55_t28y8SfmARR`KU)GjW0KBMzu7a?
z3U-V8GDvVPT2TE}eNa@rc~;s`LFKCJ9rks*-d@v~CB|ex)XfUXEp???M+K>o3G;PD
z_>yI(Tz<iaQ*KS@JI7T5G3MsN<!2i#n5G-@i))+lGyWb-MJhhvH6M;0&|ah0b-<{S
zeU|mv_|13Tbl*ovFT(jc6JhxT{#WYSYzCeVy|ZN1Q4nufj42SOUfC9^WevU*n3VWx
z`TF{efNFNt-k|oh)Ya>eKlO5HC6(BaEWRE^mN1VkGMG14Q~~{A#(9mN*}R5!?YA22
z+$ZSMbu+5N<1e;?<-xtd9K`Z({jKsbrX>Dg19zVY4PN|bs^<3qv@LY7y7*`jThQG`
ztWCR*t(D>SB$>6&ru6P+_Ds0e$!Vw0x(+axS{xC=aTw7@sqXUC28XzIp@YVQKPzj2
zoze`I5Lm&T^bS`9cqX!YX%b$<F@wxGnmwCzub?AmW3HkB2^1dTFcYA_`(9$pg^c?s
zKrt}l0phNVhKT86t8HKKrt|YUD5SWC&K+1D14dN>7wiY@C{hiC`)0hUgm({E349P&
z&jp4dumTxQsYYg$-|JM}J5xYFcOHP5J%QEk8A3Vj#*r?kh5?Qi+rRT)GfIwDMXex9
zg0Ud0ip=WaHIjocJOk7_Amg2L6^}ym*LwmLWARnZUtwxY>@+8sgh`)l0hh+m>KwdD
zzo<4uoaeb(>MyR#bGejb$ODh-K*%Ar0Rc<V7_;ZKUwddJiu9I+{|p)Yvz9@Ng>5DB
z;5G$739y^nq!E_c_=Ogp>#EDoa7(O+WS}?3OCoNPGqH>`oArn7u|qQnbus_ytHnpg
zoIVC+$xrvk<%i|e+>$OwfQnWDh7p1+`mr6D2l`<-X<40YPb`M_-Qp7-d+rHE!(7{y
zvdzrcbI4&^)P%Kk@LT$5>H)Bs=!>Q|-@obw#4+BS4p5#tHrBTW46Z^W?IaOJIiz0o
z7cGX~_0CEU(YqsA__-2od+@R7yGPjg7-9jj*8<=_xMXj6$V*}g1&yJdxfNHI@E6Ss
za&IQhhB6uL>}n7zF05B;uCy?q{Q<qiC5B0v33kS3rO96kf}*;j!i!<26wESn!(><V
z7-i(VO{<*6&0?D8z|JPi&t$bV3uelY{`?PN`_Z>G3327ND9eb37b-R|vMbiQ5z`E`
zWbz-d&Ti``BU`e<Al&~VM+Tgq$NY^Xo`LOClKj5@Nr0sQwT`x4ZS)e=tk#j!es}B{
zJ-WMiMpN^9B3vfb!hT@sSNk9ido$KcI@4a=oqlo57Aqf~so14q=<hIhM3pC(J~jOT
zNP3%EjY~h5kz2i##+nJm#RhoxyTtaFcahC@98CoS9QdX4O{8adDj38Q;Qb9`N!KLt
z2K}`pTu@0dH5o=3igX4(CJ9-@TcS|m5J+o5ZxN@rI5JD=tW<CsBGF9lJhjfO9B|?T
zKZcbP<xoh(mh7{SaWc57)c-TFH2Y%^6Ah-KxVY8aQnp3m_J~ebZrgv`+><O@hQ+xG
zQ%6WWtbmi?DSE6eF6cK;Oy@+fvJ5;@8t@QlWcEsMa+$47(&IvSP<WaQ{g%LjYjB2(
z-#Vc3R+P;>*ycaf9{-+LAf`HsB0q_6QICb~w@KT9kxf{cw(_*W&mpG#$bIluL3jv<
z4z?SHgwNvaZz?2y!wy#-413AL7|sE#7r!jcKjTa<WgG$CRY3uK0B|w;;lSw=r#8>w
zX4Xpd`N_tS?*I=+vFP^`g5G!2j|@8Esr(yuun>IB)QsmNg|yu0J05kv0Mq&AE?Z)R
zLh(+K0PF5a__3@qhRq!>!0wqhUJ3DM2i@0xN;v{~WX5|&45dmnAJ&CNRSXlJ@~Kuy
zuIP}qW8{(3&h4E+5p?`!iQrQ2Bu5}8>%<az*0HjOQiA~R0zSG0UwLwY)(=>acNm2E
zoYhQWA8tm+uM>A|N#2;r2`4eCk8}1oDy_iA4s3}{VW&vTFAhnPfSvE->wqmgoWhs9
zgOKU4s>#;mz*C{vgjhv|-DUwz3*I55dogmS&k)h=o`a;|`0Cq;hF>D+m9n~6&`?qe
z6Z)!NfEPR9oEHr%I_*@=V{TMhBE>Ko7cwAeQyaaYr3_7W48VHF$al%P{Eo60$}6}#
zv#%_~dkl8q5x^Qd63^7?JjowJSaCdJ|Dv=Nly0VvlWL|3J<o9hhD-)ZMr#2*E{zU9
zap1BL?o;8MOO#^LCmt9-s1Q&$p|DQMj}MJ+a63(Y<Dh|tz)>KMRn14sk2E>ASkL}+
zK?o9-fUyo(C$crTxp2tPKz0llUQ`qS==bt-@E#XW1Hl_aY2Rw#D6v6w(Q!qk0<XEx
zqAY$c1}fxl7>s{z&>7bW!^Ab9Ka?>X-fE|--I1Xe>0Zl!Npx)!S%lIA(~Myg_#hWT
z?7EYWcXSbdAmp+&s=?ww3kp@1Tv*$s)j+|bKgJ{sXzh46N1c|lO(1bio*Rg_b|wfC
z+f14QSz2mI;T*F&;AUS2i051s?80wgdMx}JpB;M&1>0(|x3q|ajtQhavg*V5ar=j7
z=eR#Hz_=Ut%*+lt5L{LH%8&pLfNg;?7I=D<Llw1?&#gUi;8jU{G;3A}i12CyAl|0#
zNvmFyYfZYOfsb3%TELV<9C$5rE1M-QT#u5!9r1vqiB=ae5qQjLH>Ad85s7V1qU**L
z^v9{Q>IiQ8CF=1R|F6Bu4>d97m$)yL=;2HEjmiXM`>2e{nNNb%1?brnRgPeCJltra
z<3J$V8=(2Gk*48tjD(I33+xITnn%>sV2D5>Jgh2~0NqzT6*U-Ht})O0Pl~wL=*xy}
z9`+dB_Da<c%p$udx!r;I+kLJb_&d4-)K9?04&fNE={tuhzk&RWR)7DM>jO1PX0HP*
z!X*Qn#&q(n8C9FDVa2uKTbEU;;3thOl8(5&6M$74Z>1e}K5?*0dFw0&4-gZK;`ol`
zsAyv%I!resh$Jo8jtP#Z+GH8EG)^1X>}1un0K)`RE_u1CjDVLymKO0oS{)!LQmm!0
zh>Z&2p>?a`)1_y1%F7g7oxWwSo1}j`=PXMs{akETYVr2q;a!!=a5_G@e9o7sO<6Uc
zq=Se6#K|<NVRt80fm`d`MBX<xgi6-Xz>8~=ThV*xM035!UPRlNTBPGUDG>i<9fkK!
zKTtoB0Atvr6;$}_!nswv)`RW-B3^QtK{q%+Vl>Jx`u0zVGKwBN%c-E$PW^m~Md#zj
zrz%DOJ}pu66LXq|SuPVd<n+n5YR|Og+b;>^vhyK_q;b%sn52Y?T$<_M!OEye>qwL6
z3-7A6?N~PNC^xv%`c`wua^Py44$3-Q&C0Ls>PA6DcH8=dI!{uABO;!$AJ_+(p+)Na
zF6%|8n+#1UKd%F!)cUoFzYzAZANtY*rH;077R%TR6jB5{8AYyqwU)S0vTQk?q3J^n
z@lKo93BA?eWQ95Yt5HQ0duoT30IRV$$ms$aS~5v8kPvKBEOY!c=?J<&s~lO0?I3$&
z%{=QXc+q9G8jMCD2gyTSIKTxP!F?XSo#V^f>GVw?cOYki`jEgx96Tj`)(ga6zkJD@
z77|^QJQN0_Kw_*ng|Ui~_ZvZZb#_$DORN5=rN7x&=%d|v0$MMb<zATnKVwXVcXv4+
zj!<+kVR~)KX2oT(qB{|?9+&gisZC$|v<K7Z_I}Wp<>^r*XDR4}ZE$Q>ZrepON3t}4
zF}r>nN~A^)_?&#|wx~||j3H=T(6zE{FLH3rhDn7`*OqdzD}?)x9PWdt@XC@g-2umS
z@CcNXd)G~3Crx^~mP)@E;3m#~>Qj5vEuqH3dz(&Wy4Htj9?2GREoQC)9GdIKzO@6H
zNy2|0iQ!@MToR%c(e=Oxh*rlSr`QAAa=G+~_rd7+H~`>d!?>VhcrmLkUaP&4rVZ+g
z@a58mBI3U_R7lf)3gglJ+k4SpXgsm31A~5}+%_uW=g~u7Mi&KY3AoZEcdS<6rdvW6
z0%dT}RI2SX%FSB<Wb_Y9VDm(@n7<XwW$OyM)jva@rCKO?A}w(VhY_=($dfMf>+mW$
z4Cf<vkP?MHg#|Vla4G8I=U!PF!d2`dx|8Xxo4<;$q$g_5QYYq9R69xCXW3k$_WP<G
zw9`>gi<Vw<5}_X=JR=ANmcZgoF_SIepBuM$_T7v_<W<7Nt#?C3l;sai7mGq{<3fRc
ztR-L5irY}+^&#zSakW*L?++nWHnw5Bk0zcFVdMUJR0UbEC;hqOsKeSK+Ke%wCE$Tf
z{1>vY(A3Ch-(tjPboK!yDDzw9)3_}kp=$<ii^JGJ7n8~o#>QK9o|70;R;X5gs<4q*
zFezI6er}{=x!50G>j{){W9hY;&ic)l{_IJN7&jcCLs3FG<3jm>?2g_Y9P+y~azBs+
zaLcZtSH+>IsHPz>kRL|9bo{BKpRx}2*eZq01z9#5SxP#}qsH~<scg;xSU`puh-opg
zv4#YMnejkrd(u#=yErU-4_h^x_bB`0vm`Ax4eRKJ148Vs+G$|+-f`ZF2uOe_Uk#v-
zIPLJ`iGkFZ4{@NfE>KUCc<NPwZ#k*xyH|bohInddGmx$w+|DJG<E@+QFqD>QX<Dk}
zU+L0+a|%W!i<K8IyP3%+rz{f{;)3oOU5O9KN-_NZn|xxCw&DlRIXpX!ccI2v?5WoX
z-apGd%e+E;pmYBK1iNJYeF`5N6C>!?fqAj_B+7fU01XqSxf3AT2VfzE=nqX_uz@=k
zBXF7F{jk`Y!|P#!^9-p5I@P<$+^tE@_SQjM4Vsw}%ZHp_p#Z;(EGq(65?K-t=kaEc
z<FOqVgi78qOXl^p%Uf&T!sHCZD#M0Ja38-dMz&0i+W6lSq-;&;8iyx=`9gy3d|U^f
zYwP|p00*CgNb3xzN#r@A_K*R}-#986bPW^)Kox{iBD+!=8HY!y@m~_1uD-+up>wLi
zFk+xYBZN?Qvl>RJh+5GvnI)jVdxpn5EZT>f2_;h|j3hQoNca{D8nnreMR8w8WWFQ}
zknHpb%9Bk<7G6n-Sve~(S>|`1=p|vDFsbodAf6)5mlNA#-?+5~!sO1KX>x;KIa!vF
zzecWDHHA9sG1!@7Hu-9tFnKozUnfh&Dk6r*FXSyzOe*v1Uyay1nfC<(h&LpQe*0bU
zDYdY8vEaET7lC0XmmNblfT-0($kleoi}OR<tO%n)CvNmW^RecA?%KqLgSPDjj?&A4
z8SV(L(D&yi<&0<WTvVSJFxCa4=zTkKUI5ouGpO33F!BcuF~&Seqs!f?pWz@Kk)EAh
zbLL?Na>2rD{|-Ec9@>c*rbSoi?T8hdlUPHH4*Lo**b`X%jXFfXvE}nK(d1G+iva2W
z0jM|f=)YC{p)Me5jr&BT(qC~!p#&{52gFJC44Rbba9!Q-6tJqSSw3oNRU(-w?KT*-
zeVpH@m!3?>niCH?y<y2l!!N=_?19Yk-A@psAt8=!Ny!%WWWh$K&YK(=-1bXw-r9{P
zk<gXWTf$5<*_EBZx4Mvelye(CIbrqtAtuMmsI7gV_|mG{alfmksaWTskHUi;GhD9{
zM;8gdfTJ=4Y#ci|c{+IdHBnn{Ma#f)FoL%qr^Pd>PLQ%1F6U&YUq9$}yl2;meFy5z
zSnXJSe-^*RX7Ii8m9}}v3bGN+(ps?~SL9o7dz1bycGO^)Gs%@C{WCT!m{PYy1f1F}
z0ZZG+<ar7D9o_kwTiKCFH}1q`8_jy?fu--&znW#JdUrRy4x<`s;FQj;s!KQzLEhMT
z0pYN8gqv_EOoqsML8@us$a;vkbW(InT3nS|5K9kH0?Gb$1|a4~7e(fcV;<JD60Hdq
z?~!Z7p@=0*b4JAx4pt#hVGRU%Kpx#=Qfa!VIFXUoX)}NVy#%?L6bxdw;ken9MM*If
z+MDWeJc8pLYm?=R&7>EmLnjXxVyKg8@hO)xMa)mLw~@4c__d574S{BBLi=9yOI4GF
zGwHi2j@1TEcODNcn<b9WNId7PII-#=@mO_C1{^k+(gd6}>40u3tTc0}zid}XO+Qi5
z<<zrZ`IZjGbmDweVslT*!9X1ZiZc?$<9++MZQ-#@W0T)()xlA-n3=%;Ut4y854kb;
z;_?8*sIanC!yCGyrdzks)}*sTL|F;37`nOAx4iRMS|QzF0@x@PhY8*4fp0RQtusYx
z;vF2wWFpF|Tlvqc7!Ayh4U9K~aGk>aD&&ZoAyiH}8>vlrtSNI1;jXUyD@K6!C2D9c
z1hs)fz`G|AbN)IQ1UEn$+5H$G!wKoLx^qz5DQ94PU=ct-oj}G$9%T4IXuGU~@h)%~
z;N_!8*bl3>tG9(O{a7%7=@x+efiXZs(-smSSRXmQgIWK`{8;Y=1%atfL=j`KN(y=;
z?DK2Da^WD*hJKkiCAgD2vXu<fEiI~?=iCRSdO3KNao`V5VR~U=$69HWyMO{4b*R7(
zmfMq?iDk8xSV|Ky=LOqZDtibn-el}po)-}W*?c^w+Y_8gwo1s@{SaGY!3X1U_n1Q2
z+n~WEYtq%|wX9bz2j~5w7^i-}Af-}z``k6!1N~8TS<wCXj3^hmvlw(R9LeaBpkaA;
za+J`l*6r&d2B1CM(c@<}u&MxWCS@ynv%G;#qOMyoCI~5uAUZ^MSoXvJ`R;%`lkVmu
z&NdP%OqGE)7MT89RPl^r`GxlbFAi$LFYp<UOwU+(8!`PK;JmhsM+sHPy4Z3{NBwOW
zgjn-7$jI4l-xPrqRF2lmt921Oa(O>u^gtwQmydHnPJ4s6v7V49CQv+L;$SZpx0ORv
zwxvc;OpGY4+hYpg`=15J-jpj-HuH}%<}B$vwYqwZl?Q}T&xL6fx2kn{UWzYLXZFO+
z!YYjZ-fz(ha{Tyw%jomPFg}w)%^av`+Mk0HZ;dTW(@vCnoYdhsn;}#@W(6zg^LpH3
ze<L1K{I#gZrYT}<qob4N9dV*yj%Lghiy8A1V{}UD!^+(A=H^jl8eW^!h2=Y2$Q?*4
zjVEB5j;@iUDp<=(E^OV&*U;dfa4D8NB#=GZuj{Kd!hx0J3yXY^cvd17nidt|jH~tI
z^|uo{`yScW&S-qPOVMZfKgX1qrXAGOA>N%+VFQSaQJ)QPvA*F;c5XCWyaT^f8tW);
zS&K&opM~<|g@eY&igWWO)0v~c0+WNne<=22ip5iMPzC1D{$&&awk2gGdfsio%QO{-
zMDmPkiR93A6apd#tNJRc%z8&lEi~Eq8f6!&tVI4IY|Ste!o{>a06$ZL+C+wO0-Ytu
zuFgA)v5XhIn8ER?jpM{;BxFBzE&}?Gsqw?kvZArPX?3EVeZAl9{QXCzT4w5o)r;g6
z72~+<-i~5_wb_>y-H<TiOTQ+x1<)#Pi|M-xuOmm`=yr`kkSGS*S*lGEqQ>>r&E~iP
zBy?z!#DE?qyp!MnuBs?!T8&-7nZ^hwFy7F{Iw5XN&-u;6M`af!zP?hmRHP5w{yOOi
z>{HgA5tA#h?}MZUCSWxoz8c1GjZy+76*A?tk}K4mcP<!Y54TYTd!=GGR<9_464^|T
zyBU$ut-ixOPh85{Q3|B`5V3MQe$ldkm6GnAUlSKpnw?U)NYl(|CS>8W6&h)=B4^^6
zI81JpLU(k0zKEw+ijM3b2oOgO7p9OGJmPf{Ue%@3_t1G-e=PD;M5%rz`--Y*^Yo3C
zl4#H{t|Zqrm%ur;Dh6AM!fi%Ak0Y{^_>(z%m*XeVjjbpE92R(-5&JzBD~*t%50qA2
zYflTF5G~4Y&c<!5T_v1AAHtJqpm2FH-?;yJ)wfm+;}VG-Dd9X{O?xw+V9fcP@;(i3
zo~RULp=>%el9<hT7S2h<jt<t$k}v$kd`ftMHebp=4%?u&ySClgZ#Vfr72WlbcBSfG
zl*3it&{Z%U9C6AyVOz7Y)}*1fv<oH^1OhKLbU>IyP>hA%vFZ$OnVfgS-$^h?H|_?M
zL#*d1a7E87$WaJTZqgN<QhyUdwU<c7B?rHO2u6#kx8E#S+{DgfR(AJz7yv&1-J<XC
zMy9@D>duR~$&v&&SVgTwAC}{h{CK30@u-J6ugQLR9HrrWdUn<Xh58|ZKCo0eX_nMA
z?UQ2-B{<?4m$us6uy2(vk)__R1EDz&`B~!Jc6XyLbocP&qljcN<lV#7)*ZoN%JHv`
z2~xo{Okl}0e@<|TsL=!T0yS|r9h}4^mUONb_!o;KY^uq2NqnU4=HIihrnA^Oh|OZs
z$+sOISjE-1;<70p6sAlgX|T?ifEqQ9Te$4Kn7!lzVwW`tURCD#M=%9f+9c^JGnAG~
zKRmW|yV1QS1DaL8R-!P;9c;j{;LZd`-Eg1UsPO+QyFHxys281?wwOmjCfGi&Jn&)4
z6~9><B5!oc<9EqtUc#hfxI1rr^h%&c5+7qRmn(*t7&hA?P^K^G4-%`iTwNPH2e%4r
zPI${+DMuA!iTJ2p%z+k7Pja>Gf+I3>w?x=s=Jb0vpRK=ftfT;RG*s7xc1^&a3{)kf
z7RKD;P^O3;9T-6=3xqJZA=I*y&`yX;>V@u<fcPFmh5)Z3JBU*{VLMW7e^lh@NESPf
z|B2PFX`7aF$ro543wDFcLyP1vwsep|@uWT5Fa(e^^QU<Fu%93f*n-M*qwb<cxvD(p
zV8|F_ByehHsa<Bvj{nY98vJ+waO+0T*3311sy!s^cXhybeM9&#jEv;8H$2jO5G=o6
zu&j($ABK*NurbN(;Y|x7vMXM!<(V1?XtO)-m$`i!n3(1mFoM@(2~Go~_l`9(F2h5?
z`s<QG<2dpE{vq2-Pqrd$6&fCOQC$p<NYWW$EM0_@l!U%CKHADp3UsW~<7i{^cX4)7
zM23wh5{{0s@I(E;z2Q2`CyUFHX4F2XVIL+;czBTv6Dqr^96t!U-Q8R%!-0Y0U<6)y
z%E?J2p+P+iDzhsbY0519Y+f=X(;mDX@&lpDLW9_@I3(^AN3XSNSU^;ZGucK=_!Da{
zsdEdFVhfWlc)c^)t4TqN^0B7aewjh$6r|{to<HpbUG3O0^%^`Z;Y#Klu$*l82%4mU
zAQktep`OtvxJUt<9j$K(Ir9)p+Gi>|RL<*)HGZ3U<$+>}_O{!;RU`}MzN<+rS#Un&
zq++BnU@h|^-~~zr{m#o8<nO8(5nO8r5ZHZ7LH5du)A*Lel}9m8x&^OxW5JCC!}6^z
z;bBb)OXE)nbp$MoOR+&7w4u9*Zwt?I2H9GnZ9w=lq(jtYyY`G8<U7R0m>KQt_=j*f
zs8IK5s+&V(ncEJW|15joE?T=@5V?q=7$Cj<p_1ePvzN762zDfCx231?%iL?iQ<QIV
zc1_-KIf;1w0ex#VT=vz?lp_2-4p|@?eKQTPr(GoXY~vej1SocT*4L5)5PLR)gej%l
zA(le;*^Bdd;tP$YJp_h58Thjj?V`@Nzvx-dc_5KQY8g8IeOSsA)n8Sr@9|GHge0Qm
zSV$(m@&jRCTtVXX#lkSUU;({%{KE0te@OyPyitlFZa;y2GoG_d?=jI2wiCjoSK{ie
zgldL8I@zy1%9_RX-;Sx}>RlsJ0=ka|cV4H-HE}91EPZ*5-z$ylY7t)iJ1lgsi8A74
zPe1bu(L(cLa~RRO3|2#b>l@m((%uJHTsaJ{ix#pEHh|q@NZhFo3F$95U1%TaS0OVt
z9)ie8S)ldNCUJ&xMtGAG71!Gh8UN@}g6*1&4jaR$l+T3g{K2R*+JH^`b5DI(Ax!8t
ztd`t1_c$q`FuiIUP^%L$Oz~z=gbUEzNPKCKnJXBG&YMCMSQ(!s(H`EO;QY?(^JAp2
z9RQ_t^{z>*^$!FT(EqMz*mC*W82wbEsF5?<IYEEQkXUX+ZqPxyh+xq|Hw*QOXQLg+
z>$>iY<gA-<m!D@rStysv83#>q!Hb@|0okGhglDoOM(1RpyT0#+a4$rYi#!1H8L6Vp
zog+2BrhCyY`-gTD?HvoQ`Vj0wiDWOH->&z1J-+9v_gAFHAR7z6rTU$b=6R;k_ZaZ@
z#N3*Yb_e0^^&3X|*_LKet;XQQ3Vxh+MJb~G^j6s?;({&qV8u{4OmZQl05<SO^~hBH
zHLB3}XNa|E%h6x7Ty$BCNbOxC-0)2t6k2ha#8Hl^)cEcId{xq1tByr)N(D=umRof6
z>W$+-jzn%dDDJkft%S{B&1UHbcz!T+<Z};!59K0c%lmuhp2PNM0<~_XKU@;Z5K*{J
z!^OHRR%vT=j_T{RE0BUEGmw)sJ{B0+fL#2!g23z5W88w66sbY&+tjT$k+wnW=JOw+
zR@2l|wyj$8^XKhK;L%I}ttjV=0Eb9o2b2AKIKA$ib5hDLxgzDyBq#orrc^o{MLN4l
zSL;MSbeTs4>4eBWv{6Kv^lg+qjo_1`%=usbWK`8@i$0VYsA4KQYYPcboZqFe$U6=?
z<^>$~3Kvm(gd=zUQsn;lD<gKY86J0>itaDH5cc(>%H+;Z-xc<jJIwszbg0LQ`Sk=E
zEcj(UYWg|tJ%bWMz>a(+-W*TjHU;}x8e#iq#IXeViGw^y!HD-B?j+67Sc|I2^h#0g
z57@-WeiZxSlB84Z4H{*)`FS+?bizoK0~i{mIf=bzwnCB+L;a11`u@&C@9!5-h%eCb
zjKjoUymjH^8Q{vmX7ABB7`d@KbZulNkHh(D1ttM0>a0=kcIXWy8sqXxD$6x<jQLXv
zI#<WwwOg9%YCt(xeWk}GeN?Jn@YmAGAqCRx+V(PP7z_`Z0FmxQ=u?COj38lcf(IWq
zD=ZKx{#Z4=oY76k$2G%G<X;$p;^8k#m-wlIH}$H4{X424;N8mc!_=F%Ca0b&dXT$v
zDLL}(g%v)@hesC!HBT?7cny+paE3)OaZ>&|6~;^{(XS7B8|=Pk1?ueMLy?7MAf7hF
zJj|ih=CzJ(l8Xj|f<*jHcG(r0O3Dn51JbmEtccKpAiM14HIbMT(zZNG(}<4$R{m|3
zJoyFX29Z3zQPyvwbZIUsu!Pf0Ai6Vh?&=`ADk^ma8_f*|eanip$tTkyhl6b2JLGw&
zJ|1v~Ux!umbAhkcTQE`-mp!^s3<(D;PDnZ+-_dSH(0wzM>RlOr%MDFybDs)xGn(*&
zRs~iRW^3jk)6_~WGPo;eT0O9^u!z^w5`+w4;h0o-$=MYtd}rg5({f9*#p5Yq>);kR
z72*&JM9-DU`h|h(BnyYuGho*4J0d>dF|r3OTRcVTLZf{~%2<S*6n|P_eV?RaGhm7k
zzuM65q)Rfi#n+6KR&uz>S&}TL<3bnDT%#qREPq&04TfXD)E|f(<{P#_fS3>(zEuc*
z0hc0LwG}$m`E*6~3Eua|aSi4`w2jyiz>3PNRzOzC7P)ymB&BWULVzqu<!7ZI_w(Zi
z$sQmTd)|nmlG*Ep<XYh`zfE|EfqM7#a&+T?<R^JC)15qRuyH$YE=)8L7<4X9cJ*sV
z{9QyWD6;wV=!apC)pgIZw-yBhm4cMQNLFI%mVdq(LKSZHp6k$XK})Otg|)@Vagnu>
zB9c+Lq_s`^*zCO=R>SwApL5(<9PnevOPc8t`;uM%;b{6F968ul_;!l*4twDtGfJl8
zEBy*oDL|+q%fy<@^>1+<WJLe(gcJ}frb7T%3&OArvh8jbioc|&?n%mV$PXn(v9SI4
zyMca4Z#iFCyO;Od+i9(9f_!L!Q7jD;=E~PG@Y5WN!Dd!8S?nd5(*(a{L2za`7OW{u
z=2~6CQOT0(undPNC$`g%8?7QB@q!sF0G2}so%1>xNkdA=%d$F!5Z&~_3#w62Ozp(#
z>ACm{oWT6ar3;O{N!%u37K`u&fIsIJTX|WZ)`LRLQAO!mi6U&nbmJ0hL)=tc#sv#b
z6Gfrt{d$;Q+$reen%6PoHo(*WSZut%#I=200XqO~hLV{`$V)>)4<fF&foKG-_VO@+
zyI$z4GPQ5$${y(a`gJ$|^6lvOqA_SS0&Aab7?g`~6eY;nvvvf+Sq6{%+f#$`^`SfA
zn9`-s?!zLGfjBKLtcWXB6Xp{2X~GOOc}SU*$7rM1tD<)hkwrhQXFzpT6$GJ5k_9h_
z?d-~ob=xY#QuKt77zfLPXPRJ_Crjl<FTe=|V3tQ2jE7v%0Fvw=7$~jWGyE=p8a801
z)GqJb--vo~W_;Zi<%(-xN;hs>EN8<`3-cbFBVQt~7yKSZxP<kepmv1ASvSpTpbzy_
zETQ%Xyp@K1x5u)&4b$9FEPhEdotTE=F1t3x<hR&J3oj~7wD~a#d!C;;7{%bnl!ep#
zsSwCTfR|PnJR0E|zU6Ctd5?$|JuL2C_`D%LLU3gc-J}L7IE&z#+?uE?|KL^?DW)G)
z;5}7|uIR_0f0=qOhcl2~xz0USL-ITos(8Mpwp`*ixK`GFI31`Kc(GM#54^ZV(XVjw
zLn`<RWs4Yi43oH<(g}ul!<rl&0z51GHY;1m&_0jf7zih9pjZ?heA=t+6LS@LaGgh~
z?X9Z2TAHzX$c1Sa&0eoWRX#h`IAlLU+_@#*z)%F?_waBo>q}zIF6M!T`V%76{x?8z
zC9&ot+}4#4;9=!+@5v`I1TP~kCx^?NXlV?e?Q1?Tre2H*vds`NS2vU3Tcl0w0$iy#
zq&#(`1z>fPg#ahnK@Ix*`^$_f8-EJ6LjstLs#qE=SE_klu+<hZD$wfqkogZ6*%`e|
zSoZ{Y;yJxdsNx?wMoiUG=!@;H5r=dnfi^Y{^$$#WcIQ469|VN&JX>Y0%13v_Bh%1#
z4u?CrUR4(fQtI}Asyi|~XTJ~3{Z}43_G9gkZa}kuCni}Kl2zfkeWGf;XHRR){<<$M
z_gNJnh3>QyG=Uu7i2uZ1cg5vnZY5HC_2&q56v=f)|8-08QLvjm)bB+ZQdpKVOCe5X
z`F>=*HM7%10I?7YGyw$7=NDD_tD6dL8(6QnLfgZeJTS^p$njs_PAt2?4Eyh>``II?
z@kOz(Z9c-Qs0kSYlsgQ{MlaQ+2kXgzeE)>;r;6DTL;Q~CZWXA`U`w8bS|W$c5H*t^
zCo1?KbM0>+Nz2GK2)EX?+AdxMloG1qv>MUUZ_)$DSXuaUt64e#?TE!@zGFb1H0z((
z{7+#$`SJ;z;4(tCbrN`Tkz?q$?hOz1Q@#9;e{zo2G#>!%PbYD9e@#trLUJ#-GVUlS
zY*9|4obKB}rkXB?S}ZdhIE<vbzlXipTa#K|ko@ZD$`QsVti~H1aY!y-wQgkI;<Z>d
zegVHm5#ff6_8K{5@s4g5(Ol<*byDXBjUYF>(lpPeKt*C4J>cv|SY{k5R0T10ce!#T
z12|flZ(j=06~ae2d0y#g3iAT7BE@DsAs2WC)H-iuMpdKi6mVWqg+G+gU2OC&5J)Yx
z8|mK^L`+y2laH6q)C*qwMFozgtt!;H##CuMd$Dg{7VkxVdHtJ(5Uc>{uxc|_af&hg
zX1^l@(>x<vxmXvKufDbWtMTxBS?=B0pO`)l57+*9)x<(~CDZifRH~ya3@mH;&A#4C
z;5XCwfWX!7!ap0Lz}bx)V%v&!3GOh*@T1sZ>Gr{7qKMST!~9t0m&$cGEa8kBuDRId
zv(J@=*AUa~WdeV63jtKtcOH;9F)z~XA`=zjrMsU&S3h@9E{9v*RaD(<svcI4RZ7&}
zVVG}P=Hep@vFakn5%lQl`IH0KS}m$Z-k&c&03pN39QTHGrgZhKo?jixuD6FHziV-5
zl_>jw#ArWUAfj#ZyR6_-osHDk`yeu^;wQTsI8Rjn#J_s@5tSytHBj@ed>cqqJUVU!
zN?)52Nj;dVJQ(&JQ6!ok#W_d4iFc4C;v>H{j%>7_BhgKR{y=AY=-dpp;@;2#)^0f=
zHyOl3yz>`k)-Y|eI5H5%yrgG}e`s|}^7;Hq=Y;(j?0OG#lv!&_@WdW=itvoSWhIz=
z*hO3Kcqw<VcV#{Yz1Z6;zdfd)`n3a^Gd>0)Ed3OS|DNtzE##pgXn%LJ7~!DP8CG=C
znR#o=4@^<bZDQ5$>&3QAWg<)u1S`*aAKiKpxlX?rx^RLXE%y2&tf|}GEkrGi37SE4
zoUf~A05(}b+f%TTCX1xtR>s^oVTcR{V+LVJ^Gf@EjFh_u2$f*-P+;+8mc4b|Ne;=f
zG$=HEKM>rl$>5*BqLy^WDijPpb&COKbQtjLOJ3up<E*w<Tt6YINjlT4NZ|VhcSEE>
z(80i(*@WET7kI9#KN;J)p{f~%)8>H|WjC#dB{8QHIvd#Ein}BQTqv8o0HsN(uFhb#
zFrNjK$%z%qh7V=`4rSEl({jyIDF8+Z5dnSQ082u)t}vdy(WuMuGgG(Rh7oonwp$FY
zI|Jq}V=w>QfA|KFqZU$HG&f4opPEPK-~+^AHeEXKJck4WX!{hv`cWdf8i)F$QLdG`
zPF^17Tzxwmx$h?|RSGYRTF{${c@SD9>lyVRmYvi*u4_YuC-BzdH?gD<Ud+@taiMz-
zJU$yThCoo&q3aP9%b71KmAuQl4HZ-SS@flje(XXCtjC+{I&Y+PlMn)2Wtgq^6wjF<
z%(GQ?FrGMu_!I`-Px3xT)W__KkjxrWa%cV>=z&=DAW50sN^YbN^3`P5r{#dBGC@m&
z>u5(Pe^}oVZ15i30Lc7-ic*<Zsz9!0ea3du6h`_CFt<i{Y&5=vt7<BJ(wRggpbV+q
zy1S@oh(u~0!vLW)4KN0{-FV-v+AAXE2slEuB(r?ry9Mkg_Aj|rqBV4brGEhYZ#7Lx
zGZ{ym4?@j0O5ScLn`t8&9;T1AvsOTDPiY|@Vv)~$6zJM=%POK@q;dy^rBbFWKH$01
zqwo2h5#Sv{qgcZ$fo7VOGICmyP42?O64E<-VJU$i?@)C;%1I=#9Q0Iltnt4sh$zks
z9U6Y5jb&}vAgc=e>06W2zllA!KY!prY{xlD;O`7PAM;WCUm7W%8^=YRepOt-)aSV+
z4P`}(xjFx+oeInT4&!+9Vz^Ahe9M+*`?yevJRx|sm4F=gUia}kVo$NMn8|ug+T0hX
z9sLUP`V84Y0o{hyL1;(xHCr17(-tbyeXg2WismWD*dowyirK<!Kj%ztBh8lP8;nm{
z^tm*D?BN@nqrzSrg^i9;3}=ghg8_Q3^^Y%6riRNKOg{$VSrFw16okk~aD5n=G*m>}
zRStWHs$waqXf;7PAC7AtKhS=kRHmjS7qEL+0tJ9NSw^Py<1Zdb>$tm(_FYZ-N!Kc<
z?y=zBNlm+4bC>Ei92_$9^JQS6Z3q+4T8RZBok%5erU)V_7~o12C&EsO_B)|QxX!#4
zab6TNJ@^l86hswZuSUa(Q{nh+_OPzIjf2%>`y7V}o#MC>{Ro%6Lo}nXd>yavk3-P$
z>BE9dwqp~RhgLC=vq~QR4e&>Zi+^&04*!BzfEj?*LrkaVVv@PZe`RVP6~GCj2TcSb
z)@%t@QGU0h4Tjdw&N^-W_x<=(UWQ{UWZ;DfqYyWU{lEwWQm>SW2M&mZ*)xG4=5Q`|
zl|@p>qh;V&Y&upp5*u=WOS<Ta(#Inmm)(DI_@$4A2FR&i2KR9+H?~bTiD~$Jlw(d-
zkmuRQ<NoT(Yf*_iU2^Qf9;MAHP&_?e*A-FKwI8bFFjGvl1d&Ua`pnuO_Es)IoEfBe
z3?gt~=Nx1nz&X*rgKD0Mj8dm<eeMyASJM7%f6xXNne!nwIndI!gju@$FXk3Hda>U1
zmoZf{Q?=Wjp|Ky?ETODc2P&`Z5R=EHlCUv2=)oN`5dMaC5RC4MZ&I-&dSo`Zikg|f
z=~C=zgbvDs2COo~%>pz!J*8Q6&{*7k7Ecr_sF<zy8rH6j%Du|Y^8WxYK+wOsFwwz@
z2aD+C^s>ghYz2+Y!Ds}^BAM<bG|duij^vjo9wg2W<56qZ*FpVVJ|3V4rQZ(&A}8N8
zcgtFFaQ&=#_HhXP+^79X=4b91!*8<(SsqLEbvuuC-~a<!b4zc~pT=-eX-u;FiU04_
zzS?G_O9rVG#>#609y*Q)u|@@RB~$so<M)+F>O1=@P?OuAK$A6_h*&W&89ZC(S1k(J
z-`}SbNd}fw?;|q%u5E0qz6u+A;c?q{4+sXaDkNM%5KvBwR)rU{?)loyU;H8OUp-rD
zd8ZfVx13nowwo&>z<a+J15Ve&(+TshKWx&fbEgOD>mOHAmO7#f#iEJ5SR>JbcfX#S
zAL@u~vCR@{)u!LjwwTF-qnxre+xMybwWIYl^6xlSO1+CpooSh*?{C~my+AC_w-WhO
z6VG$<I^t6iTw+5>Nae2Wnj6WU`8|O2x#A>K_`VDG@`oScJEx|VKs$$#_OKcrEM6o`
zLkLY<uBu>Rl4w_IQ$q?8HC1MsSf(vdON@tf<XL%K`Z^;rcS)SiIl^Q;Ae_fy*gShe
zg3@pSW}>_AN$m|z&zi-K-AQeQeI?p*$T60qyNh?J=KGMRHJ*_QwBC!8?&r)r7VlMb
zExfi^vl7F}&$FB)c?$xxeS=i>C=CvBf3QG?(=Uti$X;Bn>$6xsbn9;;5LV@2D$y{s
zu2gFX<t66&+iPWk_8G;A)*WJ+yvSq0;7C~_Fz1u{ER6gWv8M<k4z|Zo)l`{N70^AJ
zRE2;z8<ECn1phwv+&(3O5zqm}Pv69c_;l+O>IGkZ#9!Pw@R3puZD%s_q@?>8P9clP
zZ^)9h1`ZP_e+6^)DiNaayAC&yE1=4D9Y*043~MJ?ZRC5LUfwXkq>O#{3{|dsW2Xxn
zz(=X`cw}@2u2fGK2V*>eKkitOKYX=5s3aZ{050Guw5eAVaC&yCMbnOT(0CZWOflE=
zj3#ftUszVb&2txGjD1!y9y@iYF~%U<^!>AuqT4jnB$*t5=yPLM40#b|r;*-KKY;8?
zNfjnnhBj*#R*Q&>O*et-(@8*#_JvKrezptP`mr!l<beuGf7EheMK4Uxt_I{sABKW_
z^Oi{6z(~J)h((36af^>b;S%?$iXA`Zb|H3=>IIUC>-m57UGh=nV!9_{N?Y-pBX434
zuiBKtN(4P?DZ~g=8JV;5QwK?w^Lc(e8p!)EY5cBeaAtkf9*fGy=JRoN^517Y%@k$B
zCoOLixMaB~a;9XOEQbV`2)b$Zp?+Dv-vT~sMEVgnsM3GhxipwFxU^GydyG^~dV-n&
z#JKRJ=~5(X*<I1u;lI*TLv6$U>KZAf`_E-J0Uucj!?c%i@&0uvRmF4X$Hve-y;}8Z
zj`?S$9@o$GUd5hlR3bz1P8)fADh#%B6ZrF_Q+rgMtqzV_*!ZN9|F7FNzfj{W1i;bb
z>eqQRYVA#}_&EdCi`b!-w<(VRGjLL?4?O$?i3%Mrn2jHPP>NHpDvd|kN07|{rD2A2
zMJfo4$Viz<8rmOzeM`OH6=t~+0AS`H$x$M4!l*gF)Tw|h(=sP|AvbqlPkpG)p3(P{
z;p-xi4yonyGw#gOdL~6KGnfW;-tr6oXOnq$J+96gH>G>)S=iCdfl_l8T#-Gbg1x4?
z#+p4kId$i>pWCROB4Ae=Xmq7m)7R>i9OA88Cr#oF3T_GPVm_w<`uQ4B&0dc!&y7LT
z>#awBf~g-Qunr@}Bl9LTtDX5zgy#E-WkO7^2Oq@jJYt5KP)%fxX>E`@{TnSET5Pqp
z$-avn_9>dlb?YpRd1K`Abh-7fu&iW(XZ}4Z7(G^jARh)hS?$JLVcq{d;IK|>03THf
zKVZV6d;~@aq>@!F%VJO;ehu6leTYv5%^2U+*F}V3J99}&stq1h)h|1M)+kb{hD|?V
z0G0Leadv5BeTFu?(=j~$UX-lAEONdrTejUSe1sYF=fEV*_k^Hze(nWbxogK``2B+e
z_8eH;OG|${--(-2^#XpSf_vN@^6S;FD53AJy8}d+&m9)BdPec&9l#tEK~Q}04h{#>
z?k_E3uH<EMk;W~=5WoKvl7m!t9G^LiexYLfK0@wHhx>;OaF=erng2aK>A1y@JA`<x
zCl<Q`y$E$wXpXVS-m>nn+7s~RkH8s+H}0I{4zEeQZ=_QxN$DmIBjdHD06OFh>>p+p
zr7=HY0;LKDv$Jm*VooW@KL6}%Wz>X68zQwgm(Z~|3L~y*<_tFO#az{!3{JbXl(xjG
zB{H);im&#|al~-QZYr5juCKiHHE?LEf&~fwH_~KR?xino2p;cw6Ikig1*Rc(_6|1R
z(HIKcQ#)Gqydmw7I=Os#aiikLtM}GnJ2Lu92Jq`M^D~a;sd4(0KTnj8OxM67$bL+&
zlY6_LbR89L_xkV5)h!2;^5yMtC&WFFUB)2w<2=D!Fj5vWyS#Tsy<R?Kx@KJK+dT_u
z{?+dY8GB@c4SzQS>KbWlmdtyDqPEk437TDhMRqFRYhv6Ny&{6eua@G0Cq8_3Z>jky
zj6pn%W7MZ*l!PdP5=6QyTN}_7+KDdYRA1V3zN0`uGlW{!$UOTh*WqJ@m#f78m!ym3
zBo{8cBwe^X){K1!5zcP@8P*Vj-uiNU$M7zc1lM=kC^?r)3^Asfl+?bD)%oE$>Ok2n
z)cQ@B=G92sj<ae!0z}TTRfD!LCk7x*2GBz#i7wKGIzscJoFPB$<_Zi>k>Q)qTPSyQ
zLM|8uCOA1`3(lStx#^;I80>O0(FJmvU2gVGXg$sNdc<|Sy%bF81NZ(COQD97sYnzm
z+5^#$7amj8L&0COL?B;-*9tkmW|c3^Ub`%GAMLUv8jRPZ`vP8_`{Gk5g3ISyu>_RY
z?OsqC@rj4C^_GTVprim;WXx??q6w`!IkE8P{zpS#T~lXns4I@d3DCM6>00%rYX*P1
zjOdZK;Kxj*akbXFL31X%1!$EZ&3V~sRkFe#N2HV_y5EakDv_%<_7856_nrY6z=#H$
z`6L=^O3_~Aecs)j=d>$#o)ml<vTs__WC@5W9Om-X{r7^wR4TZYPtGjR>Z-HxoCgQ}
zD2@hs&I_4L(os_7nwXG5%NfBfp!2Cl1wLn$d4VUI=@m|I5|a)A!i<>a*t*J>&gtgp
zRs|S3Ti3zWsQ9_a7KgpVDe=VYPTPt#Ni2q(FV(Fk?np^tAr?n!z0yXMR6CJ_-vYpU
z*B(3KXuW?iy&Rnt;l$ub2uW9A{7Kux0R=gv_P?$09TcQ|;*<ckm!kk8)C(pttL=Ro
ze)25Fo?SFIL9Gmn=}PKTwAX(rT3EX``tD+yFqtmS6Qqq4B1Imt`i!#=z?AC|4~XH6
z<Z#}n&Vg62uZkPiy8+N3y2XD$IqP~-q@fT(Y9l7{Zz(4&cg`d7z$iQVXT~yfznwbL
z(cQ};a6Vmbb>e6J_D;*oI2}Vvs(o_-L~$hhH3*TaJ$^D)_b?nU-P21=yrL@w@@~`%
zxPh6zGVhd9-kV;J49Y=^1U8lf-$yn-j}6^kXM4sW4~!!P=ww5pfM9)T&z<`O^xipI
zgu#Z!I=g>E6i2Z*y+@{KROcHr9tZ*)J!9WRtMfW<n&O_o6G++jjahy$=CKJeh7=69
z^%BwyaXBJrzOxLiWTp7vLs=U?g-V_N!duC-EEe5a3l{Tv7&`mt%JNX9?UM15pQ!so
zV5P6Lh&rg~sQ6Wh`1Eq1#guzinRGPZ_ZWkI%|J_sgMdGGD(o0)Nft$RME-uGsb7N?
zomItCbbrt0gns=l!cN*?I%EF4<XaF2?R5?K5g?_3_y0@MxT>dirmMNf9TyeIV6)ex
zbnQ#HNq$pq8>=>uA?ie_beXK_A4GV74VoK~G$J{UE{n*jaPLVI-9{A`v~Zper->#7
zc^4kymBZl;ixWL%`Ig(ySc_f@6^rc5^6+<4g#Eo+Pz}Q;!x%!buKw-6<3$eV$Ap$L
zMLd3%0*QN1_l(y)B2w()oA$g>wO*5rf)4xjW^JvH+!%^8zw2hbA$>kAZ&t@!IN1T5
z={V2c&6K`1tJ!g;J}GaL6`PfmNm>MIu(O{=7uXj2_gKtZ>W}XsepWXGkr#Q{B%nZ&
z3lsrkaLl&?`Z*)fI0ungfF`lf(#BmrBwsj~N8q7<dawQ_Oy9Du>D8zdU%~72;>IZ~
z9On41-yDm}ZFQC>6^?=4>H6?TVU_QdtNev8vu!cPYN=8};n_+QNwd*V3}hV{9S<Y{
zR%ttJPTI$oqbjUwT7N(@g@_tlo-lMcx1ub8fHPJ}f%t{cZo}~vvs6E?J|#Y&BB3j%
zjeoobl<qAc2wgbCKgZDoE--3!GOO3W6@7d{iB@=!^*?GNFIIDIZlgzr1enixZVX`;
zP!klNL3iJgK#LEs-o^NNZvMJcTo_CVS)FdxN7y<Nlyx!i`>4tKf>;}vx@Zt}`cv`Q
z@8}_=f^A#{LixtKFau*nN9a>YjqBV?sWYz&d12=J7&tBqv`sopnH^YK($PoE!(`+M
z!!PTk2`U_4cg^M72+1ZRE`^dIw7D%Q$Kp$_Wh{`jU+A+*+j>z<HO+(5Mq<ZnW99#&
z-GTS@%R<HLRCTu3@M$*9u}?q!Uj<*idf*5i+|GaQp`|@W-{_2EBl{3u{1VQ|sPY25
z8gbri-Cv$X$?8Mxoeyleh7hV0?9J*Ks@DAAdJO}%u)t|>h7_t5g6JEC#FlMAwND8G
z>4p8wOYbhjCEsQFz1!Ta@D=BrPJ3vud<33>kX`+`1%QKLu33r;*ZcMR;%6vbsk5>r
znh?)pOejlF&z?dBWn*n&?U0&S`?u=F{zc$pnu;IMUFXju;OjqE1rSBNUOB$IDA{yn
z*&v9wR2r@2XYASKXIBdVin_Wu!2-%Hxe;l>X(ED7^Q+O>89jhMA{6V|Aj0;Bye2A*
zsiz<ubBKCi`K9QyJ5&J)v4`$*y~o*_5?WfWd>di4W>27&lb?;|?GaNwIIU7{Mr{x_
zy=oVj1Zu5@3zoxXe3WJf!O;u{*S!Y?kA4!Arwc_M9?agL5S)GyGO9q}NJZQ;E)jc|
zo>A}`lOH_e+9SPfeyMP})&RYDy36&p`>f{rYlGm})>o1E!*9+aUHLQyK3_?+5*vZ@
zHJ7=GeyZ#Mb`Samdqa$di{x}yE-y$AC_ln4|I?whwFkYNBb}XYA3K(S?$-=HFIi}x
zm6A5t8YS*|4Gii+^LL#aY792K5(vr7K7i37<J<S?$bP`Ph_XL-B`Efi&ZR-Z0+d|q
za1;6)7D$q_yNPR5ZK0=>oEed@t_Gog7G^dw&7L??%e@Q0<KW;vs^eaUz5Us^YcC52
zKf9T-RVv<;(unb+N`XY=#F6nXA|wpJ{TD)F`R%Xm`Q2tCh+X<P#0q#c*}U~rbW8K5
zVJ}|k5(yp{j)tlo`IE(Qd!~GFshE_n^u_Z&mu6u*!q>}jMd8OiCZM{1*puBrc2!@x
z((On`xgoDNVyHSjas6&}kIsW?$r@iMhrTWy_wRIhvF7*MwRvPE3c9s0j%I%L#&B=!
z+lh)yO;Ri@0N7J9f0Vd@FKH2I2*MaL9dR%^_3kv(68y&71+I)gMvCT4h6MBu(sH}H
zta*K*v0g0#%Ejxpi;w9EJawkzrip!01Y`Q%>P}`P*wJ3=!|Hf=P_-yxIb&W2y7poc
zxd?_CtiIY?eV^=LZ7%+edF6;oQ$;3oVN;5I1}A+SDnIfa)Uz4{0KJB0yWf*>^TiCh
zQjhc!7QL=Z#7g<@?LG{p5@~k!R{4##{NG|t=DY2mrIqpvcoMz9AWy1t<}pr`m_q*^
zY%oVYAi;HFQcQjs!!;z3&AC9oToISB7&q3)zO&w`C3RN$W{eAyCP4%<ls4ZX<63A0
z7igqHO@g7M{!8b+kqKR{RmhO$n>9UQaZ_0uS2hg#pgAX=8_oJ8$v|5C(+kQ2(7L-^
zqZOK5Z>W#lgu0|od}Z(vIf=OQlPC6CZVp9PObShf>Nik!l%Gr1GDc+aG}fxxMn<?7
zMAIGpSatUb(yeWS_o#g^yI4^<w%AgY2l=W}rbD?UpEq+XhfZox;&xiX`ghU0w>1vs
zpz;K&>^k`~X9$3y)(CE4-L$gr%UfeWl^q&Wjo&z7;|ag}zT_Dt$q<_*GTZOXsSu(c
z@vY{s3CA^spSS6c8z7j;hsqYEkl7HM1GR#UXy2U~{ZMXqkd$dtoMnfCDo%;b%0K!#
zXBiLbm4%`FQP)t-96CCFb-C!*vA23=!m0#o1qqvnTpw4@)IWVl#Fb&<__M>E(W9X@
zLK(Xj<Lc`Zi}0xx=}nFT#Es#}+!=eA_@=P`0k<(L{v~f$hlT=JFW^jm3^`7XB^gkc
z+*F~B*ZTrpKK2%;N}cS)O%v`$Wyp&D=rcd1=;qWB8lm4A@|A-<V|~6}tqkYe$en<t
zKV)EXDQ4YC45=fj23*0EesT@h3<-e_TeHJS#kEQK2`brPX#9Z}^@9lOXs8-VH#e)~
zAwia4<iLMY)5WI7U6wKCWscSmv~~6Uq78M7Ah*P3XaCWBQ0*%9sAeCKH|PlxU*rm*
z)8h7>lr|mp4(Wr{j~<iKha<+L%<W@`^43aNdR@mCQ*6F)(clB^jKPQ^$}ZzKtkLrR
z$0Q0QEgtpw?|inza}i816pr{r;{cEU{JxaLpAk_f)~y2GV%nL!thL9l<7J^m`Pv*d
zfXZZQUK+>N@TGn2jZOA533$tOd)hnH2Np?tM)kKME}}B^qq%tDx><pk`1}uA;_+Pz
z)+4Y&bA)d;VUA?-_VOOQK+Wb+0uod57<tKvuld%=!nXbZCrEsCeZ-<IdwbNHv~a3&
zi5rBNe^)jO;o9WX4MZIb%^a0Z*_(n=#cu7-1HXgD+Y0{Q8ww2^I)80kEIOQo=3aMO
z_mDKeyqm9p$`Aff``m$_aGq*3>GDh^c>hlSu8#n$_PwrVY3uax(7y5LuZVQF)qg=8
zkLKmL6Sq$Md6CkqHHVGx(f>7Kr`Yy|u<vWc1}?SI+oLb_aW8!Dnzl1bm7D^CRJi2O
zX%Tq~(Lyer0_bcwQd97xdJtiisvF1AjvD55sC6Xicz@3#3SKPf0R4NFlUGrGu}xPU
z5yyi|TQtxFC==A`nH*)fWT_FFgsU2=#@QdCC#v>K!CQQ@SN*3AwV7Ekuxm9HzhiG0
zv{`uMa@_}YQGZ0>=g;EO>#rqD>Vei6SFQaIK#}y@0A;cZ_JBmq%@DRY?oveN>%Ljt
zDxC|Dg9n@_(b#-(JIzDJre}(SmE4(~NA>?J>o}s1?a(Tl9Pt`i(4_+cI7HbAyc^LW
zqW*6%@GV*LTB{QzBPTUPMTVL$diEG)=Q&nB#-0OBLtPN@ICiR&u<&TE<~0pi-~93~
z?4ZuDuesEHoM{k#P@{dnlRtF=Q??Iu8p%c<B$+?xBS@HgI-<2`t8H>Yt8dZ@B5z|K
z?r(KeYsJsi4rviyj6l>LgS3Bpg+}orW=o!Aa5D7#YNl9go~`1SQ!4~RkV%_8seFSJ
z@^sR1S89Aal;q$8YUqxft%Lck6qC$;N?G7Ahz)SJ&W+xtowK<-2v^0C#P$ea0}R1)
z+E)?!Vnoe*5J<y|?52c%KVq;H)L0TiX`VQgc{$t_2cM_CwDH6fZZ*?@DHi&f!O`0C
zP~dSC#cMHIi%FXJdk81|9@jE@?n?of_?9Z8j!)dx8Z3Edc$)w&Ok9W@PZth<VIte&
zCN+M5GVdoYK`c4O{t<VDisALMnNVU9r&Y;{D($`|A|4g>?~hkS@q$|Aa+bb0omk~`
zW_iaG4YwbB13~#i9tVDBwQ+yq5uQ!L-MXec*nv~j`I&l;fk8vf6$WnzRQ)9xkB7T#
zPZM3||MajqW!jC#kMp?%xnYL`E6|*5xZG<foY)CKt6;uXm^V|7<>idQ7uRS%Mw%Xd
zyz;1gGbs<Dzc)*JGP_$jI$E&fojNRHm;^-x;#o&CzZRW+1n0E6X)ba(AecVYJ&lnx
zu!tk%)ix%fr#3q=1jnf`j_NY5^7{$=?P!Am<#>=iFo{rs%1MoK186ZJ`#ET1%?P@d
zVbpnqW1*FPXzuif>TIm-1`M%)q2lEHl9z+)<A?mzE+~!GgTks1_>(B;U*aeRI9u^i
zFMiWARn1RG!n9IK3k#zM-rZJ;`H~}Q$8dzZ8);i2?BF?lo!YR{<I$)k9&)m8{Ccpt
zFeMHhe51;CWj3jgttvvTbE*^E{-i>(%~i?s$IzoQ;wC9q2KKd)cygxiYehgd;@64^
zIw1_A)!!&K-tN~M-USX+HmW&v+Q!`{+nYZu*tdWI3CvGRy9<bE&n5J%F-)?o>GEW3
zR(8XP1kEwpRJ*5+gpaAb#)Ytlcb`4UUs^`z-d?3*hJ2X)+09SrnB^m+h2@<v(5mj-
z19>BM3DEkH;<!?#|9^oF7TpeJWv5epr6;)OH#P58kTGNraY=A>KyoshuvliO<6Bdv
zUn7+4l!2hFp$GrA1f|OcQim!}u#laXA?&QfX88>muWm!f|F7?YkslG1r&C^A5{89S
zbYfU%7>6ve-UyP#1Ij&7j}MuKc9KN6u!NFIQuua8<VoArUi;wMzAYSkHd@d|Dg*ED
zIwU@qiByquB}A~~#Mkh?Q5QYyIiarSCNAd_a$?P0{cPM533|vaW{tj_nDD&zP<To@
zCYpKd8#I?T3gi*K4qUL0L3txHSNg%X=#`qNF6iK$mOb}cv6xe-e^(!QyL~lP<1l)k
zN)ho}C=!?`PN!q<=JUiCwf$OC)X{&^P@r<NT|f6N7x&;A;`fJr%Qrz$6YWCX%k)i*
zwDQguX)w&@GChcOcF<azK&Xv|4<nq#oU5vjm@j|U*)4ZSzc}$pn-{idoWWlwaT)zq
z`Hut;9a6pT0nFAkime7E%L1(IQe7hJRIW%b^vsptj*>zLz8KBuUTrLCww*=CkeqlA
z;f=GkNS9lVz|~K+gP5DUBlaEX4cwnEMa=OdB&g1-`cf;jsCwxa$WX)n{)dkG=sU;)
zqv%k_X$%&M;oX;%n83DkFIH0ehMP3&l4yR&u0ju3wN`-Aq*<~FFr|fv56`~BCWZ2<
z00`lAAmy}XompFpuCx@Rz~&wn0*|rVIkV$nxqvcC^5WsBMZkE)AOhn^+OA<Ry;5$-
zJ`xz+G1+(|(1Og}2%R=>sf@x`7AM}ss>`6~8e|tKTl{#Ek82er#<5$2Cph~wqGY0}
zFvv}wHIFELAfbr`xsfA`efsFoROuH%*VG9~pZ2wXP|qa_NJ&~3+50xQ4Toig!K5>q
zhlSw>%SC}q+RS*A3{(WwYhF9Rbn#X$r@$Qz^1n}l2tZuGf?%H-Sz~mam1oaiHB;OC
z7!QU2<zY8AJ87>Chx0Q`vxANc92OeE4(8RamHD#P-kIt0vHu5gWoYz^F2n$xTMC3w
z^;g5COx=Uurt_W>=ATiG_`2%p@ukhJ6sKa-Whf!Ch342Hs-$rUyp-FPn{xww|03Ob
z=%k5*?B^l;Bu`w0&m)LXDtrLLrr^RR+YrlCuT(9XSNH820(YCNohU@TF-O@A0l|KO
zQ;<~cn2_OHsrBkOg`Mvfpb&`^3HLi?W$uLBh1g6B8AxR{<&STKBl7Cv=We|l<uV-3
z{XY7Kxc1t=rxD1zDu3Lz`4OevnhT@Dc?S28)=l6L4pGm%jpw$uG}-^JNVhvCjF!lg
zoxrR%D~-s69Chv|Lr96Fub|@<5I<MG5Bj#PY1R?l<)2=|ngo^S`mbgJ=HnlhpVf|R
zx`wZ`G%X^b-&(sF_OlF}UXxN>-bWOh|9=pfk8+(yZ%}3yfe$7XBn8K)MF|U^r_+dI
zGwB-trK%d~U$yL{d6hhQGyxTsCp6J#W8|8QR_`>78jJnCz^?a%850L+oolnWCh3vy
z^W!S*Hc4dZGU8<(@GpwZA}>$<Vzc=2&tdE3(?pigpN>UZsK|`!I=qw-l>$?5FiH;4
z<`NK8AD@~K8j@1t&Pq=wp3}%{7r@agBp^4hh&N+sb*H*w1f<?nK_$f}RKYbj@C4$~
zzHbTb)dWiQvqoj^(@bpNUX)rzze<hiVJ3k<D_`Ok(FrR+4L5p!k@A>Q!-9t^usgd2
z?CJl4NMtZb<iVt9QhFz2B#)%}LpSVnO*(tH>cKgdU<n^=oGqq3y3P|ChtMtWnQ9=y
z6z9mDw%p(8*@KY$HTglsE>nRB!Y}Oj!C_`hPq>6cIYfru<Hwvv4N@;1v2!dadABcR
zC35bCu|Ju?Lz#b87?beiLvT=RrUZVbipwV+ner-bmXatu#R;4hAT5-@0p5`Z+iatw
zw(FuMSrf`IvKPflG<coHq%{;-+q`~b0SNIKEnq0tBYG}GsDYohdc6;heEL}*DIQ27
zJPT6~<zdUIUWoU#Z)(|EQWU{w<|tCMoqv--v!u;O7WT}gHv4_Wp*w%4Ky;mVYF>El
z2ZI1rT(6}53;yI}^8{tSu27-|R2ClEOkb1Gm-om;tw9Go|H4g#D4%+namgt}_TY1C
zmt_UOQCc^A@qQH$AqV_l2KX`E-D~7>T)y1{&#EHK`Vn2v4_g1L>pmEHC!6M!e6S5t
z1cu_IlQ@6iEl`*8%_Ua`)<cNE9jr)&l#&)^F`a?TKlo+JVQe?`nI9y}LpqC-gJsZQ
zV1}gb*sgt<R!YwkFc6s*aFPFay#{)gc)qt*1x^m)2<4Zby|5ZWU$8MKoJKU#{ZV}F
z0RHR>^K|8^Tt1V+8`zH@>jY>j5Y@5(LVP<bpplqk4erfuh<{bKs1rbQ)@?|z<95Hg
zTSR)Vbe!Zm?^vIfqzh02Ok+zw8G3l<J`T(KKk;RB**qy$v5G11n-<X0l*9Bg)R_7w
zTJ0%+Yzt2?)lk8>z->Q`8u7gK`#w+qetJ6FRy$ehj)X!F5s(OUYz>xM@8)7yS?`E_
zhfiPoNsE0E!eDY!jtQrxl`H`Wo7x$fvbgfDLfni(0Caku0aQ&1|Lg3KN8~~a+gadE
znqF$_v6IXB3OXC4%4?7za98P{Ki3B2_J|%!YlhPbE~cez=WAz@frR#JOHkUV$28g0
zr8LQlp6u~$D^V;HB<{=y`df?>10GLcCB3@6*>kzqx!R2BRPFhJEVWm*_O&G#f+-~U
zQ|O^P=50Z~FDN!NLt5xksru|%n*$|I@23a>vUY~e=9-FGf%5<F0WR2Yv{@<!viSrW
zP9SACkZ;SB$pdXhR<3pSVks!vFPzA%6uaQhZXe=NGiPDJvH57vn`R_nuHoZy%RR=q
zf^pgN!+CB$Ur_uRVw6usB%jJK*>`EiJw2ZZG44pfAnt+BX%pBx%Y4v|ID!l<>2I5P
z2BLjw3$M7bi@pptfNJcU<qqVsHoV=mN$Uo(hDu&fRl=_JeYWV?=PJ~hS#*porV|!z
z{`r3rvx`vZIMRrM)UDfW`~}DK(@5*+r;N&$eC-o)v`A^g%ADEtlFr9x^C=-tEZ;S6
zmK1GwBc5TexNKH}Zz)qFKe?|Q{2;K7O1M~Gsfj5rK|-%u{l0;0u+uy$!*`si1V7?D
z^*90K=0$C8DpNE6Y$aQj+lHjugxouDBW_fdRJuUSlgf_l7>9Ub0(DVN!pt_T_$)Kg
zrcXeYHB?-a1w0~3+SROh74nMC(xhw8G-f>A7p3nT4hpR0beCWa7wTFUW-k$IsI{Zh
zE8%7x9{PXoywTUBTu-lD(-FA$E`7PR-3WdbY{)iK0B$iPV*hbqb@)Cu^f)xyTwwpj
zFGuo5OKAj|-}HA8K?CfFiyNy(Yk~YFL}hC=I#u3u;K$<a^i>0LMN}E6;wI9rn_G+A
zUD{!-dZONV8h!IRgoAX$9)P`9d7yOgN&+<(z2VqHOdN&#n`*u@xtLgmsx;Xlhxt<c
z@K0L~`PP9HgSRR$c<p}b`d;qQeKX!yQ!&J1^0Hpzr9ySv>vKc*Oz_G9?ss$XuKj1M
z?isVyKsr#r<JhH;zB}fM#U}-=cjU%aqUxBp)KlC;gt|FG5OG<LuDG8_s9efc>@=}l
zL0%zL#=vlE&}Sghgg+QLCAPbT?d23zR{m!*F-qSKc3b82I1>5->G#C5vF-Kp?7lFq
zVc|gCXGLv_paj!(?bmabQV3o?Z>hkDUEehQS41+7`4QvYXwe_QVPlb|oh|SnI(FYp
z{YTe@=<pZ$Ul-lDdsmk!uBH2}yyhDfAv>kXHuaA-3lm+>1|KgaoN(#6_ZqLGQ^{Ov
zlcO7g2cv%gD}qP73<Dz)WOeptS4WEam?O$uEs#I)CQK(>pZ?_`0rNT*jYEYCmcfsl
z?iC?LH>3VcjNpX}B&*1gU2Z=P)czk2_BorXGV_VJ=x#0$OcJVC3#m~d4A-5l+)3?)
z>d`q*`2gJbkch47X&c2Y`I(gry`u#pmB?*W^gXTieCR7LvGqVS5}g@TY9jcMMEl&%
z05=xY`bPkeBS@ih5HuqF05MpjgJjkMtEeo~?tkc2o6S*3VEM%zJJh6;atdDnuhZxk
ztp2I)&n9+iU5*uADEk!vQ|-vLljH024h0)oha9%*g`*?foND#ssuh$)S1d;(Hgha`
znk#`T5eLx$vo%<ZO(WTfl@T9Y)upWB!^of=7ET(T0;9tXR;euYW!14e-kg;$t(oY=
zUnJh!Cg_H>^nme)J$s>HF4x9IClGjGnsU~la}|ns@KY#S#qeyP82+af9m<p~JT1)x
zNT%({qaUgJdp*zHz2Ni9Xj2nR{9|Qr1AbYvw#8*T#0@9!UyNw{56k+{;mc)P<OgiG
zQN_@!<FF%MFS%z3Fz9N-KQ13Ek`H{%V=s-rudJY8gFSm1(y(3tvOP=KcdHdg-24?_
z5-}M<VF{oK&y7#`yGkAdwZXa@()wd}r;6I`DoL&V2j9?e|Dp6cg81-3+`q90%FuTZ
zhI&X2bjLoN)&SE1rRY+Ayerfo)rdsdLXz(>tEnmVWQzwI_&p3Np;71pxJz~>I)));
zv{MFxRa#8Z#>^WeyC%AppUZHJ@Xm+v!x3&R0C%_v&FUCiwnkJN8m1x>hcSGiNL2&X
zlG6rD=V!42`vE1nFRLX*03-me8`%XG1~Dt6a3}4RdSyTJN1!&5lh989W29Y%HSoSM
zy*3tvTOzT(%4+L=uXktdZK(Ad<T9@iXoioxPYNHn_xQXg%96ajVjK1gH><0gtaYkU
z<~dayYGUFYC6<-b$MY8rxBj+}a4Svn>Gy0gHbQK=$rP8vrIF)l-eI((F~I|T<Nx*A
zX4CVf0En~}@N8p<KT4mTX|DlfLRR4r=8tTS5m6APLdPcFcpy!gBC2!iQLEb%b1ORy
z8AffPt7XfY-1HjFvJ!f^u+ND-S;?1T0(Idj<Y1&S3r%b71D!?!;YDJka6U-D5d<zr
zP{-tIUQ`MJQNmisVO{YA`2=Vu<mPE-k=fH6#9KawjuoRY2TBoKm=hHmZ-UPkf(K&r
zRaKL>vriD(dq7sgyEQrUh$4X*kRSfPy6~(PGMiA;j>^X3sw{lwA-d+-0_y>fjajtc
zgowVxGUEELGHDWP8_OzWX^5GMm2PC`DcA1crk|$Huxv(3`N^#;a<J5W4MFPx`1>$Z
zzc8<&4^9hpQQp&Co&Qns1lOwb1C%zSQgSjS4|o2Uq|kUxaLG&5gI$mJL!Rc2&yaEy
zsa(_1#<ySyh$f!oqlcz_;cTZVw4Qg>pejD(%#3&_G(9r(iF;1FrmNB3cg#EyeFFUO
zFBXyy+x?>&e7Zwy?6`B_1UGBIZJ@ivdL2XWHvL~kshySGl1@lGJc$7b1LL~jc4#z1
zgO@xBv}UZ&FGI)>T^Pcv<N+IpYFj`1EG|?es0X?BwfN;u7q9yjLU24^mwHQ03}l7`
zK{tzqy#C>z%O3$5X5bmmtq+mk%>@|43WrFp`yx8XAYMq03?0-Rx7L%diTn=Iow+Vf
zOZTIxsWl6NBr{|LmkYiBwW&qzmsmq5-TFt#GRp~Z9ez3uX|ZJEw2*}*ir;{w6^9GU
zC^?-|RCGSDI`qYQO*y#0{oQP#Mcj%RrM7i-!J45^0U)W&ab$59UwO8?&0sG8w^`E&
zVF;vjjyT~~W8WRJKa4z(zsQkj8~9;cyw27Uw^H;|5I{kc*2imp%G_w7^}sz|fGtOy
z+bF+!JjG;g&#a)n=nde24KIzI?_ik&!uD6O$4skBR3)<}o_kmL^Y?fQy}7;d_hcjo
z_5?RTH&`r>6Q?eQeRvubnj!aw8DRt;h4K_km6tqpV#Ws0dx>)=*xqpmXTNB#)RLeB
zOL&v)Zv6l_u8V^OyQ@vpF7ZV876`&BSIes$zy1Zj#=CW`hH+uuFUTo?p}P)dg2{I<
z)@s>HkpVZ=ods!@MbD}?qxbVyTboDfT7g2MKUk-$;juRH2ea0jFHp<;&Ca9vkVA31
zw%bsVYoqz;qHU@kvk;~8`6zGIMp-86Z268&wY7(w0mE<?{^Ff@#;~N6vTtVZATm-#
z<t}O5xdy{T$v~H+N?wA?7s#-F;E%nm<{?7panx4FU)2P3z+=UHZ&vLv36J6`0l(K&
z4U#T_Q(SG6>mCr;tuOOXV0rG1$s)e5!w~rme(w&-AN7GX)_8A)H@+Z^?KV4z$;2WQ
z>VbcfpG)X|ekk1Y-l3!)Qikc86EHBF@vRS|T{X}e8v<M*Z7-K#n!u8zk?RJypwO4N
zTPwQ8M`+CX4Z*cX2G8Ex5+Yz7l<}p|FAr|0CXWl74-<-MxbtGuBbdDv1SrL7nHbBN
z-ehFXj(N3v&s-`Oz;WxZAW{kin{%qJ;ObXj11u5*r-$}1W>zAevcFt|0ffMAiZCCC
z%2`{Ox=UK*<b|jiCV`wJbxq&P$a2e<Ho72EoO06-yiq4H)n5ZC1aaI-?joiLXT(U$
z>Yky3D7z)#h@7V{0C9`kWej^hwaN*m-jI{)^*)v_lr?wCdpE1QC)NAA@_HC(|HFUS
zE4@A$Nc|*?9{EZ#I_co7*zL4U_%RqBED?qYCCnHx(W2L=uS<g+iESM6xNaV!#qZ2G
zXj_FLRqsq6yZPOIUgl5!gvv(m>-3xND%4cgbd#UEYn`8!>!aOHEF2_Rp8kBvT19>T
zd9c1`(vfUhZoex!6!wwsm6pm8%ZylkF;;iUYh$W_P1cJ60l`%Ud*kzJe@MfydU7vN
zHEt22{&FqzzKhuHL35+Vz762CfnXGhui_7w=!SUsHc?ndqhB@f(a;f#L*u~X*Kdsm
z%Zrl7lYwKC{Haw&`28N%(sFz%h)g!CG(a{wwAFO1?g>5$WD-^h%nL&+I2+<>q+!=v
zyTa*TkJiR}lM9KI2!Ekc&$y<2TO>ftaW}jx3z!w>{g;L=XyVI1ZY$_NO7I|}bAvfn
z?{=6Xy>2&MGP|2(w!dev$x28Y#d^q^S+4A{S!`mVx&nZu*((`X#3>IkdAi!ljwrh(
zUjF$g=<-<|ctS4r`LIBfpmgR`5TU=|M9KR;e61(98H6~s*1G>+`Drt%iNw5I<vjdP
zexz=|l*O%YmBtJzvsC^)itdXLA9gl}Dq$~efXGn%!<<irPCr0)Fmc`R{-wCKl$~8Y
z$d-9Zj`Nc&4<H|{Dc4q1{-3_KVY}3*9^b0!45?)<(;?*%sOA$xWg!r4J#K^Ch_%KJ
zqr}c}7))yDHNf&iz-w9iDbfm_qM=Jn2XHH9JAf8*(`#XJB>5I+!gL6Q8{wJxF*J)~
zbs*RkpGDFfXKjc<g#WdEpIe^HtZ$Edp+8sCndZ|!-#>^*!_uKY$I^!(G>|4pweSIX
zw=E$@<GKXyW0RxZs95UB<AehAouG`6j315c5xRZzWh3^~C#Vk%76i$UCfF@Tonf(N
z_Fu;k?mDQ*0arSQ{U$Wfb4<F<7#jj$Udv3}p1`zPy))p2MOHGK5Q-yUe^BywX2CR+
z4fy{;MC|sffe;=eG>Ej!5c6L~Fo_<&>Fy0TiP|qjXhZp%a>@1N78M{QI7lCn6$slU
z?kU^j^UA9y*|NaaPEZdwiF5bzOrMSc$dy#8zsFvCWj1#Ao0x<5QSmsoy4J?7!4$<d
zLnkKi5@~e@d6pL$PPk}ktyK<UigWORwlkzjHoD^)@WzE9u@Bk16!P;411^&HVk19C
za?K<2-C-+L<U($7^_BFlp6976p9#`2sftvV8I3xu#!Zsbo*f=>*n%ze{j8Ju75&KA
zuDliU*J!q&uVJ74<+<4Kp7MDpjnedS7hLfj^bJ70pyf{CXxdcH-zzWI--!b)<M_^8
zC%sR(6Ufez>z}PSVo1Q_`w)Y=_EBQk=2^6=uLYS4;1asTZh>y#>au)~_+vG7o>?uu
z8+s!z7-b|%2*b{!)D(Ne7uWGNcYg;kA=<5i*_^mhslgO~bR-#23)9Z82^X8$55yP>
zzmKX^fPq?4f|mo$9OGo3jjYDrS5Pn8+>XQ>Ld(jx6?R^J%VPf}6nulLgr#qpC!JXR
zt$)7+Enr%oxNre?7RnTOw4ztL3^AVm{VqXC{W~~ygRChDB_z-|NhJSlSY+yY2Nz;P
zj=8PkmoMIRQ`F?zqqf7&mIHci(#$+RILr{&d=@Mq%BHAJLml9R_!2@;Ib)9iP&j#2
zicX7dH#|8M?tiKU1ioz*^ny+~DREvM*5u*Bt3zCZ&paZ^c-I*va0rCY&0N^N5_b4T
z?#2BZJw5zpYKahlet>xvOQw|7;=w^y$|kF1Y(B&aFnH4K!J>-tFfmv;ky3~4WQYv>
z5<bRl@^+SJnF}Ynp(kM>4)WVW{-8I;i*TmvI=d+H<${+e2XsObK71dSPA!VuSKBEd
z5RDghz|OWp5XOt4-b0=y_Sq}SzY*yV>*g=bmwwcsc{DSmZI~Pk%<%CQJj<CRm9TxS
z3+evi)EorV?_sqIB6u6oiez~oxuZ{$HqKHJbo|_66DaxB1~U92Oh;lb(-3ILik(U2
z#gT^mwI?s8BUo^tUDV78ip`aM{?)N)2g%Aw*xIxH&dZ8+IgVHA&?cc1;(+AFH9rq{
zPeJ=xIi>bnE;SER7^lt%n5)}FObx#;JrufBs%4vLmO)35^k9@$hNoPxf+I~=Cq4@}
zTU3{z=eq#$8M_xKFZiU0#2s_wFH$R~syK2JLkK;Cz@SwQh%BgwRJ?rK`n5jyukEqv
zA4|P-os|rx&R3bi-<s<qJyT#bF7vwSFxAM1Rc%e?2?UO3l^uz5KInALI@!e>`~=;m
z@3U2WS%qdqElQaz*1F>R^eFA*aCGGvAi%Jt7+e{>bkq^|Z#X~dhHL1V!S$VJQnts3
z*80KryUwFW)P-jtE-xCUvOhavRqtR=IcjZ96y@){=$s5#rP~dPPaLjNWOeX!KO9d}
zqfz}lA%w>>D&&E0p!us7$F%Q%F(bYJ`@Oz2&Pz-+m~|2<$>q*bn#Gy528|zE+ns^M
zXfnhdL=#q)PzNg~Rq(Cpx(kkn@?O+d_L%vS-68e>wu*#leHc&u^m1!AS7f#k2htmm
zqJ2^CD%{g}@V!!`Z@A0}B5FsFnq0k3?#5sOi{%x4P_=Bx4aWUT{7T*xevzfFX#(nr
zS}Lo>CPDDKtDm5TW}363yWC?%zqx)TxL3E91Z6X@;$4#6%3gR_>USZtJ#lJHMVG=$
zbp&yW*rQ#;YnrhBlKMG1QqpD~&?-HgDioVas3xdK(Ig$0sJPaHEUdMGFwHOyoT4fK
zi6!51x=qHS?JOaM?$`zAc>3aKfbqZ%w{nm;b<#YWCy!C=ix?#mj(9x%23rJ|l_;h`
z^H>S*6`}Wnb!!P_DmN2pJ*d}Gvu>Bv<~P{QwQAX{yv;R8YnSDua@EmeJHaK)d$y}B
za$v>M2+6=fHiGWFnW0AIlAp;!aG<X2rixq##;{lgrwM`o4$IxwHK}FAB**8ml<PZ_
zVq(TmaYy$_4=+o|nC*TH6`zeHWh_;TUgt%Gmub>4uV~HF_`*~vC&vyOZU<uW@p`od
zUjjgJzZ?6urs{bNueHX!jn?gcE-2O&cS5|!OWktAd0l0dOcw}apuHSPnDR{D!zZ|B
z$eI4K(3aa@f5!z~VE$I0Fe}N4F?(Vp^;6ow6SH@>!`u^#K{F4uq3~a6@6o1j>PiVc
z)oiFlvTfI6{}YN%Q9@aUOnr_9knXfJLWp5p=}tLlVOYm^#^5iT<c9Qif)BMStNUpu
zg8DJB3?2n<B|*Lu`3nt(cv|##9&Tyre?@XhXFW51_MR?85ytA8wEK9J5KOj1tA!37
z(@AA+Iwh#GMn$k8fso1Vimj4z!s$1)fGpLT0NAb|FuG)S3YvzThFAin>C|YH^33Fl
z6ixmU1Tsx79&TTL34g4jd844)Kc?Wqc>29OB?!Y4l{1(8eenIcZZx83`Gw$j*8c>Y
zarXqZ3Zql}W7;B$FH_(6j#%fZVMm+6+SYuGC@?>xbIzROdD<80V=>g};ghyrq=-x`
zL)hI%{DdD_pJU+GP^2$T)vc#ppg-p4a35<RP1pG-<3+x_&U?{E=f3UfAvh<8G%~wd
zIpbNs)@in8D;c`rF|^4%teJId$u@uN{m)pqFlDE;p$&v=*@PFrnUDDUd3qo)_VxK%
zLL_x9Q$=rLtZu?|tU9r0`<$qlB!tA0Si*G-nzjT5$t^A3o9=FkYLKN-JTey2Ccl9w
zJcm<i%TG>@u_P+lzT-^<_oJ7FJ<6MnMvoXG-3}7$(tvNOC9a}lveB2zws~R$CR<6M
zXH;kZI_7RZsw7vKNIJhefcWB!b_iYVeGJ{VDHTUh3W;jrY;to-)m7Nl8T``eiLR*t
zn%$PX12=)@crKJ1@w#6Hh=3d0`yvHNI`KXTAigFEZj`RJ6&u8^sSYACTSlF<K_^AA
zX*sktv?@_<*?O+g9eY=pMT@5(J~P$%UnuFzi#4s73W0LjTKdQy=hs2`n`luWiC_(^
zFwB~{ELWVOUu~5`7ipz?w&(AoGb@%jC~M(*nZpoW#HE<hk3kmHJ<nB_CXv3%P-Y6K
zUm|pCAhV5hl~9C8RMMA#;v{^}8iUWMTKq{>!<rxASsvrf!G(_jdJA2tt(cdshElRF
zDuZ&AvveP(zk3qF01VR=I=@F)wFDH-9i?R5xOtvPWfF2XDNOHVNC+uX^zZsDp|=B`
zhq^Dc@CoV1H>qZ(V$DIdgYp&*>mlf0ofXB~?n`&7#=HkFz<X)P8?Za=kEa#t|1(rj
zah{K+>-Wk6{8bjE@k`Q-5PYf2GXtBQZntn2G_rXYDvOtK)7i-fk=cgED77XzjdFR|
zI~&;TYd;lk`b;C5h~j+X{B7w@3ejB5qArQ>KLaA-<G&9Q!MF|?Tan${rnEoVJn2k3
zn+jHr$yJ_pIox`%6Wlh&RIt^Eb)NyUpwTbFA1=S?vL?oo2mZ3B!oPhzID9OV=DfM9
z=PXwrdN%6;(we4EI5~&58F&Ix{@)v}*-CddGc$fU!j9J%-M$)y43Z3*<6@Ja;t;Vu
zm_~LrAxs}=?-O#4n(h1_&aRH}t=2j;d#s(YdRZi{@4kBMd7%&5^)ojjaNfYXJX(EE
zk?6xRU){b7Esa&&(FS8Yp-6Q7V{9rRD+_B!Fyh^BGR8&7eZ*Uq2C~K1;riYKRf_+3
zWj1>wEbCZl8lk8CLW%(7-b#H?ctk?xq*Kxsy()!MnsgY$_Z8wdCELs%jKrZ4aOm9i
zHB-`{2vp&nbXt}|E>xk1i+!M0*DO@ig^kY{!0#m+xmQaqhdVrwCudRarHbcBIZ5e=
zD7jB|oK?#<r~+YavK$$d)rF{<3<Q=6Tt#r%px|7rl?fu2$|g!#1@!St5xY|57KoUz
zBR>0w&8&6HTX>e41th&iH=1hr?k_;0CC5*m`34PM$*M}D%(O7N^S1hC*ztv@mjN3{
z1dG2!%G^EmPIXjt-k5dN?LA0<g(<pPD@~dwg@HDyyyJ~OZ`ra5d1+o%IkM_*%^RWp
zG(4v${)xkD=fsm$3-UCMrOBg=aUOfu{lfNo|Au!hd;?xNUUX8>p^gGH`X#y5gENe^
z5di(2NZx|AJ-o)ciblqz^`v`KMX3M|JBo#pDp{D18g2&rEQdWW{*+QA@)>Z8Zffb5
zyhkzl9Z-M%gS(zSu}<bNatioxMIhi)t$PD7nXrM0?KUoK;fVbQ8-#*}#^BEwBr~WM
z2Ifcy>^c<bJDiupWKJV`2om|i)Je>D(#R>3MXU0ernMbWKbn@Aw~wQ6aFTo}TaY8K
z<KK`Gs>5lu>l{@ws}v%%`o7L7JzP{LCBA=qNaqHfp6B8}6KC^K+nY0>`SOn6T(62#
zq;PJP_4vjt`hy>pE>8$F#Al0-D#w%BhSGGjszE)Fb7j420RL?QYtrbEY(B6!SSgAQ
zcO5HnsDld2o*|x5sKhuxv~x9PRSpM`lksehN=?%1e(8Vq>NZ~8?R-!)-j-pKE}U)N
z@E@buPdK4_x(x?8dY+f6Vn%z-5sprCWJSp|51vw5n+lSc(i3?g7DqI#m`MwX{CcTD
zkQH@~w<5u}GVUYsJE^=^IW9h?-IKi2;3&H(V6h0BzxG1`(HD1}jtR=>@@}Ho!3W%P
zZE#hMFsAR;ar9_dB1#oi=axupP2E>UP;@ISQi%8s?1@7NYRoaZ%5L+Sl}eLd7|Xfv
zM8Fxk8sc%sUMC>BIje8<?gh0?jL;bU25KA}SgrHjk=$}(PHF?cx(D<4D44|Q&%Vlb
zB>D1V%aKJlk>LswYX<cD3TquT9d>`^pv!dH&u#+4?gWRC*$-|yrTHIVn;!HZfN`Pq
z&2GuNqn*E>U3rRK8(2`qoipu~qkJXC)H%>C^pnj==GleqW`S5bLFc_wH-KhfOlA9W
z{+U6bFh2BI@o(KIJ}&+3^4&Y)^Aq(W!s#+-K`#Oz&@iqy!l*{eq6uxLdK@Lz=WJ8X
z>0V03N7tzq!>XU~!0WEBsl;MyEfHldQAYd<zo-rFWH!#(Y4BZk?(IIM-t8bQHdw(a
z$Sb;1AR}ywCJRQVzBOg*mhhn)OxMe*2}*Y=&|rIz@TV2%L+^M{r?znF^-89(Lq>3y
zHZ?}RfOS$R#c9^+@r15LV(C?#5<^N-@x6MQckrTXGj>{~tB&$yzZbC`3e%mV%d<9I
zUHO<J(~StL|2AVY0nPz1hH8@~P}%(LDb)|bBV}u+Pm%HW!<`^BGE_guy2;Xqg68Yu
zIUlq^@B=fEiq5oVs!F~s(IU7}<m|a5to-9)j=MV2$pm`Loh9B6XLl%l5;-%6<x*~E
zy-IscXp-bxWhJ=ZW-rfYKk?L%?RIq}a4ZR2xrgW&*eyGo^-zQ1)e=NQH^z4-z6;=~
zLOjT+^Ti_{=luA<%ShL<GHHN!#TpOy%qk5dAlk|3uCMA2pGmU$xAb~hE>7L(rC1%_
zPn_os?)k#!NHq{RKZDviTY<N(4=dw8`V`Zh5M4W7%q(~GI?xfT<!2J8iCUMk&xTLY
zic10zP1BxgZMlx^!jt42*kHa5`V4}*MO&f_tcrk22}*<U5^KZ{q=m^t^2x;h&#BgG
zX;5q%^MNJ+Ri3x1L-P5L+0X+^r0!mzP=61c6@)XX@bC4oz>iEYVlNcXf@lCOK+?ab
zA@`o(^v%^Xd!(-hLmn#$zY@@~)km4U2r25USR+RjYPa8AirYva(0O(O?2x?oTnxDO
zitT8*tqS8b+W*1t8w8vu(UQ5BN3f(5Yczb-H9l^+kxmet7&QGND2FU8ooN~bG=7@$
zE{9AQfAPm#YVZKgmTcjBH8Z_+-4GRGrY(m^yvV#B><EwG&BuSDm%3RIWT8?_Zc&=!
zwN-p4iAhFw>^Crxc=19X<H6m5(W+}jP9W+#xDNAu_MZZExX8mH(BdQ7#@Q&YW<o*-
z=XxCpJEKVD%l=V7$?Uz=-e(QpwXm*eh&S~@PLZ|SzMA+hwcH(S+l~&S9FwN@Si4Sj
z1jQS<<i-<&PSzD|AHF2FUaM-aMygH=-e|A9kV)F#4H%Y9<tUdCW&QBUM1Dk)5WWEa
zM&Dgj)~^IJZ$R=hySZTd+$#J$E~FakHa~QzT_}V<n~Am7wFoagd7Y^HuA~*UcyjGH
z4>Q#HYWQUO{dnn!rgM~E2A9!FN!ep+2d!UCE!nvxy_Bf@Y#nTy*gxzI=vlFo;%X9X
z#xEHKKt_iA_RYrXK*GXfV1#cNlc;I>%TQ$%H@B<jMi0{I3d>J0N~z>_V`mGsBHG@>
zm2W}28h2-vP5yRZ$W;UMe_yBvY#3Ks$jI!$3^f<Y4-8`a-YTfQ!5gp$PMB>hAKwN&
zhHKv*<S4(2RjO`KbZf={3pcRE0zm(l<dyIn<69;obdl<+&a;D$W$R_73&W(Lc20?S
zA7`hbWC{`$#on)+;{pTk-@I=-Y*3uT_eYe)rv~C&s|$JyK@#F4Sle3=?Tqa0jo!s3
z41eWU$b8$zot&-%xlHdK@^4g<S>3HgHxEb$fP{p<DPCCFihm}c%S#xNP2fkh+#wwG
zoE^RgMl?`X%RkIiEWX|Pcq}4}F$Et(F!X0fM!R&l;LcJ+cCU7H@_DEl?Ef{`@aOVh
zm9B%80EyO|HbD|4xOhpz>Ua+I7je}fY5#^dF8ih+*XM#xxD!8stZkRl37LqT+Q+&y
zuGGkQEPLu6oXyp=o;J2OlB>XC6o2B{(AQWiNI{xRBa+H<Y55#@9<SW%ijsc2b4Cgk
zr}GjSPm__Go??^l_XHXVqSR4g(LO<1qYaG+xJ#yq&n|j_x3<b(z7l9h4GyjB3S-8q
zqk`e|$}qy1h~G@pW4;BC<vFyQ%VW@#9%u*Dq9;UIAwg!@e0@V#jk=z!L^IR#0$mpf
zpw_OOpm0oh*~9_~HDR<f5D3S2Od2QNJHrqNBocqIi%=XoFM0?&<5>+2N$QuWbYjE&
zt&{g9ZzF?{WV){21Juqt9mAPw;U32tX2N+~nM21A-E+?t%ryr9L8i_T1?PcM7ALU<
zo&(>`etjH;hyBNfSv$#%Kp?X_7P^C}A-t}B$%`q%0?^PfQR!P%wt=pG(xHdz^kHx%
zz<4$w`wGpg1qhiaJig$W^|>p;1MH(`Au0^h6qwIRX$_SVKKaA~#^z9~{n?=U{wIA`
zuYfAm5DEUazFD_Eg<^=?^Y_46#a_Eei-pn>Dq!#un)1F*Lka)FQ(ae&_cDQJ4qnfO
zwjzkUAXfme_3#0jqi;J2g0CF1<DP1ZeX*9t;48%plbalAx;DSrSj9jtn7##1_wJ=$
zQn-BS1fC1AmMmfo+W0*)<C1>P_80eri7=10nvJ8x`uhdP>D|K$&djBn)4O2)gcny!
z@yAol`9`n@h<pUlBUG)Rf(WAy-*^f|nzFcXbu-UUP~ug=@z!w0I{(2h@7>hPQGMnQ
zPXqWclWbdxyI4cLgob<FQ5pyr<5G}@01Kb=CV>Ru7>Qog<tS&}+oyW9T=sih)}sDg
zMepnRwzOj4vi#rpfX%>yy-XCCvNzD<M=0rGPX}JRkJ*yLN|YIvBJD%82l(z{N?$n@
za|N%J{i)p+L>{2&unq|Zmd1L20~0b%l_ne*NBtwiSQ`P7BL%PNhN`U%>^;CvXu{$s
zR?>3C{O4<9w*7|47=z~t=$Rbh8PXg?h-ee2%}?PKJ`Ndy^&+{D9moG$%MFypMwP_u
z$CN1jtN^#C=c;g!a~ZwCPA2U{BeX+J=Z_bRM};6iqM?~o&NNBuD+OfjqTABF6;2g;
z3__qwGwEKgr=y-TydQi@i}u>(Li9GHh&;Gi$x~4yzP~|fpkamqc(60rPTKN^{beTv
zxtAbH_3{idX?S3Kgr#KzBkO3(H$}_@UPumv{(!{6yg+%IWY^b8aRlk`U*Fnq8y$GF
zbyia0*F9)xKktKTtPop!4nTGf_`~K!rSr}spY60H)v~os`E6j4nja5TFo;pnKI}Qd
z;)LZYtk3d7B?`7s_3769^X?kiv!QXSx<?u1|JdWJxfs`^<Jga@%zou@E)C;=vbb1A
z*)EWSI(~w?R%16u=G?r9m5n)KW1JX?D06*zfyt|4ry^pfYOFyCjsd+yzt%4%Klg3b
z`_J!p(E~5d^Tm8f>xC1&`6kDb0m9r}kNP&S7qT+diXlBt3hdKW?ud?KXcQ&^U8}-s
z5$wQO=>LO4AvEd*vLz-$GBh<otBk?4i+j3FigY1cmxO6OC4uYfRL0JbCzTDg=g0%d
z`@0i3U2V2#_sMYeyHdlqcS^XjPoH=zdKwrHGAO;)FuH4SGPGCKT~y1Z7m@0oMTNqj
zdD+g&GDQYfX^2Z2PO<^lx^&2^fI6iqK<ht|dbQ*$f29!E_%XLJ#l}nKJfCRc##Faq
zt^ql1)J|yp#?4>W9RLd4;HA~9*7%_SXsU9MEWRm(q$usa%bp*#yNlL=tr!qFb{=W?
z$>-y)^+=nX1W#5T7wSNs_s+^dg7_rRWxZw1P=rGRW|xP0(ZrnRj;)g}rBq3v7?G_B
z5pt6K8=Jqd4i}|LGPD}Zb(U%vZ+Uoel`E?_@JO^56JV=6)_EW_DuipkBcN+Qxe_~z
zE(42^So`v0lS}_ePVMRg6c^t9BVr2(Sz8c7+&_6njhdj79C3n*6BY_Pf0f}W^GY7b
zDA1#aqJ{8Cv|+>rslLLv%V52Yu>0@(ML9ABE?W=knN>0zDEMqT{3xhjp|GB#uO|P$
zu_Rk>Ycv)A%8QOJU!kpdotJ9f?eX0;t8>R5D7U>>r*P=kbJiYblVs%Rw)>^K=j5u!
z5eo^^DmSKLiU4}rt8dt}+c8k9r5H|a4&_7+vB3ds^4fm(A{At=#q;=rDo9Zo3e^ku
z{)g%$IZ6F6$PPP%e9K(|=6tz?sh7v>``ZxZDx9X#cCWPRvXhLxxPdJS&4>5H?0wX~
zsE7bzp#EEvj;GB~rwbaG|FsI(dOv3aZ_}>%ksiK2nWQ~NN}@6>pp9TABsHP<x`zKI
zZ%&}9iUN4XjTsLmF4Wx6b8WgY#FwTDHW&<4C90VUA_}%rV6E41!SzbrrbdJm7@2;v
z`|VaU0$RYv$g=@7d&-FOS)Mh^dqbV9Sv!Y+te><f?Faz%#;3n76ADe*WDZqIaBPNF
z&;|~(0b7`7lx3QL%cFE4QfiBp?HI_MVZDCW-<`9HN0s1-*Q0Q1;lF44yr!Yf6p85Y
zl-y}px*`h-!cvCcq<QA9|IpV}xU!z13)G+FLhmS#`y7ueeSTIPxB=16zx_-WU+MbN
zrh|TCm9`+amz%G<TZhCGl|k*uxpr@PqAM^4BvOaIzjp+WMJ{kP%AJr5o)svA8s*<y
ze2Ge5b*rgSBL#o3v>VG+{ljorBO>M^&?n##@6qD`%qz<Vy=QWkrN#2a@t?)651GxN
z==v9sP|0=I5vdt%Rd~G2NJCMy4qrp70OJ85;I@IWk2s<W+B2c=t(+JT&(>_f<U9yV
zqlQM&qHELA=+%5omh_eqSn1~`Q67!=dF{mEV6C}3OfGeF^;o%O6oN7@H+PvG-FsJw
z^1A?4y@c^)kXW2rYxXTvqV$>@(5r@&_xPsOu(^;Ha0otbOF)%p)bbM|E)O6X;SK5a
z3iuEb`cH9idxa11PE+}bTcQoVtv9<$ea{!*zd^;-rb+|=)xz&*ND4Fw-Z~@)vk}?%
z0{uAhJ;(^KfYJx*zLV{seD}(EJsyLv9b+GveXwOLH(5gD_<Z4&Lq(`i+)Eq;k@Q0i
z6SPKJIMb{9Y|N5FO!9iqcPmvw1dpxB><UJ1h`Zmp6ch5#UL?USyVeB?i}d%Vj8v!=
zdfSy3=VVntQ2R3tM$kY3V)QYk<bS|@q9KwqN9kXS`tX$)Ehnv*`&m*U+&&}Ee;iOW
zXpKzQJww&sLJaj7mX8{GjBoHtH&M^A<+-$1({%eZ8|d;TtXw#Nt^yypxB+JPP12Uk
z4aDx;{v}EPP28Y?l}r6JXs2xRKILWRVJQQPnG)9)dC@3oVLnCgcUP2CDa<dTt=-Xi
zmg1O7WVh^6f`$Q1wtL|xd=@SiwF^+1Ci083Dh8%*r6X$J%G(Wyc%R10s~1`=kowRh
zB$=wdTnola7pP`<Sut#63miVgVHpM{L7``Dfe{r)-w%`d?cEqH%)vp6Z2D%fX$1~g
z13X(4t-6ed-#peV>lKh#FU0_{0D4sPUohGP)_k?7BHkr67wkZV1LRl~t6_j!X#yzC
zRq)LFj#E)^{XX(pA$xlCigek&gh%X?_GeG2awvXfQO=v3)X1cA;sLxnC2nIAY5n#l
z7=z?cjM*42SPp13?8T42jI>7+8(yC?W~~{QG2Lu(vhzCa=D4uL7#Cbl;anGOv^l{F
z{$@*L3!G`=g4)i~dknd%JPk?_XRF68=76}F*JS<9&=O{fysSrhtN!o;t+*Km_9lpw
zooAeL{WtIQof=`(+Vk(!YMRPEQAV5QWL$jU5>K5zj)k7Y<r&t5)2o%AiJFiuornA#
zIFrC`E`O(oAd2N<huR(c8A19c>tk%+#*gu3ntnK~?-EXe*cI!fH5o5_|331P(HLF!
z2ii>1HmpMy9fZ*D2sIb-x5mD3BXp7O_3B(ij2WxH^T!3vXJR?fSv#M@cn2Ip1NWtE
z643vVXia_AujRaQrss;gr7dnO<jE<<xB39g+q+!hUsG|zcoV_JI#0eAj1K*#3_Cf#
z2N8rU=`6E6LmW`q2NsbcSG#oqou520n{jaOd&DpecB=|GV^A~bW~|>o^uLXr#>Rt~
z_9T*h%gHg-5`HeZ*0`h|8?K0NaJwj+@GI0kTJY0eSIypjGs&f88bsk2AzF~%UZS6j
z$thO>aaweJG1v0&Qd|c4n}4zj!0xI>L(uDlbFukrN};VLbWc>EJi<(0vFopi6lNn0
zx1(wGP`FcsY^8r%V!oEj_Za}i{^>2Y{o1Thqu_-qp$h{xf{A+{V0B|j0!C3xe;v>c
z0%H~uopQPL_6#m5A_vD`y8+Ony)KUnMWbQizeEm2Ftc&(AA1Zm-GbCp^ZFD3wR|!`
zSzw{%Un*u+^RR1*=N6*=D6istzK-J~{q4K+6$fI+!y;iI(@}#Qcqcf?n<-~r<59K2
z98&u)6A9d4PK9arA53m(#<~LSQJUl((+&ESF-uoLJ)miU%Pwc+u8F{QWE>rZj0E8m
zHm>2Ut*Nps-)57vm~puV>piXve6?>Pm{A*J(j{+iqG9Ul(Eo>6jX#~JBzgd3nkRQ>
z8W~9%{0II-Qwwd!*&n`*8^Nxc0{4e3Rk{NzVSO19uJ5_PZ3}4CoK>DEuXelhh1JQR
zRz9YRs_Up?R>z8XW>FmbsjS2^0Cc*;8@d-)zn8zi=Ej{(F#6@D&M;`ugP@8<%X})i
zUm;^I4ZUhW>>~)C*lSpmmIX6mN_=;IkTJ|T)Sdf25^9}>&#uMk#dv_-Lj$SOKtXnv
zo;~Vt$edh{3^7$7wWkhDsUtp{7rG=ZA1@y%ID}w3X6&2mPZ3RH_4e6%@dsN&_tbay
zA6Bz#q5J{!^zUdwK}*2?*~cXeA*p1FVw_!+*V<gj19N-NL6{pi_Z$4#&vw9?Gf<*`
z91t^+w^h!Zi_ii!zossau)NG!*R4A9x7rr<v#p*Fg>#Fs%<f`+<X#R=8~LJg!2l2C
z=@JAN0>O+~dHJPb&RLmBC`=(vlT9ao&2ycU3XEk1r0qx5pX>$_tPSB5Kam3Sf2Zn}
zem6QHXeL>jIiop{loLSmW!KlGj+vZ?@NbZ<5<-u}H!AwT8%3<kSGv}u8G*ju^er@@
z6uge6?Qk3=g-sQ;knpUDxy?=}N)GA@p-rCSEEv3`eIJ7JW=G-UA&~0}AU67S(cMnr
zk`Cf+&Kn6l>W@{^&w33sYP2Wx_M`kxhrm~6mv~JR=aX&hBE#t;+g=VOOTt&LTR4KD
z*L-Az9Aczz+T^$O6W2+-un<Ljph<4vN;jKS@b8<p;N^A$I#F07M7<+<5T{L9uR;R+
zkk;qcY4FTUOFDIkX-#37oD|2wc`<^L`GA~u#tjCS_Uprg3PW)f6xIJ5tEN3)uoM2C
zIewk>ze>i2O={YVsV$9T2>@MA-N*oQG&1bH5uujzfnT`vIf4uyT$RYy{ZzvsE2}AG
zApe@H=(m*jfl7RC&!Fj_J(I&a!jz9wxH-a~M7N;Q7k3SIR7KGj;2QVRtQ9&GGk}(<
z=Hf2;xPYM&z@ey^Mzy<#fm1|Qqe7{gYokAQ#dL*-W=@@>A)5`H(LY9e4eRj6^Nx1}
z{|Q`Th6$Y7m%r?Kc`LB|7YXq6m4=+5JoU_^H>%K9-ZKIVfUae{!a;KqkvalpzgfLQ
z*b3Q%z-EAn|J7F132b$)2ZjIkQ{z~n40b`3x)n)7NckBWn0E7Td6Yr|%u}6Oe$?-k
zNG80I2rj(E8}81CC+4xyZeA%Y@NXf0ra;P~^!@+4#gxD1)jKqIIIvbsRaR70Quw2p
zcGP&iBRtCkjKX1_9f7#Q!XEQ1zcYart<Ys*EtGIgIBU)A=jodFfgF8Sp@C_w0EjWO
zoR&=tJ0o8HUPdxsvk9q)`6B0s#x|rf89C4fOk|P;@(YRjO%njqJrV4M+Zf-?_LjKz
zhMuxCf3;77FH5)((zWqqE({TjV<#g}c=D_Fcv{3&OoUhylUASPUeIgNN!}tq|G^Sh
zUBfsqKHNF}pwUK@{O4Y14%eS2QF|om(@cSl_1dk+&;a0}UIdjy8OR2LW5prV2#dk)
zwxVO-HCa6zbjEw|J2w5h3H`xxzaXxxB3d661Dk2Wu!5~ofs;tdd=`$|Q|I2%+bD3>
z0;<};1qxk*l(-GA<JA6%&c5C101MxE0<uzZ7e9~#QxpFP{mNstY+n|<?#Vii%`7{t
z23aBUR{L3=)rck^uV&Cxs`pBo`+xOIIGb62$hdMCmTzGl?1s>6l5>^VgEX13Pra3T
z5-{Z7CalcvJ}*~$RCE5n<1>VJ(t|&fvHT54tx|Hq|5V%TRMc^y@=$(f2N5Tq+9==T
zL|H9yq9U!N<v<qu<9MrIfgeCooaMy7I}iRqN&|}4w8SJ=%j_zA-lMoM?R~hdtd@6L
zF6T<^u|B)9NO;26lzD7a9T7Rh3X=|Ti@Jvi1YOMWfM*4+FU!x(b4%LPbOMH5Ix;_r
z+NB`V6bAaUKdttrxhr5AM~Z!PRomvIOvgY8y@*QB?2V7-wph2oSm~6&Y412yd&=2E
z^y$AvcU;u_vR=sEpZ1Jl>9#<`O^*G9>uTMIWz%rwz)NtBX%mDh2f4y~y!cZPM@3>P
zU4-A4Qjf0N^So&wls(ZfYK`oxS;zI0XseD6cb0WN+ANa!b(8F+0G@e0*JO^QsmT$*
zLyef}M}7HMP0IVuAW4H8eJIUYV8yyLuZ$FMqTM)=ov_}cItHtl?oivTFYs5;dTyJh
zT*DNjzS48Ap4}O5+!FdMLjQ?ymWcaA$G)M*BePjiCaxNglP?Ww^*+S|1Bple)5|bD
z%&1SPTeDGDVsS;c8bOdQKuWOdq}9BgLXpT?+1zqXx<{o$X_WNX>=s4=7$QG_tba6B
z;^dDN{cb+QGJe$$l(XfgEWKNSj=x`st>D$qe>!oJT4#?mk2tg5#>7Mf)T<GP)FN8z
zXJidxW_XKsK}J}@p78fdPZ-Ab>28K_lEbn)IR!bd)ezNZpI5~Xkth|c0FJwHxi!tv
z`a3l@ZfIHbbf_ffEu);b6ouc?SXgJ~%j{rQKyL|E)o2$YX?U;juJ+u4A0{!L6BtKp
zcxtDCN6MDJ=I_KT;5Et~szm+Sk&1jXcEk(G7rL^UDBAEI%(VM|`4-0&yrH10YsS4E
zrEQx0rUb9!OmUyNmObjhsw^Gc4Ej(7aPNYA+t4f4=by@1Yd_7RK$Xiix5+Nmg8E*|
zlzlSkWboMdYqd#vYAw@w=(Ggw{si_a!ZukEG15jBYgk%bq966B^?`C_CA{(HJX7Pe
zwIvep&1RN(wkt0Ytrnv8^GK*MlqE@PH{06f<5b3K%d1Q|t)b4cPu(sw+w^E5@7%Be
z>MS1JR)CiKl~*^n5YZHVgKvu_k$K`m9%Tv!!`HYPv1z{nYXSsn$0>YA_d#p-mhH`!
z;NlEh4nf#O$p+N$7w|$0Oo+?VqQOp!jUz@>JOA<)y=>=#JjGw?h`OT{y+Ruq%;xeu
zO11<lKv1j^C>d0<Tk9tmi6L@<7<6N4<!V|FARzAFODT25NDfpnKx-2vr#SHxxhmr{
zlF%9`nR;YGloN?xiuyTOL+JYR-#eNKL8V=C?KrZ&{ia+*-)A+u8|aaStOR@04Eq5l
z*aa;)5cY9zhl7Y~6AO9HD&TxT-*UUu%uxZDc2U_|K7cs8HJy0@hP%EVOWh9AkxQ$a
zap|<#g1qs2sN3qm`{hJth_<RRg{h*x6iYN%c8j-qo%}($Qdq5JI_XWh*3&7oFSIZ&
z!sutkqi|Tqa8;quP4~f|YYE_<b-g~4(R_PSdz1)%G7t0_Sar`UzBhaOAnnr?`E2ZB
zFLW9I-s=~d(|=xgD&bGIW-StPf!)3+KIs*dPLiRkx8di;Wpe8IZfq##C{ZYA?d&ke
z<+YvXneH-|JJAnj_*nJtAy{HlApgY&*GJS(>PspKslhhJu^pkxAr}!n8uKtrov(BE
z5BPa|U`o)Kb2Y+|^ECYgZP0Ulk>sfO#<I;PVNDs(*eawFVrVXc>~`?*dBYcK=Ee|U
z3nrbD`vUbZvQmA=@|*r79y&@GP&kbS*vN=Ac39z7A^}<O8DLX_4l^RS>rxzp)u|M{
zV{feum%heV|08n-DZn<&g*Sy1UQ0Wa9Y#f*keWaMkng->hyc{@DY4<z%!cRxSLr!=
zBCB0vox-l>Nu9<Vbi=5}sJTvI8`1BOkScp**r;?l6i~{w>&Xr~jB?g2c6m=!w9FRR
zCk45xAluNd&#dbVosK-ed1o{}5Az+g*NV6lIlofdLjBcP75gT4L6Le`H^I^Z<ed8I
z!ZiHBSTQ{eA9LaO(zHCaJf_;2vilJLV;k_W9-_(u9mFP#j2&GM%GpYWehC3g(GF1W
zr>6nCkl30izdSeQx3s}(2?<ZqINCo7rs$fEcnbu_*E%q;x}#Vt8&mr;{PdvkKJp#t
z)ypPTO$zPm<s4~G^bbp2hv9PzuK}_jrr#W(K|XF_Su2?Zqt-e6!kC>UqCp5&p#N-U
zQM=4Bc(H|GxJ2CeXdhdiW+v5#<9vm@i~z>4R7l^u-;nS{48{Fo^;RvRYIy0!MlfP8
z>!<6w&Np4esnWjbn$@VGA2)-tsq@nS8q=!R@D^3=KL95lLtb7GTITS8ZM*NS*scLD
zZv2(>Y_y|wJIT5aVU7X>3V0+@G%mRtT8j+wvd}LDN4nC$<3@dxsk&+p!0Odn{>PdS
zgtZj(>^P8j_XZUSLD}p>#?4cWyl2d4;w$fWBz(ACIVK#mJmf^WPUSVJv!(cGd%)OH
z_Gx%1Px1=fa1z_QX-1!MZuLob15w)wU32>m&&ITlM@yQ><eBlL^rXExj}bhvdzpl#
z_8T>a9^@JVkMQL0iBph$-d*)3J0*J`2t-Q*3U~G_n%CU%kOiR0>K(#st6I3n!ug8T
zP!&++mMv;|BtlZgc?N82v2hl(0Nv34^mUIyw2MGUD3uq;-;evU>(O(7Pu-<VT=Iv$
z!>z%?guW#zZ1_7S@%;DZnp1BsR&pau0|y3NkR_m=WkmGnkVwMXI+|Q`2``2W0n1Oo
zXPWR$A_V#~Wsgdrr#@PH+?j7$7$umv^u8fEpc?8ce87(a1{aP{pynK?HC^HYIojfU
zIn>Ywaeqy?QjW?l^vx<tf8GQTy4$=}Xlcy4Km7TWJqk7o+i+m4uh3aNRc17KrQe|S
zE#>aLzE&*k0=}Zl{?<~xrcCvi%-FU!sSv}Ew7KxMiWrJrSllX^aIxDc(nFdX@!54x
zi;Clsdu-GQss3ghpM>Zgg-s$P8eKsOF+}DYv#12}b_G+*nZKCU1wQaM2ubOZZ8Bk{
zcL4dy4by?9^RT}{V&Sml)|>~bm$#>iMx<UuQoj5<w`wA?;FZhZDiaNh`PrmMe}Ci5
zEZ{LlwzxRtjWNQ2^vgJ%?-Hutr$@6NG)}Zd2Ey0CXo;0I+TEQJI}MB->>kxGK$?%T
z>y}7XwSs;i4Tj>6=ewnX?6b{qZbduO_&9~sU{VrxMVk{qK!e)vajWA@7I4QIv%fl6
z8Q87vb>^4*B3w!&0f<19vCgXcghRsb#1ASmigYGfa$u!RA=SifL$uUMz@eE-8@KwC
z3r@Lu(}Y>hA<7c}Z5~B507#<(`RS99^m$$@D~FgT6>d)~wg~G^qhi|7QKuu07qd9!
z9!oB^<o>XAk1eV;@ML7Nfq4y;f-l<Kmdy>g8G`VdUirbe#OE{j@%(e*{VG|`RK?Uv
zhmW#=<RR#gqjq&!-NiK8c2=QMdLTJ~4n{fmj8k)6VkKI*hh6vYtaaNYq##Ex_mbx7
zLBfehtidH2;g97M&Xp1-hfUp7WC`9*4FRuW6i%5Q&$7|=;cceo!kv&UoB*BB3zRm>
zrH*ArhT$_Xn`km!$R(SZMHZRk<EP9OEYzL>6ZIvVrW)`<*?F%(RA+1cpG2)4b!=r~
z+EL+tQwlN(FS)Q>nl$s3D(lh&L!#<Zh<gtdC^ww%$S>(a;6<IbI|WOO?3_Rayyphk
zF0clnjxzA((^$P-%UjHs4TuGOx5o2Fv+2wQ2J#sd)Np5{g8gh%3*p*EgI4R#G+9S`
zw~^CcnsTHj++ms5%u6I9C<D*?*2psk+TcA7EuX~ohB0`$WS0Ozst>*vGPmH!Ee42g
z_cs<)@psyc^u$*R-5YvvTDkA%pEK+_C6Yf@$~|zk59mnGd0UxG&ZhOF&;>!YGx;g$
z)KM>bMdv-dle$+J^3Xb2tMF`x*#Q*vR&<4W>L9rZuDzqxJq;@fE3g+`jq=ik4b@I#
zSj^TS&4FuukVp$J;yFxVU(^^S7XfgVrAlG;w2iPzV<b4d((|8unt5*c{%)tew!yp~
z#|%|hD+o>5!<1kSqi0fn7=?E3Qp&P1%;k&U{_OIhuDqq}ogAlP767E6)*7{IDhzmm
z6}3CWOIJxTmW88A*PZL1$Ze`&^`<g|xOpq@ejuqOkk4G|xIvRLU+Gu)U3w6-cUe?D
z6MGN5MHep4Ji+>^mEQ>+yJ_P2Sbd1q==HR7nfI3*$M%Jt`&%GZQY*zH=KF@&cL1<p
zDItI@VAEnmlh@v1>-zhcK;T2EW<t2QL+>LNhN;;%LuYs4FBiwXn4<U#FAYF3n7%{`
zWP#A{yJ43$oJCw+Xz1TVfbnuv-e>So%9=pf)@uy(kfk4`7?ZAe6XJ|zh&?$#RdKX~
z%>R(gW8&#%%?wPf<F{$uGsSo0DdCe9P~hx7%vaYwLq@-d6=Lfr2_{5zGDC0i3$%xF
zQSPdLej22J>DPL8;3G2)ijIJ=TXe@+9>HKGGeQv3m_IPc1UMiebQK$+=+)$pGy7jl
zKT)peu5qtr+~e|OPfFs{Ac0(+rBQQd^CwXLy$Uf~i07ZU2rL9~tOA-;_X+d8fO9%c
zO&hAsqTpTac2L*Q(|qNECS2K1Py)VmM^wWh`N!pQsdEeRCbKtpNP#~3<|qxFBaLFp
zf`$F%y%HPK8x?&R>#?<BjGw~78g~^#BTgVW5QIe-6nHKA*lZM|MnG9cQm0;1`s)Sx
zJ#leiJk&XGQh?$G188t{GAh-Ga$hG@V_;gAKBgMM9CGxu0(24<Ry~(29}G9S6Ahq4
zy<&gmcL0#IG(;eNnxtVP32<~=)2c2__$qAN*EarG7h+@|I2_J0MtHS7z4N;U7W4t9
zt~Mwn?IONihLnM)m3BP1mja^)jOO#Jn;(HLImp#tqKSZdGjRe4Fy_^@GEOkYu={a3
zLq0H!4cJVCuzHtC$xM2N-D@Q41*Cq-+ITEp8J9_Liiv81M>_Vi*3x?7j3~uuoSW!*
zzng2gbA_-5V-K!OusRCxx{G63#%#b`^i!rVPIY(<a}9#8fL(usd9exb503}WFf{zP
z=3`WyiP80+2?bcT2<WzzRuDE04Zi-=Jj`D8ze5F%%<o#Xb<+<qvFFY$aAj}0f8JQx
zw^j=kzcEH+07B-Y9hm=SPVI26h?F}F+Ynk<do}ANMi4k=)ICR;zln}~q<5j|)mJGz
zG`KG+s-&yDi5Sw*tf)K1OX4m<f3+YEsd)N?*~xkRWHHkd97X=0T@*)-oJDwErEW)Q
zEYK@>J4_2^g^>Hg04fnr4cqK{PB<GC5@?+XSCfNVm)zt2x>8K5&K75kZ2zUiTxtPq
zII|PY$LcnM0Iv++kXsRxB6~90W;#KLcR6r#QWW92^XU|Px6TQTY4iqmgr@e5yfyMp
zL}jfR8~VS(^#M$5REmY}vp$pl>T{?r5m&`09av|Q?_Vx;Feq#9n7k=7t2(==7f(29
zPjHGJxmEkqCK#l>z!Jl6TsZ(=O5}0CO0D)%%pr^GI<=NjnuIa%y82reP)1t|PdBsh
zgq$SI6?=u++rkwhL-swmFzqf3P-3EPJiuy8;4IIY;!#bu4|3zZ7kGW)A9!=!fXp{b
zjUHnkZ_s|zISK7d_)145$&!tta@$UY19KybffOd-cS(shef~V6%A1IxIcM6+MdJNG
zGewefRh<&Iq}g9*RN|!d>>kuhaU<lJSl!dXs;`-`i8#<36)ZVsNu~f9+c9%x;b-9$
z!%?VRF;M;puqAysRY4;R<|ys7=DoDoV%zJrj6ziKECj=Eha(u%K3!2(js)CteO*td
z_i26&ju@AqI#QY-d5r}@GLaNaq*I6F!$*ArmWhpM`HZ^e47fAfrbiND^b~Sh0F86E
zU4sB4nJzAxndM2RFWlfH*{56K1>)rTf~c&3blWdZoASfhjNZmO(rJGtfU%L7THU>_
zIwKPV1u<>l)2H7;nQZ7cp(f}^mE;$TMyA~&Y`!dzUXIKleJ$EG+AzGt(_gRvO~DhO
z@PB<s6iGA<M0WMHR_jJfy$Izx^TXBe<iCoceW|B1Ei+}U&?Z!!xC?JWc$;VY^pT+<
zRzExS;pD53pRCFk8-*#jwe(4Z_Fmm2om}9cb%8>pz0#=#ifD~}u-(H>hPV#>w{~29
z2$JRfNj_}<xawf*e!@0w;1Bx3Oc~WcN#|s{U?j5LP=w;9VU(;*4?gf~ILNVCeQ8C^
z09yw_*vB%$TN!OtY^;6t*Er2~a_Z9HT***0Oer*drI?+nt~8E@e}yQB9Q3KZDPlg-
z7BK)5ng{2?s&`75zrj8se2V1gjA_6a0o-r!U3oaE$oV!Sn5^(Y<B2(ARgvyZhy=Ek
zeVAhX!JHZl1t{f{u>0q6fIVZt!6j>rGz-2oBe}c-x6hd^=9(Hh?-krfaV*1JJ^}lZ
z7qm9cA=-(;!VThBJlhLb67b$UpQDSg_9{(c>FyLbQnz?2gW!yZG6F!BB%7CZ5_-zq
z){2)N!TIrK4{C5>*U#K15$<d%E>w4mRNaEWi|<;RoTKWK=O88`dQ$(tIGV^=C&kna
zz<fbC(Dmr?3J(<emW1{wIAwjvO<>ccYmi%wIVXa|7GUqmbqaW*|B^&Yq^N|5pb<mg
z<tL6+YXw@v(wQZG{fyM@prJ_{(nbUGU4#gN5g-v0%*6XaGh?9RcmXybJ89-XUnkrn
zkiJp&0ER$}OnjIA-?lY|Qmrh8O;+MQ1=Ru=wQ9g}B$eXvoh4w?tMwea-0#E-#sBtk
z8Wl>~wmOvn+fwC+yH!1EODT13^se+c%c-{~S3GdM(N1dUlZ$<VZ&XV;mi+c9=aV?)
z`x@->!|%7Ne65*AIjN)imQVPv3rU;RSC0paBZ(tF-VR`-PESd9aAR5I&xO~Jp>NN1
zItIrs!^b)_T-78*0bD{shVYVtVkB$J(u1S`)1WR47aq0!`4e}iahY6L`EzNKE(){-
zd5K>X?4|E}8>!y^o}3DDJ{9ptR$gz2ZG$Le5Ah5lB1RP!gC;Q_`Q?RXQx?|;m~E6*
zV!nC~{f11(Rwt}aj2E9v1EJC`kMKqBI#)6AW%r-nBsB+eqnUaBA5{BTO|<&M+2eYN
zduYwG>Txt_mQ~6DdRDyLP(E3z&_ZmD%-ul168kYlYpB@z0-rj%jue?iqSbDnYrv~M
z|9DnU2n!lt<3!II%g-5<n!<%uxP9-HSJ`%@${{<NRm}M*$oOs&SiBcUcG<>tGIk3d
zpun4`w76Rp+xXf<U84<dyek0yNIgSiWV;!Dbs<q*#?ty35q+jHPz5=wV=+5$x|x2b
zOo)GR%6L1%8#qO<s_gD!ka<QoV~MKed@WL=Nl-9T@|%tFm=8Q#w*aS(AM^~f)A08e
zQP^?huwvw^Bumo=dXyXMheBb0LX+fKR<}!JO2JN8DZSSO({47C!(WbZqQ$+f4xM=S
z2YmA&Li+ut`UD9-klbqk&L(bTUAp_Z_%o|^R#VRn(7DI1SW|n@CS*M_Ho!v2y}0j7
zh4`<x5Rbw|Q|@J~LR-F%2aA!!Atu9+_@weN=l}}SEGa}_%Qd71zUO=&&;dpFa@+hw
zqVdKxz21ZtTU$vsQo@V}PG03hT&ZZ1tvUZYMc4e)mDy;f@wU)$N@;57r;ZUZZ0+SA
zyD0lys`9lO;&Dt|Su!iE3D>ukaDDzVDWg<6=z;T2w;sr7YZk1+RHmG!=Tb1-F#noY
z8C>@PU_kD8k5XdBw98}!G0`BEIK{8Ra74A|*h0~Kln(wJE^Y}bE9z<`o!a1ZYX>aC
zw6T~-OTRHu7`CP_47y6?H=eDqGL0f9_!*@plekJRr%yZzenQ^gK|$1RG^A26{UH<G
z&nYo7hj&ib#KGA(ElcNylLqM+{d*DJgyZBjK}$4|t^%|qs)R*&M&Iv$*Ws}b&U;>X
z7qYxPsq~fu^=;0FZ-(uBxtPfT3H`%Ww#Sy4R0Kw1AG;6XvEcBUsSFiBZwD1}SZ}u_
zbJicUrzQRG-hhH=+zp-a@7l6{Yh%or0?`1K@j18a36)s>8u>2l-M@leG`cr#wmbW)
z4?%!jc*5#u#~t-y4q?yoyB;Cq#pZi9saBCp9zk|5*llt(PTb*}O)L^$GUm^>`SUYh
zxLOnOrjAT#SWfils~SE&AstP-jyaZSttj%4gY_<wWlfXTXFhmrQ#?1!A?F?M46N|R
z9?(@dCCivhb2Tra95Ac@U85#^UImRhhJ3{`3Ed?_dE)Zd5^W=u<VrF7aAVx)>E#%5
z-21-WQgvAOyE#xz=YN+%hQK`7I1(<~nz{j{4pCPMX;)kOgF{Nel87M@`Hk9Qxtg55
z?yJiFv_rhWx+*}#ii^GDd8AzL4z^g4gQje>WXOT*9g2;qsyT}HUEeq(jiOFi2#gr5
z5ryO}FN_aRxQ*M!62~!{=}(!lxl532!9+oFT3xO7EjYTTkpu6SERpy^?4|YoyiHcV
zGSmE&p9?}teJSrZYD|*)G2Usq^)=78e_p`w0v62b3m1xgm3$T|bt)=(g7UCUMtEKZ
zb8FXdY*AH+O{MJ?oZ~R8b1q&A+4l~I(&pbxW_tREiu-PA39sZpKe^Zj_Li@3z8wG7
zj*e|7rKq}DRiB611%6Js6nWE!Es>O(CzWM96;nAbQ%4lMu<_!_l{#N`dmL=f&d^A`
zo^Bq1%VN>h>QZjpnjOW{Jj{5{pIj-vA-4T+H_l@BHRy}&P6nb$n4?;w^a@e2B(VCS
zf^qpNHd#}k!bhU&giwRIY1hnqwD=KR!iBJr;C)ybKCU0kCiIP#0p@TVnwl!u=eSj4
zVBE<{cXhX6v%5~8Y3<kfF~#c?B3=wAbe^MI5+9T_l27c+1Cw-uvJfnqfUD=#N>3ix
zF;Z}6tI0@nWWO_;H;Jz6+UQsAW>_wvD{o0$#R1W&)ro8)tyi)<r~{9eux=w%hx;~l
z3VY`!<kK60Gx@OMu8lGk<>~;0Th4qExLbb2d@FQ7niW*E=3+YlPzc4*W<YMS`b~Xx
z8)jA9hB=HJY|kK>BZn;>Qd5Le;1^_OvQ#h8YBl)o#Irm+F&e!Q;s7I?%QLoZbanjp
z@ldqlvL$i7pQ>aoZEvq^KS0c&wKxTGT;Y7pVu}_()oW~%cglohjRm*GyD5jO3adhb
z94RQP$Nm|6Q}d#|@5Z6U&vg3=)y>swPH$u{DHm>MwspS^i;A~{`*4$McDFK#m5P$y
znOVfnVA9*Mj8#L;2<3)ozR<5kTVeON&dcp)F)}B{ILY715T+O4B-m$ayyZ&q@6})B
z6K~1+mtg{KSo#@SGlgcdR#+t0aEjRNGYW!%n<bT?F$fL0U<2~#ODl;&$7L7=gy7{S
zANT^pcP-LSsev^6{@qIX+^<t3GL3v9O{z?QY5FdsO@+!D>IdDl)%RIh>>zYTz5;~*
zL~*zbM8h?GK(S*Wvah7X!&sm*A4YJ2sGqxY-ZOY(EdhKXKm4J<tDtKnES%Yl8V`NS
z0w}x@rFG%>JIp-Z353P{u)fXA;gNC~A2UEnBcg;Nu6xwAbI-nkn92Ad=)K8-MW0nV
zSAGM!WVv+im6%;DEROZ<-1T3*n8s&|Zj8KP4qeMTwKl#y#t7Vym;N!|@vWh%Rv8zH
zC5c}QQxLeVjkS|5#*4(MxwNU#&<q=kHsx{mmWnAe{imNDp4h$eKJ|Pw31(&IZhnyw
zb9Bi{$u9gW65F5XUGKONr&oPpmE0iYvE}mi=3_qegI2?NwG+9|i4bWEUlK2sRzAoH
z%j$JGM!j{T4Q|8Z0|X#^O%yVArVbQyIeX})VwAHVJ6lC1S)q;a`e@?=OMjSbR9*-T
zodu0PMj<KXY7?{$!f<w#foZD<Q_qnUGv+D0eA{}mxVIMWlmjg+9DiJgmTnE338V;)
z3t?IR8q5Hf6|=?hXL<i?$-gVzP4DaW_6?)`8$U>`r7~H5r?aBJwxlIvR1hhQy{;$w
zA7;!w`(sMr@#{O^c-$$?Rpu&UntyfA%$ct?u6r&bk}*>qIUS#VF%jwafn}6V4^uc}
z*GO+2cV15KF{nS^(&KaYQEq@r2<X4?dTgG?Vnxh)&t#hWT>&~e&lHl*mg9-`6Nq;P
z2bBhnhIq2lBwBmIg_QB9?%Z~a?r=3oe7R%CUmt@|omOOZ+*kXsE6do<%#m1}9$NnI
zctKjQoXq#{S3A5Z%*v7(;I<YFhTL%Q&K@L^U4TeXCx;A%W&l%J8`cq0kA#Zt?w#7D
z9^078R<S`N{_{~o=y?^B#~3$?5v&U5U!fz+7KTu&X$;?Lz?Wg5tx<-lwjTYksNz&G
zmoa|WWsOzmYT0_&((<WnUW2mG3zfYN@;(aOTczSE!gsrYVb1jl$li2sRQ@Ko${tRm
zfCHlUeb@BUA`MZvGhAaBy_Yx^Dzx>LVTzK(B~n**^j|-$Y2^>k1_@|>)sJDaLx8A%
z$|KQP=%O1~uRimF0>$ket)z-xA+BHMh}BZ9I6J?lWpJ^CZ`Z2p>f{x&6dUAo0{<wm
zdO>XCeegdNe;ukyAr#tHH5#5SH>UlNYDFO?*N+dL0-&&v^k}-&TS(siVP?RHcj%g=
zYxPlrgRyL{d`8!eHJ3EoQ-!z?&a-&^5(-SrO#jgIwPJ<s^t|;!JJ6*0b*d87i?Q?E
z>*0`J(VOW7|6|fkYpDKse1%nFGe@oTP?Jd3NO~{bUim~j!xsWADX4iVuYQxP^9CD3
z1VFviw(r|_{htuL9uG$t3;#XkPA{?~qaM1bDhvj9{03HbIUk~Wc?^N!6*-6resc%(
zbz@9_Of==lQ~C_|X9y*nI*fvs21y0Pzx}4*b7>bS4XIQi)k%?^nPWRnOOhagBO98_
zeC)+O*d=hw^{jcwSxrmnMaI{!UtoUiZ*G(z*3A)W4_+s_C{}ql>^jubP!5jqeH)|<
zjp`(fQusaB(vN)^RQr1et{xhmYLGp`y8m4sGyHx@1mV%QDFNAk#RzU{7}{_S@8ILj
zvf0`Bc~uu&{_ogD^?Rp2nR=wrF?WpwBf>S=BwPAe?zhnud%1+SQU(S{ATmOPdQ}C}
zHeJ8>HNA<w2x^NW9(0iiSXK&2=;nG}$W4Xto?S=6c-bc$RbDj1uRGNGWS$2QRj0Hn
zYP=NFadYT~L=HGT&BCNrm(UxDeyzvmj$Q0h4F|s1bLe}=3tAONNY9E)_Aus{xSeqb
z9F<4llN=MmPn2`{4*xF=ysY6pPS=I(p;RRi{z7c{<S&<CYDEDaG{D!7(7qA8rW5QH
z<9)hHvy*p~V#GJ27++@yYpb5wo%%%vTD@fqVX4L{#U;6gS$bDxo|L|+$2~X2TrC2(
ztTw;bH!Kqm@3FsShN*xij>H*pM@=VjKA*Zz*$LDyAdyvOaC294!*9q;ktIhH9(Ir|
zKUWD53Sts~NmCX*1Kp}Zq$32+qs2Fdn#=4!@jM))l_4@7A~;7Rv_QKjc5-`e)+X~6
zIshi`P)hcUhD@gJ!fo4clLJot{u0K)3HSJA^8V4&Km%SDhU0nyOsk-Q^dWmT!BDAL
zP%bWfn|w_Z9D(Q%Uizali1Fv_0LskVo^7Ux_Ae6zWo2l5U<9GI(XX%-+yWQjZ=~Ev
z2wcp!t%uvV+|>l9yVyCMp?_=bs)o{52|0nh%_jDg;LB%m75Ik-4;H@rH8C0@<*|2h
zirLJ1%NuQsFtHv5c|E?O|2sg*?RVN|ssE*(KX=Gdr#foFXpWqVzF8P-&0g4QzBWFY
zpfPWGn~muW6Wxc<n~hmaqWeJi2Jvdlv{X^d`F-jmU2(8_ZHS|r+e0gW;xp^@6<sSL
zA<WxTTnv|C&@KaLzc5ELK=vb{YTGIOxmAv*p!Hs|((Ln<efyQwnk5Ljt%vHd9I$eZ
zR^UqRXsG=By|}U*;Q1#mvdODn+*UtGc=xv@o=6F@5v>Tn;5TS9hpH5GGYYV!F@0dc
zv~d3cZ7)o4iV;KWPR&A+25p?k^+gXhfo$e`nNv=aU5VBkt~#%5r77*U^@%h%m<&ub
z1ca&0h4EfB6GGBifF&FGuPkLRAKXB(D&G^2Uj)h6p=Ad$mKXHM@Ywh1-m;MV0{f0p
zEe>E|g?-IQ9_Xi>Z7=aZvCd_adkODG9&TpdUkcLiV7A?Gh?FP3e?|odE4BP+4v2vz
z_>bNz;5!ZKan`ecMy>oV{LTC7z0H{{<C42yU9Q>*@&Kq1-QHbPJZJ@d7G?xK=5iF^
zpoUWn>z2CwMHev-rMJc0t3V`=E%I=STm)zSj}v;+YQi;p0B4k?3qwuyv@$ND;2$DD
zU=g-a{&^o7Fo3d<d_tqfj$8)GUn&dfaTt)-lezy(Xiquz2Eg#{3Q!ZTv3%gmSqYLB
zh{$5wG%w<x7TVi$25Z&`B|gWa6rwYDBq{kuA#Y21FoFhv8cC(G^&?)CEyHjm{WV9S
zKf`=SkC``H*@84G#rxnBG)=+oY70q+kvjR#fb7^}s?TIm-ICD4S!1~ojKb5J-U?;w
zh^K@%K98yacFUV1Ph@fg*~~E}Oej#pxXqE0lTYX;^gb&i@k0rgj%6I~?%pWXLx-Yr
zbp#bU!tJUgqS2|wZo($DNwCEJ2Z<Ep`YpF>0(JQ!cm9H9p9~$Ji~INqwH9QGkAl8&
z0<tzo*e&6!eo%{JBPY*#zV)>ItW3<5Vg&O#81O~B^yj6_Jn9zn-au>ZgFc_s#wTB4
zk|9uiS6kC~TUwb*y7c1x>G8E0?HlDPEAXCsUZq?suCkkXS9I|9w@(W*n^Bk$in3mn
zUAi-)_+2IHZY2?0av!tHQ6Nszj>$D8w{!!VRkdfk8gQbr$tD^Tgo=g_9`Sct;mKXw
zU-Qm`y&DSQeQc6YgH|S4DZtsOoVVq=KTY-adUdN4vnqLNT!(V61(PA@s(1|>3~KSg
z-m6h=R__mQ0EEyVw#;ZTzIQq&&Bob0)o9OWtIe}GXaOecI2NBhi%kLciCH{oc5@-i
z(w$<L^<P?f51jv6Xlw~4tLUS(YQv;avcLIO$FgJZUfuKm!#ohBM|(=fMu2z5`=r?z
zypSG$C8ZFdzZ6{8jZV$K{a9@>hU&l_4bfb7tvKf7Xuow5&n5gpQwha3-%8+IMND^g
z5;SS+Aco*aAn*O#j#`EE(n97eUHwd|TqojV+XvW2<@Md_Hivr?)%f%U-L9~oOJ-wr
z$M<2&ab29TNfFUM1yTYXzRx1rOhWG(2Q3;vh2h)r17t8q>}?f-3Lw#&o?g_F5GV#z
zA4GC>_ylHG7MMv1jlZlR4#<7FM(yxBV_+C{Vky6~*jUo_-vd)qD`kAe4yD})g}(sf
z2@ez$|I2MWqAML;3OO|j!+es`K+_?paoW|K8@~X^FMV+f;x9btYAjhr>kYl&GdO@p
z-ghu@=VuBLv1u>A5jW(FuG(|1P!Ehts^Ziy7zw{8ONAsRr9wwcebOb8m&*?{+3$6f
zVP%Vl>&$-F_7RSSAT99u2k#V&p5Hu;d0l_f_z;xqiiHJ$7oEA!SA-JF;Ifn24wV!I
zN08CW>>Fa;15qIDTA`o3anY#flqtcR{P<aW$<4R|BZv?9lUMB349b10Gjs;u6|Qk`
zf=*-49x?$~qD3O!SmB1R0$C#?=?LMtAFXVkn|#&lQMbW{HAi^UYh7o#N*Gc<UJCnK
z#Gg0hy=~vZa^g+Yn&dTNt}(IGlxBlzFd<F$W9DEAht|O}^Ddod8UiBHA~4lU()!J4
zH3zbWCemwomZo$pDow2_F`J_WEB4kIcv~?2TM3LoFZh%Sc`0}l-JDum1r?}4GpxTh
z2C24km$LnW{m`e_Kf<YMWLZQCU#xeySjFsUfN?CPAfTo*1EYwP0#cL58Ex<Nwuhm~
zvfMPgt-^rlvXqN>KoPrg>wUA7(9okUb^Ft|L*siOfs17k#W@B%>v=1lA9>l}tobK(
zR06Q&#fVB|-(5M&^WUwWb95^K)Z#E$8Q)UWvw_{we)n`n8wqyVmGsw&&hoV>I3Y40
z;isnRT^O0Nqgj-fXOCOXVK0$U>RWjy$RU&jXpGnRGK6~@+<88i2_4zkBCD-@vu9B6
zzuf|H3vOJnm~ga8``-Y(<@}22gQm|>>=6w9C;V$Kz9<HW2261?JmXoH{0xtcRWlWk
zWg|rp>Xbn+ENGo5Zu7uDKZ%Ed9^|B-!Lgz~9{%C?%8>06>rSl@2Zc)FGH4LV082o$
zzg*s$JgvTF5Y!5jn7>Xe7(22JISOfHz;1QQ&tYvlWD%4jV%5FutcSi4Ga+ems0E>3
z4NL^Oskyr`%_?rL2fRf@-gUxquaq8K7ru<~e`psUT})532vUkNbQW|_ustsAxp^K}
zVMS<LXU`u9h~q`3DZbFek{+Ing6T7-fXlJnR(Mf>DBdHiFZ{UUr5xQ6f)~Hr{PorH
zK9i6rY^LUwT}xfhOmK%Wt*Yx8+Zh~e5ZiXNI|YNr@SEIrpdx?5_@En-@hfFR0Vk0i
zJ|{G$np>bipy>%cCKC192UsXHaKrc>zvKqS@#6?Jd)HtD(Xc?$;aC3$BJ6?744f>i
zZP@qhI4dWi>K;_Ui-Z7)2GFkUTFxTj4N0Q#EPqTaFW;Iu(yhb{_`eD8!=F}j)7ER_
zf2vRq3Q3;Y0g3%3z`<wbj_2Dj!xKk11c`InSY%1qJW;(mIwO{*3<Tn<&jVXuhQxaL
z)&_=&#+m}GyWJZelZs@#6t*>=!>4oiJPaj8nT>Q^Onf(OdIofy4hFy1YbDi~Xl`mM
zR_^NS!}!W{h&_H}OO%BIYR<S`duyL(2-lXkAi!1P*epCtZTB$0W&Gk}9M9F5@O~wq
zw?K$f1qM}}xG&n|yGg9<O-J_|yuT2}<z4I&HG(Lt6iubMRtIV^JpB_FIfpOV1iEwN
znYW0AT0qHmN0Esr)4O%vz+nP0>EVr}_tvf4Dm`7i_mI)K67Ya#vIxCaY{t*%2vQyN
zVd?pOEuRu${W&x&mB4roWgYt1^twTOmwvYlFPmk;3n76s_NTThi|fbLHq9W={wC9Y
z?NoN>7Pes?enUsXTJr7(g?Xkhe&Yq0CZ&aj<K^2E7o3Cg(I$C?8=bf8=aUo}E>h7$
zNzO<-q1RcD%!lq`W=7)Hm(-lJBi2CVAmai}2aaIbzQrM!6&09#1qF_cCD4(<yuaK0
zL{wu|K#rdsEUdK^TFh-_Hx4pRGsC~LH(RHg#CTJ1u=Cc)*=K-=NYUgCcfH*|kW&c|
zn|453cgC9;U2~f%?{lwS2Ml;|6W`8$&bZ@+htc<g>oz}pB0o%D(?=4Rqoa!V%~JGg
z^y+QvVJ2r_@zpl;!z=f_S1p^b3O3WtatI|e$tT}y^Eo#V#V9wZYyfMcT}EuZbnkg2
z;lR?+%zU&+D0YR(^b#W=q&@YeFtfS8#m`GaGgKm=H=5lQHNhv-%(z3dI2NaC1{D<_
z%PaSTO~a0yxiqPbwlo+I0;STBBlr&V4G<!QFQHe{8wF=V+T7A=z7$3&Ld)sS&cyBT
z2;pLwz<bTj(!B|EPLypit&Yc}vl&xYu~l_8XYqJGO3}KX1rw1uOun%>--~2HX}1;`
zin1f;F(wLLajrv;cSFYXU(T6aI4*kv_Cg*JgQl`CV)%>5m`U`Q3pjGcBE6w^FI;xI
zVsnzhMgedj>>X6qE69Zl_U6SUTR{(cdlOm3J3owRW|7{+vTS+qkRZP!sinfi@c+7c
zH3VZU+XI|}Q*p78!<`n?9?I*b1^)(AIo)_)XFsv<RpW0+>eT9HRpy{c5#~B};T4l6
zr#j)S2F}#!xdXo=hoe=O4~aJ$D1ZR~cUUUYZk+Z*=sUbLl`+DIGTqZS^_$A@t6J|R
zT3)#bQYdoC7X{MMAxM_M2#@B_fr5;lIxT`H)Sxis?4wY6Wr~o}S4mrqO&A%aWyh=^
z1!1B}3-hf5R7e%m$!lrG-SIcGJ?Ak<ih}b_*h_dIf)hhsIo?-l1B6y*SUYIDT4VC9
ziwo$WT?@Mf2=QE-lU{8KQ@wbYON51Bi$dRQhM^(%VD~CETT^kZR9Lhg;_NakMi6~d
zWq*S#@$S4AQ@(QWj4B(~*mLbIn%fWH;e<oXM2fzuAWZa8ufnyWDI-{&?INqY8~gwr
znyu(UncrLE{57s1WFd8CI0uy|0xIaj_bw%^Dak>4ZR;&mHwi9F5?p3+hU^>=j5S$u
zC}hbq%i9O~Q9yv98X)o|>oAVfQl=wAkTg(4_|vXml&oIU@qMt>_7Bvy4N)i2*q34o
zy7$?}X&~ol9X#v>;!%7gdBNf~wIqk+HW*_&Fh@LP`uQA4L>~Y79=1`eXLuaY(8PO(
zC<M#(o3`y=1=QFzogj?Ux5S*34tri4^O59ptS--)VOR4=;)$UFo%lO+u`qwbFQpX?
zjF9Mk)m#cTSUeu~cRrcmv6I;aGpE`YWp+JpmQkosry<cA1edIRqjEKfaY9MFz|sn0
zk=W=Kg1{%ds4P4j{hn@hkjsK4Z}-;cDM+=%dxP`I3M6eopQUN@#O%IBy2jBKK%88)
z%CG@#p+$Sji(m)FpoHL?B>WA3bVG#Nq>x@&`j){Wi@bM;$4)hNSza0=J?ju!2`l<f
zyD-`TJx?|7mf_=>arzP6d7ndcOC%uQ)Iuy1$w8%-A;R(wMIpS&AzuP%Po$v~KT#~w
zV*2w&!!$*|!G=QMtPjAm!;|riJ9z~>iW?;1DJq#TUlgw^kz=y&3*ehsX`IXRH%y;6
zX?Ih4DFutueW{!sZCc&$?RXZE!tOr08Ju{RsHLQ`sa|=s|9)#gDyz?V>!vsP4CL8n
z?w@<A=Kp(YzTnHsg@NQe9SS?SdU#9%#~UB7e3n7Vmsn*O$dx%8TnjduGAu3=@E>^$
zw`gg-@WYKFQU}Bz{+zp~XU0T`#$(&~6blM4lumJkCmc|Zdm|Szy8#LYgQs)YnxSFd
zU={TQio$!k?sdh^6gp6D+qah&um&xelaYlAh+Zin0Ru$!o@k**@VI%cm8lPbg4slU
z(fzHYsjpBMVUJ4dbvcaiu$nHMu5^ykZ+qmN!vz-w)ws%KLH(|Pc9!BQw<8?17Ql%e
z8#sV)hD1+QM(CHk+a=mwEsVU!OmXkx$5h84Vb~zB2q204orQ=Uiz#BoHP{8YCXHsR
z*MO*0DJq@9b0t0Xf!;J9+j}V|%yZ5dU*iRWEibHv^0Ua59W{fd*$HUq96yO(8CzK|
z;W2dn+?zQ@!&V9U7Qj~soeAta-wm>O=%fihyQ}Co*kS~~M0Y-vxMl4nPb^@kwkWvf
zOuvgHWhsefk80!%4TvgM1DxeZ|GU^)s2?<fnC4105L0kk2j~H3A}Vb|&~b4H8ffD5
zgKMk@L+!^ya2gdM7KA=C!!KZ$E9TyV{=oGP!G{P6hWxy3E3=x3#?Gem2=sNFcJ|Iq
z9rNH0lQUznqe&)jEP2Ib<+p^Ij=ywhe(*OAUKe;AbR%T34*PQ|e^Ma~7KY==IdAk_
zB3w_Fto9(hXwc5waPp)ZI<rmBGIaQFPWimSww?FO<YDtdqF(x)IJh3Fb~9`Se2Gxt
zFC>SnpYcF!o~+p(w5mo*&PxMG#2XJR)5ueLQMRpVtlg;rdHZIsgmGt)?r7b_Tka~)
z#)t;DckJGt*k_4|RE)p1%5a`N#8pQ$wVPD}j?7X7C<I7MZYsNOU<m3d{a0wG!c3>n
zLGjlrL0Ct=Bjk#e1#Q$6YY47T5FfuBKLrD_|56Hwr_FCZ+`2%eps*Mq^(S30+s=pH
z<gxR%YfJDX)&&&SI{}z%pZb@_4Yc;y`z9PsN`eLp2LbWM^mqY}9}3s;fh4N`Ues$B
zAZ{3LEdQHdBgoIZa$$q~n$>wuaoiZfVY@2iu!6gfZ;)&QqstnmAtxlO;l_eR5Bv}a
z1m*)j6l4A{{7Zt0-*$_vj~>OZMAv=6-R{L%gsS-4fO4{IBV!w9u3`_^-J}COmGgIu
z!fnMkvI4>k5ZDf++WyMPLi=6sZOXz5>QZf(T_)2o!!3%^1PiU<TjUzvq@Ml*xrw3x
zr$+&JhC?0tc?^xZ`PxBk_8dC$nY{^ylEq_5)oM;>`G#<&m{lQ!C<aeQA0kHVU;+-O
z0`hvy9|Rn3ZebvFWyVY|ZMS29Z8Y+rzN0MyL|6@7ff2U|^lM>rgl~Ls$!R;y&)QGO
z-NfG!5Wimh30=?{D3M_9!vFCSBMWJ))R}5vM(Xg?AMKlO(B75p%LWSuOgMaLJN42T
zJzFAs!qdIo?z;^)Ukx0pAz?S5ky><zcuLZ~fZJoM74IyL(qSj0@GhvS=+v0&=#vI^
z#;h`zOtHXqbykey9C_5FsAiW4)(#>g*fx15n9D;FbiW5Djt7eZa1cl~Hx4lSV&Mx8
zyt{&d`xT-mi^4+-)72n;tLS##SEjltCKYXI*slL1BVs;Z2p&gc5_!3`EDB<*e=iPI
zny~A)B9tStR0UTX8c~T5s_-T+9|{yQw6${n*k35vnRt}ai_ZkCwofV|KMByc8$^!a
ztq2iibghMeCS%5a9fV4=y#ap+!YWhN%F|-5w76}rdwXX1Mxzj$+e2fWXl!3{H>O!o
z*o^a4*kCwHv*u{xyo!L&uo%}M__+YboPc6mSrmPc_wdjuUws;F_Z6{qmzg_4J(pf&
zzl~N1^8v!ijOx*b?ZQA!U@KfYBSt|h6gh^m%CK>5>PlNk;^}10C;q@N{L;_i>g8wp
zjdYF3X+K1T5@fN@C^#_Kl$F9`aC`~4+kYi%cyH|+w>~E3nYD&Rc6l(zle9M~?8Ks_
z2ZOqDW7v)Dez$69xrUq69YQm`EpC%_jaF<xy|~DFzEZCEq>RCV53)TT6`F&(W%aVh
z7k?p=gP50s*ZU;~fq~tFkHC+F)1U{Q7~H5!ov04o*R5_bM57P8p|_MA^<0Y~8X&&~
z9@#p%;T+b|n;26opjC(k>PE(p(wEaGgIkqHf3|F)J*l3YsI@RTqmz&}@ap_7AHtt#
z3AeBGhx%Q^XFbcXF9Chlb6f!@Q=H*}d(GOK%xC<7d?oFnH;-@<@-LuF{t`Prwz968
z8{+8O_SplA!JuwE)&qrk<1NMe)8Z`e;-L1<y-o~Yc*#!PG5A61;V19C%Ua%g3h+?J
z-+?K`q?#THShK-R2;^lYiKR`Q{EwIXLX1QkZ@1d0J6cG({6!&t%mJ|ktcS>g(joe#
zJxVY%Co6mvnIv-Rb`+r>Uuo+zX;AHfZw%J64d`Y@yuUFeUMY@zUoo_CQK@Fv@JSr`
zErwuUyY`aqw37)TKcwx32%y};cwVb8tPUzQk&LqC@>QVJ*{!}ygS<Yl;cssnz+Yz*
z+7J4<qh%T3Yt!4U%;T2l1f$eP{>fk&-+wg`V8_~^rhs^Xxndac7dNV9R1%bg{E-5+
zRg`CuC$B`PqD~3Fh}{l0E>T=5(xvKzi9cn-F{~x`e1^PDGT1IgJUQ5E!wLPZBLOv*
zOft}e>xhBr?HC<j8MoA;ElRpDW_7;hViu2}gxaxyg!*n;*+tb&6Ne(snCwsa6%bp*
z5IrWSut+>SUb#XHVH2^_&^hNcKRP_DJPw*bV_t+|Kv!rhh|4y|8E{A?FbX}@(Udnf
zR`F#TVbO!i@*oNTP7JCe<%ZH~qVs$P?l?*5AUUteu_h0JtB2;|eW(lP_avl=Oy6AO
zM<}41<md*``M_h#9A1v%bpC7kc#cS=lwdYi4mviQ<l6I~W<LM#&Sc%BzSOpV1hSbP
zFyP%{za&Dx-z$Q9!O@PN5g1Q@g3*$*JX`>}Q-Rp)F$ZOC*C7ronh-3<GJf>!K8qLX
z{eA?n%>_5#KH&=VQyAa9$|VDTLs;z*>@$G&B2>Q|P8DQtYt5B*dS(LIYx7a~EcV|s
z{y7SfTByW}#n1>LswFEAYDevZb75c0*B$ZoP69f_79RH#5Iq}X_dK#$(H=03G1)TX
zLw@IwPp79RR{dUt=Fd6V9|kKJusc6m&R9S0J=NA{JkKs|{AZC2dlZTXf;G`ogIio!
zbBS+l?_}-+mROkzR_s?go4GjR?GSM1Dohz)$Wd9fT8dTBJ!<JwXZ1u_H{Kx&Qin>m
zh{Oq{@exDx#e!r&@T9SH*pA_t<}jGB@l4F;stk%}?F;(X5r!TmpY^l2-vOf8kWAH-
zS)a+4p1TGE2;I*oFu{fWnofcpn#S($V{7`&XfpMn25kQh4R!+;G86J0AwSJC@^q8B
zx#|s{!tcVJg#!Tk$*%v1<x47h=kb&b)KkqkrPw!X{`+WZ>A$HL?P^A-$=YT#-%9_u
z(34@iZ%>lMeS^jK+%yf`<1CQe7!(?f$AM|HXJxc+>GV;ErD=bCI2|O02{WZBT(2zC
zRvI0c-9tV_O*5Ti@lRnDZZ*%Vq7CueSNV!SJ&AH+q;4qgdJZq$_^Q|Qf?7`_rlg|#
zdaJ2x!>&y@5Z6qp=U~I$PVA8alH7moC|@u_qD7NZUJ&vU6@eAiVl1>BaGttb6EDk*
zEps9F9<djrb+L|53es*kc2Vhjfa>=95uU~+*3P%Q=T-On5u+RLsyX{EL~}2Ytokw6
zBarcH$78zmEP^-ihc!OB-@r5+3Kog@XSE@7SPtDn6Auzb{N<mTRT(!mrmG2ig->%R
zY|!!YxBJ$&M>=_fVahm~1E%#4b~ey0J#7l(loh@up3OIiWXjWti2*nTW@kFZ`enJt
zM}wQ<i!S;i+!a>$8#FC+a^dp7?mi1{o9A+MG%eK-pJd<@su`{K?V%ZeC$&jkQW<-;
z#hFK(1#9@gAz~Z@l!8Guu9{y;OKE|8Kbz07%CmLPrb^EN_GQiK#hE8Wyn3zTuQOxt
zn)n|)s!)R`J1-b)V9;;*xzN&&kGNtW_BifDQVX6@T^n?xHPab<WHaiLs8JWNrY7sg
z16;Jx)9YysKQ;4=>=`hP4^G>Z7Uy<l^V6j3#*8el@wzUS+n!KQ5KWh<We%-<yXs!)
zBC0F$5;Ct`XoGADnTBuo=@g(nd>d(d&xa@&G(ts0>**$mAil9k7J_n0xYnZZyYmA^
zKgNjOTXQHHkfCxqkc$(kY1868>cr(eQnOrX{mHHzL~5KRDlIN0m6f59pp<M=F4cGA
zLBcGIbcdSTM9FcNpF*6d)J^@CKMl;tG^Ehf^V|+Vc2wvSj)T{hs&Y->S<Lx2zxpMA
z+iJgGTi1no#fCvz9%rCbsj(7MJI+3(d<oiGmKC}U+h9-Y|BE08E=Qoj4+S+dFMaC`
z?b(z?2Tl)UXw+y#ddl9+Nam^<22_beO3bu&O}F@OG$YAH*CYHsy)eUs%X<2&yLd~x
z?(m=G;3S$J6)w;L4=POEr<n=RD?atEHO>{b-EQehm9rK>qmMKJIVZ4K#r-m6lwoN7
zh0&B<y5_xCwk=22-i)&DL+bU&O~N~hFjquwsq8reP>H--xekTeX;!q#RB~{Z%2Hpb
zBu!u#+hSyP3$Iq}qJc3CeiyE0NhG|H=ue`y>(WwfVnpCU9Ak)8$W;g#J%NPj>TlQ=
z;>pY9N7J0@O2pWETraX+Wkp2pe+Jt*av9bsg+OWZ?~eYX57(F(<#%S&3!0C2YK-9q
z={#FzFH}I3qT$*JGt)qRXZPGR#i!$<mzhKTmE=nu-}Un4l%3SfkohLT9#^ixjfMt`
zRb8HH{)LU$D|^l@@*}?Y9L^dbWtUajr{9e21RgzlF_aR<)i0l}a?t{bnolVmyxGyc
z>Y#P5ux2m9s5D4%@$?FWbcPuacDrsQmb2B`V8<2myA-|+Nb{t+JJtm`uwgZ^QS@QG
zOv^6Ql++padDDare;Q04kuaQ?K&b;Yrp_H|Xu_jaj%H%4!8vUkjd-F}5}R9H>HL$c
zSv6uMzVV$!#84<>iqMv__y*Y#pVQXmD?zamHtqrlVY$O6BiQnaO>5nVoWOhcMH&9M
zC2ie8Q}j;V!9dw}LW5&0M2V@?+^-&nPNzv0c$k!Nz@%sPVOa)}mHi57nIL7R%Z0K5
zdoHZHcNJV<R7H14Z1kX2hA^9^1S?(;)P?02bF}(Ca0JMI%X6?a+Tlyl2K3AeSO_1g
z`Rt{LRP#WbqyOfN+bZ<>F2z)3b5*|_2>!`ekrgBX)sJqd3H{+kMBWy8UZDCpgLi4b
zgxFZN4Dk6)q)}$EYy20w3xdTeBMj-7gIwk`HR#pw3ty>2m<S-bUno#q@vjGM4*Sj-
zx0_U}VQl*{zoI=sa2+oT7G@_b{G#E-|Gm0&1$Iq};9uQ8Ak8@xcc7BLje*mN&zV-T
zYm`A*`}O_Vie3#?subP#QG(xE)0q4aSvj?3_YcjuM?n9-pjYccO7c@$8g(>K=;*yW
z(kJrUi$BX{&Oi`+s8^F5adpAb%t6KsfErvTxy~lNg)4YeiU}=3GZuD#gGH27`k)eJ
zN^Dg}y<-5=#1tka>XtBt7)*t*&W#RsLmd7%T~Q1)WSI8{KjVC-j$)Uw(`PV0(7;@3
z4<WBX)EhGHTJEug(tpRyD1F!Fu}439KeTE<_g_`5JYY9N`%x<Z!d#wj93CGCNY_N{
zQ13T}>0)<4)3#~wfpgUkG3rqui-)61?=h;xu+%;%Qo)7gYx|IvD*eUXTWYoOM}Pzm
z0#6OPsi>Lb@dzQ6F5om>B~?&@d<hnN8~G&sbT82VU|L%XU%Mo^xU+rd**@;%dNAA3
z5?k@PbUov(SKcsi%BChBIZMyO=n%Udb%6iD;(jWS@-KE1;mhZ;);e*Sa=N02xGS-D
z`tvQ3&F>CUbc8Fk?xOa^yVQ6|kR6Dy1KG>BV&}~IyxOjiXujp|^VSx}F9lIQtt9O&
zs&_yWm=2-xnzNYq`YSW-moK{!4dU{bY83^|5Xj40PiD;))krC6NJtO`et=U}0gv!p
zE8b5+Lzx@|&OV@u%|`-t!HWH|?NleTRWkOfjKW8H7(j{nJ`IqMXayct4tZO-{B}E)
zVq=N#f2_-3xM7ZwV_)_n55)H^Bujde*b{RdIju#u?aKiurf_(LKGyrNrwf~FV=Gyl
zFTmgZiz6b{h0Y!unnJzgU5@fZC6z5#;+J-SlLfZpn!E92bVI|P3p{jWGJht+*<f;Q
z5~0)Kc2)th9e-&hPe=`DU%ZqxosnU=5={?l?BK$r1Q~MN9c7Jp1QDsna{22pv(~pD
z*ggG{!mU;m1AOODxd?<S+|3XSjF?*J*6$5-kApu~OsMC+s9O8PzR6$o<>oBi=f8$i
zY(NkFkM&bc7~(j7`Y?6yToS`V!D`DrGuZK;iU15dG^bLVC?3$5kp1{%1^c^YW^4xx
zn(9dZ_>h%8emMS7<{slAjcTkKo2}c;Piv9i@|EdgNf`~QH7=X}M%(Z{ona8{0A|b)
zT)oO}#WJp%ksN`N?pb1t)ZExoNV$!<Z#ML`BaSRu+lSn^;|5ip(ybc=p96*clxppf
z|IVRal5ikgy2`65`-bLx#>4C(J`cHOMyw3$J7y4X$0bq=nm^P4jIrsiGij^B$jU0g
zt7Pk&sSc?MRLT~YB0iEyXW&6?8Th&?uQJrC!5wt08rk7)l{Ot{Sa3>%9s*C%W-~NO
zwbH*a=aq)E@1b(W;g%2Dg}XERW_+ICz*4_((<>afXj7!YBbm~&c<^($v2(@8`O&OG
zKhLcHDkeK6O-d0&P~pJI?Bkqm{}wHh&PNp2OT>pIVto*xWoWZWb`RXQ+B@^hjlZ^P
z3jJB$6u8Ia(TynaTc^3EQ)s-z1_!TMqmqpanDt}3UbNIO{quy;=SC`n|4B(D-4Pmi
z%1s;NtDHeuNWkhRBGcx(Ox5K~CJJF1vKYVPAX$KcIsWnGeePwIMQ+oeJTxV;m|{mR
zK}gfzu*GH0YFvJCxrPcQ<~uYTYhTl{&i-VHE5fugu-<V3f)wrPoiclhle9WaSZPvG
z5(YI#Vk$mOk@JI8#3F-7&jdxE>x78Jr+QV$udX_{*3q8*#pKEWR%NE?!6gAXLYVy_
zFd4#jb`qZ-f8?t)vd-SWQP1fxuNvVQMy>((sfH4MSSHlLNHwcc^PE6xdlyyzM&dQ$
zQW#PHe3bi;L5eeY5dFd{zKh68QbV34eXyh(OlI!-WcVQh_Ya~xi!@uA+kez3Xm%}}
zOi&*!5q?0M+6x4y;+uAfwq#RyYPu$!GaXNM1^eQE&)K1|;1!)~V|w}-y3sEjCafJo
zK4N_4MQbQ<;SW$9Ww#2{3g910>{yoZcc#CG5nE@X5$E?*Bq(B?zf<*2lZz0wqw8wU
z45*S1jsGgL!<#>)9Iuy<zBr6iP%4685rbJ|BxBzQ_Fjs^vwEJ`r9pclcq5OkVD?Da
zCO<2|%rvkyC55}#^?m1R@nzXK`?@5P2VLvrUSrDO0c<Yjy1KjXT;aj@(DQbFz)~(6
z;LKlve`uK_FLD}Fs;r*DXa)6{<@8YPrm!D)1+Pti8O=Gn1!Jv_B6N7p(b7s4xwy5a
zg|wD(G5ptkaUBDr5Wm#TF@?e{G3Yd7j>xrY>*@<b*4tCB4Nj4L^3YjkhZf_lm7jcg
zFG=V$n-Uaw?)TJ-LkZGV>{gJ!SRBvhX_(kGzXw`N@QINbijH({3u<JPHMW_ashEm}
z#CeUy{!<g+U04f5+@;sx@;{FQj(e|Cdc7Dj)aY}Ty)i87msW_;^Qy*#or7>_80#T}
zbD7PukKkmoKPmy7GwqT43xV^_9t=_OO)_eK1t7~>iF=Gh*bNJiGD*+%-h-K4lJ!>-
zS3Da`zZu}_st>8+ovZv9u2e;z63HS#WcsCk=qfGjx(kBxu@kYTqjEm`HbbtHWG#B8
z^ta*-$_Xj#zQRT`-i7Ru4Gam+Tq}Ye-PhprjbrwY3^HH$Cp-_a!jp*PKuB$=g}E$1
za5z)zW#0G2<OxH<{SB6I>1J6WvgvPgL(qn*XYye(DYOKwzI|8#5ADfHlF^V(Ahs;4
zRA~0Epqp<MFOIMh<FpM$!z#hEMXOg>_o^_e5BR6P7Ac#pk%3Eza`+9KbWslq2P$B_
zvr?=~zG#pRsnz)nCz`<>Np4{Uwo{vV4&SB}^N2Mip}%IgB*rPu$`6P4wY=+G9oiOY
zM6kp8GWJL(A)5}ZQl=@wto|upyGR8G|Di9g5b3I=Mnc#@o{b{Jd$QiVRyt{NYFR67
zS^%pWm-bi(Y$0~T84m<S)cIet7vl<)XU0}}6Wyw4pYW2l<=_V|oK>Dk&FZJ7p(<V$
z(Uvc<{zX^+_Dx%0gJlAqfetT&Qgvi~@6>_&|KhxP=W($nGIy)Q@R6~w>_xJ8LOpnI
zuX?gd^_Y%rz=M2j4)V?ZvM7KZG-xV*lHLZr0_)3@D{m{|<&&WV>)g2Vk0pTPP)`b*
z{|}M~vMGicEjK|JA^$BOrh82+?3C@jakY7LESD$Lw5b5Aiw*WOZ|)FoDAcr0H0DQ^
zsAuj=W6CGo+aczXu&V(N@==%wN=U;M^YH>xI;W^=+?*ixcacV+7Y>GJFx54=|K~A^
z|L5tOK71xAy}uFp1^+*2`cv}+zrjeZ1k2tJ`$2{{k>dTeO0<X2Av8^bIB|<E#WO?k
z@hAcWJ|kFq-u4oTj*b?4?kZQ4ww>rovL|EmCG~>n*a<NQd0gVOWbk40bOpoO-*wCZ
zR(9g~$e6#{=7Z*F!OVd+#l7lG!u=x(D$BSa1NN)#yV}++pr*Z`RkKAD%}XJovahPl
zux1!KDLQ#<`TO2RLNGTc{UriSF2U@YmHCsDId3X#FKIY^HmXy6yJct|-k@6RNFxNP
zXo2+U3SatyW_Q$_W?}Fy`r8zShK}G*7m>$j|5<ID8sik>5JC!H`2bsT80M2}*cBz%
zL@FMak**Iq|L-h}0=djN6u%>WtlA(^rOGF$<ioaRHBJk7DX^r}`K$So@#|bEtK+Ga
zl8N{rhH>~-7(t^l{~opdC_(P}s<crGJHK7^L{1m$xOZSxO%-#(RqW_MLc9&%P$!MQ
ze?i7hq^J+TuF1Q=>t%Y`I@v;ujME{zrb|+eb^=t}Ndg=sC*~sav22p*Wl`O_0mu|O
zYsl577i2dQiXl8w(H*F8-38~O{lgu$xIf^0b*{D>TOS5`y{PPlS$h9tR*8c|iH%$F
zI9ZM%aQ%P~Z&O#jr<;z)=_#lHG|6@z6NYFAoab$TvL#!kPW+~Wo_Hf9?0G;YrWI`n
z-5_OlWer}h8Xcfyp$PDdba#LEr}t@YWXg~U6}rpQlC3P&^uL&`9}Qq_lL0(d1RD3K
zfsSh_u7{O$%FBIpSfv~!8N^oRx2}n#^kr`M&Wmfj0&8-RN%c!Am<jiF=1(ltV<{1n
z!rL1%h=7(*FM8cBa32on6K>vkIw->%BRxS7Jf%o7`Qk5%>kXV*Ra(x{3#N2sAW(o+
z7fqUr{=>{4U;)?xg17JXu?}9f46CSc^i3sxbCr^f$WAukkeAb^jQ|#5na0e6<P_x-
zplMQQBN0W%Q*CZ;_(w+cEo>2@sLwyiYzmcBXeF*|yccX^++~-~(23sG0*A9iV}GvN
z9@|U@LoN<>jYkkKw*foa9kAiZi3<>DY}(i(*fYPWivU!!%;@tG&Cq<IQ6UDKP1G9f
zkUXQe{i(DedeIuL-U>;Nv^qRZl!$Ey38@<{JbamM>*^T>qfMHx5#ds^ff(g4O(jT7
z;4UlA!Wt;dY_Ni_3UtVq$un5)#r<Uol7d*N)}Wy=NpE7>SDmBy50*F8O7-zXf4Rin
zD#72@*dwI)*)-Rfx2~#!&5Y))Gb|NHyB=u?0ryr{JOO!%HA+8g&x)I7(`wU5HXCts
zwCZ_8LtDbVIyBf5Y+aq>Gz+J`SyK<02eIo7*0I5+KZojDgz8p<yRN@hX|&&V@o<3?
zR&rIY=W7k8d-2pev95Kn$Qg~GGyqf>RjtRp^4p99aAv2q-K&hKg>?m)q6D~^EVb6J
z-;&ONWCaG7=}~r`*m`DB7x9gFa5g3SBs;9DfhW#KRX^L?xe~)RkftKe3u!;a5syh%
zi(#~K+}+%25ZmLZG@eo|4)5&#-E{caOn@+r>Xaug*ttJ4tTZ<a9nl?K$%1<LM^&2p
z5%}?P@tV{EZx~|PA33+2(f%oAm$`F4<?1p<-S?*cx~?#V>u%HuP5Q8NrwcWu)8Qy0
zAf#ysNtxY_x+o@3(XyQUQM`}PPK2Z#FM0t5FDV%hQ<A@7a|a=Jmenz*a9f~gV^#W>
z>m1@aKo*4YkeK;UcFS;>t{j&yXu1)Yo_xG+&Z<cr?dwcL@ugRgfkQIS2(G!d%>oEy
z1g~jwd@8t9YD<^e@O)-{MYG22#1^#^fa3!vcaYr7@Hx(xi*7?41X8>_yXIj=xl!3t
za~pyAPaG1fBsO9zKR4Nwg(^<H+MUzrG{9su0rGi?$pqKd0#<zWC@QzHnGLD)9d_YL
z!W5<5>AI>RqP-Z%coLC?$#WXo4;ke2@4DqqE?~|y>x9d6)k7Q;PG>t7Q{JWXl1>+p
zVk-*#p2*)@T<y|Oq1U+m>`lqREik_2Ti$ZiabVL={K>>PwkARsAIIhsn67^wa_M7{
zBbQQvZLTCMXxDmolE^Y5fICa9mxX5InrkNQ?pwsli&DSDeYbGY?_1Nh@td#r0TM3~
zFXDdVdaTGV+4*wxa|vA^5cv+j4-WRu%gF^W^;=Sh*r|>${A08wrSJOXL0zhyXUdSk
z4P%@oCvZ<N_vCk@rPZFSEa2UIrsLgXZPiM(DA6zVf<jDxd;y|@tRP%M5DpY>@+l_v
zfvV#DIqW-d@fpTGJF}LcK|tu=XQow$D?ujPG`h4W3Wp(wCu=(K&=33Xje1m3k9%+L
zD(sPQzWrl$%qkofKJKl1LB<vPES$<lT<cMs-hlnH(AW6SPZRotoI=hH1_u6o(Um2D
z_`+?~ktDZ#JoXzo+m4N&bjdQP0?Pws935du6mhHAU`{No2tpm%%@$nTIPbV}%|Ggr
zr2?cKeuG^DulEC?2<o0ydDy@m_zFzd<DY3|-iIaLx94W~2EiGCW2ypIz9}HJU$DVH
z<s-aQg10~OjDD1x;?pI1e=rmqYiKaRMa12U!DjDGye5{{kH5o`trpiM@LYb?n&*Io
zEM@AE1UU%nSG#q32m7xyF(o3Y0Bm>Er4{|<RcofEd#pmd{L`NuPjFO;r~1Um;R3`I
zgS!Smk{A8m(I*Hgi#KE0H>}}nT(ut-&{xy&eS%sA22vr$1@pj(mbQ*w(0v*>ZQ<~S
zZ7T_?xpMa<;9W1C2vruSCf~i9m*!f7O*VE(K<GZ&r8Qe6!_aHHS&TLBmmqrpQRU#}
z2t`|E)G*EZ0e-{AahkCAFg;{D0)nWFJ!NU-5%gQBjT}o~#7;%Cj!0{HZ6J^!L(7hW
z=6U!@x*A_*6zB&|GH%Smtq8x!7Oal@4gRb&FW#RUNKOLAx(#D~x}(w7((%bCLIh@=
zB`i<6Z2%-^gc`J{W!8(eHg(OcbOYlZ$LT&p_~ew<a>Yy}Nmf3sXI{36aIRvYh@F$i
z>!_#)?so1KL6&+!r&$ieXF?HwyKkbV)aDtR*y0zq(_%Ds6udZjA;xb)>yUj(1dOYp
zd|L#ZD8me<0QR=%Pl3|R1ypcoB{O7h(uVzTKI<sr?GXBDFN>pD_eCh^%tqi9h~M#m
z4DM*7=;icBTcbjq;;5^4{1qv}bFYV>IaDaWm~+@uUoFoqr44|qw9-t(xOFBQ+$We)
zWX;4^yYZ@GUtb8xiAHIAxnf@!Y%w28cpK9DHgW|_ia#oEj3K}sKE|hD0SQtmku;&s
zFKEt0#1SwCB#YQy8|9bg?QO@E&er8&kN>2vs6cRfb3P2vmegY@ALC$q=S{QLhv({)
zcpLPODV5T5hTYjE<DRvFTTQ#H!LTHmRYDQ@n%ljK&8ud7S!$VMkDDj5RWrOW$UdT>
z>_7-*Qae4C_&`?77^T$VYxD@0wNM(=T(N}+`HVH#ij`}Sx-On&r)?6D2!Lji(%DLB
zlG5&&yMl0BR)UiJPUG9xI_gOAvIo-WFkFK(VRuaWXyzgctkA1+n;vSIcX#2FMp~RW
z+#L8Fv9i8SyOI?Hxz&}cEh`D_;sGp;*#qjx=~}^&eF5ZVkAM!~w3mLyc+s4Si0#%m
z(3J@!7z>B55nXvbdd}Gs4Tz3yXe#})e-y}))4HXeOi~ZYgSy;4-}$5V{af&n1Vq9t
zA@g7A>ZzKl{>|6;yy6oZ6sI81;<UO2u~wn#-ssl6$B=dOfYzkl4lmA~1&^tvx|DH>
zzssrjbSI4@ax<}cl6~D;KM@`ak5mHH!2A+3{6Mxcd!JTYOBWq<kB9L{8Gda8KJP|f
z;wc6-PQS)TWtr64@AN3tZjrfM<%5IvN2i~HiS!CEOUz!ePd#gN>#!rCJ1?l4Vs9Z`
zC59{VF}%8^AX^KqcMRZJrzQBDmIK3iKyjJ)q0M#<`pSaWc8%#x5|JS+s*onoca`+4
zbw%X~MKmZjG!N$eju#8R`c$$h5L!O!X=;f$V^}vAGwDhgUiIRHk;n=0k<j+tW+LDp
zlr2*qBd@GEC;;(=gL+<3qha!E`*>*V-CHG*uOrah{=~)#cAt`YqhoK7uTMEVMPpHi
z_54~+h#QBg%uDBL<BJTghz()8{5evwICRv3n3=UDu#Tf*IO{XQHS0;u1tNl-EO~$_
z4;he`hqO=$dSP>6y?SGWsp@n<vcjvkEjOx(+t4c>*X_BBC0ybvLEd>Y6vqQ{3lDG|
z1oihB!_F-62=jc2WL&fy?|dH5&Y&*;XGqdQUf&QJ@OTK5Rg%kwi>@NTj)2^)witi3
zmPd7aIK@ZKy*gd_-UjuC^L8*mvy&ckgTm~BZfOKmFP+!HiiuQ2&<n?e@~g^H76b$s
z(|4GK@Is&;<56r1&1I8<g!M+i#R?xGq&y?3CQ^-?yh^_FFQNR%nBCNt3Z>rwT^sUL
zv41A9JCaNx;yVSx7UFV)SxgRj@!W=(Qc^kFfhiaxOD6MrU&yJ(jn{WYluJ(U2e(z~
z7N(YW;omhhWzHFV;qjuwTkgF^fiezXd68D3!}^MYg2<5zhl*zx(drSG`tgg02{Mj}
zaWh(htO!+KXkdo6EJ9|4e8&%-h?9xOWIF`z^PoFp;l1`|a3*3iZx8(`e}v9uaF{$|
z)+%_6R>F3TFf2Tah|PX-)?(oNbp-~+rx>x1Az2F=6XsOHGcwn!BV1E%;?(6ufsePL
z-;CQ^x>qE3rOs{#^*_sfPC2A9r>_)I{hGX?X|>P@;Bc*wa;1IOvhrnQlb_)dY>_^1
zTl3^wcMQ0GppI#d`N@xv6xcD3uC5)!&ucBtZhy|>!`8e(zCJtpa_XB&(75?o({8^n
zAe(@QupO#iVjJa(qy8`F6EvZl>kS0LDrJr0aQXMD6$U#_2P*h+Zl7=QC>sjG)D=|-
z%bQPhON!UsMc#`JLQ0Y(njmOQqL7Fw+qcxg8uysoiGohg?22K_YR)ScTKMc+YwjO=
za;Bi=38qcLk4(o(gy$P1AgF}E1;VUjKuBXv98~`8D;rQf!6Re_rmqp7RG0(ef$sy5
z@qq}Nla|J~TNCVNXAFl{^i})I`#Rr=iQb=3K?@5Q>LoniskV)e(1jeqp=sdO3G3CO
zX47X^<M)1yuvLFX%;#<wZg&2;1Qu!Mj3c)8S~*+S4`0hs@i~YgU?KYVvlpiUQcmAy
zCb(w&qWApaUch<z0Mu6$Cr9Gb@&r$AD!jTQbP&a7K{wU{F3<zzjAF&CvG~)<kXCK6
zeU1r=V#nlzG#}Fz-+lphqDz?XWtv{xA%Aa2zCP+zJqU8F8TBHdj1{akHK_?fhZ`;x
zGt7a~8LKq>X`68sl6xF|K_t^Qzpi+ys~1VOm9C*kVSVU?aNq$2as!DIGeW}&A}koZ
zANEZfF3hn>1mV*_7Oc6|*&8dp?tGTW?&YX@5h7{ngVSMqGDKTB-Z>meJMHX=&WG#l
zG;wL5bb#J*|BG-;{wF;r*diL^Rdealt`hm0CF11>y0DmnV8PT;>YlF~WA#+O;YSI{
zGh@}|+K-C=K+`SPVIp#Q5cih*7DYa&?Tg3z!N^$&sQ1+sXvq!kMfd3Z@Zb@2h`NN?
zmsIPY-7!K^m$us?|KngOMtV<E!U=!`@AU+?g(zHXWYLXQS2E$qTiqgoY^+Swcn*PI
zwTPqvW~JKp7=W4fEo-NEls`C3K5e*VQ=}vX#+pCjVc6q<-@#g5IFV!w;HzVsTv4;`
zKkonLHvMn63TwDHf)e;U)V_e2F=j3;sv#)z;d_O<R<cd$&`XL@aUF}B@dNF2X-{a`
znQ$J6Q8Xi!=t7A7fPI`y3?cJkLe<~(TgyFH!12To-elICbDN&+U>mWGq)kcxq{%o8
zP|@zS#*DM(m{v3K@3fZhi-5HMaM}a__!j*!R>?Gj_<G$%oZ^JNmZwmz!~Qc34w=W;
z2{2*Rl5Ms3e+J5hj;K}RtS_Y>Ih+m4IFRm$5-%!pqLqX}!lr@>-&pmL6|^jJY7f|8
zr&CL{StqTyyB50d{GOue4GBN+N?!R3Q5(?cmUv}46t*rl?G$98ldGTz2rU$WqrP)}
zAUNVVAH?!9-ToLN3P)bA8Q&SSw9^El8pJLz+7=<Pd{MyJ995TTVmcXXM-mQ`PqOrV
z@<*?ZUvk~M1(PDwl_bm(AszrR{Z#XZ;+)epg=Q?F5ecqk<c6|Bs2*2fn3py%C>!gw
zgEpjwBf`d#%3_eawM>~!#Z-rI2eU|zBvon4MOaJSiztK5zOQ$jS@7J9i3Ed?mTW*`
z+IkZS39j_(i)Cn2CLQtf?7N|S6@Yz06QEhoY(i~^z!|f%Tn`ugU}AN~!3-272?I)P
zp7|V2C+$Yye{Vw?t;{LIDbt^PGhz@48w1f{+<2}3&`^3IjeP(i4k*X%*J?3Xr#K7{
zh6V~zYLcE0QB}+@a|0b5I=_ilbJT}12_7iWBWO-BJPp+*z*t0iQU7iq27=ko{IDAp
zi}%RaVI9;#Y3qkX^4JDHLo0_iIcGyLt&69Tx<^4BQK569?)11#SCEl3adGuE&(T1P
z9V+lXV;B`Ifa&+IyfuKc3X}A8-=|oHY-ow<^_!sivXx!<(?5eAf8H7iCc~}PwmarU
zy5FY-2k_8!H3RM=fl19;Do>1s2`Dmw(5AIc3EDbQZ3IwN?&IcRwLGratr#Y;<J8VE
zXAcIrUQkmXi4s-yBRpF?qXZuE9%)GYYinD8a?w=~4#VH=9&6xr=L0&I`PJA$-$iQq
zvmw4yLZeV(Nb?%=@38`iJ*O}r`&_1jj)Dj_#fH)88~Nhmg*%<WY`xC1F8zxzoHFF#
zb?H^T@GPQN47!`21?gXy$o^Ynfj;=G6@f92STdKWFiy4xJBrbby1T;P=zUVtAaL%|
ze>C8`)FO;@#(Je?QZXevL(4H6+Z^j-iu5Z@f|T|qKbz5$M-n;2h$WAqF$KEOacl;l
zsfc*2!YYnP_YSgnkC?w{<y0$|%Vwm708mA_%Gr{oy_BYG6N|dD&BZgjNjHWcsR6AN
z74^R~=cbWGj-3W?9*1Zk9woZ^z+_%Y5d6Plku-ON&i4%w9pq0agn`xA@WNh<>Q@Bw
z<YUh#wQK(Y!t(!k8lu?&GO6}#w{j~Er(|m$(Z0Wz!s6lLGjwYjpqA`VY))7)et~e-
z{hpFvhu%SBFLUU)3Wtkxi+ADLfi_$q!IxtZ_@yOq+YjEU(^H-+Tfp!2#FGxY@TZ6I
z$g$|HNzpMF6uxN80Wk==r8JBJu@|n8<O5WJ=T2ybGWW|HRiyuIE#*RCx4yFiq^Ij-
zlp9>A69$+(3THL%VAoF1NypS6{nu=mC-6aJR^g;Y5dVc1=MqPR@rEI^oS5HugP=t&
z)$^IwfzhHEIM;)lGixHOhXds^Xq`WvbLx*i!)@e;w}`$3uD{@{!oJ0<ijY3#{sdES
zvK#Sg6G}%QzxB&@9!p*=H;^2Ru8)Y%xzK6?X#)Z(%3fqbO($lIC3JiM2$OlQWCE&N
zX>S1ts1KD!yyIIF<1y1}oXz)7(K&FW2K)0eu@&g#dVLLfiNta<Th2c_h?OV3)G0Yt
z@LA@<*M+_YLVr8K^CspxcI#BXr#7W3^DLtI4S5Wlfq*ZKe931TZ5}^kV+)swCwc#^
z7b$P%PwUo@4B0A&D=7Fveze#pC@rAF8HU)Qf7=f0uV9V4h%h(DD=bG)Mw{o|p2P$x
zN)#kxLAJ=R#WRkJ>A5nqm>b?jk)3#5?J6}4)y8meQd-Lr5&KRYUGRDxt?YTfk~!PL
z4Wi4Avsdm?qtOs{t50UnGSVSRbbbJo3lf+S^T0kLTCVX1G>OW$O>TIU(8XCK`IE|q
z3ngfxKgNg8B2j<$C8?_vtHrF-Vy&ilHR~YkHXjS-&FA%C`}DPT9foebLJ2lCwl<Xe
zC}wTeiWW;?lJabT#wGQW_%gwV!@?ZRYr?iEa|n*Ms$UgA*UkJyFvY50TmyDp^=3fj
z;8Sjl21g>1hPuqCM<ehJDs3muc6yAdNrix+qOLj{vx*cNqZ1ZffO;g@laiswxh8;e
zehDuD-|MC4Pqxc|Bcp&*LI~J+I+R6h?5Y1PPAEbw8rBfTmy9wg{SZ@kfoCS>^6t=R
zQt|OQ1iH3Eou^)g1BiOH0Aff6s({c1l#Mk@S<zDo?FAN;7qBIDw4tb9QWMACFfCHN
zEXxpM_#++J<R8OfodFXE3PNMXgNy_R;piaF`_fALhO(1?u2{x5X^ft*)6b{=-iT9V
zMF1;;Y7pC-x_i76IRq`n*Q^QhwaVaO)B26Cf2G+~s}kZqJq0f~Kk5dB#IXzpS&vji
zT0ZV|^U;9seLWg#eW_IEQv6f?Yg73xJbS(rL86a5yP%&dhaOMcc**=Ub@~`!DDC97
zlB<Q(lJ_kZlo%m3NC`Z||IWkFFl5~?IBLY|lXWYL)8Y#UYAV}BCd+7~c2){o%o$Z_
z85OK5l7Y26WNU;spIeRb-IAJQsaE?OfxlO7ct6rec@bhK)`V^0|2xTWX;U(Rk0Gh%
z%h*f|<+H4548NqC;}ictlu6=8bgFNyOUReGUr-AnQUfqX5CEz`w(xY9)%r-0dV*^A
z*<L6j_DFO?j`u+Ga^*2{H}ML*)@tn&HxE?02q9^{&^V}&$DO$N5h{m~xQDM4lUJSq
zix0G=1-AGdRjcW#4L(B~LAf65B?IAjpgaZ0y9`i-*x+7_QJYwPnE1=7w9-;0cLs8`
zu{Y5H@iWoV*l||kmlYjIT?%bQnPvB0dUKsiQ*yOMl(9UHwa8-w-GQFfI?X>o3kR0u
zsrK@yXezkGlJjPZkDsDKJpO@<)<BoPqVuEqDQ0qltU>=wx|f7bun?Iu=30Clhh2F#
zTeo@i8D+OP%%`^NL7IsvYTgeMfyor2EB6`P=7p{orh1#LKfH9xmVrY!;GDeGvn^}`
z-PPcr@Td&)vx!n~H+3l@y3lwUn>kH)L{?h9UlXzOJ7Z4Mx#z#c!u7~IwmCNvtqNr+
zom7*8EN84uO;VUGCrO#2@@JMTRNQ0=X4j?UMGth)?#WcIE>tzG0*+P3oXMKL>;}`>
zb_Xu93WGBak*@^QT5kZ9WZ)gEa4WPRQEP%LTtkqoVkPWi-Gnzb^H?aC`LA`bktzJ6
z3vqSATq4A`vQXxUT?X7U<~AmE@nDg&OjK>(x!aXcQwvw5&Q6#O#%VW2Q5?yDTi$@N
zZ5aPQu)DY*+f5$4YP1JU5V=x`MGl#C-^&GV75YvLMoEUZ`go=`e6!%iwJ%@#rFZkj
zYsi>0<*x;=_F{CMf{^rd2L879?DuUN^sE&+=$~SI7$+f&u`Vn=xs>FZyE`R-M@5b*
zvu4^1Q3(#o9gY4(bfo{$dVr&T-*Dm!gNlVGj_0T4Z#yt!Fg5>jNWG6sVwcn855Fcc
zUMO|7Rg!%W2V9l2&4t4^M1DGd^OKcB7jxAl65d6}H!IOuJIz0Ye65Ve-k&pTa4vK^
z-9^(g)phBZ#wBI<b#T56)dYo+*0TA80w1|V;VE4d=^$1fI|~9F(VH1U86lbI0}eE{
z9?bcuUD@Vjr-9P$v#TRT(grWoN|KN@*OuEs=s9BTzTUah&ev%I-Lz&UVz@^D{$-?V
zhCGaDSpS^Zu7gDBAAkU8RO5sF$D2lE5l>wvwY+}grxzG!(+=>}_gEaZkhn!g+3KFx
zra0AJk5JX#xZq~E?uHe|GruL3EE5b+jgdM>`mvR{cDWwJ)_WIWX&dI!iwH2b1{7Fp
zku%i)fcOiMX_UwEaSua$3U5P5yc=}5PvCjUTaM5aWC61q3f?6V^Z#JE)40&c@>LrD
zZsM*J3Ld7DqHQ5vR-{4jyo5I~xMzcU6^~|ws*;oOvEP1?H_b%PhEe4M4dR-{ygLO2
z)zD994F+9Duhwc~e*h_V%Y>z!N>LhU!HfkEF6lF)V(M}lBwyFyAH2}HGQK$oej&^r
z7|ENNzy&NoShP|eqgh*ny6ZbQ<@}tUe74KF1G&3~GzO`q71Cs}xl{c|-%eCC2P-e)
zM1-qNZ_q8tL5#&gmAsPORDV?pHbf>h;poAFi<0&%E*@g7AH6&ky<Tx%EB~-ezj3a`
zc4y;Gp%$at&#w+OO#BBOIm)l}N~ti(-~tEsr89TAvuKOlx<M2sm^g!>3YQi{#hQ><
z4K=C}WoR{5xZ}D0DLB@mGQD#>UgsSuU=~LJR1E|ie$-r|2o?J1pWxRtOe6%QB64Bu
zLe8>dMQV!tLHDh6OyB!kHYgWf$g=qn;QL4_bLzok*95>Ih{hOb?L9r6<Kl?v(07Yg
z*p=-9VjE=|>QWwMzo2T(_y&>qo$#2}&VVZ907F2$zak&f%ABnre|ZMdctT(qQqn}^
zzDyR?#e)00PfI^eViS>ME!Ii>V7XwDr}#B%<Z6)O%@g+_kL=|f1qNDO`YqFOd|6MG
z!N{1=LN88qmFk9YfG=W?M}Giz0nNB6k`nZ`zEW}`mtEpYbMyexJ~jIip`3*{9TU|*
z^9H8`Dx?U&?&VzP;H#k8^Vk4rP|>gM)5leB9S2?Xm~oH#ScGm>h-2eCNCAk!x;2@W
zc`#~_j~~VQ0hgZF1;i_@Nl;WXTc*@}G33F%G%|qC+fUl1oG4whH(#PLKR!FsfVi6|
zco-u2ZraZubVgLjGk=QQIso)BycSI|I^SHHNwY)_turLGc9wEjD=#)}f5Z&teKR5A
z=y>}}g;m(_c<yPQn@?6Wwnjf3$$_NV*GZ2%e8=yd4ylwcXRcp532bhJHxmE=?7e!1
zHAYuLAgl&k!54(IAt*3iMAH6yET2sXEHth)m1tpW3)kse-J}38I2uY?=c<;2$myA@
zi~aiX0Wu1CkVE_hTfi~<3k>fOEh=rPAA@#bzf>WimY1>Z75@ZAGhi9AHsdnh|LDZW
z+KJLLs1RtBi4xWGN$)x}&CJ>tOaCCAz+Cv^bMGNEo%li3IG)(qM9%G8(O&+<-ZJW(
z5&xUzNRbChqS8PyNP;-lmWF2f(W;m&mpL6kS4KX<h-@um*z*8AS_MC9^GB>fVzYr>
zK$|bdgtuNpWnQ~cf#Ym;+WEL}cJ7$xO%ixFy?qKFpOflk;NW@c9|A{p@fOlH5TWmz
zrl|m;NjS0h>8cVRmy|LdDB?_5<jO?uw$QM@{s`h0kw4{mw!JU8FKTlT+CF_A`10E3
zgGsHF&VYFDWPIMb%EvtCcT_Y}T<dN<5Ap9+clwgzEE%MsuRmr|TE#2Ga)KAV(wtlJ
zUlDtO2+E!EDN^5BrS$g?F<cDX#ifVTFR`fVNMTGM1&mcgiQ(zMpbB^z81_IpNSD54
zN}KDgA{eD%XcrIM1u6O_#<$OmjoB#|DSaxYF{G{v`ks;)X~L=^__jC|F_^9UDQ?Jz
z&U4@9)^?xnAk(w3f#)HY1;0XF2bzC&R~;#eaV|HQ#ayU`juao4Qj?%;eQDTCh!t$0
zYcFM2hoIr#b;@9qV<34?p{9iLS90%Djhl}f>R%JN#yD8q#W2tqqB}{Uhw8oQ0{F3!
z&oPth*EX_i+g1hW`55h;Xr10M(<i(}FAjda>c`I#d!=UTwNwGGwP$kO#g>Rn@>{eg
zK!^LHxq6liq3O-L0k5m#nw=4#7hYg+;7|9Db6MJ;9&;sG4V*715s$qcTB+K?SH4Lu
zKB_9fj>1VV;`DZ(oCpu^ks?@)w!8qZnCg(A99GsZR`=UD0II^DuHHctmXB%0ld{w&
zYkS~@MEcGgQapnEz97ls0)*bOWWeO?V^aII&TCSP#W*F0RBCj%Exry%#Q!%yLS>31
zvTKkpZ@pVkW$NQ6lbzlUKdoz0PUV>c+4JS#BDT|N@N|ESrS~yhEzD)+Mp7;i;qpD<
z0KI`vA(x<#;^x6?&A6TbaL8NTQQGaEgsYbnyUT{o5`e!Mv8r;~ccD#ffZL3l-r0vz
z>4OTPxcLFRNfdQ4y>5WEAt^lFbTld3D!hin23&jQVqoli+sdUKhyAn7v2X+uKP4_7
zxRgU_!S5VU(!KGC_9E$Y?Ls)t6^n#S)@}X9t_k2cLl=f1`lVy5f;H#d9MtCkhRIw=
zZB(~X?O_7j8dq9GH1M0d{Hdc|!qDF>rcV%WvO+pnlLkQRF`?wvt+LBh8ejnI)j}oe
zMjd)M7)-z$*TKWbays;ETekFNMD)eq8EkucI|RfagMI#`STW(Hcf}r~3PMXnxPP>b
zH1f4UJ$DfP{HH%1dI}q3g|8%-TOxgn{Dz)l9FwI22H5T|3p;)4C8fjxc|K2JNhJpu
zTUDcpl|<{qp$f&4XUU&%X^%(5!og0v$g|RDlpEJ5Dl#fF?9N+V0HF*BvHG=bQVKi&
zaUfP~K5M%V<P>ewSw^O;UpsL0MV}*Gd*}LbNE}=hQ2vq?g~&Sd$@BIBw-)*B$vBa!
zE`7;{n9^cwA+$u3-`4DYsztszmTVg>VWh>u?{AwK+PXVE&1C!fbyn{2nsRRErDStW
z*N<WslCdEg(Py^F&cb#~W;w$z9qjuJ$lhfWGdal*ee`kj1>}{$Q7EEg^o`P+e-Ujy
zCnV3>Uk<(Crme6SB*fWS)F&EX)b<=`aI!~i_g*|l1jH&(k6mt*x_9sr!+1X|zNEMn
zK`oXRAtz0ni(SHatMaa|&P@_%mwpigfU2(*^?O0$k~d(09q>rorAaY<tF++Vhwrnk
zC{UZ@tNa>Afe<3s@hp^SAQiZx5D;jG`NRwRj~J2&vsR#1h^~jICek65FIK<%w~R(|
z`)x|ISgxkb9zdtq<*<U^O%k@0qtOZyW~%DC<A~L@UljRR>^3>e_gYD#nra6pH?w7w
zUYNBo599x`2c8yE$Gr#Q=B8U8%sA?j0L^~|@ZNgrL1kRXaxUnMByG-H)T>c-i#H!&
zESHM1zQ8wzdZB<?^4ZW8{J+Y`Tj65mNM8CX(Dd<{=R`JSf_pab+67urPK(VzOhRiZ
zGL(6rJ@wGTS$7P;8tp21(xV1g<cQoP>qnW3qUpvZw>!$k!5uYGRRS=Lm{iJNoABP_
z*^9|@@Lhe9E1#5$0AFyKHoOHmC<WI((UI=gdzN0-r@PE#wVx=x9|`N${ZK*UvpBZ<
zd)nrbfY)Vkn0=oHRtqwlMhDs@cXi@@9+|A8U|x1bND3ZHZS-US&}qed2>%(VxNH=L
zz66-R=QMB+<m~iW-UYv?VDi?7g%dmx)@@YbiN@=^8#<i*Yv_f3bGYhdRq;FgN<8J)
zpOKR^4^cX6Mc!^tj8GK*J7SC{1PCJDU3S7>DDPieJ2T$(5Q1tOdI?9GqTR}}j2*dO
z5E@0KXJpiFDG}rEeMGJmM(teiz)@0{qn0Wf28IFJRZ!f?iDwUAnea|ZUNfz>o!QO}
zaA$uU8<!2Lc6djmy{ODXT?Uplc~y3zU945T&{EQi4HREi!;)22u@SCzxr;Lii(A9-
zNfWjdTpHFRML|1;Z&R)bA*!bPw|D|GuX~BR?I!G4G1(U0Y!c-))!KemY;8PeYXns4
zOV^L^3mlrclTN(=4augCl9ZBJNSzjqpxao={I>}mW6Ag<OQPOLCrC|t&p#--Th<5q
z<2@K1I;^Y_M|4G|YwbuQthKs?kguv1cHPM75S4jjeXe@|Ll+$<o-*KQ`K=Y@6)d+#
z4ZM%~!u)DVwf<87`SDjFW#K~(!uLmBz1p2CptFJT*o}>wY+Qat$_*s~t6QdQM1=Q$
zLK#Vo4aT;UOw>m!Qi?cT_{f>@uDl}3&ft#ItHC}#SEx|Flr9|QEocbQK(VjGr(^Ur
zv&~_}CL@EhaD0vQ7q)$$PQTA>7-ckrtocu?pQO8uN31ua9$A;{AO+my<z=ucJ#TF(
z{@^+LC0xiTzw1s@BJ)|`T=#9<oix=17WzgnM^iM2bnb4pC#e3-;h_n2se7-xe8(Ch
zo*IIt=!g&k_q?(DPLiuAo#(tHd0=`50NMfSBdIUe)+qt;^hb47q{JhVnW<n`TzymE
zMwHwJ=(yCgq9u1i&t++q&%TTjK$>|G;@D0}I_k8qv=@ov;RvmxA?Pe7=pYSmIGsas
zGdd03qb6jaN&1*>D=c#=5=D?Y2yN_LLS^Nm$9Y^Ts&t!wKOON+;g>t$OJ4NOX#@wu
z;q<bWZ!EwRFD*WdbjD|m#@(zPWvm(ed3i|eD$TdJ`kkN;<xb5k8uwDA!hcrXJgRs_
zX~m;la8eH9WSnpSUi9?UPJ(X{5lS+N9Gis!&NQ-K%y8lOuY8DBKUJz-kDg8E5~@Yp
zr=BW6>=fI|L&E*o4szM*mLIFOOW8}EH)kASt7MOak*X7y^Ga9KkrT3V!9w2)xub|i
zp{P}$kS7R7UE!ah^4Isl8Nb&a)(bWJ<Exmp=93sG#k@Rj$t?8rR-w-tyG8d4NmeiS
zIQQ@T!sAsmW#YDoi|`qz9|>1eNI(%$#!@MBfKJ-G5Y~(i@_Ad6I+~o5*T94Yk$@k<
zHnqZ6zji9ofXS9%2D~O!65>{!h2!$r8!bWl5cHdFFn-yk@myzTKw}nDX%gU6tadKT
z=F1`zh_<{|3y=)BI4d|(R%EHXE_2r%RgQT&pJt`zM}+o*uqGTwT&&tQe7QEZdtjl6
zFv}i0A4~i;y^loQ`ui#CHGR<uS8a0ixiT~;t9<8Mj7ga0YF6>etk^eU*-LIhU3vEY
zNDG)|ghv_2E_7U#xR|Gp$~w^gWt6Phd$_8`Sth2m(wI9;&H%R?gMi@&h`{7DoxmZ8
z0)1wfnA<G-bbN!y?}Uh0+8f9mUd)xGFhs>6&Ig<po$=%a!YaczWACL}l;SJd7FQ-!
zM^30kX#eJIL~15?EdF@YRd}j9t6JV(O?8Wc^=O{`p0AHXKt-TT%!O{(*wb4HBBxWv
zmWc+?GEbDJD*}26s8TSv%e~CoWYc>;4SlFN9CD;~ECT?3ox*}F*SD|jB+5NxJG;;1
zUPe~K)2#bAt-wgZ%kRLOkl0j1+axN7dI<#o`4ly;xtR1k038Pl7h<iX8@D3EwYiNJ
zv<E>q-1pJZIb5eb()iIzl55BIZvH)e)k-_n@R@aa=+$!m;N>l6$TRfRY#<QkjEbMd
z%rEm_Imu5!grqv+iE{qymRNR9v+1}Ed7HdunA^<!8copi>DLQi^Qx8aWS--UL-=m!
zSRaFk;Gqf*yg5k3L_Tu+#C2zH<Zer}7Cfg6()=w#!XnMzgvBJFq($jndMh&aKX&5W
z#udQRo4#x~c>l9<v@vva0O=q;b-KB$pl109Ytvl;D0$JDI09$J-nN1Vj~gE9lh+q{
zD4pK_ET)QxX)vP^zY^pdC%aU#X&vkBPE+-^)Z#mK@dtllqwrR6F7NYeadntR+NQ)w
z6k}@BS?E4pY6m3xLHG&$x&5P29S31nQSs{|TgY1xBt%+jl3_;?LG)-zoC1hsnkY7`
zFg;>U^6+EMF;ikyGrk&}@gI-S`<!OULuY#n%#dnwAJ=6(EWn@0hS=S<FznzWYablr
z*n#@#{|TJ6hcYxeN&waYl!mxFE+mVC8+DEOM>zheXYs<YkuPbEK-MpiZto3?hzIj!
z!|X=Xru5KynXhN+ZnA&0f@V5bLQ<wko7c9vTV~~3<0CQ#gYuM2rdenAXn9!n^InYR
z8`a2YGnx{yZ-c`q+!ohGkz&|$R^R4BU1tCI8^o$0lz`JQOy3OTJYxhyzB3?&_=D^j
zO-jbmP%Fw>iEO8;&^j?&Zm^K}y5U8s)`e}Z;fwQ?1EXevTj}gs85(?lWZGBlw+r-g
zi(rMj=9W@ZG=+2YDXa-F%;HVgy~G)scY)U(bXe2mmvS1TJlvwtI2~z}_q4-feCsP9
zGTjW1wj&ngU?$0f-D$LlY2(IC-_vz4IcW2sI*$hnYFnYon$>Zb-E&&{lp*T;RgTUN
zplo>nl}5K73yuLWs*DxvDJ4uJSJEgG^&YXvj<=y_l@YQLV8!?`;XMneVG&7|pj|uZ
zXTlz+-Y$3NMlJ;ao@JZwdxByG>?*5}ll;(A%<<XdbhJ{aHx^DDi`<X&iIdyY&x%_;
zfj&o#I}w4XdA}OyT)k|9^^#1pF5V+WNMAz6IT0Y>DR(zsmU!8u_0%{L9eiOMj+)X5
z@2ZCpg%<vL<mkawtq$7~UDPYrmCUKv8<Q}H(E4ekoB`s0Fx%@l(KMjPB9~01Yhu1f
z0l$G<i5<cnEy8@#5aKa3tnjZCSRo)ZDVj36(_=-@8V5G2qaEtEwOPot_<;QOUR4Lj
zB{rPYi)-%X*bOBwpu+8rgRAxGQaj{^0NxC)J1nx5A7Fn;JJD@j{^86Bi2DbedW;{y
z1F>}XE=?;WM$^{c0I<+F{2>**rCX!2T80b#NxI1f6FlrW$Q>-&p6lms_)R3+O;dUh
zuXvN>O&i4vWSR=-xc2KSVp3%m&NMGX5a|*=bgntKU8xMal4OCkKw#=i4qaUW=sIw3
zKq8153<(9Qjg?ROL)t00QK*IiPz1cK>t&Y4Gx$z?k?C&phg1PC><de9a~Bw;!*$mr
za2d8u41lE-bzw1sMVA%S)`8Ctu=CRtky-Ut8#;eAnbi~Qy(9^xi*%G{L(UWb4DiN%
zd&Y>t9!R^Wm=l8wGZzyu%IuY))Ejjwh~z1ib&@(n5iLAP2AW%v0f(Rk{j=PSj`c1+
z;$iC=u-_z!x~I5)mS^mlhBafT`)PWiySTCFW{OR;3DuNzl_Gxr`p-nQY?+t&kpVBB
z+D(LhWB%{85ww}J3H$$lG~5Q|BAGvZR>-B>R$bGXsg7R$Sz>aCrQF*bogdRVcB`t_
z`-H9^LC}mL7#YYFPbJl2(BeGkpL}dkeh($n*R)9X8tc*l`<gL5nd?h#_se248Ew0N
zW;h;heuAmUX<v+@=jv17%K@=&?mtQ65;2YRWC#wvD`6d2BFE+b2-!$FDVlh7*0iM9
zcA;fqeJGDQF6c}cm&dn}Xq9M`Q!KKSC2Zm-L`a&BslHD=kmOwO)nr`{{<jYws?3qx
zB025jK&-+;0KyT4zSuzG$<T{b1ej}DI{?H+qT#*^>nfrNRLxW>N;C#DyfnvPYJC29
zQR#@xIn8QzJ{zk*l5V3-%*_u}CJ>Z%RI{6KUzX2@;PKNv*e?|M$d^v%Bo3l9a^=KY
zikcVG=!P}uH#BzJd%&m|`jCUR->uWpPu7sh2tP}{gzh$)SrxAp?e8a!u3poYqy;(y
z{L5lHdgmkipcD5S#~6jGPZ5lgj$#XkipV!xMH^;VhNd(TP|C3m%)HL!$neK?&>v7c
zt0V^L4(dd)q#*`|+{!04GGqX5fn+pxp2*&K-w!A~E&q?BGGf(8^0j)jz0}<ss6sab
zBE1oBqAF%$-sCX6xwTB}8LRv3=h_-Z_(NoJJA@TDvvXaJ%aOm4pLZMbodCIYAFZhc
zIZNB}%XBXKJ`z<JpWuXqM{l1jz|iuq5QNn$4mKGAOF4Wo_htB^gM}ErzYA9THol=S
z0?>Br<SL!7hH(+1qO>0BZPN8z9ejG97hWnvCGqCzgKdy2C~rH5M`!eMnU^uGJGE26
zZBe$0CzN{_U^ad&qL!i{CJVeb1`9B}J|aZs9z7$|l`J#Scc{}IvsF2g4Fz>-w7?HI
zh?D*kzEc5JvE|Tisok--UHQ&s<EWNr%4~zEKeZDmDDgj_7Gw(luJ2E}Rzi<g;7a<m
z5=QkY?-_iKnRFKVr{tYLnhb9wO9kB>_jF@hwe%Vr>iM)q+;mhN`g^3hDLdfz)*ZxO
z!a><fhOck;cDV_uKxkgYaVc9D*5ybz8LJVFhdLOPcr^nkR8%flplc8sMTh>w1)$KR
z9{7zf131aAsOLIm81~go#&lZiRb#UOx#Z?*&qm3g9fq!`*&hdr$!mFcS%3;xOVMhe
zMX9^b@?Y_H?M55hb=-ny*#fHn%c!|xQ(3kaF3_>l`v&>x&Z~Ybkr&(mfd7Em^{z&0
z?Tuy1T`Z@7ltcp@?j@CZBfPpgy-~c-0R0`0dLP7<8DQ8_uyRF%XqUvB1b4!gsnVvN
z0d0KeH8?z!U0CkXD#fn{rAI;v^-|8O>73sVCtT2SO~^S*=KeRn03KobpEe|%ct$N&
zQMjj6b3C*Rlv1xV`50fm^nmo)xn>WxXIw1>>D87%IbeTu_J+-#sz654P=ABl1Djo^
zB{TykG=)xteWs>}u_(o8A*YXqlSv=}828W~Ro>pMYQGD=HUH0!p`ScfnMde~I8f~s
z6GqdxI;3SbuAf-Yuinj992~itmX~F`zn^BJTtc0aA{<y>>y9hgpNVoxC1;@uT*8Y0
zx_Y@B8uD=0!lIZoiaNa8`ir=Zb%<07$ixq!Aq8S3gp0|x*Y}xW_QgRho|n|!dn;o(
zZD7uA>Enq2Vf5=OZ@4MR-HqS8Ue6azK)0VtorO<X5&CBYI@9<MBJ{jCau{XKtrr<v
zDH)M<>~#pi2Md{WOAXod-R6zXy_d_r#o1#^b79TJ&~1=_*l)?Ys%P^Od_-f=Q_H}n
zA4p79>>BmVjl)GeB_vr<(|1KYsV%ZX1Mo)(L!AIgg6fx|ENbeiNn&$_WPshvj@_}@
zu(?0sE!^bUHSa35BN|=2o#Kn}aA1{$pBfxfVeRhXx>RY#l^xin!}J@d0xNzIBtJEp
z=D%1HvCQw~B}Lr?-?ew_BGiuf<&!Q=4IxZ9$GMptl#aE_P6Lc6IXzq2eu>fvt<w>M
zOv%|>Hs1&3g>06+0HaiCQ?sVVqhBOls5k0;QYWvT4NAhBc33_pdAv)^l9PV~WIzvF
zNW7R&jBE<$B3$9`HH2r&k1zLGpWWg7Cxs@hKra>O+HnV2J7pbWf3ANFkVz7T;Tm~A
z`@!`8GPYgB1JoJ}Jt;bb{3#y^8g1_Y07a`9F9*C)VC^T~=_iDww0;5oNP_obbQ0T+
zcY6p1x569G+hU8n#=oA#^*kwiQ6g+)fBM+NsSAETy;&YDa%n_ET^U_Hs4hyOX<XZx
zW!3U=)e1}t?tQ$}M4I!;MDyL*Xz)+8-oHn!1Oa!_jK*MIG5leiFQU%I+_10BqbDuh
zR&ua!#B(4TO*+$uD)0c+eDgr(mc>;xEn>BnaLWPlVRd`e=Y=07x!VAdAcfyd+nwtU
zBT{Q0!tU_}pxHrJZ_%1|Kog}PNjZ>;;6)eR+<YiE;#`zg01X|&Z1tg!CyiMyZ8B^@
zIQIF~Rl<6JalSf_a}OCpwRU<DOay0w{3XAf+UFkY$*bn4wt30|;!pQs8Z3VklMp_F
zZ%S&5WWs47e`;_|9QR;!E!D$uHV7g(R0XX3P2W^w(<FA1Rc6^!b4@3(KGa}n4^Qj)
zm5}Sm9At3fGKOY(l~@f)w+9D0D*JubXUOrJahUFu*KC)|GUO3lKk6{s9Qo)NN0KH|
ze!xd-)c~tg8K+}$S5Ct6-%3)^m)Z;Bu#U%_)SWFeo0(Y6`<qgwg?<?~(uH^)E})*;
z(~amIfrJS!NEd>Eodn(qNnx>;qcKJ>@N0HU8S<*Wp&~P@fMG|bqBk7phArv|dxY;(
zwF0x!jhGc|oawb0O}+ZLpif-(cXEB(xQ@}|1Zs3OyB0jn#5bc3Ox-SSTrnenMuT~S
z8SevJ5Mferv?rWaf21-uUkL*k2dftrJGFZ#f2+WY`HU&Ee(dfXuS$<SrqaAz;@lb<
z_#SNo_H!2BlnFyzV7Qn(nPQZPucd`#4kS?lGVE%^(%h6MLFG(U=V(9CEW4<{xCUL@
z=Hb*p!YSI=e>R7PEqtN*55h?@%-aktCN;ZFGnp-{@)K6r!6>LJ?|O}$#m4Fd#kqb$
z%Q`C10EFz|d_#rE=|#7$j-73;PH}n#%7<&a!aZR(Bn9gtK+pDH9=%7)vuS8A<PL<;
zR-7_Yylx^<g01u^sBOso{VRsWwu9fJR4FoveI`gO_utsLmyIf!A|?)#?UA^?FV;(2
zK^gg3L4D{N5`zgLx)n{2$hTOqi7c-BR7k+xc!)xX{X0?{mSy!dgTNckD)T^?`TU9w
zm>ShbM)&?%$k&xIUNIF}c6$S9`Z=zHw=kVZW@1P;G21Sd_1Vy@_|}lvt1^ep#x9WV
zmhoVHZ(tw-?MZrp$|NIQy7NOdvZ}ay*NMLp#acEfccB$aaV}?A?}%*b6#g?b9hX}$
z!Z&eLy|tBh$TD9Q$W`xlmxwKV6Aj|k-VUy}QgKrJ5X3m19Jw_$z8C=BI#4^fr&+!!
ze`BuNg~PCGn}y6Xb+=q4=-AY%gVUl!Z>QG;fdRmV%NLD-847AmuVtq}{5G`6A;qZ!
znxjO6Ep9Hd(LDm&Y#E^+-RMcwG<*qD*NgEF))BhPhEUKQ&s)yK|63WBBS-O8sVEi7
z9XZ!IA;OuFx>Y4pz!*1?!<j!+WSIZv_@fHU9zu*d1GN)_VmIXi(DlO?JUf^`78Vb4
zN0~kS<aB7^mTlNmAf23r^Er$a2$bF?WosG9)$Egkj$|{KA%qO!m<}qjbYH-;V|q#!
zG(ZZN0#~ou@g#P3Zu07utvYs@#-GM7`(Mx;Sz&Pw6giYvRst36L15c?eB>2=@5m8}
zhNqpFht0kUBnc&LsWpTzrdQdFiBU@!#Ad+K|G`d;&%RO0O<sERT<a8yKL`@pL?zGj
zK-@Z8P66p9ub?EjS$3<uEChyv)Vrg4mlWjZ34#ZGXJ@lB3w!6&(VX!lZgof}tbP~}
z!<Tc+8^P?NHq>CS@L#kQ*}<ZbxLM;^u)b-lx{MQtEv)`_A5M<i?-@yOqBNfeYx|62
zqp!4n)816aU@AIyU~!O<l-|M3u8I1wgP`+}d<S6CavR0MV=66J%juxtHFwdW(<T}<
zZ@?b|zyL7kC85xn+lC#ZI#K#bok6zWSNc`7{>8hj!ni91{?dT`E}xT6uorUPIFiB6
z%FyU|+f14+{eoQd`cYOPCp_|Z6Y2(j<YJaPTBR!KN=k88CXu6(2jwZFGlU~IWz`;~
z%w3(_kL!4R7eIeC6l3D9kupWA)`VOr@bD&@euq7c;P96%#R@hL-kt7ESTgg&;dmS`
z7Eau8;NbvsgejUhQUmM0vy!D0#m|IxpzsB=Ial$y3oS*4uuk|NdG9f7)nvhHEAGn4
zYFj?I(s80c|IieUch_8DRlOMGo?~16tWK&5_Ce*l-UT%dAw7I*6i^cWJ2tpNZqoBC
zTpT1j46EU-NJjd>P3aL=GBB+Y1#4J5ai#Rm2fn}xZ6dn#Q&eHN#!(}z<VEQOyad%o
zl5@a)B#>=zkmLxELO25Ci%PXax|rU?pbX;e5Jk?ol49<&Y)I80wFzdH;ym&*M#7I&
zL9)V#V2l?=<clp@id=HAe)N@gYy)cJ$g%^79%UZFh!U6#@BR+lu8SujB~YFGUQ%N!
z>SjTrU{8#cUzgWNDh47bKYbCvdWTWN+h^K>oS}7o&Qu3#?H8#j0#^_HtCi&D9B($x
za?`0#Rd|W9(zP562*t*3&*(LzngB(dM*nEW>)RUHa_q_bmoZC5^MIgp=&Q7xFCF+n
zwBVf4OD<BnMr{x_H00F(#B)5C(@G}fAH(SuyL#H`wHt`pSRjH@ovyeofjAw%B4c$(
z_uK6#P>MtHnl0zU=K1}^gq*gEn_r)v)^v>Aj989+Eef0vRf!q_HgeMl)ki;+v#$tM
z`=+XOX}kp)kChk!<R>ZC52!mZNlHr{4<Y_hMX?}G+++a9X@g=8*S`g&Qp>tegeKTk
zFvy1%Uzu9YsVspOwAGB*!RpdBWPK)f>N5q-%_m=ob7#R_a!6vtgvMx2=18NpJC{`(
zs`5*|i%WN=rhkFiQ%M9bNzD*`ednaG&u069atn=j%L3JkBtMd6hhG2tRP%BE9c0qr
zO?sG1R$Mv97G<zC|NTKUqGB|G=T#~VyIf^RLeO@#w!%1_8M8g>cU2I|72Z7JMO=}%
zQM~#}e1j@0kt?1ucH`9m0Scom?G1TF`NYD}g5>^-h^7lLvrirRX+d})fxX~_l-AgM
zz8;6O(HfzSP|JRET8Dt8Kt`kC(hm3??)HvS5<p8dTNhrW7bUf^=Xan;k0C#+cU($=
zT@oNC8D1s@qzfv~G&)sYHh#F^bbmq)HF5DL=EpDj#!p|)Tmq1CcwsUDLZ+R+x2+O8
zjB5WZBd5>x7zY|0A>CK~2za=T_3Z`e!`3><t=fekP|yi;7=VX5d=63~ic80|7+4Wg
zSRS~D8}?a<{w4nLCTrG~9r!3^1&oBUb3&v->2{6)jO4x*;^N(3eyEx>(X!_9w|64p
zCDLiE_?zK2P#{B#4~rFrH3`i^5}uzIKmc+DZgd)xhkl1k_!|W~1Q-%s1fD3<ei&Y*
zTsO+o7!`1wI#jk=YX6swaBFQQ?&ZsN!&rIm4Z&r+ok_Rf(})w&|H04XdOe&bXtKU8
z?f4V|JQ7Z4Aj4yhoBJ~AYGZLfqR*Y4HH&e`Jg!X_6FeL`%ZdVjjoCsrWbsr_S-Shp
z$RpdsE}omHU%vd0K?Ol8`H-B=$FY`3HgVDibW@?ApZ;+10>isn%Ypy)WSr?2fdTs?
zJ;A1Du^#gBXhLQ&seZvhH-mp04-Yq6#B#xcy?a_5HFiz4-?zttYX;Q9-^%h2{f^-@
z%|tf|R!CgEC;cu`(E*WI99f<;q9oh>2csl)HI7O1w+_pI0+3vC)~jf6Ni8Juj0tnG
z$f%inNNmY0Im%nC=K)By^;FX9@L_I8u5KYN2vmeD;cK3THt!d&tYrT;vwGPyAPgyE
z_1cWf8eo0*K6o7FW1JQzHSzksOcHFnCr)C31UXjX4)iUCTOoFCb%rhpHHsVPSSQ7*
z=3%N2pQh$L<}9b9(kQT*oFMgPxXdlPMij-TV6<3GJL8yAtGfMLG@eTX4<p7YoEJKN
zHxB~+hsK#O!yI@C(q)n=vWPIIB2`-%U-Us_Fvf?9xy1%L7M^$+YWwinV~Pu9)Kn#(
zwNS2UBi5^-CXvm!c$aPUht9$i+`56UWPhy!qX+bcYR9B42)nINa3<))p0?C%*`Fxg
z*~J!O2Bb^w&qDYfs=(?)n><wV%zSMlil(68Xa=v&FC)2Y-V%zpFqoEslE$$Qwr?Tl
zw19x;wjco=Q&zL)pp2H<R#-dm3NuWwwu5qhtCs5m1Rg^ml?yn+spM~OfR?AwvN31b
zxnX~r&|Gcdf)%H^$*Uu>rk4^3CPHKNizB9hl+0~q^r!`V$s=*74$9U=DI&->kw>EP
z&<6`@>#j_>Rj>hIu9&xVFHwxWS8AV?5z)ejBRN+pMgdvT9+eT%Afxj~dQ3dPN82AE
z6;EBNT)MjI+z|wHp%%KKJMZZ`3V0t_C=5flWSn`rpp4g?x@3nIYM)KH^^4F$3uTHL
z5#E95kn4E}M|*@>3@n0L_AfLTH4ZvkK=2k#bN6<rV_9&?D}DhtFaFJ?z{Ai7BJDUD
z^u)O=kQj)VzqLNw$UPXsQ_LF=Ud1ylcq*=^lQyTXejz1V$$#?#r#Vke`A3i$BI9tf
zdznmJGylv_J<!XDJ>#jFz+tjf2LL-%Kk)Dt6)iV|tVMd&w`eadYi$*`hj4AcJMglJ
zYsUv+^f~cmT9pq9E5T!f2{^TMcajP1-P**vp?jIfmMH16?j~f!r}uvawJSji-+tGs
zgP?{=<N6?Iw4%yfs$fG_cS}=;t=i=QV2n$Yx^+fX59e#2+=56yGC^X>>W`F}&_Nmt
zZm24=0fQPeL7L#LwrM!-n@FK7Qgivr83r{wpcAf`7WJvnac?B6RL@`bWfboIj{+z@
z<4SY3%>T#eT9>jRVlxD9kM|eiwU!E3-S^y-S_%v$Q-$&n6%O%by*C#Sstp{KXOI84
z!ckhg2sIS8-+6qGPiO0%Pd9yky?Ga8V;YOe=2W@dm7;$zW#4D10M5_Y=9gaIQjMCE
z{Lm9cBpL=?0XiE6hxv3mJjB>1LR7B5%QBxlW}(n~8S^~Fl+4g^i>+&g?d(doa(bbm
z(I5y1`YtuoEBx?~7Rx9sSC4#Q9^T5l=YSMT*XiX2?xdz66Md_gL9iC-X~->UAHn)|
zQ}!HnX)3VI3^%@zpS!HzR`iWf>^16hNjCp=KgN)Upt&%jWmoFN?XY9oN3S>Sj9^kO
zm*d)heJGbP1=UAn`r@{RIhYu!3M(FnH<G@;o!R)8UgRaEXy=gBi;fX9s@22dyOl(e
z761<j5T(+*i-HL;q+fagDbA;%p^8IL0C>(sLE-<Q?wx^Yr)p6Gbyt^WfDuy%5Ik+1
zJU3v8xEpctfDJE4T(HOzm!nq*SX*;nY$_yBi2llq{yOS6)!_Dlp*c;FRV>Ew2bPL@
zxW(cmifvJ1Z?n^>ce_!HqF)$ORWLkbr!(DxW1@q)xamkIr@2DB4+Pv#*wOIA0FAN?
z?$&dS&-%;IrFeBXg^8_-5mNf|h|!fEvcRM3j@|8`EqSES7ft-h+Y`ajeF>Z?UQm4~
z*$(q;Zc+X+rA=*BBUefY1o&t_r?tsYQOK^T3;b!fp1DyL4C4}SB+`FE<dGsC>5@SA
z4yRWRhSLE79!MeisLJ}M1d?+hO|mEZH{I_=aclY4qS=u^4+gHBA?0%>S&$WgE_pq{
z_RS-;az=!tzTM}-MUQnc%YIH~mQ2@jdpGpX)0x51u$#U!);kb0JVWA$D`6&s4b5Ca
zOqIHZn@l3CHj9(Ckr?y(Y`x{2qzFK9p*SipHfg-EaF!LKQ)rdwV=d8V=6z2fX||b{
zAYC8}?Vh|=yC0bozTXYm{T1Cp{U7H;umg*=YjEmvu3ydvT*8z6J0Bi1`7S~<3npu0
zB-4qG@C}YtpI43L!WDSFo0!HV+=V;~UEc0p)ZeP0%_YEB4Ds|jySZ@H-(CvLe>~H4
z%Jc5CIGNimRNJVX*o$<ftL7Vq@sY7JD*tYTwt2-d%2=&Shf#CM%3&u*sF4?Hk5J2h
zZj@A!E$~uTl2TSD6MYgM+eu}ZdgfyeqhcrA+Q1mLIbLfed@x7R#yAq31l;GvbQP?^
z1d3!iRqUM|G8@zp;-LI9n_wUVUTohdERUq=v=vc)>RX2C>Ye4tY;6xOz&w$h^)@)m
zyAhdkc?61UNu!^5gz(Xd^%`$6hY$f87k7XncPQwn<9Qq{FU8Y@6%CSid5G~CT2!A~
z5cJ9!m$@+9I*IBu5(E+tfru?(`6DsC7&zU6c>KM?#iQqG+>eUYT$b0VSL40gK^Thc
zdIXx{GM-~TKm||Ml)t<7o;c|w(F|zLUJ*VR!4D;TT?Yq_1sXtG;lT+A1~Q(nL}rFn
z^&kEpqoO!vGFmY|bjsJ549$s_2lg#7jiD;G=uZc^PKo(yVHlmmSghup<u|)(J}XpL
zyjN{j9D&otb|=3{UWCDeI}BT`tm6YAF3^R-3tWH!!))U?;d19)ec%4b+{n5;epM>w
zRJQpFVDPDY%EiEq3kUW3F8q?<kvLBgRF}~+XHp9~R}vDph|EqZY6&Lmlfhfn41vH_
zD*DIa&o6)C$HLI=Ga-UY-8mR<E|smg;=qeTFIQN_!CXxgv*+XI3+!$Q7J_H7Fi}$(
zsVU-6+4@Lr{8_hnCNROsW6Z-XLKg8CXmJr&gWTZP5xPxtgd^+EO_yoofuv`SJpV>b
z$ZDF1?e4zO+iPWq3-iAxo3_vch2LqWKVvBPHswwmBPu_%?>R~;dX1u}-4br=^~R<%
z{MK)S2`?^s@tI)U-^IKdO^hUtMQ8{^*pq<-=)R+Zt~kG~Rl9oMKOnjgR0o}h@?E~u
zQ%79~ghK$q5>3Og2i2w{?2xGzF%J}=X;W0N7V(6=JGRs8JBRdcp7QY1#%{>hh^W9r
z1m!;p(Hguadkd|ioOI5D`7Rfw?_KM=B|QdxX8xQC^bF4;2z7m!uVF{hZ1d$5QdQ^&
z(Rs;{G&9P4L7VQMX74j`pk!xc+T{h4-TP5jj=a`4TbxBb9YabN(UF20?#v>Xg)0u+
z3|J9GbL2(qKEHSz^E)U=0(gW6!~%D6{<y^@VTJHeBfhR<se)%8ry9`gIkba%Tk<<A
zQBU7hjFy~zrGwnX>xJp@oRCTHsrBVaaqD!7qsqc6tbC*~Gp&79de4-rz=AgrHS$2R
zdl?C4<``JVc|_wa=&v$P*6GOzKt_8|?bxxQbL3kL6VaA*B&CzE4Eg=zrIIyDx-?E%
z)v$&eDstn`bLRrYaIf9$xKJmFt31up(9RVkN)`6~wa1pkbMkvMXO?3WW$?FWNd@83
z24hJ%+7@wFXT3I23)N0SB%~uJ-`i7RbMa30H11*9>Blf;7gq!p8)Jk-`$4_q%&c4}
z4HQYiF#=NoL$?hgDK(6ArX>*<M=0`Qo%0$|0CBd7C&9ERQa2PAHVVT0<<1S(*Wlwu
zK<#)4ovb?=fB>xNTSJSa)m5D+<xfv~S+&_A*e@k(nnr6FTk8~2VbOZ-gJT$L+5KFU
zvHh&XQjSKLk#|!=xGxUATq*vuHS5=jn-_CXS^D#oKi8_c^HHNQIBVw$%g(=kqhMJB
z*s_p&F~o*#89fm5+UgaejZ<ZWVJO4y0gwOjD4R)~qcAAGAbTarsre3PEg9k^z>DIJ
zr{_hHC?-lrFS@$P`c&;b%-cX+2viPZVrU5n*QKn{rXOL8jPlCRi}=jCWNZ^~H(Bt-
z`4g2HrQde4OXtp^AKhGC%;@BC*#Y#;Ew=POM@cgnB!`y4zE-b<NC@ONOF%lz@-t9r
z5TQahF;>dO9F*r2qsbS!$;Dk|KMmW2-HtDvb_Ch<&)qCm(NZ*QpF)CRf7Vw4Xsrhs
zC|Ea}Zi`|y_7O^~SA0%~qzqZiiksO_94yGdj47;^-fPHELgyo=MJEtRnD8p>m?-FG
z#BQCRvbwlxZr=qYUee+%NWM)2(tkuJ&cR&f81ZeiP8kZ*aZEo1LLf3~wvHrMR{Sx8
z8@ojVQo%b{?W=msJ~U%K@ftLb-z%|;F4nsgm$t6>fp@cDkWWZy^boWxJvQ9YXm(=)
zW&)I@c!AT$dUW#WWn$s8mc_)Zhz7^|d7~*gl6xxz$yA$uC~sBmdfsEL4u!g^sjTBU
z3$U<hITOJQk+IS{Kb`=O03oVUGuS9jq2=Y|oE_3AnC7~xtGq!7t9py9yNJa*;sV+2
z;3-L^vY<az<2-8x5G4>sFB<f19p_1FsW2aP%Mn(%YGR>IFq`JyBFt@w6`W6Pp=XSk
zzFJZ*yZTNOsP-SL!ZLNNkP0_y&u{5jhsuTXh+-<+fyAZ3KM^?VtoP^xd@v{O<sINk
zw4$GE?iX5sRP2Xq$4XU9lQZSZ&ML~OXZM@fBFa#VJZ%6`sCUhU%TZetsdt1gm3wlv
zUfXfM))cI=Z~?Q9%Ilq&kCoC5_5_SxqL{}<xk8T4S^MB!6tAqEqdvM~L#_Ex>zHH5
zgRG^4Q3U-ks1YHVlOKm!kMLvJe9GNt;dx~Ef4TAK=Pvq#^(Px_FS-=~x)(=cX8w+|
z)wz!TySN>OGW}Yqo-zo?>w1^0QSKN+z%Rv^F9qvzSI=DRntvL5dRx83Kgxz^j1aSW
zkd=*{#u^5gePuX`Dh@NGpo!Qi=uE(kK^^CYOgNeC3BvBcUz(RAU@DKN1%(S^kM@W;
zUS)1}!>G!s?e#q2^_YL1PIU76q15BAMEx{gT0+5p)k@_1>B+l;TGsa2hXtBa!_yn%
ztpu#O<bhyfJJiSnspX4qIzV9itImb@{-W||!3J~V%#6=1UjHwrzb|DTDu9R<=<WR_
z<_hL_K$%P#QLbdh-R&fgbw>)!c3(3-$3*r9CyEs+b&I_5y>>!A+@S(91ovmh2azsO
zVNhSMlR7PiUS^OEg=tMi{O)(I^yDH^M-(rCj>B!i-zW_P%#9j@jk;lc=T9ZH#%y{N
z5oC~zCXV>oHoI&6qGP3bgoDz-qEcO+!+#WvwGzQUfBc_T*H2dX6O2wf{C7Zc`#`bI
zFc-FO4i%c-3-u=*?1j4&AmK+e0^vkoq5*_{55U0i_RFLn=J~g5cs(CVbawZiW(sxr
z6VLQtVgl$b-Bo3<dYStZL{ePW)xu{Bt$Y7l5AJ`Hl`ZJtxIGJ8i3mz=iW0@F4jTyy
zlej*e%^HRA;EgLbE2bGu67rk|g_k_hHG>@qc@BXvS7OHpxzH~Lg_+8vzjIT1Q-W}w
zOm57ZG%Zrs=V$l2rITzwZbKHQERQ!KC|GyrV#6RkBBZ*m<T{tPn{Ub$SMCwR$PU#8
zX_&-O)H7HQITr&u7*geb(IyviFcVYUA%Q01k9IOQD-TN0{J-6yOA(`5$@dJuD~8r-
zjhERG#1SO}Wc92H;w%af$+4C6)*wQ<`5?B7IGWC9)0EH>UrC2@cI0m7#7vTx;A`W4
zdOeR`|5q~`eKz5r`E3xdH#wv!>`-F1+!SJ?DYeitbWLWk)}u*VE_4*D>wCbV@lu!`
z%o_n7Y%X<*YfhXd;a3{gD932<9X#)9JAJ$b&y4$w1{FRdFT37(MrR|ZBqb&{ZESeF
zGaV#Z3HW2UiFAeD=C%vz4K@ml#o}^T$4PwbSM@Zi0L6Q<?;=GMM@qI4i{kY%bitvA
z4x)?*-%pljzPd@$_>rN4{}MT(X$1@vd4foy;=tHjv6!bo`P!^Ha$x()o>p|MIal=q
zJ(3@yF4`8g<SaRM#)XWuOZ4_FV1jtRG&FxFR^T)M)2kv(lJ_ZSpO!!#W;D{GaOxC|
zH<s^o>1<*yWI=-dh378RrJa~JxT*x}30!jdYp3aY3c@RW@<_-v#+=>|%QvRQMW-*9
zq91D<>s1Qum*M^QwGNFpuzh3{RquHN?JHR=E33(Ar&jryff9Cmq|$?^dIZUNJy@Ii
z>+Vm?n|jFp>qa7fejvg%1r5nKRgdDU%d4Xyq!x7nN&0KGZKRci0UhDeRB)>ILd0Ou
znL{O4f1WfiN~R0Ea~EIF73^bpS&l^)DuONUeNQF|S}8?-kR_ZY>II<cVmD9#!jc#D
zb#(NfDEh?~x^Qk2qK9oYCfoG6U#Y8(my%AsT>){gbaW@th5F9S>(ysbkd7Fyq|M33
zP(3-!^}oFgJDEZh{uby}fteto`0mnw&Gb*(K-RvXy&U+4h~c(ycv+w*IDOQ8=B=!_
z?uZiyY@_|FT3*u^x|V>&Ma=(%w~tO!vwUF*cgW<~_SPy6k)nLI$Kog$P_<*Py8<w?
zNBr;m%QMwL2hM4`f>ekO5-B{V#x_PB0k2Bzu!WsbMzAYRf_R%y41LF7vEIE+@%N=W
zcuz|-#2j=32S*O2#|Kmwb#C$@$yVGsvzNTxs!yrTr}aEDkRR9bTqzeIFf*sV=%-9q
z3+0LoI?l-p`dxKw_y#;k4al)ox4e=8m^wrZ?ex#-scPJ~T+3Jw2I~SpeQ}oWRiLT?
zq8d4ARwh-R3TrehM1i29FqKFy?d_-dyoe-d9D+m>5X}9QmVbGy<2hyE+vEm063!gw
z9P2!vd=fhP<i*C!%GmK2e(ffWdt2k2^2tPct0Xbr-@5ac@1%UKU8QjM(@UlQPi%v`
z%tqjv{I|H^tH<#U*LXiWEkaEG*|VBS=?-{+GIGXMX7X}>+1W`h!|nPQa;X<^)oo=0
z2#~S(Y{7O-;W{>lYRj1AY4hv!eGt8L`rQql9Sf7Lt;Jtg%D^DEfi?A!K9S^cU$%cW
zLKfzLA26J%EZ#`~W$WZS2~-}_tR;Ssj3oqz3oHoU?+rdyum-x>OboEFl;noVGRv3v
z$9y$a%rwiJIm?R<ScTED=tHx>;d6?jTPlt7-tr03JJ1SR7PxvJMJg#gIRT2n*lO>2
zGN45PF?u8xm)dRavv*MQG9Qt{PE`e(5TYG};z<Oa46BuRfUaB#<NSLw)|9>JqOL?^
z_HI#Fe5y+`#HI!U2xbNYiC9p$SqpWr1+YZL%$6@i!m42KY_|b`twAgjQJE`Z;(AF#
z*I1uu?fF3swwVkfj!;gpqj{wH9&2Hefrj}xP!N1mx_o?f+K0mxl~}Mhlv!djDzns!
z0PW_QPQGqV4gxyDZnemr$}?sXX=G>MsK8Ql^LDX<PCG1Rk#7f_dXl`pTkQ~I;G4QP
z3iqdH3pWL+bQGrfEuN)UibG8Q|D8*rlNNWqvgSil$De(TX5#h4hVu@aZDN!j5#cA@
zpv+lyl|rh{im$)stN)z_AJ<6R>LKhl>1Ap$B#Pr3cmvgmS&_Ru*{t}cr2eRTkkF#!
zzH^GWTRVMJne<*zA!ha-68_hbGPfakYU>01jKZUJx1Zpj$X62h<cz44c8Q_|7V<W&
z#Kd|45f$9weH!={pxbWK&oHfgg%A$#vt>=esP6Dj=cS^S?o$=zX%3C^$^dL%evzF6
zD4_<66?v+=^F#MA2Mrrl4x2QzW!}M=`iDLTfk30~J{gh88@;%mwqxNrSF;Q~t*tH4
zu7?WGRH;An_Jln0c90f&YO9)P>t^cPvl>XYqgdlI?CaVFMZ~$y#U_|5pc9v_&F~(<
zw_N?NU{+&bsZY$G=l99l_%lb{p(Od{l@!eC;yGhB&O9z?cu#Juvu}QGWcC#W(^oe-
znOGZa6=widTh?kfZsDc<kR>|B8NyDIJUF2#C}(Gq8Q!szXQ}KG=W8|VeZaH+6?6O)
zJ9=vGGM_YZG!F!J4^U+Cv$17J*99_+ln{3iI(W`u)uHyEY@{&=hA9_Hwz>hQD8=0v
zQC!A^gOCLy^a(!;)wZEF%?C>HB8A*L5h8W%t1Fu=TMwP6B_I#x6qQlVB1NP<ITTdY
z(Ev#~u2FFSN+&S`ggDIwP{cQs)Q(K?%SV)5FHS3_XniDxOvi!A7C6Ir+NIsNaCaS|
zVPY_a{$52F#bw2rYaXx{nCdE$xTg#ko7^|>sH34|`aB>OO)vbKW9~h&M^AZfjSwpa
zt2~EHlkHPWh17AZu-3xFEDTWYQ@U5uJ0hh&8%1GB3_$AQHLKpelIVjF{ZKg$mh@ls
z$QW;Az}gLWuI!De?p!<ZpCgfpi*F=1(3l)Oapk<a)p~x%8EhvXzR2rjrxz|AOsF2_
zuv}6e$E5;8hF3E10(m*$S(AflE4Q!)j$Fb5*PIO8aim3C75xvrTs{#cqP4a0cjePD
z&_oQY`J5v5f@aV!D)yvBBwgDnPN@+S5X9<wRFag@8w?mHckx3pZUH_i044B#3XU%k
zZNXq_0D;^}Sy8bImg(iqe#60me=fk`-jy{o5tU1`<HLgm`9i*Aa8oVGlIu%HWI8?v
zLW{1RC*Z?a_XJ-7-Mr9i=j;<ixbuHj9-~FNV0qBs{939Fys+^|r&_?jg^q;y<(iF=
zp0q(oF;IoB|88;)Tda(@uC{lR9}dlgMa?#;7s5W!?JTd9KcL@ldhVVb?Hl@Nr;xL1
zyMw%e=I$sd%F=ou$pj(=KG^~6k2O9(p)F<$KWq+gIOC0_jb^e2#V;x-S@_Es#q(N~
z$G2gHIL!r8{(WG18CQrbZADOO55~2VFiOoun~<>3K_u;3JBh01ycQ-yz+jLe80~mr
z1ollXVtn+u6V4bQN<bApGBNUgYkPlFE$+Nu0aAznTc6=`bo}*$=zgZR9TU+PJRtXa
z1XfK&WBd^`gP|%(I65ox+mvXa6$;?AY!EeHAXF^2bqZ7Z8mF=M$75uuWD;&r4^O<X
zBd56qs^sBLgizY4J~o&%|KD1cG&T*aR5CVpstjWqC@wK>pVtX}H?Ht~UP5)_{mPut
zyG*3~>?=vPVk|M;)n0g={eA%bd=-lt!_{CHqXrHwy9;SJ<Z%f#@IQD5Cl{8UPgkY*
zv?pi^dg4#Q2|m>yb7LnUJgg>cG@U-CK3+yXTHwv8(i0(ZW!L2-5cV7utxKI582|6q
ze(U6U0LTS%!I9F#TB0{UlZl}(iN3wqmdu$%pLsl{6+3%d_I!f_Gn(;vk@(QWSnH6K
z;G<`3gyEZK)UR7eb|<|^&mk9HRxk&D?O#DTkY>ExA2mn~tk^?N=y)ugFIIFfJPo4C
z05?F$zf6Myv{C_Nm}D5Ks0*(cI0*!sZ14f_$z@?w22J-mEx5bt$Wssk;fv_a=-Ut8
zH-%*)kX|Sx;A<#B%kBT~l<R}EP=&+6?qUje)v#JC3|5zs2uNrHw|vN^T`3Ftm9jGD
zSRKpsZHS=+4wJ6{!Flp;I%NwG^^&i7C-pubZs9|v&ac0C6L85?eEKXu+(H4U%1HH>
zT<DeFtyPk2m+lf9m?zu=?{<xwOpFhciAHu9o~)`UwH&rNewp*Hya!5EE#$@)o#~)?
zfFOoX__M`1Tc?d_Z~yj_9+BUp$cDf*Qzs0YL7U~fGo_-n<mEJm6Ylz5;mzZyHSy*`
z1Has44YlF%O=Zg^=5phde|<M?y7N<4D}qYDGs3V%wlpEKCv{O1&d9R~*4w~3KKM7K
z3K2Bh41LUD;Q*6jv;5n6s3bW4YP{0Ej|^-zh)wsx+TuUEVMgER2s@@Hw5t&s-$f*<
zQz|V#+Ft7I3hBAMr^^>%*`F}O`ESK^2#feyD&KkJZxWUSD@AXrGLZd@j`W>2dvqrQ
zCh|3f)Q``vxI$OOI5$BM03(qy#nF&+m_ffN4-7oP5HZAP${hU@0^kwc=X-WUxW*I5
z8%_eCDzoA69!`9C_2H|6arcd$p%-fDsZQCpj3JbUiu3;puaGKoy#MorL4@c^*z4|w
z=}u-a_YcBN#FDpViDKXtx0l<gv+el1y#`xtf&xCU1#{RFP138fFSi_)5CAqVt3>6;
z=fU2yTcuHL+hfcO(LHl<6###8Q2}Pnu5^XL@)>h!Z+Z{cgHrJnJ~GHh_sQjFWv|(G
zVvd(G!~-D~1Gh?2k(eGSzO`_5AyDf~u1I57(>}xQa%VNHO;ey!bnY}>1O)i#dRImH
zRTmG<L75Ils@whLfZz)#6bO#t<aA3R;v>7Y0oi$Xzf5>D+{IrM_fAX8je@ljw2}vH
z>04X=nD0UY3|VheuJ>aTbR2p6!T5%}r5O-zz~RIEEWJTW2sGHz159gadej|%=j>31
z!`U;Rl180ah)<r#><=uC9_BsLvw5&|?uW1KN}snON$#7t!gx=AL$x|3v(mt#HI9BD
zJW;nmB5DAy63~S6GF5_q{ICN(qB+&4Q08fL(k3110en*ZqCD$uM=tloT4!-y4!k^4
zdE%{Zq5liA!r`&-pF%2FkoH#2B_`Fd+}cfu)U^>FDN;p`I;k#w=H@vzHajyE|1S8>
z&NkZ>sF5-&OwHaPe2R!WYk#DbjiV~=%`NdA39Lc2Br^Lv;iIKN&krC_6DtYA?y1#m
zlp4q+^xI}ksjADa{tt3@t8<-xqbn<tB!?hRzmvSdzR>b_PTQ}ZBgDG72)mg{KtGe{
z*P$<SI3)Y@hXC?JfFadu^5=jS?sqsV$?j|<+zJ{fV%4|XtTGmXE>V9Y89_KVzh5cQ
zcK%H3T3q4$i3<dzxb6!%&XJ@2Hw;|~Abq4ON!FdouVyi++{iY4B!%vND?GfEa!1(B
zi(4Pm`?*WgSke{8hvABr=gLq;rqN|YOWC=NZI6sr(48{?Jf|A6ZeKLXfQNk&hLr6n
zI(q^(&DZP)msMgL>Qw9e5&-1W|Mdwp4-F2$A|p=P=QAxT=VpNO3yh1KL3Jv%S;e#o
zd!z|_Gk4>s-mwGMzA(MmnN?(nl`uDy0U{7VY9RwzRj_^6X8vv0o?$}N0GC<D5)p8u
zI06ggY+~sADt@mj;nFwfvOuYB{$_cE$&&!itleV5(U|Ls=H}u>+Vcq$B&G%4uQ@<R
zi?eC+sqs;Or<;Ag?7*$doIE`mfr{{?>@U;_0#8J7B;xRNF=v$&1MS+#n6grCh(G#g
zD|!A0xq+BLKn5tuq7Rz=Pi^r|4+(xWc*tgs<Tr9pUM72=-_^!f&{@A6R5o-Kb=+#_
zAsBs}N9Z%u&AXI2%~gbo@Jw>b(%LdKiMMj0`$_tRvh)sq#~Lwe6FQl7@)c0px+g`b
z?9ok9wmERq8g&Qyf~{&{5C6)(c4V8evau53X!w#RkA`|4IX=!cU=$vF)M$9B((AZD
zkzU7_|6pB(|3&@1S>&kG%F4~i(a=ARj9!cWqw?TYz)Kpmgfb+TtTkaPB~fuhcEh?^
zmkfJ(`Cg6IAF}y;j_3*ZRz*A+yqB3F0;<VAI#Sk<)>NFrL{^54l|!Wh>@5vJ7|#YQ
z&K4$|wQca-*^cwqLO?1s>vojMDf}W69CKP%6wf+I=9l>9nJQ<1=!|+2Ga|?r@u5{l
zJ^Bj8#vP#mu%#egFiFjKd~0Nz$P|DyuoC?P(scw(VZ_@h;Q?k&qeGDj3&(OL`E$)y
znR+dcYkoOg@5j}>TV*;WyHTA`>zBmHd)oM{?`#pWI3Zf4_e<&Dof=E!GwRkWEA1jL
zGdWUN6#Gye)e_|>!7X3dpBMUF9*`5pc%YI$V})})-BHZ81!REyMqHSl=*mvJd;A4<
z0k9(FqhWb~UFd!PA%2ew0J~g4s&fT=Mp4Rs;OF->!giR7+Y(vDw6Bf|oHl$zP+LgD
zS-g@vGIdr;DfF_|D6OPvPs_kazf;`-5^a!Y^v74@k`$C^v?1{6g(HMY6yfL}F^d5n
zokapc3VrYd!Wvqn4Qv4=*Sg6~XoKeo>Cmp)@~-L4F=1YQVEtJVnRynM8n2~mc$mT%
zA&-74mu7a=RBiJbJ|(M+9n0CTrWS|ZenrHgj1Mdd;=pkB-zbe0F`2ny?wFxD3|KX-
zk<DCQ9hdgV0Ph|L@bQ}Dt6d!U9p`GjZh>vqF6FA8nxZ+hp)p11pI4M_psWPDTgLvO
zNG`0V`zp79lvIve(l&A0m*a%37Q*@sMX@-wN<$0O6YeW?9n{m%@Z!@$GX0L77R(Ha
zX#3KrR}+qB+f5w`>QvL9sS}Shh2f(kRLYax9sCROnJ#%#gmRBr-gEWsIca!^e;@(R
z$>+UuAXvFElff$Grbe21@#SWc;)Q+DBzQ&$jTm{H4fAbnBsO~EK=|#L&SZu?--9p`
zxvlS1cn8(W$U^q{?VzY{V*F#|&Fmt6h;%j>kcnLZg;BZAerp3~vF)s2{AZK}A(Rdn
zlG(#PE6r9mM2kGtlyxHqg~_EWvu7Pm$f*@T@rT(XLBP+RdPlffN8iU>HPdsJMldi_
z0}CU=j=?*x>%gG`;X#l@#wZj_^wx3>6`ta4Wys3!9XJAXw^-uB>_)gqdes#ezFhzP
zB;j}^j!63dwSo^KpIpr+A(%eRjRBPV*hA0<ZQRZ~6p#TREfB#Eh}g`V{Dii5PIHTt
zYtRmKXjK%^fY7;=Y^ltq|Fpwd^bz<U4YkA9CZ1RP*&V&C(PcKc`CB`qLRnP7O??~!
z8|94<u&;7)6mSSA1et81dIZhQz!Ug`;+k{b4nUcoKD~2716)EfOOZZ@yCWS>$qYG<
zA{U=)1I!#@EVflAQ+x~0;QEwv0Pt0S{I!1gQ*f{Xex6wd-11dFqJL~VkW21wo7ZG9
zcG=ABzZ<-GO0C!wKmbC!L(f4CxSW}~Wu=<J)VeN3!<e%A@I={#8<veI4p)Dr<>#Ch
zjS5=ppZvgCv~z{iT|In$iuNO<V9EjVCp}$UnITM^e!lcd9a19`PLQ6%>nvQRRdDFq
zv-G~^w;9O63Tt()7w@rI4-^e;W9!$`N6kqt8*5a<3A4(q)u;eBe(WJzizsk^&Ud|N
z;jvT{PTaHkg|ICK=<|k;7cF+$9duJk^W$(HIi|`IXI<c}_yj<sD<#<(EsBHb=dp~9
zEGe>{zQ%)8Je{fVPLgJ^Y5)Iie(-uzHT&)ZISZITf4hx3#3kF_W30G+y=qArB8c}C
z+MkEpNFy7&`OH8zS2)O?KOGe}la}HJxj*nASE3IeM!vLEcAH}SW$uIPTa>?jKc~Lx
zfadnZhXN9H%zMsUyKE_#$byE9h35s^>AlL8BBL9ibj21Q!~lL|0m?UKk?JzY0jB~w
z56&x9QccGmIhONeX49}JD6RM(Hqtw|W4gS>9^TL<D0$OEBX-}_X4T??(c?zyx)L5B
zr*d5wn*lpbNWNykXTrWaKUl`n{hI6}CYM$bbEVZh6@;(}JPS~~gUr_ZqEUDn^IXU1
zyn+Bx`Gt`vht5XNyoB~@xqa2o%$ms{{eRlc4e(VG+{`f9dn@-q4D^L*YX8??*AMOJ
z$ERraTiD)NY}sY=W0|jNph?8eLCP}5g5rHhum4?DC#p|HaU+n3?ia}DjvBtF+G`<=
z+jkiRrz`lB`Bnx5+##4>mjG4I(FYrE93(5zZhNFis!emF%%FzSY-)<VOOj4xIqM8q
zj?hM!hbbid6w&+Y1|pv40O*(_OOE!0TanPuw&jezKrkEK<*^V0zT1HhB3Go!GpNQZ
zod8s0teC|z3(fO7I|oJn$A68CI5*jPETYvQsl|)EUdPPsmv?{0*YJ=-boj}{WUyFJ
zq}w+fUeA)+^1&4Mm)v?o#`xKn2+W{xNX_}T1dudp<oW`E$yX!EeH6zSioUjV=jL;O
zC-*^2NcoB;+`xULj`=29U|)z<fIqH5D<<HT2pMawHGq!8cSOP_o@}%iR?f0&yLVkW
zpf96th4$?F(rm3w^uu(BSs5<>7bDKzX3uPY*EzAp0y?s{R;cqelj7Dq2N|+D=ESok
z+=K*kkFJdT53e^GKOfX_Z-q9>&t0N>FvaWgm>qeYydi*|)>TB$<o_ucnE0){T*^o~
zQ0EF$t2G+~*x2Pqe9rZmkg#>Rybc{LcPgNczE&F3Gp*Mdhkj-1;!jn5#PB0O43@*e
zE>DV7%j!aakOjJ8md@`_+2)YdE5uy>Rj_b0wIJM1`V}rg?~q?Y9c~iJ4ube+8dne9
zBQ%7z;i(`0<D03lB3g7HQex$~whqzU{RIvJP5x8PN4%I=fq6LsgMX#-wP8i(>Qh4;
zPQiqe>mhsvz-ss-DMbkSyO9+{&bjr}3u4Jt+BhYMD}AOzO4}ZGgl35bARFMieX&T~
zFxA%#kp-|!2^_>S+G1aR7FhH3s9WwY_=3Oy9*V{&cyeA`F8>PS(^4ih1oKLN@y$rT
z2OV<oknP6C`9#Ny#6x_u5`krv*-&qgK~)@d{zcKSZ&TRrDGC|Wz!AC9_TpbJzoG;F
z#;z3zJ~Fr}e{VbLK=OSJCyh1}kX1HPiUVj?kgR-E2dhb?0Zd_lz0Z6m--E)2Bvzly
zxTt~2kFsaF5n~@YF$jNcq&U*})?Zd+m^_+Os*NyB1hiSj4<yvcTH(<gA4?Y`I<X@y
zGC<u7tX0HknCCmcsR=YsRRIiUP}>dInF^C%3N`aaYK7HFf^B(DE~68NJoHA)0HM%0
z9i?r0c52Wvq{=)2@}lzYvQHV_)014U51Ix9>A4eu<`SGlY`91_67YMbuWPrt|0@Kk
ziOewBohMB&YCI#6N>m5h#_;9h0&zd#<wrDLec$bLf$vr;>})K-PI-DJYZlfLP$$HG
zGgF^`{@jwLNbM)Ci^J%$?gzti0yc~2uT1}o!R3(UL$%x({tH9!R$aAr(+3*MtfLtF
z%6MKvsCF#2n21Qnl=RC^tQl36KmYycT*o?&`7~w5&n#<Db^!`zm3&uE5}!#n?HS%2
z4EqIX=;sfGweEMcNjA#Ef_F`2gjs@~=PHiNyq7@8whehiwOzg7J%N8e;Z0yHi6{0W
z61`aK8j0L@PY<(c@zJtFm{@0KD6;wzRj&J=OIT!99GLzHqD7vaDn3{>IGoPxP%|)q
zsQ-Aa1Ev#r4YvrrmOrz{Ib3YmcT?O4x~h?tSW2clGphwCv~B&YoB&F$`72J}6J^PW
zJz|`}$U?Icz>OQS>ggrR;ix09-hmf<QnJRmv<t83m|}bRfSH-##;3eY6>L#@Pv7a;
zz|Yk>3hEdq*G?<3iQL^ooB`h-Js`fh01i{T*|}8n0MM~MT`SwBcB&}pQFo^+y8I<K
zRT2b1uzmVv*h8t86fL4EXZ|jC3_1}Rulu+|s6`xD3(oZi8%hTz{y9i^SoKA74~%Bb
zOk%=Ls})%k8<b1b=}UTds+oN|)|jdK%XJpP&Z#+Z(RdBF3<&WE_!ma<3N<8UH@4CF
z0&3ybO%(z40YE5FTCz~okY^2W1oyqJHWuX5+g!|@%}l1^pgwJHVWTNgz94eGm|9l0
zna<^mgy+<w*rV{dWsKW0Ot+Z9ni3YJ6`u$D;#B>5L}!cjG>$kKZOlGUbkrd)!-4yy
zj=eu~F>b5zlrnCahdG>avpa}qpzyx{Jc7Tr#u^CJbo?o}0mx165!``4#TzNMeIbt!
z8dc(szTdLKkP6B<SYtQ)!LOS0K$RBFSH{oo7PqtMY4JWJd%>5^UPuFG8gIiaGTf1_
z&+wQIxJ~>faZdB$&Vo~uemq>sw5zF6ZM&U&1cZck#;fQz_%?g*KO)=u{y+5&cuFBk
ziJXb#H&L-TMyJFY#E*Qopl#dCSX-<`{L?wwwn)o`bCEqsfr#BDeHYS!C1N<Ap{3)3
zuy@91nH$H$xvN}H{Mf8(R&Ks2DPJR7d$;OBb=QQZH9HXpINIy>R+eFmDqsq|-vf31
zXA=jr(iilL93!*!NuAQT9Ow(mcr^Gd4j(%u|Ir3S1FdMViGOjVrcz_8Drpq04R3%d
zg36y`&E%`*+D#jpUkQ|M(H8_hWJ#acH#8k>(9$B2n@VF!h`EIU)zFz-QtB9qS<oy-
zyvnHIXnMP76b`o5)hlw#slDoiC^mwK4KTXuZY;#+T0-9h<dCaG#(ih`{2n3<aPDld
z1ww-;ot<M1u1c*?qu=4<$6i@;QWDtH7b6fv!EIbRyzB{S9kR{W4@&PC90^z@L-I2E
zT>wXyuP{ATS#sO4kwu}0_O2F!rY8%Eh1Hl@I)u)v6MOurpwbM$SRbKLp+nHlr-(U}
zM~xY;tK+nGyH^p-PG9o2I39+Ey{-NFE_slF`tTe!MSzC0=eX}(4xIP$a1;QCq-?!R
z?5WjNL0|G0SJJNf`lhO*;e&hPeL^S|@@>;du(CXh$Ta&Ns+Zt+jD(l<Ijx=qino^>
zaK5}j021T9lC*ky=D-~O9zq10SFJ9u4&LvRmIkkkEu?a*o{0QJx6wopZX=?nBU||z
z?Wad0zedm^qD!ZIg8k@Yorj{*-e3kW@2=Di=+CeA7#anOfF(eFh{<z}z&EZ$MC%&x
z+;!F*-dwBy;A)kfp{@Vd#bTpB_}+rE!Wz-h;#ZmDAi_|s=k0SJ>ZUtO!~O%)n+78I
zkT}PYIjKHskGc(v6e<?<a@+)zi2#K<!+nih_^d(M{Qt841Cy3}j+N0iOP3G!j35-0
zn@(fQYS(X+$=m{mtsGXtsa(yQATc_qco*psR4n3f-6J~vD{_N~s6dZ~%O(DiNUlqh
z=GwtB)?3l9$NcBDPjL8tmgsX;Z%}kpU>vO0R5J|)wsz0w(T3OjEXu7?ibquGc5rds
zIUH(T^I6-^o_RJNh-dr;H$D~`I)i>&LC*)~B!!xfHK^d7gKq-gXgw{$ej_)fWUYne
zXO16uHhw(mVT1M!EnId$J=Sg`(PPk}2mh2S{r~5XWU^)BfVF96RpK@4B8)nPI$q{e
z@;S3h3Wi>@5UwnEz<oC_=VABvQAVAbKh;&9e)ujf_wJKOZ^KZA0bfJ8a|3YH0lxI&
zIJ!i&kg#f_DZHI~65HMg46KD<0o+NPF<Vpb!m!ia%)I*Nal|P8#!^c#)3D_C7FJ!7
z49hJ+$<rsKQ&WYq2fy~YN}$T>qB-lMQQ+H2-bXP}Jyj5HEf%?jUxKB%K8#`x#!n3#
z+P$j=8Xei{R{f?&H$<o5Zp*Z;oQk3)eux;xrRI89A5P%Ip%s$?J<X|L;uli!E+way
ztGe5}Vp7RBe0BP4Cy+Y$d-@)8mp6;NPtR)SxWm5N?;8LfHwAZW=Ac>g!rL&`Cs6>n
z{>XHf9e)7n<MUh~LWn@&BjJ#@0Y>1wUn(8@F33MxnQxqNc@ons1RX4`G^v3?OQwNm
z*j$gbCj6y@HBk%gM)WNB*v}V+L0Yd^XitOTgW$(zb9A|{4tHjIi(jsbP0#8vA?u!;
zE2F?9q`12PnK=o80K*1yXm2#9vEwp$r!0q2Vj_CQhz^-40UA=%5d%HUlZfmp&P)Pj
z3IzLxj+3Ee$CTZ&kVC5UR+6)9Vlg>a-(00zZ8}q75r2)kdXP+@l`8k6{mD}bGa4~z
z1$rJ@+Lil5<dl5$?q?r3mb`MfRlG7tk`cfvnw@3aSJ+x=Vs1zf7StD(%^53J-SWiR
zm2j2SrZSj8LcMu}a7eDTez<UkgWJ<iF~WS0W_-8Joo0!1$v(e_ytcJ*e$rKXKvm>m
zij*}@7++6UcX|~76ZxBwx>JSa9d5P#X30c4Fs;9c$Wzj$C&n@_R|~-)U1I;)LMckR
z(1X-kOt6Gw!c(ZCucmN)kgSp++_eqhYsLS;MkmEUavAGpc$&`GZ4{S%?>TIlN(MiG
z*a11wE=TY%=v;Vjt6UFqPUpzy>E0!Y77Y1L8SXc|pS#dlSi~yZ!LaKvor*6s%`|Qn
za!y9G4$RpWlvPWFssVC#H0*i~9!IHEnB_HekunoB>EUyq4ApsumP>WN%gkg=Og-LU
zWO=tt&Wl!@2{u|`7t(wUPhz8^Wm*G2L)8+$tc`*{dmaMFM&p*<8)uA6bCypO?s_6E
zbvvXfOP)2mNXd3Qj_{eY7%INfIeC&5x%xxYxIQnEPKIS{JV;i+z7tmvEldi3QU)F<
zV#Z!?GGH3w5zaDGhhG7u>{leh&~4%Et+)%vx&|?^%tcB;Bb1xg#9RzM2fRvljeOl*
z_Hv$<+F1CL>t63P+W;<=DP}@S%{9R0F^GiAiVP$@5;iyf`*&c}Nk|rxa3lUNCNf!P
z+gm+)gIS1rdI(fy^<cU;`}yRSbit|ahq!Khk>dqu4~Zo=dk^e*`dE;zrd=+{_}}N=
z#22O49K2AT=pH`Q9;T|NZzK_s&bI>kLy<Q)DR3Y`y|@@Lml>GT4Yh-&V?HR0r?4e)
z92qf;ARWeha@*=j=4z4&(gqEN^^^aU)DNE>X#0>9!2MCQiH)l&*7K;RLV2?CIjfdU
zQq>tv)AV=9wq;mAk6%3|zX>|lPdhMu17U-(U2pI!7d((T$H$*A3v*Ms;s0obn8>2d
z+u~))sQSiqngw;BWqtEf^Ah?fl9ar?VtGP*(%bN6t9K)~SUp|%oeJkI_JznWh49yS
zo(S!Pv$8$0vAAS5xhKh8VoJKPjFe{v^v_Uben2mJnnC@`m_(v$?h|wQVfK=p_8$rY
zoN#O$YUrt>{jnSBTLrn1BV^{ZG%X3uwnHYId3eR6eT)K5cbH$rimtcCf0~};8dF1r
zK{s23hq7vB?c-s-AW?=Jk$T;BPW$Ii)@lAYwEuu-(h0IUjIIPbxpyiZF96a53>>)+
z=M2uVx`+Av`MP$PyZ`>IF7gb|q9s6GGavQ!BnQD7=sq7T#=h^4e=?09{c1~IMfV~d
zHYu8X4Sc;JIdN8QLz1{08<>;o;sG*92jc=Lsn05z*gEuFS-q}53rxa#)W76mDxq<h
z|7dQ71BKc<QHDFMM_(?j1j)6{kI(JKvuDi<Q5@RzbYIDyC7I{-JdD9J*)L`IAq4_q
z5GiVQ)dnXotN&s3Yja*Q<Y5KFO}JY-NQ#6ut>M-Rh%!lLu7WX~yNE=zhP17`2r2JI
z90U97zK~G<tLKh!{Y7W#mLx>V?hQ`C0&3?S<SkuH3Uxc&L-r3zldPH~jfuGH2_&@y
zVSX%>%&LE2=PTU~$n@g!ANT(~CS=L^ZuSGoJ&^oPg2^&DRuiN@FpT*|!BTD36h6|z
z(HY;nl4=k0zHUg?EQz9asO8*v(Zog~`D$)*sONo1B=>jFy(;Ss4%sWd(A}h+j$4VV
z(xy1xxe{Ee*;YVniWb0TbzVI9#h_o;=u(%Z`U!%>%fb2hT)?3Tai%N87$V2h&4uZE
zr&k`NK{lOAX~uM163G={tF02iwhC!a6a7VfhL(ljG^*eD=pJXvo$-iGXdl>HMOz}L
zbrG-Ve4ydD73CFtbI#|96j3u^Uo*O6g!Sp}Hf3^so!@n30nU+0^Fwp#-GZ6Q#`Shl
z%=A?6N85N0#U6m@SPkDM`b}&Daw!hFxL)w%v32}q3Ed+~VLSLySN>mS8KSPYr1nsW
zCd2EEcMh8?-*ai1{{)@VAurTP@S~&KWIYF^-Pg=rKgi-5K^j!~YlVC@G!OB6(!X5I
z{27INRoMK}?rYuSw%e8oX3M+lQFSK{z=Y8$2eORtwg8M=c?JgrTxg73HQ?z_8hvi#
zEU4EOC;!_NgMZ~CksVCH&?SDfy@EGdI)4L;(k?tK#Eiz#X8|D{_%eP-X8u&MBk6B$
zFve`BzMM(vSGYBpdIhNQi4w|0^UxnsdZl)3(S3wn)w{OB4L@t^VAOAfQ(qP^avR!?
zJzi%Y@l{;jyW=)tqPjyh8tHVsIou>zNnA_8lfw*<vx=W5a>sO2qxge{>9|gy*RCX!
zJhwSDQAU$T3s!K|Wt<0-Sq~X|O-4nTulr-DoMm}>s&i+)eWrV+GDgslulbnvYCnZl
zd#S{Gb{sTY!EfNTK)r^}+170#xxn`EZtES4?li7G&lWm`Gjf`U{U`^^Kgtdr$f^pz
zj)a*x*Grt#d@Ix7R%Z<WJ+QtdI}issh>>X*qkE4cKy)`UlPk7bcyN=@JZCnEww>=d
z6DQGosVnvCi3ThJduG0YAJ0bhm$~oBw^eWA5|1?)Ho-S|)z|BTAhDO&&B>itofxxW
zxmSxLu(EC+pl<;-raksn+*(IhF1wzJf%cr6BZ{#l+#14vB-0#IyQ54#s<-PA)e;2=
zd>a3-BpF~LH=6V=|3!y``&Kd12iF6E^#c=}EVjNInWfI3y&D*ZY}&SeDs6A`2ZjL9
z8Pf~y^LG8ggX6%7NwWj7QL@z0Io35Q8brDmMs<nsnm#s@3MR=@Qv4?UOG-77HJr5E
z{K(^Z$8~^uZyXp?N{iNoa<&Ht>RzdL<E~JgXw#4$$Vd+5&J(t0ZKv}=d<r-#K$yRC
z`5Gv1G(FDboUX_pZJ2YfnJXIKlg*K6WH$xJk)#ze*P2q`hnud#ePc1!SCExN3bmRx
z_P<h7z9@3xi@KN=a={|dgk93BYFJ=-syLgN^-1h;3H0~3MI&uN{eMFpP2|T9*+l;~
z#N@Q})~D$D-Oy}LeRec*t<8i!gf+RkO6QOKHCwt_HXrEZ(c{wcn^;+_{53`WQqsFg
zVUDR?yq5-mWpANb!m}edrs{9g*S+}!Yf&mS<?vt{CLk3<cD_3?#)#Z9xy7)TKigtA
zWr}Cm*`~S#3!VbW{s?_`z`%z_jG>cuXWcrXiP3{FbxH^DzNk-aJqXIUdC^nWzEw_^
zb&HB@lNYmWyFlZyx^g$fYu5+YHuyUG^iX-@NI_gAgn4x1ou5IZJ*S#k$fgLr_gRQc
zn^CvJTK0hY8cE5b#o(c*<-|hH5lU|uD7=GujH)%y>#>v(`dr)^DJ#7`qum_xm1zSo
zX)hej3X?;0lQW__smxTXpYSTShFdo8m*e@_-7vpY4@;PQGe2R<hmC`u<chkI)O!id
z>vi)6VH^4~n>Cv{&V+%<X}4%s;U^jm`LlSbwS5Fb7Hb-?i%(Tn(CA?&h8HAj1c%7X
z;0`JShhS~YD8nE@e8v(_93gk`pdBJ^LKsld@00UfhO%DDmNQS_V@FE>w21X`{}vQO
ztLn5=pCCjs?+@igkr2F3^Lb`7e6?0ceST&nPr+8PgtlW0`FUd6=QV1PCldc)WoS6q
zO~B2k4Eq_yG9hTY`_ZVWWpBgGc?G~2q(gkTnZFUfuJte$6b@==5}tS@59_NH>~u|R
z#SQ<@Ts=#^5S74Z`<V7!3m{F|keUVGw~Z}rj&;?RejnCc4{imER)tXao|V>aKsD)3
zu~IU7#|)7uOEv?B*=eV$K!dp?3f&K6l1OZedDjI9z=8}7d^caJdTU)N-khl=nL<Gb
zSGOpCLkX+zF%M|m44(@x{C>mt-d2tKROGRO+Wv1&Cbw|rCCm|}SA1T^-g!Q9V2jd8
z*-(=HBM)S=O!pD>$P?)8B#Xs5H{6}v2i&0lcm|8`j;Oz+`OjRytq#T-EoH@8aTK8p
zsn2ZA*&rh_RV%T<?aEX-1Iz6lML`=>Vd^@%K!<#BV4l*ExE*DAlI9{XjutO~%h!Aq
zOz5aD;gishRI-|~!HJeA5B#%&A`m2^`jTx;Txm4JmpOj8qbuKo^(;)Y?xSDY6+#cc
zkf*adXNmiUmDDk>{Z3$sMlQ@hDGv*y3)^?ch*)%u8_jRf0S{nbp-gNbSE=i0kt4rs
zlfdPZ5uD46h0pqov4PGV4}L`4>AK1=EUyD#ZsXDENy(q!7t$e+qiNgi2P~5AY-@`W
zAg_r`6M^JlV<g@=NUWTR#NucTykvvl8Ff}_g|bZ|tQ7XxwF;?V2SrTJqjn&Cxu!jZ
zgqz#<#!=h{L=n{=1$=)ee^&fiOOu^nf_D4Dw*V|`<DJc0?!j<MXslUJY?C>kBrhJi
zTGsWxzfL%5&Ox8m3V(W&P-$+WTy+=40%kq}q>;U2RjRAHIXg5siG}};OsjOS40C5}
zhfi0*OwF#bAr??glWY648G0Xs;+?K~*>8_8<|1TPbzB1-wQxEi9EI^T^irN?kzUOZ
z=S(lRRxaEP9d^b;eIZcJt6Y`DOnf}|UU00xR0zXL<-3c`nB1dKE+m=_5dRUo)wKFP
zARX<xlV+PbB^>W3brkgwb7Is@W$W<eX-A5)il!ma%_F9499%ijiJjUdF&{_o=Jjc%
z1FI%KaUkttp*-B@KRb79Y}UUq3n@)>fmr8+1`SL8%p3~W%!_i{rfr$F=|iCg9<8r)
zkF#{|L0X&ikPozXg6l6Zn&t!3Wy1zW1g-T!y4nF`rvX2&Y91kx;twMuBv*1FBX10d
zt{l6<+8xFbClG7Jh&Zlwpo3AHo>na$`$k3$>-nO2W)B8D^}r(~5;j!)6l&d%F=c9v
z?QDQ5+4qq)j&<-C(p841)DAN$W<!E14mre{lAt|Jaac<Orb*`)clF2o+AJFAT1FH6
zPgN?(cCf-#%~Mdls5!<P+Dl#R?lpb#d*~6MPqo!`0N;hvd7e}_EYD9vmcYbLi=&&J
zvx4eQNKcChso)A*xy$4J+T|6s6!o_zyoM<=KMScK|1(Hj&f-o1cFTuAv7~Ea6zFGk
zUQVUP4AU1H+>h+g7=|81(DH#AxDuw%cq^F{FF|)O?}H7S5Dw`0kKO}%cA~qv5=aE!
z;nC!cu=73dmQRUZIey*)GLa16cCGkCtT0Y9F(?)XUN9h~F-Bjb!UW(6@J`w{yW$j<
zWYhRBc)ye*@BeDBa5M>mpJ;&w#uN437!#<FCH)xJW@X4KOx}e4;j%%0p$}k7$CHOE
zV5SmD`OM9|x&#HYVziLCf!SRlB-w-;zDw*HKR@Y<eLz{!-SV_E@#rJR7e6Gs0fu^j
z%QHq(guTp`+n@snh+M<%ZXF}lY8+^`0Ecf31<eIlIZYTb4Up2CPx21Gt&&^?jlmd;
zGNIhlG#lF-T!6XX08o85Pdr#|W|T!mJK8C^F-K~;tF#-qx#W*rn@1}~5bRsl#!(Su
zVb1~<C#2uzt%hUhomyfg(-kWc8PXxL;L(Qz$3kzGe>5PyqIuOg7?P<XU`ooku+Vcq
zq;I*<E{_Ujgx}9nqxrZen2j;ja*xJ1<i1lCw3B2kRf>fjA|E)-&An2AQ&M#!s4nV%
z6)ww<$wquIUhVnm6Px$GGV7qXGQti9Z&(m0|6_NspJPHm{V-hz^@Q+Az@^4JDhX8J
zulOUrz#~OOY}BNj!K5dNZ*wwPB=oqfR4DlgC^MTRR7^ZSdUEcG%MNvJ02#egoBr;^
zhE~dq{N~-Ja&y9}CPkXuybxeS|5U*P+}`w9WF;y@FzSGL7bsV9TtoKr5lPX3sPrC7
z1lE(=G^hyU7`8HX3^58k#kp3N%Od;++PH%>Fy{xq^tX#-nKl0TG?x4}AU>wB<;6}m
zr)e5S6E&Uvm`h78a27lsoxo<^7tQdX%r|@3)&C}LF4WOcs_Fbnm&<m8velXF@jsF&
zGS~FS@e+$N_{fao3@Idb$Qb~QtTe3K=&d^>Ad46H@11m<PQY-2;$FR9>KI4XDyy5w
z;xLP1_!`Y>7Gk_wCK5s|z={D3ho38(?*2)6*W8J&__I1!q`d05w1t--x#OF0q|cC9
zq|0&n@AWSMIIRMfy~Qgj5|)vyHFX(?7KlH2$q%+y6|7C1^#-7^86kwO5bphvPA}U<
zr$aG=Pt%D98mS2hj3%=iZnY_}X=;IgsoC=35e(;d8##x@{vdrOz{&(4G4fi^)&&0d
zwn)ghi6%LzOt03D;9ywFoX0H|d6j;!qwQ1~8|krW64jWT42%rQZH~^7(jA+~lUd+v
zr!6g5o|mT(tO9f-gLadT%gPoQ@o4j%GB#swugNQp8Q8YxV>v-QXNXTkp|~A{*VAQl
zYFW#`F_2YK1D62h86|l^4oRhF4U|k^?^-JwnlCZ8Lw@$rcFnc*KIs?52w9sbhc9T-
z?vV?2Jk6_7;tF#CI5y!`p_K(JT0L&bkQIdelH1cExpD<M8>$;nO0rMBC7>dcs=R@S
zt09KS&=E4vT3({fN~XyPd+ecqi<>XZHt(4pjj2mhVJ)M^;c*u&f}y8z8eeNyPJNnt
zDXMU`Hl<FoI0#g@^IB1v4IEQMCi@C%LcO84u^&ov`#K!L{C5r6Hl~y~X%&D{K&HTT
zOeWTleqPC?z$@O5Bgf>5zgRY#EM=>(hQ8Wapm_UaN%4S367?51O}{|)nLDK({KLil
zR1oGu_ES~hOp&5ugXlhUjdIRZM}TxWMP6Gtc=zR!cFE@H$+&|r*J+JH$2--T5~{yX
z<KHK|%;}Js=6)JN{9~clxg9E5h`jg2;E-DUUIMyscCck@%6{M~2+kZ`R_igrCV><@
z_z|Z~J6pu||BK9muw6k{zUS94I+U|O7u5H*DH8uH9MsE*9k|C-M?VED?J&aP`>vD|
zV>9Vro)Bbo+OS5Z9B~HsW*+pDCaR&Uief?36%(@tlcLq#>Tb4*-e{eIvM`ho)3(nv
zC)da`9)^KT#zlP}#1+DqBqbi17=j5cRGE@@L-ujVN~JI8QmBuS7%2TJ3(I7us&w_n
zJCJjM3~)sm-o1B?N~-Mh<(XcO_BBJ%Cpm>FHJA<X=tWeu_NXJ0EQ?Z-r0p`M*<<Uy
zkbMwV%Vpt?M4Pg9t-B$yF$YS^0bUN6Cf^|=sV!X|T6V&7OYFp4&v`){JmEr|`U}fV
z$~yF4_6rtX%gYuWUI9U(<N5o&48&_=cG*yfT^4{`n!bYOGk~A%&$gk{K{hMRQG?Yn
z$^%eBYR?}q1g_`L*#sNQ@$m;}T=;}q_8+@2$sQ(10Sd9L9m)vgQCbd%hAu3#FhoUj
zA|kiMPLXv~Wv<D2YlO(H@m({l865h2obWifK)<JE_RwtVTYHmx3pG4?wpGU$uuKcx
zyg7L1FyYM?w~`g7!sg}x?gZaE;O*g3rTa?PUDd=CBCm%B%pr(hC1Uo&?)S0LXjtg8
zwlfY|708Q1?9ll}UYZ)=?)36%x;f|B03a0&oA)zWDzqzRNgP~OzK>-lDnNFU!3W!g
z-qL}wyf6#pos>lO&i=gsSnpF9TF1vC#O#bCv&dCGt2i3b5ZFgeXz&s(Z%Wo5I_&sb
z|8w)MMtVqV2PKDrPUs68e{y;z7QeX~*i)c(%});<V_#l|)C27Xm!ERuDzpcp(`J<#
zB=-Z`LjE1Bg(#oj{w}-wt&wP4ka4{<P*eIYFKBJ98<ik!!^n@CM!X)(#Nj-?s|tZ#
zK0dFXi7)uE%|wlOwo}|7WPae80yXI;E>4W0GL($htQ}P|AfX@Y&3d=>Iy0%G<8-mM
z(@3%NE2sXDzwrbQ^(_x;h?LGc*FvuUH}V0S4a;@EH#krkoPyMhTE9(W4l!(1l#2wa
zBEc31i7}a*rH_wr^GU1y?{>i2^rn2zc}9=gUgSq-`NxrTm|}~gtWByv0vKCA+%S_c
z@QIgf?w>6Cv;I_@mBqa3Wi1KI!;=MJjB=tO=Cz|UtjM#;6*6Qg6}~gTw+-HeM{`1H
zs=_0jDT-dUK&|%_lznQtjhHq&NaZWfI_@mTPUgi8;NNqh26pz#&y3!(WqCu7vBpzr
zK<*oLq?Dn$8)gu-4_m=W;zeNC^P(AyES66)#BbBv(4x{e;D2vti(CKGQl(uj;Gt*e
zh-$ecn?C3AR9XDPDjcgtiTbF^r<?mYlb)u6hmr8kJAUX9vZ@{gUNME{yYo@LC|8Zd
zzyni~ZS{aZ5+Canl~q9PO#1P8*qh6xS>i@~%dWTy;u(Clu$S1bGkiD=&MTvaMPiNb
zup}+xGU2=T{pn6E+Hv0&<abcK=+FU4s<xxV-dToUo*qtXyxa%6X}1>?MoD+ivs03G
z#b6)2uCqU;Ig5g2*D!Soz|3-N2A-w=g7~L`gVRO{gH+LzfwH^R8f>-ZoA}C={Vrs!
z0Sed@-N+{hD`hXWDRs*v3215a;ImM0vLeHlld0nN>3S<&uiPNLmh@^ExGMZlUn-pf
z<<lqysk@(}xPtdOXDAHHwwd(|3jm=_Vaj=kj`0bb6j6ir_-4W?*dg&=A0bIyz~sxP
z%&|mWUPR|33}}O@RoP~Gk(eXuWFfA5c_K)^bf9_8uqfkpUi<P3ydha*{2EYFZB!HU
ztzN8LV9%$i6!ZlE9PM$!?#%84NIxMoS-#iA%D|v!VlW#KWKtg*Y^Qa&kjji|_~FYE
zUw9W`GwfDQK<h?tUoS|LI<38`PR7x)KpQba>2KnXF2Q%+!E9>T_S!)?(1>_+VxQq$
zBYJCHG!DB3mP@%6%GdHDopO;g?on*y@mq|>=TxMz?zlluQ6~J!b!cq|_~-4O5iv#i
zn(Mu&y0HZU+b>k1i5TJh8r(G&)V+<E0E5G5OKB8Y3m>S`x=dw+*47(O!==7Evv!MH
znDkE{T0FsQ%*v4Qbz;|AG2p6+B}OQ`GWkpKq7^mfo0oLUX||BfP478B*jN@0%bCn}
zP&hXlvaQ&MTx@MqMt5s^b0I+1&rFao$=DZYA_<}%sF>9wx~Z&)82vk>xtHB4{W8%1
z%DP13?q>N6MJCL*(depM!g{DQv(8EvkS5mMp|BA1XW&JwJM!(+h#a(&ZH7109L@@B
zlKI&%(e88a!?{cN+i9e~S*LlW#uuPMb<z(28mVyIHdmmOP{dL%kzU?s>?;<J78tag
z67F<CEe%~>26;P$+>+m&43a7U6(nb|_1J*2FL;zrA&(L@is<>j3@^~YTbbov!q5%9
zZcap!P)Y2FKuPFBdGgYF8mMhqwXF{C)CNLX1p*2ka#G>jOu68}&n<j8fe`mWzz_MR
z-L2R}!ve;=I?;ac35DY;|IeE*=CW>mEumnGqJs1){^9Z8E)s?by7IV4O;E6aS7epY
zh7*5>;Y|=yddV|om$B?~a*6<c7+WPz@2Gnc+I)#rUE*aIhPGs<dv2?z7hCxLY@}9p
zbY3szl+mdl2@kPpp>UHYIsfNv0Dsjm6X>$L{q9b_+=ob%O>EUS3$-*iWK+QM8;M`(
zdzF?EbaCiS3kH;{yzhaTkJ1?>K(`dmpFWRR*^u&24@5E~WB~z=j`t<y(_HK`u*H-p
z*a0_xkDb>OSZ{YbR2n5^V=lptah5#2qo4NQ8(&3u;TSwGFe9jnco4?x-vc0Bu4j#t
z9El4K=Ui&ZfbuRZd-smbPl(;7PREqzWQ5P{o@lnNcu*t_8setKFp(Vnqs=-hw7`L@
zBBqw@ldUSVN<oS<0j`oQaJAEDaWcWgo>w;L7eTbQBCPo9-H3KpFUHdRr0j%B6N_rf
zUH-+{WCL<Y^vfilKO1wDFM1-70%jGJ8EVPU7lRPswnsO_D<cV&{6X=ZvS|rb{59IT
zpwemqja0N?`q0|AcdD)p0l{TJT5i@I<~qBAgc1S_5jqttwN~V4?2C)0)D%@Z9Acj8
zDKmLe3uahu=98&Bp#`|96s)TO4Wwq=o^ehTB*%Zpk>qkipxDzoI|qNqKusaHOXY2D
z;Guzap%fI1?u}jDWwSls=bPU1I??(ax@0rQ$(s%qXA-Z~xQth2kFIukW-3%`XKYB%
z3h9T@Zpt|W<+T)JE~0GN<PJW_-iEUO{^(Wzbx_R+EsuHjm6wdL;AcFnUWoCE7l#2S
zooRqy5Bjo~F9ne@7^JOxBjRN?rBZzPPtU-1vjKDl<(6*~*wO^{r(GSrel+`y#cwNJ
z^r8(%DD95fWEr|pN`2V}^_~y+x%zmowOBo|@H1Zl#Buq@rJ<Z${vxTOk!{Z6z!rSu
z(yn<s7FuyJ6Ktk>))JJMq*E!dGdbq+X5k{TwAHD~fd3C0`zt#xgBGhk!x4(-pNgwM
z1FEoOKIA_?49YZVDV`GD`dTyWTANr$-dXKTxfeWIEd~!Mqlm^e!&F}g{sYr{aSa4(
zDcIuPyqo3=^kH@{^y3chz|k)m69L}IO6c>Ld+G4h*)%+7o8{EO%i27Ju1+Bmw#IyE
zzaJ3uXIG`PJ#ShseWWSVb_Pa^ds;DZ#!r!PPELlSxrm^xJX+q?gY(SUUCaJAgjzf>
z>^zJqvhM;K-5~0;dDmXJqSZa7Ty1OH+4+X@CJzW0!C6g=6nKDI$;?q*uRA7_8AR-6
zL4$Wvj<k>vawpfdam=yHiU$n+A75#>y^J1l=}mmt%}b3}wFSJc&a(rMMe|>d)Y6SE
zrYM&f-5DLIV_&)cO$uJqqlJ-Wkkt^c;BfFz*x(d8R*h-^2B$atC{Y~CbT)SsIzTEO
z4FJS!Njo?-{tNSbI@x+pRgF#y*E4xw1|IW@8am46rP9;nW&ih4g>PS6e<e{`W{T;U
zSEa?Ku-K{};c-IlJ+Nzi0G46w*|eWuM}=BPb~2ZW(g1UrZn<q~u2fb9&VA?e`nmqP
zO=vIMH7t*cS}AiEf<x;Q8G+wgp2PxiKxB_}^>Jx;zIL1c0-+}qd&cT=K+CJ6TOF-K
z=T%3==o@k+o_-rd8t=<6GqURhqHi?1_(fP9kq`}b(}?=PX!f^d?E|?m8TvEeV47y-
z7(g_D%j1~W<#6u1(U_fx-|d0!ZtA`Sk#4$SWl>cqhDcO}sm1x+${Kc)G8uvl1jqj{
zHv9yH{H5KO0tfX^xbR!Bz6`$+a3701l#lLY*xi<yLDka*u-A|7Ld=Dubm<(zJ|)~e
znL*~ED`)Qncu;lm1}9zRa=otP(2udd>x&ao4Qb*y)y=G;4cY>uNAvIILH0rq2&byq
z0*M3E*#Fv`b+!AXuC8T+N`^`hdi25RTb7>=`e80(JGno+WY44|3h;Qg)*@bSe=}kh
zu){qZ2nszSy?*3VPB%fhY$IbA3Z3tDi{R6dVXJp{xpJ7$zi@_cf(uDE9yA~xAyE48
z-1^y)`?a<gES+h<#28b7S_#G4_JuIh@5oAFaWXyfx8He?N2d>$P~QUGvOBqX2AyE8
zf36I_zV=xIY<P3e8bq~P$D(h`SLL4htu}`T3(d$rgrZcomoYQEigTEMc(s6?;LRD^
zBmM|T$RCx0uTv0eh)Lae6BvbEGhk(9XwOh~H*cc_J>QiCbd6MFMgs370uJz;A~fE>
zA`*?ap{bt;ZQnScA9-Xh=$39j(BFrRf*0<`E1^nVcfM0JaL_Svf3xb_0%~kfLdtL2
zj~XDal<<$*p9kcSXXqKnrz~*u^kk)G@E<XSc{0Vh({i#jIhTedXUo9APm%=xvMd`!
zM4NKKuH^C4V;47Uydvoi<Y)URzlbkxVZ|=goFO*#*<=~DPAw1zon?*siRel`A^vC<
z=TD#1L)-w^VsNBtWIfOWZS2JPr2mueDLGxfEO1dit5(mg)=Kx{@ux^5>`gOB%V<EK
zky{=6CW6hVmsHlPw?GCkkV}gJD%t$+kfLeWATN!tHh8)+h_8-)IYH)Wzn(pjFy-1T
zdHY2Iyhr=`X#R4@%)M5s+W8vA^el-ljCauG3w1?Weq_UUs&C`jzzZb(dG@~t)*!th
zR=hExm%hZ#15Ny*H95B9^9O&<tT%NvDKd&+<uAhnQ{!;5n=}=2g+#qVPOgptC0yIX
zfae@ByOuT)mA7KD^im1wM5_4an%@8Sj^hdZllP9jbn~t6eCm}@`ojB?hyf!U>*#A1
z|G3+a_@mk7%#1Pi0yN$*a@4F=dqYIpsqrMG0aVPo0X@eb%I`G0`UfZizgIg>f0K?v
zBZ65Q)&?|wu<oJucrq>iAYrxj4?wvGpe$Y`s3|c_GRo^Hs*)bC1fh(TtMfInz0-Vn
z)!6<Oz`Uy~fHtUjr3AdUUlg}@S(ox&uTqJAu>2p;!r<aPbeog;YpoOI9UEq<!-iYs
zX-f~~?oK+Ag|TG^=O$lZeYH~ng6fteK_OjLeDCovvEHQvxa4QYSdqnQCvwP{A+`Xo
z@M}&|0=VWfh;Qr`1wlSL9G$;g+ct{ArXpSzh*DP9n9zgIU``0$wHrvfM`($6lPOi}
z-*Bd&_gvh26VLV7YE`}ocFRNqoL^=Ll@x_dOzp}zsOf)p%#e<8Grd9+$o;Yq2O51&
zsEb)`79o4iwOxt`S>+g%tR=ESJk$(ANrc+$yKC7P+r4XVKFg`EU(^mQ#iKUhOmX8(
zBIO*R)_xJ?F4eq{O3y%G5-Y$HWF+b>w5DwiNTiPFK+?W+{^4HM*=*)5LZ+fq#R6WO
zb~gk1W5T>~3!;wSPdLg^tjf%E@^P-E%gLJ>9^|d_poRl|8`Jwu*N5=F;ySB~Nx(RH
zvx`#Sy7x5ZbjiSo7w&0(45_^XE*lVj+qk0oV;dH(uxT#IGFu*(w@ex0>avs)>H>+o
z#R)eC-CnOb(t$s4#&Ak*)1uP=azb_u60&TC&J}PL&OwKTDK&QWJ*mAxj|LCVsp!&+
zSA-wI=KT1@WQqJ#NkTe_6D~G@VD_@oE&GMYE}+yr+{eqR3te&9&t6suoyS061r@~+
z$~3uSDxgJoqbJBowbG{X<a`K6d+Y=WbY5;rPJ^Ixc?&JRBaj!m=B_sy-G3607#FI2
z28x!jN5m$>^a{Fejj$6fW(NMA@Q_0aMyn^twc_F>JIQM_j%9peT#+83sY5MG4PdpK
zFtrB=z~Zm+%>nV>Q;TDwyxtE14~7v7NX7CP7de-N6hHN`>5f=mrn4^`3thwmYkHBo
zLOu$nv;~WLM=0Y{%<Yr5B6S}iO;qzal^QRNlLZOX{{*hQ=bVUr6<wJV2~a8>>qciF
z8_;gkn{-e;q>M)wF}|7}_fhvd5uW{f0CWcz{l5IB9H?33gy{C-d5dlO%)mB8tI5dR
zTsl3tb1W!(`Bn7{Au1L~ZJG}hm$4LIMfFFwax;liJpDrz9oAroa-SoYC}#2ZWqThP
zUXvJH-qI=AxMcDc`ttw}n7n(1#wV27UCO8O$zUL^>|lBNFf+{np4()NFnKX#_G0k5
z3dyqZ>T2z_S4;|G07pQ$zvPedZ__||>+So7{=mRc2urnCkBGT}GtA+?+XamftO}WI
z`_=KgD%H2&g-r&o+0YreL}{kKgqP2N4IwqhNke8=$dz5m_!|ks3Eo=n!pv58E4dgL
znD`*@9s49i=c>bj96h02pvs)tVD5f2Fh}HFCiU>%LIen*-jq}Hm?=RRl&^lmO8!f^
z`rWIpNSNOL$a=D`&-!Ppos5u%FV=!*0%e=Mjr<9X&9<@sdpbX<2c__Iq|qoVLm{Ke
z;9lw{mFN)YV(qT8`--UYx%Dp18(btAHmo%x9uFrJqJcGENw%Lrw$dgY%PnNr!qh{d
z#ENs(Vs-9SsC;h9cufJQBM+dJQ#3T^hC!8La!tkqqiPfgaVknKHRwf1BHNGuwCWbl
zn0{L=Nksq7?W+^@20Bnm@D2FtT(aL`>5ptK(V{!)B-C#$n6W7ZK4nnSs!dy=BHOqY
zklqa_J(n#4Q2Y2E`#@FdUWQZk$ZuDe4^gtL5Q=}&EjUw3e+CJhjm}|V-T$B5dg=ad
zH^zQP$xK{L6Jp{U1DRma*ec`zYYZG`hL>Ru)OAcC(x2fd%lcnZU$Fbd<Gyr(CB~zQ
z>3c^=rM3GCT_ldx7o-$rz8UebyP@p8LbUN=66j62FC#J|ny9Y=yxiV!ky*F89L)%K
z{Hju9aWg}pJ}!p!qu*-y3qIC0j6?gzd@mx(lB*`kQi{h#R7zw{T-;UzZ}MdDWcPnM
zRBcf<yy%tzy1&^JC!xUzkURugq}s@Ep{3Whi_AN_eI38`^P!o7GH_DBc8I2V>l_ha
zo!ViMT3~^iuz}ka^L-;0EJ_yPG$YKVO*Q_R6h{-e?t?pW1pcuFWl+ww@nGc7$iYg7
zwP8x?c|L-h#fhH_8Ap6*qYw>f4P)E-xhM+{or$pzhM##TmWtuk5^9v?jb!tUk~b!+
z-o7E)x9WtUwbBX4Uwg3=`bIeTQcNzP;-Vuxg`m`HlBL8cR!#12r69NnMmEDO=ZqB0
zZWELwV+Da1z^b&qG$xl|h2~{OhK%)tAB2157RY6QRmvnk)DUd=2QV4-Nc_{#)yYgf
zqBk`p-h4C0<hoL)IY<9rJR}5;Pr>@A_PWzea3sSnXWCZ&Y};HN`{3__{~;6n(LRcV
z{5OX=i&qEKV>QK$p7olySME9oglr@0?n=sW{*+LHS{?*GF3FZTZv68Beh)`;Fl&xQ
z+ZAJQ@1*TKvCs}wY$8^4L&}&FBRl-W@+aN5-Ybw&DbS;DWC3@yh^PrIAx*Va<;kYH
zDL@hO&cTkb!5i#mX77W$!zO<3rhqi^)Mo|wn%$`|&q}Gx`)R)OldgsG=Ra&g9VBG4
z6@oRZNB3^Kd~2`~{;w}~VsB&Vq{yQE6I@;)4aosA$Kgw#8$cVN=@Hln4C^w#S}@u4
zT>aa@Cw3V1>~B0znQ?h`F2-WVdU~KK!T_@WJ%-nW3LFd|uiG>(Wzr?eo#m_4|HM-8
zsL#F}-k;L43}=6*Ar!RlRx*4j-l|aVyo$_rbgrK2(cT-)1#1u*=1%uZ3~8o>cYoaj
z<>B$S0mbH!_uz#nS#%rsjF1)=70?<7qSrtlVRBu_lRt3dH7g=6d<*I<`D}Sajz@8T
zS38ppY_GUmDOhKv`*3)6@d$41MvW#jHJ~+;f1CkR{B^Q9GAUZ%u(MD9WHl&~@dt2L
z*#nWjZccZ$WU7fFPUav|l9AKEKZt6I((h*e+<oPRYWLmEXWsg>FaN#E{xM>{`gYo7
zCqQqov}sz;@^b|;fd%u&ToOa4ww?rrZ~42`Mza$(M`_7!vP*%%$OX!ZGXO!&fV!qP
z5k;Os(42xcmOX>^eO3I{u&}Mi%w0HjZ2>!#$ujQ(Y?-!-|C)S$HYY;ZSR$F2g0v@M
zw3ydCq~Q-E(!qhCLZ-CX+ypJmxFZ`B5Ay2ch2DByEgH0-pC1A<n(167nk`$AMYpSS
za!IODUN>vD{(`dipt(YGT$ubnI<=j<;!2ur)e&XBnwG-fdyO^n@PcIm1F=abr<s`$
zV~&=a6l@x7yFM-;T68`SPB)m$!eH%Sj!bGs)j)b1Ce;x%=C;1-G1*RQ*5x~^w1#_{
zza@Hc9!!u0ZND+oh(K?i6LS(9iXG?dC_flud?Kd(mhz3o?)d$FC8dLKoX<#=W7yTa
z*J-GJtIS+c^c#U93^^*+jigR;Kxt+K!^&S&pTp#}ipf^=y1?FTc@+xvzuP+|ES@>N
zYYt`Dtm9`r*%dbRI#%bllikEr3^D`Dt@K~K2?~n+xopr~tAlbD9-d1TC;AnE5yvp2
zO$55bM&7c-m}vWQGQNNvz&MDmF!5`h?Y64?OsC(A!O$ydT^qo+kwJ;y>&h-fED2M4
za!(V7sX;{DXOiK!vBFLfgZZvz&$qVwn8m&0T4du?=loO(!iMfKR%Ma6t6=sVc)E^R
zMYOF96S8Q~p-nffm{yNmqfTuUBZM<kRnt>myeH|V&eg>`t;4Ao56dXpojLms)w^-Z
z_sQd;A>yatJ<X=D_Z8e_#wWz6W{-%X2c7iWRL1ywJxql=cg)u5h_*IHj1C>68BPjN
zWMSHdd+5C_<EHEs3q2|?(C}YiZZRxKV`<2QKN@^<;Ed#c;LRLN1=;h~j8$eZJi<*J
z546wndb!&Sr2*9J;3N+6qFrDBvs1;~o8w)rPodp2^h0d;OBNJULJzlSna#P{cDkp!
zZ?Hpb_NlmkF%`uB@Dn>7JRC+m6}d;+iIds}RemMYmYj-L45-#9={>c0n;`A#-BrQs
z#7A1h4{kQ_Yu1XQ_%t?dI?uwv;jm!4a*Q&AjoP6x4cx<PqiE6P+Oom_s}`xblop)P
zAW&BNShRSUrIB`C#44ZGJ{5YOm;gMLg&qGRaYT6;!^cA22lm(Ll0U=oLP1b*EJ=6#
z6>m|KyOjx3#S?N(;jJn5Dg#8D!axePTh?k=NfbfBhdd|4PJbGPx9oQwDSnrGLhl(c
zxkD-(M7mB!tl=h=CC|zbS<B5v&<@+3uc0R}9I-zHKUJBff=6)u^MoZdaI=m!-yy2`
zZ-FswfquUS8N8c{?<A(h8`88kGo}umNRmCxq^R7NvF700K!*<ov)P%~$uJkkU(?_h
zJPPfNpFn-G3{2kN84M!uSPjJ0`UukntI@Av!s{WgBX-&3IH%|E4vI2oG%X|YzU5#p
zjFS6f4-1mVLj9I1-CQAiCdg>Xjho17IZkkavdjwpp9Q>8<t@FHuluJHd4D?#Js<tD
zqN+iW-4t&%Too^;S=YD!OozWSAHP*@<pQ_vCl}>uGcO)eHDV1`G)w_)(Q0aPv*Px6
zX_cZLt<&GjAEG<(`wB)^OiuuukK`T`!yP)oxOEF464cynDBukb;I8)g4g-n#swUFF
z5FMPT6fIDX@3rcu_0o84|BotNwpJlif2p%rAfBuR{t<2*u*_8;o5v=og~738oWw@Y
zxXS;;T9TbJ(|tO<Ud|!=S)R3d;u4?wzrrV0+d-#>uAM~5gk8JhhlkHV5Cq%jT}G+c
zM0Za3N+dj}EGPfJNp|>?cB^A@`XIxB{`ueG>HjLDiD2!z*#3a_iUz+&{0ga0CYd;t
zGSzX9`LH6jV8Op&Gh9KE3sf;3Tg-!iG0($U37?Z1GocnzMW4`%V8;faHwfvt^=2qh
zEpygUg+`V`U!;>nHsAEt{v76SiW|=im*Uz8AL(Ik_U7I9js>xjSRCCPEkjSrbK8BZ
zsoZdGGLZDPomjX-iRKRt=y}4d;F9eS1zLC~N!jpIHx;}38p$8Cj?Uw*lLKWKe|~uJ
zRI8MjrXWmcH9`?e6xnN37_3le_;HD)@bJK+stfa$ya`%RjTp3K7!8$bWT0*C=F@^q
zCY<n~gg7RKVGUmzr$9F95z3`Qu>ff*UbsRVX#WS>^O5x%6+(-#Iwwo4{+&EsOIxpL
z2pWrXR0Z9-?!^+H#unlxDuNzb?Z4s@dfViwTR<39X__aFK3e}Ty5PU#X5u$)Dq+PA
zw9S0s&dGvu8->7bD#=K%M1S~oRxm67I~yqqzgotL1GAS>D3jZ-(ru%N4smZDb#Pd5
zW5T;)nL24oYoBIh!aB^%corqAT66?tuB_$?-Di)_pc1y#r!(^@;813vjJ9(m&YIoG
zu4)O8u~2)gdqH_B%-8f!Hh(;9%rD4@d_k7<!iw$R-gZqkFgy?zH(*AdgWnCpSGZ_s
z^kG=HYZhI`OT_9Qt66fa7x<+#z+Ansgc2s0P};5&q9~>XAH~o=u{G<L$A;-synupm
zzJ+NU*@0ax5=7V6o0QnWWShRHJNE2{n#CDYSS4WyuP7jr>+ULX{^6cYNIlZVIxbgw
zb{zkbx!vhs!`T(HZ+I4;yJCm|$SwnEAZZOEm0G1aCCC?p!1+n=sF}&8(x9-xrdBvg
z5c0|YTXoh<iYwY>8!8~u28mnf4Xc}R!}8}CX?OgOJsLY6D__AubJLJb81_w*>m@5n
z((^#UW&db}qf3WfVQiSf5cQtNtae6gBj5euw6({wmvMC~r;IUI%4WLXic0WF!ESbd
zwz6FHEXH2@b7rWgAV0JlG0O*i@z$;VwVLb4P>D`MeWcJ_Rb4c;D7V_mhp)JVc7{<0
z%I{{Z+wny}-^ARal~Q8A-S+Y+Z}TBly-=C?Tc+-@g!nTEPu3#e@>mk=NEV7Uj2d*~
zOaDw+)tXC}--qs3nTwqn_;7nqx|ACEnk!Nc$J_5baNT89<9XXOTL9zwSFOdNZEWlO
z1JJUzw~294Ns^5Ngvj~J9xbehwl`k5x6K;Zx(z8{t$I?R<%~UM8T6>b8^J2+dXggR
z2idpkq;xlJMJ-9^&2FX5yfB$|Q)RtMXKX!f@#G{_SSJ#d5Zj!Bq^c31l^?OgWfzmH
zo%|UP!XjFJkQ*-_141ItLu`OPI|R?cgAQW8@%P3a5Kq1X@ZfmAj<tIhHhs@{uY~=h
zYo^!{3ero^3Z1}cWG_*80fbz`)ReEC`>ip{Iy=x$ST*288_W+9aFw<b0x4JcB}<Kw
zDBGg}<_uZ+jCt~$Xw;?qbP4bJ%Ralett?+vhr(n>+z}50P#Zm(#P;dYS8ClO#CrdR
zGIqTQyN-5AT>s{EIo!k5RDWQrarRo%A|h<_Xid=PB6jL7%obE>m9SDdNM}9BFQw!F
z%J2ZT9dLcnzYQ6b^uHESwoanTS;O;MmVNuZdp_|0O&SK4O7x`!Xal}~QXYECsl=P2
z?xC+G6Z9TV$S99a+2JGnYeKSF!rJQWUcasuQbct1fW~&p3SRT;Qg!iOug#gTevZtV
zP$vrHSk3<?x^~DRn**U7R+Kyav$yVSe-%cz)}<Pwak~q+$naA)C~809gwNr_dE(?t
zFpBngG{i**loQvwR;`wC5QfuikV?Hoaa=KeZv3-6$A%7Q6_pP(?h&eOp-aS(>=OlG
z$s#d6Y5^2<YsGy27kO^(&@6J<hh{Ye{Hb{W^&}Ed@3V+SEcMFzYjqeu4wG5C;m_Ew
zEC;>sQFh{~1~kiJ-(+eHrDLv)A1QB%PV4F=p*gmh^+B242AJop5mc7~e!P#i-~LN+
z)Co8DAmuT@ud>S(;8KmhQbD|+(MuwAf*^VUkLj$QLn~?nW`*LA_vz;UXk7;7J;BHN
z7CR&*0&c>!Rx_jq$*v#UtKJ-n8vbgHx*kyZ9{*3?c&z6+CPhhn_q_w(W3nlj+-iJ=
zM`rt(D*zM)XS6ntAX+a_{zyJ4CCX6uRXpo`X)XSGm*KMkvj+gjNnk8w#g=Wagf8XG
z`R_Vz^Ypi$ZDA_jxK-7cB$jvlSYI2u4;tw~HmMifMS_H?Om#$ZYg!h|9c*pbw}UD1
zs#31ubDw~UO#ASW*#(=*E-J=<m8EY%P_5!hrP*qLQX(`xP$oQPpxS<`t5;jPtXZ5s
zdo8R=Sm+oEj0oA(x#<Xt1ZN+yoo8A$YLW!9lfZoMp2&MRQgB_5s+=S72e3TT%f6tJ
zeu^0hMw3_HK>6Vs;g9!grUuC^%8=9Sd;kU@mE{pHdk?wkW%2;pMqV-Xxa!?m?}J^i
zRcD<3(;26|FC>%R9-HZvgZr#iK*nu5+?*U6`t~WucQ*v(W~%`fJWa_hHcDD4I)>Io
zOh7XTy<vGx*?FLL30&h3@_fYKJV60Hj*CDSl1{YP`yIJ*`j{)Z@)C8X7HtVwqYFWA
z2Z@$cf~+VRBjoxr$le%~MH+&We5&>U66#|bGC7`Ujm3u4;T_y_9mE~XTS?W|3J1tO
zxnyLRQTqymbe=0A`Jec+HrLUh+w&v=1yzPi;Y<z4{kYWbkD!|#a1S-4J}v@i+~ZZP
zF)7SHtfCQ`N;?bFTcec-C8Hl4U`ZvBMmdPH^R-u@2R1S}okI8ubPspd&!bmnM^^cq
z2u+tKs+sq~(ZS!|2J^>lzuvnliG*5{D5#1TfqY>IhaQLkEo)ojmViB(kvBRi>GycR
zj*;zp?y7(eKaJmM^Jsg;*Tlzv+;$&?4iWnQ^6$8R!jCcR8oia`^+NMr6o|3U+T>$Z
zfw6-G4!l4ym3B{82RqeLIW`M~;eM_Um|*mwP~`&D?a7jbTxgR=ELesoTu*~<jbA5t
z;exVJL;8^JKPZ7~`6}7e{nHX+=R0|$bB?uRTZH1@_4#R42BO*goG&x6cps0Ur(b}V
zH2xv{J*LKrw;0S4g&%Dnk4|S#b^}Rn*$uMI?Z78~xte8V8t2%D@r{w<T~M4qaE-;t
zw8)ptrzDC$#bu3Zet7gNZNlAJ&;(NB7GLet5=JGFm?0u)sSA!Gam^l<=m#1DiM0Mw
zk#g91%)U|V#LB<+EyYB(;7lFPnp*G2ytt%nITaf^H$PShNeK2Kkm=B%EWjpQmQQR%
z-b>mDaIVVlP8qhICGgrNGfuqszuLMuBylWDRlw}QuHSuB`IW%BWK8LjFL&&Q@Amwy
z?Qr~bSQGkde-g8bBLju70dQzx9pclv=KFl&W&a&;?`NiGb<n;Xy3I`wA#Um%R%ig$
z>#|NEu^+vHL$JboCC`?28QqDJp@Wlc?)CLSdz|y|_UngaH?l!C2nPCys*G!6naQ|n
zn?g5|1a)XJkS777tE&*YgYf;vG7m(c=4JojsoMF!RZoS&BRoP{dy7L~W&njkoqL;R
zEds%B*G8r}QqdfT6>S(9sZKDDBuc)Kq0Eu)X_SXdtytxtaMgm$bVoRLHFoy(pf)ue
zHG9jz3K?f{*SHVPXcYnlPirz#vRJ{ov6!byF!}>8KSB^>MmuOMO5<oGy73!V=g_YL
zOQwPdz$lhnTL-$(p1~;h%*kx^pB7)6NK1T|)ZM#MtF-KMC*kKEGhZ3K&0xFL5=R#?
zIVs;iZKdGgoA0B81I?iZcU^{&#qeYXg`>z<1|T4_;9N$HGjZZ}I@fa75|R3@&!We3
zxfim(D183;^sq^Ez6S4HXSax?w~AO7Ho>dW10TAV=ymd+_~ztuGFFhP(u}gs*}M-M
z$X;`shsqat!M{mu)7A|B>gfL$&yQS8D%NF)unP>`H{gCoz&FErQ=yG5zDB>B6?YqZ
zIL5-eGcw6}%fczx!^Hm3L42N$`YiMTRcN~80RkQA=mzcM>Wtag!FI@jTFh@as$53p
z0pBv!t6V<F47)XPJLHCpOcgSuL@OaxmnkMVS>Y)1g{JCM`<o|%%in;pEHr`SVq!XN
zK=@dY(P`o*?J0f31E9iRe+AYP%SI!A@~wdMc#PJ;>e73->IE4DO#(1mZ{<|-@G$7=
z2^g@o-oI-FvJtEiS7AM%VID14!;pu*s~~0gvCIIexjxJnhL(Sc{V<-`5!+$)`CWeh
zJL~z>@rx<C{a`9b!7^(2o|OoDgJq83M7CWXxLqOUK|I#8S4Ns5IX=;%ihWojerGOV
zJc;ms!sSk)D|d;b$i$+AXv0_idE?%|FBAP0GMj)LM@VGU9N~#Sy11^qRfhen`&vN^
zuvXQW$jDLuYDf{$Asw`Sr}>EHe9cy=HVIz+3eY+C4a=?izPTlmA8>59l?QsqSN_~t
zecvMVjX#(}b4_JJwhAD`3~%@F|GnFrf9+-Lf6<d@6<@h=88~53O;UJe*8n94<^qW;
zvzZ+s`t%7bU91f>MPO&`K<;EjsI^6UMND}^Uf2xQOMPS+Wgm2!dh4a!n%A05*Re_H
zCOz{<P&KbVeMEOIwQmNU`(Kax@6r$QuN<osB@q=7A#o#KrwK23V~kV@faN^3%1f@R
zb*X1(&)39f3^I%4Vq+Oesk=i~I~+a7Y0H$^twYZx5>aRMy&D`Ok-=;(ENEInECC%4
zfoRzBmYE#0AV0D#iY!i{D+hXYzZ-B`e(Lxeg5Cz+V|GeGJK?D^jSt5KqqWFv))QTq
zJic%$EEDM_Z*n~HfBp-eX1;K=g^cP3MRzb#DQj@+Hqzt!*yJeIN{MaZ%0q46lxAOs
zi;1WVaOFww2P}!J!<Q%)TM!VE1Qqfq=Hvcw1B?8xDPZUZEBY?;+|nuMgXn79f{uki
zK->LKvrLv5H`wozq;L=0KN&r|ke0y#-Qc!w*gkC8((MGl9z2Sdqd`KL{)q5rwD(v$
zy}X1o5NW^kx4Z~N8#uWq>F05{m2EA53<H!?IWP#0e8^7eYTA!k{)aGqk?d{!Vj{;A
z>Q{>Mx4HdJc9vW4m#1I4wLPrZP~CB>MfENzcGG!sd$EA?=N5v)f8=L^D~9)S6s3pd
z;(ePW*w~<#ynoU2GZu7f49hn^t&z-*YN(KNDtw73QE(-l>r~#JhzO7xqF~SNO(Uch
z*ZSb7g_pr(ZHDVBi1)Qqkl8T|w+U5;G~70w40KGK9go?;Eqs)w^pv!1gIQ<Ozmk4D
z<`VC#PC3+R|C7vVA_5`>)DX;0zeAhg-LxTR3RYvYXm%h9X~`KAB}&~-<S7EuFf|Au
zWhA;XGp&9EJ<7kg_d=tUkK`b^E(l73Tij%4KC!k3QP+t1I)G<fr?05qF+TYBs-0h?
zz*E6kf1sDP<wSF@e(_pJm83edV1$42T-M)@iP*?UWd6;v-$kZ5o-Ag4VLJbrG`Gx<
zYS}Nk?v!;4eqld}?-v2%0@NbLqf$3VFo3_`8?GVi$Nwat$&W!22ICFrD>B9<oXh%0
zgG%)6$QC^s`0p`Oj;d9HJe_M+s(GX!RZJsD2eJuegeCxl&j8+Pe@&8>9&SpAJgtOm
zQ<ppB6}wyG9ypZ+Vv-}6Tb63#cL;-JW<MNXbkEGU>vTdaFxBgV9L00K|24Sh=yxim
z@4<HI&n;nLXZ%<26#7d;eJi=Ue)g8LFYJ!)aGv)UGxbCXUgVRa#MjeHx(FiFxFxjO
zJhkyg_@(%e{P*{4NVviX;)eyDQ7~6>Xw%?DNo!9GhcV5quiJm1A;w=Z>VVfcJbYLa
zvRx=}8+sl_eOm#A6ZIMkV$K4fRM(BhMDdx!ot@(%4{eZO_?GHi`?z{JcjbC2i{c|m
zB;ul&SUZF({p6>CTG52X*c@FwHh{;j{vM?8t_7YtJU5YvA)rfE1tdc~1fHr%%{%7J
zQ%~qUJe`6E$f>$YC<_@75iB+3Obwv<<o7l!)iauVvj($Rh5uwjuV@+TZ~T<j>3f<s
zB>4>_Yj;p^Bh_B{I<Q7*AG8xmehc%YG)#mB;+H+FT6x_5r~)M5oK`+#U%Y04jVmH<
zM6&2>hz^v8o)Rae+m{fy?KCOIzm=FobfCiFk~|0U_3=VMbM$l-CyWNjfKL(ZJhaD1
zuRa@EbTImH_%wpomW|ThZbolq7n8F2ll0<v+KSu;+FO>|aE_dDxZ9d}OWQKt40-9f
zF5#y{`L^gIyw5$ReqTu<LyYz2X6kq>(R>I!F<`yYLHxJTFL?Fy(OEhI{2>QSdI-;E
zoXz`g*5c<i$7H>4dRexnpdV6ui~;p$Y@q;nFxGf@(f(yetc!HO(8x}myKDe~NClhW
z;M(pE&hnAAmj6N`l;RyfLeMfrf5cz=u<j&^We)t#of3|<o^shF_c1`J)FR-#!G^bW
zTb~5!@<C4yD}?J4Ce&GXLGnT)^+HGXn1Iv&7*zJo@Faa81eyKBuE>K|jj9vn>yhXc
zNt-E7<VmELsnpTM4`wg$)O%V+3ndC1@&aqOZDVr94CZW)Ca<VA8M%hV2km9#T#bBG
zv&f5Om*G_}k6|84vkM|7pj#U^CF*3=W<n>Nit<KN2HA-FWCt<3G161Ih*(!s-(_z-
z<wBjrP8Jb1s(Ya>Z@$pSG{3@~Iji+JR?(mwyE5^3bB)#t8vV=LUJ5o{e~!CF_(e9G
z*e_j{D{E@K$&VfFhlkv(o9cT?@@<>sjz+P7uJBx@`>aPFkBP_P-fSyp@r6!1kh)x!
z1yv6A2gemUdzxfc$!p18Wv{lyWX|-!C+svtMDC-4wvjHonGPSIItPpYNUr!I&g~9B
zUW_cS#q8E!8xiPEO6`JVLcZcVN~eOqLEWZTkZLM2E1Quw!{Wg|Z!!JGJhz35N1-Fz
zg&4&(=c|hU;rFck(C`krX5#B#tX%;AYYoBX5O4$Km*>Zj>qVnhf~jM$pHRGLZBf&I
z<ISc_VaiV)tfqwfPaLDX-Lq6j3H03Lab#`%?HviS4TC?nWQd708Esf|7+8aj#ZL_c
zv~7(71GbzZ%+n$hP&%nWE=5%V!`B=1MJJQ3_~ETFLxDuMit_)nH?|n3$dAA>5feiQ
z<17F4w4-n{W3{M-3>t<AOr+cM{>X=c!fKg1=z!{t_>ElZ-Sl!Kgm;?;ETBLq@B?Tw
zD?$L~TyA%!Q#paKa_m)Aq`!sc?|D6nR=i~u?Pf;F(@AEw)D{=^Rxv%UAcSH2`Yx@{
zJ3zMe_@b>Gh{Du-{aQ<lz{u(t`$Yg|vS1gxX$}{TrT@=rv-l8oHaGuxsBWK3^Ko0C
zia*CjDS{kd)ZzTGH}C4T|59Zdw-dj~m&H2*M6!d5G{2U}9Iye7)Qfz^Z_?ng1{pm+
ztj$V#Jr*Y?Y2Slw9L^m`)zy!uGG#vv>3LOg-Z9xx&+0ZHxpcG^vuJREJrE$Y-4|4R
z+TC7wkX7Mtvme9V*9yN?XAit*7bRywVk#q}OWni3&V$F6?WX7+=2cN>J0}F813M7{
zTj_w<U1thY8Ih}*qF)*AP0tUHP-dC3o|>>=5fc9@m$+^>#rr|Lf%P+N$vay1RmgYa
z>CaB0b0szAGbvMRv@=e3idq{i_z4|M=Is*KH6+|0&zQ~5QDozhfVC?v1Y8~Vn<e)}
z4Y%{IQUSt@(>1pe)&Zq)TrT>_QWIDZ2Xq0laZXp)f9btqLC<W5P4g)*X|HkdDicG>
zD1&qiYAc5sbFm*+B1Vcx@O>XCM&Cmwr<h!$52Sc2o9;ZWMI)f%u#w2A?P`zwkRHh*
zA1_g@Vl-RNO?i~|Q#Q>YtZJG{@`J=m5IwcxFJ#(P{Q~=<CI(O^kwkJ+R_NAOT001G
zLD$nZ^Nx|OSrJ9;i5I&<qB!)r;fyuSz&CeDP7n2g-?=;;=g`7Q<_<d>AN{RoHJf(J
z$J<|ZRI&dD?vL?#7q@Td&N|-8Fn|JT%A8!Fc0v>{SmUil0H3W;pC@2pTbA(3z8TZh
zneCvLA{+M^z5Ks(tU!QHG+#w!RQBfn>?zdk+qg$B8|h*wU-w##Q?wt(_?g|-xO-3|
zCBh@2aMinHOW_8$s{eqgmCtq}#Nhs`FS8QLmWfPLp&N!Xdr5x}g`+8pgv7vNQ1NQ-
zsrS)LJuqP*yu}L++)I-X={s_0h^MAA!ue|+|0B(QnUA#Ow%#NUgvE4%#+xFe)sZCP
zQ>&5l^>*>Q*GVRWYaIu`bV)o8c32$Y8Yf3{DcIj$B}{PGJew>4Q!9@ZO24B8p#St5
zXg~elPPcm6J&$-a@^IVJt*Seyh|0=&G2GpgPbe41_hVkXsfQ=t8+5Zg7sM{3pvb|p
zn=|58nMN$b7Ypj)MYDWg<Oto-NmxpxN)ytLs+LoeR<3;%Xl(^1jh2J@$T{b(Mn9Bz
zxL@Xk0E?Dd41ltv5+^>ao9FGZ<J0;C`XzQu5KynaG{<9>ve=G{KQ@<34aQAltSlPT
z)Iw`wIh`Gy)$w3poznDn`b_@|BRyY)km<ULfIWlo5RX7%&DArO^MtZ$3S(iWDe1}e
zT{~c))KOxiTS{xGZq1lFzX5Wm<iS>$(EquBgfVi#@V3@Zq!TW$6b%ZBvS~Cc6E*44
zp8qCR^r=<|hjCP8j9BnI^x9K^?;ic%%!}lMNL{h3afaTu0`x*915$^0A8c0zOX2Bk
z)WyPOqVWr@T6#?{yf|U4Juzo^MIocSBX+Il+Y0)!ci5fJEv?p!Zd3y~Etd3mysV#=
zu34bG#SyHEu97Kjp0RW02B(EegnzHqQMix1727ce<U%sYs$8lQ*=45xwy#p@9uVLF
z;$a%1gmsM?jzl8>x}w)<(XtJ(3=l6)ZWuvPWIBWO`#^)1Y+kRlv5o%Ers%0fd8xiM
z<imF?wC+G-S)xr$f_Mva#tuQlJ%~JV=1&Op-5dp0<&6Ar8&9=)UvvKtYK3q1zcbb7
zQY_EJ@pUkMB-FwPPeDb7M-|m&?#PWR#X%%@nOo0=|FW_!5=c8$uoguZE#GKW{WfP)
zqm3*?lDrx(r3Va3+!pvI-ff(^kKw~@DZ8J<%!9V|2@3n0mIs6Gj^L->Sl?r~jpLrM
z)XTu8H3fz>Y>D0Lx=X1QqRQ8=^h4|iTrTPK&z0s!LF^a5_mPE%Gg9bAEfL0)s+0Sh
z9P{iBkgL1DUwt1(K36pbG%$_i7sTUhvDj<ZCXajlc*t%U`P|mm*hsRAyPb}D#@6A}
zC;ui1*@9Md%x8ZTMMfjyL&`TCg#}ztK(X&=`6L2#P5ps_RG&L_Wf$TePmP_<;yM4N
z|LTM@?p=}n{T9FY6TC<5VdBngWS{X9WPS;b61h~P_w!|uGR5ij%x4{Xl#KVv7i&GC
zvbGiZu)-#H>AQ)&*z_Ec`FXVBBNnaup8#76$bSx>A})|f_^I2j4T2q<xo;V|8>&x5
z$ikQx*u#=^c`GurJ5uluy$-|{oJ{84&7_|vgr95mZe(`(k?4H2giV51TEOjL23vV>
zOth7GRJDYZ6NxcA^qzXur2#XzrZ8IP8VJcxGv>iM3;O7oc8|;F++&}k5>O|t%Yj83
z1Cv@ynYa6aZ9OcIM|Y~B=lxx^S>|hh0##lJQ2j@kS5}D;fQytg-9k>+{a^xm8Bw5s
zuu1LWT1!@d0f^Q%$A8-Xeux~m@+U6Hns+3djUxUv!=;w{2HL2FS)%QVRDX^MfR~_)
zOik`}fSPm8GE1NLsIWl^Nd)udDYvZ09PuJX+ZF!_Q=CFJ{N)?61J*ZeL-PA=S5Mw!
zU?Mf8R-yqrk6L(%V|IZtE?VX5A2o-=ZW%+FbPp@$e!o3Ng5J&a_TgCT_&g$Am5zBl
zVI(Vw3$}5$`fm7y)iG$Pcvu`F(-3k@26MKV`q3$LG8IR#3s!^5QZ~3Da0Y^_8u|KQ
z3HH*{YZ~d~<VxDP2GPmp10XjYI}l^l+=do<x^qWEkbnr>aB|=`o@p#q>gNIpS-nT^
z=0r>vAY-6I>izamPm#6GHgj7aHOJTg_1{j_CTn)@f9{^hf+>&D$x8FW)|`EPO6<HE
z5S_J-A-g))ngEH%fA~)gOBWZJBlMwt$i59mZ@!-MsG}&hnJzln*xL7$vj`URcf}Nc
z5>bnv;$%D?Q(TrHOs~S}2uk>hL|C9@(v0yVd>YcloG#xqY}g+vc0cu<A`TH{-QGb`
z32Wc^R-Bf;r;0ZDH7VpfJpp!-16w5OhptnbKn(NZl4dgN`Wksnwzj&0q_L4?_c>lu
zPb&FG3HK7nCIwLC6mv*VJW*&?Bid%*jb2BbtB^kh|DfwBTawTO$p+QrTKZpZ$Q$L@
zeG7wonC*%1hlW$SUNf&QJssjF46i5ugzbwP?0{y>%&09BLw7zyK<5o?n0`SKf+TB_
zDlS(hd(+I4x*%bQ5-@#lmdT&Hdy&*uc6YXuM)7-*>lRd%5|M~;5C{sad0653*|LLE
zULND*Qua^jf>r-WJka4x?|**C1Lp8fJ_697f3`ZbLG~`rGW^2j<J*Aw&_ls(+c78F
zmS~1~%s26io<e18KMgAcY#^-NtNkeO#6o%l0CZ4UcoJs=j;|a;GCQ=$gU~xPL(jcn
z5UfXBx?b!ITt)vCu8(?62YN8Ho?|Ms4Hkt%*yX@3OSDHAYu-G!%I^`<yMw|u91fXV
z0oUdZ0QM^28_F8K!Ny6UM$t4W_%<b|mq4*wmhmVZEddI@!Jy8TF(j{af{4G_$c_CF
z({=q$+3(BhxrK$knmDeR9w(h2_wb|LjMezdj00pzm#A9p7*DaDjt^ACEf&6=mrHc}
zOc!uIbBhHax<s{4WrB=mMDAZ~<LP<SUkH!1b8dJ@og^`gsc$%;HgW*hh#uapXjd(A
z6_vRGg%_=M(JG*F=Bqy}H)r%LbabSng4N1EB@HiPi~uJgUUR9>5u_-mPvtWlwwXtc
z|Iy$f{W}G(vy3~ZM^8oMa18PS8+k~pLQlZ20<filPAy?6hbC-(zlTLOHD>&={Xmm!
zg7k_~7^z<-Ll97j#O0QAj`{1>qAcBhXI;V^z-iUcf@fIkj$fzI*0lu_`3pU$J{CxR
z{iD1W>D;TXHMgVYKyzJ?%)ncuTDXoTho2rCUqEU6umq#us^3<Y>@^%29Zo>nflpiY
z6-TjnE*&`IL@iVKKZO2cdG!6@VhNW5uwNU`L)ZB*4KABECn|0=+gyowooMi2zLv7F
z=w96+Ab^-Zo@j;`;@V5UEY*0eouH*(X^=ZmrUu!UU<rB4PCVtu8s~738z*T&SMmB~
z`9RE#iQ!7i4WdL*ev#8tjOTCUmeRL1Vo*><UEXhQErlGUITJ1SgB;XI`Y=E85mIV(
zl<>SiPNusW3>*|ra+d5$E?+Qrt$GkRt}jouUTL3=!rzx<jwd_D)QZeVF76D+?`4TB
z7!Y9*{My+y;Ljmrr?Xu_#`H-qjkFQ&yqCC@(GOUx@dB7-{ljsn@B3;+3v_gj`gc&#
z9#PSQEyc=Ii_#}_@VXFGeL`nUHJmo2*ScF|WRJI)>lOrHVn4LX8B>CJQPC<tL9ncb
zht%@Izc=GrajE&9Rq@|~ZCO1iZo;^VZ0>PTb5q9!lVCkoZti?q2M~)5P<pm1NoJ=a
zVAgFxN>qy98A>z)wes{?O;B(NjThv1S{43>1%}<O?=$LSYwVk~Eohy!VdEFI+NUi-
z7p4PhAzx8FTaUFcl*G0~qAwf|*r(8eNIgdnCz>7UKoc7gZ~*&Zs5`ev>kLgj@Swa5
zMR8@EybIiHcfG->Q9wLC`lA^~KJRXSZ`wDGjxIls@OFA=yBRfg@Oh-2@F;RwL7?=d
z{UeQt5iv_71q?QH{__9!o)=hxV=-2l9odGDGLu_izdzw1AntDm?oGVG6c<&PmYMk^
zhoEGt=q5pXWI9DeOIUbY5mmsaUmrZX-XI8~|8vSWtdPk}o1p`C8-9O<RQMf$1|)A-
z#;ltm6pF`l!Rq}f*y4EWOi`8o{Oe7F{I9v#ZV@pPXXc!Y|L1wkMy}q14sdB1S<+SJ
z?_h4@17=%NI=rL0B@91b$v$S>B{+#~8gMFCfdstoRd=$1YON!Sfj<lnTh^HZJrK6s
z74e_DgNR?HOFSFGDFwNII|pTp+DiP+Df>Q@07aW#f%Z*mq8C7;Zv6gnTEADqwd~%U
zZ&HCO&n95$#7$%i##7Pm^bINQ<YFn*CL6q|nN_LEnHL!=7x8h*y6kY3K?|h>-3em@
z)v_N<!j?T|bzE%%xuzt=GMq#BN!jB|>}_9UU-WB0*6x6>%x_v4E((EzRp$`R<dsqx
zcdeuH-nC+W2y}fv2#6VsoBP-rz4CnqnA#V)lHf9_*ofi3ZiC9)YB#tCmtYueznmrQ
zrE|PT64!@l56e~UP??dhV_;n_Vy_pyc##i8N`ee)iC$B-Q$R*B@?EPy!mxdw;p0KU
zPS!WAy^2bbi1-K5j8U6^u?S9s6bx|EHXh5OEiU6=4vM_+zh(40m8hOZLQN*x)JDBY
zo}i;6O6uRrlz1gm6=oo|ebtP0*iY-3Q!aiW<1tW`I1~(vimOWiK-np-`D7Ard%g@m
zxeXttisI{uc`vL_!`Qec6_22QlX@yb2W5^0`M)h$v^)KaKiNx3YvNG3;f3G%i9Ooo
z65u>VjnP(ZF9!^NpuUUWBJm_dIT(Xs<?AsFDdq@XMW%q!TA7O;tL!t7pgT$%7>rr0
zx<5x$Gd7?C(v~Be2dSe_v9mq{b3s#h?`oMpq-yaUyAHWZ4E-nAm7vg^+Y|*>kf{?*
zj97w8StC2C>an${juB@_ktHPyCo5OF-XWbJQ|ZHB51_%Fr&Jibi0u8ulMtoS<U1YE
zl=2YgFAPHb2!2dAgv-8>`Jk9>0a150A4{LlC?}vra>bDG;y1|#v<vy8;12`%Hjt%%
zc9lWWYv`xID4$k}F)!;+OfOSMkyGdltgde{MtYxP7v_8TBKA*C2?XbY;7_6~0c+Pp
z!)IsH(c9b7ghr7jrCxR|ZsS5Tn<(JQj2RaO`wHB?uCi1HVVBJFjj!i;S*^i_50mT8
z0jYP+fm0<AG0vRTvS)B1daVk7qlCw$nLiDG=d0NRooMINumJEY*_Xz`8jkkW2YS6_
zu>rmHOcIR%HJ{fUt!)jY2&oXdu2Qabn<M_l+4}pDQq;vJ>^n@ATu=yhwQXC^u_78l
z^%C0)lP{<r2ivmY;Ozhyqmc<?KEFL!D(PcYdt=FgVXM1%C~rO=xsJ<GXb^zlrsC@a
z?X%KreFIjAJ!S=z94}^x)rdYX9lWqND6woXH`Vx2fGXW8wK8=Ivg7I%7}!#;D!<{+
zdFS_x*9rEVXxx{%hO4&k4H?PdY7ZAm!w1E}#93!|J(YyWW{ALyol2v3gzAS;NWx<y
zc=GdCIxk8O|BE^gEGQH7jFzM=uC>kndSG&#-hBYAePqrj?a`^HD0msG+u=D0yE&nq
zT)SRvH_^or<YDh(@kg1{GGy|_-kwkx4TDGWpP-bO8Pbn;g<4S4#lxlD8~x()DW3`y
zagALC804YAjQ%s+dJ1y}q_#KRKF?UqD*jtxN_`qxsQ(1Iivt(-)xax`7rx9s2diua
zc)5|k?j*sxA(Y6}mNYdaN?ci{ewp*ZG2sQ+A~+?tZNB1r{6m)*$P)Lb9K}}<T_-o!
zNg>i5_dTJ$wmZFH7X<6uzyKpQ$KRWBtC~Z44DqgU1HVu81S2%Fo<5n>1*sHNy^Bc~
zi0V0~Qe{Y@2!(aFZBRTIB3XudO=v(8qlz!t`A@oX-c>L!$c;-WZ(e`}Rc$)qXcb_s
zRzuy1jQGm(_|&D2hiRoWofU~l9fRn!mP=0?Vbf&0og)JyGgcDQ4*aX}ebEea5r05a
z6hZ`^Jw~%Do4*S)v@E%fIN%$U&GQlTH=TXvIKWigf|5)r6!i7{7P`9O_W$Z?-^7m4
zI`HW)fp>o7?NuZSNgFNJstw$H%p28dYC@ae=Vtv~!wsi&((h&ngL+K}zl1y|zT4F{
zP{@3?Dhpp^Go#W%vIyU^*e2ri57f0A#PmxZVbJs_leClE1vub*4g*M_0Xe1)rfh)$
z`dW_6=&II>q2=5I|3<FGL_?1Q$_)1Wu{}!rqW7Z{$`7KB2ZIl=*QvM{Utk?H9>cbR
zUR({xd%+!)h5t21CZ5d63;OqK1>1*8<RtALF<f!9@cx^O6}i85w(~JG=!ZVl%@+Q6
z;K<3##@Ye2IJr?IVNNmeNM$UF7@bGsIF7X{_buH(QD0axUGR=A<`c*Nh)SDGlCqB>
z1#Gi{dbhDG&=wSa_utI#s!RF99`{8JsbDwsM~g~gt>wYlrA%eiEzP}lGmsv<QUO4y
zDK1S2PgtPTY?Up;04W7M!Nu;!@5_}O_}#PM^$W>^5gu<7{pteNzGlds>@9kd*WnQ#
zuo%q#*%9i3@3YEXJUBJ!P1G_B=BPoH3vV9BpgPD}#_I#Nop7d&sU0R(xHM?@_LIRP
znWF)fGrVMqIo5P&{39DA@iNmc0xRXCm(tblxili(AE_OG!5iJt1xy~M`NBiM5_K@L
zaZ6@&RUC(&{#6@x4BNR(qy1AAWCArZspGt{k8e5mdCC@{`~bOi`(W7VPPQ`7K-kuR
zIu;x9G_5wkZJJ_<m~xOW7P}I#Bkjlp1|KlLY<98>D}{rj(};zMDrl<?q&+iQ_OMv0
zqi$ICPWDv@jEVb3lP+ieMS_Y>J{8C7w+4ng`fVE=rd)C)=2zs}gt+U6Ai0Ea#aXXq
zl*7DwO4CQFXyui|)KEKyN-)N|2dC=~-gLOv{v`D}3i8S*YOLqP&{lTHn~sndZGA*V
zC)#9swq!_;s(j#Sy63MOiaW)vIiP~gMDG3~+K~Q>6{ny63SK5ofP9)xM$scN#DvVA
z2GdFz%FkZ)jV*^!l-UJFQx+QT?n#QyIYYau+7P1)BrZ#{lX7_?kk)frTWCAJR5y3?
zL;kQ@`e+Z_2N`KyaKiSn^)lg*qX<UuS7}^#WFQL-Z@0=t>i@v<Vym0FqZO8rP}Fx#
zAk~;kLRm1|w$QwN;R<~#j$FUM79?3F1GM44Piyv_=g~}V#Ne75Q_P;+4(mp`nJC}G
z%HdEaf&$7<Ok5quDIFRUM>Uzf3`6+JIjtK(ufVFk`YiGX>WI?bGa779&s=NSipq8U
z#Cy*|MB;hXAMHRIsA-$`mX>R!rD&U{>I#58<aXV<n(GD#zSgb=&=OqF;B$E~+m=-N
zGw;mqLqdDioC`O%tUpk8-FSh1<72w?ySuuzH1U0#FI<=5Lg^M;WFq8Bo;L>8zE_D6
z3}X=IHnebi^)tP2JPnQ#SAP3P3WW8yam9GH0CD418l~W5fk|Y#0!gk+c~R&#lxv)i
zu;}Yftktc1HFu-9*syV9pHZ%Z_UC}g?~TW*0Ih{Gh!P;@<=O@!ZTPY%FguQ#huns9
zKS%_?D(CEcLPwA#i8+NLk1oUV*h_+Fa(ZWy@VwLo*Z|Uk8g!#iyQ*G0ggiT?&8PR)
zFj#zG+8UOhO*a^U`VPi|>N*#0Q|K4}aVwbN4=7DR3)uc61kLAX0e45rFg{Ra6Rn4@
zYl-Y}qL1reqZ$opaWw5>Vv6fGl}MDq;HyZiJS&Jg3}VMF>Bw8atVbipmgE=iWva?Q
z@0)fooo{v_<*C-Sx6z}2qQ$xi(<T<6U=v5L5QIPyPgv-`g)t8s>ld?)GcW%EjmJ&T
zG$aiq+{o<EpvI+zLxK_=C$su}E7j_X`|tFCp-z@-uFPTcLb>s6mfZyFwHEG5fpT&m
z4*QHY2yUmO=47N$(nf3-p&dM>>kY!b$u^8pqsCf5Dr)YOV?^+Qtj$(W#Sy3_*VB$N
z%{Ghg|5cPtHXp6VO?SbN#dD&T%bO{MVs&|^HhMr*1{fKK89F9L|4yYgcr?CpLUhK<
z{nJMa`*IAIT)gtdUMYx0pu5KCB_fW51VV8U)3*%LB4>-h+;{`rDF179ewl}ojcxw#
zM-0OeLi7yx<}n66)<5?IodM?y^S)R;P~l>XEo@7iZws1YCm*k}g^-bjx7hwxrZhF@
zUj9a#!=4mu%TDFTx+}{P&2C+2iNY7_2bWT(Zlk^%HyIPi=~(T}U)aRiI~(~uI^vE+
z4}<m&Znx8l<UP1B-mc~aGxTP%wj}~lj?M#JQjbsOxor2?YX1(|;@KI1{C4+mNN<zj
z+th5)%(UF=c#wEu8=Ki}M2q_32fM8G8J|j&3pq(+fuuSJWL)!voVEImxc41rTE^Ku
z2JY)}JB~ktI&V+d9rxN7#jNRm%i_I5KE0%Q%0E?;-tCL~8(k2LBB0JtRIFA|9H$Xb
zFYl>T^b8j+j4LPZ5!Q|g6WxqLc;LORyg4c}Hy7uCd~V*u;F0ZG*8mazRCOxx`nvn2
z5i4Ds)9n%$qXaPA8d{VS&Y9|GfAps}MzLsvV=JSA$-qX1>>-Xe^z2aH4F-(g$@TPN
zQHxK<!iDWYJsv~Ie4>F$dKw63V4ZSMon;J#aQ*SB+u5pn-yN^Gwe|@6l-8?`)$)k(
zSLJ6&0V<);U`IjiRd)+#I--ylmm6=U7~tV?g)NT63hRB(<e4sIFNlZ|tqO?2m!_i`
zQ^X046ofT?<gV;XQO+97{jp#e_5WPZHb&mt2}o9IOFT`7ZQbiA0Ar9Nkdufc+OkO3
zB6G1cCU;*{uu@3Y^J>v4Wi<88Ry|&h#IpId`}ys!3AGxu<2@h?Q%c8ENGyr^+V-{P
z4~vvi8Ht7SVZ5TIW4aW<X#Faf1IHc6xpWBo-waxWurqaEJ_b+jE6-uzUW}C!dqEMG
zU6i-Tz>GhdH8a9hzyZAWm+pY%$U8mL!Q)Uf0Az5y1C2tFyzqPk1q&f}#i&%eB!n_H
z6G~<9Ua)f1HIz8pFx+A!Y^BTQ-SU!<=DZIp6j*W@U&?^9G4`{Zb8c3_!s=9M03?mS
zI_XU5$=#V;q0ovI4VX`sSD7KpzDGlY@DA1&EWGXoD_F+(JLBQ`o=tdVELpxuhuAEO
zP+V+9b;Hw3>C)SZ_~5V#axdfubn)jKRFP;opU6dT8)J1o3$j4}JkZO8+ScbvxvsWl
zOEOU=qNnOIYb%aeY||YDTycra63(;k{}sGcp;DN-Bc<}5vq&$qU`C<GoQg$!6=#{&
zzD#bNt}K4wvwgmIu2nCn3oa9-Xe*d3_oJI@HJt|^>v{oI^HNzUrvZCXev*~QEfWBn
z%z7<Yk5S)MLok$cmr5>`EdLT`1PKArY=ZZTwyy`RcOub(k|efq8m7}#Ir%}s+_Eok
zpa_`;jqW!~sR>BL;r$o%hu-V=4zg?%1aLDsZ-h>E*OxSrHAtE09l*N3ew%o!TxlQI
z*3{9^j(v>*Wd+zaOd{hF+u{WG2daQM6H1sfd`U9?E-p!7o<dL=OkC1O(5*1N%hwnB
z8)dw7BdEvkCuv?w(5HP$GAf&~&64u#n_yzQq|Kkm7gHs$Lh5FdE%-cQ9lXa%j;ANf
zJ&U8sDD<(BE9*6%MR!N5ZU|1exK*txzS~4j7M`ltG^ehQ7YN^T%>NJdsReCzF8hzK
z*x4_lM+C>FP<Vocai-Eg(I%!21laS6JERIIwgD&QLQ=A-_wY+6_yhOqeOU|((GFTl
zI=xRf=E%o0Lq09`WQ}t3!Y8!8y9T-1qZG+pkyplb6yEi9JecpH2=UfiJPW&H+f*DI
zshLfikH`)YwS<&c<o>$Wl$u4t@lygvDjilQZvAuQI~?VdQm5e@J}Wf&d%lrs5-lh5
z1pME034R3F!I47Q6TFY0iauw^zpjBQpu_*suuME!>0#kbPtrj>w0AQE;9tMY^vAKQ
zgRf|3k(|+Jf3GReFCJzR{4{t{P-mzmRQB{rmJqhmn$WSR8#phCx3q?!7C!Vylxcal
z^6TG^(+ip?BgwiYu*6Mf($J8E8hOl_dG;PaT3Hl3xL{gro%z-oyFsWPfmJIxNlaOx
zWk7kGzZ=Z*!&KsBdF5lP4$NzxRd_{W4^^()&XV3%FScyQh>9QJ05w3$zxB7g-d2Gj
zKNQxmf@^<I@Lu7`3zQ)CGObd*xMdJ`O4B61n(~U)RRme!-2*c>q=Tk1rzdkoSSnYE
zMpKSJdm4qUPgp_~cNqisYoV@Ud63Y#ir5qPz)OKrjro3#BzX~54K}MQOc=%T7pn)L
z&<GcBE+P7Ko;c_Ow?{eq0HYX*1X`6$t3P8wtDT%d`2Uj-U^YCKFORBdJHfXL98-C8
zZ&Ixa1T1CbG%_f&*TP99DvzIOs3GE$w>HmzFPQ4sFAtrDODOl;yx6sw2_tD*nKXx-
zNc}>tZ+6FFeK0T)wa4B}4S*&|FG0@?WpiPxgnWnHq2;+4fR0-oLlj=tA4XMqi9X18
zGzDScm4N#AaKoCg0)TVhLYzMon%$nP|82y*iyndvd(4|K*#4GF*@aTp&L~`tA4Oeb
z7DX#gz0Nf_b)mX>G}wit_(Z#|rkau-0tkuVN&UCLiH8ZlZ^$xlm;@Ic!KpLq6O^oB
zJ|P-9X$bQF>@GQsPv<>kF}wYl22ve#*sju>nIyU~BRR(4((YI)3JQCXhQP5b37sU5
zk8o60uA+PysYxw9)3%m8>d*8;8b#?Y6KxpN5&}mnVuAI)v21Rb!!VmSW$Z^G{{Z7J
z(sGtVagU8f8eY`cM|WURLP$)dmws7{49RguP0Hqs<-cN_oMrEJ8A9D0Af*Awos>_;
zl_3@o3Lb`|>KuYB0z1{m-3gwnl;f#zkrLTGlJhm~mT$2&!CEPi0DVwaih&Agclz-N
zCe2`t6R8M$!`vNXhq|O=$ym#4EdV;kd(&N}R;Uj#fG|&qKV`rl1I%l7%8Wo3tRo{|
zHvDSVAl+h*5--DTv(T1Yq+}XHOb{YJ{{*4+C96}DkV*WJ>u{oCe#L0a2)&6C>T){(
zuXIbFbP;-BMjct?auZbtUynkGAHA+DxN-Rf1gTa20SEA2Rz+#wLM<!!OL*YOnK1X7
zDhbdiFJU#|1C%JAq9p7FHO@IKwJ^AQA%&7#5ZTM28wDySuBy34%ja6r7s&{`<26Rv
z?VL3of`s><2G~#E_NTzn^6g%PkzAGBa0Prxfu~j09g=a7@z;&KfDF$;`JOg;cg@1Y
zjy#+e%}#iLh&dO7cgDxq`|v=8JWE58Kkyx}I_c(YS30;Vn<_(kmMC<Hh+Se?+ND9J
z`#IW365m8D(EfLK!%Yml7(6beE9>BQ%yUMCLE%6z6Zx+2&f16oOzmST=C76i=1}dD
zSB6?P|5R`>GbkBEfnScZT;=1L>27$wuc4Pq?08ssw}Bwbal(=u7S_kB4htqH!!B+R
zw@|bQ_2Ort!nX*hr6aDW>MjI(^%Bl@je3liPi^X+B95}(z8SUmvY3D70UY|6C#fb%
zFGefQ6uP@eYI;uvvq+oCIFMUSo`WGg?cx!x*PB}ecw$7-NX@!wLXyX1R*q?tJ`f%g
zQ<OFb@?&iBHNiwaV4y9^ULa84T;Tg1%Mx8&Dt6z0L%>dO+=IsE+-O<&`YwS-xdivW
zQ>tfR(huG4%9mL$--?NqXIRW_-)E}hH5ynZ`9=3LdP?duh?aNttmN5!Fq9Sn`!5(S
z{q8LS1+deCyH>8ulp*;v8()L|Vm8EpzK(BEH%X*$PpDwtwU=lFi3)Wyif=R$X{*#X
zorvw&ecR%+2t{kx1!@o*CB)Fl2acH<^E$asp%}jTL9QZ3Xpb&!xv~wBj$Oy3`k%A~
z+py-(tQ|(o|9>grU|hgp6T{^gCd4JyBAA2>-bF`hDqTQ)zCGFV!^Z>X@1+j)AxYM|
z!0Z;fgfNr7D|r_YS1gn$kH2L})~kncs8E@KSc<(9!lGre>I5O`;0vukny^2xKR<@u
zWz3>cu+<E5aAzFH?S9GqXeB%v|04(!2Pw=+Y9Dlug&Wm?E_QczdN;?K;_B(7>S*d5
zG6-F1L{jSr#4_eCHd3-L^N9$hA;jQ=apA7EvX--)2R|dz%yd5K$bX|Kx|TShX>BAi
z*yQ}$N=Zj7&47Oi@3$ut!h@p{fNY}}`rZjmdaFMJ_x54zQ3Eyx!EC=~an%17?Oozk
z%&Tz-SP2vo&p_!7>PYU8`7gRT?49+%`%j0R^rBQ76}%_y<FEKM-xwh#_F-lt{+xIO
z^P@!3fbgp6$t2+&B&lR23O%qmbN`!+_yz#z$c|p1M{Xi>e=r}Hf$WFyTlt`|s8q4g
zSu<s4nkNknQQJl@a=kHpR1&3Pj_^a@hmuvBryJW>S2x8T^G3(GDwXiwxj!MKAicWg
zI1%R(ohJLzBBTc>d3EYNtTi|jIUQmN%SUe2-_iC~JV5k0#&WfMU-Z0Ep587_hKnbf
z%2jo0x9^L?dAVL#jOfr4{rZOz9?VdFKuK7EApI2!=>$AEIc2Js1}s!c%F9|+a!M|h
zpLFGgJ9aX7nChcDw7O$?18ztLO}rNz>2f?Z;|FCWF(6bEnt*1jF_{kdBsv9)R%m+b
zI9qSN+x7ZYrkL;x>_OgsGkomo$u3)Q#Y4Wr2F;98_}RcF!zbF~2>-Q}{(&|3vF4*?
z?&KQkr^L($eL8{Vt2Xr2xS-MC3dnp>$oEo*`;=)PJt*Uk4)l3pJ${gNU(@s+sdpL&
z*wL+PQJ}7jjn>_1G*Mj$<MD9{6wR8N3W;pk;EE~u8dls^SauUPfpZlXUV@lIA3x&`
z{W(bGenN_zyrkBCA1yo%^of}kw`RczL7|PtGRcRpx(!sJ&Qtt@K#$V*VcZ!G-jm>Z
zvl6zOo3Zb*_l8=y&-=KE+>-I7@KmX9FH;Wt%LGH4W$qziLc#1`6y#49W(T!-WJV0g
zadd)9O*2eOU|jDqrb;>?LQthXS*x!s%CpxH@%IU5Z<G$4Y5S>5Bkx3H$cs<5Pnolg
z3!A5|J$h7<nP!XZr^LO$-ht1`Y=ZsUP*V8^V#BARBt=1(_QHqh+nIeF7OWUo9Oi4X
zaCv)TEG9gIW9MkJ!8eah#NM=yGU_J}al*EH+_VQJ;I$7V`!k#{9c0NtK;1hT`lN#Q
zwqO>*=IOSd+y-tEZl^A%x^q3SEplmF_kmOw+M^#h#}*bWo9c{HPfVf05j1}fl*>SU
zQ$>}j(o`FE2Ihg>D-#UnMZdW4tNV;FLkwd6WAOtTsD}+LwP#K~-#JA(Aai~&rZ=Ml
z_A`KY6@(XTWOEoet{VPkn}7p#bblv2HDr56+yNCcxa6gljDrD`GkSwcB>{q`E^V95
z%RB+7x#3Gc0K-6Hs!oVtcdw$l%1X;F=UB{yl)@Jl+kTvK>E8yNUb}bzb$Nuv=RG@(
zF4xS9n^qFWn4t?_1|c4vBuA`L+jHL9PtYN-h}WXrvnIAGR2@bSE111)jG8y5^oly}
ztDsb&JU58raqx2Ii2rkQwDyvRHfi-GmH>rY?b89C1&UsT>iaj41u@n(sOiNP=W{;i
zU6jR;=|QgQTuA*nhHo=!m`=V?6o@n+{l+w}k;h$gCUwky!TLnY2rq%MAL(HW%HRyd
zK)t&J{WU?Pz=$K_LfIgw=&IazHy9S<cAimt<fM;0Rjm=;LNZ!N3_gC*Z=%hu0mKK2
z>SQ%C9IoVSG569mwxbTOx~vy&3Th9VNb!(W$ng}ICJ>6%%nhi&TX`8s^)#J=;aD2e
zxDo0A#b<Jha*FwGU0Cjc$IEk^ANT)<HSqwjAuma2vv<v9|MjCMA&6)t=YibPt6n_L
z$U5&lFakRQXAnJK%MsHo=TlTqwcX_){A#S%5m5P3Geb!Bq{)2%17d`A4m^_&BV<=2
zLwb<U$Zy`XUJ}4=3!gE$p;_wTJX{&KS-E^|U4ipT-pNl{2rc(lMsKgYn*h=&Sbri!
zh2X67p$Na<ng(ci1r9bYJi=exym%Cze3Hk^-kGs|N$l27Hd^e?#u&*4J?n>-{*dtG
z21UkK-x24Pz6?k-^dy7e{LtfcKrUT}Omahzu%Mf$w|R45fwVyRzlfnH0Ejd}ebwL%
z5$4?mYg#PYfDoJCSrNL(j9B~!fAWqwm;@OH9u+&feQ(yjjiMySJD(_Egndr{Q3`pa
zmIScDzX-{)?uWGfI214;AU&c&z!Cn#1jyZiGnZJh5=T1Ym5VvFXGs9RE>M!&yzG6~
zOf-Z}+FPaqY$(daw9sMkm=>ahS<C%8x7wN222fQ8KADGQ@F@sn%zgIxpX1NLI%(eg
zf_#sWb)S)$fFeI#+s{%ElzbW~D-h7)%aOb?%OS*=U9^<+ft%E5Izo?t2V?ziqYWN~
z78{39aef(8Hv;dyKl^^oqV%RJxv#qxSK8|NB-PZgLz8PQvbDWw<!8=rs-w2|TUigb
znXNdJy=<8B{?VeVmH}ylyy*LYp!S}3!Wi(YiylYb1F9uqGpq+r?#M-TXP@??`h7jM
zgGk{Q{cNGMTt-eF$0K<;Ae##^eUHFzD{Gp5Jj@M18g;6`+b=CKrMl2tr%}UtRvkm`
zr8>RV>J@qX-SV|O=uzx-{Y`_mAU97)%aJb_IqtGEe6`p=C96@Y`W)FaC4_Z$@SSaR
zdTuXmj;V;8{G=<AnWMTeUk@v)XO_fz&SM^wh}ewwK`~v9w0~{=s;Pod+7Uq<ad>Qh
zOn|^=k`+hYsC{%MY0@}iCq$zWse+8x0K@%`S!k0ltbL7hR<{$!*gTcOWf+!;bqRpQ
zAqg;*`u#;w)a#4yN>c;vquSh1FK=3TR?BMP3@5o&v)tH|;?7QYA6C?Fb#S`J4s#**
zCxs&z8_x0tuGDJ+@@o^&|Hy3OnuN@Iu{>({O=n~l>E%C*c7nbAK81=)QaZc?I}=*6
zYu{Q1AM-$mFvf+EZ9dQYfWGmD`(@$lx7zDen)^t#ie#KaUMw>IwY+Tk7y~|@8abXl
zOoY+!PR?nu-R;D1whJ%_5j4qTpuRTdRA5iR%max)w@GFo(DvXv*b^Lmk&cd!r>7lR
zd)Kn>>x!y#70;JVwllk~$x@8mptfqP>8S)M$+O9ikgV5Lq25?`oB6*)(02hE=;xuJ
z4|Ilk2fZ`E5kf)nI={A)Eb&r6M42W{t4=0pu6-Ljr8t*Z`ikHO4g{XgE`H1Dwd$4g
zI^t&L1JSU3pc+9L9pB2QGN2F#^r)c5k*j?Lq=<Jc8f)<3^(AU>TmAEQ-$;g2srux`
zCDT{qcTB2N2w4BI&kh!<Mfm~cZzZ8VUr;u})W{zD<A_Uj5y-KIw!eZ~{^@Dh=a3kx
zzInqFV^8(jcv3R&@AK*$!UrwB1l|W*PXndcXdISAdP`x#8Zv-}_M=;o%&AI80(F_)
zr7|qUapQo43@AJ*6*%pGN{P{>B$uYlKJ?`i7KHC}=#5TZNnXh`QR{0fq-JE<bUf7!
zbg)$U?Bk0}N%O@yD7vnQuMwq?M?ExZ;>NG18l)gwztjip4uZ`2Z?;19C;47}TcliG
z@sDcg7FxE%ZxrH}Cjz|ku~tEPZvWe93eqd#*8r&^Ay3u#U8=xKj?5BGETO-FVK`ks
z&#s7~qc{fdrI7ULW>$&`h3~2me~uv)-7ZAT**`0n$0AFRg}FWCAAgJWJR&uJK4bLh
z5#^jh++x0E^t5375IN1m@x-%TH0fNNzvemj9tL#h0u2sw9sz_A6N`Jfq>3R}Iji|{
z>7rlDk)-OSM!w=PJ3A{AFnU>RSy-mXX{W(Ta~*t}aE<}8wxx_or;73)p!%&5`Yjb`
z#b3|B0p&vK=aCN;ubjhicW*SH*jhCT+vL#He{(_W0cGrVvxkqpgEGxY8i~#9qgw8H
z28s~;k_&$u9_tE*pJS;w(n!(4+d4l8Fy3<##hZxC!s*F7DwAzb7+D?w+d#f?&mf<&
z;LKq4ZuQp2gH<OY<5){)DH%n>IH+|_qub$z*!E_UV7QIbu2(QnJ=hnNDa2<T-g&@$
zrDduS_~@cj763fmmYlHS0A4D<$@8Q0o#Fp#<{ELa%k^g|!%$Lx?yz;H8^jqaTP9vM
z>EB#)K~X6}{Ex0a{-vC<P7D=@Z)YxDKJNthApE@k>=JdG)V8um961eZN~xuD4^00(
zCH4CHgu{>MeTOb3W$nK{eN9gQH^-(vYUe~IvN&E%({R?^N6-#uX)A3T?X20JX?nsm
zAMnvPan7(8c+*^pEbDb=DlefH5|i|DXl5vUjx<qrX-~NOk&Mz@bCq8AIx)5byO8D{
zP6}qj+D$nax?r&*vd>GZ9(f2r99I%$E*{pW<c6VB_{`aikcdB0uAWQ)i)-P!OZIpb
zpwaoAgeKIY8qX#t-;0wTjeat1;JjcM1jo<PN-8BF3jjH2*>mDwL2ZIw>&&t3)N+4l
z`L45hFo=c%NPkX4lHg5KRtDowUZj;z_cXM<@P)21tYh2_MAbmBwZZF;m&GXDa}w}+
zvjkF3Mv89a60e92Le&c+;E$kto`Bol=}!7Z&sg@eQfQ(=wEDjC_}0BtPD;+LekezH
z)>bHt<XW^eo9?0c{tQ6!&)%|eV>iFkFSh$i;#eOWqdLE+T+3g05@lJfa6>vKtcJA)
z>Hc*r+Q&b5GlNbUz$Z8orD$F8t1_E@?WH$$+2{>cG7FO#z9DPs62`!I#B4p6NKAC)
z-@y7(pQ`OqPFob<t~5kP0d3)=YKKts3<Hx36;QB+{f-dZ!EBYR<l-3~=>nPnYF!<U
zD%vz@@+-{@)$W$#d<~u4Dfd&y_GL6&+tkWlSyZcOx*?~x4JGa66QOoBn18`;aSQhF
zjwjV`8ykW9*|j$LhT)?TtGIE75*gSvX^g+<Zm0G02;B>++lGa{J}D1rNN`q6NuSXD
zwyv(}W}+W0HS_Ep(<ZUr!RfGb6tuU0S95EI8C$Z&JMS9pKm2fDS{5Io;PX%kqG|wR
zIZa&a$Y>7EupZoILVRC7n^Fri`-9J@rSl8U!IESbcU?JJ1W__=z4mwG=Hw;JzCn$H
zB%I1o0wWs?G1`#5<k^|(PH@B~wRdD4J04B%L{D$mX2@{Ec4=^+Rm~D4E!HOwnWg>R
zcF+XB{Yq8VwA+&{6~cT`To&lu@#;w7@MT6kOKJkiB}FHLoS3NmvC%-IiccLcm~D*|
z-84G*fN@zzUAt0^>C!j|8NNMpH6Kh%3YwzanRcAnth;1VmW}lqbL%FjWw7=5=c6=)
zf|1Aj3BPA}DG;-(=-mgSOI`m;?9)?qV**PtE0u$UDA8O@1GQ=4{UP%xHf24^u`or~
zcOj#GT7LLm8xEAExMV<SBt-=>ltq0yrf1s}(J{T69dQU>Po#Td@hGuas32A<_J-{e
zyBA*sv+IA^GJgzNi{*@WS1|0b;#oTB8HSKCd?MR!toqBtqs(iV1Fe?XBD6^2@nES2
zltm0!?hisJWyN&CzO8cqDLY6g&TN8L?_OT1Ta9Ite>YU+@!nON<L~mk286iFO@IN3
zMKuUNV%2kwNMrC}1@lnoi6S~3($5;^_541KTZn&~`T|QA?NhRT2WkRPQiz`Hi*rS4
z{bf)%7KSvU<J7+@#XKK+bT?5(fQ*bLWj$bGn_XZr@c@0S4IrA;I)RrhRLZ@~OR_-y
zyu4{2k#*S2d8KjTMz{mM&`HuEjNR}YlePx5w-p%=<7d@f(zWQAe$!~$mE#FT6%7)L
zTx?Wv5LHlCzg*1nAbYzl`<0;a-zE^Y;4oF)r&9AfXC`W>n2&y*n<59j1H@)CT;6ke
z)_3*Qx&GujKqeP)OBXEW#G>PR4?(&Uf9|kT88h3^gpmx}shZwQ>cGkYOn~~5K5FN1
z?=nP&MRofBI43Tt>#~$X%U2MBfG#Di#nzC!yNFott3<L-m!&C8`}8GwXT)sL<>0Eu
zoTAUvp>=!q<Z8+NxFZ)wc#yqhuzmLmY?>CTGuK^K#f|YjGt-Dms~2*mUeFaXfr$G^
zq@=!d_wz2-XRU4$-V|TwrU=A%VXn4%V;ieQ&U378eamLCrJpb9_N}*QBsqC<*NZ@D
z_or{`BmjVgi5g&tyD<I6=tRnkw{zdJ!%AB7rwFFghpzF9T7NhF@3U>*w3i&GnoQSa
zT<%BYU5c4SL*T!1{e~!C3FqO$Oyyy$I75KOIsqDM%p6n>*)5Bz8`h>R-FAjuupdnB
zYxtWhRk5KXF&-)p0vlmMMcC`3pA`KLbWZWGUnkelAxeYm9ZmF+x{~OWd22AT0*pFS
zK>D3<-e41kq#XTOh&YQ)2!|Ys$Hk2xFgs~J$i@B|G;j;sHL_py6M-tNfDF5`&Q=n`
z@(Fq_^$R|XHoEG_WhRJ|jjz(Dbn_#(+}tjWz5l&mZ=pxPGNKMQy(>=mHT<<l|7=_4
z#%!#o7f$b)XM^Gts;eTY03S$<Tp8gnJH|c%RetXC*ft%_d@%8SXsKM|-_k3rI$H<Y
zjqUGPEma6#{kIwgYgSPSYmf4cXD@V1(`t$a*2CgC#MRfyZ_eN%4Re8$N}ZUHO`Y`a
z!=r3Ct{P&({d-mTrs=0YA|AVkyic%PcPvwW@9#zEqTls8Ou)eb(&r8+phSaEa~+?H
z)SgvR$`_1t$||Bop?rbd)bSx~bNrLf?|>+y4*e2|JzUsUVB70bRv_Pb_7Rft^W^?u
zzQ0r^v(F}@;Tqbr@B0Vv$1U$C>_RV0cpLl=@=M6l|K9B+`I3TMJP2RQR-REhsBS#(
zdG1>Jn|+hX2TVHaCSU*HOkT!3oNY-GNV}wxsUUgQg?9CD$c|71d8QZtY!2>ld685f
zvkPl18fSca=+ROL;mA(#ti<aw==x!{Kpx{1<^4LqJe+4@dfeScfH}4yJXI(bS{Ogu
zYrBhH&N{;gN2zFpOD&G|z7(H%Kw*>Q8ie~1+(V$gC1<oYBDw?7MOYw@LZ@ZkR^xvA
zOV&C&VBjzO(*o9Q2f9T)J_&}aj^6YVER(<{OGewlMwH~XVDgknR{!;Q0w(2*0;zvF
ze{2iqq+fp=qpV#s*tymBg$yBn9t#q=pK+9mu1=yIx-QmPIfE`CL=C5Bee#`7<<=Ab
zE=P+K7$(<Yt69@eC!l(*Picped_N1qB!RC;9U1AXpQg<2n(NR<cOB*2BKQon!yv)%
z*oi72Z{>tYGh@|D%Q~?K!&eY62TlC{9r+NXy=%Fw`Q|;+kYfgW4#R*pD&z5J@IyzK
z2b|h}ErdJ?y$Ip~WvkdsFR;G<e3ULY0OhL3Q1)tMcHeC=acTySAG(MaPH?8IBfeb1
zvh=b~UUSU{SE6Mk^#B_@>Y4BCCj$#EeV1&$cDN?!zdDi&*JuQSCM0YgfD3uY$nzO&
z1-UyPS*OWD(<UQCRiBc4xK!hw?kRlnM@AJNDJ3wX!%RH>ly{N%yALzoYIoJdto&4E
zl@mV<rpx|o*_}gAtKjdQ>{&Rg%vYV}a6`p&{HUBLI)7ogg65#*l6j05Pw_<aa`k*+
z-Zo;)YuGWR;wEj<a--gGKljlv4auoR$64FkYXGn~5fxRA^Q%pUswuUf?CXL$yg!4%
z^O3L$iIDnZNR`NhuV#TfPZ~bxRMTM}rwSA4pOyE#+|sJU7~fBw*?(v$U%LRi=>c$3
z4~)<v(IUP@`FsYlLn(+}?lDQgt2v!dY!7#8>{$>5ngx^rAxE7VT%KSK3MmMuxT;ci
zKv#g1f?!g)0jr#p1JX}|y1&+PwFMt00i_D-scRc2<by(sgzI|FB+SeiIkfI&Fh?cH
zBwY~9xI8QTQMDB}1}#OuWN6IzS)%su0z{!73Eol(TiSlkZ;1Vx-E>pbnhVE~yG)e9
zlcmYgr_ws8o+!;7O8-e18aLEjdu=$)Spv?IzBtBp_w4GT77m7R_vm9Vy})({X(gB@
zpZ{#Mt*J7|br=p|w`FBzwF46KaYPpOD|e(GS)a0j4ecC6q!OTt+Q=Y#X@~40_z2oe
zaVEXB<g81`^+VKb4K49pxWst!u-pmI*&RTsGi9F^Y_%jN#RG{QITPXBt3@3mrsCYB
zLRn!<;@Vvc*@6*ZD5NSB>G)1iVgTKez5D5WWWq%J?!l=|G?EA;mnz#qvQE>93MHo7
zEm)20?!Nx&bW>UJ;J#4leZjM4#(1puSFxT3HHLt3;RB^WEioT+wmo{`o@<4#cA{p?
zVkg{sQ>ncyNiVMOm(BB<D`oyP$FI$cq!(>+<!7@2v4!c!NcW~I<6Hc1=%~2F6}Fz;
z+6C<wUW)3ucm0KchDnZQV@U~;o!*YVSido|^^*<(SQ0XsV)u$cVyjc%=k_AA#$;N(
zXb;^r@n~WVvK1|z67ic4fZ3(Wv{Il3ie10OZ~(uITF<FU?H#Ia(8uM?4}opkPXTb(
zhJLuUx~*cH>T`ffsqoX4TUdZVM<muwwBW&E8*1*vSI@s46Su1EiyXO<*QZ3AVF;xA
zf=hZ6^rq_{x2ZQ8d}Nl?VrDCVuYNBPo#dS=@N5^aD%%$@SF%nH#<_LVVH{a|MlJ~_
z_|-F%5gQc*)~9iWqZf-M-&n&S3Euyra|Z*!L8{!Gkd%!;RB{GhC~0LEQs6?g;6sS}
z+{<s9b*$L5i9h8FyN{*b+n*JN)XM8GV4TF=(t_h5ESodAr{}8kEqiQjryyVT(CYx$
ztnQ6!VJtNHViF;|zVl<{1I_6aR>vdzID5*gBJ@x-{`G$(YZIDVZby;&i9zQfmR#L~
z*t{1SMHGcMFVbP*Ym~<F^@&RTHK@(Qh?Z9LH!74dO?X{+3+e|{zXu4mCKF|+X49q{
z^NLZire04yRq}v=@-0g5DMGCcTKa%tNvt~cVnxWE1W!?wM%-LiGmx0RkP(Y7#MNFb
z%RJ=m{mTrU!}9qPU4WU@r~1$evzSN)kf=qrjWtnM<Rw#?@_%`x`7=;MuZVcDsv|3I
zm{4g!o1x>2nhh0S9{n>8dk5iqy*1D@U;~yfB?IJ=#E<UAYS5=j%OZ^s{X8B7Qq6<(
zlR56}#p0d5-}t1Lm!pHrsWFF6{Ul3$su|&Z_BD<-mccGbW!wEw{sRGrf>p}vxiveV
zcBpYBtQqc?WIm3KU9Uc|AYYRVc@rZ(=w12vqkIsxfm)7f#T5RdQ|o4I^4pBLcQ|9k
z^#h97pY1BPxEt(Pzpv_(clcTjA0<EwihSaZ+<mGlnCmc6_C!)F(a=$qCD-Mooxt}v
z*y^imbjTpXY-w@Ms&TLQ1VFQOsqx}$oMT)}STJ{7a<!jq2cE;4EIy!_9Ck6BHoh^u
zM|6(heW?n1OKi-yoJHd4Kj#&t?KG{4fV#WApVf~!PKx8#Y9sTGX#v9Vizu(}IhE()
z%M-9m?Hs=q{2$lXMaRIESFrlz#I6S@7GNb&f;?VaVN>LJpQZIG_Gv=y=cTaK5o1i!
z*fyvvB5_8d$#w-ezeYf3y{3o5mHX$2O5dGai7#EQ>%e(NTHf=Ivy=cW{+@WjheNgR
z4nNG~iA2KQoUU4Bw-$SD?LpMCz|*F0c#E5wDqvhq(KO05_LU6CvUIt$c#4~%tvYkH
zfJ?|P2-~rE^gbx}oCkXANd)nzwAa+2pxWIH02!&=V3pD~+lCuIy3M`FKp_{xt1*5`
z`2Glr-0;akMtS(E@to(pydaHk)Oc;OuWk>^jz+sq-;Oh&nOW4{oHkM{+PZ7@dXhbI
zGgOSXAopWjOspHK^rplnB~XjU-lH}9E0_rj2WPaHaVG28oA9^QG>dryv5>1+rZufc
zVjbTlK|EpkqVKaJF+X+*Fw$u}sy4|8H^y3QIN-x2sd>MCp|Yo8D?8Abp3tc8tcn5<
zZJ40U?Fj+f7h#=5$}h|RUWWf|mdi{r(pk)WPBn0Vk4_xRh;8+nY2i>{)$Hss!H8x5
z@P?N_``ZlSx-yqtuUQuRXs!%JZJ&TWl`LNN`El#e{309oU3x$fR<!bmrM!%}Njh+<
zEq=i1esOJ(+@$$OhS^T)7`1wd4m^l@lIl|}jHjQ%#v|_z5<F!Skbqw*i1<q&E1w9d
zbE$jgdY4hZy>^2!4|nTPjT|PV$M40->I*lX42N@U4dLo(GJy6Cphx?u`7_;@MwJkO
z_(g_^j}xRDpPpDD2bU==hqPN#(0WBC*)it#`Dw7!q@axac!DV|ItlGJwIn+d1Mji<
zI<mPo2P8o?L0~-eZp&5OCMOjj7J6&y{ep~%UOH@+bgQT4x8BDPEpb>#+u)-L>u$09
zaA6T19-t49aF(k-kDm0a<}8AF0Oj|RPZ5O11|bB>$7ZMDT3c+r*4TWOC^jJf6}9$@
z4~2Z^u-N)tGRt0jX#4pX<%wU8p%s}pnxclbL!}Ao%35Pey`Cj_kJ9lPk8w5m7OEwm
zONvwe!B1c~A$De^AqKPLeEjpLhoHI<CN?=Nt++VJsI4LxFKs|sKY4{?t@hnUD`X;}
z`yFCq;eSVE`v-M-syoWuJfG=7uoa6uI`Wl5B|#~*-BfdZ{_-3*41|-Eo>6AR@NCYc
z*0;b^St_bn;aHzXmRuMQ56f*qBK<l1aXU7`n3|g_`IAUM%JfMu{<AiYY+;!cq{mW0
zEpM?Tf^aa%ET^Om9`=rA<oZu(9;r-uR#57oD5Kv#+Y6m@FlH5LkxT1q|3LzYYk9s$
zELk=Fn<-ncS_j5JUEUHGfa8f8c3hL&%h3h^E)jMBC-7F9sY~<MM!Qm<e$e0}I;Ja6
zV!O4&s}}B0C}t6`ANP&02d-Z_VECe9rJHaLUpX6v6KkkyJ&z5PZ*~U+eNUh@wZ_(5
z6EOx2D^}l5tD40v_8?<g6wr1ymZL(zy5Oe;f~l!<dJ}bx+eS9AWdF?q5-`g{muw`(
z4iZr|-x{d6z{%CIZTrEUz3Uz<^xPqp?s&-|H>J83zHZyE)a#y}$hSIx5T1h7N$bZ$
z+jKL(fXlvLx=NE)!jEM;h7cbkV&3ySpyfw_RVg>5ooSgK>Y`Mi65%|15=Vj%4ax*5
z_kA^XAiyXv^>HO5AezHL_Q62kgH2<I^8L5daF-;KaCj9TYGeI~bzc&}I-iu+3y0>#
zoJc%xiCPXi7U0LE1}^oRm{t;d*{drGvHxlB1KFUrzl;ccRs=%6O0;%D>HzS2ccb~d
zjtBFvj^4Ziy1cxIevcNY<~JK^7!eT)NN9T+m^i<(A!yLNP#ev8Fr#5VDAPbD3YTte
zO>RfOLQ1F{wlfAn|MSyfe$^_9wqEHpu5e~fx6Te6f)nSV?@$SI^qBemwV~!-NI73q
zH2&_CS$Twta1qd-)fFONDJ;Z#G{{e~B~awJOG4c3tv@^0eS<jIc(D}Vy}idm&cLD6
z!U=LLP}p(~i<>5c*%Pdk`4S1v4Zc1q(RvQ%{Amb&K(h#hG?ry3p#NHG)^41+Iq;}{
zOy&c{Rii+&1>{)XcoATUzo*|Qkj~kx<eM|>$k9LA>Xv1@5Bp?sQ@FDVtbm#XJ~P{t
z@MP~AD_o_1LFKq*-02tkPuMd$nsaoi3X_a&w3M?Mh0IEsNrqq0!364^njl<nLo>%c
zM;8hCog(hN2?cd7`mAy1%~kYhS8BQK{e-XRLZPo-^<~aQa8xXS{7smleUH^R?z5GX
zHVsT*W`Q?TWmAne{H=&}2Q3%(uAak5FhH^q-cnfpJjcd6oUYWGIVENi7mnUVByv*w
z$+IDF<{|?@m?`!=JjiigmRXI}eG>Vi139t3KeTVUeiTRVV#PCThpDr<{XvPGEz8k7
zEFZe(%7`>vz%SGOPLx+l`(12IxyOcvaD=scs9I6<%S1`cf-wkDGPR)=Pj8m?CPP|!
za|>vvzSVa|?c30%T~(RPW>bC4RJuqA9B|+{C)b-SkGW=&3PQgvo(hI2ly62XQ5rR#
zYEURu1tc8)bH-nZU*E__-X<xsKC59vWyK>_787vi4@!XkdG9cF71&cQUaoA0dVRsQ
zz3JsBt++jWbP|e8G|>sBSg0#B8;*C=-(Svl6?RW2z6p9doI~3lO`4|8kcbz&(JruB
zsv-TFci$$7hJ67Yw9e$q)duXw&MNn$m60!9g^yCOfN}XY6($$;6|`je`^^Ot7#lOC
zl#^+J6+lAQUGrrg1*-|3u#^4h%9YIgFG|cKe2mS`p|x>}b;XHD{wf23<FF(7E>&cy
zbg?W*i3F2}yL7|S=vrgqWVW^e<asdtW+JXxEJc<g1|7w+al%7BvXE+D`v9+ob;=j)
z<dJ#t7>gaAg0DsrQ6U<C2nDa5bEnETj74a@23du(_dynHuA+FDmSEWkQOCGp7Uypi
zO-gyc#s9?G_9V%A?@6=E*6X_f{O(`MO7gzHW^|@+H#C8i_<-#;QKE5^CqS!bY4HCo
z;X$4cMYIpl>kFaPmm?xzVrvsXz5Ti5v$VwgrQk`?JJHDS(0m<envtshIS~{achp~7
zMrHn7_{uIL9`en)$1^}43TMkr8VEMXW!lND->a+v_ifhCAJ3QXj^K2IuJ<{Tu?F>t
zUdfZ(RfG!dZG{dXMp}oSI5z{0)NM7AD?<AJk$5@iPK|l9HMM4yf`LAyahsl3_R{ag
z%>O+dQd;_I^wD<SVfMn<Rq1Gp63Zp3d(0+gm@ij^#wNpzZ0{<CvT*NakIFNrDGH;U
zmfCE2gPhh}CkF1(tEN?_Agt63iOipRc`3*fJ?04&`<alP8+aPGtS|nw!xv;~{4trJ
z(VYjY9vGlOwCrP;?9ick#Ui;`U-b?^r&})b*Gn0OCjt8tNTMT*RiI+Z-`ZVNjZY{{
z(8ItxCZGS8*LFZ_S>ra#G9XdzC=ILuti{w`q&S*c=<VJZ%3Cjb0Zvl*fqRwDz)2<U
zJ|o9rNO9(K{?*$1H&461H3D4tGEy6MX~w|{@A5Zxn5|KTQCJ}&R8D-vlEHjdANML-
ziQ4sDPX5@_Gv4kk<6OW73gt!fH_V{gr%eWg%yyPsLDmKk2!2Fip1|GI7dZ(sazVw=
z6O7hf=%l+dTMe(3n@soIKw^bn;Zrt;<Pe=p2H?)oobldI!0G=2X)r%6!Ws)fK4`O1
zI073mU<+5%v|{h?fPDID*zkD}iW`jw(+8<y@e03&90$tB8EN|hek14uJVxZtP3ovc
zFz5e)yjup#=z3{==7%P*6Y%G3Uzaq#1m{nDRa}1EF!N(?71Z(q`yB5%Wnpl**-9X{
zheuIdO;DE$o<*}wdH;pU8Ry?n(<Mis9WP;k%)G#MxE~G5*1}0DLd~~8PzIms*PW)x
zW%-TyYMrp5QUWdPGzojRI-RumZjGDXUS3~zTt(>ifbe1hUTY&EW;TRJ;R%_T!<85l
zaY(+bu6?)6;ow-J&C|y|SGyLJV4s7;WdmcFMR@8j#5YG67JExqN^Hj$hZ6c1b8Q(C
z!^+;7NXR0xcqYTh7HKNTgRj$I#^Zz{2&Di*V?+yT36Z?X%GUFv8-rut;>l{f_!$rI
zuFxeFft52#?~H5=xtW0I0rsa%*$NotM@<p9sMkC;!c}4%ZWwJ~?^hm@`n&P__P(`d
zaTf_o1qf7<QXh$U^up3M<J$!xvW@f_Z)UcvF>w+DFM)O5wk92ghFoLghpRDLh+$xM
zU-EQyl@7Js<*@lhvy|R_romX7=-s92VpI1mcWw=<lO^P1YuNt|n(rkTj<Q&vc<;bh
zWLX1sXz*loFM){c2)u^hmSSNOQ`Q?1|HuvS*2Kr}y(U<gjc!+qJVgG@x!w1d^!c#Y
z8OKX79Fqm|x0_~~jG<g>)l(oFN0-hv)&31n(l@J$NckOk9cD$M@JM8G=x-UxQEdZ6
zrSc5u3sBeGw38mp0w*#09)j!ac&()miM@uY)Y(Blpt2_4nxhv+MG;K!)ZL*8Br3DV
zV<+Ke?2Jydkz23Yu!_r@<9ml(CccHQ_GjH}gR!EJq*x8Ii>uY<@JedSXRw|b%ZDxa
zGl;ENF4fwW!pnLZL1RvTlGMv@mjCg1uF@BFoymd*noSC|I-1`fblrd8bxz#<Np@jZ
zPXvn>p52IbD8%HbP(O13fR+xM<sEGU^=UhXv9X8kWb^5yio3dVI0;|aBc0!_7C{ky
zWx6S`0qD(E|EnIhsmhl;lo94>b4SNN9B9>mJgE0;6j2Cxxn5a=|K(r(Rr*3BoV%&4
zB$=T<#7#FvF4(ETba^_$Dh+ea^w9t=wY(aiM@@u+y-0fC((=u~6%NnrqJUD2mC7>B
z<46@~3(sifkFRdpZMapsD2o!w5j!8N9uiEgks;buwM|}5q}QvLA~ym+){)0L`U66^
zb<V$1G}@k~{vVy3Op@C#r6t7@7ubnr@I5nNS_3S|@+bu4xF1?>_RMr=WS!Y944O6k
z%a4nyW!~cP^KCsM*~jN)o){F4=$sGn&_uO%Cs4NO@!~9<+)3s_!aIEMqwV}ydc>}3
zj5+iMBxbTX_UPdm7dozsqrxvxhXnhfxJ{eG?tCS?rf#GnHIawS(1vqobUuIOCfCPw
zBe$wm7|H|#bGjPaESn&Un9`%eMU?{t#WBz(S(2O-qMo4)Y^mjQsF!B~;?xG@VJ2PF
z8Mwmjk4S{UCQ7f+UAGHI<fxAKG;H!5J5K4m4=PC@`K4h}W83uiWtXph?Zr|)wYk>r
z6NX^a=MC$4xy2?iTJ0cUpc6+hpLc)Sr2V^<>V&`{zvRJ!--Bb>Q-B!$b_}Ku&Um=J
zGCLng-Cil$tijdAbLKv+bhc=MBe<`Ii588L0;Va2{11QDaosD^@Ac^1)ONI1sB#tI
z-SWX6$20G35mpB|?SW0H5Lz4j(RuCo>>TZ();)*)mR|~6sF(=!J}OqNni{~MB=sEq
zH4ZA~D?8j`A7f!O_{&H(C68Ayn(V~A=e|}2*{ECOZWdIkj|W_O9a~`HY#vT7{F>%S
zCn~VM*fTBXqgt~kGjk(GNyVKFDPs-GjF;;ir2Xm_;f+I#93}szn$O77E%5H%lsfKK
zFrNeFQ$`*%qBIOSc}GI6%dUT0U-3w^kpNqWTT-aA$nj-Ug+tQC*}i@<z`6kbA)-Hd
z1aZ7)6DhBa<C*jd{fg9-=3ERarf==S#h^Gm_B)%hkE_tCJ1cp;9@LXZ_dn$xqt6L!
zr806vOmkNX2kZlyTT_tjV)8Sm*)S0!b`pHPA)9^>L9Hj}E3@1_!W#rqaKzD{2C1<A
z>|lHT*qA@BwHL{DiXUG(=l{48=D@|0!)|*|_XGSgY5s7H<=LRUH0cEwv`*ozAedU!
z?pMc`hWYXnGnRIGLR_kXc*6n{?gZKZz2I`#44hy+lvE!f6_u%@kdKlOjGWdj--<|h
zT12#?-w=hfF?Lr_auLtf`(-2!Ub+5Aol?`x&rR`0p~wcaSmeT{4do_T(A$7RVLC)L
zjhp??=EXX~2A0AIJZ&cTe?q(^t)gzHh4awnfkVXL{3n1qy%bIDK(Ss_=R085$REgi
z<j_?Gz%&@BCbUp#$Ev!U^ml~NM;tM?yUBnZtVAby;65^_&ouSjvfSg()3v;565+Pr
zU`O7H(uW~f1nLy4U}_Z5l8@K9B^NBSzIAJW2eshm$Gq}!9}R;^7<*Ju!5w+|?WYBY
zbv}h)uC3HLSq-uwZ&sJv2eIRBU_v>{xW*hlNr9Xv;Jf?Aj=RNe9(cFg;!9HGHPSVC
zI4+gW{HOP5RUQm#RNX2%LNOkb(d8kpw9yZ=SI;-FQTZyB=wSJNZtF?}`q>UqO$0?)
z>`*Q2%WzndbX!o@MoQVd*fDp60hk6QHijmoFPHR5MLs8okpx2LqAQ6$FnyQXyT%#5
zG>~d2eV$1T9zsI-K8+lkmJdZuAe4c3!!H_sCF&l^jYZxSAFRGd6$9J>xW>)8*;=hI
zpGOBhIu=;JFrbds&Fx&9qWUzh7!ZZq<)(VfH0il0xxT#_N{k)qD2o7eg~E=YhHo+l
z2tB_Z&#oX3c~``#Vrx`48(>)CEZPUi7VOFAv#5azB%1J?kb@rLmcVExl$`cZCEhln
z*`8GK`6Vv)xWe@U0-i)7E8}L(<bO{}<_mI>>Q-6CGDcH$KR@8GufAR$Ba{Vjr4DQW
zOuGXMih7eWfq%{7LkvHVjs}kr?$poh8rAsYWF>R19dbJP7s0p*+0ZH@3>w9^6+H;(
z32NCRH!HiKy8+G->AO?vj})y_^g<JWx>=MvEyWOUd1KmafO_yYvr3nXW^KG%yAO11
z-gPQ1KVYr#vl6EH_KBUSM-1n$ql@U!Np;LnHf(+%{jItSD%>L2Y(6#dF?q!16JIuG
zeg#x%fV-wH=+2&Xe%Lpt48O^#<%MoEdMU<e{r3O1xNyJ^LXOA2YO3ylB4PD<>oZx9
z!_<1E9~1p~$Eb;vc@*Fu@Qj47<QLd<Ul1_F5}DdE-&oe%$wNC(DezL4Gi`_Ao#f=P
z8}A4M${>Eu2mzk^M^<!!E+>2Dj%TH9M!SA3$M>#9F;KH!je_7qTnwYd_bURk-INQK
zas&OqYdU*8905#Mh*h@DMi_*WlVRTP8VmIW1r5~!9qDtd*!Q@pk~wDq?wth2TqTV7
zJrh=O9-dbB%eXV&H9fyjxWTqP=3>!i(EPY)7`81+A>xEpoXmUhK(r!HFfxsnP&Zug
zN{X3tHFU6Qqb3~b!OKE>@BZCC6DSYFyeu<QlhQ2_2X1_$XEdfYkKLTE4h0n2Fc9mR
zE1V1;TZTQU6)x!ds3~IcWx~h^N5~J`z$bGrag+ku;o{`-oYUNORJ`O090}(XsBFEH
z$lnaBZ1(R)m}3<CP|7M5*up8a26vD@C194Vi2#AH%Ew9dOsMMQ73W?Apwx0mtXM!T
zb@iJ#h`H894PCVALt9S&QO?-yC+KFDk`u)jEFsH25Z)8$kCoEaJ3RYWw=$VdLDdk>
zXZhL?QFQB(`gXv{`OM5hsd$%%Frq}Ap&sus1Cb3Z5?(LOMq`zBFSLwN4k5XqMU<W?
zJObHKxfMlLmmV8X0vc;{&|)S~;Qw+mCofj}>?et>49ts&0prf0YI~9em#}m1Uyl@6
zB*NPVoc(nG<4>g&4@JQ-Q31x=&4<0yo$4cDr1FRvOo1e{al;-3In5*E=4rSL0hd*>
zI3iiqF2K)GxIc`WFy2n+hZPvx4M&5;zyz_(X5H8uzHe7ym#4r<cX|jsrFnO-U)e^7
z$+<i+NV;OcbAfEyU)>;pa3BzIK^?u8Ox|rIj^)H~<hY0L_ds?1Ai?rDfR$w#NxE1E
zH_YP@OOi*|cgtrRwhV*Tqa5_Uzw?lX>AcH1OV5nMS^jeaT(U0`$Kz5cl5bLGwDSD{
z8x51p7)bDsN=>496Er-CjQwQmq2f}gew_lM3t>Q0oJrK~_IL0@fYn(Fk6WlvmPchR
z!rAV^!N_<O4$YEkhRz-2A0E05K08=T*N8razl6-K)S!%d&^kmG<36;Vc)%A?vz5)`
zns}|CN*4GP_%g^4GUX4#yb49HM<%z>QQ)SCyNwnpMAGZ(tm{DZuUEmJJlE{7j4YNv
zG@}=^eE|;I%tu#Y<Sqr*IIB#Zy*v~Eq^ZT2V{ra^AOaOYu0zn%kor=mB@XnE2KEuB
zAVyuhJJ=$?qPrNRMQEk#9j)sutMViog)x3UrEzVvD{CS)n>&aI4tgL{n=>wj4fen&
zUrfu6{%5uX4|T#s+S3~cmIJEVk3JpjQ8P!)HKnY)p%bh3fc_YI9^ZVQB;0W{41`=5
z7n2Z1yHOy)B2sC2X!O<>s9GXP<t;~&g<oHXLa-5<AsaeDQBpHVvnT&PqO~BBo+#if
zt5A&ck~<jU>W~B&kH$ltcR-^0-n<L>*h)e%v%e%rT^4-Ay;^#vLh8xjg~=*L2nTCX
zy=F3u7-q%{k@3wqS#th7!?dz*KHhvS{+Ap`K+?qiIR}(5V(dpPhc~CsQ>^+3z^$5&
z+9&O1zo*><CRuBRX}^<wXfE(~lTZSx&{ZpA;;X<q`@G`r=F=BEW(j?Q2REI_vKAfL
z4JzrL^5%Z4um@!(JVL+OL;(-I*k$IIKM)V^p`a%pa&=I-l_32@6eETk!BS?+@=7W#
z)oNwkB#H#6g}iF+5{@5szkb$6YbJO)Dv^Fo1D~i4rb&=z$q2!wOQ1U9#s!YtNN{m~
zr*wi|xeXk5%7LXdqD*Fke>KtJ4RXl4WCKIAo>W|auCfMAF~}bK`K6Iwd?viKA6*t1
zBWcpbVwlFB-Wq<0Qf|0o_vukNQ)CxQE7!6!UAqrr(mu}?3?ku85?cU!ifO&XgIdJ7
zAzb&9x`@CZ1XYgdaNbBcgcbDyIc>;0V7$k*Tv;uII+HfR3ADQm2Vv_nRj%OeC4l-`
zna$;PEQ?CY`XuzXSj`LOA)DF+wSC&vIvv^<=YVcJ9c4cdGoM2S9mNrf*kE~#PFTV&
z&eDnS=Bo;w2cn+q61ld2O3i5J{MqRdPJ3D|Drd|OC?My?j@DOzp_Kb>puLf|Yg;DE
z9Q~YgkH7c7H5SC=lK#STkps}A8PzBD%f@jOI!LF#tpgmXZ?#O?=n9sOC;}k40z-JZ
zY%r*pTcxo#9uVig^E-(aZc`Olv>!n+Bb)IHRG6^Fu2UxH-B38)1Ui~AZp2_$3AS$}
zzmKSR@?${rdD_C#vKMaNbl`y(+4J*J37<JtD!8XY`3w5v0`mY+XQSFAue~R2Hl0Mt
z8$CuN#QK3@`gE<wCfgk5u;h2#V1@pgpC8Pm0l})wop`r5Ft`n2lIm5p;~pE{tUsj6
z^9qc@R+h5U8~LO|E1aS{k14%ZN4;$V=aS`0A`v4}4*lPq#MWx6Wdaaa8v<&SpBzC^
zcY?QcZXb3s7UwVUuq%g0m*L((BnC|2g_RabIk4>lM3uqk6caHWkmtp+Bj9RZDRcSS
zREiDMvTzF&GIHsHAW~U!6~ysX>GT$^BJP)$;DQ5=-jsN2#J1RU-+C+5|2$(1@`Z&E
zi}>ohyYv0L8X4SL_}ZgH4M19Et6vx7AZiOOUO>3AcDk9H`(F>w%}!hePn?Pj=01=?
zlp5jJJm|X+A{=MiOTaL?OEb6fFRcNluEM}QOzshWiSuX7Df!8cf0j&*TJb9%066r)
zpA+9dq88sQ771RKH)R8*%<}aWw7KM}-B=z=2hy7tS5WL@q-nh40v3>XZc@18!BGLl
z{Fc!dBZf>9OU4!7twzvAvC12*<;^le<GKp)@s#i-Df-7A8-zHzHf1fNC7LjEW~$HA
zmulRh3Y%wCg)YYc_jWGMz6o#{CdcMuuHBS)WnEI!*G=vt-I`4PSYe1u4)G3k@T(4Z
zMw|1?5P^WDCfn8t!$}*lSzSp-gty@pa7v@o0b6O{tc+$1LZ=JJ9=H=yplD(B%it*t
z>uxgf|39YZ2Ecqu8l5Z;JL&D0F&##*LlGT#1iPsgt1T!x{~%h2XU0Ct&*%c66Xr|Q
zvWonI&u8phsjeP~>!Oa+nAXrdru0WD4TOJeEqBz?wQ)dq8qmat4rm>;z#*Z?_9*)R
zZ_8<sLt^*TagKfuA<C5YA2jST^Z4N&zqUrQi-p`rU-_??xlUs233F&3YKV!sJ%6=>
z1x6q|lHBt4|04fLSBf}_2hdYS!7dR+jxPiO#gEO6QW6!OahM1QotG%WID4**3bsBR
zKpxXZayJoB6iD^5ZKd&(s6A!EJVh7BjD{BguY~W0O0K-LdQ9*{ypL#}UI=`CNHRm9
zzZt#h*Ey>Qa&e0QamgTn;CkYxOqM-DgHqQjhP1NVn|w$B%$U^S=KE#LzeIzz9B2SL
zK*YZb{dE%<s9oXXk&l&Ij2niNh;rP<zSL`l-YW`9a78Rlh3j+CS(M36w9HLtxbhz3
zQ~f$q6I!meGW(YI6=mI$#hVe#@n}`FC24K~gWv%PE2{4nH)wpSZh_JcfSoO-?f7<+
z2^Dk70?*&~9F~jET8^1;i&GeLgozZ!;Ra%})TI@B+@+p(;D!GeUmXBWns(P5lAvcI
zBRtFUsv#s$YxT_DMp9H&0L1I&5e2aYGuXxC|00Y0eRbo0BS4*+wM#<SC|iN%4Uq2x
zP_S@?5x;t+$;?f8`RXk~%ywBqZCqwg`c;t}i;lKDtb}_x2a;XA&SQ%Fs~i5uK?_%A
zn+SjdVUtza6LWS#3Ha%0arvekQ{)$uaSXAgL$R^j4_#X@^BtPT0W{aE0)eP6vMA@`
zKcTOJL`BTV*ssxC4};GEh6iB<<--9|P;a;B%hd-@d#Xg`J+&W!{alVZUx7WeXr64T
zUtRvB-7p{!bAwxA#m6+zS)xnl-du89gan7Br3aOU5#rm|tlO^f|ATKy`JnJCg`9FO
zz+kB&_4U``?hKtd{|OuDk|?(y2@XuGBqD!3#Wqk!b%WK7&UsVcHCfC{GaJlr%X-lg
z4dB~(pUEgd89|@gJijC5!na`&(2amoO-t=6F63)>n63YF7SU){m6fApM?wNUVUVkX
zeh_SH5Xb6^8f>g2EeK`j>~I8JEgDCdnatzmc<S>7Wbt*Pt?9lmQ^8z8X_E)uWu8gR
zyHqR%)mftP2Tnba-h3VvW}>l0E|@Jg35V5GY(g?=nUtNg&4z|0)3@=3?tVcm$>nYi
zFXgK332XY~O&9}wPzO*e?sVVPqu5K4yAytS1%k<XS*uxQ<+vY)9k;4YlSV;`4K`)Q
z4DxLOBShLb4n8Tj6#-za^(sM?qM%OdT1$MS?`f2o-WRWSF4$(~agTEh3c?3(?BC0=
z?`zRhTu=f7Uh*<L14dnd4W%llO&yN#7s>xKQ`cvb(4sS_>H!Lo<EIIhh6=cz|CN$A
zQS;e8jHm(uu11~;W<ARq<Z+npD`rHl9LG9ZkZPXX-r4cuHfgGu-ySQ?_jO1*H+fV0
zeOv3)nkE1YV$?E!g(^z`t<D#u&)jw{skjT!V(64-w!+Ldw)cO@kWGcK4ux)WhV{fC
z1E2WLHt)YN751bgy)sZcE_TS>T`OMR{lh{!%?x10EWKHMum(w@wBS6Vw%z!dtt@KO
z%XzbfpikZDZIt$XxSZsF+ID)vefN>YXU&RLO$_PB4hT%iIvY48@g`))YoQvms}f#=
zzmF<!QUwG!i$v`6{bQ~H-AJI#D$_hPmsG#0jA0x%=N@$z_PF$n*BrCaCY`P)fv(4&
zwDDvUOE9k*?d_^TcOxrMPxAJ;z27%OZ@s81YnB@q4mYIWo1c4^EDD;f&*$Ap?w*wu
zS9+C*Y=N_iYo6&d!ZOHP=k9q{?$MSDgPkBke#q8nKs*Ti+ovH(U<ky|+#btjD+Kt>
zE-&r$4oUy9(Bcmh7TmMm)7cPW;ijPu%}Ac`^rW_~pfXQmO^CYLJZ%nPmSJGA__d^F
zysVeJ<|CjU`=GbXf{gZ6{XVLCGR5@|93>>m^Wu(kw{7DBKZR<6J6OW5;%SyG5wPPl
zijckqJ;FVR=GrwcEaU3@dgV}J8q@dRqGDBgwbkrW;ys9<X4Lm#C;0ebIY*pJ4Sz)p
zV%ttI8{%JDVvviV$tS)#02?7eK4o1m5lUjrFMiSGk_^}m3?*B|hZAXWQzlcy$Nsp{
zjU^W9Vm+E|5~;^O-G?cH`H$hX?k#8uqw>k!6veg`zi+}h0a0x#GmAd$Q{|8ewEjA$
zu_QlagW>{fGmrLiS=H}L17Fl_x`%ipjo!{DS)U6SrwBSr3u<7)4zWgA>!3%K-7*bN
zMpLrtfOj@w3o#R=LczG3(@7#wErCbqXpW*CjxJVZkLGJs5Fn%dbiO9QD|HW4lwCAS
zpEgM4P>-cz92M*wQ;){|kO&5jj@pI%i9!k04djtFA@yK6b1FPfQ#*BWJf!^0l_b9#
z_y_K*uB8b{mJG=nm$ME;{M?v^;Xz$j=?#_V+>7c4QjhEd%DTMN5_3xi>FPGcT_&J~
zgS@CN#n3kEZb?Z>_Fs|(`V#*U{iHN#hn<p(+ApwiUqb$<*;0ZM<nH!nKN$t9w4Pk>
z_+jm~DzR5VgaZX9&xe1SE6P{@s0(VvvUbYnI*1*;(N%}f+AxjwA167pF06=VYdOGZ
zk%!5UV}fMPhp1hEtT?{WgOnbLoLgogc&giB&GpY1pw)3PCk#z67`+Ve=K;0&e9VGK
z68~2|Sb@!8)6Kf9JDkE9UFE}$+Z<bNEMWq*bh;A^cm`~{#8r#_%XRn%?DR46ZcIDb
zAoAE)6O?TDL5g4(ov%X*hS0T*74zEO3EBqIo&TEm$zGBc!AY-2Q;`KCHsxP0*Z{5q
zsb=FlPD40ej8GZx<^VNpP>z{oL3s-!&Gj3L|HS{4JZ#x`0G=fohz$!Vor?5^TK>K*
zdF$w1h3G(b<&&LN5fgZF-p(CPIq`;;Q)KV&Fjp{_=*K2uO%xPjXEy@}5H1};gGAO-
z?Q038X(lq7#_{7C-lb3)js?MHH-wHG4^xhYtTw;(`+HLY;91|_*BIemglzy7&=qJu
zvLuITY%S#P)i4_}?6YE*kXdkBNOo4ID0MM^R`*g_pCX;@oDSFtRu5JPYuE8xn@9j%
zq)iTceEq{husT1_z3zUn9Y6=1Ya~JN$fJkF&%I;QcMW3X=cHqHXBB;M?BK-uYV}Zm
z$%FG?oc5`RA^j=h^6jl~7CdiO6?7J;VEq78u1df<{FWjQR-*CxpqhuvqArH-wbHSk
zMWem+bT#n@35}Nw)Xi6o1=K}a&()9;g|N|M5*p}A>xYL%O|%L^Fx-hENrl`mg64Z=
zr$5N$q_|H}j_0<&tNY?BVSXZ^B*d@oQ;WrJ(Gy=}<TT>%w@)P_IAy|o#kK;YfcP(_
zn>MmPh#d|u@ZS%1IX0#gwg$s4c<Irds{MMRkH#b~^jGo=`G3^&Se}eCB$AR-1pbn7
z?(ULa<7zdztwjm0fUz*bsJMA8b*N9$(O$mE(W1ijfR8%^VOIZdxF_mGjjUc#*EjBl
z>>%kCF1@CaF>PxRbfgt4F??$4ub5@qmYz61RqsSSY7T|15cY{D^c<-|uf0`Iw#RSp
zaU7s{pw>>XB)#amr<iFj4d$>kY#>8Vb8a|@0H4i}Jfkhs;B@V`&RA%y&?Z3$t(S9a
zJdzCR=B}_<k@u7~MCG}|yz4BxL40%5!f7vU2<$2ZCBDaT3K(B(k_6M?yq5iERakx5
zH5y+uM~~mf0JHd4bN1QoJX;M+vM{BGaR}t{>RFtdc{PHE0I-hnkw;)E_Sb_Aq<F3*
zKzl$13C0$NQoj*sVIy4WF)*7{C<Uz)i)e!He2A0~%ZbKJK?k*YwFS;inNyIp+!s4<
z#7JsH0H>AyQzRsNvSMysyLg0YEoOvQpZtROsB!jfL7CL-P^0<+Q;|ngy)5DxRVVs#
zv<GwQ!k`eWna{yIfo^bh=+k5%*T{*ip<Jk}F&@59H~~aS=TQf@op6BhL-R;{C>*l>
zsX++31Az@Oj~$i0*>;_<Q{jfZlu>;FUG1H=7Ab)6q7Y-5GOL5?Ipbg9fuJ!$x(JTP
zn-V3hwf=f%M>GejMUvlo@1?RfXY+BglX=DB>=6ahrHIPuZ!ew)35B*TrYF9;_2mf6
z$LM$h963%>$sCzvE@!$qJ6`>(!(h3d6fYgplof|b4k`QwVqOL5C27PFwg^}rGMDe?
zT{6XUp~J!ZiFqeox9Nim&kpIjOdz)Fr){<M=`FaJ*iD~A|6b#HSDQYrr=vj1iQ`+$
zj2jdpF|@6l9KQe%9Q0RFn=D%C-$6x(MYy0njWolDfv_-UIdeQ?A5SqW52fB$J}Vuj
zcEPzQ>sr6Tt~IY{37Knlg;Iga>#36eY|ZhuMV4>EMZ5I-MQ#HyUwAI%A$xb=FbeSy
zJN678^6(X*$6<xE&s6vgsdJOCkTd3KOJLTA%T9_<mwC8RZRJ$1qW;aS?~g$_)b@1s
z;X*NJ7K6=NAv<(f@x<3ymw0m|Y2z0+*eDEWe#(^hC!AOfrY;$#Y-feFuL~ui)W3g{
z3*n;6zMao$a@3-tH(brQ%Ii8Az;?<=J8De4DxM$yb$wxu)!Sn`75rxeMVp-Oe;~*m
z%7{FR)(A_E$_B{L*U1ViI22u2!j2Ej>YBB2HiHUYzM-HEu=GRLJ-N}pO-3szOwtF;
zDgGTu{m;2<5Xf}<`F_<3B{OmGAR-NA^#U(yYW5~0fj=^wOItrDF>BO|*$b>{7^H~C
z&Ve@|H?4ju3hup%j+oF2!lgNMNjQfb)zG0*d3a$&Go5^ftthK7QuqI2knFoucIf?c
z+;cUJ%D_MT6<Sp#IguY0**bZQ9c5V+Q`$d#aEP`b`7ArAoDM02-MgOS_%2|S6a|ZP
z^=Oo>cCcm&?O*(Tl^OS-35|K7KVF+|t;d!RvS!gwd{88w^)^nvifV8s-6upZG)S9*
zr+u;zsL`AQ-v(~`rwMYiVw3%mpPxS2-IxHv@^~8%Dj)v?5I_$V@4!4>M|{r{&$}G}
z;7F&^`9<tN%su-*xO5i&BJ3rusma6@n!VS%DRptpK0FqcLMGBvVJl7-yM=7{Z;+WI
z8q#2WGGFFULDSk&8!<S3_!;3(S1T~zU=<Qx9dUfwM`H~JV-FO?1I*!!jR<EKR}Ueu
zMv3_imHDL@8C(4uBwp09GY1(y>!!I=#=($P2;?KbqLG`WlEO8JOfmwC;U6gh21)FA
z%n5fNQGONO0-9ch1Ryr_G15LWJ3NpK(g?Cqls-3e=C@a&l#dSx!u7G7qVT12U7Lmw
zUY5yAC8e3H-`L4wMmF?Bzg`h<2=u=7*r7ABZ%aV4o94V(Y;$5<-7H6QrD&^zkGls5
zlD0jGXDcmRykjR7<@g)ip>h7YNWfQpw3Ca`&_h4LSK*f)e}ga}SCBR&BG2LN6fHAP
zXQ`C$0WiAmbd!@HEW2VQjE_WLZ#>WpmQ)4qw?94NXbmBk1l~_Y<BY~bc%cS%tX<+^
zue*zLF&LCS2VQ{@sT_W{yM!km8pGKA!v8=9WqgqeMcw!XQ?#l%?6(k=%n`(*B0Q2w
zzjlh0t5Se!I*%B>1E@Dc679izaF9Yez27{6n8hb?F+Nlim{m0sd_685g1%N;GEuu9
z`xesB2W=FK-<=o+8{6_(&dxs8TfgC1130*xpfoN>&4u!;od=C9s;kK=F|>I)U|yI7
z@fKwcm)PHX;Kev<)Jd?gY}0{z!S&^@=p5LN8Q+h1+)VPGm9ohfP9U9_pGL(0qXW@c
zG$Q+JIPOfDSA6a&>dkpF?vW@(5QFELb`SMJ9=Q6!%1Q4Z(8v9f6JjM>OWk)#DfzmD
z8lUN8Tw5<o&Nw`gIr-~sR^sOWq2uANYn-$e=!t6m;-m7ITvd-a`c>aPa8_8n(j|D?
zbIGHS`P|AOsA%URMpEzWfW6U-<18g1l>*`Ro2jmo(W$`i(H9d6P=2g=x|pFXLZPEv
zB=l%SqYic_ZpbJA-{e&$jm5FS6OGB6X6l4$>PE<S%9bWTWQhg6$Q;QvDIt^;I^<P#
z&?XQ+&I_p(R{3h=KoAOV_&#S#0+2cyN+huH0MClRq?b91Ro4|M+h7KPP_~SQ1tp>m
zLu>YN?^Rfeh;aM?*RZ;(aV-l~QK>lkn1GpYzgubwnO+}M)y#f^nI`GZnbi`?T(pw4
zz7l*fAs9)!Gy$>&4%-LkhHz$jJ+Kfuu4Ul!Q1wqO6zD(TAL(c1!P&S)RGkahT|l*|
zm|KqVONtVEc{q058phAoRDE*DSzAqzl|CJEsCJ~h^<}Aj?9InTS*IkY@;wm#vD`K8
z^H-QArXp{tGR!!Y6tx+-Zww%WCiG()Qh7Yr%%tT7o3H`Vn3}c2b1FM@O@xOdgLD6r
zbnZmqf~+YAo6#5R<Yw#@wDs0{_v{0^<PyF@O7yn~ws&q*Vv!5SswwgPPvrx8j)BVO
z8mtAUbqqQ3q*deM=BP|yCp%d%9}&k6I+=A!6QYjGQ&X+52tJ`AemylTjT5@<I*}W}
zJ0YN|mb=Ur(12t)BC3DhNnE@nUL(7OBT-*8O~XZ!OsDkVnA5uzSU%!1SU|@_7@Wk<
zhuHhG6EED9*ncI2ti)f6_*~++=h7R&Qz`p=>AN3a+kV6CWsIw?Sf%yt*Ic-H`C6cd
zr!pXhq!ub<KgrUbh!R(Y#e>wrU?nZNw>Q4x^-!EV>7lmnuwC+NryBkE9&QHi4Wn+4
z6Y14nAE?&vu6zu2uu(6;ZeUxnw2Y=$CMq|=Z%U<i{(4nPx`N(Hqjgqf?;F!Yok^1%
zo6&Evp$m0V=ag9%r@5sGuUZGh3d_KY5Pjzt1b|hB$cHLYX51SWCW<UqBdmZ?n$JXf
zoXbINKn7Nuw}@$72I;E8*mfEdtyA`7j=`>o&~CvLyc{LO<7!-*L!ka05DQI7EPjiq
zFu;*_-(()?)e9V4SJu^|gUt9jJ2^6Eg`LQ~P&EK%5`*3ce|Cc$`vgumw6c`fV88<j
zm-aPY^3Y!Qn=%wBT=%@A7_={`+tHMkw@zq4^=<glM?LQ#W2T|Y!-fbGP#Wy3_*%^A
z-jn+Z$%7pk7d&g*L1Z<hXObOb?MeL4c6Xg4wfO84^(z8Cd~gZ{IggD_u(fXO$dU3h
zS9vxXfLfqKqOd>rY^coc8BusEQn~T>9Hx_YKng)YS-<F&TfgP_l^<C_=;oO?xTi&6
zz`8;+Kv0jNR6oI*Ns?=7vqy{fsXG?KFY>O}*S32Q3Zlk5QD{zvzoCmXU;LGYpSE<a
zj4;cjDq7#SRoGW=P!0vse`h>d)X2;u7e&@W86K*pzQa*>(HcYGF~>u5TaHwJ+VN8l
z>Qf4bww_CJZ8SMpwWQ^FR`Aj;O#ZVAw~{@0Y&qdp!8#^uPt%&^6BMKO5|a=e=cJHV
z?@~K2$ZvHhCHGlZ8P9G8PCx;U5}5ozpG%B9kfgAb*MdatGR)Xdv*>pv3BWj}aM`EI
zD0-;ZU(CyQy(1S~p?L7IVYAZ6kN`iKXPGjMpi+PR5LnW*(9laSNryyR2~FYHWnE*9
znclp85^a7tjAL}a008ZaBv9T)z8>ed_Z`|EB1}zV_P4z~jTjU^tC`rWab-!2o*6~G
z91SJU@yE_9hdx=U8I4)G6^$s_1<I{)b3%GliiNW}1T!FyluF9eqN4ed#@MPl@a)GK
zNSlMXz?#oBg5Xhe4*6YBH_ezS#52Tv{*hBTMXBse`ke*d=8-#N3(piJJe<CU8ut1v
z<m>6{CibccIIb7H-Y9>T(!^)=ghi^*4ZmA@%l1jBoC5Zd2*ekjqI}eBz=+_EQF+0c
z`q@C81|eo%0=cL(EG3<eWux!#eUR<;!m#eX%O%r!i}TstVrC1mA;J0GDr?E)4=TDx
zvh{HH9<!pjaS_yj&`-Xcm;B4nT#ilG;!ZhOtC{ZZpie$(+1<Teul2dfRK&-ti(vAb
zPA(8@E5$eNF~W0%^yjyUr-=`~E}n&MG39;zK^wj^Kk;S2W!hz;|70z1u_q%-C;X)2
zl|+eokPueBBFf;wFz1>b7^*oOpJ|+z%eG7G*J-&!N2RzVKx>|78lNez_=%~61sSYB
z+s{KfWqdDZE^Qe@*seoy5bFZR6_GON@dieaOC*u}@J!58Ev!2&1=L%N%FaJ&&u;id
zt-{aQvy0)5f@3$L5{2KL2yC>gE(j;~%@;3F<_;ms^!-Jj6IhH%8isWO<OQ+r_gAqA
zo1ttLgTmpp{?<$LzKs}!m;6Y?yr5O$7451zS$=Ps-j0c!?fFkO`uOmcP1*whx`>0S
zX>~T?6nOghyYIqMD~wh?Ue6ftu9@gVu<Lp!!7WD#gIz{(#X~bF_f$CWVSvaZvxr?+
z9Nz0)Xhh^(f-%L7V3Ui8Z2@t=9mNDN8pZaSpp1#F3DPUfX3DJ4GC%bP4>NK@xA?K}
zBf@Oh(_m@8%_VVSA7H<wg?Hls(qpP6<ws-SiS>rFB+C4mXCW*9nEk>42kPMrk(-Iv
zGCmp8U4}f23=iyjS4M#7UT$)YJU8|Y{z)jY0%N>;Oc1(GN-1(DBUtDAmN0Gx8B96&
z(sCJAyCmvK!jGZn!Q>l9)Y52DIWbfXByynlG4{m$5Zk<)B%f_705#D*B3(#A;SLzA
zSaUCPI<8<BBD^RN0??jAZs&h3)l`Nw8LFCl`lL?Ok?A*s!b&P@UV40B{A1kRk41su
zBn>$<#GB{mgFP1&6UmheN+zU;gO7i@@l^9q;~h{|tx3~CD#mKQE<Kf44W`6Jj~6az
z%&2PmP9gv;X&kms>`4b=c|Hs*u#xaaENP$U04L$dXl4abklMFTEq!0abf+8-7*4FP
z_3Fu!6Sk)5&p>+cQ668Lb7XsKII}Zq38wur<2`yDSYs-1T}>S8^w}2=^ih`ZYGy&)
z?vt?S1o`q5t9H;?LK46Z<b^1HpB`6)sd&!xt6~h6ontt!*Fa}vpMjiqGjhddBETaq
zWDrHdAmK_DiEMqn>{w-+&dwAyd&JAUMPC9Bbcrs7ARczW^2RCVDggDK`LtvC37iIE
z!3dT$2@qa_n5KH=y_NaYiE)EH;bb`tI}<HmH@VYiXBRt>d+>brwZ6)J*rlN?llGpy
z|GnxWt1laZTJ7gBbkh`4#LFvk*E4e98`xNq@%*~nnyVWomT>1_MokyMXB?|#s)&s~
zp>*_ZKCsOvMr@5zIbB^gDWV2lT@5VtaRzGV=H>^YA%tgV1jVDupiDRTd%Ey!M)DWE
zP9uiO9G7`Wh(y_@8TVnoOcEEe=&VzqH#pC@yL4)>$PntD4D~(WA7(EOa<~D_(`X4H
zdiN$U?zCK+Kwsbq_cQl%@ny`N%xNW_C_!%AIc<Lw>AlCpWo_5x{8%jJ>i#w>klt6T
zzC;S3Ix+mZuc)FnIf?>I97;q+R3t?9BQY;ZHg=Mf*@h|7ctdqHN64787C^gxL?(Zz
z0)qzN<A9QO1sVz;LbOhd>uuZo#ZIzWg?NsG4%qBOdLLmCO5_!b@?xZ9?>QBj0sZ*z
zB#H9DSbW!s^0zS`RLk+grV-1s8QD|beFF{kn=PftY7-tJn+D7-2P)n_j7{dinse-Q
z%Yr3Yt-P5Zy_gy!#$Ff|DI))2!+~WcL)5qdF|XC0Lppz!GF6e-1NU#OVQdH0t}eqQ
zV4X!gQv|d~?X>l@F_GY*P>mJ`et$lY;USH(J4?-FXr_=9Tws4<Oz)~6#y4Z#gwy$7
zBQ2x)Ar9}OY1<RHB-B*fx@?ABTAYDybi(fn_Fi~mo7QYGFh-cEpXd;1x3d~hdIjz4
zZAaei&_PKH=vG~<9dLein#6?4-<;_S8i;X7EtQj^LYW&v;xk-~__xn|2UyrRL5<*y
z=VcGgg-@m^P(W<kY`52{n*DlIC5Etg!6n)5x^jtfr42<f@wZr3$XxewmqtU3^v1GY
zAqxpWfc}2WUj$v!cs0Y0KMaccCnBDPf^bgD>ve<){%FWpFPe1-60S|L#nAZSa+_3*
z;`E&m+&G|jLDly3c`voFJF|J)zYm<EaeE_?m+FMwxFK_$Q87dXprC&j5K`#HIFerB
zy({fw^GzfXrDwcej+dIpyD>lXEX^gvCSyZ)HqpXa&mg-B&U)VFL%FVPu0Ca^us7x%
zMgcKLK*Ob+e3cSsRKbLQ9My$e?4n>1ztuM6mf!iFkKs0oGcNMWB82(`l@Hv*-Cr@g
zq@BU3hc2@8Rl7N%DBrs>yY&DyDCYB(KAIM_^m0|m5`~dqXmXTb`{=Ew92D)|Lbw(8
zmCtMT?~*U-Crv>AJk?KA2TSJhitQAlqTVyTbZ1@Ca4uQ9AoUi}xG1PkB+#Y-p6FWD
zz!hXFK55|h4~JveJM(*2i@Zzr>iDH|#zJ(bStg&G>Vvip#_qJ#s=Z>C*cC`RmyG4g
zXO9IJsF|#O$mpJ9iLd-I=wH4Uue}dV?hg}i$iXX&c(eei;vucJ>wg8M%{`g4(OMtD
z)SuoFV{-D6>3`yDLkCevTo-lc?!2A}o;yt3)}+ghPf9M<DOunGX=2VBRRIHi>rJ}L
zQJ6Pc1Jo@={xswYf~eVg%(o$)8-|p?Zhf}_oG3d*!2dBOZm9^il8hdV{nb^Vr04rj
zY;mYRiOz;KO;?slS5kvm;HD!B815UITVq*ubCZ5d8SbQx{HkQqnVE|yB>hy!9i+7}
z0+IP}+RP<lM*Ff_WStZN@~0&oxqnk1jyC4>8>SgT_#PbI(#+kqGNPKDv`Vfhk1O3u
zr?kjR#xuqnTl0VzYVId3)ja7gKFT~7)!w*(VbzoPRVr`7@CpHpkHy_G9fy}m=O0=n
zYtP^LwA0n=9Ba5m23^2n`gzbIgUhxA7Y&<r>N=~~?qksDwV-1(?4Fi`)gKjz*3_4U
zSvH``xfoMJn-$}Sx3C4mX>u?)tayS@c!T8@HQ+w=(6oB)N9ORRH<1mCg}cU7U4x!-
zdX(;F*^FtioPA*YhS<u!)w6=8X_E~P5tq}8+z6TDIvv*-E#Gs;h!USbw3a>EX}Oh6
z9hO>_BtjrS)^wN2h3fn3yVz4?z}YK-U@L4E+lr4v*eXXOsBQ;~%Tobebu1-Fjl0LB
zwrIYPsVWXn4c({Zqs5P#Wn}DGf6aa|TOyi#hA_^EQs>b$P}65kUSLtoZkDYAF9~jY
z(l2EKPy8HO@00}<0tgSC-A%ns)JdwU*n?v)_(pBUvw}<8S6_u)8&+T!kEktBg8;Ak
zUgrFjdnBf0$VXqn{_3{>DFziBz5%%2Iq}1-U8(DYD)(<yi4WPCl%gsAw`Vhe#pn7o
z1XsB}9e6rFW(vlbQER(I!aMgL3_X^096`!%%+ZVOGj3obw%xviP%kV%9-dhLz(x{9
z@0!H!gxa)qs&ZYuXwGLU<8rp0M{5sEzPMj)GkOjH73LN@J-iyU&;D0#E(4pNB{o>r
zs*-y~Zav9vHig>2hfD=5%j<Reo`cz_kaixBt{%p`qotla2Zx$Eus_rw^Uv%7eZ}AS
z=nj)xHdCWOp%x})hNL&6l4YAvO`Q%@+?Iqz%%6sj=Xo#J9Ft<9BPeF};Q<fY40xdJ
zeKq#K{4pH=S?=xu?<ghDnckjKQeQo3(J&A{vK~aPjP79j<=2!NDR=ga0Y+URk~mXh
z|H-6NTV8g&0O)tLX{tLcM)4drL&h?P5id#Vlm3Grkyp9v2rWgDm`WRx-LVSoFzs^(
zdSXRUodKC0rZP<bRFr2is2c}khb5`vH8Ys|+KoOSR)<O6YdIoHbZ{a9IZ#zE;M=Q3
z`p5jCAXLhi@m;`*I%!R$kA!FY1}NZ#2DDFH*nwwg$KQ9Rs_ZnGi!Z#fv>*Mih`h;B
zK<kCtE=E(>v`?1gR>xMIwc)QrOa<oWI2Dndtp>)4aNZIMdLVM9#$(J_ay=BGzVHHs
z?MM8k7vU_vX%iWu;(GK%b|^3ZPu~AwEnU(*0P=Q=GMf@=^G^vUEtC-Pudktr-0f9p
z7fMW12ebi3&5}>kg(9os|5@cHu5r#PxbB2CJ5%{Y;?VrH{+Kj;w<L`IsEOLEzfDg%
zy2Sd(;I!o^=}7Kn)?7*`GG9xjZKLZr?ze_7JHHNfAX+Y-ESWUsV=W4P@|EjD_euGo
z)!*mi94)rZiZv%)S+Z_0I!rvEIU2hP(^W9o*nNH>pBAoIUtVROq}S)}C7#UisU9JS
zk|#~Q&`>n84gP#XmY)19Ykn0zXOMA!^HBu!MMfVT`QNLMZte!^s|cXgy#vAmG<@|3
zy!aLpnd2-e$Y%GyoN#DN+)F9A{Zquogj3UzYkfi+>8gMRudZjAE-d`Sq$0U@g*(3T
z?=`5{N|(0$2_Abc(Hiz}(x2Q*9L#bNO&U7v@ZEvsA{r`VhxIC0HB8~PFhdGONuv(9
zEGS<_X#d**#>q>jxdIxRp+}<X*R?ad(BHQlR<eyIEdzmazK@r&_EbwY!&#o@ox~C=
zu1bvS$cKT(XXJ7h4Lo=AetUkZMDNix3|yV)52StmGi!4SQ>MmCE3oV4lr_BMN33TR
z@p4-_(pQ3uf$f^b@y$dELg=BX+OBJBD-CC3?9F_$Jo!$<hOja~80PpbNC3;j9LV*^
zrVudJbu3y8fY$<>(6<4>hi?XYB&~Q-v>6&d*pke7FY{b#?`>R$i;?h@9o%}4({&fT
zm4P<4X;yU3CJ;w{+dH9J>G}_lFWu=SlPzH@2nl#P8!&J!YL+qp+I9l}za}$jo)Ue{
zI34*bB)XXLyI$WRH8)TR-+}_*W-|TjEh;P;teVB=XdpuYAxuQbsW}iS?D>&L2a_<=
zZg_X_p8g<CcHF9SEbHOVK<igO6M~8BI};7Np^I3?nm?GKXLRV%u*pN|%T_UZWWf)z
zn5C}I08<(-`Fc-XL#)0d=w!lUM$i9TFkdn%GH(H;8gQA8C}(_$tgs{k^&Zd(R&=#`
zv$Kd~pccd~>f&{F-TLr;N#GZUTgqCtA|Yg2M%csnON!vLVD~A?^lVcH<w>*=_e$F5
zh=6|$@jo*Z_yAXad)iUYk*cyTG^tJ5lFrOpkge0VL_#of{{Hp6mF}5EF%LvV8iw*d
ztuWP9l0rKDnA;cTeZsU#V^Q^cvHtntzt22loOBDvL(+~EvJsdl{$$F%%W5EC2Ztqz
zZ&8jXF9{hD-U>}!K$&3=()tI6{I0gQ?75UrE6yh2_D@QUB%unwslR^1;hQuk?O=v$
zpKk1H4Rj$_L_oyZbu-5M#*CTYqX757BAleZg`b9QHL_&28tE;QbN{4n{xB@;)~qD7
zng1xCJyJ4f%Yn37$;NpenhCxSM&Qd+{}$_y6_04N--r@InnMk6aG(8Tj~;RUkN&6R
z7B!pim`j8ELBoe-g!~S3rZ)SU+ohcb1U`2>oKXq#E{h-s=a$KiFXP=hpmamP;-G$%
zjxLcty&RcCbIaWT8RULKjv*bo+t*FsU`Hl#&)yt`8&|r3(5+X*$opYx?%DpEFH`L9
z+aSim;y6E(=oz;c<pPTt9Vz@A47zWc7?CTEaqeSmF=PP{N4}+~Zfxu7DU~DEPN-CQ
zc++4M6~`?{$hAIzPDaxt6dotqxvJMH>Pe~Ob4rsSrk9>j`O{cwd^j4HLb@UtMdLO%
zCVX9*E=et6r#6|aJFvP^G2Q8~C2cXEH+HCHyws4C<b)IlB`!Tnkyr%{@h4(oS?UeU
zF*8%h;u@6io3x?zv}BK?DX{E(;k`cxn>SoXu_CzK!#S&ZxW>Mw=XpT)Trgj_dL9-T
zNU`}=ZW%e7Wtmt<^UVW$EFTxHC|)N=INbQa?+_M!o?8%8TG}%(VNOJ2!4#mM)cbh6
zKxctT*>x?P*3e;p(q%^7d@-lIIslaruD63mmgMG+PAJ9nS!NBym*iL%GPxWHqxYqR
z1z#B#D{n4c2-6h#V<X*fcN)dwQ%SpjEtx`m08WJIPgcXkwpK;Gt=T&wlX`b*+b($%
z$FZJ$(aGR#D58ilh02lw*+N{5B}|(;oV~>D4ZzfsPOo_O>azw|tcT-<NUydv%hZ_;
zI=G1o=5>E+V+C3fKdmub#M&*zP2#suq-{3SI;<n1A;cA^CC2N5%S-!cz)b~*9AQl%
zSluttsxd!IrGK0|K0K3K{*9^odd=ss=Mgt8ED~`0yb`aeX^dCyk*WgP%pr#j)0TJp
zN;MP4OV{9TXD9u-8nMjCXq6kH*MEm~q2N_~ANd)9VHh?PuQa`aZBy0PhOt0jn@Kso
z6Jz^+Cs{TVI`t%!(PM5ep%A9m-5tQkk<I21iWEPfd^UsO!&YDWHB)L}SNJ<Xv2^0y
zF|=Sr^)IS7RIm?49$v2>e&u7(?*}71aY%&`VWnC~rhKG{u2`>uu#X7!X`MwChkjnh
z2%xP*YrN3<fiK<@3M^IWq%+py%@Gp_OFnj^_getmdxbC!Pfv2=l4d&5?*^2==C7%B
zIrNoiBvSuZh-bTk&A)`pPfHS-7WMypWR}L{NQ9$I?M<jJ<^#s+WkV6DmIY5TxRL!t
zv&~KXA3rN~0{!$ZZ&sd-BD?7%Zf>T3Aa&|&wWB{W%r4i5CT!>8pDG`CRem6SL?4|t
zLUzb1YUT=`OtKhUNrv@vPeRPPu4aT0k=DtVO4#Y`{iQbzApiUJ33CnIOqtFEP9Y*#
zdQZgDLD<GCKiA~s!%3eim$=icn9??%O?uqG_qTe3aq(!S^#$!)RY=H}KEQrZZ0c_W
zehvpQ(>|v5loVG?X~NExo8GxGu=V1GiyHwn%A^o?*3&^NM@AnR_hpAs2(Wn8`tTkK
zcmoG%$$Zd-&#TjQX4+1JBDp^!{ackeG$5w`)k&E%wm1{%DN55FiaVKiB)+)*wtlXj
z-}P0m7?Pw89HjU7HBAEl3I3Rk61_uupPxh{T&Yj+Y&mac`@y(0A7LgR#91?<&nQDd
z^-Xcb+Gkh@4``u0s3sbCn|k<(KBK<x$|;Z9bVif$c&%l`t$I0|X_|Wgq?5Oru?IFt
z&dp0qbGQ2W`X7Z9MC1}#*`m|88+cT{o^EuEtD;POQ8v1pqWO6@yy^QUN1_p78(W<T
zBa0N)=y;s4zmObNDHgILByRtoBQM`R$8QFiK~qXI0+bgc?ht|poX?Y}<jS?Eft?>R
zM`1?(e7}nI8U<Pn>X>TS@AlAMOAmn<l(D!AnLlV_C%L9!F?`P?&!28pmFHw<oEz(<
zO}Q5>VHC6BS8d>t<+5p=Wh>e7L=LRv6b)y<|MhjKIFlmiUoinw*m2uoy>^lOlT*{8
zo#f^iIYRg37vvot7Lc9<=q0c=Y{qm8VYOCag0f{Y?2ke+l-Ati3}-UZ7oH^lg)luT
z1;xfVe!E0Hx9!3la^RZZ-(dm;lcX`}C7VO-UiYlEDM|*d%Rw%KW%7eNpin#TaDxI5
zcIC2};}zKH0U{w}DqfpqVh7LO<YL6sFP+Ec_uXg^YCTjZLiNXBF{(8S#d)f{d53hW
zn1Wi(_SN!W5^K??!L^UA$)EcQTpgqX4}u?xE8`bYxmR^;*E&?RMD@*4kPJ`PHoi8)
z?AYeVhS~|va}2`6KZ&y}WA%|$*(x`9YN^t#x%kyG%}I$?aDh<XV4nGAdJLG)$xq)*
zddI#I1fsT+=48a-3+IwvRLO%KTRz8kGrB;Mk%p!W6E$fHjrHEfU)cK-ciaWI$&#;#
zE2)Yt=7sFIKg;v8!?mH*u4d~!t7xE00ZCq3!~Bg-M}8&*)8(H2O==#7?%&+NjBx1g
zQclsq`JmKw^GR8P{Zg2>O8j5+q$!GtCS3e0T2AIuov*Ns+}P<DPbFdx#FCaqvD6#z
z9Lbw0v^SOcx<zeIs9<(!w;j#Hu6PhRue18kAA}%)?(t;uYvxbCQQB}5m!3Ly34X0(
zeDN9zRA07>zRwM*%^t?eX^=CGQhhKaDY2Vrd~`=w(oD)2odF&!YPh(9-#(<V_WmJP
z<qrICm=hTv)HT~@$yE<KQ&H`YaP9#}zn+c_nq;%XK(0YaIvmw;tjlU0OYT%S+1Wp<
zl*=Od1?H6#=qn&M*m}Zf1)u91@w}_n=@(3wd4Uihr-_*u{w9nmed+j?Inl)j+&~oK
z3D%+*e&FQ77SWDFiCQur(=|mGAbj$UBqF!!8cEUw<2A@$ujIB<>+^EKx{o+_N3z&6
zII1GH3Qlg3YQid^94A4Yh174xi?%6|RLxWR)dAPyOcgRksj5cgDHA68B^Ob5&wapS
z8avP2#a&u7y8_Iwu&5guW;BiI4W_UAah)4&M^;zk9dL+T<i`fgB_+%f7=ekjdZmlt
zR*jJ<kcBRI7>yUIFZ+=IQ3}eC^YNWha+x{Kn(6uc&$JeR=fPQFAHFt&U)W9%1+}CK
z%wZH$$5thL{t7%M5hhIZ1qNs~+<WPVIb&#?R9~KeX@3}ZrmIG84xhq=PXt~iNsDB0
zfQ692$e%$-p;gITay}Hm+mEu$S8ND~K$cU)2^sY@JFua~aAtZb0|z4v;l;^qw$|A*
zL<@It_v{#WxB^O)tymFo?Z>mSaCOL^$&JTnG>+ITm!}M1r$N>?z=ALD>z&UAwybxZ
zWe-t5dt!YEUc9Y-rhAT#y|=zZZ!lL_BQ|(CtGTd>_3j@S_dpp`qSWqEr<Txa0oe;8
z<ap%Jc!@^zA1hQ~%p)XR?{=m%9fYZ-MKpJ0G~G$kIju?37&v^mi3I`?bsqh?WcL4(
zFufn<$Wn39AqR862bG@RdQsnes3hFNt?ETlUzqo2jBj-mrX`&{MH->_c<>Tz&t$hl
z5FW%pr%3$)0QgTNE4njsP||rT7)D)cXF{@Bn~=-wI8wy2B=UtI4mzgWFJ+;47i@(t
zQ6<G<HM=X=zF58<;?pO(Y`Ex`<>qv^ip@~VB%n2JK$XwSWG&TNA$}t`Et19f4CsdB
zQH#(N#IQQPwnrkl2r+h68!H@M-NcjN8J52rX<IjAWw*drmGWywUC*+Jt5b54i-W$@
z6R?7Ao(=>~dQHJbGQi~nSQ<Iwi4ngL6!A6zp~7FVP!&Jn<yY!*c>i)np>q#531q^d
zE30f$cyf&lQ6a>2-1qY6%nlhefY6Iu&TaLBAUSq`D~)}Tx~JbZdp`-GEVQkmzBZm!
zqkpyQw-s=`Z^JNVMub>j>lhj3(c9e2rAy7pMF;jS%RL0zlDC?0ZC23Q_Yc5-LhwSr
zhok~&|9Go9TmYj=ZQ6MW-_&>(MnJeX(>?jJrc(pI*-g2Aj)ejmyAc?qrc>mCWO0hr
zq1J+7NcVMq%aN&ss44{d9l6LWsbAZMJ+V5-u`yuBCG_%Epop6L`p?$pRxt%&^|rlb
z3Fmik0&ER>*~RIIkd|ZwgSW3y9K^^p8#K1neI4JHTZ53sLo3HUyI{5#vR}^*E_;P@
zXA{@;D=6!|C=4XF!v@~7sUN9^EKcL#NH8HR_#FV9PVz%^HA<SP=sHl0LbzPppqP)N
z*ZuZ9dzO@SB$>E$uq_ff^18Be)beyV;y-WNnhX=C0g%V^?>*Q_L(U?8&dQv7+=5iT
zGL0<PxAK+M2!|`?(JEvl`?%kl0*Jm};)sA!+I8n3cHBT@!F}c7qy8DcpoFMhf)Q8<
z2B9e(#TR+^mPK7<^LmX4U-AdF2x|LbQ3n+TdxRiR=BsfbfJ67qw(}SrB!m4YvQ7?w
z6~<w>7O4rs0#bN6D>ON@KJn&Lo~JWsHr^fZ+1T=lP;jmGI(9`1-_Y<&Gdon9WYLfv
zHj0YSuk+q`hwqKKPxvXOfZ#<9x<U8yG?ua^3>kB3&){UBY;7sX!*{Fj|KqC19B3QK
z%s}n)0O;RLvaWoD*`GqM5@TCfHgOg{e9T9*Js3#HBud{!8@7@Owo(LI3qD(0I~}hw
zqNb41Onvi?Sb+Yike3LpeX8m+?4L_VtE+Mm{p~c;Q|+HsR`K7&1uDqtZsyy3J6KgE
zJz2I2eS8rZ=rmxH^MSsK5hTa4fa}MN0|=~xSX2{YunpGDBHP$X{<-lov4;f0-A6<g
z06+-!#4YAlfxP|+(_+Hh{uapr#=EiAr%M9X-Zq~-mR9&TjdKK|C)*^yvFlGha<EKk
zE{iP$%Q$epXnWF+J%X|DoA728hm8|W>Q9EiezD|Dyp6Dhs2fq&{!B0H!M`cVGR>aS
z!T?|r6~6U+Wdn#-hiP!8F_tM+<+i^YMw8%f1R7ug&kXeOr3q+bp4Iw8QlOwi->*Qz
ziwEY`%Dt-xvyh1DNA}#7{2}YV&6Z{QY9!r`2UjC|%<`t&EV_alOOQw*rm6J0O<(Mk
z`ER3zgN#HF--Fmij#l<3vx56GSKGb(vR~O9_OdX-0EwcCho4DNp6I&nxNXt#m{MKD
zKG=msD36{n$-cpXeBMdCNg#zvPIP9};|a`t@D$4kRn&H{fT7Lt0oKHXEGf@e6}Ag9
zciz+feUs$&T~D*w&Pii<tpYzOa4w@OuM7yG6si9G)S;f*AzX|vnH9v4W4OFES`rU>
z&WUDdQT%;S8V%5KaJbrQoz9IVluVz}#sw*%)vul5AdGNf%gLGidAlIyFF*4!c@m&+
z`7aGqCMo7*5%{Vy4b%<ioRgb;TtSrjg3#h464&U$iFM`c&5_y%o59QB-nz(cPhr{B
z-fCf6n1DbEEK%|^{Lh%cz7jy~E@PHbR%7q~Bh=1WF3S<@{sQ?T&sKk3*v}iOHD?+}
ziv}CO6?<GtEeoKJ?$?HAOiswff+&0of|LSVjwW1yjmJU5qgF{D`*2(_;%ws(6053N
zNxV(<qn`<Ow09jpO8**_srPG?$|sP3Laxi;`$+=8<v100vKnE#EFvp1>>7Sw;j!nb
zGd(af9B9pBMWSX$mQXgn8@rG0w!p8KZn2NRZ%A6qtiwVC>V_9(Lkdchm`}CjQZ_KU
zOpP>eJmOcLHl6?4k2Ci*VL|%p{N6Ys{)2#OJA^aRi^dpdwUjZ2@gl{4)sAcj0oMAj
zNK~&&m!_f8Ldi#_YU@pa)N}NyK>P+o@+7s$o6qElT;9vd?cHnq#!(70{kB0y>1<UC
z<rE~)=<&D(AtX-n)*jos&{<{B$>1tAEVVe1wWi~OkpaBjxpfs7+GY+IfQy5rBM2<L
zVa-r__zBqJs2kg{7P{}|F|eyl6Gv@*TqsRxC~)51Y$>dbSw=Fz4|pb-rvaustBNq7
zV4_*!6Nw#@a4$8e@=DWHs0k#N50uiYVZ567Z;WtPrOSiR7BApacutm~eEqDaQKOPP
z;9(b<ht>??U>j6y6!r*X8uafa%A-#m^#Av-qCdMKdr~~2CeE5BsTLtxKV%ou)BxHR
zW3qX6<EWT)<0WnNce_#{rPzGB-alsY0bK%gNRbLp(la(z@$7Y(sx0m2+*+&uA9e3a
zV%s{3elI+j6=;B*2Mk8VI6kAb%(iM5C!`Q??_w%y1aQxivbPZTXBUBPBNAlx2(b?A
zf}6o=wP<g<14P_t#L}xlUVfq1C&Vpnvg?}$jL%5mJo%Ne=wq=IXw)LAQQu*E7{eSK
zLsbdtX;FfMc?%LrZqvLjNA%@R`vm;ULJ2y}T0@m#nrIcgeQ{H4U3^c_Rka%Oo!CBN
zNy<(rCMQVCSfsXfh0)4FY~Uy0Pu`FF;iUD!*X)>BonH6o=Jeud9z9R|238R@BYk1K
z8J7ASbT~kyetx^~%anm{1DJ;g+U#k@%*f?or<Md4F*O+KP3-lZlP5`Sb`q}y2DaiM
zSm7mOsXgK4*q4p}?|=`Wt9-l=5+5c8z6Kt^m=RTT-%IgU$DJ_nirIX`7;;tK>FqM>
zhpl6&=B5Kw2>#}H+6k*m_lB%9^LKukE|nOi01D)X*p|j9(9;x@QEV``_;6#DeeEUe
z|4)g}^vG^xGERCh;QYfbky&Cn%&^obwE!vI-aHC%wcyx?=r(@0wrzJ`Ih#r?si4M+
zQ7^Zo8uzRUo;GXR`W^4y1|X6L;psi>RA2W8TP!B#fOkGg$;R|ec1XdeHb>~^j6_bt
zB0zDj_<OcOsVGrFkZQ<IQ}Di~&EG9v-HVe*NySkDxzPldFl{xzs)#^WjVU8C=LA{v
zR^_pkfL`8H^Jf6~|E<sm&o6go4bJhP@S1Z-bV8GHYLXLxx0tHvSPgy)UWPJ8UQ?{h
zD`+BUD1e)f{H9J*=wt5x$Kk;e5VVglePY5cRhT0ahEIsSd>zpDYg5yZaTlzgR@BC6
zj`dkEAr1=gq$VnuD_Rg&_m9c<wY`nEqH?(aE}3iM+C9rb1L%hscd$9RdE%Av_t#r{
znL~u_+kZ1Q7-jW8L2AyqfEgD^HRGUglfsFdaWBdm2cZCxt@M+%5}i7A^c)z6yBRoE
ze01HNvcoys?wV7jWMPTD#UXjJ>v&Ri%SzD8zbEzbEW<T!+{+BdLx+&<84a;=Cu+U^
zRaIaNGDC<)FU0ClicbGGJbgokt$wm{S|%)&oc&(L?^FkpW&ZC<evQh?c@ak`?2!{X
z00N5md&t*1KBS^C)30W%#Tvgyso}@N(jZP@xRF~x0&@^3F@ul9P#HUW9YDCR-wjH3
z{QvC1x=(;zomm`!KUVjDUPm+Hl+oHHG%4^z75(Fkv^|f(j}6a8<f}X1)rO(5W70pA
zT~MkNE-cgZg}$s4$*!+NMw)lbh+~ZNVv8r+%ppu3GRCw5s19DxSqg4g1-j?Vi1hA&
z0g)*KS^-s=5`E>3N^wpg7)t+_6GJ6QBdff2u|k2Y^jVP~>kCZ6%Q-vLuvkFp<BBm#
zeMOTH)?F=+5M}s^_W4{BCfwy-H=rf1h;>A0f6IJ9Wp_Z+-+Z6a&sPO-X-_etawKNk
zTGp~I1_#2JG)zyGPEp?Xb4nRdna4p2z{!88&-`-t##qS;1X``uyYinNOItP`y~!Z4
z@HI>2(D-hEd_QS7iE(4TGw~1rRLx*~5k-+xrlZuvL>K{A9(yEqm?+j-fa9Y~Yd|RX
zCHQ8RS00rgQ*oVP5_MtB8Pa>m4}nuSNiWpC9Jj6iYxfYdNPK!G($^uS9_%{ef0a7U
zWHTBO#zV^h+s-@wjDZiI##GG_N&g9dHGwiYsgY4enEU0Nv*<ju=PfC>2hX^M^691<
zMDfrNIrW@2_;`i(*9^(57iBpZ7x~&4BtsE(n0~!iyC|DE&uQZK`xnjk2p{mXtvh^p
zhL5;-YU**~tV2X;1B%zXKmQ}g_bEe^;u-b3UNrMTOQ^o2p|lSz`>1driwy5IZ<PBo
zMy6>pnOjN65~KX4-mM5%#lxb47%y{NS~FD+=&Cl+x|a1rZo5f*&X5eVz|Iif$o?oF
zY};<3C>ADk4&b;4o|N3wC@{0?az>4!GUgmzY_u^|?iK=%L`hc+0#H4;OrkXKj!8v4
zHI6g%qlVvIFV=97cG&OR$&|0=(<wA<5mr<pQxTI01C!$XGkI9khnL9YuY5BRwGhm*
z&*W&AMl%m$9uR0*M&U7zzYZ6**CKhl?}wP4i&9Mt9_|w&!1M~%8y||rCr@B%F#}CB
z>(D^e6Dsoq0=_$(dr>x+{D8Nx@TbWNg(D7;N;kQ>$b2os9yno-!idT!`PEEC@J8bf
zwkin$%LW!S!hsMlc;+t}m?mA;e({qblE=_w1>`_v<lV3U^F9z_4}Nqm5bU}>a0z}c
z4X5>*76-!}U3wlGEiwXEbGlhM0i|I}S-PQQkoa#&!OnS1X{NM9x%~pxSMz00W|<-6
zkFDviIS)L$CH>7z9Xb;6o1D5wi*~w(3$(p_r>xx<)l(#=P7t9Nb7e}gk1Ly-8<|{_
zF<W2mR~bst-le`wOU}9sYK9YhLq~@2saEi^U)J)AUi&!{qOPANr_mB@t71y)EOt$p
zswBe5z*~FsvKMTDkFbux;+DCFqwIan^s_CWUyp>K*8ljL@eIXZ=mkjxQcc}SJUJ(H
z(9#jKh@>3)dP-DW<gdXEmKm#|p)y?z@yEA9OI$kO9yM}Jq4z>e3ZgrbZ2LCh5TBM$
zSgl_2!xyz!A)@B)a4G;NK-j<FeaDL}76qxhrEX_rxu4PZ_)x$OVLX$Z`5fo|#Yjl^
z3r=>}Gvud<R#Q3yy-wEb5{NP3(>;A%e=v-OyRk5UEua0+pihHd>7gEKpPTOn_q9W?
zC%<c`ixMOg68!OZl8F~aQBn_X4A%EU$N^XoGz>F!3SE%HjYy{KH}0cRq|?d74WuJ|
zVIcKgs7LI;c#T*xPRSCebjD(wlwA!JM#Qr4Oifol`VIUOkIUpz+TEf72xGW1$26J#
zc-odvOfpZ2r4R5P`PxRUVL*ZgU1Lwrdxu)?6zJ|C+ay25dtk(*Z_oaQ2=AbjVp^?F
zS#*g7rObD8GRlC0ZuXxeSs&&=z4c>ZM^pBq>iizCp92YVyV+U0Wy9=R<X3>#KF)q{
z*Tj37=R(HXGz`pEYK$Pp<R9Xr&XGyeeQGI645WjWEhsGy8vXJkch1zs(_w5}>twip
zXL5yaGU-^5qXC(E<1;sL0Ep4&2#;H$HpEgZyTfBEL_{0zMWFQFqfq+K5oJOq%ErOL
zRf~Y%o*<eTD$hN0$IkYr!4?oRQXZOZ`d6U`>S5ShX|F3miGR_(O}7=f;DZ($J{TY8
z2{}N17CN7EYs6y^j@HzCf5mepGbFrKISk@R8UvpyzQvRr`d{5O2=9*0-;QPz{}dpT
z5!h;jKS_d2UU+2#)|$2__d}JY2+G+CFY$w%(X?)q7ppeaW!{oF3+Nfc2`Q=nwCz<l
z`n-Rj{VM^Z<n3xhQn$~ej~C3nx?I9^#smH`X8H{`W`RfxPWqiX&W7w;=MeRkbO~9q
z7pAIk93gQ$fpV@ZUt!r)aI((<t9%;s@-c8Zz!rm~tby-RWK^$j%EQ|-cyA8y``cY1
z*h^qMw#Ps6)3`_tztMnN*Gk0(z4QLV8KPZE2BJ?^QFN<HcT}L~JESzuD(DsR7uZXm
zm;FWATOq)Ad`k-8oX(3+L@UzsDbfDleMTzPg#($%W~Gf>eIZdrJC{W!KTLjmDPNEP
ztD<(1=5%6e=nwk7@qhhee0AzG0w&L;q;M|IomjC-*=w>K5F4{K`{OQnMs7Q3@C_b4
zWlDubf`meiGEWB*rA?qk70kZm?$((8V`fO{xl971U33{+>`dAf&s)GJWYYr@c2`!t
z2dJs_Sy2SD_M-1!Y2K+<$ySV&8q{0455BJUrwK&20tKv!maVDqte`HN{T=nhDv1V=
zwkM0i*Ukq^1MObl)L@(Qh1g}`qS)4OUbb7}V9xAC^Ch}RK56Ud2*G0W<dKr{CMA^n
zaucZCtW<R3Je7iM7_Yo1?{G@dLzaZkFu&8{wx{gLAqbT4Fkc#fi=AVxzfZNiPD45m
zR3kDGnYrGksmf;SAF`GW*^&lA%2@gRazsy~z}^5U8&*-l#TGa&6PSfSBiL0_pP<v1
z_M!ofJ-OLIC=a1UI-ob301gT{aUfcNTcF07ynchZ%g&aG&f51ZK@>$iOO-4G^fYU*
zj!H=LCWUr(RAaa(!F72vrx(=yjb&g4{qkwsdb7DnuRg9{zdBHMikK#LJj=_b&8KUe
z$O<it#(=;&yGDSM`Fq!V;hRbMDhlNQ_P@WgLEpj4HrJtBGZY>cn5VFV%s+Uaw;F}V
zdaS+|CbI;NQR?#cDwv@vzbvE<O}9vjm>Qef)g_XIxNqb-$VE4IIs?5qj#Shxz?KL;
z_Poge&vh53JXYw>hf8m`fYLW09l~25FQ!5%;Xl@01N;%L+3)Xy8N<h}oNCxcwDe3R
zHagN;{+}zW%&EEIn5o-qX*skr3rGW)ymD{j#$jU8>O>xKhgH`o2rrabTMGYTn&mI5
zEljYY&5SE2CbY;h6E+guyLDe%W3o${Ob|9Lg?{CUzo4bP*5sv%FS6?JXoy1=9>S})
zPcn{^oWgjgZKzC^$=VIe{HYzwr%Ynn86BVkoJFBGBq&~lTXz9Lv@gLK2KeM{ttL+m
zrXdw?$#^ql&AXVR$Cz{8SSy7MhqNO>t_gq?$lH$mBzgbjIsd1qa5N4QpcT7HB3tvy
z)iFv~E+p95-cW0m!h7Sv6VOmQwc(@Usn`zCd2WG0q9vvp+B}#uL!1L7Zr=V|%8cK<
z=gdFrI)ox)Lx%fw3&SBDl@);Z?h!xIoWk$J*(8v$9h6jKnm1H#p%|o>Z-XBzz}^0%
z3SOxI+e51VAw#JIRS`kKOB&x_J#@Zr@_J8T>ZK1oyK6Qm)PbDr7%ESv<4HFR43Nft
z=8Sh{z7@Qr&bRt3$XNigdyDbPOO<(Z-=5BYa6GmqxlkQ#SmG;i2bm6LUsb`!rTJar
znmy}EL=u_@;5NN-Q2ZyI@4`_4vsHQS;!4mKCf_S)o*R)Sm6kzPaK<tJqiPsVTjqx&
zUW;V$9vB?pobbflCI2+!;wwoiQ<y-Y?bwP4h^{UKExb<G00(=!#URQ8V!UNjnpnC`
z>Oz|}*}<zOh?O;%HAr^?J=I2wAH>?0+#=8a2>T6~9Z(kEPqGqQkn3>T6vnac398QZ
zm@-`ReGIvmVTUDwc!8b6OZkCY@}~4OTJyh)`r3z}F0AD6_g?I%>P=&3nqUaJWnRI+
zQvs!5hLePg{qBzz51ry=*<xM!i+*7Z?1OeKP&dyB-Lq-0V6?TenJ4F6zz=&oD~=cE
zs;x1uF6x|#6i?W>ntq&;ywWz_@e7M*y%}SXWJ{|==n@Cv;<mXf6K9AtF>VG|z0B$}
z9?#q{s2ma1WV(k-=5AJ}X7`9a>}*4UY3`FGc?eyM#*8;tbar&1qV)(7e~`SJziO27
zQvL71dvZd^TW&&2aag|nT*hu98ow{ESj*3_N737DA%JkC|4M@FE081cFjm}nedc64
zu?~C|{@Ad&)SX)CTovo)UkilOUbn)GDARlBYPy42?y0W|IHk+W+#L+-WMaSzP@z0C
z`Zjaro-h;!QyWtKg?rR5SDQHqSjg1svNHrwg2+-si3I=sj;h)C71@)?^w8%<II|i9
zp^mQ6A|}`l)viXfcU>1Wpd+NS<7z5~xDE5Xj#>u(e!grO!`I>`EffOSfb5!jM(0QI
z43NldsmPY8V;-3;4ppRFZ}FPMu_I&#Vi1$=)*P==$7PwdRj{seJ<NAe<7`vZDyp9-
zpp2oulNfj#fEpnqV!Fu+mJKKI0y<RC8XE2}Z+g#p9`5VMcKjFsqhH@Y8TJ;Mu~3W~
z)yEM{ZjU*%bY8>X^8xXIb<kIEkoN`^4tvcAsAR)pWstU*JJ@fMIwr`fL$B6W0w|hv
z<T}G%@||1<j~k!lv%}5oATs!AMM^4Ea}a>Zxw$8@l9veJXGBz!gxfs41s1ndEco`g
zYS=oiOZdEM12ei@9~7qUX7?!el(^a9t;0L_<+dJIMq?s4Bt~%WY<+_cjTkd7`tlIp
zm{IGI*8E=HI>d;;+ih*HN57EXKsAO%ggQoGzAF40o~YSx!f(Y|$ZQgGm-^ejmHme~
z2ApAiB!22*K>#^ms<#vQR0H@(79LhlC(!y{g;M-?WGPw6>z<=5Zt?|GPb%+kx#JKm
zjD4N&E3fvqoj_X%Rlqk+7ZDcZlcQUmsV|c%hQFu&J7Lnu(}3xK5*D%f7m%JsVe$dA
z5w)h&#x-SGl$ghm-f7~rUE1T(Vj|o6UEvj5BhJZO+sud)sfHI#ymwJ9@+>Pqg)K0i
zv+yvVt{Mio$>_KFzA4XNZJgfdU@@hF3W=z;)p)*wAJFVaSifx6Fc&<w0PaFJonkL_
z+2@f?8XYsvOWT^u(@zBt0*JV7@t_`Ls$ywM#>*a{^;r#_kb|(I8o*%AJ!okIa*3<*
z$!-3Hjxp)Abma;zh%EHfw%IV*jA9@`&tpWM$DE(Ap_1`e{~l3@ixBoCixVITHdi)v
z2}j-WlsMLyUgA#m5)5F5WVZ(6BP*FpxMx;w*m<Lmpe?K10syH*r{Coi7O~D+^N<kY
z%<S3|AsI~8C`I(S>mwkU@g2m|tNOq)_aq^yG!$n|+Dh{m;Nigs;PC1@{bXQe&Zi<0
z?N;H)BkLc@MD~$X-}!S%WTlKVeT@B}xr}#6I0}l7JpihpFid{UTIFVLH}p$uM-TE`
z%ASt#VDw{v$<w`sr{8J!E`}UQQC$j--w@_MNrn+F?@F;MxwYTu!w0tC^8elZ_#QEf
zfOUfhDErzJ7)_RciR5TtmUBIn$`{d<ZHCIBTh(Yz$C8%yaOfUBg9D|*J1W-TTPUE@
zUCM*O4_6KmI=RhrXRr@oQOyL8QDLdSr!fVk9~piRm3U(>ukr9iL?+JN%=t6|Pgk$|
zqZYOqMCQ>Kw{XAhaZFRpobG6(_wv=?q_EDHzZhOFs)bk$wG6ZyBcgmP(A>hw72n6#
zy_p}^e)b|kClD<L^7DChhV*pgrPB90zglR5K?NF#!d8UI)3>&?w{-I7uT{g3n1uOi
zWAJBRiV91Jq16M$IMVJ>)k%&V8++7rfv4y|1Td-<vW1kCFR8lZFm5T}mce__W;}i?
z39D`J`(JLf+ADixx$NlgNzZ%1pxUiNS*1T~$f@fjd@Oc&i-SV_mtLNFxLHKHI+!*-
z4rbbf@jLk+@?k!Ouh0j*Qs8jDmf?@=32*Q&%ee~<!sd0&L}i?$&qmy8-9=-6)1rq$
z7#vX_4KOuhFz)-LAuQr+Pbt4!5L+`wRjlwnjG9Brfb^yWYP*2EYYSn)C=MB-KHF&V
zR=@)4Sh>G&>m^9PMc#o5H@k%xp@lB5==dzGnV(N1$CIuH9t@b)^M8Je$~YzGEBy^>
zXAqx*8d>eUBHgx+GT+iiOE!sy3o%0jDPJBt$ZzEQJ&Fe*Y{xyfV3k)0WSb_h!84kt
zggXF6U=pWTa~`5X1!U3ymL3fZj*B}TuhDEB8(RFDlFqL5$<R^4Vtq%gYR+QPsZ+OL
zx-Oh1zc*djZstG`a0uedwb>E4Y^AC)lX%~Y7g!4mHWbj831$s=RB0srL`CC@y_`BT
z)-?{EX^%mw*K9?*`$%><qV9ONZ|%uciz1q`J!ToKxiLie6nrnPF_sdW<PhR22mh_O
z)jqM!#7WMHG?mHr;sFF@l-VBv{<a9bSGAD-@%r5f2tQ%c39I5Rx|;~TBjpo~ruX;$
z+*FyW6;*(wG6($C<Pg&7r~gV2;_ziD3xPWJfyC;4fH3@_K4ErR0<e+olWlQ0RHCMz
zJ_ZW|0Mlp-uy6{|vvv1Sa>s_Fb1j~RGH3Z9yzBI4eG|GEj;sNNblIHr0hr=LBOPx6
zW!Co#_FA_uvjA-YjrYFYdj~^iV<xqHQf7F1v*y^8{d#0rpurg!WyFMM%qSj1IfVKw
z<j&+^I76Y7U}RvmV3&+E?{wF0SqBESU@d5#R)LUiYnOk5-9KPfCrXQzJGUOK?K<re
zOl%&-Z@9f@wxim0V6ob)e?c_;y5<MYAi6Y?o3i;luG<kHc4C>67AI5%@+5&oElQO%
zWgmQh-`)^O?yE6XUhg%!yW$}UVo7N3y;pFZhIW6sxb725m(1fta7Mo&X-L=9w-Wzj
zEMw*1z$@`g!+D3;6F#w{<MEHQbi^OHgbt?t{)c&Q(HR%=E5FK&*ij5hlb^I^>1qS*
z{*OafFA+5;MI52CTly2@Kl6Y|{F4kw58H)JoLWp{M8I?V7KIVmGHEZiGM-v7`l7Xd
zqSD6SgJ-2TNV8xbF^x*i-h3=9g}n14nTC^deKcJLt>%&^?@T0^{JZzKTdhD(%C9Uz
zun)CQhh~Bj24<|+d|C8e4pf2Xere&Tp*dk)YY^+4R-ZbK;j4%^j)PqykQFTc+Nv4v
z%_V3DpRF#W>6{(M;-@0=*{8HUwPK}tsSdk*Y3E%^N;mwmK`jQpYx&N`W#R(0dcor=
zsXSmXdZb52ALPJXn5%{~>}7c4F21id)Lg?^EAG}k&|}KvxXl^yKqc!z(pS&<UC8Z!
z^1R`DwWu_t<C|Llde)H;KfFLN{b*!JQIH&RnSus7>%wvg`l8wxRswSFBGcH@6t~<i
z#ms)HG~EV&fbbKuijCG&B<@j$K)fW2l+fbgYIUO`&d^O|rV8PhN()LD!s<+%yQ9D`
zq&%UIJdw2&d!ym;uc+%=*iMXXC2d5&oTv??l?=AO`lF>O(V2XcRDHkK{jePUXFyPR
zVn;<&hV0pUE<emVcPz?9-A-JmA5^vZ^#aXf_FYk1vlXK-vvd~%8~DOv<u&jP=Ii+@
zk6UD^I1&7;X5bO653vOiO8Nn4s5WZvb2s+Cp{cW_AJtvWW;yk9IJU?O>U=7eD0Fgv
z3li=htmtNjk~0|9%F!UCUFLSZ!*{m6y&{#2J44dqT7E`$1VTG}eZ7PFi8e~3tl+&S
zWJn&b?ONxQQmg3o(H2FvD<0qkV=G_MG;~?|6vmZ9EN6Stf;w0+mvvFdK3)lgdjz3w
zia!=`iah6GuOzYVTrk$}HFrC9;eYg@q3`o%f?tF(E)7?SzCFuY?AxyT?j=aR<qtA}
zEU<{S6LYN}e8WE7H5r&jpnl4bUWW~zI=NhlQElDGO_s(XO;V`=9T<Cgi#uSoL#AYo
zhu4JCJrolvHiHd?w=c{SQ&3SPEeOcl#AZ{Q-2>TL0nC;<wNIAwMbk{OGFT%;h@I78
zf3r_0dt~l>j(oa}h(yFK-@=iFhLscHMt+EkMngF-xz|t}g7(30?u61~2om!?_&lg9
z>5+bgizV~gy<mWsqSXd9%pHY@*}*PU5S`p9f~kSLK4FWy$p7>Xbeds#TQP_74m;bk
zF_+H)3?xrrl6=Js@?tSzLEcw!#!ySf_Osgu_;|s~CZXKJ5)1Xyq{R2bxSa9^yC!6$
zEMniqN`@~UXmD{yd7V3Cfo{LACSbTW!xB(#KM((cWRl4_fO7GV2&hwjAig-C%XOK_
zfe4uc7YoHI5kDm2POI>|EWQvD1~L#9YCUW=iBnEYtzUA-c=@@w$dxQON=g2kt@nD{
z-3BBUCDWrnZ!D9ax_wDs*g8+n413BO9T~qwrUHBtqp<j%4tWjOHO`zh`jP9!OLS;;
z3zt6f?m~?fAB1{n6cpd8pQ`>y4SS~_@GD2Cg*G`ru&Zb>jJu2sW%8iXpr+AoHq}_j
zrjH38=Vn;KT@y_~@#wB92!bI>sU2~r2s7zs4+`0VKaYs{Jt=(@ej)PmY?J|HPot2=
z+_%x2%(l+XvzJ!Q%(RdJtrB;E$*(u1Z4QezRcnlzQT+*;dZ&T#0}t)_Ws*>V%|5hQ
zCwM`N&0dT1%PaOF-pU$;&)rf!iSMl3?d$oVBU`i*6XW*JTce|M#EbDSeJ~<Gob;82
zeFYGryP@aGkwy|f4{YMIYcJ_?b@t}AXRTP-0JN1AM`h??N;w#AL{`ofRmCq|pSL_j
zZ6-f6)gy;H^t_!Ws5LD#*XT;%=wWH_lZ0WNNm^;FLUP|rW#13-AIo`trK;QjKVq^!
z-3^cDEVo>rHusY;b6O#?S9*o119Qq$TWQZ4uypTCakyrgW2)e%Jl`XzbUI3!xJ@rw
z+Rh|$@<Ichc&D~?DF)Rropd-WnsUj~ozz)uJ`~*OnHzn3;8i1FRPP~U!#Wn4bp?a?
zJ-3u|To3TZBjgPeYk$?$f1z*zXo19jw0P#$1(bz7XPH87oMEd~ffWsGFFq2sD5yTo
z{kCQb7uJ`?sbq*BaEAku!@0Z$7Bknvjb}%RO|C2o)?M*3v@5Y6Tba-!GfbAEPT;J7
z3%$;E{4j%EP^0ndUTWNcy(2hdM&{+7nk4~1RTzz5W$dCrIKZlb=nH*IKPIqw2AN5N
z7{?+!hJZi}CWBj$)Ygkeg7ZW`yK$@m>Z3_Ktvd(GYMHs@MdU7o&e#^8bd?1}Qq?*s
zcu!*2rWcP(^CtP(9Bu!PLafeaghp@NOCx1k9B5UczOt=9l_;LI+I1<Nu4@$STQNuq
z;jjYXA%#Wy$FUiSl=u3a$Hf)8N(K0_Lea?*O)R=!o7Gb^pDfl0>NoOMG-XGtS22<y
z?Lqpk>9jE99q+)}GElfJh>3l(V>9?9o&#n#FsPi0xa=Q+Bn9*~eCI)?elGpHe#ZOe
z<`3Y-Rp-gQ`O>b|QrNsu@+kJC@+3$qhKrfzIV+Y_0Baquv%Fbw-}kE3V?}q)BYEf0
z^qD$)0LF*ErCt(#UH5_i=V2EZm?Mn8K5V(Og0ao?2nIG=(=WtxQ^<pLj0JjWsA!^o
z&Ek~E53rinkAq<uWyiu2vJT$2l1d8%m3!QFV2W(Hxcuu=f6YiarvYbW1Dq&g%dzjq
zxu587j`N+Y&XG8T@k{O5F3`b6T9!DXHPu@6Xn-@XCsHV+&XNwHrf*b7U1RKy;%Twd
z<;uV8*NbPN-heIlP*JAb7DM!h6h-GlVu!Eyeh_bB3KC`&NMIdU{MqZ=s>(X@zotzM
z%P-8Xkxz45YgHCWnXbhIw|f;qatz+sJa2L!EG7Iv&+idd>zYO_D#j;gRJ2Ne+`GX1
zFKun8S`_R#_(}Idin!Lgs!R%{uCyv1kP>iJir?#@mfq6^HP@gf4<`T7U|lw__Oo@A
z0&7l4y3=~cVqndQtKECF9jMXmU;E+Js-YT?3y{d2jEM3A+uH=V2AetmTzZlkkWz5S
zoWry_$Rqi-Qy{KZ1a!hYpg`$k`O($U#ZO|b1V<3h>EqN)ht{X_`Yi&<qTBd;5oktt
zzzQue4Cf>ru@?;XdCEnPB-#3`effPJaYC>>;ToD+F#e^}?9XT>kQcHkOyld$|2u65
z+;l`_(Qm0xm<No3`#u#cm~R(z!)hy}mJsSU%Q2GD5f2n4mR@R{P#VeLWs->zTEwPn
zALuY6E$g|)V~(}PVR}gyF}LeMyw@WEhfhF#+c?9`$iB~9eyh=N-Y(Yxdd5~qqN+Ka
z`Kw1MT;fE&BLl1R1I253A0W+N9fv44^XP>a+F4UYpx0Y?`}U!PVqQ+8XL^tmN{h%9
zNn1EOqBJ$r%N*3sjA1l4Jn9KhBPmDU8_rLVj}t3ajM+(*1W0{4%&tH0(zM9Vfy8jx
znqfadqlDlm@_#N`%Fw7Uha(d7Ir!AEESnM>2T#UVWVl}|=!!JkSs{`9vo?~8sIV-5
zeVf+59nt)>Zbq}t9!Zs95<^2bhxSe5JA|sNFE_y?CR-*!_)h=yX-imk!n9!t3YvkA
zQd0y|oOA7E1yPLhIhXYn)s`Ot?$)c+a6OmKAyxJLc@;;Nb^4oY4a)Buz(~j&o(j5z
zy=LXxU=G`<ii_UrchJ&_&OPXSuJ$2R*fe0Q2d?hea8{A)QT=fyIquATS)DRxs%RHD
zM5`};@5;8J2_o+eYd8b>jV1|F;l8SEK5t@SvfqSUC`P$m;BuG_unIinkri@c%S-3?
zeN$IRPtf8!JIWb09?6I_zHoyYZ<w~mbb9jvp8_}96Hg6`wUnvgr3ar6VxQDVLWvuj
z_0>FJ6=E8dDqPfdDbER;mCEP~ki%i;N!H8Jf?~M=U*#%xf<zl}Ju%_x@8}>J?sFE{
z#{*Pok*B7EZ3Lq{K6?hL<a{3R1aRx@kOP<CJ-qR70!FEh$Nw=ifLP|@P<n&^j!OC^
zYl;j<G~tn4h!`qlIoK6t5r3d~=u4{hl7aeP<xomrI=aXEFjC=vKy}y4)o#S7*&QCp
zVU$~?wT(1uV0~%aW~L(GUF(3cEjV*+sDeEV4~}h{dS<NaT-FkP?S6j$>*OFw%)whq
z4DSW0^B&%up3uj!ovBYphKeSh4<2R*J{>#}vscgKjL$b^uEi8=zzy1o5XOuiBF{TZ
zp?}cjxhyVDq**$&p-WI6#?wclOfH!cxYfH~u<+$2!dr_W5vBnDbMSR99<(Px=Q)0L
zI1T2lSzs#W&OGleP&B0ZPn{HuR_Zz2m+*>zUTAfNYf?*op)zO%Qd3&ryjUM`^$%cT
z0fnC_e9y2~oz$wmL&#%0utYQ0Bq{7)gIv^j7`Elg>vYbpim8K6Yh2^FDZR^fO1eZM
zq@2eriQ~qBN?@^18Bi)bi}Q!HGzHky+NUH&lWhEZowqhDju-cce}j1=g&$Z==uGqM
z9Gy7rIPR83wJ;C0LABsou!a*omPL|lc7MsFF+1Ta>@sXy8rg>LC<&u@LZiLlI66xK
zXa=z*>3~;|&uD7S!3O;qf7kD|f&#4tL$IKWGFSjEUof!}j!f7lvsRYdED*kG6B-2w
zsmW8v+V>jrlLvN{>wOg_V;IXymWne{$Ug*xq&dNQ6#T0uhGVUe<D(G_6Lnuo0patk
z+gcNRIntGu!b6YMcV6!=91RS0Ll&GdS}rzj!YvaEV)iV1-SrqIVWI4e+@l>BL}#m)
zZFtX<gbp10+8n8wJ&)cx;I$)-lHB@MDL^ZBy*7=F(o|iZJOtNJ)9gG3+t$Qcrq7Xc
z$9pGuDmOBNw_NsUTEUs!)e{GQZpga9B>=92<XCnu=k?d_q-7x1Eyx3dJZ^B)biq?b
z)v&&M*IZSlr|JDW8A{4K7HD@qNO*7w<x4RS31`CTs@Dk|YrDv(sVw*i#)eT}_e`pV
zeIDr6WV20(9cMBA_1!}5zqnsO<R5S>CYbq}NNX$dvetLbu;=kSP`&vS!Lgn~WD)L6
z4i{QX={_;9`R&-i0bCrW<s}{E!HFAAYvn8LNS~NO(^7P^w|_ggJtDAj5^8RDNdVhT
zFT`K&7hQi;<695hybc*>bkF4+vV!$Y`1t(|u~K<(IpUVDXmie=!a;^{C~uENHG>UJ
zXNww_pr(LDD@khk|0fvX6<w_xa+)^y`b!Ufj%|cX9D%g5O!B{q+T`ah=D(j;a?mM1
zS}+hwVzl%^s(RM7<m)=tF!Xk-l=7uj-aqM&1@0~OAp&5;9zp82@KkYuqqWo5Cll)T
zL@6ZYu}ziz7&OU{M?Is!bHQ!Y&&Nm<(F2mVKus0viCl#KVslLFB$v6$BIB5^Ubcy|
zk;fTyN{Y%ZDZd+uqU?LK`M;u{ab2$k_`GX+I_>~bR)H*a<Gs`*6%sB3=(Q+cl40F2
zCpALCZtIp<Q#0R<2v;zpHVGjx*mat4!>HD=jP>uV05(!n9&d&k@SU=O?LhBqX8rjx
z^bJR~ia=+Pzu%ve*}qa$ZjvssCyG<=^ouaDeyY*Mugj%ksGJjpqceXoRADs>wIvq2
z=$a-e4awESMz;~25&3^$SWez+T2XAD2rPCl8OsjqS%mW8cBQuN5AKzr5&3hT=km(m
zCT?r{mSNj+3v7}}kuegfJX2n91X;4!I(TJ9;yjZAfJrazAcdN7`~nuFLhi_#@2UCw
zohc?3Ph5R?ZJfFH9fHl}&YiO#^|b;78d0JGbWRN%8!mFtYcuv9t?Q5j-uKAr4mVI}
z$-7yIYS1vVW6w$IXsB|<|A}~#k>JA<fo^>vY`d6e8K#6~os!8><4l^X+n}qCp8;%_
zT{|p6rmrx@E@2LVojABcb-+*d)n<Ld9+rhf2Y@aCB&SfNn6z0_u>^QM9=#=<c{V%$
zKN$gnD}4eh0Rmjw8gwK~AUOD>8qEe(4K&5cVg>!s5Ykdfq7Qw9C<AD?A|<w`K7pUl
z7KYscdRMK8JhI!Et=;2SpG5P;prKBwFLG$7Uplj`ag^;Hky&u46I6I{<?4vO^-byS
zAC0j~DnM)cBhUWTtZ$0vn4z=PtK_3{))>p+gcpTD=OApnY6G#Jm0u@9YK)IleuwXL
zp~A75bouLrb@C)g*;VcdJN`fqmwPrO^L%+V=9sLv{rT)Iu^Qv!`!7Y;6`fS%XaK`s
zE1N+^>b=#NUia?6h~&u2c^#0=AYFO$wi}|8@<F!QZ8Qk4_BYxxNoA%zuU3-i#^$X&
z!LhEHQ9aTyR;%VGoL?;zIb^PFZ$b@*$(gs78VyjQ)^rE_!K{+omVKTXM$)#4Ta&=6
zD0K@%7nED+ZupUw0zuI!9}owl#_r-B`w8kFE1_!Mg#2qro`k}d7@P(6Ov>g#q}3zR
z@^%z=q<LpX$5VEM@bfm=_7RGVoMf+_A63_g59U1z<KLzq7GUTj-)b(lLe8yZF%S|S
zpdDpE;7)^Gtj2eVE`JIUjIA7_)n#e8)}0#iT$l&VryqR3g7wifiCu_s9<$?iR|qq&
z@a;ah{Z^M|RYK`&gVHN;gDz9hqoQSRLQ-rJ5f|~#)goh2W#s*E%2@gs4&9ke<ws~?
z-7mYYa_oAUX;^Y?tz9cDix}-WYZHc}*YI|yPyt%40yiuF@TCR=3kC=o{ec!D@)w=q
zD=<*i!_Av!Y*<OK(B-^44e~(rH_G*hPCsVL5Px9y&j@O15ekgnDvx#2tZmY#{Xlnj
zVXpnT@=a3nIl4-@9`2SEpAZ*qC_bu|-Ao{M!J`si-YdN$iuqt)d8z2y-M-tK9{a~C
z-)ix(H2L0eOU)NM+4p>CGx_#lBE6^BZ<L(I_^CZX&8K!>K$g9tX3-!gNDLhszmHse
zsHp<l?;dZ<U(mf}1O7(;@kA`bHM)RKA62D_t&@ed4|pF(rbx|5I8TlMBU^@2VtaH#
zPeQ1csT*8hRo_X+Ue3k@!TZU^WPL$nCqCgrxk&HkoG$IQ1{0xBS9Wi`%9tp=)iiY9
z!=hAgC$P1y_e7DpHzO^APxIVvH#?N61gYyQGGrS)#-^xG=mVLTw9ZWphSO$+k`tj9
zQW>k9@_MpOO<L|(H!>chP#Fy&*r}-vl(T6Yo{&by@ODy1+{PHcm6(j{$V0C&;!|>*
zn9`~(ChygAD>RKv9)G9%n<l~#-P@CVBTb{>sJAGz0FB^A49EPv{VEF@Cba!dg;rXG
zc~;?ViBMrxnlJKYS5J0ObD4)Yn>;)o{S4Ud^MTc8l+HimS3{5z3~a;V=aFHppN3UC
zU(T@c^aB~m5&-D2>Yhhdp~FQTFTQZ31WU_)L}~3bTGjWZ+$oYj<6p@-Ss|Q0K1F>m
zGmdZ;sv%9u)qwQuY0frM=IevFkK(*Eaa{i^#_T-#0i%{fc$sFGuoOYK#m-x$3%}2=
zA(|n5cF(#13v;N(@lB4EbA_KO_NSbiBggn`wDH%JyDJ~EGF2v4Eo-$vc<gfkf0(>;
zM0G9!wHnIn;;ik%NuX6h&>?jx7$ORDKw&$mO8Q@+<O;01bi)j}WDS%KxA0YfjkkB=
z;tUD{`PMMjo6E4H`u%#acbxF;Xa8kz)ywPt<t7$L5o^?SnZ`)<22ZZdQqmVwXOGAy
z)<uRLvK+t#p4eX|SicZvMAMZE4TnNR?`97uhP6yf+o)b(tBZF}P_-kjK17PXBW(?y
zvg-Tz5xPC>)oM#vm=ALPcr8EI51+_aHBO>*m1*mf+s>PuRSKQ_*D=ZHa(B)*HhrAm
zAPl;{Vl(pvMJJay7GGVUG3iu|S{A4_SicC9Rgq5Cz_+Gku192u@R;J;nfY1X+z%v4
zgt4EF^|t+rSf5SA?yA}tn|KT8L^_9)aU@A<2}#Q+-LRBCuSyou&#IVtc*rknaL{!`
zrF{$%OBt<+aY)H`G>mjuUo#T)tzBweWn8wQ>8AfAQ=L_DK&&RWq?GAEoB0kx21aSx
zc!cJ)TVd1!;<DCBTf&rbx>dET3|n)|!!E-u1SC%L_wLjpO=e>|?ut9{1oM>keWnfx
zXoFK&cEDFlIW!E$l7OT+o15+gh5w#s(tIAWGSEH-31A6tS>+>i{%5{c_Lt~HYxo|g
z8*}PfQeOc-XGDUTJx%?_wt??rlGUt5V>)h2P;$}nwuaiMAf1LBa#j|mHQ%EDIpP0{
zM1aKk<^Aw!Qr!RQJrWM|2&TvLDig(i><_v)yedqUNqYu;JfXh@x1Cda+qc`jGlKs(
zHO?O;PeDUh@Zn){j@uME#$~OXUD5Z@IqsR|y-(jE#NR<|)XADmg3lu;adP6<{~{r0
zxL6vl;cVS7H`iS9qU`+_gG+2fcH~7Psq;@9Tz-C;1SqjqyYNSlM`W3f2#6o(&BvKY
z`Uy5E=w2hyWuYgX%3|ebl<d{<z^X#@Cb8+315G*{Eb;sJ;Em(D6CAdP#^xJ^uNNDE
zFnsC#UBJN7dY(4Ts)=e6tCb2C4DYm;cp=c^b1mS!5YO@+E+)@`XOI8`s|}P_<MYF&
zJ$C7R|0^ftr_##n<8P~DxVilnS`5C2>TC==`l&;ReRS+Yf2s<4Z^e!}MJ2<j2Fe#a
ze8^V%e-gSD2s<29rxw0A)(xRQ|58Y9?KJt=gq+5VT{E!agcff!r|2xmmGqM{(U$n3
zN?|W#WMhP7ZBF^EBx@cC)sEnJCC?QCzee($WF{0fJuAhgyL}^S9fINTnWR#o$MLXG
z5|rsh7Gi`mIR9h3>D%Rg&p{#OVo`hyXrOC1LakZ}!sBg`Ux9c@b>asvbt#i((j5ev
zf-`4wW!Q~%NlH|f_@e;!wm$#~mu)dNS!d1fvTP19XC~{3px+tGovaS=GswcRGoLlC
z`{4I6rAhV;9p3ev;R&BcEIk73a1;oKXskIU@}x%5RkWLT{c*TE2E1md45Np4GQ9Bz
zff*=WSJ|;yLpXvU4-CLuwHF-hNyV>)cbj21bosPjHBE2KRUTmDKo^RmSLP0aE_8Jn
zGd6g<rX36%=UK@CfIXu#yh`2aYcBy))uWR?B2UC+mTk(g&kpOftG&Dos9u%Whh$v`
z+4=!mPeODgc-MjjkI?(+MYPUp9|c<}r}lUYmZ}m9-8*2YX0*n063c|hUIp&pk<O?8
z7LX7KEzW=v(JB^Du8(`%;q|351gLl9YycO)DA$9xgoPZ?L7B$iB9Oq-Ep=nOf$ncA
zSwRmd!|<4Kf}EsY;L#lV<U9N-=vL+sfsL=ZYhP!{o0hAXPs{sA!l|Q~QW8{s>{1?{
z$0#g7|J<(=G8K2Fv2l!QwH`_Z!ALHnC8NjDx$R$9n4zn?%v3Wufp243ebA((0xHbo
zglkk`-8iD$Dmjd*1VuD+UdLNZUMQm2B;s!V-qi&UY|fsauYL(K52=}gK|DRWNC2Nn
zzu<`a!ZPiM&BLUc<T_ZV>url0AEkE1oY*Qo)08oEUz;Bp`XyqK7^8Io0Q$J#l<u#c
zR{>H#E`TO+98wmFEb%u@)Z~?(E1)}viK^qjT97B&_@e$jG?<V46zhr!E{P$sFDLoy
z82EB7;oWjy`W9sIa*5J+^c<|QG#&~hp6*FNUvVRyvN|%50eV#>4D>?(P3UPIi1?yz
zErEL>0?eJrSLAt^8hw%&T_1={rkH&uSqeDr-&-AFBS~N421rQf2%oH{lc0^BWns^9
zVHm^{jS0&J!K;T&fA9e5$Vo-@9fZblsBau^4<(1{CLE|I`rt=ws<)y5rQrPt@P6oC
z5WbE_Ml^}5HuWbthlFg&YOkKHHWhOVf5C`+hcxJ~4pp1%5#C+o-sFSo$G!R%)XTU*
zYA2&AoM_RX&_;EEPH={>zEBvoMNC+PY>~Kv0;z(mtzd)rJE`R1vYjeK<g+@#(9?i#
zJIXCh%^Y5c^+MFab5_9nYaQOAZ>z_ud)|QTPQsy`SU3^$G|US8WOATQI~Z%tBS^^f
zQl20A7+GH47`NsBDe0@&W~Xrs+L`8oSJRM6o|GY#rt&Rxm0@S#J~Cz6_6^M&B_1%`
z$$s7Ph=}TF5*B8d(wS((mp<^Xf1bV`L=ZsxdmVStYJzEeUK(NC=)gvbsZO#E69=L7
ztJeQByl~3q@Uc51h}&~UM9JF`!bg$t|CRs4qxOma?FZx!1a5kI1u|!XSB`r(e*XX(
zYjjLvlc-@&xaqboifiB0v+eW5dL9lo7^`vVFpU#F%k>|E*&3l%WC;-X#;3lwu<x>(
zs63SvH~gSMX8*g#<cITyofamxBDSP8gx%i~n8RDe4%+U;1QKqsu90Ox;l|snH1HgR
zcB>~ne|@x#M3>b^?P?7F3A(B6d5U0Q0#A1oF`9iX|G<&2POgLyWtkTkxzw0Rwln>j
zx`euVt%Cr_r0LGde-yLU?;02uhIec%hK_)JYh~m^1M@rZ{-GcHpkaBY87MQLLKv=N
z{p~gm#SFJ0d?zZ4Z6PhGh(_{*{tELBBOfZV`$HV>Jw}3fnU=f+H(v*l_9|lp6V%rx
zWsEruF0W7r3`VK_79u7(4~y&gi1FX2?Cq7Hh1(`LcPb0WjEoxQ0INLLd1YT1E&Dd~
zOGrn6Ki#cY>yi`DV>TO6jz0kg8A+kf|IUC)m~6HQ<Zh@ABn!JC1|v)>fyYsm9&IMV
zp-@5<HdP)2?}OG+Q7ANS<OpF})ifDVrT8YpT0g2s&-`g-(-~S|EMc%Lcgj%l*ROga
zY&#<DPgHsRK<e?X(pG3t+C733wMW;~u9`UUDIEB_Cf?y1L9zCGu^i{}I!+itk1%KB
z)WNBJ2ya6a$n^(bVm?F`r!N3|p6#u=e5#}td;cMg8Bl75pGS{eo}`Qr(*l)LO0usO
z=SwO2>qI7?^&TUYM(OII(@Q`X>*L4hf`WgUg=inr*fi!dcD(U*E-t#?J&?jvv#4zI
z+PSs(z~URdbhisK@EHvPG1J}dCaSzroK{=WN74r|pPDB$c8>BVI7oV4KPp;|*a@NE
zu-SiqhC(mHlGNoFYz33R6j<j!mS*He1@A*2_2!Kv;umOMX8;iRc8kExl^)V*@ebZV
zEwafB?EN*_CEencR*MNdb9+6x3xC!FSCY<+?9>#yio+AaH&kL*8f*;^eOiD+0j|)G
z{N>lrDi$jotx6zY8U09uBu*<z_c5QsJPQGYH^6V0Gus-+LD@LeJ<cCen3j+L`Zsl}
zy10V5N8|5z*WIkQt2~(XMS>xV#!sF^%YHo0f3-ud?KPZnN@-Eo?5UXjJa&yCHr%NC
zW9Z$c1NnCtP&+0sJVTmWMZ#=aP<MCkiKpJsLy#KL@%iWNZ|FTOVl&xb5EFcyr22JQ
z6IZjBg5dcB2+ed4J9bS1e+eENHxdT{#T1pd*8vn3vuhoP(>bfO^3C<5jDX5J4_DDb
z!i!^W%3h44&#oN}P44$n!;q>RSIt$mqBv~{sq~QH%Jipb=lVvG0<O)sh^wqgB+}QD
zj0idWJ#y>EWe33vDj1s;%yftamQe#>3Jvb~T~|%&*KxL2)j4LF3aeS~Ld|Xp8SMgt
z7^2D*TjKAV(m0$9I`~mC2Uu$+SXz3Rt@9NbH==6np4ODX3^TcED^<N?l-0tNfq{BU
zYwNT-;BOaUyD!^Ckq+hahT{tcS}llsh7M6o6@g*Nrw>xM^Pqk#Q}u3akMP+|LZ|CP
z2UE@7cPh7@?PdQFM2(amK9V%p7X0D|4Je7a^(V4rQN^?X=Uw(DDQ(KYcf~?LhpQE9
z(!DbzV3am0M(vH*^Qz_Q#);Z%I{B}Eg>_sP(Gh=I#g8^W2u>XMo&0Vjo)IYWnegQh
zLq5crPJbZTg<NHF!3q#9AeLNgBOVIJb3>a@9+-nXu<Ur+C@>IqAwSqx={&HW_itkl
zYYPPl=t(q+!y{bLCSPi5YGdAReRMy3Bj!N?g|Snm5ZBZMD7b1iNi52M*~PM1gO{S9
zz<j+eOf;+d=~?-Nq~Xoa!V40Pz+|w<e6?yn1}35PN@;?;AMUeJrgD}}>-%3LBT@a(
zVRjXqj~P%Tx0HfwrkV$0BW>4|wuK!!$}MFBDMw&>ycpyQJzRrP1SNOMlvN$O0id`&
zM5I^eq*r9x$ezcEwcXfsHR)v5{OSEIcAXs<D1m~5doc3q%>OEwtyBh>MkDY(ovy~q
zke1^w>mueGTvC6{C;ZwDn84H+mC?YdV(MPx1IhlHP~^`ge0^+g&xLiq`$3OOZA8)Q
zGqCMdQhl-XIK9ab`%gM4rI%U`p_L*mY3BpzV1}@#>k6eWPfM%WTXAvRD^8bKS)hft
z4)Xdu0$n`;dFIlupar}Nr8zX&c+Pa@A6N%|*swuhY12c%u0yKf*{2GnRMxJOi#HTP
zu<OHj$9zK-L|+rq@aBI!NI<Wk$gOCOUXuRWCzNw6e;t!ZgCl|7Ry4qrdGK^itYBj1
zOWa$x(IsO2+_(Vyx`T{S0L+?2RIXm@LL|}}p=Gt?!4hQqE|RBV`4}ncL<{Xb=OR{R
zKn7LDrsR(pM}wx<bLU?~znF4hV-si*DzfN&A<LN$OW}TMBj=(iDPs~pAMZt+YS~+f
zZ&P&Z-I|PY{zXa)sF3rH&VP2<<K>i78`879-Z4&Xi>xvG*v6-yER`sEV^J^a_=$_T
z1lG2*9*r{fyJ>=}sEC^QZ?XRebm9URl7Vc7g#0X*odsq>og(gF2Tkyd9euoLW+LN#
z_*itUY;*my7T(~bErhbRAm+&~jK#NL2f_8DSxm`)qM4;*z!*=x4RMgnBaU;Dp?Hmz
zVDc6(#lO9!ZAl`!w!f5+V9xhy&#%kcbPkcU_LMqtUvIOEl=6u;N8&2}Lcp64xGhnS
zlqe)K>|;&K<nI9lT4p!yXY2Min<G=;Wb7ZcW}%^;d_NpxCP!0H_;?HH#Npf<(7O)i
z?9wEs3oh2!%(XjD0f9$iW7Jg__Hu)5=Rh8!z6tSc+xT&G;TKkS#jtu7bkFy=^7jEc
zzdK_dp|AMH@wAJLDB@-x_tvS{b*^6A%_4kt$PZ%KR(5cJ6DcNA^!DyO;E0Ozhh;s;
zvJ$|60jd{dG!#LfBGa#=Bn3#_jw;bd#Cg_mvY+Z=8gU<%^!;FcYfE3;oxHEEWWQ>o
z4(}7wKR^DI;tlv?&e9COb}uGY#Pe6H(i<G9Rf)v>yQ~b<;U_5Px$r5Rh$uQH-F*M;
z3cj#iN~*m)3tU<|!vi97vx9qD3oa?{IN9jvmp*?f5ZD(_q*#eDbJ=d&0!6#Et&YLm
z51fF-KF6QpjPemu>4Hp$WcgYj<XUcfY<lvn={gTiz9eopaery#7|p+DABq}Jb*qjh
zDBQmX+2Sg_RpT59bi)&0#Qbt?et|hX37b8FJzi9Vyxh>?oZ_d576z8B_F7y{6sH2P
zk^JbM@3`LVToeDX737|3X!FJZhPygWlYFVS`lKiN4tbs3WYcC*;)dEiGT0B$bLcsb
znzCdv2I+}?>1t#kdGOkrPV${_^GCD=djnt~6Ky@kXwd|<ka`fXwUnlUi~z{}7E~il
zbC<%lWJ9P3anb)htp~UFG}S&lyM~(&v9y}Mt6zYHjq04ttaXR|1&Z&^G%O0BUA!KP
z2ewLuetZ|hr!p7mBffd8jpe+D&P--gW3sL#9jxa`yCh0WIu0kMDHw5Wvh0k^yMd)g
zbsHh-B6Y)h8^+a+;LY=+^l2%1p$c0A*SDF7%D)Ud$7Wr+L6@C2uGgDi%uzxv1N<jl
zh}Cho*3b9|oXuhGiw&FYmjP0$DLjee30O}3m-d9`^VWHk?Dl)gPl#V{X<4KeMY~Y$
zW<0v0$!|Q_ZP>m>ki!f$!dAnfAnjWr6IP~0P961A(1aI9N0O)QqQ{@fuUj@r#|&XV
za1$f+5Un&es1QTBYhsa`)rc`to=notKUbmiUz~z6I-2a4h?&qBz{HWUtrG;(*Pg`N
z7k)m~aPpxY?8j>6zu?V4Cbx$V?;te9%-=__$end^!ugV(f<mpPKhY$~POvnJpSb1o
z9125$2a|4so1H|R9#GMUsA8D$B-Hk=34+5h%MY0yPLBc4sNf{maC2E_tdw;HIK0o!
z8?Uyhn~X`UeN?$oFgi|lRca8jULQ5wQW*wJEu#pINQV`7yXX-a%j=Xvh*P5Mz`|4y
z6Aw9Ti1t&&OF+sad1RRdHANvhsG}gwhiM}!;CM}1C}#Tg1^0k1(P^1nl0MQyQ+(j<
z0(?HYFfITK5U%nN+~WaHlt+&9LS4kd?(N?fe~uY0xv0Q2Hp*kcC~<*(v}HFV?Oxz~
zWKoh8RNB>!5}N2H1Z02Qwwc_DU8JQV-fA;wI0o!2AOtYAP>u?T7iEXU`qBZm3}N?1
zfNlJR#>6VNqr`h>8<>GDiFG~iIM+yNrE)5CdnBZmIYYnghN$WQYetZBzWZ(WXoVAE
zx72OF2Py7FdGro^Q`RHAjuKVXGCfx%6}@luA&?)_0{pVN8n}hlge`KQ^8xOBag$Ip
zFNjM}+EAYvG}W~t?*N4<Iy8ehy6358_wMbv@fwOPuS3;@27OZ94DLPiXiPLMI#wD<
zA`iWT`X>(R4U~1QD3U~7_}*#xN+|piUSKU$TrKM|@pNn~-e32<SxU~OAH`#3$*h@7
z;=DtE|1N3;?a%zknciOP<$6d(*EmE38e{+;D^5}Su*yzGUOj%co7Z<W8mVjIi>y4W
zuh)gsz>@cay<rqZU=^qkgdo9D%Vr@FJIyf_7~aKa^x3ehy?eh~Lxz@DOTn!!ptLLz
zKvI?t4v|4@;Y#UB!kV}a>9Br%B-Pe`SF|1ZkMyF$L=r)QC*cl85!WBL`QmENBQGr{
zzfEJCvhwFSJA#w70t=7HFv>jN)!0D%7WNG?vRZFbI#(?=wTAbcD_dmo7v$J>0$**L
zQuRk%pZUJ?0V=<b-RghQ0g(;;Fp3?I(xeY;>PayzPX8CydVG=k;ZmVen`Nua<>Is1
z#|a5HM1_}SJp=AJ0xPG6Io{L65{ebJ1yVr&;`Frl(;T^*_+Bsc_*|_GfPft)uE*i7
zw&i?^5>)OR2q@KOct2wT-#p8nhejhP8&G$3@p5r#KU##nkGjif;PUB-7B83wL<5px
za69OptgggFHR#WFI}D??pm$KSAW!pR%<|J!CpcMrbn&0`9S7T)5LhYo^B;Za@bF&a
zlJd41S`QmhY!3B3$Hhx;DvKd@G)-avif<FD-Ig!eEmNeYvXAjPVxK%R-dag+T&OGk
z&e3YjWYhIZF6EIhNC)1`#?Aki5@Us<cJj3cT_GcVF4t5+yKB(H{f_&*w-Aor1)^%?
zq1DA~o(sW#FROzsDlCAp1N{^_t=~^^L7iBQpKVZl-0=ORWNx!OEx?Z2s@gnY26!Yf
z`+!4k*A4#aQZ&4=Z4KYoe(*gaT%OiX;l;S#NhoQx8cqg&YcSu!3R6JIM%qQGPQ$e*
z^9o=To!aFiOU<Q81e_F8bMm(z;RbUA{nn(b^ytHMfL&Epzlwg-BWy8|AhuJF<i`XK
z1gqt6Q#|^ZLKp|iku@~o-~8~}7Y<Resyc}v+wG@%$ji?5?{$fOt(}@zwPw-7q+|m*
zx=goq?!+o=Jk0<&(A!N0pR^#PW>oOvG*5f_gM_c&=oRqm4pvqvQhTRZO_P68Am<YF
z`rD1ZW!KdTvFH8Zs~bZ7$uO`@ND=cm`BJ^NX243ewEM$8Wph6gAu>a7)&+h=UO!}t
zgu7ynC^XNP9M>UkB)IOE2N<u2VX&E)Brz+zwps$Tu03EIP{mja!^Yl1QPlc4f-;ob
z!T?dBEk!76onL?oBSgQ7<w-@iJOjbf+Yon$no`BBR4vD+it16G_qI9oRDQ@F+U*Mt
z4PJv7PbVU0?W@m}WHCS3FhNa8-xQqS{7gV^vZ?6aoO4Q%B-W)UYx8r0d1quWN(U`L
zl>HHsvvY-FV;NW0vvzm(Mg%}o&g1_8fmGL!7y{BxVX8(LDn$cnA>vcnmu-iz3x!R1
zLdZ(<qg@Nr1eq^zbN{|s<OknFga>EIR)rp!0O5wt_4(__JHQONxRI?)BwrE1X9WlA
z!w5_osg*%SDwF^*K+eB3;k>>q&zaPgV7|NOXU|d>4k5BKU24!(xfWvM9=6ZJA7Saz
z>~w}H>F=@G@_RE;Uyc~N_y_aiFfmS8w}oHAEHSW%sDt5sbYf1+>lJI;451a&#opM_
zX=T^>Z+4}C)NO&BtK;OH$}HljL`PM#18bXf(MEV$#0CkuU9fLWdy*BY-6W!N-|@vy
z7tvJII*o0)>WK;2aMcFM?0pI&vn|}z6r7n9xZ0~bv2-rqBz#7t??XLDO=P#1zHC={
zgIv=k-94p5cmIXEH=X$CeAyO9mTFJ4jZBS4M`i^)8(2Z;l@eJb9W={}ERrT{gAREH
zF|y?pcHdDJ*uqc=TtMT!v&a&+El$*~)1dxO8XgL^3KebgNZn<f7|Z8;l;eP|_nEc8
zHp5Qam@Q%NJ=f=X5#;~9G_A!BnCYU<%gg6CLF#^Ax|Kad>4n}T7K!pp?_n}XyO*H`
zsfMLY5VnNE$a&lW<5Qc%tSD{!9@f3F=^{{mSNr^}sVx8>JZpta8P+E>`61Z@VO+8u
zh_(Z3d~c|RIj|v6{e~qUi*o+O&grX&kJ5H4C7#_0--_~in{tVAgGnFYF)3nO*ABSF
zKJLst<|%=hZrWeeqXUO2`!H0si0LJ7E-CLNCy<ZS$B7L-XBElm#71qk51rwvDl_>F
zg8p>aqN&hKc|C5LvQ|T_Y0RH!p%XQ-yhzl#blrk?%;;kkIYK_`Lq4kAfbSy(Hs>46
zfMHUVbvT5F_!8QU3D<t{YjH_{i3xnby!9~3syYim5v{r+NvqjB2r?3oBRO*KwzDwf
zD-h{8VXkp{mE~x4wz=}6_KS=!PVIwUUNDTOw99k*f4A?;po@XTQuqby(eHq?0&|?v
zZ#)4e<oc<Ki8bzIVzWr9W9rWK<wGX(_|9CT5YTi5?OL5qLL5Fv-B^fbMMV(Ug+eeS
z0fbx<r*dOh`hD*=&&a}7pT!N82tSkk@0)+n?o^&H-e-t&UKb}FTTmS#>Tv@rU>;Fz
z&T&&fDS|A9%XJ7tHRggckX{?|RM4Oc%_4YlfMO9a(i1a6Z4$k3w%jXQ^`A~N?G1Ck
zH_L1F57$i7be4hW!muqO9`;xnsNPhT0up~$+G#C3X7j?dC6u5Q6%yKMh^+VsL!Z>>
zn&9})(TRugmE3oB?Mn$hs{$|%j}NjnBpDI*3hZQJ(M<8G?4;ezR@(RhWFF~-@tu>=
zZ|HbKt;tO4=D^|1zzbAK2khm~sRJ(8??Z&t9ulK2tqw@WQE3m+>kx)-BUEiK#hnfK
zw8kUJRXi{pBE-=d<ZVdFnLCsjGhJ*(aG0dxvuynW8!*eGWE;Sf3PSKprI<Ib(P%K+
z+*Eg`9K^8I?f@0G$S^hbA~WHeoF%xDmGoSiE)?JxyGga$O(>6)(+wvdA0S`MGA7cs
zYO(;EQQSY*4;WCsQ8(jwaM=&$BojpLs4}Fd4?+Ia8JO)#;;@p(KWhZPW%z2Sz_1VI
zNVPPRo~OM>b+q<zbKs;_!IkrFzQ3?<kPf@tf(=M#_Nbb{{M4wl%R(-Tp(@T&^Hfc+
ztVX7L?XBN^F5ZDDjTotY<S+|1r?yE}hx)WSmPxb}ALgGg7x#!a;%7K~)u4IGOf5}y
z12S9R2QT(y^0R(fe{Sf>GWb<&pbUD{sS-+t{JOz}oKI&Lz-`-3BSi711pf+`@sw4I
z{_i*#(LCHVG#u(`RDt2pnbdbgo#ynaJy7z5%oWa5IIBSAKjy%_t=CN#T=*5fmGtfC
z*hRq&?}Bp`<Rcv50KKM53|XNovcp!u9+^Fvi7?P&|A$|?De{K5VnBV@l+rk6HFKI?
zXb}yeaD{e_-GlP4!OCHc?5+>y?YBBABN|4^=r+%Qikr@{s!4+nP~&x#gkeL)>=u-4
z%9ywT&%jjsrx#RgSMYw-Sa6v%9tL&!Jy~G3Hm(6Kq;}TeVS2c4HPT_G>+=NxIz>6_
zlg#jg^S`CBQ|jWlL<XZ_BEjuE5m{4&Yo^F9TfYM`=*Ioo(=|q<d(76)3hjxu7Oq;G
z@BQ<fZ&3AsFMP&h$i4WrMMWJ*RSVEafY==f$y*8%(zKuuk1^w_#*0abxwFDUTH5#(
zRJ-RUc_6zI^f8lHt{z(z@m<!DQP=K{acKpXdU%Gb+Hk@*lEou=yk01tUWboOXL9Lj
zhVPP%Xf=3U9-2qbDl#+-feV-tGI~2hiEzgfkh_uopnm_A9mIU}-iYoI!=+{gH%Y#q
zN0knBE9RT2oy6YMe1%QLY_U;go*qx{Ti_hj$sJwclEoxChb@U1y&xtxwkZDtp(Nri
z_EsWLB8*$}`1vyf3BHtzJTWS(Sp}j@*?GzAcbZI(_E*nanuMzPQc--7^xCNY>bpVy
zwlpG67x{m`(xqZCMPchS;e=TV#SluTUO&><i5n**jhNWz7uYP>2L2@ham{XRa3qn^
z^Oe`Ui>+>j<r&Mbj8|rFr7AIeYB?>o8YrEDd^U~_s(3MfD`F5ndB@(Zhe1?pNc(H2
zTUUTLtklte={2jM*32>wyM-e@k+%UwzFY0aC5baqiBdya)90-ezN*s!SU$7-Kk_?d
zp05i5+3HF_8iU}JPly$luC6C@-AR{9;!-)KqvnK?l96}0Xj?2p!0RFTGF0dsdB&P}
z8eg+k5G}vs{&)w57yqu>JLfeu<_*x==ZqFG9-Ma#EZ{HZ3*6^fAk?(s*Si7+)6o3T
zd}A)Cnp=8YKQ`!OJuf$kXAp=$GLl12FETSg$l+`YpOzws?>vP^d^IRw<2tSmVZ|-(
z24+gO@&Oj_$_}mi<t3iyGYQ{V#DYZ}y90z!TDf>Rcu)UkY5uU%HQD-R2IHnq4Ij~2
zx;sd9Kj3M_hQBkWn7mVpLe(|C`;6#PWW{6m;j~X#7oBcf%!C+qeg2f8r;Jf^y&$!=
z<}E8z5gPh~0I<#<6wpv@(r=&+Kxa3!<jGdV4<ni9(4Yre5^4-ny(D;e$lHSQakVQ>
z3DN~smBdCdg;Gf*=7i+K1<pchS&?==h@n#}sWj|9wQs6$WlD8M-WyPZ_-AhW0<4Od
zzHtkx?b~{Y2lyAT|0g$)oh6~q`Z<ksMNE_zlPG7_kn|w(qnPz8a;=)i!Hw54s4t*f
z8o?F&d`7&NY~3FF25VEeSte1L|0dmoFWhhC?WYT_Rt1B8EHt!7TBzUh($ovCT{g&L
zUO__(Jw5f60c@6nExo|nLRl!o@GCaxZajm8LQuut`SU{2rZ0lej`ojcl~6BUI^GvI
zFHD?$Nslq93&p|A0~;rkKQ1>qwHOF7Ah&>ksB|FG2R4fLaSj$&EnI_b$y10ie{?^T
zlW+M-->i~HIfXgffJA`)A(N@|BqOvf3`UHCSM^y9HDk4BS>igIZDHzc89f-x98W}g
zBxRyeKkb+-LtJ!tw`0A2tin$SJD6JqNbQ>h4Hlbwv|*iXCitv|_U<^*6`*>qcJgW}
z79&=K!-NKCLuFJ*In67;*2sQ{8C@GlGrDrOiH7&bOY?El8>a;UIqT1q^)srvls|{*
zPZ8pvR`#NI+4QyD`37qKgH&&W^Er{^7{MDgWIes)K4XC?mj-sM_!LzGn2y*G*|aTd
z?Mb!H`Uk79$pI=3IqGZGQ4}DxhrBzYA7@5F^8-pdP>j(@-!)^z`umJ!l+l<pGm~HT
z)}}Qt6%nta%!SnsHt@xG<HU-#DtdRWAAo)REuNhx|8tu2ADgS6uUeF^*#dlSr#c!@
zUQHU0YbPS#K|ab++wS=S%2rWBF%dp+;pDiW9ad-EQz4THAglKZ9-j!o#W#eXpJv@N
z%h|b`Jg&vsX|bHkQXyNxQsnpsLsQ<zd6=w!zH-N=u7He?ZZ#Sa?r3VZ#2j7dv)Bot
z$v}Os0MVzv<=-iOban4|vmAU}#`E05+Mw{xukUqD5AA<Mh#+cQlIJKJ11dz|I)X{q
z*1dYdLP`;^(4H||UvKkHv9i>aI1I{BWw4?_ZxYo}s}nn4kbeImMDT7mC@j;BMhzeg
z-nTh{u&|F!jJ1aaI4-UgZ_%4pyAB-pUkr}h)2YC+3<}FUFj>wQG*Yx9Inv@Yo8Doa
zyEt??$j8!%HVFMAxE*P)C?u1I+a~ZH)=OD3FHf*bm^czIZT}gDW3d9TP(QNVjrtn}
zDqD)6<}b&g6wb6X_^Y_Z9xlJo<q#Y`?`@v8dVriwF5Fkpb)jj(Dq&*wYuk8*@rF5z
zG<c=b<q^{h@d`Jh5EBp2QAvI|D`pK>qTRk?TRHlF863)W2K;Hua7IkD%3~WzdbSE;
zg}MnzKl;$fDaZjYR)QUvaAhUmAsUw+z|KjkTfUq2&Un>yeX-%dwBcfZkI?fhG{Jv8
zRU~Ud(Qb)dS-n-QlK5_miB;_1RC&jF?tq$#arrIVQMcm{@FBUH(l=AP&`4roy7^HV
zz8{u5SMryU=RFymSO~|FPo-vv^}N%Rc8Az?0BTka!oST;ygp|z$P-J+NvjXPgs~?R
z^q2`LVgtxZDUl$khi6)B_zG<WPJ4Pxr3DW3V<ifmA#y)Cuqv)3ydt;eb&M*I+?A^Q
zp3_5lMz{-`O)HwVe2uDCL;I~J$l2Ws71}MR)?mEo;w-ZoT>2<rK>od!R#)n4k6uPe
zz(P~qJ)+J+?%dNHD}p5jsQ+d#f&B6uT@2rmkpp~RGi8GiQvO)DUwEcupftRsfL1UK
z$)cuch1uEbS)w-WzX)ZXQ-zqJkWvgnXD!D==h*tM?^SkF?#3`uYCv^?#uIO1{4<eI
zu9x9Be+YUSwVnZvwnx@f#{zA2W@be6a~jBIIW{#T#Q3kzojuU*;^X}|?wX>(;>qHF
z;%`Gu&EtOrTRu=aJtE0+h@(aHsiiycUP*`-S5*L>5jyl=T1k=uJd_P|{#7;_cI2<_
z=MK+<`b6ViHPDI+JkSbQH?z8czuoMMk_c{vr`+AKLfqfJIqQml{1>#h7sQ_d=sg<W
z2wO3Wgg0bu)4;&m4j`u+I8T(;C(DCd36N3SA2J3bA2M45Ow%WlVZ<eO4B}g~bv$@3
z0@`=78!ic8f?1N#EJt=xANREK6yH)_1j-`E+!ByyAhCnCf<cR5h#>FV?1u>wG*T|4
zep>(w=}zl6g46ujZT=yJ!T-(9mTCAI=#L?x&EyLYH0DaJ|8bWj2V4WM5e_(g<4%wd
z-z@TfnER#TiS1Df9~TK~(K^LvP{<}>>V`}t45=a_*Y^qPK^Pu!DbEIm_v^RuUVdKS
zr#BQ4jXQFOYss#RLX9YaGo7bVBk1l^T9d&_pW!z69YU<QqBp~t&7SX@HMNp-)mEkK
z-+wk%%Zm=l(K0YXC^p|h3%CD{_Ym!D6Orcvpqq?=nAP@gU6mhA@qF=<vAxRBMZ)ki
zv!IzFJCqnx`K1f=6H_~_VrzY*N5g8kHM*oTltQX!GM0Vla+?MnL0j-~7mLv_zz40L
zW?t%T6lyqjVzBv61~9wYPOJ}x0g(=XOI3iS!K;^`qpM39w#H^^D-oK%-4TC2mWkdS
zd3*X;hY`p4vEnM8XW@jE<}<h_fa0Y}^1zYpA73?sv$*10qzvIMZ>%Tr-uMx={fW-M
zEw0NJ;Ho2(Z)vLx+H%BxyLv02f_N4A(r^~JPHf&+@PyT!!gOUSYY)M~>!pG@hxg@9
zcsjl3FXp=^4@4h`wZ658(-&7-<AM~)$fBY@-JF&ce&Bt|t;vaR;2(R+=Z9H5t_?P1
zj`I!|o0U~w+oi6c+YiRtHIOt0_{Vi-Lw|*Yvj3<ff-04@kDgx<$3Txp2EF&M^dp&0
zSA}9|0itqQURC>NpxHI%!ZzBxJKf_Yhb%{^v-{D7FaTY}D-l!ha(=K{v2*Jt*>jMs
zvHBebyB1FFBgSPJ$;cunFZiJUQ*xher`blky>LZ>n9qJnae&fFUs@W*nB3oWTc}4e
zVwhSNjTL3=@WQjX#@+9>Wbq>6Z6iFU1uC=r2vC+CtQx%CE^WQ(e|^MDCvvSrUaFyU
ze0YNXPpE)?Hc7x)hXW_-TTq|&!)(hRCOAxWlJ)J4>w(E6UYZ4(lDNekNzvrao?UAr
zum5`X$PGm37ONs(6-O>4%W#bz@-k5XsxIYq>(8#y52L8~{f<slK@lvs2!=P2w4sBp
zRBiq>UPN4pmG_u&`i?AIv2-A1K^(wYXLGv*bJ+^zWM13mlvU7;Ht8ra<<#IIL(cKT
zx5{>>Y&BB9Zq3s|Ze@iS`mu=R)b_3)XbwvnKb&P-jA87Td#Y@o`oQ2~9m6KJ7d`uC
z&oi$i40ONIKFf6J9T|szV|=7uK`7EMZcN?n*tl5vA5e}##6tH#{gnY;L#)5ivja01
zXku}*9o=;bhfd7FeL%4wxKOo^)W}D?Imy?pG-?#?KUN3`VH676mS-_%$cZiud&)4t
zN&@~p{Zk4A+Vm7n>gnz4&^*^n$ON*bXzkt~Z+hF;cHFq|xSumbcWT3FWdo7~x@*(q
z<%<66I)hS4!?Wg2S{et42!`gIglqSND)?+!Kp7Cc*cy6M^{q!m1gDsYfTUKxr1A%S
zRdf{8@o*&9?oOAmodBM(tyWbRd`=6GjZ3<77a4AqmyT|v-LBi=0|!y=sQ%eHuFEB-
zBu<U=&Dn;<z#7{ng50O40a+VSs3tq@#u1vJMiUSc+q(J3zzXoD1JX9k853}j?`nJY
z6qfRwH+zZl*#qX~8Y)UIsV=3&`4|4O%7LIOz@sI3=Zv)@i5S912v>YwFdn`D2-d8o
zLliwZl`L>JheTM>|26AB{*`h+6Wxy{LHnS+{36~wG!QPK9@E1H4!4fhsm7&t*@({P
z3PG-eARD>qIMG;K&-=UCNvYx48g*Qn(I;nXG9;Um5uOq$G)B=yM9sIjbj^&SIkTIT
z@s$90C=9gbxEs?3I{X5c3%yQSEwb{E&!%0-H!W=ErC*m%W<zq3ts>(x<q}%v4SJIr
z0s{uxDCMAK$G!E5+)EhDq->}!arI2+RCnV1hqj^;K3GfE`PRKiiL{~1$mTga6q03-
z*bS^h6|#AJUE{l)_Aikc?oZ-OKZR<wTq~fr42BJqkUf~!3(G?+3G{aYKK4eINLyO|
zCewX_XPH(?;bi^o&UN#Jukb(Ht*p#^7@<{!@zXQDTuE?^pKq!&d-cSDQyDa)vU>?N
ze}q1;3L*3iOzT~j6Ru<y$ts5j!(=`OMfJAG{&pn6fIY;<xqcdUWijE*s+4HQ1cw4n
zaD`$``)Oo`4Z?Wv{!B8M!qk3WEB{rZd6=t9>Xp%PKhhKVY@^oB<i~VoWpods=q#*S
z7tg{7v`?^^$U}+nZrAtWHUmm|Z}Ayl%lNKWk1@Ld0jf*KwKorW!&pVWr|}#NZ1i_+
zepw2PAmm=Lx^LUn0|H({syY?FrQR#9JvylX!C=F@=(r-jRj3it{7BUnw=~{B1aI76
zar%{>P7k2i_~G)?Zv+)F#f!mygceSakbPOJEF|*;c0EG*DZvmzpNPI<G=&C7TBmGs
zjtTlT918og|8a{+88@+&i_f}?;_nd_1G#2p>_@bpvmjfDuWs6c$zz6AjbDid`>4pd
z>y+ic=8h3jj~{I_bP8c!*e1Kx#Sj$19Q@KORUwJ1ZmdQD#(9xhHc|ZZo?<}4qH1Oq
za>Fl{OlCC`Q5q?n&e+trM96Hl8VrFX>7PB+@+XzhOVAnP(a23qcD$;H7n&<i@rowt
z2X&C+-^+;Za4FC%^@(8a^Vwe3q}0=AD+jL~%j&Xz>yzF(CIqK&J3w&H>e-!dg$RI`
zHAPRMi~>2D@e_P#V}UyWQ>A20mHYL=3HubOUylG&HlWq%5;0#0$UGIYI8z@ILD~cF
zNNq@=lHy=&F;^~&FW#k#s6<yem+AJ+pQrlbh{%!J^3sd&!6~ako;hyQQgNbZ>g<Xa
zAzgfQTA~s@>q|?SttQkD^a3Mf3~f7z-`wRz`6m)~vE&pegKBQ*JPljd>e5Rn^(v%?
zhDk5}^<wN;^;-kTj_ZrFRs4?KzRhAymr94qu&>@d6r)HN=qo44Mf6Nu4p6T5*WKwa
zM@X`PXZrRS1mh$Bcd3>K?xXJ{GJE4rdhq{SOqpTv`PsiLV)tU;l3E+JVcu5|{q^K*
zVhGJ>;vyZ~i&i%e)1RL;!VrzSc$ayi3$Y`$E;b<SUF@92FUKc9IK@{$#{{(<LYEZA
z0W|_RunIZ|>>}{?7otMGP55(sgidr*eO)VPz-)tEhs}R>OPIJ!NZKZe!4hJH-rk~{
z%I=ZP>a?5JDN&9Uf*|-2W~5P`A`mDT+l0ddfveFSOYG@Duvmnh3K~M<uZ43rE9X>^
zUNczg`zzJye*<Y;-V=<Irt8FY-w@1*$dl8X{H@bckwUtL4SmjwfPpQT7<Z0W^6XtI
ze#qBgTToAyQ_$B@1=#KOom^Xy&tdcjE-i_wY#Mk9n_!0_>4;zR&R<^N)IuNf;$c*N
z;0gCNbfLK_1y7$*^&basC6lW=1D_MoWng5Xc(%bRW3oR#if0>G0KsThX4dJV_Ysw9
zZm5ukt}ZH!2lL8oR7UqAtOQ<TFVpKl@WBCBMF)H`GQti@z}C5<18PQ86)ELk_Ezlr
ztCJ~RK|qk7Za1AbZGZ@dyeVm*z(Mhp=BRejW7Y5?PY)k$n==>z(K6_-_$>Zm8eWM8
zREiUy`dA@kSeX05W<2Jf;223b*TwuEeNhfKHMM}DqGsg%4J-$K<?6tbrUO~_`PvcZ
zEI)o36V|4eW2yo@_iszsHppF6dL$Jh@_d5mxIvTYZB5}N***wpHOIXt$?N=#zAA0O
zp_daPF>m=<74(rlYVCi)B=({5JWstI>>D&cDLZ-6m_pU$fSJ|*DdorO^>FD{lpCGF
z63_kg_V8(6(Bcez4C?E*F+?AMrP`ElLYe$TWD%k!yqws5Q*n_{&Pp&`sqEM{rk(_t
z(>j5QsS2C&+o3w&WE<N3$_e&mou;V3MmfuzWFp&e-h)&$1K~J27IFR`qRD|2o|Fge
zzYP*1`dV%AkbOz#4i0={C#-Jhc46PKX%ie*;K;66w<uXVA}GiW@})Gz=sue?16)6F
zhGOWOwHgAkpp9f|gaRzF9p@3~p{HjiJ-I*=JR7Q4k>n&l5sfv0UH0*KBz`v|ptPov
zqK7Hvk57)up52nBDdAlk-)d%vS+d~|@+ReoWb$Cwc;i7p!n&U{XNM`Rg1Iz?x}b><
z7`C)N+#SG*E3o1%Pl+OB|Mdq{sTAtv6hP2BD7vsEm3ZAI%b%G73<GDyHkIlV)wRx<
zFf!524m8aC)Er0nwX!e(k^sr($DC<s{c{<F%c<r7kNCC0>Ed$6+#S_`OncIRte#)2
zGV*)9vh&HZtvGE#z=1VCAE=oB!dw_!NMT$BoLA;i3WpIN$j&GTka&H6B{PjktUDjb
zFS<L8JJUM`CC8q_Fpt5sgdKJVk*8}Mk)V|}?MJkTg^I@X+;G5=YD(+4#cSwq!jBh?
z#w}VedE19FP5~25Ee*3nH0iV<#4KL)(L2k;FG5!e#n3m(7#a1|l&4t+x>Z7SbM8Gx
z8OO#a(@8KE)SHl(I#-uFc(LrqT^WEnz&^`0-$04be=5w%mi9OvvD#GP2y>f6ckyvb
zyQ<M*6YrdL5i-Wa28_|=yw&)Sk;Un0s&BfjfNa3zKIrL97mLJAAQt}X)YKyS5TjGH
zH#H=Nlr@@{$X(gClw;i7XSirIYVwP{oA!{84XZ>o-Cr)FVkl!1|L(KIF>BN^UQ<6q
zv2%o4t^Eq4D9iF-w@!8|udr)>^8BrILk1H#ikEOh<YxF4bO@}ko<uaSD*G7P38+Mh
z_pcK1O(N&K-PieiGQQqVF90}<VCYT!VgTWC@x)H}X!OHz+J!Gy9XQZIo42#RKLJXK
zxEV*E5?zx82_e(_MU~HMnY&84l^h{^(!^x4->N<naO|<xX`d8RR)DMs=%i@Z>c_&f
zOp5?=$QCk&GB4z%bBn!lI&LKEiTFdOasXByCjsDr;8bC3=+*~4Kom9yAFS9-eG%e%
zZx|G0M6FUB;#iADTtmt29wZG!?i$ZQ9nr#*b+;(znKC@f<?iS^#_xHiL9Vxd8`u64
z&^~$A59IXyP@T{Ls;h5Rbb~s^b2l^CmHXCQ7i>cfGwy~CrGWFXXvz-YLC@M!5S-Va
z_Y>!hHPXOAzM9`45S}y?D|O10RzVL@MKA51TUQK2h-6AXr`N_9qVV_yg?Khi7;A7*
zm2E5|O7D1Q;kFKG1o8y;CsF2miXDwU032k^n*?4hP6?dmr05xhs%`a0J68Yf%3njG
z2~KY3xaj?I61D{nJoU_buNSNP{msO$Dr2KEJ0|0ogEp@0dSUj^pDu5Xtz1NOl4~iG
zN?7QA3ZB1_T!}o)%65aHY^v|`)%~!$9Q>axp2EO;U;;2l0PJvPN;=StpLvOVO)I2!
z&l9J>vCKZuTyH^YDnpcwebL(YLH!z{z1iSHlve-3fD>`|${~<~o~G3qEatkbjK9s+
zp7ro~nlQja3AZl8Qh}<Dq-KCtJN*QHnzou?xQq(g|3CY+FzXl!Zes%Dq{I^l`3<6O
z$gL}W_D-M@sZ+Hx8{yEbKm;kUf2zQ=uchu-!)2<!B}xTFZI1Jv=PF#;ju8d5gQ9+i
zRkf)D<I!VCmKz@wMlS$T==y<eq`Zl)!c^%DL+N!O`m?~KR5NI0WAx7j)rM%PD7dS*
zyadRROs>TE6!PO6EhMa}D12+Eq;zd?i9e%98fbwplI-;bxD8y3X3{}to!0J4ik(Qe
ziiZzs&AEB6@nxwLY!#hAW`)pGy!<~R(rKQ8Qx0%{K2Y)?Azp#Mbsu91N#y>S^c!mu
z;M_2VXfQko?#u3JQOX&}7Xw}_Tzx}3v)8>c0F8d^$Dom$<-s#WjlJ}}OGYyzMY>OM
z^%2h*2I2;IdBFH43WRgg(<#*nXaf!z0%7=^0Pu8`SC6o@l~1{h7GDK5TZ}=n+I1J4
zMCqoD%GRW#H(-7g0|xjRnk;xdxtwCSyj^uw92d@k!Dg1Gn^>pA4A;Keaa7eSCNHkQ
zNKq#hHdh@mt@=!p8|CJ-HnWC9A0HS|JGm-d`fL?Sgg{;;H)fw!=UX5`M<JxBw!1BS
zXGSpY4tr*M=)>4D%HmvRHvm8mxy05|t{QV3pLfH~$WQV{<Q%)6xEy|~PYG^>r93R=
zKs_gMB^uo5kZewF?xM)##E!V2&_!G+r#09qoe<fUpWD1xl9dr?>?J_*o+I)^YUlG=
zG@Zpu)XMig0?sz7sCGi{<u8F+?)fL~L)oifrHg+wLML!EnC~z@AX-V=UZ)2XYkGy-
zN1ZVaviT5j6yZt&D>6jIB3srFEbN<66@Tf+FR=`nf&pCDP{WAr0@@Hat`hR^Cw}tp
zkEi5WWanFIZX>~iP(>&iEQj%tAwfg?FfLUCwlmQ7HSEPgZzhr7uxd)cJlnb{-Sboh
zcDP{Awt0YJaE~f~n-^KB5(Nm(pspn`;Q9gh4`k{d>hQw?EL><?t4!|_YCsGWnW5g2
zkbCY9qA?C76}9m;;XoPsw7kNN-_?>wl|z*)YU~hD;4TX3ac3K&ebjyiH$&5Z=I<Vw
zSEh}}eO8bcM5&<ur8Qig$oZN`)&}dd+3ukRlC0H`7VD)__kpgtEY-SRe7&ptMq;ht
z;(d6AumOBlxEqyWqT(uSM!`Zf6)-<Sc46+cB;hq8pM^daOjhl^>0e*c1+Ry50pwpj
zq2{4dmoB`Dt!|3@zWobiF_=x^i#6KZ-W1&u&xVCmhqlaagL^jF!S@$LByTv3;y1*=
z1n~@J2WR&K*l=^{WW7L_*|VGm6l<?8>x~{*!+#|}x>XSEp=)rGEOnGxkhQfw_)|Fu
zUFxqOA;Zosmdo7V2na0H1zLHAPq%fmL~}wr63T~=kLaT~r!ln)hB^<OV>U&s!0pD`
zZCB`rl<zf!I@D_xq^{C1sFLfyakgCI<ZTBdCD*f8Kbp*EQDnjBs7>|cfec4W3K&E~
zH+zBjQKE5VsTSKp&&CThTl7%5bnqE0mg}DB+$1mqKl~nLs7<cF_%r#3)d3yRv?gFb
zQ?&D)Ewp$Z1FBCUerK3;GqG>S$S-+Y9fY@Ud>4vVi@w=;^K9L)rd|m-rHd4j?XeNg
zYYP!Pd1esinRa)FiiE`R^s#U!bJxnJ{@?zwIC~@uY1ivX#W;M~tFVeRW*cHU6#Y-=
z>RQR{(?sVkI=!e|jzY8ILXRx2Hxg-s2Ih9ghZyhIWPJ{@slpb~2i;(Gd(WLC@Cxt~
z-!D#2-`tiIG=y2BdsS<R$Xz8gd=nVz=}}ri+*2&t6D5X}ez^x{Jqya;`sF1&xB-iE
z7xv~QQR&llm9Oj|99M=Lspzz9rFj~}>BY$w4D$$6B$$>ed8)^PZUqA#VyEr&r<9A0
zEQCdX>2D2Hm}A8OM*~#C<eG8|ym69p#_3J*##5^CTnr5N@saT>lv}GLSD4rJ!BqL^
z%36S39E};%r$3VtLtX(>vhC=edd{WA-+(l@aea7lQ%=_s^-Bs2e2Ury1skM3);P(p
z;~~q^#7_m=<GN>*zhWb>7tMS~;ChI9_2C}OZ@Y=PH+K|XQ~>R|Jl?+jSUy$nN#Qzj
z)ZMoyY2C4-ex=7hCgS+Co@SH805k9>seVKl9T}Iw1$BFD#A<2OT)ky*R;NSur>HLf
z6n!Tj`I>lCF*mk+l*cjLjfo~rr&*a*I#5nU*3cY)|BC3J0se~EdaLZ-Jm;)%|JE{J
zHTW2vsAQ%pq+3RJ9mAre`XxqZpoYZa=llgZ8P%V#fRuTD=XZtP0z0El$@QshLAZMo
zFpbe8j7|&Vz&a_+hafDo5?B0lM4+-)`$VxpT^s8ULVbW25uu>=pF32HVW4`z@7ncD
zx5vA82QqC<z6$H?FLKN|!qoF1m+a|w^KJPtWbsKRDhFha|LnKx#PsLfGnk}9qr_;p
z)DDzVrZ4X}B@Q7W@?<$wG7q0X<q{>#@I#b)2OXx_bVB;ZrL*JLqkdC#byR!_sHz@_
zND=SLc^7w{y|i>LR~K!tOLid)M(jMKb}C7xXZfai9zI6&3AEfYh0`w^zJe<z0i#Q!
zMiCGx&)P-$#R4bfBW*DEMG0Tp^yeKY71YUqK7vZco8m6?d~qEcLMtqfY2l>yaN*k2
zG9*}p4E2MxxwkS)TGs6RbH~$i?BNDloR|mKhFQft_ZefY^BmM8p2%@II&WOcx=}w(
zuIO#yVB%640`H%82g|$3FR61c5BfLXcPk0)I7KQPg4O@aQ1;}r0mwB-sit)qsf)Hz
z`-KTFUa|NWBjl_EOgqDzs}EiNNEc7vU0?-jJg^GFpD^2~r&ZgMPpeauZJiF7k-iMQ
z-Q%Hx;jaL0SVQ_|PpJLa*oe06dG&jP-MqC@xzWZvMC^6VbdKkQg2WJolY=5%wm0~X
z{ic@Yj1FhyLToYz+)rrX+-4{P8v)v<nap;e5{nnMy;a*j)p|>u?>_SPI|j+!41I}w
zshGY0D&?Djzf(B`FgIe2Agth4pZdKndzRd+KK+(86>}$x0K);B8>h=811PQ#uL}Gc
zOLr!p<iUW217<kW2DqvmrE<z1#~O?o@#00XQ71-6-|7_@`6#T@k+-)(YItHkh52bC
z{xD$*ifd2=S`(H4P=F=U>f<VX4j|u(hbAA%7Zz-yAm2AAZ``FSBd;l#3%7_fG)D=+
z+KwhR6hL*lsERzcrMV^gE#N1mIpQ?zMw@E!qnj<|Z5HG<O2)z3dqqi$5wRJf{PteG
zmA#vo_O)8PaPD`o<GWZ>LMS_6G+VQ)Umr4ZsKMh&w{S5vPgnAzsv^t)Qtbt~w9G_O
z1g|U|p)vAm(QUfa4#>T$W#1MjA^o_gZMiQMk4X5YTL_V?Ip#+}=@&eSdj*eS;BJ#V
zgp5tRnW2gL6a6;G<c^TUZ6dWFC-rAD)WCeuhSq(Hv?w?#QK#k3c*pcK>h%@Hw@V0Q
zsw`0`xEQKs7XzQQ?E`al+lryR4tt<FuG-VF@n&}bF7TnDpf~fgJ~moLI@%F!oIF-*
zn8WZ``aZq#F9Am{%2Cu~E5AohVCRd_3ksM>CV)+p?8W*#yFOT^^<o9Nw|E5C^rlc{
zW`t&|w-;TO_dzMTGQrgG9~-eWpzyhcB~vi-{K9RRfx1;Eb2eb2NN_x&pUXZ@dkmA>
zBhRD6UBz<f-nESbosjwqLY!Hx!hb}}Iy}&57-%gWs9E;e!pu%kUO6Yy^aRowHd<NU
zlcNuX4z`0oY5rD7y}_|{F#CGk`cME&MO6P27cZW(xLNVm0uL?68H+KBQ>2gD<kG9@
zf()V^9mQWW!rws#ikFa>UGyIeG2`*ivP=a<Fno$N``{x7ch%OH#(uNrYtlw~O_dWx
z*Ds4_woER$U-P$O^cs%)=hmGSY8C$YZ8z840s2Y5xB!HiqX%GXLl={_%CATYBW!YJ
zxSk^>;IW=c8~v4B6c>^|m`$Ab4bZ`BD`KEZeTdRVPj08D3xpxMC}Hc%j$dgTBlcAr
zuP61d%Vabb#CaxFj7s`eH0qSSJFG?a@eDohTwq<L*fa??%{yPu;P$HLHW7dk2zaDe
zS4t|vAPk?&_Cbrtb?6DPZW9!-z90sn_wnQk63N;diOyY<rLK1beYw?lYZ0YuOlmeE
zQU*|eCF)ckzX6&dfuN%Yd~bGdg78bl&HD~3_Oj&YUu#i)Pg>{tQxWrZ-$Ud~*ft0v
zt58%pR+FpP9?&X~l!X?x=0-Gx(w0Y?LQ-}aQHnUFRYrpbKs7<Vg-Vio$Vf74L-X!{
z8rnfosl$+M?@$ye1+45{DL=y39Aq1(<phqn#}Q7lY%a0pvZMPz)fgYKivhDSpj$)h
zlpbF8oEX;Prl(LN=XKpRAu?Cd3-FgNKX9_XAUo6qlDbMk*9vyL>e&}>=fjtlyaY27
zU!8uWy$!r4J1+cJ4x;e3_<reK`&YG04f@QmX#0#^$>3ooq;DDUM`3dxnAVHd69SKg
z!SBN%9th{4Wr<tJeRu5&$ctSOU~F%uZVoFnX8?LsvufAL!r=E>SQteuzKvQBK1xAi
zBm|s01|PIc9zoXNXdczHJ&g8^KzMJl2XC-+_ML$POzSrsHA&lNfHN_h7=kK5#bKz{
zvI40~J34HL+xtg8z5&oaotT6>WXF_Yrv5KJguJ30V=;pCZJgKg>_#;CZ2vfca%GO5
zVzQHHttBU)JHQS9g*-q2SXJ&9q!K-<WzFiK6$9c{g%1NSdt|^!Z+fklY4@xMiSnJ%
z=e2e8sv$8MkQ6|8x26!-Jb3BhNs#|kBYfhG#9wK>+gR4~>ewe7W)VRb@Nu3tt>JX4
z*@$Zj0!LqrRl5iwo8qQ$VVIWqK~Wqv*K!q5J(q>Adu3u>zADHK)CyXxKnU@LKcc)6
zRu}c(0GEo`QQs1z@z&I<<>tqEYB+r)ts}mj-76l9`|^_J^X(hFPkc*}#d%B`XL~Rt
zw_}W{e=#-}5u@ZW%AMfdKlICjyW5f4;>;;(Vm}|Do8%gV*_{or+Ua@!ai+_0uvL~}
zbbt<m#0;H#`{%+3aC>^x_ow6ij$%58hn(h<2B9N5ldN)nLL<uAydpz_&5v10ljOUU
ztcg<yqw(z}q|ZVAgTW<u`f1lt?wQSVYrowOQ9$ECGRR-2_S1r0wHQ^_i72<9T`LV=
zV)>}gVdhezXbZ#GYAv7q6_ys(Yjnm1j#;|=JE^x|6OQEWt9qhJ%sEEoYVESF&spU}
zHmlaG66KdgJ0Whrlg@crbNI7tKbFkplp47DeR7{XtK&CZV$Gfyvl{eG_QMsg&~@eA
z&ZbZazm1bET3nn5@XCHM`wrWP4dY~P@N_HUnP_4+9C#STb~dxFHwVbY12K%e-f0A`
zF5GL9B;U`5X@LfREIW&sADNLO>;TX4%zjNbNO)Mx+quZOG{FStz~FsYXhM<0FE8PR
zl3kGgSx#!D_(6td6R%W4c$GD9An0nIgz8y3|K@yLi>BsVow3-()lDVG9%Qp1-~kM?
zeiQo2BxjXeLEZgs!JdOSaXT4<ROIZhn?O&-Sag6nmXlLAe_w`vzq49ed8ZCWsiRyC
zHJ>XMZ?Wq<pS|sj(FDvmc{sOrOX<6n;fhEXK#wJnc0janumD`|=epy%ndHk*#DmE7
zcnhTzKDC&BVbt71)v323h!16#$AwM*{+Q}-IvwV=f`HVKp^je*#qbp|OQ<AI_O@r9
z-{wuQ?8II9k$32)4)-_bBNm5LOPPaA=fr)hJj<E>1e+;^$gqL}>~!{j|DW;0hTEa&
zDVT5G&?RgD8;C;30-e9aUFb&=|GRjXu_4@JDw!)%=<aZrAc$H^!v0gl61;Xg^bSbS
z1+G@YT+xsi0p0oT*E!7k{|t{^b^S0S($3gL4ez#*n7e1vj|Y+?`qsmZSfTQg6%c!(
zc}>dKaf_w?Bque*bboY)Zn4_GB#(TH%wl-9a&RRlJ|39;i|}#FZ{!qw#;LILV^y^q
zed~7?f}uI1i@SW*Is5Tl%ASfb(F=!IK3d1FXGT5Tkb`l}f#AzuN%Ps&R2`c#0|qZh
z>t)xyGs6H@bg;E<zywoJZX&N`*PObZcjC@o0%b4O9v~;W6ENh&0=8iVlC+1xa|d=>
zf(6DkbtC-8j1%%JTHwMlcI;gw@MV{;qPbNk`d5Ys_*}D187MO_;_bb%Pcs=<V)d5I
z5b@o{Z{_d5`Ks8!8*9<@_R`%4*eEu3LT8gn{dGrp_YQ|xU82dIG-kgk8ODp)3Y!_~
zK6Cxj$G!d$m^4LIwa9TXycnY(&&b&Y0`{0qlr@ad+v}kPm3MYET=d_Z1iwS72}(Cq
zLdU)H(x{55^XmH~;!$B#_}%*mljO}|<$WTY*DAquhk3{cKo}@LpUZ)3<<jgH9*#m|
zVj_5wE@C3BCIWDI4bc{*Hsqf!N(@tB$+zT;AF5M;Kv7?>b7=f1=hL#mmV9-MXng%h
zKW~_-r1@PqZ3zl!(qIpazQY>FdJNTc1#IzB<Vhrne%Z*VEC|_N8k;d=4D@N9Wy9Pa
zEfA1LQp@JwnJI%1jC_Q(;<W_7v8wuCH6~FC;4BP+C^fD%*N!^h%N3_McdJH|DfXr|
zz+Zs+kAeluvg_jj{TA{NrAHY`4{DL+cmI2rqhFkTt(}wm0<&>-5b^!x>-icQR6Vgr
z*r*634e68=kK&WiNjlh%B~|4BT4sjiJ28cMt>mdC)Mg+_EM;QYr2VG5ru6e&mOV`E
z757g_QLm1FP`s-WN#H8to}uq}5D;0R1|;Q<wo|S5tgQ8vcHL1(W|}%O_cS%NI!gK?
z(3bXMAGzujQ#%o;Pwqx5*2cW*j^R@R65a4zIUr~+2pwG@r{da1P?FKP(ed6%ifo_6
zu4>REq}|s!Y(%gCKz%FL4&P`PxvgwKs^7x7Gs(IC$J#`Hw)8=fswW+Cn!jyI83RlB
z<D6x!)w4E230`3s`4Z(72gF!n`yGdXn&U{*vDOElvcXd|A4A&G5J7&Tl?C6PiS2he
znRDe5L$fppj&JBD7{yE8j$gjAOsUND#VYa!2#6}`ld=`eHs&+@9SqruOdDrQ&hdJI
z{-gTLw<6N?ja=F%pw5GA<I1ITI2V6w+5-c?+yXXCGAc*%>5u<J`C_>_0kh+#QXycj
zW!|KZahH<3#p`?p4PV?X;gs8#6T9#sW7x`vkFO|Q5MaO^C`CLp>3@yb+SAZ<R_kor
z4--?pVh6k_wuM|Y+DP5ectl>V;piW@In?{WnKtLE9(fS`NxLe`UxCL1;2qdMOyrlB
zk=Rhs3BS^&fT8$0pYY`*Q+l(6$eHOx7Go=uM^xtZZhZhdMvIYOJDHmhET6o0sQX}W
z^cG;Z%GtOU+OR#uX~J97so88sT)>){X0&H7by#lw;+7#&euj<j^X{DX;^sW(#xWJ3
ztIXdk3jBJ`RXE0>N=C)IX0}gGuhA5~({1f~wqz9Z(&;V{LEqAKijHFDH6KlI;Zl)S
z)ZtSh9ifz6MNW)rA4hL>%R?K(JoMa$T{qR9lJ^by4XV-G1V5z<ESPXdr4Fw&&>>{`
z_+w@Ekwm-o@`g5}RlWC2UAps_3?lLj9H)84jEx{9LMmog;mcO5I$S3EWhGapCFxc}
z6z{XP1kO$QXfwoig5U4xj)++zJ(^<!0N+V@N9p`YE`htE(mUzP)z&l6vPR2N@ovGh
znK8=gvk)!ef@<Teh46@+nv2$_yIOmJ!MlN9T_(0@hcMsYr&V)&ZBv=$E}Iu7BJ&*X
z%<AaS&`t1Pv8D1rsHPV8Xg?-|<mkR4FYkOVIHF&?U=W;gK+4l#I|nU{MAP*}z|}0Z
z%<r*CArP#DZC7<P!dI01{22oTqqT{1oe4Y_zsu<(`#wzKEB6j9Ku#)H5z*sml7d4?
zw~%5|?OOmbGmr^Py3dW-2{eW!4dNZjJJvc0-w|_S#4$mGS&G2KVUu1#7PTT$Y+}?6
z9)#7egpJ^jsrz2hoBXupWk^A~VDmtgZCqee)TBMqvJVYH#1!fttPb{O(A!d_PaV8!
z)5!=P{zN!D9oGG!dHZPRU0=`qr<kihR5H8Q{wk{FJlW+J3F-N0-<!0iCjt4T+Q_P4
zo8k`=^6_8dfmxU_RA8GYvR-h7_O#Qz?aV3{l6uT$LJ>KeF<aTvuM3%Dbk$^FTH#N|
zl9!x1?Pfr>S&O2VZ5>?eHNd#Pp4uko;9nlaDrL7=ay`p5)HcU@>DJo&#bZzQX7`;o
zQAUVWql6wpgaN)+W(G^F^vI?1tx_V_)OeR(G|V-st^1jLhQu|aw)Rft1TKS#Y3X%R
zA44>!x!TP<JFOj=n^$hGe3Uhf>!uA8$&j@^pujdO!ncS{$VYS5;nEsXBn6BU#Jjhi
z2nM$S`7OixInJBMec*K?j`{d2IT8aP46$^tD5PuX81|SxX+>=XkZE8oBH)RjI32C1
zo7`SJpvxlCQz%0Lb|>tPrpIQsSJ{VgrY=I}siIHI5?)Zx3p&yEQ#YeszOu7aX)AnJ
zL58fKHk(|V!AMm7oRb9g)cY^@-`zsktuZb|b&D5*0PGo(dxRcg<1bbt5@VZ;J349U
zHMiQ}!Xx!)MfCVdyXcg6w|Bd4ShT5<EEI!O#If>;Ewe}JIfP{&{JxOEFoe9Aveu_j
zJKtGYKCaDghyi$6eY&@mkTd)`=R3>t1Cl*GyLqKo#N^`p5L}7_AmR%MQ{QjwL701M
z;25tWq;pulxCi>2swD~~n?I~Lu1=G~L_~g@rzq_?p+Po;AB7;By1}Cq7b)l}f^C53
zHHO=T^u~kBUYgp7tFZ&xW34*_C@Q4Rntkw3jE{hn&_zcS%h^#>>GBloH3;~5N1OX~
z4N6~Y3Eos``up$>l$%5HjD(M%pDHzpCWT@P$vSsU^vI7wl8u8~zRq`VMN^&Q9?0a@
zvNTc&5Gn2v!t&O1#V<lmmJVV7^6P6c(yQF{;j8?{bDDm?`exgKAx6wi`D#Fw8RHD2
zdphNIcoI$A98PzS0cbESNtS}3^e%JIeaebzdxz#+Emefw=p8r@R}bWB<1#VC%^qin
zWO{27&}uO;2$&M425AINN8dT8Fg;Wrbrs=3#b21kKSl84dUs)KL}c0H80{0aI1JX>
z<NC%5ned3YOOX2d*)NmX_^fv!>5(f=pzRutx}pl@W-^kxDc8<UkI6x?8Y8+VG7=X<
zo~9CddWIpvO<1xJ1*HHN1tIt#e~B>k(v};IQiF^Cc1#cQD|o3tHv+T13H?LZ6=O_^
z0o&*)mPR4~sIUnI8c=}8J!S_^5-UT<9a?^W#2jeaI)uM|h}~~dD6;eAGuozJ9mS($
ztE<mPXb0|E=Th^Al;84#D0C_C4yE~h`#MwXG|`A+rK(d*->24{3>Z-i29xHmm2^E%
zlLEr&DRQ5~Dmb44F?nuNDd*-1s5CpDK4ti8?L@R5OBBJ)0V^y&CCETCw<l3K4bzx>
zm_V1?3i0CseJ`SO|K~!N0fe3PdqS(<Vtk3OOpZ?a(zTw`1ckU&55Tbcw$+br%@#xg
zkTz-Y^J8m^RYFY&20ot#!3t20+#{XgD%GLA`#-Y<MM<=GAbCSL{|S{QOT2Rec~8%r
z<=mr(>pz0FhZ;aN_o(&A>>>KW8^lx5O6|1?n57B>o*P8VqDi>KJ!-espM_pXWx{GV
zzlOkLdzx|{-!#UYX309RJ7;x)_%l<7A1gmV8&R(xNK!RPtJ2GgGIIHUR;1NPaNfO)
ztcVGCwDJj@jySB4W_BzCOt;0z0-3Ua?Q$`^_qu1kFxvi>VIZ~D76xkTH2FSsLXxl5
zlXx55w|kL!0E-8`HwnzUl2*!7805?r_czZPO>T%hZEI;x<BF7b3?ZYaH)-6cf*Ok*
zff?5!>n*V<4AtowSBqKX&#!vcROmB}t`uj?@8$l-^CqlGK@&uLQ5+lnp2^*v^g6Jr
zUBYy<#K`cW5yEH|_^Sz*I@pLBziz*Em|s0P0E7J94XgYti~$PENRD=d%!H6-7yeL^
zEkn~K8BDWsSKV=;ynzKxV!<H_EB4*P&kYmbNH?FbJ~c7e1iN~b#0-X<Vh9%<cjJZp
zJIFQPc65HlG;W|Y4tJv?G2*Yg`FLx{3G*ZpRy;}T6C<OTNd3Cl3lGQ|Z;`yXSEp(K
z?YVMMK%msyoinM^q9PkUlF~uMump6|5QoD&uOtQhG_IB^0W*c?7I7^##xtFy5(SdS
z*B>Ns2O=q+JIJti<j3kO3cRp1cpq?s0tw~7Lqp!CLu0&Wr{B7wG=H3P5_Xq-NoC?0
zc5xtW(XFnIZIIW!j@7FK1$#7-isjna_U~xxmM40aP$m*WBnpOIzFLem$Fu0-UY4dY
zYvDDxaMD6?HCKE4t6)Y{j05z*Yv6HOar6IoZo^xdBXhmh-hE&A5p4>ztbp}RmZ=>&
zNNPOfL$<{l{Bb<WeF=Zm%(Tzr4`b`OZz>ObLCY0KAzK)@i|Hgt%5$X2%3C&V8_R$R
zW1lCT9wFl|D8{XgYR)JYl@8V$4~IFz9wVuBJJCPc!wK9>r(%$E6@MM4_>e1tLGeiO
zE)&dh<TE=<7w!i>k-6hNs{qfXCz9W<WLz!XEfdA?ZeNqPByU_I-nPIPIQA6mp&1^x
ze})vBS6NRg!X-8Z`N=KPl}vvj1U-N+Sz3rO%Sd{JA5*!_<b_q$y)@>2{;;5ka0?Ab
zQaJqF`{pWGy5iy&dWK!qk|>Rp>ipMgRZe6Sfg?FaNh|JbcyG^Ngkm8>FM`4_p?{wl
z=b!aehcubwmK7@4{M73isA#-Nhrp=Sr#$s)@{avUs)?^87WIM1_WHkG#Q1w#M$tPc
zvXbbg=;0;=gbOQvnC$)IIuEf)ST7IbkR25Nm~;#%H=O6bkevR5O?m|l(J%mUFfxUl
zpLyh<$1XwQHY1y`1IIn)*s`?-bx|B<`Pw%jX+1H4VFwFa^Kl5u2!6F@CS-J93j*@o
z3M~O<a2H>F0s%7RLKu7lOpFwyGc=msxaB!3K>|`{cMebE|M#0qm5BS!I-aq5f34&*
z4OTJnZU7|DS4c=Ck!MxQ04+e$zhfv%7fx0$Vs8^1@~tKVR=jbLwe+O<5TNt`rRRX#
zCnAX<v;=R^O)T&v8pDti)mjDV&G9My>7SyWc~C3etJYoiBGr8~*NjfttlABvS`!j}
z<hrNNXCpMHOp(m<__cFvjhe%h?BCh)2-Jt0=S`{`505@kkBM;Q8dnz_2yL~tc|qNT
zWQE&%2^bs+)7=g`T~|#~<-S=w?YkKxLybT$?7A^QXXs^)j@eU2`wd+d-6gV0P`%)x
zrVel~OQ>Y|t6L;bgrm~|<2DeU63{%`KX>M0?RyAoOzP69;_p~z`JGM<C^Rh#-%V|3
zZcaAWqehn|s`Dnxdq2^)G&2OUC<w9}gAK?k8J9|%WTy-V#yxtmU!fn|zyjsI>vg$u
zN=?Ji#9Ru~?2KB->LIf5foZT9&aP8kWYo#7c8?`cMZhqqPxNz{mbJo|UG8I+X5ZVh
zW+gdGU%F(X?C+WK;t7HD@Sw&e7Q_t#-bt5@+vxkt06>&_`?w~PREp?_NSa_<c0YEP
z#Zybm23d-1IbgnEFXy2z7_NveRyAd%!fkx;z%RKYg=CwH6E0}STzFzh`K15C@5h?(
z2-i|o6Lw^)GM3$n*3j^t8Jon_wbZDa0~RM?`5P0wLz^BhyQfRSuMhaHtRdz<s)FER
z60Q17tFZ|Ml4u6Z7bAw#4-*VEgkN1LS{NiiWXYaXic(SV<>Sba?X-c8DH{*+R6D$p
z&3YbX3|RU%F1fFrs|s_VtB3<afv~01od`tMi54KxIHA>^rnP5psd69BJT=+2n_G&Z
zp%suWLUho$AXFcrbdt$n5%_H1gGji-oie4zeQ49i6d??^S$STWZN*LQaIGC&ZSUdh
z!lanBbK_QtdaGB~TVE$6E=RciV$qTzt3;yd%!Torq*RxaNZb1EHZI?0H5@(1;Y4pv
zVJ|UJUCbNbVm*ueArV0uyBQc&l^210r*;+0J=EZ(E2b)}F#f5FIHi-zv$Pik%4cr8
z_4j``dP?g*SNsp3mcu<Y%WwiummzxH#My~|9TdyH0G#3IN;R&v`)^#-NUhM$JWsBA
zNB4na&lcd=HFAkV{KQ~E*xhW{3-lPJ>_Z2e)C2>V1DMhM%U15WsG2SVASvL)`R>>j
zmpUGvMb@n(73wa_eT)8VG7bzja}>2T(ky?fsq^(0Zco9V^((y|<X;%B6u9AY;xf&s
zxMFRd4}qJn9?^KpfUu7${7ecb)eRid2z7lSJ!_hTjgBr*SxLNZ?a4)#R(r!qcvCZ(
z08l7@Ja;j@B(p(1j~4qOnAoofWwLufrYp78Jqvn3K?lg|&c4_yMx^q9ntt8Xkv|;t
zQ)ABIOBuTRpwN5+>+6o-DeU0>AJa#;$%8;9f3N+FPLLB?T8tFT3&9;0+e1OIuV%?q
zqw<DGhvP65RKFfO_Y%sM{*C_jr^p*s;G)yG%6+V%2;C~JFEll1BUueS%J*QDtogW=
z35nr<!k3#;P(D9ilI)wPpAXg}Yuae6D+$N&G0KummzVV(buEcpSF_Pc=aephcK1?5
z19VHZ>^z0h%QhI2wMGDU3&`-D`OpLj<=>aXv=}8+<kn%oZ69o&{4Y}O%q=bZhmT`F
zw8mbnY;-27@Q0gTVhi@+CNmCD>vaF2gfbwMv&5vLqBQq_?!yG`2E|`;TLP5Hca`|W
z5xXn7ZlF7K`>&^6Ukm!VFH;&iY^^OQf%^*I`<^1?9g?;t@*65MQdAq1@4BS&I2ucG
z8`uFBxe3qlLKMEsN)NWQfxb`K)-KL!DK|uwi$ys}aee?6h&;uCk0z`p^rRpAQi1+6
z9o`(4Uw=iwv|ee2s(_8uYuQyQ{$*=`ww$-jhiIVH6#=hxG?+ed;}+;A5b3i9!LeT8
zUJb*752xBP<F+{t0H`eP2_k(Az+KTEnKs~<T-H%=yb4GVu%q%}a|S64mC66;4Vm)W
zuCgP?Lb1u7uoZN=tQBi*^=`6`nf35>N%LtN{_@l)_d)3xf#_kBJ)n=Ja;Z=9MQe&#
zpb6{JMfvFO$&W;ciGO<0<Q(93_TS<ibFRJ`_f)?pXP&Dlua+^5WoU&RiABW4H4$K>
z>@~+a=TlU^N9c}~@V>VSxPTMT;B3^7x89^r+b%xW!dl1wB~)q@+5BXa%l->DK-g3j
zCd5dbUHVt8jQ;I!Z#%%aR9GX(KOHXvIijqQK<-cv`oKO>f{hKNu~}5|Ftu3U`5U3*
zX?z^nwl6SeAT8J)tP#aYpkApv6eu$Ju!8<{LVAqEa!Y^=8NVby=8HuBD5M&um-a;Y
zAt5*ATim8VWZvti3{*PQ+o&&I#$OdB;3%U1TLpvF%G=1#!1&{1Q}ee{WqQp&un7@b
z;KRmjB&nytnKBoI!2CPSiEZ{LNdfwx-<JvB|4MR$|6EGN^#ApCOjgy*aEv4RC%c96
z2BZy-Q6H$SO;XN2q-AzI=~dc&m1NQ;hT-um1vAVq1WcR~Ke`O5;^DECuZV4Y{O2jR
z*m?gC&Vv!w6q?ayahK_b5Pl6$v*9q5!|4U+L>;d3tLmt?&n;R|7w<RP&gDI$W<R(5
z`@52tDq(ZLk0x<^d7Vt5X+TlCE|9q5aybn@t3U<Dxewa_BbD0ZofQAa`n?!xVseWE
z8mQ>}4AH>3#?4S<P5oyA%zYLJ-?LgwW;a7T_wf#;IjhY2)Z)(gD`eJ6*kThug56ao
zBnyt0(Kjo319*t;%o>KvvglXy=rOPF_+f(j3;vrE)#7I-DX3l<yr1CKv+wDDG<8G<
z<h@EYAnq-wU$#bwK+V=3O20~qIJi0qIzZ_Fwk_&5f72QynsrP&7=B=wXR|&Y3*?X_
z$Wd^M{+pzq(#;=;lM}$LghE~Gd;g0M2nhQ}U|e#^E@-~trth=c#XVbmmB9IO1AH##
z*uh?W#{Bq1ld-p_-mB5!kv6dL{U#Z0*X=?}1uigRymnK@n+tlbzh<|6!pxFyJS!s9
zgk_nVfZZC}Mt9(WWX>b*FJ|dihg~#uIlf4DOZ$wVWjP_|3~7$=5i5*#5ASS+^t{&~
zg`S+>N5BlnEkv^)M*dF2CT27*7o3xi_=r5Sp1XoSSow5VK1Q3sN+<#DNzRk4aH`r!
z*Ikv>c6}nX&nRA?HjG9o(KXd6W9>t4JRP|=h@k9$r{TRCAs&lygjBr1GAR@7HmqV3
z%P()Ku}aaZ?+<NO(^TVGbD*Yp@=>hmt~H2?aW~PWL;)uF41R%S<L>2`SwB~Fwwb_J
zpDM8jo?iU;ViLTBS*WF^p0)UCKg?lW48mq_&SoH%|4h3_6>s=by13Cdj$lcY@QmJB
zg>_$nlGz(AqEYz$*RV>I`FkV3@Y<~yU3p;{1~uOBJ8Zxn#d$BQ9i%7ufDLWvC7KfN
z2Tu`<@Wu`GEc8lqvNHmAd8h~%>!h>Xq$@peg}}we{oT>T-fn+GNUIcq&p6N@2tfqO
ziv)j|qH==SM&ba6l|VJKbVk#Il*82Q{sp3Par5M#U+nn4b8G$vUl>vDi~S>iUo=mU
zZ4Rn-=*Xrt&XDd6cZu6Bs@TeKH7H`vZe#+#iq#7N)YT$R-_EAD8C2XW3Umtql<U)M
zrJ8W8ddatf;<Hh#qucy64$(h!TQWl?#+M1g4fF}|05{?GVG7_n8v6ru?AhEQexWdH
z;o6J;fQ&m&zBW^DOcuy{s1%8nras>=|K`cD@sE4{z}l0<&9taFn*Vp7fPM;?)6L`I
z5gKAsP<JCO5#mWuh}pfIuJ4ORb)!DscQz8QKrRPfksSztv@1pWKWrKCe@-DyN@&2S
zTErJ$qCG%eFp-AiKs{7V-4nu`TXMf7j=T8eT*g|JEWzPDn`<HA!{r;I7uCn^!Yj!e
z+QP`Uhhwk1QZH22c)G(H%MR5{Z3avURQ_?VH|3kxtwXG;(<xvf=DqOz#%7Ql_kY`0
z9UZ3fN&x>rV6kad`tE>(l`BS|pwE6G)$1&1`FA96p(Jr1a!!Pf?bVbr`-4%iz4&bI
znhcj0ab7FM2essxzzSu~{7pfcl?j>eH9L9BT^hYMeypH;Tt<q+A$v^Vrv7!dJJ8UQ
z-b>#$3X!!y*w-0HJ3!zUQ5QfJ>h;lsUwce*z@6bzad>DpH*_85V->WEKj(xWY+zZJ
z-^)8a>MvWE%WVT!5W!d{uv;AAhjMH-3l<5eeakrjM);=v?(x?OfPBtJf*^ok6408(
zuusWwO=$PB`7XR<&mDtWrBdV_`Nbz3{J=uuTc(M8DcRtos8QOHV%9atiw)NiCh=@d
z$3YT*h6}Sa&5jvGRs(FV7Taqotg8hT$@k=?ysf4lf>~FehQc$I>XQ#FAaUTLrc-c<
zjz>rD{@z;CK6^Z)K?K*r<E1Enb$~oWZd0V!iWiS*l@_4~BFf&JlzOl5;7kM5Fdd(K
zDpm^6>2_9g<41;4>_45s^@+y<$7BJoHzCa}<ez=y4IXxgOJ6=Wac~adnyGJ=x6AEz
z9Er3C=$s7G#tlbBxV#Gx8&lh2r#8f*DeY7dw_^YUfuQ%#wyyRhc@cL!(!^m>H#*!G
zpcW$ZVKkXLtC4KQ=4}&e&H6L^XAy|dHT>=9ih@_cD$}Dwb5Ir3wLayw=nQty8ChEA
z2$3KtfG>N0utI?&NPqnyL{@SJ{MbFaN=`Mjj~CtUP?fb&o8Jn7oSXN$FlNvWy<mrr
zc)L)a|7F&us@|!Wd0c1$^H$ghb1UXwT{tGd^Yvw>X*r5`q{!4z5+P<0NqV;#tP1??
z2b+?4pN0+`Npams!`?OAJ%7i?oD~dt(mNvkc*Bm25|PzTA^8YlnCAPeKS^v%mv}Lm
zdrmtq^>r2`J(_t7#OmytT`tx#CJ>!0RpC@!>Ts3aRXI~2$5k1RALj|%=nf@vl|r@V
zD_|1TN98jLlh9b4!ou@WE}R_EMT+3aF*?IB>F9li*^{eiM1doOcE1m^I3QSg=odX<
zlmIS}+|gt}V`65rKHqyq+yV$%ub>z1#wbI|GrmqfRY))q??{QmFwlB$Wlk%j9VZUB
zD7LC}q`q>@5U0j7<tjMZ&(Y>he>1m&Jur}#Mn40>$B(!Y(#fdBY7kH($eM;vB55rU
z+oLn*N?1A(u5#4*(#*;x>`12W`nsq(l~7Ts3N$1aTTCKw^<Fw}2;%2vwPbdrvV&S|
zo>U97sgYS~KMq2Q?kWA-G#vIbL8iej9o6fl$WWXa*4p)hGR>IPe*UAdwbuMUL)yQi
z9S;N76Hk}!x4I}Ee-@uQM;z&7s>B4`DB%0%haI^nanmbn;e>>ObrSsOYE;<(9ytsL
z9mG<tpXxOP`?7rkDc_EJroIe`O3(~hC@FVx+zL=mTC1P%?7FeKWR$sFIqBhm&XfSt
z^r>_aO#YfNAUem|E+%v^!1DH6tX$`_*ApyaX~~r-39meb(OPLHCC>zS7sNbZe4s3^
zpB9IbtFzp`8<2!t{W$*QrSgx{m(b`zSDp5AfjhlHcs}fNd~e6)`oRbH{!app87i{|
z=SxpT?mRqRw1h^13ol=n;QGR|ueBb}LU%)otQ@N%WzL)uU=Re+)#v!=q;bS=nNhOt
zoC~VIC=di*7^|a$PVU+V6Nz3BAHMC^oC_Bdhzx~Tis`T&3k;f4ggZqKIKATWx#x(y
zctlHJXU1wX++eczOc_f~@K_#+$_n&8Lh*4!%SVp5WcF551AYd$a?b3azOW+t7Bdd=
zeIPAJ*KUPMQT(SzYXHe_t?Iu-y~O@yCEX5u7C3WQxNed6^l29klKOdlwXeP=+q^)b
zjcztC>3|WHkkN>?kySIvGK*8+$0i1S)$Bn&D<jPSnLZK#0eO^0(TnwyU0HdxtHU*I
zH-0{~U#@@PQ61^?J%blQ1|SObN&YI3L2!f5`iMx|)#Bbp2&JFs+7iXOzwFT~5^Mp7
z(=f@m$i!b}-iBH~nYZ27Q*Mz<`pii<%ejzPxFo8<Sr&_`dl1W1YuAkvDJ_!EY@Efd
zqfr|YWGcZUUg}#_#SW@Ah)FaLDb*dwlObHvO*r1qC!2vp!r;(1H584Z?Kvr!Y;5RK
ze0{`77gG35hAX4H*}Ba`0Dku*%kHD^bMFt0Jb&&syUy-Sbz5RB<i|KKJT*}Xn%gQh
zJd?TfxaER-r-di_Gs+)igiIzrQB3o5io31;LiL8xCstQfC1z@ns5+HXnWx%n{GO5H
zMdW5!PeRhwg4k@JQ-#nn-I|9zm5VP;G||_oEGs6J<denI-qhGw&hR&BDD2tHQ}4B|
z@A%Ufvxe$jw$0T<H$KGC6sH^bYLe}urJ=e%f~yHVL&9jRo$c_%G2#NO3>6#*eW>}>
zGEBp>r^MT03dD}ac-~fH9sRR=9g5!C*Zea5Z$7bGl_FXi4<wtaMNKQRYKdQH9!|ih
zu5lEQ3*PqXpQE5y{kX)HqWD>9skvQsftZTe8z!#JFuBP#^M-%r+gRt#Io$c^a5Eg3
zcF+qiDanoQ^HD}0*c?w6_PKR@1x}1}H&?@WB#ldP94(QU`O6rj3I=E!;k&NzH{rn_
z<7QsLPKxe?4-S%2+;*stUbK^eDWj^lFR2Dh;Rc~FtAK#bYx@UmO$ELnX6IPAK#nbx
zQtdlSbN#6pw>>=M$_@-|&^GNg35TD~+HEJsMAMsr*G-|6ZiNjQ&p_C6mK_xxhHl@B
zL>@*zxWyr!m3w8v1a1O~^o#w!=)sf+#htVqUVYv@xbxvRC*@as&>_wv$aH{dznuL1
zS2F3HAEH0f9Il(WSNx83deEO?p0flvNYcOR^GM#Zk~$`OM4Gv}vuheo!jI7<qwDv8
z!ps<ogUO!oiZ)no=+!`gX#Bbn{Pccl+8LA2ay>+d^0^4aycC%vH?*N)j@kWA9}T<+
zEb={yGmTRkYSQVN+cg~?w|kl}ui%L*^Qp%T&UNp_x60ii#?{5SRc?Jt;x4(=zRdiS
zJ{8BV2~hN@Elq@*FqoAj;v<Yo;!1-f_w`{vSdJsjDcg(Px6^7NUSe57u%dVr>0ho6
zjm|9tsH8j}j&<{z@Wm;l_W&Dfy*cNsqV4_nUNk8h4yQ@erOKN4v;$~ILEX#QjET@U
z&vPwRuWsJ{%v&!rMWDAm4s0)6lA0|W&1a8`&sA(nMk7f-(BT!{P<$n~9(OT}Zrii_
z-)>FLPFHCp6xPPYblnP->Kp$5y<ml)0~79AI(ivyQ16qzn_P$+5*APjT=XGr+N@yK
zvKNJ_)V40WR7n%z7rHrf7|)v{$E^FR6_`2pB~Jx(Xt)qMO)r!FFH^R7h}{@h>PUnY
z{n$xXA^&3DDu^YfTWNl!8vs@=@p?h;DRQ+*TcL{p{&2Dt^)SSheLZz2wv1!148<YI
zW9UL$+1K%PM$<QuB2kJ|d?Ei;@ChLK5H4@>Gz_Cs2T#L-^VJJ%f4d(0v4wKTVo@mC
z-{}i)G}m8AnwBXni^FW+PNjkJuJS?4rm6hiqEd~c_mz5W1g5L3U!~bO^oBOLn<Abf
zgLkqC2n)E!CY)mrd+shc=!h-uv6j+WHIoDlSg7h)P&fxHj2vp~zzAC;?E?8b2lAGs
zzFZk@&E=!=^dgH8#-<667@XU15Af0PY*Ep+M_oQPSzOIyI1F$XP}p&{r25;y-XMb&
z!(d5u(9~^{((aJdHz9NFq;C&uRx%nCL-!}t9DYLm0|Z$d$r=nW1$r!M-clI*NT3K{
zt%Fb%TK!k^y)>4pa`Za@h3M!ksq<2>shs)A0?6T+WlEfeSK_9jp<Faq?o8#f<Pxx6
z+|HF5Mu)ZC=!a!cM=QX1ZAjl9xyio$OCN@}WP-0B(e_|X!uj*SwX)PC4d3UL?U}PY
zFc%gYnu`hI=Y`$VDY5&l$^2+dw;_t5N}Z;kL3C@+V|oM#y%rVrb+yC^2ev7gaR*-#
z0{H8DdFOhOYJbSQ7o_uKo3oPjF?|NOK5^T>)M|+RtD8?~&_VF#j+!;Xu~e=d$otT|
zI&d^Fa!q-3?&AtuX@LOa&o#df;fgpmDe6D>etywf)K5PY>MJ)I-rHhb#;AUb5Ob38
z5wEJaIG}i3wY7{bIt#|9mfXr<)>VZ%mSRIYG0NpU>}mv-4m(@@Mfen_FU2}Y_Ok4$
zuy0%Dcx6uG9YEM8VFdBEcyl*wUV@}iu8YD4P;B6R=k}%CJ9P20+!eZ{*kocbdcl<c
zJWr77Md8zTV{yeqR5mDg3TzqTD1zGKd}F(UOIPnx&^ktv;jl-?97`YHeH&bA_8+vL
zjRr>$0umLt_@7e;PQqzK$RwWj;VPQU(H&m|O=`DJL2zCbkeAF}zyzm1SB;XQ(4aas
zA)2l%96Gha3hK*+y7^0#<Q&1+f=%GT2)55+IM%AO%Kq^NpiaPv8a=Vbgj2|YYhgwi
zP-UAsC>nOGI1aH~L`yl<m^P90x6zbH4NvrXPu#A}+Np5wbb3D7hQBw^8(<#lFq_=L
z7h>%1(z*5%OqoQ`+BDXL`3~Lw#cV2CbXfXjh}71qTN^X>Nm7LWQRw#zwk}M6N+S{&
zzMqmy1$TXGde3x1d(<^8#@d<_48hY2a)tJDs~pEyTZ186<raaP9nX@VBwP`loOOuH
zHkNX{q+m?qzV1@JIB?S5&iM27ts(5J23g<YXtp{mYKRqoyAC!v&YOspm*>IfzAw%U
zK+#b?2e7u_Pyu`|U9Kq&k}|&Gvbwb;l?Mg5FXu$>(f+3eZWpSpu4_hQcEe_LeS!^N
zz%3Lh=$-rUfyG0CU@Gp&n81HhV(%6UgA`y6|9vg~p(=O$oh-dvzOJkY1@f0bg&66L
zWeuonHTki+MS7G{F>GssDM<jpi#!5Knc9F!jL>w#X}}OyCYo-`zzq{?g&M?jm~YS+
z|2P^|Pqp7O{HAmB2et@(-Csms=;#1F+!)QVT}Cus$kP2qFBAMr`@Jg^GXHmGsJgn1
zqo>|6bbsVmI@OQQTs+Go*w^qKA+xSw9f^|XWl?Ecp#tRNq+3hw%+Y%w&&n)D<u}^u
z5(G=2YkOtthvE>mgLAtzJ>i!i93Ueae4)xb<45+$<(%(44PN&pW>CAT*12H_im9+b
zj$}Ndr!8uI%BZQY{eFmL?t59IEAH<WQEaR?G22s4nCMB?;0$$|N&|Y{-;w(S-KR{7
zx&G)QhD|zUZ&5X<Jj5ICd7KrVw|1_33X*l!YB)wTPnd^&*m?Ppe?c;<yh4?r;>d5y
zZ$0mBt(-be5jUN0=<g<OKT6zv>FzDMq$Ccb@eJpnsS70_B$?0c!wr#U+alc=Eyz`|
zBlGP`{Vn{yOegI8^Zk-ul1!X57o?)?=vZnc)g5@#slvB_yDuM_6_L%y=}p$*P#@iE
z8>2qEggv0p4F1p~dGBIo4tqDMA{%O5{!$$S)`>=LOHez;=W_qS02-=1+xaGDX90E&
z`!GEz&0g4o*}eUoQZUZ0!3Mlm^!~LG!k9*z*C#e0j1>8h<e<!D)!Ek?6QPgq>g^Z&
zeNb>GaHG|tc^t8}#@mI9w&7D1bQI|pvR=s?4XrNmQzf~FW&Ty`{&;3l<h$HuDV|ZY
zBlLdN6^=zIK;yhkY=SdiY1V;GWdKC@aO^L$nn*6X%$C$s#A6RcRwndl<hQtpZN=jU
zRn@3p5B_X`JCHz{AAcJkE6+EpNcSrI>3Y!0;g%||4M&Z|7!pS>K`Cntw`BQl{1M&N
zdz0|7LG6U3^&v;8j7h2?mDZoY{^=rPhuqrMv`#t`jV1A7@=GX@o0-`mRjQl(9!x9<
zIQKMkixsc4w;(G*E~TEI=!V~((>w3)`WGa3k3K&0a8H%UcKlQ~WOo_W_>-=%WT9@J
z`n|(OA4UCxu)<$#1C3QJ*ij#%<#e&YV_ncwE-jYpuDys($OrRro{y7;k3eT4Ei)dq
zj9C&$b^m2f`Wp_|XWFF8u~-%pMPon8{S^=NPKp%vFmlmurXxnv_0LLo>soO=565gJ
zY(Hs{C$tsJ-jE+7c{1UQ`Kw+5;HQK$Z?lsYUlM-px+nCd0S6$QDqo!pe$$FE^s(*x
z(s7U-_IBHK2arVPUyI)r?_Uow?3RMFTI2#&idMu6tJ>r4RqtxsS{4+MJjopw#O}z6
zS96PoNVI==;&JtSuMVJ#Jsu?A%(<6=sIN?V7+5#<#-}bM_>x`s5tLTkUn}wMeGl*A
z=W1JufWcEwlyCLyXL>&+R7HO*%+ZXrSU)AEpiM_xeqCdp9rpegCeI!-2KlB$9uIG#
z-kt}p5NbD@iQU}0ww=fXD5QS4p@u#~7P(g^=vuRY6CZyd7vML6sxakC9C|2!vm%@?
zqMd}DiDr!8oi8(!&0G%{@4m$=^@VYtfedzZUDpQmIA{Rl=G7Q9pjB@j2T{0%u#23q
zrMLUdw_BbwyKtUEQgqEBD8)+8vK7$WUilLLCt|U!?lIq26Jez;B#EtoCg~P~8XD_4
z3_BgD83+~d!37;yrxqwDxSo_{HGgK*lSCWxgt@P>O08~7%ghP0vd>y!GWue@Ef#F(
znbrnvcR+DlMi_5tjPZJTBdnnY`_yw8#$<ZgC>h^k)&V=K8c+UQ@Sl2D+_IOx4udfp
z<8%{uywbs|N;wvhHFjYtY57vWa6EvFC-)i{ua?RxGa5okGnQbSe#u&1^>O*@lY>F!
zQgQg3EXhVeV8i3sAowM-)LQ1{mVHh{)lNmk9QKE=({hVA={zRsNHLPg%0v9wq*Y%v
zm9~&QEx@6)5Nx>CeIBiR(O0tkZ4c8jj(^y=Wb>v|6i1U>PyF{00+*4amhZcqVa2ts
zek|dAXmeo8XwjYNRif6M>Qs~rk{*BrUf*2VC>7V%?^pA*^7}XJJ?fo5`HiG6M!025
zGBhZqtQd*XB&qJS+@*==vHrrBHwj2CCwgb#VgDj`8XFJCK0kI#QjuA|8XX;QRRltC
z7G%h?*W-Nt7!}W!dkgjryEn7wKq0o1&;<AOrnb$)i>QBm@M(#Utm#POJlH6!TS#`3
zd%>PN&P-6dHrbb>_)a#Tu6%8H>igo)D!5{3AO`BgAjnRN9S6e+1aN^2Ky=(v37I^7
z5g55)P#B5qh#2oh=AcewjozaI9;1^0>~0OB>%}UEy7lfFbo8LIjD6SC2WZm@MVeJZ
zl^TsP<YoOiY}Y&$j@Z}vY>OoUA?jGE@T^tBwmKCu`HQ$pXDQgDroOdXBJ|5r561a0
zR)!PxR#piA57|SrDtQXEc2)m_?sc~+Mk{OZ!TbB$6NG~5-a7W4J$YXUI$v5wcF+hc
zmLOsYym=NNv-b-j?{&BRb{Kwo26Xf=2dI*4A%?*l?+{x+zEEDev4F@7Q9@Sw#6y4X
zBbtMvm|_*8w;Kb}-Ay!UY;zW#hH_)H@s5erW1`J?gHRUfmTb%a9^b4i0WFLIIJ>0o
zBKIs+IDAG<GkaRW6`GqoI~wzpP;{6LA4Q&q6f9q?^Onb*PoT*e9T;xv#6sv03nD5Q
zN}TF-&qS2x;zrV7N}BLch!945%8-Wy%Nqa!Ilf--hArBK8Dtli=pX9U!np=0icU}z
zSCw>rlj$9u&Q~wr;)X;zj_QwKi0ZN+rEv+Gg*GfL%G&9>oxZ9RhtV%``~pBo{`8Zq
zy6=A)`vT<QKbGor<vAR7D;~)>2`3!8A-B?on=#=Za}D-PQ{NaGcYCl?D82zubLU%u
zdKQj`hx&K~*iPNOs|_;!4nc7ulfatWL2KJ(C2Qt+Yt!km<j5b2#htiFA%dFCOoc@~
z2a#3}AOlh=F2g0cPu_l`{m-^wKE{PWT7XnmAlkvh{1eYpk1Ugi0~iY<1@BlD<kgwj
z`0F8vmE+@kTi>tHO@I}-fGpCS!q9y&U@Ph`BUQ|ADxE#+Ylefn+6jva_{HsARW3t2
zb4-c?GbVTZPL?i=+5*4|VIc%#(1Y}*O=<Q@@gD*ahv#KBz72N|$;mKXiF65vRE51K
zYz(~3dLIMc+?XeE^3i6koPb?K)+?tpgGdzaJw?I#av`8Rikz(@5`j$cLF+PAn$fzC
zPgBE1=_INuV?H&)m#3*+;*<UR)|)};&y**^olbN>zvk*96#J$n__GyiDV9wjx*3Xr
zikRk5@*4i8@jzEEOeND^dx;|Su1H|89px%|MU%rmVrf`|?Ytdc-=30CkT7-T;<H7;
z*%VU*J+V(aTBC*CC<=cO6S6AiMD_T~^RbKCx&;Vum7$#nF+3g?G1qbT6@S<Jen#95
zJb*UZ@m$|YH~4Gmz4QAR>2+$7zME9XTg|RTqfC<Ozk{o4@~l<Ed=044p-)o-c&;F7
z(*g{b>qX;HN#o-%#2-(o!t9Z}Foa)!q$LLGR(715RO*SOlav?8Fi7<&2B(Yd$8`+_
zOvNef11}*Lt9M)3LE)*etqSPI>rCjcrCa>;0TuD9pn@C^E4WKykaQFwr{6fr{~=@<
zYttPDW1yK<Mdxs7GDc~Pcg=aCRvx*QUr+AJF6=^9chuO&0%HWt<M>%LMHtR~qFERJ
zB;zHjkIbIaI7hR;`P<!OAt$AY2zfK}THEv27e^I*Q}vrMVn}LIE#R*x9vqxC2Tkpo
zhL!U~GGRzvg_<?4FjtsKT9lGe)Ed=$caT6X)AHk1tD$TF9!o8F-mT4+_|gSt2i*nU
z6z_Q2oe->~Z(Hn%AljaT-Dkv<amK>(bBO?wH!_4Isv&d9aRnrFVk|eHj}6}aogh`;
zR7;yo)TrhJMEQ8&h*A_V_M1X%g#*?-ce+1}j`Hp#NJlfiRq`@c#x+>8=h_k^-a^Cl
zd$zG_(-QH&+59wMwh{NF_lFwUh{bt;eYQCbbou3~%aeMvTW0{oLDEdgr~;V9;`w0=
z_kW6c+L(BW&qAp*rsx7QkzY!qfYD~ziJIH(wL2+?r48>fV<#oLJj-PB=U@zv*7m!;
zA`@CBAhvkD-uQlxHWJ$VlU-%BdPiU41avXl`!<W_P+@ed!b<q=d@={GfKL|VqpUj_
zZEVMeh1bzZr>MPBdQCrvtNZO0I_+|lwFy_wz_P`tvPo{+#yQpKw;VPYb78>c8XKl|
z%~0ehWgr1NLhh!(&iHZywRsxRb|r4=c<2BHKp`IoSor2gfbz-HwpLw=nebPC`7cok
zR#cOmt+9@~J{JDT3sEd<9-WxeOIy(hY`=)L47sM7MF8zB^k8$x*3CD%Q7KsvI`zaE
zc`3l3{gSW`ao;wBB^F+dpjr|Uy(<H_@SRJ!m@aL9p)0k8zda1Kap)qIkbvkpr`dHA
z6vYbU#32;;jy@tbcr6~ts5$pcgK=I<{+pPO`=8P115xL(268SwnV`p1ZMEFpF7fgC
zns=GuDNZP)1RA?{YV%km!9hQu8E$sbc;7;_l&m!W6W!;9v@+MC?_-D%QuqZbvg+>;
z381@rUBeOdaE-2AxZye<Tr>4+K!Gpm@ztXoGf=mP7d?Bt$v}w51wvTy*>0!u8a~4*
zflvf*c)U+oywGK1XO?|h?P=3e3*)zWdagGHxhI-lK$7OgTtHgz_98I5;>yyMXnQ;V
zWp8DMfH4L;?C_@nLbdrS_XbGl1WIHq8k0|B@i&;qTuz-+7BM=^l?cCP%G{Kc7)>>$
zyQ=;>Rf>W}x%#hf<vlBlwSG%(-@c|MdN!Vb<j_Y}mdpQ#hwJ0ya@rdFd3L&_wjGbX
zS)m@IjEUsAW!B{lh?47eMoZ?H`A3bZrFIWh{Kywfl@X$Ha8i+7=)!*W9w$x$$^$({
z8TvLdB1T~?to(ZUkKx~}<B861%Dv)ua_uX=h(A|S_0CFvEr!~r(sN$rteSW;P)oDh
z-juai@U7yl!HVV+P>5Ml9fl3c*|)61aC)23KnweMD&1b2)3K|55X-V{XyP)OnYvvP
zcOh2vQt#i<zarR6`Iknz4LVdITvVIrm6SqRVlMy~xcKU9)OGX-%Xqr+d@7&ApGrN9
zuI$Lx+A2k@MtY`#rH(cZ2Eb4IUfYO43KYa@2HtCcH_ZcX^$WB74Ipm+Xu2x&GC<Ux
zh8G8-eg%4g>F&{Mc~zLfcrEr!kA#Ox?VQTW_X|OqJH3KwB)5&0<@9^!T8|QcO}Evm
ztZxAu^adKwEGQU3iF5n)R^9w2B=Fj=sGrG%DgpfpmFn^FzctrSJA5qkX0p-`nKj@L
zvR|~|zP&g@IrgS<6%eCl;37ak$m;5=Hv_;K*`K%++U71A<CXyGY5#|>CYuOnN1SJs
zLOdsp;F#t(QjiVrbHKrl)%ih4JboDx{8Cp>AS!f5V9U$k+$$oJNq#nSL#5S}G2j6Z
zj_0EBZCcLfZ8?fiqQ@?X1`@BCm~Kuw(tvRFoJn%d&ui6LCn%5yt2~4VFQp)juNjRu
zm#|gRE?!3JoD3d<vSv>W6IxnHH%AedkZN)*tZ@_QJ{c&CcOI(V=p{?;Cs){agrPf!
z^hQYm(7<u)Z9XWsBhNw%oie&HjO61{avUMmVBW;NnnAqSTQZQyP+-MJ8}`w;p!Qfw
z&v4EX-GvJ;5@=P`N6`4ifa%QVlOK+%;lKrhP5q?p1&_U|rzN{dya7J_c_+_#qpu*F
z^Fuizp@Blu70i>LdvyweQKSlD$D5<&jzW3*#XLnrh5-l#pbVi|6ba(X;a2DNc|~cN
z18@}boK-q6wjF5E_Y5qUoG9ifpHbRpxIv-#vRT-&Q|`*EeSW$rSo0Fv(Nglq>-#w2
zGam!9BgKV>LVGj)Y4Yf3p3{ubzQOG)Ee4?WPz@EAzqrOKz(Z7o!S}6OD<iuyZ{wLn
zaX1#4i5FUB%jX}8ZF^)v#=N{PSn74Ne_;Y;m`;mMB@~?t`?#z2ovufhN_DXK`krJ1
z>%shYEod|o;j%dmwuj_pcadx~VBW{a8W(-ir`aaXeW{njt%9V}sq#CfW8G%>W#nZb
zEJxfYQZ*1?5H1r_>_47J_64z7-s)|6T{TAg8r|0VK0N}B^DVBcp0~VgxV<Gqlxe=<
ztMBG4+Bg0{6`o^K%R)?|LTr;yH_Q}wBpW*6YW?BXC3{p>OXq24LR@qMtqwD>&?R$q
z>Not9hJHC#{GNmY*s_6i2z;hps#uG15uTqt+RTG?&J(DTx`TcZ;N1q)HxX8ie50so
z4tcL6^cA#~_i8#mcbErZPl~ZH^roE@*i;~yQ@r}U=0KKtoa?U^b&<o>WJ{F$x&{k@
z4^nMnAW#Y6E8Sq=G~v7mqoGHb-RBUwsosB^*h~-#*RR5hyE(XDRhR)?&EFpZ;7SuY
zI5^OqH81(=OltpV<Q)2YNi{Edx%g71SuG8uo;Gs+nYtFJLGo~i)^`H2t&YOso>9*J
z9=Th)BcCXDkXmlFh2Z3~QEsJUfK(Xe4>7B0HNa7_O~U<KK;HGr2A~GO52iSGz}uHy
zmg<ixy5#(HXzw+lb`?5MH%h7#&;bYH`)Dz~|1M5mSAdC7CMdLyb!Um>G5w!5kY=C;
zS^%E9uw?Py^)D{a0ZBH+Ba#GqZL^Wi1Td|TaV|9=n9MJtc=`S`*f4tf#$Xh|F#I@Z
z9`@4u*rcO5Ol?v3?4@DPM}RNaFm$97-D>SL<sQc+F2+duUke8NNfh%ADo8AcvJ#lh
z*f$boy<)UnCh0-CDv9tutIeJDUP;7-9eZhhMPuoA^eyU>yy#$F!UgaJ+##IJdh}6i
z{8-vOVS$ec%$a?CdQdr~s!NZj)yn#{c{C@=isq74h@B~2w*!@1O4TbN;L+`EgDJKz
z8rS07G0))_O?lI<t21J%VrS^!T6)F#2&`h3E!Vx~Fk|M2E@#+unz0W<fH@d97`v`4
z&6$nVq4;`V5zy*a*_8G5M}rhG31uV27HY0QOGuj-Jx41-?YNZ@95uOZ%UkBjqmgxp
zU)W`sZ7}<eEChk~(DB@Gmh7Oll2mW{g)v@i&;a7Pejp5pxAQa(R-k1cj%^%6)pv^d
zEobLB9bK@cs-8l;+(bYi4Iw)-d<?s3(AFRN38*^ORyvpd7tTvUe6HKqcZ~WOe1*?v
zNS*)r8ah@UiwFq<piiNwqui<e%Y-;xc%ZW1X~a<=hnHtXkgfOPgHAe~VhoPAneqV6
z&c!OM?F-5`X|p!>xq+`ZfV7F&rzAJ%bqj94_$4*?^2zvQv5MPtb30Qm23RNxi%KjR
zsBzWU={$*%QDZ(4^9p~$Qm+#yp)6zjXPkGN6c5_X3Xw}c0G}5D9tVRi*y|;}lJ!fq
zwC+{hxZ!s*qBb@0^xJ$wLhgKGGfd0PEW!m8#BKvyRx@A$Uy?k}IJ$X`a;mn2guquH
z?Mb9gghK5_f|g8}4Ge!XmG#Bu@j!tnng@u;MHinbkWP2)6B;C;5-xm#yhvWNTlKyY
z*b8b{ZNja>qi2I;*+pbySv8u*FsNi$arstTsBS%s`TJLPvEW}becBmB+=S<c%#%Oh
zVSjqH2g7;>L}^FL5^Gfyy7GlHPc_bRnQ(yfAlF);rEk2`riRx~rz-Y#iIOmZEGT3+
zY%#knM3CTBuy>eN!#cqREJ=DTLb(?;9;MfgxZ>=cey@7UK|uQrWhxlkaA*plUKaDi
z@(wVDs|jxy971}6BxAwIXR%>#qK{4wQ=6RQ61D5bEwMjm<F0wK{v_vdAGnk5F<x#v
zJ{y&fV44{3NHAK4q%z$xWJ03~|0P(=M%^_r^L&#cBuUDx8m8RzP4r^!7$e|vE(IhO
zutGQlYd$QWKLbw`H#o25pshuy2a0FY9GAUzhLF(Pk&#m@09aYXl%~w7rYaMxM&D4C
zmDp-!zhzvh_Uc3~6l<<bs>BI`g<u`9*|bdLU?k;!Gb|+6#%i5S(vGvJ%sNEnX*F2S
zeybM>G7m5AmhtQ3&z6Xzx6~3rW3X50syec|JgIa4r&cOBZq-lF+59f?EsOWw#b)>E
z1;$Yd{0}+7PDZs+IMKj_3_I?--b;>E#Xn&L8dvAJ81hm79<|Ay-gvKmMW=@AJt}J-
zSrX%%bNC}ZBG8(1&GXv;c(ew$E+zqM!eMsAZLCB2vDJM7)7%_3(Mv1c`*d|A{;7CA
zjR`rc0W@_hAUo`mzS7bRox<1o(ci7x;y&;Uf+aZJc&doX=eyC3#1~NILh}1zH{`Xw
zK<WpIh}hbA(Lf@@qO9odK<`l5s<C?AXx48Zy8~~9RgDz!ej%9)=1Xw&ro@5f`Zn<@
zfj;)FA9UXM|9DU5*sdA+oEd`vrbq367o^sJ?W5t#p$DCkmwz*Dnh$N7bV<yD7gCX|
z61jk+vLm7~c?5fAX5|rnGIKN+oTn_KuR$2?nul8l5lYA9X7M_;Y8m51RVq|?oVA}=
zl$5oT8?PDe{8o{eY`}rQ?+UqyY=_mmG!xNiwJ9_Ktz@;WiIGS}3r+`Eg(jN`__1uc
z<i`_|1C{#^EuFh<_3H%6m0_qbhR5&iWULvHf7k|2HjOC?F}t$07075JG!<_~z#|ja
zMesn;x@rgipcQW)rJjdUd90l;gMS8LH?43&iJE&Q9p?8Du0Db5>%h3HY7IzbNH&Gn
zv`vBr!0*Qc09j-M2xGedW~$XFO7P%`Nppb~;J%!tSe6Y9cu9TOB}SvBlqhPeOix|O
zQl*D&)?<x0pm2+%=a7M*4a6dFF+Pz~6<$AL*`eGPE$i$@Z1im<89sDqGW0OcwJ|B^
zSiF)Un<daxTfZIqRH<GRdAMN;cMt5E?ce9b$!u7M<Ni`(2fik!NN@nP#z(ET^L<D!
ztWuMv<9vXf`jNeCjI4aM@K2b@L%R2h&`8N0-71GIZ@5>;tYB-Ws6;6Fyx$FIudduM
zOFp)DVeH;7;#)hn5{i|UA^ct1EM}Gq3vzl5&ZIhf&YZN(x}j3%rOBIlys}0tqREFB
z^Cbzgz1V@sQxY6RYQ(Tn@t0`4_o!!z(pEov8>n;CFFSh&0nMw4PHR8AxNiyvQ-1MZ
zy7NOZ$6{cfb>=L4adinqqjsnqKF&<=S}H3_QGx4A#q(c{b3Z%sDaEVw9Ijgz&>7FT
zMSG`xZuo*~SFMG<N8>b#D=ZO%q^hv1l(<_4t^AO;!aoF?&sff^zZaLcl5g{zk=oW6
z-an%SK>X+7B8@EDAebUJ6OIP0RQSc2IQY0AY6@tn4%aNZy{GDeqjLwY-hHO+@2nBx
z<&iIMcyiF8yOa-}J~CTe^x&?|X65OQ1r@Yp_{6PP2R0<z*)+APjTm0q-n1pfSqvA|
zx}rm{t?WE?Sm2lqm(hc=el6W1-eYEyUF)11EtV+XE`CrPkcrw6ymF0-XK{ta=4Edy
zpcse$faC{K`{Xpp=t6tbFT!R37;F?4A$Ys7-A}|YYL8gE>!Tvq?Up;f{SNmtC;{02
zmXfy;eG~r&8;~`xM>=5#(NM++qj2gPg8NutETg8uTR8=)Y^MGX&jcvTkk|bfyP{Su
z;<GWX{*~Qx&)}~|QUPu4g}T~o$W!~tmEq4LU)jrE^!9>m5~%eoPE}8E_Js;zXz5i0
zDyo!Qsb<LG!VahKlvJg40W}<kuWbD@P|kB<{r9+fCSUCDT|Dmwn*YuGA?06hrR!AT
z_EMoqRrja%RI0EnX!)hZRwt8QXONn-na~m5Qs{Pb`M|_F?yFYELDzAp)|+GV=T7JU
zS<59$_fu4cigrffXQg_T6Umd_8^qO+Iy7yiyNQm8RQ-de{RJGX|8s?UtEYoVT$Hy(
zw^%MH(lolb*(KWN-)%tN)_i+2|2cXHhx0p4zZ4C^|Ee!(QCRYRqoc@?#re~dX)0BA
zIQ{g>*i8yx&k#Ct*t}<EuC1<0;pgyG%lnB!?VB?3wjD+gjWbxNZ?3!nN$EuJ<qfB_
zmB8L0PtM^tYMVm76mJjZg3tmA%8@K1L@((rqe&xv8&d}m93OcX<fWSuA*3pTP?yq%
z=_<(D@2xH9{Q$lI6Szt+9}ut|Tp&~cC&!woDS3RWuircu{g_wq;9~y6NdTeTp{^md
z(Tw8spr$KX%C0bpMF)$%RIJQ4Oudx$1VMxK@N-s&{#~C%ckDeFQBM*bHN*CIE0}K*
zs<N%pS}@Bh0G{gzns5Siw@7N;vaSA)Xc3MR7g{cD{Gfp`Jl_V67g>;f{7L)1B@%2N
z!G~iaB|SCg<2^7YCpTt}&g#<^Tbt`%-e?p;!KpEwpTVo5op>SkpvNIUrpq&ZfX`2>
zi)a9kTqb`{d!5AK8}T<@M*xc$tuq-k2O3`(VJ{bO%(Y%7o@c7ZvYSWk&tj&+McUP_
z-^b|2ZYMFM!{OXnNzq3}S5n9o@<`L%h6KRF;?A9?E`R(R%U}Cvw%ah`3Jp9Meu-NA
zKDHM`QGqYrUQC0fUx^_e)l062lBQY-l5Tyu1f7JP5(cvygMKDS@QNDWar(sVVx%TG
zey;ncuEejqB*W5V*@^$E7nOnapHIOCh)JNr#%Uwj@hoN7Y*<%j8<|D`DZcOV9wsN0
z4S{ZES^jMB+0I>M0plWlkgj#$;&X<-ces#p>PVnFp#|$6gX`@G?|m{ob2dl+(EXnA
z>;mkhkF(4qRtz^-OyyWGR_wll+B%^Io;y0h3bp;cSYsvJjk?LaU7_#XW>k9W^Vif2
z*8lZnVF7bYf%j66TF?CMXLLbzI2Qe!za)=0IW%YBymlL^9&^{_zg3B!`IU<u@Mc|c
zAW+Wr0>@EaLaK__ZPamWa8%7YmSaw*GYGk^<^&hc?q^f3O)<=D{prZ4BYHs~-5&)q
zom?>fIqiNFS_huYRO@g|3!&ZkfBG*Cr$tg*L~JYME~1pVJyG-9x<`8(xyjJ56WpyG
z0~@71R4=b9I2lQYD_|F{VLzN|chj~4@B9PhDU_p!p3hOGb$@CsLb~D4nqP~|r%}}l
z2bQXMnC?Xm_`-V1D0lb4tfxEUr05h=vd<LBk1Hb_mfqEMrMiRLg`N`*Y`zIxDhMC|
zmObZE+&qu#O;O*go`WMW;~2-5=%dM{K^$?L<y4764mWx43Zpx@@it;#2VYXR%8xAY
zM;;Mhn{-pS$_`Zu)$qS|iiC)**QvceXQ;sA5I0DmT=okIyb|H-N-I_XV}`@0Eby@b
zinI(M`zop!_|-kH-8%+xmIGxcJCP(h+Ry>nST#^h%h&=J==u`>2LibhP;BxGgaJ##
z+x(a^MDDR?KCp0V*2GYybQ%IBu?;OyH+wYH^xi+@yZTHm=H2yk3x78O6v%=ody1J4
ze^&;jX%@_3x_ux8bX4*}E6&E}%WIMhQk=%ry@<jR-lW_d=&R8R3`m{Hc#X|&e%FOi
z(P0_;u&w2&>mmYooWx54+wz?ROG}YZ#M7dYBJ^Mr-3}qq;?Qc7tspCJc2RO^>X8-t
zR1L&3Csu@hI@HqJWLAhQ=Inl8Ly-j+>{QS>a$?2U)ERqZ&_|V6HSL)KwoSn7l&w2u
z%u7g}ogybmcdQNA_^aiQdWacU4~B#SRHEb1qHcwUmBc`S<Ch;~0W~WbjxBM#2)>US
z3Ur+Eg)CI8HY5HD`Q7Oy2-v7(#)#H=j1=s=JqOfovZR`iJS20HN4>OWTj&$GB}f{(
zUhw?UO=F=<-oee)ntXR5B4}#EgFVU}BW%Zefvo|0m8R|XXJK?*Qozd}E}Z@^K+)@~
z^W29u(Pk&YZVO#N7=j_NTUNDO!iH%lEy)}&Vv=4JKhm~%S;IjD?>TQTXTCe`LAie6
zkioiKNG8agg4B3?XEYZ9*hbg=FP#pUBVWg3y=`?(J^<3mnzD<05LC<J?xrqm4?Bsi
zTsp^kD=5k{WT}YK?lA*rji;Q#!iIX_Mu@-7Fm7z%31`wWN&8&j%^Ru2|NWB)Y&3ka
zrZ4OhZU^>+;4je7A1FquZh|d=l{E-GEeBx}v1|nHEFdBwWIa~pBsHkYM@%-WN3(lR
z+NEBnPo6yDzVkllal3f_;#WLwLd{PlY90lF&<vK#HZNoZ>}jc{hJ`QytUu|R$T`{;
zyIBWB&#mCx%#t#Ya6)DbyIRI9r<z49^7zt#x93~7@_j{{aO@(5n%RISJgO(fk1~ZB
z)0aU5tV`)}_dsQnbNav9n743v+V+`VJ00mg54FYIRxZ%6lb|C5xy!S=A609OAi&4~
zQnr|^meR^n%hen~ECC|-I+jm-zhK+Ij|+!%SEBK#w5`P-o%P0ttCad}G9X*?snU)>
z6b6BMQeX<_<1DR<&R+T-sJCbRa8JSDdR-^xXVHA&Omi^?HIpP2BEF<=Poq!BM?g0S
zB?vyDX<AA}0BguiP4RG%QL3JdDr08fYU~4gdA$S!2Ttk?MW6wtmqy5URnTapjzKu&
zhk5X7KOvboz^y)c0QXpcI+n4#X#>fJ^bh<YZ3a6^!~XSU872rGj`zyRXbKw%pW}v^
z;?ascYANbbjpB#fjYZx3LWxUouKnw8dM2mWf<)`O{r9`<bIL&jA3S}E93J?C8us1E
ztTj*xCVwh8)^mb&RDlKT#|5$y!ixSb_>txB?T}saUNN7deJ>r~2v=x)6oNl%w`!c@
z`v)cc$=>fbtDG623Um5tN#LxkXPe9I(Lrxl^P~0Mlopz?$jkYePj87d76h)sQD^w4
zf%F<hb9j>XP33T8uU#3Iz|mzJtzXrAYMe+z`8%OvN;(DLe;pcd5E<?fN^SF#?bpGg
znmR!K?C2J~fO_|HXbQPQj<NtlK)k<{R5uVVUUSDT&&tHwB&++R?W#zFoRl4IOss)m
zL?)Wb1Aax-YRx6qO&V#)n)<dEIePSdIR>++1Qf;1Is0Auz+_JtNX*Z|lS>BNB@7O;
z5WL~}%r5^P=|n_}(%$BirOBV@xJYJC1Y4jN`=%PDF&F>~4Be!qK(%A$-lGAPVLH*R
zy_*BRf2S9lXN&xJ##U9W4_ZdoQ)O=xfwMqxsDh*PPKfX48^tv68g#;*H9T>q6vwtl
ze5@*)a_<)i`(xX1_kPQ9k0rH=!VvskwTI<{Q_dTIWo>RC1>8n$40?J&yQs1A8aaMr
zMn=+Sw$DRTOho_LfP@Gl?!zNxh(nAV01Q?1qsPNk9Qa^SCzqGs?4z!`<8NxD`P-i4
zV5dCRgnDi6msWpbR$PHsP1(kAbowQuYcJFSEIe5#{owQ0x)soME%y7qxzlSEVjg~v
z_Ksczb6CB*v*L5|Bu9r-50~rt(2(qn)+8)no*ZnYD|^!hZHGjU|2XMZtIvHVfRy~-
zx0qQQu;pL2BD|XP)&}MPA7y`kT=PfH@cpQ`VJKeP%ve|=$!m0|GsRNbP<o$D)($tl
zFdOwpY{57Qd}&lCoAq2))9%;M4}U2Wn#>B@q!UBN>USEH!IRVeT9jnv2CZxe1CS2d
zDu*A`(C{dLj7S^L%HTcDOqpYBCJhsG@0_C?O~QCw%}MbCYTZg#R2Tx=@vC;F`GC;B
z2-&T#d_@t|FDHdb@)cn!*eL^>o~ty?{p3>ct+xGTh1-7J7JfiYK08jR^!6r`BFi-C
zt!kaCO0}3d8?Ca*-)h)XzGdOg-FP${G7zvo640<GA$6m6;8krI-MCS0YDAWkO=<BL
zSjeW&bqvFG0>IC%Se=Av9)R0P=)xYbO0$ri>D&|quaIw<YcWdGdp)%Hcyht$K_B$D
z9c>h@(P5c$zYrRXpKew<n`#bsX6S*DCWlK#<<MFCem#5~bjN@JHKDgrlJ=A(H6U|V
zB>$ri&ekqqY6AH(qWv9?7E=LR7LD>kT?oARsJ_&Q8|9~!N#{f-faV2hHN$nH@HCl;
z!#Pqd>@8%W?BIxcZ!xy?R>Xrt+UQfatwMdB&AXB8VfP8^g1>qeXXgm^M($5UZ1D|e
z@sB5zh85|nW^r(f{rl#`u)bXLW4T>%LiLQ7nx|Z}M45f`&@9e+5H|+Rqk``?Rk3FZ
zyZzz9yG3lr$2vhy({67(1Ger3KIzVI3bCDNXZKsGi)X-uQ51$n6sWbaR~V(_52e7g
zD2CbNQBpTIWFJ)Fe0vMZcsMdZ0G|@UJJ(V>&&XJ-+B@JHGqn?=G!unj`u!HD`)v_l
z;<D^m-*V>dw&8Gbne6HRw)6f|Eyeb#btG<Ox1gxDQX0(3AH6?Yp7Y<Q1}XnwKjflM
zaF#d6E$i#1V8L4?{0piRkXbtT@9U8<rs12bPpCI^#*mLD8?@#7Ceh5-Tv@A5W+s73
z`~){iXNaB$b{2ZaiN-eWkMhk&Ct?R8dUAJmlf}|bi!F9O!fY=k=C)7%<<yRwTf}6s
z&OaXX$gcBNw1+dCkYas0DhH6Vo?_s$NKz@`2=q0rS97!|wz`lh)~U#PwozAt0X30?
za`Yexh18U5MqvH4t32?XmVR4=82zVmLuB&yCX>?TH-VPJ>5mX46ZOa5$+<0w5J&Ke
zvB@|Sb}okg`BP$CCFM#B@^Z1sgXDCDfb24noc(VZeX$<y5Btqu&cQs<^d_xnT)Wqg
z@jr-nagkzD1#Ra8Tr@|vjLu?rrKnr1vcsPEy%Pv&p9DpqLUo}KC_wU=FPxMT;;cGQ
zqSm8H^mDDUx4Q<w5RQfa%Et(^_QWYExY*2;D!tLYAi|1HCWt1MZLVe;hQ~gbKh>yI
z#0Gck#Zb?MLlwGK{|Ym*CDoa02ZiB+wd)QMv-2@1C#-8_-IJwmgpE8p7Dx2U?Q%<5
zk!dkkUq1WbNs~A75UNmF<qE6U>{)wI@AN~-&@qmwCR!ps6u`DYi2`NdW>>qu|FUNz
zYE%->iBlPih-Z*8jb>f2L2s}(%C%yW5S!xzAN8FIn40M8c@T99BG*&xOIXQ9IwGv2
zyCMJr;-!}V;)To}W!E!&-%23JI!VYwt+zcPF&|a|4jq1<f{uF5mcUJT5ER+{N1_}Q
zeLwWOr$6lK+BSKw!ZN75LFV$OD!`SfS6Ux$E}zKsC)In2yv-_UDQcDcwDO7cRx?i0
z^k$THr~OY$X2}4gVS&F1+DgkAUQO;V^S5`_`Yh>$4I*A^<ChjDy>DNKb(3>Dc}k}g
zXP{E#l^p}cAO;Au<v}z*Qm3=x*_Hf|Rb}MgMN|=~%cUAmc-dQO?z2jU6x|5aei%oE
z-9|0Xod(h&gkn{Z{C5qq=w@u-QPNBOHAZ6B|C{B5G|Isao^S(ukW7xAy{z7U#(IO!
zGbj|AD4n}Z@+1>3rsfLL)Lbv5L?#%%YpQ0Z3Y+Z~l%sjv@_d<cf(Eb(tFT(18{=G=
z;Q}VXR`_1(lm3+^C2p%VrtI~{hQ+hG0j)ZTW6U0Qd1=cznLo5Q25cBzY;X}JuxuI4
zQzzm|DTKj4!(CzA>uC&{uKMHvfWk3DU&njM?g|qnR*?pGS@xGJ2dzPvWYU^d{VrYi
zAr}>!*#K|s+BV^uEkJ5nyQDmG>}^x89_c5F8<wC+OG1=onBXFb=e#iqUBd7alBtT(
z=NE2aC~cLm<vwxnnU8!+8#Cg!_03tA=+4e#MxI_c19+3<<V=^#16;T}%gAQ7S~$41
zX#zCU#k%xb>95ic30{u|sgh<{xmm@FBa%hU2)4ur&}wBvz#PO?l<b<#hKGalmpP|9
z3>#wFU9SR+0HHz^224>SwTG^PIulmdiLk)g>QK%+Q)Dp=cmZ8mgFY$GSO#tcYua$5
z!`nkw*roMO1e&^3OW{v7{#5ANA(pQfJBFU6_}ov@u5dYY1hqI*V61$*MQH|lk^_IB
z28cRdD&H+s=?+K;(C}W<7k#`moUPpRjHv|4J`^(0;sXW)5Yl>|bo9)qv#Y5BS#kVn
z)s>rCO7z&B3STUwQ38SgrY6j2RPMPNf=265O;_D<0e(Sneld?dY$AFGSV#rkf<DZf
z#EyIo<d~UEJ<N}V{lpAup~itZY?tnGZ9n25j9pt-5C|CAruX>#TWCz<Mnm&F8+5H!
z&n2%hgKP}U^zqMWcyFJsCO@t?j@oXEDrFwxH;*58k{biFD9RJc59~?7Y0@vp@@Zy_
zxM7pE24B2eSNn@9MEuh9w~CnS<5MWjq~m1c`iTZr477ZMof{o<M|3Xug?cA?!lr#4
z6W4mjwc?}TyF#JhTk})`ywBx0zQ<NwkDs1E#6mEX-2lm(u5y`#Rz$3$A`3$tb1stA
zT(c|LJaRpq%<<#6(3TfsFR6r@o!9<x>*jy0WM_is4ff|^!L}_iN2g6syKLjhn1?#_
ztGOC~8rqX6udU6oeROhTf-VplN9CnB;bdwa_N2J>n1MF3<<wU@{a(Y_hJ=hNH}#5Y
zxo6wSE*2OtRp>z8KLHr^?w8CT5L<(r)So?{AW9xN9}Vhe4R^zCJA9%Z1Hp7$*~1&a
zucq~FaIxUOw7y(9T_bX6!s#yzsRn)E0IAPIE)Ggt;eYFXYaW77JaEn0S78D)=|eYU
z@>4}vO&UhOwzNhxCDUv7S=PYZK=y&AAvRln-fnGt7en;fkzQ>bR~aWZLk(fAUEeFD
z&vtKgS})ktk;t<+h-aQ#Nd#b>P5H1KA(-~|wAdDB=T{s$UEplv$`12x;}Fv8a!PP{
z{tvo^GcT&v8<vn6_yx%=Z^^hB7SE!g+l)!Kbxgm}E*F#ect{~v3dl#kCV20G5VH+D
zm7`O5BirT4Wtz2xgb&*5RvdsYtgTroL$P>j@&(F=ZvZz2sQ%gh#ww3W{|~1dnb4B#
zri$q^rOHve?npp2x}g0x{DK=gXuvc)x1<?~PN8ED%iYOQwxET(8P@q~E8yoajPXt)
zkeAn+)c8RVOdu+ANfIvBu`Q$NyuAqrI@>`pTTM_`1nzT)03-`ZmHJT}Wvdh-u+2z~
zeV;+jUv!4)ej6P;9|T|x--ZMMt_*P37A^9j(kDvcZpm>}`}SeB7e2cV8={L85+7P{
zx?Cdz0_mn}`#0QW7n;mh?2g0rzB0OP;D&H6^$ZQW-0`(LNoN0uB?m{oJoNj<YMDf`
zd@CT(@G^{6e38zLtt@&Kk}Yo638vk>Rz_m{8~l%hY?*<`qMer?y8k<HSs;kHp5Kdf
zRttZO>MK6;iS2?u&@_?A(40$(-fH6ho9m7a<_IS2_afNt)Qo#+<>irs(MwR=%Os(`
z_=BfTezE*^mX-|G{<+jpx_y|h`SCs$+bL3|b7~z1A3>(nE#$ZFV6|Sa{xZ1MkOea&
z{cTY)%ZerY@^;(lKWd%VpT}9*>1-LVv=h%Qsr9AH*gn^9<pH6}KDZ(B`Fql~vYZqd
z__3k22x~Q5C)!ro=n&c2LBXU=<%K9~yP*o9QixpCI#Nt>XpV*!ue2t)qD%k+e9d#V
zM7dPU(L{<gDDRXoqa(|d9e?ptyud6j<MX{ikdE4ge%?=DmV<;ez$*~*6_Yd95&S91
zJoc^a+6)mZ4kgP42hbw4bQAB%j=UgAGhk(Daqt61+0jh|+#o3G7GRJL_T=o52VuEM
zM3)tQD-`I{3fj;~Pg{LN*KLz49?ZJ2XFqUwZi2aCmh2}`|Bf7R$T5?ASG-Akf{&51
z12C)9Xs8SGZbg2YyIJd!B@*YfpdbENueP%k_%YrMq;*YmNfkA@r&vfAg3*<(Ys=Vv
z_Q~rp)L>39cX@mW0EM#Mw^`%FZ};VJjhtsjH>dhN$up)Uj;mjCfMoaQaS}$cQ(bd0
zdL|Pd=G~HZ?9p*8Q-i4n^;5aSt(?LOA-+<IGcB`!*&@RryB=D@V51}eoo35fp}5;1
z$Ock*E6865^S>l9DMznGe0N4^vWfMrXRX8+ik01;bh7vQdi6kB<4UvMGu1DDNp|0V
zE1nNIUv~K2CZKlt<hGdRRbaZcDykkB@u8zUerXS+>rd{g*YrcVY=jU4F6limda^Q*
zR3Ii+RW!Y?z%k1glT3+Q3`~T%Qrm?5VMyXS@F!G(60bcIl$YBIRCuW~N8Yd;!hT5Z
zM+gI_!x<HKN^%s3uLirp2^k-7H5>Tb#~F)JoQ1db>wgYtoD=7LaL_v>j8767gPG{_
zJ3^mG%ki3;QFN^yA4x0rt$;K?1rver%=-VK=YC}kf-Ag%166|yxC>S*9|^o>n+U}f
zDO)+M8;&sAO|wLgmX4T;Bz!#*dG{=oRXMi?AmNGE&m5rD=Y~PThhh#4$W?U3lFv0*
z>&d5l&x7mT;9t8jSkj53KQe(0(1hw2XIeEfW_Kx4k1-TNBg&;J9`O$5`C13GQ2G?{
zPMUf(&#X)hzA-D(lES#uimvqcy;${K<laW8oCj{r1wYvB(JBFX{U!Au!>1gDxf^C`
z-nh6>VQTzzT1^u0H`zK~Xp%i~^t&VbuG?8K(l(z7xCwLgubp&SruEt_G`cI88k}%<
zveqV<n(wR3v;=wP4uclFN*JQQ#>qdrjNlgnsP#8KgWSNfGfU2aNzWmZjc!^l-qpmI
zwGc)j2jQ1%%5BPTk7&295lof)`WZp~lNAD?43rqO|Grn`B}Jd-#lmw&U~+G{XYy=P
zV4v9|h9LcRq8!VCZF+7WvJ8C)B)>rFYfab`xk_~po!&mrk+F((c={YCk<9749w+;A
z#GusLA#DVxZ;G^?<fXw+bxfTPW|@hzX4cy3yfdy(TX46sPnbC3aRG$Jg{bI;U<a4^
zO{h|*YKVkhlpf-aFXC2{lPg+S_T<<)2F4dm5HbPJa*P1(-B_85Y~r|}tIccHslRau
z-`j=_E3@%NJHvE%qGG5?r<7s2{t*J&0D(q;9VBHJ6kgXk`y2o5Y55K&FsK*~f*42X
zC(#bNw0pqZA{2!-wah4tm-r@8wv@#Q5qR|b2isPrQp5z%JvBTr+k2n2%F(r!ssfG|
zHqO04Uy;gJIg?ZE8wd0vUH3&?dC9w2a!_S7nTd#asJm&i%kbUju9NgKXx|SAc21jt
zG*aLTD~@|lYl58Skj`kixV+Tvjpe^LrNA!zp(%a=fJt-MJ`4M7noZqAyw4Nd@>*4o
z1ZuP~KOGt)d-@<0E!N~I(rqFZ)}=|aA*QsGUbTVNLA1j}@Wegi8S#l3V96b^Tk<#T
zxfY2^`%0}~nZ@3NHW{_MP~S0>D17NLIYV>XsjrhDfAgpXoVaobOBtnZ-5?est7bl9
zhKdS_E~0;tpHdH1DLUJ4K=2H0$|K;}-U;QJE!sAeESw^jWgh-`Zx$r?1${P>xH3LA
zBW@Inbz23KJk{MOBf)&&Ea?^Gh>=T<lbm$pKH<Wr-6{s#CHgq!R2nNSpn6C!!3qgP
zAH$jv1oTaeXF3?U!orW5Qib9?O&rk1TgbQ7WaZQuG7vesufC9KFwgoXo)opJ5+v>+
z>a$m0@kD`20$lC3E+^w5PIZF}dLl<=J-pxHe!!Vx{?9W7GQw+e)j@R5Nh=!VtNTpa
z(dJT#-mPehVE;w-0P$^PO7#D9mZ<avW5_b@5v6MMe=>m}ySZcB%#dwrYcl#+v%Xvs
z@g`yjIm_EsuT>C!h3B0wZ_H@r-H-CAMDj`M`oBV(UpO6eF9*%i-?={JzkJq8io1IK
zewweJ9rz@>6EIio(i6P-aP4r(G&2>|D>sI9`RmN~KS0Y%2gU1T6x#N&z<L0Kr+r5$
zYsV@PC07ra!z%rIu<&2>TbYpi3>wZavPwgP2pQh47oO$#O>syT@4h2f>i3$y;A<Bj
zaqxNiYZ$)XBUFqSKI18=f;`wgaCCJ`0>!`6eEIKF{@!63YVOMrZXo}Z8m(Y~M;0;z
z<sZxIFt(d_u&aBzqpHw%^k(1}tG9qIYBT)sexk3>rEghjX67OqAC&cXHh`(Y*mgTg
z6?@BqKdPL{4A#~={Z92w+FY~X7O{NME)n7-Lb=5IY)UP>zU?zT^dR6wi3IRbdtQKa
zGH1Q_i;w9v<)e;dIb<=Q-G(6Uc0wM~<vbHvb6ii^Q*xQor=i%SAvcjJApv*p_6;JI
zk`=LtG}rn+eAj+DA4a@tNM`VTtek&vpaen73s_X$eZsYq%zE#gXRc;aQC*w7TvJ9<
z;U5v(n3Qx%5rG<UdBl)+;3><M<^U{<0KhrEf*GsAD4#+YGuFy?TY1pg3b(C=4uwqQ
z9ouUgu0s?+Fk0!$qCRm@L<Pj-Oo!8cDxiq>w~-@{LP39FbYKPuV^kLnJ<^DOy<$}k
z*YY=3;5wh93QoEdN17tKYTrofi4fC*G*iSRM>R@;gvIaEUC9Cak2Jp>Ws;V^A<Han
zbse*-!^2C7=VL?We_Up3E2&G>4DaLGlu0IB(05GfE)fb)>|U?PFE=u?NX8fU2<xFD
zGMo|_7%}{Lb%TlR0FS9NO{~vN@|?TnXDW(FoE@Su=>C)kWZXD;4{U^24!kQm84Nm5
zT5HH?3?^fuA}@KM?@-wV(PBECEG-m<GUyoKcXox(S3f?sDMRL0oH*(w1hQzM+2)X?
z=Z<1A;8Qk-@j<aff)#F=m4rhA9f3SFS-H@oO}=F85-<(As8$p$@cVKqFEL!UJIE*+
z&T(^jOE|7Fzfj?I=8)n2AU|{naRauw9;5u+zr(>%Tw#0olt$1V6jJWc(eu?<-U+YC
z*#z@b8tPq1k1uZN9n5_PvAf}2fgA*~+2}sU`F2o~p(i}jbpR?7QbXS0XNr|vV5HdA
zi3|=@LV3Hu^+qEB(xPAki>XR2lxx4>X!b9=4L0Fh3)8eVQ((lM`4F_8;$QJQ*gwFm
zD@s=1JdAXfdLSXWCXcLLJ@2&+(=5+;e9|4@uSg-keqUn*DXWK89c97L0t}@LX>tp}
zroWopFg2EGfz97=Bj3a{N5tEUT|A{)jBF<f+l<r;E`cs4F*QazoThD{>!+P$9iI_q
zZP~$z?gN&)P8LOBa_?0*>#>tf*+0+V4{w+V<o6Ro7U=L<&=UM|2##ORnfM9E?1~rI
zYkywSMmyevf;R_8?qC}UZY^`yPOuKt@rskT-&8oe0PRR>nov60oK=RqubEmp>({yJ
z<U?MAiBWOlzuRXPBd~ln%YYI!dxEav%f`kvzxDZN>2)%a1UcKn4~O*7G;v|bHP71)
zQn2TVddyLVWb3qh>tBpt#|`8`n-7HR5fsao#zOVagzdueuFVDm1+Vh*Z?WLD$Y@jr
zNDbq@c6kk*Rv;Uu{%>3UW)2zoeJEinUcEgCUsGDb1lEBt&)-FlJ1;9}YNeAQO2GUH
zT6Tk2p*FQU59yK(`p_}ju=y;blqh88p3QXEmgI}^OGTAf<)EFNEb;4R>gxjFhq_Z3
zVe0q3aq2qrE!~4gj*l#U;Xhr;vH+48UMgILIiaWMqF+F|AE%6vTY#q2yb-=2vKqPW
zdhfGbGLJScgh5Ke&hP0rSwHqTE%=%KN2Tbt?&bLwrP?c_{pKZrCqblb0NlHpx*ha%
z2&GZp3!L8kBFv}ylP_2p2s*P7xUhFzQ)Y9;*v!)_$fiAhGQRPP!)U7K%C34&QWTxr
zK=mTclR$<v%212182=wzQ-_|5typ8qKB|=lto*P4^xg8LNyAMfy`;r!X3;l+C6gv<
z58D942JEWjX(;w#i9}eeKhbYG)L2SVK>B$xjH{vtv9X$8!&e+7QNI3Y*QNphJ_;{g
zmh7>?Fn7XQi+%j4?dRU7sm15A!(LwlkC?j_s@jys%>7KCCl;{U&HXxuxrW_y0Nx|#
zsUki<47AcaxbkeKTMrZx)+21v95w46#jvs^kmqGs|K&Bq_(hG8{rfVf-x|^Mn<2<?
zMB+N->HLg+(=yQ*tmcm=DV0E%r-OmPM#)}=6(qZXd~Ni~gF*a)Yof_{d@qrSe#^8(
z<BhPn!1cggXh2S68kHN<|BHFSaWfts>#LrPd|5Bb*<1{D&XC|;1lQh`&;=8$zYV%{
zHPNxXt50K7=K$O($WWRq+}y>QVf(&ThCRzV8!!`mdLp|GVhY9`D#@;@s#Z90M2UEs
zmsVP?T#4&zQ0~t*g`I0K0<`1S*n}(;Yl&w~=@u!^Mq7&O$A*>emc4O#e=*RkL|4MB
zMPA5^kbhK&|7cdIk17rRr&JY-A8@9@6)y(G#243`U5&fRcid7wg_#rJs0RxYGIXYc
zP?=*sQhg-T=p2fw3M9yH3K+kgYkF`Ul6>W7XYkUSTlV!2({K>{-Afy{Q!>-+RMGF@
zpou1Abnyw6Gx9y6U9jeT(yR#Th!N^Cwlq!<e;wIh7&akjtMoDJJ8BNBykGc+#!?;l
z>u5LGM0HN9!P=7LPn_+Y?D8F{fRse^(<4TJJZpGOJP-*gUKiLTgi|t6;zd-siLh4?
zL5{im9G@m=eUQ+YzE&z5{VA83MfVe_jcdM%>4qpqmssB%{1)78DGJ>wa$@(VE{c_6
zrmquBT~8;R)6O^h-WUkAo_}$>gM%-N9ib^*&(Yy(5MqEmrrGIedU~5I`!48WIsLgU
zCEQ4awlSr`>_%XbB^O?=BS0)eHS(58@C%y)PeZt(h-!?J`JstIQGak#bG3>|NwN{+
zU0C(htea3day!*r8dwsZL<zOU4nt)cMoFvhBI|pPQNxw1C6Ra;^zwUN?JSoUBaEg3
z6g$g@ecti1mB<)gGMNAyAiCrn!Sy}3-IsKHLP>xFqqG=(?TQmVBO=8;33tvB=%(S(
zsMBei2K?lUr#?7Cl6PUhE+o)SgO}<JxrTr+Bb{}(lh}U*WKaO<1yI!o@l)erS&wv;
z<mcL!$Tri@((3B`1kTcvBtJp`0|U(TQ??j!fogtYY60iNypW`RcKi&kZwI-^tft)y
z<?q_2OXJK!xP=KEk{?jq-;RBB@@3}_@>X$)JhpW0{w5qvH2sP9HL4_Pud|MB1RVs1
zBy;EqN?v69vme{u95i95YKJeXaC{J(7i`#);6`_V8ic@mqAnGUbO1nC9ZlqJ%F5GY
z=wOg~9e+1A%jGE+8{R@0Hz0SYRgx_?92d5OFdz`T8tl+wMB<N9BzBi1NbnZMV(Jm_
z1zos<J@C3U?oTn*1hgB<HUCj4;ke?+QQJf(9QKvcORt#nQF7OXPwe99n4b1Lg<+DT
zp%?Te>bL>looYsZU1mlc8_p__D+)lbS@tC2Ug7?WdGB1);?)Ro`y0QbC@*(BRn+RC
z)3gW#&XL5e%Qpv7*zQK}{3VqcegwS<D^>xgz^23)<eqJA-Wy}K;|`R$^QZ>@7wO^g
z97b!CqXtoEiv=bR^S7;-v*hCnv`TD_LS+Vs>D?IzwtWmz3DZXPFu5P8De+f_<J;7s
z&-j_aKJ`l995rHPtX8FBgnSp52esP5wHa4~9rYJON7?5KD0IJaJ~`lA$>?FeA|7^&
zqQwHGsp_xEv9ILed;`e}>6AAm1DuEpyNF%GqOW(uhuCHXsAvCvRUP#?&o*+cA8ux^
z!tVl(!xEz>XKEr6NrchQMSEDbKdUIn#592KhtD5VpXsSfDr_w%Ek~yQ|L#gX6<gO4
z<-Vj~cm7~)K%RLfPfLxWzaM3f!R%j^(OZhzv_xMxEa_0)!Mlr3jqcMC+F7%t4jTTx
zQ#>R0a|PGQE#F57!_8*!8Q~w*P@_eFF`XvpiDt{?g;SBd@zy;gTyC3@HjC`f$S|X0
z57S>qEah97OI2@ZaRN|+w)pMl@JhlU%jZ1Ezt0-`n2q?-CZUYVh2no#*@Ve-S9`|w
z2b`VP(h#Ynd83)2pi|iMJ9ou?1XP+Q9@-I&WCEvdUO{xF`i<^V%z<vs9aaD(X;(}N
zlWevAfJ+Vd2u>V!WtX`yQ@SO8iNa&z(uRS777?8W>E3DelhX!_#p?PngH)e=$rDXw
zwAxBcH3Vr>Z(=2JXo%K>2)Yr;fbkjj9F~#zcftlzsyN8Y^yqWLvvi!^*F}6h7@q(o
z+f-{WXd)SN<AhV9-9Ad)R+U{f;@_$M$};TaYf*Xj*c}Nsbv@O~_UCgStKf4Daz4o=
zF~nF^7Qhun-E0E&m~?dKqq&#DH^_Pt9R>&`sS&fao`nR8@r2JXU^>n>@3M#|D060P
zieEwvvpC`S_n*g6v>R195Qn}zT3F;XU8rD>-WTrTuSjeQ$b1xss^_z<LXgx*G!|?~
zH#6CQe5r)UuhVa82$A@qwm&Q7=j~o&+yOW-15YQEPXQqJv>OFiwmma}5=?2(fvAoV
zTfzSYK2m(SZ99V<!uHVo%8{qZw_-j_h)_J7-b5x+c>_~G*+T9Nd57VM02yeGegBP6
z<j}6(;!sGz9XOYKos!R_`A~jEvcL<`zg5M{ZGPEqcM~4P=i-+%%4MPm*a#2gU@Zsh
z>hV4K6gWEbGo?!rfG9A6O=Rdbwu493e0p9O$=D6kT~<f9)1!?Pnk`)@!4+r2?Z94~
z9_E4P34VkZn@$V5xA7EWk12UTr(5@N<k~oRfkV_h3Sj-5%Ux$bTOGwjafLic-da%~
zU3HbtLzNUm9O3OJh7b0$UWbfWf4a(?xgsZFA=vLAJ~lHm-}GTgqkksRlG;dW8GE^H
zv@Ix43<{+(-&C^*R9rlI#mX0B14>B>!OCl(KA)kMqwnm>mUUHwa%pa2Y&gd3Iu{l$
zQ4FE3fZJl}*uL1j`gHb{@$xaypt=qm-gndfS1~jZv{&E_WIhSPV;DJJvD%HFfL|l}
zcV@B~lY{!~OkKaozf%QDpFcYaNLn0HNW`xNgCjzcs&|;G8%~Z%TE<`O=ZNC&!@B!Q
zWph2*(wY-|JM7T?cd)8OSprBsJqE<&=}m;#)RC{A1xi?AaM)KS1kfu|;jJX%p(iFb
zvQxlF53_PUN2%)yl#|qYeP9vnZoYdyrDV*dJ|jOcUekMTlG#lDme#NPm1D*B&Pbb1
zJEXVKohr@kOx-Ge%0OuF*%rad+GkTI;&+Qj38TPw^>C~<kbLER2T#-V;RxlCdwH<#
zz;XJ0N0ev``!tod>tH0gYl0nLID-wlyPjj2r^(pILMU-kE-ALiL?_B-ZVmE0ia_WA
zPx+6l9OrEeRp(_=jo1@!E-R2Y)&)*C`_+-0KO2S&w<flbeAxD8MNBKh1#~9y>YJ=g
zsH$#`ft2P!7p&1i=>Ug7O7^Ua)Mr&f6{#ay9G~49!*hj7>~pz8m&J#Awe}3seJT^O
z45Q-}8Wg8eZFt^_n)JH^U0Y$=38>K9$~|}cf1*4%I{9=SE~3z@uE6h^r<YN_JPv2B
z?LP{D2)TZF&8x?tJ|_a4fJ9hb(p^|g85&dA2@BA-;+2txpJ57tSj!_^MRN1bePvU}
z&Rt)Oi`5icYf4+}h~0j!!oPA}&V{-?%}1Vk^*>MaZN%Z=nl?^(T56}ba#rXI(Q(&|
z(ckVzCM<YfH<$XK@zD<K!@x*R=CSfm`rg`2*jLoRCQiZQOQw#j9LT-}zHam1J0N?7
z9+>N`?GEAVE0V<upqP6)`+Ie1hlA1cgR@7Fxh*Oj>b?MjW_S*2Ruf#=-6i3A<iOlD
z#2u=6KRviQ6%(CA^T08u9!q7zq`#OXs|t|rcJ{|csVL-eG(tf?Nh$ZYH%^u}em`@<
z53cxo(2)4#F(ypJR~N0xWanlsKfuP~1Hz~&(ev5z?>TOo^Nr%h%m+SUvUQ;N!dc_+
zAV9_9Y#hSYV4-!6A-a8lx@j%h-Z4m<^82(ol7NDIq{TkuS|2lT0tLQSKwt^G-jbb+
zK%SfJ82md$y{+D;ljP2Pb-A}m`(Q4i<BO5hVd;dowC-#kGPn)uhR@XJh}^>13^k2q
z>Eo2Srg$|=SCvv_%};2#68mlKVCSZxgm3N=z3M(jr_1eaNt$vuL$uOXYaw(`%Y1@z
zt?r@EQgOBr14Jxct^bA`=WQ1tH$$emF$49dg68;AMj(k1(UJbGL7ct6xQBft0Q%?Z
zX#=h$sd0CoS4`PWnQlEXeUS>WBXpLxDFBY!P)s_7GYKjEZI?$xQ7HjoW);YNnz*UR
zEsA{a-4VlgCv2lc+y255b7&}+B;xlSAYj|sdy{sm?o??NX)&PNJDO@Yx2o6yQU_Wb
zs`!e7uJ1OU>R{#Oe2)uoxNjW#-O8<1ttxNrzs;)tBcy_<>QPG}%b-ULDn6M-_b)L!
zNs>XqgwZ~P`V~Ui6+P-OW@UbDXJ#b*zsKj#+3yrdbq0hXwz@27_&^PFOGuv%=w8(U
zm?Ck`f&h2uiD{Qtgofp9ox`PEtQh=(!U$)|W$YTHiJzUqo9CE>zN?W!iOfrmu{uzB
z<hBTG3fy_}h!bK0CRzIT7b6<$+{j^`raQSCm-2YhdyT(=Ni=RmS?>|Y!A2BC+F<Fb
z=v!|>5m^O=uimH*57M6HaZ$tcljSC^*ES-uUioGqGUSJ@(Pmvy(C-fJgIAI<>e^&Q
zK7@7iYnx3Cs9bQwFAwaR4r<?rjEBvCBYACbE5LNaVWZrNp{qazHc`~3<{a`pqAJ84
zwAzher;Ls7DiDpr$$VTH<4}m`*}Pt12CKjG|Ij=>`)wsZH*P%~)Y9dFNKsxHXQY&B
z?YT%fuO2&Wo!#1UCHdhHfI^@GGie7+sKWQ(4BF1GW-Q{+i4PYPLiI$XX7i<wSby`;
z!|i=QzJ=}tYX5jaqgKY<ty$tkgi4@~+6I_*Mwy7U@1oN-TWmFuEp+!51>?Rdm|&}d
zX?RAb^NoBPcGIY`<qcXiBJD|WVgAOiqK_YS?~nla-N7M8nC|MX94cFr?#{%;$dwnk
ztRkX`o9feWJh%acLr}9e*7GKalWUJ}_7GQ(vN=qg&Be#Ik8NQfkt4RGQ~SHMgnS(P
zD6Swzhb{0cC`RVfuPyOCTY4u@7=Ke?1)1P4p>~7$M76+~&_X$m`^+Q*f(Aw$@j${2
zxu3!K^oE&I-5&|C_-}n>AqX4VH&%&2ksB4`Jz)A*gxQ$iMacrpGr*Tjtus$)BAP7*
zO-6#b0b<CQLsFw-0`MU4MvgU5n<8q=uG{OYFB@_S;=FdVcj$M11FRgQapT5Ba#TJf
zAEFX(j|5H;Q^a0%CfWGss8S5W!>-#G2-cx0MPIH`qAv_5X46&>soytq+0F5_T9Jlp
z8<U%>`<|G3Pgq|S&{-#OYUW)8M&zh>mbw#6L#PW$F|>(DvaHpZ%%!E$hg$1KFka&O
zC10;^SYWae|1<FoC!->%Nm<)oC&gS&pN^4R4j6{3SmCb{kt)0e0f!{VA<*f7jm^(a
z4h&?_Ut~EesWU(O9lb<617$cu!{qb?26G0CF=NARLsKXN3tg$hS`&~+i`ec(=*#xi
zHIy}|==;F!-$1(=x@u@bEW~wCWU&4RbJz<66o5*t+Py^p%vbdT3a&}sSEO9TeTM{)
z4}AW*&rBh`O<TsMwQ6p_O41eX{N$UNjr?qkJ*Dqv7nd?Ew2RPvW*+Q)g!qzaV+>#B
zjBNMn#aERn#U0g!*?f;Lj@YuowvRu79MA1!T`0+q&<b)YrL@kiCg_{^$5n}-EuR-5
zuH-jX`URAYiF;5LFo+mX10#*6$;1>}rPu^vY)rMuqnxI+aa<3{#4N|A2!5Zel|9Lh
z5_3e(ZokbM!QRd#0By^7*CzcXmG%qRTkU_)l%P;DXeR#w(^rWcFKzW~hFG}{dDC*h
zx*oZ=NGd?7nF_361w@taAy!KC_B89F6aL`uhp6Zm)A`s5$C!F)4M1}Cy7O=)r=(W5
zvEo}1(+hG_(|gt6f$5*qDVp7gPDbJ&5rx@k@JSbZR}<k}vO(%N+!Rdnfb!uxf<w6~
zIe+}LV!xa)6g#ClCuI#@$?6|V1u9<YEmR}77!-fns3qr6>drxX^c%A~1i$zSOf8L4
z{vOigUsW0V!pT{&<yPZF;u$h~PMsza4}(~SiUl0-1iJE$1rvJLI)@!dUiyvf6JKPl
zUK#kQ750rAQrk-2$ANY`1Pov=F#^!KfWK2c=!Fm@1(l(ayv@UZqtFYcp-6DdJ10=P
zoU!cv1ZvwJmJo#*OlQ^K-lnn?z*yH>AO0X1I}KB>kitV2vqnce6y){0oPjfg*id(u
z7cPI7@Ji`%4l0M}8If`WsVwaQS2x*SEybcKd7rJL{8uRD&kHY9(ctR+BDcYz{T%c#
zy|E+LjUZU@{HIW(<=_*OKj`4lz)SQ#CNM>0s|9o^Z{#|Z*`hcanNvx>?<oEn?-bG|
z|Mlk2o7YJuxlvyOtAl0jQ@hrUkH<SwC7(rRk+fS^V4s&ca-pr#^yG0nC~+PV6w3YJ
zWZ`ljAf#B%PSGz#xdLD8?we&%--wBDz@(N2Sukp!R05cm%y~3O`qkP2%xesfF+Q0>
zdTW|)rccs#-A=6^#GJoCs*#4vzA)B(2n2uD^xEg)IaCYwpr|>A-Y~nyg0ibNt$;j^
zNpl;4T)oQTSR5rc8G(34sG!F!Ygd3X_uMt9By0#l^rhNB&sS#TGg^hqT{1ppn-v3U
z<P)yX_a*SD4spEv602+5`v1{?YhWZnlTN3!KZ`GJi7Wei{e*MgV|;NPu=ALbWWv-g
z-F=X<a855i@}<yyY^EO>I+fgL1L?nO!u?`HM!b8e8y`Tx>D7_2R8kWe#J)O-wdM|v
zAma!N+LP4yfW)voTH^132it_#w_q{sOIfW%=-<^vPc?M5kgjoC9)Pfe^L-klar*$D
zVZ>zO>^}EU7<gE0Mtds@3ZlkO4>8*X($`h}ntgxg?2`g+I<E^Q^u1`9dZa}DIebAL
z;|19S<mY+!&*?oK|F%y(gyTH(<ZvH(rJ+e-Z~&6BDm)O~x=Rx9<Bv=PC9756L>B=o
z)PyaZ+iZ)$q(kpuBl;qil4YLSXawGv4eB`++zBL%!~I@g6E?4Nk$P|NI#D6t+TKCY
zSP5kaZ9<oDR(*utZ&!6vSa68B6n&H1BkgCHhf5!T<6IiShZv$E_nRJgl`Z<U!S+Sl
z@F**%!#pN1h~MS-q#hFWMTI-XnM>6%|7<JP<J~l0(lCxkI$#8^EYwA6%0g0bt=$&y
z`Sz#|CXY##Vh_$LMD&xNb8MDLXpqTh@fOeIb<<?9ch_(wsWMl&j>4E~`=6%=$DW;)
zgzp)pqkG+e3y9}7LtM`~%tiLEN<cVaghGzi(tHQ4HG~>{NEim&z)?r5P7eu91u&KU
z^gvjj7XlGfOt~HKE4^tW0HLpG;c0Ts@OF}<55;<FYH()Q%6r7rjRp@D6#TVCmc*_u
zkFM!`a`-Dc)#pIRC8oapy5cMg6O+zH@HZZdk=g40S#u~-RL?j&8(rUZk?=M5$Pkhp
z$S3g788f@FZUi1c3m7@;yczfRe3{)d0%r`UCO6bu0|!R%W*chrmk8044QHZigC!z{
zO&X3`?jl;%ujoN(@7$hlBkn_ik663&X1>1WJZ`7}^5GMrQQi8ySs(}=vlG)10-P}L
zAbr*GP*!{Arw*PYRKcb+)-&GA%!}FT6^)$+(&-d7nQMaYDMp=ni<Z63r!U%isz+rn
zH&0E}w4RwK2&Ue2cUvRUcn4GfJz@LN?hTKkis!y=k=^Mf9Pv$|1+w3;ZmD8{^_$<!
zxkmS_M=)LjE)R9*Jw05$m6uiPN{u)E7G}^Yj_<<|kbWoLrG*EOu<YJ<K@sBk#uJ5e
zpizJ3j_SbqRSRmBfw}jOO&er4`#nTCDOG&I`LE-)I4^jKKW%N0Q}WVqf=t^d&J6oE
z|8g(m2tVz`Qcw(pY79Q|UNAFMX+{7ZrM|Dg1KLIVz-k5EmAubzviX4GtRwE7bPTT7
zfv}~I0ExAI?-wb)C5}BT2@z&EBo4Bpp1(3vQK)*gjwpp?<Zq^7;D@FitDKt_<F2A5
z1YeQ!(#AcZ4x(0tpw@-H)vI9l+PG56Bl4*mfb~CG!i8rWnaGKRzRBsFxO4MA<Nu%%
zK4Ln-nCt|vfv;>Y49A{Ev>?d$28{iX5MW|Mzppu0_kWQhr$z^inOX9c^a@?fDuzti
zbR(BG$8!F4?l;Q`f<f?FO6#gaVVG47pE1<j@*o@5idBkhDwx^#;Yq{Y(;9dKqnmGA
zQBU`Ws8skElFho%C*W?r>mEqV0vfN9i5lu6VVi*>+t;Xe^fW(EBfoe1M{opg-Je#%
zd8vJ*ci1LH?}a~_@fiIms&nw`j~bBi0f9TIW=tT#1%$O-q`+=iZAlczu;tSa!+_)1
z7>a(YKWRX33Z;&^;fvAeLB9{zL`lgwFYdt>kAL~5bL<m03~XP&r35&u!0-TdS_l>O
z!7x>rSDxV2-^x{$W_iO9@@PSxq$Yi9;BJFx*<pKd5-1RUcEv(pYxY>MeE6Z;1)?eG
z{6XbxU2BLu=$fy@%&ni)Um_QX?oBwjge3cHVx4dJ4Ic_yjLE6dYIk)?*Q*Z0Mx|Xm
zy{BJMwM0x7fxbSzxQOv6FEd6?RCmLzqJ{5~MfoQjv^#V9vx;2fs>>DmsRr+H4DhYr
zr`as}@b2gjYI}h}Mq>Yu8RFe9K#T<vmcBMHyWo<ohqXE^-(uWp<g0MGtvUC2O}w8=
z+ROt8M+LD*12(KI70;gZp^KT9hd`57uG5^sWicyFCr66u@@M(})}^<K^Je1oo21a+
z;+#{@>_?sJH(>j*+q26k?o+W2KuLV`mXF<<($>wkfDIsCZ|mL5I_+Yfz`!aa?k?L5
z)Z(Jzxb2;qp=jPkUBWUuxYwC!E;JVTo`I;F>qhDv7x=x)b$2>Uknib1Op*1ywb=fV
z?U`|$$q8c@l{z%4J}&lW^GO8{-Z98eGpkM~iZe$wN2gjrE$q>#IUk6ywqI9}Mnk_k
zUoON`?|whyQN4tpPMb7=^qiHZzl8{M^=H<!S0a_dex5wo0>@Tnz$S-RsWOXZZCo=K
znp3?zAL(HB%YY%Nm_4B@dWyuj%3@b+Bw+#)qi~PaR#Q!yS7wP-NOJwa!C_8u=}1L}
zA~C*=`&Fln*oX3(M3TVxJ>F0jZH5raa-fO23Xp^m{{kOlDmlEqCnRH}msuL&RMj{*
zYvxj{!naPOJfp#$C72p8Zx+LKpQc=Y0_e#Q8VA;6G87hgUTs^+lmrtVQ#E@Z`=+>I
zdl=D{l6m^7ZQK#DFTq1ug^EjQ(=xhgQF+!#fY?Do7dM81&z)ZI|8$YMUL1)M9bF&Z
zD&32d2xFgggX|$*FZas@dS9OCa~e((u%8S7A=5qy7SAh4KF--vV>*tH8LN&JuArYw
zWnHQ33#U79Y=e_k`1W~uc5eKF8)U7(7y@Fi;*oDzj^Wd!jv;0|<^K0}#%jsjR1~;l
zW%m5Jm7k<PytKNVfMs;8VcM|0$AG7&(6FHuYu8pkmcj{Ad)HSV;!N}s4{6|u(-{46
z-yW4<VM^#y1qc?Wz@9xX+-nG6(IH1bv)II>g+N^D(s%K7{2FOXT8gLHyN0IVOA~in
zbW>5;?jWg>?S#JNkSGGo5f~TZyxb6D69vF~M~$C=@woYo&Qkyw2joTClw4oQA*`e{
zj!+kk;=dLFS2H29vLdW>f|ha3G3uZTSOlF9$|i@tb2Lc0C{4$_Amsp!>L<{#!mzox
zpu=bz@BScF%a*D<L{i)0SAAK2Xx?<+8lI7av`5~$vPw>Amh@#gT42Y891gm$F_Tjk
zv`R6OPd}o|TQ|(6s1Xw>cD3Z(Rq32#0L9hEi2oEM<Xa!ct=pGD)hBe%Ee(A(+QAD8
z0U!J<+vDlKod>%TR_kVMRRNO^L+?j$g~ws*!Pk^<Gk)+EZx!d*#QR^I3uW=DMN!7b
zPU5o&AbFxPL1bE&AGEKyr&GT;--yR68t_G=92{k6N`Z;BtuOv2{&osF5V{9^dikKL
z2u2|H_8VSQZ@4=hSJ%@t(o9p-Wxvsm4Dcyo^)^2j0bh0|SYL9{heTRwcD=TR!L0B{
zvI1%~{P7kw(m@w+Fy7x&d)I&8g*2#A?E=7ny)~p>6dl|F3>pF;pN}I%-z>RK?CJkh
z{_wHCgoA!uiW+e`)DiGyNahnw|6*Q0<7WN*IoXZnf@D0~{AOgrO7OYKIO1qKYn><F
zXAq`Yx)hKofBtDiY}fIOU4zF1AVY?~Dc{wuGcFWtK5G83|Nlu#V{O<mVTC$p^`}W`
zk8D(w#KMJdcr&W)Y0NhMRFyuXwE&MVyfyQ!XJE|hPZ5S(;2M*GLe-9f|K&kKBO)nJ
z6ngKS+TzQ|gZjC}WlIFov^%Xm?CPr8u0bc^`pa!5#*B$Y{Wgy|Iw7Qy14{;iwB8=N
zHseK-9H`m`ZIBNN4qA}7IXGo|=<tOB+uJN=U`FmQR%M+W9BL$rOv<_z+FvrP%(CgF
zxX9X~9i0lW6QS*cx>ZwXVHf2~?dw2SHw)AuwI<#A;f(mS&5byq5%GhNdZiidObnW~
z?27@jm=uz$rV<ZomX=)YbhL=fy!R2%DwVWRiuN=91WP*rW?s-=ORXZqZ*E@Oi6ceM
zeb(ZXN2H3hIufm`W3t|6gyiTvB`j;AbGkc?GTm2JS6<Vo{1D&)a4Fjzr0ttaB}vzw
z+EM)EJ5cl7M+(k`eYsk<+Q<tknEji2r<6?jw2*)L&0!jw>6LC7Q>_e(J(uqPEQl+J
zDzam^ma=<);BJ(Xx$p~}ukVBuQ(*Sq)=}p+<4=aF(8@7~yvnIy3s-L<(3Go<YhzWa
z_8iP)C_H2B3F=1M`E{4JvrwJTkunz1==xwB1IorPDm?d_>N4M=d;dGeT8`2@(va#_
zp@h48$n_4v3S``}+aFqEJ_vLuVpf&MRD#XO0?lk+Cov6$Jx9tf&AC4S)lXG{!!^|Y
zfUKSC#Xbx_S^)=ytYNE38phwn8f)H;8^!OoSPX_Yrq!T7Iu%+EG@kO5+^?-KYj1lc
z<|ajTQyNih*L~UXv*4H6NhbKnIyxTK83vw<WCZ1A#nNbaij7k$UUgj$n0jZY&#b*w
zpM@+BQ7E3~L8VNedOf6n{f*Imgf9w}9W**g-6}4a8H_k##y8f`L1cDQ2S8sf{fkW$
zzfnJ{IK=Wvrs!sTrJVr|7?G8}GA5WvkVGHx$;i^qn1Yg4leu<?ahUb@y_8BNq9aFW
zLqJFmk#KT#)NCOR{3=NtO6_S$bCAK}+bDZzW$N$I__mNlrii%lJL!`Nt$BV34rqVQ
z-d%p&rw|K-5TA+qJ=&uAl08fROqRl?ON*m^=H2Xa=+z0*`ocPyvloQoet#C)o`zry
zM?v$R{=>)=%s1Ureyy(!6h^rC00I|g`K7N}f=wf^3B?RuXIVlg5w<aM+e*Sc@@{%D
zhY+`s!2l<?M#9<#o02wz`1ZIKzR?XHmAw9K|H^6wKWU_<{xDf>aXu%p9B>q(&RKbf
zg_0NL#|+711=c<49v4$?eILH@Hxem*68HSsf9}0bg|Wj`{twjj$27CUcL(+`k<qBH
zIU>;GW`MTnpiC3*xdfL^o#gwqcdayLW583tM(sNIB=PPP&WMAT7clayfa;BgTsnxx
z>Vo?7(*0|!UpRvW-66224S(iLqbK$=6#WgW*753pg<i&K<KUr7c1W(qgvXiD2s;1w
zDBNCgp1BVTIh1UrH2vA21ub@(ZLNzPri4PUpWNWdBtFz|USGKPoDb4IvMxMU(oXgQ
zTS~&&UE}l3++=!#{pQ=~knYr0$F35WP3RTZU{K$5b?V3-CcH)RJIH^&g68)IxrL>S
ziR+8n6M)~DhC<$bJ$l0{Coqw*7=YLgR)PKY|B?S!!Yz(C@()vLTSr#CQdHE1-BTph
zspTuj=qsl@sIW3!jMoDi>uGV1Ycz_1l$}NGbs2~FH2Suopvuxs0%H+=m$-v0_;tc&
ztn_pSwwDs{8se5INv3~oURsS>u>!WTXI0|l7p4OFm#euEGNjVr6}1h;E-Q20-_%MS
zZoq0TZQNQSGZrAktm#QB0AJWVMA1-8)T1$5H3GUfP9{TfWIf7Dbp&X*&o-O8FRaxD
zWUy=|K<+^4*4N7$9CbMea}$q5OfGvPClKNiorRvMDsHfC@kU{p`UUP*I7GYP{gHx5
zO9{xaalmRR2vz3(E6W&n!FQxK$D@S?X=>o=mM`3DF3M14e6Sw{o-^T;`I!y8M`GtM
zvoVwvt#ZmD!LqRVi;VHzg+Hc_jJx`y&x&(|4S*t~8mGT6)^cV1W?hbzDn2DpAxA6F
zC1SaBM?KZ1K*z_^Tv0iYrsUyHq{YD-K854L4M+P5o`G?&RBLL&RVYqUong$e>B@aY
z-s5<U;7Q+|W6e@9EW5lQ7D393MjcmKg;~zmRw&++MyLT9GO`s`T%Y$@Vqab()5&g7
zI(3$gr5l~W!F4XbEFoKT+4ad7XjKEEShTL`MdU5RI1uRun;{F8AGcaV4f1l=aFBzr
zFPXXm(e3njp;=!WmoSrC!~>GAiN&@ieZr$$+z}^$x2ZG3_RwKwsVa8ft~h%>K*RZO
zQxrnXwy~p^t!w{60LgWx%qRD;E%B3_q>tL<<LP|8j3~Nb4oad{a%I$~R&Ib0gUXhg
z?LmmVR?md-$9y%&ANv6j-4AX?fDW~>o$x8AYgG;WTIGhsHKf6)nnwUPK*+zH!Weo9
zBcNmvfr3LLNe#~qx(qS<Z?#dKL6=ou`T=Jn@Zu2N&*658yyVr5n;HDzt_$*S1fpdZ
z0apk!Falf;m#U-vrQZ4Y75sN5^?(o-*&-X-e+Ei)=+Cwtotcjr$X$^6N<TyP1S2>l
zV1;M)1Y!&m8e9t-YTR=FE;)%VIpIe`UJD=*+oG74T)T#WfKB_U2f+pnvyX2p+kX=N
zZnZb-BG+Ogpp2#(`8?G%On<59rxj;d9^fZ0a<@wf`N>GTwYj49iClt5qbQBfsDWyW
zRjGiU%m-?E0-i`K0QxX@t5Gi@<gvSv;J9Mk$wo&Nc>FGdnL2dIw9%vU@agCOZ`W}D
zFAsqQnm*Q1Ho(?KUZ3!m4~yH{Cvth4@7HPPnC>fg9ria2@z~(FBc0(4JGQN3MJ~>`
zFoD*~9OIGRon=t%g#6`@@$N3x55d;h?eZu_YgJuqqtqBD))pbo&Eb9;gB<1t%poOX
z8GEIR*ZtmC^=)&`m<{I!9p)~}=Ui-ghQhAiy*v)IxcOJQg0rPQcwPQQ4xv<bi_5Bm
zrv#b0{MhaAnfI0?p?E=)ht5!BjI@XN*NgAG5RtA9^mB8JwfB-lZcvohcg07|LVMxz
zrkZFhCly<<CMYfZ9}Y`d<uyKrH1oTgz<G2Xj0?BiF6u0}(f4p}m>|HrXQvfO0{IT%
zdiI&#{(y+EA(~(h$mA`DG5cq^<TmrXIxzmmoI`%->y9&H4S$8b+fo7)pXrp|V4>({
zk{Uj|uZRI03Yn3c9#eT;&BkP>1`mK;bk_NGpTyExpfd34{8rvG&}Nogw1rPsU%Od~
ze=%qo7b09Bci_YyJkVE?fgvFvH=nqNlG=;8x9i!`t@>4!O_}>aCSGrO`BzXUl5Jaz
zBH|5(e1@$53ce0jh<R^Os^F->Q?H!s&)c;NBh7VZrK(N1rG@^!pD*&vneVOwn<BV=
zk#IiN?pu2(u1;mcy!^6B%?><D1CGAz5U&@Fb@9Qe>7}*-6|$mEo%GE?Kbl44WJW(!
zIB7sAC<K20IQ{}Pr)>u#wm@%k6Q)NA(aCCU_QBv(Eyfk$v<}jFw*p9G&*%XHGelz3
zD<7SPJT+CZ6S7_ritno-9#?Iyf_mGA!V6Jff!;Y<yo2eh?V$&PfI_BrVCt#nFUTNw
z$IK2Z+CxsLlZ4W$c0dyI7)ur(!O*1E7%A^#O{HtUfHhSTGLX0Mu1HUFH-Y>wf^w{X
zlJfUob%de#XhOoKqA5Uji7q>1bnBmu0EM=rq3B77XYL>+WfU+IjX8$ENU>3Tqmo(+
zUCK-Ki-A!IU3byL6)_B&(thc}T*`L%Ys;YeW!Gj%Kk{cJ<`09J16~*m)LZ@n1&aF&
z3MBMLf9mD^l<Jl%*~1^(<|zp4_XB%yo^?>nB>+9yO$H65S9%T-50`m6tpx6JG@l62
z;w-+-+lGs@2l@KY3Z)?Rsr@zRgySwlovFrJY`^F`s2~-f3X`Vr`MX^a%T;TNEQAYF
zjen<~*mn5dWHkx+Q*!KMiJ=x+9m#Om<nmK>yVp&1U<`fLyCL$T0Y>XGK?>duw!qW7
zWj2!osq!uyYYDin{)HLsG=qZ6BdiAsHUSS-l<%cAHE^gG^w=wAIrB(j@dDFNscj!8
zityxgZ#h769YKnnsm)1#^4C|f4TnNUg`rg3D^?aF#e;L>sJ{9hSjF8gLp6mnSVPY}
zdLemsGt1W_kSK>PpDD%4^Fqv2xRUT<aNk>F@u1Es2ymOAnoyz(y2|=}bT|y7RJ6#>
zC)L7@DUD`?%83R|;V3nSfnj0<jQw3p1YHJ{ec8oWMJ&JkUwscR%`@W24RLY~{W@Id
zCbw5d7|Ct&9R@Cs<}0fWG-~VblkIRyve7g&KGmF&iaG1$8c=OgkaIpa!Ojw(Cc-*X
zFr|ar3q|?Zf<*7(E2QTe?R7s)05RMH6L@Yf+OG<G(SF`G(md|EDHhR{@eDFrR(L0}
zBBeGbNZnJEF%>K|Q|BKbtpv_~_5v7F5FTevh3<nmD|%FW2wH%KqbcLqH(2#Z?Y!4E
zxII<2N52THpH2wwWob3822v4{OM|~D>1{;6TWMGE8#OGA<@@#`UF|{*qAp?k8e*yv
z<7&~N4sbwj$fWn`)Skc*(H%B26qNLWB{x{6(^KNP0NGs51LLH2oeWM!l$C|2NKwgJ
zMXOGM-6O1B6$O$mHc2it8RPTQC973+)N<k{D|*P{E$R^;VRY^|p38GNKrlR#N_cgT
zv{E@1aL(Y%Z~M=w2NrUyA1OiYNEF)(JDHFjA-_siei7wd4I^}~jUsZ1Xb<p;#&b2u
z*otCzZh^?`DnrUL9B|7#{yJxSVe+v#L04DJNYy_+`G2Vn!kP^x0c2Z^C+-hgB=hy&
zAV!WGMJIChOm&oDRG{*o`6e1nuoQR8k+O-u3P%a7(tFs(-!RPuge~q~XzWV@Qt4-I
z=%+w5)ZyPb=<)hln7Vq!UAk&><C@OeV3R0jsWs4V%!N^lOP^~L;=UKPK?h{l5(?;P
zeL4FD{NZyuVa7w}binFc96$7Je$oBzaJcbUMhob+)VBo!JCgM<*zW#WFT3#>V6@^v
zdw3i{C-XFqLh_$H4=6j{Beg~$6C}2RapS22<80#$uo<nDKB&b0WuN(LHkbtHbFG(}
zO0(hIof`bO#a|WDKG<~RjENrAVg%)yFiWuMKq}*OWu(!Is?&>{eL*Dys$y|>mt5w{
z=mRme<;Pj%&O-n94EYW>h^T0}f;l+S<V>_nMT*{0Kbeqs;*~Q(qG}E&<pdpFk_{3T
z<zi@6zqX9aq>>d`n$=mm3VNpUnWQie*t{}ia6+c1;=*H7U>CcI(2Urz^556r9NRn2
zGvgMGlEE76h-;o!CDa$$`x%S}V4Lw|DP9GyPt$r<#Ju~lg@X+IqK9SM9JN5Y5MDt9
zomZE8tE;$W2>6H#gSGcnFI|}pTNLO>Gn&V=Y`C^-4_6}WQ+d`)YNiv<AH^x;sra!5
zb24+ka<o9hUMEAG&gf7&!pMruC&B(mGIymSiDq|`e7<S!zD-&Q=9!Ko<Kezd{E!wI
z$B^?HvV}?;y#=xfVW#vr%vcPgOv3!z=4>dN(@C5XyB-MQ^3nmbZhvtHqFszGhZH>6
zuO~Sn>V~12V;LHrL^R~0<bS^5r}kh99sqFEcqdn$_ZP<qRkzLH^OqM&$!bD3xTC4&
z3E~@(4Y_adPT_&?duL6}yhOtz#b`wxVd0noi&a30bqo0xsnwE^9zw~+1`KU)+NR*1
zXK-Z{2H>nP5yx-`hut5*-ggh^Bf-4yqh`+6F?lqn(uNxzCf|uRVWaivzzEf3j$`!%
zPa8ZP2_{y?UieKWLVNQ^ZBkz+@}-js6|@11-@QIqtgM*KgFon3h(f+iT1gjX1nNQ@
z^r)iV(w|F8{I(LgdFdT?oB;Y{4RM>2z8dP{X9@ef0j~ipJt|c;04a>wXyO_k1DD|B
z!hP==OmDrZ+ie$fMMM+32--z3lXy5)Y}wKKzMg;`N(LP4k)qSY3TK_QzY8k3)5<Wj
zye;O^L<iap%a&%I%XaXhedF1eo@zt-&Tc@ECGV9>*B#4(FGvbRVV_m|A!K7wnd3xz
z0Zlx6eBpj7Mwsm;EhgQ(j-?PGA08Wu@32;S_THp7Z8_IUrR>yO+aua7p%GU+6-OfO
z2D^&e?mHhQW|NOkR*lr$O)0zNTuaI{?G^FI!<5Y+mml0J`B(XCD)E3`K**yf_F4U~
zyVY|A7cOkE62T;7st-?>rlnL*$qJD&-0jZx+Mpm=g4d9q^1Jh?+hQ^d3?E-+>7bCM
zp2zUU)^4`u)oD{va5qRc)k3Birj2r$zL)Uz=ah_;22wkm%8wr`dhNHZF^vNe?t57G
zo`X`XYH;$x4u3G1aDUmdodqfxSW{4fg&N#-Nn&`hcb3R|h#YWlR-&Kr;@#uyP=DV&
z)(I<h>{niKUofPCpsN;yFQex3Y?u3iypg+*6szuS39CuF_Wh8>2(cjCq0d0@Fp=?_
z!^@WG7c<Vuo5LLD#u+RI!xP<S1|)aV+0-%>L~=jND<-{wOu)uBaHA^n^drYzC@VO5
zMZgY8kV`_Vm(GT)7@v~XVK9sQ04jVFpNZztr_<b+v9C@lwUJ!4xA>;)Q1y}Co&%`^
zAv!bbKE5X<CcL^>B2tGK3s$U!?4CbJWWt4;R$UN~E$c8Tv&MRuUIf7oBJ(dt+i8<h
zu~yD+_Fhli)jbj;vEAY~FEFX|5ioEuVWtPBaN#ZoQ2wj0x&DF6ZkEh{ad3?Q;gmz6
z7rf&uZKq?5xM%e%0_N#KLryAAf%IinZ=wCo7%a6{w9h%N0egy8>8wCjhm}KgMD^n=
z77v!(Ce>!PVM4+$IH@h?nTLu4-tvj%(k$L3r2vDs;usX@kvT@@zUMJ^!`?4_q|Y0`
zU-Ay>1JX2q@Z4q!@(DCL-T>z-M&ZgJ_?g8>Ga_li<XCMNMLsSOOvjH;1cyjkyLjNU
z!Z-|rFF?I!lG09w%H^ng4KPycsFGIZab3ezP~GszXhGvnvU2zVJu|NYcSZ`Wp}96W
z%cXGa5wSjP)@aosw0+LlO74%^%dwY1Bg&@bmSNJ`s^9UnUO5Hu?&;Q2mp#8gXY8y@
z^)izQq~L38A0{AG)5JStft}q;8MM;e{C;5Tj4b*ig6DW3=aUXsfg}?Y0SDi>;*=at
zlPWP@$F8srznBBz3YApgjho5uhG7*nEZ-*Z^k<_tV`x0|r=YJc1GsfK_M?^_u%<IR
za)wM++TqL1gDF7|k^3E|qZk`L6JWVf<tV%0*!J)qb=|B9Wd2C{I-1Ia<<!ArIkxP1
z0ulUXwgkz<^uA|`?5Q@3=3&e$#Q@~t94QwS8d);T246o2j>PR*<h#4+w!IabDaM2{
zc5+NUwZ#e(F*fR4zR!ICmQ}soecRtUal#ak(p~_@X+>=+c4>$h0guxxXp*LC@3B)p
z;%x<GLaf|e7!q(7Cdp02JUL8kGiZqHQS=vrJbkTSaiT^K$xkT5ueuv?#71&P$md{D
z{)OR9oRGkID+SNw+QI&Tk#|Mk-BQm$vJLf*R9ow+Jj+?4>G5g~;bc+sWheQ^EB*pv
zKRm~RrkiapAri{*Q3)K+YX%<-&w7`i)a^D#tpA@lauj^Ns<Y&KhrcKCmiesZ+oBmT
zp#IFIT-AG#U}Tm`#!%Jp^nm^#p(nj=LhRJxpBJ@S#K>n8#F#^*<#_3QeMTpwc@W`$
z{s>xVZV#Q<xcW|jmTbem4fbHSFSE#!4O1bpW@e3<Y2k%T^VlBJLqoAlymi@}Ov~Ad
zDdVc{>_a*czMUlNx@a&lsyo5V|Lb~~+ZB*ESlAd8Ij8X5!}6wob}TEZK9jp)vI*T#
zlO89E5Z+PnNT_&&6vK%>VeHL=M|K9<h<B=jWm?+Nodjhv5<9&G%(?(_jnp?Fss@G+
z+>Op8v0G`)4x5)2h@uNtGe&+K;j8%=JE1=aC{15hE#7h%=W1D<_l*&XDS^vJCu{$}
z_i!@w?dQT)D2!odW9Z0p?acnJTu0Gr3@HLDE(1ww348}gi>XWi7yop^$f5G9Pe>H!
zwy4l5T*5*^Hqn@|CrfmPuLYK+KylGAs_QBV7&(Ir6-wIA)?80eG?~D$P4lWQta>n0
z57|2v=t=>S;0VN|A=>*iA9B|YH*YIgw5$1~B6w|GOggraQ`Y|HHQz>N9<W&c0`eJR
z9ccDQ(W$HLWbOPju%@vDyNE?wIhO6_f{10t_(PQX(i$ICsq9#Q$aNtfl^U1}1xn!U
z_#^<twuiex{Li0DawmyvA|{@DWjzp13USI$P3C0P?OJB+tXEEuTb)M%ker~e+W?4A
zA$^TIs!0s*z={NdxchqkcA`zoa^WlTx*{&=Nu#Z0W4`<y@AS~B(o;ZcJHjouE69qP
zqFLF<1wd5sHKIy?fJ*)S^gfp}hJL89(S68~!(`A;g!hH%njtaP4b&A&-m4ve_Cr(w
zbZ=dLpXvKg&isGe)%r1X)q#Ol(=u2<A7m4rvHsX^5iTp%D0cP@ru)$SfGsyX&}VA)
zqHH~=Yzc2zMhE>03g0l{Hg1r*(uC_B@5LE(gdXrey1JPI7`IGduTJJe+ZP$0eqd*9
zs>xR$OmuQ7^{L6wjK%4+gBW?MDYN$cSNeM7JwI(=gSds?0RGIOv)8{Jnqe)I24ieD
zZc)IHokoEMUW#%VuI9REtCbNOuE<Z0<epf}7aT+Bw)CJSt|a?;<PTMkc5aPy1VrEp
zaf(TFuB&tKhQ<hI=Eizq%PI$(Ii17P12WUgmxF^0{v1dfIH7a5?)uV;IWM>Ik_V6S
z+p=P)_<GEuHF9uwH?p(Q*2~jOY`H2zj_<`ihm-3kFViDc<BP_0p@q&Zi1o<I*2VS0
z%9#=FFtDdetPW1;A2@#zId<*-A1!oYEZsK-ldYUn-nng{yjY4T^<6_S<!?ue;nO;f
za@~-LaQnUnEIWUSuH2^}h+xnl`R*zWW{z?Q4_1g_S@Nte>;-{wd-0+oK6wD!f$0X2
zBmPlnaZ#?^oUX!`NFx>9K8?24N3t*H-+mh*9l-6jO8;URt44a4Z4|dUE`=bysK<+N
z+D?Np23<~Q&4HVSHJ5>_#DUT4>n3D`J)sjyY0Y4zo1<IewSXw+&CjB6-2v*o0$I^7
z$b1UkMJ+)#mY7(Ys&eNP+JkY%zzG}+Hdx;kYS$4*$olQ#Pu>kzUt@UOn$>2&G`Dx(
zBUUd^MZwpGE@pp77Ei+*MlLlX9h+3%O9nd)KSwvM$mK2VF}RC5@qSCTSn^T*nCBH4
z>d9<3m0V^f)9d27SAyfMFBjQS5zbTBb_Hd$LwY=d4!n{4evVYM2tl&@;iOH){UKBQ
zyaAASVEneDK0zuW;)<(q7CXHJWN*$`Rpp85WCh3!#pyx;J}WTYBS4lF_HuP4Aa9Y$
zdw)2(XcRq2ng9X-6XjG^OKq8pCM`mTuJNnyGr(Mhl#4C1+y<M%%JO&-T+?vP(}+^v
zV~us@`BB+tc_}QNt|q#FA^ai};Mu0i|Bas#UNU7{TP%Fm!bBg2zZ~qQhli;qyjD9I
zTIE~>1f$AU`C>eOlb{Bd1ZtS|JMiR)pnlIMpgc{|LC|g<+-bRrN@;w}gDym?67kew
z!+b3`i4P;DM$l-8g8{)*9Q`Y%2xEJ$0Q8mR6BE5rTz%z+rXuLpZ*qrsk|Y=dH{bu?
zzp2Z;8J$9vpGN4+uNjFHs(Lq<$Nbsc3Na`Sx$d)F)2DMfyGx%^9KIdZ=il?6uFG@r
z^mi7?N};;$OhRx}mxxU7*HIw>RY`uSBnP98eS?0T1@{TLG>>{jTtX3el=?$Ol7yt)
zI9$;c#fN{c(>j8Io%SAi8fi+|99FDs4k55jjRi?_Z)-bTe~&p72V!*;ptS9Kq@ShI
zZSyZhl3B=G88Fo`mpxtF9#D}3ht;V!3gCT9ognr0DLRT{I<0GDCVadQMD9bakq%LK
z1a;%3s=#A+M1^wf#FW2o^v@qGFtD;o6EMNTt__5u<NG{1S=br0$s4@U)LSS~K*dzI
zo!2Pi`><?Y8_78XL{Vr4?$}!8j@zW@izj<prmDY?C%nG(pZ2wx4Q|zh3q3W1JUKFV
ziboPZTHbM8r54!gE;Oi!%2i8^4dRTIm?}Tmk|3XG$H3IZj<yjnukhO-6HM4;x4_t`
zot%!;JjMmIKRqx>8xmg7_Wr2y&92lQjtDCdN2>!6C*dUi@=BGQ43#^uEj|m{FN2+*
zz(96$?fG`o-6lAIQNFm<yQw<GK`@sA_6CjoCPtCbAu<6P!<$Wu!YC{f`~zPKJxcSR
zIpIsjl~Jx~2r{dJGyT+XK6)aTjEQgR9t2K|o9%w>G6ccYzhvd9b-w@i7Hq2g1%wYm
zFPa_gQyo7W`C`dP2@dPF6Sd!=$?kMcUoB!1%i-D9ht*Jk2M`($a>P`*<%;1g=h5Ql
zcqZ#LQ9VonF&Xj)09%9F{XM6pUh%f~G13BAt74%Pi;L-%p>r0^5y5!5o==+UKB=gS
zo>ML0MSQc!#VJ&RfmUv>8!B>ZI1w>oFd|^hqkW7V>EzoJWGA%8`|;{m?C{zB9t7RF
z=KAs8azIieXdqmuUJ3SzY0vsfQuM;JCqphg-`F3(_*w5I@(CFRMf|E-_^NW>7+tl_
z)Bw7RrjgE-xGZcVAjhwo#-4v`ggRMV`SG-{<zK#)7%}(FJSfy99{j!^e+kLAhqMYe
zYXzp9l?qkYjBnZ^J)9HxWkV#__%YIucqMLNPq6vJl<9DtS_Ey^O47<|%s0p04!WmP
zfmUO5a63s5%?}tN-7R&7VU<5|HrgY8?|`pyu*jvgRFT-&jZ8E^0M&9~Wl@kjjTHAC
z@LK`ZxyZ*{Du$wbUpG@(?`YboAKrEh7Gmr<O;QhRb4N}zw_xs>ebNA4^&y9O=x}9W
z$yVqC;S<&lv$3%Q#`xm7y=Y+8O+;>40X^J^0AR_Qbf5Jzm{@2R%wCt|Vt_iIkZ=wm
zuVf})rOe_M$@Xh*UPyFx2&d$Ubgmf8UkDcj-pz@s)M6Cl)(cx}pei0_9&&DJc}8o7
zqOt0quZY35%ykM*>5fN|aiYL@gOv79scUuZp>^BHz9PZ)IH|P&yM`R}F!~;Ehywsg
z&!WjQgvIYJ-<E5)^}Vv(tvZ#>;ZA5P3y6FOEFJ$r`2s4+S(hB;B=hMAKn!bqXQa=>
z9WW?mX?w7pI*V7*|Ft6YmmO#cMrWi6ku<STxBkK9?_q8d`gM}a7>CdlkVn=~n#*-V
z+D15Z?K2OxRIG&NBww;b^<9HRtb!o%=;QaI=q~Z(;mJutbk=E(Uzr!lKRP4m2t9Ug
zTIKn)Fykq}F<C)Sfr&UD&l!-x5w{Vl9dqZZLa<ccx?S{SMx|w(1ILnn*<1nJPx_>}
zZnt)`aOXwA?vyWaE_=6ZWtex=-0t$Fzp5B!w&F;8QUQUaPW#7Auh?xnb(AxB_29R6
z^sh$Sd9TT{(b+(mU(Y9K*nhpeA=D^=H=&92N3S+VtDU^cc>pKKOM{0ie4~nW*KrH+
zw2)U5*+eX@2g?EM)mx#Dz!XrcCMIBZG8GR-xUPOuhUt^6*IE_}(P*GZ%qY=mBVK9V
zs6$s{B_5kKwU9dL-tEPc2SAHngbFg7S12rGTa}M(11M8n<S#A(KGvv+%?}z$0A-st
zlM-)YuBT)K=lRs0l8rPCVOr73OK;uT9U8tc2-rPzfYY*+wo=7-&fZeqcJ{=Km#7B;
zNw-i}X~@ZRn@c9gfnMWko$ZapY$*26c_2>#zes^2!d_}_ve9yn$WuER5IwM8W;=MB
zO@s_6^GPOzKa-82$frgn=EeJ9={<&VutpsBlnw|jkwA;Bkh{nO`p2Pn(BuSnMnVK9
zRj_J561wyOnfoDubis5@=;#m*h1xV_156p5Ez!7wf7U@NzIz-IQSkM6BG=57x%#C&
zM|IW!)wpNiyO?HKfxD1KDwhfa8TAFS{!S~Yg?(GeNJ~4Rn&*65C)-H2i8o^gX)Q@>
zwCr)%7(SPPZcD3cM<JPDV+poJBPuMH)6G83S0#OTR0<9Mq%(y#3t^&A%uLeW8yMER
zm^X)lyPa&RVQprg0F)|md!3Pk(1yUL#uAXoUJ&P@bhw5ud2y!!(e!apkSitl)cS16
zBfd);>wG4;_A~L)cNz_0z#S+6b}f{8Z*~kV#nnj43s>(x^hi4@0vtj%;{SuuN5rzq
zOsbz2G(%`C$a}%CO>m>*LpzHZKW8S^R)7(BBXe+Gy8VZibv$zTs)bJ$3sGH06371y
zUse{og$!!M!C0&YYv^P^QRG0lBolk7uV&7`3IOJAFRdARxH%g>x9z|*b!u^3&B>#%
zpp?~}#Fb^z74k<XBMwp)yn5aJB+4P9i?xN(J;VPW!jAx|&ITRJr(~sF+)QJ5bd$u`
zM}SVju-)DL3J+r8`VRQ-JfgLKD1>#agV81`ECMQZXFe?wgz!kC37H7kDx}^td)nR)
zC=Z0iw6XN}#qjkP2L5AVzx`nBM)N^EVONJIE9C;SR*Eh~0co(Q*bv`EL(d0vM-xo=
zbg$SN$#<6lhK#C@^+@hDSn^bMMuA*q4cqsIt?(Vv5et#pJ`%2mULTdM^3Tv04_?0g
zKePXwMvD{H!>5ES6hJl=rLnc(T`cr-%HAIGg+^&V%+Fi_4{jM;er^j<N!&E`YIHS~
zV%8JIJQG!8CY2U3hE{y2gPfk95Np{hs7G;y=lmM&IRu3<I8Wx{h#0hhwtN;d;tzw`
z71%)dZG$qBz1J(Mh^90+_1R@fr#;wIJ<ll8#O{jK?Tn-@v{F2rOe1lRUS+IFh`3FH
zjR!-9U9aTtjUM(3AxBYa)vv{rrKQXESLx&Gy_Bh3Y~hhH6%XG?B~V<R!3g{b*D(Ue
zR43sGf)&jwkdl71iOBq}9mfn0?BxmEQ5H578@eU)En=K1^olAfKvo=QvvaROn_PN>
zI@zgsWQR@`IMY(_IoHa!0cn{7s&#tzZC9q?;V1i9cx^yn|Ic&}jjYL9o_`;Nu7`j+
z>u7|-W+n;%V_v$P3bA=ObPEF$ZP>ms6l3$MXIGQ3K-XHHcty>RbitbIIcNP7{53yq
zkHU+OfCc;*UA=0Il}S+fv1F#_D50iYWS1($RVtMvNBU#Sh~WV*p3=Bg3-aTnL@Ftt
zILZO~4dx~W--nO(5p<IT?|GCzN&H$wKP4?VifexYLgudLQo7!NnYFy!-jOZb;o_jT
zP9WFH9c-g52-Fo)6(spy8gY@+&Bh#}5(9mqXqq@BIc(E^UYZPk#lJs1l6Hhj;76d%
zCBxO$;gTl9Bn!cLY<bAE_i8C1hJ}yFrGg*Z0FF2aMLv(EYV37do$Iq!^wM&_{hV)O
zPuq&Zc}HP00oIKMCGNMq#KdCTwVprC{TRd4syQi4G#GT(D(7|~lPlK_a_<xb?mZPZ
zqCZys!eo&anTqB>^MDNrADpR`H;<29O%h?67}URiEqxvol7lHpA$At#MKm2CRyxd{
zD#v=>EvT6E!rOItL1@FFySE9z>r8u>;R|~5(^sAusu4U64+x>&(CUEtpSN$^c>%8d
zs0AFp!D8#l!a~Rf5Pmw^Hf>DbJYm((?4E(1Kp$W4P9!6_MfEf_?xzQ)$}$^b{QpaL
zz5k?!`1akD-5Z#cFMB43@l~s&mo2v~I9mGrZ%_te)lEsXI<dD?K{guzq|H-BR1EWD
zsdjwG|JOfa1=PxXHWuz5Eu^NyP#}oPHz}_6tntVLX!5u)Gz>(~qA)Bd8*2MDSyN31
z2O5q2-)v`&XxK!Tbfx!k1RLn{Yo&Ouo<GU*ia#=UxWZ4*z*&g%wCFhm$8xI<PZkzJ
z-IVub8BU;~EA$xHUW}ywkqwg?b`pxOvw~9bCZpxJ#v-k0x4Ob)`;-=obJV$cXJ6p&
z4p-$#@ij99ICGVC1+zw5YMhe?ku~PU#{KJ}z+t6PI2xiAnZS^ajlt(wR9I>mc%w^)
zEc&QCgYJ~crA*!4#TTaLNnAoJbd{^D6oo(8**1;vd+8VV5Lp88i}RtgosNG&StbMk
zluQ-$OSJNoJU4<j1EGDuMZl{cX&*Hw)IW+R_&k9XW}|NM)4a3*+Bin4G?lwitF54l
zEJZL*&cPBGO33%g>3pZyCD#rgRlCH}ub63wF-U0Ot@bbyCnc+Xvl+zP7d(k*^f;K8
zVFw!CxyEM*9)+uq;DxqTu9%m^JmEz^1qL{?{fkVQ-Hu`V!=j6;S&&)N^?^&JS*FvH
z*w@b$1i|(H95I(@-6m0vNl7?)be7)VyJL$*Kuqix*}QtTal}R~Gj@|y&U&t=O+QzH
z<NF@Qq<R`Z_&blwny6%#ljO1q*{+oI^&4wbx3><--qH9TS(-&evNrN1&V#Cu;6#)=
z)r~CjUG1#9#f~(gqaqZK8(PHgn{lPe&|~SB!(2>j!?7m|kCWz0IjRf@`Md98iP#cs
z#WXTqk<*@#RW34#MY<jaIu)Ue*(SE$LBQbV=!8UVZ?w=@*eRi6cm9PoO!uL|xXK=K
zjXGQ_)Yw=b1USSdW2Yb^bE@@*@@{H-bAhr^{9-&n0F(9hg&^fQA<q>flM=ZVA;gPF
z*I?iBn<wCzs3Tz+i2DX_C>7dEoA^OAZ8!dBaAOI-8c0lhVx!T|5L|#uShR|xHyuEr
zvaIz>B5}#4>jSOCc91C8VaN)Pq0)0G?grx7sJ@)NKT<=b!ZtMn?$Z|Y9ChpW6Z=Ai
zek7yR9|~Go-CYqp2>H{m?(9}tA0|sF-zta$;raE%tUEI8q@tkW<7tAaI4_XhGKc<i
zYB?Sv?Vn&^T&Oy_E@;>rCD+wfEvn+*4%5xJ4~wJ=LL)@`i=JN_%W4lKQVqn);D=s)
zI})7-w$V~?qAiwIAqZSJk#3}R(DRBX5Hqp%)|0h;l{+S_0xxB4dd;DQv-Vo|Sa3QA
z;{N4q{~|TJ<7vD|<`Z^M>`X5yeBTn|8}@I^6#lW<IIMby#SsEuaDZ^X#T^hTvD?eC
zyYtEf>hbD&!Z5)wt>r{*`IdzVB9G947I54^H$#>z!t|9^xwj+h#0SB#AHB;%1}}<P
zdPYpy{_bAeWlS97aZY;*EuxN#HW}|;vNtyr1HK1f&@@UhW`)6=XkrKs++}(DQpj{`
zzM!(-UZ5Bqp3zk@?PV38t;(J+a5k)3ofnqtW1`g<hHONSb{kY?(h8|@;|b@Y5!N62
z9hgs3q-GsaiM@<3jblqBn1(kxuF?0FBF0vA+?<o_;;En4m{D@&Gy1)51o3~OH)^PU
z_t6zomzBde>e95#tFDPpCyWG5?|HSRujqI~+w6jb;mrJ^2-M6hc3UynSCGVy;u+V*
zV=;}{_yUmmu#~a*?W=yEUHpq|Hjb~78EW`9uV9DnS_MYD18?mgQ}G`;i=ODST=|#c
zZ-u?x?sN))%~7WSQ?}ta8a42s7Jz}z!!1rzTuSC!61;`bd=d;|iW)XBP;=Mt9doZa
zvOff6F+q_?aXQchP&(4!<qLeO#VOgw^;LFdn2uERt&yxZ6^gc?(v9^qKe6kx0S~5Y
zRKU9D&duv+tq?>XFu-B|mf;F>GVvnqe}+kAf1DXm7yF1&OhYxD+~wi5gbF0%eln4l
zz55<*h76P>*@0*DGlmk8^A|ex3>6$8Wvx(=+hL}6ZK@q~9FMkE@q(KOOiey=u~XoS
z5uD_u=-u#=k9q^R$Ih*FIfAp)WW=eH=?@Gxn#uvywo!M-QO3N0RI!ZA)K1n1YCJvP
zLxbTqTToBwo`z#HaJ{4NLiUiWdTzqH>p%}6fcbqAU`$XhM<npL!wH`lDxFg`L`PRt
z9w%Z)$PN3lQ-d3tN;b@vt|NL>j}M%=cCtUdZUYKS9~7rRh>Mpcje(t-x~P+`Opc8y
zicD+@1Y+Kkq#I61A}boCE(zzvV7E`7wF*Z}lm&eI27*+#WC)ZfMn-)0BrtouzzR8!
zeCecyoB_~hPo(S6K59%3y@6URFr0A5EVra^QD@zK8&UxUnRVaESE$z(?$?an{fbuR
z&Hf%6beA%acH#Iy<_HXp5Xk#nMeV>Tc7W-AcvRinHwz|ZY>v!#i(Nog;hXhNt<6*O
zqFZ`$7_k1~03Wqd)ct|~ZaqzoXuI6X**Slq*T(M>%-MsV()G$bFHRn#Pj0$<{~g*L
z1%(GxYCT=+KHwKFJ2g=c@o^MIftDGp4Lm7as?WCih5XP`4A39c2+W!3Q^rAX7x<Qw
z1xEKP-y6c(miDwL%v6<c$)%MC=XkLva0`P@w5iLMGqvUNbOHddTf~h$)E@c`jUd}`
zOPiJx>^8`nfD`1Fn_4HZ{$daPkG-vS<jSTZ*5rEKuTgwsop74=;07SqY6p1js$gk;
zFCM1@y3-p!svvq7rkVah1OV7ga-q^6lE%e)-(}e@+iT>!n4Zp=2??ySJcCYRKg|o`
zWs}Hh+RG&`_jLn}y5~<)a-ugaXeA96g<u;JkA$_)xvb5q0*@K#bYs=ojSVo7e0#W3
z?dka~Ki*`GZjWvPxzL)~o<8Kky-o#yqAtmn29Ra-%gSUVEH~<g{wM0Yz|I-H-jj0m
zPf!+qC8p2?07n?g;qC6yp`%IyWH+mSn2s0o)VQ|}Ig#{k0m<rmW%^k<WP7;!yOaM6
z$$%8&#_Hs~60-N>P+lYhcV;hx|FyettvSHcqn*F@OcXEoi+Q_^-=*=<Xrwz|c|;t}
zc>y-}zGIuOiD^8GKGW6fMERLW^@0hTNdy-ka`*Paw~{0mo`8|-*QsN=Vunh0MEF~%
zcd56v&7?F-sQT72RIDvt+m}J3k1pwA#^>lq7SMD-9d!WCzv84tnFs!l2{)3xC^rtq
zZw*;7s*Zr*KhpCymnLDbZ~NA<h&1C~Pv}#&RyEVS8<%@bi+7S2cYJUWXrc4M#sowS
zgdtUNc1}}}vH0n~0_DGQ{sR}njSGV#RWyYqBOI)Xdgnb&IglE1C|WCZ$0Z{)>qw4Q
zV6GCoB)2poB#nY^=2@Y$)v=&t+=>-nj|rG!XAlht*#g^agimlkUF9$xax0fx7fBQ<
zC9eRqr<mW%@8#u4v3adw<w(|DH2{&!-NXvBm&H~R%gr<cyy?hoep`if-PlK9yKq>7
z2EBWmQM}V97TQC7*TytUAUKTVaq=Y0bHw<6_2!9Mv=&aZ()?~n3oacs6O`>eS*)8t
zIVK0y#40gzo%K`D3YG(ITn=&+=L4e3)0Qkkhg%Za;k^lu7?7{&lV{|W$5t#Ga<wY}
zy-e%-D!xpo29*^m*}RmYW>SKTET`dOX)qjI7oxcxIeE+IlODUkV8?*1kI?>r3E0y{
zT>(eOTC!~J>3CjtK0JR$oU={>_}v(>*qHhRq712*Bz&DCFGxC$T3SQht);FdXe2q#
z$?c|;#ghsAui;FSl{nWG4c`6Vu_5p>IB&+HR@MeMRX+RCtWQnudsHCKtjn6x|1Wh&
z*$hFP`FP@1ySKOrYy_=J>C{@c<)yRqI`e!DFZc+)jI4z&E*Mmb>{obGd>&_3)--PR
zEyigsND^??(hd?aqt`Jx#K>U}d`)@HdE5b6)&9^RBAjke@Kv{g9^^h00mL_WgV5{b
zy1QvQ+D6$mEAB27C`!t}gL1o5XjfL*L9J#ce{O!D6NOib!)Ut)08kpDcuD%C56fkJ
zR{!xmm2`2|c5JKZFmU8VA7L63d}G1V1Vk~M9X`LDp%mU1GYzR}o^Il}rp4@2-;f9M
z<Ue%$nS>K(NE!2I#BwX<7L|FdE*iB<#TGE_arFT=)hSXIJL`1oUI{tGj~oFg@egU;
zw~68NhSM}junXC3;$fB5J(rE%Y>yzNsqL8o<g;cMEH1x{rs=>XiM#oBVd4uF5XmoG
zJKP;?Q*`Qxeg6S}lAR3ZbA121w&nGCAS(ZMb@+P;e^?R`If_KsZpVn25r0~+Iu0iK
z<-iLPgK<=eYt(&S{YN(t53Vp0{aM2DLKbd~a(|T+1_s1;Q_PAUo<%Vz&0AmGX#7VL
z5KVqxvxpO~6kR^aZNZhLcQ0qVlf9)1R1ffKnEvNC&SdE*-KtX6Ty0Fza$?Y#Wz^6D
zzj*~ba`h7!bvn<!kw9&~!tznmsqWe3elXM+oldg<L?MA6f8I-)t&Ds#?`@<3NWM|l
z?ZcmKl6z;+P{q4MZw-!MRKew<Fe+7g3?)qZzwWI_X>i`xKx6t1xrxp6i`3Hj4<~BK
zg(0)1z7I+eJwxv5_18pu9=ZAhys=dn{6^7FxAd*p@|+BL+9d){R_T*0l`Ie-#b%8%
zUu4E`2`06NPMmrhTIz#0?cYVVYKXM<+fC!WT8Krz(+W*-E8lF*gL${*b#5**@q@0!
zZ#7Fw(F(|k5H6IDAVHG1)TV%WEs6=>A^|#%A6T@jQfNerL_nyCn6UWpNAEDVxYqdI
z2_QVGp#(hR?qtT@y>E~FyLr}(;qAFNKHCP-6f+#^pd2^hf3451^}7uzmDna8T>s0r
zO4^cKey+bM0*pY?yr#UNJqZ-0yI^j7-#YRfGX*ySj(8yd_&<z(+mplOO9JLPwo~AG
zxe*5kuEU^n{qN{74u97oaRkrKQa>$?UBo7icbeOZ^q6Cp+|rRc!1=W^aJn8XPsQz&
zbF@7{`bl|Z9tj6DZSn=RFNa75=#shl3KL*pn~}~qCVpM_h_jHjO$tLT{W5}005~7s
zpmmWo+7`L-{ZQ<1e`VTO8LS<-Q>NM7UI2&A7vzW}7i5SfpJbRM-^~NY%)!uzG+Vzn
zlws#JPN$gEynj+j5jf4+WcD4j)Gj`HU=eXxE`p*=z>f<{hm?M{RLg9`SCS@noPFDM
zrxW;aXE=zvr2rmmLHT;T=@*<20*`Qr6!`k$L9hb#Hc+(6iU02wTR_IFK9~pu;{+F<
z$gxVnX`s)*<yt$bc!XXXAn;>-Q#^qlA|gSlsY30y(kvv1o1sD-Z<{PT_|W6dka#Mt
zo>+1!C{fCpKiK7e+(hm%e`%RG?BmRc<C)4$yl8x2huV?X3PsFom$+E_f6TZ5ML+9t
zBqF;rNx;U4x@gMs3o}vFKE5wh1(WWBj4Rw1hZLcvO0!X0GX@#V+<t=PrV#{%c0);t
zts*KM^CuP1Oph8e@d!V=N2sv`4I-Hw8)aEU1YKF9#z0)Wm6^Et!MMZ1@??qPh#M3T
zb34Xt_NEHu&0|A&?x++e6dq+(y8$6=64BcCA~g=Ih_e~ItT~J*uBFtA@Ssnw`a0w7
zvp+ctXu)A%B|-OS&cL`*eAkqQH*vqQ>0`(`MgGJ*K3QMOr{5&#>9_v9tS?+nRi<#=
zt7#{3KgK(KOfH4JcO*<26E4>j1wy{CiUBM#%8jkNfN*sim`&LaU5E_;4^|SJMIA>U
zNDPv>-a%bi*M53^RT)Yy-|Az%5?2JcvtBW(CJBwH6p{0TSq&W!8C!!Ju$s|k&4n1)
z^p0byp~Z#7uL!D4BDKwcZI(5!H7T<76gLkOqcZF2?8ua781E%G5ej9ziK+-VZ;fde
zY#7AvSDl95!gqeSJ!fIMe1}3hlBJN~(LJFK)(qz3xhSmVZv&g-aqpZ1`{A->d+FW4
z^v$c>R{QR&d#M{CIP=HrQgs#P^{WNq%lVGKS$=b_diEMQHDn^jg-lgK#a=MJgf;c#
zK`pJq5;Zntj6#@|yxx7Sc}t%6mPE;euo>cPQIS!L9e8Pv7mN@!=u5LFf<N?on<9!7
z;XWH}(jpR?)TpA5=mZYPw|jx)P#NW+o%5mz{88Q-%eQoWU?|Q=@>X2#WFL*RXCd%(
z3~RPWK^J_?59^Zl`aPRmJXb`cViz>fqHOY85N^>t<`P|~@o*vpMEBiK3`RE~V&-iw
zpu&W8{x5+s)ujqA>S&}i9?MW$E-uq#;y!puBeeiRmn`jKK|ormcJ&JB#FlWP*%@>|
zDsc1BM;uV>$3us_Mt|jiPqGj<P4gT~ICp*U9DXU>^%;Hvqp2r#1hXG-_sx~CkL=*#
z!j6|{C};XvhMBMiR4U6%ZMgb|Knv}q9N6`P{uAW^#DjNGzdxowyi|Zwa?B0l$bgyy
z0k-xpMy$^N{ML(SsWdk^3cFp|v^x%idf9RRv5p)aU6;Tk6<V-bcG>tzGEQ{eY&zmW
zJW_&t31>cr;Si>F1=FSk>(lkkM0Q*TjctSK)BF=-t)cSA0_Tpsi1FJ=C)-O2Rtyf_
zw+k@gqsf^)Cm{@`6_RU&fwJrlncMi+_PwjHW5({441>JX2`~$MjxbI@2^8#VrbW3Q
z24Jh!?~4>aR$j@Wx!f5-3?SY(Q4C$Kr~~)J#D`e4Kk;078u?#<)b9+o!fuYhp+q#q
zlXC6eWttqOTM)|8>8^mArw9;Rh<BQq9kF?=2Y_8QepaG%$#r&mQzv$0#D+*H3Y+5}
z*iZ<$ynFwVq{oMCQJkLrWb&vYyj?)oC;-3}aCULvokTojt+g^TN1%%|n|mD&ow&Pd
zcbB8tU5QnYv12Haz`M&pOl>brUG`WesPO3=2uwq;#ecr|-@%1?Dca8Rcg=qh^lEd(
zo}?<Qlj<97iYvSthIgY~Q&WFQ(rGH^4I%%+=!JF3^fs@3C!n;=V(QtWV3rm{aW=`4
z`Yy)q>C6%tt!($xO>7$Qrm(P19Q1tb6Z#IO>tH4inm8jupXg$k4lRvOB4Ca{@NN&g
z^;8I-j^G~>=vY6rQNL#`y=64d=%f_j6ahd-wq<8W*M^Djw(*5~@jZ!U1a8kTJY(ey
zeFFQPsz_X58*JNjX*8jXF2~)!Rs3hsV$gi`hciENcTKz-#vg;UtfzJ!u#`by6J{Nv
zhalZkHhPZwA?;Pf!$GTB;qXrEBgRU_UGjirikNmlN~>=rR$r~tX>+svY@jh9^a8X1
zGKzNRZ3yq^N5rZ-#=g{hbBS<G(5I$p02YX!;@f~WoN$V}nKNf;$}2F;b;1rUuHH;k
zzB3a7r6jED8hAq|pW{I~8+HC8p=UpaBSBBlG8(-m!dH{eggaiSD^R~FuE&u%C6xy~
z-zVvI1VmEktwAb#OheiXzveboyCb>_Bk4-4!n{nMOgH`T_l5*by&A<1f(FD+lW0v^
z^T$v}h7HZ|-kqK8g5A0nNjVz}P_nyC9f}IudcQ}1)7u+$xb^aiW{MCY;piT%TAml>
zXAN6BWHn3v<kSO2J7S{=&V?eXsZ-|Y;z1nI=iLYOp9Lb$Up6TX=~F3Bz4ahPuD}vC
zdPy!%b<ATlM^!?GO8ydl=tM&$mgayYbk?sL9ZE0sipbi9yk2DM+IQ6Y|G7HSSh9Kc
z`fSqK@i$GGj98xgYM_E6&?JqE6dS|IQ>#u?^-K3bXm-tB_Tv~$`qe}dsyMGxe9YnK
zH{pDZH>H5n*9&lj%`PXh1@>R<Cm_kht>x*Lve?hUoymEz*Ep2EH_Xjf39Bt#)jG$w
z88F~?W06%IJ|MA5CtDg+Vrh%k`Egx}=kx9K@<ZTEuQu+8Rt;?ntrGuj08v1L(4rxz
zMR3x-`VVF1pnvbtq`$!uI=TG^K46<l`kfc#Du1IL7*JBo)$ocgamCpvt?MV|V_)J&
z1=w`Tt4g?>to{N|ztTS;(55Yrafo6}aMEYn=>ikv%nfsyrMNK@z~uQ~2v{ok{?sK)
zsajOiT9(lQhNPdqeWKYy{80-0cbL@2m(c*g3|}|cdRR=8cd8h4(-(I%6F;sFH#UrF
za(sJX<ai!4qD$?c#DoYdNSkuLHkPJV2G=xf12Q9)-XGJci(k$wUYAazD`gL1)*nwH
ziG%$EU_#Z88i=#(c|&=Tfl=izlsXa8_`7`?l)AJK*Q+f_g8iCH1DTW@=w3~sD9NoC
zTg0kZ=Yy0))f?!*p7Wk-VL)!kZ<6O(GYxd0w^zzu#+jP^-HG(|9YcUUv!VYYkTrQW
zEkRJ$LlIR&MZ;GkpeL=H%sRI77{yJNSlm&T&^o>f*)z)Qheli1ny0bg)pH^W-O%TG
z<Ec?f398fv&wfl7*tuX1IYIBAJ{CB6&}7s0TD?rUS|B1EtU0x_>MMn@ay*Jk`a&38
z)knz$EsPeMJY0;5ElPO~TB&wFej-zUP}>wPeEYTqMZV7cOw=a9Bz^6}cC~((G8JDI
z!@p(mdb!kYa+186*}+u7KmR$s%Su6_<dGsCcZlC|7LF!8NM8eA1d-E`T5lVeY~lR)
z#$lbI)b7%(AT;R?qrRX8=p6btmiUtQ#ce4qiiDNouV3SA{WMlH)EJrBVe^1=9fv49
z_mUQt7msqMMWIZ-gMaEf036t{a(!`w+bG;@JoJJ~d2%Ly?TkZ`>$MnZxFSu>J)6xI
zAyreta10D7a0$h@&}6u@jw?PKGRX6Tx({$r;`i9-d}HasZUkafbIGjhqr1FM>sa9;
zuivm6HYZ-$9rkqKzJ!u^qyCgwELM%G5Qgo2X6M+y`1>MtjQ2)zTolrbBF8CK4M>hX
zYT$++q<d5T<F&B{OUMCuub-I%=xvTfgj=?S!yk);5FJm%O4u+uUIq%Z%a}L&^i)9K
z-`wk5{9Z?<sh3GigY@SNRJ#=-@anR!B#jXe=6p7Axd(T;hJ6wO7i0Nj)e@;YjSPSU
z#6MDMh;`rtK|nYDxOCZUIwyTLR+`zIICk3n;QpS0C%DcT7bdC``Noxozt)#htyIBc
z7;~B+QOQZHHOqTdPz>a_a3p@B1X}IQoyweE8y?&PXWWO{&SCH_J6YUAgvEso`aj@?
z-fXn|ze)RGr2mzc>Qw@IFr+VNH2W+X?UX3@4_(Q{8L3k)Sud0lejP)9Lao%~9tLcY
zm1WO0N(JSG=o&5d*X`Ee=0Kn5cB~j8MHU}dmiC)()-<5}!GcWRfOV3z^;ZcqIF2_d
z7||0}@m10iTxNQUE~6Hs7uz8J*vmIJMj@o^jJS>rzpY%v7xfC%%7Hz;`9a6aium*=
zMg<q~E;SZO2&OHQ=$AZmL*l6yh2;NmOU!$uPaC5kg9k_vwT5PK2@(1=M&aJa1SP>A
z;H3q)l6D+BN7%BL85S)hjp>{7D~z-KlQU>v^-D9~j)M`fy=FnXiY(AB@NKqHSWUEm
zDl)Ve$CxOR(~$p<9^@FPo8XAPc1gT!KCbVD+%ko20yQM28Y3Uf6??lBi+SyvJ{E`e
z>5(j;g12$q6lqN3Q_-H3nWBAWmagoprO7B9ZKH5gI;7Ve%4BQXLW3Q^w^Xx@m%AUT
zns$}|EA!T4z6NK=-Uu-bLUbWu220+LB5|Xz{ozn~dNJrGtw9yH;u?J>*uI;nj&3Hx
zz&^-B3`<{pfJSf`>m+b9fNHvRS2xQ>SyE?UfLVRNmh@|29tfQ)mCpem9q#rkh{edg
z^8km4v^An+J9yQx=5!A<cW!J%3n1Z{VU}79n|bkY;*$ec`ZEHP+0sWjQ{c*-NNOTg
z^wjT@v;2jN<>ZD8PJ0NCgY3LoVs2a`;^>UD>jUyZnBkKSpylzQh_D1@-bP&o>;*H*
zR5vgLLvy%-C*h(cy5=GOeDLx9@s(9Wu&;h?)W12?j#=&gqh|hW%r#8DO9@`;%R{_!
z^IIYq-U(T*eo+12dK(RvUxn^Pv2)_Xp;kV5?R%V1{tV<a0cYf0N&ZgpSV|LP9X{lz
zLV9#^aVm16^X8TmSmICw*J7awo^7~6#GU&!zF$q!^uPuNps~`TysfCbR7mK2cj?8$
z%Qmpx2;YBX;*S%!M4^|Yx|KD*+wZ<HEkZ*+1jUx>$?F#O!sPen<rpT#GWHYL;5g#1
zmhCi<xHKe{#6@%dsX0|wZ>>(s@f|Z>Y~W7`5=B=g%l{jAdAjzG#VEv+j0j(Em_4XC
zBJBr4U(1mW$Y1hM!!1MtW=rAX{y;jqWY|yj10fC`sqoR}LyOi)nFFa885-D}riQ&2
zAO&GqBNAPR_Ycr+$nU;iA6>_T0kx~!@7<v!Pu+graU|fsDppg@gM7dz!ha}b`!}ct
zQgxEpY_zUe9t*xTYq9hc9G&FzUC-=?JDvAkcig=TFmnXDHOBg5Sh^KJh0tRW9_&@a
z%{Bl*K)$~@!qg}FOk-JA|9-57fQ<X%Z<kec>e2%d;IfYS3oh-Ran6cF(*N^>hq}-4
zm`Cq6hSEr*Pzofhuy3~vVs$&C#r+Kr?z_8Np<^piS&qgPZl?+NMFxT3>c*hodb|G;
zI{iS2xdB`=HjG<#-+aWEyE7mmb{OE%h7K>tYYkKPr+=9wyJv~ZED{*%v-`TY8mB%J
z{dt_`)v#A1w5Vwe8`_q{s|)?USiyW%b40HNtVRrjXl;`x;kDun)Hhhk-an>acwWL>
z&dXEKCP6~sa=3*J9Kx}}=aG~Efk2h}-RXo1R(2F-gDD%<72sYG5W{b?f%Qq6|9t3i
zIhg|dvj#P)96EKk2z^Qz^h{3U#>EN_Lse4e!y|g`pDYnTUdrQ-fO(bD^!6m2%Q|ee
zaSCD%6i@c}G`}rwxpY$*Lk#vhd6;?>q}_mzAiV`0w&dT_CSRUS&cWmGh%YxKeI?EU
zowo>W?vAvbTq@kvwHS&V*hBZ}hwrMGLL3<~nLf7J-y1MbqMK#<S3<a8={_GQv&cT7
zO(SCuT--Cq9()wriX2BsZuYX^&C$!QR5u|J%Z+U-_yyw_jde=l!@&!`8{O&^BW|UZ
zB~-hkLF|x)v$&_3O9Shb;A-k=HS@SwpS{H4B{UJ7Aki>6_Fd{WC45Owz`SY!9=3gO
zYR*!)8Bhq+Ta{|i1^fi?g$c7g3Y<E3J{lr=8%_?ARAqv#&261!zgmM4h0znM$2*B;
z7VpBxG=qr;r;vQ#{r3;_WBQ^H5F?9FZiIq+RD69d&F4ibU*V1e#i8T)?q5fM-8XFk
z@R2%n23rL2?)_eI5k>4ssmx{DVWO%v2YQ8eCw*hM|A&v6;roTexx^~^=ZhMh=eJa!
zCD_-^oNdY{=|z&Wf0+gC2x8jdu)pnOod(}~o@!f9-X>75=oy>WPoMOjPZr~()>f#&
zbZcDaf@><O)XJUV-1iT5`IYB7HF!?v!Cyig#Ybn@)n#7rxN6+5Q;t6}O3#W$K3mv`
z)0W_}wPn_Pa;L&kQH|)UI3&nc?pA$WIj79HMyX#~n(%pIthXr6=!Q!Mn2pog^8K#j
zkYx=(yt2)TG7OT!6a%gclmB{*(6MY>L`KD})u-*hkfP~Sg1#oW#t@n;c5XPimw~Tb
z%B>fDrEYWZ|21fjb?sno^3X8or}8_!ZYZoo8>1;!a3ejUuUAcsb709fGOCMC_A!@Q
zcZ(wv7n!Q`Wc6qQ2WxDLhwxUc3q-|1dW6)T&cOb|>TqWy1(OjK*G*axI5#;av`0n-
zln6_MA?Yye0V;!ap%SdtYTRfM^}F#>b**^0VHZ6USKNiYwM09W0oZ8pDI+1^Qt<5e
zl3zWZ!@keIt(N&#DZl$GpRy=Y3>k$MUg#}8BniNqyEtNGS)ZOX3h^cRag`wo?;!a5
zL|`3GcsTXz41a@@tT@%y+gj=jZ}v0Mj*sYB9FKrOF0-1G>$G8(Ljwmfp5ly^cK;JX
zU&&9kmV}tPo}}N>!<Y>r5fCe8@U-{k9ffE>mVL5)SN9j$=oQ)~W3b-1Czu9yR3uQ>
z0w|UwFh%uC)L*dhE7h`h$=L)aAiXSrNF%f|YJ@(c*E*WwF;9C09v-U|Un8rbC@s8Q
zv+h{zcG~zxA2k3AWT7%mDz+)yQQoK3@>#iTO0}v!#Gic!F{qg-MuWL5KB_cchfwq~
zLg3w}<pe(JErQ->Vf5Q!LIt@G^*?KQpz&bZ1qS5jA81u`_F6=u5*Q3a#XAyg;!A&1
zbG$3%GyS(pphSsrYu9TQ5a}KW2=ux*l+;{Zw|<`V?Qx|7=EH9Xw~bjq&FG`8^d-B2
zxafN1gn5kzfB8qi>h8|XQPVt&o7QE*?H~hBb~ijg6(rm^dRjvt+mR}_bp2&##lME3
z{EP}-E46TF9UYKQn=P~?-K79Wd~+lZDe0~WW(JhmGD_0AuPk|!A)fLgEkqW-V@0Bg
z9(kXf!L$Dj-h)D14(n9A9~nT5r16xEc{|gt^-aso{0dI8Kjd+ib=x2E$WC<BMRh-F
z^f!+w*M>wCu2)aEw5^OPr3MM=I3GK#2H9<ef!o|f%Q}$iFpdG3&Ek51T0rub4V0h2
z%yq~pvm+y~b^|UX{Av6CIz6Bnz4f70N9LFPS(SW9+%X-z#OEE9QBo-59fJ{)p@_2w
zNoWbawy3o)Kr50}hR?3~nB1-?(BA(94p+z{4}r1ddngb3S_7Wg?28m423)f#i}z!z
z{!oaokQ|MrOB`|3bmd6KJo=O6%^r_rttkde%NckTCl?$&h14SVXw)MlMRmZDR}fJ0
zIIvNs|J>!DK{W=Yx{Z$im+7c2Rdf|AtYL9?+)U8B6&5^m4pqGRt#2IiU_a_$49ew$
zKnaVwU-ppeaO%8ZQgKCU+K>l%16%r}PZ<e`7oo5^Z)&9KT>rnNAGy*PF+bFbYmcGb
zKe|`}Au}6|b5;5A6Ut9wLuqMS>|~hJQGCAL(!`-^ze&ZJsWwT3cb*N5^1ZXV0n9J7
zL8^U$yUO+UC=h4FINzYY8HWyB6EJ~(O!W`|6c<6`e3_~3hIc4xY*jJGAR_M`MlsNE
z@=i#QiHfM|nCtr~q7x4<re1-3Ltv@fu8~C+1i#=tAY+|IdkPd_Bqlfl?Ppz$4H@BR
zEZhzJXhp1?K)KWT+Su4}7Ant%-st<|fMT+x8D)vv3~qbD+<^tsvDYjlBH9|rPee#j
zy44khz^k<&3UL;Mv)0i+rOZEFi(|-41;7r8cn0{1-!SReGL01m6zR0L5|%r7EC?2X
z9NBL7<EuuTNYp_4@PZST*&J{Jd#`m|RlPI<y|t$^M?e{&;t=`t^K78%stLl|MZRn%
zjy`OpcW)g0%sLwx?Y~-e(RMX`eP4QX?mONWl>QuR4hL9)4xhbsy-PxsmRT!6v2%>V
zWb+4;uv2R9fj+qJZs!|#b+Mv@+u>Gvh<UL;;Cl&26?)%Kr!zb2MNlxNp+0v&lUDR`
zzz~-a9cWwdZB8_AW?j3gue^y2{Q}g>r%6_D7OmR2u)Ss*4zerqBe95uVqQzJ$xu`A
z2#W!$b47AXCYqU71V}<buk!5!b@%Nr=Xvm1XQz?ayp)(svWtO(w-0?2wu_j>fIjOG
z7b;ajD25@r{O2>pnP~qDG}PE|ZDpPfTaQ1bj4i*eF?yLeJnWcaFqvjyZ#p|p9fp=!
zn9to93fU+BiS<z~dWu^p!(G5hpxx^_v6(;li`FDPE&1|8{@lX&I4p)E23d8l1FtYF
zWcsdmaBH)PV>&pmw6((LpPNXSvbTVI$>SS!HL@?qlCpp7W&8G)Py?~btIhkoh32Li
z{;mPZ_im~=(cBTXAMqi#HVlNm;>*M#2DIw21G`aYIunZmRuT<Q(UY9J8z6kVW_#J^
z!T)`c8HPtCh7BzmDEdxNy9op#7=wK1*dr&c=yH+$h2EXxWte-Rkl#^#SkWTjcd*oK
zwYFmlsY9>rRy`~WpClG&>5}Hks0?9xAqpMYwS;jKX^?^6K8fn=pgv68rq0COa7l}g
zOLu;`l+52}2rB<9Ko|e7KXM`^sEkxBdVQ75pa^3xy>#`d(75D~KUeY{*YRgN=aM};
zPy$(tM@+}i0wI=2*ZsoU+}XzU1xK1vOHZijwW?2S%xHzyQm>Xm0hEn9fAb6=r6D-g
z%ah`?&*CK6{05u<mJO3ta}IB&yE^j)zCWAJ-yN`?&KGZkY$L%QlLkT-5aj681;QdB
zz6nz>cwvGm`{mgIl2Z5iEM5!GmDlUw6nYYVR5p!huH9o0<HcFt=CsoWC<Pbkf;QrB
zUN+@Bkir11qmVAtndo<wT=-tea0rOax_WBEUgw@E0ZZR`Hqqx+X=tA31qDf}QUT-Q
zbiw&Ke*XA_|7%NsqHuP|`55GbDxXX6J4;Zv+g*eFPQsFB8f|7V?uJzcR5S*lESqW4
zY~%_ne&PhuOBJnPS5jaa1LVNy9>OH@n=R7Y8Q#$f+|(jEhTZO&n!T3V9Xgtbl}UOZ
zAqzfD(zK-ZaluNVN5h}!x-ztT8?r?o9n#CbDBEIE86fU=mi~KL@=%f?KUmQ!qMg>M
zQEu3Spx!xhk`Fs7m605hmz|D6Ib}X<XYcaG?yE#gidRI!5_I7~h@*!@eX^~nN8rY}
z9r;-pgGabWeowI~)jW!>gb^LX*KgbG>nHj1_lPhYbSp73i27CeV5OcKTvM9gj_fE`
z(}eX)yXuctN#4N=FrUL5F8ww<)XgaJqMqr}oA6Fr9tLL<NXxw$C_LJ(JHd<%bRqgQ
zC};w@bArtdL8w+hS1_jUqWRt7=tY<-qF~JW2)WC%$SG1XFz1Ii?zT}~BG`BDVAMg4
zXIuK*^j*EDkjcx%7w3^=bb^AO*&k}pd!7Ldm5h%V0OkN8T?kY>WLNJ*AakIRy2tNJ
zOJ6|J#vTD__w&}B9q9*(Uh%vN9MDAARFZ|psB&hIgAK41FTqw!e&2Sy*^(V+^pGoI
zm6jyPZupmW7JL5kR^8uw@d+dUn-6nhMT{%lMe`THHLg*+*XR{}yRT;^b-`{qjd1A%
z%U!DRvV<n&v+@m7TMaVLVloGptWI0&a-(FLSPA@F8A^ymS($1;Ef%@2Pzf3mt%4qT
zc+f*Xga2{E5p<HPL@yq-{E#i``H5Ia26@)UC^$;)37^eW$io&oN6EubR&!$bz<9lg
z?sB&;nt;igH-mAbp+%74zGD4(r}C(sSPAg`sxQ~Q!~$0eG%iuvvb~odslKXfHsr%>
zfZ02*FZqG!VlcbkUG@4?zb{(6P}p-AiqcBUES(w%&2@Vc0EPO2Y;Rwi9F=YKsbFl8
z#kwqg%08JCrM*`y+IN=5_wN8TKG-UIVAFNFoAV^{>AbSN;kI;!D<QT23*x?{d_g@q
z=BP2#8CDZyT&Qg`zVLUX#p_I{>k>4E@ojSEaAKkX?a>{dw&pu6pvbzD&nP4uF#)EY
zy1wQXti5UrVgl3+J83wKQuqIg!_Blhu&_PM7H<fXy;zQ%W7!)ZWnF9XA)qnA{&mF@
zJc>WuWn_jitu*pLxL9HOAl7NW@!IEr#m#rdeaV3-WR0&VZ>?Pf3Yi%gRG{6&WqCks
zf>UNJm{#as&mkG}RIKs233=zRW0qZ2!J-vI1h?N!<&{%5=uj}&!u*J3G!Pg)5bc1u
zd|&Z{SIW>pew;YSxLIt<Xfk52OKud*3B<<;gx4BZilRU`g@5kqIWd~XFz`2X{c3}o
z1|)+Lwl9yLWu6C`00xRNUUo5BYU0vMptu`LWSD#KqePHJ#iXJ=Z8cCRDGuBUQk!ow
z1?LTIIbknALSh!-N!HInDw-X(sv|HwBc~rEFPGM$w)0_VCo#s=nR<*}rupOh2ZbV1
zIsKD)H6|ArTadluNaB%*at9H(Tg|JN>MbC0DBQ*OUdxek2X=iRmqH&$KB5D>hZI$)
zBFHtjAh0UAU@KgY5_(c(j2mJqb^d?JTlR56v3ajSmV11AOu4_S=$``v`@OIqQP1)f
zH;R_Id9g>LEQ8#~DdqU-x*r2z=H%7(Z<+EY6uuBKG$<8rU8BXIjN(k&)llpr+i0m<
za_V+#-caSbPz|^FWH=o*e4qS*cG&caMEzYPu#I@8ZV$F6TnX@A0=AyYVk*(l{$I)b
zu%rwWWae$QdIC8}BdfyTUV5m9XrR;<Bm<V8A?>54r`XYm3#n;$Y~ih>JC;g8Cbhwb
zcFMN)`hu|Djig&ZXP4h_jLwFB+c#-1IV%w&+ecBv8tfrp%Y!$Fz`_T?l&LYE45e@d
z(-GI)rS~&*;pY|C!v<Hq6N%u-aWN0)ym?bTU>q7vsJBc}tN&<K`$%1gnVhMD;Z9_A
zr>+lF$ik&KYCt3$(gAZI0cbM6_?Z5BLU+&e;k&Z(s4e*SU$!sOE{bi7#bpin<4TZh
zBmirKU^NmWJmnQyMJze-Jd0}5&T>@G4Cd?ktr$k85C=<YpM+C!$~wh*Ry_-hQ<U2l
z!aUZkOiNG4a5)OY(s3qzjIZ84)F4-IEB5rwvF^T_2~1__60TW?OvkuN0tH+^>`V4&
z9RYZrI9VwEB?#cGgSNRc{$M|>cu`uIvMzDsKnh$!oE)GIDz>e>!$9jn`FKWi!*qq7
zH`TEIXrMe$E-0IL{JQ<6afsGRF(WIf^5mAp$bSV)UK$%!<N8N^6q5HB;DLDe(=S=b
z47ZC`30Y4br_zY7;DPM$)u&JS^`4LYp@%a}3$UQ>zpshq(TkSoTyqRHF{5T&A1=B_
z`vEsq6bS2`fbpuy(OA!wpB+*+$ve?o=ZZlVD_dJ_ZWr<ZhxsBctwSEyLfX$JxB$lL
z-XF+*90;8;b+OCE0guVlG0hNkKGQM({j-EDw=n9EiKR_^RzMl?7;l;E0Q|J@suU5K
zVSJT8iVj-b`uLF}s*G5;5K#7o{hBYRTsE+FyMDeh5}zYVm2WtHqj2~D(W_a>Z;09L
z0Qb8vYf|TKAF&~5(Plpoh_5$xP?0?zl?A>mO}avl9L&R1K%0dT;3r{k(;DtR^|7=)
zgDDoiD}3u?ZXsCz@>TLeW{sO5Re&6)31jZc$cK0A6he*FOh6xKV2Kob*C>=j>?4Kh
z=^r=n6xU@qs!`e!p=V~FA0+4%h%K?TZb?4&u-lBqNH@#dF-z&avLD}@Bwn5F9}c>5
z*_CiQ)FT2#(RKdqqeAH?ND>ByB4%QIs5z%Ros7RE8*57Yn)A~qaEiEQv-IlRO5Zx6
zw2aEP2I&H9i$+n0?=BOwT3VC<X(x$I2vf;wGl20+9^}|*#>;{*Vs3nuQVIo8+@AUi
zzNj7JQ;O$dC^KB16t}1++Wcphuc+ngx)CsO)t67y>h?q}6ZtTA67kf+$>^#U^g`#M
z`uZom+xgvc{;ynP$c%4??~slKb7@)|k{A^KRlM^1VcUM}*-@Ag0_XK036ow11%g;m
z?Vz&7Mh5$lB{#3Dh`<PxoQ-3tAxwO<Olmnu7LnA2LPS-|V33X2xd<{b34+NeWntLT
zO9aw2LIP)Q;!NTIy(8N>H{zQSicJ5Lr+F5Tu2MSv(>!<AXL$8!_mKLBWl1E@a8TW`
zZ2#>sT!JHWY~`>{$%rn6_pA>`*=Bkg@mt`|z)qODEE>-?<Y)*jPw3d7+?pz{pU~wR
z!|e-sfaF}+mh<;8YFp_%1m)&ha&BrT|M|Y9TKLkQakeK85<-xb3(R{&1Cz`7{;^p4
zq90Te1RJz5-3vuqoMcvF;WoC*Pl++I-u$-wPbBJu1Ph2sLukAP)!RNYK5`66QuMrM
z+w>;ta>_fd%;W4zq9Ps7v`kHuMi<03J589fFG>^!!VR(X;$Br9=df@peL6wz^1yJZ
zs|b@K=ymFKQ1FSZ)jAFD^u$p>VmxZ&>pLZ7H~Zts9~uo;xReYTEg2tLx1owJ^J!kj
zwZFZo1avHsu++(L!)lHRh^pJgkzWW#W>S;yFqGGc+s0tBv@N<~wO9H>W-1^Su5e92
ztO#xQ=wLg#0YyhGwe=&_xxVUQM;gd_@709A^bL*GQ&7~N@5W=qC6V$@ls{Wo5{Zqk
zX+bD_j3~DYt8dGW0gh<4gY*fy*2%zW%0g7<v(@z)gK<-u)Yq&*(<GMcGbgatf0I5a
zKjYXA@kl%w0_h}oCzT}wv;U@rdmhfV^Y}6_P+YPkk6l~0Z-;^AcqdQsN;C`teA3m=
zGWG$U>JhK%T90-#b%O4NG8;%vXN~drT$i-sfHlabZ8!CYe1n0Ee-LU^mQMaK4Kj_*
z_1E-d0hHO-pt^|Hv_sKq3dm-Q%Zb<H@sl#sYjE<C>+h_oVt={#&8>4@5q5_bgGGLf
z4ux?WB~@U9^n}f;Kw&}}&!Z91zv>B3haCxS{K2DVh+03&-dRgmcp+=|MF{cyE)T#i
zF(jxW*sddyz3z3EB3PEtA|DeZO3PNK7@P7!yf!!~+SSztM&!ubfsv)#!erMTPUN`n
zyNG*PhtZH5S~NJhB&0ljqVMA&UUUI9)kS5K)ZuRa_X-?!0?nCZI0r0!RF?VIi*u)v
zWTob4*}_{M^(|H_U4Hfw<GnY6g2;d<i=G`Y3={_HZ=~&sf#_e%`=(ZLSR@Uqh`pO~
z{Q7emCg;eXUzHXLnWdyY(;1)0LRLvO1DW3XZ|4r^&p^~oz@?%g7Gl$I_Y|gTlHU+-
zP-jk$B0bMtu|T1p3#J-M^XW`mxfOYfq$&HwTnP>S{Ubd&QFHb|DAkr=cY60#3<dW0
zS?fYAWuSGvIjh8zvnFza>poTgGdY?1*?IGPzb6GPcNnOFx|aX+{shkPOynF=EE^(~
zZ~qJoiQ%S-IdL3iBlUto@jliyV2}(M@Jl2n-TG>$zig1tk>bg2onn_0V>-&t$YD1`
z%NQv$kHo@Dy4JSbW4h}>0A`hGcY5+sPPkY{b>I17xXiKm)M*s9MWL~z&98o<gdhO=
znJ}rZ8WC`|9(P5Bmwu{;YA^0lfef-uLJvrOZBz9a_5bHpRKJvmBw&APow!&GiZT`|
zpTNLD3*dkShb16D0%n__vpFX#4(YgmAxBMzC32dhX!HEHQM?wld(XrH#Ks$bXSyb6
zW>6x#=q!U{q8>Xdp7?O^usi3Npckg{xG0z|S8d{1?(fFfP@pD@Fq@qRlLbB3-4<#f
zGLj`}f*i<M8+B#HSi=nyYbOnm+iReYGUuz6gE}8_ccCM2V^a@@kle4Jzib9qqRUtP
zDt7MN*CD-3I|!tHX}=RlP<-H82&DLcB7v!^Z^&;?$lN^fMFDhs*pDg{cK{C$QEu<8
z1Gk<Ba}a`swfGV(b7?#(OaDt8Wzd(n(KT%6#9UW&tyjZ@6%^VR#BsgiDPxR&3)DuD
zRWbB>=$d3kAF0~zBI!6*M_Esq*wappCZaW_JgknfGiCUs?XwPo0Xux&);1jU6cX$#
zmu@8o_`h@8*gozE#4jlwddkq%Hkf^5VE}g4BMdmyU?S5V_DguaE#3R{3yvldt)9w#
zZq5-_SOa<X(U!Nd>=p)=>#;(mFD3$9&pU|Dyz=ygadIg}U-6%t2jR-w_)LXlA5Q?7
z?r$ET1IO)sKTW!{p25HAvvqXDBo4#FjM`r3lgK73oX?;usHi<*0_6o^%PR)8yKONe
z^hQ#!1n;TQ)LkN9x@;8CH`OVO;zQyiQ@AfCR0T>s#8Jv4$?8{W<}-L5>QKxv@qscP
z$ESP;hdeHn6(A!3qvudRpXMq>bIT|d35Tz3X61;fj-Z^LY7S_FsO-}copqY#t;Puy
z>!(!121#eJ>@yp*txG<}qbVeK%(f1!xL~Uy_&war&#}2FA<X$=fVRWtlc+5%VU;@9
zZuzMCdWcwnvU8Abgc`n2C?=yLJa4j3lFhKrws=ppc#ZInHnNs4b0N=$L_(Z#A)XJW
zE3edSbOEHE!upJnS;xKu{8g*y4<6{UKE_lw4efWW8$~QqjQ9`4Y@Uqc+}e^*ZhA`N
zk_@kNM^evf_Q*N&+Op|p``c{3z7>e`BuM)=`JR0kNw)x*3FSM4Hb*ys?Se5it-+Q=
zUj0q0?NN7JZ~z>4!u=SjQWsj?m{r)tZ6pt0WsUy7T{hG^vT(Yi2f_)kg>AD0=GxiT
zINl?v#8#Q<uM?AhC4G013q~YkGRbNzma~^KyWf}c`@>1pQOOA@kElQlOMz{VgzHE}
zP{VFwz^~PCB6=)u!sJcRH&h3;>uWniU<*E4Fle(@T_c5ngAcO$g(1Q1g;?>E&tH-C
zq8yeFeqvjNKZ2BkuH%aB&6&_7>T!NYgD!fcef12iF50flk70-h^>p!ko5ZGM-}CIm
z7Efq+^Q$Bqps58(TVYEZRbnmS4)7CFF#-p+j30ZQFa~RtxI{!@%-JX>S~0Hf9LTN!
zq`qyIk?vQqbQ~>6^WV@s7V+#8L8>_Y8Ul?JLxd8LDW#+?=H?EEsZ9WB6*^J6Fglxx
zj=wXd?q^;o)K~#_B^{S(ae0qQ#erWSE^H~G9egRBuxz(lsC+ATW9({&nPL&kWB~i1
zJaY^zjE@|H^DTV@UKV7CjVO%uob~C?uUOaVa?R=q_)a3;M!f*v&fnKC0Oy6pxHq}q
zG7!=pYM+2Fl#J=e?OIXa(jo1c9;j33&(faN|3YyYVC>$^M~oGg!)n`N>LeL!=mMoi
zLzJxFFL;pIYPL?*5Y<Rrs)~>ZSE0r|C$kYKGuFI0*r=*2NkDmK&iAbb?4v}hTA%i=
zkh3qk(70dTkpm9?b(mL^J)Ko-U(6kj^kb9dQpCkSt9O6uj*jfGU~tc6PSqbJI|CbG
zdfAiJkd-Tj)0-2__q8m)t_qz&YE`=@^Xge>^>@J&kn;~&C?R<q6qE^={uOPwa<{;m
zRBHn1kQ^Lw#>g=u@1Az#WK8pz>be)9I<D~d!#K~OzJOjwZKtm%2SGA4<Ww<nb1p0F
zlfhU%5%c>f{JAn}|0>J4c2lrWaP~rx@(4k&hs2N|<A7BO`;EO6a1-khU``|VAP|G?
zS=Pr7e>*=+<iE15`<q8zFh_lAVc5ET`$*KxkR(oc-*dcoNx%nv+DVs4WmLAIF#)D&
z`YR`(cRY^1QnfApOatRo#8rU)dpe8j6mE8^r`e!Qem1MVmk2&^nC`a+>N{gHVfWbz
z%2@w7-t<-2nuvUq{hg_gY)Dt}CalonAamf>ZSgk_EH$W1%Kv<QY`Q<hxO9^iR5xi_
zE<O@Q0qvw}2YpOUwY`vckpBkZ^XAa}U%&IGVY0r)%?nWp-Wh6Q0RMtL7*9<da)13H
zWj=9l{V3zvnmBAaVqpO5(e#$L_cSPrV+9?DEELt)6JY|@PyZH~9~PsIU`1)+9@ioB
zRV6L~w6aVH*VR*ArqgOr88Sg+8uMt`zB(Em2VWOOp0+ILo$F}7jkq0i=&U%HZHKtv
ze<r6F+=fq3$NT$EafD)p)i+Y><2`2-M9~tR!b{PT+0ADq2WZ(|eH$Rv9Nm*&(lGt8
zB~g3GyM%yE#8}2PnAOFAe7A_0r60a}<PX7j%rD|H;7rQPyQP%MEg;sOGy^V<ZDEVL
z9Q`{Xt{EH)7MRuIo#9YKI#!NZ_pl3S!~fm+TmC0kfw5i69bEU_v0w>o%V;D7uxvJ)
z%dQOG)ogT<{?|jq6_Pz-Y(J=es0U26a8TJwozDvBX;cqR0tMs&sk$>bu)EpdVP3W=
z^DTrJfi)1$HUT%Gphd*5U?9}3^K<-M(XE-*I*}z0vvYtw>7vQf)&<iJ$(IYRO7y#A
z?pRH71ovp+nOc13#&rPpnkxpJqZ*m0yIL^!btsJ1XarcV>rA1oKV2zC&}46@-rPMh
ze9JUqY-Ta-b{D!|C+$6ueCWf$nEQ5oswouMl38V`f#GDK&}_*<b2N|nO8Vh-@V>f9
z+3#o-D*Vm#ddtkMm{$%Iw0q0bU)ZYAWI{^;JlTn5?>)e;({{v#b{*h+z+7NUgOeJ+
zV>`T*y6yDQA|V{~YBh*R$2Sy|_Dr?0y_af8pz$O{+fArlGaDgAM<q$)JQJR;l$P8^
zWlbSf7$GXjSJeRr??*~>Um+OmjpVv^QMjf;wd|1r9`s}f%2Xz6YT;`0YQxv3oN5d9
z;Iflf0&}B_FTmCfA|s^3uAs4PO68)L7@<nLU{C&v9VT;+AudfT%I2^va6;t$Ya%PQ
zcm&*d@qR-I`|3EIN?>s;hPcS?pKdw`lM$)siC5we)CR|th@Q`Cu%RdO1h}UQ<7#Jl
z53z;n3dwZGMKxm-mE{rFCWLH`<yCMsb4AK6*V30S<V|Xe|3=&bvs~$vdPy=cSq%|C
zQRvsrysqIS!Xg*Xqk+l?!~6_)@wPSL7ETyWoZ}yuQmg#zOX(2~^KS@q1vWSo5jsg%
zyC*eS?}RHOCh2PkVzSU_xsH+!zJE2r-DmH~i3F;jBr1%dNJ#p55;kF2!;ra@Lh4B<
z9<LYoM&`w-$VRi#BNREJC{5FTxyAeM3VLLALGk<(pUd75%hlsD)n;DcMN9tXyGi;P
zWX5DaUXF&})N1`B!+3}_fw2Qi7T5_7z~5+}AMphh6MbG4j{rdOzK1GLZ<l_1Nm;Rv
zf3e1978asZ>*K<I2~!i?vWJpuzgknNgcVMk6e60<%~zk4WaBbk23JEtOCCNtk5tzm
z*Gklz&3TPG@L&w=otDUu{4;d&j&C%R;{7@FloJ=IXfqC&Hu$gW5TzXbp~}UI#np9<
zxHLIEYG-bOnAD6eL846L{2d8*7$7gim~2;zL;xUELVw>Xf;w+)5Jn3f(E)zkREWu*
zOQJDkCk7(4&&1xjeAhAA+#B+Sq$?pc&G=A=)qi8c$S-{ohzEQCG*Gkk6AYhgMQA%v
zZd-z4!7Y=Z2I!p1-)D5)#P=U>6ic0F5ijSHzFFAg@*Aa9jVYhOHqEWV{{MdIwK(1W
zqafkxCi@N$Ma$+}j8`#FWll!+UU{RiR|WrHWO3*8EM!tWv1=-Pri&EMGjiZU#QO1y
zbYUCAH_kexjEef!%L$cL2gb)M@pzOY)y)-=cp~g!&M%7btHDb(|DP*I!3n6th%xB5
zIO*DrBvXo1)A<a<ryg)0ukBqRIXhKGHCtgc89_F@>@LvVYtVM8(5Wi3ZwD&Bl~#|V
zQ|3MOM{BIDwX$$alVP{aW5xBUcB#Jg8b2BjGVQKzwT{XKF0hMj|399FoYT+Ag%dgV
zHJ}Ad^|@356_$>VV|%+|5H&UtOLxg)+F4hw!B(76n6FFGcdP&)Ge9EqM%LgC9BRs4
ztEtf}xegYTAAog(%Zes;xN@YTgv+;r5zDU%_893!tmPnx|Ln@+8*ZNnvpg<8@Su%v
zbhxc)Ss*#i<m<%EiVizQNe4^2k5<!n)25<Q>=Y+Chx$I$x{-(xD=E$8sH~9?ZL-BQ
zlTVo9`juB_M+#UNsWEew9<?3jW+_cbtIIB-@Y=<fV4~C}3;Av|e+-P1wKL!~HDTCn
zpRD3&YI{eog=a=~pj5ex6`948yRep@AlFbDb{BPPH}nKG)47?m^1?Z9M}_t~Y4uqj
zYA=K#3Ay;Ly}p&IY*@*g-M&_JIg4$>Dd`-c)0Y3?#uC*Ic6>{4>&OC>bJPyj%68`g
z%@bQWN$<=?k<f`!>P(&Cv9k*poIsu{ix6}DqkiGId=v;?vOS9-t5lYfXa8@}b_I+K
z`ZyHyRz%P>@MP2|Z<=b1+<rI~U1j%~8DaNb^a;qlHHOQkuAL^DDj85vSll*gK<}7!
zzc9GPMZH85jIh1nJR{iiHFI3kqyhgd$EG>rSCVFH4_PGz%~H`!IkYK{-?Vp(ED5LO
zo}-R!q|>L!sSLuBSE=qhg{Zuu$PgN^q?73<)K@oOHmd=IlhbW?t~eyfQ<^IKrF%&u
zMzBFi@RO?=2hF(Gvj^P>)9AB=q##|q<y!7)5ZicDA#k#L$4d+YkvyGd4C&2`nE-6x
z3+l07>+{0tmJ8f@rg(Q8>%f4j=*&$w-GQfYmXCG5UNuTZW|@k=6=v3kDK_FzJrW~E
zP!H#hg`@SqDrs`9j`y~I_-5I}Oep!h2!xdXQVExZnM{Euq5`qUHa{DayNxKf52NC}
zOROxxLp9T4jkL13f(VyEY&C<1T-3FXhPaVyC^Ij<J?zum=B<4FUV7J-)b9^<$k#eF
zS!k+c^wDAc112O3!{*WQsiiaM$SFUB=MVt7cl#Y2X&Tmqyj5X4sWw~ZP9`H9YQEy!
zH+CG_N6~7rzt4km<5PLaFqMP2f;~eb@F}CM8!|#?T+P*$30`Sv+8~}DxYJO1@0YUW
zD<;fyBsn-96q{^Tq)}p#Kh}&q*+$KkP!H_i;5C^A`(f+!lft{IGd<?s9m2H0H!+I`
zP?j_SmvYZI2c+&z$LH!CSTE86_|j;v;Z%YWF?alcAnOceh%Up{t>g%0@mSAmjq`7L
zszkj}48CdUBMR~!-AXR#9VZfzpHeWRci=K}t5KTZTHs!aE}tiMsTLi$Y78WD7ZQ#e
zKs5?+_`4ncuJti)M5^+l;W8!)2x_AMdkD1h9`*>oX=d%QiXYz?VJ((t+n{Y7yiTQc
z8n(1jy{!Py<P$V*_s<Sre9d`x<i@g2LK_NK$1Li;nRj`GLmp;QM`=r>Sl=R?Fvt2)
z#32~V<zzPk@cFH)Izt7ntk3rRYT#f*8%fwH4GIC37FKS1bdkian<xs|^~R(vE5Tw5
z$=<#IHA8sLdgTBm1stxDkc=p(S5IEH=D&D-kfCxg|9-`5T<W8J?=&H&RvUB9_hQ)O
z(dLbTM8vdhy_Z5U7%l}`IvW{;4QO)^x;bdG`88#nG(|jXh}KsIJObDDH8hmMc%)`v
z@p2r98c7a!)I}n;W}`Pa1v&?2jw~Fcsp8~$Xl>B7XXAXWIhU6&OEV0F=B$P}*FrrG
z4HoY#7-JDYEpPqPTnTgVcGh~5Z5(+3M2VY0o3M^f48Um>xRjSvw06SKK|7;|Bquo@
z%s+acSYS)kqF=dRH?bj0zh4yfb5Q505VZs69~D^Ykm}|1DcVB|<!dy3z|^<E|5+C?
z3k|k`A#vXm3)Ks1jAywzhH^6<{W)?-Pm8yvC=%pf`UvmWriPrG?wjigzSrh6z|!fG
zL<m|tRI=)>Wqk_d+jolNfQ0dzc`t`zy3P1tyMx=Ad`u?E{i-R?Ty!|ef>0)sSlf>w
z5hg$#`0P)fH|0t5`jGnMS^m!O1J&UQ)#m?ZPlCzwHa6Bj!8xO_z2wQ>;X0Xgmsp41
zmke0~C5}7prT0NR8(Ny(&|(EM*8e0ht2qP9YL?P-YSUayb`6O~X&dWt3URwGG?SR4
z2EaqA1EJEiO`Pc$^UH6yeUQmyUwB8>|MTTH!J+vSB<yad`)M9Ad$i)3(gz?7)`Bs|
zwg0a{KdMbGV6@+bYeUUO1r;0PB309*&GCAM1os9Li%LB6suMe-zcA*L-SQo@b;YQD
zJ2v1wEnv-5tRVIO$}f~bKOd9}fi_Mox8@0KT){|iCp66{CI-riMD+oAi|iq?#njNY
zW9ObO>sg1H7Fra6>i7TVaTA&QL(f<r%4CNH&oZ3c0V<=IreKR%D&DxoI@gQ}K}m2c
z+h|L#lgTZUB*mWXYf+4#i)25lm+7?6_*5kD!^(q>chpwfmipWDCI*n*n|!E{V@rPo
zYe2do={COhaPSkZh~kWF%Kv{y=3Urya0(cz?I%h&hFS<?tId=RaeW>YqQ(=g>=(eI
z&h`eW?Fj+yi?=UL56Yu)9KF-;>FR#gF3#Mt4XO736IT&S{9>VZ#|`(lFmdp^I%+b9
zq$J<GLsmVcz^hf7MrfO2mJ6`?jNI!_v~o48y3zG8!=6BRYr-8gJRc|>=N2f9Kf){-
zR%abh=iSLVWsFe@`jvOlVD}?*QtaG)(m(~VP|ut5P%}C#&(~RNJzPfuaJA9AeUDFW
zPAP)oQZH)Ihj2y2_aH#g4D&$eBVum)l?J|>?@}UMx)fYc()H5>ug}^b9>0SFPrZ%w
zhmN299v2A{vBne6d9%Lv%%WRvw<Eu%=JI9!4toyR7nSK*NaXseW#6fI0zIDQrU78g
zM&<N+Q36DfFn>Oemh&jC_Nab-o&Nv*1tKp2Ft}#xoU53Qoy?d+A1*G5@TlvraUi}|
zyVIBfoh!BT+9a{x%VMpTk<>Mrpee?jtu;+0{y@hSFaGnL<yFFnbIqnqzhqlVaOD^z
zZ$_ObnwB*ke3J8_0^P<~;pIle((s9rVy#a85<BL2Sd&O=jDjU2M?{mjjdr5rFbxMX
z2ow!{?N-b^gw&88!M5v<)*FfR;-0a5Z$@Y{nvP`z^j!%#T`5b}9h`!0&;@5}EL0jo
zaF%L2lLnNJWhp(al1z=})4eYb$@C0^;m)<tXWh<qcc2*YwI5jfUBwWuz%G1(myM#O
zt5<rFjD%^Z)@?bzOLn5`ZdAYa{j=Q%7<I|3vFmrApL#v8VeJKIG|j&vC=QS?fR>1C
z=j?{j<<mh`xNfi?MHYEnvl0z6_;hco8h`P-y=XyX)C>dNddVkH-1n5;lrrU1((0$T
z<4BQ$g2%_`B`=RPewAk?C-m^-1K|A%BEgq86<&8?KF5>a$VxblS|1HjQq`uyrz~#n
z$8i2p(>f)V7i=ZE_`+C0Iy&~I1p!WUrpysORq1m^f&3&MEv-|qm+@;7%Xnl}5*`Ca
z|IT^+9Oedqxi_tYq*4V5u7<1c40j@{RMcv-GysHF+ergp>i|>U!t&*?!*$x>?Ne1)
z(l8^4%v%k7^jRvUw#D8`+S%xw$jIp8^g~OFitroTgS*j87dRxP3WYfoB1ONJM9dQo
z&GwfNy)@3(;JZ=&Y~m>PVA0IC*4`&%!lU;bI5gSsozmIp;cg#a(ZPY~;wNs8B~X6&
z*6=>{s(WRGY6NHup@I3reqa2A_Ibwfl8W_FEDoBF<BiyK`4}8mv>=~x^%Ft&hLE41
z&quToL4&v5awge;Zeg;K3gDx4d`cU{GHRDYh>q-%gvs8`jSU1|<TN-AJTayMP|`}$
zm;gMMy?k<+7Fp)_Ul{#8EKNcFznj}nsfsQmQXEf5>i3K^dapeH=F_qkbcvMF46tX}
zf?l9$|77;4J2zW6NJj$Hhkig}XiI_7;Gqwf*k{&Ca}AY>B*l$r)S)+gC;u~MGug%P
zx_0eDx5{yqfHkX&5nf1?fWGl17k-yYEJ}=nUpX-~qO!seC3i`7PGp~7kN6r+D*%}r
zyPoCco82h8dqsBn;1~$!b4(HEUtj}_KBtfhjP1Oqek(h<P!|&)M7^hdYg9Jz&Ca6K
z)r^akvPo=H*ct4Jo{$X5pphz`-38q@wGjLi3Dq*pWX=LPd395d%OUO6;qPZhiU2oP
zVAujm3H;%ySq(9H(tqn??VRWw_d$oqk<wpV(VKLt>rjF5$5<oT5TSh!S?hoXhQN9O
zjjJ3pF}ZHx)46=27kP@#jt#%3i-X`X-Da&;X9zlTLA1Z#fuiPpf<VgoeF(OF@nQ~1
zEY5q17O+%wsF?51TvKr*gC47pddJYU)i+E0Vi%-lgWvPt2?$KLzO<-OaNCkaGRjab
zU3APS^?!tW940>Vplcm|rT5O*F~i9|?)N*;xyrj!&*>M>>10pbfCzFw_EX{)UelvE
z-Us*28*TLo%J0_GU6+|=MR;b%#&_>+L|<WoL;tDAP1#6Dg0BJ*@c~BE*}?$&)C#H$
z1*T5T3&=nqQ&=B(6&dO74Ub1Q*2KJdn94ah(Q2ocL9UWA#TJG-@48xGa%DG;qrLy3
z6cA)8&ot2^G}dpv!jSC$5D<&3E?<yTSygaU(Cdc4$#v4S72fhPn*^>{Rv`AyTHO21
zzAN73piXkSjsA_f`S0?~rt3kX1po&4UvoqUp-kUWg+qtdzYmo}P0aaqF`rnIC@E6a
z(U?R_6^U#P%^sSnHCx$SC)iMpL0B|Ju&W8AR@c~sv=S`Rz4NSQHI)NmLCiy8W{2(o
zAd$ZRyB@Ga6!&So_#784zjWuR=ub2i$|Np>w&Nt1IyWc)H(z29W7mdBZ$NXmTWpf!
z$ZbfZk&&Q&H*7wvhb73NMKTWI%EOX{c><uI<J>8@6tR~yS=87F68oj4RA%!yZYcg3
zdwCxPvk-aOj5Jzk;_bZ@;L1g<xT@B}yh~|kw(sp0N{srrcV71FgzV1jRZDA;x@)WJ
zg6xv1(Mx@_l0n@UtFgjft-kTVWEl@8&4K(b0Uf!}OzZoRaG(zk7-&J7bhvwD+RNDz
z#Wa4=M!_VNE?AEFx*&VR)7Vmlrvz&IeRKeEu`w$DOZd*rBWrZrxarz&k2uqf0sG(x
z%IB?`Q=pbxq|%wJ8$j-1%e=j>SxJ}2B)P{jYeEd%N0j$ScsEnUt7Ruu-Egg8-$?B+
zeopn@Qw)DA!VI=;94pQW^jD34to_oq2vdvVY94PDuVCdYCKukRt5_**8RNymg{ZI@
z<|`A<W>@aK->yB9WkbgHYX-Es$j3vJS2aWN96^>|EmbdFNe(<|S#Q~<PIzQVHJIsC
z68?4wTbZP^aAIz^oiANJ^M%JWgkvaWaVk<rvSuIg3G-sZWGr26p60BD*%n@*K!$h`
zTDD_;4gv!Bqfs*&Rg>qHBeW7zKZF&?Gs3f{b}C^%U)}K$Nt;;t6Rs5>fLf!;X1kNI
zp>pW{nHvY*NS%kd6=IB6x>cEqn!x2z*?qnOi^c7QH=OFv>;ytHonq7%W^Ec`?md{y
ziUpSk35(|$V}1(r#0JcVPnL!I?Dt4Bx##+<0og@R5%x<Y|9nm(6UJqsAC19UAiT3a
zNVor!8N2p?k0dM6^&j*6i1kM5<t0&p*q&7Rrz??QSRJImAboa9#BI{wOZ6y~a#v0e
z7_|XwnM|HM9nJYBF5xryWlDCbz_q+xnpu;zgXx+<!)WUmA;eH>B~={|PD?I2ovbck
zXh=-=Vl~weku8<g@9^Imu@Nky9fH^-^qaje07z6XkhGvw>IRlLZ}nU7OEY40<ewCA
zyo$Ze_Zq-t1+UW@Q{!YYt}bVb#j~sjm3ywVKE<*L@^&h7L^pXP5m|>LYV2B7BwxYT
z;Jd}`mJN-Z_;+bvh|=yun$x*rn={3Udy3VVvw9H+-pBbUrs25&Sb@_=kaqUJ)LsJ0
z@Axrc-8+{-*Ou>GEfdDg$z$`$!h;X_YQJa>$+~s|%CX5qsf1nmNbCJ8-kYc+85?3a
zP8>Q&Enj6ba-d}sbHJAAh_!BL49bjSvvbaZC1Pzjvb;L@+XX3n>DgV~yQ*UO#ri5K
z0e#0})MZfS{Q8P60~e`CArS%Wa(tt}qycI-!m0(ZcIEXMeFPohcJpCmT=l?Uwh81p
zDU-nk>OiTXN!{k_D0RleYnr-t)3?~DFtHYe){|8&{CdOOX>2pyI!xhhS03~n&CRty
zr&o=MDy9fce?Gc)08}(Pl^iInDrGUyi(z(rUlaGjR<7EpG!}^yI-jO}nB(199iIMx
z^;LqiZP&bhns@EKRTLeY-Vdv7#-m=4Q%{Hi!Zv_}VaLgXP3H*;%~$UV0wG3=tN}B^
zIv*lDM50Xyb^J$tL-R5$Fa-tU^}f}>d*QCamgW#Y^ey!?=)p{UpX|=v3A;_6Hdl2a
z`>;@^Oge-$HtZXytatRwNyh2jUIPR=CoS<9LzU*ZcfxCg9IT|lp5IEXm5ySa0Cl-&
z9&woTJE{-5qbHt9(^GbKO_`}`U7%G8YlZ#_;$P$#GTqB}Y^OroWUs0N^e02<%l*5|
zW~YUqPsRj$D@7g(YUrp4H*uTSIhgyYnBwD7AfLpH)WL?R9emB3JNXZm+~sTP1LCK`
z=qmZ-nSThBZ1p%^v)pY=m2s;K8l#q`xMSIR|1<o!*u%@p74|;4YWE{L1t1vdfk3lg
z!5@sZ)`p&~)sFRp6`_l>YwFx?zPmoWHdUY6PcUP$?PpvNMiu`Lt<<yk>~!x#nLj=i
z!#&P63Ma&Zui0=YspY1)_j|rTi4LXT9R5+~@hc7Ey2Os-t+_S0NOx1ur4Y5Fro&U+
z>CQW{{@)j6bFJujMzRmf+RkwdUt8m~s(~xaq12nYLv@Ms*etQW1jD410R~x#qs>@A
z84w{k5ry0K>cT!)T6h*tAETH%yHnAs!qZ$`CqoUM$*898{+;|Oou!loV?7rpl--5A
zK5o8%QGSsA%}b~&7lYNIBcA;iwMeb|a(K)qrOe4sU!Wu7m}!vH{|n`5TiZw#XQ~?v
zbw?%$#N5}oPzfwm`lEUByV7q!ij0V}Dea((py?uF!)FeP!YE39)nSU+pQzR+Y4mWY
zzm184D#^bIlO9#@tnmsL@=bzMOdgL$geXRewvmfwDcb6!|E&N1JM(LaB!#Fm_65D7
zOvD_TOhY}KAF}9QvkV*tV=|%t<<T|GkOarJ<j;|8u!!Wz!7CRcY*<0GtX^t!?mp$O
zq$QM3IZ<o`$m}ygvWxZmvMv;lxez44rt)0O!z^0o9f1_J0^&EYsXTg|=|(nbUR;;|
zIpkVgdiRAV)A)yQ0$-V@#h8+89Hdid$}~iwmC)2gCU%5r+D)Lk3d4Th0A?fLhyfVn
z##i*y2Ww$VRzuE3nY>LT>|~-Hk6ZUj?*Hc04MIR}S<M)}o8yHviRaV)3_Bco2$Jz<
z{!j2zY-r5v0GR4g%2r)vPm@%qebzP6-$lihQ!+cXBlD2)A+zWun0)^f#3A%palSiL
zZn-YHGcAIwD*wP{d7y9c4zHWFPQk0;hc#@%uWvWXv`B_muJjVj@C?%!G3FY3Zl+WV
zikMoWF06JP;LVF@kzD0gU}y@(5TlmD2>xWlgTGun86k<ffw6H)Ryk<laE=^93eq0Y
z#>o;TO%Bp?&G5Oeyn#i7S|zN^xS_&HWrGlKIhN-in!fng>{(;|Xx4PjJ|pKAy4+%C
z(UA<R`tHq*?gN<9NfwFa;~eIw7>(&3hO>}OG(@>5b*mM;s&e0-cN>BDe`;mucK*Oq
z<^L4`bZapkD(boGAgzbh#kR(W0d24=*FX6MDC(e_WDA>VDXd9isJZ0@LL)+{;)^Rg
zXi+>MBPj@?e^h8F79+D0qdq1(_A%rl2EjyH>!}4V!f<*w?l4dV!BHlB$Y@;KvT|5G
zxG&X^0751XE{$tHtHn=sDkdgzpcB{x!EdPZXh`kcn+m89KHc_tMWveqm1ex%mPX7U
zAa8*m6#bB|+Ue-ZenceDJvSwZ3$I*wF+#1DIE((?Ro@U)5og(ym{@4$OaAF(&TB~c
z2!JIbUg8yo6wt1{OH&cF_KT;`Z`KRO4R^HEY+ILQ7iQe{pT1J}Nh7|dM-uQ_+jrsc
zJUWzN2nG$OxD--1@;|Q>TThx8J?c%8D6kWxU@rI~Y}LcPTo^Ame(puM)X@naN!zWG
zWBGKe?4MW9rzhWdd&+Xh17A?L8J5fUGGQu)Eh;DEXyW%c&a&K4;D9vKND2G2xD4Y&
znu_~frb2`nI6Y-4g9f<1K&$_XDZWt}a*8QgIVmM%;9`O1Z<h})v+htHwO6?~gc|0S
zEu2bwgLUYC=Ce>9*8=jb?Gb84{*xz@V1B>Im-Nf4c@k3qgEoMc5ggL@U|v`*Jpaal
zWE=fozGIX^!sY2*#|FboW-G4v@3!HEReUjUjP2dh&5td+^AjA(zze_M&a`{xUB-lz
zrVzb%zBcu-64w!3DU9*!w9--H1$~j8;@>+?R!ayXuyZ~R09;rF%at%T&>u+k^$#K^
zUH(NdXDlqGU!vf`r>HC6_OxjcvfvAw%U&=>T8+(N<UD*f{|N5)s47x4?$Rdk;N0Mi
z<qr$k33X;6V&_Cl?E9uOO?0cCgo#|S?ULYm4{0Tbw+MyPg!bK>t8{G^vF?J7gdm@!
zh^7)IN}<0!r;=y39c!ZNb`ex*^xm=Xu~QbK?;uh8FeJ@Hg+@LCE^j+5`MGy(=~DB-
zMCkqJ9{i<7dj!(3=BzgzytArvJ4>q4)+UC&(XX<wY^<9%c6C36nD@XiC?;BZ<@=!@
z&>||nC!>H+s&aK71}JGeid>|_%-&XJcyk(OjJVQQil}FuM-I<tBE>C_;v$i0n-Fv$
z?_LB=wgjZfqb9-ht>(F^urhI;b+tS405?F$zf2T&I2w1eT@eNQ{hpH6uAL%%Tx=N7
zB|D@!HfFM<qucoWP;5|2sq0wi$WucCRLFCcoqx<kNdRF-ML1kBmwC!-E&<VCZP*W2
z!@V=wx(l4Xc`>>{6%>ka_~<He%@=)+rKDqpgSl?ZTBfnZ(eb!gT3l@r8uk~93Izt+
zHB}S?YMW=?ai8hB%Secd-(|&^GM0I2$=I4n4%3WPRAZ%jI}Uo~lX_$L<<Lu|fTQyh
zYjZTE`+5rbT|S~9JFfq)AN`N1;9#mm8V2bN2>xz|q0oQTj@E6o&c3iP3m0qVwbzGV
zzS#E-mj5t!ulQC)PjrTArkukWY(i8Cfrk8vbypDyc?*OZPx2%)WjhofCfN%(RX7_)
zduX|h&E5eBwc!aTSu0YMp479j@mHX0O}G;Z;T(niQE!9cOE;-=vnA{<$OE83<P#2l
z|49y@S8Z!3u+=;Q6~cObuQ)h-Eke%mAQU&fN@UC3Rm!T->+_XvHAZMPVhzf#pi-r&
z%3s2=XAli#oMh7*Re|2HRSa&7W0AU*7@I}h?bW+iMoHLgq_;{u%oBM<!PSbrZ5&js
zM_hS=$f)#9q&TpU8k;LSF^IeG(PZhmqsP^8(~6V>-0R+f>fbGW0A8Ir*)Nx^+$U-S
zd?I9rQ6-!A$<3rV`gC-)v<Qa-og~xjiT-sz@#(yzQX@%G|4-BDZM}y+-Fj<fGbz5%
z2gs|=&7W4ex{~q?JDgUrlwr?Uka_IYL0uubSibawueaX`nF@Q-VIKDVUB?|c$Wb3$
zZaS<xEUhuIKNY5O0Uj#1hVh(-I5LPnzgN7xez9K|Tw|g=+m^Dg?aHjssN2d~gd>b0
zauV9vUXCz9lr4cX!g4PEZZU}og?u>#AC`u6^U<l;D~0>vHR!4W)nO`<=@MbpErStO
zY4ET&vd`v6MVrH0(s*m!5v#!;#O79jEHwQ{ps#17rm>)0vZ`<hR(a2n`h};I8d$@o
z=wCCG)1NrOZp;P$1K*zOX_<+YM7)U_Q76bS`&KcOl{{in&jQodRudyz>%zdQL!A2^
z*ADNdY_wU&+<Eu%>^c(+#Fqi${E@aKI$p^#H7LO8+AnvR%-{A5r}iJi38ti=$A|vo
z9V(lyEny8QG|@l<U&a18y{C<bU(U<HE@(&qx#Ih*+<PT@sJeq5m+7Bi2)_EWh=(<N
zWp=C3GfkJSQo8<7e=RWRuN>$#h*AqQ%Coi+kU3rT8NyoVN6&2wM;*eb-i%-~B*o7}
z?dZBi#Vrj$+*)evm$o08yyLcs0v80LX*EJ32>dN3&KFM^`nwmo#u;07E*W!{Lu9U4
z*WlpHD6TIwJi;!P#PAsmNXS@X%VzS9z_U#HPQfueUly|bhCvo5OvtYEd}l2f@t#K4
zBD2dyD-hU2$tXq5RjkI{q{Pd@c<bmvl~Bjo-Z{tXzAl_p^m1&6DAS`Uo5J_5;Ruj+
zwF;37Ea+nasnC@Nl>p|!S!bQ=WW#3pc}wOXMcpQfq6wq01q6ZH6Tl?%guqyDieHQb
zM~3kOgZZJ9P8LFs9>&A>q^@NC;cO`E)&CqF?CF#1^(5bUz10(`5lI33sZcCeZ+3rU
z88Yxkc{B?fgn?<!zWytp`<J`@?f$f{`RK2+t^>X&=4R+8;t7@FpOjv?ah1GlWx09N
zVF}_7bAAYVN#i^%QuUhCzX7hZb54s)dvVl`@dXktch>xA&Ma~O;$<qf8v*-Hta^)Q
z6@a*#gW0s{-OPMlo0H#}z;7pK!Beg^8}}N@gTXx_PgDvgdQ92yNTpuJqf0UhdR3Fe
zuF0~oV2B`kI!ZYxdU2q#05aa*d`nv&OG_Kno{kc3xmoEt9TP?-Y;hqSPUHjRdTpQT
zB{uNgCdR6`&7M|?WUF`FEw2U?4Cvpo`@awmHKRkzT7nI#=x9=GCrh)>MI(_gv3ET%
zC3-xcBE#74M48WIJg-?$SgqUO$~fDZc5)b|m@EeLdPq||sn5%ZgnK`rQUak<l<m=P
z60kzg*gO9<LAt4ic4-bx&0x&4;yxQgXMM37zBHw6SB@gB>i2tzkBZ-F(m;d5YFhi*
zSsx}H$)|dfUyKvJ+c!-9Of!U;7CP9fshOKWnNZW+F~_f#NWS-<u9BuuOp^3aDAFv5
zMUYzQ&!eI#@{IPuo)wY7QsOJeLItHJ;dS%Bp_k6o3j9Q6|7^V2&$KQd7n;R=Pcz-Q
zt%!nCknmM_%*3@DxTE5yZ5nJt3{Df;*uh3n3tX8ZZ&e6SK|_qjn=X0)GQV}xzq8r;
zKzqCxUH9b{7}&h)rKUdlb^Mx&VUpSI$6s72hrrYKZp3)rB^f9|N4@C{3yXTMgDxN8
zZ%)=BWjMUAH|bnpeTm(_)`I^!2VDeKM#&)V6#XZp{nejhL{tY1^c#2r?VrOx$fmtV
zgN&lDDnSVxCYMrRjGDxXtAQ0|d!&1YFXJ<p^NSP!M<4MuQnm8XNi@$JFggOwl_@hR
z3x?N@wGRp@`xahYu3d$meU2za6U+I+j3F)qokq)jU=l@4li$uQD-ch$&zTqRHIr3m
z&MD+f4?1gZJXsj*fWopjJy*dZ>=JSD1w|j#(~K?YQy*31+;l6t!+bt0@iq6t(;!@T
zt0{90_FSNXeHse%3CkZ6P<(;!-UP`XAtcpXWh;8(<*0a_w829p-kVO3+W|;eY!|wT
z$}SWQDS7k{Z4^v4=vW3^QhnmdObYz7J*K3E3_4Lh4D4UStl}$+b<3`@oW&xA_3qr-
ztk;}7Y*badhr+yKpR=>9r6lD`M7ei3mPX@wo-ddtDCh|otqq$kH;}&kC@%>Q5W$?i
zK-#4SHF0lS@Yy#xCS$#}1Y*m;3l=5yrz-uGs;rAB*7(3gHYvOF0f3g;FAQQ=7PTGt
zK<&k(*n}#3<spQC(n_DtiT(+TaaP;V@sFL-m8&T9!LBgqUP}i;7UDALCY0d~ld1_u
zR94x1qP(-GYz6gNmYg-}tCvBs-B<&-oXCY}CB(Zh8q<u?QR68dg~NFziARoxy;o$g
zr5uJ*rnjDzA*->9?Q(McN1>DphIxT5hU71gCy95sD^N^LGzWMWbU&jsKk`;|h^uc5
zza@~@AV_fXxp)B+ub6d<d+rWJPD(n!Qb7M`yJNCUckD`FpSp<u`{fSoVW=zM1ZFYo
z+mA=^BqFEF?dg>ml5p7io_ZHfNzAOjl5&d@fy==2BhwY;Y>hT>Aa>JhZrJNTdQDx`
z^81E~^L^Bthy6bnc2H2&p^Y1{q*NLgt$O^Xo2!&`n>mJXNuscYS)AO!Dq3<i32*8p
zIoNm>pOtsHUAmm<N20i;R!S6$wq$o1J2gbmn`!F@{Z*p&j`v(w<=nMtZL_ThKvLXd
zme2^8^!~cY7{d}XyCQAn5==)uk}cM88z}ABtdrlVU@G~VIYVIihah)ELMgdE5|eM{
z#acx-cP?}@sa|6fyZ9>x^jlNPQ`zJ(g|Bv@iYEN6IN0iwkMk4g=dEiB2uETr3Ix2T
z)82d@k=NeE<KNZvPK$s1^L+BiJs4E|{v?o=Q4y|QIJ}uH>hLI(`AE!@*v1uQb{|@U
z8!q0lbulP!YHd7I1f0hSC_fs-Az%ELX~DY#b_zQE(3MY+92J2Q*yI<9fxU7L6aBR?
zaPg_XvYuL8B;P6>kWJN*b>_~+r><M7Z@^9aG@xd)#DgqqPmleM$Rej0@Vw%Eu)Cin
zkt3T(y4Oex7@a#O%j`juaPW$qZ!~rn*E(gIb$|Wk!2_;YIPP3JY2-4oVfNzqaz&j1
zxflR&aZ0A5Yxo*o<A;>S&<GQgTpRulnihx{lz^~?xy42V=XAN)d2+Ci-Z}}*$4rKi
zbs%!>{x3?*iN45oi9U>Az*=BGJ_x8Q=(ef>yt^$xD}}*)1lz^zMUDnMo`&{N_MkM^
zs)RaW#F~8Acv=hn)&C&5zXs)FmN5K|R}%_XlH7Og9<?ifZ1u14?@bbqcBuWhpO9La
z{W*}oXn9jk;~_$TpBBA=*8mm;jy|V4IdO4OVaw(&*L>t)S;j`AFkWa)A{4AR-L~Ww
zd}o3f!iH(R-r3jHYu`jv3m98B0os@H&-CtPt9b+{Z-4@ub*IgIQ^R0x>Nev^K%(Iy
zWi<+2_!2y)r2yw{P&&E|o`|M>LR7RzpWfC#oyv2n*Li>>?xWs|uJ2G|g?%3VB`*G|
zpke(saUC8;Jmw`NoR;PY;Ez#+bBcQ{n`A_}ahsOdkpOOdMJajYfoDiE!*3?&jecNE
zoAQfMJ8bFCWru3cKF}q60vVkfM!sI+dnLTg2RQys;Lwi!@?bih@#1=I31S+I2DP+a
z&`$70m@8*sD{Z63NmKC6{(pEby!}aD+;s-dX1HU3#e4j?7IGI@y^-aEl4-?g5bgGK
z>^@=F4)w9z#x`0opB}DTM5@ENVc8gu=);fqQy~$suSzhC)YXsHk0&BN+2%k$dp;eE
zN#nWsfY^<7YNR78QQO%dy50TC-KcNx^OKzbiVqfD41+=fw`MnuTN=NjE~$Poy`m-q
zvhmpihMOaP@Qd$gt9j$=pQvgV^Ar@@9(X=+=xd=zQ?;CWhD)QbEXr5YT+=b#&w%Q=
zer>z<cT9!$S_@d~13MZWLw;8Aa28@Zk`wXfuxMAWL8Lfx7b{hze_ai4_RvH(xzXk<
z!>Jm0poI$u?x}9!=1v)-``#Y6-v0$lBTv2)vAU7I`u*r4As~U|PD8)z++Vt2Vk#<N
zo;$r(uX<D}TzLTZ=*H?Yp#T1l{=E+}ygDC))i~gR*w>6K_dV;wXHNxh3^5lfMMy9k
z57CLF+$zG8;Cb+V04)uE5Fb*)equAIgTl)6ONSfWG%_rYPLxGQJZ3)Lpc`}UoNx%!
zk;^aPEv{TFL5SdU{g{pfYVJ99^eQ_Qt-YUbsWXRFIJAuxjxPmLdW{Y@G6qA16boB*
z^;SG`h0PjhKnRv_6DuRzDi(3aq6iWYA>oQ*sZ0sKWHks(xw7wK>UkuEU{U;}+T%k5
zi~9u+c`S<v0dBqruyl?NJb4w#E@1X_K)s;3LiOUwpXp9Y+Z!G#KW2((s+)V*k|AVQ
zJB#Syvak+##vtXMkAba=5sC!+S-t1^+q?$HtaX-dwEeKR&Q>~(rGzxjPTMwU{3iOU
z1?`Bc$%P<?Z4IQ8!$AcSorYA!stgGrHAC2BInjNc5ZY0DF7O<515fTRY=6N#?ISea
z;*D^)3%L%-rDFZ|p*0ziaI#gOLsGkatjr_yiY&|AGXGxi_*B^dFSvaO@OVS}i>irZ
zE(>(Owu-n1HW*{gmF{18X0Jv4A`ngW-N(Zejhqgay`Nv>lfCAtlivc{#t>`IH5!Is
zuNT}Sws(*%<T^~HT6(uqYpn2r)B)%eIGM$AN<H$WI0dq#C$Dqc%2xN_O_nANK9TzG
zhvLNgXKMS98gd(^Ni*%v!fNhvI+#;1%tF;Qk74)K=gg`i{$fdt$bBKnNXOw)^L6+H
zZNeJcEr1-+@w*Yjwm^cJ{Xy1PffF`+ekFnb_b5{_Cmudu1i=yqu=KY6(YEz64MIg>
zLXBnBG0bv`3o<>UtmeRPV0nPGPosJ>u0d_bCU56PZN9&9NRGMmCC>2R81x|9CB=OB
zQjzY=&rDGR7ux<53GG~lb^mBR<fZyCVblY;Ne#JdvxX0#xZ3Hay5S5Cp|T53D@MB{
z{*REh33P8+0<~u1;9EsXjs`+{SDWc$$N?VW?1sz~brI<y)*`bJ#HU%cBL>;sT18JG
zmwG-}!ixY0iEDF^?xMgKs)QXeQ^Mn;>=>xEB+wJ8kpK{YCI{s4dLdI0S1y7D<k9?~
zVsK^0Q{8}|xq}S1b0FdKu+ANMYEc=cBj*p1@3G!|7Z`qHpnrfZ7f3c#>`x?#D@fdd
zDnaZYeBiqlGLk?LOn5}Py0fdAKaYv<>!a9^l9-eVX9yuFCdHl(JYWCB<dpCwZDB7r
zhb7^z0uB9=@ET>kYEoyRoE8u&NUVz;xRh@iW?y0=9l?Yt6yt;*p$?j+YaV6Oxb|K}
z1mAb;AB$r41M;L^d56LQZ@Tf$aOrFB?4I<%2?~d7xE;#pNehiU2s}0D#)8>LyXu=I
zB(aHa(pX=C>c0p-s4>2q2K%jFGV^0S_Vu>LztasiQA?Csv0!AHx5n?K#)Th?`l~Ww
zzLb?{YeUK2JwwQ)!g4f!DuLN1R9zS=#=>r`sZ6sSrWF8p$mycnW@G44X8OoH9~JSC
z2>r<z3X8zic}DeZa#YyAB{MEzV&$K1#SZFSq^*WV&NX=1xHQf@Ly&9FVDxbkfoZ$O
zO!F?WD*-w=s;%XT=N5ve+Onu&vsZH<8mGXGbVc%NrI>v>aOGlrP(ZxtcV#{VJ*!vP
zV@&vP(5tTPc|#pN5EVb_`9RNZ+&1sE`Gvi!m2*kChdI64`}&hm_KEe_o1&**9;d>?
zf1GzL#3?qiEl#ver>kluB}Xq`rDa#i8psO%&}B?5^L5MlPBpTRRN(@H#tZv<>crw7
ziRGI^ba!gNXMN#413Jxzu$7pWRWWTo&t#oRk_Wl(LlyUDyuN=i=NTj}a(Xs-PurHe
z0Tt_2M6wIH1kcIE)?J+2z9VST_uA`jG4*`dT>N^5JxMbzkfTAgr5L2ObbBTyW&ae+
zWNJ4_?yCjr6)0ku<{=Wtmuh+4wE5sb13(SCYN7-He~I_zgzpj8S-A)Vz(7ssAAq`c
zw!xf9F%@>~0873!>_;qyR=h{2YkKLMJ3ImHafAuJnkTkFhhW`n7L|kPz_a^6NvQV+
zYKs2HjAq9U_NeW$+_XGJ1ut;ctM3yeUjOy#u6vJi<t2(?<ufHie+m-_eCKE<4N#i-
z>0~0~AmI+MV`{%+!T*$UWqpA@IBwLnG<mEXFUKony06|eF_oR=iWUVTT4lKgcT+^+
zz}Oxo6tw(hrL>74>T(YwiyeT}XX@gNj%1>mI#oNO2E7pw-nXja4T?YAs{sjOE_hjH
z=}_vRptu0I(oJ>dixnd4py7jd>5fnp?*`7*T|U5~jCnD{b#vh&KX9e$U578VxYQJ>
z-$sEqwr7uRjW=k_+fYk2Tl&N``Yv{Kl~|CW$s^K+ruKtUDr&aKfy4fAY0n1ob{&ML
zX%)*7?kULCQDOa|{@iG{i&C`C{fsh5rP#&6{TthsY+Z(sEH6rP7Owp8U>jFB3MC)|
z;cHTI@^}rj)uTWGe}l465h?`4g(|D=*c#%-<|fThBh|i!WJQTZm~hISK4)M9qpIu0
z#zZql%zw*P)v%TEAh0`C81IvwLOk$18C36%fK=PTGfs1vAmeE}Nbq07t|-*5kG6&&
zjGP<9AY-_<Av2c>6{9W$ccJyCR6j-pE`R&S!V1)btR_!3p>OL{1{0A;^&(nu+rE^j
zOa{?P6bZXir-H#Dt;$}_F8D;u;|a2{tbLFLO__|Lg1#OYvw<*DYdxYx><tRc4>L}A
zx;D~!{q6VMQ(`IO4yc!td0s>2gJOw9wSm8LxI=taV0`;Aivk?&CgpOla}8o2+MGot
z6m0E|-n2xgW4yAB0qVOAbF3A6H8E3^d`PSwO>TMAJ=@hKilXy@tlW<+=JNGDnSv<v
z))dH;E9`EyAZ~y9chI-Gmfba7C(ejB<9>AfKnERSa~F)(eWtn!0OF5F;j7+}tF!ZX
z^z7%Ar-SgmrU~$2latGBr`Ej(_sZdvYHqda6p(!hkqwxY(<tLrnU-Vq6h5LSMCTI1
zP2#3vI@mf-KzEvy0}b)b54(4DHFg0|0tRuQHtjX>&kvbK^}3mJLu%V)W>FhaY>S(V
z<K4)2e%YmsBOXqvw_&a_xH5R8`V&;Z93?=(pn5?P7)!oV1??LgQmT&Ii_uS9<P4Un
zWmeKF(@C?|m21rpR=R0COSKoCt4~JOb5j>5MS-0RG7o_hXhZjTJ9PDb4>p5s6sI}m
z*<2_9S&jQEllt0Em5WdjxM}uHEgNzi9maytmYgoIgosb<Z$=xCAW&4}m>kuymyGJP
z_?pyeOnNZ*pB>lMy)DTIpyk0glJUG!`!~gjJaX!?o^G)#4tWpBjb6E0RoNA-Fd*ld
z<m|W$Lpbv7L#IropUGNFFLhl6wC}(SaV8Kr`}Tl2y}W^c7s1+1`ndgovVWOo@K{Rh
z9L#{24E>I!hq-f>n?~^-G@Qu^u8Hs9RE0T}ZqtnW^RvmnBNl$AEyip5+)*taO3Uy+
zNv=Ev!~=F7I2S4d4Ps3Ocogr2_8N6<G<okwH*&sj6S$D!T9(Q1G`v}K|DB~X!|YH*
zD8d-f>qj?vE0+GAZ~A<2pITM;jBcKKJRj-40m9@JJ-Bv#cq|@D0uCM#4;hmmw_>t~
zG2XyvrpcFBk%f?HLBL9_40Gh~XbHCGZExaUNrz@M&&i!}s?`28Ra7CHdC1Golzt7O
z3U8O@9*GBJQ-29CMsp;rHu*hC4Xyuk<x<efPQ*=`Dr1-}sEGJ=f8^CWY+!Sg3Ki1Z
zx_z8H4{^_<XQ%tOpr^-O1bY2JeM?gX_N}Jzz4Z4GvlY{QnUk%Q&-G7#bMb1`0eR-o
z2{xkG=Sl2=Z?_!<ZR_j^Q_b+f`4M&y{Q4MhLXnacgUnyQ;rY8xX8wa&q{&@RSYW~v
zo3^E7^sHh6#zi-6s;qZayrPk&%P|Fr-sI%1ha!$tfFDe;)3>(x+wtLSRsHmKF?DDY
zCiYBFHap3?Wi%4*&4;rUHGYsErYpSAHUV)2ID|NjKIs0>!Wz)m((|wo2wu(lc@Y7`
z)8T7PyOGJvTZ^ejZZ9_1Do#x}mUB`8s?Ds>w;o=KBf}-RnqAJH>mM0)wvSoPGG~|8
zZn)UWqinvRwgl>A3YkP|SyAN(H8NxByDiHiXpJZ{Fa)>|Eraw=-ZNT4$2Q38Dn_0-
zvvav3sKD_s>fRuKgnVYoulH26(i}wmbPupT+!OqgGVBoqGG~;5e{r#x$E*&Y#19HF
ztdtMG1e8r5&-?*<qh;}1Z9P-WOnb2*n}>+uunsVJOFw=8FGmE<Mv_-P6zQH@lbmYE
zIvqh33t~&M?5ax@F7MscQE#RIS^69r(^~XX6AgAvnj1M0+}LVi&kWLs+#Tvmr5i9v
z9&K!2sENN|p+HGKryz$p9c?_xks?LLOK9O@8pl!gbM67SWn@!{mcSI~&m44yorlMV
z*UIuu1Rx2y42IXI(uO+m+i7Pz+9Qi(8<2RNqIUs@jsBCSt)Li(3<BPIk%mu5Do3Uq
z2G@4sa9Y%-ll#;vbJB~arUCHn)-%GX^W4hi23&R9^!PGMHC%}Jxt~&>4u=xW?}JT0
zA4G&c4SOx!4Y4t#&dY7~#*B#bYzDx7<U^UTAAOhYRTQatTEm5Du+49ejmjfX*2?oF
zXX5+7c(2U@a%05&md`bje7(LD&E^tY!HA#>1}U3Q<ET=7fvI!JpDXw)t+eKVGbdl`
zpuW^RRuT8hr|*IzUQKK#5{vSPv^P(LDatoAhSHA0)|(QCYm6s<mXH?{MuaY9&Lc|L
z90>JjGiJm2>6IWxE(`)iWIO-v$(9jejS)I!558$7#0ye+fI4#=9VCeP&{fz?SRf%}
zem2D(W7wNdDof{PX(*0Z5UlzH#!(pT=$kfb<HfQ#HLyxO4(t*>qc1?EXL(@~jzc)n
zAjZ$2(@XMrhRr{Lf=YZRnUSjf_|4i%P<3v}ypO3~tfse1H|;@S(pZ`Z-hlSD?p@^+
z#m`&RUC4YOyV0*sGE?L;O@J|VGlxb&KH4R_<rU9vC_bTGm@eym4m&yVM%&cFPSKM8
zW*WX9tq5mQ&HszD1dhHODz>N$q%>BXz%p}}J|JJ;Q5HH~R!uxJGs`Y-Mkri$_S4in
zoRe<v8XG5X8PvDB-bQD1rX}ozqB3YV>@VgYAOsG3-_66VD4tHTT(1qz!+DET4qBH&
z?DUVv91kOX5A6mA0MFqM9THe!wJ|AdqTOLf$CFQf>W&j`5T$JKD8Z-rD7z}?`6K?>
zL$Q!~<`u61=Z`e)>F;)Hp^q7uY}XY{E^A0+tV-g4l@cy+5^Kok<gKmsK!Z;DRbQPu
zqXoA<)vWsj(f!eX=|dz=&lMR*w*XNhV=QazTt<-hGs@W_vr;E!tc8O6?FXqxwB?ei
z>mUXaRTTfRt;7sF0+-zErL5&vMR4(2+T!g2gETu03yWRuw4j~uLzymMYp(m(Q+KE0
zuFYm}ze5DLW{wA~wES}ox~IohGPYL*T9^Z8K*6NUFKDfCb{(b?p?WCoXaq#zh%Rf%
zM9`H?y(||stA-u*Z2n{G<Z@N#mc3(=JB5UKss+WX{y%`Cz}nst6q4hlYM&DGWwiA@
z6?uYqm9MW~ObKr5!gd*Ar_oj$OCL`Y%e*RrO8-*LSC<V%Vxb;(*!)V$34=?wDN`Xr
zQ{vcR9#0cGBe~82ESZh<O2+a*MOnN*KO-NVhgtUFykN<OWN1`VbVv*-;{w<by!m33
z{GY;vtkj#~qwcRp0_%4~kN4;8?SXG7DY$A_L?QHoXJ+7$DdJL;T8e>d*K$5zB0Ym|
z==H7S0Lg_8VbyvSdKY~*^I6~NO+*^k2PD;R@tNQSbPlZM>4co1F5;p#0P+2!hTq?h
zb=q7E(wsP2*+VO91&My6y5YTn1-Q%U5PUp=V0yFD&eJy1_4Q?{dn=Y-0-&^aSg2<>
zF9MxDX4<?f`)jk!Fhke)YQev|rKp5iEoX!f3txIehf-_2h7uIOK6J5%?G?dbk7lr@
zL$2S^c?fpoPZfPqm0puHBnGQhZ`d$PH3+>FN>?{JI-zX*8jJ5KR63-NMlk#<x-;zr
zf`^g;9B)D7K}y%t>JoXncY{dl_)@Q2J`Y8QOq5_Lt7`Aa&AitA^e8#u#O|v`V`fbY
zsqsqGs}zCJq6?&=T0d1}yzh0drQXrgd<(C|!FlGNe^!Pd($PB)H@Wlu?r;Hm7P*>E
zjPa<O>kWMWwb!4ixFheg<lYEZT~95i&NA@qNhL7yI3!D(8g4K~HhNvW0`JD(JYm50
z*oM4Y{sUmc38@pS$0^rgBr6^WcDGNSmh(-*H44u_w$`LHL}90s|5OP5MRi7+>soAG
zKLlHNbQdG`Hdh3qy{F$q(yur@VYLy53*GZQNzY7J#y^R9Fu5Lmu56NHTX=h7lqn=X
z!a&eU((g3At}^;Dd)E9CxL|K8BqjddD)?6zR0(bQ{1W;IY`WPEP!m|qkPY6qKuoDR
z;vgF+0<lvTAwdl)Z9$l<J|BB&)1#=k1I69WX?CkN&DtKOVs<*uwkBYNt=*A?l2eAP
z-mve4@hzyl0MEAS%NNV}UFGg{1ewO{^4cu%eHg<x(N7rs{s<+aSN-gGs2qef04nsw
zQ59CcUP}V*L}&0#dkL9x#PbuusU!XL&s8@EzOkB^6Q6M*><8*%gMfop8!r)#%7^1@
zus5;*Og}`Yg^(aD+Yf*xQks{}EnZmK=Vnmg*U+vVj=^BJ&be2Ms`M7`BNn6CGXTg(
z2&GvM6B*3XEoZ~8F-D$RT8v6;My4A<{xJm3qgHsM@;4+oyX0D|Fpu*!%WuA`IVR--
ziyGO%8Awv3k<AN~&_jB7gats=Ay%6Aq|=Pqc8c<5=e_3q9`pt-h9dzVD9ypV#gBdu
zwhcFKe0@~Pr2$q2nIy>9var=e_|i=DHuyh=X}r%H=<X3+x02NPC!^=tsXx?Xp-%ju
zljdry<JIa|NblJ**A`mn$6G^cHF(XOaiAWiC+T*7va#%FxXQG(`RR<_SO+B{rJgt=
zq=8e4LX;>Lx?C!GPeoDC-9i9LUxq754I%_F&mKdxJ6+#z*uF;|?~bkEX^1soKGS#_
z{~u;isR6ngL;@=?xY!GR^H)gCFf1WCM3jw5_|aWiAdyMIr1X9>w{YPI1xeokJv?)1
zFf7pBFgz&3upVisB4#L>Elo!<AgU}kMwK!G%iRQ$Yi4^4Sdev816hpSPf)7dhLiw0
z+2N9y+q%ixj*6Pdvyd{;%9S~(h$^5>mL7Ml=OQm9d}aROSjC6oz|Gz!q`_vwMNy1s
zP(KzE%<P>DcO~&hiL(sXK>$96?N9J3ZZ#+43T|uJtAdGlbN&yyvHW(4GGz<C319|i
zDB@b3)-Mk3(XWpHoE!%R`%Z}Nd@gc|Yp81#tG2ew$cIVleM3zT77zOi1?jezz0DNB
zM*DNjEyZ(_$dK=c3vHJ_1J9Sc8hOr2JfxUr>B!Ps!5NA}CwV{hz@6zJz%K@%aThPh
zU{IWrTH2EByd0+9f^&tCIt745P)sCf&_&Zv6CO^4hs%b6gO%a%0-NOckg%TMF`Hf%
z8B<kic0$vDwj7MM5O#^rH5Z!KS~kyJQ|0K1k(m~@o`jL6GNd2f4BTr1H2%U5CUwNt
z#R|Z$zFDG~N*TEk!X^!m@AxaN-y?@blvoRwbP97l_+1VHnyREap`dp4r}7`IgD=-v
zIzA`NgSB|9J!h+^UNFj0Q*l90fq!o^V!`!jEkF{6bmnFvYW?(|hvMK*eA3#OiIj2h
z$xVk?GW7%!ERkD9`UDp!$&qzlOurZ_sWDx^!|`9{Xf6crQ+&wRkxHfdq;jk88svQP
zaHRHu-7b(ioS|gI@ObtMs6qi0-LBlK>=cr1+2)f@z;7vg@1{C|N2ERhVzmjiR7`lV
zo%>`-ez`pn1S6Lf_UNuUSEubwmdFu!h`JONt?xYfr0d~FK9tyg%eF6|xSYfg&2iDF
zf!@T&<8BJjN^_Bi?MlSZ{&5pdBBYv6`=R0+H)8glPkusj?urksSn%7QYf#_Men?@h
zUh)~6YWfG~ziBtV6uc-OxwhM|qT1cNh|Hs9$gWN~GN-o8Zh<BL6-M`?dp{zQ=@~j;
zlS$M2G7{b~%R4+v5yc@*pvAsyAjX-cjp<X+7p;3nGymc-W4HHuG8w+nwRwlvK0TLK
zg%1^{(RbG8X!(4cB8y&(CkMGw8Y>ozQIt+TGMry@cto^7N*%XewH5C~?=VC23wbYv
z_$?6`K0(e<iYbX8L$;GK2kGkD4HoFpH9EE%O7G#%_KhIGS)!>yHr26du>`CuCns+3
znvkty&ow>~?}9_vL4;xpo@n_XF+d1sb%r+rpYbmUG|HWR#85VJ&R>mHlc-9CcEps4
z+(3a4@Jk8RERoNM2lCoynw*#kbI(L+)+J$XySMI8l6ORE*$uk#`c<}NRh9WXkss3a
z=r`tv{8>qbO}Vli_yRgu7;*pZ|AmHw&I)*pH{Cfo)m>Akjbd^Ta0xub6pWn*-zvZX
zszE&(-tDGY&GBB(pju|$eXoNFX~m+<A}kdF*d0~{f3zZy9=_Xj`N=hbSz@zgA8d<x
z_Zk_;dgi+;Hc_w5YRU38Kg~VbqECogM)zs8gIF&asM|}YOJA&27_0S$VGFdkh7kx6
z3ps?T<C2EfG0PCapM=GME(iFg3gb2U(-aocdh!&K2Vi@nkt9FDroLI9p;I{?%_@UM
z7fo5`5DTE*-xTvWA(JQq5&F7tD{A5dMMDxds4}ZyJJiLw{q23s+z=dd3+`x6ILP#d
zjg&BeD_6!w>+l_v1PP6f=2{2vBnH1e5k(HtG{)k(+NGye{j7szwY<|xlKFidmfkRQ
z&o!AY0!g6WhYW*<J;;EIgrwreJsi~<#1c`7(<W526+PO6HxN;Sie2qyuK~73f?p<a
z{|^k0bsdG++has$vOiYmK~(%=0cI*%n26!^#+8U+AEJ$Y)jpBOzHq_(XTW5d7S}bq
z8t7evAb_8ClPvMN5~D+x!<9~9Yj=R;B%Sku*)<b^X6DR&((<x#NJ9zL1#^P7DkpN7
zVLtbkPZ=TMLt|cW!JK=VTB)QmJ#EbccO$FnL+JGN{e?R`XbG-++0b}4%$*aBa`iSQ
z5Iv4PcvW<CX1Y=<A)>|Vs~&l9p;Iac^#YpnFwu6pZ_Q|b(&kh2vz0yI!l>uc@`7`K
zX5$~|Q7UlSO_L^++91AiiAUP5A#dcbV4T>bwvyC??D_H>o~M>~J5aV}8~=v_JU-|g
z^b~VXY^x7Umo<A|JJz$RMKS&G^3yz{W_w?CQU=j+@w{lZ^6-H;)*I`KMA3W^9p+Uk
z5_|gOKlr8aJk-)xrx5jy;-F<kI8WN|C^!@u>}gqeCL|5qyR*74ofQJjjn3_TxNWC)
zf9%hcFo=uPhyn8~lG`g?4b;<r&=I@QpI#v_*TLIA#U2EX?%t;z;~zr;5i>_yFPHro
zBB1=;1~vd(RN^kxw=e;x?~0FROdk8{7c03XgWsuL;jwYAA6y%Jo5#4!2V<{<=>7NZ
zzbI&$K@qvjDuWW4gU7%vv`CN{Smb9#NDZ+D(Q4kgqVCI+5-$f0sHdTd_Po@jdAH)%
zXSkLLa*TzGLrQK7ftF%PE)D!I(@XBH@51CUppz;7()Oi_M|fiA9-hayc9x#`FL(Qy
z=*OA0!zxyK$I4b?ft8SY!HwW({;h(Vnwsk1xO{mXB#M>aLc_wFdJ2eC5IsBbP(=So
zPlw^Jndc>1P6%p^M;km<Y!kdejq<5tgytj5YWk|4LjK8fAB{=10e-w-3tnGT?&3mA
z8yKi-Wi4p@*VKpMo@F9s&JwW-ee~td?9&&pq#QpJ^&Q5|8L$;WdnJzBwhQBuaW~i#
zJkQf6zUD5%FN#e{;M>4iZhVf}Lnf_@yq%<NU$ZG4g__IOIvxeGZJxM74GCF0ik+2!
z6z{L`TYl+IWB1-;a&@Fq3_{&vh6}W=J1A&W&>4l4+7FGCC5epCV6ZEF_WKzwXs18n
z0F*H-qF!FXM!)ja_P%Pw3@l~&UH<E^`d&667_o+--ZL7qfE97f%$~<;YGhVsT8`pi
z?9xZ<5RRv9ySQj3Nx&L;p}HE3NN-gTwGWlkC~c|pNex)oGmBvYQ>wOL#3!1;s0{_}
zr9njFg{xX5L1;TY{_ktQIpMPQW0&Kpi(j4)g0yHX8*aZlSN(3=ca{l)Ln?<Rbb7B%
z?U}~YRhHSj?!Fei`gfjk{}<{9d-(1+a-I<f3#0Z;B7!&mx&w%ov7G7-$@n)rqb9}r
z4ks~g?B3Xy`<)D4F!>C6<)(hW_;6<>G|5*oY+D>cfEo}3wCm05z6PWDO_%deIqGMI
zd=aOwm0xWZyRxY)U5z{m{AfBh^n3zvVL7>P=3?N|)MK~!VBujP_-8$KzP2Vr8}~3k
zaFC_`M|eJG$SVCyJUZ4#*Z%t%tKrAmE!s=&G8YM#mP*MNaO7{Ts<;FTdx!SSoj5N<
zq=Z4#SrRwj#xE-UW+=&K+E~yUC>rJys0*nyvh}Sj{P_j032>&6Ix_e<AdKb13ErtV
z8wALAnW=c`L>gc=Bk`(xTPudf0&R>h3r&=*WMUduAx(j1;#9C>Z2q9$?O#o5@W>~2
z@5~C18<e2y179$OJ$)vzAPY{6IUMt>(gUeC7d$+7n*7~(_h;`YZvmu+x*pgX+Qcpf
z2w9DICVZ#(5HAS0poS>dfw|bL^+=}d**lfg{nCR!4qn4h)JnV(L}#aGF(0#S9+xaU
z+Ko$)z^eD2(dnELtC@+L*bVKCIVi?`C)ok(kUPfbF?_5<m~=KR(VQfyGR5!YU@V{X
z@~Fd)J&^f|ymfUFwwU$w?lWbtjBBd;Dca??>DpARLW?irNiOFzw$Lg?$U1wdx)u(_
z6KQo62|vhuwy1mHE|(4Jk6!7dD6^l5yd`gXs~^WBSt9YYtfkEUvi6CtyLP3ie6GzA
z8fQcrqu!RKbv%8F!LHt*7GsFwp}=<wSVwW;Om1+ZC>uu@(_RIU*i<2*p7*|^+}@eO
z4E&$}IR#H6xvXYDTv9h=vnT?UEMfOEy0Gk59ZXYkU_jJl%f90tdb6_OpVd!j<B#IQ
zkiXDP>qIW+Tb~3VhsnJ`q5>e(PBcHIKAFu=chMg@4#6V^ik=k&9FvGHf)7MYU|s@S
zXM-{~UY8=SZ~OeI3O7OQ*JXt-5#Rz3c8Ax%4aKAGJ?l}^*0y^5g#R(?)+KyXuqPM*
z`0}Rze0o*XM3mfxdf+jvvrRXYhVXRCJ{*%vx6G#j2gW4r1zT8|-nUE9SpEhoq8+bp
z>Ul?>fTPO88~W4y!0k2t+qGnt=t8POhCFH>Doi2=Bm;qcQ!|zEYNKBuRiOBRJ2Gq&
zxRLeV!7t?kHK?5IF83zFk_$OR8dk9aZNhEx@{a@IA*<qtxnm%(s~C)uZ4UV#1z*^d
zM>nwK$}VoSC|{}|<2*+eTE%ek?&KF8FCP0UBp$`kA1siYQ$NRO9i{I>UEo_hWaa-M
z#I4f7)ioI~%lO}N%qh6~@Z!<nX(hq_8Cpu!V{*Ud3O%3P2iJar?P~RgXa*mJy1sB_
zAw?OJkp)HcE#Btu@v4Gm$kG3HG3;7ErvvrQk25716_&T`B;K~6e9PA3(F_hGGQ_oX
z)iJ8Ui@<U~=b|=xU(En9${gswVW+%Y(GPBj!YjO<SmU$l(e1ozIc$zerIK&jr9H|`
ztj>xeSq9qs$nvowq@J&3k@N)A)32_*#!~W(@zR7NlGb-KMAE2gO2Qck{w5t2X6wc1
zJ8*Z@e7X#-W!}uL%efT@$V*PTemFno^>UKu?Og8;S?uj;bJ`}Sl|qYqo7h7<qCOz`
zC~H&BkMmL@WY!-s!DGr7+->2f3)Buu!~CwF%ff`WG}=M3qrP~zQxr16C3U~MdpVOu
zMy@S~W^qK=L$I?)Q)kWof|@{d!&Ewp%l0eYCe};kmfjGV&>4Qf_)J?0NG;Fph4n6g
zOS4csjW0h7*Zrwryef?V#_3|eEfYFDbP+$5%9Vj>e!IWUW&t@GnWaplD`icGzKSDa
zf!TR|HNol59or2pqPiKNsKy~N(6hOu8HY20s%O5ya65M?FMY*qdIVw%a9lr{IXoo!
zlnq-kbfkc=eItJdn0W1V9J$KUj`ilLBy_UWk0@S`9Zi)&Pnys9Np~!W4I!sJqVnk`
z)!{CtrBwW`@IOQ=P&zC;NvuJtt7BAKz8P29V@hKGS;fUmtVQWf`AFp}hW&fiZ9jSM
zckFu30a%|Yu8~66TDYHLK{xB(tXk0W6XDJew~cg-KoBM&?|i#!N>Hsc>11yZ@Al*D
z6o*Bp3$ya8c6#X|?^k{Zb@P8=c{ghJUpDX|R+?Yu4#X|9-u4qm+3>nJnFvY;zo+h_
z^o0TbESjjC44?-qJ2^k8Wt2@}ex;CcT1#_q0i8A^LI~YpMrS(G0|Nc_%E(EBc^>I5
zzpL~-KyHbfUm27+3`xrP1}2nvTgXZhSmWH`<nd<-F!Le`0Cqy$TT%qu14eRYk`aS=
zAl~g^UN1OWbV7}gzJNz6sEAtPk+(zFlHXj^d*3z^sz|b}84@RUdn3(Lbu`-y^9gPR
zG88DZ-}@Y)i`g6Vx}TUfaP?RwWT$tS;7;zDAFojLM@8EP<_lN<J~~6=W0EgFWEU;p
z!OC+>*lqQ*K%uz0gi>lYC%g;zjgG~cG*f;(e!rEFQ)g;z$63@>d3{axlHqNFeI|NJ
zbyqBf)m3XfjnBs8${&5n%_4?*iXwBxUJHu|xmp~^bMHbLJ8UXWK(&wIZNtQZs-pYj
z&f6!po0k23#5hg}I~Estmqvh(1ELg*=M`&jma84kWgyht)yv6MIqJ|k5R-9Fct!eN
zXuw6#)%bg)nlcVRpbFzl?OBT)?f2fbiF#0kkZ;Q8580mxh7)frG0!%*{#dLj&^f_U
z@16)MCXHnMJPBo5`f{%d70SwyhB%3OK<OO-vwsDFhveq0HIazvsYc&NRzbH_V{$3%
zQ_Or^)=yxHvf;)ZV}VW=h5evRaOd;q(MPF%yKU&zc=c2_{PxIYS{9N9)f;cWp1Q_{
zU`1<MK><&gdwBFZNR%$Hj!c%d0GH2vQK5ME;F^0;iL3)tT@0t3bGVIIq>b`}65LY1
z=ubw1b~6;wq596YQ|BXu;a*71>eh7(c2?2~z*(UFjiu*baFlMl`N<(x!CLt6>7H>=
zQ*ErfSu&$+taFb-&l-7{cS!{?VUXo2cjHzp4kqXGGvtZ~aK-=|VUi2U-euToF5dOS
z1(Nvkht7rGV{POFSX%EXn#j)iZ}-HlXE`a|vOdI7!n=mg9mH(uRl@j_+nfhFyC!~Q
zc;YcVy_5;~md)D4pn)03q8XQZd=V!^w_bsuogDFP&^vR8QEW&^>Igqlp4du!N+$gO
zJIN-3poSpEo}{<N1%q#YcG!rDcp3V0(UHwK6<oy?px(l=$`Bn4$$S$%#44T?6&PYu
z7Z8HgcOK|NOFFVDB`MCmiP!hXF#5oS<S((oVY!m=WD9w3`FfgtV%iPS6=TlCyhM%^
zN(P)w%kWO8e=w*;e|KZ+C?yZd_}b0_!A6;JR91TQ<uif7+)W(!I0vj69w4c)B7y54
zZ#&X{upHSDD+*XekZyQ(OAub)1=f6}&B|FD?y419DOGkI@a6y7?g4v1WG39r0NDQ%
zw5nC+wJKo(*{b@6OT44tj!KTDcEKlahS`)-C>i)8r|Wge-+!eYa`j^PboAl>j^zY1
zDP`ji^0mOO9P=*AfEwti3*>&G00+{AyK0w&Ub*=m26oc>@__NkgIkF{n^Wbs1KuVI
zE1WRrAC}gG@yz2n05!w^E*{iYGHwkFXSu+m%u>+Z_5*sc(LkIE<M`0(EkvCZAZsJz
zxt!swc68K#_n~#O<|y|Pp|00gFn&0T@gN-{-w^!Ui=!O0ZfpVu;%K(26-2Tdbst6D
z>E`n!-zmE67f}xeNLaf0<)k1?0ro`s?4?><SVUY!H;z@9{83RiHxBGqXs<mUYMU=H
zTerMBWs{23OTjx4(elak2UQU)sr}<J=*&&elkwgwRew7sfiCHm$Upv-AY7;fTJgQ~
z#;{xsbDzH?OlrsbDWENAS0vo(YXbKS6)CUu_tkqq%|`*?((lmav;Fk-3Tefl#1wi(
z#RcF!R&~%oytEkwYMM7->s_yS!Za(LsDsYaG%}^)+%R6n$TamDl-|ryYiF%g#Qs(I
zE%HJ#Z3c(VxRC`xIe(9BsY^Li5Sd1<DF?cOQn%86Lyw>Jn&c$5HmvxAKwWr#AIA8y
zA?o5=V#;>IE|oD*Ji#ZhjIhLR2^FGbVCR<N`w-gjcix_?FTietCrAx2g2w>!_{1vs
z60%$cbkSH?G|b#y<`8k{`9I-v0HEmGPs1PMNAt{>`SU}>1P#*~MrPLFkUZqLT3Wkr
zs^Xrm3sa@>dpba+{(ic(bw6WU7vlcHX8n+^g+@3%v;rdX$sHX(IDQJMXz(LS9GZRl
zLcLgbtC~i<`)IY&^H)1`y0;=?9fLoc!1aNr9r-&2B35SZmm&)=4x-l2pgNZBE~&>v
zaOh%^@l1dih`bB5YWLAYjQ*_9kbgKUG)Y;(TsNp^@Dl@n%%#krdnwgDq)w|xk|Vhj
zrxuah?WNb_V}_vZUWVr>j~OZQn+AIRHNnihL8V@2+V-aiZLPPrWSeaVs>KQ7Dz&hx
zX=iX~v3GA!QdPVEU5UFl``1s(MLK+w)_OiWG{&Fib2L0jP96F2b{U4|g<X|S@CLy#
zIC$8@-bW;0SG^s!`RXS-(kZbGY`GeEBE+7AvwTVOIjNiCV+_Bc`$AVJ*G=V1*WN~b
zT`wz+)`RaD&}zJp#)YMxBaIZ(5ak%7FRO~bkW(#2<-G<2TZcgLkZL;0#9pCOH4=EH
z+J<K!td$=_I!_dF)7|lejWP}!7<lt?r7r&w+RH~>12H+=lT(<cexIxXF6Q(ToKY77
z&`f6kYAp9aDg0p3Exznc?q+QsR7uo*1E6c?!qPN>z-VpU=7~6(EuZ`!^edn8ex>Y>
z`gKeZ0!K)p+P-9xvv0Wo&lm7_o6pm^Pn?KJ7r$qaYy@8q>x}*T0l_LxgE>g0$l&mQ
z9{A|x9dipy)oEGmj}0~w%s7nN)b+;^nfC4bTqN?dLjG`7Ga6CFCq*?sz~=^u&f1Wo
zI??wHPDu-cMMpM}24-Iq?rH3e!whYtg8zKM+zcIEU<P{V3IUBIp{zU~>VM!r<3xl9
z9ZA8;9VbUgX2tLfn=o&IRutv>8pP_7V>Y0`*7<3%q<Uiv_OiJ=-Y1I36oO>{#kl2a
z8ExLGii~NTcL?+28NpzB2|fhf!DqyL2sFMgK+VcK%)+m-_-gUsKUioiR%!d{Lv4tv
zG&N|ub^V`=p9A)fIL!Us_d?V9>9|hW&h&q>Yw8ygO@n`gZ~avo2@3A%5#i_Bu|UJ9
z9qAGiWskR3(wpBW&nW5%D5!^Kb9ubW?}6gAN+{2EWbZ3e^h!~#VWy3Dbc(Rwj)*SV
zsjzl4f+3RUOcAs44J9I80B4iz1!ycHINckEUs}q#T1Ps}V<)FL$BzcuI|TknEic`U
z0or;)L6L<K8HFgEEn77K^#AyK+9ozvi>&rnH@E*&uO@BTwvYoCn5EY54rwcJ1!)tc
z2&3zvN|k>IyPWeKLe9dOz^T=uK3!Q<%P<i2_)RiyH4^VvEDM}y8>opb;x=ZuhcLW=
zov5UNc{6oOw*a#BX)%NUz;2nX7wbZNngWts2r$PjCYcwkLKyLA_O0kC)RTp=?ppn&
ziEFP3mNMwsm#Dr}B6<}YSVtF7TUe0;@vvefyw&e%rOc2sP?LWQyF-wx7<Umrc$Mf4
zQGIz0LSi8}#oD`{!#lMO8*wS7_aCg|xD;W1bL&N8Ba>|*G!O+wz&>Q$jB7>8-sp{h
z_C$r%zw6Rzava?=1I`fJD0GS^kL&veM5xEmB4}YXWJ3S#uzm-cn~*0^K98Bd02%yM
zCVzw=lHM@_2saL_mIOf{i%SMPyW_`!x=aW-=0_oNmlW!M$e|z6veRKTS$VPxPM+@a
zk8~H9&<5`vd?#cjBATL|xBxA0i056TVaRKex|(BO($wY6qTKixYilLYS4!goS~(UG
z)^bWnO3SUCi1}p9{_Cf9yOrLs#PP+x8~*Q502qc+UtC17SgzV1B+rzSD=$mzqhDxB
z3cRK^oK;GZ4R!?=c#A7Q>uIG({|6*-My8uQfBt#uBsQm!`v`eviv&l9_ok=gQY)j~
zJn%bibzo?%ISStLnWx=M^(&$SyBoS*-_N6u4YGa5RjJUvb%0sIF6GI=ZtGaaP{tjs
zo{E;dEy*JH`Q-#lez6z62Q!Nh<kMs7ZC@hS&2w17XPd9aZmj1X(#T^#%V2}N{#Um-
zeD702o+3grs2IXOt23_~?WCpSU?Fe}urz@Ck2kcGDqjyk@G40AkmsJC2V|UYaQ2c3
zkL`T=x3Bd<eYhs90q?A=L99=s`z4-PdB#C#?AKRPyEe~z{>4;cjU{e)zA^_T1OdDU
z5V^4dQ7Ae5b^f%_k1AzZg*2rtr#QX$HNXk!oq|Q=@ES~Al?c$qG>~k84o*#vVSsDs
z<5}J>t_amdhf0B_?m0VCF4l<JEOpMCOe}tP&0>2>0cGwa*gM+qm84CCBJqU;d=D8)
z3dJMtIu)Grpe*)BRPfJMSklK!%nz!y^h=-oV8Y1Tk9GUaFsUDhvaRQ&Unaz4LkDF<
z@|c?A&aYY0tB!u+7a4>*GN{H6(0wpuNx%HoP#u-JGZp5R07*c$zt~-60Z775v>j+6
z*uUbA++ck+&YriveYXTc_M-16v}E?=sswF<j!Y^4B*z#Hsdoxi{kj0bH+$0H`61g~
z&Q6cHkk_{$-MHwU3qv7u4lHHpM3MYe{hE6PIU8#k=5qwNiaDz9WN&884Oce_s@-b3
zCucFy&w*tyRjoc>({1b`2`bXEp6|N+!7&v&iuxMbm9jI6A1kKV8W^GEINZ&&bG%7?
zAJCABoTiyhg^41n?6^t|v1fXrb_g*ue+-1DtNt=?^3ODH^5XM=Kj|K^bwKu7!5kl+
zV(U@y@xkj{VCjxK8biG_9faoe6lA?U76ZAKQ0`$2@iOwc$B(o*ol$-Yjxdty@%S$u
z0srpTy>1DfQ55WxIwR-FFDP}^{NqATy~Cn4mpnIBaAeM%zW<PLa7J#vbC!A<eKzwO
zN){)RYCExe0$Es?;@DHE6sIFi`&Mv?%5g8h!rP6>PFZ8eAb5XXN19!O^gH57PAz#>
zC;%$gaId4fuv|3BF&4OuV-^!xOBf9;bG-Pu@KME!?6W*0)aU0)Tw!wLS(L3VUAoVi
zi4#rS?Fz;=Y@r~<ja2F66GWA(6ain_1Tdc03w$JkRkJ@uQFl`^erpyGU!(lCE;5^%
zEL&GQ`_D5x>gj`w=*Y;kfrGEiZ5}82o|3$b^$UU$I-Wopu*Ss<ek}Jo1zt*mIgZDZ
zbJMgB)tBZGCV7>67z~lxsuwK$J4_((O90FmzpVwxUc*CRAW8NOmOw4tHOE3FtS%$k
zR(fpn_jrw^hRnsKY?<JCmZ5Lfht9WYYK%e@zl_?+SEl>=-3`iGfVk2z=kW(bV!u~&
z&lo-#c%GZHo^}Bp1N^wNg`u>@CLyzOd>i~&^i=JM!-!%5K}C*q%$Ty&lwgp4?4QgU
zQrk(_?J|KfO&s3Ww?5r}6P`?A&8?rEoD+7IRR<#${ZbBK<0D1!>=pkbZ862u2^TaW
z?psWsEDfwY$)GN`hyZ&nU@51~hjE3|w*{$?``ccgtq_1HaIbC;d!^#PaW0_gt*S_I
zba4Ujcx(wc>u^p7^fl>)K{Ux>O%F8S<}=PTK7ZX^1_p@t(~Dw)M5u{e;B21_(&z}I
zq-=jOaw^|vju!@8q82%C23nHMb;vQZa0DlYwhMMNRsB0OZA{@rrXVsuf8Aj@5Yhpi
zh%P(z5*O+euD+q$WR!m1QDU)iM*^T3iqP+c-8Igu1Glat8qkYwFrS9W4Bpsp?Azy?
zddj4hP2tKo+9`ede<@*l<3k;@F9$<X?R{^GObjt#E8JYg2ssIJZxqME@GJ_0rsf{$
z7|$)r&tglx+9^LeB-cnSe^X_%bq)5B0Y4*=Er#U%Tpy5j%jWn}rWQoe*w5#dhpmrb
zb8<W7Z;n*v)pv62p=UKI<{7IqlR5hFT#i!2xN0MW`WDNrO?ls|07=b>_?;B5pb4QK
z1~f5O8D#xw{2PH%WdAnY(z)`wo#@VP0#&4rI4?NyY6<jbyB$9ZBnbUJOYo;xDyTGv
ztBh+exq;xP;5J``Mny(=Mh2vMVOl#QhnZZ|E1#vGmcgIaa%C-eh^u>)dxytIbgjs%
zIq%)hwlruxoAc2UtK)D~!DIg^_nD1=Z2PzGB)a2Iu;dTNo%XpJx6cQaiEz$zK$HqP
z(D@(aW2lJgz$&CMAdgi%=9ZKSoGhG?&7m=|(My$XyR0ZM*G3W}AKVyL4F6EPy!qT@
zUd<`O5sFb7YX23eawu@ZIUH)ZG0||6wiUWgRP!3z(njGIBNUtOC~3v9{A6lREH7KB
z17+|fR3+2^vyucV;_2No_u^<h*L{UsCyugo^9)u~(M1BJq#?Vef;)5bCM3k#{P5FK
zokS(qVVF9WpAqtS6_*lTI_;aP51#82S6C^rIhOJMcZc@=Ca&es)Gp}WI(kmZ)#KRQ
zE+qtj|Imk+UTdXgEM2uxhZN_;%FiHec4{&lKMAy1Y-}m+qh-7l%&gzLV{%^>ITD-j
z4Q<X7(;EkUiGIFn-?60>Zxp?&->wumcM(^jv<@@JK2Y19_(K#)3YYwDL>>u>a6(4O
zWGnjZ|C<8U$OiCs@)N#KTEBKHZA?Vf6374(-M}u`Y%pVn@esPjN+0J!*?8j189?ZS
zoB|Uhq<dk(^G2LVy9*dFRHHoY0zbVro-PhDMnxv;DJ<zYxZ+J8T(o4|je6iE{z!pw
zlu)6>9q*F678!U@RKqzS!vKXEj#c##y49MN^4UQ77ht>oQYgU|YE*{w6;UCBu>Xyl
z9oOg|#R(~_OjnJ}gAV^sFse09s<f(QPfGeQNhs`@LYuh%2e975nyXRY%we22ApCT^
zhO7X7dxA;-gEyGoWxFmw<)MiQ<YhXQgnR(JFQ_IUP~0YAMkQ2rAW-1cFA6pV{kHPD
z_^TqnS7zA*?nKcPE4g7)kASDkOhEtYaNT^SjA!l&3<-2!`&+Dy3LE!F+|tyr#wvJ9
z0Yiz~H#L;t)kx<=2qEunT>dhwB~QCYv2kS@0;F&KV|0EQ9q{YDf<F<QZ;~0}6e8xz
zBZZwuu-P#K-USvuJA;LR+kZwOO}Vnrpr5S-JVj;}^?Q8BEe~6m!n-B9Pa+zqo}25f
zZ@r=LmXi|bi!9{T57#z<iwMh^MWO$L%MkOWwwkP~s{$&HJO!aVEr%Kuh7Qn}yVP%k
z=7)KF0;g7uM&;h?ay^GoadlSFN@dz&$hN~DQERtb4-Q*H+i=wa;lnEEk1)wPXN#tF
zIE#ZJZ17kvx#o{KR^hoGo$H9D9H~484on<p{Qm?KC|J(`tu-88!ChFb+<Is1uW#L{
zGHQSFE*ul~n4^r}qZo!HSxKUP-71W(Z`_DVuTXo?aNTLam8K_kAgnzh1Zu5*3vEmr
z-eL*%OGdTUpERh{B@}V9Q()hI&j2q+QwK4M+A!jpL!$k7Ose@qv$tuo@+j(F#e@(W
zxZcOq&c&9tzE%-k#)$3s)If;uYGL&CO#?F0uh$-bcjU><Kur^sA|CO2)A<C`uNWW!
zckm2_XKG~vEfV>wO1KW2>0`A>Gv$w5TM&TeeQnhW-+I4iY(WcJfaZMamuYj<-!V64
z@W7ssP#(&z0aen5x_#IWdynV>33)PnDv-t8sx0y)h#Jc`<=y#na(3RFUYJ*s)zaf6
zcAs3N!rff7t=^ba&1Xp0E7;c_uI-{t_|Yf@CU?Jznw;!sw|}fs+(`E~dhfcW4XEs2
z#6tGjZG86z$|EHpo3k!Vm<r#wq%EmO<)Q@zJeNDx+?YtvGrv-TuHqD8Z+5j0S~7EO
z-;OL@!YORg*#_)-BmJcxulh7{xU|4IavMm6dym%KL8zX-sf&y>S02?%yZuI`eYb1w
z4wn8=oR<6tKYhbrM#o%k$bk8&ryh4;JEsyFeH9AWH>X>JD7lUoQyL83VV)aW%@|Fi
zo-W5d(SggY{xJci#Y7dZ-HIARvTtcuxr+FyJPC<;i?+tHIG+UMz9QGQlpY0M;xyx*
z7%N;n<{4{mR;PkqIfW>P9;R1=kg=$LW6GV5a*$h}ORHxnsK|!p4#!fqg#p|5QsI)M
z8A%ZOkg}zLHm-qyQ5Yk1a$n?hB-1K9V5ezZY_`6h5G0}98wh=f-qUL#2Fyv=mJ#l}
zqg`iw^H<Fysfu7ZuaS_@Sjl<gyD8+`pO+9k(=j!YRE^Bcnb6b29FQo!j^X*dH?7wK
zpxRIqz48}j77l}PE(p!4RCr1LXU$EnApYH9#76|~ysv4fqn})#W*@vBtecY@rc!)!
z1h4%_`9On9Qaw3tJn-B>-CGpcgvzQD6WnD6_g6LuN+#df`ywfctH1V~0pWd)v~?Qy
z!v}6fu#gbJx^X3VosfP-Nf=Uc=OwGuA$#wwlwFs!5>}nN5*z2m7Ip(@NP}vjAlx(2
z6^)2C3kwh*9v{mFp0VBgJAzR&%DgvU{QN99r6{HfbP_>>cJJ%#4|OwO6NZ^hQ-9{S
zq&20_XuAYziW@?D(nU<sO@<94<<(5wCp`Wnu?)8}W5RA+rs5I{tX7xi#ZZv7jehN%
z--n(Km@_lejw7F6iTa0>eUf}BF^vPsD$5Yx@f;;HaD>`MX5oVtMJZt#C<#&!y4hO}
zO7GQ`0KVIY7NJXT%gJx~V7x=o@Oa)OGJoIqDWn*&!vTSt_G@U|vu~%~qA^iK*+Hak
zt)j^YgB<gUfw+YaHg-aU`QNd;1z>#+@_$XhI$PIu{;d0Mn{h?)OtKY^QO2v9qI)t;
zdgKDtsLHd>r?i7_)g^Uw=1LG$^zQF|bD78Jx&A`okYCDBYm?H$EZ*<zGjv?jQTYu*
zY^yGZ9@V1@^{YUXeg;Te6yBF_g4UeUp<#U6Qd~80P)T~|hF+7tyV50(2&_uS>3ykh
zjEo7rmnYRlk>{=rO;bPFT;?h~DoMvt1p_4Fc<d(V&LK{@_~!KR={~hOa^rw7B6b!q
z+EDPH6q(Rd*XEMp)Z?8%!Ajb;w%{6{w;lybZ4wSaCRxp-TIIn$ia9;sT!5P0Rm=J@
z=TLLK8MDjnr8hgz2;NvveFo!U8hR%Ved`Ald1Tcwb7WPQ!J}nLUDAKO{#|VzIg^m<
zVcR59r$G24v_9N4^ct@j`;c~(Ec7u4Onob``5DyYet^VR%Uo>2%zzAh*rkF}g{{h`
z1*46U++>!R8BzkksSZOdJHyKALfj=__^5eH?R#ysbXZzMF?5{>rcK<_Yo0DtsCy~f
z(_IBr)FNPp!4b1$&($v%I=dL_z?rXsULuY6oc0HfD9f+op(Y*Xah_#cIv#sl;5Tb?
zI<`RR^)A}0N+MoAiIrPRzl|eMLideuWN!uJ4i7dV2meL5qNhGt8<G&|*!dS=)}y?%
z`b;RUb!L{jco|h?wIT}37oL9TDNhE7X8v_s>#mN<xb6r?*KJ-}My&+Fwak&?8@Hq%
zPH-#hk<nYP&2~z4?ahn!Lc(E_-q>9cgXrtqz*MqN)f3p-9xElLg8ibk83CW6(*G|o
zIpu(o;@DT_{E0ESYkY;L<=DFnfQ@%|_%t(z^qf^b6(y&oVFrV|&9q%c^a0oTnR;-x
zVWx5!hvxNWM@b8h-Wk=@W-#osurC+Qs8?!o<=WK_grKnr-}Cbb%duaxmpm$Fn{B&U
zgbjB&<6`rln%@2s(_A0ry*Ykoj}}eCp^Audq<-drV$g`0c8_FG##Q*#?@1dyXTCkW
zC-pKm#I1GyMW6Hyf0KDWkzc=*a1jd4vaTjxvebbz*4u;l+nEahJIV1o&*daR8F{Uj
zgypa2AY&ypBSQH$EjsIn6p<zb+d%@?CEOYPL?J3kK-w?NfO?Rl{|Ke7e?PBa4q~)B
zE*_H%(x;+skHf?x3HV(nU7y`~^+J6BIv=+L;j7INO_(W$8-!0T5zEm?%VD~&9CeLm
zM;(_J(9x9&O=dc;1V*sifQDxD`RF<#275#%Uxxk#J(a1qmA!B=5|&{7+v<G+m*!t0
zH4301Ps$~%?c9RktMM{m_~MS}SUWHC45+H%qXp6J`T*sk1?Q=aG@f$)Cgm@*CHT!z
z&@ipl70fm+2MZk;&*Bv@<*)lWmp5)AIng^{LUe5`_pL5&l;=4V6ORU-tx%dA>z+L|
zj1NlVvPdF#`QQfEd;ZK&LYsscNB77>ql;h}N-XvT0&kitw@bQMBC@FX1yB4VS2f$A
z<>wBm><yLTfx$J{D~{BbKN-+YKjD>a-viG`<6acQXHnPG(IXEq0{hCw6`@laXH!*I
zKzjxhIV+sX{eml{BQH!qqb}iXr5s7`E-2lC8$Y#=F}LrD+T89|mn>%hirCmcOX%S4
zYV;$o7Qs=~=(1a|8Bmo*3+UqQ6V(P%z3Gy=5-5zTR{<=j5_LzMH$ts&@jFf&cd#vx
z`k1f;nbK=$ZI$uxZ;zghcrN|ZNXYyM&>;$Sj*db~bgqayI69T+OvaTPNsPwB=i`Ln
zQB*B1_$1J>6}@VqY|Eip=^3etWgKw3gRJW|9!H8fTnm0Ib*743(3T4`qjKj&ANs9v
zz?$Ly#j)m)H`3^-vdmvMV#@Feisu7sWmw<QG*b~L^^I_OQLIIA*IA}yuA+arnFTqn
zz(U!?%t+JjE_A%az=TpuTsrR?#D43~@3+b%Z5E0gsd1!K6sEw@`EGACuTEX$lgq=e
zcGY`p=@v8_fR2B2c11gN9P#HsHAW1H^Q6K$jl^1+BW*D)_pok-5UBHmF~_QBJ3ef_
zr$U-p)qizoOU5kK!h(N{#iqSlsA_i>ri;C_!6S%G{jy0w2N75tijzx{LW%;tqWmql
z11*2Esn6Wn-Rn@}zqJdwLUlrcUgX1p`a3MLqJKe*OHnF#E_kVujI&JRz;r|nS?x6v
zGkoN}eb4GM_$+HKIZOwH!xJ5YI;za~3TzF7om3wCFmp8Ce*ZJJ``yD!ZhV<iwmm`y
zlunK5xIb#9a>jVZ{-H5(M%gh9o$=sSeplcCK_!GdRH07esAHp?6CWLdpV}%XWZUo{
z4C5^*=-#z`%AB_iz4A6z9+aZHW1q+S;z@?n0AkR#pyN2n$HynJgaa5rfl9%KCz5DI
z3yfRDj1l#cao)e%PwIA^HEL320yE_%RokO|R)2}Z>o(vk88hudmU!3BJ<wjH+mf5$
zUK4q^b-=R5LXjs#B4HT|FZ9~Zn3E*X3g51T00bXU_^7EHU48HNXAqC%yTS0p#%i4+
zd+KA^GWm+-ro#@GS8-B=!s7vcxy8EXQ}OZ=`e*wfbvKri#N#{<a4hRCy6ip{AcRr+
z)mT?MfbsAR1EaEDD;y2|7C}?1*L_Sj8#v-i+XRqdURkdY4Y8~4HeIS{!I<BRrSdP3
ziHp~Xs!puP0J!FdsI`#H)@U!sZZ%2+r~)k#<I_$=yin~&LErzpoEoXf`zdKQ;NExE
zH(qBr(>rygz2WxOlS4H`k)X&Gh)3S{-Jd`>ma2^>{S_3DI0@U>p#G#J%~FWJez}q3
z<+TLmj%N8a^`6~=R>MfngtJcMh1*$xbaklA8tBFHr<Bfl3wU_;n1TRSKN=d`lZ0ai
z2Qv}yO~SumsA|=X-9l(==7p_ow>^bAy=Y{}>ZKuX%ir*O|M?21tGhaJDMO$uy8P`d
z>MC7<;A97o#60g#ze|_0QSQ7*r{UbZ$=lU5EWNPl=VI;@;=v(#FUgu%a|!JkvXx=J
zmI2t*3E!0P_!A<f;$!kHS~(pHz@#f@wPX$UQuaBbF$Zk3R8wTrJI={(A7Lz-%bGH%
zSoG{`n=0=PkE2v$-*#jHl}r4JP-BNWJz^<9b6NNe_%pC4tb`-tFmAPkQ~F_?DACUY
z+pX~OT7g?oYEKZx?Uv-KW~RUPI-GE6>=>B`Hw}uo?oEf#RNgG7YQT?lStFwq{45&w
z8Tx~A*d*M8x0@*4IPTj)Wj;;?2?q<By02My(x2O1K@qb?*_ORaUS`0Gm~ltr8Qd<y
zyuDQX+_c5@M|3=%!j4n|a{S0F-h#qnZ}ahz^)AZS7dJdxj8Dc$%$?<WJu07G800;a
zak=oKAe=JI6=F5N6}%EHYl2dY8KxV~(w+;vq-VJmD(Fxx!6Z0P1mUTJ?-}|U7vLK2
zVm6)!Lav#$?_wa+aS&P}Zyqpcc>^IUdDp4%lwfof4$;}OCh9)gw)FvUx|H!uWU<W|
zp%Td`9RPAk2S<pzRILG%QgVcf4^mm+TGvzcUOtE+qHjAHt@E!bSqDn4gGViSPZxx<
zDM_<7JL--bw{+cJy2hFFVy=R#7ZMpeZpGxolh=R!VzY6jAIy?1AumAh1Rgq@oFL}p
zN<fLl|7mvmdMRVRggz$;sDpN6AIZY;`O$aT_AO#Mwpqx_{TqVe$h^s%1s02zQn1$+
z%_n6{(xO4G-Yf&M$I^3;*s&7@U#ys6{@f0Pz(17`?v1=6bW17pl<C2w&~lV_ns}vD
zhPk%%6P#RyMZtT(5Y&7_GG5TcTx0RddY&EZVd*#Qy5#ynQ{a*1PebXz@s+uEdzBvI
zG=kz^m{XTLDq!H|A8z0(j8uw){N_`X#P%h^nK+ITaL>@6c$V5_<wvQIE}yFePAPtN
zoX@g=GAavEt9q+gU16`w7}MO-!*9s;d167;FkEQnFusOQd_9bi#^TIaLlf=YX5#Us
zz`fp~yZ)5~#V-u(YPtqd?A!n|$RZ4HH{E|DW>yU%z0(l0K?C3h@JVEr5yI}1AtU#R
z3B=3)^6*GRU6D)ppbMe6ft;HNvdr*c%H0oHM$tI7q+RmBS`o5do-7$w$<m*UvuG)c
z$)Eh4F97Lb97Ak(d#ml<wxSX8V>zfswd|t=#r0@wQFSdWg5BgVM`AKp6JX;-G(NvA
zjt1VB{|X^+Ll_Zvo*OkSV%)}Nsol-~Fyh1o9)s<X5;T*pcD$`bPvP(c=eu&+a6(W(
zcw8Zp*@6@@>n!=QvqYm0G#SZ>Bf-1G<fIz|<wwaXwam3*$oz$qAYx_@vUjzX^)&85
zPECf<g0)=X>VCX;b<|q3vSH8x>Og9K(*KT=S@kn;zlHxxIUGZsR-`F#FMtABSTM=a
zMl7y}(`;{yS?q}T1XK`9y{1W5)N*tz2U9JoudDB!D#F>)N(UKKff4y$@u51o#j+3-
zGU|WTFaE*FXwu#}>H@LNF}&cvIQ9uBK5HUT1g;=2J|EXIxCL-kTgO53$`+Dr?%SgI
z+I^Z4N5I*F@2f_l_e!4#F+)+qC~jK#W-*)OCqJ2cPEvErZsQ|Arq04dC6%9@Q)`4Y
zr(yXApRQI@0%aRIBZFyC@5W97yNySk=J&0vjQI%Fj`<na+Cz&WRi{YL<{2lW!05Y5
zq@*D49-yl_(&yIJ&Lc}PxFM}j!t2{bHB4XikynlV9p34Mp(mb6_Gm4x1y%#Oc=o?(
z4yJISB5POhUA*Nhg<_Z+Z9*k-gwGFPH}|OFV!|pd4x{8|iY$M$`Q07j)&I@Xi^WEO
zt_5c)?pna}R2TM5l@0Vli<>+{)7XMmu_6Fy5GmyubOk;k@Ti2WZX2uaZoh)eQc^M7
zIp3x%n@0>%I5>kg<^6hgpetrDp7CAFAW_!ibXm2N)~PIogANqnrSb`4Cba`{$j8n<
z2=~N-)l2t&Tqf<Xf9WnA0LQB;2*91r5xb-3jX-t@p1p{egt!J#=*&eglmi!&-v5VC
z6tm5Xxjc!V1RslEdTbS+-Yunp?cPrs8XWq=!wZbx*1lprR`gA8gOr;4@^_mNOchY;
z-fzXc#+XM@$+mKPM{HIjAkVR)NF9qy0fPE7fjuiHp%i3yfzDi=+=GfotJXi%J7)0r
z$>nf&c&b7`5EU{!9w&J<v+NH+X39;7OfC4!C)~9%6&-Gn-}tbLIMv%S)0u!SFu%B8
zf&{+2QDJfgf=2OjzoX9{vK<B4F)vwRtuO-lK&oUS4YVfa#I(whJ<6Bo$|=?7kAO?V
z0v&UA{2?tVfbCR6yZtE>M}13`;+0)2JYHF%sg!H@u($O{@6)l}w0u<qGyEL=+Gr`n
zmLXyvyljt!`U!hVuT6tbGy+q35ZhQ3X4zU^i4^>ysF|;$7JzJUhLD?rW>b5M%?I%E
z3jPO~n;oZUc>B*xfIY!e53HE`#^T0v$|K3YJ#{fw;}p#4on|bgO5Pycu)JRc@8$jB
zT@1B2F^+fnIiYYIRIGNESpMSuR6um&#am4Bw@P2}svaA7?x3*a7)RV{kM*lIH+D_u
z)0B5NZdHHV7cvJ~WQREG(h^?)nmH#Wcp{54d-_$^2?Mbg%1z72J`jM}g*))cH!biZ
zEVyC)yRree?omoA0g33OfUm<SLNuvenTtMX%Rxo3rSaKX<9aBYBuktdsvdkU?<{=8
zHo2aQ9+Uyo#;Sss%CC<jqqnUa4wQrDN&!kZvsH1{8Bv@;PMY*87-awoG@ZlIV!BMk
zWA==*+JFqNnPgE;+Q<|*y^o>a+pO|qG&iJocHS!PO&$vZZOF^U*h@^2a>*8^y*?B@
zHK{RX%NsXhBDfT5H``Xi6JtpZxXUmjF0L~iBDpjy4^)NHo^i<UsvZ~im7e%o>75Y{
z3P)y&j2~vSgBy#IDhC5~)!k0=Vfn-SZ=;I!ELMCwsc*e=auQ4CLm`^Z3CqGO8~~(L
z+d>tJ$N6399UNIx&g#O8zGF?_D)xbairGe9oOI<0E~|cj3d`$xHnn}Htg;xvIf^kn
z5X=`#qi4v_QR`1Y$b3><Y7Fnp%7X3I$hWVB08z%W6f`pUHZZDn^PHU5zbjlf=a`&*
z97Dqo|FgfhX9BNP(&BXrX*qq6WkVoV+WEW>rk+w42y5nE3H`lN#THV)Q2vc*&}(FX
z7U)G>kvAS*bZ9#3;g>&@R2)`o@Cb*j9kPR>{}&SlVt+8fZ&bh2mXX5o{S9sPxi!<!
z4~umX<D7Gpx4TOfTMWT^kllobY6_zH-R7nD(5}$$1rpjQX}&h=P>_kV8wceMb8tkO
z2?NEp_7Rhx2Yv8JphbeU1OIN+rs$xmi>EQZ9c5KXAsr#O!^ToU`h#hZ2Id)LSIb8t
zXK(sSUf4<kjN`F6UWaekw9}T|qssx18CkJP!%&L9W5HPDq7x?am+mSu72}uSaFniA
z-LeePRgf_EI&FlW!EBd(0J1}`@e5KPqr#$`aM>@Yz@RkSUeCD=&pOYq=a*;$%m0(D
z(khz5IFdpNlM^QU#)6A=_8HTGRc0z2aiK0dmDzmGtL^}<yH(HRzkpHuNBs#KKMwxf
zm<r>|)+N;#mq721G@O4YU@XrMJ8D_wRS6TFqXDuM<5QD3w7cwrmVwE%`kK27Qvm3A
z2q>=dFj?fk5!W@-jUvs>qWSqp^WDk#7|FwaSi>pC&@?3qNI&*@&y$FhDcKyS5xC-8
z)x})Ux2zy&W3J*&^-=3e9Y6ALJ{T#7$(3hRt-yUS$<FvxP&Dz9T`V70)*x9}%P~z>
zc8NfJuO!*+%Pu#mJWiYHw;xzBoiYrZ%=I9Wtomi0CIgoie)Pt=)L{?gb-3Re_Bd%N
zHWb4b-7S!&{p5tWZ{$}>6m#8=YrgXsa?s+?CfILb<xS%|rId1`zchGyY`pd-g^QWA
z220cU^w5qsbL7waiy}$!6j?tHG=_3Dr4CB5>Gs5O$mNh7MUUD<T(|U(%?7KhU{UeR
zYq~(<xR)3FaFDOL{{Zi?&sfh&!}**n9)z}+{4TM#+|LgjRLLR?p0U;}gW<0ixNN+5
zutO-`5`MCXgp{)_dpC$o&`(95rcA{l{#Jp^B#7<^;Jx+ZEc+5HuOk|bmYDq~u2I&w
zyi2veRcg4WsRGLchS)d0rR-e$%E-R<*O^%w$cnf5%_OZPM|}Xs=^hSKB+=z$-`Gdb
z*mB|Wk6kjPl5m_ikE5_7#U0LDjib_+X=PwWoXUTGQ$uCWkf)bsR#gsKh=QDW$(w%i
z3Gnv;+j@g?t6nhkbI|g`!&f44_vMXj!MWwOOiVNxd!AAhm>f~W#<PeR@8?=0SNSzt
zgb-R~$z6GG@;+rq=HI+FX>4WWb6s4qOBMPYoj+W>wCjiJ+)@`z+6+g5+2d!Q0K3Hf
z!5b5(FU4~6sovwb*|o+ke;o*Lz`*u>Sv<7yY?m7t=l_eFqYs)c__hHYx#$e@*UwEA
z+b<$C*2rbDO3d*v5EYfNHbyR4b%BxXcfl1E7@eh*W*u8?)TV0jv1E5;3SUqgd={N4
z2Y?3ghFjb>Yy0vUxJ8*;*#m+ibv3xaTQN2LeXS`=<|HD5(s19Qhq6mLVO`VR9|#=D
zi7A)I-=akw>TdELRQE=Nt7c3Zs1^3@MxaXfJi3q1{+|;pYsD2o%5_+zdd9H-qno)M
z!(Ld0j7Q&12~KG3peA%+##%-ptZ){9CtRJG<+e+Ea?dXtL#b(`Jp9#i?(w%0yl`S7
zNxo+L>pc&QikOy5?k;NkD3I%><1+h7*m48uhoJ_F$0Y}Y$p2J>cBsil?Qin@J*VTc
zw$K(x=U+kJxqA}*u=4hslujCItPl(aHQe`f97bWW)qFw#>Ht8|{FbS3ayn_Yz+h0D
zo#6b89jhx0>&LVWRF15)h}38eud6ci%5_q21Wv~1Rtq?GbEP~i($>?w`l)ST$m<h3
zbA1C7RexF9PkizOsNI({KvB+<u`UqoJK9w#a9|9{=(T805^#}!mE5H9kyb(*h8?>L
zC0~r>DsW#8@tlAKfs0>j@sie6hJ1CJseVb5$T1zJ)MTb3&u)GTNukOYGV*+4<ueKH
z4`lJ8Z>-oEx=$<0Xw~wQCE8)B&aKQdIa-hpHj8=E9HI#>hYbN+2!1ydBe{aAMLHv%
z>!3m8BPjkx)xTWPM3<PKs^eS2pck4TY8*j7iQ%GAE1eq4L!^ZjXfOgf6y<t=4KBf;
z@*68QAJSd3Tl9`^H|Uk$@iImDpD(o?nsug?VGWTU%A1Kd8vzkPstlBnd9T=6)IRt6
zsIfV5rU5#}H40H^h7Ws}guTq>T+4Bl7e6{nN&Omye&D)A<aT8kFWtuvcegTv_Ffl;
zvRMSZ)2>KY->I-JiEGA`(EvA7h^e|y)s_U3(J^BB!Z7V9hBH+5gI!Uyk2`&y>%IfL
z$Z@*{-y!I1iCJ<zsA4b)Q-JW0(E9`{3Oqh*NB4FOxP69qFm7I+xf@A1gpuPsm0%fI
z#5WW8k&CW~d1w)HLR~QqHMA-f%tX2A3ENNp>NlBs?0=BeM&m(%uGD_aO!dmpoH2IJ
zF$bOE`I{^(tx@|2g1kxtn%KxnqC&tyJzNh7OBTt^h61W1{*1YSa}P+T%T6j2k}uFi
z2eJxL8HlqC9LQh*Z><4%CvLNUcJvfElIj-4kBTA0vZW`ZAQo|;T&>vkizGQdpSEZe
zmy_F*Et`)5mdGm}`gS>wX%3_}-O8zKlnR6TZzzz<1)CxS0obWmRo3sGK;?)ET(o|;
ziJs%T9s(W<gV~{ek1Uz|a(%ILjb=tdJ~M?oTLzEh5kAs-DtUiJG9~tWb0U<b*tl76
zZzSD3gOU6faUo_gTzNZdR2SdBu?V`5=a$stfG=AMj9_Ex{YLwTTPdDIq5jZJAKjke
zY@BjVswJ?;(L+cce{Gr&&F(>f+q#kxZ)3AzX3tQ=kXYGf?k)~HKdcM@wl=yyvCRQz
z^Y2^S4;~_HA6hCglYSB-{_Agru+U>fB>HkGhN#Rx@b}r&kZR0K>jFR12ALO(ygMQ#
z)_>hfhfK)O?dqG4>8hEXR@Qr2`Q;7+@#BKpZUkShe|FpZsm!vWcK^$}ROJD0oM@yr
z0h@VL(=W2RIk#r>X<blmNzeU$Ll8hy5QHBni;@EOm60rM>Bgf|Ob+d`Rwg;m)uks0
zxE&NQOUQ2hLrr`qIhxt4OSK~OS@M=xjUsWJW^B(&RYQ`y81KLN?n*kM{Uy=Ia%Zs|
zcZv)Rmm{*P^76e21-_yB?uUTq4L<RUOF@4EZ+Ob3g{ed71qx2J`DAUp23<y)*eizI
zgXqJB9}Lq)UKUN|lX<1PzDMrKkr#E)q-w!!56kcc#o_IKsYh11_M`nE+5cQvU+Y0n
zs6oQotyF9_i}jJ|QPq<Cn=g967?`;&^y>$>LhNEwuwJh>n0bI7dvK%Ky^Yoyu%wZ?
ztk8{uq51~7SV~1t7P!c7Pk<Umv$Kq}tjrSz`ur)Cs#f|`>3p!Ua8CPk&121{)Fy`A
z6#eW}(_;ByaUt~H5^efXbJdvA`~$85546upe}!@~yVF)JjGwE}v1=s)dgt+gP7Q=z
zoTOIjQ;Mv)Ow>?UBr65HrwiW`GXErM{V=xJ<G(aiZo+nx&r5>pJn99#EM>{)*AmbA
z01acr8)&Hi8$w2f{8`sMy8!>z(xGwcA_jP>N2A6EHbd!jNb@GsX6EC>Kvn|X7Dt^b
z{J4!q_+1H&YxYKj$7!LCU@q>H-Y*(sSJSx5!y(Y0ud?E_FEy?_G$<z<mp$8`K^2zF
zZi%vTb7w!0iBDFF+3$<)bUn0rVgw`FxyKrF#0v_-@W^8GA5*NYMt-Rqp|v+E9UWBb
z1#}`KN;|=ARGg}}$dj9OgNj{PjjlsV(JbvLrZ*KFmC&ZQk&Be)iO_#umKek<D$m+2
zEl3fh*^#U|0Zgu+V8rla(mgQxT#n~T$IfiKYx<S=$laD4wLSFRZCy1|yZolsvE{E%
z;p|s5!=WFj%+y#%!3>6tb|5d+#_8(@pZ<L@SOYp3qY9uIsV)dMjsCot)INt`Qh}7u
zaQ}tZ&F!>)lWO{$ouoqUp5<kVB_sL!7?t$jk__`t{!`*AdR%%QK_(CIqxot2)V^v9
zq_v7-r-d6V5VjydxZ3<M#_y@&_(l<eZ*&NO?t}o25lm0B4VXx%H(AmDG1d26yK6bE
zIvyAsL(@cIcADTPXKW)PYGN6HK6|_1HtmshwaX3`(u*8yy`j#UO+K$uXcv|?QV-$o
z>Xa;Y-s~rH_f|g^o55CJ*|IHisFINL##kV=c<9yi{u(P{z2KlgoTivRG^7FKsMYFC
z)`d2~j%e8%g*dMh)z>zMn_{Dp5u`GUnu7cZTNe|EU{GBm+hhz3!*F~YmW8AW&x;Nf
zl+d}EnMe|CJ!1xMfCV(?^A`V?06CM-r0JP^*=?-plg#p1%rz~iGK%9Ern{~4zw;of
zqr|nN8f6q_tYtiT`kc*Gc-B$y7Gh>&EY2jYywUuEGKhy(u@8yvpQvxHJLE9=Mb(4w
zAvj!NXsfAvIjwod%8*6BU#AleF9fIKY!^m^eBkRnWr}o;23w>md8i!{MVSaYjMY?o
zP9Ct3HJ_ItG3=oe8JnL<h#%UhsU3Vi{<DK#6F9#bx%+OT6cL}-UsNcOn2zIT8dSP)
ziWr7G{frKWVLy*|JN@^5VYKI(x^S`P=7ITvo*m|Hn(11)QZ0U0FidJf>V`BpWCM_V
z0a)gOtLLdi;!FPL)+Hfk9ypL`mtwI8b@W=fNtU%7EQ3Y2S|Ef2v}BBly?!(ujbO9-
zU|j8#E|N?)O8X<5QxBHLxB$yv^R*Ns+?G8QWi^Mv=fZ#`sey?oWL5hORc>hEsvjsd
z^$&`IY9vP@_*|ubJ+qc8MIvAXu*#b2+yjU4hItCIvzwJu5N#S0;Ly_CiTD$7g*?JI
z9AhtzGG&Dc0R!D)BI=^IZ@*}DBEkQxQ=}WWXe8<m(7-ssM->x#e5`qbf`CJrDuH7}
z#L4kKjSVHW7CU}PM0&V7wj;a7!d{;jEy;Fql1WcaFX`de;4c|{Z~dNc7C-~C=w%hr
zwBL1zuqbTL@2`VkB|-oiD}kE$ly0!qU_?0xH-HIK>CMmt*G-w#F<nX0>4Y7IM}f&3
zj*)Q~FOhnsq>SlPh0p&M{4`1I8bg}Gn%4y;H>FTI7G~PBZL-L8G$d6jZJM^6Ngm_P
zF8HaQJBn(9E{zG5;~Sh?{2RjYCoUXOiFMUdys**ghHB|ZM*z2AI>V?pLwe@bdLn4t
z^SnVqeZcw5G+z)*cgroVO{}Ny0@OGu5Hb%lM|B0r&OE~%2<q((g~Sl_1T50rVr`Jy
zkvbI|hY?J|c*_mgwelLf)Wj)Kw9{cdg;bxN<8tyxMiRmNe8a6~y^Pz$YFSQ!F8wHP
z;SGupQ?=Iceh(?GbUrxMD79zUn(3`}NUv+bq)qL)Fnrm$&>e<jXf08^&pxi0h)f~-
zj!L&|GQaJv+D30=>V*$Y)tJFr^)D5DS|bfhum#;9S?K7<bslkj2Q@247a;$ojR6yk
z;xG%!3}((8pA#J$MSve65-Hg{|NqOUCFR=O?{ph@284uC;AqnJDDu5txbfBqm}sJo
z2`526cdBNHnVuG`J`>lhl;!#Mub<)@7Z_obT<ui_!yUSnhpJZyMFeT|8~Tp4X)`F%
zy9+qkMWc_dY?$HF@MI}?dwoZuX%swA@_aKY(Yq&pjb+I0P1!)70G=R$`-(PpNBTeV
zVna~jHzSSjjK*Z_QskGay7GoN(!&IPN`8al4vnp)plXi1{!^%e9z#evZXJg#1PJ85
zYVnvhZgI5}+{o!ZEf(sCl!7RYGH4kja9f;E&?ycpE_3A09d?V%>)A{)*F`2xoC-*c
z^bUY1<mEF4>09jQbu<-qdEu+qS9GyQZlj>AFjPT}XfwJd;!MA4k9zamak&zQS6+D-
z8nukKA^zdFu%QaM?p10k4~CcG5>l+@A(f?>-gTXWRj#Z_TNA#4qrI%KCnLZ^7}px<
zG_>h&e&V+GgRbr<$Bgn_7lNEQL6o6Vtg%(K8z2gd42(aYV)FUBF;FT%Z5Oy^=qIdo
z5;sc{1SKSCc_$(=8LBWY@ICYuV_G6yZ>0fMkJ{d=oMERffESwlFj0haYThIgfMfo@
z=81YTy}D^hN%Y&9RS48`N24L=Q9BFwR8wse-UWnU{@*ugD&`u5|F<2vmXp!N<A>vp
zgIY~wj13QyIWB~uO044%NFaHZbeh#VO2VSh-R-pg;z1-ZZ$)PRsKtKv5jE}LpmADV
z2*|uMwX+`F4a6@*E?q@^%I`20sT`zb`781LtQ`#|d!9N*H(rgGvEBfx>%l@47#r%M
zSF_2=dlg4mpqJQL+-n8+4DWi7YQzWncYox+OdQ`bk6<gj`=Usu6poI$l&zel2Q3k%
z<I}}s@^BfN(_cbedco-U5JhpjyB(xk>)Cc>Bv#G+qT>w0kNacW8QBo0;NwIhC>F^@
zNQK>e(Ck-eC!99pIMU!YU0@@8SIW~~!){u&VT|N&f$u(<wPmWk>yw0*kd}nWp&@Vg
zI4_EbMkf{0J7FxY^#tq4(7#!iau<G8*6)4^XI%pU4Ydq6EI}}?lAT!Tv-bL2NC#M0
zYTYCe#)|MJ-hoxo7}od%WB6OGj>5z$IO%|YGyP~o>y?jbtgif7)a)f8weU8zV;1xf
z0!Qpg!k4L%7RRUD13DSkC!`R}N(Ch*EK2a0q+1&88>B)-|3Ew?{-@_9>?gs(t_tAn
z<V<YxJo-R*xn0w;2|zBExbeKx_9hkj1=OuxO-a7UJC<ol=c{*U!ycppyUO?|^UIlJ
zLy=@Q(cU&bYa33EH}>J2_2dfgl16ue0~K=yTyFQ!s4@!uIzgku9}fM{R?<Z|wK3~Y
zLp=WPY5BgpddT*E;&015e7QsARpm}?GD5o46~UciwwQZR9xWt;Si!r$e?g%>jCIeH
z?NGO(HcudP3jC-J5`(Epe%3&uv|~Cpgn47xPk;lgv)lP<E3butR8khX^>lq@?9m$j
z(%cs*A(2czr^uueZ#rG$`);JJwy;sr{qkyOPCEKxvxkNHC->%Z{<}FsR<htt{4xib
zQLFZ|MU+i>!751^zh;1MQMk`C3xjeSToqPBN8lkkxR`Hzxs@yp9=94Y<8}07sDurJ
z%Emq1kO~%1kAnzpC;iqTzgrg#Y0SM)lJ%m0>-1l*`>!!ESz#=^LO*~UMf_`fi$hrR
ze0^}q8gRw8b+vyx+I~b()CCU!b1q+s4xRFkM_$8_KHZDM?d6-7YK~nU<vvKoU(pGE
z_3Zl{Y5Y~>O4N0GpI36GPYy6B!d))|HXL-wMPDwMaeGW(|DQA89VXHD<N=knW84>Z
zFp!<jxO^Dij5>L8sZh#dv3zX2dV2OF-*4g>Yyv^u|D3XIG}OK}$E)SQ13oGtDoqS@
zE{C6{R`KA(;r(nDJP#1^Ro!y3E~m13nZ=8>qbKjojt2)!eIxpNFYhh}mqh2a91ZI^
z2(UlxaGTF<D#ciuHkT&Nb{=h)3pQANwrO_HSdMPb<h_sOt=T=m94Qcb+CzL(SV`;f
z#$X{8$3eadTn-I<FqT^!RxJ#I#z+SHt81w7`2aBoih(UUe=RVY#k)C%FZAz69A=Ca
zAMpf3)pjLd^=6wnyYbq+;YG?!B?!l1x>hl?lSIi-<Pzh7N6B*saRmqBJNXgzis8O{
zuv~Oy=2$|Y<oy-jN8sHl;dkt6@=|EB2OjKO^!k6?-&cK~I8hd1B8x;U$Q^Xjyx6ws
z^Ady-0<v6Np@n3x$c$pD?D6Gx7Mu!~{i=iQ%AX-!gG}79gv2zu;t>LZjp_DvL~F7Y
zQr|tP5ExUr%DqV~yExgz6&Du%iV5OAgBYLsySKk<yEsGO(SXABHwi{nQ{geBiWhSf
z$kT;+4ia2;8tr{5*&Qy3bfZKHG)e;*@Ag95U7u`tlxlj}>KRJ>AH=J(EYiDN6sgs4
z1kkw1@Ibtg25Ffwi+Rdrp4w6%-qZ)n<c3OvlAW`QT$_A0NL>41KNHWbyEj0)n;CBt
zFFez6SO(;ES5L-S2R<-G+#RePOe7EZ*YA?tJm>YFM2L*cEN^WUg?-cG$SO=AU0gKh
z+!=?ch$hxTXY19lS7mySKkWt$3!CFJ+my<cFcK&o3cGj4Rv6nVlTUV$bu`Q*0LK#;
zBIFtZMvq|CV<vI7b!A<)l3SWD!GE1ul9mXzLm`BXQotn}sF>O|gMqr6TD%=!imR1k
zt#5VlX+|R~OU|hNp#6@YNL|Fk$)`*zf+vG9;L|^IniN|Lk0XM`bq>MB{i)N$ool=p
zG4Stqb*N@AiDsWZ9R|^eckm`As*IraiyE^Ou&#9G&M2y^Y(q3eG-$KP<3!-Af%(l;
z>CbP)Ksfvd-%xTwXcv`DWE&!=A+e7I82O=1gIOK?Ds84eJ2<C{yZMaG5+Xs!bZv7O
z-UgpNMiFSR3sA-<)9|SK3R=hqPdO_=2b6^I_nT3E-f9_kBL;mV<~j<ZlZu$bE?;T5
zC9xqZlU;%E=^;ZLeI>-$<IS(SLQ}z<5nl5lsHM0sjw^>;?i@g{8QNVyZ^hF0kFSR|
zM~)Qc05l;1-er%tJY1nc%5kb-NEP8YJ>y}776nM%jOo2)#S^{WIGkc+ppRvv^$|U+
z3pgk)vQaWsvE+$ofhhoJK8YT-PkOIGJM|H^(z_7#yw{2ngVc0C&U^g8H|oLil{EDW
z7h1142zaj@&x~^N#kj}U!-rNZ|0yx=-Pn<cBNA;l(0b~@$nmVun`?WM-oH)6JXE0N
z_%j8rXz{GLa+-g!$)ZGAL4U~Ljk-^nC>d=fH?)1nusL_ep+`D>S1rm8MWU@CSGLm$
zTrGopE!2$WL*#0I5&@v_Rj?5mJtyld&EZ4Jspgqq@3*gC<*#cj?TOgoJ`I~q#OJC^
zDO+WN3*e+RAxPith@(=FAjtUlIHY#6u<&jb3yROME%9fvf7gSl%rr>B3ayU{vpAcR
zL8t+!nX<WdDS&{)V~ile*@%kVXbMvjr~!P^Iv>>0cIB2MWsrWU;!@AvJ#V+jft8w$
zH42LCHS=g)ckZg)Sh=KiKbyl=N<rEBKC)vQ`LMfJjSzs-x{Zntr<AC<XQbtR$V}+&
z12oM&rA1`9;ox0pkhSx2$>#wbUz^DVt%p*OSkTaZT3s#h)8Rekv|7chUUdtbt^*Vf
zK!BR=abgdAD27tI6&-T$(s!O;_hzCY@~yy|KIx%%k2DNxh_N#9CMz8S_)q8am&hy{
zLqJ>-X28WZ2s@QBjA7m4a1JVQ-8Y5s1AfzL(8G*}6*ZaqjlBk*rMikt6PyZcbV4{1
ze4+Uduf_at`}(S1Km@*x0&UPvRb>f+(Kb}=_&6=BP=$Lf6?L)KR;jrjq<~tQ9$1k9
zO`^`cqM35}%2s1D!sQ<zAhVLYK5?hm*j4GB+zk#R1E{EsFb)S`<ydNzAf=@LvC6r7
zefjI~&j~~R9p9;77XaD*wMN(BHrYb^pjcl!)$it><T5_=BkS`UuFPr^7d@g3kxqzu
zQcYgi);E1ZU-nm2LeWACJliNAO5XyWn)Af-2gNDm%Ep0)_S?ll4}z&+u>Y5MC3=9u
z#^CxHo2!Z_%v<f#!-`nW&j$bSE>Yp?Z0-NDtyY|aN6@?EYGf^3SG=v?!&jr~Q9k!l
z<xjBi*se4(j$M@anYn@$y0UT_vC7RR6<*CFa=?WRN>2rTQ@1!L@ZGKYBR>`_8mL6m
z6S!`kqi8nHKEUjH8Nf0E7~w98bw~GbiPTzfzR!0A2u=~rl5}gPgZ`epJM7dy_;xDx
z9z8es4qy}b8KKm_c+ozzWAhJ^Ovetxb&%s4ffJlwjUB%B<kgr9%d~hVMUh{AP$~1C
zE&>0)TdIynP1v(nX!+cF@4o=JpK;Jp1r)nhhPQ*ou=7JAV&zn8o>9KsS&dP01{xCK
z2g7!C=Laqb7s`dH3d@&P<4=a~IOS7xoM;6|&(mTy#d|mMo4AGNe+p$cmqMO+kB)s2
z#ddrui=oUyE@ye<gf9&!h#m+*!C7EAB+@OUFk$vVf50KkPuHo0eC^@4nJqa|kX~||
zR0fdEA-YCSVJ&1{2c3V^LAQDIu|VVbWjL(X@zued$}AR&nE?YOOC@+@=_PGd=x4pB
zfsz;#*Ge^Jp(9#2yI<(C)1RiP@@5sl%$DA-^?s@;o0J{_5Fr;}i+krwUOs#QfUJkf
z(Kh+%MbilDskr>cWf1*R`r1%J;&|@DyKZNN5p=gCNNpr6sKzUBz2_&n)7LT`1D}nj
zsi|y#H|iq*xG@$Pz|oOPys3!VA-GnGN97p=kU$BMN<G#nL}q|2*ChM+fGI}JVxZqS
zwc#v=O1t%hA_YZSLz7LbB*Q=g-nAf#ljlpx&$s^!>~=qm<0OC;a{#v?=ZyRMSIp=s
zZK#_rFxk)+W}z^{)S4%a_Y8Q0YX3#cNR4-*K#a@Bfk<>EIdMYgW@#Pdb{DQ{!0huu
zu)5aFujk3Y(L{`mtExjR;qqpRjNr`qV+8bC@9&T2x93ZYX?<JM0j*3MWyY(Ka?>?Y
zX=eU2=JIAaG1Mjq5QJ<Nj}kCf_U?Q*cQ7V1`_BLpr~v%<e9P~CiiABsS^F+Om2Az6
zT+)KVs?4%HQ_|h@76pEMb)XLqo1z48V<+kg7QpSPa-W>!UfkEV&&k#{#R<TqXE~XR
zLfN4HI=m29>d-;-{D90Y6t5ovCb(Sz5|1Idt@Pv0Vs#@%akEjY8R?7^C(qY`=I^$M
zv*#iI4m@5z@%>J`&W_%hA!*>ZBVpEH;L4`U8KwLjb|R&*GwT5&P(KIEJRKSv*(Ecx
zAqg3?@QJ#BtytZc<)A{DDVsJMugABzUveU4hrK2kg6%3<wW$-4>QASDL@q0UmlJ#P
zIam)ja{?#HO}R9tPdEw8Kp{O2$%1@Groe|Kb%>c}uZ#AXzL{Jrd5KgCm*naZ!!!Ne
z@Qmg|{~yb<AmeLqOidKuS~O~FJ9iVR(3Q7)TYJRpOc)>O8`jo$T`)PWv!}~xSql9}
zNomVPQQ-eG=Rn8(;c(E*=@j?ERm3A{gt6k_A;|a27HFWsW>G-(DOW<3eqdrC(vB);
zp)@c$2|J92bG(B0EChVr8aQCtD2yu%Noe_;h~iw)SuCYR(7|ocP1HFS5qwn3%r%%t
z1d|K?b3EYA@788usZlsGLmcm&FYXkeeOFFcmmpMBkzwU9zSlLsZ{67{_uP7L9};~;
zK+oh;`cFVZ`m!|X9fw)j3%nR<?e-L$%l8=O$F9KUbWE0K4+<rwX08?}gN^e+X?A2s
zY1Hn(%}+x3z&%~~8F3Ok^INKCi820+{$eubTI6vD?ocr|y*?#)p-4fk?wUn(Vs$C@
z;L3mzvfFACB)E7m?8^WxK+?bXY0-B-51XrnW)8;^bTWB>>-MbrCj&{wRQc~{p4;d`
z+R+ztiGAbuNC6o?L7V~jCCrEu4Mum~f>*l0q8NTU^R-V4kHC}90%@q%${h9sK%p5;
z&5=bb1Zc$~m3$c=%<V7OxWq1#oew0Y=b>^d&Es%oRm*-^F-m*><X~cDoF{0iD*~5U
zEW1s0(CAeI3SzM<mh=v3RoWE*QqtB)q^z8%OKV?=ot0L6J-#=qE{%86hGTi}m=YER
zd;MgX%3~M+UrY&^2*^@J%eS!IGz`n;Gmf$z_?WU@sD_k<>P!8@z}CiYr_fD9PxxMo
zrs|m^PJF7|s&a6X`?a<`d=U$K=?dn`EC3_&xgWh^$U*tHRgq}W#6^G;j0D&4NVl1J
zH~V2FqeEAOKJ$M}{q}PFAEX}ErK-2rLxnin{8d0ha2w(s#oP-@jKZK%gUa{-iIxRL
z*3-b3-OxdFvKPZ9C=BP-;5;nyj@8|SWS_+|(9cb6o&#O}dP_L8hvaE{TgMiD?AGB?
zG6r|=*vA7H0LkxS6xjP@Md*_!(lK5nbi_qy;*H+~Bd%(yPx89UK|_$Y0<c@gLlFth
z?%)mh@hLcFDhYQGshtFZ#8w(}7xX`;3HyTogqVd)|A~#_va0jPJ;>k-Blg_jB-Wk|
z79XttJn!9ysQPMXPjftCvw#@n@TH1{lhSO(Z0$+y<|u|AUv~7rbHp==Z*gAOh-xcT
z_V06?#u<8(Xj+t6C{NQCHGC6gxoHal+wRGd^uXbuiTi$+LHr;^sNrQd#mWoxL3vB+
zQU`_$EV6FR)}tOEX7q`qF9_IelOEg-GV5248VN82&5Sw}gxXQ<?+2ZHP1nl;R{aP%
z^lxj8y=H8>lUYQ&LT<`_w$(e4#89;Ln6dSFq`e)%sC(R^>g_R2;kK9EWl3>vS7C%m
zwuN2ag-3byhTc)%DreMj8X4w!gSrB%#6Ylbp%RoM`(}@aOEg04HJXCDx-1T*t+|FH
z8^h<Yx}pAuAkNqXvQ^gEVeCBzfD5#yM7A4pO_CA#rM1xc?(hju`s+FDJJ~G^??^Y4
z*E2&>v*^bI1~v=KYbhJqpm8%n4vHJtN1sX?6;@$0Il%Y~Um(zSY47^48O~<rgHAz*
zx9#u^?N&uu^O;g^x6e%G5J-I+9>Y*2>~+z*HRM;HqCmoV966zCt<2LjfbA@RnrxPn
zY=}AlxY>1WDMLna;A;DPg%P$?sb%P(6;UpNQOGK8_Uf~dWJ5((L|+E44J{AJdS;Vf
zuQ@=j0|x`2WR^62Q24OQDw2=s_6na}ugX3Y*1w2K-F-1Fmp1OY=rD%v@7wBRnEmOE
z77O=9?VYc#gVSK}KfKX;NS++;G=shem-5C0UY`bLHT+xTF-eIx01~CF1`Rtg3vcdm
zCeH052&CFTyif@yzMc_5s?CgcJ7}6p!66m@11!Lp4>{1eR*+=EgA=|RjT{l80^omG
zF-_pMESxAV7<vHT=ktTkrZJbx?8V|h_@XNZ9m%7SuQv>v;PW>a^0CTl0u6k>2tNA@
zYJ$(>a=401ko!(ICCBS>xdVqIc*%GL9m`bax8^tk_p;0vmcTC77qMW&HAM^X1~o1?
zI8X1G;8YK)Pt<8bg`%XOU?I;R8hrBT>S{cEa)+3S-WFE@lwb@&5CL<fj(ZqX!aKXX
z{4h92#)a90W*8RXp?bZI=~?d(u*G_`=i=|Z08Jccp`3+jpZb7+0U^Y}IG(G45x@;`
zO_pBV+Q^)>wiP0Ncg{R>KXBkah6kHO_ao0;N;CI?r4%0K0o>Y207J@ojcI$ur768?
zw3h6}vz&K)WA(>cH3{Jo$DT!*qa?R^p@X$paoQo&Bu})wdSmx}G++IsLG8*9SMt|(
z)CKja=a{&F50YF&iw7tq7AkORCzD~)p&Ac+iCj1r19{r3?Zk*)pJ-~^7dVTEDA`sL
zOjS;i<jmk**dhI}HtKPaG2g<{4-Z+o*~hF1#31VEC#2;Km3QdwE+n4cCW=Qa>`Vgz
zlMa0>(er|rD%>wrlRAwJHT;$_*B1d;u1Ys4WaVfRQlwZk<JI!c6TYEYhbToq#vl9m
z;1Dl@uiu0JPxuYjN6NKXNk3gIA7!cCaxTp8fU8clwMxeWIu1w}rR*YL4=vc9a;f}F
z`I^aj(ic9@Niu3CNibgT{n>uaCk4@%S(8u8h}VoN=i#4m4LT$=132hkd|x3h1$5mu
z@gC{6BS;eoq)kJXgkMURDzU0TxLsEwaZ|Z`C{v;Z&mgpTD9<9I>zcYqVA&*ia5`I8
zqIH)XK#oZHT;EEm=$lwss@<3_HUUG3n<5u^Zb$^p#@*Wh`fS?h-B{Eak7FW`dMRG*
zH0a&Or7`-dUCK0w>n#1LbSb<d=*W{QA;^brzL^DwtdICBn1-yV+@S#9Gh9@hG`fW0
zsRr14_wxQ$h^aA+)1E}#m#jQk8|5G!8;Y;k@R^FDJfVQoxY2Ol3-;7{eW=koqI0J~
zw)nvZ+ob8%t#Dn|U`01vh#GFC5K7;VOPp}MX<w`W8&`L5nVI3S6~^L~x$hzFROBS6
z{~4IO<fLdE@fvAxsg~dASlhArmi1e0w+J3NhgVL1ezo^rL=nBu3IkXvMHnuUsC=lx
z9z`7@C40-;-Hq3i4jXeaC2?e4LUs|Q=zG8tAtoN6)B*aA61-+<K#dS@V4oaitwWZ`
zAQ?s<ffp0+`cxARotOa2slD)&^u}`hW!;auv+9<9c-5kFvZ|xc11TpLxlAVzq^+!D
zi5^cC?HE7~2jFNi1KlOR6i!jO09DrRq;}@K2jq4`A8XbE4lzu(+R?hSSKujWt*6*c
zgo~lGee&E0bna)Hl8NX6P6F;)n?-a)0z7{^nYAC(jp1#Ffa|hTj@A(MF;+6=Xuw|0
zEVF4MxEEmxUt2dX%8B}8vzX7qao=@=dExS**dE~wX5M~TWENb5r{VM-&E|+c1YD1^
zBX>=brU^6}{vVV_-`<^vVx-1zG)7C*I%Ob>M__iNJ7ueb!y$eX57$0)q#s2??0O1(
zh@&-7E0KLji1f%0@_{aSvku&j7UG$cFsn+%4&4^Rn%t#Ve&D_4-$7bC(>8+wVnbB{
z&fq+<9S}M`bTiX%@^xaFTch*hs}ujL$TW-BOqJ0BE>PclOa5mhvZ1eF?2jwq-<?{E
zWcZR$?#Z7zj_v3rjnMKG-_te!%qb0KrfVGW<Cb^Slx2@<Kl?(vjhu+zYWGyLFvsBe
z9H6pYH-mg`s(AQgFG((~|BFTERv=lAqD<UHTwd`kXFC{?q}DaBV8cA7{NXn~4-^ke
zXARfS8E>}kf%Mk0t)y#$!Ai*>tymcwhs~m`%z6Z1?PzmX{c44Xq>ZnDFN=$VOH9&4
zab!5v4GR%h!Zm?N(D1vNokcngY#JFQU$+jn96!bO@(scrkiY9+MUHC|p{X7rK0UmS
z;q&i(W~$5e<mDlFv@sHDyWB?j|E{(uRmA=eWQh4$R~nkymoSHBQA~BGUxrVeLzPOe
z6O&Gs@1_QX{+d`-TUY*%`$H72*oIR{@sRyF&>kZ=vLjy<LHFEhUJc~&M|yMr=O;fp
zr2L|ymw7x$+4KY9^{6OQ(a<iwo@2wCX54rgo>$!~#({RTev?VocD>U#U-T2YzZeVk
zenoLeXI3)yoS|f!NMmAqH02X}Yuo=s!ZpGdiGpfoYW3}pGDNMw+J4ZI$E3bdNj3K5
znr1GeWFdt`1eHrVbgC4A4te$!y%5YqSnfO&k3ClUb*1n&0q(a;q?0<YD*Vs|9y(Zs
z8JE>C;QXj03mB%XcJDo7F!t+CGNw9xya|ZqJswTW5jcl@ctKqh@i!*dt&FR@C`r3D
z@Kzb#@AgMbp9Kn%v50(bt=SdSS;OZ3R|~7cWofekZcVS>Ztxiv_2XGCWZ_!5Ym-g_
z<!ZaI%F+S0MBTwo<_yi(dP^+>fCs6Pe7zDur1e03IEoRnhB!?P?vfPCcw*V4Y3d<D
zv_z`+ZIvRa+>?nl;KoQma9H+$-sJEkk<-w#BKCDymqhe*U2axt?H%>n>;H1U%AqdD
zaeB>8UkBfR^BEiNsGHItYM8faAz|j_U<hK9c1KjV%63lgui)vmQZ7LC=p*4D#!J#T
zTQb2e6Sq=i6iy7mFcWL&6DNQ}#<?@6+Z4tk+D_PF^tL*}i(S_BJkfHB0Ty*X?Evox
zDRM1UnsVEl5kFF$0j&jC5bT`|KLS98n!WmqH|0UT^#ir)q${3FYnl9ufX&cDly>Ba
zUk#{v7Qn^H_BiPD$o}khIi=j~B%PXk`H^Z%*TLa^z2b{DIuXlBsB{qQ3^fFR<l|n+
zLHC6Irx*LS0%Zdm<9(0A@GKTIHW@vCLd^-(r9yT%xRvHVIyC{kc5>crSc5z!-xium
zQg|u4Oe&S(309O_B)cY$H<&4fA$qy_qf(%jLKpF8){gbaJN#vrA;%X^Ps->Xl>%cf
zeqGN^+g@q62(kBtdg;5=BIIIsEkRcXg+Z1nF}7_ue{zZdaY8thzu6KMglOq0t`h8#
z<W)W&N}W*iq0Npkz2$-SHgN)cojB-~671%1&UZ)$t~O>1ns<<h69@%<9aq@eZyC@G
zqE9ox02$l>2qdxLOo{I$eiQGaW#AkL#kW@kuN-tcRJbQQn4I`;;pGemBi4;tJYt9L
zDhvWRnlTQl+TKJD0W}&aw{v3R-m^yTRAFo?nV-vZNlMQ<D_A`Qdx9A1*jF!w#7@;i
zcDy2@YU(SyTL9Cvs^l)*H9O8=PYL6SZvhT-U<_2pYrnAhO*Lk<4C7W;Wt3(DdKQb_
z0tN6W{3zuePuvbeL_bJ0&|FQXxyp^ikpPs8cyHDe7V;R<7_R7TUedY&;xGbkWNBfz
zg`|z{#|%XB(5nyitQ1vq*Z+H(HE(3MgQC#yQWa{0t@ZjXhpV{Fvo<TB6ldIVyUvJH
zb0Q9GncmBUs(*x>iA1ilWh~no?(xHVDq_1G#IK?s#ca8ZTM^P<8o8EoR?|8Ce))|Z
zk9%Xm!KRji5|WVXIhmTQSEUDA*J9vuSU}iizc7OTWPctc<Wy>K<M5F1$NlSqpIFM1
zgn+Tz=`$KhDl0Fffuy7uEICe~EU#ct43R9^GSMqs#j)h}StPkoRbDqGEr(pai7-9^
zyDiETWXLuNHXAke8|L(@DV#L1R5&fqZLy&3dqQ}Kxb1aGf_UiXDboOGBHyDM);%`F
z#1ojo0-uV(Nmk)}7$Q0x07z)0x~X8b78>BGJP|1F%x)WPy>%ceEPpma%V6Tec@lVH
zuoGIZ0l3^HGggyO2E3KH-0AGAx=0S04RzOfS0OyUOo)5t=&a^{AdB*}m#t~(8hb*8
zekVz6Nh4B}ir7#*iWZ&tJvtiN4NZUbC5rw-yEEL|{T^^AW;e8(q>p4uD!yq0zAMmV
z0JU^ZV-9c4-8eBkp7*>CItx5*4Y1SqW4PP?y@0~V(WCM?Ce-R}B=xt>JV_~4%&Ib>
z%sDadRX3Nnvxhsq<J{#HNXDLQY{6&_Op^TDxK_E$Uj=iP)N&&6+AsxriW9zZd2mD-
z+N+Kvyo7ozoOK52zDuNK2(ggNCv0*EE@9fYS0}j)CpGF!acAIV_qIO4`qJKfCDm*m
zvc6UH^v3$vO7It6php856MKk5n+6b%JED;IhwP!iJ+!re1Ag^XeUE<{kNv#E$lS?F
z4s9jYKb_1#DVJr(Vf2LEP(3Yv;2k$ymb`?3L!yGlT}tTVpRn+PL40%>%PpmeopD0J
zE({j?w-bg@UW`cWxv1mvv7^<Pbk+)z{`MEA&Bpv)5_PTXc%~mEE4*@DlufBm-80#W
zRb%{R@m8i`&GWh_8u)qmd8&&#P$Q>m7l*@Z(SD<UQ)X;c8`^DD9AF9&X)U-nb-`~Z
znezdJ@uOQC8r`Snokg&9(K|&P;8vD7h6a`n*ST{>U_}gWT7Brs8Qe3CYzb-NPIr51
zLDs-QlpB_32PJTr(pfpHcM%!L3v(zD1aHp(cPfzQhy!M}Mg;jGm)omDtY~qy|F2jH
zQvhQ9s&k8<gP${p;mta1l1i$>=Dz)J7Eo*(Gt7J5Cq45GAUmJktYcd&!4!Ez#mo9c
zaj|D1gDEZF9;r`Vz1=0`%c^q7`#CuH4nq-JK(wY^CiG@QdvFO8f|Zg|w@a!c@139b
zR<BQwGu0)L>`y;2y;(-3C}5JOh}21E5^eksH%I2EN7To5B;FoUq^}dHQ;LYIK}_JK
zlY0$OGhLDC!<2ACQuowzA5A*}jkH|+4XXSr)&duvRa=yl@!5{}1nOsq8g!CIc|fh<
z-<BbM5)I7hCO{yO&|3TAlA)7rB<^#cKU(&Hkgihe23FpJV|clJ3JYR!e6VmoOdqjd
zDD(986V9`0rNwc#A9!8@qJ&6+uV~Sc8n-7joxH&iyuef~+e8Mmp#h;GRNn0dVon+2
z8R;qBH9%2rb>%>883jsRW-_S_*{ql0co~Y{Mzi|y?`+ord3hkXLB|U@M+fugZ;QDR
z;0OrT>H!1U3~N6peySCv;*?Z(0aDYW6n5xPrOx(~2}8ajVZwsN1|vkbEN;08lW~7n
zARX{ZXG^^ay{q*|6+K*KF6m>_30+zJ!;hd<+aV&5v~T63HR^hY7V6M5+Xpm``qd6g
z(~}Zev3J%YvJ;yH@6lvXrrk1DRx;A(4LO@WC&hk~*aPqyak!~%@ld_vI|VtF(AJhN
zsrtLIMQdq`m*0btS*yf=D=AN5Xf?QF!$ulxb@&MAqcD4gMmJy+ilWPSVvy6w^a%F(
zszK2_?u}p?0EPBe0veey<|rOgUKAh_O`o$i!Q|Xs)VqY#N7=+vpUpoCTfl+PB{ZsN
ze`<f;1+?>&bAeuwHdI6<vV!7ntt-CgTql+l8;^6Y?I@6h+YMFK$`58mLbO@apN^L*
zAKQu_hR<TnJPODxxq9UoRPrAi`?)U>6QVwF&5BLc{4tQLZbEW=L#kpNZx;`-XQp;x
z9v$l)bFdiR0{^aI&_&Mg`$b$_vtL_H5Qh<KcMdBFtj!WdBk`}pd09aMCmrQE2E^b9
z4F1|57{PGil&*kY0h-t|mt&;j8%zjj!$)52)<KYoB7DP0ej8kIek89qao%9)NUR$a
zeBgDG*P2S)`uGH#`;1*jg5LiDFeeJ2-Fm{AXu)ViIS^2*z>7kgT6*mYf0B5Hev_%Y
z#aPy0l$OoWmOt;e6N?Z@482?Jvw&(ErGD60h!;*mgeW2Ki>Rq>0(KcBE4K^w{ep+O
z3z*=YsHdm4;eHI~Z?dxr`4jTM-GA!jZ+km_WPQH`7PjzsGGW3OO)F##jJsMvDme$<
z5<5clbyY29m1NOv%FF)(8Q8cz$zd$Om9|THYn)uxKrrI<eCHKxC2OE=ZsgJZHCdB*
z2@;p1*;C~E29$5wi_6DRVyyyvU&=lB^7-p|un)&vNb8`J3XmxVhH@u3zH|G0#gYar
zRVLel2>8&Cv7rJgg+6$F|Ge(K?JKm!x?FGtltafQ%0-$IhistTZ}$K(EzBk}SYxv&
zDYP8by)mps^#py>@q0<W*=IL%>>q!XU|~FuIV(!5ZMmuJ*vJ6RQuXs)OuZPR#wZ41
zyVrSWArej8#j66A6qM%Qb?ZXNPQc9hf<Q`~bN)eQu!Wt?&cF|0XxTJ3YIq-OGi(ur
z*x%+EBcZ2os?$$b+eK?=GgpIcaH4s;tOR>iFH7<3sj_H^5sE&e&f4Wpa^{lnTgLWu
zaK7~we!w@LmkGw$a)>cEJpcWgh1GY})l9UNs>;fEo_eej&Li`Qrr~WmR1oBvJ2haw
znNDOSPYb7$3?)T;qRVO=z<1@H*n*|<VRQ$x1X~?}ltQ<1!zOKFKZj9A-se2WCB7k3
zdZXk{^4SX(1Y^eV13iEhnVf7^sxaLWh=V~W+kjKpNCSFg*q@U+c&1?B(~DhA^zggv
zFeriklOjeYd5Crl%~vBfoY2vB3ciYNe&!t+KB1V?eR-rw*gF_TpaC*<xIY!u{pE;h
zT|O(_{{J>7GjR}5#jF?hGgSp4GG0Qn@*DN7hv1*1L(&UqfjVwJRulP5MICQk9O@Rg
z&#hu~>GHEiCWeBa*aIFz>V^htIvWepyD0<7E;|jkyrpLRVWGqo%?m9fCRtl>%Q<de
zCfn<+_P_+La{cv#VnJn%;iVP)Is!h39<7ooD=KFN_N7r?G(7X5R75^+eSBV=E7Q$g
zK21j06~npYIAU2<ZB2bb2iuY}s_gal9_aL4qP&dzl%nmTENn2BjoJ;QgB21Azdt;E
zYY}x?BECNh(B&d~(>k2x?u%B2()az~3SPFi&Yh#_^YhO{wt5^Xxd*YoakuA{89ef^
zh7XDq2>1t>2)aCOs+j}6I06YZ!KQ(DJkk9#iWjjpr>clnzKz4j5pCqzkPk~ATG^;?
zc}sOiQ~a5f<Rov(nc1Y!#ec;bkP(pDldLtC!yhbE0%m}($#4~{M{bW~`SJBcs*5;g
z<W0NkryGwk5YR*;p2B~;_me{N)BDKwT{4<Dyg3W~N@3PTWyXJe*JSfhYY3Nb)d{#^
z(rM$PWHQii3X|k<iRBn+)>9$5WNbtxLp$d~N`z^k&}R4jP`1rG`EY(X5{GeuSn$jr
zLE<<vF%2-CsgFVyxzrrAC5-<%BtWG1%uEVT&+#j1nSj<+k-Pg`$@q%BHPW#qF?pYx
zEyEa{Z)L5+Fja8>Fteyou5<JvPMTL3uTlhKvTAeWK2l%S8?<R%GDRZ9T>gqb=5Voz
zHS2(;N5}Cl2>>Yf8Qmk$4fji_`{x%D7cAO(p|gw5mF{?v*rWvCk>w3d8(E)5MF1Jh
zKf9)Ir7cd!5Q|6)C>|)Y;O?%9*L`xYR3gsp>y9ge-zuIB|F6dsu^a<oh(4=S$HykW
z`fQr6K{VUKbTPdK)r0}C8^xU+WLW7AxsL)f9ggB^WXd4TDI5A?M$v;G!nJyxZq>El
zF2RSV1RK%_tbEa1j6WKe3F5%CbgJw-POf>=DxCn!q|ONJ>N4)eMjI@n0huiBzmv$`
zaiY4GAxolEn|8{*4I|!X|Fjx7N$LhH3P)=w$HFOa>SNj|imX$jG~V%9&CUQx|7<Ya
zsD48KmrrDeA?(396icGW=R$a%f0(X$O^43*ZlSn|bz$GvC07yEtA_uDEVlBJx&Ue6
z1oUA{!9#^GjhRNRX&HXG9M4NYkAi<w%ofI{1bcZfCgm3fr*DxZ|1yVr`l|KrHQxGa
zMcg3o$2ptAAG7k1SCM1G>7Nx+zxZTrbG?6e3mWW@{vTfz5vVZVtvpQNR+^6r9};2J
zA1(#Utl{T{@8(gB#b$UeX)GHs$I#V%YTmJ_Kh6>$9*e(u0}+A9;o!j@=HS6nY7~KB
zu28~yF>}C=3K^b2yMiJRTCHU3ySY(;7&k<d6>9&QBX22woE9j45XP8?SQ|s<m9}B@
zU{D!0^40s4M=<;S>`+wMBMbAGsTSjY5GU~(Uw{E&<*1TE%8*eWHY=u&nI;$i|G&_)
zbEUX>(~#dP&5VDreKhBe^muRijkt$7?YKb5MRMayp?@ale`OIeKUh?*ksjUNe!@R>
zM|hSy`5tC(9Rn>$Z`>KzCbl^`I3$8Pv1netY~|p->{i58%`B}($b9qj*0s-o+N#bi
z&!{dyFHeusaCBk<mN~p7Rv)Mb&}Wl~_99?YlLN6MrMoGnHl5s;xQvE^A#D!*FK~j(
zu0j#H?l~Rv-&{1h59Q<I_P;yiN}fpr{EI*k(~FU0XeA_nwQltPlLnj0i0|G7xP&$!
zE|UG^&1eWf%{hy%&xPuPa4N#KD1FFZsS*LbkQSvjPR%Y-YB21>uq6zPBF*5K%ZI#K
zaNq@a@>WF?Q$QIru*;m;`akE*=SVTj=HT{!u^Bc(o+nTGOz0<F*=YGvK<?BOdh*)h
z{!A=p>YR7j+Ndqw?IQ$Rpv{%A&X()pV4GJ7msxut_$}o#jnVKb+fgAXoVZ=yrYb7c
z0*gVDO;ckr;Ey{QFLf^}R?cS7W@SOH%WO;Q^(t?2$eMHX*v9jXd4{L>_-M2|gMoqs
zIwspZ?YyL?E8F$)YSCqD>0-%0if+bLu8?>D&B-D))tXe~H6m0`jlYeN87aiVO?OKP
z?{3^ctT?d@gC-xf5#yXNX9B3L{9%~(TmR199f%<17Z01tPI^edTM{Z}e)^Z{ZTH!O
zjIc9iJ+RU|Zu*^@UPorG%ULGraH>oXU$Y*r$sC7l^e|2DWB_7m{I-7X@lhQ?@Z@UH
z+k{ENH<DD`K3NlSH%U^;z9$iCv$lj$XXSZUh1r=rc$P9V(p*Nn1X#ZopYS#bTf#k*
z413EU96wysvUkcak+EL$bHRC<K$vxnNr?T+?6y6bytS^qQRz0nR2S5Cp+ILA_7B=a
zNY^K@f@S!zf@G4@Oi%`1Qh&!^m7AG^@6;dK6Rae_*Y-w_7j^YRu&7l&4qlLi%X1L(
zLOm&i??4a&d%zO$-+@4cGSe~p3N&$c0oMf>!sSQ;JIvh0Tm9n3$ekv8=_Gy$sJy<x
z`yrvr?F*W&$<eeIWx7KQ*epY=tHVNNkKURnS8O?8@N1mhbM;^4?w106nk9@?JAxP*
zDPmjkqN;S6A~xYKD0jfSjEEj|MZrgA%gA2_9Bnuh=htl*ol9GyJAbK1J9Ts8V4zkJ
z$u4N5{_O*rfKA5~_)SvE8z<y`#2HKrjo}4jm}-kHb55>>Z8NVChmm4y8baR7sHu#{
zZvxD)?6dWD=zks3Tj#r2zvjhpLxN%;rMu~1FzA}wMd_kpM7)QG!C*n%KdR|2^GJqn
zd+PMII=&5K_5)tW6#WA;d7>c!A=JZXRFpRYPh5&uznbA3KJjwuU!U$wm~u+l83eE#
zYMuskP>l|ZOfho^ceH7X;SU002;IE@DVST~ZLjx-%(G~2kD+GMP|&&SX6dqS+;oWY
z$o|9`&Q40kUxH%q!^%H)ZFw+!Y&uc|Vnvw0cda!^+cOUNq87(vl25|3Ttb;=QR_gF
z(8^NWs<plFk$w7j5UE~ch;f53GNt?s@HqDqXJvUHSR}j-&y;}u>JTq;2nUjU&IagA
zI*tr{`eHw<MetzuGmP?(c*Ynwsx)jd+gH*dY^#Z$Cd(8c*cYq?A){)Y7hLMPbePM;
zVq9ipR{o?6^Wq`l2jJn>>q{{Z3;|u<BL^f{?Z})M4@`HkuMyBvOgYWKB5Z-oGz<G7
zA&kVN{-%{uvl^f!BOhAW*<ydDZJ;Ubmk0uj#3zh*wa8a(Aw?3jw)zqj!yxe}wY;qU
zZ0QT(Y}?}7Xz<K5%yGsu^RZU)WCrd5-`}8ZAX^mP*YmQlPjMzX<92DSb62IJyIouW
z70k@9RdE46l_+LV=?s}-8zY8o*%^_;Xh_PZofEH<X>nj+=ju$@S`N_!{r&?1V#}^b
zUI=LkfqC}Y)7B|&FQcp@)!gK;%2;GQ+8jO2DASsmoP4J7_ia<sIhI?%gx`i1FtE+E
zVS~I4%bKQSG^|@P)I#`<Xkr_LhmiKV(3^vL&O9$fv(%ME#p=(Kt6`ax5escNgjvXN
zSBrFd|EwMpB((u<M{RSmMTxW_c#)Gj+hw(einwdm#IaWD5pS(fzqlJ-O<!Va7p)z=
zE7xF)(2-QiPF+@)YN=s+u8BA*0;3joezWLvkgF?1$NT&sqOEespWZ;aEz)~b9VY3#
zW?0I=p-5pzD!<=9nu#Xg>yVFS;pNE~A{|=@+A8?GSAKY*^J89(7}CJ(Q?_TpVK++P
zWj`7Kz8A@y>geg+|4eYMNX_Uf%XkNIH1LPB9yS$J@jX$>q8}r`a;&fX5$K9M($5Md
zM<}N^3x?v%rVvs)lp}`+_p~~*Z`{mLa3aJhX$5s=@ZY!svN+KX!el6Qt=TJLEEV3+
z&oe@v7~Aqq3~bvHjk##$fFvUo6RCrhtc9lE;!TrhK>pjMH~=P?5_Yq}<o6@ch}r;m
z!u>f;-e8mgj@723lpfQEK;@l=uLtfl@C~_tP8T6@qODofgkYO((~ZOo^E`!PeeF6r
z59KHnqHt9?Gcmw)aqChU>eKGtZZWdIuH7MRL<tJBgX*!5q62>|KM3R`UDj^4N7h*Q
zH`jU^t(uJg(KUiGN2y}-Mb6cqE)7@-8v*=zXA3?LiWC)#u7}xmDV5)IMgH8_{NJxj
z<<A8k-+v04u!iA3WAIY3$@<+^MpP1%U*8fbg_7@-ehnecQ#G9FErrCPYQR84tS$I7
z0;U~M$uG+??^DP2yYwGHcE`<@Fr1od^g7ym&(T!YDv{frrFhm*&SXG^Z`z1nZp}fh
z;>I4ugbYU1Bd-7e)kyn(L|PIaEx*Ic1e?i8&5&|NNGoR%);iB{A#xx?y6aq4yHmwh
z?sLYEYWR2?hhRA|EReyi<kk8GA1*?2AR2w6%|qb^@f~_dXI|AdD6IlA8o#IM5LHYO
zyyH7jg}zhs2bNjBOJfkA3BNo}%R?dAChqPQbx%~JF<Q5Cj<@_S>RoHi&3*|@2nx(i
zRZ+dJ?_|Vb6KtOZ?<lki++Vyk0-_TFDj`N=s?^T-Ix6%CJ;K*T@ajg@yhn1OUgu9$
z-L(RTs8JmgkCS6HWuf~t-rTVXUGJ$<KiQn3Fr)f#z2O~YjjRpNJu^6^o|B#cxvfSy
zz2;rl-yc07iaixmFngq1#c)uYd?nQMXBbn1crt32<2nRu4nA|isMqal@u$W@zw+mr
z(Pyq-DmHzqt`A7Q75^?WOs|x?J6fzYiF2G8{q6cQ0k!;Vu0L%bmyW`j1!j{J*{TTX
z6RKP`f0N7!U%}N^eN=lj@OM1vu9QXX{_|6B%|I1b=;jk4k^YSV{sI6L7jChX%0Q&o
zb?uFKXUY>ARQHbLPIbXwC|L9*%Lxpz^(-#OvKad1gki#^W5fjSxQ%lMj!?}m&~zYJ
zt1~wlzP?`wiTqgF5~bq}Fb)2Z96FILn=K_C2c*WMV2<~Gea!Q9M}l&kt_r$R*aV9r
zN&apz2tap86<I^Xs53CpyEc8O?NdQ)){Qu@t|qH~q;q$}BipRDjTMbi(}+zd-W?k9
zrp8Ch<3}rp=wmG=jf=5*d8T_=JRoux1oIS@V~az!ok#Lx_JPx%1FQS&mN?J1%eZvp
z*;TSd3tz6W7G5n72VUZnxlS%-P5l&>K@mcVP^b3wn7#5IW3Ln&oCiW(8E={Ibt{L~
z_-tXnPjB<#zErMQMt~<QR;3<CBpEhL^2J5`8woB6tMCN&G@H;mb4GEIT|8DoG1p?0
z=C)IAGI*=G^rB5)0FF6-ZQ>d&0+*XgB^Bl^hQk#k7>#5mvoP470K!o^j!E{86==an
z3}piz5iz*yT^WK?(hZ~c+&`a!XY=$2#{bg$UamXKUX{gm_}8z3%PMsz!5AjdNIX4?
zx8T7~S4Cb2RBMe2l<^8Ko;B0@VCY9g<}7r`feRzy5$9E~b$L_teRmmTMh9?(y}`^i
z2{GKERyk*CzWzY%Q<~<`Iaf6_ybQfOQN6w9_A%PJZTc3O9#D3|WG$17B|15~q(z2g
zh(s+_A*pvRZ59-hvk8p)`>s<hDp_s{oth9Y_9+vFoZED%_9su+&W+=UuBq=?HtI**
z|E&|=>W2+EF6=dQkiYCR8n=z`yt~N(v;^$DV2D+IT4F-G<Sj?q<>MvueW8jqBH{X!
z5{Q$a0@(rejaYoukx!t*X|S8JmGR=`hpjEZpm3?nOAia@M9iuKMB&uY;~`h|s$9u7
znCS`;T-fFzmMguuQ8Q|(gacAMB*NskGv2Ha*)~1u&_=P0@3+h&?`=TWe=wYH8K1Xb
zDa$n&F7e`9)=*Bn!#Y8rla_-s=_E&^$6aQKwpjm9TK9!#Ek_r||G=sDOMz3O9^_hq
zmY2h6LjT^Rqlyt;(R%ppC_B-#cIIRXAi!89*ycjEO*B@JHzPkw-yY@?(ngu^ZoLi!
zv~vWPxkjy-_umv6uTo*5qZ4V+7cfN_7(N+Y0HG)%`_Lo<*7g(Sr9g}8!$$GmJmQ9j
zZ8AQ((j|gW3sYO|FF0%!bFuis*a;(CT3-*M^?Kdrt53d8(oZ%ZZXueKyenef>cFz~
zalc$Uu`t5Di*)>P<bNt^G*BSnU#ZPqqMeO|pWzYmZm@Z616@?~*DAJ~os=|9zsgpZ
zq_VqNm@C5-W4#bsVWpsSAEJ|ukc#K>W;fMlTahgjFaYwHQ;^0aWD&Tl!{-fsMqoMy
zC?t#zq99f*YJrl4D%66zKcUwOL~xRL-3Aqar^A`j><pVZ?+dLf<>FrS(cOGNM85=Z
zAjfwxoXhMKv_pv~L(i8bKRsUXsGjwUVD5(G^@<BXZP=ZsTY;0&26)IkDxTc*^O1Vx
zc+>W{qqmwJ(LV^>A8mlM%a5#Qq7-<QD!=fKy(;#yZUdiQbu0>g!fFX5?K!4Ju!-A6
zND=h(JKB~D1#7CCGs@j-DVn8EdR%R2Q;Fcy=UT>>(YGv7L|r#nt#Xc6lzMW?0eyy&
z(T61Je@u!OPr3TG)INs8<1xxr8<C8$0OVgzQt_6YJoFuZTHW*1kFY7o7+%KQJxXyB
zL>Zm=9Vz@q7#p^wK|c7^HuLW&mHkhcbKK8H<Pz%=aLwu?d^D6#k3wExHGy5KznTDm
zyXX}3@kkU0CEVZ03*BHtFvhzl>xErUhT}+#yvs;dV95YLWzx5r_e6$UBKuic6rq9Y
zR49RURUtWW^b^PV`h&e!2A^aPAflzn1rCdi^xAFeYOCL~RZLB!h0RR&9~X;rwBi=B
zmOX(O!eK3g^0gks&IMkInX5(wy3=R>*oJ!OR^uO44X!~A0Iuu;v#<_DR5kZ(4GrHh
zGNhv=joPF&4CWRIXZyteK(wa@+W){G=*kLLjS=8ZW5nNg?OC}f<XK9!x51b$jcVd_
z;N!V+R{&jrbe#e?8g0QzRiWp+!TP$603?5QWUp0!muU#AVW*M+B~HDbJn=iaTdgr&
zu0-T^^eQI)FTMlgzb;rSR(rBepZe}w6JV|<2_~fPyFGN1Xlg(lm3!%x4%cdq3xo={
zFWXicy`y9$WZ4M;<W-d2gzt<QI+!^7zVQyrxzJOf3jHfKU*|8c=qOAMx0?O$9@H_$
z3v<Pk9NPURVa2SR5)I+q6Rul5<AqFtQ61t`THnwqAZP^rd7*b5uqDQBDVeR24G{dH
zS4b3a$H0W8xt^9IKjewCw)A2-38{wHn>ew%+Z)V8F`)t?4#K7=Y9i`EQ7C8<Z^P~r
zN3$7D_)|*Y9-RYf#*%3^QT02zwM0Pi?7sP^mu4AiRNe+|MFwZ&71qAW>>!mJF-FSV
zNo{5nl1N4KC7@<CE?7cefH&}7RqL89#c!cq&3s!N6xsRhP%sL)2*$g4Zl-DrFOa?e
z1$isI3Jm;2y?(A<3aWbng+z!*3oo}bC2_&*7C`aHU_}9^^^3rH(VPAiGx1>HBB$~D
zG(+qHI8we4Ht8u|CS)a$jt%SSS7HvFYBWkTd4ko?e$Y(pxAvffAQ1R(mb2jn^h%lw
z;P3e%NJ6LCnTCmXoBZ%9ql-1)L|G@0tI8vbKpqwE>H)Ec9)S+hE*`!Nq}Eb|bZt@X
zb;^{@BqiMeX~T&!osFAVaDVn})_|q!wHfg>5aKO8;oO$Xv42S~O=Vi?!kU`Hqpjn>
zETU1BJ+nj$DOkFQqv>UWLQx)aH76j6Z<(0upxRxUFwh;i$0H^~#U&EFT#XI+6fZGz
zcP48A4^7X&P^Nff53uJG(`p;td3Rk-sM_v@KxGGjhnOf2&B5rL>T3Q(`Nf`MfY@|~
zqOMgV@;#?lSCyC@1?yF;K-51(BQM{bvZ$I+$H>>}^s8}d-!Rv`oQ6|E#))2fz=7t!
ztA^SVYwK7=DewjuTkX<spvK)lwz)|RVi;#%U#V=dvF3s%b_?;Jl(HkFGrqaKB_|}q
zsXqMA4rzHY*}bY%^r&JG+x0uzY6G>~#Re^fOAB}ol`<NpnFp5^gqkMX=}kXZz5{Y$
zwPJ$Bazr0kB7;L5-Qz~WBGP|X8R7`aB?&V-Vi=#VD6;j(C0F^-?(|LiyD9tx7L?~~
z%GE#;By?M|!*hu8ktJj^n@m*scyl&!yhPh7Kw>Eg8GUi408%rvd@ik(E<Eu9a}b#7
zs>Vj1YpN*$XWVp`3@7?bvxYW*&2)Tn2K;B``*_a3Aed84ucNowt#kN)Sx!t;b!Sgz
zoB+-rfyg7r<U<0+_3=h_J6b&Nw(h4Jkbmgc`fzVqz`%@AgIrW|`dt2L)6a)7_3Rw4
z#ABqRbf4@<TuKCho3380KqLiEpwqYt%INuNu-U<kMY`RZo-OMPumchBcL|S&dN}dW
zvsKByXYT}PGZ(8A#wjKP-&B=h8(^eDuW<+f&7rJkB)o;0vvAOVa%-&O`7xSy12{B9
zAy1HyOlzE4Vb`sicWXqGmeTmbKZ{buXfLZ!tm2H{8it<_2F8Mr1JC1E{SH;i-)-U+
zun7@;*8k_2wEeI$C991s^9`5n*ewsFN~%rgmcZ8gD#r(Cow~CdSu}?~8^ba=+@H%?
zrBC*f)HuzRLEyZ3H}9DSPYZKl0AEpq$6Op3i9v;BDgxr;>Ym$sq9|S6t8zE>6{ZG0
zNv`5f*dqU5^#=dwwC3n7+a?@IqZ2BGJ^WlKKT$6MR?_}GUM)vpKNE*KI!cqU4D~Eg
zf|nZ&|0!AHdf$IPu4K%-$6SibIY8x@crxJqLBxu{<(G2iDpIW%#@V$lp8mN}P6M52
z@Sk4<C;0cB<aTTM>Xlp#g~?gAra#X`<Ryuzr%0hO2jGe5%f)<*d2R$xZOyvq9;A-v
zO<BkO&M^x=xuaJFZOi1pnBoE(ih?=ImZT(E(h%ODp5c($z@&M+aA2UA1GB*_Xy&-y
zy&oMh71;d_G6W&-gzDpr7o^Su1Ww*9N)dS`y{UY8zNT70&m)k<FQDT(4<DestcY!I
z>3xH$=z&iBw?pHzEvyA5KMAn~RpAd(eOi0lf5y?)jM|T|4Mm-%J&OGgGdU5}Vp)(H
zD|#ztGbvG9IzXsFbP(KTF4uipjU~!YmYQ#!AnX%`w9ohhbsTLjQ#b+x8{}n6S$ij|
zG>ukd!re(q9qro{f~amhx14^TL`@uizeXlUgi^FD2hSZ`+Wgzi*<!8KikFIe&$3Am
zslv?~8iPs}<8Y^UY)9|YiB$}9Sy8x=kGsW|D-UFRk#J^1M14LjAa}|K^d8T;RbFb|
zdTD^8YCGJq+!ZgYyH+G)Qb7ci7Uw?6%%=0dAW$5l(8hOz<e(|nN=WPv)cM54j#5#5
zG&LiLM!J3>WlS_6mh@?&m1(fR{3!aJa;(Y1tbcRM+6%q`*v2>dM)X`V`D$<<Wx^p^
z5BdsllkZ$ubvLzEq(c`kNSZ5NLj}E1zcWUXk+D<tRh$<mTNkdc4cOP9F5S+|Dhwe}
zdZDb>#Y8w|G(jqCawq02v;w_21}8J5l=>w`GVsD?39!MxgJFY~?^%rBVBvdVk><rQ
z{_o+;vP}^Yfo9vfcDA!{U<|MElF0#a)6AMws@ZR+ZHv|mUWv#(!-%S2XYlM@o;cBh
zpQfa0?qW9k;?rS7WGu|&-ddfd*%DmY1zx(zP6pj`;ObD59v#i0x^UH4S4(65y~T#w
zkHv6oWuj5&*lx9IeO&qtyg8=6>AG1>Z`85MPLprUZ6z%4Cwp=Jk;i?3r8jh<Ibl*K
z3v*muHhB023x#*-;nd1n_v}ojw5t%uc&ZrV|KXA|U*G-;CPS+-vw&;$W3dk_AlvwA
zGS1~E3&~*}P{?~Xf^9a%OlAFLP?-gsMDQj6smZ{1cM)XtYs+h<mP&$&=(zdoW+mK#
zB@>;Op`FxUWv;L4eYM<{DN(tl7q~T7Dq+OpqtECYUQ8D1<=%WfQJ;+WOzWiudW;+}
zL2m8z4_m_xqmpl&xIKY%0=of-Ri_AFJJZ`OXW1JFh{Vc$kZEiWi)=MTEzsW`G_$Q=
zt6ldQmmM;l2G;cXG<~OQ*k8>#IyJ=bv6=5?v8xo23UL9)IIgRiMOu)4(B%!xf9Wj6
z@~<D$IjsULZlG|saL-;CD4aNy$IjKwfEr}LpZ^}h(Eh~4Bw^b+ra2wBBRjR@l;C8_
zt*T@&mtV({TNyD_JQZ7^re)EM6RZLR>8o*7Qi5_HWZvN4fRP#$)hn+jL{&z<QM#uQ
z=|ntrx=hpM4h!ZMNkwLI>EKgmsVeD;es7a(jllxfxhALJWBOA(1BZ%ySf2dY^gruL
z{b_JscBv8^#&@b<vf@hykV2;WczU8*@bH<E7UW)bv5zSd5Wx=C<$$sT(AB5})ZF#@
z3LfXv=+`4~4qd3BCr~Ldlo1N)G3~8A9_DgRp$SU4%`FtnW<q{|#9;Y}E->fs1lcTI
zc42A}pc&ksZ1au_m`Bq=W!3uc&s6YFG;e*$9$$A!{1tK(O4TzBTm!f1%Yb1$G`o6u
z)xLWvRkDo5W;bEj>FvbeJO$vb*R9suUiy=p6kJT3(w)Iq8G88ih3X)}VZu@PoeJqB
zJN~*(&aD4KQ{6tFK>Re;tdgdKQvyKuOze|I9(ZK^?;W`#pf0`|le?v)TX|S&P}5pb
zvp^y$n|x{`E0MlgXan(&GnGgxfC0#A&zrgb3#o4MbibqMdu}4wx|H8S2B2L27KE-n
z@bVC8wm5zCrAU)%Fjr)7-!m#RSYRQ1o3xGwt5XzJDbw`%6?4}dNp`N72}S8FbI=xR
zI9ek0pYvDDkIt>>$^lVF3vu^(_P8AS<(s5{LGG7?9V#A!h7!K_T0mFkMZ7stsx)65
z4eTt|-k-O?HAW)iVbJfC)svXH%bW94ks+?!Y)7d7%BAHJ6JrBlhiVC;>UPrqYf!1u
za`=+muZ<||544+>P5e)RbGkes+Q{O-{l(;5ALGiyJDRKT=6)%<dv274zVxhdWEDB~
zq}3#n1)|vxZExs-U!z-1w(JL;KQc@tD7U|o)U96v9~Fq`jx8&Z03r@LUC1ehn`aD=
znrrPXNuzxSkf;-}s&Y{Iif5~u46O#hVqcUCEU_1!LN*j=S^yW*&8&10z@SPT%(?K%
zjK;fzk43!CK7N7WB54)ekr~N+z7pH_`3zL<jbxOBszVJ8WRXjuLS|>3H0-XP_McYs
zUSK~WXJYt>(Ue82&5TJ46?VPvniaZ5IuIPiLEQqg>nlYHc}xrFQ5=6l;SMs!*er*w
z1#`dMsFUXXxgTj>VSLu;SjdR9P@3N2Og7YFFBTE)npdB;;@uX~xm!e@FQvMH{`zNX
z$8^N^&(zJ@pikjtaCkxei`sY$$YOBOcVhbDRrpygv%6<}9S+~*BCzg7vDc&=&aEEG
zpQ{pf+$N(mQtjs15O_oV(#0N<Rc>hkW~>Pmea`%nyieEq4tqGHL#+j8B!!@u|EpE2
z*HooyZujrx`hTtqqyL&Dj7f~(?>Z)9kz25MY|^GU$JX+tcI+6Cz#KZNWL6M`q*zl;
z`x?POfTc8Gxr5Yz(FJmorNx0Fv7hfK<c#PtPAf4TRRMvsc&1B<;5)f4I00z4_4r_W
z%@zBD8dWQ3pr9a!+?MSe;uDrBl%hnz;Ig8?%@savYc+~zqGJ6~6=b?hM$>}AJi0PG
zN@d|Q3h{Y-A#TIDrjQIblEG_iV5a&&FLNyu|DdL6y&JTOmwFa)S{j!^hcj+|@8PUU
zpG~`FHP8IDP$NQSi~kEQD13)|xF)0>I<d(52*5xSj@2L!7p#y#noEzLzI5$%2>m>N
z?e-@ur~quT?{CoXN!8J@<28=Ug}MOX<Qerz>dJ_2z$RU0BnPyvztTY+=qGZ*-;h6I
zcJ>A;?e^|Kzfns?7!@IOW2wFJ??%x#pc|~ul3<*gNK#DmhH<Z8M&H&f9+>?*Jx$eQ
z-^-fvwSDYuWZL3TaEzTFMuLndiq}KCwy+Xsguk{#6>FtM`rDj)6@NerR1AJWwVY~Y
zQ~gU<fAd_;Ww}gQVFv{+Kh(DPLCP6pFOHX;u{l1n!jO?Yg2^Pj)(cmcn#q}g2>1#Q
zRUyhk-u4f6!EsX}sD>bg|JJmATVdkb)PIe!H!i9<XCG$*&H%ar@XNjjM3ADO6SG`R
zUn2b?j;YiSEPAk<eYoDI>bB&};wJzaO&Yl({S0`IsG{7jdGjm}GiErow!fw%%0mkr
zbAuIY-;4Q)sDXZDZ7@8borOL<7+2aTn!zldNwSuZkmlOd%*>}R68l_Qh+c|R6gNi>
z@m++cV1*iN%%l%}zqhTVLw4duoS7GQW-n{E_C9Y%Ip_zioqAdWaPO15f={E_hQ00t
zh?naM1tN$9M450u%vyXHep;@0>f&B-@q)>fEP39TY8IVPlgu3Limyqmw1+qWh_bRq
zDt_9-gj~9?N}=4vH@}5l3msqpXLMsPXQgy0opG|E%8||Tl`p{>WyfAtSuU;`G-9c#
z>`%O1{>nM@4*?Ze9-*+Q>NI5D04y3t25tyl#@kh2Wu{iV?!raC^|xoTitxUKgB{AN
zB{~X4TNx;lgrsW7%z9+o2MIK(u`(io8G}<xq4&@P7;Plun1lEBmICLP3J7ztzjL=W
z!2Dq7-zCt%k5l_9G>0pf9?+-Jm7s^7bI=I0tBufzzJGK@aecJ10<tkVBRXMdUTZ#&
z^5C&r$%7>0q^+kkAy5BZ%xZx)JH<RmCjVBp2IDLMda&QX<)d9OiqD<svQi$DBZgF*
z8j{rat9lku&G<TCw-sT?zxp^8Ff}o{My6W|$6p<Si6V+%qj!BhOAYvr2Zb=6U9d{$
zLbl|m9MC)jSYfWMezV|Jy2^Mywv3Lo#;}PX5|oK~3dPHlscf~=kTUY%6I;u*>7nCC
zQPxc0A5xu?9Jo<*$2&Vwy?@kTD0VS#(aQ@8+N1Un-N;x9FgpKFPC@8=oAKs}#dn)n
zyHy}Y{~7F)T|~%w7!fI!b+SMYu{J8<Gb&NaDNh&muEYuTf7BFDh57p`>UU22E$QuD
z8no2QxH8;b<qzSPou8*0|4}UXy@DH$$>1_w2y9~Wyc=OHQfw<};`83J+H|`pZ6lgc
z!qSyT*#JL0Q?$$YU(pfVFVuu$ds6QUO7_W;X6<TrHG?k07_Ho5x+Syyp0Xh-$7QzH
zM#eSB-8=hDtYC$7LN@PzZo#O1(s{^Ae_z}K)dDdsfL~U6zEvC{@kVQ`JIY+$)iLx^
zA62DH6i{hpqB#PXA31G|<(W#fOEy3r=+h*+TBcX=t|`X@q2zaEfS~vSpEj(2z8MdJ
zfUB~!PA70&IwpN+Z01QD$n{9UF7F7kwYZ)AKncig(u)I-7oDtpkr-Ip+I(xY;D@9&
z;|zokE$2?l{UO(lgE2Wd>KRh&nc-=Pv>qkAzQ;84w-`JtKjHCyr``Qd!956!Ox&Ou
zGwmuIZl`fy$z*uUi^DB#R42|1>=C~6Jc>?+H_eX4jTdW635*$u){6F-Bxh)^^TeP2
zcE@Et9Ds9cXLz^f`*ae11Xfb(4}c4=D<spJ{RSV8Yd9FCK99~@XH+>(lTFWwx3iI4
zhdGlRDp`rue&LDYZqL2f06{>$zhQ6~%{}#AJHb_k;kkCB1$Y^%wBAyb65H%_tj<kd
zy!?|GW1%<@2)*?<>&0Fp&K>uv9&^1Y0sivkO^|xBx$;62l82k~)9+kZz;)mf_EX5%
z2_Ff9?Q53i6^c2!LL~qItuoQe5&jitywv%pY?xqb&F1%7{7;9T$)d-F61CiH1X9W8
zyUCp~cMNzbqx_qzzsC}7aB3|-|11bCMn@^eV7nxzp#0%+u-_u;rh1R6uuM~7)|Ru|
z3d_}Y1TG>JU;Ndj+>o^MP$06b-QR3DILl6x?DgAxtI&zkHGH;8WT+VF_;-}f*QMSs
z*mk$okEoaX>#_9+moy+fMA!HWmtz4V=QX~{+y=r7Cr2U{<JVh63)mNYdj|!UMBly8
z8k)>^G@x*s5M}xiMg`LTv*qwd0(+LD2N2Y6^;e@9c~pkYYQec!(1oEdZji`<osr&0
zqaW!CS7ZjD;M=xmpE%VpTiK!#E+3TGCTP>41W@q;3G*Bo4q|~m`q!Kd{qOxIHk{?r
z+N(>~hevKjjJOmfG5_w*!>S0vm>k*iqWq*P(Ine-;K};1E3a)n%a@={M+}^zrG(@z
zyqu#7l?Q+B*Gp%$-ZsADUt^Ag*#<ASEc#4Zwgcf|B~CyD{ukH1mhF-g(T;nV)~c>H
z2K$r$Eb871d~2`Sztt)_)mu<txW!^Gl{)(-$8B`b)0|#<33#pcQ@sgLzl*IsbG*c7
zd@1&)R>5{#NYnmO-5OBOtjPLZn)}(Agqe%6Ta=KbbQ6OfVXDe~UeNjT*)&eK!cSv1
zG|w6OpEtU)tOdTb1^cIEw-a*>&37|G;Jfv}JBR2$DyNP+v9~YUoe``YHMS14h4rDR
z668UHT^=r_n<62B9Jm9>ewy9xs-V&0c^l?#l5^m`w(DFZ?+HE9CuN{r+EeK-dLcLm
zf!~`|2a&CK9PUkT0;m3^6MJGv_p#Z6X~3ltMEB8J-v$o>L)BQOfOrgGLyWNyu-p?R
zNC)DAdBWoPY%3LKO;gJI4l9q!Tk{|U-LM|Ku|*niV_GMGIB)5UmRR+pn1?<`{Q(0q
zYqhyW<t?b`{OjJ$VY6B_d>}gp);+aF)eX<F&Zk!6M25!w5>B$WDggfas9^t!vi<MV
z=1U-TeDCRHsL)$LBq!imUJ^cz;hN5XS5PNz+t9!H{GMA1&u_@-wrDk=n2LTB&T06>
zyF{rhq~Kug+&!;h6xrO_r95Sz4P_UlJors$n2k<su~&BE$x2|e$9WdP)ja73y5m)G
z>#5F8XAg9X#z33ST|Ov)xrKY%SanMz%*)qANKO<e23+=5R1Gw+xX5coHMZ8>FfxR-
zhfN{a3gTZZg$$`IrIOHo2ZEp+wp683hFi=ezeXw#Et}(~7u0(9;5UYnCN;3Mc;nVS
zaCojL=TF;ug^btT_j2$<`;0)WFha}npFBkmQ}-9x&iTyIU0jC4Zn(7Fa6v)4%VFsK
z$X9?VxsK2-TK~^$EBwA`Aiw-=e9h7=Z7ANDc<R-YF0;Nd4bH!j2uy|8XB~6eIBvmb
z^v_|1e)ZHICf1ai=Gov&H1=5)#~F?_pv6j9CRDgAV7}S9mqiwc{5q%{JC>h3*6#06
zbicFmFBvMIa?A#3(C76+?s;de7C`ByA414XP<al^ROzEb*LjKpMy>?J(Svn_(^IEt
zq}?dGGy<UdSlNKwtRn+XPtjvWh_3j08%6D7vla&#vw-oh>)?7n=yk5ac$bNi8M6rm
z6P<^+RAaBFwgtDV;DK0K-Etqg9lt;-?xmm@9MfWfz~oy1SF61Z6B-HgHWw}917nRz
z#PjCEeoY&=z%)=G<j_)nrUBf?M{0#!R(5A62`N6wiSv#;*OavSi+a{CNp-#Bl&<Ul
z5O`nkz>=Pr1XV0s8XomEpR^EflP7lNxl>_3tl^A0K=&FMX*^V`(k|_7&v)dsTwC+6
zY=hK|H_X2?S^epQs-GbI<(4|3_tS!ejSo!Afk~N%-)7p8@LbVVZqniBbl=z2(1t7N
zKa)O#1n?_=&XydU85evFNJBriwJzqX)M(d@lA<xL2^){6N>~UdhwaHe!BDkb7|t%L
zPiq8S(=%{e?oIZW<ZZrph<K{k;DK$-^zRfYE^*p*RTR=7FC3@>05oYA@ZQs{6_)X-
z|2@b3lqyjxwB^WS8Gv!7ZuC^u3LcXK`i{yd=;0bp3P{eJRxNeu9ZfMlgOT6@!s4{z
zi(t|Md=O|ClRDd`>VzNVfVC@#((e8V#NwH^rQIGuOiTF{MKj|2=eVX{5!+@ou+#Y$
zs=X7|S|il8rwX0>7Br2qtxmM|Vdid2k*(58hK<gBr1R1@fBp~vVe?fzQ%FS^&H7r|
zIaLc2QeLK|nGy~Eo93nz2xJ)8&|d`2sc_%Srr8EYMp%HdI|=IF!WW<H**SQJ6?R=Q
z**XWZa*7DyHQvW^8I6If{vg75aoUnuMh(<Yw`r44rYG@(2^*?ubgSF+X9ATyYZPvf
z?{>%FbmLe@O0G_v^Ry^^+Rx~L|BV?N$;Y>OWah%P*)q9uSF6p7#Ji@W^XGB>l7P}x
zz({hQU+~dD_;9mXxpl1npiQcgQ^#oT>(EG3Iy|x=M{0hoiOp1j^=#$-3QcG7c5}|B
zMPmNMoP@u32VjR*7P%gZ_?lXy4yf6(7wmCwM(~9jPG(C8NZUSK4LHZ=%VXpQDzis7
zrXcED@1w(z{-meXrNDi1R`+`{!uC?wlQ1uI0-!F#Vbj03S^pnyx6P!Ru8>H0qpv&f
z;WDou#}~8NgR=<2n~9e(M2sJHwnR=XzEmaOFhpxTjI49?zffx-d1l^S*R+E8&&3__
zr4<A}PDS0&2mKx7G{V)kAImwihTKw&&!RC$kodG!A9sz`ouIZsKo@(79nvrU4Jc1A
zEMCETV#q5(HNjl3?VYt4;kZSxE?Xn*nN|mkKy58ekF)^Oy70wN&Be!jO<`})=+FaD
z-h}JRFbq=o)=FY~3;i>c4g+(zU2UbB%n5rjlhdZEnGIv&$8%2B9<sOU0vMC#2egI#
z2GKG3CB!VMh?Z}Vzy<U@ygLcF>{Y-Y56JV)jZ;>^OXu#KccIXXbo_=s2vAx{G_Vj_
zYCEZ1yX%`E<^!o1l>u1ysGjT3J_Q3RpT;{xN7nLTy~-qiAkO_g4@4RO8etw%jXjqh
z&8<_L0ODO2aC$5hAVF}&LTLSpER2N)g{iz1nhSLs3C{G>WNsCN%X{&S0y|c`RT!{f
z)E3vge-LYImjb~ZdqSD^`EJ4#(`%s+0@PGcta8@C)zA5+G|l|}>wLrvTg|H`Y=L!X
zt4{?jBR9!Z2Pi^-LjrE_AVvz;;zwE6VZcO#IFXgsE7W$KO2e`$%^cJDgIiY8X=ao@
zWLxSpl_hTDSDhxx4LOA1iE~c`;tU=T&G=gWtqrZoQQSY=763GH8d<QtK2G<BuNeZ(
zRx|yxIN<(LPY{7iX><h-)I?*!KdK0CUOqMjSY4H>VtdI+6kPnD1Pk(F=rBk%4zIUf
z0wA=T&1ZmfWROes;>XEz;4Tas^^x5#t_+V+i`y4sC#{gLp3V^EL2~BAfOhC;FZDs9
z;^t<R9UXpARkD-r?*px)CrNb$g+lki(BuqFcDR9GY0?5I<v2RaZQk!Hn~)qs_EP?l
z0nFy^8pqB2Me7KJhf%*xI>qUNOY{FVH#q*DMm8A<9G@!0GkuCAD>_4+gNc~ir0?0=
zd;re~t(@^Ga5AkfF~UG8E1z?E14y!$*|<0Y!<&N$TWhb7k%ZK=A*6@~Pl2*9F5Ty8
zWwY^8-GyVhOXuIAw<P{N!nd&VgTq04hPz%?VAJEe0SBh6kcxE65`_xNUBRE^h*#lt
zKQctoIbR!EHiQ2@H*t#3^$WbB44*{UX)8%;j1Ai)E?%S!SF~YFvbYT|lmPB0iYcGO
zTDrnjJjiv^`Ta%*EGeDV29b<&dGN3D(F(hl$$Jn#`yR|$H)yBL)ZX*o4<t%^d}d03
z_0sVOZTH%;sE8%}Zt<HX1Xx&2i=7@~nXq{i#wld_sMZ{OS5U`PmC#}c2y-ZCCZpwA
z(kQfTl=0UwK4)LU9u+ND&&R1Z!WKC&djM+RAF^QtsObjSZU(!Uyso$x0u%r*T8D&-
zzA1482KfdbU|)E}YV>0}2PG!)@JKIp!5QKNVpJLqf(S&A>~zCQoLv~;<Xffnv$^X|
zp6l^_MM};Pe*t<#FqHjs84K5pk0aZ*a8oJ^;%{rBc>JDiAy0VWdVxV7B4U>~3T$)m
z!Id)xyCEulUGSdDneS<dnrQyGyx!YU=c0k3Zt%^$(c7Y{D{&F~CAgNz#>$|5>ix2c
zGiD`2z-P<7B|$3tZ+H2f<uN@H5dYaL4@q2E#uP&z@u3XOjk}KDTB8bgw!vv1^=M{T
z7h8aC&G|+EjpU=QrK}eT+kx8-aSyY4IBI2?ZOJHVzm(Mz;$`mJ>kdBz?np6rMCHUZ
zoLbd47aif7u)hgsSxl;%(cQ<CIl4MRuQV%=n^9|@!u+6t6Zx=8{ywp%%;;JXhzHyF
zQ>4ME=meDF&DX^{oAz)9>FXMNRiMoZLkA?NS0qKn#d280aCCyEG}^no_m>gP=(Gx_
zZzoj_ziPSG=p7FTLS;g&^~~1Eh9kQ&2-N8rp7yG%l{I+U@|IGq!CB@1xfi@!Yggy_
z@(wM5?3gP{?-#pu11a-Ombsp)zOBVG-@#`$U$4ZD0}Air@WMEs{GR%dJFpJCl>DIp
zEpLJ7>g@s34dh_4>|1&fwU#V~%t041&8@1Y+GaldvZ`OOEJ@KJB7#|cNbFC&_MHEN
zOdr`WBleV|Ko3&Yh{o<Q{i~6TM8>}2np8_?NxGFh>%3z(9L-C2mg6O&TuonK{g%Um
zOT&J%3~wp^{2<ry2tWX5%)^J2u5~_oagmyBpk2zx+wHPQO3BT#<z2*8!>!-O40jBJ
zN6WB_Ommr%?P+fH8pgE*UhT#wQ>h`=K_xrv&l5h~pNrqnUZJa6j+l<r19oc6%2E78
z)&nwtQw5!OqGq`HEg{mcNo(&S*_}pt=2*<jScb!ndq~q#!2F3P{@otr%)DWNa?7Pf
z1}J1&@ir_tzcHt=%C}4vo3|e<!UnZh9U?Myn(IW4&p4eS!MP&$=4hk>YjXKI1T(xU
z<|IO|q2X6gHbxS%YnI2MHuV^&4TU@?3j%;8JkwbH_~zBaWpYs(csKDkE;2&Dd=L#L
z5qg;@OUAOzG)MYzw(V!AZ~~PxJoBLxPASwrk5@;BZ`*_lIo><_N#ArKF`jCpr=cV4
z1t>yhh3j^beGRm|!nj~c4ft|Xo5=m7GJk530*|4S7)_%Je2k9qW08__bV)ArXSeM-
z#J$A-kA!G}>k$h@&`cgoMfh@SAq0eZI37U{WoV7cnkaS#xKj0>X0#x{8sCJ2Nx?L^
zsV0qjkr;jP2TLvxr>Ye)qw9V@xzP@`_>v%d<P`hVnD0)w`fp^*9NLyhlj+*Te1q@p
zZK+NiUnJSD;W!)&;jLIws?S3PhqNnsqfKLPt(XJ`h^dali}VZt_RNsuY9sj))BNj2
z0I`zG`$c;OB*Q@jEpUXbvi1e~YGc<7p0D}Rr9)if?%@N|KZBxq;O0G0J@@w=2M;Z?
zxyF|8ih`V)grW9z^G0o<tTuT-l%NL0-O2Lf5_H)G+a=@WPXyv(Ru6aLJa$}4OEi|P
zhRvzkz#r8YqN{#Uqxz2sa=;JT<l$Q5hwEAdlwmpMQ2iUQWsj`7;<Aj{Y6G4jN27{c
zccck&3#nBZRsYs}m$)nKGr~vTIRs3q<-J*!(J|Nrlfm?K$SskqmvVc+UWtP49pS`|
z?1<j+3S~voy&ousR$d;iXGGEfka4ZhHiZnvrCMsRG(l0B!_Q)R)(Nl#7zUh{fVM)9
z6y&rHmf+0&XRh^sNVxGnIZE{->;5$`Da38{eM*D(hh-dgS+n%VOSkb80At9H(V+Rj
z)4kYeP*9QO)uKP`PrRQ@T_MZx;Ph-y1hjgY5Gvsir}D0T;d&+FnEWVtd>dq_nhgEL
z2WQhRd&~kucCKwrB5>$nqX|#OpiZD#^tFcv{eX@_P!L#giT?zdS`IS0Wxeq@m8S8+
zCu5}9ljE}2GqSnzWrK+|svee$<oodl>MQaSLLwmeWj+S66mADp{%%DdG~MPLJj&Gg
zQWK!l{i7%U&f9cw!Nyu31hlxS+KFy+)UTK$Itm}|C$Y~A?>r!r@@=+&o+cWq5^c~;
zgc05lk+kLN)i)5OaRYB;2R?W&Yadh|aGW7<_uV}J_J6##+)}x98y{-JwZ5tVU3_t?
z=kDl-1+^{?b*-i;M1#iZp{+zGCJuiroi+lXk1NESiUqiwNMBLQ_Y-_yd>qEX`6hPE
zYFt_2W>r1YJFYl*y9nb|g}-};rY{Lb`-&12r4;Tk>c{l;^=P?#L)j@A0F8th1`;W<
zh?Wgt`?t2xEmP!JFX~2VCS6>PgyS5v=KaCyN$%a(>h}v&^V+Xx$<@S%3po)xQjXtQ
zhkmlO6-|o$DudBp^jU3an+Mw%@aA^xhLO2i;QXNLohL<2DCObvd{@7?upcTZqx;*u
zI73|GGKD{n5EcHx<jktl0x?i70VG0bvjO`(pD8U|DV8@9w|N$`@&V8<VR<^F0P&!%
zZVdyu#4G?r#P~2X29H);c8ONE3E#mIm*jXtRL7Onn>)NIw>GwY3xiJ1aiIrg2J|@<
zK>Fkx0{<8~wtv7d@TrAXZ|yc<g#oXFGFJ2^Y5G-GX;quR0eAP-hjUh)8eUvaB&*pq
z;<R0h^G(@IIbGYLP#z&*5@q%*Mr!cS3$#9XRUM3o%NR5-Y7p`63cha;f=Pi4jJaNh
z$&JiIq3}tWSTT`jFkE+erJWS8hl0!NAxNAG!TQuwdn@UQzU**OPU=M@c+MtIJmxoY
zxUrdu{GiR64J(Fc=%_tkQF6VM>9^SB+?t#uEPv5eQ6byM+=bsQjEj_?F+nga)maGi
zT8Bl8!t9d?GS@_HW8~qtTTUW&yXB!_RYQywFLt=ZR>PLwkkO0TpDeIDl0CoFQPc#q
zF!lYY>(G_U9&(wx-38`shj57EiR@S+$2DnkV%66l$I(sg-Lz${Mys}_HO*qeG^?NX
zX6{y`3g|<cQDi-JtFl#S?2L|{OouBVMfccz9gwD(S<765ksyo^lM$cVQcnn_6Q<i}
zz!~OawGRSvXS1=6<?Y&1^Hfz5uSh%PP?8B`eyq^wNzq0P-`ww=O2vuUCSy;+)}m7I
zEhx^}6iT0qPuN`q+`i!nUEB`G+~NC%!$r00Hk4Zgbedw=#z2Hq1Cm0SeX#Yi*obfu
z0N#{T9a@Go<EMrcaF<Pzrauz+JmfPj3=cCV3?Gc8p9JVZ^!l>#E@Sa$(j8(ahAZp@
z)g4vEaGW3qbL?+YjxEXla9ru+xH1w{_j>d%XkT~G@bXmW#TsL!VRZm5UQ)y5NtLWU
z**C`cZL7{$Hb8`$<t#cft%q8z?)vZ2y?KuM@gV{0^~9`E<FFL<@9l*JU;-u8cs6Of
zzHIQ%Ti(7lPt|}JP_=d|T8hJ$h*JNf)fi#kS?TMh7PP7}NxDVCC>6zV*!xMX>B*X^
ztAO3sS!2KNy>S3c_lC_MycGztih-x+2On+R&lqVu>Yn3v^F&D3EoK#W4h{o26wB_x
z!s;mWa)4F;jNAx${p6z^rM-#<@$K0H-jlC{bxW7~$s8Z=1-K|l8-3iS<@v>febW_r
z>1o|*m+P{QAMwQpCAz>gaEZx6SYVBZ$cfpFKP?Eo>O>f>I4c8tf*#5z7TvkA=Dmko
zEC#KB;+ZD(LMJoA7A<B-J%?L<#5v-<9;XhFZeL2^p{e5LnBC_?vm@Z|Z-=z4w}SD}
zPeP=W!KDp=mNL)aI2<(C2!lOex{ravNnbVBw1sV!-0>V)`Bh8zs7u-*q7eap=M*XD
zLN_=WJ)&@C#PW|27y4rqf%;O}9(Xn6xBloU+;#jV4aFYimQY?bdp(dWI;?*ZBxd?n
zG1j4c;dE&_+*KJPg<a;Q+%WLOSEVQ$&5#Gz!kt_(QYc`p{?^y8(5tBx1!;5JNz`ml
zRh2YRLO5jBC5HnE{Ha$+tAzV-9gbeT)*T%sr-iDDP?57Fk$IsS3uxLNhM1`^rqna<
zvwqjEGm7Sm5BdUX_J%G|IOmDx&y@rHR;WS%c`eg||EjVzb+7j9S)G@wBcz31CvmOD
z_y7;N_h)xf(huu4nGgtm5WVfjL%pRQUYI9`K)xMsZUA(zQkJD?fgKjU8uj`g?tWPY
z(#cxaWvEx+H7X}zOfxVd^B82fY7t2vW;Hn}KJs6n=VnUrN7<-KB}4t_R5vwP*+c@3
zX~hwrlBQbs4}*=rSXD`Yz;izotn>n;4kleg{o%@uCa#>dj)sjcp7q+uuJy`rLg59T
z3B5J9yM3wie2vzO(uE0u3(0$~!Vl;1Nx|mYRo>ZZ+bQ~f76B2KZ%BkPjLrD>p5iP?
zk#hmMuXLCeMJXZ4Ugsdwm_35RZt($+GZgS1JjplGAxpboA&|@?0aIl_t@b{YM+?)a
z7r7>sc^J96M#m?V{NvGhxM8xs`whXQJjU69t;v7Lgs9wgwxq!*omQ(266<f{8aEvN
z$MlzobXF#I<drO-nN#za6p|^mg$ntR%V46fuvS`&+nn5b;Z`2lN9WZvLRIR%%DP~c
zJr*h;f@TRYaeVd)z;d#6He&YW&;Sw4nD6IV$IJvv5#$5r@>&z4L@VK7upSm(qnpZ+
z$owp#sm8b>mjJG$VS46dcr9iedS`FmrjZ`#Xp0=a{i$7&qB7p|se<!SK!VN>piC4&
z!q#Y*2ub#Q;~u}cH65Uh*cr*s@hw;_0wNMABlt+V2yG?_G;{CGVj`Ho-b}=SC<zQw
ziM)?NP&M&pPFT?v4vP79fC5FSp)`TjU^@UW7Ec%2x@y(-Xq5!*0UKE@+S|rN!C-`i
z<kxVpLd9z;Xi6z2SdCicbfgTmS3bNihM&9>o^?hub7uO5N`h5a;~&ckfmda=M{GF9
zu51x8f?X9r?^D9#v9)S&cWOj!#0FjCmVMp+?iKcvbTm+fBV<{8WI`VP=mCgQ3^bZj
zDSO$Qq)hPNa;8>fl@MDrTFkxs4>`Wk@;6}V;C`-Dbc&WNrj1<pr7ek#Gb(59W^_%4
zgR9F^RhY#O^R#9mZ7|pyVR?d7a0BO;#Xi_Es(+s=Baj@3V(s+{l&Y7qxFmoWQfsMR
zLH<yVzUnxgErVR;<?Q#6)Y%}ipoEU-%TFXa9C6FMxSU+tg!xaSq;~MsZ!%1j7U?LN
zZF45{C?5~{qjEI7c0k1zVL_OA=Pauf<80=kHy$)ZeA3Zw&L;B={9{4~B6A5=!tDo+
zCj|#58GqN0OFdk1X9KZCG)~<oQ68r*;w{&2OVeEYS154?lN3Kd$36dBOfdAHat`?e
zbQObvR=9sC`y%giSdQZpWGS6h_s(-d1(DCASFR9+Mkz2uw?s`%v1x`sy?Os>U_Mb!
z@(L5CKz!*t@#(nP4Mo|>{f=~0BaWjYWlPEs2~WvNd&bUUYXwCS+xst~;myfS;}iLH
zH<mcZnejdYxDu#|PYX}v%NMEpD`gmMGSOYUPi1%xg-Ht@1c^AS`(LB9XUBD`L%+Gg
z4xU8kJC3Zg$tHZ1)3Wg?0#7GY%&u>`Le`9)+c}33^N$Ws6Q?zR&85}bapp3)y(ht?
zOE5&lF&zlx^a%8ajBbvx1k^t?{;GmTzkfvD-Pp4Z1JAqS*cJ)czE#U0+Hph8a1F5F
zv9#Wc*bj~r`DPF}lds$vwRJ5m?J{(-?!BrCu>a8*KB?NH?uur?k$C-Q7LFC@LpM@1
z4D};de_h}vcUBOaMtRrXGW+v%PoHtm!g5eVHTks8=&!c#1FSmz_R>&|Kvxkh*EH>Z
zCFIzdZb=&uNRl2pD*8#G!{0dEUl|-RA9=mCutJ5`ynLwpbqf{gxvUskfv#SAfD8S5
zK!NJVB~x(AZQn!6UjNa8$1nFpJB!XgGBMp7MzyiW0x|D`M=;(Gw#E3w_HhR4QL-X&
zb|7&c&X<c?<?clFeS)e#aNUWD@t@Pc&R(ePc5DdZnr(sLKr>#G_6-~8G7of;dH_H2
ze7`@$;^~OF*ZOg*)0Y*ON-Lj%Z}I>(SjS?jhR^f;?B1<^P|m8pY;c5?&nL3+ta=m1
ztQLxfSu7dLq(*bsF1>c#<%X2+Jg-mgR}O+BegIi%WAnMx<@adM)xAAG7uT{j2jR&x
zQzQgCW;mOKE|HF;Tsps)i2m}5?YcMXY|VJaCh<i1_-AY=``wz3y!)7D(C<))X;{gB
z0kn6J{rOFl{6nI!)%ANCza@%D?SU9p<4ilJr{Z4hE)eB*+xuCLfbw9#1s7bq&0q;d
zV7>=RVM~rWdSSiaki-;GFJsKOrGNh+_F_G0{Mp$;y6=cB&VZfC4Oe0qt84080g}Wl
zw6^eDJ%5r_5bC1u%KPC97_hTSSlo_UA!bWm9mp=NN&;g;{DQmgAXd6U|MxG+Ibozs
zCa6L@>5E|`SvuaC)iWDzJ8CnHU?aXJcP#JIj6A30q@V}po&U&i8Q>Ps_bbuL5jpvx
z7?AXGcn7b8yvDi)GU-8Wr39`D{+At1o`Qs~+fU3SoYX(L9<6L!&w5#fEF(c>4)m!&
zQUAqB<g?6(XAWVynJXo)N}=s|v<I{dGwI}(R|URzt2S<53trBafCRJ3*?w#b0;}iZ
z2h9BijSHx*JTy7irIh`w_xxRb@RL#svXoX6%?-D5CcmPa=C<z1nWfgzX2SMR#*ili
z%eM~&$l(k@u}MV|Y^YNNig1Mz=NhFZVgT<F&kGU;p1EIdvX7|=1D^6$4SzqM*5YNh
zLS>XqwnDPcZHXLeLfz7Q{mzQ;b>ps4H{WnF3tcIF&=eG}+W2Ik>!<ueN8G^Cu-#R&
zcUsv3@i!4s9<TA(az24fW;5o7_@pTB8Fq}^Oz+<;=AQA>7FDcoxbJAfa_gO1E*?$L
zY7SCZw4CNzKzr7nM)?>fNsKkmKtjfJCUpOLA1E*w%#+%bpg=vG|KV-M(M!tE^&oxF
zZjPdb&sE`4MK*`>d%geDV2G#+l_|m9`?N&62$5oQ65VqJxH36N4MklN9|08x5HeZt
z<r~{Pva$T3=bi*y6hfmewk!ke=?oJkrysoi{ZDW?v|u*KB@}c}F$A4H1z3}@m;Gqn
zuIjRvbyUodphQhlA_%ibF{r|sD2l(zujy6FNFYe{*m1R<e)XX3J|ROsh7A~#aq|Wz
zWc^XU-xav57iuB$epaIfy4r(|ZdOJ_byuJa4(jJEMHc-pBo{`Uwh&}Fbx(aJW2f}|
z)je0x74FshhgV<-i$jdc&{=1{&u4@~K4KE^_+~M_8m5qZv{UOnd;x0y*hjhKuOEmg
zwgIF##1TW%lmR8c7!J|>AUvVSc4|uR8u!&YDebTqYA(17H)Ttp&`5Qt8e8HximI`$
zkfGm+&dZZmX+JVu0Vf39dlQm&rsM5oDF4^qr~=^>N~AGFkEb)ahfnG1L_1^@r;{|S
z095Im&D*!T4L*}BD7u{){MJ8)`0xwH@p%Mq1;RPz&YSD_Xw*lA5p$C*$Z_j)UxR@E
z&`y)qo0|O%Pd&?yo$cu8CU1v3{gGHTxuKLcVu{G*^h!K_xWYFw=J?Q@s6@YGI(zTM
zV_4-Y(uTQlZO6`xMNQXMf_s4LtXSKN6Ry43HIXJ&d4Fp~AHtmA=@N|i6@RFO7o-<3
zj~=WuPL}3YW^)nT8qnZ6(KOuln}$7``P*P$jE6<)0c^5u952}_Te(`XjoYm{W?{J5
z)e-AM+@6nJdef*4rJttk@MpOx2Jk51PIttv9lM0h@1J6q>?QgJ-z3Hy^RUlDug}?{
zAe(&o-LP;k6W}``4&=DU*UZRF4qz;12yXh4foWcw^}}ZnX!=@YVM!0puYf<fy)uGj
z7LS2iF>l4N9y~aXavRmTrdw|xRG$9H%<1e2;{*}*sb{Niwqwu(*l>usH5&uSA6o<@
zMDOcyK5B1(MW%7d(>fQODNf~|usTY}eomwqF2MW^6mn+Y?;RhJz67p-=G7Gz%F#S1
z@4Ka*O6}Y)`O$^TIU`uy&#SkscQrSzOW{l|=%lH=mr5a=)0`V35(Vr*$H5+nDMIoK
z!c^B0TTXQMfExja8>UK%30mN+a<TTUOp_lZ5L2NYD{J2lGnK{TGFAuE?LM7=+AS@I
zA}MmgA_c4ZV-Wgb3R8ok<s?u$c%?bIbyxy=C7BNk<6gdXz88EV>U^ie?mDp`e$j24
zxCJaP{U07C4gHv%#9e$2SQ6S-T_CLo7#daFa~=@YTVvTEVdFP5T(Sn$fRq9~Nh{K;
zUH+>6(GI`0>k~kvqc;V=waMUBERDv!463r8I0a;ac%DvpV(ty4Lf`5Q>C6{K_bXI#
zz~8;UA47_7C+GTCiw#S5jBVTm2<`wx^qw0OA2GDusX{kdBZw4a_u*}8)NX8l>ScsM
zF=|OYe!m?4pI-G?b>kFkudI^r>zW1zj-hTv<Ay~i#oofs!g11e#B%AOJ9E`olma1o
zWRAprdhaT%l1eb>9#~p@ywW=e9Y!AJQuSmn@!Va*y$EBhj?wivNK{#%&BqMaF-ZXp
z#D#s#7;2;DKw6d;U6Ao<)h$d!7X2%B-@_6U9D>~lsa?;n>Rp8;+<%E(7hc@*r9<~>
zPY$XTNM$Z-%M=$D{^>R4oXr(N%E1Lqk_M(p1d*+uB%fl3=L%)A99H!8^4xxgEg_xh
zM<#$uaPAEM1jv9(ybuH`B8*a-4|3NBZpM^v>?ex8dzdm+;BAzFMapi$*MrI0PR*X`
zpM{t37~9o1lUC7#0dVW*-zp#AdSyLwgI8Bj?Ou4%Dqm=>!qyKpzV`j03(?k~Ga(mM
z-i~y2a@&z7Ui=-BWTJG?GfBj;wXGJtR#sDe0mH1g1(c2-&H8KY_Kv413@y8XL6AJN
zsE;*Cja1T|E;M?=fis?)oh&NmKnRd>2?VN3@8E|?+&gWimc=%wP{V8DalVO_Ux3Ba
zMj5N4oKUzRPPba7M+e>X5J#5Zr2OR$2dER>Aho8fm%wlA78ez%{zBGpyhN>#3*%e}
zu+|)WqIx6(Nj3n3Qs;Xf*0C4O%^&&cLdp}^kLa5yae`&nSoT(_l~njJljEXc{X-@i
zi`gres`m^QT{f-6`H;7Y?4_PcNLR@fe;x2ID3WI*ykbfUEL!~&Swb1uxJ?wNL{*Fx
z;6=sYp_fz;eX1Se9d>g<RymtsvmYV}^r;4aH7@u;3-2wK=<+G<ml@a9(!hF9VI=Ji
z+DF|IFRtn4Cp&<4_xa<UWl8QLrIJ0GhU*7B5LZR3RS&1@NjJ8LpEFDV58ssWZ$o!4
zDD~lq!%MmQbHqG&ve3$}5C1O`rpe^4g>1hZCH5J%)NA^@h2>B)c{}&YJa~A8^#be*
z^(-46O-A+;{Lp!*xa%p4)kq$?&b_l5Qb@{*-=oHdS#rTxj7=ib$0AxUK?}Z5FlK`7
zx7mp|$!gvpg2|N)_QxK+u4N5%_5^^IP-p1#p5sX1QY0qm)GPTF@N49SpxaEs+eUbo
z{!sG+Stx<uv$vxaVZO0m-H>vDTJx32TLU{{k5KDQOmk0g_7)8?Z7UB}gu9cRe*=aG
zmgma!g;a~ZV6=gO0%UO_QFjI*udUw7E8O|&>6q#l+4V}}I9k<w`H=URI6D?VPJ3Y`
zo9&0PE1IJVR|g9c?Ue@Mj8tYgXmza<;3uRD7spHS@5}-Md)JsJ3z^l1EurRDnckg`
z>I2FC_g1c%A(JPWN+e7|n7@*J2?KItU~eGXd^vCvIXi+?m-X#4h?L2vO?nVaYfTzN
z`zwMZfh3%QKA<cxAoGYIP<cym0|d_z1q~F!gNNSn{-{Jy!_PD>d8za6$0m(Jr+3Ji
zMe`25@pQFHLsys8ebGuLJRu)VoqK#F7To}3i+Ejj1fb0m{3H8q0FK{uXLRME0ihZ1
z1^o{*k9kNQFda@PTd^;?{``@S3rSQrvyWpo7TUuH*Jn}s45wJXCD#yHR#5US?lHH;
z^&&U~NEFWI4s>lrAKPJW1dx=~9Ii~d{oDp8awwL?LI$}B$;ps|Q|EEBD!%(|CK1yv
zTzpR3wR(85C@HvjZYX{o9Y}~&Glb+S(HVk)scVu$*_U;8Mn=sJR!fXo<#f>#tOx}c
z#;My84efC_u9xV3Bd@YT?ceyffGVh;qrM{owyU3=(2J!D1q^OnJl7t#-#M?quibv$
z3BIV|YQHViYN2|U8v7}Ds`Mk1QTUPCxNJY}OTtd*dQ8~tR1+elpys6Mhm8MNDfF>n
z{#<*Ezc~=rtk_tL)CSJd0SZ7w!bw+nyHO^q9FM@nZLCHt-mC6|w!3+kMrYJ!-NfVN
z#Q`4p{0x3&sw%e%Xf>Y{rZ~^|?!m|!^C=V8KaufF6D)e<Ni%T*t#h)X|Gj(a{jBRm
zVQaP)Nt9^3)5=~K(w$-q0uc_um>pmxy|ZNU6Cm}(RU$8b$zRV=#|5nS>3(=<c+vkm
z-&pa7mM>I3ORzM82yd-9KPk}0!qcZ8KSk(W+_DR+A2_C;?g8(MQhWxiQ*#93tr^{p
z@kRvp0&Y{4v1)&Y@l9-Od;s}5=9nf7#GlgOHsy>{zl8GL-o^iaZ!c~s`*#i(Fj4Dp
zz_!v~A>#}6%XLJ)&E;!(v{Xp-&4>lR>@cCYwxKc@n5m3*X^Mf|CwLMDO~ng+kXZhn
zeemKzqbJ(7kmqv_^`b|-8UvVq%Hv&2o)1kp2NiCZS}i*G_v*O-&}68Sf9O6HmRIJ)
zM!~P#|D_Agx%_xZfAMUd25JQ!s`nR+lIkS5WMW{p87I!&B%+nzGs#`MHv_+LCYzFt
zPBOhWha3T_@=v+QvoworZ+$${AEp$V09VZb<Ua_keP3|tC$(0ZMNseQsVIC6m0=y7
zG9i4l#H5_y*+*)?U{HYf&9j0jcQYWsSH#xgG4-z2+;$(Mk)>8Fxf>@J*rn0?C2*oB
z-zQYql1gMQQs!Tswv*NmoIj{)1t<4Psn!rz8lZuosK5a#Et7b!mHsnuFdK5@nC86!
zxX<(UOGXE#0SFDu#sG4t7Jgq;inTpKp)W2W1D=q06_dA9Sg>@fxjql={syB)SBQ%L
zkVk5YS)DFrI<RDqaSiPC=|o)#y$I92j%QD;%XxVaG;^Q_%7FV$NkTU4L(XaaaJ*ml
z;xlVPwfiV+<J-lv{N~gy)1ZO#17UCH2zg^3-W{Q#FFKnl2THuh43#RW`DE;H=b#dS
z$vx^t{ildA7DU2UZoH|74q_0hPI6wJC55DC8ct-BfPZooIayh)Hnl8Ob|foN7gC~q
zlLka^HXZIJoD1uL?u9QXnJrE94`@NBA~^fGMj6Q$FEGEOHd*EVY^71XhXnBEjf<N=
zPsab$Al=T#>+JDrvzry=rY!e_>Z3F-a_%$^V2F(zOx)4wM3?vh`yq`X?&kCtg^mPQ
z8A1kuU9Rr7^;spaPuSPmn;~acZFj~VaJ6pan-fyfEyF!Z-<x=VqVcd~iaf?x*dnb%
zNv0e{W^p7>FW<-m=}q|ME*Teq^q5AmA0tWr*~dtCV>Yr4(DBn;ie`8;atIR((Yo>L
z2kuF?kz$aIGfjNU@2v#l%K9$pN1#KcJ>kGAR+`bn2Rju<Nxq80IP_*>QJvV20V`(!
z*`LJthf(ZfD)q(yk*2ecHrsoV<_uDX6+(hjD7BZOQV;92xBPYQGZ$8IBhj#+kllAP
zdp+hChAL_%UaT9Wq<Q&z_fAtWz%t0gRgPF-P8#JUQ_LOkecuVv#n0=n3eRWIbZ0CZ
z4h9|zOFE(2+daWBO<YHmC`{R{En3ooPTEg43zMYse3fa!zxl~J7yNOh8)r3JXo==*
z0@cQLc&dvQOFYU=^@?OOD>yt5M+!O~i{5H3Aen=B=K^hGiyV(yFgKXc`bl*qH<N8_
z*0#-b;nxO>thQp0&Je%-a7gmt5Wvh8Ge>_+KcK*?p0JoYgQ%y>0Yt3`$z`!4=Mf6n
zVL8+>$*|DP<vo?M!&Ob_?hyV3;?e#h?lQ|bK*H~c4=Mws+&?Y1DXnd%qLsh1AnztX
zmg`?T?|RTR6^!vR6%7;*zvb{IyofO$hLP?A6FI_457~}7+5|%dIdRftK}f6E@kv?>
z#gpUVZE>C@?B9Qwe_6EVcJ$hCLy4Xpsoqp0>Xfd-)<u7MHb`7+A4W2H`rm;?XPhrM
z+2xM#_9wH6+!rrS$;4EfQK%A=^EX80dy5;C3km*LYD6Tc*+~W?+d}jY)~C9)yh$6Z
zI}z2GVBFnA64=_pBN(=`xWtn?5d`r`GU*l&cGrbWs;8Gzxa`j3YqzMCo4tf}Yo_S3
zWlqr?K6?}v{gg=|;e6lEq>MY`{!I*D82?@aLHb;2n9o2zbnejd@E56(u?UNmOb>nQ
z#cjRi7J6ZkZ)lf7ymKQluKh`<?Zq4X^R9s$ks!#(vsYWz69rrrVi<H^jzCT!kHwvN
zSC`GDw>|zp5XHiLPC&~I)WV4$s;c`W%D_3nvlBaaQedN#JajSsQlXrnED&<{>4m1|
z#PnBA9-61|tg>ISh5z$kQUr&+re|{|S9ytx*R0_M^Cmh?D1B4AjV4}Ho}O=z9Ww_}
z0b6+|>$}s*_eJ7n&U32-+quxiqzp}w<R+*~p4!>U?!KXzK4!3>GJZ9@PQiBi1+@Oh
z#LEMR^A^wP?_8ShyDzJtKwX1EP<dUbgO@w2@iHr0LX~TP<`^`RskkF*uY2P&=8+^=
zGq}HCX(4}w8%L7`F*H$RsY*F{2=g)t<X@jonB4kjS5p$_bCRhk=JAsKTa^sY1tdG?
zSP}m9e3$<>H?z$AkGvDVf;`ueLLedJGEe)($ouf2TFRW?=0ryk0;+^xuVma8+<;Th
zElto$z%vmf-UP%gD6KIWIIV@5+7eO!1XK`cMNIowd=Z!LcSA(OGxA(zQtC(5NA;H6
zW8lwEj`HaYSeO|zuiu`zOc&3IEd%p=4csS!u$qzJ)a_j&D72frm$@JN$kYMYI@e}9
zIbB9SgNT|?G~ups+qJS^uEJX%dOK7ZyH%=G8p^p2&~A?dQ;~>MTq9ajt=LW$iZEOf
zN_ix{14ZlAXpz@&tkmbxDym287MNX<na07Jn#6pO?UvWqq`f%h;DTs%)FH-XRGfbl
z;*u3L$sB0ce(#5D^T@91G|YvJbScA`NF07V>4qN=6`t5`bfxI^te44RfKYJ-`Y1Jc
z58LkQXY%AXlP)B^=&ocXQ_uX~MAaO(>n9rdi^517nRj?B#V@)yfLCh6FocM^&j7rY
zWHU4aDn@<X{!nF+?e}m*mG2Tj)1ECPUqrYu4aNPhD3J8ho*WoY@z@5K{lF479I*G6
z#mWAxiX#S%_GL*$rXMmQ{sH5ZNELzeR-d%HQ)W#A_b<<|CvD`me^vL8{LNdP*=XAt
zPw-qQFKJiA$>>asES4U+$a#kzHsOoUH&W0!&^&_7#BZF!q-ALi=Af4W{bIz_W616<
z%mBV-+{|S0nTk9JNaUX5x`g2%4G80KAn>9I4=r7kw6M)#g%qn@E4WI|MPD{R`Q&ZG
zQY1z~Ch`~Ti`7V62-$nZ1s-?e;v}MN4;y3aG{<zh!I_y7ef1y=g<Q7XClNk)Gg4yr
zy1c3N7eur%(=X_g_VTortMib_AR=@IkI1b!`^OBn^a66dGq9@xzZW9hz=czyZj&R-
z@-XWt3bDKxS<4A2_L0A1UMFlj>?syUSk5N#xt-?S6j(pMp>x+jnNSWjj56Rbogjlb
z-Eam<ROih~i&jOHFEH`0r+|Hg%o>UhdN$mIsSV(-B$Q2uA8q?k9E42jNNel`Kvz-G
zN2YwiMz`Bk?frAo8fk^UCh-l#=c=(2BCS*$g<bs86p-SuNdRo68md;v_3N3E0p>!6
zVc~YiHfuI0!*MY$ka8VZX9xF;UrbW|by^#fDK~p9T%%EhMS#?%C2sp~WJmNX&l>3^
zrZ$VIrYOIuR=Tx%!AOZoM>!b`R;7|%%Vcayte2G!S)kWmq!L((`-Op+&q|4)Q%?n&
zNCAzU?w*?}%s#vwarp^Wexu!AHi%(*I^Kia;b;z|UzM4C%Stfl>14VrIa~!8M5`ha
zfp@=1<YRva*ER^!!@*eq2+~kvF`>kL`_vJPTn*8}Nf?Q`mBHp$PxjfG#?#0K^`#dy
z<DyjAXsm;9)K?Fw?4}Ozcxt^t>z%M13~^_UIANOX(JrvR<jZKw;ZB7wu01(bVXl^d
zQT%im67{t2$`!$;oT!Q4#>UCec}C*o=$DvK+i}Y06MBo@0z-b0wYr&RBCOk_)00rt
z%x2qYg|U?GLyud_#1u4-OUhGkDdV9U5doO9OPowXWLEH@LLZ&MvyQ^kGO-dxm!$8#
z3G>Mzs56b75kK(r1*uh6_}5Nsb}FuRU~*lgB9}YoN)|H-qbB-K{|Jx}P-epj8wP2o
zfn1Km2W`vWJXJ|*&gh)0tPr}3$xo*)?BYX2`oy33wVF}4S59lLM#K={ra7Q>?~tS?
zOD=qW*stIIZsYSCuam=#w|WGZsUTY|0m;8sS`XoFnY#6nITikM^nD-&%ei!Z_wzqw
za>X~;o*jwDCG(QvFUtsPGdTQm=!E|(NDhBR33b{^l`4@eN#gMW-9|XCM#}sPy3Ej@
z!Xb(3GUXJ?_0j%8ioDW0&9qn2BnF_z28xjvghhm!ExR5OI4GdN%0!^J_cp>9ToeCo
z$WHQgUHLYYC9Ob`MzGrRR2i1iS_Pm-Kf`fF*2;GlhHOk`6E7?kw%~Hixd~fm7g=mh
z#5*Mgn<GGD=a&)+2KCiy``3PmQNZiGAEvXhO9uE-v<tQ?e@N8}d`<8#67<=A7(uXX
z&sM${$by2RPhH}OjwL>$)n4xL9|iIlKTl{O)fx+ecOq2Ur`6~ND+@t<2$|@_lu4|d
z+OYMF*mi4ZJU7>qOm}3pz87HF!4u#K!u=Kgw^}Vy<^G-X>05gOhhw47Z3pbXWdprO
zAv*KoE3nfyYR$3V_J!3mKsR3(9KkJH`>WU?KyPvj6W6WG*V#;9rAtJ=@LSpu@qm}I
zN5G)Z0lT8H3|QaXi>ntmPkDvW3j`#x1rs1jTvD&1RoPs`>qf&cP-8aoh07>0tHPwI
zxi~(unL=P(kxs%W*E3UZwr3~NGc+0Q87m?)I<HFu1hNM!R^q8gL^MeIL3LOp^tEtY
zLo3D;K8}$O$#-q@oZdq=zGMw3$Z_);@cNHRqUtB07I_qnIf7Z2Ui0i)ctkRfeGxX0
z*<7}8L2&WDQ2jfn;mwwvvO%G1LVX;lZA7r;ekmQB$G^c2zn^ddBXCRIpSzlI`%*@r
zxHT}KQTLTypFIva6r?4ftLM&G`0#h|q2LC)esK&es+b-);LocYlsJ_l#Ze|60o2tS
zKgu=G*3N4W3E)0rtx@t%hnaVGqh7@w3S*3UM=l@Dm}bm{k=s74I1^c`_K6i*ixn+$
z6OC5tGa4`KJxG3DVkI;#y{5{~@8p0OF!SX--$`hO2t9&JLonSB_Vs!5X&I*{@#Q<-
ze=f~lB7U{!i9_JIof)~v4gP=6BSTZ=u$vv)+asLv5>@5=p@+&;TSM_uk?rQ~&?;!1
zV2bpyMEpxPdJB{h?NI7L*7KJxr6_5H^n#zb#A|GD0rfIkQh<%eE-}+dRw>n=m^TPt
zfJK%tS8SHm*G9`Ne&rzdBv-)xU|_zM;b7qwet*XDH(Wj5ft>a3#_*SSRn&HUMc&d*
zPz6Q<h<RedG|iI8h#B#`l%X1x4V|Jlz}36S6m=YB(YOr{p2WiO(t`^MIsR|KUO^c3
z)TC{m`qLE!U*lmrACuY!9IBso|L%SM;wt9u72!DKF^=w4H3gJ6P8K-YAvlUBg+SF$
zNo|=2jS1ydGk^`9*$!OCtd6-h+@;Vy>|_JkYAzaNJ_UmwrU!EGjQth+()O!QgN8NP
zbIWW3>Nd$kV+m7xG{?kgoM5ik;IzRBSmRd0ULta{s8|;J^|H-q*^AMesf4j<eJ_~Y
zi*>eQbW?R-UkD&3=0Oc3(UW8r(;cX#h5ia|79WR0q)V`|3*OYvs1y1U!9+TF_Pa$@
z_57mGVHCAW_G-S}YtJ^KKaPQfpOZOQnJhi|AriA^mc!#Bft+6Lg1BJ7J*r2buJk%3
z(-c9>d+}x_9Iq&i<sf5Xaknm(^-BQW_AF`fC9H@ZX^;&e&6P;U>Z3iT>N+kNBGY=_
zfyW*h_o;tAbx{Mq0YD8f_jD|A=UB<Fq1rtETneADgkV1^1fs`LEk@zqsj^p&U&#L*
zf7;*!xD7K#R@w#GsrG8&cLS{RCz9P2_3x-v4vp5sL<r`qAP>;l4zuAJ+ix&13(B-X
zf1ywZea>WSZ<KFLs6txof3gVvsFG%2wb4l1znlSBG?A9O;wG!2NsR_XJEuB7Jk0`6
z$E)G)CMVz-AE(X&@A@2XayMq25DZ<c=RJUfWnyY2DmSyjEzhvMaOQ@za=NHN(OxqQ
z3eeVF3Y!W(@3P8}mr5FKs(YmdOS~Z8c=51ZdC@we!~@ZwVu_iIXSkk7yUmjRe-2^<
zxHsZAa>lUm#YbNS<OaIpTc*o%zO4SE5wa0_LnD~zX!gkLs8ph=h~b|&l%7oxGbdjW
zW#gjt@15l&x%Y4ABy<-7A6`MKPh}P!B&g>63p=Cqd1gv#?$Xw)Eka_D<wJ5-mv3h)
z#`u$wQ`|$CEO@a=dIs-vA(OQE9~U^t85xjKq650rgj22X*fF@&LSZ(Pnx<O&IZzDz
zi2Z%Be7J<c4R(#pi36Ay&zo|2{@1fC5@W|zVy__0iaSx(qm?vNShDd4Ai)IsMmVXm
zHGpHUw2?aE)EV=o7;g<iV0FLe8xgYsVE&Z+%%BP0q%~AY^ZvhDCFmf)JhOc@P=>ne
zuTt51LBnu7TFaa#U}1!C!k6+uZn*|nz*4*pW<NL!BrkyRZsk?vNDLFuqfNIHNX09l
z+zK8>1iPuLQMC$er`}pkpsi!{_01o6&K46-N3{Cyl+N*`5v!ESwV~Bp{wsN!?Vbt=
ze{vHWytCLsCvX=AGrbGX(PN&d3^Ur+nsDpmEu~51Q2x8`yY?ZiPIqkwc_}5>c;V{z
zcFzJzx%(4PlTJpQS}}#tC&n#b4C*;rw5sIB-EVw=<Ru?zUa$Eu)UZf{!{K7NZ5arb
zg9Bci6I`J=(`KsHBuDv$6=^hTmqB)2vI0K-GUuwG_n|jt|BOoar{oall)v+18&PML
zvp*=DCcfb0qN?Yf#x)o)wMcOADnvx8ruaa`Jd5z?b*EQuWf(^0?46WiU+XA?esA*B
z_XOybWx?+9&jlTkN*sK2F_Cb$+#lEG6=d3F!klECXcXd7;c!EbMCQ_#{vwe79k+T$
zW^l%IhJJ4jZbJr9YghQ<Y!ScRwlHC4NCUmTsGFhyWv$(3>^!$w5|~Y!Wz)@QYt1b=
z7Fj46>skvs=Gsy9;6m0|kgK_=GC@)n_bbvS7c<f)(G5x%?Y#g+K)S!h@c5?gQ*?bF
zW=(GT?BMiv!3rB)JWdzMCVQDI_!12pMDsYA+DX|qD~^$H<OH|210(B;zZ%&L6g*Ld
zm-_N2G(Y%*-4C%O!@?JQq|ycFLzU!;NMWSCh5_<KwHLPxd_Q;OJc0Jy)E5Kex<{zD
zhhQ6^^7CJ%@XSp|L)ANI?xF~Aup-pc%2T0)1tu-KMl)C<fSkR6E>gGicj530`>syX
z7*bOcY#hM^$$+<*ZO}G!R6=d{9usj4<XV#`{MGrdMI9dw$#9s?&hUj-C~99^u0LQb
zaE%;)L~dNoK-(>8bLg;EFHj$P1F0uGy=DW4FkXZ#-eF)hM6Mf`;r7)LC~8Qr;K7L%
zh-2qsHgChe3~5L-v_N>|8*ycK8q^$**o(6pHQTFN=4u2UI7^p92AG1&<UQ%)GQ)fg
z>4yYVleHfFAQx!jm@2!#4L}cfQswt!v{@O6kVt5(OmoJ@B!2;|)1Vz^^9~V%(5Tp9
z1Dyy#f%u$po%q%^KBlJK!%Tf>+*ml>nO9(&4HpfC_q$#cvZ81V_wQno4NIp`1HK>6
zZLgnC5<rvH!%5j_4{vMR6SqdA-;G7DxWGYduTZ6I%RWiT_KPa>PL4UVm>59hrsiMI
zgqMSK^LDzuniLP=9RFN^91v4!bL!U4`1$bP**;ONu`VAs3^^(#$5O{W68kvGtg&&H
zVA|YQ{X4v_xHZ{C!E<7s1UUd-aS1#CI+fXY#LozY6D7Ukw0z@c9b3yksHXX{3*I+S
zOI|nFR*2!B+iVKLH_L^)yy+vPo<Vc7tjlr6s@m_uz<$;AL=BpedoDIc14^rzlJcxl
z=ee6TFZ04paYwKzRlUGeWx$&>h0Vig(Wq4;XMdD1*P#l?%{qP?BB}OuvUAwQG*Rjs
z*CxD!!3af?0SC`(j!}^wR1<6NxE6<YlCBzE%8mC^BgT-j<$wBK4+7I0Dhf6fO&8Ej
zh;0>XVGBU6Mo(p7tqGphl8dCO;DbG#>pl{p@>b-vVD{iyHpQSqE!j}}IV{tMBAa5b
zcOErxV$WEWn&BK>5(3Tm6Od-88;v(aCsE!Z_`gIgmoFYph%l#DjTV}vwUQ}J6WDTH
zCEbQNS=p!G_zpk1e}&-9!Jv+G;BMmJ?BG4i1*J|-`ol~?E}Spc>l2*VG$wCg*K2{}
zU$F4{4B&s*^bDmWyIk!f2nuCEJ2uot|D?qskKj679v>?rPKG+I`1lSK_;gRYNdm-(
zZP-f8dVv{tT?Wq?$r?LI7W)7`t!uMXU(`Sk25JJ0P648QQr&l&`m_#rXn?7HR&1rE
z`?D>WQ3_!U>H(=_cyHsvslRi3lJ$vq&TZ;xMS)Nv-;v5wpPMtXr6k8At|DQ6(|71T
zi7t1^<PpYGHGhh*kr*L3pu{6ILkMvVlKjaJM>A0i8KY#R1Ts7wlP&#x#3W$Les6k|
zcb2nW&Fx*lbc%3GM&-3AthcU4p(w2Zk8MF{se^13QpJ(*F5#JNE!lbGQx$5~sLq3}
z9nljyWsNm~0z%!f7M-QZeISfbMc}89e~j8c&>sl^oN>n%YY$y>=g4~tmxGBGDFS($
z*8J-6UIAof5^NH2k;JtJ4^3qJ9WORc)Wq=5DwlIU#2+WcQem`db@a_5=4ZVFIa8xm
z38U}T+$8L{jG;N7(~FK#v-A(U5V!5X!w=@sYwB{<@0Wm$07P}(g3UUvb5;o{Pej)4
znL7u3s{@PBfd*Lr9by~J9U{MWa4oTXhd%Go&>)loIhqO*iOp$T<pOdxr47QN6Exyz
z$Z^UzEx&JheH?9HqFZqYQ0=0)XY1%0SRiOjZTI9CK$N#S2OJG}uS0nF!A-VI;&7XP
zHz}N%1`^3}!CI`WJaZC}OEiwyYNGd~6DhQZYhb`FI>v#3@K;b2nNHsThkBJ_gKz<Z
zt3^J7|L`o+@e_>W68PIkMbT5rj7wlXi1_+Q3KNM;4qx63QKAM7(~7#@S0f20oKO_r
z?GeOAgA4RqpKKfx(Xh5lsU_p2?tU*^sB`N0Wlb5uw4+@Xrc}uY>kJb*k4I~b=GEV;
zq1x1jaP1Gv8c^a(jLxM23cD0zafnVIH)_1ya(o=N(7>TZ=gXE0)*~k3a8qYAimn_t
z>F7cPy~#(M@;O+*6XI%+g3T-u+;*L#l(LmoTAC-}0cewI<Q944EHCmXsB*BCxRq4=
z26V~sM?Rk$4acgqn2N_2v2ZppI2$F^A<dm6c_TkYnc<tRK+H`rB(s_*`b*Tow@qeR
zR!Ao-uu#`vM!_sG8H>zzA`tY3Yje2H0dk#7U?apaF$`(Y_lU<_M0gVdEfPzR9otGL
zpp!7YAlrQs<8KugRK0(iOhuBdI2!pas>7FbQLrlz@*19O12u<;<A3N-))`+0z#5%^
zGx+6MuX4JTfmU_d)1WPY%Gvql#9^O?1<h(WKl1r@Re)!!LHhyt?+wx^C7#z>o(pPt
z{kTHldVuRk2P&FqW%dm#+5JG9hbD69l7i3Xj|+e+IrRX?a}**mJ0wi0w{n*BYRQA+
zEjP!fomuY`1GNGQ2b)6Mc$edVV4lz@TJ8qZCRBu<cm)DbdI{mMHcf>8wwiaqh&)rW
zt2yTaZrPP=o#HWxIC1TBf{~3F7&VHTDN|NAocB{zg68LBIL@F&Q0b#eQm!g?MnGO%
zu`ao2!jjz9v|aDKS%n16fl(<Jvc4guhItI+X$^qOZ^He=s!id8q!lwlwdv1zo%ea;
zKiN+r5{Oct(fW_;XtY*aBP?_!_5Y3j=zlYmm~zFny{LdZt0KKdNQ&RIgZ*=0L+v92
zMg;u_;=U`WeW_<avpQq5jb8f?g@0q68*e;ILTT(EL*+>#-kpiLiw7R-ZjSa+gTHl7
zx4<dRn7Fj#0=nqQo?5D_3Tv^f-~4Ks(gjL1gV65#^k6b$RiX8d&}aCNZpiqr)2s0I
zX?pk91WkZ-v`BMVIWW72E)U2SlOpK5@|^&a4-b>5bi|o6s5@&a^iq8zrD?OpGXy{b
zE;jhmT%1ZZN}&oLlR-rYBH$;{_nb!I7Oi2Ouu(ELXGB?JDg8H2%P7GgVsGvvC#W5+
zrdW3h=olgp!$bIKTGKpk^Qs8)QZm(+#=@4c4LCJh$gxQC{`l{_j%!>O<7p8fr<c%t
z+$cWN5k8Sjz@fRJ`#TkQN`PM1(L;^~_jj04JMy+6x52-A##GEP<uQb0R1$Oe-&tR9
zXxReSAr70kkO<XF7hNe>;Uq+|4GQm5QN8?|wIbhj9@ohJf0`n+NLk7N@I7SE=RDjU
z0z#d9Y^3)teETx#a(~Bj_x`$sfx}k2pnPli=8O)Sm{dM4-lLI>d+E;gVlmf12JE)P
z_NCM#;yR$oFX%s$CP#+oqF>&#jK_-g@3WqtZBkwwO=h`8xAOD}(sXJan4_K|I*^8>
z3Ld4VF6pA{J8LITaowmV+n}o8GpGO~74lUtDcW;8VZ6ak1?waaTpi=yz$ivV@nCl4
zI>v?3D5xM}MsP*}gOeCo=Hp}jtx!~GTRXoMhm8f}+#(X@BnnuQoqL&_)5Ts#@5rBj
zHw|<MR;CMJIms(JN<<po6MA$IJ|rXM;Ht^cqt0LJc#$^BQ|Gl!@2v6TJvaU|B<1Z*
z|1!#B)$8BYN2DTdP=p&yp#`q-F1o|HCezi$j*Xx8K-+K0bR?+(rbBSuL14sDdzI`q
zRYZu~ptej^t0>(hUwE@yZu){8-pgj{&jWI@ey_y@_4bG~Jm$+5dV>?v7}E&q<ZN=^
zD1X_r^5tjzZj0GKH>PwD)jr0V&mWq5%d+BenIh(rjf#N4n6Y5^E*ipA3-d$5{@l)N
znU9G<1X~R#MBz=CjkJ`?`j39;t55!UAJD}Cmja=x0sG>&x62bOD$Ly|&qbH;@USfa
zDZ^5ku-G$pkHO!;=<5sAgW)xE&myM<fP>m01d?%PDTTECYM|bL4ap+93m7IzOYYf%
zx{E{kHk<A-J1(~oYcA!h`i=!9Kit_X3vHZAJ$!sXRZ{Sk@PH1O>s~dXd4^<12C+Y;
z+Pm!ZEh7g;*U3)jocC)64&^DC(YS^|!3CuUp8d4&yv441o+;}49owej7UzotTfGi*
z>Gvi^*kZS_`#8D{ZPwd=PiVXJWs!_8?T`nL)QMI@@`Q=kT1<4ecXRNU?(_58>;JeY
zVU%KQIhpFJ_3@Hx$DeW&ucIdEAKm*AoNa4-`?c9Ubee^9)l`4DmC&X3l<urOBC}4q
zr;r>rtz@s^JHZ+C4;foy-In3QmklPR{brSEcZxS?C|8mBkHgX3VF{tR0)R0s0y8Nq
z7;YWB;k?LH%tps8@U164)GoR~t1x|lAZozEDo}vV70^l{V;v>8e(g!w7~Ow-nx;Tc
zm7ZiXk$%cCU!&z1bz_Op3b|<q->4{WjzmE#F;TrB)1O=-cu-fu{oG@+@HJ`_L0a2m
zkH>l#cP9ly!VV#pnu3zBgrZ^|qVwwf1Jh@pT*M{6hNF7Tj@q4*&ODvsu&Vz@l8c8t
z6+My%7bi9?RqHZqvDFCWkO`<;sp49WgH4fq|4ov9*>0I5DfafZye2pUJ(&tj1C5ZJ
zN5lee$Q=8Y3(+#rVm^5W08w--Uoc9-)U#c&tb+}f$N;lkHfL-~Uas|;9>pjhHL;8S
z25U3K$?{$4iGt3b!Hc}blw@_;%MiX`pCWK~R^~PGk}<;m5nhRIxXg4N6Rzs7TSC#G
z3l!`UC_>4X68S?rBBSz1Yeh+4<vsn(qbr-{yU#lYLWuczJGHMDCCvq2UlPyC?c{Ql
z$1=up?H7GFLEh0rkg!<_LkDCP6rxV72Q=5Z>bj(uFl-r$vU%H5^}<blqk<h2Ph2&b
zYrR?g)~IRFcMB$;1Sa37yEPlWOr3o8Z<Qsmsu*R3ne5v`ScX>EZLe8e50iyjU)JSr
z6tI?^)mQcoV2iW$K%<NV3jK6ueo!8R*z6EHbJ2J&J^k5<n50pXEat<0tiZJ0+^oM=
z_9{Ae`)G;wR*_EUQJJ`wv6Qw*T%EuA*`DhrMwQ$rJ`fzZBZmuk09UZHekz>XTU#>j
zY<PluU8yiPg=q^buG}(nrP8bLe*jCA_nP6UaSz@&f;`240Jw};R_<<IWP3Fc2VTn;
za<RGHd-%1WJcAsp@aDhCGQvRBFh(|Hs5I2SbBcuJw(jqSOm?el1n2_Of7a4b$eX1=
zMsM|h`{;yk-N$fLj_ebd$qkZV)#p9^A?sIs4~dpQsT7&)3LvO?0nBU7gfnbG!6e;n
ze*C0uDDVB%JJ@CqSu}jRO$k055bQ&|1`8>EIc#T&we@zT5p(z6U5Htrb4MUnwANg|
zJWj##@Wz6-EisXSPRGj(Nqd)6cp#6Em8-*Ri6?f{oUO;BVOZn~%=LMC?6xY=6i*Kr
za4z>`E~AY>pm9^~wrZIH^vQRT;?8+WBYxj4DuYTj3Qm7ecgAr$vhp$=<u*WB*%^f~
z_xPgZo;uVYcpAo`1k_?K14NZ}5stHSCWYqetY(O!1-c10*{9UuEG+8i9AWGVJBkD=
zqM8GAF6UM>5{qwl(k)o8z9A@b_dAJa<7RP??mE<B38KM-C)B%Vi_3ZE4QAP|x6VNW
z_-R&x`8w0QyzAv#SP5Z)&^KS3vAeknp#KRW$<=;~H~V_v!4RK+-pkRia+h6jVHIPG
z8<@R)DNAzskXro&{}TmJ=2)KxXDakPm7P}oWt}xEfAIE?8gI2@ChGV^O1cT_02f6Y
zVT0ZOYnlcn<C3bK1{2z84pA>@{FAyPE`#7Dbp8ME$aR=Y{*Da;uuhnA0+LIumr_V*
z&OJ5{G}cR~YQEVQ&b65|(T0QDfwr|-D{2|`FH0O$b2j=gyX=l-z_ZpUddgb+rC@YX
zLkJ}7iB5jpyEiw6A*KU1cwvzy3jvQif~-Sf^<|K5m5GhCO~q^As=xyO(a;c1HL8q#
zy3Xp-HsP#_j0X7(>pDWqi5sp@*fhOu;*f@IYWl<rV0DCfb$j7yIuNcNoc-<&#J7p&
zJ)&I6n|4&k`S~!1N%<4tg_*@666O)O#H_j8T)pU#bkUa>yNWl6w@zqbT8LYOX9sni
zT4Y+yd4GJ&{T7g`;ELfB3Ca^}mTZoT^rUY+Lk!-_lKLczM2SBtKm(=lGe3V)s!6%2
zrpl{RG=6C^&%={Byd2Po;TxM@GU!>AS@i*fNF#prYW-f)xR#VvCWDq!>XgUny2~EF
z#dm5TRm-GFwUHaWqf}8;9J2T!-<asCz*V;&f#k$}A?K#mU~m?~b9jz7fN)J0h9b6=
z6|A>s=)^M&W~}^-RZjcWhcP^kEmCNZhy<n6|3fEr9&%3-TX6x$(k9DVQ!*T#@8+hB
z4&|l!ba&nNRa`B~zUT&@bsWTgEIPrYk`pptZTKud^zaz3%OH2KfY-{FC&k*;Xj|Y7
zY)NFck&)TPVw>UmBFgm$rZ`$W6JKa=k0s|Ek<-i6EF`VO+mk%O)vCvYQ89s+3d$!H
zw$o)5ERlt)^8$7NTI#TUg$4-X#Pj>oTZ$<K{FHMe8MikQp|#r_r$b!FPCwyLWK|2`
z6)oKPx6V&K(PKOKaPp*lHBXfXXjStFf2;E-njbSJj@jaQb<9-MyULawv|9+jO2Q0-
zkA2Y3w|<7)S4`kFHSn<fnD$-pSO<V>y6bNU&=SXM2VX85Zm5$PYDhQ@yR=Ha2IuJC
zytJ|+J0$fL82G9MW5XOw>?mEMztHsQ8R_<<Mzvj?3G%#oh6;WzDk|&iDy*p{10yey
z@g0->NdHfReEK*TV!=hC3^Uo_c-;yCHmoSv8DVP`T^<_?{RD(5#R@If6a~QhQxz9d
zNE<s-v>qd5Xpll<aEmI~YKJvrO`D7iUjIY2*SLhZGPEt?=}AnU%f8_|n=VFQUIhPk
zXC(5?o4uEQk2G*AzZ$kUWUM2jFwp@pDOuk0Mf^*ED4ek<r9@h{xqj%+5_^dH$S142
zVP8HYf?WjHzx&e!0}HLWWr>1NU2RR+mXgf_Fzmw;@%y{?XuQswaEGBMQ2K>RU~;dR
zQ3H(|-lx>7Z%*Yy)(x#NO(=8#j!;SK$ZSw>Y!>r_)z-r~OO(;l8!fl-)EU%pEd7+N
zo0TNC^wYV^`h^vbl4wdGbKPHyl1A;7Gh#G<!m@EPjjmUiEDbhbhA0-PvFUC4im$)u
z&`>mbPy!?+sX_W~*S!zBAc5f&q8z1?McLc4r@W8P=vB(q;k({aG8<|%Lm;yVbkZ%1
z3+X#z{<`kIB?@?9ZtGTC&Le_xTT=(HO=f!daE3iDI~xqAiznPQZ}`O0xJLdTY?{ck
z`bfmqBg|=3u6o1HZ&UOOalhFvGkKG3xm*Jo{uFm5{LRhoml<%1HE1L&^ujhu7X{rF
zRwZAM*e!RB!0TiP&zp;d-y}P~IC|b<L~f_GRnDl`ccBSC1a2EGyVb1v{%s>M4I#zY
zn&O@jvD$VI0AC+rnW-h|9)@fsq+TbIW1?BvxpEBM<;>u#Q}gbu&V?q>r<HT6&378`
zMe=)6vXUx_1$lrYe8R5t1Eh1$Uoy*Zaq#&{XJkG_xtnWRLwFu#OKsszk0T;G+Vo7j
zHd|oeo{NxhHrvsWdscaxC!t5sD+Z;@fDHGx`p{xLTWbHR?!0Zz_Ds<WHT(_n?T1Mn
zLPBgpFHF6b0&K?JbjiGbPRygRTF-PjsvJ(T`h>vi@pvLl4s+(;U0^3gC@4ZTg6cV^
zr)w()-fo&|n+Q|fTay0pw68fHCc`i_j4MMZmPw1w^8kVMO+ACV9h(9JN$lG|YF_`!
zxrr45qZbqs(G^1E8<FEV^x-)(ynEN5*X4vU0L7k}Z*?~#8kaFJ3r4o40?q@Duh#-J
z@xLQEW9=E`?o5JJFWaqG@S*_AuP6)xbGnWxju5Zl@kp`%Kv9kghy5Z9moMTJDiSi(
zd<%(iswLpoEnh`To<G$A@v%44PlP@#xfCdBJ<Xe@vFxOZwZiv)!`<En2BIdWH;XLv
z!nm%OD=WDH+m(_lILRD}wXd`5l+<awTmCfRIjdhgzy>gOhSo<-<=E0o{kv@P>%DKh
zhTyogO)o;2=llpZfd_690KGm+KRr)7LRPaw>ddwnP^S0BfZttJ3!p#%NiDv>if4zR
zHPN6!!t7>8rO^4BQg_w&Z3NVJ02|^!F2n8D*6qUA-Vgd<bPp5BuZ~%Qf1Oz7MAHQM
z6i8p7*Dhuvwcs9@jBbbu8t-?-MrZj%<SH-}Y)(oaAibjzC%$y(RCPqP?ap#xdlp6o
z9yem0XR_G;biEFCKxT<mLL!Zlf1aX!j4@nJYm2o6Y2}fxcxc^NjS%8HDDkSrvc>UT
zEFfbgJ2fjJRsqRUAn8E4#lY4ou?aftWYu{s1hnTY+tKgXfWH1`m3%#bA-jR>wH9qJ
zs9Z)q@hG1F7zWH*&wUxJvl|F3Kq5R#c7yGwQ4RV+C$~(Mrx(;;)qJr^T#QSF7a{jf
z!)P}_06!f>G~|d+hE2`44jC$7qUhco6tbpi6V(k*H?3%~OfACbMmEz)Ww2+_h_c`<
zxCSs&F-L)r7{-uE6~Ht17M>Mub?`3l?bIhUzLv=;=m#p=Qa}!=3#P7f#kHKCMyqR9
zEcL=ue;5lQ)0pDrojv4&s`Uz0E%R}(2GLMtwe3dcE^Se89#DewU{}nCiF)@>J8W@C
zJ}*?~1`Nk|nQ5{96^A-9$1QDQ=5G01PQiF8N#J>~B#&{(ZV7>sn@Y@4L~n^`pJiS3
z0?%<qle;L3neTuJm1oS=8VFOCOaA53cwJL1(Y^(hyfK3WNjMk51B6c(l3OGnr>=?o
zZg6r&R79o&Sq|GzKz5I??u=cb)U&QsL~iO|gGZ6eU@)c*mgH>L<$UU^gEIH5-0rTV
z$1wHz{g9f(Z`@*BH104J{sIU~<5^UUZCkn?Bs7|AxLX6;0`EC`aQ0Qq(WBhmd>(rH
z#+jHYT#UAg-J(u2lqU50OAHARO!CWcd%{RogwT&S9xMz&`hbo{7xTBH)oNv<w|#RW
z9{3i7Ywmk!@+iI!w*)Rle1LrClk5K#rJLlfPG&yh2xFA!E3xk|w2Rdwt}82Un%hE1
zUzOio7u_oHS^j@@Zn#L+eu{{oh2@MVN3++m;Z>~?-{r?)1|+cGizG=7N3BqOq{y#O
z0D?Xhwk6W^s}o46mtaicVuXrD|FROxK^P(j<(2dhR$1-v`~6%y@#Ti~gp*bbG&Q$v
zze$oe6whE;8h!Udd}nryg}5NO1v@u}wkCZs`R`3IWK@@Neg1xisz_^O-#pO9uf~mh
zQyNxXSv?p7IV7|b0lKoEb*4~7yTCI6M%qVRg_4=8fG-$h6CSjwuU^AWkLNb!P{PQ#
zM}S7(z=AuMDeG}21XiswqZPCD+*KAW8Y!|=$yWsUTk^?G?ZZK83DL#u#-@3MQoR)m
z=pbXTjK^k$!}QO3^+-mT(hJZfLPbotPkxY*Jy1Pjx$y_BLR$$w7e?w(0Am#E{4T5;
z(pZkqVd)CDD2O+Ju`lkt1_||4qc|PKogs@kin{v_Lido7$F9eR#$mu>^W%A&=qc`Z
zH^Fw_p8Mo!Az@QVp_mIJ{OP?r;?_ULK~m{|hJvZy0`iRir=^9^PG+fG;Xk+0-tw-m
zw`r>v`1YShUQ@AaL{7{vDm8ONR>*{}gc=(Afy|4xn9Ykj=zo0mT8V3OEuRmm7|%x}
zcZ%Mi`Zg#%Tsoz-ljtW~Uf|4jUyl|pGD6etTU|^l;;_0y-P@g{TyguYK}RPoqA7S*
zeZi)?!GeVNA1TcwP%e@?uo_Sb&yxaCwg)6poTiA<Y^DVF8(lDDknSYg&uFB@AJ4di
z=Q47L9ZXR(r@!@NgN{tZGkB*fDn@Vq!EZW8YC}JHG_4QXV0ff3OO~hc-z4oOkye$M
z9jJ~LZ~dB1)(-^5cPpTKM7`arq;|ZA$gP2@{xjFCkU*wExl!@*J}<d1uN0cA;M-?h
z59DroWRV%Cuj25vY|B7A;%(=v*M9fXai#w-kMVzrUf<o5tFHe>lcV0C_YvX9s6klf
z^1jJc90UmDG>XY~cAKvOw_ZjXrbWT?gf!5Az<91h0HkflY{FjywhqXYxx)(-)@<^w
zUwsetlP@%$Q{m}!z1?(m$N+S-8>uM@3-nnK9C`@Oc^1i+-9SzWia*dPp*gd#$yF2g
zbc;b(xu@UsMD&j_@z3&n_PW*_Ol#CL2blpHAN1h8@GwOYE4rcy16L-k=R2oQddf}K
zXaKoq+4gO=+%2i2mx@gsF=b%7i$Mt=RxO0nv~M-O@?kW6<EK`qpyh?UJ43Lski;_6
zYkJ~05LP3G_Mu>Wv{>3)mzTZYM3CkNPvN~+_!^o{u-wad>qABg<ydW&yO^3E6Q!BH
zl(b(~BtkD8M%SfT*glN9WcX>tUPrV%vo-@v{*g!{--?|be0G62dp`koje8FFueMkz
z7S;($Lszus;ucw5X@4x=_wnCi>Aj@1tycXz_1q6z_3Jl@WW@~VTI$A@xfd^|VyN<<
zyVD9iOY^L4ZGJgox^_)b*t{Htm=QWUnM1O`xjEe6?$$v|&5$gLiRQS~3+_<!Oe4a9
zTh_F6gIHCD_y;XVWc%O=FjB(FCPYva<&xhL6E!CU0W#gok%%IB%>KvWeMtY+<Q?0i
zi^;z=VPHNA?TL-jZBk%S8^O)R=cKw=ZfU6d5y^LRjy2YxMlYK;b*ia>h58H0{xL!e
zjvFuJJUHp*sqN?cggljBM7kTfEYtam$}#8?UlJ_WQgbR44j9n-;4ki&W<3nW19EbH
z2N8}Yfyf;$m6_khPe%`w-PC!rpKp=_Y~liU;A8>ipji}scA$6NDN*uRV^7dO-DT{M
z@dlYUWT9k$`x_8$d7rGS6F#T_9qqLUtGo^DfI183=^_TvAla!oqC!JiPjr{R;wpKJ
zL-TFSN_seIhKxRlm*kk|GW5~ZlPY`vsjyJ6mhs)_NpH%YkjN~3Xo-h0frp3`vaU9o
zDVHE7uw42?AyMd$I24UKuvce5B#z3vIq@83vyA6WA`84C&j#=WVQu3rS$1I)T`KT=
z!Qcn={{>Jt6$9s3QyrnuVHLgg$`VkfiYd+l7=8Ei!)kpbQ|;R6q=<V<*8d73=C%>*
zdFY=(v3=I)Od*$e*7fmk!;5=FdcvUhjsh9&8L=Xs+)gH=Zg)Dcg1k_;5r8FR0*Iz@
zQIGiW^PrXm8_owCtEiL$FH^L3fGt~YJuP!x-zpq}p?9QZNVwn_g!47pA-b9J=bYhI
zM!Tr3aD!}seR)c~p*eke1>2N73}bS=0S$%T2-3XTDzO)2$$a6ib~!|gSYl>%nd0*e
zmM7g4p8W=M{wJJqCIkIISZf^mewg$?#~ThjlTIuudNv|i2^XnJA!Nivx{ZIJc8}_7
zA7}&Rx`SW9o>v+e1cNen7iE{2+#8nT8cXbSVNu_Zdo%N&&`6<f;|45bV<N@6KDm&+
z9Q?=ho%)j-1mVfJUYO(0JC?i2lPIG)e4=Ck^Q(W$*r>_!d+2{PN?2vx7qNbIxw(t<
z&y}Owq+R@EMR#hleC;_(T<Pv@EShs6*{$Gy)GxdfZ1CE_YO0BV`!GJ)NOM|oF1+Dt
ziEO$3gXuNmwzu5G9hse=uBW8sG!l`U@psnmiw!HIYR~G5K34sMk38|W5r%-;O)f9h
z)acE+F54xd68w`2C=jLaq5$=F7Fccq9QUsJ$vmPaOjMp?dEqdpzfkRlQ^Flkw|#OB
z>n<PbOcMzN|K_GAl*sob-e60NyE@myDAcr}W;N0YRZZu^0l8%}I%sbcNg+@dZ?&#K
za2#yvYHd6>2QGd=y5B@BqgBiiSX18!9xvFYCizAnb?y0&;2qJU7YRpW9|q}wOhJ+T
zPwc~Zb3U=o%rVgp)8ZQ1JYW2?RrPo-7K*`1Jg<FK*@tjeRB*r_=w>J+Ph@m+<8Ri6
zFFgHU4@{Kdc|_PCD!K~Jd4ooTE$tYQiE9hn25F&cq$nIUr4Ji4z55b7rflp%4VS*^
zSJFo9*}V-}IRxiv&07+d^e;w+P4n%fPuIktt?3E0pR`*a@QA7=USqpGhHU6ainigF
zd)f6a69L9wARTN!l|=MmkHN=aHdmiFi&}_@FK+unXBU5p&)JZdO?ourMO@xm6h^~j
zr-1H=PMx(I#)3C$2FA-iyaG`dW;Lw5eDUwIh4dvU<DwTlz9E+HL=0K;h-1%^TZP_V
z_LGNggz<TZd#!$tp{#W`|CM`I2YIEos6jwcWgU!@4?4Z%K#%~uBSxuHU%=EltrW;a
zB)?)^o>X{KRo*n)6mn&akXxPb#HiL#5AcD}ksZ*H{tyZGXF?sbDX?hHFEHFV4oC^9
z*5()X-(aSeVC$3--q8D?NtNpD);<^6J>ws0v1fdml85KNYCHDBIHbZkC+cn@Sa@cu
z2>AlRskI(Uc}hM!JG4@Ms`0k6T$If;DLg6Gn8{(yqF2Ly0L{RH#b+?}RZ?x|hp^m@
zfUgqgw{d~EYMbu~RiBfl=fxrKYlqCJ4@!Q~R0&MsCUlABPxMb?Olcqi`jM=$-I4bf
zr4<y=h-YhBOGKU51@-~euIK;ILWa66U%mDNJ2CN5^VpZU6U6VK0elV_qVH|aWO~=&
zT;%uCP7&!zZsCveC0}5;pu?&^jB2~{oBCR^U(#+vBfO)I=sCr0{%9R4K)=|=BAd<A
z_5h~ne8nWdV9e%LF#|>8KPjJ>Ug`s)jJlbDBHNdycR1txPOpG5Z;iEHZS(cO9AAoF
zXy5ZpXrW-9V^{xZDy~N$Gj;6yyr%i8qqBwIc*TJiN*-UkAE|7Ct(kLRj<{TYm!L^o
zWyC{$Dt=7_+P`CycZ2LH3~J7vNH-CkU;cvv7s6*<;YRz6q9TKJJ#=8jtK$LxxI-e4
zb@J3G5y(x*<B`#Pc`S1px4w;QE}2f|TmK#!6#l-7O3p1(2pFw$Ltb4t>CIU()FV&(
zXY3D~)<Vy+KN&0uwRf-H#J`t<PN|;CCpwUOLWMtP`ixs(zS^Ty+BnWNr|m11ckp9k
zRln*}Zbn&FBjjr9NN!m54Yx$7+rg~6(UzCDaje$~lwO*o|4}^~N<x`LzP<rbzHeN}
za$OsIqgKWN(^t^gade|z?ibFJb;`IC0!>0CMYUUMy-dVJI)Qv#KZ!I}su9rxXqsWx
zqv?t4ak78wV)K3rixA#4=8#mJH&#d%{AX4opQUS+?O&0sH^%>|hVzZqq;Nb){R!zO
z2Z2M>-LMPHFk^Hd8H)9k(XP8yn!46C#rEfkooto?@GXd1I@4W?l1wKX-Uq-`fzzje
zF_IOQs4Yd}#Br9P{Mu@qB-aG$aUO~egh6lzXAIE#2}FejYGgT8mdbitQ*eKwK^Vv5
zYtGJGZ&M)kXAo%5W~Ff1rM$8l0|KzMQto9E`ur{gDkfx0p$f5;W=UzN8ozOOY*%nt
zjD0@auK{O$)N!_|UvC%Sp;BiDr0Zs`oN<(~lQ|B_4zi0yHk(f%o>OnTEFAeU3u5m7
zGq#^QIrV|v2$(LZ%b(J|$XOnM_pk`}JUjJ@9!m}GZ@CVVU8H4mBsnB83}f+FL3ydN
z#;9+h|BQ}DV7)YfNnyT_!mXy6popd=u}Gp!joDd~j9{X-T&(l~H?+-Cas!SqKLApQ
z*-Ny;`gc7!)_q?5fKV1(p`f_dEfr<M3LP&-du6n0I(Vv$H<+s3l1KebBkdUx^XV?B
z4Nri!=Y!K5!!gKr^X7?xp?!?i<vhAnnu7@m75F)0-LwSjMs@&AU*oQ6#j$K-mfL)(
zZLDc9>Q~<{YY`Ly9Xnpbdwiisv;()Zu?gj=K=)o@^d~OE{&~FiT<MS}(!>6@WM7`C
z-P~nYDw1jAN?3nX6!KDh2YB)61>#SYu4aBsTC*}pA(jh@4Fl_w_;Dylcn)WfMd>&5
z<<CSE*&h*gjnRpggDWW+N&=7cvpPk(6KodqKQxi~mGIiW)-tyZ7zMh3=&E(WE+P$4
z=!5*QSfUMI%YjHUaT{_U8Vp8}?rd4yZ6F3Xi3KEZWyR>xk$`1Iy!_^r9do%w_vGQb
zdM<UZ4GgQvzi3+Lb;s|Z6|)G~dGob>?PTJ&`eRbDq;r_7D$aEFEL>V^Hz#ea`wq-9
z%(^&!nOm>oz;`tLlygNEtd#;%fy5=Ht_7({&F|2j%;5h<?XO-n+qbNjLJGotCm!i6
zw$d0gesM!m-oSyA1GaJB!KA2B*f{<k*`PEnm*ekL7c8OMHHA|4FHQn)PZQR*=L{${
z^1v$Rb&1?un<<DkcP*e_oPVPOUcNXelX}jn?;GX&(HFOFHH04VH*vGR<<B^g9W#(8
zD|x;Q7c8!R$h{6UKJ%zQQZVOIlS@0MQmtSS?QeuphIy9&z$a0V4~x(6Y8;N0-0Jk3
zL41Ry$5tH$b(3XabrPIj$ruV>pqle$e3!}%w+l7RN=L_`c)~6zD)P_P+80X{XYaye
z@<9*V>m=wqh@SHP6);e9U@`Ge{1C!PrlcWfU=jBapp{fwkK{J<y27N!t08q>2npGI
zCMZY&f_$`syC^(<Bp)W~p6Er)^jL!Zvkbnz*o~ygn^;dt*}&EwFsWV%T<h15K<V9y
zh>YD~cTCzsB3*taS+OO?ZwF0;?=Cs~WdR9Q>jjI$s|U4+bYl16MzQ#fl<@V{>A<nP
zet1Gixkz%0O8&#VoJkR;t5*$j`F_DUr)SMjs0#Cm7sD9^(9#g=P&Kajm<)kVqS}%Y
zEm9IUTbaAUiKj5|LWe<)#20J{a`0C2W?(-hR9l`m`{_-WwYX0J`eYZGwZ(`S?idYT
z+CqvTXT^nbd`hzba8zVtF%Pa>*e;Uo_4!?UJkwYR(L8yMXrz92xDY#H>V&wn_GVU)
zD4l665GQ6)9H$OkknIGp-S&u^^PJfl#uomN3fjn#dbSlGg_wVk<_zJ&*%Fr$YM9iM
zxH%LZbF=W=Jy_9~b6i{AC)9$v*MpU)pwv_smLdXr6oTU))p{5&-LniC+Vx~Zz%DHQ
z!jPLQiyGKiC+gO=K`qKPi}gyTi6vG9rrUP=cN7$mHadat;3<grWve0i*&!2B>N(Zw
zw1dCXgGAMoC9^P9fdb3_uz*a^UC%pK%}|2U<_XMf(dxmWDc(>QhjZiMv0mtbEM?>5
zqG4vPhWL&g22`}~cnucWIzd>@Np!#Z8odL|o2yCNlJR_EgF$qEAnV|BTWepV;WKd4
z9$7u;QxR+{{Hyp2ST(kLqG7EkdxUA0nSBtDt65{OrWAc$Qbk$e<V#CB4XxONc_}@Z
zL($SBw63J6MBEIpjMq*6tk<sZ!j_=Wv_HmKaO6=%BMB#IRag3yc3N}J>0{7j=Ln#k
zs9|U12RPbbP%?j1_+xkkE8EI2^>C)o>0C$X#v(f!#s&a(xc&)8!|lKqt{C=`DCdP1
zADIdf$26^!<^6VMa~fc)Zu-aG>z!Fd2p&dXS5d3z3g_pAl8?^tUPmK`#VHS<Uwzn~
zD0ZtW%+DT2v+R(Z6?_4GM<5?D9|gxGImJY_UDSk7*NpM5=!3r`>^=2~@3WjwGLV*j
zeaQv)>qXi8%Y!y`N#wNMEWw1l_?}*2`vS>-BQ40`7|G)swXOEaV7+7C+ODIvXF{Nh
z-H#kO_4ki^8L4`_!Zw5R)C`3_4Xy3bq{-xGo&n4lCT_#Qvu01owNvTL_jF=BDIwo{
z8kTryY)8sJML?Cr{&ZH_wxbH{6OcC&r}Rb7eR+rR)8xsez>0U{rJTkOeuVa=?Vd|G
zrBl;lJ~|p*(9QP%HYX_9Rn*W91nGgEOcz7<Emmg!pWjqZ@yssUUX;{C<H#1JkvCZ+
zgZd6MO|;eP2j)nuJjQ6FLtel(Yl&d=uAMFta|O{61{UnE%A_?+@<^gN-jn654`b7l
zgL`%Va3ObiUz8yoV)6mY{ParnIH^uM(1;DZ5pMb~$oYqFr%0|c`~Fd`-^-q#a8Eym
z7+4HVno$2FnoI1kYf*k~4vm!e7`OUjev9~cNW_!KDZ|hRk*xMb2SaOg7gHxY2XMee
z9Ax#BL+&BvVh1P<RfOph1^Fvy0$57st;bqE8gbbTR6m^CPWJ$0u1%n3As?foytb~y
zbVeQf)Dj_zHZRKp-)mdYo=g3!$GleSb*LVE%o{0Z;P?N|5?W?&UbqYvYL2Jjyusv{
zbV>mz08U4{){tucNW==&1^N~XZBA#miClp7U;(58Vx(-WRVGW34i`%(lO^T|>`z^o
zLuYdN^kGbAHUkN~`o2`RVW9Qvb3&5{4Bh|B4Cl*I+f*RtYriP!5nRxc+=!nIrkcph
ziJn_~4RM^-P`5lT*k-mcRg<q}h_K4j-3VQp1^{FXqSE#d04e^4cYcW4fu|K@D@l&q
zdVllmqMwW}-YlJb?qe<RZwfcV@Uh@BFj@&dw!0h}?79#>y)1uGFYb=QCVs*EvB@9=
z0WLBn7$&JBRC|J?+)?+s$20#PN)9aW>AIn(q)nz+WZM#t&Uw@us(|;XVyeS>!C3m8
zqm155gD1#KRJk4Iha0o!-C)aRsLJ;DFTI3w>MzC2g&F*yfJT@!()qby0hzpe;q)Mw
zYN5V2-|L^wr%2~KlJ>HMHSy<F4WZ7gAsTFoX-W)LQYE^GngA%gu$KTOUoPmNtQk+-
zj4UdEpkoGW4KjKXbR2ai;1QD$r|gyKN`5FXI*_I;BMVxt_k=e*ZCYOw7nGl+s0^NE
zS6{XBUW<Grn?h>#kY+t8YsY?gG0>WL83|*#VWWI9ka<A`tWg#CI37a2=@X26T7(7O
zzZ@qsL+I$;#ryj?5dcjm<f=Licq%r6)9QTdh&<QNHn!I#h^D^MxNg3&x=9-*=iCZ^
zl3y)%$RD;Tl|CW<42Ak$dpXqMf$BW2V;D!R!kR=YNV^v10|{!`Gb%yQ>H&?}+IUB+
z2BeaeZ_GG%fM{Nghv((eiN|8)d>_3FRl`L5NMv?*MxmE3y1q$gju>9@zV9x&g!8-l
zmv1LeH)F7@({|wRbE6^g4s#P<19nWP*z3rjEq1Vtyo`y`0P>03t2XFL>_1M6UQ!gI
zRV8gH%m%NCet{=<I509ZZ7SqoYt{O&#NBMm^j&=naE=Q)CHS*jDkhk;hBiH6|EEP(
zQ&%6Am2Ouv3zC!p8hn}cIN<axiFnFVRX;8zFDebM&anoNsY3urLVd1e_pmxGcHwFf
zgAfE=B}cIJto}2D@3H8^=jCK7DR^TUELGwvg9B&^A6kq!Tq{$*p?xX|#qLsF0){W?
zC}!L`#F`0R*klARzXdPTcYG?E`~TVQ%!5Jmtb9r{YMXuss;cCI2`nO^S{VvDdtDGX
zANHX`P^hY%YXmse+LD#s`X|h{9qv<IKkxs__ZdTakp2})LJ;)QtRx&pr&<Yy8s9vb
z5s@$wO*CGLmGS7uLAuGZ_iywY>dAL=1@@eVfik)@%$0OI`&nJub!9v~6IgN?sPbB4
z#q*TaWF$Z_7Q;ZdLS*Q%OK63ku*?v3z(+P&Y`HG(_|+kIJDQ^H?y6DOGA~A5U)uvB
zU(>-SAKl)25j1H}?qWDJUS01u-u)WdV_GejnX5M{BRf=B?Jxn`ug%4Exd+P_n;q4w
z<_@o^wRf~-LO)`-zKb;n#>|)XIY+bh3&Z;hKu*CqGE<bs`u1W^iueq^x98#IZfDSU
z1+r{O(9_UG1!ZYZg@7r}->L9VjyCcfhI8T8R};2}%QAX9GVvZXj|p@qQI9MT1D-hn
z{=cF2`xu2KfY%op4dXt7xq^7JmbbBNHkH!F+A`GKUU)6G>|Y4LC5b&YUG|SUtddRy
zSw4a)@Z{04MYJabq6rpi$q`UR=JZ?ELpYrVnuYJ%#huZ_Eh<JFSwPaUGxdkvf*`s`
zcGD&AVh^njDU(wpP+96Q0f^y!A-zz(=K=-#K-L}p1TdoTnLuAWP-dPntjm>Db+J?g
zQ0JTSI%Bc4P8><zHt*^eE~Y?OGf=KzkB|Bcj#2%Iz94N>(FUE^Iq-1^I_c-r*Ti9%
zyopPr-Gk_lfD<G?^Ae*952F&*HEo83F!#De_Q7c@pbbP_^&$uf=t|50wWp15>9wa7
z%cf>=+eo~44))#V8Sbb7%iZI|Myv-d<dRmu<hvhi`{NnI?On_y+Qi}ht$~>0B<hw?
zqd9i;uqQxSw;4EaAenY(C*5UQ<q`r$I>;FOn~&nfgK||aFiH<{{HRsuTgZPbsSDT{
zEKLeANyV$)e((9RN=O5oHkAs#d|8Q0)#>+aUt8Jx<<1xT8hfopKv*^h&)o6vloZ<8
z4cR)So#F9P12;_aOHP#i#LVE4^4`pId1{2PG+~p2un9VAF<BH7X+M(rMmDURV1G!k
zu>ho4MHd2yVe@Ra3@lhB)Y@|!>|jTQIdKvGf}TVe5vpOg;8e<O@=d1CKQNr&v6?&O
z(qQ}PQP`?nmp36M@L~9KKlrki_`Mo~8~+Y#4NWKPusxNEiTd=%>dfWElz(FWzRl4@
zsw>V}#OpTh(cozCHuYiV_;=`Wq8qH?m{hs=LALiqHzc(JW5o99<9DE7-#6BMjvMmj
z=Y`+mR6(~3zP9{sT<h&$<<4v^%l#TwJzjICX)p22jOf>0{{5giAFi;ghXU2xvi(DJ
znDi4?)iwL^pn<zNG<X-_!KGdMxd=33o2IkxrS8DAyzDzVHXswcm7>=$aRS5__gK{v
ze%CZwZJ@Aug{rAYrtJvAXExnR8JDcyoT<>B<yNJJ?G~b)^h?UMS7gxmY03BRd-Z&g
zO4&IeL3z9e+&+a2nf>R<{sb<8=P3M`vzarTW_zI}7raIg{J${4_{z`dbfjOY^T3ME
zp}&~69HGF=Q<BgUxKLT+p;PYYtW8nK4g3A10|qwoH-%F(Qe2vYD6I9Y*TwGLuj^ru
z)D+)Rg5Rp7rG~xjD_)LG%`$s!N6?^DXyqg|n?%7?kMk$6ndTKO94raw(k9@iTgr^_
zKedua;fK2Nt3xBios=uh<+`h;r=5uM9;?z@s3_HYxdl<Q%(2R6zOV3%=#&}7G^UTH
z<z0LKTJ`Nlvt2>t%F2JW{OHXHKHLj|-`dd7kv|&ZgTT_N&0x2^>Pen2y!i;1HF)l(
z(%!!4n1~280Jt~?hgJ<*>w*ffu|)QmAR|9!WVKoLwq9~=5V2Bb+XHkK3cUy^vd67s
zrb<>{9<~my^kRnk-!kI82;J)B+v@|AYV}lz7DlSx!Z5P?qZZpP=bNu3FEiGIllEQn
zr%E@ePJUk?ib(=EHfH7i<KN~nv*FHWT4V1#<qv*~&^@ZJ5$LZ(W?SjJS=u^|(X4u9
zjou?Y*Lgi$u#-&1G$y+C7FKh_cz2<L=ZkbJ>$^`_<JlA}EUFz92h1KJz(^$2Ez)L}
z3A}Ln@nrjU6{dfgV%zc3dx6u!Trx<l!_<8hfpB?8ZtnSdyfVI`CZcHk`r+uFR{A|`
z!|&9pv$p^i%Ur*}_#Q->H1W|pByfo4S#9#9ftQ)>zb~6vLgZeZoMn>ydqiA^?3>fc
z+4|J;OcgE0cwrkAYDN7Xx!H0E4>x^Xz$UA>TK1j-J)_hS6@K>=S&0JrXPu?NG<GzF
zv(Me73XXefY2HW*_L;gf$A$h#6DMciO+H+@&jvL(?iuo|F#t1dvFqQJJMcD)DhcH^
z9BUDw#t1@!ZpR1*pM0npWe%%*XAq_egHi55riHRQHXQRw?)j(@8BQ(xjTi0FDBDoD
zTf+%O!HXj?>ZmvU6APz+6Q9c}RU#$*m<K-Y9A-E56mab+?TYQbwnA}ANLzekM`oSa
zXikXmpoZrfm!;3tZtkv>{IuXvkcRT{ed5ung&d<^Zca<+vUA(x*GH3<?siDUvWz9j
zK*N|xenfc15ezK~Ou9f@Y$D1*by`}i4n%Gpq3{i024dR6VA&fl;O|Of1%ngwBN?r|
zrHj%qPd;~q4*pVm>(_emLl(`GbGYpkq<-wX{5r(#FT!_#>m(0pQ@B+I=_5HdAH<(^
z;-piNqvas=kH-I#hAHe`r=S~x76_wHl+g2m-G;HQS}O||(JiiDjx6(KL^)$&?;;tn
z&2`;63Nlu6gFR@nU6q$6`Jmxof}9;VnFoEi5G*0&D1^5Z8F?quez?~z`p3@A`^l{D
zRHux_-EN+D16OBH4#qx*Dg>|h&eu6TFcDv@>glh`MQH-UMN($xMPXbGk*_QLq|n$W
zZ{Vf<9Qf`G-&W)axQ-;Uc#VTgcP5>RF4oZP1sd3<Uztm|sH0UY6-!?BrEgjV#7eEP
z3}MT$Zhg^8QGa)tKE9^&XU5<{eKxsDu71!pd3)kp5*q;Y-$Y%MFb*xnJU}~<#NlOs
zl<*Da`pD6yA2T~Bbl6NDFU(*0&rKd(pk%(8<U>Nddvp@#RXHmbrrxORGfO6Lw~$e|
zMxBstmv=7(4$U&Wcly84H?3Br*#gpkFY5{RMr~p*DE_oqivHNskLEpf3Hdq^1T*rG
zm6ssAKL|yuaKCI~a&k-}ehHrGUEubMtdF%KdCPJI*F0Dy#!~FmgeNOet>%C_8oF}z
z;A)&jz4NzfXxn{wyjH)e^^e*>Ofb|OX)t^n%7?N*N_gRly(YCkfyp@WilWL#GoJmb
z+s|L{Ip@k^=rFr+`c8isZ2%6yh^($`cYO^Dqo}ubLTd}7b$7!hAU6XNcBlX%cV3)r
zK4++<?~25(6frqB|G!>jn32$Op{s4OWRGqayoBq{Z`Cq94+}`6Xq1MZ?9MLBo60Tw
zSVDPV_w|@`nEPP#lYJw==6gU{DI?*L%E}$X(<_lA^8PLYOcew7?{yXAa2a6LgJ|Bq
zOkAlM4OJT%N{j**6so53Ih2||9!Qi~1%22~Z-jOH3R;rOHhAmk6Hxvc?C{@JStmLY
zxKwU2F8(B*n|~5Gq>fV@6Hz@82q7G`*1Wa(q9w*^I_t0>w(4_JbXUP9ur1)7j{{#(
zk5(|}blHbLwdEY}dtHp__wSU+-+xGQVpRnbodWa!P%Jx@mESoqf}omrnR8ky;A>M3
zg4=mSGepHp@*P=e=XyoF7uRq)?udC_n$CmdV>yY}6Wt)HoZys@hoA9Xoo7W#vqK96
z$7wr4f+G4wS(qgzN>Uc`gNO8)g-FFUlVNdopB5*lBAd#&s_@FG{#3+o*0!|Xi{|qN
zhN@I2bzDSft0eau^!G>T=m|-j2OCu?>%=FuO4r6i-5L|G$3Z=#h0z((c1W+QO>wcm
z9+HT(eB=tXGM)x%%-^?9LZXmVFTr)bLBYuIK}^hQwZ`1xw6;}9e+7WSHZ#7+>x@{!
zz2=WjESSuzKPM%MdC4K}25V~N6;O>YHHvy%R0qd@NMh)x!YGF^5#^0U7saAKLkM&5
z^hiW)8pK!}1v8}i7AxS&C-YX;`NbRq5<IpMXHy=OV76|cA=#zS3z2_4&baRaPfZPv
z!j=lb0g^*BLKAh511=EFaZe?kYZPSRu2dtiZXFnr6eY;?N^Cls#QrjG^*pnqZD&Q`
zwLI{7s!N=X=Nmd&Kax})Vgx@(_~iDB$W8^v>y9GK7jYK25XtGuhX5oK%G^`gWkIR`
zOlfglX8j8mgnlBV07pQ$zwS6}meuZyG!MqBqymVe!24j8TTHw(gxby$AcnJJc71xn
zh<dBqQyO$7OkdwRgAz9#V_13$X4orLTA2YWL$&te8gpcs>WL#>#LqE!{Jf%{F;obk
zdy6+~fx`&4{}`hm?Jbax!1dF)ZrosJp%oZ|o=+y;{r<ztG?IsTID;zVz%MLw;8fzf
zo*<V=qA-}6_fNL=69U{GH!c0YAhMW|U(oZD2&Ov3wpl|+TDJ)gnH!|ZW<gL?m4v76
z4!<?WB%;91(|ToW$D~M;Wv0W2bA}+yPrR*t2e94|c!oRYbo^&e0)Z~5<eXU1feafn
zZ&BV8va6{YcZwUG(`jf2btUIGwkxI}TE*I_^{SU^*(rKZT(xNsZcBC~Dl}W8O{X~O
zijjcq-H}rQx>FoU=w-%xt8mHlsFhciRBNE+i8n_3nv^x2ixE`CQ)gP_s@qfzwxcBg
z{>v5j-uMk4DGtEXA^gFAwSpN#M&G$`1T-fd?JheBR_%IEWeG}T62Qv^a7Ulnop>!z
zy;X|?;R+p*C^xNhI%kB97PIta66+*!tL_T@UjZ%JKBYnM44WqjR|0A|Xo8+O$3dvf
zjMk^u4uKbTqnL;lZfup=btDB4TDY(!RuB6tXw}XscuFUiMP0!@+A;sLt}xQnpCxX0
zHaw0)+8S#3P9e0cT2CvKTTapR1*cJ?G||}9kbT+PDqT2reti^}2Zg3GjThq@lQ-WC
z8^5JF-}LuOV|DX;ThPT*%Lz%kdBOvuTg=e){?8T<-+A^)$uTGPpU63=zv2cH)R1<z
z&s>w!QsV3uUQ&?v&maFE=%Y-?b*NRK+uG+GNjVlzr*BH>dOFf3j-n(rC|d!M#IYC_
zbR0R8(2_SYic>tbf5cWuSQ$!Vl?UujnjqHW5!i3bnKosyt%+7rIxi9lwD&T4eq-aD
z`nz|bV#CF|3`q<v6|J{xhJjAhO1&))%QXqF(<WZ@KX(yEh9wsTh&%D`sWUx!M)Wfp
zuLu6Ok5ShLtW<{mk99fwYO)|Hs1g<)?9fJ6VE$bRofInZwo=x3DQ=a)f~S^9v^T<X
z4m@jEUU~&BG=p;@lf_`0sr4F`$4c_4r&M4*9kL-o5s4>c>#2o3hfUCPe>nc&6|iMs
z_x#Bdko&z`)S*Po7-}|S1CV_c!+=w9LWF*sU_Je;T4iH=4Sk{U$F>*{uaO0~CyOWK
z(Y|HO2B7!{%-=bYy?YIqOAp1>MTHiIuKaOnl5=axASG4gow+u?WDH%^)N07O#fFC$
z%1UrHOVq!>@i0+OfjR3&5`y7+vj%7sAX+;$do{vSQdxY9KCPIuXikW~cKet9*ZEz4
zTcMYoc&;{7dDuS%-p>zH4;`@NBOQdQ(MA#ebB`xUoFx>W1METRc7kS;({kE!_*^1P
z6_V$z%^ZF-v%At1ZQiDtgDPLQM<QYkCW=Ky*7kJ858h0)GzTyvva5OWM9a8u@VB=+
z=FEF?{V%@12NatP0@8iHi$Z%ZFDGj(q;KS5_wQt}&u4^McX|E{=x?$HW!x=Aj`kv2
zx{b#((Uo<C4h|s^<P!!q#|G&3=vpT@_dsVpM|vJf)+zsviFO=?6&2hj5v|0a!>+CF
z78kMA&)ax1C+ww=X!3scCWGUwp;Os%>JS>Pqs8*gR%iG5{8S2by8roL5)rFuJ>ZaP
zhW-UbXN;?Qme<|(%5QUy9O@cheJskuQ-hl_sAI!4XdQq6;e|`;Z3ahF>ma_G;|p8@
zNBD$JHJu(NO6DNGuBZ&?iThjA?FUscIma@N$fNT#uxsgfZNnY?T;pHyOR<?9v>VCg
zz~tkHvh~KW_!@5sD^55f6M9NP@TpiIg;*7CRzw-a(xPKZ0${H#xsB=GToa7NfA^60
zT-LPd15Gg?u=B{7lFz=WP<ri2vv+%4R+vC5SZ5PRDC67v3s<yll;n%6<@sB9R}*!x
z`D;<7w}9Ti=I{BajXdRlcGxL|#{2_x7jO!~-A9ikouQ8krD<AG2IegQO^x(oBvQ7)
zn~@c0e_~w)x%>zbGhN(kcOdjvnvEBK*)~YSyC>Y5xrRCJdM%Yp^|Ihj)^kY=u(5`f
zxbinQqO6eqcXBS*^WXGU2+yd3L9a93ZN(KgHB$F|+O5Gz;v}Af7=G@7%H3=Uo$KSZ
z7+1V`DxWH8(rK~d36&IE?iFTV@nO5Nw2^P4c;Eyvt(It~2!C)Q6{F^Ym9r4fSb<HF
z>FD0=TxD+|QvCm;al6Li|6gav>k2^G{*Ne-qMel3>!tILMIqd!9g8ncE)fH%jUO05
z95~X91`d&XoV5~gL3;XQ*jvJ{o?-jkgfBy9OF3G^q!%BxV^B=+OZic5@Ki~1D#^@|
z6je6L!XKg9I*J&vL6ZV6uiHND5-)v1z5%0b*qx!(o+(LB$_Dl*{3r}d#=YYZC?4{z
z+aY{-pimSI$nYnNhLaKn&Z*fSscsz57LI$bJLNp#N89KNB}e(j^Xz2P18<qw=+LGQ
z;$(nCY*$LosUM7sPfT%inkp4eKd;nqupDKQ0RGqtWsDQL3AoEw?w){ga`XngVOGH9
zGISxNCTd1kFl$K5p=d-tU5%4aIrfG{$kJ1SC-m;cig0o~U~gf4kfk&euIr$@Z`kk&
zh#&Tt19%U8urNtZv@?$uHVqk-<`(?8(EZ+7WNpRsm8)nEADXJvouZmWrlfF>@Cj-D
zHsAIqo1YUny?&-GJTKd@#IkSUP+yd>=YgiFw3653gcwj}kJncb7Te|rH6|6fw*BF3
zijnM%P`9iIHhyPH2TB{p!Lbm>%+E`WsO&65-RrT>k{jr{Kim#TaIcvC6Bvz<Ubu^$
zIxe-=jClvEPynCdyD#W=H+|;Az;84ES45*rgGSy9BD^QBP!|jFE1WNA);*{#F64ft
z`H9Zr-=XnyeaMmky7jh#RO<vGX31%`+iHO9f?5V9&+9n!@!sH)u!NX%t<NWk8>19`
z|K8O1_y3t<<ijy3)kN2GAT~xpBmRAcq8lZ>XE<UG&OT7;8qb$lq=f|$4Hi-{(<G&Z
z{33#Erb1!|fn387MR7}WRvVt5@wJcKz5G)D;_p4$-<w%!_kWzL4*1Jwxy<rxQoift
zwW<v<#w@T`eG|6xZC}K|ZC_cN6mKfqjS5!MYBgw{!Ax!BEsW;CK!pSvQuD}U(z))T
zbBNmawQ6r~eL{f%h^QwqIEsJYBK^2&>~k{7$hJk|H8YS$9>4MpzwZk}=AwI1w}ZL8
zAfW8Dxw>O{h`DZjOl>m%Y4T5^iSI?vht^*Auf6KM{NTM?Olm(~F*!j+7=^SM?$SI5
z%X`lMAaa(D%o=euE^FbjzNuQ3ym)C@{EsB~2W?*~va9=i#1clanD+KWify!@DO=$9
zJ-V-@LGJIx4(WP2l&y8^irKMKiM*?K9k3T8!A!1AfK&RMwr8WJ^@U66qZ?Q+uN1@b
z;8~O?P7@&}#9R6UJGE=f7mD-dp_)?+Za>PK4M#t2q>oNvTBmHXE&>chjsDMeEfC`;
zL%W;(n*zeMU%iJ@e5jzJ(w4YG#Q~MM1O?=&F>)ka7EDZX*^|*rMtxZ9-NKVQTB(Pi
zx&qz0{}+8>dFa*i4XuVmZIzM;A|>{~zd@t&b%L{j1@~wkm)V=EU||ceP;=f6bUW}l
zVx6BYb~kQ(@c_a1^cB@KvR~=4RBX^#1yYcJKKmjZ-^9~Me67*i72~J?!0+G>mywjj
zQcP^-otftfH%g?mm6+j;>romBl(t7Jzbp$<3JN8_K8pAZ*7#Q=`~yPg^LNEp>f`Mi
zSg7H@Mf7x=z>w|txnT|^F~ibjKRL%ylu!4=cu>BYe{bJ#6)vmdxgBb+hpG%nA~SDx
zHwfpevofF2zav?58bKLT#eTwM2|+Qxblb-UsGAWBD!2`(xMEVBhLF^H&x?CI&|IL;
z>Z|RcMEc5X^Q=;cvWY-hJUt*rwhsT|k9f(Ykj`N}JO?v@zijj`XC+EYRWQt)J{ZKQ
z(1Qz1ja`3XS=~3yy{It{=`D1#+(LZt-3D7$^5h)m#4NCa>Z!&f_0KCm0CE<Il>Ub#
zWLkV#RvbYtng$Q!wY+7y_Yw8-FtWK_`e=K`XV<JKK5tU=6_$ATc~eChQeE56wasCs
z8hd4>${L!qYksZ){a;=O9cXz>*oV)FD|mpi#;0$Ls4cYTO`tLP!0;svd`=N}=yOr;
z6-Ndq22TnMG!fE8-s3JfO)~s&G&g$MELbP&4k%)6olq!xYK|4k=1{dr(X=xhV^Ge?
z&U;{v0n2Oh{s%G$vVJg3Ulqfa>PN+6MKFHi$nk(cn7@afy0e+Q?_4{nihHIRXE*Ht
zmT*7;r7>d&2SkI{*z}BvF_<<g8|sgt#eimOI;fUAWVmb}XQJcDk?mo(!Ev~F?8f}_
zc_hU>^aJ?7%RuOiezb_Y);oEye4ge;@}U@DYs(b#(gkTKmzhbWtZU=7uA(-MSd2zf
zK>xaQ$LjsX(Bo#4l7^5$EH{Gs0~v9ec&qDnc}_>9-Z8PH>HgB+#kx`6r<bFT#F0(*
z&gHE`AaOe@dEikTP?n{8W`rG8yI9v@5HpVOHBHZZ^eh%X;;)rZIC=;U($OBLIRChz
z-66CF4J0Yp*QIH?8<0vikrxhpE+*AUFx8HW(fgY%p>A2vAldlM3|Of`J3^rwk0=17
zhz;gkmgmuaJ?lSjpj4?~wSqKxuM8MSA((z*Zz%Wm>DDQeNA-t{LW6jx@PE#i4!nHI
zygpIS&CzQA%`~P0-D~m5b4Tx&jN`bcjYik_Ig>3SW%8QKkrL}YD%S11)bFfcx7gew
zu&c>)Sor6xLKN7@?rht8r}=tB6?Rwcz@tD0Af-GnKIGBAs)AHNa?MA;;9XwD?XHdi
zxu_)eW27Vz_n5}^QE{*3tVbFrPCgU3doLYo=Y}@p4wZ}vGtj_wvbu&AbG^fz<`HVw
znsKbTb9zcit8c;AlaMxnZmz@6q(F`LjCu7uwkYCLT6ax5lB=a#0=SsBKt1f#6({55
z!<fZN`#9*1DN&)iNFpF6+U=L>qnX~Z(bX7@>(jrzJe@_k943hksQpXIVHjOCuwt~!
zcV_kc!T)BH+pK(2122nM0*d72W6cRdQ_^v0`G7@*IH|c6DQhO!UD5n^JFk-X6zgQ)
zMe3maQ@~^0_RyFPE3^pa+qo=`oh*3XeI-(%flvO&R!VH&$Yey6T!p`b>}0WYlbH!e
zH92wtK->`?E8?`W4xKg?StSJ@EU^P=7U*vQXlygjnoDckbY#W9J*Q|o>dMv>@DK8U
z>SW@>Nsd6TJLgVoJ2iXYAj7Zv>!huw#C~D#3cl11L|cq@$$>9dQ|2i0q%Tp$iy89<
z;A^>gq%P2|%5p*`*x<P%6b9hXgB={oM1s*oQ_-vCCm+=LfT<Ysj!A@W`Mo|!$m;)?
z&01IqVwhw!3IK>`L@;bOQgo{6{ft+kgQy~i-T;8RXML@8iay*Cfj6t2W;Lrxv~RY!
zNmQ80u;(@pYY}7VWokl~r)MpuGF2fapZ}d@hbIDlzsg5_rAGiAKmar~&2LnQjnE9Q
zFwxrPm29WJE7f27mGWnJ4L=wh7{?+CotKfV17;)LU^pzj5iB%COYVUjsw{H*FeEw~
zB+G+me`W7*G3MW_EBk@<VqJhX3bNE3vL*Z(Q=#+rj|tCSwn>imhF=<P;cNn=kw@OG
z`SyUp=l^M)WyNv-7S)Ii6tKwdzcyL{%+lKh3C9_<XuuXQD2oHof!p0%qb=^6{G%PK
zWS**nmb~)~;X_{<TXi#!!9|Sx`Il=YdAu7wq?8!awA2EkP4xU<4uANn=xHley7V8|
z)}6ZgKb;Py)2wZFK5I(18dO8~8zL{#tl3?8p9q?7v59Hb5>4d119MladteVkFn%@z
zEhX<eYrgeA3iZ*r5#D#x7WL`VCs7on@X45CmEn;BQy~Z47M$Ibw@w*Kj~X9O<-9jJ
zDT(fxMlr~-JfL>UcpmEFFVvY8tiIXjGTi|bg}1r}9;traoJ66nW~=wxCzUqY@-k8@
zJE<m-WZgwTea2R8lcK!K_(4pz{V@-i&LzQC5B>ir)G^*>*;c+$x!ni1!Wm}{56+;#
zuAsk>F0KOSG!hYmyp?HGECQIDH8njFR6v{lV;%#BamYYHO5T*;Docbp;^t-4ZciB6
zUO7<&I1w6d0t5=3C4jovSq~;C9j!=tgna-N1Z7&^Tv@O>Dhd%N^3W_E2ym|oj8p%w
zHSZ(7ymB#6{C2>;{8bzacsnuq15H{L#A+(eQB`8>WQTCMcL#)l@9d)Lza`q6a#lH}
z$^f3*I)+XsB9knc1|}H2#T7etD`e0U!?`4-0iSFdsGRRuDJVthV7u@>qS`oO`ZT7o
zDxM-&=@B*XS;8pC*J3g_0M?nk`42B}3VX=sCEVt)xqKXXxlg#Zj&bXtXG~b8kNLWQ
z9~%u$9U3)-F_~699aS{08V(nXrB1vz>G4GaZ-=IrQY>v~%NU)J71sA#Znw`Zmk6+o
z@K+0R<@Vr4u#8l@PIA2dJh$eKrHpk=34y}6ov88{@Q6n!9t4R5xNA>D`dDrEh)XQ-
zNAd_tA#`8`2Pv<S*6U<RC9pFWK!{?h3M;>jS<<n&`J-cy1LHr2HJU)P9Ux`rDtXzS
zcd{szb10HdXF)yFj@hN#9GT=5c@-DB4c20eBc1r-37JFcAXk5e%qV~VWi`K1!eSV4
ztT7yh88J-PC>31>6l>7`O2iFjzHw93gymx}b1+$FW;%|oeM*3H|7mEC4;K>}dbd*t
z!21^=na#;d!Fh!3tYiFF0%^Phg%gGaU^O=MW^-)3xBbQ<kjJ7Ob^vWDbco43a>IVm
z$^eX2P|6DNiYpk@aaNFpX#|?Ne)#fX7tg-_8D0kOO+U^4g^T|-Jn!I?xOR?}xP{f8
zZuT>=tdC3i19fyl@$Sj*L3?h*|CQEoxX)W8cA<G=ON%3Z2*&<iR&<+Aat&`4euCaI
zn;G+J#g$YhyTJupMj6LA?EKt0-OxuL^j4H{dJ_P4olDKSti8~pX#AEN6ymrUy`l%V
zkW_fs5K^{JHalGCMnIGxUDQg)_o%qk?d|NER(IFH1}kAoRduxa#pm!QnsT6z6Fs}x
z>+YeNkUl3S3Qk?C;(2__0!{ka!h@8J#Jd4SGbj;!T3&z!@5=3uA1T^aK9wpB7g>)f
zlM~ln2rIz1A5-ceQ!8_6<!ciAR2+PT1HtW|j&2H~yCYsN`;mCCBu|*IShh9@@?4Wy
z=9l!nV>O1X!|nxjM4U5SRI9&AhT(7Yl{C_zyntbmP=<kwLRcGMy5hSUV-mPX*~!Fv
z<rr*ko}<G+m1g|oRxPD2T7}ECdyiCJ%3n{MWmXp;cP3+;SP&B&6si@8Kb0NlP;zxE
zNTVL29{-|jQg#`wa6pOQdw(;L@lT_VlXxNu^Y@fQws&ZVFq9`$)Lg^#%WwNq9-_c^
zIj>^R@b#A5xf?S0vxaD^!kQRJM6EL59UzW$Cd>s@t^WU(gKE>m(}ZAfsc2x<ahPC{
z87U+GpjlPScnwCCez{?-9OTgMk0=fgGnHYo6joYQUO3dH&5p8Pp%?-x6VYG-1JfJ)
zH~1hb5UFv>spiuiR?#(V!~>{I+ojXAp|U&q#1|fw+Zp$(C1NsxSQk)F>kLmA5ewlL
zQ}<w30S^eBF)cwF6_c<{=LT(5XWJL(d1|N44j`!O3A-$|iq2U>QwL)l9rGLr0U=ZT
z7xW`lPWB_<%MEF{V^I)7!WS9ISr+;GR1xvN93tHjO{(V(=<+qLl$QLxH&D^+t*(=m
zo`7U`wZ!qGbzDFVzqqfs8e<KRYGIzWIhuak{;?-M<aUR_l+D~G@?33W&AaxZ$g-Y#
z8W52W&XcePPqQ-+GX3X+*>i_lAT<<$H}O^t{Li5Vb^v!pQ~o&_16R2hn0Hn4D~KDu
z`Xl<jh~i^2;9||tYmP=bC>uQGR-5|NWVMWWd51gWOsL5vQK`?%^fPw}1}hlLHps&M
z4l?w=F!)vsM=rVT#Rxef{<b*VGan4c^yIN<27_zYu-GU^G(}Kkm*nz+xx)5lDipy;
zrNk(4XWkZXWI_G1KH-~W?AW`Pw07M-6dTWnuG1@qNr@}nICM!Dt8sgSmQDZhF<W0A
z<B2?W@TMWn)8)T3T51`Jf{&$j4I5uQ$RsY<e>CPxmtL2O8)4}CHHp>sK=KUkXWzC?
zm@2uW$rs9$*fZqSyDxj-t&sXo<wrPVYM81$kg&44sIpr}a~HPT!%Uek1IT%7KpKRm
z3Rs;orzUhC?6(#h<{N{NBU^4;<H57%U7DB)?h(OQP(|x657`Y&?b=X7(^;kWa?js5
zqltnGBxGWaD%-yME-HPk*2-t9SJZryfS$eL5j3|{(Tz+mR-$wQsd?LlE(N45ftPV+
z$9@AlQ`;}<t)-X@XbGQJh@X1XocASuCOO)(-cBk>h-Pe0o>&0Jrq%CUX$Cy$7PsYE
z%QsPW(c!>CL60IR-dFYWjnW}wnaDJF>;lz$i|gJT9M2?~a#f>h{D_w2IP7J9+7b4C
znUC|lK`s8gx6QDzETegs#Fsz~KU#`PCMc9QMFi4rdo04$Vo=G{388lQ`|9TVoJlt!
z0OAuk<mNwjJJFZFrB7gcoG?7g!zC~E%*lLYM?z^4>I@Qw$GYZRyRa{u@||L8hyNv*
zG<u}{Ss`%aW5zj|I30u%LVXgU)7vT7BieS@8Jp)5(2Pm_p3u;HVtBx<&%f<oINr&j
zjnv=r8)uSPcRq<4JT=USGDZEEa}N@rqrcfHu+LaCMTC41NzyHu#lnInYyh%jyVPGV
z7TJ!;l0z7)vMD%ho!jZbnWm4fe4X@>D*0xy6unr)7h8#Kzkom(&fNOSdpt-2Iyw|7
zPLPz_@fZwbznWEW7aI{(-0CVPr&SG1m7?}!%j%;&HDKV*z%WhEv8>p*@bE&bPQuD*
zh)>mHNOQ4JxuQhNc?H+?T_fK#3y7Rx5d+TGJ@3d<y$DRahvCbDAK0|*a`ck#($Fov
z$Yq=$1tW+2IXTjBub>epYWY22Cw%d?)v&a9q#;Oy0uhCzeXdN<vga~K5mLy+OYQ2x
zs2WGyHh(>apYH?A7mp`Js9^x^sF81PQs~?FN>!-+h@k7ng--sxX@x8+SoZG`^Z-a_
z*9s>ywth3|)FX}38TVP5^nWqSGO^2QsF4$M)R{OlwG%av#2kK|<eoBUN<ogiI`9rl
z_d7Zds415QlUHskH^O&);oKbzm|Vw(BMt%z`)ORf&4HlVn=saqk4J<5#A|EG&&phg
zg5$ai0k3Y0H8auN(nTIJjPz39^8@FCfc3o4rqF4iK5BUIhhe7~9lWz$5zsSth6M%<
z>>h`SS3(dP9fU~4=qF6p<3}fh+!ua?TX&JFcZsVaqG83VLi{$yYxa!D16p-I*E_9C
zp~tMOnKm5ulnyci4PJh`)l=sz1qyds576G3Z^%;awPsA(u4#o^2Bv;AjUFGlc}>E2
z?a$M_esek)vBf1mM2L)V()n$1k|WQL@DFvi$#pMMHoX>%6}FVq0F5@*mVo~=m&FY<
zPEqOKhWlR>r7IK4a<~C({h3)104?&FLu>n|%8h(@Ft<h1bk1K=^FBI_58KMoS(hrr
zx6l3DwfIl+7?dCtWr{;&Z+5TTeuXu}Z7ksjI(As0-QDC%O~kBWe}8`RkK{cneY(3P
zBP5H*A^zlUj>$b!<S2J4V+jsfcEVENDj(}0%QY`8fxo4Y{*Ce3z2I4Tx>|P^pm8Y+
z2hXGpq&;QW)zlguPlKp>U#oJ2bM0soqE~HR!NZ3c<3kX1?udqzL!`u%<mflmM|*@%
z8kGY|j9&8X{5hc?#zX{ewm+#!<1TWS#oI>#HcB0l|GjTa^(V6?kZL@$l-_l6ml$*2
zk{J}q1VM;MO~O#kGAb-qiG6<OykDi-!bRMEoEEr+kRCwYOWz&|e1T<CHdssQ>(h$P
zG?nSBRg)sTb@f{5pOL~c?ndR*HNzIcy0x+vL7hh^3Ruh2NRuD3(O3Apr&mvRd`t3j
zwt~=z7Xr8ntUUU{=0iwCw&m8?L)0A@{J#8{sffI~iB>C<YTK*FldL)m@9BMUaEOBO
z4g^(0rkmxUC8<W}(xnIz)o-e-SD)?~6ymIPPKvHKT{>ouhhDu#1@V>Ucc=(P5n>+)
zzegjpMKu?D1Eyg^gXB6Cf20lZ7A(=5mX8?UX-9pjXw1J)l_lCF&T^7*6-)F$8zU)n
zOlDB|&s$Ql`idB-$gMoA87xEBj{7(Q;4m@{XA*7E_`7JzobFrysP>wx${au!inC`#
z_#5m?ixD1Jzx822;4*ptAwPsT)i!YfglZGzg@`*FwVBPvILFY=Gd+Z>2<WwKq~s*m
z9-#R%&?qa4E{wNxF7Z9VM?7)jaz@UKf_79<pu%o1B+ksgNN4#`vhV&*tMJ!BIWMW$
z@+4*)xp^ut-=<6Rkl~4!wrZQYQgW<l)C<TKxgNQX9oQsA#37jVpdO7l2gkuY+sgpf
z86>YL;@XAsO`dN}^NCuAP5calg5b<t<~D`V6`vqfyjTCK9>Tt@Z}0@4CE+i?1c-X_
z&=UCc(${T#q9iHNp5Ha-6C<*qYuF6e{IK@ON%I(LEHo9r!~52yQM7je@*W)5nzF*>
z`dm(rFR+=UIi)Ts?8Fis4&0iXA5Baof$r~c<?v#U<JeUN>!pZsKOEtUHuDqlq>Sog
zrnDoI=DNo4n(HPbt!`fq`Ns-xpU`X#d9}v}GC<==XvNN)WB`YZOd4H*x3&F~=P*|`
z@*PPlPbXCJ3EP%OHw=xaICyZRz&gA2LvjN7*8HF=Fc?B~&Gu_Wc3{nUlF-8sLF@Go
z=}TzDA7tk|04)-^7mjF!rwWJX+<^f>Tg3AZ4MObLS%OlomnY_w2Gf~Mut4#LM8jQT
zl;2zg+G){%AklCfvk?+W%9u`f%C3=;(JbPl(H!IXF8v6Aa6VAP_^)p%8M}$WdJAK$
zPvBP6U3phIJRIySveC9V>D|%16H_Z=Z2P%En^Z?dOWW7^ahI0eHZ(U(xBhPxkYjsG
zF<h0{d@t^K?Ujt=Z;k`zNfU@rcLOP$T6v!X$Sct&y!Rk?`AjV;`ynZzxM(^obPeQ2
zi{7aCGvczC6c^$U+rHNX`4n5gC*;>ZY1}1Hv0turcu&+@@*l_G3`j8-WuO!~?U^(d
z3o-Hq_mQR@W5X4ffM{AD=(m^T6Xtlr$-zg27z!%^U7MvxT;B0#j1pP|zBO$hMB8ep
zfmfOoLN@xf<a_z;eHCdHx>F&|Q1_K1BcJL{F5f`so{Oh4_hwEtSU<9SK;yIko%m6U
zfz!pVCd80>I%ZPYiN@gdKJbo;2Z@T!a}bWf$<C}?+^%88Lf(K97&_p!ZhqYi{&P1?
zbmy@BgRGNJrRC47Cqh+y`Sn1{(Gt|||Hpk#=Mpn={`=sJhPyb}R3wm4EyIEL*};*-
zvwFE@zUUqW#rh?vF0aJmCAIOOW2icr#>}Ww3sF(9i2T_xCFoU@!ffW1FF|^Q?&IiV
z^1#7PRBQlV!;mA*LjdI{-y?R)PH#VDl@nvAth|+PH*(2tmoO@vDm7&i3??DhXbiPC
zupBSIVnnN%*tccsMZy5cPRir=JQEHimPQQ%)X3yD#JuT9fd(1}(oAPf(6!O>yP?N_
z6HPi<+v99`nEG;bN3w&Ag}gSFNO$YnyRN{lo-ln;b%&<sL?K{i-9SPGpiuC4CuJD6
z*>QbHjTN+JMh{6*Y><|IWExZpF5eR7bMDl3$$JSYWL+sjuB4UaOkP>}FoT}Lqr+pb
zpR|?a?3~DJc}}?$q?yQXRbwt2F>?o{FI8G0JO;+ZpD6}1p;w}gEP)kk<>uP3tqsD@
zZ($msnKlRw1ZyG#l`Lj;V~vgI&EsYNspO4QFGW(1yv6aG;y9_N=*G5W{oxtE#5ptj
zVV5V@<DB)BM1#y7feU+s>_Ws6<<|4LakLd=jgeQve#iW3W&G=VCVRWvk|K%hu=tg;
zv>2N;%DmRtEB=TQWGp)!nvdT$<{qnC^S{MHrmR(LP0S6+a}n}Yq`!0%1O(VuASZGb
z)^qu4Gi!68Q0luyFRa#uF5u26j$emOSPHd^<VM7mqIb<K8)Er1vvPe#r+IM>Vc6Tr
zh4)7Tq+^d{D1wK?8R2Qng}tbGrl6gQGv1REI<l1&$MGm@UFXQpe{9Eng~LG9v{gcz
zo=f0h*5wGg@Stmf%MVAeh+5u+Ow`hw=H9Z&o*zxJH(qAnk=QZ0J7uAI_5#ox%zcUK
zMbkV1j!%c0a8lO@bA>vt9MOKxy)ibG$b*YLs1ka?d2m4W`UBHi7qU}S+{%ZboB)mh
zy_s65fIlPm!03W@8C#@Bqq#C->SE;71GX_Qmnbm}7KJQM6>aVPeN$$0yS1`+k-g_o
zJ4uI(Omp7z2}nPDv4$xTBg;K+)SIvD)O7rGEGyF`8-eV(8D#O9lXJh&cH3bnAb(;v
zS`c^sSa$o-(aXESG)Jzo3Hduyh&);tdXhD8HT-lOAw0}5&z^OS`6DqAs9)U=2lmC=
zq?NZhB*-RtE+Z?+s0`F25w_>G05P&xy-c@xdTe-m_5Gh^u#GQQ{Q}TG&FFhP+TXw+
zMMh=MPh>UK<X1%lmpEM2z;>alPw=95IHQ4QbWQiVRg)A3=s3cp4gr1N4aI-&wpuXc
zq2^Wz%!2bD?1GyLOh0~_VUKgmhYU?D6-RP-kv&m9PLaE7ee2_30+>+aTv6(-H(rJe
z0ih+sn6;0x<Nx4%IKC;;3?8lmQIh>Y9vc{LbNLD#LPo?lxx#K1n}sU@|9qxf&rm3|
z7m1%y({W{n*w1!k*^+ha_~VZ=nGmtn&mWvxQbYBm6iStAg@hT#9jB4xY*ZqIz3K7-
z5BUSF3_sI%V(k*%o97jtczuA%12&Xqe+1wLy6X2*<|eU8P$&6M@^7w_&vwi;y6PHI
z_QMNiNMt6`+8(I>-$chG&mlx*yrn3?l?Xqya8CFTEnh9(X_~gL8qZH!N>7Y6NV&r+
z*LZ&h79Eh<;=_+^-7W)7g}KA8NK%eBMeGJpJ&&=;!0q%6@}^it9aNwkj1NpkNMPEs
zQEhWFq7R#(O#@e+dKm$8j{cbiWSMM2E23mPC-761UviwbWmJ89Abq7LErhHq{iO&;
z?aGj>@UdYjbRh5_XDwHsEf?Yo`cxf@^^L`fM4t=*EJty>x0;)A7Z`mnL6)9gVp%9N
zp=F5A9~7rHIB9g%qH$STvg(|^VockLmMUHO^&DpOP15jmLZ0t-1}2h8eUUu$*Cs%a
z;!S$i2xj3qw+AOzV4L%v2izZgz|!V~FjwRIni;Z>;25BX=s`U%QS{*kAcsggVR<o3
zJ`O_*E>A&UDeTa7+qFy+1uIDReF%d&nEKeO4&8ZQ62*{pYWZGH?)c;|oM}9z(}j9D
zXpldDTzm~-lcg%XiT}}O5?r*`r|Ih73)@MD7L+T}=PHzVj1^Xz>9;hikCmBAWX`?K
zjx(;$?7&wW$KT{)Btjj@xg-Y!3U&|l91ae<xQlzyqIX351_wp#7351j81p5D>f%@&
zPQE_?nzcC9ilj-rKm=deE1890H%b#J58<NN)qhRcQk|?8O-jyXdZmpiG-(m0D(ryv
zI=r(HN+8<{hRps@2g+8zR!%_|Aib83=2xv+9#RDb1V!>=hXReJDL1_-uN|q@Nj>8X
zaz<)Mso2bVpGuz%erN1HV)i(DI)!9-5|}d1-6-0C*Zxs0K${Q>b<Zz-%SB+OQnuOE
zk@;$z?LRklCm^Me#kDtM0AWa?1C*zY5N8!@V%9oJsxk>u49ZxHi#VlVF*HA!x~<Vl
z#xGrvpxXu@KQ~1ku5YfB=X!27%4TNT&hUX7C<1^rWxeLb=gc<j?BwltFBowR^=Hc`
zjz0UXriN*ycoK?D14=>PxzHr6fcPW&YLMuS@8pwv&j5x%6N?dhRKk5q5iQ4#KB`Gt
zF;F5#ZA9U?02iK<XceQQE)pd{S{PEVHtv)ZM+3C4&+1<^n(0g}Jvppmodz`akGev9
z)Ev8)4<f(x$dtmg(ZpM9mt9p_=K0wfd)!P&l*1~@5;~1p_^7?wyN}W>;G1L|z{P<~
z1a4+(yQK<>0rzi-Fdou(VYWO6w;x2WNS+7T3+u~wXMQvu_*6-q$)b*zm0tZ&B!11b
zPNSn76~#A8oTPRoodDL2!bV<e8=jfo0&wT>v;;tISJ_efPsn;p9KUC}am!tk`v*qH
z>+<17+x(L!);=KZMbnOD;siadO}WhAaRT!8EN22_V;yjy6`~XJ&)E1)Ql$Q{%&v7=
z;6=iy(6d{jjjIpXVGdTvhR~t@>JDis9dj>qeH?0Csp?bOzqO%1-=oX$@|$=0dj6KB
zC<^{%64wd(=>@+<C=AKlr%%26vKL&O)oGxxfUKALC5H9JO!%iL_5iD;nculsb+BZM
z>U+C=>k`J96=I(t3WPloW0IE6i#zdM^CW`IB(Jz4ll)HHn}VLP;79#eSdA)}V+r)g
zGSxm~0PV9W4v+v!j>i=;-r1^`IoohYN;Swtj{S^}(K9FNRJ~gs3wfIir}cx#@7~n=
zbi7FK&WNy<49?PRTvVcm9)+H?6Ro&xrgb}vxe~1NS=^6H@Ga*FxAhT@f*nkl9!z<~
zTx;3#vTSAsSo7JR1I$y__f~n^LOPdi6ZFPRfjwy_+#mqZk2i$Sac!h;3JCZ#%Gmct
zeeAS?nGlFiLO-GmLukz#z(`k%2RBNgEf?KrBVmqQaIwQzo&=4NEzigvznAh?D^~TZ
zEKim)^Sv}Cc!yt_Ew2^nu~j?E{1vF0f0KwI*8nUAo(q=n2pV4+HGY~u&3Tjhma-kp
z?0Kv<bqAREC{?NKXlV7etlrSlGEA%+P2R~CsL|nM^z{kOl?ytorB``S6)0`>AQtQ>
zv5XC?#u0x$ABL4<uEk<5T}Tvj+AdMp^Jr8jS<s_i7+m^Nw%N;uSWGln=|5Bq6dr6a
zU2VFnUJ4H@p=n}%&{RFY6Ca%%bky`@b3#^{+%Z5%20lMZns{w4ya9SB!X#CMZ(sx-
z>(9^4xS#gTET(x+iI?=m_`@SOLlhKIYF+`aHxXR-G?&H)a@s7rn6srsG|B3YCy%z@
zm{JmFyxVou*-7A3Yf!c~AItY~<BR24<Zl;ki)<R8@G^rBz|=X(quMSVa5B`dNNtuc
zE0N*hl6KEZ*o!UVPp2qbxhwb1GTFKlO3$=0kySuZ62@Anh6aj4;TVyT{;DVE^AsSN
zO}(>7tG{2do(ATV2jI@~H$dXlVip;64)+99@etp8Hz`)uwFBHH2}6J?lYE?jeRQGY
z6@K9XMfCN5(g7MO(*+->!>38}ek%&HTT>Gh_FQAo<)<eDrM7|_i?G)*5AS)Fnw?*E
z<y_*t4=6|r)~-RV%Y*U77NCi6f5lVfSq9dhjL8ZgfUeUU0GtD^Kk#1n;s}OsIXsI@
zE=bNJppEJ6GRz$IOz*t7&d)@yXz<V&>Fc8%vxW}ArdUmO1R7D-=Wldjl^yfXm3gwW
zSnpTdHD#qWuWL(g7>~ZekU!!$7S#KnpHLoi2euHQ--6PUlPGsBoz1^GniAhM9*$&z
zBr(pV>1@I?T`Pghl7!bVy?XW3I27gf(daYUGzDq{UemkJ6^PKz2*FsXER|3n*}xCh
z+o(VV+oVOgt6}!imST2I{{v(fJUi%o+&m_6>4FMd*Jal*aizk|U_Jz*&*+->?^gF}
z{r!OZv(MFI+{g2@>pjZeF!m1G0<oBiWl@y<;+b%sjk-2`;Gv}N7T@38a&W+aaGXP+
zlPC9tl2dXsfu+7GtN%ml??kL6+yF6zTc86K24)R=+#cYqCv=oT)T0lkmdd!hP8<6!
zT&lLVVZ&epmZ`I)b>qgoJM{rHS068~)YDNT7laS~Kjo)oxTvzBnp9sA1F3|?ua68A
zx4F?ALL`(9AYXqp3!3gar>V&}eEc!&OXz=!EgZrozAnDBV*{*|$h1E>3iqjsK)(aE
z)qA=*IX6*TIso9h3a1ADR@9}}cl*-r940%sd7CeXD^m*E+c!%e6)F7!tPS@>hl4I|
z*9Qh<$@Z&n;ABeG@5GqOw6+SUvo~g#=)%w70|Z7HR0<m@jA&WNuts%#f#6P4c-o#{
zcP6Jt>?W>|EK)7g<->Rhy9&nlQ7wtWp&rmOX;aaORa9QnCT6=vQs)0xUq@~K_Lk(i
zVzS9wN}FcM0d%w;Li=JQ=><-hkFc9k;@1g~hof?HUWFp#i8oe_1qFr^gE=AY0oR>o
zsb=I|_T)Agj2DF1LOVgCjNIuwc>P#an2995ecSqLgCX}!ZzQRO8R&065iz&eVaU12
z5FqJN8G1vE9Z*@lj%DdyGCU;jsn$#dOwI-{{g-3MIhX|W%fzwn=@K8dO=V3C8-W8P
z(iDo*>-kD=+m18n`AyXUd=%=UtCxNFRAcZ400ljw0v|7>BF&T9L^c^muS1&+xdUIS
zFKheKp=VW0Ot1=GNmGd+`-7Y<0y+*Wo6{tyN1M4XK6u^bcfo;SbIvB2E4As47X|u@
zXKwmzyLLyWAH3JNv_y&3oZd690+6^gVx2c-T^j=^0II6#P+id#+FdaXWFIaKRX#S2
z4nmbF4GmrvrH>1wYV#5_1j}<b4!-Z&sfIl&M|n;$JMbvl)1X^*A}~4Czq0#TO1*}P
zxwbMzuBHBWwe2Ataw^eL5mBIHB^Rp5PFke?+b$ot7dhxbA1|mi4xyS6%y>EPv8YJ=
zXZV>E+96B{0cGA4TQ5`|9y}1Jh@&hX#M@jGy&}r$(!_Ve%j>SC>2kGUwU^9ck<r7v
zxkLQiH&X;Iq2A0FUX$%FLP=D8x>BqD`Z{j~!gTzILp_`3trhE{dSfach!=$y|EN4!
zLh@BZdd51*Gy6O*N&yquFE~3_Y9xbjus0P%;gR(LF3?nuSD7Hww<~h(aYgqB;T)R?
zB(K{hgQ#hzul3aR8%K24uAPYPxXX?tvWP4CD};nz6eW1|JY1uxTwdj3J^6>T%9c|n
zvii&eV3ikw8vDRL72CM`Y935uY`3GN)6v$rM2;xQvNPxEDD-KJ-Lva=R#+Dj^7RGh
z9g29~?b;SnY2G2-kDB&WWnj``3(W|AjOLkU7smWs{W0>Q6J8=~sB>`ya?ehiytRoa
zgE)Qk7y8kmhc-N$gSF8$sLdKQ3%9BO8148HhwPr?UvD>rOrW-Od)k7&_qS9B#lhRe
zmv_KEoQLms>=jx{GtIyW`4d}+2~1ruetp771c}Kn8Pfe2?~PLXoMZ_JX>dG4J?^Td
zkBbkQFx$U;ycIo;_nW<i8$kpk$MpuZQ{YJiYk&&UY8aRJ$a2*vHn;am;INCFD27--
zy?~(Tvrd`FVpj#QFml^G8k7p32LbTv0-{4OG%=Q(jSbS)vp~K@E%dZ%3Pyr6SjbM7
zu0KKl6~HzX(%S5r1MWT~ODHrz_GW06RK{x9l-Fk}C(Aw?paZd%)0U6L;M=i(e<?Fp
z^|YT>gdW&#3kT|uz>i|ROtQdXnDD#+SnlqejB|oO0+}@*{Z%(nM(k~J!>l7U-yIsT
ztW``aEc6GjGX(+suemFbqC0=)CRtU28aE(*ZN3!1s$q#%1ie&n{Kt#i3~DzkH&8L%
zRvod_Ma@5UAW2db5rp~fN|b1=XblitMf!zcivO#57Wz0|KxF0S2nG}3mTo*PUAVip
z5Jp=4#u+H8WS&YMvQ<JiWUId|Ti1^U%JfyE-ea=zu|UsbAJs9Oa1xRrxiZ1!lv_^e
z{1yj^GI~DDlivI~^V`VF-)9`HJGcu=vlUwVRRi55op*?TN{fsK=Xy|3?k?qICC`+9
zrLyT$I+Lb9{LeB7!?F%T%`RMI;0_5OA~h}z=;zAoj@g-OnsqNhPJR~}dc|yVdVl^^
z$bv);-0z-Tz6LX5Z@F}DNYktV{jak!6;NG|Xlv1dcq2kwDD61sP%?Hz4FQF!6bfgx
zL)b;^&fOWitCFX#I>`M^eTEdEq7dYgXVwB9%JgG*nGT$@zwJ2_?HNX8V6(?k^fQ04
z$Z-oSwzz3fX=N=k=c->2n9_HMK3rg4Sw#aJOzpD?3K^O{ALOS9rdnAUJ;R>G%J*z(
z2$^@mbJ=x56P4<2fgi9Sb#0lKLAad_LL+jIDg%8<QQT=~Ou)e%=QlF95==>YeR#(Z
z4SeDURjTWC-ZDgSDvT_t`m8fqO9KG|L8+Dr7qNBD5o&e12n4Dh6L@?ySz44bzN49s
z4OH5dKQ9BLqx99+r8TzwQ!x)4S?~R)$u=_X#zHNV#|yoT>8zzK)Ovy|$%Ap<5)y*c
zazE~{`QT7>ok#4&D7s_`7sdK|QKyi_!x5pR^L0;q3J~~b{bGVg`8(iaTdUwZRMDGX
zm@>>cKvjYLs|%T;r7N8<C^i^=ALQ-CJOm+8VE3Rq<MQmgHmhl!z|_e5xpAfyXCYty
zMT!c71gWXc*zFhr{~J<>dSvXC3{D+Yw>QOPZZ7waNYz5>5{u+OR=r!6$3g@qb8G3y
zj_|1F{ZUsQi*@~`L9qX!llUfP8RE8z#6?;HrJ@a-;3Y)t#WRQL*Zd5F^(uNd1x7y(
z#USF}_ChzHQCQgipsA?#mnmR6sL+;>fhc%*y`Xz?AYGk<F>TSdR_(3PJSPu@utGq+
z=lm}%W>UGfa<iN;5Ue<GXVp4VqL@bM|HU~#0o}d<!1kqwN%Az3Oyqtw)%4X8T6Yn*
zIF9MFG;{V{@i%#Ykux2$<gO1RmFSBa+}kHlGT$_YfXv{G@c2VN3B_3Kc6Q|K-Yf>e
zFo6F~D0gOWRsg!urdtm_`%@<#nu99}yYSFNaAze9;@G(P{#FW}x6%R*u>?FByiUb1
zZjS`(aRb%$(8>mgZJLngm%wxPliDFF+%BW*F~<Y%#1Da23<R^wTJLh{33|2e+Si~w
z92eT_#MxW{Q4+Z@--`{h&=VK>Hd<4(6hexcu5<SaJY1#}VuoGL6KGm;{C@-0(=H9i
z)SjBvSUlJaI~vw0T6`|^{PGZ0E=3R#I%^VVy0l#a_*<exg}u})i!dhm-czC^cypnR
z(Teh0fz+Q;f@RU|^N+K?NOA&PKqnFw21L-^ZW`U$GDrLZK&ko(0E2YriLL;GjHBT-
z)#JSiPUu+I=i{Y_<;IU9FkjVtggzMDQNXu97Mv`RzN&dj_hjd&&M2I(f=8(#BW8bQ
zD<0B22HKn#lH3k99cwbP$L~Vv$-S;qU4B;Avf7wEhTbUslCj4NZpN6~kdWa`NAqzX
zk`!Sd;ez>8%s3C+09AnWTIw!R849z26HuP%8F5U0Z)QRdTDu6-oqCn>OS^P0uwt;#
zSx2v#{zy<g)dFyEC@@8->Ua*DkpZWc5G>w=yIT*V0Ie!-ia416Mo}y<mft`9MwB8Z
z(SStK!K%^X{~^nxN03i;B45B>h!~rPG_PWN$?vjP;RVknR+@1678CGkaGNonB{0-@
zL$5{n`Ia_=#4!F1=l0+D71t(#W-#?c7~Aj)c6Uz=jEZ2EoT<bx1ejW)LR;@a)7hae
z1aqV233FJWz=1dJX{4OL$H0|no2>**-GN(RHrI|dOgmLkqhUEG{_~Bs+5<ClJFL^^
zAizn6&7IiLdn6}E?a=>sv#5imvv?7sMaBR`B-P#0lu3irO=^YCxK)<`_$JHs=iCJn
z1o4qv4(R74I+fRyv9J68t@PP>JzDOpV=R#z(HTS~HFdf(=UnBpNbpL*@Z{M&0oYVS
zp&>h=gg|ZO0(`m9iY&G^N|=YmsCnVr4n#mT;b(X|iULWZGO<y;$jD;cYNm&dvo%N`
zzqrR%2{cVA+$(A+(r%Z^x%<ULVe}L>@CdyC5%b0=Nf?t}I>}Hc5~he%d(m14S!Jfj
zc{ntKb+m=?#89Z@vA&nu&>1eAsJ#9A+jW3rez^L1+Em0Na=h*Nyy2lQc@+#phU@U(
z!!daP0i<h@=MJ@4)zyy!yP4wbKfngGI#GHg-jwNzq%wnvF``X+OzFJEK|0cW2kYhi
zXDQy(6tzwpk;2k*;v%U8Arw%3;P1I3ot{#(DY2>(eW=2dFzR58`|ggmrKRVenVrwm
zhNvj}u=UAqKagTH`RPTWBH*byfxN=V3CGxHouFhWe7wgZ#L)~Ge|bQn(w@2EBlXG7
zMQqQX=)gMbNirBBd$+fcmd+X*r6!d3Wchc8AkVzNrgaBPQG_DV)7o^Eq%^km+WShz
zwj-T=VGuydWo{~SM6bKZ8`Z<=rbV6`Dl;kxY1JV{>4FoqnUzk5-Q^y14G&>bN#{N`
znuE3%552;hV*Yt`_ErjkPPPXo`aM;3=8;vwsA8{4s!%<91l~wXy?Knjf_BxpJjvre
zSGgcbqI&C%!R^+3%(F0?1*5As<F?|>C3!GqsbBL=U%8p0k%_z8QUbriN6(tccnM_g
zl8R~p-M)fgLfjxU7Il1*))$aId`aU*;K;{?)($4A{sl;SAa3+>cWFtl1(`=FALj2Y
zGeT8?j#VYL{Xgr}R6YzxMAn|=feEMQRtTbxsSI<1>3H>ui(*2X_T~H-bdn_5=;Ws)
z&1EuC(kLNNw5z<HLp@_JSvP>@>YuUM`OU8Tc3A6TU<mNfY!H1XOS95Xy4=PwW~Yu3
zF$z`8*g9HdY2E5;sRPe8Z(r*uRe@-mJ2pB1*chf%VJF6ERs(2?P8cNmdO~Mwp4D-Y
zv|ulQFTqw9Lt53?X+c=qp`9=cjJa*Ext)|mxV;bdW#~IoYmB$SNruc3hP8ubiNRpc
zf1(AsT&&8tNb!4e>aGhuA4l)Bup_1)qo)t7pG=@GJri8SB}h0IL4POPZjWK3StYZ)
za%#E7$YhxnD2ZI*Pbn=u@4wq85=nE!5VRQ-C<rJD)lAoEka0a|xzZqueJ3pK+`-Fu
zE+^0&zd<PZySQ+4uEBSLw_#?^X|u`W#yl<B=lgR??G6$}puNy*&;TndXrkK%@)AdF
ziqd8sy*HYyK3}Q+JVehCPi3$!onE3+wo=y_S$GOZ3XD0P{s1YYc%YJGmP>s_WRHGk
zeQXlE7*c-eU>5NY-edjd_InAnkZLi;GF+kv@R@7a>y_{~mm6Qv!fXpHI9lvrW>9ki
z0@>8TLYkq65BbZ*G{nhmoWR#<hU0QvRvzUg7?nxAEge~7P`|?Oi$5HpS;240%!Xyd
zGYQVshF+jr{7k#wwc<+w?B*`&q1T1ZK(GXwVEzyM8~C!W#%Lq>wD%NEgfb+<l`*Kv
zv(T5xTq&q!+mb0fL73^QIkrURz$q<2qojxPG)n=yO%goGpY9>;efBAqF7_^s5(qwo
zqz4}QuN>7ft)?6owOO!L&Pmsb*$E1iqPnUuY^Vq*TzELaj!@{JyCGXG720q-8&NbD
z1UxEkGBt82ygsW7oVFIMy2HE|&RmNXN~+ZP*4ZU&Fc$?i0iq|#n$$br()y1vlRml!
z$)i=eYQPd8G}fa1cE@-_qi%+z`%h%>A##~Al?jldYGMPi`WlNG09HV$zntzWH=epR
zblYz>J#5I|a%aJuP3sGF%t9ZUH<pJ7@tKpj{CRGIX^37i@wx&WT9b<siO#0a0CTGr
zoa@Y+=}?O3;X?-ZdgoYTe`jb0lof{m7Cx?7{jW-Mh#jRQe0HpF`n=z=pUR9u<QASN
zc2%0|gL9t@#RT=i&ZY>zTIfsgZyBmKxPuY2bXMhi;(HHxa7m>p*s!*DW89^zLdId@
z@&u}*GDM^XvFCTc;O{e8C~)R-4&g9pK9r}NaqFAQIhMUTa`$$fNJQtIP47YF;ELg<
z)MOc${=J;Ae~`;dJ20%AidqXOa8a-r=b9OYslp&0<+B9=<kNmn5L1M`9N}aF%~HGC
z;%GZ2TB`KKqcNSHAvF#c;)3;uBs6<F%fh^UAW1$N?n6Vmv`+Ez<@XF5$s4F;VT~Sq
zagnoC=0{sUOH>z;l!cEInXm``T?~(Z?>^!r3>c$fRG}v3l03E0&_@{d(-~{hpH>u9
zurltezv3^{8B$qFpwY`n<@`Opa5#HQ|5<Ix!&e6-&+HTmHQb4b^6aN3Z$*$UrS3n`
zo;WZVQoO)-Y03Rd-saKh4B8@}uN4l48FJ56BvU(nDaTKpEq$4Pfs6!r-P>V`Zs#re
z(RcVQpQ~vJFD%&X5Mxzf6!Q+5+f%zdS+u<1wjve<m3VVtZy|L$`+?A<LveoE{hl#b
z516j_DRO5sQFPT?*i?Z-qq%+sbZNe!@1l4s`Pvx+&Q*?C-dyf<68gxz0G@M8a&IC%
zv(bH3E~MUT(`N2S=17;e1b&o~h>fMG$dZy5x-pR4>Tv4ZPC<d-iUXy`9*J3Dj*6#I
zcf(T$iZkMa?bTde4sMHDyR|QfR7=2*j5zz<K|l=aVO~wgrQ4C`O6I4S99G!PWT=f!
z*1N}|Gt`RD2M3F|=U~N{hN3az(PXuHe`A^K9BmRyt#O!aJv3~!m%B9~pQ7i)BcRpB
z1pdsd?=6#BYMy~#4*U1OP~DK5@0!wvZ?O8(DLR*G>REZ6Yj)7)3FiimbR`KE-nr_L
zpvr)veJDH<_;Y3;<c_70EY(QN#8cjaKZ8f$1J)XZNh57ihNhNEOet8Rej~;`=DJ46
z@TfpyN2LQq)9m$x<I)9V4XY^Nk|;Y?p8K_JQ~7!$PjsZsx+hZl0p-x45_^qH3)77$
zj$YUHc325T2@%(kp#^8R6q|M1p+hTNx&7&X&D$B4>|~zOUhzo#sG=C{DIu#T`C{q4
z=0Rx~ln@(=KWRyYf-k9B8Q+ux2u6K@56of4H>-`+tfVHet8)(?ZSk#zo&pHV2||H*
zwACH|?!J)|{nawhv>J|$lQ9>cji*muIm6g1bFJFYxELMowm}^z8y$iN`4EtVUJaKv
zuoP3n#XkIWnE%-ExW?dD#$5<AxMA4YL>(S*t$G+$ch9d{$r$tAq2zt)2>r|Q;<-OB
zw?MhN*y`(G(qp5pM#mtdOM6GTK0QI&iI88UfV^mW89>n{haBDjEcm|gTC!aSP9d&2
z<I9-xHX-fd@r!BID1cdK-D_N)Vs?+#iARJl$&klk&c=+svyB07c)m?=*Kd))oB&st
zp?7gfL@`szWE~3q(HUMJsAbx~mQlb*+c@^$+k}iCF5p#24444I5xu5J=9ZRy|B|^M
zBh=*}ii4~KACmH*6!1Xk{&1>#=7pF5qlvc^t#&QE=_L#g^M9A`*M}=FUUNL%p^+Jw
z<Gm*A<YSygot<2VqYBqRg$|9gHe&l9q)YO4yQCUdEsig9J$4qNfZ}84T{i!!Mg>I4
z3i5?$2(?*ew;wB1VGSvY1Ej|rlP1;i!?d?tiyirSfLXPA--lTJn*mw-%cs3|^b%^A
z1#S}Mcd$(ZB8&{Vu4|%f7HZFhm!X(Gb!ayB{|$A<ubdq?z_dm{(5Iv$Q!0<qC$Bs#
zXPcD;fBj>>@UHXyKi$*-K;>SZ87Uni8pIC@@-FZx^aHDSy$-SM+{yvYf(#<qoo-N(
zB}2m}OBkaG)9qf8evhIEfG5tGgngA^)Cq}IgjD5api7U~0m_P~Oh7^lJXdjT7$GDn
z%47ex%PA3II^`_1Auf^3j<IUV7#a1h8U64-j2k`tVT8bi@Ho)_5Ya>crb7X?CYXIC
zX;<W=1cV!cfDIG~IgyuSkAc0aClg^Z&sMVl=et3H@XhRZ;Fv#MpG8%5Qs~2`<l9}g
zAEm7q$L<9AxSUaUL5H}y%zAG+Uza4iLDZiQ&}_@JpJU96?@M-Yp~k12$@xXwq+_c=
zTeN?I>Xl#BE!rsCg(07uN82l{QG}Il`H7x2n~5NGAq^P6O!p%9`_edwYRW%D2mly8
zPn$5-oZMyjtg`>NIB#;s-iFnzSL}=zo20eJx)820K1OUDc0#Y5n2a{8F8tGcUaJx_
zx~>h!K6k|oqyFFS?}pd_d{Nu=73W14-uh!h0kU}I<1!8DB9y{QHyLlHqVJ4jD&8R_
zb8<B=P@RTV_X2NlKt0PTo{ch7{jy@ATlx;A{<2IW5N)xE`A?o=$J&o}$z^(IE261F
zs^L~dVH+tVLhfsQ;6KT|8Z$^qE5G@(kut^=o9q|vDH!js)sn%b-F<W9{@ckgE<Pq^
z$`FHtUfEg03&r+i3&Gz8HnEJ+rB@DznTezMf38hM$-^T$yYkc9ohnsKDv3Oc8F)|<
zMB8WH&(Gm=N{kqCYI6mgcbylhc)FWlEIdLd=V~+pD&1&w+L^-+XlW{lu^g3<g9Fdj
zGHwIs@W%$YibJu*hG}Qd6#;Nz(O(Ad+l1VfjnmJxihHW+Uox_C;$w=K-Q6#Q2^zzn
zedzB_y;b>)CD|@`TTjKSix1vK=fnPPRhM`c!I)EmT1u{YoOSH#Kx!2{y>vy^c3!FB
z%l2@4XNI4Wx42e56`_XTM=s;~v1az;$rGp0AD}lx^ei+vH?upaKgT1Js|ImIUMkZR
zj3}W#9yo!3Y7tB34LN}h{suSEN!j5u#DZ{{i0?5aK$xFJnyYReApi6vtLaOr5#nGm
zMc?9z1?T}-+o9}knD#987@N-^*d5c2-&t^}q-)FbsvX|u3v$bN*-6irbJl-{Pm8Q;
zu@$LG=_-p3nVj}r1WIKhul$YcjCd;fg(~7Q>2n168gqxwdtoj7`O|EAs7-Fg@novT
zycxRs30}_7vWSyaTshE#fn-@sk`{bLoURc<ChQW|2F{q!C<zKw$mXMNx?f8pn>?zg
zA}tVntc(Eat{LJKbpYGMJK04ArLLou2Lln<I5K`YN9pETmA28|R?4%&q16)cPTzx7
z=C*ab^1^(vGI!Z?b8B%7B!wi~STp*kjWMn>3Vgtx%j&ZdMB(KQr%MhbWbVL>3j&CP
zw|!o{=q+YG|Me&c7#W{;9ywk5@PQ$99zb+O2Y|)Wg4zw(>xin}K)BMiJJE;~nt9D@
zrHH#eZf>Trnw=D=z#1tJRoLGPp#+fXka3|P2yK$gZeJYpoke9L!ml??-fNWk(@*(q
z6N_Pmm&yH>^ctKY>-!6VX*A_fbI$!yp-_yM9h|B8IvC^2#Q~@H+|3BGNerAL6RPAF
z&Kny7fSQbWu^w9@4^n8+w{<cbZo?bux*`3$A2yj~ScXK-%ojRkf=|Yf%<=B@9gV`-
zukbG-LRk5-r)rmkj`##rc=%Lv)BYv}nx#N1mWckJ@yf1y=hk{?fA*6|@nE?nr21b+
z<#_QVDKK0@n{e5M>BGw_)DC#C+{<0G3o1~gOQbJ=GAi#f5J9e@xUb&amnud$#`c1~
zfQ1c(6(OZ=%`jUX2EMt#f~;1EK$-Doh%lBuFLREKAQsDU|M-tVnrMdINqc%HHGkLY
z-N@<uo5Rgf&8Y?4W3HRt7$X0Mlu}@Qxsb=O&ltwF#E3se$#dnL!gbQC;mPxTEuDIs
zlbgC$)V#;4WDhPJIz)gx=g@O2j*;kX#p`f2SJi{l%jSRdOwBRpq4=s|HV7Ly+Ecqa
z6ax!3g3<P|58-X|BlrVbrsb3%yQw@N>K!W7L&0Cepy4y^)v5d0WKJF0A0!M0>y-^s
zgd^li?cUy59MR$?myXka3qJagpHN1J78wcVMV14Me;m@SH}I-H8TgMi768`q_;tA2
zTc(jMB~n^U`1@=&oV1Z!fYMNPP4w9TJt~zx32(Se7|rBQ(jW3i1lJ1RGw2NoSp&3)
zE#UWtNt9<PmZCs#Y2sUsRA3y$sW14@pcCkTra~5P#B8AR)@tIP+354~{Cvm1HEA}h
zI&Q{O8|rVZG>fy0yzet=fO>|dsq;e8(L9!?bWD0kmcWipPK&M1ltktN+bFw>LNCz2
zkKWmDz6V-#GFkcCX9<s^OTBqD)~Y%z&?9=?9!xr#eqNajz}-R1dw!j2qqlQ--FOCZ
z6YXOy-IyAUW#^g$)K!K#spUn9kQR9?0h0E-#(HkP^U30hZ&A#-3AV_h-Tz^^&<W0v
zDjl4#DWcLHb7LA+`SYFk?sWOraR{yqYlbwxbQ=SYfel}P)EmGy95G)tu$8=wAkvm}
zI{Dyf>JPC)YNAMvlXpjsoRB6_gy9u=QY=Z5mXy>4IT?)3pKue^L6qHwpZO#m)IV_P
z3Y8a>fK`_fT50JI)ECZh6?Rakf?(6j$b2gV*W!87nb3_vobvNj<75PNd+>LhtVpY5
z&_bfik$dC#dKpqosFxvS%_wLCT4WwJ#BmVw4h>b=1c`fxv(>bFC7Qb2Dse(f0mhdw
z7Cy-4wp&3BA1of5!qTioZqOM6lm|Eq=>1)if+Hv!{Vp1o`MTT$;-fFAdYiaeWAL~_
z<fsZzVDGn|?1B@?Zxi4VTobfYFvI+=s3bc7*l~~bq=b9+^2WH7{?WJQmKl1&pH<4;
z<yh>ag04k<p#L3XurYMv9xHt}k){)Ti!ApvjTSt_r!DrV-?N#QUoiN8^d$ga3$o#n
zZmDxfg>Yvwc48*59FrW`8`#7xPO6v`?JMSi&X<>8fwOqr^ac_rG;u$S?A5h$T!qb&
zsIeuVy3F2=ysSe}P6Wl+jUzR5fy2vf0uSlHkR}*TUHA`U4yTH~Uk6~{?M}^q8x4C(
z`oJSIrkduGg=Wntq9Eee{nsDdMj4eh7J2fg9b5IeF+XreE~UjCq((g+;z`1RTj(-4
zR-n9-Uw}up66@xj*yK6vEWe>&Q_B<rHQmzRIsgy70>Ua3=N$0Ca}uEE;KT0m-Hy$z
zbxt*o%+HS(X31kD9+k;SCW+Mf<cpLE`Cdy#*kd2^6XijAj)c6gVeqVX%cr6e9I`q|
z8=yOcqNPik2BVn57l;0(8}((_H*_oadZ|DLVtgVtxkGRHE92!>*wCL<O@&)!);2mt
z1mAwr-|F9SR$}`=q$P8EQexE0IRU@XU_3w6{%$YLiAcfAoDfo))n({Drr#qn=!w73
z;}<-~&c9-@e#%2!8rn3mn`6AUwj)Oz6iNYkl(^V_%NilVPp;J?dfvNK^S_JePdBJ&
zxBeiC?}-@;DQnCVcI;Ay%Wm^xJxFysf2%~!Gs*Jx*0Cw+RpdF((;3x6EtQdi7!+I6
zXKspCtDKTtRs@LV53u8l&cS?XVZB5$Hli<#4piETVsz@_4h9XVKSOv@RsC@~u;aTF
z3;nVnPmKN^6lmC2x7E`lg-(?+3dZl1N+g2+ichlOh#SMo3(HN?!nIUPd7)nSa&9Eh
zMh0NYT;1*|Ra>5X?*$J)?no5o$j@lpS&$KUzy#sPq4jFv67LY^z6?-TY1jNUxmh2|
zjH#bZSu%87wjh$%Ql5sdBR#cKYCl1QaDT&lo@>IC>*6cv=&p1|1#bB(hjEzqhrCJ~
z#+6;*Ur2+heEybmdzY4PB>I>f+*s14Y1k%jmXtrk;+Ljm$GyUeW|qYdAY8m|k)LPD
z`T;&fL*db-tkWvha|`6qq0QMTJV2K=L#RUsI>wYtpFw(Un9)C*J%iYBU;4Kn1a*xb
zzxdaW3HR2F6OF}YvbAWTSb%bwC2reYYN`!%Z`~3wVG=H!g1Eb*!D<5HvORI&$6?;#
zeVJSprmP209c1{?&Ks2ncHg^A$0kKNZ*8+~|LTe;O|E)xDDgPu8{wcL!uUFu_PN(T
zdHCjCZ>H2O3B08jo*~GHMwT(3ydnPo5r4sPsc>SEo>>OEoTBx3XHb=-2TZmlV8_jo
zfw!))|9}Lru4}=7%;tSO(ww9}ZayT6N`6sM-^!AxYLN@dZl)*}WqYKR+r<BL2aOI#
zONSs#-wbmhipeOVZv<*9@`$3mH^kt4Xp?%3K?o~Cd;B_3$uBBECZfXW@^p#Swg;Z<
zPFWLlcZzIADT~}+lMw`Au)P_|oE``XNFJ>$oRe?EKXmLf8SXJ2OR}yuNL^vnN_9k8
z<XA?6iMKn`FuSo?=;0!6*Vf=&(yA@Fp(K(b73*IeuFW-I6EW@&SuBthLD`{?`jSaV
znYO>Hl;0iynA_XFy|glb{Sb7gr&{({cjq@e)JQ#Kfn%M!ZkIGV#yiKl*ZCj3*I43#
z@Z_E(Jd_c$an>VNJsu%wOl}oPe2uchsHZ`^3)yZCBiB@)oUbh1$L$5+YJ^Q=fIqw^
z^XS)2a@^Lqg3N-=QM_#?*nx(dvLs+2_55qm+@HwGu!9&++s2f?L?(IrEh^|+-B*m+
zprDM9t_x)uovWY)eE?jGj9&S8`6`S38lE(?kKL3cS7XiM&Iw|7tPNLppkfQ<dA$ih
z=LVlt#0h(XWz8BpRC%?+1qfSgpQ=c}H02O6CD6mc!{eUy3cHF0Ph~pSCB#Qu9zkB(
zA)zR>;4_;eWyH;mAQ-Y_8_=0fh>d=!%G+?G!<qq%<%mgd2%5isv?U>)-}U4BiW+Kn
z&nDtSc%rH{zr+-ND8mEn;kN^!d1$|Gz1J8MRbnfC@QpBe)gy1M8?}WX!_m}L2JhUq
zj`~r>9W=Qq``edPh(~hSKa9!xEktYsf;1BA%Er^9sMLS6qM08JCDhHRQXME+sj|0g
z)}xn5jb?t2Nt`SaDiQ;nO29Nr{cozP5E!GEeC;QZBDMd8JWk$a{E<uUo05v%F%LF@
zoti;Zv;t4?Be=eU!l(qv)g*ey+(Jm~`mYHdTR4nhl^>ULp&_!6!6e%0-UYehJzBAt
z0&^ba8Uu84FH+j?a|SC;gK?8nuA}uAAAPa5>?8BgVM_9IiZD~43N(jp>R%6h6)-J6
z3T^gz3N+D@HHPd5un~MDsj#o7rp4=fN((#?hIYZe@pRbi4X!s4Rw?+>8O@N;UP0$0
zeB^Tt$zCQKD*%;#49t8gbE{7(Ui}S#)b)1{mYc9EH;<d|lC`(DPr;2<DH@!pZ~U=U
zGlW_HK`6c&cuT__XTll4yXR}bF5l~zO=PWeHbHGEtRTrAeOQBVp6=QeE%<U7dS~rk
zGR#Fh!JQ`wZin^se+aE%?2RYZg99>I3R1HfD^VJAQJtqw>ue8rC=`fp6*OO%eul(N
zggKjH^-c{YLL@ZGmn^SDTs{%8&`9`|Owsk-->`JQi0bv>FlDrvc;9Ol8BQ=&!}uD6
zU}#}x*ErdjR6q`$8^y-)xB=HN*X@zl_ZPK~BT$EdaD$~p5~$a8k|8F$Zg$=-?ST7=
zA5oaTVI~kkndl4<Ll8gW4my5yp#;N1i^|24u{|rhO;5B2hUX>NoAp!KSHSMrkh$Vf
zN1mZX_aAawdyD0_cmf&=B3-Q{7(^?$RMMuswpxi_UJ!dgcnF&0ZUGpk4q_17MNlPt
zy(soiu3%kiKe%<1g}>Rb&y~*;1!C;Cxirj(C<@(D2C(MHX{!rt^r#!>9x$O`vPqWe
z9SHwS%H<Tx0Wlp6B;~Qjg0l+f7=;MA=Gwe<(#uNWiW5zuWnzwC*3ThRJ3)o8`(8Fo
zIExB6u#AE)r`c+V$Bngkp!l||zX%jF6m)0yOF`9n(>n|6K=6Ejxce-tWpVN-Io#q_
zh#vmA!+`nLJGD~gN})>H3e#ETe3Py7L`r9n$N&%HzhRBKPIH;|Au$AxwCVc9;RN)N
zS79ynin)WuCpmHGxBLe*;KkKEQ|}hyDr0b94;Z&W!KM4Lab?#8#?`W|>C!S6<LwGC
zx{5Z^3&TZS<hJ+nS`>C7Cgwnz<NKlA&cs-ulcUtKVT|dZiJN$XQtuSDD;4#&<<JOw
zQGNl~WX5eQ#R*^p`x0Nvn#e2wI19($a8<vr5bz<lG~i?X$D?r(QEZDkxBk50TKUvp
zGsw<3-4A$#a(9GjTjOdzcWs#O76i?xsZ-oN()jV^-3*bDPbW%}cQ`gd2Ucm*#U|+p
zevV(T!*%TViA7dyoA~2fJ`%H)><%t={t{1<XShZ&`uert{@<VQF{JT$`f0(s_5Q-~
zDe5tIZ^n633>Q~f+YR4)_g9RbPbmD{Q_DY#@taT4773<qN4wxo3qzs%w6?PkQz6zK
zQKQl5UcJ35uj#Ekgt(%-1Gfm37>(K_>K=Wj?%>+=biY$gs`mGJba;Hh%>syjN`b8k
zK?fou>wIMzF5^X{j`;)8M@<&m(hwN%AjgWY2&RZ%-a&4<-vJl21Wn?SB(bivbbrD6
z`rQkCR-rJK7^z}A_(I;=7RL8COSQ`m>tfLh<2f5zHiZcR&aDEmH%+FvO8v6%iqod6
z0J3nfyKW;|F=w1nWhfj|b(rsbv|LINM|jdZD#(<dh2-B6(6Y6T#ZP9RFZQd7TIVu$
z^PWN;3dJ>Qm~#LaL1ssw)Ut0Z>%>cK)IkY>Ug`kIn3oSIdXk42j54JFojZ4bPjV!r
z+Xg-w_N`C^F}u=b$By9QjM^DPL=`Z(@<eqKSmgc!`cEn^QPiePA}*>-)4efDa|EAD
zJpMwz=s59~rGXQ2@>^O4(E8+gTzfR`OGkMnqQ(yWUC&?sKr*n+iIR>pQp`XcJd+*W
zMA?~slAehbAi(dW;fp?tg~SOi1BJsYjm%is;;uy4=_SZ1UYu(?{5ALtsIh~3Hl}ls
zwd%s|`0!6^frF`($Edxz3Q9N3lwRL@F{%w{{Ck2dp=*GyuU&T{7B}?8)r5gU30bN3
z5NqfrsL&vMmhRWgnc=*RQEuaXM16ej{W-ARTj~6<a9H<H00lyPv77BQbSnyDWUR=l
ztJVzwU18Evxr8=|3R%%G;F-YjK!+)%BM_|(U)<acYWX68qBHt49!#qh-ypS8JxHc>
z=lT|>N&2o5QyDi{dqo1<7%|N>gQz(_0_pCq>Ba|LE{N4E`;kCrds2bg9l$F5wZR0_
z^5+e1+*bc};TZ?5b>Q1YIdVe_zZRm*sm_{Fw5pQEGl+^NY|>t0co(Di|M&c9$bK-L
zR<CopC{&9mqAa-$Fn*XYB9;^OrUvX(NY5IXBMqBuG#^0#>sa)r3_sV|bDf=w8ojtO
zQ@rKA>iuu0v=?NIhLd!vfsS3a^XajmJ@YAD((=$;>;y>0+aY3&v$j^NX^C;){H~FZ
zleC^br>~%Ce0hZDRbU)J10@2esX}K(l@sUs3hAPa`=85AeSrXW6V6jG67gQ|*PM}E
zghJ-r@uTU%a}C#B{=wY!MI5`g$?{k0#@Qec7~G~>Auyip{)RjIkd?7x+ST!aOx&2{
z6uAmz3>40S=b#-{D_2E4;Do;n0OktZ?-MR^<5q}41FPQ3k*jrS_IhS4@<+mpS|cKh
zbj)~c$^1$h!yj2oikERGg0RyrLKzcEArf{wSaT1OB<&Tx1sP@s!hLh=`{Aq4r;?b;
zb8#M94n?8Q3ldJ#<j4yxIyesKf}0&%e_ALv<ubsvpP1_n-d4!6oz@!Otz@lJ1oV+3
zi~Cpmnb9Y?VC{Pze3gyGQPB}V=9p{zIuPo)bRn}5OA`1B7I~@TR9k05tARdNy>u~e
zcm{^`gN>U+j5BAvUvR1G?bbEOG1{bnJ+gDjyT2(Zbz-UkU=<4+t)GA!TnJMt%V%Q~
z`0b8ijc+>QZI#3?4>6t7wUO|uVyhFTmP14AgU;EQE**MmXVK^L6}|n&1Ak^asuOM{
zeWw815|OB54=m)QtZxSoFvJt$8NPH4D>&4L(V8J?<Vw5n-!}X%of2}bvPnjSTmk}q
zT6tNn7VNMoJ=sNgQ`4n-=L$m=7kz!B{C6_u144OnM9o>ZLX#tcnI&8Xr<4(2s5Oi3
z9oYnYk1#^RTnR`){8}oEdrlx+c!1U|9teuy_y->td&1gC+}jk-Viy3>#=O<^z++sL
z{hOG6Op#xIZ3<{+`8pMyv-h5B8Jz0C_H|{k{HQc{H_746-i!4xf6PVRI@VScEZF@Y
zg{?^-1*j~LR!7W;61#Gia90u1L`91&@|-hIqRv*nC|mEgxb5?n$89J5ruJ`ieZz|%
z`JlxQ%^!Ya<gU_h5sN)NkF49{q@AmHFmWw=GgGzypjq$I6M!KvA`!sTYPeWZ2JRpN
zNssFz8WMjOT_C#2R8r)KpbNI+Hm^>ANQo1Si4;yqyo{QEvH}C9P^@$HRwFDzfGd5U
zi|2t{xJdkc9nw~<RPDwL;{h`aMu$4-X6sY0bd0Z^QhoZ>+U`m=63eAfaW-N9W{K_^
zL?<;}hc_Yp0RYAj(itvyS*Ox_Kthf;Wx2cQRc2ebxe#a&BuF7{TI*`hD<n7K?&{tt
zEY`LozoBr4K3nHvc>8<f3DyN-m}4Z#?st71{c^y`8P!CN*l*!P9}f_I#Cq4Wfl&Fa
z{JY)%=tX)MeAeWP3LkFTU)}j-Jc+#3rHbSIiSJZ*oVA})tBR9S4Us_SsC|WpxbWYn
z-kr{EI8iiZ4GWUtklrJfwYDpX`h}>O4yxXOd~UoTCYAlz<+x8bQH?lw%J&}QsZpID
z0VsvitlnKZy(|0-k{_b<3i!zejMi{q*B~#23GTa#MYm85_)F||+MY$bel?WNDq$my
z=pt8vc0gXia9k(w`*J7Tq}LO_lcng8eUGtAvCzt|GaR<UyXQ`yHd?a*fXw+u0Z@x0
z=JCw5X;3v31adp2R5IIiVbDg;c~Y0$JHm~4#Q=V9bak>-1-nd#8)jv@*Ee^l`YCwt
znzYFAhy_vW?M%5VOLHRBK|6$IVBv=G8w=u7E{6W_;F=qhx^-B%)_AnLE*3^C<MKv+
zgwYmQ3pFKbiAZ8QwhHQaP)J6ooO>+<o`5%6;8cInS1AZi<QFlqENLd>iF>NaetP!u
z(Ga&$jWXc~<j4R4l09Npi<rhGl?dw;dzJUcAQ2(vP%&w6b;Y@m-X_6BWhxbanh#5K
zSyuA3wuG%~PHx-vlX;c63$kO2MLnb2B|8jro+BwLUa-30uLcG|;Hb|#K3*^$<@6dD
z$&e6wC|D;iuXx4PX_s7cySW^d78sGmV&f%gsTc8I6hk1H>Rx=o0E}361YHWOkW|Pv
zp8#4*=_qb^Q#gz(dr%;0=84t#Z2vIp1vU-&7|ABkF13@HI?jp9YO1eF*=DVi>$UBr
z)YJDeKObt9oOa)i3)_rJLTdz*^hSaW%sVw}uh6jqmIo(=TR!8|{Z2V#2S<7#`IZ|w
zH3aq`NY0cV4`8v81u6*3F_)kalANj~yI_~9VWDBcJv<*de;O>i#Ab<7`Fk_JCV-0Y
zEL(t?DP+Lw-n6?cUZ&o9d)}^(;X_;^4#6|DL!rmt)hQ7pNtHBLo>U=%NB}S+P%Xwy
zv~%cN)oRrsDJ){M3x?YDkPrQ5n6|7LUby&;Z8GqA8Oq2TP%2Gg!^4$MQQ#ID;j<&)
zBGq!ekmhsE8h8%k>#RVvU$`ypQEtolR&}zU9mMxz{doiy7Tb`cM|!Z8%)dACf+xM-
zfGlDJ4WqLk#Fkzgpx?al`sC{-+Ge25M3em>vyKwd=;R$-K~m$pl;$xxnxBJ;s2haJ
zH1isS_TEK+ne{`BHUb&C>Vi%skThtGWVz8bQUMsgR-|16oc_LyOYPs7SJ9pr53v>B
zzeo=OSe2G?clQk01+WJ%y+zo3OSKBgRJ^alI)GHpp2%G5N~svLWY8IyWpA?Azxq$c
z<D%|+B6H2Xri9o0>X&BiX+#x2?_C4F!~!SK?B5xNZ*@M{i69}pPbOcj&`gi1K+_=2
zrjetRAEsduGFm*FJIo29sGWVk2w`mik3)C`jK)OJKj-!rAFKTmwnLRPv(wg5Pj#oj
z6VO9V_bBA%Udgv<{|fGm!6mbz<zD(ss-NjmxRmw@DyjJ+^FNyN<8k?-zd`=O3`g$F
zM-K0Jr%&hTK3tN5_kUOsIB21dmt|Q6uR~Adhoe{sRb3%T!=r-E8w&%+?xWLc>gVfl
zedHW|Qd#AyyU_|N8{_OGs#~_9!0)lZOg9Peg@6D&Nv*-vtcmC$YR{cUuxpli7$eFU
z+S9g=aAw?|Hb3^Y;Eo;FCM*<O`d&y8TAPorr`^r)EN+0uRnW^ysFyR;kwyyJUYvNI
zG`3j?h>8vmXrokz@I0fM-QYAi<VCNUa|u4aR$i&CuLei`1aRVKMh--a@cvioW`^}l
zNL*`rUB`eZj5MpLALb}`DtGn)(!g}{j@CgV9ZNHc<)<+ZD5{JMK)yLR1-{V4&P?vk
zF-jh-2OM8E-Ade&)iCq7tsfU0Jsi6*lpIWT)g;qY&};y=o(?IST=sa2zq@aoAY^%Z
zxcM1`BO{sRWyLI=*}B<kCN*HmT8oI=XIb6!FA?y(0D5B@%KIm7@b6+lspe$N5Qpe5
zzdNyUPED0keZ!B`6tGxQcsdW6hFyu)ci%i3Grq<<u7DG-Ex5`?KW%z!c&zrz#n8o6
zviLAW2RZXwmY;VpsM6&!JRoDmmo%#Aic?EF*t1*%#v71weopY@tX@%<^Xz3nnLxM6
zKzO^+39igw(=wF^FJL7s&1g}_4=cEGt^+vO7S%EH|Fd}FgAT0T1X^&=(w>pzvQTM4
zz!BqW^A+ewqqBVI?f3pr7G{~DOk+%_&u(0{F3>GugDkHOCo&x>MqqSi26gN7i5#nN
zo_xp~DW8)W&@rSANp!h*!;G+<H;_)Dgv9|HYTH!HO>ABVQnDM2u^+P(CkAkMiNuex
zuU>3&o<crdi8eJa*7c>R?d&`oWw9Mu$ol@9fJE&Vt%JJJmBPkLZb6B==*Rw@q`kap
z$4KY<g)<UXW2n$frr`e`(K1tRx)zq$AkL$ua6F?B=>la$(06@sWZn0pt83utHX4G@
z9h)A*&S#KHc_ERvjex6g%P1odIA_oE0V8%$hSFmuQH><|ocYLPr@EP9$PKvBQ^xwL
z^Za3%!_IJQ0Y0MGi7*la71us5g9elm<y4955*}wU0uOeha<{z4x>JcOIaaaqQz^v&
z__d+B%!^)RdC^-pp$Naxk8M1xs7z=erXx+($YR!wl1WC&zrX+rlcYYEf#-A0Ms@7w
zOQC*}<8GY_3BQOBInGK3NuojydK}@#Ys8hY>E=g<jlg53HHmJ?liD>Qr7^-{ItVik
z12<mf(#<Ew2y;T9J{51$k>Q2AT1DOj6{%ODFnsB>$X{|oxkPh=%}yp0Rj23l$ia-=
z1A*}4_1Ulu3EOnJq@$a<jB^J=01goN=onvcA_CdHQU&-HEbl5V)eSTnhxgP42K$tJ
zdYrQFDKZZYRYb^tEPXT|>iVKYmE5}soU9g!j%`p;Wt9vqSKDFE+UoaF0IjB^J2ky~
z|1UOjamJSA{V2B@ybA48QjXSw!$g)fJZ9y~v=>PrA+M<Lg86&>m$e~JrF(yTK@Y@7
z&t42i3?x-ceI@beXl>i;<D4cVws_QAcl>&Mw5ftrstTLP0(4?v%WytMlnIhkyL^Dk
zHi>fSsR&?z?Ff^I682;%fWktw4?~0JizdO@=U&%$_XsnX!^i<kUX{bWfW<RSrwf{J
z5;L+;>L?MtegJV9?kRADF7P?j;e_0iwa59-G?~@2L!$DzHUp$;bz8))8MpjnHZU_o
z=QRP35`QN66lJy-!n$LxmWvFNMpjCcuL`z3xxZI7QB(+#jmlJ9)oy}S{EVpM5h}Uf
z+IbIl1DwVi!F<*N{r(mfwgoOEO_Pok(O_zJLE8ZR7h;?bL3BD>fx27V;+Fh3RAvbb
zayBtIBaHbB?m|=1>Z~@^pVQxty>{bFO_(@^!N9$;8_q^K=aTDu0DOnDeyU!hbv<q(
z{X~Mlzxv=F4Pf_Nswn0h__z^2hucbC*L6S99e*GSeDKkSa{q`h*j`x)_Fl?#>9`#h
zGQ*Dxd$Ui1>074tb4}!+CscBSi>SJm{He+Q_0{jnMR<4UDZ=b5!LFa>ngS;%NLIYj
z_^7Zu7G3vJ*G6ax=*Ul<MDLtmP`hp{vrXs&cT1*=CzZYzfhhfhTN4yu3fm;XEKt->
z@HZQob4-W;rcSPZa%VPb!|k#3yuG0Vl$R7eC19wNR?wd)M3)YZL#GD>H_FKL<mgy9
z)C883txAo?Hu3u%9W77($5z)%n3aP4ZquWYX-A$Pq@9{e%7OaE4Y7Aq4JvrecSzUM
zz}&g}+p`4Zfc{})aXy_?q0i}rx+N$N6{(lmZTu%w7-6j$`P`JKU7i&Gw544eKPvog
zp}{%xEjep_+bVG52c)>uX1u9nzB6@a@{<x%3p(Q&RCGWjwUA<4^ijqK&C}VY7bUF*
z(|_~XzqCrGDQn(5q>beVbtbybS?CTmmlYNXqla0cB77Qn{!n?nHAsdv8zR&Vl!m<+
zZFLf`ioWnP5v%sTk_aYu@v-dxffys);T?ziMpXSYZHxBQ?*e>Sw5bkxx6US%>3L1p
zHv2_pver2{#f#@r$U2Yci^964An)8v^N4VX;U#nO#Ez~;o|3U1PSvsp7U0~YG`cwv
zU^fPQG+LKB#qC@jHWP%i6@=~$wU+l=kF(|Dq{?#l7e5Zzkp4iP_D{f#4tn$(o8{@$
zS{HJUV3dW!pwYRYg0Ch{pJ9)lo2B1{_*OW>Mps3BI$@rAlFldb9bo4Pb%JYk!aL#l
zcG!G#5BFo}s&T~$DDE^30t@n1WQwh71~=L(&HEE4!i=T|*nRiw#~){%P-OmnD`rVg
z<7m>%kS=<9)#vo+e3pLAJkoE1@AELSbZ~*|A~s)V6xy|AJLFQZ(A0V%EjeDM`~Ccp
zDcc*Y{Y9Jpxn`{8+BVO@=b#-T(uF^D%RP)O*!NH~5QIldeZZn#M?|i!vcg&z#tH7o
z4g@1gqplX<spZZ*7d99DEEaY%UPUKdAeX+0y($huhN&$EPNBjY%V8i!6m*qwB9TEJ
z%|<-_VMn9r?_sX_8DPxWd9%DN=p?+-upD?WGt*|#?dDI&silw83cUlS$R-XeC`>*u
zcq!`@rgdTG&8W1jA_ny8#;QvgBtkN%jG+{T+*?|u@<G8=2{mHOgcW06LoGfh52b#0
zA(dp+>5$M_4(VI=0F3b|*r^m<SS6o|`BU($ogSc-X=qG{!{;?RDBkwT$=A8ay_qzo
z?@+r1@Q$||FYVYdtoI=Z9(kUKKp(wie!|n2rTV6E){TD^Yv+AqRCJ{H>zWH<*949e
zr|cq2Hw_vVT2nGB`S7y=ZVor%n!me@3+2s&OMulOdnNRy@AW=P!@~%`@n5q=6QQDj
zZGki%>2t4sfiQGAqR;AY{i`ElP=)4Fx)yKItm~l@h?C(D8{>b*4NNNtSEW^d-VP^s
zix<F3$MLI;;Qp6@xXvoqp|C;jgoe8$xfmnwF+u-uH?<>d&#0J@ril_zs;P?t^x?ly
z$HaT~An+4Lq#Ppkly(2Z8o9oCXa2u!_8!arcaF$GOJ3p;(yo+&w{7r=^fAZ6<zD+|
zmG&Mv5S|j57Lr9askx@eLL^PgBf|0^!cBa+l{(5%cxeC)@l0n<e0^K7cm2}1khSuo
z*cgRAW{<vHwRAwGe-4=p2|>sH1pMnrr!%e1f8v4B9B-`gP%Zi@6B(x_ca!Y0fMkSU
zoXYXz;n0DwA(v-k&Y+%T21gM22`)+692>hM`6?9qN6kL`U_LDlT08JbhPoP@DObb>
zQOcl@Cnh*a!#00+q?s`zaTsj8OBhzlFfVn4mHf%BQE(?^?%U2ShL$<L^}$pUiz5i?
zL$pGzMg>@}>%=dG8#t0gV0=Uk3b};G^Hp<M?`|t0CutzEOd-I*_`G$1289X+82F6Q
z)x($h3de3w`>bz9V^p3byoHK9<9YX~=9GKGxT)n(B(&-kgA&y3w2+oZX#!_1S09k-
zSr*R+-H#Pee3mo~=4=S{CD`-l8C1BH^=R!_MjZq#=#lE0wEDfR=U9{dxm4p%4ALXI
zIIuHl568F*uk`_^aCoqn^n|#>wc3N}xU4atD(ICR3<X<gzlCaY=AY~OBGnd!5H;g+
zWvxci7Pc|6SzlLBM!XFOK9WEhbPAdHyLW+k%B-BtQNod>>H3B}Daz6FRydgHbz8v<
zm)E)E*VCswK9#RssP^^Inj?PVgaF(%j}qUeGQljGjkyFcAn2F<S?*{Kru%2#Rizw!
zms+^MTl6=nC2L&Wkp2q`Ydk#D{*oX8)NojN4nQFMe3b2&YAnAb#jVj!U|DSLI^qE^
z6-<Gwe^drbMMb%Xj*EbSjsXG6>;uG2r>{f~*2Fj`|A!)^fORfxKrU~r4kfF}6KgiQ
zW-oa|5;{hf6a#gR62Cqps}l12*Qzn^e{G`S0(o;AmTaWH$n6#YUzRot`fdW_tCsEZ
z%lA-K&&HSy;m#kpX?y80qwE@&bw8I~vi`hjxZIB4M@;flI$CfC@ddn_2=Wy%ulx%;
z9$%@NQTQcKy@GFzVLK)IZZ2b=c2m}aAVdsO*0}Z78ydkgTa@`@tb7!2oD0M<Q4Zsk
z(0M;}1lUR5*K}nc0FQa2U&nJwu>R^cK&%L&?8y&INGc<f2f~hdU+mqSO-2PwLsg#<
z0^e>)9(}~-QAy5?xr55S8(+-ZX!`ss4?URMT(@?Xqk{Hcngr-4kRc2gk-L|fE$x^*
zHKA~}S8kceHnw21lIomYE?xd0@hK_M<lvDTyNXrd_OxFi;rsibyHd4}rpPNDiDC2^
z%+aY@Y(r3hMudAmq^fDlPy~#_WpusW=GD}&IGfeg9j-2ho9ocjs@XcbtLn2ob=H|0
ztopUE7o^>1=6eSlfp|2t$2nfpWM^BQ`imQ?rAJR}#4*OM>3cuYP4->&<y)LcU4ha(
z`RYVuiYd~mC0$5mDfyHg6Ir2371gClCu#<%Zmm)oLV>qg0|ujC%;HTjR(xWASP)dk
zWyypb$&JxUy`vh72}wE|Fe!5A^dmNQ*>y%W|Bz&=q;oy*iKi*mpDH@o1a+ZBf>f4>
zMeI2)B^^@0(;=(~dYf+nv|PDB&#L-Zh15h0Hm}j_dt(X@sEOZM8tFn~kcVwXRR8D}
z@un>yCUl18QbP|{Wfw!i$%|@iKj@+Xn*)(s%Uk!eItJ6xLnOtR1g;3zhcY4-!GmfE
zg9wEk9>11c(Kr?rZ*d`(uEL4_FryX7b$sk`NqY(F->5&(xF*^e1HC?GN*R!yOZ`$Y
zS0icfpU3*P32BSEU+Wl4DI%2?YEqgI*G~vDgC@PjEDO<!#&-k-$f?lETDa(<E7tYD
zoA(UbHoMXbcV};mnqHU><*R$)ct$XSLYI%sm&^@YUPf&?mZDlM4Uy|9rcygji!E>6
z9;lh70|giAzwvP+6_h^R!?3zX#*f=e78%mJCVEWS943CJpbX2l09kZhz8TW^2DdZS
zX*IaEKlqwmRX)Nj(20e<SiYxC>Q<zjP%K40AHpGfCC)ZhBDEwc;+5@(h5T-0mfA+-
zwl@N*y^?|oS0mJ3&igoZW7-RsCml?MQ=U_*@Y31g$xPIeiypS~|4EPW!Y53!w3}Y+
z|3sDAE=O!wsS#0)Rs(4!HZ{;AymO$l`Vh#TPhJ=8RxY)GE0$VO`bZI{r4<TuHmhks
z`{?t4J_BDsvLyu9aE{O1+2f$?i(2GX9-K6Cnh=rNvB<_H4#v1*Qsh3W?7Qn<wdYt6
z68zD0J0^olJ^F1S@25(y+^FpI8NqESV-Fx3q=vnb-%7oGChoUQmPf%<Dw+3SymFQq
z&tr;{mmdq4jwcw%q73RaQ+8=mrOiW}hryBc*y6r~dHUcd2z4mRE#pk>C9D(xtaDN3
zch<lyZZtj?$MTOWSnZcNrMIEpM@O}(DoM?NGy@Zo(MVGZb`Pz~*Oct3wgk>5j=yb|
zxjcD@KQx(j2cY&5aA($1Tik=5C3Ga~OKth3RW*&4zYBKt{OC96F<#??oU4s^9}V&j
zU^jy_9{vys4p|Y{>>^!L@V#a;jf>EVC7zCQ!yI<YIj0You0eXngg2``m0(&Zp+O#;
zfi0B_!~Xi%FaX|!$XoyLbJF?P;2<l@NVZqT<XQhoj9tZE!Q!9G_g||_=?R|5H-*Hp
z!7DNWwleLT$)?lGTER-{SF>Bb!POqUS|um0h!o};L2k6Geji5~EEdBZ6Xj0oL)kq>
zFMCEXeYa^0yII3;>gjx$66;+}MXV;fIg>itgR2^k5h9nNu`@bmJESkFIhoy>x**@e
zCY~l-Fs4ItF1k=h#5Z#f3mJ=}K-gQGnx+lFRc6}|N2|#364mE+Cc8rQZ!aPc#_0jB
zHx-Xx7vWV~x=K{W;N!LSz6T#QtF1;D%2;;4QgE+x$SiB}z!A)-O44=m!}l^*(VVL=
zAd0AnS^}(>S$1*p=M^zHMOe9IJa1~(h(c9`Mv8aU;>gsy`?k|sLda8sJ7cYc6jCI0
z?-gh=9Eg<$pZf-K1Lpds@{do|DT>KgQ`(yPtaOHA&E=s1;I8b_@m{VP65=;N6w3Gm
z;!b~Ur?MfskQzY!K4Eg<B}pM%&l$86*_k>Oits>YdZ7ORD=7JB=zowl-w7o(o(=wL
z(xAn^$E8Fxoj?ly_n-!7T0y6#mtx2>FaAJR2@_q0DZkS}!cUT64dc}}t`XWZa*aYf
zI+U1?606QQ$+-nVAFmrhp)x0UrB^y{yT4kx<<9ajLoL^@zgoZwBm>utM^}^^UH9+g
z$Z0Kv1Z}S+mYXyy!7maJ1N0wm$;%eJMi}Corv0IuUnMgmDW}2n|HHA0@!h72Q&k=q
zfp9wcGWgiHrwj@4=;ljm(x!LaU0I!P<O!;@chz*Zor%Dhn`c$AnWW#Oo$w=;L&K(w
zYA6Qo#!Jl3x>%WtKaO(ws@;%0b!S&Kla0Ph|I@}KzITC|nRgGhE7Y8ra1ixYlIlRY
zca6lCnf-7FO9Qz6ocR6Nn}qPF{uDQR3Bhl9>{hUoI@2mzH9roL9(p9^zN4eR2*Y=8
zf<F6bdDEB213p&OJPiZB$45LKl(>BMZ28~5Ed@`NG^=*8T`H#>-<<7!(a69M${vFu
zlm{_UJI@S$U8LL{QTX{ZW`#Ph(evCZVG7(61u5(GTpl8Dh)Ww$azZDXj}hgdABKc)
zPc<N<c3}2D;3&A_Z8sA1;R9L&`Y%3Y-$|*lGDY?O#J-t$rvc!<TUvF9R}Zl0eE{{s
zeRyGil!{i_*Xc`lS!fJ*Q-oZI#tu!hc?_9na)YKSzJI#rF7$%7PCyNy!3Iu<W_mDg
zb0BgNfx|)Tbz~s_P#QF~vCGjUxtOoLVgRd=k4sH8K`)g0`L}{)UxKyK00%9~sM56w
ztKvRPL+ZcuVGCx*u776Vq}9nM{rD|-CFj>_F4vD~z0e!CscG<0Q=K#CaRadg2og3D
z)i`{JRRS2OnlOP|tD6WJUrMVha3RjSQ*sXC%@=#ue)D;s9rl*qg%Tuo8kF>E<zp$o
zkCWwYwb7O?%XTWt<1a~R-C#Vg0{098sb(&RpQax}E(%@m`_YG#C+o3xr&h6bdGBfe
zR9?dCe!3`q4X4vnpRu7Q@7#b<8;=%5Uv{EFU=y;=6|pfCMK`t@02ju=K4T@CVoNb^
z5<5k3-<iVAmlGR*tEMQLsTmV*ohIzK;gDLvFL!rRMKbJC39vssa#^RQ3L^sBd)wDl
zH1P5pG%WUh>FpO>5+UnHS*UXv;P7RKMv?46)wqku#x;wsJDi1^VTajdrAy0c>_KbY
zuTJ9VlRt=^zi~L%d5?QIs9!h<(9|ghttsKbT>ER_EIwLmP0pqjVO0gu=!4GZabOt}
zyt+{3r8!Y4Z4Yx*mgBq{eYEQvvn-f^7%@NT2RDFcs$V#SF41wK(2#46e<2uD?LOBF
z-XiZvysB@xavID&iCD{bnTSB$no#-61#jRMp2|=>pY)EOA@@v(YyIc+POSQzHovdK
z>azuVHX(5Dx~K%Sy3u`SEtIL&4o^AIT>T=wM!Ly4x_jXxtkp8{6We6hD8Fi758<Y=
z(=3B=?z=-WW!S|ou`zapBP5_;`?7e7<hYdTu$)9>IK0)`m=^8e(c=j$HJ;cnVYW)x
zU)({DAb>Z&-}htMGXGd#dCxdU&J1*VN3mE-LdFuw7ytx)+w+L?xN<UE+;CFqC#UFE
z1#*jJo}=wYQ%klapO!UR#ovYjvbfZxfkBeYV;jKBQ-f*ti*K*os4wH|W=H#17Ojzj
z8XW|7l%D8Ak1bv#9;YnO(U>dI@gpDj1!z#=3Yr+EaikdR9d+1Gr#b_c_#7@A^s{aY
zJ?tly+9LURr+3D#@wxpR?b~n0hLj<kbA)^mrYHDh`)`SZ!Eq8VIUl;qXn^Z)ADyc?
z?=$0>GEST`?^1Xll3HX9NS3n}U$K_qULWr6nosL-(cV9YV?Q)pysctGLn<aG-5k=p
zmi-*?2W-ejix``G9NdXs<I|38U`;YMOro_EqeqmkOEM;*_>Hie!t7%vc$GvfjJ~u_
z_pClA|J-deH`F6vu$}8XdQuvajTffOG5AYI?cbYG9*(9vg6m*o#exCr*FZV_m{i@f
zctV3g%~!03y1OB3XhWTm$enV~k@fuDkEc|&bZ2jybPX~t=YbHvlKfOqH+ttuI6~ES
zK@Ao~>V@V|&=Hflw-_fS9hzKzDIqN_)vGVYg^<Y(D~MlYy!keCg?R@bZTv0Klftom
z%)VG7b~ZwPC99bwh7?gy0n*Kd3pR#SV7ATg(ATi3)iarM$Wf<Ce;G>0SFkn_Oo@C>
zr8*2i7^D%NoXMdR0A;`qQ50NZi7D6U3Dr~wjatCkZ?ua9@H$w^bNx7GlH^@6#Ou3v
z$=|#Ab3HJ>lzh7`QuHB7pbyT7a0jPElt=DOE`5v^G{-1|nE@?=>Ebs1{g2G1bDE6)
zT&SKn*dHOi(q?tA7u?tfAxF{X0M|>+Zi^n;#8n}Gfmu#b)Q|QyI(>6}?S{+*f6`^%
z=JK|bGx0?8g?IgzN9H%52y(HB{>8Q8w{b4m2EyrG-^i_*bc#ypUwlTX0Z*&Sj4+n)
zdX6~_S;&-cU52a79qC6C-D@w+pH7r|XV#tSlA&2rwj)a4?O0^eNJ%1)>k9F6XjK+O
z4@|tU7_cYk-jvc_>1mgVwdYe;w|EU3fji@k(^96CRY_qp>orl0dDe!%`Q7ERImM`o
ziW@wq$|EwC2S06%Dh>t)JD)>SHlcgucPQ<eplG^<x1g_bZ8ZjRk^Q#cNc|l(D?8~(
zu*Gb|iv9Gp0P+ykTCXp6_Z=g~pxX$P|E;~+7kHF((_XJ+Mm#O(iFSbYWJA*XA|v>=
zR~b{KAw?STTG^hd6IwM^&aJ!j4bD2InDU^K@w4;XwHkb)fgLkuQLHYgUlY-7&)1+w
z96E;hFSszr^zwb*>bZ!H<lxG-fNt0wP)K2qt?;7&O+d20ozqYi{?beFAB~g)_D!}D
zDFxHR0B4iYc8`+!!A+4OvN#?LqZQgUzDB^E-F_VWl~u3M+?$yYw`CwZUVQRx4u+GF
z|2WUR&mGb^gN~!Qcn{Hzzw@M6uv1J#nWS)&>NGdBuOF50ko>KK<%}hGNv+?Qwh}SN
zq`EwU^DHYi)aOk8aN-hoc%0@}e{(DCZkp?|&=0=#viDAbt##z@i>JuCSAKI5hQQ)P
zE9WD)i~LF6!xX(#c@k1!8H7xf2p`2g`H^(pyBltYsi`o5l;FP0l<ofZH;6DeOv1yY
zn?m2>CoKd#cr;1MMq;c~zOVI&IP3AS$Tzr>i-+d5W%H`0^P4XsEs_rhb;)OP8U~Pz
zSO<_&^j349dzIBUx@pm#ly2-PqIO`@!i>;S<}zi1gIH^I2rI~*$*{LekVpV)nt-x{
z2&>c>wXo|q6y0=q-T_|<Kt|RrP%Zwv4D;OvJ1jHAvo5VP+6=^E8fjcei<?CiRi+1a
zB2!@rUPS3THVX2IwZ0I*o}H0p+w$zhker#)(g{HDWn~3$IORazgP`gR5(|R?C<$_I
zB|v90q%nXpz>#fExE+jTU`eW|pu|yPC*s;z$fir$w4R)fKPO0~PVtoV>{iUbuCvR!
z9!vn)is%;(2#OBN6(M(!mV6`jiz3FrRd|S0#cgxY8?vrjWJ#QopT1x~u!<aPHF8hn
zzLQ0imbW<@R}#+H#;w$vV0McppJ}XUSf2T6*efE!(6gVXALZT?I_{CYAXCG7SIO0p
zB@Aa#L}Y9W7%W!Vf!R;&v_{+)K&MX$J^FJU0k!t|ARthCX?khHiv4}3nJ<6B-6`P|
zo_>yxm`llo%P0>3%#S#-a~jy^rt3-vVckWw<)3A;87Q;8KUr}bh`Ae!<CDm)$+b&>
znjOng^RG1g_}{vOd*>z0L+IKZ4nCB*x0$SN(}j-oR{cJit)tZ44ZY{1J#q~?rUNmf
z*28XtE(weRs~{9%Nr;Esci;HyMv4D2IWc{N*n@%$J~=P|C=d<DyK1Bd)<xJMy}%Tj
zy`az}BLZa;74ISma(-OtwsD&u+F*<4M~_1P`E40k{|LtE==eAc_WJ5Kz8(A9Jn|eD
z{N++6b1{xqJd+y`P4XU*JWGOl#`%)$WEyv1KuCQ2P$I;)Fyv#S3Qf;rsGwmR!zfk$
zdtf5(^+E$yX(hjT3xk<X%#!AAdYml+(AcKw&X$^ZbKLB<aAx!;Ia%)FY;xD0xf8En
z-)>N-ct<CQh{8D}JuHufwOw#VIfw_)Ay)*sd(^GJknc;X4sshQQO~BrC&UDXiN}zX
z$g6o$gq|bZ_&1f*)CwC>-#EF^sRvH+4qm!118wmhC1O!gV~ASkPHe^C!X~W|o4pHT
zm-J@A8vXuVk@20J34E52&?x$+t@JX1ElcC&sJ3@ked2p*ItY52X*a@|^kuop{pG_o
zUS(VZ+nEMet!ohyFhIGRIqX9~#(K&!W3lYqM3%lrmBK1&AbA!IV#2VCP~Jx`(P@NE
zubfVVs37)DY;=D3te=9*jAinrl9fiHdiPx({K)#2?(w$SVvyIjL2h&@kU(50P?%`*
z44~sMT<(fffA0=}gB8W`r`<tez^hff#mi1v<uaOdaKxXDMNEv<l+oZ3jd+ZPvi6Yx
zW(UkX?;JU9O;NW;Msr63m<(XsM_L~Tf#RFK^07R5&t+tmBmyaSn!UDsv9uJTw%aDv
zBZU15;#@Cqy-7pdA{VRUAssx$Cg=~=SJ--$0GbcxnbS9_WB_Pf=HQiS91pY{hQK{h
z^$5}rgT7d~m|S7!yK~;f1hO+dT;q5eCEVN(zX<NcZtAbPHtcd4@nPl(E0g{-iTiug
z3|WQP^P64n`wWM-H!YqEEzj0oQ#~<^mlx1Ls5zK`$19QC;i;Ed23vq+OKBkbEW@*0
z=>{(ZDx^8%Gh~+^C`;bnStA~F-^oWTAWO)S)BKhy+pANambUGe3wBJQQDU+|Lw~Me
z)3R+2JmeG#^6pPS1sS37#LFy5<NjZ<c+)IG@N`e$Tz=`uVEA9d;-t$%gZFeu*EVW_
z8<?5bz$#|Va6BC}pjhrs@T$S~#;j;&)joj?CMOyH#Rg*$c$;(ZwAPHhv4<Vxs1zg5
zA27)gi&XE}G6Km}k$9D{ndqiT?V;*~Ea2-zuzWT;(K$Mi>uqtlG<EAgQPA_vzeu_#
zD;b678QN#7L-C+vIC!H7Ja`K}17@eh{x%@o8K|pq2#$JHS9l;wURAPAT+yGh>xE#N
zM2)AN=4JDmpq|t>??oNsz|V+Hph-@+2m-YvWVCh2BlNt~(qN7M(5B_%Y(--}j&K7H
zQJz%!vMNX;*K05E>>&N2CJ$^m@!YP2_woDA0a@K}b12|BUNjO<yh%%5W9vfeFdiKH
zBpCGC*#N%JD_ylFUMQWy@_9%AHF(C-4#TwpQns0UUMo$v^zVBj=zcKRPcWi!_ynC`
zleI;+>W?srJ|S1$&r@E%Tv9(PkkTtFAOaQqUaTIFfUQg<l(alDI;wCuo@|h#h*W%$
zKmerz?Z7F4tSkpBzqc;MgB3xxWoP9|s5z%Ka%8}U92N<b5f$lN%=47nfFFbLYF5*9
znpz$vLE=-J_q<DJPW2+2mgA4q>P1H(@5B=dGhJrqDu{KVM{;mG{bdyQ)OJyRMi$`I
zmHr4c^J7WQeb%PlMU2FsZxNSMwN6S${J6S@YiX?vXB319C1cMT2xBq3au0EI_^JZL
z0R%!uNSEBv?mK!ZY4>O{r0)UYwiPG((Pe*&>uTqp5Ijbfk_nL0M@`Hn!$??0d0@i$
zlqdNf*!;SeG1zlU@tN&0xg7>FzTDfHc}R-&Lg>CmDml(#s!f^>?Z`I!_^Z#Ea=*F2
z-54jqW=sxiER`OaPTvq9Rbs^38rXi2bqBojLH{fR%KG~6zzX_jZyRgpf%glck<ap|
zOTMButx8WZ2|%gZRq9Ku2k>&eW5)##LGQDgQA3Z9LhRO!$B1H8M@GX~Q&TdKSj#x?
zAX)sV_5Yp+H8tvVAyMVmDl9Irb`;~9h@_H}t^H!9mWy@waLMG#zVPzfY)NgS=Q1%A
zGUuzAR-G94F0h2xMwa_RT-zewbxEd}e29<JWk7YuUuS(o4JtFm&>$r`tH5{ne!`l5
zowueXL=#do%Iz%zM<-a*7lhc$eF;FnA*!F>h4a1iIi8xFlTF5p!cP~>0fH5)qWF0_
zo;|QFiVhbM><XE`rxtW`Vdck9VtZn7#@FUgXpk7gtxu4I7P|mgJC~^|cU%gv{`G}+
z9Q+ar;|ygKk`RNYpca$dqq3x;X?3B!5!3tT8q2r=+rW~ygi#>N0No6`O<Yfl(aW%*
z#KxciQ!%WKCkjL|uAKpUmYdU)bT*NN{XNw-Kx;Aa{stYGX0AQ6Bs=eV%cank=)E}=
z>121iJ3Kc{4Hu)0(Kcy*g|D@YABF=$5VS@B$ML;<P<WIeA(LcddfTV&#+dNU9ggHz
zc0LWhljhlWsfIW}{zuG~#BIP{)||H8)~8X=GE+AX;Z$1@%DWynBS+m!bH^%!_Uw?Z
zA;)eUptddv!VA`y_%zg<69zlLIxW3(ypd60o1GmJV=N~R_U|j|Dr_ttqL_ADa-nSc
zV}e0zePVql8k{Zj5ZT5D>2g96BaI9|*zP9#@Nc48Erp>;N9gEMygE`!)vik2s=)+?
zq>a?Kt}N<z%1(%j@kXwWN6owU^$ZVpOHlz{4vis<9f@FB_50b2s@kQoo*fa*#(AP>
zxD?CG?_sO1po{3XYbw@KpFXm#{jZ*x$S0&Y9b^Fwcb8#87dp#5$anZEalRCXVrLZ!
zUCZ<bQae3aXY2cwOJ2kjT*>0aZ1)jVrz)(bWPc1!9ZZodx%0ZoO}HDFMigfuUTX`n
zDlLKdTCnYJ1&PvmAao0Zcv7f5;#PJ$>JJ6vjG-aRoT<`C-A!pqVG^eT%~c80`^_89
z=Pdbz$&i#e`_3Wx+xQ$|jJ;Me%5PG2ObY@4QOuS>mz`B#P;rhxp;Ai#cJaQ^Rcy(F
zVBFipJtWpgN{78^H_sKS`P`>_Jd0gQB~}F%Qm?0Ir|~HKmd>_cNPelI^0n=p{}!|I
zm)V;MwpZomm&8^lfWVOUbGkXKE4GI1u9|T;@8Ln);m?GY!btgGyEwWM5rc|2?iq(&
zDVh)+ymO+Ml9B<Iqt_vRkLX)ay~0^KWpB!fs>XOZ$-dBwp&V18fbwkqMhSYpymAB-
zXRbN}*jc^aQv?)W%t^&`8@TLbBMgV=R+`>LGaK;oD#(^W{kM&LQb<QYN!UYRMSY+r
znH@%^uL<-t80tK9C@?foag3UeG1o^(81-4Z<vul#E}M$ef*nN|%Pnn+50M-*2GkkP
zJ>3%2nP&^3qnniiI>}!h2{05`<qeq0uQILAk1V*6jv+GrAq(M5Y{{HO8ssO<vBJi8
z@)LVZ5O;5x_FVj^zy_BE=HM-<?}$dYUk8%+lfKREl@GUTC@3pV9G}6W(s-aYN%lA^
zcZnMM{hyyB6W#ZoMh~K0`fHo6Gl%oF1o;Px%&*F8j**<IhBYYv9Vzgs0z$!=X89+P
zqxx(q7m_)&v(SfqKl!U<9BC*wF^zBhQ~E)D9zpqPO5ymSk;SbK*Q?Iv(sQ`j&gDLO
z!!QR2PF72W+rQ#7DSVu)xHLqOytK^7f?(e|w^xqPd54xvR2MhMUrCoW**ueglm3XT
zLz4l65Mwf<+Nu7`b)id3bAEAmm&GK~;cZ~jTd-kZF6DTCd>*W;w#9$(_~T-xlrftx
ze~!twg$;@(!u-+ggz=h=A3)#e*@^lx{}MZ?G88;~uha1?Z27SfDr^|6o16Yj7i=lQ
zSCVvz9)xm(24H?s+7htZ@eIv|OvC1<?hd3M!pcz3bA{@;wSpP-$o7w&+IS~0iTVls
z&L~;I0&B939rNaya$UQ$6Nfi1O{mFWx9aL98lOA_4lDrp+9So78~%6ymqz&GTRT95
zr04C20^7RZ=(HZ`)AGPF2->z`tF$J;PG;Pd8vG!ZuKD<Zy$JY%pBu5L_fXi}_<|Sw
ze<roDPl{|h;0Z%V0x~H4wU`{P_OR!$mz5e>U!SUL)QVYwU*~!l%j4qG%K4_^7?y?b
zld?|(hzH&!8D_o!b7l7#*fulDqR7V_@VuQv#XbBkfhZ^Tc$;-C&_|VC#?Mcs%SW<_
zWcX1e<lw{K#Py4E8>!i-a$Oxh9YvTBd9}VeJyr6?*9~QRs&c`l2)HbaE3<P=FQySh
zkF9%i_9>IsddG2Z7A0!qj;SiC5{Vf@xk+Ru7St6|1QF+52><AQk6=WN(6O`!HJm|b
zS1p%T#Q2Z6q>$yr??Yx!uGgJY94Whl?vIXHt`gHNGKDa~=}s8_s{UfRYMoPYDRPDN
z+Kn8X&nzI)l_sc__N1rH8A>fFL<gRZDkYP;k%S7c{<lXiCr-Pdxy9!6H;ZczA9EEJ
zLIi1fzG%~yU#m!A8$FOBzmvZ<u|YsA%^`i-!;+fN`he1cCLU*_-rZ;z5i~RPM;~61
z$)wpRIiDIolT`^tP)4c(3*ePgcO<a)TIj$bhe{04kiw{v!=pmakFmnQ&>>L9qm1RU
z*z$xv%&CNrJ&?gD?Pu7R94TqiC=!6@!j6`)-=pgI9S+g<K0e}$<iieHXPzZWA6~o(
zhYu(s8+LZ$_QK8LWf<*fY{=N`a@@n4Y0d4)p4uF)PM4^?l_0XDVF4rvy@U=7ZjEj8
zyM*G3(r@FdcW!CQhDEnTHb99)xrHZY+MX)ypHkdaljC8b4%rok*_kR?Eqtp&$DbqD
zvjJ&BNG4(VGOWUchZP}-Uf3t~9&(AtN>gCOHD>UUKx(R(IGVO2tE+z16tnN~x1n<1
zSfF7bIXtx^x<PmESPME_zJx^{uL8Xfhy#{Gu!U@;94PR}|I7d=AGBD-<?LBtN*mWS
zu!pB*4Ty#Cb%=EO!>_u2U;VYxXIX&;%#dh#fQ&9gTs|hwPSneEO0IRlZzKUxuY<3K
z>+o(t+$|^y!;xb)Qj4nK4EA|yCxs`X*U|87N0Hahv@_#P8i@8V1H%`Bi%x%-3Vi~*
zvIoYg2qMz2&`(Xs5R%#^_lZx14j?hT4dZ3Cq8#37hGG~>dJ|7E$UpO(ge1LEX808>
z1?0rg(<lt_3gi<BkNFmwiuJwcFj8c_<T(Pi&)VPIJOZY<n9xd2ZMNe9$fwu`^I>gP
zOArpL>JdlP3p0l4<&xZiBQQ-f@)Keyj=8}fU4z4GZzemRm>9u-M3%;g1yid80DYA^
zotDI8GP05n&WK_Jqxjw|5jsEMtpp0o11{4@J`O0eyntRuiB%7I@D>JwHcK)Yx`!HP
zP>(bm8x4dQ4N=TQdGR?ytK&&_iR`R-+%Ig3YHVq)SyOw23D!CaU{d;_!ra$D#BgQ)
z$I5SnDbQP<e)EtBQ-JPRY(%SfVZub-q$J^3(o-S8$EByXO4Y6N*8ZQq-2fqRJ`Bhn
ztBpqN_3k(E_6yVRR2dY?>PRrGH}~!-Fqu=`>o+Lizb#e#_sK{8gq^6<yWTv!BIn2Z
z-%MDhxf(ED9{;tNT>3?0-pY-IuccBtg6cfT=--$Jz6ibxavR2fJ_xb{BwqKn340`g
zC}n<oZsznBdADsUUr~b#hzMS@?R%=?N<<LY(Ymqf0be$UeW4!B#xa2?DFh4WZ0L#d
zc+x~X`K7K(<6OK*c2MsIz-Du_H3*(PYY};2aIOut?1KN}8Ivmf8G>$SK<E5$5MG7k
zt+DA7{h+DG!CJscZOc)dpZ^%ur_RJ-zy_p<na+7y3gtsc)}|IF4)4&fjN49@B}|Ne
z+;IA6kC1o#u+u14a6dH{j*0}!WsKcgTRcned6!`|fIBN*g;nzB$}9n0ueD@qVOh83
z<Mo`n!C!%YZlG`i%n!0<G)Jbb>Zfz^2QP^svwB8m&Ii@(+sA>biR+B#y9F1_qjrqI
zt%!D|QP~UARV^R-dU%AsG!YCxpAwu>A|E|}_?&Y|;CnEbVlTCc)vYee^S!QFd}sG$
zm(#vOfXJ}vBwB@2%k;d94KTsC;D&z90QCmVIdIYF)m9Y~9dX|sHbYqk-IF-e$Sz)g
z&mOJRO-gaa?L5XWHpkzdT?&!Hy@-BQBjO)dC*6pU{uVG?SKN)W;L5_7RajEDAb(?A
zANrE%k5h7}cWa61i*mV9w6(TLo<xT0p`y)Z=m)FU=31c3s*bUZrIFxa#BaH?vb19j
z!X72CK);x^Jz*9$bP8$YpOqrchalRdaU5(}kigvFQmY57D5Yj+S0`<z<Lt?BO2M{f
zr)g)|K)`mSi`;GLK+6eKbpC~xp>pLDd^E=y8VVh5J#&9YyeEV-sF|3Qvwfh#@q4%K
z60X-$SzU|?xCN*kGVbS&`s1^-T*XS}pi+F)KYH{j#vA3}nQoz|OtaOl(na)W_i8aJ
z1G<F9K~bJ*QA$M2Z4Z)VdwEttc<fiLHo)@KNH8-K)jZ|l{q<oU0pnCa`Wp=+j8ySn
zXyiI~9?o)~WSFD7^={q*eRD5S`3Ed}A&I6&5^0awPtskzNS69>kvoD6cIakBWb??c
zViU$K!^2w+F3Zw!{089rXC{2)t`j=8(Rq5m;$K_Vwip}Et~h<W94`+%49-EVzBMU*
z+y?D<9owVrOUBVB%!*lfUoY~<<~K*A9ZZW>R45FC_ZDdU?Jw~;VvY!;IP}~yY91au
zLmP=;9jfa@tB9RXxWW5(#C^I;%XYW4oz-CBIRTiL+~n^QiZz7-E2bNGM%lc7io-Pg
z`1(H-&{}j;A#t*6kp(~>lBak*2)=tF9Zr2X<RqgEJVf2gvDzFhv(p@}O;nMou?ke4
zR!U0Tg(7I69+U_=()bAobW3cHC5ZN|;*2;RnVo_^O!R`DMe)ez<(oZrYG*HgEXl;E
zb|IzAH|`D?A{W$Lz?Aq88C;E?*J*oNwoD3lx3xP61g5XT5DllkTG;%Gn#J8{%XKZe
z+NH;$pMjZIj2<<;(J%PcBX7QMa@rIAg2pp?U9&bUj;bKH4P_ymF^zB03Fi^0TgM^8
zKD1YNqxzVidz2M6D%S}E9k6UsI7j;nnqVjJgb+;2@*WMW@_>wCqZ!O;W;&nV0;ja^
z1BHiFL+-BV>+3sqf=w3imsJCZ8f4gAOnsCp8_W(}7&<5As)=Hr5XX1~mHI*#v7G9y
z6IcGgR-Ia<6d(J19}FW@6qN|wH5~K#5K^t1gM!xI*!50<IE<Do{^JnEBAdn`&!ii-
z>W0d-*S0y2#8;OJi%|Ola6Xd^VIkxy!<H82*TURl9YifKCn7m6g3}lJL6_g>TNHAO
z*V{9(A%o`{lKH4@?`Wk|1imj7ohdt-z|Lcywh<l4GS0eYRm-wLh#}(8b1t<P(uoK^
z_!#ymi>lmem<9d`sqw$U%HaC&J|rw$28OlZ1>CvzZa5|1J^HI415qGOq^3q_<`XZ<
zM)UN8$pTHGZqG53#ttX-D%rvNMzG5CozyGL*WPE!ENMR`o*vuJTUb%P7JnJf+~;k}
z@gvp>KJykYf?kksREJu#-Lb!Z)3a0$?CdcNYT>W%W!a2v!}g;y5hvv6&&qw+gZ5r)
z8yJyXbzM76s`wz$Oh*GyF5<ngQc7+KCEb@NuNx|28x3}g%;jR7kz@@-qN^g65iBPU
z#YOFtd$pEzx^fe<v-|F?RnaD*Ad|ZCC_=o{?6B;;hDtjX))X(a7hs%*-RAjG5YQL^
z@3>+8&uYu{uX^+=X_=y-BU!-<I~$A1iO0+2@&7xy?;WkfTRs+<>ZSwz?=EzmzIH<f
zMX0d^sQ2L6--HLO>YnXmd6xnkdrMw5By|YQyc>REnNn%!J<>$teFS|n(%l&0-(6pR
zU;m5j+tzVJ3fa<0nh7S7xS_v*=|9<!BN<P}Bnm6ofiYpmpl)IMNISHuCOf|??u!Y^
zO#h}|Piz2ZRXA2NQEY|XR<rFbi7te+Z4prDx{R%myvF!I{!T7CP9zhhPNlb7Q2AJH
z+5H4?)X}Sm!O+EXf}*<msghi`$!sq0>}k?+9j=s_VeA>k?cF09$Q7)5X_c~e5QMmX
z<8e>J+8r$1C=xq@S-u!mq`@`MOCskir<}6_RoYIz?B7H}ztnWQA50ZM2R3R8oZ+dS
zYWy?~xdhZyy&AjZ1INJMbi6L_Mw3#41_H5gN%QL;5pOSAxc#hsk9EO*iSEESyQ(s1
z<_`dj8&2IGb*@O+0Qp|e{PL1Nc81)GLJ*ZpG(RNO(C-MqU;4airG+OWv2^%TriU^X
z*8M!JN<x*A4lTdG9DBnC7<z}M1FlnmpFO|l@(dJE3;U!!=pkLB+cANp-@)bYn^c1^
zeY-mCG#Nu4{kL!g(9yO;mYkGJv=nmxSo1tu=@Q&rTgg!q(|*F<`ejZU%`cpxl?Aa0
z!PD7!8c}W1e@(Jx1(P3wEN0@1Jdw(NXG{`798Z~#%uBJ%_3}hOP#^g3rpK8qj$aul
zd`T$67QHR>28%898ce4{p;ckVNCa*GPR7>`0rn9q>XVeS8~ilThexo^tCITRAjx)U
zOz?%MMRXi}`oGj6m*c4m_a9=^rra!tkRjRd<ctk0&}zHnm9nNL-o}6|m!Fg+7G%EB
ztyTxR7t@S{N#d^jG(<g%BnK2`qe_S)^^1_84OqF*0$%_#_OV_7qQ$wXZCWi=K1S4B
zBVO@EJewE1S9DQ!|4m&4?GYtl%vf`OCCB>WHo!q7g6>re$8e`1?&CY9bfpcg3|v=M
z<`Z0a+P5c_pgDRwb`hVCCvd%3K9H=%*TgPF-TzyDFTxta=+DWOj%qrI+CT3G+>_Jw
zJ`XWLF8=<b5713~GcHbZIWyZe_4<*GYpd>Ax8i9eJN&>kjA`rehoouvYhe<#UN1t`
zv-WEJNQsDh2tBtA%uv93dJLtrIPK?IjUMWz5*d#{lh`u%l%^GmxMuuplh~)bZ6#Lc
zG|E^xoqB7?-K)`LA3%(130@Vss2&nf@znV+&{?G`hzJ^K+(A*?+=+VEUO-aC6fr!X
zC=ga1TX+7J9{h<aGCw}6dL=t&3R<)rK*KdC`&my195_&cNwZ7#!;qTGyQ9Ot0G)-6
zmbN5?5Y%B?Wu3w+>4kIA<uww0j&8`=GqXY_oDQ5Vpsm^oIOtf2E)Prh5^hlKiSXYI
zemyMezTeWM?p97~mLnlG4eh;qZ(9c&n2n>;vCbq7c0<6;y2R$AKS#NEJ2A_I-^O7)
zr5OaBv{mFzDQ{8SF7iTISW~s<QthC*!(l{MSI;F8d>U=M4-`P5b4YEG0<`*om0g`1
zaC`n*$3qImm)Y>g2}aT3yluDF`juD1x%&LXbB$6z)eJ&U#2a!n3FrT)l(V)d&n*0^
z-;I3?<vbY9*ko$pw5yY<zMD-tlGazeTzyaX0d5~ZMNZMBR*Es+2`O2|5OsD4_)8>{
zr}~}~h;iLVh8a{t+?$}TXU`~ec1&BYCAo;m;hWX)>1r}c4moy)DBY>-8+fcNu;Y+!
z$|sZF^Z?SnpmPU#60^#3BXHj@Yc@i>?o2dp(UtL;g1LXCoC&C^q~;)nh|VM~d5&7%
z)apT8!uAj*lD<2aI#s-3MI>$zU$1;{Jk7!jLHxFB-)`s+*Kl^$5~a)BLCooL08dHp
zPt3XBPF#VA&}n)T_lku|)P&bae1Su37D&Z~rn%GUP2Q14G6=)F>8n$yY;By>h*CpK
zy~L%2@M|w-vtLMd$D;&juO)&+`x;$PaY!<N`iLE;aU1>^nU#}w=+chdA!l&tI^~br
zQw4JZNw(XQx*j>o4d_XkF4K#7b2;6Wn7_>#bQsY{J3LtLY$ZgH<$VxQYvOiC2M@<a
z$ar-y(xIj;NrEhQ-4?`vsX};5YDj95oDam7-7h;8#qHD|O4Uky;DYU7SmtYSdgAvV
z)p_rA8VI&f^^lj`{f226RR2_sG)+2M6+Dkz>1%lYX~SQFZF-GY85Zkm+T^HtG80>k
z?n|ggdVZ-SA>4`%8o5MIwCic7p&?%{B}<u}^Wd4K6?`~41M2zT3J?wk;mX?HO<1U@
z5K#B^8IQIr4mi!<re5PxC$4{}%ER>rN;{;4B31bs|IVB;Zrg+CVE~7Z;88+EGSWA`
z*~MFu7%Vi@VCby2&!|82$V8aL18LioI*|xqfkbVyz^C>5H4%uialyPs@Py5RBueR#
zG0dY}Od!9Yx)JxWjndJQgF_k>MtmeA!G#3~rQsbcSte$=KhYfQjhpR_=pxVtM~1iJ
z){1g5;mcd8Ei~a@8(bus6ToI(4gA#a0F}X5MwCkqe9@A*gep}>zbQT>I;zv`=q>Cg
z4*}a;J-;9(vR@g~Z0^?>pH^2TfS@OyeIFQ1k4E3M+)PrkGeFaI=}Hm&GC*dshUNmD
zioQr=xY;Fg;?~OvUc&D9?g*Wqe&ts5L^k#B62fVCD=K<etnF+c98}b|(I)d*7#XVB
zjps{h#&aPAR-@+-&y^HGePk?rO2+D^>t%{rVAUm)@{8x{(W0plS=Ys+nD2s<e{BH6
zwxg;zVI-8@9PV?1r%C<GywLS%y6i)zcyH>@qeugbVW|({ZeMQ>9bRHZdeqn9e;t!r
zNK*R6>J{ciaZlICTrhb!J7l3+o(=Bq?2G@H`w*6-3u>7-3+#k)C3`d({0Kabf#V}<
zazagk#jwwWFxN{=ezKIS*y+^0nq!(>x+wu=J`1VorQ9uF4eit3iH=8cI*f^D7;ItO
zvNBh6;`maCdq0o=*1_XGjUu`!@Y)Sn@?bhl5y}!tn@d7n>6O%L2LTQ!hJP2UwpMdB
z*_a&j>Id>^Uv3#`HuyZUWyfp22C8T8vP0j}F&nF@K33H!?<8FbT$E41h4m##d)>db
zYO$uBf=wf(hK?MIsr*0!5jxyxnZ`jX|ErH6r$zu5;UAX9&4)Gj!1siP47B_PNT?1<
zV{e|&p~?jKf&x?m`n%xE(<rhVvHv-oH`B_s=6QP4CbE_}-EoQEwAO>J8vHbXjIft3
zu1dMMVLTs;Lgf^Pr-d21{IIEh=)N*_61*1ql0uUiV|EFSETfBtLvVl(^0EfZbJA2v
zxR`9T1L7W=4*Is5eR-)dX<q^F(y#`1$%p6zbpHjdZVqC)U$D3fUL}h=j~K=asYJT}
zt^Kq%tCPSJ=_T?X@RaGS=Grqp5W9QV7T%vNBO4TG<a@4HaDvT}Sco&Z3NEGA^yu-T
z?AN%krIZY#Y@n7{&L_vr-O<DgY{UEkD>Xswi%7rin^oqKajuRaT}<Z}WW`&q!TL#!
zFk9Fb>I)+*8{N@vgYug|Ts=5a?r4&rQjvNf^)qob`vP=1bf|XB3DXX>FIU`>go-%{
z=LbUbeomM$q~ps_s6+<+3+3CA3R^QDvB@)R?nBoF*}00jc0RbPwoe#k4@}M==SD<m
zWR*QvC-bRh?aVC*#MP|6kaqzd2|K(II?arhRlF3jF7Z48340<HAcO8(sf)I^RbEg{
z6v-<xmE)nF|4orSnBSw`x-brg-PMjpDyj!Q;gXdDb<F`J0V$llJ~NSt*YB4BjR-2D
zQtng&+DX;|+?XqkR;Nf0ljXoa>>v~z&e6`jsVrs-O^q`>Te89VPe<HKxzCCPf4zti
za~QV2jrkul=rrjKx{s3*Tajdc0v(;*eDqAF9RS}d;ROI|PlTuU8cVrx^{cV;{gG3S
zH53`l+P3lFK$*I!13?=Gw}B9qvyW!KL9OKzoaXt*uLV@X_NL)Y(;(?<jd~_rE&5=|
zk8H8?odncf{8m{0&CMa@JBbhH2S5-WTzCw-lziyuga{l70F~>d8WXHPRz{yOiM^!1
zcKkhr0tEb4`ScPVs|7=TI@XOFHca{V#5GEGl&76O{6Z?BudSuN!T+N)^X$I9dEZqN
zc{P9>z=9H?RrMGuR>Ddn6C*?~=ng8x`0mv#=h0$BJx11YhDmK205{vXW$@dG>_@T7
z<Xzcs302y15c1BC>1LEtZd^I@1KZ=dI8JV+g`_BrBm$Psqn8gbze@t4T|S)aT-QA2
z1R|(R@ys7`e@YC~><ow;8(+-j-k_KCg?D{-N4sM60ir7g3|{69-Dv=RC`NY_>n8n%
zR|d2h&K5mvJK`FJ@!sd}TQyX-Tc?*nX`zm%!9`TtWoY@<`3G~ZLFWAw&pD*sR~2LU
zNuIVlPvfT_AFtL%6Qfy=16{)r1D<E=94DAd(5y!2cuRVu3`Mp!_b$^(4E=n1TA;U-
zHKEn=7v?t^sC%E_#xOBcf0CEJFEd@y9Z0tlAURxM-s*(8Sl4hc2-grlJ}aEoGL&XL
zd^Qs%zTH#V?q|0l|MKLbQ)aKoh_XwvR;Ryoghj7QD1b~N@v?*o2%;fLU)Gx&t049(
zJ0Y5EXrL-JyJh~1-`txhekE32-o*>Q!eU01SzCcs8pp%$sGQhJ{K_j@iEAp~LKoIZ
zKT;Td_64>4=-sXh0XyEnOm+W*U!`pp#%X<Vr1pXe2cRRkqpm3I9+uql!!Jo}JPUze
zm|KXu72U)^p##oQG-iz<5OsBKamVkST#ibon=Kv`L4fY6zN_P-3m^aSO1Ot;s=SB3
zH<^f~vAQi5Q!V>!xq=9@#IDE6W(Xgh`2UuD(xFb&<sjYW|2&Q`Hx}jp7k+;}P;)Ug
zN+zJ5xW5r4dHdU&;LnSyR6DO+$gl7_j(h%lni9bK#B4ly3~StppInz7Mb2~26yja-
z5p0&f4p|XDlG*SqmCFVt7ql^AIK&7Bv(=_^3%zJUh77C~Y(B)(kHFyC$O}+hL<Ish
zybmO%lbrVhIHex6nds$EO9atoNb(>I6XwffKvR4izVmG!{R#^Dh7%24z85?AZw26U
zl1qZ;5YhuL-zc^hGo-RH&s7HA4pt3UR))hH1l5x79NyqsC5$@oJT<>%Elo`;>MACy
z@03<wysWt<hC@L4k-Q79xu#1OJP<O0m!SyVHZz9D?e$;VA;fbpIdI!Wmkx02JaC>-
zzg>tFQS6DYLJX4iZ%47oXZ6j04M63^6$O>`D5eNEPB`=@ho%7SM_FRUjm*^8@PGm}
z|LD97i!0m}u4T8%$T?f_@5~0Ml?T*>u6O2>G=`Q??+4&WA+o`)qRPoYxkyGDe)?4m
zpY$iCQ2X0_F}S2}IEmEEN8_L>^fjk2>1l%LE@UsSx`I@W@pHI5FNe{+C|Su`;)Ka#
zW$TaMQmduI2IDi+1N}m}&}Sfw#PsuHy|OuPfjzNaoR#XvsCdrgC_rO2#^}fjc+p|z
z46PbV<<iD=Nuq~7)gVB`!=@AOgxe|u_h-W;ABbB6s(RtOJFlJ)J$U?$tny;yIblEw
zMtJf?%EapAdm;ea+t`VPI%LqMC)kvcfDZTPxIK)WuBL<=^Y(p>xFK`Xb!Rcixk4fz
zDJyevAA-m7DDdWgQDDqr^4?s;?B|{>+l9o<B`6h1HtZq^MTUuvgV6oR)#u%)v|rGe
z%4!WG&k9copNJjcl@niYgf|?X#6Qp90z}F~HV3F$QEt~hqh>2J04B0fW+_{n9N2#G
zT{Rbr4lOC=MoCXjYF`AhO?jq}<*<G?WT|yL85trxZp1||fJULz<2P40VB+V=@bStl
z9|;G<h)lHVpP-cYi^|Vj&5|vT(byqtX+l7@8cdMbMKf~sbcDy}*JsAwf<w{uMu2y~
zA2LSPb2`sg;hoItXt+{*Fmy~gd6+rJ_t!4|YO;44E{Q_kuK>kX=ig0t$axH=pNkZj
zbL!6Kh0FrXuhv7*!_xx|ONJIYp-|szJEOlI$0q3Md@!~A0wjxwth1I{9AUJTl6xUp
zDgfW?{ulstMQNf0$p)@?ojMVm(n(-nyrwFW3Yo8c?!LsRDm&JDu!Y_8GaB6?P)Sfw
z@X8WN@x=<IKuRGX;~0`Y(3?Ut-IP9DqCB}mx}pboDd_W)8XLdjrtqWt2FUG9?RvPI
zZZWT9;)Ii4BUM;VTLomuHV+Rvh{!gfqA=}$*496r;O~?97J+USf`!KHF*QjA8f1^(
zn4+C*YDuoIc#`R+^#e>V+Y4ObAYO;%gbL6QxdCnv_VQRyZi(7dKcVzSqxYuV-@{vg
zLW@-J-BXGAxXGACPaZ4i&NOWUqn&KwQ6+AW>{-<cpU-Jhij*X<H6{d$+dr<Eo}}1O
z`zB+sS{ZT9k;47{Bj8dl7MN+GOC-o-bDhm^Dr&rEL_75%x)wZGgt9%|k?*MLZw)Iu
zQTu<su)Rk51%h<(ODSZi>|P1M0sey5HBGW+=Wrq**&5|DE0<p<^`-diZ99ht2baPA
zImohxn^ZO>3@c2RW`v8hhqjs&n_@FQi?z+z+;J3{8&!M%Fu=b|RU**Ai^fI!HaAUI
zzOFS2d|MwURMtRP=$A)I56}l!flr|IiusBaI~HJwT}mY)HEpY^Uc{qR$?(5(1^n0T
zexzDoEafFC8M%!9FeTLcfvrMJe#A5@x?6_mTCB_!F%VLG8h%P6quo@loaqH9#!;`=
z3Gg^7@R;vvQ>YUqGa$PbE6$liv!mDI0W6u6RhlhxD$Og2I7mavI?>N}-}JJF%4oMo
z1W81=_6&K(W6Ie9j%!Oqg2P#E#xz^d@uVi6pI*wgP%U_Dwu@x?<zxvGo8F%&b2f@W
z{F+$#xEN}ZlunYe<Hk!0X}s#HH4cH?bGTL9B@*zBYFKU%yD0OXa2bjTEYv4+HP$j}
zc#9a@Vz*^1(UiB>NQ+92R9k@#yd@Kx>!!vU66Zz4J_cTz=ej@!#hD4DyB!HaQ++?p
zk%_|W4p-De04->D^8g;21Vbz2Y1Jam8$<SyWE-z97j?z*KkAJ#iz=Cj{hzzqkTR5)
zPhkq0m0dH#+-eL!%%mG%Za~z}<6x*yT6=TdJW>2n4u`2M(R;T6OMHwMq?VA(29@OJ
z3=Rj^c($Rd7bm>&m!BwLwB0R<RYidr?(lCY_Y|^~fokAh`v*x#j}fx!#XZ_+NjdSp
zVf~_RUzkL%$!<4mME1=`PU*^@Z0r6gY7Br>zr<>OnSI+>C)l`1l?{r1wSy|{j!f<3
zwa|XpV$7K{*HB%QDSWTsztRn9q)hiVj`qcIp9~vMpF1y0jkO5*;EKg`nGId`*Vxg`
z&#E4J>c>nhAReH#S+y`p@{>5vhCqK?L#it5`yW!XT8YwK!i9S<V_D_#m%_v6WTk9E
zFKe%VZ|h`{UJ1^A8wWC^1SFz!K|)Iz&-zwWp#tz5JQKm8<DeD|Zp=e9l~G0`;eE;l
zK512<X?eZSA{2SaaW~PngDN|uEpLW}dX-fseCN<t7f}4T@DuV!;E*v=oq}o0fBV`J
z=9Mb!tH`ALr_%K2IZ2!?q!)oHMSL$954gxnz8Dm81_jfdPl@H*rwYPRcuvi%e?oe^
z9PvM26=N$5RVw4Uc+i!u<u+XxtH+x|AX;pBN12uE)hIR_KIId_+PXK^f7jgQfp>b0
z>KLh3b$TVql(g~(pEE73!dkojaKG3o0(fhHkL}XckN!7DpqLO8ca1EXLD@|Wya`{p
z;u)NUY|e?^;cBEa$;vCb<igv?ohP0TBYm}e;c2y-iE|=B(~u6=><k$Ns}qT>+(5m_
zw0;ZilRSxo=vkCogpR4zaJOic;tFaM{~(A5I1UUcHEO=2>wo{_AxHtKx9Z)Qz9#gZ
zvqCL-#qW1I<64^=dW7ExoouA_rKlH{(`}5-?-TUEoBDKT#+(BDNDO*zrW$Bz{ZKz9
zy!iy?|D)XN-!p&Y@S7zlb8Q0kzL+Zo5SRl_ifaI`83WYSV1VCevj(K}oqFZjdT3D7
zn;L*$ktr@RY%QZte3d^4)xKZQk#TOkx7RS+HrtaoteJuRS2kgr+$z7h;2OSOpwXdB
zPq?`ECRWUD=}X{D-p&azhIukGKD}0Ty_W>c887F-lxJAe$%ItjpHl(*-1y<s%X0)S
z`ORF^nym0sNrhCY%zQ~IUs;iB>N9Sp@7*9Abua>{<>Sw+S_4Od?{Tyg={(G`2?B4f
zt{#uzmRwzzk7`AbK>-MPI&Wr<4nw{vvaODSh_P*~71w&Mj>zDgMu96OZk61iylHYs
z0uoY30@j5xGsg=bO1oAO7THU^{^{DQLZf>`>QGbWs00Hd2}ZPXoND3`V`?fwZ6aZa
zfA~B5GxMzLR>Y5VAZG<XR{`XTo!p;sIFE1EaL6_{;}4<3RhE1c2;>x|-mtzJU~uXn
z53&g@Y3Eh3l#PG-*|6*Aa_0PP-f_YD)Mn%^jR?Pe6jio<=3|s2upjX6xXVox$m|zC
za6EbcEe81E_T;~+)&-A(!7X9-VRUQ+5TJb!y3INNUS@$Be3wfW%=AI9>l%3XNkMES
zaTPB+Y9FGUKEQVhZKB*5{0myhFN=;e5E7^7oUk;PYP>o$)@Gh{8fb)(+#omod;ryF
zCeN#!<!4tmALps{<|zxE=UE1~UA*xM`g6djXAO8<X~FeDP?SMMtP};Zl)Y9DTSOW$
z$GnfHSGIw)g=7%jWP{D{4v=0WILZaWOY-oOO$}Abp<$R4{?A3Z;a1HNfjotfp%z#n
z)6S<|BE2J_l2vjq@*5>6unuG%+KPSxzxD$X-q4x=)Ufo@@rUF1-Thh%WKzl@q#7xV
z)7%_eG_Pv=d!XIOmuTeYaiyTCr2yq7SM`D$YYi1GF&em?_?LQ_T(`1D0C-!)^DM!r
zh$7{V3n%^h)Mx}ysIZbVY%K_QyQY#%pvarKPa5$B&YB#T+&zlfOad^j9U!oNP;4jy
zhwUg}V4_b+(h|U^UD8s75fkxNQ0)JeGnJ9;>)xIUfg@43rD1SR?gRY#oLyt1>gsZl
z-*S65?x$*83G8<*vH9^nU5yzWG2-nUOZC!oB)R%OTz(+5moMk*MIvQ=V{ckSFUkL=
zCwIBBk>9Yt?RPC|wGpH8mlm88cFMr4Db@eY$<02{S;3Y(7vB01<gvXOjRJP36b-r@
zv;24Tq)fA9acPPm=Y0NKpmJZbb^3tEhfGbyFG7pH%mE$YSmR)oQOxKKZe8eu+uzHh
z)$pk?-k}pUV0Uxq%ltm3XeIAQSx>7rNgjNutO~U`zpTT#Vg%`sCy-lL3<3?OQNXy+
z(%z*;{~UI!DC8~8jg|Nfzv3Hcn~!b54L*7A)6amf*!;i^f;s_Z%M4!Wz&EHTja@1J
zAdBP5Gbe09JV?oJxx5Ka{a`OKTvNJCUsLt{Pi!eDjQ-Z9ZUjxAkMqU$LKZW?4{lcn
zy|M{Kh=C9<nPJQ60lAA2JQ2By<}K>;`F29ku>#MCXkSfxP<Wy%=acg5pL9<b9zRsy
zUO$2|Z&I^}RPBDa#b;<Xjwb*3f_PV#-n=Arb7dDQ6rPor1M*W|xsHX0<}DeGI?B*p
zgO?{NMuNj}{A*@yxz=Dg(Ospe?B}i4#K)L2&<*d_Z_AC^ge_<V@ykWPSF3P|l<xHi
zO#y6PUSO7Zh~M$zw~!{B5MB)+;0ZAhSDSLJ-CNI8)~lCtq1+_xCRi(*bB7vh)e9Zd
zqc`+N-Jb32v1?h7w9iQSoxDetN8!GB#`aB}-!LbbAsps)r7S%4{wmR;YaIwOeFC5j
zM3sP@I6<Ym?Tv`;&4=_;*jEVSYzgBsQxwR2q<Z<|eBm6AflCbYr`O<;fg?<q>oSUU
z(zze_6duMz5~bv#iW8uPv@Rod(DZISXA{K1j&9v{v4VAk*m@c7Vzxa!!r%{rEl}Q%
zbV4Z>)@y_7csX5_3(m?J!zDAH<G%QUn?*=!XX3?Lux7lg7Qju2>a`aE>9P)KcZo0}
zOxi~!*MC9&(fSaUXuw)K84+x)dH$ZixmK`a_|!8W1)7zab%^y>42osZ+-FZJxxlGj
zRYF>*n1>G^s8j*$o%*=yI+B@>j_^nj_5P$|@4kaRWr&D%1j+ObDV9Gts}E){*&tVG
z(6v7~7g}PQ(o?1CO|^to><;jMQ9|ye^Aw_cSE1M|1U}+aD{;33;v)I2n@7TPs4LLw
zd(PEp|KOdes1=L`g8S4aN)=sDxXcw1{aai*JzOAH9==u#o%X#_Bd-Ku9je||2T{z?
zt41z4cz`Rzp6gR%`D5=fs~ZX*+}@C7y7<8s-+9|3;*^cgMr(SnTQy?1<$p(<I{sCv
z8+g&(E~s^53m-p-xW-ku#}qw?YG+X%sSJEA2pUJ2jC3`+YPP}w<~Gq3!QxK*6uZXS
zW!FASFT%HT9&J;hJLF6M8-8rjxX~1mqn6IeWIFdb=y{y%=WK0oi2L%J50Q4KT5Vm;
zZEOL`p?BC#Rs$G<)WxxzyEoV@xkjtmuv9<b0y&1i{C*GW`y4E`S?Z>J#lETe?sQR6
z?OqA9?d_h34jGGl;iJKz>2ijm_o5(>Mxw2iwTPSo^j#rDYT|=aW;9Uy>&C!X8|ty1
z89;UTR3r9uQOIWWqey%gVD@3K3un2pCR|hucpvr090U$jMw3k^5yqw0>edN7N8nHe
zj9(rAvA1FZpEveW-5IbOtr8caDt75C#RW3u!jzDDUW9fuOM+nw^Z3*BlOv#a2{*{<
zjyd~Pgrq#`fJz6SFBW3$vC$1#TIf<IK<)B*8!ZCi{2KLCJxe7}E+<&9%eN^JCdq#s
zd?I*bvgNq*CUXk}npJn;DgPJqp9so<;L*QOs0o`2xchDyYjb>&z4G~r62?so@e_V*
zu%zSnW=|9}z&09s;2JRXgP4qzmDeJimw>xzLqK7XWovA<hG~C=bBv<u)h8%g(<CDq
zCf(H}u$xvfhLP4V)<K7bn)t*_>cI8bL;>i@HJwo-b5!9}Y>;*rcBbs=R!2REu$85F
z0CcAc;u#?Rf)f0fwQN#o43d_b?m`X!TThL0!<5TmH(uE7rE_#(brGs|qlg==c;T6a
z54eeF2&_FFYH*iq+c<rAGoF}KT~u~hbQoosPZ4UVW>PMMN_b6BcA6I21cMbX^}-{V
zRn@a6T}L++2^pTv!g1wDRFr5ykn5_c6^f&d9&gUH^SUz#qtB>)?5)zUq8D8w#arEB
zSw!8|VdiKg?}`MITy_!R{{mI$ISqpIQe<RX>Iih3J#ob|dAb=lj1jA)iAVMK2TWao
zEANvCongN#VR_q~(rcLa`DO=dMAmdyZeSKPq2DonrTja9C{d_1y$U0sWA4Q;wNOf|
zL?bVsKP=Qwnga=sB_%0;k-TsDvf82S<md5juY(%@xaB|p<uAivhv`}O2Wb)(y}NF?
z_DtmV_yVXSoHd#SQWh>J$0${d<`7ipn*kY+XiZlGq15EHKkoAh7eAu7P5uuv9wJE@
zEvWIoto~F8ZdBa<>(rTBlJ~Ykd`<qnVrhzC$IJBdHfrM;3qhS+d8qR&j5?l-^+rBg
zYVftU#*9!ZxXHTok=Z<VMJy2qjc|^}y}rc*V7sj$D37&nHFxsFUz1@X5n_KyrZ2|B
z)%6T2Ftr%Z{YsM+$wi+}QCbw(|BEL9Xs#GeKX=d}PM}1n9CO8J^X1LBl7t@<u`sfC
z@iQ!J9az^p*JXr<hAWJjFPA7@Y*{0Us~NqHo6RX5xrM~3lqJAsFN}fPUNwk+9!2Lx
zk(L*!d%i|3<?yNjx0sWzj^u>?#3%#)4x!onvriq~a9m>zu2%0xZLX_25q%Y{;T5EB
zp`Ohg-dem9>GO*TuGH7R_4>bADW9Yxf_T%56;Y_ThLAjq8=nDZfP}y<6@qJf9a+&+
z(9FTVHbUBbgyVj-u|!h&ypFs>lj572YRMXf#cIc2IY3Oye}Ra6f8veJyyg#%9!oP?
zGtDP}f_crW0fpw07*MRBY)!Np!E2^<K<PUBu6?piL4mKu9<~L)(4t*F!(<q#bBU?%
zusxG{2YFuGc+viw#a>6A|3GTU-2kBF@SODTAU5M33D$Cp^+{<pls9@DzP~gPH7@{3
zX}$`XOsdD?ioYVYA*C<N*AO|ggeXt`6h5-Cn0H>HnyeluqRjwxZ%Iz#0&!bPVQF3J
zz()ZybWDzH_D8l_;*+|p?GVaA#>M8;r_F0(6W-oJvfP`?OSLysQE#G{En*!c9FTU=
zLiXsG)(7l&0W0NEE*FgKkBZ*TQO`&Kk$yMky54GXMe>SE@k9(=tymvNKRN56#7dp<
z{u_-XDwU6J1n_*RFR9=xJWh3ZQNiViU%rAOvJj?0n*}MeH}$tPrj!!^M;bi^L_UH$
zx4~h)o5a8j`7@BXl&q(CiWE4c6eY}aIW4VZz~i3wxW&?}ya*)bC@G%huoCzKV9sv6
zhOfFlDk{`(_yACGzN1rLFQj;SmHydZl2D5Xnejt<-Oy;^NflD3mmw3{w$K?JH)5oB
zgm0xwxBw<s)HpP$U!9dH>{~$61@P7i`dQ>>7V&AcL}3BDzyf8{$Rg2=j#5?!*00sk
z7|eLjAylaF=;v%xFhpJf;A!xbAuou9rBgC0;K!KGGp7WHWv^r-M%O(T6@=qXGFKo;
zh7t-?LTn!4+n%|^Qu3BK**JvWNG#HfNhddh<@$fH&-*FJZvq@fQ~1aqg$lbAJ4^v-
z>$WSy0)impOHRlZ_OmhMG<J0@|N5~*Mee&fLN6c=AnxW=lf?RpwctS!g6A@nDM)i`
zhIu+_OPqO>mFYtR3jj4h%D;=4&EqBCwk$E-Xf%DkZ#)MVN@u)|(a{$tJsZ@IVIKJX
zWqqdUAsHGG)J?f|uEvRt*(Axbs=f>SU9JKLv}~XJ0~x!;h{-}DDu&<uQwThkO;fnd
zFX=jQ$ri@=Rn!ck-Vn9Ux)L%q^}h;(ow5>yFQRPx)T5SK5z!1d5~GqBNG>#c?-yaC
zivF3tut{e{otadg3(Qi0z)TmGhEWq%*@<RvqyiGuny*$D4G9iy!a|>Jy0|_HW!nCj
zyf#S+u^3vOrfZPyQjj~wh(x<^sjFFvFalv9NCan!2#~BOET^YU{R>^hSr*tJ>Q)R4
zWh)!%%r6D&_6tc<8(Cp@egcGBVCg-S41cODdhC?hSz;h+JY`ez!8V};1geHCVKss+
zDAD%}BVx#`s}C9qgYipER;+D*@;uCUXP^&IQhJ^#7KouFUGR8;NQ2H1Z-OtK9aVkM
z-VdC3<!QIZr@K$+&HVcXx4~!Qt+pWzXq=tP0ft)@nc2-gdOCTV8HFI@JNQk3+&s3i
z%yesZ&TM7LDE_>fN~HFWNQjhfZf_Y2Hw8G!3Pn8YLJos#5L{^;wpIp1goQT$urv08
zghrG64-ZQ0DW0Vm7+@^yO!^~rrla};s(VQr(T6!lRp5_M+6RP}x}uh`VkGsIIdu71
zcKSAORLcz!yn8hXMJ>oHZ$wL2<$yw7r-%%BTnj>*+WbN*1T`P;@1My#zTIn#Vy%ew
zf;-~|_2$8KardiIUM-?u&5r*CCEy<n@<pup2c+Ia5+ii(IDW&Xb?^{=Zu?ITGmu=K
zhU9nhhA%K)4f<$pIg6gn_zahm>8VTzJPXyKv(iHGnM?K~j*&50(OtzJdD?*G<6J1*
z|MQ-ZFQ%W;h@w!D#$xr>eY$j2lK^CQsGm8jSk!T@Lahj(X;RMggYiKa2>q1uScjm6
zvXkeDpl~nxydpp_3hcxAe<;*&4yo7WDFxWgjI>>>z;;m152OozVn9?97O8wol(<h@
zDLIGrdj_8%i3EY9DJk+3|3D->*vDwR+luJ7=Xl!2p2LHIfEDHAo)0iY9q_kUyW)5c
z9-I-QHf9~<-qu9F+K)B5+`0##AvsI1i6yO#PE)Ud?^fxU0&FSSts5|S)5kV##S^z;
zACI{GS)eeB+1~VWI@IgNT9#ATg{H@e02K<DuYQs}9b9|76`sCkGgDgI)#uVc5q7P2
zU?1w?s(B@ypni%<Ny_wF8=6B>V|gC>@Jpl?Q>m?c@-y$@oq|8tS^x|`Om-ec>sqKX
zKDrfEe&l8_x?Z-%!Jh)DvqftF61PtF4Ffr@EG&Z}!EcFT%t|}#^QH;$g_5m;oD{Qp
z4Z$ieak6<x9yc&}L&%8x_q}h!2d1;OMatIs_s?p47yqD+X$?dLG?FGcExnT)1H`+R
zvt=~GGX4@RWK*q(;4FIY`@QQ}r3%ne2l<Sly$`r4^L5s1x3@nmO12(5`0oV)4pUVu
zp?_%`r+TDqeY?)MVBuj7Y3F?~evm}AyPBpsX?I@)UN5WifW=O)53S$#X%Myii!I4W
z$9PRsHUmPiGy~8V_pUCBCa$pX#6z)Q*>a7SFfqNf9?|UQJ4jcN4OS{4s(se>K3KA3
zZbp(?5F*ckJ^7sV8dQ7Hnu@fdbrK>0L#A9#&Nnt#Z&Fx*Vp21jW%F^OX4yf0SEG;#
zxXm4Y@xiQkl+v&Si=nQqYLw^pfX7(A1@`{1;Z@ueqe^M01ZRS><{wTwAF^n%!bL6S
zIjo_IVw5q@&uBTNu7Nbw2Z_-_D3yFsWq((}BkJa8n``1QcUQVkB*wCGga)mFGcP)0
zkKPl;m>{{@upT<c++hPu2;#5?y(R<pl?n*4Kdyru1TX9>b^55s-J6VPT{#iIYXK}#
zEL+1`!57_bL=K*@sD7%qsJfpXF3_*sU5uQo!R{x*YEIhQ1pNWdBLh!?Si!c+4$OPc
zcf8`^TYXAOZ<KiQ9@8Ph8u`0U#&1nkY3SC3IrIBXx7bg&dO^M|`?oGEl^Cs`e%dU}
zs6nb*C;d-<0}<_E5nn*Tfj32U#6a!By`OzujF?9$HN8p{*^o|iEYoQ(l+V|jncub^
zjU&ihonXd3DG6V7#<%kLbDzj|V1*|99ZJ0zdrh~Um+vsy36R$<7C8m1icggJqHvJQ
zR$|0Bnh>S<8F8W!Raji9Jm$n453(RS?=h(6X>A22Fi_Scov&R{L-t>F+<Wg1`AD^4
z`}^}d`lRqpLbu}{)xuBHxp#Zb->A`ei+=~MiXTeXw80N=YKMgPVpiDB^Y;)JmoE3w
z)<TuxX6>ol={4VzB?A`{PO)ZtuXp>1o1U3;AZwQ<CiQHJRVf*A`HwR~CecL`kS#Wf
zdtv|*!TkU3bWG@`IU}3J9;zkU!qBu!J2VrE5DWqfR`i%-`Y9XcKXu8O?Q@M;gFU4v
zPc-b!0ZCM*eJoLNsd2P2I%}J@;KUIeJOk&F-d=RA7>W9-pnez*Eoc-z3yrPRu`n5q
zrlvUMU}YM~-U-ZhjSVX|=Eq$@qH<#^WX&cQ4EP0EDG|m^pK}Vm8Uk&sYjdzwSr_*<
zcdA<UBljh7RyD03qh!#T`Y>VUfR9p|jPbci^1l@o+*2OwKs30YKsx{XBfrzmklqMP
zI2{C^%=}>%O&2O$YX2JB{5Dfp+&ZOrs|Ty=3$ywSFj%aYwDOt9NKFk?F|romHe_0M
zuh)-Urv#lNtz26>_9%P`GP-8f3DU>jBxIh98Urccw;@kA<f~vkby`5ef0VJ)*xTE)
zd$h?E;jnD>plHEgi$2s#HkB;Xs*Zu4Y(cWR4w-)G($)8F2E2U&{A<nd7{@*d1o`5>
zhcF8|F8>0WVuDgZ_@8#^inf=wxs$7Wr<iJGkVigp0+jMpM~o#5t^Mqr4@1Y@82|$J
z)-oVJ&xAoeJIyS((}>}(_}A}1fCDF^q`B9z&8(#2+T(iY>MqWF%f=C+B4%05!~`gn
zUL9|8(X%%Ev`&#34pfZ(3|14&vF417vRHhwyuD?@POwC+j2tWn4*LP-w2u>gID;i@
zS$~!<_^G7c(Zxc5S9&SQoja_k%I_uwU9X-vRq>TV%74PrshiofXtj+&QE`z>yZo;?
z1^F&CC~9#%z%qbe{s{m+nBQVgvk3`9W*`}Rk$SM}iaZsZfi!XzhBnTg|H_Ib7h(Hy
zo-c#x%(R>@qMBsp!35j?TXJq{{d0j!HdT`xNVnS_+~M6M{(zQ!9+$)03YI<t-0f+q
zY1N%X3D|Nxx7q|{>a4xpA>#Z>OB`LM$5=U=2Kw1wM{<<(vjiRNcV%smSPzT7+>B<o
zn#D}kpT5h*{D;^73xziUNoF&@M??z%1TzJ)o7hdFKwPtSo#a-O41YK)#eCppBdB`=
zTcH?b%g+@EamnLAE-+kzA*&00*c83M=sle>qM^H>Ydv;QQu8sOBM(mwInw)m$`;yU
zmHia2l?dw^i<*1A|I*=kpr2L+Z@!C@e)$w4O^I=vlgzh?pxv1@6-S2$IRIc0a_E?0
zw&{-MU_||14C}t1zxx7<4T|oZwGjvLj+9A|B=0n=G|x<Ot$vzo0~Zq1r&*!@g2xxU
z;E29dC(oav#n1DXN)|opAT~<%rhYKqmTC68CO&=%P`0M{Z|el0OWxXcEM33`_Hvg(
zmJ%d6sD`5m#=Q!S(L;a>W@S|wicvXjslI)^F_8ZecL{oC0M|v5i?M5U+ZtcQhT#;A
zK_#CfDxlR?<hqjE?2}&)*0N63z~seE@Mg?|_x`)DVp5Bs@aPp_#ni9m?^c1fEuF*~
zfOA*uR6-)xSx<-cD-Qo0Q)qCQkt(MUGsD*1S>uLssn)zpw@)2wecW~@6EGx4iyZoq
zo%hpY|3OXaKCrJDpn3gBP=^Uf!4(3B!IirA0nYE0@F3*jX2!>kLYl*I(bZ;@S>At+
zeT69M={9z>Ai$}#`si6=T8=coL`=a3AMtXWFXj5Lp&;5iJl$|KIIihCRPcwAXk(x=
zM!{sopFa$RrFl5iTBN+Q3AYlHr+=hNq+y0B9vERoNzuq<5+_Os<GCE*jGT!+q8De4
zdl&V+Q)>YR&)3$8Zv&wcR$+~HXW|r&Y6yz(HCLho10DFs<oyb>GGi7IDS)YoRW3gq
zIhczKuvH)IfH=YF@T$uw?S29EA<Tht8wd{DpJy5di*M!8R)Y>YyE5`>)CQQVk<~L%
z(qe%k$uqOp!x^EPo@7huQT;_RO?=Q+)iP&+r|@RLc|l-cf2>1T1)gT^zB(!g?O9dL
z2=8z!f6XG_M-Dc~gyq9Z>0(Mm?TZ*GxmR`NLo32*d1G#12)x_)GnQf84R^#0ASoZO
z8nztC@f173SBEOqeAbn_N3^G0y>Jm|>Enct1Ec@sn49(WE0U6PNHZmaOrV)BCh@$z
zQj-MXU2Hq7z|cc`>a<6fgTIKWeSs#APR$4Yi}I<}%A~pK33}8j1VPEm8qW7VP~WL&
zrr0scec=C|7eOBWjAI8<<~)CSz0+oRs^WyIy7|Nl9!CWZRRlz+HKMRjB<ZElF)@s`
z&G_7<kc@G~Q2@JkA+}sknn-ZyZGZ=hbUutL9fYS^tWNXE&{N|~#WTczbz<k8W2^7d
z)vZ7A0uU+DgMg&;`~wL6<iR(T>Pdd8EWRF{3#0(&W1Ah{sxu(U@{+&nnS+Ad0Zntd
z{3rC=XNGm*#E$RJIAVT&5dQYZDB*p03iM;TeySszsgj9CeiXlhcs*79+w2c)RBgO4
zOTS41DlFNqf}@(XX&|GHPuZk<5SAsb6JouyF4%bF(R}Wyn*-g+uQg?IdT*?VQr;7|
zFURC8a%m3`G;0a;;X~%rqDb`@kvo!3o811RdXcrz*U=9Zi@X`ZGB)1Cl#x%;LSA^k
z`CoMr-1>!;mL!w&05u(2mYmOa$15jRg8h;RGy;KB#;|3JI^cU7<6cG=seHmr9I<?)
zd@p`s2y-(%LZQ_PVG%b10St47nci6A!Rd){H<hLC3auutrqxY!-x*^W`YY72HMpe-
zs0xUwbqV}KJob*jb+C?LX;u}+EX6$n%bU#U>bfUU&6m)w1fTdXVnYE;l_cRnrBqh`
zes@ED!>0oS+X+4z;$n9^o$q+3Zzw)UH047zX{?0Kxr|u!keGzwUP%Rq`=I2{%C~3p
zh9f3&t)Fm}QB#PRV)n2}kUj|mBgISg-m0wxsJY%o<~7PTU<^Pe$=!ZNRf<?T;x9F#
zSM@;LV-h{fde$po&0-7h+UqW$j4A}zW#q1<ZOSu!kp63yxhzxiz0NqI`wOOJSz-;B
zrBNPbhNV=i=U|(PxwYP~!b1fm1zg}3LMAzq*)Gf(!gUQIum%eb&2y3QE7QK_{xSh9
zx0npbk9r?E0S}A!icd=S3=#j*B2}LApr|l?jI4^v*<AU#UfaUumi|_``(z9TluMRk
zS-76-)1=VMb1cj&p0#}}XmEym?s4D4e&PU&@l+}(zRo?rEQ=5t3EDmWWJl{z4?QTf
zSIwpC8uSFPB=(m7kkko}O&v(IL!f$)BanQ#R%Fam5KT&Ix2mlbT~N*p;<pFz{<_yV
z?l;K}iYjvb3rOWA*MR5{VBVZQY5T7hY91u=t|+ZL2Rrl9y>S(!R`#;T5lmYE>!0s1
z3yWw34EKNc{KxI>iX39mP2*%MsjAhgatg!!OjH0%g?05(Z%v3jd@WC^jMiTMTzBa_
zw4Ag&vo^>L>ZU4`GGI^=>a@=5dI@7}e{DX1i5CObSY}xd2DE`LKRJ=^Z|ipEe*q*X
zFbEcLT`inp1wgn@O+zY9{Dh@$s~~O{gjt>}%8k}h<AM^F!qHOWeGK)qfD?gv_*;xV
z@)lh<(eLMnq1X!BZBB2`>~X&;j%j|grom^M-+1qDTnR-!vfsh2vCu9~CCtyGkzE*}
z-q#qh0yHObA=pGoW`M#FfUr<kc~)UMC(Tzg3famiGp~NCGdxsUHV?YOq1JNUVha|2
zVo1;Ayqpe356m-0cEX($F7MC#bHP9y{!W|gaQ&ZM&PXTknD&%^1?=v(he^3O{&h7r
zgfY7UGzZht)VHklPqlzvodNihwwtcToKvVeO^DC5v>c;Rh&!}QymqWvR8gQ<LQK(q
z;7&5T47Z8hv48c3`^g>uL`b&1q-Rf&nCpO9X2+ixfZ>tt1(Ny9+5M1S44s|LRp~z^
zVOQa%ZNku=W~-i6u26BoK5w#s$v@Q&`kMVWrytFeJxB0OmRp3Vy*29D6}3+frIt^^
zal{k%dQY#ZZG9i)Wvw$;%SWGmS?`J0ap)#ifTL{fp!YKcRVNBhHZ-4EYHaDY5u9t5
zo1%;5{L4C6+=`sGku6sH^hJ!H$S*j|OT%J*58XB-1GNu595b9xam~Um8ued9th|}=
z^mI@)qUu}8|E8IZ8%Yz<T~l2<W(Gp=sjA~U+E7)`Clyh-jWD2^*~=idrC^d|y~)${
zZDKj&SenRr?l*m|ax)-q**$2z9(f8aUDvb}9N#lyPhp6ddK6BtGzQt|9|@)1Xve__
z<8=O1ARNy#K4*LtJs++xK~^uDdMK5CA$*<L593-&brocMjLnb$;`+=h+;%FtgX+}F
zs5}Gs1wt00f@4yQwqjRBn2st$UK6tVAN@%ueWKX)l?{h?!@0o-6tsn#AJlEsEx*@-
zC`r`ZmAeo7(&z87qOS7UvHQ(Z2ocFtE@P`F0ncAR`Rr{g7U_n%G~c~^wNJu4<e<`<
z7pAf~10*nsPxteRljTUKsvMBaI&Dq7u6_^>+sf`rcQgejO_=|EwfLKReN&7W6gzLI
z7ps=)*=}eHRMU|{FT6}jvLHEEoGfy^d}6Gboc)Aoyk9b4SOm>~y$&r!?S>Qp%B|=9
z_4U!98#zAkib-L(c0OP2a%YfW#E_qSUYyZ@q%kR4P=@)!(xz|pPW>YuT2I4|;@4i3
zF#BuZC{f7wr>S$%4s8>*t8#Y`<cpo1_9-MT)xWfcfYGis@mH2VNY{wFOh+^X#9!B>
z{~$E&@<ihHvbY=O6sa63sx*L1>*sXf@_<Q5qa+<BJ`27x;w-(v&`)wU)!sw>=-WC2
zB@mTpiADgGbO6bZ)m7H9+Swj3uS4ZT83?dsd&m$(TTh+q&i~lOjfG)^ik-z8{l140
zXF<7#LJ~bMP0mF#T&r1h%-je<;)ScLY<rgQeN_Gqp05LVfq;0yx63(v=O4OtmSuz#
zFW}yZX_J)CClkUXnGSx$QX8eQ?$H34RKhn`RQ6ui@IQ^rhxj`;``pTdb9H;xsD#e}
z){&zYYx;S-yqPN-3h2cr7D_Uk`LO+1bo{kiS}qDIfvBwW5}_86WR>X#|0vaNwBMcc
z{o_<~8^24$PIWjy06^9hxb+fgH+b5Kq|Rfv(cdF4*SBLkroid`sq%gA91@at9VoKD
zq5yBWDW<D`^`t@^Uy1xx>BrIS9TjZyE+1$zwR`QG=UJg;_uZuXFDDte(>6?^$efH;
z272FHU}$%El+D6DU*a+nY7)CuY5}_MRB~-I^w_||0LY`J??SG45b8_ufavd)vXrsA
zh^*iwbi+sRsiUUxgw(y#$GICEkRRK=+F4w#rC(Ou)~8g{qg++PN+|zq5!jV%qcI}>
z=3S7=H##B<TLJOIuGi4vF{RR!MLSp{LWkXm#fpP`X~KxvKm1^leq|@c=W4!gv=`cR
zNP))7@Zf`66#1AGD()^7L=f0su@|4Z?(^g89@bsiAX==cu3%^JN%(o$EBXy@e8Xn0
zd~W#_>Dyk!Xow<t-vso+e48byb=xE+4B9h_j>^tg4U@^qGa}MPR%E<8YVQ2?k+-nc
z!bN{6Sbj9yK%iRCJD)mpx5`Q>XI#K}rHJesms0e0!RW7UFKvo3y7fwge?2!p^bz>T
z;q&b;*$VnGmXAj9-*gj$qb%^f$fThaD<-w>BOl$ww8viOrBLQ%nbVutymYGefaP49
z6^9=g-a^e)ZaGcqXtK%L!A%=sQ<0>!@AoMo;<|0mKS=pW7_MoKY!%yHWCF(LFK>a#
z%-|~O!G^xk{H5+nH%;GF+L2^Uf|syMnEUNoa{bq|dtK>AeYk@YsWG|X#j;x^Sr)Dy
zL9r2I>+gF9<pJv~Kdyqmfi=#Gwz(M7We5cu_ApHNi$t2BQjR+8Vj*<{?#Erxt1L(O
zvI%r?8ixV-`F1g5Mf*)Vg4yIT(xdK_S(|88Sug0ZE&M-?G+<mZrLgX8Uov+3=~7v@
zmU$0EqQ;!iwX?&b#7!M)TZHcVyMb2&i3usLe$4@-Bg=3jo*QC<yE1*YycaJ(BgQHk
z=}aPb1>E6bwI0g7sYWeg#i?ATlc$E9dUQcW41%kqr`*a0_KH}1q?=%+@XTjaK8}^?
zLuc{m(x2ALJE(KO`cjRxs7b{BtZp!h0h==FVwv$>+O#aa@9{c3uM7oxGD4M(R8z~M
zK*P704IEmn-2Xe=d_ZLfW*`KnHzOG`K$Kgi;kx?v@0fGpfse7?r+^{yAs;Q+`4;_9
zqVYDKq)5`+i=|Dn?cXX~_&^&+1NOV~yb;zV{L^`o(Vo5jY;{yQp7?QFC=P5r!gLz*
zP$nk^GizqAdoM2*=%9Tfv3s7~9OU0{MGQS`dBK3|oMu)%?SD4dodleD^tp1cm}?xn
z>093@;kdPdNDuKAfm4(^P*A$dxf2oh4Tfdft&CDsYXw(-%<Zl**C)7*x&P!aOhzm2
z;JWtS<8+vSdUaw9qk{Bg>Sr~by}7|8I6L6f7bGCCL$;Dgl83sfX?sxN_;zsTPo|ZD
z%T3H54tnrE))k9w1T71wO=SIg7$qO4KMA$(PQZc=;+Ec`4wXUXy#mr!r3+vB^HQ|u
zN#Fu|O)U;E&!8lY_{tEkaD;OnGhOC*Y;6_q=aH|7MIN!Zhhd1K?ZJCNx*zc>DOWjj
znH~J`ab+7tmU1(UQn2?A>kL5?6tn5{c#7U~U~-&-V1(k=GzjB5tYyC`pZO(+A4$t?
zLtjc=_>M$VPeosJU0|Q0qOQZ)W`-HfVMYp_47)kL`Yq$Fm`nySXyyE+<v3H(+;RwT
z!obRsWze@@H$Timm1)2SygN^}rDEm^f=k@DB-}>Al9y5#p@y_(!@V}}QH9-^s9RE(
zG#k%CBhR3lWKEgtNb#*`TSL^uX7a12bmEpf>8L<{OjU1!N%9zB#lGU!o~>3n;v!a-
zzVXZJ5ltV_UexWG$93uO%_q}1BJCRcXsZ*y&A`)5FM-cGu99dl{CYbq@Ih~zHa*Q$
zU(q^SD3h4{fG(C#_roWs;n`wUu!D)<M74n}t6Ci&CVAFn+<nf4jvQ)Sb3mu$iGgr@
z`CH7o$oyKQlCPy<(9139*wTQd16%Ft%2&2YPsiWT=9n@P&(GX%?^k%2Eyl%7mW2SG
zGC@03Amv;*TwkX#Ak)<8oxqO;+GQX}i_5!gQP<VrRvdFOEgP-|qx;I_D*TBZlJ}x*
zs6_elDltW6`8w=w6_1n`qt_B@E2<!#`V->t$q`u%i-@dJfPe$Ba$G95I@*{MY+|s*
zJ2<(QD;ML;4sZ%&2_N}P_c!QY!d#LLw-P8R6&>C{VvZP#{#3ad*skQY)+{)h>o_TG
z0%!|vO#^!ID)|Rq9NxKCi6v*|l?J0E@bEiFol{HT7FbhkcQF@$uXq*BmY4Y$zC=s-
zqhI3axKN{bLD0#{u3Lx$bgmrTTk+qXaKAtm@pGsRlUFB+6Wr+v8;)R-%ggT3dyDkb
zh`rL}Fqw)Q#g=<1s$^FtX9(^3PHx3c%jH(eZN6Kyo|Y_!Tjs6<ns_ypB6l12J=myU
zfwzx=$g0$P)ke%mgZV_yYTu?NJQ`S+BMde?!x<46QM@fhZ>aRAOcW0Ilij5?F~L-a
zcayUf29bcn{+b>_Y6TesZ=E}QR9V|$ac6Q3X_FRS6@N`DGI6afI`1A7KIeHyP=~gi
zCv{%`ie7QZTseF^=z79z8xyX)6ssC4u2y>Um67u^OpwVRI+qp!YvU5-65{x!db&!8
z3Z`8Ep@h&VF}^qm>bEL{BTGuu>Z2coOF4^o3lQ>gEXzNRRSIEP-gY}UYT8tZXWL7<
zN`^-L8^l{^esYsl!yX;HXIYKf5;d%s6J(DRq^vD&robZTCR5Q}&9#%MjqE#Z9yQ@~
zGvXVYgu`%k^Q+0p$M=nrYRJwi82W@|2Ek~d_jbmEs63GAbtkDM0Y6xOf3_a)4&{T(
zavOXea@oG#8ziQGU+c<76RPcwYREyrmeURFY9UY~YT1?YKy8F`BOXp)*$uFW!4FW}
z-S$?!RR>l?kp6rQczrbR(v;pX(au#*dfQep0s6FJp!QsMrQQ-vV`$V{NXR<>|BoR^
zFfa<p7NvY3o33v`&!syc#85g?N$g`3)?%^9PV0DGm=ZuKNb=n9Lu;vOW%(j=a?01-
zgseds?Id~fzaooeGNuy_Tyg(di1XqX;5lK$#zeFsdG|^kP6W#8$2AzXgP-L4bZFtI
z9}g{GG~+iI@(=OsN`BA{bnfHedI6~E!|rJSNP=6IDT1MlO8$2tyqrmC#;?6?Bt!xO
z|Laump0nkr?gwP;gdr4vV&^tZ{a5g;ar6Bf7$teJ_iMakYD-r|X*(S&s$dE=@kAZS
zK)LbHve1ut@aokOaG%zBA*+<rC`P~r7pUb_qhW1BUFr$@6mkhYH&zZgX*I~x{-)y^
znN?T}#m!HY123r<`(C2`M`uwZ1X*LsoLqUEvS_uMbR0bG_&Tvl4rl(h!ZHj!NKUFB
z<gyi-tKM;jkR_AUeJ|VXZ-n!ha0ad^A89D;=<n@+ms@-p5|MKMmigSrVel~Dd6*L)
zadH#3`^)4c1TOU#i|{WB^KOg4YmchiMZRaXKHWKlqZzS4g!I8KW7@d1-+;pDlPC-p
zZ<_Z@!|J^tcAQz0jTHA8_*ZB9o=9l}2uu=<(L#(e<OVNUm2)v7kXH~&rd_4CVy(cv
zoS9gPuhu*Ej4wf>Z6&1!>oJs9O?$EZ;EY9{*_N4rj5_^JxHzeU`l?!#z-QX+P5SLO
zGj)gR@u5rIgd`F_vn1S&X{UXx0&)Wky&SB9ydX#!rW$YkTQJz>L1jucI_x~a*^Uy)
zhw>1mnw8@_E9-z)xm9>W_(zraXw#-MCqd1QsGJi+d&S1S-=k;zsH`o2$@3>yt~riG
zx906<4^(SSUhY}nhNZSG)N2n}Tm)miI9jZ9-k}1x4sIiDD`+*X|DG52iBGeL`vz7{
zC?MM%VF6?~`*ps?ZOxH4-jsFDh~B&oc(cDDX1C1tF$g#AneqW`01(d_7~I0#ZQ{|e
z4;b+g6sd7tDsWKankbS&QlPlPYrH()|IZ*7YeC?>qc#lv;dEXvRAZg0KsYYTNqJ~T
z0u|bv&Xll!77qIq<rIVqQAmQJr_a>j=|Cg{!t^fu3sjYZx<c6<%IR%*nWD^sFppvf
z$4NN^;~2xloh`Op``J@eA@Q?u=Mo~1ADyUNALBlWy2#Xw^_}PMJAP8u8(#94aYuZ@
zUa$Dhu)m1x2VTW$V>;f`t8f~h?TnsHGPO4lQuyv?7y8r5Xq@Z|u~lqNrd9oNZAg2)
zONAi$swafW00a&_KEOYTmyxj%*WkUQCU#&IQ=ItM{6(`jLmiIb8rdN%_PQr0k;|;-
z@lqG4iL4#fKa4k~Ad=$HQejX}>vqwoq*{Fk9W~e%-W^I<-dzZUY&i1Dae|NPx!J$M
zvVcDkGBaF)M08arLN3wSy>SSSE{GDYM%UWa$6;brHe#9^oR!)keZiVc5g;uqES1h&
zpb0$-i4BDp5uHTo(i1et^uAgwLJX|fnl1}8C;@HMeT5*xOBdZqIU<fOab_oeH}zfM
zi;-YE$5?~I#xx0iB+q;!XVKm`S(X8zrPbQJy{GiW&5!+?Fh*jAF01%YliNKVYPy+`
zxKX~Kk5Jnhemozlo}kcafk#NiR{_#dFG)i~+P3F5S8sqIS!L?~#wbjz;z1h!t3|uN
zaNWfXzGR_+t8_$iXyrX%8c4d*hBXBCNP^kFs|%>zrl}fqgYfDnv^4=2){=OV46cy$
zSM%I$NJ_S`(O75&RU+XQv5-m@d%=^U4QI}-z({r-%UF9yH?+*aw}~<G_o%@`tUmHE
z5yjnE#MosujJ|*w^ggR)ssPry!t}UTiK=h@rk?Q=7cAqw2&g)<PR1+mv9M}u{B_;3
zo}Wcqd(^1vgZ@Z~3zgtd5bKtfDT(}_x&1v?nh45KV-fXW?5=YqBcoYxH(_;7*&)RQ
z@&k=o*?4!A-W5U$hq&gh4r@T~AtQeiulXk%lt*Nc7>0%O5-3~bS(D`bQZq3zy;~hY
z#TX054`=@?Rn|lX5d3Y%K!2U>qvZ2_whM><Dl$sXD~ksf-}wOHY0V0%Uc%Rk_dFv_
zAN(~<tJRnh*$~5rfJc#ZsJ8L4%pz(<lgkAoP#*FrKO^8V$oe833H_fe#lY;2{cE-m
z)0{u@9nC2E+n3_&F8gUL<O-nfYoE!IW`y-09O3VBnjM&B2ZU(Qn|A+DJ5f6%3q|ka
zO{ts5+2#gwy<H!@TuE>uiX>migMU_jBHGUAc=-gdOX-xX=w0jz>tcQSLHUg7+8oLm
zMt`4@?DKw*04|i_j;=w){j1I%tCzN+a>O6+GOht|Fc-Rh!CUmYf~McH6Q^|c)WF4`
zd#~W&8vS0NG358}3@E<m3QY@#!rQ=C(DZ32_G;C2#-t#<yCUF)B@%#{`=Jkj1fqWf
zxZGwQ$bV~5C079{0R!nI8wDW2u31J(k4+f{<f6z#(PG_><0?06+0r{<fgnT9D*1Yr
zMJe1m$M_Zhe5Ouc&+XmotP0x!QxEYP^qeu3S!;Y+g=&Z@gb%4geDPXM3_4<(unbey
zq25zE8)kw&rab@h`~CP)$yp^e{*(}><e{Eh3xdi(<gT!$daq=7*E0@nCTd(oTIVaB
z)NonKv-w+IM_M<dZ^ty;KLjL_b3sU`yjC2>g1PeZR)sQGPY&M-V{B1jU;a?`=idxk
z7j|;84DpQg<Jh!wHUE84M+pa1bW1ze8wsHGgs2XkBAG2K-WS%Miks)}43Dq4Ac({0
zn*JJ=kUkjs+Ijvdpx8Z13F;U;(Q+9E3WZ{+NL6RnTP+57sEK>NK0l2TM9A8r{KFYb
z^GY=l3!UG5L;O=u5l7|oeb_f@@CDp{svnOqjJ4;V>*4P4p)<g&yf<o>WH{}K@zf<Y
za`mCumHrbA_I^BwUTt1xo`RN%x3u^9ohC-lX9iE1*GJ56um^3o+8S{4pah}+Q%K!M
z98~1&=#DMly35nH*Bah!juXT;xzs&$#Xo>Va51F&W(ezOd1*l#&EBLbj7QZ8MD>*y
zH?KlCg_%w)Da3goM_iM?#b_p8v-u^7<PgN16zbZHMya(ur}gJN%K=dPID-OO^iv+$
z{A<>qugN3Zs8r2tzyR!=T%iy{qEXt}CyxdvWb#l;U?A$*jE8odDKJJ((ZTs{(CWfG
z>u*!0&@QXW@c8{`*GZPW6Wqoe0HSoWZXAawzvfK<4(=E{l<roPfZ-qjid^8Rzs|lC
z@o$7)>yKg>dI6&eB#B#EDvGLRQ=nm!;71!wATYJIS3fG?S9i$&3Jk-+?dqvYGXW)Z
zNsk(~pT%`NI<1$ys+P!*<ZP?Psk%RYY#nC}Vf`!PU8J74QAl!PE(M)ho!}}L{AwkK
z>s`57t~fi<3EEDbu;}`RRtX6GA@1nXW?e-&B})x#mlqJbp)-NQPdPseOi<l{l@)lZ
z16s~#595=9UNK(OqRRN|uwhr&cmd!8Vd$Hc?`>NtlG6zx!vbksN*dM7-JyB7IPq~O
zxTXgpKfaVU4qg6e-Q1M^$(z+G!M9m)f0!!15EX--G{-^FTs67SqQ{CjT-S2l9lC3=
z89NBy!Pac)aL(!MO9Md&<Jx-Hv@gZ5Zzvj4m()>eiWyJ~CSh`Be7PTa%oom3U&^{N
z@nUZ(1d9Zp;&qwcE%LzugbTklyF`j%rEgsr-E%JlQ((C(8V6FSbbgm%&>i14V-J$*
zdo)sqVq>BaL-IfDjOi>Ba?Fwr)yteHf!;2HJ#w|WnEMNXDyC!6^~47xDYjk*HiyD%
zR9rx#lFS}tUx}t1OjWW9<!t+xtNFOpHh5oJlVTHq#h&}o@lofH0sz$3aPA@!*r>%+
zD~YZBcz)Lmjph&VkIM=A*s|I~<@KC=Uc4eOMa-WdIq1G}d2Ihq`kQzm_gn>H6s0~G
z-Gh<GC;R_}GKA;IcuMiE0u$FuXtx-G5-Cyg{l#<Fx*esBIUO7R@fU9iYVQ99dv}L)
zZig@{b5jz~uUYpt1T4L86Exy28x`Rqi?~bd2&0gxuO}dv-E<YGJ+2+Ekb{+zrNi+@
zJ5BDE+JJEeL5|ZAjitJ2g9T1+&7{OZF*wFS2%E4h|5TQGaD2UXv=(Z%5;Cn39G^-K
zES474@!Gt)D<{O|OC&?2<0T&zX5Gi11O1H0hswM|#<kUq!NkRUP(TQm)k5Qw#i5@(
z_`w@Pig&1MYF_J-oOc3J`DEx%9_pqz1wD*F2*<&IRR@S7sQ9EHUptF<H>Wkb+DJDF
zMF@`4Rvm2`UbJ<p&BK0+CgX8aF1O{AAQaKwfnmo&s=`?qvJBnQq<&Od>(U<~#%MTH
zWxVyNt;<$O#tNd=JN?RNwJ!imrGd!{+zj;n5R7h1N)=A2J^?oCrbl&)bRVA2++8S9
z9}Kw|c!Vm-AM_<tl5Gn*tGR+bhwAm{bI`g%Fyp~6R(<|?cl(dcf=*F)vr7%M9hf7>
z{zpDwUZa+RO!wE93B8mlgzMe!pSFA9&L6_!b+|w=YaoSUK^0lPH`q6wkvrKhI;VGY
zO($-K@KmuekQYeJr?Fr|2VWK7Z8K=rD@2~0(8<;&PXa;;1v={T7sAWEn$4gTKG9|l
zpEscpnHy<4k2>`v28#~hi7?9+_$huhewN9d380#r8wpbc{^1IYM=vWQ^tcc67<T91
z3~k^ZD61z?1Wkhkk>$L=aF5Ayz&c@k^xN<kzchy{q!8cYB3&YUN%%c5omtsDtglVS
ze2Dxs#)dyEj{f^zSWRFun%Mg~tnBDaWfSRVaz(@LUW1kGQ#PReaH&-T{$*RdZvYe>
z;>YTrjDwTxv!@+}{NMIRBCKVMJU<>CM3Vl<*dSU3jg5!+I#<dpgdBO4hB>7fvT|BZ
zVvpObw0PX$vIHk6Eo=%Dg*Y>1dJ4p)zKWgdf{g@2XcBFD_^Teo8IP~i=HeD>b`1?n
z)7dcT<#xXlhkT1Zy&bngk1bYEh|!Aj1vWH8Gok#0`iZVTi6a};sIT!rbJ+ju(9W<0
zYNa55O{QRFebAzQwXzA-kNqV*ll@FmfDq@HX6Ex4ZjSJK!`QrF)|7>{5i-A3FBBrq
zZ4neJ*V625K8odif&PnsWyRr&$uE_s@30qZHEWU*h*OU8>==X@m+Kf#(;IjDdRINM
zu>r^ZO@&l*TAm$@8WHTB!%TR#QOmCa?E7RkYuU(Jj7pNZ#f*8j$gqwOx4U&puStiz
z_I4vHKT9L}l!5<dTK~D({7)_f6`9eMy)jVxx{bML^2g}+>Rd-|FUK8K^zYAHOm^=l
zKvSGSHEqKuN=K3#X`10kRNu{xbJ%r;4I3KvL$~OtB_*=98TmDwrbT|1RL4%$KGwBG
zlH(t9a&rOuke=qQ5ZmFm$;}z5o8F%c`S`!R{k;?zoDET@p_#4)LShLk2Jms&&4M3H
zkj3RA#rBvAUsSzwn>aFVR#g}0wLMLdo{1`qkMAK%>A9=Fa&hSZ&Z@4i1U+?lidRgn
zLh*<<m_c6x&li_bbYmsu?``+p86y8DI7QRbDsH%-EIP6mwB3z~D0X32PI0asB+)NS
zDJ>Ps3&Oer`|-nGN=#)!wr;Zr7r32KYdK-oIw@fnLhrs0P3}twr*XX3c@!tKh$$jn
zT2Xm<%cmIMiE<nHCTig`G#z2$jzL3^nSHyBNXnmMWFYo6i~G4Gti0F)KjeXB5DxEJ
zg1_xoVBSD$BPk)AzkuG}Ypk4{^R!Ci_)-dXL^_+hemh~B!rwwQzy|cMyr%I}CTP!U
zTZQerP#iFqa(l^$@?sut8o7ZPeo2ebH3ZTZFDIDOx1XAKVJ0(Q-`8V4>4Rn2twPK5
zTmxQlg(>1xv_%1Cd-H=>Am(@MME<amB*@1+B;CnUj2v1MTi<Hw{uC`c!KnDcaw!n&
zIT&}-N<HF&J#Hz^7s%)rDDT42ii#f347^+F_GXsowl8L{C;`?7FyB4QFmwA^^%3y+
z@$rZo`cgZF8YZ>L%(tHM!MZ<#c##5sCeZ+EjqHVo_15RkcC=}e8Z2yKTsW1(5EvFm
z-8P(j7*3}%b8!^aU-j5PNI7Z`ci4za)*49GKu@}P%PQck+OhpceWpDflQU5?+b$Og
zV~<owFYA>jzl*}j^xW!fsMoLI`er{^d7^M-^t#KbLtdVSs3B1x*}^1HG)Dtq3dYRg
zJiXvrFl60Xw%@4jE$42b9K<1dmQ+2<cG57*9v`8tSpj-20@za;6&Vrh_Bul)qq*Ak
zrmQR_1L`bFy|NIrcx0m}TwdYQhuW_e`{1pk-1-Zdkjl~UUJ&&y_+nIEBnwOK#kPb{
zPZh+6()R8~08jCA9wl3r!}buPg->d;kZ3@9O<1FBKVVRz-`&w!XpzM?VfI~n>)8`x
zY#HFdE3EXsHyo1OJaFNJRyQ0uxV#L#;qTWfBXhIkwaGGS`_#V6fwEmiw?!~_h5KP@
zaDXj>7}#{sq5zZt+}s~qK-$A!%p+QH5ZhY&09bS-7k+ZuCIV+8V0{Te9Hi9^fwBjl
zg2<AA!_>7ZD#&GiC--kW2hLnK3mmM432iR&&S=G3n9tvcz0>&}w^?$2X3TF+=(DBL
z$S)284bRByk=2HaU1Fv2VzBXj^T}@&FvnTsxan0lptzxK7XQ`@l$PTS#*67VDoMb%
zTN0S!`wQXG;1~u(!6|-#lDDy8%>FF8-u=?ZAI-CKj@e0k2zTkW2|>4w3mGUJYMP1e
zXN+YC_CT%-bT0n*y`F!U#?kqSWPZdn;O-=R<-o&4LE*=jEsWEM>>lVO8qi;>3~!Z#
zfu^c1(G)Pv($IHp*_z;5$d}ZoAqxHG_sXZ6ibP#4@X%_<s#l8qjeRXCm<K_>Exu9$
zaGxJb{n7s)7M((q4()ndl+yNAZ(E&5#=JGG?3`VwGEH!q-~2IsS6_-qH5jVLx^ZcH
zsP%v%I+!!8+UBjm|3E}b51n^F(^MmXsS3^Eovp2rVGc0l`-gghylapr=aZ-%dbqJH
zucrwv{@gZ!V@XA@32n*?A{aK0^w*36rZR&YN@{C3{EKpgJk*wv^1;0ip}$*`Rc?q@
zn&D!IIo8lQ)PsLnYXO}UX8XEYrx)0!J_q$jJsnQLe8r!)muLNlF%^&yH}Tly%!=$H
zrtq9!IqjUhdGz(F$&LWGSq0CkSs3<}Au_r<ZD#f}q!3Z(dJA=UNq`*UK?k5VfWDlb
zb0F;CW|#&GUhxe}2#xP8n;`maU1ZrX&8iNR4~{L}>PeHEcT(}jSlivJs1YK=LQUfX
z-xiXAh}44=8ruwwq5g@xb#z<G<v4v&=kM8A<_;F6r6@1HXqLn{4F-#%CcFpP@(IX(
z=iiBQV`#yQMbE!_?!!zv-5FPE&@m9y(l(dKHI!_2URLdgrea9y8Ug>ZKZXP)!WDxg
zFHjV0t`DZZGC$1K!Mpmxk1;aVfw#b*xI?ZANTOn<ESD)qwV$rI-%U$v&fHWV4m4m<
zE)_Ip@r^{dhm^M9=IH;GiBj!dmaok{)n?sK<#^lP9A6#DAb~nPc>r%@sR`r3#H5n#
zpG#A9qdA|4qfTOXT0KamP_3`XOj@OfAfyW+lkTBuf`=4?E)?UvW{eDl<NCY#1)6aC
z?vd|5^LllPORm~peU9Y6K|A<OgqqG?iQ#U|ly4@irULR6=hwe1HCpqf!yZ3dt$PfG
zHKO*r7zW8Ui&M7=F@Pb{<!A$~PwKGxoTcE>KLpUUcK?N&jYUXyomPsl1B<*MGPKV8
zB{0V9e`yYcS(s{bcCSX)x05fa(UW7bld*X9TgjP80AeW1qe<YIMVZ*RaY6XB`QyTD
z<%S36@Sxk~!{<qvN6C9!kG6u*a4MkQBF?>I%T$6&nQ*8c^_qGKW?PtQ(2u7aqk?Ee
zmysL@*Ma6~c7bjIu<|-6yh%+ijOA=SA<)<W5mYW4>&|+`9F|^xRpFRWP)gL&fUROv
z|7EGO)L5VG`&}c+<ZEJy+XaXsrAuos2sRZwhhZi`4+U{JlLXYUi_8_}(DU7hY26QU
z0|FKpd;HbF(-|t@L;RupZaz_t1Kx1AWpz(yjki3UYCpzCqKIm|CnO(3pgCsmr&1%l
z;4o;T%<G;~Wql~r_J9Tf^3HxUGNKXZH`~wbwjbX3l$lo}M?Pb4a=od_6rLQqo=;nA
zV*u>mC5$xS!vuApH#h$nPzBlPe&S@-rjqK%`!DJ<lI(C?mkd}k>Nm@4=^GFPkJp#P
zrQiB>#8(9?Mdlq!p~8K8G#j0OU3Oq{refFfv|pf|b!G-sC&6?GsJKR#-g&77R@TRy
zYM^B6!UQZ69@%k5C5gwT5MoKt3A_}FAQp$_TjBwNEO>WC%^ko6&J+DYku*1|p--;c
zl0Mqk{*O%&71)e}{L*w-HE}hjXdM^x2{A2?!{A54(`ef^tR`;FIC2gILkdVO3MmhY
ze$Qe&T0Qb=f!Y(^3FNz(ots`%Z9oAKD=j$-I-A=tJy>D7qZilO6LKi1M(N@d_c|^5
z?gk(S|7P-JTa=k|=&Y+1kC*jtf>9#Mx(0J1+hBu&e*4-#)^pzSr8W{_zLPLy74U70
zblKyKd=62qaKNrx)x%t{a7|rKs<Rj?P7A)1dnv_W$mC0~_?>JQ@-7PPKv!=lfE+{|
zKK^{_<(R-B3{Yt1)7rs;p{H_i;%NQ_NImDclknQGni=a~-TRP~IGHv6eyj8CC_Qm7
zizHa)=Djo(nekO(nKbSF)@Qcr9bZ--=+MI3DPqUGP-=d~`REvW|Ds^E`zjsDdu4_c
zgYrnELx>u-G>gAK@NErdN*_C(O`Fyk6)&$d$)KQMevb1IOX_6(lreilOwXr0P~>>f
zioLBG;tBczVArsISt9A(<58o{#RbF(VWo}$pbMvVn}uA&IHTgb_X5UM9h%?Kw*gUH
z4;Lbv1NGlJj)1BF$78MsKo{8$<tt~b)1e2No-EJK-y}?oCA=ev1DX!%AacVeTbv{8
zF>W%!KeC|dHQtxi6!`v`yLg-|TWa20FzhS00r>}-%{Slc*(npNw&}Qt#lAD^F<I~E
z2q0@@^t`*j+;GyTXJfJQm-#csI<=6~!Eo@EL%4O_RC>!z%R2??6bAa;M(*{~!V2fE
z?3F>8Wi}Lpyxz2JX8&mc%E!c65~~@-5vGbXb(S@==&5K$h>8SY6UcnK5dI#fi%Uf!
z3L4V`+;7Rqn5<l^kp1h-OuEt>NWt9f-XvXjjUr7+ex3(qE_yOO*KkUm&Nw3<gkC@h
z8PEoL?wI49+9cVCB}x(Na>s+Z5z_Nu@YyThFC;<brs(ma$>4Chnp#BMSf1{lzvslz
z$r?zDujt$MEDzjfjP8jiyfq5nj<bA3&a~Ovjj@)JfljpBIq<c72<HB(qFseb4%*1v
z-ZL(hDP7#RGsoS0_^Sp8C;E{?&w6S7GfYbOr$FwXy#&M3Ypdz`i??Xd{8O>Huz`*G
zDl|h9Jw4Hlfa>1^eDoSw5K}!UvySCQ0oh)att#z0<=Wul=EX1dP_qA-nJrmzX?ZDb
zEzVaCHKA(05#m<-k#o1t7tCUDs|cvzhVJr|H8&gtq$ca;HMnvS<*pvrOW3_B&sD_7
zJQ2F5WWlU%Gm(BX(_W@)3Q$$7NeGWT<(I&x2B0U28X)nPVt}OViYW{?r%HP$y($w}
zW?gUY;%^*SWtIqiBd2)%F4P5DNO>{yK{4+<36)@d-v1f2L_>?d%I(y_$oc39dzYS>
ze0LLNQg|~{6dtIpD!O6YN>C`7QEItyZ_dSvP*$Kt&1~{QHd7Z*#DJ$I6>~o^o9n(e
z7Fw8#^+w58#Zq%UYH^&dbW8^g%d@G^dsS+y90C<kKt|($lae^qxa$#!@#{2p5u0aa
zEEP60XUCaZ?cW>-D1$+X?s2R(`Q$zDbWB!N>bdUrEve3xe+>-prD77O3UsVyN5+ig
zhsw@q@i^cQm?WFQbQ_BNmD?@V7Zw4mUi>C8@;;VjaEX?wI?1>}ny7>-q;z1Je>(zR
zFPZG$Hz`qihl&z`emb1w7pd3^NNqg+jacL0qc|TzZYDirBI<F>l*8$h6XEx5Wl3Uz
z{;#Sd28xNXU3KvMwpCA?UZHL6IIAR8$@!6DC;_}0FY&7B18x=ED5!uU8+Tsch^}yf
zZk;{l9vb?L+t~r~I$WR*96+X`HBq><R04CQaTxjk&-Vhn6I>ynH1A>TJg|RdVh{s5
z?22d!k(NmA@)cc419xt)J%U%M960jNF1ndNR`)_sTU4@O$NBe8cQ+<KML9ThtN=tZ
zwN+^#qIyk{#$S5y&_%`8prV3dm((mdm$tV`QzZw|1jn44g)7E%>7=(q^B)0))PD$y
zID4YZh|#xs(9jbuECtT)%{prGU@w%l{j$$Eu{>m07SzPehDY&%Z8B!-&A4iftzhP!
zZQ`d`lpT7?#LH6H2!5=t?MhK^sM)PS*anTP!4ij()UI8B%YN_u!1U_RqL9wU3!b?$
z@n_QvTE=`4cW&%C0E38K))Wk-d0aRu2)lHQew{o8pkMN6z|Y$PMA2aG%Ju*5UK&H*
z1SzaZ_Nh%2E)lbk_-r}Po`#)9QUyzd{9>lVvl+9PeAo%Nep5x1-twdk-;Woy+Wz)a
z1AQ|4Pkk`cUAtemIb}F{=#HMavhklbDPsdBw8-2f4y%4e5D$>lFTE1$DZ%B1J)!f)
z_U8N)fj%-770Yn?#vy<r!BS`Ln?wZ29I8vH8|e??tM8%?NZx4_#RKB(VpHI?2(BfH
zxBmO3nRY<Wa~A%`w3%&I32AqZarK+$iqwPw+i1A9weqSc+ZU=7V=`lLpXgDMtB=sJ
zVLr;{1xCpfD++;u5Sxj1)>=zb5RayQbB!?vt(H|<A=NlnU#>k<GIMbX3YSfbwd+jg
z8=AD@SubQ(e>|)F2nf%{Z(*N-#dRXO;;?oU=6q9Xp<)ryMCJi3;pwJ@p<CW!qzglz
zfXF&S+D(eq0dFmmGE{W{#zW7ucyh0y$|NfCd`3CHhpX~aBEZhLjEpxjjku?zH-cmn
zDuuDQCDL)zO4!9=?mzeGUy<N}bO)N0lS8Vuraf%Sr3!=^DWhDET2_`0TO2NRPd9RV
zE)5sRBoLvz5&e2*<oY>0L3?w8e)mKPxA&W|qb4#yKQ>S43M3IkuB_AvGA>hBBM)}`
zRnhBDPfuYz$(up8p0H+7F*1KZjD(*kK~c=RstF_}TNkRu{guR#{OHS=wvSbazj$cP
zcA56OCVcJBCfesTk2G%b?)2I3ane-)ML@d0J~tB0BbzquLIIp-;}Z4iERImi8F(e*
zsErTLtt$n~_dx_=ilPWX{Nt!(>nHo}4t@n(B&aDJ7OUS|<@)5Rcs1{%aP$4Og%rAq
z!l4}oCgrj7^10q$md?pxU5qh<QJUS&=?Wh_5DYf2`CV8_<tt%&nxpHeJmWxzQ$HF6
zQLD%yfCRo=j4VEP15{|QRp`oLY=h`BxeWAG(iM<7IM&Zd)XmMMSX{!-55(xUbJA4s
z<+=v+KJ>Tf1zVLb&nFUG%PO8^2FJ6k!+bmow@p;~&jx5$0%3w~ajRUQjA+<B0JuAg
zdb;rUpYbQwT6deKivI5Gkl$9GItG$XWelpYa@S9&Hj9S1ZjmqKCZOZ{P8as<Sn<wq
zVoD63q5g=*SNRq*I#QbHhMUHoNkB&jp^F!QfK6I%>sbNpwHtj%&{6qajp4fFr`ons
zobKP*N{{rHscEDh1%=PTF75btXtU1%hI=1;=qDs##Vu2BPCSyA&_H0yY40(8@j^_E
zmEh>AdSIyLwEZv%<2|E|U!_(*ok%f>!_)GnOAzuPJ7%@#!>-!yEys|Y!b_*pedE(X
zwJV1UczJQryz#L{HlG&5P4<A(-u%A&(a@v0$w+dqoSLn(M4{Q59ch?IlHlfxU77h@
z9*!OPU@B}A&tba6MMb6i_8ge$D_yb-vT>5~^G%txKYVV1tT8h{^;>e>^2MCF(k4CR
zrAeT(P_vmec+s~R?)|k{KZp*-%n-TY3C^e(J;ECa6j`q%LGuNxD2XKz=SH`u*Kg2?
zxJjk5rxM~*ft}NqmqVs9%BRI+W7}TsPYGvVp8EPD*x*2s(-W$Dh*(~Z>ZEk}AMMDW
zTtrT}XxbUqB#mx_#Lokr9{YqrJ8{GkZ2!5@3B-e{p4bs+gaS&=7!t}G;5M4T-i6xq
zNsbCWVX(fSUZ9!Bg-3=9XG}{ixrz2FVs(YoJhzRx`a;E8paQ1d_y6iJ7WIbx(}2H2
zb=A<oFwCVDJ*QJKTh&GaQ|Z^RK&*W0dUza!c%_4Y%r}rPrAaOUla1|mq=jNCLdeHA
z>&WpPSIa*!Yj4n?jQn2J_7P)x@8)h&0jzf|z&oW%Xa*#;>H=M=BbjH1Od=^`h&9-(
zrl>K;N)^I-L$kKaGZ|DYd3EJw`pd_yl>5PdEDPwNtuCk**>_>qSk5>CGo@y587zno
ze247|A8;-6mm4cJ(DsL{8mZ>r`DiY94-X_~zDG57NF^`epun}wWhs<?xs7~YDfV#A
zpi%#G@4Ar{f0m0k-BCnUBj%e;{nGnyDpVU%fmV}Ba53TW1g0W!`TFFEAXGg0B&x9d
zOp_3p6Tsg{G%@1&gYhsWY^*K$#QYHy$dOH9Uf{T?3VSlh-;r2lknD|?KkNqDUoQ|a
z15{&ZHJVZGL`*u-PN|lBe;Fcg_abd?nQ6WVYFUqBxk2UNpuyUjH-NP>!uPm4YsQx*
zQ7d$m)VL(nSa`rCmqW5=q()x$?`hQpL5tEx$?E#f2;}~Bxfp0ZsXWVC%U3+>w3S=S
z6AC5?Ht5Jx()lNAsG+Dlwo|M>3(v;A7F=%5MFi+UYibh4C5J<0Uk>`PwDsQ9t@*3)
z<8IR;qg3~@@gbIPd>ghn89FTa)$kl=Xwi^W63dTvo>q>Q!;fWCxnC)q_nY8y6>cxD
z?M@T*DO|KOGBgiqZ-$c^0M)0}O{|QcjTh5lVNSVoxXNblb}l5$$z-=D+@~LB$^DlC
zWedwS6(00GppE`B9_Aqbylh4PfN=fhi%-DS#JDgXO1|qh@Jg*vDi3p7cbNhhhQl}o
z<E=mBh6FcySu1umn)RJWrQljcb5q?JLk+!_us|Kn71vh%2_yr*yXe$`+zavO4S?I1
zM41aFe;b()d6sdOnd>Ge7VV%z%{_aD;sw~9jIHgj3yAKfliNSidFvr;SU_{|&S=@V
z86AWi<U5cZz`>PRWk~l_hp^8j%*xmSeYSX3;02^S6LJ>AjgCLu**CLsH9ECfu4-6e
z$ZM!oFM&`vB7PiiXV>3p0u*f24%WQk4}Js0OEvt(1}lU=_@t3lCj}7>FrX}uYO#1p
zrezF>{XdG8kdarFRqTrw8pMa|uG`%VPi-u=OM9i{eyQI^_Od<GUSKflU8x6T>}+So
zgK;T_YX7X4NOvHN+OJbtb_gKEYP77DBD14B<Jdu+=tgO6u(@(X>mYo>9FRTajr1Y~
z0bgI;d2;8{D4}+cyvbHn>G=bc#{06{p@oxKXYML5VyfgdVLP&7smX`L8*SQ#=Pap$
zX}MVgzkYqCD|<Nav`Gn@36iAgJ1;ZFvZWDgM>l3~|Jk`e1(%dfWcR|t_6`KkYjMU}
zkPTI^EdwEj5!%cp7(P<)c^z835LxR&4;7yEi62|JqFH@U$Q1H=Jspv4GX?(mO%f?4
z>WDb-qv#uGMjliqW28YiD;LzI)~$9~i7~^-K#V)laSqObonJrk;4RPHyZ#S}FsR)+
z{Pm11ayH^A11|vM+R(VzB{%C*J-XrTNjUq|6?swOv965A1xJS+p0Q$pBPerwjh=Nx
z$eNZrK~7D+zSMbl(ggHAD%3(3-8>a*F&~Y={}2qIVyQ(!Eh%;u-(lSskM6lNAAAr+
z#Q4bT3;RP$6?<7~=UTd9%W2?5%b*t{Q_clrmH)WhoWyXIE5qEc!vfwsCc+$dU{v+<
z)FX%nQAwf|WHkN0wb5cE7bue%rvnN3<s=sN)PYGdwNiMAmryIwXN9KJUA>#)zg-yH
zUQOWpNXEYr?^1mVn@m#p_sSS8Xh;|d2RQgLgqV+neZOIz-5f+DG8<C`B+-ZA^VP%}
z5UcznU~az44YMhrsNHk5O-qU|i%7<<<>ekG5}{CTB-0E66KsbbJhmy4bM^b@uEEPc
zcHq1oEC6-at-(IZ@z_2{zEBm5gqY--`fDsH4^Drzped@;;=PbZbWke!l4Mj({q(AO
zXo~-z?yMv2@)-{+r>+S`%Vq{L5EHzO#$*<Qf#h}AV;HkK?N<m82?1Z-EQ=c2Ow|!0
zEkSvdrr(`~%CmbM3Y~a|Qf5}NX#cOl<q}gW^N_*~inaCtwn7xN(J3L6vIFv47tVVz
z*az9Ocen>>Ni%mXU_nK&M}4vQY}=BA?_1}y{UR7-@aobJO!oNVjQ)Tul#~Lrph#eN
zhch@KZmK=>FY>idTaQ-q@wKR{+@^n5iH-#r5!33g>)3QzPfCcppp@4z2IzEPe)7dM
zq2SuSzmsMw5jDtR-pOT>?xt57=V|3!{)`igM1=1PC$b)2tG`3f&DCdO1$EPYa&Ei@
zKUF%r)$Rg0xz#j8cRW{xr<^%qpzD53L&*1_U@BSHMttXZgp~N`>qgJYw@OvPGLZvo
zv4Xnzb&I(`n}-iAfF3L}u&xC*VQ#I7yyp8nvq83(=0?#N%f*?5I~ENa0wy0I;z0Vn
ze@Hve9A84@a?Je`8*=qw$dE|4zWe?pYXrbtjIOq&Vv8DlI_(dttNl-3p;Z+bRFZ&X
zKvM#$wTQ5<J{rE?8Rp_9$Uy^)&k9Z=6pcMon*yi>!*OS%0<mHXeyf_U*U0mc;5fN6
z(C5;4Fxa$Jod{lV?|=tfAJUlN>;53Slf~mnA9;5fACa;NIOK2g#)!8(vo+O)a@O=4
z6LzHbSpM8voBs5=4Ld^s(C1;o&xmBha}gb38uxnO8mhVqsjCNOw_aT_fGIaVw<ok;
z|4Uc8Qc7^ggR1G=>B-1+-a4A?W*R}%cg8kM0gu|PZb)Ol_g#rxP1Qp{5n~%qg(fw}
z2+rN!t`LU-O0-4oodV^~lJbi~(zZ?#lws#jl0}s50*f86Cj*`?#{AEa!<kq^>q~2I
zoCJ1%)NC*XJOr|UPEaSHZ{MO@n66bEgA6q93Oy=}PQCo@sK1y|fhn3glH@*5MzkrV
z3^;c7l<lq~A9(G40ivc7r%}Kc7rGZy>8~Jce{_&2ZbLad#l`7e;xy??=USI*op%{$
zjs6@e#B-w*u*p73hEPKfRNlr7)>`})K_Oo9E-pn#wvGoU-dFqUA)SQrg+j~o8YJDY
z(|@~_s|;hVa{gC!6|jpkM*nj{;i`OcBTXNY5OB|SmooGQ!_nS;@G^B2PiJ=Dvxgvh
z{Fvi-X-+AP1HM})9Mo=7o8ICzOn^*p_5^GKm4t1%(2~%)@RLF)ed*-~9AfIGs6x{t
zzSh4B+TxQ(Pqw&N=~SZLW=&Ui?>822Bf9?D@2B(AfK+WjFoqsL@{saKIvL&`Q}UJd
z?o+VdDV79I(zY#yUe|%0ZPaaqpC9&j^pmx_I48OTinuqicrIU~<gTJZfAL3H)|y!v
z19a7H{Bzqx0Ry{BKW%)Al|@5klnYZsNs$m4?-U-)RYifcD;cV_Z)%A@Zk=IH8TjD-
zC{xW+Oy3~z&R6FWY9ArAaoU62m-GjaEWtG*^?ZMUA6k0Af}}*pDji2tV>v8m{FEWZ
z*me|pJ%Ng_!T1?%*}RTKxeKNAJtDlFA#WN9Pe|orkzZZMgxP}_0pzdbH^tEg7`Qo6
z{unn!4V3T99*yOOQfX=pkUKRdJe<IiBm#yz(dc`cXj2-0BcQc>HL`d#yEiMNdiCP(
zZH9#py+;6y_fe{fh9O)6(x;nL9d-%lGP={0&)<7FEv?wJ3kAq1dx4G@Bsy#j=V#O&
zF_wN7vShWBP-o5#))_|@E55YLk7^wC+2mo?v0rf5G^6hP)J%wGDS@4Y^!UexZ3+AY
z#W-=tZGj>%&^h{PFm6+W(C3DIIbK)~hP`<;2*jBv*J`uM9&iq8)L+E-P;%C&7tW4y
z^_L+6c4418`K6sDNu8J$E{mXoAT&JVp!!c>Gz5=s%H(u}KwV3C>Oo@XUzrFHx#&(&
z@nK49RfL?>Ns|KGPW$MNQ--RnH@`>g2!D)SO#OM6&uvN)6zGyu3WEnIaBacb*_pI;
zSI97q0f7SGpIkmSobU;86%00#p~d=OEoFkBZznu^34kbDoyyM1vCBR$Y?Zvwm;Xeu
zTz47+`V$I+LG_J;w!{;nzj)QKCB7TL5V#<&%Yt@H{dYOiCoR=SzT1R~FX>6Xplkfp
z4poX>;K8AgVM@<Fa=mxPCo4j$7}9|6yi*b^aP`}l0R>li#?+A5%oZnr*C8?5cG%~x
z1J>qK&04o`q45`(iP0BOLq($~wC%}5>MSJ5OKWwXa0$`0=*D6Gdgcg#+)e?jQ9n<L
zJWWV7&x6xITk&$ccDHWiEtj`Ca{fzjRkD6pUmHEJ^Dv}xL?jc+vc}E|K8q9jqNEx1
zWnmM6oyPMJm`TRKi!_GuVMRivcTtqQiPS(fm3FsDL`tJ)y^(uRdSE-bpi0$f*!$?k
z1uF>g>PDr~v=Aiuk9?R(^yw84riYIRB_PDXs$PmKipkaLe^dB`-bYsks2gyI#w=`h
z%Y|k**R#IMjSrJi(e?>?IqF=~Z%ja3#6PmRpU}Q;ta5g~8Wd<3=?csCP`u{i*}YaH
zocVhK6|&T`ni#7At@=@s<Zz)P9(<GUmNB^auDm0;Py23olL}1eff%x*@=1Ban9nAM
zi;fyojFs{TrOfP7jh%QugTK8F?4zk3GumACLztB6tlnQi8{t2c(gL-mc{}E+s705(
zPSj#9&eNj&CF%D`9=tG{*J^9W(*P$e%!T{g@>-fVGL;HF{d;8**X6=(Fr-pHEBds|
zo6cYFD}*Q~X0m{;>)(9sBq_%(jAf0c6RC`FcLi|jDOfwKAl!*PJB&}0$SR6RuAqTj
zumMTu3_c=L|5&7nS7HK`EBHdt>_UARmdjV^EA15Ujyw97^a1)qkl#$~55vd4Ho_qO
zfcsf@%S*R9u#O?ibPE{VL1i?@gAy3OoC11%XD|ar)hv%?X0pQl!^BVLdeS`yDIXU-
zXLu&yf(IF3ITow~BQUn*b|2X_@Xkw`3s612F4r*&{EzR9kzxlW`a*qwML^isKeg}`
z_IB20MYIc(<AJFC)Kqi;WtulaP{Z|U;i3g;=YZ3OfADVN+%vLUA109=3-w^(<=qZ~
z(d^+o|3`67(G_*Ti~~%_2mwhgCy>>XH!xlnZt8$mL_G>%$uNQDI<zebnX^t%6hQ<%
zG!1fqC&6|O=iBGz;Hu+4$8an%c}pKA)V){qxSx(~u9ig_?*ic>BPyJ-)H<z%;XwNt
zdF5#<UK;Q^*euCblBlZI%Yyfll>PM7?=ZA0wr0e!nB0Dy()t^}QLjccAlRUG1Q2`D
zA%AX0+LG8MR!wY6`r;Pb9o(s|7tE`SQ`^lA72$uk2tVFYHxeh_)((7*@_gYnRJq%0
znrs-Fg<7Q5{woDY*=DdLuzb=-dd@KIyu#qZl`rMO;{2^-q_t1l%e3n(x_pIslTKji
zXp18g{H_nt<03nd@9ycaJsfM^jb%##nk@=m(Qww4Gq+Ly-qjN1!uL6b`fFvWIp@h-
zc>va~%8=*F23++$dmkHms|QZf`h&jil54UU&P${y-p8fYP!Bb;(4l$bDrZY=!O1rm
zm&OGt=?u(e4mmom1j!FCH**22O|@qxwjV<CcF)SeNUyb1+QajZ4>AAXHYpv>l{6z^
zX0N+`aup*=5^}LXM{H17<-%}NlcYz2!szIHe21KTtUNht(g|5+1NQ+Qlo(iUD$RX!
z?pbk5MJ^rJ4h>(rVC->*KmLXxiVH`<fPi!Dq_}c}?V5cK=K75Nuu{~D8eW(;NYFyS
z;E3mo=>(l?t`Vns-jS7;E^g)3r+UED30xSdG);g$CI0&6!W<p5$}wL4?*rI87t409
zNU^jq)o%#OH39M~J4yDYK7YW9X98^Y3k}=9*f1!7P;E0rbTqE()a06@gGygfv|{O9
zI)WyjJlDZIX(E@2SE6>2Afu-=77B_lgqwYCKD-b2!{Olo4LJe8r}%9AMN6wb+M{o8
zjdU)Ta+=20vNGvNGU*qzyq39O?1F0#ej3SKkX>9mTu@U8&;UYIlgP2#uCExnxTpgn
z%4CKEuwID|1upb9E|_|Pf`7OtkxmK8($64HC&iaAk-mo7yd!s>u^4gh9+5h6|8ven
zs4Rpiw6@LTTis_If=eE425@S)83rOx)Q9gG@O`4G!`E*$pbb19=CE#>16#sajMej`
zWkD~x#REJ21OA=WeDEYs`INkQUrwX|ti_L`3&c%FGB`StbvOr?!Lc2gYrEC)V2wv%
z<SP&#&SZ{(Man1@<SEF~#{+Vr`Vas6_a9KrC3D1aL^7K{-0~pw;ETXF`2(;S8;#6t
z`+Qnff#CadygX`%46#l=LJwB70h#Ra4`}QwSR6_Cvcv2Ud4sjsIGUpo7f<R{>f7eE
z0y5d%MHYV`@cx>NhMLj>wm)OUIbFvL1R9<dgKp+<4KgvGh==C94Y`BpefTIPf`nm1
z3={f(jq`<yMj{B-v8GV11X}%8XKb-Vo3ZroO=z}k28&%v{;YuvzrH)mC6HC(YH@`X
z=N{Ygt+q1}8*hNO;8EJf3>T8W*lqT?(^XCRKk&C36a?cHff;HJmM8%tOJ`#?98AlA
zGuGaTAx90nSx02dvSpivFaZPZ(h1b@HOyiU&&WPpnTO144z2wv^+jzg03l6)&0a?E
zA9ER4se`Z+#z_iTl9x7xg71T;%VY(6n`!RM!ICOR{%pHI$vg*EYz)7ZlRaxapv6D-
zHi<PT7w=J%<f#ic%(dPKMruNTA!8IbK0bRY9hdut4hY+ast`7yK!7T`V#`V^%JKCc
z_K$K5ma<OtO1C9Z5C{KO*qZX)RTKJMjQ`SoOfIZvJjl}OM;azdLdboQqYws>g?-bN
zt=%yv!~`TfuO-=EXMp6BX&RCR3$sp1MlG1AA*WG>@uLiZbgH+GnReD=r}FL2R-$NU
zLq59sBL2Boa{Nc1iY{rWI=n%|L`H*B1S7cO^DR65aX~9%4S2)o{V~9eOK5(v{jIQP
zpS}rJCoNvlLtR5t_wpq$`z<5G)J!8fNa_vr+$jU*j^UFkidrvQvcoyTm|X#J@g@T&
zZKAH4FiGzz-Lr^oLV(=uu{_OAce!>ffr-o!^plF{IcV2hse?}&R=&tg&GlA9n$22j
zvA=`gVj+6<dyiyVsE)otk#j}6uRQ-W+HMe1Pe0*FxmaJkj)g}Up-Jtjx9NYz)~QbP
zGy{k6Hhy@RxAgN*`^%HJ=0iPGjx3QCy}p2}3(HAu5*MJ5s<~e)5%S&@Rx9ylk<cEk
z4P1}n;4Vw2;jI^cgZqybkpOt!$+i1eNwpGFhWE*kRN!fPf7^UTs?Fi1k0|Uj!CaTP
zOgo?lt2GxfTziVinMZ{eSXiP!3+jesIwyR#(dNY)SlrgL7Dqx|Jk*!*BUAT9nIK_#
zgzDJ)FUh8BFlcG^X#f?PCDN^H5gz9;VVJKNRR!yUfp^8IY`%C}w7lF?OULSu1*;0T
z9cdd;F7Mv7!6Fgx_Ug%HrfI_${cTda5%3stF@uITJW6ckCN=1|AvX+rb(DLM8`=ra
zf67lBaQ$U|`0qs9aQ4f5&Fil7o|)Dc)b-a&(DnV5Vf%j>K^*4OH8AO!@xuK<-<3f*
z3d!?{;po4#wQdhljdW4%w0-W>UbRtB=rBzMt|Ms=c?%GE&SGJU$um*dM?HlXsnVYP
z7F|rA09UXJdYG4pWr`)K;SQFtxIx;6`68AcI*PwlThw=^v^v>=?i1D+o*^H=#)ON@
zcbCf9n>-#ulLP0}M?ddgOg9v3?8R=vHEvP~Hme9--~Q*==Pz6ZN6gmXzQojs5%Bj;
z!q=f3IUh4VoG4=`YnT7Fe{n@Gj*FADuUGdHb)}iC9t5Ni-^fPJohR`K1OszOnz*HY
z!OvmErT}Z9DI2EeY06X2U{M`}wXQE#$md*T23u3R&=db@`R&;~-q2JC5!L8CXGF9u
zmaCg8oI;L&f|ZeT#u<^FZALqty#Yhw`+}+U!a9AGQg0p>%=na^zX&pVuf*Dki7^P3
zjH=9nkKWr9XOO1m=F42MUrapF0W&TJu{2jqYH0hjD5g<!`f4a>fp$cCVEo`U&^Hm3
zJ-M6$b(c;4G7R=7CPC2;ZLcuRdKE#Kq03{BVyxbu^X>aJful@(nl9aZD#`9O&6LM4
zNoQqsutjpjYbNNCrRG2T)iNoN>HtqV+dJSlwdx`x4JULGQUzIDPAH`7)KI>*+p^4l
z&-m<)pP*Mk?iEC$Nsam@+?u>Fm=Yh;oR}dD9(<lnV1myxVdXWy0T}0kKS`{=<aU1C
zL2f7t7C{jpsp;mr+Ac@OaVe!xSHzy^Tx@A?a>i{KM+2K(K69UlPJVibX--RKb(dMw
z$^4or+EdyFPB}hjKtdN2W;%Nq^H^iv`wih50^8=p&Vs5)RHXHz{?{4nle=rSW}@1Q
zR1A>e9=dPdTKuPgQgpXQ4156akLtReWpXPl{ZWzz&}JzGOWmbhCpLA{La958@@<=7
zRhbnh35c=hS}fm&lwmAmwi8DRa#|7+Hi+#~bi=Oun-aEL0r#KGqHfA<2wWb*f+>2a
z$xSi*!#+bn&(8_}<uZWSt0<C{P*F&tHF2poN;6+zTDj!d;<h@GO3gzx!2!lwOUZo-
zaDv@L?$@mL^cK!NRqQjS(i&GKN%XmH%NH?j7!sgcY&%@oxK#r%$NKmBq?uBM>`K#<
zGcR(HWidFBp6Z~LWsYJ?;f=O)JZt0^Wxhc)3ZFflYxuA<HEvb8;9wmfJPEKa47Ct<
z``3V+xq?Z`xtmop<m;{2_pb=57N|7UK5zwp$hUN4@R*U%CujevYAmp{58oskuZhho
zO?AA9;Dy2_15QKYFb#0?vwMC>ofnN=PO>X~wU2fD<be)W(s=<SZs#WvqOSp#m_J(q
zK~&B*tL_8)mNLDYidyr>b3~$7=Gjr@+!cho_nr6Z>SHe5vAPU$f^F(rYGa?6DZVqZ
zj8l7+^K?m@YVpDlIZcdn7!oLMxjox%iw5_>KGmBz1+&rD6E%Sm<#GH}`4^=!S=ESR
zwd!XKQvV7PSG44WSD(g>Wi>YL(;7|?CuX@3=d^xBX(6+XJO{X)ETO1*d1xuPq$>gO
zN*$8?S9A$PGOZ~NSD};?kD-Q^PYrC;E91iH>l&|c;2?fo%xB3G;z0XT%EIYEI8=G4
zn6`U($^Xz&Fa0q+kb)usvDy-sCA?aE-W3Q|w%~JlGRbAua13k2iLDJ#Eqe{@qvM}?
zM07FNyhOHlVc=YF(t3fYjH6Zg7=7z8OfgfcdE$VL4$i`rtgwmV_w*92EaTQbH`n<~
z1wJZ##2d-_ShRf*qi^&Fe2C32H7r?GppIyIT%eiwTg=Gq(S6ty8Cn}8wkAT{;`Pd$
z!W=>5!gKqentyWORUuh}7xn{{cRVC!ys6Tnq#JaAuK0YH;*t(q8TZwT@kIb0Gus~C
zp!J9-IIvnkWgV(kdqI6roKf=v5hGuN0Xpmz7P#~br9ng`Wj6jQ4!b(6<`ej{>zGhW
zCE@RE6(odfLJ1lQb!Cvs{ZAAU3rxn`yy%}Rw;^Wc6_gGqE54tyzorE4=u*^~^#Pnh
z5|nN&x_aJTE<#OZz|drW>ik0_TR%IgaA_hj;%({$L0W6+1+dTl+8g(zR?wnK%m}tu
zEICcYHRhN9M{T*8`?6JxbAWep2{o=AXeR2!ecOXK!^{sWoMn$Ug;ZOE@SF6h+6~O*
zV1*<BB;hThcD=Mlh!kAZTOZ&y4IHt=@ojm<ktjK5-rClv(wAR*yBd1yQ0KE2%Q}1+
zV`(XU);?<zq3zS~tiec>Mn^SRz?L-M>1jM^i&qd4+A{Cbs+GRgV|ui!5_Rv_YHvB5
zPBMoSXHhu~vP1YhH5%9}nq4^3J0!l%HL}B$MeeETWBg9ET88%z15m9Fo5^A>Ykahh
z@3q6Q@afTknSCd`iuCFxL`iGmS88m3-u4VNF6zMe0Os(PDetaADo{t2g${!o5fAX_
zeytK&GCrz~4b_yB`osxf!?-oK-WUO7ii|Ab4N&!b14z@T2IbZ3vr@4uV5)fWI03XS
z{^hVin_l;lsiBT|!0)YtZ1KVg9)rdzo)+Lrl8D^-tCC>a?v@`s0y*tVG<Y+fvV)rl
z&rICC{T0b@oDfHl_laZP`fEThDl1}p(~~8`_|;nz!Jj3TZE*yN==5Y;3^UgM`3E9M
zvaFSk6q@r+Oht1zUnN}a8b#QbX^oYqo(ej0waCKYl`cO*HqdU~qSBIT_VWfw=BV*a
zRCQnLeSFZv&BeXmoqw{H+lz+(R>@j;BSeMYU<^8~QHX-3kVRrjl@&4QNW(tmkz}@w
zq)b9nL$^(a&Fh&`#%aw@+Wf+N+|^Aoa$R27*`K2=Nmow=uTd*Qorx%m4O;t)C}h?;
z*wmdb`(tGAuMKrbM_#R!6;%h}QB5j*^s?8y<6yWI=9-E1J@Y2u*QElnRw4$2mFNi<
zgW@5<(5?6<3XwWF5)9N!Lu-z?oY>pxj~VFQ0fPMe*u}jGrbQ?yKz`sSk>BWzw1b5F
zUDCF^HHYWbeQTQ+MJ_gMNhIcOj(5Ntt-R5O2rti4^abhMae7zP3ssWnPvp5VffrDx
z*__kwW)Ru@ul={34df;k5-Hp5qcZ)Ba>%vx<BJ}`n{RJ^(4(I!J4B5gKqfuXy>k)7
zRlcr%UW-UvF;8RKOrqt%e_WWl|46Ca9r{0%oPKGn^!ijyC+$#5bpk;8=JT|Tu;)W4
zP=}5q4yOrnxpLD#t;2ZXUBoJ93*Efvs(LW~P;^7gp!2skFa2`Lm-em0nw|z5$2Q~P
zDd(i;1%-ezfM&X&ORp_3DCQoVF5l<Qq!2*2?+1%Q+;K0Zz!J3omRo5eo8O9*CNy$6
zTP9Tm2Zm;*+%&gzh^F1Nf;CsMSpYYhCJ{%u{#QXD9R?;|AuK4jYcO-y+25SR9Awh>
zvw`%ASB_R2>JGX^F2_4PPGE{m^Ei$OyPw{cA3wIaScXI)xP$qiz*7y3EFsUtDA)=Y
z`k3mJw|XCKuBRzGdeA@ll#|T|kif`Pu@1pmZhoWG8LKbSBfc5#;QMaTNDUcJWVGVs
zf-1j@bsAE`%|2WQ%{hl@-TXl;f=^cxOlA@%^4R;Ke>rq1u;V46?F5_sf;|AELlag~
zb7~zK%+T&5V!l4mUFuh78-4;$NWU!=t-m9Y?N3;IFB`hJs>#Q|&AK0`{iSj?p7hst
zuHeX|{j)gbJSFf=%M_bV-Q5zdgJ0}Z70Lp~HU?d2(^<uHnt_ol;-<~4UV-xqRug1P
zwJpejP1fyn%*k#RPw2`eBs8%lf7No@MgZkxP3#acwT>xh$m_SgJW)OE;QdstT@!3j
zueHIJ<57B-q#`hL%Bx-WgWMWTi3KhEj}4>g?^KNSF{#&%=B86V@x}P~r3$h#<Yg_@
zv8mK9n+pTP_<2`chvgdyXi7Xn2wv=xa-Oi<;}a{|^XDkop>26flg^vr?rO-bnE)KG
zmJ-FKfH8@G=<e}lS9nc1=8#HCFI9T5z4`-UvD^V2ot0;l-tyc}*B9dDL1P6}9deUr
zo<7du+vGBCICHhZNr9%1ynq0@)<rS|53`RcV1^#?`x(DUyRDhPj@7S?oLTEFMu1RG
zt@sN`OowBk$4m~?Bt$*Zz;Yxh^wfzzUZGCX^~uCx!88l~+I3I@Ir5OT1APO}A)k;w
z*aLbCZkttnJ9lXL$Ldx=waXYnIAGkc4+OnjB$a5t2e+`nskfPh6GI%3%^{Z~u5R+*
zFkc|QvRR-J4ij5f>T*$ViIX&`e!^V0{=}(;rsA#j!vYxsdkH}<g4F-xWVtg%JJoN1
zu<JI*rCc(eIz-dMCyhMy0q`#MpxPLkgLJPyhQzr>4n;a`E9Ujvcfj(X>&@2fJ&~t=
zC|&|9!QN>M0p%>|2K6*S(MSLig0%*)c>+eKLXv=M@MaV`Q|5JUg=$>*M<M`I;bO48
z<%Ip4Q$85`yAuzb13SVAk3qsV9gd2p9W9HAsi6<?R@Bi*UVm8HA=NTM(K&&AIt}1c
z4iGpIb7@)5=`@{96|<|K;m?wS6^kB+aBHRmRjG+QV|ued50KS^Y8-5N75a!JWZV7t
zx0vr^>><p%jFZI4Ab~)LUfrj}%%(6KTL=f){J{GA9a;{hW7^iHAJ4K$3$Ro<+%`RN
z95Zck0m8hlxcTHT=!B7QbfDqzVe-^{23s+Y2d>PS2P7AqHp*2Medf-Lp@xfrUiocl
z5a^W?n64_$38-x+<#N4-1wr?tD25|~VJ1$NN;xlEIAL-6)Jbe(@HtnLr5=|z&PpZ0
zT@P@jW2Zm#yX*Tmv$Jt%%NNxvcP}=Ob!>cLoGcNq+)aSt)&BU(VP{R;SEXZD;;n4=
zgQY2g3^Yc;NQ~wV=M$1Rt*FZ0DOLRa*0<1<*hzAkz8Y*#|MrSILP%`&mWAHOg1Bwm
zQ+PXrwBnt6|4YDx<aEXt0TF1<x(yPRyzDB78!r&wF5EZ(aD~)TqA^O>T0)>ltd%`X
zg;Ga2OYgbZ2qP5HW1l#+K}fR(aZ@ddrMb=gy2|cC_i27XGUEb-J2H^>lgMfPAM5NK
zG_&eIoIgT)AN|R!mfGYg{!lKsX&GEhTKhSux5%(P$AU<ip%L=jt=4)9dK_{qhfT5d
z-2f?mI@CB}*s0~x)?SIeL?L`!e!t`=9gSVQk_aqL<$sh$FFu$Mmb4o1qKRm2Y;k0S
z4mYcjspfuC+$POigWeN%Pe2ij(gF@OIOQqV{rkHVyGvch)|{q~d;W!2Vk~qYbG0`Z
z09MyZxDjLQafMmB$6x?2D47v(L0yHYt=Vq8LEs&F1KKby87Ty^sY-*+?;3sI*_ddp
zM0`m{)J5?XtNm;lF)I8K-1=Gtun>(&Xxs-&f@>JS;OhsvEEehvn$e}cxq0;WxdzfF
zMh1bS*K#L1DGX~s69rj{kR_TckRa`~Jry+%Dp&c`%j*xxlDKmhs+Zds_NTFCOR@gN
z`{~@yOqsE<2)PM$R&qoL$431dNXODfpdWgt#?>uTW?s?@35pzG=2zxWOi`ld-UJN*
z8(GeIF66gBh0a)F#e;?1Hzvh^b@_~kI3u7~jaZ<pWnkE{Iih1``-UI!P$-kWsL^Y$
zEY<jbP5qjWBGN3ZITc{>I4BxgIJTwXv@NfSXtrjD3546#QP<ZkQsW<N0Kkl8ohcgl
zYnZZmUdOnu`Gp3-N*b`VFnXeQ2cJe^vW%M6ZkFUBGw}*oySBq&DFBS;siA+1(|7Jq
zX3|~pzj~r`omp%Q+K*t3)>@5PB67B~Qei=2If^1RugjLzh$r>a<0i^{Mwi!1S!Jkp
zx7zrYOe}P#E@y;jPg>IvyVq!U;?O9khXTMu<mK;ppm*6*9wL~8oUcQYrdN{8XKpY7
z%-Fv0e&xuRUv7DKzx+Q*6c()CsFj^#N-~zd#l}krz5kF9wC1vflH-NWe`eX@XjaJ>
zLZ`$*%2RAHs5XUG2WmeJ!k0v~E(wA`3IR$S1Wfjar!8}_R(_iZ=e1d)b3KKXI%k|4
z)jcTlrU+aWsbXNIMf`<LO~A#xbj8%R0YHs?lj>Ve=LL<ZJNX=*Ceit<!6gX&TuirQ
z+@{i>Py48p)MF>}8%aETjP}>U-EfD1n=nM9K~5H6qM^l7k8WR#Uph$1xT5;lstDyJ
z&mtQUsEK-;oZkalYTV(%OZI<nITYAGz$g>@S`L<LBn;>p;29z}*wsI|(B~7Nh_l|V
z@$Ewg7;Q;>7(1dRdlsmg+$h=$v~;FOy7ITzCmPRyxo>6}6k`jn@62k!6#GFfSB9a3
zF^q{@u0RHes)Z$@gO4i??F1=UWFTSK+!H@NAS>6<*BH#OokUoKzS`htueC&ecFO*9
z2PPlNvurf8y@qIPTO;Jdi|f3C+7(AISPUx!p7q`!*piwCGWq!AyD;j*v3O<+tF=7C
z;HTeJgOM(|hGjZ<w_>$aJaVus@tLlsnsL}dO(l3(TdJO%Pp)JLOkMD`pziYI9FXU~
zp=9|06GJaq;Vh`ep5KRaZQF`aKILToc&)nm0{iIkA=}SV;@j4>xFq4<X6iCezo5|l
zZPwS#?$Rs@W!PUA+8tWbRX9|%a&6}`>tP&*bLb<k@hIxG8}I_ij`WD#GM&dl4{7~>
zX}g)Ju9I`h+h^e7Wz}X>N1)c`mh}j8vu1|zev>x8AM;pBm0xLbYoRCJ0ds-Aaw{}u
z!ZlS!!2G#emuGM`Xxx+N!+Lg}GbChHmGmEgeRB>}WY$U3G5-TVx%dsZlC$sO3`_O_
zkz8Q#*s1?18cn8DL(^fw7G!%T%GD)H#1M(;>tC}6gdJERJ=wO_s+=luS6NXbA@ivL
zZ<GmHR;oqiZIg3cgH<WSr_?-DC$t)z_p;2FM_IOtZVkfrFm&_)&rdBOT67x)TZ^q{
zM4Ku}7OQkcmeE2Wa=62El`w7_Z9A~xek<TrC1z72uYJw}hLQ5z#CV&hSlVtcG3FAr
zQA@t4uH=%)rQU(k1=0ki-a$AG5YZPK_^!DiBW49f;#kSZk)sRRaYc#&K9F^NTh-M{
z)}@Aa@(N|gJViKpheUf06+*R{fcigOY?>}{bXfcDkRLYKe!ndsF}V*{oZ@YeZmN*6
zhv=-E^QLz;KU?7TZ8>X5dxdXQrDt)AnqS#rz<{i4XVG0P5P9y_CFklt12@4KoBxy0
zkv;!SdSYEE4vhV|7C*+M&~%)YL#*g!(CHJ@5Fqed8?fXS`7U+!>ZpW!b9+mc?8FYu
zJiN5zpj<n{0wd`#o2`z%htf!X2K}a`2(%~0x-$oU*T~Mg3wWz?PXF=A-jC>kG`HOX
z$_yjVOtm##V&v3wCZKUNrGZM(QE2+N#W4$nDL%7yj!(tqQmha*WTsdKP%*&EeST@|
zY;Wb#EuRG#f_@hYjW0iYfoR<5^4gz^(+{=;7CHv#9Go*`R(2^6FEgfji}zWVEOfb6
z!Q*Ai{8Y@VI#MgclP@+T;_q^cTL|{HO=FoXtivATUq2Gzr#Aa{s*cFY>@9g#ZAU?5
zDkA6smV4%dxXxIvPV{$;YhLUOo@E9san~^6FcLwe2U=AEj@?xYxsEzALCr}!mCwm(
z1G6ff+<*TRI8zZc9NbM551HC^8YvCn%x#vBzu#XfQJ>0wsT3KJC?XqU_a>3|DK`4C
z^8&O*IY19lZ#fiYurG=Ng?B--7`A?zaFoMY1!1QdPZ}oEWf_=_uyvAuQnt&$BUuZ|
zdjbgjYuG2HgyNu0m5Z>;xD+aH9F1@BaWr!E#tlH-IWf3hg?@gIUJw3Ii>;(+U=H^v
z@m|hY4xq81Ha;XEfDc&QU_2ZQjiz@ZTzY+FVs?6A)K{K_nKhR=V?|nxwW%n;;TH}l
zm{@?}wS5TeP{QQ0V2J&NeJIY&jg^->sxC6UP)zMIHe@XhY29Q=mJC4CZ!KLl<e8tg
z_!>M`P8T)r<`kRug^Zc!0bb?N9xC~?afsHM3vFAbvPX?O%lS=Gv1R1H`yCqJzbxI@
zLAu4jgGz_U)ZLL3#MDsuB4vHxi4?l%;RehNh6+B0<N4U3d_&9W-6wV>tqUj&h#i{9
z&rZ5F1+Y1|<i<<Aj&1OuqveAQIn3$gS9ULD*sq`K(FX`729PycJ^T8UXjtb8x%#A|
ze@qP%%^mMCiS;+#aVfFj@Rj45F^W%pp_CxE!%$PUe+NXU!GmPt=Mw5wVM@}2=u@K)
z^)@CBh4sq<L>-~M$NL<CY{E%ji4P_OL$L3J^dzL=kWLjC)46w1*HmFb<Qf~n)8r2c
zB>PebVac8ssLH{^5CR93n_8ASt|p3$wsl*HLzQ<*ut9}h*^+rE?J`TL6nL84x(YA7
z|Bhk8odC-klrtZ`s;Q9^$v7y3*}>|KM^@mF)w5_ke1yc+F1=t|5<Kdx!cuEvRvdn^
zfaRKsi0`XbJ6N|Y)(HW4{*Y|Jq%r^%to_BX&)?cEWkLiMQ+qAqP0sLDic@6K-9z+j
zd?zv);)qoVXWi40G_f1=wUk&Ydv5p+SWjKe`;3dQ+Y!atk%|;p(-Dc2&)%rqv}~6R
zfLB(V{-L7xh-WV)02yG;b}^W|d#B6YQ6fzSks1H!X`J0?VXdo@rXu}Tr*h04`4{s4
z$}Cuf^%k>yc#g%LHn_bo+1!ME_-hc-)Ys?;wUD(adWs-!n_kHBcF-k3`Fd!qq<l8c
zLZ_0&>+dCD#ivAY*8@A13;=2x57rpZNh?j9dF?cJ#7&Gk$F1Qe-!pVXNBgqs=CYVl
zgFZCF;PFR)C{`HC5}5Oz^GMc2>~9qpH&7`1w)`;}`?5dv<Ire8G(JwsIvp=M!P0ig
z6Sx4d<UOj%i0UGz=;0BCRe9P0GY|56X>$ZxUG*px+LV-2w@UlUkxgDdlunT?q?2xT
z9#lrD-ri*Ly-sZB<H2D`=t-^4bEn#+*A#3vI);q%kT=_wX2LIzlu*Mv*!?kjONF&^
zKTL+^kqZ2k#aD_1n5hgVj9nvy)&c1PC_0DiQgrJeBbPnYhMwWB1K}k^fHF9PDOl6s
ziaIKE<`b0mq90{bFOM?S^7>aH2oZoTM)FBTB~Yi3hinjnKo5GI;n;wwUk5q|yaXS-
zHk=2txK6%@=`+=s^-?{@&JIGoa3+~2f4v|lA3p*Q08re#J^BF&4C1o(5ix4pD+PI+
zKbyB)-W<3UZY4^TjouB4Qgr%Q@4ITdp5W3aFk>~Ly3hx?Yz-x+$_3e`x$K)GkavX+
zblix$6I$KKtLftbku{-3ze5z%rk5#45VDJn=}TSQ#q<uPEOh8iL?8*gmjUhZb5a?n
zyMy}e`H&A%bn@KW(1(X=Xc_YTHCVPp&FOkj0W0)ei^{nUfD~%slTA)njf5#5!5lZ1
zvhEdAgMo!RK*lEZhj7(4l}kDMM7d!&%!P80nc~U0ONH3=5r=k@<qyz&YF+_yd~_<3
z+;KjlNF-kS!;2}%dRmlWK0LNKx@{rRH{xqZ^4~C7{zuSdLmw$ldd%fh>L>INz~l4~
z_%Qht#tsl;qWX~0q&8`*xq8f`VVp)l?}U%2=*w$T*OZ}fYZ0g!@AAqP-Co$&ZR?Of
z1?&>Md23c@OAalj7hm3@m5SQCelW$AAy#fGS`0&~gX&h&YnWxkbWGAAQ#yHe(&t?k
zz}i(J?gDpra9&6}nBa1%J=`-B-ig*Tx>((g7|M-6lVBiQ(D3z7QrvEI1HG3MEdllo
z9_*#*uAq4HT}=-2IaD0?j;fTTU&=oA@Zs(nHHj_T*Q&dP^b#5cw>vW~^`pmweb9^c
zxAwc$c_NIk=hHWxfa=yMwHtd$+Hm;3B2>fK59H*ZO99#eAATvl?z4Q3(YH<ye>-UF
zo9^LMap=Q<8@kg4!)Ng|<z9%14*aiEZ{jykOBC!+I6Q}wQgx!9c4MM^lz2p80<VeE
zDSzM)j2-eLx&7K$p=)_JNu1KhB2U_3PZ>Z*a_Xsr>1QkK9?P6yfN4ppqp}C>VGe*V
zm-+WwC8*tbRa1(b0frUpmyM#k=iM^E^!~cp_LnuxsuQLA`*qAWHX#5ax5D3a<ZQ%C
zw58&Y5Nn}SG&+VF&xMIUBzzAdDwAXe@g*;j8%ky(iJ!V<0(knAjF{5BwHgQ$TX2gP
zx5-3YAwfa~?%`!%i36%BuSnC^*Q?uJ8i%9c6ibJ_oz282(vUnB=@^lVKh9@*1c|U*
zfd^~S<YB6@zW-u_<Ao+{be0$tM~)$slEjo%`Uak<lQ8DEK*UVP#B{M+gLDLv-EqZi
zZN<jX{~md{9&^Ap14Spid=^*p>JEqQv4w#lkGK%FFl@x7^>?Zle%~+E|M};hhI`-C
znqq#fsR8PlCI@C^=#;Q`*`SJU)8H3e9_Nf3d{FVWbhq<#vh|r;kBg8Mm}4~#2b%j+
z(fm9!OzGZ!vM@ViikEG~?IZfjWdu|$qqh2OO(+SHz?naG$yCAGZ3DZ2w0E-nSL{nu
z4J2dzHw5iW@=sleSIuGIoBi-3j?;GGzhD_GQCQ<AC6Pc4yJG|PvO6C26Mw<FH{ULd
zj(u~EcN-bp4@S!6mS^%Vlb}D9JxK^s0k@UAA*J>}kUO<h&14s-|EiiX40UQl+9PmC
zbmZi&v>I|K7)&plO#kd57R&Z|YTF^3>BplKNlqb)){;?oFXN**`6Yk1W0{sU)bXAy
zA}(WE)g0#3rfitnM@cptNdCrCP>>GmKIRRes*$8khxY$sL;u~+gAE3kz|ZytJ@C(^
z@Mm$br*2z2JBUcoG>SgMmn$&*`m1E=5D13D%o<mXT6)k+K0ra6e-^NHBA4dq)JxKz
zajOVTVXC2ofUXdxEnI@btyWDEH1$BqD6fB_8<QqMsFwIFPPkPW-XY;Ze(CD7m(peT
zu_joXzDK8Z*4j~^%AtQ#&XtB{-lUG3ac=89@(nUF(ZMtZf@$+{nA<5q4Hiq(PIwP1
zZcQ;)uvuB?E~Nhu*j#TWP4w)7%IN}!jJbt%l$ZbZc3v5ds$s((+o7Go#Mm_Zhz6{*
z+|_k*u_FXQL^hua&w<B7rdElX;h7Kb-m{4pKf+K9Ga1OATp-5Wb&^o~hG$VEx-@Xn
z{Cf*-UA^WWTO(L}lu74cjziI-RWY^Mvu8ueuF0!2+cQNIsGwX5P5@Qr4Iu(#zk|c9
z%OE8kA2I79@nY!RBKa%$obm-A#&d7eisJCwjt{P&y}Bb7wj<xT5xQAX^8L~6by!pf
zMGRE3XnrU*%KaysUGz4pKngs=mG6dqh7~HO;<!CELnxdJ@ej8BOmLnY?W3g(HmpYr
zoYU<v$FRd`72^C)x}f*DqczIQEWU7C>B0YMIXVT%^k3hi9Zd-InSQ@16QGYrhp;80
zSj%YVC_jrC_|;3uU?#BV$*OL+Yfqk&#mZzrYI^!ZOjJ$*ZjPr<or&sThCpU%bbU)5
zs8PSlPH5hFT_KFXFAqwGK+l;qOAa2H58VU%d45?0h4U^!C~8zXp)I%cJK4nr23*q)
zl|~Yo$7ZmoPC$2(W{YO^s4<;0ev-~83o##fDGhTH4%HeNc#sjSwk?bYDrzG?MTx%-
zpc0}FwMQQN$;8aPx9yz0*VVkT(acL%p)euF)&q`Xh_QL}<7yNaBrcJJHSr?_#5-Hb
z;SGHByecdyC9SNrB5xF!nF&@zz>bOJ>R#H3NU?;RE)-Z*EqHEf9mI<H!#=*o-$X%T
z<XMY5>PFR(b<ZLT&EMWZeA*;R8Fnlo^ogi%D8q#VNPPFFk^W?sf`&qDqX;GCD0c~L
z#4nWiH}YpAoB1Qbv>pAVIJxOSvjV<uGZO`*+@U~n!H93)fC?l3<*Nf@9J5CAEMb=G
z5$NNv@<VrC*<CRBW(wC}&Ji{W4u|k5W2JMyT>*ss)`(=?xPpKZ?Ary>KK4`+LAMc8
zHoaC>8fsn^9V1qkJyN;Bdh_^Z#fkWslidZTjK62PE;w-d%K@ToT6ImiU^4TMDt{EJ
zNUI8nL|Yh)e<J>5zwg>xg~PsnHc!2iDSUH58$tc^0TqXX(_+fyPzIU2vKQP@Oi%R%
zYAq9ju=Bjm%!@izs~FJkU?#koirlc#$oV$oRgNT7d;K|g3OdT_u!VlSd-@8Yg64rH
z^78Y=yJYxPtwRR{oGd2Wb6YS7^!W4o0_Y#i52I6F6e?x@;7yE@L0=qM%sUwa#NJjc
zRkS2qMsi4%ZBs8A9h?E+=%)4z-2wDYVPs;QU9Pi!l$n?IXzuhWgj>E?chce^+C*6J
z#3R}jbO(0vy@g@&+?!{6dK9z$MoT?t@6<t68D!eK+dUY&u0`H61gpY<9tDW8JK97Q
zTsWX+jG~%w$Mp5iTIP6Q8u8c6#d}NkxXL1B5v|74ezqs?j5{)!OG<4Weu9%!@acJo
zDK&<wIA_rVxM0n`Yfl*r`Nd?&f33N4ET9+0fM0o++E-ZxcDlD-cE-k}_)vG;lYuAc
z$T#<4+V62$&P?szrS1)qtHih870(ms|5J717i}^SOfiM(`y5cByig{ExD7#PMF2Sf
zG+XE)YYcRh3mQE<If8U)Jkj?4ReQD91MvqXm}znbDBUs%#rOyFD#Am*8;+Mjlw<<7
zLn^Zlej}?FKW6Ecg^02O=k827eC#mJtl;aR=<?h#=09y0L={31@(iNcND5H3f|lWW
zA9kuL&Wfizgp)M1L=xl}Hd~S9RE}*X;7VwDw{|IJWIRN=C5Wh+0IO|O-|}2|FNWqq
zPwu)%#UL3(j@)BK1X-=j)^B-W@PL?W;iC<Jb*RE!Idj+neI+H@FsEo~xobX;fH4hp
z4<w<dXV&$MmIBG<(-o(VKIFKx)YV$6YltccKP%m!7l22N@?cP7Y-o1=Ncv$(EO!g&
znYQJ<#F!i=Hmv!Zb;3iU5(J^gAG;Z`mYEhZ@q`uXX<Ly_8ONFRNgV55WkqQQNc>&%
zI~&0-%<@~H_&zP}QtQ-ZhR{zybpE@jwOnVsiW_xWR8ATY_~>+B`{`=5ReJJRLvd2d
zL;)$YWfn}Jpa5%c$AdVa-|Cogq9U16s2A-y{_KMNsJzgrFWI|XI3`?he-{LL^1B&A
zp@tpUf-j6*Y(!GXS6-P(U|;=Rh{4!UcpM{s(q)+U6yer4iJ>L2Ksa+wZ!OHaX8>0~
zsJ}+@lm&~@B1<URc$<<{a^5IZQ~P}{5%54)=l@RpHt7TI7gJu2O*e31`8NqIb*Yhk
z6J*{ZQguXgw(34Sk?%%3E#i_>@2U$Kq6y_>eI_Ru8UMP#Qf-w-Q1pNen;_v(CKB>|
zbQ_deR<S^W9rviY_aZkg2P0;wBhn(y+HM}eTSV95gR|RC(>EC=jw{7{rp6>)dp#=D
z7OCUsdIK7DtnUu8#4PNn__9+l^=1lV7-LUC)I=DUPI8XJDpl9qDjS9B6>^Tzb=zkf
zTM$oc>vd<@rOmo~S``d3`Ts|>v-4_`HzLUv0t0)z%gbHUYN(j-Hxd1c>QFW*s+^g-
z>UL@M;$cDRo+gmI7J^?}w*b%Sjn3#v?#ejF4=mSk`99}M+F0cb90oes?#fl30NhO*
z7|ky6ZN+kKxqtuBZ(W8_Zn!D}Ntu>iP`~*Pkd)i-j=`3@S+$+gTB~o5dE`e#*-wYx
znyf^Ea*HV-DU=?9uilS*{D0T!0f!mgOWF+WlOBQro#Up~V1;!VYel=c2kAB69+lr$
zgF~7*VVZ=@#U9ca48=5~C7a@MvyfYeX07OzmN;^(?^k2`z^KF23LH~v)tZQq%~LwX
z0S7;kv>x4JF39N{AvxX*`R{&E!qe}h_lJ54Iqe)ROK(-@n-}1ck}jZgVI?XP*E<*Y
zAxeat>AVRdvTtCgED0J45T3C@=q~wd^#-a0|3ct!E;4y4Z{_5sRhwICxMZB!3PXD%
zdtqZ>wZx1Us1FD3L<E4`u)ZlXbggZ7?d})5>_l8APAZM@-`;EuzVIZn?;t(`F&qPs
zWIK4$PJ;PPcD|43&z|<U&Nj5eV}}CS2kLG)#Qz(Q-8YX~0EjZy6hA{iDYLH;Z~{v^
zvvvT%?+=C2-;X6>@<5`tu?tmqZh1SNR@7yMrp?BGYYprW&JUD&2Mv1|%XhZ47-L0y
z?$bAw<ury%hWL$kX6^}U)q<0mINTG)(BI`7r|N;dsj%9G_+KUigZOYw*~p_M$**-M
z6zyWu>zu!6Ug2I73lGvzsz&rt%nN>{`hE-?MG08|a(XYy2d5`}m02q9;?K9Q=Nw0&
zzG2S+V|-?-C5rdv+hkz>B->Y!&W|B)+A^^*D~2<KT&JDznp(<WF0XO>7qF<|e=-G@
zA~lwM7M+(nYVh6k-McpKdFm^n$0E1MmdyS<0oj4D!-<XFa!Uc8nSefLB(wH!p<A^&
zL`5;8aj)`&!h}vM36CrH+HYrtK8pKUbC>(&ivA5JyC+{f)p!zSQN)zu%~p49&Uh*B
zl?~%{$B>~ay8XmK1X&b85Y6}X;Q(5s@$bX9731=G`S<D2LAYvI%eFHujTloK$nFPt
ztuJQ_bCd&bs3Cmd#KWF?-we+v8!^@u6Es>Fw2I(WF#n7->}}wX5O@GX_teQBT2>pM
z)DDU<&@|k+wSUjddfPK(Z}WISV2-xtYEO$tHX{@GWVD)vN7tzWOP;;W2zCeV@36YV
zj~J-Awbk85ZaUC9b1=nTaiv9f_&-42=UD=<ku?DJCC+PK0&|?=WJrL<J6Ssqh9Jl!
za1xZTTLHoB7%t_PKxqu}Y-+C0f6xhhWT21i2+6!!)@*Q;j}xtyDWc+Q69u2;S2;lD
z*NqYv7Vb@b&IO!d*QrGe4Ut6}N9dC*+R4TDVXx_w7+yVa-OES>FxRmCmUdo@Er$#_
zeT_OIPCstUS%mNU_d0IpgiYA8YyE8vc9Z7i;NFD;^|T^SY1MY_JC&0cCou5PU2PN9
zC1yQD`3pVocQv6>aSgsDA!>>l<7z#DG&#D(vFHZJWU{#Zd{F0rsud+BWJAiy6WeTK
z&NRA-dq5qKrPondbBNQIeGgjAj(qpdDiMp|j|T39!k6#<h>MAE{A1xUWgCg+OwY{b
z3X)p`EK$ZXBlpQBT+(S%Dua~ziqg7$n7U-`1B;Z1_o9slVdS2oi#_pfFaxQZhV+A>
z+h}QH{-l?0T;6gwsVs1H>|G#~;mN@yJ?mxMG~$EShP0_?+VRAqdwh|{6symc#;Y{(
zr7RybVgV18<fl31T(5+>YiI?$5Vl_6y!Eq;z2G7@kp<B%J<&lp!71Ui@sq5xN)3J<
zT`++?N++M=o@WOjN#yaFK`(&+-5dxwr?Sq%0=MJa99*C!SiPmRBd$(6uX-0(CxyZ3
zA(ME=&xqx&r<M_W*+ptIA{AM^C1@pp(4a4}wxgV!ldN_@sg-Qa&9YDTv;?3HMwR=6
zK@fG?9Tuc%=2ICZouJqZHx10FW|eN<YluNd`?0LWbyTO1NdVDdtXy&oq7opGbi;XB
zp$)i|44o1f`;sLNU=ZO@DYT~Xz$cLf2D$UErm1J%cq*Fh{ihg^d8WLk_kqXw+oLtI
zE-){fgrQS+U8V=7_tgE^ay}R{oZG%RGEe6YphokE)QBR677&zkjKO90{Pjn^I4Er<
zvs2P|mG-I?ylH$n<AitI>vW*@0IAFL$QxNCT*M#ekGvq?u5gY9nD}pHqd4->nH66y
zug|m@$DIrmTjyIo5qfHwq9O@`H=T^&XN+qCHdPiQv|<t4z5XQ96WIS)-2aI#T#dz_
zGL$Oz>uFzo)w*c<CUoKB>y{Q`7#YPw1MfTMp>-23`&DD}u$Q(Dzkwkt5z@zs`)ZJu
zUxg#!hrO&l2h!!qAeG4*8hffXd$WPB3}Y}k|8ZwqHYd~5e@<ThxiN=k)zrPOC3^P8
z_r<2)ggd5@NCa&{fZ^O3-E;XPhCz)bzwJ(N{UoN)M(2IUfq=aDn2iNCDftqZ9!$Gx
z0YMp_e4Ahy#_x#wk1GgbR^ySotjTtaj+Wrwl$1%v9d6uh90AeV{0-WtV!ry!Sk_;3
z=K}pRmBe!S__4b8m!52A9`LMvbL{|-kNkt#{<O`<)Blw05)-@5HZR}2C6#Mwa0<TI
zleKelxHN!F4QmtRCfIJ(CN?jHv!Lmbje+DEB+SMNhV$!=$!z`Ix|v1)JoMB0tpUW7
zi0^Sd0wu%y9vMwNfs6dfiuJ0n@zUokjzxAfb7w&oxFPl&dykOOf4fMcQ*DHfhrsae
zeh<aTUEwz~yDx2$N`5v@^MY0Pi<q<E1J(t|_`~&G*!hnovn;oAXQHHe_^QWeZt`Rd
zHhcU+&Ke_hB<8DnLE_CK<iv)Wa_1RT$t_PfV3t}pMS~C&*L73{<zA8Q5u7FtyQvzx
zWz1R6=d~UU-g8wCBv|h(%dwGNmqXGs(C)lF<InEY*6M<pGz;CKnCpVHW5onT^z-}I
z(ih^uLA8@(LTas!8O?^&os88DuPF_MXf*=Stk47(fP5d7VrglCm0E}mHZ3R{<_8OJ
za{l-@tp<zVuE6SZJR4yOv7D|aMr-a&p((WiqkugA=b=$E_%F?9Vw|wFuTUbZ{tRHP
zZVy~{2%^229zi-}eHOMjd7Q}k%GY#In)8j!^T$pE9IYNp-@A;y%ik`N=^C0_8N`k`
zqzK36k4v{RK`5Lo>Q|>*c~Tjg$q220gWjr=ZdJDR@;};&krBNvkU2P7i;?lOR+eXC
zletRUpSgpL>yLc&b(M8d?frYg^m+t}3N%3vZaHA$*9nt*|0~_Kt18QdM1OsnmS>2y
zl9(*~S)INxWc=0iRD}R+Fav(GRb)81?bfdv+RHl60S_U-&NU#~Ga%G>mjBad1AUPF
z4mi0U-auYFni6UfB{Iyzy<q^q_R(q@%+l4yT~D+Z2s!4{^%vVeL}Jk#7e#`Xqw=_N
zs7<0Lf+oRi=W_t$T37R|j8=w@SegL;Q&YRIk%EYO_VF`p_Klz9rAwFX!BW0zXi^Zn
zVSY0d*MW|3Fz6-K^A5YjIo`M*(Om{d9jHHr^UudoKofSl!w3*@^umys_KQE~p9?8i
zr^HUCt;T!RTIfWm7wjK{GZWz3nrlcc&ss*r??^6_p)pa8W;|LT*OX@JjmLbGw*Wvg
zAc&OK5ibeq<hM~2`*x5CICjyNO{>)Y8+p@=YDAm0DRQFiG5l{8<D|Jl<@ybre&vQ>
zbQ{w;$vJYURwU`P`p-z((5Cl7!oe@p5#gJ7a8fhaf$s%URp5~m!tW7UuiMYsk-1Um
zWZh-KPK{R~uDRPXb?q&chXfv6gmu1-0<Op^s&kyPHJk6E>b^3>OiLWlad(}P-!)wp
ztz*()a5-|6VweO;isEw|rbRgZLbMg1K@r*$Sc-ceAe<fTB{1a`n!G&{LR#k)yt3a!
zI*&B5>!9Q2Ph}t+8DgK}1g!640{F4^O3K#><$*6{Z$-^gp`}BnbkH9sZ|86FY@_j`
zX<!MChHRBK?bQ?Wi+Q=)68=7ca6t-yC2*Q6E~Qf}Zq}Cna~NqO|509siAG(tdm^72
z!M5d`=usv#TJA@^?A{4P?r)+V-j7uk(60spHfI74n=?MA?GvAyC}8m|7ZV?>`C711
z$VaZyll3GVu9`%fz@?2cO@0n}GLHFx?WC>FtNQRwqbnQ3X}_zsi=3raCwmqmL#6g%
z-z=a&Jl6@5terMRKiuvo7UA`<cn~(G6uCy?;VR>0`v$$P!?Q9r{`dAtf|lP#A6^u5
zdU+;zfOxUP*T_XLww!v@<Wg?RKucuUwd5*onvOcKt)s{m0KYpu+fua39{lfDBO8O%
zHmI`*G2yM1nMHZ<&BJXkhLqO-3jdymt9*3P+%9Kgn7`*WP=(~oJ>R<f2j{B$%RVat
zC+-h+3~^VxG%7B<U#oE~WHu0QYLH$6hnB`6I~jNaLP8`=wjZm!g%}>`vqlLXKUZMu
z27JbaF7<G?b)N2!Z-6W!oz!<H3aQqooD};$D;Up1&8T`!Zn%6;Z~{$cNj~$&Ve5S<
z<Jjjo56w%i8*GE7nr59nN<9JPUY<<4UM_%KFr_IRwTB2)!nPH&Ti)FDFJp8<bXMA>
z`||*5txe36Y}TjWCM`&WWe&vk0_plsVfj}<K5W)Z5dm;VjOLZr8sJFQK<{)9vd)C5
z3BYu3+oVL1gj)7h&58_l7&!L2RHprMO!E@%iaoMM$qf@Y#%0=TP=$x-j!<ey^^44y
zPT?STTZo#R1d`jN^x_W0Ib3bp)OCmwNhgUf+fG3qzRP)+j=C{)(YJjo(9)Gs!^c!N
zT)!0o7q)XNgpMNbCPgy<^4RJEsivX1;Py+d6bbvtJCx!_eB6(QFMG-ST89LG#K)?+
z^nvbIa6)-bDbY6A!9HRm*Uk?<_?B@Iy;X(`0cQt?7tZrdo{UtI1Yt?~W|j+{>4exn
zPYyx~OSr%i(a5#&hJq<J_>tge%h(8m+4~>w6uv9E3o^J%Q^Cu&DvR>MLguO(jx~IY
zsbzM8Z>RMXELF<p2UqI*kM}n^#H%Dx&Rd}&3`()s4zw{Lxu&L?ug>zZDh(VAidnQG
zTGm8KHWM`&a_^==PG;8blaI6=vu)V$%H2yx2YF}@(9mJ)K4L_#Qs;j)ZSzadm(!CL
zQeml|?il%?A%o0Mee*4YSNc#|>QR>VC6K`C-RbY7$x1STqK+ulB=n<-MOm?mE+Br+
z$pVEH%|M(R__j=4*%PUP!xzEvz@Db)k2gz~X2~&67MXRwF09m6%CPo7tpg30`fve5
zTtJ@JU@Bn1H;{k@6%$R<ZXev1&2&1q^d?!l^YAHADuVl?%kPDdA0q5}kk0Ic>4o6H
zNO`cs5vmbm@SpSAEUj>b)&4p(ET+5L_b;7Z&wAHV2ZKki2#q_!dn~O`U^eN9tF*?q
zr~x4HvhVI9?1wW?+<A=b6T^D-j%@AcV&u@HEgfbmm3;mNvczegVG|;p4q1!YuUG>Q
zM=~2&dux1gu^wBe7v`(!bVV{rkGJC&+~XvcmeX+vW7=xJ+?+Dg*6dy$#Mt|SCOs=^
ze~_t}1s9<=S>NE6oL8oIx_1INA9%!&4bijhvxO>l3q`(Q>_HA}=MBe?PvvXPlRM6e
zkFJd!0<}QD>+q&P0A@j(#0n^b5*VKHecod40CiB<ak^<iZ2>RvGuKr&<F@K&9QY{{
zzM6tJr1nc}W<jP|-*ElvJ;~;`=K^`5J4Jn6!d|K#9pPApu6)@xEYxyTHTON}J=J(^
zB+27^FCt0QkZV;Wo@J_Q+eh%Ew*uS?lTSU_Mq5<53sND9<4Jj#3Hk5JM^L%vNQ8$A
zx+$qrqh`SM7hj2K@LoftS$r80P`$+-QRKGDcZ_H@`-7SMB;O1A8YvqSlKiTgaj_#<
zI74k`fjim;6ZU|eC;gkHDtWq)&~ejVaPu-b54PdZSK?>SFi|xvJAB+?nK`{kr;||Q
zOZ_sRXrBTyGIcPFRmUGxEd1rA9eBI=-K7A5#S1D4rR)xAN2%)ufqfAE#lvdDVZB=>
zD<s9FiTWx?W7z2-QK9B_$db;ToGG%|;`ae>1tG|LasC9A`p=v?PRu$zH<*P<f|Zl)
zp|LA^ng7kev23Ir`>3n%30Vb+%sDc%{BT)@*znKF3tZds>ua`2W^;kWp*b3xmY6)O
zY@G5ToHZw6JM=UP5+o!L7^V)TlsP`ldhCJW${ggXH-Z*P=)vAFzs#b-#d%-V8!&v@
z?KL~4-fg74lO>j2r61qV46@_eD$Il5sE@9cyPm8dKv0YV9(a_S@FVCpNIkh>^n(PC
z!hWW0!t_Q`xLGn~5=jw}Q0Ui$iO}c*hfH1}9I20-4*!n>v^1D^4Mi`v_S2lEZ$gWL
zijAl@cwW5?4ERe6GpO)O&MtE*6+jsx)cpRoo^mN%VswV9(~mZS?SJZ)4%r_jAJvNI
zeejR~SRR?EFl8cdH^)?(Bfb6S!|0Bfh`FF0+qW9WK^SsL76b4w3A`x*v`^n5=5GmU
zdT7IWqyp~7hC)aH*PeKvrh)rK&!eJ4n3oO)c&_z%1}I6W4R5QVJ^E<yd)}9+a+cfP
zmf4EKy4-)Rrk(LqC&+Ma8M^~y<C-(tilT##XkcIPb$xE-eEvRjj0GkGZn_G<T-5b?
z88ZJWV&p?jbvk7a|LCXCyUmP<xXzJXm}fBKGV2NS{<(Q2%Y-Y+#yuYzBJ~B+JnQ-a
zf60v(`2Vh2KSSCco}1C^rr+st39yw-US9qM%*p9-^e7^qOs2qi89)gVH7%g_hf^gz
zcPiMiY@lM5#oXjwXO-)}Y6wAuXz4yuv2Ml(J2zZ*rouT1>esV<o5tPW!edkuf^;(q
zyYcA8-KLl;dMvAUvqFo018jl2m{ozRe`xjwdXUL>8itcQq~yH)#3!7_Mg@kM*#`>o
zzV44|yFu=JIPMt#a!S%+xU>il+JUIc79Hlzi;2GQV_^ZcP|qlgc_0PGeq=6;I`6p)
zeez)?t$bLic;wHY>$MILnHs!!)jQw{t2^p?WXpS_w3$?l%F9sB)?!X*hoL7feY~5?
zGd<@)6*hkpg#T6<N&RMUq~?{#vDZIrtJ_(^^ds~t4LQW^CcTkEyA7}6`(AxsC5Emn
zV4giZ2>ASIIdePIxX^TF1mPjAlWJ2YMU2bdmV>vHl1}CX@3;Z5pf6KCH{@x8qong~
zoo#^18Rgpkb6nfMC4so=0z*jA2Z0_6F%o`uezmWXodwH{WT;RMF>i;EK=#IK|BG%j
zd;6<5=x5+Vvw_<2Aazr+<%vTXx61&frg-cqk>kk=z!eP+UnjkJA}rb5Q*+9TDzqx{
zDG1HzogHUOXet;X{?I_fCNLWm?yfUWtcz~pGZq()0{<hGggzLUjl<Vb%T18$@o$ZF
z_t!Nwau=7n#s^0L?fIFNm^0}?8P0<uC=Da@L&)7aYkYiSg?#X=RfT56c>g+w(h+XW
z!ma>xf>jMSE3{{ZG~pKIDJiI53tT}|X^=f^<A1_T|AO0<prm`P0sGW1gT9<UKl#jL
z3w^O#>z1I$ojwoZ?VT-5g@QxEHDwd07BvYg;O%=#$s^}G=-B-L_t=w|Cs%jaX<qX)
zoEPwLV{+l*y|(_pMlzge=keJ95TevD@x-3m<kmC)OU_e8G6YW_rKWyo<x3<mMD@0R
zbQScM?rKwMMNxX;@i&D2fwb2!C<rY3ZKL#&3R&+aTUez{bVoMgL13&tT5kRpW#QE6
z93!`d1vN4RPpdkL48@GB-&*1GQuW{k0KRpM2o{&+9f2$_Fp&jmZq#9GfYstgM@x@5
z?tF#`-fiNuDP;{PZ4Y?}^pVRHw!056$h3;2=t}tsi*%HL$i%5gLg1ABooWcoE}Q3{
zPPbIlGTc?jVg9^12oyg)r^;A~kj?F&hrIA2YNW=*jMy`t^ailn&iNm7dt`DA0&tKY
z_BZzBHRd?Ov`QeJz;FD;-4n8<ujY$?MD^t(IP4>r06Jey`e~Z12|ck7=n#@HKDof~
z-Ay@#PzLNi>}v6moyy(l@zt6v=|PAPuc`oR@Waokkju?P01h(SMw4=9)zRmo{vk2;
z$M4*0%@|Iz^(ICJ8K<T>)B3epKuaW3<MFw2TGWkb1-<|dFG=Rq3t7oPjzEcAu?C`A
zof)ce^vk>c@HyRKF1!+SYI*PbeB<uMHnq#YywFPoDpEnZ=P#SFshFF;?L6`E5w&}M
z_h{S1W5A-OUVQArKpWAm9F7me+a8!0d7Irzx%DA`yphV9{ASR%tqfDyz!%zg8XJ{<
zzBOGcNO|A4jrGgngFc==Q&ojGySCR5kiSX|yBfmMpOgyX1o|Bh2e%nON6e741ph(;
zl1`Ok)Eq5(l9NUC83V8{!dAm<2!?5_-fTmaCh-x_Yli>K*%YlzqcFzG&JF48LY=?(
z|G)jH?{2CV4)YhUD2;JRo_3NkFZPR4SV*HtfGcF^SZPX2mci-DuEEufYusyQW%hg&
zwExknU+fWI)$7`Cvj11MOuy#(HU04VZvcbfuNzG$I*1;7&SvYEDjJ!Gfn3l7G{~hH
zmFm$O384b*Kr_}`0`;`gw9ru<oE2~tqdfFPx^iX_Vhglt&1@@IDokA8#VtVMWQLnc
zA)2KFadtR*&BAlUv=Whg8XY<^CVciGv<i~e4PxmRVVsZ)qYq*^c)%^FMpuU~Fyf%?
zfiuj`)g@?9fXUGcULyYUPfa(q4oo3yV#f(|1dSkJE})gkpjUK^Itj69c0K9l-u3!0
zm=4`bnkU^Q;I(x+L$(w10daP)g3ao3_i@5G=jI^?@Ed`R1c>`X{|TD@n_VeN0AIV>
zK3HDVyWPAjL&m|ln;bL?J0%@|QqFna%pY#PZQ*}97O-cfN|_PoHOa>p1q1|qg_QYk
zp)o_NXMG|b$>W{&1+*>q%9aDCN3+UMT${{Z%a-CTBd@*2P@FtHUJK*77HDV<MSU%*
zOKm=SRk>W^iZVtNh6KpW|Bj4pmqsF?>JjjDAuL++!$Fb4VHMg+hZ;kRpS$5(v4di%
zU0C?w8m310OVf^VXNIv`C|;1!f~eHc;Q|U8sK*xq6EA&%jv+at$58zU6>t-mxy#em
z*W(R=Jj6bJ$O^o0us<P!7o%=;-H^{8sRNrp7U${qL%QLSv$|OciNQERQi#H_D#vBT
z{|E$>z$0gMhmdC@OKAuc_w%NEEkV3);-lp7-DEf?()+RqP3BwoBAV{cIcZRQ5dmj(
zqI|r{u{974rYmh>g@8AMswd)IpLPbFsEV21>Wd2teY)raqalx$`^2Raws@FCnXOGs
zRq-Qaj_Fd;<h6@9tM6{LW2s6>h5e5RvEIPpzxDm<jGNk`Q57W@;qdWV_bg^W5R5qs
z<TS!@o!$p)cK~q@8XW_ntl}0LP&@zFH`>TQ+i^rKjp=Q2nrm@IJNAw2yV95*2bNvq
z*XdS*!5>;VQWUqzTjWJbrmjToS6yyY2*L5^4y7P|+i=H$gZl445#L7wvK;RQm|mb=
z3=%oGmQ7`6<T$llhZ=gVEhsZ3@5N)``3;mY4ruSn7y~-;qT6lz5C8Sf-JixZfx1c`
zlwjt;__Yge=j$iQRm<6}y82R)8^JE(YUWZEFZeQY!Kf({{EkTbPwX6uW}Vm}ziFwU
z{IJP+AKchX$~^LY9=ZbacPX$4AXej>*fYwc=Ow4S)xGn#EO&eFgBXC)^($vWf`?z|
z-km)njRNy=;NMYh>mxaa&(mk)@b=2SB-2>L+q-@26?Rs_t%}}b_@c@JvcWB@2_wb<
zjCxN-dp1&hxeREZ@`wQagJ3#DC|3LwvP2w0VHKO&?YBC>A;&xDi5^HB40qn#?qzoG
z4N(Y6mX@H3f%)2#`J?Y_z}I5AHi?<9-VHTP$)@2GA`v~yW-j{8HfyL`{AaKv$K2g+
zdex1$ynroY24eM(Qt0CC9llh+%HN9EmX}sBdu@3w_=mXRV;aO~x30LMu06K+8sm&M
zu6rWAa-#f1FzR^UcdPn|)iKkrv-xSl*Ui|+g4E0Xzah|5)uA(~*nG|GZD$*Mbhf9W
zfx!82WzFGhN)RdLx>qvokzmrkSiJ-LVt0P25DNK0Nhz;FR%xpj@H($*iHGm3n~noa
zbA7sZc)30jsAm6R>QebwGoZMt+&?I$f1^$s8e=DLJOAVHp7subf&c)(_uD6NCTe%z
z2vhnE$XG=6FD90lUTz5pk-3KeyjZUquBD$i_w(j7xI?~>QrDZ)_4G^%PI`WrEl-!X
z^aMmnsa80sX;NyC{=C6t*K{sIE~m=tA0*F=zmI-8lTQT8V#@zuMLA)}zh&>QVJ>go
zZ`X)r&Nb%uFjm^Yn#Tjzu8xiZeumtXIP)`IY;5P?hmxqI{#cRhCDC7;bpX@X^qFi!
zAE6N6CI3@4Mpbb?+fU_XStIu+#Mrn?s%8BUaYEjT3B>7j_RKM{A!T*Qz#fv;^0kZk
z&r(DVb<P_@%uGw_suO{{Gk&ZTmm&sPCvUS!>`;(oea0D!5CZ8+-UEb<Fz1^&+oRTh
zz@pLxNuz=(lW*3R(0+*hzsj}si(e{pL!l;L=P|~(E5(ad!LLwzM-}fZ$N(v-3h!`@
z_=|e*=D<V_#rc3}%Uo4lJr)#Kufq#n?q1!-ds(Z@PSthWeZ1t5*J!!s%Sw~^%^5LA
zCK;imx$5ifnb|q@Jyv6ZVJo{k(aZRWba~v*UcXv9uSg~Idbe)K7Vsiq$_|kbY2xm7
zf@e@KJGjJkfO*wX4zDeC-}o1&w11S5_S|>QM4M7|MeK!?e+6}W2wK%CG<kOZ1clRP
z^VjK1w$eZ7h|;w&sm}It|4++bg)dCFoLoUvD7)u$BM_=)+`4-ypVUQ)PN11egFV@|
zL^-gC>1Y5ft4KN{0!fDOBRJ>#k$nK>vZYO36~Ba?e4U?+tay&uOGem+c%udW1ue=L
zfJTtKWWv3oXRo*Vf3z_xFpOHh;}u1X%H=_ksptGZ+G&ofk2p{Oc0!J}IAGeCAIh^q
zbY<Q(tk%Fu4w-~=IcEO4=~5SbpnUdr0QJV@hx&07&-8PEUg7_{z80Z_jex8p(yJi<
z97YH_<HPsU0+bLOibpcJ#ECSDNaV*lL%GB{2*%SKi0yml5Wd8+m2W8QG{XcxqhcuE
z8V^tTvxZW~4Sme%`FZXKv<EG7vimM<{5S4h)y3PAVQx>5@>@Wk88^&{FmI7BEq1}#
z8mVWIGuPQvyp3D=)?DAr=mqrehXLpE2>7@fnz9-;6*CoM{2cuXUot;m-;{K637y;U
z#S+NF4}lCv>ZDx&9YOpjTktbQtGBa;XAUh={`?hJkVB?9+mASW5km{s!YBF_?_}yd
zn-P(KvX!$B0YPXRCI8Fy%CbpZpo;I|w1^nfT@;{s*ec<W*t;5ia@}r+Kh?49!_U!&
zg-yn3_^y81D0VtZq~hW}=k|#F`e{B*<y;1rNm#3?;qlz8J_$Uz){U58;}YPLZH>#i
zM-_<Jv$~j4k{&usUi64sJSw~GM#R^AP>iOcl)N1FYKVeJ-G4Y1R7K!=Vt!_Oc8}GE
z-LvVYkFUbd2PzX$O7HQ1NfjY<s`e{l+<lWNbxa_qNhc^5f+J{<>rpIb>s6gav{U!r
zVO_XP8}<|>s7OJ_xGzyfE?ifv+l?HzB;=(oagAQ9E?AR(**KpI4w6&}OSuPHefM-A
zYw!34Xq{N$$|7arJ`8vUmI!n7&i~+bSJ*A!1AA3HuQ3M6Ex5gLd0WTQ9CXrLWrYN;
zB=;z@lCkiiTd>ZCB&d~_fYP5etD<9|mePb^9mKB=h<%P)kpM2yDvVCfD8c)F*{)P>
zv-P)IK@my5JAddb_@`~=<)qV*4-^;IsiS)lu^85<RvApl%F3?c&F0(c+o^(r#+XWr
z^wzKoG-h(xQ+;FdCTJ&(*VQO_!^GDXqsy4ESdX?ehqVyi52P7!ooljF;)`6nT$!qj
zMO>gBK16KTvlC~j=fdw?==Y;$g)7a~RbX1th_`F8aimA!fqXSA-Q=j9<J9%M;@-Zv
z6d%se?R)vKTnfI58)%H-%6n|KM2ImFMuTI0*?cR9TqPPteh%alWKmw^S2<ItEjB1^
z?@o!93!DGY%Pe344hiB?-|GTz0V?>#d`67O(BMwhS52O&dO^v(y}W3wa}n$yZPu=-
z<Hb)>A{rGpk13vr4n_smw!hV21$N$?sK#~+`kINj@}V;5hp?|vb2)*GG10-??ZVdG
z7mOP8+#GdsuY^iv-+o*-+6I_soEx1?h%K~4CHf-RR$}CDZFiN)Oy49_b&S3|bG0sR
z8B!e`BCf0({m953LDNc3<0y(^_Dy^quD50oCl5>4DV&}B{0h1zZFs@$Nkk<~s6xaa
z;M~7D{`gC9n<y10bC>QERdW6`>F-#P8*}RaXTZf#kI_T`zppr5G#l_p4b_OUFcH}>
z{a{m&cikXkW)ehkYJ*P~bIt>s_0Wf3*+4NBX>7MhAw?{hjYAy1imIn0q+nS}Z_HIE
z-&n(Um{{SWzOc8FWG}VCwOik^1qX%X0hUHf0g4SWf`|dAHP}JxTyP0th@OO-jDx@j
z{#zaZ@X(kjH)@o|w+(UKZ1%=$K)^sI+dp{DnxvkpC6DGPtcJmvQ%e6F#B^K?Q|!wC
zHWyQ^2H8r0w>?)p;EoBLBNzRi;#Ev~okHK@mmPiNTIoKnlS*}@{u6;D)+JVF*2wyf
zD+(Y3)4eZiod1V@O%pc6bk|p-RM4S^TXPH>lr*XHy7?{AMlC=m(1ap{M<K5CnEjF<
zafQ#G@2yHhGPVhw3xz#ql!ATAlVp#V2~QJ8FHI@FxoMB=spDhMBV@K_f&s6nVc5`Y
zH>OXc(&B>9no>JB;z+zu7s%%?Tq3DmJtl{D@EWvIAx<cl@!)1*VLx-iW}UV{!Eo*5
z{T-Hkju3FjN}7-WTPv=&`|QeNZ(AzcxnVb}vvHcWF#~S!P1{T<YKG&zKN|A|T3)`^
z2?0u36$nJ*<J8m)82NSxj!JoOt0$Ou>!EvS0q7^c?=L?R1f$wy@C+lHBlOocYZkIp
zd}+_<0vz~W?3R-%G<rFaAF~Doa1+OK)DIfMbY`Qo*dE@3aI4$3NRZB!w&poc86d^o
z;mTZQQpe(g*o>L&g}94!9nrrwMrO;zjP||r;i>t%yjG@Mz{0nJ!P@2HHEybN4{P>j
z`Bx}~jo==+Hr;|Zz8Tmeg4^F1VQ%$LlU@{ojI@+WAIBP#y|XjyaD#L3_id@w5$iwa
zzz-wGfeAIzpQUx7@Imzgzs_~=@lmhb+(C!ZT&2KVTb@hW8B=48*ni4qVy3?au+h1D
zSJBI4Dv6YsgBacMMwC-qkaFY{Oc-M(`)q+UlNEWbq0<S)zBPbx9UFIn>~M@?QhTKI
zVAA>TrNcovh8~k21mYIvpmr)=)WNLEKlF3`<YkHHG^rIa_JTFSJ6J9eQw>V6>V_C9
zfYi!A<#w*`#)|hLQ9RLgq3!7C$;LJ<e#N(9<mE3W%7sV-OwGlSGI&MZ>>UggI<bwf
zLJ!nBE4wo5Ksv;X(b`JD*8A*%w3@g>mrr!zb_lw_m0-9{)q=ruxwWj+WNnPlcT9UU
zLmGWy$$+UTP}ZE?Ei(^OoP>25_-cLawjf1Rq{T^8O$VW7VNe$@NUzu6i_Gy*(vKqH
zk(|7AVW^hGN)VyqoXMDvDKX}2vL9Aic-XaV>&4Pu0xZ<@RQO@O>yJbbsOxs1D`8#J
z&(&3N6d>8;>(eWd|9_prA91%VbT)p&Lg94U1fPshQYlkT*+w?9_5%1EQ+*g9wmH?B
zF^U)VeWdYDHbs*FhBGF8Y$sUls*Aa~OCN{B?XW(U)KZaV_&6G&KP~Q7RPa^8lgID-
zpOJOXJ>E?>QVF)V6Vh7UPQ(!#KVKqy6rqo0jE_aEnI+|cUS11>_O{t}N($mTPnmF%
zo&6}2D_@mU-#gIdJ{vskEC}>wJ&fr|pLMreWFHyOwZN%fd%>9n68(Pvf_|>iH6pm_
zeKi<jx1dwPSqH~~ajh=mVba@jf9$PxW4!=tCmCLPqi*Bh+&44ea0F+A3-X<AnxYjB
zE@zW=Mcc7_<;KUXFSGZ?T5jaJ+mljUQ3|36R6|!a^Ow1a7tkUs|A=LTBHi*SA%aa@
zS5Y5L4#Ptu)|}hQvoqdrL(mInFK1`UR1cGs1<XrMc5Ly<jxKZ)`d}P^4`fC$O8^wb
z4_+t76cZ+ujWsaUcTv|0@_~R|Rjj!~aw9~{zFsvS6nu$`m;<(!#Bv+X@QxMOH{_<Q
z??!fr((J~j(_89@&`_J8XIG%$yK=(21VI|dLXYcecMwDj*e(2)Z63G_gfsvSlmTk%
z4cJn4*H6$H_}IMksdT0gYXqPS_|8V3A$yB0G?lM2eZ`H9eSU;OUN3m@R=k13pQKd-
z2)L1g_ys{f&=4^kv*?*=)P<}3H#X7lv%l&cG#M1ffrEMYvXUk;V|6==I$K9SWW=L4
zjoSn9inDgox{m=cxUNqh)GDM@#Z{x(I4}XSsh<qI%3D$&61OC@DoFgKgGQXwAQur7
z$(ehrzDzC8m?Bgu>R|Z&l2Is=4I%hKvW3FbR<W)!+x<3g1UIbYFkYw1C2)+<CbAGM
zvglz{bHA}X25_>$ElYlJ_U;Nm_v>8|l*1pNX2$pL5<So8>Om8ajo^<C(OqOZrQok0
zOJ4@V5~Hv4U*4}!DU37!!0_n5A*0GS#8HwVChaxQ9oUjD4BIX;Z1UCn5;m{#{rwoe
zHT3zMkm62v*L#X|Nt~rL9;-u)a!gHtkKg}PEqE3Gek+LP4gL4?!cN4b2b;kParJNs
zW{;_+5awmuN`dr7&>(a@Y_(mM017bm!CyJt0kq=Q=(UX2b@7u34_tFxpKiJ$*zpmy
ztgiDbWofC`!-4JzPlx9D1uLt5mrjn$@7|Q<Z6qmg@*C}o&Jc*T2sp^Wan(hr>PLrp
zU9LjdRy!UpkYw|yIH+3fgpf=n*?7%Ukc&baiZn>)qo(hZU%o%lFzgh`AuEWMR6IFH
zd+<rs<u)Hsq|&ZgL|!y7en_6rocI`LV>MIa%$LX8uplR7MWPgG6gFY=vIE>;0h48i
z^PKc$^}VTn*-aNHX!t`Kj)Ejtk#>-0pCFp|Tr*V>8Xf%_r(;}b0G%h#*9j4wfgw71
zVY>9g!Z**a<tD|+KsGSBLfiOw8$dp{orEMiM#okZ2%lCLmjuJABco+KKu1>~*A63$
z+Q<rR!ZTE8($8sy>{9Ft&Rtq(=)D*y`>RHV3Nuz?Byf?!%-yN|rE&XdZkRs_!F_tJ
ztSYS8#?>OT6muc4^wpBO*9(7zD5;3!D>sV7r5i@9hLVMaXJN#WCjun8wPfS4liT&l
zSo#!DAL4;<8`Urb73@Oa`ghdy2l?18BFPYRAbG|~baLttbUVWGD~$M}r37*5=$PCw
z67}+K8*&Ue7Ll|8;z`y907qBM-!-#`eQ<KA)FM_50vUfk-2}Or(_vcap+Lzbf||dP
z6#Spl*t!SF1FZkBq@U<L9ee2D1PB#l8uXYDq{Jdo!dE`=2&{b6Jd?kx2CL{}_ins%
z`|4xtH39WM(@m@PMDBc|sr-m~Y^-siT5qb$O5au?$kODT5r`TDlY2(|up%vfH9k<5
zFQ9i>tQsgoSzCtjwZhaitc_nn<hw^1&X3fsp$_Jm`8_|XycaHPvpws0l8m>02w64n
zT0ij{;$G02?Fq+EEK_$SH`d-O_6+i`TCXcvir~9oQuw$n|Dp{c*1`5s#ULMpTV!pB
zIj(0jJW~3<f&A(qVnI}U1oKiYNf>Q^)b;f!KS^=GZMJBy+D1ufZ)R?Bd%xd6HY0v5
z(DFh#4^__~g;$n;Jo0B(o)8HqZRs6PuS=hl;dWh0P#hwmx8>XE?%b<&b9_aTFqkG~
z$b%2=k5zZBHI-YQkOtE+6UCZ<kvKM>qtvz>mME{4**#i+VR}Fk7%?NlSJ?!Y6P=Jy
z9#*o;j6^(9bMrFxv^2{-DQi9C!)&J&(1?A58AwRwSBW<}SlwE`2qx7@r9Cj+opiY;
z;rVIczJ)JhW?p;nh3IhT``Zuj_^A%QcrpmJht5JDQh|LZcy%u&Wyd@yHe8Glhxo>1
zL{+M9QeeE_SmER{_VLB3uaoH^Z4@h+<%k1nO)|U$Bm*4=yFl(CA!^;`3e>}DHW-iY
zFyC=fzdU<2%MGE5%grvs5(>gh=TTIpJc;%y>|~c$XQfyb_M{s_gTr?m{9GLd+%Znv
z&o5x?hPxsW+^!@kLRc@<oW^;D{G!CRM{5Xv{MJ<aD_xP7mYDkwK+o<OL=;(<7CO4C
z*|}*!aa!%ThNp-zxbu5k5NO{DqwN%%A5EIBv(`rc09K#vH&<WB+}g)ESoGvX3k6g>
z<ZVR>h;3`$wpD{E5gCa6!(lU#i&hn4Fk8Ay9m>gQpdC@^u4DfNmx#Z31j(2EY9UYd
zUAJ(+!XM%$1a})*$A%ws8^brp39e~`6#VNge9D-w!fKzMM=eVO>}`_r-+!%b-Q(Oy
z{CmIBq$qxy>sFbHT0{n5MDa8iQo`SjaOtATXqK*wHH>(IAqR0@%DjLXhatA0pP{BN
z!A%Hk<woKG-pLy?4vMp4$0zWW;6dRKwXV0kch(%h!tF637^QGcBeO&|YYa!i-W>Jd
zBCQ${Evcojnh_a*qDK(W9+%vvk6kb~<XyZwiBh*xbgt8{gCLLdRe@WN8rxs>*$U9r
z2$#q-YG4;t;0=_xu?*_dyv{u?<VE>R$nuqI8se1TEqT-{LByr<J|}xbS>Evz5#K}G
z{Q$a1+;s}(?+1dSy<#-zHX8q3OyeP6a143OS3dwGBe!)3=j!M?Y=IHcU46Dm{NB6?
zV$|iFH8g+yq-9`Mz)ac#46}G(4Uj@O>MjA|CfM<YI8jREP{_>Gu=nyws9t;p^@m;}
zYWM|p0-B`&Hk#iCe`tLT9F=9eE7Noy5%p*9p7}r`^zy=J_vV}oPX7HydFadM=u6C@
z6huENS$U=ZrH`gfqd(y;5#A5a-l%R!UTW9|Oz*f|_{=yY30P!Gw3ETtVErqTBI6}H
zWQye&vvRZ<!0SEAHTawd6rGG!f7%ZqKXY|OSov`1>{sx1#hy*5J;F>7-@JWB$n#?U
zBfJ;TzocU=do^}ghK>o24A;`a%9zisib<@G#F#@B9s{fE65>08zprxGBR4q(ho`6n
z&BHFEf$cKA1IwK=z>eY9SvMl^{kac|F$ezG5S`~kg-PUI^tk-tA@z3nE+Z4xV?qcC
z2&WT>m<s<Xx9o2AxmAUOM!cIHmD~otlJGwjg&-R6oZJr=J7@^b3dnW*^KA?Myd-Y{
z0~dm>KBi-T9B~va<knoqlz5N@j_pW8GmH7S^5!_bbK+~DO(CdGe6tYvHUERR9tu4k
zl@7B5hYmH+d2Ys5ySzJbc{m9qo>mh|@!Z`>oKHgSZB4i`K{X^ztrY*uir%?hj@!aL
zA2#alR{3&0t$K1D*)8q_JHQzU`kU5QJ6#_fhaj@Z&4T<~xi6}{bi1at%DFG*$*Zn3
z9&-YSOn5zNanNXFNOqGA?%7KM<*lc3Fy{o_L9Bl2xq8oK=(xzJ;1ayburnoSCD=t1
zA#9LM+h$2{jqR&6qS?X{Jtif)8)%Je4+9qP9t*Ha&sQ1-gWV>9Bz8=0X_81;+v&OV
z!*?B=mTc-7iM0p_C1oEgKgGi^4p`bm4bEs<P`cN8F!fKda`U>ooyOXva^C6dHq})b
zA0c>-Z>EXrbDhK@sw-dZ62ZO;Ml&4&0e6fW`cVOV^A5gufO{PkP}ZEzV}V(bjUa<r
zA5a!-<_j>Z?Y)nvB|9x#iD~d@*zv%gcG;sn+sskB@dV5TrG4b$--qjk{ZGBrc!UPk
zaTU|PXu_0PY-ik=T3pa+%fV5?i=kM*qiO(2{a7e}$_0jk1Bf%{)BUim+xb9%K@=83
zs*#+nw>FLWSLyaKYq6K~zt)kv^)XMUiLmhqzuzEbD;docpjszG7zOW)b>Xp)@vA)P
zL}&a>&~A;$W+26)e)+5kkwDVl7HpMlT3$dt@Kw@JG#>$<ab-l8!o&4tbi83H$g}9j
z;NlDygu9(kE!JXS;f;3aa!$4d6ctP8Y861DMj#RxmQZ9>N&y31b@6$Ig4aYm7k?mr
zG-pBv1ef2J7c0_BW71VEpm52Rz>ip4o6mYLytT3XwUcivx&{&FINp5Y>$qD4XM=xF
z9554L>4T=B`x4&Nt#GmeJOYH>R=q<G^)f(WuZEUdTVd6$m7>U#9%jv{N8aDet%co?
z1C3lMNqovRq;I$ZynfHx5Yr_=>M(8ec_i&F2JC^Y7}z@c*~<!t`!*OIhr2ilVVisZ
zfMt(pJ%Br$5K_9GShE0#1Yi#?w|p+#{a5BM>h6{~9Gs?>-KSFe?j9g8+FFT_+kXsL
z%966EJfc>|OF}ULt|Uqlt~z{Kw-kDfr*~c1@r`Zsu~6Ukk9TZ(j>Y-n`XFF*wi1&3
z9}o_u1RME*W@}WP`AC@3H);UfG(0}XprkULcp$LX%yXqj1zMw=rUz#M4;-)Kh%vcg
zR$6rhbm5J>=h44B4L7u!X9PyB$s@c8)0v(t9<Dc<`<GD~ki%{CA?%Nzm;OhXcgi6E
z+V{|A>~m+XJgL^%j(&eHlev%pb3ArVj1FE(tGy3xE2YJ2FuHjxlzSBl5|R7S-{al1
zDaGm!X1+#=$CCjPDIjfiwUI4Zm!4ZidkK$5p+Y4AzCSg5#iYSUer3W&fYs03X{z?}
z*315s)qWq{5PL8iF$)+VvHrOki6a-InYL3!72H|k)ZcYW?P|hnB5TLSe|c1*VJ#+b
zPSP8Bbt*65i~xFD28jYCBM#Fp?u`&~(0L}HvT~-%>As7P$!M7Eoo1_J1>}(U7y_SO
zv6*E4NCk%wPvUS}7sAP<PPB@B`HOTL(e3F*k(^BmBv{AbW;PDdvc1#0&0>k+VX+Ur
zsS_^;FvT!|kQp|C>3IX0{}L8kT@)L(iUfCPgSkNh4`x&l<?D;7HD$f{Bw^RI8pYb_
z3nwJN2}aRp^Zg3XAoIl2>)1kuUcxy(e(-kg0)y?vq4^zvd=(F_DY|?)+ZIcf$=*t#
z(qTRr2K+9!0q}d?WRy1eHGcpGvr|<HP*HEmV_1XY0Y4lj?M96>O~xG|Hs%CbA}=yc
zyfh*laJ_7e>j$y5^#v#)s`Qp%P>CZ3yJ_Wk$em+RYwr0#3h9~BQ($6u9|p?<WwU}s
zRum5NdB;n}_kz7cxbU#KHd{7!c6=R=ev)0}Sn=Y#rS`t1L4%KKp`;`>Y3uRYtZI)1
zr7+CT9?!EV5bKlV;2}<ZVO)<RuZ11$=ESVIjrLJHd^Ds6=AV30XD+&bz^?hS!8&4O
zf)XYAS6e%2)A@B%=98dR>D_8gc4CkJP8UTQgF&OR|G}!B*W77Su5zEhjZc3T=8=aZ
z&zl>c)RoRdq0?3oSc&9dQt!JFp&BlgmcY|o!S}r{Nb=5$NlhFA=P!bEb=(Z1oL$H2
z^a@kGs5BY4fdXrf0b>W&vspO5iUUW3T5xjf-f3ZLneoL@{yT!uHyCCBrnwJL;zz<u
zgXxDDr^r&oE)|C#FP_U_nN25VC-rE=$0F;|9Y+cLPvoasxF_3vH$d?YL*A^mVq}H?
z0l%b6zKyw%_HHSr$Qo&cT1#aPyCcwv1W-{y7n4BF09O03-~{?js0Us&rZkh>WqTSS
zQ=}koAz(L!MR|LYRR{<`gtNfhyq^m$UP=GsDFcT0Gk%8ZsRBn=Hj1LG^;F&ke?kF$
zWd0!pY4{>YrRU1ITt$TVs@!k82XwijuUInB8q7=lzu>kX1A~6c*-2@aycpPWkuLDo
z)vHJ=JA=8K&FKT^vNbMzk|4OLwW&`5DV2|JhF}YRY=oFW?i>^ZzxcaP${jap*Ae9&
zmi`&-71oPA&mxMM9bbL6S68W#+X23Zy8X@{cTZ(^6N(4<Vs7!QSvZd+LmuoV4aeKh
zU)II1N&Jtu#@C2djWH;76J9(FblJKLWO}4~zwF@MELWlI6fUq>hqd}OqA7X}eBd8p
z?M}Eb-`X=4IFz9wupR~nr9WyHU0xes68rOzp`o2th8?9yP@1?cSp8ao`GZ0N_f7*-
z^TdklOWg(s+f>6FiK6tid8nojnnKW`c$h&-<Z1tUY`s0082gFoC<eW87vM%XL$?eE
z<jXWF+{__O>i)FdF{a*OE~7o-vdIIP>k02*^B~AQ<y#sS$PONB6MzQE7iz<yyYB>R
zQ5v)=^nTTUo?TUX-t#FToMou@9x<OS1OGV{Kd?yGaXVpN@d^&B1Pjs~|DFJAF7^5g
z9jO5f>whqtA2~nr4&S73_H2ny@Z2)IOXul;q^+vk7_BG;2e63?Ck>+7DaglQx1C6)
zPb41JZB34?Z6>E_V1Qv6!+0DdNF#mSEhs?E6rOHm_t%KL5bAnRhzG?o%+DAUxybY(
z3~s*lVh2WdK>Z%_lqSL=Ei>L{)f=|zx_|AjHl(!_`{xx+YQIFgZ;wp_m9KIi@ic#@
z<t-1b8HCTe)W1`usJ;x%Z_zFP@z>Upi!}t(o#xf`am7B7G!vB@xGv~g^JlF)MeA^H
zMkVr^?JLBwzjuh(jerU~+a97~*V$P<-*HJcu>ZqwUPIas_O;_L)Wh9|zpnpK{>Oa0
z4^`8rr?7SnzlDVKopD`R%JNnp;cCXIlF<m39I0TZ41=zJZLk`uwNE>q)88S2muR)6
zn8;pYNI?Ebe!*yC@9~tcXPN`kz@E0YN;1w$X>WR=F8jm-ZYPbGX12zZ(>BdZa(E+>
z#`dI4Cx;~01iOc17=U3g$J?x==A=Js8Wl!wN3l2J`<b)LM&L!@Cx$yOqUX{Nj!!^g
zuLeSB3irifc-P%_m`Itt2-QDlbAI~D-S~=JLkmp=Sgj9Ra;yOS`(6UoX?Ik@$P<i0
zcnC&*V_aWcK0f&BxBaRk#36HN3vyiHPKL?tx~Z8sd}<=*syT4cwFk{C@|>6!WE$^)
zZ?tRp6^d@b<=7_qFjyWy;E!WO?$0z`O<Mk+*L?c<A#+Sfxt1u6;tzGgnHY!`Gh<()
zdP}t@<?qU{gCM@U8cgfIs$_7W#=O!1(U$qCxT!XDkou!g@<~^8eBckyy`Bto;1Nnz
z=U!YydUt_8o^kY{&y-EtGiRg;s%+M|dmIl?imT%rLZ194sqre$>s62`*k*tO_(n%U
z^&Q5_mTjqzK-he#pdMUnX(aHy&^{kkNk8MSN6?uv-JAceW~437L;y8F%D*GcJi)C<
zm_$&%Z&WvNS=<srSGT_a;XV+u*08lTbs)V_XcyB=YPgN)=%KptbzCbbR-|1kTUdaE
zz;h<DQ41U~d?JUb+6yaw{&njjK)v0s&-@G~Ah$B0eqRisbQ<UY#5c<c0>U$XcM91T
z8qa9YXR1Kb=#+Yhmz|%Y?yN%y5x=-r&_M{e`QTxD|MMUI*rm3=UztEGkX{N28Po>+
z-e^V}-S*awwjIQbsTs^=z+a~B*C3?b!}RV}_h7Az!Brk;!0|u1|9G64;$2&{d&P8A
zN;9phIpB<6FajMz;VzTKQZFcbVlaVClix&IgQsvHQr(pI;JGULD|p33wqGFQ1u+R3
z>JR)wibc;kB78H7E#zh)y(m4(#a4qmSsWpL<|5+KnAQ}-yHttKU-KmeF4YdGxMJsz
zE!sKniKlLtu9`nAVZ?n@;2oOpx(N~~EP;$$y_=}im7ai8@(BC5Ko$&xNFeC1%OfU(
zW}v?ujpU6gFYC@*cq|BU4us`x5%@RN^kJ868Yb1C4zD+>70-_Hxeq+cY#LwB<0;Vr
zaww;{)Iy%b0yWPyv-Kmrmjb<+DDS`m2LCY}+dki^Yf;`HIBYxI^1CV9f+(g|8($sY
zr^+n_=S??B6PNBpjnYQ`D|(qm0}}{_r(rNg?xON|J9p{4vB=b(39OxvzC~Q_naV@2
zVTrrY31uZ2;1@<GaiQ<W?;4v$!-e$vp|L4EN~cLa)tV?1F24V1*SQmPDhytGVE4dg
zHOEg4)%t<GUN8b8G#63>|4uq0e6oQr2xblItoZ{tJbzx!g>shSpfMY4!bWC>E-znD
zhdVR7I^&>`P~)w8FZW&Su+ph9$%^2EOL6<-gPg~)XOpru<xg0w3?6n!O64_mx#Vp`
z>!P~Sg(tV*gNz2uKQKmXxYP)mUlB5Z(bDUQCk~xUST*A(YJ=(Y_{uQ&0h(iA(10x6
z*Ym%Y0&g9_Si-0E^}GOy$bOf3*pOVpIQHT8#)@-{lHh~BMBlb6y)i<I9`|ZA7sPb%
zB%G=QMUwmngOV@s_3G2)7<B)h@Gm2#W6~-+;4~VZ;mu93XXL9PnoK-WF2sa<6VckN
ze%<_(=ysz5KIUJd@QtNk{elz2rc$sPZ+h04?78}hsVQfw##3Ghdv8#crXK<>IZY}D
zX_>XTSv!b1e8L^K@$-P|AcSXt{%{q>Md|k+m~*mRn2DPsodye!IfGabwOECbpv$9|
z;AYw^L+iMc!a*uqz^wKPI;(GdO}CRqgsK*FVtYbzihU!xKfe2XT@Cq1aDV~HJY<1(
z;?P+LvuXB<u9AFbt(+*QUb!vc20Yzo2OPLlix%#v3Y_8WTEdM_ljNsFU)V{MhuA^E
zYBkNBf$wBGL*tWd<(KMTQdQc7mppH^0p6%IK_e`iJ)eV9$rU}x`=8A6IFAJR`dek)
zx)Jq<Adxaay1NhnfLuB#N*vU9ep@J$`>+#%KD6nk!}EvVnN$Fh4IrXz2Y_e>PRXvA
z-c~q8(#~oIly#0#C048d+=Y6mV%}oP0E?s<eJO){K(Hmo=^3sFD{I?7td;wK7X_#V
zyM!^-8?)VeEZfJ#%2UwgvC?jVLPOUwB69=V0^2)H3)Z#&L;V<k3@3s@lW(-tkSbK<
z2tCAop~}2t{o2K|R8~Sc6tK{L<{Pi{?rv8BwzY5>yzk5AD?tMvp_f^=BlRC625~Q(
z+*G3lpDlN?=8D<rLCR;K4!9SB@2dyeDX|mRi_Hl7=P$8ufEPb_CU}GuY0ARy_EvJg
zR>yi0YpNBEAwH;y2XNC3zJVFu*r#POQo;m3RiH3%w!4UV?n1&gbzgRPl+)}Dml8}e
z1d~m6bG`j1;LeU<BwdGv;{-2RfnfHvaZffL1L)jx7NMF-zQa2^UlNh+(tglU)kSU0
zwL($RDUj`O8@31{z$ia1YZjPgZ0`3$t-b;#WTK?=pW%~XYG~R$#1(62aV87=pfK#@
zi_1wts;WBWnkFet+a$TFmNb)glxCrW%Zx|xjnF55gO8pIL$<bE7D=CrwX^GnX-EJR
zok&^Ky;_aNADz&VGIe}=pK^1LG|`YbX@pj%s+^!+GElfoS>SR}elMX>-N`v@2vykM
z{TGeW(k{`K0CLAsAGtuxkEP%CivPS14fjQ?@m)}p-Ej39>p9OmFm5mr7bL#SUfviU
zLBj;(oFX~^TR9&nA|>1$yfrlD_u$1x0iPQj-n8Fo)|IG`t6#k-O(M!*f21dxUa_S@
zzZPvhxvB`rBrt3iq*MEym2U^RIVuCIDCCl)e{lIUZM4mT!<CHK=~a@tNJ$S#Jijcy
zoNyf2p=ss*)cK}S<LMc0c9O_g?qOP*pSk2SiAzq*4zAY4>@_Q&l0mTHG==9T-9HJy
zt=18Ir6Tr;=LdT=hZFG;G>O|@+d@igO5H-YW(OmK=^V~UwK1$VVX8jYL-I9@gDU?X
zTq+*h*t}}0wGZ_kBZp8Y=z69ptP5~S;Gesh?6cY8Te>~bx;zBYsryF+v+gZ>aQQ4y
zmH*##n;6d(r^KcK<YlSov-R|{G9gV$Oxrb`#_)2;9KRG4P*|$}PwE^k&CdL{@}=*U
zNEpO*7zI7Vw%mk!Td9BtR=qF3Sv|7|dme8)u(nBBo>Qr5Rj#s)9~8$;sKG^d8U?=b
zspRN(aCV&-&ka2nBbskR;E-G=c5A&84%h*S4d)5w-xYBsLrQrlw3wU*>MWa+ifSCQ
z#Z6<$VZ`ekRF^K_$0~kS8@XnoPw*M=RS(seHu^k^MeMUzZ|GMtq0ymxH7BmKN0(!%
zY+^6>i$bd9UGSV#eL_(W?QlwWI-O*^fj6rYhhJAuLzCQAT_0`&G423rn!thig`uyi
zB;@h2y@3|ad8I#=6Y}WfT6$g?%a|u0fu~WdxxgYhV;_tA-Zi07XD;I~%2g?{5LaPA
z0bilJEakEX83{nE3vlLMOo%T{s*5ExxykesKS;z39C7aHUo_Y1K8q~s{ekE?eYW@e
zF?YK;d42y==OzwAb8qVGnF|))zKJL)l|KT;tcwKMCtPFi7568I!<0hq`UihEJ{+X-
z1X8S#9U!ZH<h^$yE<d)q&lxm79t#zcs28(|V;m*HKKrtXFelIRQ-&Q|DBQ(BueR$d
zXZ+IY8@{XVO!p<#(Qt1qC!&7R;|0Hna6bCtcT~2?{?AmR**GPSP&yTE$DRP|@<llP
zN>2thh|+SM-Ab6CScYN};0RL~@GXs$pv-0Fw<26ydy^j^aUDj}CPf$ftl>jBs0>ln
zncN-gPE(CpF-fi<m8(tY=6uIg5%Q}L5sT+{*S8pYuc!yuE^Ov+yVMH&49E@*d>~xp
zkg3QgTeO)f%N%QF4rj!EE#Yc%mDW4BUZ?%GcWp;Hw)_pvS(TlJvtHvx7|sKc-e*X~
z^#<I8r-W<<eX840MyMHi!HQJ55((=G!phitTnO<SIaX{`Q5_d&cs4x?jM`ZRoCb8R
zeEP%sEtJ^F?-ozt^a2RW?~{6NT-R%RO{7;qN6r0W?me5!N+AWg=F|8Ed_w@yQnCB%
zoqMN4CiX_WW9j%^dBanEb`2qqb(_SRFaqv^;~6D&rlKCTlxKN>F1rAWBkE7JYSyoU
zr>WlFojN_NS!QE@dK19EkxV;sT?Vc$DT>#+XKR5D1PTg9!fWQw=yB#m;VI<)XEj6w
zShc>Hqmdor8pwUt8dPtcH*&t#&_as{#o?VmvdA&1e>v`wH*tDc_dRMQ_7Rf8Lyd7M
zL@w=iL?Z$$sn<13;W`0J>|*Mu+4DKWCn;N-DF@lAlMx>U(km+%NF?n)dN{<8xQf+#
zxn0x;-e;$nquM;xtBp+Q%SF&qmt5u~><_{gKOPXPPdT(c=?iN^#BB~)(~4g#&GR9O
z>RLAf!Ng@ocjMf>aGW7BL5)9@E4YH*W6JurD%U7%*rj@ZqX)>9&`pXX=ReXVK&ruv
zMz_V0-p$Si#!bt#ix?=-^7Nr=qCCafih6tB6eF&qF;UTOwtrr?j)C1;C~ms-Ep>w)
zz>s_~ccJ-P4W)?!%6xCx9?$E=0JGV?o6Zw5Uzul%`*0WzXH<JEMqo2%TU8)^$78C7
z=&w^RK(4Wn0OvmlFwLK}(}%a3z#@Ns%)fmnsBdKcylv0q5Hn%LGTs2ULz5m{=e!9p
z_H5YzD_ppf3W(ST(T+hpndN<Xs0xfk^h>wn&}2_WS{FM)+Uv1gru(Bn&={uDDaTI6
zFiytDQyYuamp$^^is0%pVgrZr(6YfXRc`rpdeE*kpWSo1nhS;J{qKtWQa<$ZJ5mSA
z)NpvZWwT*C@n%>gPz*ed>_p#L*<HhCzBk4v8$6kMjSvRZfAUK|nyJl7&ZCjML$son
z9#1<OraQPmgO;h3KT!}%=8_ONKBlGCGnDZ61n59KY^#d9=)-^#s$l|jh+~Nf5pD@g
zDK<%cwb+>>sK*+Kog=^I({1HAlsE+1u$kP%u4ObEJP+>w04au^zP_M4MjnY;Bvs6k
z3?dQ_=xr-f0RgjST3u<bLNUC0ae<M@K*|c2T$r_Lg$C8ji{sv-h-hI)rS=tF0t-~&
zx~=FI9{PQDO9vfe<KaSD>Vd+)5^D^*-HfBC8p7VqBN6c+R9>imHFzT?hGmu+O`BkV
zG-w;-d%3T@?|3y&mA%p#usN<Y414Ca{6itYkpgN6HA|Ujj-wr*tv1px+I@#Jc7069
zF!nh>{cdO{5*GQRR3*Qst3*jdpp>z4PWSZ}!7(67wxpmx&gxH1uz-b4Xm4f2CcJHg
za;b3&`AaiAM^7~`FH6!?RX({Vl7cpQ1(^<!Fxb~KCY|j`kVUz!4DKx$dM1qXW}&WI
ztG2I%uE$r<nC~H{|3P)_vq27HV(nRq29i^MHb7qd3w-Cp$2KB&e568qZ+#KnN;RRm
zHmI%!*F=v->}1Lm{T`*C(z6>)J8*Mj=|jVFSY8EUB*vF~Z1dd5vn$%W7|q@BmKRHh
zq(1ga2@E^227mJ0f6VyC)1M-?D~1?|PO@P4qw!8fNjr{M8j=HSFE#rbR6c+CVLcTg
zH<C_n0Y(k@p@#e+<CUfi8r%lZd4DB_1yHFuz945o3{jeN31~sxC=1-1D)t!UA5WkJ
zS0JOQV3W8q-*L=>=8-oJlJ`{X_e*Jc*zUXT9PPlAJa0FpKd1PH)T=6!NZY%mENK&B
z@{<|nNRn;|C4rSq=EN>0Q;YKDL&MEuj;H*s0IW}%0-}OOHlL==5J|0*eubqGYsP$>
zzz<i$kO~VG11EiJU6Hk5&Vjmbn9h!;NF;P5Kc@XpQWe#^9TJ;frs-8kjpY2}=Xxmo
zXyC|gT!%ukHLe3r1rcFcc%u@#{g>~3u&@nBa)fz{@liO1jdeuL<wZCfLV$?`?8Ji&
z`y?bzBYFSzSl}PInwpH$K)mi9sB`JfyV*tv=)<e6#L`*~wblx9Aj_A%;~lfY62`LB
zbVNL#9LPEUPYm8nj4n#2oPP+^CzO^Fl#D9D5zTy(ylCdPjPvjOkiZtL2V@fGA}@Bd
zgY^lR)vq}xtP?8w_=KiKN=r9YQvt|#8ZUw1?t3ZOmp3HQ3o{_W0Z0P%Y^kOIAj+_E
zm@{uEzZ|s%eI8`D^^@$zwp-6HZ$qPI3FD}AHE+CC8?vRpox!S~F?2s?8=<aE<3DJv
zV6thm{%%&5z%s4BX}A<hgSrDTbnnZ#`VB4(dAv{6=|+C3b&uW2A{b|IgiyF!*c%+u
zXL$}^s`_)#Mg1QIzDn(%z7xqG<rwmm_ciF;HnIJ519BqX_|>bhDJrk>5c<`Fx<*<z
z9O3q993}{p2m0Aw3107bOP#2&cg6ap<b!un+S98V1LrfLsva;6%0A{mOUSj)`htuw
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%0Afb=m2gZ4z(E`$+N6M13<eGUmU{hxM#Ew|SfjS3
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%0D|4NF_53=<cekONa@?kg0<+Kc6P
zgx-5hiWnODj!a%gaMB4JrEMjoorppI&cK*DN*^B{1gOJCa}FT*>l*B|Xz3g_V8@o;
zMH*!F+2i1iOJ^4MX8K}r+B8e?R?+VlO5(LCyG)#szVWQW$N6#cbd2794cJs73DO0i
zbrXFAUeYY5{5irG=%fobx!go`WZ3+u)7)?;5Ak_Yg^RaN$mb>spx%uA0OIpXAYfx{
za1*K#;lGJY>R0HEpNIHeWY6kFz_#2UIJoGSS%1s@ewMDuWPjBXmstX7mZWhf*H7T7
zaAnmlQkDPR8(&sej-fNT%8CFcQQqhsrpuGqq|&o8yWuHR_+<sv^#}<uqNA0}02xDX
z_XLK<St$z3@j%SXQkGC>$+FNYJs)IW%kW!y{wRf3AVmcX9#gF`b`SWPwa;xhra)HS
zT{$6;4QWX~q><t}43{z8vB=}GaC+*<b|=j7ip}Nr)=)*~6UfSYAvU<nC7Iyeu7ZND
z84ewlVF#$Z#0DdWyWKw_pe5WNeW%vo42QGBhE99bwF#Y=aMA;cHAts}(Hn!wo{c{C
zdoB3sc@VBCS$WPd|LCvyGq}y({Z_@Ybj}2nd7nq+vUkzRkijS+Rv`;H$>1?_@+x|p
z^~rV6Q-XniT8ht*;#7B5DCOnVVJYm6?m79#cQPObXh`aaSaOOI_D~-3ApWJhHw}D;
zowd1E5urA&_ajZ#^PcN)`lW7Q91indy>fE28<-ctQ8ohMF3rv8IqmD$#k5JgIN?Y^
zp$j)fz-DC*E3)IfOZdrjg@%ecY+~<6-=R+;<ajbnE=A*4T$o*1xyyd4%07sVL>gaU
z1<~_nM|$HZrPR7&Yq5~Bcm;bAZI3{5hm$Qt4Vx|MFyi56-KuJ_13^SR`jB=ewV%mN
zr4!RQBoz5di>tTfW!}@evEnd7Ij&Y(&u8t@Jml2@`N8Lc55U)nSg^*RjvR)PULnD0
z8PY_=j3@a46RSq+3n$c4GJ>s>3T*S!d`Ugn0FfEnjhV&Bbj*%&vB`GL0~nv?#=^0n
z)pq-~@kUe===(wTaYg2g4!KnzUKw$;zFPa{#5G<KEM-OJkg>Sh=^C`oPofKKDf1Y(
z@y#rc4g$g%;~SM;Zv#tEHhO8Xz*9?cdlrj;U-}a0+oStR4X1DFkMG$x+p$vnQZ8a6
zXe`Z)?Vb8=E-$N1&Z~L}sCK?3SMqt`(lR4I!^IXz^m38%8k{BX2uch_r#Ibp{eB9=
zJy~n$LL7gzP^JKUG#p(cn!cp1H123ycIO!E+4)&N>HEpie|wE?)$@hEqx;Cu_z-v%
z+NC$SLxHi@AB8Fa$za1vV}1tE32JSI^JN|^q>pgj3>DPS-dx=)48k}AVW=7|2O}lJ
zrZ<n1aZ@3WZ_3cHuYLW3lX5jY_LumiNBS4_dsvGcf5x&sc#O=-EU!3ZjW>2OK>IGm
zy{?LnXrrWec2@o&TL}2P-~i15GdTn^xz&Lt3dt4;q-55$@9Gv8m5-#N>}0v)_6cOP
zMh(6;{bD&M(;mel0MqF3p6MQAyV6Hv?|bw}J7`?kK}9==d-_p;DOI&LJ7lrD@-bA=
zNP2dk`Zcp?0nuI4RwbcqL$)cf_!N6uN5^7{$z0JP7`P%AY&ie43+|F)ZuphFUB^6B
zPjSL5fJ@3sMm`bWM)iN+J^Kv76EH}GP$r*xMnk)BS=}nlbo!;C5O=tDGrvyPi(XP&
zMH&-1Y$*c-t8o4GF>{fXu+@R+p?iU5dIINMA1XH=J(IF2JPIZu_svk(0Y(x#c?{$o
z*`dIDW(7MQk-%#<&PK|!lP6KaiYqWkv1Y^mN9lJ@j80xWML0d*EJ7O8fKA}eyuFju
zVWtzz9zDgc$`Lokxi}7O<p#k*gBg|cv}8fa&*FRbxd^_lynJfx7Qr@Te}1<J3?2i=
z%`(kN$=b9-az_1abJh$%VI2S~6O9e>s_$!;LTnmA77nJ~SbWQ5T+Ml$F=FojgT~Kp
zOG_I)w|UB^$D&MKK}ckau1qWXt$=KAC&)!WH@}cu4o^HjJ|bq^TG;o~#-9^t2^lS<
z_xM*v)HfN~yk@_eB@(1Q)zxh#He8-0$hN7FC{Gg}JKa$Ib|TNzzDxqt7P`=oR$-wJ
z24;&7gRcs4Qrz#=2qHmgo9@PUhxR-#!Wf{%m@eJ$O=LT`_4|ZSioS2pFD@Q}uxXQt
z`<CTqfdKly4oZC#cIdQe21bu!o>;MBZaDWkCC(v$^rT?!z)%~u<}3=W0Hu3U=)XQ}
zRBc8_DnWQaS&YLR{n+uo!C;uaPq2MXpiqu&cPye2#_BZn5tngoN)ZOTUFad$(`Z%q
z5W~xY=!D-Xb_m3hkRHYN3*Kld6@6svPrvC11x&$y$OIZN-b43fh$L-9UY7gPg~GVW
zbxmKRE8#*%?ID49TdAKa;0)DQPj$4T%V7C?!_&fw8_K)fI@hD9fJtD^JXfv#2%;`d
z8XKJc?=f6gn3SbAN3JBu4R2HPRa@_->`*XM;S*8Rf^oUkW34(Sh(6+uncw;%SaDkn
zH9C1PMlEDgF>=1HVBb&%qgtt1XE(f_e%qi*rD7o}WZ2H7o&fO((RmNEiyAJ?xc15i
zX|OHz<ok#u*#H(j^X!D9iIS8&cdn&EP=gX8UAQsfs(>bb5qYk~eLsKa1g&GB+u`lL
z*Kr~EqJ^cva;>piny=MSJH7ovDG(&$LU;Sa-+G01=Pq4ArRC&j-u&hqmpEC*i})G^
zWf*c9sJ00W^RPx%iQ?s%m$pl@3!92<A}m=StRpE;{e>v9*f|ffL8L3!-9i0wi8z)0
z4(x3C9U3O8W6?T{LOh`o!d}zrkZ)2K7bd|ApzS908$HO-0eqb1wnYXFQt=Uac@joc
ze_$;M;C<yDqAqDTjh{vX7IoLBu6Ra)eJ1Ff+>l?vK@upkVdJhITC+V@vJ{JI+lI}{
zC)689M}MvLV^i@RlJTY6ihTJCi&OdQRzQn&<wf2NHXyBWXq}NBlJ$s3{A~8Vq5W&)
z`+rc-fr+JvaIkE%0zp}dxLjS`X)MyIxf9Zokm(+Tl&>)n!F~1QyEwmPL>A@oJ`-2x
zWjz$?$*@P!j!X4zyfY3&%Q{a`Gr~gNzIBx!$H3<SS)}B?zB5h0Dx8USFMbk}&&Egg
zOA?DvAoWqI;jlSVgHhI#bi^qe8Hm3KE^>k{6syM7ZJZ@}a4L_1%%4^7o4JkBwseVk
zsxbsqK)=t}Gaztr6?5ZOi-C`J7{VjREqoOUHf;dy2h7v7T4jW0p<)vBiGt-xx=`Ve
zRG$<Jo&D;{MNIef>)V|^^lk6e^b^h6;%AVGco$O=?*Ea|smA7mR;<Rdsf0SWZs{?f
zz<LZ49*u$8KC7Z@9cXsx{i9MF-3~#V8YsRJsAXM5$`dZU&#A6y`Mu2rC20W9ja`*a
z8Klim2eZeW!aYaJ3#~jVcMzNN7;%P(xGp}H9A^gA&Ts;JX;0ZAXw2L*K#5r6=xXOb
zcOU22-hkkzQWQdt|5F;Y^@p|^OP5JOzzuYdh{{7#y7K;*)ZA@~<sw8pW{y*E<(Q!A
zFP`-`T@+}#@Tj-EsA2L=Yk$k^^F=-Ko~_fU@rzd&Ogh4&czmguCni9!iFKy0o;vCD
zpOsXwDdeC&!c(G0z62EPmlrqv{L}$RanND0`CK71<gF3Jy{gL>O|O$e5wEKZyexx@
z#K3Ag2^dEo^`?$07$~@b;`3k^+Q>Vxk#fpf1!Q#{({yn{;pMOOE3>sW>)hsBHnAb%
zDcKj<J&mJXFk6oqOwDRzxr0MaVWcnsW#1{@M&0BxI;`>$=}k|3dUE%Z7zNohYp%(u
zvf&RDt#fIQEJl}}103EkntxTm(O&EGThk?=Q5sK~%OF8*sJwGktfJq$z)j&&3Ky?~
zu85~R-z-aC0G5+3ReY0mv*Q;%H-BR0)Zlb*<5M~>YEge(fZp|#JC{kpFgp*%+n^A$
z69ocU_Nq!}gLQ)~FB3~p*9o(dj=qvl>Z@+|x)1-mj7VTCGsKa{^WD<eES7MY*}j|W
zoLd6KgGJP_aX>eYPV%bKRvHRoX>7hJ24M{Hx5RyFnb=eAkR-32i+V_&wn_z4VNa%M
z7T07$ki4GWGi3eC7U7IFP=O&kY5Jo}r}qFJlx7b~EMp{fkFy24mAIM68cx}WQPh#}
zkkO0o7dpc>tka2ze?v9t*mV~u#I@ljp{PSX9xZ_d&7rJ@&>jmiCQJ<}JoeGiH?T$G
zO)Nl%Ot_b4H-$iiubWO*tcm<<FVI%PH3+k>%mU@~BD;26+?sf(VK|A|!YG@Cla0`!
zf^;xGxZ~7pDjOy`EXO9lG?ni96o!#O%ZKo}|BOeydj-}*^i`1g$5|hJnkD9f%?t~u
zdA#Uq(vA)X-KA|I0|v~Z#Ye<pd}`3eu-eKi6!_PJA8k)C;-bH5)wDs$ePfe)PjdUc
zRs*9%N`CYNT}_y@Ib%F_!dL-L!E7?2^LpG;SXF<^>i+1U>=2hgg$gL8SQ#}$e>(^h
z4jd}lt{4o<jn}WmW5GS;DU0`#fDmmdkU9qUcVDlZGd{C9&!C~RcY<5X@h=-Nyccce
zfb|<!#{L({K;W`hT2&eO<A+?_pp4+yG-2^btv4KEy*jc71q!gJM5c<&&UUMRP%v8P
zP0%1U`{nUkUOc7|S)16sPO0sBqNy5uKSdL`hjeio95ZGfYGljERWF_|(U>wB(a?rf
zix0PprGyx}>QwjTrp5?x^gC*eNFIqni>`Oh=Ad5mOWPRQ#n3*MUp&;T0M`=UltKwx
zKIRSCPkl#ZCVI8ZlXXJrro?E!%kh+F<AHmgkUo<#u>mjrWxl0{nkS`AIG4KE*D$~9
z@l3hLrV3dgd!<R%8E3m6(0kb{Q-n}fu%E2v*{6o!iLTVBolpS@9lSK`QBC!zOaWCr
zqUg1|AUOo(2JhJ&B&w3zocxWyI`TU?v<;>tqlQ2Xs3yTaz^Sq3U|8zSNQF%z#I7im
zOCOqst0MT3qoGlni9wr(Ae=v7w0Qk_E%=1?ae%XB@E`$@Z51RA?KVdIbKAtfILT*u
zb`Nh7(Ml7EEa%)K5l4%a{8dt=bO<3s7G*#%AhD8P)^%;70SdkzSBrX&8nrum+2v)M
zL9m?1CYFU9MOU-#nH*yMHtItrF3u@sWD!Eh$a{2k<K+w$Vw07m1!^W?mMt>zMAyQo
z1nA@UY;ziWg~;krYXPrBmykj!HpY}vjH==)GYMm6C=Z8BUqc&IC~XO}4o)_wUN2k#
zdP5BOZ;BreO5tPVssw9zKZ1-j!NR8su@H;mX13H@=``tQq-bX5_Y)5;51(<@#Jp%y
zn4Zn;GIU+b`mEB&22K!}P6MaMob-3|;Hc;2jQsye69TR;)gBkNepfmYEZ)WXR3xV&
zNSd@zD;kb+YoHL%BTGlo%6dW~P(@1o4IUAmXa$kEGA`#o!HTO@1whCd0V8QwsBICq
zfWJHBTK8S%ucDbRCg&`>msoD6zt%&P*=DzG4Yc=bbIJeCqaDiYaX@;j2w6Ld-pNU}
z$j2EDmu*sE%qv-oKipa6(bJE#vi)}$o&#J2el@2w^by>n0r7HHreaL$VBXI1xba=Z
zG@7ciNw!Qjax28A;&A*Uz{UTZlwff{vbxv_zlhh}n*(fDPwMR}=E|*H2i5+=zR(<u
z&WcvrxC#Xmb=B#GgJD36I7gKLsN^wA2`tja)ld)<6vJav9qaBdyW+SsVK4P>%oUT@
z@s=*qWqs2+M!+_|Qz9SDRPfc;_QdyNS-Znn1s56CBrJ(*w%n!HTX;5}0z6jtJB{5z
zY*5%2ta1dEOd7z{mbl1f<P1LKSZ(7`>X2-}av6Tg*ao-A^A?w5Fje%hLVpDG2Ik+`
z;oc1E@;eZ$_435hQDkAkj@_seOIW_?a)0NW+NbWXJEZ(1TmopDGP{E>SXuLO^h^}l
zZ@H><ad#)RLS>~3(C=qDD1>ZZ;HDegmQm`B*sgYF+SzYXJ=ymhoD4VcB|6<X^^8LX
zPsV|E0AA;&^%j_9eaKRQ&0j~%8p9*!#A%ZU2Kg`&7C@!x`@pP_qyXfpd08ssKe661
ztGveaO$}PBRRP$toGL)P9esj>WvFGvfV@<b4(2uX@~%K4T{0aRUS+#~bkTaTPTloT
zR6ub@e}tkA=&hj`n)8d-JYUSAMH2z|U{3>&;oLwP(85NrMh>YiMyy&^&d~W)^dR|a
zGu5Z5(_mk=ENNelnI0(LZUL#tYPH(jmWzf?uKbOa+RP1s_V87JVl8^K9t8ShQIT)h
z0naXJ#vRiefp~CEXvDzJP0RgUmv2y&V;+2nt0|k->xlkx-dy8EBVEF->hv_L%MS!W
z9*cCdRY(^)3|VKEY{g|wmBJT>wN&4gsD_JWY<hE`xwwJ3*gjv`Jl+?`VfRvcwC}Gl
zM{Dny-_UN<-Df4QxqO&koof$>v=cZZ^d4p+x^>fu@F!{A5P|kZU3+ON;!n<;l2^g%
zM|=q%V(rfHsxA!|YZ=2#1U3T>)Ec!}zh%!OX<0ChhgMGWsPQ^gz2wwZgl<6SegVdQ
zp#hwRxqe%fhR9iRNR}&qsP}nbU?okZE;`Xx9r0D@M4W^q9a>mZ065?WBcH%G$wT@Z
zC>IVGbJyef3hZH@E|T#djMz@CdYZ7rjb$!r^qF`v4Smew1Jf4Nh{hNIWupYF{gg;2
z4){r7e%H^}=U?z<II0wfDIX?n0%li=TPgU5jF`N5#jm@T==UH{{Kky4-@ZBpP0i4C
zxfmH$Q&wImzmwwF<r2G2sJ?v`Jf>Zg7e1=pVeg77CNp2xgcAkQ-k_qwT)jgU85S<y
zIAH$vd@nZOmOHmAq}m0!{{unyw3y-7=O?WOUXY{~y2HlkCwsOOyk!o#Itha%Bd08N
z+0Y%E20Qt^Za3sP4&TB>+S+%PjcdnQjo&eBvFK<yrh2TK^^to8T43<tmgiA;f>m*3
zo1&(d{iE-x{odZ4-={!Z-3ee@Rn^2K$*py&2{42?3~@K1F*K7Irjm`V9m1$ST3Ez|
z#c^PyyA<5pIW1By!A#R`dO#On!i8VSi{aMKyEp{^u|Z}RkVv*piD`wb@)FuE>9FV*
zXVjgRSBlTLcnIZQTkvcdHhN;%)9LBzCnPwFI4@EqKxDGb96$G0h$N2|6YqRVMm(|I
z%K6N@PW5KGw@-t8qtOEqgTV1U)_)c&Yqn70_)r1JtJN<$5OBe0BADPHI)Vzrh>*0<
z8*7VPMKRcAX|7eRlRih-5%u)I({Zf%;bt}_Nx8QJjJ)9Xx=AYODum)4bao`cKKA1B
z=wmiT_jL+$&`o0?*QHwttOVY^Le&;<RWTp4H>TT&V5@rLH)iMABr;mQVjVcGjv4xV
z#tz6XxiPaG8znC$+g{VhLW?Pm^}n_$DF8LVES8)<!kM-Ijp1K*iDUzjr;endy^sy8
zx3fv)#}NPZlA<uZ(hpfS#xLajHh)<t<SyWgI&+MK4bZ_XeVCU2!<t7CY)V#nM5<;g
zRRP6(`~8Qi|Gzu9>(ZJXbj@vn{E+8_3k5D*2zn3Lp^hFE9=mS<kkAj;)jv#o)IJ_o
z-m)rl7mhmS^R`?iTa)MS=Y0b&6@QhrU^(m@Xh=M8I5(udsS;?2z?t?lX-8O4xvvP@
zPG|c_M4R<gunJQRm1FUhV;{|oJl7Z?j+*V+@DFjmuq*v$Xj2_kK{78Mv5aT^V90)a
z*XQ)!RoIg&pLTTMzcSvUNEgc0tnPzvcAy+Qd<`KtKxj#m>JcS-!KqE_BpRgy;IlX-
zpqM?(MkKiCR%nX~p_<X-vr_!IIQuRK<j~qEQE2YkQhV5SrFn|t)&@@H{XJ-O<YgUD
z)D*YOcP7q_rEb|tDr&1yBD|V|DcVutZ%-<Odg0xDfEkXy(h?O$T$A)S55o$}IP-|_
z$F$6y)EF;xTV?Kp(d^TD>PiS?r>m4pgs3UebjI9s%lhj*c8AyPl``D$yNx#Wv|X+^
z*KFxqb_+)v@6lSG+@k2f@qe<P7<x|P&kJJXU8X{BeRY7J)hXj;nJO|l^cN^{dO#QG
zRq%iyY2pU{&TBjbIOcI+L(SUel@R7fBduUEsXK`=V~bw|m5B$w*;!7d%m*^Nv|R|(
z0!!P3Z8wZ<RNWPZy#*he=VGcjSc3;a%E1}i0{AeBHMH2S#H(_M$$h-F>jhgm-a^#2
z1X<N>E(#=JTd<ALBDk$s1g3e8F~$;7*pTmfEixCY3x|1u3+bZ^BTZXs4-*;mc@bfT
zj^Kv4+atrw6zGb~Z9A*s-;mZx6HviTyWa`3pYmLOoTO7i_`~Y*TysiUY8&9v+W04i
z`Tu{^s6;||It$5%$OY#4!8$V`DdNongu^^@%cV)c7XookCrG3axGei^-)C|tU{;7Y
ziQ@*Tl9;6`i>x9W_ZVGAbidH6Q=6Syh$?0dKfWETir|n52IB2=m?m1Vd+zYn1yik-
z-Qwbge!CFQEk!1R_G!<ooH=(t3VEl%<aZUL@2l&RfPCNRfKLotwJzx*ddUmq^S*rC
z>yk-6jgU>l^Sh%J6KJ3HSz?y>wS`oHeOFw2*beT#mv|nN<laa9>}6lSH<L8%<X`Q>
z$6d0Q&%aE0)wh=sJj`b@MxPjXc*!cVABs5l&vS`VKOXMnr3{ECv4pT5$e{~_<Uf_J
zrSri?9j)&mHV@4O)@WR4dms#4Ob6%_0OAbPI~8x6@-%*T@5PoBL0gOu`X3eIEXriy
z655p(S}9XEgKGylhcPp%dN0&%AZ64wIJWW&2b;@^t<Xf*zmfKg)b&+%1u%ad{L;CQ
zN<yz!)AVqrdL(x_Z9$xBoNF~+dz#O)w*qkQ?S8giEV@?%G-s(ppA(Z6;9WlGL-Rd+
z689eN;-#UQr>?y#IG`zZMJOhP5<75DQlaXXuGO`aofsv87Q93oe-At$`)Py@1dwAL
z;#cVzVdKS%)%VTHQz)R72=Ln7aOS%{6IC+|OebzaJaLXb@L+QeJ)bNY{ASM~T_H0K
zec)$svz?}x4RBSi&i?cg;0}R}r-V{N3f9<oC@8N=K=wOZ4afG9>IT1KZpMhP9aZ5o
zxKz(Jjh@F5w1?RNI}u8QD)<~bI67nPxE9`I->zX%3E+aNM^<3HCFAe$q#|mxCJJht
z+1D0Go(Pk+adW6U;A5XQ%Ln+D*-QW5<N<#H&Cjxq^;#PbO2;qpF?u0r7wGY6MgIzM
zon>l*2To||;r0m@%d9O3YhZjv<zaHJ$-oV)`HgLknI9<LuSQ!u^Lj(&$t)K>^=<$`
z_X9IbR|Dc(>6oU?nbyM!4Od1srPd=mE;ybf&UfXUMn*Ugw`>{8<)`U*_wwHuYRHB_
zI3Vv|vK2Qa$mrOLT*g(&7`!L7iIEkkuwCX|yV89Hy;6wyfh^A2L8gD~@6O~rTw1C(
z#CaK{3|G(Wkm^J{R7=&v;Oo7|e2`c8_~i8AsLR%KgB~f??7LphQkCrkkQY~*B~rkz
z2(I%HeC+HZAxIhe0AhPs*aYEAK~XIoxM-)|K7D~t=znuq;|Eo#9SJhB4^yd6KTl+g
zuNoLv)evPu31Ulf*1Zn<Fjn+X7Y~}~{uanZ0^J>9?Y87%+j_RJc<rG!*X1-i|Fzj5
z`*K-PXnYLrAM4>BM|0^)ebFhX9q;xQKMH)qE7b?Ts;+5An*nQc$64O}ac@|4IyzFX
z8{KwOR};)s2YR0y`A}lJV_P2HE0X1#ai<k5WXjT*zGzxx?+!~txyWm`dKiJ*1jWml
zLzw%F&v3N9g(<~#^k|0ml&$`6Myjt*sQ#g%k80<6<G6wke?eq9RlK$EJHk;WvaR+O
z(FjxHeNQ=KdVRiDx1XRx)dz)xN_#F}!8YI_i(~;KKp~_cVT|Sm`r0}yzqHwPcCw4L
zIv=z+TVZI0W$N{_Q<ap^;qVy_kVHlJWRq9){lSikLC{!FW0`M4eY<P*D~JxWM;+df
z({5~8K6~cw)hFXOU!Gk|&F#LMf!iEDx%4x&d_`Y%xvpj=T917B%JwEf#8YV~Qo!M)
z*W1^E?cP3KT73eEpO>?HoZ5qlI2iBewteo0w`O}%5U7`y?vtb66TWBiK3(}D$jEY|
z+ks(#F-2N|t|x*ZKN88C<vyR_Zgs>&?=xf{xb)Z%XV|xaf)BPk-BDtVDphis9D$Hn
z8ftoMh8*y^xO<x7+G~OmlBc?rt>n><e3cG0#RRoI_ZzRS95X}-QEr*dIlo?86MH{j
z>1;+pc7;UI*0UbwV!0Aw`v2MX*EHj68Hazpn}e~N`CL7cx(osBtFkVV`AGU&DY+j2
z{-H884rO&TT=^@aE+0Fh#pYLL0Nx(wfYZA3#Fx~)GTSW7R8-=LTd}AEbc%=_m3k*%
zXD@8|h<koBR9)VDx5D{g$a}h(pn<TR+(i1i#NcGh&x6bXFxElqX1{~j==M}P+TpIs
z{dqw^0o4`y2W?FNe!?>q`?^HH%X?xmwBnAd6|R?&CY@?Mm$Lsh+a|d2YY9c|)f2)P
z5>Be$AHBPei`V_V?k)CgXtNBbtzmqNtFoyt(~F|ycDZl;D7AkAeRmcMy)SuK7;^Gz
zLEerza><#HsQ9Nc#NiFM1=`5Z>81#1D@vgj+U{cr3SvOSu7wEgU15h&6pT~VsW0_|
zyB~%iZ`4Hp4w)x1v}wp#Pq|$ux<?OeO-o-5>Ls;HK`WMKIFXyWeBM@i`6g%!X6>=S
zN;GZg2E6qhC+J3TUX&u!%WgNa!ALqhDG$~kwF=fFF#iX}{uXs(;wS`k_*CK;1N8iT
zJ2drcYUiQZ_0Lk5tffnr3KedqtH}knxmU8yYt^`(OZ!<~NqiFv<KG}@L=zvva!rVU
zmravm6%GC4!W&(?eX+GKHEO=YmPeaULaSE&%|&6N2QyxE-%C{?z&-6WE6|)4eup!v
z@_;CA2LtRp8EXjGWk>CKMiu+Lv)(1wL?__gMD2riPz9+<2(AMs$d-ajDbGNb^A3eu
zzCgy%%0)^VJ?|b-45goE=dlnq>)mK3D}&J0#E<OfvCoVE%cJry*+LD+N2*+`-o57+
z%=BbS8Bmh*oU+)JZ~kadvNwqQ$klWCPi2WLHBObjv*6UK!(`r=PV(<7iYJX_sN{b9
zn!^~-?ldaBoL<LeBx<|o0DqEO<_LfqheJ@_?;3T53^b|REH-X)dC$5K5Tbg<W1i`7
z(F)jpUYt7~nG<a;z&r7!DJN(hy2WVJ(WzPY6E-r07vfR}?!H$Qs|XIuqLd=G*x|Q(
z+1~lFCqJvzRDjsWmyhqD*Sx;d1bdEI69YjUxwBukcV}*N@Yb6Cc^@cdoGiKKT2YfJ
z_YkGTLq$KI{IK9QNMl~yT+4|L<G9D)3Edwn?A)lzm&kN>v7cOztPIyAEzt4QPe?-}
zTg(;lHHp#L9vhMZ&jEZ~6dxEuUX-x_t8tFx(rM6tSK!L<U8$6JFfSAL0jE?Pv&SqL
z5hN1W?sN(FxvV<v`WI>T8AILO&%@;?JFr`6`8^scJx7XgcfT~1{vuF)qgW#TfvWwM
zoGR@Wpi>7^vjtpsJ=DTl&8(IpELDD_Bqb%aqwfbr<0Eazcmy8v6lQkMjOW5-Ia>o%
zBw*VnlI|qf6Xyvd`T-~`T+d)KXoNLoOx2dF4q3{v`H0SQz=ymlVn~O+1xr9qZfcb#
z0k#CxE%Oh`S|OXdud_)h$`1!OB9+rEwgyJP+>cS09Eq3Hd!RLbA4jc!4{0Ao6%I?<
zgH5~%{~+K5E?`Q7z@VR!-qzMKclOsVn%C!oN#>(1YYQl#+ET>7e)hmOs;qEBvEr6K
z2Y!t&*pT<PnpN2;ztvw!0?jFN72ZwrAnH%!b+84WldSq=S}WUeFe?ul(0e0y6H;bD
zf`m1}IErn72!VgarUfMTC*BgOaX3Z8oKLpMRm0(c4<EGSHZF#oVZl<=rPuwf5fk#>
zDiq)oh@aO!PNq)8ja1uH;n!*ui00uuMd|D`aa`sy2Fb00O8TCYqJMa&RW6e>v-T__
z-edrf881&Yo7#l2!P5ntbZ)IzSGjq|C-LF-fO9Z7Ml9rG@!U@BCoIj=_FE~BrRA2N
zYovpqhJ8kuj(8~zhaO`tgq|b*O60RCV~Gm_i3(GK8fQ0h3YhJ{c7)snAiJ)b3vN8`
zbXW=`Q`CB}ra?VY&R!vk_x1x*UNgFjgbHN{k`l4QA-mnL2Z~nyD<V#R;a`(EHtNtU
zqv#lHTxA*~><{ydxg{qp7_qC9m0Knzd%tHhZ<<g8LC^nMPhM}66IKZ&51|c(-)~nt
z;e;487s>;Fgb}^6n`1O@U8t&<WnH)B=ffx*M=?4FeWY^%zS@K8Ac%>=RQYX4NhRXU
z%kOBb2I-6li`m2w%L{?pT}&U+lONYTDdGOCag;jBE?!?EbfGSD@b4rf<+krhX%ok;
z)d8Y621P8Vv`uU*@R+S8FC*TR2G*?It3F+-q=Cbqpi-mfjx#&Rj*NQmxnhYwx5tj$
zZ(FUa5`f3a2FeURz)ShMr?DTZSD)OAz6tIA1fD*W;%SRR$q<$HmeP<p861CrA+nG+
znf$SOGD&4b-^hB66cZzPe+3?O673&0Tr^DiX#RbDk$Za<%+rw-g18Um{yP7$=rp;d
z@eEJSKlV5R41(z6YH^3W6P0ZFNG_%w<31;dxZoa#ej|fIc6|UbI89I-Q(_!(JF=jv
z1`RV^)<W@dDM>;ppqMsh?U+fA;xn%oQN%!ZMd+Eac`4cM2kw_C23cXf-0njW7Gr=V
z=kGH*;X{tYM+Rh26uPd+z*>roE9=T3fIwjYNOa5gnDRwc7gmM9L+iedzOYJ>+60W}
zma5A2gF*`tA-1nhRs?VSEJuoY9=N>pH)gx}sV-KYd@fa4R!@;3Z)Lx6u}639nB<5H
zrNw7X+%le-wS(da=77b(!&d_&4AiJZq0}%K%@=X^{lpyE%>kxGs4Chi+*7M&z^m6T
z#i$)khmRAare|cACJ)sn7z5&_c!MiP@ID4f_`OLc!%lVRb`VQ<mwbVu@4@Vahqz&C
zThQ~TkC1egvnjNu(D1Zr4a*Mc-?HW5BvH18FgP*IS4O537JXM=CRuccycd29Hiz1~
z_<_~!iU%a;unE#9EmW|0yWo7{3E$S#18uJy0Yqz35hZMktMQv+7Y`GMr_p}VXm%IB
zc}p!efnL!%Uw;W^neG#6s=0+YojZqvbY;i@vDzvzz;hph+V_<^3uKV(-mW2V%_z<V
z?);ZJ*ensD?^cZq&rTi>+JFPJLNw{Cq5Ari^?l>C4E0=rmOXJ44S$-PJv!8g>#Ref
z&ox;bF+nGZ&I)XO$btGG(ub2}pM%^#dz3chrD&y(OsxdpYXx~>#O~;1WXu=WBW>KH
zM(?W7!lRhe_KoM+f9D3Dj%{>TMOyDXMLR3PaUg-@aHIDe)+F;kMsLW7#IBSTKCctx
zEZ?2-)19;g`8uAlJF^w>xD~qXo?rf$B}v|r&DOv%Xahz5B^*Z~WqCSvM_Z{*{CVbW
zX!6%nXOj0b@;ATkDeu;|*zsb2TF9UAbkn!juLbxQVpEl|-b_0X&Bia;C}c1`VAK?H
zkA@mT#}q@V$q$GXLK^(3di9`Lb1YSk`F3IG^>nk!ugI>da3^CBATw1d*Hkn%-kcDw
zB;y#7GDeLb$||29UXg_9w3cz`ve@Q;g4{^qk;;-;o3<RG76Q{}JKPCs0{R`g#!>na
zj_wP31A2oPeH=+%gP5djRM<P9Im9la{S0g$F8+jYGRTMJxQ{RKMo>I8ge2LYMzirw
zA-i8+Se4GasFH0;-4T39a8RmOsO?`c*ss@?NuX4OfTC0*1G7pOCD}abyVcYL9iO^G
z*D$}pCCXhzaoW_YJ@ydOin2y@BOtIjSc_xcXXN3EHht}x&vHIbyIxoA<Eq9^2~GLj
zW@XfIE`*gtwYl+f*qYNoATk0$YnMCNW;Sv@++S}cqj;xFz&O?ThKEg~VJx>ALK|Ij
zYXF=_r?$O`frOyrg`ahND{lPHs~uT0y!Tbo-ucjS5RVD(YDQSpZ+RM_i#%u5C#c4i
z<b?0L`GZ(Zf#l8{Ayv?PZVsqJYZ5PrNAM?2=K(PzI2FijOfu(srATgnlZBc>NQ@{A
zn+B>a4#M}&ergnq`Gq8Hd@HS@;e0Z-;n_W-;qrYLsq0}i)<H}{6!`SNhxY{GuoN6(
zcv%ix!m(7_2Q7c$EPGaOl=n^{tzfT_>*EH-C!csFRF0{H8N6FJ+QLs?a7f?lOyD;e
z$^~sXl#tjGT&v4<X)BwP>1?J@TDnCOaCfj9FM7-&c~&mq7&}Zsq2t9`XjKqTNA+y+
z;+i#6X>j8MQ%f33%dOB4wmAGP@6r$(!bAL46{?&Hwev3bP;iK2w;P2O<NpI#+Ot7K
zSNy--iYYlXoMkw}#g14v)v;AZZ-&SF_Jek5IaxQeai>Ara0c{b#gS8L=$orTC5K#9
z4@6Q}_=R*w0-r3OVgq<O!O>6$^7V~XSqD?Bt0p_gn|b0XHAIJ6_^%BF($&c%uuewk
z*-D%Ot*#$jh1`0XdqSH^%ti&%9r7C5gjH?tn_4x}8!kBjS=|n7C@FNeFW1@8z<f3O
zC2HX%W(BTE@1!;A#@Vrm^6ib|-YhH-<Xep~=7=_u%c!~YHoQXYNwL_~cp9Vrg3+BF
zU$%1v_(B<}BWiv-ZfrPZ>u@Q!AN<M`u7%?z%g~Q2DCUarG9^d%jhkAp!bDgE<*t%t
zh7rJwkydcZ6ziK44DX!>U*A_Qa7Eo4dICV(c<<)(7M*kQ;-`b2`q-wT_gPgubR;+%
zmre@!dy3$?zLl%Uj#xmwPw^0WgdKp<TCZ<&dIP&;BcIA1*L=vJQyb)!t%b}sPKS9$
z>sLHML$GKnH{&ZibiRb?Y?xmoy#o46EamqIN;~6YEK%2-u!jKo0V*tOf!lX*w7Z}#
z^MF@)b=tN^RX<}?sobSS|GvmmntskkH5FgurATA;1Rdw@ARV;YkO@9W;RLfzcY&&k
z#}X~-EbbXZ9&qDS>uRW+d#lO~eOFQt2kiLwi_RBky!^?lT<nx+;W!?taT-H>s((c6
z+gx-9j&@-)tW`PvZH{TIXyKKd_s`3`jz=bmb&GClc`QT&W}><igcc&ZCFxt%@uRP9
z$A;DcK?)V!+Sabhbfcer@7rc+Hbx-0s$k_dG9?JOl^V1CGzED4qo`;2f#SK5tX1UM
z)%EuwTj8zQ3&j!M?mNy;1hg3tKOCrZ*q6L9vz2+y4AVBIb4ixPvOfE-y?e;S?E}ug
zFnHu~b%&dB`axwOIN3np-1ty<;1AVIrceTdWE^5ReDPf{d*3JNUc7x!zi)`E-vHtI
zGX!bDkI!}NiCFo67-RSmG>EZcv&$w`WDp+NbeZiJStNubGv-dUP^u5hwf4Mw{BpVR
zQbu9i+3=)P=i}kBPy}6fGLLrr@^~JA^?x>uIVx|rz&%$hs_!uqvjzIhJ(52H#-<p|
z2_#Wy<IflJCSiEfepD_rj5~Dn+n&1Ng$ul3y7QV@V$|8Y?%0KXT!AH{_=(H26$kqh
zdmcV3$&52Sos9#;&TMOM6ke_o;KDK^5k#0J3_zoKH2MLuq3YPF3_6CE!>6ir?uZWn
zU~Se8xopi{PVhnTR!JY-9?Fz~9}TdCImaG8*avN+Mi=dO-#(ePuWHecmOLR$d}|EE
zTJ*xmR>WbR$74_%fX`j8s7ChtS`9u7E>G!<baLo?+Cu)U{mS-=0u5Ki#R^>KMl4Rj
z(0kE^B9qIyy&(-0!$SfC%ezf2#V@jlC$ImSt}31qLQoR>`bu6kQV3{*t8c$zCqR&9
zcR}NJF8+4#bJ7exQ0gyA3OWH9)c*cM5;~v0D;thR*l}ugJ3pf@b9?%o<uKy4fu`Ln
z>?1sG2zk*=LV3^YG*A)y*&x^Zswk4JJe?~S9P)*r9er|vt?f#JUy)`HmhP7U02f;K
zbmjr|d;7Z7)wuQ5)L;}N#A#7yAMPceJHl`9NA2hK+<(XA5ylv|qml0v%It;fqYX7o
zHhyO?GQ8H1A>HraE`vfhTV=v~$eg!;f>}$;VH1hE-T23GPyBZ4FY?gs^=UPwtqU;n
zcebiLpv#YUkIJ3C9LH_ZNX!hmMk0WrV|wf0*xqF!tagV6_mBSyCHlsVvY<rZ_AWy-
zQZ#oBJOxfhz7r9HxJeve%mk_@Z^<lqhVNz(!<a->auNFofs=$I`PTaJh`>x6gDt40
z3(}0XT>k?mopZ<~))`d3s7-WSl`OeOj7CYUDOZ<}o5-;}P`ctsM&;TLNZ>EfN{tjw
zHm0q5cklw!+Fr4zVM&rOV4Vc|Se9`IV#DsrksE51JrARX+e2N6q3)UMN^NdazG;T!
zir-C%tOq#{cu(G?xerU+W%Sm0n}IaLVKw*#tRMLe8l!X2tiLn?=<KMtnGbHFA&gXt
z-$xxd0LCwu{EiiH{l4*-A+2WkKzU&ou%0f2Ml3l{CYAOT?U!+vO3=djUrdLS`{?a<
z{xI1~fUX-pbSJTa5Q?k)U)Sm>YO-oQcr2Aqs$@@QqLVF1atRX3L9>?<C3}Y;gA@zv
zxs!e~cU06g89<mbc!^TWPsT=%|5X0TnWBa~u6y7uKi3Wx?b)jJY_{mw3CNDzUGHi+
zbJ!9cf~@P@7yj~Ms1CPr)`Vt^EGeP0+x{+0aqN81Z5P^n6b2`z^~L7BI(6En_2RIf
zWc#K(?0r26>s~~nT(trf90DJ`xYtv4AnH9eFm14kC8*NfxblrT0!EuyxBu#IfZvqs
z8)RWR-r*_pBfMF|Ld`GdLY`3_oUK@B()B(6gz)3i@8EXDG%G8lSPOxsXu=)T;R|Pe
zW9b$rtwWqZYK7k97yAzraS1>%$#UXY&ibT)!XR=<^(x~L6NuzTfgv5zwto=w+k<79
zTrCJzC}p38I)`5sm8Z(!6Tw6us4xwxMoYS$*%l;QH^4tL+q&^*LzdZG+g4Z#;`clS
zuIK8;I>|P`FlqTLO8x~(2aZX{=<}>lArxzXTs_8*_9V=iFlbh_@%=#^tq4!7gz5hX
z6nMJ3czPZco0<ln8xH-#d4kLRE~V*$Fq-s10e*m2dudU|pgIo8R-4>PyveGLg{=p8
zO2sx~cVi<_C_ZY>XQ6ff>;$yABC~yMmH{ODgC8-95Zo1AL@2nx3>2vUJ7ake8hC0{
zG(E)#01fTh{2V(zg@G5$Ns6AI;+!5Rb`xjT3(-X}8l>0NoqgbG%89x}j(9ea@<)~C
zc!+I74prc^n*%b9TMkM#!_=@ByNmSnyPC#m7)M$jwKyhP0)4k$$`E|<$8^NFZ${R_
zU0(DOhWyUWa+yDwUxC-`Cg9k4sh~FIyb>0_C^z&~S=m{KinSpg95cAqHU4Xx2plBs
zlL^PB?FXpnTg|qz#r#(9ZN)a6M|`oJpDJj_-1~8$4Bn8|g%C-&ZCPia`^5gLc1y!f
zvgZS$nH(a4c6c~;*N8U5nr|VNS-~RJ>KddLL@7ldrRV-D-Rv})?ye&bax_->ngYBd
z<cX9=LP3WO7qSXa=JG(N5jkkuy@BxDe~qEX7AJ!2hLY0p?oD7cf1m7`@#y3u(le#;
z7z9g)<UAOY4q>vO!mo>B29_L7OWa{+aG~dLm8^k<yhLo$KB~OX4X$~IP!*+?HZ3aN
z;Vj)<Fem^$K*GP|Ux)jgIoTbDb~;>?0i>fE;D6Kylj-@*RrsED5^Uc`ecC-C^zu>3
zj)RfuSU|Uv!0X@`I?q8mWwpCB7eLNxPaYHD{dGmjJZp`?$R0Sa1xg18y@G+4=y|L{
z<vw=anDfZ|8|W{Nqlz!p4r>1;&Lu&nLp>`|B}3H%2a7y&n(A$$hy5OTyN0pu_hhv!
zBrq|qFPnVza03#(1md4iW2$E}yb-N?m8V`pGn<M*nfUfuyp!MWzwkW80_DzpHalP#
zu2!)vD3Eqx=4QN|@FVg(_GdnKXzpxt#X4Esj@dV?*M{W*hxQ!@=Dapq{vmR6g9f2J
z{_}~QZw-Z$H)IQ*0xB#oyz>da|LTz<WzHQ@>uCV<V&u?cFNehSlw6V!+#WdXt^kzW
zg3DfL06Zs@iS-RpKrgy`_ePZcOqpaqsjye>S!`7t&}Ob$_v8r7b8LF&r0AMt2gUd8
zEmaSLqJ$Vx*Df;WRO4>{;ft$^2BN~e&876QJ_6TB0KO1ox^8*6YqJWhjtLOsOjnJ^
zmNG|27#Mh}y&01pgIWnf&&C<kZvjp8AEnP(X(mIM^?Q5g$TgQ##s6$-v3Mi@hyde(
z)-4qe#6|ti8>wlKXuB4m-fzaAfynMIEyZ{Tc*BzqK!&G-k;Sde^K9!VQJWOjq~w%+
z3{EIZ0rMc57y%P+R^D~p6xrh1Peg~|FeD5JZPMqCH^2s()55BAw9N0PJy&6EnyYK-
z<VPeiPtSARUmtDqt`Qt>1tyT2opn>H(o~Cw*;T$1$#~@25P$|hP6<1o^{SQAxBzLO
zE&%{>aKGg=^q^zBEtq;X@P3r+<@3cAOAps~w7j}LkF|#ullse()eLDIs3dvs-1YXP
z(mTAmyrJ%e4*Vg{vVx#v_fops3(-$BMhMnc*S!u{T1O`D;@}%B$YL3!!7PFQ%SE-~
z74-Hk(xeH~n9dydSUm59UfS%Fp>fZS8@6)*c`cz+sHpv?7Q8Z@h;I~&)eCw=ZS~P-
zmKN*djoi~k$gF4D!clI&gPj%?>oBJFbrG5e^d=GA62ke=4c?;%@VD!GOC{lCc^uN5
zrUUp7_<-1(81Q%nY&0OTXGIAjA+V0*mI4k?X|!drSU0Ji={INLLy+GMENdfw?|RCt
zIH72%Og+zofIie&B0SEOgWN(d-eZI|M@Y2vVP1?53kCxAGtUQN$_Y&KPQZwPo8C-H
z_UB08*R(3Ah|nb25ZLH6tRj)U!i1>_b~pwKqREDZ%(kw>M4ZromgNZ`z2!6{PwtpK
zWsxA?;I?J+615@DRkcLSvGN#jG{}iWFNlOOgAhNiEKGZB+MCx9NEIkQj=p;ce5{&f
zQ0uj0F|>2mN%?w!z&kQcRRh1y@aV#(!Hibcs6eMZ7O;^y()N`73B0WgUj*cR?8w}>
zJYwm;V@0&$zz|JlOE4YP#bY|<WuJl7dDTCUs@`jqPGL#*06*y7@;`YqCzB@sSYGk>
z0HaRGPACM5iV|$Q8?8+#yg6@Avb#8&u$!`w%eLYsDZ0?a?#e~y^u~=V)x9O+Slrh+
zq)LKOMelRD`VDw1(v&_d6ZCk5=B%9_gY0jYy&-T^^ZK(zV<+Fvac7Cxt<YnRKm&c6
zcsEFQJB-FBRnr@;xEd4U&5PuCd@l~c56YQmEda_Fi!|W)gF;_rEk)$9alxfW*XK-a
z!(SxonEb<M1{W%C#6FoPW@;YYpRQY3!?7H5tBy9DmVX~+Yn(7kG(dHPN#m~zfTmNC
zwuz*Zk^MCkQij?2#QRg~s-fRqS}};0Y4cvw)h)AQC7eS14m6AFBuUVXav;DaUM>6o
zxb@4O^;m1`RSCR!jU(KLGZY>Zrci90-FJgUNMXdZQI^dmuHWXQE9k43>Cp#nUl3)_
zHyb%e1h#D=f;Oh{S+|QVh6XqV0gzz=R9jl28I`SQ;z*HGyIymH^}l&OPG<h~As%Qn
z$eN-reqRxHnfARA>zZp?>U<LV4)J+}VL}B*=6uTjY=ZsuT%It;)2q@9d?zj|EJ)m_
zp{ZDTgoMxB=kc0;evM&!;#*!IWT^K+;2lMr#R!*1prH%lxy`?Yriw)`Ln=8>S9;-o
z9YocB$IX=5mA_`mmI1W6Y${UKnniDmpUhoZB;^<@QBpO$W<ewzx4}zG!MVch!t^S9
zeGi5t@~4Z8B<7CJDJL7!bO%HRQzxipt1tBg#s684dBdO>z@d2|SYS&?Wd4%ZCUU8n
z6#8V6jGEd&WBz4T+^D<Ici47yo>zgIf;#ttvZ-W<kM|n_0`(70DmA9Zcakh`J;)qa
z@{skhIiJD|%(KoM<t>7nzo<I#XmR4mT6}!Ea3<BR0O9*l+t7ZjF(qQ-Yu51ax=Ugd
z_12_Rximu&>yLAH?()rz!UAl43c2lv6<ZycZ*m)P8z0K-j2pkP1AlUl9Wwe^(lag@
z08yclS7Ad`K<Y^)HPwoavR8S(5Vzmp;xQwI#zvac5!Xt&HKmZzJW8@GaLpa#5%T^h
z3+Kcuo&1W@M>jl%+MQL?$5f5cF;g>+JR(jKQT}1OgZ$)2^`mm|t_lTc&=5Ymqv?P<
zVGmwEV9<t^fl<x5UJbF%bm2<xWPNihm%1DiBa&3SvnZGKc1x|M2M%?Omi%dv4sFP_
zHHDYJSLjC@ENGd|MdvJ=U%ae?@Bi8MjdYA#qZ&Jbd)i$|_~M{e72yj5?ve|wkS6X-
zoA`NXPj}3_{yp-OD#L=e(t&v5ojNe@SFU$&aoy|xa7>fLP_FO1m0WeLI~8ee{Cpf2
zWHQ5DLCF*Mq>AQ+_hMs2xhgrZFE6po6T!Jgqy}tK2vg^g;e$nhXZi*%nVgUAk^2p0
z2BfC3RW)g%5LZxa<HXKB9ve`*N@J6R8j0GO^R;T=>hfk|3a;lD=H?umfL$CsK@*j?
znhBX^5`^IIQ%#uUa?5aLj~FD;^{L0^7U9+oqF4il>}&qf2SO>uv!cO2+Gej-!%29_
zq_5`PLZlKYl+l?8Rxe+o8<Af|f~guP?~kDn7Aq%mSdCLHP9zE*Ly}J5rw35b#}{Cq
zjf~eL2r+2MgDoXS>Y3L;j}usKnI<t)q?Zxssc3Cat3l&B7`G6PJ=o%lqYL5;NJj|s
zDuemPL(qqBBBoU|5|?MX)7eZ4rv5A#oNKeo?-M{`{A-f_SPZeI3|O|}HaIzDF$5cm
zE7!lOv`lmdjd`NSE9{W+GWJ?6(>e#JK4}qE$V-D)>@>7}8HXfd8oJ(_{G2Q@c|I6-
z3@%Ld>JAM7`FYH?xga%;;9Y{tLrY2z=8WZewkE(N>mUfKJQtb1eP83joOF10!y>60
zU$!3a2igwTa0#S$?rtcA(DWQt9LmN<oUb8%dbs<&55&1%j)@JaQ;h4|@Du9QcWc<`
zyR!aVBmM`%t@OGC;=bLetkuItUp=&3;S=)(SUi6a*|2RB9sYMwg+WWB4*N$XNs8mY
zys$A5^5@{s3#R-lhCux}9=@t>if}~3;-^dZc+_KYz|16iqg`1iPa{sk$5)i1$vUT=
zeXuqnf$YJxNyef&1jdvTy?7(lPhszs-mLw4h~?;vHpe%&fh2Th4)hVg%PDt}WZ5j)
zzRy8t({R4;=xuAYslO9%<4zf&ogbFvoh2BmKLX*GO3ijx0*j|<iky*drTbzn|B=^+
zecx&Hxtv>XuY|w#IuKm~YlJVjSoqyP8208xWh^HeV3C%$D{ys20!!-=W`e>>id-lA
z#$_}!tolHEC7vK87}5CzKD&3S&}z>kkWP@OA+Qpk7d6KANHPpZSkdkveO%Y4vqYYT
zR1=h`?TE$rLRDR{<vaAbMaa9G5y3z5MgixG+@GXd!zGrZbLoR{cUm}YfM?3N7c4Nm
zzO4s<fL+M7(SXkoA&U#G2j>&V=fIBs+|1g7$9t<!KIl-^=!YOHO50i_Ujq5_9W+>7
zTCp|8ai!)8B}9D5P5=+@u$cQ~1Pw&^TRZN2a6t5Y+126*wPb*lMJS8xw_5fY>InWW
zv^4WIvk7IWETy05&y#N_qI4lcl*TefkmtL+BetE%38lyrZVjNff`K7OjI$z&O{_J+
zgte_@wxA3cSW*14;<xHE?we5RgrsYix&XZ_SYe&yLflTIxKc5n7EIcVRA!N*D5LVk
z-5k64AIEd*^x1a;@^{CAlx3}SarH9>nPUS6+%izV{;DN9KhTTxlG4|ES?Vq}v1QY^
zbkbi37*y@ZVb6o&-y`Cgr5i!-;f8gyCR}x8HzktK!RL!B;`%i1+*7wkwJuh-d4poU
z_@)9sT?IAVjmiNZ+{$eZOmh<MI6Z?)-3pL_P&tZE5P&R*G-a0oE8oOpNPO~((HIDH
z3%$;|od1<d8rO{*>cT(&2`<=u7myP<SV%H<IcvT*f;QLstd#sS;=Dlj6wcy@tPV@B
z@&yR@tFP=ANd82r>BmoC=qPd$v`3=#DPN|KNNRUamfO$rwMac%$JG?!pby9m<^+hc
z05Ed-he?b5J*ys~Ab(a1K>UmTo&?T<+e(iwAP;>WwO{9#14PWx?07dYX0%ok1uh1g
zFzLkee#^48M#`8HkZ$?%B{b8n2z&q1$ao0`puko3x(tL$;&J8Mjoe!~aR278;qhCn
z*ETkjFL_Ja!5Um|etws{Reu;4T4G<X+20bGpZE8{taNV|mc|4%>-<veZxc13na9|)
zhSHb3_eOopZ|vksJAoNCioj#k+PvKvl%@j(Fl^`;QdR8k##0AEsY7XMFBCR(#kLeh
z{TeD84W0VpO90PQ-nUioS`LfzGM2m@<wey&FRzT)Y+?{oK)x@q%{pn6o5lX8NwvL?
z_VmhnMd~h}Su#OMc)V4w8i|m}AP=*y__-W)282zY+5Y`<12z)b?*k6nJhNrVIHB|j
zYzNTPmpqJ{VPpo3H{;7mcF|?^x)>R`4+9pnC(s;Ms^J#1MFxL(%wv93^ocM^35WA0
zEp7YkV~T5gvUS0237Eq9#<^GfliJ2JMBwUr!65Jf01s#9>avKLaw1Mjkw2K_*4f86
zIJLAMQ>QdhY+@C~^vYXh01~+oTi^}+$yl~Legr^R0h3k|LFPOiVFrr&&V8b840QB9
zQ$-xXkxU)JIl9+P>X5ltD#Enq8|Ze&$!=##_j9WM`uClN4;j?le8%`7`CIn1+23jc
z)xYW@%`PZNS8xmS0>uXXwpHu3hPXK-!rR1mCRy;PHP*xP%-Mz$qU0;-nx04UabbCc
z<FC;NF^K-{=)OH9rt3$t(o>NY20JUqk*6?uo))r*tu{Md#6mi(0#6)cOm4IUEL*K%
zGO(xB?4;r6t)dc+6nq|SZ?u6z+(RDLnQQycH=1Yk{FIC-S{4TH*tM~;mhAd{19&vN
z;S}`?+KOdyKeWI7<Nyq6Dg7=Yw>zHUtkYnj&xW2u&}m^|5R6|xPO_8`-sh<m-(H5E
zqGU1iesr|7wl{*IWJ)o}e5FgkVJ`BAJ!%Yc>19$pn}H|2MX>;%Ii<vlI7$Y4J!VSZ
zy|fvw9rmzd^4T~{W%FG9Gzj~iGSx@Yg%umL5AxF7gmZHaTtq>qE{|A;_M4pHIoaZR
z@I(zQboBNJH8a}g2xLC22biF|NK{G|Aob;i&>v5g7(~?%5FpN4j<abZR!_}|sM=qU
zLgQ=0-dtgnAJcR1UUhq1{#HaD`d3esM?l#cq7O1BQiLtnc5UAoz^$rlNziC39nAOw
z#3clR!Wt(QF#BK<FNH$P6p30;koFH_5Qjg7feVq{6!eSq?<bk^gCcghJ=FsLc;|FO
zZypkWec}zJ;@~?=889op0EAM7chfo%%oSqrXoji$(jbqOpPr4N6^Xg34u_cf4p3p|
z(hYV_i*z4=&wK2RYn0n61jT=03G7Tazxc0Fp`>n%gfjf{w9wCKiSy$>7m^v&1gA+W
z5dLF~6$A|!f>PSWn;G&}Jg+BT@Z0cI=Qj28%rOjh-(ZCi!<@Bi^8&62@N?|*gt^mQ
z8P^;hE98+0jBvjdc0^eEX_~VAi=@igIju_8X69Za^(3$ktU8Pd7^b1J8~rQNku`YI
zpQPwNGmk=>PM*AH?r|nW9Vr*1@w20Q2eI6j8z-2r8<U4PNCBuqEmu<^vq30=Sv|<3
z53DgOJN$ZEpTUt891RufsQW?EymKl=uI9{AexV~88%U=U6jLbZsK}(KmO(DK9~zRG
zQ@O4+>r#ydKhE<96I3e{wWa*C`9C-8NDqA_@pxCBW;YZvi!`Xzq`5E&jn0?({9?@y
zV#q(7<?vINb8pxg*b^>o-q>GGDzm3<Nt_th_mOC)4ZmLAATb94ajiPP2gLFB`9z#P
z^PqI;5|D1nEIYnOGQ7<NEB^Q{p6nfB1<j;El=_uRLa}vONo%dSje*scDE9hF`DoUP
z^V#-!1d%3i?|uLkvV4`U0AGH-@98^5q@m5s)JDW3F_;*`5YmLb?h%1$cEjo?I+7_?
zs&vO2MaML%S5vBF>}iOkX7B?6aDc4+Ap>m(EZTow-TIxU;z(uNzeDNu<U;v6=YWz@
zYUgU!l;KSjE_JMu@o~S{0*C!)4tu#Lj(Ls?AJqG!k^);6D9PYH4*oNOi=ZrCf08s8
z<u>HMp+W%y?PVYMj-VTc0c>{~cObfzbpJ8b<Ic*KKblSO_TkXULX5Q=yZ)@L$j9=S
zp5Abnt*{+0;?f(EW=PT#ys|kXG7_d7V68rosw9s$@JPiC!6Oe$xv(__n0_fL>8&)o
zvqIJ>s34hJDPoc(UzEZdj8$xlYXs*QX#vY86D(Ugb92hjKptxT4k|Ek>@J)u4dYJ<
zY)`wHyM&{#D`cY)0V~r;p(_03(%VAfEvI%YhWIxZGpHl?)RV3boDvAx>Jc4!-|J*c
z5aE?ofMU4x3xUv{(5QN1<<00>=hu76Ob~#;i~eR<U{f&BIM@JSvvIopsd1z0T}HUE
zKQZsw(mHNSo=PcdxS;I;AU?R?)S9^AzO$`>2ZcahtX!v!Lo&ahMfA+XV}l%0?!*%2
zX$4|lO$p1E>O2iYK>o{}UfzQm*5|NT3uWh}u$^c>hHhUc%n1LOy4$Xf2W)gJK$z5L
zjZ?f1vMG|pT1M(}dR0pD{b;UQuycxhYK!;%HLgtqpNsZsHurG@P^6pcv9GSBppsBW
zOD=M$2aeY2IT?GKrN|yC8c{r|;3LNdeO=nO@q(+Y6>=~~!+HnZin7O}DkMMQga|}R
z<W=YI2%Giy0w3cvc9c&Xjcd3ee`(dnII@JWj|g*V+mU*Vz;K{x8jNuu_{hr|$W&&f
zlMhncNP`yKj~8NKTxN08<HXU1dlbqL(_<zIaXs{gLWQkJRTW-v8$NyO!`=Aps}@oB
zJw|0g8^&w0S>RLP&Bn)61=8gXijwPEW`JNiAom&qOtf~rYl4I2aXo1KBrtT9h!-#U
z-RC`#u~Xv=yRV|jB3X6Vc3$7N(;-uQI|&7mUzm;wroF;PbDQ6opxMWA=~kRSINxSd
zdn#As5IX$x_24fh5?Dt1f=t|u(#^K!<-6`<%X*!p<hDgy9i)h`w-}cZW`sA91AA%5
ziBGvnYwkVIBW!cFeg7VWYKzS1k>fm&XH_;6xJSN&C7@Eg8ibD&(+%x^1i7x}XUsmH
z^Zx?__M&41b7!Te^aRR!pefl>Sc!3{!I&uzfjsE6cR|1vPPLIWTLoAat>^#v`?^z7
z{Yj4$>24sX;2(2xE#SH<g=5(shT^0lLNE_%_ty)Kq#|~gi2}M^6<EhrjfoGWmDqil
z4}lqkNMaBRt57K=bN1w*J_&R7A~`$v%RO#{PRO@3?FWf-D(0u{qXLns*{mwd@5G%;
zcmq+(Qx7c4KTrgmc6ucURej!}m9}asEf5u0?jF8cC<nnsT2{3m=UWUn3D&y|hwzwW
zubIKyIOw=iqX%bO^(bKI2CsvD@aR(yehUI~>F^Fa9TxfZI%OmD-ZP|w+k>jvA|9a=
zin`RvV$=$3h6k^J{49Gp2rEYpvI^j~md+h|uvVnPRmks&Ws`bNuRrJyrik8JfBNQS
z#banh&!E@CT5tNWoil$zoI#f;0<f8RMQ7DV>R#8Jrd6_?g9=Pfiy9cKG{?wuR)%VV
z=<;SGSYD1FIYQ5Pco?eWC~csKq&^nF%heCSHGi0tRBs0BbpZJ$jgRku?fxRfLJ~I4
z^{)A~kxxnf89<7-TK>O}5c~Wq#_Vk4LeqiRUsNSS=P{bO?<#fc4Zr?ffbQFPtj-tC
zMh^;pU@3%XUN@eVZvrd{ZK<$uaCm81@alp^RfNx?r2-Zl)n0ET`oMi9{3Zdyp?4B-
zQtiR*M3#+rUk9{r4FF&1CNlo+a*@Vq=fflr>+|g(zpUhA9mgmHWxbV@&s1FO%W8>1
zs&&{4{=VTQJtbjpyNvGPdU>y~Q|^r09%I8ku(XhbEEMAwD-*q?Ii=rQD#-h%p}gx{
zEKJ8&fixwPreANJ7q!R7br6mVe7&-9gFs}5-fZ;AITCTO_Y5RJAmgx^(pnjEUCVAj
zu{kPhfdT)trA@HTwnw-2PI?qJYS}rjyQZWfr+_f7scA+&d0^i%!VT{vurR3M^|l{%
zbY=&C0^nWPjkrsH_}akUBOKR~(na<&iEWo&niK-pbDu9MTT-42mvTBCN>u6lPhj6c
zvtsV{LJclPe8Z_NmwI~tq%iZgkjz=Mjw#&v9^N8%1Q-FIR6-gO@#B_pHF;g%ltSFQ
zSw}ZAN4Yx)mem7h3{Mp^HbgG<@{pcg0WkI@Z$U|!1VSO4nzqO;M}e^`pIyjevNqs$
z(ID7f1(Z=f-NA`(dW`d%cINYC`7xDxhPLkf9P>dR{L|#rkd~E5?a{?eg;O9>*dIHG
z-llazJfh<Lp#ui1ubk6)#W4iCF#RE)MC#=jXnV5Lm4eIfN9@9f6vaLTRx#v*6iKja
zIs<t(8_Gzik$SB;&mam&UPRlKuJojbeYh?=8#W#O;X9K1#b-ZVzQe993B<aEUr6Uk
zv_Pw20CM3W38rsQaPZZb-eutzfjM}JpCe;Q2B~;j&UL-b7b^iV-hQs52%_vp#<B!s
zULNl`m?u$@!W9MIzmcklrXZym6{z*=FV-t4kRFei$1))s0>9gx;r7D2u@vhyo|t|>
zeTkJ@d80REREsa?gO!k-smyQ{$L#H%HsO1YM?al@6x(f_j!Gm9*<fDo36AE;1Sj7)
zY)}7j=odRqbKOdQB@<Z?kBYQlg0OPP-x#x5;cmC5++{(2(0Ec3QgEGD&!esS;{T3n
zk)&GA@-O<M;)vxyx=4e472TLBHAkBbd6e1>&6L-4ceb>#1-&ErN9LJstpvMp=oky~
z|3kLjey_v$kIg9ScrEg8u$FYORzqrj-H4u;DrQvv6$@eeGfzJpfVK^vJSx0Vsj5yg
z&IOtnW2@(nq?IN-imSZ&q)#kn=yD2qrjA!Vl=8JhT((F|&#9!()EKgxq3(eQ3m1VZ
z$tZ$%?ZrQvedV_kvV!uaV<MHCSpvNf7)V=n1aKdtxr{@eS)OKyYzrUYX;ru+xq>1D
z<l}ow>2F&G59}-yT>H&kyKO5ZbnmXukya}+NX$HMUZ0(G4IU~kpK*=^MkgDdw?T_%
zC1ap!YGvidI6C5~H*f^4)6v)*3th2}T519FX1~`VNcUkeIYpA)SE?Ffkcd&TPLFim
z<}7Ln5mL$pDJe3~RWEN#df5UuT^FGxO;Uez-eC3{04if;R*NMx4|}LVr=&#Gu*F&d
zOI(5pUaoV7eL%ZbFo0pYXN#%XJ26uwmrF$!Ns=~V*e7<Ku=OJU8FTCAfCC`U7J*Ji
z;Bg?CDNl>BfV{2Tw8A$Zgjfc}WlB>H%s6xPrRDG#Do&zI)gT9107zXLLKod05iq(?
zHnXaQGcGz9&2F$6^VHGuk?7!klHMlN>3uPBBw48WhW#+Z(5TZ-`>lwj6k!*NnX?KD
zdtZ!`r|qNNi@yK58UE(NhvjNM4f=J+v00R1LynVg2QQ_wGkPd%fDO$$cRQ`8qAqv}
z{oq1B$+ZFY6uWg*Fm3;XgAnx9NML#0T6A;kQOWiQI%|plj>QsJ2(ykv!Se(PbQHwK
zfAslQd-RR6izQ{b%Bp7A)`G*I=-O^Uc#hdq2?C;qZBD%RLiQsvky%=sjT{pVQR1?(
z*Y;VULlxrP)P^~&d;BbcoepCfn++o>JR2U%zLsjn-_mqi`{4)9MCbQOawS~_Ud2w8
z#S&FHSHDG#U_2moJ<EV3M$F?HI#XTzcd}LoD!{R(qruketV+T?Xop56!xKSA(h~=W
z33Xcfxi^Y+Xp0KqdF^D^DdXXB%mHR11pK$5JGujSNtKF$UnO^Y#+Mc9YiQn3%}@#i
zo30YsCmxC11#|Ut*H0<H8r$Jg=MU7$F{TAOWQl((0bx}J{jy57_}21Gm%C)9(>jVN
z?T<2GOn~Owm9A`2yJrlTx!LmgDbeeA)r9?<&Ka%mep4g`QoBUYx+Gw>?S&gn5Ind%
zWlRNsq@j;FGjYo-2d|9@cBQ#ltxq}16p-RZhSEG!;YLqcY@M%o%d!>*#JH7PD1K+w
zJCCCSv68-9K(k%|lnYP5)lI2GU>6W**S)kh2ate9P<tsM-tIF%oXc=sMDnfI^7F3G
zhZZ+v5S~q?aR5Pv^hwcmo~#4?5WGel#EGjRSiJnvYp6TwRF~rJut;-lI$OhFTE{j9
zlL>ksYlC1Q95L}xi=DTQFtS=3;4daTt{5(`I@>q4oFiSZ<8LVuu`7Uc=Sa!Aw{Hin
zfQQ1VE63lSZVM!tOEnchN@;Yj2GH$34+vTqH^6a5-<nvCb=kWB{P^!G=d4Nd2*53%
z_j&F!>BKw0m*7~rJ!SXc(R|GHPcO&&G)wjN5#}zk6HDJN3Cw$JNo8Cq*Ul^yQnI|I
zKh$LJ+@$P9u6mAnswt|g#1c_uz2(eZxU^uh<%Y8fHziQO7-#009{@YrBhIx+f4!R)
zh1<K`5L@StgDE>)!U0U^wMh(83@}q^#MIR;iE(jYZU-s)Z}ku$8{6lZ`tbI(tAOW9
zDer36uU=zUw?yBaQf3qmZu~e35e>wkw~SH-<FEw8@JRrYvM$U~R05tWSFb=8%_!Ls
zYWgB{h`b0yidx0Ln-$GRP)oZdIddv;kcmhsT5(H##h#J=@1DLCx!k~X3)xI)j?Fs^
zvS?<$HXh|TC}_X*kLXsH1ogFjU_$6t;nbdR1yS|JOiE({HR?;!24jpZLnakE6f~Ld
zTvwbn@vCCJtV&Bor@a{XYMeHHp}Qudef7r{u<3E%2sCvDp{T`f8Np9Ar4)_p<mNvH
z)hBE#+o#Wg^z<TWILvk)&k_FFF4v^DH159ohTe|hhrfW!m@^+fW$9L6R}h1TFI{Hj
z{N?p@A2TDW)!vZmSV<Xuy*^&{NF16syq$OecR}6DKV8^9$1Z?8OtpP|A{Qn9_$Rk%
z^~Ucv{nko7O$lbpP)o+6F#&dafCOb-B3~)L(K{4npO+eq;P`Sv>#{J7xCpKN<Ph8t
zK6M3JqGW}z`#woM9xG9PFWOAR40E_Ef{{~ZC{^m<rrshp$`rgg#4NhT>AW))Y+q}?
zqqG=DAlF4DCFO619iW|YwP$XOvtF9b|Eb~(Xsl{&vNxCa(*6SASq`HSIPbYW$CPyI
z?90dvNzF2hfvImq$U2z7#A2-heIau<Bcw_%V%WDo+CvLHeLO-TwI>f-+2CE0P+N_y
zYz89T&&2qu`3pT&*r9xKv4ltk%C9hjJ%QR5gVDo<856MW=fyG78}iP>SRhuOTOiC#
z5(+^y_3jt5_zdit2Su!sIqGWa&#bU0`!pta)Yn$u$7Vn~Q|@v(qr+~$qytx=wDyp^
z*hP6x>2QiEWhhZZHPO2Y-^2n9C!w>J<OjC0Zi4y(mAM%%m5K>+ba56acgRNg95|(j
z8DLN8zbv~tslz>fbnH(a3?LY=SnRQ>s~R&I-M<}wlt|N-(ywt?Vv7C7dP_<1{w|pp
zlx-)#A}6-pW}b!3sndfS&PizY)#-*o9HmJy@uH415|vJ9<B|D|e8#5qXN|G~YCLXg
zdubdF`DUWG%|^03!t}o+|CCAw?2i%IPfQNlb8-2^Gdcn6;k5NhsP6`~@i@YS6|AFU
z!E{~WED*GvtkmQk)D4Gs_Y;-lH!+xNW_1q~N)nzw%fpKRc?A<@JA7a`h`4vFyZ9IW
zfbR%(wO$cKxSl%;_R_nEF`N{10*tIO^O34uwN8X4Pm@x8v(+Jtwk3&H!hz}D(JK-b
zI^LbxJQjcPIF%(N@Ez63#zRmRc?;s^W$t#(d3!<m!dD-^51ZKcocN=d-i<{E;o0Ep
z5gJ_0A5KE5NmHaW5Q4CskblmIaS7H-7Q=CQd$ItTHgDo3IED6h!t-$;54i_eT(Ck`
z5p+^dUboO%106zNm%b-@f|I14rOr`17_`*^a=jp<MSftF;Ovw6M+9;F_s}8&>Ohyb
zi$7~{O_f!xs!0nhEHhd%@lAgE4RfqjOTqYXJfzbWij@k+flqdjwMe$WG#HEx0s4qf
zY8{xmQxl84^g<jg)BHH0i`uvj$f-w77y9yYAg*})ApqcNOd-Ykkbg-Je<`|UL1Jj|
zSP*<l1*wdY0x4}ij}vUPypgDPh$xo<Q`X-RTmKrhXR3_kl2nANvxwB4<$!Kiya)pL
zAh(Fx>7FmFoou)UiP3fNwi=p|kIcsyq|;hn{yM*-ypqbjrJKS6Z8oW=_DWQAU|KF_
zMOeI;ct@7L<~8M{WophwF(72od{DWUW8QY|lW@q6Vc2Y(D7_%ebSCx|xRNpwu8nUN
zDspjz(0A6So$dnJgEAbWB)*=wBSRC(12OH0&3mK$VA?>sI84DV2|yXJ<KH>|iI6IJ
z4CV{RbYy&HmN-cPzB%`U4Y><-JM<1Jl0(YuV*!3L4Z~AX4nSm3p9SPdb?eIZf`jy_
zN;A_Yy&D7jBeg)DHE?XK76ci4N0vaNZ3}iA09^yI(UBVyv{!@BpF{FynK^`0xDHx8
zqURye@XP*kD%K*>>I->`kf?~2D8uYD+jPd|M6CS-e_A{(a|C+QzX3wYSm~3sIC{tb
zFnn<C_l(ubwM7`pdal2|@OnawZ1#bSH-y91zw@&?$Ekb;g4>R+hV=TutPc9v1TrO*
zz!-AD)>(dW^ibfd8B{>@fcSl39acN`8RLWY5EH54gk=g{d6A!@8G?ru#FYnF>3Onu
zCZDZZyF|kxoZ6+>J~2XMb=7_3#___Slm0w~=*0sH+;0`>cyGsR0%JaTDbYFslFf~T
zx9$)HNahZ!B=I!vZHkAJ)Q~_w6BCtBrpbp06nfm%^iP-@r=Sqv=}dpdZ|Z8p#MWoC
z3i_LQ4f)9s%2xroKdy!lDTuyn#TjLAUine9H}UTH<k`~UXMy8=XQ?EfMF>MNG*7f5
z2_h1DK#E&3Q{-z>3rmPA5i3qa<({e}V07eOAvYIsh|PS^l;(7()B@zqb4Dw9!}gqR
z{_VSu6h;1R#!vL=+Ehh%s`dm=_#2_%-jKfb!@ydHYz{K#&D?zq?uQuj>B!=&b5St4
zFwRz`rk18G&zI4Db8pnGZ9}c)$(h4;D+ot0xza0F+51u7YO|pI3z+Ge4Jp-hxA7>X
zOAdPmR`!E*`(<kImaE78U9c3fl=7O&Yt=|7A?XjuUw%<?ZQldCW#>1oiJfSf`@6^t
zI<!XU{uf4Zh#Z8w#Jv|K7<0q~7cao{PQJm$Tm_`Fa?;qm7p1<#pnc8MOvjD93Up;X
zn{^I*W{vv?^z=T`kyU1$nakvw&Xqy*7&~lDg72^@vUfD1A(gMU(%Mcwp}t6!VRSlN
z4ZnServBFs5VLocamqT@J6~>{A@n@<Yl!&(>%Yw@JtL;&xm%b1RmDn|f*&YceB#tm
z=VVZ$Q+IsDa{N=zh`|4)`=TAwjQ&F3Sq;a%7+*517Z<=jU<@;UP4YYLOvoc#YDviA
zB`DT661r;20<9O~>m+c3$H^_Ks_0$!0xnlxANvYs<ubdvTvOH`UfEhGt!b%iSA7f1
z>@3#6Fc#H_9I!oj`b~=_{f8!kYSQ25YrNRX_7}xG_9nT7Ju*tI@RLR%fSSm0hvw&-
zD;X}Vws~GJ>TMh$M#qiiy-uNM*UEFYAcy3^9#I@O*Ti^U$J3hO_#Y}w8zA?VUkJCJ
ztB~0bbZF<#YssFCffb5az8<VkFx#P?HiFeY;{$Ly);t3<m>mEB>kcBngU`qQgCJQc
z(d<6=OrdVo`9t{5$}&WN(k=8qSCH?l%zj9Ml=pf1HBEfnO#uU^D+D##mo#>Z-$Dup
zHCR-pTiGsyV!o1j7CAsXk}(Dl>R%Z;Jdl%1FJJKId_`8PG6fu?c)w4R_ic;Yvccl8
zo|V{;P0>FOvzqmk-0f3v{f=uN-xKjDN))8%8lvZ+h|Cb$$eei4&e2v!J>~{!d|%cJ
zK8f%keA%Wz)VcV33>&WA3KJ4uuaJzyrYhgeTJ6`~`?N)u4~?q#ns9eK0LMbYdclxY
zKX4CD%a)EGtfnN$(()c5*}7+dy9W^sfVnHtzfDN6YO9yyiEBKscy8i(at#Y45vbl)
zQX!HkJjGk3FT$Usy>)9%Fp1+n*{Z{Grd{+t&YF-%VnpaN&gp>M^#eYVcswgH!n3Fk
z%^CVuXjJVF(c+JI#V@C$COi^M&0~XfYPXySFFkE;pV;ozdhFH5Y4k0|-OLzMH54vg
z(_ZyoT~mknSrcS;fb9QDeA7JQdi%GaLab2kR7~1lxXFLU2H~9c=EuRluzGh;6x(M1
z$o-y|&I2KhcwS=%_@nZrO4l|Z20&=j+!d(3)t&G>K+<q}2X*gwUlRL?Uf!m|-k2Cq
z3dJzjK&ZO2ah3+{xh-VVQMe$8lfZ)e`yWmqk<jaHEGr|uB~n=a^My&jIoVR?$wGl!
z!P`_RhTT-cni3vq5{>fU#};6i&O%r3-<)!4Cw)WT=?=|Fo#FPO*!l8y57N1|2(0Q1
z8EvY+IV<Cx_~qLSPWM9ZD7|(if9$t9YL4MMkI1UYw4p0=BXqu$Zu;!`wV1~*bSvX;
z{a?WA1`_M}S^(tfR)^99$1co=UZqiqrMEwky{aqN)hy`{uRV=#TpUWx<5I)r)B*CJ
zP(`vQ=1|FqBWY`4tId}rdfEi&#BdJ)+d~T7X`iEZ^Td6bU&kKZ`H<Srn;dU^x#^T0
z@TS{C`B7a9sD{h~EB1OS&M|Eyc-g0Fe~R~i$mRxb0ajc06D@%CTYTFvRmIwJe}YUf
zgC@`8-*AuZ!KdY_>#97cpH>vou-C2lt4Hn7q!YoqecYy&4B&s6e=U~<@RIRbVfNwL
zt>kUzX~lh-Pc~s|($l(;-aLQclHXB;ux=ub86e9JkGrp^#Jqw1fQ!Lsh3oGu>}h$2
z&#aYk@v=o?Q)*}Fyflza`vM0J%2SOZN&oJ^KIu=Bf%y&wjKQyh8_lO5UKnVfZKy(N
z>#I*9K*${SE=dAknyDPpfQex+pw48nP_Zst@}{>z{>Bz5P$VL<sD6#9c~~pt=F#XH
z==nJozal4%>)UDKnN5^#c*VpBreyT84?$|&hl!vS6C91|swJ9$0v3Op*w=7)z-?}T
zBA5X5-Sr*;Qa<$*iY5@pKPr3%8+UzEQqWXGzCF!$1}4X%43w^7@yhzmgyuV@HxOt3
zqfX*=4l&%=uGV8kKx)_uNqXdFJ!fM>rNVCpiVAis;2i#m5z9|U$!Fqyw7XR!S&+iY
zY%`-}&Q-RWq`Y6O)QZ#TgT?7=#T-%y`W05O%`6IOnUH>FylwqWZ3vRzA29xA1lv=v
zv))@jJITJS7mUn+6wAV=uf3vAAR$6~t>z_$6L04iG-0hOrDMg1dDSs&b@XOmr+KuV
zGSNdagAMaU9UQyMyI@)DAy<6yh@P1I;|N5=vX6=^s|y-TD1*dNq(Mx`0nWx*=-?un
zlGkP(f)Oq!c+U*J;@!FhQ&gC%n4_<{;U|>fF;78Wc%fjNFGfHKyK;CWL^WeQrpse$
z4miwo1SvB91z_P`t8FY0{4uH3|FquHo6^ID+5+f814qZI6&DxrPhfvCb;*GZ9+h5H
zDWr|XeFz9}KCQ9~`wA6FUfH0W6)AI^8au#vZ-~#}=r&NjA$6j8-dc%n2@nrjar3ws
zLB=(VOVXIFvve2GIT|ZO)UwxsT!|ueE}j3WHds)?Z&lDS5;_Kxu2|k8?l)!l=$~G}
z(LkGG;YK4JB`Ryp@WvASg(m0^MbCqlQCEaGD?Z(~&(Kr0N&TACy(=q)UP@@{;0ZqK
z%F+?!_kM3CItG#(MPTjsLfu$zGCUb4vT9VuP^hS0y$&dTvAN(NWWF7A06!Q3rOoX}
zH46+e+BLlBm>=++k&Ct#F<M9~?c)F&-J8agf63nNc}7V1-lkn>IG_+s9qf|6K;4Y)
zpx|D!c|3T(fRy(_j>g%()&M*KPcCSDO-|!YhxC&R&e`>ftIj^Jw30>q**!)~yK%x8
z43ILcmki2XYg88?tl8c_*5m{y?7)n);M`kAENrN`KC{okIQy1!@C4zI8lE&+hh#||
zc8*I7p#ikKF1Oy$qblyUeT0GtQ$8Z_?F~UNkmoSo!tv$Xk@Ey@zzGU;HTqUcdxJ3v
zUCz|?@Es!)>FmE5i$qNuNjc4OgmoLKRGTMjL_wNck#&BhZkA#3tlm&!PM7IwOAt9^
zi93g(7M7kj(|D1XTpEMu{ABz3K?-Upm|g#bKj$~0jQR{gGyo}cC=^dXgA=GrHP~dO
z3vu5LquJ`=LHj^y@(d(9aVC(hX5XBwhh8siAe*GUC@#1zYdqR@DCsL<r)o?ovTKH!
zG;ex63*W=eHW#;K{XA}-Y2u&~<=x1QQHd&uqo`EXVbh#LBuA-(kLjQP)1rvRy4rJ;
z#xHy6csznVX<7aYqm&2oNRPp8z97Km7)K&z$)?4fX)YP{{ttpCZJ<vuWfFMqTu2QM
z>U*7FcL*Fk>pQIS3W-eHJzP8f5{87Fid0t1>LH2Q!<z<H6Yvh;5?{MmZsv@aen8_T
z`n8kivcNKh#O<MCiXgg>#(r2)k#~!rj!aI@V38hNo|U41er)pu^st-{a-)v!PfDCE
z$E?1FI*mI;(u8+9vue4Ocl0fczCH;<WD(S8%V8k0-u;bsz;EfOMWjS-CHJ|;J=LNx
z0<hZG>itW)k4Z^CP&gDIr3NLz4LpMJ!`J44&G$>r6oUvK5)m5|09xPZj(3r$C$OZJ
z${koQ)C>r;bxCE8O|<(?=ZF(=LbmoBvywN*6z>y-BM1BVuD?p=?x`)50{<gB&@tB3
zb!yFH1X-dxBmF-OL!?3%7V!gK{S=dG%{i5?@msJ^--X4d&7kLAI7OECW}j_M^!r|}
zkqN404e8LDy<dnL|8felR%-%1cO|9|9PqXrSxTx*qWXJHL)eoEsnvD>f4B7a4NtSV
z$TfRa(LAYf%}54&FVLayhP3BRKtI^`Tjqz+l6raw08lvse5RX_$gBPU(H?VGG<&3%
z5KaHTe5dGdUls<=yzGcQYjp50+&3w@%yx`Og31~1_Obg=)8?Yuh$UY}7+G;iT_&jJ
zcBLE9ekpZbPPXaBeo2kW{P#Cd(*&~}!LwQVGUDj^{^4!$AFnCOdWYz{*N}?Mz}+-|
z`;Benj$7cLcN9y)t$>O_PNkZTfIj8<hb8PD*lom}1pDw}csc2EY0Qx0x$a;!nEG%E
zC9O`zgIYhGnSLqX+Jib#9UFY5i+AWOh2`Zk#<5fR;FYD-*)Jmo^$`L!Sl4FfkSwkR
zbvXQWkR69_pUuiM+NbsF{Ln0#H+um?U*9l*r!OzwQ{F%4MA=a`4XcR!XUs-&c(iab
z1|^j16xy9l`Lv>zGfT>8zzL*iVZ)iq0vV`KPawj2?Y`U_?b&p4RtHX-X<(ID?e}o*
zaLi=C3CJeyW!htC!21KWBcv_9lT*^JHnQkUTYnY+`D%MtgZ|Gz0!`7&r`Gw|QHRxx
ze&4AR`A1G}e8PtFoSF1i;UgvL;j!^C`F^3J;$WzC;3$;$Uqt(3xh^BOd9kla(~=`c
zdYknVCYj}!x8x_z!-3_jvIa3kyY2M29+kJ$wPar9$^X(9xYny>n`kj30_#%iW+jsa
z86Ju2g)oqN0BS;CF&hn5%2Mo3IOVJpPK*MG14|}bC^fZJLy+}N|BVROx0=v8v`+_i
za)p;xV3tyfwuXDDtsE-hdG2xJzuJh7!JK|lkLBat?ptnTucg7@sWLmE8CZ97T1W7-
z!BciXw}a3&kqu+);12x6i8qH2pIYu_?mHh&avc2fGYEYauHlW8;alVur$~s24Xph~
zibXdxJg>c{n1?a34t!QTmYM(Fc`781&{8>cs^($Ob<jI;%QOl7aTlR~<>dL*DarrY
zJ`C_R7yC8Vy#zO|gVjy6{}(5^M*pVf;w)uPbWc~REUh2j!`r|H9aNa5PCKF}tY9D9
zWSd?J|B)%&e52lh<h&Q8-dCLsUqhr<qdI|oj#!y19&TKt<2Z0Yr(vgJx>};&5_dgD
zPF4Z$6(IExA);F$8g|%$L7~2*Z)3v7;J|VuNr=&n8g)CrQ0QKO(@$jpz$M8z4buoW
zV-1&BU^3ajj8l2eSbvr{oHnt)qbhDv*||>#_LV}Q+4<a#-OLp~F(yJW8-HctgT}NZ
z#Jr7M5gKLvzAla&BFY%rlh=g73lmu7=hHN46-^n{Qd5_c8p@ODTK0<5H^!#^DnS`i
zoD@^Fqi>l(<KE_1)Q1LBVpdx<DFeme7ch04Ld5u8G#6+K$mv#|Wz+0E!pmWf!R&zs
zy<SyG`pZ)SfR|*mt#LC?P~FH)*eQUA!P^R!sLT~UhwX*JcwBiQ>?ML6{VQ;{xrzB5
zLg`pOp`_GdfY`iX+UGgx#cfxYQWh{+@MM@%k7n9mWoXi9N6Wmh68xo%S3+6Td_!|m
zxL=i6uubuQ$N5&>rNAzaejE_z?}2RU^`@ZJPhS{~7yEJw?cd_Z1hu=oAxHys9*{_<
zu=Z6qWA^NUUnQ8#PEBGlkN;mv$qv)nRbuV@E_t41zK&qy2k|6~ebz3sB$=uhvPs;k
z>XC>E_UxOG!J%4qqetBol@$BLdW?+dlonrF!-#u1fz+&OFPq^QWX|6~H=|>3ONTEh
ztP>%=)}5aLjKJx@!9nnlU^?fWV-K{C7D0=@5n6Bmu2#3mYXcHug_O{Wn$8(4<o7B+
z_c%p~KX&1<*M1lMlxr%}BRStz0?HnCP$l{_8G`Ifl*_llV`)g-2di@;jVpTMX#}5Q
zKn|41jN35_<Zcg5W&Gn0ht*Xz+*3Z5tC(xz_og88Q}7F<p@(kmN|e*2k+M&eDx6i9
zh0c|n7F^uMRcrDVB(70O=GH7oWamvR6dq?7fdvW6p-q@n2EfOX{q5owMmc-5yJ++s
z2U<P;yLY@ij=3b@w`&)a0^4?#4XNOTXDQZ3k)xy{G~60AWOP~`9-vq!PFHEQs6oJu
z5Z7F@-iJ8m8t-&vTr3p-9HHY8ZNt7J;rA-=_7@?cwPP``n)y%GI#1JL<!SsUl2G9`
z^9l0?>E&#9Im{s|*GaESa_puF-eF>Enl!CT^t@DE;C+dyXPhnTEa{^oRcu(T^{p(N
zn1b)nxd~bj8$F6UkZSije{aA|KyDG(dPvT?T`}Qtza^N@vVP%Y^szn$f@`c2Gn9At
zI|OW@%4eYNVPNSjVU#`oxeKSGEcKnBnITlXJIfZq|8)oSRoCz<MAS$uJsd6W*#GH9
zwmEkE0dIC=V{4cNaz#Z^H-0FsKv_Wgt@IX`2S#>hVUmf!iRGHkOMoIeBKH1L9{3ag
z9Sij@pYF0HBtJ`upN?tSKaTC(4^2HYadHt~;Q?LN|Nn14q8M>VeZ>>lOVt_%=gHF4
z_*7d11A|^E8o^B^2>m^j@&h>a36>u0TVz)UardO9o!gfk(ycQ3(VYg@C!?sVgvqM4
z8sL=h)xf4|brnCh?Iic4k=>|6PPOwIk@^n(@Z5}Z{J=r&!5fPD;(3OuOZu`TjV3;u
zUiyvS_-7eqi>Nr;lUZw^H_9yp3|@Qp&xDgSIVy0J&hHf7K>NcdgV(^3>OS||JZU+>
z5|vy}`etxm-wXqbYP&`Q&}3$_ix8fmG-eJ8j@0<z9PibQI0-BY6rr4InzF+9UNA^&
zac5<+IYI$+tK6++oiR7tR8gjN;C1p#<akt-sL$`vicFL$DYUr{Fm&ni2#H&@QZ?Fh
zi)cM<A^CDlJ5)imM#l*xSTJE;<s`0491h(AGv3@5IdZzS8_bgC)Ee&amn&#AhX@l%
z9U^QI>}=2nG&i0Pj7BF+AJiKYYqJGrcM^vLn0an8TG|#Vkp_TF)=C6YsR;>24W`Ia
zG;)r7pkjdVJnV}cy64dLW`{4j@v7)IIPe4%r-8Yb%5y=V#lfyo20jGUmW#{|2}vTR
z*Weq6U@Ey9uba(Wb3#M<AN_harA(XwIBXI!?(uALPyqU4x=Z!))6rP2RC3ou>GizH
z`-*ys{L=^19MlUx?00PwZUlAz;u0>RLp0~nugmxlsrA6LM*Trh;7&1qssZr2nhVGB
z-EbD1r1G9;mUCl@LtsW?`YeEOiKh#p@t7IjM)^kuoIby)(CFH(mvPDodkDo1v!@~{
zmP+Ztw)Vu=UKMugg`aJh-ws&P(6T-rY6wh6xD27J0rad5kf044&RE~ueUh(g2vB}E
z7roQivZd&af7+vd%j<`u^DobT&TSALv#;4^BIZmQ+;x_*mtO_#GTB$RliA^@Wqnbh
z|9@({=$)j#as{WuGShT;NZ=9U+xonNkm-z>wPJ1&7AcOaQku>ye#D=r)jMW0=}$Af
zVM(eKms!gC;_zBL2BU^iYiFj*mwi+TE{WB1&`|FmHW-D7<ONv@8DchaDHsULQG;@C
zCW;9Nup|`6Ihwd^T(_#PMWrn^6O7-t4t7h+#sQK@g^Bc^Z)5nMYJPe2lEfh7N?*m@
zw5H!9mxRwW{66O5FX1t5GRF|au;>P#|A5>oEtI1Ma|BUiRFdFqg87msx*e4r;NpA;
zX3@yfI<-RyQ0{k+(EMD4V__f3j=04J{dwVL=Jtmt%b9_7ShM`Mm9j{%(}5kRI5@s9
zOC6U-pN;}s`zB3~rz+gntNTqwrhAX?H>fn795KxHAd~*s)PAO1Cf|iRFqe)JEk84-
z!hz-FwlL++D`%(+*Y2j@RmCNF&85F>iaz-fTr#i1m>c#guMV>7Sah}W1x98_TzE!@
z5<Wm3wh*i--662N6<5EHJ*}9QNUez(O)OQp_~iYz^HOx7W+y2F(xv{c$dTpOxc^uJ
zDJG#s_;C5!G7+AR@k`-7{u{<ny3!$gOfm`)U-F~X_Le(nzxkTdRzu+)fWXhMm%f_6
zU~uxdwhDNS^}kt>{Z{{209>Q051{Z;di3wv&uWu~X_lfG@hgHPGfF(Wa23~U1II9i
zvOBTnnX@Le=~g`6t=mDZx_KBIyeg!R^~RL*p@qq4avN$s5omngd&ZZw5Dj^`FCRnx
zUlV!H3O-$YCSb)%cy)MFJz7E!sr_T@07*c$zo=53QBf_*DW^s6iR1hBR0xWtOI9gB
zJ5{q5sJ#lQi5W^{2?ri`dh$SU;z(8G^5&f?Du+n&C0?bcPn&2(`JLOom=0v+f2fnl
znthMhgukEBP9d!Xx40SuF2dOE(^qI|bLNoZIpLBA?qyAST@4i>1L=Xs>T`H8Gpwzo
zTQMMzq*$)td`{EVX1b9*$zi?c%{UU9nmS6_{`+RMeCL~7&EFeVl?jf26cN<3uwD!T
zl1ar<-f-1{J72)Y4X1}y6jeb|nFLX&c%C9Bmf4}NPXctBP+urB8z`lLY|z+;a{TZ-
z9iQ1QoqWPX@3nCka%O>;J^yrhx$!Ox$ne%PGy^&YIxEITb8ciGF&oX_>EA$J9UrNV
z23UUYeOd#CYdbglqM|}S4U;fl;W!|IuS`4K@UUwp<;LPQ$L<_pIf%{K#7sapAm(g?
z>bm059wI*Yr*&iOO_?{utw=0c3j!I#uz)$|eT-5%JXcZ;|B9e8aO^M)>tC#>01P1h
znM#==LRsLjTyJY_6S*Cvy!b)Tsql|LNsr`H`qZzhE0YiKI1`jOC-2!JF`@sodXqb>
zneLxP`y$QEnN`R`-55ei7G_bcRCZB;@KNg0Cze@Rl&_@7Zdk}_yK4J|`lByVv?H?k
z8n@3s8$sJZ!|kywnL<2yZJ}Tq?C+ooTHPG84TC!!yBaZaVbpYO%fI?dPx*nP<lH@n
zmM+Fn_kW7ni_hAi^b9r^fm=LhxO0s8IQr)rP$~vmzbT$#(E+DJoj^Ly##DA>rMLhr
zmmH7{6|P({>sYj*FQn*Dh4PSw#Shw8*PK!+l~5!{W___&xuw5qp2&8Y1l^(@<YO?j
zy7YLTy#kKN1cc*IUv_@xBMNgXJuCE7=Cf4Qszdh_)SMF@bR1x0%^<lSOKe!(OLxsU
zkj$C^PK57|aXhxx8k=RxcHcey;16lA(5g(~3!;aeSDWBjg+i&i!#m9)`@J~-pmOQb
zw5`8dXwL?mDPS9<gQ$c0Cl(t}fL60Wbj>9RkqixVDvMrU9NMn(kl1}V@oi8xLB!kz
z7X!AR7!Kr;u{5o?YJ(;E6)R&*YNOE+*-#7K7dC$o^eEg!sKA`5U7^qjrU6$23>!cF
zJj>g91UsMVMcEn6Kwk!Z#|D`VwyP&FB}`z0W$Fuh@eznq6a$wz8zL6{TQ&C|HgJP3
zQ@9)cSE;I=YJ=m_nCYV0sD^tx3GxgMAWXA$=J3^kYH<oh-Xh}^c0M0SB<bRba3%!j
zsyWcY<B6qYd-({N4qw<5IW|}(e03QoZS<6uS+8n9G(wneRXK_n(lGj3Ux7E?3v&$>
zGcTtBbO;`xOQjzdjjI<zH2H;=Ni-!nX)9*Y@cL~g=T$s;?f7KnnxUzyMtTL7gO5p@
z^6}`}aPa6><Yl|8?cbId(PeZ7IBU+^<!4@F3<3((OLF01y5;_%tQIYO7M7TS!%mt-
zK+L-yRnYH@QweePE(}5*%Djgl9!xrV1Q3EiZ40qlPq%tPxbMbhRX5z9y9ikKVoXpc
z7;1y^LF&%)HfN{kP(iB~hnlXU0&##e9;~6<SJYnIx=pE=mg$bRji{hm&eZ_)Y+d%x
zR-TAIq)dF=QmP{bp?4G`6O|dFIyXyEtZ71=i=0m0Dc%n61>{m!Xb{>B5t~8+J;cu0
zTCJqm79Z?r%aZ1b&0=b(&)3u^gA)<@gT^SyhCc^RqxeIULjh^fV21`c<Tj{{NY;n7
zA?eOQPV21;6G$KO;vPqI6S<n2;}1Zh;60Ks*tw5P<tY*WPeQBYO%>?<raUR7N$(Vp
zGRqp$RQDdgT?KE;m%We?p^|p}<&o`Qef{m4(P#_q!6No#+8qX9jyA{4+KG(~V>Po#
z{-4xLdjA}n#|&H$3jEI;6ZBQkj`LwLeg$EVDz&a1Ff|M@c;gChC^c%%*eE>+o~W*H
z;p`w1c!yoV-&o(EJc%fRhr`Z+S(>W#^)5?<C!~IKW9?l6e;2N>4!|2o&WAb>NY(*m
zLxfUkKIh^;6aqDU`22r92qS_ePn>Q}%rkoCA>tdZ#{2Nj?V<MB-EE&=G%FbmR8Qwr
z$Q?GPt5AyW7X5RgSlr=Qou?Oy*<%QeneI8W&gMz-W#(Ry^y*acQ9w*)8oozBRl1UG
z2T~)N1q7mhvYj|S3TY;q@(jP?+%(vlDM)<4$KS=(V${$lf-yYxFcSLFljO2Akyc#G
zyU2Mi`@ItNMGPpGW32%%qYG)$BOCL=I#mlIN`gKHBl&!CGHn}O$_A@n$Exx2A$BQJ
z#0*2BhiU8zs+oe_IE6O5{(>Hmv@o~mG7W{z0Fl<>P3W}X3RrAL_KfN16Q`T>foUQ<
zD>L^ka??*v<KbsEO@R>9A+Afods?6Z>E?mP0v!*HmVzg>itRuGXEc9qut-#qdXz`s
z85uq`@@X8zT@cbaymuMLn<J<ts}?}~&3&aDn|X%twq$pwZ}c*-u)(o0qHQz|&te`j
zyW5mzg(v+Z^b{>eJD+*|20IV~XKUJ8Tk)+Mp=*G|Eta$;N9}iG-zZ~KZQSZF+%@4=
zfOQxyHB`_tpOCyLuZV0q^a8$4U5{wa;Tqwux?o62Tye^slav(_e@FGU9)GikDT36p
zktU&Nh$OKTn$#SH{v}4p<pg2XN)M3{y2rZx1#_@KQ(TiX`$ltWQYrewg2+gj;R3sb
zO@%0s&nE+P(2wT|(pfECE!$j?hnL&K1KbQI^HL9<!O#G95A|~oJ9Sl8PxW*tTbv{A
z$q_f?c}LE0bZyAqms>EAT<WGa3;J9~$Y?VUkn^=02*gP=;FaND5z(48VUbE6At!3D
zU)e3>Wc(aCS;h4*+H=1!<EN6sZw~H!%=Hh@zRl|;E@#8<qeAP)(i9#vv)d#%oVzEw
z-!IH&lvs4WV!qqnYw00SGk3cRRRCN|^t;C?-z?M!c}Yryj=`$?2i14pEnG_zmW6~u
zVMv&We-r2y39`;yzYT&Uo@htiS8j@5Cz6iE(r|RlCLZEDrMHw8h<hk9{2g{5de=Re
z(|b^JjFn?PQ#8B_L{|~54F@aJ5i=_3-}I@dm}z3MiNEc=eKzC<@GG6$=|G!6IiNz{
zrPQp)oD%Yevz%Rwj~&|TsmryU#o0VInsJMs=R1y#Lqm+G)uqzet$ZSWzC?B1_RDDo
zoM8!}&Dvb+FlDp_R{Ks9jC}Q|pgdL|zD!=cc1lddr7DjqMO0^^C?PaLiwzj=)9LvB
zV>0{Tl4%iC3=*qCb^=j&N;cAKo2^sCJ?#}QEHd-^=gS|dxJe9NgMIX#B5y31b8+4A
ziO872k_4`o8;UAt5eG4BZc+}z0dJ8akBBO*A~HwWb`;Fo>-;JR0{m{@vP|CWKKYy{
zKnob>#;+!<6((!!{zK(_z-9ay6x1Yms1G>1y_PqD#~Qi74c<uXTM;~AN!JGM3!RBN
z5^geAm>~_sy~x7qj%)$QTCkHx-_;uh^%R2(<dwyUEfy~qBc$uw!)ie%XzNI=I!D+|
zH`~%}lK>1vkmirDa%jUFmW<5Nivz>q5~a`svlG?uN-(9|n~y@p?mM|{!28*@pO~&M
z{=;3O53WK9+8h)l9s*jg%Og9W{jQlM@F<3x)3^);m77PU_GDeyr@(IWH_CKqjf+q6
z+2M+T7GLR-<HFYL#7C50WsMILq3V#w^4v|F)bC?2OI0pSIJ7Vn^Jp@|F4=4|*Cod(
zMxZ1qgnrZP4~fG-B8rM;N7A=R5|gLQ8;94OZ|;|TSkAv34pv<?I6x?4aZn09M^C1p
zbpA)jR;A%&OVlhfjk2FeO)>v%KF4mf;bR6Lv5`Lb0hlQ~A;FA28-(!3cghH^vAx4D
zwdbWoQ{OvIR6`sZ&-E+>E+~hb#Liy@_zVEWxqd?F_3J{f!puG_?7viePX0wBW4*Y~
zS@8#rLksvB==>+jjE44<+R;A{qfdxThJfB5F%qHP6F0x`We+aE5JWvgzD_Y-FP!c~
z^8MCZg>;$DvGUlrZu135_TQ7(OnF}q>D;<VSPPR|3@!kmnSABeFBg%uxH4#VT;O;Z
z#C$)=*&{d>!#|;F!5+b*#6Vw)00+8b#GZp_91yOx33_b?ho-r&JlZ@MCOiW(S%}G9
z9j^YkegVqnp*CibaDw$k*^ehP_h%WfF29PY_Y$AY@N*DfgvclWdCZ|3sfN_4K#whV
zzGzAEY6(74`j<9M9AVr%_9fa(CV=niD!a1augs#_3wOn_elKT|(QFObX#b1k$QT$8
zH9Q&g!aDErPlhyd)1v(>@(S^|D&DL9<i$z#)bB%Zb)_HI0P6n=<dJ=hnLUm2qYZ$H
zb^R8YxvQs@D_94ASkf+tuJ2nOZ=-x(zzd%d$Ccc4hvc|(boCvAi>rHZMgikFoPcOq
z2M~#UZ$#2(`qFrD@{*zJParVqF}ZE4L7bDUCcBq<49}`_gun+puYqbDad!?T#t8gx
zPcnG<eyG650B^dJZS0rv9b@--BVQDcb!`~SypM_KvMT$HgfOqx`*y84#I^|v`Lc&O
zE>z(&l`W#time~_U25<#WQYn5?g}w<>-S9RdJvI(aOvYL>F}Y<JRW%H3xokOsJ)10
zQ++j73b8xF?(K;JkNdBKwieCZ%4&Y4S>!OP?&K-avuK1RNkTT;@7;bik3;pWhJI*s
zp|kOfOzUtX5z`u`NJ-OB^l3A_tu{RQ^YBPbf9S6*HS^8faSn-dd+iS*6ssyAF(7^q
zkn%6<Di9GdU<&%9?Em_u4>}f5mi(dKJJ3Dc^S;f_)X)CCWfBL}z>i5#XzT?G{aYFb
zY)}w;Y0B;u;T3QG51z6TznP5<+tT?z6CTX2i*$sXS22{GDMg{fBgB34tNoN62^l+S
zAm;z|lo2i$!J_W!T(gNi`r%Vbmve9Z$;We<zI7|wA8SP#B{H>?hMt>V6LXE_?23BA
z9StGt*Iji(QR(s5l|_P>{3c{cosNIF+FPw0@ob3QzBnJ6<)ZlYWA8>7m~qn+&sKgo
zw5=ByokSh7gF%iW(#vClxNx))G8I<;mH~zDBFTOEO(neivVyQZLdtDqbZUL1vt4Yq
zQ73zZ?zLM7R;bO>gM=MO^Elj+fm|Lg@UDFI{(lTZgqjsrT5mFqhNOUN>+~KcX>j@g
z6UGZRIl{PECT{jFeG$I*9|vXw5xqSmpQjLs%ue+a9U`W_b|ZsqP-A$o{Zbzk3UgP$
zNzMOKh4<R~p2n{3A-7GGJaK_A>0|{mNi;_zh9cD!j3=8|sQ4s3%Asp!3~abP@ve`M
z^TW0^gRBc>mdpOPb)%zIeDeHPe0pI%q?mp}8+a0+!8)H&9a%b}g~3Of2hiGym}AFg
z7H7V&Tmo49sKQa-MFPG8-gAiP)4?-CNYx#lsaA-QCC+rL8R8plNm;2OW{b;_DL*f2
zHfJUyG0;plO*Z_l5;!#Z_#@-`x2z01vbl3|C>4*J+wIM9NLvI9;kB9_l-U>%8PU3%
zJMKIAU`3<Q`}Hpa&?f`h)dq#ak2eo!-6Z==k1^#i>=z534Y+u-V`f71caJHWdJooM
z{oxMeVFAKu6myVb=bArwz?Vfbs{ybMtUOI$31B*6MR~R$3Fvy44G+I05BqiY9~+ko
z*sxtG>&o65Np$%Wc=?S3mEc_%<IN7NWjFngK+pD&!a+5~J9gB#iv+cPEUFqjI=^EB
zYBw6~D|!bO=026315^TtZekNk96M1tDJ_*MTF>4UaEMGC#M*bmQM%%nQKjDsG&2$i
z&X5b4xHlVNl9N;6o>6P506^r7?G23k+=Kf3k$pp`;#5`bir3s0{mLH;#$ubxaNnGx
zy$abT0~JGX`k_S5rKONd^i6%>qE_26H9>DAk+E>piQTE|q144*^S9Khiq>pxw5W_X
zn#(&%d@9}6kr14c8g+{;Lfbqv)+Sjz|JxgE{?S@EnP3BOM$bZ{Pu*Vm*zqPC2EB`O
z_#MLk7gBEEdZ_%?q&f-8Aa8a*7|Rcuy=bPD_15M9s4s_`-oL@qf61ejoq&@K$`#iJ
z<i|X7;A`ZsAq|S)FkK2`<X`u30r~95k=%W^ad=-xrRkny09_<-^tn<G?%g%BqGujE
zJpDj@W^Dn0>RJ&7Uj*2HlCqe2udf6Btq?3N=rwb3FOocn<XQobR265sIKvWc%+GIK
z#4Jt>Aee2bMSWStz@NCT+1UbF6p2B{=aVRT-ARp#QR!;!kLGOW6^R408KjILetjy0
zpBf7H#tdZZBzR(_Qj^OuEx@L}mHqC8>HkTN6-XJB25{nyFz~=-h6(U2IO=$I{=Ijo
z9JPCwjvGBZwX#lUXppJnWm@l&DQ8cGJnzO^Y@sdPPXs3AJGOL}<v@JaJr2m=na_v>
zjzSc<3rQ*2QK0%Da&o0@(C26Ej?ZyBEGN^}iYd>Q^8zn4h+qKSEaXf<s*~xx*{9dm
zg4WPM``^g|W)SYX`+%l#!UM~Acuj0mY^D?v9r+IXwImD&#wwkrg+;OFZ;p#5zeX4^
zHf%Hwr;-VcY%|XgDhZ)4YIo-s(zc+Wm=MEb#`5W4DAysuEJF23AeGB}CM?d4gy~Os
z0W-ubNYKK}<qL*}{&CvP8MiXQY*HKa-uoXEsaxxdwckK-XMB5|shc0AaV_UH3CG}%
zt2Wp2<y)pt!2%rtkhJ6dtNM<(D-N`h!Wb|dl64BBnrLBH4d1q+j1B4Jj-zDO*;*sh
zO1gZ0g8DD@o9xpSc(ac%gPcB06IeB`HdU?pCAodxWJF|{?)ig+`r^Q2+V=|8OpVgL
zePuD~tG7uE3_GOeor!;|jY;|JcH2hMp;bCVG+RkK26DLN)RV~mm(Ek>e0x6UAk^cV
z{V3syNs{)bT$dsOd~~hft)-|eGOxMdC$hv6Hk}-jN9cV48<)d?s*fb$-BKoKZ(?g-
zsrOARJ1RV~+CF+LYe#5HTl77SgAuxOIk=osdcO=brAP1P_j84ldz}g~4mq?v>Q-(R
zlKp_tsBd&%;>p1v?v{;?aJe_kPH`lPgh^lgN)oetl?_crPi%um&__m}aPxr<ExbRG
z4ZqsgHk$Jp>lkxAhn`n0vGKNqE&3GAn4}!jP)q)N5v5vtOqWO4`v~@e-3GCxOpBZA
zqo%W{qof}3K@d-%Ax-QlUG;mLar3?fJwlnc5egE*UQU-9I2ltF40G~QBtRKcgUvgc
zs-<XFA4l?D<#wdpTb{bQ@1gMyWJ;3PrkaONeX8-?1<J0vwjhRN#em*%^sBw7*R7I_
zhN}D{r!MhDzl$|_N@n=9Z;-bA^xJ&5Gqg99|5uXGH&&l)QXPJ*()1e*XHv=4KA@TZ
zrRb~>;VUdI{Q*BLfTOQeq4#l)pDBRF?QEAQz4Vz`z6V^ehuxj{nLXiTdydQ(M*!#7
zh)ZBqLYeuo0Q;s=DKpKVff(v8sWC=k{C=Mj!AWMusnG0_vqT_oAGug@Puigo93vop
z@mw*jSlqPztTU+tCY-+{H4V*66eKOz4V<E$;*f_4;@u1C!*=t7=gb#u0jk$tf9in)
zUDbpDr-{fEIrS=*$*f6HHDdc*w-bO}G9pr<bK3vc{d$jNFMau8OoIFZGX+3BhNyES
z;4so<v0RZ<<+mPD_Zb&$Qs%OG5S&OvWR*_fYJl0se`u1@q-AX2d#oZH5XO)gs)xeR
z=te3*-F`&#^)ICETeQyz0L8EoUZyXnLyNNmmo5reu>D-OPd1<`qhOaDn1X*yD0itB
zr)eQdyc3n+2|U~|;@=^W5}Qb$Fp~WR<abbuWOW8@rvtZ1dR}qVW9NK^i=fNUCj>~3
z(G)4CyR^MDgv-#u%ot~z7(vt~bpH~nJPB0H*7n-*dl)Ot1~6AgglioMwt_!u2@HsJ
zpa_ZCR4+YUw?y&9?&LXz<w9-$Csyt4xRW61iU()6T|%zQM#4t4`IX3n*zQK89>Jcj
z^|;h#`;e*CQrW97G_0&v9hPkwN2z>8@9_>KCW#A4Gfo+uciu*Xnai_DhG3q~OE9|A
zJdcr^)r&j^9vnE0#S>wRobD@6ef3|XDHJK%S+}2o<p*b*b-||!-MVWkS_&<JH?{gN
zKT$;{qv&hNjC3fT{#GP7T>VgGx1dF^h&CSFE56Qa27y1C!vz*<muOQ+eVN?slMI0a
zOm#DY|6_-&znp)-8#0Kely~Bwjhe<fn>LMhlFDpD3M2@UM~Q?El1r|uvg8J+;K*#q
zGMrnWIyo#HiW~u%w)mOcLdn{);MDk6Lo!}MstzMQby=VG+}&pX-E26yzf_w#J=hPJ
zK#qhmEMH^mB~%pT3$!GZpiERuvq!MXrae;e)srcfd0DVhHQ2ztVAL_T=Df%K9TzSh
zo+u3fsST(8^ZL=8uZ9yCXP=kcCRm2I>fMYLXc}FM!*szfV<*nb0qEA~Mf*>Y7JD%B
z(+FtF^<pJyuln&>nJpZM8#i5|&7e)y1W=))fQ4Aiu$9IY=@3a)rbf;}1l{g38{2K@
z`(gH>4LId2@l6Q7P_6OV=9r+*%3!$!sOWR|@+JfrfO2Gl!*u&JzB~#0;Ru}mG#U~o
zt-Q2Vi$5S##^Jr0j-o3h`jIhY39zzq#5%P<${4U%$w=Q6@M$6RN;%oB5*$Z-P%ZWL
z3osiD;@ciuyhArk2&6{ohn{w^-UWrCo0_4#`*TAi?4-}$nD+L;;81`b4g4g)fR><*
zP0(2(5*RTzCrcBk%M3K6u15w?luDkas9RayUBrmK*o8iL4hOZI1caND4zAv2-Zh8$
z5i3eooM666{K`Xg^Yy5<4BwvVEm0`;L!FB^{V@TMis~phLKZtXR4?DJIIUohQs&g$
z3hou@bqYaMK^S<Cn;?ZNqEl1;Nqo~QgD;oUZF>8bWxnW<j1uQ9X+s3HeqT%)MYl2(
za=geWcRD54NEvYK;~}{Z;O^#X!;&EY!^KUjeI;g_kYOQbIjWkkU4XTSp9=zimB=RQ
zWPTeq;uOkI3o`$?bd+JZG<!eLV1e8Kc|wZ916TpQ1@=1=j7}7UZ;NG{pPziG_vi+j
zc}}@&{{W9o3pHG|&l|ZJh8^e?jVK>*cJ-322^28y5^~TA+Yo$RV|bsKbjLOO?%)*}
z`Eax+2<*N3Q~NuDn}u-X-Ei6JBO(1xm7{x?-{9gtFtEK5Ryx$)Gafy=&p5m{w>oGs
zT-vnq<v=?U1~_A_G#=L!Dn68`1#{SdPUWTEvJ$j#L^HyJR%HvlllquC!QWxheiV>V
z^t9dm%sruQgj857x%LM4n`_C5$-X3Bx<dB`3Rey$z_k};M@M<anQh;$+}vJ&?H9Et
z&rju@;b`x&4eEPU-B<5}*9!Sb|0a981w!(&m03W39qR|09)I6DZCvKM)w9q3*xUXg
z&$>Oli9@Q{t1=9Wy!9dgoO_81UQj*=K~Z;X0^(B3OZ|bc%!o+#b{~=)&oWHM`O&UI
za-CfZ8OMsFB<5lEKW;jMlGjqWs6<v9XWagNhMOM~=mGUaH@dnp+lAD+b&XLft5Q6;
zt<cjhxIXS{gdzbC0ZJ&b#H*p?s1E66mPO?Y9<e9XNJ)~%Yc{(D{dK9`*slyrD&wj_
zNBtRO9Vmc$Gbt-#jDNY(E-==#>nk}f<2(N{F1eE20pZY5vXTY#Q3VY&RsDiK61*0}
zENvm3{*QC<JRkIdA2sSGKFMPP{5$imxVAz;22$43HtVY$25PGb;Lr83V?9J#aBLLR
zI|wW@g!5!i4-o7~8jT-6D`ko^m4AZsAs1H+dvV|rawr1<T4~DY7)H6Urjyd_slY+D
z_GO^;2Fgri7@b8YRtPxszm1?tBiHM_C9`4q#^_VMY(xXEx3Nc)C|4y{VATSI$si=f
z%f%}_uJ4HY+UT7}VAlJ9Z#?Q$Zh+}#_Tz1AO%UJG>)raZAyaNGXn1U<?}=}r(wk6J
z&EZzY$>{WXsa63$8<?d}=#4TFvm7iDMALQ~aK<l;eq|BwJQ%r^4Phhlh3}w{(@!~$
z(b8~ODDrJ#;?|VqL)bsp%`k6S_8%tHnArL*TlmO~cP3mk&n~Uj*{xmS^4dS8-M7%%
zVicq&aCCg5YcpDo-F{p%a42ZLP9$p4XA9c%Z}UIKGOLUtpsevUX;s*GX4pA(vuaM(
zUfB+x?HLUfPn5@!!!rEs7p0fF!g0diK1&{D6=ZaO%T|stdK%<yH6iojp!QD@*N39<
z3@1<PzaOTdnF#UI`)8^PQ4*_A6<KK)Z~8V>GL~VFyEsLV2?$d^6}vpYMi~4mI+HIx
z<72g}nQgd-xIiN?CA+Q^dDn!zw69#k^qH>i!)_K~h%i41w-_A+u_Gd7U$J^y&g=RJ
z!3RMh4Kc1dQ^k8VPX9XE#JRiC+j*&nBV)Op)HY+X9Z9k5)<k79EHplxj`VoB0+YHK
z1?9xRB=*Yfo(|VKom*GkhpMIlOs#QUDr|o8Si^)54Y%2CGpkp!Q!K9~T$SAEQcv}p
zk$)$35OMQGcYJpxOJR(WJ^;6xD3jQpYO31j&^Q-4Eq`ehEBWrWjyJVchE4<tk;_@<
zc>F*4j}4v3x$a4orD+b&*bE}bj9MRwVtwNU!k3yPDSptHWx7WjQep$be92WOWA9ia
zeuroQY0W2d(WC)Hfzsrwo0Tq*KJP+O72Bf%ZljDA$SfKieX<@B5+%4DcFVpyzXyk<
z#c1iRvT8Cs@|iT2;RwIIA)`M?erfQr*vr4{VDzdw>qnLT_{J6AzG>tR_n-fu3ne8R
zr^LEtQ1#A0#fn_Q;}@fNc0aT-)32~4{_MsNo=&nW)&crJ#uj%85E>?u@BY&-G_>5}
zC&3*cbrmQ4Z&mN3IEJHg)S;!!Z&5p^jc_S#(Wn3GU~g3x1zA#qE3~-9XwQjc;u^#2
zi`iPHrfGw&H6yq<$3Fv20H(zuuwvXo=ScyrCr&YqeVtByQkb3h;W$M4Y-d<ap0h4_
z?@(ZZs;X!ryI{L`xF#F4RA=)^!|upA9aTdUSz3!22x|;(mfqzW{f?kNfFFhZSo1yd
zFJv{t4z5h=ftF{u87*#Z1rg>W2<W#wUC|FDr#9EE4&r3A-@B}+XK^i$#|nlUW@29m
z<I_F)ptn|3O+Ve{W8f#-U&3a9?xVtBjk;3r&68bXL5L*dpa*XwB$lV~k6k*wE8tKj
zuGKTI>d(i{3bMT{X<+Qk$XtmSA>%PYS6U?U8O@8WT4E5Mo@+3M0d{@HmO*N1S*%-e
z#c_`3<KQ^%Mc~#sgY#7dkfFf!31hT<PIJo%Se6w-yl09~nS~bKvqFb6e)MVKJr+>E
z2qcKOxRnVdUDEmSYA5#xVXTrofa$ENSJ8gal{6+sumRlwuI9m+uFQ=q|6@Kkh@VW4
z2__MqM~}Jbk`Qm)7_Ywu3=>N$L16AG?{d{00FZlutf1F}2$lB+7tGW@^oSB?uAtg9
zOw$zM5Ri>1Bf-iCJRimNF7C2<KEH@{MAzkE-{$|5wiJD_>(@%6%B~>HaVVVVKT?5o
ztM6N>PB4U8+JP@WWhtN}vsHmN>VdK^r;&KoFDm&Q)OpqDiI&%^c9rjqZS0bi=+;9C
z!Oo<elh}tOZ;VCtAmdgmC4qP2BDAP6Jo_N<6vr$tcsWSEW|3M+Mzc+R0y?0nn>&7O
zad=B6fea%s1)#ijHv4^g;0=!<rE^!{l;T<alO>!08Z7mb1ka~PB%X0}D<n6d$$M%}
zb_V3p48U)e5W)WdK7148?-K6E{_Fr?v$R+f03t*fess6}Q(X=@{=P`xx%7w4tFtJ;
z3%Cy8ROS$H&$!HgY0RiW9CA;Z*6}=wE)uto>CzL1mh*NW7fTalEegQPU{LN^o?{ky
zvOL&5&_HSgeAUHQI3&l0OCYrQAq6&R_wtpud!7%Lhkk}5V;neBNCnx&V~q;bE=(2^
zr*+*Q6(q2bms$)5jQ-_mffSEUa0Sh4xpWv`qo5%`5>+_qG{nq%1ViWMW;?lvE@p(7
zcxn_D`eTF<Ai35XQ4bso<5AavE5K1gfp%=1G*k4{a788n!vgJak>D<E(@HJYy}9<2
zDMuqZ_<N+X33lf-i9qAGj%LRr>XpIW2WG4BiP1=50TFHjN5u3=+%j?tXQ{8x`ZzQ5
z^Y4Mo#nE&*Jof9S4^*bY7FQvH*V9X9sxHJ4gg=k|0;Pl3!ds}g?w<NiJqxTX%f@Pw
zzGr9L4${=eXi%zt#@U0fD(!VstaKlW5+KuvBMy`T-i~R<pKVtmm$wJ8nw|h{V!AE5
z@Nxga9fJvLb&9@Lun*ID*0q--kq&pq3k9GTh^1}C?4#w?YTs=J=k@_zAFsCAF}d6x
z=Wgw6V&@15BUy@Q!J1(zL<Hx5ai92;9rR1iZFz-84Q3v|_V3urQy|K+gKU`W=kV~l
zIou2XoQkp8z)~6w8fd5FVZHQ$cb&@jsIQB2`d(O>D{i<~+=}&WiUX<VyO$hVgd^bG
zw1rmKtVT$XrLZeB9@!YrxLo)c;P9|Tzd3*i>tfp|0^i^7t9|YQci)KLKUnfCGB$)j
z4{J|MNw!CD4hBl&*dO(xtJ~GX#hXF;6l!zAG7Do>eyFa{D!4ZfbrWOofXt~@&tg4i
z%@ES$%_h;jZ~F4SthkalaX>d`ZJf|=lUn)@x){4a1#AVU26l9^17m}v^u9HT(M1X@
z&3QBc!-x|)(8h(thY5H#Mdn%@+~~ki&jQml5WnQT*U{g*iuyce>qTsnO~e*kcXLHE
zL75yzVKXR-DX*9A#82c9LsU50EVn%O7+QWBwGB}#@N2uy$W#pO#x%}#ridla@XT2m
zU2&pp-@)VSSNq<+e+?>%#o4w<Xx4F*f>lhp_N5rG%t~^bc?}bQm;%(YQ6$TAb|IWO
zDFwTj@%-ekP*j5dcW%dk?N5Wt*HRLcGTm@tgKHdX_L-1e9W)m;b#0(l_F)FbD0zl3
zL}ucQ0UWCSq9Ngyr_@LG^-YRtSmsnl)mI=BFzpKTj|cNYrKa3H)G1RQ08HzqEX}<s
zmyRF1nJ}2Umy7dN8*jv|DPAU0HR}oK^f4-FYg96dnB_^rSbdVXKFC(0fkS)(0iJi{
zi)5cg^5!FbpFFmJQ=RBuM0kXQvFgR(s;&o5#pi*~7x5CXdM7iAp=#dD<Xak`)rfWj
z+bQM%D_d&Jq?L=ESinpuRlNMx9O>gfN@ZelGX8suq-{F*zR3_5rFk~J>keUz0O+CP
ztk7KyQhxQu2O3Uh;{5C@aUE-klPNhQBMM>DzWIo9hxqexXm)1n7@Jfo?N<9&$NV>N
zJkU;IS0VG@GX2!GA%kZoPt!-XB9d$>VXhE}q;f`7lqaWNo9EA=@=_R|QA)iURw)-T
z*vM*1(6hLQ`U;Ceu}wUcMsPQ-*AFk`_*P1-7m1oTBc^Pmb64c;38IGhi-n)w=nI$|
zWii6$Zwuf}#2X;Tuh<I^&O%~+@%t3iC?hHSgNv5zl09enRT42DUybIQWHu+9fOBaL
zSD%blu>wjw+eB4aNUKjZjJn8dwIpgMuu2lf4CAQXd_p?K`T(?SFfj&;fw?8cGH7}8
zD5%lv6-o<n3%i!Yb&Dg^-MR`tE}1Yar(j9!{-&quD(%ce={n(B#j?c)*HGjo-IP^4
zkn>V?nJp2e*p0~$i}fr%N$tER52V?%OIcXSM{gAE7kBzfrfkotGSms)LKyl9Sb|#n
zXcItD>g@n+15xY@ElW0t`$KFDAL&Cf5pB1BVjnEH>DI+@W=1#5T7HdLO~q80{07bl
z>-PK*LdsQD`|6m};S@pBzig!Bi8j(8LrZrJg>QWO%T)UrQS-P}=72RyOa+~+VQodB
z0gX^YMYvK6qyQ8OnTW3E|C4Ahjh#)QUuL`?^Y6sG%Hw3$WsI}76Pp^YQ>RmUX&-2B
z1<JOB@xuxiCs5l8HT8^B+<Pfzp4OJMv)eYn37!=_2v5VIB!LlCzXd#F7l(Tgl+anJ
z=~5_{cA?$@wgPlLKod}FeE|4I>^@TUW7x|~TC9haKLgB*q3b#0#gCLkC<HSJH|IV2
zU+vyjGX~dGH!an$|9HJ2bq%cqZ|eH0X9+OQrlmGMM%&t)Zvs{kuhUv|5-e<y<>w_Q
z`^S`OW@UR%b#)C)7_VWlAy;bceQ9|iE{&=sfek!bh;KN5oXT2im49v%MrS?evA^OG
zRrAI?*RVYCu<a<Jv&MQv5<UHV7&-EaTULI)Y82dx&tq8w^vPthoN;Wk{RwB`I%Kc)
zrJPY9;F2y~XvB$*1A!ebn1sOHu1z_iboM~YkeWNO$){yH&qoL`(tx!bY_~eGW;aOj
zz>?j>sGn_zTH0X?C=u)qMSDfxu|QwOZMs2hDr8%XKke(g4fw$MUDE+iVw)}>lH9t}
zA_q$=7v<SL&%?zQs$8pMeKSKf(;p^$R*H;IfH>U5l~>@*lV|<ZRSyN(F9)6Ewf#N3
zUk5~>GK0W67m(*$8vt0c;EYHh$e&k*LWREvHfPg&jW$MrWdCVBP@V_aB*XxSRHMC7
z(`oDb6lAB|attVzU~GHqlfzrs#XKP_qX_mj;QD;aLPMmOYxXl$NAOl_e))070nofu
zMH207&aKsFik^LWK;vq!WpLgYe-t_^G>`lyAN3M_@{g~Chu&AvsH8Y`Qf>fMj;}*D
z>Qb5ccoFItS<z1|ke=4A|K)<1PB>X4m;UaEye1c^{AnE7xt$2O4}c@F7v;X|2z^Rl
zYcmgVEY|nNhT%Kl(4hl!k4XH^)l5W*DxfJSHK<le?v=$zu9QYenqaHkHWbwH?P4ap
z`A_df>NdMYB|pOJmMyhFb;)+7Q<H<!ZK3zZfmOWHK})P-MfmqVh4iZn1(Nw=lb(s}
z541Y{m(fT`8S@vam*}5J8-!vO5-LDE)N=1w@OhU##G<S0Jo41Apsuqa9jtc#;0i$O
zPOg5fTn32;B1w;`CUP%VQ0h6;yqcxYB#n<{9I@#=&5`~b8P&WCpeMa4GaE%{B@v-W
zTLcB+QAuWLM@>SaCJ`CI0i`z`OF!iS4OrxFK@S8(WYUH><gEdqffGymXyuc;cHxhl
zp#C&sDSe7;gRIaB?lsbK-#SF5m&a-wJe4%$+yBELN!mJF+h5E2C{aSNVq%Q;Rh+!i
zodmb(G>oeK*Zaiun@oc<QZ>(Y9#W3jFO#+PmZ^f|Ta9?xw>B<Pu{5JV#X2fB6Ny9)
zeRIgDvq&%offr~1<HH9=>r<tc#$Ace$1oGrMpDnk1xzXvX=jtXWpR-YhU4~H>v{<}
zb2|wM-&LC^o&>C2+n7!uEBY(VJ3>_ofKO)YlvF2WZ+i2edw~2}?6wVwI1|cc)MpY|
zK8G++>Pgj#*q>61(MMRq<9vO`ZHi#HT60mYm{J@A)Fm#X26zrfZR%~!%u~=hwBy--
zblycBBa^5*id0JVgV0WfR~c;JXz+%N2jJtQN?hPJP3lXN{lhCu0)py2DYW@}j0$P1
z0g`T~^>X+W3dLG8Mz67ghz(;a-u|~Q|4|wtMVjB~5bDxVYjDi>8mSIzI*j5QBr_}F
zYt|nlVwl+4TPME04;h9vT?21)A=lUc#ag*Ho;Q73la2%m)SwLRu>pXygX|H9K;ClQ
zWyC2w{3EM9j-31Pi6*;L>&W@}yXC2bW9*8@v2Mp0+#SPeN^Guhfk3`{fy6)dScEqx
zh>=s+>zxiMNsc156|~CTQK$_)s@ir(f01<e%=Q^wGn*}8{sT-0YSXxj(~ZL{Urv&T
zDOGuM5lf>U??~}g?Z81q-rNwEYe^b<e-J~V0gT(z<tP{Q?P9g34AZFh&R{a{=y^D`
zcVU`62QBKBx~o&615#Vk4*2uP2CHWj{mWl2llFfGuTN5u6&bTSygixdWLACI&1*hT
zJ%yacMJXI%y#4M^85d23sy9DAM8&s2T+xVd0(3Kgj}1`EiEul*n0F-n@yOoX;m7~W
z#3rOkB~RMXM>lP8m9h{;-2+bpfcbg@K{%`IK-o#}Hs{h7UWAw2Y5d6El<a-DKrLor
zQ@vo{2uB~9ZVwC0#t3hdqa#HW3RxfJWB*5Zq`6y45j{He?;k!F!bVu#2$?Avp2)(&
zoN(M`_@r%F6Aq6(HtSCQv{Ai%7IK*v=w>ss4lb4c`Gv8j)OYLbQI0UljrNYDDrZoP
za+?B4jy96KX>z(x#=dEP1k}2~$<+UX8oPLvUJ8|AU-+mmh0ZN+<XfNO<@;AH7gl=@
z)5w$&ZYuq59;k#1PxP)s={+0mB9GO~@KMhBU+5ZQ7j?j01IgEnLr#~AprCut@kCL<
zEB{r3_kg~SO;E?vvYe}!IG{GbpKPUk5Z1STnnxoT|LZGf3sB3&Vq2CTamK7wN{zQM
z=`AP?;Jm`h!o3j?3$_dl@G{){Tvr3UW>}wnSlIy|`^F`mP}7(aI4<_qoygdguK-DP
zkgLj1+!Ol@qqhZ-)8-HhdU^t#wDG=5q#t_Q%_h(3f3JJsM2ztOa@%pU<VOQ`eDW~K
z7MrV55+N}^$N1{lb)l?st|nGRr`CoEBf~gk8p4>Ri+fRt-dX-sA0yq)Fh0jnv8hst
z=HU|xz>AsUY+Lv}Hj1RJ_;RO%q|s^v93uKF-5Kv+p7_m0F%G4^%?Lh{)?m}($UdD-
zm^SkNj>Nq|V@Q8Dk@EEga-V+8yy6j@A-%U&0t}=gJ-7m|0l?eMMO9d==+Lw1#u@P6
z`PRZ|8}v3*oTnCCd%{)Ql%3yP9{sL$zMI3+IP4B<>fTsWMuV0U^J;7<32)HpvJCtt
za>VkM52G|{OI2U=Wu6gG-<)*MgeU8qik>wlvve8OJAlJ`OI(277;ba>lvM(6VTl+i
z`6AtoneEL;Z0tO-Iye<ZoHv^O>@DYprF&wyGaL0%0HyMlN`Xw<S8i=I<Ud*Gp|dC@
zRP+{SNZT^jcuk=Yj+>R~AjI$QQ*Rr8h05>be(=}qgCf7rvc9H>`#y=-CFHDuW1Ej=
z$vHgaGq`80yo`=0Yu&k(zxgpa-M@Fs6Yp*A*Dyp#h4%+o0>O4^u@*5QG|ZYLoYV7R
z;Or5EMzP`#nLY8pnuWbI2DTQK?*RGzH44BxM22+Fz3YHVp|&hcd*xfTagFt>fKH5r
z`dRaP^Z?OHV;Vo4+sk_>i!VL`>xS^m)T2-bD7&gUW`Tbq>zwWe+KGcKaA}VRFEFR9
z+ixfRnZtIw-2!msxyv*DDvMuOfNyINbDIJ@w@pslE0bo)_hTrIX3CL)&T<l?FB!%Q
z`m@6TFkF-)<cj<?m|(NCU5tH5BIbZHTr)k?v!<`fu?5ybUKx5IborVnhUl}4zNIy#
z|G*vg-&Bmpr6@*?XggV1`9#A+EMXFf<Eun;hlwghGtyb0RSL9ym=>6Nz%*ms1-iEW
z3FKR8^b?sve-R;8Pi<qw6dpZ}RCEt{F>*-D;r?kZ!o_=;9O1|o2J8lwHf1bpuBNRF
zw=g4T7xGU_%RZeM!yR{PFPb)@@iX1QDFoHi8JWN5z&_X-F=`YSzatQ1`nuUrd=>;I
z=Po*JE>r87Sx@tc-UJHEJl5@<r_0{7X95|9l*x3+Wx3mf1#a_9f86%%tOXue?rn?v
zx+HhM--SrT*REK~YwpR`<c^NoCWTN@279RV{@H3{1jCn0Q{u)BH3;;yyvq@wYTOV@
zFo;Tadl8Le>{JiM$6@^f4Zysw4aBAUw(Cx*<x-l~%x$*EdBkZ4Q}=P4aLx7s|E`#o
z%E`+KCRly2GvsTEtB;ahTA8$RsuK)iAt4x-+mQf!*)y8<J`0AZU)``L-y|i?Nab-`
zdSgp*;<m&Ek4N8)AA#o5N7mh;*IG*8fl_gC^XXKnK+`YEwPE}~HSo|~g#M2mi!u9v
zEdQ~9iY6{DV+!P9Romff{(X61f-rEL#Re<)@tL!q+bB1ulBS3u8<S%7L>4f)OC{FQ
zZK;5&K4wUH_t9Il;PFE~tt}LtxfS;Y)v|L9sh-T9aYmU7z;^vWY>3mhJS!W{2@rqQ
z8!37X6f=a0eJ&^LxX$72LHT7lR-RdEq~aw<np;7Fa#L~6HE$5ost8J{Q+hi~)`+8j
zr{sYeY^`b^H&0H3Diuw5^}E@skI3x_BzT<sNoM4AGqYsO<X`EMjL;En|Cn1i7l`-%
z+fMumJ_g(@7YJ=SMbyG?lT3@xFYDe?8>@#7`dU9-yaku*^hS~<+waN3!0mCjlCXrx
zD{G`P5>aLAR+cw@3pAg4J68qNe+X}>-kJ0b%dC$=j!9sw=-yT5+pD|)#6G9eL;(v2
z`#?^BO@sR&p^sI-wD$(G?wVN>rArZs`GCC8U=>=ke^x`!v}TZy>VMyff*-vQ@_=8|
za>x2j+`RQnyVMCE32XSsbOaJx6p0!3nJTc0s2yTFsTC$yYa3pB+Ox@anzmb@gtsx{
zamBDvCVSqFQYF;rN<2d19fS91C)(^#?8eVl$}VOQk{<RZJG8+m;}Rkp8@p=w)@`KA
z5bv^p{oz^6=IJ|8Qnq2i3nunlJ05Y2#)-jS>TeLq4k4fN@A8|i4lVLBOnwYwxlael
z{k1asP^Y`Gg!4v1CV=O55~2s;CPkdX*T1vVFC>=bzH9KN71FF}y6@^&H*u|$MTB#`
z{;}FNQ6YW2??6(-&rcLPOu`IUyK;H#yYpBvg7VD9%GBks+V4gbS7$`p4W1=bcayNh
z4_4~^)~O?$l-5x?jQ0asb{f||ndhk5t$qO9dC*W2tAWJ~^8`sgAU|n2%^!m%AufPA
zdK5pYAFa=}hosk|S#e5~o>sDVrH*cTU{<X1>IvX4CZg_FJW&Z2BDL9Kf^OPSH2|Yx
zHJap+pSLIa!9S|`LYqrj4HvS7BDANTb?Ov>md$;=g(3|Xm})W1A8RVtY@3{-<Yh&#
zE%}aWssumo;D|?N=0lorG+=KT9RVVsWOvy~zi;R|0ku03eiP4Z$#3!G?+5d$wUGC3
zdehoKGP|1#IdL|QjiDzbVDp9GOjq9pWT`nQvcw>8CLG+;%zTEyVhGeX(kkA<C^BN;
zbsSmNHVXy;_Su9kgZ@*n(U5Ffax+qZNA<scg-LOxZL{`$N$?R6<)&y<<OaX^kM|Gq
zchTK)VaHlz8ZuVpkSnVYvWys>{($>MU<Z9s<!oQ|RFk_%!`m}buW*Y|jF$1Q<&4X)
z9Z7J2Uw2u_Rgpgiz{5(C>Tht2qn_#DtM~509iFA2B&dAp-;sr(g2ltrklL+2R<z%x
zvM}pwPE&933D(`i0b!B!AA>I>Rcdg~YK;?yu!-w+_I|@3%pGsRbXdr`7WYDsrq^#^
znVFkX*@HCJWtMa{WhryZ8R~!pY=!isy!Jn<+`P{nZe%qC*>J-Ml><8MJr*TqM4gbX
zM;%rdN6ZB(Q+-MuYmV8R*B_Hr7u0w%{r9P%C#I~fxeIj9$_N%GS-JqO5jib!qBmb?
zPF!P*cg5rX7Ybd5r9G-*;GBX2A+&gBc#ZNZis-$>L90K6Yl`Mv$PK+_^)|=E&LS*k
zRk!_suXoESWk(IwqCh3br}(qPkrmv7A%uqWI`eO4yw-6puPpqpXH6nwpZ%rS(K%}%
z$3Jo*TEazHmNz8-z)s?(WHk^r4JO@>cG4=WImE?%A~MkG--OLp4r0{i;vip@s1Yu*
zJd`siPF}mj5U@eG792YEf-RRq9yoM(Mp4IOe7(vN&uC_AF&M6n%x{MX=rt^`KiXnJ
zpFxwLmn<N^I3K*koiG**S3q;Dg@3&LMQi|R|5s-^*TT2HRD8kMi`J|lOGue2G6<u~
z3~N?3g3WR?D#it#tmqCTi>e>hQp0t~+`4yD@<sIMN299g0R_%3eW@e8Mov~xc)D$?
zBZO&Q5P3ABn1%Hj)Ogh^C@e`BF&a?19TyN*p{P`O5i0F-oG$T^JvpRuui~}$aqw{m
zlzvn@eRkw#Yu(H@^cwv-VbEqdvt|&Mizv6U(fwdbkL1i>INJXf#>SBb!t@Cw&GvV&
zRHF9L?n*Qpd=X`HnW1R4Ir-KHfUDsbz6Ok4E9_Eu#m@;RneO?*%b@o9yg=M{xk8A$
z&Hf7guvKKdxpj_f$n>k?$Tmw`Y<OkZH7Uq$j=2&8YRZp?$+JQZx!l>|Z{9#Oi8op`
zZ=7<{D}&3uu?p-DL}P_$QQv!$&BWdJz$UX?NIAz6_m?4UEt8n98a!te+?*F&mPKL!
z>-i&iu<+y9w1Y3WhH)%j>xOG~+58J~|H#<YnuPk;VpsgVC1q*3)MrxcP-og1D+5-P
zB6!`UkxaRSQp$VW-DCMe-Rm6)hMRYbknpFqmtWWFvEHBf!0t4;;`Xptl=M8W%iZ%`
z0gZx73j`-XVCI5kWJOOx^^QCC@1NzWISMwGQ|Qa5Kz)<j8SNhSbvw6(gXhQqKcFaN
z_?mkbn+$xZ-JKNlOK6KmH~%TS%4|?_-QiFOUPOYcTf3nsw_}%c%L{ic9Mm6^L(fZI
zt18NlFjQ|<O6z5<V;w$as#)VD$R?U&IX_N_askoJaS6?_<@&}zR(Xn1l%`nh<t|Ok
zSN7G>JNVqYK3UlJCcFDGmT7<?1(q=lxscp}FLzV@NX+t39o)5WplR@=U7fQ4Vay^d
zz3`czN96R_Nv&`dbOC7DL@PDPEicpmCWenVL8Id`1<-zA84Z7gIx2*ip9ig#OLqB)
zlgtI)P{l_m7R@|RyHYPwnE$%{nXdW<jriSC>F+0|1u(x3TNxhH?`y9o=d_+dZnWYQ
z;tCkuYM1s<bQm&uu7FEjSle1hvmpFPk$jc@p>zJq$xcaOP|5RZFJRBxw0>4_eBsm3
z*{be{RAX@gDKt<c79sdwR8EH<$)r%@(r!kCy_F|H*lTLLI--ElgcBE!6bYpx)Prf7
zT?_H{R8*}Hs)Fv*fw^g%)!#mF-%-z1-K#wHcMtDcWIZ#|++hgIC*_UFT5fxpT9MzV
z7^H_tWbKx&qq}8dN+vdJV&BW;=HB!%Rgu;V={Q3V#4ho_BV)TiPp@edg*}<ZqmYzy
zRu4oK?Mq=bbyZ51ejGnygmj@o_SoOgK@=%oqROV!QMqoY!!C44;6^o6&Vt?d99RIk
zqzLq&qZzjy2gwXu=bTL?6Fs!u0l03_BGq+OVbN~=kQw5T33tL#UN>+=L|SH<!u#`v
z==Hz;vF2Vq`dViv4@W{i=NL=)NAc#u+7^Qya|#(U^;ASy4k4<C)C|RykH<BgfYvYD
zTiE*argw_BGzAL(wXyckA(KhZeBs0o2$ZxDa=G&~mhKyyHdF~C!D~)4<5Oz?BzPna
zGh|z2j3G1kGHJKN@i{oKu&!@*Er@U$mgyzQ`ZKvRRS3wv6qjI%#F1mDx3F#C{XGK$
z&uNs?iu?5=*?AVAv_PdNidjiEvwkW%;YR;L<PIX~r#Tv?+8^&oiHJT=AYGn%KB~s3
z+nX;2wiL^XIX&{UUdQ@$qq2d_%GzJE-H-35BbN|o3E?pViAY<SfYFsJAD5YT+S;*y
zzmjiso66>I^3;CfqFh_rG)kN<(V5U=ay}F*im+exBikGr22&H@<YHZ2HIqK=!YO9Y
zrFz$dtxW$b^Sr=bH(H%V1m%whMt8~AY%<M1tI{3+54hF%Z{blZk*4Sfji)R96<g}M
z&_Vz~K)%1VuR^u>XE1Kc9-8dUd5;m6^+Z2ykl5{EYc9Sh5GoO-J@<A1?d@v}g#o>I
z_L~|cUheMp#yR!X8Q}~&G_0q?X8<IY=T9A2oSmV=X}8GlqXI){BLdcWt*p?)7nauU
zzteJKLKNAk+A}t)mHAGn1GEO*5OmaN_ap08-CQ}&j~f(FxrB`rjgWu{g+3dL(|-is
zaui8$ASsGOwX`xk>IsLh;Y5RRMYD>z#uw+|k_09{z%3uICP2@aR^9VtZF6z5EBIt#
z=5PC5EtVH`+htT{j)g3^e~F!iwBvx_?4$8)ne06i#qII`d5#Oi1Hph-0~#XdSz%oU
z%^s!?%8y)&RGbgj>)N3l+Ql=c>$k|S7T7DS++f0-tSG_Tq$c&B>+xh21A6sL>=M#}
z8SY`iN0%|W?l60c8T$IK>(D*RNAz7@IAR}v-=P2X8S1!P@I(4pM&zePE6zF?Nf+c2
z8Dw@@uL+!&E6K4P7DGoG@w(pOW&(nNKK8iuaWBHO>a}?%_&yR&aTw<zLu9{8v8`k!
zG(`E;TS!-X%8|=3$kutndI+A?elp}|LV6+_a)hcOE|aRHiy^G?j_;YY;YbqnEu{Gq
zmx#0-v)*MN#k8HNsr#H6BlO6`{_Qb$=-1#lp2nKS64GfXWU937+@{rVsxmOGYM|o)
z?=$L>4_gJ$Oe0g}<FN2njk%ivYz*T(Br(&-CAW-trm@4WTGy|J_*gM9y>)#!XM5>X
zVz}O1)yR+xTEx>IHTPsQh}sC$+n#<d=0n<QKNTl6yk2T)$L)s(IBV7Wm-E)?zR7hn
zxP!fIN#>M{&F*E*RPPpPqCV6f_I!#>jkZMTunzg^ZD-%v<TeSYo-r3*y?h$ZkmrE#
zCk2YVg309GPA))B_AIM|f>G!fSNocnT4b`_VZ=>mH5xhxQj5`rLX+`|R^+@PZ~D~b
zBjI_CMm4P1F59}1o)<kA^+P-!FoV*2w3uFi_(=$hsW=S1`LRy(O>(?o*AOU)_S66u
z(z}DaEU-l<GLp7Pc<K@>lCjG13=oNH@F;77Ekw%v2<^}8|8c7@>{nC5!-T{`CP(a9
zzin3V{5$uMAo8g!uJy|fD9We!3|!#k_}f}H(zgp1Mz)Tw-R-rc9f5B^?|f8b03xtf
zz>hU?d~4pRI8q2LX=s_<V<DN)Sb^1CX`f<u*X?BfVX2qZ>>eO`5Oy3L6-8A6S==e)
zy;W>9X6)&^i2vW%^-w8i5RTxbGoN7l<mIvag>U3i-Qpl=?v|}0EJa4pt5~1j{qctY
z*$?-ve-Hh5%|TVlKv*V&xa^4b6yO%{qc1iJ_=zSoX|BCsnwXU{WjCE-=I!1wf<_@z
z4?qch<$f`eIgn80u7as{OSrv#>+dCfJ2DN#04MJ`BQL&g!qk@2`rDm4ha-9@1)9_R
zj4**&3ze*GPQBF%>COwV@KxpZ@?T;ET0fohY#C|aEQj3H4I8jrIZVaD0u#t<K#?l6
zG;;o7JaI}_aAYS0!yErwCbfBh*60wF?O_<%!FlXsG)8rCJYeJqbtYkc*n`@zmoBCa
zHVC(3wt$ycKAXybW${z+^3h6^S;x^j;A`+x%{NTjK)pFaILod&H+Y&gijPs_+^A-z
z{Iij!Xjs_bx}Gw;H1nM3WZfz#I0qV&q|gq`Ri+_vCYGFp*>t)*JuJ6^Rf;~ea8_Lx
zL6PmL8X#A6bh-MZKYoyK3D$~J(rYqjA?{3;<52{SX1x}D4)cb{L25qb&WVRax2!_)
zv?u)t)@U5Ij5tjrn6eu=3;$HAAO;QfC9G--!dQ-98R;E%8f0Q?azVh0xO;D)?*Kh2
zk8}BZ2<|ZT(%2o;2pe>WevN*oP#^CTkqXauySywaSL_3Trdw}tPP96vsx@tRv1oKb
z=Hv(yWb_F~gON{I$w)C50OkVUyqUZqsQb_o@%FkN1zWj0@y#}ldVTl&2VD7{L@Wi)
zry#pXk!oU}4)h0g&OBe7j|L*IF2`^e*k!*-h`R!LsAO%8Eh_{bn4;sQdB1Qdcr~^E
zFaGkt5VK;2#Qy3F(C9S>LkY?GQv!fgu!lN=rj(c+gXV2L&yLhT<!8E&4dN}XpThH<
zgd|;m5WM<^8A?#p0zQ|giwKz#Z7|WPObfEfL1;u?ko2poT_+yz{%rv(qjEa@Y9r~t
zqH2j$|6*}e9lPJ!IP{JI6Z2#xs8zoiw)wN_*MpKHYpsA@#-vKC9s%?`+h`zc8UfPn
zmY>?gRB~>Q9LW56W^Sug@dVIIAY3u+X9*6jRbGI_(!-KGC<Q%3N&kZfNMmx$7Rk%X
zOCwWcIQ?QU<FkWWMhYD^Jcm`Uj!(Q<@05oN67C+_=ki1al#ffV=ktogqc~{+wm!Ua
z<SOy-Ow-F04w*?fpdDuIAevX*<kcIo?n~SQ)-9=F0_Ze~TrAgK$tf>q(AK*d5sSnn
zeE)q7I_b9&($cUQl?@-oornggJB;MDvjg}*=LR}!gFMSS|EGgPpP4jg7kuC48d-eK
z-P=en24cTybQT?r{6PYh!%f+Cc~s29Bw81zj#cmv@Id&`6RRDxmkvQ8O~0EKSSHdr
znT2o{_&~Gz?TG^j9RKP|e4XUHpv+D=QHu2?cLob(TMOw^Bb0b?AkH*s6w!UG?|^Vp
ztWv*9%Xl?VtmXsBg0{tn!l|i>R2+%XjA@TLKbnL5=OS9|Kt99v?4froZB@|}?qL~~
zfF7BrHg|W}z?({BsZN_Sl8Wtgkn&?EOTdZjk_i$uo`BiuX$e&h&Pw)2On)Jgf1<uZ
zZz)d~Bp|5--!jVpfakJNcJr&8Eno70<dA?=1X7eAiF(q?xplF7)}ymriWK@JY_4NF
zB3bCuJ)A8W)EWDn>}0e%q{3NoQ&F1>*<w9*^J4^7dfIZ7F4=KMlFcLiIA;xtO1%~0
zrs4qEdYF`1JFq>UhL!QzNs~QE%Q~ddW+kCt0&Hq==#%)VkYV1>5@PSuG##r#hS*Wv
zDPm`8^7SuMyh}m2n2q_d+Nq{RIvJ=DI(e@N*~HLNBCVqmqZnQ+b@L&0s)-?2%{Q9g
zyv#}WLTpkf5u%dO4R~-D>T&VPTb6Wb53nM$eDF*)wruU<{>SG4$dj;uEh0a1z#BFm
zXDI&HSY}Skx1>xc*kIL_!ATuc&0btQgL2uM<QOw!S4d=0kXGUQb%PoEj-Yor@}xAk
z`a!(;{SZ*A?wHH^jKo4)O;$(R|Fy1{e$2t}BBQ_>v5J>zeaj%)$sF-~Rn7u;v(tm}
zUkAaD&~2k1c<wl@82X7?I;pjwjLD_lC3rFPV7t6cYR|9Ns@4~)SGc4!66s@ISMK4@
zV}AF_E-5R-#fZaC$|YuzGC&4Qi+8H@NDF+SAK{75A3kgg6jB&UJPpl5ib)m&+1E}f
z09p??8kkNa?q6R?YWvBJA{2M#Iv0!ThyqrAcQ$tOWIZm#y0FEHQ7c3i+w-QsB@-hv
zWg3dd=%7(TbYT%L>Q(uIN>=jj{mF2!;(do=@@IKHufxaBOO&e^<^Ft0Rg^fX^l`Wk
z9>utX=4r3SW<P}$sohpGBxlxjG0!d-&=CI7D#FcWn@9}ZvTF`l)0!->Gus9qB`~u_
z=BF-sn5yKzIvir<K;AS^w}IU|&VIsBpoxQw5Kf1ak+ts6Awq2AnI8(n{KcNJ$w`q!
zOP7ZR-$bCxs!7X2WiF5INaZovBZE1sK^?88ax=d1MWTmzV-cCd2?vS1*ifRTL4r0!
z0?=*<{q9WWr>{j$moHioi6@C*c~I-3BdOIo@CZ7=iYg@?VoXrjMfi8}a>LirXqren
zHpLLx31y&fY84-t$`uWf<~x=GPPJeR569v}ei7)+w_K>9c`t&b|JXqfve_f}TlT0n
zMRis|;q^B;IA?3^MBa_6;p9POrARJwzvZO*y{Ds$Au1^MP_c_R?H}%LJK<k^WT_GJ
z@18{<R1!}plPBfXFbq%#Z}wJd0RN47EN377VT5@2N!WP2ibS2KtmC;8b3EWN98E%(
zIMhvEZkN>>Sh!SG{ldoWeyVxOl|Ym|?DS)YhJyofn;AC$ntJj38t!$E*FvTUHwsX<
zk2;IOe=SwjGxDPmoul6D^#3#sJ78x2M^HgvzaZwVTFx$?GH|EFDyv~=ZEwOpwH(=l
z5I9s_?gFqk!Evq1Tej^ZTVLsh*vfzr*kBL&^4$=w>aCdQM%7HCioBu|6oUOr3OoK4
zPC)eLgdE@5qvH1F&OQCAIN-!>fFvrrYg$_k626PiylkWNZv2IT%(12$Ic6{+&iEp!
zQ^`_%tbxh*zC6PO;2!8<;0a29=Tu^Z*nxnzZRY;Qrl3;wL3_jDN!R{J#VKNtpEw0v
zR6p@|tM^2;;h~y6h{QQ&_+8PwSY6TF(LDb*j$Spwv)~>LPPZv6bXCEGokJ$Y!mA))
z@mT4}VkA0$<Z1+83|ucS9Dr#8kve7jlwQ_sG~6pZlB4yIUI!ZM)daj58AaVG3&n-+
z4n;*}Lh632!}4R0;J3|go1788kyAsup^QOTwEl!qet#ndm4qudP){V`^n{uSF3Qpy
zhD4pXh$OUcy7T9oWIRTWBAiKl!lm18Z$*rYHqLC`^rD4v;_T%|r;aFu^(-)Drkzk=
z*KUKUH^DL1h$YFzOd=<x@X^(*+in1dNM}ndA|zf_aCW1-KrR^X7gtvFa}i-u7p!U&
zsL1B^5DC`PxCIJk%9fOA&>7E{&Rn0a9T{8G6V5XKc^{ulvT2pGE$^~1a^CJF__)%>
z{xn`3nxG!G)hs%c<yPpC;Acj9lx4ed#l`-*j~fhuvDUJ*gvMT^0F-^=W`SP&eyj@P
zvYQ)Du{(?QaS2Xp#p}C=RzYNXWzjX~|E-68yIP;wd6qe!I$@9pfX9K*$hBas0ja9Y
zbPwv56?~w7>?<$#gq#69*W8m0Ir}bz4eLU^T{W>d_=Tw#ro&hXB_=gv6Z7I!B!Cv_
zDQOcmZRHk=@V(<tN=?)j)@9H=?;uw;KP+B&M`3<Yedj8+F*iff@qnYZP-l8U)F;j(
z%wa2Phn<h`KeST&#QrJ+DfV)Js6goXH~|}=r)ES8^od3^zp~A8-R|#9iWPVqD4f?8
zy)Ap<&lBRVb(61J8;>~oX9}2RmJ^rF7bo#pY&=85f8#sRhez*>AK`suF4rHe1ZA(1
z$a{gM&c`%T_+l+SvN<tW0ujozG64=P+?xQqv<KcupFILmLSKx~e@}Z-pX-|=2~0hr
zy*21x6FXDShZx4mt<z~xvJuqI2M$Pn+YbPVCwauPJ~5xe<`q;UQAP@oBt7<nT?nuo
z*ga9LbVo|P$f49rPq}yQ5x(fP1HnWGg3+27Dfb>FV}Z&lI;JumjE3NAB{>1r<F+|b
zkq`g{JIGBz>FAew9_6CA)T(<Sj%YQ&qG01sIXT0Lk;#p5n|c#BMSK$BkM2_r3o~)E
zJ)8l)E;Q3t^S;dzgQJ=0|D$48oP>Gu6>DV;=IW&j=^B8`OxV~M<b#VC3|-7_CHHUt
zttI*l8bRGFA^82OvX(_xD%h&)3ztZ-kRn4M0Rm?{X}+U^2p>VQWp^C#`c~_RW8!{G
z7`|KK5r>>YH>E)pz|L0)>@o9b6e5qG%IxS;6AJE8;-XE;1)R@Nq6SRhdFzt}r6N@C
z%6Pb&K?TXv(A1<6;4O{HUCgGM)T<YXK{}1FT4OkP+VCmND|wo|5no!S(o=aA4h&bW
zc*G>1DGn1qD4Fz~%pR%lwdF*j$LB8;c>WOg1=}sFJn<xtTu(YGdT6bIrd;)$-ph~D
zF<|G;Tk;EDmOo7}l7k0a=x+-y#zZ4p|7y04{F(#*N_x=c;>yG_P*c@w2XoDLK~I<$
z4f2SOVHuAde$6KREh=SOR4CDGS3(Gi_c?Ht$uza2?KMo3<ecBuIV5+Y$g9rxoCPix
zVG)myK5A8<S1g9zCjRF`&7D;EH?-f_S@aqrbCjuh3Zy(aGXh4>HG@<e7AgmxXY<YP
ze5LY`zcqQ@72ejM0KIy*H8Fhay#@(ZJK+9?GII7LfRl0uiqf$^*(XA16t%ja?oR<C
z7rLtm6Pa8ybPvkMp&xKz9P@1*f(qiscxz)|x|mkb?2zo$@9Q=SnsisnOcOU`Cp&8_
z`hDbLctQtR_r^Sg${GRIt8><o?DY?p>v+9GCRj&$?3#jGg`sopOq#mHm3kzO84_07
z&)XFouHkpQ2kYR*E1+e4`oWJ>nIZ|iQbQ;qv#?hRp>|FHEYf)Yo|yM}+`csqbtwiX
z9Maj{S3w|&Qx{wy9=o&!p*V>%?FV587`o7-L84&#KlD32Ni)%PtDV9|r2ZkX4SSq0
zg*>9w2>LvFH7+2#gpdJkzSwOXz*g@;9(Npe3k&gM)hQm|^Tt&)U6j3vb~)P<1ODbL
z<(H2C2O8+9$qE!gxN{@*PN8MVU7BQ9$VFUYIf#c-EE`s(2{yjG>&RqcKC|S5)SgnP
z)wg0;u&=4R5x??`QTz;Ts;_ctM}9U6xi$E>M!^T#DuIzb?VuI3fSLlRqLkHOq<#oU
z(@~S8Hqm-_GN;wMAQ;_wb1ED5h&aZOGO516AIe70%!2h=v^Z{MJWyrsL%#$tovLTh
z-qJVZ>?szhZFS=DLa^{sSi(6j*6PD}?Jd0b?B{3AL*#0Umik|++X_e=$&;N?oO|lk
z-##mVtm5>IS&7K1nR6_gQV$W6VdEUw*H{L9BBz9HD4x7bwerc7q5g@>7CdJ+5MW9<
zv+**3z5BDd+U=*uh<jKaC40g)R5#+TP7=vKDjlL#<;3YF-1Gm50TXQJdOc&sZ>c9^
zWDn<3puxytPXQ}uN9I!{#XY7ms)n~lnFi}8)9h}Vg+COX$OI;4LJ0DYJ*rqF?-I|?
z1KHfz5NqELZcncU%Z!?X)C}YGHRBa6U<rR_(CJw6ebU>YA(yt9ZA%56c>_mTr6SR|
zf1APAmHHWDEP&vN5*Ov8eQIS`-jbv{07heB$$y`&%^T-MGP8}568?h8`_ma(?hwuK
z-?>cAc~ZH*D}e*SEWfzv|CDGPVvymrt#j<QEUUY;(`k}jym$s<AfK1d(rE)A1Y2~}
zwi;Kl5*ebq7yB9H*7kqvwotwN%M!YwWYxZcx281o&BOL;8c;F;sOs!r?-Q*@BQ78s
z(ljcL`IQ}kP`!%DL{x8ZgHp&J?J#y(guiiH6`+{-LILyGC?}PO&YKfdrX7l9Eqj}w
zTGA(nheQh5bPTO6B@kgf=7V589g86w_2myBMClm1`7lJIRk~zW2pDFK3?AQu8u<l+
zA(+0p?vu7!=cs3$j5l$@qeSXxs0f3p?DskOCVZhdyb+$Ab`0Oc#jCs;)=~H}{7iwa
zO4bwFTTt;wJX}d4qK7w4agfThQ@^fR#!A<;f1OcJs7*XEU8#5XoRDG0!vs#UUj>qT
zh~rkX4-n@C3O)`^$f?15f%_%fY2bEhzAYC+t2KL2H1#rW5>%-qXW3n0jEg@aM0Lly
z@wFk|s_dbky5lsk*?5&S4CH8xjREJJ8aM=B(hivu9>e5S-twZgvxGBD^)Zrg^Q|xe
z1@k|50A#X}asF+bj%80e)G-ZQ3YE(Cz()DJtB?2boU7>GPA!#qBZNv*<go@rux3Du
znA3tqLxHxVHM?yz2p(I!-P}hqf|Y4Y%3r`2fFAaZXk{{MQ%yDNz}UmWW<Q@a>{*0T
z6`3bhB&|)!IO9g3+1F%W8%?T<zCi1uHA-gH)}D?0*H0~#8<fYKi{QJwFnlbsEb)@)
zdM>_n&Zso5xB2Y$CXc6ePKRQD8Bl4JU>si1(0s3(DVjDeo*j(C13Z(8iMJs{zp#;S
zU-qVwbc@8HELHPbzdKE<$cUoJ!3X^V1+aAqVAdNwj{VeAc!VwMH?Wz0g{sbH>{BYC
z2gfK1iD6(_z=Pv^!~PO=clNkOvilnv)3{J<X~IeEIS0<sK$=3pper`q%BzIZ4wnfM
zX!b2t<i0IpqJ$t9kM*Lik6t0+vcW;Pa#527pe6zJU4AsBItfkwqE4m{dj&lotN_?+
z5u5v53FnE|oVf1Hq?#07ee+1`zy4b$vIaw|hE}uMg?_;+ECuD$r%5&U>V#`6Igh<`
z;c-a+>XB7@oU3QmPIOI%FT=GF1&KK#*2Iej>XO%N3kh{5Yi@$5z?OiMk>R@XZINRd
zxD_hm^wVTgimcxO@^-xBRf+=k<)T>--wIyoPW~dj@BA^jAZ|;{AN$R`CGW8b!uzx6
z$A7adcAFFD1_I%P_o&dIbVLEP)xs>DRq%?OSO5`LSJ@9SKT?T`;Chn)O+(Y?+}1$?
z0@ti>Uy~HpJWCD&9Ph83{c;diX+k*q*)$^H59&+4K@WXM5Z@on@ep4QdUQmKY6c0-
zLox%EfsEe!R(dLWWk`w0-hgi<@^88VCKq?vFW3sdM>c$#F(Cq?t!w*HU0=H=ivVNU
z&nbR5Jm0qfpV2h|v^?xxbYrr+mkz{1f9sb^l}CM_7SWY;140K8pDhj}f+(d`EaG&A
z78*uE7VwtTj!r4HfPjdI5^_smR`hTjxjpvBxRu{T9u)4VT<4qWV^Oq94F>#}IuHf+
zDt*DdX=p7}=3}^#DTs*i3-gZgF;_<=%VJ=ZO`FA@HXX<GxTd{rv&!YbB?JbhFSiMB
z_)zq3@o>AOJd$?TG*`|%nKf2{ftJ1mGAM|`9O4uo_2^dmvzz~-sEju?T>RMOm{;=W
zb;#Fz!nISjZ;0k`u(Dg%*s?@uCZ1VDLs<`xP)&vRB=H1f5piw9U2L_VKpsWU6EA8G
zxY$hl>>iu=Rve{{sTiGv?5`KTvb|TJV)E!^w|I)1AtW`H(lhz+xmTDn#h_9h{HHKr
z?J(QbO~WYH7rE=0i(UUhG-(m}fhCiz)9p(lMHC<$oy^N%`l$+zYuWQMSOtXW!I^}#
zit|CeW4HF9N-4670`HcbsgYRGep$y#jdf+_URl^ci-%Q3>9UeH4Ew%Y&(B2|zZ{dq
zabj18ZWRD3CU*K90f4w(KvcU8zFNewm6?X?D=Uq(zk4jSl(s)j6%yf>QF_=0M+j;%
z@i`EdeR3!iy#T(vuHZL0^KF;&&@mgPhgz#GQ$o(Z&Wv8EIoVl8kgDXo;wLWEhoDMe
zINI#d9^ErK9-?stN_=*pmr$&^(dR~Gnw@PO%UbdoCz3)dVdEE8I{*LxOS5e7CmV|f
zICW7AE^hnV5a`$Rr3W4mETcyGE$A4TUD#ErAyd1z;+8qNNbPVYH@A7?Q>f@ju$(eV
zWne2g<hiQzlgzX0iy@KcJ-Y<6faBPP%p9ylEqp#@<BIKdXKmV|XLiJbjZZqu<df6M
zUuSA}rV%xlac`8TZYZN7A+v64J{!COeZn)Tbp_aFBM~HT-;-<ML#?6G7Qou#5X^+n
zOSEV@GML%xX}mdg%K-0ACP=i(IgO?RLst3(FjQ>Swkc+obN4oe5>PL^REj$b<O+0E
z<BaVdobr}%<q_Aui<0F3dp2>J2?ZGe_5nP~$?LKMU;N3sZj9btzfSM>g0v@$0(7pb
z2O+FNPi5Xbi|eqBwuy8Fj#1Gw)x_zKzgc?XzjvK_0(Sm*9xDQaOSV%ZUL)F2YFVVh
z^j9m2*b#Yry`SSvKleU@91hDSgV@<wHCqfa5ngJ|(5n0dEPZ;AG+%xV#H<c3l?2Fa
zvqf0=56&<w6en&W4l6n+8~6cSFzWFKrCqP+b+gjZMWvAE(>!ky>>+TEw4@jmd(RUf
z^q`%*)ff<NTS(+F{2&W(<56KX1pdTWK!@4vnR~1kt-*RA$SXrC5%Ih6uMDgn0Om(L
zGx>(Pqp8H2zz=$ZzbPK$_p&p*!kUxFo{y0ORH)>++cLO&eZ$eJ8(^+`I(bisGgxt`
zEME^bq}VyApVI!X*qj1_N41@h`^XDX*_YOl1A$F{u1UQeCG%BTUL3u~!Ks=OHXQ}K
zhw?Jn!JDVnKA{(_&M~v?&#C%4HE%y;O=hDEn{#qK-iv;N=1AByDto=8dr-g&*Z)5n
zaN$gyw(Lz%O=ee~HPD%lPs7yzxIErfRfoL0ZnBvKZh703U8Frx&$Fct0@SUali!ae
z|K=RhiAfT}yWg(AQ-n=1?kwC#MJ^84=81=40^Tx^xwWf2BG`3+u6rQvx-ochKx;1v
zI6QF2_GOctN;RYG%&GZ;_fRQP*t|i{#l2!j|31n8`LYx!3~3*eQ5TXsNn-Mt@{YF|
ziP-a1v#hU@nw?v-o^Hs=-Qo?!05~tFvHul%#6I9Dzp+CnZ09$SrY(Vokgt`pKrRyk
zchviUA#hg|FMTW{$YAa^bRGYoq%Ro?%#m*DSvs^c=MkSV8z)+r7BR)f4OveFtaK#Y
zRk_S}GJHJ%LFz#AgAdM^C0ifm)OTi{Z;<6$PfeIrxN$W)ew;@;&2YcU-`+V)36CzQ
z%i%oqj)6}2<vTXgh;ZqFy@O^xUJ7J1yL#6*_)f44!sTdwk9v@g)l0FOjgT_H?G!Qs
zC7+BL7o8+-NTwY!T%frbPj9zeaECM))+JQFnVGGS7x<WJ_Gh0RXx`p9Rp|wXS@?u#
z6;#M&cM1It8HL>7qSLg_(o*Ehdkj|P@GoBB+`#eI89lm9K+ET|Qg$FwJriYN#1w9`
zvCjruhj>>u7HW(u1pg(n>7t(Sf;#?^PgwwpgHjMT&}(3tLywo(fGPGfGtN21A+*IQ
zKT!cX6z~1^+-VZYS!EBm8SJ4MYa^KQ-_G34kT_g8&<m?`4TY*CKQgphTzYV>YUn4a
z8F&vVm<3wR&g2`y4-PFKtc$4;#uRE`yQpAM#HKF}U<V$Yyv?CYkDj#hCw>d_fQ^4E
z${|m+b$Y%$Tto^3AgI2VSj7l$#20%Ls_Yy$Uv$*F6B*$smwUJ05u0$NZ!WKp^K`9n
zoK0SkikYw&{d7j0@|3D;?%}~e+)P3%uu_P@$E}+tWe-Uh{yWB!?JZnh|E2~<ii~iZ
zANELJ8ZqL9?|qWeeAaNH8y0c+4{lP<-%)48Bh~eYy}8$_#5BQbXK`)(ZYa`<ZcKdo
zOO9m`MA^`ZsFxacf+Y}~cwMpMN#>`7S+zZxLb+gn02KIc@}fyp+zw=k<R&MMT#X<r
z^w*yo%1kY~)%UZ;?F9CV^J<JLEgHH;Ik}+^;3@Woc2XJCJo$u96>Wp6sk*x)4$FQ`
z!gvE>b*Z?w{o-vej$KDzGDzb%JkSJ?$!ZMIaz^Ri@F2F@DK|S^qy<f~CFQ=K$lp0(
zh>plku=`>dv~Han!Y_LcAAz{;_3w9#hfia24zytcG+Z$aU2kJIRWgSjlrd*FDB9`h
zDn@UKUwE!d;1QDqe0$J(V9L|EoosuR<!Y9F9}NzyMZR~=%oXRN&Vy!bpq+B1p!IbW
zuvK5~uWTbc9BRyWDUSvH0N*N68&~6Ab)kR?s_-fgk(35HN~L8BRJB-HcbY4H&=D>S
zHE(K$px>Gtc){D#4sNnT-xv#c6#lJr*R6{sPYhw!@?ydo?-F#&Ke%@}3Jc9=1cz`D
z;{AM6)e6E7AvDU8V#@b<2DO*hGgQb#rzb1-&dCiq2Q6M-OFne&0+!Apd!ks(mj&@3
z?8(3~5D{~z*rsngA6rvbLw(C%hU+M%o7*|R;1c`lv^i**5#?GrK|5Mn%rL-yx)V+I
zq_|VAJ0Z-7U1^3%Q*JCk9VBdx!UM!jHBY0iyj90Y(toVZrk~f^`U8{5-3@$t^J1ks
zF*oKUZ|_f{iquytcIQ@A!Ta-KxW=hGxvwL+ydA=iubGD?CEc}|)<l4qASNKR5jd<R
z%-kNM=M@M-U&%b||0V_xviDySe>6SeDHBsUyp^Yy<67}esexxXSTY(oW$*V!gqdY#
zQXeOn0q37NG_X0mI3tC6g6y(MQ-atu1DQo0Vuh%+i{ujI7^>P_^Bm5AYmIY|AKF}l
zXk2n&=d6NgL2_|xO<2b(L5EHi)=1hoiMEnMLK(vQLz;*S>gjYP0=OIB<9+L@x|jpU
zQ++Ldz2tC^WA-uBeoHLN6TIG~ly=0m{4loP?~hPiUZDNnMuORFsyv%8f=XsYFlhZB
zN-K@i3#R+B+lkx^vHd39R&;so1A5`U1Q*;tX?+299>$76urf}v<MYmDL|MET9yQgD
zD0tes@UHUfvLB+o&<kX=P7aiP#zFG@na{Fn2t`4iWl7QGewR$@nyR&+1|_q^)Q)XP
zBmY<h9vQ#u_!6V-@y*xY>$LgTNHYjO>b7A7Q5JJK!z66AJfn;Q;nU5n<|Okn_?1{q
zs%Zyl;#TK<lk<Hi@Wu%Nz+Y7<$cHBt{xBYPg+v=DsW1<wz6ak#M4Z5UAfFd}@AQM5
z2c6eWQ2;GkH=Nl7q#y9os>7W!St<if)JTu6blAhElN31>)vQo*2swJ_c)Ev&Nqp)8
z48{4GkKVN7PwaZly1&%P30_2o>NeUnM2zEez#FRy#ch)2r=U7<v3vp{ep{?126cZ2
z8qU@IeDT!Y7HGXR_tJ0HjSDHiPz*myXDbiRQF@t?HDM83e#)`|rI~mx;p(xGW`->0
zm)q>l7I2{8YCc9bqSZF_5gE6n5BV$YVxW>kK=VPYM0fX>CwDJ9@cJ(HT}j20N-{EI
z9(w9%MNR>=qsP7c9=Sptla7o_A&6}E!g5mNL5|nEk3iaBAMw`F-e`^kk<{&gs;7qW
zQy-`QC&*I<egq$l&kx-^LV0sNkO5rlm3kGa<#P_w)k(P}IE6i1^m8VnS0j`;c+g5o
z-uv|JG_9f);NZdt0*cAdYoPwRBN2N5o)x8MPGZD*M5VAhQYr7{I7m^TBJnJ#o86uN
ztkVNFX9au$m%S5WNOHF<os&lqzI@q0TSqq}Q$5lbEyu;bySNCw3vB8^0SG<0r-^hT
z1jaUq-c1YtbF#zZ-ywyQjVmGGW=9ZS2Nq$p+Pn5<<A=*fSK`cpAC{DkfFraZ=0=+@
z2e7B?L#md$W}V4{-m-j=VAz9coqi&?`MENnEsDQ%2`-(FWIMnBJFRfXkPPJi3CzJ`
zWVX!I3qaC%=0V*OO1G~wmm)oay#6i72BRm-ug{U$Cg@ZQS}F8j@J6`odu~%pZru&%
z5kO^(6^(wyq*S)RvDI><m;q$>=qJH><Yagq=B=VnW{$AfUW3hbHkj4jh1+bJwFon@
zZ&Sy4x4wpoKBQ%`I=T9Dxiky1wAQz*nSJ{EysP;pptrcrDe7QGy<S4{8MUUEAt;fy
zinK)zrm)@9K$+9rqJ35+!TvU{Rh;zdNbD15{jrHvQp8kNiwMo?GMTCv9wQE)nOgo|
zx(fYP+)-g8Rgt7#9-u}J*O)-i2)&`3H<NH{Z*Qv?IIzNXChc3dVLe<P*jHlx{r4=L
zzdW9q(=Ovh^bL=oHKpUO`akBToL?>zUJi(SIo^T7F7gi!_AIG>&|R5<{e$;gt!M|V
zg>Muv3PsIT(RZSjh^q2WZbS+bIJdbZh^8OPi;*>V|KRz6YY4CYQG!1C#uUw3>Af9v
zjb))A;N-VBvjIWbj%o;;{=O?rb12^*Ho5p@7y(XS_A9t3zte3W-F1%_C#zhfF8|By
z;%??zO$S!ToVEJ9D>=;ZtLf4tqhW4X<hIGN0nZTL&k|qUc3Z1hjhFxCj-QEu^9-Rp
zEcnUG{p;S%Vds-F;rc<!xw3@c+p39DY)~yKb6ItvMI_V?D7KIb(2!F7PS(HTEO@YI
zo=zoWdl`(F@4Sxeqr~IK|AcmUV!m=p)gGqrJ}H793}zVA1l?{9MUfz7W6VsPPqx~1
z^w_{XcC-;9!EP6gv>~~$7&)<Y{i@}?w?X}1+r%3WW{bm{x6bYsQt?0c&-4<#X=DOz
z{-w#IQijbMvx=w}z~*+i6&37&06V$qN&A!(h(_>CB?^S{IS6Z@6je>3!o-R3^7M<;
zWTx5ij<p=JER@<wQFE!?W^}n#6r+$A8L4#DA*|TF33!8qT2t_uBxAtv>yUNmbyisA
zsg-+{3z||)I%{o^FKLG>rV8;X(GS|eOrU%WL%#j6YV_nuE~>=o=fgZTACnPoKzWEM
zO5l7cG84!EVF$N{LgjgC>Z7{~2?r{ab1%pcZ;%pia1m}wky0dLE<VObrZU3cwid5Z
z$XxZBJXU&+#FtM^>Tu?Qpv7%H`jeK~4JqsGz*FrY1jqO7t4&d5jeGDfQYl|l>W6Xm
ze;87?%q+dcMb>r#cy|_K?M>#%*n%iJ;em;u1YP91y6GO%dMfOfAcvEg4qe2xJ)z)=
z(Ve|^;ZE%kcyy%Cz+cha@^R`F?=kfCfFGk|EHGQ<9udL|kJJ}_17ygdsBy&;t^*1@
zDo1NBNN?nFfU{X=h}ZwDAu;$$){&7CvTY##h^vQ=U;$R&cqV`c$SCV<kVOSH`JqV!
z_};n5W^tX+;S4S~b*TMu+edz3c)_P;%4U?=8S!nwo4D$nV<imPSR8L}@7SF|5E*9T
zQ!hIvs2vrViPndX8&}36NV1r4a15_{Nu=sdL9O9XgFFo}n9eZm_~=WyxdN6wb)#Py
zg}>Qm_CV)uU-JVnWZ#EX;^4ioqme=+y{sMddcYSxh0Wl~Ob<5gweblw6KyMVyIU-<
zt(EYRCdn5NKsK&X1e!}7mPdg>);pkWDvyskDwG2i1|$<$68{cH_Tp!{-DokXjOC^1
zRy*F_?HdHdAW_1>;*f>EWDsYRQVB&&Un1DiTaqCHAf<(u8}k|`zNnQTkR0FzMZ5%C
zB@ljB8xMwX00?5ke6>C0%LDN-`FgCwCk^=3*mRSC&E;vkii-{pe~D3PJq^`?&Emu8
z#sW6)KD!cI*^yo_sxC3~Vu0sMDltDkQRlHG?g`<tp`W|uOmpv5)ro8vZN{(G0bmnj
z7nA)|7G0ezU{jjhkB7D8d$j^d@5as&*I7D3hsi<U^Yy@#vXTD9=dCH=?Lr&U`oXmd
zH0<a{k<@f_Vhog7ck<jnAH%OfFp;vKGShT#{%q2c(-nV#0NEhw*&n36x~?j|qosQU
zk=BN<i*^)F=%V@aPklG%pPw;|GsT(j(8BDrMMofT;i}o4SSox1K1_ty|G{OAfV2;K
zc?*ozu-wRwa$T@os@uB`KBX~Z3^u-ew3_IyYs}v?KgIRJNcO8$Ga7!Hf7(i+y}oNm
ztr$v|cF1T1Ui-mAN8w?wWi3&qkKS|BZq>l1994E7;+kBdXUVge3kd&UEFw#hm05v%
z+$%f@FiLk#PZ;JTO)%E<AVXkW@qE_zxsjh<2QM&_%0XbPdiC@_ZSW6?A`6v403&fd
zApn$AlnyO03^4<TjoWEmS7*f>C1*3wZWZSR*w@X(;-kvl0t865Cqk3j;kxngu;`}=
zFU!B&alKX9C^+n{=**;&On9kwpBgiKN+<Ph@e9KEcOU2!x<mi9@1bD4FcxkE`k&SI
zVCae*jIVzuk;Qlli(7;vyDr_>ACfJM5foG7Ye2UkOFb4<0o`uJ0L>KLfYenL+&BfI
zJyoRRww6v~xQr!fKdH>GEnNa`fMEvRt+Ggl=0>0JTD;lSlIlS+8cPEn4fchDPH#Ah
z_`*wnWjou-Q=Kf}T@9ug4D8FXZ@d3otKy58c;8(HTZsj;ix3_s;38pMYC|>{_^Uo5
zWiJ;73Vt*If+OJ#y83riS+H;{F2zTRNCuP7uhcXb*@!Bukgy9i^&DoLUX|N4*$QBS
zpN59^xi$0yB<}CIBYg3W7B;?{V>`J&C|T(J^CnBjCQ96EVXhhBV@Cg)qSQH`Svyn*
zuGK^$Hj+C&zIbIu9UtY0@t33#1mYPU9SZ7#2hfd3XPJPoBCb;<rKf|ZR4n%Rz!lvg
zG|}Ei(H^RUC-G}AJv5cV)gZL^V%4f`GRafvz=WCSf4pUZd|o546^x;=fU!xxEP8|S
zwA<3AsqSH&ScPTjdcj1-i?2w%GE-R}tMb548GsRVwVE&ItYI0BWaGToLGz7tfPf;q
zXlJ&?YfV?RdqIyWopYK=>|K9pXK=_xG0*sIZ^+=miuRHJ_(_5PaYcAy^W{w10jO}m
zCwoiz%|ioV_FodoXd@ZDZWU~+3QxORd7B?Ttoyn9&zzt{-YpTYukDWV(nW_7iGB!B
zsA#Q!8gaUX(Mfwgw2Tb4)iqOsiVQ;CkJ#ciSoCn<3-%O6Ovo`K1RmW9Tsc|8Jz{)u
z5tD?&r+b%dIcXTxx9|@f=KT-QRz_YAjJM=}lJQG_S;knnTir~8@*zD<V4N^VsIgkr
zW4)cZQDb`aYPpLhTT!smr@EaDbe*^I76Czm#U1glZtsAc6>=$GS_XQ6jrnT>2r`bm
zmQ6{`;LO=@5C7T2^w0p>{#H<3WsaI38eBpG+&CPL*fRwuGulhQd=WHqm(|J}v7?th
z9i>jJG9e)CZw!>UjBEdH3Sjo(EUA2OC#U0%f}``e!XQ_jHj9O#TXdg=Pp44GbH#*;
zBaJX<xBCB=z445!rJ4MZ5~}qm;O=d_dx?E?GwO(aPleDK4)2?D=f*vA1P=E@4qrM7
zu(3^om0P4HBq|%gvj*QUIU&x?Th~4+*8zaa^(h?IIwcywll21<SOS7G;Nf)H;wY*a
zadd7V4f55h3iXa%`U;gDwLhg*<p%ZYUbHj#(pk=&il97XNJW`Xqx4<~HX#@jqNJVu
z7UMcD^;>6e@(e1gHE=%Bu#zunW5X+bEf%Ah&;^*X7@_rD^)X`}EOPqKq$(@g=8hox
zlPd|(-YkJfB5reSxHFM@*Cy1(bY0KlLARNoC<1?~RE-}@UdT~qYY1>M0||zG$IhU!
zxvyC%CxgGdD!gDEUm&whtVjsDrx?)W2d^|7&`i#zAs1BIwXKXC^(VWM+Imd(Obktj
zJh8$$XdsFbGh^EfPZah^*{@NIh7@Bm0%F9=1E88ZrvT(~Xg;06SApzKU--Q{K98=Y
z%(?Y+1;*gHBKvt^nP%HLy;s@j-O`OWxQQSJk6LW_BgI#VJUV?SjdsAsSYx4D%(Ad+
z!jEU3M_i~9m2uTTC#>~Shru!V21<gN)t~(gPC%Dn;4(mZAY_nx))5!jF>b)sC3<iL
zjs8D5h34F(jkHGYSxwNY`WlruF*POo0)uO%lN4`l<~-OIs+^0qet+=uYp>-7lj>4@
z`4Iwh*a=F;o43@HNP`_Tv@}R))yH5ICPYnneA{{xZh^~7Q3zAZkwmXQ6+xuM9WX-9
z-e^6|EO^hqk?B>3OgX;*oI%>Aop~SS)<RHa!WIc0@L2v_;HYES@*xWLGhcf2&yjv*
zmVBfGHu(L^na-gu^_71W;{;lC9g0Lh=~azVDp2n&EwhEK-D!H=sRxYQIUK9)P<A<x
z3N7Y#$Dm-iB2-#K-r8p0>VcdCQ5_i$HxrEWkkns6x^N71f@(=UhBnO&)MQNC5u*jI
zdgeDbnp-)~Bto%uP=!jZz9>A1ofE$*qF3Q2<1X<UF4Z>gqE8_;P0cCT+|JV30Gj3X
z)NPV$^Y4N@S;8nb5u4n~s=SZ&h=6Q9b!Zv+muhO8CR>rJHO);e7h0Mm{dy5fZQ^tA
zjUs)yGbD#xOuzqqDhzFjc?azspbv))bR&{DIL_vK^VDvpf*OTr6m<fp!^GTh41b3x
ztsbPR)n~k9B+TH%>$c0tlb2iJ4U(_`3-zjh&}=nCHPX&~0LKrpqt@X5`Z4WqOv(%i
zr7cI6(Gef>=uuZHE<YBuI95lVF>1kwaOD;f*7lK;4@<t2BMk}U7J;$mm~DU8RY49i
zX%HHF@r*(Rpro)>0tXb#T(N(E#7C6EaZ$m7<TwhUYNS6Q+Kl1pe8A;@3;;*92ZV8+
zx5kif^!ipkQ`YU!QD1LGgMxTVXU(Tg#2)K4{lRZ3S>EK~u70bU()*8}i#LAoGDtJV
zm5!xlmv5-$e9l0_j@sRoWoMtP2PnyKP<z;vU(SFdsyM+1Tw~WGEP~BSzebRRM~&+O
zwu%3{>H3^Dwg?8unf-vMX6e%&+ckjfrWh?7m}?#0hhBZogDEDyzy&Oka32c@lxMx+
z9K?H~RC7Yqq~JFGhw$<nPl4VLm_u|9_E?aw*CoG|wTjBlR05rSKa^&p*aW8N+)*Jw
zgW9&EPJVo+iFQ7vU3hYV>P|%nWI7|E|7un4LPELyDIA}1R(;4Xlv4lJ7|o|;@zEB^
z{4#=Je9E5EEIV5WkAo7wX^}o9;)$vaTIh!##8Up|CUi{S04`gvX{XyR3!^IxLQT9w
zjVMNMW($A|906zuvi=HlGL#?dKFy%<<U17%M19P#6IechiZ7oKK3INw!$b3@`H7TR
z>qG!DCkl*_ZeYZ1am;1(n>^dciKe7KMljZs=CVwo$y26gg++^H1V`2;D~aeqF1gHq
zbrb`^#d+91qp^vt65!k`L?M@w=2P_RgL*i|pU+y$o-AV-{N&q3F;ojo#mw=fwWgs)
z6@v5D0K899^Okyt*W79-U2y2ei5-L~wE}f&v<QG!RNGP)5}?DWUbm!N7>Y>g;8yj9
zOn_NfDZ8;F9*?g0MeKeOF0>@(L-kF^_6PJc$z^nGS52ZvTz@wQ*H`pH9Nq-%VkRFS
z_yGke#HE_MvCphkd@-89B$$sSj5p!~$FQ1vm82Wl5}no|&sH=(D|<Nbb(HF1>Y(#>
zr3r#rRTP-so*Oqjs92<M{6#76$k)Fd0|RVlx#&cKaxkPJ8$O1aE7;TXbB*vCrfvz4
zBfjqySG%<BeFEvzKW|1&9rmr-{IFSSR(_4p&UPj^JC{&o`%ZQ$M&BUL@ZHfmiHJZQ
zn~&NwE$!w<#4X7^1uy@4-e!;$0HtFo#0-9MQum}ty6-!IGaqkVFS}B$;B!aW6~n`T
z@%OewB$X|ME**&kGF=$`x{ScV9`Dse{i4P1IrOyd(LeK6&Y6zvfh*1Xg7_*RGLVSe
zW|QY5HZnre(yUl>f@4RFZ0~KR+@4I)w}H_<91C$i1~46T(cfe;*^7ON3cgY&bI0!$
zh4KDc(DmI!U*(H|S2$2h@^U5d0fXlJczx^oY!^kJ@1ZMaF)}ZoRU55wG;x)@6;_BK
z_|O$_ooWB*;*tcO-!KLNtP0nbJ<gvH5ldSQbQgW@WvJCzJJeS2DOfdhgV=X=ajG)o
zOya_hv{;ADizxv_$qkiT;8H9nX0T}xctV+sOjr3q@c+&yC3^|lf{;9t&WQ$;l;!IC
zgcUtCxV2TOpGq0;lV3`fC16?S>5XUZ!wxC;U5;Zxq#wpbi-`2@Vd#?6d@QC&;*f|8
z)?jO)ip5xYYkIr-=1WhV`}wGML)|k-m;C_DFG>7QuhWnvkM<VQ08R64qBnPSmGmv{
z_lP5%M35qe`lGP)ZPX7w_Q;!7=g-^Aqdv_6J)WfS{?S__j#&D*e4iP%{LN({7FEqM
zFYAbs%~^5KeYa9f1nraLg830#RsB-1XO&{9=$wr(<AavscIngL+T*<gCrkC81EME#
z&dqkF5pM>e*FZKrwy1!%uvdgf_E%RxF(FE69~p5kG)<ULquy>Z(+S00JzUPvHzQIP
zXK;MGVlcIE{A)N+I3U8Y9%w{CZ0!kNME1L7reYDnb?97WxAU!2UTR2alO?+kgTshf
zXaBea6{N<Z%|#O0Do~3unow%wbw}H>4nov;8=nY_LbyPyDn+`FT<-!v9bSVBLAHXt
zcw?~($S=6-RXJha#)`X?tt{oxE;OY%7C5hXdI0mM@e3vZwa%YoAu5ONu3)au&>uAI
z@cXWIiX~Ppnt7t=ZVDhQ<U-hy%7{pE<Uebx>vag|UVC)w^_Y*)viGR5fX^n>sQuh)
zPVk}|<X<Pqb0(Darv25ILx!2NJf_W4)564)8+bs?r0nYd(?XsI7Pg-|UuBD8y0qW5
zpMF^;aZSyq`W~8%*${2OSFvfI7gy4C$!BRxJz0@$TZYeiG;d=W3M`b>u8U?DhxTlV
zQN-d0DbE8>^_hAF8a`u^m>BOhgm3TGu3UA?-FWEMX+uVB3rWyCMcLrR>S(;GM)s=_
z?se5GdAFKlj-_PTv2^ie(J1uFQqC(GCUQf&#8!LF^{ic=6IsThrsX9uNK!;H%gmO(
z5{_p|!^dX!4l?8osX{l~5TmJ4^pZxh(1oMyKOc-m43$~11D;~yiTCd${>CV2unKeD
zmzkQi4n)Je`+H@_QQz73eM73T7Fq&qVo9qrObpN!xjsZ{9(90Y_M@846S0T!7k-XO
z5Ig_SY=IbfKPKBZ&;t8=+l~c>fCD)y<=G%53}^|9M^Id)O!nqsoC#1k%%Ig@I_sov
zH6bI~+&^-US~65-J+CZC&CJgN{d@(@-6a-WY#(Fk{TGChWt*AUeza^>@MjhhN*+bX
z!eZISZg^N@DeRAjinofw2G-6Wkg6IBa2v!hNABoVv=KZ!T=#0YAwA4je}r@$Z_TIV
zrV{+>Y30ROY0O4{s4F<zvc(r5G)n|+Vzda6($@Ax>j9_a6rElm`=v+-*`C^|sU%DO
zSkjO)K_TeCeBuKPJZ{zotjv~1f}MH*D6T)g=C{K-#@&OoRi8z?kX50Lb>P@%l0?e@
zJh=0!!|evmq5WB<fTHnt6~BASqW&zt*&cWh2;5enrkN^FpMdK29rd^hLe)u=I5+`#
zSIt6!O;r2`C!|aD`%!o-4e2k|H~Sj!l%EP?Iyeq?Ds*amo4sV-T4~@dNPKsrkP9X?
zU0YDBxh(-IdK2KdrtAr){cu|!`EAXM7KcT1CiY>GDVestDk(o08gi8oO=*Nv+O|b^
zZc+t}xScsx=?VixP%DOM5Za7I)gOPIiQ*uki7KUAT<J7%J+d>DY!w6unWYe(kU{s|
zaWg@}-3qv9b`h-JQPJ-rM-4sUf_F96bV)rm#iZH*?!kgYK7*)I6>;V3Sl8i!ip7X9
zTYM@q3pX7#{|w$7eYiqsuh?qblBb71^fAlAh0=Q~pEE=(w;v9*fZXn#t3<p48g<i_
z^+F9~LT>^Qe1uV$D>lhD!Dr07<TH+jkN0)a|M!sKmpejSU>k798(DlPqyd-rnl_jL
z1@~SxVj7KVuAO`9`k4%ozzj|{^q*OlH68ei9pL_7P}`(C*q!hUFf6jk!{9-CVNAtg
zJQz`*cYDIh-@;sQTr*MhCWcHLrE&&V00VNr2-u>-NoH*J<X^h!v_Uk6f<sQ*WRALI
zrC+5@50rjKWj<=4OI!YzP2g}_c5Z0%8aPD_GT&9$HH#1%as>R@Lu0Q+CHdW}Q=yBp
z+}Y=ZI??ucFvq)bsea0>zY-B<Hhd(AaEddwqBsdQ3H>U$eY=I5PN;-TD(`$U6UbFw
z%<H4QfpQd{xj=ynS3u&zgc1ti*UysKqMBZ^su2ghP|p>ed->t_T39qYu7T$moT@(G
z5H6$?SjSRnH;mb<x+ER$6u#JWw;@!iut~YsM69roh1%8*8*&rinyja5FFmp#j8p><
zId+<7ZnDRFUNQ{Hj@XqBpZ%Sqd;B92)PThZyCeivtsrgVZiYVJ6R-d~^Hh4c0vjya
zE5h$=Z=zFBE{)dp^J_X+l{{B;om|$m84vMVcC)`|OegTEpnME@tscO{hAq0xBn!{@
zx(2ks-xy8orP0JZH9!xRDMyC-oTx1F07*c$zr^$2{?+mCTr;q>tVzH|=oC<y@!0_F
zo8BM8-#+UPuutlql4QabzO09D|1O&Af@c-4E-LNG505x3&7Z7^aNtmpN-@BoS4db^
zj?pYoQPQQG<qK69Eor6VWGOH_W@|<`#^rjdV2aS2u~clb0m#p#qIFLaR9W94hH;fl
z(r)T*6KcnJSSSS#-1mH>@q@6rD<6}xg1m28aan?uTd6F#H|M*2QftFfJ48QMioE>d
z`~oJdjdrLn+uQd6<zhzM)wm4oPcP&b#=jqhVIF<CJIB{z+y#f_cHHuO6_bsl$nvoJ
zelYQNLc3<qh$rd4fOTgfjaojf!0%5}H$ZSrHEyLa3vGln*{;6b`WAyPepge!i$IB@
z$aE;f|HyPH7XsS<7=n%HPlhUjlAS6CcxUe6n&BZ=1h4J)BGMnwETSU&|5b_m0o(&p
z{aIZ>3SQ{cE?xW_W%E2p(PM^MkUXh3aBRF%&>s?b^$_VcR}p&W<oM@6<#fz+;kNd$
zpBH`KfUq_Xn0;`T9KR=3zsmtw;y+Jik$lBQQf(*A=ecRUVE6;O{IY~M&#3X+I^O23
z<>|WHUXm(u_!MmB6iPfIz1%j$2-PcbFGb`GnCU9psm5*59B9Emt8axlu5%?Md}#+m
zEv{8}PSKiL)^<E!uneFG!Ea84$SB7R^_fZpR~wk4YG8|Q<7&w$sM{Mt+5~X~^X*yW
zN%Tk{bUi1AL{U6(r3tb^b#J0XcJ>5-<%>Zj*FItN`<zQ&ZL6h8q7vnwI8yMm_c#`k
zbFpw#Clv3)U^7e6Mvuy$Zth4U4(n><|Egz-LhDU~|D~e3$RS^uE<hr10(o`@vT0Qu
z2ZlCboK;GcH~ctzR|)u{QfQ{)66bwRQ)3!DUJi*7Kya$y7FTG0Y6wti>a<V6JT;$6
z(&6uUBKFyd)(xkX_;H$Sj-s`AT6$q;@Q6^042r=1d(pV&FX@DppjK6M1Uxaul8k&}
z>=`3@Z~b^N>;F^F-^%f#d-n<gnoikMxHna1AM^j6)v7^1{PBfl*b*?=74^9H$2a`Q
z)^J*XDd=TXvC?PJ+KM8djWUGIEp(DLQgztiTQN|+qZ?>i;R{$<p;rv@{~@d*pUMc&
zJh%y4qCCZ7VcOc6H&u3x)DnrId_@uKr6MHOvod88hKvF|7EA(CEhc5an}^m4O;qkH
z=u1um2lYy<(Epo%M5q8s_KB8Kg0G0Gcd~k?ZP_&rq{loFKjwsEUbnG{+yH^6q?1Lq
zs_+d7JrnG+$$`9tos&e(28M~MxX{3&6Y8;6pz{WOR{a2gR#reFDT)sUiB5g6ZY!Nq
zl;3OkM9pi=8&dzf{eQ-Y*8Ha6rhX5a$Mj`_0d(fE5b_AtRBzc3o1t%tt0=+RN3ch|
zaBQb7cP>K&2c@)b4Pa)_L!%(yAozYw-~6pcQecV9o)p(dG`xAK>n3a9$WiEJR~+Q&
zyHiPNRy^x5$A3vXYFrPW-gI{{Rr|FT4qaiVODZ`-&+or-FnEk|{;45b@9P8dOM}Sm
z=m#9ff*j9%+;P^VEgSwsPx^!lBl1Wv3Ef4u1U`AJ&$Tlm9P5H?fdUzb(Q_vbxQW{3
z*#9hE3mw#lrc!L>2CN-KG<j^xC?|Ij29&=(Z%V+2P-MpQ)MI@iFdZE;{;2HuT?p3+
zpcCB`tCzmV08o!DVj>uy@okEP`vU|LLiQndxn-?S1Bd&KI0?SpY-_0bAD=lN1_i`n
zcB~c9>l2m3@I|f<PSL#vR*wO*SrJu?@v_wHqItaX2FoID9)l>1%;Ie5x@A?TW$>gK
z!Frn6D%=Jy-l3v>Y_b_S8|HMAxW4p*kb|ej^=&ZMqh96-k0Lrshpt)vq4u>Cx7Q~@
zcxNw;{!Fuxv3rTpd=ZA#j`==n_MCRVue+UC7z$`u11^3A_!w8a4ltVB*A|hw^c4Qu
zw|JkW>PXKNAd1hp&pvak0S&1LEl5I=H~!G(Aqi}}67Jb=o=PN%EP<rl1aONJg>+#J
zh&6Xl3c`$V9+F+Zcv!$J^`;asmVEPbZ)(7`?lI{kJ4Es2&vf3G>{{Wd{VcWejm@A0
zR%~|auB%UPyK}kG9umn12H)88`RB6eo1KCXEF0o^Y*-;vA!oXTt023Qzw&{ZX0myU
z!zYEHMRA`5M;@>l8vzpA16ij^(2#pF**I6{O%`_fpeL{*^*Zx4XZ^eVsnw5NU(}eL
z{7Rw#^%EaJVNcn%b7?0;0hN|vV&B%hQ_}mC(<uD~G+Wp!ZqcO$WO$B14zHo1mdN8m
ze?<`jo0etCMTeCa8Fhrs4q7-t9O~wY%Id-ED=!3jkWcsAUF&5qe{W|zw@tX=Y#3wV
zWX=|5wJ6NI!MPx#n)#0Kdz4)|J?3&j-!B&6wQ?cq+ygBEI?kJl*e2~FgDoJMr~we6
z_~@^28s~fN<Z+EJ$VAM9qfL=-iFGH2zuk<CN(BSOgast8N|IOt@%j_Lrf+JPK&m9@
z+w|8&WtJiaQDVz5;}CYZ)^F56ec<;GD<keHK2DgK-|fQJgM)jzBe7H4k#|$~MYv4X
z32;M-=5R7-XZ&JZNKlcz&QrCB;<%F)MZ}Y&5(JZ<S<_Pn4EYP;Tcee@gbTy3^1vnA
zg7;Ho?|Yzs&8VR{!8FWcZ$4qOUOR<^__2Av$EJ1yIkDBVEdgY>!-kI>a1+X~#>-$4
zoTNes!?z9tau{$kTVh<6yJRh^)VpW)Re3uN&eyg<7O~RMa9PD*L}!9*nSmWr^H)qu
zEM5>`zvQqOy|u_D^-#i=b^W;#dli8Iz;oL)1mXHWCQ^%6lG5&9&Xx`$c&Hb~Q)SW{
z7&J`kT)*+Us8dHpEKXH|cLfcyJN=ix=xQJ17@F(0f&QNkaPck~&)eVo6nGkj4H%m9
zE69;9Il)D#D%j5bvLm>$8z~_aT`k;6=2cNnk@MplA(|GwnP`lc*Y@s^b?j1ekLL*l
z*6J9s_{5p9DPNIoO(0<Fxf0A1LjY`TqJi`wbDl8<y)qp;ro^CW+OH#GM1Nw6uspr?
z+5)D0oK9UOzApBa87V_THHuVxSqf06!QEjsejpS-=uEXia0llphSvSPBNU_^a4qEt
zYg<E-$Bl|oTjWERG_doG!gX*}=pGQR5Rh!5Rf$yiKH6otwn|08Y1it=*-@=-d_!?)
zARh-7ZIgY^8NJfbYQVO<Merf1P!Ck(k7f@1apJ{EQ~j^P9kL$&u<huis!|cHqjt~5
zTE^J~ZY*g}5tu87WMBNKk9IA>iw^t@zD8zsxcoMk8jkX)@bt8}HrKjQ`p)lo5%{Vb
z)k6Yb(90Ief=8<>HACr$C`(fAeJ*{KI(LtN<wg=iu_`vf^h=XI!y|uft*=atEpBE-
z#IrVAJS-3j^@4s5Ip3+h_NN^`K%I$i_}on~RA13+(t`)Df5X5_j<YM5rsToVu8v&A
zkgM1@5{*B-#J8K!_H}?0cNH^*n7SmAkl@DG&O0ChRi%G~LeBnezUr^TB;F_;r%wVr
z5AzD_$s^_bV2Yv=sHot5W``Y<&?))PwNrY*Pk~WKPd+De%ne91&w%m^3yjf_fyCLd
zeVx;@5lzU@L9Wth%(`~ENgHl~=za@!!$QzGvZN_2m<3YPD8z&AfOwi`WEc@5w3Hl=
z9po$wtZWnA-KXQdD}A&;`Q(iUEHj*cQ#?LoUlrxs96U%;izi?c$LvFi=kLXJu5(H9
zvXI2wJ}o@@UDCZX=cBcI^0E2?a0WY)TZ)_l;n38yl(LC5>mk&l7IUiy+Cu9afN|v@
zn6QSvt!pM&`VC1K02_ZFUGK>Z-W>15J%fS8Oo62_kd4xW+gq*1`bFUk6|PZNIMRK&
zuT4Bv0IBr*p=~+nBVlS&+B4{2{`FzK7^M*{`Snxv9S3De%Czo^m@7u@Q&a4Lp?5!d
zq;Iqq5@oV=`{HjcOT&L19|_f)H^<0-IqAg*TnL&E2lI*Z-(+3SQkqVI`In6#uyQi#
zDm#<YPPR@AU+VPJ^v960rMLvMfj&&q=A<*0&9O^no#wz&_th6{$-OU;f+F(VSiBnC
zgFNZw??+pUC)!dKg*PBqcP%lVPGgfaJ`-O4r$%Xj9}S#j^oBb`n!S8-OIQW43YHT2
zInA0-a0hy?C~(Q4YakVm!5Cn?Ap0oGy-Um1oR~|jvXB)S`ug$Im!<dplY>8%CV1^Q
zu>w~KWMid`wOaSUPX6EKc2KrRUh!i+{MwL8=NXHoKioUq)uqp}Bu2Dm6NWBBzc}4m
zGV(I~{Nr|K+xit+x}`rISw*oyu|?*oq4mln<}i6&aHEDyGqROmv2Kdny6lS<*LdxD
z=`d^{Lm=QY$V|1$DPhAw*UPd^1ri5Nyn^|J8~0lA2yEb(fXA9PMF8xGtfn9eeRzRm
zQ)+ot8%%flzUZv;8k2&AN?p;@*a#uo4+a3A^~E7#{eG1cq-tMa1iLqu=;_a0&&XlE
zQ|Dz$B3j2$vKH^e<!<wrA7{<3p}hV}!X&;WY8cfrhtNeSK@fv{t+=*=L+>z&_<zxt
zrPG1Dso{Byd*Jr|EIQwp)Vh>VnnBA$`Pz(>D~e@R5nUgpv@GtuOqG+Rtml}Uwb>#l
zy*1)!^by^Tfj{<=2f$cb$?uGCU(NhWO*Xvk4Yc$gFbb+&@_qTv?;;eN7WhK&b*`Ze
zHl-H^hHPIR^T?hw=gl91(@o?AblL-U>Q}NSUP3I|Gaj5}gfKq=6nKzH-X_oj&1g<>
zkR-a*oRi?1PwdjkGP#iCsWD=!J}r499n(tD3pe!HVJZ8Zv3MbUq6*udvRU>oSJiZc
z*@}pm5&OF^hl>Dj%1YNc!I~FWW-wJ_nKXFIW~lciSu_Ay`jAW@*!?54qC&gGzOm3X
z9dhO^AnBj=LkerlNt<1H+*~%8{*{#Fqk7$*W!_xY*fu3HUXiw%7?#hR<{1d4T&a++
zLTOt;mcTV$TG7gnxYPgWc&IrWVT7xPqgQbyI5nHFucY>NL$cKANG7ATo>3O13nSto
zB+&so`*LNy%B~SRR<8^U@%uZ!{wHPP>_4wbRFASC59Ay(XfZAA`2CoX1tTEqrTZXb
z7BLiKCZ5ST38P(CH-<~*9EKm*j0NH$`qsXl8h(K4{??r}43+m*4ji3pLE&iCD}XBB
z8q$N;f?>)59p)!JjwBi+Tg-AC;XT*LB&emDkqvoI4xbydr~ga+gEtuH#$%9yhEsZC
zWX)zX1@|yvZob9tWc4UmlN(aJA-1$bw+oAf?*&ye$D8MCDHqIH=^VfE%<?K2D_?Fv
z1n`tXJpn<|nAu4+S75?xN<~z`g}##54hDK9_raCHYx-p9-SZj+Q-pToM9H8!Ps(bl
z)MkJHdj_q{Up`1nFQR88tepFblnH|rFanrx*^$(SO!LkCD7+@0kJetE<=bqgdQuk4
z6nwi6JweNAmN}ODNzitN7N}ZIH;!L9ZhuYA0SnNFWYI&|yP5$iY6dNYGsap@b3D`s
zWasSc*0tY#dW|S=McO2>!jNZ9Sp-T%KsQ`k_{}796&Q>F!wz=gnzK#rB4QfOmWAaY
z#2lfm&Flu-jI}B#0}Y5=q=N!5Z$s)CggNC{mi<DK&L{OycWW3THkgqS<8HS{S%X=G
zk;3y7KdX>HZy7ohwV^Q>+oHeeW-ST)gF<MomZV)}3(l1#))G2eWakEY4InG9mDJ}N
z@+|3*!f_nKR^09!3{dyfchbf2))!Pe**<g`()>{k_4KfomBp!)$lbqN&>K)rJO}yR
z-SuO_0kHKWp3ElAp9IZs#?Kn%A@*ybao!O_5nzpud_1b6OT?Pmkd5D>0jSK`*S2}@
zx$!R@h!ukAngV|!sb&jBGrD43csrmWKFL%g2pElBuer|sVg>=cDF!H2|GP3Zc1s1g
zH33RCqXMthCI=EP+4}1+-~JfH`;jw^eoaf34_fkfA+OeUgXL1)lOcBR-lqpCyUzY8
zjdsIOAeW^jIpW!<!>YO}#jvWJ7_y$jN04$D(NxprXtmgW*EX<pHw^JYoFO*q$(NCH
z*(AExy63|02Sup7Mfkl7o{!}?R3R_?#OtlAp$qqE%U#Gy7%xS=mptfU@{TphV+?f3
zSi)|{8|}(<i3KQ~PZj$1(h)Ho4kn2%#)by|)RQ(<iW|K*SMo+RLf$^5zkr;?@^+n2
zktXpb?t3V9pJ14~G(nNl;xVT&3+=#L%##m-HGQjUmd7(-7E0?xPFc!h7y?)vG)5&y
z$SR**Mj^p<&o^C0XJI76URtXv&DiwOwzZ{ji9TfTsl(`KB*=li&v9)<+xOxOI2QXX
zM5NA4;dHo?qERgur<5*Up4u!-r7sswzcg1Hw(zFwTkHHKp@&&WZC?T>7n#wPqyZ#8
z1mw@N2kGIL(>^Q;v_<fg5-<`HuKnH!VHxz$RvrFe4GGX@h%~efIumpjdCV0si#IV7
z2ODbE1!IF^z+<G?D@xQZ0X_*Nt8(o!NcWbpw7T4;(-8<_b2XC`snApV#;f`PjfC1e
zDm~oFb1<P!f<|sX;rz<Z!pDAC6<Y2hq;e}i2`j}*7jY2?5oXLT>10NA?46(Ykkax4
zsbyS`WQ%7F#_RCBnO<kv3GFbs=Qe1yd)}kopH+N^gk0X&fw41+{;pYXYq1j$P_r>*
zt&DLK0KkP`@p^b2fvCl2rnP!=<>Tq`58c=l+G@gU#;{)p^?uQ31f-nB<hND@BLmVu
z(J48J1)(@BDr(RAnGzp;$4A%=;649oTVC@t;xXQ32zGTuyek7QEmLWYgu8RvexWce
zB_&*djrG(eV!15OHZu<vJ)<E*DiJ_|g`U<rThReBM+5I>iwg*X($ZYn5gDR^P%v!N
ze-)2{^bd}7zul>RNT<2`3M7GI)WOx{^6B=Ci4H@_3+Y?3EtYXek=7d+&NZR#qlXq1
zk#KcIm<TiLNasuZpTT+bx}mY$0|r}%sO6p6VOo^ev6^Ck<|J!`V746#hPhUve?PtW
zO1ZQdOV0vaNbJo>JX4TqB$$#q+lm0MQ$h{obt0urNO=;@&<J)qdN(lv^9@VFb3wO|
zU9`Yb{)&XuXEuAKY?@BPc>Nl<k{vE`!ZPX1pc?Zf(oOC`o(tyV-@1Gf5P^$7q>8di
zM{7^D0!e}z{WyLgE0W#_45+YTrbC7r-EuoEZR5<8QqCCZmV1SZ#@<tdlsIKPys#nm
zW^tRz|0ILlS3;PpSzb^KJ{iZfj0&Q%V+;HV!7c!>#OW0Bm=`Tt#=|P#uo+Vj06h8h
zR|0fABhbs{78`=KpNG`KYfl)e|3>#EYcGy|Uk^db<$xK{0=eJ6b}3S>5$VbQ1by|)
z);cf{qjYDw)_>`%#tIh91FN*{^?=1X$t6l3uRb*?Gn+1x56LoFvNNU?OY4Jc_LHUB
zh-imTHf3z>pE+Iab8<cdgvck(_udQ=zPoRqQfea_yJu8`K)Jg-$ngBvX<Z3E<Cx_~
zL+!m-dTLTO1HOmR87VC)fnD@gJ7o6413jN?Yt6H$b6a9=&@-#ddG8QRnJy{Wu`P(X
zJ(RB#F`lhWu8RcER|RXzowMl;!TZUC!WO7`+J+<B&$=pp*MkV}8)NvXOvAXo8x~7T
zhagT-DVNWpDK=E(;lBLps~gkqO75hbN)_du73>F@<{HlZWThutGZ`N4f@q!nb`&~U
z?^sIO&-k5)Z^x2Z)VMgrSC+;%K_@Ui;-|`s(+!6Xctl}PigaYIpGoS)fFe0>qd-0N
z5A+-mzrIG6!L*QHxRaK`8!h<=@=bQdNL5%YjbF*@t%Jdr#@_WmErKl<J$_bz8{NEL
zu_-Lw2E1Oct5}^_z13<OI-C+Y8(_U-Xp!}<q3la)jQ{ZWzB;Rud6kb<gJCU6^?q3O
zp1G-RtpQeI`^m!p;;cy0%?^K@lQE?2$()T;-Cz%;dWwPO@^lT2&!=0+i)2VNm%G}C
zkWFKm!sj40m=buTL8^(JG0hC*-6$5r-2@h<qCB#tYOidkrP%awS+D2ODSNdanGscG
zN36wYPI|P&5PY<l*<s`q)?>yV;8x>>TF_`O7UM4}a>{(p4;(8~#9F0(`hrAiSqN0S
z@dEN1$kN(5cGJj7sf!rkv-9ZUk~U%m?F)O&>vP#W4FF1S^Nk}!lt4Z~J1y@=pzhbO
zexi#`-L|D{4EO9Ir%Q(;5B5`pWYGlkwSN_Qnd>BG+RW?Q_7^DIx&-fr*l1yOMCadh
z=`Q=jCm|INnGi7b=e-AkXXl^DThA_JVXH<(CUY{(gi0tXwNPJm&R1gG)i_ov`F^=<
zo_8j+{SIc>MDf=BK9wQFk@NSu(DrR>;NFi{IC-RAsV(hV`2Ot}#LvCv-1qILUiY#;
zk$Ne%Fvx9n7;?WIRwN=O2mA+1f~f`TA_w9gE9<s@dSe}3bPc_#m_BQV%6;^i(bdgo
z4!qFYhyX4cD~85@=tV>7lqf;GAl9_)sa8HDMMI#cZ>BXOX|a>QlMA8~0d41kBsW^+
zU<aDe=&dd0LtG5vim@Ajs_rS)U1W7O;8O?Gf>PEHbFVbRCE3g<S^}-V%;|{7v^m-Q
z{b5>`u@8^8^Qp^gyCDemP+54eNi1oZt3k8U69K5;;iu5XajksSL;*1d>iYxWbVaEX
zYCUH<LR9d5P~)0z@HyS$ThNhQhb!pf@kR|e+(CqTqORz~nxooyGh$*R=CQt!BthT)
zShZ6jZ!cYs<)A$sluVzJY|1R#{>yZ;Nq%=vhnl#DG~nAsiwjFL2BSRlIjL|7phvv*
zW@aF)A+p_A_z-de+<65y7i99SH1WZg0`@;z>V6P<3_S6NQ?)4eS8xsiihCXTP3HIN
zf@nDq?=Yq|`TEnF-C(LxKDY36H&|)81mNS4OaV%q?GGlzHyL@6Ek{W*A+SR--FMM)
zF#Em-+(Kh=mO_0o&AS2M^<y#!_W|tq<DtA*7A=J|)E{zF+)1CZWOQEmSQV7pOPQgg
z<N!FwFUZ;3r#0TthZby_yryn>hM{dPei&fx7AC_A{)~tW2P2-m#e9TTBnY)^gO7PU
z%IaQsZ6Xph8<P5@P*wT(uY+KmJVL`xs3w9^a~Ys`!t30kzd2YYq+I-kP~D_MU5GO!
zl*jQk>S`rtNImQOeW&9s#0ylA_QfaFW42fA<kGQYj8XUiW=3?Q-%KwQxtX}n?nDam
z)n^$~U@0-)p645*L^XzpRrrZR<>GJyhs+hns&_y19PgT)L7}rI?VBugCbRlW@|s&p
z++enYgpFr)SIR)TkjP5cRidHV%UnlrVMLpXF4O3n|0eD~kr3wB5!MhfE0jhJR|k%%
zR&*;b%oF~TH|x5LnU=GEuz9k!IzcjQ`7pcE*QS4NJR&howo!5pL2`oJnUU5;iP1MU
zeB}2;NjaNpUSJTmx%5@oE>Jk_zI#RxtptZxsdcKk<h>L_F2xToQQiL~sZ9y&GRl#?
zy&zs*bkM|dQRi*k>x+gU2<7NL!1j2r-*}MUC`uWVn6O)7sl4|CrzDOwx^c`4-Z`!9
zsqW42R($5MRPnM`V~S#WU_k|I#6q&Aowi<r^P`#yMk1qO+{i_$>ddbnLrPJSKQpdv
z9XwG9R$d!yz`@~tz|srnl?kshUK98x4i6G)N?K55HQ$%Xv2IHQnWpZX$*#HFpAQt`
z5JWCN92C>Vm*ZxVso!9<lzSDY@Js;){RYxN=iM@c=)6fZPqGF}T5H%AO-W<DS3O*v
zoXw^A@hJC6g^2lM_p_wK&^-?r#)wLOtlM*U1}HceA6%*!Wt#>}UflSp4Yp#ixOFE{
z7#B-(gJ)f>R@5V{b@?5|Uz-Ra+s^K}So6fjfs1cPu`KM6{B-HIB7b0|{S`jGtmR`a
zC4cezTH6NN+hxo9EF}LiLf2o%b9>${eG*(l1wUnR`Ba;R$>GU8XCx`VVLu?9knsr_
z`EpDz@<1znFA2i6%r@Fw$!>T-5}+rjS3Bq`T*Q;QwN@suv70!oiQxRdE`fP#lnLV2
zF)RlECg(NGzq^;$WaqwOMlw3Mr?C2uv`6IV)c5Ea*ou?he)P?DKL``0n)#!@rl6Cb
z**(6fPRSTDA46#MqIibhn4cs6Q<xs{TuEXde5bljE?x36+oYBv@*sHJZkcbok%|rO
zv=<EMnm6#Yw1lo*u&m4eN%$<Tm5<9u9u>Hz5DgM^5xFpR{HY7Y0D1we&wkT14{6^4
z@)y*Q>8o=8qsLDk-8RhFD$1odI}Qm1V*EFt&AfrfkO>IzYlz0Ua%Xg8QxJXEcBnw*
z=_e{(z*?v3R#!O8>8^6_F3|sVDBm%byfEf1DFZn;=icfVcJ}m-j5RPxFh<cDmf=|p
z_zf(RJ@7>7@5&S>{IBex*UAjTGIs!IV=kMw>I3!l&hzjY^m6;`Zad#<K}1ckQ9Lh?
z!4DiYRHX+~OTz@Obw%PudaA!tpOqb9@a)i?l>D%5*zw1v6MO|dG-X+X_w`#uM?UT9
zC%kOQOQnl%a%K_$)VvJ5ME@|55jevU>mL@$o4`DO#v_|+_>1!p$Od_)x2JAY;7EMP
zr}w-{nsZ(TLIlBDje_mid>8v=K%x|pq-Y-9!}9Cj+egT|_?H&hAi(r(z)7q^H_X(e
zL0ELl2+RWt6jDA(e~4TPDI+@r&p8RV&)!yEs=GWc1RDGnXoHMPI>u51SQneUqf?{b
zOc(m$GT3pdw6|=5ze>O`yZ3d0&LRHJ<>Wh5m&eu48wLPB%_Ss$AiYpgzY=h(U#P;9
z5x;IYY(OHQt@sV~R$*KTJQ&Nl5QN<@Th8N<B_t7>L}D~xRtX0C8=cB4$<>Kb%QNpF
zgFfj4uLi$<KTj~9*Eu|K=EE<gG!6+*-3L1R)&-pnc#ht8ZH{A4>mNG+GkE&PG~5}D
zALVqnkdKMTMD%sTd(9$<GSgq<E;Y2L=5y6T$CP|t#=6d%?C;|__Sr%+(%sNNB~Jtk
zUn#yNK^rfS?XNr43^St?581W9uWrfqNX{J`n`3UfvkeckS%y5@CisjmZ4(Iyrv8e5
z)*SS1wJ)X$VC%2WU4w2WcsH785e17Rz>*=Rj0w6~BDz{?c9ji($rX&P%vTks4yY|6
zWtp;QGRwPGDH(%5X?*}6WI1?j%7eD@CAC$Y%~PiAJM(1B75eT*-8m9C-6PML?YBg~
z;u)upoNcHt!xDN!n>;B<f3WDx&{2wREeEIn=V$JhQAmJPvbr>Bu(DMa7yWuf(E}9+
z?EPR6<e2Ljkm+>?-%Z_tn?>aa6p<K+J~Mq0^#!-%y`iGuKT+i8C09HUi2<pWK2<{P
zK()Y2IZ6LSsXmQrH*k4At6f}y>DumzTzBmcLZ}jURh2K!AIat%y>g65tc5+=Z^f=d
zDTi64VaEGCS?{4Ji$^Bg2en4=hrdkfNJYNgNvMMai5_9Cke)L)pRR$o$-<UBSD#*l
z^4rEJ>&7<&jb|1?U~Y!2RowI(3|>d;z>x23<6DXYrmFgWA2}{D#mAH^8R^1y|L!`G
zFbrPY=DTV;(y7@2EN&swSxD35yb+^bjW&|9+*aywhx-x6PC8GfK$ue}StY>dWtF17
zC-dQBY57BXVStj-FIGR%x!e8XG47mB$g&-7i!XEZNa`)+=e%}(Dg#VKb+g(zP+w>o
zvNfNq-&+OJ%BKTH=3Kkk9%Q<t6PxS)Uw1jv{2qi>w<Q0^Afl?R2FrTGcE4xaePZW4
z2pQaW0tgWlI6|~>YwfnPLo|}y1J;%sWpd7vX*aJkip;m88QzcPeYDeeNtD3$qVk^=
zg9}`l-rH4uEl>E5gG`}7AvJ4dVRr$;OIk1uDG-#foMSjc#ry~}!3EP6b=E_8O`gaF
zKrP&X$=L#M`wZ&H$p5BHTP#y1-JLPYIEYv%LpO2ds7Ms){(vH*cEi1vVSf3<?JuH!
zepwz+t<NpsspRvO12+^5k>-R*Ri7Xn-|krhe!Xe*o&2UXYW91xkHHIY$K}JWXx+$}
zU&5LeFI}lP%4VU<F1M*fN8AF~<}&v}x+Oi*A}A}?E7w(#42HgZf_j5HVS1|?!%dx?
z6keku^Ct!SqhGYC<yx|a@d^kFG4I5kvxFb(x9B8x4MCU6$T92_PNMYOA%^)>Gflac
zPgp@eTEGgt>%H;;^(@q8jt=!B`o;4EY$2&l*Q)L51yn7_Xtc$cHOfwA^bgw^3$Fqq
z1!4G@78e|HuMxFzSf=7%y$eVW@q+I09kb{p6>28&Ba)gL7xgSIk6Lm>GN-!CF@D}$
zKAUAVInfbZd^Fuk2;A>q?*wQ68|1JDB6<-iw*pKMiGK|QXoZ(W;!wSiMk;ZpUgV&a
zc&BsiEG1txD)>5(<#aB*KL&c)*aU!(7prU$yX$7tpMIjh=EoTb-mw%96L6nutHilf
zYo9(No*Y25&Yh0nV3hguJ*D?pOk{)v9>NTo<!%X0)IMo9$otWV9{7t^+OQxz6`x&L
znkg>TlhnTM73@;%sDemhzD95RVuvP=D<22rJ>am2xRbMM+9Xf(u0-I6zj*)Bwi*fF
zu2~C6P56pejpGd7ueR7L@2!vQP2@#yxNlwC%OY@?xqBaeaXCyN-8R-Zpn#2Cb6Ya>
zWL9RrzCNcVJsW>NR}o{xl~>21fS1W;#Kz6>k<}TMHO#8?n*(&YHPwefvH!rJta9|7
z$Qe}z2@tY1rK9WBW5WD(#T4q|3Sdn){g`~^ju6nlw{fb9U^hn#m`j&1c>8rHTvy)@
zf}5u^VkDK7=udh1w<tw^FZ=tE7uy!hJ#-a9CQPC|K%<3ZBpSKWhEGOZWv$YD(f3m<
z+ryF$=<z=nq(xfacg#X9vG$jkbwD9qhmp@GBwqDaO6Ek7%r4lhc9f5ruV!CjFzUEf
zQ`_f2_o}?shpT5OwGnuPHQHet?-v@~*iKiS$?#p%90ggWck`H(n3V<XR8aC75KEw=
zS>zpHIsj`m-f_WaX?aw%7e79mi3)!t!oBYi`=Qr78jDLd-EcvrcebkU>yA3L=*PX#
zCZ-u6IPr-$j0lnhtmRj@m8gPZYW3cyG=I%cfJ*lQR<w?>bk&y2aN>@$I(y^T$ohP!
z$@S2x4~mVx8+x+$OFzR*tD#_C2tLXw0^9tvjqJLTRk~z1XJhRj7v>w&Fl+IbIpS$C
zxaLs~lLDGmU1Z^N@4<`=FoE&;1^DKM!fr&YKg6jIjR*Vnm!|;wwst!2Z)XV{)GSnP
z8PvJqW?lOa5>t=y=Ac#v#o0qNS*V>uS5SbQ@R46UC|Z6!Qpm<6Jy3<ap1T1}SEmsc
zA`dSo6(4kIIiINMFxNs8_Vz2=^cJ2y1zK{&mO5NML6$*|p&TEh5E?$1a4NJoRi)*c
z0zzcApK>Du=S}T90{9U`+CR~B0FOYP((u`>C+52V;noXU*6bkTX|ao9N0&4pNcPCC
zOh>yqsHAKxA9y+5I=ubdQt01W6me_w8!w9q_>ECM!(r#05n^&^Ajn>2f8!W)ld=`{
zKHYIeB_o^bPaGrC{ILi_$O<ssoBE3gZkLK+5C{Gep1}jty8wXA;p-E}?IjUl?%3Gl
zGPJ%b<R`sc{rb=dmFKe$MIb$Qj!*|%Pe^;gtErbM2(mKUi<{+q1TwGXFl+Yzhj&`H
z1nQO%EYS(JPcJeh&<0F8b$0<r>8Be<aWpJ_pk&wHH*mLF6(Tb3c<e!34=p0TahY_d
znV+YzRQ)~YLODvO1`OR{wdHrpPWA(>&fj7<MMtUgPS8F3aQYM~OpNAEDNI}ovI`Zm
zVql%s%Ws-U>$0-CM}B2Ff9B_>30*Set(I{X&Baqs*ZFF8dheo~re?lsz7)wTM8N6$
zq)l}Tzd;?4PvP*o+b>&{8h8O+vFCwuyT_L>18Ye{<i@it$b#x`*B_nQ#twFVYBFFi
zoO>O8<U@g(_KNKfEk&cgXr2(tQx}`wHa_O8b!;B9ARoa%OiAQb{*;kxR!Cv<NbEs=
z=3B1?ip+GS%rY-0L4{-RLlk7&xp*61a<OTGcXYFlucQ9y?io`DqVT#Tg4yf5BJ(AD
z1Of08$_7T#PF(73<w-c80sDksJbRp|jJ%x8*IZO5w|DxDK=}gcTg2Vsn8uJ)g=N{l
zZrAs5gFKif?E;Ow=Mo~rFs8P|sO8mhD4sw!IhBzh!4AF(un3y?l}|>w_Tf8WJuSCt
z+%k)GgE9b@@zFu)V(9U%quS7km~!tI-|t+c8m&!EZ=R*KJp$*l4m(EMR&Eb#9W$%y
zn3Zm9V%N3$7M;WTk#iEIxqJ~zr5cyujmV2Y&BiQ#6)n`TllJEb)jf(u3=_-19S_mO
z2`t5&NWE^C?UqAH(?e7&u0Q$M#WemJfQ15w^^Aw3A;D)0X?$&A$_6LQ#z2id@3=9-
zR^|y9ZSx_^b06&zsX!|snH@i;$R-5%eX&YAmm-;GF&)DF(jvr|nsfqL+}#JyOZaaO
zeVmeldnUg7@87hQ8#<AjxyphEMj3%1p=x6`qT@%510oNfga#2a(1V+YNQhkT;=l%t
zuog9tn``uqqh_+Y@vY~%Yxa+WFcLtuPzUdL+^s$Eo*N&yW@w=o{1wI;9GfXoiL+HV
z?k$m({C`xv+AKlhDj&5nc-=3miQRV7**OG1$tw<~ylq7SKmDe2rNi}u<EVeZC;^Q5
z&G9dIUpOQ1=XJTgb;+KcwW&pS5L+uF?vK_?+xY>i0k-^#rQ-oTD{dxT<czPRP@S%%
zWLx9hrEi!1i|=|Cp^cojM9+h~D+!?6;8oH=a_jMEoL8nTeVU4Sh=SJ<PFF*K1d09l
zQ6a$=yN^r5fN(~2C5E0ZVh_!~yRSuLh4*G4n?&YeE>=D?s`xf9#B`MrP0veCiRufv
zYiwEI=drK8Mi@QPdHVULa}qvO!)(t_ge(~aVx5UV8=hWdad6Q0y_p#J`<sg>YkWiD
z_p9f{j9lMHQ`)r*?`2<wl;brkeU^eXhpO&Zh!|HhcJwf4ZZ>RZ@`2^gU17m4*2(aO
zj>o3<>;+q9Cd!Q|fAW55t4@{O9y~aj>fW3!l>i65%BYuG@owc2(#+~*|4fV3Iq%Dc
zXkEZ>BtkMx6;Re0j_yR+Li4SlBU8OJBK!W~(IR%nVGs&c=9g~b#w)Wj^lt*SzG^TQ
zO*3h`t7TW%*dkR;4nvG04XRWIbGA9RzN^DV;UzbXH<4?EK7RzfyvD=r#c4x%Bw*;7
z-PW=6Nb2b6{EvVs(_Z+r9~coJi8MQnPZBH&$u(al2F4-_zV!8vBC@l<R>fAXGLiF;
zh{$V2gnQ1zH;<hh#6<*oK>dXew_jE++>B)2WIL~#+yKO7VfrJGQVeD{WVRtp6eObz
z?0?8=V5i2O=^1lye<!KQ&3tsMucNG{nZmf@QInAA0|f?nTkQOz=g6m`dxA6qh@~mh
zZ@su7O0iL==%v(4LI7gu{&t~@g>Q1EC(PiquA_KUvd)GGJ%4}u1*iq|xs)&1OD0Op
zK*Fc|)hcmsQ4U7Y60{()Cd~vUc7}l#Yde;f_u+#nkhiO7Cv3!jYPepY-YBa0vD3yr
zwX@RC9|Xbzu-Pj~7O(y+WO^*VUwxW!h&6{|^~!GGdbI|Ncq)#k`Lq069NLS2a4P-)
z66-8F!BL?dj8`!C%t{hFxf!xohVb%*-nsvch#)F6(wQti?in27kRRvTy2hJ`yoDM>
zE+|luvjJgkz=l_gMi>J|gG<Nz{0hhIoJoCOl_w@;;jt4CTzMOiDBNS%pqF@^?QaVd
zJHD11uAxF2F>*jnF}ZO_Qh)nd!apq%n;ZNPi}wNNPizklKbMLsYcdqlTjyeLaoPku
z&e`g+%!0SP*Fa1Md%-=TP%Cp7=?!LCWNOv09}=DSf7PVk>_^VW0Kuf0)K+-m>nya%
zfGV;Fs&{X7n7YuZrm+rfBYhIGcn9~5WL`Z{9gsk8qlk7-#xOpt3jC9raxLXFJ#sUE
zH(&l{=+Si0C^g2BCrh4@y9m;h({3W&$_24_E36KMbbydHom#0cM?CnK1MZOqkA25-
z<n1k>|AHU2UJj?``E|$#o#}hy9=}Dvv%r;TBT?uuZ?D|*oh||OLqs;xqo|q)Pt58f
zL#2kA6)_9;RGdZx@d<L*b?*1X5`a(s>pqGptX!;EdBux{ecqE~zp<ZrWZ1+i3G7!k
zmsYe#Wk*I*V*r7V1`vmk=xVVpv-b*RX?ffH=9-^^-K(31>Y-GKg1oDEjgVm$cfWfQ
z_rH^*1nyc*z3z7@F+vs4ZP`HW?O(&JUzxTiaXzx|(3$y`ig|Mf3~`OcvSxD^Sa0|n
z5`$|RUx=VQSJX0<{vBs@uR|dVH*mb-uqY-57TgwR7^hn!YDoPyR9C{~`wXZZ2Wr)=
zswuTc@OChEqV9&SSv}lq?|b=g|7}e1Zw5K+;o4oae@H;AZ>qc=hdwFCW4UXen9w?2
z8r>DYxB3!zY42x~ulg%W>x4<~cen&icVOrPve#V*J0p3+FW!XTl;Q|0v)5E?uJ=5(
zh9qRp?Iy*PW%=2-Ut?4u>j=bkxdcCfOedrMM}+t#pg6#&fTR2^%r;SEA1C5nS(Wp%
zViZKfA%LchB|b1IoLH^q(EA{prk?1KqVbmVKQxdh{QPl+6ri|yr$LT#!U^zbEQ6EF
zkr{2R<EtHtpDEQ)aq){hiH?f*oO5C_!H?WsP5H6U<l#^}_F~9|WrxT&YlFR!>&o^N
zu`>PJjub(s_}2F-pkHJ^*!HL(Vh7nZ(Gix!8lc5jm!^}d2;v|d)_qPIJh4zFgu*5l
zeGa+8V3<aC@L{Rx*V6_awW<o+zacq>KOf|mKyhTYm7mLr#H<u;$aJgp(3?hAPNvSc
ztq;8)bMXuPA3pp}(-7VOw2Vz^<45Phv-c_nwwTJiC5*zk%M;fslyZJgl(^dQa+M>=
zI4~2o>+MRf@4IEhkpcR~+97jI*y<k$cL!y*uTl4{MM~sX-KaAbR#3%WvgSks*r{hK
ztm{YDQ3_K$=^7qO1~QxWlpC@{eV3e%#Vj^Wv9Vm9#$Aq1^2zh2HFRaI%Yr@Q*)>8n
znn=QBoJ?MeaIG%1x*SY<d(^gSuy7dI7(?!d-QZKGgVV8~j6kjfW{TjG`y2sfqa+fb
zrk}j+MaNs!o~fSK?{X9I9*o_HQ80C4=0<Nc<rggE7Vb80KdM=I(4{{rTH_cM;_x)k
zw?)9KI8*8-lv2mIb3^IoUpu7ol_h{-a;F{3hzU?JiV@_Y2SOrVX$MY$Rt1F#tg1o8
zg~_rH($*wS`mewo4io>PGa<4;VaZ>o)9UQQaxiS^9y;kT@wDtYZX16ldd(;zy81;3
zFnE4wR+>h$pG&qq^KapIAlOCfmp}{<)CVy4?7~R`SBVaFuOJ4l@Z2_E?7;8(B-`XD
zJV1E8A1ndoLSMJ&7Frj1lh6yn6f*SE(H#gE5KGuQ>&xlmHrl>`Nl9cgtW-BgbX4O;
z?K#R`D<Gs=;2b#^Z0Wyv{ly`Cr@AHgoROlOQ#N$YA_0Wlti!fpZwN$X7T782C*-7e
zbdjDF<31{IZN_e4NP}LR+y~iL5w2aq8BKi^sMgANw)*W)qIU;9;+VHcj|^vEA0rMQ
zNpF4#z*lc6#>KMccPrScd)nb&ObPErQCz@--Anj5%70-`vI<JU{BxtZWS%bxX9osX
zzk5aKEgD7Nhe|0G(qy-iVfpSeT66lvc#gcAMM%<%5@78O3G1XS%V+4au;9#fZYGx)
z=~&E2ym$-u#XlP$rn@lXj6WsAHVK%sb`8Z{nd;jU3s7pcz63scf5zFEChq<dF5Ya4
zbmTJ>d#nD)q_U<Dch8l#m@Z2&aYvk9c9Z>*3O*olln*j(YTh@|UmC&NlA-D6p$G(-
z_MGuVohgQA>BfcfhL-I|B+X<kJI3@~ER3aM_dxk}Ebmr>)j^^#9U&dXDmam>jf4%u
z(7@xNcA#|vDu1Yg$N=b~^`j9E-)iuYUlJw%l-m!DLX^RsG?L<P5Vy>6Cckn><Pc~W
zcMV_|o`TVsvgsDCycFroReEnFGYW5TPoPRe^}K)&d;x^dxX23MIGS2XY_rP>^O4~Y
zRlEe=L=w;E;c(!&Ed<r<`hY!TOw6lhja~&9c+fQ+PgjxrT!k$wbT$1#DGR8jq&Rff
zfhCjaC6)5M^ap7n{^~3r_IS;j%Q3mNdj-h_v7S;M|LX{4;r%yMV~dch2;{c|{>qVB
z_}W|OTdk-EGrNu;gvK<m3a|<sHVm*bgIf-l&h$Ha6GuJh*6_&g<{n{q8hcKeN}5SP
z@#SvvV3fCQvy@-fOu;9LfjGCbjtD!cqUfL#TRk^YKtl$|QIjqgRL*z(XdV7GjfgN!
z*i%(CE-fW2nb~hXxD@O-;)Qp9P?8f2cQm_$#}S);p@*XncDVe|@alsPCWd6AQXxQ1
zmrjJ4xC``?9&;M^=@zH6^U*%B)g7S3Tz<%1X6$t*NW&jwGOqtLS|k;~X!~ojVy|xc
zOlm~y7g~JUu412GsYZLv@8s>0SQoP7x(vUJp!e#(@ULC+7=fq3^Aoy70m#r$EcIfj
zpR<vOI+3hN*Q~7l)LbmWtps9*ImdYgq6Si_=-7y&`$Du*Q=>5|53x7I(nsya+y-m7
z3;fu|<e{R5n~qc6aNn*n6Ub{4wE@l>xe(Nx+l$Jvj1kk5#Z?#i-{14?-=L5|g;XEk
zY{Zp&qCE5EG<MoMR0)fgiT(2W46jurXb=X~h)KC|{QDmuk$cJWv3CVHFlQ${WHls{
z!x{qr(EbsX&|F(uR62lQMDSmk8yr<Nrgw}BK>5peDxs_keeJu1(|Hi3;yIot$qDC=
zCKXPRl}Wv?$kh^tKUIYog^GC!AFEGAm})|=ZOl~GR={1FUGK5c$Y{nh^yf_INm(d!
zG#tl#5j5mQGyO7RpIhwvj;Lgx>yh`jgiB>Jp}6R6G_DG6#H3*9o7m>Cf`U-Tv!Pbi
z^pNiBV>v786n`+MXq{&lOm@2?&L3x1;dcZL_t*6>%}wNIZ?-;CdLS)Gt;p-73`_J|
z0XPEwD`zZ(g3^gRmDn-YB6ik5d#8ZJ!2RTK*~i~{y!b`{j?;ATt6S5h^eqv5(E?21
zfT@gKeWvEyQqoTp;Ts0Xnp#_#fI_nm@y%30c_ahXZJ>GI&fl#k7v)YR%BXwmhe?(&
zfuo3?SH}B22{6+$e!QbqTe}7lz0S<(u7(th4Xw055yxte=!ggrFGDVC1ps4nj=s(R
zJq?t^l9_0{++I~r?=|_-mw3~au2-tq{JVcrH|3atnikn#c4;7$YsID{XoRgO8Yq9r
z=Zy5xcgHMPgPeQX5X_y?8R~JZ)v1PwKWEhd3`GrX$`f7==zTRCbmM4FB)Qc6%M}Ze
zNR+GzPv1D}yC^L~U;VpUti^X~8(B2JX`IcLHx}ki@c1Y>o@plfA-VeK6ZM`XqY3hU
zgTA-KXX-)u@Wr}c3+fw%_F;&ea(8(BZ_1GRYdMN~0={Iz*ymil?*7X8Q$izvg!#EX
zidFV;RDWKMIL9Kppo0xlelP@PW5Yk%D3vw8FYrx4s)@^XYv$t!sKp>I_gVbZ1Ol2N
zd!hDKyj}DA@)nsGTA}kM?9MM(`7gE1dDHJj^~}9UcsB|^m6zYv?^*j~f}z_sI=`(^
zQSaNfamZy99M~-4muQ_{B=W4dPoAkJ=h>Qezp-_BUr}>Pk8>qmtRO_RPz;zb`Hoi2
zSm}9#4WD7vnn_prDDrL+@58UMoCtbi=}(%2XmHd0H9#up8sa#$XsyC_zy^Wik6_v!
zi~vEUUL=4i{nO!Ys0&Ua2WlSX<WN@XdI3mdI>(!2au~P&6^$u0bFyC|AI55E|I3>s
zaX=$wp-D0{=~8vF)&Y^MAgeytw^Tx%1cu`PKV^f=g+&Gy27Cv~CcQD)l|6a04xpq|
zE*=yz<LBgNUlY9v7@@6r>Ykxq{k6qq^%?9l7RO=rl6w-V<VdZ-I3V4h&7z@K)SyT>
zGX?QlmnX!9&N7V+-g)00`vS`nw(NX`+C1^F3*>sUGT}POGm&1t-Mj4bU^Sw-J{rUV
z{j0^zE^p<ho9$)gOcieIY*eXimFP+u!0b)pALNklEOxh!MYn`|KTeZh2hmpBmp)~R
z5ItwSr2otocv$ltj%1F*<J5`p4oqaa@v7ACt?m}uK?6LDDo9-YW|hD~5I=n1yN*Q#
z@Ok1BVN*H8dMxNCJ?m}Q?6Ld(XGa3Nrbx0yhTm!l%4#N)*|211<l+J-AoV`o(D>;O
zD&(YFce|Gzx!fP_m~$bNJFcE)703^hNEw!wl;(=_cpWPrh{H5Jx<OvLxq>^z#`f74
z{gpSl0c+{=@JQD<e(F?rM<}i*N&!Gv$Y>XuzOon@HU@VFDnvC=qcmG3j8WZYlJ&sL
z>&29}M`J)d;LXQI#pfoWpJJEFT*=kDk0lY>VhYnO?hVI2g2x}GHeZ6VU!Fz>E6^w7
z_nL9hUk8&CJo3vG8;G8#tv6H5e~Lf{seC+AeUmc<!d|;|64a~K%W_<V^72<8Y6h^2
z>X=wWqS_rCRpIecssp#eXJ`SUASseWNucGVY-E!A{KP1B;e~@BsYE9F@}VtQnZmaE
zNlMKP(6mBCAK=ER_pKAM(>jIXD^d3}decrHz3V+apT$ip99eHxrjm!wRc}-dW?16j
zHT;(;k2oVZ;tNVSI&2Q60K^*E0n!EcrASL4`zDH8bj(3*gA{2=ZieIw)+bha(0Vk?
z@H_+FC(7E_ZSXaY5l3q?UpW#l4hB@aDxM+;r0z|ctjEtlT#x*2DmgS4qyJTRPx^jd
zY!8tqw-p^&(8W3pbc<StHni}^Sz}mCg;bx5fCf_z4%O9ad0FvWb{DgPUDM^^#0iM6
zqR2ZW!D2xeMptvOM(8|vN%km~f5=jL299pILKhDTE(uwu(dob;rQ^1%vz`|Xy<$|w
zzSPocY2Nn0Ar?Gkd=x9;byV=J;EDxHPxU#-AY{d+gGg1(5nOiV=6rc$N<GM><NPx1
zUE;NvR#cEMFlwNk2y&l4yda9`Uvml|O24p>Q!_CM)_gb!>Qf=A!qyRx6Xi423@u!Q
zdWU+vf%=bt56>BaU%g5(<BRsx`>2Oy=)Eyx$7Sy!K`Fh|YzxAv*1ieOee-|Tc5=6w
z+PC$ltQGe6y$3Rp|8Vjf(QpADN^=hGEt4QDaoxX`&#En&-olkI&yvynTws@PXR$H;
zfI8};nY)v|Li&*OFRX5jdd{<2wNwjxw&0VNfnr;<#rZYk0C+<u`O(DvsEFZw=PzP5
z;Tz(B)rKD@8}No4f#kCCrLVeOYO>;ekjEYMYqD?E|G#YRrL}agm8`ks^ea`(C&FMy
z>g(%rOnoPY>{#2RhpQd<=I?5jc5)n>b{(&4hDagfUbhbxj6V(sl8$jio0^KjOclZ{
z`~M|{jpN0Pdz&6r-;GB{lj2i7@2tu5$Sl}q^_?kYnN1n3^!}>c7FhyZT9|SMc@pk+
z{ugXE*C~Q@_ed?d?2$SB82X(c$S#;X*)nvD4n4fu(&jFm19e_2I+c{N@(ICm6y!vz
zcR|2FgrrkEj)N<+CP(DSNu95I&&W|&QjFivgiVwfOqgb)Z38=iN+d;WsE>_kXqgCC
z0!08dK+3-wG$~_6NuvH_qjAg>tsM)`?#yI$DQlYnGq?_8xIf;xeOCTqb3RXE7c4+Q
zSVg0F<I$rL_L2)+dUErjmiM~g>gr|PNuvachr3{pK$2ZFZ%f*GC#6_~DYBWPs0|F5
zA=q!#hdQ}P;EG&~Wl6_>r0<d0^SCBOA8;n9XB3@0;<@wJ$_QgVKATnf1DHJ*M3Mw2
zKsqI-uZ#QNpS!Qh7#HA`#pqOW8E6jxXGv8=1o+k~<3>5)Ph#fC_bro;43bSxNBS}!
zXrWzP>_+(vSpV40la!w#pq-lcP=6Oq!eg>DGm^G3G3716CwyjH4L*4y01gVaIo$-3
z%Zx7gq@*rR=D27K`9ESwAC?Jh4UwUH2<G*)CXZQitt49{e-n6!c(?q*aaAN!@^Bb{
zOkWKZ4=|z<22aMQaUTwR@)K)GW=q%z&7!Lm^Y#(eAG0eXVa=^HgH=t45=c}`EtSS;
z@p+?s66!otq&caM?V@PaJQT*^r*}lJy~~16%=~CwsuN1aANMAbC&i^YGY7sL$;DaN
z2cTRI>*EvBaEt{ryFkV(iJ{g!Mc#FfeTUNws&dO~#UF^+2ye}*GJnXfS@P<_VRgB;
zEzOp*Lj{}f-rAroH#moTH7^Nquo;3u#4l=zm86Mz?f!Qlb=zcIO2Ea=za{eeEJ#n!
z>>b?GH4OylpxGiMUL;lm{;(E9)uz1VFS_P8^*hvPh9Y>|So5Kkx$|9fnzvgN_!D?5
zPv_A&UQXSTX?y53j@A<;mdS0{Q18x?F<OADb!D9twk}1rdF%a&&pH~^L;%)9s^UU1
zDzQN$jm@7lBxtYCrh}g^wtt(uNR3it%~^kzK+WM>VmlvM1@lPhHUM!nN{+sNP!Ru0
zEw}SoF3OypuegWNrjCSZ#5c90BWQFGSqKeihdaPOI}N~VqNLn7ZqQRfU(?E?&KBo-
z5u-nWb#%R9^VrXxIvQ0HP<fdWBB}!V3~3_L26e-Nkw)!gZS>aTjDB}7GwTi@5OS+O
z^+#&12(Wc>F*p<)dQIhrvqm|J!)2YgDrqM39Bv?hYnd8>^E!(XlBk`D^$h5WAdf&H
z@m-Kc47`ES9q+!xVmZipv@2SA^q=V_-U5pTe`LcD%Vr+{Ch3r}&|DQtw}gbS>#dd7
zTr-i-DJuhohRu4>1Sl(lx7_I)jCx>-F)fc{&!&dNZ8bTWR?W_5p(U8&jkLImJS#8q
z6u45g=^+SSRuJUX7Gr?aZ!}OpTd&hb)rCZq<futRZmV<<B{p*#g*vx^DYL^lKY_6Q
z!pqoQ99||{&RLXkU4!#-YyaXH$PC}yyWCVOD|RxKW5&;T)FY>~wn;KEy3evDy_y)o
zdWTi(rXhS)@?3sB$cKo_T)MeQ{;JuotUQ?^d6%l0uw3Kh)`nLAJv^yV3feet%?t43
zxE6F`T9rr5X<ER7`baK6d!yN5!~^VmS93O;tGhvb?AZ?0ajx=*X9Dm$<sSA2?VE&}
zSC)L=ZjbAmE=KhguYDHoHfCnBVbo~RqZ@3S_|fK#oT0xBu`_o~iTLWGnY424oo*t<
z4nEtdCt$667^YcYR3a$Bc!8<&ejkePen|<Eo}<PRfx4UY99GC-*Ez!!PNpEGM4J0X
zoMLnf;=uNku0Yt)dHCH>Ra%G#FH7$ZBJD}zWg59Ir-<Nzwn+m{#@(AgVo2<#ALcWB
zAn@B4@^G@>%@Y@OEdIB6b0_9;AZpqKm1z5-=eau#4gSg+qjyFYyPwez+1UN;4oG^8
zY@H`4o2*<8r)rNCRZIY4m;e9T>iM|8zZQwX(MYw>hY;Z9_drRAZw^tr9~5SY=!|Z@
z_gzG9+xJMQy4i<}iR$G+;j-<*W&<wD6-Xv{oNj7e)-bI=IV52C*SitCM9*UBlk0cX
zy5HnM1?zp}fE1Fuw-}u7*sDc8tS$+0&*llhy+(yD>r0l<Uu;*GB2|Iv`Z$5yxeui;
z2LW~Rh=G9Rno6+lf>?Pk<mtiXD!IR6(%mGz#odDl=XZxD9mUDwX~Y8t+b3SEj=|L_
zP8t$#69Yv9uD{uh89+Tol-3+jlRv`|v^yQ6avq%)*1UJs2(DCNc4Xqr1J7N?Kw7ty
zS=80ot3}V+mC;Vn>R<-BNuGAi4*X+xOH+kSdo69s2b~gA&ixM77A9SDLZB!e&|bS(
zncQYtjK;0W-22I`k*u{}Hs|PKpJCa*qd#P&%g-*ME4e;Xa3u<6!7x0<!<Vw9W{9j>
z1ZHElddH|0t4m#1KCEB8iEj)QH#gQ<gsmO3yWsH;RkAvvl^y_s7GO`dwjW-e8$jqL
z>+j&)hwX}Xlz3J7kmYJHlRAE?DI~H;0|M}n!sj0*&TuP5CPPu=%C7M}^#v@F9X{?(
zy`YN<mL;X8Kyg(Fv>|Ee`Z5izW&P{7|51G?a{FU!Zg<!t=h8M6MmOhy;HfA{e}7S+
z$qZYu&!RbNgi@NAi;4%gb1U837xo~#ywd5bE~ue%J-??aUl@%c0WQCWxONniCz#d~
zmyKvv>q?C>S?^(=#B~SFgp;_E=(X<zBBs{vTs3xP_@mPzxAGPcN%wTD{ON<~ETIb~
zOhMp^azW&GxMlE2nRnDjA>L<nou-Xn#$+L#Fkxz-hW^-0F6<BiDWdmhLjZN=93l{s
zj}Fn})EN|OL$uEMoCXXrOxpst{26I|CL91pSi*-0ImbGa-a>C$uhz#&<4RLkE40CZ
zI+NjE^B^v@fX&Kt;PYj*uesA25yo3GVsL>;9R^TbKVY^e#cpd|#Zet$FUZBF^QyHw
z5lJ<vE@5I%jLCoa3%U)`HQ#46_{odNOmfI)RF*+l^fPjna}Qxa1SvR;n|G-~1~0-)
zSl|7v2k%YL8$SG25m|*^nVcl(^56r)pT}w1_5xf!cMmN{;vo6$4S<BkH)+KiFHkj!
z%^g5|CD23JE9LQM9@Aq+y5xtKiE#o#7fEzie{l&A1=`U%5L-0Nn1?1k0=x8l3N7@q
zRu7Wj5zv4p!3bVU!PjejJ0Ge;=D4u=^E6wLu|>6mCT-m}7-LmsI>wf)o<AJ(5c1vK
zNG(6#;PR!Qo(sIS<o|?Wp^RBPq|h$W_Orop1EKf7Q*-f2$B;xn1dx&)1Iw-CmyuOL
zMFDMIJZTlN@4O~MVmWhjtxLRmc&-b0{~c2Yr;SDO8k|+&+dev(2M+VmL{>G`Se(Sr
z>zWu^377R_QXy!uydHO4UQEjS<<F%o$M@fW4}093>|d`PLXS{=Duh2bk(+j$TKL>s
zspwxb2<~hnAHbitI|_Zc`=-XHVT**M9C|ljh?&7RUfQ0+K4o`8eW(e9C-N*^1dVmy
z7GwC1Xmv?)c>&*0cTZweL~3x2)_`dk_?P*c(p-cV;*Ll6$Wir2u^CM?oXiRUYrDb5
zE8le*`gy+ou>48MU{O+%E}7;iItBS=C!IHDgVEuxO|@uNsL=;M`9KbIYh=V)5mc-k
z7VBTVh-0G{bo=tr+hl_-&CXwJ5h+-%vyT>|PmC+ei4aCr60vHE*;A(TxK-iZ^FlRY
zPaKkIcfo;65I-$^U&#}!R?b2|I8esp$;WICSy1?tXncdev9<(Yi%uHb(WEXln4fj=
z9MYK?y<xf2C<W&uY9zQN?DFnt9zIGX5*`YgdIl$LaZudsiWFdx&M4Uy&Fvxd3?urv
zFA=7zC^KWGss;XzR<Ym)O#I%!<O*s!baZy&U^BRSL+(L&nM4+PV6;2<^<|YAGbB{7
zOyM(Iv(ZnmYvsUKWzk{4I04DnbnfrLkI2QaSo9JQF!Ik=E}9@z_#KXHh95mE7up}A
zpH7I8XO4R9wa2JQgs<4F4k=Wj-t>fhtjYQeCF#0R4D2dQ4z^@{Pyb^<&XPO=it`le
z4xUMPdQnfU5YV`d7kuhff%J91&+V+|hIAW(AUdNAQb|Sy%4|`4I7CzC_renRD23*e
zH6i&F%fw-6EC$gYvRn7ws4~)1MRm$<lCM9BJDA*v94a{Sk+neuxB~)hQz|&0*w~3A
zZLzXw8@^EhLGO0fgF()3_BJXuE>6mw=c)l%s)4R((Uhx<quSa42>SknRWB2t(nL-#
z68ie*K><VkYX2${&x>)RMW_^H6aG{Ht|%nIavnRRLx|L_OZ4LoVUg$i@WD*E`I2yQ
z@*=LAK?xgYWZ)<3`G#ak2Ft|MzJkO;mhS8erz`hlhjNlZN?`g(ieerB^Tv{S`$EIw
zYKAk)mK267`cI6S#Y1gCP-FG_H&uplnII-QSukUal7mj|F$WT*z%GvlA24$@h_+_V
zxs%R*4$?Rda7G=7`J4N7VR5y8<=!y0>z~)6tlDayA4@>QI*e%dj+{P22cP%u>fjB4
z2QPhQz&4omKoRYsnW7YrgndoXYF|0M+BWGe$OTtGoHA@4PQ!O&Q}u><_m7n7wfnS8
zjIoL>^k=VVXbb+lZ;cBf?7etOEhvCB7E8ov`<i5oi6+etXy3$7dH#}@`Bg@<I4C#3
zX`k(<#&+Ke>**lpAaVbL3AWcGqQ<8K_D6&=4i@ftDS@v@Pa?i)J)qogG%PjTOu=)f
zfk0n7grS-Va}f2O)}42(NnJiogwI)6PB#e|R2Db6NtK}HTCUvsCN7+iL1wq^?;eIx
z8AugSECg|AJe4~ZF`on%8!s-Y-I=wq2$?__WR&4NnScg#rT}c#=F{zk2k>M0erjg_
z6bSAuT^*}l#i#j{YsaCwD~45=)B{`(OO{lD@nPA^bNPGNeX(E2%$*PLe5CTgVWmDm
z7HtF-VzVvX&2P!${{~BUU}#C)Iz<KP^*5Wm>RIPc#!3Id>&8+P4pX%2(DM8*V?M;g
zb#@WPzrkYEu!e=La&Ou~oKa!>jYzNkAZhKyp2oI%c}!c>!5IM~(wDy;*U<y6*b>4X
z%3dfJH~KuMQo(hr#|4wkcReTeaUiO-I`AGvJtgW-KnbB!>vPp*Qn$S&(D;^0y9-P!
zFyKvTicFHkHIkE5n+q1`q*56Y-~aK`(ieJFKu>I5t`LX6z|vbYn9oO8A9qKJq^Z=j
zSl1z{RMbt`N$Cy71SCUEc_lf9LJmli^apG<tML_Q<yuhW*711D(L1+p>8*a91HC45
zvnIv1c39y>5<8o4nj%q@d<xHar#(aZ{I}JyYU}`znfY`LEi+k@JS<IwoW&<nxE_Rf
zrO=)Z5e0Z%k^JNTChH*FHT<HAKL%{;RbvTI5@0}tnP3Qlv9MWkM)JV(QQo9~YXZzO
zz`6BMF_&c!(~9xI)}R(i6yY2WiBARXyxosWLm&IegB?$q5z(Blco}ls^>_mZi&=*?
zzvR3Wcot#bh{_~wJg>!U8)+h2<pNc%3Sx17+;RejYe&9~DJJJW!vJbUGxEY8%{AnM
z(e*|gW2(<N_N~7x9*5s0Du7M2!!;~K+9~t@q<;|sO3gM+DnbN~_vd~ta>PsuIjG)y
z7tp`aSit=cL_>Z~c}VQsG>Jc^QWAx~e^1$UHEa`he>$94F)T##Dg8_gitT}PfUk3v
z(nl|CWXb<dWViZB(DII1XN{QgK8d1boC~tx+Ft2opF?v#$qyNzraaACs(IXj%VHfC
zWUGn@KwJeGUqg>iyf^-Es8olfEUR0xmQvVGIs_Pd8WK$0B#j8rjwblq#_-4vt9AfQ
z)20or(_|N7h+;(72nTP-DD8qg6Z=p2XVh2i!R4=U&zREr;j@y=&VWAcy?R~T2nW#6
z^U;SvE#)y~X77?k*?wSvy6krt3pMoJ#tbScWnBg|j?E^pVqK*mn!Ix?+($Xk6f!Iu
zxB|Xma|&|#F=z!(wV3;(jI`+9=R;c+Pwt{Ro;;eY4;NO485xc9ewR8MGUx~d3Axzd
z{Ld7NYvzj=L9F&v;>k!(zr=Q;IM(g|q;<iWj44s`fLr&pni-_Z9S!gugQur7DSHUs
zJ=|%m!?E_gn<75L#^v0oZj3kHc4yTc+!p?^jDTa|?`YTRa8Mc^6n070O+e5|@kL9=
ze7imGF=NUQ3XG>-imlt~($K{oXfLCE|AvZK&BvMqs`0WtRp2*jel8B48(VPW3f<&8
zaqHvGHtvl$7AsEK2K&FxmF$aHD#j4DnsCr?AZ0{(mywTQedio0>SvhZD3k_h6O2Z4
z>OUHZX|k$DNqKt!{ksF>DYM6r3w}J+VxCX|UUn&(TCT+~5ksAjm96>oEMPOw-_NZ$
zUZ&8l@=dh6b|olC51;e5vTM?4x;)owD{e~95d+{cOJ2cVNDp}B`l|0T#Q3Kb-Iw0|
zh1g(_f6S1k*#Hm7xvE-femv%YbfSGV%l>a*sYdXLgxyCH2g!Kd)GfSU5o1GBOKAj_
zZR;6vYHZlK(AKyPfiN#ircK->Q%Xn6ooIk3O_y1WLc=>md|u6{HqcHBg*py%2EP4n
z+0#k_z<sEZjdV1o+updw6V1g$fschiblodJ7=_Xnxq9Ev1gnQ?C8U&Z792eK*q9f`
z5*Fhbr<_-y#)8O>gujsbHlZ!6+zaE}jScjJ?swi0*UW)c5aR_tf!p>;&tL_@SP(e<
zlQh>83;1T_m<Bl|BEAVxo!WCY!?K2}zUH)WvVsfbjdv87pND$uoXozi16>*k>e4#0
zgby&wU8+%8tlwFPr{`f4vn_pZ{a2+&Ij~P|fwwfpE3)-|tSZky#(Ur{?%+8iNFB}S
zb4mtfjTBWN&L3S8JCk2TpWL}8{=@V!!VD{X_aEh}vZ;4BXgl_bIm$I?P0p+0XnRQ3
z*p(*7$0WlMh0cUOw1J@&oB^IvSXQ^aj0plg`pr5wHW^noe}5R~ZZkV06l0bM|9><r
zAsA^Vm;AYDZ-)Ap)L(6$iqUIv{Y-CiN$-WQt>V{m06on&?6W?cc8Ewc|FkfnErf~C
zJC@=As?m?!lQy%4_?CmxHJDmY;+vj8UP*fcglLH*Fv0#exk3$Y9I`fao!9rsdC$JK
zkRA{uoCO?O(0^a3cYu8GeAd`>DK^7ozuD93iZ=~h#rQGr;Ir**Z|!d-781A?rf6eC
z(+Ti!50l%^ZG2%`?AZuT)mV|&ZJrm5e1z@nJ2k_hw)l{Yl)@f-Bl4RqjFaFKOdO+e
zwLPwLRbvibb*aJ&!$*-h#vj$XvsxEVA+6|L>$-78vVa#YZjQxZT0;tnVeiagoHa}L
zp1QtXkOYFpVbHH#uT}HFEkzCAMo&V}0o9_b?=6`H5DCbms-{IxEFo4ss`I$nZXepX
z3@B~yTp%LoX4%MiyV~*8zaahDFD}h--PXKa7~1E3@iXiJ-d|1bujk>L!MJ!Z!K~+>
z%KVo}+bsH5+&9>&&dg{&=_<&F)Q5@JZ{-p6tfEBd`46C=F=%9oaj4cPqeme>tAzv>
zHqJ{G;Jm)@7Y(8RUD&6j*6!PRZ6T2RDM^R2^z3hxt5olaazNq%qU3h^er_M8uNj?4
zhEvYNqZ7>T$@2rTFKkZBFEpdTL(jKBa2YRw-MR}|=3)L7qh&a-<WIxIZB{3p()nMZ
zn+MeV2(Dg3XA3-}dpAuWP~G|&t2xPgz~!AGN0)7CEsIe1`!yKjaro)jFx+v8RQd&i
zMfX-ctZA?mpw;kl&df_QQ^W5L4^thKwbHh-c&u_i${!IXo@eO_N>dNE8bCQn#CT+S
z4~$?+yiaEM$>WR-53yU4MB94=N7V7OF?C98ni%lNV3Ra5`_5_q*898nXx?lq4sB)N
zx`jb#z5V6KI^n0m&QLF*??N7291>?ev@osgt!R}QWDMh~m9gA*qa#iA2+;xy8s#9+
z#14_%eZrW*E)NCw{?R4Z$XT71O<FIu*Db@TS<UFPDQNAOBOi`{b=3hX(V7y4WAcjj
zV&?lq4ZfcJ)S0$dyj}ZuA@xGxr<6%|oy^@l%{ddlHftJe+UmjwS?Al|<y$-qDjuhd
zpCZ8{l(g*mV$Xwjaq@I!pQ?vfph2o$D{W>yUf|@#>0F4<!ajwJ@YMi8Hx15FL}Pdj
zwClX2zOj<=f7Q`a@HZ|Ih)<6ktNP(42u)NkJvSzVE&%@Y_T5XfM(f&PW?AnU4MYFz
z7j0*ih)q*^;B{66OdL+OpXn0YOl2Of>1<gtizHu~g2`F&YlpFPV?WPoV|CH`+|9Tt
z;?O}&OAyQ>>}&j+gzt)5jhTg;J@70JwA*?K`%E!<4l1<-yifHjnm7|a+d&oy6uJNH
zv^hjso*xM)OMKPJM>ayk6U?(Q45rW|f+=3KFf*$p=epdwP_b`(0NQ1@h(~R=Psl$(
zOti0?aupv)$WKXfkr1O+Wy*EQxF((;Q5Nj1cv7+7E9v68X5dT3=s}A{z4^xQ6jT#|
zRwwYYb<E_Ujo{K07;n2$rCExf7DPjY)%cLneW20E7EY-tT$KaC8H$-aE4DZlC>K#q
zg+B%@XwFF)G<pbmdxDQjEEQ4opZ?A(O$_xPHIZ;(=c@6dc^K4<R2mJ=LUIqTMSuVx
zjt;7&%Td$6xEQnjVd96F`8+#%n-Av9S051g@l`M7uoH@O4~v-VIUiB4tFY9IfeJ&N
zm?#jWxf@W2SAG{Y?_60Mnveh<%eq*n3>ypW9+tTng&N|Kz4~KX6u5k5Q?SP5OZGnl
zAoYq3Q`_x*`ax+q6v9}{<>{X1&0LA@zEz3$36<sNG3`=`X~9w5XI@JC$4geh_>1J{
z&MBm)!tH>v7*0M3J+G4gxqLj;P~Bb1Q70WL8zmq^;NfpbWRS5x>@Y#>z?5VMy2hpn
zWgN$Ml3W_KU@dJ@4ySUQOwr{86_Z;L&dj9V?_(Zlj@34kU7Do1Y3rFRb>>(Jn={0T
znH|Wv)_%$g6asWn4VgZ)ftcqZLW0QiL8=@!2Zd|f7)tt<b?sCx+Frq?FVPiyoalm9
zh~86SjhEG@Pma9zzzFE>v|T6@08>RaXtMNuy4oAVE_r|L2oyZl<&j+r%>nHRHIB)Y
z3i0<beBq~n>s_ZG8_sHt+J?bEjg#L|R|cd~6e0$?n#h@l-#b4OKPuD!e{j1#nG4?G
zDnB1BV%@t~8jk5LrIc0_(Qc{g02%G&$X*Z`tTh-1F*%!g{}lmb`3qy6kdtvjB=fa3
z_%~wfapg*$lmuhIA;}xwH(al~^=$mhp$|mrVC{(qiKX}7*@DoD&D>WO-YA)Q^vsBn
zCTGnW)751hYgFs9<MTY;#$$25r}eg3f0#evPm(Cs1sbC@oU>axC3?a)mQ2S?LoHV$
zgv_4HARJP-IQgm<&`)U@Z*~07D!K=%&{nK~+f+U(j7?-5h>*uxF<E~dEgI>39KHTd
z+aN*?8Z<SGv0N@|v9;Q(&2p02Gc&gTV<5{A`0<4XVC)|R6>`L@mO^T9CykV+{sm?F
zED8C+1iaiq{@=A-2^T$<u5R$1R<Z=c50+q8c?)(?4fofE0f^%T%M0FggM|*l%%Db$
zb^TQl9|n(hX0=7Ms!X@9iVrP#6%Y<;rmD*G{<THI;~$ow3vB@kXfY+z17lh9R)1YG
zKmZfOg-~1U465*&?X@Lcy6azYAAGePm3(K>g9OU;lR(GlHFIvfHG4VdJeMjj5k~P!
z{@@KBOr>yLpi0Iww%EySA%mSapG;@R);#g~PxhZFk{l%~9<IT1D3c6Xl$<7xT5nth
z0Lmq&N(N*oEW)<RG6~5@<UH(Yv7ud^gtN$?h<grKT-wYyVODkx@H0XH(?=#_zV%#o
zu^>oOE#)h}R<STxNuUXVv%NoFoRec2$Yf)ILH~**{vPT&YK(SLrn6gWF)!(ccjM$s
ztZ=LAMwd~(CCK3v;M=&+zbKfnAn;32Q~>LbQvq-q?NoQa<<WpXCJu-_vVIUWwjp|L
zw(sGX%!I_E`A?~-HHzPE=a3y3i{x7_4aAlz;V3*2s%<UjEJ&NWR&B?5W0xfy+Gr<S
ziG<gc*1jaSuC7Q59rB?%%#s7lX5hk|8p&EZ;=OZTk?3K-b3)u~Ok51v_bymkN1>Rh
z@ClnUe{ZtW4E{`vD<AXq(p?tpY5(R(TtFy+UfReJJ7#JTcA5)}Ahd4C3i2NP`dO{@
zK#Bk`8bi+i%VKSx#1cldLCd=wFfZCSVt}hp4!^<$;kHw3fWf**miKvh?6$GqN#frQ
z?C#?#g1YG)c_Ljem#gC+*)z@390MVZlwHz?uvW1l!-aFh!+wfNfI_Bod*U9qv2<ib
z8#nyYz{%@9&$YWP(~_S)N=sQrOquy^Q3>?R%)heNIZ<7o`w;Q}FizTf$$5u>hO2AP
z=fqn*1&$Y_mAaKUg4qUr#=pr)^RnA_LatBd`Nk4IhMGxwZz&I!XN)|vpWiNwoNAkA
zPobW?`r)zf5kDM1qeD80oz^wUw3gqSaeUIKh1BamB*j3yNX+hc-4mrjzv$H2&99Vo
zcIno5ZPKZW&8eL;{2KIeK87r%ry<crdetzn-~E#a(r(#OOTrU}SZ65Ni0A|k$^UXK
zPlpqzL2QJTfrY)JFpelZ(FrIAP6SaVik;4frM-z|YnLva=NrxX$%O~COa!BPi*b1p
z`$`1|8@>>}<JtpezwpbBESDlnb{7?P@6<thn})o_A6R4Yq&2jSuv#oocF(Z<7sR~3
zzUnY#dm)vDG$@C2G6q;XnYVQlArdMNZN)Q|&#X|lrWM-sjGUVW14wp5w@?#Ys}Nl4
zg~;5RZOKjg+~1H<xI8<P{nW0uNE6u`!(mWQON5+roS;bFM<TOBSW|y6SqPk`Px%Y|
zRN2nkQB?BUH%ZF8;!%(K^8i#x=4gRa{Cn2(5__nXMqPK%+|<TK<l2$UiK81UocM6A
zQLPnnI=UB93Dy9RX%G27i8P>Qcd@_QiSb+^YSyJ?LB1dCEiQYda>0l+q1z--ieH8>
z4|?E#LTT5*rFYr>j5ntaUQ)~~K0lpZ5zI2wch+CjebM&8y{)t9Guw|K|8pqx0LpH0
zwnuPL7zY*1>L|6>o_{;Ds_E+X<v41>6ufybzUf>3(7V5Sy-0*FWA)27g?gO!*psPO
z4w)zViACUydd{xa(KwzGDGbfyuVi7L3c9IAF&ffT<6gqrAp@AarJu+9(oYVz=wwTH
zTOod_g*JHHmk{m*A^4n?{zRDEL<Sw~i-IObtowVE1Eh5F0(QEwy~O2*%+T#ZJ3iEK
z=KfRJ<7Lne<gibtE#oZCW|Q2)7dI?)1kmn6fP@3{l@Eb+aXmLiJsDT(rQkXSqCj+O
zYkL)sg;0y!Y$P^r^g*}rjZ{KsoL5x8cxTmXkaXxA?Q1~*p!|3!ooP1GU-L)p{fc~c
zb+=s{o{Df6rHnIPg!zv|Y6p!_zY`migR_szwvK0b+BD=RI$pj8<!Muvq7Z&oj_Gv$
zg`K~^|73Ly30QJ3ZD^RWy)}WMvU@w1RmgGa7?iT-l$;>0<>KXhubV}?IWRcQeWxO2
z`_j|-I7Wq!*>6jP*)ZpGtmKUPOZbQ1L)2R)oEx}W(rmi041-eY$y;M8XQyv@I5$?b
zO;zJsCTCWO;Xb*j;b7r@fl=Q`-XZsZi&l32^txdfF-eZn(p!>u;Oy77cbAF<sH&zN
z<W6vJ;-80OZx2)kUBK}_@+w27Fwt_QKPS2iDXFqeq5lV84H@fBmvcSM?-BeI`RUWO
z()cec<W@d^v)%)_f)UkV+ct`zOfF--Jl!if#ttR{z*mY}j~mi-LfbnxrxWiTBR}#y
z+q2h#3@S%dt}kxi4muc??NRTYR)3|x7I;ECdWgc2QR@S=yc&fNcAC8s?u(mtglWR4
z%I8NhheqqUBHb<xsJzx;afu}zWry=RH^c-G&rYZ|HhMDnhofkd3f=+2;M3JZfotAf
zU4HW#vqFucZfOkUtmaNi20>!u+moZkf6N&s88{W1m_!hoei$G}Nld-X@Wk-|XJgNl
z#VrTs>Ov#7ss?iJ2QOk)A~b@5X|_Dhrv_Lt;PNTfxC+&|=)JM#hBE{ROgYsyaVBh)
zhqyl}I=N=k;)^P?<uCpv`w7V@xaDl9^7<27+r!XN>p0KIZzI~R<Fi9abu_IoX<<`!
zh_4>LKy(VEegHyFt5e_PzI&edDRCiUOG;tn9Zd+Baca-VOC92}#!t(sGB<>aH|Qa_
z!}D%66l!u)dWvB^))t+!4N}H1rOG$B%~$>vkX$@JB){PReox}fr?v4UMDY5X@GHJm
z69F0>$ziL&aJ~MaOKVQn{}23tY9@vclf#2hcq43ao;oiBRgE001r0tmStUraXL>mA
z;<~a=e3j;hexwV-RpaN_%JEJ=S6s+~rWymP-Q}s31i(SCc&b^?MIbun-?#s1HTlJb
zrO=1*s7pVTb0ljO8jSq3+2*3q?v}q{_D^OId@bOe)x=Bf^E`amab%-Mt*l)*%>?DI
zKNq4!{~%5MMC1YPaG|Q<p+Iwg1j*H8E`s`>op2G%w_V86$*J^8VY}k+*H_Wz26>5k
z5SG(<Kbf&|QWz5D@M|5d`B2ga7@4C{zx{!@FS7QLe}~!8h_Jy318OiWJ4o;79$nv8
z9t==4SBJQ9>oS>9_q<Mk712b7H62})61jj;5~csLYtD6CAzHL(FQM01YmCePL;)Vx
zy}Y5=T1+2kGF4MOA~P=xfJ(7)6yVM;czh_;x^u>+?8SD-mkvgP_;6&64z#|C3<GRU
zWLb@j2SlFI?5ebc&hw8EOlR%`F?x9=l*w-TD=^c}+_Fl(8qvQ>fva+r<p&ZQbP0-F
zg*MD=0?-&fAzU)Wut-xeX99YVLjhc=A!y(eWi@v|{xJ}2ykG?leyJSnr=^#yOkgK~
zokh)Xov_ie)LgG`?xJfZWj20Oo0C=5v_l@7@m*i4zLB{f41Xc9P6biwu!4i1kY_p0
zuUE4HLc1IHY&`IL`(A9#b8d3+msMA|_@3Wf1{rp|1dIgL{Er%hLxxKA=CDGDWf3nE
z!jK~v^)8L@^~KZZBE$}HNZ02*vOP@fmP1(_IJ91tuq@q{?=mMf`K1Yi!o}`Jpt2>(
zzO)#c$3)}Nnu{_~Yy(5Fw@jBBAdM3!@l?)nU$;z&3Ir^Lmn6xlq0yfglY_H6(=7|j
z@z_p1JX$j6tjz=1doqP3d;-oF!wmZ}FJ;97%7^*lE7fQ?N2Pc}-KFG}8!ve+WQj<(
zbjJ3;E?1(@A1aEw-k2ygGspCt<6Q0k<Tl^x5~csRy$tol1LDpCgvIj$=lh1D*Lr#&
z*3^p2FoiZ9PKYUG%ix6#e5I+(DW#{5CMlK&cy7qwQ7sWLO>SA`UAg(Z-zn6pQ~1fD
z0<Mg@7pRY);l3(FEvO#4&hEdyL~Q&nhG-y37DaO)T{1oJpQxkmiH9laMQeXy?lG<{
zt#MeTVDBrJf)5C(QfM~Xxc9s?1}^5bvjRSjp3Q8r)L?o2re~O0#^nS-eg7*`FDH?d
z&?sJ-hEFeiJIUTBw`@3yOKns{WG0TMj@}Tt5n8>v-a31@Gi~~`4IA1nBCiQZ9<NNO
zhdVufce*#ZYkz#(I=r{N!`pB$TUG;!Co_F>i^_CbHOr<2wA@7Q)o7Lxvj0z2G-A2q
zVyl5Kk~6-Ur?X^@a%X=JcB`11FC=N+^1FSc&7IIABQCmKSXqVTO|0+>PI=`H*~`7t
zSpRW4>*wB4mjrEA#7nviuK9d#Q3fK*E`tk+>O=5LC-X&FaCWDYxT%4sw!G{Pg7mD;
z&Y<f<xsg!``*mT%?B|PowL}M7{3^ml1oj-t7?9%nU?w3tf*okIGOB(77=f8j`WBkt
z{CJ)WX`)c)ZNY^Fv#wqp6LuDB@7xDyRPSOSc$fricYZ^L;BK1!Ae$zu>P+}oMrd@-
z*uC|l98=^loc%A(XCJ=!w@H5^21byNkVh8i%PT710vhxR5n;CPwwY$a?#KJz`B;Hd
zPfG;ea4>lIx4EDDH}WLOelo>Z0a5>t*^<VTc+VygbO600#~0W9Vd6^cZlmuu<&b55
z%@Cu5Xo31|9P_Y4HQgqqf+}@OB7cDykbOyV;I^pc2TPI?h4hgJC*XJPnjyVca=ueN
zTjH~x{FUrK5S4V&{`THG-#h&?fBm&6<7)n3;in_ybm2lNT_Sp=%9}mKZpK~qW^ozg
zpCnNT8sI>sk3otQk&IZ=TqIH6V3NXD9ia|Jnh2~Ck03ok*kxK}oQB_373-gKqk!+n
zRe>s1Mb#1Ja<CeLz!H1{&qBfz>CfagRzyld0eegtc$~CakCidOtJ;ui6L9rHtbTMh
zFsf>#Xp4HS1<M^6v`M7WRrp~?_cCm*iRhvck)1{^R$Ldr+!8{>>RKj~gQ%w6dj38s
zzFU##dA-GN<|n}k#4ui1ckMiKwMgzf0=i-BIXqGp|EY9C_xroi9oI1Zh?&MScYIng
z_nk~k$n*>497-!}!;k=kJS{^pJ>mjcH7mH&WWTpLehGMmMA`Je*VzJPOu5`0Cq`OK
zGIyEtcxXFqM!9j^bJZoL_6WY^!ZZC+Z}TQGzs@z~3ogqT-vc|3;4b;OpGprSHt%pr
zm@#yOqv~;!tiL&rH142kV5F3uM(%`%q~uabsaE;uGEksH(ph>P6_T+W+drF3$&4Wi
zut&*g@=h+$I0R>5yYzIYdC*yg*Yl7D7nRisz~&T{JGfq1X6XUN$v2&;V}Tk|;rno<
zU652=`%1*$R)_0VH1k>^-ATDUHn*u@+OQFg3m2@zi3`UC8ZA|g#jQKP06DZF72+-1
zpU7p;9$8wzsbfm6#3!QsBl`6`i250mIF=IY+WfKQs_fr~=go+zGc({gf~B&1=1J|?
zqn06FmSD6<VmbW3Gq~p6Ygb$N(wBa9U&>T!<*$lUGv&Apo(s)fjEnho_gdgD@S{IU
z%vB8U07r~FQu*2@6FA3d2ZfaP-b;p!`r6Nt&`E~cE^IY^0`n=p918(*vwc|t93g`o
zTEKB0Q8nI3>1)D^<vKq>G3m39)dr59H?#|9jC!zhW%MU-wk2EJ49->7XNRx4IL|BN
zIk3x6oLJvq@=~N1<hn7Z{q;d&XG}_%s3s1jGX6u8<WylkQB01jkRKy}p-uO*5212q
z>ZBB7`e<qjsq^YBD@!_9uP@P8gn#wsUnvR_J9SolL$k$#kdPv5^f%!OSmpVD=6A*G
zPs^$na<c5~IH4<SU&hQwL-2L*XD}1aW*Y;kC3IO{n|thAhvBs_nT;g4$VIH$R=uYG
z-AUF`8gW8pcVB~6z0uW5_h{SKL-q5EU?%Hs+emfGKxr;ir1wE`cjrmod$*+1%((W*
z(vqhTLG3MRz}p$}*Xh%rv#$V6loxxqf7j5J5ScZJQDZvG4a_O!gLtd&r7p)BWi;2L
zTrX38+$IFA6_h0-F*Fr{SWlAKu>Dk2bW>o{j_6EJ_{W(JJ#bjjQgY?^7j4G*T_l;d
za=WCpvVyo`x@6`fbKJ)N61>Y2lJ;W7&pndB2d^MpKOCH%^9i{+@hf<vku~7uzLmvP
z{+jiGKSy%*tCimgZ<(vxx?4n{`|#SYp!lqPg;aky1%}sGu(9QxW=Xp&teFY0Lhnfb
z11#2AOpUVmbQ$%XrzvhQT`O9JZ-^&o?c3R_DZ+5xANoP+E0jy7up*S^E|&Nx-Ak#M
z)EF~mW4cAMOJ^mt;w=f>Qb?;D+q>q4p2CRkb?xAfY~?-?o2zC{3rbVXY7-{nMZpMX
z9QJ9?=`H7&0&cg+jQV>F0%6`H51_T{`W4m{Uw#(2k$|!d?3(0;!7FAgIM?-X(2|!Y
zS?eNIwLYz9cktoR1Cqm3^CnT5^m%l31EY*G>>{ctn)!tuAnpL-0QwTA9!{ho=8@+D
zWhh2;L&G8Gw@`+l(C;DymTtXWtO@tE#GLzXRj1#c$ilg5Hqx@2q(}I&F%P_yJ=P0<
zGhJMvlYMo3I4=Z68)NShGe&OmtGCH;mO~}Kp9bNM8^;2rHj0z*zsve}nQMD-?O2-G
zzp-o)M^dThRg5`lkBCAxhc*`3fATKT(Z<xgalSzpzkt%ICJxf6F9^)071MAX8x>WB
ziaeY#qWGi~r8-L#e+@))P5QD+QR^n#v)Xpnt_7e9AM5fyL4oHe$@eLyzNS4EQSewl
zusCnMFNMeaKbTawx_(lD@|Yh|vP2|w;rk<#VjUM%zTjQT*SWV|maEc+Y~ggSR|pOg
zKSg#3oq(3>UL`fLpgq9(KhSuWNODs|kwt!OlBi2vu?Hf{82#tk+$Jdi{Uy2}5G9hb
zui~>4Eg&DSWAb2^0EUEZXH3|8x%hbh@*wwVt8yl1<VXg_;}_zfia}s5bT35u7MHZJ
z>m-DZenP-Sf&9B_NRG#HMvr0#nS1p(d!8*HLs;Pu%fE3JJ!1O2fHS<Z2uqvAD(GQ_
z3X93t|IFZ(u)KfhwR^r8a)nN4;3H|9v9RQWE!V+1zNh9k{IL8Y{rkJplYKtv-6N)*
zw&yU_)sg#}3N;+F8vEw@OuIx!v<y>fQ3F#6aPq9=C6r}pE1+bd5puZjC8r(r$nJMM
z1f$gyOUK+k+_mOi#zwuU<)k2Ijit!L<So+uhV;<H@p^Nn-7x<>*e#oc0#zJYmF*a)
zIaI|IL^k-g`9b2$^0sxhNTpZQcYL6PA9N-i@-FW$>M>6(W+o}f&uNYz2D`iQVO9n4
z&5g7L>j4Wgvj{X^WPodIGEgHnZ-Ny&PZW0H2qw;{hmB~>BsMGt>Xu4>T1Z|+H#~p_
zhjE!hXK)3$(6B*}UhFG;NMiUj1>zGBepm1-w*6XIt<MGjU4Jwkt$$Rc`<UX1a4u85
zGb93R6$T3{ha4)TT0`Mg>WY{(oHt=KFnrn8<Oe*;W9|_l|Fh6&OFpdImDUSxJ(Y@~
z_E=F9y}oR7M4H9~i&`$XObIc$<Q*b@xcm)m-a|RIvP^yp9d_P<AG1AIWqG1T?DVt(
z-2_JJ)`D6Kb@S3|YKj-6T65|gC8nK@ZvAW?^pxP|(&c8xh;q1XQRyAx{IFJ|v@3d0
z1hH$hgw7l?eR92Lh^uM5s-Dqfy*mn$hI=Y#)5hK900_LK)g*MdjlaKqFtz)HTx_sC
zDC{<1v7NP@RW5}MJQ6#-MI$eU7h-iqjq8Zhk`eE}968UhQ!_8Sh`-P{*h44(G^JZO
zo4iUx?14AY$mG@G@G{OvN+GB(l0d)p^3a~k$Tn~1H~q`wy!s*)fz!lbZHqVT!ii<r
z`cW(<%E8%PP6k-3mT$)n2t!L_NGql~p~U=XZuNh}N-Mh6n?TN6Yr}t0i8~Q#5Ms|p
z<BqIVqb7asVM04D*(eH#p0|#-1AlJCeunPH^x>~<gFSzZ%m1;gQ39Gz5FLfmllSgp
zCe`WU8=$NdQF-Ly$7-GG6~|v<Mx;}C$hbNLz!~i!?}AyV!fN>({VYVZ`IfG|v5X_I
z6Do%IIvp5X*i0WPXV@{>-)dr=&r#zyAi4V{E8{WMOnElfjQ@gQgC@{Sm~BK0BCO(h
z?L*1Lo~s=}u0pjWqU?`QC<xz;rl*C33fy|l%FBf|wLte=i^!R9Y@_)iU?_`}CBfJ3
zX`JB(9ZjuT<801=-XF?SR(wQ~PvRd>8mq<%Nxe4BwGR>8oD+c-2V;oE-<`9UBkvIx
z;WT^MxVie^vA51^ch_rdorg)bd<kV0b@4dz+H%;Ti`V*s*p(CzKOaXOo1*>cJ;7&9
zI2TQ0rKl|4?GEW*>`i}I#A36f_*1SGRDXE+3hBIf4xw+w!L(!)_fpjYVb_p{;Imrg
z8TKbp{E%@G!?{8V?RTT8|C?5hxjYjbbrgz!m|1Zk5XgYb0KSQx(qxP$jcdZnwoJE8
z9#ly2;@csg{|#=zchd154kEF~Hi}O#y2x-KL9!K>cXjk#I}^Y;ol17s>Y~Y8S5!to
z2fG&EoNm}X28`D#>$jxM_yHX^zckDJ2RrYWw|-{*wAcj`qKV&O!Gw^NMnL4SKJXu8
z;BzIejDGKuU0Tobx3lCruZNV3EtsSMT$y8q^6;1&e7grujS%K)vOqTRnow`Q-U?%b
z^uWiUP(UDiaXk#iBd}06kUKFNz=yR)JvLCA@ZVdYqt~C(LXRtytx+n<zlB$VLFK_w
zHK3LXKVGQ5uybuYYX9-H!=Sqxrr6E6vlUr`U^MR=Wr>Zyri)TSU+vovEyn>h;qh?C
zIs{~1^EFO5h`eY8;}Iur0{y}Ym*r{-wUu&MX3qLG{IwzN=hUm@_(!Wdl_fbrH&izt
zGsZr!g)J9uw3v3np;!L6oQ@wq=juD5l~Xzl-m_palR@ImOg_!fn5lb>JG3SN4~t6T
zYCxf)H4{+YRBN%7K&u892u4y&yOMqA1@HcE!3jHG503oS(?+}H0A6ybEoOfF8XqYP
z1`g#;m+qH4fmy>fM^emWHbJaj0!HXKD(?N{E!5cwK|r&uK)N9VId_;0?!&D2EL3TD
zk4EEW>RB*sCCQ0*qFru3J<kY^_NU3jgQx`3Z9y@%o_dYz89_ObsrMR4K*eC<l4E?m
z>FYldK8-)Dq?|-dkJTusiia~-wEaVNS#V^*x}w;XAW?5{e-K1A<mb^pyfpu`eH55+
z@oThNGtFWE7njg6fb}dG*P^1Jg7blc8UMS`kZ!09W7Ly$6_$?64h<<B`h!w1E>_ow
z+hv)TZaIQEq(JN?CgoAL%;MW071>frOn1Vq>r3rhz1VVeJC&R3=V)SIXx1!*62@EY
z5tQ8GL7KG2sU9UhNoMS$8x$`UF^Tc}yu+RIQ?%=8`jd;l`5eSu@gEM6K#i|8aN6an
z5HMnO_dG*ze!$&OcoNiC5n^G5SktX|T#zQdfvB@ROR<Q?8D+OB_!0Ss+}>U3R1bj!
zdP?Dd)}@nu&BApO_6>Si>g#Yv$L0nKwd$)EHd1(7Nl1GMovnc!v{d_+C2f5Uld;AU
zcU1m!Ob!~ziM@s&E_}hICh@`6dQrg-ZEt#jN>+75n}EH330d6DFyzM1$aSOR!|+yG
zjsCNNwND`OKFK5Qp|Ij)<dsuK1?8fY%4BfQ64Y`6R%Rlp{#2ak@kQg$;wH_!Xi+a;
zMrUJ4UeomQ>WDAsbX~8rw)Y;?YW)l4=!Ga)Ck3Y9R!o;<e7%Xgp>si+JD(K00(w`Z
zs(&KQWpz8r7r#~d%*sLCJL+f+?Q2S9E5APvX%b-|<R2#KO{()IF0dmzQmdIg59^>&
zjV06K6M0aO*FM;0@I^H%qPF;NNSg7?uk3MHEz2ygOsy@U*n^MK4>`@MxN{g-)Edty
z4g29QLEZu9xS-jK7OCQhbOZL5&@B;gt{UfPhvQ?5SGmhVA}e8BOHCok1r{`3ud3E#
zb?sI{(7sTKuyifLpn=&Z_=n>nRw3}0DZ-i|UPq7&04KDea$ISQm~wezSvJ95oB7oh
zX-GfwofkSf!E9jM`(IT8T(23k)P3$3IZD6-1SlkKKDgYx!z+AaI}N1VUD2_s8SSW8
zp-sU19M%=@239Vr1TS){0`E~WuD|Q0GaP4B)6tYGr)s@xNUo5S<v(R{svmB_Pr!}i
zOxcn@_@FGh-70n2L!MVc=yQ^~iUSm@O?Oi=-wcP?<z{s`3`}DKyz4-T-PyGJYy?Mz
zK~$5{^XiX77a!W)E$|tvu#{rrJyY`GZ<~*MZ^U^zA&wSGbP{J-=fYpL)5(rrJ7Dl_
zm2wp)%Ga;V+_EkOaHk;D#P^6y42jYoY}p13l(C));&-vX`2__06E1lwgT_qV0KPG{
zS9Dat!_lgq)Y8=LdjUOy)aZLpkg%4&S-!vgJyxZv1J`rSLqdZt1ae97avoUxcfl+S
z|M*r?3Dj3b#f#+$COO-4@sfu9SE_zptdi5xBN_TZuZw7LLQB5NTNlY#B$ypqo#7Nt
zqwloZY}I1MG;n%^j`L`Vd0mgGRIc^u_NHA$UK9vp=&jl+9Ra^@AZWKJnbY?(Cvisi
zAkTSA#FY2Ltr3^`yKfSztylRSS8#od5-8A-cTkf$tqhF;cc{{z*#jsh<zEPv`c-?)
zSXu0U<-y#dQBTS*sEvsEM^kvC=I=qJWvF%f^cfii9v5lXFA`AlHDKrqhCu`)$EinL
zh<VcgPVbwSJg0FZ111G!ZDROJGS<~fkg(9>yGrZ<De0Hei#1Vv-(X8B1@x2-$<lkJ
z$yct+uZDs|rGl_SoCkzZFB_7l59f(kBTwI9-8{`>WGTDj3~RF{YD1@<yHY!KaWb-b
z8>-Y-`9D^`fCc>l%IL$N8CCK<@F_7TM-n-q-t5g%{m*wGoUHFgGfu%)&pX6^N|O$i
zyKRd>Ngj~nek2!p)fz=+3^+`)47Gi*5+&v6PN!wwZGFPuGwh$JjFAI|#$rbtBJC4g
zIZa~92#F}F^T7YHKHU4?ZD~C~_!ZIq$FP(K1qd)APb|xVvkSCm{K=l4c3#+8)eQEL
zRfp~L#k#W|+MLS}*;G@`Ba$OW)#(X_ALpA2-T*#f^u7M@?_;{UgT>Hv9Iw;kMhpp^
z>8I757rE@q0E@6uaIcx9dA7N(4Ljv)2jj)mPS(AB-&O2|Ff2>95Q5_@2=}8H$FNB3
zmgqUJXKwtITixnrA`A{~=^k+@t<DyxX+gHI`(SOAAA-_Vja4SJYF)!;7;=JrN!xVc
z^eV;N;THyT!?G|6j`AbwiaS(@a67MsF|ro_id83<76tCoxXI2`jRu}=N9UbQp}HR)
z=?&S8OK@Z?$XO!KO0)dqLUJbY;Zw`GLv<-^z=>mCL0%hvqx)<w@;;XjHX&(#zos(1
z64}_cnpB5+tA&oO|GN)#*WfnLc25F@#!$wTx9A#I`!6x<t!zh~tmTdmsz9<8CB(4X
z3j=P+wK9ab|4R(-;}-+6QCM?DZA;$!>X0EwEi^oknaGow3E8V~h#dq~)SdkbN7G-i
zYb&t77mSl=RBFUAjHU0p06nI0z)BBd4zkU$qwD+*3c*hY!psj3w~Ja69mQy2x^3%q
z(gw1%!`(R41FhigPufUoM&YE86C6g5iTAAnrtWWTq<K!O<7T!EYO5SPWG#GHPP<U!
zi(Y%T{LD3wB*-L5HkB;6ZtQsf3$)iW2rfddZmR(-_0f>%xV8sc+RXm<k>t`@x5wO7
zpmat?;8<S~+E-7Iatgayt<!Lv2xun=Pu52^vd0v{#K&O4$1@!gb0-fHe$}#^=XxM?
zHMz?rw`m!r3XJ9;+1>7lM3ui$Stz)2Vo3fj_l8Kk44*H_8@=(L%c*Je#`oKL@^n6t
z{8fn-FdxUzLh`>*&MV$%<AT*WGJ5HpC4a2atQa-{yMd6KcTq~)e4L$N%fAh5T+R{f
zbT^;hH9(<QkR%C1xiU%jcCRN&Won4F1=d?z`*v<w4-0(3&#&$u{X17_FqcuKodu{T
zjfqhCY<1wSJwpF@D}h^Hyc3wD(sn`bHvq5|+k7f~L$9o+!ag2;gMWeK4mIxm8X8Q4
z=df7m!gGGIsY#h?u(zbrr~9U~u}9*k!qr$tDgLdgI$WwM4;8C(;Xq`hLt3RGlX=<x
zx_+f5KJM;t#|+rEo}$##o<>0_inBCb*LCu_(&Qq^^>}&b39GRarUW9cReQXqmsfj_
zfUU~iQ!$RhLu)u!OW|%1%vl(<8ltPOwPjgO^JqNzfwI?K5U~)3Y()HHx~Z?qM#vQn
zFlGW<a@<w`ZuG%e09Qb$zwrqnRaG4ZENtMrVctQgwjBET-r(YZ5-Y)mnQBBUWUd08
z#~lYEJ|to>U<;S9ls{a*-74vvayQm4J46;)nAM!{yjyY7g}|Z-CZ(RpGkd3W^2<0X
zPVEB}yu~$7zz<zZG1l&v1>>P(#&$CTK@^Z7MIQkE6^t45fp!6kQ6SZ!3EanOV&D0a
zT{|9QId?@8C%|zUsY)>SUI8FrE;ms7cRGxnc?vV~eMw1@Yg*~<pDP(7enwOCGy}2w
zIr{n`?6I)Bo!?lH!v>O1FOQfS-H)OQuEkaNB6K=kjEy{Y_GEw6LFZ?^H|uuc!cQsn
z%!!|vWj$GkCo{QH1Yf0aRj0tuSFf7jaEwbuT%UMAD0zM`CuQI!%IGLaN8m6P9Rk&@
z1V>v$V-mNUsyONqNcok%1CL0h+-_Pe;-Ae&rhO<W`|8K^8h9EZ&u3-BOyZMzuF-NR
zs)=w|JosS{UBh+QnD5)sUGhC@pt^Hmc-{%&Snyf%F4MrJ=9NN9ODmsnY}anGr?^Q;
zBbEoBLn~u%>$3;mju9d7-#PByIW93*c}1)mp`{_F%H=^X`r-a*@88msn8D+=w_u%N
z_gh+!>jpVcTr#!&(UYUJ032TQj7`V<P1vV+k9)vCqd(m>LN`dD>l$g~jmj57$+e+9
z_bj+ZdRkIY4%G70NxziP7VJzC@@B8J9HILl%NM@RJTP5C9=qmhdw(u`(Cp@{D>E5k
zmEF_)A5PmJ%G-+LGa#$90@lR3eLSEQ3lihNCug@D^E5z>W0g>(m6`|DQ=2vCGSu7q
zJ`puzr}7v<TmFUpgMxy+=fNL<ookuLE%T3Sx|6&ZsXgU36&gtc7VY4lM%<3%*H$b1
zi|P~-tt(|vT|bv#>J}C=lP1$ij|Zvrje4Qdb7Av%1#rRBP?YJ+Ab1PCJ{u0=ei9yy
zmaNg!dL1%|b|f*h_2NVzcG*Fy6}T$8lQK+f8RH&a&9>UxZ1=)J7`V{hElDN5ymB|9
zkS74n>4=lU@7jXgf*E;jWr{Xp5J&12&X)o<wH5@T<aR|FtOHtMEumR0e#SgW?(pgw
zeLKCXqdh`Hv&v&806(?yS_$qlw6^Fmgs|-1BLWJ$glEWb{@*Vj0`_8S)^~x>XYt3;
zgzvM+Z0oPPgcslyIt1dD4Q5i%xJ~*<Yt)(gu+N70eqjbUiI4n;=#My0v8`m7?&o^b
z$JQo61_K&3rAR=X!@JR=kCK|_XNgZAAZdL|s!FHrmt#^<O7*x42%2La<nfCSAi?Qt
z*=(ltImCfVHN#oSwa6@bQ;4{YK}qox!Sx{Ycu_=JSX{UA!JSGy%9roqIfF*b6hq=D
zUzNeHNlmmQq<ek2g(-mm>eWu8K}O4aVF-x?TAH1>sE-MO%@3Xd3MaW)G`q4c6!;<X
zs~55>7*eht5}{NHOo3mC##F~dF}P}8og%-|X;XksQ&i2jV7%h4wE7o-5+B@+RThMR
zg~eU~KU^;~Yi7@`6|$i~y_OuUs6aTjd5nGyUd~$>47+|KQ$q6zRYm3tI_Lt9l{JUy
zYkLPAc<h`0OUse<M2^z6s^Td>&FbHa)yfya@YaDhC@h+j!Q^Hi%1gQj48fPu%j)Ul
zJOrtm@oS$48qCM1e~o)-dA~}>>t_>4bRqQiffy07km(&RW+>^SXTCZ{%Qskx%$IQN
z`WW#18|#J9(zVReMDJ~nI2!mLLt{jQq#g|02+hy|sKSMNF$P@w3kRCFaZ~;?w<J|}
zNLCqV&aqPmRZ0Wg;9{1DOzuMA_CFjciR-ALrk00ADeK1&QArTQOfoMs(Hu5$D{C-e
zOCejnCT~q+I#>~dSpMK)kC#(?o43^fV>S-;-WETMtRj<~LLnMkaW+B!5E=^N@09ju
z`gsCCN@(!!ShIM;rVKt*4CPQ01#shnialOnn@a05>$m^FJt0;yhBE^PSDt%%R*R!=
z?xd%z0)6B+$B3LNgPT5(O_V7`MW9R0KPqs3BI?zo9wT~&!lxv}*nuEqu|<s9G^8}z
zBIKa{6D*XG(F%+gkmBUzJ$-$`{c7GptvWxwz`Xh^u6*x$(Mz@KZp`8Ewym%hc@2r=
z?5-H2_YI0!fFKI2*}}z-$*rWS9%lG+8a$=P(lF`_#@}R9X`vbmqc%G@c{fb5Kpjns
z%s!gj!?y}-3rGP#954VMdLX%p^5ljlQ9C+g20S(TjP&^?d6LFG>YE0%L0f|iBOVrI
zvA^WiaP)lh4S5kgET@-2N|b)?oL(!(Ufco45J?Ap#ewsN-XZ+JE+^l*)zdv_sKfH@
zEXWsV#oS`DY+(FJfEA@#I+0Y%<X&s~8yUfXyKG7a2TCD`c)<0h6Ro<``jRK2b7E*i
zbF@EQXh}%ibR#j@D6CbtBPMaw>>1y5$(gH3r!DUFsTvP57#!<vD_q-hOIlH*k+3qQ
zh&@)KPVz<k{dtZZ5nsTn?2dN{4>g1mC6KHo=dPZy`&ehAI=gd6KskHp8&?k%(N_VM
zg9SsbYD%VEKrNymKYZIicC12lc-3w4#(x}zISnPoGTvcVwB<8U(V^{Da!n5yGPLF{
z@yzZ$D`!(|_H^7Cb3glJCT=%+SLj>02!<-!`2f_tv^`IupBNn;%(J;lD0Qv#i-M5I
z)IwiI5IT{l?70AE;3w}*0?Hf##2?6><%v#+N%&feH2v+1Q!nj7D=L2+oJs;L=vc7(
zL>R7)Rok?$A0%sgpT6bMa&MfhL$yLh4lSi`X6(p?6!^HC2kN{-W^WJe{$I(@5t;<v
z>qTLH^u+G`ZVpl7{=|X8s0o?+eK04=r4>U=^_Mm{&hxzQClMyA#+++rzv%g<+nvry
zsIbW4_(`{`kEeY_I<K5Z)ZkD26E|W6E9Upzfn#!jEi@TmO*WR}MPPvUQ9p4=HCW(R
z-+?hHAj37=c?4A5@ZqZ^O5yfDm_}M#%OyT3s^7H-eSBdrqSLk44cUcp1290UotwZ{
z6l)d*6b4PDV_L_pbW0<$0p<a*bODf7H^u73(Rpq?x03~_VMrx41Sz3+#Kiy>=7qm=
zLb<AC2y6lx3FqfKR!8afio2Vc3Y-vqW~0c;T(XW<v3;`wO0K{F7`!fh)bgY>+tCw;
zc*?i9ZqDh?lq2S3ZM~*tGDnm&Vlr)%f=7YWT?vgpqJs`Yv72%-I)IU#PW{wGv0e_0
z{0631au?~B$}vb9Ts!GRo=sQRc69SD|F-C}&*2@L+~=Y%D?QFRmev@Hd+c{TMR)oN
z;>jShDccPXY{LaaLRv)bBwn-6*HW$}o~=XG(2iG;^8*UI-1MG|LUhJ26?voQ$uQ)d
z`Er@k4HN=V4-K!=G)!H&(w=R)mm|Cmr|2d@pV<COd*}2~)Fl46oCG(;!+mHE<)Hut
z%7u0~wLK1&(%RpLuk2^je#$BlM_PI&jag#_<Sno~c(ey=(LCQ2AR*1o6Phm^;x3MJ
z0<5ScYyAp$Uy5Is#6m8I+#*@%DzvJnj4*`?d7^-E^pv^2B(&~5B9<lbq0q-2^BU(6
zy!YoWyl$@oE=?Y+&1A2lp57HAuo<iyk`%V=sXqalSU-yQx$vc`>JxGs_8(B<ud)#L
ztUst4xRa7lQfx*}Wy{?<%Xyz<Kax*GG~%&?ivx9V{UvJrdX7RNk$sSi+u)U|DD1gv
zTHr1P-dLFK!Jp~yQp=<5P_8@&cRiRW9+gnqw`YeZ*-KqUi#1QGO|b7-Yrq3sGvVd6
zMyJ>#*T@td4#2A5ime}8X-QZM7QntR?msi;$@YEs>lrwL5she!-<<OttPPxX(yN7}
zIo;x{LvB``1+5W7HP1z+!^sE-^LD1JLa<kqq3IE;X;6A<L3~Tq6d*x+w9t0?knU?L
z<sTH#Q5$fVGLXTsznXEsgfL>j)u3EVkA-$C6D^&lGjVKL0q=G(RnPu+F>OLyFT61S
zv^MSpGrI3_y$s;p%K1d@w}{Hx_dPyLx<6m&O&-dh%}OsMZcZ~%Zp~?+A0OcbQCx{;
z7ypuJNP-VjH#ri5jqzoh79w0~$9Vb2mGbV6DYBl;3gV|v`P9sdkc>Ou?Lu%WhGu@L
z3&>(mjuw!hP{QqW5MpT)<$cmnK?GAttO?AIJvJF*Ad6|yB<sQfRU2Ml=1J#z$DsBb
zOC>FxV!?kLj2FL#aC<;TqPS+Xq7_LXQ7EyQXbaHw<5h~;<(iF5r#i54)Pveoppytl
zw0o9$l1{kZr+x()@@46jRReB<69$&6D)UOKg{Pp1E&J7u?wnuSsB=-;Rv^1=$YJMg
zPk^JaxJRxTnmrKYYF5)#1pOQZWoS^ZkL{n(ha(IyN%CuZ;;W%wuiK_p1+%-$x?GV?
zqeEh%6@1xJaAe1mBA^%tH)CjDcj;9niXy`c;Fcfnid)~qRwnDheYxR%8Da5f?J3Et
zn^3_qHz=AfhrqWlW}ezs-2EX*TXsgzLKV2Z0omo36lfZDK{s8>uYn})%O!I<A}UO?
z*zkLCm(pD3L?5&I3?Sh1)R<k^F~E*W@6K7|jPkb6IR>h+Q=kEj!JO4`Q3}vrY~%k@
ziRD%AK6*G>=XTvt?G|x(ph_&|6>%7%;(92QAiCvQ4F|B=xfg#;lVkYp<dqUXn{*-`
zdPJYo2wATubM$$V=rY}SC4@#5J5Z!Gc?;}EI?J;;jU#yUG@CDnJ}6G~v7PW1Zgbh>
zKbMqi7}^f+ZxK=T9O<4g!eFQaqX|RQBTIPvRcO_|)!!3RAR|e&;oDQni;v__#Ht4V
zvt{pBWZAaHC!{8i;-VgU10c0B0J#CRa|vvbWxs6+ujeN}g{FAWg#v{SH{+V0_6k}}
zLWuKQXro_>DU@`R$SHPO{+gf-PEz@Ku64LfK!2V%f4mytrBdhdM_6p`beWR)=orrr
z5H35g_|CspieP8QbW68N3-ywJ>EMdR&5*MGWg9m>;Xy$7Scg5Y*CY@Fl8kxh)WX7p
z+|?`$fHbb^29rJ>9dA|I5SfL4`5v-_Y#nj0kZE{}w1SI}v83!AMUvjGcjA%lJ)Qc<
zvg>1lg_pVvK6p@++ri|*h2ikn>>m-hX`%r&!3c$V2RJuXXDvJuwnW!|QQ#r0xRmH1
z0J>1BrJqXZwW~{t$}mtOWlW8!)fhs@!VOZ|m8noi+vsOhPMwBM1pZ!B+Jh<AZm2H^
z%o*{uz&QVNX*(=;a4VuNZX$Sxd#n{~W>1s88uj!n^ZRKX{Qq&Cwmr%JLf;M{5W>kr
zaDE6W1=3{wJ(ke#EHx~mHFVTW{_{z<^%<P$yw`3lXrok!1i=@=n%zDxlv_UC9SkGv
z3<?d`hO)roR>=-Wiz`&J8;LKzKmJoiDHM;H&sw^do?j#71Qjy0-aZ_7gL~L|CElIL
zfzxPi(O9Ef965LD59Sv}-#5<E!le^5WhHwktecsF4WwR;;J=AVQ~AG2P!I1f^lgF_
zxi~YcJmn#++fvTpR-CMa2A2UfuHIL-EZGE_-Vr&~G&t8}^Zs%Svi(K3sE8IF{PyV$
z$>PuZO9|-{qa!j!rF7TV#%?!RIkF+ftx|GD9voIEt>5}i(j;j0VfD(&aIQY$Aal=x
z)Yma!i6uz}_}uJLt7&oki_gb<uqBa(MG18DtdfcVPkK~sG&q%9t{I=5R(rSEMVud7
z;gKm|{x&<;|BtiG3>gStPW4Rev<lO3rcDi=aERlgQt=0j3l7Mx8KdI?wVW#Md%5|?
zhnAc17FF(oXM}ZrU-~3u8SPU1TU|M6Shy2*d1?Z6C<*j7V=A^zjKkGYcCG*rqwQuL
zYr*z#SV_Ld0a>^+)2F}%4Sq|N1A?_;=kcYNiVG^KvX>Y>R-GsDTG9!5wdh0yBj1xw
zsaXY#;4Gu<?br}a2?`~Xp>LtrvL^@wItvv`A;XFX@CZ8W-{p%NSMuUDh`rY<C>T3j
zA_~uX18Gd2BU@e)EdjGZ_ytLex*AK~gNF0!74>?WAP_upRPW_fGYCj~gp@xp9!6|Y
zK=wZ{p$}el#y&p?KT1Jr2Gam<XG7q=8>(_zQGI*DSScyqcOL5$bnqUSnIx+${d-N=
z5EAa_CL}9Cc+n#rdBhP+W>lr<NX=<l7`r4ME-j)Nljoe``Bt5WA1;_(X7YkY7<h$e
ze)54BfWx|af4fv>$6W{dFKhyeh>WNyZwcqfH-zb&^}XWcHgEaI3Y3(3LZx^v`z5t<
zQ;G*fbWJ)>o%Y<-^FGb2o~rpQp1GDYrhlF@V)^2$=cyMnGqTg+BMyVH6}O@uX%%i%
zjDA<O-~(o{XjmA2_EG~8YR#Rls5Js8m<W)9y)=gExb(l1E@n3LtNKa4JPWANMy7DW
z9p}mMnlv}{F2ALgtvX&21ENO9GD^gQM2u^$MWAc|Ac#wa6dp*kL@ikuX+uBuMae1U
z7imwKcdv-9T)Kn%q*je{_L?wG&@9015J>E255v}F1m&T7%)D7ig9Pcg8KN^mvAc7_
zHHlq_KUzR3P9b)>j<XK9lPi}H_~LQ^clXM7*9qJ4w~#GWBcX5}Nb~TCY*jnyqvi}&
z@_~-;91)){6wdtj*1&zL$WxMKHJlqIRhVDoGD=-T2~wD96Q0n6Joy97O0Jdt3unwi
zo#UN@<UUOfHswbf_XM?<D9QaF_HQS;*fw3E?r)qm!xwEQ)_y%t-#FE{IcDTVB4z*7
zNnWp1WU3xG-2bI~+H@qy|G^RqZcjML@d5h;u1M~yx65lSJ((D`cGhZ8f<~5X=pvw|
zjv?=hOj|}C>!Hz{<3Uji)M-c_-VgmQ6Zb;R)A<KTIBBo3^<n{2$}e|ic?S9J&jLA_
z^=b^ab#n1Tj6l8q`Q<!|+>x=!;e@)Y_B%!pta+OZz`sl~TNzY#P(G?L2p`<sluXqo
z*tPqutzw^=Y4bL}mU)zbxeHg)!lIfKB@LdIs<HnsXj4gUm{z6&02N}VI{gM6Ca`ce
z&OCZKq1qFHX|_}tOHtqQr&}&ZIbR}9({ad$|GGRMgmKR^@Dv7KOwxQ1_)s$M8vv*h
z8r#onI&o)0uY>cdgDUlFT6mXMrz1WAvi2cTi5P?kobsx{bgsk<=z1D6z&zxB({FpR
z;Gr|>vIWW=M;822_@&*PS_$H+5l@UO@UE8<fOQkgt$p}s)snqw3_(sx%=0EyFB~PF
zQA860q_-|GJk?1r=H&&WMajNN1zw_#`$gF!qqvbo+dR9D?|G_qXrvk?&#(3C{f$GV
zTp+q7sl?gu3ykERN)8tVchfb{KF^Rwf9ELHiw_O~(7f_v$sOM;8wNBThvddP%D<>A
z$Qlx}KV+yu-0&HEC`x2t8W0FBD3l+OUq4;?(coZ&sAGUf|BvV(1v%xdsi1qkw=r#V
z%FghwTx1i4?he7A_Gf-)xNoszTaB1Q@)w=4h8|xY{ZD0`FF%L?7rx$qRRYAKTcaFB
zG=e~?^P%RNv%}q(z?U>yv^1MByfG})9i#-2_a@YnLz^6H?J5oLfxiyQ(%e7WvkvUs
zdu=xl(<I>JAHFt$tyEztN?jGn>q8_ih>YHy7(8U8PH;LVr030eO7WjMJ=q30Q{P)D
zwLhIWF|4*x=voO-5tOsup53%rBm9uhtG<&L;J77uw39{sz8vq56~-9>^mO_Zj*J{;
z!`7Cl=nKQdf3$krjf$0iAs5N%T`}lsn-ys~@0G&33ff+*w+LF^3WdO6pL7z3^TS41
zDYl!*rbGn%_56UYa%V|Cp~S>eU!dg*fqZaIj)wWP%!oW!vnu=!3%^VQCEC4hO1unh
z&nS>+Zj~U}3SF@lo6osr4`S}@jz%%~P49NHynlu9G{L!S|1Ah}wbJI8J4VEhy@mp-
zn2`^UT31%Hc|NRJ1Kar`5(mH^lg^K>&*eD8h`0`Q>Zv(LW?wFb`oP><3hw7>aU{Qf
zMsS*6K0TYP+Tk29=MM9=&soS7YtmBFM|0nHc+wzHiq*3R(9}MYjqB*!35?3`kpvQz
zl2-+fRdIc%Ca<r#O}E##Mfkyq&6{!<4|b%35c$`OJvD~d2yH-{;v@W9kf*ZB7Ty_N
z<1aSK{OnT43$%2vLWjAuL{C%FBr;eABf=H>+a*Gp|HssOP;R%053VFK?s5>cust*|
z0qnD48y5Q_#271jDiu>uPWEC%N!DD2d>RW+<YY_l&GIp%t~0G`n)bDyInfLa1dl6j
z)7;4~Nfv+kWdx#NIl573)=OxdFp%DR)b%NesA}8c+uyBZxC}&y7GB1==8T-xO?a@A
z^~EjRnHfWe2XDQv@v;FKk^0WJlniMUYi;)N+q5PP>fN2vy?+ox&Dbyc@hZ_@?0?$U
z<tf4<p)5A`eaX7+iAkxb1kucr(y0v{%kJq@NY`SlA;GKIoMw7733Xxq^w2VA<T`?h
zp49}&J8o_%7;y3^oRZ}`LdR}28-uj0ePXb;kYeuIVr1tf=7>>VrHn#!1rk?C(Z-}B
zG`ZhMUT_?Tir!e93;-(IkBPTJ!|Uu`mDT5TYHjO}zh~_IK}*0ta6k!paYc6se46-?
zoY~L>)@f_!lauJp5CVI*<)eRdXDDvAy)s{?;=EBNd{iy7f_u`r0cG!Av!=UirTsKO
zd;Pd$N_}XWFB;?JF0qV>c1TAc0j>K)ppLARak^M)#;Zotwx+AK`=o}NZ29{lB?31b
zGK$;(17kpfpd<ahfSaOw=*To8&oZ+yX8u6gPId27^*rE-ALdE&#0>z`X)hb~vaUG8
zB6qA;A*NJ@f9Z~zXRi8ym<BGJ{9O@!yyMO?iokkzneRg6I%9cZ>B^{rY6ZL<*LeDF
zlS>46?N=<~y#us*fuMphD$?#%ME_YuqbI)hB1@;%MJk+!H~WY6DLF3zxXNA^W)(!=
zhISy<2bC4DlPMjZmBil14xZjPM=`mJ;ZxH`-akSR%hkaAW~=;NnFEZOLGA((q=Qn?
z94xK}4KNo;1kPf_6;ANuwkCPtzhDVb$lYEDuDpWU79+?GUM6(-4aWAN!?(Q_Yreft
zx7Y_--f(n0Y3{)e#*71n=s@LJ%A|T`z3WC_3#-64gzJHEQR>7HXyPx4th5oN*7^L6
zih~N?L7`a8Zy7{0Uvrt4Nt}>Z+e&9;&`bQo@S1BHZZVynqFv>MVj)omSt~a|q|C41
z$CD^ZUY8xfb$j;i@OJ0=s@hG2Zyo#T6w7Kltq_52PH93Ek-ne4sG#P}BW->R7Sx0G
z`kBqk<!Usmw@@UWMVrt?k#Ur}4@X>neI%`4dkj<kz%{g;s!_>+c8G>#ZfLza&6%$e
zL;b)4C&`L(J^$t1O*G&6^ZHUxhxGKv;>j|_OBE`R|81BeiP{G;?BNMGBgcLmGK4P3
zF7RDF;7F**LV*rygFNY$WOe4uA6HSX%&0$22lM-K{S9Y|jmojfqJn;;xAJ+ha@gJo
z1<u{fmu;mgt~27iWfIfSChr6#ESEY!wYuFz=R|&ccW)!^2h-)MhyX-L7D*bW1fjf<
z9p+-K76B0Tif>`sM^L8(yS3p7cT=w~N$HhAET~wFsPjT)ePg}V7WOw(3)(`r`{z;5
z<6cp{PRyWy410J*7j%u?R1`UoP22t(rfF_<{fslorjTI*5XBYE!Jvg4r0{%5KGgsF
z_U6J7m&)<6fR{6%JWg7QHip3Ujo&>?lUI}8{(~I>UD1+UAn)?s2p<btQRZsEL5N~@
z(UHz~LrI(6G<8=4U(EFZ6;2bqw#0F#7J19BKfuBh8-m}Mv%obZrrku5je4waK>r_0
z8s(7TV!s&jKzIbspcKA;3BTHETZIVuPcr+Q0~XwU#q!2(jp?c)rThYrwq7N^*n|fb
zlE^6qx{n$y?YBUZ=8j9MwSyAIb{cWcA0cwq3<i3|17=87QpgQsslgaN13E|v4+FD>
z3~d)ui>Eqf^8-L(gJhv2P6x!ead#%vv&W8uyx@mz28e=RCsaTVYgaC~hBRW}K*4&%
z$s$eiFU!hk0#U6s2X|W7iv#N4MK>V|tbDN>*WJY>mow#_dFC-gj`Q4x@cYYd9D@1E
z5pNP!fz-#I<dtiD*V;jKhWVUN^(AX(g2V_2%oW;*P%p8il$|h~+0F?Bw0?xJ0F0Ik
z^#pLcnM#+PWui{p79L9N)eTcBL{uKyA=B5fuYgaQPi4O6X#GT&ZFPb6vui5&8c*rf
z5_}^#TWUuZ1S~UO@->^HI)=#fhzbB`(njcq-mR06(cW@37}vz(*KrMCyBBEv4Mo4T
zKvfGvOfD^!VU;BDc3BG$rs5JypKwAEf%d6*m)_8y8o<*m!xtajWbE(H{@u<ZO(EZ*
zDT}X(Wzv-cAHTp!Ob`Z4b7KE@K0TF$xeI$f4we<{qR`L!LB=fx$KEMsIPt{caVe9Z
zx!^F4-upe^Xzx!W%O%Gfi{%?RX_}v`WYLufYY`~H*Em%lrjFJ(pJBI5{z!Ajsgm<k
z>e#lie_=p^J#w(s{Bm@%0T*CQ9Xc2*F`iAY3-@K<7<rLD4O$@xemlK|%n3M=*1_FR
za4!;Pxeq2IVa!Z$cgM(mgsvDOz9d4eEl#T@N;5QqhvK8$2Uw|@W@@w2cx7(F@3NHJ
z-f&+Qsm?sc@l_BfpLS?{N9mqh4srIzkPWqEglh<z_!#=~k_P5}jtE6*{3L<OpxORQ
zX_+^EFK33kMMj}p(A984oOOUAtowdo1I4=>Ag`#6b&^N!Dx8ABk6%7uu^O&8dNusS
z=|7F62({oxWZx|gb}IO$^McKJKYJYtoV)m_jGn+O4(#1w9L{6EmkyP@B~7vDhDk|N
z&5=Ag;3Xna`?tIz8eA~hT^AJB9XoC5LGP4+A)v~+NgE2*M*Btgv68MCD>rx<3u<EI
zL!Eq<Hepd%-cGwv*5qy`{J%~Z1kfgovfY2k)g^|MrZg!>i9zP~qP@3Y&044NwhDS`
z+*33rsRlCWA-Nz2)A-Y~+Pi@ca4$_;fflDz<fJw^;<lY|u*VsHwNovz4|=eO=XSZ3
z6RUIe1LqH(Fc*@la=1#wd;ES^=^VRXLGTpDej2G_vWURaG6<-4{&%!&xZ&BEFUm10
zU)X9xe_F%QWC!lxYb}tWY}y64&phHlx}H>tHr^6aj19MklvacES(}%J?4SqAp53aG
z+8h1~tW{*3mvCv^PN+ebW*z_R6vRFCxuIZxaW+2!4Pw5#J&&TRzTcKhq+aEY?ClB(
zY1{+iui*EF`&0K*AZhX(Hvr%tQrX>gbPE32=wU_^3(dFK>rQekb=jRV@g8`YNX94%
z-Pz0h-~{FC*<O1*WsRO*ngK04&f!J;uSh}SY0Z+(qrlo@agI6W5g(Z?yoPInt}d~l
zH>MjDdwl*)>HK7!-kw<*j$2u*+T<F(eaY&v=-%^e4UfnUNLS7q#A6l^5sUisP3SrS
zN$RTRtsJ!fTBi}+NCfFq3x~f+e!D>3Dw_MDNxT+NC%%PLPouHE*E$5$S^<XLLWE30
z=i<7PNb6pe1STGiKCCs{=%gPz1(W@Mhr19;`pjIZt6HXxi35rgE<a1SFBnQ91HQEY
z!+_9BrbQ^Afk24M=lYLWjpq!vaxY#4zt5~QsTutKV$b=L&vFF{>bYn(f?=B8G%)<8
zAc<kc#?4ul*5p!eAU{e)DQlEtcz>A^XEm*a@lxia)3pbjumFndLAMoz$rW9<*;bZp
zdT(JX$h<~wG*WN;fExL+Iiw|{OJ_9r#l)ndh60RS54IsX6<9iGgr*c_>CJOjzv?d;
zLo=hfTxUM|ih_Y@fex-P`mYH6)a&J?r^186lz(SAO_f9M{aTtMow|114Pn`wkb3^I
z&sZwAm&~w}p0$@WtqJ3fU0hPe45%Oi3V1Pzsm8ikUd_TMj&Xvkl|u$<lX8w}nZRZM
zirzwt$XZ>zBz?3x==Y-*TzpY70Qp}42%iA~YoD%Ms<~R&w%8$28`1yo7R$nbT8xYY
zq;L+@7=(enGY#(0476U3m61~{EW1|u_9yz%q6|Qp2<K3bXVNwjoCE~o@}78${m5EI
zuc3^WS&`0xk?F=dE<`(<iX7h)7u}S8phW-tL&H<92Ct&%z(^ltDx#H%rm2g$LZ1I<
zDQ|&69ylOaG{bO|=7vk%E8>uUtdsGx*nTyd0BmW6Y<EI}`z;msmyG2U3ncwxx*~1^
z`>NP;YnANV7*rHC5o~02(8Ff78c8T?`L-WV(XDC3(cGdsjGKaiFIUkVynRE*bLpxP
z>Iz=*a5<wPev`1X&-q(ATBC>@tgoufij2$ssPoBUVq83T$ZZR&(QLsGCvH8jCB+vv
z!n$fG;=RQg-x%jQapRpBotxFeu;uqU9z+QVB=`e<cgWkt^jgC;gU>b*`F~6C@_TMN
zz>p45g$1|f1aXdBL*oh`#|v+a!B61i5htft=>b<ghK7fsoO8zg;iL<1Gl7HDmhgPP
zQY(_R5YP0oSE^rYzyI!1>zye{TBMWn(be|8XhF6<<X=%OJGlPB&r<0u$XO_Y<w(?{
z(?;eAZRqV=Cj|V|F9uibu%%oLz0x!L0CIl<XvHAclBeEUrw9{EaC=AMDq50XDtv7P
zk84tCP#aKUK2Pr$bxHfy=iSwFgKXdxJKdx1TWd6^%WP-UjgrO;hxN|y;z37#UloM(
zQXkF+3qz-76r3m{kb9)kqwTyJ#B&_dc_zdml~by<?*Nl8nictHiJ41v4A|vQ#J)%=
zKK;1<-4er_0mGhRWNo>eewJvePvnVPl>30#)L>6;AJ~dk5FykJNo_FHs&?UUa|l&V
zx(4LV3l{1mgKaVQYhZ!X^%vPbk?JW=759i&xnV?kOWp%as)eyU80bg#r}BkPn%%Te
z)rM1jeO2dP2OaKbmY`36^U+t_GcJ82gSP0ogW(e}Qa3fYRpkan<Q1-h=PzO?rkAk~
z%?i75#s@Z@zJC6%?GQPL#XL{-YW@m70ecVt+Lj;fOAKjYpD~^SO*%l=zsd)-P}0$}
z*>NBXdbDp5FXJc1GAgPNQkU{3R@ljTRxP3Cf9BSc{@OR{71)%b8iDtXnh3JtLrKd)
zvo}QT5`eUy5}lT#1|Ae8`cJ9q{)IpTR#6}O8)8|(z`Y`tHCzT65aW|ay~}*VjtIv<
zJL4|n+4H4h-ZQYD^}kb^=~Q08P4T(P3Q9`y-qBX4ZoSowLrFA<xvz}9-Y$oFihpi_
zo+gYZ3LRb;xBfT$_KGg(kY^^GIZ8*tN_MD>3pb7kr=5M-UPI+b3-4|`cku#4Xb43A
z|GfYc+&0&>@ju;(l=Q9s#z~V#SZ=<w^BaD&!&w>jeufZxgX(DBbRT{#U0sPhDDnWf
zClORY$6ei8XaDywD<l3~GKmldp^<$zzy^|SMZIjwDugFB8y?5d7`7+Bv***dld_|D
zZ?SByq@7cd{e`BE-s9+62`|YMr29c;tp(lA!IljaC!qOP!Xpv6#9*VtU7AMo9Q4e(
zJ;5mbLTpZ5J|R@NNxP++*A<+4EpUfCSD&<vhdM%R#E%I1mq;ElzTaW4w9f%mTCjg~
z*Wyo)y3_KCNBgOs(T!&)`z9xzX(=JgcG0Z$1B{`FDM%L-olr;?arbif%=x~`gtS7D
zF<r+})tkM4-qo_6jf2RU;EAK-84d3O*vyaV4;Akh#9$-FoHF{0(R-@i@3;Ihk5H=O
z0f$8}7#?@dG@1GUVv5+{%}+@iul64DI<#MFDA`lbgk7=I48p49fLSn*KtN!y)}m5V
zDb~&9on3C)w<_!{fa8P3FAK5G$D?M+Q^pw0(FWz_1JoR?4x!x;*Mb1JRk~4>SuO-|
z&QyQ{YaB-1YiAvjgR1Rox*;B_vOaE=yO)X>dJKD?gJ|XRBoe6nL~?wQ{HY%=>QASX
z^IR{di2L{YHmwp9uHx{YD6=T_=V(e0gYG3Avo|HGHBsOOnOGPej!wUDIeZ6agr&Ln
zNzFsPXm?WYGlK~(36d?`p0}3B#JhWp+Id$IC^_$KBrB%#3&Z}{k34qqc;UO<oM!{8
zGd_wzwaYSnZu)Hrh2;n)6zNJ3&+(o6znN~1+7CZ1!G3Z7ltT5H@0^v{c`)cPp&zll
zNwso%jy&HYcFhs_@upcL@@im!<7@ggYZp+Re&Kc}WihpQaPX@+%54;V{$vm-WazTW
z-DY|wR7$mlUDI|G&C7Hw{dDXq9C|WKL7rfFyT#R%xY#P=jb%1O2}=Vh?Ne=c5ZCL+
zQnb~4X3rgsdG6x#P!D3&PpJ-&5Q*Ad4G$T^G0g!~ytvs%A9mdGk7U+@TkV!q_yp%i
zC`y}l>|v1&;4_fIVvNSCO}ESMd#{eBf4GjrL09qBjMjMK@SuLan5PiN?Y!{_)+J7p
z5R>=-Y9)!K3&iuQp1@7*b)<Gn&xb*RG_=$kMo<XN!x!RqrV>zsesjlKuBPe(CNFGw
zH&8;l_I<NF<5^Ho+FBs-M;@aBh=Mv?u(Vi!hr9;kek7nAMZ;*Z(0NxQk6r@WUePYm
zT`;V73S12QZa?#XxkDu>QD;dto@xGfYS)jgX%?V^IG4Yc7AP_D-|6g=i=X>P$uV3Y
zoy$0M1+*uE-K?$4TEw4Qwk_a^=Iwkt>t7=yo=!MiC|OcjHVAji``~AH3WV+Vz3Oss
zc-jZ3Bk`k^QCkjRnIL{g+_ThK^H8cOd@Y^ru*05AQlO1ZWZ$#{b^eZwzk5I>6?~Xw
zCJFoHWoFO2wWm}sA@Go{=c7E(Wlp5W3UU@E#U^&VJNL(k`_uFGUKC%^AAZe_0~dX_
zu7AsMmNwJ@8+J~?G|hW)QoiL;IRlYnnCWfKBwx{=N9OU7jy@Vp>-me)Z*=@^?^5?Q
z?4ard`gppdl%N&m?$1w5N^}W2+{8$ZUI4M+p;HBT*nb%Gji07l<}g;Ha^{~1^xgSq
z1a1s4RbiN=;Yd&h%e#c^cAq9OQC27nj}q+23TraFz-mz@zg*(9=b9STp>g@f-*e;D
z0WFM!Xzi&f6atMVA<z7e8)K`(rLrGX(2=bvl3is;uH_orW`jQa8m0kygh8MyJ%`E_
z+WlP!TfBI_=eW&|hX<jf6etE*YEKVft%c~Npmt#HY^jc3J1Nnd(tJF&aD6pLfrCHn
zVUpBVm**s1a9Ah1EiEogKJ0wh(as+41WVjyIVYd%C>ozwtFkw)&04TcU6jE|8R`&^
zV1^pPX#%UzRj8PCBE)-qZ&xukpl5zX$A-5kJKYb;XOQ+}c$B^)Q5@^6geHHlqZ<oW
zVL`}gt5Xz7F3so4a~KPsZ>D&hY4DZR#L(BozD`r+O~)M;1NZ!ICA1biRkMFOFKlG}
z`CN>+{RjP_e<%c1$C1;=qv9n6r)X8&-y<%QKwL-e5w%S;{~xr5#endqNWeF*?<jA7
zXsea+|J|pRSzFm$fMQw6SViOO*1ni$<vmZ%7f`cqg8F0>OFZ9=sf1^24A$%1KpH!r
zgK557qzekq+LgA0h$Hr?I(CyH4zg-6u5vEdMIkj0JNxUMT>hkx*AiONCeeP@Ri=u_
zBn=&jbwL5__@Lao79fJV(VAc|V6**z1WcQLBeYC_jy8VM%s!{XKHWMZL=|)=y-{_`
zp}WdM!?{ND-YEeyxt0P((a3JxxFo{AR=C1G<BNbo<w5x4G@zTB=0kQ$xq$FDX5B&z
zpT)0-o^{OUzZ|;Vw2@@WOXfpQt%nwX6WKUF8m5*7s6wo724a7dSEklDKg?YR0dEO+
z9_&IYx-uCc^C?#5k~BllR3^l}P(V-3H2INyhDlAET4<I=x|^FEDsxRax?(}BpfkgG
zZaXeW_@~6n{>UKrgmbSy_XroWrEKkR@p-&Yx*4`eH!Qy#lMQ2@?w;##qat*@-x2S7
zn2X>QM;EXsLp?mCYbm@dT)!FTo_E#*k|^K$Er$`c->!yvP<`xZc0g+++(fu`2`t>b
zE;Y+bqMkfSL2OAh_krc#I7GJy{j0oek*E!Efow}i<ZP@WcdiuvYys`T7E(VLt}+Qg
z*!=_?1foX`k4tCYM;C}`W=r_Jr7&4eD4Q3kMSb8>o%&}`1%S5WMduRdX<+Dk#tr)6
zIgxYYtq^^MCa6@<dpVOR+($@Dme5kY2Fb*v3I^aQ$du5)?}OIpSNPo>I$<RzuaDxa
zp{d*FYi3UdEimS3;}0MN#r)bw-=@me#g1|tbx+@x%;I0lOkUN7MyiomI(VY)v!S|z
z)NK<^??4H|!8PcV$$`cQb-8(CDcq#$%ZNJ~T4*IEzCvTokT!QlWEP(Tz+s+{lKl^X
zd7RvYA@V{ar)A$6pIPo@Bzdlde~W*O!~>94d<qa9IO{B&{#)^l0Upd4@Oe5_6Ob?p
z)_)%LCnIH&^cKlA&05qPk8wouZd2=wO==tVJFo5>EAk~C6#?up2%sLN`VRkHezbE1
z&~OM&r;upqh(TB*bK}!yIBGw-(&$@Yq`XnF-;jctsPYu)gfGn-4RoZ1As9=ZiUnZQ
zD+nf$Vh>w>#60~yRx#}f&fF(cf~JUSO%Pk+mZ)E0UBB`Rdru@sRjzqDh-)2pkI!DW
znAysgz=$&v@i4%ztYe*h8B}X&a%5oLN~NJmTiF8&8Gmd;c~Nr8$&e87F<bSl*0#7v
zn>_~NQ=JuzY8jfaV^`_a@N?tWY8;zUz|^x`XE2WSsVV&|y<KDxOuh^b^MQ55G~$+e
z{DzS5P^57%S=eM&w574|Yu$%l>#OJ$^TS{@&G5cdSgP1HD=;|_T?k~AC|*S%8$&u8
zbg+~M4-EiPx(h&5%!MtR-3SZm{&6x6q>TyJl3XsNFPnAe#`BF^5M00(>!Wg;^mXLw
zL{oky6nZtI)LX)0DA{CQp+(%T*Qz@AsN}3L0c-aL)HIy&W33qHRz}>mB+e0>s8TCl
z!MxoWrvOCxIxH4C1tLt53eUI$RoeRtWJbI@+-iR2#b$3iYE9NiMu^6Sl_K(^!Ln`O
zV<^qYVM>r+t7{jEFPON~6?lJx`TaXt%rGol9+Kqaz);Z4FU0$2$y|HfGBUDo3J*|t
zTj_gjIXa$G#K4{dL|;kF@U&E@SjQzhi&&?Mrl{sji;AGei4I?|Ui`Y+9vr6UKc=bu
zNQos=4wytmGOMEAyM?$4TQUsdKL?C8%OTpjPiD_w>!C_rta+9gH(@9VUqtm^qUbm)
z^kVgo{=;vtj%itEUPBn0S32JBw_+)-f_F}t8xnZfPkcbc%lfTtd-ZM8IRpDgOoeW6
z;?$ENvTd#{15O3T_^$N4+ID#Aw7lKDoO$LfXTO#CH5f^tI5%TL=A-=%S_Lu?^tm-d
zY%PjQ2E*psMm&^h8CS=N_!`#~%~48&TA8Z}F6o)c5*)_{oCs(X`*jFnah>|8-($v$
z;F~UDa$<|yKBgw(weDnkj}-9n{VCW3+AJ;gzzg$P^&)&r1KWv5ntY`1*a<;u=T$T!
z9+3Cl$pLjvtAQOciqVkc8#$SGD;_msKQq)EIQa4R^M$qBaH6K<gs<OzI&{h})$F`+
zc?|OIjo{JhuAO|{b>(smDyYapN(iRDgCUZD8b;{?guBi2B)2&eV_OYpfHY5<=R$+y
zr1&{O95@z2D{s_lkpSfA%0I2vB(jmOclcKB{z946JR*C$Lqypxeozw8rN-p=&;7Di
zN1p}$BPbSp7Anhy7#n$^o3F$HS?_hU%uyO61vw?Y($N@cl;3eKSED^Uo-nTVsaFs6
zI>%rh9{*Cc+QiH#R2__Io45((1G_XopAZZ@lF0<bpg!(FKLTAAT>%j)Mv#o~9#$;%
zjllB9NcaFxz4rf!20W9ku34TM_tWo@gv`Ti%QlQ|ml-6f4qC4Z-)r_Jl3=38T}c8@
z7lw7*snU%fDlqVv)+uR|Eic8uc6IYVz#p%GeG3P{S*m*P-%>QP8`V-<FG`kyq=J<c
zIM+mUTueH#NHlxBSBBXpjU&5TM$oUU)wpsZ$)PJb8<^4;@NlxV7z9)v;gq?t!9QBa
z@Dz&Vo|vT><yhT+DYIQo+Mx#|0-xP+qZjq71yG6m1?`zHZ*tQ)G_yY1^{ieS+LaBq
za6fO<GJ-{hEn*-{+Ay(AKH>7vE8nI#j16_V1Wz}gZPM?xyZN1vOWwkjEqA?_bv<bT
z14PC+bg3|uWy;xF0h5uhjZk;&k0q8`t;upmaY%x>U7ntUUBnr>XgUqD%o_kmy%iRb
z+PX1CNP)-t=#`DICKdkvLD%R^-Ip737%lCz7;OYz;Iksuj%Cx~HI##62xh3xL|L6B
z=!RwfsizwW)5|pSX)u}3UwLk4y0T2wed<9SWT%9FeF3?87>@u{!s(5`Q%la-m<-Ji
zT(=w_>F#l$71t>;;M2&!&=TW}$a2V5Q#0E}L+ZXyzJ-;Im~}-&a_J`%2Nw6^YZ0Z9
zCm5RmS6|itGdW?w;wy?u-!IIJI0W=}GhkW|No3)IFe5599DsK!gcgc<M2-7a8rkqQ
zL}6KP2iEg8Z$M-geT=|Zp@vOVuLtJs*rt3{Liki4+gsgDYyH5JF|IT@w{yyQ>!ftp
zEeng56KeRNF4(ksKqe^ul)CO9;HAg?$hjlV#OcT_=XS46%BW2rRcabPO!_~}mL4Uv
zvqe8>S;^DEIH0U<fk5gq*~}NZbufpY67AJv=amKip{nsfG|imnoza^x@`5O`;1Rv=
zzP%&Q{{)&|$@#-cEL+V4-2z!%YxM0)DI?CH#&LM<iRF@0TURGa;%lR*yL48o$^vkK
zNDUijc?^Ba115Ma0KsoX+jr$73%UL8EO-r3NOT5bVu`9r*aR=1)(<l^z>w~Ez|8My
z(XY*r>x>X|51wJCIfM~2Ii$eN%SMT-$QHwK8|Y*gv1~gK=;H@foou3T)I*!S>S@_1
z$oFN~x+O?^nI*Pe5_B_^0<o1e^R%Yu94o3nFH!hJEnyPwAE+I<DTfotN6T4PLgotU
zwMHvO$cOmF-0ZbRehvMu?Xjbp%UviDbUjoCkJIwJ5<tv_?ei_7XmE~sF6}bHd###B
zfBoXkMZVVY*1R0`8=TiGxB|}!I0{)56p&K*UTGG59vuW3NKC%}mf=Nn_J!@kYN*3^
zxYf(bfEJ<F2KlqTyanvxPQ%WeSy$8ei-_H9o+-Dk(*pom=Q5{2MRsqStf>eoWg$~w
zS9vFHH=-FJNS2q)NzR@#2QfM-DiW#l;bJ+b3>T3Z{||Oi=-YZtjlrp9q@n}lD)io0
z-NTfrZjNl|=;5~a>-@shbJZ>CTx8l{V5m9=FeqBnB8O6Gmi5`2xcP_WdAFiq=UDzK
z_7oI^WP!mtxj8!ia86Tj4#b_-2(2&N)l~tVrA~&wv=9v*SW6*hS>=JT)&;ERGs|Vr
zUe#TZehdW60>dP*zSDDl<8Hlez_;$2g=#`~GQBckd>_F|4PkK5yw~RVn34hfHMa=s
zpUe-qB1MJ#YZ_jYkf$W>?sy{FQG2va-7+rpqeBzfN*svdeKq+r6Vii!c{398(8(Ny
zq65k+E9(MmZL0SkeMX9^<sG(}om%NSqHW!$m)-2tOjw);;eM$QD`%p=eV4>AK}s<m
zyRPR419&q;#?^RqNA?B~hMQIgV52*XRu`F7f~eR(<?>;wazh=kWxGGk->@*023}`Y
zBv+Rmo2I=Q`8JTBMrLn6{WZ&+ydSLI&ko$>;JOAfVq={|iiacQP}|XB$;81t6Wt3b
zmp5eFYj{fkiCq|TSQKXU96J7v3g$O7SuDqv&%f3;z<9e#|EOjM$%g>XB`U}4;iQRS
z_kdN$nZvb2h|~vj7d424DDRLCyyLmYy+a|=vP41kHJ&y>S}a^p$=^AKQfbrKGMVmX
z0_UzO2aoM!z;$0M3C^>lQgoZ$d4)nHWz=E3id@bW2~nRpkG<#Ju|+xJqbD}2)S7oS
zqhqXSiOdR?7`>-5PivR&ZqInsRH@S|Fchy9W)w=Cnc28wHxZ{XZ%?s6*GF<pfH49M
z4Ggbc6y=Y=Y44V23i3bkUOw&~`w|wxSmpks^WvvZW@C3%{TycbfVG%Rjd6l!Cy*nj
zNUh>iqteQCe`n{k`cUGuPD#Y4Q>L=8i(?8kPweJao`@Fw4qyiN1ekWkHRm!x>W~ee
zczu9>UoANw<yqu+I{JouNo%q8w2skJI5adgwh-dH+zU}PY?sBETl+<LvPKf{{Yvr5
zu8Qx!!?j~VybGo+>&3gSUjdVKlrK&ORMF~`|IpXJK!!ahQ-I=}c=qiw080>q%}RpQ
z>QvDiZOR^WHlI4(YHqd_P-rtk{5k2hwoEb5(!FAcqH|1@5WUpbaccd~pb>a5B(##+
z6y{M~?yzW;Nz(^K1*E93>nXJq<Ot0d$k8)3a|g7$G-P;`qTJ^p6qGzlFk@6%vFiQr
z$utnAjQNe}p0qvCF!lOL_($p0iu^oDGAoMu7qZx<qut9Jz?|qSDV8YZfimp%;9*}q
zlD3tkt2Xn+A2j4Fix`;{S3WC<z>0Pc))q`SrSXL#C(_`DWd^E<OzuC|+|;)oRUe2>
zj-brQlrm5KV9~y|^71I7Ur)l0R8}>*Lm)B&<X&ShCeP>PXEfwCLn)A{icj?`NI6|(
z+_OpbqC--JQ@Yc45%28I`WU964d`qcup;<ZttuJ?906Z^Ql7*H2Gr#%NDAnuhC~j!
zN*_G}aq8E<lA?72fY|XiyhR|KT44I3xXNE6Ci1vlf^8$HH^nM2UA1z$zOaFT_VVF@
zAW6EHcfRo02R{Iwp*R2?gdP*I#vFFL;^DWUKd499n8D8ci5JFDhe4K|CLJYioqzE$
zm)3S=w_h;GH5?*;w8J;g0@`UD-T&|LtO#H>Gc7?Lyeg_=egKDVMLKg>|7yo{oY0N~
z>s1+TWo0Tr=-AIk2}pAbPiqCTdNWnxZ9lxSZsfxm%a>nsgf`F)?QDDFo_C$I@gH<(
zKXOLn?lPdOVT{{qP`CT(EbrZ4zgjElGSgO^?H_3PwM(H3y&uP@<5Z5sYrpnQVK(|7
zy|d{_p!xEa>3v(!J7!qdHks87=<q&#SsDGQm4X6P@)elsB0ZZr=doCU#3rY@!#ax$
z^iMKd(DNkn;-BMiJdQq*4blN!D!OF7-<T)T^N}LM+%SP4x{XXgt-4K?U4&sepU#cw
zMPsACJ-wdJO=Y6p6~H&aPdV{2v^{6F@k3g$>L2Es&4*1UoHO6m-zsnhOZMjz>Q=1?
za{P&b17Ur>Gqm&`=rQKYS)=TC+=f>1z^mV?1fz<NTlLBUymhzoiY6Z)zn{Gve`ck<
zL#w)m!<lTjJ!>whLvy4{Z$vT|UbBer7~8Nc9Kr6Q+g|3{R*f--p>4>9Z@CXPxUlVx
zKmBrf)I@-gkVm1@jJ?CFpyS+D?LChcR)81zn5#u3D>7N@@y@VOtXp=<91ikoTYX3m
zD~@xf*$>C}uN%+fD%wSx?TYa!ZHi+JovA@8&6~&7USQP0kE^V7KGn|t4qp#cesldm
zVll}P_$KhqoZZ8U<N@f=fWSIQ*Jv$$8SL4d;qrwpK#FjF&6~p71rNa&3W7D=V4q=t
zg>+!dzAabs(y=G(rF&obl)I)_c(`Phxgn1Rr>D*J;@M${Psq1nyWeAcbw6N@?!;zt
zif-Ct*G&9K;M67?rQotMWb!@fbcu3kjJvQXD8Kx7#^Ldn+)_5i|FMtOhg%}#K->W;
z-H!J{07XE$zcS2*HOr8}CC}GooTZ^MbuK;v<*V^5PObqnc3H03HB~}sucwNsK}p@`
z>kqAltEjN&K9QX=h1<`tyu{7*DhRrc7{u)tMctg{dX|Ft>ker2RhWDy&fjVWEE#6~
zhBIR`IZXNO%N}b`_1TI5C}$3TsC0<txk_{}VvnUIV69!!`+PlZtC>qJSfUa<N(biC
z!<szUQKsd9g5BYUy!#33`D=aW{8P@i?+VcZepKAMxShFe!kW5DbrxoFY~TKdr9*14
zr3n~$r~f>HFyx<25V=;QvSO^=j3+3p0P2eZN9VnPR!jb;^>z4$dqv)EAd;DD?FS1@
z>`M)(bmSPnC0ouN_)5V4<3Jea6U?VOT!&jbjqZlvxUwiT&u4m;Qspq4yVA6d(8pOV
zm?Lc6)^Jd>*PTf61G?sIZwnq%7RExjbjqkz>g4SAbE@9$V>LR##IhBYLLDn4$N3+=
zFBc;)9XvVUASovw3zvFu&LR!O@y5`~Wq?2a8zawk(fKIePBX`7bD+7mp{}mJ#~-f1
zdFtMCL4Y%rgy|bu+CK@93MUY9#(o2D9Sv4lE?;{+IgsIW-g;sP!Bf#oXvqlUta4iO
zzhJiqNO{IaR@|7*FtpBcG+y`T(&4=NXI4IJ+W1i*3@56GGH(+5E;Ras+aHx|A}P2q
zOeJ+5!!MxOsDm2VsAHm2<gr@=$XxX)QM}@FAvWu*(R@_Rd79!xIg>c18iN<&sP?&q
z1l%Lup!nA?BR{$V+z~Hv3qpIIZzuEDC*qxf46~H%lLSHLLRdP%tXKFF2+l%ms~C7O
z@^L(lwQr1A$4CCPt^WOR6C(PE3xOvnL5~G7e<?rzW7+D?5C{Wg^r83*yP`bQ^L!EW
zmNovr3`YX#U@UHpUd*)b0^Hn9QugzLBB9m9DL+2(z#biYv_4&BTe8WRKdF-S{v<?M
zDW5x2<^H$(Cl#aBenrz<Z%U{J`acbUbE~4DQz0!qr+2%0P6G>oe`OOg<Cgc~K+@T#
zuNn?;eRz!Z0B0)^M`ARhN5-B$ruM)T>wC*kgi;DSY=<XKnxHIM>=EyK-wtn`)K7`D
zSY%}6v~Un&)k;)F4s0R}CL6B)Xw%jweV*h`c!;UwcS}tn(E8RSyZ+!4q)%syxe|Pf
zrzxH>ej2@)Xjw&DXK(Fp5@9CC5H+dwK-dda$ph@aZbPLA9EMUM3y^H7=?j)y9mZ|k
zc^{G53IR0)5RczQwI`+IBE+<P2R$*MYrLz<9Y?acgVNWlhq;k#nQ`w=>_Tgtg|@KI
zH!VJN<hp!tblCUB>_>(s7RTy24d04yY`d(p_AU)#oPBNn@7{3M0hKeq_*`VH!5<uH
z;W=csiJWaArpsnF?|^U=1vJ71mR&jSOM=VB&<Af(uDo#zPxU%az2I@Q5GGApY#_k`
z-RPo{o0FtB>Q95ei*$er-)Zl@)wy$k>W=t%MUbQWkdOT_a^AC|7=MLB@vQWE@bEh=
z8d<{{d2WoRd4W>%1E(ZEYp?j|Fse*pdV`Jw8{40^pSt2hlcK2|=E>3YxSU&QT(wd#
zQm%qQ`O2PZr;~Z%@j&WsUk5dfkvT-Tt@n2gOHiT#E-u)&Zlr>Hc^;K=f<LPg62tTf
z%?}Q$GNY%Q<w`p<fkT`OWw28WcgBoxS4H=}zd33G3DZiF>IDyTb1(u%Li%Ogqh5&A
zaAJE((@;l}^=;KJjvPJb=nfQ|JbuHuGs5|uJ$z<>fN)s4vKOxCeT+Wv{47-gzTJo&
z!lnZtfQ^l#>T&n;tFs&C#xwEh)}nuMC`(?bzO@6viZ%R|753eYtPS5>bMR~6t5%rB
ztAlT@G-yVNGy8(%c0*^hi|2qq;F0`m&Eg;yQ%N>Sn=vYr^D70k)=7!eyMnKYR7DJJ
zn>bqVqay(-l*1C<YXdQ+=pr;WR1j~RKT?WyFVS{>$EED6uV8;ia`cx8A>zSO#0WfT
z2^$WK?5}Yw<-#A^v;(d7&lgBhLE3P6_#^@mokv5mWjDOz+yOnB?y3LHOF8A3O@=(=
z`c%NV2^;hdE}aM4WqvL~mFYpy2>p&h2)F;(yw1^_#D5cYBnpTVW+3Jlcr<-Wd7O{z
zg9G!l#f%M-u1@ouq*ty^;O_$t>0}tJL~Zv@qB|Y*-ULl>spYBT{nUk@Jee$R{_(Kv
z`o18g(c~D{k}K4J^&)G>ZYHeZK7rtTZs6I;K0v|uho8);*8WT!c>{rp$nN1ZHR%j*
z5_k%>8hf83ctAnJyuQ}{{a4V^1<@d)BOGLI0j94i6~>Vyzz1$(hlzWs)%Zn>x~oz;
z*&^#tagO53lYu?wDG9Iu%(UC3#k<~VtiyOuoPE&sICoYGTk`s(dHp4x+2?AAp78hg
z@y^J=<ryqCUR~g$zmVU3iR^`MY`nuLTKjsz--R9>lr553I7iS!yEvZvn(unOR*kD7
zV<mV0k%i<fG3Q&~j5T4g^Tw|>)}?hdcLK#Hv=4?vQn8eQl=o9LQn<V;axNpQ<&h#`
zzh5k6t=`TBscSaz_KjS^_F71#GhEYX@1%FV-Zb;O5Eb?j>vSE2>B5jcG-_7j8Yj+p
z*Cs%F@RmI;YoJ-f&;3u6o7xvAjLAUZO0qsVMu0<0?R>Hk*25Pr5mlvI%2_Zt$$r3;
zNWIgk!INRPj=(C-$Cvn7fBcn<K-M@mGSR0<-m5mfKLiIfg6Tk;bTe%c<FH<BCq%Dh
z<T>TZD5g6oo(O^R-a>xnPT!1o09Vd&wkN+5>(D7%tdCDn==t!xQZPtnT?Ct*e<3Np
zs{=|qA5MVE>`+8YQQBjzPwf|*HG>E_y4}TJI6q2Y>Tga8nOknzpWtG`EP~0rVXkCY
z+U|BQcZaQK&hk>J@dcxeVKmKn45=_B%|;cbEHnuoE9No9ans+_i{0bkJzrWa#dgA@
zcph*Twt)~$F&G#z7@vwh327#uYbIzR|IxmxQDZVd2yzlzHNpG_B0T%boL!|g8zt<N
zD!cWjnivkCWF6b*nEoRN!GtHa2_*jgp#0Y;s3+wq3PS$+Gz*YV&+b3l>Kcw1Uon)v
zjG(jC7I@{*C6iriHKj)>nJ#XsjeN`co|G?J-TKaj$TYLN{<FP`BILK7l#1$g)_h5?
z1lYYe{w$x}_J0Op4YJCM_h!^yEP}ENR4GH?(B#X(Jl&dM9?Iz#Q?npIk>;HtC4J&*
z#kz+q02kp%5Ccz2l}fwv<|tCg<0F0_XOk!qWTpg=rDMefhmIk`NHCe^JVTl^X8)iK
z|0G}Z&9#;@<-m{{jKR4*PJU5#oX(E9jjqk=&0PqZl0)adgU$zDe<Y;#;s0RmHScve
zvd#l7n=TkGihmmhYGpq>pyZ=fML6sJv?^VUV~y#kE4@!tj&oU3yDM<58u~z5MlsSy
zKDPc#71}6Qr#JL-+H)%aKp?qF9)=4iB3@2-c`yWo4t$Dz`9xs~N1z`LyVs-8SJx36
z;GISsA5nZS*MS0iGSrWg(JWhX-&*49>|EeVKYV}vm{Ac{e49(Ndy5+>?O4T$XCg?X
z@Qt0`CEdJ2{GVSGB)q!c?;td^Ce4Y*PLoCN&q{8_W^zqB?YlK*?^!7X;%x?-g37Tv
zEQgTz6MfFrB0K!CKT)BMVW?5p?sU1I+iDafXC;koY>%T1dM3f~-8=3Tq*=YH2oPW$
zt_S(V6-2?qtCz1hM?$MgoCgW<%DWwN^0!m-gI~mP*ZX1=F#neO{2zHRptuM1vkUt0
z0TzW`e?)=ukaa7S6+hm1ys`f8lGQ>Ai1N^aCEL9gPmDX|cK|hpR(lXr^UqNxicvCK
zTr@KfmcROCp}tU<Xa|bSi*>Kl95CVKy!aY_e^Efs^Wx8UYF$t#Ao#7;pjrOM8<-Cs
z<7rTjd!%5igDe%%C58-}2a5$}teGXufZ#|sSOlrxfk&rV<=Rxp;7(eNe6sM7U1L>M
zyIegu!NEr`Zo}DW8d&pIws@rPOc}xG5f7f9IA=j409aiNYiY0<@;->s9_Tqgv?iGu
zloeI5db5AVSXY36XNQJ#2le=UMr#o)5f-dvc{$6M7JWjD&oAi!@YhnFl#VM(xKjj}
zRg%#0X}2#F?>FQY+2W^UGx2M^#fk1(FnnqwsRHmciFWY`FY}D@cEvh+>r+-L{4x+q
zzV>gX{uRS5V<t6L64~SU#p6z|ToA3uO#(lnw#|sAJl|Yh=o_CpX6eXXL*CE|>EgyC
zQ2~FPZsPD$V%hB7?s?F6!F(HOxT#L{XGmE~k3NKySrEMrC@s<p(KHUB(MEWFfoapL
zu^-ROYvCgQ!9zwE^!qxklc9w*?>Cyxb2`KN;4Odf?!~ekhM+21sIgpN2?4zJvLQa?
z?~2BR+eX{t@NF0Lz1kW*nx6BCkDyTZp!bbYktd{1-(DN(e`pHk*YiE|MRl5;J;aKP
zLbey9AU1kz5l%UwlQ;Qe5yjSzLFN5#-p&+O=8IoXIlNWNURjovps1pG5pid>0{drW
zl*|{@=QMR!CYuGfCjbl4Udyx1Zwq`oiGSmxs0}<|ts*&e$w2Znz)ix+7Y<kdfE^;L
z*^MwbiR6-<6{znxwLXkp{h>gDsfz3tGVHuDT}S_Tn2vg<U6K@nJUdE(F*v@b9ULg=
zk}pKc0kEEOW7*;rVR_)}u@or$<mFb5z+jG5MS{LKglJ(JZQh^?PGk12o*?&pE5n~b
z3@uEvTL>cXo*PmeO>p3YHyhU_?@=M%%qztr6CSc-#=#OBM+ziLvzD}iFQyJ+9&}-p
zKn4$LUstV{z)|Sy8hHbY=TVH~G}`v7uXLGJXeIvT{F_2=X?i37=sC_gQGxX)`FXmh
zR^x)dLwgevu~9!!poD|gS#idz2jNZ}>=^2VD^UGLp(no3`@Dk_Tg72P5VKa=A|~!H
z;o=vG0p%YKljTzkyqy@3BKu?FN~>N5!zi41#AU<<3#HDdw^r+z>1Gq29_8)kvFxB^
zX+t+Tt7Db|GGlBff9ICB)I$d_oZPZ;iEbnv@EXd$B86dvd0P`%*>-BQTl<450!LOh
zAtiWJ9}0`>_$oZU>q2^77dzZs=<NHl^QGy%Qq8nCt=nZCR8W4OAZiama}K@Ab=bS&
zEckzYh}+rfl_8K>jfMr%*_jfyAGQ9?AVofcLTRNuSF%$lSp`TfQ1Yc=WKqc2RVWFz
zuApvOT&-*YXiLs{kMcKr;Uj;`1TpJgqLvJbFEL@wO>HLPgPl<6O_`1%%QleK3~o53
z3{K9`S_v8_pn-|kyIHa{=q=`rs?nYkSDuCh$!wtXYoMpjl{^vfke~iIZQr!dI0iWK
z=PcW(r7WZV<fHPKsoFpi<M|Y{!QbJrq%w$`GQ?uBU>@y~jsR3{s{vN?kF(B}(Qb3}
zs<UmKc`~E@dmQ9&QiB+iP5THGX4vO{s{zE2`qk}y)XE4y);~-3vz+z7;YM<6o=p;@
zz%Yw*oefiYWwdLi(D0Wju*)5nfu6%Rn$3o0nd41VG5maK-AKeRBNRLtDwmd{Zn%c0
zafE|!WckjDrB9&hHCi6COiP(Lcp`2nz+0({QB2XO#tnq$%Huda?h;Uc^5Hk1?ceAz
z`Ymw#FHl6S1~d*!-`}mRn2ffmBx(j7<SZWjC`7af2r7}h`(>7j`?rH6=zo))$Ft)l
z7=KV8OCGzWrGPAK-CC)q^%~a-b8Q)rGOq)2Dq=+psVzo-8}hDsQ-i3BrXN{(zO#xk
zgo#Qbfuv_Qb5%RlR4~JX0sn23g~*FhDdq9#O?=O{+X5eaH;uDrtrk@0=E2p*pQYxe
zeV}v5FI*WmiDR1Nt`=N191f1PWaU=ZJEOZYXANTqx^K*mITkLDamWe_3zwv)Cy2Uk
zrBjx8DTH{11r#mr(etF@6VOIgzsADlq`I7eVWg|P#eb|oCIoM0z~4HwS2?EI?Yp!n
zSz%l@vyPUOR20_lNZ4t_%^(V0+M$kd-Iwzzy0u1FSHBI|aJ+YDDeh*|!s{SS|9R_^
z5;4U}B0Z19eHzxqB9=I*y-*LL|1J%zcQ@|yF))ZK28Y@Y6<2R#M>6jNJ^S+Wt|#+0
zZ2p0Ds5PH;XVm6dlw=PUHvh}IK;RF&`%EK{C`ic8H(Dgg*U~I{4iP*;0NVoF&TLRy
z%6Xu`9$XDihPZvNuuN)TtdkfQq5wLTpBTn$)UFaBfupO|{+tYT8n(vUul|@RkC_T)
z3wbzi=R@@Gy%nLUswmPZOi-EKU=@Ur5EREQ2K#aq=3L@7mnWvF$iT$>2iT3D^M*i9
z34S}C$?Unx=Z-8ZCB>fT24q!3P@4lUU2!XPIb`{2gf*a%_d{Rp1y$bTL+_G)AJ(J2
zdKW^;nK*v~`eUsll6Ssm@$F;$3g5{3@aRb)a3_lf)ETZ7(=)zc&cc=qB;`?28n0MA
z%lU>KCf>=HevpEI?l{l|hkWZXW83ZW9jC7;=OY9rmjm|GETY_WTPX1*u3<?Th{2$M
zo_-VJ_%Uh;$zgxvm(m&c^dduR5Kjj<Z5`3iXIi*6n36iWrfe`}){7>88=~X7)n8(<
zpGm#vfF5byP)LzxwCNs*DfuDU?X4w#K^)wnx))@vNWFLsD31E9`ld6T#>j!tDEH%v
z>Fz<h36qiR^PN_hI{-kq*w0a;EAc#)Jf<u4ZHsu%I*x$1*AQx$jzK@M1@a0_ET;O#
z%g^G7|4cpkIB9ED!IsL=Rc2PwS&a?+9PMWrqm_xZu>d^Q|A2nX9vQ?*R-G}cGGzIu
zDGlyG`5~A|g2mZo6=2laG3qkCs%hmKkM`qDVg_^?wlNII$pch;ptQ9wcN`RZPJtV6
z94Ozyv(`m{*i1nh#iu;=-E3{sKI%1F1r49}k)dHOMpAO!h~w}~Kc4BJ=a*5a^LRbx
zQx_3rju@?bPNJErL6Ixy7*z;`ahq#&XRzxwu#Ga<vnJtb`yG+2t(@LV>;+Lya7Qhp
z?u&Mp(l<sE$jx5hiaBYTD$IDL|D*&)jU61#;!xmBx454^4N5|@gfZ<I;)Ypn*N=mo
z6sY^CIe!4uaQD?xWViP*GOcO6wbC$<X^yV$P>q#J6SJtMmcY(Jxus-oMgn~?FRMgh
zB%UG%K7A*Sz{O6Zb<TR_(YF)H5;*Hu<BS?KG0=;?47Vg>Hp5Wk-V``a<v4txpoTU^
zC{X7ipi-*5)j*{LNF}iDvxv=nXyr?ArUoqZ-uuq0T6G}Dt3bRe0v!~_K0s@kS6?FU
z4RUOVtv&Od-cFc<-m|DQ+kwPf`8~TEYlb{@A<1#MOH0Yw_?{5ZQ42MZe#}QbC)`n*
zsL}z%`<d&_)gLh14CAtCIv!=}?RaN;Rf@8SA=P8L8-%FR|L(A23?si1=Mx2E3_V?~
zjCfx+Q8d|I3RFEaHfn6g&*8xtTDX&`m+3@C+6R`#cpXvnUU5~}J#d{gSHpyned`$!
zFXk4|r*ibE78%SQRFGDSl?$>E7|B5eOiNd|skM|wM*1+WWcbr{WcQCWDOOX1IC5C2
zoASK!ABu9tVpwGKl>MvyW{`h9B*`D3(@de~#iku;UMlXw3FhM*Ciko>m(xh+M07#&
z9LCPyxTtHU`3V^W>^YBw>zu`!lej61q<{J~HbyWyZ@xwRnE&wZso{R?!>I&Iv8H~-
zRhTp7umz-|;?<;{T}w($MFWSdNpl}LraYgUEJjN<iZW66B4JyU6@DW1G)+0I^?SKY
zYOKu46Zf#(<HzeX{|KoIFtSmuXH#F}`k8u(z-gD6TC!6N;A8ff+Zw~8<+ku@(NP1A
zu~cJ_?apjF*eU|jFM1q)vy-6<wv?P=tfUq<!A4^ag@FoNg_qdje{2JO6~s&ts6&}V
zEl1sDjGf(XifKMztF5L~gyqmLbJ8XLA9hF|Li+!o`)Q^9f;V$oIlxVN95b27S?Jjl
z$Ek1NXb6t~P5R3+JL7xdRw#$#X;%<}3CDh@9yZUAp^ev1**yT1Hb<&qF#OUP_4yHo
z+>u(tHTtr0t#>TZ3>vr;Q=~8=9_F+Af6R?n9&5I3%8IinLqY0J=cnnuXC9%6qp$QC
z&Qqvxf<d_CUFp`#H^AR0rx+;?iB!3QKw!h9%Jp*jMTb2FDC|NbnDR=Q_(l7>2$9O7
zAysVx6>!-*F8F(PHG!u#39`U?ZedrjpSpfZUWBL{M$1}3W;DNY)(7AnB*f{WT`Oh$
zM_u&HDQ%&tN-S?ZZPsV8thOBC^(O<qEh?tep|Bq4(5yQls@yIk{XAJT_M?>dYfE!6
z|9ZaTqH2ZE;ydL`g3F~;DW(w?+xyxkv7ZjEyhpOlO`e1gY!l3pSL+5g>BX0Ai5MhF
zEL~`9#fu9`cKcD#I>dFFC3A+xn%fhe^SrdG#cS&d!vr7d(N?&n)x3@_!4=-p*<UB|
zZ8|AxAb1$h$Nox@#V4d{@4R`ED{N%5+N6x^Ka>R7`sWfb#e!ySW2F_C0g4nk2Ks{i
zS(|L9at<rhL10`QT?amM`*SG<-R!6i-uL!wy(&N%zo@}Zj2wtUJkw&;89@lJax$GN
zK^xNMyacN42>?Zi2XZstRR3a{+iU*UJ6XivQ}&G7V>DYKEL?yew;D`>vtNiw8l<Va
ztikb*nu&z_7<@G$hnb`-jv<)kAj;qtru!FT-cJRN@Q1b<E+oS~Xb8mLH-oQcpnCU}
z-lHZ2>wXBBXS;|Je<nrpCWr?=GwNi~>)Qa{OUJ=G1fLZsTlkFqryCr3@`*HX=WBN`
zVsxF+RvA`m)@*h4YPg4a=!#(jO$8|+*%<eqwBhR%ROwAPSZebJ<?)xcYV)(Pvj|b@
z-swicifEBefk_m>2=$7xaWm3icDXFOXfM0~@Nh=JrjJypPZM3+sH>4rw(Kasy8<ZX
zz*JXau8)~9d4)7XvJXWyqraGQbN-p|$r>NwIIGkfE^?4QxVlar*Jl$a{H@Rly}x7;
z9}jp9ZJWxD_xKF)zc@tgNz_6}t*mBNu-wFo5wc$<dT5zYH4~%KwmcFLeGZUlhOg@U
z@;iPM@Cl%740?!R&lfLHg3SRFKd3m46}SSoNmHlpqzA&^@E)-#?ES@e@(;Hu)yyx)
ztQT9Ha2LGMeXeC>$3LGC9J5F68_BTryq+Lg1rjN~vorNk0$fNDFSQuKt*fnOpl<X}
zB@y0jYd0^&Fm<kT8e{TmTyfw2HrX})j!n*P7a8h8NuJv0D8`q^xAb>?7%Tzh^cWDr
zHw`N`L3p|!LjfB*Xge@H-a`Kc_Pk$OD+WOP*5K-1TiB{{gy<le{w9hkf@?|~8>+k(
zlDu*J!CPceT^{_6L&mz6yN7;7SMAh&y-gr&eISZLLO(0vvra~^NIXzv{e&hgG|^50
z_5nHS_AY{b^M{vjGqw2;xDH)~Y0{q`3=DH+ZKK@TYiUYzt{6>1*f?(p1V2%<-0L%D
zWCd!3ZsEke;+*@4J6QQU|6;O}FknU`fUhb<Or8b7WkGTK;{c+dPZWXGBp5O`U`Xml
zF>v7c=&JY_EA=#n%9Pa^J{p_3R+N<}8BUobjdP>IL0Zb}F}|bs@yx)U4+ZM0Vu(jj
z4#|5Z{TL1jWgWtrY2216Y9^)Rhq8?(`P>OUd~J`$**WsHNx6myD)$ROuj+NY`E81V
zcKl7g*8!~6&tS&C)(QN!pdTJ+_C}uC_>v=$dWRZ=nYc!wQWXNxJkGGxB)wUH%UXgD
zF)Bao+1+SVtH4xQ^sTuBu0GV97Ql4K;*BXscJN~jc{;Sc<Dsh~dgxjrq_{jY9im28
z(dcfK@iSD;p8*yYQlTd39}T8rfQ@<iEhN_dJqvpSBEl*Ktfz%e%G%f(q7$>v3#*DC
zhA^pxEwnp^!krmRM7UvQ57HYQB<o9Rq-aeTn^6sGP18RbYTve%bcN`3Co8&Zie;_<
zj-3p!gPmYefX}v+$O!^er{hm5LYp!nAF$yBeGU-or?o?4#DgYhkjRBn`u5GL{(77v
zP{mP`7m+>>Y+yn+2TxX4DUbR5{vS5#xr}G;Y%@O+U~_Nr!nT3Ht@Slj-W%{W!NOf;
zrF6bxPt)JCBWadTNP5$%MqAwv<uY=>uKW^76Af<)jUHQ|)BgiPmFG8W*s(9l-9vQh
z2_;Xp+V)d)uxu5mBbUQDNs3A`t1cUi8ortN%(;I5kBtOGsFQl{;{dL>1lI2r4_Vt5
ze+C#dln|!Z_nnnJ87mv(@U}%8OR9(wWW@^kY5_^hfvNihV!~;rDC;$l@6SW-MEo2T
zZ8DQyxb`g0kPQt37<d#!ngMQlef=r)GPQE9Q%Tdldi-=MfCZW6&}SY<WQ`#eXYSc^
zj&`eOyFBtGXurSDl9>@U?KIbLw<~tOE@Wm>4N?v_O^G;8$@J~86UM@89eh(l3T&kx
zh%vgr7T+@QzhrJjwu+|fnvxhGKu1cmE`4!^Xh_u>nppxLr+)6Z%T%v4=13U!dL_JD
z!%Cm-jMbUPeY&21R!V&&<FQ&Q6CwT5{;dZ<GuluD&dv2o_r{**%HVwIwaJo5hO!)L
zvOI}}F)u?aNzM`B1$bap0m9s&hus#m|ATLoTw;dbgUqy$(iZr}?e_mAv61BB3(}0t
zFyn*Cce^~8S@i6(+Q&I#BlMd$(q=KcO$8d^l<8TxrGt03IHG-&5G8$zbR<aL>6TLT
zK51!*t8U7}2l4W9fOE$&dP$FUF2aeOOj}snXa>&4nP3LPjjX_d9_N3jx;J4S+q4Rp
z#Pj4wFU<>fLFKHw{%obaVcZ)ox&0ug?XOl)Rloe$yiecIwoD}GUy5oll`^mbgSDAg
z9rv7g9Ev(Vk+JM;QB51mPc9|DZ*tlr&O(_$&BYdrf8pu{T8CxJF6nBo#AH9B$B7lH
zvYTu(cYRE>BQnWyEPo8=O{2uMN~EEB)BI)KzvX%hd&_+@E<dO6kYx({HP8sJd|I-V
zkTHi4s?*#MI3I%HQ|HBK%I^;+r9xJO`k-UO>F-*u2?9(rG+HQ!2IHR4GlvMCM=r=^
zx-x%a{HcG!wBRcly*4qu>NP;p<jr@bZQTsbkMzmDGK=g1#WZ?==g*nrXF87w7+)nQ
zvDud*8G49=UBvU02i>*HYk%4x-aej(Bhw3GlIb=~Y3<pK#MRI269m=ef}@-2TaA9n
zKU)$pK*8GT>AvT%?`~r9GQ<oanYoJEM?(4#s1_CewoS3YLf2*5W2%*WA{H;-3~9QI
z^<|EZ<SZUXrVE7T#Vr$OeK06+Q3yoeW_UE;(EH7S4Q<#-CXMLe*ayKD-1yW!Qgwe|
zG*6Hxf@5@5N`-m52zQuVvsgwKhI8e3Yx1$xgS9>IwDt5nk>d_B*YP^GTSat>7Tb6|
z>!!jAN78RY@@f*I7!*h-1{v;9_vJw5JlUvn1ygp|49X{9qDf-1OX^S;{|?!8V-`g|
zy3`7;UQQ*f;m4WDQ-;wtz8{W{WugHrdgH{tWk^Po*r0*wk9nF4zT!597@QZM{%ysb
z-ihyY?24yJS}MzbjL8x)Tftt_geRv}Ke~4ba7Ny=Ub8aoe=&XsrdeYti>0F*Z!wQB
ztkjb<&sj|npeJO3A_+a>XU3l)4Yn$;9w7>8=z-rBIXRMA@Nvwk(nwai%{0><4$-?=
zUA7C2XdCV}x-veL8V*Vfh);x;=bzURJwq4=bWMKFnelyeGN6c>+wgY3YC7)^crcTm
zdxi4kVJg;Nh~c5E=ZsoJ1Er2_gH4j)LPct@H^VRvIX!YJ5Hp|cr(x)1eE7kRKf@CJ
z{C+a8*X@ljv>#`8=!1#enWhoGf!}!p0H+$9WV3>~sdsy~!PulN2Ao}gvN~0_(am6D
zDU^kmygurrJ}q#e*hMA|!?k;p<)&L{`33iFyJS3P5V+5~-uS2XWD5?9);lu`7mn50
zN{cVh#ak!hfnAg(y-5$0DcgzL_lbsYe^}g3v$0laDB>^E_~1msLM?Qr)jc_TcT8M^
zWcSr2u&-0$+Hf+c@3p?KaoomD@n{GVEegV$%2&zV%UKG{>TRZf$hCq!4M2q*F{+1B
zV~6N;?2Uk<m7nGED~n!LR%B;BaAp`X=E5j5pBeRRS<}VL2$IXUs0mB@=%7`7K7Ytv
zD2!g6Yhw%!x7(ct;=c@1e0)|YQW2TlzHK{d6mGmo+NjWKFsSJKeq?&|gJFvb34N!?
z0oEOqx-Z6d^=ILpxF&a#Z1-vI0QQIzrI>M+wyW7&2wOK~ChW4C=!G8nnlp$>I;+o!
zon2~Vb{t#7{l6*|DloU2G*RH$x&7TOfE4K?y5wZfYG-`ax}?Yu=s{JR@TAai?{HJW
zE(BtR>5Mc=V-n^!QE&f^#K6YlC`te~)nSjgu6um_D<EMT`{(R%@)D!3B5LP;=I5%<
zR$|m*>Q)~n%ul2f6;;?oVv2c2PT>(C+txq@;v{@Pu0=2giR&H&cfli=bQX^kpHjL?
z)@#0<3s(u!Nh2o};4xC8v+}|ZI+oghtyZ;}F_^cPz^q+o?Gi*MqrF70{Dio-RV`j8
z!smX>Tm1!f0g-FYZE6fKu7JZ-1NH*Xx+T0^CsA&&*m#o<A)FS<_X}q=l!nZ6jD@fk
zkJ&wYexqUf0!+Sbl}R)2(WK=-6C>z)OK$<Qm>YLx#kY88!g>XMNd_KGxB54z%5FvY
zL)UwE$k|`46su`(#PrQut<kaKGfCsl(?~RAE(?zP?2zqKq1u*>EQKDt%%_gQJa}LF
zU#h1*zX8eGcvYSKbQtF0QfDb<3qp%GJ~ix+WoRQ|VfOJ~hME(O@J!b;n7pN=I;d%_
z#XqD3C=L}!oN{02Z!y+1x(rsOZBbM7E!o9{`>8RYKU)3bR&QS)I;cw2ZP*e4wjx!I
z$tDW)7py6C4^sh!n<T{qe{iPVijwtu<aV{}0QAO0*-L~6s=2@Pg^tybSe#%+iH3AW
z+_({ZErvBkg$#423wpNH)~%cJrwO%HQ1zIC4_nPZhjRDwbKpQEv8rm?-r+1s*cxZD
z+ntqS8$jdCeni4FOB(&6ll{rVdEK>@iqfWPnF{-I@t_ejVtlFn9%NIZm`<JS9|ZBa
z<di`Hx;b}mK8^^K`*Ux$chZB7%I?nM@czz=7l+?kp1nMomnDTy2$nh*plnHa36s%V
z?fP>KS?~;LHBW=PRE4IW`M4+m=jH?UMV=|Cmi+NyxUqYa{tkib=HsJ0b>zt~bDkAd
z7XQJ8u^4XdV}X+E+io`PFJ%_|=v`E=CBmQSoG8%x8MwP+Ci*ik9ZB%kH>dm6E>TYn
zT^BApS+vMiqGBeQ*}Z0zY_m{GcuO|1R%H&2m~$8rXTf>&V`6O5>wky2+%jO}5b?En
z$;*Het5WKPO~!EESIlaTVxzfLM~sK|e-oT(o(qR{3ezw^pipRzB{Kq~FQWFYV0OmR
z&j3ECyldX!y1Se6GX#a0K$gn3dxsZ|&!#mh)C$0FE5t?95vU}EVR@%$?<99(Rwx$^
z(8W)G+0NY&Wz1dN<Rz!>p<mkSYdGUaynqspa&uG#VA6G~t62adT4jL{-D;LI6#4i}
zL3Z!u^X$2zZYWzDiaTZ+l@VV0!4ma^2%Lu^fDQ(pUc5?RULZPWYJOEReY@kTXV*_r
z>_$I6(UBV)-y&(7dXpy31GyCkjrE}@H4-V}{%)~S%kU-t(o?p{3s|_yGeU>{GzL(i
zvHo!^z$5ZuSowndTDNU_xar$K%s9el@)g{j)$?=|S}+DN66a2~-MV8Am%+u(WI&?&
z$V54~1~55CyDeRc`Gqd7Ekqj@X61wF%s^C9Cg%dF3I&tT6?85ho#7SAU(I#&gj=)q
zs=~WmJ!viCP~O<~!xb>jjb9P0xj&cF5fpju6C^0n+G$l!$@Fa+vQ8kAa0LE!DNaQ*
zRxQm296ppYC1zFz5Cs72VHM+wP4|>!zUF`SvppVAn+@kLhG<C4+q8&+WB~-s-}1ir
z_x?7@;;_t2N`3KtWpz0M?}m&?;tH#x_d_cZ>V)}$Wv7u&y(gz4kH%ks*RRXwvUVY*
zPx+}I=Sl5YW%H}By^Vf$uVzx4^pr0ID6r2~dkISz>W$3IdMv(bk&^T7W`L%-ANOHP
zRO&F`WhNUD17W)`1`fQjyPh|=Qe49r+5LW`?>D<M)4t56gF%bv@cYuJtw!SmB%87P
z8>g+yWD5(QNSV8duYy!5rE?1)6Cf-88o(KRSi){}-I?4?ie{S!omSBWIo#6s%7C^e
zI5FB-Q?x1&S8bC^kjKx`@(n&Fq@dU4mcb^<b1wuC>eA#-@OIN}5=JZBC05fFGMQDG
z!quODRIL7weIajpBc1vE*)eugNQKDS7{9u~mCMiCbl_;(_t6M*n?8?8wGWZEoqQtr
zfRmh205B(w&vL<Z1~Ck$XoNkQz~!y)hZo^4HC1kaGFhEr<1pEmjd+!>O55W%gb+)X
zhlc$uQ}YRT5p@mHa$ECm54Zy-B9+-JYm$SBK-<zrG?ij7x~%S3kp}-ZLAUO8pJK%*
zv}QdoLAHlkXu&f_XgtK^yF{u<5k~1{2N~+B{L#C9i&t5F?V1oHIIyIZOG`Q=cn+@g
zX||bAv{}<mSdTG6e;VXrbBsTQ)=ARp52v3@HW_WAFYT+(Y4o}FC?Auq1wQ^WvLP>W
zI|qa)1Z$?<jm>GaHns%+rXpVdclqr#7y~OJ3L&o#Z3^8z@9ENbt}A(N%%@v~hNP9M
zuI5irC9uM{UsPD0?j1%yR;@+r7)|<4ao~S_h~-3+CRc)|^qHUyNv4&luZ(2ot$EDN
z`t-p@hn(#2H>$W8XRhaBz>i237}?r}d`4K5gThD+>gmF-wv?2aw~~XJq@}YuNYm3;
z{tA*crJLYV?jiK%O)3(<>l;y)01q?b=$3IR*7&tVfC>pFUl1?MF7N<BlQ)Aj85f}w
zCfX|6R3WObYLE*fT~d~V+(39}W+h)LOk@>FW&i;7A<Mz_`7Ej>BbIZFO;t`?pS}>D
z<gHSX-8ok}ki#m}TBQtic}ZAJ{n=lhdwS_KQmA+9*JN!5;e3GF>b7xHa8%zOc9aUK
zst?w?F(H8^Bc>7@?xJghYUhEhz~ySeJ0k$k=Fr8xbn^gBI6ej0I~C$jLXAJMNZP^2
zq8eFjL5*IrMR>P-oSS{gL_2a;YG`8kHI7hdi??T*xC_47C9OE~xNFo5X&|ymwoe3h
zJ2)`0DaCE<*hV$}G-{*TfrA8QF;=$cfql_X@YUdOu@aV(MTa)38lb(ksmUlcCpJq8
zho%6Zz{y2E3gDIz7dXON_O0*V0?emdhIJ0-RGIF)DYb&n*gpt9`oRi#!~-+Y3d{`$
zK!n;0>Ijts+@7Gl=_T#b;RcSCffEe4*<+{C+Kkxpn{F5q&KP)8g~4TXGw4WORCanS
z9zcn}-OqcLrdN%?-#tZ2MJTKN0E4PrhI1`-L?D9G){foPR|6^#3{~n1$h2dQX!UYg
zdblCWq!|o8lSBeMU8;E`6(~wf^F;~^ZU6gV*_$pJPol9`8ktnAJr%kJ+gOur{>?^%
zT-}YNTd<uLJUdD4<@IMN8}Y9Yub$MOQg?kt#5VIx{DCOw^jz<ya(MLFYM*sQPlPbs
zGliq=)>7AFQ4(Hu!=OW=bkET4|7-oVQ^Yae*+2F~FUVGC0EcSu7eFeU(BQd`BAMIx
zvs%5#Z=Ckk%N)CF-M)mA?R@>P0Q9>}wHjD$Ng0;hXpnU_qqv)AtChB@PurRY=-5Et
za2f&#2*K$d9`3G`X6r6p&q7tqax?Jg5TRZ^E~E8txr1N-i8?O06M)vX))vX2I}}xY
z?&C*(B1tYF$4JzDZ$0`>3YaJ!{>#0fVuWmhcmT&SsrGSCf=5cJW%rzYVVaWK=ZQ#v
zqy2<WpS_R!o9<~?O6pNzISW%YDT1;9nk7aHKq9c#IOY9u1&e<jI^(f%)o;vM+(qHf
zLa)26{z1&@LfCFjjTxBSh_kvk(V<cRv?Z7p;AwC~Gdui9iPZ~HtkZ=q;uD9~T&-sy
zz1VTXv1uM>89TJMuOs?Vgd2XLP0>UN=b!v#x`MG$n|iC{4ZFs~^COZ28@DD#$q{)N
zJ3O(wd|OBe5<1wDyC#8Up7hA`)g=a?oQE-ZsFyxgQDqW$jaH_dr3xB0&}Pj}w%dWN
zUwTc*N>D8yXu97KdLB`~aF`h9Bsg`{vsucb<~%R=%<&l%{$T4>=C=A7Dh<bFp5WbF
zfyf{J%-Hb4wK7}5EoH7iBcL~{wLul&WFp-%=*?dMol?~qI0Sp#JV|5yPR=kxYJEkE
zaP{aYMa<j#REw3B?qtwezm{MAv}F<Ite|VX0Bu`Ye1&`h`}$ixP1VEuDO|>{@R{lv
zMHNqFlW8BF-V`!6yyn&)cN(%%kBuqKYV_jXaCyGdz<ntvs-M?4d;pO}mK$tNjouZb
zvb<BurY&PjbpIsE#ot-q!yV8675lOzHq(<a;MC+{R%02sR&%t}Uf4tGBnNno=~%_c
zxFws5X!0qu*xgr6MnxxvBaez$sv$>E5r>0bxzVaeUI6?_od&+^w^uVIA}L318dmGd
zlameMhZc`2r{O!XwU3qggtx^4To*E34x7A{lhg%uH-?C^HsK;S+1Z)NnGUIfN-6{|
zlQoGrM;2q{e8JC1qACX|Y>a6+YV`eomByjeeKjWzoGF50&HUe4N!f+g9BvB26$sa2
zx=Km;i(Lpl9`xPte85(_aEl)O3;V4`Z%noipDBrt4$48$=0AXFU7?|+4^5RxFh}g>
z8i{OqxuP9VZY%pluS5-|5Q7C`_HFWKl~ERsAv<C<a_(2|T>VWv*kgxz&5_gG8A{~G
zi26Sr_7hnk{`~{?8}s};YzeJ<%sQVQR5z9Q!98D+76)-paaaZr=zev)Y#W}(?*tFa
zv-xb|O=Xp=b!>mLGiVvlaUspO5qlcAbH4g<83ezaJ8GWz;Wvn*d||`hewcVk<In%>
z<4w2t@+m^U=s*WXae+zPd|~c^Oz|nRJ#EBNd(cI8lE0gp&P97Cvns6Mvotc{d;Nh|
z{GRe!JMK!_0X6S!NTkN_(WTdzq-6nk?f%$~LV5`o;O;aBd{lF`cPr%Xn`(^(xXSqa
zJY(j-4XTrO;I@`o1T7#JY|Vq^K5gcSyZTWF)BoVXykwu3jAcbxTMpuf*7}j?0I{;1
zTJKDjc(=?etP5CLLp3+?-e5e)GM$(jMWz!~eJwTWn(BFm1dSdGA*BKrme9!1*(Tlg
z(E$kZKk2iPgf(Z2QoHopWKE9BZ#X`~CTSUY9KvB^$hlc+M3vFpumL-47%#C2I~`47
z3)@TRR8I<uS>INQsf^DNng9ASMpMPc+5*z&tFY2y7U;&I8YFlVg^gfyzO{>`av?27
zEi;m4;E(h-#_g9Cw~QXk6l}-gu08LjA{p8pLOX!5JlIY?NfJmG!LsO+YOk}N42uQ+
z1lqSXC5974qkvvQxVOvUc&{?)x`Q>!9hcz+BR_k|{f0nx#1@XDcz=+q(_Z9GS}?LX
zzJ;EFEh^u><*n>V7IfqANoZ@B$BbNjtuE9*r1Jzk9psu{Gq-rRJ=&N9TN*8SLc^u(
z&fHekyCFD6A|1NEwn{%~T7(eAko~ZaxH2JT0eN%~`%H75A|f047l@FY<q^Xoj;^-s
zF;Vp5(f;3I@K_Nl?(ZN0&9o${>(l(+VSb}4OD!wXJ1SP_5-Rze+Jlvvhp{L<kO7>q
zGM=8kBhL?ib%ZG?w|K|UU93JzU>TPM=dqspy`j`kVnyz{o7MtB5OTl2C=Y|u!;BV^
zp9IcVg-Qqz!4!a`MsAZ_Q`wPm#J_C&=dK)_LJBY){{woLuo2>Y;cgplX8z_GwF@Gp
zF}fc}OvF;ywL`-dU0W0{w%Dc@4z?|1n;r*p{_cot1bp6a5=|!aHUb05*=^&xunkRj
za`CjQ^4xKp^T_*h4}U)<)Wf|LQ<(h+0<LHFm`Grkt@qZ5@=GUc_QL<z4}N6AIp>00
zR=cO*okm&{0(OxMldoJ~8n9Q$sl^5dN6BGgEtPQYroo6XNgG_s#1_ivtn%~uaeEOY
zSTdqpo!8N;M5d2a5?nDw*@N)`(l66!t6s+*&ei@(&hPtw_0mHY1log<)|2fzz+!70
z`k*;QI;6@a5}b%NP&^+l@t9i1B8^Ckh86&?ff_?DLu8=O&dkw2b@NYvYJLc1^6Q+4
zYRIf(uOzU-ORfs8(~qI3Q28qsJWs0bcy9~UJyVx+(&XaI&x51LRflzL#0$&7{T!AI
zs9a)faeyKLbIT^f3x_EQVdnJ<qWp0#6;i%yp)ln$;B@Iye1v^Ip$_EyDLM*u6C}we
zEN*au)5Gi}at#ilV9@TM!VirKs2AE*pmIP+BK4bn98dh`-DlX^5oCGNQsgawk>;fx
zI)H^-5mUkiWsoHqjx<%+E>I(#a;P0+v3g=$$FRZ3vAsilEmpV3LX-Z3ozLq=<fl%~
zY?#4cx$721@&T?N7|Ztb*>iKTA0B2M`aNZ*2SU6g2M^K{Lu2~atSaI4@M`Hs;)Ioy
zmn@wZZL=Gi$JL9Z+S<fp#r-B9HRs_I!PgNRjiu~IcMxt;Q_jVlA+eUR(;C;T*k!#`
z;_;s$ZNcJxZBsKdC2D&nd3h(jlgZ(AC(R*>%(Y<wMHRn<QUD~Oo*XuMb4p&<SFH4K
zJ6!Oez>2E%+G;RRLP8akO?>l{4(tIC8hi)WbYPAdw76mE#wGBwR=g(BvA6+MZ1pYF
zMBzIe&o!XvCisTda3A_dov+w5D2bR=6-eSDoM8`BUmYg$4Wt|7VJlcuqHwbf^7P`Z
z{72HjDrA06u4qw02J4auVj+g6o6CBV+PVa=Nzqj&i07l&I*uh?yiw~;S!N$GnM$hH
z@{!AbuDw@cj8U49E>x|TJgIOX88`yD#5<$NPhJ@qtl0BdL{BOCeL)~5Nt4=fQ<J#`
zHnhLtTMOrCNs{806VeK#lp*Px946Uf!5t<1dgn2(9Gomu+%c}M-(ame<UA|X0wg%P
zv^Ucfn<^to@?%<*>2+Q@)O>PP2Pmo1V<8Gdxwj15V}>H8{gg`bU&*ku_7#L#cuE`G
z5*Bt!iPb@uY2_n+e$9ZITvjtc--yQS244&pI;L~Ui4Ea8wfq;uG9`7Y7;kl()YUk#
zJdoKX5M%ym=JB5_0UdT@S-LRj-tHA>9ll(B&9XnZ8BEUb0QVrbNmDxCPrvw^lfZQT
z>6_@XLlz!8ntXLJBwmsZ#~blN9G_9a%`r7<uI(nF*kFm&6z6rhWf?f)&5rR7-QcNi
zQ_q=|g>-<OJT*1?F_r{>fGKy-^4u8bhg^6n2IN3E3YHMt_z&AGkmF&xCfh5ge8lQn
zH>|pg1{Zd>MT^7z#{6$+C_xb?B7Yo?kt8~mbb+BSt_xeHh}yl?3dzW5#Q;<<VOqs#
za(i$d+{|NWTB$#lv5EW598EZV=lQ_O2siEE){2=?@;jlA4{t{`L~XCiI@Csf1=q{u
z?fW&->tj)JNgxqyS#yScxk4$^p>~~UB~-Yan}sRl#BkTK_R>@9SEmN5y;bjTwj7^<
z^Dam+2D)LKo!67|5tK+Y2R)li(M|>^dKS2fpC$+@xj!!XgWC}!c}Od;{k&2B4pGoN
zGC{z60w)c}_StQDXn}m)s)wd2w$}}_K%eO9%m9juwpb)?-eXLZ7VJp;or?eP7F*YE
zrMMTEg^V8?h4Vcx98uoX_j6&r03yym41-E9C#+gLu%SfK{5Z4*p#Uxeb5%21!s&+J
z5i4lrU-?41_4?htty9;hz+>n4MsQI(c%()V&YFdi!zZ5r<dRfJ1R9_ovph7JWUrui
zF?rWLvmEbd1a8l}6aVyz^ppY54v__g`WJRS)aAN8ukhNUcCwILrg52_FhFG6gUwPm
z!D1;0JO~!c>R)kDD|p9NR`8;;MJL|-8<Z6$TMqL7_*+m<OE%9Ia-_~J%4(4+v$8za
z7H<nQm*#;*GMd9a1@V^4>o<$+7jr%2=q8USC5_Q+h%m`p<mjB|pmVW<<&h#}ZkgL_
z*Z9zmkrTX73fD;XrQp(DeRf^5khaQZSkwtjW`D%!oLZ`6l!D4Fy4D!?x`Mc|&ZTEs
z{0XF2c(IrnHEF~SO?C_op(tO+3(s)^$%-Ul-=s{qT|f#4{>)e}hRfZ=qLH%8H)IOD
z|3;XWD1PXzX<r2yDc6ysPpa){-hcm0nhynF0(jjAgG;^&Su+hDO(Nj!zAS<iSqm1@
za7-~uuOi;4*GYp1=;)>8WXhs2U`~$>Zp0Mt!4jo*3SOU!4O)^;F2aL#BHO#vbjr8;
z_z!}Cn!$F|2pL*no|m~4AV<j58%X@lhe+H}ivEC4jEs!j_J#SG7YYQ_Pxnqs7&!R2
z_&3I@9gFRMB7n<3bJD(dR$Ja7V>#>6;ty*HinGi*H1abs0j=qfZO_K*@A1cMzJQBF
zZQW*+x(JpbPn|Bsi*$}7-A7bgE|UajG+qIUwcG@fVhZ!H(|iU&lViV#Z?tzx8#F*;
zp0&PE1daT5$qG#1$!iY#$C4MjDN<xeLWwvxS`X^lq$LBW{p<Yon875p1jE19Hj#bd
z<;n7;7YDtY2mZkbF2_yCuy#d4hIcNmNByqTvsGr~5Yk0<L=nn`mCQFNJ&ed+YTx<9
zUbugXH+A3Qu^r7oK3{cwp3K50zBs-vAUfiC5|9!WGuv=R_(T|?WffcC`5i<xnXB2n
zfulJ^d5{I^9607Cu!r#R;9M<XF1h$>!?L~7##DLQ)#CaBc`rzU(b7of{y#>1GtY4D
zoq=!=0Pe(f+7eUmZgQ^JjoaBU0FB6VdBOi*<nLEn6CsvWv{gzXJ)P(EzWIt_*a;bR
z)=#AQ<frbm)l<97J8!pigshZ+y0#+C_1U|;J0GLB)2o?tY*!4DN~b)Zz@LyT9ITv^
zCOL@C-<UkTj`0uH0$jM&kshtQ%tK^jn4GKRvhei_wHMIr7vhcwJOepX^66JG7&4kx
z<EI4|d34k1RtLRN782W(Z2SdrtSZfk@TK}4r&3vmvDrRBx7=>vI>iB|qe*%**D8y>
zaW2^sx*o6BFNWJ;>FFVT9j!UUgXfI1)@}tn^LgPynoD31f>!h!)Igado14Y9@o;@^
zSmUNebdWgAAOnmefuwSno=5L|cm>xWCN_3PiT!gw<}?EK>zxTxGREayNSV1H)xH)F
zsfp~@dPF2^#X9eK(ao|A)tNw7RnIfYiT+%f--8BAd3#j%fH4;k2A|+I{Zmu8xAz($
zNf;isN#8#?-5C29|K=vVMwYShVAQpnIdwUjmzk!KZJQi4VtX?9S!{&@ND?Ar)VH}5
zThC2cxRHOh`^zkPBwcD}6npp*N!5`)Te0K^oe+&r>%@9G?fKtS0r-^(^=)!*qPWrj
zkvbINf!eo)r&*wTjE{)0VXh+I8q#y(tL(>#mUe#}bO~f|*WGFek`JLqGS42RPR(eG
ziKpJ?B;Ej_^T@dnICZVRt=3_T%sv=@4FEN!#Q&`rynDY)3B?(7ih9Uus&khb<c&5)
z3*xjtvy!HHgGWhr)qkxv##r7TzFM@*Ji<Y$j64G#yNO@ExBpmXknJhj%nC;pI|VuD
z43^nNNu#jFarMbxHRF`R6?eCepxbNE`R}SZVr2kDK)S!Ay8u_JBQQdD04*#(@+x<x
zZxDI9T>P<ejcmc;f4@E)L~hz+#>c$(M$LSeC2Pyze}~<!k1jA$%Q|HVzC#UO&rM!#
z;fqhjlZgeYZ@x@L5++s5sL40`S?w*SqhuVI^lXvma`Q}|XQC1V&;9-7Cq+sL9x3x<
zaRat)+U+;3SQfm*C3z`yKYp@2gR=cGHdhG<UJEacEIS!mAy>RxU@iI(u-E!dcE}X2
zb%M4GAj8sXUnaop3Yx8fO$)vSF?j@KQT^B@7noCSYY=1=FOQV4ACNi^bjBu$8X95z
zn_zlq$`v&x`pvly@3u6LDpwlfzs@!gw{PZ;2xMM!DF6z8*IXpm_&{7V#c+L1S?>7%
zDCq4$A|*G3p~<9|KgKmq@jg=t9p@f^Vztm(N8X2-u3-3w73%9zPQk~Ee<y8!9n8T*
zmXVL*;!rn`W?Zthrf>a8XLXD_<|Ks-e(M-!_ZptJw)H=Il)E1WTeg%&RX-jPMdv(n
z>40qjd+8$_m0xp{19u!+W+l$^jD<*q&oC{gZ!l3;qHBLUu$JIiI9KaU+fopJn`zn^
zKv|urvER`Wv7_Oo`ne?_(QfW18TZS_2$ufBr-7=%OHZseOwSbejk&C+65>>md0?6S
zr7U3{n9s#Y-yefnw|Owx)aIqE0?i5N1d_pVcpm@sfuc|zIRH?gBqCspQoXF(b`u=q
zO;|t~%1guP(tZY9tKrA<+4gu0hpKN`-+mb;rCE?iiQCI>@s?^YinxnemGq8mT`{9I
z3=3cr2I7k}$S;qn2~>{ftBIb2umk1|8J`J@5}$^+!^-!yIj%$Ud+AG7Q`Kg1?@jCG
zJAmQNfb&&O+Oy*A_f~ByY<3udut^Vko5@eUaiJQX-`E4Fta|w+ur_eC`H*pmGikee
zEBz%t6|PB6XIIIXCT+|8uyC4g<EZ+&w#|W*hP(MGDg<}I(wH20+RYxhA&CdKw*u-K
z4Xx5T*k;BoIBSUDulcY?5?sA)fFCPANMWCX!t#$QKRW|r*(X$zO|S^H<EZEg|7zWS
zIB)gdIe`*L8?;IL0m-eYKg=LVe;p{8e^&jvWNVV<!{Vx%1O^FNuLaIhT6OQE-e)D^
zWv0BP#1le>AyiF!K@(gucqy<|=HA}9pR+F!o!Iwv{QVqvS7`jeS+Rf54Ro*@u*)B)
zQU9=jn0YMv(`OAy#;}lA0~<|m#q$WbP*NRsDA3OAwVYfh76pF%kTs#(X%hW=8su*|
zjS$5Q{|kKVakAPG(iKc@i~_cn+<CqO4;4`I6VQ(Hrl+{@=%Se%GTXzbF5qf1xg&?B
zneR9RUbzVL!k!_uYbg*!pkiHqZbZ^#ex!DXbC5ceu=lD5R=hoHR*tm3Ky`{Z!r8L~
z<;&1%O9*1Cmr4rn_(gU{0gWjjghq6@2aJlYVY=<C`}5DRA0bEA@)|hA8F8`nVIC!X
zi{#99e0(JDx11#RfXn356RRqA*n>2YR-+8GH$?I3Y)uKZBY<u&Gv-8{g>9}sBqd;j
zUh)uVOw;jhJ}*3E=s${l!PeDzqA*kd1bIp3elQuA22@F7x?hkNc}8*_yEd-bA#`f0
z)49taXlSkPypLr^GK)xSq-!T$Am=~l>FIiON!Y+x8yJ!$fD8w`rJ?QD03{f51&#7^
z{=wh{sUdv5lrg+B4?*5VgMPPlVdb&tb7RD0cq6gLS(uN+I~4_xFoAFYi?GbaaGK@K
z&w=~|eH@UbbHyG^_&Yxf(mJ5$=uYUip1!4VtxX^-0{auHG5YvX;ov&P{|%jX^34Lb
zX9-HRsAc8}vqFt`q;7sdOT8+uz&m{=YL0}}F|^coF~3@D9pgHE66)KgHD-w!O?m#L
zR>zXjw|H@r5=UMeNzi@$tV_FvDH;i%KuJ@25)+$?GSz8kuKIr`Sya(8rJH@!@b*s~
zb>eIHn`?X6S{6-LJaI(UWe<?8Q6NJ?T%*km`H$}Mmp=;nSf~k`^J`fGK6!sD==U6b
z9Axxt3UHCT&)1DDgSLvM>Ay7&;<skOl4{rqQj5xhmu;(9$KUqIk)HS9Y7F9!M?}I#
zzWyBu(zOFA{1E*q`5y}p*36_n`{Ew|;IiPk2GgpzD};mH*ovIG(}f==QOiVx-<FYm
zv*6L3zmDGWwv<g0J{OB^nBf}jHhMlJZ63-BlKZ}ihsC4PR383kS%VJTr65fRAnAi7
zcdGJVg2<Z;J<;m?@Uv3ULcwg=4EI6065;i23S=@#89kp|9Xx(Hqd+%5%i;y_YW7M~
zEoS)Rokz(=(PRBU?6ubB%X08MJ~2COD8A75xbSbqqykRs4F^Vk1Z!l+<x-~+ML~_Q
zg%-jcx1C{re^_&$+Y_#qu>!??B@c>-TF;SZxOZU=VWIgpGU1@ZDFFquQfGOe*Sf$V
z{__-orUQb=iB%%Dmb1)0DOT!_5(IxUGLAyYdZaPb@L8h_ciCS#A4{>C;2P&Tp$q<U
z45d?jh7e6nzQ*Zcb@p@7ktqPio{wRmOzE5V|IB$&T0~ScqVB@Ptd`{Js&lW~pmMfL
zt6$kqwE?#S>xi5tBTap8pBa?Fu~p7;$pM<rL+q^R8#7SHy`V~Hv<TGWV@JuxDC}Z-
zo%ykS)}CG|&tvlJjO<8`9RmIF6ig5uu0LaFAX95I?;@_pQ$n}^2KBtgcZMttabV3~
zNyJtnu=0uige32Q5HF{D=w3%qI=htb#1OU7)B|we-?~f3O|WJSKwJMcyY7-YJF%t^
zDY4TxB?7(=>gv)8up!opE_6@7Q|TmOM-=L6>}Kxr#btE*Bj7pM<)fq-Lj%HOxg=*d
z**xCBfU3rn9co3#1DaJu1&I8qu9mZdwKwMK3rL(JPR0vZ6}8>Wp7>}-RJOEi>m6@r
z_e7`GhVE~9U2jKR>sW{7F55LhVvB%AT?$SX`N|zau{%@+Dur~RFAM9Xh&QU26+}5=
za?&n714e>R^t+Yq{Vb(5VAHQ>6*-J|yQ&IL<pfrRf!B*i)VWAYeE%^m7*{|IL5%}2
zXi%(?9`)+^8GsWpOS=gr_<r%$Q9-5{FKwuAyi}4=@9?0@Tq;)*@G)r4)nomy23_aM
z=E2ptZq7pXF}-Rau)2RBI}O>xB*9mdM5W_v;eRDNs?EBRQrgnxcW1Ts1@f`Web;uO
zSrC^`$82=<SvesX3SEf1OS+UV2QU!8t=2zvA?g-Pa&mV)*+RKlcr}&?EQ9S1%oXI#
z1gnrIG;l>2&7-e%K&z8i?6o9vz8(jr6!dWD7*nHoDbSNm`F@5Z0{!SN+D;S+qecfS
zFn*=oN55>TSafr8DDLd(MM$Pp8dt5oPJn?H6Uy;+3m!UuSnV^YH^UPt7%`#0No&xN
zpQX`x2c?m>Pi!2oz<n=7y3(s$tUC?vFS=C;>^gp>%7XPfuCY(Gm@NGNjG+a>#G%Ln
z+LjYcX8<W;lFMEiQk1Y4Sn~Q>Qn%9`;2{6dQ*>w*geID1Pf>wi1_LyVz|iswe+xD-
z(kJeMoEM$NC3VBWPa^APK}JEv{~>$PAF-i1&S3m%VosLswyCRfh6uUNM6kaej40jv
zm=27~w1h9`oB}hL?m%A63=L-s!0o=W4&iz}9D|6->CPrLu0>JiwgJl`Z0Y^Qb)_28
zyMG0U=NE-TJ+k&h((d(T=oL}b)xAe8KwA2Lu(Ob!9+P+w29x!R4wQ)L@C^HgncN^!
z3P!*C^Ai%0N<)cCxovdmU?bVEbgSFjXcnR?+5=j5Gtqik?#-DsvAsN6HF%R)HuW=0
z{YSv*&?Ar+rA~7*;7<T(`hlN%L@E_c;FUG0bYa(boj-J0?snN}>m^n=p-Abe%_?;E
z&Q+%ads5&1eA$9`2Ao1o8=sYEEmC<tnnBS$qul9ecwf2p@TTXq&G36&bZ;eo$T+vw
zu|uIBZ+9%Vx)Jf=qV?7tiJ-Bt4UnC@U4*sG6+sIaX4i{TZtdDuy0p^ojG)(utJiIx
z8)(lI3j>Oo8wT*^>6K9-eO1Mr*X`}=n_nY8Jbc_16%jpworbGP>_z0j#@{XS?WM|N
z7c0i2j}jxmEIxaWAjqbqCCDHp)Zlw>S3wW$N0Tg6{3~>>{;=7EW9mo7Gktxo8cz{<
z-#a4DMIf2?KfQfftg7g#l?Zr4R=A$;nLcy)hYmA~XxlK>K$5E}u)L3_U*Nj}x5~4K
zL>r;<z^t8Hoh$G~@f$^BDr@j>7>8U`i=h=7r(t2>C}5|mzQjY~XV(nzVEmnuNNVhl
z!osCI>hW5u;CR*xQ~~VVCJ+oZlxq?j#NRUSWD%UT*nw!!?GxbU=#Me!R#!k3ho0)K
zM_O-6El_K<7@K@WAp_FcXpGdCc1u(O9Q>qTMtALCo-gz}=O6a}cz9S~q@qsi6=VWJ
zD&;7!MT5}YCT0_EBloL7x^;jH3o#eJh&`lM2LrjB73I)}5fMWFId~|-LK)Xjo<`ce
z`{8F{9CRU)L1XGRJX;YPB8N!ra7?U%`HPTySX~A9*dg{MUSo&uyR^`02>|+NXg7t@
zjWZo&Pq*H&zt(_740cDU=1a_9M_g^I>E$n^IA4I9N8EBaoZf}wq6i0m7>!1C7L$Px
zrpW8M|8&T4r~HGI${5r*4l>`=-9R}Xr4#Q>1yxP>EMEACzmC9d@kiRpS2u~w*6N+N
zE_x(p%|<UgiJrsLgfbrGnjDLNe;NOCV&RZsd_2N}|1uopb`<6G|KYg1TMvr+P8Ahf
zh()CpH9CmIh5)9L5Q}$x9_>mbscz^JbZ*jW>CsVfmqv@>I>}#@0f8BdQ7Nov;1S~+
zwzW&NlcIVqTl6h}YDWDyx5Tdc!TN0W`Ay3hE(HE(ITQSF+dCE;p!G+-mx%=7sN}IQ
z@R%4X=8ezTZV17<IK#zJ_!tUD#3^6TNM2k)oXfeH@mA#ak){MGV6EbF*VVyuWwfYL
z-9^1zjZLQn(DG=@MGe_~B7-7lT^nA)Sn7k)BdaUU{kkn};tV@lhrFy!GqOge2unz#
zeq`N@TEp(#)NvrZm?3In8p94^JsZj7aWk8Pmlt<Iz<*~;<&vZN(%>gde4!c(S9!aw
zi&Gs^T>qzXljLSv0U;YaSJ}CZhD~VGYt))7<i+x}h60isx9@aL4QT1hMIC3eHRQT`
z2EeXvJ_szHCh#?x{F5nBqwK(mxA^gn*kl|ZTU;rKqiB#}TH57u6w5&w=18T<Uj3wT
zq+%~<!Reqz(LC~k4>f!SFVJNab6{}s1r|r}3~xp3pjYKJVG({CwQu6Et;n(OPH|6u
zMXh2ZgSz3YPm9<<>9vvc77&|jd&}sEO76koytiA5aJQzYbw!Ahm=@NFDRl2In&h@&
z2UQi7{Jy1I$c<X(E|7}(?^{ghY{t!s?Yq-a7zlN8TiEvtw6`5+r|@L9idnCIbCFW~
zfNr+aHZHR&`sZgyrVB1Y^yO|ML|3<VG4_IfAI{l!lQ`Eho1p@+;BI8%T|?M=TKXo<
zw{@a3m9ktZ5*`li^Xf25Kh##g>WjX>1<oMQCL=E$hqXy9qy*bE8LWFwq2WBYI=70h
z!dL;~p>=gOo{PCtv70rkZaxE2+?zj$BinlSCviNzH=(3`3bcM(aTp#DMYq(Z{_e>m
zsW#O@>P!+e>muDV#}oxX3*Iq#oOH8Mpv4jmZkME&l*&tTpP(|$ygS^u5CZ+v5Mabt
zBOSkVx{a@19IWOkxR9{tMV$c4kH@k-g^f#m9h~OyOF-aESQ>`LFu2kgsuKi1&<I1z
zJoqDI&{!muJPvAVsa+dhVZQvEt2X*N)kR{^6)n^27jG?XV~Lq%aQ$zS@eljvPQ%{9
zLvE<TfJfjG8#-6WrrljY-p>@eX%{8-4(vJS<_|No;g!<nU(J}~_jl-+eC6vXozs?u
zh2GK8l<t?wCz2F*Z)%;D9^BP!%RUJ}7vln;2%s!vA@c&8Knyesk-sW>a_OG<v@k>N
z8^%|$W)#ZHfQsG#+*KPZqnbU2ud7EHRpR>7-Zl4=!6rGH7x_5;X4op|WK{_n=6k}F
z^>^M^<R{m^d%H(5TuzJuZrlKSBWU6$T|yUs$j|RBxBaUgt$@qRQCJG{ls)PvsJSvV
zp;dmAd*7|G8zTz-rHPeufFYQ~l1rpT6ZAffN=3LR(3}_hl5PX{{IT}3UhbO$$;NrP
zkDHo9O38|58}p`nY2G%!Dbx950DJwaLS4SLPyt-Nk+JQyKN+!2v)PK}A8K2mXP;8E
z*JW2KCWJAb%_lvPJ){LgXLK_*{t?RRl^wz+fkDI|<PXHZBXVUdTYN@GKRtT4g8pu6
zjKQ~9wp_t`cyK&2`6L)>B}~SyGw48Rrs70H$LHGkLY|kV1)Jr<-eNF0#2g)2ebCl1
zIhI}E*bjUuf*stK;1N{u13jG$dAL~5%AQKt+8BYG!rJ%A?4tQ~d3vIUy+VGEqN%rP
zcGQDrIK|&!+IiWHsYax4GrPT^b5I$y-;9tTbF%oj<}ekzNXS=<EdQh<XsCVfe3S|z
zc403NDi*1t3M0C!5@=k8>+rRvoF|dn87qubb-AKFs_Hc~$V?!j&0l7U_xF1}R!|3@
zUD4b@Zox2l2w&{p8|D`ca)eh&p?29-G^pi^A-DSFqOK`SVljhYX<|i1hSR=ozv4>=
zSi~B|y>ZTSVA$-&Noo3{(eOWK#w5YbG(JciTur1zWd||%sM2-jZLul1_{&&fRl6;&
zxAnkj>CYM#m}gQ3afUq9VRL4OLwciPZAH`?R)z5Rk7K&RW=)r}lJjFJ(Fy-FAU0MH
z?|{#KBHROf*^LzZCn>BmE<tr{rkiZcEB0Py&mC>DA9QG(A<eMR=ox!5aZm^vBay+z
zk*()sY6*Q*@D31Tc`P*$Jbf}Wr#*FbSa@O#{F}8G+M@}tZf78y!)BNS0;kMpS_txj
zB+K|Uvn7({kGKER0a37@6d0tT*;_U_(@#dQd4=2Lf|8~>p{F3jGxZVLMUhOTnB(G?
ze=q9IbFDCP^q=FH39DCQnhTm4MuRMbJU`ZefNL0qkjHKyOalce_fZOFa3ASZn?8#!
z0}^u*&QCzZWBiFVr&`%KR~+$3H9{>sd=Mj|MG*vu(mo-kFWtO<_Wo6ZPKlHR|4M_A
z4WCHGAxn+`e{pSObi1mD4_^axw-mWJZLuinA9U#ZjT9v~(viU33?J}|q0v6xhC^5i
zU)8sE`8ld^uwj6!5CB3ouJs>#(m2UKJ+aDS`z^ma>6@zEM~;|Itr$!{!DSjXhhI2C
zGk<4-pk^5rFyltb@WtEZItJQV{<{TwlN`fY(BmM8;<Jya9QKGWcN_ju5~g91mY%jr
zGHN)*FRM4+a-%~Z6R>*;$0wrQf!Ub~N%VsNdCiUDs(kzKB1?@t4ibfh2^ItdkfM_F
zMZf)DwhV(sgl&Fta(GRsvyBl|RJe}eIR8|oyVjZp;ST7GdEq^Q%w3N$7Z>BH7IX3*
zE%5v0J&`Lk0MUT9cHk-{=4|h{@f8j`%B4~Tr2qZDq7QqEk8)b|&uZprF|$C<a5?Sp
z2SdJBNAT5#)k;Xbn?Yz<lBhGuT%zQ!FbU|oYP0fh1Bi`LmZL9*ak9G<gK=_bzK(!G
ztjp~Yf3ycq>9{WG-@~c@a}&Dw0vZU=eIxh4iqB+gGmP5dxZh;AV2)X1WpdLQqDd2G
z{{1zCC&u!<ifB$NmhK<TdZ^iq73-gFLUmOjQ%F<3gR&^TBlIA9R`|W&FqPpFxnat?
zvudkUcLB&f<pMIsINm4bDx#l<DP3|8bYKpEGNE#2hlIuCk#Nrh+XVTXZ;aZCh+S^a
zZ_oq>N%6h|4G;FHz7;VRl4NvA83jexXo<-*#kUZYp+v?LeG;P@Y_zd(UYCUSXzo$t
zW_F($)fiigIAw{%a?vU)+=m)!`^09q`|@>B-21$hV!ArNwu#+uJ$kj>75yF2IPbJn
z=&T{#@kxDy^e&=UW<(Gx3ww(n-7<Ho4}2!Z@D7s*Br6Af+cpjppo;q;S7n_{s?6kh
z(Zt{a65>>zd!Emf6>fXYv|w%grI15bd=ii`Zd1y7*sPC?VR18COq=|4u_i<GbpCyG
zslyw7PWJbw#7_VJw=@xX*MnIrs!rFHveH;T%7}yQ6~m{0J|DajK3&ee*pa<bXgUp+
zG_BDbAOhcYxDQ!N9kz*Z%lceF`J49wwB--TN1>jFQe!|g+%j}IEGmIYN)AZ8-OKM4
z`SgvnRwtaeW%BsnW`s5a#7%u4>}sXC=uM|6Jzlx5L{`PS4vKPzy4#xyZI&GJQ(pVO
z24r6XS7xC6rDF|2#%HuGq)y(PjYRhqqqGOZ{ty&YFW21(`o23duK=8iaXQ3PoE^aU
zt}Y5hf=>ruxEm+*jZ@?o2|vB(u%ImQ+|PU+(TzCCl28861s8&yR%Ej|iS=DPHMvAd
z)re9~rZ<lYMoqpw7UL@(-TJ{a7wO%SqyNEYP|N{W&CG0VNgL|ajG5^o@D>(`=Jyih
zF200&=ABcOgLzsiw}rWstLq!iX56z?qTe>fwj7r|C$vuj5O$RMw#(Ztzi%+hN|GQG
zOdRI(a;<PMFE97#nX`-`oz-0I>OybYxdQILn8TK$ZpFccci8!qdS^=Xj~&`TGD9gS
zvv;3+N0$aC;#Is`<Mqv4DpO^Dynl*CD33HNSO_JHKL?}4u6n}s6vnwlBgcO#(A+aw
z?Bkvp9Xz=}KBbO`M{1SOkv8m#G~E-kDfWe)C#%Ivls}Rd%A`(xkA-%N1?(-(mHcv0
z`#c@ppLPEC>zIhL5y(Tc(z~|Az<i`?gSKj<I#0GxrNiWx3~Xvu^^xbE6JUed^@!HL
zK9eNWLF&{XM8v{hEr1b#{*wDqBT1$!IPxW<`bc<~7V{sw)QbaxdnVOPNV-t+_paG3
z&xY};?#3y93SvblTn=Y`vuUMa<(vb1YxWK`7E^BK<qVYchXNc%hYB$R8&v@hlf6jV
zWkE!FLlNePYGGv*JEf6H`&SJ<W6Jh=GIwCqMR-U>7Q6)%a?@ZsYC*2=WLph4IfIfw
zjuNf@1m9_VTzPM8WddJ)O8x3F4wRe_D*t-1wgdcJppQY1H8BlF1n84-osPY>=<I<H
zRK|c-QV!XZ(+AM6>f8#~Q!o;#796fvtWnWhD*g(CDvQ&65O306C%iAv;h`Sjl(cZR
zKR{C-CqNY;(q-^YB`nfT2O~TW#zWmg9I{|3j)<nZ4XT_oSGhp-Zo2QvK3?EUoy1E0
z&Io7XFkg$2(Vt`|YR-kw7UU~KV{Ni7d)<hJh}7Zy{RITy&h)T}{@$bPL!r7wF5GOr
z3nfz7I=H6*4N)!nTh#zEK2bVg-v;}cmLW7p!9&<1539N?NxO<gYzQ>U8QZ7A6m4iD
zybq`*y;pL<k2tlp1GE(w^LZwGnX0Ox9gbls0_Lk-YnzTOOC2iyJLdNM%V(^^DXpU_
z36f#NoC3oi_ONg1D$+RM)Ojxba&3!ajH(&MRkTqsN0HkJQ~7~%9z-|VYba{~uD-ie
ziC_bQ9K41O51>7CP=?IJLrVE4rj<)vzINj%?{=**ash{7PollWshnU#>)F==c0J;T
zlWyuZ5y1gUG8Ja6LQdHGi9=&~_ktw`(YOuqjy<96Jx!h&5}20**=w9IUVPXJ9D&yZ
zlcIzA;SqXai%+q~J=AC9!$=yc5>vUnnE$=!8%S0WllGAw`a@<<kb}`PdwyAJTVMO)
z#U_<vxryy<jhpWpP62{eJkn*Rf!Y`%$thv5h-rEU_2vsOFcz0H74~lKlU`W_@xcE|
zabJS?xJErqTDgIUsl=_vW;$^tT;%(k-=P=gjf2Qn2Ubim^_4Qm?zrQ+sMl~BIH1J9
z6}-JzL%AP+rWP9ejJfg}L0s++#OJt(S-6j>pH^f+$uh8v7viYvLfC_PLWCAR#dI_D
zY-_EDv)=CRB*={1FJijBE?1jhSI|f618I6bbjOu<nQ}X3j{lUUt9-@<jk-=X_Nqx8
zG4nD9dp0938Y_AK<r)I=K^PA8-J6EBa#Su{=~x1m_H~ts7Qo+EZ9xY$*#jprhZlT1
zXfZk=X>P48zaPCf|5C-{8TLI~aXOF7mthDS`24wdPjufMsU(M-Y&UY_BdY9OYvkzy
z$?GU?o(rV2NaNngkDuxfLAspgKS3UsX!;_v5=54Af5!$VMPJ@^If{WA5oQ%r{CS~q
zwUA8D3e}qbwDS_vUdof<8!v*Qa8?wTS8t~Asv9KE)Jk@sv1e%cF60l`v<;`<C%rto
zfnTh0jcWSF7NO$S{h3F$T}x=X#Z^eLqS*p6C~yhm0ZwzoBO_ogY?QxX(gb>lBL_Es
zrKl2w912wNo#t#0b!K)%Q*~dUjLeQi9?+4ld|u%Cq)%}+PbkMM2B(>W7zN995Dh|Y
zC9>{UcoPFxQEpU`xtqfr_`_=u<O^OT+21uockdsz6|$x{gUqRs2s#f`hK>=z@kM8I
z>wG-ji$bv(*G&lGb%h65gDQ}*urofa)jz=qjN=2yblbFU3;fvTquZSdK5-?m+_gG$
zw(nxzSaV(k-~@tZ9($~JE@3Qdh(4Bn&wTbKG49us{~smBy(*Ow%8=nA2%QJMSJT1K
z6bvueP)7!1>!M##tkLf)mfFj8@6>zMz3Dun$nwB&R;4i2;-5XCKPQ6V>d8H^zxm1e
zn?s!>rF`K^Z>3mBD5AU>+A(Y~n=;dMGtVrS&jk;t<i(nK?J#R2fYeir32_bcoYPBl
zi3%bQ8f@L)3qv)Qq^E?6xJC6}sqIP)KrH-fQLd<`*TZ1Md?YGH{d=rfM(OoQB-{UW
zUTl?+6*OKI%+puzv_`KwC|Y0x_!rrrLhdyXBw#QzU;^O;esXQOyFEOQg(RS!{%F}(
z3i>DAO%Eq;I24z##WIcmSpYz)XG#TpxMaxDPsoli*lh1=G8C%0)5hl09&5VbG*~>z
z9;^wnw3R$;O%ev;=Tk%kBHeT>Yj@P7caW-vtZ`BSe)G@Uh#x3a_BqlD-Kpd=7*0Ie
z51z26{BR?=$BHwMJ7gj8w$`4SMe&n9l@=G39@=XkGaieWYz4UwNsErRw4?6lM)Qu*
zxmz93@bohn|9CY$Z)^Q4Johy4q;@)()+5jGEAo6<l6@drbbK42q|&vXW)on{m|_Er
z3zcPGRp2m`vMt}Gp6G;I!nI^_I6Jq}-?eYk^5m=9Y2j+w3vbrYNl;K*4&w_ey(XvE
z-aF3>U(AWX_u{W{zA^Mi41_!R6<#($ijWugE-bJ!F+pAoK7SNZL)aH8StN5T@KQa-
zhSn#VdeFHC1m&gdY)`!uyMQw8>NG$)eJ)5I%&ne1{F?|54nCi|a{}T1$mfN|5OLFO
z`&164wRz)AU*G1id1<ekcVlVQtn4q`&ljcT+Ln2^_UX8WT^=Iy@vU3e<UD@WCPTbY
z*F~s8I$#9hUWm*<j5$<KD@mf9wbucm&`p!m4I006sCa=RmnJ1@@{+ZYHOLKQAK9D|
z=+Em!VsRqCY!rSguLPr{sL;^-Yp`zJOCo_Jy^rL$o^Ker7k$RgkBAZj-Y&}f^uON!
ziTr%o60K&~<-iz<0O-fy96vq9wZN22^T*H^YD&(JK-5y>-n#MBJTzXYx%5%JZ|(qm
zt>q$?#LP~+TT;+3kiU0k(XP==iJemDuLKlygLH7-)Gk|V6E?kQl0#u3aL$rzVUY(F
zN5ak{<r_!ZUVwntWJ?0lms(+y34+1p4}P=7lvA#nBM;AZvIx-o_ILtV;o&NzkkzLd
znZHx`2XXYlm@8CktT<mT<KEUHAwW;}M!-`8y486VH4c<Gw^9ZD&fdBk9kdN7!)G;@
z5j1!l?bfJ#34)m%exb#puy#w`e@%*lRWaYTMLS|cIj-Q7{ZOq<9~=)*6%s`BdIIi?
zem97TI3_A|Etl26u1G6vC*-utpqo)~IE2v-FjU0AH`EeGy)7<o84gx`%8HDvlyZL&
z>Zbwa?>=8OQ{it11%v;3Q)dH4U760t&(UYo!&%V<I|hHTIw)daI23FTzw@60WdBWV
zFE>G%`SxYcWgHELW_Y|Hb`n5NWBRBfEV#{~XNSMwp4c@yTc%B(Nxo;iumH)FFg#4o
z5BdFYppsUtsL$Q7X6pM>Z~!Vmi(?z;`#^IieTXLza~Uv&!8$1(#04c*&(+fgm4<gQ
zppBw)JRt6TuPn{ayudM;h$ZDuY_ki5Ly>gq(?0b9Q4f5EvVc+cLiumk54+AGjw@$-
zO4EE;*86Nf-G!E6Wp>|g0OFN1?@pDp<nME=gB29HOCXd(VE$8qen<=`wDcu~yRs|G
zA}JJ|JHQNpAonPbOy`4B^pEVBpTfZGIJTQ*k)KKD7dMV<p@yS(lDhr=>TJr7`S3z0
ztO{(L)_RfhfMkXcC*Xk8WDXfq)joIF4<^w!)%dEXOYWRf0JlmO8+R9Tx1Y2tG~oC^
zmU4UMim_Wo-f;Ab6Vbw?oP9ph;eCbQBr1k__47~~%3?AbAA-o=^PZPRBOwer(t)40
zoF}yUtBomXT$m4U(z4gc!bF$4#^+Q;H41mXXz$FT?pq5({Ee4oDD2!?S~Fq=DrRdM
z!IA=k4Vh#D%J@34_J*!7w8}<6^TtQ4#i<1m7(h<Dg@@KCv71m!Z>z)FUS(uiAtPmh
z16GAl5azWYjy2FUwmE!{26Km`$5>CSxZ1=rP*6Oc4&y8y_ciAv>7N@9XNPPNMYVv(
z$j`L$(tx=kyxmd&+n90^orzF2IP>C;ak~(Ul6*WL1i;oS$6tU>uvWy@nNa-4VnV&<
z0(CAN8*SgltyiLp1}pLeH|Y^+f2C1CrvK6O1E552VPt|CneE$?nId`UWEk3%HyXLW
z*}d20z&pzJ8_HW%3S?do1qO?c(c|JsIiv_FFl4gwJYipoPUSY}wMB?}h^l9VN2M{m
zxH$|ydKPJ%=E+-(R8LbMP8Ug4Xo#T(K%8r~1p=7AF4S*HZ0@%`czW6BsMsn=Y*mlQ
zgJ-_Va^FW_HLgCStD4?Y;A9IjrfnYked6oJY`&Vc)cU{aTNi^&qry7HuE}SZ&}<sd
z156*dM+w_l^7QMSWjbwe)>Rlm=HTBKZ`wFJ+6eNIfEvv>Px@eR&H}>!0=}Qk5R!U=
z5gnh%npX<JqKc|asO)_T2F`u#5pQ|1RF?aha9|+%nzXDi`6|W?{!JzBID2)g&Hv+u
z%(`AoZsF^DsC$J^<jt;P>g6~v=QgZyhPrfpTsgAs2q?QE>B!_cy90LQ-k`=xi@)(i
z-ll<J+yyZ>!eCae%kc}7le)w+aLU^_CN2$HlrFKZcjvp@uUf{4I(;B^dH`Pp_ZgBz
z)Q=Zy0Hq9Ne{tFm_9qPoF(%#!7aQ+Ba=xLqY5~rOj<g6*!W{ZV()$lawi!L!xf0AI
zir(3n(pcx*>yOPl;TfUiveV;q^_8kD^ug5-e!|+}5eq)OCxrFd^2@YuO9lS+l~|G|
zm5Zsh@?n@P+#2hHah3lknwli4!3C)YmSJot%ju0h)v2)pKjBvzA>|_!CePOafo}cm
z1wLo<zkrRq*xMYU+Lh~rm?y=>-Td+df;1rXr+=176r%Nne6E<dbM6`;5atvuIub`g
zCLosOt3?A2gmDUfVyIM7AZa}%4o>y6D4Gy|?;#pZY0*p^E+8B9iI)oNCHCU5lYU;X
zxoaa}#DnK|dF7rY<1ifLu%47$N;G<k_dRav@CKg1%!tCMoyDA=i8i`jglAI`uRykb
zyTOGKyAE<y`_xNgVl&_O?vG0)>Zz$Pe4+7kXbWD08tYrNunfGUaptFP!;Qd1fB>F&
z2s*eB<Jc5%>U7{|B0LH=Vx8v#qhErBVO7~!)&_{+7z6zHQnjOba9<^T=y>I4ZF!N4
z;KX`tyt^V|GhYsvHUa!a<RexZ=|u#8&p!tmptQ++)QVT1fJ(|iEAUCdC+Mo5BJViH
zfJev9mdl7SFTY~b_2r@t>PbC|5mhs=nzt<KC1QCn7-}Lkt>~PDO!gGF-5>Y0QK7R!
zx4xgY2)@`Mhf#duI4!#NZQjw3mZTRs#{@{Hg{Wx`s-ybEtVCxsTEd0VYRllKcA?<|
zGS3}I?mH2h%OLN}7s<Lm><IQ;fJm+0Gq$CH5n$B@=}^6UO2s%}!w|WV?amPxnsNo2
z=US+)^f7DbbJY-fvdFdT5Jb$B43wte$hnu1-x|1a{!A_dnW5z>0@5YMY^)YamnOl1
ziBJHeSz8f5R2*rElKv3icHS9|oRqvHwJMsWVxc_xT-q<_I}*H&_IyfJvwBb*S!5l-
z$?Sw*2Oy)wE`05d$0t+S6GmKBPuQAFJ;@TR7;}?ZQ-$Di33k0bO67Z3H--#j7aOh)
z^YAL-n6+P{L-!+&1IrnjPYKWeb%Oko%tZUp^royUc-Do21Hr_`JGSO#$!RS8Yp#+L
z+DTutkC&CW0G8qOp#$ht(6k|=(ClPod8qNF5j!7SxJ<>p7`B7VBsafOL}~lsW)rEj
z`{Ma>%@Tt*U^}T+3dxATwCiN9#*=`F2Q?^uwATEx4KZr=tPjEr%?twg)^0nm_wBRU
zjsFmh7J{x-L++0+OV-(kDTs>(T)+pmuhCe7RBa2P$@*Iox`6f5gR^X;I)2YS)_6f?
zHqH0%Y?sZqDIFNoIT7YPrI@hAIvj8T1ihY$Yc%y<<W{9ObTh0s3s2CS>+hkS9_p|g
zZFfBi<}ujRe0l&tu3!~%BKn_4XJp2M*M+b`rdDxklt>l&*HH7!WZSgrR$HUbqpJpP
zoqwhn&fQfu;`F3C5Ax!t3Ny|=U{KAlr)dHspdmsP-S}@ebTl>y<s%)er8cJ+8|sqT
zEmA@Y)dU2GA)2+gyYJp7+Jf%7%6P)^V4C!OMycJK?uq_|Mz0E(QC|ImC46gXgc!`#
zZU)fsnee)skHMx=?X|hGNG>)oX$60kC}#zr9ki2rox{U-SkD3klyNy!89J<KtC4ZV
z6+eCvKN#Q=s74JsYd0h;J)*i}ZaSbSTS_Iqk2UGoKMYk$WPKCPRko5{IH<w;pwsi+
zBPoxZq2bVcoPR0xG3>v_kDJwh$#+?k_4U{;5W<4pStqEaq|7!B^p9Anr_E|XVV`^{
z?R?)f+Mi{awA3fByn|^80Go6mps}BvlbBIqcSEQ_B-`4&Ear>=wyO@t)(*hJa)g_w
zY=aF-b}AnbZ2%41hh$-39YU{QiC-t8Axf`<WNTCKz*~$>Dc|uO?WNpkqqwdLf#bL4
zpmSW&Wwo@gHV`~R&gw9rP#yGRH#HWA2yWXIbMf||qD<T*N`J|G`a8S}iUr@Obbn+Y
zyh04NPQD%i#9ID=rVHOkTR%`T4bO`wS0Py#G?cAT#|79j!iiAs^F|;C?aD}rI*gAt
z0?Et1uAA$UM>koLA`3D76}iMh2P>H6&jZ~u*VOQ%bh-)9BJSvn?VN+!9kMv*Zk>y3
zJiImiL3omd5<w*1ejs^Go+dpXHRtZ{2Gg%Lbw{}c#(y&VIEKa6kCGbNnR9iuzH_HG
z)9^0^J)xs1egdt!RL(y9r+s&@upa7uCg=4iJW82lPDkjIe^Z|fLl)_iVZ5R%(oh8(
zK#x+y!XoIbxXBZlzpCZ)CE`KA`GOF}(W*=+3pB_98Q<m^#4%|GHjT|xO8w&^Rw#z6
z|B@DctMQWOZKl+MBwx=aWqXYgUJTY#X#CQ9a_R;EOD(p?kd5d2cxj@An>|Q?FN4EG
z^x}Geu^qkgqs>%W%PEM1*y%)TID(#4`)~C4<FE}!pyW2Lp@r2h=L|a=_7IfhW`ZS*
z-%&D47W-!`3wpHYr+fOg)=L8d_I9RAmA)`Q)V^(_B>KqgE^WvKhR<gLW3tn89K#)Y
z){=q*R0cFmc#lydf94Z4I3xS-tcJW(Lf69Sp61gD=|2u@t>#)l;L}N_ch$*(H@j#;
z2ii+a^7r#<M&G=}Z`}che&`7wQ@Rd;3DCQ9_Oz&u&Lsv?%EL=9tX>G8%Zw3g_eqqx
zmKlD4$X;*6O;)91DV^(61tTnP08$?^fWzl|2OON;*Vp5;D+K6EW0B&{#x?x74_Smk
z5QYSmxZ$h3W0dF*1uPlc!QU^^c&yGIrk%aS2R^%Ta3GXD1-Z2}Jh7zPl=U^*hM@7W
z-FDmY#0#1*T1Rj|QzsOyZ857HY<buQW=E`8sUOS;p-ZBg{&H9VE9d$tKXz#Ni@z>T
zYERVsX|3EuS%=EADxsD{m0@U($i=YDqqJ+ry-zlKtG62*zba9AcSCIR!vLwkd-FNt
z<1N8T`iu0}Tj69~HR5r7!$qAVZ?EbAj?^$u9@{61ZIOX71=-8+!vFqSN_f5px!>Mj
z(danB;%k}G9n+4sV-gLHues%~?`(IR_$tk{#GE?AanMF78Z(#d=isF8BezQmgcpn~
zOu69F>?2Qb%4|-ifdrB4qnExp4`pJnwunN^j*yx|#0jA52b!QF=6N_<C(@*X+@Fh0
zQPYgTh^G{4M<NP1cx2-RAtnl(bN?%E3Kdo(UJh|q9g|{zBhF~NeP1>J(Ksf(AwAB*
zNlrj&s4{_2k{ARTAe{lOFSHd$p_STxH9-8isDcQSG-2kx%j|5k3hRC-2YXxPlTsS4
zHT&oeoEcu{lAL<vt9uN{+z>b~7iv3Ghb!<w0HHol!K(W7*3l4JPVpQj;p9YQPHWga
zN+#oH4-RQ#fD^P+NcqE`$KGGmfkngmj{``gU~tsFeho(ojj!|pkumfCKeNm<LC}W_
zbPU5~dBBJ=YGrs2*5}XgoaoU8%Pm^SA@6=$=ApQ)_P%3#mWd!%d$O{{fLQfRc{smm
zHZDXy&9?WM3)!+EF|~!~$ji6k<}Jp#32a2oWPRyP#g*Owjw?lPDNOo0^{O8MN4)>@
z9#jdI=APbrp<5+JdO|G_0_Ew)2>5zU;<XiEOC|GU1{y<!gAV^t2hBj4)EY?5rz$OF
zwb^)r#5n4Fq!Fj}8$2S4Cng=|vA~cA@JrdxSb9#od)UiSW@79=qSZ(x)e|2Fizbl^
zSxbg0`p1#_7*1){%6SbH)Gh{%sWxGm5eA&#jfo{3JjU6f?}uVksfkJNmk@t%Ry9V_
zBe&fS7?%xnlgV|x&bgMU^GJLQ(9v|w=<b*E!{CNv@lWlPyINk5;Y!?$k(;TTb_hwZ
zvE-Vhb=)(lrWK!$5sC(+@Ds917!C$8KyiEgq?We!<7>`gYej~d?bL%)rGqMjx(7GN
z93ToUo)dB*8BCG%Hf0@fV0GQ`-6|zypbn|8C3<0&@`F^YGa?Yc6*bB;8LFayY3@Ny
zR8W1b?X=^ilSX1JEhOR>6|IW=V#P|c^;%RD)cNKznAb!d97l#soJal5H@1%}m>uT<
z!F_mPK;ReZ&#g#FYS8MVKt`Ymr8bBU<#qxGK|-LI_-z8phgL3pu$ycgcxcK#QQ=X$
z>Ch~Mr=UpbiU<Tky?kAk8=8^WEzn<FXOY28FZ4)+EAp^k0dCv&_X7YlL=!E8QCMHb
zL{!K4P24v;E{JRG_rM2R=S|-Hl9>W=xaq%&`a8S(iiW!hj`?k7B7+1YT-u$q2}_|+
zLjOEljw?B=(^F~4?Ek*hf)2~1^8$*y-ZBN)7hzsK_4H<df~vmFRB1xXEtOFum)jBn
z1*j5<ooBw8iXLW$Z;xlTM((51#8*UM<0ERwMy#`j(m_d_BwS{8{!^BF`mpn>$m(ON
z)3<R1hPAhg-P8{SjF)g?06J_!z4lmp9%#tdGL02Fmh=qA_Zk+(J3Ro1^z^-Phto7O
zs-ZC;=k^Ej?eH<r9wN+mXf)!Z@>XD6)Nly^n!|1!e=-S|Os;B&Do3*l)jZh<pyN|Z
zecT=&@h5;!XqCBD^<a5jCI}M%EDPmb48G4DrdALb7ajX60aPDfnVh7W?nzoJ<Pgp<
zcO}5pu@^cDRs*iTULa}sZ>)7XnsmO-JV!sM7y^;VZ!f~{itvyJu*YymJE-Ml#6)5E
z{gJm+0KRhMNtf9n6arGDJk%_8p44q?6u&QR?sIMcha6py>HkNh@-@%hbso=@$QTXz
zM8ToTGU~a(^R_7fewzmW^B+<oX?(Hau9B=&#ME3ie{F@_G6n@F8l=*8D?nM{K>ug#
zXFdhA!r@=+yxERtm@=#s^PDDSlv&xC9wL(x#Ytg^b=n*pbMF}y{si!Fe|B*I1u7XA
zNzR4m{_61X#)|l#p4-qm2nVo1wjLdBSd0V~@xahvxZ^zVY0;Gob}qY*IMcnF&(q6j
zQbaB;Ih|8qCYH5X_tZ?*%+6CEIQFC^*FnWsi|Ic%=mEA%WxOLe61cBXpzMBcMdbQX
z@1@8PuuMIt$oYCtxZT-<ir<!D6C=Lh)k>Q*X<o4Qvg0@gu(ZLw7*=kxD9e~7&~lSh
zhx-&T4N&;}N0jKc{;!X&jdDIDjZkBFn3~~FCX>yHvPy9D`tkZL-Z@rrgwcFi=y@ro
z55-fpLkG`-g9^<{UMdBeZ0zLNg6f(y49B{9rOv~KgX6-iF4gVHWhkpv!K@{jWubCN
z9ygsQC?iFxz!Q;s9AE4>Xcguf^3*sj>3~Xq0zlRs3+Ng~MTyezejmje(Qt>uvsSmd
zF5%pyNn?$$<-m%cLA}@YD!fR81(c$S&PHor-Scj^&PBpy|2Yg-6{!}<*;eC77b*)7
zZ^8O&T@lV?(rDuu`P8j`pRc#JHN8N9uNPV}Xer%yPXKQ%`P>0IrMB@!3|#$8WK8y0
zkAVROm>Djz%IrXO=E~Yi-DVA~&Bu^B+F}zL9!`utLUlpm(3a`MeaB$y(c?1~w>i%p
zIQ@2xpyoenR}W%DuU=n#TLmo2Y)DrBwig{U#Z`H(<K?ttpBlkg(+<vuQ}%SiaelPh
z7Q3_rA;z0Ht8ZU$(`28alTA=1ql6)6^Z-|?S-!>y!o`c~D$oCs5K#lWW3OQC5pv2E
zZ=!$bLnw|&%!ehNYhI9ayUU{4N&$`6yi~-+su$exI32wikm_19N~wWHd<=$aE?>T+
z71siUUspNNyw#wPq}+vr0#~yyI*Fevw>=?9kd;#E5zln)vU~^`I4UIB5zR7Q>(u~k
z9(G`!UgfpR`}N#Xbj{INEBf`j8wg^R-lE0I9dzRh)zWwfjwi8MB=ffbJBB!F#e)2o
z8_VBY<Hu`2lGR2=;k@11!r!$M<om{6_n1hol{}#6SDA-BW}LRtYDtC*9}HmV(K|}W
zfk8fCoso1}a*(PfE?#7)oNCU_@bn0af#}aeBVW2Uh49hlae#aeyBbuHH88oq(2ORA
zb;&4wR&*rT{)UT35ggLVeKilx+8Oz}#m1V~78PpR)uVX4!@1J$cpR`gVRhPohR{Q`
zpOMheNy<B`*(?I9@_VXwlE;(noqyt-AP3f100D2E*<n;88Os&aDcxKDpFZ~nx}Cvq
z7K2$4hf|kbn(K<co5BU;>8-l+!8^^oefz4YhsjvdDjv-;qnQv4)pZl(%ka4+c=fjk
z9*@5nnC*5N-?QRg2l0O+>P;C*RK<4&Ks0(gun=Dzn;t{;yE@5CJ3Ew%`&54LEM^K4
zWh!h}&e(6_PXA9xc;C700v|I&9^fS?qbLo2>N?Csm5hw+N3)u4^y-X9d)91r^#U3Y
z1N2bAsSf1<vSGn)ZL3x*2YyanvY?*JmLtA>+;&uM*lD{FbT$BKjEkv@w%+?c<!L?R
zM(mn7mab3qc|UJE^*ntLy3&%3EzA`e==&*jbs$f*bwI9*MZSu$ZQEJNji;kkewL#i
zyP3Nf1FHqD*BrJJs32l5W7rkG_#M`M+5I8vzLg`W*Fpg}ZmH<zsX<8F;t-Lhl=+V;
zb?nOyKM!=E(g2G@O-Yl>mkd!k)61u6v+0;>$1MOBvBNo@z>HLq@c3+L0_rQ#Ekrm(
zvf6l-vtY@r@KA5u3H#XdE3hO7_~Mrv>e?Ox(E%9y705c}g*Kd``3TE_R^a^Cmc*8q
z5ubwuD*{c>l3n15S=<7C#gaB-YqkWFt{G?=H+)Cm)S*EfKtX|dY5y^!i-Oxp@8+}Q
zzGvxFk-bwb<}%FHG)nw%+C)P^w=Jc6hLm3@f+rk)`&=@Wf@t{%8kw$48=rJbl#&k0
z*R|#}RxuR=y_rJ5?CIAglfmwnsN~d*E{AG9W7|p#n*JSm8X;)At`6g_6mV9hwP*+z
zVP53q9%|joOwpS@Hoo<%X5xGm2IJ2?i%*2~V6V;NeDvp|FU0$kf&M3I=xCzr<6$L+
z?;%O#CsLOIjE=@|(B0X1(o89QxA3q`deh}UrM1jGTYHYXIdaUc*I)pQyh`mRUBcU3
zAa;;HJrJ9`UW&knF-)8@)X@+P#;NXfd16_l&f*u54(QQ`=~eiZ3l2T~{xt;O%VEf(
z7Y^7%%&1@K&PskWz`_r@6ZMg2!Y+H=yC|O*-e<(AP2CZUI+5Zhs+GK^o#_4$ampM^
zt%QqEMgh}xs_a2}q+0jG_5|>zpi#;ETYX-nPQU{y!XeXj#G#Tl(5fdRLCcTGSk~Cf
zg#5p*m}r1=eW93~2S}H=r)*dCe(VQFGr(l3sY>n~F$UZMh-Rrfgt3e+&&JMTN7)by
za%QU>*T?O(FxKzdTIlS?(rozfV@m*`0V*U5u;R6_kp@L&`bBTUKjF6ttL}VEYb*LD
z4KG=^xRx<l^I0U=lFTFpB%~dBvIIAldsnafh&hOO#*<s^D?YC#qDg!XFo`_uE<0X^
zhRW9Ug2v#3hPMJItM)P_X=M>nQl#AX$+IRO;ANCwa0dYK`pyyLZhtjN*<locRCy+n
zba-dT{56%!)MKESdQCg~X2-R!i=gq_<-F01>0m`;iNc*?AEo!ZBs?cUu`mO%3x^)^
z{$0RS2RZW!p9F(vBI@<>O-GMpL|SY15~(0~U_Jx*>dA<{k|FAMYsLFJKCmvrRtl&F
zbMVruILu#|dZWkiMQdv(CuE>JW_)mRlpA+wqD6O`t}ZhS$KaOmNL(_c`Wld~f7dM2
zQgI<y*&!>Jz5nREviB0&{1bYX$^$PD6!XzCM=t<UW%$Nsp40-|YeOBOb7;XR*Wx7N
z;OH^1wL6^Kn8&g+(AK}xpkRsbYBgU7|J}0!jkFTMhE%g|A;t8vX``2789k-9pOl=A
z(6_$WOzz1TtQEdJ0I7^b5Y<(&<*vWC2z{WYvu^}PhGZw_B$W#voF3E8)g|w0%|3s+
z4_!FO6sceN!$Uq%_KRpKLZbr<1c9#}3q~PRkp;}=RcXTMnaj-lh*djdLBrM7u~o8d
z1%snj(M_ld&Nfd!dUHi`HOw}@IqNYDqnrDQlK%|BEBc9HtZ;oUCr!IHDzlqvoTZsQ
zNX9Q5LF2fKL8E!R%!)CCw=_~chBE?@OdhLzyH7q~btSB+kM3eUb<$_pk3t{CQ<Enb
z!h_Ln&^R#apGO--ZWyzBq)sc?pI0D?m5-exdYZO^D>kY@KWzz(xy!pNoA5O5V^(uS
z!T3k}>17EQb#^AA+`yB_B0@<vI-xRqZ9F8l4kIV_-nv!ilv<Bpqpx2|OT<RQ7uA-z
zcw4bh>{zp@2&7EpBWG6`s9$>oVgA-NZI9CN`^Mg%mNPjGB-|rdGyYUx#MA*L=O*^?
zQ4{~i06Rd$zm)hN;_K1_t5Loe70}U8bN}>$V|nLqsNE<O@*=7`onh*rh(dCqu%G#n
zpaQSNhS4NapsdR2muOz-=C@*ByqaJH-f1ptzmQo0>q>8I3U^8jkm8(89lMSq2$0fE
z6Zl<%C!+nyAEAhvq?-)zo~f+y?j47OiPMt0LI#cxF86Z=29k%4rIDE${@)4lV$R{$
zVN2HsPf1pmQdis!)~Z&UOD8)&*VS^P3>PmszTJX7!y<wgB85B={qvunpbBk^Pz2Q6
z`75IU=Tiprp#7OnuqSEkJX4Dh-_#2r9Hpc8EKy^PsKB_abm?eO-r)sE{{!p_N+`FR
zB%dshLVHmpCSE#iL`}qSn$fGX3Rq<e&U(X6n(}V|%x!UjxjOZ^hwMqU+&^2)E)}9S
zagGdV5LkTI|Ih#PtV-9Vk=s(!ETj{Vb9ncqE1+z9VzDD~Ez{kAjICC;dlFDwCrLf-
z#2`<}imai@lo4<~l^_Kt$F(@y;M5Nyy>@%XgF0q77ll2!^cXT%UwV0eI=xEjVe-XE
zC;x+bHMv{wv3RQ@ESBr3K?L9^mEPKy1>%tMI`lt}N_OM4chxDG#+}3z#GqM`3AAEb
z>o7D?0{`>~5K%6%6*O{eAl6<-YPj@DV^KWQkM4gTKyAKaUkNSP(s#ckc)ZPRcpwr%
z^W-Dop7%ZJjfd))Ko)Y!mUx-(WszB&>Jg)u@m1VE<Q`GrI3(lW98)-Al&`_Gx+G>p
zH<*207y56JFx%V{PN)$bE`phK8S0z>xLmja>e<+|x_~Bh1V==HAp+(&b#&NGYtW^`
z%Q;`D%8CN$H|SqfQ)v>pF2lqiY82ba3+vuB^O5vmlPWvZ?7jfAvkC>&|GfROJ`Gxr
zEx(?i{oM92GN&b9X#r7F1_e&We@hQwno6&2?Igl{8?A~Vx!59z9Ml(s9HxXMp+M;e
zd0_bH=g}}Q_&vv*sT*>$VkTY)4mq|7e&E1)0hNl+UI<ylSiHb6K9s^CU-*4OCsBrv
zd|Hvqf{@&(q~2S6ERcWeo3y3ST2-zOO%Z}XNgR^o?N)#C`YOs+stGqM61Xm^k=kjv
zW<J%<N=Dyc@43B>r#MN3H+SSbBqTeyhTRbzdX<9}NR+YdsElnQQ(?khBg0G(mZ<Ez
zOf>3$PT?v_TMHkUVyJYt<Jr;{>|4KV9u=tYm1N)#7uCK?u{<b)Zlc@RZW^@|+y$v4
zbn_t&zseDs805bM4w3XE9H7EhS?&;UmUvLa-nCR@W|-N6%BR)x>IYJUMXcIo<kfFq
zM*3x9k1Y6|Xr@k9EgzaPx4;pucw>%J%*_FR2>i$iE0!SXjK|OL$DMRD>lD3t@r9i@
z%>TJ;8gAKctd}^V_#s7U-?F@^_iTLG*E=Ndo|rN2r%5?AF;hbwrw8NeUxMj{DXqeA
zim=X_Bntq$T^lDK_<+vkS0cNfvyr%@9Ht`W=3Q!qE%Y6rv%WUmk$m7!NR}!!1_vTV
z*}ob0iu4zF5~HF|okKX?TRaP-ez6K&ZY^k^N_<&l_!qa#53b4Okn8Q)O#nfVLuS;&
zEEfqNV*#g=)1{iOf{d$aOFgvdp|^@CR8BBpIY6TX)YHOa3%<*RzXtS#!zPNETx#uS
zq|Ui<Gu4*cg^iYlC)u8u|Gv`@;(rr>G6SWcU30)~&r0oQYZp9A9R|qZiGx{?T0}*M
zB<pu<ww$*DyY^Oo*Ww5YCfJcJOGp={p)Z<4uCCALJp5V@Yd0sSXIG?Ww~?IfcwKBm
zUl<K{bQSaHtP$d+u_2W&`GY*9!^!-v5Sj>FIV2DQ;<!5zd<Pp`yXJ8+TyV_BMLUp5
zv;DTkZ;*AGRk_OS^d@Y5?I3}wz#eq~2WNds%KtKy`3&p36rY}=JYfBgdEH(%VTh02
z@kx;@)d#6iX2%$C--DksK?>1yBlNCnFAH?)V^j>HjVSAQ;QMobRlzi%=n~F-=7doC
z#k1*Hy5W@#t~Dk)zYYRr3iKvhNL}OdX{70r-FbyWtbfI|!RPNEit;K!?xUBVj_`94
zcq8bo)lqw4cy*@8h^0zGd^Fx}aq+8*<guE<UQ>eS+@5hV8LJsW8G6ck>-60kLRW|P
zN}<;+OR4<R^AuJr4?@_d(5a|y1EG*#hBHZO5jCN^yH%8Es*NB841{(mXm_L59d1vO
z0j4euDejzCmKfVYG*X+{=QQqFjx9d9CHgAfh{Q%^kVq@Z5T02*M$Gaa0CsLwOvxVQ
zFx&>e)7*|1t=SFnLNPs+Fc`QWFXbg=-klgFS;IkrrR_odFlKaV!&pir);`yr8?U&E
zA%4%<1L<Rmds^UqJMEUhwcdDM27RVVq(K?=1#KFm^~-&ycMnt(`<y<n9Uh#c@p;jR
zM|b#~Bphc~5I_Wkw61J$Wqganl-<S2%?j{U^YC>Ti3`SsKryR;Ju55esdstqBMe_l
z!A%s_oFZY$S@()tA_(nXzV5#}v;%X+4e+7F4}}>>5M6K(hq_0&mu_}XanE|80U`f0
zMbNN9b|p&ra=>P%Qc)%pt7bpg$6#s}2!*%hT0Ym(IML2Hgn!T=a97ho9}4H3epjuL
zHG2Q(eJ!<W$p0%0s@CqInUHW*QeImkLlA`G>TUad)c3J06expVfP0g#yr<qTX8V_a
zU29G*?}kR&IIDyEnim<Iv}86kE5BX_tLY~ZN?~a=(v&PZGavf0ipy~tB~01X1=h<m
z4XnP<r%`gi?pHGe@LSgvm;tq+46ky{R&k==qhZMr7`vlhZi$t=6iKoSQ-?xt4X8QD
z3_`q)tj<P(3^LMx44$2^|B7=)wK1QBz6m=V)YfvlkEeV-;UPM+$DRw+@=raraJBdu
z1IvQ|XW9*19?_!1M&>Y8dU`47t5LY}vWv<U#?Mzi*HQ%X8r!^2EM1KYjTf7#v<J?;
zVsW2oiAh5ikB>V{EwVM;`2J7kaC(XC7^v}D*8-E^i@dj2qJYF@j_-FewxuW!U<WG4
ziLMJ!C{cSV4$;M;_f>O+GMkMHW^Ydj&RR}ctSs+G=>q!iwFDXs{Vkj;FGJvgfS0ja
z0zX8w&2=^tn})Gg9BtlFfy$I8H$(|NmLYGCtKm?VnNYJlQySe%9OTf~YVLA!ktaI;
z4x+Zsn!<vA8l*wWV~V%)UgQRXv3uYlxEwRe=$do;wU2axd?xeg?z~SXLwY+aw+`|I
zjQjj_nx3%GQi5}3_>swUH{&oM)A8&Jt2U7?)jS@);wk9v6{tq7A&}R96)2JYS6O&b
z$SmiWNY9c&k<F%U?1%w)aU_yB&)6qrQn*A1Uk-&b5(lK3X7JxqpR!H;2g#d5FRs_-
z#VhW64LJbQ5X+;Jq<7)5%A2l-P9$<8!Yu_j{V5Jc#u>NRVlb9I3BWTbYkVC>^~i%#
z#aQ<iO8HHA(OGI;BP|5!Tpc$-IxFLy)I5)V#fiyLObu#SD35(wy=u+~?~S1+%re_q
zEM<M;5RA$=nLPzlO&EK9(4fl$)P3srAWm^9iVd<i@0X@*Ze2Dw*;!?<rTy&eaoAr-
zeoghg5A&PU+{RZhkaR@CIpmaTRM?QtCjXPQJxI({o)W!%D}UhUEyJ_vbkHYTX;6Q)
zw+KhA2rpeeD@4D28?#nvi&DGBq%T?J&G7cC6?SCVlWOF<AK&F!W2`WAeIR#S(IO-8
zCR@gGXVvM*d5-3m<c9^>S+gMQ^QhSw#PR|rMrukCF@~F%kY!UDVv7mZ2G9pa@%G#O
z$APOP7&A`n0(&f6)eFf?9t}|_Ce?^XyB2eev(bsIQhh6#i)0oR=y0O(D6As5i~)eR
zSP?eu`Rg)h)W)dVuRA<;)2$Iq*k>$kLV)6W6e(``W7<5Ad0~ClXPJd77KPFo3B}J&
z?|qn5#7x33@2NR7F0k{%=N}LYc_s@qN)~~v2*ZfES<7QKkiC@GYg5cP-n4N0X)fT{
zY~sur9da?uPpIsg$*1LX7_7dL3vmc&_H@N!_;PK|chgDl`*Xh@8`@z$CJdwoA37es
z<X?StagDxa<C|GD$iC0=hxV1=OAf4xBTBwk{0!ZfD!n>uh#1X3Twv;r+L~qN_9L`S
zTp+;ooo2u^jYMVNM=`#&y1P|=?~5rv^dspXZ&vUnm%O3r?xHGi16Cc{f2KaZv#}HL
zP)t1X5^S=7a6D^H$8Vpp+{i3f-xmF+Pu4@adVD;&M}J|l^h+ht;!&mk+(cQ4%5@a-
z8qWd<kV!5V0(waZ!gS53m^SKQY&@X)ZZ8em7N}ZDU82KfyH=%c%-s;hdh56w(8^Gp
z&x{zE5fe1hdxJ}iFVA$u&=|nIGP1S=INZ*$9X<rV)@C<iEA0dhV6;S2;VsS%EJZ?X
zvU4D{tjXO}tVb{6ugF;Ffu1uJjEFkWkm%U@!+>-WG85+i1u&l!f!nZFCJuTAMD%qn
zj7WJzr?oJ2SniOG?GY%F6|{Wm(o(tcda#CJh4<1J7KYszdtgjL5rR4ThS6q4`{0~P
zO;I>J?C^<sfo`G&SYD2lzxU@3R>?F(Asp`yQHs>zQ5iIoR|rPxZtcVZ&b(3GyE7e)
zHja=AIZ-2t5)Q}I&#l#vt$6X0GrIn)(7p4m{s>6UOFQU@sxdmaArGwZVN1VbdQD3)
z<b)3v`jO9WLpb@)#$q8;W=z*aCD)eHJ^*yBqsL_j7}>@LJ@+CWbKNnfTi0WlT8-*n
zO?Rfji1&jyIqGX2lc+Nxmj40rs??5A`w|y%=gFk9Hc`5F`tf^}myqr63{Xn+h&UIp
z&1s<9kX}84Nx%k?f!GHLTup;^>HJM8$EmH^5A(#0wAfr@l$k?)4)xZm|Bol-zMOT$
zhmt|A{A|X)y+ymR_Lf3M)D{>`7MR9B!xOOOjw-c!*k>r#J1A&Ig>QQDzAh-1AIlh*
zXycN4NwwtL!Y4_^-sidHJ}l(-Krbw>y(!XtElTcnw9!7Wc#wKFskPY2nDukTYHpB}
zEfn3n{ylc}*3+dOYfFRrnR-kDlK0d_b5efDwWQr5#pTciXZx(<0%GRA8nI*~9adT<
z6E@Z;9z4a_m*N4GnJ{)0W{Iw*4I=#@^QUygVX9ncePXIp!t;<BQOQ&7-88jeF~;t*
z12*1@mV;;?Q|R^(5SwDfb%AJQ*S-Fw?e3=v_|Tn>djk*SFK4qJL7t5<Y!S7E1^973
zE_!d676HTR_94tt#mGksONZBQ^kg;s&M)GkR!6OTA+O0gm(@A%-C8eByU`nNS(!{r
z1Vq8Xak&qL8o833?zt;}E?Gde*p!xt<+)8yy7~F4`DxoNrO$dAm`aI+vK-{_*L|GW
zEsQ{O|K7@m;n;fo|7R=nSINLDhBRpaC%qU_&S@*`NZo#G{vIDGJBT(SN5C*xFX43$
zydBpdDzzP}&>WXy4GvjrSudfasA0fT+$|3Joxd@T+-)-JS2Tg&R`QPK^z8C|9LqGy
zdVsEU?871H#NtdFHSChjJhR;iXTV~9z9vNOYKgHEUXhQ0jZg|_&o{wN2WLevu)0D@
z@N*<q$k2!R-cHNxPS)I$lr|rlBv(wZ%U-wDu+40YC7DeGi^fL+1S$^av-DA^c6g(g
zX^CthT&%cT_w|Ixd!sHL4t3i7G{M_aOECwM;|b96dtl*m_u*Pk7>A9(LvCyhSHJZf
z9{sA#1cSKaFA_Pv(M%@{*d$tFbhYX{jIPPqqgCr23~7;Sc-HDHR{*@oDOU-$q=YlG
zq?rs>ABwZ8Eg{$;5eg7VuTw(^TJ6UjN5y}}yBgR9H{Q%S_hMm9$nXd$swg{maWff(
z^2;7k{@@RcuBs}1gi0$BFLbr(v0KYzyy`tSI<@Czk)Yj0U%O1#oFEEcuVOqswY?6M
zx=U{}6`)6rUzQ5oq`Vl9!r}xj(Uo2fjR3U&Q)jTyzQb{YX~GaaL7&1lC<BrT{Ex&D
zn*X(WbEbBrUyVf2pPxM?prW)`s#p+g0T$mM7d~m+0R^w@9OWAlMTAyBBG^gsz?;m=
zq7DTRKg_?(qHt|GJX;<<jui-THUxnC9rwo1@@NEfUjg^FLw#PbgE~uOsCc&29-C;g
zh|kUlX$4mOCcF?k1I!XEKs^ye*st407(kj&i^!MsECpxieQj+d9BSWrPP!<g<ta2M
zn(}d|TDm*kmjA(21tDY*H!~VT=bIGCaAei(2RUK72dG5qC7UF+dyX2ZUn;DzN{J$t
z^9#~F!6&;4OcY-f*<$k->KGcxCd!#p2!ucGoO<%9p?o=SZynXrL@~42n*Agx+vy$G
z)~qEbSWCfYH_*A9UR5p+I1>pj8KE-xNmmhmlX@spAExqK3MEs_oBOfrrG*(^c24}p
zXyJbS5*`Ciq9_4|)LFw+%iSL;z&M0uXz#5}1o%-svBu0AiA+}z1OR8J;BXt{#MnSD
zSMIK$?0!&<!XcgKm}**5lz(!5T65HZTf<h?^hc8vFj0Z$JWvAVyLcw!-Zn0mAa&{<
z{}N}7s809YTxD8fNRoY#c`%lYYxr$yY=SBob{kzha*b)}fRHNrgL>Q?9D)5pOW<2e
zWzJ+RgL#%pi{)xZ>@gRt6}l8=WVB10`tZMi&EBc2QjQAFPZ^8R!S);n6)+-O-_@gb
zV|)<`EL?24h<w8OA&=#8E|!3g%56@`{<^=B;g93d%_R0-*se-P4U|@pqQ|wpkR>g%
zE+U^ziO$d9)<h@8tOOCv;+(0UKk?#;9<xP$uOies*$=bL!f_%;=osyifs*5ik;2o`
zi^4LfBXv%`_WKUqW@So{oqh2svtZG#x-l!_%9-#_E5G%R3q#P`?7@FOT3H%Y)%`v@
zTQ-)xG4Bi?HP>l0V5p?g<s4-7RrN825eFWtP9XAy<D@@TAl9as&yzH_^wZ%u<WBp2
zvW}8Ims`+4^h$Z7sKR~VO<_l`yl4vXD4mF#D=32zRb$=}?;cv4GWxX&>aJfba~3%p
z-Wb^ShrY;SZN#TQ!)SS3`flW+9C76JkK}Gps8#avK@Wg&Pto!CblUi{r5*-lKBnKE
z0&aqO+KD{TY5qu0Ta4A1sxmrAM?)$GbZc>l1bw6x%NGFw5uL9J5T5*Gz`k@JhBt>w
zz%s}yMDT&hyT%}42KN|43~HSeKsr#2=POmw|F<8jn*E63k1<Vl&hF{a^a-W+aERG_
z37i**y?sVw;%L_+n2cotA>0O3p~w@<-V0GUjO<S|gnP_lzFrp{WG7Qte9U_Q$Vo=!
z+9bS3v;7-7uZ>>XyhrCBhmD{5Yh9^!`#Wns0$4B(mpij9nV+(;Q#EasCcc6q%G$5)
z-4@PqzYtPn_t_*l6rIuR&h7}xB>`OBov^t6G#EMc7u~WgOdScK?(_rvK|?@GI#Cki
zLYyN4m5qbcnl==5PEob}$#HYxSb?T2TVkrtQRx8B%IS0BY6+L4ivft5?SHI=v(iX;
z(TsZE93MF<#pbd}aV~S&gF$JJ;>KG;oThD9sXv?F_DpSJTj0Zb<6`s`dkvS2y#*<3
zSjz?*%Mh(2X#5TnO&x(H({laqmc;dqX963}`~u{OO|)UQ2Vyxj=q(1>u#<UL;Qbqv
zY9kYZW)-%>cKspOp+ud2X(N2Secb00Wyio+vy=M}xY*68E96hmZ;4L7+E3OAQy{;s
zF`4Y$KqxA(F+=l{u+ik#;t^d=3Y^2b$dlsF6lx_?HUTX>X!YFQdASO!_V3EKN2aX8
zrR7fp9!u}eI;kwJGk4i_Jz82mS^<LDaWk|wu_qY^oG*4Qlm&Weae%}B<I~mZ>h+*!
zvXh17(`j2bY9iIpOLkN9rA03&W9YksUJ%GyBDOu_%EQAcgQrOHW4$CzV)7a4zkYgO
zmQ_Q~yxCI_QaTsTvtHaTIwEUPi1leO7$8mjvbLbchXVzr=E)cj(O(2s-4uH=b@dYZ
ze+>Fd#In8}LP$|J51FeU8OWZoZ4r{!`xfLH_<-|xB5Y_0Ii+e*-ZqAb4rAQuB>MkS
z?MFed^rkh@ciXXS#QFHfI4rRIs;I?^=Fv6#TRQ2Jz-?X`QC&{QnO>sgFr6};-K-yK
z$6Q4JFg6$$Pfc$as3Vu{DQbIQL|+t-Q#P-?Y&N*&T$*au^oI%tTHvW?ImUOsK88iS
zOROM)@L3%3XDrJFPT<FrY5qEpnePpKV@kibvwslAXfmP&F52w|3}<ZVP~cB`Az-Je
zfXwRt`DR~bkATwSAlB}5SC+H(Ac6qT5wj=Ygcx~{6aD<*y(Tayp2(Qkszr_j`@xp5
zT48A*t*<^e(j;>Lwxj3wx8d1e!<hu6uh2SxnQpq-cLNtGPuRI4cPvFk1O%@3{#pli
z=m5fuDX(YBO~=zuWVK*HVd((A)aRG&n5_rHHmKu1TT`7HN-{nFh@LzD4$>-x|19&n
z6qNNn;j3uOl_ca2^m+av{OeH-46-a13HSb<crd(Lx?r}L5uQ#T9H4C}A{1DU$<O!k
z3SLd!6de%`2Uw@6Dlg)WnEDv^=-k4q<J8H}jl;Gd8$nU7Vk54mA~XbHF61ni#_i@e
zsX|!(7X>6h@i$N7i~zO)xB&WH35NK8;F?%b-O@?IS|?j~_IV&70lU|L)fdzJtdz4*
zsp5g)%cGVw{SYNBkcCiiG|nSY)6=ESIA0dkr$y>V=KJ<gE5$PFL<BFx)sE#UM{p)s
zF0P(8n|U0nEOp~}_~A!FzG&?|hyPy|?bes}KCsPKyXa7}xdIAHOUVnRk4UF}i7GhM
za0_h5->y>L!?^g#237(adxBoQeLP#}t5V_XpnM<Yr?IcnoB33Fw}t9?j1z>>DmHGX
z#JE^2#5tKE|6SomfE2|GLu#6IFG6G%Z0DFr66a@pZz}Z|%W09M#zt>edO&18b=|Qd
zS`Jk4-Uv%$HSky<5O5|GJ%U_Zx1dtHAr%s|yNrtmZbJ&S1i~X3a~@tXSZm7)RHJr$
ztg-XP+-jA?MjIV<_mt(}kWE9R82DB7xa~T@|7m~iCNg@8Va!XH1CA!y)cxlC<}$sU
ztkwD|NoiO_l=;qccG+1)d1*%J%BC<XUZ@*2I`#{_osD&6mU5e(Q>r{wQ`D=WTb3Bg
zm0>R2$<IE;_~x%PVG_WjghZrWKU)a{PhUN#p}*BOM)##^B`A(TVk%BB&y4SV(8R3I
z^a6bc_*vN#SA0nc2Aha-Y5<6h^^NN(nD+J5(y06hsQO*m+Z2e_c(bUHU02FA!tYmy
z%SBv8tr^-=WVL|cjM~Gk4rHXn>z}d2RnFYrde&?6-_AIY9ZWyl)@0d(5W^ygS?|Pl
zEVXftvPOX1Ey$8=m?S0BTdJ_O+@X#W&6s^2ABn&SdAk<g+KXKomEV2d6G|OlwR7f!
zK6+Fi5tsDuA)|X=PDEEhTlg<o#fcxQ^PG+5rsv4#?A0UJe|g&|o`X(lt7slDpnyi>
z@cY7!xn+q5FhoFAkqtopK6!}^$e@)-+m6~(xRzRP#dp0R%wbfwJ+1~y804)Z3zt$W
zBHnkf_LoE=rjqD+0NFurdt-cxkj;fu?smhbTu8H$CoO`~CQ|gq(8<&h|IZ)s;IZt$
zlzWk-q{s`i;sBLuq*)2$*^40B7k@#p89lz}rhEFC@JycIH2W^L$^dFRoOhyOfIvSh
zWU&KyW}p;M$ar}NltBQ%RA>_<@@<I??v**@ycU-`?rnbS+W|nv%2GdrxG_-$(D=yQ
za+_~$QL)%;YQd%v9d>U>#3d>SgpNk$z0?mNEvGu*5JmSkIYW3CLrUo9n9OEwCb4Q@
zPz%9f{QUMsZ-(v2-1z5RkRe`GgZAotNugM7PWcY<E-p|tE6C_$Dq3c>rBM?A7#z<#
z3sMHlvFX>4MxPHi2#Ogl-^o;HWbP7*5siUbH%K)jyhf0-08?l&tUx8v$SCx_R|-FD
z&^w3vLDr(O)MhcfgYC;GHk+0jSe{40znpwY;A1sdLO~%N4J$#dgyN##7~b?t-vcd^
zXamN`lKwVtm~MU}lcyvKCA3z`aElniJ8o4(R^i;4DT7EqJ9?aNqpGu)7lZ&67O5LJ
zq}ahg2vb)<6?3|Ri~)#^a!p4d=}ciApL#Y+O<~&#M&#N6RW^(eXv%NrzhF+;k<kc!
z2mB!v1bPlq)7L0Z7l_~$lZ(JF8cnxmb~$=PYW?y4ME{9uL_cgWUY9a1!NWoD*5@Az
zi|=Fv91Fc-%MvSJ|DP_jqjE#{cwY#M9o}*@Ry1iB(}A6_HOR+NzYxpw9-o_g$XAO}
z*9>t`{-_FtIUO2udu9x_Z0uXTxy9TE%Uf9|hmEicVNA6>K=r{5oGZ<)i27%@^Yv-V
z#(g3my!h9YB@uPjz5d5|ss!5Qp*6m?pbu_^Du9hlFOXbHmWF_YdeB3RYbG8EBY@FP
zHGiurkSYabt?2WFMtPPtD&p23wsq~vEXqz$BHbFDPAa&<?G1Xi5Av`lZpMe$<I?gV
zTx`g$kna=B;Q7a07bOsc&jE&|kEDY=Iv<n}Hf8Ur@{q=;SOVWjw}vPe0O11@I`4xk
zEptPeEKdaX!uI8x86)d4m-J&|0{LNALBTI+p+LU8+1!OKvLb$ZT~g#3M^p6{;9)&5
zF&eA0Jxn|p0U+7!YA~^P!F>o3Vq!JqKkj$jdBc%u-oxFz$va_^;0=nj%bxPERv(hA
zB=t#q!MQ^cyp;x}fV&HZ9Bnh<+?N0V`zzz7^?L4Fni2?xr6@unoc=S`pkOB=<YaQg
zYt}PE?3Tk`W%33f5*N4WH|)Vdpr?xvXzg7(+~PyAbBqR}l-MRtm%OTK?%V$_?mp@~
zdKL2gB$>x^xzhV(l*Q1kUuW`{=<ts{jWv&siH%|XvDSWs^W+C8ZlMd?tjPY6XH?k|
z_Xz#l+Sqrj#4m@!f?~DMVHs@UW1&2mysduuzW)wAC1zG|m|b_?%Rd;sgdMj|pS0z{
z$7@V?Xl=9GAIOr}mj{LeszG6>eI#!0!1{5J(TuOpRbE}s<+s}+x>F|v1V*^bs<G!Y
z`$3SX>+F^hYoTw>8OZ5XDiT?ztg35s2HD9XH$8G~#v#rSNQ$gr6fO(3k7Jo)<D@+=
z20&!RdWkT^hZg2>1iM&P1dsmFTgS83iGTj7H4Fd`VkLIAoGWYqGoD7E(_v*^Qn$ny
zg=8f?LL`qT0}$dnn1Ad`UX+r_2+Ab|66v#)j_~Yl0c#cAv(%b=Up+-G0}1!#7`jaO
z?bP0a!k@NKhW^KtzZFQO2A9_LHuvs<qb!9$>>5?v+}#JOLA#;kxU`jzsc}T8^3egH
zORmRxP^NO0dN~44SSQKgY<T}?3$mThDqU7s{gR)hnHp?h4Y+8_Zd3`Fi1VI4#TEt5
zfo%Bg7UF~veA}5_?*A>XtIvX3{~h5o!_;hjg#37}s`wV%|C;vZfu|>Ks$OhloJJRZ
zp(48u31N$5cvgCb1&B#T&GbPt+fc;oO#HqmKiRd@dn%}$dj*ue4K}4$Xg?j}?Pufi
zjw~`;2ozQSx*bfW?`ow>5SS`l{(k6c1W@6pv>#&R)UPp{*2M3{4xnA1YZ>e<27nto
zUdA%sN*Ys?V<4|sZ6-KJ$Hs%NI}E0Z9RzAcq)c@PxbXT&dEzOKih^wT#}XZmy7x3t
zSW<3PXF>!G2r;CLl?%nYi(p38&*s?>#K-|Fv&m;P!Wp@0Vs$#^stegE$M^R-)*qhR
zX{XUA(LyfSbJCISyPO`745vw8&Od!uiuN<)<=UPJhZQi-1$Hvt!iJY^(WSgh)`>E!
zl1n4-S&yeP+un-gNeoS{;2?iKt-lR?SE2`8Fty>e$3*Y`6^<;0Yg!_AO0|P~f+_K3
zLwr#&)&jLI8fvvoH%DdkmFU>>*1#zMyQAY}*%TT*ci7M+(ZcE$xVE^NE5ACYE!Y9H
zKS25QhjFF($og(CUkhL99>d|E@lTOsFzK!2$R4gRe1N<vG9P!>`an&BYQ&E&{ACJ9
zUfS)@7MYiDjP<rUjBS8&`@QVofyKv9caZWM9?vi85DFh{g4rAw-)mEaBRDi~m#o<v
z;okfVq)T03v2ZBRFe#_7TM&32{KzqIJ*ZlZJ)e0EpHn2dpO${K#5V4;L8rDho1}&l
ze5L!|_GVOZul^01VUz2i{ygbTbPBE1qSFm%PO9_PzvlBmiok0$wDkq1${v_ssG$1+
zjWad+oK7t8q|MI@&=!(M!lDzBk1HXLB<+5=uGu9{_-5GyxDXzVznde4Z}%-thCBTa
z*y@AuP&~~dN@S}%lXHr%X=GRPKX}NXWK=tc8-e;iYBeq~Z8`(unQvwfJ^f;b$9K3*
z%AeyZWwVcvFlBIHatw;#^x>FP99cMd?%5dYXtXGO?egE>v<(}bYg>&%+P>ie+yzbj
z#GKBg*Y+gHQZMau@V<IGfDT_js%(G@Pm&}9Uk*oE4DnFZz9xcA+Lrh|IGCWaTc@CU
z#d`Cpt$FSd0-MU0u-KfV4~YG+drqe0Q{I1@7YQ44bq`OU2+GsyYW4>*k-W-froTy#
zWc(r&2GV?5WF6uuF@Sgtz%<1EVm&kCx4IK%lOFQU)DF^(U))85-G;MLYhCeYV}I!|
z?Ml>s?I9$A?gDB60vv(do1a$au=v4A=@I0}xd^cwp&M^};6LfV?YIERlX@&*VJd(5
zePtEw+mt%-g#gP0;{T@&9S1EUMR4eI5jj5-Hdjj0YGcmvA4Xt3E|JlHUtZ>1*8|4J
z^Foj05dv3}U-^&ID%Q9zBy%;jtx7JrLhnBVIhWeeT@WnE+$TF<T$0u4j5a?u!rjfx
zZ{LTcUI%QZnr?o6)3CgVBL7Zx3C{PS2ke+yy^}OI7b^mDI?L4p7}^sfTAJ91=#oH?
zxZN}4yIEM>D07h%0dTz{e`QDkhqDR8YzCVuIqMVCVlUTQS*PXjh3m4ZcWj0As%Vc<
z!>BiY9KlDaSqoEq3#ssF*T%mSz?n1asS1YlzokGqK~!c?kha?IC>Sy{u^9#MI#a?X
za-v$BO{|IS@5`LuuK9dWS3>!ZJ0u`we~lw3u2PJJWBfi*jw7Axfmb)mZ1WHH8&*nl
zHBekknzp5w$=QANML$Y0T2zF7e_RhMEllg0&!##h;5K>oKLlsn3}Rz%G2Y^mJ<$ui
zNutjcytH<qwJxGZ4JiYx`~@k(U4;*{yIKAI%y_(bH+!fq)v%ge6S>IoRzvJ!H!coY
z+Kj@La7_eJj+wIu3U$cdWRa>K`D1e+bNlJJB+kN;k9@tDgDmlHy1BUl32wPk7QB$g
z?-3@u3{VyF3E#2vHTH3oeL;<AR0N|?t{*PP3?YeJc}jJh&&v*3ceItwK1;gIqNHRY
ztzQO#76Ztaf#wb0uuARz(O!2BB4EQisIdW<H&J>v_R{Ha2r%5x0|Kz<93aB32jUuZ
z7XDNOR~G$<fwdj&3f(Fii7Mh!WR~(7tHwNGj-#EJt$61PhK5CRdb>T88bm<xL96)s
zl8NjDZj8CYEuYqm67wYMmv0AgQFxtXg2=EnP0Y%>TFhyPDvFc=z?xbpv=x2u18CDy
zEQkd2L%*h%H_BwJjMvNpj-l91e85NkB?Dgi;e_4T!5zNN$`%Tf?DAmHo^!Qw^0HWF
zdD!86*mr29gN6+JJuh@6noXPE6!^MI?Mh`4oYI&X=t;*jecj!44fLD&$(k~9$ZT%m
z-*|vL57;iAhW(%Y^x^1&k}2Rx09%g2WJ%7Cs^y?)BMS0z?66q6i8b0|s*U>CHuxF1
z2P;6w^QAT!^r4PT7u%QE#G^@dK`ALW&!wWtRa&)ry_!&#kFi}xc^2@6l$qDjZCf6x
z+Hlpx%3YK#CpZIncLDfeBIaQC>MP>CH9o6bTne!c|5R<?-#UBT61#Udy4j%1CdMWM
zcdeZlRwbEO3~a;sj018_9o;32KUX5NX1{n<mz1>FJN019$H=Nj`53jf1jFuk?H6JB
z1}u>!HQj}Gh_b#~A5Zw-cT=7}LQauKns7H#A?;q*_6XQe=l_oxWKOucG(7W_=xpF$
zH)X+<iF{kJEDo8s6vUfTurswXQx-t!Ab6lYSmGkq3xFv}S$rTTMSlEzZfSlVUm?up
zM5M}wGp&|$5v%S}MgHHXd-H<821U$JFAjt046m|mg**UGz35R@(kY>&7zO<9PoY09
za_Utk@Y%~6tT-#j5+W#(DgrC{xPzp_))UI}etF{J94=+neoAnG1(*aPD&n8&Z=m6r
znwXFRNdJ~kYtR*nM*N8^^>K$?9&OZB^Z1WhA1meK+?FybB=wKx6xP2b$QHh{XAtdU
z3%Q@6C*~Y65yI*f*&qCi$omdul^Tu>a|=2}r~wsph%!i2=?{6~+8&1Yhm4o-CD)pv
zhx~HAC}!w`w-$9&`Uhk$^iY>I?m;qpm%xHdMMA4oKIMX`4OQ1n<m&+fhS(IO#j3@5
zGa4n6W!yR!dgX?535-mC^$2ZVeXvi^j6U-SiN}S+^$zv7v1t8Oy}JbnABcNHbc~Xx
zM`9B*j?np)go)wu6Hc-CV$><uDfqsJDbk9w{_l<$g!9G-vk6_%DKB1Ixo<I5pZnus
z|Bvb1?deNQ^Znf<MlFXbjJu2D-Y3pG0vJh?5T%XZ8MTZk_{;g{h0vV*qK~lFGDxZZ
z8~09Sm>;L;O{&fFS}Y}m*5)GpED{JD2>4*gB^Q<yJ#H>Txp>pJ_^;2ZpJ)j_3wb{R
z62V90n~?$n;oWlsN_)D6AFZ$>a^iB1$|gtJC%ztNyWqa3P;%V1?xig&x`(`U1B2wa
z+^(DF{N_0Od}GPP8nbMK+jH2zI&IZ`Om2KGr9`5-$h(p@wG@61Hap>4B|URm9Iimd
zDXs0~A_(N5H65p^t;<NXKxAdC;a<~wtgX{sOJQd(kH<p@@+M8zX6rHV(mryac1Cpn
zWgpepm_Yh6+TmuQrDV4ZzCCg;G*zHRe`@+?nu<o9q$uzcDgrp#mw+pgB5<v*xKaPK
z$3bwap(*&_BP_w7f2wzx68!cmJ|vDx>HYB{7V6T}SV+M9){oW2fc4li026R}qS?`s
z_WWO-GB8l8sX?BrIL#xJ4h^LUwnJ)Dg>JaI^{^JIAxwhG9VvD0u8~MJU#mY~%O%a!
zJ(GJZkRr3rc8ym9<cO<Q(Ey9Ez1!6886c-8uW*&*&}08>V^9v-p{Ux9vn(8QKj^>j
zDXgCg?rX7lrKnaxa9R*+Pv$l#U>)h1ghBzC!VV?#pNZ)&JRyQkSlFIkYOB22lhKPR
z?s!Acv7XEf2`-lzfD>zn<a=CICb<=O8d#AVY~F++tf^ZjLLVmTTG12S5Fj&A(~Uls
z7CvXBJgDl*?_L&eg)T)y$imB=v&y)A`+MQrSAj!+5%8_w(G20o%Gy~wJtlih@lvdO
zfj`|tSEMKm<GzhN;8Yvp`BGp?vPyI{(l0jbS6M-?BV^L+%9-);Kr(VDkHzmYi*b>x
zug3%7+th7Y4Qxp#Z;(AX+vRGxn9cJuhiJGltVvZT$i(h^sPrn*a~WM)tjWwpWl{IZ
z@r*~V$teNpL+A%T6VA=_M=M!~P`e}hxCarcnMv1?Q>V4M^+#aLzrx^$Q)<JbUvNAE
zIg--1WKzuDslkk!)Q7h6(!K37U_f_lr7ELeJRd*iO+NWn?I6!QLpcmYeUidPnc`>~
z+cXtWO2@rqid*_0q82j(O4PaW1Tx3VREFE=a5}GR>F4*Koyw*ZlBW$+0a#NT2K{p&
zw?AL*>#w&77OratpJ&l18M>WNVa$a1&fyL`#G)FzdfP(oroF%p<e(U@!@v98neL{m
zd~)(>E!E)qCt6Z#q+q#-oKHE$=!8LMNz-DOWNJvO0B+ZSy;qN47zFhV699sMZ#Xbr
zT&@g2w4b7TRfq3(;Bi^CmXlLR9lpNPD|pXG&IWVL$4^FvPAGLMHa&RPWSM=iCu%h?
zh06t^vaoEL6N0Vf)wZQ82;q$7o!K&8q0^h*WyN2);7s^wfj~fK34p}!nU>`5?{xgi
zii%FIdhwWQN?cgK^$NNag3x6v6cOUe3%-W)FB9v>!@k*wq?a*h{%BA8X5nU9Jo-CX
zt1iDo>`=F}ufD`3`j4|*IkexfeTnHY*kf4C==%BqapSsP!q)L(PaK^H*^CoCvV+8k
zNUP(Cif_I5hZi~Hwr6F-hSNc_LeJOwakGUcZ$-(*fi`x5JXJ$?ae$rRhCF$OQw#$M
zW8TT@4+6%s(7IQWP=X8jD+2X}Ad4R}(V}_bBx!X0eYN@znj*cAI)V8VC#&LbD&S|T
zd7yw2_VKE?V4bm`U7rj>Nc18Y@Dd=Fp@WBu)q^>Oj2NXTokC;;p2tw;4D1Icqh*gk
zyDe>)t{twD1|}-!Lvt~?R1~cdl?n|{!CUOg0O`U=0^_d)RrJ3dMAqY*-p_t)Uho~!
z=*Th0s4>%F+d<Vi%Opk6KLVJqOj+SDCa}5)AI7m&lhPlyZqyGGj}7*q^4DImMas6l
zhz?^tmczkkp9KN>Iv%s=khZ@PdjRdJBF7+bJzFkw(4aClPrTX_y4Mxp!|tmbkk}9k
zQMHAv05=XeBKou2WUaLo6j6g&1Mo8-iD!Sg>kIgV?#a2&xpY8=$=t}NC7<<p&S1!K
zfqV$IB=uYu8cq|r^$b}*P|z`7QgWSmhEFwl0p1Xw@q96KT>FnbOW4@rAM+|32+W~-
znu3^1=`bE9=2?W|H@q8k`dhI!%{Pe>uoNu28$<gIAL(Srp=>aZT!)oTq{^D5r+~ms
zm04Oe@-3wDyf&B5DUlm=E@H~~cpJSh(3kKsByPy1k@{K|_?1R~me)Lj)D$-}#qdQ#
zWo#L(Z}MHa^QZ(i$9|%x+;kbU4bV-Ey5@)oR#=NVYLk$goNpen>H49%H%dnAIqLk)
z|7^$QL;71`JhZ)XI<poC2TY|4COW)+(K$UFyeIPF!+EIY(nAkCbSf+Q18_%P)8;LH
zXO`4IXu1wz_L}NRYynrA)Dzc9pXM)@%^%Z`D%H85jLaB!ee1c66q_C>X+u)BcC_X0
z{YycY;gdt~fPQ}Oa3|edw&(=J+RmsGLoJ)enj=Z7gocJcE15v(y;DWy^B=KHn6*Nf
zj`c8Fa`{DRkkP<1sA#F$+lQbzS+3siG-J@$$2Zh{Z-1S{<5RX=)m_F~^+ot*Mz@-R
z+yki7XVWL%mOu)?#E56~V#9GoFMbHMEe3_1PJ!AQ69=nUJ2Y<+y&{@nSiEbH#5fgT
z`L;XI8|6&&!T%P@3_JhC?Zbc12F5Es=551_vaV_&Z7;)5oeXqwB#%n9sI79MT@Plw
zn*3jG$Asm}r{4Fyk0esd=EG#{>Xj*l)PgS0jT((j3TRN+uaMCfkJqLoM?xx#i9EAc
zT~!3nL^u>P>cO<4`l?{_DVJjVj_xjAYWj*65?OS2l?FH*xF%=@rQ6uUR7a&`BORB4
zj&&hiQw$L1Uco!K10ao6YWKFzht%btaglS|P7!IyiGVrY)itL)!XY6mWWgnM?3Wl^
z@@OsU3zGEWBVYG%D1-3oPn3t0_qeH;r%y^|@D0HS|C7faZ1X$!QS1g+BDabnuk$Er
z+eK+9!v*>t<TKL8j+^jTKx1SUpw43A-ycL^Ezx7#$Pxki{2#9t8<~aI*g4tpm7<EM
z^3ve^v+!@1eC{zj4)FRzIr_+LpyNHT7j+m=a8+>HkirbJM!Xz)&cqX`R3Gg2v@s-0
zDm+M#>Ht4L5hAbh$}HXmaNq_QY7Ywmn=5Dx<H;Qdx_{SmQpw|@)^n>mY~tzgB7vuz
zx5Ech*fu9*y%oZ*Le)T|>97g{GXe)}^tRcogp%6%Xf*Qo0ruaSMH=;PChIg#h)-a=
zeT(it;QxaBVV**Td(*N*dS2gxTgi#iF6?O$3?zt$DPJpJ1@rGx6+ZNX7E5rN?UKJU
z7=fOzm57Ga0=|Cybe>$Z_KPz0_~DzgB#lZPC-MU#q(Sig?wu~#J4#<&E_G*4+)vsI
zc>mC2!q{q#!_rK0%G6TAH!?{=H{|BgSNfb2K~tFoscE&%nCA&JfV9ggbocz~gPhVM
zkx%nR<Rl=<*|W&@I<<b$H~jQlJ{-Bd004T><s$fkWX7D)^XlR}{sv-~X*lYA$Peep
z>xt{0GR>>_o7)Ujuz4IYn&l&Q)!S~*LYxPS7aNwx{)!xwQ97M~1BP!)SSL+TKgs;X
z7x5Zg-Y566S0*95!NUINmtTDA#`V|;4kD%5RthB`5c+SlK(H*2*3+i^Tya9!sYbyW
zYnI424d>9EeP8>^ej<YEgeb6S<|J<@V?v+j|8VO?NQIZmV}-5L=1yU5z#lH@oW4qB
z^&!^*?V>OK8@Xge_wV7-WQc7yZpJv13Ho>DpB#(OfoBn+_TR{p1k|o?1S9ssI6thO
z=D2|(x^!an=1LR6k*J3)yrJvJ8%$--<Be^Q4jq)BYqTJ{sh*4w9ukz02n}?H2+t)W
z+Fq31x<QY>)kUivKGXdvyJ3prc30{Rz~XenoYSQpE3)Q={4tcS0oZ={Lm3cc$p<4u
zAO5|LyM5JUq0pALINZ^+YGb)}k5v8IDj77Tu%zo{ZgNy+a>))`{go>^<IZ6VvniEC
zWok!$_yZ)Haz=aW1Ne=M5m|$nv$ro<*OkHfa8wqatJHiMU{1R;)dXJD3zVG^=#e60
zK?kAe>kHjfDqi4tXVj}VR71VP<$b^WfrxX;We3~Cc_W~Va)K7IC;~_LtJ=XuX@cbK
zmyc{v1O|&Q2c7K7c||xqO7O<3PpfmZeednEi&FW9YiAu3Fyesk)<^p)Xshfpz>?un
zcxsep3BTMkA7>Qt@zum~FBvdiTBjn@al>zQ7)3KPBK(!c*B3?gMwTZu;GS;!qA%$a
z!ox~b)f1^nOX3`N`_7B$K@3-#>E>w|BKMPlq{?Fqfi}g1Me=z@^fXawrj{zdLN0!h
zKZ1T4$8}<a*PSoU6!YrV5$k@;CoauS<7bKeqE#~kAye9pxIG!WJ#Yi<;|Rk-tM1$<
z84}>w(qA1BXstj7K7E?CPWY6DlTb_sCMMwMoaR#t-qMo9V*?7?Qe7>+R-s;e1^~z!
z&(Xp3w}B}C^XiIN_((}QzxC}af+g-;<fDeyDnPKnNt^f?LOFS-Xejk`Cb{8*3)kXJ
z6GqkcN%>lN$p11@Ei0c>qr|hv>{0qQHjZR8eR%g^)*Qi)rM;&08693WlI<Y11PgW`
zdAdzTw4=5Hn&$k|yAdzbbqm&S^GO7MfQG2fdthGa^U^aI18ob58gU6h0=Q7*#QOZ2
znX{0@;x<grCtN7Vkb2wFTo02A*FN42(R?e!(WkLq>xTmHYCw(pAK{-E<Exic^TwT*
z=f?-1sj|n2{8fjud9i(OFqKp#Q-@aM8PLY?ersIk#}*qh;zFNp(j&S*b{71actQoY
z(O#99p0569dxJr2A<MnnRbbdv>Qaz^WUmHN-tpdBL}8(&=&Gen4Gqa}HWkf%ksR)j
z?Z*)_*(#>eTK8JeWHnSlh8e?Tn%F;-ZWTI{NZ~v7(<Z2pj8>VF?-%*H_MJNqJIuM9
z>3j6({%t=3)vmwp6ZJA!Sd`|!c%nxmWml3K{iZKZu?=41I*z@RC2mIdK=!sW_I1*r
zu%$V{oxSM?{S1P-neex)v-?=8{;W>P`lNUW+8>H?z-7bf<snhYi3UM02?`S%FRhWc
zU-B8ezA-Y18-M|Qz+1_`OkSD$FG=Y3?fM=1C}x5$n6O@_SXM>HZ!0byXv2{jC2Gxt
z(_S6SOblbQM4g7WxEYViGOv}jayHYjBj1!v+P%eUSZ(4da+>FsR@61Ta?Dx2{t#*U
z6^I7Da|tTqj8KR}_3Uz@{>c=9{bFml{IUi@!Vo(5WKbUf;}oi*RfDE3&asEK@Ih30
zhx0TIJl=Eb@9oL3k~-4_X57%uD~Qm?1OQ0ih&APv`>fApJwVx@Ktb0(^oDR$w|TG0
z5f}@Zx<JTWJrCS(_TkGsy<a8ID502(h9&#{;J-uD{nh&xD9fq=lBXh=+*#xqqC83s
z&)V4sdYzIbvNs{mu|^P;L<z$GgBHUD3vrbMw{)+)2gq`%32#85AEVA2)8drKi#XUl
z1h`446iXhd&^e9wqX2uSDe&?N3X)>K&>$RuQ?zQIJp~RREOBhDXp1@{@r60E)cyP6
z2Y|DLk}y^<M7;>^>$oRhz`zOvNe!6iEOY$A20_Lsx2z5Mn+&=&a}=SdjH6_1;s`MF
z30x6?Es6TI=;Y5Fks~kKBAUx3c>H8$7mDLtz=rn|<qvDapc?2`o5qDHjBYwKfTg%a
zP}<8qj-AzS0_q3AS?&`*Kb0Yo91u4jc|8msB`jLcoTewQkK)o#hWw+}H~@A)crOg(
zI|D6$?QvDy6R><CaSpA~of81c%@_!ENfIIHh^nm*efhI7T?LtGy;2o4c{2!(5@?=u
zGew@%O;sF<2>J%P#0V*2O_~*=MZVF`GK>c}j9#X3rIyl?saj1W{Xot%=g=EfnQuk1
z1Rl0<x^GO5#Ny>5gKSYfeViE7$D9*o%j`~Kk>|Zhthi8grn6}nbdxkp(h*u`0Ld-f
zU-M~Y<h+Kbolda6VxW-+gOZ)yX#u>A61#g=DI3}e8#OlSo@eIW`lY+{G_=WOOnyvh
zK7C_v9LHnejU3#6kkHCKi;qXyHFb^BV+d6Qa%)?gyVl`;`|<|dtH`_5?w*a8-u8m%
z${_=M<+Nc1%Pl<YLD@^v(2Xf`r1my-U`f+mIvl%|Z6NPZV?SNaG^274X8(5tX%jdX
z{$3wSh3oAO*eyld)5nuz$J`EW8u-=zGju5xfca8iJ7kc7zSB_m*l4`YrS%;jMenGq
z_6TMpv}`62a2~#I9O)D?E`<AuKQ3)(f;%^Ul!NgO^s%bF-|*7;S%BZ=vQ}eSV2S9C
zCtUZ@$qm1$;0lH3Dd^d@UkWr%NTjly2^%k|rHY<ZMEXL2sGzj1HLemWzlPdCgnOh$
zrmwTOd)K=xqD?1gv|K6XR5l7=3b=#1I4lPwtdcnI+&YYgwgZp9{?j~}rTw5~FZF#+
zWK|c6Dx!8Q@#Dp$6W((lAh96_Z$5=)ez7B6`5_;yA$4BuSD`>V0-?JuV}NDqnCsI^
zpL{b|HWat`bW%NlLzahodSgzVKo=ZNo(1exD%%`saOT>*uoiLEwa~rgX#sDk-v{OP
z!-wlN`$qLLSgo$x{)CABgd_x{yVd*GEba=_fappW1W`|mJ0q~nu86Zw!c{?g3L}PI
z?MFEj|L6cG00l~WJNT??dcEjhv`CsQrl8P}>UTz_y(}4j_v4h1)C-@9+Oo%E){QDy
zL^vIvTa^XsX^E|M(uXhPaPIm6f3!wg)XW<mWPU)7Sm_kd@Es`^*Xx|benkWvz_{ut
zTg~pV6;p^JA<GZpo$~YK8WvvDy?^=LqY72#Y)aGCAkigmb*a23U~SZnpdiea9C*Ni
zKM^0v0+-w))~7?xV#F`u7DB=YSuh9&+{N}kSw?PnYpWQV-=#P#Wm8TVFZ{i!d!#4x
zb2ILEF|mIuC@SaUpaEfA^U3=(<tlPjVo!YXnf$6Ww}^v=Wf_G>JGl1Z10E=z4z4px
zBjFRu_#(Js`BvyO2N<V9d<Rha06jp$znnX^wKP9YxG?k6?Z+qM=>~#~5zO~CqMN0s
z60Ae<*<EX@A^w#LU>?p~JyLL6^kd4@G{5uQ@?!}y<%A9ctHMxyq?umqf!GyaPG-?y
z8S*$$x0ItyUr1A`cKdav%w>)9`Q9Kc&lyS_G_7m64rnCJBzZfhAWyGBy$zXAHSo^m
z28<Vcc1xEf646r?(weV17!^&@qd#J7^!LyAT;*S|H1#L?W8UBg9mwM4(dEgf*1=a@
zCjC0@3ko9AQpvbjUqv{_c>SjRAZ8sMNG6Ic8ICgtZPFK(=9&HV$POMq2H&7BMvLxq
zaE29?C<;KsG{OvI1d_tE2l2eTvW9$D9R}2*8v_JWo$j_ji*bv|MBRs}`=e6u5Y;s;
znPXJQgsaG7ok}n#_>xeCdk9qJK`^$~NQ=gQwbG>JSsA7PyQs`_$UC}|8L77VXY%Mk
zMlBjsrm+cTlp)|S;{4`88AX!{4T3i!xznN7$zJpXu57r-`oXpkxEUxi;@ZSWWN{!P
zZ+^K<e3C9zI94D`W>mViHGu<f$#L`V0JMphK4g(^++6Q#A0K@#ZK`QU&6TwIe{^h_
zGvi@S#T}a7H*eR}=c|)(XlWw3nfIZS^v4-V{8$aG(T@HcsUB;8Vw4cX7AWR?j9R@z
zRjweJZ-@uc0RV{W{ibY@1Q{pc#B*5?k)xQ}iZxL&tb{jGNrWC{F9_(U0N>4t_H#(}
z0-oMed`M?G8L>F0AAZ+q3b}ntL3S-AxtroJN|pzV_<Y-TU;_CWAgA-*5&5SdA<yuY
z*Hr15yLC~7*Esg9+0q^c{Bb3{A(BIE>Z-YX@?uI|6DAm3Yk1J{NzfMddWv>o*m06x
zQEO}g=fId2Wnb5J<ss72XwC|^MV)*84oEBS8nGSfuA>sauxX++&2<69r_>kY{EWa4
zPGKc&rTIPm^{na3+JRm204C^D1j6r1yX|GpVbCsr&wh!(Sc%hti8nDh(@~`HLfB!1
zCpijIPyX3JrH;cP8{Sdz#xO$9pH<K<+6}ldV=Dc$HWUNrvrvq(EeRHz_yTmcF`H#V
zeZ{L_>!1BswNc^A9LOG*WC^vfn9-8c!yP0Q&8ILLn?)!8oA=H#>t~PNm@E-VdbX>N
z8x+z1F))7M9u89f!f_LwzNhV3l-|Dx_b15ERLk`62)3QhKId@urHFNdMq<5u0;z_6
z1TN1g%Fn`^2U9Hd6s`chrvp}6{yCHPIX4M%BOCr&^JZWPk;V~zp~4i9X!OX+Ji{zW
zmr#}T<B6JM%@6xZ&o*Ce^DdBC&WrM#GBXnHCa;{KS%tHmP!^<RK=mFYJ6ff@!P-5(
z>FC|=>0M3OtONLNS#`xCzOmygvm+7g&xYPB+N<N)&OEm^wM|EI4-^3<5CY1hJ1|~7
zV^0XTJs~oA3!IZZmn>RjV+B>Dw$7}T<DR`Wtk)Kj<zN0h6VOn*zjnCg@801Ext5+$
zgU>%ZtxFuKre8+q8)0@llpqzL9;g9hE?}yI9TItRbXk7L=$_tp^132z?Q>$VHc>K0
zW5e7d`7yTIG*~syImBuSudI{1*nQ93V|1jd6X4i4Xc)Mp09JNafDTe`7ykfI?ZS=K
zvnfJanq=+(`H>4)`m%644i#~$%~v=NymOuikmRY%l*S2pE!`hTx#y=P4%uq5!MIbh
zcVtyWa2l5p_4PC6_a)LSI^v9Xnnql3TyjD~Xvn+fBt7D&U?M0L*O%pv_quoSV$_|{
z)`akFCl3yWj(RhdoA3@~o;*pZI3v~*LzaS$Aym0fS~e@hnZk2u*+`7s>P&d>CB!AF
zAu8^n!321NR`?yrGY=C%W+=cxpGVeV(K=32OP+J9Czt7A<<HFW^_E-fJLRwF9+d9s
zI6LBN3&k*<D$doW_fWv;4rDbsPcHErqm-tF?<vJ8>8~E46#Mw<t864s`Qj2lLOeLi
zS|AS3;|8YPw*wVBmaS|m!~@FZW`=0~LIWOiFIIfOz2_d(TI8f^GhDDR%#bMaHQ{Q5
zLsxw3LI}@VC_SlEJa&v6HhL_t3x{xCOHKh$1(JklhjHMw8Cwx1%YBAB4FE~;duf9V
z_1F2MfUh!<m}rud>RtY>Kq?^1KEPI7u;ca^o_P{O7Y>|C*05drgFYF<si0ho(@20F
zBhwqU_6@avptMq(+1wJC8&0P=R-3r;@O$9ACzrc@z+?6r-4rzvy8n}kC(_uqU>3%^
z8$xcc2z6P0<FfhgY-JIYMvxa8Z(dS`-5IPbeb)w?u6YemB2o3o<kEs{bJT7C1gimh
zxfb|Bw{bE=jWGzU<I=*Fi*j`JHq$>hNWB>;gk~vB12bevKZN}romJ&<edBo(XvHqi
z4D{Q=Xr7FWXh~&EORL8>9GndYf{;XX!oZNh*VNvfXs*-0@I~MK2<DLc!pD(g2wa7=
z-K*}8;BSgO1(H2rf2vMUcw~d*W{vgzw-W{5{aweH^{MYCx8;k?JBebWaU%mAt(TTk
zwoQ}+Kni60=19*5+MJl+q0o`w-`Q{Y4s2W$-)yTgsiUbU%V`k&iTOlmR}|NMu+FDG
zEtSE$i7IyW<IvX=mJ>S`h@?e+6NL#)OWuVuj>AENhVD;KkQD;ib(yucZunK~2aNg4
zNG%xUk!fp??XWlPFH(BsK{-C^`!zcLFI)`GxYYXnjhU82m#w0SP@woYkehkquTtmF
z75{E4Tk*+FcH=T7wO+nR&4m@n0~kyw|2v!kmztrpLDj2r(XA?8#Cn6;X;d-$0(C4G
z@PX9Cajz>6O{xuUd(EUol*Ih~sg9}R`_&guI>=>{?ozknCm(1S4FleaUQW2bhDynm
z%Oxcr4I4BK9Tn)$#IbnKT4!nu@(RoKooo8q0J-ZBtr(3O2g$eM<PmUXI-@FzbE9)2
z0HG4?%P7QAmmI5!iLn5PWKbDEao_~I)7jROKz-pPXVvjH#Gkx?RoW>Ixq2@jrtfdf
zq5i?yf$0gPSN2*rQirlUlK;Pwtrq^Y=WvzD5kC`#+zrG)yk}J85$_9Abv=MPUXvlf
zST|Vc4?zXw0JLh~@(y~=1ouC{ekMQH__@jIFR;-jd%n$S$AzD7xx;G^oBaoUYL+{P
zF!*1zxnsy7nWc?jTFw4H@f3sKkx70w$9s3A!R%qxW|8mh{zp1*%gEnNWWF2nCl$ly
zg|bx-_RGyi@l;+~RFbeal({5$doC_T#7l*~;JsSX=}Tl<Np6kMA(wttx+2Z0m(dEY
z7)UM6%I+z#EXXZGX1Q!6h~oK<u6E_@mi|ZzcQC~!(W3=kjv%u0fCJ_Qu?Oal<m61e
zD_`J8w8E{(n^YY^YEZ};BBF5E^yaKwZZJ5p>Jt5yJPLg=sBs9Wse86c=Qe)%<hSS7
zf}IvGMPEQFh!u|asB8~kv8y0E?RHJu7Ssrb0?=-TCAQJ}GXX?aw+87~f09cXdtUq!
zxs|M=`kMjs?Hofnbqo@Syp7CH#g%sIF(0IGgiXJ~?@_c|YI23KO0Bo^_-Ku5C9k?K
z1Uh21G^sA*Rjq*+blBp=(?yb5vO1AT(9|}VIKLdVoQ>3NNdAd}eiZ$za#F7fL;p#$
zIp?{eiZ8SiP0<?i?%O7m&ic$M3ZRhdu5)ue5XM2(&kauF6bCcWc4^(yn(avCnKf_W
z86tj86TDmsJFYkxOb6NKwL<9s-+&g1FJE-gdg<ap3AW+u2zsmINbOkH;8@P3hygXu
z_+PQYjTk0Pzb?etKGLfNx{T*+*vPLZ^*Z_BU<AG<+nppZ{9WAy)BNIfTVbLYB;t(u
zm66L(ka6>7Zpbo+cf8VOXVUJ@<mxlP;99eh2rQgg^Fl`P4S(utwK8r6VgWT2SaF)L
zo)lk>D7jAj^`jReb~q1bX_NQeem`j4F@uAj<NFu={3`EOWG7Mf3T*2o-?i7uPMeP{
zP{Cl8-891lg}~cWL1#(6Yq>%ZMstiX1SCvn5__dB=oiTV<KhFIcML%dTjMM|-H%A*
z?ixl&f|m-Fc3T;enV!pgMAo3-lCpg?j0WWpG3ATqem0C}z({(4r{~-=4uywJR9j1@
zle}<zVZbrM>h~L|jNo;8K~x2!5bdcjADp$A6vHy_R84uBG<s5iB)XG@iu3HgCNnYN
znhPq}PJYTyHg5o%553brH4_~)$?2Rjg)IiN$?Dl!^}*4}9;RrvTLzH{vLw7Qg;<wb
zrMZy{{KW4ETC9_TIwY5Q@X>YlMnObRdQKvq3xzN%5KR%LBQ<8v6z5t1uq!2Ucsc9N
zP$`Qcgav3X_=;IAFQ^NEA~sLD0ov~;)cLa7u>R5ZZ_l<SN4w60@?}bPq1iMr1)g}m
zKD(ada<TOK(>mCBv(-Cqci1he!do(DIqO()0RpX8jFi}}J~tQ3?YUy^lv+Y<nI73c
z&R#e?bwbHbRoR}sy+)B;SNiPRY4FQNchMk*%>@BpK5+NVz)))fHYCPNoUshOI4tcg
z_4YzE-4vLN-FJ>;^DhRpIJh*~jaLL`JtVFu8%0b*m_$%AuzH07KquNI3xz!ppc8rY
zYZLRApz0{z^YA6hc({cVeYyW827S@boa^f)4dE0*n3ZcJi{94fK>+@jN*@ECX}m>c
zra=>G{cA@XR7ATk=r%w9o&S!iZ7Ump_DD9%^%~a=U}G6s=WEX%?M`UTR1e1Gi=gg2
z;Gq~FME$gZX?+kMyxX~vda?s#@m1?yG7%se@^UrnI9)~0`O~L%rl~{we0ladjE{x{
zutz1?s?2&`R^%AGXW7^T_Zn2JyrY=h%Z%Q3w+(05PWCV%j0X%f`QltorLD2JEpP|V
zPrk!YMWEsN`3%heMp85&Dwk;_hW|ow%YHM5y*ZYX9F)HC9I+T{IfiK)sTA!-S27KH
zn_dK7!=#cgwxlU*zUNT~DWiP&AA}|i7}R;E<dkNS7i@HP;*anhde9Oj+3?TX#RrIo
z{}oj>$Oopk&nl4{XWlkD@>50B>5R3cT0t`e0?W|zFwoi`${<U$hagGatvc2IyywYd
zY$c9{!zZja*+tQ)0+hYBOoRrO@By$IHd8eD9!(`j`I;`>dBG=Gazxe#hF#L-n^<}G
z>N>yOP@<GX7p!O5u8K%3$*cC2qO})hTg5*fw<KUj>hab59@V5!bvk>h2kuvirE5V4
z49l-V)U#Oq?GOR44m*W%p|WJXM!fe-GOb%TYP4t2#x1-#byqU^_72JvCGIa6AG`VB
z{k9YU3|Co)>xq#v@C2uxlYKJ9I;FAIe4sM-EEa)qZlqc*ZT0nq!}Z2Le>X$luyQ<3
z906YB)j@*gQ(Q@KDac=mVn)>I584}DH6Cc^58Vk#k^61s?=ij1@<`Z|L_Oi6-_Hh9
ze9h69ZLwRKURsnDm_1t|fR$v|$U&fy5(bGep5?xivJjp*)sh)sHI*hfJ>Ax!n9V^-
zc88mS$BmBOGPJ&<L<_&}k9`cHh_ib{PInVR@$t36kmE@ZSM!>@4p-DZorSRC==;(h
zn$YBo*c3SyeCZRlrcC3tool(=W~+vG{#z$Cx(A8GzOjG6ti;e>HXumudd4a(`Ua$?
ze8`-(T||AE0Vxhu;G`Sx?qkI)r?+-PS$h^n+12;fKpJ~qDJXB}qB-<_4m~;hnj)kF
z_#Ic`0zKG3p1>%nag~+RFApU#d2$n$xm<dzm-^bxC>z(MU;~A_$pe}zPnW#bD0NeT
zp0JF(*#Hx5tJAh%)QX*H(RuaMXx=NHF^^w~y-ZO6O4iTz4WySDKxh0eI&g_4#*$ut
z!;$~1?mU_nKl1BKGZwqGfZaK;kPZYTxk^sn{y|^K_}(ME$+}}4?e=y!K$9O@RDKVb
z-^_PWY}P$s$0z(m`s>9(I!g4*^DdAbRM3!CK;ffkgP8sMNEZX_Gr!a@!t>j>Oj)c>
znn0tkh9Cj=v=1YDdz_${0YMKzh2z;!EIoi4@w9l&3oJ~92G_b(Xa6T`zo~;4=OkeY
z>tNp!GyTt0K%HFVXBnCWN=e!7an@-*B14@;I(#%!H`hhT%CJ2@sMuAX(imtdR{=y&
zBX1zd>3BV)F=EBRTN;gmM-+N@NqzA<c)ZoZV_o}(RRCspU%(L>6C|9jV%C>hisN_{
zAz|?qd7AoI?XSkiDShAo`kD)McnPrQk_H^7Eqh~QBl~K>si(2Tu>K+Gns?Z0UPkCu
z*f_T&F7pk2TUaf|PA#LJTvG+nj3s6X=ebe;3gt2jAw~p!{>;;Zw!ic-lPAW6F%H3I
z1->K=S|`jlJBuSZ?h{Ww2uPkO<A2#KQdQ}ni4thr9uDY{fS$hrUB-M=cF;=?FQ5!W
zWEMDAlf5MBev3>#xn8z8B0ED)$wXWZXDOoAB08|Sl_xV?XDXy9RrnMWPUwT_hmX~I
zg2()iWni|DTHWOdfe;i1BXfM%I8sP`S!tVEW`ww9IY5QZW6+8f9)w@>nv2OCx}U9K
zM*_=KGIBVrmJ2R~;oNCKZNcd(WzkS-z4#fBMu_Q->=gh%s?E#o?Y)U<4t}pSdA;@M
z{*Dp8#P6Y!NLwZzS35ztoERFf&5x01WtB*{CxeUOY3*5id{7r!3+?3ScaJ1CQvoxW
z(6%{L=CHxNHp^I*$_D3k=*1Ef5SS^;?r#!*sRALSm`dDva(fls5ib#A-lt;_bM-h8
z>s^b|$RDD2#_|mlu0(PS*=`9a8}UgxJmT{KEhs!A=f?TZrJqk3O^<=Wy!GXJWlf){
zk<Kg3HHH$($P;#i=YydSYA*)_A;Ehd!gC>J7t3bEJ0ShP(!H|ispi!><xh=5lf1}^
zip}em=8|rgc&*}PyacNORtLc<!}@?#uDe#Bg`7jr3T)Of&Y2c2kdGU*;W%0mwaxTC
zITmwh_?ORU@7?`~FD$e}r2)If*CA;=H%+hx!(V+rpBi$77jRNvbz3in?g?Uk83S(s
zelf;=`ZU9E+nj}7p9Qf$Dw8#z$fP}<o3hbv%M9sjlOlv3d-^ftdF_DYc8|ec(d2M0
zheFvmDH;fPMc!ru1!TU|n;nNPvZ7w_qg$&lz^qHy8u3RCT;`YfDqiJttq>s73``wZ
z4u}kDyH_*MLay12cYGzk%<SZvgJKTneOT75hLt)r7F-zN&Gw4Lk0D7h6`C_;&A0*=
zrc;GLuzY*=%SCMO@>vZ%wnVg~jd~v<ZX`~}KrZrZ#l<Rsl_l7Wi^PSXC^c{SIS<of
zG3=dTF`{en<u9QNyR5W)?X};I9cBt*ov~gL7q1V1Jx#XJxm#<NMjT@MF3@xkFNK9c
zo7Ka;+vj1dVOw|+_GpXvpZiCk%I|4V>Q3A3j_dUOyI>_rka5I>&>qq49eGPYi;-Wo
zC;OZEj`9p$ec+YY#(Sti<<aoWK^l`InNs3j=&Hzb&k7jhWH_}@nQD=fT85qOK812@
z{A-KGWzsDFH6wI614m9zy4uwLw$1GO(h-@4(jeP;uPJ<fs57ui&DmEy24z-^2=_vt
zKq7x7u4hh*fqmEdb8D|Wwy2bauIFbEGZj6A@s2KMx-pa)#(3`2DqsOM=b514(x*O%
zJE8uaKZ`*E5S!&XfFl|Jf3@oH-$eXm#>f^~ZowMGt)zu6fNv3f0K^a?A+xxHiy}8|
zyru|jcH&HUbnOuoeWQ6U9>L+)Qo)wp0wynhO;85*p7z>S&3kF^Q^FBaeKg6)pP_qb
z6<lb}xCGBfL;xQQoWz5*Gh%HoU|B=$p~uJj<`#<$FX|+|hO^HEg2p~^!n|-~&1!En
z;2rRXcGi7Bm;~h@UBpHjrgF;blvg2Mri}MMVHhpBVxm$Gry{T?|EN*<<OduuZ6LJ-
zbg*&1p6iCZzfLayjiWzna>)&EkwDj6!+pr5YeL17Oh+SgJu`_U^7p-b@dO33<{szs
zq^UdT&c=t_=m95iNXS4X#C(UJb`kC1WX~apW8wc^51tbkdeL{g_>!-Bk2dWyjPT1e
z?SPX<B@B3g(cklhEppQY93a}fdoD<P$w#JRf-yRsHCksn@<*n70-)fVY2TV?y@#f&
z)toi7j@H?;|3!&YQ4Xtcv>10`QtQmW(hw1zXF*-7qZrrmZnn9;G73p=6*;yIsBh|$
z#*Fn!v6V6NbE3^sxiis48`(Nkr$Iv$CRupyi%I|@%N`uBf1HrlrAR{CP*pup{{0gn
z_Ftp;5aXX@q#&O$YQvN=p72W7*q^^fZi3(`b*wl|4OfZl9c3Vc?|1M{n)=_;ilW=H
z86xwl2r+!hqT|i%XV{a;Xad$*!{vcPdWQu@o<C-Tw=vDTBOjyow?+raPrni4`UNMu
z_ohpIMF<V{KIwYoR;6%Iu8>m;Zg44y6O^u$<Vqfobi3L@xeDSz-p*M`jtmEn@YqNG
zA15LJ^!7VV7!fQ4Rn5kxs+hn%<f%)A`8!+zwIa$pV?Z}A@P@T4X_ym1D8`Qe>nEzh
zEtjnO%`Px+QIWdS)x?0JL(AYJ`&zhqR#C}>4UmGUVi-m{6sY!)9Y_6~<{>RnK&fhb
z4>td`e_bxV3E<#y{Nz2TmHF3eV8`my-+A6%ZZ1)!X8<qnx&XuoDdNDGpu!cNtxdun
zRqIvL(<rzEZ}nps3tyE(qvFc@z>d_F+gkKQ9dqtymqo2!<0@G57uO<Y!+pkVCD|TW
zwqJK|N{a_N?e3TSURMqQl;K{Ap5S#nM8u%yA5?cM%2P<3?FjFFEQ~Ji3F4gu(&pEd
zQoP;8WACl*70!y$qD*$!q;49JSt+sM8;eJ8jr^f>Wd_fcCWZ9@Vs;}q)AHq_Sv<@P
z@Jg<trkfFm7kYVJ`C;|L4I}~X>vRgMt!Z5}4UG3Qv{SxOI_r`s9K%v|^%aWh=2S#&
z0Cq@DRYV;En%mvzd{sLVZ5cxGA?_jiS>Y)Gfi!n$-mT?N_v)Gx=(wrz_lqV(F<m?U
zUtX~nIT{hyHF}jxBt=bP!IFo<y?08*wY-VeI;nm#yZ^hG+Ar_j1{l>*vBC+O?qxxf
zK>Fe^z+b{BBnWMN1*9E08mo2+XGucA%Kzasfwo=dr+G5@HV2U*9RD?q*fg2O{)l3V
zM%YP`d90r&IH!3$0O#T*%u{L<Y3`8ubRTw{96ELN_CzHzm+~5h>hnZE_q=0i<sChN
zn$fiD_}RgC7#@=vx1^5&se28_GP!K9RMo$lYiGJ;nBsFV%Xe(*sj}~DRb&fqacPK_
z$h2c9mD|2{AB?OX<fUZ1wa!`-4A`@hTz-1LT!eeJv~fx8Oik(}T4tV_7@Iaws#MEm
z0#$H(vt2HD*Q-a$2_RW8(R5+Z+QWmY2AuKN77PtB8HuZFk&GYC){j0}&sH;BQ;=KF
z&+=xKs#QDOHV1}ZB0o!->^X!fP@8cDE*GXJTWfLZN1;=DPg<!$&;<-Nn}I|X@L}L8
znXhp<iNm2UC$wZixu#v?rSD-Iv8MeQaFW+dY~C^rcF+&?$>dcvNSC+5WJ$-TG$LF_
z7RA;DI0!(v@S|@>YmkQdsckpe30N3qXU~FH#}e|Z3~e~g;M1T(r|m>2>w<Oo!Ekz*
zVD(EyBm7O7ql)G-5CxYV%Ygoiy2Du@&RsY}@5dRHXq&53-WXu9I0$COF$jM=wkFGV
z3Rl#$L1TED1|!?1Ii)=U299W#%xGqP`bz`aH%B2cO*XJ4Cj-L3L#d%pX1lEPvYI46
zBglHuVuKC91E~7MWH7ISjLNFTEt6!9HS9X{1@O6mjSIWoY3XrrTHoytM=Gcc`Z{dU
zd%r;@D+=sSt;8d}<a`5?w-0&ab8X;`xF_P}P6H==qvh&XdekUL^OoA90>F;d+lZ-(
z9f@Hk3>fLJon%W2XT7)k%v!gCceM4DXu~P*Zec|VxuipkhB~+=5G@_l5!MzAGp%F)
zQ#2J)prYjAoc%1??t0Cm6K`R5to?Gr#lFL4ypPSIi^$W7#0bKO1>g!<7$QwlPKN)u
z)ijQ@jP)|Z8Pl}7jrm8n`#B)EWf~9Cw#(7kjs4JKVm<2Kvu<P9vpR9X$a07$Y=xX7
z@ai2An?h(eE|>Pg^rzr52&1}tqjOk#L_EI2e4wmoqNOT!)P^G2{Ugy0o3E|QK}YVv
ze)=BDZTEEbu+<{Madrfy11ol~cferfim3MIkKu63!b|<W?p*)Bu#fR^zYEMIB0+_!
zgQnbCpo;z*Jp2WzAWu0VA}j%AR!j5QsM@-43L!y`jium@JJl23iYgbU<{XA#aIu1B
z&(M6zvOnNYZZFF>h-(k!gY(Jz-p!Wf$YLuUp|mQknLiugf~opm3HV4OLaiNvpo`|K
z5EVA_Ivn2{Yr(ellQ=MoqQ0n@bQ->~Hn5%JM(QojORu}{D{D%lX7?zp68@U)`McGv
z(F#h6o;gede7D4Vi@cV(p8DLezJ~B%)&3%2R&a%wbhYnmx6HjA9PAsCP8qj;)qk!j
zzV+@$oGxw9sRs9J(XKoupki0$jH4u-B2UTMLqX>Pa)3=8NL)S#7lh>c9Z?}ENp*X1
zC@mQUZ%ZOyc<jata)ZS$00m&Kx~@1BAxx+v&-UNS^*-PYkR|W|U`$pyP)lkH{(5v!
zG#Cv=b$7?%M(Mi)hj-CIdk@Ti{{<i2z@Yt@eG-T(#&K<=ZU%ZuDpIxd-F-Sdi<6P!
zlco**dps*3$X3qN@LG4>GHxKe=mBuKH?E^iL;tN>6iTl|*lu7}fF|s!4hdS9RPZDn
z1nv%Q=8wQ%R;JtCQ*m-nAnmuU1X|OdI;<(m)cH4%%(E&=J)vvdQRLI9FKyPhOzeAc
zO7Kmti10m3<X%%YUEV16Ul~oiWKVZ_<HU|ji4>rh1TOFfr2j(Yr$s@Z^?IK=Z~&oc
z<#+7_Bx#mCLMDEek^#SXZwZjDhD+K#%^!ucp>GyuwBU}diK{TD3c6J}f0T5WZu(dq
z!vhz8>ZU{~EBID8K{wih23E=>8fievB~*6GH<O_e&$N|yZ;_723MuPw%AJEN9aeW!
zxlq`-0XONm(rp@gxbYk1SF>B)Rq8=fNWyWHFGIezrxHiCFC;<h+~eK2bM|a^rNvCp
zBp-ZLC84PPS>O?7#%DBh*D+cvxTA&eF`@l^ATf$6#!b{;Qx?lo6kvi-!TuX2f%sJ-
z?HQNOme**1;iT7`w3b4{qxfE1aZZ;kajGST6Z>bTW``@+@M~3ov~^dRO!e_*T{bj-
z_Ah^cAJJ##<7;@{*$$&sayJ@#%~VFF@E=XLkQ$UEeRKEaXrtBrEFEciNdS*5LR>gr
zlEF{3v{x6aYG6xbg!Y~d?=prZJO%*10)@7W<9q_{L|Mx&Z%ULlVxcy|yPN&6=i_aq
z40J!-^5W!(!hI;D9#gCCO0&+T%~;E4r_w5VADD=X7#!y|7Ml`?(!A?c=_tW|^zOy!
z)~gsin%L~>W^r6&JcmF$#;B^>B97t1oDhRS!<C1@nOWd*hE&?4*zq@pdodA(M6DWP
zG~=$?>|!9&ur+EE<xx>li3<Mt)5Mv9?aZ*8|4(7GBjs$inRnVMn9n4g-Q03aUl2;@
zp9n}R(Yw+*TS?|%9R?rjBw5C%@Go%amQ(^$zq26pu}1s#k6}(6JH@`BZdR5syuboe
zsvGtW@T3=?sKpWW-E!{-lOpZ-WGdurCFoj|Z4^<MATG-S6UVmoAQWY!K>mJpkk1Qf
z#tsL%!rvrjqJ4JwT)m=kl}FW!`U1E(7;7@NnA_TDHIJ$rstP-s@{j!@p?d}^P%|F1
zs}ic$Fe#}d3Bt#)-uAXa%CN6{ETEWLha|hmfbYALk@wN8WJ@;)sbDv=Ia+a>&f=Qg
zBAx21jLk`M(DkL&L3*~x)#&z$I$ZYuQyWBcG&9uM=N7L|%{8@tyquq#cx|4gaxbZG
zzqnFZbbCt=9km~i3u5OQk-L@2SV=@+<Vhq`=zz@d4y4TAp=F1(GE!Q+$zzC`cE7W0
zYTuO+9!On@DOApao9-5Q`R0pIVnR}lP#bLm@x%NF+DUam6SPS`_R5irAfu}JyBbOk
zUv?MoYnth<alDo9TZkv@-DhtJ)$~u`5p&9A=41C&Sq2!EEyJ{?<+P|Iw2_r2CQg=n
z7*cz=?;ySwm6<-K?m30LhDoy!ZoR1gpx#y_ongZKAT*pOY3;U87z(=3SGXZ(Owv2$
z+WZ{WUPUa4c~c!PI+(8GZe#lfYENOLueh%1yL#8Lb`VzZXjJ~N1S5JEq2Rt>SYa&j
zcLV&$F?}ZlZHQYO1ha2U-D}mNpkd*CH?7yuTt7T5KSvtfuv?>{aV&xr1vc*NM<~}=
zusVLI_oIow8jmIeeQu@AQ?&~Q@hD9n92ofVOe`hJ(yUk@j^(S@EvH}F;0<CN*$lDf
zu?Zemzy|?9K-kQxV_re`1n388Ys^P-j`9Zdt9f;srkcmEnPD0)f}Czd!5n-0Xn6cq
z`T7VkPE&&cnPd%FH${j^IILG4$SMo=*aaJQ2GdG2TY-XIB+Tw>A%G59%Osl7#VFmr
zX=|S&s0cal|L4r<IJ0`iuT~J40TW)F*2P|sn)I0M=JeeKJ(weR4;W}}*sGq`#Atm{
z2s#Idkq$aps_usJakzmNP7_rr3t)DURguy3)Iu*2o8RvjTrCkOMC!f~*0~EL8A{Ey
z;0yGsdgV*&5(9;BP|elDZSZew>q_*nAz))Z{g)a2GWdupT>Lr0v1#aiJ$WO3{jvRl
zz8<K&2Z8i;xZ@Ox{;4cEl40xP-+F#|4_CU@nKW;KC)`aimVM*}>%WN`0S&Z%tdEhq
z%o2x1HKT&JOW+XmBx$w5)RRZpBP=ypky7aPqc90^gH`?g_95tj+I%}Xw&pwtfklsW
z*%*^k@-sec>@T%v^y0R5Kl*4|Gl^!e>P0E|-kRdKJf@5!wwJB~qh_J+Sm}@*VdePo
zH>H=+^;nzY3TP*;K@p3vM#37KLY{k$ll#KtDu2fnnNq~8exrRAO_UJTtNIXnE6sO5
ztnfUBy3dC#O_Bl2Dxp(tofg0-VD@6{gCCj<49;h%Hb5|XvG*ln3&{_IdQMD{*Nck8
z*R>^)UEEgxgD~0^d5(MsRD%0ItdLs6u@&Qbp#%W;Zz4r2Ib0=c81k3SwjnBU==OZ@
zF~s%=e|KVi3a`{^7?$|+M=9M2HQ@jD>p8<{8vx$q*r}D1%{BE}DJgbU)KZ090GS|x
zpJ_SwgPG9A$~QM|7!b%BIFFsDM$$<`Z5>9yDIT<82R?6Br%Uc^RLge+<)y%t0$m6W
zd5s8*zbbWARLUg+PCl52w*^dJS6;<(TES;V1Kknlw?fqa6z$Df6?SK$4n9G0><q#+
zO*Q#tm;6GXO#U&=95S)o@C9?*+5=>JgHKd5$e<0`eZI#X!_L@4&M969mCBJ;;ND`(
z08OyS$~hqfSIN<?hAtuge;59#z!;H^=3hvRW-f|Osk$2y=aKkyZVV^I7Fm^T_^XyM
z+fJ|ypqWMe-yP6KtAYl|M>`3slzv!aFqGdV$k}6*2)RziI{^BW+EtM|lDhKmkOAz^
zF>;g0ypPT=@tKfRWqU_t6m*BM40eY%?Kgt}mU1--;R*@=dRBwnxq;<da<h7U;4XP7
zs>{XA4H9MymtkUs=wLn^VEYlrwCFlbL8$+_Dejnj`4bJuL%ODi8W<Lb8yQshKA}2Z
z=!5q(gePgL?2Y16TwM>m&K5o2t9i=2_91h?6-a9ee!1;*1lvCJY1@dX_=$3;AM|xo
zwN-RoHK)$Z3GH*^+Grm7X#i8b&-6p8=N?XEl`O05a3%z|8-?#*qT@>21ys>WaAOz`
z-JiW#sH=N*H)h)unkp;znk6j*HA)5*R&j$&=+V^hMkJZu#Dq;xMqPZ9(KX~13M2N+
z=zmf-oW!WTJo3G)4qw&->pK(z=~K*MD3I*fg(!l}>cOqfKiPB5ZBPSY9_N^&jx)qN
zGi?Th#K&tKuqUTd_pC@k>PGcdGd+*>M{g&fu_&8x<h{rP-+kx|d-a!WBa5x8b~cHQ
zfF$G{3)Y;Et$~1kE);2W+hsl^>|%3-diN-Lt225h&*x9elR=Qwk7Sc4xgN2|t=Lii
zuSq(yF6i7@sZQ_eQG|<a^89;v%eQF8J+3CHvqT2--mJsr&X-)8(h!v?(8YnoIcEq)
z)ijxyRmSF2_zg?LD-pq$Lq!XxI?{PhSm=jIrN@u<g*>JXYq+ly|JW)v`nJc~>+@CE
z1^Q+@Y2X@Ae}f`>{%lDZ{2;x3)ezc-IPC7646Z~_&1ym<&8RIZpgvi%iyjH+a)#3=
zaCPy*2!~8WS7110I4?Q3pBg|VLHIN`8*3fmH%#CrqBxrG%k$w~8X+XYciJKiKv^x>
z%%|(>dR<X1;&%VBB*JtQw^jby(=tU@37{y=W?IuSHYZlK6f1Oxlx@~)_f3X)Z~%IG
zRWL(RRDaPA3%ze3Vu=`zSPwazvpL(uDUqg{3?_UZAW)OC>-7500N%9gh2k*rNcE9z
zs!j7aN#K%5ZoJHD6&(2MQ9*v2{|zC7csG;sNB1=DQ6NWGu;DkLst1!<O~_0A=ZWLX
z`o4Jv+I}r0`R@{&JP7wISbG80InZK~OjJKk)s6kmah`v8S5NhzDkU)hB#=`+TyXy0
zSDq{cZ7O!Sm*lNPskIKe@SrW34TG@xCSCS~eiA-Yp?ol{+U9g6OImlVGN1|QZv$ig
zA?%c1$UaQcy8Wp<qnCX!e@L|5A)~9_Mho{Ot@%xek3eh-Cb*hWdTA*mj;#^3fb~pQ
zU4Jn6HXAp8l~pkNuCUG&u%I&3&OGS2M$I6nahP7rk7MIL_7)QygE;kd>*qnPhe$55
z9E9^(5A4%;coP{NoLf21d>@A(n@!|ZuH{VjHlWv!3G5BzSB)ry=gA*K9LYsW*Hxc#
zFZfh=8uzgPn1h>7Qi4`EjOoe0v<a!88!HD6vMy*9P<<Rj=G2$i(pkPBNibl8Z!Mr_
z%%&{=#3+Hs4Msm!y-)nl0S=x(CR8mV#B#)irf+qbK3b(h>DL4&1cB~>a5*N_zDh&l
zF(jt1<$44pECfRtdBr}x?OWVc!_fNEyw23JJ)DvuytsyeTe|OXNIQLu+Tx!UlFSz?
zKj#lA)b2>mel_VR_0u_xq4Exs=K^@7p{{>&l2_yqUI&n0E4CtVTXPR*??(JRD=|*-
z1)M&^C!xefB4qeZ(izNCMx^0``M)YNJpRobX!tZ1eAzQ<$LJF;469MvcrI11xyvTG
zGB`Nf6w*A;b_u(rJ5U3mGxIgz+_QMLvqy%rOQmFJE)8St5(yxWQKpjacMzxmpljg(
zRRoZYutBr#YyQJzwF1QR`>UMs`HM~t!5*9A4ZjTLYxK?7Z&))Hh`G!{{N#>~uxZ;`
z+gPGA4Gxov`$-IkdAh@3vdSDz;STQAP;_oGNv0Ym)B&-6cTEp+94N(|f3wyLYUe<+
zsF2MZcE%qEeKl|OD?E=c+BG#xZCw5xRjz{06&`FeXFSZFFvU?xj6Op!hcsp1SkZ|O
zHC(T>gP$sKu}ZA=@Cz`<yj{8E8tKAT^;G`tm%ImgU>JKu>CH-HNeLgXe7={}V^J};
zh+5*UuIdNl{QwvY%V=iK!JP-WP|^7?2^g0oo@5+R(Ft9chNV6ibh{7H#YZyhj9O4!
zL00$>5{OR5yG@e{Re}Y#dkful0|L#U^}L>~XN>}2eBdA-{0yRXRvlYCN*4}1Mo9r8
zJ}Oeg094l7Lx-uwHayb2h*luI;$g^or&m3?%u!m@mSo05AputWusRUs(>@geR<yy3
z*4)(iM-7uM?UESr=~vCMxp2C_92Kl?9A42Ac(fT(4ufqtC+QGCZ6iywyfe@Si81D%
zu*`iPF$M2}3yEijR?woYC6=KBp%pX{2(Qz;^3e~V3Z-&85Dsfnz5Y!4iH4~l`I3R<
zrNpk0lu5&C#T4ChWG;@X*07k#Z3SG1yBU_$j35wl{m#kJEJa0@-cw3ap?%}ShCne3
zK^*&%5*?SPB^0*dC^^Z481@4DH(SmRu^KDU?-v{++#{;EFeCy2h{z2S1TMZjH}Ua5
zWosOdIA1xHI5fiCd)PU+SA=cGV(X82h48u!%3?gywS+DJQO>Z9DQ^jLvQpsB>8W!W
zGa|SInEoG>r{O#}#Rm6V=3lJmps;*q#|c}0eXG~nZz#YKnQ{``J{++Ox`dbQij=T3
z@}E})UvGq88cuS!etpoyfDxjMJ~pELW|%HAbTc%P>^S;d6u<=}%}J_VB(%E+f%{92
zi{XmGldlkp2YSkaNOFM=aK}wOyY61V*-)L)(Yq+ynIYe;y(fDzYkg{V2vi6#CaJi~
zkjh_&uZ?~^2UxOZjEOTF^A3W+@Gx<6DE6(FdrlJfRISkd>TbR;bp&te!d6J>B0_o-
zx@QU@Uuwt<(4|}#V^9a2^XKZroR5}Rx>E>8!hk}F8A|VY#ThkSRG<aV`Lb(yXv%tf
zt2x`gZu-)KFX!LTH=;=L0Hs9Lkg3J_57b}G3{oH?FClpWnR|yk`b^zk;lh87t-PQ;
zkQmUr_`gyA!Uqj7t1K*!3TSy_9nE$zj1yrAV~|LzW0k6AxLfp}(3K8t%0IeFKb@g<
zhR`|sz8~vTRk6Gy@othx`sLp!u~Ap3%usZ)t_oM{3>ks7{NO%ny62Lkk>N49*aEOC
zeb|+w-8!Q%WEkz0R7Gp?4T6o$q`G9JKd-ly%-1Ox*qtZm{&`HIwl1o=P~pI|mGzb(
z)4U#+&c_^T&tC1oDA3${54w9!d^zBxh1US+ZwjoJ&iml)lO<iQRg#-7tlAm$fLlE<
z6!Z(e`4Gg*zvs+zJQYW7yVqT%<ttYbgg4&dXE^3?7fVs(x@I{tp#OX+seJoNA`lK*
zaD9}c$u^yjFmowGu}-;Lq_i_(Wf*{@9pDHw@^P=zAa)jbBtCL~8M_H`q`tK}v)oEN
zvgh1vA)OdItq@mV6AV-T`E_-OCFiF*`E5BQQz@pxfIU8z#JWO9e1{Wc+$r#eYZN^@
z84ZMQAB!Zmfy@(VWS-l;(B;0w7=-^@o8~VmWoqzp@(BZ1Vv86s6Ew{i{4bHrlrQye
zL1(UR1bP1dsenmegETezk4wvNZ5+A)^4T{;**fm)qt~w?D-h(4EU<p1&pjuk40dF1
z9gq6m(@axw^r=@K0c&vO)8K|ta?<xSjF7h8bU&4P9#x|9X|8&Mhm>o+WUIfG$%r7P
zjXH3`jJUwX=)BRen9F=jt54XmI-Y7|2ItuYGpP1vqi}(x1B7QlP@pp#Qaf7{;>Tm`
z?iTjv14(bNEgeFjzYJC$a=YQTdwF23aWSD>#5jv`*+)Lr(T3n2OMQQs^hBrjM;(sT
z4w|US82*R6-e=!}+9w~trWYDp15uW(fCDgoNt9C(Ld+5(F!UBB_FruIzquVab8|a}
z<j0k$dlACDa7jaKYqwP-bQ)?%kZ<_6%K*!vvDX(V@+a=oWvJ-Mla6XlunDxP<XgN*
zSpkhdVkth(arlMDPsLT+Rs-mSi~tryOzj?Di#w_Bls_Cgh^_L!7-Sb?=4Dh5j^$R+
zV&wwobDU3i7a@lSye@mNm4~c=24v(8k1eYNq*em6FuT}FY=~Lgh@k64$Y10k)V!ox
zBe%&Uv9k!+&me^!pFZO6d7HyB<eu`JN#p{-8w0oR+=xY!qy^MY-mT`LMLe5kudr7g
z(BZlvny^aBsnV8_1uy*3G!mqo62&TMNv4rxuI#Z&;R}rt+B|_-Az8yl(L;u@pMbk>
zO!-CtR(BLsEBlC0+oo4eH<E+u%-u-0D6c-*sxjiwz~klz@m6o9eRBjCL~tv(t<S!L
zpkm&X_uNSE`n#0imuRA8oVZcd3AJFZ)HQ2Edja(8&6jYSkzQB56c_R8SwEd3pV<Lu
zl1|m66WzfKgHfI*ThTCOx0*CvYPhbX21e_W*%iD`+ubC%d=(ho*xaFX2HYP$@;Sh<
zYbekaM}?ky0Nsl@PF>4a+v|HKX!WwYK<S-lJu>cPZdrO;vwBLtMw%YHN}#13(HJ=9
zg6c50{f<-|$b3<1om{FW*!bWj1~x^!{*bDG#DH&E_&Hw+<e?qfHG}>d2<r8pJhR;V
zP5Ef%?~Gm1N3g!GVa%WgW-`L<oL!sPAnsOT1yLh}7~xGTMd|>p6{u)W=*}{2{R<;x
z9h1S-2lnhwXXp3+Lsj>qAmN%_Uxt%dS4UgP_Mw1fQbg6nmhsRzH|QFQnc@SK+-bqd
z1)oatvX;<0ddduPcDw3_`1X7-CkB58VMj077-%tro5gi+KcW61I6Q+e)hp9!u>Mo+
zB`%NZORR>CA8amXUGCEW-L+KA-uBea*3UkdDm>@~o?NX}YOz|X+)oH#E1}0FNx_P1
z({~{HagIH87#7-b6$qnlf^o;ue6=p=Z)`=l(XU*i&a-}LA^!OfMK7h}<1)FryWN+j
z*pO@A6E2uR(nTKhO-@_ctSfLuvu(<w>d^z__c(8a1tMMAlwnXDO1be_X&sbNoK2kI
zJi<UP)V)V-80H+C?R>Q}Jvv?cm&PM4;#(*YT1+lpE9h4GgiM-DL6aTStx$@rUUiRv
zwLar)mP1wrsQ+z|Z&qHn;Mbe%^xfCEEVUO*DQ5<wFjI27uK~Cp#bpF%BMXjhCouGd
zlUj}GRpS8%T|xq`n#C}>zC^<Ie{y!m(VbE}66_~vNqeT}H)Sl&LwDnPR0)5G+~r6l
z$y!!+k!8{GR-)0v9d8PXFGHkU0kS5BpUU5xIM8HRRhvR#?hHRSZ*ec*Rxzh_u*$9(
z!#HmX2>8~bb+)1SpGC<b?W@a}^G>h{pXyhMVxeVtx$_kzia@d?$%(#RR?)-SRX@}4
zZ{$qKsRz|hd!<%6lroc2P3n8$Brf(RL|n|wr2QHr&tmzM+hHFQ^=KbY(d$gaf8w{@
z8=To}YT50OK)g6=F6doukX#u*{ne<&g4r4I7P<l<wzSo!-2TwlSz9O0+nNY+X<_u#
zsHbXiLnPWOosR%OPIkJON529OJRz2$|0R9M7k1k@)_Jl3&`~Xwwug__QJ==YV}tO+
zFffr-w)lXM8Z=5yGH+j#h(rw(5cKLdPEpAO?$k~Yod&KmIkv{7TY<<!Y0KX-pM{CA
z1>OzR=-t7NHX#a%QAHIWvxN0{!^SsE?N<ZJe)ow^`=A0gM0=0I2@Ld$G(DGxg3uAp
z{nwLjCkMMGuwGByXZeqSU{Jok*^q!BX&ehUMGWy?DktfCzp<M<5NodvGhyd5>By`B
z)`Cdf%y19@Jh}FB>ecj7rhg8{0=~kCsmbkuoZ)P(jA<oJa$oc?>R{Q5e{Iv#hl=ut
zyRCRLw@~nw<3UZ0Auyd#6=$JKRf$_2YQ^Q?`wy)gS?-#Sx{l^BmENdozRZnY3k9>g
zKkpDO7~|%kLT4u9-VK<{(!{0Jp_v)6;reV;Jt7kFspd8nVHxw&J(vYkFkAH3J@{&N
z4;fUOvu?io^aI8H3NT^+Cy2^y;OMt1Qty=2*F83oAg&5*#)RJZ!vYYXzIaGGsNj#J
zJFLzPBX3?rW%d-Cz|lYv_I2#OhDrGrcW+R@EC!L(e|o%;HJc6`FEK{yvqu6HnOdxv
zSZ_|E9IuIQ4xdDj<40bpVkjlWj75@?2M0%jK$JmMYFazq+jU!zP-B2$zRS>?5D3s2
zzxdotAjEobyw(siJ%$8cORHq1+$KLgauHO)QS=hqOk30*rRs==(@CC6hmaSN%WJ$h
zU`V+k)pzc%_QvqiyTYEeX|7F2?M9fv?pUL4k|DP?CxplYek&uC4-j0%yM2uG_9)s{
zV@;qc3%1Xzoqx38MUA2NWjaylX!w}Fv9N;bXU8x4dU*0moH2}HZ(Kj^0JG$s%Me#2
zX_a)~z;CIl(cwBuI&}vsF5~8a3~CH=&%{CLjfiRuPKJmLd?9Kg!afd=K25;P!kPHT
z2+b?^lE6E<zWh|d_+4@3(^_%ef7@%h0-=VI7aMad#SkTrp}~B_cvVSDHSDJtF<D&c
zRUVlwkf4v;O_K3kLTqZ}5n(+sa&t$5uSm*z*Rtx)Fknp|7s;0{hsp9G-Jc&BYEIo}
z>e~Gp#6n&R7weRYyb5_Z`hkt0mY@k{_86o(5jbnOcdJRDD9LgQ2f;V*q&DDaP_gbx
zsL2D&43veZQKeR&>ef2cdfsVmeu9aY+C{+L2A;kn{hL8?oCz4nS2uPN?vr8jWW1C9
zk#0eUUIfW<;_v~Hy^dx|-<cZ9!>+h<$2*uz;?!EA%X8``F&CND1@TD&7L-QARwo!#
z@Vi2LNSb@S5<f|{lvbwodn9jOFZ<3HPROwYzvB21%2&cEq8aT!V;<9U#G}8H>HySB
z1O6H-socuNFVAL5`t|PEx@KU&`&ghudVYc1U1J87&l@Kw^dE60I;CNw0_lDmlB6@l
zzZ6znguxVrxODAx))Om%2Uq)>mq5Czy}Nd3?_S|!leq1xHQ{gXqz%lZz)tg$WM$j)
z$XbaNJW-+`uH7sBWgr&=WdDPdBj=r(<t74n8sZ+<iemL_jQb77`6lXlwWV~}XbhsR
z&X^qrw2nxz?Rz>Bg1%w2SqU%IPAjo)tUO76$ePey@O?>YU_qn8!X4o1b4+Y7T?DI<
z`PXm8=4{V{z_h%`L)i+nV~M5MO9lIq9UWbe_<k#gf!4hhMwik_$ZU|NprM6JQ-bNJ
z6Uua=av1d#vfXRg<7T*!Mc(`7g3M6FdpLOU(5Yz;j+L%nN9l`~`vwzczye5+T@JDk
ztvz`^?=;5Y)0&cS%&Z1i#s@D@MKhPL{Y`A5r8(5W9&zCnYqPv=`dFiW^vBQki1wNU
z7cFjEn+(o>`oEz<cIvz?4`*GzTicgGIK|*7SO%x%AXF{<{8e25Yh?0DB5kJ?_<o&5
z6mXdHQ`*70C|}Dw#mR_0(|8l)eZlCg#?~m%*v^aF(zJ-hC-r5>VsC41s1dsCsutgA
zaI{p?aQGyMvJ1y5-$tojCFxVjEY(VV0c?pw8b}-M-0+bA9I!E;vvLF;7%T#umbG|;
z2|%LBqaFdDj%})e+!7s^5CGnjkZSW))HOj%DxdG;%M7ob+0TIfKnH6(OP|Q&e30b}
zB;%wt_5%66pE!*D{%@(_y|D;cI=q#~)<ArhIELa}yqC(cl5dh%avQi<&r^(Pd%g{H
zrY)2H>6E@y;IF}!O}nFLF%F+iqi4JSyDd~SrrOX&vx<`#xAQxDf2Q%XxB+rn7;6;^
zUF458s>Hc<NFdWf1;~48M-NKM6NgD6pd0%xy3vZ-VacIDS&d~07s{_q?I?jD2BtH6
z@Q5G+Cu}V>rGIZQ<Q=hRN@|G?M9a<b)N`{;J&AO5Dx6*{Qql-ui0?kOtSfhZl(Ua^
z@<#>m8IAhFnO(2`8|xqR8oLW+I&Cmp@<?>_^qoN%(v_=woeAYL@r%^Kby;aBoT<&h
z=gUnJX7ZVSnD|J>cIS`#^eq7plxi?{L0ERGpmOw29f&%DkBk6B)y1?!t3db;;d>07
ze8blHkfN8X89HnRoC2`n=gjQq%8q{r<u9Ux^jg#fp?GY9E2b|pMXC||v7<`*%0>^p
z)@+ot3IbCH>3P`Cjdz*D@V9&QXh7Kk2C7Ugt!!2wpqE=5=_~**K+wNyq~9;QWSjz%
zq_mM}mCLk+C6R5Hk>cuyRHETZZL8_Hla|eHvwluqz5@?Pu1>+oSW`(q@Pd11<7-H;
z78pZqn6L+Itsx`0F8QP!E$&Yad5Qr1$lqY36Z?QMs=G)?56z!!+Mz(47UKr^pk+C^
zbZ^nebB}2P(%A0WH7ac3<q8*R*B=uw;mvf!NS!oZ59s6w(IQIlgjN%=rnp<czIy{>
zw?hTHP@|`TYvLXcrj+esfrZT0+wzkSX(lrNvN|04zvXg7v!N>)AdCJiw-A6c#?b$#
zNpD59iJaMBzLT+r$^TDqRwW{0o_+%td|FTh6gj|l@!#Q|CBVj)D1`8$F$TH?H;h`#
zV+zeivle1P&X{X=F3;qXWHm~@r#k=G^#cQ&6FY;>^SzL3fij}D_e9kET~p6cC8x!-
zJcg~}ea>DrWWEnDwxh9P?kh6;k>lMAjXP&d)cAaih<ycyR$<1ipgtsohRm*kkv@=x
zu)iUbXsJoo1KQcJL9;+|x7-z<*OUX|>QwoV$Fs-g4qN9f&NM9g7J#RpS+4;IJeq52
zgtyRaP@3w^Sm-Zt-RR1}bqun8KaT@L7Itwbrg7qbV{hTsKXh?RLnZl=fe1c0=@BUo
z9~@oS!(Td?b<xaYt39eKi#4vs03dF+)A89^dt6fWlVg+LAuEi`_x6c{GiTdbr|Z<1
zCb~Gc3RjHKYp1*WI8f_a<#nCQLx5Q&Z~rll9j?>!chDpz8FfDJyq)I2L-x7-Uo?J?
zY?~I3e|qHUZ`**@Q_$d`&^6vH1Rdnx3t)xd?T+hag^6VEa$;ssAyG_*Q;>mDwOwQg
zw+b64kQ&k^F=-(lF}k^0W$DQqI~t0dT=pOh|LYHi`qs_k`hL-}tIAXNNDdR!xi_$%
z`<9-Nb+YtF6H+1Omf<_obV|jgjN<6n0FE7?bLA`f?sqZjk{_PMXdXPsxZuvk?RNDE
z@t|!$2(X05JK{}Bvw+W(<p4NSo7LJ0%WL@O)xPtX#wa)TXZbT}=vA^`%JSKu-AX}(
z3=gsvA!$*K>meIs(7BQHY-f#4$%2iNS5h8Y);iV`Of2@sOgtw~w1}^x^dbs~-WQX^
zgn6ncUb^{HWZ#uBzOi{qI3)c-FFLZ@X9WH7IVS~sQtrBUL`}i)KU2AdDik;>qE~`-
z4?wkg4DPp##twPk)q1G~;_8mvx?R?HbTu!P0TK~iXmG}@%tCzmXYgX?L=Z=M9NL!?
z{OVz3dZ6tO0JTshg`eyS&G}Fd`@52hoE6RbXWtvwBR;v*TVRx({#+DgW9nR^aZnT)
zki$btBm<^q%VY#acJsgQap~b6B$Qd~m?y5&{x%+g8cBZ@hWoj%mXX37&vv}TkJ<0A
zM$;Fp)q%u*Xd~m?!yHq|%zausbv&wr&#Mh|QcE&4c}@ADv9{rrOyI2@*ao*^c&H%*
zy+VYRPz=2rlIz;Q=eJ<SDI+?Lhn=n*nC&=A%bz`Mcv&^@ie3+%T7rkRIcndu67}5|
z;z>qZBRg>;s+%us#IGs#kVkrVs%xa#6#yB#y;hE;zP=sYcCC4n$3sme@!*OhrpLD7
zSo%BmRfniYt7^B%t8iyYYd6ns%(?9#<5045mTH_+$R~!-Lj#{$HbzovKtgRYJljbR
z4@nuA0x{C4O!LjEyMWw~{V4B89^#svJ09WO-gntoVwAwPZiP94?P1=uYfe&v8S+J^
zJ~fwlyL7D0N65N^alt(Si!;h~*huUJ?2;}}Ai0l{f7WY!Vf%ZZBXAv{UTQos&Yv-w
ziSl%mO-1&z(aY4}X8z^VSow%+)&e5A)7wxhtgVI`CDWGn;AU;iF=-Z5Wr@lA;(`!o
z8i87Byf{qQ@)dz=SoVJI|2MN;sL8&FOA=*FL|a65LY+t5015kB+wgs3M#7NNw3pie
zZr`{1OvLV8f6bHGi2Ohjn@ULx5og}MR0r`k)WlF0V_K3x$(d_6mXX0-o)dda)aj)1
z*L?FTonM<yW}5Qmsc@90vn$?>FJe}MkKcS$jyA$RCjX{&V^x8va%#RYy9gCVFN8IN
zzdm*J)b%3DLFRjHVV)i6eYjDH##L9(5D3%JlKSCn|8}7II0|8UBU#K0tK<qcu`?t)
zyO1ThU6}ZN)tlY}WHj+MBba)wvW9&w-b>-CgTdhO7L%kw)3XaQ!P<eYAJd{oI30EH
zp)0g9B$X@b?k&DdEi_?!fd)vyyG~(Bd|pRR%3b(YUpEUox^2tlaW_}Z=9!G918-KZ
zTOlOaqdsFNe;Ih5v`>v0HVrP-(a4)Kt_8e1ahGC0OSWY3%K)Ah1w{K4g?7$0hS4z(
z8F~eof6E!@2-{c1X6Dx2W9u0bkNkahLAmIr0z_09A)J?I^s|+i8*Jl%{Ms?5+^ld{
z4UhMmu7GWI#g+N?YRh;}!b|KW|0|)109NYLGRg&N{)ZG^sD`SK3kE=VHcU#}I{tsG
z@{kFCO6N3mwAyE4l;sY3<`;_5a^B||5<Fw-O|;96_0FjxI1TKvjItLWUppo*=A!>P
zZ=`fhsnrFw`GbEORqO|NL=`MlU-AN|`Vm+Tm}pt31IxtzKNq|e)}M*zpIO>(e8Ub{
zj4Tj^5h(?9O3*mkxeq@MlT+wDd_M@v7cYhTx9M2=-)e(c{7EW-QZd9?MPyH5T%gRU
z;fwhqG$M%>@vk`{tAbs$Zwrnlfa}NkVu_GU<n1|2x5NARnX|E~TQT5sw!kzJ_Y;&3
zYDhqlL~oZ7*4e?y4eJxf3z&L4r8qAnBTJYG(c`u16BNE4(~wgJ)P&Sbv7V8}A8OXW
zDkJS-dAK7U$pc|PT|s}W%z^S%xE32pfF8w&aT}rVfW@2XcD)6lB4?jV^w<=BXEzOd
zuq+}vc2b_sgONe!JxkV8euYDDclIntqizwRGSQ1#fVx7LaXp(}mm6;rmepgF)CS*#
z6J?ySVc2ArpGX;27=XlyM;3p)rw<kNcz%F2L8u(%H`9#G8ADBH(=LUfRzJo+DZhlI
z4<3)$0LZd28m%ZxzC!{>H<rE3W@)^(64A8Jl!`B#OA4mNP-_<MX@I^MOY7L_ZkX~4
z7+DL7y8Uv?yVSg`$Pm?P^7kk=KE6PN<rQ5s<~bfANP}uyNB;rYhivlVlTd*2>?w<(
z|6px7OeK!O!VH9=v(>grY?QU0WP}3uHYyFxsNm=vmz7vrU4*^$y7BGH?4SJsILvv^
zmwmJTkMz<ix(M>1h)TVsqj~C(c#taF>&q5}RxtpxV<NoKI@K5{<5}KON(PyBnzU<6
zX`ws+04r>m1QQTN@o<HzrjjSXqU6bG#|CQBlkl_%Cg9jQS8pOut|P9nT?lXm*3(rA
z<PY^7c5%0w;P3{2DVd)0io({hMu6IhR(0Te`sF$ZZ;61_)!_~gx&xNF2E06g9Le!h
zXUu>&_b0#c9JtvQrBJU^r?A%6jyvyK+V+|7%s)fKWnpVewBLcvyz`T4s=<S;*KZgZ
z$d8N7#>;LojMfFc(JrVvg)|?@QS5~WjpGJxgarG}>$(L~jt;-O2x7n2SC=vNACpA%
zviZK9mj6=ZMsth(;qEUHD9Yh?Z+qD-eGe?6W3?SZk8j)#hTced2#BAR`j=^+@h)pd
z&li;=ul{y?=??I1Htjk&rf#bpCI({(O#v^jyqlz(^Qoe77fT_PawV1#Lyx^k<&OQ^
zkM+UR3_oMz(b5~K`~js^Qoi?T3;}|WDcsPw&c!a!DX40kHmD7lUpd^mZLI<pp`oD&
zY5!(k)uU*Ng9v6Zy(xz131=OeeBc&+?t~9ILKR(QBe(~N>NYE*xyb3sY#BqGtj7+i
z3ojM0`5haf+J77@mlV$$h^%$B!ZFN2^ga_!^^j-WLZDjM*X2hByFf2NFsM>zm`;;n
z<$s*WLqdW`4G6&v+?y#7>o@0etCy_ThaBLpUK}&FSr<eU@zr3+eH(rI1)6{atIM`Q
z#KH>KbH0UsE5ogS?mVK;HkSZsAn;F;NO+~w&hk$jUoV%OSyz=R@X>mrS3p$0Q^Gt?
z|H{7r6f8wx_2Q<8U2H3eps59c4lDw`WS=bPY|HMj2dZOT@V5Jbi&Udla$}1<J8GT#
zOILPjrb@lZHM28!lCcn0(&pT7c8r9dHZKT~2RJfP<Tm0lo<<ycfk{@GqB%l#VN=B*
zQC2R6$zk;}29)r>4FDS7O|NtZ=+$PXW%cWxCdm$I@X3&2f}h$_&?HAIH;yoTG66C*
z*NxvIgyhmva_nR&=Wb3EsX<k-L*7bBsAClwmsbH|3TE0E8u*}IEEpyg0KAhmFg@Fy
zQ*B>s1;qzH$CE5NfId7Sf@5V=z|O7+$kOZ8veu|2zw#mWD^=hHqhWiHIk&)=2&%+e
z2O%-fv5f5Ai!}>{I0-IsStA*!RYWrP^97w13OzRBZPq3cIGunW9ylU^hw=Asn_eOe
zmZr|Q$XXiSlEXn=G@R+AHhXOd%o>1(dP|4{M~;&v<=b{7a?Uc_2cdE*hujdkTF2cX
zHq`$N{k=VP<Sv{5)4>rX?P{zjb=Rk6{eZ0beqGG)fCFi{N|_mRcXPrUZ_4Ogq|T0X
z3J6cc^hclntRf#acgg;#FL}BGBI5ZA==?YPcv!0G?mI7oE&2098zCQ@i9@o~+Z8IO
zE@=BbM=45+8DbO%Mu@BE<=sf9<%vPy-^0o`e`LZ!H-KNB=S6GZ`VR~12(&%Im!w?_
z2Og7?MKRM@h|aiH&MmdZ=V@osS3#C3R{`G%!oFaJLA(H3je5gF7Mr0?o3!i=)p7hS
zZ^Q%T^qAcY1Eo}kQLl0D$81Df9V=%z>zjwfg944uqioP!q+r}y8$#ZFE8432jzdrb
z!ELd=t;c}ezEs*r7L2!-=n>^({Xi(n`_q3o?`J?AnQ58NN5h1}26>Oh3CuZwD{a%l
zNs+(w7BVbkX6Fg<@MXSa+~xwBMaNn;iGNU$vt8-IdZ}HqYXcBd?=?I;m@>?gVuozv
z2^dU00s|~j3sDkZzxutsP&-oYo&_)}tlXYn#Y48`Al`$2Cb#oAb#tDBJ1&Uq6Q)Wn
z+uf%X*&s^TYSq>7e}2x8`ldKxJd7*v>PmQlP6}yPVD&Cc2)gpvKy?{md^G=?StWg-
zQ##2dg14U?N6S7V=*10ESJVASD3XW!Empcn%&nD*RiA-QnWW*dN}daC6*;HF;*b$k
zTB{Z&jl*zEJj0~Uern2x$1=815M5nX&V)@+W;+ZP7Zs!-YBlJ9W{}*B53oNEeneK~
z^uIv8VDRvLrcv{`hWqk%%+nn)xlK<|zr->AF3zCut%igw76}xoXd*K>_1Wg17$-f4
zEc6xuCnuWl|I+njcFcFP86yvnd>K8g13sKT2AVMpQ=LYBK)KRtfGH52>)X`0O3$Pt
zHGHDU(p!P<o|WZ?{|P_eh(7)RuOUUF8#B4jSaklLQsA)d;K}DNjcG6xH_~C`gW;>6
zVQBKr{E4qx>lWIm)%u|3jI2*F3~DHKfQ8%Sok9jr-MqGkzLt-V(-6Wyx20GPy@)%$
zpTKwrXHp|)gcn``s1#v)1SL4A?dUjE+WwU<07t)FYe$Cn9ib+pi&<jjqFdV{9++}@
z?dktO-z{WO4OMuhHCAKL(vGps@0kur0YI!Eux+(5&J51DR&I}fi=D2AMYWaQXIbkf
zy&|ZJ)!rBl-g?DoVZQ%g1Cuqn2uaRCZA-25y2x~HQrQ2BMnFY<_?Q>jZ0I@MHFB^R
zNqwO`7;V~>EHBEc+m;&OJV3hr8U7F!`Ff~sxWy|e9iVV1tAOEux}mWJ+++k5)7oOW
z6<G<OSty^=Tj-5!I$Z|?!8hja@r?vro%q&{Q-i(r_{Bjn(Sy_d91$YBiL9CmbO5D8
zpF|w>>e!Ebz;|SY(gZb^-u2m{4>`~*eY;s7zvQ>oVq<APlSXN&#EW3Uk`11{Wx4DG
zu};<>oEQ&;c?UDCks^=2(=AN2703nK>6L2;szHG?D*1#`v>paCSwZ%2q3h*ot`aYt
z^X40h5n4GDfUs~nXuS9leS27j7l2Y=MJur+dD$L>uBn)gX9@<7ZdK-oG9%nOL=ov)
z^FW!<LS&(RDT+5Lz2+%R;4-YH7&_FgYVF|28oqZ=i?7|Yq=XSxuEuXvH5=b)X31Gq
z0}Uk9)N#q%)AD7P_1e(TswZEqqxAbstbzl8iwCIhLcur|E(!>yB*S{qli9a@td3EV
z6}-RpaUO|4&A){uQ_1ai3h-)g<l^PPe1r@>H1e{{>iUJL=UJeVEj&^P`iYg6+cU;u
zz~Q&;>S~sr`!#P_;{ot8GcP-cS|1$j;X&(VVTz+6#EAH}I2h*TK~v(r)M3?Gxc1I4
z@zP!m+%R!aEh(QCODX}Yo472L|I|57ssc-vnoZYk{$(^l85T&<2!PaK&5k&p+oBiE
zoQ^C_QOMarm)J(9`-DG8Xz$f}bLZxg(y48G_1L6oLt<@3e-|>xKtpZti@^~Mx8~VA
z-k_#)aLN#<$)=VHx^dHq;W`$Tq@?@A5V-z1?YC3d`v^FJmD0$tvt1rfX%1|qEl<H%
z)Q&F)(d;DmMG#9Fe%*7@q*u0jyEs4b&!7=*wnNTHVNM|3?9y$PYu_EFG!)zYu4SN%
zs>JHwUegl5BStV1hm|4{nHn2{+j%5d(P|-TYa2g-*Kbc%|GK}YGAoHMjH(^j!?S07
z)g>X##@L_{Z)c%ErizM_@d7PC5sJiGh4$k{VN`Oj0sI4mNHwhXrX+3hVj$X(bqTtR
z6B3e<Up^|b4z`(oc2)H+&?ecYk~ugx`jzMn>ZW60N>m8DXU0JwP>|+2QY_pdG3i3_
zlb4nTq0aq@%$mL}gfi+G9H?hmFlaLCs~vQ!Q2(n;kE9W}{~in1(X97?#2%6IINbo;
zc=(m5vRvWn1oVmRcan&IoNPN^@<A9mqg^EMvUo@3Gm%ggIN0?=rH%uqNUT<|&5(ZB
z%HslmY>=s)yojvTOUYhO+5=Aj1Y>`a`P#?G?uhh|l8vHWv}mCN3)FMS7l>%>Ide4_
zG7)pEJvsBG@5_ZPC}e?*zn^|>qneX4C-@M$%&>P*t5yC-Ies${>t?@3PpgowR1H*_
zv2f08qa?Tny-9wnHF?LI_?9=KJ2KsbbzbKZhXsRRb;tkK<Jp)kPomUJXnZJm!%rit
zV<K<C<~m1q+SCxv&7$g*r}6;8E{4`Q2lK}?8kuIazHJ=Yq(6roi=_Cc0fK+5F}Ony
zPMCu}D0ZY|imsq4x<-W=>YNGyobYeKI5i0g0w(MFy;(l4hY7MM%i_DJ>9d=~PU}V7
z<&&5pCDHcW{Yp&T@v+=2?4*CGSFB2~t?B@{0vjL^W`&B&5q6lj@9G#UvX_kR^q6NH
zMg&%!DIri$GWI>*&L$W-OqYA|DbS}iMV=?q?`b)Xe{pPK)7iY!WJ6{-1@#tf=_d>v
z(wTtDAc?iXZyZEK&%sXN1A9>3abJPg1pTq?QcU+!G}!O7@yBw(x*3BaBT!oY@`7)p
z=xvz=Q1`bNE!g$S;jV?Vq_7eiJenOSSdtVB&X6is);bDiVPBUkq8PZG=eDQoVKt#u
zO1?7jspgTk;{SYzVCZe!WO9?~^e$jyJbh}cj|5pny>bQu2RxcGWLGn+S^5cXUkLN(
zsW|-`@ZKoh(v3wkJ=rF4eEcjug&))~ip0@HBi+zK?Inp~bZt|O84a`OauUI;pp^x|
z2ko4|RQb2Hhfdye(8X)_#j_8hC_a>;k972(R8u|ckitj&7dEt_n~rML!0TB#a^T|k
zMBaKPw<{tlS8v&b-|y$S1rXi!H)XJ{b(a_Yj=ctMver;SQB$9nqfY5X{=)x?`>JMZ
z>6#w+yep{6pA_&ouXZCsEQCNV@<|2q!m<yO`nO{p<xidC0ZULc<49Np^bIt<St15l
zKzDZMyp<Ij874j<p4!udsd2C&v`M5;e!^!UtL;@hCmbD?@je?B4_l{_%|!|1@^!r`
z54;vKX4+jeSD`2mvr4tJf>omJ4_WfF?|>V5lPQWbDc#{E@-mTg)5d7qThU6%YV@S<
z1hNX}cgTW*z$ujh*bX<4G)&?fG|q=(;&QM>Zm?gEz+Y$~3--B15DGK}@-Sk9>&nC%
z)!g0EzRAGQ1D_|?_QfD75()q#RvGVfJr}G@mefmH1(_Qwi?mnHhV7u~;JT>=J^|{l
zEcOAx9<?~!nDW_ftV_1d?^AaEQWx4l8geMJ{_;VHzVC-(8M>_uZ1JNCo7H>7sJiGH
zB#8imYy0?<9&sjWR!}1U1U31^)6I|U^)g&4e(|{mXt3z&>j=;_ck<;RQnRd2MtcoM
zgBOU_uF-o5O*u>nT=iKlE1Bxjh&FPE3DOAmc$ORyq7fNHE0RF;j#NbbIM-3yM|JD?
zy3@D-AN4eutlP|1^Z(0X$t(>Ix|hl%FHGdS@MZ)=p{70*ZQxd_Ne8j@)(26ZR*(RR
z3qEv(H|bylD}=(`b4t5G7NCiuFSX~FlO30iU-BhfmS<_8O)RqRoX@;Ll9+#X%H_{|
zQRj@4ZAjPLx{8BB#`uS4#k@C5JpK?Rr~j@DX0+Q2bZK%x@XLU0*p)g$$pnFvzByj)
zaC-6^5+?=>1@&ykH5d;f-$Nk5x1e{GU_~y#1l#D3$g{>!GO8yp5Nmm$_Cz{;d9agk
zu}pZUpRs<ypHz?jkL08xW!1!Z#JZ9hBqW2D-o$;Eqv^XRkmm;bJb4D_3lB?QNY%pQ
zB4L^rsCWyA4d(E2@*Rk1A?8PNm^Un$Qw_(4ZgvtBfF>*ks?2Yv!oJ0ks;+w%DEf{B
ztvn~M5$#%Ix_uCv!$1~G_B$hisA0>Z>B-MB%|F6*D@K-9)3@%{2D~tVI-$5avfp>(
zAMNdzavXap?12ezO2m1`{b^=5#s;|>$MuQsu_;Y&whm8*{yvsu9|_fyGtZt;b~<t!
zM=$Tc^1Y=>K9j;@VjTbZ-C)23Hb468zu73J2ARe_j#rNPr9_8rP)z>wZ(=(G@$;d4
zQbM<BF|tb8u~G&HGS4=!)H&f+<sceDr5ekw1F0AUp}~WQM8*nu2S&U)c`phLO?fU7
z1I!$|k|0zG%61P$^wmiIuN&&fN`tZG0J;dLg`_%WVDI`-!!51NiJ4-LIorlvtr{@T
z+=?A+gD#nlGDTSn%n>7+_MX$X7L<?-@<o3FH(-<#@0lZ0gpjiw#KKBZUieFiHvX);
zRL;=30|=1kgyJ&sM$f?lP)%;=<(^JvzhIiM(|YLdY!tAn&LeI@_tNTm_gvFkDqq&a
ztQKHpaff1mgsb_^FO9Ej{5tZ?Y+-9Hu*9lGpG|G`-~ZgAjBJ9d$am}GsOVCcaLTi#
z>gK?+rX<Hp$3IV5U~;Q29TFuWh?^&2*Dphc7dHJ@m`=rWh|_FCGtE$0uZOoch0kRQ
zz9!mC`4oVN0tJ{=!8GRh8KDcO*T2VCY(d+lbicJeR<dQ*LRof06L7ogGV>WeGSxVT
zx*Vt|ISaDLuaCZF6<u<f))m2ZK81*^Y@?OXVBQNct%1!j>m?Ou#~f0~W)jxBZxh3%
zXq^-4?1PJ*kBSjKwtR{s2c%F~v9|y)U3}iy{Z4v;>oa-vN8y_vj3o-p(7!5XGN5%q
zj^DpeM@Ni-5E>F0Iw$bP>J{*fAgu1ABD?Et0u$=BKObm^RnybvhTsJ}R1BEfuX4^+
zmo;85rO0&z50yNdl4dho1%Z8nV24jr?pUSKCMXKh_hI=F3MW)!5CrKP+N)q(X??T_
zOzj)|fobXlD1>{_hI{xWFTn_q9g%sGBk-s-WyRA)fkvXU$*k0Ln|waY1_c1@4?Qv0
z;0e_*9h9gYmr-`9Us<urdm-Cvq{}H&!_;z+$5PB$;0esXZ~HQ=L%svUjSy4D9m|ZO
ztUX@>Qu@2C@S|41AVu>VlwLGtDh|PxG9s@Xk@`r{+*=DK4{*)i@x?#b-{sZv6F<c}
zxW;ZWa>xa6n2y!=EFNg*{lk6N@P%ikSmtmrAx<{{t3!~03dhia>P>Ov6<g?TJ>)ys
zRe&SNclw2j(r7etp=~KdE-3n~hMrPz0R`4z!qt}NxN)FOlc!{txfX6AUKkSzA3bI$
zmAt5^$od&7>qxU;sb)Fu<#m9Q6WDYf{$}ELiH@$+bcU5$2cw&_Ut+YgbkzO}-0j7x
zgfEtp1`7|cJO*7S+!hA{U<tOa&RBe16sq^tbRGJ_jhe7q5cYn<KoQ5V)p(>fcTlN_
z>*o3H9#!<ZQec0IH>Z*hdSNPMx%0*~n~%`wSg;Z<@PwFJfT8?#%jrT>q=Vy>hCk4R
z3NN7^j2=t0dG9mSnvT#o!}&Tg#|-?cMa&0M)cs{F6(a)?;g7!whG)HJ0ZKvB$)0~n
ztM|+e^9GMA*(|&oBj+iWLLhl+NcU)<P5#%1Q5edK8*g<TleR^+f*d3X`t;D03nw8m
z^deEts{3fMl_LBeATIgL&;K<S_pPrs_T~RGBd$&EY2)zEu!yjtP`C9K%L8j8Pn1Zf
zT<NYuK_zs{10!8t?XMUnWfYAYbp}S}-D-p?y?hlf2RNtHie#*5@K%DrUp7DVjIng<
zQhjXq;(i#J%S`^lf;Yo2u_}K1_;ovHju^O?=|%<I*a_3-wAAHfH4#e^S{z%8&rK5J
z(TYqBNJMV>k{zb*7QUUr#$)s6)F(w3y(R+|tIN8NWS)2APu(+HT<{+E`{LeqX-7bW
z{thw1%>^yKt8Z;3X-?(AIZb|ngW>di%krXV6ca;6(E84IvM|Q*-@0>ppup@1tF?45
z#irfTAz~<Y{%ELBT`jS}g^|Z4{r8Clldr-bKRSWrVO5|yB?!8=G3Oqi{QiZrnklo;
zUA|~inRBjGne5@O|G5^~0Tgff;g|3~v1jr91>^|EdUeNCl&myQB<ekj=9%#I5#Nd=
z9C}1T{{G;P1>!gbbEPh@Y-cU34t>1x!eyCZH{CNKt{Khpjzy_-UQk2lhZ0J+rha&F
z6AX{H>iT8I-wNa9#2u<Rh>V^lDlvgFZWfj;rHL;+Y7MBM_?VZsq{tsC!;oB{+lg8b
zVg;aN1WR4#jHQU`;D_EkVufd)S_fC-;}RGM3O-Bt;+124{^p|qRkSrv#_;cNn5!!~
zw}dw!KuO;Jl&6F^cpuxHq{lb{;ggsmoFuM|%_5nwQ*ioiUp+^XtfJ&7@-ZH;u>i;|
z<h{l_@p73^<xY<&PL9;N{VT;0Naka*sI3=j`jk<f8mS5?u?1*5&E~{tk0@%TwF~G=
z2OYpv?VmNZ_=wyyUJ~{dLW*q0LjIzq&;}xuLwRy^9kHpz?h}}nmq7!(<mLS=^NQo?
z_XRTDhYjiyJ^&kfP0G?YudU&-De$;`Z=YvKn^fM60NVsI6y6?CQbzqyL&k@U5B|A(
zVFz(vEV^SlOJOcgG2`OPM;^Kkgnau*?quVR$D{PiMKvOZ*GzX6NVN|v>Sl}4px4oI
zMj?<yI&+P!XOT$s0QW+3Id=^CzuF;Q9IGWW&Ru2xza+=kS4IjKq!QT4@sMgI-m5gp
zSgHS7Qd$=3k%9d(%P)|*?((7y75eQj$CD=b^-sgv$v3DcY}CdY$_5jWg0Ak~D&7ZU
z8nP)p>T=f>b~MsEPFLuPSbtbuGqeH*-OX;c*nnJ(`I8VFTzSTbykHEM_8k5GSiIbr
z3;1G=v-srKEj7{8SL2`tSnhBAHTgmMQ(RweA+C@gj+{arfIh5r?i%PeRG{%|wDZ+t
z*NbI_sfzz~6kfpfZgor6csR>AkHOzn=n9mGyL49MrsXv~{JS|$cd+X)PN2k=HHKh{
z`*}tUBkgu5-kgm59EMMvoI@M->9cA!H@mN;4IY$GJc|%J*~Z)wPc=7r0wuhV_4S&h
zVX`pzzpQ*yAbp0!agw_}B^Y*?%HZ97EB-j%hJOpqP0xG470xo*&{mlnJ@mb)Nkj{1
z)XOiV0YTkj5dby5;^@WzLv0kjw9OF(^jlc-ul9GpnJ|m_%^?x>Jm!^>G7yHKNrar0
z+l#|@*iU5?3)(*Fbo78BTl8wWR&J{!KWEsbz!iCX(=w0#u@%(>P-a^P-b{l6o?(ko
z{p)ZC!(!5>fiR_xLUBth(m1890L50siwj^5B#b&&rkGmuK%NC`ZJhE-6WhlN)A&`;
z-lP58E*X9(r<M@DgBdqqvb465%=cX3rSfJprLE5#D4Tly@mQ$KIW-I{5p`uOHTea`
zypo8a-jwOqOp*e2Jm5W7UB>Kulw7j(1E+Ay`<e_(`WU!?FeYk<6)b#xsPAmQ+)>9Q
zB9DJna0-7)h_npb@EZT_iQPcN<D|_oH_vA)Sd)FSCz^WGLP6|Pu!=1%rDjzD{;DZD
z%(u35r7ijdhV~B=V}DByPHiD%YL~d<K&pU^sXU%u#z!9nN6D%kQ9=n_5R(307ZjA}
zD5y6jce;?%(2SSV-O`kOrn6+9%C3TT1yH3N1cl6nL2BO>9~B=yvRLuaydbgb$UA--
zym!$To6^1e7D6Q7wwdS)UFO)XCk1K&^#*_FUDIB=I~xemRUW8{aUe%`n_IQF1Z+B*
zFg_jOmi@Vzb89$Me!Y$I79}Lr>!jwqN}udwd-5S=USfd3*GpRB;dX?W!I2GV5C6Wv
zIXzB*4U?^xz}lBzd8j4X^XaV=*QSI{&WZ^`99Fs##Us8Hbt#&hq|m@oNm1K=;Uvh+
zvaXJ!Vwcq`pfh0bBN2lbi}FA~;1zw+jE2mLc#ID1H-WwXQ2ncxK}8s0$ziLedMO8n
zA^d7)$`GKLGiz@p>h?ot%}gH!?eY}h6BURsuQ*;r+o(GyX)`phwRD8e7g$Dkk9wbf
zOi#7|9={Z=_h)hU(R~dR5s=7Y7Mav0)zJ^^w)F-3*Yghoh{~^owv-ZQImeTW|Nl<F
zJ23%=#1RPM<%e^Q-we!|>l4x9#2b6Gd5fr&9l+V4(8I^?oxbgZ1*I{@Eyke5d!ot+
zFS-~xp5eqQE0tdyn05eX4$E7<*|)!k>=pzx;fqBJ&0ka!XJHyP!ZS~U#9g^9Qxd{m
z(S$`ewBf6KYPd{N!ltfr-np1`mUG*IrQBI$?KFGiCVdVA0UBOjL#+N*JM`JMa9ytG
zg$|cgkMMa;#;+>ZS(qfmp6Msy6K|!9VfJ$|)5davmp-vGYFvHHO`D0l+{!yvO90nC
z>WDnzCp@^Eabz4hymF|6yMh-`l%7NvxG|^&6q?vw{Cmo>vIUH#L&AM2+PNFQ;~>Ku
zUqY_vO_0|X#8G`<npqgzvL^d3$Q}ysG3bx+y~yYjqUw&<c8|>LNMQ%~r*>%SKlKii
z$dw%<EKCcLdQ48$I4D9Pfw)O$%oJUb7)eE+1-*;bWBNWDy8W`DBHb^~6I+!6If1^e
z4Ht{GJ}jbHQ0@g?8Ni?vJ+e1qetTymFU?780&LAe^wI~F{4mlMeN6uqM)Z7a#Fycp
zUUae)8}C5o;ttoSNW^8X6A8~WSL@(3;S4&<=JVKO;0p+36bC85SI1pLGkVR!Cek+G
zb8Aauz+A*C2nb(|&J$l-1upQP4;N=w(Yh90tN}Qn*)}B#_v`?KAM5^Oi@=qbz3>)=
zXY$fQ2_KhIq+?Q}#?Vcslydme;P)SU9m+0X8K>qC$pw1+;Yx!P=k2*`cMS<w6v{h@
z1qORb$FO`=*Qr*+6!3YVa#VNGHhsvth(*p~F&*9dGTYw`r1nhU?)McJ2iT^`K8_5n
zJfK#(EgyDa+l&<`y$U>fiNnL_20DlL2VToNe+0wMw$<_11F{~}${TI*`JoJ=@ANyH
z`Z@%h3eGg4;a_sp$r!l>I&u2hOqD&{riX|sKSN;DTRaF)<`kx!SZoIMXU591V_-aF
zDVW&cBCIj#0fcdZvBhP*Iz}f_swK=s*QgZ>+INSM)HM7QH-l0ey<uc`I?gM`rW|pI
zGSm)AWT!df3NP1!WC;|}wTfpiV1yRJ4||CV(b}9o2+ocq4U)v~zZN3YGRn$pwNgsc
z9v88R;n%%VZJ5F71yhu#9SLa<pCXS3iOe`QCF}tsI*g9oXA6M+PFeF(Ve;+?4b?QL
zq=5?QT?@)@_{_qONw!hBMJokm%RM1R4y8YV?!#^`y<Hxxs`83^MhPTLW~p`CFfUN;
z(H?_e+=U*vVgCgT0ILAD+~_W89my9!5^Ae>V{2d9C$nXvJGNM0!FW)Li$L4m)R{5Q
zmAHeqQP``R2XnoJy%8wub%lW*gv{-$_+>jI*+j0HYvm40Fb&3Wwa1XqoMZ(xf;>eX
zbiUjGW^dxD$X!$1NI-LHn^<HijlOowf<Q2~0E&W*Fy<y2rjViKwqqZfT>y}DJ-XMU
zrg~Bl-4WEW*7a7S5n2}_gCP2O81_(3<;<Wml-&>S(o8jT#yB%>T?10fG=Rle?+G2*
z*}J?cgYHbw%eZw^4?v5S?o&h;|JE5aVxgIet&R}kmzb4Ul%d;ssk3tD2KbMlD*YD;
z$uMkn&5}t&iObF~;hD=mR*5M4e*J7C;E-*RYT;Rz!@2qN{ivFi*+CM3!=ZXtMP)Dj
zg|iDfwuZno(K;&IZ&36yQ>!UKfz6!lR|g*l>t81r;5EXt2pbPojce@9zf^m*P*tx|
zq|a_6<YqHZ|HtXRj<k2MHgDx~Is=i`Bj;1%&ApmQ40gnQQyoh0G6?TMUSiJCxHeHj
zO)vDT33v9imi#$)o<C4Lb9XCqd+fRIgJzni2yC2UAYX<N#h-vx)$i<1Fb@xn!bJ?l
z<8U1(tclttC=e+hY&?|zq;9#eJykafK38&2riA`gUnjVIiuy?HtTqxd3Z2TIWX{~b
zD7^cpt-B*1{XY824w7deSvr|5kp_=PH}B6=yr;_Fzdw%TP><W?U#0SLA1U^E)F1-a
zgvH%mUwFghXF1$4(xpnW4kc4I8>g!9s}zQGIG`#|SyUrEd-jJQJzwU|NjOK6Z%IVc
zs-fK}#2a+M2v=895I;_SaUnFcUeLvuC}18E+8y0pp~q2PZ&Bgle<7>U7KOssF=g6S
z%h)~s<N%e>h<)7cfhJ+)0!lAZ<1@~}myXv%-i#O#)F+sI-L3WC?2O1?Djti3<^Ry`
zYA_g7m&;JL`JzuJS7Fa|X>xK=jA-)9<MZ|^2<1K=M~EHo$Mc|^C=18k;IuerVZ(*&
zO`QR>W4(x<NCmr(ewBajQY63*c;P?o*fVvD5+rx$DVx|<sU~uLNLz=*k){8a|7l59
zzB9#*NCSJ`2SL&fdpZaPDsHL($qd^#ARkCt{yKPHuP0cBJ{7m#U{K?9R5_%VMX9?s
zGfM-47I#LY{AgkF{a5AXyE?&#GnMmMx=QJ*3vML(`~pCJ?#u$m5EfFy$cKgz4gf2X
zmET`SeI^=fzG;h4IH2_Nx8Yq#DlmOs_6l*s+>dW|M;#d_N0i%O&8`=0b}rNG2}Jen
z61{Ts;t&auLvcrA$|R6h*cGcXO#=QmLe>!?XIqG}!Sv*p+U(p@A(lNN7$^<E3Ww^R
zY%wMO=?-dyAjbFMTC{k9ZWe4~!kdobBi2$C3<}bePCwi@0DYmyAddJ0_ABaOa_^9u
zYjRdkk+_O<2Wr|0$$Io#xs4gq@?XHSHrJlT*y6Cg0%+zD`!{mw3CXecPW<W_c{|ds
zcCRny{&QeIRN=K6rnK2fuZ()<p`{2jU<MDz{_V%8+wr^D0p7h|6jM-#=UyJ%xf=|9
zG)oJyEkS^Opopk80@Doa&F$dykC#Kv;I#n}brt(x^rM^%3XgYDvz#iHqKeUI-fa<e
zZ4#Ic(_-qWZM*gI_)X591!~&p&hT`L<V?h&`E>w6)pSyBytjtz8)?H<1l8kRV<CA|
zdn^`u%ZXOyd@m%{=y$C)6Hbb9o~gtEeDWJr;+en{u0#BbA+$wvhkj0{A3?wKmg|1$
z<_H4HC?=_Z_rMy>h8V!F@RLinFbkywv0gs??k81!KXS~Wq5zRngR`Rt1j+~qFNvb~
zXRpFWn+M2X{3|ifgk2bSxlvpPbzeQeX+3p$*>|Mqp_~#(U7B2{NhB|WZG62w?6Dsw
z{*goSjgp0K&Kvv`e83#RfSBk~8QKsN2-ynSdiQK%cbV-4k{+r_%9KhBRTpzMcFb-~
zvnX%DMWc+g99r>Rqr6T;v=3>YjRBMao!qb_JXJte&dCyWc=Z0&Xj5y<y^8XuUnyiG
z5vnJIadDxD7<-!)0*8xrBHopT)5E&Tso|*mUTqtEwHsh(mLZQ8Cme4ya>MA)tDH!(
z8a(c2*{Jdn56HSXYV8pLuRi}u?H(oK4Q*Nt2j#R-1q={W=Nqiz=)+Z>b);q;S0yV|
zpJn8r-fO8^N?^a#sL+b3P=QC8*eDob56X~-mtOy_(SSG?j|~!1j_~2rjiyx4sx?!3
za<$jwR>)Ve+XNEH0%L1DGcsc*39u!5(PYBdGW=NuD=p>Id4D__01<BR$Nz27KEtN=
z$6^_fH088sIx@pmV)-XiamRt?8B_Fq(zW+nRR9FoO{_YBQtD%7rof70DH^?hrc#}u
z<jM{jZ19|<Y{jV-@BkSV)MZ^Pm0k{i=XAsb0|s_x{)7Fcny$0$9^Ede3SQsC;eri0
zEtY3ocwm`svz4S&rfgWzz(%3h+-gLrDKpZmKVxct<##a-rR^owE<WYhipyWwkawo?
z_{7>h2CN(9`9Dw+NGKVrWnIU`toD^?k(>x|hiFu>*GP?Rp@$4_agGD#<bSt!bHGmW
z?8IN(1l_vL6$t3SCx;&6>6>D&)AN^G8R|!)xA%<D>of9bfeIqf`REY%eL#m-BOi(7
zv&tJ<$bZ-C`;1@sO&_gG0`7FOz=;Gn^#0#Qpj~rxf9)D#aC?TZ^M#GWI7J!~{^^^x
zZK6>}fg2*U0B|6}iKR{c9XA2n11`Kf@fqN)oPa5_z8-y{2#t-2M`?%5ohwoRmr%#@
zE_a8m=>0y$-$b1$GVn~%_%8V5@!tgO*oa3kaH7PV?t&jK->>$){G~@c@HO!b6Wd;x
zOnyi5;qNDM)<R0ri2qHqOM%svQipI0aH*M+QDrIC2e~m4TQXJ%;IGhWgPHwMJ_L+A
zJGQLDN+k$H__o@)q}C1OH<#o|v0ldMyT!<;e$7=Cv!8srU2Fn_JR1rIRL)1W2ObLO
zl&QJmm{H-hQhl!H*}*`gPI)2Tp|!*?1Zv^^p+Xo_5l+wVx<f)o#i0-dWS@ahl`Kgf
z<!>2%DHEg0=j%s<U5>a>=Je%suLw3H=1lKjj<r1lZw|GsB+&93yO1odbqe-kt+ewS
zAk~7{%sFEvP+*-4Tmo1Wgaol)LiF}S5(0}a29Y%ws~o3AE)e-y9W=mBNODF)-n<!w
zVs3nQsEZO(D>KX;k@s-E7p3d2TdE1fT%2rG9XKR-csRrkQhIACj%{|EhO>QzzjmV(
ze@yYZFDCe|_<}TS#Yzu8*=Ga<jpdIJ^n@k{p;2OtstYPHJqPek<8F=aRO&{kl0hGD
zSX2hL-Ir{h-Of-0Ef*&OCwSiKE|Mn%p3PkE4ZU2$n^Iv?VE63g`)XVlyy>93SLT6Z
zzKX%*f5jMC&q=N9+20?{)B-5WZNNs#K)F2K!Mk2=Ynb<6V%w14m7O*I{68Bo#L7tv
zw($%IsS>crE+L$-$^nW>{E1$!vElFvff+n_t+F43ANC{L3X#T6_S^0Og1YhRzwzua
z%_T}9_$V`b`s4=4A$;O#A5p{RNILOlUe<NY_(*Bw%zk3Vd1OpjNAMu(kr-s0d9lZM
zj`MzCC(;3OX|Ka~+Z)A%M$jnsFGj#=fYg7plm%$~#hS69Y$5jW0#(#TP8q^mH!yMc
zpDT-ed(?1U6NbN+)ax^jgAS_dsMvlo6|&Anc1P>ay{p&1=yHj?v3m5`Q+UOL)_Ctt
zQXko+#0)9Va#MHR(!_VSDe+V02MY+|t)h2KMAh=K9eAyK5^%W>FzW9cj~NJrmo-Nm
zgYMqQZaUSFc&A@!$Ds*pbc@;3yEa79NN7O@yO15(mCeOkjUCPIB2rTlGx-&$y3sUY
z1Xp&MTJE;&<?<jYIfLs@6y}=Sp3MaR6~-*Jg=|hf<i$J<j^ZVBJ35zER?DroWpczj
z@9h_K@sfe*C@ZV+zcB~uKMtf(7f4#|@wuQ=Da91aEQxP|_D89T)vt1Oyu=y!KuX{b
zt>7=xa=r5WOr2R!oeO;CO4`HK7}}o58mYp@;|hLvte=>2NVL^x&$TZE%5SM#p0D(I
z8}&KiCNFwH-GLWgn*yIo(3e9b;ea=ROsNq4F<cI)9OP7q+i7=gdjq9qE-2-7T|2(4
zPAxNf<y?S1;h7}(<9x`%BOKs|*}n2>a`NsuHZ74u(O{SevqMm<2(7(16kNPRO$~I6
z2TH}1qKU^_9bsKL@|%3tKHR|detinF-spN3gZ2uDWCD;O6?j%#N9lIr=JPuMM(sz4
zZGGN&u5!wiDA=||J0>v~&^68+sAm47>m1xDT`F+yEq*WWG%3MJVE(c#$M;bJf+FLF
zXF}~2Cs1-Je(ghT5onl(h^klbrQw6cO5=10uR~9umo1ZbV=n5fNo`E&VjIsHUr12B
zq06tS^#(h1gk&g(-}Nd80o&S>93Vp!Dk+Q^%1CIh&`7MC#xnZS&wj+=)9sZQgj<>{
zC=~mzt>}{Pp)P$+U3jKGdSZ885#Kc>Ye!F(j~*$!_=7;wL=ic0!|2|Y-Lh?50n8oa
z>*rD`DzXGaF(5p=9>o)CNdihon>|2lp6{K4kRYTn=LFIfan%fC+!kw>N$9n#XRWlM
zn!mLqvQ!VfnE_~y1^dEf-Cs0n0Pe`^wCL-B8_cQf14h=jV;nBaMER4SK%?M4@R+$6
zx~^d*A1!euKr+XmV_?ED{QTwqxjU_BcR&1Q=D&GT5i*%q<^B1tRFnrhI~+QqUWRzS
zKOK%w<pwn0VCx~*GuLCGs>W76^37B{&!&D5<FPc-YuMGBB+^%cW74h55Zz1IGU$JD
zIEGYxcTG%Z?1Pys4%Oy=sW*$e@xUFk68j-N*i?s8dl$KxH`0l@^&6Dt9x~9TJ}SnM
zYg9snOD(ZY0P_wpD5%cdSGW&uCa49prz|QhWy!7M3@IEsaQgh^<=w(CEO`Hk3)ov3
z&+BwHZPzB16Ve-~-9Bze1aQKAtlD@?8YATx*lH-9Vi&w@xw8*yAD~;3$r?fG%YYIh
z2<I*t@Q7b4@&*dKSdBdUo+U=Oz^3LfTTR58uPofao)^pHz%Ex=QQIN`S`e<6$`|_C
zi+RxCpC#ZxYP4Jppw{C<#-U6kNv)g(gz6DAz8FlwMa!TXy><D=s;Qbfju$tvYKcLv
zGY4K%Xqq&=xYfTeK*;3xL(@1A4$M{>835`BAsD-W!IYNq=&wbn?w%RTAFzi{{VZaL
z?ki#4)q-6irfc6n-1xSxn+zSX-{Mi7_eb<iZ|a?_WyL@t<7gL=bT_sE|73lfRcxG}
zhjV*Oz@EyX4}0j^>QdB{{7?s1=k<`5WfhsS{pf!Y>c?f?GGkpNJ2C%AZmQZo<D!w0
zmdw!ITxvV|KPJxiq_RbaEk_GAdFFXpV^`}*tCic2*Skod{<!1EyfUJn<;8_%Dq(<}
zmYb$Ydc&Ds2%5&Yo!-Cqm|+yei+;G{<tO-nX?eZ&k?Q4n0y2aIS#uOORL3?e<Gn7y
zwaY*dWrFZCCblBEzIKuY-bd$y_G?fqefCkAa@#9bK?<~Sbb10I{7BEC|8;8<dIP^T
zgiPPW`4{-DNaQv<;k1<IeW<&!<T69w>&)saTV)Ao^@V-Fzu(4BOVd@vs>R?zExlUL
z3$U{Kb{s&lX3n4xcdwSoegBo-L<U<eP>&}^T1*UV87bm<7l+u!A*P1e^$jyJclKp?
zuOB1Y&&f|QT%nXZv&~`Rq_h_?%x*i5ldjMof2h|mLTzsxZQXEfK%SD4O0r!b9*4KN
zQUQqnQDvVb^6gf(I8v1T3nh?Qwi&?yfIRFv&CZ@Hu3PjVawFeVQ!rEfB`CHX0Iq=Y
z=C7g*Q(hm3bQpu#2vTk0;Tmxb$YwlpohNJ^3T71Q@{TM_YoQ*5jhIx7>%_~v%Rxnh
zQ(d<-o4><9EgTDCE@BY%KF|R_G8*Esrf~V9&ola~+=VBVIze%FVs(z95Dlr<YMR3J
zR<Mtkk*2T%Nb!&*($Q7q5dVCDn9vgw9&P(V4#!Ewm=2IzeS@;67M494nxmf%a?tU^
zMEfTUDJ<$uAB3E?Aq@i46B_Tpc6pw$2r&7GI{j46|CV3&HsUgp-r2V1>ck#>DH1RF
z-_&+|z$A@Xq9=rW2>zu!%%2{XctO?`E;PoBK+e8M#~mz6NmPSYfE;nZwN4>Mu}yww
zUCeB0E2w&_`nME4GX5$mVtQ4|&S4f9D!E~~SNs$yU+Hb(K($Lb@IPi9k_#3^Fx;}y
z25I1>q@NM-$ahUq1E3Th$r2GTkSOrqPV|x!Q~miZ<bM7-sfpwc3E6H@#DpTHwoQe&
zG;{KsSyk@l=XnH4j?CQe&t>^z#3anOz$+P|cURk|Zf&8aF)Q<ZBlSUlm<69GrHqk9
zKED6WYc}7U&%xXbe{w|!^#ie}!F0y7^<$|%{4|L0i7=l5;Cj@~i8gWT(t4srA7A7*
z`0)H}l4d?Xm3mB^t*$iFHX&z0@W<WdxAW?s0L!eqw{mSAKe`muv6Zh-1*Y3r-&=;7
z1p0Oin_LG1WX}`wQEa&Oe-6_{93aDS#EbV@2Mbd6b5c`8QDQ4!iP9nx9CE0jue&<0
z>X1`zOz5w?Gy(Mldh~QHh?9|M*K;rbuE-8R0CH{&5O6!nm&vw_-?ETv{*i}`wT@g$
z%1fPNWiGBQS;J>ta9u5wbj$*7RH=)n;&|9Tr1s%_jmUq`nKG4b%?>H;ctBg>`pjpH
z0$yz9G|~^z1<%$s^J#hg+D}P=U)-3tw#m>KSHp-P@v>WxnBs^`>HEikGvr*TPm8DL
z#X@3iZ8D_DKT3}7hDRbOf*d7OSEIFC8p=RO3hY2uhG<$KzuCPRf!O8S;$U+2ugNVS
z!sI~8Au6{ODT=hpk&2kVtF$XJAa(UIJDhWHm4mu@su>bJ?7}MVhF+8$T3V3~gqLh}
zrb6QM#+LJ!t$O1^V~3CWldbz*=rl5G>t>$8PO?S%JWG@8;*5^-s$0^=d#~_ngWcY|
z)7Kl)7{5Ov{s~7S2YU}Iyx;5|tz~UDxe@T$I}i1thiZg=8J?pDP!8L=wTd4IiN9BA
zLk}==f}GFiPO0OeZh)2$ereBG_^{NIsd#uMB?@3KW)3&-xNMo)(@r;ah0+1bu@_ix
zN^clD2JlJ0VH2Do-I7+eR%{Ih;NG{v6W)F$?td>({v^=H7T16hzly+f@dwA&W8$!3
zLliOi&(d*cpX4>ZHWX1ui#MK&A+2k~Dx4KW^GJp8>6@d5zBbAbDyRycMW?VW*)+A4
zP21vuxHqq~2q4P9eNohy8j4U1JLd*%(-O#{L^T|ir8&iR<Nf$yYQ600Ghl%DlNt<C
zz<qWcfi0}uEQ5TVA*%bzV6<)dJrQ(RZAgCoAv=&z&-}3o3ILdRDrx{fK)}CqF$>cr
z6nVwB=S4twdyV=)on5}F*oNZF)j2MA*rUsJIc8_bEkpD4WHHD81!NofG2Ry1%)GtS
z=HS>VWJ#vM`|<5+e(&)3H(v_L(GMNXv#qH!HvKvdn`9PlBpVjDyVLu_gLD-Wy^P-P
zC~N0-hOl0dIjEgn#XlTibvHfLp!+Rbnc6M<T8Zk{XRR#kJriisINQXyFNdvTYLbk*
zVmo^9dPD$%E*a=!6W<x$^h1-Q!w*zx+V!k2E!Q=>@+TFF@rpr@ztzS8E&$?#A0;Nm
zp8{FzFRkR=NFHYQswTjZHsV2%XYkK~$nH-{A8MJyu#`hs)HJ0eAeh@d9Pf$)Fo@r5
zI~}9tL2MFwh2!S9?04^GFAu6k1CTKn@B8KAhro^oPi}5x#(nDXC@@8(Qzgg5L>%VD
z+F%!9EHd02(7Xbyin=eK%mOdpXY1rDfo%a(t_34sjh5C^!M2ks#s#NG<w$jv@)~2G
z=sbnZZfmrWL?_G2Z7Eedy4cvdaa+Jk?@7PNTEKKn=?rCwZWde+ImGjTXC_K;2Z7qR
z+NI*TaxWih*QAD@V!`YT+9}<Q_RP8YKU;4M5rPFdg^&ju7rf9X@Sh5OvSd!skTeQx
zqqrI{C0`*2(T}TT%JH_#XvK6q9k~dDkoSLqX21u>1Xw<ELbSK(LtcdHKGkDvr;lZk
z<NiFr6!><~W1ELvy6O}nI=Sm|Sb0ADqT@MfIJIgB*&Qi+C609#pk!6pEzg9>O_{6A
zeD<I##OWzsUars6l4iO!QmW4T(jA1G(pF-tJYcC&VBjc|7fQcI4KiOlxxs@0@1dO8
z_U>+i_Ft8t$6XX7l9)%1l1)j0-z>T#BcIXlw$mbLuBEh2&^1hf&<~sV)-uizv$)LV
zJgF(CSg@Qao*frS0|jA|W_RVEnCsz;28xqiHJR~tq>hbqB$}F-8neDaj1AgM%Ev5|
zK-$V|BDD8|5`R?kg%H)4b1Qu&V?E+EjQ4i?-3(!je|@^z^D9<*{~2xw*Hdfgh2l{D
zDLmVCoxE{#_p)7l=>EWB430;7)TLOE=bEo5v#0M?>#tPib3+QOvElX5+ou^AHEg;n
z#36nAiNAd{j11Sc@u(EDbbvLFgqodY6>RRH4L5SfS}@5Q#vypHZSuHdYq)3K=LvL&
zlG&VMjYx92o1C&?Se&3z&Q|D+xWm;z2wgOKpN4Gl?wj8F!i0C5wa+ie``o)I7<7Qm
z0r}w@Tvz2_@kj0_v#E3dn|ZuVF0ekAIM?JH<yd<8b@ZL<FyJG=tD|!+U^89m&WTGl
zSl)nDkCl+|;K{K?*@yZ%yxBVsjnzcyVAeAU3>B!(7p2aK<mDam`D^9K0Cln0sIEEj
z#{T&n31&u03gtN<ezcyaT+dYnzU7lZA&;A(_t}H&_>N<q+@E;)(7Rw>uds7~j!>PF
zUV?F}Ut|(4Td|;6aOdcM!vbH46ZB&ix_3wkxL&^L;#I=ED{>>CyFPw_riAup8j`$f
zCk}V|8+_CZHCFV2YNBEvvhuFHKH{3nD%QWq!#?#U@k+7Vb-iOlg(sG`f~2^w&wDzR
zmLaB2^iQ7%I$77IG<eH0a&+;z!5|Bo8Bv61oRl4W<GG4gUxGSgf@^+KefIK09t&4d
zsEkmePph#^{4|^q{9f|xF_G6Dk6{gd5honT28}P2@d#i8=y$dS7*D8a7VvPj)8*Bd
zE#F_MoZ}N^CaXm40^c7?dx5iShFgcOc(0bF1=isN*6TP@UewYdHOM<g2vu|U7NC>S
z=4D5NIn8(|3o9uXK9}e~fGnsiTJXaSqiRY?*WD25n)Cgp0tl=l9(S9J6yF^1!e{2F
zY}zN=d*CZcA~7Bw<X~f<3>6ma&$5Oagl<5zz!PlQPhK_WON{N=9(;fd#|k(73;sfy
zushjL@5k8H##g$sSN<Y?mr+VHpafq|tB5MmZtcTDjg@OR>4m&xIF-FgPb(qUYY-R6
z=^o^*Y*h(QaNIm5Jt)s-`dnZFLBaN|7y#15n6{S}qR6gTi7bQ7(}zgFEC4p+pLt;^
zE^f5~Ei*7UiIM6C8nE9k?y{eE6O;xuIqIZeX4wcY^py5Mnrb|}R)7nzlBn>)7tK7^
zfaZo2Qm%aaz7ZNXt~4DeuGlk)rt3N~-$&kB%3ol*A?uz-b<L+0qXi6C+$}X#Dv@{}
zS!&2zXdSV}(R;=^$dP1hb{Bq0hl5GN9r7*bCCtBGmrs;Ik!GE7Pr~4TGUC_Q64xG$
zM;SKTdU7#FiZ)jzK*P^HN2z@AOH%>`?d^wkd$~aCI7STRD;L^AUSyCdc2#7aMSs?s
zd)EuuLoY%TmiV%Cv8(W~V>uteE9Pwf4^W#p13Si=3{&-SnHeEXM1Of9;oz}*1@SzN
z{uOFgj4ICKLjX|FoWS?pn0=bzaHrEjXI?3I!!CoM)KY#~XU09H0#@INolf!x0-wW6
zsgPzoYig+WJOT(s&Vl1uO$F$zH{mY98r|(HGVTp|Smxyo+)YymwYMS!oA&M2^${3m
zCaLq<KgV)pOrhCtR^@FdG$22w+SwN{j7mRZa`zf0K&3sRx$tydChAZ!_@!0L7Bh`}
zfK;j-#anc*NYDes?Wbow7rB)BQ<=sS>~256ge;AZ_{P#w)xk+DOPOP8YdXM4?7=>M
z9*y^w4*dm{As^)3YD6QTg{CLDH0pr1Kw#0Jk)!?=v2uP{pCidb_do};D7P%6oD}RU
zpdTsAPWZsBkL+~?oE&eUdo(>Ma1Jk*x+9~-m4-1=0nD*6$SbNK#ivNe9n~pJ2^c5%
zqSt1klByC{i|H_UV_;1j)eV?ZUD5(%r=fHy34(fc(@_MAl@@dxQa@Jf8hJ@1Z!9VM
z_9+6rLQ)PcI2*~SHCp4zY)(Tq>z~2Ep6+2f+<QQnPqF6U4*L8!9;v`5mH;AB<hZXH
zfAKKw0T3IRFvN2elui(Xf6uYivS8*Fl(Li|HPg2i5(m1;wIdA}8LSDRdR;qWPy22H
z{?u@S@V@;PLiy!D!(E6p&3SA3p`M?34Dx)4WL;L4E|OuxJk+Z6{Y;>&+h;ab!(vIc
z_D8uffXW=wNss@{tT}!xz9a_ZL~23{5X=1fIm1!Od;NE^5kA^2-Tnz2t(pVp55(_`
zWtqurti>5I6^|c?Lc;bD%OFs0793Bxbgv0P&~QuBpSX^IND>Yf(yGZzWWg4H65P-l
z87^DX0wU!697-^StqI5y#K9-ea2g>ohr(rNui0u$IA2uT6V&F4_XzU0LDytC8<X2Q
z=IuS@lH#+o_Z5ge>8CT=*zNBTV=3K~@FUK~ZTiV|v?Ca@?J+QlsDEoltR|GMpL1cb
zzEr8zd)j|3cZF5O+Hnr+{LrPYbcm|<BxyhvM}OCOc?x(2umJ#53_tCSdT%RoxO&|2
zV{9&g6$-|6QYhYbh)7m+AD_)$c~PLEJ57Rgx0j}Hb<E5gPy|&RN>tzd9UvYPi~cbv
z6NgZmASRHECSZxhU(u4TpoC+GF7~U{Q5AsQ7m}x9d63-_A2WB$-v=aseJpH^(FczQ
z;Vb$5gly%s4^qM?1FCjdVZT<Exy%f3vdih!kPQR9?fFnqhkn+#9fvvQlr=quzX4Fv
zzF~yvc<G@Ij(f`oZ@z$y<nq&b2Dgj@ZFi6Cxo)qIVx6)WcX2TrX$&NQPitm-X=9~#
zhOw?NK2%|bk2wM4W$7<Td-h~LM8}AbdzT$@p1tZZj2*3m?5O%BU&PtXhTN9*%IAVn
z4BBGu!{BoHgYn%zDm=*X>X7Gi0`4L{Emv_U?}ET{mW$hO4C{L0Bn0@iyX4B<xp-Zm
zwfBcnqoUA;LGhU?I!=1IkQO7e;frvJ!13AUYa9g5H=VE%5QUVb`EiT&PRBOD+8FI<
z__#-Uww7~#iY=xcMRIKJPyFlT5W<jt<TQkmU1?ucj|EnosvZLxS&bxwtNA@ui#e=D
z=^#G>23CMrhh_+A8Nf5^e|~OkP6r7EO3NiK7!v&%!v~VJm|a)QP8nml+P6)gJqjvp
zt_Tjwx0}wmb9Z64t#l-?sxwg~A1y7yfmf$!N<TCE%-JPMDL?q3?xtJ$z;a(F9PSyp
ztsXA<ahaTo4<+zDD1Z_dN9i_@F=pT}yLR+lz>@hcEVccl2VR5T?M0UCgY+<w;3)o7
zx=g1>+&Y8TRai?gYd|GzI}&69`Lo-gK)tOhbN>47zc=qHse#OuE#%P>DmgC#9AfX4
zGQ?{p;7LHGR)e#+J4PaP8(DqixHUd<JS{q1@KJW>6!bwfc1v5q1ufQw)<|ce+uqeu
zmpQ5cRjj(U=f#&us^7x%Q3s`Wogt3RvQfi8oP?F%;3DqRZNRFoLd;ihIn-EnFTgYw
z1s8#sf16~@VOVS(AV3H7>5OX#=ihf3^V-c|Cr(*#-%!^~E&>5n7-?Qa!OUY!WZN^q
z@<W098K7yc;%(c{c_=D6X;P9nz74@AwfmIqj06Fy`6XF1QpgwNj*Nr7ygKZr{#*p6
zX!(K0r}@&!M8oE0A)&qyI-Xdbs;D*INfq=p&+8{ivS+Db+P0;X_A6nfM9y($CBGT!
zLe_y%WKIX;A%Gq^9YJ|$@+{GIHdy^AXowi(m5+oc3UD{|W4Xl=#dZxfYU04CWQ}W1
zKF~P;SOAa3y6Sb^Vl3dgg56?;QEZS0tUToR8e0V)ZX1@+c9If3L<KUwB*g@B7&i$1
z5P56qzM2d2amzbn@A)r)s;83K3m)^{^tn;5c~P3ooyA~doThos{+2;~amXP=<eo4;
zFcN}_^&4^OM&XoR_s4}@6D>o^C;GjXuJ!kN_ngyuK6B3L+TkF9-L8W`e2ke`v}<e9
zH&0!$oOTKSi{A??MU&CtaI8u^Z%8Z1*Jkv+rc3QE;<QNje*+q1am4%<<}IrtG(mo3
z1Mpwb)L(3R$V-9e!YnDHn69|1bjN!14^AU*(_}rC;TtK85SxXvlRvqRcN=|Se<D`4
z@gqUCyGHgj5<&nS)LHU#4%sf049(c<EvQ7a1@8V-MbK7_5dQE?oUTS;O%BnLd1Yr8
z?W}h-LW{W3lB3$^-L>u6m0Z?bTFCT;82f~BK3s`7elXC3)_MSukR)TTL)j;chqm$5
z{tUe;N3>06uue_tk(bn75g^wK%WwR`lN?!%`B-?QwI^n3PAzVIv&l~B0Rk3nfp$@x
zOzJZcfc6YD!$e&;v<$R?QUj7#MdHcXOv160+b>V0<qQjosg~sG9qL;rMG-X3HQ9QX
zdN6|U+qMhM<62Rd(`WU4!r~lf=EJXVEMY~<LYlG>eAFvo>L#DX=`BG}V4V&7CZ}4x
zH?7`->OTutVJ`mw8%7mHxYTghfnkGu|2FO0%0Nmcuy2{Y7l=GbluuG5#a1Ir*w&{a
zlJs$SvyJXs2TXIdu)Mrtx55x>sZPm=Yc7f|v7T{Ii}*FiUfs}r7kz75otMn?F+BOq
zPg=mgt7sQiVFV!wNNH6H^TtT87v+`6V+uIPQS3dlOBZixnl0;~H<A0-`dv%bEf(Q?
z<=+1A83{ULO<BWgoiekji&;6Em;EFg;_c9l;(n(B8gG9nMj021C=bgycw~x~1?;W%
zuUT)Zq#08WG|W^!6S;A?tm=Iuq&~y+yGrPV4Ci0SZ>ExuLXHNp4`R*AO|pzC*k7Z5
zkZXUyB`kQ9a!JsOMcTt6VtLp(xAO!82QhRY%P0qlA{6Emn@8_heg^hLf=m#{1d|)$
z>RQvi(c<&7sV+X;iWtEn&{hrrXhbkyM!%!l4y6;DhI7<R+q^IZoXwz<N%566A)eOd
z#3soOLLS)AwGVLcuy#k&p&P*5I+*Xddr;?~B94Y9JO-~E>D)RAh$BbnCU!Yz)!VBw
zt>*7}6t98cJySy>dkg9q7U#(MJF@|;T8U*P%jfxNCPNA)$^MKX1N?i4PB-{~t{1Xk
zd~=~6%-F}cfb5&?yUet=9Q=InXBT6$a-a@Z!}oTU*JYy>MfBCBIm)$63fIb9ps(UB
zh*`EFZgql$H`kMxSx&JJ(QpSyr@NpCL$bcDc;>%aGp<55*!nczyN7mGl`KM{xBFn4
z0*HD&kb`TlEl}sqcKb}Wk-mu&CXIo?WslJp2o{yE=9hEYYI6_<DsF5U=L55UY(hbg
z5kVqhxyC=TVNP+2y7YPXf(#iYNfKL{2?rVg&wgvne94|<^9}b}&8lcODFweKC-zO9
zuMG2b^6ajCuY-RvFH9o#HN%NvHVya)bV7)7lYleL_|(r#(#kdFR8?G;n2<vQ^}`2|
zEEyMYfp%up_-12?HHVV5XjrxEtxr#r<0HeO9wFO8vrMaBx$36OTS3KP)pT%-1DPo|
zx|({iuZ!bgNa$MxG{)pB*){piG8)K?=rh&*o;<1QqASK&BB~OF#r}DP0M?ix?TGY&
z7U}|v(ZXtxLQ%N=6xTgD@xih|tg&ol84>Y>OS5t2we@JKF%JFE<0+sZUp5eW-)jLr
z;*lAknZ;C84^J^y9(cgeK>r&uC<P6TT4JMJy%?Ru$n{Dcr507vE_g275Jf9<HKeDp
zPlVrgs}7<Vbv)J9ODgCLBsMCUckA%8@k_~7he8jQv5TBwsN}XT3E9`uhS0cAaXI6s
zun@n!M*2?yG$O-8?nEvEsEBwFu?G>Bu04^#C(}xkamybSQ>zikN0jW0#^R}D%iPgk
zL62Nx#h+TrGb4f>xp2(HBhkR4U;GTx)Ij)<@Gqs9@SS$I(R6T(zFq$LsSPeL1V@rH
z)b`oO9?kS3Ff_KmkxziL7ol+pv*-*VZc9guSep(RhR;Y$e^tSMl{=LI)+VuL1BjB_
zK0t{_D+`ow>Q7Wg6wil|^o64BcO4$TQaMvjD3}g>>!gNHp*u5lHkIvk%@)t?S^&wp
zKZsq(YisFPgHxG5ul&b>dW5xWuXlqY<1+)JAgfXh@p@2wqFr13rS87zE6ukuIIQy+
zR*FrcOf&TVQVu>-z8$~@EUjv_QlfY0(?t^BaPOSPc{!-&DZCl$bP%2`Guo()Ei1Jx
zN0b{hQqVHkJEW={lW~#S{gFMw7C%H;@1cP~P13WCG;eeYy<-xs!s&92>1Uha3`@x<
za&ClF>iO*3XDThx;NyPGi5C?a1xVJqaxe5oEV4&opDjd=Ytk3jl~`6$`_?_i!<>Z0
z<EaHD3*w6aLKhKq(bz{^$A~;dl+KuFo59>-nb_9ZyWCJ!QPw^jzb5Im=~MLEx^(Nm
zZR8yUYUnnW7wbC6sXVgWjofTDkog(QTOe+ag1T#W`Wp^?zvfi~8(`yVT2NIr;HNU}
zu1(fb?MgO<jkI{{cKGW&ybZv38tt-$xNrs+@C5Gg4Gc!%@O&YQx3n3^WabmWLAUK)
z(FV}1dBV;^VBA}Jk_*@_p~>f;I}F3Pk>bZ#(g!%wp?;V;QJTn4sCF_7x~=Ic(UliD
zbbw?~vJ@Dhib#O%t>yK+hPElR?SyuvYRmrG%1Gn~e`Fg3wePQx`y?6eHGn5_Bx>ri
zsjiy=k>AVLZ5FvS!ry{+)H{LK>&%0uC819U%I!r?*+KV{>TcdUc&*~j7rgeX{O{MR
zOke9eg|pigRJ#m-IidbH_8DH)D#fb0aFUC&bKJuX?O=M8%wy|aTaq-#7Mo1bIcVD<
zMEB4NPGE)^k;qS=aR1_5#95-%0zdN^KIYdokfa>_`!%u~$x$JpOQ=QIqmTLlO01aX
z<Um+T*S$hIxaQ9DNp^1jHoscODf4*Dx8jqy`4`u17@@yfrW%_g+p`|q)4$6GPGZrA
z+cC|>zEj_g+-dg?V<M9LLLl#5?+2fBwSzo!L!V1o1%Ww%zZXYJ9Vj8#Nnuz>BLIAN
zfCYlpg2R9+9&>NOA)i~6e?cPEV<dq4^3uTi`Cw|?-9M@~>LKtGWV1dg$+M*W+ULxN
z@u15V?A+laRy9E!Z6)O8*QWd~*9OzxB2WmqsJ<*tA?%IDgt)!z`&w!trG^+Fv5ZLW
ztEPrdZ1bA26)xb`WYblCZmZ+*c_=Ew1=+~e;<BFX?@EIU{s=3grpI~eb&N=#!?v^a
zpx~k-ws@HE!z42vYL{e@t(!o80<LnnA)4%SbS;^GT!cx_SXcG04F#&n6jtPa(chPw
zu&-#vQKVIHLCpe4vP#bh3}Lh;SGiq6Q|7(gT_YiNioh)e9>Te}tjI6CMz1n?jIeRb
zd6k54UofvzT|g$tccF#Qr)F*0#yWsP6j#h&59Bg|0^E~^JCX5XVU6e$Eyo*_Fo2NR
zP*XuQ=FZ?~jh3>3#9nFNJt3~JJC8#D!JxJjc~S0waE^iX#?=nM@f`v&<_EcUo~0EO
zsrWAMl@AU3`Gdk&8XKQb&2-9gSeQe(vyo-qLT3-J;`M$~z|zDMb}7R?oS7%5N_n`C
zD#|x3!aB+R!I}Y89oHz_3gJZB1)=uki<An~p-R}xbyhf3k&Fe@+%U8{^KL09m%MA6
zaEp4BTR#giv&beAr;B;$I#T%Nv_2ZWl!viTrIS-<oh5O_rn-+?lOk|Gx{ggf`PrgG
z+c>2g*^QgOEtv?LT$*g?(J_c)GpRr`OOB0)aPI45PmHN&mIZ@9n?<ksZy(hn!Uk6y
z=?$Kx?tkNGf8U%EEh{3SiBryc;<xO@S4x!yAMx0{=}FYRH+Z*djNR+6+1w2bkDE<-
z{E#L{<)S2(liS!&&B|+Y($I2BGE|I)M?M0NwtEZq_7%)97BUbX0m3&@LE5G<fKO_0
zOgm;Otyo2zWyF-J_G%AN7c^6p`ox3(Sp|3k+336#5k<X8l(DSaK#8J>&9S1sJp=yq
zWS8#TI!UFnjjjZxW>Iy266~g*;L?AXofWnVIm`I)c8uHwAJv3-rN8daP)`4o*@pG*
zr2gVgIu%QYx>94Je#^4gw|+b6M5t`~@~ffLyN!wY{2gDJ7R>yS)*wZ9qER*K1~lVK
zn(pew?2Vx#G3y&rx<o%!HJut1!ZxHI#+YUM8Me@B=TaxaL)Qc+g>wSzAf9O=qs|B)
zQuXvY41UO-Jq|fYgt*tE%BfgBfy(S#Y_-nz1mdyHE}u|5DPR9`0G7CEO4B9@XLT@O
zJ&LRTJkc7ZLz(ZE(=c8m?T)RUn2ti3bL0ai!1G&nlM1@PLe!%Xrr9FCLC4#wnD(vX
z@dAGPm3=Vh012nf`9FY-3@96Nr8<u!{79I0fUTxvi_-6$_IFwO%#Wr22$NGq{Cwu7
zK-hD#v_ai=xBxGH%8&7#LoT>ibRK4?u&vrXh#D9EQI5MF#&bjmhwq$0u5y#R{S3*1
z@?<lMCL1YBL@k7BhfguO?E>GoPk)*L<2`+ouD=6$>@NW1(p_cDrqnDAKB_#vxWtJU
zLf@(h_H+UIe(ftrk2ai7=K$V@EF@QdU`4%z$sYp+kvgMnQdUZTiOk`d;_6ZIIwISd
z37cs+W4CRuS5&g9l&>053+N4;FKI9kYsXfp%ItYyUA4)ANI&?<#*J(&s~ettBKv4B
zk^&;OuotMkT~S!9G%|0)7_sJQ9&+AylT$qy6b*G=;Cgrd3vS>g9vt3g$|!8efr9(w
z6^Oy}ut57JUG!e{o$~aw)3~i?ml)Y<WC3qVG!h@U_joq>=;Lu0FuAPGj+N)$m5AZH
zNBC@)$*xLzOSyX7I-w!686p)e8+oxaI>I&#s3LDCk+Jdqz3W=Ql_Z}OXO^Oi{`3#c
zY0ZO+ZfIpw4Pxh!w<NIVF+5Ld5yyB26WHLEf|<RG@eEl{rmq+Xz#EN!(AOP8AQP$x
zB9YnE{6DJM*-rH0Ow~k%4S!}(QB1c7%X5f2`(r<VUh<m=a;}kk({r`C+AzJ`{2GWU
z4>bp>j9jfu$yD71c9z|zpxjf8(Us_lmV^o8^SYE`zC%<J1f?GEO~?L$d&6x`*<2Xf
z+s?9fP;YKOYopVvUev0ElS{@-W{F=R?(X$yUC?vCBk=c-DH}{B)@nE5>^In%s21lk
z2@~M5&*6=E3B$ai&@n>GQzxR7_=oGTHIh4Aj_KUzKtjf#{CT3GhrxxqK(fSa@o@};
zY&G?IaN3~oGP}q!f7u7aOv_`;4e|llcpz1|6m>rUWqA05)yd(DtY%{CDdke>FP&!6
z@oTb-3Pc_KLO=!ZW$!ePu{?lE<bYO7<jo@C;&_TJFA%@05gVVlY4c{&mM%NRm^nKa
z_F`2Em_FFskIfTC?n<~-o0XKs_r|cWIl}cXEP&JceN?Ll^y$(zVZ$<*l&fG~z`PSr
zjy=~J?SK|do+y1mc+pxNh?$w&2Win(`IL041Kh9ia>MmbbHLBS{hr}hG}y}qX?GEY
z`xG@7nXa`EvhKgoIzMKVX)geiYD!ux(DowYs<OGYJSO6EhE?$~8Oz;f7Sab1J5|9y
zyL5wm@=gE0Q<y^l?aOs9*AOa^e=FR^|KRaPo3jb3C&6mL`WX3^nt$)?amu*M(V6ox
zB|vuhMdrQ#4litmWH^t0*$cNMhWY%5!>Eno^a`Cks)`^Z#RSGZbg4xqOmKyXnd+Jf
z^6rjenJh`1Rp>xzOSJp`uY<*&oQHbNKLO-sc%+iMZn;t%FFRZ5v3@rOOUeu8noELG
z5;UE}!*M&IQG$k<@yX(#MI?nN{eP=H$nX7yKwz;=t2YwfpL{!=;quIWQOmW*yoxR2
zf@PKAfyQK$0`d6i(~(Bn`lOO<6mM8D+)6;fju@lbBupm=UHdb>h22Gp;^r|c1}6Q7
zu#lNJL}EO9VPK5hzv~=~)?Q6{OAffrb7qST@Ej$Q<mdC}!Oy|G3!HddXa-odAc3)O
zhxna%M_7f<`Zkwc(!djl22}(2*vS*2-+d6AFQGnN7fkZ6mtkYd-j2Awj!O$T-P$i;
zU<Zh6HxX6~;>Wgnlz<kANsiJs8pGlasfus*C(o{MgF$p?YF0LKiD~h&$v_&EVIOg}
zb!ulC2^Vz42=vqa9-f*Um1n+Etpj<c6huG7%|UihE<q<h=Wz+;rm7G5JMBV&>4w42
zPyhlh{$p&qFH13xD<P*Jh@t!-@gk<>2sD-I6cFR?FFGh%ey%0T<b8K)97p~dMv0(-
zj$hs3)#3=d<HANNW97AnmLGWdu)@Lem6W{H1H;LMbglLAhJv~lztU+)0l?yKw^zXs
zC}og1U@ge#fP%(mZ7@t8lw=yZ3m|D(_9n7$6cPQWVZ-2!U`IK6JRG8H&UqYtNgRko
zcpttzJvj;~9lWE=g*GE_%b&I>=@O6I1$0^|r4%n=JEYai_s7QJV}!z}EUyH&!-*K0
zw}y3VlWrXljbZCFV`~}6N6c(Mr4$8{%z^a1<Cv+IJR6G<w!w`|pIyR9!EY_gP?)un
z6+1t_#~7!R$&wv{ZeY>jFzUG#?xDbSI)=s?-L0E#x$^}Xa*+>+T&jSKpjuZc)|FK+
z_0^TBW)cCA?8te%N8jaX&@E7~p;yFqeg`_u-39873Q93U;_L%V^k1q$DA8_fA_2kg
zEEl(+Wdf`*7@s<i=*QK98Mx^ef!aUET(+}sT3Uc-H61_*UX0MzFq7lxxgr{zA|-vI
z<ifm!G2{0zY7c5!17Mz;6Ev#iqrNtyC{C3eIwwJFaaMqk8Kc&|vs?<R2@v0Zd|15A
zx@jJWXj-SxU5P$TFc{z(5w^4Q^&6@254B1{>?(1IQgJ$4!K{Y?ggcu3kAbWsy7u5Q
z@Dl~A07!=%<Dd)(Tx8#~kvq8<9$u9UQXh`Pc5GLhlpern#n6U;I_}5u6@s(+cU$lw
zqot=!{3?6y!DE*>ldl)*Q|3u7M#2DbD?}e+$gb?^uLO8Bw$Yq2XU5Ygb6ekyO0tM3
z*RKk9GrY!!BmrgJwn>cTV=<wB+Dr=T_9gV*kQpBqmsoQ@m9*V&4WR}Og|g%;y^n6k
z)4NOaUsK$|Vb_Odz+A8G$X8@u@J%rb36@SRmlV}<)$7&WON7$)X$}lybqjLQhCopc
zvbo4qiw*UADRW`iyO@|!3|MO;Tjg{?KQ-={9XR*p^(dzRMcR4`!<P)t+u{#)vW{`x
zrbp3*zvd<AR0ET3GM%>5El>^xQt_I_=BhKAj@63`(g~9xKz9!`3Pg{hwzV!nUNR+i
zN4CGI^oOi1NdtBl(^ennia9Vb6A#JIsN6qsmWB&23t%N8Pue#kf9yyU*EM}9@YsC5
z&;kwTvTP25dtisboV>`}>;68OSIPAU(;@fvvv3lkRrdCW7M2nQfr$Q)gdR!LG@KW(
z7`E^l@i@c<kL-^e)MjAiTx|#UQeDXm@RIZdWWZUuQRiyVW*wOqS1(9`ycbJE3^4Qu
zWpO$#!U;#-&}Yo_uUx!dYqp@{W0ZhPKr;E;`&v8VC#o0sKWj!l1bX27Yk#wW+|D87
z0^=iKGrkWb?!0q<p;}c0tJ}P*(kqou_n*-TgU^c{hE0v$Q|v;((RoLDeF_4%Vq}ja
zzR6Elfg{_zqYGN@=Ov2UeHm<{v38Q_B~x9P&tYNYvAVRNuT;ysN(W?!!>D%|Aymy?
zqyY4U5iy*bFsSVFr(6wSevaQIYHNk+^!y9AdiM7!J_45>SO2Z1YOcSBCfB;R^%^HR
z=!jt59(nn2&&AtVqhmXiDKz*-wI-Dkl%}JO_%^o!{=WrZoyR6estqn~Lt&VGT|4&u
z*gLPSf)bJUru`&BP2ho6h^RK`AO0VI^cnPBCG#UA*sTSX+FXZm#S1#H=FjZ~@q$>8
z?pJKLJOZnv54A0MUAb^FSEoDXS#d*oYK)ezH~n6CqeLGMVPRrLi{3t?ZmxQCa{~OM
zt~zLKgzW84aNnTYqp~bfP6N2~r!v0j?&Jhc{2C9hymM~%W<NS2DbzYsqq^8=ilO$?
z)K(;388&BoJK@s}42cKRU8b62{7S9AeSgV`#L(J!II#2}q5(jYz+~se$Va4w!Spuw
zB)YzOZ6{LY7b!q7MRlKbp)pR)_)9qFAGPyW)zB|2p`@j;E1#B&Vj)|X{YZuI+a&t{
z(4Q?7a&1MZ^NF&0x<KNZU9T*)R6#TrxHG6rxIaI<8!fsth@#f0E!u?Rq0f**j7vhF
zK;-9XNh<XGnQ3{QkvEp!>!LfWjP37?K04%gEo@G?aBE(w=CF2!29bl}M5X{oY~3|k
zP~}?>L64OFE<#7N#!XjoD}u(I51G)D1xNW4T7+sid>tpdL14ZIK4a-gNFs_-Kki(G
zim&<1%JCe^|5hLssj%fn8j2EB7tKw#o?PLoGXdCrucR1~Bv2&}@bVcz$q#W<QtU!@
zo6}w{tvkcqw^emTJJBdfxhIl^SIQs8?znl}?;I{PcC1%(A%@nC{rYd;HU67ip<{U#
zTZUoVkKi9p8cRUvB=c8eCGhfuiSbm#Nt6qGOs@Z*FFb><YWFx^$(y5BC?~gN=9%v%
zNlz`=GSy&Xja17yfJpWoY<o!)Cm=hcn}$6lrKi{B#S3<p&mw(a0XQ<r;A~1w$$I*#
zy^s(^TWP}Ze}A_m5Y|2|<y6_nhz?3X*iPqh2S|l_{azAL2$mN@)Ocm+-d(X)c9~<^
zuembWJ^0QvdAIgEwtq2~DilW-i=M!|EZdGvKMvj3j7;t8k|Xdz6(Ku0YzY91d)NhH
zv(8lfUa*?7CB%|DgTGNfj|lO;z8eVxQg&?1sj|e2?Yz8v*K#GgJmjIBR`vXgJxnJl
zih^#%Zm%hkcfon6uGt^82KFpJ-=|bUI_O|Ji`rKZ6kyc}r&i(D+GHc+a6DcGl6H$Y
zsi1=<ea8uE!P2F6gt8h7e6}-`*$@ko7n}pOz2ui@Wha2aSC**E?DAX{XvB8XJ?a0B
zv(uJ7s&c^l?;|<NBs}G;pp{uJ((s{LJRt?;=vVXvaTsQzEVkNFmM}jSv&$RF_5O*C
zlDPiD>L5Z*nW=t+4(K{tp@QIqUTKphvOT>k;bT#dVS2x^wmtU6hO{BE#j)X)__z)T
zEWT7AhNFi2L1B><fX6T?$%v#+bDok@F3f`Hg)x6|%OT(!mP8$Q(af)v;~SOu8|J4q
zpbOU3jqBJ=GYV`s$q6QIPo;eQ7dj8g9{M3KYuR#=c&Y?n<)AV^IeCE8=d;jZ#=(kW
zQ!4EaL$nY;JSi}A>QBQo8dNj9+STznC3(e}<)%Mc5ruGEu&&UX`qJj<Z%LXDBGE>o
zirj0G4uOCNny;dQPiUYOk73Jv3$-Lq@MOmjoq9iIL4sYCh1Z@ifN^bf;T@pSJJxTg
z_1`^z<D7XW(eD2sf)Zpk4z8s5aQ9ES29BANiU2zlk`xlJdA=6E6CwdHPB_zX9u&Je
z_=r$bo}Qr{{!s();}w-f9O5!l@c#MtdXTwS78{`0e!eyxXJ#oGn}8gNii85LfD=Ea
zv!B89Is*GOC?DA3dUF(9xs0<iMYqUZMrLeJZZNW}MqVm@gp#NyE7Bs4%NGGqLznnc
z{|iCLg$e+i^SWAA%pDIyOL8xSY`O(7pOZ+D1&*INNCfvmMeHd?*%AUB)K<i7-g*-a
z5nJAB5~xA$DHnvFN0*2lHMPGcsS?NTqWba!rsn;!E}QI(&8idAZ&y(_*@@8f@LS2h
zNj8J_7<49U6}Bb8A4)>vtOdQ@)6hpLpw}+6%POS=9qEWdxvh%d>l!9fTF6Sk<pC%<
z&oSE}xdv;nI0AzBVy38+QQTLn#DJ$Cx9e77=r8Jm$$*v;t@va_FIvpG+rfbiCL<_A
zs;!lwI1!Dkb6kct4rh(Yk>t@*s8758#OSNlzKM<M2HzVB!N6cLV-j|G3?g;^mT#cH
z-Q~%Rkge)p_OBSWY%>6D3R`f+kiRqT4ArV>)6lIXEo6z~@UPAiT$$a}mt<aY&4ib-
zC{!rvfy&MgNy>&l+X;O9b0#R1<T;g42OH0(mFE%yarn4H9o^7^IxavD=<Uqp;%MZ(
zBHVD=&8}9a?wC1>k42D<+3#(z<o1FnE$Z9@q-!euxOf5xR@Pu(2oEsK!eyce8YJyE
zbNQmYFsSo50Egy-Kbl;Oz+h-XBzpg`?=BIq5c(A1s(f!%X#EEwVG!#7_Vm?#;M@br
zyuCOtPhR<1Pj_480fO~S$5>GcFG45xBWwOOnCE5EGMOcSGxyH`h4f7C!vh|j$&udU
zGNmz#xod8A17m~1qFL+i{U|L$L}IU~7pIbM%Ixoq#B<dk${(X@AeGYYjM)7NPs;Vz
zu>A>f<l>7l&Ugolzo+BZM4Q@QfTfnB)eqq?nif105z5nh3z54iJ}Sd-_2~SUh~;;t
z*1+cW%rYYLtr<eL1NqfhHmgJ1r5*~MptO8Cv(wvo?g^ULkylY&UWW5h{mo@$-M1QI
zm$Z1|kx*6~*@`)x$IRR+{Fxw6*}G{Li}N&e!yyG~;B=TetPork8sP~y0`P%3RAJIl
zIdR9kmLVSp9ub1$;h@VgDVs>?-UzIwY35FDIB>UDV?uAPI)Q~%dq82<ZO$GOY%N#y
z=C0O;^PC87Ln^e6^3es|shD`14<?+SvCMUNet9R<HHxzAXhcek-(u*ZqvRI?5VPZa
zv~wf^6LkPfj%YAS$-Jev6`x(k<wAy0@#MZRnE=KXb^6KXgC=P`I6|_qT4r9@kI#xq
zbNY?GmLs4FzoKAUEuyb1pKIkIO5^x5DF}B!{ytqc@m_%~@fiRVd{R-`k38U3BIVGa
zf)3SHMW9I)9tqA-WQGvSAH}92(Q)F)QFV%?X`TKb<~#n_FTf~8{~}LG1~H3xi{1>H
zwCq0o7Dsj{B6xXEcCyd?dsVXajGI5Rr;7MLw1YUjXj11%c^&%jC=ED71X)5pEWiS|
zBtXhrpHUMHvV$-9qOSf3|FEE37Zd3BrK446=TKFn%HWQwd_m#IU2tn|rndS0Uh$Kw
zEN`3;Ydf9o8RasLqXn5|<8gyQ@!;CI+vEOPc{>66bP&-?+kBsqHM9tylram~Jp7=N
z=4<=XEvBq>+@SM%2xxNy(OG5Ur#nZ4OC5yTXvLP306fS-tDi^+L{97)Wwz$Wt3BTJ
zfe;2WOPDAP#Es%rb(MG5U~s~VZaMyxQBm=d2MA{GT=XiBkru@0SCEp10`+p5ekT42
z_T?{kLrYjJDq$NHI6&uuy$VQ@B%4E;5i4EdtgO=zx3P7A<LRD@D7c5<H(0fYFOtp5
ztc>1unu$I3L?n2A!75}XRl`If?h|Qc1U@g-P~(%uG4x%-OkKchNrE9gN#GVXnlmF9
zzKAx$-Vw#qf6(U-aJeTBazw{73{rL_f<EpPT$<;U#@xG!o5d3RLCa@S+Dxe&?P&9`
z31rH8;Ldg?1Q=rpWyGy$ZGg*2myrvvuWGgs(#RO#jI%1G4p+GV)v)RNRV{%;q)yd)
zAtg8&dy$Gi)-MDZG5E{=bj5T^J)&zTl5o!ZK~U%3;(%cIS=tltUoY&5$g^&TVk7Ba
zFsxEkX^Pm;9l>+(K^Qcl@HDnGB(u^0<pm4<xCnQ~$WWl~#PoApbINv3;|n%e1fRcN
z|FCRlANG_Bf*V2WDgxNdCcuu4s3F0;jnrl@_6s<fA#0U9?l$n0Kx*vf8{q`r%q64h
zW8g+y-c>@9`8!3MKVCyZb>+Gq)5S<{#cwD&SYmaS<}NVZ8vTM*lZXxdK}`xtVCN|h
z+j>Di>Ep1yvJ6&XswR?V!42bjy%D~y!)-iDL~a^uUAh-B^pER}X@N*sn<crucxctK
zn+9>0WKf%{P&H+i1d;n_1=$_;Qn3yrF-_zg1gZNwhiRm9^uHy&e?uMAKFSybMGr8r
zn5D@Y&G|95UGnVy4`S6IWAu?*y6~c)1?6+}wf$RJCAlyWD%Adnj#{CofXOKuyrD^O
zYKBF=*s+rv7#-JN4e1z4v7D90T0~d;p`c1t4v6bM=T49M<DWVWnLy<F5V@585>;VF
zsoYs)kTXVX{fi%L>x#YC^E;7lTl2kzCL4Ua|JI3By0~tYzCKHqQAa@lkSbrcTgHjs
zQ3kZHJLu*rUmM{vF8gFw$Ab<mmAnTw2#$^4ZN$&dpY&VPos3_NJ`89>f@5HR>41H(
zs1Hg>njhBKv4Yc^oC$v;0@4RWV7iI^9g0el-VN@Rw;O9mho7eHGcEt|(H*UR*<|+B
z1Jb7CF6Dw?tHqqywuC_%24jNGv1Ed(hziHCf)j%M4uVEKTX@XJg-W4sd&M`ihl@aT
zjfh@qM+`PN>F(3{)g9RFi!h+Rn7AG_!Ey)N>6nCEjd1K7RKS5vF+w72PeV<PYd;7q
z#cP;ID1@FA2KmiF33P!ACN>!9ie_(QRCLoPYeOF=887yB<ks7Bw9uISl6ZBb@@#Vr
zZ;JNLs4gjQi(B}CKq6?4WCip|!eU8Yc;Wk9?w*r++gGWNDuZ*B$>-c{5x$*o?c0@{
zY?vg5flvq(dJ|nCUtnLYcBf;?F+E#gsqcYT;{mf~YkXQU!Lql!^@ZO1w=_dE(M7)i
z!Q2M^?_t^lY?dOUcrv`xi3p<ddnoL$Ua<Zw0-?S+_lvSP=qSK8?0%QvXc~I$aYyPD
zz(YoQO^ltMmWq0W@T0^-VBgOuw>%&3p~sEe@I{y%{f3xe-tjT|UW^Wf==Xl5WC7E?
zF6t?x+Ez{)>}-)rWw?vCHcL>wc40Mho$3?%W@#(y39jWdF1HKZ)`7={XfpGs=E`W?
z#YBX20nF13;z!pl@+h+=@_m&vl)4pUQ(^FdAh1kxoXYjo$kY%&zOF4ZvZ%QHZM9z>
zL`4|-(T_8AOl=DA^V45CfzSgwlc56emMhY?_&--bnTPT3(4+X~{huidI`2J{PO%`!
z?u2?wgbhyO;5}GV1-3+bo*aBd?H%erHv#fTB<A}mI--<(p9B>-s2i#G{DV$GtF%N|
zJVKi~w*=`XKR+u`mde2o2G-s4bL;+KbE643>0VorlmZ0YN^4Vb)IoXLfi&aGT?NZ-
zeghiltqierS)6wxbQy5{V8d|AAM5L@!C`B_UI8y5=8XRyc>50-lL@IY*@vCx0(@hs
zunUxL4PR`;bOPh$LrwrvggY!>%e#XRcQJS@RY6RYaD}xyM17pZ5j<PrsZLhH2M%Oq
zh2Rsc0h|{Agub-(<zbVIE`p5mhjh5)a)m7cA<J5a+NP}$msx}%BD>?>oR#ov!m@i5
zAIvtn4?AK*$eEhW!9(qhDxhvR26&IEz>mD5rXxuI#@uTe@N0g{=gV{bNe*GOO&RW$
z`&h}xmq|RrLeQs{+qb0u!{`8CU%h&V*6lUO7=}~90r2DaAK9%dOk1|HlNuY|kPP2)
zD1=hMaLE3eK@ZBAOMK4JEikWTC+hm>h9N|q&Ru@Y3p=s4q#6XgpmfL;Rq9F9^{7E!
znLgdr$-MxDf!Mu3Mh~=X=U64oDPN@$yvw*l026D6j?G$+|D01$cI0>ykMbM=*zb2v
z4l8->G&}1z;^^SqX399KJ>p@sdt99f+nb7ir1m*EM|Qb1P9fgjg{>!};fV}ZtsskZ
z*oj-wOb|dJ0{{d+uTxKv_^&CysO(f(A<gvBz4;{N&;51#8jU!QL4JE_WEp^&uui+j
z>&)wOtI^GkqF|w;Y(>P5P0bsI2}cW(d&RE?A;I9l!%bH20eNk0gx~lXKmWBd^lk<{
zP}21rd0DUv4`cdsOvpw5dSKE8EC=LKZQo)$$!04kgGA<@SE+R|+FeBZF87c>%<4Tb
zC2L=bsspKTAI~if7hySJ7AwV>3Zp$U;FGbAZYnYR?81!#1Uz-fF%vx5Q`3@x6;l}#
zvy0dd;t<wwC83r7nS>GhL*-y&RD+XK4?5jV__BWPo7JKX`c-0XD8gDRn`|oHzi^X5
zG3^xd+(BjqeP{Ci^@}TG>N>~Pht{&?@HcCPVi4(IeU{OC`<s`7-!kXobcz-N7vU{2
z(SPm2Rs(@)*#o@5u2%uQC%vqefwKXHpsg>ZT8sA9aHq4h#z%s>mY*!|-twTwJUsSl
z7EAvdF;)>FIYa4$jizb2Q$xxXBM;~3>kbHC7nqMCNQ**&?KYlr)9fu~tck=rUm}YU
zURCOUnla#m$Nr?GeMTX%`1RtL3(q<yRW6^asgwb=uBB$)O4gAml(PU@ryrs3EDlKi
zk;`V9Kg`;5pYbq;^`KQD&q?%OjzaJ(cI<`rs%k_P!B%1WvK&`9Rm&sUavImSwe#k+
zmmGyrG7vz8v)_Z-HllE_mpGL7uBx5AqM6%=$8OYo_c<ZEool3NcM|jZn&_%N*g0wA
z3EUv3$`(Z0*4(kM!LQ8=gHne%c*7@hA1hIxQAX_9!whtNsvw1ljr6~iJz3wSYjw)W
z$`=j_J1NRQ4B*PIYc4KVFqWUok`pbTfWPsiO*2_{_rE$5<o>~A7<7V5)>fJ%Djvwb
zq~LpuquTusRrBrEX6r#YmRNxfw;@7Throjd-KZ5Ldq{_yahZb1CGPT;mM9GW_N@*R
z8rp=4&;k*OmJXR!+ZLn%_xGgWo#xDnbx*y%Fmvvsw$F+3?J|YK5QwW74IK+FC}e<E
zXmOoqi-kPQp$&w7!8E3Tc||ZZX5I?_hF(BRVi>fB7+Y;F)_-aT3}4ygKa%pzNYBlD
zjK@b-nWi<%TY>p5b(0MBP!O3}28~MP6`iMs$Gz;O)^HfCz3D6l4iFuUbgWoo-};w~
z17`#wUkPki;X#kTgK6@Bh3Pojg4ple2r`vEQIqAV6gjLOVYp=$PnQ-A6Yz^N(ZtLq
z)ccXsq|SMoq{o#A-2LPKq9Zt5T>vTIaSgVSJyfjyaO#MSI<SeT9S@<^@*y%a_1vqx
zcpJZ<0PGsM0++VqZN>cQd;5yHzJeQHy{9F@S3?e02pQRSV;~ewN^K|(^|KM%x8V7-
zo4kOsuCvl!J|F#=<uUPpdNvM`2SEAE-J7;SLkz>6BWY}ALTGMFrc%b0@W!yJxNp2<
z#`lRu^)`;2X4Mt=37J~^(S#3$NnwKD@UaBbT@KNi1rycg#T4Wu*zX{mA2e}GDA&+a
z>JdjPu&T|mOCvhP7pRY|GRWzgzuW>AJ=!b!Vn+9@^>VLBqVM7aem_ylue>09R7M%a
zAdMb6;<FhWzS0_~Ntn=x3oY!}U-<MZy#N2n9C@R+h#REc9r$;=wf*Jf>|3BIfsn?z
zxRgL(o48%Nr&N>K>j-unu36gVz_^-VX+K;krc(Jgf$JOu)>J-)S;AA^m^QEOYxrdA
z*z6Du(zSo9JKUgaD|248TxLxKF}OF?G2^8_E#ph@dkQ*mi}z01^rH*L>{T=Ob++w`
zGyRy8BU`?M57Uq%;n0l~t1a6SLj{MQuN!V=M`v)1<ZqwXNQDE8y}kgISkIorM1y0_
z2_4Es6Foo6=aQ5%o0`nSzzPaxe7IW0D3K~J_@*fVGPE!lrjNPBfd)iA_9t2wgZ9}l
z+!){x`DLJ!2im;wubCw|3AJ2rFn{j|7C|IZGY6tHoa1>nG8hUh^bXT7MznXb=Xr|`
z3ukcWg7_Yq_fJj&fz>c%Hzpv`PFIAYi<z3#lg;G2G9(?hq76FzdfjVrh|2NpUXx9O
z1^|v<#vOmDQHW}3a&$D)x1~`7&$+}MR^`nNkD@i_b)@QEj{%}lg_o28oJpPk9kltw
zzo93$VRwj7T&+{@&<6$Aguug*Zp=+6lyXD!8aZZDn$0C!Q=usk2^5+-r+go^`)_m0
zWqJ<e@U*&E2;rtZLEQ}l`UF@!J>~sVz#kXl9!vT9*kPD@Pt(h05Qb~?w4fJk%{#z)
z#0<>a{B6UF1(-q_``7gXBpbZD4&^guwT_B;{S}9qv7iRXbKS({9$@&0x3Y`R*kiH4
zmP~xf+XwUAWIu|jH(G`GlsFU}dPEd`^Yjt?>EhO2f5OaNl#FB#vK-2`9)^ruYlc&X
zY0gkJS#6EKY+)X(h_c&KcbAO2?U-GreUbtR`%Tc~o!A5dh)d_V2FSsmI*vA-bq%tC
zCn~>N+_@GTS8elHU?Ak(Yhgj3U{L^WTouYkm#x)QG`n(X3CQHQolC*jj4Zrs(Zz||
z<ex9$)d!!ke$*b+8Yp9WCMb3eEm(W;AbD^GyEf(v3$zCspH|XTXv#SkST#y2_~U0u
z(Db>ej{n_WeSlHom)m$IDNe&Bh}egXFvqL7d9caoXWe>DJvyH}GA9F0pstODdjMwp
zP-6H-y3-T4Eht*C{?AaR7oH~eL>2_&kxU2;*mvBbs#7JRc@2IyPk2HWyqd(IgQa&q
zA<~7~2pDXFSJ#n5W&rk4BU(wRm}12J^t>Go`&geOIf9IKprZLpj4INfL&WrHLDaqx
zb{f$a5ByORByG8|#Sgt6ZRfTq!>Q>LMrXT8)*WaGSP<xv_p8kTiDC*-OvGT!BfcI_
zPYC43F4!N??K<Ai0UKWQkUPMUSgr}KmRY&{vN6VM_TzBVQ+xP@Wp$<8=VGTv)g6KU
z3Ngd1Cu{{<+xU=ay4WTTlgy?jb0B<hWkLH+zAzJ?A$|ove3geTfUwjY@V&C`6FJ_b
zIou!|PQq0%i^JE;TF?AhMKQ!0x`!*=k*BLBKMGSM%Y!Gy%xL&?J3j7};ReC3*cp}_
zk=MK{3m?hwE^HsaQ)vX-;`-3FF~Q6*FTg#jV|l_1SLFUmas%)CpImFL)ZwfK_z{RP
z1@TP4*9-AjO@{zCK*+xWL5rjMd?0J*&VHvOP$bf>6|$%DHrc?&X9$CeM7i>WfrOZH
z#3!Q~x4F~&7Bz<fE9hSU7>}PP5fY@{vdrB=w(`kPx7>YSLl6~PW=y))5}b48lkjOy
z@0@MyA5V%c6`NJ)Et*C{Z$hkXBos>np2)p)GOWOywPsS1<V42|%3+(-Q6}HZ9^%<Q
zlXH{HNe%1dffxi>`kj$wo<K{Y=9Un(WU6jPO|1A6@DXY~1p|ZJ1s?5%(K(NAYxid|
z&-<<<ewwt@(zH+$_{-=S&$NGY9AV5k5&oqd>|hfu(o9kQ^a`?iJ?16I;J31S^iH|D
zC=v|xd+jEs2^L-kT0JE+Uu*f-V3-D3>5jtA4=*^oWgZ&&$%`eFsh}F2;>g9CE0zCY
zK=Y?I`p*fg)IZvS6l{h8FOKn5=Fx-~p;_$-|Hnk4Z2^og{RhNtf|_~3jd2vfG;pT&
zkGvI=TZ-he0(XU<p3!De3>b7vX?rW6f&ao+HI&;Q7+SZ`ELvfq_92>ZPeD*p{*2SN
zb&n<VvcweMyFsFFjm;SVZ!hmoY#yMMvhdO1rLBd`i$v|ztbZ>i{|M+J9OgX_H5iDP
zoi*NMNY|WU>svv(57%6cmkkISp*Fn0@u29i#vV--{eS}zz-PdLlf;RG5oQGHd`0Vw
z$Q&R9z=a|#<1UsJC2l-27E^`mN%&!S9kH7Fg-J1{HSDgXWsLKWu!o89HNvEr58O=O
z>8-3pzU-scdBXJiAm>ALQZth^gj4{10|?jVLB{+!JXRRfJqE>b{hW0tfr+SJAW}3n
zIpaU$V(s`W3z~7c%Aw<!DV!O<VS(9z!Ep~x3y_2k$Kj*&sPX!phn4BhGXwO`v!&bP
zhB}g5CTQZOqvfFi?q(ED7r(~cvDZ^#-*jT44dBtas~71qn%vK**Mi66$QLF9gbXtv
z2(+&*{>w7V*jQOc^Y#uNJ-;TqcgWR2Hsq`>c#$$zo<JltYnpr$)#-+uvtgNOnm5sR
zPT85^i@!Tbh9MW<oFM`1^Z`J;Gvz_<H+DlS3)nu_m}}JOA4t=p2Sv})mmp&C<<l6z
z<rO_%u1gr2WSWXP0r&K3nVmCbWfu264(gpE2eu<znc}@9mQs?+9XeQaOWkxk)ElkF
zuK<0#Ls2p-Ci^Flk_tlA5cnyo$)VXM<@JQ|p%2}O;ytN{5T_C}erSX)`=w=D6HNk+
zMu0cQI1NE`<E{ebmqYMHLZeG3!zM1S2>HvYFBM^whE4wopTPq;1R2Et$x_NLwvT^l
zW{;j$`z~DxhW5p&oNPX|e2pD6TVBC<wU!6u)~DXWCml(|Qva$hB;|GEtC;3=C()(u
z|5Mu)1S5U<|GUP!ju^unXpl~Ei0<^jQ92UyYO~anoY*+8OK_Y_Xb*QkfLa)ipaCWp
z5gLMuB-v38Xkz&PJ=mj4)x-#pxx<;B>HcMrsxL>bsQcGC|M)<*8Kk>HcmDmMR;ueS
zH%pf=nmtn4qt7^0>TR}rMb!R;H+8P1Ea$dv)YY|@RJUrOLk(WAk2)B8`Jof0th@kG
zeSW5S;U>C$*D%Y##E$$y^9vQK02Wql=Qgq#&u`@n?<hc(?A62XBMpzkim6#QxB`^c
zjy)Ugwcbi`0^>)++$xRN^59%Sg;aXtpGYqk^%o+U-T66L+f4|{hbnT+tgcGPx;<hl
zM9vSb)rPD_CBL*eMUV*$E`vlQ#oygKv+Wl!oqo#c(|(v-!`O)|FQhpBjmg+733y(D
zf3CCPdhgAT@~(TTkk^3NL3Sd;h8HEGCaz3hxKeZ?<jin`rZ_k=k{3kobl%2m0nDFm
z;(6%MXPyFT&9UwyhP1G0$`tYKqEI~l`9F*qg4G-G6i>o16UURW60*;k;lqq6zI1iE
z@{CJ}8A*Nn3f^|Iuxc52;5XEB<Mc+qpz;bo@UnMatVQ=kH-2?e-4$s8vcr*He1M)y
z>O^A%nj@H2H>K^OiyaO-H42#F5iBL13)>gSMp%{>j;rFI3QW@LXm^iCtjE3yWNnnm
z3MI<g++6=55nrjLHNF8il)&VXHiKQ9d4UUnf-3m@&re7(l!EuVg2FZUUFGdlFOwe6
zPeDi*!1%s}shZ8fJKw-x$DAKWBI^p+*y~aTW0mYjM>7g83DRC*x}$016%@N;{HHZl
z0umRV2r&m}bz)Jh;}1dQ$>&MQI`;bX>?%AZ(`jlKL^+xi7R;Xp(5OoyaIPP)S2El5
z2u0bsfyB8sWl9mbfUW9Dn>gn7!bABZ>4vjGEsmf99`~ca^hdP2H7X?)Sgv9qi`Bjv
z+v#xQC?nZswh>Yn9ht*%I%Oi;duNMpZLZ8i8doJV@Wq|9%qYkH%!Igo1Zl8X;>5|2
zRLFK<>WBCnM*q`9kfYW@W<hn9TGem))bQW6n1Pt!=fw~j$kcn|L@Tt{D8t?ewO(D2
z5(;$e5T>=g4M$Ie$po(s&8k@7Ty@IlaI9iiwutN0$6708^-YDNUnGFU)23SUv(iR#
z#VUD%z)S~IEiHIa^Qs1R>iusjD!8CT9x%^?L394wf^V0O=h^d5UON?bZDuC8?6|nZ
zFHq7e#^>n4XlxSk?qzfLhi5044sHYP1gwuGXqJd;e`O`Q;5hJajXi)eY9`+$=VTWI
zVq(YMMTBB3{D;SPA221vj$wiGsM!f$auto2Pt_~d1Yi~@KnpuJEawCz1{^PAx$?3c
zuD<&D`Ffz1@vMKc^G+8yR;`ck1q>O0omT}Z{{=q4A-7@MF;&^ftDMpPkvR>J2sU0j
zih3WxA@f*TDwE$G(!~(^TNO4+)=bx0<Yr%`n_>ewd2DS#-*Sn&-;c%mk=>nKHcuIC
z^^5enR9~*xbEs-XHc=!03A-aMdL*?k;*)J3w`1~MUkEn?@yOo7VY_gCNhf0w&W;}j
zp3S^PfHz#@NQPwE6L18v?VJ*l3Job(QCn52^c&-AWpshNtn0y~qxxQ4M}3zYx4s{3
z-JVsgj(<b;(4iA3=>L0pe7U5x>!=O6gxXPobuFrQ%FC~*6Ry^~pha9ew6z`7>^A}d
z?CK#m0;k`(o&!{7MA)yL_R!e}0|gO{H3}P>5}{=v6?d$Z1y~s3ss(%O5UoM=v9ZT7
zc*Qb#IhLl&)45-mfi2&}#Hdp9s&XG+xvbQs%TW0qh4r+SDh%CX9Ha6=BVM+vI5Oc4
zu7EPnDUhx$g-J$S!KKhC?r5xbZH^N*i(?pb0jO-VU0fuMCs3;N4xIg3-%T)548+1u
z0i<KzmO9tfqlIpB56uom`t6@Z63gBYUVdfs5E@ZUpf9*ZGdsYo0qdPNC&KRS10+RI
zWLibtdOz;Ec2F|oW3;J8K7XXyL_r3>502`kq>J;-5}AvMp_Rb2-2AM=4*)?%vzD~m
zQ5Tebot<2-8FeGUS@2CM51sQ%{hEv)xn5o>5;YWG*ulN|0xaWelXK%FL_Up!S=13x
zW^=gT)|`QR^CE`;BOdldsbSLJd|(oBpcV*xxzSGle3z}*xzWN}Y2U#%^yZ1GM<~Vo
z1L>6DR45akT39Wb;yh{&k0hF$esmy8X^5*+lZvKT17B5zoZ3#C5xG1{uIYytt=*Dh
z4V^9}tUfXZic;UWh_R<moKS2(8t0&AEDx49Q1eZl1-W28wHqBBOhrl=?W^##KNvVX
z_4t^$=E(tjEO^hR%N+AJ5TY}5u)jSGj2F~{XzGe3gV}F=JW`?xz%{Ca5V+6nE?R{}
z6v4xcZSc)0oR4=wg4}D|g63|L*ecT{ilcgycTQ#aS61zVAL{r<*cs+L2AQzNF3Gwj
zXgq<zN~D8pzi|yn`|&IXzF2jd9bZc0<bZU*x;h*NI9-U=GK$Uo)(bpJbngT+X&vM|
z0NO&{X0`!ZynQx-odlKHvtA<T9o>$7?>>VY#=!tQ8$6QtxzS#t<J2YJ<XdCLq9ifd
zS+xsQ=CGMVd*e}YjR+|+Ye0E`Ns@g7DeEjUlk5D^19Ix68fA4}yBj&nbJFd)KTtYP
zG@N(c`U=ozWB8t>t3h<j4#dPxnn@Nx_ztqE&{vgA>Sp{uKQpX6o`t^>$wa+HU;4!4
zVNSy;`poZWeb*{<XW1Qodez>3dX3PRe%iyB-J}A7vs%awq7;0z`{o5r_(wROzd5R}
z9zhdu#PJ)>M~lk@{{(gy6VmZ4al=<!o1ix%lEqDO`Ry@AN#Is+uA<sO1a)ZXOE6Ex
zm@rF6ujNnx(^$us1RAnV`#eEUDd`}Jl8$j$A6mKI7+=)WZ62=ZjzkJtn*ca^+=mjr
zq{cvFARq9@$4&Lk(1pW1o5xHD3Vk!VL<m5&s*nuTJ_HKEY%8}ab*Y5nT}1ujpU{73
zdzX_r8sCYnFYt$i5DR$df0uuC@e_%S>o0>JBr*5Bq|Q+VZ&4&%&6K2-4GP)A`!ipH
zep7swdaOBrDD2$(Kuh&d8jdIRqGA{rbMHQh#H30?&n3Jw9i`xQN@HLd{N#Fp`>%2e
zsYw0vgIcQE5*n^{DQkG$_(gv@35Z@*G~w%XkcNYPVO1jhTcS4dMc|(7*j5`BJ!LM#
z!RzIEJ-5?J*9x!Rr#Vl%*sKjHJJoBj!=le#GRfPDU^>Q5mhPt}sW@nv1MP0v;%`8E
zM$zMpg^M`iH;)`5kO~=%&vOQZ9fGu}V}6s}C#=)_6lm%t_iB5#OW{5@i^7iL(PAIW
z`XHFDRjh&v=wl4mf+}{@V~k}3D)0VNde4+F>drG>TL<E&pG(DL;zt7|Z{P+IOF+M(
z!%YKef*ZVn?Ei!P1{iFlvmp;oe#YBuDgV7Ms*_v1-=k3^3*zraht$rRnD`lMhJoZ;
z@x&M~-s1|aH*CrIOiBk#SMpWGc4#T3+&5yDS6#pHCWfBKXp5=roEx0M<9#70kS4eN
z;C#Q{_(<n7)`0II3fLRkn3{c-ZLW<`DDnb&jAkuCH$ruR`p+)Jj7iJLwbDymu~QU;
z2-~TMl${*i(v!jV)##*45)xQ-a#gL^NLSc3Ol6sV)l66bC_CC35O=(hKJJUpBXP}4
z?^DOi+*Y8alLQ2ErXVD&neyBAE`shOnjRW60L;Orpy<9}*9e(N{X#aF@5gB*a#uKv
zYd6mp%>+sZVabPB=6hf)Y_~eQHX0kPsS=3-3ld*HOORa@)UiRGv9S<4e)FZgSk2$7
z=N6`qkC2F}Zwg;4+J5{CJ|(qBToWxlY`qI1f$@e{y?nPlskajqdQ&1iZ=)K_EEdQl
zTWDuCy9;4CGZ|kfLD?00V1w*s0U34wc&jMROR;s45HM!mq?G&g;QWeVk9)J54l&}`
z<+>tCWYcYb>xMzgBhmTs`WRuV|6?Rn2#)O<@V(V2G3T@%BpC4MaSjPOAz<J*%>Bvv
z#S_-8PHg%lCMb$@_T$VH^KivrhfYzIvx0LJO0av2a{sl&2#Za}Ns(=qfwDACqG*aV
z$&-1c);0URUZDisL|OIc$a4FPUIt^mn>JPglB9_#0JgqxGMzm!euP*&9GL>q;FcAx
zhC9Q8;>#Fhw_0M#El|kxWw~-Nw`tH%fnOQ@l<i_~ZWl_n4fXC<MHlIN|F0RC;Q|Q%
zNF^`TFknGPPH?w3VBA-~ek|T_RAN8RJ7l*C28lukp%xE@jnvo}T=zgnDcj~Ma)_f^
zxHZl=o0)wwCRE<pSwAs}?JNt~#6v4(J!VF!)0vLIQb#3%hw80HL_6jqRh#Lj)|zXJ
zTYV3@M$Igm{ebxmoh62ef!yd>8``!-G7sB@Fi1(tE;E>VI9nK=2r(To&5CEr)GY8a
zCnZKK7Q~qDdbnYjPk)`&wKrNjPmLd)%N|h`;Up7~n5CdWU~OFw<;vq2>FuKo+`4Q!
zgt=oe>HgfCZ6(hbv&fPsZp7sc_$^$~dcTDHpI>=w%ME!Jb%a)b&EZWG7PoX+ZCSX{
z>BTBZA+2A1UsNhCGhgpcO-U|yx1Ed(bp-P!`K$!Tw{$?24s9I%-Ww`2JNBBCfXh@N
zg?|nsKHnyS2mTZ}0-uHOJ<6>#-5ntXGz|_0=>TgG?oVS1BR(F|gq@bf0fhaDlDnzU
zwgDaOJB$74A{~tokr6|VftMv0=sASmt8KeRzp$@ZG+d?gw=%?wZp;C;$FIfSbyN46
zPx*@P{)KUy5-UvSZ_Opu2XiYP>5$T45%w1M33yc&j>E@hWYGXKpB{(vY=ZDhC|8V4
z-Mr}OBd99bhksGCq0JB>s|){wGLlE4r~o}pOL!QuD39C7qFo*3N#NoR9ve3Pbh9r?
zB*vzLyoF=;IHF%Eu|KFssv$%&CveS#5Z^w(8#YCc!dBCx`t_aJAM_*0OIv-Vr$6wl
zeTJ4YY=pPZPYL^%gWX@79DG`Ndz2B_(gy9_97&m)Yr?<H**@u#cY@vVD*#0tmCEa7
zkcG&}S?006(g5JHN<AR066GRAIAx!|9K2!>aixx6aE!Gq*sKYLg_xdr<aO;gL*{K;
z<t%)@La*hqOPA<RDFKZifb&kyT$Rq7VI%W@K-u=D`6L*o0#Sr~2#Zk!N3xg%qfTX}
zVv3BsDr}*G?ohwTK1Dqkr5g0A=sE*0U(dB%kh$_!EEm~!&hoDQZeYB_7O&ePZPKun
zgQ|gEA?~-f8d+M*PIX7-h7NUhNX)+%>?|C1S17<w1~esPG$$ETNDFWA@`4(;sWjvj
zE}dB#Y(36BZj%-bzY`lNZe07eHPKR3fYB|Zj1XWxZHM%RicrV-%d1pm;cM9dO4jI1
zW#@<`+2v80OlY@?bavjn`Ugara)MFNNq4<`bJ<oVW2`dJ3QGG2RUvmcn4JpI%@C4f
zny!{_+$CWP-f<z9WGc%`K3Hc2#Q0n`S>ql{gZB^*o<X*fVaz5qY!rv^s}Wa=3VUq8
zHCjc_iQDnqx4uZ9U(JXkxdnkI#PQ8Hsqa{d<`~1G0*51`PP{3a>q4|_9u)kNG;A5P
zmTx(kJrF3mS3FUcN+`uM2ax>@2{Il@a^ciJ1W#`sk8fZBDE}&wRJLI4*{q|UNYH6h
zcx(<}NqK_Xe8h}e_WT7GZwjh5VpHxQ<V^85ivLz$0nd6eHAhO{Uo_^B4hoU^e^^a+
ztGI!jMVO?^V5zHozuT8^7Nz_v8O}+@Z1T|*tk12;Fb_uhKI<dz!e>Wuo^;Uw#?hn4
z*DJudC4e_vtW!0c$<Y0fOuQ*<FASk`bL32+T8l&&fN2H`BE}lZv4Ah*oY@JvG1w=k
zDy<tyb&}I3p`t4f_=%$EMNbVbR##u#OHL#Sl3Z3LrEGjvdo!rVL_R6srF36-2FRUB
z1StLoraP_Vezq$wh4g{@cn=k&t4_{7>`$qu-L3Sef=mFEk~doUOI`1wCnBy8k~t74
zreYGo$nh6|Ohp8Te5SE+=S&1e34`$Ky2yQn(<Z>B4gU^8`0p2&q)blLgBTYgL6Ns$
zp4bfT9Z`H`G&#SRJ7jl41f)5+rI+CEq{64sNZq)OA%BDxBn@nxhGlVMzzy<V98Xmz
z3*eHA^hHhYa2~rrfz+yej47l~hEv$8X?E#nHbu2=7O}3H8IX+JqRC9jQHnYPwO>U9
zHAstLmip94aKi^*V_#_;yhIGOkiZUfybv#^2lq^{Mjlr~7zaruQIfkHX_jQsl^J@M
zEqrn5A%dO(V?Ds;2B!o{-d59uAWSW5?a82<I!C^~O`jr)7m&A;0ABhRZfUVUSfe)J
zNq2~$NcCq~?lPZnO7Ss&#kOr!TZp=)gB-pn1k7?ZGvkfQ8qC8gxbV4xUXw+u&fZRu
z<&_S3pE}{u<Xmp1$7Cv|3xc=UGS;Ih)`HS0o)g-1a2SzWTRi<<(drLDaV**?VrvKP
z(KxF5=>K?CE++RqDEj>*3-omP=^IxHO03ew-RmlQ=f0U(47~jnCn*K-GXPvh(TMzM
zwNwYrHm(WdJg_Ln%$)yPgS3N>-A`F}UZu23Hr_T3!ucJQe?)t&=VULdG3VG)aI;S~
zS;A*RAEk3CGWaAJqa=HLJYEFT*eiG|<ZsJ%BFgL&d8b1|=Kk_R^D7-c`E8>$31BQF
zyU0A<@QHWD(4<zeazO;d(ppNK0JccB92wMDN?z8VcU#XERv|n+Wo+~&o_TXdxvg9A
zA{)lnu-sJvp*WKWD5yeV%mE5${8=U}eFok-;Zyo#ErXS`!|<zw71}XV1(TVSc|Tuh
zKO>Nm$+e*op}Xz8ZPN<5+hLMd74>t-%*__Dv?Q*%^KUHZYPX$+k=y)UUM2@t)25Gl
zZH)+qqTIjhN(wxjh$i2Krz@K8410r^jskf3$~WXs{F|r*ZYZshJ_LJ_7t{hsn${QU
zAnm+HsA#RJ&ir>OgS&YIuhM8-qLt9fSLji0Ac)wjt!`rar>fhnh^45p)7<7@2DxQl
zU|=dXJGCg@{7|)99iM{Bgp;T;$Ny?GO4aF#jeqa_SvGgm(H#~af*pt3co!=v??-&i
zsXXX_^{?`CySzQv0o4SA<wJ6*ZBn60TJOX7&K-c|t{<PdmE&{%XUHh3!N^IN{L51Z
zdQ;SATun=_=`ls>7|pe{Bs%-fTugln;G(hpHy0TTE(BE~>?dJU`TKqq5Xx_rAYC0P
zT`i=zZe&thl9AcX><u~dz=$kH=e8h|wFsqg<IMRKB9GYjFeBEg<j$$MX^Nk^sCVRr
z#ab{YvjOe;%aSKu7>KS0EX}04bh&?0Z+L!a44mEK3KdiHbWcweeI{s~{O}<9{Q$kZ
zZ;>QQxWuWax}(*V4hRgL^yniI3{W-QXRz{W$%p~QZelx=zXr(toy^y4W2nP|SBfxK
zc2`{K+jGYC$u&MZtVc%33o+YZzxf=IAeBDZN~uIXb=;_pzdpL)0lZ6Q0}6{)CVW_$
zEA8{Dwmq5PA324p^v6DC<b|6do5Bhj_?joQLttT<|6q0nWD}lW@_*?oEjkLR9wnXi
zhCH%t`c*KuG5eazvuS*Zcqw7jQ#N^dw!xU&&^E_O2qK7ij-op=*(+3~`^Q{Mkkifq
zO26JgsgV>GCMB>}xTiS4H(M$F8+Nra7Ps7`SMP5?JOUQ{0y@tNY3zSrK`F3St-#@`
zeok4G<QrirEI$JE87Bu~c?pCyRF5-FE79n{zznV&|H$jhPHHU)!Vzj{$BnOmGr9=l
zd#SptXcg?0n+{v!2QGT!yX97?3jmc%vdld~r?2|-2PuKyXp&%jVk9$lVGV)Nk4uSB
zkh%|*MstIC>RwGeRqZa2Z$xV3w~KR=M4Sqe*FUbiFip#JHFq>RH-xyR#k9t5tHW`p
z#}G_?;~_z<@coQ=L*<#qJK6zsQwd@K1lh|d0C*Azxu9Mp0rA`Mt#uA%w4v6zZP1a=
zPZgJC#2y5SeTSW%nmR2>{$gds`|1vIl7He(2#nOm?s10X4zBeJ$Adt^M#&Q7lisYB
z*!lf{-0QN=3_bCPV`av}jjGdp9K&5W2`3QGYIjF3!o89gfMT7dUC>+v(2KKPqux|o
zDmWaK_WEgdmfpQp@GbgdTrhAQ&Tmu4|5Yx>54(Bx^XZg3++vpH#?d%AsZL3iZ}blN
z5LDU6_C5MwH6Orgrl;Czo_bs-n)#1znUZ4M<Zir}51}ESR((mxObkbY6AI8>4Ph5Y
zQZnpzk++S!{!6o$W3FPu!K$R`3M&(Mb_%cO{L&ZE&i&o)OCl$(1FG#Nx~AOGCmw?q
zOv-HIe1>=TBY#V<1Wr_5jJ$WpUT4hbk`=ARD%W}(ZQ|0yMpbCE%pLgtJ%}W@+*Ump
zyxZuobvCDBgt-|{dYXH45<Y>}{o^hPgf<d(XC(bgY{(*R{Zi!Evf#v+zuRS2g&pI5
zwgF#<K7@BzKaSCUvbUTw^{L37R0ABaewdkwH|po&Izbb$S011Cq{A{<1e&t#U~$<$
z^;=%F)mUq7tY!($HC}=`j!^h6j-g1O$n^zq@j~JtG5;W4C1A31z1#Hxz8Lbrhp8lG
zlw?G~uLK7n=ZriSv2xLV4O22#o#JJzCbLbWPE_l4e)rUD9+aP&4JLy+WFtm;KbuAk
z#p#8~elCF1@RA3jigBs6f8X5HHXrK%geZIbmei8TIs9o80Rl}oBfWjw%5uNps=aoF
z@@`$W8EN}Na?%)xgE+~N42pi-3~LMOVrw)uNj?TdtS@F}4M#FTGvYBM&_sIwc7hG#
z7=#_*AR5c4#p0dg$;D8kQpf(h8J46sYi?^jxiOhTFMm@i2b>IRwu^ZX_jHpr+pP1f
z5>9Q<NovEz*1{|l;@)iIUuS(L7~<!+2#C@h)F)Yn$Ejd``V@h!tBMrF9?aWnRdWca
z8WUst)V%5o+ADET;o@&zhmgF+deA1>RX8C=p~@h?^v?y=VcA8kQm?Uuo0UuctTb{W
zMONtOk$<KFVY--LjcTbzYR3UhAH;vL=%Rk3bZ7m{P0Hnagh3`KGqxSH%y<sILD{A#
zUL{arbAI%B_{uzF{CGoyznJXj4Q}1TzWwJly*wjhyh7*-->lfibz#h&8kq`RW`5RA
zyA3P#8W!=-X@$mNx!53o(H&Fc7bx+2r^8>-@-hi5+ogxCzZ5Q4N;e%^1|XI_22!5s
z@VNzJK^p{tqw@<@fS#w^d$z|R+E{`T7pvK+Jh8xdvlMo&o~}I|970vB_cxYqv(`p9
z<J6VlyA7lDOg7FevlY4+k&WwCNWa}H;W6~0K9ORr-%vN_%KQ;ohz$f5%MngvSS$(0
zv2fs)npit8pqdS)dP!h0PvYHTS}v!%aj4G>MYP*e`7Ue&Gb2r5%1eZr=k(&JThB{)
zx@vfKM<u7fu%_Z_?s<Y?)KPA1inT3C9u*;O==KLrB(k0(q!FFK0J~<h)#In&G@VV~
zsv&{);q;IFC*}|J<-3%Qr{uE>>?k2DF1{9k;I7#00e5kF-&2$~n*qd?HR1NwFcc)+
z8R<Toed*KPHL*J0A6=u0JN>6VacclY*lVU!YA26EbYnQVSUf>ncZch^4D&>LwM<?9
zYtSF01p$n2tVZiW@NmJiiljEEEAhfg8yVHFV)}X1*uQCXyXj1mV;B+_mPAR*zLYT3
z3oKfB)Ga1Bl(83<QVgDi1|D71JS)?lp_;L_RI7?Q$Cr8|QUOf_?_0XiERLLmtW%}z
zhuq2zP9bZ2D}g~X@HU+f1Hy7(i*}{wVU1c;u|mzmS%>F#=3XrpBedyo?7of9u9Yp1
zl7~}>iMn2=jBKuODZE=O@AJe8>jdr;b%zk6`<p@UCQ$KQo`v-k%8COPVGWm}X(8^m
zFQ_YS>ijA&;@{$0TJ|O#|9V{f_N|2)w}>=*ys5kNtCON2dgT=Oxio}+wAo^-&eV>q
zJk_(l(SXV}_<=B%33&`Jw*4&_-lZCG)BV0cN^Xcp%o8jaF8o*LUlV(7b?nfrw`;)V
zVKfeK6ndY7q~;3FxWU!(afs${=prZ*6VRixa$U*}XoLKa?mh0dH%Kpx2Td9uw{{+w
z98iCas^c}gS#>h{8l4wSl4B5><%1<SipDw_C4B(lUDOzbz?9tZ(B}Iw_?L&(^MN%N
zsf9kyu4i$SwBwmmV9lZMkdXq`9=@eB8b+AKZ;#|{^t{ZSjIz1mH%RDnsH%`3L20wS
zB7*PyWgKSA8L_%RhPnRl;n~O-FSFdSz_s~LDDeC+dGgy?uZsqI^q)SoWql5%U&|=$
z49LlVZ>cJk?FcVoDvRR=hhoIMtQRbfVIQC0UeproZ>zWZ5Y(!F_cBKe7Ndkk8M8tB
z3GtZhQMz6GW-cr=Wm;~$Y_p4Vs@;cM6#yNWnnjArE$)^)R}s)WpmqP1wh5p5Qi^wn
z;DzmpNyBUg$4g5agr6dJ`qR8)0GnHX8DYZ`k(g}{xl&rMujtaLoBpW8s>X&Noz%fr
zO7oZzCp71Db!SoG9zU)pn1pf}_`4QpK4O7UeIyusqsab*S%jlHQ%pkHDco$8Ro)S1
z%E*9Ac!Y+mYjA4&1!VNH8>+kejz14WgACMh2`H`u5zq38XIuE8ZHX+1Am$duJs{Cu
zY9{qn37x3S#b#dDFPi7qV;%G|BU<aoL}!=N&>7>I$<X6b<)RO5m0=jNcNzTxyGbx1
z>(Bt3eC;GO?jlUt9Dp)$I)nY8(wS3@i3;W&pP#jsvXo&s7I3GpJr1^cB2gd2aHg1T
zkJ!TvAG=;~o7>s!$z6YP$VnI4Qpalz-a$7;(B8Q>C0g5I#hs?UL_S~$yQ66Pj$#(!
z*{_QAP`LGyTpqpwMP$i~VD$1>HdKK1BK9{bl|xxMy!mW>Q+xr?O9VX{qS(_3$oK&r
z4~>z7MHIv2135x^POu9NPfsom7LP!Q0DN7^i{$<)P{S848nRx|6j!X(^T=D@4mir6
zyNP=r2*AN$EABL5LfpmaWeaVL0L}igz&_}Og7*1v&OvDWz_X`4rWdvcn`T7XW;Aqi
zy^_^L)t0~^vPQQUa}5vb$wNBMI;dqak=WK3>8)Fc3C1gEyHdWI_X9CZ@7u`mIAxb!
z>da=_n5M_U7Wc<eo^Y8zQ6h;Jwp^d|U&;B6)jR9B^PIEtj$D_&rM*N%73zkK6U5mL
zTY`#~*u7jc(kBgwL|`XlndE}n|DSt6$wi>j%V6L((wemTI^``v@2@*N@Y6xjSe?gl
z%4zf``rJJf2*WWW{MiI4wwX5pe}c40d`(Yw7+^rYW(JJ@%5&i_nMMt4MrrDPdWqzM
z{ysOD%bBL1pF>qq(Y3D4oW;mv=IL`UP`1|QV_q-41&OkR8T7c7!Y!ILJp8FmuFqiD
zwR22fpol&4sNP|=#8jde6zVn*)?W6AD^&D}f4!n5?Ag<#>PTwtful>zaftUs9sub2
z+N?Vn4C#4f8H&#Vm3W6Pg({<{g(v41vYfA3gucH=lF;emPXUC0TC2neRR!C!y^&uM
zQ(%_Vmr}nI9>6cp|7Ug=xkf7-@2j>mx;Dgc2qC1Js>x0@mN9QhO0-+Ug}8AWu-4M9
zcLj;3K`jzhg-DWp(_YCH#y(G{FG0(BxB8&cX1O@nAm7U!caQV8qmSbv!!&*YHD#S}
zm-5dRuD!l0rRk_MEo5Xkw(H10i5cu_=m@-<%7DjiL#C04o_UIRh|eSXK8wE?mZYXC
zu|gtI{FXBzo3sbi+x<td2JauHOD<*i;M+nT6$l^=UgUo!R|8D<<QzKo1i>doKpgvZ
z6b&SlR%Xard}!<evFM(E<A>J5S=eS|o3dfU0(8RcK?<+msOK|!fs{vuvnI7k2#Yxy
zhksE9pE=D|<Ex4dE)3PFUST_joiB6yL+c+%7=&6+|1xf7X>k^7Rx8pmS|+dFj;k+|
zd`nGD*rEW=y)x%vJ$bt%Deo!j{&((g$uI-)L145PQL0II?MOeFFB(0##u)pc0}^Q$
zeRFs0X1xe&soI7l-zDm~$gLxP;3DOTkgBYk?zATozjYn7O4oYjXwEWXQ`{CwSS6`~
z`9)#&I!KAzN8e`qMKWM*7yL3`+lR2XW`dAis<aGyv5qHQV`6k&M;HrzJvags8Za($
z`9D0{qUziDrBQ<jqf*`A0qV7HfJJN1tf)*g@<ptvw-FU%@CTt%OEvb(B!PKz-LxCq
zGq-NfVu&#W%anpl%zl5e00!3uvA@qC>dyr3BG@|%%3TGxNu@|kBA5mwrzakEQ`X2c
z?u39n$ADM)knn-6I2yOU!~==L38?j!x!j7Om%~eFul~FDkFuxQ`E+ZWm$1;dV*G#B
zry5X!ee(r^C3k<2Qi<3u|2R1{u^gyemU{Bh$OZI{jr#-^;2d^xqGgYYl)Nig><CH<
zPB40m+V<gBm*nGpWPq01R9*5E#ie<yBe<WdsA?<OFH^1tKD1PHXcBG4Y&psNk_HL~
z4v&VH@m{@YhgMx!+#U=FdEM&nv?~@L@}Y>^Bg!RLEm7p;9&vDLqCrL;zp!%jy@-O|
z0v~V@m657K<i6W3&8bt9d3Hc`DsO(l2}yD-k>O7k)WJOC38z}mBBvZ<eyepX2i}4;
z1|wK=2uPF=Htc>MA};Lmlj#F4-|(%>s$VuuX8)JJ5wj$p??rv=rGNW@tn|2zfs2=&
z0<D16Y-%oElL{%8wY6pP-&bR`uAz&Kqg8u<=r+YI7-6%4VDsU@!&^uM0?DK&`1ugR
z*bH;rCn?ixy6x?y<>V+Iak&<zxJcq(0~|k4V(dQnr)YBL;l%4VA5*!2r=?Oo{>pj|
zxmL2HOulVn;*Z*H*&zRb$`%#?l^^vlWeBu(;U18pFCt5i<5NW{)PkSa*n{nl5Uh5q
zVx~5#0^^fa^e6WO{Y`0w$u4xcS+)Nr`TDC3TljR-gOHR@d4ajBj?*KQV7-eB4k2~r
zf6=BXzY&NbE_AL5LwM|Z@Jo5C0wXCMkAJ0PmZ!rC8B9oin0gs=j-AQbc($~Lc&C4H
zFQx))6SE)SxV>kN!W9uPsxn%c)Vg(JoIj-eUtU{!zLf4Lr_jum?_kgLTfzW;bE;mO
z2_&|kI+ZGWOzBM14KjJ~m?iscgm=l?RZMOLzM1U!E8x&afCM`=aAdv)vx_X9q0z0}
z-iuMe+}2+%RYWiVxnaR?+>4q@RBiieMxu5Nk}3F&DX31~+c@EOZK&`MF^hHsA^+m%
zw~;um9)m|BDm?*xK93<^?ItRETk4cDbPe|r7F`h~&}O)ywe?^<MPkcZsJvcEXcS^=
zDB<;%OYemPW+!q138*nq-GZ*>-Q6FzbaaXC=?&&Ta{uX#R<xhPGu9}Dt9<XO;fovO
zy@j@Zd2+GO8VWv8?d;5&5dF4M_;^3SWzWPqnasoBMu%MEWggyCA;UjZLXc;1j6;hG
zkU8A>K3wIb;hTc>Ub089F+y<%`>01xki3{y(1FOSXQX>Xn91t}_uIX)mNTq*%CBTv
zJ7BbebH)F0qxs-RU<teG+8rei(?`}(hV~1*)%+u@?72weW@3-2q4Fz|ng@OwrbV+x
zG3r#IjCmbJw%SASHQbTfDwp+DPcxpoUBE5iAJ;js<X4SedDZQv!A~&-6eg*DMov25
zPlmjlwGP5VDN)E?Xhsj%Z{d43tIfbEKGUA0m%O4Mq%fwuWqTERpP)F6Y<QbG|J3lF
z=otzXku5b0{<~l^4y=}XG=@Pz<#5f}z(OJ}kBhCvf~vy1z0O>dQ8{JV7_x}!&ASqX
zp9#n!&!imQC}kF`kgQ&ku$_0yDXFKla5))WE|m1gVObY?J7#AcTnl4=aEEgCbhp9^
zvHUpEyx*^(O&+DSbB}q$rX@iq9~G|@o(ngn5baym2eS}vi7R<v6*yOIN?Jav{o(9w
zflh-{S1>q|$`5te><~K|R?}Ni|50rKXRyd|2Dk0yZcnL6t@kTArqU#)1*Yi&y+Y;6
zrL*xt+7@EGY69mB4G%ssH^FXFAjV{T;^Gww;p6p0LJCJ5KSB$T65olE<;Yt^*SN&6
zh&zYO9Xcr=HXs#}vVdXxmn?3cd-E$BUQmeDsP~uyPXm_6%1Bb<L63~s6AXu>&Bs^(
z>T~h$1OdrlPg}9dXi*AYIcOaC&p_I8vIrouM@;h2Ha{xa?oF_io^u!(0nk>ti3dg!
zL@Mf1?>F#_&t~%X(nMop5p#e@>(#iaeCcdQi_GE*`0BXKMjy>WG~xtATqwqzN}ZpO
zRNFBfC1yWy1>%(~EQ^UGXIEn#j^50$jOqdolXO6s*Nnrf`X^CP=A%6nbMTucFMq-z
zHst7C_X-vy&2-+?e(#xhU^8&QfZE2Pw^yi`g*$gq`x?20{Gm*)LxHqi=)||*bt1-W
zmO%RxBW;ywnqIH>Y$X^|>N5{A$G(*z^KI5f3Oq+eH^)J#L;pLyuvhQy^D=u3bA%G(
z4EfGiGA%b=k#-#cK>anZ-V5y(`5`bB`?&p<gbl1WSL>YIIGIcwxFI3r+ULbbMT4U1
z6tduHoJ|XTX%ye!Revx{Bd-v)C!N&0U;boF>{943ufD$Sa>y&wOsU?M6wz-XF9W*j
ztQl!|cAB@wt(BC<5g{=Q1h%81r_n&v>NFz##xw^nH)rK*V0^Jn842Kl!N;^W&9z2c
zh+h-yELLp<YyHhLRil+vKJkvCEs4>1oK)_oZ+S#C+t}wA<IEvYVA&8aOMf<eVEn@%
zX{ZY~v9k%r-CUv&FZ&gR^JS2Wj@+vBPm{ID?)PJqd`l7q<I_$RK^}bI&QME(m=Pai
zklH-xdl&b^Bbz+fKb&Oj9%yL7(ipa2gLXV6v4NwEpK;2MP8_4()uwSWiB#f2Dmlo+
ziISuM@{b}MYU|rU+8ZqcjN-+H5|6#%o)kz>tt>|v-_DpiCR{_{YT3rtafF|9B59(^
zVrs|*H)Rg4e1T?j^}bxpaY$sET<z$Ni7QNtnoqGuxZ03a`&z4^r(NQPd)Qh0Ux&F#
zD|W2Bja}=QF&%%bDUSO(de~7`MxjKEk|AR4f;8{^>JR73*I0cJcEXv@6$Kn;@M&Ty
z_<>&K)i(w)oA+b(veU?1&3NfaK@^P}L*am#e$t%++&-F3R^`h$L`g&0rGe(W`XHZ@
zr$q@53SMsLv_n!%EYdEipR__!!#O3YSJ_D~{CX*2uJ#ySbMj!VT8`Uk4^5kvUCfJD
z9d=+#6VbI6`k>KB>&VbSqy2*36MhlL>*~-nJUZ^WUPr;feLn9b&TZ!ryTZxG%zj7p
zl$+pcAXvB!vS<JLCy%~DmI3`A+YI6-S);=q3X1XLvAF>d*#jzzsgAx_dXX`7g!er8
zVLcwibq-fVCd|OaP*(Wzeu+#(-r?6S#gG-`0zwbJvHKg6-R>Z|(HyYs*G*hZq?xAi
z!k9$xJw?Nu{Z77yLSfavWT)(4y#DJ6YY2ISW`7FrVDHkxy)VaqrS^>Ku2}nH(^fYl
z$6{C4WM+6<DsMXjKvwv~QHI?bzKJ+Dd1xY{(a!QgX*Qofqn;u@;5|EXHXjX3tSx;U
ztUnsN^?%H10TcU%>T9i>+$3|I7sZ$@F^h3&efo70_xWV9rE7m5xj%^jBE!0jg%VWg
zTa!y&kTDaW5MK~y1o{xdi;*!mtyW)J!8yhR+8Y`ACj~3f0KH?(u1y|*KDW+dwN>gS
zwnpamJ%Zw{4R|52f-y|Bv^>;3nm1Ej;YPg=&Lz%(7ZIz(Ubu&-6=T{xlv9lLmwbxV
z5e;^=a3!!p4g5?gw=C#7y1V5&vXovg5_D`2#l-?)r(|DKWxF-r!woY{vYUFfYbu}f
z$!TF2BZ%o04*i6-@x)&f{WRO5RdNMsBay*kMa5{0Vd9mfiF0MjXH<HO4iR-qTLb5v
zTn9irm@@_jhffg;oc8!tcQp^*g0F@k-(ABJP(6NFv!Z+Uzh_X`2OVv_75+e4CcChB
zXmk1r?JoV$jDP_w;lc@cvJ$0YMj<Fp&m+dbN_4B!h<J7GhFoYMvZS$!g4D~1?RaPO
z@*Wa(ZY%8jE<5_5iQg9eU5^%TogdF0aRtlYBB0=8IT(*#fm{G0Y!J?v)Kh~+h*>2J
zeRdo}ja&9~i5f_?8{{G3SN<;GxEPqHH=56$H{_<3s>(3!R$Q1$J@?*!?igq1Weet-
z8HufSoCvPJk<HNNbDH^<!sMPf(@$aOM=s4lvu;G-dS$#kH`V8aA1}1N7W7@;Lj>1C
zn6%H(7ea<U`{m4RU^<pjE0{AKVwGo-BKA37taTR)*h`bR3j<|ZBu&T9)j6+p=79%O
zQ61^F`VVP5ffw_q?S1L|GkjPHtjF-Gg`17=5vxRCDiJ^h!z0{vv#xgpcS7JJ4ZZHJ
zSbIq;6tBlQRqYJ|*Ap!L0F@>S>ywi#&N(%?1cYYY61>JCEMdZHyvyCAk{gUrqk!}u
zFR(gczQZT9aE*Mfa<uub`GBnRUe$m}N?e^u%jo+B7J3FtMQoB`3&ii1{I~}Zg1`m;
z5G3FBo`IuAzIQlcOq>{nB+>qdPG*#T%Ji5{FT)8%PXE$=Oh)svLad><tzx+N-h$wS
zwm?@!gQ3iyZ3)gn<7*7F^utnj8oh!I6BxvdD>ua%8Z0QP688v*W=0Ls4EyU)A3ltW
zwBm{dxKnS_q=xN=%~?^kB~+pmkN?8c_W=Z6Kh0tOPXHfVaFg=smKKAU*J_vG^Sw;X
zasAQMfbJcuL24|MOJAvr`eZe{ivsZ|imTB$AP=yBP#wHLYSH{&C7UjQ>vuaX0iEOP
z#K?PHxh{UNUi?VZF+b@9aK5PlV3uX{ILg&6hJ!CLLt~OHHx~gq>!?<9GaU{R9Oy9w
zb65QSyq%NvJ&UGBp4SIgbpM}GMojJA&Ge3fg9GbPyLSvvD~f3j?V!tISR++(NxeH>
zg`(abm`HvbfLf?dFlTSZD-DlTo^{@RDE4>blUOPx*>k3>yEK>q9&u5M;2N`V^ClG)
z2_~paUphrg4BFgXey`7u8ZOjywM7tVi%!L6?EbvHxxElQH=98k-P!JZwLfD<js*XX
zq;^7mv<&>Kixa@bBI~4CIT0KSurtkW*GXocVKYx#(``>(m1Yrr!0m(d@^{MykxVgx
zcp1=O^(g<&T8TN-Pxf2azs9<<>`8-9Q18ew&4VkM5dcRsr0r360(%eb<-DJ?Ur_OC
z2`mq?bjdQm7|o?J6bWXD;I_FcJwhTpr_n6Ac8!a~<Md!Y*LBLP7YFOmE`i9r=5Mgt
zA7_-GJ7Xud<XmYZt%eDm?I{Q5AkV>MAtXzf+p9=)n#tBAdgqAzDgEc1pE((U;0Z|+
z^0W!YQz|OBrY3BynxiMk(~01I7+++dq)<|KHA|di!5{Q53*@`jKW_jpgBm0$7-Oh_
z8f(Qf$yHNnVB+n+BX*T@x_Nl2rNbUN2a*v1_$n`hFwoS}WX%%n?a=t~fisd4NnRzb
zYXKeTl`d(H#r2ELPdIRrv%|*{WV@W$n(_8+n*Moh6<Gg_IyT4~Gj653Hxm$u;7J@H
zs-sZoO<^ln@L&$wno~VM-WE~XSkPoDn>&d<05m{1^DZ;x_C&Gz`hQ5H7Tui}WPib!
zwBewCBTDqSIOZ&$i8bb5T87Ue77aRQ=9WkO>U%oD;Wv(50$?D=V|c_-k|27Qq`s$s
zNm^S9pjN^uOtb`G)m}$6%yb+<_00s&3c0}R#!iF!OVV=6wp*M>w-ZnqDWn2x5#{^m
zHBnMp+F55%1USw2KVBaB{Z^L>AThc3o$K6JHbYYNk^B3|*y13svI7_*qv2#8me+&I
zRFoA-KGqW39rgbOt~3+j%o<cSvLotuDneL=d^59ArXS_?(<8Hey(B~bQnLXq5HO(O
zUSsf^LrI2_6EsEHv%JAeEPj$xBuW_18F}s?JG)gj0q7KZ9qHHo#u;@Tk>@V$K-(8x
zaj7TbdP10yjC%rvHXa_1<<bwSuc|HJm1NT#F=bHWuoBGSVTfXfQC5Qd#4y6ZJ{~|G
zu#6t0q?u_s`#Npax9gu3ru@In{`gn}Bgx<AFrE)jmC?v?+4XB@S$6}Y$KsfZzY8@m
z`4>99<V^B;PWjJn0a~n;><Iw-8|Hn5x~HLKs>Xd3`&P{bAM?mJy}f8j5Jn=tPqCgr
ziWi&@q?8i=PC>3LZu>IuS{W-uSNc3SJ)!nw-`%Sm(x$k}*4eoOpIe4&gxo$AM2iO-
zAo$($r`vj*@?NOuWL^60x|~4;zWry2N@Ku);B{&elM(e=S<`*8X#Lsdna7uA@x^L8
zvZ|yqSrQ*VWX9fDX9HYk^Y`L4IS}ojv2qt3f1)tG<j|{Hsg?XTwuaETI}%Kjqww;l
z$We2oiPkkHP`4>!0B>TtQdC+1qSEcY0ihF4?~C<m?BHQp%4Oraoaq&zz}@7qFq{k|
z54`LT2(Oux)VIu|%Vl$r3^|Xqo~i9p4atw$QvqmPk(r<vL16|N9@(94V*I=FrU_-P
zIPBK8xnn;$;|H3Wn8UJeus@^&m79;OSSu>L+TgW?PuW^~QeZN~fm@1du*PT?VkdCA
z#KK-{Rlk~FOuZzh+eCw1(vC`6zE!VDr_&fm6dRl+uocEvOduuPwqy^-mqcT8bL@Y`
z8HzVeP<>2}!Np4<vxt!ExwL{^#Y5oY5JhAZ6ruxubY_-VBSgW2Q?{NpZ^+Q53WroA
zYMP1O(djRdaVN(s@mj8yjs%{USou6@wizC~k|duI#GL!1Snd+wn}(rF;iE0u7se3i
zSQ!BGZ;Rh$DWVsCx;1tifm_|?;Ke>eR59|7wVqf{o9$1v0i8;;9ut2qjAR$e1YOEt
za`3`IT0v)H@dn|-y~*V9^<gJqQyw&Ao<*oc(?~WH0~&M_hi7f_RFD-v4Yw6|Lx!4}
z$%u^*{f=^sw}bR}k-Czj9lgX<lGO1mntOUU^(p9-f4#DlS#Bmk_`BokMK;sQwV7K6
z!Ro4=C|#fFS&7|9@X)ZszNG59&HTCy$IJf!awiIK=ZKi`%9iuC<=^ozVx^{=6HP&Q
zswWefP^Ypzk7&M+<U%FtfFe!|xW8(S5)?&SDonI8${SHYxfGnZb?ftgIe&msu-dnb
z0BuT}+Fl-`vyNiPvT<0M@t_=~>XeLcpZ@n-wuH#8W5R)et9LSF4j~aP&1dN!XX(&4
zHkU4B4uu=Sr8NjN+U%duW(V9F`qV&Yi}L&X7gS0eIExO)mhWQ?m+Wo}T^ruT4Upmp
zsdupPAKv|Pr$nG5iU#{T8%HQkK3uP*7*aJ4@Jya98v=Wot<0k%Z5peShwSAP|6w&@
zm5e3Ai8co6W0v9B8d*$3K|6K-jK9%+Q(XZL{u{MidsxoI%+zfC$;wClHX~rKI^-!@
zbNcl)*$Jm}5>Eo?Bv9V&o5gbB?+or6bIm`@^$_sov~lB@7&X#1Ie46O;@^fTZXzmi
zS`<>Q0OYrLw%Dt|dWzbuY6Px4g<S~?OmNl&nk8}3pOUg%LPn-!U{$|`Zc#jBW^?Fz
zwZ4bG&dHMj$GK+^h2~V!4ruRDpZMY!<^p!MYxR1iS^ZWBf9v-)+UmZW2NHy@HS>FJ
zo4r5<c3AhG)Zc%)4&>hGO=Jsu7cFC50=<!fb^yKke1Odp5w=ZVS<FH6ZHV6V1h|Z$
z-1b<dJ&#EQQ7tebQo}<CHFmSg%!}Pat}Lmv-mU6yfebD770a_Xh<I`>lELVa`wB%t
z;Kf?MNpmG82*TjiI*!{|b7L=v(xwC=y*ggl8WK(_vSyZpW8Z>x5iv-v4{j-O6TL&j
z^=FeJhRj@aVl4*AH*v{yxA3>Dt3lVOjfzqYSAO~Vi~Z2!pq25PmRCA1)^s?&U0EzJ
z`VV}7_YuC60Kj@ST$7PZ4#Q#&7q#n+Xos*#q)q+0%3n|ds(rdc*XF_^r;p|(P=F4>
z(z2{pMZ+XmhxJ~=GRc^2!qn8*56eU5-|od1p8}~Kq=+Jv`_4Pfven;Oj#yYQawd=<
zaE*1Jm?i;|VjgJ!hRupPX**S)&Zc--N_!*8LSI}<F68-TEH!8<YIH)<zFN0xT-XDc
zt^M`9b!lk(bn?57*6TGn1h3L72_$;PfrJOU5n7o4PBAy7zO8nQIx#=0^BS^E#-bs2
z;d3Y!ONXFJobjpD1|CZmrstyeIWZ5lDNyKzSdS*OiZ<T9<!|QGcIJg!ki!C(->J;t
zBPLn%!4g<IK&S0?6li0N6;bUYm=FLzK)}EACi0F^VI&6InAyRO^)1)NHjKYC<xk1o
z@=B~;A96&2-R@L4-K*#e#=m+nX@Vk-Lp!Hk&EpSPAyoQ={qQ};MUBcNqi>~ZGuRcg
zhX&CvS1jvwr#HYWZ>m(rFSzx5j_N*B({ysI7&oKNTPcu!{X9Q&BvKJbd*)i}GxT|a
zo>VH@t&%KP4)Xf8EJpu||6MCMT@T+suY@S)2S}K;NK_siM!z0;N)Wn*UhHwst{^Nd
z*<#)-7q&ZD%JY)|aqGzMqp<*KN5n}N`q|FwXLH-<_wHw=iPqOe&|bZCJn3`=1gXfk
z_G~u|oK(`ePJ#R7kiUPiP(j8yS(GF*N`Ybr72l|9T(yCqlv>G+6ktnm^m-|m`cie*
zcIE)+$&77Ffn15{zRH)4=Vg)1y+`hhkw6YJ>rcMytQpy<oJ)H^JOi9OZ9P9$Es#!$
z1!ct-oh!3#l_9^`Mjbv6xoah@1xrFJ&ovOPnhH>FSt*R%Hsq+3kQD#ArYABQX6>Ug
zF|5D$`zUeap^`dP4-=iX;JO3Uh(KI_OH3ZlsI$5xv{TkKATPC542_}`sl~2N<H?Lk
z03IqX0IMWIXC<f|GGE_4W`2SdnkNwW?CH9%tm8aCd*i*i3u`XeE$kFe8wamy@YdI<
z9fArN+l&91f!A;5YNekd*m{i`7lGX1AauQ1_t&e6p~(8iEg3xumBpICV)$AdvLW{^
z)X&o3CkAo~1*=^NOF{xn{>8wNp!8Qzb3x1!a`;hiS#EoVo0@1;!Xa#`?V9?I8DG5m
z_Yj|?`Qrl_;XQ9&BIgrzx?iBne#49BX?`(<%ngFQG?Cw-Sy~Qg?LiaS!0ZpmKGrv6
zQt8h<N?YgL?=7rJVF}V_CNfLG&G^2R$F~lcVqcxrAkx#(P}sU43?qmq%Y2@fNb%wI
z+EPtN$D8^M-JQgmr%uAjs6=4b#Da|bd&qa5z2LJntz->)!5>TQMxX&2?p^v~ztMly
z>*1!P^tqKy;#Ozc+Pmbci>w?q9)Ypj%-YgOGG4xNRMP-h!_tASeknLvbpdcfY;ZO}
zCijyzm9GZ9%}4wi{wYBh1~p;4eO_u_&Lks(B4g!^Xf*}A6yv(es7uxni%IVLi@YKv
zs3fUNI{FL1SoU-f7Vn>RXD_GGC+MXXQU~!j4&4w>qmi3PEdD$^mMH!FsPBFxM*)O4
zv*TV&XfM-#Nc@MbdnyNYA$xKe+S)_(z?hlKoHl`aJB0wdZfb(=uC-I3h*3iqpz}#H
zjl%*fxU>Bl9O#4=Em39lOnVgGNs~Z|YlL2jLrY4hAgaT#6G2dpbhYJaKKw8K`f1yx
zhIhT~6qCKQ5Tsjlo=X8LHnAa*b2Ah?I58=|e06H+qz}d+9Jq)v>GU`SeJIl;sn1fo
zhBt-?I%imY*)VA@w>idQ4c_dpq+^&g3l%VM?R#u*Tvo5~5L6Jp;I6RhIoajWQ?~Z(
zfW%>tN74-HXIT^6R?0Ddf^a%i=uRG@Q=grgG~<B!wx;_nT<#sHlE>Y(=YE4QwaO@p
zt)pPZU7eAk%#XtTNLb7YRvYmhT6&KhaQuBk$4ABigV8Vswg<1}<-N=Cg#(WL-E>nh
zy=Ev^Pb-efAgSUj;8Gw@<I=mv6al?|hC<q&2EH2><#V_sPrr=;oDk~t@h)KbkF_k=
zS2AbZz1b<Edb}yhfwWIajUsgO<PC-qDIu#_#0=*MJlNh+Zu%T9+EZIs?!F;FFL9bQ
z0FiL`^H59%zohJlL`N`raZYZzj3lzMV83<gmxUWX9)M}dy9IecPwpZtf9n&mJ1SV<
z#Kn(v1d$_s<3YRjL!L-}DZp|S-&x84^6l60n2yz4ffY~gl>=^B2(2M4AVq*RRX)5a
z5FOFs!8}=OEro>nW^38cp3+^iZFaxiQ+Via#M~<4j){(n?|cx=9zfl`QrLVt(5$E(
z@d8^c>;wkfQ>?#?4OZNvih2_jW=aD=N##M~yfW;eCT6+LS1d8Nb_4<6nx*{G?)r+g
z5F0~W$N>ZfTzLmPmG0q#OF2hRV30Hsy4p1;y!_L-<RG6Up+4m;8%;S?e(ovHNs$S6
z6X~!Xo03`P-NpA@G-tC-)yO3d^79{~YKm}5ItNr+klcAOs4O$vAYo+n%wTD?bx*SE
z=@WAyGGm@SkDwG2`Z|k(Zl^j^Kl!Y<tyYlCoSeJrX$t~ecXVK>q6nH+7ENfKKm^ET
zDd4#g1VgDI8d&nZ*c?3bQ|&1lZ9t$ME~<kB33r_4BM1yBATfqTN@G}OYDFnU)j7*|
z0K!r4&`5xkU#AiU<1spw=iqPc7YG*&33Nk$KO$LYMpUr74xNxp)pl2fdyfKmsJS%6
zM(&mtFJ?bz1^VYYEET|vM;dNt0U}0)xW9ya^`wQCdn}kcHEH`%$=q+FpENT0C-BrL
z4GrQ&qX;O3-uq&i!5V*Idb4T<&|w`v+#paJYT?XgB&3-Z03$xQBC_q|7m&nJy%Y%{
z<#&>eh`T+X=fAkspi;?9YG&mJWN4sLR_rZu*1EjXccNd++qEG3M>}3=x=|Y@?>S2#
zX96T=H^AbE3KaWC=|&=){S4boHsM4M?l7&^6W~Qm;-+ewqN^{pAuR^C0v5t*GLn5+
zy%)Hh@(b?#Vh-YfHLoww1dAJS>{pN2qD#Alj-RAsJ0#^#F<uoMsHndSub}uL(JJ?P
zvfkYqyi|Q?1GMLk-?kOuh1VIfJJL>iu-*XGqhDiGL5n0<qz26&XguDuXih<hUsQpf
zE<=I{*)#`M$DFd5dEnCHO&{E@2K;2B@-Q06!Z<Y#bQ~3NLb@43=jR_AmJ!Yhq@|`)
zfp}-#pZ8Lqhq9O@&VN;f-shJ$3929D_tQ8Uor$QU%$nFEQmpBFnU?C6lI~x0u(P*B
z6#I!~6VRy;>b492)pmirPTf%KvThG3iI?3+<Uib?<m>U_6?Qa@my-Nfv@*iJ$xOCO
zy3bcGJ}eGSt9UDdv^+`8(C*ShWV-`ozw=rAr|0-vv<uTMj)7?5hA#w^A&*1lnU_uq
zgDl1$Lk=iwAmQ9)Q0_ih{_;=J+9UX)CEm9$X!YZV=rFeitT_VCXBQlM5J1pXD8>}N
zt)kUjUSup;95Fa|kFcxJun*scdUDdo4|04u(t7@Gh|Slah_YH`Ijbe3*?m;;%1NFK
zfd`#7(LMMLT2DAXt{R4d0slwtmcuuysn4;C<Yh~PQndX^Nt4J&qWa`i6YYyig;=|P
zGb5hvuJ%Tf662@R8PEx1ihk~!r5U+J45O`fmOOFeI$i(338IVb>HJ!91$L65mmxzn
z#1Dl1-IEZ7pcVF3zN-Qv_|{#mnKByZo&qv19*~{}ug_p=1uXpF9HBYn!4@m`E_QX#
zBbnsNCpI`+TH%?bU2<<vceBHWesL6B4u`w;evEU70q@x?PlCCEqvyEKAJP2nYGTw(
zxa@=Oy}LubzTJYievyJ7c(;`K`^ztVQ_%97;24s5D-mf{!~>DBw^XeQC1d{%AM2c`
zEnQByvh=0Mt*kAI<iQ>nC<jK-arNile>%8h*$|XEk=<HU{7eVlckk;=ArDfiTm7)e
z;2A@m#pIejyfyXzgc+0_olKIIYG_XWg&BJPa8Byt>1@AQ9qZfFB49QwjI;vgn2*eY
z15#u`ETnd{gcV8_oEdmu7Fp)(=6+C&^2Ka*adB!&kV93Kor3slvkN*X$73H^se+_&
zXZ=g}u3zFoJ>0kEBQA-!0il{u<mn#hCZ%o+PIm*K&%WtkU4-VVqp-Hf6NPxG(gaXD
zTny5XiCqlebbp6^?*&?U8UQMk<=`70FwFv|EgbVs-=n&zh$@^9iKq-v0mFbF{*v79
z&rJHtf6|&{tXk<}3Z)@*%wA3>mTLV2MxW&<cU`!d;;U*_*fy-jpxb$-p$y%$-(?Xx
zNK$L<??;RP*%9=M=sE|WVw)Xy*O}C_DG?gE498I)6AS=ahC<>DrsLgIHAfx%H?FNS
z{W`>QQ|6c>_kpQZxUI2ITxp3t11gJ{&qs!*17Skuv+jBo^TElK+eGI*cw2e1pBI?S
zp3>qQlTMAM3RT|MB7beU)yi@%Z;A*cOKQ2r{QPi07q+qf0T0@R3e#}erTW&f)<Wc#
zmGdWWQb4_kF|bB&qs|g0hvr|C3#~MrB;Vo;;ARpf34%NS_}OgOyGkotTaP5@ZQhKn
z>kxaKYzH*J@vd=8!ck~CWusP%6Se)qS<hOXWmEx_9i#1;H*&kD(c`=4gSc0YKD!tY
z)xHvL`j>({{66C{&M!yho(Tu2Fx2XgVH9T?r0J~arBD@$T_TLWXsxbjPMfDftBC=%
zTO@4x8=dKq3_UH-R`5U<*WJT^pBDdLGW=6O+G_^XMsCCAYCR~x1dYe5iJY;(D5fbi
ziAbjVt^hbj_q$adbC+!H?w2D+cRAL^_I>R}iImSLz*Q=wrYLQbi4w#7#6&5&sF*hI
z%G9Y?GC$~sp&Fh0e<7a%Dm-Z=&67T_5A*moCyvx$qQA+wm>>t!R+P9-TxDfzt9{U<
zCdd%cFT%9&zXaSV8K`ahQnyIp324U)c{GFQ39OdJ1VS;<$+FdGN`1}~J?QVXL4T5v
zi-XlH7{!6<cs7Jv#8K#UMKPYhHZ&oi3-GQ$^Rc+pr3--w&<*zWqw*80*)HenP(hMY
zCv5qY4fwcX;i>GP0PM>gtDjdW_tp$|qRp4Ip2<up=>U=VjF^!ij9rqOHevLFcHGEO
z5OH@28tW{J%)u>|;b{ZM&||Cu05eCmzE7g=l}gR<^2b_~7X`=72r!wmjfk1NJ9nl{
zRZ-$?TUH-inFBR5vT2k_-)cym{>iD>^8&Oded9<i3j+A_AL_2f67XTF=<^=xQT#FO
zceBL4E51Oen%V^iF<btG@|wQN)i@HfQwFMIrT_5zV~u9hiP~eKQOje{wy>$J4Q2P*
zE5AkJZlRR=Ca5(el;XmA$W2@~H88F~e}C@n{;hv&`$vGOrOY}0wcE<*H=Os^EJ+<j
z(8m1h5ZcXI3dU$A7Hn1ASRBXghW=$Ka>Bb_u_z(O<~c?oyCGZFJxxC6bE0BNGz5~z
zvgTP~OIuLqsWQHIHU+7A=+V0GaXUC*;m4Y(k7e-MbG(uE&>>(ODW6N|W7B|!bHzqI
zWJ^kOc;9^REbSV|OT>ZGr!bBLsZ^vN?C4ILYWrTRplNYi@AT@H{6X0QfI{w?UBg=&
zJ9LkE36~X<P9r>H^CW)rt@aLo((W5Px^z?cL$*7rw&npDsMo{QMSGqw=IRT-KO?*B
zrvC)|5{|e#Sk_>&xQ-Vk%`DbCKSjtv*NbUO#8@Bte?M&ma3}uf*>)NrD_7~PL!!y{
zyI~p~C%HMB=*m#@zaa{ytgM;QH<}Z2<T1kc32`#d_qZcW7oXT)u517WUb`Hl*jtWJ
zX8qU&57u|;9G%PnQfTgZ=TFtFoR_B^*cHq0ca>19Jw<{TJU;btYVvWVy>98Y^+V3h
zly~OQxuHfF=M~0YBNH%k%X-3__RN2&nH$r^^1nH(Y$rw<UFBkF%!LR}b<C_Ku|1pn
zkVZ*3&Ng3CK!W#EGDOS;uMW6FGCGZW(m|7L$qqZy-&J54{8_-^XIp<lVjn%o=BTuO
z5>CbW$Yp=-Dly&~>wdOuAGv6700-uF<z9j5N7*!WrNnpu#dSG16W3UjJd3hC4K?*L
zZQo>f!um;X{#J=@BUjPLsJxc{hG)<Px>XuRqUBTasZi&JCe8gi*Pnw0?W|);#ky6d
zyj2dh2O2u~=X1t>j2+~*B7t2{!wfa!JH2dgQxdA$YHEm;tg5V`VhuE}>aEfZY<L3*
z^b3Fj=qeQC0{R<@HiO~vEE%s>e_}V|nJki?h|^-s(=VSw8S2u`#=h}3{=--Ukq4^{
z7zU)i?xGJ3O16iQ3Qi##WDriG6vV~_ovx*i{vE{k4tm-u9ziEsG1wF`O4%NnR=2P{
z&2N?(EipWN(Bx+MZE^A`^nc%U6nsj3-{qtyww9VwJ|1nQm1{;Yy*mWVmxj2+^cZSk
z>9>9l#RyUZP_T=B7-?1TGl7H+&Q^R_kpP2b0I>fs`Ptih<YVPO{U`vucZ9ve3Zg4=
zaaKMPxfu7-@Oisr(WONPV%Wf}yWrX^U+S=_GFFf|jRRfWJv$%E#KoC8FJ*x6Kym#J
zb(>KNn3L*lt$a4IRrMOdneKZY4(vQ#a{jP)oE#5~EqS<De_S8+ZA!U%(&z`BkzEI@
zI4OpnKkYOKMI<dF(BQlEy}V2TQ1h_sE_Yzvz`ADaAZY5`h-KjBg6=FnOf939&kglI
z-_y|+Ec~=6S*BGjt`|@0pJ4|hY5C7D_bQKDuuMPf2_uA-KBU^_BJAosd?tMVFy3Ij
z0Lwq;`npLBt1JOi*|k&{ps;j`Q$Vf@gCgYvJFlVp!7ZPRX%29stqW3-nF!kHT8RI@
ze>p&k@q;SYjP_t2fp0KJF=$I$WE|Rz>!jf>=vxoE4wN(F>`rb<(v`?7z4eOneYH%~
z&YgABoX@;bJYeHb5i1#&Tv%6-Ebt)+s{9D)qTd6@cHIpb?Kg_yn_~^bdo@Sb9=E|J
zDmG0~o;7Clb7VU`0PB@_7jnqfqCgjxOgdPPVD}iA68^XJ#Z}4~EB!7m#2ha=Ed|m4
zm9__dx9@Z?RUJE;Xi`<RuXj@bpHNyHNLk)ZgXaecZ@XQ-Mg4YwiX)$tkgY}P18=uj
zcnVrJ-443}9|EhylYrkaU#N7Ss!SHfgbV3Y8ejRzW75Dj$-DNNlQB@(kVO7o5~-na
z%6MN`R7xDWT=Dl5hQ=-z^rk^aJ_AgF?)DUwuQl(5QR|}`i1p%A-7$5d7~h{<CTQz>
z5GViA40%br1|!#YEb}?Omw!5(>}>{dc~yq6aa~fR=if}*B{n{6_7?}a2T}*J%~l(l
z?W6q?*-FcXvlzFf-WMeVh~d{_3Ik1!%9PuUGQhq}w6C?d#ev`{Uw%dhoM<|?|MH`e
z1<v9B%}(LaxD4O=QM_V-zt6O2Z_4^ST4=GMV#3DkG3Ut!_ud;}dboi~{Xf55XvNUi
zMis7*?UEbrjx8|kUsUnj`E_3;pvUM^L$LZQ*D}v=a@v@UPSseS%?xai>z>+-vK`oo
z4{mdZU{3Iu2^V!cqWAwgafZ6#%v(X9We6<m!Y>CfaAIo`QKhhSW@t*cTZV-AO`J3N
zs&1&oziVN;nXnUhLd1gb|BL@4;SD~VAu3Uq?+m}uOVl)sGDfi+;CrnpX?o$rS10pD
zA-x4bEZ&O~di@UjNz5*WCck!fSHWOm$Cw-(b(Y6U_-M{?T^wwCm6o~;MVQ|84oT>Y
zwnNsa{>A(!4<}eOpN&60P0O(66#!7ETp{60X7l-}wF>|a0SNGahh@N+$HM&Am^a>$
z1ckSAm_qbHTJV0CM`SYQY!2hf&zxvI7nye)vJ1sY_XKA!e(q@E=`n8#h7cD^#q1d%
zRlL~`@XEOavm$8-8AK_^fo2y(II2EG{dU-C2)hbniSS$z1`vO<j*pe}_J-4oP#qi%
z5vJ7>`mW2iHKDA|>~i}(F(wqaiPGujuQUlVu?GW70vJS%a@C+^s6Np1Mpt6+t7RuU
zvlh4EPQ|DrgmcP<`j{u4gv}+bQFef|R#t-?z`vKnslC)jtsC&HW$ZaC`yZ!P;1%s~
zYVX@2XZfYM)9Ly$CZPcW^?Nr(%%Gb0uWz)Hr}_Fa9m|W15$mx1M>uAy^p<me7pb}1
z(B=#Nr59>Z`^q$YxAZGY1wzo!XacV0h#p;qs1XA}i0U}HE{3=GXc3d}v#VvnRPv;3
z>{~#_Hzbcc$9#_#u>bK1OLbl;_AU9b4=eVbFY;4jHnN%Q#9))ZcAOG;hmI63TAv`z
z&MdUTnkQA>ilKntIO`>DLdC|$06;qVCeP@0G>fUdHq-KnF~E#eM(&JFdt3?U3BS8U
zpv<vMS@*4Ut)hUOM<L@X&I}M#5cRL1YLm$n>Ls7LZZW|h5Q}%=q*E$fx<-2R$@@4l
zphJJMnAcI9Z@t=_yBSIQX^!r?IAFIg73mIn+(PPkM3MM%KDCvI)ieZ`l$E$sk?L?@
zn%Bn*_8dYjonroRFE551AzE_v1RrLZeXCVUCBC%&-q)qv)2Bu0SWdO^q}pKYA5zO`
zaDXr%fz7p-jJ@;hMM)f_j9pYphawGMC20=<fqb%ZxPHSBjhRWu$7lmqA&ZeWZsH(e
z67&#f2E<BS$ba)1kELs3h8H!-IV`=<mAj`yF;Yi?8f>ttH2WPNI|x6C>v}J5Bth>;
zUerWJ%i?Qd$udeHJfm53`GY*WGC>6{ExS#2Wuzy!(#<aQi+2E6+Ms<XjJODr0L3Cn
zZNzA|5?+bBuem}F@9`tzOBoDspBu>|7OGdppNq&~e>KpHeiz!jmAIvgA6%Dj%Fapi
z5n~R8hBA0Ew-h@OH^VthlM<7q)vQ(%k7<?X{LM6cX^5t+k0YWU9n%trZ0g9%Yvh#N
zQZH$)WI3@;#Ph6Q#f^T^;7}`8OZXHUp5+<Oz8#EIrbG`Teb@O583$b}w(LCOSUaY5
z3?Orme4HF;1b#B(lMC^CA3us=Y|psr>6Uyvch@N<v}{{dUpxd)l|WV#C(j^U9+2dx
zr8o;nL4cVK?^3~6mx)UBQ@;MH)mB@Vwd;UigO;574$U4(B_K1vD(lWi6|+eY>eJ76
z=rmFp5q2(g&<4am4n#Ey%`q>)HJ1wVR5<6;o4Q?zB}ZbMe@Cx!S>nFoBRjlB{yc5{
zCFOAJ9ELy_rp|*V_Py@PdrNuT(_McPOs%fKcm^f?^J#^|>oV>hJsuDE{4~b9UGRKJ
z?IGFb@(m@ZE>in2hG^``JQDqx{Fj>6lq{kNqFD>-x0(h^k5iKkP7scDgc`7M;BE9@
z&R#Mm;s#&IXTpr+bbni*RENJ{RJxZVG>HZln$+)=Qp;xEIf#8!VL<FPp+#CtX8rG%
zz8kS4!ySOW=G6Lr6P&hr<a0SE0eI18B>*QyQAy+eo)cO9?(`1U?AN+_1p}~_@)oj5
z$ZB;Dl|4Oi@mt#B&iIrR%!jY9_X=3zouxSea(T2}29W$Qj;mlU{mRzTR`65tPcD-6
zn9^B+uifyyWzBE#YhcIt<FYLcdLS;$+L)}PU{-p2Y2tXT1x36Qy*T$>0>i4rJR|<F
zo(g5KP9MUNFhLc_G0G&ejNBg8+<5+*IJ??yYM?SQqcwvY8YXes>{}VYj3TzF+*HGM
zlrj`zMW!$OYp?nWpd*#;i#i~gms%na3o-oQ&3bUA6P5SU3@`%TBq9LUy`Uz-c3Gs-
zjCS@m&y<D5^RmIu$H>Sut|-<5z|Y~n$}u@}%NVp%0^Pa<b;T&{-D9OV!r39&`O-!|
zg9h&W@e2+;mpR%PrCQmF<+Ix$&6qn7smzJSKMfU*;|X<V71@eCPLlOhz4Q&qysjzc
z1*!*vY<xv37z7K=mZ1h25}`Ue(3Gw|vKQ-rh5w24oA<n|b0Khfr${TOy<&a3ny?IO
z$z*E#fXJksY>X2k75?TD1$={Bh>Gk$6J-t?nD|Bvq?%bnp<7OmcVG`MhIp8<Q6VzX
zO4vfd4BuY}NBbVR<>Ud71|PtNda~wQxs)J!TXhNJl_)5?-#rk6VCOCNRw}b!Obg}g
zv>76H+*@j@bbv*mdum~2l4tS*TH8Epa>!8b1(u#{mTTW8?KekF-(R_VAFX>=yP&2l
zV6E#Xx*DNDXYL!X`3*}D&i`28X#n#23N8&OAm;nhwA6jFaACsNNWogJN#HHR<s2J^
zct3F2r0AFV_83q}?toGab=tT`kblkj*|*?egnJR~@uU!E(>LiLlvnVD{zfwjwR9k-
zVp?`}eR@$;oVoEBu~7&KQAOv4MGN>u+LmA6$C%;$v$$Y}BKEi#2Xd7}96ixdgiaa(
z_t*`E1e-nf>`9fw?c;l7?Lu5#u2UI9&;c=9<X!~>M@RU5M2*(Xu4Z4+HZ@(Da2>!I
zc=U4s<RJIKsl*tMEmJ3`-P~p3o*SvdKNe~5hc@QHN-K8|N`8HM7SLA@`faT<9SJTT
z%>~|P?Rg?w?rfac{!|B-pp-FaBaejN$bGCh?mGGLU2R=27r#Ksj7JSW?$ub+&b`r*
z%0;STePEmdTFHGoqvbi02gt46)|_^;dIT`pBnbL9gT{Knn$o+y5wv)Pogc8GEM)Vq
zd8qZ2fb=-D73B@wZ>4`LSi>)us^1!PvI;s_Fvf4;wVKXK%h>0`!*39dPT8;#UBnHw
zgK4M@N{#X)$*_fiYb;Y?xD2>s5eV&aFi)BU*#-zEUS+tX_Kq^+?QP0;`2u;@8JX=e
z>3buUgesRK#sh)3tE7F@Wlo)AO=c;bE4E|z?<fky1HXWSIB`w(o&YJv&ba-MSD76?
za6EO(LDI9<ioA1V&G*dn=&u7xQBwq)`a<HSMraREKIbSRhYY`+5D51`MHrs14pU#k
z7sO&uSM-OyBfpSb0OEh&0%2BXm0(*Z^n7Uigb2utZHl42a%1<et_?zc=kL==Qa~(l
zxr<lL;C3iDk7U3>0b^1?b@(~*jq@0cKnfxy@3^Z6@}m0*2>%kS5ne7O;nja};B14|
zSTk%q^P+JEZ7ctG=4}RWvx;sZm+W`yxOOvg*dojYnVqbwoW|n0tekK%s5^YuGVUy9
z?2K;eNt$W_kRup%U&ZoiOCPJ}hQ~i5MI^IeGf0|U4!B+<yTq1Q%NGKx7m4e+2elzf
z9vHarDDh-7$T_*$<N;v*Vy&Ktm)8ZeVNM1`z@qpgGeRAX`fXiP?^CEWqO9}XW7N73
zntTb@!G+^IhdoytiTh(!sE2+yZ;vt?;Jvvgb;3Fi<5(xb1WW8Rl^M*7iu)}W>n?+<
z?mU^A!a{Xeb;Dc^GoygX_#qI!Vh6CFm3^_(AHiy7C~_m}{+xofJzL8lzIm*6THGTN
zM`xQS3oPaZxY5VuRE7;R_$Dk*3UKU}ztwxjvU-_RC?OjiQVcQx{}N*ef+?6kYWuLr
zg_=tKg9;$)SeUVDYYgk{O*@~ooYd)@|0w-qBLK~5N`uJ+7I1qfAi_C_o<(`{j(eZy
zMo>PX+QmuOONN+bT3clvTEzfZW2OrzEEP%6=quHv>6us6V|2>PnoY)g1tLMs?|;&U
zb=)p?323(n?--U)^X79e?5^D+QQ$Mhg}6=dV={}NR+JoOfdRx}7JERg+{s9d1ZG#2
z_?e}B_p$A3yl501a!-wx@4m09E?65DXtoh&OMFf_d6gd*7GVtckx)Vi4?tVldw9X{
zY*1s{hR^?I8G}^nt-}zx5t+pT5~%(bkeow$Pw$RsCY2g5xVq3z6)J0D@s{j%VDWL?
zKHheLKdYmB7B~Q;;9gem>|!*Ybac<+v~s8>m@A^b*^)_eUQ@aVZK^!KCX|U48(RH0
z-onh|KSf)5A*@sZW&TxE3i2}GPeH0?gnt3MU1VtU(|Dr+a;Y|{Hu<(J!JJ$@i5=<N
z@+OU(zed5etuG;RxAzY!j-JhaDo$cPfotw;6-qsuU12bHa+KYEIU<BC;d9G{x9)`$
zhs2hZuC^C*SFaVY=uAkESBmMw?l@wmRv1AuxAsG7Y8N}aW{w-Ncb5#Mc<T0}>aTFi
zd}ZW70`oJL-yS+!IF|{3>ES-IEIWm}?9^RU*21vo-r2>;=?Oyav}E#^zFg0I&`Bv)
z0_XIefArN7QU8{y(s~sfv|~?R(FtMm5b%MhY8kw$`<}i%dh=oGV;B%o@97<vmPKOa
z;juv4@|#>m`jUmizTZuRI!T_~_1YG{CuG$EPB#06%+E#AV6m3Opx%Yx3QOm-l&H;O
z&>2Cy$-3Z{`F~|^(DhLo58y$tj<inwe3kYY$c!j->X3WVzu@TJ^%#`A(n4Y?PWDy9
z&){&2VwbCEQ$QWNyEgTj990d7AOB^H^=0@5N4OJ{Z#0>{-)-ygvJ94794VdL*CHp;
z88Va3n<w)W?gq-r_Yp+Mjy~r=Rl(cFKhuOfU*v`8)eyd<zA#Px9w2oQYL_|4F?vm^
zNui96(wTIc-_rhNhj_Vp%9)ZOY0&|rk^Q9lW$gCw)tMT1qL2~V;D!*$zstSJ9UBU8
zpz>ndQI~Qk8zH-b*_%;43j${lWy%izdNMYcTtRMBewr`Au@8SVaGPky{lI8%ANKZI
zG2G4Cwe{G|@(3n;@F+0UFilZN;|ivfcRhGIN&2NOmCEoeaG=0Yusi-_;bY~Deaz58
z1w=%3($6op6PAsT8BJQaBqID<O4l)(w{QYmfsM6auAiBGd!Vk|Un?7)x1VbsAeXEe
zrbJ8`_Tys=S~5Xye~1|@ZN|R>yj&l^W+*86f7tC+obxrVS0D=pUi@b`{T?~(eNsrT
zs%I-e8h1PC&aqZf9{D?se5Zo=xr<LvtDn+f3QPxCM{6@})!X@A?u_b%^S-~rC3nlG
zI<KUG87ePGv0sh58_Dc|w5GE$7`?;l+(i+rCfwAtmoVbclF#V#S)6)AmA`EM$-@v@
zysXM!i;qmrX<T-E3aK+2vLr8hWRtidDI98ma~-KMrxz0ao<Ngnw7sTEgrY&-)Ic<E
z&S3e|bUJ!og0jSp4bgL`c@L66*eO42XMnynq%x7icw7l_jEW^85Iaa047mGjv-Lco
z_;d~CJ~J1^+dn1<1C9bFwW8YVn={4O%;w542N6vv)OG1KS4nwp342hv&wf(nVWY-U
zxY)d+e2$G%!YMFdGAki0(R@@RpBY@sAb1v=350W3sJ%o#Q}<uJCK2E8Bx6m>CJwwP
z2LDjQWAo$4J%+}Emw!-T1a+Bkn2kT18Yhns8Bg#T9r9)H>%X{@;E*+dyCm=_1@JK*
zvrq9y!zokKa_aU@9&W;0zupEMs4k$4Bmf#8Y8D!7MLKHIdsu-9B7o}}z%KnG@Ao<v
z&z>>5+-c3ZrKg_P!Vu()ZhFse6rA)Kh>R1O0LyRTMB(~IGwz>Ng)@G|5@6G0SBN%F
zb8)S#LnP4PBmg%gTNW*3Sc$$#b)q!2+3_vVs*=c<qi+LZ98Q+7**|LKX2}WSFD`B{
z0W<HzF;J{{`DJocK3j`lwqcokhh@Ez-Xv(m&k4|s)(b<-We=p(pxvJxnYOrB>(P4t
zN}P&;Kz`?{8<Y@frtw10ndv(S8it3(fmwMmm}F)wiM(=IcLqbWlV<-gQoGSFl|HuP
zNo|ftkwj)fp}mJ*h-NDiWXFv3F3sO$af3DTOt(kAoZ4mvbR%mH!3U)SYD(kHBiX<_
zTZkznc>k|zCWk2BTEz9}RY$hh85|F8AXI+7M4LBfb)@3l#%KLGj_%QfTv_|(7xjq;
zXzBCwf``(Q-~o>lvI%?(%!(&+|GlqrIdh>U5!sw6xq8gzE=gvSdIX}zU#nwtf^Wce
zmkto>TFY?l@L?rZ6kS!;fyC!&YbL9i^re!8f&IH-urP3XfE4r-FTJ_BFN5T-f8Z-j
zo=lPVv6ywXF<Vei1%!*H;&7OdsVxK?splB?UqEpA>rNVuyQRm5shl?pFhU6KHt`L=
zU}h*mIE%49A0f;F5`hUe3zCthWbND7iZ~vnz6c%<SM1CVM~6j4r4#d#app&PqAm{g
ztnt%}GE*&d!1xA~nFj~UOr^4y6HLqN9u+S6&Pxw6%<!v7H!=nWe#1(1Osl^iyWG+?
z{`GEm57|w12Z0=2H5yB{0JTca&LB@z`=_w@0iGg$*4XO@7ue31?8-jok*Js4*GZ+M
zMP)Q<b%ab)XI^%ZsH8l7ugVDFj$5HD(BJv`Y+F@M_SB%h?@~nr0}D;9(w8rK!C`EQ
zF{FZu<X_PBZSvX6@AG7a@l<{GUxGL#VXS97SppzW+nW`fY<}lU2kG8(_yZVZd2C61
z$pr?zJ6Zv{Z_-7@P}7y!rghV7&6lnzg#%AJN@Qv=Mxw3!Ej&t#XmNv1D2zaqdVU4C
zOt{I6<|J;puhTO(wOVr%2oy8rX1IHhmbVr2;1p>iq{UCG-vjVLvK8yy))*Vn!5#^n
z&Mj1D`N9^P&yH7j5C;-X(03~Z_KGWs3w-AQuy57J0e7@p6*w&PVA@v!yY^>*jTn5n
zi7ZbX`&KL=Ku+h`K6lX^zw;j6H8ThmGf}XUjtTO1*&>gVt1nZlASFpU5Cr+=y=<-p
zXN;H9y_X$$pD$2h)yAEHmM<$sN&Z-<lR#%&xJK5zs;_9=wDQc$Xpwd?dNH8QQpeTU
zoaJAih-AEyT|GC9L%ke&9{xuDw+0_)@Wpa$b3xpKbJOffb#^K`b^F?btv$|9S_T#o
zwxooKS&Cn!vcS`SMkqddfxX30JY<AaSxx_IEsox2q~A7$YE@GIEG_IdF57yTkAO%N
zO=lI=+FY32s`V>Lei$!<X@fZBvg3*x-`|4P@CY^aX1@N}@oVnlD>7b`oJ2yTm6EN8
zQGjvDt$hKC-&;f@&b304e><QTaHbHL7nk?AFS%cYF2Mx~7nfs#&-(t7I6qcTwqYQ2
z>ua#otir^`!uslfsWx8Uf50KTXtW8WXuEEOfSFmi%oCz0Yx-?o74xhuHu39OBxV<O
z53GkrfrC09>=y|hbXFyAs|g(X5<NVK@;6kNDeVc+y^6{;0_oH`J&ao0Ee{QPyZ(I0
zL2YdJB6ekgkT=sO_%-JwR_+>sH>?hIn|BZKhL+>jdKArYU1@UwMc|cyCxg5xNXtsI
zGkHjdbd=Yedua8@>CpPxyS-FbTCnD>s?|bl;XYZ9(ser5CX~Aa+Jn-Z5$+Til5M++
zmyW={Ft6+f3-u*hLuWtAMrN(kbv$t>EoaL&zBG@ie#fPXK(e|T>inzQHD{7JQ68sS
z$=L>3qD5(`^Vo$xjkVE9vG*J@M6}i)Ath>4iZhe3GAJ=OM*gTL45)vw^!;e=k)4Pn
z3u$W!MaRsO<FD)dlhEc=q~~HVdiy{JX+i+|xtgT-@_tJkR*)z5JZW)~goF64rTNcg
zs$gv`XdNib8mP+mb<%vg5&}Zi?zMUHphKYO`Vcmh6TkYRHuUsg&_LCE*?UtX_#^)v
zrTH|FtF0*u?J~F|x9KLKKcB>uvxfvL%)B{*bY5)zCp<85zm-=1KFm_VdDXKl7aPPl
zjYXtf{k=zKrBQt%m*DhzN@WnvGN|`j-0Zvr5|LpVr9e?DkA8VB=_U=}3OMcr%AY81
z1#}xE*nzFctA%lBxi5Hpf<8TTz$iXVSi?y>?(&oS=g2-xhlt@Vu221xTc)0?qa-W_
zBe|0P=$U3i_x3V)PPh!)9Cuc3?^%@`#geqr(iL$SQmeHPjkWCkQbEAh{@#CeE8kwK
zt+2*PxbBHlU}UPsJBXOX`0EkgHMrwjk#(Jynua;sV`^(`AAM|vp8ItPu@aqCT^Ec7
z8T*r@aXZxXuB4(^fVMho-8J&qXQDAte!=YUq{)9D22a-mzbm3&v8!=VIo=Q&wx2kj
zbKnl?U7^~{lQ*kPG^cqp`K3GqwB=a@f;zkr)zxOhZv8ez6aolF(U>0`>8OE9iIPEg
z+9%WH{&!S@#ey)ujEWpyDrl=ZPm~R6tE0EcjXX3Dwx2WB=ih$^Q1!RimTWoN@;x2m
zT$Yo%J=<VMO{Aj1$ONbz8HbXDB3guEXl#Y`*qYiC#E!>P#Asv9>-BKgUQEVokcl?c
z;!&#eBo*+@72Fufm&6$(&4ZX9{bb<fD>R}b(AEH5=Z>gPU6m`cEU)`{H`P{<1@{KX
z8`|D%Z&(?lahK@m1-0vV=qgs-r2{9Pu=F#;3b99AV{X^rP{*3A)iht_*f*<4L8>)N
z_Vl{`Nal?G?!UJmwZ`M5WZ~ew{@_T&#<~|9jLF~dV7Cn=8`+?|M`p_z_FUO4okMfQ
zmuxk9f`I>trS!lo@tb2F`Dn^{zBJBD7@=yXOms{wAbW{s%r3vo?J@KUe($gc*I1Rr
zoglXy9Uv}A3tO3PjI0kKMflpOh?Vt9al&e|$tyr7V+=KI$boT!0-Fg8mUK6VwSc0}
z#vN5Mp7;IE@p)ficXM~v71kFhX{Vu$XqM|c!^_$SCwV%4&%h0&swCVeOp!D$3OUg2
z-IbUYDr=7>(Mw$C3|bdcf2bkLT-=-Elny&UJMU3G^W`7E3T7IQnOZKTw5O@A1PpR~
z?fGgxIe%j6M|cGfxBnHBD|@AD%=+$ntxh9{GlXoJJ}_+%AJ7`T04|@Q5mda3s)}<B
zoB=CeQ6Aq@Zg>&tKS#@VA)S3R7fWYt^*b?F0b{_v_;ebDnF9Mr{h<p~am}bY%3NU=
zt7g1(E)#au%G5&)PSKF!X|JzeX#c4yhuN1^KC)ZwMy2ms+ARJc<<q5pCitnjPK8y0
zYW7f%DN@^2_GUAUNko0-S)V-$;C%%>Vb(mFOA+8nIh-hPXm9aaTb{!%Q|z2#(sX0`
z=JP9V+|YK5*92A!G!H_FM)0`-M*qogx+i6)Ff#f(8;e&53ysiHE8^LP4gOOHM<;G0
zA^0l}D0Q%KJ9vod8mC3Y*AZ*G5Yi^0?Jc*he%aab$MQ3~bGcMYeNy|F0=ss88Wnq6
zX#)O^>WM!8dN_E5$=>Nb=qOSz(xe+f6pj(_=>v;mpQpfB()~=4#Hj_*D>xImlwBl3
zaWvVpYh-%XSuS^3tglClTuHNQqf&JXrSBu^J^1llfE&7spAubjDyldGP>&?oc7kSz
z^xZ>6+jvNX%^o$5qnTBwqwhm}q8QIhSQAf{hv4#Sy|K4Vo$3<wkz&$O%d}$;LtH%f
z8|f^1pIM};f%?=8cYVoOX%Ss_X`PH^F6{uAnP5gDKj^v%+!XWgpOtJnex&HMwM}x;
z2BYW87=jkYXC`Nsc>EqyW5jt{stgej?5=qL>T{AqD|SE-ij8%D@8Vm;u(OXs^(fq&
zK9*@GU8w9bIL)wW$05Q~Mfl-5|Kr=Ap?--z;ShA=t>?_o(Bl7pL=3WCuXx#WFZN}_
zwZ#iwv}M)^nsrF>w43aQ^5cqOWNtePGFCo53^U(Idbg)(EP_2MkMb6I6Bzf;WR1s4
zXXVh3$>`UR{qSJA_PJibSqAkoQR4L_q)6CD0JMIj%1c-6>Ws)2jPVbFb0fYf%rtoG
z)lUj#yEow$oMQEOCHCe|SsvvIT3nkN)@{9FAQKbzjtscmO4$Fa_Zd%QEOX~K<@up9
zx4j0J&qoEeQW!`ZAQFDNEq=}_LakO?sM(HJ)WmayH446?DUfUxI38_3!RDA7kx6qK
z`s)F9xx@S@45+eJyv^69KQ~+4a-Bz$fN135fj1#sxX+0;kn4jhLJ)sIHrR25*=yy=
zA*4<Bacm*@{z9J9+iG7@cvm4EsCOMS6~$4Vl?e-K@C*)SO2sc#I@M^(z5J^x`J&lY
z7Btg~qsqJSuOFMbj3_LAK7<eFpWAKU4G4QsCfFsZCRj_{xfwd2sli|;_%nhH`s*8M
z!^IF*a;?A9VO8{eEovoT_n3fv_1tIkDL^l%-qYPTWukAZ>*c{EFXup^G6}9m9sz$R
zb5tBVDw%AzT|=~doQI7BnD>~J(#kSJ;MzzJ{JNikT}W&DvM!l9Y~K<U`NV2ghS^c|
zs@6rQd-@J!pF<JSE7NqWn<nsPUgm!m^uVdG^r_@lp%8``20zoOPmpX%Ypobs2E;?x
zh<mHJo#~O=xRWCI>_ymoEUf0Aiet!?reoZ?i_ul5?DzzR5CV^tcU%TBdTqjdhBfP~
zJc8-r;D%?^;+x|Kj}#>(Ez)I%d^5EIOW7VcRHB~<Us}^;F#zFrM+9xwZG*nl8FedO
zZsWCKLq>ix9y9M?IC!yTTKTgzVWWTp1{i)xo2idTLP+&~FHCqh`EpkJH=V@SnM;*b
z8xAXt3`^sijxZ}-s(sJWwYq5>AU4Vfb|7!Fdmiu-6o7uenQ7cH1|Ko<#MDgOw($A+
zZnQeippc+rKBgc=wj2@ah}j75cZ<<|hXmhGM#n>lO=9L0@Id?C_m1sGbT!HoXfn`O
zY=r!ch_Z%WtAg+&RG@8~%@)Syx|)eG=)e&rB$0myDqircrk--#<t4$%O?UokbJI^@
zhZ!r7YXPlYvkLyD0@=wrN;vEIU$vZZe%?`3x_Ym`Y0?sc1M}XdMkk5+4|XB603R}Z
z{MAx1e<lH+aM;X^&5)5s9SBK1q?Z^!)@K2CHKH$J5mwwaf<9H{zBCWc)R7wG_5)${
z2`JfKR2#MW-SX_(Ff0i07ehv#yw<3ZnBAHBDPDt^F$-fKd|JLY1gUd6D(15pkna8X
zhd`UNun9bRRVz$D0Eq|eJ!iruc{(nNT%V9sz|@!dT8+n^k$tf=B`RP8wA9?SYiCqg
z27GyP{?wPoz2q0Z31#G3U=u$kMXcgNh1V#6+a2)8KOXuR<A%!SDYwQc@@V+TJ7!z(
zi|Nub17h?GEo_I#V7ls~%PgJ+eT4ZAHOO4ib|3h`As&is4J3W79Knc*VEEOUBN0rl
zcgBBvNlAV8VZa4<2^UP5#KTv?(A2`@8!zKpS68~>olmUxSe)*gx|2p54`CTWoYw)5
zP|1nIH_agRooqu-yRjX-0$k2&v6`~H-frdx`$66qVXNrV_TiYQ7tje|)KRgJiujr{
zD@wva*Hh1k`s3ubEC0=me(>-%-_1+N*&|*IS9>Y2?*%GmDu>UeM}m)FZkD4kV+)`v
z%HjsWT!b%0DpnZ2swObAcBT^@u{rWC4S3*u5l&<*?B?svb;KW95%hJ_<~f{VDe<O;
zY;}r>FsEEUEwY(uszCibrNf6t(2sy0ZZ@%cbBCFwh$|-J2KV*<JbEHU&vh6#Z=qeR
z$E3xk3(a@$iJ4{7)`&1b2!g*?@jZ*jx<mqZAO{|pn)L#QTF3aKMWKPeEfKVxTK$?*
zxSDfZ1ip>zMf%A%9G&IEOh7jfBs0|b6@qtI1=^TmS38wVo;LUXe|32<tS~zrJ=|EI
z#yn>~`&xiXZian^WIE}cMzTT2jnV~?h#B!O5BR13?i`V#l}*RcT(+Sr{u1f~3p-hE
zr9NVR0fnUfO}V5q$QJXsQDGQ~8tKQxqO@9Z<BWHL^_b0XgQX_MZc%4QQMu>=Yd3F>
z<W(E=GKAX7CXYDOTxR2%ZHV0okkYNp1iOMm!0RJ?)bpbqlJJ=U*`rk+_4WxzQ`;k-
zfiXi5`8Tpb?oJ*5HJ&jqJ#N^0EAz76>Po@tZmE3t+l{(B38`KjQW|ea4%eO#AB8tU
zyW+xNgz+am9D*hKkW(E{RdzrDAU!eCurc$Bb>N~V%HyF@=6ix6?0@aO*AQv>QZ*a<
zN)vP<m3vPc#w`df3{@UI$}j8E%L|}gLUQE(s$(xRn;g6qfKMQEnFdo1Ww=70c3wLN
zgpad>c+%9M%wQFa40HdspH_sCgRPiY(6V|(gaVGC!OgFhTdvVHj0k%0|2l$`OTp`N
zK1xGMIcZE*stp&srEO8O|A(D3ouI=QiNousaxS%HVQqnG)Da-ad^BLBgADX<=ttrv
zt?sb?9hBpvU;HbPs#BnHxXiP%A}zeA8kVll;7l5a(J5jFZPXiZ*AZ)E81QF{cR@%2
zmM*%n*^y$65sdwolXJUp_WyUHXy99Iwwttp+iaC+Dm}qEx|q?^W~Z>SMs0h8-fNS3
zgxwI%lDM0Da89}s`#~-9M(;O#^&mW4X6WU$3V4d$aXHxxCOI<^LiM11&;J@UT9|d-
z=hx#Pu`zFhrQ(Ai!XL>n*$lCIw;R4jQ+iSt<gD9%gmfK7!}?<f!HfZ1j*g~=b-c6a
zYlFFb@c`seBmx3{OY)Z*1B=bOYR8llJLSZ=yeT&fk5EWX!ri|zk^D7sND`HiY2PCS
z%<El!yLpH6BQ|(%bj{fI4>FW0xC6nH9u-b>1V52xACp`_@9*iWe;E+Mfr`s1-n4OR
zeB!qYP7G?#dOZnRmxaj~EX_a{8g54WjQyX)V6iUM>FD&jMc{EvgqQ06xVXl~{y#v7
zvto=-%wjx7QHFt%;f+hF)Pup~IZ6I*+noEUz)OD&kn`&jB7vP(nE3B!npi6j-?8KF
z;3AU1^P>Lm4UGh(1lPK=@mkg%riPCY^KLV|e6=aOp}XMD#wbH(97bO=t{F~?(v}YK
zY=_dlrA8vOyBt(nEiwUJfz#!PPdiR-aEtxRxa+PtxHL!XXOTw;QQ>7nUOCoX@(xE)
zNmi8e^12Z6x?Z~Ab?pYVoKj;-U_Vgp7w>)D$eUF_nI0D?+me>aaeXZzU4yTKS)EII
z`iRywt+pKev>_YXGUX{E7_CI@HH6!r0Ey<_`s5c6m;&J1-^vdn!GJtAA1LN9B(EYp
zUiF(GT0<h6bes9sSw>u0YWN!k<;UW|e_uDaa-#;TJ~<X=me3mFu(L<u0UbL>O|8o(
z<i8j^rnbH7$|9uKjeAQWOzt{?!k3)m>`sDKIs5tISMaZhC{cmh3eEtH>?(%mDu?J8
zhy3%i;K8U`-dNN2;y&w|7QULe<GDBC$f7|xbAB`L&E)>1k(73*lyK-P*#gD~Y)}D5
zbCENFcm@?l5Igi17nNkSg`XX7kDBoCfu4fzF@I`V$~RCvF&}uteqq1r58cL!+IPv5
zwS$_)3^amR!grYVKkwd17l$gkn(0HQU!2iha$IAk?H`L^vc+ooJRp|k+}Jk^!2foP
zH1JBWFZFl~78d%s>o(m+C@&w&cr({PhxUoOVWNsMJkniocv1J7`8J03Ad>>s9&9-9
z+P%pl5E7QbxSnhXZ^M&T*v;2#X^EHjJBhfh760(zUfs-$JG{(bwBE*@dL0PJMV0i`
ze?WcygQS*s!c*f5)DR3UI)AIf6~qtJxPeNNI$;Ijsx;N;Mm{uLxy}C9EYU&bok5BC
zz!AWr!an5OQx&5-y5uT9oDS6xiDjG-C=A?m31YPAPcc{jYbR{!vyiPT76ra_-Tkxx
z_rPqwhS=}fa%ibWB)C|or~Z-rB5aFu5GT>>9hfrsY<L2quqTbr4-SB8YGuN@U%rin
z%;!BEfE!17o_7s@goWdkd9w&YVvhQz?K>8qa;UenB$#vEEsci7l@t{WN{YREhu+)y
zEG_yp2e#3?ja!>o@;=vUV!35~h8*WMTcVWF1Z=_IU*L9ihLG50CJsfIQh<;R&20_O
zD5pcpZ`@wGCI6e#-JWH(Dp}Y~;<OpBdK&@~M5h>&yOG1g88k~Qgak}zW%Qf4=3wbD
z7sAl8^*d>(x1KIg&P*fK(?<RLEbl3EOiJ@;ry2TNz8K=%^3~arw5uYKc*G&or0$mm
zGG2-i`*GmdgzBjEC}t4of1?k*zuukAaJwIlr&-*;CweJyrID+K>xmTA8_Bc$unial
z=FNhsF{!&o!Gcpd3Pru+nTd2(h0z}WU><V|(^7a8e#@HrPZoKP?DW@`V>~R!nW8S!
z8|Jzd0_bmHG$)x5*$AhZR0B>~dL~Bc#WE&<4!7h^g;pvylfX>_D_F=57A{FZ><6zd
zkEYtolnzuNW;XhoO(!(dmzo#U9u^|nb47C63KgghHWX9%<I8k!Il^~KlIE;j{Kq~y
z7Mpm;mo=cJ49roJ)<kL$42Y2YqpgU6!+H;%^HyRWdN>rvawxA)bNK)#K-j<FdU%{a
ziR%3j(5GHzKR#;`>&T4*>cjRcZd0s*^e2;A^x1((iBbaf@;eD|9YKfkKK6X)p#xBF
ziH@i<pRMl4qQye4T8%cC)nnO*LuuyZ-6Uqpj;On6^q+={v(Z{#bqQlij-BCNn|Yq;
zqN)RZE4~D5SfM4j?upcyf?byv6o}#fNWX3FzPWKk&?*Iem78A!AtUi-l-@!hTp+@2
z0=h%RS=<l3GFCHpp9#rG<*q?i0Q^K1WO{vYBB`a`syPAtF-#S)vHnEAViWEoKgFUi
z1oDV+Jb4UK991E|Ym@*-y5u)=;Z9z`jRQDj9TMjbW=)bF{mL&EUhxYh!(~Hz$zsnx
z6?vh<cKTf}SWFYp(-wQzmK}wSNKXcP6@P(uG{nB3q-Wa&DDrVaDG;Iyl#-6ABE2Sm
zti=2b0;Bu}?MXP|m*c+S!xu$vYPj-R2<prS792Vx@@UH&sVl2Hw<QJblAe58iYr~f
z{Rr#)QPwx#sno<FtD5>M#%4h|ay`K3Z=@dI*zs^b``M|z%d|z}y?0pX<lqQ|VNkpf
zW<T4kfs%0U8@-%!4XBuL%cSlpXU*$Tey@+JXJ+o~WDbSks?(@{LNbH5l1y7^$`o1H
z%=X(~Qp(dstk(GaZ4k>pC{nCugU##hHyP50&cGEDR`!hc)<f`)rOTmw480(Nrj0Tl
z|5^otA03AgyegzL@Y{D+UKVAR<(<L{3byoU#r@(+PEsg59p2<KKruwJDR^E>3x|8x
z1M8>e?A>=PWZLcao%%&WG`Y8bqJex55jmHQq77KIbSmjYQX@;J*>%i~d4;AwOp@u`
z&8|AHUSV+Ab3(yq7ds<mi7LoWlt1XR0_A0eXECJ=nDY>EVR^o+q9T`siI9iZ!Qz~1
zAhVJkB+d<Rh!ajSZrZT*Er27lYcRAGV?`AOg8t_6pegVvGf*+E46U<;I0pJC&~9%B
zhv9Lr=%lAFJ}zN4I_2!c;9uMCytdBm<Pz>9Bn6xq%O4^}WQyV%gW8jS0cxxB*X0z-
z2~Jx9_{XW2grN&lk4UUR&)qk`)MM+jEnD)Y;-_(dlx%qamYwdb(~~S>q<8Ol)JN%!
zeE7hK?Iax^Jf@R<ZPkRh*l`YX0*(|?n$yrm=OUi>`8sJqhr=d`r*rHbI3d$y;uC*(
z<>#KJIzTDNZrN3-%-L@jRADoxg(2iD8de$|ZrI(QHH!o1u6IUw`apu!FaJvC(A80a
zPxsKZ8j70>%|<n#0=Mucthoj<r7I|=O=lz3m{TYq=P_%jk$jKy%CC1bT_CLc(~eOr
z_p`r6ETLOIxU*msEM(S<%rx97DKk%eI;55J%`}6$OWo7eP0(W0#z_0mtSDtd*N$T0
z4pto5&yY$KA0^huG)1A|zync&VR!^Bk(LcsjB49S;ksK~saF3N5c7kulLFZ@Kp6Py
z`0|ACw-={tg-s<l@a3@|tLngHT-uwIY{-kenRW>z%EILVz)L&!dS9pW4i1Dd`_C}^
zqQ%$-cUeDk!xudmVq-rBwb^)0$|B3^=Og%uoHY<OF~-kL%IKLq^O}CLVG|LCLFo-|
z?Mn!nhhtCO)?X`P=`Sbx2DC-0C}Po|m|m;F<#t;=YBY(hk;RH!g?!1}0d{C)bA{5?
za{{!~R(=_<8(0`3A3f*LRpWDAuRKFSZ5?f8_UGZ!eR5fB&%^4YjY9uy>$dRDLT49O
zf=HvzPZgbNRrE=dG8PfRuvO!+dnL{#-?Te)>IUmu<_3Z)nO;oiV*T<@gjV@QXk(gg
z`(P3~V>f#Q@KjYgD)W}?Jl6JhUK>v;kUl{D(#a9L0HDV6@~^t;<O>@z`Ws!q`<2jw
zkW5tjwWw=ski3b)o{(ZfF{aJMm41~J4|chEz|3OJhyvDU@zs8a;0O8+KH|-fafSMf
zj`+oe{M$s-2xwV*KUeGG6xPflKxU#5)7G8Ilnx%sRi_y@eQZS}nf|b(j5{%ZNe*11
zwF?>-skDoZ@m?zYM$Sp6z^zWNxt1QlZ0TPe;Na_G5;<mXyhm#%Rbk<A;(3hqVH>}>
z5`JR$>+OXY!A2YLa*cnP%=d{*d553vDou?KOdGdHdhULR+F<W^1n#ATGWV+}$Re9_
zH{~%w89TXzMTYhUn1?ty4jT)y(9tL<NpNXR#o|c7-jN<%&YH4uWItIi(I1XU3#s2d
z?QR6G`V1Hv9FXj?Oydvp=gV4-C6-`+J;M0u6sekGK=SP?^jb16iv4}yhu9@+G>}6A
zLw#;BW&l=f(^8UdfQ7Q2&~LFOv{PdZ;~UI%LK8QGoo{|K{nf!0CMC2*p*b4ysA~uk
zUwpolxr*LKj0ci&%0m56JIvfbMCaBpBn0{PkNnr8-!I060asU+aEvAVq)m$kXcS%e
zPIDYMi~cqR;Huy+Fse<1O2X;X%P5E6;P)UWco0g;Gi_{zh{<ZzR}v2V4$a%10!K2*
zB}*>Klx9jPZ^(z`WOP5E0RP{n2j0AD3hde(!n5gF2Mid8!i}zydxU+?h5OP+b=?=l
z&`AVpQ0S}3hVFw24_f=4x{xtMK-V=a-mA)&wSqi`Qc0@Rnp-3~)Es2-Vx-%LY#}z9
zvBVn1A05(_v*{jx2+VNU>bIBPx-OkK{I~UNyxZWT+K+h#0t7~UNMNM0P5P`JOmTwR
zE(ZVfC>p**NC#{>M>Tnoz&&M<$m=PLqTw$$B|#FvVnrqryCANem$)=--F6DBigN0L
zlA}XcICqj+LPc$k!MKot8?e+S)k8_iI|Y8SsWZD%5&AxtV#d%0E?Lxf{lR<RIb~pi
zhaY$#CU7CVSRU>4Jf)We@75|7K<yS~3W;|e!mdBAcA{y0qZ=jUC~LgPbQ$r}AWUJy
z^o!^}J<cuAU<{t}qKP$pQOu9N`oe%G(N^Wj6Q6%1<TOya;f@RE`W-fT*4p8zy1;(5
zDb<c7=*{dk<3&EY7cpt~90GM4;$V+!He5Op_$UMLy?>k<!qF*2cXf(EE;oT3+S_gC
zkrK@Ud`H>T{>M7-+nk7(xFA_?okS&%dOC58s4_El1_L|LFy`!od1v%{GER(Y&fnX|
z`B<2M4QOv0D}YDn&%x9d7mPXxhg?9A;a#mGNU;EZ8gWLq=!tad%`?cLD75!S0$YX3
zEiNl$IC8?|`haswm<@TC@8(&Uf}WZj5H#(tuMK$ke{8vSF$gZYv|r00F;QStA0WpU
zCKvwnTzpsmrn!_Nv4ahy<MAF^jlTDlFrgt=oYa#$A4%WqlC3B@Z}_wWUW9CZ2UbG%
z!z#?cYtDf!ingU@{uJfGG<_&-!vGz4hymAs)ejt6=pCYNm(ay*0&s~-elm2Y(TU`$
z){MPm`(dcbN%}i_=5VA8cMkv;@vNRqhFhY@2Om`qbLuzN89SKPMvwAu^2!&+h6kTj
zWlDmEm6Z~G(by#pdbpr6qv}PNfr=ii+}sXJ1FZrk(}Pmphc1n@qZdbPC!S+RuTygx
zOL_EgYQ=>T6UeI)JEd&1>Es>`GK&W!rxkU~IyfVabs-`}ZS@Zy6OvJ=P`gfDY0m{X
z6mk0KBi$Bv8SU>s7q24nH)p+9w)u@LVO|>h!lLA4&-f)EDB>-lcE+a_c|}eorDk3G
z@Bj!Oj4SV`N<0%0qwaR}c=-~Z%b8U9SebwskPdG~gb$Ssgf({v{sDV5$p1Tx%Krd}
zR(eUWwq>J@lqSlw$z=8&nhbrSp3!F2thqUY+PJ(e6DCEvl*|&FqK=4~PzLJ_r5w*Z
zwwwBRG+$C2hp%Fv{TgF%A+e`)$V7e|&w=ikaVU>MfI9R40ex68h<z^f9*^6T0#$!!
z2(9D&Sa7Yr(f<~~Vq(}4+35P0v~c01be?E9d~Ta1lDm!0U5Rq<;e_0p-KIw}R9yH&
z>Ftap^&cGZ&<+7loZ^dKQTqn!?lt<UFgio`Fq21pedL!pDiB5O2}4B*`7^+C3wvc`
zsz-(yaSwKD&^+R9KmkMpB2pwN#&WKBk}~Q5G$feQx?id9H{W1{9txV%5yX1rSR$=8
zd)J~ujlSsc{?ckzc8K;1m^mnn9H+&qa57r+zsf;t%^7s;=6Xl3<^`=(->slvdu*cX
zZM6SfyD;I730y9<iqVz&f2}LDt*yLz4Zdeoq$oSSIT`lbRoN>h<3-+`;)xsx9|5bt
zO0-3xD<y=*hE3#d@~}I-xir{PT#_~}p9l4Op_Cy1XH{Bst;%OH_F$?4F+(zs?GJMT
z<<{A{RPutVZRmD&)5|WDo;3p$p);DUix7f0^&8I^`?7p<K!?o{Z-)IIE`Np0<;Rl_
zgVyhq`O_AWklG$4PUaTdz8m03{fvSNC1~Pv7W9Q6k5UWZ`4%|HHUFx%ETcApUMK0Z
z4~!xp>Ktn?lulM--F=iXP`V(SbT&eSrEt2Xkp?JeE*G~!yKwomVnd?#Q)zXtCY@si
zL3IBC;Ic)~rOBnB4xb<rq^rd*YSZfYQ)&;}ZeDUotzHFf@foA^+tt7b50Vj+U#5=2
zMFo(fv08If7K>s6r?-v6cz@VPkT1`ad*!tYZ`xmpgeti7y#2cJjyW)ghJewy*PW`K
zg9O6Gl?Rft6h`@&e{nubL)ZUG?3I<Oh&u_(Doxk#B&74<qP_$PJ>>q~6W;o$ko|<^
zR@)EnwOb3hg3tiF5B*D9FEFWJB+?uvXM*a97sQPe#>61HYOWH8UNc@!B3zN@=YAuQ
zZdU-q)uIRFv&U~gbmJ-^kly}{v}Dw{H`p8!v_pWE4nH283DhWMBLP@Xg(iSY+UJ79
zg3m^J6xDI?7wg<4p?fbvrkweG-=kyWPnK-%<za)*n^RFy{N$(UTagzL5YB<BV_Ku2
zM700>BF5Vl<uP|O>Q9u*P~7D7VXSl?u>oZQRI8H=9-P&MU2Hir$aFcCQHisIBRlfi
zf9IM)#&yb`t%$zKz^N2TRd@t@2<rF7uCcpK17;r&B0ezPJ)Ur@xjmi1GL^2jH&tg$
zt*EINFB0vFUTE48pNALG$2*)ewt4iy5RoKg!iP~B41-PzKIK~_{N1Fk4Ntay@TiO&
zDr8gA2ee>nAq)jwe;`lDI>WJO9+r6z+X@0|M4LVDGoc=De-G27C5t-p!g1-Eu*xXp
zv|cliu%|fGaQVT-?MOP|PgMfeis+g7p&~}Imsl$h8^yeq^ylNMcI=LR5CSpe`_FuX
z$gb#qhJu|#n}lh2#Ft>*hlQ8l^{cMm3Sz5M<yA06<bVZ62xRUzwNzRM{aQ}KJR(S(
z>k^1%kBe`|xsi}`Z#d!q$C{O<<u2CZWJ^7UX6byQEZsUDIrW%zTu=-{N=*_{KqAVA
z8b7s(M6k0)=x`ryNNy#j?@XhNbVg$<oUzJ2rfw6hE(N9y5ArQ1EWRwtGkHtswcJOC
zSgE3@uq7Yhr_<o4;u7b60;(o@&%3&t2&bMYk<GDxcxSdyuP3@4TiAdc$K+hV{4g?{
zs$^OfW0$-d=?H62LfdIqW=G~>odQDl%)+@-IbKQx3f=MNgjkttS%Xw#wh1j|+Z4mY
z2%Vz(8W|#P$MFAm=$SyRY?0Uk;Ln$c@)cqGwRG^P{-tag4a(tjT@o;(eCpmf6eax2
zu)d!v&)OK3jubAWlh7=kNbv;GJb?bf&vB=jmsOJ@_aci5;ej;Ase6e4>$MsUCG6jE
zb}<1^fxt${Wo|eWZv*_0UoUd?Ko9HqveouEc_&n};Gys7HnKzxk1-`&YdKx3Y?3H{
zJ#Whc2ZHX+TWKYlh2I5^CVKvWc8&PbG@@ct7*Bo`Mtr{#*`Tiv2>VZWNAwBQkd1})
zu+MguEhb0<GkDUQ0_Ek$;9z3ar=RJLKnKktuv6-ei|xQN!D0Dg;;|W@Wu^pDpD{15
zcM2a*m6Lyqn1rx_rYn=9P7ks_KJMuP*2J+sE*{(xh&B{T15O4SDoX?EIf9L>3VeHG
zevE?~sRC2uaw;41DL-jcj(U-rZw}AE1VoSG(&yTs3m@Y4%t?6$`N^h+(p?ejeFCZL
zWcA=}#doP`Dqp6h;ZyUPJ*vm}ByZxq7cz`Z(ld)<-s=T{9-`{(uqNVj@8*NdB{M(E
z&r&+`^tMlY)bEA)v!#cqooly{@70SiV9)vHl-lER*F**QyxX7CE5!o@gTmL{SOxjb
z?gPvjFm%Z){;7p&-$8!~xYEzkgdcQT?C63dgs@B(ahy3CBI;}}7QP(zt!~OSalgZC
zgk}pgIDjF5MbTyEs-~Gmt6+2Jq<c#jk?9=I9D-5rIj?s#0q(2-@5JW({d=KNn^5ZE
z-klSRRe+d{d|)YQ!CZR`s-dPBz=y}EjVnQ;3MSTRUmbJWN*BPB)~*SiQq0n!8zR+q
zKSx;FwYNC2c>{b@(<>OxRi%D>(8x;#awKnj*{+$q0a}SeMdo|v0roSQe4M~y13`93
zA^PU*m}VX2{2iAqJ+lqW&@mq}T;PM=Wq(&%W(lxKj^b^x64??3DStwR=OJ$~PFKZW
z72JNDL@nc?AHRVZ%$~bvvt(A~ZEc1=6L_B>^q+W@?--nBW&ygRmwR{_4hTL+u)K~%
zvLEPtt$2`Yi3iZHnOcXcuLY<er{?sk8A)c*yfFMiE=9MKwhTASy=E9DQQ1D$E0S*(
z>*X)EEhjGATCFNF0jZkZwZrKJPj|m<gVSAf<$}tN>tP(Cx#xTNX(>nq4o(#E!O0!d
zvz}GT3<V*%mRF7utz25+JP=6f)oHPeY9;}%71vQxO&_X9R`@tcv&hZ;K9}Q0aucj0
zh`knfb|K<#YESQ)gC7diWwNfGr8*G9P)gTeFaLw#S0Z-3bcM9hT_a0gCw`ZTT%R*u
z0H(u!2{*~Uw$fJBtz6YflOe8JSCQtQ2iFL$N}*NL2i%4+I-Dwj0;#58P6mwrHp&Ni
z?A!bw{-@m`maevUOr1V3nsmd$Ld1uHHh~5TQL^DCJlIK$yH@(<W7~iyy;q(V$Cw{j
zC#Xv;M%K!NoAyzp>g(0C8&*W&lhAon{vUCpqY7AbGcr#nQU<!_KxO4G-kOE!mtHE(
z2W5;Yp29nwr936-TieOcZWX_wgVN91Wsg|mR#ecsetN+1E{Wor1?%nyg7)A`1xWS4
zj}8mq;s*#9lc6QM+2z9Npz_t?YY98dAWe5)q4l{!z~(`k@C80e0FV!q%vPO^_evV;
zMD^Smhs{h2PZdV^3gB<4?WPM#H6f-@CUj;13dQ}Dp98v|QnR4TtY~LH=o`{ovp=Yf
z**0X+mbp4<R2TFnwmvW)NVjiM6qqrFa19piJ@g5CQ>Y=-a(kF1hW2BB8C^Yd&afB9
z-~=n;Y3(I)EKCI*TvBi?J?5B0ao&e}pF*<3Q01`ayG25B1lrwFu(`|#wS7TqujSM7
z`LJ6-<VPHuzA1!Wdh)!W-H}u@Xvep&1--CM4jpMiS*?2s+QXz6G>#(^lAi0?JCoap
z>pO6J0fxm=g3l^UIuIZqXH^=Fj?G1-Mi?*2*L7S^o7GmGb*h+`f%IsJ7|JqG&LHL`
zK=PHGdL{Qyvg}uFDI@tUuPO+*X9MAr-Hzi$JJ?^mQTuVG>87@B2Y#FzT+>|(`f-0}
zbcm%I(wM)ea|w+6pBPHx%A1)0xQCRARpJhPGwY~44Db<yYTGGGHKhfAFm$cX@u149
zG9SOGB0QHXwzfj1#Kt*&P*ne-Cj=4HEqfCVtS*1m-aNQ*V=ikB-#d_C{^Ny8BsY&b
zhG5#u6?n2*477j5Xepw*Yyo|YqoKFonlgZO0Z`=w&8(+s=^gyp_fcv!7~YWG+`T}o
zY(4luHOh8gQ(Ezi5}_8#k)#0XGzN-M#=ueHwXrH<?P_k+MBrnnF(GaU_;$gxa@-Un
z-6?Cn$e|B+2jp%wP;9pEYlb?WBN7H4z9guReRpW|oX~4_$>u^WnoeEQFP9q{xuSTk
zVdb%Sm_BYTEh4j=5?Ga}f^dsrRDsuU&XVKEMkwJ|D1|w=|CL>k)di0egEuF~FQ!>0
zTi>XWFQV130~7C%Z>fGo;y`PN;hM}W?!YLpGnt9GDI!rZK!u+(mS!V5BGtt1uF6)-
z2`8A*G6dL(ag_#8&WGl+L3;3u12{EDwFOSX5+NHpmU6Yhm12qs=2y4XivRt7>$US9
z#@~zOzB?p|J{g3)2R^I5_v>WeUNf%syJcM}L#WPkIthCUOR=@tY4qJz1F0$8ryD|Z
zi(AXn@q)C7Yf`!dPI$;nd|A(e&S-+Yu9w$^Fkwwl+W$K8g~3HI4To+nL<}qc{$S+B
z+JQZ8Vq~^cGt#GhB0JB13}#n+D$wL>(SbJ%-nR;W<Q(0;vuI$wB7omy!NFrdr{Qxj
znj`Xb#!yc+`T}hXZvX04E9#IkMO`+ax~%K@ln07*o8eD&3!ogq<w8yH&>dsr)Q>{b
zzkti;BPC?ILZi&`yQB6-!!cH?;hlvF5pk=pH-2NrT@e9?_C!$^a6XQx#FZ+2l&S}w
z9hrM2Mz-G@Eu7310_G;=9%vdREgWFy3g39&*fx8U4P|GVO9!8{qP|wz{;t}vhimER
zIdJZx=D_bnU?KfHvo#C!6wPV88~>}p1fC!1PoJqV_!Ag~?ksC?;6tKdqv^Zw8fB2;
zExn0WI;k}G*@k))P721ZkXoBDJ6(IONT}lF@-miZO(7_FDy%&w$aJZ>4oTG${9#t|
zN&QT*vEUqJ^7s={7(n6|TjJ2$ePqdShnY-%Cx_$3TLmvRCF~NOPVE(&TfF#2c>9O$
zxbKog_zrl|e>pZ>bPNu4e;~DH@;%UZaV)^xB0t1Lcv$?Nxs=S;^xBTZXcZ(HVi{8~
z>c*x_fw7q0hJ05h_X>_G!kEx{5N_9+@jx9N6@_V>J(5bdokk{62bP1I5VDqzf}=<s
z{PSDAQB2K|-endS?Nxoi_#j0yM(~_M>}%AGK%iANLu4;oLHL~@)ovZbrpXiM`iM`V
zTk>H5z!rAC-C20a0l*Dzx98BO=P}7YAxr<im3rGoZS>_U(1pGjdAVH2PB7Y>0|)bJ
zt-u{hZJ__wePm^y5HYab)-LU_1sx)@AgSrY-0ht$liZnee3y=0je`!^TDP7b%6CC-
zf@M;yxAQ&yS(Pm%Tx6Ft$PoI$P%&ZM=t$^<4-f!|<xwbvuzsdT^gmO;$ZL?FcdU~I
zwVpqI0o^jI={0ncv|f&+#yy=ss*<|t9^ROS=GXhf+^<J{M3lNGq~K)C^YgYM!kRX(
z%f=;2)rB~URTT3xu#bY)G>>@eY3wNAj+968J|Q3VY$-2zh;8GXwx}IIfh|BZJltgL
zefwHmjtHAaEML?w!wazV)P@&2s7>oe@-JsDzx_1zT%Z7gv>5rMmO^slA*?G_OpHaV
z6us3oqm72X4<1BBI9Oyiiv{Vbw7Z&2)}eBNHZY(Ki;L8@+GtGe3kcFci{Jwp0rW4n
zjw0_JH$5PvjL(z*WNzAHW~56<nOt@CGXBp*=rd31ce@1jNzVU0{Dz-!Oo>|%xH`Zs
z*9O~^+;FLJxK7LYE^-iA@-dFq!j6=V+aKhf#lx}kuBlKOl<r>MiCMj`AEne3O^{Bv
zS@}Hq<{=~U2B*wg!ALUMd4~pB{oZ0otM(+;)~E3i@}-|anzUmzh!gIFkA+`mpIkzs
za1XU?Jlb-QYC>`k9Gs`I-(>G%leV&yARyzz19hmFF&@IF=p`&=SKdqgw%k9J*BXai
zm@V_vSR6@b^iwE_uEmwnQf1qLpxCTR%CD60dWpXkV2Z<jY+jeW;+JWoJKK<QXEUpc
zt)VL$VdG*^>;G%}4Mr|ezTV|zz%l1`@NQKOF}@F2T7p`)V_U4+*`>elL88x{oSh$|
zJnV*gkEcHVmF&JmOG`0UJilzT)8QvBAq{}8ze;JWk$4g*k1%dL%87&rf@&Q@LU#p_
zH2A!0mfS{2sX0A9OonpfS)2zeGqmI%bifqDH3qOteco;YXFs!Rf1rOJH_$pmIY^Ht
zN^QX<=XGY0WE$|&xWgF2(2;s$;Pl%r$5Q<XMN~dDis+YSDyp=vJS5vFORpCb%L-Tb
z3*cyh?JCv0juS@{G`n_eWl8?M)2lV~{$QiJMAXi)(@5f&VuoajWJNsgw3ch8`Yaqz
zZ|t9bR2B}1GFK+d!$?~aPc+}Sn_D9@iN({B_<dz3*y#JorH;t4olT@QDwLocdgJ2*
z2Numq;y#(z7n$bGA&l=T5R2Xi$8_j*PEohIiZSRO1^XPW#zF?KEe5|>>|;?`ac?c0
z*c_fI>a7Iphjb~$4HaniK^}D*i%f5}Nt5-;=6c-8Qxt6=Qq;?s1!-ZN>4RZF#9_I6
zjvCJ;9vo-s%(`U~tu9{?JproJZU~kA+aq*cC8(psyyPz4^@gc0V$^{o8-%H2TWtQ^
z6q4ulyjsag2N^WAja!M<9-V%U&zJ`ET(`M1I(wD{{RBcJL^p~<816DA@N|3|x_SG!
zs4*3K8dKi3njFD_KL2SWt4!tjNg*lIzwbiWg7?Igq36RjaVq9LInTLSRA|C$jSqTw
z`1z+p^Rxz(D)O5&N+|_yg-mowzb2%&ZCAdJy?vS+h%p+XZRE5a5k9F8&?I||RxgFd
z3*M9^sF}NiZLuRg<-ad2ig7fye~(!POTgmnFgop$JgLTY`{c-JTY;>@z!;h^q+XX3
zjiNFkDTO$iBL2XtH}~R22c?8~2TnN!KE7Zlp*Z$0W}RMe|5%6)gNqpa&;}cRaQ3$?
zOGKt><y6PKw;)i~zUmCaN>gj?q7aw$&t4<PjR}v4&Lz0cZc!F|!dvVS!)KyFhi)Oh
z9bz1-#Un$d^HSzyv{CXtKt{M0C20OoL|`p6OjP*K2CUyZ8-}9PIwhGPVod~+r4Ncu
zvaw}>2*U1@?|0@_;O8Zln)+|jM&Z2BByaan12w_GspDGuYbnoEko*mpMTzJ06gi^#
zx9rR{Y9OAo=^`h9-MDUCGDvbP>2Z&B@WOcp0MCbhtI^dpxruZ*@hfSfN%321s(;O@
zl`upc0XYJ?ocByt#kpRZj}?}FDGNINwa7t5;6D5FNx<=nuDifh0BvD?j5cZ3(ntWv
ztV^IIu@>y^K*vOMB{iq&@_ugaU$4ZX6BB^7ZbjST)!amRJBe&;2(?dLPS%ND{dtV(
zR9&fye{CK0k=Qx#&7+TW`$fY4nF`J^&J`dI3zfbH7=VBHU1}8?IwblDxdN}q9KDEn
zITEH~a_5=KpeB5I?V9o!hoH+nptHXZb(+pCb{nGL$wgTQK!=~yE5Jt>LCswNhc63<
zDJ?e~he)7YNUlcnb3YPK89AYC79-G~IsSU8!SYkdlsI07kn}ZZnRx^zi@l+s52k4Q
zCr8yoe}cZ2rF~jxu&8SBPo$EBrw+_SufnnnP^PwxSOdjJ@SP_geHE(>)mBj=m?hGH
zYDh)(4E6m`2b6NHEYx`!>Nm~1(IqQc9A0CE!J~z`PuBpUvVz~LL5AIZr~~GyY-+GP
zTJUn?-KscZ<KKQ5np5m+1O2`wkvXM7boU^?Axw{0jrDLl&1uAA<qe5kvVAF9O*b==
zFNvlbd#cIq+uJmFWSIah2y_ijmsD1n#j@UE7CjA?;!85Z6+o{T{ma0<@XrCP(=FGS
zjBOz&y;vwO&Idc6Ao-`~H#0sBjyj6B6t&Pt*pM6+Bz4eIuqFe3^1`RF=jn@4#!Ky^
z=(V6>mog0plS$)?wUx~hd<RvQ0W<)Q)gJ7O+z>|<Ht?M8C3>w$Lst76l;84vZYm;T
zbGcpL#RM-z@gSzinP`S$9HMGVx?=osh71He?8$eFxozmJek3es3*_?1Ak~L?wx<p1
z_diPv$XGxMm6-Nyk`Fcw<rHTMc^up{d}NI6!2QdYH+87v#WG!S1^+VLH%(UR#3SDg
zz0bg=tK5tb@VFa+JJFGV8gW2(3|2tWDo`kxZK{ie?17J83ksX{T|R5vd!4uy1Iy=4
zw<q?oI#id-j0Y@8)b)MtQ1>QVdLzleJl;h74&HWoL|2^B!+|+XRiE#%%;{;4+&XZ~
zuY6iez0pNeBB431r*j1n_b<uwIX9L4kf=U+$Bdjyk5-|i>C?;RUcqj7Fh4_Tz=ad4
ze-W!FHY8X0YQ)_oMM(=au~Am2cC@zNA@j;bV$n>eo&`PanOpRSd0o>afdx-)NZ&`e
z4io%e-v&2)uUI(C@FGmNQZF$5i6dhWNOqplo+)iz$h|NU|M|AjO|UP6uapZ^Fc*)%
zDl`?ajn3K+v~-;4Lv{-2q$4UQNmx@NPH1#(74py_ji7S(R3Djo`SEnI2+<1hOZauh
z(avTuh49D-S_+^ThX)$I(B>Y%#URA(SlhB=(drAd1G`w<9MMQ-E|48sWHOan26G4f
z@a<$6iCMfj+KY@h8DqNx*QQpBk4zS>*+*(WV>}#16B<-xm3DBr*j94E3LqJ>k=$Lp
zRrk_4qxAjyO!e(g85lv1P$3#7P>Ye${r=C(BA-d2h>16%zEYkLWD4QoIcNZAmHoN?
z&d%-`^loU|Tu$$QL)!YbeLI~LG~6fb(I7=jLsrnu3Z?XnmwXE{Se3CUao+zcp-aA^
zkFh10wM00pPH-zZHnH1<2H5D%3M1a=jA=f);=05y9Wn;2Wo0%5nDue7*;?i+jUUrM
zWbcq*Dq^2_HP<eAA_x&1bn<|0bdMlY+TDDbpW7N($_M3#f_^KVslb7l6^fcAZGeeh
zCL-LHr;z&RR#?d4nA<tzE3V<A#z$S)P5`P4<~;z-)c#fksN2VO`GfBR+9)2HPhZSQ
zUDiH&!93wje3#Gh;4RD*oLuTzpBt}>>)D2tMUQ{Yk@b-Jz?P)7leFzj0z(xx$Y`)$
z_;!txw&4v%bp#acyEwVbk#h<pyua6_Sflx0d1MaNFiUqBm3wBiN33Uk3i9x0lqZ-E
z3LC^Xm$Ut(E*<ekkP=Xp7~ZEQ0!_jjD(d8ZAvV){y{ol8h;kX1O28lesz(V}<$BF3
z8=ZVKoQM$meN1@W^Z1&8nBHRR(Oyvm<Z=te+=&(2Z=LSFe=Omp6r_wT9hlG9k>g~S
zNZ(ogpiDS5Ha;q(9MXU3Hir8HH_1H*`@R&jzeim4Ln#6J_NXD}cf~P~uLu#caSN}(
zH};Gbjl;i3`ft16$LTj*wkJxPxbU71vU=;lGvk6D<mg<e_4$U(TAXh_2U)k<c2Cjl
zqYeQ|ot?xLM!*%hJOe7*RRv=(V&4A^Dpd}WXsS!dpjNCTC3KY#*<p@Hd|_M$yBfEt
zf~G0<nr#YRCO4?-6!&p?5l>E2BG}u+FJh!_6k6oIXZGbkVoh0Ni~M-M&s2%MHfjFv
ziff24SkqdS>I1Q?D!Hoib@Z+Ri|WhvP>7=95l7bKW7wv?CjI;{+QV=t8HhVZr*cTv
zA<iI@P8*%rEhVl*tW;m)=bHDUKH(l-jl6jzVOAv%4gN2X2N{%{_YzEvK4uKXu=hh#
zX}|bv(U><aJXnS|wNL#=Y_|8yH!ET3@ZhneP#Gbg>Vl;^HecPyG$|b2WOeQr={Bc;
zhb+DgY?8R{A2C3A#$pbZg7pAQvB)^?io(nJ(%SS!oG8beEQfPa=npzBHFiTVV-#mq
z;BH^Lmg?z5_NTe@A_EnTJ15_g;`eh)AmTU$d0vmPMkALLm;LZ&A+qyIGgo`~Mq?Wt
z5@(v@VL>w1Dqd^}TGhE&OJkIz?Fb*d*V$8+J^$7!lpB)%>iLEy*g?}+DfRk?*$p_2
zVzvJvC4bbn&Jd8NgK5?dAO4nc68&rpS@d0cie%c{{L2#B`G?7$92!!XEX^~YgR>L_
z4O&Pd&PJV!iZ>hpDB1>L!HGBoFo*c8Cc^RiwMXf^khXT-)7#m=m)%420ojwHjxrKE
zE3*&%XrWFb%Fr~KH8KuJZl{Cd3880MG{&-2hqLKF9jvh+n)}hf6@>D+;B!^|m;Bv3
zx9(yOx->w2&NFENe1QmenPxWrpLi6qB7X&70Z(K}%L;dG*B3&Y#E>B|ql1xy-hk6w
zquU4T#7pbPckd7|3#J&=SDQXUqPEpRIg&G<k6M)sK^xJIlmtQduczi+$w>Th{cq^;
zY5ooKl1VKwX;2Ugc0faGdS)Mn9Sy?9XpZ<u4LT0ghE4n;QA07>4sTM8$zbmM3sX8U
zYwo~xjA`C`_S{;ec^VfDY!WXC&-)1TqH3a|G)bAew)Fp@6l+ki=A#e%M8(XZw5?(7
z!!o;Tc?B$V0SvNEKz(5B{)d%SwAH*=?e)Y>7S6fT3%?T;sEi~~nT;Tp`C=U0LI$RS
zxuG%X@}k8mZ>yqno4dlAikQ>{(H3W94Kmp8G;aneq2)?}Du>1^vW%<|_0vtfM-51X
zMGB}abl!bixCe`UVw;UUpWtXkXJ&MyJXwUq3(OqF*DN{!&a15M>gmI%Sj$DnRikQ<
zGjd4AqBhb63hi^gNu8Pux_!lp^Pq1_y;#P`(DKFkCQ~F5WF61I;R1W(H!E0b2X!i)
zX!>$*ECgjv9cC;jav#529SLLtsl<h=?nHA4`WMusi`)U<V&zJ={-gQgT=%Srq17+H
z7k4W>-ON`Sw$8-8ffT$^&M?Uh2s}8EQe5W|QvC2{qfPuFDZpVK2Y!LfTKB0W_O$D=
z4UW7kQ}}n%*8MAtb5IhIk1!JIV7wpHS`4gm*3P(4TMoY4dBS>EP4W%RC+c=g`%GVP
z{T3{5-OZa)E&PR_PB-YtdQTj=wNd8q-RY_nUBxjL0GeY);VZdTLv%S~c$Hg+#?(Ug
zLrOjrV(o&!o?=ZZ=g3k9kp-|YHAkcGtd_(eKp1qEK~H}@g4F0RYG!MLGZ%)YW^ERg
zpwYMdZ}=_5M7KZNNim2=z<$10!Ov+Bv71UE(Acw+=KM!!H5i(jKn=4<*B5JoB!apS
z>SMc;QG?}U4;m#E2c#gM)Bsx+7>*+OBC^?1+#D@|Pe3KK!0BU=O16{3q1Bd$=S3-X
zYt`j6mNs8<lQ^U7@4T%J@ff)#s43IG<(uvX=|#_eEObB*5@xKuYG^D;#)%y8$RgA4
zPS`B0<ti2B->}cWQJt&}h#uzzyrxdjF-zWbhO*iY9wR#;Y6X($u1wQ`QT+V1oEvp{
z&kXWL37LiQT-K#j=e+`Q6KC0qyx}}6`5&7V<bw5QN|aiU_#n&TYl5Lk%6DgIoOOHn
z89z31E^a1vvJlyqQ@Z;!?4i-C*tcAB=Sw9-;hN_AEE3X3B&;@CyY#(0kfEDH1i{4r
z%*2lBl-WRd?;(Zel&vy?c=ex{cJFB8W8G+kKbZnpJ4gzbYN*3x=J4baS8D(N^iX3)
z5w$60NSNhzE=Owx`xEA$xy78|0b;{02Cd_?MR=@u$L~AN&$4)8b;TIoZ6JssCN=2!
zXu398PYN$HkYZl>aIXubvWFx)g#8g#T`}%&Qg~yWg37q(Z7!(Nuqb$w=DEE|giNq>
z6?thPk4i_VraE0!mI01MCH82;py>K#OFhhTjIa<h@gvMHrOHRQ!vF5sgi8|@|7lO;
z2=xXu;BB;24u_aq@Q$roeU?5!>&C)YHKGB4j|+bizE_2(m?b1z@W5~xXE?3Mj&jt|
ze9jlBi(Y~Wp9Z1GX;2aMlt>IR^g;M>FW9CzVo}OKWKSn?B+Fag$J_BXdITxvBBt-2
zudO#Fq2i!+(@;M=Lnx<hKH@SZF^MTM&mFMwm5$-F>)q12`WmdW|FZ5BB3o3&Wf&-r
zFFnpZNG1DSgWm#iU`k0-*Dp~QpIDGBeNs-?zy*aS2R*Db`*GJI?%gcdoN~S1Qb)z%
zr26pqvdcGl55<1eU*+QUO{da_rOQ^JLlMwSaoGP3NM!sUB<wJcz#)j71!7n;eZJ4d
z$t)}*pz2Jb@rj$lU0MBRI>GbZ?P6eNBsR>S1!lP|#f=(PTo`8ro!gW;X?+9^)YW8?
zzAYA#d-}stj57~mbT`Lq`L(3rw(F;~3<P?-fir9jj5$v~a@Lnsc1ZpYZ_{Gx<jh8+
z0+1F|Q9seQ(ZFc0dd~hkQ%K-_DF-+ulvLEx9DZ{wwOSZHu+p{G=WD6;C=?10(%B3b
zOhFfxzc5ekNv}FDY`A$CITuI<+7H9X3<NZh#ROP^Ew_DjGW@x<Jez(8NPJT{=B8Am
z)1*N}9vkb_5muSO1)y#Bk3IaTDln{LK>=G+`qvziJzbI{7-cjJ_lv?TPoFX)g&jWp
z1zW)}CRT9a9mK=?7H#u<!zN$-xm_r>;4A;Sf~FGUFh?QQSw`-?gRO@=^{Gw|!|;6L
zq?_&hnaW(%_kO{XJQXhHkmCtb=!!uUxmy2!-o+3@XdHk5x+woJmD%0UsCD3x<p_7u
z^Vv)NTnR3n^;Yb4csMX*2<dlPRe$tA)Mzz@8yRVG`Q%U=G3;m8Yz!(yo*7VU%@;cC
zch%`a>XmJX7a6Hjo-BNqI%&)5-4fe67jlATj~O;%^}_3z-LY0xqoSp}FW9V)yAYX4
ztBELX{5#Nf6KrJ$OaSPAGPyswAz<I(mfl7<vCtTS_fPVnfc=>@%{HzW-&Vc106Q&x
zdml<i`p9Ixwl^lcdCaB*MqZS&YI3|4#)5=WWs?_f7`Yx^{rMENX)91A%OtZ^95k+;
zBgU|t5?^=cNtGy@WKqY-`w=e6FGQiIz~{J64#nXVPTQvy$-;_?W_w%HhYc>&ccR4Y
zz2RRT8k^jF8YzVRsNVHfwOx$@Ls@J;es((u^4cd>JP;(D+I?>W_$RV_?3*Q{L2CEX
zE=e6*2-RYXBp%7P$eJD>qzWWyZ<1}40+Q9OTE3a5d49Rc!PQV+7{vA95%qEdAYfD2
zSq?H~glm=IbPZq`<d);G+z>J@-vBufe1p&Kbs&+|lcG2+SlcO%0HQ`%QYkjMI4V6d
zRYBjn!PGtZpAG#OGp)v;P24PsAbT7e%mr#Kal~}O5;4Sea35#Oe}9pm^QxgOIFU*m
z+edIt8$?RsCu9?t?_84=gy4~hb*Oe6Nx(y>rC-+?^$O>XF1Y7RHK%QIFkxhM8bm0{
zJCOb=ceaRP!};h0wRZq6(qUUC5?nG#9h_mayspXQ*Mgv~aFEnBKw)GBHUausb=P^M
z7gImm>!6J=nDbnI7Zh@<yk9ZIuuhiXzhlqL=rrIKlG)AC6FpPh4@VWKF9mvQ<U-G=
ztuo1N@G$PL8{FVC{gSI*A%m2_To(>z86UMMjkb_2@i(6^s2MpgR~n}?U0<pu8b;m+
zW8SpMEZWH39mK%BIO_(c0<BscJ=t0Ay%S%;w0Nu>iiQ4Dp~Hl)D`w(!!L}-8+@kFP
zhLoQ-M(VpdjTddDYEDP9a(g~lRRi4&SSSthvPx~e5co$ldPmOKK?(lpV+K%&pik+^
z?9J#XkdTiYh0YI_l9*~^dOMz#l5f_h(6+{)0a6AR`g0)7AAz+3wKxo~i7KaqezIg3
zrI5i9D^TEOD?u~4VU0irM~#dDHX8b`hpy6gLm0@5I8{)py>utrJyKQ1D*8J_3|X`F
zux%gOmSxaQ(0jKZ!I72)4q5B~BfXk@oFRxVqN@xZe;1<xGxQPswsSQT^ko`$+CW%X
z(D+DR6wosxE5nFdGb?~d9x=sSU4Jrfw$Xn+>{eVm5DY30hzxG36~eKBB9fWOyKZ#M
z4PQCKnFdl$noqhEJ(2xg!3p;lto>1FtfgY2ES)i*BWL=Uayova6w7rD7$_P>&g<Y@
zR2`PFhDY-P%xHT@diB-Gm6~aK*eczaT`e95xisgDY+030)Ll}G4_Ey(nMGF;$5TM2
z>=C8DRI5f(!v9#}SBpb_A&hppX^1S$n5r^c8f8Ok|8f!xDszy4`Uo=RJMqucTPkHr
z=jy^b2}g-~Wu;BY6%ny7C^x_QV>6)C0pr4{PeMx1d>-Tt;E><!!&>R<NA3ta2r3k#
zl0%qh+TqG$0xY+DqqWux7`WCRDORFji@1)_uH>;#B>uUiX51kzNt8i@J^y0k^0t{G
zjSRF!c{<hpp92xBeetX*Vb}e|HdrMcTn$BJC5-j`M;@{|ArpP)mmS#h*n}`AwFd+K
z&nWa`=ulqI<kYuJV&8rewz%|T19(^MwnzfDye}<3+3TBhd|ACuEPUC<3rlB+e+1Y_
z{!EtJBHEz+-EIM1=Ntd2J^2i))GyF2$#*S+hUke)RJuR*gj<|y{WNMMln30Q!Wx(y
zag%Sc#f4b~sie&sh70UbYFm=Un(K7i*8zXSctQtZGB<V4OC{GzX*4I-7&;S$wMC{r
z!I*FFghh$nZQWzOuiF~h`sst5oUc}hp<J0fVS(1cpj(Dee!~t87Vec@81G=@pV1!x
z<zOEF8RM}sEm#=#y(q#^Z)U#8?@YW|fH8RT{ruM8W<p+lJvy0xTob73gR1IG-<Ecf
zKn68zIw=s<aviVQ0(wPrDA7~A(kt-m&KPcKQ_WL47Sn?XKu91HYUcU}I}lkr%184E
z&5sz*aL*TEBLRhWQY(j*_+}dtz0$>CO{XqT4|uhlPY)Gu9)t8F5I>YRFeLnX>A43Y
zle#5}oW*`>25;@V{i#L0S*tvUwy=qGRrxNNf)!_PMPcmZFn(u?V-FEDT;!1}FgmMx
zq{0crA3QmK1(Z&|z~ZQqz;GNfE@Ho{>3{2;$>=vuU=pJ@lxG!^a}ZmTWWXD|9ObE!
ziaoq3dt#0aYTLygs*y@=5Rp!x^Fh|6qRNSxM=lJ@JZ(>2&2Z66rJhm_={1Cp6a|V8
z`U!gVV6iBrI|2>uoL?#u&%*=DQd_VHMLi&X#CF`${ooTa5Mx9^U#=b6yFP$z?mX`x
zXApZ2|FMXZ_(SBs?<u(R)C4*Z5D0?y17~DpBO%99+EEFRA&z~3E}j?8?;!w{GTBn)
zggrRk+K0(^jfaJBYR?53HDVu{cS-x!k$6SGxj1l7Q05Tw2}!Y-+)nFfE>(fH@V>s-
zPxV1HHhH8}C|JrN?xz_!Et^`-H52GqeMOHoGDbJsdMP>-7i;bWsKj?@>tv;ZgxoCq
zObb3USWsKEGNo}wIHb@JrnI&!(fS}M1Nxx`12G#^l*WshnMC<QY#=^IIK$X<K~8jR
zh}W{u=Lgtui9n3aCTXjm4BC~^<xKN-qSH|Y;Y(Z)-{lF8vv9t~C%~yt^s~@ofvhX7
z3UX8|^`Al01izkj$bf?N%|olEQs2aL|H;oBY-95-4AcHAiWGZrq08RL_mQ0KTg~v+
zZuknF&&<0l#9jjiNskHjB&p4&ML2RRKyR&|T&*Aa*k^pv1<Dr!Qgf2>`HPj2uBd!g
zF1tJMKH#UumCNn0TY|v>33WL+8lW~7)+Z?iak9Ofc=~_1dP#=$2RLI2Kdv>1enOJV
z7yT(9Vjaj;!_&9zpEIy~wBMk<b*kpLon%IjeXjWfxn`ySvig!VG(VcNys*MliF_>!
zLlA}0pk<!+AFLYpq<-G&0+$guZZAsQE{(Pd=&3V8IecG|8{|XCo3FI2c#jMA$Vl1q
zctRp{PF2TM#1%N3BXzRzk%pmNH!pdobk*plKTg#Dj+GIm+Nno~Lt9~?z-px|D3GUf
z)z_`^JXlG!Q8t_4*6dd$Y--Q&M|&9k-Nb!5n&V)NOVF;$2g<p;3D#hJNmFmZn!Fvp
z%o-vBEGa4Q`TWibKBA&FMY@Nheqy1RuFkUnvey<3Asu_WKlKRQw7c8%rjJscVGyum
z*T()EvYi7zAJmEu_+q`S5!17^AUssXZ~vP8g@kz54p)7vDtjGwQFlWkR}BVsk`Ep_
z3nwcT3O7>t@K*IcN%lbc|3Cw*#<vl9F`-|}dlR=r_Zz^t9Vi)!5P~ZDh35R-MrWd}
zZJ;vu7nOmJ{7J`XG3!a`gG5~V!kHMO)Me9N!wmEyEZd&o5Ps1(K`M~z#nC^7{)<>d
zk^dRw^kbe<(W#g47uf;dm8}>5NutSUL2l&xqQX45b3BPRD-aYWkdg|9in9vzskMkg
z)4{BcAnh03z^5C^q9RV0@lGGWtCxl0c9*84qS^>`(y>?z3$WCslEdeUr{px!(&Pr*
zVpx@-p+mFEf>3FHy3S-5C;A0808ySkks-CHWdKf8<eZ(ll|>bfq`A!DV=N*cJ6DbA
z&JrJBMFk-tXSTdb)dozFi&O}PB(*wfyHnf9m^_C!G#yy0M6f2^Jrf1fGr3m*-p3z}
z`JBBH9tmn2PnAo#mG*8e=je3J$B52DsR6bKafaD^-tDF+n~SNTZh3Pzo%$f8husIW
zW4SRpC0nrH6w3x)dN5vFW==<n>DNJWY?=VZw6GWj;!?<%)M4ru4A{lYn8|Lq2Bi#z
z@lbA^qZYSxt#&@@W4UgVsExlfaoG;OIu~F?u?XMXMHE3~+^Zv<e~Av@xaWxz>7>~B
z1=uQCetIFbNHYMT++Sz-GusJWIKY!`zGl6(`0UAIzoR!ZX-Xq7P^x$tbxVsZ*I5Mf
zI_8a(_YJpc$6g=<j41j+y_Jp1G8$&^FVrt4xMj0#bs8FKBd_wTY8(=YdFS&XCnPqJ
zJbtANv|(VoQmV;i*RZFr0OPp~NjYp3_Ehzp)H!0cX#3)@l;4-;3f1Yx1|fbGqo~+n
zaK`p@D<SvwN=eSk6<UcjX}<f5h=FUgyc(&fD0iQR3x2E6sCs-aSZp#*+s@nMDzYY*
zcz6YJ{~A1nUPmbspDV7rod!)AnV9*-Y}}be@$0KU^nx}t8XQ9fu<(unI}vyfs{SFn
zXEK?RMR3ev6I7XW^G>3>*(;;`VL{j-YOj2tRe~;8bQ$k+v7$0JXc+dKJPU}oX*|8j
zFNJDvZh@0VHSFsBcggiy+Z_W4byCCW5io~oovrlW2==)Oi0|$Dc7f5s3;+u(_4<ny
z<8k$ENtV5i!?mZHQp10U5l9L0Sv$0IX~5a|2FFHRnD%#%lknu?Bx%ijV3yMb1-NOX
zFi7RMsM@pkHv+BS)7xlRvogPaFJCjq#*Yo?M>G6ZU&7$6;jBPyQWLu(^4C1>1%Okr
zk?9iu&Rp4jKMPGu#DdcsZuIWcn7h2gesk$@rxGE?T8%!}unB^=Y|A+y)J>ZciE}g<
z!Qez9Ghxz~h-mM{b!R#nfI3t3*V_p`=ux2Y^-EY`uv^>nXABroL*T5xyB6X33pTw(
zU>6#fy!IV*bI(1|kf;}zatt`Eb@(FqhdK3m))XW#!-|T&S8v{d@dhBpDTg{LSYwGa
zn&5{AUbW41)@x{JKuADIH6Zi^vo`+5+#Nk6Vgc@&O&*|TA3-Yfguu`1J<4}dBAcq`
zZ`F!F$-`zT?o<Gcv>Tc}A-RUQahC_8>JASq{C27>0&_DA?Z4~2HFdN96V15dyA<lg
z>2Q{A)wQ*_&Qlt!?7JHNQ8n2**ZnVR@9YUfppbE%#MU(rvZq^#`wknJu*yNI+1#Y4
z13|p9v4v$fl*@rhd<(C#@3)o_t>t6%mmj&a{1`P$P#CTDmbi3git-3@9c}E5eyqzI
zwA-D@iI~>3*ZHYyy`9Z8Tr`tjyg#l%Hxf=FN`m%Q^Gz$<#c3n2n2e}be(FXOAl*ve
zPP~PlH%Atc&#>;~*b#rqbOwXR6gfyq0%gB%2(rcPi@UR1JthD-K*qoLMY5)Ay@KZ?
z{upBo*x(?__PFCQ67<fM|BENE&SfG>oeq)Bu!V4Sfm3ybqt_Khp2Vs3%d!U|TWx==
z%xQGDAa|>!cD-vH={O@S8<I=>%lHTk#B=lG>2GtaMG_i6N;XG#WHpBG_SwBaNASq+
zc~T=o;^j>~yQI>;cU5zfN9Quv-p<_`PV(X6%LC@I@XBceH2<UrFVeP2)V_D}jc{ej
z$#3HRU85l{6lMoi2k{~j%{RZ4DF0|idACQKckFR9{e55#dq-7ANLbe17()My8zb<#
z7o|CaHe?g|QjempUSgXG^;l@}tn1pS@Zois24kUz9}UouI9(h5{z{EW4KYL^TUtu#
zk23=?h93H2t%E*KYN1DY=DQks-(}7}OjDTD;^GCH{%QEB8@2DtE9#!e&5bEvEvw^(
zJ@h|mi(~quRP4dMO=4@XHg$p*E*gHVD?`w$gJ$*L3}uELzjWKcfTG77W!-cZzVR>O
z3jJ;$EbC%HYe^O}n#FBgAE44BI5ZUER;V1t4{xcVosTz4XG((x4Ast5aXV<qF*wdc
zBT`9$B*SNnrGj7_qHj4Dk^#aLXJi*|ZcbHavyx66!3)JUz$4~JX6V0c46_>%38UFy
zrs;|+OUFLPa63uSUe$axXj}1PBR7jvvy9@rYbP5M2{gmPO;NM#w;jPPEkjZSj#T4k
zJX{RDjmD3%poV7X_oKiBFk{)TQ<2}ZVXmSlJs#(mvM47@<?JGvvC0gn2@zqTHn^bM
z<q0wp#<P8kx>k3&bII_qJZQ64_@$MRO*!Ht1~R#kG&k<A@!Q}JZib@_K3IQ(HEcyk
zPKWraXYC;4XlFpEK@&pnb%TqBVyC}r-upJVZ!i`RBe_UfIHD-(IH2f{$6XEcOy)!5
z{dJ7JSTotJdiU_N3V?eTrlwsESzzQI-x`Q!f%kI|4)$8IH=-)~hfF#XFCu%6B8hsw
zDWU(@3qGg^Jrp?`BtMh|6Dv4OaF_8DwoBRu^(!}TETYm4(JTpujK)Ktye>dI0j5v3
zi=9@PW-UA_<ZkDtc(QS~>GYhEs4k1a|FYu0aqF~*8PtmU)8O(X`{JLZUQb@D*mGK{
zsi~7GMJ6y)Rw@Ddii2$*?20g*#uRKMY@BnshC-Vb$*0X5?N3J1)5(z$aw8&>fYH3B
zsV6Y<h(WjP;PRbLFUT*V<AX(QJu?WpQa<~t=`M|u<oa8t4je9EZwnoMGSi<g=zT%+
zu@>gu{&J`_lyf))Gg)2kn<j8r;Cz9-G>8|Wq(Wr2vYraMfQXY*ol16gE!g3&ud1<K
z;EMa^z~fDDrs%p&CDVgbfJp#4Vd!7$QtyoA!WDE7xkr<z6FoM1@gP1f1FC!bfD8$p
zgH3Jv2a#0;Y7u&P5#OhMDGk^6<fXQXhbt~B;ihYi#_<L-4s4rwKL~pG-tG{>^SwV&
zWnShFhH~fVj1OW4e`(cxY^`7_UH5YKN$ld{2*twKpoi<UOK~!%Zgpzyc=wBf6{ZKi
zRi(y8FwDTr8k7XQ#fFprJ;np<m`jeUNhj(0z_RtlEil+kH7<la#^z7hAtQb1N)Rf!
z_qXn)N-~6>zoqGh=Pb{XMC#-jpTQ-X93Dl;$M#zDFAk3f$Q-WH>aWou9P+U=BEP5K
z3*j&iNU5jWL##y1;2@VYXOvy-9H8iT7wwlIs8SH%<E{s}ioI>|ys?QRv%aQ^$=}Vg
z&$rqt`?$zi9f@T<1EX#UorK4CffkQ9pMZ}n7sCkGko+{4Jasb)c?6u$9j@-0@IjZy
zZ$6bC+{q1G0}Cy0nH|ZFb%{`*b_Lt@22a%KjE5J@(PL9_WUPz?5oHoKkgC1NiLnAi
zmK)IW+_jSLB|WEuM-QcK{k-r-eoZsjnCuR^t@QBfAc~aRaIfE=cRFU&WrfwmQqL%n
zkMxkSQbC}GoZ67fo30W<23ZXxLS~wNaNrBa^S8bC_wQj!PJW~fO)`Yk3~>fsmaHn{
zJu0=7t=Q^|8CTh3jwty0?@B1AH?GJyqKp=2-xRH%C+lxqJ$)Ur`HOLlpbYu0eEbAD
zR|ls`*PVy>Dc<Y(3YoIy9!{vaUNzykmr&yU_NBq?q>u7^rWvSyr!(xlv9^)189-<X
zGBwUSx8bL96v~>2z7V4YoLnig5LQ&qK*UJV)8Y!DWmW&H`@F-7V-#{g@u68(BIY6)
z#4gIier?`TFZwUyIU?FXyfyz}<}jiYkG*pqyjOxAhz7N@YcRD1(~ixRf*T17hL+(T
zqarsPHax>q`567K)DbT!qx6`0oC!!L#m(|PjEqEaJkjc08fdyvraQ8IB1^Z$p$RH7
z`MlQHoMxYI(xQrd{KRDzb^tm(KB%eVgC0Kca24Re68EmBfF-JAn`S~%_XK+xD!4N0
zVzsxO-e?t7_4YeeJ20)Lfw=YQSL!68CNFPkr)Cfn57nYBeCQYZ6TvT8xkBPc!F()U
z=zcWUX_6S?@fER5KVLcXj#e;uI>Sqouvs%Y1(YD$kntq+vmb+|mjbUnH2t>Wn+44j
z_b^za9DW|y4Fq{T8)2*RBh6o-K>hM5Ghil|bAw047gI+<;_?u~>d<W*t&@Zq%ii?m
zoF*<=lfT-MUb^;3k4T0FgG2se&1)7d8epV@0evqiS)_c(eA~@V-pky$gloV<$^&Cj
zCq&(!<T5T!7mY%jU&b1Aihs#1dw%mr-G6IFK6%OTi^N_8vI0y?Lt$QQ(hhIPa`&m?
zoSx}Y4DQ>--kV4*WzAq+k1KO}EPh1_3qM3=G(3$OqE*W|Bt=g?dxEnOGjZ7}-}JG^
zSP`Wuf%1H_nIQ5^$h&{uL@l*~R=#>b`D$}B)_nv0{g;Ra50DMD89KPR^c+&$W}pvh
z5z6Xpl-A;R!ao;*51e)WWL@C-*wTsYwwh*wBdg+kn%Qp|e(2(nCJ4eM*wSJrzeo+^
zN*7iZh$mzJ+hRTK32|7`)h%B}T}er@tle7kX`9Vb1GLt-Z}6Ra3)#RTz^aC|XS;U=
ziv6bCIRe^KfA@lWV{n5sAHZ*Fk<VFiAU>43I=<@ZDqNEte1Yh@iG119krwW7PI2ej
z9Pw6X{*nidYSn>H2pD%cqNdK2-Y%h}jZ9u+Jk3nB4kjvd7T^3S#YzHL2vd?td1qdN
ze(_-b0=f$Bo@PH7mGSsLO(8{z0K`+67s2C3?RQP}m3C|h^K0$n`xF;Cg~nSOTRJ2(
zTzV(qXJ^`c8Do5hs24ohkxBHV=od}ck;%$3>+$u!60KZx0KeF5I^#Y59}GZ~N9Pl1
zyk2wb#uu_W%356YKtlFUTQ-sTJ2O39%#1Mi1~dszPWc}!uYye3b_6%MmRfTC+e`5-
zUx3Wb3Lw~jlqiOD_sQM>#ErEgnr@o(VjE0yP)44TgLY|9;GR2tagWNS0P3tLvcvqz
zI^UYxkD0~?3MWQzaCbgeerK|qc!bJ0<4^><o)uCP)Dx43zLCYt5we6(;8bV4O_X2N
zTl%j~$>Md6-gS9Dk`e9)G+qdwzJU(#WZ{l#>~0ZIE4C*Hnk+AC$}xXkPd!wo=J5()
zMOB<&Tu?e_A+$E2#|3^2LC_lR!4JhFy`LsBoeV(IjS;oa&6A79iLbwe1&h3=K&Y|N
zHow%u${j(7W-}=I`Yp?b3nc411Zd^A<Ca}W;4pSJx2k7Uv<MN6N%syv1U`&JFf24y
z^MCa8yU@!A!1<uSUc#S%j^-+2@F-bpTd_Thhq*8?G^rLB<%VR|8RW#AC4lj_CflnN
z10@wMcb)S%Nay3qD`W6lF#*`-LhylAiT@EbbU?$ncc6S@j0J=15jhfYEKY+ak^;KU
z`MDze<mZ_H=>4%PZ~Y^%Ydkts%7b%LN5I}V-M9ghmOEnZntxx4t0x*@fX<l)ui!*S
zd9i$?i!rGHbHX_&pF{mFFlLIV<s|f99xUo)t{O*iVxTqm3=?Z##vbYjP;91#Rjd);
zqQ%==)Xsp=rXSy1GMrYUZpNElzf!G^FVaEM5y2s5l$daUav<?l37#C8WTe;ocnvak
z$~X}I2%AP4Tw}xyoTe%d$yqezKl7$xE-N9Dh;RUm)}fuqq!#!OHa2m-Sl>SZ0y&C4
zY+-($CO<56d9+43b1rRJ1@Oc~q4T}sjyOGU7&1`W6aIMbNcIFu07E8<U<Z3bt#_DA
zy{VgriyOkDlXB^-<rIyJ|FL(42}(RF#q{P8RcU2q<16VN!LQV9ilgLwFU@l<!3=4}
zddbXgQS^WHEU-TIXY6Fdy3KVjB8}tif#j7$@2&zavf0^*=@Ku-y1ggn#1X*V3l4%^
z7?B5r>B}?;>$R|eBJ4UcH+peRE)IHDb-w|?6Zz_Y=>p$XsZ(=e0td_ahX_<Tqu3r>
zMOmXlGr7Gs@eSYl!1PD{gQ$gV4sy*>JH?;on{$;w`bnL9ot-v|_%aQ+2unK1=9P~L
zDx{3(Lb_E|w7pN#B!=g~I&(OBi=GSfKWYmbyB;f6u%Y)JQvpk_({4mgoK}FbwQs5Y
z|H4?MIv*ZNlsoMF5qNv-L(g!tYS)O=kv-i#fsr25C(9NNh|-#51k+QtxVYY+s-aR;
zoPH1c{ea25R8b<?E|MtXj(9z%ZJD+?>=Ld3EyxUgQIvjvK~fi;Z(OH-Qq~gX%Fsu>
z69|)353SG@MH-UM4_8qYhMldju3IT6>t}<|OA!U+aB~l@9_hu&jtb7+zsS`{=<X&W
z-L69=_$*7M<Y2Q_jc*^7*FgD^cCm9g_01e^cu$cT5c^YadyRN+5^pDOQ4Kc9rV-vt
zNweMx@Ri4p`1>y0hhE%fcziq)PEZHm#nweul&=_Zs9?YeaHTA2GJ!!scDxY;-+}Ls
z53#m++N1lD;O*2EC@Ctq9!jKMR@XJr$4}dj^vmx>7k%Ss>thPE=t$qUEAPv}JSVnk
zV6>)7q#s$gh!hd*kIi8+Ot)V-sop}C6tpoqHes@P0{;BN#yBjTa9q@L;uGwbz(xPM
z8*O=?^%vT}CbV7ajm%-b>_~8NQ|3|8O3~TRJIxPL+YiGhWVqca=v-4?fNB7}0bCvf
z1&9ayq7fl*!u8K3k??@VfOEfs#D63EQWCXJIzLX%dd9<li%y%yt%pf*)VJEl+g$0m
zNaD?dN#Em^hq6w`RB@d4TCr>dbME0s6~TgL^A3#2pW#O#z<d|Ew*zTusH$Ld!{RzI
z_DVVq=1AgC*@3+??!Ft^Q3jdk{#sYX2yF1iR}4IS|K=1*ODv+hj^+6F)Bsh7C@v4^
zVW!faDmcg3sAb{3gMl}oTTuJH-D96*LGiftQY3%GU`Pf|X%dbfC}Z+=0Yy|%)s#W-
za|;Q#t$3M1gPJoFW+@N|(s6zzsM957gXe4kz1AzQ`j}m@vy}6Q#68|_0^e8B0cxD^
zoXGA{ABfS&o%=UPjbXVKscC?!pUhb_0PV+flMrOg!519_KWH1=i-cQd-?eBGS{!`g
zFE&0ZRbh!U4RG>>BsO4f8#4jHzcL2wwGV%8WOlU}ZgBYk!r6Zu9EQ9?Zqjwxi&~I(
zGA)1BMVfpgz;AHR=F%CbD{JMzr+rKg0TKjTwzvx}<5)Lw3G6bN90GOC{>NVb9=ska
z*&(mt$Yk;<eph6|=W|dXatidKk^l?4sHFajhFX+XCMl`YbD9c^r}!D(cM$5N(}wzj
zcy8@CyYZr0=@vYbg&b8uns7aUaJ1b4cT@I|ibn+#{szd+{2p3XRW|ja5(q#kxYxt2
zktr4kx~Ps^20byEk1$LSga7|#CPRM#Y681QIG&gIpV$CPZgh6&kQLvk43CcCw#&ke
zkRVnc3c=1p`x8w?WDfxdi1;}<Uv})HnGXIs_TAy*(TcHtE=H&69rojtFFKzBG^E$4
zGoj!4a9`{cUJr{lun#iD3yLIAHUb>=kXHzfkQdMq;r9;=;8^_M9;tICs6MI$F~p*Z
z8Eto0lji{PSjgI!9UOAG|7ana7x+O0a#G#SK#4C!<ZgmdkzU43@wwrb61;&5737Cw
z?%E_BYZPD5zk;(8of4sFk7d#wVq?GfW>xcjGNev5k0Qfs5UlNwqBi4~U_GPz(3v0U
zD*<+h0!iQ`@*_m42>!=-NYA9~kAL5(m6Z^T4>Zb8pTFji2bV_tg;6`515<gpGGNqk
zNDCjECY;z~>=mqt8#`Kd1UU|9YvyCUcAJv`_J(>qAne0f_Y#}6_U%9|qZ<rX6G;OA
zDdDhvESwjqf=xP!f4^8~HJT-=7O;<=3v#{fdGeu>QoWGQQjD8o(Ha3T*pnswr!)3-
zj?d>Qhr{nqsQn)-+}u1CSrYp@UBFr3MrNEPuNiXpob&yZ>VJteTZw&eBp8@KWIvs-
zlbg~j;>#QwS-3LFZ%w`@v-71aQqNe~<-i2b33B-PFuIVRW_=}uany9HX7?@92zgbV
zhSw=|#PPj3!vr#mH5vQVW6cnY9>rDWOQd6Qc)p_%uF6l<w#*fGD@vC>FECaNp%h0l
zpSX|~v3FP)U-Sj{hDN*bP3sGX4<vTS)yb7_F|uupwt-S+^`j!-T4Ja?8xlS~4*FGG
z9qFf;_r1?wsW0<0Q{lyMJ}d4MAvKO`rNyU~)oX(rMY$pnZ&ncgrL`GKy#Gxt3j0RO
zD$5`lERnD4_i#Gb$&Qae^0o%Ue>5x_4k#>HQP(7puRj#uc6~5UGYDj~CZ9?lpd&sq
zS#Wd_=sh19=I%SWC*Olgbq8-8cA2yLHJY<Y@)YnBn#LQ-5{ZX^YTCI{*^QM{kq?>(
z1O?T_?4~753O`MYN!@!>jxglAAcot`k3*Mf@Xk4^jFL^ObbEIgoIbzlHjP>EGCEZ1
zn+<MPQ1F6-J?I|sSOwCZ0YQpNLUbQq$)?Y#W(-^nj!hS_7(`7#Jeip&pIkI-2+{J!
z2?f((!&>fY7wH${R8dbknngGo*=<gb_Oz|s&kxF+EV`<5PFp-Sm$`tD`G?Ba=86XH
zEabVN5%9H76^KoJ`HzuL)&F-OX+HN^rvi<;QXx45j#}A_^J8mMpdh?biJ1GZ8TVFs
zC1D1jP&>Q;fvOJ^!*8S1M?b6JbYA;RE89_3pRn*mDrI^43#8vnws~*Af+{3sP#)VB
zpxBA&gIv6x$%jpAGh-Q=Q0e-_RjmUI12lHpH_u>Fd?Oe*Nf}!UuJ5WyzBZVZoorJ>
zA{!_BObnbIDgde=xny|NMof2DRM5jV3G}rW`O3vkM}fmhJ-{u1kCo8KIu%oW=7h2S
zLL8bsXP;;U1(Q-Q!Nxjwbl0%r0HR-J@199N*Fc<sj~UZj8_`oeKbO}vEsly?AlU#C
z-_`dbd5J&%PRp()%VklWhgLZDO(FWam%V7P8ix_w0L$Jyp!iriL=<lfazgR3B_Lm}
zOC?<5oCap@l<PH#lc$aerS`p;m$U_B#S6*~hxZo7s!_UZUc=C58#BS&1%rD6`N(hR
ziaGTni1%_m;$d2FZ*8a!F=wk(Jp?N3D>3H#5I#@r$n?kpr~!0STx>kA7!p8Ff<#ym
za4~`46Yx!*>$sr-;$u9Gn1QPFRp#w`Jby;d!*+|aSAKJS<fa&x^MPk-uvt@V$oxVp
z3%>vRDmmqQ^XHrgRzP?tX%^+{N<7LJ3FR_ZFzEv&_kA3gwb`zPy*(v_c2#+{D4r}3
z-{EU0_#3>Budj}sa!le)?d5N#XO+66r@HGARUKEXG#5w61l(1o5$_Kd>#5VxKT6;R
zCghFBJu=o{ohIrolz5T_G6I-X7h?tbFfoYCXley@c;PPKDS9DCb#Lv#JlwD152R#j
zEGG<q_&O3``h_KwMYptr`6l*RsG+Y>>%peVvGkk9c_@?o&8oP0{|)#ASfT}%*hLL-
zAE&S1&&fEP8ol8DTcX?a2obhc=}|vu&4oePqJ-oISc*Xl_W3Ejo|CAo>@SFYG)K+a
z<gUkWJSdHX+8MRc3mXH=r=@Rs7F?2<vXeN!?Vr}6mI?f@YFLH^8-3eK)R`|J1faua
z^|~a^B@RhO?6H3%0^2*n8Iw9Y)OpNU)%#P^t(9}01}}*#`V%vYc08W2a)6`a=w<qR
zosp<-Kb|BWRrh&oRY1|)>}>;*-r8XPYuQ^V-SwPp=*sE^M9%SxMt*z$z<8s^(PUHK
z+kS4~<-AaAcF%vUu!OPQE(&p2y>neqTc#Dg7}AZvOCAZ@HC{T95o-xf_rb*yMYP(G
z4znEjD&eNyHI`1EB8?qTAr5AoX<~G@h(1x+x!^!)xo_mc+)Lw&T+ll)a#&$rYYudM
z#T@`%1?J&Sk;b{W%9AJk0-Ua4N~>UfyX`5QfLfx^t)xbvWnD?ivd~lVfIkT^W9Z`1
z=OT<1iU_f^lDB0T*AFyVj45A`=jlIRi=cDj3hlg}2pY1o(3X<{wE|V!mzRhog})T>
z2)&tU%3>GyW`ExGUID}}m?3(?{AF4{eGKFo%eE8BM6yB|yjyI1U2im_iinJ=koow0
zJ*l?pE!w9}uK%k&fh<W|gKyYzh$U2!nRn>+D?nXXw^RH&+s5~MU`=@6?oi`f6IqW5
z7sEDgCs<(MyJ2?i|52>@sQM^D2kNfV3sYOZTu`YCydu>9shkP`*)tqrrI3rO>{_%P
z9Si<&LcL*yti_8Sr*Lcq+>VmVyh(ve4x8Yyu*bfe_EnXIXKVd+{s4ogqiB{$oE|2h
zkS`+{<VK!~ePw}M3Unt!qobIm&&4-S14X6|(anylh%ZY>gQF*bGkDtA{gT_$bO%cb
z!U}_LiUQJCoJy<l5eFyCP$)i-_L)KwuA(@O>?{C>D!?YY4&{}i9~&;iHnzM;-DK=?
zXvHN!yV>N@qQUrr=a;^z@|m(0Q3o90HZmDtXhGMRUpRcL{_-1FEa1=i(6$7XUDcAx
zfyMg5mdA_oL|=QAFT~}0u}D620sG|Xg5LxV>GFWP*kEA%IEOow-RPg(b%MUQ>g@v*
zMlVd{3Oe|*G<bF>tTPIt*$*qeIh2d>8UT~Mb<mVuofPmYve|(Y(}qSL+C+*MZ)vMy
z%v3_#o?5u!P!`r#!*);|?QH|m%XVe^{vg9AW!rYwhCu3BEg0PzsrGotgFFq&ZlMcz
zE+=HSXjRmg0AjmOnx)rpn7NsSo-fPJR|z~}f7K+|Cz$E%P~X(}G6ksH=K)Ocd1$00
z9oi8kQk(TVdiZAK>_SUttHWf*(ngOp`LX8J*86-aNOQ=bJ6r2En^*MagX}*ubmL_f
zLC{WIlgRGxPK6aXwr!kkV47CKFBBEWwa>EPdT-03ATZjQyKk(n=-?|fY|Me*kaOg8
z-s7!UYbz3+#wiZKBBZ347+&Ahb*+DdGLo+bdx|u2jo0e^d~`&IJ0s{E{NHge1et}i
zMVp?&LK~$53oy%(?T@O1p4g%46cboK3iwx>>a}@8T}b7+QVw=21x@~RcgKXFQXZIN
z1>a#7&ZkN64S|AopFiy5?dZBY+(I(^48Ie*y&nV{^8?2%^SVAT7-gv>6)1~M7Cb|A
zwf1-@w`+DOFV~1c7`6L@h6beFqhhyQ07koKnhk&gBLqyyhvl!M+lKZNN)D*M1NALM
z`X|DrTqTXT`iC79miwdXp(dM8I)c$+MP2DR1?1L_UvvSUI5=6p$?O>{LM1;IG-+Zw
zj}4yvdtRV#9d&z2gCPajvfN+zZbL)ZLqO$+7dXlA_C}R3$MZ}~q{Dok$5}6K*D8%V
zU#g(g0R7P`|L2s^`Amxc=a$|2F^7xDeA}_gZ-!Y3)o%Feu(%{(v6%;Nm29>I0&|yD
zPr@klqyrqvT#nTr)__LOpfY^SvNCEfs=BpT7d{&rW<Jae(i>E=c;JyDK=`Umetq9k
zzAjt)0J!M|QYr7a>~2dbr=vC=k4}Gp5e_%!UeySrBa{HfvP6Ud_F$$-yqDY=e)b-S
zLRen<D*7G@2*Y;*v+PD}QYf<#jos?CuxT4N`gI4sWCG0{UtB-Ai@2jmXn?Ej0Ly@<
zsooo4i>5|F!NX9S6GU~{e#_-)?3!CzY(#KTj8S7qcaW+Sgo=rQOrrnUHr9-9roDY9
zW_e(P@yo?1#`p;a5+_0uONTp4#paVf21x=@#~?HU%bF3;WPcB}Ju*ip353pi&MtCg
z7ve(!784opZ=_8qaJOeaW`30b5)H7k)b1EMrR*N};vc^4QcR!<-ejgFA~`KWi-B^J
zk%Gi_N$iq{jw+t0;X)!SK-40zu^kEc<Bk`eZUw%wE{EWIgA0~B4F&ez%D$?OOZ0s`
zaTJ7lcQt+(oHhbh3`+eI6$9-TPda02ztHYu!1kO<!U~*-Y)XjDvs!F;#^I3+2k+s~
z=KWidpsSl*J*%~fLq3t<{D(zeFcolj&`~&amIC{TOn^o|b4`HxzKd^RU6NL=IO#8X
zAy;RoUU9PoE-1q=UpE++4Poh_MZl$GlmWR7rg*<Jx5KCswZeaTFWtq%qCDNDCj-y=
zA5p}J7&-THEcK2W{{yM%?9<sbMO3`x1VEn}<y%e-r5&<c?Sw<ki~CGEU3{hRZy7vp
zDz`Q|bHp;Fc^nVOFAIGh^+SA)l4pz2w}&6^;uQ$LNmBa&>kSXOIgBklEE6<3WeWqo
z#?<^~(VM6Fx5F)x^gPKeULZx&3^Wt@lvQbh_pa;l*O9`v`H2$+#m*2z=YtaE&Wk4;
zTNq$ONW)fCsF_~1$w|NjCT-12h6`}%-{yO2G2{6}PJSeZL?LWGu}e0%d<6sKy25=k
znsC*p*FiQewa%_<2iuF#V;sS-ImCGldY?JCoo%Y(+sV4E;D}~3T@)#ER3RA|p0CIa
z^)y_L7fX6m(lTJ}ZYweP;w-*l@Xo3)=NSoT%0Nv>^Phul@@1WqqnL8UoFfqQ66+n;
z51*H(Qr|`4nWWY-Cgq%NM9Nfukp4(Zu1VgIVL59cr|CCJO|KU7We~^;jhklKY3?>a
z8piXoqiYZ|?;!y4TR#UFYj&{OA!(l&6+nBwp(S>bKJy(NNC169^b`JiWWh-hEOpnx
zJ6R!nN*)VmQphdZ`Wn6in1c@}b-JKC;2V*>AWtd}nd!0ZS;bTYKL@R~EsBOCVs&PN
z>a#)=RE__2hZ7<P&aN79rv{GY1m`}$Xn$H@Xl&4XhMVMU6{NqLHAAG+CqH3KsY0r@
z#~n)MCO!PsN+-u4#B)o7fo7h!;Nqt9SQ4$Gr#|shsF7+Kmi+aFR}DGUbn5ruuaoCy
z$zpcc?gdxurJEI|#Es*}FJosW?Ni!3+3Fn2K&75jcsqdVBS62iC3NEfa|{x~d5`)8
zk#)az@!NJguttHsh`FU|5YS%K?Q)jtR10>)llcHUtP7!#e%!X`$TupvzF}95Qbcf&
zb!n`+&ojm!1m#eggqT{=?K4iIhi;i0PHAw~O{eK5u8YOqNI<zl-RMUsi~@_l+7JLC
z=g;C#p>C%3q?TI~1PhK#{H>d^3}~}4g*XS*z+I)Cl!Y3H7mK*Q0#1sEz&FS8mmn_&
z!{>+4Ek;#60FyLyq$2+5PIh-|xMXyt6bP5FgsplCk2~EF{mT%sqy#6%5Nmh7Wy34{
z$I{B~@s%kBKx!?|uhf1~M720f_z@asJH^c@gHH|`loiv=gvT<|;C%8zrFe!gLHKq`
zTjExBsQzdy+L$9mdv2oR&6@9;RSIS(cc8=aKh=9CWf3bj7CWm$;fF_JiObU=gz>4(
z4E@jFjX0&Js4|NtlBqoGXTp%Ft96Hz$N5!R5g??W6`O5!bZhnauEY#?HeCA`Absmr
z%#dwk^rO@Lw1@Y8sTHccR`fYT>*&D5G+DUW()EDODS!)#VqJ!;;X0h8qe8qJC%}62
zbFfIvz}6tKiH*WxH{LT`w`Fm*B&PxR6}#_QiSqN<ia&5o>e5M@GicB4Y+I?kr{AAy
zb6)EhkuXxnVxdMn=s+?#5ibhsOlpLKB{qAhUY`%<m>BA*k$%5zlw><V7YzZ~lvOH-
zi2QIKwcCVwEYw1GSA=olkUbJF<wv~ca@2;Bo&~yxj|M}nX-LoK<YX0`diX64YXAp7
zx)CdHQGtRf)hPow`a;kAU~1KjlrM9RR9?kHI+uo&X`)wP|5yPzNsS`lI3*mUT;{eU
z`t3dP*Z%tB_$$X0Lp~zNdh0dh;t8i<(d>S^G%;65mdhb$!6nU_15zt+L~O$A`9$J@
z_sc{<mXrmvl-&1wDikXtP{|X}R2{Fz*lAomY8!vU5uHL`Hju&Z;b!Ntxp?=WHJk0_
za9udLj{;BWa7Wx`6U$SKqnBylZ))-x!iB5DFtVZwrhdHN{{?}~)<FOj*(Iufi;l|E
zlS2LtEdB>1__2gxVSd8Rl6aT}H#IRpCqc+OFoR2vVBX5S9OVs6N5ObVAa2>72^4tC
zOYk;8BZs_&$ZSr4gO~<e+i)h-rURr=R<a)7gx<#yUh*Ln7v_Kkn}i+KbhRsfGE)tC
znrdp&7jgb0UcUYT{I;-{^f5b|v4S(Fz3F@e*7AjaQha$f@JHLWYz)?t{afhcv+%&1
zs1JE%a&92WQ+lGpqx_Y$9Fv?PVW5rE$hx4xDBIVF6uGLGhXt;B8>g3{oJrSwl}f?V
zTKs~{V+{}AsleXNPm7sQfk}T7|HY&ILk+fFU$gxk_N@ndz@@}68_m%U3_&!JHeN(p
zrVWEOr<cjM;3U)Uj>d~xH5OS4;flS&eC_1EFh9$U%|*?sE0D!j8t1u$&x8EcaCouB
zT4Z83p#TtUj2AcCT<qZ6j>7q7XPQr>^|qj&v`W{R5lb8N-&>1H|FSzYRhBX6U`-f#
zYoVkBvB5K>ngsu2h%cne7*i)FiJgi(MR|g`LfcNVKiRxB*Y!rsF15k<<|qEtr{t=%
zxh>hUd^(Uio(Ivb<Kz<U+hozSo<yf&S2z!u4ULnzOA0j5dF~~-f&DfD@XvlF<ilNk
zPOn_|oka!Pq<YB=AFRR?ES7B%EtwpvT^&a<R7V(F=%CHJqP{@>9~4I*VieS$LYG<i
z&o-n4B%{dT_|ulDB~-e|FB^tnk4ULYJY3E|MwGXe`s7--y6CZI4M0~6+1DKJ|6MBQ
zY<gLJm6jTHudF*OVscWFx``L!82@g+d9Ks_S$IyHZs6erhPo3D?C9n~A#!tQXbWKZ
z2T7gbA6`6HCK`Mpk(~u|bG67nG7Ie%OiuzA5yzvz?<d8iG)xr|gdWEenM1qj_Ya>!
z|AEiWm5Sj%HlfcR)SB&pcha05%zRJ--{qcH+#D_@Vlk-}iu|`H8sWnN#j3k7c-Xw@
zuD{}Rh^E8P+cG5J%`r$7$6t0>4Gg|AtV^C~88K{yq%ZEO#=Q9O`hN}Q;bWiDJs0yx
z7$dN$(r^Yq;7!Sxr4RgC&N=xRh%GN?u}-fx%%bEeA9UwLYb<3F+TmfH@~(c%nXdtY
zUd75XC|9Y9g99muZuRa#M?N$l_)@uFKEOk_o1g5>m||GOt5!SyZ5kYjS)b8A>K_Lc
zFfT@^U9<ENe_-3K%Rx>2KEPczGRpSgfUl(XgugwWa?vNn=<Vjx-i-3Q;||(*-}|hJ
zt@eemw28zitc9>?wUEMU+Z;CHgP;RAN40RL?84KHAs{jMU}&&h;pv^_cbeq__KVDH
z62R?EC>eaDFDqUJg&G`QC>+=C5wh;oJoM|z+?`#yJ6=*tk6I*!LW7-cMXi|KV<4qk
znQ))gbioiil-ro|GcD|(9)>P^=vHA>s<o(+?OnYk5;6M4jF&O1DdjNq6N{V3PtA#p
z9jBWTaZi{NPSuiK27M{YCA<>P3pVeiDI4wrUFPY);-c;QvxR<mLll@Tj=zCp!yPTv
zVllnhKzH@WSoz3;oE`FNGz?dBVoe!3Avlk<CQnG}M#LQ6TZ;2PwZU$Ri}PYNX>WE^
zHtbg*xyV?^^)WU2C_)RiG$&PFsSt($L?@kI5FwmurIIewdo)UR5nFUZtd<NO!;FAe
zI6i#}tl{u4ry~k6L)siBrNVcWLBfFfw>kIsZ3Legv<Y1a4T<aykCKd}G6r*UyxXAa
zn%JR{Py#@Yc4&{CEuo<4m>je8zXebT=Y$|4sUz7#FEIjEo0eGlob$5T!d>mTo3_82
zL5R9s4+I-Zdj(gjj;IukqlV!o;!AndH9pD<Bk$)CFtl<rF9_OK6gAA5+_(Dn9%>h-
z*`FRYVIHfVGhs~M1g!i(q542B6Y!Fht{c~X0QjtOAdy;4Fp<&eW{ZJCt)tP#NC$%M
zA^QY+t>Oj;Wwy$d;WCcr)+R~|{lXgIk&tF>cu?B0O`$NG{8;7$4tyR;%;K6PK6P7E
zO7bB$lWe*9R-sNYU&yOco9H^4@^3vdQ4r91t^-k00uA;Sq%HIR->cJcAfb@Yq~cJS
z*QaxAnf(X^5SL29m6Ua)9ILeAA6Me9S>#LW&08>leu=x+4+(&s;Hi&mmUx2KR~rbe
zfR1GfOcWz1iZ_|F2Pbz3$*=MDjELP89V(GyGPbvzObG}fo2ETS+4=)R*&7NVix#HH
zH-gd8f)Jkz{n+$mxIFUp>rzB#_ygO31=prOp!1vFH*V^cU)L*y*2P5vSNXVm0wj&1
z?N}cfNsQx%87F`jf9=kN6gE9g3AC8fei{EvitJOz+nitU*g`ry!+|#GlQLQgiUJ^%
z)3E%RP#j0x=x8}EJ0UJvRY>@Yz0tD@a*bYkT3qy`jCAzPo)OiyG8$2~Sj;4XfQNDA
z)(%Lb5ZRbRSwxZ`DE>C=J8?V*O(Zhh@zTQsfKJ*dOBt^`nVJ3Ic(L@#OBg&)c&C@c
zYAX=pyAksS!`UZ%cVeS#XrZ|eCjEN78K83ba3UGK+gg`-WfTyLq_TEt1z*~J`-584
zcKCIlB5t?!JD#3at1F^8A!^h($-!wCz_|4dqzzFUOU76fd8$O4NOS8~ysfZfDL4Tl
zDSyF=zIH^}D?1!ZCsxOtOF*7NNOgm?&0CYN)Hmk9lf)MGaA-gKPoqkw+(FEX22Un+
za?X@b{+roi6K|BrYW?T?Dc;&cb<A5*t<v+Zs$}iLYe8#*m=xPAI4se)%L{Jf@!vMm
zSRiT0et%_x%;9K4byi`?DpwA(px%?GoJc-(RqmCMDhTZcH!_JSl4P!&n}<+cBL$#i
z!Qk~^m8Sq=h!Y07s<$f1DIKCQeYzf%>}8p&Q`)zOHE31v|B*ELrq&)LigGi?rKGUW
z7Kxa8$HSdXz}0Bs3FaNisWcoD5B?rZoHghEvSWlAhZLE38|jq)(OUyd4`73CH^&Gy
ziY}sm(x{vu4t`M_7t)q2`jd62$jTskB(yWDIY2W;Z`Oy~nj#K>{KnTf?~$Snb|l~c
zP`_7Vr5crw0`56ow}li*Co7k3z!NL+M3@A0GXT&jn~H6MMR%r>tigOyBSxQ`&QkVM
z#A3iEFt{FKVpUeev4iJvV$s3ZGgZ=^C0RRJCpE-=OX_TKkWPOE?cnQ`>g*mWsX#Fy
zNY1<nFj;XYm{(fck3XU>f8CfNyfITZ#Y1ODb4*sjk3U&qjNTPaT}k=C-ZD|Px?aqi
z1!Nf2Qi>FtM&?tIR0QGKl(bx{ju87Yz;JH<oAPoq7;WO#B`fGP5)*xD{;`uZx*IKB
z1eVB_VY8A~28O0X_deXA-*l=G!=>%u%Ja`^ouAatpIv7w9Lnp`Z|=f7*=P-huav~a
zC5b_xF#Isy5P$Q>!t=C;%2x#T!W$A@MpLBg9XcssU`s4H6v(->40eGyM=<BndAlRc
z(hXCIBy>XuxE2@UyUf$m{;<L8rm#mY2qduXj_JK8zT{ZW9@gcC;a~V_3XGS`co4UJ
zJ*DnLcY|d8?{_yB%#8Xszi0K;i+zM7ANpUh>99i{&G<q{OGGSE8><Ocu~==rzecW{
zEjkV^6h72*Ss!}x?%B<_!7UHFA$}@wWMD`M4O7s}tl*XAU-Jd~gaGdwx8Qh}3_OQC
z1o<1Of_B=o<S~mUrQk`4Z6MQImw^29zXYz)CR-Od$}lJP9ue-<94GCX$vTD`^&Pe0
zK*Hp-g7DlrrZQDTNGrZMp;h4!ci}JH@qe`^v;tGE$r1n);277y`@4R57p4T$6Z2<X
z;(DI&gxk#}(cO$!?CPw^Zte*er+6bSg&b8y7HTdyWaIRD3Oo}zvXSyg(MihgYEshR
zmIVI@;IeF+&B~O0of#u%jSt~E9QBF^R?LW6TZjxn;L0axadPT*3@d7c=X=sqUbkQQ
zOPk}g0-;+*3L^TlQ)#gL^_^lyP5)9C^eXA6$B||$ruvhi&v;n|ehT@jYsVW-%$3tf
zQ?AY^fwJg{uFovJqF##G7YM~)K1QJU79Dfqf^+NCfa<nMVO#?{sx{m2yR#1kZiE>c
z+(BEzuQY`b2#;-JHgZV1dbdgdFE0**NjfbheJ}+hOXc(v0)ta|I?#nw#IlaPjGH(g
zPzI@#?#U(i#4w|APIIZtO4n0xO5Ho0RLFdFf>w7yRHAmVe8jcrF$IyxqJomJ$?lZS
z3YoXsakeH=ZC4<|+B)Fgk)+4i$CcIqc_^H&wFyY7vNk%57fNu%W2opIiGu~$s|g~E
zlT^!5P|1R>7Dl<EYGAlFQV_S;G!=zi0LLEjBKNFlKC~Pb#L;m1Chvt)3H87>4?WU8
z$lLkWtZk1$b?I|IoFTDcM`Js+Bu${Dq36niiqZD2x1@?Cm4cHWwy`_mJnRe}@SZ#1
z=JXCD(f#_-d{^EQ%2c^Chf{UY(nA!7gcY2-(iLmSYO>Wj;>yG8nqX|6DOq;&c3zFS
z=cmsOc59JP;(dZcFa!3rD$HoSSGqa)klsH#peV<XRWr^f(_KZX=?P{_s8I54c|KP(
zMiLNkc;H_Qrh>f|PM?)taRqpvvU=IMZiZ{`)u2jNtoBbD4cK(|{O2zpk$mR!AJ(w)
z6s24wi3<h-%jOXNBYtj_HLR0Tj8Mc{n~oP)>k;LmNN9%Tp3BoFoz92-qs?o5{8aw-
zLNjel%>eCJ$n)<-*85Y87$<Y>-~v+F!*?O<VH>S_gp1Vt41xzoNGk-<ISKND94Pb6
z=R+2Xk-<#Az(Lq{pW|3r(A}1;eNT(stqf8}g}!g@JknBm6XBDf3sGJ93l{U=cgl|$
z{1;1{okBeQ^i|ShF1#+Rp2W%nWqgWYi(%EIuq1q%npnW1lcl*VN8o^HH722+Y0lxl
zMcRJq`eNINJjOs$UY-zI?)j`B!GoS@F;D{!dm`FZ1JQp(@n+N=7GWr-p;HE_=o+El
z%+US68H^toO?(XlGy^jZYi%ykNIIjmIjX_MU3mJ1U50~L%Dw}Iw=fK=ezS>RX~)$#
z=90CO8Pe(^xD^D9o*fFwjcl*wc@LSg7WaBGeQ2JF71SjVYxL7FW%3FWqZbY^*QQT8
zPFMK}<1%%E0`b&`!DjrmbJPKXvj<}}%>=TwAepSsGKaW|#!U*cZb8&eNY9%nw~0Y_
z=t30j?mu4|=MWkbp`FCl^j7m1f}_eJagbBzFL1usN3(!T23OX%5V*HnM?nrfI^kS#
zo9+@g%%nvb<F;sIifiX>Ydw+*t1C=`7AVw*PYMa|idZIMuJ9x~XmfFyukSjJJ@TN%
z<HeCj0N)K&K9WbVrT!d70L>@$ziNf8{bXnF5vj=khDgi<$`Ke<$D6^=lZ0#Y6!qSi
zFRjBb{RsaDChTA)j~o<lc&j`0DG7xD;*`|Xi{|O53h7^xVDzX=f-8w+I(wUIdbDA{
zW39YK94Exx)vB^HqZitJ<Smh`-2u{^6TQ?%w1j>lqyGosNoVsow_8yWik$h8@pKA6
z2QwE;R-%FeV9gn0m}F3*pE3JHS`u-+uCeK``zm`oq*uz~B!8s@LdOjED^CA+E0^@g
z_U<_Uffgl?RZsKh!{m2)ezC;Yenrc(?)I{itvg`_n{EF8pOfx()e|wTyOfRO;|7*s
zgOwt+qbu8yz62Jj?YQl0=@z#)BzfD%_hx7b()&1B#PJT_y%0lyW|aa{tX5>gF)F3J
zi#^)qLf>>mH%o#EO)TVA2*#k8=Cyi@zC@^X;Du}Pa<f46RSEn||5uFQ;e^I65U6SX
z8Gqv>dn&x_khA2(MGi+>zZ*gHTYQN)$Y3ufRei-VgwLFl6lTGd2Qs9g7uisao9C}i
zbD{$T*it07ef7Myu`lREQyz$=d&(NQeI7eZc6~w>lE18SF)1L!4-m~S=6X{fNT9%4
z+RF0}yYsKcoBtAs#Jj)$N?^IL>@thuu6dh0T`aMmm+6lj1E>OuIdtGCRguIIwF|RV
zOM8>p5D`}4m}yv-A*tV%iYi9dwbuX`C~fV0;?{UQubNp|QzZQeC0>aMl}d;~T?k&r
z8RWpBt|Tk*p8$j;F_bOF(nz^23?RUS1P4t1FG9}Vg>2G{>Id`6AzjlQR8wZ}@RMy|
z#i9rR(Pkq~Rq{^QyHkZpP8_2=8$?h8TAH^=WagJuw`Nlur)WtWa9tbxHh}9wmS$r0
zqBdMI&O(gBJ<3B1j&9<40OBkE<xZ3vGqGvJ)D^)PyyNh3tDX^pLK9#jnI-pmEpOc>
z)qkkj)B__~mwJ;-CIw$`>AVw2!cKoq#D4ZS%>ew;R9lg{*OF0J8wY-Vf?|v9R(Tap
zoO7Wn_=+xpSbc^^??3!O?6kd@Mz6K`VgFsqM5yC|6NA1ignwqfgNw8f241CL4~0-u
zd<I_LXaC+^2yv-|G!<Wt!c-K4`Y>lnas^5FCa~=&>Em&ewFy_9tmlErU-G;*Pjpj#
zBRsndYoQnC%F+)WcEIaW{nlWHUg8T&>jFnAk&Khq&KDFBZulptYB%NBz?YPa6tF9j
z<wsldYTw5b1LEuEw*aK-K=ojs#D}*2so>g5ie>L-U>Chiouk5(6V9=an?Do`xSun+
zQ<ZY&p!bekO@}7f8b?~A<n!CWk)nK8<s8TP8r+VwjjYQVrJr}b2jj{)#(o_9>N$zz
z(2APM<!ad|mns~68cis;(~m2dV9rdSvV{48PX;?wsS&Z!sk{O98W~I6;dwt&Em4!_
zY0-J7?8fct;>qrc;-e%p<btIS3Cs0+NZz|hsH*E#qD&zEbw#r2Sj`+*4X>D<fz_|9
zL9J1=ee^Bg<Z3M-O!=Js&e`;n4EC7?HD@J)yI(<EWCu$DS?nn7atQp6{Nm-fna=xC
z#ADX}9B5y9BcuMclhY=0$4=S9Nr4%W@5;<BApagfNeowV7~;1hJW9n*6oc7O`VADk
zUSh*ICUZW;e2}lg6cL9m1`_%fjx4a;97Iqmd;6XO#%Mw*+E@LKX`^xs>&*z8PD}`b
zKEEX!!ZG9$MQ5aqBOO}vH^XjC@c)bQNG-&%t@F_uPY4Bb-TTUA-fRO5t9b*YUhvx*
zkVXy51nsCgdri@WO-5n)_s6fpZ<phWqUB`9^|Z;Widf@frM3=)A<C*6<<0BAjw^}w
zch8^LC2u^e_-q&F)ObtY90L?I>jjw|U`oKMmhQ9coCr+MfhQsv+*ypycW`cgl?<_d
zV9)>Vjdv;rB@nbns+dZvf>i@5F3%ys@I_xRPKxumZ{G_gMq_#^%~P7>xj@$s;~Ky)
zbNORUxnt-&7vKsir*MDX0X%Gk)1$*@_<V}tzpa38;9q81L<3)lO!4K*gUP@8sy2B9
z;hDup<L>DB<u{vO)$=IhIej49&`+$I*AV0x4QAH5DCz@`w93T*^EeuqilVgye_*N#
z0X9oMt00Px_=KAis-ZbeArqfyG-*8;1?^7o2t7c4h5bF+zcZ6q+9OC5>}_f8<{UG}
zgUM1XsrWDe<T$&m?=I1{<$m#|%UJ|bM}bh&Zt-7)Q&I=XEqUwX(1DcF{)G}#!WrHf
zEN9+FmC3kysan8!I`=AG^RJJzW?@{j+zScV(5-$j`SH(lgoM2$-<y@>IAwb{AzKu;
zSA5*hmiZt*c>}&$m1dz{xC(*xMi}7vE+g@2H44_u1(pSJNJf55IY~jCE&5>?GuI**
z<Xl(m6Kqz6e*;N<l5kaD3yM5Xd;{JCPQIzU<Nx*Wq>PbdY@l9#>$GySzi<cT9q<RT
zp$<=M;?4!V8EU1_$JJrFF%p3llni^a*%0(C`8mCG<Vf`cUnVlRg3*YIBq9EM5C@oz
zb%E9!-yR@`E^g}RHM?W{9J+@MKb}cEO#pt980MN>VUiSaI7@x*;S^NEr>fHtq_ZPG
zc|@W<Uv5=DRYT-uP+g4s!_`wq%dB%46#Vpx*A?B+$;>Jowmt)chh;Fkb;yj5B#`)C
z-T$rg-xZ++1}1N3J=6c(R3`l@iO0uhh0aRv-C^^GonT-{j|rVfUXu-Krf<T}z%FzZ
z&DUnbl4uV}$_loBu-ek+;8Ct_u$Mn!5lLz><nly8!X4jEnnR&YPdR4dkU6$8nMT;~
zyOUs`F*E3sf$bsyIL2hS$_1}OnB2LGRG~0h9nzpJ0(x+QBuc;8m4LJS6w~9lYCtGd
zyq^>7!1J?Wav7(>g?p=Vl9Toqc^X}wm>#8-XO$tz%Ms{1jvC5qF0F&Z^qPRk!`Gof
zp{DDb!u<1N6S(ZXs$${7;Y5>QDE(S|OtzrE!jL1r>mdQ128>ZRQh!kV*f`Mmz|(=8
z{`ZYJ@5cyjFozxGp}3!e1OtnsoEtH$pKA&t-!+mjBbJUK=as7zQf8$-dY2__z~qq$
zbYX{31(FaY3)c4c4jzv?>LEOs#9ygBmD7U5Y~__ae0<+x+Ws<R8p+y??$Vm3_>Gj*
zqw$9oE?+8S6E(~3NJ#^@VCc8cpEELL9_Rk72~2`mSoTw2k%~~*I5)wPe8BhV7eLE}
zuwA&hCRKM;L#>j6KG>6)I${ni6Q7&kr{+2<s+BYUGkOdaIpx^0dFYWfJc$=++de0x
zS$Q#O#oK%@-fVi3g^D~z<{)1C3y5rJ_8fC9x|AprgHt&ju~5ZO(Ex9=H-(H7B5_qr
zA#rOtfIhawj_=h^L1%0L3**J?Ji_;?p2LSnQ9kh}>xCO&#n&X5&m`+8L-jaQ+Y=c*
z4F*{q4Q3wS<?!m3Xu9#b3S=pYK=0$FodA_#VylCJpDksI95iDIXQ_(!pNdYTmPLX9
zMx_<Cx{p+>=QfR}4~Hd2N2)BvdA%?k=`df56_X|@*ND3xvUYx?HSwu0`j+YlyAD~9
zq0r1t^mjABFklJXpjm6Z=2ipK9Z=5*utKr@%_PS|Y8V<<H1et~wkeVBY`A~`{$@Tg
zTN3qj{SR77R;&9Y%2dM@JmxBaKSqTxk=6w?!=W;fN3ec;<nXtI5&O4c^lE2=6kk$Q
z;$3VNbO3CIlCJ?Z$jn>qFLr${gI18elI%_gf2M}Uv#Qs;5|)04GB!r<UeniW9x*7w
ztQURH+?sZ(_nFXTBlOw8>IKj}zr;`8aCQLUHQG_n`XnHoeQo4#MVk>KQc%1W6wEHK
zydKoHZB5X<dZKwZ$AWD6o{Gz;8r$#0s5w@!t62xD%{_*2EZ4!wIrS=27O>LTddemF
z{Os`|%WSBJ37a&d!Sed}>5!Q>E>iX8IJpBX3gHX`LtE*C;p4C{hF3Vc&iPGK)2#zI
z0Gk{U(bD1#yr0ca|ETDkDd5+zJuN#NzW<+=$5R<QaOr{qWvIdxJ*RMz6g*!3H<^O~
z05d?$zj3^jh0oa&fMcv4E;T~Iu^TS#Tl|A6-_eGKj1d(%2PB}9LJWgeA|gA?BSSr<
zCb9Gb&D=VyVi>0A4#urRi}q~p10GVINMm|P@4OvupuABrsU)9jcFIbIlK|^P(2k`j
zNP@p`$xR*6SoOEPvHBe6caDd@LuA&4VY6Pzp-4rA!%)+Cp9<?54e?n>gs5GGMJXDv
zq`$pB$9}D%!21OTxzBHdDn^W3FW3OSEUL<d+{g-TytRtC&oN}a0eix56RzNx1X^)h
z>o)uYu*&ib9TXsp^Tfo2`r?<tI<2&im+l(}(j-L1l_Vlre-P5w2(}!G_sI;a8ii<*
zU}(P4tDietha*o;$1P}nn5aUMue;aEMoFJ?K_<B2th<8<YM0T^0o6Ul0@P>{M~Rx^
zXooVbT-Big-P5hDg7p@9ew#qN*5Y`HHIS;McAD>dBEK0i)V;BNW679BWQV7F{BwU5
zaC~n-p9)nnaYE#rs-$l}VC4cH@}#%e=l{s5f|daBCrUs%sX2S#+envDH`MscN!$&(
zdhc^t(b`s+ee55y5J1nw^@oB<R_3c#hvcImhD^7OkFX{qzeL6VqDPS)T({BPgrsyh
zyyLff$xM&3$$_G@s<T0Vs=Z;_de_JooH2;zy!Y3?u5zU<hgNzp75*n$O6;^j&|&?y
zr@TPh!zBe<tMHm98gs>p=NKxS`M5jRIzdyRS<yd1%oZaR03UMxG;|C(%zn;)Q}Y62
zd8FtD!jUHwH%A#I_*O??7k;4ea~9m}H;O?~Y;jD#MkN2)=mkzVn#midF0?7en~+}q
zug@pBT-U6&7BT*G>t{pk8kd;rh&TyOqYqBl#1T=+iLNehaxLQygQoifSX6YyMK^c7
z#MulHV^ki9l=GVdM$Le%?gfE7!_W9o>0hhzPhvS)%JF$pS0bIBHgV1pT@>x3{Fhch
z?tmmvW+rk4rh|vFZFG~%&TcSbrpZ9-(zeNku^<gf%GjP+@Y0nTayDJi=k=&tqIY$b
z1OppFPt~o`YNyLY^sF6LW!(LAu)Y8EB9GP#pn@QoYOI_@8Z<~+Eajk~Kq_Hq{JRC0
z8}LE_nv;ZbN&l7jzBAwsiV(4Wij3pb#l~X}A&4-le-^0sq^%=ai@V3*)F893IL#d$
z_40shJXvueoA70-QEv4hE*!PO+$@0=F(js(iwydqFZG@9VCAES5+_)Z$^T{ZJR`>D
zYXvLY06_DPVT&HJ6UilY;HWxte%Lw*Ik)qeIF2Bp>)eb_1}<3AG)4mb6$_q0MTq0S
zl94Vixkb)##YE(<=%8l@3<@gbD6UmmR1$wE-hEF!i<_1!;vwZet%&BtF&*#DQ_%~*
zZ{wg=ZeZP2LhWbAuhK8EEM?pEJ8il!#j1Y3R}aS#2|Y>pY6Uxq6>0W?Q>PfB!?FXZ
z$%R7qX>wM1rHP66(;?GL7G%We<B+9=8n`))tuGjk_r!PYpe85>7NQl`Ci!7;1P*TE
z-9B=QzwcnWer?%-GJBe7gB65H4T+vu*Rd{tR8uD4n=0s_BPT@;i39L|CI?$UHSTSj
z4tYK?Cg7rU4v+}mSpVbl5XffOSMJ(@{R**stG@|L6#;C;h@V%+o&xgE0bs8Js^$p_
z$|)ZOfw{n$OBP2FOe|Ke^XL*bUCMB+&vbe4w40o6ujbo@Y2OUObD9qwz@ffmlEedK
zW}MnXAvBRefA4a{QR@dpbuOPN^6jvELR_-a9uwE<@I|EP1i#NNHs9=FdvoN0VRph(
zbC8=a)D}#^Yx0RJuEk)3z~D0Bx*}1n1>1wU>jre0Ad&mRq`yxQ6winA39)K&vF=B3
z1a?_I02A*uEZB_8XBKWDrIyTg|IWnW-viM8v|3U=@rqwy!!nOz(+2a|;73*oCO6_P
zU=-~FhElkTpSfVR<8F+YKZNkQcHCclB8^O+LGvLshH>nGAgr){dNoB8MT*-;{X~&G
z<gm(=I0Td#2bxRKt*yC;>#@7oO9uFJihgplJ=U^%1m;Hgmq46)H$U0x``18i>b-A$
zzvB*Pn`p~3kX`bGrms9<3?m`6BNV7QH6w8!A_gn%$>Occ2}$r^E!ad+YaTSmUM~$`
z&>GtGs=PfP#%$nLcz|_FmWUBskMO`|97Jjk<UpPTsU*9)rHVrJ3dPN_WQFC-d@cvi
z!q(V}RO&Op4YhA}lf$UB=z9tzU9f?s;~NADp@;0vkP-#nA8-#tli6E?T_!xB{2bU+
zCq_TEuYuI$z>&`ID^=@4fP5?8wGZ-BMj#j96G1_Ok6p?g7FX`z7rqg1Erkjkp6&NG
zK$#De%dgP00UE%yMgZ;eo$3t_eMpMIpg0zjXa$bR)W!|2LqRmJC^_clUf~hu1hbFm
zLF#(hL+mI7&Fy*;J(XrYRc_8xCc_!4!IOZ>@jpyP7!+jgXhin#G*yqwe2ki*^!ihp
zOeK)16_?gAaN}*dT@t~9Z~Hb2pUmSp6#Uz|hS76+B-gx?^~jNdbtp?wChNVtah`gk
ziE&Vyuvy__zH}1pEsW!J?14E4uSO8;f0smD)t*OL{qz6}&a^~i#Jy797Ye<24#>cr
zm7+GV3~x1~G@!BWZyPLD4I^c;)H<;+?{K*c$QH$TS8L?xWVX-t6GF;|ed^LY-VfHU
z4oVnobFRw1i(~N%&Sz|@kk(*YBGvt$l-6Q>bi7qJDzs@qf|MDDPnXvN?n4@r<69mx
z&2`Xzud1x4iXXA6W(hN}^8tlW?G*@`GxzL6@Teg9lE{0gWax6lM6T3jZw+6!c%e9m
zj2;P$*hsZ)na>3w<<M296EwqRHwomi&O4I_Uve}F&7>;YrbYqq=W>KIp@LS;^Cu2n
zKFu1*nO-Q{s3v!JU`dBJ<ni8a<40!+!5nO;YMcEfHAp7&MB{T$n-hBjsWyZR|3qC2
z)qv!AbPp#*)zL^{LL4(XHNiD@0M<qFxmiv5r*Y(EpS^qsOD2l<Uy3vPwDEc*pG;_e
zH<0>VRStYvl#dk`?o7ErL5YxOR8eK1YL+5kQYMi?Ri@<PyLZICp#Q~;%_?2Jzguw|
zx$$r&NVZVus8Bn130Cg{kr6=U>`Nf3v3BF~?+}o3Pzx4v(n5OCr^$lv4=@`dRKB~o
z4o5)oU?I<wZyw!cGe3?I-zxQ0URagdC&<V6eRy>CKDa(qZkxIWt&xCL?I7;l3<?gQ
zb(pW0DKwqBa%&)Ac!2@1$hC(h&R&W!GY+T!4*aq>P~wB$%fKqZX}porhlEstPFbyS
znwNQr`CRQ4le<ZsmAos*IHO425#8iK&w9a5S~9oSy3o2UvAv4EI)9F48iyXA4(EoZ
zoIQ=eol4pkLRd1hvbg4u?mLlJO{!rm^np0-OE(zQy+VU2M~v)Jp7MTcp&_~idW^|V
z{Ezt`=(~r4V6<3RFQNB$DFUHAAQd0l=BOUN>qd)~7cJ0rzz@<s^Tt1h2(rB}ozt<?
z*=uSXh^9@?^j=Vmts?pq^!uWe+?`Veo7I>e9j8}K^j_b{N)enFr%8Qnass-DMZ8T5
zy<;{v)#{W@x|<+w7wK9_R-yVP{l{r6G%AlUh@>PPm09RypssHEdsndVqsoSJXQ&jW
z@V#8HrV4?Qb(TlnM^3azn|AHT<s0niVRh6dYL1{fGkYc4SY&XF_uaEAI_zR0M!6vw
zh71A5&Q2aVO@;bjc!TBg2Be;t94g^Pgj81IYA2pZcl=QUD}f!t4&EI;d1TAkosV&^
zvn`6wLypzE61C5Yz6Eh=h;NLX(2<c>eIPgQTomrDyX!D^dO(1t;u_)pw<as~OS3Hv
zMCboR2=@K?{E%2jm>)s|Hu>+0H~b0I5BJ6Lz93z{*XAPn6u{gSyziNu_5Yc(v|VsU
z&{%SM$j4HB?*=KoeGAksPVg4w05yFDLZB^^vL9&M8DZCU!XT+_^#rXM(Fg$Snvgcl
z@L7L$Jw5|9bOI1IRD@hr5gpp1hmy;;jsdfeq}6nWt|#|?cfbwIqQKY}mP{Ug9$W>x
zHfiA}XVm5D+Ond*K|6TN019oOKkJ@l(CaUWsS;h%J6&{&roJHNhyt|Ehud2RTvZ|b
z#T^a+pO-?%e0Uq5*)oGY8WG&4qX^4XIoy+YCjw}dTDNdQVT0q|i60&9EI+|ov{MZ1
z0~2jP)#L(I3~wcnxd)}CJ)cuLy_hQjEq;1_9v0a{XZRW}G&bb)`9>M}iqx3Er<$0T
zfK8H@bP`{z)G*nZgbejZ3i2l6H0BF8IejoguGC!pi*>~4t<{~257HW20Cj6>s{w@_
zesFEuRXXvR{2nkWX4DSwa3sP7ZM=&N)duyL*^rCh4Kgf)TX0DDZ&&T`cpZ$o3CspO
zw|MJ$Uoc7t<vb@n>U4r9je26W#UsCq<l*!rFw*P;V+em?hSR78@p(bASJ0f7Ifcs8
zegB0YYQ#609ihAdV7HZb4~cj}6!3upy}rn5)%A)Xor3h(qPI&|nIJZ;G``REQgtUg
zgijg&QduQdcW<zoIMEiWUBM%2nAk|!?{nAw>Ljj&9O0b--m+Mvmv}9ue@B>6%G(k|
zn7fS-CEV!jvP1Y6ugcjy8+-dDp4{a)K|PBv{r9!V(V_rE%yL>WxI*s!iDXwY7UjSf
zefTL7oZsCuz4z%SJ2t&flDA;tpi1s(npb`Z>Nq;V&6;kHrr1C4W182~cU2R3qV5|E
z!5Q?pFuW(g86}9ivuq#L!V^XB;=88=k&z?~7UAinLGEnEs4bteWLg!ffgg6R_vkL<
zF!{uq?*pcT0#c-U#^+-Sj}o~i7rKEHpR@N15&3)xH8s#4g=*60DrPO3u1x*ITUZR7
zp1eP6P_ztp$QPp*0_#X_oks|BL*(mgTm*}fmPE7->ABEYm#tv!z>mYs8lapZx2~yx
zABbPY%5S?>qc5jbHQ?Fscc8T{7+9(9ldKBnY|jIhP=oyLvn}f8xjmZ9Fv&;I6qjmn
z{xpykmW?sRnDE#^S6qy??PVb)+O_e*@U7~UQ#j;ltZXFvl#Kkp$p9Z4?GQR=*YBFc
zMrP4Vy`;b#u^4l`yI>5?;x^~7#3%%#zY}`<3?v~kC@Cf3P$m4t!s%eBq=Q^06tYZw
zYscC?S#%xsgmkl9kPw#k<G*n)y&Kfo*Zp<j%Z=hjflJGKdJLh~F8O6$^U7Ti*B4cu
z>%qGi^Oyz&{TF7rd`~E5>uyarJ#NGdmq~5qG3kD%4oNKpHz%I{{e{4Z3p+n{UzE&1
z=XywKF*hf7&KrPl>4Lomrlqz;2L2nO#99??IB>ozk2u<miSa<m5mZk*KM_q(6|Uwp
zY5%u7{t@c%<yTs3rWhhGLY)T#rFY(WuXv&R3DFud=mP}iS}*!3H8OF25cfj9$6fkC
zXK=7wf+D|I_o3sb+@DbA2lfMx01Hk2Td8&E>9Z0xYFBJgZ!vGAo1+~{GNky%u@$#f
za#GMH$lsz@rm1`+L5JXa{zW9FsAKIXvZ;C{VwjWYLCfUs(^JYZouYrlame0`J?pbF
z0fF#N>%P{~oTh7Ylo{v#1uGJC+0Ps{TrQMHS%1_gorjzkJuzuE>6JbCs23ydcTU1j
zi$cvI2$}B;o`d0ZYN&6uOxD)%S&x8f(Zq%<$_YF+Xd&b|<w85ad~%yP#o~Is8(Y3A
z9Ek)6@|f^_npBG#!H9B`w+za75W5zxcS0NZCXooGmhkpbo=$cQp^6LMj!5o+w0<3P
z56L7^B^YgyN~uW7fm7SVnH;{dDdx~=muE7TE&=3ka^0d~TvkM0LD(BYtxL=dnfMc<
z1w_x!mJ=7tC(xp)S-XwjZKCdk>vnP=jr*odTq5eUXWSGou47(Q7T`(Jzwfs1wq(*w
z0h`z)JN6HE4rBlx_#3e}UZUh6tA_CEy);tp2V`};`kV$Xs~kL-!9K9@6n-kTxBytQ
z4QkjNS;$opBE~$|xq6z{S4yf?0ER%xhY)1|xAIaH`Fz9y=$6O<w#R-<sF!4G#=cGc
zYBDM`a@A0L<zaJ}N10zLz4o+u=xKo}9a4AVBKaopyNgn`Z1g}`u!x|cmbgrEXZduW
zqyb2)+{DtAm*QMiTeWGcxNJMyL0wsc;;6h%Ow(eo?l>GZ!*=EQ6u267C$x2~Atvl)
z+Mq!*%CzW8ZhF4MJduVh9Fb{sZ>sIb4b{Z3kiK!yOcJdv3CA<azV#n`RAYHZ`mo$a
z_C;8t#%%d~$PGOn1k_XgrE=1Rl)-L`&u=D!b~fp|@N|)zQKWKbo7tI)L1hBOgL0~S
z+B1P^ig>kzcmKv`NVTp$*oTmfH&{?|a6Jk@L6X^)w|VgPQf!XFkEBG5B|g3g%eVuP
zG)rry4iN34J1KnwI!~)AKW@c|&GhGMi}6?>4jS_X!5SY4%=rNi0I6z+<TfY)JJuLo
z3>j}_NkP9z!Y$_SZN9}2%&o#XSHir-(m(-I9w-&K{|AVa4?<VJw;%<@_ylZX4;1vd
zGCWxqa5(aSzaz)vv=1>7%PJ;$JddjGr9)Du-}rT;ELUU@1|`z+BL{ipE|{{+q={G&
z8(HAAst4CYd5e3YYTiJVQ-Z45AobPbAec5lGZ!bCowWtX2?Ht^cX(&Qz8zSdb0ybM
zKfms$=cj&A!8+fDVPf4cH1=1Xl_E@!yeVIb&xe2cRz}k`J*}^C8AJj1Yn*1+H80YK
zBw{^1LmS`CBENdrpoOat`a53A@~rnj*WVD(8BnDo|60LkBlAmip<4m#&J-i;oK?tW
zqx)c8@1wzSmi4GlGA5q+3FKI9MoH(==kn{aB~+Q-cZ6FvzZ49><?~R|y!$%(_vlXC
z)0Vf{{lQpj*h-cwcH(j3sk2`2neQ5M$%(wUL4?0``th<&>H(`Bnz218*|F(T-o4e>
zU3}u$DWl%TA0?of9^PNoX75uhir<C;N%?nBhq@xedv)+my?$q)++T2d5D_s#AD=dR
zz=HBgfj$?|e<ud_j__3Q{}h6|AP$7?krL7eQoBnVQ{;Uk^rD814a@z;8~&uUY&M6Y
zx1YLncXw&0|Mu+<P&(iwVv0!oh|}l1t1ND7WSJHJLl7=S2Sx#4j(?1j`wAlGu3P~$
z2b>7j5()sQAsBj-LQ2waYIi)O<3(Ggf4!<$XkNM!Qbm8g%+@g>n$UKP$J6k6*+iq!
zYKOWnByAxWO@IZYMWR&4B+n25fwdnMWX$Ga;-B~fSowv|h1XmUu(?Nc=6d{2vO8+o
z1kOLL7Zu{AeSj``*Yy6Ef+>M0O1Y_pnTRsQ5o~mV(9;tJ{N&PkIgA-VZs5@d`>0Q?
z^VhQ+@oF>ClS3917dwk)8GqL0YYAVGF+U-HKjum0If1;v&N#o{wzMvj?<g#fc3<S3
zJ*1Ge*d!TD=L#JyWGlm09AvbtgI~yqjZoeBV-F_|ZlE8H>Y5JlYh7n9xnq>q->e*@
zMi3yF-aZ=CDZ!#9bJ}u<I<>M!^Nnu?Sc?=3G@?%XfC=@@+7NUr@b`vCm^zomWMaTf
zC-xx0rShhtGR}x%L@`n3r)!s@ysbvrJW4Crt84&yOukueNqS0hGuOK6+vvmXa4jpP
zB>hW>rA>ZIVEF*F(<{N}2G5opMGIN|dBn>;jFd4fAE24)B>&jyh9^M?$5#Vw2W2qo
zzi%-W_7t*q`?NPj15yWoni<(c@~(V4CiF;-E(inp<BtDm2BXZn<$(88a$3R^Z`V0?
z*?BVXXVLZ?PU7r$x^Nwu2>3_)&>?FI)4egBRU8=)`m?sm`CS+)938^yw@nt6j*q@(
zBszz9c_9>KNO~?f4Z*C=pSP;B%#@U(FUXPaImSaj;ykyTs4c)Ra-ci%xIuYw&FGx1
z-zWBw?`?Vj8Cq_mWEX%EnYz804@~~;!xrDEL|yX4dP|;e?z4Mn?ffj29!xO=TJ<c>
zVQ^0VM*h)PXI)Vyu3#Y593+Y`vjuI|LF=GzO{!?u7xOHWTyICnO113r!PU;5+PB_v
zsWA~hy)L@stcL&!eeGEyAMZg*C8-aA%oi0TXw*}<6r3j-o+iF8tj=5G#eQNEZ?asn
z{nzc67atfYCi&U)yl7{0#%9IpP@kua)JP%iBk%LI&0Qfyc4;gqYknFuFQ&P5*-`7$
z1DXGml~qwEG=tq4#8Ut)pRWgDhr!1UIo+kXeAergE^d?#7+Ih~nX}B7iSa?u%J&L<
zNQq@ex_&oD7c@lkVyb|flHGy&b%>3;`&7dhSFjd2n-ipja8QbB$_prtPNX^Z)$=Ze
zXdG4d4sbV!pqZs1v)<BTqh#l!OOews5Uaoo2eeRiU^Qb{0X#iONC%{38l^m?^VH!B
zGIJ>C!kAO#J6-9cq!G>#p^Uu_4K}?GIWhR4{HWbo<?}l)j7nIvuRTVsqZT`_Hlm-5
z-O5=Q0aYJU$~vDiuvQyNPsT{)5oo+1ax_<UJzO&MQ7_0;F(fH?Vb&sbt{NsY<MDb}
zLCBIa$~(}8wZ8pU%f;_MeZr$I7$q-e#7mRG2%r_Z&or`Bpj9P^$)H(qeZyGzPEFi=
zY=qA8QUfk%V&>&d%^?_2ELpb#<_pCME->a}0SfOtO~ZQl7`5SSGn9`X76bzm`?#Lx
zpj2aAS^OB`7O%D|<$)ctajWv%FX3YJ2hFb@+WywKx}O3f8nBu+xFy^Qa%HQo7XO01
zPDUveUA10e6j8q$55E+DOEOF=Y-*`yIf0w9Hoc;BaQLDw@7qm<qT}c-{rM}{XS{%(
z@+TBcFEI{7e3OkHH7vlsdJ%bTnT|_qge^68gzdtL<KkRMtJ+*hBmFI(M7doO)-)k4
zcL;=n=Y*6>JGn2W<T1WO2{oY%e)=UwTz)8oK3ZpDxk8$~lgiYvhl&0zxcEhrhU~i7
z{f7xA{C_Vj+ltTz`jl!wD3SB34<YF?5z`EmzIZ5v#F{Mu<k05~a_MXjc7%F~=~VJ#
zcqWII*S7<MCN6$(45*;-^8^G}6>#@p=sxgOUB`!4OV=F~DQJhzN`2ECoPfHLfKu!q
zi-PtS)0Uop5)&$GGtT?jF<@zb0~gI@SNRR66x93^s<#DGBp?%Gbf0d}`JIwF9D8A!
za7P&#xu=NYf_lC#Ue^ReEP+c6{qwvM6ws<XEL2{3%R_0q%({tT+{Q|9LB;J;=O-gH
zAb>k*Qo65Zh<t}1p(`%MYn^d{QE}(!gI<?>q9N6f0*-nmsfcchyC!$7UorpI0Ev0~
zv@<-wz4Pj~tD7Dh+!CJJDK2Ms!{ajPD!H|)<DmRS72@2~7nAY=V`zMW<f)@+((^@|
z+iag$?%kfmlyiLql2DUU?lf#Eh^-S{B;Ic?Vl+2!1okNOr3T^VZ2D)9CC_Olc@MX=
zK!2~{bI*fsjE&duH)pFsqkSCkK11i4L#>7YT%k>##_WPS2yDY{%D9*lf}!E`K`n;c
zGj6Z9!F4@W0MgSpK%0y^Ty(8P3-fP?2xOb_Z<JTRcT4d{p(G;lX<+Sl6C<;P^F*Ec
zI_xjmv(dB^=1&UEY{z6=^<cf|xvOjs?dgH_cg!^lxXmZsYqVUI0Se`UCbwNBn;3QE
z**9nykKb)sN3Cx)G{rQaD~vkedj7a7=|0pf;&F4Hl2utUL3Dkf^7SZ{H7cml;kCpb
zhLEvJ+1sJ(*%{h})<yr{tp|rFbMk4y`*`iL1g0dl5mXlTE}D_1Ei%)geW?&+X1gvh
z4U!(W)=Z6!W#Px1f92&1Ak!)e5%rHI*JP&8qQm`Wu6pVAJ=Ce>OJTuu0+Pq*5)KWs
z^vFPLbWAP(Q|pt(WePgXzsvyZM?tx6C_r#T-%>xW%&NxpT%OG_G$M*=(j?QcpWXLH
zUaNXJ|KgSMc;PaXe*`*d5`V)~2o&Od1Jw<7MzN`^zpv&Icn}*3yo<RrS*PmtR19<4
z!jx&?1zP=tms!G83U-s8&oTv|g!CtJkO&M;U*rQ?P3s%B(zJNh&V}kj-^b$Y<aVSs
zwcpnfK8Nea>*N0)e+>dEE*Cw8ZP?A7z%N%pEpIn}zpC3{89xm39PzONpfJ5tStam*
zMP9318TxEku`O%3&mu+lLIV<b!pf`<Og5?=xeXqb<Y6gIBbJ0kQ1zUow0xxde!Xky
z;^LEwx7r0R#yqlh0QYlKFjY|9nrR9h=zH|j;ZWlAUR|7Vv2HD$0i#Z1L!P-BJx<5{
z6p$DhEbOUS2u%$IUjsHdH0J4O5dkEWV)Ad-inHL~X9=NrmvhW8le-xwC+-WEbTw4h
z4vz70?OB=`tmMigdpAE7r&(2uQdLBHhH)<lx_@llNnQ}uzYd5RA}ww2Z!7(=y#Sl8
zC1a<vdOYb%9wqYNisOcG_%i$2#2}5Y_<rH3I>fh8w&9n@q^4)A=a8XVvAC?brtS0<
zVKVxEo}i`_FPbgIHfc<%4N>5*i%K5skWL0XZUj#XSfD}0u)C%38d?>V|J9bc#?9oX
zYU^hQTLZG8Mw~lJutBmE#=AqxPB5x`T5D2%CA#6lRSy?;{n%!7Dia$efI6`wIuDw9
zo}V9p`E7Cl8$%acFdnf{zl?w@v%coR0Vu&i!0Jzc0E+l$1Z4vRy3j5qT|T5L_DgyZ
zOhiMXX4+}&JDa=$-X+^0SIYz_<j!%Gl&Kq{JxwdhNV4*k=BGmoOy*mMDV7*>LnKB7
z<#VgH4uR;DfJcncdQpsFy2YZ^e+4A|=gf29Rz!2)S1krE4ZhsH{+Rf&^wn6M>_k$k
zRvs^WS2|KlnIp(oiarIJol16mG`e;WSyncCt#W&A@9UX6mfiW_R|@MMMXzAejH`AS
zYzMv2p>@7))_>T{IE6}HI#zNpN~g{r{gH|!hd-k9@ytA(@0CL8BDhOAeSH-km{=`b
znZW_<qq_lsac&p1)jPzt8pi&eG>i`B-4HppT-8Oezg2~vv%N6^`v;hTMb~=Pm5WQr
zvj~bG6j+L)CP_K03XAPbai?e5Ad@t-x@d!EJI!fF=hOMpT{?($EGovkWaKySHEoG^
z#q5nd2xts_q=tGVAYAO#>?OYpCXEgc_l!RjdKC=hFj+<~Dpt?4+;I+?*=?c`Ni)eO
z)a>7f5=c>j2!e<-o)CS=ZzsBMV4xByd6t-tt^_73^2`h~IqyQ>cF-K_EvO6_0rdKX
z?6G*p&OJHzQ?}y<_lQr2WWSA-%fgVY6M8qxTV6&r-n8ZA6N>?r(*9Liy2p9sL;<-X
z(wF4#iRd$%7EK6EdM2xZIkq~KHR)USSU0DN9>M`RJmB}O5HZ1gM>!BLUD#q!-^(}0
zoG5@1Vl2C?EvA;&!=3x=CCu4Q<*E$r+B_5B=y{QPbAviI1){^}0N78$F~|J=+i=*l
z0sS^-+F{ZX0gADJxh3djI1Jm9c+V6tIUp%_!$zwicxhiU$eorrLt#Zc496p(^ws2U
zNJHO`mvxQEA{Uyir9kI(pr2y`MXtfceGy`10YOy-N*n$4EvoRznfj-OJU7G@z?4E^
z;zv{`M6XF{6_)NdTp=})j}SXGvE<qc(*r~DK{=e8d7N%WV8QHLh2B?59*6$MGOsa*
zQFs3h8=%m}F?86MY-#Xa<`=<m)$mRQ$*b7OXrZ45;nV}}C*X`&m@|Gq2VBB-(jIK{
zwP(MSi9bC3as4wo*mQOB&7`OP#9AzGcH}ruy?`huGIVniXbQA^nipwc0mlWowm@f#
z{CV1lAGK~CwjJb!?ZEDxu{Jt8(3;k4R|ma%;zAKpTtw3l7tP4hqplt7KDCR&Sz#z4
z>F@?n8$6>EGZC>kRZp)fJr%UQK((JSFt{}>ist4~mb>~m^MCmQJ0t<dnlEW_$?1i1
z^o2ES>hH6<oi;<FYcnbwzVRJ_Yl~X$T}NygE;$p61@_%*EA@Sz1hfEDAnnGlK#p!k
z9)L?Xd=|PY`470Oze`%`8OcGJ!LC__P8)bxt%5yxXlHn7+4?sHD>=`IYus6HStmp_
z=kkFSsz&zBwU0d!5FI&+FN>u7XiYCZ&v64r?t2K`jrO5WxD3mF2!rKJ%`G2x$7*-c
zXB!a_g|+|wbl1N`=2iOT_c^YrJ>2NJvB+khePi-W{c1nKra8>fZL4d{T`wdaXq4*8
zCRo@A;5LXy7@(aI?zQ{C>DU_uTVVs<$1QC+r7I_VrMuy(fB)#ye>o#5XoX>T8Dz3-
z<9}>sl5H7*Cqe_tsQg_EETkOay5TG>S{g?*N$=ar>gFcM5?VK)|IDZLkwQZ1rw|);
z7ogR|oCBQ$B4d*X2@-Q)wQe~^4fKHBA%QVf!*Ldj|IzD`wAfg#w8s~^9OS=!d1Ik$
z3?>=UIVv#CI_VjZd`W{`I%k8Qlp+C;RFDtSnY1X^k2(!?1H^}RR)u=COa^P>gRn#(
zgFZE-<NRXT8~>+EnU$zmZgIbi#q2Hjtb)@3c!S}@Rirj^t$J6dpcMC8EdeZ{6C4Zz
zwa+hBBz{pBu#);2^!89ehUs`F4`#lG+iXAHd~O|&WBi$gJxo3VO1vVW5sIeh6=8^-
z(h6i9xR_*adIxSG7ozecN)O27U5)vF7SS-)^Bd~Mrp7VYxiM*(+QgnR-rh2m??}SY
z)Oh}Xt|qL{DOR5H#Wy7vv?X3kc;f+!cssPb-j39Han?)ckVJL^6Y;5ETL9P?5OS_j
zkgdJzVMfj;aJu`8dfc3Y<j-Urj3cOrnmT<gTFA1V7%){aNT_JD<X?<m3KMa&5-bV<
zxNsS3Lac#8Q?Y5q^DjgO7A$iN-FRnO(8EUEb-1?@{$0>4*8ksOGVud!i9Crox{A|A
zrOvMmSXV`UcC{Rs0fM<~ci-g2DCg;2O!92xI1F>U;KGmH$wvhcb0vz}0`q8~ePOP+
zk1Fod`zcb&{Z3;W#h;9`=#ET#6;9AxS7}HpnT_qHL>j<{h;1`QK^-+8Y|#S@KDBcH
zMT_rX3ZIEap+f8to5>cPpVT|VQQprmArfyCJfz;+i@6HSzQ8IRX0*>N23$!Z4@c8R
z3p=Ci;oRtc_smppgD&K@EE#Mxa<vT6Z7CfiMhq$}Qth)V!}7ZY+UPjA4E7il8r+_q
z;g*z3G64A0Xd#N62033O|FCKqddt&baPvlYn#@YWzh@_{Mj491vGfPP>;WnN^^`xl
z#^N7OvX3(5wlRm>;|t=Wr@J{6FsHB@W~Ju06)O-#zet(Q)Vs#YV~;a_{jEnP6S~nl
z9wLaPLvjX=><lThB`WUL=_WD`Fa^%@JFY&z<};wiIhP>ZL`c1Bq&V$icC<=Y9EVay
zkS#cZkz4L&DQaSt<8#}%lbezrDeLi}^}E<;60EWw<k?nAacTTfke<eiuj*EjQfMoS
zbyM_PC2WMf-iAhJ#SLKG>b9m*?y_!vU5!uk|Mmj}{DhF@4y5x6b#=_(I=5Q&3vQ-9
zwWzTy+A!8{2zsx*zWyJWpi5QG9*;Xfo<~<eyQV%8hUVW0U8~8ajh2q(ny^FJbI)H}
zV{|uu=2nU<`@8n5WhX=}gs-!nWlWrZrim**LD^rWhY;Efd@0a9a+;*BrIVMQzi*BO
z+1V2dxwhDd))ao`ou3D<06l{}!xJMi-WBWkH%ZjIVBM0|C&h}~7u(d=ZqN1x(nkT{
z!L*M+C%8HF#TSeRvGufFIcx$_vOBdR-*j537z)$|`K#mN|MP!CHb2P^A5z=WJ9ARv
z9%tR8H#6$aFh+{*8aS%bVViI;hliAQr0&$Cjizw`i_aAMM+?C0x&PJ#=v<UtY$@v9
zZlz6weqTc1q&eAI@DR_T+6eWn8pPs0mvk0aD;MFfnRH9fX;V>&{b%wbn_|RQ;c@r-
z#S3ZMXMS1><9ApjkaZvW^N#z)8_eI#SWIm5?U3<hg9xau+pdpS?YQj<Z4DPLf8>bI
zl9NuI@<ZLxRZ)pIy@z%-&U+F9p0|c&ME2`r)lkEq77ma#j-u2cl;Zok^u9H4VzS#v
zvL)HO5Gl}q(Z>{da=Hw*-V?fFsNX_~bOcf`AhJxYj(h6#x1N;hx3^WN4aemw`YmOM
za9uCO=d=us&uCVA^UaF6l7ld@_f2kX4J13eF?R<EA{;g#aiAB8<c&R4jqJjugWS?B
zj}qE`#yX?AoVj>J7YMcH`GWBLv9(pE-+>eJ-2}{~xV<@hx5MHdhbfvNYP7?E3sGVK
z&bv3_NgX5Qk(tMq2>VeZCAbmI3&k+|uADqg`UnX9o83F(J6&L&x`OZ&2Cx!po)EL5
z<m4AG?KaC%wAmR?!_(_(qUX)_SAp(vbkVbXPwdI)Bf8;L<xzz4h=l7SL<P>`7}NJI
zlUBu7@HE>hbTlU3yo>NHf}^`c59TqB&t`^~_jWPQ3-e2CD2|_euQ&EyGY8nZT;KcC
zDzce#d3dl>^-qD?h%#_bRvk$9;}@Jn0usK&B{xM^&|~BL;l<gAdP|7iCWJ6FBiU-^
z3G{DC(SV!tLv6|}y3o~kx+f|FqG0c;pBCsyZ`nFDi}UmgjsNP=?RzvB9-;<%Aev(|
zE>pP1j5C3p;D$Y3r?>AlJWq@2^^pKiXMF*s^rTWtPMJPx1XEfDNEXP9NAjY~g@O3&
zO{#quPlaN$jmCw8B>B!_ZZqtn^i}_%!m%QBkZm7G62?a=Pq%uWN{D8@eUXEnh$FM4
z&S2!<+xppA*nx0nd=h2Dp$*)H+TyWDrMxz!%^d=6tUbeE<Gscnf{c4|C(;J7)imsh
z{U~%?!V5hCb96MEhzY)DILUFo9GrDa?f@ndPTKmd;^}V7CDR!X+?hsDzC6FLF7JEZ
zDOkMyW@qt@#+tMA)fgt2A_C$1#z^uxvT@TD)Q|p1wOD5^1=H!;NWQ0x%?i!R>!C!p
zn92*U=B6m@i{Uf1T%#!qUAPDQfPZtj09=YhevwzpRinRBgQeH_I9L-8e1tV|wl4<a
z9<Z6!DUo7?lC(y+pB!<fm|-z%oy_}Z%fT9yfB=`db^-{!X!)0~(*Dt`IMd>AjP(+V
z`MK)Tds8#FiISZ^E!;e*mSac27?d?`pEzg2H0|NX{T=i|yt41Lf<u2WC7;oQaG>PH
zGJ=k@4G(3Kc6sS*5U}~IzhAgEz<eZ~sgrESL~fy8qEN9B$Pf&H1fOa=uy<50m$vI8
zWz?|Fx@{sNABL>UoazA*v>P3Rb%iHUe!S`rGD3^{Rz%LvRBqY)NK^9|s)Xh~YQV{z
z5ZFd*MbOQ>EV)*V51M{h-=D>IX?83UpvNgZb?et*=by<Pxb2UWP8N`cW#Wya!Vav^
zrG(I`Kv7@^*ZJ*eT8eL%hclMiN9~~jc^IPyY~!YmSHrFc8XuRB@X}_}N=Kh{2`eoG
zql5Yt_B;MY`i1L9$B*kiQV(8VJYX|tdx(T9@qbeRnry&};N5n*4ha<1?_8{?+9Mj3
z!h;kBzaY^lI667*(c|yyM4nD0PB;@=g}dw^rq)Ij<)qXL8Ay!jI6{W)Kae@bF|-Hb
z`vgWwIHESsiXwE)rl&#nDWpeD-CB0(>N=rd;bFucwTwEswd4VuSFT%+3!KB*wCcV2
zFliaa9*N@eBqfj1fHA3ok!P4dX`82<VkI?vFvCUX|F7A|7_a9y>?$h8+3<$~t^7^{
zX#h~IS|g<!c>6bJ1^Bbt@lG$%gp{-N4G`mliO~Vq+>Gyw#g1Jpa%4Enaq^DxfNlrJ
zC&DT7vlT0&?s1Y=t1Uv3F4S|!3{D1Z!Qog0DJ6^B!*Yn|GxND90K$Jpo{G8)_)oGW
z`0dBGv5{eIuw_6}wTX6_MuSMe=oeDQ7p@`Ka7;dxK&(?v1T6(^Qm88(BduQO<J8QU
zAjbV!FJUtpc_mR+tI)_^P6ZXqo(Wd^!M*>p-(FII(L+&PbYAqVvD7uclj=;>VgWf&
z+{{jd4FO{_w4hT(yf`Y7ot58`MA*1f(;W?A0q5<1gK=zlY@qHd)y0na-j*V?@Y)^s
zBPd1IbeT}9x!lrNA03)5V9aGv6Nl?AJ|%MXUHz<$=e&+>iJ5A9?q@rRnZiNcmHJbM
zQ7B0z4$q<&WfwUyWs5AO1U>a~&y0vx{GSz;AHyTZV)QcUXWM7FxprO=c}xHK!naW7
zzp1Amsy`T9k<_^+2?G54i3D9DTpuLUlJ^{)yAAG}m<+K?g14BKOc%RlR7(YEQ0U(i
z$4OUHz!;w1f$R4RV%P*44}}$7`Sv}N#t?1+g*FKcbtpb;f5;GyH^6Wu<Ee|%#2V|r
z&*ZT_Vh3@)KN+g`XzhuqXv%?!L38<>_ZrR|G+xuY!U#r7;rAI!Med_#rEa}_0Sm!+
znuD+vxMl#NUbGXZkjiuP8Q8$*!@yc+95k9$z#MvmMA2frg+}5NoGxuH!1s}>u*u$C
zE~~EGA0Ur!s|&poN=1XO_^*xcE+LpUFrT&oiP-5lANd-7E)iy0m~L+p<kT+Q=&SVO
z)*t(fz9RUA9B}FN1h4Dbn$GU1N(;t4_#qsyW~89Zfg!4=dYX6=#(_rltx^Nm+fR?f
z8Fpf<)zA-Z7*8rk)gsa%T7Ydpu2=IG^SYD0{%vBv;!vY3YJI2=_Ze%<@@{B0gOfjL
z<cLj}(xF0K6tMa=F(g%cm1N|$<?kmUzu#7*8Ju<>_yMv+PHnPt)IuNBz!fuEe$NwE
zg>c$JaFeLIue#zF+Awk3D+Ua9m=;)r+~q<{Kn)W9VYtS<Ah3kq-=5CML-VchJ&}z0
zjJ0E<ddemcC3*S?C0!tZb3e_JHFnyO<p?^wrO*d052YhIB3}3%J|3pfhO`ff-=HI}
z(YM*Tj-Ql&cbn;d1G2a%BQ-WwXX3)=^oF!g027>=-20gL$Cw4T2+7-O1pmr!a5Sr1
zDgl6N7ycu`K4<+ApeKz&_Lj6KrG=^?H-1~s8W1_<SIU^K4U&NC0`*Y#DT$##d_LXd
zH=>WGiuFL-Mzp!}S7;)E=C~k2Ozr5tEJ?+Hzp7ue(>>Eg>RZXWws@gP-cIeggOFm8
z6J$OHFETQ^G=o&)dm%YVo(W*XdYCwysuWDkz{@^u{0b)E$eV6U^7Wn@Xx2`=!S2*A
z-<hdBiNJCy70dvPZY=8~G@Jz8@&!Pah}#RFPXBJ+r38RfB%SquML}cDW?#Z+0(l9l
z7BH_Y?$KJqJp)LDP+9gnrr^<ZNAQNylw7-YpzF!{Bn;hoY&Ye$cWj~G3#dYrj?`pu
zwhzEYF3eoDsh08PPQn7rKVTz}={uq4ql!iPb{Y9L-3qJHaCmk7IA@nu<UvI{?fmvs
zC2an{LnyYfuG-yM(>V4_m6&{C*QZ#mV-GOfq<(sOul2QeK@s)Ag8>}9lbv_Gi^(9%
z%N3oDh2;xk4<~CR{@sKrUgwl+IyAQJ>^m1y&w2t^<nPZE`G%cz>&l}I?vP9)VmhXY
zOWR%xR}7J$(}e`bMEKg%N-zpS5Ov%CFdQ=E<_VrT+k5*Lrvh`@TCjxS3Z5RJ{`?&q
z6s@YR!Rt5KbaT8rHoM*Do-K|^alHs3j@lL{uU_8kiicnZlr2hvaI8c7ha6@!*4^x;
zNrG+N8v?w{EnqWhUh_|`rF|EWl-i0|2JFLJe?6^;y@g4}F+%Aj0Oy9U+;qO3@8IBs
zR{F&<e6%5m!zEFR^0-MHsrU3Q8Q`#>vGF9_E1T6*ExFJnB@7x_urF~?DGmS7P2bQq
z1S-08<yi3f5xL0zj(0nen5`~;eM<)0N}~^@0MtcamX>%C>H+5G2wuGZHNIhgX_w|-
zeNi^8<omB-dS-3;-9e8FStHr2nf8O_*ccvkB`?x+dICt6GRIh#dAHw`Q`?o~F~#4R
zF?W6^M0!w!q<7M|uf)e#5REOQmG;&;vLL7iXBY=1wc55=Kf21y8>$PkJ;U&d4dMox
z{L<UDsUdvsqRCzJC*jh5q9h3oxesRGXI&7@F<7^wIGTy$xV%1x6+l-L;mkWpEM+T)
ztV32PN8hy%>5DBKaj;vd;sOI?$h0=>BW9+&CVuztfzbiHvojrxhm9O1uBb8e8_ee6
z-&bBz67ito@<wf=wzQ-1p!2x7`Q&~jq>Fq7r%K}}VY0?Q#|0S{S0{Nh^+Wop6{41R
zn%M%=+9ygLLMZ``wsDIwvAQ7g+oE~8Q~}7dqjlN;59!q2QPic>y~VX3p&cB6_R<^e
z@4mD+bsS(8OEPHUv2=5u^u&Lzs7@$_K8Gq2j&O4v7B03?p^r5Vvxja*f0h70Ycy{I
znRl>7kX;p>#j2dLC-YGJwf$X)&Gsme?6Y*fz_NVbaW2Atkj#di0?8))t<?Qf$8jbg
z<~=z#f{%EIMmS#ZRSW4_5nvc$ndP<pv3`aS$NM;l%(MkB3f9$Z6(M&I2b1etIjJ)~
zHA}?*R;8I+jEK^z-?}-dRmn%TUEy|Q?|BQ(ZxKlx!RJ>7(inXwjLYr>lA_~X$LSbC
zObcCS#WViTD`(TkpqVS#N?4QSq*TO7^<n@Z5c?e5zh3;OdgLI~TxPVA_c&5$JVoVh
zfL!1#c=0=W!+6#bx;>RkxxTfbvUfJBgG#}cKESHreN9V-NM@Vy+lP4DJWR9l%+9-k
z#7Pt@c9#7km6N2B;<U|OM-27vp7E#}%Ti9~z}&A1WQ9Kr^`MLgkOr9Nq6e_(2a{em
zW`01HgbC_jZ3SoAYnp5)f*_Z8r>ZB$#k)@v*yeEQ^_fE@a7I^+n)XRO0iwo^du{hh
zlW45pXteur>bX8iIn*?@VX+5h(O~YZr?SYX?}%}^9kt~o{Ln^DXs;ZKYhyx*<Rm~y
z>_HI$d?NBRw;)R9r>yRQm$XRl>cd4-sC2tZ2R>AGZ8hliCFnPDy!2@;NE&qe=M9NH
zz31D)@oDV`F6EyPX;Qtm;TdCNeVJg7*2t~xC8<k2tBiEhrF$CE&>hsst%`WvRBDTn
zju=xHJE8Tvx4~OgX-{l_3046C#YnN950r+41S3K|=g`bqen?bH#7+4r=8C&BPJ5Ln
z%B-0w$$a>!m(_7!csQ|A*H5ii-g47TCDDsWj0dEy+1-e;(-qQS^3=DA_OEB)(w%9=
zN!RKRY2uPy&GjoH5b9)js0X=xqy91lt@XzvesLMp2pfUIw5D8if9$US(b)r+GP(%@
z$rwU<`sq{P^0eLQ7+>YSwPjvhMHe)mlJk}Y9SWK3KHQSzW|Ut#%Ji~YQStGbFYNSc
z`i8Or639%-KV;P1DOYuH3s{^N__Y}`AGT0#J($PR_x9ecFu<YClEUafL#?Yn$D(gQ
zoakXzA1|*ucz){egnvdv*&cRcSxHA)y+V>3au|GdV&0dY+D+8bTGo(8C>$qYn15$p
z@(UvAP+8(!P)}JalX^pqa5%9iH1N%kcA>iP|0CBK_6m#mObJm{b3Q0stlJM9ER04)
zhFalDE$>J>N|~Mz(nNd_q1=kKQ3H>W92wG4)y?$1l{A1w#6<Qh1h*r*QMmJr!8cr<
znNt(0G4n$+$B?RH*_zs7<gmH!`HpfB0uTwuqD%i+hVvYK<|x?FP{}dR#V11yG~}7;
zq!+vrAn!iJNdfjd7&I$e9%?bIXsAfL_tQ~_$(e11OsbC!+5B061$WF&_!L3wo<0f@
zv1`{t{JSY56w_VHaXBcUTb#ps6TA~{MrLxQ5wzD0<>k48OT}+2Az*%_8p2V+rPI!k
z3iIe@Hv;TNE?9%YVDh#iLtY%et@|eu68ak2vFmo`;@UD_L0Hn?R3-c5bE>rsNw;wN
zz+;TIt3sLqdr`$Rt{|M_+gbtI48BQFc(=a<(wgw6EiGp*#DY`}H}|;LKxq_ywSpp_
zM_gc+1+Lzin(847L?~8sYyi9Nj&mo}D(C2+2@~QOZpr$4UK}AmAmslZnDyQuAUF%4
z4y;ez!ZwY*p{-yIm=!HLi^j*4N5`dfPF>!D1(gG|EmqGn83u62Kjp}%-)4!4P1kZ$
zl%gIDfWh8!66$LLI<9Oe?37394A}KApZKBm)D>rdK=7q*Q8;!e@+ZQt6Z34V<zrLi
zb_YWiIqTx6P^t`C=0-NjPOnwynjgSV2(?D_;u{4ol5Uk@G5*ndaxFAf5+G}veig3#
z6GRv8B9Xq*mL)cf!^Wy5VhfPKd^Ll@5y=*}(A3;!;aCG1PVYdo*nwSjmIg=%jfQ0R
zT0Ma?|Hd}hbc3NaB#KHs9k7B^VY)z0eDP8ddEz%Bo76Cho`Frl43~EX$0p9!ctUfs
zyhUgSCAKMXYSOy&H^6;1hztizswDlw-Vx4A80Aw@Bx<TrMv61(%$#N2z$hxS8TIyb
z5|E~wsgk;N6|@j8{W+NO*Ya7tc~%vbVWWxT6lbGv&`1DT-+>qc@NW%>e3fpN{QHwe
z-Tw#{KyjZe3x<T~ifjnT>`V>c`vI4y!PB|`a$F-ZSxYyl#c=qfX}j%|CO=Euu;^4D
zi@6VJiVv>~oSZBu>Xf_D%Bb6OMezjX24P6OaDp%B63UNC<6$Q!hRmL&MiY4`tG=!(
z4|<^_yLx69Ego4m;YpjGYkUT*4m;A4wj_aQBb8@<#TTnfx7+o{Q9?4cAYR8?s`m_}
z1<~%@i@~*RKt)uQbf#I|yuY}uO~Tz_5w<n+JDU!F-?+e9ijd(_s^F?j{Rv=ds7m|~
z8{V-un)=-G#mXI{&FDyuMr(_nZES3Bh7-{Sr%tLIX*r9wh<KD1J?i8+WKn*4(1>&L
z>6>V!#K(mjKM~v|3=*?3X+d?pJvllbSn8?RgVr<X+UB-7xoS$|{SvX1oWm;;0n%6T
zpe3NS`@V<o42cdCokyx0xfM-97frLB_uk%olqZBdEId2lz-@I<mJzJIV($@WdsacZ
zNV7a^71do|qMuTumbc`9EZzRmS9m8(n)qhLsRnw`#$$1jTOUJ@oCY0nJ?U06QwNz2
z?Y0AM#bnK}>ea8;C_PfDw5PTf3vGE{lBMVib?1+qE{<lJDzIdj^r>Q~ZFzfRRbWT;
zaZq`>qB;L^y?FCnSxr#KT<8<$!!h0Ot7tnos?*BI1|p||CZ^8Y?MYc?O1`k#QV$%G
zz(dTkQGbt2s|Ht-091VV<~Q|Oacy%8Icu&hG2v-69TDRa67ck=87(G~EoZr=p9o6q
zYI?{;JyB?ak=Ff!z=rNTK^83Q%KR&7vx;3b*3QwC9|j?bkam}`)8kqDgOdB#-f)gt
zq`|p$rXybw>b?cvaI+(5i7)#63ES8npmrAHR%M69ir7>(1Q(~0ggaO8%dfEUfvF6^
ze|~fXNoK6Fyk)EdEd_A^Ls2{VU3>-}p|tn!-!lWuT9yP#56tQ>nR-kPfo7NA<A$0w
z3Bxc_04OJf5mQ`}kHivfe-t;YA!XAL73JVe!!!6xg!?iJ<0pdZAn4}uRAoZPI2tj8
zSa#sOGt<BKnd|-etgFh+&4{Up$%$28S@y9h?EhXj8qk1QyqPb0<on!so}`)f!B>-~
zh_`#t^B=q0h*u1EiF;~9OF%3SIWh;+WMnDYt(&rNS^=k!uQuepls!&VD4;8v{7IEj
zA1l4)KzVa!OiKNdKEy0-PKkDYi$W!x-p-D8p;!K&9gooRn)!0yz+XtaOFelMecog@
zenWKs&D!6RnI;xCrT(bq@gVJv|0Y=cw3#-SE3ioRqSKK;8Z&c7Drru^THdWJ>TIRr
zzwXf`QpS&Q?0xq?mH+?$8P0L+&9V2+$lgv$B$>srw~&<;3D<>?vR^ooy3CYK$Ua6!
zG7>q-N{N!JvQj?R_iy<A`aZv%8|Pfl=i_-_k8{rTd^Sk?kJjawRp>7!UAgIrU-K-s
zV5ldTn$ZiHyEo6+^d1K6Y?}qmI8=@|wO=a&XoX29hQB+<EM6JPG0Jbh^D?yLI7wI8
zi9WZt`1r@1y@tK@n54P9u4fSUU(&^P%-YA-ja%AXS8sLh9giL9CCaTqvDMtUY*klc
znhpE}e>dskF5O0anEBT9%7LSd=OU6SoGFzdqA~pBSF%E>t=i1s<vf<+hvo{J2bu4B
zs8pD=4b!x!_pf#UQgt+yzCHUs-gnl(ghH%q*9qymn#`xBqyOYAcaD=dLf7l_AADre
zch^V+M08d+Ru>h%E1%&jesiX>s}%21RyyOe{m_!fr^f#bb=pl{{^jmXw%A9nMqMve
z-E|o_^PpbLSo&h6dQ;Bx2ALhp#8R87BJ&S9ujLyqi>%rx+e+=e5H^h3|Cz_7U#3G5
z$+NuSK=XAob$QB?P2cU&_NAB2+Gwz@?za&tzWv&d3oBO~p)C4e3X=sUNe{2MXYE%O
z2l;8@&xPx;WR}fW{r+K;@E#Kuv};$aCfyfMeqD;$+BMkfZFSb<uBWL)VKdzvh1H^P
zUiY=62~D`6{N&y+ZI&byz$U6Ax#Mec&<bkvEY^jaY7OtY-u!%MBX|FM-vgH8l0|Wr
zPZp-KYtHG}=>e}2jPELcz5TQ2s)K8LW?}22j>$x#-TL~Vc)92ad-Ud~IM#z}dGR-n
zpQluccS}v<8)e;5H}4sA1?-M6+BsS3n^1lfO2u9H?{1f8%t1440!{zmI7@Qy!<RJM
zT2-VQb#2!xfqj|m8GXghjm)nbw|uL-h#RtDfRY5myqCA>OUVz@(bA)B&O7hiP2_21
zEvNqb*T}iWPYk{BZzZ-+p)^bI`A>$wL=&GR-N_e?BXKHrCYw#4mcP+h+oy`Q#=qIS
zUBQsKYC8UDvP9(xZx3tHUQa)f2A%ok&GTbKZ~o`UoeozG&ag$5C$XK0g)TfB_UG}p
z_Z*d!uGa;3XS<)*E+$GA`g!c08uhHbi)0+UVg*Xv^X)2C@vAA#3}6WV;=9U_)O;b7
zmD`^ks&t%7kepqJnWLY`&3X4c*q|ZW%PjRop`M|=JEV_u$`-$*9_hjo(LFao_jZZG
zVZzS3&g%Guo<V8c^`n93Y^O@3p2Us)H`3P=6bHw)W$G)rAJ3felIqGjc4T@MY@|FG
zN-b5G?Y*2~B7ej=8+3kz)MJpnq$GozALiv$KG2pHyt7eO5_OKo_kG3Njq;@*p&n-x
zTkT>W+xw%;OZ?ph>eSd)x`uEr<Gn_&1KqMS!U~3@tjzwtabrt6QpuD*WD@*qs3$)<
zbu+m#<KhA7*|3=PNo`Wp_gEn5@-Wp8?cbSgI*K3pB}>0>g(vt{Mb!kvC@S%fQayV1
z)pR|M<CWN`nThlTw%cv<(tCiZU#Vc};tU(ZO`~n>FZAiF{y(FL7mcg2{Wn=Mi0Soc
z+56YuxQ@U1xFy0DYq0unOiPi+sAkg;j}&AySh#s+`H0M4OpLqqa;W&W@}HHT|GroD
zU`Ou?8`yW6yt$<K=Gs^4R@XqNV^>atr+%$w+Vx>z^gA=H!gC8~`GvHpWcgJC&J*VC
zWUJ5hHWr!sYWJpcs-K=S8n@J6^}5^Ed3*oi&FkdHGZgnmw4KrOfQv5evTQP8Z|zGC
zHn~shx$j@IrYhc!%c;KhlYdpRh;wlgyl?lY%;kJA-2k6Zh?zq6wQb?&4AYj>-@>9j
zFCNb@X*@*5rD-WU|Gmof!+(?3_FZ6w><0U9v)9Cia2Cl=ndbj8-bu9%o!9Nki;lTO
z-+Q6nf&O^l28}9a_&<$~r=y7)HFa{V3ZlKKcAtwy<mRM()N&CV7gBomoH6!SpGOy~
znr=(q^X0OCJ@@qUk+D>2)2p99nA4oBwmKFf8v`0;@d@7AO9bF<{riWyo-c`S+>9xr
z)}tP(W-|9PF-__Xj2=cO&!dJvJV`r~ca>1oY0uCb-<sIQMSC{X)Wkuswp>pmX3)0V
zn1QWhnCl=_Y4cP8WjN(T{#inEzkt+#hP7Z-G+NB5!jL|~{r-N`>xkzUtK|19{6<IL
z*}9R_#~j_(b%fo`^VT;R<}F#2-c_)Nz9)7T6ydj&c`BUu8pp`@%|G=zW|TTi^n>rl
z8xk+3TZNy!vG>NUsQ#Md5Lv{?<gP^UzG91Fa=Z6Ip2({CWy?UtHi4q-SJ{bHKwIyp
z9>G_)J@H$QQJVI9n1}UwBH|y{L^zBkJ`uSeG0mzktFEW+en?bfelMRt&^IuY#8;tu
z6{%*xPVdmMkkIYD&BzL#x8wC!nd@&mc7LR28~CsLNsXeBS5a3?Rn$9KZ)=O&BORxz
zwt?@#Kd6tvQ^F%k%~h9$SyGSHpT}YYX$u1LsU?*MnPsof4qJY@a&n1n@<Yh`E{Ct(
z1$oZhuY?Ztn^6gNbN8^d%;Q&dXza)5bzHSSrDr_6CH?1Rar=G^XY;AFQ$;u8qLI*R
zV{mk(q$aqYA)=<i_CUkvN3O-3#QBVLt)aWIUg1A#_V3?`_p-b{^}?QqgZ~1C6QI&G
z;oi7w6Mv@n_i0f}f1*Ppr^2Ez8)}YGu~+o!3$)mk{7Ms1@h@K*<HKrxmsi}G|GY-S
z+)K{abpJ6LC>5P^Fu=F2TL^?smW5xQYq(u~BloVH?S)Pf^?lMu_?FjI=S*k*@9i->
ztkzE7Xm9rSNMPIpj&&~XOz*YX^_B4<q^@^&d<*q16*|d_3R2XS`E_P_-j6!UCv&ta
z_l?KLP4zD4CrixdHNcaGJQ39%j~BsNylqxj>6ZGy-ycQ4BY4;>ZdYCRTJ>DclAkLl
zY6(gC2Nb6|c%J99|8ur^o=;FE=b*(X;~M6rq#q`<=?t^NwFe$6m3!ao@)};>JFP^T
z6@JQ33(2YwbR$)+`W|KeUUc^y&z(w^wuqR~Dcf!<^LBfk=~FoV<yEf|uVtCQ8B332
z6#>S$svQnH%jSD;*Mbf|%X_|@b!2TW%r5&N@C;<5Pi_lIDIIW|gYU`BPIjkHT(fQm
z4^#~$>C2eke`0tWyU0zqCdYNzIRH~0mNvRiTQ&Mq(dHup{~q04ci`lxS;hWbW`X6_
zzRFdhD^a-6=FyoM&`$J>6sMxcLb;7ZDRaHR3l%1d>9a$OT-k0eQYLE>nnO!@t?^Sq
z(+-=g+OHO4TZsyUiC~2^=Do1}4}`1Fh^8N)oHH9)FPR@WiKk*KD!<(NP|;fgic~F>
zn$j30GO@hK<cJMRE5y5wnJZfq#YWR6-A@XR^Ooon%Y3N#o&4Z^AzkCukLQY=>0LMn
zd)L_>gc?PXGr6Dhbkyjam_UXJ;sQ@Yx90|$2Dt6-D4xCRZJh15LhsTUZJZeAE2>5k
zk~vHFM_ZLzj;r+f-qm#liC9L9E+hJl@rbf?9U5EdbGDK@Pia%X>#ptiZX{nmWWF^x
zxXmmy2OQ>#Yg@4w@(6ll%5sZF{=3&(A39YZ7-3>lJ8;kby-#CH@qM1Y<!hq3r^-UX
zwMgQkYOv1%?vJ=XulZFv{OIm^uWRn|Is=qQGmB*ONzK_XnoK&U?zY#KOMP0R+1fsy
zhu>_&uHPwmLJo>F92aGzeO2=!xVE5#$Gi8_MV(3iR|}TCyRPp_y#|BA3ru!1>{Sl8
zSkFxsy|cWf`PMl4s8<IgJ^btO!?&$c)mXni<n%nLV3$_4PqRmnf7j=waHVH@^J`bJ
zWZzuRVNc2JoCk(uWmoksJZzi}eO=pc!=l(0$;zcwrx7ud>q%>U+kjy)kHTq_(X4WZ
zE@n!-`|d@O-EesE?&sOUlo?hbqYJnR$Kvj`+!j%rJwP-2cO+8q<O}Z2%g`RmgYq92
zGybT`>WFc1b(|3?*?A+^{B|#xThOSk?{d{=IwOCLPvgx>$DvMFEGBqYKYFrLH7_nH
z|Lh6d;`g{RP}R?rrWqHbb|Fxz<6x?rhhYpjGdV2#8NG@4a!*1|`VGlWaxD2p7VDkv
zKQp=KxxpSXhpbn|E03*7z%u;b*Ro6gcSCjrCGG}_^6|+e(tU5_$TpCintkTP>0jP5
z7A5wb)`m%AZD8nuNkfj@1-=ty=Isk$-shTU?pH#$-H2y%GDjtQ(sA(V$*s0O_>t8_
zQN*jku$!~+K|b7J*F`n%<}D;w%BV$;B!)j=J$WkOA95pY#w>u18|#CvZAc0`tjKrx
zA@;08#rcdFdr8dC^ZJL}zXDLZqd9qeMi1yqFITT!Iy3C?{$MmYf#?*)_6GIb%sq5!
z_0i=kJ%A;TZt;h8-<oi@iO8f&<PWXVwo4ByBdoM7ib8ENXgWiG`$0<d4ErmW!oeRi
z0-VpbBYlD^wd}5O{EQc&!j?G9RA04axEUN*FZS)k<iSj+((jy6<r%4Lfi`q!H*Toi
zq(EDBeCqWj>4!Zn-=FUZXA7y+D)v<L@`v5IKGj`u&hkO}EHO5%5ht6FCn3t^1<mOl
z<T6#%+Rjh*`W;`C5aYTOan5Os<MY!kf0OX5)*t6<?!H(c3M!`lP7`#ZmplmCxpHm3
zpY?lF=(#vXj?~(mm^-^yeBK(P-%Qms?Vh*%W#HO)MfcY30qsCE?=#L-#rnJDkKBd&
zxY^Fw7wtBJmMhipk67wcSH=~Bq*WGD9{AR?*>#@}iGD(Dxa@kLE8aQWTC6uU>DQ-Q
zV5^JU&6jMKwuApY<4|P6>fDX%{g7qrCcu4yQrNG5h;ayegQYk^Pv-Z}+$LC$L`K}b
z{Ww6{hGO|x^m1JwCaUU&kv7j|)4kjMG8iKc|MlbawBgg-(MQj#q{a~a)9E*7?tNcy
z7@&GmWRK!3p2lyKfBChp2{0&ka8!;z*<mR+_H-)D%Xx==7KthR&2)P9+^_0^B!2Se
z#qppd!@#2lmPv^>mJd&(?oma>{W959yO^)q8}j$>`<VN!v0#dtXYqF5x2bn#7?Tt`
z`t6IRZ?hXrC8e&dp>n?eSZYywr}?__3msq9&vykbJt^(`;npb@Qqdj@%D9*B%9`$N
ze$>`Yu)@0EO;Qs^4%l0^c6B+#6q$34or;?rAGp4W%spFQ&bNV3lhk_P!c&#@LQ2ET
zUhBkgi#ArB`A-H5`k(vk8$Buy+}4b4!777~h;<b5=EL_^Dqn~-kH4oL7XApj{n8X`
zzT_Acr^b8d=5ph$7pp2q!8|R2o%5>?-j6&a^XYXY7{2+M%-$lnt6*-9%%2acp?`gj
znIdl3mbGhkzBY7v{@HuutO}~Ui~rzX_UvkT$RS%wa!Y&%@9VZ7PMj<*U%BYCb|u&3
z!L8$n7OZ>Qe0Iun3Bk`%@Q3zxCx6@G)hq_TOvMKsg=A5_a^Fi((0SUXEVCnnX{yAQ
z4_{)1zX2|;iX71r&Il0mO|l%hTJNuba1K#C+~Yq|X^<X_ne_ea7le_m6_{YmPB&Pz
zpK@JLPmxY79(rcQ*0z7$&-E8+p^*E@#Wmf7$VD&8IfLXx3$0Hje#GGK%724fxh}aj
zw`9fTvQKlXbhQ<Z9(_uR0o((F>KZn5Y-|~Sh(7~|Pg6rAlZTUi;QRY&M8LvWxx<I=
z%nV;=DDyt5Nb@lrFMXeF?fE#!U(R(vx<u9|*VTi@W_XO_R%gZ4^GuHoyAm|^)diRJ
zUzNFB@#!xR{aH2Z7wp9J@yOpzPN(^;0R876iNDGtEx*!rjyE35uip2uW*z?FzuV)B
zKAf+(Jm&PrJ-N|`nxQQ3-Cu`+gPbJF*M7du4-|Ii6;NL$%k~0CdP#!C{FX$8)nNIf
z_ZyKO4}=(3vd{SpufNlhPRm`c9}z3j^G@8KzkOU5cm>`bVODd|U4WmL{CWOvg7RMC
z{$gu-(ELX})C2nM3!|Pqb2o*NrEUbQvh*ciFNXfdIzETwXDw?JN@a~7gMi?I@7xp3
z+WpfWJW5U@s+z1cL$!yhyvj^xM{M$)D~03hD{@kR9#lW?wBH|(;yfE?Cg*^sRF~)N
z=#7alhhM$;wb(a7gUx?6PL=k9ce4zVH#xU(7Wl=!(<CP0vpPF*^l(4q#&RXMwq2ig
zG@Z|<lo_sHznBgqCv{mbT=ebGna#r~*jcOoGUewrCnPlHcMXa=VGrfM^k1%r_Y8hj
z{j)SAEHHIlOvW~?y^2K1`4b$0N~`k0Sn)?Lx0^tzZG0lJCRL|CQs?pdf~P`&)ScB2
zdQGz*r;FGo3-Y5~wgdCDAM;-n@F4HulETF8jU9`VOy^t+<Z|jNtL`bO%Q`%EMsjX+
z3YNCK6;twLj{8!YIoh4Psm|WhFWP`iS>|CA8lYb~x+J<i>i5k(Ac4x=-RZ$+GRM~*
z+e`bTf|->TO}Yz1pRu}LZ&}Wr_98p4f|P^le^%|l?rD8WJA-jR1s#Xuh0B`Ale7#P
zE3laTn=_Jpoef7tOTO&MCe;2r#=dc>(4pgZSEnzg^69IH$5Q^!m^nVtI2*Ow?N~lm
zaywBv4ptgeigag72~IGtwa&0<CHFrJ4IUAf!F01*sa&!Y!RI*1?DA3z{1uKdba}sa
zZ5s`VHFihZ%>@6uC++(?)HC^20i~X&phkkjAMx5y`E$)vrkH*q!=^LjBqwqu)vMou
zzxBJzg6Ia4L%gIzOcB&2Ka|fWJpEJ@h$~rb+!j+D)_<*E_#i3q;y3iRNSW*hlG_(Y
zDbt;-G`e;P-=RNzF55S61!vJnCN4E?53=(8*O8toOVTf`C`-R$uXVd>oUVJubm#g=
z@=rs)Ypf2Q22ZOnQZ|Idu6&+*=fMNnkzM-@#<lut=&Ro8kk;MkA*9<q<%f;G==^-b
zM6XSLOV)!LjyAR?M_Wx_G<_8-M-@-iTw>uC3&}cNG%qO$Q-Z$!+fmO{r`5WUM`^gm
zEoPxolSk&){HS<QZwYK(W-W3E%=@ynQATDB<&kroH5xyAV9>+DQ5E>5^{$Wzt)HKU
z=%Vf1C8v^CFXEA^JFk^4{pYpzS9@FhvpDZb!P8WV*_{FBsB4<<(|Iq?B;;!q<^Jt7
z9?BGWGI686zf|;`46@m@`BX*exlUL^8=G)RUoa`++{UucEjy-@VAp#w-=nD2naV<b
zyst8V5BDCzf{3TI9Sv(&6}?LN_FmXY+jz@f2`)3ZQ~n5t+2uNB^5RT-@#|;W_cseR
zRv%uN*yyxtt!NEtoPOusoL81xzuJ`ll<_FUR#+oyD8fnsn$o^>Zei5JJ8vXLFJVaB
z+j9Es>FCQ)LoOE~py9gyfCjh3xzafjy<={($c@$NJO5^nuuTRmH`N&3`JS$Ge>_LM
zoRhcUmpQcl&%*m}x#A7wr5&+4J({vbwo{=yB6Lr(T$GfnY1<EI#xBnrc(|lMPXoYz
z(IZ>Ptbqv^Kd)fn%QqhMI$DTP^FGg3i&xo<{LMk_&3QJ<$Mx9@eGm0y7vlMY0;WnG
zfn(*oucfE=&FYcrNxZ!)2h4F<EgJ5v3B}*nw*C6jelDRZ9otkc{do`<&xUyV^YKF}
zv&pJQp>g>@4ECZJ!Cs<7cI}mOy)f0@{M56nPcr+>pE|NxTTiPHoNT{-ZBqEonB|M%
zFUz>j&I=!U1FAZt|KuHi^T7KY#5<((?NP6JTuQUlr`wZV+lI^6CN%E*Mx>@xgnggA
zU_f>Cri+IPp8h~A=nk<&KddHR-~VZ`ALXV8$`4X_l=C0wE9Y~?{}Db$U8}u4RK8F%
z5Xkx8musBH2_mt5JMuqI6$E2kmQ?=9#Y}3UoEJLpSZ-aR*HX29Urr7vrqOKn`z#_-
zbNhVt->2mg7Pi!%(-zWsqJ%E=y&mqyhH;HirMtDYxn5P*&wa}7OM86Y*6CHhi9Aw1
z;OyV~&{B3nQQ}nv5fkKlXPH4)<wu8-V%CovF<il}>Z5tKPFoV(D$9zfZ+h}eVdpt_
z(|grMqkUgE;#XD6tmHeq9X&6PYF^i;NNrRFn!kDN|FEoT*_3^{c;YVo>2%in-ygU>
zv&S&)Yep8GZQ<(L844M$F<?dzX!UarhVK4JTM%hQIpq5}-AdeB-Q+A+GH<I9nw>CI
zhIc%{kY%qC$q|D;9hOWrk~TL}qR?1vHJN$gK&i3Qpaly5`%2_UXer9w(kPMpXna~5
z%iPd0LM=Rg+;L&&9^grObK-uTLn@M(C}&*%`(^XC)B9ms1IvTkxG6c!JCU->a}kDC
z0~6}ysSr1NbpyjymHic~%MQ-pIbN9vFX-`xEgfT@t;B_BUAjQmau%4k%Sc>g@^0nL
zi_c%?H<ajNxEI>fnD`RUSFk?S!%)tEqq_3FfhG7=jpI!vid>FwrL6c+*brYzN6U?{
zoW9pn^Jlg6V{fSu_-44Geb@6N%|<4#Yi!kt4QqSIJdTLp`@1F~(ahZH&gI;aHbeVh
z`ft~c@7G#S@p=Y1c|DTa)t@Lfl-^!*#=NC>pkZ}ck?`YE+jpUDfVqVH;-Q1F<5}Cl
zGv&&8K59-JPQeq}eO9&#liDfY3e1Bd_ON`Ju@0(D1{XXM4P5SC--p}MnP$_yZ!3LU
zKM^91-=<HLM^;yHV)kR@$`(M_>)`c?te6)Ax25iF4Mo#6eVq@^r3~LJ(r|z`)uB6?
zxn+Cu(sZ<<jYnnA8MLGi>>8itRS?YPT&c!Ac=LAP%p7Ay)8=<^5MRnV+d-MNiU~UH
z2pUrz&m>mAP@0of==B2S<xt4M?87VC3-#1<3Lb~gR)1Y6fs{?XsdU&`5JEJ>RfWeT
z2EX#i%b$OGC2wi#nHN7KWy*aV<}~_21-dehOdD7J{m}hyUOEQv_BKX!VonJ%%F?rn
zSxOWWxiiyRr1LVShKFx^rXg&9_R%R#s+HMivzVh{$@arN*0)L3D)M*#uwXrB!!US`
za}pf|dMCKoRXhX!)A8Th=NKqh$49$))(lzhc(VzwuYUrpxfjGs4Zh!a%d});Q1P11
z{gdJm(IgjC#MXS!sSDM)*X@8$sv1ePdV4*+!+0bsGWUJ`TNB>{AqAPV!`DaCD7h43
z-f;hUt|#)Ql6NyuCK1i9crE7FW@;)gsqZt3G(zTnnSV@Jn_Y#~p1iJ%Kmr+xU+xB~
zeOP9`#4*>fV7q`{7|h>EF~2!LYPj{hIfieGLc+|%jwN$6dTRWUr?Zv6>?rS6p2=@}
zrq@0vxK;0WLwRtA>%o7+Nq7EgU;6I?@#NeTyXQi61asYg51#jJoE2?&+8kLJa%}zj
z(dxIkKn->tmb&*kp`PdM{-wo5d{uEjv?x|#xJwahyUZ;@6B$%D{J3GY)U(c>^G-th
znV9H*LC*0O0@w$a7vC^9eJxgba-lJ|G<IXam}c-vlzxs=F3sH|>?WE^sCeFg?<@sj
zP$_<9!C|a7mJ(jQ{!iat*YOI?!e<uvtRixtQmW6pHWf1uY4`v{WW!9^w=gcN{sg(@
zmB6TvX9+0hNR`|d^u&mQqc(>>$G>hwiP!BtZ%F0=IsVF*4~6`k)L_Th`v?tuF_ZRw
zae_z=nzux&=AktBf(sHPCo&3tM9S<D6Z{SIZqJpjKPl1rU<?J0HHWZ4k<xEIHFVFd
zYyT{iD)4k`6cy|cY@h3}$d~pLs$!38KYrV(73RhG@<vj?4|j<mn>?p`BCC%)?yLn!
z)V9nux|z<Getd!Q+#**MGJCiF$Kc+PXuR?EDMu1dM2GH?_pQ?sQ3i=up|Yo59-X`1
z9h@FXH3GpGmtG``e|y*`@byQXH-A%p-o~Q0@YS%z5H@9L#KS~>?a3XpW3vJ}J3{h>
z#v|F^MHL1q_wvW})U58FeJ!+aET3f}^B<M?%4LJ_-f=@orxPBZq=Z4)bz)TaovMFo
zF_xQ-ce*``>x<sr77nMiHi!`2;B_4nZoL&Uv#q1J&J=Qk#7z>G4iD(<I?uni*rX6I
zaZ^LWti>|NHXWtKQdD3xoygeRXMJ<m_?kx7_|Fyl|E}jU24hIX59^n6vkd=Z(s;B~
zF^JFZcKsNg(->83$fIhIzU`2BNBXF$L|--6b-iC6N^O_vHndwko=JaI`$kCaW|!w=
zTuR)R>JUwLh5v3P*fJ&QBh_Tpx;kl!K8*evq&DMy`6fI;l#S|q3c<a^Be<1@eHfU>
z4Y{AHe{sFt{-5gfo0hK^__iK=Wp2pNA1e~&`F^~2EaAu!BlR<)r6n)R@ZEdhD7#H_
z>!<)NT@)(w^%sYhB|Cj#O!NxZtKv%pMb1I9gs9l|azw>XHW##Hp}x)auQoFoSz@)%
z-!DAf8{s~APb1aIs_P|@bn>J<!pPtWnf}MmS!ygXN_yF<^<~}yNLd-8;Ypg!xZ`%g
z=AO4!?EytNjWIwCb-En#X}HE|ts;XJ^;6E)=D4Qwuc27muUl?Uu+bCR@xHI?E1Rgc
zjHc7#u5$QVp#>KOzt*Z!SlxL!JpDd&w#}xgt<g>t3NcRyd6itXzVk!yE|}6J98!KS
zE_7d0k8~@T_KULceLiCWBe}`uIh$H#y+x64lQbqJ9IK*W)wyQPZ;Y1mZ?Aj}eg3Q<
zmAkooxOeMS%HPcS=MmIc1NGg%1Y<o7v9=$fT}nlITa9fRr3^8T6sZ4MN?0feJibAn
znPV_J<MeDdL;L8o<VzuYsL4|)y%G1Od==7XgSCu-zq6l*qKs^w({h<BBNsFR?f(mq
z)#&c7{BP3bOL!3G-kb4gd&R(8UztE|YX$ZR*{$9i4&pc0BOIP<InqiCq|R5UaF73s
zl$UJzd4-Y8YTn|JU-9@VOVn&ikbdjpopbw6k30YLEG}hx=!jN%Fs?1(G$mM^{<<FN
z6KGh<to=DfhzuzQ4a1-QohhT^82GfAy@45Nn+u;S_bne&qVkx#8|(9xN6GSU$BfHL
z_KwVU0?A?@e1D%4f9b}f^k#ng5i$LNcas8XzAvX&qilzxZ=Y01{vtbm@su+exjv0}
zCKuG|JXMg<?J-4cryI(<sb2Oe{6FkFdMgcHyy4WFcP~3k->GeUmppv@GPCp|aXc?)
zB3fXLOAc$a>NoqESL$V)d*+MnCspMCmM)eS==gmMo21E}`N^1ezaRu)zpt9reoePh
zV>$K?Uq!&{=pKnGZfD1j-G8U9mnG{5bRo60Zv*MEwTpL0q5`)Q)slRxw4{G~%GEXe
zkhv#VDF67cfk4>E&7(OX%1=phLqGGE;pnHC$zO{()6#FnRXq&D)|Qn&N9Jiy2DV#h
zJwH2;+;pJ8kkgH0TvmUkQ58%Xbxk>ZG3rW564x&nEnoO^opJWs2@1&jYL~q$5eU|p
z2)GZ+Ne2m(pD#GNz4p{#9(A9C*Xy!lhh`d+KGH6)?I!I~Un4O@eoWwNC&}Sf#)wm8
z_ssd?5(8^P=F4w&9*=h&+kFreSbdT&?j0Cz<)j$ZihOKQ5hXYl)Dd^FK4$y%m^ZiO
z`@LWBJewakYsL84;BS0gTsWr5DmN(mgvC=lxhE*-nBAOxu<<{!!?k;UkHR%h_ooQw
zYaPwB+u5YP=TCOKpA_k{&n#5n?-$cn3hn2!aGNAnfA&Fo^I2OyV{8*a(A{0Stz>kd
z^k|yN^F!e`58U#F;{U4W9as#1-!`hYQBg<;`54t(V;kx7`C^z@$hpB^FPwT@Ba1J^
z?$4Ur=+x#<v)(G?iu4jSQn1%B%ruI6m!w(KEgU5r%f+M-c4H!K&HC?I>pzY7cU!Kh
zVr0mTR_4!zt6+jY)ohRCaYm|nK{8K0WA!)d#T%zVsR@_LH&lA-zAUq1@Op-hqb6aH
zU2dSn{X%xbF}fI!E9agLA%72;3r9LOC_ibbFnOMxe3MY9{f`(Ed-2<#Nb;v#ap^ML
z*4KM~me?<N+m9a}9Z8iKYB8HXv(9PcHuy5AZ*aIn2Od4UtCV!`D=58foXg&S8YA~P
zw9r#z#@@@z&aBDcpAGl3<4-y2tdO^D-JZv_rKV2?frd}Yha7dJU*6cfs)F>y*ZJSM
zva|EY>ru5Vj<EaPdG$q?@I5WggXL=}W%DH@o8~%^3n#Yzwd&{Ii7w49id)(V7MxBz
zxZHRBEBfmT?StK<qs8eTimPXQT=oMEa`?sjYJ=03D}c2RlKX*GIWKJ1Y|nc+>-o2f
zcIQ-;N6m_GA5`6AS`I2wNV}dgZ^wA{MrXOl<hKDgC$pCFAXA?^E-L9o7UG!rW#o8l
zz!e*lpT9~Na{X8z6-n{8a1XS+$t-y36@t*{xnjoLsr_09au`yWG<K2q*P3XVXy3ZO
zS@q(qnNXXm_Lo1RUDB(cdp9iJ`&AUKZrr5ntZdiS-gZgo3cbOG`;#s8>`SPd@alM3
z)7bPI?P=XB!}o}-(X1tsqMuyC^*$|b1$<D}?Cy2YjBoGNnu;Cg%AH!NY17J}$X*es
zXhkhXt8N4_Y}tN)giKV82+e=L6T%bM|6q`FBJzhtN$&y0!r%AWt+=jK;p;ZP{#AI~
znt}f7pdIYju$6c=g+Hm<Gf6d@xA>SVHv4K@yOu$TZ}1ST3dZZIDx3{ycC`1t_LVkf
z<}U*alh>lqyIs@dT-4>M^d1BK@}OblEw>x-T%SHwU;Cu;_tL<-vv~ob4D~5Hj2}xE
zsSEs-ePfx^@@hJxtK~SZ-V(lX(P?#hV#}$PKASpey4&H4t5VFTryg5=f!+0fF&*HI
z7KY>%+eePiQtv1yx7~LA{UO2N+G-o(m$k@-+kl5$B12ha-nEk`Yw)gFIbQht{@Zun
z!c0o(ziD=Fu3h30SS%Xpi&J^r<QA^~t|xTNh3~^|@j^v#v8HCvp=Bc0=IsR%TMoVU
z#r^m5mlKa~UgPOm(Y%hcb5{|%3V{L?{TJ1DZb${FGj7g0y7^r6%@ufQQva@(CRgNE
z7i)3UrOoJT`{?X|6E`-slJsa6cr#r_Z-ZOqjX%*>RXZ>IH|oT{_#Zxo|3nLwJ<xU~
z$TT;&&@w3Tw!=$E+<3z@Ydz2=!i#aPg4BI^EV^1*osH{a%QD3>-!plh+2<6WYS7G?
zWgGdHyGln=zQa>{cg)E_2V-!vI*i9ifY5!WACdLgy$T$#o|nc`HnoOAHUpkZk-p6D
z)eLIbNQO9QRLS_?B}Z#$NVf6(eLP5aJmaacr8xNeY8z<LtuAgx!@75ikM6j;CJB%C
z4D;LGiJLn4JhsDPaA)!!{|k$J#W{f{A?r(w>2G)<XSfSSCVt;9djv&<<)0HSV8|;T
zb>B?LPcGv@cuMZeAFo;Xbbd-H`zmC}X~QZ`d-<?Non`DKpwOScN3!T#5r3*}=jf9#
zM*o3U%_ENADn8=@W$Daxc8Wpuj6lF27w-PuR)dg`58QX@3{l{-yn2k&KlsL)M{Uk&
z`MR1McIyytD<ti9Jo5c%A2zI?B;Z*8Jx%r&cp-c7!Nq+-tkCRmzIG-134K|RYlSqm
z6uzL4y_K)MWMjvV$4XE3^^*iE6I~(a%M%NK0!p_*{tqIytI?sz*vIeNkXA-tO^gco
zM6Odd>bN@I3N;HV#LI7JveI4cKhK^&(9kDcq)R%EU~W=3syJUlKiVeDqF}U>%M@Ll
z$RfGQP~En<FjLz3249QQNt2e1ztdMUO#R=|&T?|yW`KC6TISN(Ixaj9KYiEF%x}?g
z=$YGgZz>a*QZ{Cum!FQ66x$btX{sD*PR)pFM}K_fWa6<hkLYzvyNt=@D^?qP`e;^d
zN{<rwqfzFn9Jiuw3jJ1F=GOx7LELmNZWWxc-Anf#C|YW*9M3km?X}99VDGB>e$HT!
ze^3s?WtgLU<-r^=n7j7rorohB`#u+j=of7dYwnVlMCP=_F^DI&JDiLn=ghuo4q@d5
z)Mfz%I;j2#*DS=68Q#f*PIHcMPJf)dra}pfA4}H4u-y|3n|N8jPIoL>aJaCx{FdC4
z%4oW-Nw4?;YuJ3NE{POR$I>wQ+yKF$mlc4v{a`CTM9bbuf483FBA33ufG!^vAv?~&
zAN$F>z<7|TXQ=h|hxxNudgF7I3Kmv#(=#zF{vW>%EE^oQ*oTuVDjh-(*JZVDm`#Ue
zD4T9+NI4dEbXDe8H@-QCyrtb@2RcWadK}#Qr?k<L<q;Y*CdRLGHo2Y6+$W4JEG4;6
zH4lr`;l#-V`W$@+e^r}3bRy3JevdNq0w3K^mmN#qw>t7)z~a9b?z8CfO?Jd@|7qTB
z8V>e6x-^Umc-R0jbeH@Sj1Vef=38C=a7FTQn933N<q0H+J4(Hi*C=toyLcqYJw8#R
z)_Zw8kx?W&r9OIbgh_bp8<k^STthf|(1ER2LeBZ#IW5D`z_Vx4+FSlJx!(S%nHL<Y
zUES;Az1<n(PHyipEcq<*ir+!^Oa`{Fwc)Jq+dE&{?75)dwQ{e2O&%mdSya{ZN2eJP
zmfr98%e$(s8EZMWzovKW=RTm5xI)0ZpL(2;w-dehsoJLJTlKYa-AaWzFP+%-%3lRR
zQ~Aqu&H^N^r}kZ9)g3&a6&N`Oo{oH9{k6itxht>Ch4>cHhTwoVu)N*=%M`s>$8V&S
z{BHZYcV^Y!(&sy~mp2|YH~sdYj8@#tx>Du+m?}njd_-OE%Q9WHk@t%|z22mm8%)+>
zZd-cPE7d1|8AsnD<pnO4UrZ4H?pW~JDXIlcmug3QAUZ5J{=P$bWjM>B_J#HH&&u24
ztu5;LpqS3dohdQRoZg5ulir_GYc5*kjP5iGg*U37Rg=o>_ixA3a@GPYvOEeQ?ET{Y
z<6cy+sO6-u)}e~;8&RlGQa>K*$Hn7i3=FQHza7b!A~ijx>&(A?UMSOo9^oRVZx^2F
z)AcH8jrWUBa{&`e{Gr$@|1>o)>_dV(p%@XI;9f*I<f}>F8adh(>M#0%-K#ZuCnJ%U
z`h$@6dPqrPkKZ)aRhzCag`H__Ze@5e-cF!c@qQxy>aSGwjw{fpv+~@&w;5x+#hBU;
zwMh>^xR_P=8J$!qQ&`62e@cyOcB0w%x)?;!7QsATzTn+^4e)s!Z@c%^nQu1XNlObo
z##AvM_a6<f@7pv?ur^sAupORre|=}Sd368P$(rjh;~gw&+37(SzqbCGCY8v_Tg!X8
ze-;Lp{t4=8BJrDiMZF}$55s)s)U&HECg1YhrIk}4THNL8l~cL*BAEYLc(!lk&g-Iu
ziRsfuPLa06^v~mmg$X*FDk7|fg<tExF56Dsnw?i>_I2~}I*b0=Sm&et<ipdCyXU8l
zr+5G95O|%5eq=Q2zk>anQW76=TGhQQ3;J{<^R~|gs-7p$t}E@vpSOyVccr;~x<|*V
z^$Nw49<Hi2g84^6{$T4-I;pLZ#9iiPI%}9`<Q^FOC?G&Gu3_=NKB>Q(eV-+n{qZh5
z&)v<RiumTWT%^|ca5mO3MoL|z-p^&OpT;swZ!3OJSVD<Qzo)f5MXPtCd-@(PgWx&a
zYrn=OvaV5EN_GhPfAOu^{l0q+$4lZuFD{)*8Mfs0_AjN&3oQnO{P!RPyMBj@>_4I8
z`P}=G$Ey(~b!xAYmtgQ8D&5$+5m~#JmOZiKN$qzUqGRh>zg8}a+)Zr!WHzaGm0{-Z
zJjfH-S>xg})1liDX|7ZndXVtxttLr*R$^+NYDOmPOkM6yaok>0dHDBB0^6SX>36V0
z5ra~giwR=m_(=K=I{qRrQ9*?CPQ}Ak|6J44+OwOTvR>?_{tL4ZxM9G-^ylDvZpPoa
zi3x5$;q4r9?2D>g?eI)mW{KwI^V8jI&#Wyv+ls5g?MoF?dKHGvZqX6MO+I$V%dn3i
zbH3N+88Vp0JG|HacFnAr4907RTKtmIe&!@upQDple(~n;VMqs8aZb~{DEi;ck3QIW
zXH_lsN8MQXo$!V42dh;T@Ux%vh^5(NKZ5{lDkJ;ix{p!lMb<3cBpJ&yWdfD=f_b>i
z%yP<19)}+OIZvmZ`%jIZ{=uG(z4;pocKgzMaf;~BQAl{@n8fP`BB_gu%;mo$;t#Ys
z8U13dIZlZKn?G*SKHv&CA2siurzy5j<o3}e^F_47kHqw`K<#t0pVsra9ymu#3xzGr
z$>_3Ecd<~Jsl*>!4{yKQ5-ShRaet(1^|-3`uJjQ2<g-VJ$2f*B+wykQ6RHuu1Mk}_
zcDsclnfcEsq!~ZikaKF$`yvMd(~+fNt2GIE{O#Pf@zFARrNd)CzZ73{>+C)|HZ_<$
ze(`0>_oBTU1W323u7!ymN{skYy=HzP!&iI5jqA@t1OMp=L0Qv9%F;Jm#qqz?Z<||a
zUN0LwxOC~)<DQG!QZ#I%H~2EIcS@$17x12@uDpzu#me3qJdV2W%xlpfZsJo1N!;Z0
zstu3!Kc#~-lOD*pL?89%l2RsYbO%Uiy}Ad4vyasu9KLDB-8j$oYJWax$Dx(WV&}@Y
z2_4PrY#e%0Wqd0vf1hVur^oz@YbuLgQ33>n)%50ipH?<+`I=m)bko#ARdcbtvap(%
zB~DNB+Fm)R+Auvl?ESRgWwtbZSbWgsVp=U87|12Y@tCgm?~3cMP7~heAOpX7RK|sD
z+-518(2sQe`)S+2Cue_mb+5NAydiICYEB0T3+F~|mtUt^XVk1S`E&eEgf1qgyVfg&
zBevJg+x6$puWuV~nj`IauK)PR;Or)J?5~a6e>Cc^xGrm^gUWm^yD4nad)#__;-)n=
z{9U(UMkhHJr0J}@Uvw>|&)@5l)!zKb?c}_0%>W20<gnJ-Otk!k6AX42*i0{Bi6ZZ4
zNt%BRc^g{uY9lCdBM9?YKF|T@ZBrTFRpBV$5<4Lh`$iEN^5%0mb#=Gr?8}y?P?|@_
z%3{md^lq(bF4JP5T=eF<fS2fL^I-cDrtA8h90-mFi6R^ib4AW@001)wGY6If%cq8r
z!cklff5~>9p5k#FshaHu;)wtE*gpN=<9`+SUj_bGf&ZTh=&-~g5GVu=fkzM!5CT8~
zX!r>$LJC1dkP#646re^hBSa9!2oi#Tgirtmpo9Ne3E_jFAjn7v{yV^g5JDIrQV@6~
z0R>S3Gyog?dMiXFf`}xeAov9U7eW!?ju=LekOVY@1sDKcga#r6v5uf1$!G|E2S5<M
zemnw)#G?pQ5Ds7gMBz(jBczZ-6qyQw-x82SSRhIe#z+#1fPrWM4nP(jV<W-`NkNe@
z5PS_l0pW`1L!=<_XaW|Z2e<)cc$8C!N+c0Y#zOE#0d+($Vg)gbB%uk^5F@}3Xd@yK
zyNGop1x==g;86hj2mpaX;!t=h0uEvZgn{$$#8{D1C?XXZ2f@Pvj1ZX!5u`DSL`9&1
zSOIb1GF%!Zqz{ThMW%t^aRTOWB@K`%C_IKh3$X*zfHhnTD`X{#h#}KL@W26EL_NYC
zIgBD<2y_r9AO|=gULrz}>nI9_Ob5X;0bJnn$0KoQJeEKY;eoS&2VA~vq!gNnCDTLj
z)PU=VNkj?K7)`<w7$6=%6}SPfNF&k*O~H~GAb74o5Mmk8hfG1^sR@h_AD{_@!WExF
zR-%d2WJU;{Ja7xKjaWerqe;{RCP)C#1)>p$h+X75nnF!xg5YWZFg%bb6pjjyBQQfk
zz&RiRUL;nO6crIiW`^MM0LchuqzKBGii9JuKq7!4a32PO63T~)f+Mp)aJ_&Ggb>mI
zl|qH5A+SPXz$G9DURNtrB^8l|%nHE;1o9DzNO#mQ6^Vwx21x){fI@@@G6c0wMWG?H
zL2yNZCouZrQ8)~qmcR~40hT~1425iz6oyDkW{2Ps15Xha$P$z>hD1x?fMkGcKoyL?
zMwAbRLQCd=;F<$<2v=kuDg}e5BXB}z06U-wM$Z(g5<{dTb3*VU0Ii5%<O*sSL!u*a
zLGpkT(1D0V?xNN)6gn~&1g{Fv19Jq0#$oaF1U#e&xB>kz;8@X8SRy?c55da>3?VX+
zB4}eQiJrg>DFI%<C=7cgv=5d-Pv(Z;bps|~Vi}-Quy_Un52OP40`FjqTA?ekL<TYs
z1TQ2oi>ODsqld911_Cdn1_S^f5igM;=yfcGfy@iRD+?^a<cmk+sPT*hK1c(&34DfO
zosE{FCNh%wAb6>PHN+&c1Z_-BVkGcGT0l6k0kf?U?L$prB=bY?+5=mNWn>>Zg&NO9
z5P)=mC}0m}!W6oan#e>JfM75H2Z(Lt3VN8D#6%E;^ne)P4<hamxr<(>rZABOAs8OO
zDXbqTDjW{aOb~(y00^LA_OMb(;fTy+Aqd6`K#gQZiBK8iNX!Ib$N;zt(7`NMqVmB}
zn90Hr3?P6BDTFehO2Oe-2qMr0;2yvR6V8gN5=Ueqi$E}<04}5=%AIN$M`9s}LKlHF
zfETHO3ZYuZQCP^L5DYOu5Eh?!DjW@-l^_Ng16hD5%+YKrDH<XxSqy?P2S_3<P$g8x
zG$dAnIAj9k0<y5UG*bD{P*}<05DY><0qKhBqe`K{vk@d9Q=kA)hG{)TRY^l+BTGOq
zDgkw5FlvQrn1;kgkc7;DB0w7%iQ1)Fr=hTsB_SB5fIbpHp)fdFJUc-OvH*&K^RN=I
zVx(w^>|`kj#w}ok%tVP`jA=>i1Zl_$C<iXXnx=&Dp{1~sr6Cx|fH^F*2AC9DJO@Dr
zx(Yl4tYPu6!c@`{Imj{)jBLObS&wqZ4AYW02(pk3Py;w1U!p=V>$DUOvMdBc9dLoQ
zHy(qd!*deOKt!Mc@PPFu8zV(W<RqVgVC)0ek&~zrj4>UFlOPA#1I@q<SV|i)K6DgL
zvK$1H0SH1aqxvu@ba*a;Jmd(p0im!&O<^kOh+JfO2xbRx3%QM2!3@)pxCjc6GtdP@
zBM(u#m~}b|7g+&<=>o(d5oi<^M~}x76d_lj7f66rjTI|JPsEcIA(%fvGLjiBf;FZm
z;R$CUci<IpA69TBtPec}Pd*F5gaR^<LTCeQ3O$~ipagjWBR~!;gjU!}dLlPj34$30
z<RcZ)?$}{^5;s8^@&?9$LZk*d1iMa8;U+6XFy(+Ju=T`aaSV7Kf(qmVyah^O?aanX
zF%WskDiF*;;3?7qU4k`cAn_1XAwOUSsDh275$nT1;UTL+Fe!mLq$|1)o5FzSC8$CE
zzz3iSmfI<8B?FO{tOmg>1zM58=oRcR1BsWQ4g~@WKnF4sy^CFEpzxB_A(*y65A3NZ
zY8)e;kDvhs1D}9?SfN>|r5K5PWDN-BF))P8M2k=xGm`iSnotO^3XH;jr9|z+NZ})E
zLNKv`3D|cHs8bm6`~)p14EP4TgGJqnx{{H|Pu7B9rUSFcdbB(BFe8bdpbbR;o4`lp
zOLPeJIwOUjtPR1`2bN&xji<&j;ROgfP$aMee1?4>n_7yAC_vVMU@ZXFkdx>VYGWpn
z06`bJ4g3Z+V4G~D_F<w3kaZzg9Dpt4GP;jCg$XZ6(1Y#(N5CFz9aGemOhiGl9t5ie
zaDa^4Mz2s0Gm!)d`cN$J7x;rbMDJ3sGf@P|`VcH1z$p?zg~H*O@j?Uw1OP}74ciSX
zPKuc*L?%G6o`BRSW-1Y!F*8Ysa1M$GFd!Xl&q_ESW{ME`90Ust$b=H2GQg!U<An(Z
zP$EDBvcV2zg{x#H3X=^WSaCoulp>WoZkU-QOgIlE0Sq87N`oo{x6VuvCZC632?7P-
z<Pnd<vEW4r7oZe?1r&u%EgL7rLKGoifM87mB~cbsB{*Xik_f>NN(DGTSvVCm;(S;r
zB4k4d7Aa5x<x16uOJTu_5-vgy0B%qj_Q5G!B@0oMd=Y|G3sgr1Q?1~JSxBM;BPbo<
z2ena=RJ*u!7K$j@2!dq{)JFkSC>k6q9^S_X$^?YL^RRWY(nzrq#mL4GtZSeVDw9ft
z#+a2PMz{oJ1LELiIE*OK_^?vM$d@2k=s<HghZ)eMu;RrDCeVL?G-wUGtrblrD^Z+m
z0>R1$+M?>I+-ZhcN#cadP#z!$I-p)sh0v_CQpCxZAy^7Q7dUvu)8N?f5(HC-1e^su
zV1v%4kzylCkWC?28^P<SNvaYWV>Xfm;R^H+Pz7(m8K{xQhm9gZz5>Bw2?n8-srqPA
z*zl4BGw2bZ35LR+K1EZ>MwBF*L9lv)w@}+uD>TDwBuRof^cc_uqfv)cyEN-;6iKo<
z1j{KHheBXbv^aLW6u|<5fOB9190OQsrPzs5WD5w^S1=jHj1i$VW+zDzETIy>5WEjZ
zFC|(Zc8V0)5`qO6%s>fY3}{o>@zMk<s0_FS=D^9pinfxSC{4D4U<C&AQHmIM+F^E*
zG{G9G0Iq<AC=E;q?K(R}nrschk_<k9b7wp)jsq`4xC&JQmS8CyHnM4@IEXUjs}QWw
z;8T<Zri9j*gCs+^20aI^fmLwgYoztzpvaJ~L9l3pbtqR%A8iT;UY1}3RReZl6P!<`
zXe&90vSb?wR&lTu6^vP-9p)g(5^SMbzzOU?MPhbo*EuM%WLpT9b+8A{;3zsAC;kk9
z2-O2_U_TsbSm~rViD$?}2-bOU2$hKup)=+rogvskjer+83I|OkIv-BT8L}M&3qLpk
z$8rO@6i&Px!5(@6_=4}?6l6tL$w`zW+e5GufU~H2j62;hCrOUr0JQ)C;78O;ObFdN
zCq<6z0KwJ(F2S)oo({)_mnS$vFM*rjXE-=z(@Aj=<;ji^>=ob|Y7$dIXUs*CCpbav
zKsdMo=i5d)A1;bK*$INp1KdI_WBTY)xbO-DXQ&g10{2jH>zFCJN-m-T*%^ZE1Ux`(
zV^-*fxkw5G7pNPEfp4-s#O%_ob5Rt?E)eW5;3*1$MbYE%ctwIML<T?*4d*jfdMP|n
zk?ab=h67TgnXw}D#(0t<!42vI?t*l1u2!P=!BZ5;ZV>E1AQM^$Ye1iZ$Dbv*Lj%A)
zkPVJ>R`iv4;#smg1X~iwg;vD6(+}fGX9*tAAdm*~qBXD~^y_%aS+WNNdlV=Lw;l2H
zIBvWW!4nz=vOrNd1!mJraTAruo)BzWpd{J?TS9NlO;RFwL9c;aP!^8!jr2a;6eY43
z1iKihfOf_9(Wh|Zl?mR^8=wGGhJ)i2eI++hnd}Y0wg#%BgRv|0!`vig!gXjIC<3+7
zk=R}Ob#96>`8ovq9H@^5uqXx`4_<}f15E<O;CVP}vNA~V5LL)N5Nv#)5jqnq!eGop
zQX%+4Q$RU*8SWyK7<_mrDr8>>c0$k`Zqp1HQh4yH1V3mRcm`U-@zjc;l82~D_Jd$+
z1Z~mvSa*hD9+E2I2J{}N0UgjUu^|lWJQP*(4G8v1&;{<g;u&zfcr}7QL;)H=4>-|g
zGf43g)yV!3Y@XnC^dz=~!I&35y)Xcp1De4baP!j0;KNH%BL_gRn}R{;Wo#cq3NK!r
z5D3i!ZD1%If~OcNd5P-eKnS*1@D_R-yTUNcOHwBUL5n~a7>z!}?lP?NQq;*o5bU>L
z92!B5V#M*`H3-4bGSCYqz`2=~QHqbKK@Nss0|t}P%+w-`#(X3V!cAxecm>{vdnP4D
zA3ll(`6dKAGMIrDqBdYm;lpbZLZC0e2$%y$Z7aq~KB6W$1cEIZ%ttFyyE6{+ku(XR
z&{tp#EJSNihcK@5Q8dY+5bW9D6S(P&XT<U2wFqI*I`9@Oh0}R9qZB_;iyQ{QCJsJD
zTTquU8uOF12;tCoU<Ry$TeU_;AAX7!8Qzx?m<8+5uGD>uDg1bCLIm^!_y9J+fqsgy
zlAowej(}jB2V2p>)GLg`{3LC{E$An(0Cu1wsdpLI`6=4uTM+E~U=Q50qnL04cpX9{
z1b?au_QO2@E0dG}QHLA}!9f5VLT6HoFc}MwbO=$<F0cxY!X2U#laByJha3gL$pD;y
zyLJPn6al<0;WqRO_y)d%+XgG9N&%uS`8EVc1#lK!Pwmb$EI`sFL__<)CioHkk~)NG
zU4WuXj)vgu04~8jcRUkL5U)qL104c8;Agng$YzofB<hjxKya7<*U*#HB}~SGBt1e5
zbPW6kH{iy!k;zApqDPK_;B*0Qq2rdR`<PM$@%n^V=mhvbhR(;YiTaP@h9bxBv4I>S
z0^`>qDmYY7R6aLErl{b|JTnt9b7m%DCT0e^``mWJOvKDHGw*X|uB;@iq^$f5D_4F?
z!^$fw4J%hx5>`@He&7E94<By3y<gAQkNxGo4&tOI-k&a%(?>NpH{3S{_eJ!^2h-JZ
z)U5s2@~`{m;DLz#_)xl0PMbBjKis!~d4!pm3>KjlZIByu73dkWiOUcWZPDN$5hI3}
z7^}&Vp(5ng!rbuO13_#vxiSny-5OjdV*HQ{#%@wFSRRSm5O<_#0SV+Z`7;EbiW;0O
zV)Bq8rrs3HP<bS2L*21r>X1^V(G<!scq(ad!-(m?97Ge7$=VUt7<Yo01*)mt#AOP0
ziZwWD#JnN3jBavds&*u6QSKzM0Cae#$(3o?sjR`3BNh&+W4cXBCR>3#T8ukIEC!*~
zWAbMT71X1_*&~(=X<&Ly!A!LRd9^rqnpifZiRm|mGK~uA)!+^i%ZIcuVF`?tosJaE
z<jxc;K%1EpIIA$7DjFO{V%3l~#+u-;s?(8AGrM!dYLNf71eevAPJJ3&N@5LA9D9Od
zWh+sumgvqG=YyPcCityFC2iH<bP^X1>0s&;f>yN>ZPkXk$B2uEbTN$yA*)eIw`y=p
ziA#r2MoeI`*cs?CjdhO`mk$Xt?Fn3#FoQm(!Eq(79CDV?6C7FU475!f?w%m72I|n6
z;L0*)&}|xATjJUwmzeGZC5x>>k82~`lf?BP8haA_Swa<kT!ZsV+&H9<=}ib`sa0sZ
zHqt#++&pA}=}!n{8C7(<2KSiQJY-O0n3>6D9jHyqaPy)BI@4_CvIPfi)8If8y+cfq
zR<k2pb)X%Z)m<rW1=wLTyRr=j-J!w7CT<^+5otFo+3ZZzu4TJtiaSA?I?euUVJ2<Y
z;Di%*4=IYQHwUxTnP{h$>z*U-9a0+EXbxo?GwDtZZaQ&45GT>h<gl~Q6B_59CmsMb
z+ivD^gjw_n4URnV(2&|l-R#IwXQ5r%DE9*KFff)*vn$7#MR#d%^@&G@)J1lil^nJj
zJ*ka$FA|S}0PZpSbA)R8qy}f8cx*^RWUo1xqgJEc+F17z@%WIY$bNGu$Ec>eHMk4K
z6TtYwEKDvt8>w26dzp9=G_%>l<qET@s==Wso*L2?X|*_V)!Ar|W^=C)PXpSqSzNis
zY`RB-%TYW7P|t2ra@jfPDQ&!am3R(hw$tLz73R>VG&m*2^Ful!>n*`tbq?CAO?0mj
zFAV95Y_x=OjX89$2Dhbn5rCU$Ve;6y=xMFgy-vIg%Dmme<q31?(;6I`;*}w1BXx@-
zPo0bQX_MU>#H&M^jmS=mE6<oq_i1o`ir0o*itM&1d29`OMw{Z^BwhzK-(&IT2{rT?
z4en9##*n_qUP~}ftwH;>Y3?oJ%^?Gk{gzOkQA77@aG;8}h75`dOJq2<7HJxCyT!o(
z0L+OTC)83+gNs#+2scGp6CIpdi-=}-%VIQ;EL)<BGioW(;Di<9!!x4ni3-QgL%KHI
z?Gr7)44jF6PMAk^4Q^U7IlL&UJ~7Ct^UwiphI^Zs8eSUJm>A-WdGvq=N3NI-z)?(O
z@>wT(R&%&_h*^Lc+7r2a!AYOh;OZ6g!fT`SL`S~rL<hB5?p<O50JP3TSH9t-2Q@f@
z#lrBqsP051pPi4M(`LK(h{ZrAdJ_Hl!hHIi26wSo65bHin;6Vj=c7Z~T=zb)EW9bI
zKQWYV%%_JmIF!Zm@Rq2sBxV$QJMwF_ZX#9y%rGZ$qlDY3UxUk8tO{?7vL-o3skfu&
zHK+TaSPk6HmgE{`+)kg@;FK0?0P@<Clu_&g^n!M~`+0Fb@DFE_f0VF*zM#QvEiMf2
zh^kKtj#3w(!`dD0m&C>4T~Uomp;5*HdRT*FTU-jfRZL<E*gMdRn&5s#Tn@;jJ&7w2
z?w~JfaD9s_!_P+PNsa>b4)l_Cr~5T=HQ>U|Bv*lP2YpF{b6i{-ekrOuNhx3#qL;P1
z+;52MfwJ@@`3r=F^koh1b8%yMUsP{Wus~gij%atg-xfEA4@C7Rg$j&?^oRxryVx8)
zC^~EyGny4phgRnfh!TJq^Du6-AkYpCE_l%!Zi==JbBtC6^omyReox#Al+rfLHQEs9
zD;k{i;`Z>2X!|f_G`k3OYWKK55O)I0aSrp378cP?4Q_mKcX&~B{jlI@brCwM-Ru5H
z+#6mR-8d{X+E_%7YH;+6`vEtL!<aGbo#<7~<^DuG0QjeU7&k_^lfJ5f3J?#4*GB8Z
z9Anfw(QDd$?$5--07pBAxyBfG($_SQ1>%wLy6Em<${2PrdR@EU{e^fGh*8fl{}^F0
zeO&{cARY^Ei0&O09HTBq$Fv9BUyH}Xo1*)Ng~k|*=`jt2gLopmB|0pb8Oz><y0ixO
zx8g~FOy*>6tZ*0Y(m+Xwr^4H!t;vqD>Rsp!t<n9xcp8|jE!j2JxQo7_fwU0M0Q0ve
zD`VLu=uPcG_mAQ^;8M<H|5#xOeNzLiA)XKKh^|i#j#ZbS<Jv>+U&IUHUD1unp|Qpi
zdRznXAzlR9E+#XD?A_=st;zkHco|Sudoouj+)dxoK#ho3!kf=V>&cEn^=|aG_OSa8
z@hY(3&SY1iaW{Qi19>7|3%?ZIovakHOVK;pBksS%>wv#{lKq9kQu>YtdPTeu-WT1Q
z94u6qq7&Mq?tjIb;RDhA$)Q4HDLtWqfDvzn4~hw6nIg6hQLV*&n=}}RnVIE^ggQz!
zP&87+P*aSRbrh*}D4>b%a48xPw2gHY8Fe(Efy9yGhi1gsS*3_whPpNEj+86_*_^Du
zNLWU@HPAd#^3bA~dNx?3E<-0Zk2_XM9a<XG$cBoHW%Q&5B1lRHw?Sl?acn($S5w>x
zQWkKzc9t6_)YEr0P(@PS(ApTCb&ON%(R*5}J4q@4^4-b0#u@eWJq=`%R5-LQrkhp9
zvCGl>+GFk%sTfdR59=Q%ET`{lpqr$Up$##;Y;c^q9G%i0cc)2ZLz`my+0Zy+IX$I;
zkdn%Ww#0;`FgErc6x7<>nNkJNKXVFa6Yilw4V0BsHMA|pn&Pmj_n;57c6W|c4Zz)&
z;<6d{&<`|_T2c*oK=u^H#;!mgYEQWHrTG91ohg2su!4T5f%cLX4(*7kPYK%873j3~
zq<f6CcxYElV@k+ote~eg5M$C(Fk8eFrkK4K{ZCWf<D})l7~500V&Pu;KMmBGv~uX#
z7(K;Ntlo=0(w=fpkX8fd?@VzO8~4(WG>~i3+M$<Xx>J;5b|v~)d)hroS`S#VC&gbZ
ztfU`npx>m8L;GTSQ-a0nN_0kh#ywTqJaizYKP6ObtfXf&5Oh-W&_S_b!<q4{3!T+8
zH!n#*GR?!e@q&w<)j;7%-l3*g>u|?-)rCIMba$n+73>AuaMyUlML*F%@=4o=X2jZu
zE92Q!s7HI&JyY5V@Y6ZmKVDcxdo<91((a)}vGv1)<JDE@oc5f14h$Za#x@QQjW<@&
za~g<3X+L;P;&5gHdms8#^SkFs2Y{Eh59cO8-s)2gRHAffXl<-M+%ZAD4}GS+;9ejd
z23MnVxNCxOAN@=N*(e<uS{K_rT$#YGMxSdhx)(`D0kQTB_fHU3)6X@~k<ziD4Y9q$
zgA>%%=)Cr_dx>;>Xj5$e@X!QfH9fC^u#`@KhZvU1Ol0pzhSuR;CY=N-Yfj}R3ine(
z1EndQ8rl|XO?6CE??+!~o$eLVX)sf4sji8}{qzeBq^EQSEJ1s!GLc<_zSLfIuaeFI
z$aSXrCkkumml|kM>HN@+*!tAqM0E|ipuO&1BV8EU72B8^nrN({7c>y3(nYY^#8jq)
zeE@x>b-C9`mxne7W7|`?65#>*l?HNEx-#@^te)y9Q6E5GYj3(YNLRtc=}dK%7!S~|
zHPElpwV{_{yHk}Cb}jlwd&|8^x(>X!C)Hmftfk**AZVo<L;GTTQ-dYyT69r+$Gt_m
zIdmYlKQ&Zhtfdz<P`J{qp@ZVWMlhvp1G=P9H%MGS%;phXsn9?#X&`x}hzL`hb%di-
zZ9v~@-ELWm2Jgr=!c}TC&~G)+z*2lfMx1?wQp&DFz1q8OpJV|l?Hu7R71q&S4Mee&
z98m=Q^I)mE4qevXcW;wYBTC~MM}$g^b@Z|ZDp^Vgt5F=mOkx|+cUsWBL&^e>-9Cbw
zBs9|RG?2|wUPNu2KEg3cZA9N|AG&u*1z=fqj&Myf8tL~M=xC`hqAsp`gffX;kA8rk
z<k%w>1N-h7;h!X|r$1;Qtfi8OhPd7l!Aa_RbVd8vy-zBOXo~9}5t?MIr&lyk+ERH$
zOI%nQGnsu5g|xG7B2@q`H>Yuvg$HR!1L-YQMYP3P(;So42hopOkNcoh4NjRY%>}<F
zNq^Kpi%T_N5!=(0$?OL7llH0md1*cnc4wM@vao^vq=7h>7DjZ$)u#m~s~gZ&?Q{1_
z(&C7&xW=^5WMc!ps)1UUmV(nNrZHvgL+EGCaK9og2Pog3#+3;V(VsPt@6yVMvvGQw
zqfC7W{i1#8eoa~p23=>GtIT+a{-S}Nm)1sHitA2O%GizQSM4kJ8`65<_&sU<GGQbA
zRRe)9ZH(xP>rD%msT<KX?Hl*o(&mVPxc;<InX!>x(?Ib{%@Kp*!$vYw*e2AcU2+HD
z{lLVVM{-kyCfcWc>pm%YBTVtuk&Y>96M`QdaK9&Q1z*rM(ly0sqQ7aE-KV7O5gGCJ
zk;)Wy6YAH#bAKT11h>FB(mzGmMEf;>1k&z^qWJoe!71t{bY1(w{gJdcqBOp7WN3=9
ziC))$8c6%WXck8@Q`v{n?^?+HiF5!AhW3%%RN-Ozy9O9RIuubGua9(0RUbxwXg|3>
zlMaI&**VfR)p(fxp#fKrjzrYOcaK!2vYXML+RyGUq@&<T^o;aR6*kj9H2@9Lv51EF
z-jTtn>SlC9`_=umbUdOdzJFwBs<D~g(5|^JN+%*(;=|IJY3w6tK<jgVE1d)z!<^1d
z6CR-h8lVX2R76|6HQg~yeFXib^}D~9PJ;_-OLt8(9-)6}z$T<KkQlJ1E7RC5=x^<J
z_m9#!a6X*r{%OJ%`nLwKLOLJO5nrDkoThF;H?=?AzepD%y5bwtL(_~c^ri;%Lb@2y
zOhNcF<?N&AA8o+>n{*k>lJ<12TzHiJqXEv4u0))T*V7&4>Z9mi?Qi!V(p4~DJJVg|
z#-sFK4fuw1E#gvqce+x}HlzQvf82jb*TG-uN%xlv&GbJFfQNJ=qA$KTJy@<bqg&d4
z?ti755d-o4>7jC?ncmWXfJnC@2ARS#7{s=qK?ITqcraKp<_r!AEp!k8B!VLtlgXOl
zKxzxRjexa?qrvmFWw?;hLT@9$NN_xpVX|i^h;^ed0^R|(fQ#eI@FT%Z!w5hVoXixN
z>NA2!b)&%q;2=(AN==O!A!NAeU;-2cr$f#_%wTv{L_-Luf1CxzPkRQ(3nCptK<?o@
zrq-lqICxb=;RMcmTmV*cXNHS6L>f-up2LMqovAxR;aLd{CGh=?i@_`E$?)@nM28Z1
zVB->|!PJ`(<W&hp5cq)NGN#GYpAq5>iAE53L2x<KVhYP->?}qMF^QSD0_-JoCTABg
zWeA`dT*b7RteFnGicusni#fO&9Bx~t%WhyANr2Vh8c2}XGZi~4qbQOn=HvO`NI5h8
zc0s051mF!`$aI+MGlO<jM$u%LI0i3fx=f9kA-f^dXaY0`FNK(en8{SI9uz}ZaU5O_
zCRTeUS0Q+43<11@S2AZ!dZwd7^`KZXT%3ScgR$P3>8db1G?oDG!E2dIrtVCog7u;}
zGD4h$*MslXlj*Mzyflsg0KyxYK2vXIutN2scrsF)iZ?R@rvA)Oh2f>~1c(rBW(FmM
zS()jqf=nbs<go-+nc2!s7ZhqDfQYb{F(p{7j_Im`5{Ol-#9P77w^?1&4TUBUU`BX5
zlaXMzD$`jXGLvj^Cf*6|n$zl^F8HXK07SyOnWBVxYjC>iLl%-N&cS<`(u789Xu9E}
z76McW?}wC$Xk{wdR+LCMaUMPZhFrUqs}x#kA_2^V4>7d~y46vswxT35N?d>sLyVx)
z>Z&waX%YeMgpV+F3EftulHH1ik<sEJd=xyq9;?4n*h+^H08#iD(~!_>4OXgKQ8F1T
zF2To{ri6ZLsM6R<lL?S1d;&5`VOh)!_A$hgB5@f$3AUd(i<==lMp*)=3ZG)y60BK{
z8R}ywh1kRu_%x&!Y+0@u#$z;v0K39xAW&q_Qf9E*&~P$dT!qhpQ|Qd{&k(lJ;RIk7
zKF@R{)Mo`}sM}B~nJBKo7ntU*gvPAU3}YKjC4jf^MM&9*SxgoCI2u7p#dY{HxQp#s
zT$S)R9YKJ1;VaD91U<`9r9O_*$YgN?z6z;{&Ma4z@i<K*0Ko7y=2Aj;mQuxTM<dA;
zaTC4{hGb8cze?CnM-m`n_y*IL(3=&kQn#aYGELlqZ!!Z3{aK+ZV>?YJfXMJIW{^27
zn{lvhD1#u;jR%8=Y0l;xLL1E>z|3$&q{(c}b~w~Flu7KOjH4l}Vas+oj5eA{0HWde
z$PBYRTXC>Ekd;gqeb^GonVs2whp>ZM2~ahh99d+p&kj1&9Vm;;5Vzsf$Wn7-cF1Au
zpjiYk8%~Fik(kZQWZO|Tafmx`7C5Et+1yN_on{l@Za6Qp)~shcW~%Kdhs+Xp;R48r
zbY{C|8tpWP0Eokdk#*+oY-J|96XlZG;vQTK=4wy2f2OdL<`N)txFoW{+?ySosqRF1
zWUjammqj+2`?Etcjh!@)0II{~kuB!19A*~#1mZ}oNN@%CvF03Zmhc4S2(UX`71?IC
z<~U}lPoR9_6c6HRh^E+bT(gWPXg&d$hif2UX3tS(vAfVHa=Z9Eo(~qTGsizm*hNPX
zpnG^>WQVyvCpb&pg$l?W;!AjOWS6-yCp630MGFYvKD-n%R$>lQ%|3}n6G40hF9+AR
zJ%_6no}{A*@ISmV@~m0Uaa5~MqA}!7@in{}5;2`Qu4>~+I)(rc#A_ojnY(k8YIZjo
zOYRci!0W*%?#c023%lu90)!B6jO;V_<^-$N-Kdb<ExwI6M-G_#b3)a|ZdynH8RF*1
zL6)#wW;Uy$B2p&?ums++IhUI)sI-UxL&V-llf|0rn60X49H|%I!&@PUW6O2THdH!}
z093@=BQq@aTxB-92ieFy;s<yq*wM~h|7>9owGp6<cz0xxr9L+}Tit_-$-Ux7cyDB>
zr7<@&+t@>k31COOA0lRAE;EOH3XLZ&@e_Oi9PIX7ZjSI29Z!Hm;zN<O7CqN7M|}!S
zAoq!%;lq&s>CAP_F`l9m2!Kg^B(l!ZovX}Y_o9j9e(?)@6in})T>l(lFP%t$RN`Zi
z4VK>A;2d=?Dj^SuU*qGEO_u)L&>UkgEg^s|@rlS5OIRK=mwg(Qk_Pcxd=h+ea~?NW
zc$$_HV43(-WShmB=a{QLjV6&s@q2t4Vn?<-*IeUiI*9<>#AhIHXwOsTvis0v@}T%5
zJ_pviGtWO)*heQ5pq==9WOIk5J})>|-G|D^L*g&^LS&bvF)uXN*hk9<;7@!JB6eaP
zQ^P)krjRD_H+&iF`1U-mMtFu!A;3fNmB_OeJ<n02K7*!`hs8heRfs!v=DBK&XXsP{
zfD~VgykzNyjsd$LO(Tzpf8p!k;P>SDYlQuD8UbR8Z$$Q4dh>!c>V8yC9u@z^HzNlu
z{du7pV?Qk?fKc(R$U%u=98=3`2$2@?HhD0Z{$`G=6*P(nFjYAs%9Lp39JQ*3cp{47
zax|o@Y@Dms&?rv;vdZyM8HsjIsbvYW6D&r`7RU)WIe)D{sGR_Hm6M~266?8Otx8Y@
z@rbc<YE)@rBNwVQ2(2K1VdZp47>XP-kJZt1qKFA{7DNl$Ic}by)9D1bteh8Bo2YY+
zd8&>oNvoJ77eKhHlXJ~8bXrNaipg?eR9#{>r_5sypc&*bF-0zhG(r#OpC=rkGsreE
zRW6BYNbKc;^V9>Viaai+$z@SZiTzw?o^gOyk?mr-Tprbu7?#gC*=Lc1w27H=1q2w(
z`J7XDmO97|F-xwBYD=`{JDlpXXeMbFbL48sl-crKPUBfRlk61p<QmAI+Vd4Bdl1bc
zPl);Qe8@aF^ZicYAe}{k{>lrZIuh&igHH7zswPj0W8}qAU5SnPA*XSWRujO%@=^#`
ziuufZ_Bk}0sNy(zIm9H|^SSxLb96QVJ}j?{I-98HJLap;p*iF!ae}-WqHLY{uKC7u
zbPfSvEU%5al-QlG%x4dwx#VealDr<06+QX>`NAPOmjFSQH%9d(_T~rYtA|hxc}AQn
zZ;l#B?9UI)HxAJn0!UeIjvAB{Hj25O^`ly%iM%X97{fe@yIt_pS^|t&_C}eKtfL&a
zt9~?(=whY36%ur|QLft!Kb=PaI?LOmGLr10l-t?ok&`?t&XjjTe#1G+f4lHJb&`W(
zwY)p3D5-u_@OJfiG@m>t&XM;<l_oWg3f*ozPv?_EVvW2X@}=S^W&!&Gx}EsNdGY~>
ze6)|^76>oU+sX6deECpRZIV99u|RzREg&z53*^HP-0K|WT420D7Z3o~@{y>zr0!A5
z0`@SvgS;p%l8-`4q-T_WfpD1KL4ah-$D$gNdPfBpsE5%)^0K%@J|5MS)ITb;z&K17
z5<uJX3CKW)6)<<OFCu|-h|A=Y5G*klaCZnVQh@;LmQO{sC0Pp`cc?F-MWj<)A)ki4
zpsm1lhw&m^L;!xvXCRJjFHr7aUqW}1SH)HGxu|A;lC!{nhwu`;lK>8v&qsA6)fWWs
zP+vle$?M`8`9f4zQe#2r4&x=dm;fJ_FG9XnEMOM0FQdCim$**84EdGz0&b!3GQEoc
zFqf}HolVjU91GQ#(Gv2exIw-OImONb*FxiEx`Y5hm#;-#O6o397P3ds-Q+EClYAW_
zFFghRg~AbfHvyzB--zl<>MaN^RF9yg<Q;K~d^2hwslOn!&^SVu5@77|t*Al6!bUR!
z+kxr`72Wb+NXeK-bAr%8>j*%1IU?FL%sSd3s2yk-=@w-<8sd?*(JsO0pvwqQcsV{g
zW0-xkBCxNZdh)L5lPwUeagO#2!Yj0%0G5}Nql<>sj}8jzD`+`+U)(0AMwbq2932vj
zSLkvAoL)|cc(FK|S;Tgtdq_~+A!k7rr+qZHNa&>Z5CHdbUUcm+eY9hd+KE<>55-+_
z0i-fJN4pjoopc2Ok}nrV*A43)tt?`XqI=2z#65B`#CLi|`xgmE>AeKdzFZRBFsyfU
zaFKcxtt20d`{c6dreXb~LyL@~bR_}SFPBHR3=12>+{wO*T;!}s<O)dqn8$E;3a?TZ
z0r)RhMYj#Jj&a<nzKT|n9`T@D4Pj8*7}uS~t8^6sH$bj|c)ERzawq#5x{rJ+J}=LQ
zkdSkX|4!jGdLIFMKwcQ#F|2+}@J{tLw3>V_z9cV>?i$uOCUmFq8eL7mFOZi)x>_8=
zEM{Lv_Y*^WMP3fMqV_S|V&QdqKLG<lUKxFMm_Ej_SbZI>AzzBG$*UoQ+BwFx*m#|;
zA>b&;Yojj>>mH*lW{;r<$XDVU@_L9O^^EZ^7LL&e2v`jA#^}Cby<>ul)njNa`9^$O
z-W)wJtba^sv2l#9CEz*8&C!FB!^Sdqv0bQvToMC-z?fw7Sne*Ni#8B2A!Ki~DcL&K
zahKYK){$QEJ$WlcUu|PucNtxD9RXKD-X5KiY#*!K#lC?W$#>!h@=gdmImi0%65gPV
z1Z)a<cXUy5{n+4L>KkZ1`9b_h-Wy$-+&DILm+=N&Pr$d3_d~c`9Lp?W-$W0Rkobvw
z05VeTW4R^5oAf~fMuvPSx;9xK>sX?`i8hd*#Lwizkhtv}>sn&GNjDI1HsmAGb;;dh
zl_l(P^bq-3{6anov8tZ2{w2b3`VaxDLp~PWklZ^qxI{gUHj-b(ujS*>P09UZLraX~
zbRz-pLp~ARk{njZ+|9m)nn<7ct$Y%aSmr|RZs9H3M8FJ@Per#STMHd`t8bxAq+k4A
zJ`F)%TcPW2<1M<0fIA|eiEh@C?S;zS?Az#J^1Jw>d=A1}&O-m)!rSy=0(OafKDr~h
zzA$*V`Zn53{uF<aFGP1GHx`EOHr}S23HT@SMF`i6h0Id+9rOqp5Py>|L*A>skXtIe
zLmwevsK{5M&nD}Ij-~25XbbsU{6oG90prd>*HYshx`lwlB43NXl-ymYEM-riN6A0p
zU-ET`i1ifumkKB7qXaA$`9^eKa&KX9sd@r6lmEnj<(tt1$^C_)rN#-`Ou&PYZ$%Gc
z!-|+XmZBCiNV?547*b{CBCbxLw1wOz4faIDm{@C(qfVvBO~RybPc-D3ZAGp+gHksc
zEJb+YV=`EKky6J7kVu9|ksb>K(VRv8Iw3$s5-vr1l4FY4`l4W+8bA^mD#dzIV@lb^
zqEMX?pc09Y;yvlmEf9;CWo$RXgpm?FS&&_8FXEO7-4v5Z$>Pb2sb%#d$1=4W$s|fj
z@)SUvy0gf&%;=^viI$Q*g)wz(cagG;J&8OdMoRG%L)@*W$iGZDNj)T1O7)b)G_buz
z!DZ@6<Rx)Znx`zLiR~{6Ei+D1FNv4ZJ>@YiY}h!ao_!Z7#3W^UDj*?e9>>)S?^1;%
zNLik$m^Rir&QY(vi+sc^<#?)NRMs}mRd2jYeZ(T=d1_)b);><DXWv7uBvH!u%#ZQ2
z&T;;F;XT?)lB5F9!k7-Weq69#eGhFV!=y2u#W7uM<G4`0@gChulBGh=(ijTlgIUhL
zj~*keG|sa;Cdjsr<CY8W)5l1PRP0$9bC%V|IhL#MqitlkG{Lhv#$Y?gxt1I6(`_VG
zD)Fq1xx{vlQ<k%*(Bou;G|96*CdBrP^Dh@p(Z@-eROZ<j)5rFX3ochrq3vX(G}W^?
zW`OM<7g}zdqT5NjRPJex8I%%cWA0&tsEuSuyhnnxpV`LUBLrz1$&@NQ-WXGg)#kWI
z4Wb>yDph*6LT24&bKPSE=?(&}m1lcQMvC30+{1o=+DW!F)3Xx-f=-+N9^nJpPQb?U
z?2ai)ska61Q9nRCNv<@<vp1$RrO_6;$M}HmB;ad#_CvEov@t8#5785ZljeC2K&G(W
z#;p)Oq)!kqx;%$sYEyKZV}<%5+C@f53p|G*D&J{ytuQ{My9hX6o+B}JDcv?@1$!Dj
zNk&VHJVzmh*kkjr5Khx430PsCV=)aWy|&;A^)%W|#!5>($77mO`fZ^V#%a2nfH&qj
z0UfKbV&-1<e@G=o(lXCUNG_U-xqF5GQI&vM<~bG9mSQb-+^hZ%?IAX4h39lkvzlTn
zcHL|IkM1F0pLxzeo5^0R+{=E1o+9I=Ri1N@c61i|?-f3xPZ99bJm+INQtFF?_o^SE
zy=0=a#&aR2E2XhGbg%Id-Alk=^IU{xjabaAWIskvlTvA&=Q0E&+l#rC!pHP!0*;&K
zO3c|5z1Xo*{TS^dlcf!wtI!PSEOxClKBoH!Sa6<eF_%)hi<On^8T1U9B5m?qhfHNp
zv45p-hCV~Ulk?n&=}YM?4z5(sp#5Z;w8e8XW+0`%IJD9@L-!Lf={&b$1`Q7z&$!sL
zNFzvcdj>-c(>$JY31_KBcuDd^#F~a%$2(l=Swx6kl0DH-NU)7}xs0=vkP6A`iI2?~
zZXd6>*iVp7rb|AL1(KW2@qU-^3DrrZwAGUwTQt0We9)zSf)0=w(l$?OZ0YdE@gbM-
z2|Ylnr0t$`C>Dw1nN@5LdX_k(9iA)*d$y0~RtY`ySu#`F>B)<&9j=detWtZ>K{89)
z<tcz3MCW+dDx-%UB-PSxPho7`@b2--D)t<Dj?9+!c#0t(+B4q2N;pTKBXgv^o|4#x
z;l1O7tJHJo5Sc6O^OVIl4euWxT4kK0he(aI-%}pjGCXVob07OD@{?MLcq$-LYM#K|
zCwxl%WS(@uQx)4b+&aN=pZY0!o;an0o@%IH*e1B{Gd`uylljsiPYsmY>=Tsx*w4@l
z<aX(K&wNOsIw$z=6F#FakOk6V&%)S_;q?=O_o<(u!{iR>CC}p6uHlUnLiZV;(Zgh+
zbi}h1dR5{CW;OdcdXWgyE1u;LTy3Agtrk9~FOo&lQP0ZQv%~cXj@9bt=p}Ne^qOZi
zv_3i~xK<mV)0fC%>6mA2?4{w|6O`5LdGs>5OM1hz9<r`I6a1@%^Ymr1L^|%-7~40z
zcS3NrdLA7icS~=3HpdPO@1GD_ZJeh^$WrNqr#W^|YS={Pe%3%8q)rNWB#6hFCvx`-
z2JIlrq>~<RtSQwx(Q&_OpjSw}^qyxcluc|CUH2OXeT6KSPI<P+W~ACDD)+NrpiXj+
z^nqt5Bx;=#{r3xB&`z>KI_=pVTa;QqF?hfF1v*OZl|J(9jV(=WoEW;__<|lKE2T4@
z{ZK0tCo*f;FVU;SC4J&K03qD=iQF3DOZqBVC7tseimgr6Cpy-sU!vE@ebQ&1!_aZ*
zoakC(d`Vv;tEKavBe8X<-4m5H>;?2XxnKIia};vBJrn(FgbVa_vPQb#ITqWH+B-40
zM!kTJkq4x&J;!64Qu`-{))*J)F|t;==s6MFk{VXRJiva1x=4fct>+{}ea$7@1HxCd
zi>#9_drrkRx20N391o~pp*KjQ^u6aabZcxSt_O^-=o@6cbj5Q9%8vFD<pK6<^d@;w
z`q6U^;=#@m{{zC;^i8rsy6QO}+mTvd5_~}Y8XYGONxyh5#CD}NmV_QKzNW{?M(LX8
zBGl@{5@s#?4SI_-Nxyk6L!!97gj*|oL*F8sr0bq5v1e2D631Hg8}v4LSo*_r6)HWQ
zC9bu`H}q|?S-Ro57JDhRyF^*bUPSMZN2I?z*CB-5Q{rDMT%_-iEz(WTjo7}_-jd*2
z^&&b!9+m#}+>9Ma?Jo(fH7?Q<q*=P<xfMHTL|7@)z+OU>v`Dvk2SaYzT*@^FmnbD}
zX|OjU&NRYW>S$0ep#Xs#kvAHeM7B~_gK>!l2-tew__&M__EM#R{T6i-pln_XM4g?b
z{s!S&+D+i-^(My^ji@gTHmKjClLX#_-qg6#5sjsx2IE_Ll7JEHO@~&YSjwzpd(pc@
zkrKRFkdAII<<<$k^j!kZus1KRc7$H)Sf}=)_eiUh<Sl>#Q)j7bozY9*BVZMK3*+iW
zbeAgY*vsgB@|cw3ErvjKPpN;MaGAbOz&rMq#5IiQEe)<yFQZfBaVgDP7S}YQzcjSY
zxJ*wGFq6IIaV;alCNYidcPL2Oq)cxGWU$SXxJKbS8YJK@d#mEwMp!2~8rAR62c%uf
z@m51`$~MW>XnaRMAYeCpYoPmTpQJRh-=h!76H>l+KE$@2ll+as_w+*o{<C*sT*rv|
zNx??-dvuySDUI<ij_VrHI4RU<d{0jkFr>Xpp;ReOV%D=ip#Kq78s}XON$>Va+<M^$
z`ac2=wRdIQ*%A6A$9nY#^bvVVn&4dxb*;`xuJy(b^dkb6wRdgYr4ikel=bWt^f7r_
zn&e#%;qabG{`JBY`Y{0y+q*HYZ$$5;;Cl56Izyh3rg}HW4UFiY6k2awp=St~+TP~4
zL1|%=nFrYrI!iQ(_ezi_H&5ms6hibYAyS3c8)r(hPIf$~hR`QOmnywmp(SRU?0V1$
z(N752-rntT8EN*(%7g5WsE0f&&Ghbs2)c8!|3TqL+C#tx_wJ4>N~@n7d{F%nog>dl
zbG&=wO4AxAhaNP3q~{12<KF$yDHSI(8`z)Fr^GMK^B#cIdi!K<gYXmmlz>z2Jrq})
zrcZWkP=7+7kr$)|-osE%>zwS`VEjZsBVe6-kHpobbx&3{uvgLN<V9(b_b3G2dnWrg
z2v_On1iW<bvABk`-pRoY>Q!`}yeuv89*=8E>z^FjU|gl=37G5N6VTxfD`OsFe?|uB
zkd}E*#x*Nx<}&Uf;b&?Pu-m<-;@Z-zWsZl`pV1ejQ(ECY4W&3+nd>3rXZi&J|J{2A
zy3qDA<stSL^d)&!TID?ld3tA={~_TQ`XvEF-g`c-BdxwH_>lSwx<Fo+)_5<(b)_|y
zg&s0~p%(}^^xlimsTIqZjqI=JE7B#c^InDsetQ|WQTUa9MZmK6UWq%Krk6Q3s=uPI
z$(zy!?^WpHb(Xm{8o$!733&M4YjKy-y33S}>^1Zac}v>ly$-4Uo-+SN;TrvhfT{1j
z5!aX2TNd1?UPBkjJJJ^K&A5TI{<6?U;~Kq4z~%SeiW@XCYzouF_MuCJN^b992>P3+
zz+QVFy+i_%<c)|ojkHd2G^u^)Thc9o=7kENZHlYO=%e3~lakjPAD=POK1FF_e?z_G
zUCHOQKsUfS#or|SMtjM7(pGPBe9_4IDZwW7H*}f2FKzRt#+Qz4oDym>exsMkDQUYm
z9V*4*6lN3KkG>;8X@@rp>ICgmxJ^Po{f>Mf?eylw*N)VuI5w&M=zH>^w98un&BM+q
zu1!Wi{hpkLalXR%x{=*eluhh)^aJ^yw8vWv4TPR4{!PMl`UCk$+UqTeZy4D-CAdkw
zj;@f8rG4JA_@<HlQ$m}J>+}jaBklK=$G40Oo60=Q{*FTAtVFyOP+Blg<sKG(ry=r*
zbii8`-!{@Z)$y?UJNl9INC&;uP<XUWbv<nSPJbllq(j~ssK(o;Di5=Npr6R6((~T=
z&~tE3^*=29L4P8jNr$})<2y#yPYph-{(-KN&!v~Vi{raSHckyaZ2Up5lJn9L?^0+~
zi&L4+?4RgoVo0xemqRt8eJZzE_>=xjzL1W3SH_<msZVumR{uo5kT0dzysM#S**Vp<
z+4z(GLM}+hyldkxjqIMPY-VquU&&X}8{YNMrs$dK-z?mqzml(|<KB(&eIt9P1~;oW
z&^7Xn^tN|%{J_ZmsiDor4SJ1Slume?;|HaOO=BKm2T&imBn9AM&!n5DagPWCw2yo%
zorIU)ly05octjmQzmZ<)J?~biciN`89x(>!Z{)Ic%DX*2Bi%ktd4&B7^^@<U54<~}
zv*DcPe?<6;_LJ|W)85_jMd|g^f{&<wq3h%a=_Bvn_|o*oX`x4qzvy*xMLOf%4~24Z
z8ncD{8~si~(kI>nQ1fV?#%&S)roWRPrE}gx@wMstG{+Y8Z}bQGN&3ut7+R&B(_CAO
zzv&<3s&w9aB)%@adz!L^y@~!LKTBVDk3ut~XPSSDaFhN?evvMCkHt5n_f89LQE#Ff
z<X7oy@A3Gi^!{m~EyhiHgItp?dQZeRx1@)aGmo<WpaIe+ed|35WfF5a_o(m>9U#9+
zm%XRr+tRJ&jz`sh&|joq`rdmQ%B;3>*Q3Ti^e=K<y5c<pQwjER<x%!u^f&ok`q6t1
z`X|nE|D(dc^l$Qqbk%!4z9YT9Jou>kFS<$olz#DEi0?{oEDt?u{7Y|=8`3rJMd;Iu
z<xDgCANq$3NWXb6LuIACoNE^TqyLb<r0d=*@n_TZa!0fJANrU4E&buW3LV<ca#yqQ
zAN`lylx}#h#a~MAE?1h_Tj)RXkMx)KI<#DR%Kgp4E&3n%SGwuF5#N{ITOMpyZ=qY{
zKj~lZ&G>=z{_;?>af{v}x1?L%Tk(T3!VuHK4&n#tgD`ZHp%`OET#GO$Fi5`*LsiIR
z%CI6wi#mvhy#)-(U8wHbkgLTQ6oA123_%)GMur_JE$nSP6z(zjTF|9&B7ci;TL2p8
z7%-EmD5D+)Th!Zls9a;X`b?!6jVRP&+!lb&F^1Ow<^)8<xY;lsI=2`a98kY$N1R&-
z3qa`<Lt@`lo1r6zTMgr(b%`OO4UOSW<Z>Hf0jM2fh~%2;GP;rCW(V_7yTg#dgvL$}
z^1Fq>0qC7!$lRG4GI~+atq$g)c!eQkWopXkM<KT{H~`Hf451oROGX&ai0lv^nl~6y
z6j1Up^PDIQ2|)D(gKKVT%dqkeQ60iV_X2}W3Poib?-Gq60Vp3}u*G0G!_F%r8_q-c
z9)k}8y&xy=7lrTuq|Y&MZ&OD`Js%X+a312<7(l0~E2EJQiAHz;;>Q@k7OW|VJR`9~
zdC1>lAQ@04YUepg7#e^8DhB0hI-8;M4oMx#Ljn_nRDphUC-0Jsp#exBVmM7rmomC}
zMPeg(h~QzkMWB7u!}}#6A^;gQ4BtJbzKmWzD5()Vgs?C?Y)k_g{d`C=A_5RX!tmxY
z4ay9&Gni#~Na0}kYfxA++c_*S0f?dC3dL(OWm@eHtTH_0FmR=^6>8Zwy9*mk0CEVp
zO4)A8$h6xP%trEH#N(ODPUtu}?S3po2Ed8N)yi&DQD(h8h}B3QtXMop*=s7zY_x~4
z5g7n064xmEVN61_Gcp^+gBOSADF>hy)o$lxAu0f76rQgfGSz14c89D+@!-bb1<GM)
zgLm3pvJn*kHv%tIj+p8)yX}h1M)QE<@gn6YG^u**ep!eP0FTCtm1Cxc%wBs?R-<_U
zvUrJd+|=BZ*>4ZYMsxs(BwnhVfRUK63dY06@POp-GUX(+ugn#kM~DdklfuiDQ>L~|
zYlXw3#_#}T@CxNLw9su8E{_ot04RZ1DraCx#a^L!*jOG^IbNllgTj`x!tW7c10YNB
zYURACBeT9D=uu;N&}Ddya>3M<*;o<s7_kA+C3vlJ5ymvc3dYOE@o<>qb;@Pvc(qq>
zULh_3mnmMaTrr)^)GHibHI9eV3~x}bLixS3!sRvM0&tq(jmkCCrOa-41=)BWzMJtT
z<vP^DdMf;0AwB?KPI$9&!_=4ATM_iC@jN`8@fPK#X&|$|BIGsV1Mqah&B`s)AZyrk
zMqy1nd_1vR84OJ_^K?!TOaXX*Vo8ZeFj=kB9g1q=;RV975)GYu+jN&=m;&$*#9k#n
zA;W5)t|)8*Z`G$`pJGYitj_6vMMwx(^-8=|NlqxT)=v*AY6737&%oQ1)Pz!N<MfbX
zBm}bbD!g4uhb<9tI^$!_e75euJCrQwtF=$(e1bWUt<S_emAr&n`0EazYUXqFS$LOH
z09F6a=`NpP4&><7c(+oRP-pF)uJ~9BpR3Qtdz50Rxb;l;`vllV)#u>7N=ZV4wRd{Z
zr&{<teJ<XolqED-`=^I|h9!`v*Wmq1c|wadtdePE6M0Ur#YCxqR-Cz#YZVd$oIVd9
zP^uEztkz0LtD4B?>rQ-7sfL9CTcxYjNDSob^YJ0228MO)l}ao8sLCk)cKp0DABuF&
zN`I@66d0v1z=xHE2_4q@%3!OS#24sy;Fpxe30>C4%22D36e!Ra;v>pZm{JidnXT+F
zezY#&SCr+@y=$-JwhF@nqxD7jsIoHQEd1v>wyMMUG5VeOHDxsn8+2B>wi?3%WAw%N
zn6ftElC>K?&}=e4R=*3sp{$3xUQeZetB@QRt1rRFm5m8~*51nCRyCO~)bGY`E1MGr
zto@attwwU7P+y8qD9s6jvchICkFhLYq}Sm9s7ofxJcD~oU;{<^GJI0;CYZ9UGaQep
zEI&@K$L}dyVNby}!}XZK2FB^j@hN3{LPnN-hVmGj!rSzF@CV9HC<Qua_#YEe0ycdG
zKCSFdD9Wmz5qwNd;fwWq@kh$ugwm|W8KK9Flt8h*5}#4_!;*|RgW1Lo=f~?V{E2b^
zdW7vWxNXAlz<7NXKBpW?sD<~IW1BjhpP=7|KT{6Fj6>%P*EVB#V1m9HpI43~)Ma(g
zP`0tD{6zhJ{DpE9s)s!@{M&@oz(jowzMvdSXl}^roe|uort&5F1Ndv@ctTTF|BTQ!
zBQ;Q>uf-RY6A3L@VO7lI><GS8Z@}LwC*jM^T*W;uj0lwK>+ogeR6<*pwaW3hI)b01
zH{$P=(=Z=lt8zVVj0jB9*W)Y785ml!S1FIPY5ZjULHwg~4jPWmD*xj`T41ui0bf<l
zCv;@hR|Owe)A%y|A^eMSA)za)u`2YqkrpV^H{xr`MOe}itC;QVNPddmgnv^mLn*So
zirX%X3{25C;p@tkgtPG3a%@*e@>BJP@gK@nSgq)+a&0$82Bzwp@eSo#!lkTkc)+vi
z{51U${FibadXzm?{_R3~V4A)K-&AfS^kwx{1-Gl|e7XK8{#Ut~Fp$+>720m32g>zk
zd`r2NFep3B!L+d%Jkne6ZN9-!y)-+xHX$Q`bT=OCi!htAtqw<<n!)qBh{Ju+FqUC+
zxY~@20Iy3p!WVDO$hJF_Ha3&D>ljD+EYQ|;I{a-yX27n?INFzNF3PTV1l!b1zC!ol
zSYN8SG`rCeYBMqe6}lJ4`_f@ZNOUkeSSvqWS8#$a3ksg?4sM5F4NTX4*y77G*TSR4
zu|u`;m3k{q@)f{FN2kNJ!>|S_^{qJBS7@%w?sh0U*ergA{uoa26+<Vq$Kl^0WCdpE
z+i<F{#N3eG>j>^pv-m3gah&EWGdE@TJ3>2*tU#5%9jE)s%`MqsGnsZan|J7KIMY`F
zHB$3Tu3g9uIP@Jj%U5M?%eKyRw5!?tOuZfF_^M$V#5U8_Ze#~$>N|0suLgFv>@$^i
zHiw_3KY{ao^Pzd_oat{DasspTUAVxv(A<$-KQq{_=J3_}lX#48vAHX|ab~F9$O%;I
zyK$j!DeNeTGnt)iE<amW@i^adD66*5<aP?Vf!X>VT<lwEJ_}D)$4)hupQAs8C-_#w
zB1z{=*G?lhFh}2uOMGk1m$JLz`<~6?=ju=6Nxt>aZ|#}s-znq;=IZ-!nQx=HFS~bU
zaHpEb*XYmSslLtTf$aX7p`Auvphn-1%YDt}K{;Wwm?v0{uhlio`y{BunrCrO2wb36
zC%D4rHJfs*vm8&T96wLjaiwo7458R&xt=h%z&!l`uJUa+XXMytDNnHZyi<P`&-Cqt
z7OiuZ{|O;K;M5P|YTs^iQBM7=;1g;-KVN?i&++Xwm*zCi3O!-u2j=UCaE)(2%t(o|
zm|g5B{&wAu=lKpm@wR;yw@VlmxLto9&-WcN*TNTzW0yLLU!cE$7x)gt{z~U8*DhmJ
zV1a%ZFZ3NT*X4B2Qg*Qg{2ls>c#-d@x!IM|Gt0kAC<xr4zl0b2j+q;BdS?Z9sRjH(
z{bjtwcih~R(?2V;%P0se)Q{k$z7yt_oUm%<Np>_Z=pA^O?<Dkl&DGqK!svjYzk-+h
zPMO<stksSu)zSPSy%VqSorc{PTea&+V{~AVeiX0toq-)Td$sZ;JBGhge-*Ftor6lS
zv)ccpFeY%P{u*BGJ8$mDsjm(`sgB_n>#yTAz6<8AoW|<Vlg609V*MCi>$?auT4FV`
zn;pyFrFY?VzRS=eZm;Hc3u6O!>2KimzANUl@Wtxbt&ZiF=x^c;zN;`d(^>7>ZHx^p
z(U0SezH8=7Io)vov4#BI`dfID?>ZEZd#e4rg~Gty`rCN3?}oV#exxb5TP@_5>hIt!
zzMJNOoc`+2Zlf@;R6l{6eYebma>HgbDqF<Y=@h$tgQ2Tzp3SL3QJ_u_V96I@G38ok
zJ5;rZU#53s*%u8fH@4X>)hG%q(@$crFW!=oYoD#C>^Qz&e;50F7N|EnXZuxQT%cZm
z4{!A)TZ(e)X9rbv9KT$DA8+%eT1s;pXNOc{Twu9=3UBwN!-|+Vo7uzK_<Qsq-r>uF
zMs)jZZjWFK+@pVhclz=ywQyHB_NX>~h5jMl<tu=3ozB^=J%%l?LO+dn`wA^}x!tps
zJ!~<5ul_&0$5#v`>YmyDJwkEdUi~Ay*H>a`$nBjS+@lurEA@}@K3|!oDYt)iXpd1G
zSgD`E`+en>mfWy8%v0=m-ld<##8&~mYx5lLDPerTrGJ7C_^K>zxz;(3r_}NMD!m6E
z^i{*Ak8O_YDPw$Km3|H%^3}jBpM8$<6gz>xPyZA@@0$-*ZRZ^SQ^JJ6efnqkuy3KI
zBe#A|@F{fyzgqtszvNqN>B?=K6MD*+5Lm6B$47iiVMI-w!|Y`z^7rcoe#N&O+THDQ
zxV^%}!2S9c_^5BC<t&_4j=kzcevSSme$BTUri41@xb_+o18ejP_?U04<x*}p$N{#5
ze?b2Vzu{XCh47v^{=Gs;-~s(>eB8Iu(wEyiC%9KF;n(Wl;J1C7Ed#mzb3%KKlE7O1
zB0k}3whYP(o69`SmhuhyB^&^p&E%Qqa!(7Tfd>6sd=iM4DbG6B@w8gXuhV<+d%mr(
zU}T%?dfF%rtkW;!Q@-t%j6C~X<!N>j->83wKk)5@+PQPC|7l@Tpi%!GpZ4vx6y?>=
z4L+?-;@9gx;E#NJEv0#lb3;!XlLG7YEBK6WKWxZ}bD4eYWd1=tgg@~efTnu;TyCE*
zIq;zVBR=OlWT}O#(y>pS%x}<t!k_sL!*EjPT-QEha$tjg6`%JVu{77^b<b7yv1R;2
z`p@_a-%%*H_ssS06UqV)>A&C$zGIe#yxzINeQFuMQU4Wx?K^I1%IlvS+GmsnHtN^#
zMc)ZaOI}zF^9(zMZ_@klx4x60uFW;vGs2WWll~jN>^o&?%d^%vo>8apoAiGCz3(&(
zHrZ-i&lpnzoAm4With}}G}>#FXV|Iy!}{;|N8dT9&^v4V&j?ck59@#6tG@G=j=cJs
z;4|t}ezX23{>68}(v{a(6MDv&8rZDgz}I{iVM9->VfM4r_(${s{G0DGwC>w$xc$Pk
zz$5x!_`2_k<t$v)j{WL1evAG${=;__cA`3KT>Fh_fi3z?e8YFmaw)GH<RM$mKdS$O
z|MFdjqJB?}f4@*3cvSxv-}K$E^yT%|1ox}ue6#)^{?~WYGLY9_6WVW-2b%R;_?GXM
zWe^uu%V;d(Tl7KlZLNc$+i$MrGyw%#^xNdYtr3YP&RXlxRK&aWFgd(68s@2NwJyy-
z0k=L_j%bZf%;4;`ipKK1s1K1NTP-jL;H>p)0v{0da5=g)IkAYVuMKJ{&rAAHIkq)5
zv6O494QU1+kn{*SzBL^t1jSm0uy!8njGWM#1q%Z0wHy)b0jx*Lme#z)S`ZZuqS|>`
zkCKyG3t$ziv(`lndqCEs<>c1F#5%6KRv~N!@6luAl-6Px9q6g`6QLsD(PQP*){?{q
zuD3Qw)C%6K$H{4}Wr<B(e{F~u6#=gvFQ>PbC$?~5^BA3-&MUe}&TOqnR5<fIP8X&J
z6g@%CYOP9a<E-->x;mZr>1H{nwHn5_Z1Y^YF+JeZEplFK4Xk$B=P5c{$+zl>a(?T4
zm^N_E^Xo!opjA(j3tAT@c5wCcg1TDCZ`Fs%V_Fv{c5#jKLb_2I*s3SXg{@0rK~bE?
z9AIbgkLj#Du5~%AA+*oq4hS;>kLf9LaqG&&v!JOQ2h<t-Hhs7}p>=hl!FA4a9WZ7D
zw&|&IN$c9gOI$b50=9~OTpuA%YF(cg;(F%!4+vF($MrP1taW2zAJ;oCctEY<x9cP2
zsjZt62e|%up#w%$V7s0!m$x=24$2R6GS9LOzD>`N`Bn)w7tBuXS-}x#(=+9YR&Syy
z-|BQct2+1{x>c@h-3rrVHmB=Z!x7k_XUSEq+Y>YL?M~%cb|&AhXUj8Ncfw4A)9HU!
zm>Fo-bL8sQ-HAo{_0Hh4>P&v8o-5C3-J4jN-{=fIYs?Jn)br$;*8MObDLR>h>@5BX
zos;La9)M+sb|-gGm=$<J&zI-79!jhQN$EJK&f<6JqvQpx@bim8ey7uQ(3ln2r5DHx
zTaP5x<##)kgKRbbq&`|+)Or-wAbOnsga2pf+~aGk{{TKyIi-Hq*!G;=cedp)GD9Yb
z?-_PbSsV5o!{!V-%w;xguAA{(&iyi%=cJ<N`z=S3nPigq9?6kpCV5VhndC?^lT4D|
z=b!%T<+bgc=kob}-tRX%iEfbxaz&PdeJc93=LbHNCZVnJ%iK)M;XXC}I`cyxDwF6|
zc@S4@IohYLUwDD)Bjybx$(h`2%W)7$L>6d2V&9;WJeVuBob2Q3rzy~XB)x&Wauzq&
zavDr)Sp}w#lsBkX9>SGb&Vt2NS0H}GyouhChjQ~R=fOFVU*P+QeUrW;597)$7yC5!
zGZq9slHNqy<X5;wmP>t_`&AZ%K2qMK+vMTg63Z13Xx0~~b~10FcjatuspT4IDm(?+
zo$OomU3mmoWx3I(1zxH3JEgbKd-AK?a?33cyfqb=b}Dbt_vDdWwdGEqwtjw?9x;>A
z`|@ktO3OVkTeKGVcCwS{`|>DmwdFydj(+V0ft}K1v|WCkTWfjLr>kFQL1?EknQoUy
zbG4QyeZu;OPf_`pJhVd|!>zY;2N_1>6s?cVqdR28ZLsu+is-MIqW4L8=mS~Dah9Io
zmCKr9@+o=r138BiEWM(V`|GBNKIUyC%VRmSr8oF9@~8NG?Auh9$8lCmOjKrn<CK6;
zdK+PRJZHDWMP>J|oD%XWZ&NJia!yMU_(SWbsCF^=h{$@*ZAk^?hG&X)7n@IsJb`Pl
z^o`1ciGqHYl#f1?CvuxD8KARknqu0e<kJu3N!(V;ps14m{wd-vrT~2;zrlGeL%`C}
zI>on(EubICZ*to#!=oztw@(S|k_ymH`7Q1}%gCsj{+&}oyOaXDQ=ZIiw~UUe>mNQ<
z^)WLA`Q$wA14|BwJtC)SKW3*;pZqq5ExA#y{+g-!kEJPSmz>XiXqf~Sy{xIGkCiEO
zmt4T@v`hx6uWqXNF*6l?EKlKfSqi`fl0Vh=F*}uhEKlWjTMDBZ`x~bQK9;7U-SRYU
zkEJN8xqs!<(8tPDx?3*f_F9TTpISdvwVRoSK9N~&pQRM^A)cw)-Rv~_iEQBZTgswZ
zV4$MkElopv<muc2OF78<nx>j|E7Ry6xrjSxSrXOO-w(q?rVxE9&)^POs=zqXI@PzE
zEu^2yGr7Z->Zp$X?NbB0r9!k<p2Z!ptd8pH-#In3TPdV_<znurr8X)oBYc|b6NW{N
zatTM_{9Kh0IZgWs%hE=9Hh0`2L`7t1rs+SCShP<zawjZSa0X^gGkv14be~+xowPWk
zk~4JE#7`IlYLe%0rz{QNHOZgm`-C;nCV4J*+Ojn&Gs8G7@QGwV`{jAu8Oye)?2O83
zp-&V8-7lAMXD!>o9$P<6wTGFGK9fz{ISU3Aif5X34?CTHCeP>2TXsg(=D|Qozek#m
z4#*3*3zpsBDr}l&+M`UT2jp_@qGfMXNrr!#xQ8i1pUVrmpk+VkQ(C9__OM0tb9oVW
z$#O8NBBOm;V2@OU4$6zU%a+4YH5r}LLVJ`VdQe`%U9lXEs>=v3RDH_KK+SRmchzzn
z#`%$j+E3XTv{_!tU9+5wa%E@=^`A;J&>^{!yKXrRio~o!)2GS|dPuI~ZdlHO<XKlJ
ze#*>5U&zb2o0jt+X~{42eag<HU&zb3Tb7GajTy$mz^BqobXZ=&-L_ncYR;%E41KE1
zq=)5d?vCXO*mLU(RePCP=u5eVyKA`yUKdZHb}u`Nekrfy?pba`wZJ@0zgL=tj>xOH
z`<7c^W^5`n?Nw&cBl2qQf#ptATZSKo%S<u)N?yY~wA=#~OlzTUFI!B%lGk#NEDxeO
zGTI9Rd!=G@R9?qDwmgdJ%IGW%?Ny5DQMs0TVtEo3HXxi;H8LgWm|Vwovvvo2OeCvq
zWJ~BVc|F(N+9Nt*fQHpKN+pQO_1x3eo*;zGVoi-o38nG|u7|Z(bn*ZlD>gE-kzd}(
zJ!|a^!kK*5*T~MMewpKXT4SO!2N>Bvqcj^GmwE05Yg}~pfJ!#hsLZCvWr6EuO#*pv
zJ*(Qs7}3|V$h~My1xJmC)$U`B^lRD7^|tnn&VzBHexGDSCu9p3Wz7H&WfN=Krx@u8
z*~-OO2St|*@U!ARrWAc6+c>p#2xx6uS>Haklzt=Ixj5_a=!yaDY+#>MicZQ7F2Oo7
zx@JHp8``Io(vz~2OR|oRt{V_;P&F}gP(XHZDb^e?;Y1p=P3#;RklkFWH8<KdKx5E1
zNpsLC*~6t<CxQMl%V26!=Fn4e1J~C&8JyobgV@B(Mc>MsxPI0GkmuwZd`;|J`mMZ~
z%di$kHx4iw0!`9fbXwlR4YU?THxH;ZgqoDO^t8N{8)Pj8cXGW!wV#=XzLO<xu(cF?
zJ062}KRb_pCwsXe*0Sgpn5OFYOY_hf`5kVUwH&OQO$O6`Wga~vZ{vnrmqfP>@WWXH
zQ-;2m-{nSFt3c7yYVhr6%joy=d)!ECb#%voc0*vlREEyV?{lN9tE0OHbQ(hYl`?u(
z-p-A-)<%a744<z0j4`1Wc?XBA8^G!lIbHi1Yoaak2V9O-h>jSjnXdm#GNE&_%#E{J
zLH3z7-SnAaqUU7H<yxK5$pdxM#m|`es8uH11Zx9`fbysNK4a(8R{2A2l67lz=0M~0
zz-Q8YbYA|5d(*ltI(uN{^w4L@e0pBq$xXIy2X%D)bkzZ70s2Aqac^63bgh1%XS((P
zyMX>6@8SxqJEQYpnyfz{EkGCKkGZMV-5?olnr=FvET9+U-CUt{Z*<8(|8(&HQ;vR=
zKj944{oosFo$fopmeU{QJzSCXV06X6_UVBGQaQRPf6C3Y9*(XV*f~9PKq;pe<-J_7
z^=Ne6!0;l~=gdN+$c@}=>v2#NMHXp4XBSdM-p7?%Pe!{2YKruqOAAp@ZsO)zPlMYu
ztH|`ZvXBPl{al&#EI8nGMdIhoBJ`8|88_d09;`<BMZVA3Mf4~609S6k7~MF~SQPkN
zT7)jipL2_>m!g{oRu+XmR~FGr@<DEi^$Mu7>x)zenZ@X5xtUvPy#^vAPm%T@yO{ng
zAL6R4H=<i$n65u4Ek>8+FSzB_TcA{JDl#2Z7Sqe}VXoSGC%SE*AI_ebCFmFVOKzq0
z9=MZQi+l&!CG;2h2)Ek$Ai85<dr{z^v;<v|zv9+fA4PW!>?{f$RF=>y@=>nV`XoB+
z<?tD*W~KtQ$;Y_$*6yHNikzWsW-Dl$Ot}r#9x)LwYi8)1r3!Ra_H%$bfXOv$hN)Sp
zpjYMN9Gv^dB)_biAvQBhQM>##2QR^3Xv&}AYi5_ycKHNnwZ_C`zHFQkXqJ|uYw|ao
z-5M8@{c`1uP_wd>UXxF9PHPgF!|P|L4l$MJS2@7Bt*Ib&^32d4Vk_yd@+q#t+BYT-
z&Jy&8q)K#M{+8Qp%>aRH(+txgrIKEkPjg$XgJMcv_RkOxF;(a{`8&>Q9RePx))~G-
zY!&@YKErLZ4v(pLxqU|9kW__k$lr7CSx3gyyxch>bV#Y9H{`S2cI)Vvx|hRes=i>B
zp^)6dePGQ2byVa`?HBAa8j{a(*qR&TdRa45|An*+-IQCo53Q5HTbni0^o6pF-jvUC
zJFSx;380%Pe!(n9zso;xyQ~FZo64W*`+{9gf0r+CyRC&WjV~K#2ELG%qg(Qi+#YLD
zO!Lc?Gech}%jqroBDdFC4C3_qnX1Fg3iOApaQm#KAgJ=p)E;J6&_CoLx8GV8(*j2+
z`oq!+bX)$3J76sbU2fA%(_v)=y)9qj4qBJQw7u+yqe!M2{VD&<9kNz|)2el*?=V|U
z|CBFthpp8y9WS@f3>=oK(H;30?ud1DOxMeuGed`!YI;Y$!X35N#)J(DpQZYesX-lb
z8%JSbPc<lVmi9}whIYtTx#O_p6ER3LOaG-*gYL@h+zI$=GlQ~bnZ8tN=w105chc&N
zNgkw|C4R}QM4j@l+$n1Vn6vU{`MzXV(oXq0ciOr&CUcN+R^Ur%CAug7#+|Wli^(2T
zIV<#~vXb7DZ*XU=+hc0S462`{I>M|%f5{>4oE3v?%QH)Rgk44dl5cY7tvh4#;3!Fd
zL|TRJ%fE9Mth+%D+%(H{L|H}e%eT0T*1a($gZ#6^Bg|^_xBLeewC)E#SL-a_5q35G
zTfWU*vL1}77}P#1a70>-9>{-km#v3mY6f-A3LQ~a(+Bb$?uzwjOx>XHV%1m78q_6s
za96FzVSga9So;;bhIYw!xog&wF|I+HV*OXr8uU=^<gQy!gOfO`*z}dMhCY<<aW|}I
zArYY~7QbTFqJQMSxSQ7VU;)c7_I<^!rT@tHxm(tYF^z+a#euJ+wdj%jH+S25DW-W)
zWpU^$Wi5RqKj7|IuYfndzF2jXS%?0WySTg7YakBu6l;&N>*&AoL++mSMobHwr0I`J
z>(FEQAMU>O7O0S$icLqAb@Z|Ph<jkY6Vo=x4=2-1E&5OXmwRZv2d=T!V&74=mi{L{
z<{nue#B>a5FAf})YS9z<Kkl*hQB2pM&f?HfrItRCpKwpCPh!F{!%I}hm^u`O!}xBt
z?w}`&EYTig>u4D6#&@^%U?MU#CHiAh9qNX|`KN6?!N8nVVmhYO(QX)68Cx$VIa606
z9%I&{aQqbitgSZ~&GJip$Jq5W90NRKi(xV|jU|C&(t6Y#Kf}LZi(|4gD@#Jhl=ZYb
z2Aal}1lfT45*20Y(NkE(zi3MZ37V%wOWAt*6b8J;)|bhHgG4=*>e18qIX=pk0pjPT
z5))PG>C+f^8`~hJB-39aQf32s20zcMZ9~AD)>`7D><0P_1^~x4oT<ocF9}d-1L}eQ
z$0yiEGBuf<B_XP8pgk}UIkwSEU1s=fm7m#&R5*f9vE_hjEpoQj&u*kD42X^`mvLok
zX6yaZM)WL><kM}Fz&D*W+vHa^(q}O+JGRMC4AIRN{S1em!+rREwgRxT<<Iu{S&lx3
z0phV0GL4zW*#W=Ap`JLJA80FLnlmeBhx`ghdt#t^Y{gJbsGqGm&hY4Y%<zM4r66?k
z%+?-fdHOsC%*R&7w7@y4{<y@W7jP^;%vKJX>!#VJ;|fn-z`*_3mN0FZ{@LPjMnM0=
z@%#u|6*%BpXZwz`0{tHb5Xe@|bY!;A4jh*R)C(u_qin00uFTHaq2r1`dto4hY_&|-
z;BcerYeqy7IGIPb4WNySG-|(QMH+!q_#B(SL=4s#^<PUOdJ${*aW*U1wX=+-uN9HL
zh=ColIho|aI-~eCV@8oUjh|p^0MlH)(f2iLrjZz6BHLCbbFk4E_*ycf-uNZ{P1`o6
zHhXZTG4!=!roA!XMYiowji@)OPB0eK2W$DaZ5Zry9;5aIYoUEG@J6<sOdgyg>rY4)
z6ovcqQ*FD!>fK~Colq<^3Il*-+sl*;_8Y|$j1@)W0ldMsAB1+TM&Ak6N~19lNw$Mb
z#o%^h;DlsFG5BSErtL6OGq}?jI-yu;3<gBWc9f|b9A2vWhOr?AXY#Xc$H9RYS*rbp
zwNVBGvt&ETxCU!V_1{P~q{dnNT-#}oiD#9XzENycjR9h^orQvou2lSnv7=Z#l%H=q
z58Ax^Qr|bMoyKCInrs)D#=*wYz&DZ|#o<@@MYc;!^We(T&^L;m#$mvmY*!$fQD3S$
z$v99v&gPfeu7PRKQ>s15I%qrw?#Xt8X@O&O{YlAz67Z}1a@#F%m^YQ0PAU$XfB}TE
z-C^1W`%A@>j1wi|*Z7sTdm!g)E%lvboiq^x8D)FGbPR4U4V;vmC<(vLueCj5x(0Wa
zhE6I@nuGzBvOQtKvcl)60*nhK<1zetTX(f8D{_uDz`AHMM*Id_4|PPAW{y4}xljt$
z@tmzEsME9Nm;#E6reJ`nY`xUUS-Lr5fN>)Y9?P3;y+Hw(KgSnf-Bg2tuCm3bGqa3y
z0s+a5Qt^1+Zi`cAXI0J#1r#?;#eiGclAsw<KSy<n@t`!U=iRncum*bOXiu>onudYD
zvh`Kx!4`r3l;lC_cp|^qmI220ra7iliif6S0J3a@)FoN|IpQg%0lkFZ;JvmXAR26)
z<2%JR(3da}TDIZpimdiIfm2cg>Wkmv-?NQW*JO3h37t|JXkQG-mTk1UE-QSl>RV<L
z(&9Y+16vNb2_xrfzhyU3Ee3|mmaBGUY3Ay`l{TS%IG_K}HVH)WS#wR_Dw}9O3{aPC
zG6aQmbH#6&&8R<~!tb&bfX*;~uJ2oRGwqLo^0F1G8?%ga1K&!UQ3jsI@39rBo3kqC
zhQ3uc(+mvQm#r9*DfM$zr<pBi0A~4pwo))4dgf|Rvs>r@Y~c6X%G52eM4>+|Z9xO^
zbpC*?9Q^c6b4{m}Ep#9*;t$%EsN1sqbH&rlR`fES!5^|!fi$souJ1IvmA;H;@`r8J
z>W-}Txq;KtRx}9D;*Z!?tGlu~=Y~!zTj?NN%pbMYs>6na&r^NJNGKDR@DvCE)sV<}
z+V5D2X5!iWahsry7^0b{|4x$7U~J@1*sP$%&zfiYPLb$fT*{xcIn~KSbo0dT7%$4g
zbNExX22eBR&+~o9dTAD(%b&JwRo7+?G0qEoCwb8jJdZzP+osMQQaLa5o#LfKa2bEr
zwjGi&_48C`n0L@nY~s(^Fz6gT^R#E!cj!<&pFeNgsm_BX68#zJ9W)Ft;4j#AgO0yx
zp6QJ84jqQe`HQx_>XIS;dEyyn8+rvV<b$^TV1R6$=R3o0qp#pa{3Y8#b;XeOd4V(1
zHZ&YB<}ce0t80dI&I_GUw$b5u34g_QR9!bDyiD~y^DfH975r7(akV%kvP}Cu`!3DK
zOZjWIlWNxxO_~0C>0LAeSMt|wr=bFnRc88Ld6$mBRs0RxSqMz&%Ea%P_t2|&8GqAu
z9z2uzWxns(_vov5Ie*J`QQbJiSQhwRdJm1nEBM>COX}t!m1UvtmG|gKT+QFHU4ddw
zeVOVk^FDeF*YJ03*Fa6_Dbt>1->0wPmHa*14Rs6b(CE)f@1s$86@TA$3*rM!Wu~*r
z`*airP|kKo-8RHuCZ1)squ22o{-Nz2*eqMid}rD1^mPp6ob7?SV@P{h;H<PAjmGQv
z$F@i6t|6Uep|i?%IvN8?XM3U!8yap>wJ<x-7+lA9vv&spW~52m!tS7B@Or+xy+>@s
zP>o67BJDs3*Yi)?dqVRd%VcU%c2I-?wzKz&O&+Q<i7m_rNQXD_&)R!~Gc(`hYhgd2
zIt=ukJtj7DsL>Q?kv>2<nCD-x$Hit3tu%#Nln-bQ1{}|x1i_$slj<BJqp?`zU$m!!
zX47NRo?~S?76YGW?;D#pR5t0)NirITEqs(c15yi3Cet}ZrsFUGd-g%GB}4rt@f?HE
zcx>a<_90;AY&H4Lv6zm>K=9dz$5sq&HwDf~80BIIpI{#uTQjuN6gsD1nu`JHvyYCg
z8yY@e)yfd0$1Xm_o&z$^$obk<mQXzg#?PJ`>l&(=uWywInt(lgx_uH99<t_}S`|Vk
zV1WMYlc6`Jn=iI9AEJqP6W`BX0RGSX`My^6Lpl)y1!ymfZ5(QxA83_6M3e9qexSW5
zws~mf{7|d%A)SN)3$zzQFR6aM>OAuidIL-RV0$SjLp}4g=h=_w8yGl2ds%D?Y*6XX
zOCO;(@jLu5dpU$9n&z9%D<9D}F@S^iC9!Qo{qx21%ue(cewQC%uL8?x>wMpNb|-xc
z14(GFj_nxQK0k0?+KDFP_xVxw)v;YeJLiYaD?90A3}~UfHa2Wn_yW}rj1T4E9Xzsc
z05NIg0__j1kLKYI_#C?s8!=3?K>vf}LvLf5A7{5h&mwDq=?BF}-^KtR+MTh<!*mP8
zADCSz9}|9py&<+%J1l>J?+11l&BuTv+PB7L4l^zY{2=W@1^6TWP5ZXk>|vD)LO&?G
zXaNR3(Y_seQS}Q{7nqOH6zt>Qwqx+0dKPFeupiSY7=T6l&e%NIAk$xvK1NgV$NW_L
zZs=$<EiheBKBiMK5RCS{u_eR&3&ab|ZZr*l!W-=SL7CdRz;}V&O{ZZ%8tn&TD~7c%
z2waeMqeA>CKhu6Vwq{u8g3twJH!Z}#INFcK)(s0USN+I*f>_+h&$b^2%W7n~_DA*;
z%3^>X?I&Yh!!+gkAEi%_0XOk;?WZB%kyUQ`QTc=#Fi?>8v(TT@m5V<zd(d?J89(2C
z9>lEq<-Q-;J#;z-EYf~4wsDxTJn*Bm2NmJZ`9=0ivCYFO%R@gZduR~`PSSn_a#{7|
zs*B90Xa;WPm)fs^%hgk^y~ut_XJ7y)?KfguV1Z75QTi0k#9#2s?YE#B(o}A`sC-Ii
zVjwB)cVgRy`OC$N%w9ALf61@3-vj+?Yq{?tyO++wfL7Wc#C8m8FArRl_M&3^6~EU0
zD7I@@XL;zNvX>TPU@h%WV#8huU#L=;MpS~2@$2o~!5AC4P^++wv;<RrgS|&w#4DPG
zdPQnPv$3D&>^&h?lC{vJD2;SB1{%}eD=zsJ-9k}e_8}wwnm5~fgJd>;p-*A=Q6mOC
z(;gF-`HFF2K#}&LQv3~Xx5ve0zf!p{q$vAnDF$BCo&>e9`h}_>(}d>W0PnV^f|u5_
zP#a{M=o}0Hr@e1n9_$b5gHjWki@)VJ+cTh%(zMVNRGR2q3`D1WP+Z9?{)J+Y*^lPo
z?|83$2&imZ7y5$iemV~W;%OfqSMf^w!az{kkIL}({CoD1aW$`WE(`^g{j>}N^JyO)
zSNBTzBGpgKXUK$G_z&zkV84xAr2UEgjG8b&p!VE2*DIPu`k$oF(0ts=e`ucsX_l--
zrk|A0=zI)RsC_cz2z86ZpO^z^0sevCWiJ3>ZvG<QPwWA@00Sm!FN|w^#keT&lXL);
z;~)7w_M*7vS1K2Ueo_w5atz$4y%=I?^@~)On9tEdtnmBnrQq20EYe<LKc@>ZfTZ@a
zxE5HS)L)W5M~m=J`~iD86k(bcnJy`x(?$3af6%@puI&~7BJmP)5G}?(^M~wJpyh2{
z<h#Tkq>J%o{;<6|uH%*VMS)AwL9_(_!XL4(j_Z1*b5ZD$a*!^;SNNm$+PJXc;fqy2
zGtH<1xAD}z0ZhJ;i?u(q&9nkv<&Oi`6fs=0SpT!sjF#ed{sauTnBiHAO+PEmbSb{Z
zpR_yUYLkcS7K=YKhfpQ{l|N-~0QqnJV&Bi~AzF#A^QY}w<1&XE7YBZp4xuXi8-K>W
zEiQX_<>JuK${|{XZ}4aB+aVTLzgTsd`2sD&A^w~lgD=>#SbLfMf-b{1`SbRjae1&k
zs=q9KftKUn`3v^l5Ws0#Y`Uy`L6_rO{6+iTxRT-i#o}e=Fj|5C;Dh%4pcrml?7Pe!
zrYrDm{*wJ*T*dJA#evJxVN{L(<S*L~$JGq)TpYTr9H!Oy4u8ddG_G!V_!8AG%$KMJ
zckoy3$K%A|kxR6{uwT*|e3!pwKN;s5u34i0Mfwu0#GU+g`)TOzWGylMqI^kL;(PoJ
z``Nf1!*xr<Uzj6k75<CAX+IAl<NPJQU)Upb6~52kvR{mA9By0^_(eK`R^z|<+xAOw
z&BH5~gnm(u(AD?>f5(0WT6y(LR9Bd<&>Gyu-?d)@_pxV*_6qwIU4tL;_v|;~T3~rr
ze?|HVt;PTF_wBbJ_tUh*bVd1!uEme|2lhL0ZNvRb#4F5Ev=0BvKeXQiU2^LZ-xc;K
zU55d^wLggK7~Z}la78+bYVm*kWBa4HuHl_aLRXZdv=#%4Ykv|KmK|Q9YGaO}Ivgf+
zb94v8a%6?JjXg%|a5tg5qepy1wx&YgCLKfTak%ibqbF2`vMNk%$}zegcNcm%dc`Ma
z>ng-HhN61>l<=&hH%OWDD|~G%rS<q}p{FAzJ~P``5onVr+JK)CUU0<4XJ=PdgxVBJ
zH{c#ZFGmuj0_!VOR~bLrh*iRij#ThCdn&Y7Sw97RozUCSH$D$`hxJz_KLQ<<5aq~#
zxKUGu>8j$VpqCM19E0LZvi%j}RpvMXU4)=^3<33XYlZJBdz=FPEyOv7$5&*xR|Kv~
z#}VM1LV{ytd`)&|Md+$>oC2ODBsoUM*JXz<Rkbr;Bfu?$6h{u&q9d1T+u5%vtWOK6
zj@)=xwq~imUHTfqI;4>9m;_Cwtfi)Q<!cJ-O+sJCWT=(umWu7n2?Xm3LO(|V2&VIw
z`r6qO6pkN-3`b#nW43W=pj|qF;5b1T=qQSB&aPY<YFAEBm<|eq9K}#dtY50S#(aa|
zZC@DdC<Q0AXQ}oY`wfMscVUR5EWQO+r}fvQZxGy#g<+0zNI5kvHC<D_q44bzhC7zT
zw`Kd6ir1Kv$bsX95ss?(P<HE5-!=9mb>IYHq@y~%BfEWR;F@$2IdP&e%CS1WE4y=P
z=$dkpI&qRP+EE)HHX^)I^(zxVE}SeN#|AK8M^<WoWdqcOQ-mCc5Far@Q>p(|3LrPu
z2;&^q_*!N}R;B4zB|zOcRmgQX<C90|D#c%!Q^<qUgb9uYux000`hI0kQ4dZRCONjo
zXO1vd27Z-Jp$7bt@TOy1eD;XS%FwUMDcXSh3X>h%p%htPsk+X5i#B1c@HYHJ`VpQ=
z?REBBx(W9a3LHD*^I&yce_i?(ZN~kDsgB)Hu4<|@U01%Pn{kFv=-3-yGQwXeUT03D
zEqH)naO?*scWb5ZI(wRK!2^XN$HDlD5$%<M>(Xho6~8RZbR3Sa8PQo8x~`n2Tk#;F
z*l{$zZbW#M>Nn;)B;ib9w&OTxyd$f$zp>v@2@e)Z9Vg>mBQ#a|-=y!57iS4`9j76f
zl~rZ>P5F*`@erZRaTe;ex+?KE<_vlV4;AJ+&V%_ozsmO;dxpM)hY975i}8&kj8%c(
zq%&w6ennX1xD?+!qOvOVn{tM3!^4Fojw=w#tglktV7^E1;%s55;~L1qJyqHp?DzCt
zJVK~)+=y?1&3XL|>3j4ZepOiRxCNcArYh47<$L-b9w}5i?!>o^@K=d9n6v18{F<=R
zaS#0BtyR7o>{<Fg9wn@HJc#cY(Owm}A)Q6r@$14`$D{bJ5uH_`8_HR_9gh}j9Z%xJ
zUJYNS3NbBc2OcA=cXS6OdE_!}h;5-eFcLO6dL%@=s#&HFNiFCDtP?m#PsoF1Ei;9b
z7Wx6s5d=rCgydIs%ft|K4#{||V0QEdi+TPsUx+<NWjs!>I${zsUo|cZgrsu_<MD#s
z5toqtYUQ#}NI6F_&J~=FB<O_JFH_xQS`oo|!R<%|@wsQ2_9oj(37#M{IQk~!0XU$)
zDYc>x@kC*>BLk{rP0LI-l~(#8o+NB_3`!_@)xS)<$(%<Y;Wq@YV+gp?TbKE6vgheX
z_)TG(V|YTvtL@7IH>LAvCw@zK&oMHg=GD$+p_|Hix)TF5?iig=_iFfZ)$hy?$cOWU
z4;(q5SC3q-{hj@R`Y=%Bj@$&-tD5Ed-=!bWE}SoX=$HgCw5;W(-<2QeE(}<?V=}~y
zb<4%ynG5J+JVn^$C;%gS{&L^%>;?KU2F~13n9%sDae3f(=>pn~rwMx;MG4KXRxS_y
zu3VtIF@WceV#uV{FIU}Seng*OR@mn#1&O<7x%L+OBmD#eiS8&%XaR0Qe@pri?ZMN9
z1CDZNur)0=-BNy}doZBsjwK0gulkpZx0s9QQ#?aB<fsDgd+T!FE%qY)6a%a7s7~m3
zwS9TumUI#A#j}JXj@1cWuXZjE-BK>ny%^wiM{Ppb$nX`aKNtly;u3*^13@)1a)tH}
zR-uh}ws71bB-BQX)U43|At`7dHVP*kR%pLvtuXzeD0Ck#6;3*w3CSaME5tvTAZo&M
zgj0?N(97qq@cqFCX%n6+oOWzY$Q)^05%@z2qWyTDaK^DMA$w%yiqIcQknYC-z&o}>
zCboWs>NfKe`V5<db8rRJkMyk2-e!NIpJ5>49Xk{9fE&@@mVQD9@B-n2V>cw{npT)@
zD?iZ#7!Y~K-h`5o{uSbF<`ViGFBF1~{UEV#UE#aUUZS64VCEeM6DmfwuL#_hE}?^X
zv2fXOIH6`_=Zes6<q|!J0it&tO{g0gUak6*`586i3gN2bc!D@GvReBm`!j9EK-D`=
zCb&jws`Y<LKchpqQn>Co4W+xRYSW*}&-4%m%-(Sp;?}xq@lWP5`T{Q#ZaU6`DnGy4
z_a}Rqeu06zcU(+p9BHf${3%^Vhw%#Gw&PMl^T^8T(4Wd>dKd$U@3;b$-1=(O9p)GG
zC9V<fI<A3T-&3u<!~R0Q#6addZX~n-Hlx2I{eq6*Rl<G8EePy2Rh#Z8ztAHXP<_Xp
zgtn3XYVi(p1$~9r2oD|iK*--(?YqNXp<iKO_Z<%sI!3lv2kuB$&{4cjc<gwT&^5BN
zI&??5LXYBF;fdo(LfC8JHL4D#4IRUELN{l3aQH{oXgk<8dJL}@x;uL$M!cq}(RWB~
zh~j$TX=hL9`eoIaI+Qj_@dlxXvsYsBYq}b-gSm?Qc%$&Fvo~n}^J{z^>{aT=oY2!5
zlbHFMu_n+VT}8(+FTCK4OU!<)vL@7_T&2e`5aG@why>TysO~cD=xYpsmNOMf0iGJ|
zUACQmjbUHf**7r{s3HAbsU4lbu)gHXfSh1cjp?q^PETMsO>_=QEP2geBi?1Mp>Hq@
z_nbo@F3?)zyUSjq-(Yywb`DRhc&)uAa96s9PGb1zJ4Ytgyw+J0x~p8HC$UpVa*j@{
zdo6sWs+0K@1+Ys<appjeAabR)ll_$juv<uV<|evc)2!5YO2490*dwGnCqcz9Yo)1E
z`IVl+4MJb%WN4l1R*Id>b@VOXB=mC@K*At@rLU8{PQS&Qg$!q5V&iMZm4Qy_Iy#NF
z2m_r(iOsK7t_*c5*Xe1zRT$(fhDLJzO4U8)H}oBrgu%{Is2+G$YVWbX(eJQV7~(8T
zYyoIWe^2@iox$%2!<^+1Pi$Igx~Kd`&){vsaOaZ5w%7bC#e2*R^gVu87~!mfP(tfU
z-#zvQ{T{z3jC58fcD&ZUGH_42fzIOhg;CDciCwRCt_<B%ZqT!MyD-{Wn;14Ke3j}i
zCWKn>4gongB-W}%MXu8R#fE4L{y@la3W*V;G^_M~Ng;F&%fdLP6{3w<t4x0>A$ksD
zA=l|lOdh3MCH}?SM6H+z6PyjuW5{3S`-{CvTk(g&B<I$|%u&Wwfxo1i=sf;Nc+<Hp
zF?&?ys?cA`O?n>h6ec^jLnFF=mFhn8JNg0pgty^|Nk7W7N_(IEo&JD#2?frbiFp8x
z>F-OwqYL<BVXAXCv?7~UneHpU(+haFQ0Uy7STf4LO1#h9LO<e91cP%wR3BPb`R=o~
z=#O}hP~<$ASTU-7Rp7pK3thyY3NxLD6Kh6wt_s~(ZqbW)uTbnfnpig~e6{Lt<`1Oc
zMq#$|ID{f1S8M-f|DX!qCzLu*Cb~vxR_p(k{y;(8B+PZ5hD2r7YSZ7!A2f*f3uVr;
zi91H=R*Qc#x6x1dGhx2-JhUb9SNr~EZ_}Uf0ioP^F|l!!adqHt={CBAKNl7`FC{jQ
zs$3oVTe(dy;e)~w=M_j~*RNJRVE#lu<7Q#0^BUwRJgc=2*gxsd_>fTLyph-f%$)v#
z^e4KEzYvx?Z$TNeX|?Hr@+ZBF4-3`KJBe+h{Hw(W%pLR#{!&=!yaxq~*44fT>>c_G
zJ|e7kK1l2s)xJ9LK)Qpj;ID+W&PRz|qdHfI9w>L{6?{~vbv{W9dp&%Os*CABZTOh5
z-q{_Z7m;hUU2F$!!&KPd?2#1lx@L{OOX@&Zv0vbvJt4@MwZ_z?bkM8#xF9%tB_+SE
zTO)QccTqe3S};3%LnkADjjxNnOWW}Y!Rm}j%6#3pCeS6_Mc42*0=yL`WxrmzCe)?e
zrPuID!RbtbLU{ce)kCHe{fYyE+nEY!4bK|wL$;Iticbj*&b~=`fDGy%N}cFB{#MxR
z%zzGP(;Cx5rITLAr-iM~K}jXA``3sMnS1Cr{GH%+4uKj+>l)uf_8$EWpAoh>hbL9M
z-o7UAP`Zb1;O~X^oFkKJUhiBJdZ^r^H!xTyoTHQKUJqZZ`iJ=og>Z}TfinjJ9+7Lc
z|FD125C#o}GdIcgx@N8ZAL%c26SoQ<IwwJXG;6KtALTE46N8t+IXP*^>$<h#Kg@mf
zJN`k~<t%{aNB&yhKkR+_I|fmOvoNXgb>rH=Khk}43;!tWaTX;tzh1dE^pA3%-ojw6
za27)#y?(9g5%V|t11rKlXDMVtJZrU&*uUu?7*rO{vZNLuCiRb`ztL^{lW@RU4%O49
zwWdeP-}E*Hw}o>_QrqkPwc;b@0s0gFEF5xHL0P1At?v>0fc}X=cHyi}>Uh0<ZQzmg
z0NugA2uGZ&le%8-TpN0%JfL?l*e{&5Nws04!`G?)Wx7xYZWE|;1H?!o*J=M{yJ!c#
zDjbK)Zp3KKI{m*=7rKkvg%hyU!;H>aXZly^qIdB%;UxTZlSk{;iT^SWQ78UYIOS}B
zeo6j1-@oib+KI0Vr=44qGDjQN1^$&DqI>u^;f!-zQugS|b)kQihx8u4A)Iw?hdzA$
zI@M$5AM_Uv3FqJqOF!DPPWzbshyH~@so~t2ln2D9{;~8Ax{rSsE;x5X<F#p>>9O(;
zy^q1M;oO^4GTOgRe9SyTf8#%dpmRS|Qd-yf9<z_=-x#DD&Vxx6qubX79!rnV1N^6O
z*?BmrW_0Je&|~EheSpEj;XImDH#)pl^&j&u>cSnuRp;>}adc#@_CNMt+J!;O;XIk-
z8m+0-|0n&69^y{ny7M%oWwUBc|0(~{hZsB^&a+87M(b+D|Cq<<AN-ea(|I0REcvy*
z|JcX$9}MCS=f$MP(Z<@qf6`<02>&hIc3w(q9$i@*`cHXGA7L<gIIkof8(m+kdcypN
z{>5FwUFS8(w|Hu`PuTzHzZldW&KpTB0L<#2NdKY7_#ffE^A;3sn`%u@l>g{s46YC7
zouszW{#x+~^922e{}moO??LgUwbu89eM0}kApdYaNa`5fUK@BKJwZ?Kf5Kzuqol6U
zowcDS$`kqogAK&_Bq?l6c%3Rt9i|H-VPZE|cZkG9)@j2GVg4}EO@vZ#a>N)-oj%MP
zrt3x^MegbeA>FJxQ&=#}-;Hz^p`(+WJVsY1hN-*h!U?28UA>_zlV9fxGj#KZlcz<n
z%qC}!G1djbyxnx&38cJSamm?ZD(gaF!EXNUq=yI!mgF&G>g!b9)Zx0P2&6V#sgR=a
z)M>jJ!u?N?XGH*%lJkHU)_3!U>z*c{!gggqzqhH*)GZk9f130ZVSOjLWQ@N~?56In
zdxn6j(lrF?HLZ2NZiepuXUGd847ZXi#<bT3x_P_ndJxDgyGAD0jOnZkbqjX)_aMDQ
z_|qrXjR{|`3Rgd+QxPydxN;zP6S-a+Zg|SCA}@-muH0nT7|nWpxc4dDvjj*?*CfaW
zXRSAd2cPmkOL~iaU6Ye{jM1$Z!`0BFCqPQL3ZRjbzup&afH*vf5;I(d$&F)->jU9l
zsI(K<WONlJH;<`Y9|{jbE}g`PgIvYQ$HvsJS9MoIww%DGfvXg<I-d2~?gr?G6F50^
zl_j?TF0JqGg^)LalK@va)QX$do4N;~s7+w9=US57HpahR?5>8iHGwyER~3|aTG#u!
z8=x^w;K|!no!l{|eSM(27h=x@?xe2O$+cZ$I@gD~2cf!5;H%-PO%6lh^{S`TkUu66
z-EnPzdQW7%_9+8&h)If=;}Vi1kfvV$lox`)1hOkGYchkf>P=4tq0CEC#ax#&IT`8d
z#i!Je$R*I-a5X^iC%@kJlmS|`Bwd{3+M1k+jP-%1ybz5gP+o9tOU_1>^`WPN5N{=Y
z#mTPi$zxD`z3OQ-R8$G5_hBNVN1l4^(+0?yl73==YiDvE;NtqHz0egUAYXUwPG(V4
zz3J&71U^ZISm@fDT!Q@d;?rs<Z4$6=yY@p?sI}hrv;mTrWT05&I+$F6+Uo;Pd!ao^
zz`yJ|oLqxC>qAcmp#ez-iN&s?$#p1vgX$Ue^E!rrfY)^#ekqX~w9gox_cLU$Sn4{N
z>_VCi`e(e5CnTU?b)8O@P}T<1GePJCk|AQ5>umB4q}w1qqlRD~0SBk+Jj9FgH~5}0
zKsk>L6U$u}lN*t7L*N-NB<u)S7+sf=n^EP4&@(|u$&umW64#aFW2k<Es)rhyZUi)Z
zu4~Xc@@&xdFhE?5j1a3_H<DX`me=?2LgkErh|P5?SwT%3Og(~-8zUpdYS*3QHss$R
z_E1Cji-3vCbq^9rts8tj3=rTVqr}y&2gx0%eM6v!7fM(JTuiP<$z7;(L#Rg(id1B@
zSnGO{9HtB3s8XpR4Mjl4<LaKG(nW66stnL*B1qie>X8zm(`?kMybwzwpks0MOks3c
z8%?SpREtQCD7bp1B<pk=MU@)zK?HmpuHF!0%HQZy8KC1s#)(!}OiHHCxG|veLQsc*
zk--(0lC7)U7*YixY(sKIrz<ICjIMs8>RB}uW(Xkpu2g6@c{XaFH9+cxOb{DfeN*y4
z7NCFD3(XY*P_`>0h1E4}G(8)H_z9ULZgmYxDbe{iiqEQ{LPCJbbq#^sQ|m_Gvj)h4
zkT=C`uHh*ay7rBMXT8wnAb@4MMyAy0IyZ)%4MHD-OcuAhMyJ&2!a3D*>OMLx0Wi;%
z1BIwaPWzkziV@^(5xa6zTsjS>f6fc(1_ET3Yf_4&%i>JW1)-rp3dEhR$tgQ@I!=5}
z4KV`(Y>uk{qEh*s?>Pfh1;|u!x2rIvQD@`=&v`-bPXNwv6{R%mD!I^eLD1}zLUFIF
zIOUkGo>TQygYTZedcLa^I#eD`+tUEzd14UvyUJ2pz?Goy=>-Ekf&FY(d5WTI;!Hh*
zpkgOQ;z8Gvls2886ML$`iB4cc*Hs1Ss#ea|(*SaEGE+S4s!plx(6w`co?fto6WGyo
ztxoCEb#kGeLC|%RV)3Y}HYF@4oL4=s25&ZjEj`x;$X!M9+UE@*uqLy`<M5srk)z@D
z&wIfnO<+ySWldpnvUt<;K~OrAQt_nAnUb8N<HhII;8rHEsN-sYLRLQSd)@$&V*;Bh
zuB|DVIYvJ4yccA{1U5BX+fuS~D*4d!L9qT3SXFRsPZ^U_&#PWggMOF5Sv^c}^*J71
z`+@;HxC9QXT{~0qz!jl?!3#oK0*AG(-6?EN6K{GU2xeFUr<Ja~DJ406UVK3fidM2v
z47&D1hpUzMy<h-WDuMGV*TIyEoOV9&f)|{n1kP(*hf`{DI{DBGL6C<MIIwUXO{vQX
z7gYaKgT<4;#NKrrE~1fw_J0P@X%ZM&yH3JgM<eL}=LN4Nfsw82bc&RdC7Avf1i>VM
znWgJ&%8neJApTDcrbhxpJJ)%redP<j{~18JNMLH^x|q_KV-y1a^Md-2z|_WdDWy55
zQV9Jo2o6F5V++@nlw&#df~uDqWPk+T+g;Zn5atoIy$oRGBk<ztx{=ZXstkQEFX-_I
zytuh;r6@T~f~i*!Jaq)#TwHfj+H(AY*h>w<I0BFEu6xiFYZZLG3}9{}@a*b(kkXOU
zE(Cgc!JtOq+0FGRr7NdX2=xkr%8bCni|a{B*w}DU6`=;F7=gRDyE|maB1LV40pwl;
zZeQ*mnuxI)Q6J$2%NBvlx4Wl?8Ji`VB7&g1B5?h3_tGSf)rn$+8oW~kzQFF@P%g_C
zeGvu_KoR%^yJIw&V~t`U!V4lM0)IhwoF;p0r5K6`f)R<pkKj(yj2T-ms$Nusnuv(v
zi|$m2oq0s<iw1B65wqCa-B*)0Ru=UydO_AhEMk;9L&J`35=}1#!J0#?VvKu`rev%i
z{$DldYlux$yN5s@tyT2BXaJ84v5Rr;;hKuE?PB0XFZf)DLridw)YOda6hkitL99ZY
zVv>8brfzJwSrw^H)9HyzOmXKxQZ3S~jWmF2gt*02cdo`YR%6yjdcpZYJYu?gl13Vv
zWi~|yLB2s6#J=vynjK?xW-(F?77VgU?B_0k3R}L}7ij<;1=%cSxC=FnV~yrOq!+Xh
zWQ#b^U8HFqTWJnO2Eorjwu*z?#hPPd>&>d(Y7iw5NgV7hg>ak4tnF<8V*&AsL)>MW
z77(TAdwW40K;99Dxyv=m*e0{7cMuqUvP~TBUZQCm>xW;R8en?zt~kP7rKt^#Z8iIP
z8-Qvj?};Pb)tZj6?dCvlFW}|meQ}g~wWe!qr#aL+2%I<BE{=BBYQn~aTU34209=zD
zB64qlK3t?l+s6RpGx<QwaSNJ=aT<%hj~5VRB8%hPRt+;Q%VO#i1QwWJG1u+XB#+Zs
z#6D_(atRS9xEmlTmv8a)F#sG(J`^Xpw`wxS87+Z6UZ7OTN8+3AZJO+Hm6lMSAmE~8
zr#RWYT{C7}y+swJ25yu1#JAzZM?cPE(MA~npd`D*0{2c$9*AP}QC=V!$;aYU_ihb4
zuE}DG3Ib9{c8i7Xy_%A7e)#C9f$bxohz9q52-me*d{G8q?8qLm$bC>#F|OSbi1GsL
zMm`m1x({n=#&udkQ9+>2$X>D7eN<C7F5Ie$Ru9mzq*0vhJ`N9EkydTAVSt|{`@~ZB
zNsViq#;T9@0uV)-#JTR%8fjdX)f62BGKuUL%iL!*JI3j(Vze3%A@Z3x-+dnPc==Xe
zv;j~ZazHG1U(_^?Gg<@DUSMX(=i(ywB~A0VN^2-O2=EFyC@yhd(Ht9BZ&k&pfg&Nz
z;!^iDDC&8v+86`i9ORH#<-Vb50Z)!T#tU2p`9fUozNJydHCatDK>!@cVX@kMN7FXW
z58oU$kOt&Sai#knMEF{*z8C{+{F5W%YWD+8$GCQDAjS);_v9;at^1LtYh0%_6cdCU
zcyd&%bwAOBjSsh}7&R=TlVjp~cX#OaMcTBC0k*;k6*sthq(+R_*z}AS*0YIU<lH?|
znekaR6BC3zX>wc?+`Uqh$Lnk&qlSfL^0jDo_lDG8zRkxNU~!n75UuW*)XeclTY&Mx
z1~2(Ww7cU{v&UE3LQD`=X~{{^=}t-=Grr!YQmbL7l>|h$I~D4H9-CHefaOwhN^EfV
zP0a&MkY4SDEl={TxY?bN%8qZcnbbj8w<M><t?ogoCFA{Y;ZVcgBl%ABx`#keu+`>M
z8({yCoDsLVho@GIZ?^^1URVSq-;3|LN2b<{@3e)~LD<M6XT|OA(W!Og!|keA^-!IO
zw1^+LbD%*OY1hUYhWbt9oQU1Isjl%FyFS(n%VMNe{LnoqRT`gVH^l~FYm1y0ce*F1
z?ijDLi?M20pCUhqyW9nkEzGz3VhymyL@tQC-G!-*<Bj$}tQYo)$dBS4cTsBd_)2>y
zHVBJ7<f6FOU7UJse7#*2r-lt1qKNz4rBFKb*tKy6Sal&malgAPwFN9m`ZzD_oRFWy
z1Mc!vWqgy}6c>c$4{}L7=w6aq+cw@07fv;7VUVB2L+&bwBevRoaRyk2AeY6%?&{Qz
z@$L3NoEP>I$S>j%_v+NH@tyWiTo4un$QALZyEZi}H{79$SHnp?X%ne?1N0Ol9ol#U
z9GR1=;&B)(N91Z8`gkv#U6Xe4gxi|R<YqZc@j*C5CfCH1FwjcQ)j7m?H5}%WU&T}I
z21qdGJACm5I8`Or#nbMsshPP(M<Ct{$D8Cg@r-+0YIbg=BNQKmb4GGQJnP<`IwrT?
zp-NE0fgcHp=iq=?pX+gG6AW<jMsAAd-8)nBz!IfT@WK%o`CYu=-kr+kHaScQK{$&d
zx5SI?y{RR+ez<R_;Y^79AqL(1A@tbl@Ff`FaE9C#FS!q<R^+xj0tsF?B_V%`m)(a`
zYjQgsp@bkDSCBj675CB9y4-N5Dp3vR2Bbs0>OKxHX^~ECqTw}v4Y?~`bDxCQT#Zwo
z=!Ho-=@hTKPp3+`Sx!@85JuYMo_NE3Hg!j?&M79UVYE#C5^uWCLryZ^=}R=gjF;RO
zZ@Dj~Hs%_gfkZD1Tgl(zZTF?r=G;nWC@~0APx3&#<Gzx5EVtgNN>ao4k#vc7-PfQ%
z>2Ye43@`^I55;@#8>uZI$<ilzVIW8T5%0Tir7F2iPE%44CS&B0_`rQ9wJp~Vw@o!n
zsK~$KL-#$1R<=5QNd_1dk;mdA_k+}q+;(Rm$qO?Z@}KzF{V267x6>I)3c~P&JQ1I`
zpQMKA!(FOmHB2!`n7Ny$J9I81UD{*=j1x#Vb9YaVv<SV%rBC+4dp!v^Kkez6#^|$L
zrsN>JV3Y3V9-dxl$$FhjOjg5-E_urQtfx1mG4ox%WCOf$lBdl*JuzvSdZR0l?1fi9
z@{AcO;%V9XN>?a32=8E|hZ(BCX=C*DE>(&eUWSOu43*C`z24)}rWoL@ggk48YF}C&
zIKuQPUU)qq&zYgZmB#9uT&9#DJg1YMW~l0<mFWHO)S!mvW%9fkDj5*qY<2lk4DjGe
zUND38KCMFE?h2%M;R%xb&kPppv>JV<E0hw1M>*2V3|88-I(@iXrBTB(6^SsXcyiK2
zeWY8fF^u(#<V7=B<I-Guja#qr!czu`G=l{yP10w%O`0Iw?n!SmSY6U~=yh&UqlViq
z>0<^<Lz+*Y@Ahd7aQ`DwW}vRq8udnZK;wlQ5s5YfMVZ#DuXKkrLAWE37&A~&X~*>S
zZdIxpF3p571LXi^P>)-iYJh7bQJZ0FIjsd0Y5G(zT&zf}8MYA9Y88Ex+msrFs|JZP
z!&*^Vo8AvkO=|f1l6W($38aPet!`hc0lr5h!3@WKX&w4@cOcaZA83+jhB1Cxm%h^-
zN)5s%izJz0ESDBGA>5-%Q^TK_B%9$i8v>+}9&MTde%B<$43Eue5fd~XeVP}3XreL0
zZ7_|QkmWI@1>qkjsb=_CrzKC&dBij|{FkJeCwLm5S(@+hr5PspJtW;c$+I;rbAr(m
zNb^q6HISFgZ+f<+WlyN|gwlc&{0*e9d9r7F+L#IT9#y(}qHYt>n%{<n68!{^N1JY#
z=-)*8nF~BS)AB$Or%(4z)NLmH%~L(Q)7S}39#eX7qJJ~VFc*6Erj@`yD5k3?>9&vo
zW`k!xlu=tfzI4MR{}wXPT;w^JRxzR76G-<?(rqO#n`e3sr`1g8^n}ubll)uBAak+j
zXj<Kb@CMaO>Nj)}$u!UQ9EYJ!WP|o4!yA5y3^tc~PNumgXd3h{dEd}^NtSu8=X9Dh
zA*;dkQt%DGmkcqNdCsQofS*%*N&Tko9WvBB-*X=NtN9JSmke+E-yy@y<(`XajT4Lw
zftS2*>b8+r%!@pi(wZk!HiTXZzUkjahMSjouB08CP~V{HtA0!OF3C18^<0BwtEWNR
z*YKAAT{6O4<++j80){+&U+-JG_sFZ}<(^w<%7mr{Q{UiQ{`bg8bG7GAS{wX&#lGsv
zy7$Rz=9Qj%P<d@_@bxuJ_P<X?nOA!rq;*VaZwU1DPS$NFubbC;9;J0n=xhk}4NmrN
zC!@`^o+oKx6T>&DwCX(F4l>5P-qRhzu#uazT0@?H2SMfyo*wBD6E&OkT5q221EMo?
zo}TH<#H>vwZ7|RO0m(57o?hw6@K+VJ>bG?=8EZCsdP7S#f0IvZc-t?Nab~M0COvba
zaZ^C+eOrggc(dITm!3Vba#KhfeA|ynuG#5HN*^<^ev_)7I$uYK-t6|ILVnh>N!!nm
z?<Zt}xxv#nJr4wd`hMPg-G^kNd9x=Yot@aU$<!~H@BffYGH>+^N-u#Alh{vPp!<lt
zVfK24K(V%Uldqql!2c0>)4a_yJiTIK`=&rYZ-H(ndCUBsXJmTK#Li8je!&9&PBPiN
z-7`A9ZesXmRe$vqosZ<1Kk(#0<Ti4%w!dMD-$&jyV^40nYocbezQ1>hZWqZnf9RQ%
zE=|nZZ0aAJ;@?FI%sV}k(|5pUSnRK!s{5EsG4JveKo>WEv#-Bls{dm$)x6tNnBF+i
zxH-_@J5{%vOf&EC6s0#$tlS*xADrsnO$yC>J;mwACf09OWvHj=J|V1mpQjX3x}MG2
z48t`4C&Xah?<q^KZ2>`|KEpdrw}(tOAMli?D-)YGn=*pa{Ch}|`JiV>dK-Lq#0+(z
z?o%?ue8^J;`Q6sdz6?X5|5Gy4eArW+-Z8O#b0EW8sM||snU8o@r*}>4+#JdX7W(&+
zV)Ic?ZF<<G@GYtVYF5`sO3c)=0gAnmTeJfVtiO@WHXnzR?1)L4E&2goR=1BB%_lt8
zbY@c47Sn(r>)%I8%_lw1^kn$TiUZUJT@#sOKILhE$Z!4@-vEQb-$dq`PkXkeXHGJ1
z2@LQWbo<FX^BK>!^z2EMTS5bZ2LFCiW<KlLo<3$${T9_g^>p25#AH4P3uyXDo-Nve
zhUxy#$b9p8&(8Eb@I&ecdZ+6SkOk%op55u}q^2#Vfx+qi1Ek!1(X%(b1g;d~Ky{Js
zbF$DJ^z4U}@c$V)*MKOhK8zdI>z0*<l}=U~CJfiTL1Jd&Oy(LQuv|y(%Wc3+#7xW#
z#LV59*~GoiqJp^RFp3w%6cjHwqcVyLE}BkO8dh#uX;^7l`JT^y!reXR{Gb2xJU_on
zh^BJH1HQ$UtG3RmRf$6`IhxNQI(_e1zP5Ewtw|hq1)`N4vD3H2a?N&ZYF%QGTNQ)l
z5?#J3%eOWOiNL{bJch~@yL?M6H*CE~R}XO;V)$I*ps(8Uy{&JmCsF67W0YL+pl_Mw
zrmcT!GdiHmF<2gP$oIbGN82C*78~6{43#Gy@-4UAvR$6qo@jE*F?=4;?fby;i|y*v
zuEc70AV$d(yL~Gxw{6#^_9WK3Rcb7sIP9yj{ARm>7{@j@uBP(E!@iZ4ySAHC2T(nx
zLCxnAM|>Yz{;=JedL^;LO{<lB@rZAg<(}>K)a&S6G^?=!;;8Q<%U`y;2#f4@3u>xB
zJnCC*d0@LY^-kiDTUPT0#4+E;mVa#zrru8+b_di-fq2YUYk6pUICaGQAdgCe6%swZ
zI?E&Wk%*)m?7=luq1fYFV;N~56*_i)h{vGe3yI^tddp+>(V-LO>pZkZDHM<U)>=l{
z$AnHs$FW(16%nHE6U*cFaR|O_^avWNNEChRETiq?LpAeF9$CW|5t8py%TxA=q4D#p
zJpqkUBuc*ZmNE88p$YTrJt{3`B2M_smS^l!5U<(h!L^i0JmIrg#@WL{Q&2moLCc$n
zlRn1soINr$dwz$9)+#3Pq>r_Xx2r=7(Jf%sV#UNMA7{brdW3lPdju_2ES~aNEfek2
zLaXKvd1NhLO!WFbv%F-V5n3~U*b~qy#bU2-gJqI^R%qS)AYP@zN(kB4V0pz(A}Vw+
zkL#!sQTA=LOtH@mZI~az8+3dLaoT6IOtmM5dgkkRTBnqVr+s!ym_0eP8C^bR9ac)5
z@i{Ev_A~^NHu8dwDizQ8oR&y?R%rWt6EExdQlii2vP9c+Lc8Wy^8uYwD)#x@7PY+~
zv}b-juhL^>#95!mqO})?*2?p3Jg%q8#Iru$qPLfa4$N=i4SK$eIOp?P;_Qn;ugve@
zX}wY=p7S+YrrDQ-UPqUnS&x+y=Y5+j)9uR;uiDQGda7JJ@7rvdVP6q?XZ{c`>-ln`
z-?zmw)4nS7{`_G+pjXPpeqWPimc2G~L{gAf6^qftfUnsy+rAbdu7kaJEJce0zO5G0
zzCLtpQi#_O%hSXKUyEgqoeiCkr1R3T3N2pnZL`d^ZwQ@??pkv!RzdiEKFd729Z|83
zULlsM5dA)2Nwm8|HAyC~9LrY_gFa|UvNwjtCslg`u}XzF=xenk+nYiYlIp#xIINPm
z=o2id$gpZivU%}1s#3h@+ipp-w}z&ma#%wgUrAi@?XYCn+d{LGI=pn8QYl{YwOO+4
zdqNA*6>pBi77<_gc3LR=KE&Skdxbb^k@$sgmnFyE8CsPz<dx(2MZ{&_ZcCoMJG3Tg
z*c*sb7KxXAdn^U^W1)3PL5-@{uy=_ozIIEIT|!Hv;70s4>Rs`QZ?C1;-W%GG6w+vT
zjenO=d>xijdtaz0N!Lifro1aEzI~Q*dw*y%dRdrX!xj@?`aZW**as2e+t?_)MlBY<
z^zFASvR@8uPck*iuknkCtG)x4#rCVAT}joAf!CD9;#FU#Wr_V-XirjoqiP!V9`Tj0
z%d*sd13|%UjrcU`J@G5wLCZ4x&CmhVjcb_3zejxSJ7igIzZH5VsiTpero1P9?d!Iz
zu-^{7jvh4TY1k6t8{c8eO8Z^J5%)I=)2JolH@+j5RrY(Kcanx0<!Ss9;+pTMWwrf5
z=>4SO#=taXiFnO-%u;KA7&>A>&?Z$pRz+O*^;p)}M<Voi@FqN-suHjJj$78+M}>`D
z5VFY-&sP!O`b5h*`{=L<3v`?4c%@4G)+brk+sA}WM(-$dJhqe=@}01t%1cBmH*ON*
zsioqO@1zCwKZI!(m^R7r{8HkE@00~)A;RJpRBsBzD@(;2zFrG5281OnsNbZTj#U%i
z`D6>4k`dtCwh5n3Rg2&GPFw8uu&@+V4Q!asR}<g+&RCrG$gu1M9h>OsO11dCug~JP
ztHTP>^UXXRTSolgJ8R+Xdc;KcZxW_c%fugi=PZr(X<=0hhBnF5`DMgS-+9Ys`;4%f
z1;d*H)0Ji7O<%vI$v!KrZb8sy)$7>%M8G#-*=i>dMm=~l{yO!(81P-NY_rb|YgiDn
z+3-65KJlZ^ZvpniFwX+rX8LvIeep-%przHG9M+6pjpo;}<-||Ei<a&7G(=uEZWdmr
zmWx06E?L^_Sz+x9Oq=D``Q^kd-xro$_MEV;1=X7auPe*NTfWPdJ@$gI+MWgVn^iNg
z4~U<AS1fz&#R%4J+l<ekJ`jKQDVBZq@~{C^jck~~e?a`=`_i)Cz9{U<f{xAf4CMpy
z7vEJ&r+rD-b@W;_&%jm?zxuwi9JDV(e0Tq5VFtBA{MGlhrQ5zD?9PIr&GHO>1##Q=
zjpc}aRoMLn!<z#$lojG_-!;oIdu`Z=<e)98H?SJwj_<nVxP2``!Uu1`-=J#5JHBr%
z60**XO%B;&c!RGYe)A1kPTJY93CX%G^czZz_?z#Br5Aa4CZk8P`3-C(G3@)!avFV@
zc(QSe@CLO~9QJ*0>9f1TG|8qd@*Dh0;;!!p%Q<^vSbTEzmcSdzO7X7mrlsHB6qb-&
zzeP0@`;hqE7qDDF26scUZ3{k=`cVAc_oHRd-WryInxPFd`45Rdd_P$(+1tXhlRLK1
zGnEg;KYX_=m+gDP3enr#JQG_*{OSAIqS*H#R=t0VFq2v({^|S0a@F1$R+T)oMV`s8
zBJTNqwR~;w4y#EX-V&IptP=0}Zd<O|kA>AG2Q{hQ#6BYK`|eo2wM%Hp9NdJzNqr>V
z_x)zMVedtY{E#NYoBT(_U%p|>_x8RpPqMCwepC5K{L6ROa?{=)){I61^PAXe;&0#Y
zmLKhdVM4O8NqCc5E&lEM!*a`hIjlX|)Fi*juO=S&{<QpJzZ%w+T-_9SQ&}xO@ZGcA
zwqFbDNv>~F&B8t={_)+n{ARxqCZj<QpGAEv{^R@0a@T${YycHw8)oqz6aV`Dw)|ng
z6?P@LqluoSd@TO!dtkX|za4fRO(N!5SS|6N?;p!w_Pb$$WPg(|i>ej>^ZjdiV80i3
zCwZtzp2gP^4}Jex{<S{{yPrJV6qu#diVuAcEf4Jv!$zb8HLDV^I${JE!93y^iK|kA
zoACsyP8<OqVMaPe;bT)mnhgnj9q|YVVjgph#wVocn&||kPJ9H6WJWp0;FHk+WKO`=
z5JBKk=5fb398WPe3klR3F$g@yjCPF2H7TZMIe}k8j0FE<o^njY<5Q}e0}09+aU>YU
zjB!lD6H@A%RkN{r;!&Vto^edU4Jo!}d^S}tJ_;UZ#yP_96x0iDn9bJ{kAWwc=NyrE
zc1lMxJzJ?49|NPA@eVa!h~_TyY-}y@Kky`jIrKQ4;%^paQ)|Wlfv1>>j%j#R%22aB
zn_o+e0#7q9IcDHBDZ|Zy*~(gR6d1!ya?HZ(Qi8Us2<#I=1;#S3I7r-_61){Bs82){
zc!rtcn2R^0glshs{3pcYAefozNW?uUx~(*!d?G#$#xY@zWV{)Tdu9S#M?3+ZWx^e4
zxR7GpDiG8<@d@x86Y0pp+fz(iWrANvj0Vp$(T*IvwkxH2Yk*MJiKD@IM(rrTds6DR
zsz~fp;z=-p(K?E8ImNaWC#g@xCjrLj9p(4{>P0t@{HMfI-~}emu?WAC(y^5$l~2W|
zz(i)6V+np8jhSW=TTeU<USy^_mf?XE|5kyd){9SrmzWuj75JT$p{+8>uP4TUmzkN4
zRrvjs;jIBuSuc(OlbBhKT6{!mP>bp<%uI|0lbP9$wYVxZxCMWUGK*uuD-7vakB?0a
zX)(OTn~7&Y2s6jQ;uBJJE%aN8S$qaeVdgqE;FHmGYkmu}5W(P8W}d^2<Eh3L;VsG{
z27{?gqQi}AQcW%LTfBuB2SS-7M<X7eTHO+OOR<RKKp2zkXu=ax>swTFFot**;7lqC
z#28X-E%+RY5uXL&Oq!z=PeHZthB-V#JO?6}3`ZNDo!Zet&rulhIS|QYIriX%Xs9;N
z!C2yX5XDfAeK?)!ZxQBDtoS^LW^x>zcvb39i#&&CiSZzY$#Zn$HL1fbfjJ5*jt6R{
zz;O((OAXqldK=@22|&XXIV5CC3EqakO>yD`pk<03y?8@v$Tq{<JV#(a$CNtya8Igk
z8~wJzi5So`<&J*58O`$Mw=pa60*GZQ9D}%!YTPEgO<BbkKpeBkaT#w<HEomM=B>m;
z@EWt&aTV`Mt=<-RTd|50!8B%x;~L(RTE9&-7yFEO5yUe~9XD_p2}Af?>ND|0Fr8WE
zxQP#-R(!);{xjkw@H(^HaSOka+OdtEt9&ND1ZFTR9Jlf7NJ22r#WoNxgEyF!j=Oju
z)xS-cOKlKe1~Zvej(hl>)S+$iTz&&F3B1Xyc09oErw(rm%vCmslfW#d*6|P@VGQ!A
z3|Ip(86+@k93#V3#$X?Apc=%<U^cVXF)DnlF~nyu@D0Q(fMC`+Mu$%@>U^|8X%Jrl
zB(vTzCVVndF3bjOBM}1LVl0kv;keQ06AaWwF$BzESjYHqjnU+j4g5x83V55bIwpq4
z8>@W*gR)Va0_HLs9FxKmjP*X%Jj_PC3JlCf$CPk`(dNVFQ8w{aFpsf2!opJ!6u>Z#
zw-HmpJB-s28J=zI@X_-Wn>ZCDGH!=DybuW{=6RT%2nF*Q-k}etjeegnkFtxQAc<*o
zObf3v4*BGHyqyRG3z*H08R0d?VP9aLVi&_eGSlRk6<%iy0;+c~2Z4hWW~+k?HyeWi
z{to33agfSvbIc8IFopobJG_Gk2Sx@s62m=49iZP)9AY>~V_F@_;mt^=F~5U3i3pI+
zY<HxE3q~Ul-l3dg1ju0899iMD?M4%j-{GA^B*<iTIda0gjMX6Uj^Y#}K^C*eQ4ro^
ztOu$@%tb_jY-X>cI9xW`0G>#>#3(>9`yA!r0|<&>NaS5aG+4;&cPt9OV(b8PqT&*x
zK@QXDSQ366=|kp3%uU3AT;`x-S$M$c2SOs{7Gppj)9qLhe#bZj<V4<0s6jq+#IY*;
zzHt}?5*4?o1_jJ9M{W3sv>>ROk9i0UC}fU1)`qLnf+0Si@`xHx#7M}iKQ=7{8s_sJ
zLJLgHNe3G~Ax#JA`HDx>f?}rEu_1gilBLY^F`m$Y66UnS9*(COp)jA~MI9(*`W)_X
zO_~YH^Ld`ogEHovqcJ=_tr`aAE4-)&<xIb$DLf&q9;%WsFA)o9<^l@P8PaSJPolhH
zET~`x9j)OhhzVgx;=M#1sAMiV+QPHbIv|~-c*Qudh`H?86JChaFmn>tNW2E#WfaH0
za5~Kog(Rv`d<`sSt~xrytI~#`oWwU0)4+So*N*P+nzUgUNKzWbX<!L+&2cQeE-k24
zwE){h#Dgm4TZe>9Y{9Mg0&0^O50)}F9KGQUX(6qK1^gyrI;dv8cl3pO(sZr#0%emp
z9V}yRI{L$#kqBpAfNdsT2k$dKItIgqG-Io<fZ8m+4wf^w9GAn}(@d@M0)8_w1AM^z
z;<y^#l~&yvSfFecXMh#VZO66np0xT_RWi1Pcmvchzd3G%%ScGZlc_D@8(<}K*Ksp^
z03k69$@~^#Cisx~!*MJ8N?J!NovdsTXM$DCJ;&|v>qz@ECu2>-o8TknFUQ^RK$^c*
zNT!;^H^FM=f#Y8IowT7=Ihk)FW`U2He;p6P@23s729lK~aTcg$9y%U|k4O&^R4G_9
zkpSwLN1P)gRO!J2o<cQ?31AH~(m5((Y<h@bNa34_*`S_z%sDz@Lb^_%Q<P?LHdxDy
za*m0Zj3h^M3bvIXz$eV(&T$cVx=|2PsI4La)-j`<<0CZbCP7Z&w-O}ylzGZIF(N*_
zS_q^lTSXGAXT~@uMI@xx3#wGCg?I~?nP;3+A`Iy^0Z*k`#J7Nj8Rra(NJ(!I45@qz
zF$XZrbI!<!?DP(SPE}gOIe=xxJJk_|Na-}EV%vzf0mooYeFUBE7lc%5oA@@cG83KC
zBC67d1UZ%8M$84DF)ul1MAW1Y3xQN+n>ZJ2U?w?dMbxDSZC4pFA7KCu%qvbZ!kiww
z9XC=w(Ev6wQ=D@n8q!0y8;rb<m<MdkRA*v@CtbIlHYz@G9<VcE&g6(@B(R!|7$DvO
z4kp~07Evpt8@CHa3W)CjCll$+ifB(aZI_KaAQFL#iFW2hbfs5s4;U37CIUC3b{0hR
zq}Oj(rD2em4?K+4SsWp!+qUCr6cpzJp3ytYBL)x=#gN8BA_;hzIOn2>E9o8E=`;n3
zNuZIL=3EkS9SOVUG^~|a05&nxoy#Hu>Hh6P8r3Q;0GpW^&J_`N(ucOoX?!b@47M;c
zovR}5rw?xrq$#apGH7CEIcp<EWCZO{rDFn-0-BlG&b1M$jNl!3IwgoHU@Jp9*GG)a
z2-#ss=LI4av@mm=Y{Y~N-3~fk5yVumjhXA*5HT6)$>wxyJ7EMqW}ed?foB+Z2<g;z
z(Fg#O=yXSDGE6(<bbdRL1|XB<Y>bG{sNNAsSGJ33pp{8>Hbo?4)bCJbU^|F(ATX&Y
zaBIl0?Z7jr9b!7z&ZIe8BT^6$#*o49ATq!XCd1hlk)6@8gU(QPh#8=b$#U+AC`2;0
zIRk4WGQm!Ua_)<uGyFS*4604c1iP3VXJ<rJ#?THqgKs0Uz-}hb*&R`nF}x#?p|puv
zU=LH^JQh)x5!9y2#C8(dpq(jlN)hIa;5Iyy+9_s(y-cyQH=-dUq|K1Y?<6SD!IV1t
zB0L$oHab(;DN<k`Q||1KXh!O}ITPDOECio370$s3A;Z`vWKz4tg<wCk$ay)UJ;T%{
zXY#v<9B_bH?7SM$l~LUm$W(TTIiQnS;=C5olTqKM%EERNxuA<#>bwylqs0@RMeP=I
z!9ix3^Jc^V;^7#w_}xSvIK(V>-io-A(a}a{DZ9ly(9NuH-j2AAM0;}<wui_Ehnbbm
zyAgp5f18j+?Gf|A5oVS1Uc{Y@p*A^--$N9Dqs(gOgNXYX!)<{qWsg_@jxn{)hY=$(
zgLbO2v38;m^e}6jBO_Ir!8`G6s$DDu$C<UxQITUaLv|Xn`F5fRh|D_Y=*S6~x}9{k
z(k>POiCOO)6FC{}3e4HqUcv-UFc#;yNIcWHQ^=<FiY9Q9VV&b6HJPTJayGx0C<dn(
zt8-#xd}j5|K(?}1EC#*I2Ir*6gv|P#Dhlf$N`TC4bWVvhWZHJ(6xAV?fYXfK85Ws>
za6kr%?;uLS8OG_1jLgpL*hy1Lhgb^w7`Ia$S%_8?W(wO!l!3Dh@6<=qnf{#uMeP&I
zz&WPTIW4j(b7-eb@%xB!aGu%hoDo@*IlMDKDf`57(9bkEXGPX!2JKQU#6BlzFu-he
zl9A@j;9dAa>T{6>7np6%xseT-A-fC<`Ok?8;Aem{G18N%+eI%_J{K#%Ak*qhj;w7)
zn-TLuY(G&6E;8GlX^}#vahI@=+AmguOH7+HE3!S)v`b#d?<W?4FPL4<oXD=s>Ro|_
z%6@SXxXkQv7DV=B*6&i~U<ZhI!4+n&vp7=DwC%!kr~~4=Kw<Vd%OeL64atzhA0QTk
zFPZ($MUhuBJ9g1I$^mgPxXN@omqcDi3mJ0`)=9hvzG4nKmqi9L{kw!5s#AOqe9d$_
zS47^)9NH!4@SVgG@C|dsxhnF0=J2jSj?yVE0oRyg&f3TkSwXv1xmXub1+Fv4oogdi
zS;4#UT&hc~0^c$c3I~qO3fXPQ<-3TbV2C;CWFseJ>2}k(N|(44++cc9Y-uvu1DSKN
zgG4p>jya9=D?H1%Tgasjiq+tIrqAh))MS}<%enkPVj1{>Ip=JQjL)jx9mrJ<ip#)F
zrr+5VnUGb#Ta||$BHjl9<^l@n8?tP>@jU8~_&)fN8FaQrrXU!UA&);qEC)X^mz-^p
z*;yUC={)6-xE$PKE<5)`7NYf&IS=b5J^(*6igRBio#o#x<Wb$?2jCaxs<Sh)Dr;!B
zoX2+)E5NVJ*Us+9nylg7fjp&KTmfz~*PO>9>#~COsPeJHL=CvZeCw1V%~`>F@O<j9
zSOb1zZa8}*8?r+781nhU#7Z#CeDCaw^knJw(D}+?aV5CR+;sLwHlwYVIUhShd<cGL
zesm5-3R%WILOyjw{1E)X+;U!yY|k?7k@NW@#47M7^NaIpWLH-8o<P2GL|g^#F}I!9
zB73sx_oxc6qr^wxKJ%ONMx=}u)p!AQRQw41#oTq?j2u8LEJFc*lvoY^X8v&AioBB5
zv4<{Dj*6?n1LmIdcI0)mY%>>N$B2)?Kg?gwyODt`{~n=$IwpP${$(CG??v9p8rmZl
z@W+T+@E`N9^FieOtl>R@0_B)k3m!5Loev{NWCyjY3b7ud4vb(QagB^pWe2z8g;bAN
z2OeQZx<*Bf%?@cd6!Ja98W6-j<{BL}AzRl@7b-pC8ZeR_<r)(;8SVJYh1hYT9z4oE
z?iv?`XB*pvLh86!4<2JjyT(UpvQ6!BA%C1$3;xGG<(e23pIzM^C{&J%Yr!aXjB8R<
zLUw(-st6N_Pk@Sj#x*6%kZo(nizre21U$};bA?5vAQYIPh!=@<;0g9QS7cOnc1Js1
zq=@1=Fq$3jQb!e{)uOowlZa2jlPu=aN732-cA<!p#81If>_peJsH*ItcDaa`i1pxU
z_9fShsG98I_CS#$iR-}_c9LsWR9$w^UX=+uL72f<_7xWyWzG)Xi<_tuq8U8HPI1kR
zYRC@RYcTOA2nz^ir@9iOYCYMyy|hU=AzHvVHq4bA)r?k}W)pUjV8F9%xGOD6$Tsd3
zOw>t{0nf3KuB@o`Y|~!Z#GfQs@H`vs%8BaAuHG9kDJMl1jAzxZf~cPC`n{@R>=eO)
z39Qyt93^Ml_Tt6VDUkyht9O-04ImVnp_o5KSiuWyoNH0kmF$kabg^<uw1SE3G}n@-
z>u8f|F2;I^&%lf9bl0+|K(>FcP)zlTpMjUy8Lkykce01}%Ef#yu>riy&UCGcx}QC~
zH&CqfiW|Trc9yF)Y6KP3p(?>-q5({1XS>!$si@!%yo8d)2Ji|?y4FXHr9wIkCA>^*
z1R?Ak7aKK!(sj@!iY#sfQ`ot#4N;TP0@qxEohEGHRd$}s9)(lJ4xxlPE!x0THqqsd
z(om)jxr9GW*g+_p<Z6tHr>Z*wCCX{h4#L=ES5s61Ro|g1#m*28fU~Kn(8EC4I`C5J
zjOYO2Y?`YzDg}|?45j=T!U-bS3|CuJHr3HVmnvsOCx~RTTzjGl(caixiuDmL5XDli
zeNi;!?+{9<KG6lD*&J7AR24PUA(!%fgd4=Ld9LoL8fv&BP^$EaZlGohT*sp7sGxnS
zGVCnj0UEZ*B}JL3;C*-*byoBMEnDpBjcTAm_8H3fvjh)xY^kd+%0ub)(Phe6kq3IV
z+|?h|jMmlWGVC1T1+i>}YcNWnjQfN#>YV5WaqJ@3<*0Vbv`;SM&k>E_HFmM<YE&0h
zy)RIvoD&<tG<J#WT2v2JzfV<;ohLSdcy_7lMwCq1_TlB!d2th%&MtG^j2b{7JVQBu
zp4bdtXP3KfMO~pf_R;0ad2utC!LD%Kj=GMv<mPg$pV$K4U{|{CMg=JUKB1iI7q@_!
z>?+s2s5{iqKDnIlCz`;U>}uD8sQc9LzCgLsFE)W$Y_02I)QE*apQ~tWfM^B@>>Ag|
zXw|~t&vBX>5SzhlcCBkv^w@<VpBrd?fY=HMcAaZ<^n``F&uLm25Vr!7UGEwbJsB<M
z%`|p_XaR4r7T36Fe4+7kfu=5qEnp7Iy2eLq7MebnY5oGS4ZO`-T@$0@7gm2Bpp^^a
zHZYgn;F=Vju(1AfRR!iJe89kNbWMpiEVO-&S5SV@2j;PMS6Flk;s6>dcs~KaJFL?c
z8J)eb<8!(~@rwW?vTm0;x)6B+%oW%m0l|Ehcj=?)h5pZl3TjY<Ac<{sO^dEtIP|$(
z!4DFxU;(??H6yxa;qd2y3T04i1<7oaYgTmK!l3=CO6(#bfE0GCi;Ole4Bn4dQWr%5
zq_W#wbE9h;7KZFMRPq;z?ZC(aS7Nkhp>982sazDdgEY3)l^orSya?t>>=Lm9q_f*y
zY0<($<9?x%x+LxZ8El&?E4qE5X}?^_Un1H-CcDd(6Wz72dVio&xg@rMEOw8pAi8H^
z{eIOV><eNi$Y%GtilgO)w*B}b>I-ovpxAw`^5_A?K{PDlzaVyjh3tOUqUb9NJNDCy
zlrO|xAcyUAEs4I4ED+{J*kxij$Yl?@mPH2^`u7WqsLSGRkjHkrRz%-fIJ940#9t=%
zfPD6dYgP39g~R&;i<Haa9#Fs@bJa$V$O$^2dKbGww1YzSxNB{+Dkt~={w{SzYzIZG
zgxUzk=7bzDyvtu9_5u@o(#1wk$k833-&L-NdqFYV>)H@K896V^?_vtk0ZQ1@E_*bd
zV>}?dODSRpC}sOx?r2Sp>45w$uMqn{8GFvv7#*KeeIW3zqKNxIIot1QicZL>KcHHS
zeMx){X!Zgs05as*4&aNaFU8M61v}_!jZQ%rNW)_OOJYB$WG}heqO)^44$zC0FU9>}
z5qsISC%O<BKFo`;tHc5DE~~iqMbkO{1HxkJs(1h_X0N(BqpNa;4#<o7t3)SwkNw)!
z9bJ<%d?2t`xhi&oCG0iVvFN&-pib3$*jGdssA9i$Nzvw<;7<HK>MOAeEM;%FdZQb1
zLOKoa@m~=KK{flmt1sG<qwA#KQ@#=pf@SPYSATRf@|l?5!@edCf%n-TU4zj=j<HjC
zkNR3X1eUY6T$iKUb4;D`d;Hf#H~4`4#dS5hE2p|M@SgIu*bP>&w_VqwdvfYKRZFmM
zh{K?U{mpeFTF$X`;!CJ+#KT}Ed)IX{dH_){4NLfMh$G-b_7B&s=qouLo%9mr8}SHO
z#olw>j=qlUE#@WIHR34vi2ciTH#(5x?-Z6$*Tkb>HT%GIFZxc-P^Y|vzeXGbAG80u
z9z@^I8SV@$QLc%{KrQ>w^)PxwZcvx13cF79fI9XO_sAGkZg3Y~MO_zrz#4X>dsNKW
z+>kCq6@Q&L4(i#*+@oVA<m$TUD&@L(9IRzWxyQszMy?uj74|J5f=}4T-Q!~LTw|9|
zMSUxZU>!T!Jw8U0YwD7#_-_dbe9AuMo){CKTiq3?Qoa=>u$~>`o)nXiTi>NxiVYDb
zfSG;9JtfAFYwN<7QbXbiU}49(!(vhp1k|vUA0kcyhJDT*8Izsc(M2y+hQyPAWyibK
zF@?y?V_u5gAWi{}#oYQBI@jMNETwLUr+}56=$;l+l{?fWFXe9#y#N*8xM#%F<PLWQ
zmMS;IUa*0k<en8%mm73YRgHZ|$N<H{++<9xIXCzqUQK-`$^hB4-E(6aazhRps`>AT
z(*U`q+=(%sT-`ysTKP^q4bT$PogCAQOho2t?0e!2K$@aEEk?*S9u%sn@5M6!J@MUH
zG3~jggK{<hJ<$iyFV3A4)0JC&Fi@?0FZKa9t9BQ}^yJnbR4v1PAkG30t92L0$ho$I
z_%iAT@hsq3y}LYS06|a<%lIFNbHK~SxfjJ;$?Z5uFH?RH&w)mEntMsib>v+#FT-vU
z=fNg+x_ennAlH9TSVr9x&x6hE4EKtdJGny#<z@U$q91HwXS!F#+|M087+9v<6#GFF
zJIh@gGa@hOkm`LbKn#FpcD8$Mj4Chq5dJ<D5C_0kmUOR=8Jib!$nZWNATEFwc8;5k
znUJSDM8B^D#0y{>JJ-D-W-_u&ncv5LB>cd~&U4#i@I2!o;eF~y(GLKd=yu0w@=S;1
z_xT@*K>*n#cVkR^UiG2C`^t~vAZTTi-AyqGdG&`>%dww`i$GvgQDK-N&vpo3PW>ca
z1l!p(cWX=vV!#@f^FI-nzz#OU-4>Ib*KvqmuKXlk0&Q%TdrwRua%!2EW4DMez)qHO
z?~9@H{D*|))GhG~u#3%ccg9rZ4IPq~^S6l0U^koR?vAO+8$J|RuG|tYgFS44`&dj}
zUQoB{1MFww3TS7G+)|7=FSr~3fcjay0`{`S?%tS&ypV3g2mH^30y@}IcVCPrPuER<
zp!_T<U>{rV?vH6k1~Kyo*e}GF;B&UZJs2b88M}oKs9(e{!G3m;`*KWso~c{@fd7TK
z3J$P~-B)9}@~XQ7A1J?wS3xJc#C<KMC$GL+wF3K<_zHBfOWikO<UCt9zJmHy{0bao
zm$`4o3?KxqVFmvy@ijQaE_dIGxsun>O|MXX6~6}E><ahonCr-wW?q5aCcXiO*_H0Q
zF@ZdPx3Ge`Eq()zu&dnnV(#P(b;~RG+r%|+lwIw95OY6oxI3^yxh-A;$Jko;!<Z5I
zL5Ec}*d5|J=wa8mN2*o%!H4l0>W+9F9B0?MN2$l=ha5K4@OOxBfyl0Nk5*5}*Bz#7
zlsn?LKw{Us$EYVGJDj-&`;8a^Cs>PnoEpzJ9u{h--^3wsl4afF)tY?MVY!C?jkp0$
zu~zp)b$ovH;XsY@n|K5CvK!o!)Cu|ZhgB=FVd6U=vm4!0)P{W9VSFVuEPe-0vvzlw
zIt3Ac4J-L!;(Kt0MPsu%JHO*Fy;2z#zXyG++pSg?A{U-{C3cti0i0!dw_Z)>`wt5%
zsk`D2;2hiNo~EwKA37|r<nIzU!FhJGdxp9ufB0}<rE*ui3HsS4_bhd7U4GCJ)rZ*c
zL;wu1TivAEoF9Ay|B(7!41f#lHuqe0Lw?8+!-xFu#E-zw0(YX?ldn5Mf2jN}{s;!y
zR(G<x8M*(=A7XzHKY@$vc6XXu$TuDlKBWE-e*%}-Hg}e~J>PUh{*eEJxCOpoce!)a
zUHR2V0v{@Wh_}FHc8|M2-IHH`M70Y0llU22VfVU=)pEY=2)>H?Q~Vhy>^^t7dH@lS
z4XgM+iC@5%?0)wm^_BdNBlIfePw^LUmF;vdQC~-<L-Q)^9`P&qiaqFFrVix$j|i)%
zd*ZL)Yqs0HLVYKH=!m?Ezen5#->^sAtJL@NhmQnSDfh(N;2L|(U8^2Z5Oh@a5q6)r
z1Fo~j-D}mVg5ab0N7Q}s4)~UpQ2o)^f{>$zkNEq<Z(xW$iH^Ss1-hg3N6LNiH*kaP
zb#G8lMqWqrN7!G)F!+u=jVwEOf$^yD5%rfi48CXk&}XM9FddaY;{PJ<f*;s(?nZTd
zLG{tVN6KH~U2v1_cQ>gM3hIxlR%3q?zk>jK0Tm1y3T#L5)zshO@8Cyv(A}y|K>%pO
zYW{EH5AYLv$=#;TF6cN)uU7sR{{Xkx%kDkuLS(Ttuf`q_e}bP`#l25W7x<3~tEmU#
zpWqkvs=HHNRWNi^Ud=xs?tx#~uif41nu6h@fz`?b@gBI%UUMH)*A)aEQ+<s6L)-^<
z*l*pE+FTHP4F8z=N4yVyV{f>7)eQw9#|$6y{}6wHVfK4>pW0KPJ4S!3{3HGa?y@)C
z{px1q>@<Ij{Y(4}erJDl52}R%<1yi5>R<71@CSR#eOcXJU^*s$%>PR~0DrQ-xUZ_a
z3aXC<K34t}AAo!8ZTB^GPeJ`LRW0@(@ejDq{^q`+mJ4jh@LK9W@gMLPd)IwaJ%ISv
zhFbnV;$QGL`-l6M`bt5^F}hayPy81=VDGtatFI$Nsks(=Nc;!>VgGX9RR;?E$Anty
zq4*#8mwn*Ar@m7#bWE=09}*A2f9${R2kQF;!^Z-(%0uxXc*s6<KU9w>4C+zUVI#;9
za0K^=XQW0|7~F%`Q6r=g@DXmLXOw1aVMvdmjvqlj0)x26Jfk%e3Uxhnoiajt1dilJ
zdB$iaBOj}|4ts<Qf{${Kd&X(-LSv6mM?E41!N<7Kp79z@p{Yl%;~ybM!vAqkc_wP&
z3#)qqb;={sNH~fc<C&yMD6H>Mt-*rGN1=*)#xq4@D75w9Yp5XUQTRBA_{5qNg#R|I
z;e*J>;1e9e1!}SjJ9_9fN|5vz9L*tmkERgWXU%J{k>vm2lN>73*U*Lj9$^hNQu-f!
zibLJDnySK~9(fHvk{kt}=1|p~rnaVVxF@hi87Yl|V>nd(qNytkI<Bh69wk+9EQgZV
z8gpUralD>-R8qlbI24T1G!%v$H`Mcwl8?h+4*8Tdo<iMmx?XuydK`}9kZnlQjBLB+
zdh9Xs3HU6Bws;z$(0E*^ryi4@fX{JARMWH<nvTo${A1*3_&kT+xSFoQ>f?cW<uPeA
z9M7SzoTjI+{<vx__CNATIDyl8iZybf?Kr-c`k(Y9#5ldDTr+_1=Z3ZX|H!A{3tXIM
zk>*Na$8mbC@;~V*IFXy?S)#d)+`{Iy*eLR8_#!vmvrH2x^dA@2Qlq4&;Y-{M&kD_*
z!lC2xT7DEc2ENSA^sLg{FC0D|SgVYZ#=uG3EKjXwL{X5a`UF#vW8q|Owr8zIRTM1Z
zpHM1kEPRC{J?k}Ni$X-hC%lS$28M8RJgjCykxryPQB=}1a0)lqvq3W%nUu|+V2_i*
z@KtV}$F9MPjH2)f^|%xar*erNw?<QB66H_$$H{RpluPn7YT}Ek#lR=Z<I*@7#wB~2
zGzmrZqG}!X1o<q)xl~k0YACXa_&Vwd=~)=grFmL4DMc-!VIBVj`5cVkGCXaX?4k~l
zUZ*@EJqIJXEYBWIA@W9>*I}c{=V25_dG=}OBEKlCqee^5!)PwY)2XQ{8WQDo{AhAK
zjN$S;-I|)BVKJ~y87+;6YOcU@OjB1BB&j~do+Kwg4OirmH0GjU3ICLOQknp@T(PHD
z(@+#589wEoBr&MtN<DoVPmxZdKUJQTFsSFsJ^h+yWXU#viakZX0Asld&!9#qGD^ay
z)Kk(6FpgW~xvXg~GD-5M{8Qva_!_s^b5+w-R4oNQRi2V2!fD(R&oxa?QN5&Ek3CJk
z2;;e>o*Npu$R^?Isi&nE;dE}9=cZ<$s6{fY=bt8Dg0FMSJ-0MhiaI2Ez4Em55}d)U
z@Z8p1M^13_dTb2&GJJzu>A9;36!|4#JvByp8P4QZdG2ZM6b(u8dVUN!3BJj#_B_zs
zFB+Bt>y<ImBshz!^*q#!Fa@1ZnX$3tWSGFM@r=}}Ou;8`Gc{J43}<s|J)^W^O(7=?
zW_~RB3M9C7p3&L~Cfy0ztc;ajfh4!yGe$cZ8PLsU>=`lyzQtKQ<FvTRctS8!&qyI~
z4##@NYc(d*3E9j)Lr#Hjb5_qpZM>=aM8K>(BTa#GxecC4+5}Vm36%v4CSQdHZlh<4
z)?l)oz%5j;^eUXk**#&}6jRFygM|+!r^0tQrzcXIZR$8dTa;jFDoo_u9<{a*`QFVI
zY#bR1=X1PAucb}?6M}^rCxyZ!4ngR(wN<8}6S9RLM~1-#9HOvmYfQr@0v2VQ6b6$y
zgdx|~nSxHL80=XRhbi1v52-bqf=}WM^{j-$R1SftwGF0_lLm%=mJEkR4uP1p9+U1Q
z%_z@G;V_LuBw}qd^4psk>^U+5rgI3zs})SflLA9MCq=*v4zXyp?IzPnnc<%!BVi_o
zSghJEQ}xLJqdX@?!YmHKNVPqt`jaXad!CGf*&L#AYGsq{B+gRLOHq*G5ROtiU}`yO
zVEO0CXt<C=I7aOiQ^!e~Ri2lkVGf6Qgxc%K=5J=P@nj6l<q(ih8!-7#3M@5Vih+3?
zBGPH^n1)WuEI*!9!+Z`A*|hgf!zTl*GG0={0uCX`v?GdxPN_I-0;z$89Aa{5RmH)l
zaE_WFX<!kDpj6ti#UZB*96y27LKBCeOxg*>x>Gc#Opvs&m_t+|?PQcLFmo72>R<_n
zusmA4*mz3dC`{79QVwxxw3=emDVgIjQV+{G#AVUO7gwJOa0({rVL6AuB-(`H`co<^
z_5v9TX%3M&w1#5aDcnlEAjQH84xuTuDa9?P3|9UHG7eU92+g3)F77x*Ta_22IJk&I
zYyxc|3N@Im*hKO*_%4Ua`L%Sh|CC^*CQ7ft#T;s<*H#q|oszBmL~<H@k3;S3+M43w
zQvs_oQJMyqaHyVKTUQ*^tNILkk&K5`9O~!Rnu~*b@z1CirFgiMLj~2^hT@Q3!)N@9
z<aAigp@L>~`s;e>&y*LX>2Mi`8j7{eC`)1f410-u9lp<@ie9ZyZ0r?2qh69;hs!zC
zQLAk)HucJ%@h_1x;0GM)Xw`NVSN8@!Q(ls0z!e-SDb@BA*Y~P6U@wzzz#0y<bZX^d
zTQ9zWdRck{uH;ZnrFNjWrPr{5f0>*KKjctNqxMR1M=!lWd0CnXS8=GPP<tIkILsTc
zN#vXGBMueyX#>UnUSR_@NqQ5m=1^0e_D=Coue^buM9zXAbEv6Jd%t+NH?TpOB+Y`g
z9I7hQjwlI|RSno=G6B|csH;n-DhZbH25PdD0M~G+tV%bwBt$ke@RP~eu%1I@O}Yss
zI+<=zCQGy7S`M`p=_aG(h`9lKg(To79IETl;Uz{{XrNw^2)K?zbu~IoiAk0l_*Y00
ze#)V~7F~QvwH#<rUXe(+o<oHtx`dK?S+x-hA>V>#4mEb@3?()h-$;c>Z$S%(8Y^@u
zB`vaHBOgM}feeQ#8+6$v9WuR936bVNmP4Hdx<V9KF>l1CkZ(hdL!o_CBv;~>g^kn{
z>1}A`P-<OQRWc;Y8~G{ZT=*G>V%xf!l3_WpQJEsmg&R1OTh`T;1f5pduvbX~Y~WCE
zS7$B>K8@R`S0w}7$f4k>uAwC4w86%|O3s5e4kb5ro)X<@+NQiJ&4YFhMHh9=C@5pL
zVN=O>po2r%J)KZuJT2I$snR>p$)W6;uD!%`TDI|1$wcVlP<Tt%RZ@LAU{j__iO|iV
z^pdWpr2e$Zj)ju*p@&299i3caJB{0^P-#BoITT;f4V1K;HrV-4G6{M)l;6-@Dd{*(
z+m%o$2{v*lz@WR1@;PQZ7Dg_Bn>gg)*9A)arv*C|CM|%QIpkp1-6<J5E!+7pG8t~+
zkcC@!zhwAyz^;Tz$*_q-9%kK$(x5Xc2Zoa=u$e<9UY)8m_zdo#a47|D<&cS0H?}n7
zjKRU<WGZaokc(3{p;UK<b||=%3b%2{#;BW&VnJpH7ET(Wk3&8_9bRfYBRHsV$p`_5
zd~7;Rsp*XD;KRu@2svcr(#4lnp9wgWa48M8a>&V~ODL^BqjF*qWI7Z$WaZHrN^NIw
zClw*3!|fchvglGuTh17qd<2;RcW}tdq027qI72&?2q^=$amdV|D@17|vlELXGvQ7S
zZS!?>ssD`Nq#~tExQj#EY+Y69&>7juN0M1^H;2}_x|-7AGXbX(DP_Su9NK5<>Pmz9
zR4y!v%!ch8TIlJ_rNMo;i;9x6;a(0cv~&%nA$<lHA4O8IgF_n~ou^dSN4u0LiGuq$
zw9?QuqY#wYg+-GK;pZIE^mRh1u}^SO(b7V=pF^6quD#UMC%gD)G6x>ukf^KcDy{Ad
zxRhuq2X=Bu)ztNr*7vF0SPYp9yEr84>Eu#dAMU1Nq+EEAL$a1`ptPmW;O1k<Ja~vh
zx{mHjX-6OJR$`<)*v%nfLw6lzugq>tP3FVH9GdKPfl_~;;HK14K0Lyq$yRr#bf`~u
z^J=mH9_7$zr@LP|+!t^wYN-Go<IrrQ8&MW?R^`DoWFhR~(BodODhob~dnk=m2#<5<
zajPF&7IN0$;WcCt6gl*|(@!YVouxgBMk<05hn_e3$tdz=_F!7l1W$12de`G+#<PNl
z(n=<Hl0)~KUQ=c|D|>h?Sqx8c=z!P9msOt)coeNv40}0r!s!#r>d&fpOh=YLnM1#D
zy`ju@7UwCQR02<P=qs*IDQh`v;CUTc3eRxpGuCI9b)2PnMJJWQJ`Vkn`r1O2G&A#<
zo-BiBIiA<+=`#OWfv5CR89c`|^3(KHWkY9W^e<#NJkM?BXXtCnhR+6gMK6`Zey)k1
zrLQXsI;Zktu_O%#xUD>?H<tyU!@X3jM8gZ*Hh!+Yp)BN_!OO>z70}NCK2h%})19Ne
zN~}}?2f0>0S>KETZe}kQM^?g%+;%=qFO(V230^8rs)U!gHa<(=US>Kcd-*tW5&VMN
z#pmd|%Bs%=yh@z32wvv)@CEvwviftXM(j26U3i7t%NOhAGTS-4k$O#f7b@I7zFa?0
z)^g6!$iGG|hF@~~`9=CGWgX|}M&&hWF}%uk@=NsBQLfJ1h)pBkgI{q6`DOY*ng5*7
zNKKR8gI{yq{0jY@vY~S_`i~)(z;C!C{3`wZvf*=qMrE3`1YYBg@wNI9<w56Fo3MDY
z3SQ@q^K130^5FCMCMsU4g5PoyDtI1S9&+BWiH|3j!XfS?5_l(+>(0}glz3?=yutPI
z8}yS=oX@-on@(24@3_;vU5}R=&kLKV=~6ZPp6f$$m8RTuUf#q{Czrt=xO04?KEAyA
zd|;C@U0Mcja{YXhKB2t+ylOM{I{7{fa2F6D!BB2Hk8h@4m)?gza)W%UKBc_nykRr{
zI=LMF#9iXs^x5Sd=jqML>(X*~i@VJ4(HEi=p?NblgZu#g%qjdnJzefUFKnh}NFTso
zxT}1pzN&oayo|mV<O=vJ_ch<GuPGlsAK0wSkXFFk+%^7~zOFo|U$q5$gRFsfxNmt$
zZ!Qn+$G1>#NHy>`?grnhZzvDxH*DeGAXma+?t8uujhniDdW-Ugv=ZLsZu0&5W)xmD
zZ^34gAHv_cANfJOP;TrOwoo&r58)r&E&j5;z1-9<Z{cT>tKgs9FZ@+~S9x`RV2d(S
zS_SWMxA|-Op7Q#BRTK6m`4PO&{l?$W%jLFyyoq{K`Uw8T-Q{oU2g+Oe4Nd%;<ZAdg
z_XmGVf2F*mpKem#lvcwB+&%ub{yNG`nwzj$<j3$I?l1nXK2YxO7n-P9(#P;$?g4*K
zf2Vw?Uq(L*vKIcw{mVbl-!C8T4>T#Wq+0lpd&oc3kD!AFRLxidSqDd0AMuWiRnfr%
zcr%qC)xk%sBfX<y$I>AKhGss2Tmyrwk9kMOPM~!IbhDBmt$`!0qr78cC!?sQxfz>H
z*271wk9)_(;<Rx<Xr^XM_3$z4Xz%z~4Q(2boB7$~TKGTfQ{IWO@pSb-pjnwMt%akk
zW4x1M6X^N@)mDrkKY=RiGu|n&2HG}&Z>0$76Zp7woHr~sg>D%zY~=}Z9el$2oHsJI
zHk<AkptmZ7v<{B8j`yl#3sFSWycHwKPvMhR%&U*3Y5#z*l_I52;ZxR$-f6K_^w5Be
zjs<c(eA@bwcSdXtJv<QDs*uupIL123J1e%14!WRf!QLXxaIEzeFBxm5gD>DM)LW7n
zK4YEYog3Rghg>kU@Nbb87;K&DO^o%>x(jrR@|I+Q<E&xc<k)7EOf|P)b4Uh0YYq3N
z#R|0Xg3v<Ekr?=#HPV|E+fJJ<$SwRFl7-J(qrEw?U3B$@K#MX*V&QnJ+FKCYL)TwW
zZNuIsIXJ<p^%lp<wCw`Eje1++AZFEj%VP)VmJ5b${M)1zzF>{>E{eTEcU+*iDQ`<w
zIMF)IyCn8H3dEYXVROmP;EUGj-es`?+J8aVM$MHzgD+WUcvr;Up@%NW=u{*(z?ZEv
zy{lsH)58}6+myM|1~|z&%Uc^eq9Vwz@?i$D0Zz8g_O6XpRRsHSA7zjl;44<ryFPYo
zMTp<v;|=6S7-F5{Wn(8)==`)#F-RNX6zg2?hS<p!gx~DL=8-n|s&$^%9*b8P{eq90
zC)wasYoga3tEn*gWgkC}w8KzqlD9E7zM|S6@G0{oI}EcXdz)etD(d|zfW1RHAZ|@X
zKovuU&5r}>9mxU1t!duY*p!MEzX9;?kWLt3&G5FxW><9hX`s9#IbozV%eyDG5XFDZ
z081oYFv?1K_r=l`e!l>yM9BrCtvTM#*s6*lzl<&g(hXy*dEV~Wnu=k604Rx)8>+1Z
z-ea+K6+we4h|MQGP-89fO0njO;6WTx^Cb_|T8q8Cu?-a=g9gaYCwZu|mU{bQJr%k^
z8Y=T89_p>--u~ETlsYy;EQ$2OSZjrMFjlBA4hoP;lDsg^y2yJuw!OkMC__GpY=o~_
z7kjV9c2!gl2B4B8HNt7uCEjbXJr(tXs#a_Pxe3NwmwIo+$`!Ujyp>uYZGzLS%e*&Z
z2P#?y4XykFax;A0y4-s!_DV&^Al<4gkT$~^))n5{vDZ=9+1!dHlUv{$)|KA7v4INz
zpwLPsOIzSf>niWP*gF+NgEG1k$tL)wb+z|F?EQ-2!9c5$EH%Md)>`kw*b$XM7gYk5
zLN>z$>l*LKI8|lvMO>g#q-HqVy4E`?Zfs@9MT5YnkXs>PUFRJgH=$B@krtE`X)7eH
z>%C**CZmkCS-?`s7WkIc;vE-<R~j!00+lMYz&TddJ3dZRX}Ty2d@8vOzHPO7C&tBB
zR$mMVN~*LC&b4mvPKryYtiPz*ju}ZGG*~x!r^Fd5Z5Q$Flu`1*c~-kOEUq@CvgM*-
zJ8vWbe8=kaM#g1Vc3h;lD@F;xM627Yjw?jjZu535jf8N%mG|o7=t}=ZVLO#3L6~H1
z^iGSbsvNo~qc;KB3Kv*6duPPeR1RMZY**5xR+wyU^3IB@s|>oN+JU8$0!*=P^^$Ss
z%HT`*4k}#|V5)VScWzumWymGN4nCdS4vkjeO^owY>Mqeclyqr3OtZFnljE9Eq};p%
z%OH2abnA9+TAWa6yd><PGNc_a!`kM}ifgYlU6Ob38DtyGwC?ie#C26xUkdC{GNd+`
zW!>W~i0i4WzocrzGRd7V+q&0V94A-WF5zudrnD1M)_vacxPi)+ONKT+liURtTK9Vw
z#a*fFxJ0)pnbIzpW9{@ViMx)H?B+Hsi`)%!tp~l!;sTZaOF|o!CGCcJ)^6{LxI2|Y
zmt^!LBKN?2>k;p&|1)&<0Zm+4AI6{(L<NIZCf15rYpC1R;wyyjz#Z4HZdZ%#>cs78
zal3}1f<XmD1%gV@W@duh)qH=r&AqI(BG!tvR_u&5)LId%FhK=_N)QzcDkv)N{hvR8
zWbWK^&hI?W!lBOt*ZhZt72HwxYW-PL*}|Ya(RK0H#7a=-UZX!}s$3|}lU$d5O|9hW
z+@I<>Y?O$|i@C1++PD%NbLZ&K<B4)qUfgx{*TPEfn0u}Mf{9rejTh*3UlSClcmGr0
zWZJ(_mY01UeN9nZz56r$Mbm+W^Ye19d%iYO;JEu=`b#GBLV2F%y8ml|;*Pu5=`Wk?
z3l(|V>*6DX3ViEU>#tw|lQOU7y6gz0;=Xm~>aUvM!ex1`>&hcW6*%GkTz}1Uc;U*t
z`s?Z=f{Hug&eOM=jxJn-_x5#1h*jV__j<ixI=)by*K!>lp;mF<xi{$BO(z!?<oT|9
z@Qo0hbZ^w(G@V{poENz6KO(H+PP+5;9j3Dj%kxC7;%|t*g9dkj{<eu*sLPYI%D$og
z&Na9<>AOr97P5IUt;%nVe+Q@B8vR|<Mcm(xYgK<E{GB`HF4T9ME-!RoT!8Ky;uG+_
zd$YdBbaf%h%Wg&AP@iz$ySM0jO|1*-@^V@|-xxmur`=oi4^8b08}c-*{%?d&xYO<;
zeV?ggVPl@QReY5A2l&BVtbc6kTIk8EX_XzN{=xm=F3}H|x)(O*xmuM+jsE~=+}rd|
zO}z`-^6FdFM}>cIXWXUwK~vwtPE0A#9VJ$SAKlya&rJgh{dp~|=qR<C`_a8aKWrLY
z*q`TX_23IJIP2c2e`Ok8IFuJ?^&b^hb7$RU`VrH}!l3n{HgO%X1~j_M^`p$e@#6K8
zHd!6DhHG?J=!4B6@e%7|+LU$1HQ=0Es~=+yi;r3#*QTx$)^O+CmHH5KcziU5Bk1ag
zPr*;_UHVXSWV~#Bb{ndrKIMLL@79Nzr^e4;pVQ{4Gkyv<_a6NO^R#&RdQF?ZPWY7L
z+*SH;^Ne`KdTpEd7?A^bw@yFFJS)CTxxS`Nc8tp5cz3lv(mW@A*?L!-@|ZCPoOkcl
zPchGpU%9@%O?^zr;m*7F>8G0K#jn9o2Hi1YE%@2}g`O}kh*z&~X+y`TwcO8cy?&ZG
zA--U}ug!xC0&u}i>!+KO<BQh^+Wg0awcG_aqn}|;k1t;@62$eyKY_>1>Svlkyl%Zj
zkkwQF<UDSJewKN0Ji9(dP}Up&37XtB`q}0s@dww(3F>;`pInoBzkZH+X}kloAawP_
zXW$q2zxA=^<?(2Jwt(uX&$wUQU+U+YSH#z?&k;QJ#?Qb-_kZ;7nODU(tk($sdf_wf
zqWge;o_TeA<9e+iK2H1#{OUfaf8V?|-m|_&kR7M~#r^6w>KB;T#W$~a3CiQfe}PMG
zlYXH&FTQPky`VlW{ENHfHtQ42`SG3We-d=ZiFM#Nw?&_5E{ylDZxPUOY905R+p14C
z7sdCl_X!?c4}r^Wn?BWC8b7o?Ao!09>$uBqyFT4q79X@h<Q0EQs6n&aq0cZ^#)~&d
zys~d8HP`HR>Vdf`K4L?RSNW|`4X(Id`bFk_@lhM%yy|ZSHFw2*NWa+3#7ATDh3;D-
z7qqzltIsm;kC$!8_M&g8T&~6am41o&K>Yj-IbP4V#$0gK?bd%_Hpk01XuSS!g<S5c
z8|s&u?eU5YTCey7@j3Y2jr1R4VViP8jaPPp`kedSU8`SihVjcbxV*{}#?Qeu_y6=C
zn-9mY+)(dTpAbIhuDK8ESD25+uff0#-3cNOTz7x1r_9IW)f-y8=meF=U3VYRuQH#E
zFWBJodT==iTHW91KQW(<FWwOF`cDXXT&w%2ezo~*eE9}ZyZAd|J!o^+=|44d@wyF?
zcG-8-daliVOuyEAA)eh3)2{r^xE=`Zdi`hSi}43H#I>ux6V`Kr`?!9c`EtAib3Sz6
z5gUNl{jEONd^H|z$Zkj9Q5!g~`-DEv+!|lEA*bE*opA$bcYmkfU~Z3Z*q~|me<y6<
z+TADh`R0!J#tqtb@kwGMxZ!TlZ!&kqdp6Xx%T7`oxf||N`a*MeeDelZyYi%QBe?1Q
zUcbfM8{f8}zFmD%*vQ><pVk+d`{Fw>UPO12$OpIFKj=%$1M&V1E$!$emCxOBpV60^
z2jlxU_}V?V8U`KiAN4!T!|_8K0`2~jLO$2wKC3S?kHiOU6x|Rv5Cx#q-KeiH2PcR(
zN^Zy+r~<CjeNJC#4oQgE7;{6}U@QQ)-9PDfo5K>KHpbmhHwXpXZ8xW{GKVKbW2%X+
zf!G9mZeCw)j!ckk%)Wsds7;*DeO|xMJT+nd#+)0T2ID5s<^EZ(H&08DZ`9oIHwc@!
zF82jJW1f*vrr4;xAwETDz#X?oZ!phFP;RWbAv;BBxI6A9{eJVDgk>9DH<YK08gSSB
zi~dXV+=P`I>u;z}2^#LM`=b7Ud0xUAOjFUFA_~Dh_pf?fNGGT_w%kCcs6y_Z`;y*l
zPDm)&=)2*;-2l+-{!MQ+Cnpqd4BYUa5(>F)_hr4^oSsm=QFK%MJ+T@1-OYNZ86@a7
zN^Z)&r#5qb_Z9si^Wp?{W6VwE_r}ej$K9g;%Dg1u;KsO{>hFckT#x&z9-5aXI55OT
z_dT%%+;{)3uQe}EKpV4fqVK6K+<o^o{bBQpgu0D6H$C4Qw}4*vb^Q_Zs)UA(nw$Rb
zg)LmKyH$VGygH$AqxPowG_e&taJT7?nb#(GHrCvfou;;O58Q(OxOrVd^G4TA<!R$q
z@X+nmpD^bov~8@vsXi@i<sQ1*^(W2w37wc7qdQF$fk*Be`cvk@1pmgCo9HxE#65D~
z)SosNCG>Cf-SpsQ2<UU)(w{MxCJb#1-1MIoinu;^hyJX&EFmagbW8jLQ4IRso%(a;
z$^>z~<d*CQs+j9{-_~<jVHJ@db4&Syu^2pd`}F5=ge@vR?w0xop_qH@?$Tc{GYQcc
zS)==bC;<WY9etB|e}XJO`xg3vD&Yd|yZVbbp))@}=a%OOV+j~=-_u{hpOidbbIbpO
zP{IwkyY-jN_5?+~_Llezu?;+N`}J3_;8B@hb4zxH+QvO`_vo*hVZyR}*Dd84<2LZr
zeP4ggd^llce*G==8DSgu)ZMFZH6Kk_gGo8MGejwP=6;|T%*PYd`7O858LE_f=6<Me
zH=j%>$oJjy;9d|IbU)JHG@ni=&JW!3pAkyAL3f|N!+bWOJYUoy{*l-YhTQ%7+h#67
zmoMp%{YY)+hTM<!UFHi3Y<^6K@<-!#@Z25H-!)&v1NFEL^^d}K?zwwF-)+8};J|<$
z-H*f$@WTB>-($X-fbz3D(2vv(?uGlQzSrEEP?w+6;rY?H0}Q*L=^vWg6B_b09sVDM
z9o(>cP~T_nNNCL0c8JdsJHbo$kp8i`E5Var(;+)c?c`p%pX&$A-3iV4t`6l{<4*9(
z{X+lL+?&vrU*DlVE9~T6xrg<G=DvhZ%mvb&CCb2S_e=eA^FV?>zoi46rOLS1?pOL@
z^I$@MzOTcBTVY_t{aXLZJe)9;AL#I(70S2~_lSPPJdzMpAnFu166GKW2GOG|!E$kd
zq*K;Nm2*LG6dh~{kw+B7bSfK-<zN&P(PJ!O@~DEiPIaSD&W(b>bciKf9*uECx<;Y`
zh~Q{C)DkI|6=Zj!Myi4n!7+50WvYCBK~ATq(O3b3;aGZtWtzN9UZCmpHwqP8Fbtu?
zEi>eb0&S=G9H9lHp_raznI%^i)O5<uQCe;^45cG2bL7hkT%F2uMlBcv$I(+PbLA@w
z>O0lv1T8lPhS5_k^W<wV21$30s03r-c$%;*kgE$?I?*|*k{b&r(9<jl@`3_irw6wJ
zK?s~kPq!q?iwgps{&PYl7XriS8J2W;d4cG*_$Oi)5W@(1rUl4#1(MscpQv4&7*3*R
zSr*ILf|%RNpNzXeD3s8%ElcDF3*v68e-d_ap)iu3V_7P9VEU5oCt^1k2Pf09mgRC(
zkbN8dMD6Cr!721y%L;j2LC$T@PsZIK48B3XXIUk0DA3&Y|0L|@!r)YTo@KSXu|RuU
z%n^IQco;>$Z&@q%6x7_7anv4eJS6A^mUZ&x0@rONXWRoOKq<Y@k|%E~sK2e|ggx8@
zIE_xQ<jXrT^hw7NRbV1~lTNf0%KZf`w-HBGaTDQmI@wYr?=SG(_TWw^2#0Ucsg_dt
zP(k3fpA)LMa5#fbx0K0)Hi>*<p3s2^7)@tbD&^u$5}%BxbX)|SNdrrjJYrLfPstl~
zU=oa>7g_enqc+9))V!eMCc#<sVhbaW-jwOn@kBL{z_;lv%YM0RQ??KBR5d4ov*{(4
z1M>Nsa(o`%SPdfKJM;$@vs}JO<MZ=EH5Uoz&`T|Lxnh&nCq7T?1(TtS{tydcm78jO
zvh&nlZZeFems_BG*(R4ydEU4eOo8vxA6pK~S8l5Jsm}|0xhZfiy~1)-z6K+%bmxhE
z;0^c(nz9_1t2edy(0OVf_Xd2AUS&BcFWBVsd2k~bOoe}>Ke3#a7jFvq{O5&z+*CM^
zUTrxmFW)5U68}tm0ixi1`cn%h*KLw?$$qB3;G*FB^jgaWIlC#QOZl_$3qZg)`ZLQ#
z`N2(bUFx5OFE|1&px0S0%N>}krTdxC11bDJI@fYljy7d?p`R%|Cxr{?JWH#*Zc|Q|
z=Vv39yTf>TgQZ>Guu0S9|5?B?Z<s*mTRP;8o3vfx3k0?|Lpi<4(k1t7s_Bwlps=kM
zCenqLZh7-2SC{gF5$joD61~OJD{tFW-=)4FU>zq+ri(0n@=gr&(p@01e-Wn8C6)oX
ze^W~rx<Fyy9!#Z6Eras@O};J<?t_CFFpb_}8I})i3Uv7|2w12E)9EtHh&)Imx+C@w
z*q{UzbcH22QLK^Nk$EU=%z+tnr6nXWLKAaG=`mtO3e2Q;Tf!2fG;w#-9sw&cAfT%(
z;fc|hBc}5Z1`q>Dy4n(%DAQ!$K^_V-@8KePpJi%d*?djT9goL|Dd+G{wB9l;QLfS4
z@p}YJwT6pn#xf&Oq0!zEHxU?P43)IOGAmK3sktL-qA<1=X3_gCa}t+nTz8aBM$9RN
zf2O~*%uQUWslTIc5-^t%E};)t<|VGd{4!k=fkA}uFSOCJAW^Mpxr3T044#7@&}K_Q
zVu8kY$AjkpU=I8%ZM7sP7Ha}`{7nKTOTneI-IAVIt`Xf8|3YAt5L`w(Eg(^+k=&L2
zLSb|a{E$9mS)9mfV(uz`F=AE-%%;DxEJ-}5iMy-*MZjzbxSWQTrHKxVP1F5CU>E@W
zh_1CPPehvRyXY4RFMq?2>BE*4iFKNsyPjW+c-t5LjXq*omDr%s-1Yw=;O$Phf<9_l
zo!F?+-W6XY@H!t{NguPUP4sAL?#eDwczp{}^l{6&#Ac1_uJWQ0@9RJneZrEL*rut!
ztG+1U{S3H@K55BM?8LM--9-Wi^5Ng<Q<lO+zoz9bx=7&wHvEJ>Z7E9Z*ZA&w@E8Ql
zga4q<SV|LzG=aPRivmtq!qxOyOIc!2q3E9YR{|&M;2Qdzr7}@mD7h#5mBJA!_$kd{
zXJ$lU%su6=MjV-eIrMp)nU5-ryQltDz!?d+mcC$N5~DFBPWLNe1aa`6bdzO&qO36c
z9{QESLs0k`ebI6taeiUWJ<qR3JoJM9qAyv@iSk0tJ^!x)o^rr-^ks`ZQBkP9C%#1B
zt~ONDSFk`@Sy*#Vc8S7mOqfewwZOz>g|2(bOGezbf}hjZEQb?U7S`WWUlMSi0_M@J
zmZOPlFq=+yiNJL!Tu%#@<B96RmV4+Dg$oh5fo`{)Oe`q$-Sgln5J-R<>6@0*iN%G1
zd;UuTzG=XGy2EldvAj^!E&h$bZx&cU-?ngxx<W~}>^BM@C2$knWx0^Z7RGcde>38*
z4%E<hEf*6H7RGg}e-rS}!a};+ayij~k$Ae_2rEc}o9Q0Q)kIX7-Hm>utXvY@Libu)
z6YC0dx;?)ctsoh0r5{?_6B`OO-TvPME0+w5=srtFVq>AUTYQ<YffQIwKeluwdJ1d0
zWtS-%mjX-Z0ZVscbD^tSdD&<Ksc;+p)Y6;SR#@MyzAV_dR9H$6TKW<@F^NxinXrR2
zxSf7(8A$XOwsfP*l$}e1JLqA{U}ArvuiJx%U?3gtq+eNv6Nd@|-TupholA#h^oV67
zF=(^MFK#9rKmp6?QP$uj@n(r%)=W7#1+1WhtszMfn`8XSW}^dSKrKDS8kQ8bInJ+c
z793m#tfWJ%;YraL0H|vwoFEhKqC>5bNoBIl*?!baIk`-@n+~&1O`5+s$M0!2Ist%t
z=n2+oN%GAazrR^<asXD*;no>Rip^TT_zK|yB-GK9th17on``{CE0l{PVKp6Tos+a|
zv&*l%VswE;a4$W@IyY(M=6b*Sis0fF!F}{p>%62j7(A%ELL35rf?v>tbwQGPbBiBc
zp$>6>f_i$IH6f{Bv(N9rLqM<?()4s|a#Hc;fZu;bIK(Z63_Zh|o>abB)FW;o{tJ|l
zrDx*LShrcyBWt1l%PFCOo@HH}#BPr1QMMTW3$kDhJ=?k@>EPzL9(9ZGUoH#or{`Fg
zCOI(gP}f3y1^x{GO~+c7C!x*RJ*b8Hiu*JClAdc_kyN)ir^nM`{0c0A|DoTru1ady
ztm*N$2w!na-~oD`b#+qXW^Ir7D&Yoyfd}dLt!tA!n`?SxS1C957igpxSl1;rZ+7)4
zuNvLp18AZbTJw_HHrMy4uL^GN18Albtoccu7_+FmN<i>eXrU9Wg-QO+Ej{Qe1-ZXM
zE1hgDO6uS2>+#?jC|C+@bgH#9X=rnx$A49T+)`+#)2(GmL0d%k#lI5>EQ1a@!&;dn
z-Xgg#`<+7EGU%j%wJIrMOU!-c??wbZgf4oKbzf4{mbm-s-vz{d2oKSVtxQrhraS6>
zCu%`9{4bql-Jc}el6@cjPStYR@GE+W^+3}6Ejjl+zZ+}8a_FW%u$q(PTQv9mzYDe8
zatP_AR(q0Si}t?w8u35y5k&NdSU9iTQgdH+jrt$=5v-+`TVc|&Ew1~@YsUY9kKzC5
zkFAH3R&J@kuf8VykNX%NrdL>xCau9xN!>N#F!&q%nx?GBlhj*U?xSneVeW762))XB
zGO1vT@4g3*fWZp*4gHDrbW-t_z<vKU;V`!X9;H`X&nA^`5%r3%6JLXsu#Wx|Kk~XQ
zl3v+$>T7N#JVvjzUPxlM#Plk!8@~n=tfxP-UQ9Z;C9YR}UHF=#;Bk7L^>UH}vn+Mj
zi6cM-zom1nSCi0|>|S)8I>M>o2|CZ(npC$Xr`L1ccm%A1-_aYa?MV$=G`;@o!Vzv2
zJW1zUJCYi=XnV!2#5dsYuz}uW?Mm`&sp*xqQr~cYho|U5Yj;xf7FVyb)%Xqg1b$C%
zvGyjlZK>~7w+i2IpTN^}k+m<W6C*Trt;A9A5BLLJVjW2GZ)xd8t<+KOAMgxaY8_1K
z-{R}_;0ZWb4S%F}Scj8_wgh_pt-?`mH9Sj~Sx1tBwu&Bz+lV@_1~$?a*5G9ER>=cd
z8&$`xf#>K-Ye;g$)|dy%He((56#hi-wuU7~ZH;@NZWHRbPa#KFS;LddqA|Hs*G3!z
zIgqETt&z#Ht=SJy8+DA!f#>Oc)~U(!x8^+Xv>A_qweV+JZ=IGb->P}wZxfDjYvBc&
zvCc?VY}Gyx3q(EmC-l$;>#Stu)|v-0fvV^J37hEs);Y<`wz?iD1!Fz<4E{oYX`P$A
za%=qqwII}UpTUdt0qeZvH5eGG6NuyBU+`DjXkC!3-rDj23Dj}!U+@xbwk9MOZ1p|x
z2*%@J9sG^9T9cEDw+0^g1>rci4qm41*7W4^t)howFYzr<!)DrvUje$Ul7})c^)07{
zSLj35#mVf}n1@QQ@mr7!Tj;N>OOg+6jeDr}3g2?M@G1?hOOqX#Q>yb4C&1_Mce>WP
zJQ;1xeu%u(3GQ=vjXrE$kzBVm=b^`IJOT3Hb^3^PRdT~t%|pLeIKkz?R{E%Qb#miY
z?L%=p@f}zX+vsD~waK2XH4kO&)OXx^DA32P>yn$dx*jUqjo*O{&`Y1N<|Vgnt$(O)
z7rx^*z;^niH9xr%<56|(#7VFb-k?ue3zPj@TOOiz>Lj-j-lR`ki<0}d`W|}PjVD1q
zyhWd}mL?Bv4LtO>3n#gJ*g>DQmL&%ji5`h>5DlOJcGBmpmC52F$s^efs(~wjw`mSb
zx+98W9w~1a8^9*$qtD|dy{MwNN9r3w1Gfow(HE>tax|v0>TVFHfCk>7o2>hjWkuPK
z&<*Mor-66ri+Cw%eo@XN&kf@#PzdkQmvD1RUZi>CzagCB3Sl>W*=kQ#6loucZxY{w
z&CpL@u^viR7S%kG-K4(fHp3qJsud<LD{?(j-ZXv>w!r)JHS6Kzl|}WB)Hj9ixh=4l
zZnYjwUV~w<x|_sluoXU_1?%x-by3SBbdx&GZG{i%cI(OHf+F7|&rRcLPy`>*H?60W
zi;Dt}{5OTuToLS}JFI7u%Zo&P;#<TIpcwYkxABcYS0w3^-J*Wris56r%X%T1EsE(=
z-ZK6GN??G#YrU9!uqduieM|U(D}e)axAk(e12brKw}>-f8+=0dSg$6dqU=6&i#o$?
zgHP#RYin{{QBI%dmhlWIh0o}R*7oFvB2AzFmT-nEg@bgTwIjK)NZTjwAbtef;Sl}U
z+Li1ns_Bz;P(O0p;d6Sx+MV27<myv)7=Hvi;0yYxwKut~sJ>6#A^gbgfW!2lwJ*67
zqi=N`#96QtzNDX92a^3oEq$niI?L^ZujpaxU~+$vug}wAJPXR;Yx<RSIC-cj(C6<E
z&T?gNgdVYuBnK6X`o*0@BPfSK%qUxMinv(PFYBZlxpFv)3ATl#L=?yLD?5#ipaP1R
zF}ARjvZ&&?es!nN$W_2#Cd3w=5{;3&x=!L8(8AG7s4X%@R-E0BI;nG<7LH-UY*SO_
z7w7bQI*sQ*B^=94uuV&m7i;?cox(Y;5{5A0wizjkVr{?pHt`eK1;xxH+pH92aZSJM
zHuV#?3x+b0wmB)wie3H6+s2>3Za9vaVw;<?vberqeOvg6+YQ5*skV73YcT0ocbnkA
z9yp#MYztD<#V!5lHpOv!-~?uxEg_|#*w^p5ZR9`|oXAYKC8rb@2m1ZD1&*tN;mizM
zdP;e*=&{&G@IVJ6n3?#7s4JE{miZ{2)4@s1EZgD~wm9ao(r4sBHIy*3ZA(%P7RNnS
z`vjh=hLOx1+tL&V1`O+b#Cfn6PG(|l%TrKs_G9Fu&U1U=6lSh%MM_<9&SQ_ycpmJ7
zZ!quKR;4r)YaaW3!g+2VoXX6ztxjny);<<@5kG@3U=;JdZEcFDxaP5}i~5=S0usyu
z+q#tIV%KA3m+@zyhf-#tEia|5xc;%aOZb`7!)Z){EkC6bbB%Rf#05aZH<?6RVT!-F
z<uU4_E^suQ&LrE4Qu>R1k3C(+3jo{gnN(Y8%209OvA;{Wz%g(JlWr?Z2`Ui<#CHe}
z!1h@t!&aFhE|COecPI~sZITSIRi#9f!~~Rgj2?jPaLgjxzLcnvxPbbO;Nh_CiCJu8
zQld*T1G+mz6TtQsCd;-zMOKm>KzFDn4%--*CAI@8^Gk99o;$`Sfa&VY2R3txyhIc5
z-w~QPOiN~#+UzNc5^X?ym-q!>`YH3F?NExcq$VJ{OZ~!Onjy2?22+-mxB|+%#$N!Y
zlQAFL4yUXvsSl{{3cqleHpHy39Zgw-DbBjP#6^JVAq-_Zo}w;k381^wMGn&dm{qou
zDFr3Ifak99BEZ|d%qO<fDa9p$fd8&=k;B`1%xc@&l=2eMfcPHqE5O?~%%`|u(3MCA
zWcR3FIh>|v*4i$luq81A%6rCN0Zzv<pV=;^94v_&P~Q`N<#5`KS!cVP;=u4|-96$G
z!08nx*LF1pm1GZ~d(<TkPotSUTWd;PNzQ=hp79dE(<Nqutv#ioL^I&OCtTuix0uPd
zb)+<wXa~gI#BTt1f0#|St`tv6&48?%`i;ZY98+lPPH8T24Jf;fzX5zZW473OQ`$=E
z2h`odZyY{tnIc<XN+)Jk>$-`{0RQ)x65BwEzocaVbyJr)8%$+NZG$QOCB6YqxA8Kt
z!!%}xZ8&A9BrxFb7A|vkn9h{hMpA;diJpl4L^E(e1yf-QP8DyHJdydSX3haKm`Ynn
zYFWg#m?uiVu^BjFCbQcXmKwD!?uptjG;>Y}m?~R%YBXkL>-@wO;DRJmZHr8mZOeXw
z{L~fB1s5^<Y*SO`Z_9b&@f)vzL-0?G-Zm{&zD@JQ?-#Cchu~s{vCT+TY|}mw_Yf`M
zzfj2-Y_n38+iIT3dZ-rezc7p0Z<~|4Y@6$evd7p0zJh;dzO>CvUAe9PiMmH<;l6@P
zm;<(XscSHzTh~Ke1#b8k#%NoRs@~S}1oco?IXC=(G20SS3%2>5czTRi0fc{LthVIT
z;%$K^{vP2f2jNo2Zc9%s-zIu0zEAuP5M0JMaRI5@CV48mPyNmz_#t!1wm6mD7V}hj
z-}pPIh1twkwk4?tx5YhG-xq%8YT<GQ+Lop|Fd1BTpSTA82R~wJZOc>9w(O_qK6Q=z
zAN-g(Y+I39w=L(X=f3e8I1K;B9I>rRZP=!H>c1~s;|{|W%u(Cw)W&Vvr{Z4XI`|r{
zWRBU^rh2y3JeBoQ*SW7D#T>V-OKslfdaCR-UI#~@iaBA+OKsa$|5V*8T<4C!Rm@3S
zerhKMlIwbjR`3n{J9ElbnCjow@)Y$_t=u>86Xvw7D7Al^@2RKP*b0uqe=uikrKv;P
z0#E(DLMwL^u4c~K%2I<$MbE?!h&E6M*D&X7m8s%V$urpls*S6IpE8`SDm9`s=9%(=
zu?-x9Im~%X1&At*d!~LMv~kDaTIPa{NsY!Fbln3&0QK;nOp|SYs;o5o8G1koTs{1Z
zxoA6(I=?jMndgB~0LS6Km`gTus=QS5%>O_TxZ`jgbJ=E3Rg`L<i60VP@GVp`S8Rt;
zm8CV$WDhAX_btq2uHtX}vQpPG<wK(voPeJ**KCJVSC-a4Q$G~E+zFV+wAzlQuEF?q
z-9w@sd<WMvg6(*!y0qmPdPuc%-@y$`yX|CZL8<SV=b^D3oP-;ho3_)b#ifB~{)a+4
zcM|3^9k#Qn<)xxQ@gw2}Xn+OGZQM`Ll}ZL>kEk151Kh-P*)F8Ar7?rbN5&iA6x1+x
zZ5LAymc|XL9|<?OQ?QWfwp~tjVCuW>5pffI4>vPCwyUYAG<y&|qHc2E!!1m&tu?i-
zG-uHB$aoW+hFh73w)WJ9Qq7?Mk#Lhc4U3pQTSsbRsdiA@N8AEGz+&dHtt-`2S~Do?
zqi%6Oz!GM_)}7j1>Kat`8E=6za2xZ~)|=W^T0f}n6K-*5U@0?b>r3s#uz6h{(E)yh
z+nMLKfmDBK%OL8bI=CO<4rbUknA%_J8}#%UJHT1ElX+zuP8})@4Ep<o4(=>0V@7Nv
zsX^OCL*jm-6EwndW|TcRtxUXKG9>G#I=Mzz!35hw(jvCU3@Q7Ko!}hQGGpvvX;Itb
zhSdE+CwC53G9mWxv}g>u*Yy*(!B21(6Kao4lWor)LjBZj?kBjL3A0a4o4-A0$kT7U
z4LG=mnP8umCf}|Z^7jk3ISy7a;r1D6itXAV@ngaVc&KA0*=MCGx7Q5G9#cM!ht*7^
zeNNi4?XDr^W1|n8hkKbR_PJ>*x7QD;9}7P2Jlw}jwa-gigW3AJ$3z$S8GgYK_62F`
z?JYy-G1bNW4E4-3dqP^lcHfZav9SwWfHX7Ro}5;^Juu{dEOc=fAj8bCr>B)~7d;mT
zh&#XoS!O2gFX^^Rp34H%9nJ#{%q;ujG<JK;b7jDI2Q<MNX10Av+QIE{&(#6p4%Y<t
zGjr@q(;OJ-uL}@&!7uRNOssu*8rq)y90jPm+%ND;X0CljTHW@X=bnJ^F1QH)!@Or-
zmDaFb^V}a0?s69)-ha2RPHWt*eJ&m#?txz+UPrU9P4jH8c`h5E?s30DoDR3IOKaZl
zdafKW-UF8)4r|%-(%QDyKUWV3_qa<C&ra?6X`R?4pc^2%!EX?^GVO(F{_QQ#(E!!W
z{RVMmVJ}MS-|l<v88CK(%Md^4_R_SW?Sbe10im0_4DC$1y(}$ghv<d)3E>CL(7|Nb
zE7Qa~Brjx7C_mQ>oeZ#7rA6$Bd7*q_^n)wV#VoS#ON-hO_d@+d@N-w-A!f0iNsGn;
z1Kks%2eiQdGFkThX|f&JFVGXJhiidfF-z<R(&q2TdEt3t>;YGyoB6<QPLuD@yzoB}
zdbq0)GE43DG{p|>3-MFpKKLCX=0p3TH06$(7qX|+eeQQy%Phxl$YncRFO*M>_rW#z
zKjvfm;k1=I>R+gz3ir8d@G!H&el%?j_9p0_620I${F<Tc$J5k1T3(>1R4;cO9${A5
zPo@>@@V)RnHTHs5_zm-k{d8LKj=&55Q=yk@g-4my_Oof_J4D0cXT$^02J4tlal28s
zLozITMm^x#;4x;c{X!bMBW76n%=iEZu%7wMelhLfj<{j<GvNUzz~jt1`{gtT)-~v!
z5f6bEe#_+Auco0L*~91=^^o(z6HK1HHLY$(&amg1@gZo3-!U8P?P(1=G{gR9!b7ed
zo@Dav9chg_w8P>-;t{w38<<V@t~Ae%nqk=>^@zIxPcen|?zH9|u3_b%@e#NQzh}1C
zd(+x>)DNo%g-6^?c$z7)_oa1WON4Ha=mWRl4@`-DAkDv{Wf%=oecUa0hAFiVruFae
z4SNQSeV_yW$n3BWrw#204EqO#KCT0vWy<U$X=On>MK8reL_g?+jZB3-I9<F`@=`WL
z^>dx@98+lzNsrhW^HMov><72uPt0z6SbEgXxR>f7p`W`AIi|`Uo*s?u6uKeeG4Mg2
zskTR^%XVhJL_^eL&Iivk`|MNG=kLsU=@~LU23_!HMsJ^%F5jtn=^qjvb6xNP!`Nq}
zD|TvMik}k!a0hxAgMC)Ia%as;*>ftu-GNQae*2vCWjkFjmCua<a2Ni<d}*JXzH(>%
zOZ9Uhz}<xxnFIED>1(hQL-(8*0QcapjM2UzUA?pAC3;Q`aQEOP#%xbWFWBjO>3MD(
z0NwC623OYU#XAEp{m+E~t{Yxv?Dq8Z@|~hr;upjd;D^nO6StprJ0-7VFQ_M+A6{V&
z*%zm?J7ZocUl^Z&9@xTsWnYqhaA({r^$Xz%*8{II(7rU?fn6NB7sOL=AO6nN+Lx!J
zo!PI@3+gF%A6{b)+gGI5?aX=Qd0~7Cdf|2Eh<#Oh!%odB{|n(M*9%*jqxRM5jXSlk
z#KXih@Bp?k$Lwp<Jv(b&$%d(C+yf{u$L;IVn|HciDTj^Ez(eR|PT2F(+jiE!QV$Ey
zxQDQvIcd*N@5Bla-7ql-9>E*TDSKhMe`m`pG)xV0kKj$_w7n?3f2Z%2XV^Fh`rs|*
zjJ-5{XlLM+e^?mg`d|lh)?St#R3>^Yen||0e%Q&Jvsb2z%OtO5FR3A}AKqp-dsTWw
zS<GwYOXCoD41LUb`@Zz3vbfjkm%<SD7<Mri@HrHX%_F*(#B&gUcbF#o{&ZPc_G|Q#
zdd>ylUFIU@u*@&ZdF^>=d=3WSJ?4_#oGvfZy!O8oo^u1Ro4JfX7)6=(wfGhB0z83!
z=8FALy0Wb1wd@u3f_nmcn5+0ky{ydjTKUTO0z8HHnQQjL=_||XU#njUFSw_$mua;h
zO<#kBC%RX}Fn9(ZFoOMfy1K08HF`x2bI;&Irrmxry`aqZ+Vjdd3<lvN=BE90dU09c
zwf~hc%niamro(<Vy}V2`B7RN01VgZ&xs9h0x-!X#>^1e08-kCSF8hUawk&2u`P%pr
zJcj}1uKi;A!Lqm!^=siJ_Z$u|-S*4r4(wUcy(V6P7w`$wW51e?%Cbk$Yw8vE0zPGW
z?XBr`WjQ0B*Tz?17(Qbj+S}6`$}}VX*TO4q7!ERh_Kx(%GVO?Xgm?{J!Xf6dy(`^Q
zRx=_Sp<Z(@;d5rd-ksiD<{D9s7+-@|@CEbK-kaW5RzIR15ngkz;4m|2?@RB*dKcXY
zF#=x0m&|kfK)S!IWdw~-Biw8FiW#;KruUcmMm!_N5ikN@Gq3E!>19J@ff4_RFv5+%
z5oW|bk{(np3JML929ZH1h#ln!R*1_bL9s!qAU+6<VuKwaiiq-<psXNM5IG8o*fEYU
zMO1lQP;QVnh#!T5*$_v#A{uLDs)MAXND&&%hB_h@vhwVp+91^^UWCT5VUDSa`Q<r5
zO+ltnWH1`bPH;?9$jdcBJwe`4d@u@O!yPjeigImG=qRa(9F4^6B*!d;vb-iJc9crQ
zk4B+vq+^a^S-C4HYm`YujzQztDUP{{mF4w8xud)yehdm@r#j{-)?k}W^(bjDITnp)
z3C9A3y1XT*c9bfZAB!fi(;Nwkf^uI_(<oCg8G<IV(;dl*;_^UH&nRy&AA-W!8IE*C
zdAVp*s7N}R6r%`sCZ0~|$|a*>MXJ%f7)@elITkC}@|aOsBGYIx6iL|GjwOnN<#D5O
zMc&bTD2imUHAvyW5}j(1bPPETO=dB~UxCWAN7af{WB74s3X7S#in{WgQB5M#7%~jK
z!D7UnqM=+fsz>A<!-t`%EGEt<8q2k#LW8Aa$?+(P#S7pHPkGI#*kILIemo*rypN@5
zE_aQ}3O0=;Cm<<{<I#$?^7>J^!QQd_1T>AsX(dG`cK1{VOGC(s=uH+64;B9MmQl6A
zst|r6n$F^0o}$0pH>xSv6helhw^)3&Rt%K~M)d@HL-=qsgT>!;MNoxE6gpZeCL>TZ
zo8hQbh$|$b*wHF6AAx4Fz)_`$sE83|jW&tNNeG+i9s3kf6>*~6(Oxk>3C&^`I~YZD
zMW(2Fv^12IAZ(6x>{rMtvPHF{RiV5D&1RQ44k+eV<cOL^n?lJ*gw1XavqD~>5%rAr
zhVqeU4!hK0S12m9qR=tYapYu#%`1*W3S~u&D0Yl$96uRhlLD^5msPk#Sz}D&$SDYu
z(H(~sD=X?nxnsQJ_$dgJjvYr8Yp|)PdW<xTd;?)}spGgpUC|<{9is~4-$0l|=s2k;
zsPKuJ#+bs$sR)zB9H$k<6#-Gt7;hLq6=714<E)~*LKGZ2Ryv-HLYVx4hn2btNpS2~
z)p$M%;Z1(W1qE9X6Pz{HG@c|7-pqAeR2-~`3(g(u9nTX8Z`wI7D;!vmR6SNYfs`V=
zIpeshKo!}+wPRHicqzh3ct@+Et|BM6X{>1iISt`ttD{}fP@xI#8S9<EPeVAV=IBr~
zR%nAmL!=YQHxW*rIJy*`ikjfq5Y<HfO@t@Oj&4PBg)2BK#59qdj__p2(W_{ys1ME!
z@lNEYBi!kA^eH;Am#I2L8cx22aOcJ`pzv3;1lNYB!uhuluEZRJin9I+UvN{1DV&^v
z@YTvOtQe{Y1own^!}%EqAC-;~MUYlBI#eu;Afplf(;dMXVy$F!tXLJnN23h3(h-so
zp^X`xB{oHnGf^hH+Yy!#rHvb%EA~e4GZA2`9N`(!*auZDmQEsL5Xn|MA~R&#?9sJi
z)g(R!En@dMre@67=8SF<n<kOiRL|-i(=y~*&FCJncM^}y<SgTuk)hCPM~8+=B_vi+
zvj)ek45hYabZn?f!ejL?yWcS<W0}@9IxEy9A+c+g{n9ZvW2Lr!bZ)3u!eh56d%!U-
zV-40&RfkF=Ni36OjgAEwYHiEt+E7&_kL7`^*^!V@p!JPz3N=NN*cQiH9myHR+Q8_Z
zP;VrU?O?3kk)Bbm6^#iUC!I`U9Te-t!)u*ZGA4GMYBG=YKkOmL;tW<BGbU@CX)=j@
zFYH&2B^d{`abt4Fc_;JO@4-UH(hLW-UsaEjP9fh#AF;KL<rzquJ*IY?Y6_15{_J7L
zii|pK&X}fgrYR%_wzEeZt1=q2nlU}&yi<5g=w^>PR%bM7wPQlVq;HUz$jlydtj+Lf
zYsSQesovl*f|ot+SeMbPb&bgiGrd7#<SKi@k(be?tsj#c=6!?5j7|2WBR``POSh`S
zq*F=ERAf&%3N!rLmNB(qs;NAN=&`3AMH&5C-<YN_(^L{e)7UeP(u^T(U`$V#cPfu5
zS?pOySw>K$Xl&?sX%va6NbEUBWrny?GB$R+DvHM#9F}ubWkgiQjLjNviXt)gggx)r
zml0JNH#T>?H;Tuc3-$soe4?@It9rbYATif~ZF20-kX2@ntsSo-c)ZBYUUVGDm|vMQ
zwrRYHAo1cdd&yzWkXLHP_Kf!uJl<4gFFWiRic0O+&<Rp0i8mA3D~>}M%F3Ftu@h8M
z9<QRYS8>N~S*2@i)&!H3#H&Z_HOJwMm6i2lb0>JEJl-{7TOCI;)?me0^#tiO67LqU
zg5!9Gy0T?#?F7{{9*4=<cE`z#f=b`mrU|BLBn}U=Hyx)liYo(SdnS0N@i;BYb~w&v
zlvj#ELMKY!Byl>By^XUBx=Kk%>_pX@JdT60U5*R*p@|8}nrM2H#PJ{YuH$0H!OFOh
z+=<>dd7SrPyB(MDF`OAvJyANH#PfZ&$8j|SRc43OPE<|j@j#dDb+l&GRpx{=O*Bm>
z@c@r~=xEPqsMLh?O!Q9Y@x+Ghb97`hR%$~+!=-PLxI@oAc64QUDr-Vw!&PtbxFyRD
zIJz^MD_tR3;ik7p+=64DI(jqOD(gdX!@Y0uxaYzSI{Gp?u~4l#TsniqH8%U)F_2N_
zuWSja4Oh+JaaF|*I|eiQD}5nN;iefRzD2XI9K#tym4T3+aPJHrUz^ww$4ExdE|EAi
zLK;ot*Cad28JsEJB@xF)sG@m%F0#SSkj#i(G2*NUQ#6U619prvEHi3XoH#ea8_nZC
zoDFe?XGUX@TXlqVCYgzLv7ye$Oxdn%aczWZCZCCRvtiDune%t$h?^ozGf9B<uoIlq
zGUdB8;+_caOdg;rHrzQQQ?W}c4xJ>8AxWfTCpl+jDtFb0V<)L%coJ2!k<K}p%XYcM
zS(8jL<RY|}o#LFExpG&%ICqjahF^sCu~VJ%GS^^#T=gXBEb>q23zl#$$W-rY5!X&q
z&Eo%r^z1ZeLT14(pSWp~X%@K{(d=|*a%S<afVgLpcNV`GG3*RydS>}9QD~?{`ZlRV
zEISitTXef5p|KLx+q@DP*jdiSne48Z&@74RZ88hhu(O>@G7s*G3(b{y-{!N>es+#?
zX{G~f>#8Nv+2o(mzu8#la{O<}4y~1_X7hhWU$S$ZD>CbL<%Bj#OtZ-)=s)ax&Q+NW
zyELIa67Ot&2|B>ebFR*8+@%c-jg-Da{skRm-*>Lf^z5n$jg3^j!~X>t*#*vZna#Ug
zp;?ipcgPQriCyT-%WT_KADSEKeTV-5nb`zqerD&cpF*o6rE|!?A`6@7EX?%pY6-24
zRL$Z4imYt1vnaEFmoKy_(lm!$ifnAEvov#PS0J<}(mRJ=itKE<vn(@cw`g4GWT}i?
zh8%2$voce>TQV+ovP#A;LrxYrt1=^Y$BfIGY?6^5A{V>Jxi2$ncigz#$zB=%Av(k^
zb~2gKSkhNLSsF`bqyMs5&i$FP-Pz-6C#z!lZ1feo#Cafd{_dP{O_NQr<Z|R@KX95e
z<-0ZGdM0~g`Q-?*OP%&i#cu7m&?(Y)$&V0XKXe|-RPL@B7du7uF8>j#WtTf)=Ca+c
zaamJL?~)&*|FIuC4`;62T|X{&iuYaqV|18Z;XInT2D<^Pr%30Le?wohl=FC|dUwmX
z+9|5J{NK<Kc9rvFX2EXXxTYzlx#SA;4f~1nbY}7Hz_^|%-nsk=bd+7~Jeyg*TND=h
zhV&2QN>s;wijz*d-IB1_H&lP%SE6I=TIU7)l8p(=dc*Vwl0x<DXU>b62Y1JX<-Xzl
z15csj>^kS=Ob1pHR=**Ak5r*=*<9yU{FG#e)xM#6k5{1+Y@V|<vu<}zSkoJ(_sCV~
zJ9dM!J+ooACamWT?|b|zbdt??c4Rj0)`o>nmHv_ZJ8EDzIlD4FyKBN?r>g$Q{~euT
z3!UAW&AVM;SyN4aBtJplvs;|KnQgo4!*Zv3|HyxWPP0YMzRa>tY(lJ_DxF9E1O333
zI0rKQyIaC)r>f@h|3GKhQs-c1|88Gc(^S(uay9yq-QgV09NHZS>zV4E$FD|b*)r!y
zX3!qd_|Pcnd~ywHWGkG(K)gpXJ~m1<pI?K{v6apc5V0p_d{&fcKKUv7iQVlC15tb8
z#^*+P=kuQ;j;(TrgJ>*Ztd5etPv#(=t#(EN*`Dn2wNa|~`5bhf-RGPN=I_ZF-xOtf
zpInQ6X7$c#K)y#az9-82KED=SU>WBOpxC1wA4*8$$bTXaYjDm2$~`sXV+mCp|4-D!
z?sv`s%l5d&XA!12@-y@c`=xU(Sh=Tud@kXQ<3B?e*#pjbU=8*@Ruj?%<iF6btkJmu
zsQ0vtuO(Cq_<x~Gtl60W3ikNMHxZ@<<T~^lYjq}r;yr=!J%o1wzYbky?ap*izDG16
zR4V;HQjMBfCr-ZU_DCkgN>%^ItI-wqkaIC$_ry%dlA8XH%tbBiSI#Bi;GVb%xl-@{
z@ww<K3!O`W1M4QMrP77u=jeB~*0~&?n%NU-rK*Me=ja-H*tr7K?a7(YBsDE0^U!tn
zh;tQa*rS=yBlRxi^H3{$)VUfo?$J&NohFSZ*P}M}m~$=g?5UX$J53eOuSWuV+_?@k
z?{Q7Ynr4b8Hy|&2!kGu!_S8?vo#u__H=uU*q%$9MV#{UqG-(345#3-<ISYY*Ps@bb
zX{rQ%Bf80+b{2vDJ-!J|(@Y6uKDx!8ah8IiJ%I^5)4U0MKI&l4I?F&%m1tt<n^HMh
zfI8W8&PpJzl1z+!QzhpM&~27;R)L7Bn2A|$n&jjr<YUh}_kpOYxQV%Mdgc5k)Wu%F
zoz`e9*Q|b1nn-HU9k$82AIPe*C)U2HO5`=@E_)G^XXjVtOl*47lt>n$d+a5r8OW<N
z6MNqDCh~=-o4t&CQHm<<#L(%|ByuzIvsavlfU>G)V(fHP62BSsuvhUwa9NdWV%Bt1
z61fH4XRkRAgOyeF6LY6~llU#Dmu+<(1#7U=vwFHTncRvVu!8eAP*=4~tevh(=C`7U
zY`gO$D5&yHY?^LLCX3J`_NMbRD6R@j?3wOO=8I4t+u=M5%Bw`-p>Ii3$YRvb-o`;l
zU6mv}_AONkUyL5JUCs;mQXUhY^_D4xEI|SGuJa-|SQQtZ`<6F_FF^xrxAQWt`!d6;
z-;$=1+t3rX$9WaMM6<(d-%_RW+t5?C*Vzi{s&c}c-ZG_<rRW*^(Af?esx;v}Z+TPs
zQZ&f+IXggOl{P$dhBS@bj)vIB&Mx4ostJ#sp-SVoqvz~^vl}#5xx%w%n9|4{=mq=K
z*$c|rs_MgYXL!^29cY*xboPNxtT3&fAx$TDqL=J*=K%0mwS?EsP^I%b(JOY?ISBfz
zeBn(qOzC79dd<Fa4uhepKzPp#Z#rLwM%WSO2nf=NB0{633bGsp8AiE+NwH265gV;i
z@a1TfA=ni{M(AQ9vZ752vI2<=V_acmlrAnJH`=S<D^Rc@#1&3PV{>YCv^0a%qS1y>
zS0pLZWk=LTt1@^k8e<4^O(o~+aw3|dO&Me*8f%!~nnucXnuwlgZw6n9LJZ-q8Kgp|
zjR>77%_Mgrv0;*H7OB+LM8wWiW%9dFs3Fodhg_y}MP$u1Ws<wmIKvdzTymwZJ|cIf
zH<RCu!VFVg^T;(=*jhbP3dlWZyn%2nAl15-h}xMd!0$m54AWc*WP#2X(KOQp$SO3^
zFx{0*7V82LJu|(4uR`I58Lo7)Tql|o8Y3l19f~l_#KBmdPBJMrMn&>EG|4c_wU}ge
zF_W@lOe9&2B!=0pCFDU}+@#zXFUeP<NW&c0QqqAvvDGosMdV&I*%0emjxSZ&lWJpB
zi}<~0ieav61zD%dnbZ_xT14(cZy4Tlts)zAnn^t|-bMUAG}SQAwVG_yX(xrwlKzSO
z0!10#cdaEox|&I`vs8cLzd(dxfomPvtaDAunq~SEsYg=7LRTKyrmLTnJInhgUXP|3
z5?uLYC)U$e&yp@CY4oNc(N#$LbuE)>XQ>wRG@5Qmb`_ERI^U$GS*FD#gWfWvx=P6*
zU0_nrEbn5TK{E{Lt}-&HS|ka5TdE{k6m7_GRg&Uri6r)Im6B)COapLLkrCA~lB~B)
zO45L042xX*$f)W#N$%TTC2v5p42xY18C{(zseW6UMb@CV4Oy=Jq^vqyQv0?li?2bm
z4NF`H$obVdlBTy!S>%57j^P8BnUq&+Bt36?v-tgJj$x_GPAaOklF-@GKa>APGQ)?i
zL!`30MiM()^=JOyDAuqX2MCr`yChk&O@Ai8MDH3tb{!^HR@X~%XM6w5e~IQAR=AFm
zYp{&BdbV^4`5*KL1LZnSs;gThwX;=A`2V2y469rx$%1O1q-nNk33&kh(eR1uG+A67
zko3&<F5wTLd4|=lvt)U-C^GaN>0ii$Xujc7oRij7OCn?6QT>HKh~77>bzQ(kd`x84
zJEp&oMighjR50>jbzEfbJKn$WMzp}N&UKk|U<YvZJJJtG6Z$^`rgq>vc6Ma#JE{+O
z6Iy7%Tli#Mbxvf{JEjjvGm1Chty;37S`*pxj`suJj1mlZOO9-;)<%ZTk^Ys$8hZoY
zdLcd4HIcD%RDb2MPu_r2>||MUwJS1fj_I!?HoF^eER}4lu8+)}<NYg-4eJIRGb1~(
zd$@XzbSa5d=LQ@bA^p`Yk+pMFOL^=ZH{dZa*<bC8Y?@<QN@Dr90grXaq3S?n&m8Yk
z9$UB#xJ^q2?G;T9l}VS8Sch%EZI?yjy^_hXGSxC3d#Me$j9L`2H)e8{%(RSjqD%w6
z7A=a}8#g&u=3T~PQL_ObbBm&}^0-<i{gA}QWCQ-K7s>W!Pp*}zKIE~w*s#wvb<zC2
zIg^`YrVmN%5H{#t(-z71Y9{x{ydUyd=4)VFGZrcKYA1)rO0!99)ioGgvlc1$)=Z9#
zRb}&7Z)@1^nzLxxUf1NTSW`BMJ+p={U2_+$+*?06H`bfYW8bUcfNS2OHQ2OV9V=Z<
zV)3fM=vuHyy|-m@ZLDfJj}52>vnydy!Cv3wrdZQ*601lJR#)<(;=O^%J+a>9Ja&Q_
z?5^}h<$Fa_Lf@5sL}EFo!HIM8y1kMqvG1xr;;|*uaLBcI5xX~LO4hrkkH}h-ZTQNy
zWYNLBaZ_^N^?t--ZKMIZmM(H&!E^Py(vL~(Z#2}pmgAZ$drIxQs*iarQZyWPtyomI
zH)l%IyQYsxY&0|+ajja^uvass=Uwl||Ig5w$461#e;h;o!IoMuR0zWrmMcqugyl#e
z9ASB8cPG1>y-65ELJ-M{NC+Z9#KfSICFdNQV{-4A=ZOdgEm&&7I8)eC3x-;7s0BkU
zY^eo9Em&&#egD-LA?(gP$LI6@e7-V_7UYfvH`8a2R6V0fr`98w@yER%+)AH6!at)+
zXV=RxY>zt;+)iIQ5`2b9m)4`By)5@(a0h+$NdGgwbalN9)91L8!CmwXm@Dm1rwR~^
zf#W_3?xAlV8GHt(vjsBDW8+Q-_tE!`3_TN1mkJOJM&mvX9-to{8Ga^_t`^8Jp^Q5d
zte{8KBu&uFrwS2_3gbQr9->FrBu~)IXA5PR*~NVtJWP+P(N19IONHqD-eOJ(*3c<6
z`U$@IYM~56thjSv?WV#wYyW&|1A=K%Ts$byX*I41cs{#9hOtiEg<vzCSyMbAK402^
zV7?OfS+I@Ht|^<4n6GY-VbBqGG1x`t)>KW<ETC8f6Nk9ZgCW{n!%xsHU|AVP|8SQ9
zIC9hkCol^n7QqM}?u%d_U0BmU!M8wVWtfG-T?rnei(rbje*v`-!B86R%isyRq-Jme
zUchdYVLA+VEqIbHtr?mSUm$HnFs6n3DtMYMuNj_@SfFl{VO|P%J$Qz$tVx=vSx7yL
zU~mcdHN+^YYmz7G7P8OEFhPX789WD~pLQa%P<j@9)LX`V6TCpT)aWPr7OKz6Fj9lN
z6}$*SvtgotA+-s?Yzr<CybM=x*F?OK-6X@13GPnt3Vpn$cw&5^v<bnq2kzV8HTqOd
z*~G*`b(0KZ7r48@>-5>0s)?Em>Ny1S54i7wH|dJ=HT*<f2K$^0lL)x`!CUktc=MPH
z={W=w0l4pjcj&7%{S$o|>T@zw^K%b^cj+52G~Ay-ZAQ?M&;1a*Pv5Q?oQN~n%`%kL
zbB}@#=zBFo6XO}uW(2MA+>gOW^uwCriHQt#vkdj^+~eS5dPHqfiYAjPLeQhmJrNpd
z99^57qRV89WGFP}MutWi$JJ_6m`te%ebQUSJsBEfOsUnU_%hWZ85+L1QK7NMRG3xn
z&!n~>sM_W<q4CDFT2~6rWVguBdCiRpO*CfK7N^8Br7h^w-gmgCLX(ZzwPh)ZOm&O=
zY42ffY-qYMx3(%pvxq82a&I;FbZDm0T+65E7O}-L^dfWPLvxLe+F%N^NGe9qPs}|N
zN;ekP_NVw3sl_rB1#=Ta8O9<Qk?vnaZAH-7%S{R`HkQ;5rr<^FRvD^uxyhj{V`=SB
zN_>&D6+wqBH#L-FEUz6-Ni0&g%1|cDO%JUxR@Np>(&(w@5wyB;Gayz|U7I{fr)Qs+
zp<R`m88R6gYqgUYz4Sba_wwBAkj2<itDof4tIx~OH_FWo*^S+`hDm-swGBb>C#MU!
zL6UJz!g_X_3=N!IdZ@s7yta5!TrX`yP=(1Y2yHZ;sx6z8(5u^I=%nN_LYs|eYpW({
z7E>=ED2L=0g|-^c*YcBei`f@sC~4#thqfCp)dnXqi=`LPXT1`)G_=EbwYGnfZ?XD<
z47G(^R%n;;1`LGvFQ&F5=nv$UhxQn6*A7m?i`nfm6!~#Ep?$`CwL_EQi>2)d8uhqU
zp##Q;wZoGVi`DHiRNHZDLKVglbxD+F2~~oiV~$%JI%FJOmrUuFuq85dy>aV8hmGUv
zv=p;MDnXz3201!ZV@#>jQ@$l?i45&$oGH{`Ooci0{w0(TK@Azlgal(+or}UtSf31i
zV4Nk?Y|N}Hrs7K^AA({o&K7DjX4jQbi6yE}hK4N89_ljY)>ToOrPPZEs;W3=C}cF(
z@sw^U`=Sh$QJfn9MMqtbVwOrTBIs`7yrDj0VO>AvTdKY&Lx~bs5ISZosvDsEOQ{_Q
z+Kjjjp%ccEx<LvrWp~I>E5vOKoivu#4N>u>(hdauKHR3zX=8caFqK%U?vSBqhua)F
zW2~%8nygtyy@a6ghT8%utLnPs$+~6iOENUia9cy?z$DO4W|m1Wp)Y&;xox2f#+Ew$
zWZyFNB^kO{xb2~f#_l@9WdAa1CxTKG&KJ523Y}{*UdHZ}p`C==5xQbLUROLhzD(MQ
zpeBUd8M<aXRaZ7Su}s}5Lth8CD|Fphakj2%vL=gq89{Rfw>xyxc)pIGtjl6wmZ8Cd
z+Y`EFyaYQnlO?^3ph|+<8@gk>TGv0>m!-ZeL#G3`FLc*<qi$fbKa1Lhpj?65AG&Y6
zT{k!xXR*6vXgS~xgdQ00)eTLKXGyyd)D3V4LywFP>xL&MveaEN<o>ye&|~9>`lKnE
zY^oGN0H1p^G}1J>K6#2Rn=O?g2+th~jWUg^*G^%wrBd{D?*R99XpAYPUO&Z`t(M9V
z4d)Jr#+p*=4O9Ht)NTYBZO$JWZ%V6oO~KjhZW+STTuo@ADYL$KN<3TIjUctm)rBUT
zvg^yHB(l}rGQ@|uhR}3VZhh4h&2p*?L5`Q>LNiU~dVY#-Ia?+}o|Y3rb4`x=;1p)L
zRE8kf$^}B{ro#IEDZb@unG6Y2t~r!pDykot;$KefK@j!iT0@IXCG~?-@N#yK44F%=
zEtF*{tsj~aUoP!I5Psx3LOG`L`r#>w<?0?8QivST1*XdSq^X(})GG+mfE--4P1W_u
zQ*|rYS7eCgaiNgO)L5^b%B+xHL5bc$E)uesTI%&veJj*gWC*Hpv5?)=U2mA`UqS6f
zkQn1|$PJ3EYbsvB?v)|B#r1^>Ovmesr^Z)Edl6))xTB$src?E0QxhxHy)uNExMQKs
zrnB``Q#Co%s|Z3x-20)ert|guR9z1HstoBK?nG$2=~8`gDw89<ioWetxer4-Ojqms
zr}}c#S7pe%a3@2%OgHKWruuWJeF%al+()53rrY&{Q*jQvPlf~tcRIAsbgzDBYCK2U
zhaif<eH=PqdRRX^HIbw4lOYqqoe5Q#Ml>W%)2yV*5o8m%PeO-GqZ^W^=~lAkGK2)U
zPeX@I;~KQnn3YmF`mT3~Q$jVSlm`7Y-%7Py25g=?2P|1?gJGI~CAA*`zs|)&f+?-R
zH4U$1_sam1a~DF*rp$)oY4MfPegs4}_gSdTl-*D^EwNJFF9TZ5T?G6lx1nm9W)<}s
z0>qj79KHv013yi-ihWH6)|k5tK(nJEIE`5)y@mk#<-Q2@nF<^Fr}<W?ugO5)a#upf
zOhpX?)BLNb0|+o!?#s{#Q%S?%G`xyEAOnxeT??Hwl{O4bi?5OnAOJ(TuR^Cy<qgBr
z606h$G7y^F_0SnpWkb?*&1&j(1f(SQHH0v$8<MB%R<p0mfGl!1L+8L$)J|tsORu9J
zdWX4hLKjRe4f^T6)#~dqKz!V-&_!^z4b%Orse=e;IxZ2q3<ADuI$q5llmTnw?u4$G
zjyDufkFS;vBH+uoZ$sBi6{i}?rYBab2W23=xVxe2rn3!I(=}_THxLk4+;^dyrt=N_
zbln>E4H?iU?tbW&=@OjmnKjZI2pA;p`_LWJ)rS7*zBTF_GQdFGgV0^mjfR2g{xwtu
z0xF05A#~q#yJ2uTUc*+%fX8r;LJv&$8iuCF*GLrzI2G>4&?D2shT-XnHEM+nzzFv^
z^w>0_F)3A(OI0EOH~1&QBh8~5lT&rMY^4kY1wS%8$~>-7o66)$mFNka#6KAxV@_$*
zr}}c$N*R~}epGm@IknM{>d&R#L}2don(%mYTB9o!=dy3g;Ii{$!V}Gzjm4?)T<J{&
zb~pc2c(OUWu`D%_tG+3N@63-4PdDc_R;6mzQdJ22U;gRvOtZO>Pt~nut7I@@`SIbo
zW=CT%m02rQA#g<bXTs^`!p8no-&(aw25XX^7|t*kH4dcu*HVWNc!d0<@M3dG<6tUY
z%N~-!tm7w#v&^N9L#gq#(jf${89z0gV=iwTPED*;56R$O@zcX=%$1EvGc*S3Ed(|a
zKLbL!)s4wBbO!b<8T=f6X4qtIY}C$R4ANUjgOmB$VT-w?Q9r|HP~Vcl;o#?n?dI-A
z!wkQHdK-b&!0W<pFmzlquz`JB2F;&O4;Pq^Hx|!`8>F`pi0}M@@J92g#<Cd+gZj1%
zA~>HB-fTYGST#elj(P`y8qF^XZ#AE9<Y(yCvG2$r3-gP^+s&66gEN?Q(mUuWOz}&@
zJIq%b`)Bypsqe@jl=4~OUFI8&12g>VsKW>pOMZEHkNI}v;0(NuJuHKC$mfLjneR0Y
z&4{m)4kOU;_*LNp=7){LGZO36!!l@T{F-ouc?6fF)gY=GfvCl=4IeU(=90BK#8%6o
zF7fNaht1<St(HMjHF_Frc{*HUPT}-gA5yDj&|7#@xWSyt8MJ;x`4I>oJQEhoX`D-o
z5$l&hf#5CSW^*Q2tc@edk3b6GZQ(X^Hdm%iAk{C!m7KSSyUe*<l~zMjM-beNd1p9e
zHgmjIN3%y{xTNy#aLnxBf?9@_jv%-#^4@TtxsdDE`e^lt4A(ZkAbiYR#0_ZuG*yG(
z{={zxpD>qjgIY|pH8Nae_>JL{=2C7*8>gij1UCwPQ~0#GoEz3AXthR$lRdvVe8ybK
zCC$_rsaga_Y<>%5w5z$~nK~m|E5lir-x@v#5Q26lW0Y#qB&_GRg)f*}IQ>kYQLUBX
z^v7=xUo>}fhM9gNRfpgh#{0sT!QXSu#74GGhVu}=BYeeNahxlj88=FG2u>#a&hRz!
zDXwg0!l>5Ca6;gBg|C~>a#b@mCaNC6R?Y7Y-!z}+_?bErTQ9?&$?pl@GG78EfH6t+
z2sST%Z}^V+D%U^LXHx5B*hTn#;k)J=+`vq~iE2Qwob&s`_szGt!I{{^HpsB9@(02X
z%=fsVnQ@cUfM9{+4~8F^A9BMp6DGAmhJ}W&2tPKD;FD%)%v2+SH=chpJdzpBC(qKE
z*+v;&J^oO56f=(3&SK0`BZ7B;e>*&eN#XUgd}g&#hKG?q93IQ0@`hP{GsPizDtLc*
zJd?(|W??hS$?)~?HQ|X&CSN=&Zk9L%pA%mfp3G$PWwR1ym6PH3<r~7&nOweVmWH8t
z1b>j{!ZR5&&(G2^EHBT(3@?P|G7dgCi(w=l&Bl3rAe_z=^8K@XjLOTiv4w9AXD~(l
zz$`yQ31|+s@~z>;ObI^-f0`BKIoQUxg|nDaerQ&lkpwgs=kp!m9HyKfo|Rx!L7t24
zd{=l4Q^_aI*5pwlO2ZDm2QvHBeDZ8v9xKXe*vW^&CZ>_s&Svr?5$UjtkAy8u3$LH;
z%Tq;JhuwTEY-hT8!)$*Z6+rW_hsR+z)62Wymu3U<JnZHB!UfE6zIb*#PYR%Pyq-TA
z-pHKd%VsC?)PS6h3;1K<&CFT8YPQBgHKF+!rfP?`GUs`Iw$8#f$@4LcQ4VisF7d(H
zj74ff3owk$4ewyC^8K@Y7PU!UfMHH*co%bnADHd8P|au|hPjyGJ<M%>5I!rmSzd@?
z5Mp>AbB`aI9k)o$C<DXbyYK<#AwN7jVNsjq3=EUb!WGO2A!&}rO0}R&43n+GhnUeq
z@*JI&ZILrEj4}!zX2uEHIgC|mL5nbqt_jyLDT02E&#Jb_i||(d9Kh?Tf?<x|O0^<A
zhS?Nhfk_iw@D;JGvL3@Qf^ajFDHP9%TcuXC7{9=O7H(s*g|aybtJ*3r#@qRe;Vvdu
zsG6g(Q4(5$OZd;jA;v85b96RVl9ynp6NbQ)LkP}cY?6eQVyKS|_c4V+{~Vu9mE@%u
z`a;9Um?B|dj^9SLp=B8QA;Tw_5@8UY47N>PhM^EJe3B^@hUUa=QX9&`PyiP`&6Eqn
za}qYSP0qs5_!U0GR0>IRHThIK%Er*}6#kT{7Lw=c^4WGd8$+c}_#8k>+PO@=)Q*;8
zsBj5iU|IzITwlK0E-%N>*%7|TbPI;L{(Pzft-#RH5WdV*^a?I`BH0dk1%_09_zH7e
zD4rY7mpV`mh7@-A8goi0o14g2JLDV;vD@%<=B!XPS7WC-(Mk+4%kWL+yui=Z+1XBc
zC5BvG_!e^sltacYb)r=ma#Z0v%vGU(uFtM^%BwI0XTo=x8^XX`zn$trt1$#6!uOfm
z!XUf|Y?r(m0~sHFz}ypt=Em((7g~dXgbqJq9ty*A6Lz&rUV{OB4L@c^h)HQ02i1*o
zF`$l-k$I!V<TRaw?Ur*fux*i1dE-QF8sm_<(OL{FQ)EnDil|TXIn-`>Ee3ccGBz(&
zG^F_*R1Y#>fE6O+^U_2Yynk$uY{1}7M<(WFip6Phhtz}CVQ?cOlk>90vb2Ol?UC1E
zu%9B+^K!+iG>wxAB80(ih|J70i+q~S$p&SFL0^u{&2xysG{z|f5sg7ljHKrkiv4Lm
zry7)L4Ej+dBd<stNb@_X5HeyA3?hs3O2k2U?b(oQ#Bf23WaX8LLuqlR6hbBpH-bn`
zUb#4&mT;;e*@WQ)7+I57DJJPOE-H-77`A+<^r#k-bvhRtmdzNJ_=qX5QPk=fmlQ?}
zhIcw*$!ihyI-g4o%M6C^Fk;W^77aSTi;AE;Eb_XD8*mU8tTt>!&cgvdJyMW&TrAeb
zT~Y*Da1*~EvN7+JSf)$3)QD`s&3r~=bKY68N~dvCQDns}{G!O#yz}s*bZ#~(TX8GD
zII=zOk{Hx6ZYhdvSmKvPcH~_Z`*l9I8kKFhjn9hg%DW*B==^RfhVpSczdW)h@3uGy
ziyRx1^Kl2C6WNz{PaM+4-BJwMaVNhjav<-aIIK&!)tGF@UHqCzMc#-&(maia>O~IR
z&999d${QU>o~QG$y|M%M@arOn^Tq|V^B9lRi<~&f(~+9Ilz@Jo&!hIrP8{M*k%qj~
zfMK5BLt*5?VV;Qyd1(O`tgS4TT{yy9BF%Z3f#P{_kA#sMM|oSMEiXGzHZS2(vFye%
z-X7`7%MDb`(|9R@Jh+#4MnZY!06$OXWr^&;n0G_K(h&&GW4sbUUQBpzq%W^9&_B=T
zRf+7yeSAUWSYA<JV4mMg^`Z6nU4BF4L|#c?5SDbdPhO9Y@*5*3^GX9l^Wt8q4;A3|
z_)U@1dF6rOc?qxDCl}yj{N~7+yvjgQx@JA~E-J*w`7O}!QXNQ6*R5yYl?(Cv{MN`h
zfE=~y%zEivv;p_?+aee8S_1lX-+J|3c>_MdZ;xEetLP3G(*5hHqlm>H@V>}pz=K?{
zm9R%;7Jta^h+N4#9w<(aua}OZjrf=R&d9aAQ-QMd#Cr9pyb+(|cSWw}oefl_YYM3M
z(6jgyzdLd>?>szOx&rn+`C0rCzbA4l?-Do-Oo8+s+Jt|_?~UBayBg?E_Z6t`$(!(L
zeqZEn-i^ROy1#%rhMvQ}=J!YL=iLqr!VbnBlb^#M^9Ldi^6mwO(&GivF|--~hCdj2
zl=m<&oSrC9kI9?y8NMR&IB!H#(tJ%JbsQDpv;3Qpk(SX-$@6uE>~XmWf5IP%jIxYt
z(#~fJrQ>J|9^l`OjIpFN>F4_j)#LIO{3(ApGS-sXWSH+Sq~1rxSmyna@s_kE7i^sD
z`*JZ>_?pN>OJ-B?{CJ`CKH7?Z%hyFFTe6$V<|hi(_vNkl9N!R`Zpm$`ny=YF^`qzU
zd7g{Rw3wUt`MM2kzx+Io^Fm~<#nBX;&uozT(Kh@$J`hQ_6gKtG_ia%7<!$%^-yF%X
z6g3UZ_ivz1pcnA(`PRr{OG(op?APoG`33wL-xkTTlr{~`k8hAppzZh%d`Be5Qr<K?
zKe0hQA#cYQ`L4(sOJ!5i0u4)jfJ*Qsz6TnAs+*D*=vejxxdeaChax6RW0Q6P!%80@
zA0Ff*5sRgzNx#6ysvpQce3_3$?3V5(!va4`eTZJff8=q*4YZgGjtT6C@{9NjzAsW>
zIo?#fAkIo3q8<28{L#op%c-Wa1qoLDP~L&B@W&#XEoYmm7HBq7zeF$LtNi<st(Nn!
z(&#p_zm#9XU-Bm++bx%xf(w|9(l60Ytnwd5c37@9^)K*kRDUV&#Mk(fkzJM>O#=)3
z8>y4%W&CIUqsSi1?WRFEov<h6m+@Ep>Bv6Iy{4fB@r}|+v<v@*|2T5M@~~-mL1LqN
zQr?BH^JgLzmJ!WK3pLMDr%)-r!G97tWEtI@yioTndrB_FU-O?v4qL`GYZo%lN~h3n
zJj5%J8cRyEexdJK^_09D-{j9hS}wKOu+aZ3^${w=f92y5!IIYOf<qDekz9tq;V-~^
z;mqdZh4E*lkI)|cH~zCon<cxsY+>SA^&@!?zQtdJ#8GZ@)k4iC>R0F$e4GCqq$hJT
zzfiY{{gwO*PVko_F^i))xRBW-{R-{Hf9Jo5^jQj<`xp8)slSr<;ye76$T3S%^T0y?
zCh9bL75{_(GIGLF(mV)fG4{0lD*l$g7CC7tZ5~<}-z1$z`|v;cuOg={<;}wj6Pwi2
z@;-c*zaBYbsccTl&^$-|8kOUF{MS$bRo$GNp?i+~wOo$B<8MaJ0TivxV4jnHjrQYV
z{+q}JOGQhwKEwB%`fGVVzR%x^T(opI8#4UQQ6Hn%@W1#(<TB8ME;s|SAIq=d@A*5C
zE0*KU#ToJEq>s@7{BQo-$TiEU=CX{$bLz+P0sMf!8@X;d+gz2Q*-ZTgy^bI9-$ia(
z&cn{5+syt(ejWe7-;dm~Tmom3*)07A9mN0PzmMFpTy5^p@NHIqBOk<%_y>`@mK)6j
z8UD@G8T1DJFaJa2zU6lFARIl}Gx8hwNB&Xdf#qKFP)2;SbOu%6|M5RY9$6kX4`(Dc
zt7qg2{Fr|nd2AWcl9Z__qRyg9JVJOPI?_72B{@@9#GaKa@e{(x=qT&B7HuX|B%MWX
z;w0h8=oo8Ci$2p=q@I=E#3O}K(XrOl7DJ}Li24Lo;hzYa=y+>diwjP?>?d*+eo`0{
zooLN$Db9=+NuQuY`2U2bqLZ!JEoGUBBJ~sb5FRCrjZU}bwp3+mwon7;Ej(IyIy%#8
zZs9X^Ti5~lEvym7N9S4{Ex}A?i!^}V#y=IFiKbf%TlzD7ThsyhZ9GPp7|pO2wG3qX
zw@{y=cks`INzujDl9oX@XtSTn@8G9|$<ZupY0FS%e2ercI*flVOpWGP%Ugys6I;|z
z<->TaFg?1)TG^7cNK;J7s2YzGW<ViWbxZOhT`?=m)%a;)X4GVDY|$=aiX|EOak4Nw
zYO%Jo=ok5lRay4q@xt7w-P+w^SmZCJ6m$gtLeNFs*4`EuobOphK7yYS(xU~|<1NLD
z;>D7JYVZVML3E?_R7=^SM6s&KHF%<s5#4M(+fubivz7WSs>Lb7qUcuZc{qsZwz9vK
zYw;vuadf-&QcG|VvsL;ns>779G`hojwWWWNZ>#!SxeiYjvZA}JH(CZ3`L|N%P(7X^
zERXK7-fkI$YXy5wuE$e_oajF5y_TUx@vYK1)PSc6tD*<24_k&8CAO;P<OV!lSQD+V
zj%ZENYo4dhqeh%6tc@PBj&4oX>z-%N%Z+%3ur7MoI<8f#XP%eNBMxf?I$C2*Y1Qj}
z&#UKU4$l-!(FSX3t3mI7o{A$L&k~rZU`=av!EJ_(%RHVfSfb6=%+_Lk{CO#k1UyHu
zMcb^|t!4Ve^J-ic@La(j?Xu>!R_Qg{sNW$GrwPtz$ZBro^}22B?_?3{1UD2oI9h{x
zW}Eao6u|QYZ?w-^*xIl6ZBu_I2XMMj5ItrsY8}w~w^0{R6P_<@h@P;Pv<|{0ioGB=
z;RV9R=t*m7>ySRaO}c=Z@j_u!^t83Sby%O+re2VnafYxtdd6DWnzUH+0`+^;f-{9J
z&<|JLn!H%|0{eTp1uqh|M$cI*8e6rCnHQwrqgJdJwnZ;kTUzyteJ`lLms{~-VSDtV
zwY$}@*#83c8Itf4!56&@aIp(6Z|rBXgqI3CqF1cPTZ<RRUywdSZFrfmGkVQ>s<mu!
z;sy0HxeaFtyQ0^vXIrZlYqnE=K<zkN*d4uTJr4&{-FEg5aywow?1|p8UILPV*)IJ7
zb>J1k-sm0c)z<#SzU}HC<PMx8?2F#D-e?_I?B7mZM4fo0us?d=db@QH?u_h3xf8Dv
z4n!YV@3jssj&GMPqAt8zI2e6oeb_p@II&&5D0ksCLPhkkb%d0(L{matLftr5cr!ZE
zHd;zvqAOu9$=!IZa40&;HcrwmVM?S+s0SN_x1(chDUyDPuSC5h_uzHH;pkXfs$^K=
zFQGn1L5u`{bi6H1a=}%V{ag-WTBwOmv}H=gOX4Nc=O~1YLS1ySEn6yEk|<F>mqXYj
zG(@M{a;2&z8Xq-?!q_Zu(U~^0#4pkL*g-jr89|87wK=5V62>PDq6p3t0?~9^q13;`
z=Tise2(}2#(F|LWG_b_)qb{Q;whFD$#kLY@5N^oqWjTs%LR&P;Rw@lGiTk9>D2DTe
zj%bdpTpC`I@Tr&O7`6*t(KWV8DQT(ZMe2{J7dwO==nJftl9%dUWdA7lVy6&_nrw}d
zb}93s^hboTONc}*wiZdh)c2zLM;T+c5R2Mv-I8Ic|3&HxM6gG|QMavEa>2!%{X!<#
zEA&MRY{#YIrSTV~FHj#|FC2|-w4IX5mL^_QzmWTIfp9Fk*>+Z{TB_MW{RzE`3x)Ti
zTW#mzo}$~q{z-lpZxBvIx7#jB!KKU&=}+h=W`z%<J8V~_{-wSh>YwDJc%yJKy32M$
z8d&PzL0v)b;b(=9qI+z&r9sdG*emjTc$08Cy3ck`8d@6PAzeYo@N>e)(F3-J((uy6
z4)uzB3~v_BL@R6~+LD%OUZSp|<G4upBznj;x-EH`?j`oBd>n5PK8+r>jcd~`V_uT3
zqW5vJphRnIDQ)^?zL(Ui^80wJa1P@6scnX3{+FmPQ9piOh(`rmTAK@G2=+_4A8!*b
zM4N4yZN<ytFG*jb6Zi$;vuK+wyRB?l;wAM<`2^lBT#R<va@(qwX?9X7`T&;*pGQMB
za~r=*x06-n53o<T423U_w%{^mr=+3}@r%M2(LP&YTmLfOPF0mZ#5;s5(POrvwt;2-
zozyk-OZ<}XW%Putq-_w?5B8e;OT1IK7CmVzZ5vt^-zi-~C-KX|SJBh9^0wh+iJj^-
z`6S*YT#ufyRkkH%X<nxOj85TF;cKXmtf+2F&eFZi{#ibScMCV8=OA^Z&0=1b{)|4t
zWx_Yn3$~UveU|TK_0RH0c#m)^dePS1X2|ltOnrrZg<la8(aVrMaDnQ=ekK13?-lMu
zuh@>a6=%g?mcBx#@vFkO(QCF-ZDm=Bm({Q2(|Dh7H+tQ6wyi2lvy1u*`ZX>WzKh<p
zorim?ZWsF(`PX>Aa6fv>cBw6x#q5&)f<DHt3ExNW*siwqXZd!ie~~}N2ZRUFyS5u`
z16lrE)OGY5{JQW%^uFzO+aQQN>~;A!_@MA8`oMOtZ73_gOS+EE;5URHqmOJ4+lI3e
zyVUFQ8C)Sejy|@HXiv)4lu|d)SzIYR5gVC5x;;5tSIXXy&*C?Qk+D(v<Jz^^OsRAO
zeS)imCu3vsQ`+^}zEbsu{0TlJjEarTPi;43`%9^>(Exr+(8R{)r?tC4V`9IS2k_g%
znApVp%=Y5!c&YR?`V_w-JQbUqpWR-TohVhmmOsUZg|V^e`MK>?*_z$d5R!4V@N{fu
zzPX*x*6n78WEuN~@v*u2j`m<Svs)TM3O*t{6HCu8Z12zZ?N*0m1=k1@V;T8H?E~5V
z-PBF=TU;wliY?ABX&(e>i@hoT7S{=rV_Es7?L*n|-O^2T4%Z7)V>$Wd?ZerL-Re#G
z9BvS%$JXRmwkIvulu>_0=W(Mj1L{Pp+mn~;%Gkfk=P@VDjG6Kq+qKJ?GU=}<j(K5r
z%#z>Iu3zpeQ~xT*u^`Ni+4H;G4a@yy)HmpNSQK<IH$+ifps2Cm$iKq@Aw5=*f4seT
zdAv;e23^2S!h+bw{8Q~^%M)elH}VDCEM&ws=bvq_TCUkc{SEyd!!+vH*8KAzW9as<
zf0KWYVK`)Ld;X>N;Bsb<^f&YwhFMLq9r;(=`<MInsDG0`!!SA_wk!We`@nMl9_kkQ
z1BNE!*q;2`?SmlXvA5(uU?>)h?aRN{KD0c(N4kYBV(9sa9ms#!KD<1!N4+Iq#1OlW
zRpgK8NLrzJg}RL{VMxKn4&{&TNM50Pg}p6b!T_bm4(E^S(5_%!k#3{UF)(7Wn*5Xw
z{R-bJ>TUUR43=%IAwRXlu)_Zel|X|S6x5iIpVr|5{g6$_gBUI}vF7~Dj^Y*ZSEK~G
zjA4C=wdH4bl&wg-q9)|aI40O*UHQ2kRVy@mslTH?;$FcS3+0<T_!YXn?BC@-Vl23!
zAj;7ZT*2&>{*J!DMDWJ?@(VlqSNQg-f0w_&eL_L(SbkB*zzY9f>JIu7eplEKJCR?~
zF$k(9dq@5gJ}PXCoy;%o7+MkEE8Rg?@O#3h*y;T8j^P!Fz3LtL3O*)mj-AP`sO(6}
z(Y#9i16{?(g)LAoTiubIqkEP8hkO;kFKmsSgOsK=hj~@{2l^8C3)^BB@>@FeIlfob
zf5>0r6T<e`#r*CLLyrGd>RY7Z4+LNAGDMSHpq8@V$}0X)*b%#uf4rkOC;qDRExLw(
zDeR10%RkjomXml@{Z_t)PYSzY*YnSIROM*)QU64L#;1hcv77nlLDtgkWB)1t8Gj_~
ziQUS-)Dg^K_DTOlU*TT~dt-O<uXgn3`1Yy)l)u8Kg?+KR`8PTSa{T+KyXY_Y*TVkT
z{ruY<gCNqfcjdp}kA(xV2l@9phH~Qjq`T-k{*7=j_9*{h$8b(!pL$omj?V}cvB&u%
zI+Ipv%Bg$k20kmi85?OI-I=^nSI*v(Z{SaaL$Oizah=+gOu2LqeT@f%w_{`MDV_S2
zzH;@R{5AemI2;>mPwh0U^p{iLp&={_{@8eXTBmCzE@!`!hp-~l#3tG^JBwGw%cbwo
zP5fJ-E;iYo-C4FWQLcU`-^AyHhS+p_ZfDg>&3<Ya{S}`VxY$g)xszY1+s_Wmf5mY@
zh|RS-I)f{j{n9Y{2LDb7#M14Bo&76)`_*Cj8+<`%j%C=3ItNzz_fz-L-|+8+*4Scu
zN#`I)((HZtZ}>BzEtX|3?HpPe-!I)qx9}f?j#!SpymNSEV!wJ{zJ)IeU9mOx%Fd)!
zn%Ag*q1*V9&;xD5)t$+!bg!}hl5gYBg;307Z|u~rVqTN}g%WsBfV;Q7rBlDk_nP`I
zIe{+=v6$W7-Dz0me~tPc{T=^Nz%e%@)m)&2v){{q$6pA2u>$+?&f-<^*QD>!9sDQZ
zXl$eXRA<?$#B1vJ@*R9dI2PM%KigTgN^^kvH~I&@D!d=tYCjJur|tmzZ}}hiOW{Op
zyZusUa20bv`ZxL(tHOt|9rml8{i}Qj)PKw0;%mam*e?5x&Vg0_1JncbPyA=$qu3t%
z?ao0E;MoWAKk-+>>DWH|z0RRk@dMHWbQk|c_&9dJ{;+d+RpNm9K)#Ew3uj^#_7Po4
zt2M7v579k*L--_i$UeF&dA06!_Mv<ae=U3(J8U1<rCrUuE<Hrw;UPhZ)!0+I^s9ZZ
zs}JSx@J-<y^Z})I8CLsWr+z@g_^(177KF4e7wG=%5ArbnMz|1bwr6$~ua3Vi{ebS{
zzX_kk+U(g~Wvdgft3Sy1@h#yZl&s`-Rjt+>r2d2cg>MU=18rmO;#cbqvj36)g%iSM
z_}Cp?!PU$`=|AXu{CDAtSf9PHtADlcp!y&AdwfT@5<6xu>Ka(>KS(`7|Hl6izKor)
zmvjw+-M~JQ|Bb&DuEkE;OS^_v#}7)6&;$HW;j7qbdqsKI@an`t^^yDl-xaRM&e$uv
zlGbS6p#F;<;(Nl^&^}$=mAppx2K!(6A^uLd89N85ZtWW84e7t=2Rtl%6T4t<>C&(9
zy`lbB{sG??ZpALzySof){BKY{qW|E335nQcNG`g-=3sx6|AW65?!>Oxk9QTXiN7KJ
zh#uj83*W}B*-v$qtx3G0{wP1f4}`n1>-Mu<RckaA)c??b@k8Oe*iHL+P`z~(?EmEd
z;va<jv0L^_UBNX>h4er4BmR%@ee90?YFGanUxoTV`A7Unco4g5ztJ_Y#$Q1_M*qYA
z6@G}_x8Lp>1b2mfEdLMxC_IWiu;1$%S`)939;3(jf5MNkNA`zZ!)p>1>SOsaek?qW
zJ+_bNPRi9(QX}XQWP}I>ACA%8$+@~pc7!s5JRw3`hhto~HkYZCM$k`?BoV4N94X!U
zTwkR+LV1FW6ro4Mk=kv@^;c3)&`IPcB9vk{(z;z>>ab5JN#scp8ZI1}-Nm`_O6duD
zB>6uP>M9)B-DSCnO7#h4BpD?__k<(2yDC@nCY410gp3xUNWx+6=5uv#vPsHMh(?4~
z2#2FPn9IB=CDBikpNdfN;3(|w&-J~jCMi#nF(ULeIEuOla{X^oBkBJmKNF#R!BNsZ
z2woC9Qu#mfln6}<j?(U--1wW)NO~0cxd^ogj`Hr|+{ByeNM#fmD?-JAqp~|`t)`0l
z2|b#O6QQrbQQe)qR#(OTL>Wz<7NLB=(b%nB%T!4}p*18~geCz;OSgWluS)%iq9Nl&
zs0DCzcN^CFtEeaGpORmQknx8gs|zeF_DSWZ<QWkH`;Oz?#cShL(v$QUGC_p&z2j7O
z+1f;v`lK?3OcWtX?>O6CwN`V8`ak+-Bt?W=yyHBWAi6{B|0zEslSBx)J1%tx*D{Bs
z|D&HGln9A+$JOrswZ22@|0z$A$s)wh9XGlM*7^@oqv)TLDI#Ra9k;s&!8v0`DL*Gu
zMF@sF?sX5XjUSRm(PPOp5mMfchuy<#6Nl7M%2+a8gv7REL{E}I^A<Il9!F9|h+jKK
z_aqy1Z?U75ab$)FF)+ut9<70SOBzi-O|&9V*^ZPRy}|dEI$C*}%oG8Va-{Yc4F0z$
z4V_G8i4a+Kr1iMKuwyk!GMO!cg6PQXDK^C4k~H*qGDn01y(7D)%#e6X)hOf1ToK+c
zM{ZA*LGw2CQ~DPqO@x@Q!`#CgbZ@giRenKqB4l<Qj-H@_d0YA^{S28WLIBrM*wb(D
zy{-OKd4{BmkfwDM^$ZyNZ&PFF31q$q(O5@G&mj1O>=<PNSs+5r)lpH}Gh~RrEsdck
zl7%9qRvqO%!-mA$>KJ7r$q*rd>Zt5VTBmu3`Wc-<GDV1!I;wk;*XiD2f2O36MIvNF
z9gRKOb<8``&*(`+FGA4M(bA(|=X*!}nKFqi79q9i=<YGB^S?tqMN?#n2oX#OHoL%|
zWS>$fvQ&gTrQ>){@w)gs(o^(gvP^_<q~lai*}B9#>Ql;Ok|jdY(Q&q?YMtgV^>ca(
z$rd5D=r|9inC>w9b7cxyE<y&;aj7S`jyWv-oSsTnh!7}rT<z&!=R2(aT$xI8L`VlZ
zZuAVS^B<<h($mOF5u$#M+dYF|i?U;tX=IfMxjo0do}qQ|!_ruKI$1432G8-ZXLw!W
zusT+mPS%JJsB?@6CLv8VHI7atxgw<FoTG!uNLS5{Q&P!V5u$F+aX~F&s-<!C3}O%=
zx8_U<>XENn9jDA7>qH2lIa7lM<gcclrnLl#kSKGe1ziYNvrj8pLW>X&b7lsMQM_7u
znx09FB4oXs*}*cDs8*j=W)hPK!7XQQunKAXR5Cq_m_<loIn6;H>HKW6GK(-GM5>&Q
zU=T5WDVd&4@<hl-ISYgR$mds+mD$81LfFY!6dXW)KQ*47L#!esmz*WRK`?>Y@yZ-x
z6CsA=EDa8!xL+Di&n5XHM2ei{!C{o}tK*fq#4bWU$XOXoqBTdTU(jj9Awt;4SshHK
zbw}7=C~3qgLUPC17}V0t5$PASj<`gK;W%4@dfInH{e_|<ZV@sy&hDUr_8+01q302g
z2mu*qZ_owaGy9A(k9b8$yEu;ri|P0g=@~kmtQR4=;ye{BqZ3EeXOwhOAVLnsc{W%@
zYig(o^n6k%La4-f9z0TA4Ld=ZPd12<5OH1#25F{7nm{igtO#)r=ha|8?W<8IC=19&
z5waW38^HnEUqel#7m{a12x2&I2M59OW+y5O$tDp}70!FXAv#_oO{6o(b0Q=poDYM;
zbfQL`sAQ1MBE%h>BSJ|=O)Zr|XObcjvJ1}9p=6`3mQ7JI$rcfU2+naKt&ypfQs_mb
zScFu8GbN-q`fAk_Wf9pbLPWrs8ZsFDwbUe9Po5Wn_jjg+T;Q~`lN3GKCIY<g%nTJ9
z<F(QxdNFxH1QOqw9V#;>YSl@~VzONXtlpU$sxoToD2iS}N<?7fo#qg4)YY++vV{0V
z0N$OBP|(QKNff=5yeI;_?ko)T8+~;ur7R^oL_pD<MWF$szmA$rFC#CBz?C~IN<xF+
z@UxSZWn`xal(@4rG-Qm|Nt5X;^0ElTx3fGnY)sUtla(y8O9Xt|Ss6+)Y3ivdbT%m!
zfyH)KhmuXYdUlGEO?Ha_Ry!L*S`$+*O`(^QG7%_gXG=(L^3|(Tl;vcP2*|UuJ7h5V
z>#3>q3i65w{4y+vE&vPIsmcnnR|FW@c|25Xiq}h1=^XN^2xPJIRH)39s8^>dIb@#*
zn6UF~sLG^ipr+9)Nx2Bjuk$>3=DG%UnzEAY7XjdPUJ3<GOoKFyUPWFLfyQ-S4fUIR
z4eB&y6*(XRTI;+K8Zh}AsOj`-^129|tn+qg5O@Z5y0V%a6oGkl-U|(x;tkStdJTC)
z1c24~Ff?pRG^o>+HKalW8r3->oMhHCQmJ$<sT2V%b&U=un{|zBs*+3I6oC_UjSFkd
zOrw-auO(F?K%cIZu-@!zR8y6;<d6sirz<sVF#8*+8MJ}CB?6A=N(;LHqhMz!2J*HD
zY^5tRTx^avN;Bwn<Q)+}Nmq8b%$#UcXDI8)VG*cDS8lk<tl=mvjYzc!2&2m!=FK{e
z)hdYiMc@%#j&RV-aFUj$$q^CYLRVq9-|XX5twNI;5lBH-QFy@Y=ct*qk<^NS{kclQ
zgFtVvGZiDL69M6Km4=7RaZZ{^n@GI~Jf5pOJZw&I>P*E%8bpBWT$SM@M#EFHXftUP
zfs}Jqhm#o{&(2cJgcAXKb2Wyw48u#aXom12a9OUFu%7Yp>MVsJf(RUrt2=C9{5&<A
z&Lg4-;04rRxBwbqXDfLmAcE2EIvy@&;=DAQwvZ+foK@GUa2b=})!B-LG>hP*xz2{G
z7>z*9p{=Av1nb0g9uNwhz|K*uq*Vl|+;u4&WEer3L)(ZXf;Q^98t!L&f;vaBkv0*u
zFxQRn0OJ>^xpY2h7eV}R-3|`|tHRDz@=1pXmtEJr@DLLhq`9=6bc%4haXkzVGYLVR
ztJq1G2&Y-sh)7bNMx@ec2k92!_~IHJNzT)WY?|UAJtAyZu5l4<9wSO=w37rySf5-e
z5q+LdRMQkE35oDLx>6&CJikckXcq~K@C&%oA}&B=Se@b`5fR82S7xL*FD^<t+D)P&
zU@WfeNLgM&RCS7*#6)0HT)B~|JWYU_M|()G2!M&p9O3hH0d}6^Ay@=j#N~(t^O%4%
zkM<HG0{Y=9jP&RE0_r@)OZr6MI9wG)k%2safJ&#=lXpd+GF&B*K|piZbY(p`Dgt5Q
zDvb=~#RF10T|nLw0he%<M~3qf0X1DIAjd>tA6%7@B#Wkrnok#!<060zuIfm#Mc2g6
zR|?7dB2Wpg#)#I!G)eR64WwTL#K6@O(OY~?>U?DbIUxcs;OdSTEdC~H0nL&RL@@uM
z7R3cb5W7HO$%i61`L5%UVoSV9T0n0kzZAiicb$rqSrSd^0%apPDT2rDIvc67Xqu^o
z^t0rY2!^@qJRmi?W_F?SEcr+T_uF+T60|VQ(n5L@`IQJ(w(Dx7-{Nal7b=^`X%T#B
z*Nw=4#otV2(9e-yi{LT4Zbt^;>tHjK=g7w*7{;!9ks(XGS<0X{li!Ho{<<DUhAoL^
zHAC4<&WK>;x<*8kteO@olP)4>Met?aqoc`IT??D36p>FvFj?K>qFO7{B4yHB$bblr
zsXHaAxB6PtOl1rCR0R9eof<V*{VmiYx|ql!c$x0BsLP65*hNY)QA98%-I>v1YrI8T
zL~kX(6~Se6XGhDdi57K{vXz_@!7_B`MysrvR!UDlPtJ?r|GCXk-l}V5^~&=kE`pio
zc0_|#rd86@+sN-kaOT{F(SED1Rn;ro$ORE>Hg{2U!0K<M7Sk_~--}?Gxl5vhfL*bR
zl^4ioBKTkK(&&&i-YPAox064JU}m|?qr=ujtGZa(PA-bzOt~wgNj8l{Eul-uB@t{U
zcXc$`rjytuN(uQ~1kcFb7}eSsNm@et$e;)Ykh>+SxA`P>iQ*%dMR0T6-BE+hFHuYB
z7s($*ux6ko#|5+(yHt6Rd?A9*;yxZNw#6lBDZPXINd(ixeJWaJOGxTcWe2$;f&=0{
z8?CZw+NfppOXR8uc82>r5LUW2cA4@L`BDUL!hI<kv@vbcGI}RbMKBuNSEKzlUz@s2
z*-5U6;2OAZL<emCHY$sLnfzG<2f%$hItXtko29%=z7j#sci)Q++2U<d7QKu7MFef$
z{V+OgOSGw3$}VzU1fktMB9@e|X{WO3QgTBC)!aQgmYlC^XS0=3^0f#OxO-eoo6odM
z+4OEQB!ZspPKoLBeeG(tvYXr#L7aA{#tixXc4|3YM*b>-((F!)xqxkBmn&uD8xdq<
zcV?_OKi)1ar}vP*iJ$?yvtwoXiFS3lvWMIfLC|&Q#;Wo)9n=c?6>?hyb=GZ;@%g$A
zc7^f^Nr)h|x*f4#KGPwsp!br$i=dmjD+*)%`MwTyg|e625kUoY7sUqh{T);e{VMr~
z2#Th=BsK_49h;-PO1>3Ao^+SShVtVbQVzY3{8I$2(On)J&QElxIm$kAR|MhET^UQV
zYdWcwbUC>vf(q!ajwRc5o$N}boO~yOq~~soY3)p>w36OWhDFfl+$}M^-PftERQ8km
zB8YA7?wG;u@1$1IuaSR=pq#-C%mpYPyGnVDd@q6w<~|-Pw#PfARrCS!ZxJ*t_o-N!
zJ<+MIQVx&@A_!FOv#~0>ri)rlzfK;Cpf<VB197M8Vpl7#lOIHoj@*}GK|9kWt)>r>
z|A?Rixv$3h?Y=H`wQ`U=5<$~(--r#^{aw@=`VI155d<3d?bsl!*6bSP4f3N1YK!|`
zY{(w(lGe}_<bNVaC+>%_VSA!WU87Wx$0Fz;?h(C74ox?eOIMN+0T4AjqkEGbx^6aC
zsU%MXK%wxA>(x4#ZYh_3lOzQ|Zt$e^>K(prHCK6)j0}Kw;7RQ@IQ-qzTDpq-BmhEy
zC#}~7;3B(LsUlAX;8yR+>@9Z0yQQ`CA@Y9#xT1Tqd&?Y&Zgs74h>QxrecO}UTjkL7
zPzL%fGCBa4XOFp;cj$UpgYp*91mGs@ar6cqOpj!s-zGl|z_r#>*xT>$^{58rZ89bR
zS5!|??|{SKL#?CVAwLViebZCYI|#fayH0tBJQaY;qo=fY$Pw?6*3pN_&jWB1^py7w
zI}$zWI^{4K8-Qz_r?NN6sR>eut|sFGa7Xi0_a-}aK^7_1<mmuhxIB%$S|<~f5bY<)
z0k}PRT6*<PUr<GgpNtQ{RmjubYjFC56ipu?zX-s+#?#yD0!)*ol_TVt09;Z$$9s#N
z@t{Q0HDp2nZXBLdy=BfsP^Fa`GBE(x2hZ8wDyJqy8R=S*5`epa=R5$Ix)5trYRRMk
z9PB-pdV@|TBpK;CLIvQI?z!6A@AQRKqf$pE2jIl*xzRh|^oJ-DT~DS2;P~vh-8%@I
zH)~Sr$<zRxg+2Frhn(?{WTG3$v;Z7zJr8?_or#cYQX0tg0Gv`iBXE*S6Q;~`BS{Uw
zk<&98C%bfE)~qy=838yydd6X`iwR3+nj_i(90olpSnu+MRkOm8nE^Q2c~Y^#<quN~
z&68OHIHq~hunVA6mQi>zI{;@cPbMyQ#lsRq3uI0J4p5$KT;@uIRYnoW+yI=0Jh`~a
zrHN2^v`EqdaJ2E5G4Ikv*gQofx&WM0JQWTcbTJVrj}DM|0XTJd3UR;77g6(+07(zP
z3Bpr^2VDLLWucqM`~VyWJSBJ#U|80oG?4`X*xNm&c*qrxNEW)8EDXR#?J38@u0%w&
zD9t1z0K2ZI5+}JeQOZiUkjwyVp`L1-?AAqDtI|Ri1z<n)G-9oriAq+wmFNSoxp`W!
z-tCL3R;86J4!}<3>Ba`PKT6qXi7W}gwgaVVE?{t3n<9~=0oX%4$8oVc9+hl#8(9{B
z4Z(8?m$?&B)uyzOtN^U;p0l{ht%*_jbUVooz*6lw4?wOi#^x*SWO)GAUC$*PbTct2
zpY9+l0<ea9uHt^TFQ(=z9V90J3!>)+9&r0(l%4J*D+92)d2ZuDILxtjrIV}*z*6P8
zhlkwpm}IBB$m#&BJD!Jl*qw-}cBPA~3BV%a89|afnqJC5caz)ztO(xGB-x|uWgSX4
zSsQ@Y+dGbEJxs6UpnHfR0Pm_dh3GxLUe%%WkaYog@w}<T;PLlTPC7_X0Nx^R8gY4W
zFY8o-gbu(f;mst)o_Me1q(j6QfalwrP0BopUe&3Dh$#RMt2dWac{G@E(P3f^z?0`S
z6W*i4tV;<KCIF9-*Fl0F21_nFLh=IeNO%iLzsHAFml7eC0DQmRA~N9dW6DiOi8TOU
zmbZiq0_e=Tl_;?V;FI^3k|9qVOKv(w@&oWOddtbMCxKPB5+n8id?wyXlH}D8%0u@O
zM*#kT-fEKU)e+XC^b%(Pep_!N(Rvvod1y>r0r;!EEky725!It$;ts&i@pcn~*H0)f
zO^7D|{}DR&T)<beUWE{EppO)IkCS3=oJd}}kE{<IB^$k`NSQZ5RIdX6H*kz>_MRnG
zUQHjho_?1U2Hq!Iz2||?*7dRLm3PU8zzMS5dx-?SOrNx#K1$fYhh&HMD(Uz7`qcFb
z{J_9Tvdepe40!#0Q~~`Sc{cD7+2g%U2H|Ya7AWtLO@Y&7pZ6Xa^2Yn50{R$vF7Poq
z;C)Djy@@`xK!M*OaE4TPNAxAF*St#=(#J_r;1hDlJGw7<z3yGMP&rPv1U@B)z2o|{
z>zQ|@Li&AD98gG&H>FR%-uJFrsKBosI0qvZQu_?+{qIs6=zj8iAPydDTAvGOa(08#
zPqqavkY;aYU-A0*yV3^w1bHFw8ENxo_m!<rysK_d;9nZJNV>eaeO2o<M=6&6fRqG2
zCn0ZzxsPA3JIb=k2gDb+3=?-8eZlq2QHiBLBrgWOAbsA#zW(*TqbjSwrxUnBj(Lmv
z2G;wJQXA=Cl9vKsk`vyNzCoba*^SCC$<Dwva?)GcH?%%}RN6?NBrgZPBB#COeZ%V$
zN7aoAe4v5r<cznnFR4KD9`!7Jij)SvhPj#5eaQv7_t<BZQ)GAGCOPMA?9&!7?@7<n
zACa=aH{^o1rB7erdry5<f$t!2i(K?}_ZbTO?@^oRUy)Y=333@EUl+jh>?Y+`WN+XO
zx#B(ES6mQ(PufJECa(s*CD**C`pOCt@2Q&<_}T(@$#w79zN!MvG3q(`*Q7k~9l7Z}
z54^ta82g;^YqCFZpWO0Z>I)Vy$E4@zkI8F+@5vqS)xQ1$-!b($1-|LP19I1Uqi>+V
ze~j8p|AxFC_<`K_-tHTOyB@n)`3*T3ctjp}@AVB8#E(gv=`-Ywz>nmS_hH{~LE@OY
zS%HTm@R&UIj(9hzP;;CrqR*25XXsq~qNw^Xj+n`2CSoS;W+G;?nQ2&QS!vje?(5sD
z;TtS7z}`Sv@q+6Oui)Z^6)%YH%<OKZVZF(ov%9my{SFIfU?3AQ6L&KaGug~U%*4!m
z&z}IFopa9b`F)?~$+Zpx!xO?_gj&f{TGZs+V;v4gCWOOiwTicEiDswSIs%MJh=j3f
zBk$KD{Cl#F1Y;7SV4T{*%XNg$xz{QK;}T+EJhlo@I^=WivyK825@tiaTH@_GqQ$x2
zIvOYv=0TG>$oq8&{{*dLz~qF5(5#ku<$9vknQt8nrY0<bMQWv&(xX<V#X1g5Pgo9%
z)he%DPax+(>v%9DK@A19(d*YE{HwK20J9Rb(5JR|<px4@9<ojZa}qLOH+Cpc1|&KU
zTNPk#LKf^(OJ2KyXmcL1P6G22vf-dQ==B>A{-IkZg9Qn>Ff>Uf$kT{+XQ6cpu2Id0
z5lKpcN<;0=W7er)aY7-CPErZ>G(vI~S*L-e2^@?~G7A1Qgue~zbg(Sp6pTx<2=a8I
z!+FB01S@a^XFN7WQ0b_{X|>J(i3vQ^CrN@mo#=Ej)|r4#sDh@Xpx{qO_;a$(0-A&-
zXik!q%2yKKIyvhbz>v_6?HkHcY9;#CX|v7&s}j0kagwUkzLGfWv|HZ-nF&2mNHUiC
zS0elcTIYiG3BAylWGR)eBEEBeW_<^2Oz4N*c=D%Kq3@iZTjztV2?MY%Nh-CkBF;I#
zu)Ys=Bn-j9q+qFk6~Z5_bpgmp2yul{vNCxF(d9g4{Sf3Ogt;OpWf_%$x}0BH7l8u_
z;jU;(Rc6m1&O3{(1Sm*|bj4D}GJgib-??=$IGPaUilZ!LawF00{K~2V#}i^)@z@1I
z8Bw?MYwJ?LCd_u}DXGkEBrZ7rXZ;vB66U!~RIto%MEGQ|E(0eMau&MGl&oC7n)u#%
z#`+03ov_4JL@CRu)#!U?iFE~T=vwY7rc~wj)x<@o)A}g@32K)>8O!~v5k5_<iNKSf
zb@?buxjd8j!3nKNpfn-F)s5XJR3`et>9W$GG9k;=M@i-OOyZK$ZA}5S3E8eeDp>B%
zMEC%*YCvN`t}B$5Rmj&6Jx<=L!?n8kt_WILL9IbOPOsGf+7b#~(X^_<zJ|E$6s+l>
zGl6r((#8t^8ida*>nd<A;gl<mwp7U15`Jfy)d()&NY;34dZE@Lzq8z$2`(k@E<G((
z*w+#PXN7ew2qaXwOmwiqzZT(R&bl64O=xnNX<4Ow9r2^H%DMquPiV(>9%Uu94*lq?
zwr&JB6S`c*w5rm+j=18iv2F&p5_(($ZLIXKL-=I0ZUuJ|dR;!+QYl|g{N${&ZUgrc
z`d!^v38L1cpPcp99pFL2fUA#|D(&lutIh`NF7PN}$Tdg@EB)&cK1{7S;7LM=J2Y8V
zCC?&yolVv~V0dDfJ0e+GMP;F0XR|dAj7$u7M<=VQ>{-M$r_Z_%j7p4j$0i%A{8<Q}
zzt#g_Ok$KfF4<Bg-$3*^Tdfu_E-}U(pIlN!Z9siaWGw&_5@);h$x@Yl199CcS`Pz7
z;ykx0IauZ2fbfxRJqji#E_9odWz}*M@w2ntdJIfWT;eWDR#sCc^s`g49tYDCm%EFT
zRn>MAal_eRwSpOmYPXPVtoEA_KIN?}n3bq?`;sly@{PnV&Tp+YFefp?-Hn|^)JF7+
z^Q_eY<|byj`;w(<`$poX^E>P3V18n@doVdz?ca#-#b7-N79{4nLsMim@=Zj)v&;G=
zZduNEN2Dlgs7<KfdER;&EKV$RN2jQ2?3;+7v)lSLSenSWV^fSZ{!IwqC05KIB%X4|
zrC4g@n~7hY-&^r8juU$0v7w3DjDB@qv;vTr$h-9^QjL8xam)FG)dlFpDz_;mSmWP}
z@bzQ$08L_(+nge+m2V+_bM{!hz>wIE-CfFBY76?!dD&VDRwZ`1i&Ip!_ASJ1r{7u*
zG822;LW;50zXjnN%UTK6C-%C1DVAFKR^oT(kJf6iF|ps>jfFvKEBf7e#aautCJwm!
zQlwh@R^pEHCu=>}kvQZYObOQdw<3JWSsOu4Vu&X+RaPg@CI+0n)@G2G80LvcRn}42
zXux^R+5!$FhI^t@Rdx1k;;ysLia<ePq$f7jSm)11_+GTO;ZCP0Ph6^{PQHy8bpC9W
zFw_;}iO2RWY8x7K-mrE8HgUE`pDNYaw-NW8zgW)#M`F%Ak0~`+=ii3#U1~jtyL1+M
z%&D?^`F7$DXTSA4IGwn}Q<SQ#r?#U%oI&daOxG;;6sM}{?c0g_&R?w;@xNK^5mJry
z{_O}~zt&5@lc@FhQZ4oJ9mJo`->jEGX<~+_8{5XH9q3QzZEFBjCT4m1Ql)zP4&s6H
zck2~Uo0#nxObyoicOZOYTd#t~#9U9PM%EzTNenp$tk-bscD^S<qimpdq9Ny9>vhnU
zSm=q?s2c1$iHFWX>kZJE$a!Kl#s>dRgfDsPO>i#plqXJOX^`(C{&N0d4T1}aXFT!P
ztw!xae>v}4Z-GmRyhpE*8tl7>N6tU3w?QDW%45<58~nQveivBpfUAj39<xT)DBn%|
z?Hsb+1=kbXvD;7CNbN>{J0Du_ft!h4o??xv(Y~8_?EK4mAKXgp@dz4YqklKTPYLS-
za3`_X<I`9g<vGMZ&cCe>!M((OPd65dsT}l=^Re|2c#t^Y>C;G!_8j7g^B?PD@F;P}
zGpGqR`g0I|eORA>Cy60^s8-e_&m}@Y2r~>0SBLQtT4fWJi$cIKW;h(F4(Fq_swR6b
zF${z<Bj6}?Bp<6aHu-ZAey}hj;TUxkAE&i6$@dVU;3-B1$EjoZc<jxi_MlKOf*A!T
zsAuzft<+@SLktH`GoztGJ&!kOgH8TD2)}WdF>tbaA#c{on&oEVDG<htg;Ui__#&;c
znKGlNfQ%Ujr>mFq#adOf-As%C&oJZR47HjUw8mz?8R2IUGXc(0Yk8m6(k#y-o(9h{
z6X6_n2H%Y>fm9xP8jNNXaIQLw@6$@n_B>)Fc#fF_=c}{%L2a<vpNH^EikS=-sB`&H
zoy;fSON4=NW(qE0&*vj_N*}csg@LimRJd4O$Vcl`KKoum1|pbgaH*Q(V|7NKe=ow1
zFJ?Mirar~T=`23^KH?ehJfnmwaDaC_b|O;y&@*5>GXo~7d0wxReD;0BDDVO^6VmD`
z-lPlq{QD4ouQ9WrM%~1lb+Q)ue&SgW$-Ds#>UM1YRJKt2(X(J8GY76xck#tKRf~N;
zF&fC3w_v8ahZl6l7XN;PpLon%xL)1M`*fBT`2pfN@FMdL+^Fv7yYb$DI)I)7lbHE%
zt9pR%(@8D%1H>5c67xRXp&sG~b-@<@0fb+L%mSFB4)KQSWv%jjA{<09AHqC!m^VVN
zY^Cy1IGDmLf(O*$-e|q5)t*m`1<?!v3)GR`SiP~;pO5fEl35Ios-wJddP}R^LPUU<
z85KOPj`7B0-z8;15nvj#6te1^*<QU~YPDO4ao`o^W9U%N^P2R*R=)+|$0xH4o>VXN
zn)NayKS(?eVwg|hY4s9skzR?YgXnpnWLCg$)XTladKI!CB*ueRnNJ~5tG$BWi2Mf;
zey=i#(4*FReR>O$7Z5Li*O(+&s?P9sW4|X=fL;JI85&lqv%GzJ3E2yX3E*`m1=gyw
zy@UE7@)scd#AP(FQJw1zHONHyAtDmYW^}Mco$rk>C`IZJiUe;k2H2)9^hO(0qWust
z5yUd-uv5)>V+}^pe+c1MF|!JuQ=jt287!jwFd+wTGDdg-2fD{&n<;e|$-!GpCcLEP
zy?TQr+7A;7@HVp+2GmtvlOZVj4<r1LX4b>2>L#z*AZwE!AzlRYm<{l{x*eN=m2K1!
z^dfkN*$8i{yS&8)Rh#_?F$uiOY=*bgJzl|JZ1W#M`0dSXg?H4wUZ26zCO=BN1m0t|
z!F%d{Z#Ui}QAg2B;C*HXe4rli_8Fu$`%z*t_<-33AE}4DgN9(6|0u%GbtVTsQHKbj
zX|i^CArS=@GJD|gq%a{OP1#NrqA2holLtp8g$vPXs&;!JF$Kgi`{1agNFg@O*zPYx
z_=V3LfMb%Pgt#<IyZjgt4L)Kla9mQ15T91kP8~zhfM5#XgrwPmK22)3A0ws$k~s_&
zN%I6#TCm-J4B?@GISMByEfmaYGD%)UybP8w$KceYB|=e}Qlg5`%Rt2(htrdm3&m+F
z$zDWE1OH;Ia7L0^5Ymj2zX;(uf??sTB(2~}vq<ve#4F(6j1A67$`HD-mzO$@UI8C7
z4mdX{OXy3JB>Qn<I`|LsIh>!AEexgwCI4}RM-S#CT#%G2gr>_n<R^$2u$=i4E=tN5
zBGQ!|)Cm*=K4DJ7#Yu%ibh@g;eu7Yfc;;)kG>H>p(~TYe69`W$%r|gZ(kUS>-O?eq
z60d^)G9_?D(itHhTZkzudKG-i0GOD>3;J}a!)_&JfCR<`>7**blpgHxTM-^`7!TAW
zH3{Z)S*M&KUIS{z3k^x_*c-0wq!{!XNMcIis-!NVI9=6gXNZ}AV#;A=QjZ{{8$10B
z!ZQ(53D+m}3chqpr<^5T2gyt|+?doabmO%m#iG|i3R4TWCJhLE=~AbiC1!zCrXKD{
z8WIN6gPndB;W3J7ggHqerJ*Zj-^w{+HqbK7FfS>rG-9RlTZ%)ofsSc`2a>`|qgSfF
zwR6N9K+hmpkQ7-OyVCfrpF?=^V%l(tWK?O~O3Sx$8xafA7ztD4IWeX2*fCAnP%KDi
zIw6}hyHvkY`qpkE=75#VS?EZbS87@r{MK(ncv@r5!IMb~OU)}~XXSR{O_0Hyho_U4
zloqX2o~7*QO<-g$;KtzPrNt{%XYF?4EwGxo2tks%R9I;|>$f93;4zn=CrMlCTWL8f
zcMxxbHOysLnv_x6jg8ur1HBE_G67hblvUcdQaWpQ5Ocvg<_fG$$}SyT89eKEAUqQ?
zS7BpPZfWQ$*?02Kh<PB3xdvO3@=GIDDZisWL-W7}<~nRkDlCm&rTWhP8SxG<F*jgm
z5?30#%J`lCGla)T<|aIsbgDFNmE}A6=ft~U6BC3NlFpRIV}CgHIeHgtW^TbtNqnh(
zmGqtcb7DT&!rX>|q^eTWs^EA2&k>$HnLF@mQd6mUmF%4S3*tSH&D@38liG1sfbtym
z1$qx`WA4G5NnNGIt5oOgUl8wu?aY06E2*bcSY<rt{{rD*m3aW~B=wg1R$0!;PZA%1
zoy<dcFR8z@8?TwEljsAmi+KbeBn_1It&+~!PZA5jZssw3lr&U2xGH$ge-h#OmU#l7
zB!!fPX2`nar-+3hml@_7PKA|4WGK6+Q)nUB!wh$gq{7RhGgMvnQ^beB%#3i2q9V&;
zGmKsSQwWd5%t+T5Dyl3l!_p=Hl86I)8JTMw6;l?E-SE_xC=TpnM!6<Xv&-}uQkVTp
zViDNSjCLugd1a=IV3+?(gr{g`jB7Hru*{qxJ1;LLJ_7m7Sl3i)Nm)^b@;p_HJ^~hI
zoNGF@ysS7wb>3b~5a1v)-Zg_#mkAlh^ZsIl2XAJAYZj#~^JQ4h%TE&|IK)hJ&7m^N
zy0HnLI*mwhm{GXqQdwnv8Pa+CX<{)r!c20_r?SfiGlJ*+rxBjjnaQpNRBl<QQPwU0
zidX^)nJKPCRDM~6QQ1v>g_eM0%v9H6s<15DsOq+VMW{d#GtIS>;>u!;#%}*t2#@#7
zbk{QKR9T$S(k=g*_!l_AC|xUX{YO0Z{!?G0e*r5q!<9(!WqPC3ZU35B3K(Xli>9i|
zOvYfh|7(O50cMs<Lp7C|jj{{!{}KNN9P@_DK(&_@8I>2P|Dk^a8#BkXis~vWHmWYz
z|3`cb?95xPOsc0$Fd8rT|A(-Mz|3{6r+UkLM#}~HH^hIyXUsdUjZ}YGx3S~`^$q$D
z_?(&V+DZ+S^%<oL_HT$~;0xw`*A8l^Y|t3I;Qt0;-GN!)%ArEaLs!ebm!Bb)gHz0h
zt~@HNJYu!-d+H2Y4!&d-xeid_<<YBE-`md+pMYY9a1~II<*}=c-}}!XtW+?IT}P>$
zsPeegmha^yL_GM4QMry&G3D_%>VPUi@!)G_sf(p%m+Mzc-`h)w72to&$1VpouiUgc
z_`SabVReI9<~m6&EH|%~U6ebC|AI5jC$7`flJcU}%8Qf}{TGxlD_q}D%gc*bt1jA|
z#HYZ?eCh&}x?EUoyy$l#EQm0PE)S(G_pP>Elmj9GKqkpmN@bLH<AenYpakGzXjdhb
zRo=H+x@ZSPB5*S)u39R)d~kK}q8}ivp)eX(Bb8eonkoB14hc2j8J(+z$}f+|RQ^Cg
zqy}Eb;A*1^%cC<@KiDCW1Oz7C)k$&Xv6;pn{19Q;g<0h~N1ZB<%e4F;cM%jQV~nl~
zxDF;B2Rl$MM1gW9({+jB%k`Pk4|W$pg9>J?D?nA1n=*qx_+1DqHOzX~RjR4noGH5`
zcN58=irL`0PPOAC5#=Syjgmn%v(a^v>MAeJR9&*Wi4;)7Y<AtEddh`N<0ZcvVR47q
z>bgVqmisa-m*gHI71S}?T=%H{^6t!%OOywtf_i3$>j5=T-j^v|vU>;(Xkd1^9#KQ(
zgPFlgeh<QW5R>D2LWNX>u95Y~c|r@Cm_4rHbXY~i8f6c~BQ0oV@?0b7@QUa)svbK}
z=zx#e=Nd&vR>ZC`_V{^(B_!s6YYZJ#5x2(DBli+|(8^d`<LH=*_%$Uxlo#m%VhUUn
z=-CzeHByh=OBjI29Cj(_c@?HL!5+UCVbzH_>Y7Y1tT3;UU6u<(8fa&Zxu()fDvH)9
zFH-_a0}^xGHJx5wQM^WV*)9<2po6ixX3**iVU6*!UqD!>Vp!KKT3g{;W4SCZC02rO
z8JlYkol((^(=(`2v=W?U9Im-^Rz=?$>9W0)SOvagK6lNhvnvMI1TXtb5!SYtldc7H
zZbj%?nO|N;WPmQ_OV=VgzanC-(odD43~-(~?OIG1Rz$B=`R!$d5p*+OyOz>iMeJIm
z-(QBX9L9X(T1KC$h+Av%%gc$?;CrUTwF0*T#pBQpsvNBb7a8D6r1=W{TFGxOCo;hg
zjLSvSRTZYSLBGEoWr9nL$EBg0D$HwT0eJ<n2J|pqmw|4_!7|DKRe{!k%S@?j72Q=)
zyjB&kR}gD~pDA}`(mfTzT4TUpfw1VtRJzvFy%oN-mVmsHSO<P&s$CoD{)+CkB>}1u
ztpit>TGv*3prUWB6tGtk>%mV<y=w<OR57?V81PpjtkW@#t{gg~GIX8nM|l;I1$vog
zR~{W!8L>|JBUOd6z%{1Db$|}9j9#bu(OyMt0DTN{70@}6m9guLKl-Z>*7le-Tw5Jg
z8Mn^zqr93hfu9)(`_^JA<8ej_RgFyG2Gi+c>DiU~b<&UaYGNb!g*oeT(DN!y>w-V}
zs}Yt1nRB>4cwwb^o$QLdhS&u9ne(pG^peV=b;>JL4cY{P%mr*HT3%VaPIbjzLu>}W
zG8eJ3q^=a!8L#+j&}MLpx#aTD+DhL#%N2Pou?76bTy~Yx8I|2Q8ilGwTfl85;Hspv
zD*M(+SM0UKR`5G>#Z^mZR}QWVUh&r=EIKk*U5#{ZW$1d@Px3k<8w@blTrG5dWyE^r
zPgEVs26vh3t~R=`GJ3u0Cwm>S4Gc0jT%9ym8N1&2lfMpOoszlfI!B+Xj9YK{NnTHE
z2Y)a@*9H1aWjsz~q3Y3gaG$y5x<vDp`t{OJ_IhFm_>;Nq3eZ)RruD&}{PhS+o6H^8
zRl2Ftyk2%y-azaGL(E;*b-KN>Xua|()qr+_hs-_KO}eYHc)jYXy@A*T{$lRCZqYrJ
z!g}LXe*@YD9x)GGcj(?q-+Iecc_XnK{LMUc-J|;}yVsXor5e$0@R)hzdO#0U_N|w$
z+8c=+@DKCY^@tv-99$o~>Tg6j;0g1@^@I+o3eA%B%A1H>5W)^~4^IxOipWy-QcWlq
z3}c78M<$0?MQ5pc?M=iU5Xz2lk4lcLip?_i`kN5eT-lNCG09O?aaopLc{5=KPq8xh
zxa63sc$_~&H6t?^!H#lINS<A#&ysrW%|sq}njP&{B+sidWd(cv%?Qi1>=^gt<b_q{
zEZH@=kJt;s*s<=Z$xEt=vXs{-AKD9K>^S%I<mFYxS*mMxAF&TS!;W{)NLE(~S;lLA
zAHvEmJHb6GSzG1HvRsq55c|Qi>_qpR<cz9r9D75xp#5Mpt8mXv&Z_FmlCIfXhy&m`
zc9MI3a(2~VR`8m?1z|Cmo$OwaoLd#TLDna4CGtTyJH@>yIln4mgR+lmMfqSXJJr27
zxv(mFgR0NoN?1SyJI%c`nX8K3VC?g^BCH>?)7{IGPgTWju=L3haS%MuD%~rR&s4?Z
zv>ghegJ3*6!=0GSSLruMeRf0?fEU=AZaTTD%CsTa=SK)j&g?9=Cb_A~yg_zdE)s`8
zB>RTjklbEXv_W~D644<rk)7jSmE2WTyg_x{E)s`<oPEokncPz)Y%pH;iwLXK>|FQy
z<lZXZ2FrDM8*v1@$iCy=nA~60y`khf)rO9MN$h<0*5rYzz75iKdmC{Syu`lm-jO_1
zHMk*o-QR|=u+1)T=Ol+zhni$R%iD=U5XFAz&PxufjxZ^IrrJ><n8Ge{A4tv#uZ}jU
zezvz0$3QeoxC@dat7A>ZpZ)C!i{b2I_tE62>Nu0-XSqZaftOj8`*?CpbvzCiq9jxV
zrm;)iZ1U`Cy-E7nE)mDUE9}Q^NAkRClPUPKUqV<vXP3E8CNHcun`AfS9mEL`!+zpE
zoxG&F$fUeMb)XYK$*ypJlf1mT*rd8)?;xz;RrXUiNLE)1CgTl%2eN`0Y@*wftgZH$
zEH~tx1Or}Ulia1r8P(l5(}?Os44BE%?#kq>>OPZn!`?}-;B_{|U7MU;J!lHv@OL7t
z(z6<OV{&eF=tkKu@^1+a%w~1&mgM~Eh>gl$sBaMm-e3*xw&cR<=#8ph?B5bL5X+{!
zJCnKU*p0?t{NExh?6a%f=aNrV$8EIyB0o#m!JDkneF2xr#p5U?>MXK@x7bYgrDVQZ
zzft<dewJ{6x7oGsKyp>JX=Csg|5=200qlDB)#RpX^G4ZC`FF%;U>>`{eLcCox@e>F
zCiNZq47|f`bl*(wsxIEBx@rH8_#C{;Zg$^F?x_|w8gKf)LwJ3_Zgt;D?ydH1wA_@R
zBfbFdvD@7DlKZQ>H<sL_&Y>^B`|J+)gXDqgzKzmN`#Ity_<-Hzev~{^J-9J=(|-=(
zjRTwGev%wg6S_&(FYh978!@}bJv=3>CSsGapXx%mU6jppk4y=#iQc5@w|5a=f;e`c
zdsIqfP3$IPzrPFNB?WuHJtifpCT^3ZUw)pzZ9c5UJuW4tCVo>%KXo4Ab`G|{Jt1Xw
zjee8VZ$D4qw0-ulTahxa#<VHe?>~?5UV}aAo}99<#=J=uly?(ffhFuQ_tcanHAS10
zL8=>l1yt;D_w<zIHN~4$L3=mxHTV~6b<apq*9e=8L4P;Gs}PoT&q~qO_%>OB@(Tn`
zlVNS{IVl-6-J42+)CGjoAy|idZc0{7-zF(&zd&HOH~YDJeoA)D;HF^Ee*xj`347AL
zASJgZbhGSN`S%2NW3gYl7p3IaL~K_6N_~&8yMjIKUYt@`6TMmWtNnWd)6(qM?xiVQ
zP3&glum0~5UbwK|xR<4zs)^fd`Bi?Az%UbA;$DHf1><o{7IhI}IDrN3#1y_pzgha#
zev!b-M%Lw~Q>toAn}fglFCx4=U_EY4N>hz_v+S1q2Lg+Mtk-QwX|E~Tth`12fbek7
zmbzD^bk!7ZR^77yK;XwZTkg(G>8TMm8*ll4K=|@yE8Xi;dTV@}Ew|*C2>daz)$WZc
z{Waa2OKwq@kQ=11weGDc12uh{rCat(ga@Ru_3j-hLp6h&gSY&b5Z(l_jqaS3klN5K
zvft!A1P`=qvpX*(C#*JNi}E+B2k}71wzv<Zgx5xIQT=A`A-q7(B6mSbWNqvg<8S^R
zgttd*oBL==RBhZA%Wv|_gaFc52^-~OYU6P#7<Cy5Af4@WvnjJ{^;@Lh?3amBu#!FN
zcBIU!HEjw0=D&>a!ihcSKAEzx*1Sb_Tka>yKn8o>eL7`HZP6CxZOV_zfRVl6{w8I4
zZSfY>ZM&Z+2dmkO_)k>V3R{e~{eFaZRO}_UCq-N9+hVyb4-ge#4SU&Lnvzl5jl;;O
z0IC3M*?_w;C9Ae?i*(x_AS%H+_KLeUCA)TTOYpWofbd$2z3OgE$*m3DD*IjjBT)si
z*lX^Vl>FL=t;*l2A5j(9z+QK^r4-giZ&m$n|B<K$CiaHAGli>--D>>Z|0BYiF!rYV
zT*|51xUH7o<yVLru!#-2FQlBQjmH^i)D=_%HnX?fms0pz{Z{FB`xT-VY+-M^11VLt
zrmex>{Z|lPp0Rh_S5um5&0A%6<UbL0Ae+7GzMj%vTeMYqhx!TCfo<$P_sx{9+TyLM
zJNBQ5da#|n@4l7NQ!8vW-tqs0@V<?G;J%a6TkG3uxg)<yG=QD#L-)Ou{@U)XC3mQ+
zr~&L^AGsf-4Ak~*mG0QD5{+Ot``G;`WvF&=Yw(W$D#9x|_KEvRN=RL3wroJ&OEiI8
zc9>^)YFJ%FwsL^#MNME2JKQreHM}l5TQy+sC7OYm9pM?38d(>cZ5;6TqGpiCj`WO4
zjjD^wwhYLx5k9b&m3hXc#?-~*#5d|1@_~KqD9?n{*>(DCX~2GsXaW1#(H=$WygE~M
zaKL{JwSWWc7|-O?g>~j^*<E=b(F*d}v7V`^OX`ZUm3OH=)Cw%@IM4Ld<#ol`s=M|+
z0)d0<c+ZSfb)ArHyzB2n2o$grJhM`@b-rxNUHNrF1c%s(o;j%*b=^2<j=GLSaF|ti
z=B8%V^<_(U?bnGmaD<)YnV*_nH<%r~>%WfLz)^OxXF+OiUFbI1p!{c|9Tc)tJd0BE
z>ms%(2dSS?J2=Kp^(;;;tc%{J8npjRNT7(F=2@D`)x~Zz4*Gva5;)FI_bf|2RTsC-
zGAO@6bbu4A(z60LkH+JCJL(4N09JN}Coz?;({Gao?Kg-{z_2qtbZS+dX<Km6e*<*_
zmYwC%q&C%=x5@6we<8jF9Q%gHklJ2Xv`u-B`UQOpZ0sD*s?@H!;%%yX_Fsszz|Owq
z$xQ936Sf)e`F}xYfrFjvS)bZl=i6qvC%;L22R>up@oY@(uj}4ca*w)+z5}1L^F3Qr
z2kQE^N%!nGiF4o!_I=Ne)S<e;ZNYo~o9G-k$u98Zq~?Uwhi;esA@3);z$x}aPhM(R
zeZ+R<A5=f;0$;L=JO@(4>!Y`;{;>BG=Rq+`cnVS@>tnYY|M2&t^WZeQ*mE>Bsy=SJ
z<qvs~=muZ0D$nuMnEH5}=0^olH~5-e>S0r7*Xy@Sf7pY>1@J%iV~-<sUcG61@DG0w
zT>#&(%RDDj7uK7%%kIm6CB6sPedjryx}?5nyYfEuEBYQ_7~b<u>hk*H?W+6sUx|wV
zvuXH9RM!jJjraY(qKg2pianlGZM|>1<-YtD@dLoZt*10KqrMx52vWDu4*<_mp32m$
z`o8Vbefurq62Qlrr#3aaesFv6zW)}w1U#(9)0moDAG$;Kr~Egf2k@-U(~_EBAF)IE
zC-ocZ0bbVNX-h4vkKUpB)BYQA83=5;r!$qSkKJMX)BhW~3`*Hmo^z?E>f?4;{*>P)
z{Gg0AdM@B5+IXB@NZm$$P|jw0E~WDI`W@1r_S-}NRIqD3fz+yc(~jVu{@W-3D%tg(
ztEo-(<{h#J^52OcK^42fb3L`azG#Q?0rflj5md7qJvURk>Wg=%9@u{;u7DbLv*%W7
zPrb0i_`v@=x&mt1t)4rnz4g8wmIv}X#804(-R8NM+F#$jqvQc~2mJ)<*&Ut-sRQ+W
zJERBpJH%Dc!0z%qN*$^n+!1`>zk{xVMmERuBsHWVbf;`cK0x$>CU%c!xF)P2VyAM5
z8bH0Ena%Tz)Py%g?^F%h2Z(FH$L{lt(nL1I?lcbh2hcUp!XEI9(L^=G?X(QZ?-G5W
zm9==rX<{1Uca{uMcTpceY=LKjW_E*qr!-{0OI!ycd)TAU%xf_13=aA4qU)fIJ?fdP
zS=eCSDSId%Bz^|%>@m+&&60+qoyv#QAo>|d>~YU@&GLrgovMfSLE;AJV6C1R8g+xP
z)A-Ooh;D#Rmi5fiXd8SxEf3}Qh+n|Btj#k=lhM$P10tz==ofI7b$I4#vKsn!N)PS#
zh@0R$_H)mCO?JcJ&fr7;J#-VCV^4Y(XmT4ucgg;e|3UPFF7`{$B29in#4hDu)E}rH
zoM%sa7HbL{qIaqOvj0H@K{xxgXQ_s3h}~uU%l`)of(z_7o@JU-4RO0Hf64C?zk=`C
z63+@;OdOAMDXIJDS8$O9o<t4bpx-6^Wxr3{0za^LIM-A)n05vK^4~|dz$Mn>(P)|)
z%)4Zd<bM*sfgaZDF=*Nwigqa<QGcS}z-6}7vr5y|P`pd^$o?mB8~E9BPo}1)LD*${
z<o^@h1_8FxvtHBN;M-++B!58s4t`{-JsUOs4c)s+9#Id_@8Aks>)EOqXz1G|J+eO_
z?tq`zde06`&QQbPuHYm819S&mWg9&?nvllO-Lk*sL&N~+Wt%;Dny|)*-O9hIAv6H4
zu`Qkhn()Tx-KxLsL&ROs$0ARGCbBVhxAAZP5V{Mlvu&QEnyALO-Il-Q4~aqWGb`a_
zo|wjX9K%UHM1$Z4+ljx-*^T<$(%<%n#69o}d)DL7%xg654*u<bi0*-#>^aX#&B8|W
zZrNk`U&J4vpFQt6ty$7ov|IU@`V0L5g6svHp|ZTOc(>}Y{V(D^_?5kgpHS*XVYl(I
z|1WeO++r``|Ejjpx7+eq{)qS!{Kj7Plxi{>yK(v_^$7h5ZnFVTr6#MfZ@2W={)l)0
zerK<EYBkx7gS&%|{g2QCaEHC>Y1HI4hUUork^fB$fdTfKr$v+B7?Gp=hx!{0fxGN=
zPn)K&F*--}kNt1rAsA$Dcsey)V{DG`AOGLzA-Koh^qkY2YK+UV{3Cx%{007CgPseT
zGmY^$bd-9G{sQ;eTb@fAzEPhe{bPSjJOY2Rw><$(Rih~<_>ccFdITP@cRW`$O^xOp
z*%SFc#NS|uz3aKIX>TmbQ9hymL4SjX>^;v-O;=-aj_Qg1AL23ii@oo;rRixDa*R*>
z|Dea<5&OV%N7LKr%dtF>KOz1Bf3pug_cZ;D-8m&ss3+(j@R)t%d7v3+?8}j!*q;zj
zz(4F`&m+xH<6utkiT??D0-mr>JWn(sO`*B65Jd<X0z<fA{BUhpQ$(&Zgbooy;4p4D
zKT;ds6rHOIafFb=U??|&AEk|Kip@2K1VTiNjc_CRG1{o6xLiw!Vi*|;pW<ZvIBiT*
zJdRkUhl!zZ1UHJGpq<^M&y_+P!^q+AX>K&H(9UZz<px6n!$eG)aAWw%+J#N#T-h*1
zDESl&<Hqt+wM&|ca+SmAQ1K}!<HqsRwac4|b5+9}q2vho3^$&ip;b2txyE6EP;mqt
z#ZBO6X|+whT+1-UaPn#REH{y#qs?gQ#>uYqaPet4np5y|wOLJlxzaGlaB?Jkj+?~K
z*Jd{j<_3oahKrbI;U@D7w7E^8dt{-Cr^qlE&Q0MLY4e*R_9#Q?r^GNgmYd2i))qEJ
z?@@(1o+4#1f}6%K)pAX-dyJuhr$mgvaMSr^+EYz&dn}=f5#%%Qc}~f%z`f=1I8c@z
zAwC1gb2IovE#IWyBZWFfkfY!W+)SR<RyCRS1VaNO#8GepH;dP3o0`mfWWyCtlh49P
z?hW3cZEq^tqa02@Ej|k;a&!1q+ODSJJ*wf3r^(S!&b`HFYI~Z5J;vdIr$r3faC7<f
z+TJGL9?NjWNb))OBKHozQQP0ty{BY2JyLuQPU7bCTeUd@O?`W$;f|5y82A$RKEFdd
z)HJv!I6N>?#BdI`fX~r}G>4jHPbtF4a2UmX$meOpnj_50r|2*-98TeI4YW4AIohmx
z$`MA6h0z>tWz<GC$C`~#1;Rwk^KiH%NgLH1XSO`0kdYDaWe!&sXk(h=aegi>6C>a>
z4krj}XE*E3(o+r@IS#(U;Xps_yk?U*_*6h9Vg!i8`8wK#&1SP~gyI?Uc^JcCySsKt
zbCFp&f__GP9x6HPKGQC5E;g%1IG!QL!&f;BgKO2zg4sAC@QjG5Ar7-yT5Yq>Y#E^#
zMZN%E<M66fo6+2jV|(dQ;tOylhm}ihR&$?O8sQj4PJpj-c#zO$HxHVFBLbsD3>tCx
zyVmA5hvvziRy<2a!r7dTZ_(yAN8~A=rk@of;TxQRZ_^ewN9U=Yc05Z?gt1&Y->K!A
zWAltp2c8ut!a3Y3{+#wyb6lR~X~k$#4&UUA`~}=&ACJ?5>CvJbzQtwom$ZDdK2Lhu
zF`87sx4E@^KwH&p$_qXn7%eK`Ty8yoRom2T&XbK)JV(9==W!eO>)Q6_qCDkD`Z@7M
z_zt&`zp3qNF3wYpbUa5+g70#h`CHnaW+BfwGVq)@3C`!X@^`eo&AvR#NW~cPCHNk<
zjlZYuZ|=@38A*>3UxM#*JNO6Mf#$wEX{2KeIT?Py?cyJ4hnffTf+GWC#K~|0m%~5N
zhWJAF%EA=kWE5P;?cs;(!h8{Xm0@(a7zID%^7xUua9{LZRhT23oC4#xef%h0q%U@_
zF)R=+V$O;?z>m>I`Qr9k!W3i4X!sFl;m7G>eDQlr!sxMLG$gnJeu8ecPrp|RbBraY
zLfrJnD|GXGroF+iz*rHZS=>>6vTmWzyjLbuM365-+{D9A)h+QA?N!R?2=Qfzn>G09
zy5+v&y(*a_f}93%Qa(RJr}hbZjj}+5I1Mi4SbmmH>+|ik$Q0wqS0E0u<>%-!eBFCX
zWb`=k6^Mf=`MJ6*U*BFy<`_p#hd5}CpRddI4ekxf0^>vsfN>}J1-e{c=swvqis#7~
zh=XAGMY?=n#6IOS^z&j2#K8{yVqKvxdY|eU$Md8TVxu;{RLA*Z_ZgoFJTGEqjQfUP
zraR?}+h=)3F`j%C{+BD^SLn|8;`fz2Lys3<h1eLuC+c{gexLM=V>~$nV$hkVbyYso
zzTh)~@!|}K!9`x9Yx0@*$wnz&AYX$RMB)v)c3;sx<tX|E@imCS0)CaQ%U8TlHOlb<
zITPYVA)l%1@d^8kqXI98m`vj;`SrS9pKqUKlwtz;I>bUAzfqUd@9W-IGK!ucz7FwZ
z&TrKX`1<xqqZ|{+SrEUp`5n3;-{8LBsK5jf(`;NLpQ8(D3EeMyRuM_ghWJb1^K@Y?
z5&M<T(vjk9sN-7r1G?~*=>4i^9g*Z4P|qR0Ko{8(yWjY1AX3Bt9M{Gl)kU?$?YBIu
zm`KLLG*04=>tb5saqu-gQH+J@Tqhm{X1D0~OV2tcl5^ln?kw-n&1*634?Y{1C}L)g
zJI9~YEo?FGmyK4)$v0sJcb-43ThdarUpbnVi*G_BcY*&#x4flzziPBYPQC?Ka~H8f
zqizxQ8%GD^BF5~vOT0&?ZSn25j8-Vfx8WM@GGD68Xz9jz+q6P_8?NO7e5Ed{rEkA9
z+Myul!gbsgzE+prGPplDI-n3Sna5q_8+ExYp$BBoDPAP!!7T0?-=fQJi8!Eqj($;`
z2RCrn`8Hi)OY{NNbB-6ucc6*8!FS^SQtScabAcB{4D)d}`E$BcEpZ1d&nYI6@4`)7
zkiVci(-MzkzUfKgyKpmii@$^qCj9~FImaY&KHS3H<^#H_7Sn;?bAd@B=Kr`m{8e33
zi}`?TjN&EoJ($hi<*)17TZ#@S$Ivf{@4;={J^rSytEKpWYK-G0@_o3SyU*X!^|S~F
zjAH^Xi5MB=9`JW`y)C{2mNAOS<Ogsk_mID*>u>2kP%?&|EPeoYagX>1x`CFy1JW4B
zWO4!A%{}HH>4sVc4+O^qCX1Ld<eu<PbRn&w`Lb|D6uA)Qa>KmC^<k|M`O0uQN?Zu{
zaKpVL_2I42`KoY76!{@Eb0fT?^pUNx`Nr@-l!(DZZlrgNKB_e?-x98vLdL<poXk5;
zAJZC-L(S<aVjSGZjq*;=&u-P{OW}?w<RZAA8|_u-=e3&hgW-WGB4!!6G2Y4gg{|g%
z*;qw1`4P<L#(Jmfm$Vk;E638&;z!WJjq^^|FK;c*SB-T<lLS1-jrY#bt6PP9<Jds7
zNWcPaf_Ii)+v>}=j8#k}NqC5x=$)g_Xzj*X>hx5RgoinWcdkCGwJ%>9>zGO|hDW$b
z-ue3M*1`PX*uYc~6O-Iz?*e^pYp6vQp?H~G0t>k*-bMQS)(DF-f__<C0*`T1y^HmQ
zt<e@$gyUsW1&g?8-lcl3HP&K`2)ry}$da4xU8X<P8fURYD5jDBf+skocZL2;Ydnr{
zr>BYkf>v&ZH&M^G>Mc@)V;Z>>GTclrt*>e|S%MLPY2s4Ia<jY|eN(I1A{(c8h5R?<
zxHr58eS2$>MLCXsMf^9kadW(@^j)pR7S%Y%E9A$}&b{T$)c3Rs7UQ_UD<UR2xw+o;
z`kdZYpT#mxF`fJm{EU0YyHVfY+HENrM^6|313%~Hd$;NbTKg>0ILCBy8T^8K-@8LU
z)H-Mhjtfi|G5yIc@aE`4Q0PI~^NJX9IXuOE=*`oIp@@UZ=jj-6IsB4a<UODdN6`mW
z&pTqsPhc@ecnkEADE6T7`9O?_fl+R;_ozM!#T~RfuTYZl@GDN`J+6;I@drzur<Gzn
z{F+<pW%aX>{-E@{LrJcH|KmRPI`s39>0t2rfKtSaDYwjfQoj(H56Z?XUM2qv&v2i3
zPwSVUqJzru^sC~3VF|aw`;C4%Dn6(h?|7B`6gs(2v7)O+!a?Ksz^fw0Qn^I0N3TV`
zgO>4%8Ds*4T#~m`pMkm$mW-!ohzZce(cVgZ7V0}Fjd#o-6QP?+@z(0I(cr=0_`nPi
zldPP^+o;b)p#`!R6t9tL$a6Yxi#{Jk6ewSyUlY~P%Ne|F`a%?4pnAda8kqzIF5TOS
zPu180;|qb;L=3-jtGws*r%+sh<psq|l7eNN(R)FE2E`YYyg<(sDOk>BdN1jDq%V+O
zaLgoWSi!CJ2J}_PR1kb2FjK_5EVtf!Ro{fn1+oc>*U4m9#cl9j*SDjh0_6nybuk%M
za~r)k^<AjAKsCYfI++4%xXs>M`W_?{7$*c?7cpYXZS~&K_aa|`WrAWBnF{N;ZQgtO
ze$-u1GJ&2Yrowt|hxdVg0QD6}6CATh4Q$|cc^~PA&|pDuLSUANsa!6{`$Qiih8~hd
zDrS>f*u?Ge4mX5}5r>qK^lVWJo4GviNJF?7eMlAQm`&=SkK5-RWr!4G4;do^vqcQ@
zatFL)3{hg-Axos<4N?zVIg59kAx4ZpR1!(QA?hLG3cM2xvqk+ODbn!<X@DYk*sCzi
z6HSMLk%2cv%>Hsmy^{?KMe`xqL`5u_2HUw~-l>KqV$mVxL^@VXgA#Y#JKeBcEIy=~
z=!hlLVFzdR&M>G&;gE4+AXZF=ogC|(WzdSgLzan(Ipj+CEobx2F=U9{xCDWoBd&yJ
zIfr+yAxrE#Bu#Y8Ay>igxX-=w4cX%0q2R>891#=7+)3{OL#`NlSSDAzNoK$<?o00?
zL%tYsSShF96f@v??zDHYp-_xItdcw4B#p3}``WwIz=^Skjq<>oB8HN=Z@kM4r^L9!
z7P;aray9&(EAg%{oDt)3_X7QvxEfyMfH%>=i~7To-0>Ef34h>RUfNJ4nhpo$fw#m=
zc!~3PHHIe9d|0MXyiKlwJ)GBTFtm$Bhm{KYZE+2}%$0gq8M?&c!zzX2ZE`L2bLHMl
zLr#w<95yNfZ;P0H<|@7G4ZWi8utlMmORj@Ia@F3AhJLa8aEXGRE3SiAxLWU4!+_X#
zSW-CVlI!75T)lUPVMrW298?76iWryX8ofD&khahxvKJNe$Sl~)HGA_6VQmpdlrPfr
z#4LD?Yw;d1gttW>QN8GxM{a<99P$<zBHLn*7+(y`6ER`UwRw*kqT1q)SYA}TLz>{v
zoa8-jh-r(*RTK0(q6yyMI<fXRyG?&YdeQL?xe@-to%K2l^V&>Df-eT%5iyj_o%5bF
zENn9$kxf#(OKyVw+<EV5!;-e5Bg#qiyW%Do<SyXY*yU}-M^uv>?~<G0uiQnv0aCXK
zM~ssK?~0h?<}P6&N!#W-Vwt3vPi}#~ahJWNhK#mu+;Bn97q`IMT)<mt$ZG35B29A4
zC%3}ixhvjULw4KXk>I4jd=aDH+*NO*A-65`sO%-hdt^2o;I4UF4Eb#lN0l$p?}^#)
zE_dDAW+-fnKB{`j@gBJi4stiVo%j_Nd(`++;5`x3;@nN|Im4;8xTBVr6z`MU;U8Sk
zd%<v~EglzZ(C>@e;eGCw_Y$6j^hc$a9Pg7m;Gf)WZ@^I1W;z;tDe%6C0dww-_o|_(
z&3sfgS@8k66Ap2Az1I!xZAC|wlj#q{o$w)d&wJC*)mD5|HQDh2xeNZq-S^%y^t1^_
zjgtc(h?q&|9(eB<dfR+QEt3@s$ldU7?xFXdp}(#BXvt)Hfw&t!<{o(;7zWz<j!Kgq
z3&<S!5BJ#n$S~A4cr-XUut3BZJNLx<#1PURS}2QBEF^Pbh;5iKJT0s}qEHz{FBEg(
zFxzlpWLkK8bfGHBv5?#YLv163QE8Fwv4zH{z(Ns|@3xV`n6#+&xI#;m;zQC5pR&n>
zacME_@wi5W{!lc-5w=mngtXc1`a&tn@gbQ9pSFz_6lwF?O@+azz=tA+<!xhx$!QDQ
z&4sclia2sF46}_Drlu`vFDg_{q2t88P-Yt^Oix?hUR<b};)o;n!Dnpag&Aq;cA?NX
zB@id>gQIK{gjs3Yc3+`oieeGDA3kfFD9lOAXz#}DCG;Y3KOAjS2y@f2+WQKnDUL<t
z0r;G4k}y9lyM3@QI3=)1#7Mqvvald6w>|WjEL!mqnGeHlQ-non`Rx(Ml+pA@Vm=&e
zn<^|$D{PNGriylaL|R~kZJMw&jcboRW{eJeBw~u+HeFbjcB(z@m?c_4kO$%OHl?s4
z?M!<-E={2c@gN*;n;|5o@$LF!QnZ603*Za3nF5_w)owZ#j1CZD0i0l)C1}!`+Revg
zQxzn62u9l85DaPU?M26wQ)yB>1Si_&2&>X^y4s76sirze@-UR!-V!p?dfJ6!#;E~P
z#AX58Tw#4$Z@cf9WvXH^c?7;_dq>!q*5BTJtYj*^SUdtJ+2#vd(+1l6j!9D;i^-$#
zCENSLj<lin!DGRxfyE;B7uXgEIcXtMXp!t?#S*d*M%g|T^3uYjh$7|7^b)ZUPO&W#
z4y1)k(M7749ZSe#Fxo~41!<8|Y?1Nhz!DK#5^RfwqiIo6T#@Bvg^DbKFWXeY@w6Bz
z9(TmhDzOMovn>_awAqrrNP5|!B9FsYY#$4bw0V-LDEM+fC1MwYZJBT~ZJ}f?l1)?m
zi#!2iY@Z0H)0Rj@MapUPzr+(zX<H$DleSzcE>cZ%{EM{0S8bo-jj>u1ij30&{}QqB
z!Img^(zKGV$TCf_lw{y*wj`l6Eko+Y)im@{k%2R9v{0FrCG{0a(;Q1l7QSvv5o*)2
zrNN@$w7^mkdnIfdp)oC23Oz1+Me%QvgR^Zqp(QO}ia4%(h5on5!8dFMp)IXYiaxG-
z#qn>_24ijMLMNWuVvieN3H)2M!8x{7!nw3lQrvOND~gXvJABh-6fUHlk>YV94*juc
zhi}<3g-dC?q(3gb;`o?!z_)E{g+N-BWI7&vCGfH6fOBo@g{x^zlKHr7y5c|NXK<cv
zgK#~qT`D@RoKF8o{0zQh+bG;j>ynC(tEM~tLw*k5wQUw|rS(X{apUyBf5gw>eA`yx
zPFk<zJ8qe-SVn#U-?MEK?xpoh-N#F&)62v!;QO{6!h^H{sqeTn-LZ^32|uvy5+0=u
zNrT6O(*w)IlW>78M|hGJ(h+(>7Nb~Bo`MT)dxYWXVI2`Clri*j@f7^fmM4r%5ATRR
zp^9-VC%=Sowtd2=^vI6b6ULapa`8*J$aX*&lOEL(cft~*_=GHmAK5Izxb&Eg_!A{D
z^e195By0u3g!I`R`V&%&;}h~UByEQUMf$uB(}`eA;1lsQTx`Ro;pq!I%qL_@MLhWx
zTw=o|!0AgmicTn%biDW#RM~K;XZrGv;u9*RBcA*k{>z3-`qI@M!U>}?5HEfWm)daY
zR=T#scfz7ntRVjf|82u1I_Vi5-6u+v^a}BR@M9Y;#YoTU=sO`P9V^Ih;D2m5<UT#S
zWAH>!8CW4=4~q?lR;TB7gj!{<D*j8Jfy-?;gf>0DBf_eDmHw}I27Y40p_1u^9nn_R
ztB(JYB{1IhwXigu>xi`)Uk&_M#I_e34t+{L)e&d4ysG$=bi)7IaEMF#nT~kec0_+F
zI^m}_AS9;q9eS(us^e1<zyupMS*KTZn5@B91D}cjCfcxRGQFw8Y?aMWB#;oQZP)~r
zp3~k@WL3_f6GRA;Y}nP1-qlfTRn2fDkS<8sFr}Q{(;--mGXe>s3(_`B9j5no_^g&0
zibT>4lWmwHO7HLJwwBDG6Gb;nv0*A8eW0VyD$Q^tk{+09!&|=ep^iaoa7G|e#D*Lj
zR_)V6Izt)RYYH{VL#+*~aOq*45sdORS}pQWXTwu<dU$6vqk7GuCcRK^!>{D@$j(^C
z_*y_MVh@iE-+Jj$opFriHANCBz%(2F6{p8^#^Z7)I!P2@x~&s0J7;(58R<1g5?KmY
z+Rh4&^m&~oCiq$)NyN4v+d1K6`oc~#Bb%w9$TFB=J1?A0U(#8`C}+}?SO$%@3&J<)
z%R7r1)l3IPmc!Myi<mG`cM6PgW`Gj0Q^<Bn@T6-yeT-$Mf+j2A8rx-|G(DrU8+S_4
zv{(Vx+5$pldRAv2Bh7TsWF=f@yCT%4XLk-V!I=SC#O5N~RiQCGw=<NLy{<?mt6-Mx
zn$VJ--x<LwU#FABD!9RRU1&=$?2KkruRD^-YG|_E5IV8S6U!Q34<w7&k7T<koJ&8|
z8OK^)SEP_NaFZ=4Tu49D8IP;1=oGOAZnoVLE~WFGdRBVfkwVtOEw<Z2Aib*7#0Fmv
z{GXxo4``zN<G5jcby;axX<emZrOQghOv+5cyknV3m`PnFVzM0rHa1Ai48%;9nTVO(
zJvYIj!gSAx`@Q)Khd#&T*BHM&5f~y&Dh(?wE5FZw{-;cK_dK7^`~7--ig1OAy>9JY
zUsGSWPd116j67+{V}G*_tgovt*(aYve}+z4HnKOZL+b<erhSSz;4|`+<xBPt>&W^p
z{7Ex&q|Xp;J+Zf}*Vp&e`}P^;5NpWOmao{qtT)#W*9Z5R=g@1=Y0GBzj`i018}*@m
z{yAU`dB*ZJ`>*xR`rGxR`@(aiH3%1_*t^!d>&G-il**!s6tc!rz}{mUn>M~7vQ!>T
zr=S|k7Iv&{T-v0Ds8U5VNFmQ!3fcQ?6Vj$O#FR48QVPP|Dt4T0V%qeE_)<eOv6l2%
zzF}py$!W71lCZdoUW<H|ZR`Zwl(guE)KY&mSWDJgzGWY@5oxgvy3%m8v=-qy7CX^4
zEiJC0uv9jeNF~o%ir9y3Gtv?oN=oH(=~Q&iVqhoRW~L=Jm`W9MK`MFP@*VrAZFX96
zgSC{IE2X0ImL2RA+nltN24AURF0qb8mhaieZS&Gp4MFS+qt_v1*~t>N1!>xbP^o_|
zSVxMMAK0gC3)Au%MoYtUrF96GzSwED#c2f%5v(kR_?)b>6tmCRmZTLmM6&W2`g2rg
z+0D+dQE9~uQLG{cd`|i;CG2yyWoe}iF)R}!eU5NXjGbv)kyhRi&l+Ng_2dQ1kF4Cb
zGOem130unO_2`0SFFV_|I<2}PmG#Gf^<=%}C-x;9o#t-PvEdkLJ*v0tW9Qh`q~+H%
z6tc2;L>k#(DP`x{)}_@ol(6!7bQ)@~u<SgWGA+<xViog18rf*!*!ebfT33UWW#&m~
zsL=x01vX7uUxSY|%p;U!lZ9trv+2`@8-lEP9<4-879+dRwju3CLx}ay14^>lvY%aK
z+mv>@VU!KelavS-*x1Fk{IoHR5uEH5LPZ8F<?LIwt!d*MBRTmiv<d|*2iPUH?P-%5
zqd3JYKt;A#OzcwIj<l(bF&y)Xq(Zp!#!|LjY113yIm0UiLk2AeS%qy++N{PTEM=n^
z6to;-m)Z8EMK`8${#O7)wptFe%WWVnwo%80Uy&GuYjW%gTUlCMV<9J-Po$G=mMZpr
zTSZzzV+kjpPp6|ci<w<%t4vF5G;xagAf0Tt9AQ`CL|SsAm1E{h=?FLL*wwaUX(^39
z&M==)lN}Zd`;pC-rfLjg7aXld9Tv#aHdmUqF~s@j12x%c5!g>{C(`m7N4fBPNsVwB
zk6mLslUC3e0c5Wd8Dy8Gnq6zFO)F}Q1oBtu4Af;g&aShGX~m6EK=CTbAiFJAcD=10
zPlaOu^Qx4AaDR_g+M3hK8{>iDRU(tTXtA@5tu?KxF$pW^=uC9c;$YRb&a~>rRN#LV
zWRjA_$!6N5G<Ty8gkP015w85P8e4B#O=BUDEg-VUOBOeqZ5v3dYb*is1#}j=Wbv?i
z+fZ7d(F7C=Ko;3!@v^zLk+iNxD_|B#SqQfT*$uYqX?=}8U|2wC$jg?K>_*$owBg1e
zFfX7r=(6P$yUBJd?M7n=_!j^T*=sq?ZnoV?yWKbn!V4q~!o@;1-*z``Oj86eizT#V
zpQVP~VjHU*-xSHqV`(kwvz%qO+Qum-HAV4?SfC~QEk1UeZGv)YQw-0<N?L@wi0pRT
zMCJ6Rc-|08WRoGwIo4pCten-9#G7O3Y!tGbXLs19D5INFd4DX(CI>8t-Dx9~u}wNY
z94lobTwi2&*`_JunhJT@YlM!xVyR<y+h!;eno4;2YqSnsvH00NwwcPrCKIoC4d}>0
z%LR6?ZMHJG$;vaYNjfxWsb}}u<|tE|e7xZ`LQh_`G_b5~o>J8m#GXG|kFHu8SzueB
z)Ha29|7$=`4q2L5qivxwuW6JIzb5GsE=jUww#CYVrU;|#bs~oxwglJ%wk67<rbwgw
zbvg$PTUyu(8>K96iZUu*2RUTe5@ZkAmMKe{VvNk|QVznsN*3Ejl;utFM#JkwE_uz;
z#$xiOvZ^Tw>jmjtbj{Mv9<{AjRyU;@{jY;ua>UZXLL05jcQ@&b;n$^HG-BywaY8{^
z(^P1bEhN4mf3|e7_`0sFYbr6y7t&v#pDo?2&8AcanoLH;LhuFoi{&Egu&I?@O;#hb
zQ2GM>Vv$&vO{45<@)->ai4EkhmP@S1rdJL(1&!u~^ak{+rH4IX+n~JB6f*i3f(_(#
z%VqYIZIkkL)2K1LP}+cS<C8sO%U6zRj@U1IgUBOqSo+wrwynzX&5`@%Z_s(@hNYja
zwQW~UYL42kcmw2-zga@;dD{-<)aID|%o|c3!X;5wwCz$(Z;sz@c!StTj#{p;e%l`9
ztmY(aQ=~VdQOh7(kJDAr&8hqSZ-9;DP0Llb(FT;U&AR>JH>8aS_e$AjTbVMhxp2R1
z5%DGYyJeVdu~jG&noIV}7tvp$-z{Ob6`OJrn@#%_i@=xUAC_xuJ5I1BH(U2Ji=;0R
zuA;J?I6ITl?AvcxL~J7ewEWC=<Ihml9K;ewdK3E7@(U~3TuN<oXup3E*hJp4{L1#&
zPAK!5NB4&pNt+OEud=<iGs=SIh%(um#8>2P%MG^QR;w&(jx3YENq>cITYh5)Y@)Kb
zIjT(YCisf{%QDIi+UoHZDW;5hQ~C<w!YeyuYgU#w$Cnx2BsP<OTYhK5wpL|Ta}st(
z(wouWmOt1LTc@(RIkn9HCfH2gvHZ#YVw05aW?fnMO=&a29a;9etyfvoTv#SsOngoL
zW4X=#W*bn}HJ6mh7t>#(e=L8oH*G`8K(nb#u^4<!{%iT0{lhk*?7}BGX0h}&!nIoV
zmhHN-uh~~-SWM)T|5^TF|FYdw4mStO%!}!K^q=Kl_KxkA@<wy0%)c1qlXoruvH#lc
zC~r59mW3Bf`3N_0*}Jy8$}xe6a#<WvK#qZ9xO?nlRpSGZ<?=YX0F8n7aAWP`RFeWx
z<%&2^K;8o*xclrAR8s>n<xHGZfbM}~xpDT1s_B9Fazh-kg^Ymrax(j5)vQ1gHf7RV
zPz1b>n_!=!iVmcf`{TeCaxDBG_n@6n#Rhcc;W%jv8Vkp96YbMfae=~e*;_;*c`qE#
zJ#3$$N(hvc%ip34(Y;W{O}5WeB?e68inl-^c^|x=d(=K#l^n2^GjB<S=sq}sn_{1%
zN(uPN4Q~-!$^XFzxX11DRH{G_3p(ko=zs7*j<7FKX#=5h|65=yISxL=J!N00$_tE^
zhu@O6qH%B{H_g6SRS<|cAd4ryA;-f>+%xtis-i&T0eL+A4H^$0=4RL_RdFEdfFd4z
zL&{(z_ndv1sx%ODfQgsBK{7a*n`vL6Di6dTFvJtv$ot_VoZP-rRTW6WUQl`)x*tBu
z&9<*r<yQw%5BTH3HgW=djC;vWtK0$IfpEOE4NZVkxH<MUs+vII0ofAbTk-)om78l{
zr>YB-9FQ-ezeNwg$GLfSr793G9Z)O*-;xi)C%E}`wW=#%J-{rHzC{m0f?HtMsQLoF
z1BNBUcJd+kB=?$KuNn>n515zG+tEYtDQ=;CgX%^gbils^Y$qqer@2M;O{&|0(F5Tn
z(sncvPU9Ba^HpP7B22Qki6U|moX)*v->Mql5^0jZO&6g_@ELB2eY<K>OO#3RHYg$=
zhEd#7`wrFAmKYQBwp4^3hBG+IzDqT|CEjFsn=p`(@L5h_-=mt<l7uy=v;jrJ=eT9|
zeX8h|RFnU0U?3;M=egx}po(qLnZj>N1~eJY<W|_rRB<hZCfQQrJMs}Yi+kT*p-N~e
zG0B(G-=RmKoLgzHR3)~UOp2x8JMvNZ0=Eh$-jiFbCT6Mh9eNbb=2qK}sZv^eCc{!<
z2l*I$k^9JQQ>j{l*uF~dK##$fINI(~X<I@j|5C7noC06wKDD1v<+Y5O!b_zcXbPOe
zt+Ag`6|_WD$VlRQaw?4G*4k@TMJ<sPa+3ZYO@(v0b#_rz+!9rxAi?+K<1mI>Z?DH&
z=a>qHl)gug!+D(2-mEHbiLWq_#7^=F_zK6^TUAvpNm%+y??g|)`JCF`sj6;Ct?-jz
zCrQ9pxlFsHa<}Lz!lbkl5pV&gvG=NKS_&&<6!8Q3B#h;<?E|X1mXZoNMgM@Fgs*XW
z`;aQoVyaM3;0N+4_&S$sA5nGTn;%0-KcJ`JLT-cox~i|mS7D%tUF6g74Q`|TrfRq)
zSYf8<UFd1Jh}&eprMl4)s_;`_7dZ{S$!)gZQQdACtq4=nE;J1;=JM@#Rbzq?2W1IF
zF*zN^aa-(TneoBMgYpEr7)^(7aa--<m`TB?gNg)DOg;nSxo!3d%+z4aK_)>eM$f<{
z+;;m!W_mFGpdo?SO-8}DIfH#NGb@;M(40W;Mp1Anx5GY#i4LY7^e2Gb<P1o1JM9D$
z8`K>PCrG=|3`lXi?9-UIVBtZTf+!)Mg$dkl`wS)_SaMLVpi9uRP{Hl7&twvVrh^Iv
zC?TJN?{ItVvzg?e^&q2=O3-s~8Mn_qhe-+g4jL519`bqkF2~yEF{)tjpjkohLC?eG
z9I!87w879pzXI$bXTtY5qkSQh7aTnpR!Do$Ot^w8voB@}f)R&g?+`zdvtS~3z`lej
z3Pv81zeE3sX2JKl3OmIV2cr%t-T^<7a+t&&vM*ywgE5DgccdSY9IoUl?JJn_VEiG&
zJH%e{1^5AHwy$LJtAa^~%<s^9(F<@DchtU`sSc(d^1lQ2lC$B59JJGnJE%Jpen;Ai
zX2aFoG5Z>(CRlh#wv70Rd=Vyd$L;Hwx?ss6`7-(^^dkI-v)PqQAZR+ISO$I~UxFWV
z4!fG^3R({_%cP&sOOWPVb`8@P^c^xRBleLm!%sMmUC#^$gNMw^=zZvAh#mCy4a|*T
z=#YOI*hkKR*adIj#M};!9ttm$_MtftOWE!D%$U}Q!?JgYQZgE1JGy-<Grl$Qu>4)R
z6h%X<DYtKDCbdQ#R=f*J$+-~w!tFblsjV@GnRlg9G#6rVw|y5gy*2)@;a!3yW8mkU
z-@b>L)tYqJ{4UL+7`UFR$8qlH*3`rPcL7VzgIFnT2TW|M?r`{BiAD1uc01e4n7G!$
z!?NWBN4^5FWZ7Q9B(#<smM^C{^a^CSR(mCr*lIegSPnRHK1}D@aYH7#)q0p&E^%l+
zRCAs7V@yh`@33Jx0mxTj2G?!3F{;)e)+W;cy$Ulq$?jsbt)avI<p7WiU>4V7Kf&a+
zjvfv#mjGG-HC(U#3{%h=Q7L<m;K^91<@)WlOi^oOrTjgbN3k%Q8?cK^acfki;yu8V
zuR$F*Xs^d9m6%HAJ&8xJK|MEQZ)VC{<0}pC5k~TLn8StbtxQ#G61FwdM)W$&<woqC
zOm%B&rT;x(Bp1RjxL@oN<8IYehToHnXd&FdUAOl#HLZn}vK7RB@(q~B{bnCv>RL-G
z<tym@=nc4$yJ;U{0<ES>#R{;WTm--5{;-cQU3gN&tdRDjMQ{^$%YL2dYxPwcRuE<6
zoA4{{FZ)eqxHVX5UO|_kH{oXPj{O#Mqcv3NUjfR<#qewHU;7>AcI#+mc!gAk7Q=k*
zuKg}ErY)jMmPnM7aS)s19AneRw?$UT6X|jk2eHD<F)n>lTU3=I5tNf}LF`g<Oh}*F
z7E{F}O6BM+h^1zZiRshZ;;Rga!~rrMe#6NelhbFlC1E!;eE`M7ZQKOMl=SGf)GB`>
zI6y9eShwXM(qr3nRpCVG09pdE_sTIXJ+7^=O7=csBHxBsK;@W`p3qiOC4Zkbp|>G6
zK{;loC$^cY6z>BQxfFiKJ?fa9p4?`wV&0cbXer#mO>xXgPiga28Qv!<ND_X}J?@y7
zu4)TnB{p4wNVt<D91GI5ZJ{dv`=ElPAhz~67N+O5jaG%<mnskiu|CJKIK7}P!YoT7
z4w4BFdu$v_(u>+6&GIDrAWDE(DC3~gi`$~iiX?E5R6uNYaV$$OZHqB8Nzy^2fLO8O
zSdpGz-WG2*BoT+mci@kl+_5sfsx1ktxamXa9f+kPj@9YaZK-B|5;#OIgV_Gzpwr!L
zI&(NlI)s)%tl@C1Nv~-uG|N^Jhsk##_F*{IrPsBUnB^<!!{}Xz#S{)@dZ5i@R;&bv
z$>k6mA{^@Ut~RTgSt%Vx%OO@ZI5g>fZ9cPMB~eMf2eC83p-&%f3!2R<=}Pn-#O?ye
zhV&b4A+vuas3ccFED>;QO26GUY7VcID$xpvY5tD<^fB!bM`RxmRb(Q>SbfLV^zrSH
zN8}&SRVWc+zP)36`lR-#BZ?0|75P5Ipn1oR^r`JJN0<+!D)c_Y#CON8^y%&KM+_ej
zW-<vL<P?rQ>9g9Cuy~v{qa=8UTjto89^IaL#Qy;>lPe)+kvl+oY`gAA_yfs|RzeH~
zca){awHF?dts;()A3#j!c2uM%w3i%_ucD8j4<N>5J1Wx?+f7FltH2R*6+FVN!i~D*
zcIy#lm2?EHf=9X4j$`R5?Y<+1Rm4&9LulbXa@f*U?Lq82r;nl!A>?R>D_z?jI^tgi
zj*_b(MjAU#r02Dd9tp3Kj-u5NvxOaJ(hJ%nj><kHEMzjokY7h_dQp4iQTd0o1tmjF
z+jWTP#qCi?6(0f%`4Pm}TSq-kwZ$A|K9nrzBZ&F4j^_08_V}ZQ4+%(q4DB4_Xicwb
zPr{mY8lsOO2C_Oj)2rK4kNQ6Zkfb3dqdKH?cf0Or_(KUI8e&ALqc^>#z3`}PH6f6n
zK+Fnt45Zh!mmHO^rUmo~#L!O1P<o)<bX2h#2;`>_(=#0->0NlT%&e9K^eMy`OUL!}
zzINYH!)oFf`5DAKNyp9f;r8HB^J@AS`V3;OqvKZkjrPz{|7viITmvy+(QzmJcKhhj
z@M`H8S_3iZ&~Z0?Oh<%8mP}NWDX@my;uxzQ-w|n%C)3p^1)k-$I>xCdbwpVd$)K8C
z3w_)+#{~7%ju;D*ELEemu$J5In5drK5pOXh6UWI^c#bnTCaY(4Bw5VK^l_95&vQE*
zQ`FHNsTO}SI8LsEh}-EP)Uh2pOE_6Nj@Chu+vS+1j_WA2$UY*h<ma%C+wGX4PUtAH
z$Uma3=yT}j_Bdv$6FW>6#YezOu7?-6y^h)H<PNKa`AD*&^{}4X=a{2T>F`+$9}zY(
z4K{GBW1d>o5yUQg+J@3#BL^G{)Y^`a#s3kokxGbhPmYD^ypB;z_#?@Nln`^59E;Tj
z9T8CWF<~cF5Cf1LOVmXjkx>3IZAU7INkk4xUEC1`6(0jT$v}(*ax7Elmv+QJ=3~i@
z7>MCKjuq<ij(BMJm~fEk5JPetE7esUNznW;?Lg@e(`p>6)zuxT(El-TkZOprF%DYo
z?$E*T$C3l7A?CL@)~IVb3ZaZ9oMZ;XAQi_tbzMgZl+&~mWk5_caVXV+4ii++z)5C8
zj23aI)m<G{$k37#WkSsOaA?$h9X@EF2^X0KF>Ax2R}Xgtp_!&#C<|ifg=2&IMn?$x
zY2YF?5Ys0do7A^EMq!wiTu1{k2EviA9@7~i$UY(5q!wZxgJY|Dd}pK}|AclUEyQ31
z$9DCk&L~0g32>9y5EBX<JJeG<V+7_C$&IohMg=%_si$|w3x-b!52=H=vhUcVp4FKo
zm_MOCNCyYGdfXq2?o1W@p8yZ3hq%P<0P5IIoe=&+@*q9LZE{DMI<B)&kbO#c$sCAl
z-Hr-%LT8B}|CIKk9EkhXSPq=nX%ZBl0xy{hanadvRGr*u6_`&YFUo}@TqmvzrF8lP
z!>7av@(cJg*Nw+Us?MNb{**p}zJR}QlEbCec7_E1r{Dy+0pc#K<Age|b5sa_DxE+Z
zATFgk&ZrAIBaX>FBTkZe5Vu1ewd$hI$Yb))=#wZ9;+m#IR2O$f9aDS;PLdlT?n^rA
zaSAr(81tEQ5^aRIxaeqBmv_b=GkivzBEN*VK<H>yS9K;GGk->(LSI7M<a2bYt2<MV
z`9A}v$W0Je>Ku~V-Kjek{!BWBHbLBNbM&ffIt!1<))1%3uOKd&IR?~qoh8TQYv|MH
zD~Q`(jv;lR({xO+2An20LtMLZjHtWtCW=`jokp7>?ms!MtNS{A#|&$TGvwD0_mCVn
z)x({^W9BvV8T2*8g&@Z*^^MNZG5;EHhRlb!nd7*lzTG)`EWAcKgYqG+$T;q*$8<$h
z%TkCMvH;?)igRqn_^!xmc?w;F3Lq|xILBp7>WZpXq<|W73&iaW=Y))@T`|>6id2KP
zK-{8mPRy9z6<=*gA<mM85Z4);lQU*@B~_bK=(DI0;$DGsN=9^7YPCNFoF%tH9PoD%
z8L?fu>Trs57Hx$%Y44nt5!Y2%En7?Y$ZsHyygO%PBy^Qj%h%FA^bN$>bLY&A#4b~{
zVlD8I+aL~sJ7;GkcUh~MwUQ5QgE)-soRg8#<*PQVC2GlUAx=d*=Vhq6g4O1=bS?T8
zJ_rcsf(&g}sM^04)RNmF&IvmgX5@8^R)^P0wP-uUfnDd~jDoI+<FZuZ99aZ$a@M&d
zqo^zLxIC3Uhl(JMusW%X{Nk>t<BC*pjx<0VCUq{$DD8?l&ZJ7`kOAUQr*lO{c~|^#
zLn?8e{0`!DrE_IQRaeq+b1HoveFt&O(YZRKx-0d#KNXxOcR-vsbkZ5_F5U5Ps&pRh
zfH?T)T$54LRd`&sjzHx15GU}Q>oV%PN{-9d(FlDHaTLy}%m{Rujw{vyMDBz*ljc-s
zbah#eGwURTc0!yDb80gBx_rkC>j;tj0pgIBQ=c*16+CWUM~mnOh|^Ne4H-AOLdX5<
zfJp9wIJV^6lySRj^murkB%)mq=ZBp68DqL5tg_FEI<gqzAdhov#`x|?tNe4i4i!V3
zsBv!3nA9C*ReTQW$lVY}Tbw&Grgq0zna`y<v>W1xiE~%R^zL}8;d8=ImOz~KaPG;N
z)tzKDe@^>R3B;ib=e~^S?o_M)bKocUK%9PXf{fU1oi+Tq<VSlTjv+Y9GUB=mt+MsR
z1@cFT^8n6@jD+qIt9(6u0sRQ^V%}Mqk=SjrD%OJw<X(t3<hZe)+-<co>!k~5FT|T_
z=dp~GZlBe#o~S2(f_P=@v}LHegI4o;x*q)m@$S~?%FuR)tp4?&p4<oV64iMkBd>eZ
z8eT8eqkRx>Go5EL3c4d~vNWQBEQNTj=&a2s>W;L@)940N3h{o=DP|ORN7)o<pn+r|
zUbH#uGfKN-Y)qQefLMqZUe4x>^6q$>A&qDxIfyq;&en{o?j)Nzjc!C7#48|YXGV2*
zs?DDU8c6{0F2*TkxVv?>aGKPJ0K`iXXKzMLccD$DB$`Mb;_ZZUAfv9k#3onLO^Anh
zP2e2L2y~ll3MFVFjS$c4og*1tcyrAtr6y#Acy8{zp3&Fsvl)~`Gr1q)0k-pI#&CDg
zW>(V8Xg|c0Waq7n8{HwBUkRGYGKfdI&N~^myGLzdrPPedAfBx{?`Dj-7-5&GhyYm*
z@sQIwHgo*NNV{A`2T(c0(?;jG%t;rc><SeKkOv^1`Z*_LPQ4goXH-%E9e{ZJ=A4*0
z{bIb`pdwmG6U1{c=j6;;7nAH}72SeN5D%oBQ!=A3rrP}~&_Y%~JQ;ElnXwmj_OME7
zK@|{>Xq?kB<1QB3WegD{4?;XEan8t0xL9JBGjtFggm`G-oSB(;(PURJAV?m9czEEP
zotb>mYG)WJhz>z~i+9e+Ou6W@8yKRMJPh%5+Bq*%bunl+GjuCD4Dr3zxgb+}F=Y2M
zpp~qI_=4$Nn3;ER)E;J}R#XY`P0zVFv*2QcLzYgokyQ|1xtvQf^NTJ<I^^ke8>)i%
z^5dj3i!Vkw6zQOiG(&s|aW2a&y%^(Q(xo<JhWIw%T#;FRG2UTFC)&v)5Fg8(D>JJu
zCOORMbUQi%@%h-fI<xv>s>7cS+R393A5@)mru(AK5l)xd(NTy`jLtQgH5UsVGBwdb
zS|C2UIoD;@T`Y0P)pQ54KzxRBDl-EYO%8<`bdV6@vy4-n*>%zCVAN6vf)F1noSMwO
zi#~@zO>~k1#BX<}K6ChD&|y~7ok)QAHS64vdE;Wp;a7uB@)*SLJLjg%+ZRV2VYSqW
zjzRq5apq@^ks_S345EvyhWHKO+?qLFigd~|=q^+Z@uS$eJ#&&2<y2&VF7i0Uk3{E=
z%&Ah0lgW^}&~b>LP0n4J)1`Q)A%o~9tq?yXoO?27Nl8v~2HlOU5Pw^7VLe((b^0?v
zH)(_TYvTl&v69Xi&XBs14dUNlXIW;PROpmt5*JB3#J@<+ip&J5#3|3DFCsg{|D(>z
z%tXoLRAhpSqyyql785>_C99LklrAC%#6P0*SZ0dka~d)UiF88zcR6jDDk<nRXVMaK
z!b~7JU71=b<n-e|k}jA9dYmUR^Q2K{I8&043u-{G^Gs%e6ycI(5tm3e)PjCzZDx@a
z>5^yBmyjD~g8`?QSu91l6j|UB>47>h=&a8ym10~>mUIbupdJi4n={L$c$XoI=pnr@
z2ZWuinN?Df%bZ2`ATP`XBhJpuYAMy_$NvKI1pEU0;*>JolFk**l6ueyxB*;u_GZ>d
zg)W(fxJ;gedEhtaKxUm(;*x9V%jhKB2yQxuG6RyyrO<%O<SF<i_`^Ap*(F(Bj7GYQ
zPQgv!mh*aMpX75HG(<0X8h!=-a^B1wmVz#`hVDhD;bw5hc`NgV6mt3T4^EzeUxR<0
zcQS8Fqpq+<>P2T@KDg_=n>prEgj=R1`p6ns0Pb;(%^H6x(k<80eW(U*0b^a`vL;=M
zax1i;k30(t!F{d?SyL~?xEZa~ht9&SV4Q1W*7Qs9ZiANSCw=f6AahO5nsq73ZPwEL
z$OpH939czw(U(%)e*AfpweVZ;po_?gy`*!8wNgK-h1<bI*R-s-ONDM(HW4Dv!6NXm
zYerVWr4qM1n+~CK&;Ta8W@aT`GPxDmAVi*r-+@P6v$K*fS=~&w6hi0W4lu<vCoAQW
z&uz#i21o?I2amhvWvMO&-R5k103o;&5UvGT+Djp~AOAO#BK!e7<yx4PcWKle&Xxv{
z2zP;LuEkmT1(zZ`G97V+tb@hi8P}4mqDzq;xsJYq>fmlL!$oBkUyAZ5bl?i<hb7=S
z*RrhAOEDfsCtX2)xChL1t;j0B6z?(Uh(YoK{1M1qE3>LDC3(y`dJtWJd%<ki>a6NZ
zsUAQ6^&;!xPv9jNo#noy^MrNMAgYJ^z#P|_teQ)O9+{rFN;be!FxRy%tL{>XN3N%@
zq6Wx<c`jvE;F8Is(1WXFBjmt*mpZHKlGVfLrK_kB0<gfP$?Ci0^BDBR5ZMHI@S01X
zHGC=PG3)6e)C7%Sp=(3djY}bqAOBX9&2T?h<l2;V`_iZ<te1vRGb{s(UHMsKdLq2C
z9AcOZz;f`GYiri{o=C4ehaN@&cmOPMZO@w26XjLpfMK!)n!r-mj;yIYF<vG|8b&R!
z0#L49S<`#sy@nhjOa|dWpm6QUn$?r!HRsS_6oiMsGS|MW=$=%sAAgz1R(KdJcY&<f
z9-TLwBZW~btOP4uWm$1Og<e@MagA()Rp5PBMOH#jiC3OWUqfxs3|6`-vl4quUPUgr
zMz+HvU==0;CHGjpOs;edwZo%ewd+_`N{`QL$R$R|4rl=%xolago}ky9OOK!q2m$SK
zWodgtUO)a0lbuiipSn(D<@Jnu!@1H3>V(I@8rPYuf}V&IvM-3A$u3w8*1Br5ih3eX
z$iJX}MqThYSmzS6ihH6?D82wclid&};#~E(l^1h@`9k^`bwj+Mb~R^}_r#wtd_nv|
zUW9mF>}t)b>Pb3b{(}AmU4;1h=IYF<?nyo2$BzzDg7|6blCs=Ax)b3qq+gH(T|ndN
z&8q1sJR#da{7PPeZjkL7$g1lpIU(Ob|B5a_574`YvI0G(6N(MsSF#6sL9S~gtE<O)
zg4rPbihAG)u)%dbtFOm*!mxq3PF{v5!A953tl^&E3G)W}I=T!`flaPkSvPt@C;a${
zMfSqeV6*E^*6p6r6X6Zgb<_*bfPB~8tTC4(PRjC#8)P4>0b5*SHRCTwo|Na&H&7ou
z3%0t(X(nBcI;qG5H^_eI1KV5^G*d6foMiH(8>k=Fg6*z}n(3G0Pa5)w-^dU=2Mn&s
znpu~VPMY)R-%tpi2RmF-G|`t+Px|qLk{o~t>~s;D*vq<;;XLU#Gyp}g%Qa0Cce(JS
zY$GvBUV(LBw`+zb;d04I`9^vaU4eeE$2C)vc-eGPu@Q`tgYW{_>zb`ezHB|oY?MaP
zAgl-bTyr!jmwhJ<8;P6bRoDPn*F25ta`2>iBYhKHg^d8X7HG7WLnr<C`AiPMCSY_e
z)a2(~9z7Y}DBVOuuo;xO7HbMFN1T#<N&HR@!vHwoTB0es9C=FqCH*@ZhAp7NMQMsJ
zN1al934SNTFbEF0mT5{a$DCrmlzvBH*a|9LD>UVo<4+mBB>o_;!8Txat<+RqPC8}&
zlKul-gYDp`Yqh5Oa_T8RelL(CumeCBt#M!0oeF;`{eebcCphL>qp7)EcuKa3_>=q@
zc7fxrb(*@%C8y+@=s(fVup8K1N=@Lh>6Bs<_>=qvUIh65uIajLJ;iL2{zSh(3AkJu
zP2XkTDZ?h>7Wpf@1UxRiX83aOlz9_<3;havzzNp|&5g^UQ-1t9BCo^C;FN2V=Jw^$
zQ{he0Ep#3Bf-|ms&6wVZ)3UFK+vE+{2hO^-YR30Qo|b<_-$plJKd5zW*G%e-I<5E$
z+$Mj6A#mQcLo>BE<}~w_bQ}E!2Y~3>rJ3Fvf7<XB@fSG?uK>Smk7ibH(rNQo^j~Nc
z4uX12$cgSvJ?+PDLGmWN3L5cOB(_&~I{cON7rF_DK(nh%6W3dKTDF<^oBSOPgBDkX
zCZV_Fw0txDH~JlhL944$lh|uIt=J6yCjWrfK)dUxCb`#on%OM<jsAcmpc4~PQhI%-
z4V#HO<e%_o(2bKas@~vf^Je-E`V;;FB>a(Sdqb!F_~lF9g1>?u*9lEt@9639X6X*P
z1+Rl%*BMPgZ^Rkd*Tg^MZFmFpyJ|H>y^&|+U(^4f+weCq;1V^(y-{ZrUxR<hzu+hs
zbk*Y)Z_F9yYv~{K7rY6ET+N#D-uN?yuZe%jzv1s7>}u6i^(LJ$e@*|3{)T^m5m%?C
zx;OQVAHVa-JMd5Ni%ZhDdv#~RUrYa@JMb2`?&{Ul^cJ3x<rDvr|G?YeH`josuD9fj
zJfHp#{R963H(f)TK(FbHA|L!m{tN#Gf4D|8UA@*bOuqCV`WM~-w_MjXeZ9UjhJ4~K
z`5*iT{N=i-8SV|9G3V2F(SPt?aL08^bE7wO#*dF0<X!k5_}6tubGvu+OgLY<i|)d^
z;I8YgW=vm1jjVteLyZx}@b|dKYRC6Q*2oL!G2$5E9)7HQoOV)QRE?qljG^ukBKZ5<
z6SPzNVrrNIX^eP}FqR+Zo~WJP7hhv2Anu_egnN0Jd$M*`Us8>^fWAkJ5bonAxTk2N
z`%-KC_=H1^75>LR=q9wWeY%=(fpm{JRv5=mbWhX9^%d60wh$52y~23@VfPGeLSIRZ
zd<z{R-YdxX$?loj#6DAvVhf0%?i23kA9c^xCihuum@QI-c%LwVpW>dQP3iO17`6~&
zss9NN@Q=IaX;po}8uJ!<toT3SL7s3g(B^CVLN$JTvZBTb5AjdA7i#nRMr*=bq_N^S
zVIn`xy;xh&7jafrNZd<}7bfw~xR+>)`XbND3+a2s@xsIW3^%1M?u$CBC<OOXG9i+G
z&b>@q+81+{DU|LNWx`~BrhA39yf6N&p^&(bx?gyNm%CSLtNN18nhWXs#QTLu`PuH(
z+Uma4vwnP_qb3NC@h`b)t-DWmHe4v(Cr%Ki@N?X2v^9N&XJuQ7|4|PJQ~9~>b=tbV
zlC$!y^#8;Mgva@LZlyNRXF99c3jRkuC_KT>cdNBseb%$gR_TA@g95=XaBH-EeZI4X
zt;9I$A>m2>HMd?n+!s7+-b#-X9}=G87rHlSZ}f%E`tdoEnkYQYFLH0v-tHSc8{R67
z6DJDO_{Hvg?U?=upX?iAJT*y}&cEf}svX}S>63p$j~6Ei&+tp!+qIMWqkM{Qz<BCm
zA&Ot>-l3h^ALC=bk;aRdZOc>cUE1mW@jk;hgp7(5p5+zpJ=$6QNj~#8v`mZ?p5vFf
z_i3a1Q+<AXe5ED}&-2UOKpWey^M${WWFp4l@+;hB+PMBgpKKd(KlO+(i+|r;p-t#7
z@yWN*_lu7Ravsa4wTb;EpJE%hpL$eyfyXXLZF0ZW$83}C7coJX$7&{RO25x%*hWmC
z9ur>Vu_-~T>JR$N+vo}6W5P>31{Z6!{UM(ppPH#D!pl772x{~CM}6UK(gYDhcX^EU
z(H8Va)XKgk9-yWQ(L8S1Ym53LYvte44~SERxjZhtX^Z=#Y8Bst2dKw|7#?TPwWa+r
zwamBD10v@1@;DNvE$@%7HGE4vNIfCE!s89CwyHm=*8DB~p!kF^pT`4JZFPTYtsfuO
zDMEOa$M+YlyI)ru{#JTW#Ash0KTfnY{e`u%?ZiXWlR_+??H<t9^_SGjx6==aPYSQ`
zdiRhv&~K_$YzGffPYJK{x$Y5dSHHEE*)BaKVj3{N!F^rZ*YB$}Y$qmCPYZAG8{Idx
z!~MZp^LBco__VNy-{iifz0n`4_2WANHBESv-|W7lz1=@r8{RHW6fr=U&v)O|jtNDa
zlNAw@sOdr+zr{T^dweMJoV<vhBu*FJ;<viTWlsu4ol_KnNz^k!JipC7A$w{l<{VQb
zO%gG4nBVT6m_0odf6h=uJWNFiZ}SHC<m_3Yq;uvX`e89jSjz8kPsxrBrJnQSs|htj
zAo-ncB0DyuI~OjJ9u_gCnBV1|mK_%=JSQ^{k<_z70>9fmBRe5fa!zibBgJP01;58V
zGdnS4I;SvzNa{J^9e%HSc6M^edX6zjk>Yd0GJc<XPIgMjcg|oSCR5J~@A9mBUUt4J
z6g+1((38dIh2=bOFUZ!0Lg)PWN<_^R-s6q#h1q$b(Q{#gG+D$nWWLP3IJ+PeabETv
z@d!0bNaPQ=mt+@(BG1deqaP7x3Gee2ZYsMt6m?$l9e9M23rYMT_p<ELP|SJeJLwS-
z1C;qn_loTDQ2cqrcf_OA3&IDy*}XEmDwK5I{2l$M_=2#CKk8ncT^&k2@5eVWYPRqp
z58ZUOJES`w{!V&SoGq;8kGa=m*Mths%XSctQ7;O~{BifX?7C3NdHD|dG4Vy=Bi`m#
zW(Pv1^NJndG3q7ZW8UFbXLp6H=b0VSW8zB!&AZ&1?7ooiykQ41g?d@|g!j1h*~6jW
zdGii>iukhdDSyJfA^S!sbl#6IfYcn}Gyar&Q}*r9==tytX^M!+&iom7e)gDw2qgQS
zm`X(pDg0UY*6i^Ekx2eMJynbr*7CLP?b(wCqLAWyFqN7sr1Iz8JF=$^#31H-X{v}}
z(7fp0l|6kR9vQwT9;af2&w0OlPxh>VBxL@ceq4+Z*7Nlk$rnA4iv0NANzD_|_(pst
zj~&pV@b}W=BIZZ)&F-@7xPd|>+eth@y&|ai7I#H<!axa<@1&m)UlAC-)m@pLIAB7G
zo!|*-zL3thyN_lk4_FbiQ+h(g$Z5XQeJnd=z=sSw34(f6$l$x(wrtfv5Se$<g!rnE
z$xCimwss(d{P?;{EfBK!9`}jtyn#^^-YF3xrd0F2?laj10}-O^2jWR8R?zbO?%M34
zfk;vQ1O22JD`fKnZZW%fAWBsH0G^~?6LkEbyFR;gAVy?<ke(DV*qR@5H)od*#EXU>
zh^MI6g&aQYZq2S5ND|FI&`*i43%UG=yED6bAXW6^TQ;>&_=5k%E#W7GP7MDbJtblm
zHh<mSn_V+dD9UybPg8FQdHiqgf$X}05>dX3ep-A(*vQ{>4`l}iOrl~Jc$!)ye98ae
z9?9++u!_ts>1lD1u!+CrzMkDT;1dnIh-uWD!dLuX?wi@e13}Tei=HOFDQxENxNl|O
z7zl}ee7UC<3t#j9y6<G)9vBtFyQFF2Vj-Wu>%N;k=1N4JteBWi#R&!cJ)W_;@mC`2
z<i+%KF;3XRkM)exO}Y|Qrzi%~skeke{yxtH-P9{Fbxg4|UBr-Xew=5bZu*t@Izut>
z3>7bY!^=FAb+fJ{)tQUwXT*468$ZD_MHhV~wa$-63e*zeTmC^0p^Lqus|y!P&xn}o
z%}?}9)5TpWtds2~qNulpBK~2|3|+#Nk~;ZrI!b(7Fz}N-Gj)kqOm&LgAc|Tle8)fP
znXOB{Vy$C#OHtxdVFy3OGe?)7a>Z9?*iFo!Na1__anC%R>PoQAyqlgOlEO}&@GQ`2
zuY~ISc$7g=!VmmYo`t%+E2DMc-O>yZ)5G~`p2fO?D-nKK3GpnIAQbb@c$Vmju0;Cf
zCG@jmg0P#P;h}WJSEBri67Vdg5K8#xJj-;YS7Q83iS(?9f#dv4&k9}nm3Y6Qgm{j6
zNBEJKdsgbIt|a-*CG>ORJHlRmwr91j`bw(bk0&V9GT|rwB@eB0U(xx)CDL=^GGQM-
z$FoLPbEVKP+e180y(^URb3N;HbyrIK@;&tP;=2ON&+{mCfh#7zVh?zpS}t(>e2-e!
zb;asu_DIi*%LTwM@Mv^>SA2fM9%3f-p1||3dGxyBD?z_`4?R<SPcZTeJsWg4u7v!4
zJh-7&2>ba(o=v*jS4REeJ<?1OlhFCao_yVy!H5g8ABkC1qEODi<=LtmKNxvI{v$n0
zOcW0AOFY|klLn(MD1HR9sP_dEztposH+3-P0`sFZOT_SWp7QL{O&^TEVEB=cQ%S->
zUg6oJn>Cnp!TcjF7n6iT{4&ozUG!k;1wWn_Q7eVR{BjS_#SZE&gnyLeBId30D?DYo
zxWU2;vc1F$)CWQp|GuX}moQjzLB5xMLHs~4^D8}-y2L@#1;t+Q0<}sw!msii)g=#F
zFED$h7etI`=U01<=~4!L7Yuue+0=)Eh5yK7)2Rl77tDL<+2V%+<Y|vfryUGk@Z&KR
zwOSDPPdz7ed4r=D!h5CJBBr|YYdmLk1%nawvY&_-sbry=U+byW6%9t#%YUL@6qAMH
z{5p@QD;|uhSNsHCq&^a?{CZElu5>V_p7}|7QN$p4Ug>Gpl@G?(8-5~QqCOVvJmYEA
zRShQ9n}4ET5<eCkyxP;Ls~$|P_v7gpMGH<o(<ABJgSz_gPtr>wX2<gyPp__Ku&`dX
zk9e8-L~!%jo&jCmU`f4vAN{iUiQwV&o*`Xe&{VJ32VSN=6})_|XGGUEXsu`VNiT~S
zH_vbIT-Wst`sxk)h&j|}!byIk=caCWFj#NiN6!&I6Hf7)JhyZ=21E6JJd~r>2&ehY
zo;$kRgQNA~ebO8e6YBYV&t2V^s}T*dQX-m45o-7?p0WDzS0fwbrF68IBAn&7ddBG|
zU5#o`l!9n#t>ELgc_!$mUX5vBN~LHKL+$zPo{9SDSK}KDrNmq+RXE2RJd^dat|m2@
zOX;~{s&Jm);hCb3zM9(L$Fo3coq+hA9zq{`Ro4(MmF9|=gU|2sOw-3*Eo_jnL=5%0
zP{;4~%+M!XEoqRmbd319;OF;vX6h5Kni>==h@sXC7x=xN+4}tCtJVgFm14y8LOs9F
zGe@6t)z@HPiFs6-(7>~vd3x2=V1t>Z=ZR@TBM&?a^xCVT20xxbQc9tTH+mN8^RA9I
zgjs2xh;jRTnP;)S;A%vpj3Zv5R6>A1;8~(Cx*FLi=jc~NmC(Xhcqo1G)u=`V2VS8V
zA;=%{EYp`>jcH^!=@k(Z`uR%F3Vr$2_(lUq%%{?YHs0)6sjs@4)M)1D`C_`z&L8!x
z)>mImZS>>OC#4oTc<7<^?yI`SFel9y)j}tK%(F&cbG5Kh28dUw455oZ?pdd=yIRsH
z2lT6AhS1I1JW74ws;N-{z^hcIaFKU-)cUTg)<y<MuZo$1#JfBiecx4IqX7^Ls4U?U
z@A2sM!&ifiW<W0xvxFZ0glB{P#??@xA5UB<jc}Pi<=LdaeRZ@k45S4jRtNBBJo)-D
zLlI3fo`|KiLLYzDvsFKSD6&b;)3Ksf=;v!a+x3%%qM8&uh^4ZH5P#mYLqByWritOD
zSP|O>c+s;<KYb{^$-on@Q99uY@AvG{&l*Z<GV}CnqD~m(>oEg3dMLHYj|aV!UbxCP
z;vrz{kgh4rORtGoP{22P%JgwVg-tRe@j8_w4D&6X3Vp&*Nt4`2zb@toVZPN<sZSg-
zH7ShXbt+f5#<zQp>XV18O^i``UBpfUzSDC|pEBfYG8l=4)EC0fe7DD@R}BT5%tm^l
z_=WHbFX1VXb|}>3$Ma=sgYYZg<2j+v8yam28>NLJ)*$e`o-_J_p@?SLe&P)(Pq@MN
zdusJXLy^t${q!4Rp70w#;1Tu3Ls89&{ooC1qcF-3dg}G1Lov<Fe(4Pnn-lmUPqV&!
zD8AXSpIAhFDg4fdJ+1nxp`>Q>etMDkrSJzo;_1{^52ZHy@mQPMB>c($;*s!`MAsbN
zFD(+WY=OV->DAW^6*kMth&QRPgxmaYo&kN`P)W1AjDA!6O8ASv=^4@ohD^<hGVms~
zS@@g(!!x4q8nQMsWzw4>_A~IeJlFMoL%wE18L^o9TKI?m%X3pdJQQp;m(h#GuZ4g4
zJDywm8$+RHKc1#j`NDtvzn(k#+e4$x;WBBlh?NffUC&+pnBj<ktel9W3WPDnd%R<F
z#t%mZ<mGgnSRmYE9P1sIGif*~peP4%)D|Jac%OGd&eY+U08=i-iCcuR#&O<>In#&Z
z1BP<qEvits*C_K&&Y3lw6fl?5Z;6G%eZ~piDLK)@sR2J8;!|6N{}~_j5;?KMx<I&G
zdQ03Yj5AL3PRofKE)2*H5b@ME!g%Au-WfRw!zBUv0Xkm%MvxgNduQh4Ck~qeiUS~?
z+9up@eAGKTCwbT!U=B#};x=J|af)|NPRg(^U^qZ5p}rL!Fh1^`m!ldE2FwTOCE~Zj
zgGR!;AV)hK3i$EzfZ8rRWPHlIFeh(#G!Q-@EfKd16OGfni*pKwBU)r8;%%x(m}Gp$
zyCkP*II=}<qTd#agolkYyi`u{a8!%J1m30$LZtCI@3NfI;g}Z2B)u&fgvrL4-W56J
z!|^Q!6S0)~PI$y9_pZ#T8cu34o9LzDcfzB_+1}MT)x)VRe!R1wb_kCdU-Hs9?qOX^
z*d#3#cL-CAbG&PEYK9A2WEBKSeJ@Nk&h@U#sT(e7kyp^9_`UGBah_M16BstNC@KI+
z?G&Cc&iATwx`wSSOoc>>I|ahHz^lpW8}_vrDhP`DL3q;mnpdAQJREE>SJ0IBgYcAb
zp?5>hjp0y>AFoQNUBc7GMcz$0w}(et!W9xF?h>XM7kl$_#)Kn+vV%kdRV++5zUAGT
zGd>&{lpmxM#A4wY;}Y-ooJrxRpyD7%pmqyU#--jJIa9+iLFS;8Anq1s7%A_roay2C
zpy42)ph|>ijSBCcoLS+dp!p!J5KDyTjLW?Ha-zejK|kKmP<w>ujmy0tCpN4Lh7U>#
zagQ+5xWZeO6BjNF$_^3lP(KQ@jPH9ZauUKNLHQy29q~s&Zd~cD%t;KJf{H`n9cr)e
zf^n7iXijq28e|Sh?}%6eVqEP#mXi|p1r3LYWz<i?i^h+<wj5PB7&ITEmx(_KFBxgC
zD@Pj+1^sw2MC}t^Hh$_ok&_o54TcX%%S7xAF|P5R$teg&w8{<>?^2~gv~jJsHm4{Y
z*(yIwzblpsbB*h~Voq^5s#S3qyi2h{jB&lUKBqJs)5;u{-W9QG#HjQ(=ah%zTMdVa
z<rF8pVr0CnIaT4LR`X$cxyT9gjcRXaPIWl7)sOd46cAoDW_qO@cUadNJ}fO4v7N-I
z@%HA_gbQ0`mBf1#FT@(Ny#qOQ;gVK)CH<br3$GdV-l3d8*wm`11n*Hs;dNuKcO<7P
zY;9#KrT0WEG%;@QUeD<Z`&tc^#0qM^@P=`t_h!y;IM`~gq*sXhg+<0q-dj00!l70_
zUV~9(!kfm;-a9$B!=tU?N@<0N9Vo_p@7<g+*CN_vRYW3HF2otPc*o|BzZTghuc8yh
za^WrGR`0mnN!Oy<6jdORIv~Uww|OVzPQ4b>##Bj(BG#rDw|gh%PQMo4W~d_Gr%b}z
zMuT^9?yPG`ZRRTaebFQ=HSX|E$&J32+UCdGH>yG)jXS+WZtOK(TewPkU&N*r<1X*C
z+_-CnZ89^FL>&|ojJv%va`O|em9)vtbdq>bP#E`kXXYkeGqowqAc;C8ykp$!ot>L}
z&DzG8r6lo?u*|s6J0~~gny<}ZCRS31g?EjtcV4dQTCmM*rdNuGh2=)zU68B27Hae3
ztshk>yk|6e7v|<&8*K}lrIjKUx){s6i*pOEMYPL~5Fb!gLZb12cS&y1wa9k)5&8qM
zN_gK`;iYnmuSK;hj(`s+vyfyw<Xx6qdM&1%IU;=^Vh4<|(z_zJ{91gw;RvycIwE{v
zG<#R(R$WVKHy@!_iARK0#-rZVxz*QF+x>XiNF5bEG(s<(>%OLI4<C_MiAROi#$(<!
zxi!}c+hs?I4=Ia~Y&`B=ms@wOq+NcL{!p|C9~o_4Wp3b_sa<gtd`LmzW23{X&h5Hp
zZD)>3ABs?*jV`Yyx9^&--EfpxO$ov$MvqsYJA5tJZazw{76su`;|cGE+#A<I?S8!D
zq>c%n8BcjP<=(zF+8)L>coEBKjAy+0xno8mI%HUfPE`vj#<Sk7x#LG7JLK30E>;U`
zjkVtGxsyhsIuzK4O&u3fjpw~Pa;J{ObTC*5En=UIQS|Q0ojwxZVZcUY$|`(r^n3T@
z&KgPTFk>aKXcg8Q>#=kodL*^Ok5{XdO-M5~;;m!sh^`}yov<QS;24{|Ww~)9g&i_1
zMWyV5%Glzq$W0h2>5xPEW6>@!##V1-ZsLfkLxHWBltV~2wtJ7}CXZM<7_5a9u{Foo
z={=U4GUDqnK!T>6LWZ&1Ys*!Q1Ut-F3@AE<Orzv=<!VPl9e%vgrCdUmvB!HNH*aLL
zBMc>4#G)NzulG!D!AL}>46D&7x1crlduwxxMj|`q*bOGSg>2)1SIjLQiRx5fHx}g)
zbjJTPbT$r6mHq!88xPx1K~TXq6Csmfra`4;B|&x0u+pH?+PXFP-d`R5?w{WB3&!Kd
z2I;WUppqIp=L{+t)~*xW-CBDd**U{ZgbegdK~P~lj*W-${JZ`EmC4SzuFvQ7e!U<3
zdiA5);p8qEEQg|CH;-=M*Xth<!)aX_*p7t!YW#mX&##>yH4bNX8DKpS^{eqC-SDqn
zACbe^T`sstMoh+h-RQ3joPnO~^1yx=3fB4P#((Yk$Udy<;=zIx#B7x7CVuVzh#s!)
z62XQL%4{su`F|bwsC~G;OAH$_5R0)$H}&iAN8Q8CT{2h^L0OE&x|v_cKk6NJc4=To
z0%A3m=w^TQe>6DU(Pe-o0hHBPs+<3H<|FTLUzZE+uMwNEOt<*!{6~RdUzZ13;whU^
zp<DiS`6Jc{yPF3!>4@E^)CHM1`P`AHZV~i^Q+8vyj$;bTj~t2b7DG=q;xMXoA*S&B
z*pcLJ85BiRuxCgYW{Sv<8%gWdKvOc}G*;+%rs({{k<4xbR0UH`W2G+K6qCPWB)i)M
z*XBs8@nhXelOTWB$jNRGbj4DznMfC5+L*6M9Z_}jpe+^o&3Ib3+LVxwj#PJxpe~g9
z&8X2uo3`ZdAF1yaLtQ3v#aN|VYucKBaHP3g27QqfY%|iun6~F19&vVSpfC~n-S~-a
zy(uOC=txJm0U86T-;JN@1g4$&Cr0|ZU2t8GP{z-68%(?N<s-gs4^+lcumDN7(X=OD
zIl{ihgU&RBHlEXMGNtFA9*Mdog3>UGHh!*4Fd_NpM&fUYp)?C|8LM@hO?&feN0M*J
zpf!quok_YarhWOuNZKt8)FvTq#xHatQ&xWCNaigA^afFF#xHeSO$YMHk?dP8NC_ZU
zjbG`unI!p_M^4`IKyeIp)p%aF-E=75KBBtCgXR?E4`Z$FDN{~9JyLy31l1wbAI7hB
zDW)U&?IZQK#891qTr+;7d&YDuzk8(lmJGThsB1>8Zl~#Ze(#9$mIlfbkUx!ey5~%J
z`GX@Jw+zr8K>cad>2{k6^1UN{w_FfTK&~4x-HWE;{J@CsmIubiDOl#D+hbDXvqsss
zc`!eXv>OTC%O-U`cQop@2<C^WcB5XGZaS48IU0Xk3<I>t4P(9TRnwXL*wN(MGMFHx
zVE>a2F`dni8%?{dfe}ii!}zUEY^upm9L>CKfDuBf!}y(UujzdLj?wJfF33b6oyPBV
zZ<w_CyGBpm_P`Js1uLU;`%HL#>Zs~A52mP)zl@E#w@eNB=xFtA5lj(Le;EzBEYpSj
z{iF4_#V|&L+%z`n-Z5RwKRDWaTLyC^6l|H&9Wa6X!=ujI8W^NN{x<%gd(YI8e{{6t
zwgCnSsK1Rr>LjL1`6ovEZo43gfpi&-x(`gIeEF#Fwg;l*6fCCF9WvSSm7{Ei2U%*Q
z+eqp@G_~fR9*tr|kR_(NjX&vfOjQ24(RfA-VOr#tv03*|)7AXi(PTyjX;KPyS?P|L
zuICe@X^aNql*n!4e{?caXMW>oCS!m&A$8mMv+kIwE1w+AW?YZ}K^WtIb^kIk`Ikpe
zG9Cz&QLz3>cihyIZy!}LJV;a_ZsTR$zfJx5^k_9Bf<zJJHvXc^GY#aokJd9{h}0l=
zjKAtWG7aZ<k2W(h$dpj9F-uoq8qe<?but<VRUmhbW?iAlpFcR-!5AP^K;1Q3bj7Bb
zeD7!<<APgtq{nF0m73=B1EW611J}wFEZNd2Ow0MKF}9lr_o_&*(XJ~uaSFI&QEn03
zD^k5ihfZw@D~KG6cZ=a-4Y_A@>MBj)1+invZW-JxQLvXwcghq|5I2_Q*1**Y(r5fl
zr!hqrB#vde4REzU^%<||&X{5fc8q1aU2wLJ^c#QIeQFXED0YpVbbH`*nSxzjy0fN@
z1*u~yHxG_ik^4qk_qi#d03EA#i{N;Xx^HypYD`-S_K(%O#c;lcJTSKDzBFwuI5^hq
zmcaoN1?#_b=S|xS4v#tA8aQD=9vc79eQio9I6BthHoyr3_0V`tr#0;?I5F1ecEKw)
zGGP2ur!(y?kdOJ?9(c#3U}KmLH|;4<j<N6X;3W$gG`8#Xru2f-V^McR@RC6d8gJ+t
zOi01GvG_Y;c*;gR#tz+gro9EVW65`9@R&)#k}=%{)4l>?EbWd4p0ki4<6k<1DXXAy
zEc1>5o-?Q+<4xT~(}4nVEc=cNzG#tQ<KMa;O_GAkV<+!;;G2dTHg@S?A4!3IOm&9`
zAGOGcv0De_oCWk)^&Js>)KDYFTRLc}C}<z6zaxg<HDuIyTL)ts1>IxKcVzIFjT$vF
zI>;~-^o}|2XyB)fj2YcJc%d&C9P7AafPWh`X1t>_nF<QLV|{mAkSapPjdyhxQ*l9H
z%y-9QVhSkOex|dT6a}nt_FbM?AV<8$UY*0FF5r$w-4&T7a>{GGr)xExDu^79zbiIt
z<;aAwPj|(1rXY4a`L4{&$SGKurlU+}3*yGp?rO|}Ld0jhuXCAd3KGXN?;6aKLds`+
zpt}lNj&_V^-*rKl3Go{r>aM|m(5~^5cRgmNkb)g+y6YyqAaz`ImuC?aA(O^I-3?Pi
z0XklNS7ebCQIkfGuG4g(VE=giU9m-5giINSbT>^G3l5Gq-<4UIA_~^B>AFmy;PANf
zuEruLMy8D;x?84}f}`UdcMTRvF*R)*)iDr^IWgXM*993WWX3qAy8}NV`MB?{$HEj-
zu*pr=W3m+}$JsqRtDpo47`?iCrq+Vf<54{#tE7Yq7$<c7CaU1vczlo8sx3igjXvE2
z)7667@#G$vl_{ZM`I~OQbiIHWPwUZG1*OQGaZ=|obrv*^XZ9GZl2U5UIHemlbrq1~
z**z|ZZXxr=Y27IN|F}GUvd3d(N-5YEryDo*6xhdAJv^JB3|TM+bQ7lj0(!i<M`V+f
zQ47Xdo!>N2&^}(@BerSFkVWI1Zpt)V&^_MVBeOAO6s(xj&6vguddHnT8k<0YEEyMc
zvnGGR;CM%m!6s2qOU6arylJMuJKophg2WiIY+TYUn&t}v<Gvn`jZsjrl}@*8S}tID
z*}XiwK#8yb3kx!H<Xmr5ugES@QY;XJam-=zNN;?v*sfI~L4b{gn8W3<-sE1Hol#Oj
zfP;mZBjj=3v|f!}P>!%cFvc@S%M-nsy#~9aoMM9zEZiI;SM2a+_qrgdhHyYAwi5n6
z?(&}O_1KwmiUY#12=hjHs#n#^a|l#OFyLaV%?WbUTiq*iNK{lX;9=3`E%N=|`d+a^
zt3pBmA6skQDnICL?v*(h6%_))u^97q`C+fKSK|<<kx;M#TW?O0AN6+h8XOWe6$(~j
z0`pG!32$Go3j%UT7+8gEFz=Sjy}n+LgHcmqAOhQH-Xm9f+4p!(K?TAEk=Q14y8N^^
z>Ym6csi3%EHI`sT<mbHc_ry+Z1;PVS*k<!yd9643p3KQqP&^QgZ87hY6W+9Y8mFKV
z;e$1p$ebl_^k&{OI3<-7AFRc;nh(fHZ}vSG<noYkunyY>zmAu^C+~TjOeGZ#VzBMz
zLvp)Ub&uC7_!wCMVzH;pIda-teNWUX`IuS()?+E=Bl31{{XKE3_G4rvcm#XKd`#Z$
zZN4XKWj>}>0s*$ud|ck^b>7po3Qi%bfDn7moF^ajcHA?xN={L$zy@r$xj^pq_T6(q
z91w{Bk76&Hi{$~Y@1CcXIYmW)jo2QuLe83C_wjxcoJJx+9QLwVE$2=|^@)CyoTehd
zCM?~2N**~8-zWY}dm32{;;~oFXXLRH$$hflnA6m1kboiPv+}r!v_8#m0u2%c9>c`u
z8hPSGW}o3ViH3>-o3Xv-^YR@N*?lfZAtKS>aqJEFG}<+Bvd{AyqoJa~7Hppxm#0ps
z`gm6aRmd8Uh`nWQkfRgTeWELpDryZ7VOi!2^8FL_ec~(HDr7B4!rn1olpmaE?vq_%
zs;ISKD|WyP<cBAmeVQwRGsrsd1oob}MSgUmqt9?fa)w$5wqX+UCHaYozCIU(ACVaF
zB=&*XB$rS4`aD;dGgJ)NjvX@F<jM(lKks+JCrB*VfqiIhm7ku7>KFYk`GkrEPhmM`
zN`7u4zF+*i_7h}1NXGtYzACSsNbZ;Y&U`|x2PxPQ^L05fk=C#IUGORL2zVNknLFi;
z6Pf*n-zA??kAP>eW9BY7Ig#D(g3Ki%0MBCof)C@%6DRvUzcZgw0<aT1ZtjuWCsh4B
zO7IyX1iP?*oBQSTM0LN2l6*!9!E;!ic|hJiQQt47w4Wgx!1LHg=3#mFM03B4Vm_lb
zfZbSud0gH*;q2E?g0sk@;03JE?3WKtbo3i2$yw@A@FG@ho{@Ve`ubfE^+Yy;m#|Xv
zygV@B>-SL1S!yHLgDK3*a+Z&MpGOPMA#orTD>rirxxT3TB3g2eiUTiWYI9g&q%Z!y
znAV;{Hi0y((i~nG>r1{bqnUHmCXkMuGDj4~`O@xdXu;=5Ja`4un4=37iN4JH23qnt
z6%Ss;&X{8gclfgJyC7nUB!JhjPvOgGm+$0#56yf|B>)6FYu;Fx>Qmk4xdhe7V*tfI
zHzyRLzUuoTm!z6{42ZEB^OnN>zWV!Om$n+&3^K4U&07l(`kL>{Tue2!8SKT*o3|Gp
z_BrosT!I?paqv3!wK=8msITL`!6m7o9tUq=TJz4r6TZItE=aZ_Tfm!`&b+%&?(^OE
zxR@Gh3)qL@<~@Z<ANv8XP4ESh2=-%ob9&)vU(^Fpo8${B5xj*pn32MBzW4{?HtiRP
z2xMa4nfDgf`jQ{W+L$jW5y-+WnD-SDzO)CLHo=!j5_lUkn6nBSeVGpoZIUmkB=8P)
z(R`qg^kqMAL7*1d3f{$jgzw_ZzLO6;ZOoU{R&W3V=0k;cpXvecs^BZ+32+em$(&P2
z`>G#^u1db5o&fJ*E#@PI?Y{a4;;Y)PkZs_7>}T__!fs#l1KCyPD{32%V3*9t3wwRe
z2b!yb^T?Axiv42FD;)H7JTP39oTr`yA7CbPL7~^z_rL`?USvD?2WBxB7Y2O32cE0U
zd1^a2gxSoBLYANXkoSk67TEy~V-B;rkn4|nDEdQEOYHz3Vy)&=g^~XFhvGl9wa8N-
z8@pmYQyA+{ekl8csimF*IT&R=TNvk0d#L$C@HLVQ{s(iJYYG$nnGX$rNWP|$!9TI9
zuvT%0Kl`Bz;=@P^_+RWAJc{h{pM2=~gZY|D0Y|XwX1p-fuX@P4Cin(<8XU!Lm>UXF
zfAvGrHOV*B(?EuGnlBXY_t!rZU(<erJOgsEo92s!2mQ?tW!IQ*sAs@2tji1v5Br@D
zHP-}M<XP~4uv_Mq!lV9<hlXnsE%hw;7si+`6`t_-J#;~88QBT`FLuXlDwO+u4?Wiy
zEwvLI$9l}RLZzQQ!245BhwK6;uzTj#!qfh!0nwk5I%*gAH`Z^a3eWlD2gHAB>yYQb
zN$i37YGJKEc|i6jQ%5}q@~{E(^+Lj*HlX=aphKPq{}1z+I}02AnFEGDB|7SP@DVm_
z?kXhx*#j;JOC!5MJ~j$ZVwe3V2Rwf=I%+p4z{brzg?7JcfOlPhAuj+qHev2Br2W+c
zqU#cjdI1z-e)B+KyT5)wd|itnFM=X$$~;`y?Qb5CU1u=rMNo{*n8yoy{muc+bpejN
z1WK@3v%hfA-!WjgF2SjnKq)qFo+<SD`vzPP(MI-wGHlU2Ul{QF20YgpoZ15v*s^)K
zkTuC3<h2V3Bo!#JAPc96I~g@7YL^gHDk#S|mawA8$@oEWyOuy+1}ZGX5?&NLnLH?K
zX9((LpvJ;15k-o)$+SUDyFibmfeMUgi7rZ<%p5edOY~G4sKml8F-1Ejvj<%e4M)<!
z$Jk1E65Ta<a?sPx=&5vY3X8C8EJ~eJ4f1XX>XBE#X>7G6p$MI<9u(b>)Kjkj4Hj+L
zQnY`veo%ZvTaUa7s<5?|twjeXn+Ih#n0o3}a0ZL9Y%e-I=^WJD5HujKflsjYmXxBS
zlO2PG8<Ga<HSj4Wu<R^4G1)ihf<!ukfX}cEmfc12N#CI72Gc+x;4HS$vZqKn$@cI%
z1m7YkIEQVrq!*o@jPi&&B;Qgf_#8{HAVudU<2~XI?YD>+RAZYhdy8r(lRdHy=37b(
zYOpPqeMQ7%nn%+i_zuYcUtl6jR#D?*rpM4B`Hso}Ut(J=2a3qaY>x|q@W@{96}Al?
z#4k^t^msa$@2I`tJht6(sK`F4^6)wZ-y^SsTI?xHP7ys>?GbfKzNcOXUt=kjBSr0#
z^&WAj_Iu<F@D28i<ycYoWV1)s$$U?}0kqgo%kiS#NvB8CDY$^V3F@%tEO|wPlN}yI
zr{n_lCeUHKEd@p1$v%$@^7qI-fMG9Mii-l1K98r9xj^j$IJU>4C}K^qhj@Pp8j<~g
zz+Sefi?~x!L!!SVjnsai$I>mQiXx}ths1wr8<Dp_J@%^QOi}Dq@{sH=rjdFJG+>D3
zY*E})+K}cifdR<`-(q4*O;O@h=8)kpiGj)l-(h<#=ZkhsWe>R^_K#$N@3A-FJ!IF^
z$sx~QjDgAm7qER6yeM@_HN?9qXhPlwjo4e3h9Y#TdPsCr(nP%t3|N-sLec)I`XTX6
zZ4>eiXu{sHTr4^`)jTA-$uv>#fQ#4x3n)4~<s8!76kJ5!1wUZ#Sz3yYPIU|!Zb~jv
z?}8sOiRDt!iK)IJ7fc%<2Y?a#z+x(rPx*#CH<^pn0RXT=7F&^WiapHxTkr#N5Rll1
zme!)vQ&GdBza>9V2f<HRj)f{ZHx)lD{#*M4@*Zf${%N^dR6CVCEc=`JfqD<LU`H(1
zi-@VTVa?xyACdRLe=wP)v#4<@bJ*~=<VWg#@H2MI(p5xGWe>Yx$N`an|6>1w*Rab|
zCx<<MGe1%ia0xqZ=_#^LsfKx70wW>?m$83a`itnP>S0lr#7IfOFIb*sps0PSepuY4
zg?;egSL`Fpa8dVE^RTRof&JgWgcVrEi+ZP=!<sGuEPMuLtkB{w8l37FHgri~!7s32
z#g>^O?^NHg3uY^jL%@oaTIP!aQ@&wO7XuqSfelkwmWx=^>=9nK09G~vJ63Mt6mzGe
zMnv5bSkVU@nA#Fn96237BJS40PB!4gDlOr~irDGo5m`3_OSnKQcFGb_95<adqUjdE
z)+O*8rm;j9Cr)RM7`i1tQQ6=McE%D@ykk0h#04`QNDlZN`xIV7cTJxh@pLn=MgvgT
zS<A-a)M?cS@0I}eCIA}y+>%g?PFIhJZb_ggAGoj@%a-E()Ab|bTUsba2W{AwmaWAH
zr<+G)w-_kG23N83mhHudr=263TLNf427h2*TT+UTPIrtLZb_i&7F@%$mYu~Xru#-*
zFiL_P0e@mT%kE<Nv~R?7i-9Uja2>-fdy19Q>`~rr0dyCFc1&+cFFrjTH7dF-fv!4m
z18cA##pkBuN5!|bP)-Iqu<tB;i)*KoM`gDeD5C<M*ageJVq!XNRC8MZ?L*)%%wWkX
zZk)~>HQbg!+YGpgU9=o1Ca1GUT`<9d90Px2Kf+u1<>`~7p4$x6Nq{a4SPm82r&Xgo
zMgaW*pd0(il2c4iSC5Jq3CxRwTUd+bNOAjg{ivAH!hA5ejs0vnR@^<^JSt-t7zhOn
zcFA(QxOdt)s$m2$00`XJFP6OG!Rd}s10#WnFK`DlSqh51(|w~Z7@R?lgS(i;Qd}IE
z_KkWN21YtS4`#C{idi%4F`ioh5q{8%IV|d8?o8B}$Sr})Hn@kiT22*5&cu(2-CD@#
zf<Eku<xFwxO!An_%|Iv<^kbCeY;oL7+L*>IfDj(IkGU*0#fdYSV+Ob67wRN<fL(<>
z&O2tZ$6PS4gXDpS*fltW*fn!<%;RPtRsjaE>lVB?bw)MDyCZ;WbTEkBurw5-Gu30F
zI}*4z1s<%^a-n$tO#PVnju!68zz}xRa<TZ}O!JuR4g(h>U>NJNfa1e5&N0m$0UU&b
z5$u+wrTFMf$C%-c1WrD|D8|4n(21G8F&B&pAq8Lzy90+p@)_Tl=MDo$8(<vkvDk{0
zGwgBRT>-qx0xx#Y(pr3aCTd)CR|4-YU;^v6P{rqF;>X2zweYM8eAola)#BQj<Z;<u
z1|Cj;9~-b-FD7Qv#x-{Z@MQ!hF^{FQxN#<P+;CR{pFUs;8@6;6lQY@lE|^Y2iorBC
z3TH5vXHJfL?lSO?2Q%2XrKi|FqZ;S+2&_m62w)SI{$hHjdR){au~H>q7V}#MirZ)E
z$HhHbD^d#Puqn%MaraE~xU7e<Ql(%Xo3V@+_s%%SH9Z0wQU(^VS&P4TaHeD2&?B)?
zWndATx6BlKXZprnFcgI-z!J7-nJ*5^_{KdwjEz!&Wo+59T+9lvy}Vw59Z>=n9%SW|
za05|ZQLn^KDM1j<v4)i>A_MVWaj({nlmj*%Vht~e4J3PIy^NhI2OK=i8c`A#Nb_oX
z1r9_7f^nWTx+F1>={5999Fz)#;NjMok{y9;uM38;5H$$JSHc<8uE0sJr<ZY1Y7mA;
zST~lW22@_&J%JOc09<^vHK7CzRC`7DBu=UV@bGBsmXiH}dawAN)`?UCKEBqvwd7!+
z*(<xpIH^hyj>lNHmmCf_y_$Q1R^(%_0$*=UDLESG@EYz(TB(o0N?c&wS#l!K=XJph
z7;*}%!Z%oVm&gM?ujd}qN}U1`_(toV5@mor!Rr(JhMWeG_$F(5$>~7Ugs4yQ8+972
z#uMOw*ttObgt$-p8=?VG_-5<glG;G>gshMGjnaT<e2aBo2@yz}(DVteAXQ)uF0y8o
zGzKy!41JO-R25i@Z?zsMAp_YHE*L#S&VY6JHaLR295^}Q>0_=?XFv?T-Fm3R9#Bp2
z`USrupMY5WDQiv%9jKlV^-F%IJ^}0T6zh?a_CWoFxL^A_@+o)(f5v*Oq&v_&A?s&;
zr#=M&e5dtzNpHY8q3IV;$Y(%^KWEJ=84Pqx82Tj?^%>ZJ@3t0{cmsVCE|_>j&Vonr
z7p=u5fq-wq)6Y=US+Eh`V^x%}X4yX8eF2S}19AAvR&@z?Hp(ZuFQKV(U=yBhJyjAp
z8}Ad}*V4%6ARd3!dZr|HHrXe;&(PH8AOT0LXG`K{(|nry0vA#Z9>c}fnv%rXOrPPt
z#6?wu&G=sH`H~&8**+Hx+95UIar_N9f!sBF(&xF)xG31Gj_<SLC8@J2AMb&n4fz5j
z;%`|SO3>MApXh<4jrszJ@GR?vlKr#wKJf!>8}cPc!r!r8EIBya?2|oU+9+7Xjvugs
zlEbr3pXPz!D)JS00)NliQgU>*!)JIPxk`Nnw&4=%rIHh~eLfe=_aW!OllTW#Q;B@m
z=kq*Zu2Sd0cKndlR-&9``*{xqe;~DB2mYb8wdC|{lwb5v@&{E5p2BnB_xIdvykGoK
z`v>whNXGwZy;@Q`o9vf8Wd5MO1}XRv>-7?1HqEbjD7c1v1D?iZ*3Oc~*-XFTq2wC%
z4R{7WX6-5=XS4k-7%N1y;92}%Z~%LG_N3qQkhw-_!A|_RwWq{BtMc;(1b-rRU>E*x
zYkvtnTkRJONdBbiz;k$>b)ckuw%#uu(Ef?&!1MS=*5Q)w*=E0NfccZsf!%n4b-bi^
z*6G&_2(BX-cmXf8`b!39JN$+L$#n_?FXF}4nG)}8pWij0y^i4ECA`!+UlN%0`8@;7
zbqWW2aD{cbgf+*W<P8ei5dx&*<yKCqf;$&ADH@ctQv`S!S6jnMBj@5L#e>>*L=V#N
zN^5v&>|FAsY>;WE^dKESWsN9}n@gM23<_=__23m;V~s9NoXeav3`%ZL_25<fj5Vfo
z$6WTL3#KTM2JjmGDI7rWnmak^8Dwry4FJK<S~r%a&Z#DO9zh54EkN<ltqG;*T=k^L
zBk7>N1!BC$x}|jgT>YfjqwPSx0~z?2)~%%n=b9&F9;So(4(!FxTep`Uo^wuWJc3T-
zd+<8`wKb*m=v>F7!6WIUz6WpMTI<fz6LWo&E*RcKE`T?2oppDqe9kxN@i3j#1+Wjt
zt$Rw9bL=VJkl-(*5$wnH*7VZTb5T>GA<17<BX|pMfY0-DbMaH+A?;s?0c7IeS@)LK
z&LvODhM2!71IWTJSof6@b7@nWA;C?g3A~LPtXZXvbD2|yA<0du3A}?}v>qrW=d!0<
zFf)o=1n=TM!uk8<xsy|#A?7A^5gfpQ^-!sOPBq0F7W|F;01o0mS#wJ1x#}s=u;g#*
z2k;)=Vm(sYK36{_9@hSi{0QF1f3_Yg?Vf9%k_|I|Q$GR;e#v^gw0F)qr5P4<Ax0p@
zf3fD34$gH<8HOcYlo5P@o2&(;-nqUh7mTVR0Q>{DSc^*obG|9hFw;c=a0s_q6{W0s
z_B3xq(2bDbFz&FbOS$t=)1nbcH${RE@mA}p(#ZMvY4M1*8~F)j<5#R_N@M4fr)48d
zH}w<9!71z6(zyAwY0Ze>7Sas<2X|R(N)zWZrwt>LTU0anCw|p>zI4ZY_OuHoWRVu|
zzxXw{e%LjCa@sS(+@e~*5&XIpFHN0SP4h+tw-G2u#&1{~O40f1Y0;?UHU(v;c&GJ3
z>HhipY4ND`HUi~^_)Y7@(u4EO)3Q<KHU(v5c$XEF9-enjYeoeO0_8&ZEo)2Z(fN*P
z!>ELzpezJutd~kp%=b;ZU@#Yf;eY&&)l@2<_f3078HR#kUcAR@D^<?3XLw@*Hv+?X
z_&sZD>FN2X8PS-;O~J4Y-Va~z=jP*Q#A8}F0^xc5f%R%>?R@f#Y>aVJ5QfDEtk+A4
z`Lr3$nBWcq;Wpf3?JRAa&zv!gN$yY(R>6m@U8UrF_Ka&xdk2BbXM7ZHUoOv|obik?
zcPO|_!pE&WrS^H%3~yX;7lFfJe8SpaO3zo%h{h#%DLCxG{nmlf_WAl5@woOb0xxg)
zly$hYd%k%_HqP9o;9(4(v5uGa&O2u`<ANRpK3wrxtG{$`zGKEPF6p7*hlS5uXG*>E
zeKRf?Lq=?%3}3X)mj>p2GoEp#hq3_$zHD7CRj?M=0iIXTi`an@53+H}xC>DMkyp}7
z*+DtZv4xdIF2o1KUTrVp04hAh7G4&+kQ|VCnO@2P)OeUJqAYG9EuirV?jcT4f%9z9
zWr+)!0fSd^k8*-aJlqyjwqqeX;DYgIq!oOOuY}vDT?;1z9xro`Y6Yk82;0W8)CE<5
zHzDXlegmiR)wYB(bfG#RnvnESzX1&%ZQD||f1y4gp3wFoS3niM*0#0m;6igiHo^2!
zSHKxO#<soe@Pad-nGp0Nzk^Tk^|q9<qYE7Y!-S-t`W<|V3v4^fPAv2VTrhQwP~bCs
zgKc-2e8Cs+OfdZv1<v9dZF|a;3+!2*PjDZh!8v@BExqjYLe#9tC%I42;B!0y9{0{I
z#LtR-+WUwLRO6d%d&_DUl4oT;=04>DHTV|WzA|DVZC2wGJV4sO7r4llRo1wWIcxAq
z9#C!IOMI*CKpDA^J?nyDZ{#ZY3f~5oZ<iNN&U$>z1L`U`k8igfDzh)BW_f<WL*x%o
zi$7({DWeyvXGMO=L+TIkHJ)NSQr5muKP&cYA0pSlH~2HQV`be7&9gE;^N_j*wD?Zj
z@v`0p=d8vr7(o66b@+3(yt2WCj#-0WGC=(abog#tL78`<Z`K7f=E!w`;V;^X%K{6&
zS&yF?psoWP-(yphu@>2Lyh*_z(hdmxWt+N;yBIYmnv@Ju?Ld#G+fJ25F2>J^C$)pf
z4N#B2YCBUFyO=yDn`8#58=wJ4Y-h{j7SrZ5lL8OY0lvk>wwkiU#mqUwq{KsYfba0V
zw)15>7PIGEFxrlEg75J+;O=qP;>kJBB;%nv!3BJu4KGVwRL$|G1VhMQpb>w|)=-8n
zR?ms1Btz6+z<_7jE|l$Gte+E4X@`)Tpb3A+cCqZ>V)LAAiW#DAf{XY8_!T(3=$z9`
z35Jos!4LR*wwAJ^iyd=@DakPPH~0~k*e;cwSnQi~!9+dM1&sIyHdC2=(KqLrVuq<M
z0PsULTbXi^J<ppKj3C{B#6PsPmYrUVniow=MyPJ^6P^Q4|K}Ft=f%_75#$zV#{X%%
zT2{N5JTIGOMyOk$1wUfDUPdgY&1<FwqsVRWA6#bZENfiMoHtBMMycE2XZ)D0tBhRC
zo_E0@Kf-|j;{SrH*UO71=RMQRD8+zF_;FiLnSD_;&zlj9A#MPphPM7Pda-(5G$R?K
z+yIjQwt=$t#rk>ijCKsU10aZJ8!qc!Y@V0RFk{pm0Qcgy@v`1U=e%Y{Fpk^>a7=CU
zmklm<%o}DT<J4UMZ;iH@GVfyFylX}~j`RTd5Vy^jDFTbWdCv?pPW1pAuCOhav6k2i
zynw)q^a49xZsRDpOHm7=fW%An0tc?Pg()JJ;upjLtrximoOq=zToJpJydVoOUg{ob
z#ZTEH6md&w3z~pn0_g+4;Tl`CB5^5m!4Qy4P<`MEe#RD~*s+wo;0kCbkbdwx{wZ8N
z?^-&!;0Z7jR6n5bv$l<j)FssdZ&u(#?gJYC+?Jp~m#P;;vl1V5AGq)u+ZM(CrTPW&
ztk#D-0B!h}wylbTOU(<iS;j{_09Wzzw(W|;OU?z&tiX>v1b^UP+fo!qmpT><vl2h`
z5M0Bxww;O-OMMHjS*;%#0Ds~-+irz?$+zH{W&G3txQ^qtJqqO#dyzLMm_!CaJFd5-
zD^4#(EsEwOlhh!%fj7Y0;JKyvMe&?=67hfz{5#uTMeS1ZqHK<tq&%P#zhK*^AePb=
zHFJU~WC;9)8*EvM#-+?f!<=M_8Ui=*i?#y_aw&V!HK(0IhQZ(Xk8tyTdFkY$XO5Yo
zhCvq&Y=;!~CDkHtUNDV}fNuOJTaJQWs$LY$OQxw2a0_p-9Z|F|)h~+YwbRHbxQ+j8
zJErJfYF?DhGt<;4VDL+}<BHxT=b~m_FoTQ%H~xz)PcgXEv1pi=%ur+C4sNm)D7;I3
zi>`U?3^ESx;_!yA2rT&)J@d>AH4b`kn@yo$Ewh(+3xWXR1--b#rdDv5qn1Pqk^toe
z_wZKRDMjRR{E~P<8$c#NAAZGlMiIN5yd+y-0@MWP$0^%cMci`Ql4e0Li}=8O+-0j#
zBrazz85Sh7ln*?>uiDNlb}VNvxfZmuh#x$}uR-u&*Ye3F&jK?``N05w9sa7OE~}P!
zi-I|15)9%uYz+!@xq3;oD4C-sfd}ujT~O>_u3r)_YUhwCFofT<T~r)gZeEftGIP`v
z7{<HcEA#NOb4jx(m`A3;2!6}fqBy$Tv1C}3%u~}~6lb9R<iv8{l50^rkIaBE{Ep3}
zkT3g|Jd4acH3P=+9{7PMm)Xm_CBXs`0ABo_tyOV)Iciz7Bw3&WU;^)l!+~?l@yp^R
z?E*3jeE0*~RYmP`^0I7+S)gWtA0Mz?R}jl-%bF#@A~FXiagVK2(YTzsY*>;kQgdJm
zAGUQV$mQ&1*OGP-nFrJODC90KFP~iYEHR7JJea}9Z9NM6vTB*PELcJoKmebx^(*M*
z>SfWgWQke;v$)?jplDyNUluQGmyks;hfmpt72V6t%d%x=iCP5n_>65_(Yx$i)+`H_
zktMKz&)WQo!R3x+!?I+VS^|ssylqCI@Gkc)yOy=f$TC>M7j5&3z_M@Iv&<}0%U~H_
zwk<1IEDnp$60%Sh$s&U693__(%}QcPSu~3bA~^OiWh5(smBFfGp+O{@2(gDNV_7Mz
zT$Y<f2ay~i%pRePW2LjISi&HbO$HM@d$cl<mBngeNrPxM8A62HW0X5sIjlA)96>o`
zD6tZ9C%agAtRa>=h~|)CM1*~#GL@xf@q>hHG??TPtL+I&lvTq@3X-zvV3J2f+qWq9
zvl>_#L3M02gya)z?OT-xSuL#GAUB&1A;XCn`*!7FRx7J2NXS7$$rZ$Udy4WXtCQ6f
zB<0Yd<Vr$d->E#o>Swh<&j}hvt|B(rcPr&AKWiw+&7s4{2x6msk5b9v1o7FzV3bQn
z5}WMl%G0dqpd_|5nC6nJi3B(-I>$-~%3#+8qdYQ-*lgdctYxJH<+9zuG>?oXw%GS6
z308Vg6<ZjB^2s%X$eyKaWMu_4v85q2pIl39wI5KDtel`Ws8>P5$#ujwh}~Rf<pm9~
z-63>18AEKhA5z*`>L5Nx7>ceSV~MBiIZB#U6O_b}hSDp@^+byOh_ap45R}2G3q@Cw
zj}Xt;k14xZEkU^)cPPD*6c9V@$CbUT)}ShmFbrKq3W?|JdCEanXHXMI8b+@oHxRq+
z1xhcgKd22_UC;>fQQ}2=u`<B&2MuxDVRQt!k=SEbC|N-qHa}R%MI*^L;$^#9$qkBT
zCk0EnbR@ZnNVlI-Mg}FYGlJ{5=xQ>ac-4MJ85@+s&JA{R>D6Qcf!NO~<AT!JRl!0Y
z8bv-vi0w7X#Gov8Q?QgrN0FO}z4r6U9YHzlHYk%pqshmKHz0MiD=3dW6zt~F(c~6l
zpB-1G2C3Qn5FsC3Lnab$*&CE-Pz^gNM9QbvkRl?>enGiEsDYgkQpZQvl1aon_KV7c
zK`rdu5I3J*OKv3&z!Uc2pjLKOh%g*oM?OKkXKzs+4eDe!g-FBcb>uceV!xz35!BCa
zgAN-shJ2Fvz;05?gZ%8F5O+8oLvAMy*=<T?5QoDL6|O*I$sNRp_EzQTplD7~sB{G#
zOFl)w&THklpaf1vXx$2QJ(*0v3QA>dPzonE)V+dUPo@yC5lTq}rE{u6g)7lV$fpTd
z(4cG#%HlMIN>|d4kk1g%m#id%ayV^Jor4O<X9=h;R9+6s;|ztmSJDD<Cjo6jN_&u+
z!w(a#LWSfm0*3pQbWjZ^DNMSG7Lv~qFl(o54{G3Kgw?G=H;~U05Pes62eoi=!`!Rr
z4diYDl4#1_pjJ**m@oo;lzf4Ji(#c=FsPH$6ef+JA0=NT;GkCN4eIB#h1Er%8_Aal
zcyCe$g8ZDJFn0vKk=#ST$C#4E<^=P(!bmiZOeM<goN_KZIyi|djilqqmkG5!tUQvP
z5S+oSi$ph(X+)(xygZhj5}eC*N79?fbmEjfqCAeB9$dv0u14d@R|t(gx;&Ac72L#?
zuBPM3SBW$BnDQO$oZvQS3PKae*N9Icbhe9~7d*suuci}7gg9&8Sf0vO2lIKtDD*KB
zB|f(&l%wpL;3S?jihhg~6E*fN<@?zU!5O@|D0DNKL40Z7T7Hn-5}eC(N70+fy~KI@
z_VUB**5E3hFdBWFe4Y5(o>G34-5K1(lSb2zlW!1O`_A$c?Ec_3C@4a=kZ%$?`|ff%
z+aEl{b4Sx#$bAHE-&3w+b3*uh;TklN+)wE3>E)-{(IH8E=^8qbe2Zv+qvUh!gpdq=
z-5OLxW)k1o_m<bPQ$lk2?lrWC%pxw>_mvau^pGmPa4nidzD*eHS>=uFtdJ(YbS<4k
zzC&EJA1Ei;IU#M(i-c|^-z9#8%-v;nUdRyNy_Vie9w31IP`RD04&jFj*P&042Z^8T
zIps9FCL}3bx{iK=e2-|cA1QBVH-uz_*R4ahk?#{f+mDrZvs*%P!`<uXZKQ;_WItZs
z%We&+3KzzpPm)sN7kgg$AiFc9DO?&uKS_Q-nCu1RUUq*-8`LqO+sS_r7JG4dfb9<%
z3U|lQ+sQ+O&8{eCaX6v;6~b6_2YHxq*wy7+PIPF}3TZ68gZz+awVx`F<RpY<tf-4c
zpCYq~EA}(xv7D69+!gLv`Y93?(c90K$8pj_t5yitqsb&JmbTZFCvvhvn^s8I)5#<(
zinX6F-@(ZVZG#plG=+r4kB~Ur#mNgDTH#(#r;xD74W5ltIqFdUO5r2u(<CfrvNx2Y
zoSM+2mC{G(r%70}V!u$npVJVUv9j(F^cfNsC)h8RALO)z=B{)<LO(-75jwn)ALg`%
zR;?5Y&}T^~Hnz8vALVq0Hm#Hj=x0eNDz#rKKf&n_ZG-YDbSDYLgLYH7oZ}B2TIm+h
zJ4q-Kv)js*98MU2l~9Q8BB2<_-dcW|6CIYcN-Csxkx=vjHw))D31Jzl>V)WXBn<A`
zua?(xQo?dqxrOv|Bn;x(ua^^?^suT`!VT#2Bn;NsJIfn6Sz%49q#NkxNf?x|ca@Wz
zoUpc4bsNy#Bn00faCw=N7dEuYy@B3MLXg$o1HY;2Fn)yaQS=28f@${ta+*^UmJ}g<
zlzxGPpox8;yq(h!mJw0+DEcA^7svMD@@`H`SZ;*-QTjy^E`sdi<%(WTYgko;a3lH>
z2`9UDfB7J%Gps2>x{-c~gp(TkOu3iSAJ!I8w-Mb#!kd?UzC6J3hYdxzH`04Zc#^U&
zm$QO7Tz;f54oxNDlhMIZaf73|Ns-bxI+cV!sUu7k8Jxh)h^&i4UnW&Vh$CDT8=S(;
zjdaJ+FOzB_%n_lA3r^=&MG7~eX=DY#b405WgR{6zk<v|c8d*t%J7QEjf^)cS(C~$(
zlOGc+A#l1YIFCCN>E1-Alc$IX$3|6Zu$s$XEsRHBAx{&l9SJHlxQ3gwS{hHkLTZR;
z#}?K8;0A8S>biLJRkDg$>)5I~7~I0mUG0viUnS2FF^=u3!@;fGs@1{-^fmGmV!b0p
zbu_q>+q7DmK)*(QN(dY~RVRY`xouD^h9cx=#0JN1l|0zb9a`;9pb_#cvC*+dr3~iq
z_))^gP?S7JY;vTlP6tQxlA@%K(J1*jkpMSM=YkV>8BukQp<=R{*zDM=str!z<wm(5
zqs3$mvBj}ZMFgkws-lFO(G2nnLgdI&H3nz#nxdqe=?wBqVyokTiVV)-wLza5x|jTl
z*amsq%fWfPp(yuedM|mN*zP!_vInbq{Al6h=<8%H@suM+MF-dLlA@)L)31|X6Df`(
zs`lUpUPg4?<LDdYH^eiJW2)}p7G7?&`*HdWQcLV~99Q)QxALl@g<H@!$vWaWN1kdh
zxRciuE!{%DN$QB*jslf8xS!VsHEQTS5+h!86srQke%?^Ddkejf#ECr)g^Crz;q%uB
z6Vd%7LA>lxtGFT2{G>I~M0!7|C(<3KRFNSG{ERhqiRfEoJ@KmJj4C!Hg`c~|ok+h$
zHV}y8tST-fonN&^C_*#IZwaxZMwJ+n#cx_8715dGcf?-DdDV`P9DW<Lx1m|&_rx0z
zH{KPJ#~)hb7SUPc1!A8ASEYui`TVuQB=l{vk$B6|ph81x_(^M}N%Y&Kfyi=PQ0)(C
z;AgC@OG4ivn}~ND7gYyCTKKtZ-AVL2<VE5DoZuY}Y2{a~6>de}C4V5^bF`?AhII0q
z)=Ib1?~*?f62~RgiI9GN8<fVO2S_9Ffy1PdhxqwJYu#Jv10*00IczFr2q&DsPWS|R
zkR*u@9j&U<A<^MU>!eT62g#p^9JqKq7m^U3v99h3^gXhf_^0Elsx~AgJa?V@3Hm*<
zg*f844!=d|;Z^H|+tByP{}3`qr>Zd|E4*o)bQ}FX`7?3M(WN3oa>Co7s}7Zr|0VwA
zU{sew^1_GKxwp|0@)B{}(WA15sKfa&!Y5HFd71dPqhCdb)PyI+NS~yo<S#^?V?fm&
z(h!~zQ}-nL0r@NOkz-h;=niQK&y8_ENq<0^hyusBsyC!HyedYx9sLJsCJG&X)nG_x
zcvFmYJN*yRLKHh@RNj#O@HXhkLl2QwqSP_33WWH>hhp5@=|iNAP&k%VtWeGheynf@
zdYH5m<qnRT8ydYLDOS3JK1@0YwIfU&8Je&nBere_`XT8gDjnhK*wB;}xv}mY^oL|C
zamo>)jtfm+Q57qE3e6^eBQ%a^bz*4Nil$iUQ*<_Yg*fAgQSS)NS<wd7d}t2&JMk%`
z&3A?7tr&`RKSk$|6mizEQJos9Ucp~4Oh*5Qq>0ZR32HR7W<}C^X)^skq>HF=Y*FtI
zZCH`9zAhPs<@Usvj;-p0p)D(N*SnMHf09>;^N#K6!=bG!s@4lrP}p8geC<e49}VqX
z(X?KgLc_LVLhIP6J`vi#q751WQCLq)=p4J%@=*VZq4n+*`UrWQz#V(k%23Wq{v*Pt
z(W7KLp?9RKPlraYOnOB6G!6R(i3YfcJ{Ov>GUJiDr%~81M||hltF8@AS(*EY`)L{$
ziV+ta`_x2e`pT+DgwLR`K#DLpveb>CSu2|!kv>Di#vtON<A9nB%~{z7MT979h#`K2
zu>IxGyp=<bxSye6B?ti=ht&2^^-8`#_$&%5Ac&tFIchqzW@VB<`Ya8d|3r)9h`K$r
zVP%G(?pYK%-ie<b$JE`SEh}>c?q_Kz^(HPkj;nh^TUS;Igga3vaVCCo<f#WkJ6ARd
zq&sP7?Ilc(0<|}^e`Oo=AEMCGN?07l>OiP}<&eO=lZIMO!sbw@Sz(-2e4%g`3N?&`
z!=YAl!=hIu38lMe=-ne)9jDZhVF{};gmt@6=vgDKIL@eJ!%|k|3f;SCDApn<$60k;
zSo*3eq3}5rij)YKqeh(=mbI!$D1DBG<{aXx<GgxDSk9_8s9i*%DTTNOvj)4u@>UHA
z-OtfbjX_+8!?@Hi^(y`b;qxd|ArLnl4Qe#3W>wM#>GL$qz7w5}3+nx04XZLX)IE>F
ztTS=baZ!CRtYua12KVzc47U<paN>VBtaVk@2H|cLh8c-lju!RNu+CLY8>G8wm|i0o
zXnZ{p*1xI^+8$AuRwC{=Olo<Uf7Q?i_ih@-Q-~fo15$=@BKVIAUqE3Tfw<>rRi6%v
zj!1e``T`C4bD|$|3FpERA~GJWdjW;KG4a50Rb3mF5|R6;`vn>Tro@2bI(+M<M^rs3
zd=Z5}A>na!svE<yBAOnRzDPrYj2L!wsmZXMh&CvhL?JOmjKZkJ<*>Ynp-0^>(hw0L
z#vMKIYM_qbZxp_SLL`8gaP+I`u$qXZjnbEBxC18qjsdlzJ**)jV`JS*C|vpxQ;uPE
zcUVhA?nd`ZG~DtKGmdd}Z&+(Y)kfhS6i)StS%+Ue7}golv{AZ;hGSe}-Z7*0hV@6Z
zLAfOg$9BY`V_qEy^G6JAbnl_zoQ7C-EUQ^uP9#50n2N%Cxjx9rso-*>Ba`B!sWiNZ
z={e4@ib!rkWJX+FDhdzY`VeP$MJzWZGB?hhO2d<uKFk?W5ywrBtcnx9jKVjop686N
zNaSWkHpNL_rs1PhAMT8)*ul+-Y=cfs6n=H|D`C`R7dJ0*D9-&d4L>V=gmYs>DpwuJ
z-y}>!D@d+>wKJgt<<>+dZIY(Z6(mm|?c7qapW6_bv8gT%tt9#Swa%>-2e~bgxtrW+
zbR`+Ck8y6VILvL0tlA_@M?WT4=+`?_DvokHBbzo!)9H`Nm3o15XT=F_e`Fg}d7`Jt
zRr(Fi-4$}KKXPc3JDom7M(8&>_f#mkoYnkz;VbBAGE%?EnO<?48@)OyUiu1snp~|<
zfSk%XZo=w}__|k64H>21?A%*X%S~CG8}ELF){xQqEzW%v1UG$kRlM+3w2EA#7df*k
z8o61ko8qOf(pBVI{Z{7z_%r6LZi5C<^bEO9zYQjBE_3r%55>D*rO%Kt`t8m`6?U$A
zH9tZ48u|$ttAEOwQ$cfURwpG$U!y-E*XvW9M=IL64XZN}>Rv-XB_Gj0<2+W;&23qo
zo8W$p{*)BxcRG((^m1EQS0xA$^fOYZf6kd#G05#)-IO3j=+DRv`rXcg3NN>RbsH3y
zqG!oR^)EV$D*{~q>Y)TTLZ2l!>i0Mm6)YYnivO4pMbD9O`j?&R3N9}?D(NvPN}nS)
z>C>I3Dk6CaQ5lcbq3Gviy#7_^nTl9mN>uJ+Zj}C<Owc3FvlVf?^r))GgkrRsd`vHP
z)>I_&vZ9(ElZxqTa<hJ~^L)h)UQSdS^rfOT<m37`V9;n6FE487F}IkmA-CxFIq`~A
zo;r%ZS(t%-K_=?oayC?;yqc(_&C(3|3sR)da$cy|&ufUv*j$%^en}?j-*H~7ILK>>
z%H8bFpuZ%y>JPvT;bC5DRMlqTUi2&S3H^J{mWrdi&Zwr%(!KOo<Tky;d8y(AuRp2{
zYFg3r<dgajoTdsn&mT3k*}a!OPj1&Aa@s1CJWe$KapCJ|ExAMgp|iE(G%q?j>2c}n
zbS?RmJ_lk;=XeRx8IRY!j($xh>;LJzT2aeOiOzl8{W|?MnW8`9ybe$4>Csh>3*SJ$
zA)nUEoShYoysYS^$E9!3-;mGfk2$;GuY68)8??isTJl-_zhKVlGA}QB=yCTOw3ghd
zKkn?Qu=CW>{4K&a(K>RM{@>323I)xpiB8%geUq*upVQ|#2P)cm4bd4}>fS_k<n#KE
zoWm8}yq4(PE$%mI9l2Xy;2f{$<+VmvZ4vH6G4cg{q0?V6$m@)5+9KUYW8{naV&_bS
zm)9TNwxw<#ijyztOP%u-0iHj4Xp4Ivjgx!y3g>bKi_clZPZaJ)2{Kh*?&MT*`O#~V
z5~cfTf_z!8c7|0(@)Oo%B-ZUm^<<j9(ivVE%THO8o9Nz8>&bNeDQ84w96x<cRif}M
zw4QuLuW?3KCi1h^G$l&kqU*_5^=F(hl{@%3Yuca;7i}P4(|-zcX1n-#YlaftZ_y1T
zqCe~0SeeRKui=Y?ndrA9s{h=XP>J$u)+C9fne?}$SYPAZQn{bsuqH!Pmx+EyX6V0k
zZmm4XZ&{Noa%a-tk$d&$o!cu9^IO+ciG*3`_vGvPubnBCNBNy=nncnp`g`&Xz1F$2
z@&vzsO&fIZq8G?F^*ZP7N;%)ZW=Q1DqA!s9^tf|RrIOEC%TE%%jW&||^?GM|<!OHO
z+N31u+jJxOmc9XEZ0Gn1YcrDS-bM{%rv5wU-pX2j%G%r{_uI6A%+g<Q?yDsD>1(T!
zgzunD<lB0KGpn+ZpS89rN%{`mM82cH=sW-)fjMj2p!yfRNWQE85ytE;^YhjYCAr_B
zFOmoJz<H?B&R4JHZxz0a{y-ko|K!Z6r1>>#leS9VrGFsb)3-Q}RJQXQ)@E$2dl&tY
zd|&^w^H^m!zh!OiR`<K~kEBF@$$7l8m*2X!YOC-7Y9yulUz~ZBgZ$35O<Sc0Xe0T7
z-sCK(^z!@Hwn5`C3dn!xEzaV~0N=lMXsi1G4ah@!n^RHA3g@ijKOsDblH_5%!>O+1
zhDWbUdO~`TCdm)=t<F=Gk>LsJGM=bAi2g)o>#sP^RK|v<tjm4EeUSc%%+XWMvz2k-
z>FcVV5Wa^tlmDZ4Icq8t!?V^kJt2LMZYKY!zv?_+xg$JhT^ke~qb=nB>aW3+;jZw!
zbwf|M-=kZ|Bl_!b`<EK7UdP`id>{P}c~pPH*-(jw*Q`t0CVij&4=K}kIxkf24{unP
zv90cX^k*_xf75xf@?dz&y4-E<_vxR>WBM*g6dVq3U01bDC_(>A{vZ7<XG`VL@XmEj
z+oTfuzvRF4jPp|EiSYh)ZP2fbULyam{*KdBDG&Fr8`|cU(3i;L`W~mPQW?&P;Xf&q
zqL;}NdMG8XJRKe#lk}uiN?#`bt%s7)%5&ifF&R(RNzq@(lX@r(tgH=BiOGG^Ev0`U
z^YjDG>+n{e9#i$C@B{Q$^8e|f)TgpBJS(Q@|1)&%@l8~D8^_K1g5lCafTr!VO`BfQ
zDbPZI77DZwE;A|6LVy+-pb(J~M5+;~qP7@m)9Ed3S|~CInVColA~`22C@R&-WoA&R
zW?gU{7u>81hIPTsy5O=d@A;PxA4r>-bAFfSdA>8K&Eg0CeI69jfo?==iadkaOkDIo
z??I;fLl?%{Q{pp}&EiG>e$SmxuODh29_vU^7h_w95B*IZ<cd2aj&-Nt#ncw@L;njN
z<Z?MQGL}m*7c*OkkNhuskZS$VwXuN|Td}f5{K$X6gH))8Zj2RD=wfUu@v;9U4^ovK
zx-~YM;wz@MiXZ!5_8^tWp}S*aDRMEhmAK@8#e=rKhwhI}q{NGrt>Ptrvj=T)4viY8
z(yB|adSck$;z3i{)-mHWTD*j+7l-`^J!r_%nmkUgHJ32;#3%k&J*a7F)s8c2Z6!**
z_=(@)K}ArjZk$O=mtfn7PyMfX(4p397-!M?N~mq(r~X48^dVbI##yy;3A2q5{H>nx
z$YfeJ&aRD@DBDEA-{wgYvRW(0Ikf7T*mff5cX}oY`c`6`TZ_-6wu?c3yGJ7wwAPH{
zwC0)2b|U1bJyV3D*1B;4t!<{VT@3j<JSjqPYyCJuOV7ltMA+ZyNfnH(4dbF(-%QFX
zhW%ZhbfL7haa>F*&t$Ab#NX}75XxJd#wE1znTl16_<KBALPcxKI8~~87WM=o`dyxE
z!PM#;r%A<UQBR1Xzt^KjDp%JyeX4mD^8_LJ`#gC<RqNn5W2$YI@`Nb)-JSxWy7lBZ
zQz|_R+d;_weovubX&oA8N%hU5c8Icnz*8jDq6*2HD$ine5SRUjJ=2lL_QE)OYJ8Tm
zL%i%i;wcukwhoVTq^gbBlf-BKLC;LV+A5B7r{YHHN%1rPQIApB**Y?gOEnvrCyCGf
zuY2YQyIZe~3#8hN%9G;f{$rj}VQ=e=aY8C>#C8&2_!-YU!QOgnTr|~Zq;`s5_>X(a
zh5fB}$Hh`*BeRpZ;(x=lP&m+fe_SFpZd7)PSNtbD6+(0CsPU>a^=zzx81bL<EEXKC
zW5#RJ@Yz&@IO6wsOhQ|0@_2okc{bBPeCcOB%Y=?r?RaCFZMK4V@qW&;Lg;DLjW?yy
zvoQor_wyc7aJL%9The^9sa@h%ey^uWIMP}&-kK)QW)Lyk|E6aZvKW_*x2MHtD+n3w
zKjo<wPPA5zcciK3V2GLQAM&gbxK?7kI}M*hA!e}uw8tWxYONX1rJ3h22%78ndDaVO
zTI<FK(rj}SM2+>I@zf#(QvG-#jh=%cY^wh)&qg88+Auzv=9@zyY^eXNXOnQgwQ+nb
zO`gLbZl?cj&t~CbYt#5dT6~Uzz>)rQo~^>A)|T<AboE>ekrVxX&o)75b&l7h<8vuQ
z4)g<$6^Wi*<Mrw0xeP+*`JrcraJhAGyfNK2S3&GJf55X-xPqpDrgVBPhTv)bcRag<
zXzS2;OS*3^h2UZScRjm>tEgbMrpt4gJ;b;E_dI)$!@Bvxczb$$u7dbc{_~!_!u8hS
z@s4zLDTV+_{tKRGgjlOM-kpw@QV1aAf8S#lZnln$=hDrk3?k_GKk)1mZns_=A4s>A
zDhMItzv$U7+-bdmUPZbTLkt!Fhn^RNMC+~b(R5!ag%~3Kk30v2d#!iJ$I|6e20=9Z
zAA4RF9<<&cpGc3FDu^QCzvO8a9=48}pu*H;7{Vy{hdl=cRoj>e8VoO^5JtfNiN_&~
zZcCn^$IN96%F*|K>NzBgZPQLLVzx2`1<CsbPn(d`rkh~G=rRl?sr!STc0to-m|($t
zWz;j`U;H6Yhmg`%GQo<;Wekea_J=)P$YEYK!H&ht6qF_Hk9c~7thUMt4op1{Lt)B(
z(bFsF+lUEn44+4#Fk!#saSH`)H4`|@JdZ(Xx_;R+AQZLLO$cDNc?yb?^<VZJ5sKUD
zCkPll4?}sX{?9x|1!G&ogec~lN1;4X|L2}#LTOv$gcv5zV^E-`{|nD?p}ehWLIR7=
zQ&6I$|BB~?P|?;hL6xDNkD*9K|A@yUnA)5ZG#U7O3PlR~zw~fO1n-)l&oIwtP^O;$
zE00&GY8#wj%&^T@P^g?g>NzD;x1F3|%An_C`-r&z51!M4rEO?}CBrwL+9$^SUwh67
zwWxuzX2|my6szU`qvtF#*k71n&xp@gP_C5!s^^@rwQYEUBST$|p<E^ZH4hN1ZQ=xX
z23}5~U?KlEo`A5kZDazMVJ>G-vX1{xo_B@aZPz9QGHm4vik9(z>p3s%ZM!i+$e_zH
z6s_V{Jnswkwp$aT8NPA~WsCT~^IR16x80o(%aF?%6t3a_v*#n>K->KZiHvx;g3=}Y
z*FBen=C)Bus!a6)45cghZ+KA4-!>*mlZh{&P`rTudygQrwIwI%GtCPa<gfSt#S;=b
z+O$c=Oxpql8O;4LPekZx(<PZQ=>-@vSo{C#kpy>}A<2^ITR<U)vHu6pW#LF$Ns={F
zUcexWt^aSH&r!ZWS&}_7zCb}9Q~yoR6(l#ROmbwZ7h=d`>A&UqQsCN%BzGphkU}Oy
z|Bs%iaH_2)iOV!EWRT0wANPDMoN22|3S`<AD#&K$zwNn-6pQsqLMFWsLpCe_-#y<5
zfwqREXr^x=g?vW-pFH0p$W3EXEK^>{Aft`{AD-`oi)~FwiOl#y1vyRpcRbgT?4>11
zm8D*UA*Y4^uIGF7^E;C?S@<FfSq=O@dtySQ&6T9jGB09~*53b5&kw@ow!tK0mTi%O
z#OD5l=caH4Z4FFW^dbz2t^NP<{3t}*hLS8<zC{#L8~cCp+!n63HT#pSS@I$V>23Z0
z_WXqM6)q&%v*L>sBslfo^V|`xqwS|7OI?8>!KMGc=Vu|-CMLPF@Cphk4*kD+62i^4
zkt8n5T)`m8o&P_cUxeFj*OCHRwh9Gl&ioHN_k=rbH_+8hS71nU<^QkeS0T}MD=C`g
ztDunR$p4$?fpD+wZc;2uu3(Vr#{WOhZ^DDN`$>tcc!h#wC;o??hr+|QQOPQux)MXO
z3owd(B&c$ZN!IA_N($)?z$2_GINF(<tk;<<8MJr@zhfT_j&*92jXGPUf;P`U#f}ap
zId#b<9bJi`%`5ml`&dxpG$dPezDf$M9>JsR*kFpYB-yHyD;czV1OLa4NAVJ6$#z}5
zQbEfnFq%yYW;rX99Xj=53@u;47<OV%?<A7lI(#vOwh!PjRue36)+BQ}^I`^#-+`K)
z5-f7oB?ol2#R{4~gRyK%u-I9jEa>RP7@EI=acpYP=xj)i>U@hSG=K!-+4NwkvoSfQ
zlNU2+0tY6r8NqUAQ*uHVU#y@J6i8yTf)&n|WL36$35G^6Aeqe$nw-vLO*X!SLNf?3
zk<}xQj4N56ZC=8lCLBy+^MX~*!DM5$ZHe-l_!!Wz1;J|P$z)SDy#zyD7?{i!1})B^
zWJ|Vh35D7aFoi7&)}r}}HCtZ7pgJ5(Wv8QbjSI>4?D!G|)uAATEe>vV4ktUZ)g}xT
zVnEBz3|gIHvO60$QK%9DsjM-$(>apNWt&Y5x{5&>J14l?c`Z4RZ8It8Dgx<jX>hOe
zMzWAin=o`11B{&)v^#GlN3(q<3LQougDns4civ5oWy>Z8y^SD~T^Kyzyq}!Nj++$p
zG=eO)BG~L4HBptLUW%cw1L)YrL5Fk9L`@F9ltP~eWV5DVn=^T$KF7S2aS{_j4!bPa
z;nYqv=Gc}hPH`g8vnzr<PTfRP4!sm>CnkYhmJGU`hKZIO-%_ewoCNaNs^Af4$wX_8
zyp(AtG$5Z{6+GrFn`qC8FICz_4Jcr%gD0Go6CF9~Wf)CN1_pLbkVF5SI|pAz(c)xK
z$XbG@oHY}<9P=`UCZ+(KT^~H-teY6fu`N?*aSAA6Ymvgaexi^=FT*;BsbCtrF&J<*
zOpNCEmQfwzR4|?06g=;2oEXcImoXhg3Yfue4qkLNO-$s(mnj`$3Mgi`1}`~VCaU!6
z<ya@71tsjZpx|^))adc$RHvu~Gg&LLOt~iN_2%VFCy@$fu{(m7or4pNdfRfPQ%nU$
zc4zPk+A^B-^m43=NCUIkUBRfcd1#_V?^{lFiD_UCyE}Ll&D*Scc{$TXq=UKa9u%%}
zVWM3hU#@hC>7bO|8@%oup6Jl4S76-)2FloHf-&^#cI)vKRJVwMd8|En(>XGc)0<Z?
z-9!eM&+ZG}c3ztp(A!oh-C_nPXZHv1IB%d*pI(9W5Sd^B`$90`yfrbZ_pP9M#7wY|
zJrKO-ygM<bmsc=7L>5@Yz8rkuygxCakFQXA#4J$3HU}R%M@>@YstL?R=s+cVFsN!D
zGf9(+6O>ETfyJyNIJ!M~l0Mf=FfJk+EMX4?$F^%H8FOuf;u5ogiERrewd*FCa%lqV
zC33)0wmqn6H%zkR`Ut95%mK^Tj$lfA$s}v8OfbEK9xP|OP_|6jBztb0P<ll@Si$xL
zv)U^sIdat`)<@(5g6$3J(bMM6#Yw79%mpOt4i>c6OyY9QB-2Oa0W&)gENZWt6v(xa
zN}reqs@NmJ;`aJULM}~WZXzG7WRC`o?G2NnxjvF|i}_#`dn{Pm-Z&|iD<jSfQ2<u6
z$AjhVO_LJ2aZ+)M1)!Qe5v*u$nWV~7o3Vbv0BTrI(A4gnq{+k0RKI8dYgi6h=v<TZ
zd1f=yPZWZ+tT$NIJ~+vkXEQ7PVj-}wr-Ie(CnuTmXfrlI;9wnlI%sJhnq<lInW+I0
z2kY50!CEwawdTnPZ$lJ;4eVJIt#e_LJuhxn2E-yz%bp8vZ6BWG$WvEghly#Rjs-z0
zdfD80colV6oCY?sf#A;ekx5*hxr#YVOb3s%?*@0bUz-%jvsEdF#pz%Zdp@|g{l+9A
zkFLUw5HkS9z8|!=-<lN7^Hott#2H{Sdoj4b{qCe#o{XqEL^0UHeiS^=et%LTFJ7e_
z5sSfA_ENC9eUwI(uU?4_5+$IX{UqpUAEVLa<148_u>@>mg<xBIvPPe8Udap+Gr@K?
z6zpi%YK-}|mCB$v6Ij_uu%}(8G3C=Mv7^K+@B}Lb-R%aACEvG_Ix5ZrJJ`#?Bkd&`
zYrc$NK7<iG$$pNKg~~Mc{P;@csAvQ`*(*rjT&Z#7t5;#K6SF}B`(=<rXN@}_Uq!tx
z&IY^KXz)~fjfTrNuVP*&<^UV}b?{7kohFcPTcx}%&H=mGtH=>iuMzU;RoF3NE_jOl
zCKzaM&_wfntEgk*T(F1zHh8|hQ4`CT5kiP41y8fz1uwQYX%hMIRmw536zpZM2QRg^
zXjBF2)fhvRfkyWGpwRBrXbSMv6eE^_XV@5WRJt_!0`qEyA?AT+*&l+J+Xpqq0^4eZ
z5$6Frdoy^Yz4@fZR6wuBjuZ32bL@}7X#0@HQs7%n9T(?=eeCVvRWy#b7Rala<3u@l
zp8W|WD_zjo3*xJl<6=43&)x}MZy(k;3e?ru8^i+8#Qq$Np|jRqfLBv*hzr0AY$ABG
zeMG|*n5&sLh=t%q_Lt!8_G_9zfvsA3LtF?Bu=j#@+HauI09}opAQpj_*k6N*_FI~0
zfv=i6Aua+hvk!vz+V5&&1#&fWf~Wwmu)hT#wBOex3gXqu39$k+vk!w0+eb}S8Pqk{
zNum<8u#bdP^q9#S171U&6f40&RuvjeCr{QJ%r(qOVljA?eKa(d)=oAWY&FVBaWQbP
zqeDrwZnDWh*I*uE33!ctETo|glPv~c4doG+fJ5xqPzqf#*=mq$7!P3rt?YOdELAqy
zZiv??9?=Ba*rZSvT{+odP_MyQVkvO46GM7*)wm7#8j2N{f_7FDDxhm7a|ZJoh9#B(
znw=6VqU$CH47N22D=q^aY)Yt@uAeLz=rtHeEC-!zYRE`8OpY3SYbZ`!4!YR%P$}Iw
zIcAU%ABtE3y4j3SIo&ilVTi9$IB^B&VY5ONbjxH_p?WRG69jOv*&!3{oUAFt*HXMl
zfL>OQ9Ja2>`a<(sh9^kS$L58q=)uXxLfcw}7fIk|3qsZO$;qZddM)N9%%Gnw3|Z)*
z$(BOjTFNV$!2nwnszuuwYoUy=R74dx%uYwSS{EkU3*&1QuUG|+u*IRR^zdXyq1uAI
zNvs5e?97lA-L&pP+(Nx6t^`L}V`wKmGMOthTbMVARp51YPG~oMZE~Q{W>MZ0SAk<}
zX=pEfW3o_4Td-5aYQV7bLU#Jr<Y=MKLY)#<gX3&@Xg_^-a;#8BG%TVTyumIE9iZ<|
zP87y1$|<oLoM0<L&Ge`#DqOt|8zO4JNp^9_L64cD!SQv}kXQpetSQt+Cr{Di=5@>v
zu?Dd0vQP)Donpjo>y#mJ4dB=np&nW{#e~!Au+zj^z_Vn?O&g|IaNj!Ww73>{*{aYH
zx@3wKml1@Euz)w&RVY@hY>FL^uTxHo7I2EK4xOMYr#Nu+ddx?x14HbZ5Qhp4H;%8T
zeBwHAnze*Z(KS;z+`OLg5$l1ET^~9_*G&oFw)KinTo2B$wa7tLKSjXl_1GC=19*$w
z7z)r0Q=+(UJ#|Lh0M4?TLg(qmDKT6|>@T7gyv=S7U8I|)B=Gop<&0Ph&aqoVm*|!$
zsv`9U>@A`W_}OhCfp$*O6yY1Fx5PRCSZgRkyQb)i%o~`uh>ZZUJ3^P~=D{h(BHIS#
zEpa0VuscInkc`PxL~p>(5|4v-*j=G0Jv7Bq<l8`<6(0xhvb#f9(YDT7BqQb+u?f7#
z?g@QMUzlPqif>TPikrZBc5mo9Jv_xxq^`x@CMa-$eI^t`g_gSruch7=DeyjP58b3k
zrf@~(TIOwHGx&hr7rISfn-VCp)hcg`o54kPf9MW<1C0{tTI?LL1$@Z95K7RurbLT;
zwbVIr3;2jV5V}X-of0dO5$cTC3O;6E4n3gnPe~NTYn5~2R&a@J4n3qtO;t@(*I|C5
z9t^VwL#mE3Q#I4@I?6BBgHKpTXmm&NRQ)t_9pfjqflt{(p|Ks>sm5uxI>j$;0|MI?
zO6t%}HBF=IFhFbvLAE`l=`c*SO!L)IK->;OY)2@iqhzXenv4i*gcXF@E|e-)Hq|~Y
zUZ()j3L<PzD66A#s$-gZBL;~lfXMcS^r+5sPs2A-P<#SNtUFZDQ8SgBX5Pp^Vh51f
zflyIL-PFJ|+eQV7JHTc3NT|4@eyT8y-iQT=C&6dz(U7sDVQO@mZzB~Dp9G(?$3mqY
zjZ<UOWCV62c7iY1<Dv47rm2Z(@r_DA+zGC*Cqfk+EmKv~)sJKE5Dj32^@L0v&Z(N|
z_~X<&VgvY+<&Xj2HB~>|{5bOtu?u{~dP7wmgHw&uZI3JOh`T_PJr%0%I62icoqim9
zm#~39u%|<oj-jcR>AuIQcSRfcnmrS$Max_3bQ$sFh~40i>{%45cVVi1di-(aU2!+K
z%AN~t?HHcwn6BQ0y+=F+uCX9wMP;^oI=+c|Pkah|!v;b-J4U8*)6JWh_lP~<Pwcy)
z-5uAa2BzCKDesAUz_;xA(B6(4Q-$gDChR=%G*H<0L-vkaQ=`*;o2c{R)8ISyVrYNI
z-KnwZGQ!vqd%>UCk3t7J?oUljk8e`Wi+jO!_EM<1V^oT2hMK}I5RCw#G((P#F)5lE
zI7M9$8v$Y`hT1xkQ}i>;6mx-i1|U{msG~!hVw_>4lndfB0Kw5hJsr9f(+rxz-Y1>~
z2!<7McNkJEGkg^FzW6La^rO&`j*=AX3>ne$2s=Qu8<Z(nmSUd~r<C_aJGjYSL58Zz
z6vqtpX6ysvIe>5$Ar5sJ?iu)I>I3mPfcOQWQyn!a+zj((<^y6MKza3{GaYp)ff=^V
z$_L^;fC9>q<FY<Qm_cvGE)vfJ6i6KkbTp(yXZSW#7sclRN+3pD-^P^K3>iWDi2VR1
z&W0{_G^HeF#5XG!#r@z8dmTA_T2fTS>MhuZL=(8nevd{z&J;~CzJ>ZwYyv1lFcj%%
zcBSZx&0Clci5CD0jSF4w7)&u1+qNhliZ1|^5*E6GWRIp|dJFau@ghK}P@!nYP>QA4
zw}tvhd=a1+pwLyc%(oWH2o^{j04VkaWh!1su@}d;C?AOj0Lu9YUGEr9aTKe!VjmMP
z0hH?yilHvcU5sy~J{DgB$jBeM*)fvB6`Qv*9}_PFWZVwj?zol`D7I}?J{DgF$f+B;
z({Tf>9_X#uCE^u;oSC6S$E}oTv2QDNNqhw$D_-bc$K8}zv5XjnL^D9vtI&gv`zeXy
z_*UhT*bI=@CiJjllvY)uuE&On7BGr?B&_Njqt%q)_0+J~0v_R1;nAJRT78MRo*5<%
zg5PnEhR1elwZ;-#y)rBw1V}9#PU_TYO(k?a_6hMSK<db_rqiIcl=$kYPsCRNlEZ~l
zI!m<H5*eWp2?s#(Clo1JrnQ&E>y=ML2S9R{a8_rf)={F~hJ8xB29UlXtVd0zy9D1x
zeJZ{N&^|j{&{?D9O3d4sPl-bSEil7HopstkiEW$msdxyWg;lt?vtBEd(AzM9Xa#6P
z5jJ)<Xrm>*ZImFk0yL2hmv%O4V<j>oG7@b7jUdD2olV+ANqn0kh;0CkoWd2IEn3w~
z^>!>sI02e5giW1Jt!5^^oeGLhfO<-l&*9SQXPUP&L82X?CL&zbIjA+xv~5>{Vmm-Z
zW4OBWq}DW(-j0O`8lWm6Z0Q`*T4wsTQz4NC=vD~VB5j9tri?(4L<c~}07}%nptaA8
zZ&yNM2S8tYcx&gd)-h9U#ll1<&~h`wR@7s=XW~{WEOvra&KTa=IfDM&Y-Pek7f9pg
zgm-sd(*|bRtV&qy0_j|7cyH$otuT|eViBSnVBEa0z4MkfI@4#RB4Rhl;L5}MJMU^^
zGiAh|Bziz5w=jI5^S(AQGj3HPVh_mTD#Fd3qf%9~)K6d{;Q~5taoEv0CRH;Fe}WQ4
z7s%#J;kM4?RQ)XT6O2gof*fvHxT8~>YMf<zLJ`GYpyyVEdpdQgrdjk8m_+n}T#gL8
zI}NFpS-vMIN$dl8Tvhl;XGyAcmW;5Mgd5~@t5Be5S*m?j{0T)8-JpQ04xi|(Om)ms
z@4#fD9~ihbVGfNL+_Uf<lq~jxLe3IC)mf9u%`)#`WMTl|-1_jD&brjVEZYu676(8P
zSBo6l^{K)vdIxryI1Hw78^eLlhScaR-wx`sco<CQHigf3Hm1gA$%wW|904=9&Ebok
zO{s}l@g2%#@dzm9wuUctwxp_z>L;<!h(S=oZ3_#X&CXPf5r2~UOdJF=IV;L*ai!{w
z<|moYh@)T@w<CPHb1>Ctv^}YOCLRSwZfE!kl1ZD4^pn`<#Oq)-w<{d&97?qqeNR%K
zi?4$@-0tvIr1h~HWkmTTj)A${9u%m0A=Pe-KdF2!9s{M^-thI#;Z%oFy%YO_U_cr7
zOgM%{EN&ydllnqrz&y?#zS%i~o)hy<<_qFDn9uDC-|oDY8Zg>+Dqo1lK{>ZSe5dmU
zT2<0Ju`9$IU;+0+IMI14HEQ(jq^^i>fQ8(F@V(BvsWGFxlet2i0E@Vn!w)*|rzVW?
zoyryQ1gPMe!w)-0rKx7C8?X`LB&g&LhE-i-(loR225Lk+2^MpX@aV4OH2rLI12aN+
zz!L6Icx;z8%{bfEpp1wfVB*@sNnN@$(`>o{`;uV6Qm#F$=`y5QX8RhbFGUtC<2u4A
zT_tJO*>VH(CBcE^To=ldElab{jyEV@iX2$M^@Ov!D$^XZ)w{5-2p$kzZ&;5eOzzqE
zF6t|h2PEeX7j)I6akI_4n6C&gFmnUpqOQ8Mz--$t<txz(s<<QJ;;#BMVK%)BixO{w
zmE6&=v8y31I@`C4ii&T7Rot;~X;))fY_^P0s>CU<nmZmY?`ld*%#QC;qT(q~&7BBW
zbhV_Z=BRDhABZ7P!+FA{E@zr%4sN6VAP#{w9Eak2Txt3_W*hSd;xt&xdBas*gK5S&
zHk<MX@iee-r^3};C(}%GXdCu5;REZq(_u^3P?}|q&qjSM`oMbbOt=<FzpQg)L~td}
zfDPPP6sLP3%|0h?Q@$3@fLiWccx%^inq!W7H}*&3El|gSuocbM+;i~V)E~vSz(y_*
z-q|&Rjt%o}=8wc#@HqEwcz4&ew7?wOZsm{SS+I#aAKu$_BTbk?@5ZhYZv%>ZKWy*1
zl@^`j+f7{+-v*nxi{brUchh2XWCV^S&Veo5N8tlq_tO${;=7fr;yJLDyA*Ej8kMe^
zt9}Z*M)*NJ_et2%H6~p%7k`SnCi=lPP6)SkC8z7>nxA5>5dduGLg9`sZMt!;?J4D&
z2!NG~gnPPl>882#Q`k2I1W#~M*xhAFx6JiDMSUYeu!FlCKGIc^Zk;P5UM&#-Pja85
zG~u#z``q|b$~R&F?BuQ>2X|$<W3GA+_9x;U(7=5e=FoW2Js00Y{YiWW?Bb%~Q(ZOb
z++6b>=1;`Cz{Y(YKGRi~9++#}qx?yH7wqP)qC|)KbYU*N2m6+I4?M+v6ApAWq(|ra
z_E6u7?}0tsx8d_$jp?zuGQ#8%=fTt5cj1d&P3eib@jc47;(4%_yB@yO)!dS<Dpfy?
zDZ~ZP$bBCcx}52nQv7L35ifvexEP9aa;57_%}+B5@jiH#`yqU}YcSndYI|By#P@-n
zyBWTMY!#+b`f2Pt;sfv;_hUHPHI!~C^*v2}Cw>6-aks-)krdEcDnHG9M_dHYb3dUp
z<qPTd()iQLcj85`pSu&j-Zh-=C{^#p{!Dxbnz*0CF*IIvm*RV=KZ_rN7q~?DX4eS1
zM$CJeKNBB;7r9@;x4W*T2TE;wl|PFgfdkyV@SUz3NZLT}#jX<{gO|8p!-=k2>CsZ(
zUh2B|F?gAK5Wd%SH$7G=?`5tNm%uCBZ{Y`B_tO)l@x97*@e*j}9)=%wjlxuA>PGAa
zF$`L`M<S~3F_@+dZ=`OB!{8vNij3|~#`I<8M&<_b33!!zG%~hZiy6yojmi!26X4)R
zN0PdAn5m3z#J(p!1+Q_BMKs+8%u?oSq`ntF1&6q?k(BNd%vvTlGT##dXywMEFzGVP
zUKVduz83}1#wA6vx+^h9nfe**FGLVHxrq@ynl8J`@MoyMh(XZKX(9#PH5gZBeunuA
z5dt(fB~sK~hXu-P&nSNpL!g68i4=F&V?r7I3>G88pp#3D7`q#=XqoRBDkg?O7ndF>
z?QX<kWinzQ6A{qOWkkxmo3KP#{23)CMnDgj6{+ZM!Bq3q&tiWiMBw7GBc^UArkRI7
zOZ`<8K`*CA>0T~OKhOLu^H)LweOz9os(TPK&a*wM{8f~In=6P^cb~*e^XO->9|#%r
zbA=I0_Yh{8=X;j=L6pG&R}`u3_G8w0GD0sCm%(9fI?B?%fZ6B8pH+SkFM}goab#=v
zFy@%2wqt)IJ_Cc?%!svH#N6|6JM}m5GjNnMMs{|OpsK=bXZ}Wf4qoTxM0R&y!vgbc
zcI9v4=inGu8rj=@0~6-acI+nc1z@;&5qtM7EIQ9;r*4X0fa6?wWPkTvEH+O@#Ao6P
zc!OIQInaF{OU#Sgm7C%faDuCdG<T26P|a6AhutDZz)5a##L+z_Lo*+Lj=Cj|01s!1
zv~?$E=;xcCV{Q>&0+w4A>FCyG80XubQ*Mc00*+e|>FL&GnC8>ZVLuXI0iGix?ruYd
zWxnq@>PPV_;N_|!N4iTgtn+0AnkJ&)O>Py65--cJ&yPQ+{3u4jDXuzlqPsG~F<-q8
zixYnUL)@AOhjt6@`S?C6F8%?W<}8s@-8C89eDgjgPJ9h~-1^9w?z)V?eA_-HE`ANp
zaJ47_ranWMPw&HS6MqD6aT_Cn?uLx$eBVCmw)jVImfI9L-`$uIn=d22HE|WZ&25fc
z>~3z#NX(D#Q*Mh_!8vYg<WhG_hN@isJob0u8t`-5B0{$_LsO1FPyJoI1^{P8X>YC!
zeYyF0=I_Ke0CGDbm%9fujODiHmA{MMfB?5Mas}D2Oy%_R*iXctz&qToNVIz>!&2^h
zp884r6L^=~9l45>!q##bakYtW!F${u6s3M4!(JYLUinG<7M$nyMy_`cXE@5$`>}rz
z3P7mwNDS>(+~xRw>K~#45cxB5vwH+pndbe>KZx%D0&zudcVEj0l-u?z{}8_eh>H=q
z(|sdDD5v*hcZfd&6jL2Zbl=K|mizWocf>yflo}bi*L^o5RxTr)H*p=H5U0q4?)w>u
z^7ww`j(8oQOohn9?opYl1?nd3E^z}4a|a`;o-vu41$Yy6SG)l};T)0CJ;|B+1?DE^
zF7Z7;0>H@F9&M&^fvrioD}E2qK0cDvqsufcpqsFtiN63e9*<~x44IY%z9#Bt@h<>%
ztC5tRl1%FY8BxTE7(kZ?N|G<jv@eJ^DL;!b5aD_vSv{4Rjs@x$uzwPN1tQlQ(WBLp
zdjb9e^-uAyK;qnyf}Wa8Zh`p)=AXn5K;{M_MLl(yfd#e~lz)mpfXm#GNO4bnrm%p1
z0ZR~n1D|n6BgUSF%;*B&3sge<8~B_%7Afs%%#1CN5xktZ3BKTtN6LGeG7}5pFDMD|
zCb+_#h*b2nWU3abU&Q`J+yWz<Ct~VxW@;AVFH-*!Z-Fm44u$`@GW841FEalkegt1}
z-bhu?V5V`Q?M3BZ;*TK8or+ZVoXj*Wq+i5-A>!Z<-06s=XDHLM(Dx$six>xAb7vy8
zNH}g?C?jS%aU1-RJBxz!FJ#&m#$Qx^5pRR5+_}isp5aW#LiGXc-^Aa+H4a3qXtU;C
zh##Q-E&d&R!v!Kcdqz;xVLrh8oA?R*iF-G)yXRVFV4>}R@^A4c@GW;fvbX0(rm&Dc
zfZZeh0Tk~2h`r}lW^|$N0Ci9N2l$S=7}?)*H#4?SMyPh;4)`<oQRG0+{mjI|_yOgf
zcn4hPE=8JqMrElMsb9kG6L-N4?vse4XH1r65&jZ&U%U&x=aB57Cpk;M$ovv>pZFR4
zg+nud9&MI!k?kerzW6hUagj(*k1or!h<*wCmG~$4D<?(VJ%%jHBHv5Yui`(!58UO*
zk)Dz)>mnHu;)w+K8~1tSSWj7&eNp@+<ySEQZgN*pWK3n2W0Cr0>_5c6z%A}e^vn=h
z?nU^^)PKZ(fgibO<Wx^h7PrX!GV>qe7ZB&Zj-2VK%L**Ay{!C4`~}?RuA;=K`Yd4)
z{WA7|_&4}F_e~_w(~uQi<a?QVApRTt#C;n%-_zWf6<Z`DGCgq*{Db>0a<Qi=E3qj4
zvhqN@2kvm!QMyS>ma0Pi3ie;(KDf($9}#+-S(*y`73#m@eeg3ELqD%8OJ8Arh50Y>
zEBGh(L*#PLV3x7M_KNaf@mG-GZbq&k+oq|4eg*rD_z(CO_hTg5Gn8ei@V!F)CjJNf
z!rhKsMMeT^h5QQh8}R`AoBIiI6fR`hE8?#xzljgPJ?>8Ade3l{qe9(`{g3!BxX=9@
ziJ`@+y8>^f{wMwy{K_RFH+x1<6KZZ|{zv=<{=@wex!rRuD^Ou;R{kgc1|D$tB6oUj
zWC;~?Gxm`9ANVi#Yb4QgD=S*zYo;EG{{z2q4<h$^?q<a*<Ywj}@eurv`z`XI=YCeA
zBHpY#6d!_z+{4Jjo>4kgrMd+hMUH}_cofg!8l%%x;w{uDX%u{fM>!d;WSzd!+`^0^
zAA!H)QDB8jt20*GT9i@JBT&Vo<Or8eXR4%Iut&(>!Qb;J!og+GSt@-k)FaaG;G;as
zQgD^%td(*L^9ZSe|Hq?H16P^OUKwvu9+6aVG>^gsT$MUUrTQTDJM#B%43Av?Xs_(9
z#1B%xlYS2$<B{FoRioo7%?Fv^k&i+(k9_a0I$faBc2N19^e7z5BLljtUME!22Qd}-
ze{dX+oZzkoU9{47kWxwi2gmcslI?2L#VX~4jEWo$C-BG{?P}5`D&q$gl{6YA@yMg>
zYSF0{t6#-_PmY1fJTeQroI1^7{8j4r(ik|AN3LC$OQ&CKewFz>`52tUBm1mtP-k3h
zdsX?p^cd9e$j9nBsWUC6U&S6J)o?P845h9ion^7_Rq9bm4X5zP*@=85*2VIx%%kL3
zIF&~hOV<UReR2F%<xy!YOyQB$(KW1dELJ<P|0BmiEss2hXszyEj610Rlg7bR9-04K
zBWNaJb};`(j)!SHa^bnI=>m&w4(0!(@i3i7b~x7!ov@g8V57+i5aW?A&2>u`UF>sE
zqooNjgGUB2*Iiv~vFu<*lSwd>M@}u*eO+R4+@Xw?l3*5(98<1Q*{UV#*RU~UGSu<N
zy5t&@tyzM<Mvak@VK$FEM6Tp){SxzQ%ouVa%;Axl$ED3SF0s9)jFBcnJ&#;9E?u^1
z3H=)O7&!^%^2pxeGGtqp_+FzPlP1AD9{EgMCE3;`@@vdvqz2~m$nfDR%eF6xzotAU
zX<z}5j2EuTY{wGyAxuq9h6WxvAdsrSy#zl*sin!VkVjSoS4}pz#C(WRlT#qhBTs;<
zE<3Qqc1Tf6Q(zH~#QCoJY+(s~2pdaIh0}PXl6N&XWJj0y4pC#Jsc<@v^y;q0?AQ|d
z5Hprcfirj{9CtNkCziwyDPyG+Sj-~<x2q*vWm30d<47$m;gOQs<;>QY@K$P^q=hqi
zBx!cJvh^l&D>IHvg|m31Ep`oN8%?%WWt@}>jXV<hBAd6#M7Lt&$uu~dM`~NwP`1V7
zYo*3ZX>bmYWUt6)WHrgH%y=>#&gGH()O8`-Zi=@m<E3<1$|D`9YdG6sQnz6fNDP+o
zNRWwC6>byWMoo|~IFColNY@COQJLGA31kMG&m)PV>sofeWNT9<NExu4M_NJGjcmb0
zw_!<SCS1TH(Vpv8cGTo+qmradxR6KcIoI9nm`QG9lE^H$h({_m*Zu5-Dc+_eNm;Oh
zM{+XPs2tT&wG&Gwb+D30x~|?aIhv)olS-C!a50YrR=vqN`lV(klT2pAB|K6(^=fmB
zOKnaiS;~ec9!ZXRbvdS`v=f_1=D?*q+DG>qax6=IPHLi*1DEk=JltE7V_hmcnTezx
zF6U9V)?1ciUmABR6D2)d!K1^ow=&1ERNanEB6A_ZBY6lCmAIGU?bIYG7m_^EY4q0Q
za7)eY%p@`ont3Fc=&j2MEVZ>OlcYRY#UtfHZ+(uily1i~WIkNUBMCuoLr!$5ubt9J
z`EV7FcKN-HIkBa3JEI{B;A$T2)O(w95=-Olibg7c)jV2m_qODymZ@oMGHHM{JlZn%
zI&(D3aGIJd8Q>Zot$TZ2Ir?R0nwd-%!nHiwyY>#|7?;^-WwKNVEj(I)_MXf!Eu(2{
z3W>vYJlaI|4&_*u`Dkj2gv0ebS_vZCnRS^=GgHVSxPeEjx!wyo_GNKenIaXzS|07l
zdWUly%hVm%RB{@u<I%DTX=>cd@D6IKG!1U#(blMU1dS}s9n4g6I((c*>zm$dIe}%i
z4rQt|9d6>$9;Nq2j<AgGz*5K=kmAuoqxV)$beXS%N|9#3%{<yH^xn;hEt5N#6tWm@
z;n9S@_kK=dS-e9@k&59~9*x?2N9k3|)t#7@EP?erntAt*(QB6Dos?E8f!laAeC|!w
z>zA8587(;zZs*YyxL2z;F1K|mT4^S<@@O2}tJ9m7)16o<ISW3)qq%6WL2p^^>!ebp
zS#SrB29&)edh2qzlSw6w@JSvG3VX}+_T}+TB~>!QojjV@^;YT~%hg?28aW#_@Mv^~
zBt`D!co&r>&4#;pG{fqx(R0hqT}&D|2ikZvOzN%E2bSBqlr(7$+|8q@PH%I)URX|d
zVd>;t_!N)kE4>Z+=yG2dl`hSNdw4YH=xx-;mdjmCI#~*z=Fz~Rw@IH^9`91prBb+;
zN1cCfi(a)t-Hl;n8EoWH3*PJ0YgXXh6eg9yXL!^L_qz1@73OXRBj>?qdDN8l4(g37
zY~2bb&4YFxb%(tt^`;ecH<m%phtKh-P3s-fTUPkGsSIg8+{dGK3E2>>E97n_gDi*7
z^Qdp>y`Z<Rh<7U)QaRkuqXwdPSnpV&?!hw21+a-nl{|W9+$-=NDpOhjU*J(m-8+It
z*ybK4lUxX2<WX(gdrco$Ve3&crG@YSkBZFR8+u^{-GgP3i{MK<s`h$s>7y%rJye#o
z2)@jts;l>|KDI*cVY0{y_zI88pWgfW#EN*2k|kBZW**fcy`yqfgxZDa$V%A4qk^Ds
zOs<B&U6f9$ga>(aGxsIu>It)p(UFVct30|Q`?R@6!sb$R(qib~(OuQ2%QX?S3(F>#
zz}I+mY4jO#EricSWlKxoAs!vxeI>b8LUu9PqzSh2=oIZM%e516my#`+U>lE)v%bn)
z2cho8a>%97$)j@xDazag-b>|3OJO^YUhuw}T#hjJGCAZjNb~4T>#NHR5Vl?=M_L9u
zc=X8k)#nNX-HYkT<*<`S&t6|cZj|u#QhI4Q?BdZg(ASt7BjjF2Pp*L7Jo+;FnsO6F
zyjRgnD_{?gek*+~xhhiKhvkw4bn)op^*M7jB;H5mN(AiX(ckNH<?2auACpUxu#eA^
zs`>_Vjijwl$(2ax<_o0izLU8olJ3LuNHgr`3nfe6P_Bja^-+0}84mD8QY~_&T1mN&
z$s?=aVSYNoXI;p(lkq+U{d4dLUo36y8_so*YB!cou7rd9Ov#D_b#4-OQ~A<Lc$7Cv
zJNrh^M#Jo8^2t^3b$*VtyYE_VfV8=ld}$Rt#+OQa`)=e4B<;ou$kmYH=SlXyTe(rv
z=cWpz)$ll9F75BTn;Ro#H&Z}X!#DVa(t*DFxd}4vR?trYPw*8|bKj^um08`78OR!V
zl3y%2`o`pG%y>U#kZPcZH%V=M$$5ISxt}qRYaq)nlREmec}BCXUol8)Ajhwedir#E
zCNtfS6_RTq&y$k7&yZ&^`}(OuX)W~fRnn2Zl02(f?q>=~3w)Dbh3H{rd3JNWUqQb-
zc#5x<PV`mgIn3$-3@6vYA%2a-Aw8knj1N$_v<{x;Ez+sJnmo>I9$;{CJ@oPGr89la
zb$J1^Z9u`L_3#W|iz006^8_<JfEAG&;9LAgDbUxD7d86^s3K_tJj-vA&i6Iu#mw>m
zQ$*InxB1P|#lEJzggHK-pf3%c<F`te`dac-RqDgoG_nr*`E8QW=giYo;fJYdQXK@m
z6(!BP^7K{a!^|{tBZT}8>2lv-p0UbySeYhmgaLl1bOpu8n5yW**mUx7_zu5IiuMiV
zS*m=8sp-<=@LhhlbQQUjtyS`2W;(eEzQ^y8zU{k^XRnGMR?xEo&+~hw>wUv{jw<yL
zYz9fe3;Z)u4CyJ|RrnEVhD5>ldAoG8Zv<_)%tx3R<YxE*zfZc|cP%eaWjmtGkT%1M
z{C??9-;F$>iavrBlUv}2{0mZ|?^a&4%6Eh+mbSo;_yf|tzPov`D)|UgOm2lA^Dj#e
z`tIi?s^Ui!^oYVse6#ehZ&bc&rFsx6A?x8Ve^64n$K-2P;)7I)R1ZJl9nxrba=w10
zd5|d~x4}>OL(*8cHs83?HmH<H+n~U=Nl9*9zG)>rh|MIo!yw--Y21c<%SzuMHB;IS
zLwtvn;x5Uzu9OFvnWPnl`7Q*HE6ca9j1Ma4&43ZUN6K<n<~vrZk7BdPC!ompN_r$G
zb+5#aQnREdpv1eS0(VV5x6*u+nMLk^GCv>{x$E)+D{V)WS<()8nLi>GyX*6XmGn`}
zNInTa<Bv*4cSC-3rSB+Zl%9m2^T(u8cVm8RrF@hzk~`rS{Bfz=-ISkL89%C^7ZP6K
zPe>K+mVDJJ_3PMdvH_0p9?9f(=4)2ruT!(72KXh<A@G1JU%$%yIy0Nx1;66GQk8o!
z-?+;5x-whZ1*7~asoH%q-?WN;9h*bi;2-$YlEpogZ&~Ggoth)r;Me>asTP^mt*hkM
znK|Tc_(%RMV&`4Rx37x7uAp-OUggh8TiwI?j#cVo*j(}{c#Q{=6{%_6tMFsgT<IzJ
z4Ihwpx<}B$(|nAXOYVVx;@_2ayRYR3R@sgzbEQ4-TmHPX*L@>jSVbShO3A08!oM%s
z-M8|it9-|(Qt4^<9e+{U@4lNKTO}W3O3A(O&-_Qy0r&m<#H#o)1sy-|I)6!Oc8@Ah
ztyVKw8QBPL@SjKy_m~3BYMi0Uq(=BXFGy|f<O2O_GsBdT&%nR%A*sWyEikUOF-n>A
z42<y+smHA=Fs-H;Y##Y6{3|a>ZnvSpvf9T`^Q33t5Bz26h`Xe~x>{zKd88fwjsF~>
z1Ir5RtK*D<PCa;&zk)(>D+?T})yJ{<<a6*A|0SA=5e4qm_;G5!^c?(=k4mT9%{2ww
zYV&bsKDiIZ`LCrj?z)1&YTI#TzO)bC<`HGyU0)!qrjKLg<n!?FJfe!b8w#SUeaESC
z>3R4Qk1*2i#)8;t`8ZQf?uY;25jNP}RFGI5KdzwD7T)0zC)V9kpsH5Cfh{1L;9VYZ
zLEX**O*Q@owLofuKl2C#>2?+9tIcmP3&<DXKY0ZHa}O36t8H&63#1odg1;$Uai1(O
zRnu=^3&|JZzj#FUat{?)s(o)z3#Av~FFZmyp%4RWwfqLNkURkY%_DS=`$B=eI{t=&
z4taQwN30h2aDk&*eF9rVz69^{h|PhDbayp=f?6cK1b^ibjKMvE7U1R+%p&q-_#YmH
z@4K%R1gdQ(ltt3Z@Bxp~*4;M>glhT(Rzbc3|I4FvZTGE$XtnPIRUy3sf8$Y{vioj9
ztXe+7RFKW^e>{rMb>A;YRL4&!=x%`zc@&rG9%WF~s83>*WD6YSeMDCEk1=R!@RL-f
z)B+#zs^roA$p(Fm`6N?G9)!R1J}Qsx*BXp9wv$SwbP%e%qvfQ2oxxN?pTriEufpGZ
zACoox27{%>camBxy$T=oqC}(q5`(oyKFKU59q|9WD8i<{%wVsHpH$G521k2QWJ!Oe
z!BM03U`xo?;27^jS&y{j?i$=fEs<V>k9kohL4S>bt1)|+CFCKf_97E{f1M#vWAi9W
zq(gA57nzRx>kUE;?ZHfBD;(!VF4O)7L$t={p-fUM9PdT0!v01>tVZ@QCbA7q@FE*o
zf0H3m6Za_SCWT2}WE<*lF{sw4S!^lkgvnmy6X|yvG;45{S}Hl=L@)9M^t%lDHD;Ds
zO18sEUL*wXA2b-(*jQz$)DAUXB>e3^X)vv!S!@|e!^vKx^z0upSl0MhYMDgCDPE-P
zLzx!VH8RUABRk+!FOqWgUohC$#90Mh;4sCDq&xk?2FDsThb<>Nq1HQ7wjwFLdkxM}
z%cV}3>P5Tx{t={yFmuduvJ0kp(K5FGnjx^p#wp9CE|~5`%eVd;24M}&VJpaPh<VYr
zrT>;8y2i&*E2M6i;YHK+{=0_Q8ku8OkUcQdi^i$__YH|PaZW*X1I+TG@mc?<Le*L|
zj}fE`>bz)P(m$q9vlizmLUO@uFY1r`lMD50%{)Vpy)eg%8lrw}p>eH^R|u&W>b<A{
z?$;HX*3vvil6^4Oiz=ReL!o7@kEckf59WE%4cA{%Xk9Dw3`x3Sz84*7{bhyrwQ*iS
z<q9nDqDQ#Dve2<s?ZwPwKQwsJXYOw%3f*gQFJ+ecVWHO|pX#qE<kp(KjF}vOxOcsL
zroXN*u-4{P%+dfX^46k={Q5#+E$zjs$ir}&ccUEWZzzne^?9i(=`ft`-6WsyZ!C<h
zmAy<Ac?8bzZk8|hHx(w<#=QzElVGuTt9+@yrBG#2zlp6R2VseKn=JG@3pEz}O=_hy
z2xoe&h*RS#)LYDNGAqfWaF%z6e7S$H&}gx}sjQTaLZf%5e5L<np~*tOiLD}EhqJxA
z<Y@m;p~d2RlUgOc4(E7x%U4mxiPa*%$*dxe!MWZ&h?{z$&~Aypsi5i%mU{Qf*ZYSH
z9TxQ|Y&FTiGVe2T3^^&>7W@>oT4LZluU)>`KZ5iz=2OgS@;IFD-6!Afzg8Hq*iI>{
zrQ@*NyI;Q3f1^;a(5J9!@(sAa`+}V4zf~Bu_)byP(i?E0_ket_|88Ln{c4$N@&sJu
zeOZ3cf4?wciJwwXQ3xx%&GN(kQMhWIdI+l_Pr^#?L0L602G^{^ho~CqBwXxu$fF06
zas4{;5K}{X;1cg4dF+4|H?Fe{DK(M@n!Igt(tr*(t)qvqH6#m{dfR2qfC0Cx^9@mJ
zBo;37cE~9MCAf8+JjARaIk?>0g|M+@xP4uGNI|tIT;c7Jvj!@0$2#?CY%R${!rLqB
zk&(o`4nIw;m3T;c-EzS|4bH7IpJvvQUTF3X$VCHncwn9Fw6a$6!Yc0(xp<%+7uM0I
zF$?)7T<JY38wVQj=sMqN$|Ai9S9y=gr2~z4Y@K|Xv5=?WYVUEme4q(Wtc#ykPzemH
zy(i>~ffih~UhTuykwdV?>yb?ZPF%Ad_fhMlA-KlNA#9Ng*RMDGn04f7xYp~Hs|E&f
z<9eG<Stp%_7Vjy!df+5(T2K41^`sB3^PZM114FoFz0XIjmwa%&_l#VNB5$ngWgoMi
zJOej)&mwB>1>C+q?o&|Z4QsvU<gEk4xMRKg47P!M3)XpoY(+jA_j>#cwLy9dZuAD^
zodY9CE@eK$Y#`6V$Gz{$y9ch}f%UdC$_D8y+~hqk?;W^-3+w4KSS|TBq`dFT_JLb?
zbiMBkRV%#>H+wJ2`v>mgG4!S}wd6Ut#ru(bVBkKUSRX&5pn4x}^<I*j2SydCHmKji
z>PSDV_kJQf2F4U=HsEhjb&?-$^9pj?Kys0OgZV9{js$SKHzaoqXp4*+Y;P%b5`b23
zMD7{T6`3~BZ($or2%qpuvU|W#WZB?*i`pnbxWju{J~B{JWZfXY#cU)4@Ja9I2pU{g
zWZw{fOF?Z0-08i7Quv!IiyRx&XR*i0cVL6}OSFe0irgFUv()3#J8+jbDxVstDdIMm
z&oYmb??RjRYx&GTT~T0z?X2>+^e)`(y^4?;^+m!4`Yg7Id=Eb5{YDN9G!#WQ_|8(B
zr1#(+@3->#fyScP2Kg+ri98RV_I@W{9B3*^Y>1y#P<sRSdauiu23m?#wd%Jqio5_D
zz2D2ifU`(bi@!}#(gpa8H-<1)t|EP{`E7<G--pk7e~>Q^3>Fz{ZEq`-^ggtEZ^~B&
zP8OMJ>9?`X<OlFM?~ihHV5rDa>wBBpEPVj?d2h>CQ3R5;R(_k=OkRY~dw)XE<O@ai
z+W6ZF>Z;&=?;ZL2z;KbHR(%fJLVgIFyg$n^G!=B$;^(L>(ueQ`Z$iE~FoNWB=5x#z
z@+0`7_ZRv0z_p@4t?it$MfwOH@ZOW}4BRLZYUy*>R`O%`lJ{3RF>tFWTI)MUZIwQT
zFMA)z_Xh43#n8#iY$Y$jSG>Q;4+icRC2Hg66x7VYX75A!;lQYAsyekFt0#wHi}#Vs
zs>5TZY3gu4RWA+0gI?9;(T9_#>FdmXrk?x+zUqDS^4P=LX~sI6U#XWqfe!EJ%SnfI
z(@b@=AKONL3SaX+c3E@SFwIiu^HbZTPvIf&*vl!0OQu=tWIwZw6kw}&JYq(dO|#d<
z{R-+KVVgJUa@OI>X^uKIz_yb?==4s!tVb>~cO4F>?NSi7do`B}4%bZM>db)IPKF@;
z{|udte~ah-$7`9X*v6J^>_`qfIXf&K+6r2VmZ0vt9QMm^KTI;Uc&K<PK}*pRwBo6R
zCT;JuY18{5advFEE>km8%Z&TZb23wtOf54NGqudr%>2IpfS0z(eP7r2`}w@z^y}Uc
zwF^d~1^Q27AMzL7`{{w+jM}1+o&}~)q&nhj_W}A%ud=pyWORY+6OE4l+I^57?9Hw%
z8JSohd_w7nOYTFo%$r+VHZrv!`AH0}uI|J15N}>><w(&&v0J*7xa_W>-}0(zt4B%}
zD%_f-{AKqMS`JpTnvwE_q?=kw@b07Z+up)j>qzB7y*sv)=iO#{n0IcieWYrk$t_(*
z2<~I_J6?4yH&VUO<<>0Y1^01!gm*p=v2+UsH?@rLx@+lCpv-O?X;_$a$Kb~7w$K^g
z#kK7tjSIy{x}5O2t#p=G2PHc5LIu(+=Y8%vTIpR;8-g??iKyj--(63S^RBAx7>O3@
zQEWNycQ?@4-gUK|BRvaENV<XuxG8#q*HGIvGP=-(G%NUk+eYVlOKZDFCg4R(tssK#
zMtZWhytZd#YGD$^;G*tsqVv2JwP~Y7?~Adtm<YM;^i;30Hhq-jeFfGO^C5RLt@2jY
z4j3hWpTtx#5q7uGGraq22aQs`ug9@sKJ0eT1>VE8Lr1CJH(}{YBI0hP39q?!_$c-J
zF05I}N8B`B=(W^lj?%p^U}_~1bu;uFFosv;j555R#4#8UxLJCxx2ZONl<|G>DXE_L
z#?8_1dL2+AG{3JnrP1@>xSh1x%ht{t<#?YwMd^tvZWsNY_eAZ2QRsdBshFO>;yyvo
z2L(^jD9`(*Q_@w$x9<PY3%#hecvSR#*D1{^{#*A)^dj%++LBR;_k~l`D&ng9zqHnS
zwzh0k>iy)Y7|bQyC+WrB^R<<uM2p0qN>>vd?vLpuUQccHD9Iwlr<&D#hx-#+2bQ~<
zQSwFPr_^fVn%hk;^LlHoqm+yEpT<`6*W8F+;SJW>N2wN>K9#N^zH?)Gr8ip3jZ!ai
zeX3c*f9F0$ukv06LYi)o@F}&1xbFUxUIWJTwo!&f$xmZ24soBR*LiQ$wvRF{5}%f?
zC1UP2dc8LR9ZK^e#c9o2KIT3{8@#t`Ly)c|Pg84&xcf7DllN|I$0)Q&e>%37kGs#(
zrQZ9soufR9OsA#mi0|E>(_6f$+OAR2MXuADb^Q14b9A})QEm6A1RTt$b;J$#7xZ@T
zliHq9sYS`tF_^-*&(js&XSHdgMH+FNw1nt%x6?blB1`&ciAK?;Dd9Wa7igomk7dAU
zxrS_`N{E~8FX=trewIO_l^T6ptc1Vm_Rv+{{+6MmRT@*9bUpEd`zv~%S7I4HTCH)l
zY1Z>UxG&QCy#p<oqjeggjapA6++WiNK^UJi+Mr3c#bEg3zC<7P4zc8qHfqFYq#KAI
z-IwVjUO7}q%^JlS%?AEQH&2_r!z}YgJ2d1OY6Ef0EzrlkBP<I>BaQw{Yy*GG?WHZ=
z3`@~ykH&OHY9M}c`{+8a(o#G+s&Sps82F#ue!9V%Z7CU@&<JNJ1996Opl#k<OWEj@
zCV3_XGbeYDZt~_?Do2a7;?JZTi7t1DZuY7y)uSa^#b=t0e3v^+J3x9^Gg_`CKchAh
zcia)0_7+;Kqm^3yXR(d^9e0#wy>l)0(JHO!GwCKG>Hdaxdes(gv|8)>OtXnky06eD
zyz>E=r_&0bQJaXn?r-Ujyo)StqYc{RXE7Lcxv$bEy^AgFqm5eeS?OltXLkqviB|^=
zTC-MhR<oJ^*?o;h-W8S*gssW5)MnzI`#buSca^1MG}7wN#y0c!+}G*T-gTDF(H^bo
zthAK)#T}#1cny}W(NV4ItfrLz#T}>5dP^<cqZ4pWr%H+Y?(gYy-f~ON=#(~jHU<+m
z_YL~Ix5AQ^A^Jf4xwMSvc6ZVjyhclUhU5dq=bAFU+kKPvc&jV}GUOkSpHpST1NRT~
zMelygpbX^)`p;u!`~!D_zT`b@8JeN`!1TFv3-PP_M;c}Vmf;!d4_u#Xw(!5YZ_!?_
z1;j8Jx(|fUsVzjx{S)o?Hdt~p3?C#vkHKWmeVYz~_a{HY_<{JGbSnW$bvg{epII5^
z4;1G#TX}Gb(@`&LnU~@CfILTSB|xf8U-6!>EXY6~=+DKr@?e#wuY$6xD8uuC>72Bj
z0IM>6&5JC>8PN}1=QQO!XoczP-qV(njKl}RIjWohuPz<;p0$)^q&`TVi@`wAeV@Jo
z4x7ph(PHrz(rpBYRq2~vkEJ?8vRLtjW*ZM?Q91#smYNLtV)6@W8v$xf`WF0n)(quh
z{TH!qJh&z4+uoqXo}pT7`a-&$0JkE2#~Zb98S2HZFErbEkPFgxy;lLCs9P+2L2W0%
zu1DYVUbnPm7#1hLh`}7w{fNHry<ut3FfJCKm+l}yuSP%cCSVO|UaUB;*};Qfj81uP
zTS5@NC(lzm2oP-1550FS9T{k`{(Ni)4~8lFk@vo(GsCmkbY5CPfMJP#>`hs^GNOxJ
z=QR~PD2C`K-ba@1j0D`<s0socJM>fU6H8A<YH{*>492JKXY@1gGfP^gs7Tx{tt8S=
z8q>=svZiNBiWKddN<IzsVnn_^)&ZIFBC?&TBzmFenBKmA)<K!dB7J+TlJA8?Odnr=
z>(ES9k*Qs}lXwn2&-C?4tiv<aMXq+uPX0O6o9X8pXwA&j6$$OsPC|rUU|#YKw&r9S
zijwUynA)N~On=`HYksD&NPI!Mi+CQTGq3pM&>uG!DK2Ps@z0~ajKnw0Ixo{vL|&kF
z5xtR^dEGa{x*!u3=`X}~@x4($W}q*_T9oN2GF^}w37{=AZ~Bzh;>>7~>w?C}18$fZ
z?8~;6WG0G)3zU%n-Yz5a<yy-!Q$@)OF&Gx3{>%_xp0zSlv_$-+bT^TX1~6~=RMzTD
z$r8nvn%#UldWDgL6SXE&zJ&ae+D-IDuQG4@3a!>m<r4juvE4i%Cz)ZsxmJ6oYKiGf
z=^g@@i_AMdwUx_MFL8aT*~0^LkQw2d4?IoX65&f~4*}FYW|VJ{wJp=IB>80wX4GgP
zli^!zZO=3=5qqS23Bax~Sw0=q=gmtL9?f1JxMPgcx565NE(YnL_7VWzV#fJaSvxY(
z61^w3mk00^lkHn)?acHnF?pm_1dx}Q2|k0hD>J&p<<V5}fF5FUeWlj!%miHHsVV~4
zJIrKXxwR)VwIu0@!Dt)}Ve)(x*0e0qhvKiK)dav-n5jOaH9br6q2en|H4pR=M&+xr
z4#<*!NPb0C6M)}fX88772W2Tg)PEJL<^ey!6!;EXhi0ihG<_xAM*x3;A$(?Q#qcck
zhpw+Q`*<J_FoiygH8V^1q3{*8kAMn3Gso9p&B-!+nEWaRBY8B8nd@t^=4Tl{6kn8@
z2<Tul@A@2o4={hIxTrDlP(o(ZKGr%f%kd$3kunj`!e!p`ov<#*LLcfc#!Ni4P?`Cl
z_$$itd}z8T-A_OblUe9P*5a(_hpvm7{XFy#nMJ<S){?Bmhr&f_KLJHNM(aCkEz3%M
zn7kN+O#sSZ7W>XyE3-s8@z>G=1T?XjB|eX}I!mHce62aaLlue9fg`sjORgiorVbF$
z#bK8DyjE+LQm6kqc7TU23bVo&wA!;&I@8zEg9MZ@n3cY$mCI7=TwiMr^3X<LR{5?1
zUsb0QzNQWm5XWcM_^w;qvJAT9*D+W?ploKH?}oKK%cv7yk{%);kIk(2C4in_)+sJ&
z4)G93W(>aD)=-v1M_!^15s=7bHu>&aJF<{Ye<^l|heRq<>br04%<||=m!yXYh-5Nb
zd?{;JR#fM@q&dt(CXp%kJ+gLZC19*W9VQ@@$87gKvG!!8bjeFG*n6Nnro#8knl?tX
zRD4-lLqIBv+36G2rH_#;Rb1B8@DNL4jJ`f~1IEagl9#C(0&+Rb9$&w@L1UCl^_OEc
zJmgZCDqsJ)p<`4_O_!xd2nc2{`+SnR;bYWGU6(aSct|EN`+WoJGRNqa3YV!P1gz$n
zgTBFaIb#e<lb2(#Zb1diVc(Ft{4vI*VqSWbfZZ%}#3u)Mgn6lg*Bs?xImwuP!|LXZ
zaV#Zy>L>xrIp(-;MBRchXsMo$9pzy=#aMh9bwy)5OHI7gOu%}Esq-o8ipNBkx_FJ5
zhy4W8;LENn8IxEl@RXT=`8;Fu<<^yrNi9wCG1&5;xlEHUudZ^8Xqi}$9wT5v%QX8`
zb=6}e%M^m<7!M;##sSLYnlbWaq(B`bU_{5zzQQ`|809j(5Ie@hjEZ4>bL;G5RLe|)
z^f&=S8pi2U*KuRi%UpuyI1f__=7euP;C6M(1c5qEz%8Bm$hWAjZH!@AQi#EF3C(9t
z`WDx<k1;M2d!@Am+|!s(d^%ufn3pNMnpz$%Dh%?is0)p8EF-;CEdd90=9F($UB?)-
zOz(}=@^DgRPW#r?b&l~YGkK*J0*-3T8K0r9YfN;R%d4^Qa8_Z?`bz7%$0T6NM_CAX
zS2O2)<#jz{Qp=Lw80@srV&=TBqApD-S}yiUtpq%+nF~H+UAj`TT;bDLd3ang9$!`6
z0Hu66>7%R!d|jD~zWsHBl*;9LU(CwG=asqSJ6u;WRH<5S@=5Cm_=_>T&s;ZLsb22#
zY3g|RFEd`Br7lycTQ2yhIzow-Gk#w~U5?VQJn4(UE)A_<f*=~qR~na#{nC13EGlNg
zkTjm9G%r{9HTC>hw33PX*t&U2$8yq7)f3~8p1I;XQMUm8F}*)l&yPc^n5&=!EmC@x
zoBYxSVmw;ST=Sv2Vr6u>%dctR$D=jOb>Hc_5@lk!;HMghY_yh%`_9&tDO1an{ur$A
z&^qRZ?|faQQnW%GkWxerDq(K=JayGd$qGe4L-9FiJ(B>1c8yZLf(%d;F#&C0Zuz`*
zR;6-<J`kh$3CO_Q_66(gO4SNeKx!i<qK(WQU$l->s#mxI8XG?mZDQ{Ft^$5pw?YU|
zHX;{oX72f}*R?4PE0Td2Yz|Q=bKiHPu3c$dAr49#iAku8dEiUbT~?Y`D1w?seiGWk
zq<pvQLeShJgH$6i8Es`A`tH_s!0%EYj5YF;Q91L-cfYPv=~-b4N}Gr&XdCm`m#XVh
zMpw9knkIe<+Ri-jJ*w+gCSdAIH4%Ae2lLeTq^?JqT9FLKU}1?Wm}kCcb!lTo#p00E
zPUNFXrk7t-pFUPntO#lBd_LOAi2Qx(2aJ^$lOf7ZOhvnx-u`~|gT^Y0^`V%ZpNfo3
zAAkS)p<`9WrjWFmn1*&Uef^U9;bYasu8^jgpN94@{rm&#Gso(Rg%H(DsL)>KCI8_1
zoUw-DWGDuEQdGtC_YbMhA8RZYhovpVbX3i};+F$C#$2ojYg+i}Xdff-538Ry)=^A`
zsTN`eGBL0FN7OHXkCHwdYvE_0{mejrMt#v(Pq8U1br3Vr0p?A=vc7n1wAdBaIQW_9
zAT!vXU0*UbQ7nWh2T_0yF*1K{ec9MlaWWi(^(;Ef4DsjHSB@2}6i1}3#4J?9yyaKb
zSC5sfR75nb{48{Yk%LjaW~_WA8KGJU0v%=E_7~P$$0}FqBe7PVKxSr`e{Q{ftZJnx
zBBcou9b?|{tLwS3>XojDhUQ6hoEhPt4>WGwN+CkgL?NnWM)?=jw~aNdOh#g`6-E{&
z!@sz`eXMb%I4Wg`*~rRd`E>x!F|SlaH4Hx+)iFx{iuw=~Imsx+5OYvHGtR%Nz5~8V
z`e=;d=b#2A+rO^9bF62jDJo@&e<O;S;5XEFjg78!MKvt{Z)9U~{iXHYV-v6hpjcuq
zYGfw+%j<i_rdB4SF<3^UCMM5cQJ*$Wq!)i9<%oI6&P??i>(j?c^onmZ96t{=Gb(>o
z{eW?DJ^2mA5$~cFW`=)%eZ`=0O1=J@7{|Yh987`#aQ)D6D!u6&sgw90)XETkbN%pf
zYQ5_ljg$W$L^FkcOMT`zonH8cauRC9FmwD3^*Q4V`s6n;Sb`&#nd@(=&mU*hi?2vs
z#Q!3WdDrg%aFAKAxT10K|BIZA+RxU{8|ToIS11?p9&$17`A^g@fG3ImO3cN-hfXl_
zK_Of;&Z9S7k)9y_5B-N(=tuR%<Dz=k70n6$|IkOwBLC_7l5q*WaD_TS%t!xawEna8
zW#dx%<dqog-qA^BvHyI1<v7tQ@wd|d5DU=9%o4w+zIvQwmEv2?fA|IH6GrF1R9`br
zzKZ;o`VX-XxtV2tZ@qP#a+Utu*njwi2r(=C!Fu~R)hg4s(vOJu5oT8UqxIZ4^(xo5
znveMR(J5w?|0>Ygb*qGLsgH<7=u>8m|9XAfIK!&sw=r1xqtnbf|Bd?gamH2RtJ41x
z8q~(D_a}gxWL~AXs`)RkL1!3)|8{){ioN7j>c4~*ea39^->vU}2dVyQ?7zGgon=b>
z_v<^yc~+UON>36WpwF2t{#1R}xaca^Rn1BM19Xll_dlxd9+!Zn5OtDRjJ{yD`=8YJ
zj7zObUX4N00G($l{Lkvs#*0>qJER{IMW~(G=@&JmkC&`gbZ9>2i_ite=<m}oV7z=a
z*+G3wEJ0r~d;I+x28~y))_24{=9eH3Q|0g9Fm$|XwW&k;3GpHNirMFvGz=fFUhV48
ze8PW-E;9T50~<2O>sAXL)F*@vea#&74{pdAZ&;n|h(W*sU1ARVhcx7mH?9_6le&qe
z=rVJ}F9&Rtd9~u2#?3E9JY)6`YnV6Qv6{R_xrt>+V2=AoG%SGki2hp4%`Zb<#^TRt
zC>rlsZMr5!#B$_g>io)v;_=bdu4@{^FGqf+!JpkwGCr|dxJDsj1qv`We{MtB_|)p;
zwHV|oP>^Zz=QUK07p)P0C&ffD3Ng)oRYUc7$r{CX8q61?FyrtSG}MfjuOYvqFtHLv
z7}{UhU>&bqqyH|3`IRWju>QFX_VKDUrthSu2tE3Sar)H_+<5gG*LRvzydGU)PWa~o
ztY5cA_>MY7tU}*1ANdzGw2e2cNq!fDI0w4Qob)elXdiD}Bfc*Elvs^Am{0sVpk|rZ
zD6VTh<yWI?4DzpN2tm)AyiR>etU=!~r~IoLI^Z>`zaIOPUxThQr~T_1I>&p~n667t
z6Khe7Ipa4pbd8U$ab4G(=GUS)bJkzl&^<l@J3{I-u?~IDob#7A^o&ofNnVeg=GUPc
z%z1xBLt3_ItvDuaBT7&wbHQ(HNY9q6Rm3!Hd<nYAc>Glj6$7&6YsnbZMyy9aFc<y%
z8wO=7*Xm=jHhw)yFqiy?8-`}9)|z6{GsFh;Bg6a64a2k5Yh5wT8GZx0#d!UehRkf;
zS|LWAAq?mz#_w-v$jLUWO~ztpcmul41i@^apKV+#j!QoyHli*j4ArJt+2*y1xaKo{
zBf7&x{cOX$Y{yzMPJKpfLP_R||3t$AI7aB>vCsHT=q_^=l;cI&p0%d9^enL%{mfkR
zqlV(_=vr4?bC%zX?lIT>ryEML6KjPyb(Sbazc6wC*@m+0)Y@b`c9t(i_n8}@?XAof
ztrLGQ{hTO6-ONqDr=dDqvQF{6=5xLbJzx@0<f+M)uOq*wJ}0)IUzuAl(6MGK*Xh5H
zea>$|Ddx66*kI3AtuuWuJx6RszcF|G(FQJCz0UQ$<{ZBjJ!J0suY$Zmw@&z;I!BbF
z-<f;<>kVz$hIPsBW9RsC^oY6dztPa1ZCoe5A^n2bhI*I>{zSv&Z1XzB4b2z)HuRWD
z`ENIbp!ZMSpuQlsqd%C3{<{qwaEj93h<(9tM^BhX{`(D`*`9T#8`AT{4)iDU*q>_X
z%8ssc-O!xpcc7=t6aS-z?(78YjH&ZP1^SD5>VMMElbu?Zyb(LkSD<IiGyk)Ov>Z{1
zxKr9rRH8JtS3pFi=SWHvotk#O67^z5fj-oL9C-=ZNwpI@(Q|C?KtF0wj<Q7G8EfZv
zA`#ms(4QKbqbf0VN-q$*(DQ8HfP@;Jqb_lEYA*1*P;a(hU?7#5qbm_QsSAV=y}-T{
z7)<5l7)p|zu?xHr^<n!5hEVxA#uD*O>6gTAl+L~qkOMQ$T%x$C`I6s_`m&P1Flt_o
zqlCOkeM#&=V)pgG2x<WwBK0?8U-ElUKXzasgDT4Ll$dTxJ;Yx0BKu}QNfqZrOI$ZK
z9)2%+i5(osrb==WCBjY0LsX%cSy>>LD$7ZgByYw%d==`?4hiH@l{upI;vb}65!Gk_
z`&K|jRp&_7D}K;?#aE+OSb3m;s>zYBCx4*6BKDzI*|!6Qlr=}WUjIYvD}Eo6u)_j#
zDSM7;z3B((MZ$z$W8Vp=DK1C7-t~j#B5y*kvm*lY!R4V_FZ@7VB=(~>*inH+R9lW=
zee#FcMSedT$Yul<Q|&p%_2Pu|YvKSJ#AXF_fXp+mS0prF^9RtItTM2I3IPU!Oi*7F
z2hrcyae-A-2b`hxiP+ctK{S}n4y>a(b3E%!3F#%`5R$SJ0tTupC%WF1&|KmVAsL$+
zD5bh{66=Kob%{8P{?1Mglv6!9srAW3>=J(%4Po;F6;#>;(FXC4(#u2*8p=)$7^#Z%
z36c$pA2pZx8uS*c3RF=8CdfCCKT?;8Bj_LOjKF?s&;;cM{g1KB{1GH)3j&9!p%YXa
zOg~C_;wbtjO9af+@CoV-t{*i#e-ypV76vR-<^<ga;YW%m%;;b2oInGWGr_PS`D2Xd
z&1e`qH_$}oPcUu}-;xT%F*KZgH{bwdpm~GhmPX)@p?6qyfTiY5aBLuNQ37!sDcJV{
zC#VH*htS`O3H)(1f}I~YNfk}-Y%txDdWl*zl3f@;RPlu92G=c(m#;;m*hPWURLO+I
z2H_UvB`jz(s|}o`$|j^XByYvMyai>jiv#DW$_XNa_$R54u%b+MNx(x@PmmZCKWTit
z6=kuyz$L0?g4{s<MEQt1G=^Ok@KV+ZN`wBVn2)bRN_IscNZBW-45pu?exe?YWmg8G
z6gNR_aQ&q5^Yv&PyDD%M)Gj)M@Dt@H8qj!lP2f7!Ho;&>{uJ}`4Jeyk7q~&SPcRz9
zx1|AsLOJaEKmv$~W`p9kCcsl@0&57|rb2)PA#YOw!iFZYn*w*K4!A<;Z^r_>4dt?>
zf%{bF1dqXVTN)%9(Ij?DAVqaeh#FkCH9@`+O=imjkErem34?H(3KC6d3cEe<gzA})
zG9+)uf_xLoV=DsBsI-Zqjp8n8h_Iu4c4t6jOP?s&sOZv!csrWP8UuZ7118Ehl3i4Y
zXhzf6J%N6<K@*i5^<A+L-;7jjRiM9Z=tR{<Q<pSMw4mwizJSCwe4=`zt4kB+ThI)4
ze_)_3bE0me&_#s_2b#$q3=FpAOf+mvcE!TH0~N4`14C^26O9|iccc-b70qIg1mwVr
zG;dVg(M0%GM6l+-Fx$L|j*a9UDnihRWRC|%*cQMIQhz5F;b~OJS^^oiqKTf3raRIo
z!Jye}T|j9oo*3Qex}%Bm44T6>1hQ=<6B8SSJ5-cl(Z5++AlFtlF|{#yCl=*dG?#4(
z<k>1GiZ+Rp(r*Y3&10JbDqHnL$tFco^9|3TcUecEz*aL+zKKjy-w;mpKP(+6v{@%A
zH|dkHZ+ItCvut3l%|21J$&{2{AzbKxS!Y0P<0h&%xssYIybHa@o(Rkb(~oYGkfg2<
zC(!?~9|acK+9nz{C6lo${0TIlJsDVRYoBP`B)%*CmiP}^z<v_Y0WQ<LNpV;6E&m_1
zkVSzNwh&Na$h*|H#7F3T_Ecb%tphI5`n$1j`H#>d_H<yKt#hJhlj*MXD)C>WVb25%
zwyufMO|H9|tNeeFmOUFNwRKNSY!dELSBaD81NK~?+}1NOwJCWwc9lPg7PIFA6}F1B
zT+wFn&(aR!V^qXm2pDbYxsuI_pEVu)$7l)b2~^nz<jOabKT{pVC+I`=Vqm{*P_A;b
z{^wW+{|VBumjZ`vLvvM|O+QPo5pJ}U<pXBh@Lcs~*Uy@3yc;cJy#b3YGgr4+_?fy!
zAhewI2O4ZSxrWWjpJUf}gjTS@K$9&$*SJ}HPx>8!Q862aF7>Qj^Jc|8&38OTE7@p(
zwav?QY$oqf-w~&fp1l${VOszL1pU3(cl;@|ioF^*X)DV0Y&PAKUMD_9tJ!M-WGl{%
zZg$<%T<1SUYuM|7)3%b_#Ae|hb)7hk*0S-ySzB3dYIE{l>^grMtz&Nl&f6+;MWy0j
zq%oomm9RGh9$R&;q*U>XCdRj+^=u+=$ySpqFC~AWV#FD=fxQ**+N`<CQvENn7=H#C
z*xP}i&7P|&HT@!u6Q7}t?43Z=#^tI@UB77J{AXwrdpB?u%ul*f;TI}SoJE`2dx7h=
zwp>GL@|RegKZ{D)`+*y__FQAB_`dXe;&W8SJ_saimvhafiu;=H`Onc7HWj#S3jsBV
zyia{koI_jLhk?7c4w#?l@5jF9&!KYmQQ*F<GuKmUx-Y#!e1W#Hj{_-NS8lY_bzgIX
z{{n4ip9CJ+x^oky!hPxnaUShpp9Y@TdU8{x$@{Sz{CQNtJ_|gvrA-o*iMyqpL_4Zv
zdj&;}>60X7if&CO-;Q>&qF|rK0h8oqWH;4GTtK_n-obv2gC;4<^xd&e{sJ<xeS-ZP
zhfY$JnYyJni7(M^wr^0<IDC@2%+;;A$$yFVu>FDq8#5>A%7kv}CgDMQ*_VQY8*?TZ
z%97o&o4f~AvHgQX8uKR^%ft_)KM-G`YW9_&9AL5LGQ|VU5ByhXA1etCYn(U9QAR$X
zejqL)6Z?8_MB@S&AL$>&e&7L4#|{i;G!{+rl$jn#69mAf*f)d9#^OoQGS>r5f(LjE
zJ2;r#STZS5COn`L1i&CzSunS;Y*MN$`5>0yq1??53Fb9cP7-Yq|0?~FfU+k0R#4Sg
zJxQ`f@vG)X9=cboJXp|JGfBRM{FVBVfG!35cCfI~I!U=j|7+|=9<tHwu;AQA`y|yC
z)34H71Y{lAcY^9hZjyS7>sQS!9<od9h~Rt>f$6pgzf!jd$Re<#f{Pm4CK<LQe~sPZ
zVYkR;1Q$29Pcm*1r=&j-uq$A*f;wR3nztxYnxA->{jtj6ipJ0+#}+b0{Y1cBo*frl
z)z|^kGkq%d6Ax!|Haobkv2&7Vizy|&O~AXBoe(rMc1?<Iaiui3dHC+Ixxv!L?n#L)
zLW;Ug1W_Y9IauCU(K9KvC7Fud=7Xq-%?nmErcD-Y75^sfB0|W{P7N9x(<e)|Dt^;+
z@gdaAs)ALG118J2lD|=1L>RTOGlKgY2TfLP)&Caj;={<n76cDB4xOypYWhujhlrq7
zmI#^~hfh{-b^WHf!$%O!76vVinUi%}h2N+<L=-XXoM1y^&Sb;Z<ZrP%d=#<l++b5<
z{$%4;@k42n_y%$8yFmxAg3VhM4>d{t8{}lwLAG(;WXD$WA(bSqAQ$^y@I>PRm>%jM
z#*+LMbb_59JlR+@*|XL3P<og67X61^2tRZ2<mgt{L(N_OTl5jTD0sTDWO8Dw@Q}Jo
zTt)w7wZXHEWs_4|lMiEe`K#z8yEu5hv2wDgT>QKAXQBgr%q|If8mlKu$`!wBe&##S
zC#)`bsj+6Vyqx@<`kA<f-0ZTTx6wLTS+4&*_A`GCA$CPD*l3@uDmVQuy+?e9FuO7s
zZR94a%U!=~?(yHDQ|zkXRS?7J%7x#ld&G70DZ3_ky|Hbwp*;C}>>hs|oo3esZ#1?~
zHkOMYNq-??sEu78OaLm`T&{Se`Gt?6Gpr$ayD>D`QBFRhej(!MGj>z(Zes@wPxX&t
zzwmK%mMsn5Z|t1xDK|Zm-Y33CpR-$nsm89!(Q?-#&3*oRbdD_#K5FcqoG2F_QTK@(
z=nHmx@JVCO<Wza`QS3f{1D$6pg3lV$riiwQd!*e&Cu(PR21QNjQzY9IJ(_O56J219
z!9Gm`rpULEJybVw6Mf0<3HECmG)1{h-xKTRZz2y{73|+Mbc$-5sYm*N_yK*z?h8tq
zhEGv%bM<H*@IRo7?Ec`urpzh2Z9)(AfJmUP*@MBsO*vBx+mb!82Ydnn${{$UDSwJ_
zoA|NxSK>zm&B~x0NYUnPipQE?`5zI_nuEid=1p;IBOg=061Nb<4ud0_7QpOS|2Xz5
ze+xkhAehlqG{v*c^jMlAenK#m4=S6Ar$o289&1wkPYCYF!R)4zDT!^uV=6`5M)1lC
z<~Eg0No`9$j-~k9D9APi^O`EBh_;LWkp4z=p%B{~R5evkk!)A|q4|yPLSfbsENH5k
zBHvE_LH$PDK@pY?7B*R@D7WkXi2cUjK~a_s&TX<!QEfN<A$>?B(KoC!sBYq>sJFZR
z&^+Xm=n8uxI3GNLy6wUr)I;Jf`j-7DxTvXZieY>5kJv;0F1pH|3@&bJpJLoDej@#y
z_!)Jup9FOP$~JFTJkk8l|BSA&D7d02G{v!<d_w(B+(X~7r-G}RI$(6Je-ithzlW}~
zr-SR7I;VKHo1RD?5x<}qdnRaT>Y5VW?s}qm#Q%cg?Ac&xQ$_cb#CG8c^@zBSzGu$`
z%bR+pq_!uY#2)eY(GB)|u%am~Pqah)r?iLYMxE@1ps^`EPqIVtr>2MRMmJecu&QZ5
zo_q)SC)GndKtHe-gZrBX<tcaQ|BUtU4^V==6g=ECG*7j|^r!SO@hkd~<%8y?;d$yE
zu0J)8`Crj3)*G}mW#;L22!B$Ki4^*Yg(*Q(PM%>$^3T{~K80?x!C+HUex7lM_^I>{
z;y2XAhJy|Og`0OMo@)N!e?xcJDE#&2<vDhcPpLnMhbYNj37%+L0ILK2)7T&ULv)wD
z8a&xll;_!DdMbTF{EmKRufZd-I4`=x^;GkO{~g_9uLn;zmE<LM2v4ae#3S?z8xNjs
zD$7glNIs1{;UA&<?2X|0rpi1~h4?S&pF|JpW^V>PP1Sjl3dLWVKlvW?fK33qq$W>Z
zLH<SkNjyfsvbTcXCTpIuLjPCnPyR7VvA5xevFE8OOn*tA5`UoI*gL^!6PKs1aQ&ru
z%Kw2LvUh`5!5gWo5dNZ`5>L?Y?7iUirnWpoMe?uMQ~n8h#NH3yXll<hR*0WT|04cG
zJ?w*EqUmy;xkB+w^B4aodd#MRx0^zFjtcS_^%wCJ{lPvA-filD&58b5>@WT)dcr;m
z-f!y6^Hi9gNuLpap+DKj!BkUMUbMpXO!JKY3q56@1RphZ=OrqHXVf#|8TyNT8hp~!
zlb5PUK8ro$pP^^$v*5F)w0u#eI8ByDrr|WMS4d<}&zDpx(zIzp8t%o3LVfH5^5vCe
znk|j&g`eYkhx*wE<tr=oY4J3n7Z!1SLjCPS^Hr6mG+8h5Is81=HzctS&sSHv(zLyV
z=WuVXUud8`GhbIJq}h6rBK!jPQfRO}C*M$+OpEstM7R&vKQzRipKq)b_mVwFK9AG6
zS3+{Y#G5M>y|m8>&*Q$FBs9!EFW*r~_Od-k_QqoF_0S0W0$3dBd&Qp<dgFfFz)*(0
zDBn|Q>LnAAFW?usH$zH$aelPY)k`Z9UcfJLgG1T&lKe!a(90$w`{0*3St!?DmY=Fj
z_KJ&yKDa+OB$Q{b%optxKPP*hOveMbw?Zm=b-rY$;yLZ}LOOnhlZOiIHTm+L<a4&?
z$-eki?(I;a-I}l5sedm1ywDd*xM88Wc6+{Rr|CIaZ&Hk3<K79W?OeWkr|UUwZ$XS-
z=SGC)gGN-hQ+UqSo9u_*;6{ZO+1v6BJCo1Fdkg*WKrSP+*xsIR+$k2xULaq@gSf1a
z4k-ENoeGim1>r^fCZ`Oou!r&;J4uo41@a~QH*Q>LmAwP@W_nTl1>q$;n9B~Wvv=lu
zcA7-8KIF?-%1sCv>=j-4(VZ@lwvX^KmT|eEQhRrPVy7Uo^&$J?zjKpA<@TQZ)Xt<R
z-bd(<hj4kJ3VYgA(Jt}xvUG9)9?DG(8SUv)CA$>QYtw}R_$^Kqs<IE5D&IvuZ%Zd%
z!T;c9g!bD9O;zsFKOavQUcqv%AavM1bgF8X>3LaS@>Tp#jtH6U!>6iuxt`bd6<)<}
zbA=&`J#(sVm+-u;FDb$Q;^u@J>^V~nyOPhx`w9{~jGG&3vgc1V?h^NwiOJXSaPHlZ
z11tgNU5egXvG5vxhf{}G`@E@+U1V>Yn0y^8xc5RQ><eITsP7#Y3$No5-2Bi<d(l+S
zE>mw=Kk^Mcl3NHzs^Y29U9R5Re!?4g6t^gJ+Fmj>u}kP}1FbzC&1pkt?PXI_yOO=*
z{e*!ygIgRrZ?BvxGKyc2fo~pXa!W!Ud-YU_QSpKn<ncI*(}gbCYo^ML<O?=1!Q(O9
zvXIwqovJkIUx<U&9V@vNp`hJ9Rb@22AOlA`9?Pu^MeW>FwbAv07KH0~9JeZT6|}NC
zqws<a?CE$sw<dJm-Zs@>Oui6*Nf?Z?xpko%_V%epqqvXkWm1ZBxb>j~ND|COMIY_U
zf)r2S458ch&{T(!>|+DtIG)ID3f;ALz}i&bCl2~>oXeGl?%O-3dW@z%GH`+8N!*rD
z%HB0KYIOC{g4i2R=E_5l?A=onMxl=lB;9xlw>|X4-ZM32O!kTQ7lz<Gt|Iizo;FRi
zTbwQfeKyYLc7{aF>C+^;73o@VVdJTsG1RAdz%==8GTjDZYdnnu;b!xoY0BOD^f*|m
zv5Eu#RrAnks@<k^87QambPjYB&BLduce~QH;E%>LIG{r}XHL`Y7Se4XgT^yCfHgMf
zOf&3GrpI3q<hXzXc2aZxG~;e@Um0kc@hlEd2H=P=?^g8Hf^!)Y95f4?=S_3$Ci~hz
zpo~clg8t15U~8=J8wVRQF61D0*IYEsv)j~H25MtGn}aoYbMdt3ZdYF|c#82H4yMx0
zCDRhSg}yd$4&#4wa7k<~o0i(0>>HN|!|+@Vp4rWn(?om3Vj0+g@jR|Mq-w67CfTD9
zYeDUc-{l;kg65iO@;#*32A*F0KO7w@Y_?8Q?$L|mAl=1kjt$Liwog;-F^Oeh(8d4D
zIYa7ZZkl?JORNPQE`E<Y5t<K{Vci}<Yy-C~{y*-c(4ywHX@)&Xar|{*1fI{G3@vVM
zpJv=6?k5B5EMCBU64HSp!@Nh)PYViJypTho70sb(jy+^Q8~9-H``oF}s^$(@n(O<;
zLGFqdai>G;nkzb|dG?t4$w1YLHQbqyp}A{XbdRf_7QCxi%bg9CHg``;>=F9ez@dsi
z;Le50n|r3E_9Xko2MQT@F?T*x(VV6d?G?W$1G_0M;x2@Y&FL!1Ud4-AP?h2(oF`P(
zJU}JiOTK6W?<oF|yBONvJV>S7tA8;L5>c$<E`<&^4^^r5nqHKF5fm@w_>j4IxJtd(
z^`aK^o_HDO4OyBqRl2>xi#Bj|;^mw_)X<!xGVD#h7=Kex;uTyl)YP1>GVT?>Bm;{k
zF6P1^2Pi_!dlfHfL5Yc1a#1)g&Qm$|k}ui7Z;AEXmC%Xi1rQq0zZ3^qC0@l{4V`Q*
zQhD~8UXp=%60hd2!4<4n72WH4NedcDyoS3TI^A5NO6(P0vVjs3ujS&Qv(06y)ZXMv
z@xekiUdP=Coo}vGiK@ge%RttMOSqdMPjj_OQl)rV3+6?<o=b!-HP@)*RpiSy&?w>!
z+^vwe*{V`j>0ge66A>G@+o52yU8Slry(|O4A>PQ{2}PSZmAcCHvKDNGcoTOwbQP@A
zx+>vi8>k2IX6|0-dUKn~P?dZ+E)#NbDR)0~qq$vWtP=N^ffNvzaSuX?=F2K`m7>2E
z41ahFmkQm653i$&>~8~IAKuD64Bc(+fXsxxe;nL<xSV?wy5HQX@>H4n%Rr=uw{ed{
zspc+Kw93_A3sOA1oqG~`)ZDE~R0;iUV7S9OxTm2f%{{7ARkDA4h>(XXxM!hf&1us`
z)#3p%aL?gNu2)#pl0IEhtr(yMksRL1iNbwa227V%lLKsEg~PkJ-r;^NgQhF1^#kId
zc*91nPq=@}(CMmb(*POx+AxU5!;+Ta)790k0a}o+VGsw02exER*HsGxY+zEuAOZ~!
zZpoQ$s7?-uza^+Ji2cGtTJonGtHrO#z;TAFxmUt+5X6|P6|ZPPScdm;lJKyWdD9)$
z<SRC?k74j=gh#Y2fXImcl{l!xFmUn187)QAJ=LaHWZ(tEz_|`9TZ*Sgt6i^X!SRKG
zTN}=9DVd(A7GAM|unPl+GMw8|Ha%6Hd?hXy3NUcx!g(!~(?$ElugXBBg@F?lR<%@5
zm+Vu#ss%3=2JTC^prvNId>{F$4J20>I1b^$7VC87KK-k4FjiscWryds*r%)ZnO>EF
zehNd+GOTXlrmOe4Ue$t23PW!yJRc<Fx_!c{HV{K$=s|=RwX{t)>`T5He_JTTkZTSv
zZfT!x+$WaEK-q*Lrx@0OAIH2;A<=?=2}ABEyrLyE-La39*g&R)Ax98i)l$&`kr}-t
z4r(L}i^1@^md@#(eI|(vJVzJ?{b55(*YxN<mqZKBA`FAOaA`~T^u#_vVgmsYhKqQ(
zyrpM)YF|<kA12JjaIg+nw4}`tnZ&QjKn;Z9MHx1>q|cC;6t8K)^Mm1oAFgT{Fhg!4
zU$cR<2e)uD!uwkW%}|>3uf@T@gB@H!_;Ab687h<MH5ur1a4ScI%`L-cs7<cdwBW|U
zG*=k5v}DfEnS|GDAiBW}Hz(ZCk~70#O1>6<M^Iyyn;ULw$)8~~iC>q2f(CQkyI}|T
zfy^ew>ss*1U?-;zvn}&xI85a0Hju+$7x!NHM9YF1$fSQg4yG4;f}0;c*-|vaV=}!i
z18ocb54R9THpMfdCfDm)P_W>SxJBX9EhRG&CgF7(_*C$JIc@lCOWBN+DfxPQgfJhU
z<Q9j|w^Ys$?H9ix1Jeoqm|GI|v{cWK>{q;@1#JobgwusDwbaaz?<e1|frA9Qxn*H*
zi*<%_zy6Il2t_dBR)m8s_8F@ErZ;3@2f>(I8IHoQO}*dsh89#G_!PG)d=;ehy8Xf%
zHt=@fPq{VW>n&|F4EvLB#77B>@M&&c_(n_n4C8+BK-p+ggWI_E;RNWB%=;AswV=nq
zXE;Onc1vi6V?R022CfVI8Mi5Xx1|FDQ~H5%5Le){Txs}zOXm#Fe$zl1NGR~<+?H^v
zrE5lXziXftj1u@9R~~-U(mf-wUl?cuJp}%O+a7+>(laBqKRGa-AuPt{xr*?!mb96o
z1L8q45I5j<Zf98JNS`S=pcteD3j@Bu8N+=X17^w(kb`WXRKQ<yd&2!3gJvoZ=m*8Y
zkAOW~Rk*)n=uFiC(;ykh4)9mpzOckGe5U$<YmgSq1^6PjKRnQpIa7B)7-Rzt0sfjh
z7#{4%nQ1tX92CzIbodf?I6TCWKht<X{H6>90r)a^BrFFzl=*<-O)b#=G0&O9!yNNw
zIu4L;+5p{;1@3rwgku5Z#q@8+fy0lzoF$y$D4OXxV0u#qOnvO*>cUD#@yzG}*PB`Z
z<YPbA5YBd#%uE~*-n0Sj9tSvEIM-1&Gj$;OW?U((z(KAload;VDLN?rn+!PgIK(xF
zRgUVJl7ouBX#pya!<-{r;Ha4?KS=(~284JV;plLo!#Y!WQ2)0$;NEeRW5aVD_L-`K
zroYL?k$U_M=M1YI+)VXB*Wa`NV#imw6XE%ek7w!*3V*W!RULoJeH32gXq#y`nEYFO
zoUjUC<xYkdJKAR&4~hrNfOn2NxKF}5kYkw-Dh6u-UXHJED7?Z^5t`{ZNDj6EiX4B(
zoeHmVbU<ECKR6CtaeSRS9bV_?oas4e8Y}}wIF4~=!Ujjz%;-VaU@ZW@ahy9FE_HOz
zOdJ#j+koDUzvs?{%N;#4QwNiS<JrPGe1kh5u5hFkhz^ORGT>_CPVPe3=twV+98yTN
z0LjKTIZwFCF`z(xh?LrZc#VJHE{69z1{Ej|>7{YNSK|bCDSX&5v_N&pB$WY+8vn@g
zVY6d+f%=e3ss*q#zQuXN7Dr}*?vNn00VNv$#QDPwj+_F+p`<iEK``LkTrk|^$S*J+
z63b-3Z^m6*IP3s9nE8-GrUe)?zQaXfJ~gkvafp=JfUJy@+?DVN#{!58>Sb}jB;&i>
z)$mD2QGw@>NhSm2G5(pm1|#0$g6JWaObh&Ce2=>xKJ6$eNE{MmHh>Z1U$}VqtfQ<T
zbtox|=L)6xK6fL0-ceZ~IxPOX3^2jCo4XnIII0UIhZTR<0`nI?;1YmqttpTnCjV{&
zfG_@)yA}32tOd%$`oG74#*0(jZJ6KK3si?qf0qGT7yriH2}j{Et3K@dyB0XP_#t;U
zeAV%Bf$p&IcN;)&@$cNd@O4L9f#GoS@A1h(Iex_558rUK7Z?wVhsXd&i+i{S;e_LI
zf%&jvh!)tg_%W9X--gq&<1jhI2B28{2lp_1*U<rKN&S#GKwt3_?os%@qqD$s*fc~2
z1Xuhg_c)w#bQMGoyM|~1$BLhFPr{EJ-35um!Vnv<Rq<ck)9@2VPeJN%a!5Q+sKC#-
zXW?g#v{|AW@lY91PjQ;FS47mBK1))g7^($?DemPIMf$W3m?f_vhuVNgil1}#j`V9C
zG)q~d9~uX^C>A;UMEbW5ou#TV4V3{Y6hH6m8<DgQpQWyG4b=kn6ZdxZiwtbdoTaM~
zhT4GPiC=KO6dBx_Gs{qu92%c07;ztG|HzQm{8`2t@mn&WYvOe0D-k)U;mkFPx3qxD
z#C@HT$gtLVvm7<#TQ=ZcVzKk}$cWYj5Ej+H6$geT?&lmB$!IN_<*6~fB?BNOe$n}6
zMA=$AD_Y}vOAB;K{E~BUB)hd_R-#6D%Lb@O{IXLP$!#s0m8wa;6;}yWxW98qB(Jq{
zmgtE1A2NVA;sMULBC6KvS&}1)e`tZoh+lEaBL%HBv*bs}f7k%8h+lQS9Vu+J&Qc!H
z|052pL@aR*i_C4c&r%&R{X;f`G~w5r??lwC+${AG*FUsCF~qMsM?~hgemqNeMEHjd
zkc9XR=cve{*0x!OBgucnX9)Z8Kxal|aclc5;}Nl32CzUp$e9(<wN_l7Wj>;iYXSX-
z-*hS?D_TRd97jmG4LE-IZ_aU%RjnNmmetGSz~sY&o!OCft(~(xM@(`V0QRudIU!<b
z?V1%m;*x8DmWO4|+(>C__pHPbL2d)|9sav>a-_VqXIAP+QXVf54&x!tyhufB8X-C=
z{-+F}ba<$9YQ)%@PDqX_{;37R9Dd8Gid3}@Amm5Mf7$>ShyUT65!v55h)^EY|1%Ek
zH!OD+L=LwOB~(XE|C9m94gb?gM9i(j3H4FeKea$*!*4qaBbL@oLU&a7rwtHm_+QRB
zk%rbB!f-VC&p08N@i6DyNK<P*VLU2+TL$nmJly$i!~teN^HIgyS|FL>cbw`7+d7YM
z93|hj0hSCaobN?Wv@U?Gu>S2hAja?r=lsaY)*`}l)bzFtcwu;?b0MsRiizk^*V|fv
zf8kNiMUm63B}C$=@U{&|UU;-q8#&urMx>4=-;Ngw7M$T+968@wNr=qif60Kcg)^N?
zBA(W2LSk0@OAEj(oaNL-F16MWax?ia8_=)t80WHxx7A80&H8`E0cC}i&J~ehtDR7p
zP5+VsmkN({u8c(CSf)0+{-p)T6dvbX6}j5_F`+XH|FQuw3XgZLiCk}OBMj!`zv6R*
z2Au6&7rD{eP8iMNVX}Xd6wYz3k0d~hXf`W`X#vcHCpZm}+pQtOVJ3&!0J4N9IyXh`
zwst^NT0blf#3Y>SEREc6?Ib*A(=Zv}kMJbtmPo3#i-?+C!?eIM!jqllkw>lFM8Yf#
zvjLb0PjPOKJZbGAQs(5a_*|h0=Q%4P&sx(+(J}FG86bmjzH?_pM5mLIV~XKg;Q!#M
zPGh7GJ%E%SBZu1n=7Xm>_eA>9gGl8u{qQ)Dd9cb^73oh8B~`~v!)1Wk!PA}lA`*Hy
zsXpc!t_5Zep5fdd8AxZ6x?{p{8vt<dOy|MKU^<6197_(5zbiO!f%9-=2%S$FkBQ%r
z0h$KSavq7u=~<-tnBpBRaAq*!G)IQf^GL@r@*Nv6V=(DF9vML|fTXzooj3qsaG}!@
z$)Jl!&oR?GGN8HO+0MF%k}f8r$6W7d0nLKvI2$6_bP1U_CcI+<&I<mw(-z64%gEHR
z<U4V-z~Z^irbr%LNs5k(6*3^8;CasGh>ETzCC3#CE#OS>yG}=>fUY6s$4P|^*d+LW
zoOGm+wvx)@dPN*SBUtTZBXemxsXA^_$lfDe_<x<wh??d|^>LR%3kVSWp7TUxKK(JN
zJ1!_}!1KWW=lm$Lh;Abd$CHZqd%_7k-+3~!n679ijmO0!WPsYh3!I-sbl}A_A6Jaf
z0yhIMbfU-#Iz&2-lOt@vz`*Z2PeoSI9gvjQkB9@%0xxo&j;y0QNzZZ92pP~Ru*P{N
zVxYUo=yBHwEubc_)_FEkN_Ufq<H86Va3k;s&U2A+x`#|1PmYMs7f#~E&hwE9I;~Jt
zD;_BWq602+UWgd!^g>CkVx$)E40wst6RDyH6v}JKkv3p0;18V_Bm3z=h00p}$T)x#
zu+DiYa+n@ksH!!MlmP_+FLm+}Gd;XeUF#aD1*8F9=JZA^bY`KhRv2jmJ^^0t^hX-#
zoI*owa%6m=fba@uFw#Wl7aD8Dqhvr1z{SpR!~t4RbFE^O7BB#Kr85c(v3Z4#T5^;P
zD*agRyb?J<FMy(eepDR#`FNG{YUCtcROqQSjgmpx9<O#@gB5adVYJpYN(;?-yvBJw
za+)qFOw<aaY*2&8Yn}1PS-Pw+Rht|YUnHEy>zp?t=jqBqkwrXO1_gCo;=CF0(A9+!
zi(<4E+U9t@GZDE&*A&Vv<Y*gI$MFW|t%#Sl7Ah_J(Q)X3V}tW{BuLu}RTk4|8I-#5
zM(3SK6s~b<i)*wN8rpc1^KRrS{c)krB8;{{-5PIp-iutP+X@Yq<mk9oIEzc2_aisx
z_CljYoFRiEG%j;Kh$QICg=UK)Lkp#5yv3P{+=lU-!$M}*prMSnIv+;v(jCx~&}YP<
zZj8&Fk0ST!&O(pHlp%xeFy7{T97)k#g;9$uLkmS<yxsXE@`&y(Ojv{r8?<`y4(HRz
z6S}7`Wl3hl7YpZch4WeD8J#v;WEE%1pl^#SoxP$WCVjTVs>swrc^2<<ilTj(0kh>+
zGSdc4SiH;GJKB#KG+SxaXU3t{ijB@b(f-WP*($3kQwAMXyxZ9~Dq)7tR$E<}S}2_2
zJ<fj7flTIXomI%RL3<SMb-olG%;d~ASd*D?sDk1uXaDFBCV#fkD$bHYuM<~0Ux~^=
z3Tw71vb50A#QU7!{AK3Nc38<Q8x$_F$q5cmW&zYh^jUFePvZSfaPl!lvprT*mJF(p
z_<$1}TTJonsMVFFg<c~*=mcjDQ!+bY6|!tlQpAUx;J{$YW~Z#ltT;3d@nI)0?U~Bi
zqB`*y8Po@HjT0EvO!aI@onnj@x`6nI6PUA1&1`ucImQOXK77;(3`xd1TUn<c6Ni=_
zHamd{$Jl49>P%x~%SZtqbG{Q*Gu&)-ookF1`g8cW6PPW`$Fp^H!WbKr;c%@J7z|8B
z+iXK!a!eemZP?<3QZ>^)+gK-7%Alu)txhOOf)v+Wr%-C4bB61jP<moQvmJG$(gp=G
zT<?Su1JeOD8ND(NZ7|&6gitcmIonfbQp%v(g()Y544JOk(K?q>3q37tb3$l{>7Jda
z6O=Y6UExM2gaDYH*{QmuG7b$Y+~kC%9+NglR4*PYgE|zpJ7GxAq|cGmE5>S}+k~5)
zFmz)E%#qiVV{K4W!Yxj?L^FftDC_lO<Ip<74ksLnnW1x3^`@~hs1V^+C%ojC;d9jW
zuCZF^17X?;A6h1Jj;>x9YlCtRW}I`P4NT4)Lw#~=e5DY@taEO(iOHX1tQU{_e}>LI
zzNz~B<G9R$VGdm8z_BxMnFGVmfy<O4BE^W5bELQQ-k#plYuZXRDpk~0qf&!PH7eC|
zXd%!f=aT#P+d_dBB2vx~DCVAc1}<}8m;;wNaLn<0{@_1&(I)47zt8jeyr0iQz}QW|
z;VcT-U?;HkW6c9JjL-y}PJPHeTDaNvG5G)k^DqI{SsLO-D_}~<_<#(<EdkD19&(S?
zZw`KJd4PaPl>qOo1mvV`bLeCC0UE|m0)n$TG&b73IsLKt00T250hf~wO^o(z&VHPE
zK!$;kfZJIYnjG!htQb;0NWgSQz~gKP1xNcgtA;cW(lDwK@H!2llcNKh)kEZi49r~w
ze9q>OG&;ChJ7j!Nh9Qc8-`N^EJ36viH)MH`fQg7ez}X%Of$XCnVjrYoydi*`9iiB$
zXR~2Qe2{@zg#dPTg;JyAn@vNR2W1#M2#h(mgwBsnZ8i@nR}nBo5Eyqp6-vWOWb2S-
z6%7*sfrCy{=;G+iX4??CiUGVoaLD;==<;YBhNO(EWMK6J6V9!nE29@S2Zt=H2mtQ`
zhn>%dvZI&aqi0vqK+y+|IJbqajb7cH9uikEfW!xmI$sLi7`?tZJCs=^1K%E)boPdB
zj?T(g>{jLw0ILV4oUeow_Br{g-I^R4$n(H4r#Up+K0jZ*o6KPVBM%&Rz8;!uUzo4m
zZOoB@2@eFF+e7p0OY(KQEja`L-hoe?Z-!L%W%>HuYz_^ycHo3_M`(e4Wxipzn8N^i
z9r)Dwc4(13C*QO?lOqF19XRRS8Cq=5%{T8>t|owq4oo}W4XI%xv~{;;H4T7s;FQxE
zT52!Mx9uiZGe9c`MCS*g<@O4g5i_oq0X+^#&RwAu_WJzbZp&%{IO4!(&W}P`ds}{J
zH@lh!C^&H1ITTuD@6J!}7FRPs_y*26na~=0PkwfHX0;5sZs4qQIJC~*m#<)y4-vrL
z24<XlLppnZzKYR2L<2}0IOnv5HrfaB)eQL%15|9_bLW8&WgpDfGRB8wKwJYMr#)0)
zAIaA-mWPOE$xI;ZbcXbHN4}n6AEE(14Mdz=sNCM`$u}_KLkys#fv8gmRoln&O-$w?
z8Mx3u%;^r**{AZ&jB*VDjAtP3^o9(u5!=dW*3bZK1`<wxsMS7`Z)3<c4A7T>q!WcY
z?D2d*V_YKxN*PEw$3k1|7xIIQWeovbWZ(<u!H~&*DL=%pYiNKR1F~}>wAFq!Kh211
z7$6n{e|8=TZL?p`&oY@cGT?`S^UldouYFd5Vvq7+0$9Sp1?RDl**>R0wMX+X4Pap4
zOJ^{&-9EoSy@!050m?7%7w3u44*S9a?H=R9G9Y__wDV+Wr+rC*Zja?*0{FYYU!A8y
zR{OF7{T}vV8eqD>S57Ik%f7O}ut$8D0WvP|H|OclkUgisv?ueh447Nsq7z67dv1Yw
zk8&*m$Xei%6J!He2yWe@SxW<d7Wmp30s^P7z_y26%K%Ik$T%Y*&Rzi{g2uHnkYRz#
z&REE8uP+Ghv8*Kk^9uaknE*tstsu0AT}uPA75K)P3XR#j3(|YUwG04QfqyvV(1g9G
zAiF2CRtB0XaK(8(G->ZEPz);{ApngETy=gK3flV%RKuD_XyBXz-#XK<p=O{!Jxo5r
z0JIeNr}L|jWFIWh4jUhlfj|mmofiRF87a^WTOJ_*Ckp(_`8E9PjspEK`v?teP~bb~
z<xtG-DKHF+k1zoG1pe*(CX}*|7np`KkH`S+1g<%+gwETi3e3aGbp#MNf$Pq1LuvbT
zfpu83js~12@Vzq|x(I%tZJ1og02>qdkMq0GWqTYZB#rB209^t%oYz8E>=z1x!<Kaf
zP%DA|I=>HP?U&%FX4lbxpagz!-UwZ@UoA)vi|ZKRNdo_K{t&uhzh00X&a9IG4hh_J
z-VEKe&ni@mD02xQJ<u%nmaxJxr%*Mb$)y3?K)0}p@NCEYLiGrl%K(Fce#G7yp6ggx
zs2wrp$^cX#1v@)D&#|OXH)6>pfQ~>vW^W6t9LoyzBWx}Wr~|r{of}@@SXpQo5px;f
z7SK=F+rx_-IfbT?Os)(J0-DXv3omx$7Me$t>j?k~&>Z%Tuo~9ETSqkOX`lnpZLBK1
z)KOSy8zI*-VD%#<duMpLqXGs*jq7Fb?a^FzL3o9uzA!jqSx<lokABMD71lc13PU68
zdKw&cbUV8!yvosCm>v<=GhmOSpRq)EjiaY9JCa#1gV&Abv5Uj&9DRj~y~;-kFs{*j
z_U^FG(O;<At9g_L7aHBcs>2%{1BL3n<f9B&%IN3pJz>f*Sg74=d{hR17^&E$;R44<
zp>D6`QQ~z{iGIP}8`e8|9fkV6?4vYTx9CoGdAQu+DKzXAA7#LYMZaY43s*bF3r%}7
zkILYwq6O@VaGhhS(7acvBfua<3)%a_2FG-vb+1N8gWHMjVzuE`$4sGZFR5d|x<tQX
z9|(6i;xHg<)XCsOqDAbg@D|5~!r)$ujsQ~;{hD1JHaRX8hW4^L8XQ7Iuxr9w9ajs}
zdqo`sb|3l;yEeSdalJ6RH=~omyF-iFb>UvetRlre<zoaGacBv<K5TZ(DN^mzJVt}7
zhVEu{;q8w3Me2RzV+>ei=(p^K@D9hqBJDooV>0+%NX>2x?{q9F((SW6Mu2&Re#dSK
zTOG@a^!wPyXmFy?JuDU8<ycu{*e5>5fUSgn&u$J6IdY0j`!bKoU=g9EY(aR~ky~Wm
zr`$k*--DL1MPZvGugJPjvw;Tl2Hnf*!*)kuk!>HjfdMB5Y1q;*=cs`BVB-cEY!w7M
z=fiGCeNk|qWdi{o34*2TfV8$1h4!%<XfQkwY#k4eIl7C|`@{_lxEJUTEFGS3^b}?H
zWj4rQMIcx^9iDXb6)9}W#|iKi5bRwJ2Oa%IDx2nU8cYIoKWhk|bPN=!ZRFz&DE{b=
zY;#z03>Il^#>Zul?~#^m4WD(46zOc1#|hBl(Vy7%a0qNAy^VdG24Nk+?$L0};VClM
z#K##B$q_8y45u99MJ8M3aTyeE1j{GG=N(f;W}9*&0rEA1?Tg{GW4g#{(`=+ci$<`1
zFnrN5Q)IJ|8yOIm5$xX!Uv|V{I@-8V29+4W{<-iK$AzMx&9adI$rr%_ws6*Q2}(P5
zBMtg3f(>NhYmTc$X`8r_0WlWA3a;=C$MvGDEwfPuWfj2+s_;$6tYXD}WgY=CDS{nL
zVTE%}v1-32j|R;X!4jhIZ0G!9^?ovs0Ra=i5}xo}=fYy`eq){tY9xX!G~s#9CB?e^
zmOKKaMFeYD!Yb#oV*P$Lj|QC(!5)(E0_VzN!+tT30nHD=9**!LXHKzce<n``0T00<
zitu7*Zn1g4auWe+9D+>@VYM@_*t%b{i3Vv6ZDOtArOv`)+kSEr13DRkDE{zrX9Wz0
z8#l=ydLhW753g|67YFxSHW8p;AqZm+Yn^Syq5bS88ssPhY2@Km&hFy$esL26+7ilV
zneZBCPjPmCW|Is;5rR1C@H%H-vEqP|BtZ2+kjEU>Is1!M2Q(xN5)Ohu;_yc2K(YD&
zNiv|vAPD3QQ_jI+?ExbxgSdhqkv3f5>>VlA9k7rDNF@j|S;Km#qga1{C27z-5QLJ3
z%blKL!vT?GK*K-~${DV9ju)E_WJnnV2?VK>;X3D3vH5_KB0yb05X%@gIH!xP2Q(B7
zQUQWo!f>l|rr36Xq!{S?5#;iPJDhPCjyF;=H1P<6>B3u_7m9-iEEEA9If7)iu*rF;
zICOxeXlSnyM3aTLI<FR|4~P^4y)uGmuJAVJ_2TS-3?)P3iy)gS-0PgBSBxs3AfSsy
z5Y7}fJLl+CqnamZXh{*I6NR@s=j+v@<P!|^mk82%!aJM`_1aP66EZZ52;ynNJDp4P
zx>3s$1ay7~@>#-G=Q6#1lzoDRHV#2RNqCoYrQR?qKEXgsh9ICLJmk#Ln?^HF$k1OQ
zNT>)8J9G8sQRQX=nk57g4Pl!zPj4O7Y^I^}LG5e^kl#YRZIs;1KpTT#MnB9sEA;+R
z<7OFp5(Go)VYjnh9~`x8CZNGUFr^I$e49Qr%5J8iTR<?T93FFa>(is+W(G=s^du{X
zC!9U{>}Y1Q40Sw$Io0r_vrn(EEAt5`$`K4|hJ((2y~?i1r=h||FsT?m=^W6j?PNX!
z<uZavy|CmQ)NAd=d>LwA1fy!<v(6E{&Th#kppZo{s}&A`4XwAc`7{)z2!@ryF{ejw
zu#5Q&RG0{cb;2p<xZY&X<jYVlBA8YQpLb5_&30u00kt23agA`=Ijy(aH3c*jatP)X
z!WW%0dYhdrV4x~P!0U%EJL7u4-B=()iG=`I4_|R!&<E|70s`tK1jKeY>%0W5AX`8~
z@q++a4qtO#)u-)Z0Rxo`0%SLQ!+BkwwPy-sC`%A9tKpl@StSaGvXFop1NE`DL=^0t
z5|u+!NJGJZUSSoH+3frhwSz2V;PyvA?M3FY3rn;PW1$RJIRb1gGLKzSqH|aZ3AmRL
za9a@-yR1a-U<+xuV-avmkp=9^5`#l5WZ=R?0PaK<u{k9sN2XAQ+YbS`5?RdVmY5yN
zA_A^51n5RY&E}O@9hxE<?j;21LS!jhSYmUKMGRar2)z5qa<-zx?=Tk0aAP1auOlni
z`jVi-QbfS<kHEc+XxX-skb^Cv;VehsUPe~2-6d&<Sj51=jNW01$Qrh%B<si&$#BXd
z@UJ54*uD~lQ&~*Fk%_>-iRjq=5|vX^OvCwyz`%%XWCu#rPO_MR!wi9fAEDUZ!4j?0
zSS-WQgh0cN6tE*DI;W+WfO7_ch#S$fjuO3-EvDhjKp<j9%2`i|!6_CqZ~!1s@gmji
zc!|lGDVE`FMj&HF>e#6gvs0-j;MGK+<3tSXbcxle(bMprA<!`*t?W#R%}MGRcxezc
z@{tZUUgCEe^)kEx2s+uw7WP6(&}q>V@HiuA<sv5bQc1|k>S=g35wtRqt?bp3v{TeG
z@Sq{6<s;kJ>m^xdMlZutgP@p=^s=)`6|Ay^fJXp9H5W0nb4pdLri6y?6G1f-+0M={
zRkLIX178k;>pZf9U0AARjU_UC(g^Oe$WC@isgAXj5b&`fIM5?jc3G*OWlL!I2oM}-
zkzMS{QUfcNF!1{zc%vgjY)+|(&6LRS!y$O2Bg1TNshL%l67WAE_)a4>Hm}smYD#JN
zX9#|$h@CAgwXtL=1Ah?9mPR<XqSVhCOJ!CpMI2imakKTMLDo`AaAX<c*-99hX)6uE
zU!^&*3<+#?WQ^@DO~YSjII<kMSUNJn_LOGXOsUL?<;cy}MJCz4QU#|hBY3g`dDw<X
zknJy3ahfuk7b}pLHAGIb1Ep&C9~hpjL_W4TBC&&|TFzJ|^I|3Pv#pV{>`1AOvy>46
zS%m^@dn5$dik@T3XhEz(i0z2PSWl?|ekevDs}W|qA}Myf)Wl`VWI?P(W9*j5d3LJQ
z%qhzW7g>YG*{33DcDmHcY07DrSc49-rpQHhrql+%2je1XbclU6a+!@oE{d^Sc8N5a
zV7ErDuop^$oTZ#_leOqD`+OwJUIOWeEvMaLEjq$(i(F%`mZsrXXWV2RI?BEjxxrp9
z&2pJ?*)7(gNwzm~lbuzj;FT4Ghpb0a>?;ukH>XU+Ybt1uSdWge=E!Vrewi9REyhDO
zpyTZ8k-6N$GA(bckUe4p3bNZH^SC8tI^I%2c*#ce3HxS5#Vsq-^K1p}6&ukBc1L6Z
zx3bItA28!34d_$$?Z_f7r_97>DrB!{KquLqk;PnYnVDBs5<apCO|$Pt)LdSfmDg0#
zKCua%Vy%&-Tw$3Fz7xhrHY1V!AhMjRfLIt~rR)=%k;Lwbtl;X)g1n`Y@RKd*Gxnp1
zmTM~u!Gl8k#TIm$9g3{ty35k=H8Os(6`f(3$QrJvEX!vqWxv>p&a%UibzEPWLQqx_
z0kRFvuzMpquD?trXsYOd*oMxrw#Y`Vcc4rSUp*5b+tKIjfe6J7mT3iJl^hV;QHZri
z3b>InonWaV5NSkV))~=rjxxQ#R?$c_q6o`H$~jM&0iG5HksT<?3Xy7Vyv!tIs$?W~
zpcw0p)NxZ~W<gm^V6qd%S#QL^O_x~(O*M_hPLyE%kydV|%mxn_gUK$GWKpDpi$g4q
zv0BDr7fP{XkuBVXvY=q8CdSAo(HHE&h>5#Y7J?Ur9uuELGCL93%3Uo>!!yZ@kz3H8
z*&~r{-1V}okg1l(#4YGNI~nQaW|b>k${J#v>_!*ZV-Yhqr(EUI)X?K%H~NwdMz(YF
z%hm80Gvnk_=r8Pv$PR8{xz=T@k;lcSP?|j%*~u*_*SRb;#6j|D^jG#&#L6uz*Spvn
z`k?qU`ihkzySSC*26*zBgQN-ljXfP1;&RGOu1t-5P&A>7?AgdLms@UjDQV&m`3$<m
zo{QMHymG5cL(_-EXVBMd2xg25%Wd$oFo(!zQHG5~IIaRxfsC|#NPHGuW@8aIS6?1<
zS!iN{d=CAcO~8m<TX_i133@_&4t>L>B4b>4c^cj?W`f*`{=v$T39hF+>&npbgt!%5
zVb4b<xxR9RTUkpSCVS9T_RC0+>n~TiHMR6%u?Kz2reP`XK)D)TN#-#5Jo+d5RYc+j
z%e8J}t$bK~9%b2!Fr_n6u5(*zi6i6-=wIyDAlEp`^=`J7J|ez=zGE*(Vw|Vk0B<pK
zgxrSy&3+R}apUDCccxZ8B5p(1*ej9q+*G;Qt*j%Ck}sm`?6;9LH(hRZYwGBu;*02e
zHXFIf&6L~V#b=I^FQNai-$gESaR@~+*2zc3m(UINTI33Mp*-le)De^9%jm!C_mM1j
z38ZGWj-C`>MnAAOBG<U9<!Lx8m`So1{g3@2a)Y~Go^@yH<Vmp?-DGb@ZgR6K6dq+g
zF-7*FS==pA1wW@k<<ZpBQ(_;wg;PXl^YbgzaJ(>6<SXb$+^x~M{K5*Y$5<~<iLW39
zH#<6yUs9p-Sn7#m<g4h%+-*@6zpO&<Ve9E*;;ZOZZf<k|zp}yrClYgvG^3wzw?`N8
zITa>Prd~cKn$c`-UUV^^TVeJn8;IlNYiJI4M^w${RaiZm2Ku=88oG^BMVIo06*f4;
znB(N@NXgw9UCviPCX}&3J}$nF=5h<7EBN|~pvTfc1j#qhPr19ITE49!1h)ho6yHF%
zbBm&@`0k1{oO?`=+>U<65z#e#Pes;~X^?~Bb~KM$99_rvRVcj5M&c8)AI<0Pj_UZ{
z{tA^>(@1|J_M<yEb#x;?P@#silKF&u6aAdKCra^y6<V*cQT{}H6REhR(E@&?Lg%$K
z5+_It`UQ7yRL?sq^j@}+J|SAro!s(hIq#`3!12nQAa|f&a`#26`SA*qH`6Ge5O<&j
z+=^%&KUHD&Dh<S^<XdPVcYoBtPghvI8Uy{Q_!hd0(?(nQnF<@6$jqnY+vr!^1JMpX
z4w+a+gZ!!ZHd@53if-XAR0O>i196gk2mP8`9X0WnDnf8e(kI1t5W%g9Zso65q~Q=}
zPLey(Z@9J5ZT$6$tT$tjPl`LyVs2fum!DOs@F|;!X>tH9;nqjZ{G3XaPt!zCiv#Fx
zP8Z$I&#zR&xz9|K@1oyw8=^b-g_T;Lu}Pj5-$iO}V{|9Kq*CXzG!duB_t5XSO;Ibq
ztWxh|o9I*Gd*~jHitgf9RvO@{U`~-%^m}e|bcoNXH2E@3@+r}ZmU0ErVLrFg>{B)q
zBKbaA#uY_vd|sv1r)j1|@qKhJr;pnC!b%(5E{sTifHYibl;bNP63o~vi{b}pIaeNa
z^YxWMpQV|Q$Pdx~ag{KV+g2HZB7v5~57B*Gb##pHu1v#)#7N{W^aqZPPVhaISzo4E
zmc(6X1y>iH<ohZWeq{^s899hnat+ZS-(RWnYg*{f#6fgFXNaEU2P)NYhcTa#AE7^T
z%~6RTtkn9AE%ImLM@Y-HM$hsil{&wrg*Z)qjQ+&6M?-+c>iujBeOmk&J-~HDW4x!*
z0M{OKnjAt8a$V6BKVE6_XIkXb;t*QJZHb=erz*{UWh-%p+>LU$r=n?oy3*>`w9;q9
z-DovuieBVrDs6C6GG|BzJ;Xg5z0AiU5zW{tpAi|fhT9sw!e6Ki`Yo-*S#l40n0r2&
z<u8FX#kSIC#XV>(w=H^&zgn4w%au7x4x>l7m!dcL>y=r5rd2*G4x@EkZ}cWVt4a}2
zwh=Sr2+HMNi7JFSRjPodjh+!l(0a}soh{6-Qp0`B%#eH0qulG!xx&IKZNS(j&xm`G
zj@urcCoHMb1uSjEIdUI*jC(Vx5|&lz18f_8PTYq!a66(4gq2kWxWbupqzygJy&YX7
z<W!jgnKt>HXhR#hozcZYZk0KpY$rY^_oF=S-Kbi~tFi_(?eyp3ezb|RMwbeORW`Wv
zna{}sh~z$qE*B~w5YE^xe=Z(C6t^q7La46_1}yDFh#W;va34jrLR(b`N<=y&j-t)n
zP;`~hU6qD9feDdzl+Q8IH9}8SHjrtTL!uoOaKq7cLT_J{0x69|m~@~*Zf{g4^jE2n
z#z==n2P)!h(T&1Dl^SXbCQLd}F?S$J34>KyWHicQ(TVh&Jz5})ROyh#NJK~$m2l3e
zUT{?D5o@F)B8y5nE?O>lstiz$FcFeNWt<SL7RIYgC}Wf(B8SR3ceGBJsxl*G2N5NC
zRKa<p24T9&iZmT`ROC@5=a04uGgUUIV3;T=pehbUJA^m{;u$;Ss3@RnZY;V*xKI^D
zmJT9Dx=;;wFlrJmRfV8LremTD(cDCIt8ld{4Mh(VBi*Q$I}+U{T(8QaOotp3-KdV6
zjP?q%suft-NyJGHs^^YH&BB~&71ngpanXYsxL|a<Fuz(2brKUNy{M5p5#1pytkz;<
zryLi($iSV9?i7|(>#(JhNRU3%#GQ&-g=N)x%y!ZV(TAEjDY{EoS#5yQib;@u)WV&P
z4hcEcCY<S%6QUora%ZE%LT<GgE4zp!89;5^xu{LZtF~fI7o8LXsGSSJP;+6m4XQCF
zNg`zAB2iALfIL8Bmz)$4>fmBgw@_al#Fj21MPk&+C18ZVtvUo90-X{u>f%z-F`>IU
z4Fw#NBFE5^oE)7HdaAQH(<P_GF|>s{ADtBXsug3(Cy6h}an#Ly84U{k)v7Vglk^wj
zIC_dpM^6d^)oQ5um@mkK=xOe&s3Z(lYsZXF%3p{Fk%_w)Ju8e<>&7fk5;A!RJ;Qw+
z4FN{4A7h`SW$_Stmb)B{37%>Ll!=T?PN3(wZ=xw-yxKIDc~X|e3AB~F5<M?WRh!3@
zTZliChfxprZ8R-RS6jz4Tj)QFhtcy~HhNK*skT97$^4l-f?nXhi(VGu5Qk{oBL7)D
zg0^wjqF00q)xj~#7UDd46uroOAI%Dvz{+N~(C5XY=q2t(^qO$BIt|4rbDo?;FLOUc
zZwS|`vtyYp@_BI*^>R0(H-%X>ig9H(ae<sdecUZEg=<cYYFyJzUl6CzE1V)W+cm#N
z4fQK?fjov@<!+75buFyXjvKq>3*s?k=4Qv{xt7%E#x32%m*jEu8h2Yv<yuywA7{Ji
zFU8~Nb#88Kfoo-r0ZLxxOEQSw;BJpCa^=*R#xvdWmtqiY=jO#0yK-yH<I1OqzmT7x
ze(sK#+Lc#h9oIZX|3&-+y~(L!OI?LEHmH)BzmO-8g}XDh+*JW-kjAIvzlbN$4sJng
zg{!_MIBt20NRywUx464vT31_52>L@hEq;pL<`%_Pxw>o8P*^i*@+5kPBVub@y*)MA
z@yt_lT0Dt%a*Jc@Tzxf)gUY9gzmn5vfV(@UbM@D#4r-pJ|0+(ScR6)zqidi>4aGR~
zSMn5kkGm&Exdv;r2aQk5e-%$5E4MUO;2NpX9ke`6d_{`reeT|v-sPy#A7r1VzY<0C
z0k=F>?()<apnhk*A|>=8cVDd9HC|&nn0Z?MN|ewpZbhulHC1Cis5B9OBR@lf-2E|w
zYr4jIP-CM1CVqxK;<T|=*G!EKN`B^V<Z1LV_du+}6^ArTqe=docp43Ht72PR7ixkB
zEhge3c?Rv~R>w@POEn?rkLioz8N_gFVq0BTYtqmqFc-<QXb-nGw#{|DCVMbrk}ry9
z(J;3z*6W%@D-J22Auf?KXoOoIGrQ){szaJ*=u6@Z+RN!;+g<Z%H8d8?CGs5F$8Cu1
za4n>@hm6n2m&9|(#%+x4bS<HEhb+$!Uz4As{oJOQ)wPV)A7Y=OzZO472RJIW%e9g=
zKrh04O@`1Yw>dWC%Ark%GSA3giy>s^3Sz^qT-tm{`7Dtk!^puE#cZxT+ImRyES(X<
z$jRwrc2^;7gZ72VkP*akr7_M`0b!uVXXT6-K^#{ebGz#4;33Pi#APyyc&-v6KicRJ
z$OH6cF^UAPIyUC&rqj^zFqg>~a&dHQ!qr1(4`rT}FN-nc=IUaTu0C2Zp?r?`I~hkF
zt|1n5_0y^e&2#kM#W?bEhS*8h0Ih~5iTOL3Kt8THCb<S_?S%0;`R`%^`MK8ES=R`y
zo3K1bd_yKtfNPJ1Tn<`4!9GWSBPJ2zI$|-Ghc-Z8#e74i5azmKDc3k{n#epSe<P;Q
z7`G*M-Ze#=CzM->e~@3Gaqg*D+BHpECp25>e~4e8gPbXL(KSQcpcP~OLCWY5_iXI4
zD-Kzx#;x){L>WzRTVq#T7wF)GWh-%o{4+YtJs-=uF3}-SN9Zf!pV1L+TkM+aDxHSz
zjk!XeM@PArVmDmZ>Fh*it9(T~k0!a^*iF~0TE$^y4{?>efTp-tVhZ=1TGe4q4}Dd<
zfR1tI*lhRwTJ>SFhq+3AiH>ux$L6{h)@lzMd*rL)mng_>kIi#0sns2}^bp^Ye?gyc
zZ^l&aWwrXlY!Cgd_!o47+YwvfURi5^9+CN$OruY^w_}UkIkl$4nI8FDF^x`gJ7bI8
zxwYoQ%IArHl7B_h+`BQgJFnJySo1vnPw}tl6laYsbr;s!psi&7Nq&Vy?t|EJcLhYj
z8lRW{DSm}u2}o>(yS_Gf*z!D)CI5yXlRKt$x7CI~9HO)0-w;G(##Xs|yKB?XiZWU9
zB09q{u{G|V+U()X^Kw?ah#)~Cw$9yGt2m;3f%q4B3Bf>TOy};eRUOg1K>tg;gkZiR
zw$VLMtA_5C`4{;$0^Bi1xd&^tM~pAX{}R7OKp(^k+#|KRBbFD4@5l@SGa#mSJ8Jbu
z*ca&U#0-MoJXY@Z)Ec1SWxgXXBe*JK)$Z|H(~-;z@^|886yw~nI`>qq`G|5G@o)0)
zD9(9f2KRKW^@wI0{crK_D8cz-t?rpx8}!J`zsYY<l0&f$cO0T{joajZi{GFWHx}FC
zzEB%HV%bJqBmaTE;10%2?n|{H5Xb0i;y;kgO~kgkuhyoat!A!~SJ0oiBe8An>$TY<
znQihl@d`T6O~!iNv+5K_l`j(4$*brBcPwUh&#6-#)x1bw7q6l(xnOL&dw!i7I&tPY
z`7QbjcOtgKy|7Mu)cB%&UHlfMxs$P-?j?1)qm~zm@5z6nzjCKyR`;?x{ZaNs`g`%8
z=qpZ&?Q*ZIGeGmsd{1W4-?-DUA$Lxl>1gIf`Fk;oE^=pM!|vQV^HJqX#DB<tp-bGk
zn9ZG6XFaNUiT;oHFZ4AB=!Cnl&IbKH^B?j%l;J=}a92PQu<<4NKjL@jG8c=v-Su_B
zqn4M58|1&y-?;=t1hv(LKpUiQi2p|4aH-gsySpw85&?6AyoUb4$*~D{PhIwC<|X-t
zcnw|Q&c`O*eRYaS<;%o>$?NDU_hl^T?ypl#YF?)QD_%$6a_QJf_duN*R0Zb0<oD>G
z+*dKlJy@rmG`=kVSNtAjxr-1?GE%3Tw7g9GK>i2)i~Bkjay#nulkCg%58{8&cid(8
zQ9X4A5F(f#$Q$V2+&8h5d%VsxnR!|MLA-&kaaUsJ-BWeuNo6nbKk~omI`?fX?Vhf)
zPHKAT|B3%a-*eg6MfXgd4YUj9f8-D7Kiqe*%kDS?Asc(;|A{}K8{D<n759a@;H0IO
zxJmvG{g?YbmUUmM3xPCB-xU9ce&BAzuDP$)r9tjsZjv|A|F|DwH{93jvXhx!`KEXi
z-Q;e@Zn|gHE2flv#4KtSp2go1S9s>stEM!4^ekx>zJ*uBXM5(?t3e@QW>L4`AMv-w
z=Xw^_Yp0BT@+|2Vtl($I=XsXY>!vJy#4Xg1@Q?Z1;wsOwdi@mJN8cj-2;a)jjW6)5
ztT%wD!rVeB@K5;L<BL2w^`@yzpL~m?z_a;z@x`9pdh?X>72-$KkMSJ-j=0*BS8tut
zyh8s-`Z2zZSH+il3hQm4!!SRhZpBLe&iHaq1>`^*Uy*+#-HPY(3*sw0_4UCi%PWL}
z`U(Cie^*@V>20eIfiz4jq@Up1`9<+np6>cIXg7?4nvH+P6Y({kp8D)m<`r2X&BpWi
z#qo8XzIw$m<*USxsX2H)e|KEx>91EE)4WRmSek?H;MMVso`HHb$UV%DsoU_+`FrA&
zXRuy-%=oJOW9c@m;+Mt?JR|kGW0qHmTPY>}1%Gc`?{U=YkFl@Pw@ONUC%-&i?(x(c
zKp|porRL&a^7qB7J>&JJW0_awTcx>p0ly+%=b5TEA5)r%pHM%=3;Fxw2G4Z8^_a#?
z|3vyJzKhq!TRk)NHV~DVpHR2sU-1vbJ3Mj7!8V%ZpGddkMf|Gx7SDzH;4zDtm`(i*
z|C(PNH+e4Ahd>#pXG=fB1ivP})pNBz4LTGvo0^Az!>^5R^IWgb9?O{J+0s0`m|qv~
z^~`Ee99O<Z%%SGvCH(rh*)yj>bzJirJx7|4@8)&!?VkA!YLKp&In*8axBQ0q4$r~{
z?Q!F4@*L?7tmZeycY2mI=#E=nBW|O9j(^8*id#L)8uZ86*XY}%pW}OYD!$9JvcUjq
z7jqk>!oTM?$A>&Q4W{Fn*W}wI6<*30#D_h(4d&y@*9j%{3%rakirYMS4c6nD*J-8n
z3w$rHkJ~+k4K@(S7$tQl*6^iq&Qk#~;KtWwrF17=&X>pCp8AI1am(w(T<Vwj|M*IX
z6l-e;fiXbOm41ou<E!Iip6-S;Xll${Y61QOPsb-bJq_98nb+mH(gM7KuZvH5`Wh5L
z<r~CLsfBnY-w+Ra`WsY1%^UPjrG@x@-Vi_O8E8<049EPGx(ol2Z;nfz!3J&6_=fyb
z=`O70TjOUvBMrKs<qhI?>R0$re0w|uW4-zy`v!fx^eg-T-w}^_JPig=?wH%DMfgF!
zE1vR<H<*H%H{{!;MR*mzC4SyB)nE=Pw-Z03evNbZr{ZbPbb~dh*-rmV`ZZq7o8lKe
zGYvKn`<S0m1b&ErHh$R?hZJ<<cKK%#f!FX`<5xTv8iGN~c48j&8~iZ;d_3#9)DQw+
zgq|n;2CwC}#jkm;Hl#rxWad$e@gw|8@f)7&4cTC3yF5=?jMwqK@tdAmjfzi{{lt7~
z3C`tTi7UKw8daZY`sw-761<)_$7g%zH>yEWWad+M<45_|<8!?W8?~Pp`{nu4-B`zO
zkI(ZiY1DmU=_l@>ev2RD-;Arg%Nq5cu>JHM(r@twen)(PcV(jiL`dciN{t`q-;OWx
z<}{i<$@I&2NNT*1-x*)*&22P)qI{G1IrTf7$G;m_d-EEtpJ?8se=hwFZ{lIGxVNy;
z2D&BlbLt*U^04RATLB^P#y91kOZQ-khqYVY-ulMiCzdw}74>`k1P^O4ylssk@P%lV
z^n1LShg52BcVil~PDVv7#rZshM0$G~v!7(%lvUDFT);zSlee!?aYAV!enBn6g*-$k
zc>5bwCo~rN7t%6Z#KT0Rcc4)X@+k8Q>Rw#T!+?Qzuu*%$Xpw&*-HY`+@P6KrM%@XE
zg}9T_;1V9}cdw&Se}c8pcS;&u%7Ys2^)wnlQDyF=mg6!Wnp5w1qv=G(BHt-3$K^cS
z72c^v^9kh+;+NF_;R@axH+ZKTttT`)=wC|zhbwu1ywy9?Xaf<J`6YE9uHsR=!yAVX
zeB%!Jm(qQ>njedA@m^>Qp0Mm77Eph{HT=Q2$$P0W1hyExK>7ow`HA>e@72aM=(fxP
zY6Y(4kHoimuQz5-WOm34q!qZ1pN#i<XBiZqD&Ha&QY&#ie=KhH&M~My)x1S7lvd&f
zJ{aHboo`Ts)XOZS?#GS%iTDohLWA~G<6H7V>3(eBPsVq8ml$-PTHYe=qW*}R_)~GK
zcbP%|Df<?Em-I*6%uDfI-jxOesKd-%loq$}r{hE39E0i8%v<tZk`}k}XXC@(T!Z;j
z<=e!ss6XL0{#@MV%`;d()x1srO8OIS=R*+NR%oz+pv?S=dH@^w2$XFVumiyOw)`vU
z0o=jI;%;xfA^54~ZDJAiAnxQ75JA{x2!Sg|FOnX_U3@A&=Iu75L4#%%QLFHiyd0nK
z_879CX5N+;NvrS{{(OAW+h<UmRK7#}n##f5{Fm{dx8I;Tsd<O~wUmRO;?wby-T{Le
zWNYTv)N1@R|5aS_4jQy4jqk|6mR4gEe=&a6J7UnCw7f$Q)I<0g{_A+i>oDj~vhUD@
z^bmfQzZ{QwJq80P-3&pk!O!vE#8cjJgXv`E9hs2U;H~_X_<8S?!F*D=llTqwFz(^M
zji<fS2J1=9PWm^}!}xhV8^7qCG1x#HXMRJi#V_#R#V^A{<UeWLDgQ=Vi?{LD;#a&E
z48fC@oy2155&R<meLU;EWC(#NN-vfk!7uSQ;@7-a4QbHRnZ?vP{4)PT{D$|sA$u~j
zQ(i2s!@c~?_)YJuCdIUJfLKE1;y(VCgu*wcNj0q*pqEIw_!VA}nC+Y2qy`C|SwgMH
zukyDh=K2;kX{U_?@)Bu1HuJL+^L$I1bkmjr;%@3u{2G5-Lgic5q@QL7=)0vy@$3BD
z!~);SCIhJU%-xg@zro+0SmeuTGEHX&<hvyu-p<cUEcWF#nWvTS62GM$!~Ogn3AHb;
z$vUlhm;SBv7=DviC6@XMn`|KTGry%aU<-d|V!5xk0#-m6-<5wWZNNMD1&I~D`ljHt
z<y}HeJ&xbv?@DNWZA~FCg=w|)IDVU7lvw5KZc2kWz^JK>_#K`|tnu|UWv4Um%4%sN
z-pMactn>9XDNZThBYsEa;Q{{cgwEIBq&lT}kN%yMhu`JZiH*L2CN=m8%<rg8_&xrf
z1mzoS(w;KDC;v{`gsuG2M1gOlNq5Tf9&ryv;`jM`6MCPcNq>rckG@AD@dy0!M7ht?
zWB?0-xrd_ghx~nsYTtO1=~U)D`5uYFyZ9A}I^R^2`IOR1{GNIO5AydX48G|m>nV+u
z{=M`B{)pEmT75H3HgGMN-&33M$NU3{4qqHLU>L3P@1@Onh+mc1;=9lkJY}&GOR0Rk
zn_rzU`7Skuz!RsJO8J=K*Ce+3t~RB?=wOyo1$Ym?HnGijy(xPtW0jXm1$dZWm+1A)
zYF3EK_ladxAs*q^C(OP%%_>pzKD|sT#Cv&NV!LmCvl_e+W*Jq4_wgGNJA4b9wW9HT
zd6`s%ZT!Z>PT!JdooIQVxR)x%`}s`?t8ZDeUS!{=@0E)20iH_i@~vz(fStnJOX=|_
zzd14F%V{==nfK*;B|WzD1&Lu_ZnIfben4ob671lM5;k96vsKi5Kx?ED?Bw+cyRWd>
z1`Z6Pp-M5!mnJx0MYCTtejsb4Qq1w?3AeAlIVf5_AeK{QnCB}Yvb3!^B(fjS%cU|b
z@YRViUw3mFOdDo7RgPUeotW_TG-t)k2l8^M9J~3t#H6pUSs^JuB>s=8z#hIK5%l#p
zt0c{b^#4f}*vlIdCw&9WYVdiO|D!6gk8e&$zQJa#Wc*P6KdBP?`PRf)-$=7gvV2I~
zM^)hf-<}Bh9L;)({gA#-s=|oxNW^@eW&>D5%zacf#(Y;I<r{A{NtqAj`=n|-#&1cS
z_f0jMCFL&S4^#~v=buWXebdcWNwbUogH(eL@}|T^-%PU&+$81?6pat@&n7PW;;{e3
zxJ&+nMB@p5YvPLULUT~E>>^fBwfHdqd?M?+)EojLf?grj;v@XF#5Ld5<}?^k%nGUw
zALU<4-0)p*&PthG@(QUAPx8Hqo4#2siqDjT#7e3jPw}rL6#h9as?Rio^h&87ALGr5
z+5Y)0YVfR>l~e;h&cB|R>tEQS{meKhuap{akl&t|=U>vI`^+*(+)p*)Pxv<zD*v(;
z{b%eTeZSO*Pw+bu3;Ziv3}ACH_frP^DgSn2kw2%!^jT(5zF#unll;!aVt;On`7`B5
z#2=|9Jk7tGQ2X;*te<H<qW>s0;ZwXdvDDvN*kS`~jQJzgj79!~#BzTH?0+$SB>z!r
z#uC3PvBF>968y~a5uv48@Mru-39Y}aB?LqWt(98vX?`fN%HQ3R1~-k-Qmyz5&m`9P
zds?!eWj>O%QY${o4=2|7`&tyIl^+v-qT28bzc-=t_qV7{Yd)s`B(>plye+ZOKhUBE
z1CIF<)s8>s4<so6V2k#&@niW<QacXu_C$eyq(yhy@-guMWyE3Lnb7+kE&9{!$Mge|
z5l46~QSSG&7{Ie*9-umKlot}!{_z&m>CDIS15yW$@$N*Of2zfNS~)~KNOj^k?@bu|
z(=FE1nj!i@sS_u7f1=et(_#agk9m;l!bu(_I{fh#|7qip{Gil@Q~X$Bi~mAP@U&%!
zSVcXFzu*rhO#VwPApm0NRnn7K<|h(c{a0Jk;0!XWs4e)<{E@^q|Miya>CBM4O4@?Y
z^OK2Q|EyNU8Rc#whw8=`_+tsPe@?6FjAl2TBX#31`CwwZe}1bP%tR)KdJ6xAKatqs
zU)ZWWW85w0NKfH3e=@Ptzob=n#<H7OO+AhO%AZPD{mWYQXV~5JYUyeG6)z=r`B%0Y
zz<*>`Qzra3{&Zr<pVMkOli4k=mQ45}e>O4f&uulIQ8L6s)HC=Je=cG3=e1hTXc+n-
z=^6YrAA+3N!d4qtmdr!cvpB;?Kqsnb^`9{^@<Y<I_%a_$xc&95!7~<ySVKLB|IQ~M
z;<&9f1UwMEMtTl^!>1Bs{_fT^xSY%yYAgN+FDEAaJ+0X@8Ae_sZN*pk^NC4+U#sG*
zau4w^)q}6{UnYY7{#Mml%^vz;sRw_{rxPdr1FdQ>Mwy4H=kY)JuM(1fuvL53xJQ0i
zdLC!_i;%@S(yBXa*+Z<QUcmq2zfOewj#m9yb`QN)dI5jOUj}u?(`o=Om03$|!~f>L
zNu>Pat){b?J@Q&<8@|S0Nu2jjwVKZ=hlxk17x8ue+eF$w-D*9n8KxhRUc}$?*~CTv
zOsfs-SLPAwCHx=$yToOvTK#8@!}252OZWzVEpf$vp*48cGEA(aUdI3BzfWZSms&%B
zL(%J`m+=q$jl?zo)z&mPw#+)J7ypm{A#uZhy)}C_Gc2!@dht#EX5yxQR-0l*IYQ)8
zeR!5|OHvV-)25oyjL^AKAHGFUBxeWax2eJ8Wpb%k@Q;LBlXC+L+q5&r5jj_S1uKNv
z$$5b#ZMqrD2(g}e75`YcEvX7DYtzrLBlLRdReY;3H@P6NvdsX#FteUA<DUq(Cl>{B
z+DtQ<5qZ62#<PWa$;E-(HuH>fFYze#8lEHEkyHnI^V+O4n!WU+(rfrOL6uw@C~UKV
zm&`m$y^fW_oyp~aiZ=g@aj*QS^g5m^EJ&^h)VBp^EPDwZ^#=Z_a92_rXln}r4o2&w
zH}LJkqU5STcUv0lXGTYD$3GK@<eETFTXrV1SJp|}@jPL1a$TUWO>s`Sk9dsg$Mc1|
zle$2Eo9diqAN`orkM9uF$&G=5HZ?fb%wyD>_~*hsNh&bdrafoeCqE{=iB-bVWI<r0
zO?S?+kJvz2@GpdWllp+8O@EHvM{kfU_)cMYvOM5vGl0p>Y@l}FUkdjns{`Y0rgNEn
z@&;)KULdSU)&-{8%;%Ig;&JLNyimA5X$VZWS<h)~^yAW7_%1=4Yz@q`*}xZP9;e>M
zzY-oub_C*W{&Pl~{J8WsUL>qaZV6my3!bysh>g@c_}9Yfq$zNzEd(?iy-|7x6T+J0
z*1*-aG+61(MrtSijj%SkEpWXpdoE*>H%dG4VqsmfH!!PR@wsw8kw*>SCBpioIWVVP
z^|@w0ohJ?8y9HfxdtiRM8r*j#k9rsXR@ji-5m?x+{oJ@;&XeB7YGGq?XJARY?sLn2
zViWZq{++NXX$>rE*MH9Lr#DIO;d=xsxht@;-2jF?vx&0e-wT_QLxG%j)90D}@+QfO
zmkI^R;XrP?`E%s~f~4NZ%Y>q&Es)o4{akZ^CZ+fBy@Ebz4-~fBz~g5~>I1A1N|Rim
zqTT<w@qkQ9AK>LedD0!IZx4QMIY3a<hxq@5N{B>nYYzbnNK?{>_&%XJITq+{PXiXf
zP}DB`2Z2sb1bW)DpJxupl(Y-45bBbXfxdP{NI6P8K@H-SLPIhb=x<krG^6wr(jdNH
zFeFa~2HMp?5-?9tAK^a=%}FUR*scv3N98A^kFZu~O`Z*mwCh5aQDQUoG5(X#o(u&X
z?fMWqN^h1v#t#S`$ymVCZUFdz*-Q=L2ZgR=Dlpz|3S~y+&C(EFC2UEa4@|Y2LrOc5
zPwmDz!c)m~V7lEJ(%9*IX*XUin35L*Gwn9u6_|XA!4C<~CNBr#?f#I_F6T=OUL$Nx
zUI|=i4~8suqJY|i9~PcZW&@YnLx4ik1=1e8R@j!j7P#7;2E>6WpoZ}y!b`~;f$Qzr
zP{uA7NW&PIhvdz`ETbZ<bP$Eq2+kE=Nh;7BqbjU%(1p?nUN4xFv(bE`8lVWKklKqM
z6<$xyMGKAEu+bqGN_(+R*q)q+mKb$mi-Rbl_Tk5bH<K!~%%~5u4!TI%hc^g2k_*sE
zqX9SyriilP$A!0(i%^cy6wWy0BFTm~3OkdFQE#r%99BAsVroCm6W&d#QJ&En);Q^6
zX+Pd1Sd&Xpq0t8H1yf8Nz@+d&ayhCn`ol)2Tr3^Hl&~wg0@WLXVT+T{Q=|9^;iIG$
zwHZTzg3@|v6mJ%WlB-a+F%7r|qo?dRUtp4JP>(Si&NyYgWXA=<aB>~$Gb$oVmMEbd
zxKP-e)S-T(DxzWO63Ky!1Y2?=8ZfGX@L)<PCoUEaBq=m#)JBY~Tp~HKUa%(%(1=kN
zv9Lrb#o`jdnbaePQ6FJhx>RCuslX-6k;iBND1<4cI9w(O$!auiG(|G3Tq<$6TyQ7r
z(3H^}QF25X#p4RWn>3(lqcx)8=rW1Nm4ZLnie`*9;7FJ<O2AbDN_L>Q(H}8#a+xIH
zYGEw71zj)(BNmP*r(C#3IG8k{OU4k8uyncP!n81v+={Lm(}12Z<&+!O3P+OL&~;-r
zlHufX$&KrT$z(5@)uD(gd7^^y;CkU$(v0SGsG=I4u8=&qK?o+dqxl_bpjDU(%8MI?
z6UiNDVTU$q<mC#<iw(lb<W97tLl?F1L?z|JO~R?96)o$~M_Hb(lzg~ZkdnL5$_@hn
zE=(om$1TF?<Pgf~Fhw)GTq*f+t8g|sjB-27QKdjsQ32d0oJ-nJUWYZR5$Gx@fZK%-
z1k)FG*no*)swjkwLIjMdiVlC&D9BY3!W}{^=|=S(!Kg(bsws>+g#@fnXzK_82uxQ?
z7<UP&<QVGiNCQU0R8wR4NkL9dpq`FwG$Y8>(iq+%oKH@oz79o9=^|>VaojC@nGB--
z4pmI!qHCma{FIPRo<sv3Y9Mcz8tNc^TKFm{p}`Jq%;=J9q=VQbTuh!tBOSV!#YNE6
zA^eQ+buxq;9r_sSqG{<6epa}gj3G~l0bm`5rY7)n!Z*nj8t*X0GA@~xCh%6_O7c9K
z>M+NYZlabtjC+J{lW8>FVU20rbggt4KQCmH7tu_I4fr0WmO6r85WY)Z2ARwsGrHwk
z=?LB?TuWX-7dnD5i<_vUj^Y=E?~_?{sUrj&G+ieh#V-jrlGo7Hjx-=aOdU0eUlx8y
z-aywovayU?u9GHluW&PY6V2*W#FZYRo|?ja!YwHUp3|v{YdmzlG=*Og6sg&Gey18J
zBBq`?hF=wKP0hs%JGF76N3NHSVY4thH4iW8)Wt0xqJcV&UlVRisqnH+eVp~s4bpM^
zx-d7j0I%#c0C>bSP(l2LaC>SI?#<~m#WNncK?>sS!o1XCoZD%RE4@S`^$G45?ntR|
zUZ*v#@zRabC-_Z4m0F4mJ8b|fF^$v-Y!U8EEyop|{<zUAH%ce)4q-uR1+MQ5#w}jL
zKz)ke67EWAaa(5yIB?n^eTv@}7Nu6<?#?vuO^ks$iQf^3)EeB=nT=<>vOzkDcM6MB
z>u_JEBBAsVP1H0V5bjRtaDS&Nq4Cj8(lmZoP^UKHflf6bQA`tc3cn}ZlcMlor#4~q
z$xYHJY!#NK3h+p$E@ANz&6J4W7w%2zv7=L;V10D6B;pT*<*9P)=`;XE#WYhA{!q9t
zRgK3xO^J+8Zk8mxOIVSr!&9B+gwjv6P@myJ;r^5XPj^}q8b944eTF|0w5e7+(`ieP
zex`*wjXxG1NOj<Nr$1rz%PrDrJS412ZNV2hg9(eDXr<2J-NNdW318|A0R~UEN@p-5
ztVwOfS3A?dYB8<US-eMBo7#r2cV-hAzuYRF#lyn7R4<;@rAR6RL>o1OM}+k$GoI6>
zN@@ahn>2&>3cA#GJiki~co)+~ox}Tt4XGV?VV5>(49IQLIcyU)rgq{bUAm+tK(tez
z<Nd;>loc=Q(kIyf-7bBO4+vCh7hc(A03wWOr$TsC*qj=|IbEh?CLp&<A#4{4Qo}g6
z%bZjq!bpX&Lnunwa9)=+sX??+3S+0BPuX!{mkl5?#z;jlE0m@<T+!uE8j)<2BA64(
zQ*K<}6--(X(LqHqFI2+HmA0-BOaagxQWOh9b!rTEccp<lV>+l9b_sN90{3)flNls;
zNHOdd>Qa-quS=0qVxp6ZV~@~~3gZ4QRZ4^DPAQJPf+2Mh4|J&kRbx7-1ojEdDG3jD
zX;VflcS;HD7g|$i@kp00Wx+%jmBay|Jr%-^E`5r{beELGNa#q#u&2uabQ{w}r7#w{
zQYk#%WlCkR+$E*(n6M>v9#3_dQ_3;oN$LwcE<BY=<LNGIN;5`3DSd$t3Z~RWJkw<Z
zAdY#GlJOzo+0<nmhn=U!G5JYJ#uLKU)D?W8E10s35nHG~<HN%9sVu(K6@noMdW-aD
zd_>rmx`wZIrGcSiwovEsQQ@W34Sc;To63yITcq=NQs_<H#Iv4Me4!jCx~U6zN_Zuu
z7@PB?>I=;{-7Q_f#{_d~_SpO<)qveG-PD)(xbS*v?%2X7wO<&=|DU1r4``~~|2R4o
z+*Hu1pty-G6SquknV6N-DyefyYn7I5TDx71mHe0phzK|l*hHySTDEC-x2wVB{J4DM
zd0@Z><CmRdTC23!Is2u8n+iG=6qWDupMMTy=RD8n^M1YFTn-axayL}=$Agp|Dz6Dj
za<O1jS3`Bb7^Ln{d+VSkmkBm?H<<eqL223!9g6B%bFolUPeV<AGDzQH@P;9m%Y>SG
z8xHp`1Q|PwUSYE&54+gZ*YJ723}o)Gc;(HSJmzB4=>|*x60l*19i{uMdDx|<pBujF
zSAb2Z^EIoP%VRDzF%3uhmxHZ4++I_&#DHCHVjI5cSAy+3JO~2O7?{gVXBv+6uL3zc
zLMRYuHDCixzcg6;*MPzuQE#}JGcW^9XB&?9uLWg01e~x%vJ)F@I@j=hzY0|C5OeYt
z%}!>p>DLB(|2j~+LxwVh)}7durr#QV=*Pg(9ZD{%h1<zoY4S9j>|YN~>`-y07D+x9
zZu-69$9^?9wL{I-wP^C0aMK?R_5B+GwL^zuht_;7()4FTL;q#~cNn;E3zyGCn$9<n
z{ab)*hmjLHB)hPyO&1#IejVuBVd3Ns%`WC@(_amZ{oBB~9d?vdwC=*LHT~W2Q@<Wu
z*wM&kIk;WSwWj_C(4P(bJKUVfAt}JFH+dVH`wd`lhX*k*ngZr}6W8GAF95?kLMYs5
zEx?AF_=dLrVlcWR%7q<V0W;L(YjF0Lf|zUpFKm?*V#7`ThK_zCh|3o9@>WeDGu#wt
zaQ9b&glrkgLs|>58%@E6?tU{!%2x7Otz02<qbbzT+kY6OWUF{ntE33K*>thtbiW0p
zW~=$SR!tFev*}U;(|-h{W$RFc(prQ?n=Ut;=|2Y2vkiQ>l`CSRO#=;Q`;UW+Y$Gph
zlkCQBH4QfW+HVJ$*%n^jrrFKhYP!<kK}|Rtvh65!Y2A(8ZVEU2fs!zrP~&e_8@HRe
z-4tm!-%o<A*>2v{CMm}5G+k{#g9WfX+k+4wO)+z)=~_d7KL9z|Ar#cK7Gon#*BiKg
z2Pn*r^5HhFm>FprYVh?tL0PuICv2DO!A6^g8v^}qP?atA$=fx1n9-&i4Wa&CP@647
z*-q;o>~7P|hD-enIGU~WWwmpAn7d8Uh5=MRb0S;iGqp=fuzO9n8m{zvz^QDtudZEF
z!rW`R-4H>66e?SX;-J<NY^>={!!`8DV79>*Zs$svv8IuRp?)85WgC4$r(`d7ziG7L
zMt=zOWm|l5r)Dp6zv*s6w0{7c%eJEgsdX>*py^)2?fwYb%QgD4oZMdKLDN{nNdFM<
zXS;nSr=%2n*mS?)ZhsUEW_u6;r72||Ha%z<>mLEb*&!4<wU%PzO%EF$^pAnj?5Hp7
z<Vu<GrtyaH{&5hKBk&7dk}@m?#1Ip_0vMMg_RC$GGA0I0AOzl6n2;kwIaO;JHUUf|
zCVNFNDM#tga&cwM1Rx+{z40(5N98xUB<0vdFo~Gz6~ofh9JRmBr7347g2{x)n+Vf#
zbST?uEyo043NhWA4AXNA{;-QHX9OUYi1#jp897G3utTyBn*`#BnO+&p%(3|89h!a2
zBruf_dzZisId&9>weG_v10gZTtALwO;d538w~v_&L`0%@Ioz7#_M18+Mr;b0M$Gdn
z;r1L4BEU38W(t^2BzsrEoSYC!&{~aHESNz^ylY@#PShXn;EYTxh$j|$*TS+KK|t6k
z*^kA61Y(g_1*>wz0ePopKNAOL5;E^PSeqk5p<C;IY$}*VEcRmXXpS<F)yeH=rUEgs
z#Je7z$WaAMostSn2xb#Yy=r(WM;)l^)KoA+Fo#fhH$o~$hjO~s3QPp%63e`sA<QuZ
z!kt_NBLa!Ua_<)C$}t9nZpi^`8b~5mcy+KZ#}bgcH3yh!U>>3LZiDA??19(Z)&tmd
zFrQfI)x!&@?>fuP9bl$|WMY*!8~StH0h3!&iOm2Dh}B*L9L(_`08UfM%m5N%jkf>}
z=Y&ui*jkCj11a&Gw-}D*L<3<rSINYKg~VEKDU8V#1chCaDl7q{5HEO*FfLadly_;W
zm;|thP<bn1Laq!2h^<xFOz;Ttveyiga+SfXF0P8131q}N?_rpds|uRBB-Pj~@F?-B
z*8)>>)xo+hO*JzMEG97T5tx>%Lz!c1H6{j+5wClX!Sq~1Fx<seGh(oWSnoX!GjfeV
zVYkGD%?7E&n_fH2%(VpN-5L`!8!RQ%-ji@ct{ugcttM;^kQ48C>)|HU_MO$unV301
zL2UGraBHqRXzG@jvAN)J;yqO9wmsK__&<%AnG2Q?o4o+$<c3hP*=oiT!4rhW>wty1
z(O|fnGc$=`IkCm-gk`yckg!K`5K97S#D`uttjZOK<UN{$OcGc@=)AqKHdlti(AI<4
zJn$s(v6q2IbCsd29_}DB4=9Ok-m~yTt}0~ek<?)G!BfO1UJpE#s}9xmXlj`GU?rjV
zo`+Pf4&|q<HCQrun)uAy4`Hq$6z<__m}Ibu$oBf6E7uqj_DT+63qU%N>kYxaTuVsa
zt2x9h0ILaucL1KtwWG+j^$;cj&k*_E2)uyG&a-;CLyQEhAqu=h(4XrLnR+FMF)4VK
zDDp<(V6F$@kD9}b6g)>1dq?1KZU}|6t%tFN;CZ6NI|fH{qoHswcbHiS))J-OaTt>)
zxG3zC)M6<hgDCe3n&a}s7v+7LS|$a&Kp4HT%?Wujl<T(EVvE3wM1@z>oRp`$nAOMC
zGK+wUsPx7+m!{;YE}HrzpJR`JmxyYwxH&aXeX*`j^EvYfc$qMJ6PwfWbSMjM{T!2l
zSBM&Ka&vl~;bORt`<#)1b;M!s!sd)T<3-_V$rsq8Ad~pqD{Icovs{#))_lP{3SK2F
z-X+Z&^6V%+Zv6sV3|=F?@+z7)p|ba^)7%%#Vt^4xyvv)n=D9DLPD?D<V*n?<@hY3Q
z=XntRsj)DRf!B#+-c`*xc_EZIw_30z;0?m+UDI5c7rhuh%~_ZwU_Ei%ySBM3PjE^2
zv*b%G6>K2B_o|w!^2C?qKWn~ZQo);q-Mg;2Hcy5^>eer@rQj{%2QSuqG*5Xc>u2su
zW+_k;C%x;NPvogCnSPdhg~`F&#E)Ke^Qk=brMjOrUomp<4pHyj*i7Z=P_Etj6{Z01
z5)IzX%`ne!Df~0{6{7$f3DUcz*_CI!BxEFCV~>MP1nt!|_vKkG$r;Vp%;VraqS3pp
z`COhIMd7VqW6Qw%#7|y*^99s(pT%%rGt0nc0(i5V{dw+7CPs1udjfnwG<yxrgLxiA
zziN&!PXG<!@D?-==Y>#u-g*RE4zxs@x43yUFM27=a7UQsU<={&mNv&21eb-Z<S3Q~
zwh|p)V{@EAd|A$FjxuTBL&EK?Y)&x9P~hHr6k7p4BD%fi<|Kpiau&-SWmW(k(d#|j
zoMKR2HnEa#uqVMkh|^w6bE-joxsKI*!#oK-CK&IL<}`y2W%RAzU`p^$;*9rLbGpHB
zIm~k3FiNnEIO{#$oMA9t7M_uOi#-Ll6Tf=x&6x(vW%(J+x6D)E6T*Y4_cj>pDAsTN
z7F!9jh(A#Dc9Ws;a@HB{TV^HD6X(5T^HziVvgwTE81^*yl=#cr*u34~LGZ8U81ppv
zjOh1*<{U!^kpR|X*ebAt;Jl9JLPPX&_zZW9Sp~8QpV!%3W)KVrf02BLrGp$I;B_}w
z8N>tfUo_t_=^&Q~d3&2{4Kf4|Sii$ogFNDrmuWs~P!44M!hOfA1_olld$#$6K{a6d
zMPkLC0XvB+UQhEWgL<Iu7mby92ILbF@A+oRphLWY)rzeFyNGMv{$^+}41|B-tjrov
zKn!_(%`Ss+KzLSS!=43&#0_t#xzAu3ke}7qm}fx|5%mr<pEKAIqF}XQ&w<^<ZEpkx
zff@(0&T=;9IZ#ZDc!!$(2KRvJtmHWMJlI3r^+uZq4IackYmPI|gA!uQJJLLC2qCJ$
zdK_B|_7V@gW6h(6=s@@^cbr)ZN{Mmrcyr87!JzP*<OG%h%7_V^pe1gncu;;$bArhL
z<%EEXZAsWELm-6p1oi^hM@;5KEu~32m4jL5xD(6^z(~Y$@hvGkRfDE;lJBt>!G2;Y
zCvHjIsUEC5r}>_F5mXQ&F0mzTrw+jr*6%SDI6zG2l3UVu8V1AXxbGPis3hXKg)JF7
zjf28pCI7-+0#(FJPS%pS(=sUkRr4?AB~VR>xg{+dcG?kdVf`2OGB6QyI7Q2*osEN8
zzjFU#UIu0&kz3xfb*FpK^sB^<y#fvr^EhS8_MINYerxQ^E1-r*=2o@j><l49!)nLY
zfkT9ZThmgwGddXlm9sPJz+qw`x3;Bhr{Ie4H_5-TOi)WK;#4hFJH=PzziIx>WP;BL
z8Mm&bcBc$c9oBziuYxa##T?dhbf@x4)^FUunOA{@Si-GuIk8i9#q^ux2kbTQC9#xK
zx18FkzEby_<_G3A@D-upHnvbZbqEBp{(xcNYhoF<xdrYtTnYci{lH-02(g^o(&E}_
zydv~S{)6G*D6xXmwe;<@T#<V;|6y?O4WZ<=wVc~&zw(;L`XB6d@GY^D)3;pM*?1+(
z!~KVO9ULQ8aoH{Yo$f0pkK`ow2KbIx%^6w-cX|-|t~trP0j$ItuApUjX9(dY)|1$J
zU?ZO6id#l^Mz4fD+(~9VI8LnPN?T&`1!3Xul2h0QaDsS&Gq%L#i^KBYHK&*j;Cn*F
zRkkGL%MhVrJ%zmq{zbgZnOl<bmEo-4xl_!Wz)q~=4!5M_tHP$=B|l<sfqxUPa+a3V
ze08|)cg>H?Ti^!*<BqhX<?9gCV*L?QgZ~h(bH`fJ^9|wf@7#}!8k{87bH`gU@{M8P
zACfxkZE%Wsle4#E=3Bz@KQwjB+u%n+&7Ex7kZ(sEjI|DX2h<VoaP=*l@*Bfhe{glo
zJD{G}$dN5u^W9<7ACh|PUGQJxJ+853d%h=J_lKsQc^5Pgn>o;ulOICpjI|!y2na&M
zIa&(yqv7x$Ts^Z9ki-_w*;1A-hzS3b{1@8<DB?rT-BOh=j>!Mi{Fm7TXhO&Jw$$d!
z5N%`qFZLezAMr8Av>eS>Mza3o{>!`v8i{S(*_IRes)*@NNdxvi_&?$k&eL)#UmdCY
zQ`5k_4}K!_-1!zNUxxr4YXi0!G!dV1{Vg!x5DEXuH87h2AhJ1Mi!0w45uTS2*arX-
zxm>8FFW(Z8pVtt~2cVfSa04yp^6iM}u@aaDv=I4Rq~$_>V<hW5M=%=TAPTsl7Jt4w
zVmdD&F)e5%inwUYV7@0(cV0s>TF^!mb0aOo`5}Y>SxIaQXeUazv6j*NXe4}|BbhD0
zNtANqEit<USA`cO6t)$(h;mNgh}$K;D!-tin603LFmkbu(u7?ygbrCL>_gB=RB$3k
z(k|uItP32)d<fh`B^U2V*`>N_x*(ykk3bhu&50eUyVO_fE@)`xBhXElxkN|WE*+wc
ztTd(rJwy$c>`32bxEj8|(TooC5{J2kj*MN#tHQq||HJ+P`iRdtnIm(T<*NKI&HtEx
zfYXG9TjJQT%Z>mg>;JHi!Oz53oWikbSL4;JzqtP~9|MLs!Yy}f-Q~V&`b*M?{S&an
zH=NS3eV6BI-CvqU=AYmUag1B#$k`P_Op~<{+Xj9i(0bodxGQ=!{1?~AYy)QrwBL4=
z?GjuQ{w?`GY&$qdp#83+YM1z${BO<wG26kf1X^%9YIn&H24(#}>=W=Cfi`@Oqq~&X
zvi|1&kNE_62(;pIoY<whX8K$56P5*jC(w$=acY<PTHW88pO`H02Z44R4r-SUkyF;6
zFg^H_Xy7(G;4Z_p@Za1|j2@gP(3IQZ+GV^Z?3XlQpMnbnn({jOc3G~;`!!9>r{FIF
zjX53XcG(eZWo^Pf1Ah}}&gZzWtMOV^Ki9;32Kos!=yLdXxv!b}B>>w2yaXEbI0kol
zuGRHx0J8&d1e$a>hIfS!pJfGDHsA?#)pv~Uie3x%bAZVPJ_6l!9We!h>q4&tVmZK1
zpu3(Uu0VWU?$tmh2LuRo*>NNk$Pm(Hg;*{K66mz=NGecX&+>AR$ps+-9d{im1*+>N
zucR5v0~ZN&+;gNBsIS*~HO)*OxJ01yjw7u=hbS;>GiCsn3G~8uq!$>jhrL`gV*mpL
zdgD1V3XIo<oTLTY2?h!D#CK#CSgy-CO$)OVTp`dS&#|Gve*HDh+JfbSFoC}Fj!gxP
z*RwdTg~<mI0{ziDwidXrn>dLB+Xb!?=s(@Dy})z5j?*}pUEmsleriWfK?t#CRtHu9
zt`i*Ra1<6quZPh;m;x|F_&BGdtUxd%<Rz_GAs8kCoZC@VARdzQnpUO|+#o_+ucNj=
zhVV3ND^>(<5|=o}akM}=l*MzcOc96@1E_KLM1g9^#7o++-QX5+h4VO06{v^mcugC#
z8{8%$h{2%>bckrPwqeEK4si_)V_<<{D9m$hOfeWChB%+YRbU(v`Xuex9xzJW;6jeR
z0?Uxxr)g*QfV)JL8*rQ}up<c0+K!cgd&F%n;<!-IIF#k%+L;nCMvQPn4u64r$mEka
zvAy6vahHoa1`9kxbv})g*$W;JW88>ixFCeMIja*Z1rLb_+?ZpuAUYIAzXzrij1%MB
zxFe=eFf8;-Tv!>1At&&H*3!5_@vz*laWQ3J0x95QTN4Uph_$o2uyQbwoXm?_lM0o?
zS$@vNlmh`7%g48-6sm?zen|(m4@@Gb^5WLiLiKQ+U(><t1CvP+pV*pKs6%+3wF5JP
zDdcoMxi!7eFdX)C9gGpglJWe)){H{qurMI$#P)+Yawacp%`CJG%LAHDW<Qupiuon2
z8w%}+=(BcW6+lSN;T5f$3LA&B0$e9k0YqdXzr1y8p?laAkhrk}U>Z4(SGI01^bFSp
zG;Zbqm`*11t6FmkLkI%2y0J<ygOu=VS_=!K!(sGyz*K^Gav{IAwX9HZLl~5FVO1c3
zT*Rwds|v+8<UvgrQw3&{GJaiaZJ`WtgVrvr8q6XW^H}TALgkIDAlJoI12MUTU*CG7
zP<6u;lyqYzFq>S;t6NVMs&CW<HQkH}%pn#0##X9OhfqUnH)aNN$z}ZJR#<4b5e{<Q
zj2R@7%lR#>u0rDtVMx-09Rx|_3SQURS7^B*4{3UsgJ2%1<hQk+E41HuEoAM%YQTJQ
zC9iM2P}q1QE5!9MH6WQ>#b>wr3*9$NAxSTG2rM91^M=;JLeGu5kfxV81SI4dzMyru
zFob|cYcF;fNXh5;;?~i^=#4P?8Zd{!LUJu%+8R?NxGB6S>BDM43i$$WY>g`t-;`g}
z^f9$y5vk%UTN8?8h=H{BVV{FX$d`F@Yf_Q&X4XZnkNF(P$aVbT)|4XEP18lmY3vK|
zDETUHX-zFs->kc+In8_l7Lyo%q&2Nbhp<WOY0Ls1BVXr_wWb#tZiX*%rx^=aLayhJ
zw`LR>ZwfC-e#X88spOlyy*0DQa#Mau^E2}$SW2q-ldT(y?1;3q{)~ME<m5Yiee0&8
z#+zA}xSyG?fP&n}ldW5e+&4{^Bn<X7c$|EXZ*1LO<hfaQNy9K-gJtAq9<=5Zg%F%+
zWw0aQ2~xv5S__M!H^b;Dz#IX~$t}FIwX8@G6<(IG*in#1e#pC9tBS-?`DG2u90e;#
z9pBqpTO>m~r<KLN0Z)=2^Gxf}B4sq|GRHFC042GNKihhuNEJ0*mYl)91y7Nm@SfIF
zMe1nXWz8ApTd<PU^XFTsA{|0Nt!J=f;A!$RzP}X~8KU9K+!^K=SVd;@zE)R}F)AF8
z{DOT4(#c#t)Y?~MiOL5wzcAl{)ue$RXgybCN6@JC7t9KtA@li2>xH7mXx0Gt3u6Uq
z$O3+-)nDX}ng%3iF&lW6EaIcBgGHWb-GJsSV*}5T#r#O?a8U?xrdCuT51uDW__5Z}
zqG&XX9)iqqu$C<4$6HHdb_;F^2PLQ^8f1{=yr3;^xA>NPP=iW=!3(63k8MlXEkkUo
z6}7;E7s(1<)Rwecc`Iv>L#>}cMOO0hZ7I7|w@iZ)RPzX4BCC0ETk3B0t-3)Cs`Ude
zlV(1#Ep4|B;jGqQF*|sLtl^W}(svtfg$Fs*+XdE<hxvtV8M}?QgjXb}s0n0}pYyV|
z%-xn-@+%rt%mZE}E&P(U4ZH1#fVH9~7VsMR6|ZR9w7c<E))fvlZvc!u!Y^;zy4!ur
zbVY)y7649u!z<gi@AllPyP`pAeegPYj9=B3vpa;KSu1j>gEvSkzoxBlcl1^my#$z(
zU_E)9U)xr;TX0(#mi&&L0vpKhc~x80Zt-n-ScBxa;7!ubuWPH_Ekm5G71>b1TjUQs
z)^>Ea@^)63L-tFcCQtI~+fM9O-8O|KNOuU{CV%ABZKrmtZ`Xx2NN)$;A?x{#ZPacZ
zLUXN1X9nIS8~Dv_aJS)hILsk`71&6U{FXM?ZsToXM1p)pU=vC6y0*UEmfP}(1_^4w
zdt@WOt?k@yJED25NJs+SCx7DgZ5MVo-p-0}$Up%$lYq}|^Y3=wHbo@JH~>B%n|VXq
z;BL?Dx`+lL=0HO__=2|K-5~@3TM<$Wv}7A!+%~#9dOM8XfeZ<@kWRj|Ev8s-M|f3&
zm_e|W?BI=UamC_0@~avIiGdGEH(%M7P%J~tuoXc;;3Kk|H@77fEAM1o<q!n|bYw4o
zxGkkvb;op7f>QtBALMD?(w17RzEgKqgJRy`W0K*Iw51j65N2%s3u^@bB+u~2+R}>+
zcfwaWl;Z^3$g}+Mwv1xq9pN<z%I$&e<gdKFEwk8iM}AF%f?D7c(!-x@+fZyrWU>_n
zb3hjP2ZD<?6*u0=y2ha-2GEn|d9rP5vHOncngng$!KdV3d}G`8V$YqrYZ|m_1)q`q
zJZQ@)4k4J?idJi22g&h{w!-4*oiI8AFaTteKHk|@RxB71UYDTRImjUcyt}QcSUe)X
zu0g|6kV}U6-nQCe8RDO<XgCJ)$V)uacC=VIl69R!(-2@F2l%sXCyG@grt1=P`vp76
zE4-)eRIz%b?z#qDcR)TF;m@~G#X5vcThZ|r>>{u6{cW(=FcQAbq4NwVAcuHgo2%G3
zA{>&S_ZKK6Z}6eEzGBOWd`N>HSfGfE@&j$>itUK9wxT~!u$#QiN7^nFH;!Ztap)6)
zVseBZYV#MnM@&N!AJz``kaziL+hDP0q;5##W7<IpImVB)4Ht(Hm~Hi8POz7Jz>l?+
zjuuBp!srOZI6)~n&X2dn>=BF#hb4Z@1<J??K0$lj9`UGrSmS40pqv!=V%rn;$PmnJ
z^<y1iA3514YERmu9L*Z${7eThlCi${_LM!UQPZ#_fOUfX<W!%yJ#~+Iv~E}vU^+ns
zDe@(@r|r=p{@WVB+~5E?-Iv^+zQ-^c9_9j!8&s0<zJ=`>dyJ#P8<HT_1**uIK3RL_
z9?Piwh9<~#fof9hThhK^j~yZ7)*#jmOynG&qJ7hz#?h=BT#)GoW-`&YynX8)_o(TH
zB!u;VgXBD)vVHp=&uHBZO^E3MHDt1HReR2!5TeYjA*>f1A|<{x?S*@yqhWLcWO~72
za-nZ+d)XerUExj1MXV3hl8bz*_NqPNyYicwi%cK*oRs<2wb$;EAu!!~5jzdOAQz+G
z{?R?kyID86i_B?YA(!~px1ZRfx@)>AxrF@;z9g6W)a|GCsPER@)LdeI249g1-^O-o
zj}Ecy)=L-zz9yIXHn+n)hP&aL+$DwqN66*AE$yy7#=F9(<TA#BqvQ&ouDx%M<*q!c
zxy-QO8&c`p)_!h}{qAc~>t*Z=_?BGh)3;yP(|9*4%3Ws8fMet;Uv|5HkNd7EDjC3j
z0pF3UeTMeIJ)XODQOyAJ3$T)Fd<E^pdqRkqw+>)ufsK65SKL0jCwe!G4#3P=aGYH0
zD{YS{5!@5rk_=*~yPkZ(XKarv5#N*F(hM@Fi<(sVD%%rEWC*gi4q~WVmVDV~Zci#v
z-pjhh4Kk=Jl3eFI+@4aRx@Wp2xq_kYH}X}Vr9HJoeXs78<_d$loJh=fq&=-fhq!#}
z6%2K=kgxlWwWpUD?uBo0R~Xc_K(6;4Z_g+(-V@%IgfZk!C*Snh+cQfn_vE)VVFtO7
zNwx1}`-T!bLiw#>><>^!zT>NJ-&E3gFY7iJW{|6p+~_0Qx0bl?nQluW7;=x1@A(?r
zx0iVC)!o)a7~~QnH~T<)PDu#S|JDeG+#saJ=V&i1iQWsN^FM=Fe{ze@*<My67!%%+
zT*VN(OMd8cw^x;j$K-c3R~f|Okvd;*du@pf2?MNGF~ru8AEPhh(GulY)*bFDgR=7E
zHs9Iy6D6uK(;dk*3}s)*Pkf&CQzh!Lx;vU{49c>Rdf)kWsziqz1J-L8%BGN?`TE;o
ziD4{!hr7n0T{D^O^R>H5jAOzP$#o3vj>ueJsJ*YmGA19<TxZZMm^AnX+Rv5Pk(R)E
z9YeDnGT#?zzfjURmNmj%XV6`ZEbtAr`%BzorV+^yhR$AOkuTalSmGJ08_^6g=vhh@
z`$pPJhf6|8Wndk`&@YE9@r|{QmPE(G=>Eg_fRilsjkm|_72Fq&N`^5%aFOLcfirHe
z_`ZBpGtBrw2Wj-hIurKFko~|qj0Hd^S>Y2ollCg_XN_{hOaQpaN?*J)Wv}YKX;g9p
z3xY1P+9!6V?p5Ef8`a!kf}oo;`x2dLdv!>dV7-BbKo42tOLnI3HQW!6ayOU|=p_&P
z7CJNb8t)75N^W8oK_B_KPv*?rYq>AKtGUTs1gA-hZ;5lmUORFuSZ`vNz|Z7YK817B
z-p2b`ce$I)CBTqJe9N6%_qy+!?n<KAWx$f(_>|7=dp-B-?rNgUWpIW(=3C{=*&9My
z25S@>0Kbq{-x_D(-st@>y8bZ(;4FFEx7Jy<SMWf1PjU+z1n0=_eJW?wUhxC@J<Tm<
z5d2Eoee0aHdu7PvV7-N10l$$ypojC(y~+n!_qbck72qLH`qn#7>{UH5-ILtL!r*uE
zN1xhxYOnf1-9621CJg={>wO!Y)LtEuKUi;L5%4G3;M?qkdkqi5_qf|k1e_;H-xjB9
zuknF!OmYXi3J^!?(>eS0S{}&9G<TS*0AU@zZO(Ih?Z_8ly@Oo?C}ru>J1^{Qe2_K9
z-C?c)6ngMwJN<jz4@_f{5$rlZI|!e_Ik?yJpl(bv!dwSvB;YG>4(|;i#e{VP8v^JJ
z?JIVU?u|YOquVbt1bn2^SL%!@6+9H)myBY=z)yDgjLx`H@k9B2%_uVr0;Jnl=}ah<
zAuEM-6uSX}WVg@kOe$4A%(~BwGB-eo?DZXXrj)84n(j;PVmHA>^0d$5Of6MEth=wd
z%iIK)NXB=>nO3SpA`9zXEDA1@XMD$;>7|B;;rrZOCJF|~v%cfbj8fx6;RDG%>=qa#
zfA!g&nWdJ8@&}rG%q?(*^!QFXH<a3u`@(t;yA8tRAHI6$rqafTSr52-%xw@M&!Zn_
zYpMI8>49Vny92J0fB71n+e<wU>mF#vm^<Ja*^j;wIi(?_%dn1NBj7rTCJoNQ(&)o5
zy8JUEV2JejoX)aR!MO0D<UTeEhRJ}>?W`&lkINrw?lYs{1{w18I%`X1$gp9(kKF|~
z$xG-}eY8|Lp7oHs&)fx3a=>@id7@M`Zh9zrfZYSP$SXdN^HiyNyzZgq0do)BCL>5Y
zLY3-}l*9S}8v}R9YrcLbEH#XWA94?vF)%_7p%3CJHI56%B@eOtV3fS!3px8rE#vZW
z%|qrsxJyQT1I}}$cI5G}KExh?d*p3j#Cf5#aXf3Bd&oQhW8{c$$muV2kDJCN<Jd!R
zpS<gfI!gyjJ>zxbnsMeKctDQ%Mx4W?A>{tBj$`BCA^E^J<{T}Jj)&3kgBb_o<hXC#
z8B->R5yePj@E90FP4Ej`ab@BdMT|Cvje!#=fj`!jP$omV5L*mB0ZybQ`$ev#GG&ZD
zhL2$<Kmir&k9Vb%sbb7A(h2xPIEk9-7rRo+)G_rj+6nALIGGap6J2R#I%F8JO~3_k
z3N_uI>`E^)#6)8F39JCdQt|$Uu8cBcjA(*%B0dSmQ8WEAS7w<dMlnG<k(~smQeyuS
z*M>4Xl9Jda;*+6}n&VfvHkCET=qK<K*~w5uCHj}UwwAeL%oC&nd<vXK&GRc=+siyL
z^%JxLb_$$MCHq&oa>_!;V`3BFv2X?@@vm_emPKPCX!gU#!gy+-f32&mOfW$-Q922a
zg9+3kzsglrCZ3>}sGY>d!I_lIzs^-#CPV5I+a!D{oJB20N4KM8$_e_3{3LcN6jMw5
z>s=?xR1?e-rIT?XoJ}qDt6itc)D!9_YA3ToIEPaBH@c`Y9kQj^CgUPFms;lE?1E*6
z36Y8XWL5+dspbAHE?1dxf=D2pf=`1<)C#}O)mLVjpb%)Mu+!i?O6lL`I#*_&fC+3<
z@ab?qwbHM5T_|gupcn8{*y%8tTIJ7n`ODlB%mQgFJ_9bGR{IUE!7|T;dVw~UodG4(
z8h?RnxGaR6EVfuY9!ja_{Kc-(vgm{entZYGa3QtUU+Rh}7fcjQlE&c)Fok--Z*;|#
zizg~3Y2(-gxQJ5uD_sfYGNf^_#o;sIBh<@&vn#1wIZ;1}k7H*-8MV%T*p*VQnrNOR
zor=$bk5aGtEw0pZ^~Cx~+Nta;xR}EHM_g&;I%IyaO~u9VG3s^yF;{xIVPa$wKa~~3
zCDeNVaaTsUaiVClREW=psnnZ(yDPKYGEp&ED`aQGrIgx#(zT)7j$|=5AwCDnsdxPK
zu1)2Q6ZMmMAv*^usEvNowYA(m(L7ly!so)rsrUSiuI=TXiS?7UB6coZMr}r~(46uR
z^2^vncp`j)()b;&!t&_E2pasciEuf!#qV^Ll?w!-Dbi_p5=^5$^t)YE<zj(iigp^C
z1XoZxf3K^yT!xf1wrTi0_$2i)I>{d`R|@n~_-X7ssHC>}&$>>Os|4mL(&_ko_!RYt
z-{U$}t`^i!(N1UQ!<CfYf8Irv>yX68HXTofPg9@y`(3cyAc#!ir?bg$6_xGxxm@K&
zfhblw1785ssa$`^)mLs2C}OoU*adJkW$+KU&XwDd_r^8@m%wMJe1F7sp}bL`kL72u
z61avc@DI64{pD_fIaV5vOX0Irkw5AhEcXcNW3}<D6h224`$t^E<sszCvBl#H;qz39
zf6O&n9u-8;;FDbl*HWeaaaYVf!6Z?fGyzY68C1Dn&=I#!JV_C!O<+^t3zX3x+mWzO
zhV(kN1bh*Ek*e^EI+FG&C+Xw(1a=WrQI-Dqj+A|>N#;1|O#Bh}5>@RNccku9PpXg8
z&SW2fFH>fJVn^CO9WwIRX5upV3RUAz?nvKfm=uZQXR<Q5jymjL*pac%I7u{BItzak
zW>TN~WgVIOERz&dwX@hq;j5IzzocWsK0A{5*k<92;cL`aenrQoeT|d!Q~6o!Vu(>k
z{L4GG?sHEvPnC-C#~@C9<5zZU-{+ZBKUFJcAA_$`$NZ~0a`uIg_s1s2m%ukDtA9;L
z;lAjk2%7t{OW=CyxPNU&**?K!kx)7tPlX$(@BONds(s?g3ZZs3n+o5gP@#E8?LHY&
z1=(ifOW|7->KE-ex=%S-FXU&lOQD)VbzdDP_NgYDh0-~=9KKDV_Kl8H`_z-`h1xl+
z9KJ&#8FmM?PlxP6wmG;0zDprDWe416m>d!Eb65r3NFh~Jhijj4vPdMIi$4xGQOMlT
z(YMbsSs~KSWgmy{Q3#~$IJeJ^ghaNv_%irDg}8=}3;P-;>qY!rb{X7Ep_pNZf1i7@
zStL!wpMW1wXzSlGxX&}WUZhQApMV+)4dFY6_l1zd$d-sNhgu5Vi91I3MJGql*qdDr
zw@~O6)e&P9Oc70!CgEvtE7jpQcElOQQxwy*No*SYkaGJgI}(gCq&>1F;Va-rRJY&U
zkz`a((NE)(*cDJm_4*HYq!?9G%+sXv@F(FvsMCH+N2*ahrGA=r9{VKxm}2}#I?{|f
zWJ<El!<F!#)EWP=j&!48N@N;8k5$5L)LH-Wjtrx5ifFoYKK>NkPW|e)cVrqZQxwy+
z^Vz51CzQv3vSWkMj^s+V`S?nhMg8Hg@7QE)oT8u3&u3RcJ#`+PpSBv^Q_Rz)$@tUo
zQ|d2&W5;%*XG;BaZ8G~b{EX^HNA4VB2>F<7$@nU`gW~*-jzVK}N(4>)*;O!`^7)+|
zWkx})XohqFo(^-UfZyFwWfaFMW@s0%=`fcH`FlHRjWVQgvMs<@!#wH|y67J@Dr5CC
z_yz20XrKoCXFE<9Rk7w7QVISH+(}*Wdpb@T)v@(6v=a6im`_Fg=Q}8)4q2aU5_}EZ
zMP2jvcR-^dHZp^kuxnreHRShoxQxbFQM^=&KMM<~8~#v7pV1Plh}TNlXJHW)^$&EM
zGun|T$|l91gS)BQ{zymZ1!H5ZKAxAd&%t79#6N`oJKeG7c<Dm?dANtV>yLH}8a=V~
z@!Ey#^RR>(^N(~48$(DgWm|}^g?p(7{;`fxV>C8`wjS(SSW1oi$2(&73*tlx(iA)c
zmQfP|g3h@8;y6WuHigZA<&+>0+nKOmhI~}E6#NCakD441btdgs#_1FI6!ryZq+$c{
zohkcOapnZ+BK$?TpPCvFcc$)F$JHlj7qKtG3Q816>`dFQLkcU~B3uOzP}2j+o$31x
zaghXm5vzigRD57zXU2YGoM@)>5&R`sMa>MzIy3iM;uJHrkFYPnYDyef(z#*39a*nz
zkKivu6E!EG=-jlwF-|{|e}sJ*nyJLV^3JXM-ErobQW^dVJV?z8C_A_B_r%rD)XLab
zU=5WVSk;-cKZHbCHW|JS9-<_HHJyd~qj3?m^kLV*!_>mS+Rn25f~lfe(ns-3SW7Jm
zs5-0mi>E4PX&+@X;pdbru&%RqzYMvxY>(ov!Y`=BXz+7%zjCU67XK*wDzs2b0_!_Z
z>{m@S&yp_2UxQy#O9Sf8Q~T9Z>t|^fv#-IgC`DjnC$(RPbX>N@I0nC_mIXF<!u^J+
zky-p=7K2Bq<$*1ouKmWTBC+%_9EV4#6#-pm-+s$fg;@I-i^FdyWnf$9x&8L3nAr9h
z{yO}YS{cxHUfAC_RWIfrV_%2Is8xaNPXB)QRI^yR1b+j5N39MRItTZArq+wKOV~G{
zm0A-h=p5c3LeekW5_~<hQO^a6J4g3Nr$*4ui(L<oQ)>gIoiP;xp=h==72g0)P%i|G
zopBXnp<=c+mE8cpr&NK;&V&jX@`Tw^@i*bWsFwrg&ZG*ZP(PbbW#5E$YF*%PXG(=i
zXr3)yioXT_O}!ehbf#9Qh4r(wOWC*J4-^(S(wSDFLuxVGQd|xHL%kk2)|p;m5JqP6
zOIbBUJ&%Foof#EIp=gd&j=v32Z(G3LnOR{GD&}bA?As9aFa=I_Zm6&$8<|axzXR*2
zcLMdDn<^TG`Z>IueFxT48v|tL)(W@KJV&a)--XC~9%$^`Uf~he&(SK_cOmi^qbqt&
zMF<JZYzllML|)Q>qqDFgDvY3&AG;Bf)Rus=v#dfO63vx9j&Fj<8y0YPR#k{ain-dy
z*-a36fC9apwG}etJhMHHzXy@m1I+=CRwzaKx%}hodk}H@fwP?_DpVr#T<J3WeTcZ*
zfT#0Rg<4cUSG$aTA0mz}aK4kO&>>BlZ5h59A}%J--w7)WqR3o+8M_&xoO{66>8db_
zM2XTT@DCu$tp-A!eH9jwB2oJU`vF8bw7@`T>A4C!QmfgXz%>vBO9GM33l)tbeIow^
ztAS`y92n~KSGYyyMCo!|3(?{y5bYeS@QCUYwaZy8M1$PGNat`x2-(<d%keD`4Q2vk
zoud^|Q3S0#*)0%Vv;yOuF$V<GL`l*#d@Do;r+~m6cR)N%k)%yyw?gzF48*z<4#<$e
z&6b9L2+<D~5V?~MD5vR@_%!xI=%y+I@$QrZs%hpV=?eTK*hN(b#O~As>S^^!+7;|a
zu$wXm65VMBbjbN;TY>9f4^<OLcBdaOOp7G(D_9-ur49!cx-$+Kr-|lCpTz$G`>4+Y
zGI!<y%QVG2?UU?3;AzSdSmNGrz>YL=wkPqA;m_1p0fl?hfyQb2dHj>?$B?0p1eUwE
z9&k@H&yy<ge?pe}CZKe0Kj4{GKToS<{|V1f#{#R|IR`?>EN4^V+u$#hHL%8Acpy40
zf;PVFHh7jg9$4!xJ0O@YnlF6{-ww}F-v?CgssrNbiuu~7*zNFF${twfu00?_GCJE+
z_$Tl;>IXCzK6*eoT|b|Hiv0w7sFQ*9?h^-8)6MgxEAcG&JN08g?LKutJ-vRub|sqy
z|Dfsv8{O0a9rD-NR^od2C)E(x?1l#n(<Afwm8>3~r^vt-x9fm$x+q!tH2x{PK+yr6
zyYGNyx*}QoH2W$1i)svPbDuk4N6I_f)A(obZ|bLj-hJUf<8*y8|1|p<?598=+wDK#
zo^DQ-uEKXfFV!3{xCak-rq?HHSFt-FM>zro?%@L=WXZFw!m}YywFQdZqX(kXBWU5x
zW<ww443xTKDg`q{3#93I4)jwU0i!#vQanSkK%36yzyReARJs!?Wk{@NOUH9zkm?SY
z-AR?o8Tti$I-3haRBzz0JEc-J!@NMc8qb3lsnY?AJGD|hqke&QHJb-7QB2^7JFQZO
zTzt0GxB*_K&IFFR(<==#A`AG{tN{*CX9LIG8I{HvB8l`Fd?y^Feht{&nU$6q3W@d^
zb|<_-c>*Wh8!GKHFp2FMJRgRsKLYjcO_hx^^b-CVHXlZ)^JrkRwbDJqERn9kcfqUF
zUx7yV_Dau;dWm)oy9-{U`q4-)r!s_$f3`Jv0lZFe0f)P=GCCuI_Wf)D9HM*yr@O3D
z5HFHSpT!H|Fck>6-Bp$1c!gB^EL#X~P@zDtyS7q>B!RYP@gjJWx`fsQM=O=_dMW=b
zTLh!jK;W$VM5QX;ER{Zo?}oRiD*=!DRHZt;UaEbL-3@P35oB7WDs{*!XnPJXhIgoI
zfqplvG{i@w{BvwE9HEBL?8Q}Sj2A7GK9BE#qtuN+$X(i3X^B@X)IQJdfp@8BV8DH@
z(vDn&w&(E@c#parh`29QHpc50^3Ss+aEuxW459O*JKnrdx)$FH?^AaJQTJe_C%%56
zb}hRXKA^?|BktkK5YiXg*5ak`A@v|I<{qt##z#=zfh~pO)OcXr9aAMp5T!^n@G=-f
zPY4RS;;O_6iWF@ITLvf4f?#Y{LX`{|4{aHEIh;sO4vM;xs+0-(6h4D3hXOh_7~hpr
zrAjcTNMFGB!AbPgptviwN}W)jqJ4qg2Pe~_U}9HVl@3V~Z7<+PIE9`bOzujrG9*M&
z_!n3sjHTm)3%fF^j0vJe(iidlFpi!XlyzlRSrQbBv@f#z;Z#~2T++3n%8tB>wiodV
zD5U2E6<wRE8WZ%3_!rp<D54XC%e%H#xf9Hbq$>OXoJP+JD!aB<c@pXuX;th2IGs)o
zuIkFE3LzDvO@&v&8MGw0rmL_jnh-&854IA<(+h)ZyUMBrGewU`U&5<k0=+1x>Z+;|
z&s033eTl7tGih0HT~}?D4A~oPFX7d27QGm)jgD3+XX+o}Ut+7Fm|hZG-*uu&HPifv
z^kv)xXVXiA>aJ5&>Y4SAXkTVca1N~qZtS9}bV&GUdl@&wx%9H&<}O%em>GG5f0;GI
zM0$B}OP8z4I8!8(zJecwN%V@KuB)%gGE*VbzQP`a^JryoTi3ZN`%Fw`dj+q7^XZjA
zeb<Gm#+iB<{|Z|Jlj&8#>@I(md!|_?U56in3+UBBL)T!HXJ)-jyN*2sCG?tLLDz6q
z2x%p4>+r)+N<SAY?i#I%&Wxb63wszYq}K*ZyJD&ZvqX<dGx1uOLcb6+cEweTXDJ@l
zX0o+#5v>YVb|qBHkcrZkiGL0sp<fP~yOOGvv-FShne69KMz0GV?n<dv%`!hKeHH%#
zK1#nDv~;Cbt7p|es(qFH0xqVp;E}GhY8{eS+Fr#i@G<)J;IXdsYQwC^qx`F^1umi2
z2ak7UR2yfB7E52lzl5pun?ZY5X0>IOVzKr$_Di^wRtHaZZK$>*-=*y}{3|G@-wD=t
zZK`gZrC-dy#(o7A^u{3BwYAzk%e+{M;a|hY>Gy(-UE8ZYv+5UXG4^Y?jNXh^06Enm
zq{y^k_!0O7tqD513ag{DA}H*`9)Zj0EkS2jS+zhcdQ6JrM`0TMVbI-GRV@}P9@FCN
zQMiKE1$(<{t7S;4X~Xev;FI*nXp4BXS}E2)#^dZaP)TnKp6xnOtrD9blfI6B3!kDt
z33|FtRjbAIk7-|LzlAGleegVb4eOAH)Al-k3_eYN7VPhW)dq3oG5&S-7+ghX2Yp?o
zu4<!Lv_$#_{vAxGbAzF-zG{nDu|)d@`yE_O8-fE}=c?_<-D!IRx58)W{9vT(LUp59
zzl48-wZb)YL2#(cU+or~mq^#+Hux-E6pVHaR(r(tOSJ1*8+?u~4vusUSBH@9)3zQz
z4xgt>f@58y)lqQ-g`L>ra4lUL9Pf%T31*8@r5o@QFoP}+3cBM=;@OH+?FRM)e1SFw
zW4jYfGGqv~ZNR^WFVYo3QFoF_Ia{B~Z(zTND!MWl-<@Jo%{He>-^Bj~U!tpn;_g(F
zdUk!P_D%L*@MYQ@OzciG>5x>^_9kwJuh2EY<nDBnVRj^yf0MPtb@buj!tM-{akglw
z^ez0~Fq8f~DC^ENS!OGiYTsi24PT`#!6n@rOm^fUwY`P^0AHiO3M#rcnHp#7m-271
zKR}E=5?tQB)#RRSUMf}N|A9FDO;Fjr-Q<~Fzf`Mc{{vsAj|EqC=a@oBU20R~C*d2k
zHMpj`&=j2=L0K;r^`FzngKN9XOoBNgx%6!u^<C572UXowCh;7FT>CbQ3XW-ea9ww;
zNrr5vwzqLqXiNWqw#r9M$~k&D|2B&nOzD%s_1z~-sySx4^c@^ER?<HP)!nB|>N)jt
z?K>>0D5UFy8@nl!4hd3i@8GDCj&2BU?uI7AoQRx%heaJ^G#T8|?J^nXh!oOyanw0Q
z(?MN#pUE;uq0qj|qLLxHF}SV!oXL)ys<wA=R4PON6x4TLFg4E6EBJR=)FMKIV0O3P
z<ep<zNH^lBHG*yq8oCEfo;mdj?M4>W1kjFPLHDpJG>1{xHsVMNPqzh&yGKpYIS~|f
zW041(b_PqkW6XlNqQ|A1aO8caJA%gUIJ0=J;&JUJ7Kwgocd)WM!7M}OR@){ViCyXL
zpt(EAtemTVoZrMElPBF9JlvgPR?Rg(E`1M2=0^H-(9)f1R?n?}T>Bo2RDCoPJkp(J
z)*;!e?L8c++2}LDW8LXy!`#T@{Cg~NanWak$GbDk#<`+p()V%XUZQ^u+PgE&mbr>$
z+V@!`+o3(dlieH4cI1b(y^kZg3jIg0zI&6oajt$D|2~Us8uWRzA=+wo&owWTZpM*4
zf&MGl*uCBCnOnb1yO~9}Jl&60hB@XCQp(yk;|PzYxuB!F&>Wo`K}kOr@vyWn=<F^t
z3lc?7NI$?4|40Xd?(QnHI8pJ0_5&6HZ*(Zw+g)pxAq%bT0~`TP^d%HBIBHfV>Yw00
zU=h(m4+PJ4pD?Qu%}+=*I3gJ6D?v~9DYH7U{t2yyMUizn5<HKN?K&i`wP|n^QKqj2
z`@2h_*^n4{g4eJplu8c;ecdjzF;TQ!s>M+Vk-iZOb@!PqiHhY~EsIiTbTl~7ea>u0
zvRj)LM=2xvb}-U?!Q7arU(Rb;6f2=ef<tIv<xVs&mu|sPjDWryjCK#2J&E<pwOd%U
zH>SseBi+O15c1>Nw%}+_NIwXUb&r~(i4l}^WYJ=X9uJOp#~c(SiPEH7akL1aCxiq&
zaR<doiZtz37EOL>K`6E-;h+pDb!}U5H0h%!heSO|2bD?sG=3|KMmuzDD847<peo6n
zCjAgcS9yABNZgZpP@Pntru~pbcQ;xTO6*BHs6!TB+lM$htJBj%$vx=@4M~wS{zDcW
z&gl5i!k&zS#w5`S=|?zv8PhXEvYyO?mL$ar?MEzn`qJXilAa9*?MU2f`v^zhHhNA-
z(X;7bW0HOa{}I~_&2(aDdC%5^?j-XHsSfXf2kChsWzY75o}~H}S{>U1Yv|<As-B#K
zA>{hC>F{27h?a!b^b{V9CPh%tlkJ6v>4l-SJ!J<4^F&Wd|AF_xT6$4P)l+p)JWuhY
z_8)8?{G67B*7ejLlp#H^?H~AQ_yxTfg-(thRL;{s$^U~r4K4JN(E6Se2UYXTPf9<=
ze}-SuOGE0OQwP=a>Yvnp%>E3&q7|WyJ=8%RG78&1#u@lEy)3jDePF}9$dmlXECY|w
z%R^gwTnCNwL`vyDaTXq>SA=vueFrV`6iV$sSr&dnD?{6Q&K<PR!<4pv;%DHu^vaOF
z=fc6pd3q)PPxcHvMz0EG_xKOG=b4q#ZTK(nJ9>4<&@*_@Gp}B$-Nya`t@N5uLC^5P
z5b_q=w&7=?jeagv+%tMGIxm89uIyQOoL(C$?TM)o%ojZ+-HxAwC+HVK#-6wu@qEQo
z+U@K)_&u!(RrVy*$dKyTwjKW!{)>J&WbR3-QO?&t#cyYSg?4&f=x|R;jcUI6Dd{Kp
zZ}8vrt07BIYK?k+{Zrac*x%p}G!{D2lUAccc4XTpxCj1+em!)oC%winKk^j+3G0C;
z>Gh%GJsCB|`J$E5Ec|zPibkFBJ()F@`HGd=EcSQ!BaJ$sdp6YAkx<!|h5rHT=yyW(
zJ)3G8=j&JUS?nLMp57QDd$!iN=bKkb_4uFgzclJx>)Br8nP0zBt7rd&4K(Ud>dC1I
zAqTTfkDrGGjXF_!3TvYCBP)45dmfTB>Nw~rs}UrNo|b-!Uw{;ioaH@LHR5E&)7nqj
z3y`LfgSe-*MuxP_womcD;Qwgk6zw@$qfFL6&40@N1siGP2<$mgqe?bEE&UAt8~z`S
zoL@bsYShW~PisG8|As%&`q25FQmRIWRL{20@P61tBPj>^12!Z_p5{Me`yrqaWZ&be
zF(!*vNq6902x$b(_Vm?Qk`=48J6JDlrV#|!bFRjY?9jFyI0sv31hw>BsA){rui|&G
z9CXkqq~7DNaVMKsNwaYtw$dnc+A~<=Nv>a|&1QMnMxzi}&u~o$38ih>xDU3|C==2%
zS`$r<pqMl3gH9Ulcza?F2^NUbr8&4Cx@fes>5V%iUZ6<V=CFR)L8BRLZ^9uNa!}iH
z@Br+j(M+W`>5y`PKAq2D1JF&QJ5q1TA=LtNx-=IL!Y&$}d3sY1sTb6zYjfEk?55E(
ztT*kD4r!}xxp)Zn(C9PurXMmah@|tmYzX$!heHc{GY%OSh*nGU@QbjI{yZe>%{*jT
zpjfTVV=uzfv?a8pcf%n&GF{v9@JsM#`m2zlchjN91^U%|9(xHg^pVi=-mQn+3(Tvf
z2K+K)>2E^H-tC7x3+h*E4eVujhCUWr)thrDgyh&Z13mzMp{=1cz5mb9xyLnC{&Cz|
zrL{_Hm6mx#=LMY?bY4(Y(5axDBj{96^oT7JTPC(l%nWRq*h((remPvm{ea53B+p}|
zwTi*cfx!SR>uA5-w@Pc3mX*KfZ(c9<0>;kse7~R1`<-<*{9*{DyaiuZe`k#=wmavn
zY?6FA_9pJ{a&*?YG~Kyp6_ZrU$u|Xm*FdMm72lnIR*87p)SGyqYp}BsWzx#dswe4}
zOK%E+E@x-6E2+EotY(sFId%jOb`5p5y0qObXSI{)<>V0|*frcqyHdI@oYf%&H+2LL
zb&Yg(xYE$)nPF0BxpYJbbzSW|@7mLS<*ad%JO+CU|EcR*XQxZoZ98k8q>3Tm5`OCX
zwv%=3?{=KEAZj=D7XEYBcb&XT-+k>YJ4qiSy(RqIb-nYV>rnU2v(`zb80;wiOV{_E
zz-8$6pLI^6W5}bzFI_)$UUD7nzJ1n(K;P6+{8pFL`I+l@_uaGMNg)(+7jAXk=)CO8
z?jDsV!{jTlEc|xY&CV}e#_lnB3QV<v%o1*Q{n%-Bo$el&r$lUUDhvO$>wleJyG-2^
z^3<4qg_I@y+U4r(cI9<P<Y_R|3hWsETbH}D$7Sx0%+q4@3i6onTbHNP?keq$%F`j7
zICTsUcX>NSS7mo}o&gK3kd6uAE?;NAtEM|H&xpxaVsGQWclkR9T$b*HJTs<RNxm)o
z-WBL{x|+L_^DKx!PQ8u)(G~0*cG2Cbc`T-1DZMTH(G}{viXtiLc~;D{5<8Cn+4WN=
z!iaWf<T){VC3#%<v+L(h#MJ1{%yS`VIdvSr)AdUyDwuR<<%O{j%J>U+x^8u%v_*GL
zo@}yw74{B(x9fH%8a;I9<|!ttR*~-rce{S=bh)~_^YfI5b56a3|JC(drw2t8%ktEd
z^{b?JgulANojzB8cWs_#vS}4|0{^?~_s)RJ*`3{zr=3i%B2Nf^cm2^BLUx%8c{;>K
zr%vGay8i6^*>xQ~-wcyOtE3acy{<c*w@}{XN}h4DJQjNw|EKG2=db96ZF%O&s#x+}
z;h(O*I>Rnsw<FJjaO%{%_`h9$cmClDbzjS4C+lOScZGku?seXA-9j5O>ts_bmW}_{
z^-t$tu5h<M&pDZnC9{S9y8i9F=epB<8~tzEW2tQXe%F7U|GMsV-^~k84xx^NaKGz*
z=Y7}x?os)&2zeZqgO38Em<QZ4+n9Vsges2A5k`Rr7@2#tZCt(*LEEVu`~mPF^RQcP
zn~<-L(8ozR!UI6YjCPN;MdWKDOmWyr{6X*#^Qc>4i_F(X&~fBR;X&{)BX^ItMdj-d
z=bbu<%fKVd6Yhz&=zK#&C{8*l$iQf3tb4L8F5eg-UyZ$oKLo}wPq~%0gnV;^YBl+u
z@DO;EQMhN?lJhMH4Ntv?KMWpYo^`8isrhV#ezo+T@Gy`w<K6RZ>G{?O(`w9!KLQ?S
zo_DKl8Trl#dNpYj9sy4<6WvQ~nfWe6lc$XMXz(O6$sJ?M$`40`P{l(S4aPE)-LbZu
zeAyKF8ti?13>e2uacgY3`HCs3HRSuk81NLMbjREB^OXodPrZ*n3Z7=BqsVGmzIuv&
zjr6|oC{Qpn-AT6Ee9aWo8tfGQ7<h)6<<{C-^0iawHRLJbG4L#-a;MlX<m(W#o;rog
z!E?-9cN#kG7^Z~QNT&oj7|+ai@3CFUH%^gjun+LZ!31W3TW7Q7o2RHW<Ojmz;CV*v
z-fwf{Tc#vxs1NWbzzfV`x88OwpPi!DNFNAKfQigf_aWQOeCrgG20M*E30`EDxeYdd
zzH<t#Ax{fWf=Nt_`>5@9z6+7@snhsafH5oG$8C4>!&5@2;UbI$lbKj|wrx~_Y^r=M
zmWz)A5zK10(Ke<)F;%se%oWCgDU8N_+BU90iD3FvF8&ml%B*vnY!eF9Q}t`5T;VC8
zWa8a<wul1FRMT4Q4E{8j#%yq#ZIK1qsq|X%jPNv=&Lp}^ZBYd}#NVgR;0iE<A>5U=
z=mNvk&|2w?pa3(OBzKK1uE01|z7G2ke+EP{o81;$LV<azY90BZ@C=y6Xx+`W<N^yq
z_ER6?&w|;^HaBfcEnuhW*GV4=&jJ;b;y!OnFR)HEt;0<Cb6^g$!_C?<3Y=5vb)-pn
z4$NiJP=qnFz=a_HlnEaX<}th7muy)D;i;i@l1Ug3<}-WTmu)!(GNpVy_7Oe-L@|5a
zR$Fd?LaAC$ek4o)3mBcd+m>ITL|y>uBm8-=klBY4%w+{?rGCBik?=fFGyC2Bw(Qyh
zjncFp`xt)#EMgA0owk+&t&(0(ek{BI7BhPHRkTOYA(sI4F+LG2VGg>lqvNkZ8CoxW
zEKCGTnM3Xywkrijr92)xi@yk>nZs_E%~oJms^ZDB!i!)TV{rRyjsgqP4^U_ENnkm1
z#2vC-D`1uSc<HP#3B)i*-M4Hv3#>|0JeG%JU<Gr`9k%%koJu;L%o8xMk~!|aW4n!>
z<@R_g51$NHF(=&jY<CO7$`C3z36nuAlkL858&xQqCQrcf@dyydoOH{2#uO^1sS?P1
zAp)#sjPB7r;|i5XazN$dQ@|SLlw002p-??dpCIK6Q-Fp!?H=0`QK*?_O27*6sbDR0
z#;xdyEYwb;6UYK#Dp<#u+~a$q3U$bfKo#Ihu%7wYJ+UXc&@e5OAQcEo5YObfC-=k^
z8mGxOV1@WJkiZnUl|2cC=4q-8WT7w(Y+%gpnLWvc7Nk<33i0V+BU9{F^`sWE)ASpp
zLSZ^cWJ=xhd(sQ7(@YyMGd=_0Ou1X#lTqlLMsFa^!VEw#mF}fInT0N7U!ctROt6Wm
zcE|K&6^5sUP`^u<36hu^cWh5ip=`Q*BUXe*f@G%7t?9`vR7_WGB#VSdu$i&A<9qT8
zl}Ok?72&hM7N!v;+RF;n)AbvrB4HNLGR^L!p4vjqbkjzx7@rNcGOccHPfMY8I=zuB
z7G{HO4DC+oxlpJ>jt8n3SAp$JhdT}3h78j~8>M1F1yY#v?mazM3XRj{iC76f2c$Bc
zZe5S9&^%q0NR|k5zz&9W@9%LGT96ikD#7Q1oeb~R_gpJvr|T1?5@9Y#V=lT6_1rA9
zPB$fDrT9Fsivey!kH644olYc6g?V5%bIE<Q=XRlMx;>F9#peT(`OJO1=WbzmdI;6q
zg!y0(bJ?BUGs-NRA;+;YJPM>UU$~7uW6X*fDx546qQG9p>OS2w&a6c8391ZV0A6Cg
zcAI)8nAJ1%xKt)A06M1Io!1j#*32;BSUJ8Byv+2t%{`H3?F<?x%Y}ttA7giy_C%R=
z$X7v?<7)5<Bf2YlqRoaGAzUgK)L=i;@2=^IGaF~f39JHN1TvTbx1}e+Y@VSa$O>T*
zIKVjF%{|Fx3sPKA75HNCDl_b+ds5Bp3_T%L2#bN9xr#Ed>1OK;6M<FYOTcT)w{Es4
z!|a?v6J({Z1RP|pqsVin*@dhaR3*L?yw3dKzSNUt4$laocAu~m9Aa*`FZbk_Wi#cQ
zuqr$nWHLXxtv$JB#Z1*EvPy^shZ&c<yC>hQL?R8U3SS1^U_7YckX>e0&(v>{s)S|0
z!1&z#J+)@dOw%T;8eb0HWCCtyPm5VQlioyD3(LU~Cgi@_bHS`b@(rpQj{$EnKfAA^
z+p%G0Xp>Ye#DJsBE%%L{D`w+Nc@jq9D?k?WtJ~FMGn;3sl1NHe0gf?Yx39-xwjf^z
zMd2&K+sq&CP|r0pJ5!$|QNl`aoVnw^)pOHqooPzKYVcLy9p*20xW{jH&ZLvb8etVU
z!Q6A->A8*0{`MrQ29E{rGXJ{o_1rawXNFL_QHTZE%zgL$o>4`zNO>|=i^qW+<^hka
zcTABYQk6{B3US~hBlC>z9ap48RuHNdUk%=49`?w4Clsk8^~qALuo@Vd(Vnrr5k;Cv
zQ!-YEuL18fk9rinkww}_I+?5!)__xt+%vv6sz`@KB2*o&0Ut0=cqaBn7a1Z$$x@x5
z0jHU<p2@v&MaD?^W~?4x3v!vKJj&jLB6Fl_Gg&XJ1!owAXJ&75kp;O&sCs-I_>g(l
zqv}m9Vk7mNrFvl<Ffrpj^Lx{atdXY8m<3-CK4PBtsCzStoRRcq(ju$}A2Sm@OM5em
zTu4_!S@3vpmYL*<>CGw%M}|<jQ-}w7%w$h&Z%&bHmV67=fG2=_W{OACn_HxqrP@L^
z2nnEoQF`Kg^NW<oa6&cU8$cm59Ti^6iqy08TcieI128i)JxRT_MVeWrEm$MI5fm}A
zJlfutBJC`C3)v`a1jUTXlhS*kNQa~-R3n}UN|?ExG&C$R%nEIh8ihnq%FOrd>Ag~9
zoF&&{O*jt9m<1kPudT>DOQj{71RRtzYR~>&N0DV#qLymH2~fc-_UL=B6|uAQTB%7O
zKqa%(bEx-bk#&|yi#6k$KozshW9ao4IcL#YvRT*!s+kzi(cardE~H+en(-t+F)KaC
zd+!#7XN6F=RY(FgOsprncT}-#wtOqrf+vGoX0^xIJEmAMTeX#J5t2b2qw$>X9apSG
zwic=d-wf)Rbskgigktq<{Z^?(*bFR8yeF?WqF6KAv=wW`w}1v_gU8$(S*)E+ZzWrW
zEufJ}^py5S73+}Tg=)pMpot+omA%o$hS{O5Qmdc^%}kP~rZ=wGI9t9AYs0sK7G|@@
z(wk6ho~_zOwh3E7E2H%^_a+xxkQ0V#!?%GpW}AoZO)X|;>$gd5!ZtuNDW3Da>BZLB
zrfnFFZwKwn4iDR#QS6*eZzE}8JLq82P(>oM*o8DQ6pg2VbIfkfrQWRK@a)hwi5618
zd1jC2a&JztOeNorwd1Ma0<+g+?aeJ#s8rj@b|DpXGCEIpZ+3pM5~*jXc6<k5n0=@K
zRaUH4>9<Sm!VbVP`#t@=wZ$5hX*<?|?*trkz~k&~Db}j!?PQ0r6Yz}Qa~0(jbjVgi
zb>L~>6Xu}jIvSoCRH5xshmZy?GKV}jdao24Rq_<<9KH*5F^4^_UR$wQrAi^s3A+Gb
z3?5&vqu7E3H`F<NH-O9$PpJ1=F{{$2Nauvz;1YAxbF24eu~lVC!Or6(_>?*33HSPo
zohmwoJTH*oGv>JGPVenv7joiI=kYz@bLNESUhm!FuquSA&B7jVnaTFt?;TYln<G!f
zF5v0l3UksUvyUlJ%u%J17ld^11!MG#wvQ`OB8?7p0pAP0WKMbH_6a5GIr>!Tg0L4@
znbV%J_J|VA98)URiN6HCV$OIJ_Q(?L96FWk6kY;fGbYb?dsK-InRlp8TnD~kKK4ws
zN0%7pgi@tWK?k~-JkMl%T#0dxd<VwhF9RD>;8EHWO3ZUqJ4i-&8T2q_&rExAi3Q1e
zC<fmLdYNL6%AQ)n&e89X7-1i<Go_yS_Vg0#9McYr#a{seQ|?jQGfJFu=p7_0yaGg~
z(zDc_S>i%|ABx5IgFdF(6JyUR3C{_kX1A~(^fNV{SbI*1Y_5DK#^D*j!PI#)_S_Q1
zT-8pJ6EeU6WAVh>^GlRS2}E)D0WiokqCQ+%iF&Snr^E>dfRkzVB-v|AG;>WmF&=*v
z3^A=9t-Ym0JD1)`^1`cNn4vu>_6sFCWD%lxTn|Q=4o@1Ir5fgjc1paU2UnT%o;~&}
zCC0h(H0%@nHE@mT^yuui67yVD8u^Lv8u*rBJ^SsB5(^R!QJ>%k!FLSr(c7<;uygfk
z(kH?}aGkm6Ib^?CVx4PB!!F{lgYOyOG1&bj&bf3Nc~N*B{J>oD9JSvraUoX`brC-V
zB<3^Ear@np@Z1n8whM>A4d${Z+disPHc!3_>%ud^P38-a(LSbBF;BIN>=H7;kBrrG
z+CHvSiS$NP7k(K0kNMhTvQH>g&(rUcx`e~P#dLe}>=C7!d8S<$z~2CFrpIHpN0w^m
z(Yr_>ya7Cn-BW6hD%Bw)5(RJr@G_#O(jHxEm>1e50l@%#Ouwhb9#?9dC*O@h{7v9z
z20RvfLaBM4YBvdmH$i}LdYbLYrIvY#yD5kt0YPTiL)%kJ*?Ici5)_Vr5OWokZqiGw
z^Gv(3OZZ#hC+1rZYtJZk&ZBpemxQ;#&&+jHsmd&MA@34(2|o&cVSeyjvS*cs=Y>$O
zUpNYGF*iJy?K!2g`EnBb6wd;;nIAn?dv<QAV!nzbKNYgTuZ+vnZO<=NB3BdjDSiz6
z#&|q-ds(S^zMhmm6^?;0<MZ^}YfClrO(gai{x<lX33#0LmQw9}nj}9H-Ufd#A<tEm
zYtqfPlhkMUaquVev*$XRtsCZtNa-`-IJm>y^4zdrDK*ZQ@4-ID-vM`-Up+3nt<*eU
zwTJv%cnAE&ggrjHqtt?oP}Jx63Gg@bhbLseR?5!T?~y(iPJnyN9nUTM%~I=p(;n<H
z{x0~3`O6cw`%9hk={@9S;a%`AbI)_fejCje?R%)pcsBTt`PXyLez!C{KZLjjLN>V1
z-1pqKk1CTz$<whbcn%oFKH!xJW6Bg!s&w*-kOLlIW!}-kxH2X3PEl9zli)%2VXs`6
zP^OO3r%P9alR(Cf_Kp=I$}~}?bnFZKJ@63ws8=CGmT9Btbn*+~J@7Cq_l_5$%5+Fo
zMSX!A!6WPw-ibnVnIS5aE`1>w!Dx1@cd`&yW{i^W#lFPf2V>Z$yh<UV%p9fKOMWT5
z4<2O|-kCyjnFZOcs4wwT;4$`DuS!TQW25wYr7wk3K+cZ$&KJ_ltWl=Dm=*s3JkCDv
zRSOwq&M0~>X%#*IPp}icONGob7ZPGoR{S)0lAYv@5wgm{Q6YqN5Ke=!>|}4OkW(gG
zAb$z_3eN@O*ePC(kXxo$pn8e?O2`FIu}W{ekYA=m4lU{{{0w-SosR0VWo7CG`j@1y
zgfl?F&h#b;wPl(GrkAj<@ejc>>@2TVXerY!pkE@t7Cr>evMO(iaG^|xv|H5IxCuPR
z&h@6DRf}Ok=q2fE!34&$^Syh7D`mz7avk;!{t=kKF7WCETbX%*N=JSpd<33n)!zMr
zqs+1(QAd4)e+*t=7kl->wK8^rUMGDcd<-VCOTCALn`PDoCLPv|p9L?n%e)4`U*=pu
z>&R~5ESSW`c#jIV%UnqAMRntO0Ap8rj|+Fp!V5x(Y9Zu-$!x4QTNqU?TPS}Sv*Gz5
zf?e%33S-I@3so<ZHX$EOVKv^<!nkrJ@_|t{yZ}sP*Lh9CgmU#l{mYU~C;&<}-kT>x
zlxr56UdDRxLNJZp;57@8<=Tbx%VdvG2&S`%-cli|T!$25R1a<jGg!h~DMXhW7KUDy
zdIU3=$tHPggt&6!Lis+d7cT;l>}Ib;NGLZiRP7^sg(5JE)q0zS<Z=s=j#0gMF__J6
z^U^|UIlEB5PwEwlfr?G>o)^-~tqV>2FgsoX=CC`wtdLReTuARD?LrBd%ch|UW@fny
zdCDj|UJB;1yS<l$tn%=}&_2m7l!E!}9xwX8$tjnq<*#4@UIwDry<V%3Tdq*6ULggc
z3@l)E-fkhkT#4Lflz^9mh3r05pDrs`tM#u)f=~|B?0#>*P+P81n_j_0yaFs@4|ttI
zOSx7}ze0*a1z61Ly;o5VQipVCl!#Y?CG0`(b+mdjs6($vqEHEzvWL7kge&DnwR}I;
zhgX4U_ORC_*vidn)qb*1r~=DagV!fG$}PyCM)l#<U^#ol8xpRSvugc*sZXc|G3-(A
zE#YRlRc+dj_2U#+!5;I51%J6yP46fB1q!TWk9+S3x6v-bzMtyHYrrb@g!i6sw>+#4
zA*hK^17g{1?|orZg=~>L19RZDAdWrhm5F026pK_Dq(i6$t68IWv^cIpi9BtT1Fr*X
z*i&A)IH5wlNS`4&ggT&MPkYCT5fz$6rVMNVuLo<{GhT%lS)pA-XOIIzJy^$@yyL~F
z3LR3rQ3JRItY<&=P86dn42wb;(tuzA@ob)VvKUukTqHk$4dM+Tfi3VV#e@p;BGmzM
zP-p-fShIJgm|S5&HaKb!Zv-3JVy{X}tzZ}F4@iSTBS>URz4OKN3hN@%0nCXv0h}%O
zs>O^7=OX$5=@gm(!B%>gikTHIB#@(=cr)0<R(oT_tcviW5MsIr%^-=b@y3cd6|%+h
zSFs_y1tha|UX7Srp;)YXl^haUz-HFsjTiGPl*l<p4dJa|3)_g=^ko(5#rjvJA)ys$
z*=BE&SX-f4Y<d+N#@oPFw$-Z@TPn1R=~u~Np$%+fX>W>np+bi=b<{9UgY9gGHw|rK
z4U0psO2YyTQrPp}J>r!L<6^lU8^PN_D%<JRiM9&!VwIj85!%5Hmi6uz9TgU2wxdSy
z4zQEuy?XIl1-n?UmqvsRkj7s09ujX>SQnf0*j4--*u?^`LG)KR7t?z3s&EeMW-ob<
zinl9Vi|u;qDt;c2>}THN;@yhy;t)dG2<O2b_Odry991b>B7Y6LhF<{b>=$06IHppu
zMD-eZO}GH|vR3bDaa^Sm`SYl2cqe#?{n~31CseAJ=wFkr37tU4c6;;0h)T^8(`(qb
zI0Ig0d%R{bvQoQ*evSNAV8A}s?kyFgDs@P?M}3R4;1yQ%R*KP;h9#lbq;CZl>}UJE
zHDX+)af$pO_8rcF40gb45fduSOH>ER?*tAUV4dD(F}c!$EPd2>I1gTBhrP6zTFEZa
zAC$fmc%WymqLy!ZrFDtvAa))91iZ$6>t)4^O6L;#AbDN*1RP|qqsn$>r3;DusO$Je
z@H+d0_mY^MRT*9qLP#IsA~?j}@Lm>kDrHOMuVdfiT_BVF(Q6fRD-}ysuan;kUEnb5
z@^*{)l}aQ7q`t=ic!TvIx<Xl{da3?(>3abHgeCR%i?x-SrKZ=hA8-f|hSKX4TPn3n
z>DS301PBm!(0di-rgg|4Nd16c0*Eu`y^c2XhNYp`r5}V#;3#{`dqccZX<RBlgh}|P
zAdCIg>k@61=B27bq$GR_j<I2{PjpmTkaCcc@Xr7u#dt&FwMurW{*WXIp8<ph@!k?|
zR$7;u4q-R&&jCU~c*CN<(z%pAMBWfS2dMk+y(8X6yG#2a>IQxppsu&~o_M!1yflP}
zM#5!)%DvwE;;1TFv^*2LiC+Pz%;}T$jj2*Zt1`)(!WD3mmH9^ZjjK{3u_1L6{{o=4
zmQUU{p-LUC&y;QoUjWq3@r~_^sM186GO-`=F9E7!_!NDSRoZAell)Qm5}^3KZ+u@=
zl@7TOsULAGKzVE5#J=b%Lv$!p`cbd~l&|$o?u)B3M#~Rl|HHomC{XEB_9axAqg98=
z{|R4#GpxclvoE>Ig7k^h|M0H?N=*4weW_J!wEnR4KjCYD5;DH|ed$%!XwzZLg?|G+
zVxRY^`!cGW(ez=`C42+W3f#A}FSE*pjEj^D?*?e+>5J*hstQMk5YS2J2586Si|xy)
zk}Z?Jfw^%TKuZmurZ2Zju}t*_=@x9DfK~e9`|_)lNYY5T@g9JtmI$^{R;6C1e?xK$
zJpfIqd`W$^Rhng{H!u(03(#1?r|oO0(k`RlAU#4aK-W-TO5cSl9r8L-9^4Mly~CG=
zf*OWpp*JLtU<c@&>D$wHrOLQWZos^_0MNn0r|Yv-nU|>yq*o9CdXV_`_c^L8%MuNg
z7Z(Bg<nZbHu2r$i^ajZ*hycA)e24mOR#}&s444n^1L#XWL!ZCOxr{cDKA{g(voXG-
zeYdMz$R0`g@P0tCD}BfN?pB4Dg%Hn5=m#}ytS`H7RJClm{7uY{J3uYF+Gp$=Q>|F8
zdXw}E4p7Hxe5d=yRV$HjlJesNpq^dlGxbfVRxj7TDfxu~U}58Zd3_Ppn&qZ9u>d{@
z8rTg!b6;e&b~*hf84w0RBb(?e?Tf0`Ax9+@z@4CpC47~A(bb0Kp*N*~-~`QVlCP#O
zuG+X<egq5RL!gD-?6dSGRGXKpj*vlN2(+?VUvpn_wFPM{sUSWK+SqMAx-YewU9LYO
z1%+Wivnjswed*QK<)$N82p<9M><%B>mr?CpP9Gsd!U*VK(-7hzJG0t_RG3r<zY5N=
zyM34XvZ}+&Lr0{La21?q_xLXN<y6aJ<Zod=;n%<gcCXLcms_ofQN2a}BwPcXtj^cn
zmtU<!_Dt$0{9C}V`w)DktXdtTe@psF_!hA2eqVoIZM7!G^cMCr{vF`h13qV8OSLwJ
zevABB_zv)_-gg!CEObb?N&Spp2cNJ9eb-TN#}E^GOZr*34lc5Xd^h^8R2yUDN3mb<
z??D%P*yrlARhwf}N6BA=?*U*9K3|`s+JYRN)GzoC0J2AXp}uSAkFGx|{UZDTF0n^_
zxB6~YTVqT|v0JzVK4p*j!hQZ~XAFImyd_BBGxoUePTy^mb+8|$Zs9k;=j;jJy}rBE
z;g}G@nF%+*Wj5P)zi$*JTOrTFZsRw>751c0)<1?)tWaf<w}qSF3)bix-9L^}A`>We
z8~+h}$)57b`zKK975Xgcw(ujcvZsAx`y(jL3R4#LEB-(56??{~=#QkdE9flpSK)u)
zYu4l&-ycQkkUW(76?cJe*pGb^`=cqticpsHtKb6NY@Tm&e;j38AwP!whP#1{E$}J(
z6Dacv)iLrn!3}y?vu|d9GG#%&QR+9`1A5tFpQ=BVVpr&oNxummU}sBx^ZU~&>k88`
zER1`Bz?S>e{TY;V1$~SR3tk|ymA<9@nUo7DN~tjJ1AT0@FQz|>3a<zunw#JQ{cMdd
zwm*lGt(3ow{f_&AgRS#v`g1A8O4Zxs?}8r;uoho@e?Fx|R#WPCJOBpSM#SPNqtq+)
zZ%e-m0pMhteM$YblxC&rZR`&`2!_~JpSHh+(ypZ6CjStEV3?(SDg75H9TK5Zf8Zf7
z!gl!5`nxE@%Fx@=A3_LRWzYNe^k1QjE9J+rKk=WyHMY~I>$g$nm8#?9pTbYzTbA|h
z?{`oZ<W8mj#D50gvAj>;e+_*G=#NW(3O|GE>_y+9{+pC_rRg|!2mb|p&jO#J-%mML
z(#Od=!Y|+l_LA>t|82^JbgR@I{1!lfF5mI~yHt2(2*K=xTLAGgeA)e@YGkYA?_hWF
z+W^&9ea8MVHHuZLcgVZKZSW&&^_}h?SEEFRR_ZSPD?s5+pQ(RBje3>-9qF#{D?nKb
zUtWJijb@eU9qcdsH-J_jK68I$jdm6N4*8ex8$go?Uul0-jSfj&slV_rKnDX~Wq)*y
zVO8iI=`SG+d~Cn3ra!L6xJrHk`y2lq_}KxUr9Yv@yh?R~{9E`P1X!o9xj(taf;_O)
z-}oOO$PWAH{?r<FmHveEx9|rDu~!jRB)!JE%5(y|hyMwFV!uV-H#?)oxr#nP-V^==
zKeN|;7yC17T*w_u-NWyIU)Udfm-@46!mC0E<|o_%x7ZuL%l$buvRL`M*gyDPaGU+n
zXYJ3eQN*g=CI1obf?rt_zv$1eQ6k+e^$-3R_>D!gi2kw~b*%nf=^x=Q5N3V8{{Gq;
zO|0o%>|gwE@H-puIs02`w6XNN<iEn-;14$ByNY^QI%KG&{>ATsKiQvs*HNy|5F2_|
z`d7FI?y$EIRpd&IF;<?9{fGYp?y|r7T>Z8hbF3<x{7?7?{KbaR%Q$K*NNP*{hyM%y
zX8-Vo`mdp9f<9aNPxu$yWAFHG_1~<q#+tIR`}lw0ANDU_xZhvnjHR>5`@(<VU-q8w
zPXFy17xLgz_woDSKlWeWz5cs3;n)yj84CBoefGZZe*dUiS)4ov8%2zQqqqnBGRK%&
zMVu;!93_r|4{$R7Xver(B~s^7qlgFKgWSV@xnn}DI!>P>jS?S#GH$egtRtdU6KBf7
z9v~is4{?wB6^_VSZ5*9LJ|I2_ALiu#@s6lk9kT6G4-hi=2=|14q9eN25Esgk9uQ@4
zG&j~i*%4Q3jFX?l9wZ)uW4NdMN=HJiIZkzwd{BG{KFTTlGabpb79{AU9wZ)yk8#iX
zRgTnJHco$1dQf~A%DM6W`Hu8jYn<sMCL<n!k8{ua)sBo>XB>T!l!=ePC%B3JrH;&6
z7jpViGGa7*lAGj@ab(qo<3fn!D2|3>xyk-mM^3G5wfsHoAz}<1$4&8T9J#fM)vEW%
zhr}`PDNgB+cjVV9kp`H0h<Fq}%}qzBuCiM7YW;iCL*k=Q!Oiq1IcjS)t4;4=4-=2U
zXSi8@t)rz@yPAHFd{}%8KFg{6DUJ)ZI%E!}9wy}QIc}~$4aGbSt3&Te4~ud*o}2IA
z<G505TrD?Zj}VW;3ETp|&S9%HuT~k!N5seB^PJkh-{GjWtWGpij}TA57r4cKz2h1>
zBIu3MBjOWqBDd6k$Z@mQy4qyKMiWoM7rAAAgTr6zTumFv(c+VE5*On?>bPC&LVjXu
zG%*%p+)Dp($KBfS>JS21ieuqqF4mvz7*!`*BYz(oLyUtF+-kqkF{VzjM)f{9MjQvH
za2o$<$GAErQW{fZh^OFGZk^xcm{6x)qkmr-BR&O{T)aQe5mBdEV|pKZlz19W<2Lxs
zj>tOg8v1?mQSoUwolEqWI-=@yNP<i~N+{qAj__AHqU#K6LhnnDiV8TBOY+w^;_8fR
z<fpL5h-Y9Vx7lxTB-EMLs7{fOiO;}UoYvp$NUpOWZ!+~5@hqIpZS&KP)H-&J{*?5X
z_$*X$DgN`0?DRV88q+CEPCN(aa6A00Bcsl_hCW5g#pmE$E)6lHGV5H(wM@y0@o*lu
z+keTCRTo|pIwi@)@o+x3$A8(8Qzz5NKfoR*Ccr3euixs(ty5@JACQlW6W{_)=kIpp
z*C~;nnR=Xf9xmkeA#__=om!*+Kzdw!9;&(h{(eVooknB&0DFRX0WRVW_??cHI<1EO
zfP6xH0WRkB{;R0RsY6C*>Iq^ZT*4jnUq`WDgC_KW^n^GOF69pSZ#b^h88!0L*ptMI
zFq%8;cR6fzW{v7J`K0(FT*evvK8K^uf+Wz?lf)#roIBzVIj*52qyDt?q&Nx2a7X>O
z95?H%8q;ZPEP=rl+%bRH;jeRQ=+op_5rZqa<NiC2+jTDFji$yDli@1vg#Vu7Ze3Ut
zLL5_ZGK}T2{r4TC>Sb%?x!5=&0>*JC{jz~E^@_EsTymTk0atTI|LB2n^-83grp6Id
z;2Q3fUp_FQUcFYID~%JUKn-`=KXxFZUbEJei#<h5g=@Jpe#Jm!y>=~~OFkt|h3hzz
zfBZmHy$;!_siz1fT+e;%pEwX*Z&(}3m7WrnFrLfvPacS?H?EbR!Ja0j!33_ruN+9I
zH?LKlA)gkf!3~_*KXV|t-hzbI)YHUtxRERNs|Hf**|qvJ($nH}n8=m-=MSXUTi2S-
zU<zUe#JO_6dLX0Txt2adD#RI(;41w~2Quqj$bn5Mh?#H`SM84($f^&o4IzxHI1?su
zHU8LvoO;<h`G?puL?le+>in94+<L`2)raIWVkF$mS^V(>`SnVq&8D6qX2C67BO>{g
z)vMR(Ka`#kXF)C3>`xk~t=FtGeTY3v%!XUJR=;+jrCz&^{*ZiDoDH{ev_ECwLcI=|
zwy9?c72M8s_|s4d+^{b6q4cb%f+^g2|DJ&>^~QB_6ZRZ22c~kJe%*kr-n>p_BA*lI
zz#Sa&s1G>mElAEyJx9!iJ2~F3AGn5Y5PFmJoH!SzamX?@aI@aJ&Sb*I6Z7CM4oN=-
z{PoUtw22%q&V#!-#NZydUGG|FH&Nq>`H<ug5_8~geRy36QEbKea1VFcpFJ?jB3m#2
z2%A7e!E_GsA_m4-6zf$VkrTuyxR*oq&4F<iB~pM>6Nm-yCGKm#X<&jyy<Y#3G(lVd
zbsP#e4n$Zq>rEeF&l3yb%N)uY3`APA>*<fk=f#C^ABRT&15p+ovW8R76KePhhi>8n
z(H6t{&_~kqq8je!(1URx&SG3I{}_9LSOhb;0l#G+!D3#o`j~t{Tm%nrPJi=2vc-Z#
z<J1epV)!aI?578^Q!VUz{m0S^;$o=ht|E|Gy2ZNQ^f5M(SOQ<;zC|aQ42yF;{V_RF
zTmlbr*Zmg<GA%A7C#NP7OX2I>5B^I7S(fnn5Tf{sOW`5zhX3+FjztzPKa0IcM8iz(
zN56F-*P@75oh4rsqv2uB<?kNIw<wX%oO+R12H)U3i0oKqQOE1gN-v7bpn>!G`v+<*
znt0P$Y!a~?zR3mr&Vd$-Hl999P7;^HBV5RTb>M<UhZN}4Bq9dB#r^ERKG0<`#D~sG
zlf)Q!l)L4>F>u9VjF;zO7_kCoaliUq12&5}UX@2;;tF_-3;TTo4vPg@(<zKt3E$@a
z@P`Jjp&O+>Pr}5N@HltJe{0~T#TswQ!zL4};5*!3{xJHzI^*d)a<aGzp5X5J?+o0w
zxR7X_noPvPce#K4_Xh4-!to&lF&1NCHh15De_&LDEJ2=+MG$c?hkGC(8ywT1NKoaI
z5n>!X$;kqv2gfxik(-^0AXdZoxQ7Gs!3hoO1bw~~A+Cl-ZggPmU_^r^!IY0pA=be6
zxkm$v!N>+}0-aAz5!b*|oIEgoFsea^bnes?LIXeGo(N1FjBYR_gz}{+q6VJk#s(%2
z#x)od<OSGNVlB+&o(d=j6B^73sseJVxE7w_6oHw8$qg1{fTyMs>)?mnvjNp$Y6F{~
zFOa5+>!67nADBOw-e65I6<|tYJ^YA!KA;}VXmBRb1*B434?pH629^$HHn@;9o>CI=
z@GLhe5Hpz75KagohO-zC^SH@@*uk6z*#>zbHjPMt`P`I%W-zxwu|ZWxP7@Pg0jCVa
z59T*0k!PNoMr?qE+;jx`ENf72&=*S6#0}8Q%?u<B);4H1m<qA!#70=e%?fA-TN<<*
z=t6S3xDgg}szA!%g$5l`(^J!lL|DSj4Wyxxh+#vhP?|0#!cuO2V9(%{2IB^~8Jj`i
zu#8&}&<)xe%o|i@a)yY*a!wuCKj>(%Y)CXyGYA4!aEk-_!E0#1pf^i1L;_ZFO9O`n
zZ#Gyrn9SHrViT<5mIVxh{s!j;+Dy(AH^FKyCUA7{c7tn!-Av6Sk|4#c3>+W4+YsIm
zLI`Uy3D$72f$YIijk1mMA}o?fhPB-4fN^k4qhh0~h>R4IVI8LloE{w4sN9%XL`4#t
zVLi7lU>cmzsNSeAk|M>;(89$B@&+RsH5*Mu*eqfTY~VHo%!84Q+KqG(IZNCE8@a?l
z>0nf&Zlk@3nnh?~6GsFp2csJe8$(6XEKv)axuihNU|gedqr4cKO>BiN+~$B~Frm@B
zQB_RN7PrDyP8(<*%ua5!Y)mYsW)s_B8@DY$52iM<8}-G~Y;hZ;xs<^9!SqJ!MpH4S
zBDTYJZbyI}%xH9Oq>D+FxE*$IX^2so+34D6FQ!yP3OvW{4qO_{Y7B1-6-z2H1)k^j
z1TGKeG|Cd?CD<Gy6<*->2CRd*jfzB72{}hhg`J!(&^?&ns7y>Oq2>@fAj9oL;McN7
zb)vpRnj`LjEVn<<KUmwSNi>yUbBUdh;|>IzgDs8PM7o5WEAE6mrw?2mywIpiw3kqG
zi8S~LcQ9}rm4*z7p%Q7Xm<BI$hXOYSuQVDH<)zp>Vi)Y<4hLL=wnlTJs+623?t*|b
z1bl;zMoVI1DK(GS4Iy_V5E{IO22T1?X`Z+nUgC}hZVldSv?iKLvH1iEKjn@E!h`-s
zXChrn&KF7e8FxHzXYh8TE74v`%_sK2&$$zUdxLiy!-*k8Fc<g0%UpKg{@|!487?ow
zqKI^Og*zFLIma|9a8(%@C8onKIAdV6b6k@WPb{ONh`sPj?o>eToY17k^<`3&xEETv
z(}A(hh$angD#I2KFTt<4GXaG&vPp~6W#j_!CHOUG3XFF~HR*7B8MT1W!Ed;a0~4Lm
zO$IzvCM^(ku$#*ZOm@aK8F6_zwvc!k+PH#%(wWd?##QCyLh)tT!<hp!oykoWJh7Zw
zNbG~XTya3<Ol@LueYvzy+z0JkX<)uHy~&E3$}u(Z3KY2VfZCbS<izQ6QZ2p$MXoZi
z)S21j!tLdhn%EEfxavTRGpi|#hY-MB+z<P?nn0{Gr%6W0E3idG26S+B0gW@aNkOP8
z$VFlX9N;X0cxQf-l1Qwe77+*FAlHaEz-3KpLSG>*5)VKp*BnT4);4JfQw6q|cohzD
ztpTmGrAbTB735;^RXEJiffVP3CLLj~pcWH)IKp)V(ol!YK!hr!#iAZw<<1B8IIlDr
z33(;9gm?{J<2nO6r>)6Ms4B@N;%o3*jt%U0I+`p*VkNbNI0(Pv_<-Jd4b30*mC_RN
zAiU093><RaY_bxjN^B|dI{cmk0fW=u<Rs`ya;f+_{DHd^IO@FJ<Ra{q)KcOQl(^3V
z$DMbZ!bAx1>%~Lx26s7-?HtuC+a#~TqKQm+llvlIbdG6OY*JN`(PAe2k+TL)JI6IE
zHzih4(Zpf+Kkn;*$vL4}y-8msMT>`_i|Y>LIU|}in@m;MGU5&B=6V8VXJoT>6J13v
z6W@Ry&K@XrMm6g;*{i5!gaLXvF;MA@ZZ>QRRY}W41N3qIff{FAvvHHW8e2}h3H{ta
zz~anKXf|(BRg=rbH(`Kt2AZA8&6Z7x)zot02n=$=0os|`%x=<GOUuP0FvMLAoOh--
zTQ`}iu^8el_!IXn8l7Y`J2%nQWQ_P0{F%ERxaiDmc5Sj(Q!&I*_zU+#;F2?|IlL)^
z`2FHhc#FFcxa`bnmL<t4Yz2`8Z*xBetj^qKMUsjlSBP2gSI!macIG!LlM*Rv1#t}i
z#(5AIx~y59q^G16;xQQJe1U#vZL=oHL}4q5x8d(xAmDViG;5P+id-qa4gcUmfve67
z&AKEzMXe-`!#}y71J_Zf(2x|Oq?O`vc!#@%K&n@ojY;wvY!&eiyvzL>a5-(w<|I`O
zxk`Ko{>6pSWW~{JNlL7tRuL!Q-`pR8kn<XvN9${(RpJSFkGm7N<-FN!O)}MBvBbOZ
zAMUR}7#-xCNpuYvE4~Z=<?aRUIBz$*lI%59ERhZW<NgiYbKY$ZCxwu{K+J~sx%+|p
z&QUG0WO*$XN94d!`~yMR(3loQvZ|Jh6La7Lyev3+Xk3djIkA?CBTm8x`G<q@p$RSO
zWPPm^C!T~despl`P(+I+*;I?ICf<V&@s9=-Ly;}oWV)7IExrdI=H<chLs2cdWP2^O
znlQpg_$PuBhoV~y$)Q?lwP=K+`LV&tLvby}WO*I7hIk*2;hzdBhZ0)M$*MYXjrcx%
zlvf024kfo(k`wEwHN+|S82@ZgHI&-IChO~@HR35K=f?-<52d$QlTCG)hWG$J&OaYi
z4`sAClj%BABYps%;3o!`4rR8ulI?YrhBytM<R=AVhO%11$suHK5KqIg{N!NlP)>_%
zv%DT#OXR|F{FI<(D7QtiSyfN26?5TJyfPR+l;5J<oLEn-CC<R7`RND~Ue==Ctgn~W
zif5pLpBYRVs%_D1Hq~S6h!5d2{H&mMsHH`_nXV_-i66pec~vlF=t7Hbv%Q{LN0{Jq
z{M=v~s+bx!hw7zuq6v=Y=Lh!;U1>3HmRqp(#7A%fzaXd^vbC5ut1RSt@gw*=uMX}X
za<o`BCt9fW#K-UjesNGgbPcU1^cHEo_%WQwFAW|Vy4hmgY_eeS#98<vzbt4N^0zoQ
z(-tybJPRlBF~Orlw_9AB?G`GY$b%TaGI)IGZcBJ`2+1qNJUE$;4Q3CGYL#t~H(&`w
zK8)a32aQ8xS`}MV4P=6t52x^&;OU`pt;#Kl4O9YA0H^Znf~KJft?DiM1}Q--fJ#0-
zm^T#Bs@Y;{z%~$ta2mfMXda4e)o!61$PHp4oX#f(ONXLbbzAHW)CR%~XYfR@awxjh
zuqD(WZ4k|HCZ80n8On}pHExkNVjGDf7|CxAT80u@&0AEB<VLXw&f>Mf=Aq<P%a+7O
zY9mn$XY<>F^iXOmyG7q9Z4`^4icbliA4+evZZS1ti9`vU!|w>PLm92kEp#K9D3-vv
zd>Ue4XSTYw*c+)tq7=^KcLy&GWwnO4gc_wpu@uhd_XIBw<+RGQ@+J%?%3u_~H)tKo
zZB=MhO(ZUs!3Df7*gcfrs?;VnQ8-Z!7xMcMHomM?t<^V4xL6L={QhA7P;IM5Yihy>
zq5>}B4+Nb<Ev;HD-9!>%1zgPQgI9+xwCc3>CW;^`;S&B}@H(m-8?>P&i4ZH{QvOiz
z#?X~kqgLLGZ6c~*G=Dhg8nU&TwW?-vlUN0p@rIyp$kA%iCN@)>h-$c;KN1WLT|?_C
zeY3PltcEfC(crD2o2^!@sToTmD7b<@77P#hTb)|EnM@KXxRO5}yfbvW)upvJQ%OV(
zT*aRV-W$5x8rFu8yF{#kv3z#${?Mp4*;aWAmQ2*bIR0c%Haw<Hu~pSVCX2OjHE#@#
z9v;`G+?v=zB@=aU4Sy;qAD+;r-l}hrlEpfx;ZFz04o9?UwwhY7%|tz1%by7<h9ldw
zTj>^Zvse$;@uuMT;ixv<R(lJznXth1{KvtG!_jSqt)UiavuJ_wd|q(!a9o>ltGpH4
zLNvexz96U^PG~c4Rke~^#0I#5HwR}9C%0L)Cbm*rh(@@PFAl1PQ`^|B`c`R+*a#E(
z(%}5z^fv2OQ!Az=njp@X2i3zFZO*N9E2$NmAi-A#mkwvPxwhI{DJ{_qH}TcMnBlCp
z@YWDgw}{O!iLVL94(GJVw#nPDtwak<=Ier*;oLUGHdPzBRcwKqc}p;UIKNG~EwPQ-
zO0>c)d?T_5l(nh1>D#2OVk^}0&B3JM+BVHLQyaF8XoFk%)}VH{rA@nyZX>seZEzb;
z2UCVGwCT3l+o){>4Y%_h!8FuBH*5>FN!vskrts&3dxo#H8Mn!4Y&+2oQ~A!IZrIjl
z-ln3-?P5FJ!Lz~r!;Ut~wnUoRPISPXJRj5#UqjnVJuPh)J75}rF?eYBW}9`JiN;ch
zb8r_Af`(y#n{yjYlPTgkxSPKeJUV>4&9%)=Qz^uGNb;Wrj}PB%3vUb2Qi^yU?%^*7
zvxi5~vhDJAES0zb)A=ug#^EuvV!NuHOcgJ{y}UJedUzbI+@9D@r4pU+CI0K6X?Oyy
z-mY(#QpHZF<GX`-!x6M*yQv-9K``)Tz9(oNj-<8Q>2`95$iRKPJy<#%MeDZP+o>G{
z3t!>IVC8UjG;P=(YL|A1EZooc2Wy7oXybNy2ey;oU<N-Bv<xTE=IyEua;M0_1H3cX
zJe*8hwkLK_I|&}X$`1$W;Z&O4uJ4d`iagZwR}rc`owjZ_bzo`4C-61?TePdmpq<<4
z4l+&r1RmtC2QLn1(ys0H4l0ef2w&%a2wob_qQl!m$lN1dgok(}rXS9sWhwG=*e;?A
zX7WD<t;4yrB1LtM+$DCw!@MilJ)BP~QxeZny9fZ^;62DHQAVp%^yj2qB7g?o7wjLd
zr8Oz0bJ%VI!Z-Oq&^g>fYg6cR<ZcndBYY@$b@&3UOR=A$b`zK2Tl~+#>xf8TNC};j
zc8izbQT|r&#_$!|m?A%qk;JDki~lv~8n)5q6xDf>6hDQ>_;AoS?4T_viRUSj_zb?y
z{}BugUqjn${dtKLKZD2lJHcDSH)(5%={&ZF_#D2&{}l|Q$&oXKK2PouKZhrHq;D9$
zO}kR;=czr!W%w?Sc>Tk7>2OL2iHpR`Fq=nw_Tf?OvQ+s6ES<Olb9e;g9vRcFNL5`R
z)5R<BB#!{hBjehYsfib;bm9y69{+GiJ~E+QovOberHfxcBaaBHBN6SIRMQ1)FYzUO
zpGQc|k;ry!Dt&?6D}D)2@d%+f64kCtwO^q25?1&DkC=HQ(d~xR&;@C)XoaVF#7G;7
zYd5CKJF%CDuV5~Zpjaab?dDWfC;5{26+FWu2+~M$yCpTTlX{8x8h*$>8&Zv=wzH}F
zPU$7_YiQyT<zyti-I{9Z#B{_r@FN~!Ek-ihovCyusT03}AM*%fFp}BsO0{=VI-(n%
z<xy{aB&$7~8baPCu^Z;`sHZ%V(=OW~XRwzE8_efXF?A%jU9m&OkS~iiSiqwq;z)kG
zaz`RVy-f7LLVh}ujFh#jcjy`EWw8gEdDJu-scqNnFfrIZq8AqNs9G}8(yrY>Gvq$8
z7Z&rVN-%PvUAM!|Q2PiwEa6dh904i}J3@@KPqf2Q9%Y3`uCyC>$XV<aLV#sF3Wtu^
z+RZyuEcuEkz;Ygi0Y@C|mK}*K^$H=v3Ld4uMy{c7gPxUM5k*+ZqqNV+&35Y!6N~L9
z`d}50;vFOYcIOV7CHIScu$o8f{E^%3t{rxk+E4UDibwm~k-P2T9U-Kx68m8dkM?yV
zqdH_e<s6nlIAAT07BnMcIutuq9GM|HU>%PJ@+0FqlsgkSDuWn+^*oxuj!fuK@6>Zr
zhByE%Jes(TM099&nmFtLF$f!YG-4Tv?9lF{Ir4xw2pf5Hr5?$S>d@`9bJPLC37dFy
zi5iLSFzgI*(gD#4n|X9-9*OHP?v(S`tHcm&;n68+B%#B+Q^k|7ibJrKM^D9(<POWu
zM4oz;7=~>;`WPHZ?O=E6dFfSg7}7j?+mEDoSa+IuOizr!b{_qlBN-jeoitDC#Sz%S
zry<8iW`}F1ou~A~Rd|ly9lA7<)e+tq;w8O!6`tq!gf5TdbjZ@=pJ1;M*Wd+yZ^$~5
z+o4EPeL}t_UW1*yF4R4e-=R!P{DgXq_!ct!J|vwf>rkiZKapM&zlAKnKh!@`+o4G_
zeS#e%zJnZpAmkir>CmRppO6Q|?;y|XLsv&Gbm-FTpHK&h>+lo)VCXsmmKf4PpGXJA
z>+m9fD0E}wN{2B`ei3_}_#SrgheNIrTZcJKb&-5s{2l_{5b}*UIxK047pd2YA0Xt9
zghC_NP}oI(QF>kc0bb&dhHj1A?69VpE@FoW34Y2S3x!Ag9nLiRB6&!Z;Ai~t(4CRn
z9j-L{Md}c71Afk*2;CdG+Yv^;C+U!Q177B{L-$8Uos;d7cVU^tO?ZVr8IoNcb55~K
z)kS8CH{ln&F*N$>xO2)~iCt7C@gw|_KNXT+op4UQOW!4Bia$ate>ybwYQ#CsE>jnF
znD`(3ia!%lT#Y=Z-9>kihsFQFuX$5w{MD#)x?T1z>M-Gg-~6AUdyj6SOv3<Pj7Tve
z#fTJ<q!^K6M2b;CSr;^`pm7E?Dkzc^0<;h=g#axSXdyrg0a^&qB5Q)1b-~R_TS8_g
z`MzG$`*en4)TT{4lQwNBPVNyYBC_*$&&fH>Nis9<_q@-~agv+Xwcx7$D~@2cQvp|t
zqlA-mExu~_O6U~tKn7i{j?<j9Yw1<fS2Cx12Q}zwbC|eUUCXapzfwBQJCGq)yW<=u
z>soo${*}(j?4X8Rq@#?R+m(6M{gu%v)+58N4#x#f-j#jT^Oeo1)>FeS%5jmK-<5MU
z@D=Ga>ycY7+VKsyuq*Fs;wz3v+o)Tv8x9M%sH^a*V71UC-ieI3Ivw9~imu|TqSZ2&
zdM7pFy6LcTOS($0N>?jg=AFoG*N=|xc!Q|?s(iK1#q6YRyF8A|+_J7qR~4&`F7Ynp
zSJzLD?>SZ1m8+`NHkW!A^{eY=hmBj&Re4prnsk|WA)M<M#}C{pzQ0DlnsYI`D9+X8
zsNghRbyp3mg+RO;3A((FDo)$gdeyXA2GqN$psU+q=d!vwuUc0tfq6F)a`iYIoUY5u
zN1t?n*-eF9J_pWi>+)Z9uQmd4E)sV2I-H!oYvihDwGF6qsj#ch0l3_*=+(e#5}0$5
zh>LMlbNOAPR}=i#hRLNOF4j@Y6?7$42-HF-&O@RuzoVWrbR}1a)H0~fqoS^Uhnp+v
zN~w^lmC&4r#9RZ8CeGNES|L~KAd^SMTmeT5SJIVMp->y4cn=bH4LaI5Q&&NHg-UIM
z>OEB4HRK?<vaXB@t(t`9JxIbe?4Y=dT?;DoY7R1csD$g5;|6ExT3lgJ3#-L@k>6Y+
zj+>mdYiWf^Evr`VrG9hWc6hkUUCS%1YGt)~FLKBAtK(<R*0r+2uGUpEd#O7v&e6r&
zFqsu@wXs^9kNoZmI=cCANOpxsZL3!2Q@^`H4j+ei<x~XJWVJaTx$6o$`Z&;)SCLS2
zyxB+HbwwOJuF_RlA<zhG#QTs@SJc55jdm4Rh%~Yq^*(CU6?5>d8(pOpQjN04ybrnO
ziaYofl&<m$xkgvR?4$0v5)M9((RHapp)uBo_alF}esl1{iLNUZDvhm1y`TESb;rSR
zU0szGS`Ara-jCdO{q6{HKEBULui<K#{nUNeT}OnsW9ljl8ey&Y0P?46)DhzXU9A-+
zjjUFEfcn#Q&ynE6B%Kvjjk4B!0D0j0!*PdyRWBcf)73Hus0Xh5j=Nl>%U|Kv7;D7^
z$X~8M9rw5de^TYq*lN`U)L*U#j{Dr*u4qL-L)MxLkcY0n91pnrU85BV{%4dapdPv&
zIv#QlyOJsenZi18A(8}=urWb_H@Q-jDXUW#Qb}M8CJ2u6rc_EZm38JqWDIx&8yggQ
zQ!C|}x;mzi8UqB_xZp%@TBRb>SSLP+JOUoY#s@{-^h#BxtxkQAdIXHcguyA^j7n`L
zS!X_o2*6|5gy1yqf=YcRSH~Qr1YjICF(~mat~6u{>&1tVM?o?+DJb<Wtu$rI>eYv+
zN5ObZ6rAN<UTMu#)|(F@W5MIt<e<#EveKTZt7i^TV}THx5}fPJtaN7@>%|7-G4KR7
zH7NIHS9&sS^=bq47?^-f3(oiER0cB1db0r;2cE>H2N!ztDifI;FE&!+z(h<ET;wgR
z6s!?8hz}#lAO)KdRCtRkMQdaY>cdnrn1o4#OT49((lyEk^I>E>cnX`z6J_O<@-?~!
z<}fuLh_G3~W!_7biZ#Xt@e$;4@H93%sPbN^RIRZ!sE<&OgUOgIxWZdmsa-=hn2#Vr
z@C-I5xQeg0(y!qfm?M-BOu^;`HQu^P!y2Jmd=z;Cq+;`eT5oHmX^qUSK1w|SregA7
zmbbIgx<=_XA4MjBXR+6VI<J>cM(W(mQECF1hRqLd^ZF~@Ym9Dj5%MH>4tq1G_l{J0
z*4W(YBI-#n9a|X8^+qcLYe=`b2$=}P*xSK;?`UO$zp64t)I=b`76l8uNmYWi!bWj1
zk^<7OcY+3Qa+PSUtWjM|rGOcjB3R^2sgkZ$Hkyl(N#J?xy`a&XS|wkrYh;S4NkED%
z36^*Z(yA0|jg8`C$W!12?1P}mn_i__Yim>=qn-jYF=epKn^C1*OE#L1AtLZ1h6FEq
z7gXuja*fO}N(5$M%Yqi~;wr;hVUzec@-#@tJ`P&FORG$4Wliei)YD)#rV3v6F0Zn#
zRW_NABa^{P*k?hTcV(4*t*(hVPE7_fY(=obn_1;vYitr5k!Qfm*cU;&H@nKS*4Csp
zQqO=n*ec%e%Bc#hC7aAfWD0l%TO9=6ysE@nu8A>HQ@~tI6Rh<XRtdDiX7LFm6=Yy*
zf^Khdl}IaVR-d3!!8}YGZ1I*>Nwvym^9f`scokb8B)#QTa;>hJIYCVYax5!&!+WVp
zp*1#(Pa@BP*RYL2kM~NIN^5IYpQN4zuVcDkm$$M?t0kMwCy{C34Qxx$$Jd?dwOliE
zl9~qQW7~qPx30>d6}E^^A<uyY*!Ez++gfGP%39Q?sOP|&m_B&R+gWARDqGB_km=wp
zY*&!;dikWRu7x>8O$Q6H++f7(uX1aRE#eYH4E~1g2`0QFRUWOaMO{LP!P{7V@UAyn
z70{9`<`P5#{*LVr-uI4HCHT86ri7A!MOZ=bp*QK8V4bj4T#BTD#n{21pgZ}RXq~K8
zT}q{acQ8Y6TzASf={jYrxfGcJ-o=gth25#w<m+^;Oer-3D6pd7#O}0figm_T@oD6F
z@DJ=*P}H4%O|{O}sy<CU58lI!!71Gt*R<=%R`Y2@3f{*~2B&o|xTasnwKAtEDOiG)
z1SQ>zuNl?}+r(#(7r;{NbWqy8^qOg%tWAA}dI5ZZnS!&rmtV84Q?{AUATz;-*twvr
zd*wCzI$axchMEbKSXppxcjh(sI%AvIguDno!Y%~m-PzYX>uham6ZIlMu#3U@-8t6+
z>&P~<37G{@?3>`i?!0S>bsW#NQnSD^%o1GGU3g8fUf3=^i=>0)*tbDNckwmRdRe>r
zER_yE#;n05-KE#0>y_>1v&d}l3HDu3*<F53zFybPoTX+16?Qqetozb6#d>4A_#E;Q
z_!Rp-sOr9QO|{<Eu0BV-1U|!T!4=(=*R<=&cJnzz20q7r2(IGW@AT`rcIF%<11qqK
zpr*U-nqj?=6rV?41}m|uptig9nrXd^RG+6_247(IU{-hMHS2mMX+Dq40bgQ{psw4?
z2d8x;bDo+5R$+K>Tett3d%ckqmm#l!uP|p&-#v28v))Fk%cxhtY77K(yQ9|v>q*jF
zhRg+OtU8$AJ$fy{-*hu&)Lfv!YJ&ycNp`^oVTZUJ$pD#HebCUIY!_{ib*Rg!46p`s
z2aCE>?9vU&4s$s&53I$Sg2wKGRJ(kGu7fG3<^e6%5-jOXvnw_jJH!`|SHU{0Eokaa
zx2rbTI@A}aSHXIW43>3g*tHwT4)X;>4mMy^@M8A@yM6=L!Cau^APc(@v~(}F8#V|j
z@z=;}ARD_Gw01AGn>NTO_1DyEU?b)UUhZCQw{B2U=C6_0!6xkIpsjnQ-M&FbF<(=!
z10B}IV|1Bz_XZ;+zKFa5He=m<8a3PQ*<hp87pXVE7R(pKyL0S;4J2j0h|C9DvA!Va
z&a)>raJ<$_%?H~sHdxzTXcuG&Y4Jai1t16O54yXH?V>Cht^Oyq0Bpws!Ith)yEIEl
zoBxTt33gyZL9)BtF3-}@%s;6&fgZaRywQEhuE;Xd;%|_*z)tLT(9?azuFA5}>TjsG
zz%Gmnc6C?UwOJ%>{svhHc4MKSubZ&zvpAahhFS=6u}F~ZuCp7mgg3-y<ZmDkiv<JS
zt#(tE?1tJ*{SEBF62V*Dopx)M@`l-rybbnZcY<8Emk-kGZZKx*ZIF-M4Mw{Cc6XNX
zhS-Aq9qhyI1ryyPc2Ab=hT1~?9qh;M2k&-A?SU-vhS`EF0tc`M!Ta5#_5}YB##pFD
zpa6RqeAu0IU63v86kkFXgF<XfNYImfU6d{BR9~VNgM*kLG_EJ*x-?taX}*NK0}f$h
zL&Bca>+)<}Cv%B<2N<w%p@}_d*A>~uPVu+MyWlW3J|yZ%zpl!*b*jIm-UUZ6VQ5NE
z#&vBr*=hb3QGlb^gwV8}1=sc2TqpA_r2s|P#E_(C@pVJC@TT}*$Ui_aHYp_SS$f@+
zExW1y7xfQt3=@TB^(?<`%~swt{|k8!9LFYyWIZdd+p~2ynSW950V6ggG`A=7x;xu=
zQ*1@v2Pd$pA$d>sbx*eKrrJuq4^Cp!Li2lat_QNon`SGr1f0UAhZgqaT~B0lywyxC
z0VS9uw5X@>x?rR5NAbUrrJxj>5mNLNUl(nZ{iyyowG^Djq@g7}rPrk!l|P#QjeG#k
zU^7F?p7QJRjk+J1e^Va-6E-Wftmo2o#YW?g;_r|T!C7o}NY!)Yx@x2CNA-8qhu|D0
z3$5s>ysq6y{%HOVQG)Z>oX{%198<rM`;qyMQi3vUZb;Kpcipg2=n?-1`3RI_^FrF5
z*6XH?GLQN{)JNa~CJ$xxbY8b^RC>(+K@jjY_IgOy<K_1%bROnE6ap?{^F!Nu{MX$Z
zjUMr31O@-Z-VEt`My`7{+C1vZ6bin<7KU<rqSpf(Nssw5vJ9B9w?p|oqt_GsGdXja
zS_UlGqEJCkl0&db_>=ewvK(B(-U%6ck{zN=vY*sfsO8{WOc5&TDM)chHz|KIUqL<w
z|H9r28GBM4@=dy*m@CxBz=|yimGq=J6q}4ciN8la0sqE62$_1)9jZ;XpVZ$|pMdW$
zWvHwt!=c?o{$&0hQGx$pNa$kE0*8JR_Y?Cyr2?0+Wg$z?VuxXq@MrOVkx#)D?BkHN
zXQ{)qN%ph)ztpGTdrTF&+_T(a-K6~4{9oiV@L%k+kgaE>!@f!PGxJ~SGhoA3gerP6
z9qvuWpT#!hbMQaxi;%r1+u_+{`&n(HJ_kQwt9T<c#}U{>{%p1(E5KE3bqMt2ITD+=
zpBWpq0#sm{P;F14L!cA>BK{w;5>#SqLhhbohe#*;Mg2c&C8)x*p_ZOfhg7Hh#r!|y
z3vdlvA0m6o9de!S7v_J|7r>5Xg>Lj*awv4hU&KEkUxMq{#*nAyibJKd{i6PX`Vu%W
zU8t+4(xKInznFhORsjs#67un7sd^pv3-bfD3gFnb5ZhDdFzAF`;;YD4fWWqg0zIt`
zlTOy9zDj)soR~gztEbap)hWBoSCQ4gh3yJ)Jzjp#M%Tq$rB(xg<%S|XeurCU>=IWX
zY5=i4p+wJ!!=tlxsVgWosK)X`cYC6afR5}kS0EZtgY6I9?-_L@_!$jTL1{oORuFpF
zlY|L23%%k>BoowO2SWm1GA7zA^QtSUOi+&*LgRcXm~^w!Ypz7rfClVHNa#z&<ePO~
zrjl9%+*na)qAv|oY&LquRmfV<h#d=weCe2Kv(2lnqSk^Y%ov*D%fPgoNw2vI(Sl~|
zWN4ai0jA%~d6_Co3tF&}ki@qbGi(-ii?1Q;Kr41SB=s%DOq*rh>TA?G(1w{pvwX`j
z>t<!Q`5Lkwv}5N&GT%zfzFF7JT%*<l5-SVM^<`r2&BkuA9oYanunQr%FB|i0wsouR
z)CNFd7en)XIapvb*=@EXS%AjA2`%*HVTsKg54BTS;09(1E%Fs&f-S-x@pU8{bYkCz
z6ux3iv_;mVzD{L>o0v7U#8-+*w<vqe*O86jN9?<h(pQejx9ED9>(oZz!7hiE`7U9K
zEyf<P1K9+A!oClwd{;2l7F&<nL2Uv*W46!=UnQp9LiU&)hz|UM{SaEkSLf=ta6OEJ
z(t$3lBBb%vVTLV2pBO_n120w;()wC4(-xUejZvFHH)aoI`8qM{7NyUOAzMHX<_PJ0
zUViOL=VLHx3-DohXq(TExwja7VjS5DdNF56?;F89TWmfxPHhE!7zpM1qF7)H=`-WV
zHo#!jp?u#cmf%Nr3{GtWELIyT@Fn4bt-@Y0f#d)`Rv$9>3X*ZrR#~r_pmIPz<_;D4
zQgG>3Wv`h)wu1qzDP;7e;_|J!UWTByg8<eND)FV^imk?8u@l(=2C=q~$(N3+w%U5t
zPHG1j!pKmWF9X+ZC40?IL=T2BDs<7e0M~EjdKo9B2e+^rA&YM@ZrCd96T6U|U<A7v
zvig?drmeC*wTs#bZeyO%W#4k#x>ea{b|JgKuh`Ean{Op<->U0lT+}YWVO_j_n~A%(
z8vDcm*$skNH^2RojeEA*`qY5h4MLbNg!^*vz*e%)43Jz9#`;3Qmxm{|a(xV-azO-R
zL$$s_T(C{Zh#`^(qF8^(?JLGb+hmLyQh6YT1wt*pQe3)C$(SLs2gI=<-oq}(<=b=&
z1F1bAf!zw-@Lj?c+l-938rche!)}K>zALzDn~hOdQ+vT3j0<)7Dsk;Lk}+2!`QUdf
z6!P&^%KB{_!&FoG;4T*7x!gM3uuaH{Ymj|l6pMudzE<3{O~$HgsD0obmf-hiI&teZ
zC2Ouh_JcpLJNzKU%dg?-Sf+;B5AI`kLlK`JcW*PY;#%YY_!GMqO87=_&o&#YuB8ru
z2iX14U0)OrY$I87Em8pf!XAX~`$q8uKf+~dsRHm2dl-7?OCkh0Lch2UDFjLQn6RKX
znGog3{OUTY5RAbE;c>kwgfvI#H`gHt!6W$Cu&_6kkmu<9OdWL)2=H;?iM?rrBFE?#
z*CU6(qxkr+s5hNZ<=Fh{dg>4uiwnb3dNT-Z4(T`7BL?soJ|R4<cLAZ#;rvWJWdP&w
ziD60aV#1Ik>=!p6he0wvDJ<<>N|<tF{ptqlFc^=E!n1mp6V@DMzqtW90v^XFhh@Dh
z344yNpJ||u03kjlJhwNKaOW8N#ct#%cmkgqmiJ~8o*Y}h+D#n=6Yy!_`Mo(rAcyQX
zyOARBBtAX7us4rL<Z%6rn<@emaY=YlZy_PrE*uayBE=vDpAlB{789cFvH^7?RSYKK
z((sbrQbM|2Ibd!?j)AA}nLLkPPRO_G2AD?b7!cvJ!pnLu5sK}`0dW&@96XKB4y$^v
z5UTCA0d*5~98AV#;T64=gmybQU~WQ;;2C^QcopBQt>4ZKFin&ZOu^@dHNAC&VY@IO
zZbnXkRD51o+uKT*w#x$QX6gi(ip#@Uy`6-0yE0&IMoxlf@z=w;UN66usS7a8)JZT6
zpC8`V>nGgXjRA2Batb_$zZur|ju4*hwt%{YIt8ZV3&Xj+Q6jLN447Mx5+KIk4(Iod
z5($2y&$Lh_K!Ps{7xWe+IR!g}gW^`C6r|zrgblsPPSFn8pt_YR1v79(xTrV9DczwQ
zG`AwB!SncgVPkKqQ@%qt$h1<YffQd7F6m8kDs~tL#cjwL@B;op*wmZuRPC@0s@teD
zU?#2%m-S{iwL8c`a~om;FXBk}V($W{eg`+mv{5E73ttwt^e%Q9b_j>W?Z{b>j(;4s
z_AYgrcF2a*?bKN?8&`!d_bzu@cPNL<?Z`Rs68>4(*1OVa-=P~~+NpCuhOY=$^kzEU
zJB&kO5;+fE#=i*Ld$XOM9kwAgNu39C@KwA)p5qMcAcxE(QU+eZSBF7wo-?t78)8VR
z49vwf;o9Cpr$8?p7Iz@!AOl|$cJ~%LMS9t=x`QeQ^KfmrrMJ{6)hmb19moanD!x8U
z_Le*4dfhP7L0tfHJS%*o_mWegHx7#_<ZJL6zA^0Sz2a2qZNqAc`Wn2B>%v{Vl}@dm
z95z$PMeqi`CG6vy*7bUBn4zePU_QPr%=Xqf4SL}%F^&8aEWo#i1HG+IlU{a9O;i5_
zZ{qs!t=>+jRj<5drjc*JTllUp*X!lCbal5Fn)(JT#B;-uUcb|=H{KH8K+NE8_?~d0
zcf{$@+it0EP-gHpo*%y38+8Ws<Sp|J!~*_~?+@Sa9d#!76CUOUWdV!ug7CxMB$r^P
za75gRTmp;ngJD5mvP-m6HlpsNE`fJ&LwH<Yic7jvIb!Zaz6I~%N5aCsRF{0GZiMNi
zz6A=rC_J$*&866B91-6{{ssPl9}A26(p{>Zwh{GB>R;eJ+!&tHm*LXxBuC6Q5i58f
zKN+6Zx4@;}$&D~KDJxilmxLvKi(Q7D!rS5>k$;1w`022;Z>h_)Q+8YZBlU0a0d5M<
z>Raxz?o{43|A>4CKE%(3Wqm7M_MN)h%#YM}K#7-y=k{f~+&hi8#UA88;3ND(Sl*ZI
z^6a$TR(q)b00h4np5K?_3hX3rn?1;7fa2eT7xv}35<9uujEA}mmf@E0qP{|xV3+V$
z@lVJVupIw3tmrFtiFV0;RsTd?0UzVm@RGh#mvoo%SMyKE_uv!!yRfpa+$G<o`<3~L
z`W~q8%i(2xmt2Zn#$UxhBmV`T;@^i=eOFwnUAAA<KU4n&pW(LfioQyhb{F}p`Deri
zKF5Cuui}gM^}D!VnV%^eSb<lBHGOq1!!98w{ss9TSczAKwSBEF(=HjO{)PG<_yV_w
zv-&z+)?G@@{0s5}_!4)7b$wobX<NrJzfeDbRX85r*5`M*cNsZx7jhMRg*(Igz7dya
zmyJ_*QCGog9E5ZGqOQO$k~4Q96+n$whx7XiMqP<r9LID~6+na6h70<VfMB;UDE1<i
zAQP_-8~T!gXtyk=_EME#4ekyX^`!vmZe`HyMXJDByeVw#O9k@Xx*+4Fs(==6377Px
z0mW`(P~44N1MBd%u&FN{sCL_e>Tc>9SdWw8vc3$U-Ax9~-H07*z^U-Xz6C(Pn+r1C
zlpSQ@H^P>_#lWyz7!vm&*FiRZGi>c!3QW6YA$1RR9c;us;mdu?fpxbsWbQ#6U=#jx
z*w(ia*mvtfOb_J%I=m}f(U%F_yNw~S55d4@yqjOQ%?6&`wvgIKVPFgH3*&t`Ah4SZ
znSBTjw&HzZ(3b}iySWhKqj0bdXT!C9g+P!i42yda0_5QRVRv6K5ar6k>RyTf+wnlS
zrLPo7bCqFpFX99{@S!l-R}SR4x-ipAIe{L(6~57T2`F-nVR0Yg0z2{BVNc%`pvtv{
z)qRu;?83QlS6?O2=8|D^9|FK`JQViv5Q9FK3p0Hb0J(T1%=Xm*L#{9)W)KMS@K`v|
z*9uIzvWS|YAlQQ^!ngW5fi+hdF*8Ut*o)r@bA4WZiC-6C7^)iN<9EZ6K0k2h8Y5yB
zsR8@&d*MXi2=L_EB5IbZ0sHa$;k$iN5XdDXW)`Uh2k-~s`+cJz!5;uKEL95%@Q2}t
zeMwM|Cya{yNF6A|$3z57G8E;>qG~@?2M*$b$T%hiO7oOavmdDkhw!lxA(IN_dAca$
zr|N+L9~YU(q(McVF)Hpy8o*(Ed_=^gLsgzFs_v&6z!6*+nZjg1Z5|ml_akm_6rT{8
z#w>vPJTA)gQ*Ka%PmD;I#n6x^jEM)3Mo^4Tib$EI(3B^OsRyV=a10kkW--g5HBT8c
z4<Jq8I6gTdV^%_Yo-W1=P))#yPl?QBGNC)q7!wDOW^e+Z8j&;E(35A2sRL9qIEhb-
z%x7|7Adifh14s)vg-?$xWb$AlkBcz@ss)tblE@;a5DNAP<KjW26_nyLA_}G$iuTCj
z>Ora%oW`Y*B}^%l?or0ggGd`VgU^g8nQ|!Kql+_xR2wkivm(owOHi@L7#9yA?cgjv
zJECH)K-C^wTs=g!gLAknvVy6E+C604JcN+oJU%C~ig!8md$>3=M3JBjpBvFIb<nU!
zm=F&m9iSYa7tu1U(6mREP!Cfb-~uj>WHFu4x<{EX4<i)#8h<^aW4wH)gD$}gQxv#}
z&yQ?l{LsC}m=NDWXz)+`&4`{Efu23Kg!&dmgKzMKkzA%A3Ilt{g!vY71DNr*Bl*lI
zOzhzj%q{8$u;7a#1x!-4V6X5u@d(lhF5&M)3`}yhXs_%y^$67ozQq-hA||C;x>xy|
zc?7u${)N96F*2#u^1Zs>m=WqGu;NQ1B}`hiVz2Qx@onTs@NfKsh>1zBR_(R@roK)6
z2)@IWkuoNuTDzD0&3qg2fdAk~<RY`6TECb3jk!&Ez-4?{#KJ7DHtZGN5&w$(1g_v8
zN36`!YSUiX9rdr&PvCo86}ikTueR=0-ZB4*{0#n!e-^PZE355$b$6Iwsh@!jUlFNb
zGOOKtjd#Qx@(cJM{zb&jWLJCk+U}@1>KE_>zAAz<In{x^<Q+4Ibb+h*>Ih)+suO#;
zI}As4feKs`sbvbQ1^L3?#X-aiD)BWDH&a|K%9s7F4pLrFg=-@%Olh?=U-`Q^h;)N%
z`1%ORlvm61b-yz~svFqxtjG=KQne!A_`5iS^nmO5#)yZxQmx9j{jLsCJ-~tMB3(>n
zwKkvp-5f%E0K>OLe7w`5&*y$;LX;2S__hek)Kweug?Ghaq!$qQ_DFzftv2P$?yAF7
zFL2`e$StO`+M2JtYYroQz=iLMaEzDl_|V;D!c-pscy1)Z_^aLd#=GJO!T^Zxi6oej
zYEQoHt~x?7pc>DQ+-0KGfqe3=IfAgD2HzjK&x}?l^0~WAgknK0UJ!Z6B-IG^2}i|I
z#1HE5gAoCnTqD{i8&yXs-X_Nlk#THFjdY)K)Eq^4YZyNg5wfW@@_o8dCQ9`KH(nH(
z$fngO_8CXTF@(1O@naDYn_i>ZXB$<=DBkwMjgcvAMvZnKIckm}yw!uBj7(z})adtd
zqfCtA?G3ynB4HQT81@P8iQ@?0rH`MENZF+|rhT$|>Nv%BW8<dCEOvQ~b)WK{IgapM
zxA?h;j9pn{->19B#Hk@b;$@M!Y-WvnpYfhJf$&{)_=Sj^&93q6v)xlCD85??zZjX%
z=F|lCk@w6Ags+Ohzlkhl^J)_NxO+^3;;SEUOJosSSR>dk{6qX3!mo1U-$oQ{agAud
z><{&C6u+8@TO&)@(i-W0<satX5PsDP|1P3r%WLHOb$>9wQT*xzemSy?y;P&vZ~Q}i
z2jQd8`1cVNd!<IT-}Z<44#h_saa&{sTUn#sPyS)PgYZ!${D;UYp6$`^=l)>sP<-?N
zuZU>ax*EfN;eGM%2!E7_S4FgJYmI5Y?7sSUia#2_?U5|Dv&On#dEfjy!jJlJM?}YZ
z`N|jFedc$He{{$3$Trqr<KAz)FTRWLx8k@nqGt<6YCQXG_tkeP{@RLzNG=<#3G65D
zo9`n0cLlGG<g=qSiT&Jt<}MWhEM6NaV3TSE2ZVo$N0BJ-<Mj~(n_Me8Ap282N<~3G
z?v50(DYeoA%0JDcNDK_%O%WrTS}Q-G`;!@^VjzIGL`vASTEzk5pW=H+91P-Z5fhtU
zt2$u&Q+<z$gCU%Zl(8AL+5_aD=6gs24C7SfBD<hge}Mawxkn|yE&N8r!Y-~g91uPb
z|AG7lM(~>vE4#GTbU^k%{Rj0MxQ%-vm)YgD)&t51=0A`-fX|dhZ0yQf`vKhp<`3!)
z;3FQ93O2LWeZcrYd>{E8@Fy-2JDXkWIbeIBzEAxQ_yI@+XLD);2gnEJ`^a6u-;eO`
zL0)a*0QZ2oPu&IlpCh$wVXdG*_?P%kWE4d4{)n3`t`!x?{!;%*je-~+h_tY!wbBCR
zU*<oNdmxSvMM$>1R$id{i}{nf2NL+L$PM;Vt)jsAm-qql2lx%Y9r3VNYE=ccztj(?
zKfoQF4`{HJwb}ymFY^QBKKLEyrxiToq%Yw9VjfWU!CgEOVcEJ`LxJ$2_%Gy7Fp9?_
z0k*Z)R3Lk({)_q(+`|)mWk_eOwLtmM{1@^7{DI$zaIBZF0Mb2V{-Pd$`}ke{Mf|ny
z0^>vRL*y^;Cw?!IU`J{_1-6Ikhtyx-0e(MnmyOm23do1%hsZ<l7yck}pB=4D6mSoj
zhtxyx5PukX$R^bZ3WZ6MBs2*o5o4kPe{!9uP?n@gqLbhlLJ%G2PpOj@Dw8Zp=ot72
zF*Yjnr`E{}bxCXzJq8MhanXtXv^qthF-bB8eFQ#AjE{=^>2<0?TasoB{RkXO2%}T{
z8Fku1GRZOq6~M=c3DIf(1$FvDE{PpO3*b0nVpQT^TxTd0j*&cqJ_?hGNl~ePX`QK1
zHb(OZ{U{tyh@!Ln%j>L#$}yHl(6R7wVscdGUs-1_)Qw>up~pfYF(o?JpIPTFG>(x7
z(8u5t#MG$VpIzrEw2jdS=*Qp$Vp?>*Kc_BGNRF`x&~fldVtRC;Kd&xP$c<qI^f)+?
zkVF^x3+n_2g^x%cMU!C)F(az*7uSgn${x`?N+-ifgfzOuUs@+UsC>loC^{ZKMa+yU
z{pEG?gSto9N9plUM9hjV^Ixh{95g;68H+v+pC)EURsJh=s)M#iG-K(<;bcM<UE!~+
z(;g%rv5ZB9@EKxGbQQ09=?`*`uw!W<oI=cvYW#I|hJ!+Z<T3OKm`coxYW=Nsrh_tp
z<}vySIF*n`v;3WP)`Loc<uP;ue3p1Us`Gp6><4uM_Az<_oJP!#Zu1xT>)Z#80?9b^
zN%$P`W>oJVsq-AP2{hyAC*gErVKmnttqU9^1(tE>L?|ZSj^_JE>k<b!0XvSK2qna#
zXn{YeUT{eGs3aLpfoa4$QG-9ZUUW$Is3w_Cfinn2w8)=QFFmAu)RK%&g3lB0MUDQ{
zdif#Uqiixg2}+42(Gq`Jz2cDZQOS7pDfj~MLDb|=uU8$iJ*pW`KLuwJ%4nHCqh5Q6
zeAF@?6~Pw?Bzn=mpk9B7dz2kdi{LC`S=8cRTyHoe94mPoeHx|{A4jeJrS+ymvay=S
z>8IgrLKVI2UtVuLq#SE`9GwhbB0h`S{44A2hje4v$LYyXMy!Zd_%rL>hm2z-Li8E<
zGVw*!?$56G9I}no2<d0w9AZ@z_vh3H4v}LmLUamzg;>r1X6Dr=4sl~yAw31oB{b1m
ze__4AAbd>n1eyvnh&55SzqnpxkUge(f=-3=2yL{*Us^9UC?B&tflh_566>R+zr0><
z&^^XJK~IHpA}e~sf2m$!Fg_-kfIbUfBQ{1o{wwt=gY7ZR1o~O{I-!ep`77(S2J$h>
z1aumFgV+-F@yeUtz&*xJpr^t4#I`8wud6p0gySSnqR+tv#P(>w-&$`n$i``&q@ROt
z68h*Ze`mebpd4p;5}gj;B6dYNzqj6Q(2ZlCq^HA$L~b<V_t(1(#&ME~s2Ki@*b`0o
zN9sKW+c?ccS`6PN@}qbC(fWXa9A}w`O5op#{n7jW(fWje8^=zhC2$c@5Pj%RY7iV2
zCQDM#G`N^J7!~v<H;4|)k~JxG8hnQ^M91}~G)NCClPxLe4EQc_Br5DrZIB<<C9^5?
z45%QAq7(bm8We|($&yLv^Y9<Uv8bp&y+L)@maLgXKM&s{jL|9m84cRQWU^%vDuwS8
zC!^E)7c}S(bII%^S_+pCB~eNL;s(QE;dseY=nHTuaXKpPU)o?gEE}(RihcopK$xPl
z`j<CY4=cx8o<e8B4~cV8S^vrg`(fR9_9=QMR1#&;x&4_9?!(6M5)t|${D`;^mG@^i
zcn;gfYee*m5Fsu`=lAC{1P+tqEh2OlM2T;r3;XjL5{J3*tcackml2leqW;1L!4cu(
zlBdyhxSaSls^~9n5FL>{u6deHhaVHx=#u`@2I&#y<Cdq<+3*wMyQs3iyg`0M_c;4B
zJsYZs%h6^1ml_mDjE_quqc6cviSMJT{woctBeusilj)b>XM`=fqQA01dxU)4G8vV@
z&xs$Rt9bNJe}sFSolMK%3Zf#a>91=r91#j7&!8{El|)rk+uzz?IwBKlo}picUl8_a
zR)1%M^@vhvc?O*Wza$({U4MbM!G1(1WS^nuz*Phu-PZ4Ka33)WB~#E>;8%n*s_!3Z
z@EoxTHB;zU;A#RybNizWfg_~QG6kIr)kJkPzkjqLafB1HQ|P%+L)1nK`jgy(qrxX7
zsb~hwB<iDv{$#i4sO$+%DxCq>5Io=BpW>DtRX$-!Md!h_L{rq*pX!z$)jh$c((|B}
z;BmA5G`HfY@d?RP^i{Zy;H{DVbhqlL?Fr3P`c=4|;H$s;Gu+yv<P(;us2pw}_$JQ&
z1#bOO?g@4(Er(eIUyRki*ljo}oFI7?eGO(4d{0IHQn%@-Y=Y)l`Zc(b;MYd`m%FV;
zl@lz_qOZeE1i!`6ztU|#s++(*OTP|v1RtvG&vd(w8Yf7mp>M#=1fOx}&vtu`+9qhG
z(Qm*l1b^hvpW_Z3B_~*>q4VKZf}a5N=eZL{xe4qvdOqAn@E7F%Lbsqu_@v}HbOFpE
z`lIgtVz;PB_N3-HdI8){1fnhdrEY1F@=42c=$mi{F%%{H%iZ!K-IMHd^qWvm+=|}l
zzvNaF8K0C)N8f@wiQ7?6{}s2Y$o8aWI{g;hMR3us{z|vDh<wsA9bE`_6QQWDpK$Ao
zxF^}^^g@_RM51heo!d|(oG1~ae}j2MEE?!<b(@N06E$M`Z*UKhh~Db&bX$v*6D?x&
zZMc`X6Xp87ZhMh#A}glfhWW(ZXr$lob{82ZN+jst;XdMCG|@le_7vGBY9#dE;eO(N
z^e+GZ1&YXt774lt9v~h>@Ar?o6GhxaRzfd=1;oSX!~Ud3L9sAJl7=pZg~XVcU?90s
zR4hx;q|uAvK|&B4H;~dOEmo#j($II{A!2MyIFQ;XFV>~7Y4khLK#Yq`97t<a6dO|{
zGthV8VPbqtG?3n?Dz>F)X3+1#BZM$EWgw$bTTG@{W}pgql$a2kHn5;kU(BVjGiU`Y
zA|}Qp1B)9C#llIF=h1(_Vq#KEI<U0SR4kjMd7l0UJVuCOvj&zoT8ovFEYG9wK_0n}
z$p%(7+KY9Q*yri@AaB~o<_=^wx{HmIBvSN!c!HQ3lMiG!dWvn6G*bF~c#@bFn?I1#
z7$_zuS)}L^$OHAUg#&qwiDGUNE2Wn}-lLB#8YpZO91}hzc>!Gtd44{o7$|NO9g{t!
zd4XOEPZQGEl7Z4j=`rO~mKV?uAdkz(lmq3B@?*NE*ca#zAaBXXmJM8LR2(xtC7FqS
z2zfd_rW&}?s5)kQN;8xG5S}Asu@wWAjoM@6Q<j;i67n#7Y!z>U>W^_xu`_8U<Q@2!
zW}vRoa7-wYyoi1T%ZYh0?Lcdz>6lEUd6E7IULfSLtbu~gM(Z)9$nqkJz^{qdW4Zxv
zqy3mp#J)%)@FFokwr#-Q=sso?NoJua<jMA!eqf~0bIc~v%%V}q3+=JofoNmk7%8&M
zLYF}vWRK+!j5a2YaUymWy$tgHdaPg|sY!5L__QP)T@HC}J!Tk4ZW0}rJ*`Qnm&0!f
zMXYEbrAc~R`Lrb+{TT9?ddxVG+9W@&dzwwBKZd-W9xEA0Yf>CHJ}sGzegb(aJ!Tq6
zZ&Dq%J*}Bde*(WFl(Djbj3(`I@@dO#R0VkmJ$7+mL6iPC_cS}3Rzco9k68v5HyMr#
zCre&JKZQJV9<vTCZ89B~P1d|be+s`RRI$qg%bTpnm6I(mp`Sq>F^|~>RyNs>>n5`=
z(Vs!yERR(TWHz~v8z)O-=;!c%#1}F9Kz5VoxNWjVMt=@}AXdfjft;qmadNUnhOU4-
zK+Zpt<uxUabCX#ay#n&yc&v7yut{JPJ|lS<T?u(!JmwxKZW0+~&uCtzSHdbn8*3RT
zZIT+5&sbhYzkoa*9wP_Jo8(5_GwjRs7m&BYV>bpaH7Sh7XC!mbFCkBZ$2<d9np8&H
zGnzT{m(W4zVqF83O<E)QjAahG3i9xG%r`(Z>5beo>>PR(<el#rJ5bkTFbbzgUO~Tt
z1hG997-(%W8D&#6uh3sXC!vqs8t81Y8kJKlub``;i`W(82E0vnqizcO3cVTvA~zNp
z@He@Q#wn7ys2cJjcPue5(&RDPrfBBUYRCiJvAYA&rht*0VwsC-An$F*?hlMMC5+q@
zb}p@fJg*&lIFQsVI3Y}xWT2U_jyM<-1d^LYCuFIb3_26m6NcEhKuWXpgfi8Vfv$lK
z#F3aVklHLip-W{m=rzzy6vZY6(wY?~jH!}&=vvrF9E*tp>CLJWwp7hLdM#`sjIk+!
zjArc#GSxB<)xu`tWNcbsL9_k@m&(qgwXlUKiAe&Bn++#~QzfsW>tHK!IwlP)Z8n{d
zP1U?guY+xbDK;yxyxDp}Io0wix*oO@=VG$J%4Yis-Bk8fdOakGve?`}X0!W*ajHa)
zZh#%cg_t~$-RwDGo2rr18z4nojLi?^GzU(QQ!R2d3(~|lv4w%W=EMnZDl4b6;0?kO
zTNEg47Mv75D|rpghMmN>F-4%bS#(nNtmZX38{Q<Wu_b}hX6Z@gvzFJ;jqpd}yO=Ui
z-Yh?<dzO8T-U#{HhS;*erDnxR<Fk_2(M^zF!;Yx}SDIBPZO>|6r#Hc$30rJMpt4ze
zl6=<kI;w;GnpA8RPX_Bxa?i4_(>lnnJ;XGDx@N;k;WWt`=w`^rm}A;NL2I+=q->hz
z4SF-=bBVF6Kxeb{q;i_&4Rj0Sb4D>;z}sv;shh^WL2rS4ZXmWT;BR)HG)|MuN4G-$
z95AL2j5K>r+NNpd(_0}w*N^1}qRoMm<TT5CbQ|R7bg}%vXmjEuH;tW7Z-e}EcdQ_g
z)FL<~d`_|e&4K)Vbj%P)ZV{c5J*Qbf=Rp3t7%K{-v`9}WpR+7Lw?qDO9y10~TjZy7
z&#?>W?Jz*J#7Y8bEs9gd=Ok~UJK!ME7BdCXTU4iP&uQMIcfcWnjFkm4TC}Ig=PYlc
zdN@o_v5SEPE&5a3bL^Y69^N8u#4LfuErwIV>5{k5op6M>8M6kKwwO-Irfc4!cf#9*
zCw4ioyv2G-Io<LWx(ohF{2a3dR<_tr>87)9(Yqi=bj2zHnJw;9#_5uU=x!J!x?}c0
zc8lkfZMtS5y&HxIA3ws#X$hPnr&|`HxiC!h@iUyfmc%J;I=hh0g%N^{)dmV%1SLYT
z<Zoymj1v7Zcc8dMR3Z~={zm7)7!ioI1WH?^B}%d7Z|EKvCx&8Vpu9z1q7$=!qxZlB
zaVvHsaH&O6ViZf>M)$(sh}$tw;7W_C#3t6fP49(w2rkwYsBF=ekYdZ*Xg>U%2*rH-
z`=~GB#O&L2KD<jrVr-zU#ZV%YNdAuQgQG+&76`Pqm`Y?4&EM&L@E(zf-3oNJSWA==
z%iq!c@DJinj0<>M>?Jx0`*(UjyieTa=O+FZcZpFVS%e;de-ig%iNHvUr^F`FETRv<
z2gLo@UH*nDP(n&9i_il27x5r=KQP*oDB&dRBDw%RBp${d29jC@rNT7HVzdzQ7;aoJ
znA|EVm8EGG(}i%1QxG3Fn9?dORi;@MqX!{R-NuE3sjc!-T^hTXJ_vc)Ha>AMtyNKK
zOq0BW9)gcL$Hzs3>8+|#Tbkw_`VbuJ6vn3vX0&Qc$u!G5r~y9aoDiQjxS&;E%B8XI
z&;~fpIWaC7T-<6X70!^niynr_&Pj3U;L=u8sceSkUHUK_?-a#n4K8oBmMUjh-bIhV
z$DNbovcZ+D_EOyp_Fei26gsEG=MHAJx=W2SBntE>e8M?3E+5Qp^_1FXXcY8OIKeqB
zK7TN$HBd^<uqe<X_@r}seBoeTYoe5!!7At?IMFGIFB&Xt6`U46FZl;r3{#vl;)=oI
zR?%tM^O}Fq#c+~S8ecM4+A2M*eBSa8^cZ}~IWw*tEN_*c);-VugFXgD&ROwggO^$r
zr;X1`-b0VWr=7Fos=+I*s?)aTHSf{K;bf;QzGASlRePFz-tr!5gwHtV#8>g6xc)Tv
zJo_GPgj1Yz<C?*Ox>mz!p;YoddIF|8=f$;yt*xfhGO6Z$`UITnl*h9MJ6o-%l~T+5
z=t=mj^YyrH(A#Q1t&_6v(<k9H=luA#L4T|Jv{5Qqf}Vmrm>Sm)j<kAC+oYN$^eM>u
zsPWvvXlvj!DYYy?OCZmo#`6b9TN9@_DZ7L&fxLbiFBnW}6PyvgAX$o*LLNJf8wQix
zL}z3#XqM8YaE4P6FB(i~lb%t&U|EWuhCF2&Hx8z@$<OFsV3*RTAupH4O9s>06laVt
zNIpQ%KprZMn+DU{RA+22Xg;9Nz?n{EylgO|O?!rX!SVrWf;>YSzc{#{O@D@af&G9s
zL0%n=TLu@m8O{i2N<Ku-LLM27TL+i6na;>&YCfdT!r4w${PN)PHtQMXOv{JpImi>D
zaoga^Hv1XfO!h<i9OT8&c*S65oBND$rbLOJhc7$7h}#FV+dOA%Gc`*3Je=cP6~_m2
z+5%_DnHD8l26_IIpZVssCC+d&StVTtdF?Y^J6PBzFbQ9je1w)m9`}s92aDT8CfSRc
zkLYqZ&#8^K43@S@P0AN7AE6iEtIqXta<IHjZqmKTenek@a%Wcj#^9wkg~|A$1VO)s
zuQ@lyJ%d-;R3_Vt8if8DzV6h;y9O)Uv?lUJ3xZyRZ#cKaef;mP-o(AgBJ@Q#-?=T$
z4%W39Ou|_b6#XY$;M^V$47RqJOtM)Tl>R4t)2WZ&8tiPdnv}CFDEbY2%egDg4SL(`
zCfzI+rN4m-ow@PIpuf#+GR~4LL(P!)Fyo2Akv5OXHcPXNHbb7jjNcuMwgpV&EXy*~
z0(tE+et&SZEn(tjvCC)+<Z;XR!@;C>!C7ItWI1{X@|I;>FqGUbIx9=pET=EQcbta!
zxS^DG=~-pEWjXpS<fY2Ea45B1epZ*xE~meRJWLs%IF#0|IBQIoe2o4J@(yKOG?d=1
zI%`YUd`$lfzUMT?rwnDZYtNGDmXA>@eBXI8K5b}0yZ$Vf&VEc=;Sy&_Tr#w{-EdYo
zTk;9|Z@AQXIxZbr+HN{4o2~hT{x|%<X^PJpTHbCwtDJ551pN+v=sXvf4XtdqpViG~
zKcT;aN@rPo?oejC`>b)cM1}qbe&oCmmk(vPd(PTsYgF`qAmY3jpFfn-9ym+Rwy4m{
z5OsbNUpSQ4o;b_RW>xfMxXfvZFB&Rr7n~EmB>5D*0+&0#jVp$V+ePPOFKIrdufUI;
z*7%a4(st=N<x7@N(eL3W&hO&Nq4IY5Io(U_r}Xzw<-8nUHgu_7anAUX<TLcY@Kfja
zan;b3cGWrCOPbH<|H99lw)l#n%69EJ@+He>s11JZ{2{(-sDNnKpW|L)Kcj7Mg|i~A
z8LDeHoD<3<pQHbSE1gww?NDpG>6}ca`JDbA{K9FEXAO0>ThA$Fme0{2;FnHETsP!x
zx1ZC=*w5)7;3_8`-!|lLcb_xLBrDLXkoOMb`k|3_&pDe+vx2?~dEPLdI}~jXoFiqH
z6=((IHN$xR&}e(&94BK}&=ru!3*!YtNu=Ps@MXzLv=Z`GVcam3Op4CSUe>InE8!Za
zJ6<%DLQ2moU$(47s~|5C#*IU%r2M?@Wp*W91$lTdUNV$MD$W~UmVAL;gS;~sHw~qe
zs`Iv&HDA!z;Cd$+FB{4rwdcu~EnlE^$SZ>Ji$e=Y{dw+X_6yn$c{DI?8Cpyl&I{*A
zzC^D>-Uy6ahnAA2^RhXbFX`)Wqtg?=JhYs&o>$JXe2F?BF961ELn}%9dEFfLOWFZ>
z@Go95lu5eJ8|O$?p%~ok?2g-qvPsW*+Z@d*8iQM$KK{%khYXx2=U7&uIOO#{{){M(
zOq}QDu&Zbs@>pNIcBqgPlnGyve1#H_xB24kp<+^0CVNHm6-~hH&Op3nsFakJDPOUC
zg*qWG@5RZXa#CKVdxiaqc0#@LR{X}$B~npld_}Svb-|s^+i}m(6;f4ZdquOFcEMdv
zF5Wd%Novc;S1hYh0Czh>aUXx5rZ3}OVOP@t<~k#BcBqatlnLib)F^~`&R9G!)JmGl
zWOFrY8p1u!MEurJCuuEH&b6q~YPi>VC(aFdNqd=YE~}=iVZQTjJTl}b-DSqP5)E1d
zdCo4L7#blxWwyB*4P66yy)J&2pWp<_$hj5`S_^rsE`EP#luVRyb6E{t3wfI^{%|O%
zLr^ZvkYu8Dkf-Ppg5l&2QMoKblS$XXgHAzW+;B>Vv|O2C$wccR56vZn!>Jwea$N?S
zN!LT(l}k(<PU}#V8#5$p&<4meatYCJdWWjqmZ4cgH^3uKVPeW~Mu)bX%&@FM-SDV$
zLSowRf)0H-m%*-~-LS|xF(DaV++ipe&XcS~8)30?QbIbsw8K;`o2OYzH^O61QDWBc
z@(ydca-L-^+60d~CnsdXD?9Avx_Rtcx(OPcQxbEBGdtYn#(5Gg+6+%PrzYgX*&Uv8
z+dPeyZiXkF(-QNCb2<X$<UETOZGoqp(-RAa^Ewjc+&orGx4;soB(Z3?utRV`_^M<b
z+6qgZGZKp7;ttUT*{hm$bSpgVlqQx8mv%@mC||X#L)+jP=gfq1xV%GtLH8=Vj&6e{
z=d8rC;Y%Hg3&vL^>(O?2);T+&8ott@x?p=%vz~5;=bW;{is6FF4($c<Rm*ymgy)@e
z603%Z4*do0Rdzj1!ZPRFgl4#|!*D?;mux^gV7YT%LOa~rVY(obYc|jw@PbpG$QthK
zuwGEgEgMh@e(iicp&Ryg*e~eh>;{^G7oGDH+lKue?h8h_Bnzb>&y^+g!y_G@3pTkX
zi>4v3lO=M8qaA?@q}-B)-heztmdGC-?MPhU<ZKpw1M>D*qF^|Q5_~OuO_GgvLY^8+
z7>1K6(buxqG}&|~{MM;R6b+|P(yx`TS+dcakcY$)#^F>-{<ZEkHk-Z)c{eOkGMq*!
zzBaxl*@*rKc_u7j8cwHFU)x^OY@~mL-#L|uvf&I$`!)HRWh3f=JOY-uIJ|(;f6cwd
zZlpbsH@^~=;l-5UYvJpXP3TXMC%zKa;r}yq_hC^~3mnJo?k(-^E$wclWi{5;)!ItC
zdriztY%{UV8Ei8#v%$8K+DvRSF*C5u#5NP#OcZs{RY6AuU0+~k&H-H&bY%uuUIiR*
zg?$-d7iMPPsOz2o<&o#%d2~7F`#Ha~I>#Q}bo_I+i8)$n5=;8h>zsRx(}~Z~W=0wC
z63M=dI@cb{bpCU;nNjw-#InB3I`<y?bi{(TFvlyGimtw_I`1BGI&NWGm=l%D#PfaG
zb-q2G>4XJsWt8zP<xV-LPTV6*=Phh2qik)7RegDNsv`Bv$QNiEqfBdw?!NpwO_A<p
z{0p{?IaO&EYx)Z6v_;03i7(K0Mj6f$J$;3B`XbBA{1<FH<EmUKa(%^hh9djR$SU*(
zbEfh$(c4#AXDT9J##ga7n6s4@v9+(f&RpbqnOKE(Fy|^)i5<%Cb=D%`WquXg!JMyL
zE%JTUb+#h)4CG6+lc}g&Bl`Mk>l{V88TglMCsSEz75#nnb<QH=4B|_)i=islib7vo
zovX+)ga4B4V(7|sVz{rn&Rt}mfviSvGRhj2DE0;FyhY>;d^LNMQO2jlSYM>hSLB&N
ztVVf8*_skZ`r>tBkuZZ_&GL*gEhXOR8^x;js#B0`w3|_uq(qf}46E6zOTn|*ZstOz
zO&skX$7=T)Q;2M|hf#K-M74hctKVx$;j`HuMwx{Y$NDF+hQ0O_WDR<YQC6TtjeiPj
z+DoS3YuH=N<x0Ca-am~s@Aae*YfvAfY&?k*{VA+<uaLs8VSP+Z<#rMAr?R%a>Y2z_
z=xwI9a)+q(r?HN`x|#S_>}}?1r9+(TPiLKbjWda_&|c<R<xWxO&tP49Ei?JA*j~m{
zxl5et&t%<u?K2T8+Q(e4+%4+;S*&+2ITN?CeN0_tkvPMj&HDCwW)fD^&#;xsM2<g)
z7554=c`NH@xJqU6!k@>g_NiY%zD5H~eWmh*y+5DT?9;u1f6WG%hDzm0YJUN%-DiA-
z_!<o|jg`t1v;IO>zt8dt|1}$Ayp_t6k^W-Vu+RPqvK9?7O_j<MaQ@s<*0hg&1z*dC
znC41ST;eZh&HFsB5NlC^X{kIRF7sEg)_uY&{90CES}V&$++WSw_Niwf-=O_WTjeRy
z?5|}V`*gGLZ`gjOy;3oe{(9EA&p3<t1|48-R4T^F-^RN3S!VIyumem-<#}<nzngXM
zv(G}-p@U3krP3h#1FUx+ISXIM4l>HPkhsntVSW2Nvxs$Qm{GQb#0~y9EAA6!@$1+y
zqf7^hx&Bd{YQOqbBnOQ!%2JSM^N-;)`*pA4Ic$XKsZ`G7{o^?8e&ee|4m!jrJ3yk{
zKY`Qlx4g>dutSV8`y+1mPvQ*w?XM#1(P2he`4JudDV%9P`6|Ai9cFqfmH*TH(>U{f
z&#T0GRAiJ5AF;@v!ddqVuk!0zkx?dlM8coS+4ievBj2JDqb&4@PJbHb*sq(7f6Gct
zu+l4*_|rM(e&cN7TU2J0{T-3?XK=3lmf8Hbtjs8LJ7SqXlXLI4&qg+&QASzU5ncW)
z&byzSjc;J1%s^#_5@}>}zWtur#0E6RDBC$ogObCE`-R#31~$foD|xZXpU0^P^=rs?
zXq-`&aYVO2pVJV!*YNMyI5Sk~6KnhhoR%=YMtp}R7-jcH^!N)oJz;r`|Bg*C%FK<(
z`HMLNVSf$Th$b1SQhAEhU&@&X@-=)Tn`Gol<y{VcIcFw3uMr#35hhwWAa*F{KvqI{
zjo-+QFtJLd*zi|#HbOlI`5yg~iB~Ge7yeq#LFne--?M)*iAqr!hN<VAgmDh>J^B}u
ztdvE;-^RHJ%N+iD_Ah3nGNz;=-JF}S&p~q0|1p17CX}xUa9)C(gXgmUW0dU}F{WG@
z`3TP(A{V{GC{r=wh(E6UEQC3HE_;VjmSMy@{!#U+Vs$E#hmHcHsJkRpU`)NHSeJ_D
zv7^9Ulu8;M7+0??Hl`AJ=w0A%)ZLOgFri*wY)R$w*t>v=8ZC_tOsY2&+f$KE=-<HK
zse2_&U`oBIm`uetv3~=1Q)+2^U|PMo*po_ZLRH`%>ON^=Af?_~ETr<ASQQvejg^o<
zYQ3#kJs0@_{W};#Js@cVY4wg`-CX<!_V3_cN+V4Uq}Mx(jdO_~(7VAusD~t7Afw(@
zY?;gdz}^ki)OcxXAhX_GY@dtR(0jl?sYfJzAgkV6OwPq^>^<N<YN9kFkX`R9_RJ-0
z=xA_1^|&-EkW()f3v+oJI~t6o5NS>zuU>UP{W|g^ItGlRo|FuM{Cdp+-Rt;|>=^I>
zrIqFf3hK27jIR?vqW6M-QO`)mKw-W9faP`mNA_Nzp(aaMAh)>QaKQdLvKjpcc#wKl
zG6hQOO$W%=@y+Z%z(bTyS`sL)Hy`l4PHaZi;9=?oX<4A6-g-cIo!`u=!FXz_ga@kY
zZ3ol_<R|o>U;_1$WDeBUI}Yd!_)qLV!6TGjS{bOXcOEbrh@a5=z@yZ3$r5O*cO9@8
z_@CJOz(i_>v^vmT?>=BRAY0J;!DG}+$r=dMdk>HXd<%O&c$}IgtqVlzeFr=SVhcJJ
zJVDKtHU#4J;sL?HZ(+v*gqkDe21Yfg4yxZk^3ic%5;a${1;#XJ4(i^(^VxCWNy;E?
z35;vd9yGo|<f9LOr>J?7Jusm`f6(#<pU*x3wA6fQdtg$7;h_BuWGnhF@HDkRas;L{
zm=2O};9J>$foCYAv@0;J!F<s32C)^@fPYg9rJ_JegY}^B2EUcnfXNgl5rNbO+d=g_
z<Y)9jFojwqIRj}8j)S^+_|NQv;91Hfl?2iooCl5bh@a7iz;o1Mi40^kxDHz8@jtT<
z0UfnODhp&bxDVRrA$Ig(@I19tas{#)ya&m7xSf3%yg)6J&Ihs^d<Q-A2s=6+yhtrq
znzft;@t`n|x3lBHR0@}>0(lK8r}|Cg7jy!cMy-(Cf&2!IQ}-tR3p)Y4M46?UKtY4n
zX?&CT1$_kkhx$bF1PUAUPRpD8FYF^gPpy==Kyib?X@3*hhCT}ZOMNDJ1EmcnC;2A6
zjeQhMrz}!ypuEBC^t?%ILnnflsZ~;ka&ByO3UBh;*oj~UwOZl>)eSbMdOq?i`WQ%|
z)=0iUZG*$9n~(p>J_cq|R>>czZ*V$|^NC;4$H6PqT1g1BHMpFX`TVc!<6suGP6`LQ
z8{AI&d}KTN1bCHNFNuLbgV#yU$G5XjfZ5arDHez{_?({k#C8+`uTdMNkw9Gew_BLc
zZ)XuOhsu@i1V%Ng4yn_S0(25cr8Y^b;Fw0uAzd0?z)k{lDVsDpIIdB9$e2bHpihF=
zsm+o)IH6I0$dbkvuulR5wM7~moYZJIWKTnOpihA}sI8JFIHl2ah)lzGuup+`lwBGh
zoYrVQ<VhoTpjz-IwN08BOlh<p64Lk`tQO3two6Dbwb6D+y#V<QeHx@uJ0xu|t<iBv
zw*dc*eHtvF9Ma@qdZY7@aRKog`V4rB+9~OR8I7((mIeH8>@&bf?UJSjGaKE9><bVF
z`fu<ywOi5$vl_jJ$OX8A{Wn-h6-hIK*^RzKo&|&hoeWTFpEN6&(<mMi7Vr*sGQcQ8
zniI@xR2^2oh5U|A0qN8M$q>wM)Ew5mh5yb@0gEW7G(T9-s6A|ai})RV7Q90pmW;vN
z!bbgJ%Uk^K?6bf`l}K2yxY2Of{uZ(meGa@!9hFSM(nix^@-2KP`y5zIk<yZ2d87HT
z=PhC<ssry)C!}S;ibm^U;VphAs{>1@G6@e>H`)%XjmRJ9^B{vdC7FY@jgG@QBmM{b
zJXlJ(q?N(?M(1Ipk@y3B0lZJ0l`O%wM%Q7Bk^h5z0W71=ORIz3jqbyCBeDy95qv;Z
zO4eYY(R-LQ;=9-v!E%b0)&(PtzQZ0Pu?w9FKBR!OAsBBI4+}<q7dsW;RF#w)9OYFV
zQNN88qSHVobwRQP$9OeIbZ_H@>@=`~a!Xr+<Gk7<#<z(=^d;~Sby>0pCwTQoEN}CL
z>`TB*)kxcele~r__P3GU=zqY+)K$q5oZ>YdA>YP#v;P5~P#$SlaGKYA#Pc?>8`XnP
zsXD1BnBuh_5#Hu^vwE<S;v^!N>a`tFFGTjB{{>l8gX9dRc^yY|3-LYdf5B&zS1Jjn
zd!0v&3yD4GbnrRVERn$suj`0qA-{*64lGowR2Izix{ufwB1P!S;0vl<as{)z-Xr8f
zyoh}ntfD%UDm2^cJK|YL6rnS~msFS1xaN4pBf>(yh@AmeQ@m6a%=4;B)F`qSO##_d
zkK_*Kdo?9G6yM9HfHjm)stFc&wIxQB*o)2tUs1i1Cs^p!msn7KFFO-hDZj)8i@k;t
zJBsW>UjbiJLCG5|^_ogZ6yL|b0@hN3)EX@JnoB$=u@9XEzM%%B4&|Q7S|XtQK6VyZ
zM};LmSnaiys4-+e`YOnwh9qCG*6S$IVfcRbRj{5CC4aEq>nt&1#C~)(_?D6-A=u`1
zl~^!-KRX+2pkh)u*zI+f*fE4aUjyG!2}ukFyxtNL!wL2^u#p;(V!?>lSK`440-XcC
zr~Z;gf^p@uo`CTLI|t-acceSPQBA5+bvjavrh+``E?E^C)1)cYrQ^kHD%eD+<k6vV
zP1;gpI#G<y1wT-C%j(dCCVi<ToiAqR0vk129vhm}WGJ<#BL~pe!H?9vvL-a8$y7?F
z;|JK+!DdP=j}J|2GM9SNi36ws{6yU+PYk6rSxbd<{s3zLTd1)z5=w2dm8usZ2hle`
zKJ|dC4W%_XN_C6ygX|k%E2WVqhtivzrN%|XL3AGYnR-apg)*94rItnfL3SRnQ{&~S
zq0A<CseKXRMBfCzP>;y^P*#(-lw5>6**C#9YN9+Nl-=Yj^(-Qs=zQ=i^|(AMl+z@Z
z3X6CrJ0EPP5P420uSs=O{SI;nO#=ngld>U{-=sOJdj~(nrhy%lR-PZqEojmnHNHa}
zLKlGFsAptjsIW<Y)bb90h+P02)MOb86*n1<+TTGAqi=!Vsb^(VsI<v+lzaz2%)SM7
zQaX7_sJzL1)bkE;7&U@Fs2AjAp^7H!QQ;l_Flz+6sHrj@s&29!Rhy6_=-Z%>dPz2i
zYMUHKbte1>`!?83>E)H7`X=X5qlq|zE(Ck1>9Qr%*5o>BG4V&(g`kL<A+HW~H@T16
zO-Kofg1yvC*%}Hod5@ANyo5!;K5CY{E);3<9rc)q5)=dbsoC;|P`pVzDwy~Z76Sw|
zN6rn6YE~Unzl)Tj>7baJE89Y2nl;CC@8YFwIygWX<Sn6b&DvwecZpJT5jaTAlkK4i
z&H7`OcllCw5pYuT<?W$K&4y$4cafv$JKzwtKz4+tG@Fi*@8U<<cfeuFDDMhQYc?PA
zyh|KKP2dQ%P%a9kG+U1e@A5}k6DXlDnFyse+m5LhBgfEpK`FIJc81cL9mjNw@nh_}
z;3#F1OG4?*&SS>K#4&U+I7Tg&$xueK>zHLRe~euWNNR~(7RqdPAG0q;Nc25$oLVZo
zLRrn;W8`9-WZwfPsAcl`P<FHLm}fCTqD#O@YPr(H=QNAQgvC6`E&*i}E?0%}npLFw
zJ>)o=0m`WrvOARDtRZ#p;m6qwaEda^HKBrLEopp@IF2p_r>Re5PpGh2Pg>sNkF!gG
zi&`mjq2gu(X@3tnfxZvUP@l=(P-(M?B;UhNu<wJjltpe0l{cG7&wIoPbQw5Dt&%&G
zdub~vyvLtlmx1%tYMBpJH`_?{667TM0jQwX$i7f*vxC$v!B4UufJ(|L`$P53PSUu9
zIEgL?6tz|sLT$}1(z1j<$u0*pwN4I)x|`jkeF;*Aeh3(9y)1?T&0dmRf|s!$0zhq$
zW1&d1kMt}d%1|6YYNI?7iYvbx3QPDh76(;Su6!pnszr5Noq?32nV_25B&&omEt=!H
z47{Ap1Q#fqJX#pnqCIZRAj;7d;3BnIRtpna^v5k3d^x)UxT!7jSYc9&;kZ2mIfZ@%
zE>T-$jWDIfbezn<Pq80?%amOnFHCDOANOPsr%*GvLT!^L3Mnnt<3a|1iZz28YP*aG
zsV%nS>ZQnO^kYy<?U1!XT8rbjZYh46{TN)O9P(r#y~TOlxRf}JegdvhJ7t}a(c(I8
zS<0VgKLH+UmpoO-Y;hmAFGXDFr{FrZTh<F%E#BkgQryLU3hJmLd4`bP;ydnHO1RLK
zfTi}yvxJ-$@wl**cd;u0M-lQIA+JSsLj68+2F(KX)B)Kb<mR_%PUzmp&#+mbfpW_8
zg@P9C3FG_38T2#INFA1qLSc*kgynty4Eq`IQYA7b6t@^o*xyIaqMw5%>ZoiIN?S}P
z$oKKH?B}4FBIPAQd5igk=Y8TVY5^_O33-`N(PBLzyw9IyEufVulX0QC#dboy3^|8>
z0otfjvRSBYah%XC!_To_fOg6yuN3NAoF|OSh;!&FaDzH4TZFb2*9prq{v5jsbWrEz
z)k1fR`-FWNavuE>bW)YFRS2|rPms&-^X!+Pi=yRqLZroa!n2GxkFEwcDIjkU;w|C{
zVHtm(T@84uO3oEVwW?04KR_zbY|u?zkZr=4R?SJ>2Y3aW4SFcIyhRw-sy%7^fT%#%
zfLqjM*)B|I)t|I{z*n$qfRCz?w+oY64JYj%AeHD>;5Kztb_i2iO()3@@JjY8&`Wvb
zUBa|h^GVMKL?vnkeN>%XB&4)jPYNIKm8=!`DNZJY)K=R`^>TzlzXk!SL3Rpht&Wqr
z<v7KD4T6+cE)mjOohOaU2?|{cLR7O%3K^}gla}Q?#jXVc)hd?>nXT@V_T>nTegpcc
zcG)FlwR%sI%W<0h1`JRg3PZ_m^_}!ACunpX7^J#nTF7Y?PYTO<nq3FN6fai^d9A84
z^@j+9=70#*BfEwCR!y1iL!4oAz!2q=YlMPUZJF^yf<f1VVX9a52!*ZsGRucN!>$J+
z<(E03xYbZ*{}2J_w?LwTvR5c=HI<Pc;(+}Y$dn+r3gxZlGS7zuKsSIWH6V8=9gDS0
z_>c$e1`wmdGA~rO+RD^80@3e4oEnmSLT#&~Oo!u;{SG83QQ5++Z*`U#aRQ<nL6VYX
zL1=4rm055evKzq&6;pIfcdNV1jw4m*_ux+|p&XM0TD@f?j#shYgTJT|IVMC}ePte;
zs6unW|ERy@5h1ReB?&lR#pZ%L)E)VbFse;euFgcN(L6AUzALKgAJe8O*Ja|>Y#z9a
zRz*kmk89JG8#9S&bQAa+eRovdKcP)uZpq}U*-b!2kB*M*pVVe3w`U?3&>z6x>3gG^
z{wZyyaxxRY!2SU4rq$8${nOga<(^F90%`;I(Dy|r_NTO2%Y{t-0&4@K>9J9yKef$P
zu3mv$M1KTh=m(<O{<Jnnxo!o1k^K?eOKYN&`_tQ;<;E4nMRYUx2mMe~*PqemDz~iQ
zFS46~njRmW+Mn6xF1N2h+~`l>pY$V9eScP)x13yoyV;+>ee}fWjQ;F4U%6)m;YPQB
z`{~D{v-)$|#ByN;?`F4vu{07@UIEQ(Q=L+Ogj_=N!8rQKsG&c<O>;{35q^oy2M^HN
z==}bIHti|nN5my`EBF`vOw`z4*rq>a`G~*7ZUq{8aun+?ZZn*+e}r5{e+CcI&qhuC
zrER8D<VW~r_Gj=At&1+{FK;uS@_a;GM(yBX`i1DS{)#s1Dd8jjGHVCp>8Vk?zq-wK
zN^M52pud0#^h;55e{GxNl+KJ_VSfRS(E8}g{`xlODWjRVf^Gwk($k}s{<b#PDT|rE
z!fpc-=^4@0{oQTuQ+6{_gZ>I0qi05~{ed>`DbkGBu)l)G=~>Zr{gF1`DUX?`LAQe^
z=-JT?{qZ*Olwjs-*zEwJ=R|Y+N42X?t3O6+(E>1uo*T9Gk7?JO)_siEvIXEt+7R8+
zKdxPS+W0Y1i|znV(etAA{t4~+)0U6<T6PD}((|L+`zN&<PTN05uA;wzr|AVzNB@*|
z(`oW!{3`n!c!oAcclA$eH=p)=Ok71B;NSGZXi<MkyY;m2F@KeHfXOr#CHhm_ZKu_r
zAlJ~}!4!H?)Y+fb?l`Uc1i!}q4xXh=(USi3cIRp1C&V>$CwPut93}fR+FhqDpYYe%
zoj^w~iI(+ew!2T;KS4a`AK-a<Y1Gx9)$Tn_eu8`0Kfnw0vgrB#>~`O2&nJWj-34Bx
zmn-Hjr(HZPe8PL!U0^DWN2~ht+Ep&~r^t1*5KN<2MBV-Q?HZTvQ~Wwx2wtMi(VG5(
zcCE|!DRCX$4gN!a67}>Kw(DJ%Px<TYZlI@EM!Ejtc7x0QDN={-0so~xi+cM@+f6R=
zQ@oDd1E$lKXls9YyV>RWl&C|Cz{~WiXou3hSzW@Xd>vZ^X3(pne1CPj&81$6u;^Zp
zLa&MX`fJ-AF5OC;W%q)av^DDQuWxs{j4KHi-3MNw*G7f@wsx1xvXW=neP9;7E*kFd
zZg;!vD-jOe4_>9$N5%d?yVpgo#5s09m`!hp#`+`eK9^@D!J!0rjoug?>5sRIE@36l
zu>_by=SJ`JkGi2cqs~I=(PEHFZ;Gl0#@x`H(PiQFY%!Qi+oGcf#@*1KF=i3<=mGFL
zy*a8Lm~caX#*)R?vj>2I-Vz-<FzJTjj6Dl!Ko5d9=&e!Bz?2)NGh`Otz#atiXnS=0
zz_c6YGoCD>0d;~m>21-811UGGXM`-ifpvoU^!6w+kb1**M*SJmh#mrI^p2=@Ank_Z
zjP5hMkv#+!(2nTjf%F^BGse$|M)WXvi{2U44P@MKow0nzH?oI;k=_-ZI*@t8ea8M7
z;zf^ux9Qzc{Xo_Y?-}wl+{+#T3+bZhjDhSMzB8WB2rpU!P<mf<)<AB~4e^Zd8SiCF
z07ethIRkk&RA<$nBTZ;2NT&}(4FmZ%G-q|6<4tTSSVTLc^9KrUXwMoyCz{Zs;2rvK
z)HqOhLx0xtIp4${1tz*AiVYOsFr2l2jx?jkz`OL(sA-_|hUqN%Io`}31B+=gx@4gI
zhWV`LbD|j~!F%+H=(2%|8`iVJ=X^6uf+ciW6d$O*VLPj~AT8)|kU^h{ng?ocIL_)U
zcnf<RETvu1l>_xRoM(*|q6Iwx-lxw-Edy;gTxTs7zJ)yjmeJ><s|UJoxX;=xNGp00
zd_Y%5tpkA@-m|0yZ)Hz{<un~#HxRkuJL|C!t!NqekOt8W1MwT;S;4}$vSk3LtD?CB
zqdHXQ)L$TNXgSEFFGOtvV>&eFbYI|YY&lp#yQ5nM#&u}V8NVRf&{N<e`f}7hFrh<#
z&hiD{#-0LZx+c1PU{Z(Soc#-=9X$;`rmsdF15-Lo=g2SccJ?&*g!V*t4NU7WpYwb{
zw4*NYDP0#W8c6A|o)f;{+gTS_Npn$RAhpAGPQ41bft~?bbVJlRkk;Wir(1>JV9$Wh
zXm7M+AicwR&bW%Wfu04Q)6G$GAfv-|&a#TX!JY*cx;0uhklEorXJ3VMpy$9BbbHh_
zkk#QmN3Oy<*mGbN-J!VG><-^K&nlt=JrBO5yQ1_!PKS6-SjBg+=fP^4k5&!jb*Rp(
zzeGCG3Xo0rMBM}V9h&pHFY!*c0<58Z(VBsR4()m4mqaI83BICxqn?4n4*hw{mwYE%
z39Pg~$_*5E7|z?jM7mH4d`$<V-ht8%(|Phsyo;s4T3U#<4wQG8&wIWkx=<Q?Lk~nd
zlup)qUigylVrj6B4oCTc>JHm^^=jlM%77etDC!%i?Qopet;TP%3|LQ#QU5@Fhx5E~
zHE|OK;9FXb3IlB&uJe}F{7n{s4RkCT9_a3HpSQ0@coc%~=tNW;2y}SQldEx_g<vB+
z5{(T+I(+9ns|g;h0^ierMMnnW%3YPPn&;UnkW1f*-WeFxsj5(CBi(2<$fNIysRqY%
zYASTucsE-OHqols=)rNF+6rSf(T!dJKhSr_)PoZ`^%a(EzMH)OZ1m{Z*uhDih6;N&
z(t}<EKhpQcG=oz*O%-G|-osu5n`w1y{NS`sbA>0H=t14!C;GnF#KDwKYlV=__polT
zg&rG222(q273wv}E%Xw|ryq!E2h%zo6}mO}E%p-FN^4@12h%&96~;BhE%Y+@nSLmy
z8_ei*Ran;Wx7f?TPLGdG9n9=>SJ>AeKJ*Isg?=QaAI$3XR*-9OAA1FCqbJ5@4CZEc
z`YJqY2p?Jlex)Ce%^J+<6f1-^ypOE`+i4^=XE3i*RjK|8xsBF>0{Y3AVKBc_Q>pt3
zzs=Ty9kez!f3ToaTWS1?xQ$)~ztPXcjDv-p`bx`J{B8CsaL|)u*kEy|q0;^p(u-aL
zzthjgOoOGJrb_ZFyqCQOcG9}olELy$bEW4iq8IgmKj;@?%LXett(C%8d@t((yXdJg
ze6YIHR;jikedu*iNWT;_57u@%Ds@)8kG&3d)B4!T!TL^TrO`_Cp><#nJw0X_Z0mGY
zTC98@TL+5h8L`!a-JR}AyA|=HEZ9rWj9CW*o!&~)iu+j>?4xJJ)(u8FeU%<7;YT^J
zpPn7tFc|L?D+Md>XE{L7b7HxJqq<a-`fDVB)`MbtZp=0~rb|QVzQzM=JvcxcVp|5s
zb!jQ%*F*qq00-%LG5g?zE<I)Wnh&rIz)8=KZ6BP}WuWX|BSEwg9HJM*9D`H3OcePw
z9%LKAVcHnmH8`!yOnJU0f~Xf9p%=!A22;AMl<+klWWAt-#$v=^YL|^tuSG&=6DXw@
z#him_T@FgO77wva;3#d1l?<kLIVs~>B7`=BWAx$}IhfJqqAY9q5Zeq$dP%HoFtf`|
z+1DZh+5(Q#OJlCVtS&D_uEhnm1)QLl#m*0AcljvKT0%fu!AW|#V)}EsL`qo83v4SW
zqw!ePU|yGsR)2%^qivv^UJ-K-=67jm-8XnY+Xhb2=2*>OL6?>`ena%5?cg;1Nz5}?
z*rlf}-|+oxJ8;n}W87eImw~o_gAAZIz#00pn0K(W%S4mk-~;RpaF({jS_jL!%(Ukl
zVgT&`=jc_jj=_p9D=mD(53n8JJiR)`4_0^CX!SZ|5bXpN^qQD&u(r!V>(=3eY$vFs
ztug;#eV3Cqt|JD~E<n+1W5Qrtmy5Qn;|JL;K-24D;lb`MH*H^sgwdOTq1VU6!9bUn
zCfDI%_9g)IhFEMc(&eK)>xeMQ14wU-jSR+>yKP||A7*(_Md!xu434^~V$?ZE1nmaZ
z^ro09Jm#i`(dFO~wi{faZL!heaW}P$F^7ntJ>Vj}Ii?OzxT$9>Iedie0d9IrY;1Va
zO#@@kL59#<;1azxrU_5EX=2D6e2BdTF4Okd`0%uwX2z34452=7h29pM7*4rqWrQ4l
zi1mRQdV35Br{1(N>h;JldK=WzJ7U^!+D!+eTaOR3x4~7~5t|%Nzv*O*>xp5s7hI!v
z#&qF~n=Zz(o*!m=frs7|n;Oo%>1OQf5fSYJ*Xi9ceK<Gkrk5et<09J!>gb}_jBxf%
zALCh1h^Qa1^uE}vaL!GU5!Uk}>jxZ7#O8$aZmNL#TSP(wpq@SuGlcVRYJl!rTw(*D
zfp*5`hYN0Mf$>{HLW7`@J{&WK3vcRy<y&52gTPCd#ISJjO#`rhi^ymQG|@+6rf}&^
z6Cl6EWi|wwX)?AXTz=CGJl_&BDu5RHL~L2O;-(b{-|{jmfL6LJhKH+f+JJfk5=Hw#
z8+|Hf4%gmv0Nn;W%JzeH+7(+FuD|I7#tlRi9RN4zvoTA!?WPM@Ht<n)0CdpjW2?j6
zH{HO#0g0i5pp&kQS;K*wUO;ZZW9%U4qUqSWaO9>Bcs39*Gz@OiAhsbKzbOJ?10Q3<
zfTycsx#3Z~3aY<D;%EeP(-&g4@EBeLb>HD}HUfHRcWg^|9Iu7O?}#`$1a8rnWA^X_
zUJotb@o{zt_~@G0_V6U$0PWu)33M3Trmw~v;VHZclHcJ8b{O>1p4hJNG~Nt7-w_E^
z1buW}tSFqqTcPkBpI}Acr@0srPUUS-y%9;G5(v-@F=sf9cR<}nJjqHRNPA-?;dI^!
zjT?z1DuWQ+93#USybD@3@<~<(0^J%b3up3fXy1s8pi$6Ix5r%JEZz&rjra%~1p{=4
z^3X;$?}MI=#0VM#gLGGn4(IS96gKiBYz%~HK2{aZ<5gAa?~y;zIEc_aF?Tqh*Hr1g
z$NyyGV2Jj`YQhD)w#xWD@h6%9!*p-V6E5WSRhIAhKiLFO%90otF6IqY_V1Cu&?HbU
zdSc#iDQ~JGzsLV#lR!CliM58yd2^NLd*Uy21SlVaVjbZM-dZJm&;P}a0Oh-i@!@LT
zR;A8G{)hev;`C6=7p~<URk~dKf9#(iK`RMIxSn@b8FPvMp?`rSt(<3s+jv)%C71sn
z`xh9YW6Fad-MqWXo{QW;{|El06EQIy;JsC3E`EpoANY$NQT|AT_f>gvi96^W@IU&m
z*ho0ei&a7{e}}yT?$CE)cfzB(Rn_V|WE3_Ej$-bLt0H5%HPyO2d=xhd-o>cmqa)+G
zwbjNvVia~4{2Oz3TpgLvt*^G^@uRrApo$qC9~+s}ZK$^AA$MVagMVl4jcX!Px=qz&
z9)1`1H+VOrj*pK_>o!+=@`$@I6}*SJFFrAn(rv94^7y+r6&%fsjU$oNZd<i_6Y@9g
z?{EzBKwKM1>vmM@HsOEc{toYDH1Wxi^loRhaTD=3>~8oE=ApPQlF{v|wrt}6#@!9o
z%=q}!NN#4gyV|}9QDOJMe=?86^^vS@Z#B6IS8?~i`<RLG8IkO6U$tiwp~6PP`<ch%
zvm!a&Vzsb|S8=1^SO$sDiR5*wE~tM%{*H}-<CrJohDd(5=7R1A{O{Zt_yD7g&yN&z
zYcCjoApVZs3;)GD6E{W*yY&|=Kk$F&?u8m=avX~kcN;F)e?acW{sA9ko{gI#rQN0r
z<PZ4W+&|z$j4r+;Qr>O8;Q4{L8&kuFnHS>AA{E`%3&Icl-JBYZXQsySNOiaEg4%}M
zgZ&duU|x!wBemU*3pyKq5BE>_2&0d$jMR5KFBomaJ=lHlQD%DF5^3vpU9i~rd${}H
zL}o^Ob)>u7eZg)+Mq~HG$C#OMYb4O^y+GRV(cJy;ab{M0T_n=&yWp`Aqp`8@31)VD
zLnPiUUJz{jXl^V-m^ty>$fzFGMfH!!7;GGz#LSJ`B4c_q7j-}4W4LkfNyZT05*gQ{
zy=eTA7=t|kpJL|4?U4yR`iqty`7zuBP|M7ZZ;wpsF<i9&h}?_)3qH*(h&v)vdQ2C|
zAMty+f5B%MV|-U+T95gn=SSjROauSTEQ}XLQhKZxg&+BQISri5U~wXn+GD$@-i-VM
zdk{`x7R8;Bv>wMr-DdnB+=K90#uP7!r1v;48aEUFz#f9nF^l75B%{Z5(XyHU2lo)v
zF-ziQk<1?VMf+w%jXeyXXO_lYk*pr?MRGH)<{pMGFw5fSBiTK^i=NGd8XFH^WR@#$
z2IcgK7lqBdni~(NGI+cylGmehtA9fNiA{jhm=$q%B)>=F*8PP4lbZlvV$AWHNI{R*
zZTyM&C-w;Z5A#Xf6DjP`yDdNQ|KuKldS+#uixl@5-1eW4`>;phf0@tX-biVW$xZ%*
z-^V=)r!$s#Yoxr#?DqUb+=oqsFEgv+9g&J2t6TVqzmJ;;XE3Yde5AU^=2mY(?#CX3
zDa@L<FH+m%aO<|<_j8ZInT$2=kJR@#-Nr4%{n+F16=rQ*h_v;%+?Fl;{oLbl7PBrM
zj&%39-S#cWSnLV-DziQ=Mgl!vH@O8L%RK>SGaKTuNTkQ-_G}@>VhDVV*%%**#Ct@y
zu!SGXA#e_p8^047bxU<gosW#eCPBsT$5lgPZfP#*^6_!pB&cxx_~@Z=x3rgx`NTNv
zNvP=jxO!;9E&U}+K0l6o5-J!!K6Yr*EyE>yKJoze6jbbeTr)J~mgy3ik3YaY1r=%^
zA3rqhmidw=pLhV%LPgfcCl00DvR)GM`3E>HR3LpE8A`onyQJQV{0n;;DsDcm9ZI|9
zxTM>P|BHJXDoj2;c_{ss^OA8Z@h|KdsHph3ZYVe7mg|ybEB`O<8K@}u_|&1yTkcEt
zt%wHuH&oDjTtAd`%X^93ifg!kLxs4<XAEWE@?G+5B{bM%h%)=)vxahRiI;?}yoQ?$
zF@}iG8Opn*x~%>gc@Ucd6|WvQ4CUX_T-N=JKgdmi3Qv#EA1b(|y=?rMco2IQDjGd*
z94fq}zij!Le~^0?D)>B(4He%qT(<v=JcK<56>A<h4VB(9T_%6VAL5>a3N4Q>87jYJ
zzU=v#cnH%$MUuyt4OQH-UKW1lAL4XSf#Y#}sQQ-evf7S3j6Dw(CmuHs)!uSk*4gog
zx#yw6!s9E4>TfwO8|}oy*b7im;Bm`P+b!2+i=BU%djTrwJHC3T`<DB%-HwdMUW6Yo
zm2vA(;Fk9?X~)NNFT&*v9bY#Tx#hd;u@mF5sZbHz@eM=qTjFKG&X4D&LIrHcbB9Lx
zR9Do$AQP}@Q1RJu+t3)F=8EnYd;&KODjYk$WoVpFd&T$*F#&rCD*8HZADZCPU$Okc
zPvBmH3bu}KADZMdT(SRxJc9iPDz-ZA7@FcUT_JzLAL0H36-pi7H8jm<zT)|Xcm&f!
zMNY?yhEjaiE5a}QBb**8P&!TwrTT1F)Z36pvHwEFMaP{(X+Fml-8TGD?!QoB(D9O?
zbf5EzaU1a{HXSPJIZh5`_*_>k+xSPh=}<w=@v@;zpZkh^8!{1l87ibX?i$MSd9RS$
z@QK{ZP!Y_^%U;<&-xbd`Vj?yJe#s~gfDYyO#4Ex!ej+ymu4a_?xQ6n4sv7mL$YWRv
zR5)_nJ(Ta$)aZW2ALCM>qL1S>Lj^u<jqz9FF>EGOuyNcoROr*!SbpUn<7Ps|7RR}v
zVxOVL{wwl0_6k%eaojsp>NC}lzv7Q`uRui($6JTWedZd^uf*fnET}-?c*jtM&srn=
z%0JG{f{F`{^F!4>Ta9`<@&xuOR2XpFH&p9$)abV3PjIh7Mg7M8L-jsqjd45i1U4Hg
z$TuzwwfS5%mhJo#+-#_r-gtPZ+vl#aZ$}X9HTWHqh>Jr3pSOnGjw9S_a3eDkj}1k9
zz8cSV0>S1$1?a{{l)p%<5w`OPHwP*nH-2Ym)NNI*x&WDkrNTVsu7qlM%xz7rt^l9J
zrNT{&DlvL^+-+^Gv4EI_&4oWOcPG@t6K?BkEd~4}ZZ5PjqZ4C?C*3yG+6#~;vDe{`
z%)JTC@RZx8TCxCtl6xI)X4HxC!_#h?Ydr<Tlb8Yi#N3ydIGl3ZS}PRrPjUvhg&CVb
zhEs3bYSlZCr?59*KJ!3AJDhggQLEd5KgGQPw=$Z<<l)@(+s<0!4&o_n9{ibkD4`q9
zxb3R7?BJi`=0Q6%J~4GT^R~Ozz5~%>Z^B=gM-uwstlQpNatE&E-h|tjiHRA**|&YQ
zo*jf1n-70w9#6~~&bckt3Ojf$Hy>_iki?wfyxXd)>fey3u{2n~Jee>I=ik;`)%}J)
z&85K|j5aZUxZt+-s_{4CX>0-fjd><v94@@AziRo7f0|nW9n9neHe7t$aMk`B@(lJC
z{GE9=VHz&IZMsVShCjo-1$Q#K#FF9i+vcmD--u^0Bm9GTA+c<@;<ojw@EiXOXN0?$
zsR?|z`nK(=+JXEVdm9!qFD1;wwYMEtbq@UB+}m(Bqfe|HuD|WPYIG3)#umao%=Cn1
zxb3#<s>Q+on_CErm>G%H!`-*tSM3gDGKRvv%*=#!IB?s0m2}{fITY?=W+m1QM{fJB
zdK|=L41@cb*@+Fq@!R56!NE`FFi0?S61l^pdR5odzavwybXd&HP1uIV^lGl@e#fV9
z>F@w!NNgD%*Q>o|{GFJBErJJ`c?tXQgkJqM%kTUYZV_}c^Ap>LC-oYx*?&i##omF3
zm<0*P@RVNDHS%}-S?(Qpm@y`H4NvPeU-SG<Jd2s&5oTecXgH<UdQJG9f0i@B5(Y~U
z!>PTtYwDfIbJ)AElv$K;4yW}xuIYB-&vEa<ql_t0GMwJ)yk^`<JcliY$C$+layX;c
zb<MJqe~w!WNoGl+Y&f&mea*fT(P8hw<IK{8YdEXddyU+Q>$vye31(U1{BU-!@0w>P
zp~IHIlgx7EO~RaB@tUxc*Ktc=8G|RPhVyz=9`zr{^H>HfXI3QK!}+}$kM0lrc`gH<
zV$6w};euYR$M^^FJhl{`W<E)Hh6{W39?Kv6^W0MCVpb-&;o@F{$NmTM0`@*U!+e(T
z4wv?tJmeqv3*7tgEMrNu4wv_uJ)S>^7qDgU9J4CXF<jAW^$36PFL2A?d1iHjAFl4T
zdDOd*7qJgu1+ymM8?Nnjcyzn)7r75$C1XwahwFQt9^)?JMQk~wn6(LExUJXavFzes
z<d#F4S(gY8clWwI_Fc$S>_f;f>l5N|px5gmci~gH4<TSSBx1vnUZ2Oai<pYx5HcGR
zBg64t(If2Qr*b%~VsaCAhDY_OuB!`?X;>yy^jtzEj_K1}*A?Q^xJ;;Exx{F3T%Y#3
zv5=UCt$>P+OQ^*OefsN`LVg;z0xA?PF;<+^XSi-JL|(!^f{J`gXv8Ufrt4%O{u1{Q
zRG?d8yg04TeBDz>yo8yd;@T1u#gsnlb)k@di8Dimu_X{Owa<24y&L%t_Ayk{T0$%4
zru8|l>vrS+;Xa0nQcFx0)BBv)jk}5eV4pw*r6qJ?MxX1tWjFsH?h~jGw8T^~v(J6q
zz8leFpF%~PCG=uepZ7Ys8`pE6LIs#5W{BB+zU!XdgdST7S!Q2imYCBgUKe)rdTu4;
z7$Px8%<EItsrMlN#j>EH#S#WFzfV)A+k^j?%Yq6HOUxGw`m}Y%J;Z;p&!A$#5=ODG
zPhV%*!~d823@Y?1fr-U^hC2HmWIFaaRHRqJB$oD>>c~C#bnbJgz^=p+vAoY*=h;I{
z$1G5BT#033MW3}!*uzifEKp%v30$o1v(>4Kke9J9prW)AX0f)<QKu`yU*^7m3d%~X
z6zlt(b;cs%Wo#8x3|7J-w)MH{EJggw+$yM$tHf%tyU$%`FG6NuU&2nNGGP@1ecn2<
z2%o`y3A-3Nu}+Ni`RY7H#0+dTRQyz8gBb4<>x3eH2Dch2Tq=<(j`FKm^<E?e%ZA;|
zg@jEU<JYjdy?6?j4SN`OVv9J=uVsyUi4<%Nyv1Bj*u@EcJ!{#^r*LbakEuy)7bp1*
ztbH#s6Z;C@X09e2;uOD$CHLYpxvyX^<4Noir}@pSXD=}mv%)^6E>R?=_^qt4m!HX5
zp`YOrgqZ5LvFd%uE7;dCz%(SBVw&H<>h|HUa9_h9<4u%^>3%0`+(*2Et%V_`IYEjU
zeiv)m$G^g@g#y!>C=)aNZq~jJnT34=`<eEHOU&|nS#lpfi~9x+FdfQMqS<~Q>)A)l
z!q&k-rb{_X$nlG;u#ca`t%G5PPgIF{eif(QkGzWIzzEZmaEtkV4X4|WzslvnA;y=e
z5exiU&bXg=6<ZI7ncjp)EcEL+%YOb<Zaowke}WT>{RYmyADNAP3neC)@QS5=6G!gH
zXLH{|nGq7LV!7YUdG-^tu?;ZF3?w?l3cr;T_Vcs34KT)p6TDdMw{dC$c@6sx#+jjn
zPptJjI30n%#(f79jF|9?^?oO3B#76rjWEf`2|;Z0yEqHMzs7BZBTOt27Q6j!&Q2h6
zu<zlYOd=tQ0l$|c349LsJ^YIqQBFl7ejn!{h&fm;{2%jIVnq35BXR=4&*5_69p+Br
zjyNiys#g~ysaPIV@Jmu9jR|P#b;Wopmj@N=k{m6K3ux<&#Y8H$2`aQDsg@=L^!1iv
zK9$=970HquD@_U*>g~nIT<iy^z?Gy%ni4S8lg0R4?gywimE?G7TEJZIDJJG(HmI<a
z<U}bYV67L5`MI18DhefuNV%y2TfO=K@;de-RMbgQE2RY-^|}N2>)ek}K_<z`QhLBy
zZ#+P}j%|htDM{+2jDV}&a)5uG+YA*!lAJ1K2Hf@b1Be0p2`XSDsh6?>-g@!?Zs2}`
ziVsQ7kg@~5dd~sEfNg>IgU6Gzq?~|QFC5?v+!m<lkK`OFFQ95rA4J~3@}Yt~k_IV1
zplQ$@#NXiZp<+9d^QD4-w!wIicmvxC70Qt`N`(P^gXJLq2DcR|awCaJ#Q{Tu{U9<A
z`x!n6o=uvh(txRfJc!TZeufVLU2=(39xyj}4ifV)JA4?tkX$BJ1gs6hL4F=*hvUK2
zBra74Yz=BB@+S5RoB&=*nx)!+qe17y-{gLQj{tpgrBokqHW;16o7gt^D43qKNNoXE
zgT=|e$!&uZ!Hnc;sXO3qusf0Y*st(0Ff(bD0s(IW>BQ%Azrx4CtmHZ=67V&6oWy)=
zJ5=~Xa)T5Phz)|1pU-WFigrlmN~40RM)e^i4J&{OZb;gsF+okE?hu~F6+p!@B)3T8
zg4#yoAtDXi0TsHCv`Z6$`bNtkK8@P}6{(QiE=>v=8tsRW1=w#;feA^6G$m+iBoE;W
zxZj}S5R$v3X+d+N=Mb>~b3lb1B#We!ptVsr#4q3+P*Da+LP`zV8r6r9x3J%#f(nvO
zDJ|$|)E&m(;(mt;AxM@;=|N|s@i6fgwi7C1AW2FYL06;YF#i^}6DmL;Stex$-HrCc
zh!Oh(Djp!|lCpx{M)ELj<o<w4{+~QAWe0tYp2LI@+XY_)%au2ebAn={aF{o8yPy*H
zC#$5qpvtR0g1n6tLZ#(Tx~2S}#;ZGmzs(gwCEZWfNCiQy*LZ|@8`}+)Qa|aD3WIvD
z<p}>aw;L*9ev*@lg9fkt2(l2{1C<Ux>6J=@CNFseU&!r&N_L-YmCA!=ujdG{5G#U8
zWuNSjDuPz8aD-pT6+tDcPx4ZA(B@T_ASkvMDh++oC)EZWUR?=}a(khY%qRU)ebDJO
zmJlem555A{CIzW2=<-@hc$C`*XMuIeu+$xNd+j9%hV6&1g7ryJ3Ix4gvINJt{ctwe
zkc>%@pwH_mAux=9O5L6uk>WwoE0pjUM?fWJPu`J6g;Y)IQY0NKhDy7hRLNsPnkHQ-
zp3W6RB~?$3mdAy(O~z6p9XkM(GCir5CxrA(mQp^QI{=jsJvmmM6f!i~OOZv`L8x@+
zNsT-uWNIQy@kQK0sAT5J@$$5gxye&XEW(^nsmhZR<=m8zwMi)D7jaIgROCrSP7T?b
z)JKtbutQLZ#*<n(E#zp@9mU__4nZXmPfnK8L(V4SQQ{r!FjR{0q)yHVxtc6T`FFU(
zPzk`3Q{~K%yUBhOF=0ob(t9WMa#qOOL>|RW+!3hc-N_kpcF5P{IZBwY5{QC*$ystv
zNNf_0@+PhXD)Dx5j+_@#HLH&y?_#A;X|<CEIX|Rn)*Zv&<w~KFW+&&%1tD#-@fh(g
zb`&ZlcG4&phV;#rWBj|^QK*F1NlY#d8Jg|Kkj2<BsC3pzlUy1yHIv8i#oRHt7?8;&
za(T$y>^Vj(#z^=cIFVc?SA?w1!ZCg^N5UnbEQ!n2AzQPWMBc-W!whgLX_jk4j%FQ+
zzsDViOMxr7Qmzj<n~fy#9(Dr056&hna$CsNY$5sgxD#+0IG<cCcZb}~b`n{ForE8N
z%A{2eguKlpi7(+!!sUQYu9G7nU$ciKmSAO2sh5)*<akJI7D#>xR|b_>IhiYu5>zef
z<46Wp4wW`JX_LnYnik!0JcBETN{XD^B99ZaEym+S26hT6<#Ez3PZ0Dimg9T|cM2+@
zadNvnNiek7k0VR5(@^P(lMZ=`U}_<c<4d{IP|1jsyX0wtxy5swSc<uzQVl1I<P^c$
zA{^(JaxSPu!bw6-6>Kf)6Uh768K@+|NvE79I9hZk@b|ehP$__uC33ppY%!i7-p9^D
zCHPH}a)#h)v7F%F=gvZ<?@gA;nS#5;egavBor6lwn{>%pg13b{fiL6EL8abR-Y(A;
zd@Y_6#4_wW{1S92mlrvL*dm<ZmvQHz(&i?s<UB#usy>N)fK@;x#Z9{9d_mKyJBfe5
zRY0Y@P1eW-g0|IolK23tgi2_e^vH#RzSVM)|A4E6N>`iY<YK|lYCnlA$0(>|v`MdA
zDwtZyllXFuf=V@;Y?aFebF1ehu^gkJ63Hez<O;#sDxBn(b2L<%*d#Ak3$|8u8S){<
zKqY}q`s7-{(W)!MKjavw6t79YTrW6Vjb+4#7=TLPniS+V!PROh<3Hp8+yG+9u-q-U
zTkT~CjzRbxNF+r$Ab4BJG92e1+z3XJF*zdmT0Lb1j#WV=PEC#|M=4^fP{!k26;xW(
z<Q;ibzp71Lj$~rhP)ScmRM9d0nl@cIp2<~1r8FHG9Ua%NZ8Me=nb-xWgry_u=mcf=
z-crtIau=Y|k&cXwPEtnf?d8Y{>>^aM(Gg8_in2&gmg6h9i%_XVN5)5Urz!jLo^oOZ
z=7vfYIx;buqKw50<@^fH4V4IV1c|09%kSz_$Vb>Es3e~w+Gv`x;;uV|f5csaO5r&&
zIhw9avKvnkA7PiF5_FE}q8ZA*y5$uA5qB9X{pQHjXr?ljZa;;Xu`5u?HAnQ(EM@te
zJcXOND^RI3M`lE`l^Ju-DZ-4^z+b`RBeSA8$|kvRiZ^pLP-!nm=0x+9fpPU|<YTNB
zDyij&A)2qOh3ih^A9J<v|LlGFUrg=)e`JZVL{fx_EHNl+*|W#sM3xAXCB;M$icq%1
zpl*p2O@v~isI<?O7Ntp7sgz2mluAQIYL>HoUf)0C`*^(j?Y<xPqM389>-BoBpsb|U
z_5?xoxA3j>An{QSLP|>56AC@v;<w~M{80|NNs8!+gi>zFTfQ?<C<mD&W#1D64coG}
zB4=DE2UR4sqbDBfvK4Qo&V)jKFLMUv*pmX?*UGn~Ggip&XIfCAo-8P`<|XhC5k>OQ
z%vscdo&qSP79@xc;Uf8i%sG@xPYE<k3lpS=h)?pc%z2c!rwZz##R=pg{7D|3X+^pB
z)I;~PB!TZj6w4oGE}%SnTA|2UmLPJ$#qvj)izu(2PH1ITBuHHdEC=x+<<p~vie+U2
z>4LEww1$*#j}G)D^Ah>4M2Q@vh1BI9Jt#jGB#K;di5!%K)U_UcXfhTiN?nOkIS2<S
zNslqq5{nZ_S6nIwogfw1V+tL^l0^Pt;<FrNfmCphITQxV5=DpcXE~?<srx;a(Eh7P
zlpZF^<RJQ^!h5Wt%2%049>!&IkoZy39vkT8<t6ct5an`E^ifegw$QOFND>{v<#G`4
zQPDkiP?#%Bk{%%{<e=B1WIYbhek)EQkKhV9$n&VU9w(@>l_c@S#1}cJ@u-9zSLmgc
zC5goNiyXvvRC138l*}rUq++5{{yK9HbSij5W2`cX6yr)cNb4xn;|KMxymx#zqDl@*
zIx43p0J>ZS??i66N)Ey~D!(TPidlv4q;AAlIq2jlMNcTStcu@}ZuqMlWN{SkiG<2j
z$vgg0qFN3rII65C2KrBB??gv&wH!omRAo;*l$k2tNskgWa?rR@H9aZNOsafG9>q0s
zkhD=`PZrdS@{;+-h*~))*r>*y0;miXB#VyWS~&>TsFt1*=>HTZOOFxX<e*QZls#3y
z6KcfC<T3nB4stZAqo*F4IVH(_ccM-X>NBdVrxj{8WyvCUTqg&y8Kvs!gw9Mwveca*
z<)AI2s2=t2t{P=B>5fS`NXaO!M+e$0c`1AkqFxTlF-ljZ2i25<6p;t6mxEA@>aWs=
zo=IVf)Prb{gD#BXsf?jCQk+71;08I!z^I`rQ)qycr0|au-{qkCq6}2N=FsOTOA#H%
z-{qk4qKs6QP|m1Gksc=+<sj;!OjOp;w5UuWkK;x;NVq7z$_82!d8zypM3Wp8Ta=l~
z7Ag=0siG6ONe%)nYKqDZ`V57s(i6lFIq0z{fyx2O3B{@83H(D2@+-<h<pfQGl2pDY
z(JTkG6*WiY3blc<RFNlcmV>y8vQl|K2cRNV>PfW7K}$s~Qh7t6pE8y7#4U1=PEpHL
ze$dXxOXHs;TIHaWqE@N`plVN$COU~*<sgir)~bS_H&2)*JxTnOgAR%kszRXzPn<@c
z#6RUAd!h(cBsAJd()g!{HaV!AD0@{5)YHk*M5l0@97Ijj4plsK%_-8PrwFASG)$DE
zDg}z;lxgHCtdxUfi4v)@pahPW&Oc53l7m8tI-n|mMmIsa=rsN%2SF0$qAG!UHetH-
zH1S&w`XfrLs)DXHaXNV#|CWQ?h;moeLvflUo$p1o%Rya4d8%5W1x=PN^1|(M5ED^e
zs!pghQ>071hz>buhbSMF8v4nU>7*C#kb_i+@>S_T*%&W_?@e^dK^a6{R_Q@=m>@&s
zjXUKa1fs5~^q~e!m?8Bh{>VZ1LrGM|(CH=4AieP)ImmpdK$R&JbV)M!XNbRYQ1wv3
zDsyPtl4Xd_;J<PZ@lf|wmQbCg$dH~Py5u0)p~6+x9iDZ{4Dt-_l7m8rlB#T=(~6hL
zKTG_RgCK{BQrSX5l^|1e7XOoj{)UQH*+JWsFjIP#=$3=rhLWiqpgKyNNuI^sa!}V$
zaVjV1fs$nMeTW`8h-s(<l`E7w$udPgxJM4!87NEffQBYTrqqW}$w4XuY6)+sTT*6{
zK3F9OWekN>ejU0bPtHF_sO2Dpp>k9K9R{R8E;@(Ra?rg{`Kq7}Gg2s*o+C7JkhxF_
zRcOZ?QY<IWVT~MAEfiKoLf?=?&Oc9R<sf3A%2Y8>9wd{C&SR|{G%Hl4Dju4E6msc#
zf|7$og{o1dK&_8bPM*h<926-OsmkiOO!5%_0zu0`fI>B@3Oa&G0TNxnv>fy%REw&l
zBZ?Fv=>>w3gS>=Ns;W8?NHHQWU`7sV5~zKt@5mt~i0@0VauAPDU8>fOGE#;_zL=GR
zRs@6~ogIy&0!e)dP7cx#_&e&3E>ej|U(Crt2|{ry9jJogW%2z89R$J;T34+Hy)J?*
zkssDUp!1;ntM#FzMVKY^BYGi_b<jMuF*L4-vq(SO3xSG*9;)^=h5i&t7XKpA8-Z$r
zHc*>G8Hy}RbP@MPAkv_X)Rxd}qR5h7By<r-GH4UEHMEo{v&f5B7l8tU=BsU>a)kGu
ze~IXWKyX2uscoS@MDSj83HL#uub`)>?Vt=q_+EO6=!-y3K?~Fl(Ci_8PhP@(5vV6<
z3$+u}bV%OwFBAO`h$ZMbYFFsoki8dO#{CdzBWNqN2NY;1-b*hN{SinZ=tXL8Xv0vx
zCokjv2$T=>GPNI6Tkx{^R|q|%FCR~@R0lv$g&<pW1?!<<ax;3ZItWT9gxS(7!~is0
zK8Y5pL!m)JoK0TA1CW7y3QedZp$<Zl&A&<vL?h%=X?t}HbUVnhMOX1aWGENVJJj(|
z)S$?gUL|;Fq<jYLs7`^>1!XpQ74wjh+=3RVv!FqNm&5lb1|bj_&<E57P=_GM5&7dm
z2=oNBi@F554TL#Te_}8K`2a0eS3yyMIEVDdgAu3&Xm@ozv<^se_}7Rb2*d%jr@9p?
z1Y|j)Yj_9(EdcGM?u0%7MUM0uF%*rHFQI+ZY6$mN=8)I$Py|dr?W@*-q<&s5KY-9j
zK<v|()p`)SFUS=IV0{EUK7CEC4;lKxTxkF?3;}IVOVq{?h%e411Mn~eEIl2lHidM1
zNiP37F&qIYPY0{bA*x=ME4q${BcR~v`)W(bomb>auM-9c7<W2cZ4DXn%3Sg~Hb6kI
z(^9n!1j6(3_&10V2>5h5N^J}2?t(ng4Lkw?eNIQK?I5aMm?ynK7$RWHX_?vqa@WOq
z<PB_yfE=ge)J_nhF3ICdh>-}ma5_Ql3W?~lJdp&CL_mGh$!ZUXH&^6IC4><IrkhSz
zdqY;aGLMvCBLu`YjnsY+JkI;TzeyM);IZi(bpWJ@3qFW$Vq*lfHJz^xf=F=T2kA{>
z6ato-R;WWE-&_2FyopC4Af;)nj)bso$p`)|Vl)B{nl4kvK=QWigXk6>jev5dE7kE3
zqpkQLy+xQHV3_F|bqYjcD?gC8un7V}nI_d)kZ;Y)=iesAAmESbMs)#%RSWV(xA7PR
zbTQqcE`j7}VZQV>F%|(kOe@t@5F;(lCvW4i2*_Z%LtXzTr%{s64<yDR;C|^Ybt?os
z%ko8mcpL(%msY7eA+1@FFAXI42$)@(Qmg-TH7fJTK+H!#<kFm42Xd5o1^ghw6ajBb
z>uU5M6j@Lp3c{ucXj;0zMjsN6g$2?eVmty?mgZ@EjUlgCTtEil@d#L0dZ@+}!iOaV
z{Qrmv2uN4jKw}O`!m<L<e|Q1{ij_9fSVAhWqCol|VTOQFrA;)}5b>)lApgT=2nbY~
zud#u=UfxIk9bzH^zLYl8*h2WO;G^gco``@RrKf1@AW2vFQF@1%gn$jD1sVs4#T9=f
z@8C%Y$WPir;{+MEl8^jgVlo1*lb)k-g}_?bM^P}IjDXsttu!8xKCAdB4JM`_U^3}N
z8gGb_RemIc@e~BaCB01J2f47kLjGOC905;BuhaxU$g7}GbQhZ=pe5<GnjlDQ6&6bG
z5>pYdkhD+}3h}GrLh>%2ihy*a2~8wqsY(j@A;dHU93yS7iGg5LS)nKdPeVW{(mOQq
z5OS(0l!g!j1PmhWs7ZmuQe`0-f&~Z&Lt3QCg7{IMf`5;gj({Je4`>P?OH`l`-NVxn
z(1EmzrUZgPg$n6CVg>^Cj}~jHAmvl6An)NB2*^I#T~iN{oe~BAJ~0ykw?}(wS|NW^
zrV!o7GZ9dEw3nt6!ZZ~M>3zZi0dq(DXw;C5sZ@~nu>}I6j`r2)K+Gkth#yK=BH-od
z%Njk%tP~W9La`+R8jilE(T4y^VUaYHn1z6Kqa_++NRt#7k)e1N0+Njm)R;mvq@;-d
zfS8SdQlo=4=8*F!D-u1xvk@?8^nHybWHu^_qz{NW2naJeTw@IZjLIVN0iJ_^AETuj
z8%R^+ed31^a}m&Cbd<&xq7en3L}7R?0``lJ*4RPLq41M5jF^Xj?4o5F2M8?`e<H*1
zJOtbp9j9@E1VYItemF570hL83Xj~yqQ1(d_j^`s_uArUG1F``XpQPc06#}9P<eA<O
z^r!qphGQ!PycCTzevsP7E9O5WtP#*qbdDwfBKQQwqKDWT0qaEPYl0w8PgpE{NGw1=
zGSLc6D1_sQi^+$00Rm2m#+pb-x|0<19}x=?P)Kx{CI({bWW}OKcp(DDh_2McLj;|o
zSo(-qgn%HTYcwg4C#NhXAK^s^_#m3pWI;F_5A!34#R%vhx=~XANpAuyiolBzusw8(
zrUYW!gjgCuEI~l-&`M1eWUz@b8G)A|;Bx2=O+5svNibhZEJZ-w&|R8VNJo=lkrXdQ
zz|_zxO(#U1DX>&ZEJHxd(3D2q)zzZJq!cehz{Aj-Mh8O3cqRNu!Uh5D!su%C{u#6i
zN<@*^1_8^$^w;|8Lq3?WL>fsfN5HBuJgqT=eThrRNW2^YiNXxknnH4yq=f&NSb=~t
zVGOk9kisP^5k1B$5HKW+k=7C-wG<`N$HYnmga~7zwT65wWeNEhuSCFqFnp~IgkAAU
z`A>*d2<Q&ROlu3tRf1B{6TAumyTMG++CdDJuvGelSdD<pU<6tR$dnS7l27nz1l$E<
zp>=|QC`l<lidchys$k}5T_NpBRw|0ZYY;FKjFr{{qMH<@(kNmr0wRK0r1gdzCS@rZ
zh1VkB9hhZWKL}Ogeda$UY!T25%t~zlBqRwwi=JXz1grwHRvQFyN5aq2r^Gr0BmyJU
zhC+6c_%rzwuS38YFoZS|f`}xa`Ok>;2q*%^UK<0ULbA`IXLvmVMu6F&jfaFF#b@a=
zLWqC>U>vn65ci|}Og_Ux1b9Cq(q=(+53h{>oY;T>-e(SI3m}L`P$qhgHy}Xs85eB{
zr0NLEq|b?s2*7(rtgV8G9B~=>9B)K`)idteddRzxl<}j9O$eZQ##7r0;We@{Q8eC!
z0EuV3w4IPdqbQR`69fX_o$=ACAy!6NMn+=-0nX0&YIPtZhF8vyA?y&q>da-W9t6G!
z%0)5Q4greJT+`}9dW*1J8bfSG0GcxrtuaKgh|9?sycq#R&ID>rAy-9G&VNB{L4b%e
z!CG_3NRgF`Uf?YV0C48M))E3w6y?$vggpYhn+exiLwbp_oP2@p5y0DwRBHoKB)kg#
zOJXYmG@FUi+Cr{~phEN#Z$$uJGtpW*2ni8ZNM91$5Mb4eOzQxNAL0t~CEkVrnr7m(
zP7vQAso=|q?Ff))CPC{8SsbzokqmD~06a6vS`P@;P*g}|#0~^FGn20MhLj9t1u4Tj
z5Wva|()xAlDtTY{v4jHx6q(7<26P)J1z$w5*Z~1(%;al>y3LfrFVa|ICjyL^QD{RU
zSwj4UjKw<<K*9{xMnX)4<O}~5u?qnL%#>+kAo4->Mf3{qLIC(OmD+g7Z%}-Zz9JkE
z;JZwXHl^EBsr*8|!j1^wT!z$UL9zm`lK-06jR3u68np!wlOU)Ry~eu{fVE7EwgfT{
zgq70Q#2y6LEThy`L4bj{l6;N#Ab?_-4sAW85lAZeal~E($Sc#OZG~t7S*0ir??nK#
zGAeB+<OC=xrE!D^0j|nWS~Zydm6c>179oI98BVJM4t`!0Kb~+xfSNM8l&>E6@dZ_)
zc<h7#C1v_k`e3dXR!QTDeF#8NhDRBLQ(jy}#^ZemAW&u~WeTo$NfrMMu^$2A$rw=P
zU}2Y4iQeG-2mnsTh_VDfx}r+@hB$x#&tyy}YcQ89tH?L_00Q`u;Zru?6z6^Aza<VL
zKr0zD$`)+jg0G^t_#gssl9@u;frnf8Rr;22Mu0^!0?Gjl+2XI{TkMPgdSompCvaCw
zzVZ`@LkN&YW)9^FR%zK+Q35`M09a(KC=c*GE51q-2p0r6BD09{1{1ULE17^@5Wt4a
zGRhAe$-HWQBH@YvC1h4o0bnl{RErX^D*{lESxW_hS6EmrO(YH@zyKK`6$-{*aW$EU
z4<ms57=nrf6R)J2pF|u%fbcQ)R17$BW!0i2d;|fY$Lyfu!CtGVmL?Hm1o$1}NTq;R
zR#{CZVKD-@juBB=V0`7(@ZS+`2+%p^0961kRzZ#E9d<(i#xX8b30P8vHPUy)Q3Ti<
zBc`grUn;I4-{GSOpf<*xst2>Eq=uhN97BMtF`iT_I6q}IqGWsw0g%RcQJrApRMbe5
z33mjz8RJ8#!IP=1A(OE?0+@{PrF6hx$*bk35FQ9nG3GL*2X0A0ttbV1AOOLbYm`1%
zABDBj6yi7n$cvFs#^7TV*ODptI0A%=38YNHlPIa>rxGU+09s5iWex^IS*<7)pFn_L
zG50A;a0@DGrKyA`0=S9^r>w#Hr>rGYu_pp_ijh(_;N#<c<EIfP5r9!l6lDvhJi#|n
z8a{~tdt#y~J8;+uze&@GQwX3YMn*Y+T~7RsOv9%TAWKXf<pkb0$v1vFaT)=T#3WFz
zU}Teh6Q$$R2yi2)gY^Jcn&O)@o$x{c6EW$OH(1P+-^g_Ag#Z;|5akDcF<u=%gYZTG
z0x>yM0GPi7b)pRHjR5mu@~I$jatZ6C8N?X`5D%lELcx|Lt|K$>83c$9gQ-ZcSV`*m
znZ#KH01i_|#eiQ*Rwv5DXA$5vOeGZ$<|jp+G?VZ_0M9TrR0=qmlyzh#_CbKgFeH@)
zwj>_OmlNj@fG<oVRRA6%0V$H>a|o~&riCg2!;p}a%8By`pcO_*Re}3QOp<bZ9s!a9
zO}F)6<&ltlL|i}soG@KfEBJC`qzK^)2yhbczI1}gMnOsu;fnwk0T4tDju|CMBJ7I*
z1z|YKR|otryn22X;fDbAV0CFdFtZ5iMOoMn0m#Ajr}e>^BCMBY5f>3a8Z3`C2A7Gr
zp3K4*5g-`sP}&qMBa(Xld*TuTz=AcP&B6a6s~5e;mk{6+tPyPqW)4NY^gVGI0UW`a
z(AMD0P}Y<0@nr<)1Iwpvz-GZ~;Aaz85P%J=8Ep%m2|<G>8(%?yEwEE)J1{^98>HF9
zRRmB1E1(^~%^+?dv+-2~$N_6XJApMp(!kFl{1E^J>>Sz^d<L=xQ4aP;fD5ozv<H|5
z6b;fG;u-=NfL%m;g9AX>K<40U2)2H98SMvhe%^O}E)jrW$!Ay60iewnd>7^700cWd
zyOs_Dp}p|CG?%!JV1;LebSQ}C#ox(Xd>z5Y&JuJaDBvaE`FX?*1PeNAPsf0qUG`m+
zhi@R*$JrfpJZRGu-=%qk1i|{vI?^d1G*^Bn^RNWLw#|y@EKrT}8u=fHn+TR`_5fV~
z5^zDI=mWlqV3%fH=n~L#3mc^$h+7C&XI4yCfjC>-NPfV#5Nyh<J6#V-Ye^$NpSX=+
zF=jpKR*+508b$f|HiA8v^`bjL1FdM3<`aPk)?U_!R)e5f*+}N&Km=PZ>r3l^I+@qR
zFCc;tEVb-qS`Vbgf+kS`4nnZPve#&R&<zWlqy@x(2sTz$LK}kySlmPw;QtUTsB9o@
z3W8oq6aOP|2f;qd2Gi!C&XqNZKH@tF)=&06Z3$9aMU(U+5sYBlWW#A|(9J5F$d5P}
z!E(t;X&Vs1@_z6OiMt4PNj8eM1x2giho}(WMX)-u(X<`NQ-wdIg+vH~O_7z+4xlv^
z{~!x-2!h3sjia4FI4b$UR}l9Q?15|o?FuST*$<Hd-$StWvB|UtNIDfiqzd9bf-R3t
zr@cX+sr*4I@O=bJ9gAo`5L@z^`9(x1f*p>{p#wlUDQFfI;ZOuC8=FrDfecdEEG;4)
zAlT4Y1sw{KMsYJ)gdZSS$XHBAf<95w%>P7$A=tmzGCBsthO%bSCme=g-C`^0cu)>1
znx&tJa0J^GTSKRS3{crje!}4hmMNB`vq00wYvC6Y4-xE6Y$II&0zE;Cs2D#)uqv@F
zbP1^Kge}ry;t_()h*i>6Ae|Gpkj3~Bf<=h!pzA>gCu!khA_BqQ!*<cFnlcEZ7GWHL
zV9jAwbSEg(6fIIrND*u`ECrw#=*^TZB*sz%TMWz5Iv^h7wem}dNCZm@tIOzt5=_u4
zD#4KmRur~BqYtVsVXL%+c#L2pVR?)(NVLSQWC?zZU;$x=GNz!nlC<(mi6;p54c34$
z2l14wRaA<fAXqP0BgPVxP>NP*DG`NWn_x{CYmhZ5Tgg%!g<yGL`HT%{lz2b+pNXdk
zb_Ldqu?4}A;HT&_eu`i<V5cy4pdJ$blzt|jA=m_10pkEtAn{M~Gk%6(@MkR;C(!js
ze)7wR=LqI}b`IkTA|2UJQ5k-YV611Y7!Od~D1J)Ih-d^;JiCbT2KkKgCs~H05e)6@
zGR6<IFuXQ?IT3?kMrT(t0U&G<w28`b41$rIUCRW4NJZEtEhk<en7~;f6AFqGaT{5V
zUmzH`S%QfK`G};AUqQS?FkiFwOblp2WNo4f{1U-9&F*00LD->alU5Ki1k*F?$fSTu
zL)k`FU>Sm8nH4cvAi3Zv`Co`w1hX-FfGGg|gg`0!f@2Yk!mJBZ0%8cEQu>8>g<$e!
z#Y`0_8^lWT3x0)Q&}H43dXOndl>AEKHG;X8^<-K>b0AZSD)DOsV=U{%bb^3Dp_En<
zaR{bX)`wAp8bGNeD{&lxA(i!Ibb#9D{o+><@d!pz_A;XfJiXwTs0zm;m_XTUj6QJg
z!e7!V;thg<la(;WK%k3%kyZE&g87mSWK4k#m;B;?CEg+!C)r@e9H?#CFVR>07Qyt$
z-e)X<r&j!uekBqR42x_yV-2LU@)!9PCm@&&St(-!3^MOGznVxyFbc9!j4jZ?g5RQQ
zoQPoZW1|^6;C6+-rPV|df<cd!F%Ce~ihq;UI0?aA$Hp;Ez`9C)^J|EA2*x-zfpG;2
zRrXs{gWn;T+Ms{l1NczIZ)pvYj9^G((;06dH<iE18k~$^CSwuf2TUceonK3&AQ-{e
z93}v0M?t%&7N;PXxY&Fq2q;8hyR?=_MKEBo3MLfzKyf=+i&GKIQ!Hj8f!vd{^S=>k
z2*xM2jEMoJPS!5^hSLyCOKc?*544-2UHXkkM=%_*HB1U{Xv%i-8%{?s3$Y}V1%w!{
zgI`BvAQ*kvMy3GREkTE<4rd^kbl4WA1gI)uhqR8!L@?N}N~Q{UCvgW^hcgk(F>D7@
z4<wSLgHIB21Y--^#k2w=B<m27SdL&yVO5N8C-6Ip4k<|>1XBr1F=`-dlpQ3A5rQFv
z<rp1cUU;4SdLj$K$ieBddcdLxpdTJ*A($|@{;WPwB0}g#C*C6%C^#N#4E%-|3c~Sw
z1oHzolr;siLIMrhL^gtPfiqyufq9TYMKsPvFdcA4tR>J03aCgXau5syoC#|UoPZKK
zf^iOlyPxB;HURMRpd^>bMR3(~W~?os^#W*##kmM>c5Vu52hh6^T2hHT1Q$6cU>yKQ
z7eh@b&O>l-a~7-<fZ`J9$s|4?xTd)|tScbgGAN3~9}wKioE7T<aJ2%85{Y~SmoT@8
z^#<%&`G;)8`3UY@ZW-$bKr#=i@`wTiS1h-Z4FFJB09|po0KtvQt!0A%;T1wx8u1aq
z1<DE8P=IU2P!@(iBDgO(f{g_1RRV2UL?MFfk+WxG07#WVTNExta2s+v*myui6;PK%
zC=gtJoFkh85T_FQg0KR?UB`*oEWj&yP?$p$A-LMO18f0+j{+!+!9@seGR}o90VGif
zjVZ(@1Q!=4W~%@e6hmbQ{)FJ3;@sJK!1yH4nL!jIxRy9iwiN(78FWVAVg$Dk=f!pc
z`lf)=1Og+tbT}VY4N#gAS_3dfaK&)GtPbE}ynp;wq6EQ>!d+(d0OJxsY&<SOaDi~w
zSbYGjgpiv~lp?q<I0<VE=#v<N!*MBs>wyboO#w=hKyo(m8NqG91+(UW3&|ik8h=J`
z_;dGJO8|Kk5S>hvAvo)~aMl_S8zp21<1z$CJ11pr0Dj>?crH<n;3VgwSX;nS1P~sJ
z%Ml#hTr_J3z=#miQ;7-$=QJl{9RTGJLwqQ%KyWN`ajX+S7LsnhlK6t)6y_3GSHK@+
zkROS^AUJfnWYz<~1O)^r5|s$fST3FQ24p}934*v1!I8=#)(_Tv9z^I7RR~T{E{6?(
zm0bW4a<~e?fyw2wL9l-dAw!M$ir{?Y6l^Fg(_#n_!(R~`ha6@jVKbIMiWX6g;Pm6l
z*ce!IWso9;s}US_TqPS1JF5a>l!zJxXB$_;roaNKgd8DUgWxFRNHz<$Ngf305VZ(S
zF0PR+fYnd{K{B`&!9m5fuqCkP2_Z>^_=ezI;*@L^ENx<l62adP979|OTMrwU1hO=U
zIs~T<*Twp_!agN~FbQ0T;FRH1Y$q&73P@8RNCbxpN3m+ybd(S$fJp>L2*<HHu(j~O
zPfye%I59X~P7hWP0r<&rJ%R&*>(A-KJ|P4{HPL|JJm7eoF)RmSa1`SP1g}3glrx1%
zUjmj|;yZ%3oipIfVQiOyr4)Zh@N#oToF&ZQ3h-1CjR@Xl&V;jufm#WsLfnYp)#dn{
z4NS*8aMck_2;NlAjI)JNR{*Xu+=Sr8<fd?TFt-Z9Rz>_k@E&pk&H;u{G5Ct`4+O6r
zXTdqaL@5Dd4bhC?E#u~Jt}q_Tz*vHt5xi8K73Tr7o&uZ|L<@p<h+D*Y!{DaWkWkiv
z;FaN)aegp_@jzQov?6#zxRqQ0OjH8Umg80gF9f%i3xe@T2;yquCxYjn6LO(2>xe;J
zjDI3{+&O}aguz7u>RO@=!PCvzb1^W5$Ut6-+Ymg=+zu`tMhXS!D+winXP0y2QeZw%
zg1`_f5j?7#h|7Y@o(BRu;unG^lRLl_z|AcHg&F>Z;6dbExDvRAg&?saej|A9I5AfR
zcd8gPM))^^$Bc95>fwTvfX0SsNAOf}o?I*3b}|r|;C2KL5$DBq!que!l?Bm(;E~~c
zI5pfuN{|`g4g^mK=gaB9ox-E}5K@5Pf#5E4dT>DqfM>>?2)=*r8mAAZy%3020;;D`
z9w*_9;pi3v(}@2d_;$HK&J@mJ2{3I0R70YVTrg)2hpG&yCj1w{cgNl5Ea8My0M|l5
zbrbr;g>%+$+$n)<z+DKw8BWUCz}dwEu$_Qv1yssKakg*}2>@-z{}6ocTr_6~r-~5Z
zRsy1rQ3WUC9N>r$1Kx<c5qzp#9One@y9Dqy0-_1gS1y5bg_l<bfD`UP@R@PRoCmy#
z3P4;4hz>&ExOC1NUMnR)4p@cY6X6i&2d@YZR&D~U{iuP<;R4`!7r@Sm)d+rHE}sj6
zhgS$o7Xj8g^n+7yq3|S%Ve7ye1iuZ3xkz}dBrtUoAdN>qxiT&Wo)H<0ofxF9NXb=l
z@$iK!VD2J7x`uvpHCzgOdrBBQFi25Q2S;*Q@Kx~O;w6AuMt`_Qt^ht)0o*(os3O$G
zwQwcyAqnB=B>?(G-JFuEg5OvSXAcG_2dTIYZa_W!`6cl35wM#f4cEoB!XHKkPalR^
z3xUdm>xBQZ0zQ5M&Q1i72d9RAN(uje44(z!;KxwM(C^Y@!`mT~ryEAr_kq9cXV`Dd
zd>wPW)})4(>bEp!tXFU?+}ACnw+{St{=a|ce?R~G1pfC4{O=R^|MnA@U$-W+eb>o3
zL$Y+=F1>ha#oET<7ViI!PaJq5e^=A2`3BV!1sQLxrYA<9pPu>o^OD3hOQ(0ICeOFq
z*#C9CS=h$U^wJz(Gs(nB1>;HtV+Zx(bPR@HYRcOh6QR6r6<YXo`BQae;JjremQGdH
z%Vp;353gMpZVQt|nnot%9&*-A>?ez@=<3IxZys9opLLG<zT}<rl+AGtlhm(9_Lk0C
zp5}WgI4Al=%B&aaeu{TYZb{3#;lozl+LStA_Nb2!{6FY#8e2MS%<SZ+2KZpt;>o&;
zMXBVI1x`Ems+Hp1vv0=O?jCW?G3AwK;jg}rO7q$;2VOhqm2HvD)py=+GTvJ5yLO(V
zV%=hm(czad`)|zciAsLdbUx)uUb4rCh5*I<zh*l-Mrr+9OSroUQ}QF?f26J2n6|&L
ziW^^MIG%UsuH0>mrM&GmDbG8$-Al9gO;OY2h1stM<@${`zBP<`n?L^Fms5`n_WgT>
z7Zn<XWlhOhU+G{Mc=XWXf#s`Kt{Z%I_Rauz+tq{LRvqcy-uh!`k@=vRlXee^?X*g2
ze-ZX-%(JK0@$TUVzTf+g(_QXvmeaEKux(-SQ15-W!#5AeSGLXBH>gA2vR8kQuHc|$
zpXxQgUu7pG&D7q=t@8SILb=s#ZRECc`7GNb2dqbZYV%8vXiERtk{7huCCv6-*3#q8
zIwm;mlj;9`(?8wcd}j8o(pm?zk%wlxUmI~QyK|R=cJe9Vi7Smcy^4nTJr>AQcgew3
z`(~T+=Bu<dBbVeX`>Pttt8cG*OZ$g~{oAfLrkXc6cBH}RjA{ON-^d+C-1c?4y=d2&
zADWrd?>1q_L6;wWy4!zY{!W>5*YRDZouB?%Pc$1k#e3#&*TaV%Ivlxp>t0jFz-X6<
z#}h`0UZ-0ziN&_fy(|^RLwP|hpLE}IyOUiS(xca%*)Sv_ZVB`e)%&ek`8T3&eAWm@
zVZtdka|DVxmR%k<RlU4Pl{xi%MdAKV_4=){*v!Af)(_i!=k}d}Mb@vK0(*Q`Y?|0;
zVPm$`@1uSu(l^VQ+0iN+vv73(2NeslLS`LYFx}Dm;Ga0l=Pr7e3ZzR7az52icPCSx
zb!0&Qam^D@r~Tg*2i_i351wo{q;&XN$LBiHNwMD+RUbKZu;tvBs8M5APa_&q$M)U4
zZ<F`E)x8b<^2rEJKMMVQ(Cl!r&+T@*RYaoc<(V<TA2bG$ubmyPyMA2R?%;iO<oxe?
zyl^`QyH~S&dOrFbat|5qJZtNq?V)bdpWJ*fuj`}P+K}-*V`l{J6y5H3AmX3Lg_~!u
z{}sLLe=F^xcEIfq_fJ~8kDhKQnD<7SxaZ>WFgNjX+CJ1|$c!*ytgFMn0Y?))w*<uO
z+@Uh*|3-htnKw%kt(C*BoAxCaKc6%0&Fq<tlKNSKc~k%XS*04;p29NI$3GvgyL<Gf
zW2X)XHsy~0UgVvmy<jR%8p)15tz9*sVQ+)*$W_WQZFOnxir~Z_{#kAPuDcJ5`1^2m
z<ieyCk0bqEZg;Qy;%I2lmh#Kt>fB`~_!Gr>54HqkeSQ>KGv|_lNk5~sEnnZedQA#8
z(zRQZdUwdf`(0ku*ZOPslUCzT1r3v*={k0;uj9@G!rWK$zyDnFbY1cOkTYKjO;iDS
ziP33iP7b$Rju*bI%iYu4+*q~y@n(&#<>UAB9X@DZeK9%pt=wb%^M<SwxBcsT&)1J>
zxGb>1&zIhA%50;~ZEex7pDwwwUh%`X+PJA<+@yY6CT@BXvCQ>~?VHQDzH#MIR-=bJ
zE?FWQeAuswf5tujJ|PkuZ(H~}wRrg9`^{D}yyGSm8Zgy(;fa2ICaqeL{!yXmC^cbh
z9p?6)J;$fl=YV}FywxWSOk%e*W@Jj2y7^X5KUc?Ed<r^dzJ;-0v#_Z6^?I-pSNz#=
z|LU^?AJdNPyw&%h8T)G4;Ca6nI!=3&>W|zKXG)x8!y3ybT~7YDJkh+D{owH-^QP|~
zUqmln@$q|`wZ(zm{rA;Zh_x5|&$)k`APG=S>^t3~)N9Z|>Sf2g-{e-)Wr7hWOaf!=
z$8Mh4^D1N8{O!_}IuG|<;hSx?df&IZc-8~+lNT)9^5O>!+%e;O;kkx2M?G0e7W?!_
zd<K6&+&j*`aHP&vJ@TJJThk@$6Hmh@2Jd;)gI2!((DT4FH7DGdS25o9(Vd_E0}4jP
zCba(Q%9=1&vF7Fm_YbE(3>d%TXq@v;pDABmH`}~y9ppX3!sgb@#3#pwuQn-unIPX$
z8lgBfZMgq{_WNZGc7II7onNi~J8f~pkn(@KFzwHrAp^8c4wC1i4_0g@OnYB*eI0B6
zYOsBsn?ovp4%PJVu4C<mdDHN-D@#s(`?NWHO7>3u3+^9=m?TJRUGML4nDsMbW&OG$
z)!2UyjbnB=78^l@+Ah>|JO6-Vg1vE#{UV>S(|aF!Fk)1k{%#&B-ZyOWp9bSvvy0;!
zj70xp_V#&lSAKySmc4)8qn^3iK6fVecJtX|a-?AStgV*o@@w<1AC8#0JIFq^j%}WJ
zaDm016Xtb&--R?b3f_cH^x3&&#+zFo#y`8i;8)qq(H0+UDk8nQKW@ymFrDqOWyP6_
zCl)6~Yj^S@9WD$E`C?oUb)d&Sz~TC~J6?Y;{eAvsr17CoAualshE!E-lP>)JF{o*N
zXY}!9hi+O2Z1r6{BSS`O6VuBM#caLatnJJ@JLlrt2i5ZjT;G>#Z@Bc``nn@Cb{<}6
zD4wQBtnPMs65KZAZ^btqH|w1}nQ0Qoq{NMS+v&3B#lz3=?RJTKjq;<4p0~Cf+hlp{
z-lw_rtA84*@bS*Ob5DBpcn)3jIC{_9vHh2vHAXe%L|OERlMl;u#Me$uV5e9{{cKxu
zZ|jEzw;q&j`rUigrm&3dCYFUyPP|N<c7DioUhv_Dc@afdZXP^F{+Hv)+T@ec=@!FZ
zJgfWaF3WD%lsmEEQ~HGO)~ltlKb8#R7sXxan!NCP=K0zD1w(5ed|BbGFSb-JU64^Y
zKYGIow~=2?AF_xHSzdec()}h*dvnB^T<z=dXE_7YS+k;>r74G3zlwEmFYjFB?>Ax9
z$P|}v`|3i6eZMyLVachh!bUGQc99{wa!6pw$+MDq!pec!VTMyT4(_RlUJ^Lz;(6<B
zY3aR=FW)mE-tPCBZOhU}ThDH3>poWN4yN^UF@Eco+*~#DQuem#nlZPM`!JfjE`@=|
zH%`3ttg`L7U6T8Hkt@^7<e*n^1|=wDgM)4zf98lUZ@=!Olg2X(Zn^kkrDx|h+1NMz
z7XG~RTF}7d_i5N2>2w{PE3>~aWaCCDB{XxX&I$JNIGK}taqPK&r}m!G?QOLyo;XdG
zpFfy?&$Ha6M{K0dF<3KMn{p}NZS=l{N!!kDNbVy#Yw=`N+KB|^Sl+s_`lA&K{ER+-
zxjWl=>&nBAhyVUFb$L^zv18WZC7zd_o4l~F_&3V3iC%it=}2|WqhD)qZukiIf;p|D
zcW}pzdza?wUfyUrHa?+X_qZ<8+g&XY$&K<c_kw4d`5)V@^W#wEDm&W=3zGF;T)yW~
zaB1RXpDhJ@on2(*1GcoUH&_|^;KVBHIbVvOt-ZanWo!6bvGm!kLpL8+g#2Ey{0%nQ
ze>1ae*k$LW)7N_P#i`BZPp0(x^Ymd&Q^>gR!Ko|vPTkTZt}2+v74O*pJ=!!x*ct0o
z6y)dcYPhfGa`qX?!__~w-hA8<<=$uKx-YhU#=V-ham&!_H;(L9yY5=>{_ot&RrY?T
z-9}ey6CO|Q*iQGIJa?|6>-ze^Th=6ITlq9z-`OQus}nb2U7rHOtM8T%o)%Q_bMt=Q
zoyCvFvfpMl4*5MJZs3%`(~Q?Tna|42X#aZu_=4EOy<`vXvSf1QM0Y2@6D<SgY+V1+
z(SbEza(A=m3A;U^=T11^5|4Z~C5tyxoxb30`PWH#*0*ZP4~8r~V%cu8t+Rc)`D>ef
zBW*`$#)S;MXu8#L<wk>UTd#QQb9G%KoAc~S_d9<&{AXIDM{}CevhRtx*3EGP-fZZr
z^_e`pwrsv?vLrh6Z?g4#Novx%m5YLl3~#;o_xRA-hS{F0&&_jexVosbad5As$Lcu~
z|E<{dIk#(J^27r>mJ-cOny_@jfC+VG0p}0Bn6fXxa)Wzep7l{h`<M@_KOmE3tIi<#
z$Ms#eQzk7d-|><Qo>g)@p#A%U&E6in^K~P{GZZ?`y15zC$1V7gwvlggP;YhE7L&n)
z-M`BsK3BYRf3~mn#FP!x$)Gh6(Hd@Q{0-fRIZ=k+|Kv|sPv||}I4SAMh#Ebsfh!_R
z8jmH-tho_qxy*FVnu6aw-VfiK7}*YZRsQ#eSiU#yRZy_Ld&vHw^(83-BQ|qBf~1`K
zoL}-h+e(jhP1(b<O4l4FdzaRkB!wNEynRzg%80tP&PM_^8IpO=Z4<-upB3(U{{5ra
z+HJ(CX2HXEp38pd-R#x5K4?#d>(c|j8jbs%*kF6MHqn3CGRwvv%Z@C1QNP}ODDi1b
z^5b{=Y#y#r-Zjh2OyBskPSN~g(dmk+?-{-0+?vlGH+XL6{<c@&F$3<_ru6-=*nj7u
zsNM3(@?E=g>rVdCYx*O#+V(DBcCpKvW@5>?SMloyoH;Z1==S*KW}AmbEwIy8EJ?pM
z=TODvLB|ajzWjR%e|33vuzjuDeDPk*=KbA9Uh^`@J?Ka1(aGbUl#eJ-m7GW$uDEq>
za_)puNxIx^%b%woo@9qvWp9h!Kktv1{K>VsfkyPfqKD`2?!@V_x0<WFmULJjkA9id
zek3jMYW&y#Owu=()jez5*B<=dDEY*eS;hl>sXVJ3i%q}#^}GId!i}c2Z&o|l<BbR6
z?Z<x2(m%E|=(U&j>*@`4{_{pG`cl%<f6AK_QCZF1;+d|0Caqqg<2kqIWBcn5+wRwF
z%fHr7^mJvcLiO+G8wab4JvT>uckT20@XGO`OjV=bq~%Q;mV4SwDg4kH(Ko`l<?$3z
z+$dF<{<Y&&$hA)A`kjmWRF3{T_pEb@FwfZiLGGyQ@%*h1y@%Z$_^|2rI_bB+S-mp;
zElCOs`h4T_mVwiMbB3ehO=pj?Tcxb=JQOMz{6c#>>&~#tSABhju@_c^<T=OLw|Crl
z6ydQrbNIEtrt7m?E_8gfNEbf7b$$Hadsnt)>UHI8sEOI<J8Dq3bbGJ&H(aWx_V{Ts
z*N*e|Mv~W_?_PE8pSo^^Xs}oDF$rfoZGG67am8hPJ$}fKqF0F*n#4;Z{l4$nwaWg?
z6w?zUvZt+{-q3SyTe0eb;oI6mYy9TSx1T1pWe?8096V%Dq+dWw>P|<~a`Jd=e@nOL
zQFpWZU+VT9zGLs-mx)K-L^;0r^K8xYn<c$A?^v98z-{_ByWFW$o<-h!KuJ&PI}Uok
z{KMTzlAB9@&pztDXi-eJ=>Fkb52}ZRE-ma`VRxbBiu&7%OMCVlJRei&8}`Mp$&~r<
zcETii*NtDXopBEg!{>IcyJvey5$@XL1qRNB7lCNJ3-i4B#MGi*$~A{l9z0$biSTe$
z^pm|w18@6QPfHtcG2AYzUNwA8FCl~L=9sqcd2jnPDWk2qZ!f{8;dknNd)HU|WxLtz
z^B?@D@GFPyIXm9zpYeq18P+aq8_iBWHuw)Md2q>VS=%B@d&~F@q0jzYh$5!EDYNL?
z=G^zs#u>PNz{!3KyhJ@4i+Ro!!mqxE1GYQ1&)Bs<G49;_5ho|tuWv?+4_rSZA0HPZ
zGz^K@9qQlw$@%C+-+AjU%zZyXQkZT2m>+BSaGhsL;6RPpkfU>Q*p#i!rg2{{PkYE(
zKAha()W>yF8nf9zXEq(3^HyzJ@Gq}=W|4NbgTcp=U&rsS$&7dQ+`08(gUtii8*lw2
zt)n*A*xS6{w{hn<@0LiL2Fb#U<i#(KJr?&{l5|)nbVRN9iiYp|egt0aKV)Ki-}%<>
z-!6PHBWU2hcg;FWPx{@k_N%H~^tufqRWGfdeXLm)K~3rC_gnq&QtS9f;*f~LU*0Nv
zP4Ik}-Zb;OX2`FiZ}MgX$)F+nOYXhASaGDlF1osgx?=wG>4Fpd4%%bK51!>qZ(ARf
zG3?UWciUqhOI-}PJbm{wI?ZjfhBLBDRrQ{myzbt=?Yzr&tiJc_%HKPtMLt@y@YZI@
z>7l7n_g~d{zh1<vV!RF?UGXciQHUBhTebZyzqo&~f2y17pUQ%nul_rXN(7xhLNj7K
z{&l$NxV@i!^R|&@<-!%Ghi(qKt=e}z)`{nQ_&N@o>~=bAp>N1i|LlIF)cBNb*`xl$
ze+{z?FI*fDy4(9oP_vcm*o2iUkD3i1FyoMW04a`Wc)j^$<K9O(6=Tfh=lgoOIvDl7
zk>71|yT`$Mymh|u;B{`}=)a$R63*4k*;T)j9UWiXvdd;}!@>G}<(G!-s+2BYg#5KJ
zig!ZCZ3kmp?p0s^zB#a3JT0!w=qznF&fIO^ti#UcJwAv0{<sY-T^i3=^-R1MG8pF#
zF<0N-zF=KKNb~S2+v|gMg)3g{ZdjU-%zmC0dhYf2;ju>P`Oc$`GQT#@4kyf=cND(R
zi7)E6WN*tK_de7Z!MItT^(!a+4&L)A>E5|VQa|CQuKnNSKacg^Qm6CJw&~bXnZVxL
zA#bmFrp?nbamcNGgReRD)Y$&?SrlTWs!Ru`!la{nPd*%!Ll5}(K77q77x!Yf(Wgg@
z6@GK58F7|9@mM6<<Z8gLxaDyI)r8&NYOGSK!UA$e99_aK_mWM}G|5b}XNCpp{))fd
zd9!wT<Fpt5!p~o}%X;~8>i+#N?!Uey9N+RP$DR9X|0msYXjSm6{HEYs%ag&u_jg9*
z>HVBpw=8KlUA_ORb=ZJkeoC$AbKK$+ukNHi+vwc;%#vg4>zK!R6PvF))!sgQ@AQx;
zcKGDzIGe%q-$YrA9h@N-3>6N_9JVHKDP3ncPcAq$-TOc48N@j3=>K%lYqNp-9`jEx
zr~UJMrR^0PPUw^`i|Fo*IF)s3sd`J?3gddi<xQRC5n+LsH!Sn@D@|BvSXTXSZs+Y2
z$=lhNg+Z5t&Nr;svAN+-)$wN|E=`}ma80+24ZUkM(A`3iZEM{f!3%m({9)9!&D6Rm
zr#L>>*;5nKj)xO-#4<@kzxc^#ZhPC=W|S7Tea^ajl07}<c1O@4e86_p$>Yzx{8P`a
z7dZTwe&kfAk>R~*yFNId_KUN5P#gc#Xl7=}=2?$q_T8gCw-1{7Jfv>qmj}O>zw{So
ztXaNk&!EsJTbA!oj${`4cWn5#!KlurrQ~!>RFg9PaODzi){_0X(pu&25g)8J?ftd9
zXYsW0H=he^3w*}CDS8<;qtEk!SFT)}Ju1oKyPl2PLkF{^->s?)Z3mxpZF`a(<<pnl
zN=G}^-tpYzHs+$w)f1l9X$O1avnTD4FD?$u)-@7+Qu)5lM{TV$pT2&5{H6cqiRUcd
z>V}$ZxufjkCh%4rdo<f>>9~_O!ba4NexaUeZXft<@;&>tOK0uc*zECWyvM4YI;(D(
z<X_(J^7GT_DUrk576?xzPn{54JAdYPmB*G0dXZ>qjVZ58^tI$q=lTu)^V7MY?9^Eo
z?xTB|+ir?<_RD$|8aIu<7XI<>!J~y6Vl%piZe0GT_g12QgZ5Qo;PksIq6{uUwaL@J
zr0<~YIqQC9T(OuDlN-=9_~xYj)~?A%x_pmoul$aWUa(xUzpz@i^-}O2D!c!uuIh&#
z!}+WE^Sq9@9Uap?qw3CyF@J40{jHtYCH#Bss?%(}fvH)q?3=689a|TUX`4~pW;XQn
zzUP)R-BlOc8ea7GJlbGlWs_<j6gt@X?S!zE#eMU11y5#%#zuDA&bs2irzpap)Y)R!
zi2?1tt`}m`rDyG<YWNq^-e=V{uEcrG(P_ywnQxe?4Nue){A$fjUKQ(P${Zhh&aY^n
zRVH{LI_KQ~j{VugGdvD_U1fbc`TLvHwGDl5?j?@7Uv99RXk_vtL$_aebnqi%X?JMz
zvwt#Ayzc11ojmjP*27E<Ki#>~ws3sfN52(2Jd4S<E1I3-k6X>rS?+E6)?)3<=Rd|w
zd*W;vOKhE=GAx`W7jKTw|903%xZ{qQYxt?)^{JAt^VzExHaJ%nW#;@?yx5D?%Qo;X
zX}vo~fByr+1>21!TShU_YHgkEt5b{Y9vXhWv*S=i+;{6Y@jSOjpZRxot###>*Yz9v
z!tQzZ?U2joXFZNy5bR-pEO9<Q)Ze=&uy^;(9}%8UyI<VuI{E!)g5My?Q@tI5wWGKC
zSVdc-YbHj=I(`XO+f_~4<#nU<=8wNWeu<n)(-#jGl&*{)>PFeOZJggPr(t|=>$Yn#
zc8=w(ACpd-J{V!^<N5aBq@kk{2-DoWB&XCXdp76&RF_omZ)h83KRu-9nYK8<&t=x(
z@UEzcDI;I~_3jvQXGh$XeLKx~8~0AgUS_1JO9-C6JK>$ltdm|=K1Cb<O-_CP^UuA;
z`?im_*1NBCaku||V;k#SSr+vrOL?R7^~mn<&$A5UH|Ac+9&piqr|!_#$F`hs`^??b
z{7TM`NS(ZW_L(6QDmDxd)aZu!5REUkTu}ap4&EQw^iKLcew*#DVVit>a}O@2(8a^w
z93KvFl&v`s8t@JhG5;)I9=r5GTFHf5-VM*TEns+sGj4v{>GtdS_}8yoFZ{J@9Oj?@
zCN8SIAvQ=yaFXp8Y`?u_^|OE{|6V=$a&?r$h0I-#avvrvieE8vZiwod-ZP7~joL}-
z(pe&x-EUql>U0P^e{M_N)Q##Hwl8v*O>R13x_|YwAp57z@4WTCh`wA3WAg<nuZL$H
z`-ab7`kVOnMg6q8C2a5eeh1@;L4Rj`SbOM9-G;e4s+A~Yc&}+a=L4S}I?8639NFb}
z_TEf}sTh-Xft|YM&l{`u8&4))bN!H@esdt?PC>R|@xf1rJUw%=lg`bK`uKHh)6aqK
z^x?ks&f}y%!#RikI)@%^%KGDQ=(uj+Mz?<N?=>b__MaPawYaF%^)<D8@GXr<VEkb0
z9RDMo=ll8(k(cndR&@W_H!o~RpC+HU@J)|)T6{<z+VXb~%KTjTecOV)uP^_1$Cp@K
zD6!5SUp{+Lo~kCa?#{QTdebc<;-21nqkpbUU6OO)_m`V9CS>$_-d}km?3nP&q=~%X
z(7(IiG8@#XHeFLqEi)Wfel@=mx+dA^{g3@yr+0IUZpRxQao!j5pnXz)_ui8)w_F=+
z$?qC`{_`>_>Gioh(&uzS<!7sN`;rf=jwrc4Y1$*Ft=sQpcn>gNph7VRXD+$pJ~l4V
z>}u-y;5YN1z5VSlafq>gVz;h5K)1vCj$gsJx#Ydrj-5Mumk*tKxJc*n1!0tX+Te^Q
zZc#ti)suJi{&D<siIE{^W2e|`oZhc)<5lx@PuCbdIletG>|-lG<74mjou6R(8x-Vn
zug`?&bG{wRkBrYla|RTg*teb5o}aw^LfEIAkHaoVj~iZ?e{o2gLf0*v+Zh+0Ur2Yq
z%ALQ#z<HL-d&AHPT@R{;^cyd2TY0@+9r`hIv(m%n&bARo-$tI44IcH$AZ_Hni#7~@
z{sX%Uv9;RayDTQ!=0B5%y_i*_yVrf=w3>_R$Jbrd6C5fZwpbfJ@+tZ;?)9C_kiZPz
z&9^p=sl%Q3ZA0d}9ez<;vd-=>q(g6fvGj0g+rVG{2D$a!wppU5YqZhUwM=K5&b=*n
zs)qh)nUU0<<TvX1sQhKC{bi54^XKk<w)OYF$pvP|20l3SdwJF9+m)#s=5(or+wVQr
zY?0L4kB$vku!UcgbKS>x=J}YfKB-%_d>i*CU~=LV)q}m)2OL@#w(x1>&rFkdX4eL+
zGU@etyXynJvHK1my?Etx>E)Qyt3qZsJWxIlyK`#m5Q9HSRk^PJ4Vt^+nQJhensU{v
z_k`Scdx}byOjwqw9eB=g@t7ykH@xJ1nrbJvKV31;e+<*;akP&|<d(@sl<u^Vn}aV6
z$?PsYeR`Vio6a5Yz6K{hnYrI~O0n2v5|mQ87f#s!S&;NzqO>%-+Ana(-Cd)lSL)s!
z9XwGxY3K3o)BDY9vM<IPJg~8xc-^~CU4!SThEB5f)#%*nyaSOQ;Wl^n^5+_F{^mAu
z%CKhLNoS2Os3KntJbpFl((aA!XRj_H`dr*K>XLEo;pi;!?ss3`y`FQzru@soL)NE%
z>}Wh3e<C+?nT_h|rnf<3a(JAMld5#eulZ-cjd^KwRdz4nYI9ojlR-asyWT)|TUWeL
zbkwXAy>jrH=IRmQ`<k?Bn>yR_;ibH}%$@%3mpQuLx&OB_w*54_Vt#jO7p#f%XA3-B
zgPF5?e*brC#_N6g%-F<=ZHuiwD*x=(Egor<TQQ03>75uDyK74J0gK<2Bc=(a2sacw
zitDN!xpPkrJ7^SMGRnip;6?3}Ij5GEhn(THA0IwhanFB@^T471?7TnN%?lLfM|3w`
zT&sKk(?5epb&}f01K;0TGm~$=Yjbtzu$9vvj~{!h>-Lhv*4|cAX6Nc|MjI}5rX0K9
z|HD$9HS4|%HXOaMK0+;jyY95!F-`HCG>;!MYVHV&-yQR_7hll2o`{_ib3Je7u<N?9
z)vu>sI@QP3{PTgWI!9tg7kPF2zMC+0T+~H*s%Md(muSp|(Zed07q6^Z|2}+r?xQEn
z!>4aIMGcgmo_I!ja>nUZMeBrDe=WiKk$bEo^(X9?-?cq$=W?mJaoF_PRTobBlK-tC
zGo#n9Z`$*Dbm;azp9?;|W~lq~T`pAb8Ft9lV!zp^wfZZj4a=OlB4ejP>1Mv}irvJ9
zKcnqIkUQ?-0c3P5B#oby-h1Pw#NQV>-KTxJx|($2Z@7}Pld_NO%rtx29nf!m!I135
z4-B8KEIAe*H*z8u{kd>f){z>Q!wXVIK3jdzYDW;e^<=O3{Z&GfeLwiQD*yi`kJ{|G
zi7~G}G;L1KlZ{Q2k6Qoy`{MVbpOX)ba++;d^k>;Q>HLvTH_g$1IW(}yt<PSe>z}TD
zk>RB$PmjE}7;hN;c!5>cWbL*dn|Wm}-Ak{X89TRrvR&bg1=It_BMr|{t!MqKiNQwF
z6O%IQo({B;9$dFCSg~;SKl9K7ovd1X=d}K3lliMEy9+OEy~NdBTr_lMT63*Wz?-rS
z<8tm>tiMniI+gca4WR!1Ml?m{9=btTd^9?SpL%Zj&)71uzrW{zT@yt<vD!P}FIZU9
z_4usE?f2!|HpM2G<cuWyBuCN{{x!V1+vw`Ft?`ylBDeWypt5UKva#vcvuD>|40>R2
zdyU8SubIE}4i3z{`COGh^r4kQzihhciOcGgjwZ8}^Pj(xR!&(w;=aCRzn1Y<))CM8
zh9q`rOutS&RBaXJCrfZte<`gpGO}*Xv3<B#<6+P>^wqFEQguaJ_{v9pt!vYTZ~kOs
z=lnHSN83%x-!#hTcI=wM@zUst8;mC|vkRTj-zlp5`pD(JBiEg3?a*ysa($+8i`Su1
z9~6IbH(hGdNFvgEEa<+)^9QCL`o8k*oR!IKCvr|Tm5<SXze6`{mdT2+4Z9EaI(Yt9
zB@|74tsgMTym><1!)^AClcF=8-5)s}|CRhVjTqryBK<P_Wq8cGD?bMg`9A<VK*YZQ
zb3h4A@d|OIB*&`usD*kkndNALjAX|LkjepCY$-U!cRlxMd&y}8QSHdA21^wZOYCaH
ztRyxQKvG|M6LN(OH1lS7x_5M$OkF!*_1wx$5Yv#Cc1Isw#ghHH%vAFeVx~2%TGI{u
zt<BD&CtOXx3{=*<w~r>g)z|h!ZIK3t<|f6cP9GrY&yipoKu*Zj*ZJ1xXOY@7zvci<
z7WNCRY=T^K`C6WLWB6O=)@+QWr&b)lovz-BM~gj=2JSIIEG6BDOap=#GCdP(jRihL
z4u~f}@k|cw-*wfdxCkUl;C(I9F+3W@Eh%Ko**d<}nilLE&IVqDh)jwtj8-b!piOjc
zTACs{SM$GL>38v3Vp?F@O<(_RPOT!`o)*-h5CEFC{;ga?DUe0k-(kIP5pEKy@Z<+J
zco6c4`Lw8^UndZ9B>P0t5GqQ$_uDW+o`^R;hjCD~Mo9#F+%)&ULz!DU%WXml;?hZ6
zK<g(IpS&&{BcqNgQN3{Qr#0O_RMe3wEJNK>ZO5R9zU?EFOkS?3LQ_I0$mux!x-%xj
z{#hb!50gAo)GV7a-^3+`tEEv^k}hnpn5>vx4|FvRTw!a&-E{r7LNT9}FuMX#7G9Ra
z-{V2;JVLZ)Kq4waB2&fx)u*b*l*~xnejGJ70v816L`CLF)li5iRXv9)<tHC`cT}a9
zMr*(fA~72XC1_a2FHaA;RIobK@czC_{?&J}@AWO8Cp)gR&g`-l-(mp+ZqnJ#uMp$3
zFiVG{y(0t1Sbxd85p)~+z<!jInPPi(74XjNv*XpbWDO-<%T%x$8IFqiJ%Zj3L&n`O
zj~0u)&Uci8vr2m)qy6lf6=)QCO%_XW^f9a_dDG-sSq7u#QQjH-Ax{84ZpjRPC#w=8
zEaHP22y6^RO0YrpASear&&`bI4JIGGv!BbWQ;@fp&^8db4-v%>HmZ5%TAZ@{F|uq~
z>g(tc>{TrAiW}-QoiTPqvxo@ta#lfQ<SxOExymQ|`u+|BKZ*NGqYo#{eg=3e>D%e`
zMfkPzSpu*BoYqzGQ)!9hTCNx@l@sT1G9v66kN-e%lzq$ddtB@?M9Rza>6!VpDgQV~
zDqN`hsz8eMo$4r*rJYDX>spl_<Ms^0AL974?#pg-&uqWe$z)&W&r(K4?Q=Q`(bo2+
ztXxp-d$EhLf9qK=V-Z3cS>7=j{6{+%rSlPR3TSiIEGaUjdqx}7)Nq^wNpGZ&FlMo;
z&4bCvl`uz!z-t}~qx0ZI^XCa67HF5jXVnX?6{9Dim=}+bM_s^=lsW3R(pFWM8-r+<
z3)c&DjmZ*9H#Jd^48meAXWpW2R@&Bm$?o1ZX?MYNm^v8`OP!8T*F&A5B;>>9X2Ns_
zDMzY#5Q|U;fAurZ;pv0mvqkNkXr6KLjs2G6jp{mu!^7euRQ-9nlWR(#KxvlNNjX(W
zhtb4A=6le`eU(iW#ubVt9Bg$cj}x(M(Rw5IevRXRDePLAs4m7XEzJ=8>)Fge%HWa*
z=KnE20cKB=d*@gS%KMH5g92sinibr<iWj=8+{yvN|0IW<xtZssBYLdpLNMm}nr3NV
zO`!k|DQ_cJaWUc;HrdN`yUh@FeTNGIu=#ywvF+>7f|gb29U-Aq4A^n^gtRmd3tjPQ
z!Z#=kd?SDI*Xy*<#Fu+TIpTjNxCLR?IPgGBUt19-#(FgWWL#4A@o@(IpoAH>5{the
zP+QLOhUr<}Ha)C7TJ^S0is175#gxP|8@SMYOY7c)9Pfa_rwkN;Qckh%B@`sjPeGz)
ziakM{{bj0owW$lC|9%8suRHfx9lUqvCS)TM&>|C7eIvzGH$-?s>nlVKZL%YYOcT!9
z$CS&eWrIl(Y_OCH7jcMGcw2KiT&-l=tsTbOhf08^Y#ONwLnxZX!YR9|l6K&HF~&%O
zf8{5nd2+%n9DC{?xRF_LvJIqjl&;BsLz`iDX*^O46>H3=$VgPO1X3%ih8`87q39dw
zyhK+5wGvVv0u+8(M2U-h76teC+1l4Uv=Pn9(uM$~X6?I&HB+_1S=QrvF3Z*rhV7C!
z4jSd)mv@JYx0rR0M4s`B2h|_Ot(<!}Y~xX&QTYDq?*OwRGX(lfwG*^4_-~axb%|md
z`90S7fH6BWJs<4;vha=4+;XVZo6%5Kwc()1O@`5+YDon}O-Y)ydo%)(<gw`L(e&PJ
z@^+oJDT}{i7Zb87wB(Ta5qP%3svc|CWw18r{-Pl<b8Fv|@W)@FMC>Pt9MFIV!}OW9
z7dBQV`+4|WqPwEeX4T(aEsR!0d`+vt?r#kL7krLdN2W*DrC42ba_pn|l^AB`pR^Qu
zIZO<E**<GWCzb?$Df{)*pjM$%`#a<;?>7W~+&A+mq>!L^Gjjpf$D#e;lc)-Sfhx%-
zS?U<Q*<$Y^3SqR#_?OL-v3eS4>Wdvp*y^2aMq+@S7bWe0&xk7@_@p}e(FH8>v4p^r
zN;yM(Zr(|#)%uanB3QG&zS||z2w%&XD0&n6$G^bq^3@FpP3z*=Nd~OF>C1YN(pT@=
zh>~tVjlz){s}YCu{Mz<IW&Zak(_o%sfu%XsF)otjxBurRE-A|2a=PU+RyT1N&<V=J
zH;I}C08qHiuWmu6`xP;3us99!#m&OOMPo!u)Tl|O`bZRPP5Al%LultpjzIJq;Z#q=
zo?W9+KC-)`FlK4VR;Fkw6h&Ha-uLTzp~Ia{RHDzzxxrzij)*~hmw_%eln07ZpbW<-
zH8<*qv9A35KKNw(1bX)nP$pDe117a(_Sxtp;+dwLQba_m$Y!5@!Vy5DL2gi2xt$2O
zz?NFal?rdwxp>N!RI@K>e%v|niJzX4;Kz6xz*wVjNTqep5wXV@j<5{0-Be@rym<dJ
zl2(z%65B*<I4B*S%_JVWuv{CEx($Mid`FIbh5I|G?&#0S&C9ENW@tE*Q2U)(I-1`0
z%97bOOkjq}YE-GPWNw3Lw|}l;<VH5fBmLMJ?$xGTwF>QIa+T$D9?ySk<KC@#1x@JC
ztHfSwI@#Ka4)r0n##J1epL@(9IyT8N&XCz~iZBmbjP}Pzli6k}Wm4N<9nh1HWwuSN
zwQl_adua}Y_SXGdAu4>P;FT$1%1J1vsSuo^R`Glfq>6rjXgvK8OC;Zl2>Oi~=r$OJ
z`OwTe9>v6IpZT^eO$jDap#pUXd`**qu~mqmTBZmWV<&o(lx5)?VB_2i;JhrA`5U10
zENvTriYfG*x6%-2I9)>GC*G`)QhI5de1><OmF0WGz!qLc;m6R1;lv3lDjA%R$}mE#
z|DXRbFybSVpUJ`Yw#5y#+pp=S>+q7IWkh$B;&tean1+<I9FRFZebVQtmh=E`{EoKo
z8Ll-P9It#soPc$gPyIUeHt$ZorOC2FI&9le%AAuT(OiYj_h|~*1pkLx0doz}x+hc}
z-V!rdHO)g^*31c6?&Pwei$U>!&c#a}W76mUAOO%fpcLfl_ycp1dSNlL<f*NHW+pW^
znJh$C-6-r)&Ghq40{Nh0cUK677Fd9kPxR20wliD}*J?3Len5hZR@8&Z*aM^oJiEnu
zY)I~cXz@PpYz?9L5ODFkYU<SqCKuxk<HULuhqt2HGY&cATk}!G`#^xyss!bas&Kg!
zUg^H*DzxU-ietzpgnu;`NO3ND9;v59Cfc?)1MYw%lGZQbF>p$W%6pYWAjFMMfqIY(
zs)I8k$-7W2hcYGZ|F8vuK}u8_`&^vctE@nrS}aW9zFN~A5^l60L(^K6eSm2Uuc>I~
zV$J;uIv#4g4mRXtEMyxb{AjT7&G>X8K;%NI2!)BMR`P(q0<u|q8t0MarO|5np@9aI
zvaF>Jz<m9iy@d*#^7FmSNID#rMT%>tXhVhI?I?7~E2gMX*GPsODWE<%z0dUS??WM8
z6WL~dlX5l}6s5@CKzaEBDR|~nhHYJmf&5N4<d+H^dt3^Dj+inx^G6CdnR048TrmAM
zCYsyvMQ^xoozngM<#~e&KCuj2^Q_7DVnL&431187$bp%NQWG6u;JcWFT)W8sK1R?<
z&p&)l3}^{}9S8U$c(2^7z1`hWQQRa$^3}3AjnUtNvDnVBd8}M!8hU9*kK)|jgCj|O
zP;YXeAyFgX$>rD@Zn}zR%oH~K6;JvUA;OO%3az$3kl;*nZ!z_$x&+R`*Yde92holP
zNt)BN;trl069}I`udiN?={Y0qsp?0N9fN2C@-w*NXc=2rT-16alp!k#5m1f_>`viq
z$l}VUg&&agnYS6-#%oypj17AlDu$C1HFHJw!59^+xB@%a4~fM>rl{GxetE+6VCV}q
z7AOYP`A^n2KNhCv29UZGC_Ch$x7|I$)hoL29huW>LXb-ys%t)x?Cl6Wo#D1u2;Q2T
zaX|)p$L*ruZ*O50KK5Q3{bxN+C*Y?F-gr`8kbQ>W!ZL3YAqP{WeMA(-2aX<enAG6+
zY*ApL6zn%vV9EC>DKM2|dNB!nG!{KY<%Zd+yY*F-q97}5ImJznLF2PBmqxQ)+DB#R
zOy65>t~G`A``_Rnz%pZi&V#I6LljGF*oE3%U*nN5ff`Lz)eVPucd$J<?J1aqba{g|
z2P`1ao$I~zY*c>8L?2il3W^KD1T4+$aAK*D{Dj{{xX2zr@{rBz?W;?peHJa{VtF;K
z!VIV>dQNO~>J57zq%(<)z%E<nV<WbJUL$xI8!E<2$y*Eo-KQ;w-Q^W$$0l-s!Pg==
zNN8XSdTV&hKAw-Hvi*fyz>8*;<*DyX!Nt*UE8kn)n^l5p$V9&xIr0Y?my<TJnRM7z
zaE)+?OH<Pi5gB;nbxvbW>RN22c`I@mB~vaCp~-iQdAhrTg@G(XQ6J>K$*!JVfM}AJ
z#{eVsOg12&QIoG5uO(BMkesjHzU`)?+rbi^#;Tl=CA)^8%1GtN>g;??BLW`*b$SU@
zR)&$30hPB|^|*zN8mH!hBpnmfs4LTacY7yjCSLNj@t(H6JHpJS3aogIuRG=GOylyx
zIB&ZNYSoKb!to20G~o6^Bk$itf>rz>Vx>>jwdkqvG5xqOsOgWE)Q*U+txF_aqqOtH
z1$va4e>Hg;Mj&H)8;>~cSONrN++aK%m>X~j=itHjFQkbcwaLzV4i&vn0kQmmrA6o^
z5<LwW0spd6T*rIK`47?fcXp8P|JY^--e_dG$G5*?8>3I}siQH<l``#sUMqT(^s}zt
zX8Qp^xd}1wHXhOSivBLisc|ty3Ys{U6;hQVo@K=grM?#DccR0$7SaRw#ZT%=X7~8p
zH4P#214~0VxSSRh56G5RvUl^;ZjbG<St)w_NW{J$an-A^c#A-T?h4n+C8qrs$@AwY
zSC=ML<z#!RxHaigWo+ld*Dfrj01@?j`+sz?`~gMPGO?S<6~MZW&O5kT1Vy7(a_ZiX
zR82Xh4EKiscUu!Bii-;$Xg#XS)F<6JfJH~R^Y8N_l5fByzr^8uTO1~Sxga4zF7lA+
zqbzFZ>Q~l+P9k&Ikg`gMqpNo^E7()&5!?UHUGsuidf#+GRaB_>c)Vn1I(5}vh}UTO
zFwRA!Cmx2<xXTq8dZRG&7GJ1jgR*9Wg}G$zEyjf8DJ%vSbI6O|)sn$$dLRn0(IS3J
z0Bx4a!E0S}H^e@A3VwjnA_BN&y|CVR!<(EG@8f-B^zYJeU-{WNNX3MuLLV2UZ?xYa
zRMwAW|3x-7#HmxZ0P{lDYvTe|q{|KF{(pSQs6y`&a@hH53+lp6xAkb_p_`B=<CeE9
z7iGLpfcUB7uax!A&sLo2?84f+%cepn_~k^AlZCE`g07_P94+>4z?eVlC;?s*0P3g$
zwUYh}5p5rUbP?@RFee`}a1|cNn6u@a+VF1vxX<cU+bI|dnSsAmT!)LoD<0GWc+$xG
znNGi+UIM77>suZab-9^hb$Bd3YpAU324S)k=d2YTRrJ^o9D$ePvuSdEZDepB0O6El
zL2a*J%8^_VZsl!^vu#_I%oplUs~u2rcbek3><@t==cT1Y^Us}wE@e+)p(YfI=-D0H
zd4W7DVM)?tirnEIP)D4pj$|}NXoGTKJbaD<MQWw(F`ru@ae+IW*sWX?l`!VinM{A5
zm%94gou~IpEqkj6eF7VtP?+Y97nZCSjwX!iSW0tg4Dh_kq!??1pkyyT(C#x}q(+M`
zaF(KFUZq5)lM4NP%jMx{%vb<gUf}}Nq|JIKLBIgW7bcE$`SwwB6dx&>@n2%sN~N9;
zud=Z*5@qL0v-3obbl-En*QaS<4PVDeZ%jbYLEhGyJ~qchQlrE=RZt%yi}p_}DbXeq
zArn!@(;&2)N;yybfWOCwb%v3D`SeUy*$#OnW@XL!-GUVj%752Zl8AnmzLCO9eyov0
z;|OmDN2BN?Zi`-MWdy>7toD~Ov#S|f$5lku+;$ib17GGD!{J*=ldS;+7n>H<q)Pr9
z@|^hurH*t;y&{+*(9qvmchw5W1&oJm{+@JpJ7p)YPb=Cr&J7Cs@!U%K+J%2(OHVvF
z{`dpsV!=ljcm7*N_jII2$`9t{;l+U1j$_F0JgyLpb0>S(Ds3atmWSAon~zKtaISbO
ze6*!p?ZSs&X_CDO_k3A*xmuI6pui#gbe+iu*lLNEJCUMtxCA9ijgHu$U|x+}<IqoS
zu=ce$2!s73+7qgH-@-Zv6}W%+j<X)Z=44KAP^GQstsuY!YtE%|V-%1qGVE0|FSq5G
zj24XqvVZx(U(iXIceo`k`{Q|GnBT#6%9o{0;8cq-i611eVfzwM<!n*1t`To@PNW=r
z8}SLM<LsdsB6D=GCPq5tBZg~LWDtD**)HByxFk_LbQmMk4RDA#*l(|9)fP1Wg$2Z4
zF9?y+8<$mMg<TpV>4hzq3O{0`a2pjGa2pFcW38FH^rP3bg#Tc0U$~yc{(t6jMj3q~
zHvGk)fv07ZOf?qY7XH=WmG(++E-5_k5_9xDS48>x^llA^UI=QZJ{!m}r~TS7mv|N`
zE;U!VpAo<~+!LByu%rddBS(zoxeFpJs>DP#{^E4)`>_wX(-u)d)p*`?)AA#v5X}@6
z8C|DH=@T3Wdd-f=>fD6tEkTs{R*zV@Ca`g!P710ctSLTzLh)yegHL>S^Hx2QXl3P~
zzYlxsCQ>^MC4NUwC&ccrL>l;mO~Rvbs>Y$Q_O_Kj*!LohgnZF?h}|_H*TK<<ML?We
z1IQyOfepAkChyryEh}Clf?CIH=WJ3<uiPt|Jqb4E8w?w(A8}JgF>3@syQJ=Ex5N2h
z0Rz5eOa75lhSJbKQI|8Z=t)JfSCOj+H4!hAg+-53Nj6K&)Wn2t28~*(@h&_iGXJuN
zTd-!W1@cBc78wg>nB52SE;~mlf51M}80M>1xNB@(uX;y-Vz%`!VQ;>AM~R92vw}hD
z*Ds~xKXqJdyO8wTrk9~`s#&#7c1l`1_VW^9XH&NaG8gUxSX%FWdYB#0*ToY6{|k;$
z=8EbH*UpUb;qY;Q%&suL$HD2KB1$;%q|ly~cJ6b%aqqOsaZm*W7e;t<w9Y?}cbEvJ
z*!l$i=<zQzqz<c)l2`;;Nu~iKY-eQk7cvhH<kw44a!r6b%Pr9o|6*njY$`aO$RKQ8
zQv7gmkkO=rZ;S#npBz5tZ6@ll+jBLw9G7S#&wWGOFbioZy#Wmum?0BVB|vz3!7Q~&
zun=ZnG-&y~u7W+fQFg?xGsz{%)T9)46e?Hq{!N<6(f2zTT2}TbS)QNS9T1Fnm)ap<
z_szpP4aB-2B)%rO<>bVnM-vi_0vOvo@C7>*mKCmUl$2>s=8z`@wZhRU|JARm_AG1?
zf2%y926KVdrZ8&03;f|WD2<aLF3o<8xe!GDHL0Ehox!Bg9=NGoD~lQkW?D7#uq*NY
ze*9Z3kjur2sL_MtugF5>RJvQhIiMTdtmxVdHCYvk+`qRg>uC%%rG4FF=tH;S%<2HQ
z>%gI5xxDjE{!z?|VYh~}jnZ<RVc^et@pS~KsN{_c`+zWRsL+|%{Rh@=e~eDDd0Tnq
z^|u>x`9(6{|Dc$?RFjmH)$}X%QZ_tgH9lh<!-qDec?a>ma4T`=HL4+r8}MkI^M{Js
z@IQI^OsPj;i)AxVo>n`|?FM}KxIjs6vPAALH~`;QA|E44<rYEzIPoANZTLwsX<%6j
z=JoP|T{7v1P1fih`L<*V*gLpab5OnvGI{A_m-qt9|2IfD6yG5%381y$k-VhWHA&Yr
zc6O~<TMrEOChQ=!AH_CKV;IM@x98gOWotw-<iVG`@uSuZCT>=CV@$S2FPCj{3&AL>
zh3phRAl-NWey|_329N<;7sAz|yXO8__<nUoL_?guDRUhcMfv_cnrh<m&8l>y{v9#b
zB`Q*S&|kvnkHz5DnqiLbEV$8f7nzrpj8lb789JX&<tv*mi^dV8%mC<?lqW(0cz92O
zdxey5Le+rHNPQ7*PBE|_`ZUj;7OI<Q^hx&?eqr5bl<v$U*at0|DRDk0UBWOB{)^g9
zxZkQzqM;c_R_ef#<=VHt#*Ns&W-zW=jOAPzOY<1yYEY(`xOyi;2FXT73`q^o2Fs5P
zX(gTqVhteY;KnZTaDa_})Z5_~HjT8W5SZUZfxDBna?(D({2wM0|GX)H+4OG^>fUeQ
zc?q5&2Q@G;%b-XX=VqcJ9n`G^Vh`Gf+sMWai#`)1a3}4i(x)MIPnm*(N}xD_lRn|F
z(Q(^XAa20H$Mz+X;lgxao9hf?;^6VA2{BXei9TvgfM6~$T>vpcqz6oq_2g}3a!bXP
zS?`oK_f*gXb1!wTsMBSQR>GB#<Jf78SKWoDX7XN1oN#%ay9J5b5&Ficb>5O$20#g|
zVtDjrD1>>)bQm)v$n32?^flji@9e}=5>uW<00}l%U+qlNa~pKGtClIUZx7;mDC~aX
zEJGx#A>Td@_JQauQmiDG{#jV=p02Wa$WZN!FpldYCa*S*E<c!DF6YELKiS;VjS#Mt
z(SU`f9$83Wd_di^uL%FO?Jed*VJ*z2>q{%rc$i~*BHGKNOsSfEQB^XL6jDNn_vG|J
z5{YxNtc|M@$gmdwB}u`<Y(oiW{&hudx-o*ie0D^5<nty4LC$fu8yf&!MeK@gv3@89
zqYM$9+3`vD*F4EI#sKJ1%seS4i*NGqljX{eP(NC@*#qK8>gDvqOz<4^u6P9DwWFcW
zjLRAZ#_c_;?2g|2N+&Zo(=slFwbG9P6T;bO@dw@oqg%c5|AJ`S@hlGi1r<LR2!8un
zVp^sVS(K8#`-y{LU~@0WMK(scZP?QsW-yjXrkKpSElC?s<hl5Ys)VC4p%**#t)Dk!
z*|_5WT#vsexTe?wiSu=&<5mw&AUPmgQi%51$)-*pR3(7b=J`dqN>eK$Qhtv-^?wx=
z5wE0Q;f=czM<X7fh{)H5<9+vb+-uG$pykp}l`?1gz$2VicE%8%v4apzRYTNXL_Xb1
zOdRUh&yb3!@p2or8afb)SyqL%{*x$W?q02AA<#iqYN%b8Q#qO=eGo^V+f4~fexj`U
z%{0U`{{|e`s?gFFAAEhz#?i33+2GW&=8>pga>BpxyT-h^zbSr(<8t1@I`Z_egj%WH
z3b5O#a0o(D;+wq^W8h5nH8CQ;-w*t$p026`?a89k{4H>PXodFnw3PZusxTY7^Pk?a
zb#5hHIpvQpmH3~H!Ux;VBsqysZx+!#d$lsWW&X<~2TT|!sy3Y86+j0&GW%J$>`7~@
z;S(pm_~?IyqAn_bD4ivcPgr<%6;@B$=?}>^;4rbA!X-qd<(zow2?W2(JTsKav&q@Z
z<d;C17nWerR?}`8#&EM+hmq)vNzjcF<AWX{3q#WxuA@1XYuYeTEmZ5`QO*C-90}9B
z)Zht$dg_~w(3hMhi}<y3S0FD0YTRA{flCk`3m*PAkBE4OA6SXIhS=F<`!iSGl<i_u
zjRBnuriyNus_EvL)$;x)<K6+#iUT||q>MTmG9FiYLB6FHi!VL=%6lLwwE$2ELPGrK
znpgMACiVT1EzfGGhC^x!AF@BSvNzNd->Ukj#z><fqQ41;u_5rIiV|$or>u2!;y_k2
zM0b@(ectm7{$=G}25pcqI(S|&_00wNWG-7KWj&YO>GObxQb7Md$&?AaEw@1SHpF;D
z%bu-d2*#~e56%X#w?@~rLCG8l`Yxh+vcd+0-hP}(CpAaF$^PjkyzHZ=riT;5Zx;`N
zU9CWIdT67qW?U8nm>d%2UXfF!aZ_2?31BgmM8fZy<9t4@60X;F#5@6e`Iy-lgx=(!
zy3tlP)=sD{{K$Oa<)oiK_h;759vpO)2i_C6Z>}a$!dKXYyu_*fWcUtu=r}&*MdlB5
z50`rGu=d!qML-?~gf9rSTKK*BD@LiSN}IZRo7@d_j9mq`80v`K7$RlTiOH#<r^mD?
zbzcVC+_MiNNQlCkSeo~!c_!(f$Y?>Fi!@6>?UZ_OQuzdqA3fD-c!?j(`PDP+NPx)M
zl2eu0^S^jU6QCCcc9dWRonkGNt<#}MVQ)VjG;i4IRk!)3lr?btJsjU3ZSwIJc;BFl
z-LHD7bRviMbMHA8u}qQ|JvIk{4MKw3<<G8UNCC44D&n{$Bz3Z>$`^@Ub@+Vdy<r>%
zCcA+8=}@22Q7r70Rbq(Q&YI6iZR$8vS69QrBBW|vJRQz;dL-P6_*QU?x!e|Qk)(JC
z83R!87^(Qp58-K($fw+4SJEeCk7t3ZuK=)>!0x1gv>A5lnE`5HPtKse^3@pPHU|HQ
z;7n=RLMWEMI93Yb*Qn`r^>Y&ACfSm2Q*=$Vv~St}n=bweSWD3hPTKd;>sG%}mDo)J
z46Rnd_qjBX@4C}L6@<rbL;&Ot9fVYJ=gUhTT^p@sT!cOg$$tQhe{3&d4P2CFfdO`V
zDtO@`XDos`0_L`b>59x_S!;*{uNsNc*YyfH!qNk@B)26M=D8E(@cHcvgBp&O37XbC
z*9bTuJw`ZJ;sLLsAF~4E`_vn+@)`0TLK6F^;Jd^l!b<l-6VyHlFZ+oC;zv*E-=1{d
z=8bEw$<_?};hRSmG3sa#(jiCY@IU|PXn!r0Y4R7PoyXSD5tt?&K}Plh=At-_#LtT~
zxE;doVpKE?n6B|fcfw3ug>T5^sz1T0;j}K(^QdP!ebSSv?jm~q&H|yMZtNA=&&U(a
z5g_Hxv)VIUXR2t@7+bx$xy^(X0Mm__OV<i8GsocGFvo=tz`n<m*rP=1Dsc!k+(POU
z53@uC#O+POSZ%1&%DyD+7J8c`)-1NY)37HD>H(4uf7^oZ6s&wtTs;`)qsJEw5X*-X
zfU9cSoKmm7lnPK(Yrjz^s}}gyHz(e>G~iY0^sMWJ5Yhc^fmK?R!$~17s&PQ-U=VG!
zI~7*A#&8N_|9IINPng;m59io5%y(_HlrZwx@NJ`5U>YO0W(U*-7g7JqJe=|aH(V3n
zRKK&lV$o`rk)jO|&a$!}w7VSXCZ97*M1cngszY7Z)g9CIA(PX3!Tiec97>rH(Qc+q
z2GXwR*$l2}JOl?nT<19cBBcuYRWYj*fhdYu|9C0?;2DNcaoKs23AMQxT57pE{GLW_
zJavDLb7Yepx*IIs!P!Ut-S$hBmZ(h}T+JhiJE*cJKDIiz`gO(?(_5tW%{OQaN<OUn
zz6Y2dldO7luHrF*d3Ck=M{59IJMWbWH;7C>5`|th%dzbU^cvSOttbjLL-O)1+9hzc
zMn4|LN0FgNS{!p7;-Xxil;!M46jb1mi4Sb-phdxvkS0$jyewr+m%#F1)mi89S`z*^
zrJ+P3*v?)dsIw2`Uu+uYcE#~ZNJk$Hkdp4v>J+0Of$K*-Z^#NJt-J^~P@9+ehf?En
zo<N}19{J=Ke@e^bQW)b`J${EeqesvB0(~`#DY?C*_V1veLm;SF-6WF&6WFRz+vXQ<
zsTVC9P4DT^jcl9{+nie=_2#B+8Fp)+NQ#-8wNEGVB66og!DqAx4fJz4GVfnYnArE=
zuBMHnX7nBacs7>&GxYokjD0*MohP&C9vxsnKNVvVe5=)6)%EMEvDls&7vYIr_t1tv
z`1-U^!YQQM#;>!QC#E12t2hR8mx=BQoqoXTf0j6TqvHv3p5{@u*ZlkZb?1VO;FY$=
znw5-1cGRx<Y5wrL-G%bH*kkF6pd<<feXgN}ewt$mn^=e{pmo#v%MJ2F>dpVV1c?G+
z-w^~f3mE;4Lj^XG*Shgo72-4llgB?FtLcEbdrN4%y<z>Z$&gPi2{9-VJKM09i&bfm
z)XC7HVLQ@wCeQJW65uckB#lJ_&5S=d&<B`XlV15Kv!ST?#V}fVv-qHGeVqpFv)W&#
zN;@6A>ue|*-ap+3{|fnDIRZ2V=dwI~1tbZ&N*A|Y*J>xw=GY;6C87x?KGEb-kuhMw
zB0s)MR_1hmY^bGBa=`mA6<xZsjd(y=Jcn2l_FRN~CwQ?w)=g@>m*X~evE6B?h|%rH
z3@E3oa7=2f+6n$O=E$-REB7q6>dP71Im?6kYgJ=qc<(`%9ccSaC_aL!u;YuVsiCkS
zwsnTSq^C@<_0YVjy)=YAP6MxvC+V1Ios#BdQ;KWmg6#7vq@JcX>7HM2grdwiT}MK~
zadIaY`UFAac)}pi<oZ=igy?VD2C_xx-dul<aIB!cS_$v%0OwmBEky|;ZfJA?EQO15
z*1u$4`Qa#nK{)b!B$}=iBrkbq%!gyacL~P+nxZ1GMB?Y-6&IpRGFY9+{<v>8jFE17
z^+c}5iebQ+V9+`RPt*RP$1nDS7r@1@Pjk=;@mA&vWa9rm@}~^c68B6Qg2(sGs9o*6
zkwM#R-m1Osd)WmR2hk14D+Xvmfeo{XDg2P+XV{64nUt_&h8$gvl?GJ)f#tCtP$L;6
znj<%trjlKOn!N#m&3D`9zBnTyTck7I<J(d9Etj2cO#;WHpVBU`y1f4Z6E4(GPEfc&
zP=V~Ss+;kHhzdXH{DVo3BUs3#act%HJDzs*lb3e&J98Q?ZCsb}Vr|w^p&?3vI|kX5
z(E*Cs(gb&`_X_!PtS>vJ2bc(Y_APm;AMfGzx_h^TeT{#Yf)awoMPEj-X^<-RVi4{n
z=6XWSRC!H#g@inlid};oZvEOTaK$M%2Lf4w$Yn0xH@&3~7^CUN0$!{@XFqsXaaRkY
z`98N$CKQrVjN9P*vjwKSJOD0Arhr{x(Ayfh@hKgRdT31fkeuB*atMU$jj!$pk#H0+
zOB=N}uNv2?P6guV2k;o+K*y(pXx#w|YQRyxQrV0<s<t)AYC@~0FpcyYN(t@S88bOQ
zF_)7vOFpqh&RzFqA&yi`Az0n;o`8Xj4sD>HlBfZ!A5{*;?s&=a{3r^YJLT@x#juh*
zh=i^^P&e?)+m5`9i=o0T=>=};*giUaDd3PyR>HLl^MR8JR9ur->Ynyflx0}u7Hrys
zNb2nPtcPzek<~qdf0Z?HM1qew*|h|jzH~bCM&1&uv5-DDYRFq%9CVm(x`(7*K_@LW
z5_q8vewg_kVY)xwAJH2QPX=yBeDTl{bkm+Zl3YvB;D&z>3{0XH?(qAs2zPF4K94Qy
zTvZ0*PqIdn8s>5#(3&pNNJ=lhT=&DtbE)j8NwrBEjOO;sS?Y;--T?7xhB`qiG1%K-
zYW#|jpP5d6dK8cl?tFp`a+gP)J>;0Rl`GQ=roAOBe{96^W8Pc6M9Jtb_Xk1zXX7}g
zpVp$X{Jhl+F?D}?b>lvjqdKzk@Lzm*b8M|FH$RE*Z1p2-iiiy8_>?ERx<et2#-O^e
z&J*jUI~@yUwbil3_WdF73mK4Em~wv}&?4Iyj91ZD1!%N%!uXa54x<6d&3ZO<c7sp_
zq$*!s8mcNc>C^PQ@7a)x19tPlU5Qx3YP?hKK0THC!<d}U;#_*Foq$x%ibD6d*44I&
zaivq6>aR~-Q9U7K41I<%2nde8%eR?~bXrB5by6=NC-a4|dmp>oS$8bqcc$O{<5jqR
zR-ZLlXWF^Qq<`qdJ|XY1EG0(?rlV+`E7Z7PA+~^QWCm0Ql9Pa59p`P%>CoPNl8b&+
zTIa1VA^INBFed#Pq%92JmrF95jyUgO^`*8<C|WLId*%NcNP(jbACMb3s8Pb+Gf!t;
zbLRfAiq);xTmXkfovP`YkqY!kokc6Rnh<5uVo<4Nq3s<@O{}bB0^LB_Giww+PY_Ga
zJgOXp+rKpWaq*^l!)ccM@sg)=<)L2+R-)X&b+2qMb0&Z2%8=NSA3@7i*0l$5SkV^1
zHcF37%*ac`hvrFUYn9kTvicjI7mTjtr5|4gz(uOIO@D|aO8`Y}k3U4`MZPmhP>GCh
z$op0QBNIyW?f<B{E}q(kvrW(;q6)CnW@V~)L6w0=`#JOnjnJqn5^@HAqmu=X3Aa8g
z!}(piqND1gJZb0rjM8!_CpC@V*@okmw7!T?LL-bHI=Bb-Iqb^8;St(NEBq#F&54!g
z9;BERy^!8E&2-i2)QVaaGCz`Y`Q2ZMG2z1;nE(>*b6ezjH3=CGmG`Qr2MA5y(}WLy
z9st1eJU98kd<stt%M~>hzk)Qgf2RAC@4<wlR)aAw%{Six&fyhZ`z{WN^dhL~Ap@nS
zV;zCy&JQMY{O@}9e~Kn~t#QUhzAEmH_~)siqW*wb1iNCAP|@mUI#F4Z)YA>PowH7O
znPLxjHmik2A;K7oSANx^Gt?R?1$h9{u4R^Cn=#5GpA7Bswu^_b*5j|?;RarA<G6HB
zBUor~P;9<grl^wZTFvGzbT%Ld()pKz@5^$dwcMceOXr8au_bR|GAVGfqf_xO!&ac(
zA{lGrHFb3xf^X2bAdh(Dcf>sYpC=*-K-}}U<tPZy;I#;3B{n%glG@$@l_fp!V(?2X
zZ7fyRh7#pZP&CfC<NTv6c`(Ho(BC2n6E&3xg2zQRwvLgg-5dz&1R{4kiJx|~S37i(
zJ-l5l*Zkj^Lu0_PdmgU-(IP#7!hASaNgp8c4deF|8%w^xZTj7L<=j*|cd9^`v)yBm
z__vSb2<0_lgc^<61U3JF)76m@(a?K8kK#I$MRD7<6vj8JDMvwrv$Xf7G*?89cG)o%
zu%<d?B-6chaipr^=@3#dhbinvU5Qr*$kIeeE{X@?@E{I%ljpp+y__^Y0u<C>+f2TM
z#9RGKP+ATtlgTCS#oa+zDtlA%A7?_1laj8i=vRZt3;-7(yLJdMh23H|;)m16VUiXE
zF;;hzsJ4$!0sCD=A5)GsH74r~TvT@ngs5Sn0I#*Fn=9OCd4nof^C@kQAR6tyb7?Zz
z5+gTTl?j5>u^(IAFdzuWJcxbJ$g)71b}vkQaBRr{rjsqhZA^lI8>kpPM|~7D7}8Td
z&|_dc>ds*)t59TdwE4{WTx9OF5c5+k`C|fQ^n|e_m`*GSOs#Eelq!#u?yFGS|DGVh
zPlb^V%mcHU!qmzVcZEZ<<Dg+CUO{<>HcTRf!>`X5TOi%~r@IHkd`S~Hww*Ti;tAzM
z4K(y2hCh@1Ie@!vTx|#St$x*Up+_5OWNkg2A0)(X{D3RPFh{tou!DoCu+=+~qd>|(
zKXZzWkWl$A6&HF^2{*{+s5E)wtT@oZSSfYaHoL0Cww{J4Y6^JpsokSzm0~1@yK+AI
z(bG;uZ4I+o*vfM7Olm?Hl=%pHM6XXtSfIZ4?cV>fgH=LVgaFKu7Dj@DF<Dmk6gQOe
zsF3_pTNG!<fErXf@CQC}Lp<<K4>P#i$e;heQa^y1?>uB}ih#%--qrUoA#of}AH5N5
zw2nFymFTl*3=r8<Ir5o-rN<@-P71lUhHn{s9(;X5St=k-$+L{a@|H&3tU<!Hjql&l
z_F@+(?qI$C2Y`GD4IQ#Rd{}T9cu%XVPDcK$X|TC*Eg8cRpEw+?kOGWW;Z?qV3@EVM
zyAUWvlXQVf{K#>UpQ4NkGUuf|WF^gHXV|{{&xL7h`I?mAVq%dhTHre@8G1tqILXSx
z9mt#T<&7-{Pca_we;%>@miY&n`A2fEB%>&&P8Vro7bVyz{F`RkY!rQVQ1JS)wXc_c
zlKHxBtTgm}?FRhJKJdw2^zd>rx-@Wz$#}$-u=ag9I<>TjDi5%jX7z$VO$_8d(=JJI
zWbo=2WfBy`=xG81UN@+O>HzZjO0KhVX_R-eTs%Gi%!UA+*C^j7Kbzf*(O}sL8r><k
z!9qIG$J6WiBdxy+f&wN^vE4|JKRlby2Z1wrHcs>Y{wB8jywB_e3S3HyiEsVZB+uhU
zR<r%9kAIZz49%Q|I@LbogJR3V$sGKkCuY6xJ*|m3Ls}8ah6lFqLHpbT0Xgsm$NY+j
z_sWERE9UF!_zE$hv8jg@2mF0!b>Vnr`cE>0yg!&z7YLG#iN@|lgBjLuIZ4pAD$_FC
zlI%m|X^R#Ap8Hi&0K#jF+tm7yzfVyz3)bI+&rB>9K<Yb|dWaqxIt><()7YT)6WXui
zn_foBh_UO<nZSm{FlR!kT<Sfq<vhIOW)`gvg330jYHS$&`+k1v9uFDlm#7>pbR>mx
zsvt#XM}u`$VuyKp1aTKlj!?f1pH=SC>hD1@JE6&g?Pr6{5C<-)`7#50i6fzR)7oT^
zB~Mm*w;2A}8Fv3iaHO5x<i#ZA#g5SHh2ya!O6u~!?bru;!xeyVV14049)ibG*#Nj^
zKl9Wz<kD;Yb@Xl1>hZFYofG|d9%SA;U2DHv``Kn03mHs88Hf523J4IDj^i-2-1{$F
zh$_JG_#+j`BGzAygTg+P2bq4rQS{hfF|U@=%dWYXsCO+<pv=$jP1hzg#{29K_Goa{
zg{)01f_k=GqKmn5+xR_|E+)x8-N=r2`1=)+&wl0?p!?3po@52vhZ#)CBKp6;aGrH(
zg$G;C1{oq(DjO4V65yxzT;oqZdJ{%HPCRFnY9c=mY?7>00Or}7+m)Fyr4_?2VM7wd
z#}`=y%f`&FgAJ2s6ecdxZ1>UL9++q&9wmyyZ#uRpvQm8Kn;ozNg<HH9W5S<7S>PLB
zD;O=ocnxa)3oE9n|9|I<6CffjX6hi*cD2vT#yai2Dz43rgfV$28pU@(8ysW>!3U&)
z_(>JwNRQA;L&!wOPBh*g4;Dp{qkCkzyF@F#5VT`Rp<<>;EeWOSndWBIkm?_x6kjr@
zC+<-tKS8}6JRG&{aD2Qfx5bsoAgHksw%F`62}9(x(t2BLb_c!aJs<>v@otl|`{Mbb
zgYSvoLUKexPqa<uX?DJBj1xQ&7XKZh*Q~+2E0AYTBkyKwg11En<XZ$qG7lH=|9w=0
zxBT|@Ugw)?!n$<#7M<jMJV{46TMFGEo|g>)O~y;Q0)o=Tb}d?j=bq}LO@b|hF9S%$
z$=UF67>wCVd2HsO!tL_zq;@fE4V}E;JUZ7RUJihl(tj%Qm)%KcuxrV{>-TBgKn_U&
zpGp$s)_ImQEmMuXtv*|Sp`f$s1&SH7K;<Q70#MOS`Ivx@l?o;;{jmy8WIVLc2~v5!
zOl~2AQF2e`N;vL^O8of(+x+!T0MspZte)anbiQ;I49`Buw~hW)T6!e6i1DBsz&=xf
z0vLF;z}vIi#jQAlOcB(52Gfl(`~s_o8ooTL1r|KoB+#+CUU?mCCx=Zp$FGY0W`|^p
zz=T+OnU+GUcej$!-V5}(&}wv3;+lc?q66y$=9xq69993VPZ4li+P^etViL^Br`Ph@
zVhSVpxaLHlbwxpNL6~RvyuN|<`$yFfB=Hy~WjuC{Sjs-8mqzVZ2&Em$<NA@&1|u3k
z*m}8c;7;E|Q_l+ii9iys+{`6kkNCqe%@0=v%aBj-C2$HY@5TuK16*cJ0gS!dMY&2Z
z29s=X5`E=PU_i|>WKCfJM|-%_yiIjH%Ot)UXHU(br5iQdi}u-FLJ>-Ehv78tM<v9L
z^2EBOdQKsH8D?$-RMkb$e05pEfV3(}ev_;MX4SYH#h{FjY<<2De7Yueh3{!WLC`q&
z<os;);32lO(VnZ+M`p(1vh1i+bwZysEBh+=i@Qdgea!CI=_nYsH}=XjQs6j<J^S~6
z<rn8<ho=0hyoYVDzm(1;?1x9?%}mTIaJw*1qS<q`APuxAHLupf#Mbzk8H~B+h3S1-
ztko5qVV``7!9%Pg`3Jy_-iB|_Vs;&hCAuSw;dCJ9GUCufdG*XMN_0HMjXi?6<H7sY
z(Koi|fQU*2W;}K8gOI58^I4W_(~Z+~w3c=M<I}oZY4f}0C!!pWAacl^aOo3xPv5kR
z&Vrs`{elH<A^#eLT*=ZA0Yt;nl4C3Xf9qyB8Hu%)+-hA%jG4}g6*swSg*F|Hm7dMf
zB&tta1CbW4)+o{Qw|z^{D-SNe=TM>Uk%dxpy|TmeRJJ9?i%N5ytD4a+uWty-vqD-R
zR^tczD}_kCwVoYE0cAl)Igb1C{OfWWIL+_xnA=Z-{aluOsBl{P238{JObgTEy^=dn
zXFruU;U7c*cW^Lep)G7ES#AKUVb%yEw78Dn5Q?w<GHh4#!BpFhq?NYNd-l#zdWBaI
zbi$XHZ$m^cu<9i>J8`9r8KY)lon?fqSL)~h2>axCqRc!S+{B~o!FQL~{BQI$zAc`d
z7AvgorVKBuNp$U}E>Vlm!=;RzDWV5N{c!12TFCy7{nes?jXs`Je_;y_e<ewj21$_u
zq89PZn=TQKUpN+$&ig6i9^w$L?<#)%DS3Y1`4voTR<O7aS_0IwkvicJv)$|OX<_X}
zdgpYLTfB%wh=tMf1<CujvSXZ!UrE6zJfJ2fg~!CgN5YiU6XY*wJxI~BAz3)Qn;r}W
zb>}I5-?rSKOugj+1ZM1@|5l<cieZ~87Q;i!2H?S<-0sz`@1w|Q$9+V6eR>u1T{d1Y
znfvqU(o8JyOR+89D!l{4ReN?0xV9GgQ6d&BY}FVLRU?DdzK7`jWz0&D!b+Mt58DEl
zS7EXTDdt{sn5QVU%+rMT+ahVKK|K_kVXu~(-(U_8?NF+q6_yLn+nS68HH`+&JHhHt
zgUwLn?N|kn2uVXh_tqJUWL@zP#NkMPJO^kKA=64`>2M9+QTr$FtjVf3!1xIrV#cjR
zLcfVRaRvn7K@goT)c>ZJAa7@yIq+kou7)6_6<@o56K)`|CIoz)Oy8^s0bhD@GeWVC
zr`1#;5xJ&tM_9bh2nNVo|KyClg@mjv2Wp6K{Skk-$fYZBX^Fm07+xBBnaEE(F0J0Q
z9cUx~j=Dy&TodwBNE}HuIMeq5ub8B-Ax^q%raQr&5`DMQ0;9r(zabilmkUUEosdS*
z2k7ec!9tcq#hTa_$!Q&xZE~7}F!>SB#iWgW#AZ%jv;qEMQjw_u+##-=<_B5jsw!rC
zu$rVMMt!!o?}Y~$eeXp!*!wl*I**<OSEf!`hzc~zKe-8G8q@xU8yW5%oRu${pswbh
z>4(^|G7=l;!R~XSIfGAs*5nDNg1$5t-T50KOPc*ZVuQWfW(VLJg-Ub}T3+HJNa``w
zrwF;SS58B+up$y-W_Y;y&Nh!op3!5HY0NJey}SxpN$kw3^=tlW)1=(zh~5yJil<ww
zn`J>#^T--QuekoJQC9E5)!b^A4&=42r|0%P3Q39n@c$zF39)|VxS;$_uXuRjOwhsj
zk&<_vSX<Ns6`iPbO?G!@O$AnHhGj`C5>~g?>VHOWG?FMgThPMi3?5N$W}P|6>E@dZ
zq+92V2JFYfGag9nF-z^YqE&&1bAWLb*)vS^ED#%w$z}9uMW0@4*742T!iybEJ7RY{
ztI$M4B_$h2o2?Mz!LFI33HChL=xE6*)Gkh$3(r}qKV{9UcsEOUpi$Zs?4aChc0_R`
z68v%XZABAcsd)_+lx7d?E-94>W)k$O|L)4pDcN#X%HZb+|K5N7lvIzD-7ouwr)IO%
z2|BEX+Tzd4+*8HT?Q}sytC|)!b9%wo5#cSogX_(Ac8&#*CNV<3d#g2Mu(kL=%V!Ja
ztB-!6)eZ-GPYiK^==eHd?Ks_(sl?k$JWP|ES7WN9S5~DjI;U-!Oq+rXoEy5dvh;XW
zy$w$TnJpuw<yCVU?|N+|I;z8Y`~2#}Yj+mzE?KI0kMMHh-!;BpN+^X2?k-+T5w={>
z9BEa}b-}hC5xG0CNrC~<E<l*jut|RRHHo^elJ=93n}TPDhKpO1y|bOtHp6#5>Q=-T
z5~XMlw&zF}W^$Y1Y;+Y|f^x@jU~qqY=***j?hrLUlj5T?M3}dgfJmcXhFwo+#xk{e
z(CY@0s41RDCMsXZ<SNp<W!bY-%bkgi`n@mD*k1QHyIAVi!bHh6q1)yKLrX(rAwzq@
zch_ml^h-|6dqteJ@XLF=_!RREAkw8v!nW3%z7>i!GeNEdB8*xzf#lG<KiM6zfmF^H
zgx_qi0{i<jR8TxToAHxL%e8trkYCbD^nKqmc8zKeXKDgo$mKFt`nqD@#oZZsF(YJt
zqAG;lPJJkaLESA+F~%^qnc{Vi^G)~_l=|&f;>c_HlB4$0B*4Ye;HW^6d<EdsekVU=
z>&PT&x@lzrfX3UOCvWLIeW(+*<-G`|BS`6$$66c{Kj!fqx#QzD(kPtBdykW;yZ*Ck
zSyFWA8M5uXqWUS8o#9rfHS>aJGmEbkKB-)~U%~H{ZySaz3y0iZW7n1x!-@NZS{()(
zvpPrR2KLJvhM=IoZ)lcA$?Pt&VwrUDdctbfeM8Q+%ToPj<0Wx6k9i{;`Y_P)p@3>L
zBFYU@2pVyEn~ud=waHAj=|(HY7p==w@vMa3=<MlnvRUHvhph_DaN;5_Ai>RLcZOd)
z=csqNj{VpB;rb#`C93f*A^T@g<3q3sm39qb*Is(}`XnGBS|^I^?H^?zGCBlW1Qbrr
zssNgc#NNQuM+2i&ck*@KlF#DuCHaH3_ZfIrCxhwF;;Ir%%6qS5^d>ANvP!QYF{J*l
zY~{X+&0R6CNLFyc0++q7phs_Z6Op^f?8TdXMGNxp#6PFZ@`2HP+mfNY(Tzl)T0@Rt
zg&lR}f|&d8I#~pxNI7?7zzMt%;T-zzFd5N`YSI_X0}e0(3=$8g7u-DMpSs?5!X_wx
z8D1|5yG5M@ygNeK9hjODLzDq7wox#@B8_88M%8=AT9k^h5EjSNXjY~!nK}?8cMVQE
z0oZT(6i6HYxiO_GBM$fTm$@)dEG7(Lqku~k=jUU<cMKXV_9C?1ny;)IHC_WEhr|z@
zMMX9eO`*ON=I<;jJ!es4++flhh!7QfjDjg4DvVM;?`3!oM0|V*94;Og)+2CDE_fHa
z+KcP~!jMMMKrIsuIM}{7ZYZ1BkGCXljP}w}Q-+OglaAJxF032`ryRyka(D2l#x^rz
zHsDPX@c-W)y4r^AMXT;`XSvqmRTcxNV1yd&pj4<+s`<XjUdJioT;AM0ajU4XYvn<^
z?$M^y1cO;E{%$=miEj<YO@q>-d5lzt8V4t%M|tx#z7kCX$?+8mjk5r+D>u7gSd<Fy
ze{Ssehu$BNExFn$?VVJlrC>Xp&>e+vx>8xye<VpR=Mf}#*f(q))&$&hazm@}rb!h%
zsPk9lw_PO`J%KW9_KTp{Dmnu_h^2nZGzDin(v5~-<b&e<4x&)oW!?LjjgWRXFNqT%
zq+IhY67253mh-*spd1^8=br^(_a9NI-G6I`7~^-ZYnetHdWEy}S;ts&L6tOf4qNP&
z1oqMMCU4x(BJKb^K*GOtdxlBi>hl$*;uHx6W@=_STa%>mKg>x3ZzFiB0ja-pd=$=@
zjYddsmaLP$N6>mshRPn8&G0A4qVE?5;-qQ+fFE5G4A+T-%Keu}=lt`s^0wFEJ=(xR
zXg9#PU!zx)-#Z>>n~iXZ%kZZ1tt|aZ_YIAW*sj`rl#vbO|8tKzLqp+#<s!fM<$G%L
zmb>YtOk-1{a31>B0)+>cI$39+Lmec-QiRFR;>F>T&VkRXWEjBSqIf$#%--y1%p-x9
zRS49nHPq*=K9)@`RO62&9HtRiD@7rvjwB<F@aHM(I|vBvvBMOH1*I|zt4za8ZbrH^
z=C!hk@hSIgM^_h{lOe7@Q@y1=0zZgrTn^m2MM&mdDc<~bTCE~Hh?c%~M#5mi`<H1(
z@A0KRjz3LeK^9MSn%}{hr_;W(K_I)*09jR+<qRVBA8>Ov#l!^+O|CG~8)@Edgv5_E
z@5vR(m1qvsW{{_eOX*zpq|p{!#<qb9<lY5=bdgF|wm|-2z%alPl$)_pIM=je+Y+^t
zWO;?W*eGhrB^m{9eD86W((_AG*>6=|f@Bdp=8o}o#ncxi4yEg&s2H(5YpET);u7zc
z{h^f_-x;E;FbOG+P}jDU4c!1|j3Dri%h6Y*W>MNFEU;2>Ps~F)m;seJ&^?I=b$w;<
zYlJB~-I@~$z)ifBX+Ri{W?s`0^V)S7*7AP}5UUr$L26nIAix!#yg?|^X=eviC&?Z&
zd0P7qELLj@lS`{rAUX2Uwak^YSG)|O(C1@3`Pi7MJExe571SdHCb|zeZ1r!5s;7f%
zwiq!atSx?xFycB|#_I556t-F-vZ~xTye2AAyk|H^1CSX_C@g{6HWligl|jG*q(Gq{
zil^Y}mvUiZvZG9>fC{)F7yG)31`A@DJ&$d1n!sA-s>}(mumI6P=u`Ukuu#%Q(d)4L
zJn1|$&c#bU>{A4<pW`$Z*A<Rtk2~a^Wh9EHS)Kw1HN-QD2c6=4PZkyR(-+vg@g)H(
z&<q(+g;#@0ipzomV4mq}CmOo+5jy;U#xkOh%|846Vc~ISJA1jZZiC-+>EFCy-JUbO
z??3G*qOFXODxnyp7uxTw&Aeyri@o^rt|9VW%iFah#5mW!otYJW4oVKJRxaW3K;^ka
z>3{seVdd;jJ)pv^za>Ug6Dgc$ZFB({Ns>Q~p**k_qb&UMwyJSND=YpU5>MdsU^QLV
z_H>;ccJ3b$IkKN>%dRlVI}y6?*q@lkaabi0S~0C**_2wb-M6mav0OlyW^qG3r^lXb
z6dMXLM6YXoX|9=5Y*D@e-lXhu4Dn9Wv~7SU<^N+k8IW$P1K6qHsOakr5Xe<cx!wZ6
z8E3`HXq~@U_O;X=iT)pj2Nsiy|8{nr%zpMFPw55%?Lx5<S>`B9cks^1>{ETUcHLc?
z6KRt9U5qhTl5qIKlG}mBZ@FFu)aRqQJ?<)=>W&h^G7pkheWvT}`zzbvJ>#uJNyWx?
zEiJ`ZmQ53o0ZcPU&9oy4-=-`RN1=n7p=e&6xdbc@D{m+$lduN5_Vfx#8(P|F#{Cdv
zU1W#jh|T0J^D0bf={2h-F9UG!mbYbyJxQo95gfV!G&X?%T@r#V#(w4y*eYOrGmeE0
zcj8;Y2VICYa~m>TISosjOhpKLjk*WdOu+M2v-S=fM{o6Z4&;sX)bwF5&YeZCMBTlm
z#Sw6q1!d<bx%75YQk;!lymw8#>FN?p{MNK%@Jeu}1+91?G=?48vSIG78Shd_gCy(h
zCxSd+IeA{t4r)CAz^o*1Ni2`s@n1)j_R+(Nqzk6@KT>H}0SbYM>b4!a;4CR4D8i!V
znpXM;a*F-QqhsQ7t($R_d(D3ddR1Onrr1>zg!dg?WLrk(s}^()NY2egR3H*yff!g0
zj(h2oH>IhO4r;W@$p{fi$Cm`vOtq7(EzP2Dri(M!ihH@F10M=S#<~uw-RJo0zm}!h
z3z?4Nc*cZ(o6L;|dRi*YTLwXD<+Q&xGqOEfUX16$51eyLK8wOUu-%-#V383rr}eC0
zSl^Fdv9_ILfr7VH$vRO7);<2`IpX&Aa_>i|8sIn9iM*;1JA6o1_43rnh-{^Y*UYq|
z@@}Z7tu)G_EtY+xta?cGX!bJP*u86$%AEOwrv6{ID4~M?wGzaiq>v~}iR(Yti~L3m
zBz{M%sI7U36X+vN3&q+{V0Ra&th{2mKLbK_EKd5rA#CI^Xn~$bS$l$MhOoSb9vb!+
zqtrV*$b7WVS+$wY!M%f>_unobzz5n2%H=xyb>=sTqXI<jk6!mxVWoMHMJ}>QmYr;-
zaC150qu^z^k5<mMu3(cbLbx(85*BU(S5zTEOAur~r54(Mu>`OTF^3Z9-Ml_j@_@c8
zD=c|~l%LrVWlo4Ed$r>H#UTHM+)lAmI5_5hm0t}R%{X)pmDE|gkSj-u)@;|HsT)e#
zr&+44059vW*9<SkR|YfY74$?c2(j^g3tZX3D$nY9>x*xQptt;)>c)U=g>mY{2N*K_
zrAS1w<Mp;Baz|%+reMVZQhUVfEN@8Akm6twu1-VD51nZQgy^odBoo18`WdaPGE{9Q
zIq^>S)0C$mXJ?jYIiZdvRCtL-m=Le#oQUU`+Qv?vdfx!R>FU&L8UDyid>T*!KOx;s
zhQ2;27&*+fN*xHdVBpeu1)e4%&ian@dQ3_ZSZ-_-u|dhIOF<-Wq-<gQV_7Jb3P~S3
z_aWXH5u|+J)}l2)WT=@Eukw1HmGkAQ5pH?y*Hd*_P?Ei#b*M7F5gu#=$ph}$JJ^I4
zo(2uIHQSD_wHp>6*oI}w9tNx)Eq-G}!y+*Rvj=oB{0uQj?v7=fx!_ek>K0(&kvKP0
zGxT36eF>wIdatW(&Dw8w1|{mLB5r{?sM$UeJdYrGK+X<m5@jyQt%F%byXl+<*m0vg
zHz5fm!U1TwEnZ3D<-6kywShY8f9DX`MZ|xiuoEOA#E7*w;sfvdlr4R2eQM>FjfH*H
zf>{@ad28whSq5|}(QPxY#i>PwG@l7Ya&y9cZIog03u!6Bo%1Oexv@CwhI}{n{YwVm
z-R0RXgJ{4r$L_hT$&OePVDQ$FA!cXBPSmVO8Ao40+-R|PBmrnia5e7<=HLNs*SxLk
zNHPr}RW7{yLvP<)(6gu??xO6LtkN9mlkBoQW&I!(3iv2934oVSBBOy-n`+ZTtzjG?
zvPX<!v?I*Jg67DC!>z4M5|e4w@|bO!VoKz60bq}JVj~})wsLd0{};mc9+c%9P{N~d
zGKGpKK6)do8ha(EP|kSnq-+zh<~)~|JVS?=;5DN_ytSWR`fNXf>mI=-i{4B8)fU57
zybNYYkFN_KF4o>lux8Q2Ip@oyvHd_aj9d-bA2jV?nx8-16WMJ5e6_AS?0M0R>Jwk_
z)iUS*XPK$Qe^Wab^Bi}-S}v>VwVEx)->qP!w-yVIM^5{uk*CNFM1&~7JZa_;l7kZs
zj=K%140C;I=mE>>&vU4x$ZT{sxG(}1t;-mq<Kdx(M5>w9zrKT425{0#^3{#Osx}yd
z(ZnZir|AbpL|92FbMZY$*Kjia4t()&F@LJbqyW5=)zfI!2Be4#n_vGyWub>h9hQYJ
z$!jL<=VykZ!<jz=uSP~fd1-7L^*j&tsw-{=Hg=RC=7n<cmqJyy8kXyCP#hWk9?Iwh
z@VyU%Y2d7s^+gqWY3hbDS}b;q2|<h9Syabm<xu-KDbUg2!^PFJ)aj3ra(b9VZ^a~h
z`**kDBNUBns7TZ2AVB-mnJ)OBNaQe~!+I9JmvKwpLPy%JPi4u588d?zeskqZo$R5e
zc=XHo+wB?%3<bni%)T`7^6eBjIyodMl@d49!zP0SlcqNq)`$)Vm;REiSq-UvRQujp
z^mNZb{Q_W1*=(K}Cezkk#1(<)GIAqvd+$JH(k7Ylkv3n99>WA17O<FZFX;gSQ!4RP
z&<5c4Q=DLk@n1ZjBfKYZDjK1!a`Nz_Ox_GYE+n~kXPT?RUr--_3@@k_L6a@CV2+nV
zFKIdLxJJ<fY{DjAWlE8r==Fj=AaTV*F<_xiU6%53O=c!UF5y}EDJ&9n0nOt%i2q81
z0e^#i3(e%I3+LTesR)B=p^?vgE(r(<6^Xy5cw#`~vvmX2M~Uv_LA&#d#L&%ruVw7(
z8W_|KXY|z4bf!TTtK$M{E?|_N0&rNUO9!K{*Pb>+jTSS?$%0;<5jF=0a1{MemQL?a
z$j^=7V5q<p)(@QSxdoUMaH`pm%Qe)JZIvmib9wIQCd<?@Q{*5E`Mv32)FP)_h4eSW
zN>@&~psigLvNSkvIugxsc?R#>t+%U_<#H$EjI`wTa2M5UzK%H~_vBanIa&jXCz1!J
z4co5kta@uu1k$UH_yz*S<ii^^0E~7zVhwzbm?qy^BQVpZNZul1_zgB~sC1aSJ{nZS
z#suS;GEWI&z!Cpo%kSX=Q|9x{WdO6BaUOu-2Wr;o_RfZvHG-Q<B;YK(rGbYYC-V;L
zg#3l6npn%>psK8PVcQ5_jj<(@UHmN6ZDSh9kCkDk1**+LfywRR^o?Y#z@cO@jdVf-
zr5?U^GlL4H+L&l-8ELru5Q#p6-83@YYl+Kf^8bo_60Vj^d2#w`v!z{Knxa|_6R#yf
zQakV-DHmuNK~vf`aH|u6!)#W(U*1L@jW2K9Rb|>55tWXH2Nnr2NJ70^D<bYL_Ulh>
zytAWD0w|CBQj)3=zC^l|L00S~s3g@blki}u;Z=Y9Yfb)=uhr=$;o5QrO<|y(Pjt%C
z^8r=#Z6+*qGl2x@Ahl?p;%xc+BvW)AC6tBH+3g7mCJCNjAj;14m+watR#A|XAV|k|
zukwHl?wcE{m{h_$fP$yo8rmdyhO=UtTa;_*O>9z2iq~^_9U^4>dAjy(n7xSujOvan
z0&tHj>SLN6SwG;U3L}&JVo0{H-W`%Lp4L*<czoJ6GUfYr>3bD?#!3|jf05^DbbRA0
zso?=2I0Fw`RvF~8ZPEk2{sO=Ek@aedIEChsqf0{co{o#KBc~>;sEM+QAzPo=-~P)$
zpp&djV%@M`gZJEmkU`82^Ye&*k-&iMz2P9}4`Ro=#U=Qa0M}R0yadXC@t_v|<^qOp
za;DWDxt2KJ;rJ!Nr;T&V;#V=p-AU=R{P-KMl?4|+3J(@eKZRZblvLRT5NX$bH4!8=
z2=5wy4+XXuC1hCR;`YmcT3yYomz0++e#3U8A<HwzwPtP+ok0Y_?)`8at=gbvtXm~!
z<4CQE-Z|AixV%Tpe*jgiu~wPfBeTl6KX4wC;X~1`jDb6Z&|8z<_#<Oy-tH=P2U-HS
z50D+sIvLjO_~smOh6hjf7aI6rf3gJJ_L!JH&U+&5+kvK6il^63<b!qaccNRK*DydH
zr)^CQx3AbY<fne>TwcP$P2Y%zgpYpoFGEY+Vk#7agyNX|L6LY8aKbr)jCml>l{ex`
zIKf~TT!19dTQW|>q}-)X_yS!=kexMS1~hd6i-hz{?06|Kk6TQ)h)O6O;3j#<iNhZk
z(5%RWhl1htk|WCHmL7=K5s~Fz-)rV=d^v6_p3qA{tmfbx$uFSt#Nr+32GHqy*b_MO
z9YuqX(9oJFY#EULF-csnB=zXGmSOak5ZyV=;CFBa9sv|F8{eCbHeF6K-jnLk-znCp
z@=1rrt{1(f1jO=93?w>{SGA1C6u`<zjMy~is&EeA?!x&?)K6+>-_J}4DoxX-<<slJ
zA3I11Tq1%FQW~bxIqrK+g_O9_Mc-ge&7`TLgRog$@i2J$7)e!&fO07|<+5|<s}<wi
zkwJc`*KI49PUf`zBhM@*RK5~nucOWAvfbaOz4r)LWhmr#G@-J?A%)DjX|qZGITUKJ
zhA$lPd4e7^jA3EYPPJl1>C^8~!wOirvLm-{rqCm`DvPeWX&$ztZ;bCRF)p?ObN|HO
z-l>K2h{<9O3P~NsK!BQu#7>8jCBEV=xI{t=TTdd@JC+}>?)(#o`rh0<#WJ#eOMZ2%
z-+&cpHE~AP(x!j95RIqt=o%qjZwf1OCPv0LMMM`3$D(KTA2|n+mJvZMyCixK55<M)
z;)3ZL?C+WqTj!I)VwccRo<7Aoc*Kw?R0tIKhqopenpXMo&bPQr#mxOEzf;Pa9^5%r
z`xs2Vv9?xC$ijCyyqY)K?i0a0k1+jqxxfR-$^f$)*x~sn9&ewSYZIkA(kX<{4B?L|
zL$w8xFDk{^F07C)a>%%y660!TFa~V^J&xbuE3bj<bR2h`AC8*8HkI=*dGy~-?ej&X
zJv^vy&L5v^e`+<|RA*Gfy`qJQu+kRB4WRl0E_(H&tPYO1CJf;@;YmUTi}1DvvO<tV
zSCX@=;GE*kjMpcdvb;7ZgOAE>!+0qU1{-rfNZkSBOUz*85ac>#rJt(hM(vLVqUL|n
zDm0%?Y|n;kPUyJh9>|N5^?R?cH(n3{W2u-SP^RLYXmk_lVR{W@84fDr7`d5^Hk*&n
zxP7=$(D+O=ezPjOg}yIO<Gu0TQ$^$`^wlaHZ~wLFbH0wED{e5L&{-?e{(W2L9Ma2Z
z?ISLD5^9h?3l?-cXc-LZ*{WxohYqRQUf~~QclqScS!4p1gKkHVGwQ0I@$XSSrDWe)
z7mkrB4kV$%9{%$YLub6w<GMrf8cBF5F055*R4rV!F_E}JUvo?f5X#}Lijb5Ot2E{G
z^F8Jk4pu)M{s(#}{AWz>@$vSCg)nPt4c9Nq@03*)W-cg0CQ7RG7#&!E`5tbLdP9q%
z>#aM~JD{7a>Uz5_j(I8^-m#>a0GCU;F|A62k9N1Z2>l^vG(WY}tU>E_XJeSJbnT<d
zHLVyelh^1ut8yp@8REEA-qpszP~u4M&Fa3*i1G8R_X7;oP9T4r{reg}JYtFgcGU1~
zmy8l?$TGW^8{H`Y&_D}_Z;o(_)yH&`vS4@#ZDjOe=2n>9w~fj_O(j+j^5qq;wbfB7
z>{s=Xue1qXpX_WM!Fsum6z|>=Krm@m*DCDj<xCgeb!Fo7|7AuYXBP-5sG`7U1i$mj
zh?A2?)!O!y81!|Y)Fc~f<<}^JU^cAS&r+51^gTFpQRm7L_T4Ruj3Yu<n5)^@G$0ap
zxi0)F#KkvZx!#D9V>Up-(H37-!M=*b>bC<KsVFEL3xs-firo%VUa}5y-h9IpU^1*6
z@WuFsHBezm9aLC%xap}bg+vd~%?f3q@jM)|z^rlCNbQ{3X1~!kQgkT9_=kA-Jv+Ug
z0{RMRw`ox>*FU}DuGQ0Wkh^I>M)LFJx#zI$7RoA=@o4Uw8J*=6+-w9XAZqCH-*E#4
zaW1|b0m)f)n{*V(5PTR?ZlW9GnPT3<S2!?R=J>a_x4DlGp?zB2LViOV@}dml1CM1x
zSt8eDe`br9VU9NH@fV(pKU^|VR$NyYKt2O1pOAK6vfx|s@p<$PRkc~6K|lm|n?{Q2
z<~yC=V@DGAFp1);(@b=ATWCKAEQ|ggyIgh3A*LNl-Qn#Knx!`xePR4BXt$VTy6gIJ
zs#DG$A<8V0s>ZP}b)iIeX+@4dlm>ysE9OpgItxzS;Dr0_QoWKiXYKF!VRGMGmDg+&
zGY82v#rF$Z5DBIfLI>yBVBICl_#u)e=Z_kUFRSSG@56ix1)bXD$Yey6n?bdjt3_o_
zyG`W76tV?}TuCcfBtW7B{tJv>piE^@zsYoe-Pk4S`|3Tr4Ul695kmHD#@i`e{tda(
z^G9a~a8kYq_%QOc0k}XvA_%CktN2lW5MGg4=O_ed;uaBKqyB8i)U<iU7~-aG$pp<h
zrysb{fuE~l#Zt79kF&89!=a+)y#wzB+Jt^>Wur&+7>&%Br?+F1$`<^8X&(6jpL%_}
zd>AA&Ye9Fr|8je&r8)7@)z<RPwur~+_}LuLv<&-M1F&Ezbr}(Y>dQ!cWe@yWEOVpG
zGG68=s10f>Vlo1-_H>sd(O=8zI%QO4IE0JFUgP}Ft-9CvKWqY#{SPK7VW1hPvLrv-
znF52{A80}Fy|7Wd!fKRc)B&tVMEK~JpIt+-Y$ewqP5M<;HHkP=AukvN{ij*U)5x}W
z<{%OoGXo*=DTpGzfZRF!Pk7k;GK7em#R=L)%z%w%v<A9RiA}!IWbQ1i&C3-9TjU`0
z?F8zA70;BWw7AA@!$CR}DDJL8c0d$@?jC%le&09nfmI^s3o>HxfGQ^;Ij^TBVj=B1
zL-bB1-Rp>5Z)|0~+cPom`z^13S@Xo)7*+GEh|1&b)cx4)8#3ROmDIKxW@C%#{39$-
z9z+mbakx4=Vu=vs<C@_8jg<4rp+O3nR`9w!*fRN{PJ1y8j#Z!kbx|FikhUF#^kGen
zU)U}1l~!wVFT`oRcAt@WUBo9vB*3*PW9M<f`@4oc>C*4Uabkl+9M5>OXoLj2R?)M9
z+w9pyKKm#y`NnSAZEzHW01`X=%j8g!Zj}A^e>4#j(VUI)dv^8p+ifEOb3IZQG|r<l
zl~NC1ioWK}cSi4+C`l+JH--`mTAjN7(e8;GX>Yg0#$AQ^L~p)KSBUUz(KuB>K2tut
zAUYyVntEWeH>T9e9=JFS3|E@?=QvZD*eF}M{t1bv_jnO2naxS2=Ip^z;h1%f{Hq~t
zbXVq-0I&Slx;ZRu1}z+qPwtn46CLh#yVA*a(4m37{{f&pKB-|`9Y>*$?Odl~IZlc6
zV|<m#wkvYDubp4o&p8W2qgx1U#d6o5LgZzO9`ggALYV%)vIOgW{(t3R**=8Om!C+<
zYIUQb)6faYs#|F4wW77Xm_wIQB1`!Ox6&3+!uhYUu+1LEzI@yNP(_;pNM7pTRNIIv
z!`m8))-_2^d6WZ>wh*%kTY|u%*{a>?13SyRYSNtSw-vkhSAXv$a_i_h$^Ym%9WJ>I
zX&<Cz>K!)2gfd^=asfp@qL&px!K_U*G))OUOlOY!<(ldaN~29>k|LZbeSMLoKn5kA
zPH)!I#e;pS^d;%TzOQrSH6Xgok7x=t)W?!rTq{&_jNoKdU6voov$0(eGln>2Iog>(
z=0?HKIM+)5w-qy81Z#k3YuPYyrhbTkte}n*k0ouyg%eoo7M?+=LT_9F$H#;uvlmxF
z-WuWnXC?lD!SG!gWiEH#p+R=gHjC_!mgmDW%mlBM`KCe@SW~XJxBTl`D>2YwJ7RiF
z<>h=jS;x)DUc1Z*vb~>s5QqZhdC!$*Y)I70<Ba4m9;rLsnO>fHlcs~}5u_P@;y!s3
zRA0}|z=XT+BLYt#fmH@VKbK|ZrcTlCaz>gM()WS>t;@lLxN?e^d$$^pC&%L?`f_Eo
z3pDMGv1?USKnK$9LD^e=-i4&p&M`NO!4;dI4nK&!*%x8hh&zUg(F9lO=JSS93$&_K
znaXW6ED~q!U<ck6F6;;~{!6c8^_WxG*Ts!y)(>AOo6QJ^TJJMFq$e?-L`E*2;|O7A
z#O&K?{P134|4AC3AZ3Hq>Z<g*oTiPm{18J9>xnTFS9MgqLu~xzHAT8)Z2@yxf1%@-
zA8T|hLbHsQEN_qlrUWvUa$@~HrPz+XpEZwFruHqWMk2+v5<?@m=8GGEZtF=NL9nCG
z?egt+%tXkIS}8c81?OtMC1Gb261~)}N1{{+;G*tb8?wHC6MALWF2142$KGP^mj^_y
z?~aT2;ShFDWX$Dn#(v<rfcJnm8yGGgMUuRmM~oq$qi8MNxFtfz;?<oT<&a<}%zSdT
zV4j=+p+;dU8s*!hFmgZZ-#BhDg(Ox;<Nwp7el-Hae~;#F@d{W$jmqW-xDrXN(weK#
zIS1#AN<us6qr^b_T>a!-NF@cXdt}z!%&e2q1jr=f%p-=_ulR-(P}tIDKDFo}#a3(r
zNTbp&;vfBRB(l&=#Z)#E0cDc=q>wm4fHF_qL8p%hInb8}d1DM>9nPIi&+|1l>h%16
z>X)7S(LMOwtK)vS<ocKf3X;`!S8=hYlhUNk&7ZOvO>UqFdev~Mq!_$`9W0uwpxfxF
zMA*TKtkul(NKKLK{(T^sLL8$f-I#0nrK??IB`wk54kp>HWNz~GYKra;k2F(BOczw3
zodqTVDT##_g^KZ$An?3xFijVAJ}0P7e{V6}I)OZwsmlWGysf!_MGQHD=!7Ow(__Zr
z)_KxP{fFa+>d#8n17yy{&^}P>=Iszq!vTkSr$Z^9a38h6N!_1_%?q(hHqYw|QKK3o
zFZU^fl{ZeFSc&}Wr|s9{4kjwj!-%yhAYFQtL4C1~CPiZ-k0sPAM6?>~<!4cFlJ|3*
zkcbkKPhQIc9bX8FXY6dKj$6g8z70)p{4aue2@1PBhOoT+Ixn0PCmT{o`@!~>x2@&t
zW&Ehga+Ofu>?xxk#jaFtv?mn&tXQ&CV?cP1JQH^SJv*k*!be*)Fs~m*GNfQ)&nv~x
zD~Fo0^zQdymJtJ_kj{lal>l7B9R#I@FIX<APRl?#Dnt2xES$FAD|^;cnD0J@-%Zah
zx)}JM9Ud`m0i1C)TLK#!7S4-a+t`5wa2g2j2z398ywtYviBtLRz?at=vp{Uz&kL%(
z8x80=2?E#{u@YpXH&|p@T3exFzCm?c;aB{+li!uuEYo8eE+Um)v7l3PUcoPf)B%q)
z3!H-h5kER)`z1-%vn;3@2vGA|8Ee=%mhwj3PKuO923upQe#zi5z1cyitd`>6{ypq(
zo3`NIx*+%f)q#|9*nF`ybxigQzinJ(lC2%nj;|G;+4JN<niDL6y2gbP>PY5o@Ku`U
zT<=Hz1m2+hsw>nwhj^YO-$e$iMY1u8e8pPLHG+vE!270ly{Y`u&On$$qF#Xc+90Vw
zF!|#4X?w99F3`n|aO);&H<dQZysOge;<_3w1CPSuJadE%KScc`acf8`xD|n#gb%r=
zth^B$vEF0F3<veDg0=r<UC5VUCM0N^P8v%xxh6~fFTLQ~ZXdWd3$DhFG^y|TnB)ni
z^ju&z;$nYj4mDpJNytX?Sr0$FjA@2^3rE+{ek5~i4X9V#Xs)M!D1@~ETz*6G@XU>B
zMtJ!vEWsP@7|6>mYj}o7yN%>X)kf+Lc;RqTKCW5wTq-@hs(;vk6Xus=SSbmr^|T9s
zU3mIez<^$|OeWD|;nrUwcNooiAOLr&B~*6u_QG+ugvc}?3Y#dpA(gxWlj@N@C7K<R
zoEjgVK?fFiS5-Iwj~Ir!G#?VT&qL~gH|N;L&TJe>18maxdLVSr_(dW1wjW3kA6CYZ
z>2_vR6T0@APk@`FIVDn+czd5d)PRZaT4;rqZ(>c$?;~>J2gZ-!-@!ND&;_;KU`SvP
z!%m&DT+m9CME~;6!m|=clTU`4vQL=+^k*!Rpv`f7o9!5(>j9Rwv-SovR2V<xhEF{9
zZJ&FaLO`>-j>O$jGl_FDh9cZgG}WjJtm!?C!nHa6C`Dzcl>K6pq(N2$xjMw($UWAJ
zM{qvkO4f>m*BP$r(a?A}z8r6F=nSPn4$eaSt8_GWzFq<^6&nEzLF=VrMI+WRUPcq1
zT&xQnzWs)MPtBM-|Fr)N8&<X-q=`#4<tUJMrYWiPq(?;%#tWK)Z{-hy2T-AB$6=2z
zw5leDzu+AiT1dasj5*ODFYicAsSZ)p!wga3{)YdOU$zloy(QAG#xA&~EWb_FM7BtH
z1)gEwf}6I#j*nr}t!1>2A=a{&weP$qchkA!NCZ7WrleP<4A+<S8kpZ^M_rXY%Y(ZC
znuU!E{%J>VT;l!J2&wG}7PA=f^Qct&3XF$y@+;8g_7fjGfc^ChdHN&S$)88MJiBM+
z`qSEwu<dyI&9o)50Q>eUM4nFdc=t_2p%wbQbeDyW_efHytUz2u`dN=RR|DF-df<!}
z{o(XI6r&|Kcj?kSIWqvW2d5cuXv4NLyJo8~PyCgCc|v#r**JXqvm-H1-Y*BAkK|3X
zs{!l5nk)avT7KaZN}3}$k-<AkN>Tv&j+m0@R(O>>v*Zu~^6hju4WoN*Ere+<Qy?A8
zmeoqeZK9E}IX*f+QiI5r_-Q0WkzsL~EGVU0LlStSADhB19kfhr!Kh{k7?vVrRY>Q9
z#y1~jUdMtxFy;JN4eZPyZYiQb+XAUV0k0R^VzIq*ABJE36-H`$nki@<q0jCnU91u-
zWw$pFzRkUdl#5|Q1NPt%rA9)qS(1+Buh_IA0I!5tH-~ans=}hcBo@OE42BG2A~=G$
z<1bQa18MOCFqR)0?(HS~;J|`P`SNK@*lVVzG15F?D6DDCHzWD+;o{1rj+6ay@h@J?
zPzts#0j9&b3FegGcA#m88EcMH28*<_GVLUZ6bFr>ppb)lS$#yN<Mi`#nqab6BgIv}
zF@V(3A9tI610@jt#q9E?&q+=XH%cP6qi<lMxJ`EeBupDAUDtTo{wk=+Hct8qsZZZC
zR*b&LO3cO!uDy*$WIpq+mdb0LZW6qOw2$T-|8`F{QcGNj+0&otU}`YoQn*XbMKZO<
zgzKwF4r_@^D~V!RtST}U6=Yb%PeHz{ONO^)nfGHKw=lqF_dD|>!X^I5XLY9UT-<s5
zMcqxDG^I49-ZAlSjV>w?i&@wLWz%VMfrGZ6&CGHpZek_rP1hZwWKqXeQweo=Z!6bc
z0njTMFgHh0-=!0Kb8N`VQjq_cLmpNGcS+BL?&~P#0#cv0pLff0%7E%ZQTyQ|14}$r
zsY4=_d59sX3-}o{^fun*sz8H7Gg?m*dt@;lsTqB`#B}5Bn)lch1Y--MeG;GX{J*)!
zst&#3^nbQQSg_-TV{wML`Vgao*zfy){7m(sr;5SvGI)77t=N96WpX?hV8a{8Qd@D5
z5Dp8GO&okwkMD^O{D0&$vs#zNFaTr#$o=bYpwQtSzfNC`{oj5ZmEyPkQ+5}cUq|qK
zVs4hM6wf&7@pxU<=ARWY;YdjACpO_vegAFppy8nX76ZUCH2c-4<Zzc@XZ0MqMl4;=
z!IFzwdzy1`#7j~CR}k9^F4>t2O@PnJd}Nus!*=*^Gg`(AwYs6Bz@}0Q%odC^&{HGl
zAcF*W9^gdqb|(@lF`Lw_K!I0<gOsDOxxAgd!#GNo_?9*<W`afkm1K-t^m@zRpIq>>
z_o2;2oK)B=6LZIm`pu(=!Ku-b#2Iit4+Sc?Kg6}RAA-4(OuAu^%WqRP1f}f!B#T%{
zZJV?J^;GlMca$m-c7GF*RQ<sUa=d}FFiS@%1b!o;q?XhBUn$?y)ky<+n;d*udu~PZ
zbj*3cEigb}2O}m8Pzxsb-}I}Z%!<?su*}Nw>Q5<DAGPQ&44`Kzjm=c@1Pa?^Z%dkx
zFo3vqVRZ6IUaAiF4lUM}C0*B|hOP7!JK?XC+rlmIHvkd=J(vFn)l2xGih{0(gfCUS
zj$bX6P4#)T9+`CRL_jr~Qxb0!Kv<AF_^v_VZ1~6ZHvg5aktzv^TFY|aVEhd4?_l9d
z#deZ5&Q~JZ!}JwoobQDy-|Nd1Ejt#9Ox8XB^aKc@g3W86=n+`Bxlr0MVaahikzvXM
zYv1t{=51fCv)*lCXqI{Zq@9a<oslnH@lbL?;9<>Da4iEhB*VkTU#uSwdeHTuXu?Dl
zL*Y!JL?C_q#g&fAlDJ@o>}LdTR)1XXnYp!q*BF)@bR(W3linTbi-78KmfxcYNYSOW
z_S5#r4Zq#BSG4=2ejuwcPC0{mED;?w*WB|kfSsoD-V2_6{#^3!MyAGtZ=1;#TUJoU
z+oD3Br~mB9o3ks}0ohx*CT-~CF#}R)@i*gqfTaC8ZuVi1pRMOL!}sk#dV7@4cVFiC
zcr70lm5bV%`^*qwKTvU3WcsEsW-{3U2#%A_obU9R7f?db&OhOhWrwd_K;uTVvK}4t
ziX4Qr*|ID0EZ`XZ)a;lwO2lo^l{0U_mJ6D#W-fJI`MmUdW^9QWkDH<xVXuN;VV{oy
z>r$u%L%^4ucfJzS`eZmHLkto8ePPd(XMB$tR9MR_ii(yIaJhDd>87@;%8Z*LDtS12
zEX|OYEqjakuNMz8)#Ix*<wsJKDl6#oaaZmnWgLwCZ`ahnGlj%;ir5rqMv5FFaJ+C~
zS=}t96$E#LB!BBIv_@vSElX5mDLsX|>500Ct*PP8hjI>N@gZ-<fW!GHTSL;|2kXbA
zye^|3&Kd$cs9<q}WdGzkT0>>7o&W=9N(RQ<+#(2c%37t+OG;cEEl}Zq7o67;N59Cp
zJu@?9O#({+8<c^|eIG6KoQ!|cX`rA&HiPv=*}vN}$p14CLnCRrp9ALx5DZgTt|j3i
z%Oo6_w1;1>s-*CENNOo|QzQK+5pM;u)`cS+-Dl!0b7ub{^K%CsqhG1HjoFF`gDD0M
z?wc6dEHrozCtUfS<z%(mStx5HBoYsTBy~SORSCW`E$sa6QVbTYg@pfcv}PCSf@g#l
zsTOTyr*r5bYJCQ~3t6KOVBtI{Nc>4U!wa7(@!s3R_M4w!+?wun(toEvte+N=|HKWN
zLD{~Q@Z8v)uFwuPX04;1G(~4=#ZS57aOz{rv@p7KtY4NRZg7hOc?kXNn^;j5jH<c9
zie!5^OzD#$;H@3H&a4<X*1?ltAtR{*(asdRP*I{xmi%G3?8zs@1$;ruEYSIv*NGJ|
z`u-EGg#Cyy;+YWFDAT2iIrAJG`Yky=s;SzGr4@6lc2nxXOWRE%v{=3F8f=$fB&al#
zM^R^zIRhj+c2xNSsmk8rL@>{~l0L4)H4YZg(w54lB#=K>=RIw&9?Kga(E}H`!1O(R
zlbH@q@we_l10jd>0Ap;bha+t!w*e5Oe#IW8JcHY4@1*BiSy17~&J8~`Fa&!C;}91~
zQeHK2&EwrBA*ccj9Y^2jPx3sdi_-+CmBPrVfqDZb^Dlg7!9{A5Jb)f^IHjRKh{a!z
z;u|c*vJ;=Y=mPvt<|V#O)pS-@n`sU_n9SE03EV{pm=Ku}dz{QjtbD?uThcCd;qBOo
zl!TI5c;PU=CD`i)$rO8Wr)OWRb9YcruY)S7u++N<I<&oSER;esn-pmqZCa~uB|j9)
z?+&FT<rO+O3;>(fn#-65m2I!hum*`pGxEHa)OAT~L}~J}EpP>iMPo;bFQa&8cb%`u
zj#3`yx88(rjS#39P7^6R92nAl(ENqe3+n69sd$hrO#EJNOv5p)dZXd^f7X3ZPP1zl
z4OTVUgcU@IzpRfBp(OOYe@R9U|DKS%+*^FF>I%WG4A#W_dG7TO9DDC*>po{6^W#bX
zr+v+Blo1XdbF|PZCK)3&l4iV118)vJg}{#JhC&+*QAGWNP|)3h|CD~WcmGw)_UHX~
z^Gk8n7<Y&?1z-?$Y*CkM^G_+9dJ*bigeEfIRGS&Z|L7NJ2UCw)(y?;^06%&sf)WH9
zvIWt_dzkBr$80VqCv64-b<uyN!QcYX-qdAhX=aAx4Mm^_+*VcjO<KQ2I$N{qrvB$u
z9x~?;ZKM>4chD%afTEK<8;^*`wE{K%P8V9*?qQhOGw>WRctzr4so67YhOoi7kkwMk
zN%>3oQHSuSE%G9@49zSAc+IW=feJuF4FBxilj`OiIuYK+pk@3211hw`x%5?p%5c`x
zy}h=T6|eR?*^>0DPhTpSlhtaCQ!4*1fcm@~xJ2&{vFr=HAprzP_$@etF@LRK<|PkK
ze>uVxu)PsElbX-1-f7{Reyl4y-Wv25eDhaRL{oS)H+qXPnVtL<HIL)myE`DFay`FB
z+{Ni1jubd6DgWPh{z$NRIKy{F2O@@Hwda+1CETHH82ju@^c?lt#QVMybB;G?pvLrL
zRO;xriH?i;zlWok$mCFVFZaC#FPMtY=s~U=^VS!F&szwLLaWLv?BO@VRvqA`UTbIn
zg&rZPfL}7ryL|(~c$2|gb(Ce!YaJHm@ql#s?{8zg9w?LZ^AhNM6gZGZCkbhYLVl^N
zZ=t9-V0fv8hWeZug>iN&T<DvYGodNzTl(pCgL@C~P9vEO%T#hXhah1M-mqX{NMw1)
z5<_81`Xg3PNyZfxG+=#ZhAGOqZvTV#1pIQYj3DeA!kFJX>10qQ_e4#~pEZrZyXd$o
zH?U3!wB@ViahG~)8>$-MPAjlYb2*#zq)~SvWsQiQ{!xBDuKQ^&(@%0(2JMUw#k@iW
zO^Z<NdsMPvCLaR{47T~)PjGJ(Y3&)TZ?A+z-w_i0{FxaRT7PtYuah6h6BVYS<1j$f
zC7Zk*9~@S`e40J|5>r>y@g#1oBfX^-pSSI*87~&>uhkt?QbDqLEHqmGtAk=mYn)}G
z4(h*fwU}G@gebG~N)A66G0W&{+&p6ZqL98{GC?8f6}t1%r45Os{Jx0Z+rKD`sv6@r
zVFa)h;Sa6{*#Ki*I(B(PXLNTwao%$nYS+;PpbU&?GM6}8@7vlaR60upF7eVs<+n6h
zOtkNeG>4eXdv`ds{Oo?xRZtV0laV}-A7Ktfb8?4>X<r|?US5fX`PVE^6fAyglkOyS
zf6aH#<R>9s#*%TgD9%oY5tT95%o#lm*lF8JY2P@zYm!fT6(X!35Y%`xy_@crPS6Fy
z%U=;}(H5c4QeH3Wyd78Z@>-wf;Y*ufmYssD{Ogjcohw+;J+TB?Qf-+bm~hzj!@`wA
z`(MXjdyCJcx-h~8QZk&g{kF_?ySM&k)YMqvU|X!7WUqtqmiOojN==&zVIjW|HkxYx
zhntj)e$QU0%?tMz6SlXNv20k^IXmN+Z@P$7q8G(G25<EhGr#Kk-}a#ZBl3|UNij1X
zxA}s@t1R{uBI~zY|4=_-OjMlH_|$cf8HRsPwVWcGv5kfj4t@RaUoHRvEwL;wHhAY(
zS>FvIv4|@9>AYu901Lb<iGa-C$gR8vE*p)&9?I5RVOx@->33zZQCzW(?q3TQEF(2)
z$&4M+#E5TGd)sw2(^PO5{iSclKxK<GOxy~fL8-#io#0^@wC5eesmglkU$I6q07cx)
z^FuvXe}N&5zu$nTXd+}Q_tK{<9IUnRLkFQfilsJ0P;|Mg>O(<ETSmFQ1ALcUK5kj!
zfT^c|ysu^oI~*e9R2`HW`ZqVT<R67S6Z?ZDkN`a9fPw|J>NYTTg#au>e*?xB%XyXM
zNU)#<n*!^xzLI=)SHN>dy(eR28@Nc&+CA!PJ3*4*@L0g?Aocbgp_XN*?pUI7lX##I
zDak~3i};k)&29*9nj|4+{7%j~pQ+Nu3hyn$;(jGMO(}3!OHEVMGm%*TMfG+wekesx
zK#d=)+jF{}>ntyR(mC|bM!-Ykf~G4OHJL?>-?Yd-2)wtF2*`22rPxU~bMO^Atdf};
z1SRqWz}rGiL$Za%dB5{OfC;}cEv_^4L}Z@+8X5kCOj@4o_{D+GoD3bmzjsN{5E9j?
zB?2-Y^*D085zTp`Sp&T+3$qWn<db4O#-M8u)ea6H7eD5kRHgkn>o|j8L#@Z!7Xa?z
zDbG{#1l~#7pVOm>YHEN6%&2?Ka#m`kLj9p`?GHD<UFOr^<qmI_iL9%GdPanLUkt>^
z0j5CV)x?x|{>*o3AGY3@v}q3KolX$Lsup(s;myw)b<FCS(CoOy9nB-)*_-mHk$PA=
zu*Y~JpKaHs_wGF4r=Ki>A#&;R36cOWFpVc3)bB^%S97+1?_Ki+nhnX}6W+r~s@@7y
z=PCcy*7DNiUocPdT*94q7HWX5rv)3CH*o&e@K&R4y1um8HH*?MZivVaS;HpdBwTKL
zbi-eASVxmEE71R1)Lp@csnEQKj@OytX-|d+%xltD`x`4zUsw*J5a}{gi>iSCD2R9z
z1kz!sZ%(Cvn137B89f<A5*%O=XQYyFoqk7bZKTC4cT-B^J}@f4d`uoJZfUVgyD^@D
z8G!Rw|IZHQ9wtD14rBJ}gfVS%korVcqcm;4$%mOqgC^veV)cvaOGVTC>>(&VeW;~m
zYgt3v>eY%3!}oa;l60_H*=$HB(-G_^BsScl&dGunb+&w&>VChMs-DnJap;!mb})7=
zpVVaw^_nckO}_+#`W&6OvLpRnqskAbQo>Yyh#ekhp1Em9Zs}*}n-Z#G4y$hOD;65o
zd0G?)YCHypP;d>Up!w}+o8EyDh&_8ihF=rA!)c_yS2qj(C*G=COmcmYbdzM6lwj~B
zru$WfWB;^=`7%G3iw;Iwf)`My-xhQI0`l24fdJS+w26Hi+u6qN68Zs8Y3nZ(d3-9T
zl#tP9w`)jA?vWn8t2uOA^QKXz6HLPzJPD4Yy#x5zg!uCdz1t1<Gb`Cmy1bfOw!=v@
z+8qXX$@QMMWDc?z-u8U2dK2V|r8Ys}G_ZXoa;?_pW067CBBT?$xe&V#-5GjMXBMbV
z*7v0~&e|`tj-2<nX+5W}e`5_2Jg^8xztj_=qz{we=oMrO=fd(nBwiBG{bvYT?{ktd
za;?Ml`|*K$P?GvW32{|mdsZ}n$171w-r#4QVYQm|^Hu_3`}Hf}=v}CbGJuA)=(xEC
zYQtrZ2*5wTl{>2&-rMfy@?<0ch>&5+X=fsXL=HKD?LAWIOZM-fjLjN+d-i$<Z!R>3
zQ+N1KiB0CK4qijD(S*Axop$og31U`x0*QLY1xe|B(pVP8Lbqg>=8>DpIJs4IW7(MR
zElp&qhg?LDVG|tB56qT!0akd^d;Ah$>H{SpV9<1$g3JfaxDsR7K@~rK9hqsvtc~n|
zp$M^LDdck=2DO9N7={}fS(|YrET?|6HzHM&$M%t#r^AvwT}WrTY~U!ZH38y_tmKzN
zo^QkPNO;7MF$oszr;ckwwViUV>>S7iJ^P2;Z)*Q;5jgleLyD68o_M*K1H5?UWT?#m
zdP%w@h<4hWiwN`YVGG*aS0-Q9{-qQ7WpflnEv#iMVK}foL#P7p2yxZ@BC){BwyE}1
zAVifVz0#_)1ggw|H*lZg$8-qjhosQY#7?vAgrsq19X$+LXnUl^CeY`h;+avJb!BkB
zDwsdMwk?MBMhe;=kRTFWaN;b=uS7?_#HP=7kPGaT*S_Ah)Usd}P7;_@c}@`&-|i()
zIs(X}K=5#$`$LT)sz4~+Y)-2M=7f{eLqxu=-4ib!rRTB|i{8MCUW_WI^j4e;0(My%
zxuWRn25&^md}a+&Y}s*so~n8v_Wqy@QyR3)PQ1-JG56i(9G_dOJPu+Egb@8BGnO6@
zgo$AuAv>O{(vU4Oo^@~@3lKD40dJ#6o5v3vd0eg+y@fzS&kQ_tlpk$N37eczM_)hu
znTq*~Gk0r=SUVs{*Y|nnOZBclT7sK=={Bs_U^7aUZy)m~5GNKY7Ey$GRk3EPjG<pL
zA~)2lKiWX(JMnZOewdg<3$X8erUkzQo#%Z|x5HzW&2&lJt=<rG=9i@n`L=CDZ0qde
zn)@LZd^V`i!$3B*?et+|*-m99#)s;Wbo&=kuZ<*1n_E@e7J$5IaZu~3acO&Evlu<|
z3e8i`q3d8&Y()|)>;v4cz<FO(!@SkP9g157#{{N!YyV%bscz40#V_gFi!=eFrXk*`
z;Vhf2fZHaik<SY+K5xC9L~M>5!j>QPq_q1Z{fU(=69#`P*b9Mv3%7=oUtQ6Y#OyvF
zJE?s+Rn7k4=TE<xR*IsS%Hm>>m_ILLux<t1^l6^SfR%4_B6Vd<8(*sNj$n%;NYk!^
zF`97M$gs*G$fkl~61bD|_1)_8H=WGqyOrIE%aXLgaH~#nP!7{yz9Dm{#W!|`5Kllx
zkH|2J#rGIIjv$<{GS7a;Kl#;@x7;7>4{h2Fw_)EJXmDBcvWMp2Nr8$773a;?__9}&
zK46Pww90_a*I<*zQ5An`ro4_S`94?PJKq*$JPdbfO37#Dq@M;x1>ggk93q;Sp@O$Y
zAM1!?bejD;>#{WVe%XG?UiEl&kM1U9!bxkYSm>qC$DCKdP4pqVYohI~`7*ZH$Qh-#
zo_8=p8Buk)r(_fFfE92)K*PnJSw*MkpM!6+?VG1go}-aQkrqB?R(Le~YP_oA0|4c^
z=Z$U72G!@lCK!hK;$uZj@nF+4)w?}EHF|jE5FnR`sBZ2eD7_HwQzuBf$cQ3D?8iuF
z$e1A{hQv)W+4KBCqOu%`<#)2;5k~qf(S~UiCQ7sv`m6;*+6HIo%`>&lqX17W=AypJ
zjdQQYImaB~)j-F<do)-g`g<6nBiVE(HS{;dJmlEYpxD0&fkDF;Y*;@YlyJ&N4G``c
zj(NPE#);t66FtX`nlC9B$NWmb&1<)C7ygi-zeX@$@C8e#H=An-5g$FK#i#XqYV|L(
zRR_bDIdfCo8>D$LbJQqF*(+!kqFt=~DK3_7u5(e5&#HxyY4l)#vJG!SqR%_C0+iZt
zWjWQA4xG%+R{<3|HQ1Z*c|4}lN~y1Y<8%2EshI#iWHTD0)HA{Nx9T<9jZR3_$$ge5
zqklz^yI?dofPDGL34Vkm=2i^}eFO@Uk<r;BHM{xUqPHNfuY`rdz-W{ZPM>0^?rrh+
zTF&dZhFT(dv1qrd#a`v|z77uNJgzAE^u(B2jV!4@=|z}csHne6QaKmxJ&dLzdNtL=
zI(o3<bXjcpKi#(z8?1O4CUx`F)@`(y?+e#+Q7|2PA2C(geWd-Pm4$>{kuim0dQXx2
zAGhqFq!`lt3Ur|zuyd!bHt35bYB$Z=1dusQ=|y8mX{r2k>iL(Nr-gi_<D#z#`ie)z
zt9~}bjX7d~bN5h`Jl}%T5;kE3qCA)%5CcQY`F+#bhAJFrgvz+F11f$L3Z5kbojQX1
zXgFi)?-%+y{fx<L=8aL9C}z6`6EzBGFzy!75Pe`n&rlKdNd?cVrr&I_=s!*|=CN!k
z_e;R21Eh1`--*Sz8h&b(`h0+`tfXL0RhEdXa&R(amd^dCM>_%rP8FxjS9i<u2#1>~
zSeergK-m!W0Z?VEbSkcDng-V#X=VMFEV+Z)`U%9aYs^KwUzc7wP4azorS3flXC{ZK
z`=W*rfqwPQ3Ci6{|GkqeUJ5HY+Rlofb9j1yFx=BEO$G3r8rp#7CYuT?VU_tcJDG;F
z-F&9Hb=tLj85m7aw~WK^rl%qCc0XqyJS1&<k4~N+IdOzN13Vl*h{^%TvnrB-bH&$f
z`_Z6mTGYB|oLL#T5pT;%y=+$L?FHSaPSYS26B0Q!Od#y(^liDgPV)l;58p5r-oP4n
zWg}{3xy*`<-#*n%vuT!)ITZG{O)ek3mZX|}Bo?;|lLBmdES^B6vry+OlPAmmL$Z*4
zy50Y4UQ*kjf65F7teopg$w2X}mmuFz`AizWu!WjSwX2x5t^~-PR&FpTyu;oPkQ|^4
zD!PQ0YMfuMB7lG4srAZb(SywDvDdBqqh~);K}5S3P{{SIXAyPxjcE5&-*Eg^o4$Z+
zt=DF<w-qw>R!^1hG?2B&25SZCU+-EB{pv@#u&YLm+#5U>m9<)^{Xn)w_?K|RAvwDS
zf8|e~WJ9x2Q;PIVVk!8Zc1-L8f)y>_)@&uYRC2{D5H}P$Q+RQk)8(Nos@%+ID!a?I
z@=9{ebA>`$C#=y$L!limjL8%3i6CsXN4BgD8*JjI2}~=S{_}<0)P6gg97E|M2Nx3T
zjyaB4v@Zm=nMb4;IE*c>LfjtIP(AwL+t@eO5Db1WfBvNXzIl(oRS=Yf*fQLoD1&*d
z-C5NQd8tMOJ*3#6g;l6Ga*JJk5liiV7&1tW=M0Q9i}iJ=rxtl^IZ5l(BKDm26~8mZ
zlxfsMi$I&MSN6jwlE|u!EX)fng;u5*h6cp506{>$zpu5HcCmgnuoDO$e&V%};`2wr
z`9ofu@Ic~k|1L5@Z~Ow9j(doGP~_x@3Fj?p!6UV1VlclWu<bHOM81=#eGjp(2RR8k
z@3Z<Z#I~zcU(0=G8x+zVH4L#`#<9~BE?I;pxPoILBHR<8EOV@4i)pB9--1ld%XL9@
z5ePmed*{y%vzaSK>o6AF<b)QY#`Ti>uuE|lF`tW{QVIlDt15+J(@vZx9x3&fk31U#
zt8?LXe~{?H<mL$ug*U$t&d#|55lnc3;7ho1`jfJX7Rt(cA4TF=<P{IX4}!(5#w;Z!
z-8_?~6VnbIpL6LSLvmPZ><N!nB4ti?A;VL@)OWMgF!!Z@p-h+waAOIfQ(K5Y+vB$w
zY6&UYbA=7;#PWUl1VTM((!Q>K7~W639eFxZ>|jZtOlR4<LoPyY<{gr_V9KfhU+2Pk
zwH67U#-Jhqox3SPb4jX>{+|-f=C?`pN+lkHyFeFabp(c7u>4=>$Is}KC_NhPNx&fj
zC|s_ED!7<Vgoa~UQe+WllDSz?v%hkNNJY6WyGFMqqbQI%tI^S!tZiCKV`kG3PnE2!
z2|LdZu$J-EiWg4YawuSUT|{cL3}p)Dg5s3i02ZENN@+k4yLfeZD_-!+S_xpJ%+XbQ
ziRUsiFs2h+tVEGFeL732qGctlEz}HctA5MYY<jg6rO7KV)P!tmZwq_G60gyPU^cHE
zZ<g_klyV1EyHr&}L;PrSnabJIJ3iOIf%fEF=`0K-57G4ajs!w^4>l?Ey5aFtEhjz#
zZap5<M2)bI?m|fMn?`lJUE=}{mC!BqFa)epN6tR{{l<!V@|OK@c~=YpbGer##`bO5
z3VINZLpyIv8ZS{X38u{offj3F*3Px4%9b*n;nC=J5ld(6h+w{zwr?bnSr4jyqkV~h
z)6mc+M7j`2d_h%Ip?^>Onqh967{UG^H4BpMmqzbGWL|#GNfnDQzXpGZ(%Tn}aPWvQ
z{jrqCIYKV-QXZ0m^ye*fhxDLyW6bRF7M$HX+gHGi)lumaKYBz_lJtRsOzOeCo;=Fo
zq9rGx=ytSX>^dd69fil^gL?vC72>Xbo81%rBMAy(;XN6ZxplBq(GRk@U#W^L6o{xp
zP*j=b(J3J{4BzoW{#ZD=f;HvT8YkT#dpsLFF3aqTlMowgxisoUJ@?B+1cjOYyE^lX
z>KsHUe`PD<FO)$fy*=tDQ5F2r+rkjU{#+AIi7Tv@kw;}pNAGr-{^*Cz<9`Xn0lNqI
z8O^spi~;q5vb0t6*U+KkacsHSceWES2sUK;Er4QRRa#i5ET^r=nlM;4&Vbz^aS;?T
zA0*2s@a(W>v#pC}$}%dr;cvT;MpvqJ@Ta%NX%CRK!yw8khVbE5MSX(FvpjseVY{}<
zk|j17ce>q7?;4fWhT^?k_1((}NpNeF3P9BwDZ2sZ$=sMqOhySLVb~4MPMES|_{`4O
zcoZ1+Lj<;YXnJCS5gq6Hzk8GW0M~{ovIx;$?Ci-@c6Vh?pG?N*l^}1T!`+DPa3R-;
z&hNa`@EhYQdSjPvOVPp_B6cg+6Wmq=iU3}`FT(;IztdAzNjl+0-Y@!<bOGENSf@hu
zJ10?*truC0W<GIhiFBxl{k`f^V=PcV6kgVWYEPK}F8-5SM}5;}1L$o`r(5M5lv<3A
zo^|f6kfsqfmeQ;dixy#XOqI!kQL5r~$p}*_CU$Xru!+gaboS|?h?CJLzdeGkX5CbZ
zs-guA=$0^Ck^@KA7S(mCsW(t)u{!{778IC|Rqo$nacx2gB^;DQnNQM4@bEZD4wVZt
z<<qMyChUEqZ;_jM;%Zz8eVl#kS4RHT?1|#?Wm|N~a%Y#YBTy+uF*s_k#6(kY-%xH8
z*NR%}_=@71a-=gu;hbeG`>#;litlQVcmgqu1?l_jrO>r9l}JEc?&$3!f)NPK|Lg|r
zco}81E4N&CeD%dhS<zd^;y3uircab#+hVS|x`OExZs25<-fV!1^8defjVxbTM(e~e
z_?TK}5YKG!ga%cIj5Tk9(hzYb1zY=GrP5tSG;wX9urj2Mu9=a(>BOk4=AFe!MuyjJ
zXsFxU3G-==G5i}P>ITYUruXMQhbG9h=_?iYxt(R+AG}DCON}9@egpN{PhfB@XSmJ1
z5OJ_d2L~*vm%M~VpJf@R4h96q$dz?qIr+W_CKv6eV8X}~lMg=~aI$gz(r8SJvVyKx
z&LjRsrR~fUxbDcYUP%m{jA3hw&z)bJ`&80?m%%WxIHF)~#PyN2bNghg!vQcg`kAI`
zX75v7*3X53iF~Na?bYLp3F78G*f){3ym9PI-Cs&YC=1kz?0=~YwN!qHB93Rx#GPg3
z=(&(>sFY<a)bP{|<E`L&wJHCzQ(!et1x;&)qJr=_QavE5>@*Od@X3_kcy|BEnrjbG
zQY^|Cu++XH%6OL^%D@QZKNj3yL8^8a-Y6+$_qPSMdo5AiI0~9-@V)*(soyH*zQIP)
zcM=!J!ZG5+m0>Nk>xl?+7(J_sg_b|TpJ;Www*z9&uBUs;obIRy4@V^m_(@|;?z|#V
zE<Kzg7Q!QMynf4BII*5>${Vt5mgX<&eFF{)J$GaCVGM6LhRuF;*v5m*vSX_PNik#}
zFmz^;&)AXpydBb(mv5Wi^hlvBt2-8l{-D}qTn}6iSkQuAtv@|R%E~paG^U)+p9X*^
zY`_4b?gQUWbK&SbvGCJUK;Zql7I%}47Nt0mEcO`BJXw5FB4@$hGcl4R4Y$)F6Q)hz
zI1X5R?H)S(aG6E-DbN4KLLK8kzpYM{GJjjO%5KfBxq8)Tr>}{ooG09HeJdmL;k`~R
zsMYnq-FJOW+;{tdKBQ%#>J36&)52FXUjO`@NgN9nLqMG4PkRwBd$`yxDBN`GFIB5;
z6ezYMze7E$2W~j5e|@Sf$f{vN%9B{T1Pnve<_!W4Cn!k!&6*Rx^PUOH2bI%{;!^0z
zv)fsgK1|0qDdpH-o|?Sps#mdru-%K$o9kRd*4EQbU)wL*rA_N|MSj*?dCZJfr$c;X
z9Z`H)1G@z;&j|MC+CPNKy&m&;UvXh?5eGC_2E1yhRk-)PTJTdl-dL&g+14kTUDs#K
zMRg{np>7nH<5>cEC?J?lIIojr$fT{Y8F67*Y(n)H)&`HYm>4agTx=SS)7Mb^Z1~G+
zaRv~tWPISjsBTb_N*fS0<&v!?R74IO(g;L)hytZSJVocsQD=$JL6uMQ`cnSUou=5u
z`eIZ$xAd4HNdnq5Rsv>j4)N@s_H1EWqRyQ0ua|;I9>3FqCA>5%UAljuGp7Mlb+fbw
zDQv8GS@#8&GqK!{A6v=h(kM{_qDwD8VV(t?C-~N=<F+WqC<_&#pkkx*%Ef6$(JU@l
z`Rh_@puvBza!#bef_euyV2gPSpq871xx}rNM;eS01^&<0@fXOLw7Vt7L4_tXD}P70
zQ8M<&y;TzCAsE_gr#Zxaak}uycWZ@rZS!*n5oipqGZr=;NVMRQaTaXhMOSY|efMZ1
z$chzXzZr+IUQ1uc7GngM@o6@QVOMzpY3h$jlpR~LMIq0|Sq(F3Q9FO|*QaBqS_z&Z
zEty%6X<wZv=UrU2yeQcS+#K>V_;8podwOS^B@5pl=OAW{Q(Li|rhJ)~XtO8~+}yb|
zJqToK?34Mbb+G;`igii^Q}!o=h)dybQq*pbF|d}G?ce{;S66$36vme)W?Ip|kUooP
zpDq{Qr3vXihEv9afPrf)#3M+`+Xm%F`!#p9lbMk~;@d8x!8=MQCkk~Ex*P9^xo<$Y
zD`q>qhWF1w8&!>9`?l$EyJ`7^!iIV|Uc0bH1hWH7>G!E4TbqyZaTU-hW3sWA&sYln
znF)a#2{`CwVgY=(^OvG?5D`DeAN?_5#h)YU{nqLh%PzeITMnq{w~K@$tvig5qzWMW
zE|XHhlGu%sRM5R8Z=i)OB04mYJ#(xdVS`kz2RCotI^mG5)9EhI7E3TcO`Etp)Ks}p
z9^~@x6*W!fA(d4HgPeYy#rUTuQDIJe)JVB96i672Z;KX1saYPk55mAexuHapNz19a
zPA%1)0RW7+nzHEef*-%C-Shc0%BPIGn<+v;KFz7wBb(!{i*e{Gg-TZ$ab&{tWY@j5
zl^5$&<oX7W=cgsG@}!(8L<bje@ZYC9zS8(UzfwH=-K5S_nDivwx%xF27S|$AS(jDp
zI`aiO@2v(+xVav!u8U;GWI=y|XK&%S3eND`3001lpdZUJ)id@DNzAa2${Vmwy?#y}
zg~LBnu-WGGyipy{aZtPbjSOPy9F&odt_m;>0y7qpCav8UX&UHbjZ|qT9wTGJ_2~8n
z1%%S2d&{Ao+9>0Ih#7-2BwK+Jlvp?{p_Ac>niLX~RJGkYgd1(Lz<?DoUT+v(Z7&J)
zW3Cqk-sZLF_F45De-;g|$y!~$_q*X<GnUc|opg7fTL)AqTO1u?l;81#dQ&;B*0;m{
zz3B!oiA3=P11XTlW7zfT(^_ayiV1ewujY4UBvB%y|NQv}BzeMx1N&Ti1)3%ul4>ob
zeZMENN4Kza05Nky#K{Igt_pHj`=HD|X<wi_rZ`qbOw(ly)5a#5q56)oMWz$kSP<5w
zy9_4wZcOW|RTWBa^{0wIMZE6MM_OL%LG)f}_5{A(fG@F8XKyQhMMztQq8kU)ZU;=^
zS;@ihze^`(x?D_jv*nAx7@rBAMFZmS&JyTJd8XZ1xO_khZ>VP{g~P^8&(LxNr(^!s
z&yr46xze(x87{B|htqb?dJiyShHaqX@?|7M+k6u4SXC372N6YkLvfJSo?I!Ns~D+s
zmIr*)1c<&Y_b8v*O;t3ir4gjbrFnP3)=9lyNb3z>?2dHmi1IdgO(XWcDecj#S0?wX
z2H2zPA>D{o0l$DyGkzO*)2CPhLxBZ3!B8M5{}Ftpf(`=QeFTCW?vCbAKU_HvxY#+&
z)lQbc5|moH?XZ`SrQa}}>*O7%9DN%+4jCN7rMMC=CgZ!L#5RNejAEJU>5_8iz&&2K
z%qRQko(*xHFPVz0?C|wP!MRGW?x6ZB`wr#lky-tuDi>I*8VU<vPp+?xLwj7RsJ5=8
zgdJ*ZOdTk$CS$?%c}h|TGv9TQdQDg4$5?4u0U5Y4B{Vm;N_SVOZ+POrccs%K_9Q<I
z(4rc^Q&#H+vHhckwLEsFkPklSOA}XC=NcZHA9gfRaLyVd0?}XG2Iiju6avJV_x_aC
zsaW_}0?D6|F>(myB&rB;W7@&fTiL3V9bZzp<t)jJl4>?mar904UNNz|>?Nm)5W$%&
zcR5;oDX6UC&GZLeuENmOHp|H6Iefl!@S%-0_H4}{tfh%!SSGX#Zm(7{=X8){37<{A
zO=-GZxFnU>QN(;-8v`FQngW!H@UR8$HCN}yk`U}vJSmshY+A?AzB8~8;+4GCp-RLQ
zd>N53xH(SzQ&k1CmkN=Bk5oMe9B6637>d~~i~)^jCI-7<9)5yr1QJy-i9c1Zn#b*)
z$bHPRa(U4A-^Wi8hSC9<(dCZvkDU4lw9Jv(^=Z|yqG0tdh228kReb$%)!Kks_nHEV
z1VwPM!m{k{u#<`DAKmU>lujNiJfgaod9KN|8MaMITxDIc_3WPc+Q+&0p2g-iSce`1
z@Yf3;z+6Kpz1?@#t9rM*`_C}*v$)0BC4lKAbtT>+8j$9j*_({DH^KO0yxTEp5WYg?
z4l=Esyib);(IQ}KJnzgV%3RsB@&WbV_tJiodfu&Cf9k|Gocb>qogm6Q8IdmgUZ@W!
zc9xjo`h}4=JWE2*R459k&80$?oER29l>95HyHw>y@AY~Ug)MUGYM?{W>!D}-ENPKt
zJNO+gHN%jTth4pi^{xT*UqbWKS-Jgd5juaQWieslRDH}&<HyyS=m*YT15<A-Sxu(W
z<KpwW)v$nAP0DizG14i;e3U!k+3yaY3sLck!ZFgx9@DgITg%42x}or>|E=JRDpv-P
zs&>gUqb+a1`apJ1Tj37_jOLeQ)^%yP@xAhO|B3eae_~TZr-%#N)>1+&+_>em)NSy*
zy9K!TM6^P+d$*4-1%?oYKDT33Y~&Fju!~9AU&H<{?qDhY0q5WwHg#+CO)7-xDsrno
zG#9=#j1>P6s3h&WY^;-H(KM1XMkt_7dT0e>F<5|&rO=Y*BC<`l+arG`++M!5`wGj7
zh2M@}ATE|%ag~{y<p@DIL8r8|L-WkdV#X){&)o2bMB;*)SCf2-CUoclAk=)Pi11cw
z#Ud+a`23#_qR>Ir2cI@iav@}kpynO5G8yJ3gc=Cr_ud5K+UQrq){rQGTYs3e1=*@P
znFB~U1T}nN1dVn_Rp@0uftMives&o7^8W#yhY?EDrbjiu`m2t9osAu{e*mlHVmZA&
zYvfJ$q(t<SdYEXsQ|K9c4U-P=Z7c_~q$H22jI-{vt;vK4iQ?5V%G~OTmUE`3J^WOr
zo-}mAWsT8{8N`C)n+|6wyY`_vF${4{yrloee%t!;<szgtIq5XRsDG%kF`(#S698jG
zI%zN6HkaI?ipA-w5H2_4#7GC&prwLE2g&7P?c94u=LOM(I%|l!pMgD&#4vehK5!U-
zd>z+XN8t)5cNN#9)vpwME2$&up}nSPj$w{Uv-_st-x_g0WXIOb=7<&AO&ugs)VR-w
zELMr~as0&OhB$C_VI1eIMY2G*ekpJ*pN5s6qaC6`a)kDCoNL!AcRvIiv-K?>gxWi+
z*T@^TN9L5P;LS58P{;hwYLcZyGe-9Hz@q*#`2H-oB@ZSDOgr&;`8_@|3iQXYiqyo~
zV{vD9-!#@pu*upDT%8b-di|Md#}x55<^>pWr_M?;;*Y7!k+lJL1(O9o6KssA)0T@}
zY3<~`pkC&(^iI`-<>u5AHx6Mxjj3l9;jIpJzR;%;)(uD2VYEf>y^{zym_Is@Nb^wQ
zzq$t=jbESbb3Fc8HE^x#$dSzLC|etNv*8Ca(|o(653(h$Y}2MQRkOUc4@0SvUwQJ4
zIP~?1vw{4cXn+Nk{WHz=UkINJOkGMIMnkgtJK;yx{Xss>k^^>AY*%p=s8qTSXr@;b
zX$fO=V!3a$EPcusfa8m(-+su|o=`EN7(#rBfJ0BSK>JYy85Bhvzn<TeE?;S6f3KW^
zq}*>JDN|qY`t|--Jf9+pc%S+A_FxV=X$2vNDgw+}_$U?wh{Ca5N5Hee+3Xr<`Nv59
zDG96VVc)5cGGCw?ooY_Ki(<J%;#QL{MqP>Dr^y}p<grOe%YZ>WZrldpG=kx12MXr*
zHgFP;{#m+Sq-~l)Sz!Gy-F!<Op8aoBSRrG@zb4K{9{}>pf%?n-8!_|PCi_o?e`5Jc
zdW#RD3^-R{-Oi+rIvnwDGcfGO(JLQSpjKS!F+buE(#m|>P@4l=M5F4TV7B?wQ^yiH
zhr&LAW2`##{Q-?D*d3EKC|XO72}sI~Btn)*ZDulvX#^HDBiKzbi`JTo?OWTcPdYUZ
z)o>>WdyS}u{Xvc&Xt*vxNQr=7Y{R`dIcb9YV6%?AN=xJOXe=TCI0{c!_Kh4^3OkUz
zlQ~^5lQq*W;aMMJ96Z%Ocl%H|j_$Z{^Uh)6Gv{rD0(*;~wG!VFcv0&V*Ob=<(I^g>
zW<d0#NtvE1_0XH4Rsvu``FY_Ww~p1ZRbzy|rj1|%dsD-Y(<D(<vVv_Y3w8z1K-nhi
zqk1?e0g@VXxZD8E2RJ>S-ic?hdLUF)#2mdt26bGUy_x9bE*#{7ds=1Qwaij+UoVcs
zK82_l?plH+z%UPHY`~h@$d`W_<_yof#i#(CAiK1SN%T1+Y3DxW=M$uU&%bTCEravp
z0oPukfUF8<b@#p@T|as#s`^(@1!Kk7(nsQiz8e`EZYw&=t9{QeYFs$68Ii$Qf3x?q
zEclJRdqvu^A)`6~E8caXD#N>vsU9#?OsQ4S80_;kos(#^4hfq;{6iI3S@-KZy7R|V
z_?{4^qQS+K)};lbbSTU$XC3qqbD|tM$%gywA|ld1$G6}YeGAQ24D|O?Me|Qlt<kla
zk)n(nVzoJRkPQ(5ksXiaQ1>;2TIB3VlzK$BhRd@UW?%To_ObV#IlUT0A9Fs$<`ZP-
zu5iXSnhO9C+vhJOLjR#%0XuUrTwsFG8QF_+uP+sl<JVxFzimeu94p-?e2HW>M98}q
z_a7|JC%>wyI28YcdOdOKQg0jNCKIB)u}52qRgld3$)<01jJnI-D3~bfv?q8!qFvNy
zgiwUNQ<HyK6#0n90>6WaQu(BpMif_wh{9S4#RcZJw;oARa`xr>cj>QbdZy5s&?DoJ
zgg80gkD8Ud)_hldOQP%^Xa+o9MFO{m?RfQ9N(2_{5j9nHxV-#H2dOZ$HIC^NSO<H&
zkamwe7YMfrcW`rZoX*}X?nzQZtc&hc><-9>uf1p^XEcHRh;Np#2Gs8=!$hfJ`hE;;
zgzr#MAUOy7-iqMwY~w_>|EP&}oh8kuMUT9OEoF$I=TV6lG}x{c&4IUkyVVt%_?#ZS
zB`_>CwEPo#ZM9bij0hKEJNw~MUq4LGqE0Vv#KVF)&&8xrS$>kdmzcJ<@>`UYv;zxB
z)XPaZ%%`Z{EBs_0I7c4wyp9Y-cL2DwUFTrH!FLNjy^8|aP?M5E8vH2}MOSQP);61o
zYAfI_xp>Z!_h74huANTIezX7lwFLj|&mxgP%XM{abfd9-KJiwmM<I3xR(Alpe0GJk
z<R>vr(b<?;IeK;SL~87tE~?{<2r~78AGY70p%HOvP*1S}TGNBd>7h_UF+=344`*;@
z=h#;R%rvnE0`~>BVU^{f1A|C8fj)iD+LrqREu%pYjpiD>K`$%3!*qJt8uXXKxMZ}-
z>i-VrBBDd3mh^CUn+UQq+-oA1nd)9gERn%XISN9n4x3O?g$8MJVl|Xgt0v!gZ7S*-
zI-vnGjKcOvpMQBp3a3!-cN2DwA4mnb41KU+U<B2n{A$!1czn0nr2GXe8nYnSN_$fq
zO5-Pqrol#|d^eT$^f<-SY}>Pm`3gZA=N-Zq=K*_gom>fZ2Ff?3jL8ry*3*a|Yottq
za*1r#S7SOZ`mYvyx`_(^OJ31w^0_3l$D09W#Le#(>422J|F~Nnkz)95lgo{JjlzhP
zX{d(;X=B2EgB2vkq0rV6HNnAWr4@fNSu9DZzHLf#(oV*wtC5_3!f1AK2$K;oxli`y
zQT$?zga<!UaB4sMXDC?;r}&Gx+>*CpUlsrtn!Ph<$R6j8U<(B1N9m(sG13mu)}5eg
z7u{oW(jf(zUyo3bZ@??a6EaS)?mp;f+~hnOW@R@4`Ndl#j<R&6Gy&c<9M?lDomFGB
zfzU6C+?L9h?Rn)8I080rR7YKuG%d8pg?zN4j3n3V^BD^3wOeb0+N3%%F}F+`o8wlh
zEB$_+WaX_^9)LUrP)Pa-l9s^GrzD*fcj!Tx*0a%kEwl&rSkTms+6@io!1%n**{)fg
zLdtM;P@IM;Kk81`8h=n!Yc&|QUf#8&l&3XWCRsmdV}a61OH&@(df!-y^u6OkJ1+#h
zWFw0?R)zC&Sfwf9M|=O;7>*?`+m^r{4tFv?G^LJj15ezOe3PPeH2=TY%okHP1fboC
zDhXpHDL0#(1HtV^0l2%fJVBm(D#M&_o@%_!$8wEegz$hmn{8?9jjc!O5GnLfrujXO
zg&K)?&Qu#eeRk_3q<ZU@@F89hK%>vL$8AA~qS12T;xetiq7ChePb>@bpa41^PdsnG
z53SlwS^2gyvS?CeIOz&OTM-mOFAN3NNy-D&FcAr}5{it4n$JCKNfru2hD<Xj18skq
z9Np;WM5!9XI)9!p$j!Wo-bt0~^xqoF2GDg308uYx-FgfA0gvS=r^Hf5_q54gqfFx^
zQZ72Jaf?dU(L7Wkz=%{4nvBEJr5Zro?3OvLZ*Ze+F(Ms(K2JJoR)t2!b$;^EkWa+7
z?4j&2<{DfN^gX%s?;`0UIya-<f~;z-4C~N6*zq?j<3vehoP!)b62}eVvX%MmMzK{K
z;NYxHHH96xG%6}jUpvVI6Aa=<vtZ#INUVf<-W$a5=n^jL&N%`07jC-J+6y5p1AAO*
z_=d>OTGVOeAi{QLYpzMIQ%PFN7jXRsz<<u0igaZLx<S=UY`N1=`{BOY61-(s7!)pC
zfm<Viy6|~^$=Ki(l8~xyg0Wbu)#_z;ZmP56sIkHZ_Ql#+2L9KZH<5jSqbT<sEtt)o
zAkt02n5G)iS1_Wu2%1X!@WKV<>!wb?<el;h87JxZp6TqLd|r;La(!%})yLou&-|38
zg~beo;RkNH02)`gm<s5q+$CphN1|cB75eWGUjMHQBWvL>Qv-08-MSocN<szaR;LNZ
z(mzpQy|O+Q+{c!*yU=(F3w%@Q^?WFVfObx8mI99(#N1=ozB|S<zD%Hq!U^T5(>H>&
zyJTljZqHB921X0|*sa;iMw7lFIP`gv#m6U)nInh^X2GHb%UoKwkXsz9%s=JF5Tpo{
zCu3_WEYQ#X>XncUG~y`1%MtWR0at(^z@>Z;N(p3j0=sWeenZEgw7J{zTxO3rTk&>I
z9ncyBWdc=wfHNl#H#aNGii<RjU}4+|4Hb=^CF&Ry^U(#gT?FUK>{F2))vJl9!<|{S
z`bkiG0{{*Rb6EK7$c<R{@NeT+z}Tq%Z53~v+!#{<{tFdSDY)sJA)x|yHJE!WMCQo-
zyKc)&_+Y~;lfmbpLcp5=joA9hqL>c62Ibv&r1ZI}d==&Yh<>0*p<#TMAIZ$V+$@11
zf_djzf6`U?bfb_s09j9mLf^AC<D-ea+SL+X0M!H%=Tia{aFQyW4oi05r?D9xU#B@B
zw5CU!*Vg@SCl)IcfBX9kgLbrwZ`x`?UTi_bmm48R^@-y^XfATW%@<h}%jYm^XhD$`
zs$9XN%+U(ftXHjSjV$$M0yE=nJnLuh2Hac*d3YF+HidHFC9|b^*I26TvAMICiu!{_
z%pOtI$WFX{?;|qX7|JaPB|B$;H_<WeUmt2iD}J*QIaJ~{0Wul@M5-dGq!F;Lew%3w
z{v$f{F+ZgZ(+6%89sTa@@;UqN8LQ7z;>$)UXyWa_kP`_9$BwAuQtWq=5Sc)r?n>E%
z7tXGyBlB+kJ+dP@$swZ+$OgrF?UsZ3a-x6U6J(6;VAeB@KkC8I9fM&ORca!Zh(q^E
z{1iquu~Jvu-mUOkG}NBG_?Ba03X%InxmPIA9J@dV|9uXdmgoW*DWP2LJCa~sW%H!c
zPez2LgpnlUV%zSgNc3>ChI^SE1=9aZQSlc}kvK{Q<Z4vL2@E#%pn{2+25K`0imZ7#
z=+!H2lf*tFtokhULGPoJ9G`C*I`fg9JwcFH!Wn0F4F*z4S_`D=4LzQ{k(MSf7o|z%
zl%8TWZ{naA?ZJF3(BAgV4v)R<IvvqfJ;*=Eb6^7mp;oc<%zEk>1xEBxzNf!%@Yj<B
z!FtU`&fB~^T4_yYp>jE_H4Lat+ll)T_dZ@RXY|W8Bs+&c+Gf{68mzOca4kN!l3ci5
z-oF?Is6`6i?`K#uQtI#l6sX>*;@?Jqto!Q8hb}@hdz|dzM4F4{r`z_jH;VSZxiN#u
z+ErO%sho&&E2w3vSG1Q;L{~el4u`AU%cefu2;!Enag^Md(NBHm+KD~U+hmciIBtTB
zuq5BqLWtBE9V#N7b|$73Up~yt&~Rwryk(=^mS^^2j@el$QeYCkT4qcMD{YX2iVji5
zZyTJJWzj6~+^6WAJoPASpRspJRx0TuA}#jV^R7*cIr7}=jDtc-4cdfC&(eC~I0nwl
zVSbEvR1IXjHn5sCqgD!4{^0-?gm>vfi(hSdeiXAjkt<_+l3o~;wgkC60av~hzH~^P
zOXagTQ!@16^%u?>vne5~gA>QUvI-+FrLwEhZDygl?rHdm6KGP|#OrJXHA8@G0pF#!
z-y=<B3rTm=B*?e6?8treuSwz2jGV0nIMteCoeoERhV&P;aMHiQcsbG^EVA&d@!S}j
z*B^7cHxj#U%_w=7Rr!2BjDXjYec(36RnIlxI(m_*6;15hiD2TRNIH{4^8-8oeFAza
z$M?UUdw=>1J*v4rUSsD<y%hQQUrQ||<ZR)4uX`be@v4{xGYd#_UgDhXw#=@}3!E$o
zMUqr`cAXbjKaToZ3-c*tmEkn++gk&wy4MO5KGgAbje1T^<tXXT34F!&;t?;!B}{#c
zWc3)Z^|LL$+X%tz_DZQOJ#By9#DDp_3Ve8%jxW13r`Y$|?!kFACel6OY^K5WxR;jE
zMskZOkdnjlUX+=ifCZaG9Xu3oqv@>EFwen+EmMfkJVf4!-D(k)Hk=z{?_lJcR=)&d
zMkMa15j`_b9~6}!Fycyy^Bu3aTid5nQi=1d6%;tQ93jXLvoCdf)3DPOF|!{xk%4Ha
zygDQnk_z!6kDKghr6}4<OBHM<XL_5E!;a7?glXQxpu^g-UjU`)$=3x{XRg#P-Qb;(
zOco3Y@Goj3b4zZEYJa&g=&nn73xoPOfsPeIoyg90!kR3M{T~Nhj1))woX#mS%v3;y
zG^vmd%<Ot)x@)kxbOFhQq|cQ6`Y{xFyc{4ZZ>Be(MumsLNL$?-d3*-Z9=D}<1X|Z%
zVIXdKjUuUgDV#PHgryQNL}oM~)%utH!-ilD2R*+QIFdhfHQu1@YHZ3RZ`1QAtSoHo
z30Br8YS-u}?>9{rZ6$L5f?3QImr^h<@JLO&vN<gldvqkMv2_g7)=E8^^Tk_Lm*8y{
z?jJQbh00>5mv+llv$6&Pi5ZFM!TQajh*bjs(P_w-_pjir*kjB>sYNBuP+U}un)4(C
z)3@~NT8ZnfS&113*O4MFm*xmb&Zj|eDIlYi5WU2xr-EbT%jj1?9Z{18lfa61+6}e;
z2#@+UCsNxyA6t6rYK3rE=FaF~aF=QgziZ<+0Rr~sZO6DG;IIIgcaL<DY&VZr`=-Jm
zuUXv3ppTSjpLFOUtwN+WC2UGoGi?c{>jnR+cM)5)nqGD6w4i3XfTF7_nm9cUtzieT
z%|w)droXSzC*pZetAHCR_an$7_}yBu5{r`0@yNM-iOBsl&j0g?_6!xXZ**%!bkfAF
zgE#Q1OJ#1}(JQ7_WLu?}p0Q@eK=L;JFaJH)_;h05ag3L$Oe$cb&U=L*$d%Q0v9f>N
z$cQ{CTGJpxccu72Ue~>vGO+>q;dBHYMU8AD@GI+zx>;TI;Q1LC5uCrNGp&6xTA~AY
zJ382M&zjOD92`@q<wPsbjXN{PyJ-r#@*a2+fOCvT!GWNt$V?d*vzdFh>|2#h=^&tU
zx3VVzyS2}0`5GTFtT+4+X62z)sW)0vEf<&|s{nYBKXgmu-*JJBsy_H~G^SjuF!ipr
zD2|o{bPrY-`&c8qyHWtv;)L7$@F{0-ih;&fav(oj=PWL;GgVfwDKtbI&uLTU&iiG`
z)zd{Ytc=;)O_zM_O1o2uHf{n~#OQd9g0~1Y!K4ZLsX*{};mBEE1^@<wQ-8w5HQ}m#
zI1JkJn(K#PZ!Z?;*6Nq8{_iVB4u{=yA<OCQf%r+!j1}4@;j$<zvmehPYQ-vU#FL-;
zFH0GYbs6Eqzmig6MQCS;6xI=aXrJxfj`A_iLu8otJ1DkD$Tv8erdhpw{`;;^w_@J*
zVp=w^Mn!xnFVX%vHMjTA7Hd9tYvu`Hr+u8o1`1bHpaW8{HAD|(6;&fwEs_RWRVIJ9
zRI1-&gG#;E{$hfhcI>wpBJ}C8phI?ZKv7w|-8KmKZ1i3H+OLh`IIJ3+nRtxf&(9b<
zzs*u_zF~R4Ebbl6x3VJ+p(~e+4(;}V)I)NMb_NIA8ukYJDcy1=D&Ow&!uK`Y5E!ve
zw2UtSPssC%;7*2$D1S0O^Fz)5XL}V!+#z_0Bt5r&qU|gXeiJFEMt9>SbETyYkaFxe
zn-SYED~7h7^XmsdW!WJ35VF5#Efu%4BpKZv-^pu0&R=Lov-%bm{|@c!O{xndvryqj
z^=M2xP9A>w^P9iacF#?EW)@}CQBQhWBH)a}h&^7Huv)pNL&FH>;}A9{1aL)dyzK(K
zl49N$wfUJX-Tix`&o)Z3L@4NjiPZn67E%CRgyAzNKoJ)%dag5uL2xBhXMo9Sl58qS
z5OywEwM;6>C)26HSk52sS*i#DBCAL8xqp&6e(FUK2n`&_l2BixJJyPw*1a12S2f;8
zB;7V?TMcGaL1y<?z!Yp5I?A@!p!&ke1nrw(4`j3{+Gqa36;U=qXh+#VyK({~IlhCn
z4fp4;Xm7$-ybNIdYJN|Q$_H&|EkYnMb!dtAA>&oV7v12dy{VlcCUBJ)NzB*21#IQ|
z4<Dqq(l#<2%*{C>hzI**1LWS6nsPE(<uRH2w6-7G7jvhA>SfnuT;nKByH0KgLH=wt
z?@%Ze5&e`_2qCLd?ljss^0YvJ?O8W$xt#?{{y~M830>gI6F%au0^DZQiuUd9`QY(b
z4>+NR<}O+PBJPiru&p=!u9r-F0`$XJ&yFSes^8&ACcaKZK-tk5q<BO=kd5P)H!m~F
zl*n=ZYwo1_;Gx%-6pF~@OdTrTlqwk?#SIFB&P;f}cFsgMVj+YDkr^$SiLo-2LXZWA
zxX3wOL|Q(np$aE@=M$66H1Z=e(yF?)U*1>YiaTbYl-l&Oh6tG3EP|qsCz1uV5X8)j
zIwZz^JkM7*)zGv2L#4j?4D$uy-PVS`5O2OMWM*`v#cHy<=-S?k?jQyFhdjLjz~%JQ
zMTpE0xR{&qj3M-Ja~Zc{gQN>=G0yYhxrvUh7an1;P1lzH9Eo5lrF-3T-nfNN@-Dx~
z9W$46<SH1jM*?5O!Z%Tg_e*C`o)_xByS(<Hp`Wd{Fk$^(b|;s>`mqDLka(YfoaOxi
zThp2Dx1h9u@9#fBXKjr3#Tf$yc=?^7!VwkHR&5~+YK*|p$s)Y-&=jSNi-L2LTyenn
z*H?5%SY*qlH4JW;6Hr1Dc!pt~K=X3KYP3+|$1WBeFdeIrOj=aFkEyyOjlmrAW|sdF
zX+f@^vz)HVV<(WLK)o&>`E$Zran|Yih)28RG~`I*{X7xMWiSeyF89Vcme113Sq|8S
zugy^1DRY!C^B9|;Le0vSN&6BtO<2Rlc!WF3GqK?a>Z-!m7*FM|@Xv?KUs?%Xwbs+3
zD2UElt4?V)1BP13nshy&crbj6a$KUQXjV>(RHhB+j6n>h9QYRc>H__H&PU?QwNHv@
zu@&%$l?|oM%>ak9OmrDR5yVx@A!CPRWK`5|`5-ajF;kv(R=IuS%P14CBTbSFiaxoy
z13$NaYZ{b9)<u)W^S+fy{wpecHC@HbHCr1kV?P9$@3`+7P*3=PfiswtN$h40o{N59
z!qFc_7n+ikf%FIbNC)d-c#F0BOp;KYe5u~WL5b;RSvm$X=Ea{WU4LE0`iaUL`LZAV
z@wx6S*!h^!ACQ4IKs!?S)jl=Yo_P8GF7AV#0pCb4%Zg?7$5IDBIFGo;pJmu(y6scl
zpsvV|Pn}^3x|=|to5l46v8Ooj&O(T8!h1f;K<@LDymhcB%A`OOjwgzHF{&v`*e6td
z7d0j|tTt8^u$v6*bL^<V390X@M$NX(ow!HObBuY^mIRU%Pf-|tYVCv0gWcgGCgR68
zB;><vW^zV<bJ-#(B9|3R-{#nyw_r4ke+bh&I0HX2Ypq3fQM+P6iC`0Fkw@NCm}gW$
zV@qTG0#VW5C>XrISh7$=EnT=lIS}g8?ypQkZo-<9uKDZYPjdS`q9#1AfGj4;X7A((
zV?!DA<d7hKf6Tk^1C0CNwjzz~4z8W)is-P%VK`&&s-Sl%FrJbwXv^=Gv1HVIh5ndo
zzVXW~-8wJ~DN{X-dD$99FLGf&nAmQW(mQfSr+Iizo`#rN0MPLArXRdMn|M#;r+Ha9
z)>IGu6zc3~wzh*jSkdA6F|H8{l?tpV_?POLTL0r(ga`oI@d~wXFmeNt@j+LPqA!Hx
zxUt^zr-O_K6yEZm*$EBduKZ>WbFUX~q^7$oYyzEK?cckCq51ypiFU;~`%Q?Hm&{m=
z51DgddBeLDI?}I^PbOTLljgSdFOb_)0hmj9PA_Q5(0fuFOx|SC1BdaoFC}5&3;F@g
z?P0f_ZXof9%!f{oUlm!pXN&163b#r<Q$2MFr4WB<9u4u5QO);eGncn|A9fT;M;-;o
zV``gUTosGMP&${gnNu@!npm&N7svW^$@TG^FS}6EQfUC(qOp8o^3~M5c2?1P%WRiz
zMFmoCrBXC!Ylj`Ou|-l|AN%J9YUj4o^?3yZAce**Gd?oCHHr}nv7d-)0ox8u96u=&
z2LS6C7rw7Fjnb2OD@DT#t>i=)+>Ypl_$Bvtq#2;@j`hC}b4SR_TCl#r-r3z6$Ggxq
zL728Ql26e-nwm_s0CWnh8?qyO4d4Je-<J)V_`Z_fo-88I8uEY^glCjQh)#Yx#GpAY
zE@t$Tcq3%IkN@DmTZa#)6j`HTHR)jQwoh!td7I1vJ~Zi#<xb)@5y~^@A=Fx)Yd^9Q
zV2r;HTH$4{l}{8TK+vY}{vVq5Qw+lM#;~Zs{%gGx_gpgu#PPXE6u0Vo0hF~w23~;*
z#-BDMG|z=4U;V`$ec8NTsAS(~+EuxM2Y@(h)lNs1Pb&~0)Q@e&+kPo+g-1A?D1_tZ
z)vffl2pPJ27@$pDWZP=j`kE-djeOb4s=rxvXv@o=dbZrZ0{IIZ`xso$M~>b<CrJFi
zacf3v8_D?vRcb5=Z2V!6Gn{yE&dKQZctht!>oL%_<iCJ%+~Noq|0qR5*m9>0(A!*E
zBu(kBVZZC+^LoJ)J+ey_*pZ)Mxfjgz>()DYMu`TlVpBQ$om)7LS&;+TRcKs*)?I94
zyww-98CV_+GWTA!cDIT4Z2^)dz6?x()Pr2i;G%Z$n<iRa<@eHkrWek>13&S*H~Agf
zF{HA3l=)rm%g(@<rWfUmgsmMACUcYSC671&US!Z>0C#(1pevX{0s^veZ;%DKq^k}E
zI65N}K%bpGyN4VB``d#IO9P@4k{SHfV@GLi3MN3^R7!sR76!V3nNl*1SIPD_LrVJw
z1kyT+S}jC6g?nwzY_X|a;n;D$vO?gYd!dpKiU>=b(O*{kJEZYUUy#JP>5}|x&<0@Q
zxNF?`^J?V2SZD;4Qzt8&BaItdj>`3xRtGj+<%IRy5fc(jo)QB<>d@8@+#ZiBMY#<x
zsrvNW-Jqp-7_;)QO>>J@!s_OP?9H(G2)$>Zo41|tT(3Fk@(!kcE%X~tr6hO0-<M?9
zB>^o6_?8FoUHtW4UDDv?<V&g+rU!whSvID<hudB$H4q6s58N|lrjwCJz(q#m>x>>&
zmmH7chQvD@Lo#bqHsal26nw<!5sYynu@-TPwsj>T)yKQ<uB}wS%+lLC?<XA^#4g1y
z%9hBrUaF$-sDfGdN>B-z7u)Y6dOXsyXy1&8zSbqADs${*uvqyN*0DJumS492mr@E0
z&WC%>fc`%szHFBS-FzZYuTEq|clihiI9KZaNHaAzhI~7d20e3-wIl0a6qYKgBEzH-
zl@w;%ili*Q+>olV@Y9M?MQUi?%a!8OalQ{Cn_G7P_jZF8@Au^nCnH9|FRjDraPYe%
zUr&td!Y7r==r&SiE(4(3zMJRF;Pq+c$thj>YtV=??ori2U^M;mhCVH&dX&kHbT-(g
zoPxM}77UJ_(^$?^&szs7f(b1Rr)Iz}PVVHSY#Kt*mwGV?qEv;s0BD>_$-_C0o3q(5
zHj3y8LE>A-c`M{|!4I9M@khORxOwDIrt%?9dmV$bES>?J9Ro~0u2DsGcYd`Co(x{2
zrwBkp*3uqQ%UpO~ge9?*QmXkbP^r^!QJ6N#F!K<;35GqijGb3If<J4FHfaeBRe*&R
z`IL#zws!CtpC)KI$D9)sfzSmuzwlm$6`q@|a>|EJig{t>hxYb3XaCSGs3f~mq$%_A
z9iG%=diz6OZ*aEcXCwwyaSAOd{|-CE1y}RxXqT5uC=zqni3^J^td_pO$`l#{Ip<?~
z%^<UHt*_emU)z!@(PB}8t{%Vsr9hPm#NecVHf#li-(H&{G!x8TMhix@ipBs0U*6-|
z!3)Tm<etA6{XbX^5Ww6KG^}o4zHPe4+qL9Q&*8M23`40v!}f#t4GU#?D?wea<(h}W
zQ)tNgh0DQHgA~SbQ=p?Y8$P={Oh2_GU)H1chrr5{j!V(J`J0m#&mx&Qw%U7nymcFS
zX;%sM%!v;7IaE#tr=+fqy#uXPBlQV#&LUX<6bqv*Zk@$RfkN1=p$94R40YWKZw@e0
z<XK<W4%p>%2*(^zBM&&TYfmGu2KW>V9+C#SKdkFPswAOMetc5)+IvZfWCvat^fQqm
zy}z!Vt%Gv4WicM{{bAkEp*T7LS1Yf~BWt(a)zc*TND7HpcKY+8RWLhS64>IBO*ttT
zP;#s_3mgKc``>Fnl9!$uYU8@QS*)_rENVd|Cy6sBfr{YX!Nsphza%DJjwxmd8aEW7
zZLY!kL<ilg_*`RDk%_BYk8C~CrY;;f$<owA+W9iFXJGEE>LS&WKl^c>3O=)Z>*Z?9
zz%*|^KyU;qL{x|~vk}rKCTS-9-xsA8MGoh|`YyvBTN>*)VxiUQNN&8Ne;lI`fvfXE
zntvwb<pwh&dYg1ZF?oBcPHl0zfZynKF@Z7a@c2i#5F>;wS=%wE-LCaBlYWM_gfG+H
zp02V-!)hTr^`qYYk$6#ar38V_#p91+k1ZevtaF1Mqi$*>M$srrV7xHPL~#Y1xzXsC
zY-lQ1I-Nc9k-eiKN}cMAo-E-~SlBlQcWylYuXztps8N-sLK&o$&|ztU?7iSPdQuX9
zy6Y@%h6E>L=IhN0wLXtS3ZMiW5IWuhFN0s&KwY`**9uKwqO_n5<dZhH;0LgwY3rQp
zCCQpY>D~NfJ0<n!?o!DM9;cHR_Z(4m7HQ2GQ+~yfKxRIj3yN<mR@E8sDN6Go#50Nd
z{mgoY4W3w1u84xS>F0bB9??Vs&XE6-vS<s^g7?$p9vigSe_n)kJa^bRM%llEihCIE
z$H;YGXm2{$L2+6WjeoA_XYz|X+9nJs!Y}w-W^M+$iWX=nb~;aKb%VGQU1MztR1v##
zqF4n;fO<yc?QAr@(a8c-L)^V~=qyLPnU#%!=~R$sjT>w|b6b@waJOM(9mdADnCdB?
z>ST1vnp|?ypWcn5V3(D%u4<iQ6#ZoTEWtdI_nlCLVFmY!_xJKK+6m4XG;uVc$6*;M
za+BHaefWh_@`p(=c=sYl*TibCj8ZP@N|CWoFG^FTbqfVOQ*4@;?~%}x4iyi8o%vJR
z2%b*jt&teUbG4JgcrAbN+kW3-!Q8%lLo@%I6A=9rJ2`=xI>Ry%3yJA}B5;OzWP>H{
z?3(N=y<(vd!3&%C@!AbTUaHvl>B}Q_pKXX-K~3{Cwcg2n$GHXov=ts{PWO(1if?I3
zba9f+NKh>At1!{Ioh^?%fZ#j;6}~~|h-Qljf`#lx8<b1&2x5V(x7Z!NImK(%47(7a
zjbLqW>vA7!74<6fl(*MuFs*sii?WX2Vj103Dc_w%?vSftz~N_x$lBf-%gjmV<$|U{
z<4uj3uYMR$m{^WH3w6<=(w!6zHrvL@$arLU4M_i?e6-<ySjJpP6+y&c(Or`YYLF~N
zs>r1UYbkY2Cb+5K(iJsDO+V%^Zz=K+_<B`F0?AuB+ibC*pLl(7!DPRu&+dWa+7_sF
zR`Y96P&Zu1d_2(#-Huu%fmadbVN+H&y+3yOEuC*(#&7AKTt}lO_81igZk~<;aIP&f
zvsY8)M>2DA^?qM;l0ESILVHvs6gW*=JeKm0W$IeO6c{J>3Qs@RimZv;*qh$1K3LYY
z4|l026;~viccjOckJ1jzoV6Yq-Y&{TgZjrnJR@BAk=MK;P+z#Huf#U^97}u=&*ou3
zs8M1$xTWtE#1x8eYUn9xLb%#n*NP;oP<|Aqrvv(~vJ!}T2BQ_x4?w7LtQO>~y3H1A
zs>h`&C!Ow$Xfv+>yo>G6SlZf4A#ZfdJ(`9nU(gv?rzMV*31y*Rp7P_)uKnmEW*(aj
za6iM3IXr9%<fJUbSFIq0ZOk+?$*ox+D(e_}PiK=yWd#}CqJ>y;ULN(+WOCvfQJb^g
z-xA9l&CQ#xbCyT6w4P1B`sn65ot=)6&|9%&{!vuu#{lzZlYvYE=vYLpi8+0}Drv0@
z_)J<+JTqHCN>W1ZpzjM%M)ia~Et>p7p;pn)&I6*boqHl9Hs2xXM+o?r(!_qiyqGv}
zXYs8bpc@j;TQg$(ai~qSoNv`0l3Qs_a7Mh2koR*8OmTVngu<meKUUX$L+gOPp0OLM
zOHc95_oZL__?S!#(=GfHT$Uu9X7VWuX4g#Ry@NhQ%%Jx5o($kQG}r+`v%bXzI~nXr
zAA;~Ya$la)4-sywb-Rq)ez^wGo!nyxM0d$egYBhH6S6WoB3WoB5Ak<G%Qa6>)+;$W
z(?)nrA>bcySevoM9H~YI^!BuMIwCCoH!6TE-}i>E^tME3aAel&Q5z&6E9>Bc5IQ)S
z*;pt`DYn`*GHDi`jWfidk04sIQ|cr)3JRp^OhH!$3`~rKk;kyv-E2J51+YJ}Q`_9k
zC)81-sc>^up?$eSb2ic!O<En<!X{lDn*5HzSklFOZ(lRrR`A0NPo-|b7vwk%hsQ+B
z*C-315b4>Lnr|ZFI?>MxYkT!#o9>eVm&oMtWovnO1NUPC@d_bbxTJeruYQS^1W@kr
zGO@(XFNs%@Cvgvk!&ZM5Owo|8wX!&RF8QDDn2(|YR=x9A^BgjkFUjgxWI>`Ee)LJb
zobyB&6ace44>B93`Q(XJgrruxr@-OE*5hbzFp83#lt@O`=zPle_rLW6ovi+G)Ed<F
zDwKrj6XL_g2?Md0>9YV5JfgRXBHds?Z-9CXL&0--7kbsX10S<x?eG}m5KR&=N@l!H
z_z~L(d?8$GFZ6Ra0=Nugs9oTAg{(TC3ngG(_TD|~+=2j57p_$cr7kB?n{=RzV!yM&
zr{QSsCFlPmzm&9-w6FimbGtYkt&85gyhH4Attk(FvsozVUK*&Xy*AdKAFqvWfr1)f
z?2NO#77t0{<!vB)9%>7QfXA={<<_F@cknh6)Q$(wUMC|POzJgN3}bt!IGsZ7=vnwR
zu=3@$zEx;UstuhHNfZ@v2qiq@rO3JfLgMtU&Y{4*Y)gI2l^*{?IihoHw%&w49|-B`
zs0FKcZJ_y~?T-f_M(!`vgYcn-+cp&(8{nI8Gn}wmcXH6U-R8f5;Vy_<PNm#<%H{|*
z;{qx4JV#XB_KH%td!GR3^~8l*3{^FDBnk>MMA^FV>~#?&whp<0B{96W!@K)+Ev2I%
zg;m9;abEdok`_5rbY~BHBZpEvzs5l_jBQmhOQh=*sfr`V#R-#y!cMzhpWbsb4hFA{
zxIF!&=v!bPAtAE#9H)Qu*hMWe-vXm`XHeoF#fL8DCNK%I5!5kdA^^Ie3f9m5`(R}E
zuVR6^xAvvT{(!ROq^A|OBg#1~HFAGk*2*jToUblulz%6q75eRs6V3AL!Bo2N7`)3Y
zh5(A}+9~Wmobg&aPWE|w=Fs(;<dJB;;#H7dy?Mp4P@|e7s$c3t;}xf!JQicFGnfEJ
zK)AnEciZ9OOypftIPQum=H*>yL{HbwgnE2npTx>8#3(o$lm=2KleJ^D5+DrrFw?jt
z$sg$$U4q{!2|>ed%$W6B#J7ZheVoZ1io>Zs4bt`1DvwIHZ>cer)j*J}fr+}l-d*b8
zdpwQDT#=ZSJW*cSifvnnW^k)OYb$>|gb7{FB}J&x(wia9gYbn<<W&6Kvpfz6r@rZv
z9)}UOEa52b(09TwYwwI%IX2CNETpCR*$oDyg9KqB6s3SZZa>nsNa8?+Q);2Nx}gYl
zS(I1THVIk$w6b@82X>y?AmIj0R7UZYg!~#lCa~$JY`GkSx~WVJPyISl^@`KcB_jKV
zWtogN4S{c<Bct?wDm@u$>i^osi#(1(hVY`4e~ZBUV49l*u9f+Q#qf3)5ndFn1IXN%
ze&Tj90tvYpRxPSGboUK&Cb=M|UmJc>YB5=K8O!&c9Ml*vQbn?oBaae^Y_J;NIFgq%
z#6T-q2~X=q?$*up;LD}1hGYXZx~h*@b$5ulQV1F~%CtdLPZ0JcQfM?>i-^wMp+3Z)
zt!_x1k}hfFRtBKst>;m8-wLnw;~Y4hvn?JlbuA8s|N11_<x0t{_nio5K2qP-FA@8<
zNsXmt$`71<GLy&1{ek}vG;Ka@>vcYJcOPKR>>=C-8~vT1$Q_4+bpI=1ywShjxg=w#
z0Y}#+<-aS<ySRYW$ow!Mw)$syRQTVpO37cpuf$3!%sK|8^_Wd9S|0W%wjw^MQ20Hb
zRMb4_w?^NykcM|M;^Jd~Blh3yaV*T=t-9pJC?*hFX9Q$R&NBwyJz&s#46cMe)j(8r
z1jmv`2kJ(9W?I}=RPvV<Y1a8kXasn5_j3{fu<+RkgM@KQP%vuv?;HK-+98*?-~tf-
zI86_e*r3YxochM*dwzxrmiFS&GslCeGa1w^lqbk;Wn4-CF^LD<)B@idS&7oP@*#rm
za*dljqE(SmA>-?g{e&(!+*voU^CweGBQ{cDI%L<zBV~E-n%jK-{L5*U@)u;zj5&&y
z`l9n_DPvntB5xJW!1P6i`k;$nTV1a1Y58_JR>F1(7jV%CEUjlkbHHp1K%=UYy2X)7
zxpXdQcvapc)Abv37;crtDU@pf7{(Z=&*?h8dcJzDwYk9t*RrrFf}dZHMaI^@Q3WMX
zzyZfoaXXBStI~XTQYS<RaQtu~vK%*G^NgrgU5-G9d6117!+*i+0z5&n5*Ma)1FUeL
zm*$T{ChK->179`SZ-KtD#X_Bra3SYTC_4zf>zwr=aqmV}6^k1LEa2o}dCs&Mi6uih
z1kk>SZ<eW6tWw<g>4Ro^o*{JUSp)%Z6w-sBVQu%7mPn0k0wZm@8!TcU;JO%kAjZkK
zzA!PLn6oNr!OY!I12K?9dG^1Q2DxGJ^OyG}s0QJ-+2`q`Hj|8&u!p^F5CZe^=48FP
za_I2$vTz>fWG2|XvF><LsK3-t!#JclL{44aFHOiI#cS!{_`VZ)Y?4qX)N=<Y{66!c
zRV2LI*O160Bmb3-|BKxy-hCAMQlPo9+(gRvVJ$>Is4k1U!|1&;VCp6oz%HY8OW06E
zB{kAo!xoeXrT=7ZUnOHKZhO7}k&`K4Sf|ah7cj++J}10jGwu*}E6EUMQ?T;wZ$XO!
zL3lf&UK;;txVQKKAkT8EpwWdcg+KR3Gq%;~%jW3JmHc!GB!<l8`j3|$Wes1GPebSE
zx-sMcvubOe#{wNH&Pazq8jaYvoE(N@uEls(0{CDjZn#OFX#6x?g(JYB#C5<vsmyuz
zL^FWgH>?}%H+4II%4Tbs${gsy51Z=89s<3l8N*tO?eo7imo^GJ$#y}{F!x_GZd=L>
zWscH37f{cIp~I8Mau04>N`5VkE+oW|9FyG*?jy8tRs~W*<oEpFzVA1-*5ck%I0L0K
zx18?pN3M0csOGLYa7kw~3C#4<M}4TSj5{fz;#^Sjaj$P*MYF_i3^e2cM(kO4quC&C
z$cq&htQ8A6U~I7rpZ6tU+gk9bYDlz`<?Ys}2dJk`?4IIIwykYStz*8GbFV`qELQhd
z_svrt=>spp<<tFw^%pQMx(2bwfov=!^gFIV?B`fWXQR*LGd=WYK5_taai?oo9{L^r
zEgetWav=*MFOlftxx+UO>rZd2_h8?XECE7dO|Z5w!&=Tl{<%>EKyHtcNmh|`H|w?!
zVxm<COQ)z7pdKqK?3tgeWh%OrETbK(;+YK>JYGCD{Ws~d2{|gD#oxANdWZK+62KBJ
zC8!Un3c$cEm!i{LxWq1_M$e2wpcXQpE-^+pcka2ucCUSd6HELi(ytDh7=V2pAuBbS
zuSB?HdO%MfEV;9pXEu`iZ{cVhlY_6)&E#ywFm`Rm(Og=q4HIOB&u%X%cs<PWMKgUD
zU}_;@d7C)vZm^%}HS#9>{z!IN4^E<I$EDfCyPK*YEv4Fq8+m#G*B%QK?1u7Or53+Q
zZA^v2SNcXtpRf!j#KShR{iI=WY@z=pCA71y^nH+I+0v4YcPVIStqyqM@pd*mM56Ms
z`|oV<?*Pm!fwwzgf&v|=xppjjaN`MC3=s(55))=&OrNPXZbdG|*Wr{+I&(|L8zneE
zbRq~sqq2rU0PJJcm9@Pvnsz^6jwzswJf_+kn3j3eY<*Hxj%}z0yVRFKVkWYr-^_?Z
z59P7{F@SJTTXXpjuPEK@ZRdkD!QVL&*?qQnd98LTE7%%>a@kNqq%o}ES^B7xJ=biC
z2YnCf#hbhhL4oCzq>59Iqi<#Su*B+j;CeR1Kgv8j$~0s#)^+1RiXZUJ%Uecm9!b1`
z&hI*L4R#NmM3Q2m+nu0ydfKxbxr*tH(A(gF?z&m3(9Zh}X$xhxz<Jdme|g6EgSnU;
zL+hMI5$B>h!o6e)mjMERW>9X8V(VianYc0}n47bA1}L~@_@SK!HL>#_UM8ubcSr(@
z4{w;agDoa550xy^;5#I`I}9H(HpBht(C4!)MIO#CekRMgICzOgr|V&N2H4i}T25dx
z&tEFVYto|nIGx1mGTo;zj({mY{Cl6<k`Z%kmqE7khsfVepm8Ik#3x^lLw<Ry!&O}e
zXj#qce;<CaCj>ljxzA!LaER6z+hEXF6)dp2mOo-d9gWbsUife{KGK*#d{w8>p$qxG
z!sh2Gp3^bt9jB?9a_Fyp&z<&s4OzkJYFYdPM?HY<O=GR_puwlKnxUP2pID)P*%f0d
zfx;Wm6WB595(Kj+hZ^IkI~gB(eZu9@BlIHBm`6NhT{<Q@%xPk}ww}f#(8mwT3|mQ$
zr)zJ3wa<L$OgrwM{5N}k6eVXd?f%PTL7$@5elYH1s!{hrHZ&X%(wnfk6m|zv8z<3$
zY|6KyP~%;9J7TBk-zbCojHdeY;3bp5cv9S=KjXOx!XABxBHS^koP+nB@D+QsY5U-i
zTou2&svIdVtaiJ@GEW1A9&->LB1oSB3aM`7#cm~a7S-b*jvRdG3d!e;2(3iCc^D>e
z4$NY<{-j){#A4G69zOl7MARV6N{S>g%uH)yJD$>N^@63{ZVV8YFkJ)z)vR&Wd)&vB
z2G}4hN|EK9QTJv72tsi#rM0kbh7}Ted7%X;{AtY}RAJo%s05(7S*`V}^m<oHt2N{{
z9&t(C+2Y&dpDC<72pFaf3#f<g3vJUsRW$}eTM~|Gjw<!vyLwuSNW;LqmS7k2<<47+
z;n`E<AV2#!lJE^3P_7J#*e3ulVnHX|)OJB7Bce`xANA3VeeZW4>bYHt|Kip+Hcu^9
zc8{|FbhCk_3O*)8Zw39v8ae*#kNe6DD*{SBC)Ww>;Y(2W-<-m#X0&uHPwJp&g05T!
z`#DE*QJ<|p%91Z_K?sKnHv&Zsn{->y$8Ir|p#xKM568#Pe5~jlb>>4qJOL2{N>>lY
z2?$L(HWwnTBzqvtM|4itZzC+2rIEAE+dQYsKJm3v2bPY2_8_VsO09=*`#wLl=nAlQ
z3cZ8gCh!>YAkuA^q^gfGI2jO|X|NC0Vuq%vAw*-12E;v=c0v9l>F4-sms|`yvCV%5
z@AS$UtD2R-optAw^$q+|@O3Mb1P_}~tUMm{o-4vrh8fe?F%WJ<-3_zmghVZS*qG&B
zEpmQVWI)+AVaqz;98h2=Ge#aJ_V@n0VRMMvbSf*4YBasU@E3O})G8m1F*SLP_PV81
z3*`VVPxYL0#qdzhIfY}dy-<_q(v==OBBpU;MyYIb{z?c=d2dvyn$xpx2q_#^S6Zmv
zbOx}#8UE9Fzx5!PWuLXy@0x}m`E!^u=}RM$zMWi&FzZnl>k79_uZj^AyQ9B!7maKE
zyL;H>qO^K=gy*&%eaw7fXG?5t5*Tl{Zeg|bAioyz+dOZbV)MPCRb#;GDX2fh^le)i
zl&3!k06MjKL!#h9Nu!f<y@V3NaqXV_>?<26>L0{g%@E0_R0<O74%OE`9=)@-IZ0{<
zt0^(b!f)6nzDH)AQIrXCV+8<q=gtlSU3$vHC2uUh05X+t=|Tv0K7jrB_7|Cv$?8~1
zhsy@q9?tFGy|zmf%x;Q^dCdM|79L*Xsmw{}kW7+uK<#=&Rd5s-B$43~yqk#_Hb8-!
z{3){{^<D~ZQKLSr<n8*a&#w>Wl=6NYB%+vGD$6T!YecVVF(x{+Jlyw$J!e2SlcLm|
zv)C}Cr;tZ>Yv|34`TEY7$iaZJ1FGF~;)*R})y}}^kFT*LeAPg*w`5rX$6l<3Txrej
zh+PulkTij*Ya>yyZrixA!RX)y5k2x^ncFUxg$j{UwY=yqHQP6nwVQDxmapR=a0n^n
zBIX3N5>AnyE>f~+`-`n~hZdMjb>_DPC3RD&pGd8*zn8TyrV{{fU-a0XsFQ}_+QSzC
zk7DQcmYnJijBTV4n9I&2(PZrk>_)r&hs+RF2i7xkp);8Te-<8k?A?6mA{!=N(9D*<
z6~4r<Xlg!5&)%2V`L+0Qr>rFWc&pB_Uu`Q$M~q3^6}6&A8;0+y%c;H9%+BB1{lw!p
z=qwX#mwc(B2&RTLUimeny$;Am!V~L>GK7)7VhE@4(jX$!9BN=#f<1VXTog+!=D9KZ
z%jY@_OEqTLV>^R&tUlB0{^u(^7+nK?e2w(BL*;s_Q53YrvC2`@_Dh7_JU_rb0t@j2
zJ^uct=jjVUd(d@LdGa?ee&z<@wR0}2C(3`@SlajbCS<U)v4R9rZ|Q41GGt?mavtw3
z9L!XkHHY(AqmRew&oIAL>1#PrB=i!^MMH@?zU1wE_}oe5+z|$5jx}|!zE3aD4pI<7
zh3QRJy>y<tnVZRNpMfa|7Fth5C#Ft)W2hiFIE~jny$XiECbx0O??G?Nj;fs3>8V->
zE&Ls!6Ed*jW&C~>*0L+yqc=lKx6Y<jhJ2?56LpEf2tYKITc9{jO(vE|&AL#To$^zZ
zTML*7?83coG?m^l1!<)FAT9Er(`L()ymKjoR-d=!{0a*gn9B_2ivCUMNw^{9Qt)*j
zpgb>;9KWDsaXik52KP-v1=OSDQl=jAv11-m#{hNu+&$NN77YKn8=Xl<y8~w`#F}4V
z#Pr<giyl&Ub^+Pw|FuRhS{AUWKw{-%G0q<Jh(Prb$b$@BqlXJ_+qge;&GC{kk6w{K
z<T9l{BOK_=;8(E<f49F)5ouNfSOV;jo+oD-?Cn_MxBO&Nv5L<=I%O3JTztlnZ}nVz
z_L_4E&PforPkM+H=%cNl)@?N|Z!}0CS}!>@W1A`&rZn($GL#Ov%Z$*W6qAL<%NJYQ
zJe90)W;K)|4A<#iXt-b4n0J_WtW+V%ig-?iy7-wJ?7+d>T9n&r^+;n{Pbiam<a`W3
z7yeCfkfbtgPSBnVU+W?zG#K7HG3tTer5!0b91d^>z+nuM@Qz8=(jE*(w7qW`Spo|x
zehZT02mVP41ZYSmO%Pv)g0#jw(a3y_9S7F|3jwrXGx5a*taK5|t+{cFM64vg3tH%M
zE``Iu|E@q6g5kHY%<{GG+E?4~tYwl49OEW5Q5K^9H$9*uP;;2KTfF{l(sCfa`TWdn
z@|hZYs>{cCP4PbUD2lw=-u7>SaJzT7uqtJE(r5fWV9PD4%Sd?fv&2sKm-E75%r|Ur
z*OZ*+JFLq+-1+@7(*ky@bG3`UIzlk0E59Em(1iY(Lh;6&yKZCJ<)LGed8<B!C?Y{x
z549o<bUSB@<bDWMDyEvhJ6&QNs<U&{@>-VuU04^)Ye22^Ws&%VwLPuzto6ZPVT8V$
zkCc3)G{$<|8tAu0oKQa#*v5dp5NTG8e2hFqr9&*ieuD)$mQJ84z1{KCySmDzyZGDa
zv%aZ4Q#~e}a<ssF*X(c0XM`;lPoMG6dPJl9nrDs>(fc}_CmM8gJZ(%U@VoF~HW<2(
zWKv+IjZ2w4oU|%QnvT0b)kBl8Y>)bw)W}wrpJ<QLi%>CFZ^)D9qjO|H7wvxUK;i`|
z?{dDJp$H5lpP7;%)lr`_FpM_$iw?h-1oy#}23Hp0OoJo_Mq*qd;&bMi1_Fsbc-Lp7
zsdz0`q*k%Ux(~NxF()2wvfpQ6f+Cq}!Onutc+DBnd!oY>Gwj3!G2MT<iQb`hQuyY+
zuwkXE;+$0_BQZb_*51vG<qglZ)9$irQV)gjZ^#LMj^34eiYmv!#}J(v<2Dn$nzOaT
zMd<n3RGIyOe~X^|3jSpumgvl!Zbl>K+%X_7Y~1D4n)>S`*>z#_&S6E@W80d^b}jrY
z7vS6N50v#g;GWk(%>YAOCM7w0FQH9+&lQvH?uq^~NO*QZBX`y+3$GZ?G{y`H^~*jh
z87P_W^B41v{)m<*m*L+dhA?%ikQiqJFMLa^J&m{iqxh-#+hNp<y5B$j|63EcPfCqs
zp*D%<4kQvL?3dltFzf&ja>*_~*$1F!)Ki6cqjlvp`nu8I#;JIt!oq>WDXy;h{ru~V
zqsVxuWh3nn_p!_F*(9|a{K==pMOMaRy;0~L$sP_Z^Ume>o2x#=YKan3_^r-fs0Q;-
zAG;>9y*L_~lqnLj<n)Mc!<-%FH#v0655XF;0Xn0mrIDZYvUabKLZQ%9Y-q7}T;WHy
zSx~#Hl!wezpOvX4%Xj6K_BC3(PMQQlAs$a95^ekkqI#g(u1lT%9d%i=<m){P=CZS=
zmhOLFfUWI<$s(ZPn=wPV(Xe9?Z^mmu#a4u~>GI*;ulq02dN0?tauO(%8a3<S5@k0o
zadzxPn8R~ER(sCXq-Z7p6|;8cP0_Qreuv+$*P++By2xg6Ub*iGL}NEw+RgIrBe}X#
zDjUPi>2F@C2@_3#NTGzjKv=U{lNxvZcuuNJAfawz3XIYULKn5lj=R%fQkoz-YV)(u
z&YDfzPxKa}O)Rk2Gf+pH<U|&+BO7d)GR!MD8Cl)jjsT}wc3wLcjV^Ym3uIH>xcVRC
zwC6WBW<p55%-BKrg(u8X(AK5pM3?;B=9~q7px63PJy^G<i7aHAPJYt{{<6sZpL(@D
zXLaRxvbiLZmkLATmC@eIhzNZFVwr!b9AG55Fx&FUbYr!Jp9)e4itPEHVF!Ij)c{EN
zOQXD=AA>JR(jW{$6hBzAiXzaAA>E=T885;LB9aMTnf1r*>41lIF(ZT@Y&QC73K4pz
z9^XYwMAJ0z?R0F-?&f5BpYPdz7)X)Nl18{pN!8&zY}Ui$msl}c%|JUwz0tgO_8c)`
zb21lqFwY&rfUZRrJn?_LFD|xc00;3lM(I)FAHo7CB@0Q^a(*Il1}!2ZblOWjdQ%p~
zMy`m89(M~@r4C|ElxcyO^66IFNDG35YP-m<r7h`>fNuAr$j2-`8!Yqix&3?Xt{NP+
z1Y0l1=>Kl;^89Vv#agJs$NSdU{rsrdTyk-Qm6G?tS(d%@)<L>u+CbQ`JD*L!HKRrH
zfYj<E(WIT&*ZvKS9c(dYGLrdh{Lsc*=Xi0Oz7n-RoD$HxP$+P>tq)FAeAOSYt8=nY
z>1x;s4#!t)Rx&}Duv{EUtm8q?6oV~s<<fy1X4sWWE*q{7`$je!@hk|_6qzTN2x^o(
z&S@H&k0GtajkekXi#3|d+dQFt>goKigJ7*?yixOK&6tEAB!Gi&M({?hZNFKiQ`|`8
zK~be@G;&<#;#QLlgE>?W4((vv-v9$XI=a{d+nDa3K)8S-fGDx_jP2l$?C1olN+~$+
zn0JlHS2_(gNq#b?b>G}$74{fTmj&MYFo9{+qxg79mIuJ)?LIXH7PvUy!OjtxLyr4i
zRz`4D=FPALKd?*%bpOax0GY!`e~@MVWqD+|`$@hZT*YMz1$0xM`3d|4#XR3pS~^=C
z;d+o3XSB9n+ytH|zaWfd?=_WhGd3wq(28E5KP_Po{zj*5s$#K}-;$`cm~r^mM4m%D
zOFPUhYE(pI6e*muG~<7cwpth`ZY91!^s@Xf!ScT7CAm&@<n3jZVRnZC-Z`PF!Uhe)
z0OQi>dL-R|*cMHpUlCvm*!iu&JAWRf*wblr>zpM83?|*7R$ywc+aEN6EeMN%X#mkJ
z-rnD&#uJ>}J(JU`#&IMsX?q=SU1)5+=0nDlgN@l*{_Gn^1A=|kYGdfS26!^7U4x0U
zS2+}eUA6A1TK!B(<4ieY*R-9UIwSMgZ!u81B%NPtRQUee_RR>{IVn5MX2m>@kjpQd
zg`|AYuu3PBLG*L#I;3`8uKn?2`2K}WL9<)(6zTr3sVij*x_TEMS?VCd{bX6sHHz2D
z_|cY9VDZ-UiS*NaS~I2!IcfkR6m{o!P||V#C_*kk^^|Y>4Iu5{I<MWquy@nV+c^xX
z{P;%t+U(wVBSk1ol=BhL>CuU+qkc3SE1mg-TGC|eqc?x#U1@~f3}^M9qhdM@ch;Bm
z@Z59C9>pXN31Iw3O{#>ddo7ec8IL~74wy*48>7KAv+N(jnJ=XOf_s><9-nlVZ_)P$
z9tc2W(rsb8g891mt6fRLh;$%9>4zLsU%++x-u;OgQXh0g-fvS5X_6)aXL)RQ%A*n(
zT#tV{2LbB!WGPy=rIboGAv_O2oWHhWzBk}bdMcs~enl!VE*Ob#^!Dc$jEA^&2WB4+
zr*)2jPHQXMkRUDMe{Yyx-EGxQtm2B?xvE<Kt0B4;NqTLr;WjrHglG;k+B2VjhCVne
z(a`t)(C~t99ji7B+NHjIEfkqS@bnAoWPBvw#!1KDf0cf!Y9u+2Dpu0N=yIRR7#IHG
z0I{IejWkh@nL9wzX%R(8TdcZ;D<hC+Pd*oY88k8>kPXoJnogn?-Q{JLb^U^HhaJr`
ztbUwd9>`{Ze6&TD#QjD)(}FX4?PgTGbJfIRjFX8YobZs*ku1k1{(#Y#;DN{Z0Li@T
z2B3r9_FYR0ZR`(gxemNmPxf}75ovLs8%Z9%)c}6kgRQ<}Kw|3E*nC8o2r~9w>Ir&<
z30p^9Y_uA`ijbG70y|~uM>lJLj{v@c8(98R>5BvV`18?Sk(aPl^2WzuLMt4abhCN(
zc5C&0PkghpgbK%>B{o_o2kme)Ggj-US5VE56N0ACjdk^vI$#?l6$zPi2z$Xwbb@tE
zg|^?+5RMK+TW#4wPgYTzr&qfS*1Kw0jFjrm+@>1AdXl}8b+Q9y`w2^$YijH$_dJZC
zSqNNrwM?2kHlfoCm10-n?!zy3Js39<_+__G@LKtPW~aYb%;#C5$I4BKLN6fE93}{8
zCu1z@k4BPtzl&MY8Y{+mc5%}#j?#0zpV=~4Cg%?LW8#i(ZzlDK7nVZ5b?#eUKd%7s
z^t8Q9gPc4;F1*@mMGN*0?q+>hUe+lNP5Wg?#n@6WKuBR!3QY)Vj+2VRa88;}_8<*T
z2Ez2%UsuQHXTVGJ4vzYOq~{V?W%;+LDh)oL8q6I)=y8tM0L>b9vSi+rkt-}eod7;+
z4$y0r@E_ckyYEER55#cA-O}SrP@jlZtm63}F)oj0jvvAI6D?7K(_lBLMPy-*l;`O?
zw!~r2gfYV}<QkN%)l*L`#P`~%VkdZX&y)6E_zYh_n|1%8Ig4i9VK0u1<xMhL%PKVN
zJSq(!qcJmJ0<paMf;ylLKS!5IyEyHf?=}ncG%eY)9*ME2c?`c3l32n#qk85Wmm>uF
zO-?qU6T=hp4+3^PB=y)nFZcy92GGH2SdD_e-QYqUh+uKyPrbt|y}25kLG0&;@<CKv
zn#jfVBX~lG59b@3htO-K3)FuzF?&C)#@kinyiy41g8#(LKmS<J8fEQM*FCg)?N<uy
zs;DXq>?UNAc<dOZfLjMStW{rYO&W^i)nFvOXl7#D4tTiI-|)C}_Gk}fX->g1VxJD0
zGZoN-`xbmQoO()(gZFH&7gv786qF=!yfH7%A{D;l-%uEfq{Ea@#9~r%J14`Himo1^
z^%Y&_a1k^~?yzJu_(p5as46o@s^NQlPa*rOXRyKO30g;S6O#YkOhTz?>+onv76b18
zkbU@E=VYthUnkkx7?ckab!Epg=YRbC86s+96AP<v6AL=Ic5`*oe-`cbsgF&8aap^5
z)MCI4Bys8~$AQ+W4z}5SjbYBmqL4z{4J})m9Ya5^kct!OA9?tIsC)I=AAX~N8)hPw
zHJooD%G`vbTPHmNNz@G(toj|DVx;mM<Y)z^);>mia<^YKh8-KpE(n{kS{O-YJWRcC
zGpbTq5jwmB#bu~RhDwW0;;6oG=69K$4I9%bXqvDlWhBRV#@#-YN{}1RWl%KD&%b=g
zIQ%8vC=_=TOmtGB5g|ZXTwa4Vn4`9csj|H*G=?rZQLl^0O=IB{dnu*HLDSfi<>4_~
zq#v}0H}l$yNGTv-MvM&g>(V`3n)O%xBbQ%#mac6x`3P|8`~krH4u@u=Z->g*8a$h^
z_))W05>%M&fraX5G%Mn0%9K1gR6E>e7s}Vm1cG?w_?%(GI{xM`#!6a`n5qX0=HaYY
z*B#u`PpRcHEE_xJdz>Eh1+0xL2%SYn{$!Py>&CuF{(!3wvC92BD|51IOrOI`M(6+3
zwg$dUvq<+-ry-nF6*MYbLx<UBcAZ7|w%@dB8Jst(nVx10^nvL~!i(9>|EOj0FKB)|
zH0-Pc{A7;E<InFl55SJO3Mej)Aq8LMex+$+59IGT*Cdq}qJ~7cLcpKqt{`SXVnY*S
z)YE(}n`keE1A6<bjN7o1j;W`*)Y-!?BdsT7&W@JPSA74Ynl3E|9>lld=xKbGz;tJn
z7Jzk^evd;!)JJ8DCT3wi7*9u$Skl^C98gUp*EiV2{<@ae0J>1^5<72#6P`(_4K<b;
zsk8iJ47O+9Mpsq$2doQ<S7KAEF(IEehawT8@f~K*Ctb9E-Av+wb`FKWJ2XmwH8nEU
z{-^usM$CFv0Cx+)O_pU^B-P#3YP#@ULFv9{S`umhog_6D!<<jv&i2N8&jKU?hPpsD
zWaDus6MEUup<skD1aT!h)y>!7d*82dk}3S3ue4IMW)Q89@Y&fjmwSv^z_cJV`en4{
z%&}9L2I;JdA~KCaQs#Pp2D(ab>za~ZpZ18zXwv)-RRS5Q7Np>1d;f8kc-C7|$&|3T
zSB-BiT9sr~1`7=25ORq~@PsK$Na<6gBv3q4`vpAPzaU*T(YS%pD!y&WU9ESjAi=i_
z6^D)(sjOdO=vARRUdmsAMX{SuVPoLk3H}LK<+o$a&4`I_w5S-}pm;OtJtwjbYYeUb
zK7wV`vZH%DyMSMCjYQ8Wml5qUaKy$;7l(iwBKM8<M~S>Hg+CVHX1nbzQ<S#c-SSp-
zSZ&@bI^j9X^#ca0&<(;WM~AJvn#Ci8yueNE>6keN?p=Mm2j50iB)vg%Qi*iYbC1^i
z9wK~O>w8-80>F(}hS4BUDWlJVR<%tdc^ck?|7fJ#wS;q2tVIC$FrDG1St*4o43`X!
zb+<sdXv1wK31xS&<f;8AljiQz`L<~6F)ao1MCSpa)(iRm%qaRiA)P@Uar3;#neVKJ
zmWG5()H)cNLHJ46X{F$;YJagO<A1k#yI#2)UzFt+VtQ_Sl{5$+c9$xfrMr7bN~o_N
z-z^v`K3qPeXAIHZuHi2(jO2CkIH8zL!d{lBzFO_L0-zp=nZ}y|2jQwH6e|F?L^zsU
z{uy6U-~wm2*J-BAa8KAfxLxikx3UzPS@{$U>~4)s3`e+8%B*()P(*)dRz)C1tCMzJ
zq~J(K><{`s8^@V}P06U4$2M#n>Su?}MxSjfaYEAK8W3%l#0xgWFPB=+(SoMuN(&h}
zO|(-5UE~p$aV8}!<kBv_p8u1fgz`skI@#CiJB_AFxe|8dV`wvWwm3p|;bBjHD+cIm
zYqPkEK@A}-eTp_e_S(*BZG@d!h^+@g{DZU%rgB%)eIOHT>PjxBV|ErAw@IAml12W7
zFdvD9bMIxF06A<#ctzOIbL;Uuj#-!2#Ufm>$NbcmtO_KO<}o-&{lDFI^L_gxMWf}J
z)cFp(v*`TFmr%ZfO%HnqR$~#Aij${M*FV}isg%wYuEHEg(5C?i5(nERj|@3z!0@3e
z+wXt5RP;wfmDx-Y^C(FSf2)H9wtXfq{dt-a(Cz&B#4arC`=N->yTp1&`cdWJ*rp>X
zS+oYI5ognYH)H_LPn_rr$9*2Usl)@8HZWly5;GS0%?+B$&$~Y}6=8jV($?!NE1aM`
zZiaVFlM8Ey@w)2{1Vp*kE0xhNfs>Qu;wS&LbbGK2O;rz0z?QiLI#5@X<oP|f!vUd_
zOibl;;SCGdr6AMqwRHjeYZnOI%1WIO^6bpdL3HaRD1-3R(7nz(U)A{j>lg@{M%z6N
zz%QZHomf&P^LHRAEsKmDyDw<$E#=pBvF&)+iv_VC5tKi;wNQ*8in|*_Rnv|UI=F%h
zJwVs;=|qS2_%kJl0drwlwb?U`&)c#{NjOd{U=LcsM#~#CX2X`i@sg83(#rJ0QsV5x
zvw-!RfG&H81tEk+Eut20G_|1fyTGcml};G<YYJQzsV)mA=eh_$;=&s<!^76UqDUCb
z=~I`8$8Hhcbne4m7fFuD^C8JPd-j60)y0d!@)&?kM8NlwLUNKi974#o;=+^ApW;i(
zy{Z2tFq^hoIq8zq0JXA0xKnXPoqO3N*KzsCXtCQDsq$91Qc?X(Ei%00WT6!E0}+Jo
zLHNn)@z+2KFUgz8I}wg|B%4c#E-N{=*+=qV))C=ax@t^4)g;5d=p96Bc^vrzU4Rd_
zP9^E$l_I97_Q#Mo4@fpzbe_(uFXR>Gm{20no$%ko+#(?Nrn}eW@5dWgHWu5pzWy9k
zF7tK4Kx}75AbWEk#J!ZWoQ?hRl+n6LnztvDM^@<VL<bteNhJ}{y=Z6vd_+pO!NrUG
z?O@L}H7%VRe(F>SSm2i+x&v*#C~gS$Fh%WhR@=)0^0NR4x*xJE>7lgbgzxqrE<_o?
zO*C=XdGqM!vp3EHcto;lI>m^BNs}%X(eL0Recn^yLYa6eqQ=~!@~tB$U!DNs$1eoS
z>Z&O+lXtnim}3|P#z;rSU5*-+1-m^6{lMkb|H<dntH|f+j?{DeUr0oVcUuc<&)rI7
z5VRT86+gwR<Zt|J1BZ#tX|mK{+=P=T>^2<oo9jK;$pI+Nb<>~lR=Rptf;<hJJ_$bY
ztM{0Z!OMLUrtx3_D(R-JCgM~;);9~pS}?gc*%cEBn3ro1_Z^$PoY{qZhLpfD1Q!AI
z`lkhRVeM^7XcS(2eE-R%6&4LBs^M__6Rlj`sYCH$=95<dqt-ADt)y?Knz}-i;_Z?<
zF4X6Cxj0)na$5#IhI+g;%xiDdQTDEsHIx}cj_)u<F3VeDjbiWACxE6;uU+6JOD7Lw
zF0n@Vz^-6w6r-U<g~Cyj?f}I=s7NZo=7AUXqHyWv9F}7DFG0U5@}3AcmP2&7wr$rz
zIrQLK5eX@e&Y#MNMAD>a4k4<sCP~PLn}2MT0sznkLrGU!vzUa-M-<o|mai4e5Oz)N
zd_j<C4UHi;4CA57nU3-HDNfpY`7?N^I<CyZs%U2?)1!9GKU5;kXtrre33r$gw`{u#
z!C>P;59_n*&(#o=?lSwxj5)?oBPfLV{|0O5<gLRd0S6nnipnxyF~h4<9){nlEfptP
zPQa1$Y1Y^r2ngWwSZt(e2WVb1i5h!lZ)aVRh#}j`g@N9&dSR{?0lq4+H|MyGfxsZh
z&q>~tp1dchMkj~h2Gd&Z*stD<>P!P`8!hsXK@r3a%|M(0q64QYM>XFf8sec!ypAfm
zw7c=e%^DoITvajG9=r|71avQ#?_g%$?!`qq^X(Aow!K+H6qa`d&^S^0hZnjC;ZQ6y
zhu@aNjSh~3>~HyipQwgufPZ!?`41~HD*e`vhAtJ9VA9R2s^VSW?85exkY}L25ZQBa
z#S1h*!{ossmN6>ga0$zJx8Z#Fs4PO)X@Bs`+MSD5vfr0`3a$UrKO}+!V<hu6e3B0h
zbMj*`)2r^sp#nbHk+%o1c6AYc8KO5v|B9z9d^6?M>UAKUX;rS^dqt^8P4bqF5gqF4
z!+@Q9)ZChl$9Cn^ekRzn$j)@q9aRJvn-`5pum-dw@MhNbxDqtleywccDDT47-u{c@
z#K?25M}*u^!?Ug=6M**^a>U<4uqDtQ{WW94ef`+(u<$HtKw@&c;z2It?(ggO`{Lpv
zTrzQkuR5G8`&o|!NVV2PifmEP8!C{#fs;=!(B)H`!~CMmyDX!WpiM>l^E8Tgj*~gl
z8P2K5tuZ#S9p&kAr-fVzUMrRzz@H8)P~IfC<*fSQau)Z12k~nA@F|F{p6^%7eX=<B
zt9PaQ=AV1DDkcIvsL?$brOknDR3<D}o~dl-ieg+kQ}h=enIH8w`gqO=K6*}Nw2MU_
z6Ah=YvUkL7kYA6D2CNwQm9kOU$c_e8G6_ZC)79N1CGo{wrE}cKq=Aep?qU^=9!cQx
zvx?Vm*_|HhgVNa#0%#;RZcdG>OF+kJ=il`;!ewZ+(B2W!^*3LOFIq>j>ZpyJ!g_cp
z&eaEVh$g<}?j8+lnRl<i^!Q4~t!?tyZ40hIg=8N-T`8C0Kug)Sgh))@iqTaJTuu3r
zW%z=O$&@H1<tux$?WM5>e)IT>Y`T#Gykx+_Jgh2)b$#m%ms(=|j4Wt7tCP-V^h>=v
zoWXJ{OK)s+?e<z|==0qa{f<X6v}>5&rjMp5Pxk#8AK+^fAd%pI!{eKGBW6(ncZsLf
zP7UXFDv4lrdHf-&9F+Ps$>cJ3PSw{NdrPXz|K6F`VC8rQZC4k3;Cx=;FT=bS@8k4Y
zjhCbTeYWNwQ5#s}yLhA01)sR`Rc%UxMh^YKr5F@3M|;+Yk_E!06G-er@%=IqcDpX2
z(LvJ`SZOj1gTGd~kTT0lM@_m+t6Fq{!(uT42Pn}=@6TdOW<m%UD#NjI*<z2rI&*>k
zku(uY)tP4M5%?^CK3o9Z>mJ82jrTCsVS!fCODTrV%!QqtV~i}LM{!|{3FNe3N#m4!
zR^IPBJXS+7v3o5gJkvN+%(^~rW|hncpBH=9i%)=MM(53^o(%6IF)ocIiE8lKyVir+
z&Tda3k(|*V`wzWqNsRh##{RfNmDNxLBvcZCK$n%q#ww~RJ~=q>>B<+(ZT*$jnS{<_
zkCbvM2J9XUDPVFXRwVr<EFf)n&YP55kQgv%DD^9z-Q#!t90gmOKByBPPA!8Uk=EiG
z7F>Qc%AGskQMkl<;k~|?O&PJ{@dtjpbkdqVY%ae~mf(Ivb=(pyh4V~Xp_;W~1uivp
z;Idk7<qP1gDk|vfIAVI~H~mElrHh(K-<~^G=rF-^`V%JVpxE&=rIGu7RISwHxbu!L
z5g4UeM;I4vA0>d#T`j4mZ!}jkz_X>s1NRU|S|9lyD0UMY&!_;9)9r`B$A@0sk5CY+
zg~KIPVs9Dtdl61ilrhz(G*WP)mv<f&$ua&$Hrh!cV)B5jQw2&R3?RvPGod4MAez4g
zS#xRLBp%U;f(U=p3#HPzCe|j%Pd-8+`nzCsfA=^hy7lWZ76o`Grx)qgbOn4{SAf<4
z;&HuW*-19&YD7=JJS(jh4&(qd&jNsp;?*dPFI2X_9XHuWW*w<O_olWPbc?A=mHHDk
zL2=1>#p4wKe}K{f+#d4mL1Fp*X3j6L_$VE?VwB8(EmzJw{f6Cvu}eyjdpcW;<Sbo%
z1ZKWlxSr_P0oG&1>pR&3PsJG{>TDX@#BvjdrNK3sfUyptPV4d71-1rQErQD#H`y#f
z=rQ=Zo^Kya0OrI4vWm3G3n>gD62wth$BgY+c1P)&NG?mf2kuobHX_Myiu9pR7+k+G
z4xfTW+UIj>j_Q!;b!u>@6Y)23WmnUnUvn6p{~dEgB@a|K=hL~GoKMckL(a<gy7eus
zkm?U(bN4i`A7JA*w%ly{fD*9nS%G5pj(U4iI@#wvp{JrV<}Nn`{W$!jQNVMM>?H@E
zSp2rJxFafuOU<lsGnyPw<kT9**}g6tEQ^oKaqgx>83%s^Zk`a*J1!NwF9<efG?)mw
z^t19y<^V_Vk+eSW$fWvS(60iaaw)C@gtI7NRU4Ep+AP8<IZHjXqKq;_R}~ElN2>)Q
zCkSf%p=2iIsWi0h!~o=V@^%B&!c`$BZd?2rulBf858cCQVhId53_mrR@@2n%a(hA{
zB*{BA-9MWL^$VWn0N#-$)|#A!Ntf0&7{rC~K`u|7sX-N~6(e=A7YV+uG81Ld=Q-?_
zsIP*ec#dQLqrc~X?gKnNUGM^hGFk~h`o|kYonU!?F%5Z@gar$n#E_cd;JuHl=<&hh
z)t*LAQF;}1bzI#i*7rfY$!b$;W_xg9WB0@PU%-Nauur-8#mCo88_=*7pY+h2KW=D(
z(WJk@FnE=S-0fW!N!Cs%#-S%t)2az7<P$4zSZsFCVI^ys1${)q93dKpo2pnGSGn#P
zSVhs<2kJY2LxJy#5k0@O5o$mF{#6A05#BH8Ag!TBk;>I>zr7oYhzACqP`aP%uNr;f
zKe2q})Hdbc)W=`ddlXJl8(#|M*QH`F9@X>hhjls~Z@xCKu?SAR9w8TTm}{o@i^1>d
zk}zSMVvIv2it4htOU-8gk`PCYdTeg;<OO{+ji8zX4h8b3?9hx3equ}Q_a~Y%z-A_v
zG3ovOX$ymmt8C>zY!ii`lH;6XyfVC0puD1i`JDe%Y63sb9B7GpwssNggCtVfj(diu
zJ#8-%x@03)CtX^Mvyg?u%)~@9`&?8pP$$rmUj$4AVpk$kv`<xDXshmXx)URe+%jN0
zigjr6bEpw7hyM)dTcPVQEZXnSj-}EQAY<9&NjD5S+kz+(2ohP2*ji5C-T4<G#ewil
zRcw^0{)Bbwcq7O&ZVoY6OUgfW??Y1@n3U0#j10A7^%j~UWrqC46YD}N5qN^n(MBPZ
zxiIJRYb}5tK!KU32pj4vvkfsKFv2kK0tn;}8Fl3R9#BA7mYYVSWtg66jaOXvm2q{A
z=cB--%+iva1=10;P%{mRN?ZlZrGrxUjkzrq$PP(1Cawc%nOnXNFI_7R5IqUM+D5PB
z0*Y|TKiXo2+Si->#i#73Mj_8tzcd=j+dvprp+_Em@z;(vRVXBb?4igQ8HUgV8GlZ5
z$qKveE3FRlqt6hMk4~nt=b^s7qOSX>;~y?W?6wAMOd#SVR|+x{;LSjsQl1s^%L(wu
zU|ok>#fe&h5{hbAhJk(rn(WeI{Tu6Z9I(ATQttw>`x%N-n7pWzq@z3J4>?ttS|Ui}
z<M2S!!9Tw(Dr<-}6~kr2-=ASXf1ZW(@}Ryi>-cifo|pS7O^6DqJ@y^W`>zJ8MG9X`
z`@;*n(Vn~IVj>|`)~JL8BNOf`9FcsJAcbzEkW7Y9oR_ZLUs?D_hnnsu3~@7gF1<Mg
zE+8vF%KLWSoeyp`g#vIT$xS^ZkkcsZDMkix#*DW?c}boCNKI`=3`0?0GBhQPSW_P1
z-gZe1tN<*gC%tkNOYM!B;Gd?<T-Lt!O{e5uWEjOi=o^Rnt@bHUGi$%ks{%g2YnfJH
zQ=0pXObi#gm`c9B<1dgq%5q{WJD=tPegJTNfm@0gAcXrNJ1mPl?PX4&cASdfp2!bG
zzt9bP-bKDo+%iF>nGZ%iGu|=Z`UH6Sp(FnwA#}$pyXvs3gs6_d$4YbboLRY$W3LEX
zZ8mw|sGC)9?a|7qcV02>P^;v0@;f&BO0b#mO<}AW8q3oTU=gi|va8b<?gB2|<hkM_
zU3i6eg{c<EEQ5H(&9t+!rty_}x^!D%4Bg9WFLA*ydHJbdMV$7Cb#miRsKtC?m{kX+
zDR0;8t&!z2s3wF!?ww`1J|f0up#XyDP7L>?q(+L)P$tx*gck2cAT9YQa}h}UVidlb
zpty!250y38562il={hS<ui{HT#9Gr~*#BJ2MB*;al6Qawi?Og5PX7H}RAad9E>Z--
zhLRN~(``M#*fXWx%Bz1-(C-$M_y$83!aHn#9(N*HVUCcXf28%b+;44)*~@<8zv~<=
z;##^*!CdC+><l89A|)xb^*tkwz=z2e*$KT+zOSMTP$6(6et26NEeawoDO6yT^lr7j
zhi2TDX2C-C;a8QIw7hWI6mi2pMS+^9G(CxZN&T81z%D4FUS^>j{Su*ODoSt4VG8a}
zjCJgQMR_jH$_qpP5fgKWVyvZCOqhTsT6DQfGeo;um?s{4^moHyEZi^<xE!f4IoW#j
zzYy#71rFC)6^$C83o7h)DhhJVkG>y;x_%Ecfx#MhwtR_-qHN5Q)SJYu$hiI(u2p`j
ztacPD*M-oZd{^Br&w%t2x@CuR$n*-G?VN7uAOUA`Vu2My`ErT@obolzXdA7ay^%1C
zN&-w{rs_0z?3p`O08FpHE6jHUheaNXqF;jT!<z<F_bpk*O*FoeQlIvyvENxnxRc{h
z_OPVg^x;1w0T!ll9<Fh;U`ozYk+Q$8-1FHj4gSp#TB$sP;mMX;Z}H_fpqzngDOggE
zIBwBi_S?W@#45ls!Zf|%XRci|Q%vRrt@%Mo?3bgH-L<q1<rCD9Tvq$J)li*;pcGaw
zfgz74S^Sw`7+v^L!XObFfk-xHw?;?ZtO>&j^VgD<J!?5oz<sUc`9BLlYJ&f{+w}Om
zJJ{3e*n#RHicHA7;)}x^7#Z7XUt?EzpjqEMTBHCj>WaJeCHL14_+07`X-4_hp#FR;
zo5;2X8evo)$XizzKTNO2y1o8z%;lOw!yBqgzh0RE#n9y+WXO0oixW@Tz|01ncix+M
zuJie3aJ=LVV7{!{p~iflqG5uYguVJ4#`dKbh%gU_9smf>#&YRvDbp{v<1yo)hnNIL
zA!(_y(SUmH#Cs`+GcT?9oMgOtag6M5If5wSORt*-_C7f&Z_pl=uizQ}Di&e7vp%Qe
zRv~Wp7CXTs=!eDEOjhjy3M?OxoR1?!_INziG;2XIi4J={CU|9#EJTG>^|mwrh2z?T
zTjiRd)}XdPC%Yh~-rtZ*g?CGc`KZ9w_DU-2AqjyhjjPGs=H|HWZGE)>)W<``&uJIB
ztb8!|gjl#?rSHO>xWH;}O!}FHL>5Lo{-WwcACskV?pVsejoo7=g^=RWMn^U2FYmEe
zlZ&K82t|<f>j>*1Jy|#m7(SVE?Mkpne|&XQ{sfl<%@%g})Ytldc(n;JA}0d#ld3<)
zxVEGRvRQ&N@3G)(SN>br!1bAL&(TJcz!a4_;Hoo>09)X2gK4MH6QS?yh<A|nAMe>G
z3{-$#gB8xT59kqn9ejNwIhqDQL77ET7{O?0QRI36s#uyR@UVdZ_ON6-eHmP0+9|Q7
z6>TUfEoznTwn767`@h;0%!W$JR%X6s+53UW6kh2tCYvziI-{S^fO_sv@qB`ALRIqS
z1eb@4HWO;k%bC70N|7cHD<ad8+`K+bNv!?l&~Q}jWxq7`b@`>NWusk2fJKRnUZ(&~
z%bo!tR9@vEwY)7vo!maIpMuDcE~%Mp?G2c%&Q8M;;*?J0Ju(QTGp<iC7CfsBBQ*;o
zMP!k1FI%9J>+OEr8yC!Gj`=$xV6)*_N@ipj>hEZ5MU`?pB-&yNMAi)*<$m`J1p_O#
z1_?xW8S3Zj)~Pqvug5|PSimabZZ`QM?+-VhPhJ;AK-4s&ed`9`JSUq36Dpok%~vdB
z|6kX!w;=7Ga$b`D3qDzAn2&I$Z7%4PyAV|d5B2nMjjEZ+e(I=uTIxF1B*ideoiS>b
z?T|CGd1_GCXLTS6mg#`+dciZx0k&HIxpMizAMzDG3HjB=q6BW>lEJi)%6!nMN>1we
z-DmmVPz&erF*s3k=EM{jH@#H;@@yI5D3FIVe&+3vyo~KXcF+cgNIl294q$;(a(eay
z!4mYbLwTI0XUW3=VpGe6kzsSi?fL&&>`(_pH=1V=<rm?eQL(fQx!bKwc~$&fST$m_
zlcAX-Y#NgY0G1;x>CAx(l9o~SiWX110pDal4pG}zl;&kp)u{uVsU4E^OQc)Hmf^?r
zxXXJMv$dIaM1c8oRw`)|+neJrrNsN+Bx&J-Y?p4d-?~AHnKIK(zw%{d5pQWcM373Q
znvT-nQ@<<y#m`jC55UaKr1X_)yOdF$WQRQdXxn+7KWb{eztFNdK`_x5&HZmga}bSt
z)<CGmSI3a^U}~>TuLyKSvMA9{7e*IWFOwAIGuoATO<S&ZvW(39tT3-p$r}Qht|%4N
z6eCnIH?#}yQ`D@OkB8;X?ZEv*O<GZ{x*tYQ!;hH=e#<G}=j9EoTJ=(yA{Nb*AS740
zY=L}at|Ya%ez7>gcLW-w9YHc~m5obuAS8BE@5Z-c_q~*0SG#2nRH!d#Fdt{rV`#z1
zv)E;!CjirOA&C;Yy5+}1aoRt~{o4b~Y51jLyKsFzvg~gO5LwTO8~<;D<)oB)c?6YL
zWaVF%x!A5om^7kpO%<&N4@VO(Xs7<Gja$x9*UyRXpPOI4Vs`)@TSe!gOsmuc)6gjk
z(skC^;OT^DZ>zDE_JSsO-V&S)$-iv)HuI=|*xWk=!U%+%i!4h2q>ROWm1mat2@5UP
zj?c^=wt>ybU9BnzrLDuGX~;oeLM5^=xWI)rvePLU86QBj8W}pzz6F^AtPqK^9QKXU
z>CMv~Zlx|gA<J<3LxzhNK;+7*?a<-=pF!p#pU2uX@6n3rE?fk{?+_WC5tZ@(qL!80
zB-2+q^jAT6SevaGWnrg9+GlpQ%k;ql&Mp}MvyOv=Rr^B~dl&C{olv;dX@l#WyKq*G
z0=~L9H+RPzW&`T+sh^oU_M;9~H7H{|?#{on?5vkjDqo8P0zTZ$c;Qf(f)BM7FkR;S
zuxUBP1|Nwz67hNLmNp=<HiJkXagc)6j{BRZ*Xs7T5GQdA_G07)jO+_}Uh@V-<}dv9
z({g7)7ONT2sVwk26j6W{AvOtBFHTfPjExZk;Ia-Qg}f9OHQoB$vVQ`*y&1hlGi~M4
z?qA-B-3n+KP^i_Ww`QfMp`#HJE#T4(KUkDM;h*{ypbr8Pd)B1&RGSoQ(R^>Mex*D<
zp-{oHtm{f<%7LKNc$MFZm17Ryj18!FXgdsq-PN<XUtl#2483XrE2&(knCf1keXlXa
zQdh3^GfXwwwC`DF)y-TBv#KE~gTzvVvk+=3FH4nd4JS`xdJ+snskY-yW(xlfeA<bF
zOoY9$xpwVD!Ez%}j;rPSzbsKG2O2+kz#9HH@jcY7$+w+RQZ_}GXEo$6R#RNI@XO-M
z_@9r+MWF$lzAP#44;61Pk*v!7QzevvsQUm#K)S#7_sw@A+IE_)E%HFSj%wbdF0sTb
zT_!a8VBv~E-~XG1E79U+i7W*z$(m-F8mV_lhY{#{!kefO1qdZHgrfRg1<<PJS5ODn
zEDQTH8zh7Tw;aR+`bkfE5xw$;zX&@zrwA?B!ZS6XThYrF%f`g?D{HAS3@7HS3Jv}6
zT<t-`8B?!cUTPYIrubzWOhifd8^&w$24rYL$izCW<pb(gM_(oV6mi;#?KSA8!supX
zH-h2d0G_#C;z;PgSh<2#bxII}sp?y7y~*Oifj#0<TS>&@hUW_~h;k-wND~ra;A|ez
zl^v%5Sxo;1E#Fzl*D-b{mSJHucAL;K!V`F!iy^D{JO5xlEWLyghEg2POPv)FX)%K^
zpxx6JcN^=C(>msfAJ)g!C_wxgJD)S4M_U@$(C$ZivFDH(OBg;IljSb%<p4aRZJsgC
zVZ1(Jz{?{iv^Os;x7kn7Tw@vV)kRo1`|_^`AD6SesJcXOfG~H{(_LSZuhVFOgS=He
zBLzZS`shwEVd6X;pHJ8Kecn07BM{*~ZZ@O<6#Z@hf{qGTEU%Txp@p~O7AP(qg%WuV
zm6bb~-&dMFIpbOt|KS;R->0Y2GgpCn=Z<~$X3opVTuM+)V)PYWcp*G%i9sfps>(rM
zSUJ0r;;GkqU6SUN2$L6LyGGVX+`XS+Q(BE0`Dp_~1Q{=I1{=rbtQQmup^8!VU>!e6
zghV(&+Xi^ijsm9-3lH|wlgwl*M7d(mpJxH>ca=F}P+56|4=2^TWjoB#b&8q<esw;r
zZ9boYq_7S-n{o$fL1LK-apiFyl7MaV@3%`cu_>@xGo5B)gw-#{qmfLV$umxBjnFc{
zqqI0z-lK%pU52*!Ser`h3?ARp_42H#A&oM6mUEMDh7U~Obm|omF3!LY2IfjBD{w1-
zk?!Qt$mwzeMM^k`?~-&E0?uOyqa;Wa7=<_jFs+GSdS}naS|?C<-tYs_CpiMm24_P)
zzO?a#lFIgFj2UiaU1zY}Xl6!#tFyn)hS@g+usQ@<zcp)=1VDrJy5_a4Q@#^7Q?Dii
zsM{sNI$Pov_x@Hxp-ds@#(`r8-nisfMa9uUGBdas4B$|88qyU{qHYb-+|}lnMdB?m
zkDb@{?eK~x2bIE&N;sJWrrt%B1Sp|=Pb0d=Yw#jwph!}sFxROnjg*mJ`eqZ%10Y|`
z%h?-J{xmfLp{N1!!QRuPYcvVqAF^<>n^Nc8Gf+b{k=Rq;XSo5eySaYy9KqXN!ZFow
zRpI8_<)KCrBW&&<Kk{HCWFjVixphd@`MsICQfY)LuIx_tI3hM{7f!6|?7}dq#KeVz
z@%nawItO3WM<FC)r+RXEEIwK7Jak2w_ouCs*!ppg^-U#nN4~~*z44<Vd9*GUdHSgj
zFLsY~mDKuCX3_Iw_c0Apv%x6?uVHQgBT{Y*`0j!1l0Ge}u<$%Z$7G{Yi_q{guF^6K
z_(p+h3HGOOS)>vdcI#KPVdqDNXvph*bUp_!-yP3r%cPiHo?5o19GFmfiwjgyO6Et$
zFj89w(L5*(&M%!MG0S4=8o09|s;#)WOnygr?O3_kiKYIwuhe0<+~jExBAzvPhp$oM
ziy3$}l$roRM4_G^oqAs2_iFQdxAkEkIE%L}0#}hS18~Q7MI~{0tqfG(J~A%6LA%?G
zIwU_OZ{3{4!Sdu^95}ncfWu%BhLy_*X2h{d`7qGaEEiY|7;S|=zQ9Bffiskoo<7Q-
z`&{*w-SNp^EX|jfa}utjiLUn09Rtk=L#Aqw?VpNan`T%-;EQFCRj54Vm}>}~bwxo_
zh2Q3xHa;fh$1&!k?=RcHfuvy~#d=5Mt^uxEWi-u5a4}J)zSF-}Hx;E^i_;!F4>dtU
z2|V(XExj{?{b-mZsD*b&-bR)!+}bq*W-?y!t7ja;4K+E!4(6q3LRYep2sH7I7JoRx
z(3_YRE`h{gTb#42?9QAB2(fQuixHP6&5WTD5eSQYjZ}E^ugk~<)N%|y>)yY`$d9am
zEy@u)a%_+P=Nb4>+~YExXwQvVFePAaprX-GCnoZu(<zMO>dEsr0H}ts_)o61$^^4*
z;T2T>19&_dW8rHLIVLb3@VXX5aXBfTUzt0zNBs?7VftFLUX@UV71jxPwE5l?u~(63
zGEbTx5PSrf0C`Nr0@BU$V5(;Q`a@zrT_m#DTMzF)<It-({HQfZt&`cs9<mnb=T4VI
zAE{1tP$ZA7xoHD!%RA~!do+{@cYNv0-qK?7_a^#aA5!Br5BT3_WtsmF&VgdR=l4PL
zRJZ9t)e2LQEyW{ZUqU%3GV9))_64OrP<iRq2q-Mechx-~auoUrvBhN%(1&tv70$vM
zN-DUPitK&B%@>H=ZaPotDD>K0wuIv4WJx6Q9NZ88$T<we&Zq+ao;4+VIM1guwv}eU
zJ-Ya}2=R%p3bBDYNoPj~F}qq$Qaay}b?ZlmWi**F)@_}ewz^loy@wj4xQ9YQY5HgR
zILH0QN#?M0Cl`DDz=rWpT1WG>T&?Uk3ZM1I8Y}KGt>}pSNPI2ROi#|p9gZNpLP0Q~
zpj;n+L+(^1zTx7Eh9ciF1(e5`xq>dYIUx=i{s!OZZ>|}VdzyY-a)XG{x!ak`3bR6d
zU8Yl2ORjf{3|wBv*Cj%e%^OmOemWXS_&DiRlU9}8V0u&2>AW{49`lBC>Fp$$3cKjZ
z1JL(rdbHoSf;FuCej2su6gHI94e6AgGGT<aq-b!_uw5H;rua%ru6=;OuBS48{FYJR
z0>obl&O}KUAFEJg(lk)55n)X44f*&QaU7`A!b+eXVN@qPw;zQAM!4>@*o~rPZIF)#
zPf*3U*D|->io!-VeTd_g^i!&6Ch*CN9;2kav-)O#9x_F<0L6px`dvG;qC*&1nW(xf
zSRa~N6XR{M!=#o!BEypF0t38BuB7AjMe@MHF%9Uck)Bogo9Lu<ZUe}^FZku3k?0S3
zWp2X0UFCFKc^m0(>SQ<#$Jbvrn<J<}|6(TQ;>WR8fG1~gL(qmrAjuwyx2!~cGNTI`
zEj3E*;acdeD@>-C_&U@0gVv^PAM`S$kK~!2W}*vlY^|*jYXZXVR=LW=tVvPtnXJ@s
z;TR^WUC3jxcT=t2Z9X(6D;Vn3D0eU0kaQ7Xb1$DveLowMWHr8O#*5(x%gPo!N8r0=
z=jd#NY)ZB)a|DYAmR=<2Dd3Hz)hcCRFaAfWuzZ?+N*0_<ks%p-G}MG)`x|RRD3y7d
z*M4d=^`9#$3f|nGXN}c{R0|J(!HXO5J`KtFKq5l7G<W?1XK}tixn0_CAAN2<Ov#gm
zas}@SCG&{As3wIMp8~TxK^C>-r1YI%x1?ANNI<QJDKS679-JosWbg@@5L!>yKD-96
zw`q&E07sH1HB0LS%Lh#Vw_HKad$ONnmwe-TZ4HV%Vnw(o1ilQ6Jx$bqG9IY|%I#ZV
z;qhbE6{vBah|lqEbt4=fW{wJ_d9~WCE6FuIiOd#S;xm#OPnqY}P!LEqj8JU%`{acD
zDk+!qP>@K=f@n((O!#EnS9cub3`CM?1b|>7g;8ZL*kSjF7_5()w*wU6RHkrUN0<dT
z9crstw?TMR(X5CWzjvKC73YZ96VL}^IAC?!-Kgj=w;Abzi6qZ;xvXrX;1NLf2?mcd
z8h#N*ipZ$>oYwBDDED8#{4Nc%s6%2a5O+3&Rls69Zm`xFb^(>MZig(2dTF$C4)Zag
zW6~g}gPXTTBNw(^rlF%zu(P|mi;^=h;M=b8l#Ma=l8RI@<F*Jmr~!GCZ_?;<WKcL(
zYkxzZM@t9@4}Tvn>lei6|IvW*yUv5J=UpSQ2~vhD8>CmUY*~JtEts@eCb>HuvwDYO
z{-C2*c-qSqqdH&8b)DT+KH3be`2)$J^ZranwSJ;25|C)Dr}2L$Yl~U-ss*G#;v;U4
z*2?`E+zmZZ_7;oBV@Sx&S)fuSkEeqCg?{8#Bwbpa`2!Npz9k&U`<S{zXpi;m?g9@d
z!O8b0fMMne0?l+w!%gH}iSjyKrT5x*6-ILI2?~4Z{YY`(KONOt4q0A#yy+rz`sA^f
z2#<~=MRPx4pmANv*(N4gr?{T>;~T<w0JITPJX?5CVJd4*Lpk}Z!uYp++KXRu-lQQ+
zKf*nQk)?MZ6#EqL0;o9Xq+ZHMRq3%93?1=G7o|5fX&+w?=@%*L4&_-;1xQfOnr%<z
zD0O@YrP>fF{GIcf6Rokj|1(I$AR?h8ur$sWT>~O~nniNw1Zhk!ak>Ao8~~=}%_6jR
z6KQGqe&=5bNnL^8N~15KMluttMGhm2JmM5+FHv~d^0UUwPlODFG*|BG3?{M(WYH@F
zD%{vgC>$&zfLPQ@{#A(;0N9>P_~63-E>nBKO{{Lt_UUZWGc|OU<rOOnfaa19iH-vS
z4-}G(QPIBkAvdE4S)U#*3w94DvjLA6s1MIRBL~)3xHWpYv6Qo3wBVt^RB3DLT?ot7
z;8Afkk4T$>@P3PM%C#GwWNqont+_;iOI6QuhS#<(EF-Wkp-fcTlA7X-VaeY(OMK&U
zTYJy963-O_uqrw$u+4vz#$GWIU?*GQ&O8Y16v$xwJpiwL%oS8WKX}lk^V6J+Ebgt2
z9=8kW=M)42LbSczB%QiB_81hYbx<g;jq_{lgD-yezHX~4zAVwMf_A9@GXHnlj{-Vy
zTf9$Y^W0|oEw>N34bEh7Y?TO6<16CEP?&rT8?-+f(Dx?OT?(=U-k=EWZPZRW@*S10
zWcwOtDoB#nZ^};&+6&S$eYy})$dhA!Iiz=0kH7KA<&GR?N%OawYwx<bjJc#mD%fA|
zO)>21`{i>$-gneX3}ePyeKQjNFXpnRycG5@H!5y1V}^Jz_pTH(C^J?H4`f5?#@X~!
zQObC#^7*7S;79SP71eNfD?9~Q1GL6ur;2;ZVMbR=vWjg3g2-|1LU)u;CVpXk$g24W
zC2B+r_@}p*Ss62#w_yEkd|21&-o3=J8xWQlg$Dv@e~MBTrh_$}Nm$skWYpd;#qzCK
zuWfX=vOSCbkEdy=;49<G^p6Mc_(6%JORNamdO@|&^Ct<6ZFE_#>;ghIK~fL=^&W?A
zzJI(vq>rhA?~-f(Y15r939V@(Hegq_QJjROv(5yUB6;fNsY}iB-o`V~*iL%(N%M}2
z4z3s5HN}*-d2W&_*!`?#>{k&6oT&N0&3+aar{se}*|*WoW;M;vG)<Fh4I*s!4Ohao
zG7R7>@(`uq<P1dDJmQ(b!vc-7t`sNmQ{4>WY6;{+x3)Fg++d-#hv9@4LPc3sJEw~%
z3>xH~PVL|A#|lQtu)YEX@bcnhz4qJP@4xnnr+w%?69;}MKZs=cQ0$B)x7K%5H%ay`
zRYLyVb)BQTzk)-MIL)%o!dx70E3=s@$VL-c-ByV?Phvr8s4lDMAzXRh-*VPEpADvv
z$CmEpu;&dhN+%g?{}(ZD53_$*yK&J#t*Xi|I$vvjOltKsHowm`IZRV^NJ|3bL62{v
zsX-GTY13JTMa!$U9`HDetd<(G_YHpYRnU)NzV(??-Rg}8M$<4mUWPU#ouB#|BxrUR
zxW7~6A8`4WN)DmpmnAIERo%6l62GaOcuFQ`giPgnb`M=>M;bE6FD?dSu&h9qF6R1k
z%mLeF1QaVnVj8x4odf_x0{)pNk>Lo(>dISpG$q=xL7m$;VfUc1)O0~+FvrW5dxORv
zEdq+09j2H2hVf$(C3f}0Z~C&3wIwhh_M6hFxIn^~)tg8ZiV!*7)rM|~b}pE0XX?{%
zb3w%^HJoot2nJZjKi|dxQF4P;TNJgItIkal{ZY1rZ)Y#dpSyZ~t;srOKQX@l?e!v>
z@C&lfQuwt>#41l7KvoF0uE`cUk!j@A4a2mZvWI%T?b`n1Lys~lR_OEem|)lXKkT%0
zs+K2_e^fYd1pSB)Wyf8cU?GKarMsFE7ZJ)o%3(?cZw`;Tlb9V_F5oZ$LO0GEA&K~^
zG@&AJlY$(BWw45V`g4%A-jtK*T!|2maL>~s9PouOE8cznSCw5B8<1tS0%>yLa|{|$
z>>a&VX(wn1S1n(!JWN>X;8@t*qw52o6_A9@k-oTU<#1QogO@|Nuk|TcgZC3@k|jYB
zSNndU)ED_!g$@`Rf=oH_e0^{-CnoEQ=&@&@&u*c)fs@kw9_+!oew)e8BK&cI7pn*5
z_T-113tzG0=9m_@kmuMm0pO{EN?k=;@N0S^wlZPIoeUF^!|#L@N$Cay*q3s7JW*_5
zLXEPpZ~-$69(R<?EywxZ>$-+de^xubhE*>$&?@EQ_;gKIin|dJo;nRGzS-fRFc+ZD
zHH4rPQK!^+R3)PT_&`c>WFSkkd-GCD#Z=e}x*izM8%nrbdnCu_qPVGQlk7*4gcZ|x
zWO(sg>-ZJ!;P-(TH6{4orz8HnpbvO;%x{WnC%KLN&8+(Seq$##W8luB9c5BtrRi@l
zBUEqI-{_k#liSbB2S<6EJGJURTJtBe-H|0b_b6n{WMKhC>K;Ur?N}+Mon>7M@AtK4
zT6Q$FVKo{)rr8yapLfC-euD0V%n1?mO0WxoYN~0v`4lavMd1ow+20vQ#rAe1e(d!y
zil2is(I>5u8;0S-p8(DL=e=rwDC=Eiay-Xy>57hsHFR%UWE!%;g8>1J7TBC$#KPR>
zsYbAKpfb*z!(Br<$DTwNH!~NZ-jAbFWN_)e--*r31C+;Yxq)hBX#iM%^A>s5m4ETC
zFg^>^CwB#&G0?f``Vm+D*cm$8W_n}2yn~E7VLiy8s_9{~H!w&r;|u%jpfr_U9s45l
z{R3nbPt4-e_oV92<1e4Tr19^R&ksiI$}!h3ZD=_u%?B2V@H)yul~VOlAZtv4UPG`|
zLhXo`_N3VNOG6&BHzVl{)TNd<SanZBmzyT{M(>PtJ2DDiA9gv6fA0S+Kby=t);zXf
z_^o|=uT)NcZ9JURoY=m0+(zA#OIaJLB+33VAZgf_UQA-lMW!-X4?k~!qQ+|{7^k70
zgjT;8+2Fvx@`7Q+VEmD^a^dN*eq>+IFUXM)XXWS3r|qsnLM-W*iQ;>pQKJLm5TpU%
z2`3+Rw$J=l@gM|60$-%ci634V*n8U+TzGf3+q3iFy7#|kUSTjkJ}iUbtGnkaiQ^81
zaoa)FRr=p~OKuw`*RRl&lcZV#tc$*!I6qJ+oii+reSSBrY3hl{|Dd+4Uw-Elo5Xet
zS}pBK$S)2}_2}|&$b}7PgVsP48aDO<^ao%vX{Y2+>K`6SYz-rFoBqRt?QRT!%9GL9
z_Q>`f*#R+Ehgb;wL71i8)ICL1)YxYi#zNEf-tpq##&_)+Ww7Hqb3|289g0ASE2pSL
zx^ttwXsxP>%w3)A2quhM$8=9ROhR|5<JPdKfqRy6O}EY5AWu@{#llpI$RM_eVSS5s
z&!=#Y=q^n0s^@-L=-iVi0zVJ*I$NP2Qfd$mE!bHr=TD0d@7MM(YVTV=nfQ(5@@Xbd
z0WoRjDZxM?mIVgB!A&17A_*K0V_Jx$&GIz87|+3U7$@*N0te%~iLRv-onze7B-C7Q
z5inFw08J_=lTi5w8s6;sQav2V@vl<u%{ts(QMOZgRPUmixd*m00*Na*)CnzHWrYdi
z5ps7wWesf9yFs6}M4Mf#f|4cpmI9~Owv_;`Be?v~n?)4V5^>R65sV`q?I|K<Q@Vae
zf{M3dbl7E{B1OTO(``Pky0MuCU)gCW=rOEq+-Gp;vkLYSnrUIk$ISbH49eAgjUZ~R
zjO^p(k>_t88Vbi@$Yn`MnmfWA7Z~=@f5ey&BuLSo8IDovGDwL>@<<@F97w+lYBuv#
zVeW)1>JlT^;NmurcZ7BC>CqsYhlq?})2$oW0yJ}>bv`$pN(zz>j0SI3x<N06@XRep
zUacJ4Wt2GzxT2E5_I5ATEAye!cV&WgvdBDFviF9xxWV8lgfr_FWHdJ2SjfCo3>T!|
zq4f2}dt3~h06wqEx4CCLj<54{=`l76$0e>a1GrFiEoMI|1AWa>T0yoix|x(U)>B|V
z*xAo%+2=oPFXV+4pUxP9-OT4@!?P@3I67FXnOzsX*FquAoKIZzQt|a1nP?Mc#i@XH
zYNeYIhi0J*DwF?pMq>z~!801vOmH$D->MIaQMR7+$5+`b0`=gNk;t_?x5<8)9A@H+
zNenJBSk(TC`uH|2oqSWbjV>q#%6D-e=6{BP33h2?mt9`$FLBUblpx`*@(V+#in-P(
zhV!@ErnAW~`}mP){QGA0s8t_Tm^sK>J0?FWJQA9MS(+rrvS>LTxcN@a^_DpgM-G5V
zU|DB9(A9mhsa@1eJKs!=J7)IeaM(dNnJIvU+vo|S<Rl61Ti9>!z6jeFB9qi(gpS^S
znUH81YU{hQKdmR_RwlS)HVUuaq~Y5(HBN6mM13+zgbJS#D%O&ShzQGVtU<_R=>H{V
za;Azr=TCyi9b*pK#5jcR-28P=B#To-ku5~=Z20OW!80bmcbSCWCz<ey`oRH4Y@`*K
zbvg6hyWE+F<xy)8A|4*qF+lJGFpNmmCzaj-x|X5A_W_`ndhdH7M5u-|ixvHRtpa=q
zfsL+vI|}L5Kz-H!u$8rAsc9L9X!h|z=EE<o)F>+>Ir}IczD#O|8LL6!`+~uNt5SM(
zurmseo?Ej}=ZHVy+jA)x%qH!r^-O*ooH3|2LF%y8HZE=z`XOh8P<$MLY+5yOo;jCj
zQnd#b%ODe3-3r3JT$q5f;^B<OZ6~FYwL$nK{e&lcO7pyRr@IcprJk>xAT|&QZCwfJ
z=?`>8NR!}s#!fb_cJBHKGH|$&`T#_j6Bk#=@yj#i&WnhI@?4&RcqU~p?UGKcs_|Om
zDA=#gnK?YY-GCDvjk-pBv{*VqO0!z13Md;vfIkM%YcUBD=TPM8<a<0hwkpGGdb3_q
zmS3sgM*51@6$!ja>J-qBREPjpO_OsRF&_tMub0>W3emk{HvhamyNm({OCq+p@!Zag
z((JQED*{u)a|6n;ph^j--9EN#oy{(+VU4Y|$`yeP&n?i1pk3aOdglIb5qD~Btw2Lf
zAR&y`ly_sxb;UaEDRdToa*^qI5gWxhkS!!Vxr>i$R-kLId;^Em(<Zw`2XPJ#a;Xkr
zas7CB`K==d7BD^{>99<cow~d%WBk!_>8&sm@#tg|%J5)-j*kEz<tr4$tSPet5k{c#
zS?#*9?m3<WyYsQ6kmbE1#7S@i1b8auq{p7^F~-4;g|LG3^>uuLgNe?2SeE}4`~vyD
z&cwE?U#$C*GH(<a0e(cVuFq<Sw7{gy(h`IMyeY0zE+PfmhtjUZ56LxedmbxCl3(gD
z^4CXB9bL@_R}$lD6<t5<ni!@6#UG5%Q-L0yWV6Wpl^<Xp!)%&E+fXw~)^mH<A=<qH
z+*oXfKUNIlxug<A{`7C#-;SdA3yS==E=8l5{wfR*j3^9qE@pZoDkLFPD*?k&C8zT3
z>|rt^#=tD)L_i0H9MHd4m!^<S@~UEN!guTipHSYtE$5kxjfVZ%DNSPnS>w9TOk#3m
zx2iS+_p1;BhY*)9c(QSkPqlK*l1L}x#T<kdsF=JTNI)q=;uQ$Xxa(9Pn%^m>VV>iF
zjNS}@S}4syWZc=vBSy+t6&-{HjKB`mEX<l$5jYslly{WVWDk8GK!O^)3}50-=j6NL
zE2iVpuQ-7+*BqeB%RXg?9a2$6VlbA_26rpXD%`Vvyr?iXLq6%l-TCSbvVD>Qo6y~P
z)3&5t(`pMD1SSEB{#ryFmT;sa;CQb=dah>1*hP207z*8KyznU$lY)<#M4TKcq`t0@
zSNC&tMKx%3qN4UFqZ&i4>s_DY6OQBrS0eG%6%3m?(#1`%D3m#OX?6~nSbSBs09&{Z
z2UhO>&>zS0vL8(iR7-F-V-PX0dnDO*#jso<*qDI@s4a}Sn?GxU=1DvSF{L+i5A<Px
zjl+3^X>X-tz~m@{kKlrwA36Mb-DkRNdq%r*t|TGK8u2_Q&OMORT2yTBHh-_YG)oU!
z7%iWK$AJr~D12lh_%P3zWG$7(g+!e&F4HV3bEwII(!M~;i`Bdq@QRRAE(KOacs}NE
zt5z9`Fb_!({ZZqXzAzKT-1K=y8O~AXDf2HJrejcBTcjTUvl=Rbb+hU|0a+Of!@@18
zo2b$PGx;u}0`g7#Ycva2_Rn*n*A<ycABLk)6BBb1Q6(?md>=40R=%kSI_-FodO%7f
zxP?b*JJ@Nt?SQvAhz%p)E4~~+CmJB=kG*jJDci>ZVOl<}R=@bkyV>WqG&$oZ={bsG
zRV^-6TPPHKK#HQyun`=F=Iv<kd`6SDV_CM3faJTxi*U>lFcI3(GME_*@L%I0ME_VP
z^k7+L-jqL<796LSQe4b0#Whdp5<*qBs&x12`q=Lo!&OR@#t4xbTg8bc!poJ|s*!&J
zI%!bviMX1YjAIbp*QBlVIZeMeQ#*0qhWva%l-t@)Vck7{T^fO2d{!kbpdxinSV<Nu
zY%Uw@gsl#<p4kGZ6#p_Mk<&eD2K%iG{cdo5n*hJFoX%Oz$1-L2yC@1et-{IXf@dQb
za2ujG@Md33vp&0d1ab{F?8!s+V8l6ZHijTODDZQsqVPn0T*~U5#t?iXqc}e=qf#B5
zdgB{)RxM_C>6epxBF8-8R(tEI^xA0S%K`yriyDB2((W)iEaE3&zIUl?h-F%*!t7<?
zR5+7s8duo|AV<c%Mw+<*`Sz4dWf7b?B{)G8MoF<B$&Y@&&FDETZZy4jGbm;GvkUrQ
zP=p2gM-}pvENxAsYW%@ZE7ssO6$p%P`^ZPdj6w;pTNsYJg4L(b9{Y1z-i_(Hr9UJ)
zcr-GL18UMgJuTEczOh&&jsu<9knhbI>w=7=M>vUr{*t7Y<C3SlRRS{|yg+LPOHj#W
z&5hEeIx#X9fd`H+;#HB7%Okt-mSmOCr9|+pmK9@KR8pIoZ38jWcAPeVnTsQ2&;lrr
znkou~cr5sJj{=f%9szbqRIM95uj9&<*;}&c8%#ySJ3vUZmh-a`SN<dOVkbxncVbjU
zIV97qY6FkJ-4Sf0U=0{-;U5ef@HoR)w5Aku>w}xV|MA(|$gQ&35PIcM?vf$cxj%rJ
zBwH0}4AQKgO1j)R`RZU}F66cl&wCh0Dy!R>c|n(!0DRvr;R#I&P8c7^G_aSE1k!rF
zmCtQZJgcz@@&8oV0l-xo#oi_wD3+5Uer!-|8JVu1Ujl*iAHg=p#;#j=q_|}vZdr3s
zE55Z1&t4D}ms)7#!=Y-bIf*SzSLw}*6$1F}IDP*7Y^2&9tqn)DPRQ7uC-ub}K)<Qx
z?ad-G=cWFK`-zvID`}rYof9DjneXvX58#xGlf3O;)#nNYapt1>EbKpQgt-szZF%$j
z0OYG5A}Otm8fbQzK7rFT!|mZ)%7O3ly(7%2Sk&C$ro<Yc{X=2pu99XAt}k#+O7VKP
zYtMPsDy)KkAaJAEWq5Cki)NEYb=Y&^t+JhlEhis|Q6fXdJ3kyylt18Ef}(nYWpETo
zu=|tdLqtOQ)GSH&HP=lb?`QrZg|E51yNW}xZ&s|&T&s@(o&VDm99w}Lc-p==wNutw
zVZ&&6p3QVun$40Zfs(wC<|cEljDw#pF<A~Q9dAQa5aUKWzspNVwkYpB+N;J<DY{&f
z(YMSj;y0FO4-7XOOu|Ib7ziO%McQalqp<JNvkpkJI*l^KIaWpjSg?s0vh*e~r1j9O
zRcgns``=XsC1=!?dYW?)mwjuycHAjau7xe{CTO+I&N{snsl{7{wbqF#=G97+PF`W|
zrGr#_ld&!TS0M$Id~-f%c{Sez_;hEZ+6c7Ru79@;8pj2)mlx&4F3l?HwBK3P=ku0#
z6=6ktevn~-{RRBm7s`7DyAJi7V!nn#P=)66hyf{LME}NFBsN=o0{8U_l4jm*WO1EW
z2mMBGC<!hp8yb`J#-SetW%PvxABnUN@MAA*V2>xo8F1J@M-(SaAa>HN?dB75vRi<f
zCX0x@Eo2iji(4P5n8%aDj*~eQ6o~Tv=LYRTf`e2)1Uoi!B49b?FsXC}*b|oH*9f{!
za^9SxFzM)9>3bz&V}PlWb1UX9;(JE)=uB8FyN)Njq)ldwsynik_X~TpMEzb_=e9|k
z<OPP$8BkC2;`i}<&|iydxNz^l8%pt^v-NM4_NFLoiP+My+c8~O4X`w$q}hSuxcL4K
zZc;zeW~xCIe}>6(4=o>+z9_eeNS8%Z2o{x_S9&YHv0SkVZCKyG!I1|pG^-t$P+##n
z@jU9;%|E>d-K8cHyk3?YxvZC4AfPk8qM5hl6=P7iXXxy7I%uI~F1?3LV&Ex1N0%<X
zJIMPygA59f>@!P6>o-8<GL;C<IqmrAT20%%0V(t=krNK?5fUWP?^O<<S|myu7k@zL
z##I)CaI{$8-ACXvyi=Q&E)G`%?`6?I{BluMG;4E8KgComUvA;c;`RhERq5~y8hH2X
zSR(>S85`VjK1v_zxV3+xAxMEPv6c}P4No&(3bI7|9k{6@0%+~+dSmv{2w7(U^i^)?
z23}~(_$J1w6fn`lOQjDfQfa<x{l>d)EaB3VX`gL2I^ev*(NZ?D+8Yzt5#gSd>xGV6
zRQPi&7$TUzJIe^CC@X?M#05_7d{f$JTw9CWW#}8Gu>Ki7jd%xy$Z-_OFbcChxB+9`
z*J4`>f%8D(ZtrrErTxrK)pBLAJRO+p+1;#a3CuxCm9iz<a}Twv*7Al=s2FVBt}njK
zYsK;DJL+IvH82Zp?gCPcC7sQM^NH{4{{S#vT(l-@qdarH$;hEW2ILlYCD-Ok+IQ{K
z{WNVgqV(oUB^f?BdB3pXk%=K|ZYept%8Yb>Ad(!BSIlA>Rg#$P22w=;e|5r}8&Fi0
zWTI3KdT?+58Zvq)?yaa^Gl8Pbkwh~wYhcMCZGy9!cVP!8t;DC$qjM*og>&K<Vnlq{
z3pjTbdWw4>6z>{rw8N$idb6A31+8XbA9@QR)Pi|}77Znbt@4U|u-<Tb7QCAH?1Eh_
zKcK!g1+Yu0;dU^=JddQ^l~k)*CoyvXt|k&jYX(a-EcW#;d{gu{IzJ)xwDiDL+V^i0
zxBEdVHa1WCPB+WPwa`>H&1$9ex@?<=Xn+%uQ&=4*R#q-`ODT!4i>d-|bov25+jWTt
z*~1^B55F<eK}l-~$tjUvvFKiHoaGO!1Yi?U&beuKKg5&J6bbfHv|{oQk;__6Lj}2)
zPiK~>1z<g(*rz>X=XmWAN0@3^ii68;XO0b7>N~)(?BS8>4cTmr55fmwe{6#dJM02i
zPb+{5h-X|3>cI~pLm^g@0S_o;KEcvy9{nS9ZkJM0U5leB#UFtCkIFcNZkA(x;j~RO
zal@1rLBVsf5(4s%K{~4B1q1zRKu2j1H6}9W9YgJ(`TqVmN_1Za%aSKO-4G*3s%O!F
z^b&WY1+x&;L`fK{8X_;~F`g4`5S?hw43kw$1^(|l6DKw22EVag{tG@}q)6puZ_X@F
zOQ9NStt~mbzA)1J^y|0JBt;y<Ff~r~JmdR+4hnPgK5JO@${hZtq0I`{ZZ~aj1o<5Z
zd|;p&K(2%~L3^pWc<EGBaVZp+t927N1a;q-E>l-lgGdt{J2moa!DhIja=y4KF86wf
zPqhe(b3|fv>B#)NR<Qyx@Qw&XIrU5SCE0TJfGi@}A)d~&0N%5$%<-~XAMZC69k7_4
z6GW!{K;O~&<tK7jTRhacOR2J9F(Xu9Qfp?oXAxT5*H6xO`Us09xA3{nRGD7|jm}<h
zi1(ncMp(N;`q7uKffe)o0_2(KfuAOz`*=<$wJo%!<=2X&{K}L(YL{bFemOG2$N$HU
z1+w!M=K3(YT)W)sF8_WDN{T}oM;~ySe$5X@f<bT_J!b*;pFasf6fTY=v$uM%U!Y+`
zhcS?!*xE(~Zl}8u5E^28jgl{RUlN5QOzekm@+u9zl6iU%wBWCOu*eL_U#ZdMKh^*@
zwl#ZR=wu<)X>ag;TJyLS>-+B^${rkR<~_pxp5Ja!@??aaA&h`gsEg8ZQVyqte7=As
zNnG(A-u<ur+Ff$`odao=Y6%!CLwN>#%2q_zkUZX-tetlxo8iIMZQ%}tSVu#^f}hVj
zZKT0KGGSs44q`FwC-H2>D3rUy#C!*t1DjY(T(1>rwRJk&Zdu>?zJBjZL-Jz9Q$Q}T
z__ylX`bR9WSs<pCz9GuV6au5%s1&<H$1xV3e1GaC218;L<4$bn<X`JqnsqS#7)n`s
z(V8#E<AcPxp2L{(6T<M|6pC9WPhUK3w{Nu0>tLG)yBD&hmkoH!(K=&3os+()<aQv;
z*3!2(qma-Ot6^U<etfis#Qb|eEaBBr7ALA<?Ts-twVC>N{Bw}%xv?2K;sY2i{^kqI
zvDe7&-(16(6PLSRd!Qfi=u8t$WeQeQBED04-@}Tm@Npq|{qM**5hU6*Qnoulp$2l%
zzQ)RmXkEC%zRgG`1FDj7>gO(7lHN^p>3?eZ$l;P&C3*2?fBtV%{);v5^xQ%VsAV>A
ztGC~ZNK)d(FTUJuJ6l2m{UYE6ew;(jJszvBepsmai3;*Ri3FSa)Y-7D1%;(G<}u#{
zyG@o9fUv3JNzgkQRAM&3{DeN_1eva0mvP)fBj2kQFR9tf(&tariVh<hC#&_ym_T@W
zO!_BW%H=oHYZ3uJW(Dt#JQbCPang58sE2R-{%1QiP;`cDnFkMGMRv-dD09I-6P4ub
zqVg_NcMw8~;-bg;OuK=r$OlGM3(~d1pu31J5ub=Rm~lbVej<r8>M&^@Ver<JW(!a0
zj$+lV>I6Wjj8q6jBvrJu?mP1$5_DB&6F115X`t5=ZFUq;-06u2oTTJ)4e?PoBMO=g
zT)^{T*y2;#VP(@UDs8fI$b)9TZqHbo^rWhl8ad3cs1)@mV%5RXKrT;wIlEJyeZFV%
zKUdGG-7Oq4CHOhloj5n&ymj~Yj7x!Ajg{_b7;<9C8#Mgq^s2)67g#Zx;gOsc@S;hb
zr3gQr{_e{ypb66<v_ui#s=`VksW5hc^?5vhA3Jd&1H-r@qq5Sj&rXg!eUo^S+Hl{F
zX@nGrlx5K#2_@jVdf+s3eg}DmXze4QUA?c;7#*RHlcC6S@Mu@<&?NeSMA5ds`_b4L
zL`T=qY?ZJM%bKBtDQ(-3CoFf<LCw`Aja4QDn%*r7f5egyEq)p{QU_Fe%K`z#D#EiU
z=%$Do<Hw6Rsf>)~?e-+9JoEpn6tPW!6PMd*N6(xeX~bp?vztkwttAqVvYAe?<eFpz
z6*jgk?P1bbA%qV<8U2%mS&jmb9rd*3a|E>eRK2wM2fGBZwV6TMVDbcXnMb$^V!cUD
zbhT7q*62RtT9Y5~4&?_6A^}T>AZWv3pjWE9z%zF=KJM$BDDWjxy__|n`@nKo4LV0l
z#DoR-e*N@fqvuCjrXL2_rt!J4lr(N+PtI}kDGQN?DBDJ-gI*;#8MA>vQM_=mxbZ{t
z<4S~tag4hJYfIFW?Wrz<P7%IImjmS)t8@y>;#Xd+Wr1*@J)|sQVUc+TvFW3CdU+^`
z+H2ue;JqWNIYK6cM{@JKXSM~0Uedq9pz5_*X1&?X_15yn1gg744BT0b8w-3<hxCot
z-<pYA27`-acV#T!e`h?o<5hy<u}e*G1HBC+xgg1BBk%Mw)ToK(RyTLzCf;WjkTn&w
zuDAJ~sphz*cv<K9U-T%J@gjOhba)5KfAE-IDxfr{Q_z;bn<Qt(^t2C=W&Em)`B&4G
zr$NQW-@=^pLbFr!n(KGqTexo_lzj6@OB&)AC}G2|GZ*4c{)3{MU1rsx_IVE@U><op
zQj=xCogokcY$IH@r{*{X@o*9o`jvqr_jus%?-`QHX@o4r=nhIC8#FOB9?{t9P*?Ee
z>>n^Mdudc3miIez=Vk@)!sHjzs0L7M?c<xle#DtIDAH5K2xBe9&np^li+=0(MpNju
za0bjlvsSh<YyLPxAo^W!Ih_>wV97Zzk;9RXvG?cvQlokQ0Ec_FLvsdDFxyC83yP}w
zB6e&>#td|5lTjO*GS+)X$vI3(G+;kl_ZM66R7Ici?g(tRJDA5DXIF>RQzqsf4!1f*
ze*xAAgyVMJG_2y9ny%3?tEfwu6sq{kxFV<pr>e%#^%KAC+p0sqAxF3Gr6kDl38C8)
z0g1l9lOez!E0E2<eS$$V<6pTuBgIgccz8#+5x;sOo9upcU$gw9pF{7AZTxPC$C-(Q
za8doyUkt;Ce1%Y>gdAzEP&1#$;<KSV%N*r<8ZJRPv1RrY;-?PJabXmqI%u**n{(#f
z{NiIX<W3I+Cvu?|wFRLIiB6y*uf%S4{2?dC;FTDWxFkGMOw)V7Mk?vn&U%br${eg?
zzB@lK-kL4rZL3h_63;8MR$y3kdO=mDf-~JjA<lXXNGImo?jH`!SPAW~UV%@4W?9dI
z&>satdJ#W0o8(=_Ezw-H0QFfo6P|=7(P$4i^1BZtMf$aaKO-3xK#EplX!Xsf0Wkis
zR~h{Xd<Q0s4_!%$Z6}u2?{jg(MYu~g?Ajig<CLx?H-}3wOGXNWkUQ{yM388N1)R3H
ztLac^B>ETRBF|O_UT~<SC|Y*}DDT>p?#sTJDXTyRz<CgjKEmQrvP(<FGpibTx0`%O
z?qaGbL+7p6#^y1uO(J6wZ{qMM27=wGHODKH;L+4ufdcnHf2kJZ2Xhj~8Y))a2W(sR
zq9EU!%-_;L!mV+tSg`%O4Xr&xHu(vz?HwpX{!2BJU7-l>V-&$l^s2?gpj!@g0HmYF
z1Kc|#*&gQ)Yf=&7Lau$~z~KO4(0D7&6f|mv*4&4bAB*U!u%o^eHB!yJdO)9CbE^Q^
zh>BbUtJY?0^n4vif|&o8fk-e++}BZ7>R^~q!sy-dvqtE63RKah{}ga&s+7TI>)h)-
zsQ089z~wGQV723S4|?#Mev?ACzn<>pxNwo~EDT~*seehbvU_6MgA8lIUn0wH3>tIA
z9`*Iv?Xzeutr5fgBMZ|7cGY9do9H(G9CgyW9#FHa4o<q`b=3K|Zpdl~&^l|w2{A><
zj}{^10N25_yTZfOpVmbw_|{b8X9!r9p7y1d;Kyn@ic*qo5C$5~m>U@Ka2#Y#v(CF6
ze=r}CpwxE#oT^9Vl^x^u1YPVz9V$k1cp0}DH*OjW>S<O2B&qxVTnU3UU--)Lo!x>m
z_e5FHJ{wwB*f1gJw$?4I)x+rL!acPt(wHYhLi@=%5G=5P&9d<e7BBKy9+6r(7p4yh
z3<8<wj)5@(CN=zoXdZaN%8YAc&Uv&%z|2v5mE0Y-cZvYxihc;X*$dN~97`BEsu8-%
zDO20f4fHO$1YO6Yxj2Y|+r~28z1EKGzVp&xv2(dGfbcKc=83y^X`iE2i9AO)XaBCB
z6Q>?wscptA>`_@T4kJ5p5yBV<YupbDe9{+#FX<e1R1i*TaF49vZ7@Eg+~fRj_p1HP
z50LUH^+%k)mK*^|qG?`J@@1H+I$O<icLAU+*;s#9N^kLz1;wY)hMtHNwnkQQ$OBwo
z`eirqa>Z#s9ovxGV;$CShjR>M?iKlnGb2{O-#rx9IRSq8T1vA(mq4XGexc#nU$Zyy
zOH@m^{7%`}orOPn$DL43LSdY!EfsYIaDhGwdbLxZ|5p*uu%a}-3|kVc+I+*_5CE`f
zYI3u^?$NJM65-x51_B>`5Ri$4+iNRDDXS%9GXAA&+#2VTl}%sC`Jl3iWYdXJTf9K^
z)qtUZpND-B*#s+^wAtDBaS*d3R7351S-cqKL)6kGIQe%%K>KmM3NvST+xH6Vxr$m0
zpan!-&;PPr_xQ|7C3{|;Y4c&Rlsv&@Iifo4GCRdja?PY(?C$z}1oW_St7anxeagO9
zb~)_76GK43jikwDGqD@RK}BJwYW~g4i~}$;wEwAE@pd3~DpUQsS3{Pm9%1Lgki4i7
zwl0`?Ia|_GbHVQdH%Dyf{diM97Bcixz-zPq{7i~q2s_b|&MRp5(-W5iUw8FBu1sb7
z<4S5zL5~yu5X=<S;*JFY(=Q|a>`o%Dy;#=Bl<9WPl5bk*n2bHRF%{VzSt3JA9SqX^
zpck5C9y={UZ;dh7b4kOhw3rolRMec>*MTBW0t5DyOHq*S&z@V(u-iwHe^BzyB$jd|
zy=eEU#?4i5?af>ay2mQQ$BN69#L+48YNIJ}c`MNk2zP`ANfjf2(Ujtvecd9*{Aih}
z`0~pW>L*<H10KG~)2<6P<L&TR1$vCCpn&myG)%C@Aq%ylYV~Kn0YB-Y`#_dfa`)eH
zmKi4CUirvE91w*t@o-&`n8yjd?PnD%MKP?Ml1CH~b&A+p{^OxxHWnJ_>;lUVSid94
z1#gOY)W6bzU3&>q-)~-}g)T1VQkU_J1K^FGf6ree(g<m&iYSzV<K9ZYR}?B;h*3YD
zLrJ4G85?iqwGSH_FAgy6)Kxn;oD%+1Q6_wsWpo)5Y)-EZC7Z>oZ6H<j*Q*=(K560V
zZujBxRhB+Y@O&v+1#Ud8_iq`f#7<@NCB{-}9TPRbm`TRKd49Q;Wr1?U*Q(rNwoC&~
zqa+}}puhiA6Ljh@QPF<Z{AF=Rw8cCA9Wy(~Sl~6XLT+Pba(kMPjWL@!p5}M_kq-%A
z)qUz1s$$csSb1yjxlPI@H^7-`H41$_xLta_@XP2X8iS|y>=a+%?m>z;o1E@Px)b`q
zSl;6633+M=?KD&3d;mL5%a`kHJN0|>$KKa8jaB(vPc(?2i)|&8Rrsy}!JG(*L9m9)
z$GfS&9iju_Q0zv1pT!e`dD>n$#*<V(S?@7isqTtmOD*`7^X-&11fLKbUSa{jb&-|W
zuRe;yiWee?DW`094rB$V==+aR0$Y@}if1Oi;#(!Xg;$4D1Z#DGmz&U~L`qgiS8S(H
zsL$h4ul3Ofr|0(osc2WIh?@84VA(wTY7Tl0<A=@u5wkA&k5ryiIF;-kH+c5TzHKdr
zXJ!iJbYjn```)=WjZ*j#AXpfp{TPKBp5~N6x)m6T_^XE#229tD=Ca%IkFMTUk(%?j
zxFJjFy)Brd0k-3&cDs6seyPGi)i)Cd_!3j2nLq1RM6<F(cx+i?7T$NBKbCK%blAQZ
z`vnCJnU?gw^Dmy$YH0}YrIkqY5Oy7xW_lgCq?E$*3iuBpWROLk02=ot>TwmpR|Y#L
zvAk@%qdS=Ox<w~c@chEmP~%h~`W5Lm*Lv2T3(PHuTdb6w0UMc*Df}ooMlh3?X3sir
z5p0~aVy$CA4z4~B+$kGBKRopTu{BPXeI~cfp*DbV=DYUYrp_jLgh=Srs@OR-FfP17
zz$}`6ZUS?Ylg2m1kRfX}LqxEY$Ctq2%UKgG6sPgO%T#c>ddDf3?lbK)nlc;gwf7|W
z47As)bmtKenw2PxwXZODmuMt-S1#FORqMKl5w|ZHd`xr<mH{`WKMUD={l1t3hF3^S
zxf{M5^+WW;AoM5r&r@wztp=C)8CA7Wd?~8F;X}uL^U*Z8NQRA<uXtKbai!sH$DKe%
z1?kNCco~jEkkkkwI!pre2&du3ND2CPFGZ&s3jp2Gk|LKcwJ7&dt8c=nNL_zPh$gu3
zHgo0jhA}$GPXrEpGa+4ovTaj_F1cRo`BWHo-@wiFzn`T5BJ+EH!b6FREGjpTc^jfZ
zD}CRa+R+GqI4i$1DJ?~%-BX0Z0Puae%s5FKcu{I$CY?&`1}O)KM+0)gv1S3DoXmcO
z(vwzBx;E`QOB02dfGI5mX`k3}di{PBNmR)x=;(Grc;RGXQZ`o#i^Lw-^45OgAfT7=
zd{NJwWEwo6ZhgdthA+(`-@zM%)Fq*8uh>nn1bR67X}hr~B(tKd9$8?LnB_gEmOdbu
ztwb(i>Ugb#^8v6C8Lh`y8)qRUQ82PxC!z#-wU%%8L2mEF0T5D>N7lsKmSb)}T!V+L
zf05_Fo75uGdub=ThgB)ob`@lq^HZO+hkrAe(oaS;0S4sL69+{7D)86a8Fed9?a9hI
zZ%FCdtZAoq$s4Y)7&bk&++rb5#KH;E-m6hm6CA|N!cb`~IUO_56!!!aAO~XaP;3cw
z&neMqq7ACs8Ldj`Rn+f|hi`s3K}U1K%81(tUyU#0Ye{G^qb;w6y4zD`q};qr?DJ&Q
zw~gftyw$h)loIzz5dZ>QZX-V6x%^d;h1U2iIb(o3nI&uCTpwK|sy-c=gIsb`AVpmy
znSS$`d{qukNl^XdSmg%heZ`dz7jvNp7C0Bq`Qg?_c>AwM;^1;?SiC`D>Fd{oFv)-|
zC%mS6Y(A_2rD)gq<b8b(OC1Jq0=v%@&|Ee(76*y@*mk~Nh*w%kQ{RBOxfM&~Cy@T#
z5oB93SRyh}V0yXxtqtovM(TK3GM*NCe|wOGIqbD|$YiESFXJQ3!_37Wcg1-<9-0Qv
zPLi3f8`ZNdk6wjLUidoyU1fWk@OQs&;_J|)8FAJis%8k;l%GkQ0Tf@h9FDL)Pgr!Y
z6b6^}mK{Ogbl90`ub%SKTmAl4SK;EzW}Wet1w_gmN{sGe_^fzydkkd1Lrw`}pwMg>
zM=r<HXNz2Jd?5}M$figlg+wzuZ#*=#4<VSH^P?0GB2=!`k<1GtytEG|2+SPFx+F~&
zNDAxS{fX|^DQm3;JpvJ5vY_?X=2?N4WwL@7=q2N!Qe+d+XI`Rb(!9)IO(*rc|7Za@
zOtsrY;F>`u3f)cphlyR9QH&&4g-R`b6+loX6l{&k4=^=+m<`O0O~ok1O<DR{dCk{h
zmQ@0q37d!=*r+Kn>0wKR&Nedm9+swX;M9W>&r$N0hNwZrre5pCM0(SE$SW#|k@KI<
zK3Wshh2s+RR3&sH@Gr}^e@5(DiqT9Pk4$aLeFT`NlT|&;{bk;i-w7D_#Y_sWVh&Ww
zVMt5ESu=_f_motyWDoDExEPlB!Qn{R#*V0CX}EZ}BiL45B8M%Ov*sOk5;c>*RY^64
zYkeurq6%4HtZi{eiy1!HS{-CGwI<6jtJr3`MC^z!m{Sg>Usp#h@Ce>?cCI&VvKyA!
z=s_w+*hPf%0l_+bH5cXWLiW-syy4bGD1s;Bofe-Ru}0o!4qDzzAd!9AsOBr1eXjnT
zZvG|#eZ30tT#`%BoTKsiYZ<J*H%yb?c#2@y^4ya;l0R1U)giTu!VuHlu#uvPp$zB-
zP$)ZEF`7ckPcB@3!Ox2neev}Q>ghLXdDn&4|4j5o3db`5MItrJXZYKbhA#XwhLhXz
z=7-1xHKLz7#nJ5aO!YCyK_45VS~+ZeJwz3^9;z-_7*M4?jlJC;D%}hRKc8e96)Ss8
z#<x55bs@@bW?5lO?74q0MeZ<r;yteBqvJxa>309T>s>&*XW<|V0*c9R8`9Ln9Oblw
znkz8nS+y{NFhnvnV1(98R|4d3*dq&J_i?^O=P8D(z(i-Z`g;G5XW#8jI)=)*izU6@
zjdz_8$UD#NC9A(Pj29YJHIN~5&djUkLd31_>FG^5RaBy!51cey3AOl%=Qh4+3pN?J
zs%P}+OzlEDFLcVe8&(`y@mVB-hPVGEub!LzU{?Yg7=RdcU!ixGu-QbCYi5@PyrO8s
z6;OO7pPUD@_0IEzVbD_i4JeEEj$W>$L`>+sf+((j_gKqA@mo1(hPxAaeP-cc&46~u
z05?F$zcIA+J%Qvk@l|&dyfv%+1S^vWU>ObZe+Kw4m4B?!IYCnjCR-n5<FiF1@sj4M
zis5yir3EMRklz+J!pqup$2j@$Q@*V2{kqkD^&;kmuV*=}=iZZ(;@tPoKi{gdN4x_8
zil?f1mtR%JNvW~4p9-%dzXI2DHS9E~S$eIUx*tocIYTFJ+{UsPMtWWDxX@$uI5yb%
z@hKnwss4b-`FMr8M$h6~8s{;J*8(tgrjX-CQ8yG*>)g)RVSOGYFv-$N(2hGL?t@W0
zr(^1!ch|CC3Yowk)So>{C)?Y`CXQkdRlw=&**Spi5@|sdnzYXR^V9rG#~eZ;qjAjL
zoLDJ5DmRgmzCg#Em#dknNHUQr<bglmf^Ek4f%b)MzTpoMM<N%X6!DlZd5yWnf|bO-
z6Zg6mCpLa_vqzLU_DboCFEx&Uv&qVsPm7pP1ZqW7mwB_}{yE5XY5bTEj9G_2avYoV
z&^<#_pnz(=gaJB(ZnaU{Z^ai?6K<RX##+C8KDJEA-iV|NB!gU?)djKQ1*5XUIg3SI
z7XO+3XRE%<R94Q`oQ)|80x`mE1s)m)PmcO=MwEYqf}`-H5)v+Fof=aE;Th#BVb;yP
zu-R*U+>_D*H<|+1Sel_hg**Ih8q>mWqAWviF3y{NMyfYh_@Rp|vItwWI%-FsyoQ&+
zFiIW!_V4L@f3yuXx;smD7~oxEU11O4y-~|A*1Vj1O$a;~O>au|00pfFAHlbf+6l!}
z$*r;4Jz!kJ^?>5R^I3{wusbdQBb0K7eg3bP=5Fw}ht0(AnS)4v^e8J_S(8U`knL-K
z`CH!_N)Bg=`^J~=AuA+n=f}D&4aqERfda;4<7KJxhK**)0_NC|qt~($c`Zp;f5cEg
z*OT4?-D_ersXrLq2IKw3OB+W;Jh=qqCwSweXJy$10Zqoyof=Zif1uTLLVqLFM2eLm
zkbDE&P&bq2aTVC;ZT8UvEzmQmMm5xPi2l~?lhADAe2o3J!$J9%e_StAK(79oFCfVS
zKs>^;t+Z>&_bYkRJQ=BtzQ?k-T=?ezDs1cW65Eo!9aVNQk0FySGzgKFBf-C`1;Bc7
z!_F?u2)<9h?kMp_aENGZyc|g&CReT!PX4EdMw>03yrs{%jAh_!j(vFD=$X&++bzY4
zay5qiA5-R*Lsp_=x!!H9uLBUpH=cl~vEjW1u9*UaXMm_QeUEAGWyVdW%MfDSt7KSR
zuoTV70wlR_YlhjuXwKJ6sD5)}R4{cSb1q<bNtl6W7ZrN4LDGIkRPtQdqlDr)x5Jdr
zAL^((Jd}z?ZKW?w29f$$f@YQOn<OZCdcBpkUDKYiRP6Bgc#S=PYJqgR!KvR3;`_X^
z1DkQ%JsB!>+b-N67Os%h{sD5LKQe!S(?ZsbS8p!CqUQE-C?h3XBlcw~z;oK{Kow+F
zIv&9%)6nnE_wf+I%AjGKs@BFNkNy<(Peto;Mkrv;OoNbn_5o3E@yKgVzl%Wk?lAY2
zf7lM`tB`RHCkbc97gF?D7}iOa(bypOmK4_!q}5GtLV{62I(3dn{F&jseQCXz#6mtP
zu7Fe%)YF2478Nj=@}*akfoM%<_b<pB+sML^-72sxul+ZOu0MtH{DlvVE*HR3Zd6R8
zLC2mIap_B1AilFH&qs-Xr?*S?;2aKXPk2pC7Z*3W>p73>-z;N4#ldK7JP}q)85`~-
z+Rw}lvVSfvvEpt{j<nV@8^Rx)BxVQuKZHY-@fC2U)L2N}aH7jHMGRe%vAS;FL3jSm
zr+_PVGj~^x_h3x<KP{%@NE6oh!|@M8dZNap?~JZmyl8yG3{RVICv7AgqTXgl%x{kU
z6%UeeA)EKp3{+I3EIPqZJzgcs+~>2o@GbyEpkAl(+dKM7#KS%wh!k=u94vhQqjgoe
z)u%A+{+o3)Q9WT(ny$x-*-bP}5lBb+F!^&9{|f9Plx44TIr-w;C&m+2wYHc!^;5Z|
zB&=wa;PFCufrQ{w^O4RJL|jyMzxQ=W-##}=A^`I`DWV-b@kPReZ+n6R*82GXwN0cV
zH0|Ar##xXj_^SZJD?LN?JW&dzX9Sufk7W!`>*I$Ta4z=`b<mxAX91gZ12)Fsb&MU*
z>(P3Uj<|lpHQ&>`Wu?c6kOMMfg@zJfl7X5AA8D}bf8bH7ZXyUpd7<F@B``4{SS@3W
zja~XW&GSEZnZ|_N2SGvtX0z*80>a)uJ1-tW_bo@EyPCpftoHg^Q;$R-k;`F^4;X?n
zllB2|G&4p=z`chm;rrGJY=<g#-UY<$vrBKi<74xEmlV4E70YsSa)ke2-CAtc?6y%1
zR@Hx4Io;{K&^vDCdasYV=(|=lxW0{yMitx$O%R)C>z*)VusE@Q^+i@n$Ji9G<<)Sg
zk+0untu@%s1k#vGFx)zn&;fI#(z|aSvktdjYc!|bR1nq34-U}R%ho$BSM~5S7MhA!
zCrS9v{cl_y53%<H2%DN_F7QcerB&oO!yX1iA6q7!e97t&E-S{#;qkxjOi*2?PpR5P
z4hj^M%=ZmDG=1{%^I{^+<^H^YZw={<A8$YYQL~d|^!mavFv$~56Q1sxBB*eZUALGT
zfSdv!R$_Yy6dZE#r~V!MK&0ZZ1{zG?p|9iB@qd|5F>xByYK=HRH8pHO&ZoYOn$pwg
z$O;6v#EcIGIQ88=diMZKV%9t3t)~_$E7i*IXfiIyBy&fWbt4+8iZhdRx7t!Q7UTqf
zJ$jGQR^f(-n<CR3{*tBxS=u(g*~6HiDbV$uX4>Shl;)#$q6TqSDrAn)fq`}iju04N
zsro=3AUqdb6m=Y{X@SIEK3U~!+L&IAphTb7+98>A)AdV7WAyiq>&A>YcrV~JMyV&H
zb;E6~hK<{sPiuj}V+f__+fSMO6M#fgu(+IFYSTvE<ljuy`9PAm^haTV%GYq|H3kq?
zAO_$qlE$+r;aaQ|??}tJ_Y1Usu(kY>2iXH<VThYwLdugOFMjkD|NjJ8N;IcwARK{(
zmpT&Dk>5Zca(?euSlu3Jveu|=mV7gI5TE0l>-2w?xflGT?fACcBH8T6l|rs{aj?Iv
zDg+8SQJe16?O=Hgd>C-aqAV!p1br(iyIbTi1rl-ESTq9BJ#O}L)_pR8lhoOd4(ORk
zG(hO%fVLyH3yc&?4r67INNUi;9LNQKjBYz^iT!*D;-{@=&RZww)bddr2sy_oPisSQ
zTzm)2clf_nEyfyyg2W-Ivp08BTxK`K*gfe@6gNN)HLjw0QoQ5t-~mflugQ$G?P?(`
zUX8~hagBdWIGIC$M4I5-X(CGBnYr5UH9Mj!uLmdP^JvN6ba#y?I`G*NCNm%O#Z2BS
zd~uWe#|4@@g{B=f&{k*1LO|-okH!O;WnFw-x=aEj?2aWx4ztrG*5+msafcZ`iO>&f
z5elDmiDogsZLl0&6uzrn0NhupE|drum(Bc*5^r`Nu<BGOv3X{M1@FPxNQIRckSF3*
zFM9c5>}vc>g}%;l#>MlQELBtLmO9pK!s27Qd;zV!qn-YbJ;s7|AciwNgru1R^v)Fm
zp1CrMJkUy7C{4jtj}wG>d}TR9&rs5RW2eBuavnf^j?bUt7ltx-`YX7WaiS$Td<sY&
zW(P*{<!yG66|3&)xn(rIr<~H%A_^(P!%@5_!2a`iZ#7_y|8Lb~JkCU)L(Msr{!zJ(
z*a$e$YX`1J8R2EFXrxbv2>=SYNS%o-G7qKT#T0ltH@dGBF-bR+mALEdkg9l1@#w9&
zc{t<Q>+lxsaCR7qZw-_iZ+B!VI#TMuWa<&iv#|~@(_YH<)sj>x4LI*%7Y%eCMc}P@
zEbs?ZgCRe4#u<R6vt_}GkMDTJan9`MJs+}@$2#4fn^Syj2Ai0cCvq}MS{-NSr4dj;
z5odR170o#^szgfgDY0eaaXxe_fHoYOkLB;@f=0>7J@N$H*gC7pe2%hTZ(?4p#qX<h
zT5qr$v9CG17wK`aB_ZX3Aqwd-P?Bj8DMxe$W8f7OS$dbA@hG7>(4<9TGtMFys;VaL
z!1!syW@QxZ7XM<?EFQ91h^yvAS`$UgU(8kDD>TKf7D^d_Q!5|R9oF{C6CZl<<K+b5
zBqVoo8yZ}%YXyl}_Ts8P8^JDRxu*i~Llil?#*By)cXu9cQr4Zw!3t~*7&8Gu{<%WN
zyd5HF-~^9CcSc9RJX1MMN-J7hx#n{yf7<djxs;t4G<x?L2x`(^;*6{?Z+p~le%99A
zNXj!QFUW0J!0tQ85>Awq>`J&RG`DfG_xs1_Vcj>z%Z??<Nqony_*DLFE;91)sjdA@
z=Iu(L3LluMX6DQfZKT{nt)AN}Nf5oC0~kfd>Nw4qL)Qcz%T?Ywp+7QG@kNpLnD7iS
zu%2vQWPN@jt`7qv6A6uu@SOFjJ4yLrhm!OeJMB2qZ+xobEFYTQ*Gxp^2)^_OZT5Bu
zP)K8@V_<QT`mPQg<?AVkQt4xyvaIr=>2IMq$Km^oDy$s-pE;PZi5gwc`@~3w?{C%3
zpiKVNq$z3)q*!e13+26s1(Qfl5fDg&!raD3SjN3sc9-wJhGHE@Nn)D$fW8j=n_awN
zj9}j%Ay=6XuNRBFZ~<Vq$}qn={!up7OB-=j!t%77WlG+}k0wY%aehQ?`3CAmMQxi2
znXvadu*12+j7vnz>CwNj6!q76uaN{M{_nmE6Of3eZ?`T<1(`=<_0nGWoLt0EO#J7;
za|JdftpnkDh0bt{yIU`SMO!CE9exEIZv;;1!p@|^))vi$?!H>6CV>{&R9p5^{ZxP)
z^wJ#kT)i0GUFr25<|K+wHgkUbJ?D<-`#B0Bm*gVs$kQYJwtnA9AOT2f7-Pw416SF>
zAN&wKS9$TKk^qc(d)&aSrTJYtUjV-r!>ZT)ETUhiZs3_N%%}zXC`kQWW@fRtL89WI
z{*{&n31Mod@WPMWD~1Ki(`XcxxH)gbORcCuEOEIjV4&btUjk}iF#%fA!2<K%FWYeA
zTS#qKWgbVoAnJxBp)7V0@TLkg=I56#;|ir-yiHI|@Xc$qg$mI~4>ybwk^eD#+e$z(
zFX#T+gORI=yB81}aZt7-K$^EJsCHiD=hqTW(WRfxG7(YqNpz3uSP2-P?(=rSC`sR2
zDn@?%Dy=_y4bc45(#^s%qQ<5T_v)_JyIlZ3x^)}h(>n9!!Oxnzp=8&`LgF@NLk`UP
z9Pso7E|?LJnF!{YnTE!D9Wrhp8R#{m%NTCMtDnd<l!H(3<$I<aSEx+E#spTTn!D*;
z5tTkl6NVdv&rK;9LP)o@UrfFGT)bO=uqP&i(FH4>2JoH)yPH+HDo|X!;O+>mNibot
zIr}gN-Cx~_@>p7q=GfqRlh=CB$ev>D-Dyp1IJtmZLZ7`z--J-aKFhfCQ|{_&LE=wQ
zOXBTNa?jQDaFD@;8X^=-+cwVvub$x_72=y$CEFXI3?_?}WrHl`HA1teDKiC3VyQFy
z)C4jjsgI<u#PXm{oD3T=EMht!`bdu;zjOmE11|*)Z$&Q;=N;7uFjQi=zVinEZ`oEa
zc2VC>0Wo)Lk&h0fr0pCG=8rjyY(P3%>doI3KT(JtBu`}Ny?|ekabq5Ryj1<m`7U*3
z`VvZ1rQZ+w6;K`gk54bF)<q=hoM0TalQw~q`VZ1`KqMYB5Zyn+rUk}Ed*0p`@rRhk
zLk<j6)kzeXGcS^)O23A<#3WW7CdHV#?7SnKKqxik^!^h|vNWVMj<SHLd06-)n5hJB
zr?K$w2w%D7AUz5Uc?S2taC(F51bmR<RYbQwIJvtsj?|bkv@-AyK(x8pJn6AnGTZ9*
z8b1PNph*dLtNn>`urq*x+3rUgvkA}4JEs7{Mc=}<>Rj!w7#zP?*)o0k9xt9UAc0)|
zxC?-;^xE0BNVARpd}Uj5ey=G>qksg}v6*cr5>ie`^mnjs`o29)7WKXrM@%3nbH2!{
z2wTFJ0jffvnl@WyBkAWRa4gCjoDHxOZPc@!S>o|cLWKn)Z2k>ys$L48i=K@`a0uM*
z^%LwxQVH!Pj@B+^%wkQj8F~AWq1tt^Bu+$HTk1xpMM7m+nb)FSfqaK-OiXbRfhlpZ
z#q|4Pr7@y<MU{mPZ$%e@vCBi+xlOC%8^d;OVDHr)B8C=rl*ZW<{_`+Ue^vM~t<1Fc
z=jH2)ZWVgqGjLQtzv7uor+P7>1-v!h(R%I8YJ#Vt@n+4@rFf{94E)$BXfu7m@sq0H
zQpN<B_N7gJOu;ws^+kgZ4}Ddt0hx1oW=H?T<uBPYN6uKar94w9%J>!2L5?|4dO*5I
zHt1&?>jHPRE9y2IzsD(^XjgHax6=2#Kdt~gByYceQ}|R{CrUn~i`xvLJvX^a)i!uF
zY%FE{A>g#-dT$|`Ms?}11_ZJzz)|vvak_+7h42_oAO@?5Ko2`vYjG<I9Dib}g#HA2
zoFc<yJOKPJhI7g)xibj`TIU_P*L@8y-Wm~203z)aw*1D{59j(R0<@ADp=DyCV8eFW
zhFgYGcgu-C@P<~vg_GeyS=aK{#(PcQ@<>TYe2d=-j=`ZJ{9K2CFpZt<=a9w>C4C*p
zCqW2Za^c3_w*w8`7wsz=7uC=I9E0PpxAJOht9<cF5_dyj&1Y+$AW${BOZ-hf<7I#X
zq_<{>0`|?6S92DeK*k*m=`#Z>3$l;7oiZeICzQWMQK7u=;VE#<!a#rHHFo3Om*zU5
zx%8a!!@fK84IvURdp+VFqU$*A+fzBy2>)qfIpLzLT2dfFl7FB^))mNs+#mBpHSq18
zxIj}HR`32nDw5`S711it3IR^*u2uHMmFq^AE}*$*rj}o$16!-fw4FIYk*~?yVN__}
z;G~g+mptH;69bGgw#+E_8jW9xUTxIa>@C=bh;eC1yPSSU4G<F{ucom0zBwePVmnMB
zL%?g2PNjT5vR?-PHY#G)S3e0wf}-CymiN3K>J4p^{Nor^Sy_})qtc3?v4hjCTd0Cv
zhE=(@$e7OLb8UiFC|1O6O@b|%Qvtdb=-A};<X8jIFxE`}VzREKzYxS0A4CSO`*?Uq
zA5Qo=8!zRs-ycIF1laXY1bAWM(X?6A{XHSxbl%E*B|Ap+v}84fRPn0HVY(wh0s$6o
zMX1iS_1WQy&3y3b6y|?_{Zp6VwKUyEfx{V8v9D3=iarth-g;;TVuor?E^+tZ;f2*r
zSYk<nl0al6*<DBqq7>?g1-u%py%GJ3d$R^Rvc%*lWkZ(_(YV+}`j%Wk&1-^U++P%t
zmW2A%)72EF$_x&dx3?BE{3OTIS<0sbQ}j3`>rl;AP_H$~O@g>^)b4mX>9Svn3eH2H
zOBA=<Ei--V=L60gYqK|2>oe^nAuJS8TxI_BXpDj~S9PHojehUWYCzY2X>OgwQiBV5
z8-nsZWYB$UL6`X*JCZZ4{Y+>qE+Z0osjuhIBXMoKVcvn@wkZQ2tQYnrL60k;a7>Mm
z!GlZ7j=~21ytJ6#mPN$csGe=XX-e6t9!cxDCosn!M!Ey2Nj$&eN*c<<!z-<t7_dXX
zKq;cwwEF(gDlQqpbi;Pr^kiCViy8?is&0FDHMa?AD7i)m;jx!*Qapn7@R*G}w`hIr
zjy?BiNLSz|&DtYmagPBv{`Ov4l%sv|u@VD&Jcxykrk_*HCGn-%Ye%V6X=4m&G<_a)
zJYG;tv}*If;_b2_C~?zt!6rOT`=XC2tAMcfBdT?B`@0oBC;3yvZ2rn;?msL|gg^vB
zCz=;Gpa*f<%~v^lKO3LWovPm$VRR~7ep<NPypYjdB+UNCZX(TxS~yThxP^jg&hu{B
zZw<!?&po1Kmz>L^N(MtYil-U-c}%lNN4rST8M{#0nBCM#tYu9osJG~slXy(Qag=02
zs*<W2iSp=bhnBP!j5F#`p7}o=BERj)iJ(E^T=HSQWi```VHu}O-YSwN=*(6K*qo3j
z5&jCPh|Y7#*0wNcfV#BRtx+o%PRjeG&+(3|Pw{}fY-|-R*+TQUzLa;>@O7Uc$4e9i
z{A8X3xZ7)&R^=*HCOWmG5X%+j70eLnp#X!6{WU%BpG^XTwvh^RdFaEbaZ<(}zvRgr
z!p4rHXS0~xGdKhS>@J&~NWI=bN?s4APNF|!(tE75fIR%po$#%c)hDC08-HC{?!uLP
z{j)3jn_7&IV|_!c0X!Fj!Wz0*shN0HYbMM+gk><zJhsY9KyMeZC-aCFVacki0o9E<
zhc_=0BIq>6p9UxBN0A0pe(H8lvMBAo6I(aXA&}UW9twcDc#MtX)99GlNI&jy7=+>$
z-I8f$q<;6RT`q$Rj#du!HPV7EL7cLp{U|e)_QaU>-mDs?P7ll1+^q+yc>yQHc@0mm
z)O?ESQ;aq?0|ZHJ8=jRdE%tA}rO5_>5;5nQKtlIEZyPKuGQv@-c{4!>1dW_3D`GtN
zs>d2!Bv*?wos&~@&EzHyD*$W_BCVH=dbgA?fBI}UVftDW%ej_A%4)rhE5#?|FH(Fe
zO>*CiZk#O1aQG(H@+*~^BVrmjpQ;=EpZ?S=&#(53+rfvS=HIYCcVs$%XZfXowx4qU
zVp1s`ic#nx`+LC})E8o@BaYYEnw#y*(7&`o*AWdfka5YM&@Wi+9h`7@fGgBD=iFC0
zN=Yp&wk08hBTZnm4gC)|W63~$UD#c;oqLC~&#liz-sfU?`Mr{rYg{I?9ln4d6`)%<
zn^pS6i7@V&Di1l1JtzW2)4R@1Eql$UYj?9xgW?8TV+dg9GU-L^d>^?z5)d60z19}I
zvJ;-|%>M7phW1h_k=Ps$KF{X>K#|J8!s(AQN4?~@zaf+Psmw0o#GmMi5lK4<=Y>8O
zt+xxf;iT9x|Eegh2F521nQiiZd}*F9l^l@dM-tO-dOP5?XMLP|Q~Fm8ho2qm;QT-|
zhjLkGy6`*KAP5AQnfgM)x#cb-|1)D6*3z2z*VY(G5!{+}W{l&qa3;k1Yer5B^vK%D
zlcPJS_vu?SEtf{vt#Wlh%G}Y*)a0xj*JQPtiLv-CKl-}2^Cb%*o`Di6&xK#OPevD;
zM&VDUol{*Pbn$l;=W>$A>o2>IKyX22I)k^%35%D*<Z&(+;Xxx9bC4GZ1RWid>jrzP
zEcp-JL<yE2<PIaIU}=wpPv({3A#-nW`yirPjp2>!q(r#NtmbHkj=5diTN*PQCbp<w
ztni$Mvq{~$^<4f_No>Qk{`-_lEF2evN5?(YMVWd9!wyGqz8~L8mOU<rwHqL69*RC{
zYPmFVg6nZw*X8U`zeXm!UQukM|E=m+Q>n?O8U=s`-OZg=RTNI37@w&Hh>qJ$3Y^}q
z5303N^2;LJp#ec{wE9Db@l*T47vH_kVA#PE<`8ddsoxo@cSNeK6t;?Sn6pIuFnE8u
z0z)1%V$zhw0G4<y%@Gk)oSrtbi}JA<z>kW3sTcJD2`VPU4Ab<uZdl;oNqi`}u!FL@
zi{;H<+VUc^<hIWcx)koI0>xg4M&W*BaP#wpOimh+`ew-rW44E#K0s+*=E(8EA{Ej9
zc=5c&HGxF!{icTd;cH+j0W3F@q8q>CnWQnq^u@HriAyHt{$e49u*0W+b0uh+V|#4c
z>Af~#<S)*r(G*&>vq2A{{hK=On>jf!(g<rhymi(v?$+VBJ2D3R$Ahc8IU-FlG5@JI
z8JbtrFPr?W>LkM+pIj$eLDennHo3<|-B-p!Ma^DCOQ8-(-@plXv>vc{+rraN26y8|
z|CIE``<!LCk(?acc%nHiame-Ipyma$8|ZA#N87yQixo&`Jx_9k)dto+$SUA0DR>*~
zv$kA7<wFYf9Bh`U<l|*m$YBy|h6!(yOT)vzCZo0Ez6S#Y*F5d0X=*ZWhd^<fha4%*
zQE~v@R+aN8#LT?JwWDL&Icmp9fGWuZt@8mlyBp`U@qe5&za;f^o~Uw^aeFb5E5oe{
zQLv#Q2ITCU7gtjUns_s1k^N3IX}Wa6PKD<#zm{ZtcOKzkQ?E&O>=l?5Zlm2*m0(t3
zJ1`LDq-p|*FFd91%qI%j8I2KAo^F;uj$?+Q^IelctAL`CIoQTnjST#9&$(BTH;H_Q
zifH)QUwvg}<&~ld-&du}|9!~)iK}*MeoUU4OnVLD+VJ-T*LPn>4&~47fNMp?bxT=|
zq()kg)qp7?vIZWjZ{)YcCBh|4^uvNv4QsnqN9wDANQ+g<l317-#i%_tc4r%C|HJm=
zXK@}8Bg#8iS&oAhtbHv!S>59{`m^h{f{w9G@0hUexX(ap1@CJK*!vZbB%oM@u)8mW
zD}VX}g}smrVrA$taOmD<9>1nemqwl-(r?ZCVy^{#rU7_Yov#59tC2))xNQn?N1}`}
zpRmR~KRx9oR&2LBOEqjh((!XOX~skw=S=wJec=v40BWZ5m~CcCcF-`FS%x-;K5{{*
z7*Z?8*Dx}HR6I6_#u~`K9H4PYId}_{<tp%jl~@E7)?XOw2A`j*j)Ouv;es&Gs{w+1
zDeDgltuDw`-*jM;Dt2pEYqo;do$MkgLXZ85<OC*eZGY@6oYCVTPH@nNu~}%RjBXHG
zOM9LOXpdVbXsG9MpNZklkd1qRk!BZRC&5zbH}U}sG!@a&z-*2Xmo_zNGR!?uk{Fy+
zeI+>@_>+gE>`lpLq-7y^uaA%qRtO~(chhiW@FT=Ru#}-|)k*|Y7CVE&hNwKNiygdE
z-O8Zhpe3i+bVhIEVX^oGy^Gh6s{>fi9w^qWkSb)A5}ad3=NQ?%g2Yu(3ttlB@V;us
ze~+X|exh!x!|Ky_U6S;i)*@mHDRAh-;#&J;5E9|7iK;dZDl+;VRyS8+FDq|~mapW~
z@FjS11bts9pO+4;srD>};+5EZy#AY$L5|=cJcl?hSDZ@SgT3UQg8n%%ph@o;nk3AK
zXw?H^v1+KLMw`N-icLs#TvVGnm2BA7wh%GnzEI?;3nf}d-lAu8!!Hs|`M^DzX|jqM
z=T3g^$fZLnTBbj`5Qwoe5ETI+Mo~|+8}i9L{1}8Cq_9z(-=$a~y%Ta*<YB|=tj+Nk
zQ*xPmy<ZhzyQm4b@B3kb8p_boo4|3r`;k@xJCagVh8Kkszja;N_cQ>o??kWw|9M%B
zm_f|`=wZTGC51YvoYqOA(<~$30t>eN%@e@%`@lDA={l<(`a}^0Y51lYH(G}YtUzZN
zQ2DR_kPJ1-xTTFXXQ7o!yM6^}9DSk3D%22wL0p|LFs#hy{$WCWxJ||E*|&gg03#Z?
z?LnVIJcxVJYbgPOfq4rrL}lCw_ZeIrDLrj*Hw2A`6yXPmH*EfAiacb2hE76p!ePH8
zdr~5~?p-wC@S4%z1I}z#i0TB`Y~Af!M{aZCcwrAQTlPJ^W_%Lu5)|hm+a8~W$CCc6
z=NV~1{B<f+XbHPcubDC(iQx)SI!un$5(hhE=o57KP|AV%%`NHpC?`mm{ozlUwt{b&
z5L6pZ&G32-711WSIDz<!16#F{XJxJ-3}LN3-m0wi__l@pHH8n3SW-&BE7xMQ<3+Tx
z|ERAn(8VR0&#l3PdPnwrXpSuHD(5epHfT+Fh$Hp6AuTo(q+^87KivdjZl9FKC^zkj
z*rAY}+gO{LLGiT~OSfJ6q>Tyt)|wOpAci*~jLsCmAzfd9@tQKDUd;Z<ys6#BPw4|b
z`O+lH{!14OnYv+>HogGfmgcSNC!23N*YI*8TL8T$dH8mi^I|7$e>#Y>bXM%yrd&}(
z5`OzNKv@OSfv}L%d6<^*K#HR7fud>JD^Q@`u<AIoyA0X1x_NE%0uQObHb>BZW6%;@
z2%|17pL0YHM@EviQ^DcSoX3we;HJX;guu$85k0Tv@-{g8Q+9FLQ63wLUe6&mA9nQv
z4cFL#C##N7Hd(PY^Jqbbuj<}@7n$9)Q-=}&%u)Vn?C?EItzmoLOSsp9PyzcQwlL?u
z%`8+S4Sgg92{pp`8{Z1S+ROf(&+bG#Fhi{Ij?biS1yLcRg)nj+kX375ZKoZ$J{rtw
zDs@%jLLPgrjgoZ9t1=;d(+s(bWF7lRnPJ4Ju4J%!OzZy@=$~Lz$SNL`XZ4Z$r5Ywn
z7Wj!QD;Dpc^fkf=l-urzAX8?{o7h~t2(|Soz-O?GG}-ARaDy(R>oAwC&3u_-yMh3!
zy6>i;GT5Cpv^&#yMG_hNs2KAT!~O>R`{W@^4zMz-AYlj)kL|8IOaEoylhrabdv2V2
z%!1Noh@Fp%!NUsyJKjK<;Qn7)AO(L{yuUWEAofHK19ri`w1(gVK$dirIt<R4>v;K2
zq3KsP*N^-!zP9v17ZS_KclqNBNfIeS0p?0ELmP2j2jqLbe0cXaiOS<|o<wpp#bW|~
zv?o>Cr!8N;#ynkq{Pug#^B;e<!@&cdbLFAt7!u+slCn(iaPkiiJy7~%`f(M$0xEQU
zxhd?Q1J%P%9G&vW0{08Z1=3q&KukL6E@2=4lg@G8V|EJ%pTma93Y^Ge#){v5iwvj@
zx?K6*t1KOS5TM8jn9Nn+(8Dr<LEhTGDZY7DH*lv}+7nsdgd}=gm#iSw0-?)B4Mk=&
zf$U4=0cD$5%vFv?<yEXm0%Qj_lIaeTM*Jyfoy8$U9Wp&SVWs_@d~G}<{3dW8K?UEi
zETWlH(darB8k`;Xc9M&oE#SOc>wd0}o1&%tZ<IDaQXZ1BA{yTJH<A01A&8R@2^_kp
z>mGSN!uw%gwGwHdm4;`Iz6lRj6_r<_?!+S=2u719?zDE-_hlhv9fnIV6ZCIU%OP}!
z2#)7nQ`|y=n(pw@TOe!Z6+H$_E4NB-25VyN8V1EKL(oB=4R4$7o~{A$T9Dh3Zhy*O
zUONN6BcuIAuSlqVal#kM2wlwUJxO5evE#NKv5AT`a{&}aN9PV@s0)8Ymc7bzDWGHv
zh&t&&p%3XsX3dE*<nU&AraMJvL*P!2UNw@pHUrF6Zi!DPpMTc6Vte^ofSyFn)?;Ft
z1}euUeGZ@(FN7))RGCPyHZghZxaj+X^@06~)f@{7CoX9rr%;YtI>rj*2hb#YAVI6M
z&1E`xK)-uhCW8XYgR8EZ$1H;@>Mev}1LW{j8m~v)B^U@i{T`U{IR#<{uYGXJV({N?
zUFztu)Ez@3bq)QQG9}O<V#Cu}UP3_fejtBg*b1zSd%ieO@v~l32VP{W?oIPUlvgk<
zIzFFb0re9CufKk;oW4-Q=P)-XGt<|gjuYN;yw{8<5)5oxa@JZ^Fn%i-@a`K&l^~(n
z$~!#so|$CLWJ41Tz@kf3d;Cs#$zSCktKC(1+0{~i#<x4nwE7GA2gmX4{{onksRDys
z))*6gVwV@S;brr&fS2ndJNY-(h-FdKNq|Ddl-itN=N-Vbi+I?ho4dYAi8A{#V1_0+
zfbQ<HKnJbE#&tOAE1uL7xDI9uc>-)d8M3GlY>k`jE;uVp#}~LlMWelYPwCEQuLdhw
zE(0TzgL0+B(6$-8A|UPpSQCn>i_&cKRmH772;IO4PCbqm$jnkK`1YUYRHyh*!(H5M
z)hl4{|4xb?hWGs&3)<||oLBv-SixL|2ij%V9L@wIeaMGO7WsvZ15nF!2}c}BfCny7
zSrzX<ORRsEtj5y|ZPQ~Fe_ulBXd6$X=F-;e`XUHJWjMPz1Okmgt2wluQPaSlpA#C8
zY5STm?660@)WgICp&?twAeIp{OU_lHHUW^K*{nQ7*VSCa3CW7!Gt7v~r^M5l*tWc}
z!+9j_yspAv^usq0uE&<{W|^Rsr;?t-3(`XE?2liIRxXzmNA52$w`Z4q{AeY)Ta@Vn
z3_(}ZC9m>G+GgLNf>KVWN}aW8gyCr&#g(PQ^KqwsejCUdGpUZ*^mv0IY^(+J>9LXb
z=py(|5164b4UgpVa6u*W45AM09!^M)krEH9)RqWSd)SQA&)bu7H<sAT@+6;D+Qouz
zv?BVSyfO@Z$4Bc2h3a~XRYSc}d*AVAvi#ZNlIsKEe{3-ILyxiG8$MF=l$osgP=R@@
z`EHzBn<7_$SY8H9jboJ%KN*+lz5n;n;R9R2Z$&KH9%yeGo!DF<oJsSOW#4rG$NM1M
zE&ij?DS)q;H52aJxSW;Mb#D$Z2lX8b=4uum%ZUp42B{BbY<D^q&|Y!P3LaIh&6xND
z4~?otlBqYRdR+~A0OW~FXtAHmDbDoT@ofOd2F%FZk%26g$j<3or*?y6eUnK73(_1~
zz}K8_yNM5Ux)qOJu;6Ym>C7XZ+){$pc`(P~N+IcN?x+F1uf7|VFLTfv(!>H?;rj{|
zW&9fONBHWE&v@*_w5*QvW5jl@ef+5w4{36CuC*b8W4JK|g&P8E11m7A<+}DO8y@s@
z9<0==t9sEQ4mjkWVHG-8!*!1k#EiUw74I^mgHI_*`gtkaiYW_Wf$bs87l;#6hqL?l
zMG7oVj1W%i^|ikCced6FJhRUg5)*N!h2Sm2i-qB~(OYpA@v$RNrp@*H`HWNpgZLs?
zG}n4|5cHkL{d6cbH1Q+wA*q_Seo&DL;k9HU!0${f(7xU4@T|5wRR(C6eZJ+T<3Lh&
zlYOX-fRTI<tK7>%U!Y`r7jYNSZHbEzL{G63TW?(tJ5}kOCxKGbJ@PJhOD*zk)-`_+
z<y`5%Z6@)-l<@Ogjg8g~J(!xzAgM_|m$6;HchsaSvA#Dj4bv^Z->Sdfy<8~lOerR+
zI<iFI!a^s{6Ji8{2yL(ufSkbN$W3q&C4l$)vRr6yZeS1l&L>pel+t(!qLB$&dW1f3
zSB$CLshb<552%F3Kb>~<BIS>mmmrn-ZSDJl_lhj$I~KVvs0ZkWa2^v`DfYLbM&k%}
zrvi6|y!R0mOd1~uQ7b<Fbx8^EGKzK4wdJg@BsgO_;V}nXL=(=WHOaaO6~`sUL?zet
zJZZyffjRCiGAbClzv}Yqz}QSj1$3TgL2Y=jW*wHlOPO+VO|-NT$e(Xih=atvqWTq`
zYQ{?YU5@p<_JmlBg!JxwyCy3LxUzs>@Prrge5&QNpJu?f|8X0*%VE%V9g&?O5DG4Z
zhsX;bM`^r|AhbGypBF0kcCOttFr)m|ub29UUBB9QdKhV4MGS-%Fjxf#cCeOlRO)&f
zh?D<BbwZ-}?2X%A5M>9rObxEj9*DfTu6I0HEzTGeBg(;J=ZIoJ;lr?gksT(7W}y)t
zT)YP&B6M`_zx*DX4hsq)xx*&gM4N1fxKIpWZH(tX_uOfAOlTJge_`PCcc;4*gwT(>
z*Ul{Zsm3xGCwRdD9jm$-QC$EsZ$J{AxVd+0zl`)De#aW<OePFBDxZpk!3I=(P8k!o
z_^adgDGFZF+7<l^Iz{aj3%0}n-PQz;Do&yWZxMS8>WDD|<1^+RZwmtN@2lwGC`d)t
zGVUtfZvt71g0lURwdl2O<k3}10=v_eor5uguMV)eB+c|Tt82cSGS2ERN@|*+_-ruW
zZL5SO2{h$<$mHT#u)+d9JX+kRKI8Ejf2xpLyCchuKbc|y1%s;Y+6uYg&99l&b7Z_`
zDA5Q899!=|g=DtQcCJ|W?-0>iEmgO_EE(nbY2?8^1r?ADJB?LcqPSk<hP)EDC#9?6
zc|2hIT7p&NI4cL+?-YI$4(Pq$ui7%ti}=i8+f|X5vaA@r16<Ay9<;rwJ-)3S9i&?6
z@tCzHjO^RtEgn$%GPh8l8uCCkXIvjM2XOvf8BJV9F}8P`e(#_706CVqw()nWdTlLG
z6}kJPx?xSla|qFCJcp5KW-|!BspVa`Rv+FOg7%Gt-E`GZBOWXkGvkhuNJGjne)acZ
z#9XEmn$Od)ue<b$xFr}1w7$|j9H?J;uC2jKaeFgh(+EmPbbt}3t73@KWFqva)y3)F
z_4b^nHBfPPwbIsYf~S}Axt2fA7_QOBQA{0jcAWv$mwWUiDe2<dq&Yv#DHNU(h$Nl|
zg6e$chIHe+Vd_9cNz*a5-wSo|+L6RwhM|m?7Iw$_t%Xmo<aLn0F6_OIAbu?2cC`p1
z-duuCEr~;+f+NN39rg!*Dd0qU?-zHupV|x^BP({LClqI<to!pV@On5lQ3b|M`-DVl
z0C`7tUmOa0%2+uxy>NJ4vCY3u_Rz1eq#i1gL-s;<c!C)Kv#rMg#yE{ZmWT$oDxHE;
z{sw^NZ+nDuS`G6u*tnVZ%w*kG;Uc=42<EM&zdBiC>0<W$m&%=w5&f;cxt7L8t68_h
z!R|EenrtNMr9}`GcnvhxvL++f<}p-tF^u}IjAdy~x12Vn9h&<If_rK#8mOa}FI$(R
zEOomgoNq0TuyD|qhtreTvsJW^X4(-QSDeeDoMo4NIi5vfzerY)+kADvNkE#FuloIh
zHhNmwP)9GW>Y927J2{HG<M<T0-CU>zjI6)^xbP|TLF>@;rx^2*t<Vc1R41vl^w-}Z
z3J5u~8$}eB!emwl90e#sw-+0rl-*|ln^maRQ<a~99D319>aNA5JIIG}8@st?Y?u^b
z-sf`Hg<pwsYx6bpM2IbjqEN8wwS3zL{%ex?ob-S?=YE5D+Noq=T<lJ3SzKiC0$ly*
z!Rohr^(Z!mF8zL}fzThPe#4;^o--jHebpicz>MCbcF?aUDd2)kud7whYO0Ym+c?mC
zo!*KU3JZg}mBXMo-n0?3+nw$y;WQ|FkI27Zp*58R@PlQSea2R+<BEc>*+Q9h{Ok>h
z-56ADUzMsun@ZOoOsuh{6(E;&dwUc$JN?^yVP>4WCgcV~Fx2UCsD)s*lT&E|H-C!s
z#=-0lB4WI~yLrpI+b+G%qg(vY{sl#wH&S_S)+ukZ2UQ%EG3Df1_DGVHl7V{0d(w(M
z<#RNVqu!VE#du7B*o(}|l>+PC23R|~<1~jlL1-+&#Je$Q=qcQu46VEm;_(058&lfP
zQ`L*6!eg%+iY(X4PaUSq2PG7>BTuedrH#HAu4HR3q4>aodz*)eL1X@Iz!Q)=5N3;g
zO#zlV(7HS&5lk7x*J(koecX$I1?V%ISVu#1c;03yy@`0>NHTu-o?!}B@B#t$-C6GR
zT?2y8Q5@RRqu@hWI*=^_-H#Ue1opa37L3@Jj!*aMNlOyi0ohX9>1Sdqz4@^$D)X9F
z>}gHUua2jpy%#CBMx@TUy)kPoS&9}`)#SUU?k+<wW*vp%H?7+;$6nN3_ZLz|)H*-J
z=f>}a+<JeX)Q3**>gwSY9FlTCXoy!Q@y@B8xBbT3C<WXCt-qOjPht6w0Z=y=NO&bu
zHRGD^!?${Se7-7v29^^Ty3xlL2~Ci-*rkpzQqExBw|(jXzmjA3jxV-%>iyPGHs4~w
ziNXM5Kf&H*B>TNX;k0SX+g6)VVL(&$Y&`#t>hj-^m|E)6dPlB+$B*)>T5A=sHRZLG
zO6)SObADJ$XfM0niXi;?sL*Kv`)_#$9zBc5(l#t2hI)r^wX;SKeQOWpCknAmcVfP6
z?DTP<U%Z7X4wv7`U0K5{EJ~1l7mq6G@QZHU{wlJQHR7y2P|z3Pi{v%n=TQMf`({K0
z2yq|am$V2oh{!+gaIVQdTwrQT>tZB8KPz<EQb)}zYKr(O`iaU#N+u793|I^guHel!
zobql=%<in{{JU#tF7%PvOEe&5cKD_z-G*OS5)NP0rU66NuL%291Bm`49i#=KhNIbt
z&MH(x9)S9dEPA5QiBpNu8Gs$(Wh^)5IjPzkrqB^~ll;a%tV-D_LuEibFYA%XLn{@8
zI9Z4?*X?_d0vr$cF?`EKFa{D!tc_>fc}t~0%M?2Z5NoE3__c8pb>4!H7OUQF_v!8h
zSL*S|))FLEbI73J2nRX6dzTE8j)vxUoE3P07dD(G4!FeMSPubHZRSx^z&|*@&*iFL
zKi!j6d4+?YHIQFq*zneiT<M)`N)5*fhBpM)<_fu4gio+kjTYp)WSWX8#dS_<{{yF~
za+PKvFV7scWe4M3d&uw{+sPKupz*iDS72?)GHHVMv{mo;t7qV>i_s7gsWJo4C<ui}
zxiUc$ktT~xsiKJ?W*Yb+84Ss#Dcf@^(((`Ky3H-d6LD_t#$~rJf2`(sF<o0F(4@ZR
zre!YJ!mvminm9hl4R1MNLH)4sIG(q^e-USKdbq?Za#CG6Qgnl`fUY_AkWDh9*q=fa
zlSrjTt&wO~=G{&o`lZ_2wx{;`+pYQpONmVM;#D<v__hs_lDmz^=KRf;B!5RhQ!NUh
zLKOh(L4qs?sEvh5e>uwRhM%v!_1-IH3DxU_Q_Q?#qHL|dV*F)}T(L=iHROlJpWH9E
z%tE~7RR}{v^J;|jl}uv(#h*~3p@G7%XCMXfiUs!M4`@M+GCP>8mB9%=LourPF{kTm
zb{<t=aep|sjkIU~IM(}QEHs&?QO-X5k3D&*plO~Zs59h5C7&`=8R-^+xaE2|0ZRVf
z;?|US4hj|Ro1QE->IUQSIh=AeO1bLN#=L(zxY_(a$!!>Z!y69Zi2~)wKx(%R#3RA^
zIfe^$$zTVsXscQg4B&t|0fvO_VPa^1q{^Mm`G($L_U)PpTJ8#F)Cjz-os?b`akJ_`
z$?h_Gi$3?6UKy(O#@_CsQUYHN2V-^y{co*5&sO{$l4Zl*SGxnAh#dzX5_=0$<h1%$
zt!hF1zp>D&ps0)=J6Hz4kU^!kp6E7$r(=i3r&!y)Nfu^Eut`_LDS>9jPGQ#cuMj{0
z==#+mVY!P#v+SC0@V69eTXRDL8_brg698+J+`-w5H=STGavF@vJ^42wPWX@L59ewu
z+-A7z)W<qpj~+#{nV~;4*aGx%kj#VXj428L^DZW%e{6+D3ow}Y4-Q|5z^5AD2YPL)
zhJnLv|1X1{OX20PL!qiC3{4TCLPWkPjkJT<*>I1B4KXxW8`3noYTed>tl<G?+7Q&C
zh$r9lVB~3w6Z~eZa5y)t6C`aRf+57r5>8Lbp7?{|cjB#|xBtfz#X()Mg&Z)dTKxj9
zIT#@kpuY?6vffP3c$l)&F`1wfUT){vnkq(}&GBa1&l)|I7}R%L+Vx!aAz#DhE8z}t
z5Njrke<6c40h?;YKP}AO2)K-bGja1g6i7IpIpVHb6>evVob#qjSt7`8SV^WT9kepD
zPb#{>pOC}SU?XLlF3w^GR5J?hoC-Iot8KRPwDH711Sj-THDbzb?H#n<Sagj)P!=z^
zNCkrMCbC8FZLf!HE1<lB7>BS565}O0r8Z;QmXQp7RmC^Sq#%dm`;Pb`sSVn>b#Fx6
zPzoet1XXVq47hTCv~rxuPM6-z)Y_h`=}N4ux9Js^oo;wc6wV%)q&<PNZ&Hw!U>#5v
z6U^V<E@1_-P{9l?Dv7wQ@;pAWQQW>CDgdL!1DQ8Jz1gl=DzZJydg>X6c3Vlk^4C`i
z*<AD(b^0?Q1vQ8dQXf%y{YPS-;}Fv4ohY7!9*N13m=oU+;C0Zq#22J!w8Pvy$!P%1
zX0EPsG;kwK_CVBo19eDIYf)Dw$jkkXI$XokT&5Rv@q^v$NfEYuFGsAr3PSs!waG-=
zgQQhRdJ54AOWs5sr?JZhnz@Oz5Ji*>tI>^wZDo#HOHr*4aJh_!R_z6DMr#y!u*Dn0
zK%3*eqmM^kum_H;x#|Z}1FJ6_=#O=VMa1CCK+aNltxNrYfdKw7_t~i#E*VYx_UliB
z%Wdk9uC9qr(7<i-aqMkm5Y5=)#GZVNri)ob^3^{io&L;foHX_m<0gAX*n>7xHPuyB
zk~j5HGawAgdpMI?N6(X#+Zu*~H3;J8p6CV-;q$@`VMMsb-I0A-2N@t`r#Rs&P8)=-
zwq_!@EfZF#jug26)YHE8Za%OfTjk|T7oU80@Y!6iv&nd)HQ$-t#|?E+jkdgs0WSO3
zq#>s|ZPThHUi`~AQj44EjAT;1LDiMy3$98KRQBNS&kp}}f^^}bZ762GjJKskQ|MJ4
z*ZL{TjEhadlIR#-!e?sVP}O_`QIUMn9NNJzW1G$v@72T%fxw`9@OChFe@7Gi@;K?k
zB7d`4V|vnf(n<6bW$P6v=@6>a8;hhoaH`#7J|MAM(z(+5P(s0f!cdL4Zm{U;|KV!Y
z+{C_j9}$Jaf+dP}tPCGr#L(s*c-VEyAiqIx6zGW`5cSVpV;k7|NFpUv+wKtQbItU6
zouRvKfFEK}Cu|74E&yg;8y<n-u|KpoOjjb_bV|0kk$eoNFtCw$=0JktLE3qcXB|IE
zJsDL$gE$on;ZE>X#G|<62&ZjG%x3i;yeqANT-5{LqoMpC-H3qsV%kY-Vft~QEZb1@
z$S>`6(^EeW`4s2|j$aI04Zo?ujmbSD7u!B^{sMP(8AU%$D7m-+!~|UXY-b!FSWlsc
zpE2dA8znlGE^C#%bwOpicpY&uNf$_{KQn6N(Dd5N=j`$W4kM}oJa-Gee(p>+7e%Sq
zINd&LWh_!$Q0O9cza!KEOuo9qF#wqRn;)AM6tW2s+YAk4YK?!ZoAYJ)zz`?(&9Cx6
z>P!?&Ix%;Y&W1;YfBb;~`)mzh;P@Rej^_laZK2hhqpWMl#!D+-!}ls9I{@9(FM)lP
zli1>`oo&MC=`Aa@_ux*mdBoq5gn9*P_hp92zlPd{;CHBX<1p1q^3!I!*h2X!f(=Ju
zS$3q|<pp!IsGejsqotBkcQ4+=H1QT&->k=vt3r`naapSqMh4qO%#zMTI|5FDziF%e
zmvdN&P)~1ecE-l|!L;r|D(;3fMwePY$xnq+@=OGb?9yLpUjOX4XLTK0N++#dnvGkd
zPxAlQsEE|bY3{2fRpSWfB*W|(v&W>7TTUf9UT91je&9+613jTymUgHAXHFeGnX~E&
z2&!bb#D*6a+_g!@QwA8r>alCSJ!fw_y^AA@rKEHD9X>i^Agqc9fg3agr}5p4toK)j
z%$4pjppQqVic=eJouClz_`R%q&TB0n02?pa7@0F1W+gKx5Qw;Z(8Phjj_%!Ng_$|E
z-3+J771BHV<Jg%vqAx78@5uSs#qkCrPcx$vo=0vkU)|tyS(Ce!_(99HJ+35PI&^ld
zMx^2ru6zjXm40UW95QRqW;|ThwGX_4pMHWA>OvGFKGiv%FE{FVZcNZbg75W`lS=8?
zCFB!QRxXQ-Qal>>=j+MRD7SG*=rs!r7jI}dAj?9**U&v<YK+%UyJT@L%wX9Nmmu$8
zPNYKH)wU-*E!%axILyIH96zxgvI(~-_b42*FMp+ZYht)3-2*%FFgYX#Sih-sInff(
zE;LSp;|>WS6=i?rcVk*H`16kMa$&zeCaZ6vymu7FG?j__KDXO+R)}fnW@v3V@u^0k
z_j;o!IzjH93la>7+TU(>U9CPE!}bXbig-?l?YUJ{Dd`b$Rut5-N;8oQBU>@2$IGn~
z(>TQw-QR9a(bUg6=WQwcE9VuS*|1rDk$9_p8yQjBV;8u5rDNsW@neEmo@{U}sXK;0
z<@IH*Ts6{XsN$n&Cxtq$r2b7mIc>t02c>kaKlc$wpr816cX<sHX09+j4qqBg4s0dg
zqagp-t7b}P#OH|A59x!RxCymak&VFZ_fa5JBWmrWYsgR`<wD$d;{hMx#@m-AcvmHw
zm)(8$&RH4i`ISPb6^)@GaQxJP{pP9|Vu~X&0h|n~t)brrCQyUW5UJjVQeU(uMtVCC
zkz7`p5?+Zoprh<<_Y(atMZF3iK2$od=vG;%o6a9kJh&vrvHC>DK;SGoe=Zk$AIl#2
z6N6XA?7}f+OL7h{06{>$zXb>PxoWsz9xh<S7TY>y{8x0w8LD}h9OK%i#XWb=po}JK
z!Jx(Dp4@oTO}5mzQgz0EI*A{hq}<)uAtjxoc&tsP?rv#dGOj|Q5A4irA5OtuiDpG}
zoYFnO=iyIQ^{!1tzf)sO>=8Q{2%Fe0K+RR>LX|0>+I3qEc=9xH^F3c$@qr;li=&0)
zDx&)Q%i=A9i1Vz0?&>?>PGV9{yR0M`!aMwpfZ*Jqyu4}|F@LB;DgYtGXJAH=%83XF
zD#CQOKhN$g2PN-2aQ^Ez>o_qK@|O?V9gzgiv7%=c!CN8D1q8jWr;|`&y=$B5Z5^&c
zn3WpUW*Z86;7*OA8y?_c>}RR}!AAC!pNREcGpN#c6~?fB&q6ay!8O@I6#;f>q=4Gl
zi(`dQQW~`^I~2~f2-KBb$wuddUnD6ls$=23aF;yvng%XdXB(}jwKsCPawtWI=Kdo7
zw%mN1I7>1R{lu9gV=rA}q4T`4GyZ%oV*Q3OXqX2>1y?KT(EO7ir!}H&Mq7sDoP?QZ
z)717%Uob&xwR`aUc6ht8(;uNa3|j=$6JhCKwYYrhtNlq)25M!!G(&t+&XGpVcBFJj
zwd&tv$=B^HFf6I-VZ>B*Qee}k1~phs%N0-Jf1QrP$*(^*J3$J7#YoNe89>S~_l6=(
zeE$o9?%(&OSopE>JR*{N5O90Ns7+?kWYGaV7=0@N&d=OkITkfK-1aiR$;YmIXkT9g
ze~Tgz^h(>}y91+TWpR2LN;CcmXI6sb8Ln9Q|JebPJI=D7oEl~Sj2Z`F;GxuSVLAXk
zcYrvw(A#a~6Yorv?^`Q{dPnbsRy_@NK9eT>O>47f?g-mKZFgHYK9ljxD5lrYJPIIZ
z!d}m@S&$CI?^O~H`3$@(_vfN>IdZG;9;}SkFi(wM-dr*ypJ%Eye6y|j?<iyez(&^D
z>(D;2%<)!9HM>M)GHeMvP2$XM>LIwQzVkR~SV^~a4PIt>U!`3v%`)b_L`A?zp3Vk%
zMVi|Xb5M7E?#%juq&{dRH}Awq4O5I~_e~H)c5S}s*3L~64f?v+Gca&W%3AZ;Kplw`
zjGlEUj0~NS&z(nmlMUd~08*AnNx6#04@ZS!{cP40Q97)IOTCZ5sGR;QW9B)R2zx*_
z&;yasIl<n+dgwPH1{mHDT~udw9$aj|v!dX>J6ARQWszJpMSFmN<$rbjl$&lVrTdM;
zn`{Ux9qRebQ-qUAJ_((+&@E$aLA^-#^*VSIEbeKe6B|bRN^=mGQ8A^a6Ahsd#xl@3
zdmYP?7b(|H%aBdSPDZU!GZ09forjg3<k%)uHdlv}f?r7+L#(Et?K4h{Jn7er0LJdC
zy25FJPZ~csUqW~vS}c5vse}JA6cknXWl<KO;7@gH#UvuNWRDG-T|p1@W+I^`1OU=1
z!TTnK1lb#y8CC{fqH`B^W+_p*9ao3~hqsn;s`c57mx;Nk=BNtW=`AcjxbrsS2axw2
zZ3y=$c|kZTn<@0P2(`5MAe!;R1+`IC+Ad;iYj1hD`l+c!KOfId^>p*Y2ba|?9BHY`
z4|{lW+bPna-I;MyWb1$gZ^O8Um@LV*j%_FBp2Y(-cA+4kPC+^%4hjJ~puYko<e(R?
zvFm>~FPXpl_b*?^bVj($l7T_jF7krpJu>$MUb6j7+jk;h{c0J{*SR~?t_eX4^r*Ss
zRA_uo34^F*>4*<H7{P%Q&#zZY){5CkvBrjOaU@s&uqm>nTCOrMkz2B;lFn`PaS0qZ
zx3GX*sjHA4i6+#CE2S;YKiRIaZp~g(2&9cN%(O`iphwOfbZz7=zv<A&t3xW2*^~R1
zgAmbtwP+;cmha7hNTbc}tnWd@f6cDQT#(sJZAa@3eA>}VTp?3|Cgkm5>CL=hI9iyj
z6P0ieO<BkTuF>yJ(65L{(j)sU%ZPBzt-E~#9}X62^(3J2Hgl$f{5ZqHDK)~D{`he2
zl?IBXG))Jhhf4^})(%RfO~2{ASGf^10MD(ca@SDSpfR=~laVcm9&5rk>kBBM=6oM`
z$C7vvvQc(%hKMV<qE`agGzsehDKnxJ@GS|R{mE%rH?chEh7Pt~#;tM5l~?s@HeD;s
zEyy$KsGUCB)qD4%`or8V4<MiMzG7b7+F*s<*Ixv}42AP9Rp`DqQHi;sD_rN|7`9e>
zu3RL0Lg0CJEFdYx$xnPe;qOA>LwiJUb5Il*MVs5<vz>3W{QGL5w};{7cS9@h=1kUa
zmz6vK#(W#O>x;D*Q{<ci4WW&hVc)a9CE(ZYP*-ST$of=GqjkMFR6$4b__DXnF!hUP
zLxdD^h(1Owz|c9^A{{&_I^}dCd1;H7gXB|h2ykS}NUl5U@bU?O552s0(|=WslOyxh
z3>>G&Ms@EvV2U68NA}M2z3OvKan{&Fk%943Rg(=t)%5+o8VSL+;(e-rQQr!g20>6@
zBiV2o5$M;^3P+e$1S?)W{~DWDVg<fLC(0g2Sc2(qh8DQQWpExoP1NI?da6&?Qv02x
zAysnTXGBbSd{jRJ$d?R%9avc_8mlx1RHsnKevI_lej`_g>jrTR3Mqn!X26F=*G`5H
z76fxLU(g#FBJ1Q#?gdL}iA`4u^)@^f1YbcZg44?J3Z{LXyRG&t2*8=RfUCcSvJ<k)
zx)U&1%ho_a;4&|PQ1!|!R%57k>&rYT42BjnoIjj0m8c-+s_aB@YGk$qIugp%pC>aj
z+(0{RyJ_rs!6%F>w2`F$Z#jlj-={`=OWWMr0-SDfeEggib-5>^;}GRCYlm67jo$R4
zjIp!-kD!%BeKG^Z;~;(C0+?u2q-D~JTBH<JYyFI_dEUatFqfE<mGzd1=iI#`bOiiN
z@D)0`bZBe-+}&%YB`R)FY)fi?1VB;$B#<}luyrF|ih>2yrVfjVL!e*g{wc9k;~PR)
z4++Z3RH&4sqdY}ubs`b&mew6<^BuK1lv=<xj2No`3U^78=v+RDuYI&u-O!;l+&Txk
zE{j^uRIXXC<VD2f7v+nZ1B>>g`_x!^b+4TrhGOsKj&oHGnlKfGuUFg6&;L%b&7~#k
zlfSz|G2GqPH_`xmJLDg6+or_gS9NQ&v~_%cVSTmh@raQE>4ejBBZWp#v^Qp~#mF%E
zCg<LM*N$-Gfy8mrC4-+?i4=lqL;YdluUHnUM~^;nrdG3@A%wM$+T^*?M;|e8A~vUw
z@_ik}!sB`Wm@jnpvKJYiv+y+GB%7%!Dp}K>a)A9sL0MuaVD7kfOh#oDr+R%IN>KcP
zS=Syy{OgkU-aw8gHyd5KAd5S4xi3V&*Ijo#Zq;3V-MziO&==vj>X~C#7ooYU>AuIO
z<(+~vzSsitH@7}jA!QgNxxRosqayftC{9s!@4;0N=nL$R0zfU?NxzWn6HO@?<%VoB
zUYDpC=WOYcGx?sp>4L5xvX|V>`1z6+&^NOc6UsMd&#I2S^lq!l!Zr%5&a`uf!bM0x
zCPfQl$n7E`<=2t+iNO`pb?}E((`!`w?iOxX={7Ix4a-811q12gnD&k<T>(R2&2{!f
z1zGLVkM2tTtO-Fza<TiCr6uq61;fgk>Eq3PdHLF}t#(d1bl5?wrk>;!c{Z?%Og?cm
zHag-Fhd{i|%%Sk5&*S^U{}uWYr3XK<4PtY)LrPJALu@1ms><g#W?JcqTFexeO0xPT
zx1w#%4$+QeJgoD81g{i^`SK@K<&~!{AQ7MoK!FkHjc)jY*T5^N-H0HfT;8{p(Y0x5
z@sjBtU_l2^ez@&|<8`>W0xm62yK|U+5J00~S_w|RTGN3GFiDx5DdB?h5d0fDF!hpN
zX8-=|9Km4c4a5iu0)c?D63$qrmX-v{WP=balkx%I@F!PKeFrzA0Qal(F>s88I6NPL
zgw4n>+$%Ol;{CE=b1jgqnCl+P2uj+hq=NHLd;K!VJ|{saS}Rpv1yz4ur$^yN5BGwp
zA$cPUOFR&lI8h7#Ri=Vw$7}qhLhQ!vCtLcj+!tDb7K=wE!_e_m7P(ut!QZBua);|c
zS=~AG8#w?Rf7@h%m8Cf?)OAV^G)dfrMaCDPxnYy{6UlQGDERV6ETLBM<6!olQ?`In
z=&Jdr4QQCLd#_JL?fe?Q9mkvF!SM-tPb#*xHk~8*k?Es0hM89=4hi4qOXqG>C#C?9
zm#aMF3B0-P(s_p1EGa;ry<xt{qm?EVNarh=-7ijKGo+I-R-~ewx=gew>g@ID#1|58
zLuCe|pE6a@{r!n}Mws?FlJ7eD4}EwW91VRnnr&UshXBrKFHtrr*-O$aXgqe7jeBLU
z;6mq6V4#TP$=`|D$Z%z~jp^My+hmUa^c%P3ZDXK>)#_<y0RKY1?>OWe*z!i5ltf06
zVR)|oNviFeQ_S+Ccs)Dp(+V{zQhTSj{sA>jAX@ff47kwkrgItiHM9H}Bs(32th~xs
ztF90`MG&3hrqCJewU>rcZ#QcA0a;aw^5?$yO7|82iwcL6DXu$OXa~97&+`R-U6hAr
z5qxcTxb&-{vzT;VK9@7}+&i!$<~EWpI_4ka%GwZ$J!+mu+J!PNYYK_vZWdJzzqafr
zUy*d1z>&gio{Z{`77aAq0fH@RaV>f7+W|x%^>G3!#fRXuO8O)$*)t@{r@tt^-ru-O
zJjqI!EkU=$H)f{{C?KCBJ?I*HJWr?dK^z-sVh|^`fGs>hNboUD8kPRGW4_M?9pp^L
zoWHZoN&>>bKlC5oZX+%$&E<VO_L<H(E3Y1?ISzj-JJRLoBYFqU84cZL{@BPSSBl5G
zI@r{MFLfj*!p7@CWocI8f}+<^(!apt@7{-<PNmrbV6>;rtY(*rskNETt0trNW);u_
z$CyczFtx4N<m+$Jad!3p-wNs7q_IVkZ_+du+tuuV;+%KKKwljxG9t#ZVNqj}EWu@?
zOsF?E(HJXzDAH8?@&JHdkEa3*20Qu;9`NAx4yww4K}rHs5p~g)+G|68{LtY8CL9;q
zSkx-xw-iqB=ldbdZ`W>Og%`Q~yV6<dx~sihe^|Ef&h_ZLM6B+238IQ4OC>rbD_VJF
z=m#U>kJ!m9?9MU|*r3zr$?6N!gVy_z83c$BVPG_58&=>Dee)waq`;k;l+>@k5xafl
z-rXib6o|gaQFqFKvBMR=!63_`@vu>)K2iZQJ=c%dSYlukzdq3=`y}ql{#~FDhScqI
z@Udk+fXC%W>oW|rB|Ir6w&Rp;(Y;?)MhqB;%A6|br3Bn|1IMnE0I$NQ?WW`0k=mFH
z_E$08cu7$@l5X9}Ye}CD17+*N^T+tN4PH$Hl5cw+nDxF>#&(V-^Vl&xSxyu9T-dTc
z$!zSReNgP!NSmfhmgEzKPx5k7yvRPppisk(B<BqmDL#5XT3m(|R?6pBihO0<;`vW7
z9E}ZBqv}s(^T4LcD`fVEV*>z^Vjtj8@-LqF%_Hm)$??FKzLOAhv0HGPg7#+ybB;3g
zMGlVp=mdgsbh9V6c}Tr{4Bb6C;$QNr?v{)g()ZmaHPND<)gp-WQMi}ZJ(lh^RJmfC
z7e0w01TmFn>CqhsS$6-c!uijyNe%}qK6VrvwHx3+JzvcBRvz)K*<+^hHK{u>DKD;F
z7}b%O!^l=WLQMY7-icX=D8BC$Yf5ItpG9oL3eJS<xT`x{Jj~P3x8<?!4|A|R--TaE
zwq);OixXrC4ay|;AXqxdG^4)wr_<d%Fh>>wb8p59?b#H>cqsS?pGyF7H$rOMso*%~
z18&%hL~{8BhM(C}r=}+}D3$@g@31EWH5yfwOZT2K_{@7%@(*02O*>2fo1m^DF21kh
zbGC0m(cvv?tXHwV7nv(M2hHmEF4w8IXNLV%G``l<p-wqh8HPP&vcY(+Jq0)*UhNyX
zo2rjb&Q!?3S6A-2i2(vNL*8ygdj+xZGc)I}E{AMxXBxF@7_vuwxh5d5lUo|s5*`9U
z&<&B@IdXD(*C)VbDo;?GQ3D~?8PjxW_u8;L2vrLsi)jO_$Du^?s8fnm{vF@wcPxJi
z?`<EqX3if=yY=iFWdXTMMd318wJTC?0GR*zgzkCBR%WbA&VY!KG9fvLq49ZfdN)cU
zSMLo9I5hs&fDa<<)PMuJg5*YKNVNn@3UD#;?c>S*iQnC{^0BzC&rBqBK`mkzq{rYG
zkyBam;>DDdy4M1bARbnP!JvK`E;h%nRHajx^gaM6HFNSayR6rRbV{K%pxiqPVxp6?
zcsrb;PG5;R1orD_#T;GKa;8L7y&+xN(sur^QJEqxIT%SST@P5{?XDQ!kGt{EKj6t(
zHAK~;7F9hAg-i?w=$qjCNEfvgoH3>!cG7e&7>$Vcr+IVx+t~$fyj*yeC@jVC$&&XA
z4F%x3Cg%{z6^VMj@WhFxL)(b#E=@6qwYJpKLTK-b#-8hFVU0RPGlI-Xfk{)IGU-^Y
zEU4nV2{o2Enx($l+C7-G;sBuduuw=Ijx>V+pbClRFJQt#13iNxW@5)W_dCkD(<f!l
zjE6`VL2y>0W-5s=r!3ZBD6QPXv5zyyFnC5`2Ms-5CK?Ec_$Hh>=>PAHRXoUOKDB6T
z!MR%KWRj=_g;Q?aSK$B$cYUWUS5~ZoV&~z*CY@R?h=(1j?zdPAmG-=lqXLhwNm)pS
zskccLraUIzg(I><m}l#0!+zL|v`1SaGI_9JrMP5ed#!%-95}~8Uz4hd>F6lUKbW}D
z@3El{C4JjB5qXV*@<y!LuU1%RZwHmkqU8nOG)nWlMoU%Bba4QT$$>lvzfZlnE77gt
zmyq7OIDi-gWf>P5@XqP2f75gNmjkIheB$E>c4*7yfhq*dbf5#E4>sCq*=~8_L@h~;
zD3CLPX#>B4YK_a70fym3fIFdoHaVw37!n6jI{jduOWP#x=nb$pGSU5v=m#~vF-!!K
z1_}gTy=35M!sS{+i}H!n{GvH8jB8ob*Y*rTSyTU7#!M2P@t9lpsmg6MkY)Br0o4ji
z>y}_)P6eNDB3$PbTw2;@5Ko6OuEXA8rS@=hWEu!#L4C~jpUN=&BsylKjE-ZY4Sgql
z<NptX<>G3#@`~2e!)H0R!Zu`dG(fnHMY3%)QpAXglSS_izmC*;r}~HV`aL?5gL(&*
z3&8FU8p;Z}DpL$^(G%6cywYbxdRv;?rDOG_;SPoD=&s@w+f27iCp&Amhl)&~EjS5?
zJ4}QWVYXbr{O(D?eC=*qtAP9z{*fytrA9>ZT)YfC!q%72=Boh9dd?N>?P+Rb6_?P`
z1d5mTfp6iQc+AyGS>YS-V??PpGRFdACs)eYRzs{poUugLNO8MT&}{y!3V9Yi4o!a9
z*IX#!v=PzKV>Sz#*zPV!T^Fb$qvf~n_JkZc4|7NksF{Op)R_lErcX{Dzerm9nDb_t
zdO%yG2hqmc1zRz5e!-rc-!(?L|Ka|@2EPV4;7S?us@9G8)Dt|g=lO|Oxq1f}utc>w
zvwMzbRj3v&!(D>r8%cp5N3~thKk4x~$`a&bSryv(G4bF=vGk$?AZ&+K;#Qv&#Y2~F
z<PaGSYZ;OtdmG#LVYH|>!<8r8pLg-UrFeB{{-?rY-5kT;`bpr1TA}COu!PFuALm1A
z+^%ilQxp;RJvxNPP(r%*nP?%x+WIdsL+Z<H%5a+w%4w0&8GfXH<QKeE6g;lHfQ`Im
z+z@bLH8(WawM-XL&j^RgH1HEm*CM~yJeTi;-_qJ{t(jpddL2D428M!1v^0axnlPh6
z_<PRw@?GGkY<}ee%JO@!kwEds(>n7Y=Wni3ltFM9d)r*5Bpum?ztx`Jk*N|0#Vw{p
zU;*?=>+5~`y5`A1SdCVAFOhXw^tL>>V!R#(iww$+WjKFRVVh=-cC64Ttx%tArs#pz
zY0m98Fh5N*+2h{D4~a<vh|q`?4jjhCYRNTDSZ)_9v5N-(&YU@jtUy?&p%!vvu!Djo
zDa?QY=W^u~$bI+88IQ?z=kmP6iN*hM_t90JBjuRWyuG=%MHjG_W(KNqN}jhEbCK?y
z49$O;O--9UvBR{byy+xLg2}PbeoFOsr!agRsXnjf^eRk+#ja3T!mTLG<}n>e!l5xa
zQdg3U{4%~OD02#I*jdUtLX#jf=}#^eC^0>wgXjqFigtXhxww}!Hb=;UvZ$@Ci0>~k
zFrS13uGVB-AYRiYsn`09gd<RmmI!zo>K{e@iAAp`k}~#OV+E>OhOt$E$m}v-a@`bu
zZ%20)eK~Ogy)rxOG4&lh<d+a+-3_HpdOyobW<qG+?+8o@+&j#!lm3IOx@fhrI`74O
z{{Rxj-kj~8snCJ&YOMU))e7WLrwi%?symnUAO}s!35i6pGjgJMiG)?Gq*!_&BRH_K
zvDh%meh%E5#^L7J1or6$463%(58vBf+;7Lf5xlgWuf?yCT6UEm5%6gfcD-F4G4e9y
z3ubLCVWR#8W}LV2D2s0-Jy<qX1{oH5ZWf>Dz({Y=Cn|43Ox%RX<av~OP(?siE3FCp
z`)R!O%-$7`k?GY8Kp+uY&;)C;o1mE}C>Ez<_%h?AnG5IaWW$Sjapn_;1SX%h^{%3*
zU5$DejF=B{A;zCO`=}M^6YLym%TOo}c!Ny1gKw)a#a*POJphDi2RsCWAB?Teluw5j
z6?R+7eEkM0y!418OS1nj(|n41Rs6kg0|p^^gW|3TVbWnlL>y44W*#w+$<728@d4Ba
zpN^ktQCo45=8=>{kRYp5XaK91EalX#5kW&q`*TzW;IrT29YX{}Bsik~u`iG~kvI8h
zdEWsOgPe;@3eO2*E&{(5Nq%dV8A~m3N~iV?YrZ+MZS%G*MqETsy0ax_>ciE+X<Z1z
ziM7=YOSpD)cPZT4hdrGhj#|#cdAa5P4m9J5x$tm41I>9XudIWUDaza1k35<Gc7T)s
zuiYMHQS?MUH7BHzFiQEZ8*7%KVk~n=h3!(pOGjZSPIN!w<I3E=*9Y2eH~zm?YF5S%
z*4v+@^nLl9a1TN{oF7MupI_3tkH%Mpw*}HmH2V>SCF$KV`Rep0Tv@}M=-uBzI7wmH
z?pG=G*Y0R?n$_CgJ&o=P9-EA&tCHul{5JQot=5P3_rUiu<5(s7%&HF)+8WGF{Rg`4
z{xbqO07z}&y%VVB?kS>rp97jVy_V^B2zsO!u@tfHAADX{GrY{R*785>1F@)(y2|D>
z{B@at-c+0$3M-Qeo&^P$46Eufs|18~$IvD6A?DfA_ouAN(67J%<;2rJN{x>G9(}v=
zxuGwaMXnrTN+r-G{%zf~H8ktMMb%a!<s4|732n~M$*P3eI=-e^JzfnD2k4`cR1H`J
zq(XKZ0Sk8o&dQEc-mQO2rbt^wv@1ulNe&_0446nr`tn2`Cc?q+M?ePH@If$=Ls<Om
z8z|Qx7jm+pn&`1UEo$gu(`!cdK-7_x!XVtp!3K?)e1|lYt~(*T*+c&5bV!26Lj*JR
zX|nLT^G+UpYH+2HCCOo8Z1V~A2KX5=qM271zRsB8Q=f4ZLR@^4j^DfV6z*rK67L~q
z%BXBPKQ4<GF4@EAP}WE3Om@Q|WkDpgxq64bZumW`1s|Gc;-HfBFKmU_M^Pj8Xz<%1
zhb_FEnfi*R3X{c12jINv@eQMkNXysHk9Tuj&A7}_MRso%6H%$cAsd6mTy<&mBq}(_
zO?@UlUUHTHnEP4|7M7^7!g!TPc92}5YRmEWJQGTFTIc&SIFL8kdIl|v>(Oe~rLHLa
zL)Dv10a;13t)cTq0Gsvn^Nwc5WAdzvevJLBn7zFi2qt2jR9CdHogSvGKPwB>7$2lY
z3NL%ec-fSEqj5|!yy!#`+pUH@gA3)1=AXv<#$REQL;!G6Le4l&{)gH3c)i+lR`K5z
zPFzLY1wLUrvJxEoW5pbKg^bly5eube=MoS+r-+C?j14IOcEu7&ueTbt35I}2U2O@x
z9xz_PG9nD(T2VQL5bi6E4ZsPzngIx4Cm~f*fc1`)7n^R)3dr$431+JNOP{+Esmi`|
zuw7>D7ElR&F)AJ73tTjFx>Dx+bh}QQyP||#d`L-@3T)vZJ}Rpjh{}av((=t4f^zS`
zAj05vT9lw0)D0@Nc=4KyAy{b(?uP2(WL4D3vZWeRjs+zpW0@YBv{3jONc0W|#x)Bu
z;n?CfOvhH86(9Y&OOKjdQ7`4x!z9rJY~ZXFbR?HJxxmK#WX_&n?}7wAh8;f=w_p@O
zK$FfMwly~)2*+_`lTLjM3|g|($VFFqYHN6olMFOuSTpkv)>eCadzjH5%gG1g(~L1l
zO=}$vZ=Yx_(Q$^&I{kQTsH2OFZ_lCpSgt!x7Pf|{J<n}s)#~A2pEtJ0A1TDJkzB~s
z;hE$se)iuVqkg@)H0Jkw|Da)qkG?>jLzA8!jencYzbD=0Tfa5X^<)rFq=Sf~7bDl~
zCKaioP<#wg-CN4_smAD-T=oC72&flGH=vu&L0rsU7nY@oQqZ(dO5(D+Du>Bn-Qi$;
zoKlBeb~+glwBvOj#v%9T&ShjJe=AM8AD64G0&&ZU?23;=e*QztIq?e`eb!xIz`=bV
z&9=F<HUG7m7#zc>&{<nJtEQ-}iV8!UqKF2;jnud<;)|Ll*bLyP^o7yUoU*VSgLG`1
z)<+pP?vl77eRSDdwRy@a&7`daQ|2r7doFZ{4XB=;t4$pcz0}hU|A3^d%Kx|qOW_hr
zwYhPA!loI*tyCQ%_d|na()C3=%ng>wdTQI-wNwwYY%HMLxoZ-A2N9YCU2o}d&Lrh&
z7PgLi2+j$C)YWMF+0t?vpl)p$K+%D5BG$<r1g2>*w%QrdcO<DkFIn{B4Nb|V+}O~4
z$}C2aWF^4yn7mRZn$|LkTDft?R%^s5KIrzIK+6V?vZFf%?4teQFuA-47W9)hNv~U(
zX1@#fES$-1*{hU^jyS}565Vr59<tOqGCO{!{kvPXpda{ksFE6Zj?YM~1mP4I2-erv
zu3W3nSvn&OO%r(_f12<ZxA&n>Ah?`cSdm`;kut61L$kIDoxIwb3F_Lyc~SjB;T3)!
zR>d`2k`waE6duH+Q=elnzCTTGM@?|_RsFR$^o$N~w$&9`y<oDfesca>;tGKHW1ed<
zmRW}|yJz&_Yf^&O+`xAb%G;@}Z*211<Og8mB0u#hU~h$q38}ld<(9;ifN)4$IkPu=
z(*#sj==@)u5HJlH|GRsY3kXF9y)&_!>r-Es<EDshnuk?uk(=?Gla@KizuK76b8~tT
zQx1$i&oGeBP_!lp!g`G7k2MZ;8j^e4j2FTy5@F4xnBOKRVLITk;|T{5n`pPZwgK6v
zh*(Uy8|LYQ#VL`GHP|*lxE}103DCQDHMwSV!z$C~T35q6qSzQyZ)|0=0xwh=p-B~z
zPoKTsh>kTGw$AI+kJm@(N-+Xgsdnf^o(^)WBIA*IFoAAvglcSq;&)VcINiLH3=qlY
zb8Ma6X92RtXJn@5C+vwP6<8zXkVU>lt8jK`9)goZSwLWm&3%!?{`H3~2$m8HDV5u@
zxROZurpB!D-S9!LvYhQ&@`DbUC$KWNqQO9wgOXX6Lq0t(o`r3r{+{Uow(|V9j+^D+
zwK9q%q}>2M4MF~oelJ--i2f5{?)=S|jy@h?;O0|!HsM|(4PxDWuNT44utoU|tA7%>
z+%Mp$3Kd2rVGIOL($KfTodxvS_;i$Jf-hv6<3g>`QY3*mJ@JPIouULD7<3`=`}<EU
z#$gO?j_L3!6t)Mn`f{uRGav6aZ7N+*t;|N}_S}7A(e?<rh4v~bts$c<d0Y>6k&95q
zN~KD$07~YT5>45Of_#Bg?BaJgS5W9;`)IH#Y<o7COIS$hJD6T+VEMaQKka@<E^w^1
zM;)@cPw6wg9Wm4sa*tfMh|b#CwP{P}7bPQt8C**ZB@=?kt_FbKk5;)F!pA<o_7Q5h
zl)F~A@;}5s>mL{N;}R~Q=%*_63LNhgYG}yjeDEyNp6-2#1e$oh>X4l?kgl`N9tJQ0
zN)!`lJeVIfmP&@z>uvzUUpeHtBzyyMKF{z7qMy?W>MoU13o{y5D}`Z_mNg1}c^6U&
zebN8jSKQi0!y|X5nhyHTf3~NPWE`m!kIQTe38H-Rdmp%WTv#F1NJN4QTnYNX`Khcd
zvtf`+KN*Tq6Mv(YD$*EYVaPhfk!Dc$J|3NrRRUe$+a*L_gMY0x54dnVyi}e_(QT33
zbm5x1Z}}z@Xi)UPVp)E*`u%N>NHrarWz8md3}y%J_N=+ca9fI#lHZG%oo>(`zjs`&
z+juWTBcxypf8DkXRXvYsh)^+#3L;sao^0%H5?Ipef-h@OqV<dQN5k$S2bIBUx>TuI
zenzEKmKgQcMk~3mq#Y&+Jvw9w7$i=|-<JZ=y;&Hjhch&RZJXLx3>`=G^jI4dAJ#~R
z3^Z17JW<fTpN*pPPvijn;jBNEJev9foG-@M9u{$}#Vj^g1)Kud-d@TjWAikY=_-`(
zn|hTa4@Z_2Yk%8;vytB$yh#=`9jh<AghK^#&K$dLQz;1cniiGTohmVoGGwh65Kx7Z
zgSU3yroI++3O}Vx#~aKTmi08V5|NiX5B<NYRsl`3|LYINw324mI!~KsU9SAXWl5bk
z$i!J{2ab5!(B>Tivn?jxK#sH&`;R|H=t;^-8vdeUXQgW2wt1Mm+gm&FvHBAO_FAq<
zbvT)RfzM|GUG1a`vX4{2r_^G{0I2&w2_)~=uJWK(xSG~e7(B5n<1i=?PyK$3xT`h0
zkk!C{1AQV6I~1_upA_B?0MWr;OkoD|#Q=hfIw_5tZyx5P8v?NXCggkS)g2;mCG{JR
zpx`fCEARS2g@3p4Y>jr%bsheZm0z3iD^g~kHZWG1fN~l0kRSutjkq0gH=pzPZ&7-%
zYe>(`LRH2sC4W*$mu0<#P*_+dIe`s(<V1GQ%D&DSBzRvD_iSQW%!AW-)Marqv!{uA
zMTWCL%-<&A7~r<+9Vc2*9=rAH&BUC!vf>VkcYxaRGtJDO*Pi-N(~g(?%1vCXk(x<i
zPB4*@8iwR3FjlSuEy)V;THPp?hG9;(1wccx(HWxEj<^h|eP1LBL_&FcScXmf;9Bzy
zc?gsKo1-KxsgO%GCW(K}h5|f|Hn7`%TvgKQM^`0wO=Uy&U@65mwmb^R?x{g4v5R4z
zRI=eP*tcYI_9OgT)GHu0KLY>Hqyzek%_Cee-=>-n_(l=C!>7?ai958I>Z3Rl&$;0I
zudIiXwEk=IZxto4o%=EYUlrE=&ZGIs)>{rxo7f3r@P=09ep>CN6$CRB5m|5Y5y-Fi
zmeG*I80Ii<Ktpx;LJ46%bK+0Tx&7xvK=vua`bcft&Rb^Q>g`IozG`tp0*niMbK{b&
zz^ENq1_HG$jtT1wh=TZzR(8mETY-Sp+QVuC0g|@{`+`Cxk#vJv5?pvdJ?+!uu5f+h
z8)>UwGTUG?IAs0!!IxH&k=WHIM(uKao^)NWP3nySmQWNE?a(7a0&@!pW-!1!!qi$V
zS*^74S**FI@S>3&X#y6F?7hdfnL{TLUWhB{k#Z#FZOCk%`;V`Dpv_TOEFvlYttBm7
zllrxQ8}l1kv^x|$7ENpNv@e>o*!w>Sel!IF!DbR~FKrp$%7QZ?F9$(BQLV6v7#MU#
zh>Vd<?7_eX@U-}cI@Yi#YCW&=Z+dQa_fkeb1<4V#P}2cdzMoV108LV>oSmzuFE(*E
z3n_3Rs%^M`Ze;NR0miwAy9}zT`4fn&vzY+AR%Y`C<e{X*opseEb0eHeTes67_v&^S
zS#}-tGUK_a&>IER4&DZvs<LmTY{~RrQ_6>&t`P|0$`~6#AwX;b_9YuJMACONo}#v%
zwSbkwFQ7sc3ixMpS0jZGucHm%H0vBAkY^IikC5w=mNgtdp<;oUsS?ll3Xgz-C1qG>
zUw&0!BIdSWTbP;#rUX2OR9Kdm_tRql6AlBcV{vGV2i&<C!Dnm8q+#lRpw42<IprKj
z`^?GwrNX+CR7!sI36U_WV%ElrUUm0#=7R`tG>PRz+&j_}T2kLv8ogiPb3pmh?ceEj
zRR2|z#1g=s1B2onqrpdpeh=wq7_3y_DJl@t?tuA1O6fey+9QN$!I;0t5vvER!Yzr8
z?-_gUL>M*)?5PoCaKj=TcNyfP!UePxd?G(O$awgjfh4kasOu3wfA*xsOf$is${t&a
zA+;$NC$C&t@^rGhqbHwROM4+&EwxS8>}-5aS_(@m>2!J)R~yU6iR82JfF-^E-e#n1
zz)X~6rS|F0N~ejln3e!blE<x`&s1mIpDElG_;wJVQUf@fiP2M9DWKth;jyx1^zrbo
zpW!TIe(u+Z$bsp!JXzNw@3<PBBVN$FKFK1ZB-|Wg=!ejOHI&y;c_CoKy3(#&qt~u4
z4HoCq!5}&l7-Pc?QDDQQjV$Bg1esX}l3t$U6eh4~5+xBEy$?;mMs@nFzJ+X$Y6O{4
z9C1mwf@0el3x<YDk}g}9{6IB-cF=Lgq;}OEg8Z{O^@$m7!wlzWcVYWd5Z{w=jL|Bl
zv4nwW2~97e-e4i=Pg?8e$1y9F)$k=GUpjhOL>Mytb9}5BBNQ<OWu`J_w`}vp;RkBl
zAcxBj*6ujF!Q-7lEgN1(RzfqcXY;;3Q|%2PqRxq#a%~W5Ej6Qz^t>C7Dd;10I!!y%
zTIxjI-WHk=i)mWNr|vpzh!uw39Oy&=KS8z6a<or#f%ks+Y2F>zl8AGwo5cd(EbdPz
zSl4#sK!mG-LEwdaG$(=>rg0IxX~APQ3lL*Ln_4_X0@<7c9;ai|El8^|`EYwg-M~CZ
zwdsJ-jJdB_XxZ0q{zepUtMuhfk2WPC(e~W6=_J0nntF}A`?iHJkMAkIUt&q5oUMIj
zXN(yQ_;mpLcskTcsdz8BMQWF6>ra;U3tM@DU-k&?cY+x$em{K!--q;u#>FP7!};wn
zy9h-E%N!iQtfL8ET;SY{@`i?I^v&LBeB+ILZ_K{0-h)O7Qc?njo&fZkbw05c#UL<S
zP-*5U$MGsJ&fTrhQ;!qLUAK)_m4rwJUII+D%Z3!?$JpDCZWoN+T!=6}3k`EDj#|xv
zvKBTRd|yCiB9DM5d6SG6Mp#Z#)E(v&XL)9HAR(=<{q(>Cy~vAS0Ad+HZ^PbR$LX#`
zK%`N-$aCTYo3=!(Z=-Hk|38)lg!Il>D96A|=r&I$!LhN{`idUnIJY~7kOX$J?ReSA
zMHIwN*&Z!;LDu=<lbJtYv}3p=1?+d@Kg2+kZ2%nu9NZumduCJax}p@~rpPOd?7U_x
zbP7eH?ry;eRUB7=RTgs<t%|>g?RDe+InTw9b&#MUT^ow0k~rit>!>nQ-=dIx-^$7+
zrqU~e?ygqbYM+MF*GdRKgng*7=^xS=UjX`BT6=4W57l@qx!6sp{-E~x_sx*0hl$};
zNVM-!*)i!vb|TMgwK6!E56x1p<9y)YO=fYu78qug$|c(5JPTXv-h4*hEy9pF^;Oe?
z#>xFH=w(Ph@2n&b_9cagsKH;U;9->GfHfWRSP}?#aOnKJjlSdY+>b4)!CHg~mb+p#
zlI+fLLs!dK0FGX599JBCOzHTdlsBVskpor(s74FR%pPVkGQCkAs&dc4w4x84^m<Gb
z;!lr(zv~8#n^QlW(X7KXH6orW$29S|jV~7+Qi#ryCP$hrxsw*|-KxeB*%nuphn~Cv
zS{ZVQA=!5U^l34XS&X_W;J`OKefu8-s+hFz+YUO&evp1+C*8BlZOATg()Xni$gjyG
z#|wphzp+3M|0`l#!;I-9zQA+b9R<9kP}iWT(twGk<~PD^vsU*=y7e#X@3v|QtTK^%
zbZ0Vm_3L!E20<xMaXf6?KuL`evUs>WblZ_d^l+1S!!%KaL7|v8*`0T$+P7J_Vutk4
zyo2^v7SwdvMU0em`7|F$<c!q~Djv|X)9J(K(zD}R_ekfW->dV=>KabLzY&h_ZfAwi
zwLr8KNQH`qt<nfYims{X!2W?4wQD!NHtOD4`!A`v!)esCA!~9Q97a!yWVNG1-WRF(
z3M5^*gi8|+YxLph<+=Ncee8bK?9S}{E9+t!zQP+8dS~%8=7p@Z<+m6;i^fe=^vVtv
zU2D6NRPpe<zfK6bGkJL30wED{?y)(b+`{#ef3L;a)LDr24eK#xPSYQpqlwrDyGbcS
zHKf9I6)~-!hC;wN+A6uXT)SH1^Q-y6|6v*gh+&PzP?xbbliwnGbvmEK`$DX-;p65O
zVRJ*<x;+(UGtp3VkM6tY9Mz%ewmz#UyCYLC&C_n>Q5Dti+3_U4X)Xr624xBwwk#uL
z`4I?fdLtYY-i_`9yHIb(O-+ay-4BIdZyt+g;lea;R2aox^I7Kq$sm}_tiBKP4?6AY
z2_5*ezY%B5)@d}!9vDw>1f-K*wqoqv1)}hZw>@mPC)`u9vY9nI*?~!owz2?3zNume
z9LlWG|C<{MOV*L1;T1OML=$vHMcpCkTf>g^4uZA@TnKxTiYHZCH+rF(7-d=%x3M<l
z4gms&9&x!LQ6Elp>WZJEi%W@EOS6V|u5Ylk8?#Ex_RK49E)Hi(NvJj1P<I#RDCiX3
z$T$s)?huur`UO`<b=a#D#Kizc^QXEJJ=xMzK>nKCB4ZMjOmvE4JReNvy1!sgnZ)V7
zNA7}rS%T^!R?|^~7hn4Jw9jDmQBk<Kk)cp=auH$@f`1Yz`@7v9SjSxg*IlTsI*og{
z+=wIqj||Vvz9#nb%C4msv8UKK8wPesO;!-IT+_OOpom3Ap=BdT*}GbXS-e{o=*Ud?
zV{u$#uX__pjPZOf;HFX#c3!@oke2F~IsgAW?YxWjNkF^`;@PFR&poRDfwPZ@A|e=G
z7$>5CS~R5|e#FwFBtAVr{snL=Mmjom)&0OJHJN1ct2Z?|bTTOz&EHByYcZhQRZC~d
zORgbRRygFH-wR8~U~_IQf@5o_RseO8h302X<2X-oh;Tne?i-N?mWBE@pEBD$IjJC6
zd61MGH(qyzy!aZ^OgI#zxD#wZH0`2eawMFTYke2-U6$Cs^G}>z?_2KcUMo73WnF!*
zmW_6M2Q+=Kz*)UQaZ4^l-fg{+4!o?p=p8wl@H@+oL3z%Nj`|dC;cdpMbBQMLFaYLX
zDzZNSBZ<<tId%K03GKg2LIVX7$){PZ|KjEN0<UArwWkQ|?z+$5%|l6+4%kaXIGn4X
z!12dxm5X-VTgR&`QNW>yDHoz~!Pzm&{?5he-u^ao5594)=qsreK+Wz!IwOw6j)NZq
zzmrtt?J_;>C(<!~;9OFY<pRp{KZPQvohg%Pvb8S<Cm;u-6%BbBHx!h?h8k=Tda`Rl
zJAGU_=lXTxm)i6SE@+Z|2Q@(2fHgA_l5yi;bApa3pb&HC;$+BONutBQ+YmYhm#?Zf
z-7&$BSz7l>3+ax&pRVorb1?jrdxI0XesT{Pcl9X`eIbVJ*L0}u4-x2s{mC~D@7jEo
zAwU9S){rV5;Qj~U1;uxt#6!;z(TL?~1p|`!YUrW-i#+*-j)xxOK#9Z_iirs<eR7Xw
z0N8R>daFhcF)U(x>pjhl9t}J{RW!JO|2F=Y@Ad1!w#8t3v`C1EuV7Xvt6lY(N1x_E
z$0+C=69j3v1~|X4e=RsG0ukUDkgB840>C>YinI2EpBQQs8!om9$#v(H#4EDtX5^lD
z_ns;IAMx{eUY^G2CR;#maR7nK8~{8X274q7M`3-c=Qg8Hy}ish?y*b<nPIJNFa1b|
zr3V}*B1{j0;<qi+C-ePdw|<$R>P}*xvq$TxqM1%%c~)%7=Kt3eP<qWGgpw#7!v8>+
ziO>Y8{Mq7l<H<BcjlHSdB76vj31_`{@=?JA*^27V4?yaPz9Fl)KT~&&`e7$*72K*k
z;f$b9E2D88WsFs2b`qmhXl$21dTltl1EqxL4qLSIKx<ZT8xJ*W)1Bv{N(<rGt)>g(
zgmK5xX7vj_TJm}gMFGL-=fWS>0{>P4xqz~7cNjBRjFw~2RH7MPl#W=_!%^Jc?<Zc*
zf_>Uzj0uD}WRfXvHdBQ_w!rNia~FD~W5C{R=|pYsh;fELi}hBW)vyunzcbYrzhmG{
zca;jJnS7gPp<lOXiqBQrLQ@p8n<eX{AZXBqc8yO&Ju0m0B1@F6<D-X2QEtn2eI_Jz
zCFdG44PB3_0WaDKHxs%kaADvht)@5ll5Jzw{1P9%e|OdsRY4zCF|OSbLiLe9X{BKc
z6E6AXmBm!bV5&4uM6VMLcW*1cm%6LC5c3`e7Z5^)P}Po6V|v46!!ASKM!!=<v_peM
z276&rq%2reHH4fh??s4MxTsAc=<801$|vc&%9p7J^_hKs-Pfq?h#KT^VxQG#R<ugb
zQe3)42(g<|&$<v@B+E{DIK<t$VS$40{v=B6vKEHDOE$kQUm3=0;PIsa3JB<ZXef0B
z>mlm?s_cB_03=pm0?U!MAc}VB?JX@)Fc_ePuJf#!iC=x%tm`m$kl2q%3Fp=eXNnrX
zBSWqa;e0W*ssBXylpj6j!{8*mutruH!T*oIdy*^jo5P7Zs};K|`hGng|CNjz-76GL
zf2gZzTx%~gAi}szrL);V?kwNK+62g~JQ$12H+!0*ctDI%exjGmkU8s-F_QfkTF3Yj
z;vsT5^!$X6k;sri%RlM%noX29ei03rHbg+?aXd&rqexR)b`fjjAyrRy(#`T{>rg#~
zm+WIQ#Q|X=s4$aWi#a^Ck6}CWkGL&pRb75S1Z8a9qYcFiVN|xP@d;c0#3g=xhoEV$
z7{+qwep%h<IK0gIX=WpdjYAVxEU*2bX#RS2JDzJ9NKqXZ=l@y_MbTARL%%rIC0Aw?
z*PjP#5y5brocZXEfIe4eP5Fu#!LEm=f)lSxP{SG2M}IoB89mCOLb}pJ9ozl(Uy&l^
z$j_Ey7Ly72j0iHr#o`^v^COV^)1Pw^S8%Vy&29>?MK5i%#d}ic@gvPp4*Uo>tx;#Z
z7qdeGG-S*GMxM^Q9wU#6q5I)~)$fI_4qf#4ZzWOV`=W0|T+agmJt11~hG(_y>KovV
zYgy5VbvVWErML2I^TYH;S!v9X3PAE_H(!JZC|~KoM+&m&T$1U%P#SB-OEFSQbV{RV
zEH6yYZM+O2{K3Mvr<MbcG$VhOlxG!5O0yi=o1e0gxqT_<Y!n=l<~YU4;5x9AjpKBb
za4&Ad7fK@YQ+)^PToAXYXVq>jIm3|~#UsM6SQ%yC_o+|#Iia);$~%PCl>0Po87NQa
zvv)-&(8qvvh|kyD*wiOXs7<@0Y_gRuB!6&k8#sz4U(bRxtss>c6z^o<r|NcCO&0E9
zx-~M|Lsx~-fjltNkuE&=pWv@ZtdXH6*NSeC=?{c4NcSYGVatf0!1~BNRT|ZP&92i;
zbOd`EI$9Qlr}Lw$lN_XwTUoot(8gp38?_-CU)$(2tT{Se?K97fFnJa64Hmqt>LsbK
z%!a{?mgXW~DcS2N;z#k;-4gB*?eV?_pP^L8Fv-yRo)4O6r1$0n*nr|B8NR**W#D^Y
z=X`Ads|A`1?I?pRpD>H{h4Bd3gtnV!e%m$cAq*Z4?L8mafZn$r*Qcc909xKQSZtn7
zd@)PthK!1d(#cRYH=j4ocjs46us!&DZ=d2>3;#Z{JA8VGKHsyRh|g!n8tPx362#%T
zE@QT5%z{W;U5w=!LtD_Mz^KtS@^$eQ2KU?sMCtMCU6HZ<@Z)s~2Db8o`Ej!6L$s^@
z-ESmrBtI1q`xZc!AnFpSuhxb#NC22W*|!iL>^;#9l$1F){t!f|4DW=k;4xoCpj+&~
zMl)U9Wofkc1_)10`|lf|&4?XrNiLVrV2ye5HvE?Xq<Rv)5zzAzkQ{QQAo;ku!n*#p
zLJ^L9NIlcBc(@xoGONNHi<*k(8nM=T1{pGp{}eHWIWi5*T&1r($-F(N%8L*e*E59G
z1#32se3!f5UXaG;_Td#on`_qk0_v|C8(+dUx+4L}yOIKDEfZ{X*U{_PE;G=RRu{-0
zY@(k7BxcaT^bvY5IX)Q@U0(W40`t)+Cb$fv7b#N1mxMl#1+vlR@zf0c1dTgbi;u)D
zy{GvDTGKLoPDz6>+2}bcXVkxv#}mn!>V5pC)89oIPT$2((}x@U9*7*8DyA*;;bFEG
z?7~Rb7uGv7U)%P1KE7EkhHPM(17~gC#q2P@)ND8HUZIsqK*>mit6EQg=|oM7!rEip
z3gWfqnh`LPhkt=pG|Iv%@D@O8=%X0gF&{<eDT6BvK}fNJjRqOt+^Ji=7b*!5Ht!~_
zULD_?*m{5i+Lka({tI0b)51GTln8;!t)Lt_jIy3t+~R{<Yl?Dhy4e|l-OEYYL803A
zJh}3YnRmv^f~sA<&(yS9L0(thj{H4%=P7FXYf?bisz)`bI{g#Jb%uG@MvmNH;Pyt?
ztFzR2CNg_3+_dDRigp7kuDQ770NR%BUAKr934C-Vmhr<mS8)uSv?c_S-ix$kSR}~M
z_vzvu&*FacVSiaVk<DbyRz4cA*}x=#=g!Jg+84YBymovhU(epUK)vJ!0b7UBkc+jJ
z8{>;2m$0}-n8=4+IKUsc%^Gy)-@gajJAHU?KTc!VKxX<{(R02NeeONV_|z;SYu2<i
zhhNw%SVe+!IR~*{0wgc{pKjsf(6h)GUMKKou}ow(ZSgOZxucD^QbPv^j`cY!>wjTY
zcdw^U_w~Ok18at2s8tu>^1iLZ10h9e=Y;VOQD4@6M|jro`vCQT8)2ckB}4%VuD~FK
zfFReoSYQAE4w7%mJrBT_*0Nxu0r?b<W~@KW-MAJiqd2DFeeA~r{&S>#vBxm>W;?B9
z04T8c#s@k$E70rsJn>8Tj)|e>;E~DOTUsFPV~I>J9gFLL<oL~&q|SveuH=mqp46HY
z2lL5#Cvlh~Q|H&mNugSoEM<q`MkJekG6;#_%=W85h#q;u$e!I)zOh0$No`|+b!FGB
zZjkji%ZbHyTX+dy;Cg~i`s;5Ay@Ez=sX73T_Q6YOPlyj(Rk|2BfX1$h8bz%y00vMN
z1XA_)*dAmy*kIuN+Z+jTpSyB`Fgk>ELq+$+>K=^eS*l72DJUb+JMq(xew>S{5Waao
zdI`gU!TxCnn7e(=;$%}u#eG(kg9GFgI9<8?uI{snSy<d}m2`)zE`3#~RNzQIIcxH|
z>n08u3D_3EMh0m?GH&DU$v~QuYe0vqbD}T^gqv>_N<R9GspB#7NSNW)vaA)Nm953k
z3G%v2pAK(j9yhZUA1)9o*qFp^MHi6ALi_oE8G9{dQy|n)xU=4}3G|Qj0kHT&UeM>e
zH?Dz|?4(6MrS1P!md(%Z(;)x@1&(hFLaM+^u&#=s)9vpP<YKe;LnkO+>6AbLg!M>7
zv*9x>ma1{(u1=YnvLk0J)8idVYLoA)GYpd2@RN`^frqa?DCIp{idMz57kI6VoP%y}
zG#K|07UXl>7hwa~rr$;9t1VSL82aNMK$+g)Q%IFLV%I$K^T=}U+OSW0Hz0eA*80Vc
z;B(keLc<yus`qW`A{(XADTi3~E7ts=Y7!~xln4Iv6H<^ij2I?~dYN{uDa9|ka97aR
zYJdE2Tz18yz;tN#6%5kF&6kDTSPJCPjd3w7PuYcv(#UT^oSCN{b2HBK`HFyb<Z|(m
zr_P(-Nl<B0-ZdA_8QD{GlYcuRw-$;t^fp^Jx3bcGBCP;LK)S!av3}38L;yQL;LTi(
z<eeSCF|ez4rx&n>p+(pAM~tb{#>TJ8>9G!)oQQtuWM_e!b2JB#7;*LL-?C6b?SJ+s
zqH|Rd$i!i)e1FaCTg%f$z5a?iO;GD&>sEy9Uf+l}Sj}+lc4d|9j>)aSRBT>zJ80;-
zUEOepLTzgDzI43e=3o&+%j=EKpG>9Zb~@&xZF%r@l4X;=E~y2%qtGd&2l>L~p2Nk&
zCdWL3vxiIV+q>L@!xyxm|0Nx0Fos2CuBCNE(aQf-(jm9Z#@t_27V$HR6=u~S)o@r#
z3Bg?QGTmS9!Br5M>~9A4<3XJUR$3r?rr>uK{<Eua1{Rejf@Xw7S-0{>TQ;1T=Tcl2
z{JQ$R+QWsj;4>Ec@XD=%>I%%A%iev;HF!$`)U}bt@v=O?h{l4!*su+5-M(i-uVVj8
zyxGz{S(lQD*ZfJccTQA#^w8MfZA=kz-~O%4H7Q9u+;|5Xr|08^aVZWwqm0qmxy>~!
z{X^N2NvYfT@-?>~a7z7P@Hm{n!Jf{_WAXU3GG`t!tNKQMhxHvM7qX&5$NoEcS55is
zSh!T8U5!*`hJnjtaw=33Wn@k0P`(QzHOD%A<oROzT&nPbA#8L36p5~A5Ji_8%Qe=V
z{E9>-?J6+?3j-Yncs`B8n#uQz_j%DL&~&l6tI{VwO$;u+9*5k#MTLLX3g9FmSXhi|
zat?q(IUF1J3W!t)@yU=kzNI2dYhP;q+Y<=YlB_Ac0GZG94-s)MLacWFF`j7op92z>
zDRcf3xdnZp5C5Cl&Eb8pGGlx@$wQ*=g(zr$djn&=al@1s-1v3lY$wFUhis+~k_c3j
zuph2|HGPJEH6^Z?1-!XtAfgHMIg(?azuWf|E?~I~MmkQt$=jc_J^e3QGhBnA^YU@a
z?m(P?*PexFN|mGRIGx9d31dYK<N1gB6^I%hav&_OOxr)q03lL`>a-=_bVb=#t%v}q
zr%cs|J&)$oJcCKQVr1N7g2zkYDwOW;e|_-MX4{+9BTA7O>v?CL3}{G-Dmmwk)4JjS
zF&mVlL?__mvIL{3`k^0$1^GftS!B$?#IXre-v^w$r2MW(CIfCyJl7zJhY=W!vo$k=
z9VN38vpEh@VA%=7=CVz&+MZX8v-LZanV29+LcHps2gS+7DH@aZi!cIL7LeoL$@wte
z6A-Ma-9<qxhX}CD*YQ49;;7^jmr}}TFx)yiczXsBL`-Savx)N;x`Ms;&f2VF%%N#N
zOW1C(qT?$^UFG$`aAme4{`F%?=B_1Hju!=+xAel3(pKBM#UDv1U;AG;_1+5RM~e%(
zu^C(;&sIE-lES_OnZ8xnWP1yycdU=_h+WK1t_D|<1&%|K{!~C`$WI?bN%^(|do#r9
zST5M^T6G)JEdqp^O2Az&auG@0TwBp+xopzR&!*W{T-2<p3Es{J?3*f<YT<;7Q+_q`
zmCo=)X#)Wg^p)slS5jrqndRi}bgrRs7bZGoiTe%8lE5f-P+WXO;?=ZHcza5dR9|!1
zcqv_8zP~$(=pHlc7Nsrgc^Q=J;bS~>^UFZ|Ex-PpG?|SUq=B-K$U9Zp1ItJz;NurA
z4$<@F%*^T_U7R8j+f^t-k(S`Q_+vP2kTr|DhmT%2M^st0B}W1}>NZQ)z9}a+2pm_Z
zN^Wyx#WaSux;&1|@Ut2NRM3IuPd)ECxMzZoH?Y?4A7hMW_%5>6`?N><N<2D6?lAqC
zTe;;ZI;NvLi0%%>bNgbZKa?<a*h|}wVDx+$ej)JQ*tRGIrh=?dH65lQxDeW^WSA*F
zJ?8vuVuCtC;MD;qb5t_Lcyg$2A$~_d|181M*vRJ-J^uw7MvQP^ZI>Xl&klb6*M!|X
z1oiauBN}RMH02ou;4COY3|ivDn*q7LsmXF}#%hKbd**6}ei7>#tuyV8d$knc$SJL7
zk{K4>AD-g1Rj;1_g}O)U&x+eC$B-46y;@)zaV>m}1GYZ;(g%tb>jF01zsbE(mt4$d
z)gZH&ep}!efiU#zMj}SmShW)vyB3VMKATVt-A`m(R8|^Y<raL<tc6shdj%j51Z4&w
zf@_iawZsBKk0sJ2z8uol^H90kopr*$5(-DYuEFgA9WpcVWvKhK%RR>_JkUV<N$lO1
z#tg#+C<f+c7!EhYfJll-cjr;fEv`tDAFubaxA~(Z213TgY4`%%*ethW%$LNmBDBN>
z!vHPxw!tK}?RLw4<p<w2nwz2mzLXCfxdGf!`tZ!&9O%e<YGTFSqmW@7CDf@^U`gzn
zbWpI2j>f_Q8J*e`>>xX+$N*Uz;k@xOJj42;D*oDW|9&K5=PTFMwP{N{fPu9fR;;gv
z+W;S0$xNg_C$bjP-j$S~7thLK&4W55*0ZKmAMK%#mr%H}n|ouy_`F8SdXw!6s2SH{
z+lr`w7aIm26vZXp!atBbc7)!DPBrVC)&%SU*y`gv)Ys#zWZq(WR_PUsYg~nZJ-Pgn
zbo}BFfuuR_x-`PV25o1Raym;8q6(>(0JQFHGdtCLv-kgXl)?1XcO|pM69W>4sw*ex
z;jihB(yIR4x46Ai@l6lWl0j_oJs*jlv5201(KzzziXVzIQQMJ?=Ny{iZYeubHyrH)
zh$p@Tm4Z2&`j*mABZ_hrFH*Nh$JU-L%nQ!p3dCQMFXp`filgRRv2&=Xl=Kd}ecV~^
zlG55Gxhxs{NXA%CSsTOd0l||N-=};Ca{>NtfhsxdD3O!MzqBVlRm)wT-t|5xZ|0HT
zm^KLK^@_`M37-0!z_bu(+D>O?E>PfP|D`4?IbBuv@c0uqH0>l?zi<aUz*o|hhlXu@
z(u+-4avsPtegh%a#6I<cBib_hp$TZR@bkY8RggvMWC*VIF+qZ-#k=28&;2<wi^9O^
z@TFx9e<O#wPC44LKsz|ni0;QY2`>EiWou72$9xxLBN@9dLv`soH7eudnSk=z=0N~p
z`)?}QQGR6nD%iPbbWa6oXsX>>32ytGLOH6D7uBHxMYcgYk_E#xI~9IU(I9lj=<Ftd
zr2uIuby-#qdLR2gLobZeiB$0Cor%H6Hp-L}sT*(GDRn+X>v&OQk+^Q_qs|TuB_LPL
z;IZAWf_kYFru^SaDXwt`V%S7@4mwc+b?jr1J7LO~7jB;E8-pnSj}_&<YJTvbcB9@~
z#MTe@1Ev>xzt`xCnIqEpD6tF$W}qad0{3Fnlfx2SQ06O5{7^>5Wiy=ul!#$*mkD!k
zMe;&AXym!kRYe>COix?9ku2_HZ9d{`Bw7~(NzpCV_qw;uE7m=1m#=+^>!J)8m0<Y7
z_}WST6WuxaTr#s_y#_K=A14wwdi8tb(%?9;(c>9o!~I5Z*Jb=1<gK{R_UMP0qk~Da
z&DBpL6gNKYv9{j4x*`MI3vmz0_T{ZRM4H8dWP%P5=w7HpH7$*xV>q$7ig2PJY5>Xf
z>r@M%#u;R~ov-9C2?~f_9VAp+P~{JX@5MCIU|&pr60FEP2~2?-k5c>`h|eI55juw4
zIyYj9ZQ_i>X-b7wa|VK$s{p2L1i_I|Yr)cZ+6T~mNi^07svfKdbEvJEQ6s!4$X{|(
zfHi_xTyKnQFtR3RDGqWFk6T`7K08scoGv7L;!&HMxQ*MFl|2?w7A%`Pty%CCt_j4k
z1f5OuNK0=7pDX0?3v->ZJWaxi{6_Lp{E;fm*kf1F*)t4-uKT5+Ly{Ik_lqE8ZBMs2
zHIUQq)_m7m7T%`jdym;_xID@x`UO8eq{-qZPnqq`+Ftf-<h669b*wP1DpAKD_ch3t
z#zRm*lGEV98$z=N_9v@}Zok_M@6JKnW<$Mghe?hO&0q9&fs}RNusGm~h+3iy&~B0T
z9q>3mi+V>f<{^%vVgGHti;)-k7<p!J9Skqz;vj=tR&6Q<fP&lED)%YCZP$wz-SxZe
zpAk&;gz3H0UbbHyD}{D-tx2gJJo~QRww7l!qbunYm(#1NiE%%RS~0M1RYdO7ENw92
ze40H`KtE{x4&@piUb~dH4~#v9WZAuI#o4CdR}PuOH7;PNt82^t!z}6Wy1sh`Z|u0V
zG7L^@93w9W8&zWm{}Iv&Xm$n*1}c|G@(O;tUCRHJ=5mQ-^}QQBe3bUFmGw}u-(&_|
znx{&zd=;4NgZ<+!ik!7pQYTLI5?96dTbTsSNA<=g*KF};V3J1mdYEZIm^$cD*Rw*l
zePvZW>j!a>vpqBpV(2p@c4yjOLh$4a*2RieW*_e?UcL9JzXGC55#oEe5e1NAx`=cm
z|MdShbiDMN-Cv&2_1OAf&-pw%P`nr`1X$`Go)pH;-L|&g7es+`q}*g6feA3UDv1)k
z-jYkuhbpROVc0($;<)aXmY7B%dAiY13s-b$L1}h=<EniC|C%TBh_#H(oiYY9RjM(<
zjQA&*+2A2&5!oP$bb5Fv&D-)$OgDb2$HPP}2XjoKp;SO?o!5+?<ic^*Hg}OhExdD<
zvaTohHid`f^4O?CC>uo{#V{@`s~1!1a$`Kd9-e6kXtauRsmU?1M=1;_-fhdRZ0U+c
zZ&}DVQ4llDq>+5dUJ&oTsl`_*efwE^;Z^s{3x*od<yrxS?1Bk61er!oY{-PjOjQ=*
z@J<u|GfOl#KsS0GjLo6PbE$7d&;&M@<u$8*=?JOt!cz0+<!yG4d_0GLWwJDy&29XR
zcWx!6d|cI6FS>=I$rmGy4{ur3QsoeQx3c8DjUbgs)@M}{^zGc0#I-c6U_hB*R<x<o
z=7DJ#C~78g!H>yR6{zR|y;dHZY~w(@VBvVk`YnI65SB3wxk}L+?;(3(JrP>dg>sKW
zFQj{9Xt`4p_6H`sQ|`JHFt-bIWg^A{qtux~8$*%d%7URxFfaeuCaxSTv<e2;{rmj?
znCo!7UxE}?1k@uklJTGN7%fVJUR*&!7r-Uj_mp9VdT;`qZHrKXi_p{Ud)(z67ahhW
z6r<1oNk}tW=5Mmp!xi^5YTY?$ks^~^#KR$Z9&AN!g9|8_$RURjs{v8+r%}_`bRkA6
z$XztmVy2O15v@NArw_a<PXfew$-PS))vwf{)5&@qez@caMvSNU>V=r&_sqw^3e(z(
zLk=7z->OsBgzP~dPG0Iq?J76Tn1C=8GN&CSAwPSRNZ_j}a{BP~pLWTn%-*3IdO148
zq$at42Yyo&65W4*L?w-C0?pOxHk#HZ$fbzZe-3Gc%K_-=DciOVRa2YKi!*vVG)2Xy
zx@ID|tgEI(y`=lSgpBHYKISL(?$Lqw%#aZDki)o>Q`)#&@VyFGRr(HRUk7-uMmrEQ
z*70X<L0`|ahFbrJsAgsJqAgei0&$i|g4#gyC8A9){YnJ{<Wy85!>wWZPCo<su3&5|
z03r{Z3K;6AEJhojGWy}cEUrnCy7mK$%*H{|v0=cYj~6oq6}8$@j#v~?K~YD0;hzV2
zhvc_Te(-%EFNk492(PzSh+3)yh;iDQd!5IQjLdcP!nfvlg&_f01WKjZkp+xY_WW4r
z9b3e39zlY4>zPS<-|?pRjI^2JwWbYHhGk`oiq1paG>;kQFnc0&qk0?GnD`;|dX<tO
zoKske3(dN8-(+_m^GWh+knTRDXUEL;MJBzI9&dFCOyU2L#d;&Dn!AntL%H<1mR1NO
z-n|D-k-o{*cx&D%c197U>0-7zUW2~MO=<0*vuEOKb?$$e$&Jx)<U3>%l@&}V6#ers
zr1(8=aRBp=Nd6ZPNCOq=>!w^I<HMF#@PP3;z6PVF=*i^?0N2F%3d;d_$jEqQqH}I^
zm%;WV1^L+Hea_Udg9wA@Q~GPK%=DeF@9!2i+;x~xg*vx#@Z^x*oq%4`^?Y;#Z~`=m
z<G$JpfdvllFVfLX9K=on36}cKEu|)m!aYn4WVO!FvPj0o_(O%g+!YSF#NY996`@VU
zK=LwFwFuooY-33WBUzCZ8(RFISplS|Sc2GwuUn_k)ykQQ3akQcBC`(uB=xsj;d&4T
zuAy|TkC?f+#f2^DhZ0tsv@XRbc)t?`9oh7;$IXDGSx7Ay;6rw!Ys%`5PW)Ohpcd4v
zT+8FETa1tCG7gtUS0~UF4#1JP1M`<MLaR1a5Mw4UO<ZC_!Ax|0_tgtWH?jaQ&wQ}y
z>lnQv2$uHmfGch%PtJl#;YZ;ZdD0gna(lE0jE!;`e4hN%1TMFqaS=dJL0LSXpQ<#l
zPt4Cl>2LOIV7{=@^%>yxQX&n{bl?4UB_H;~i&L4p>d5KW1SGh_kU32*yD`#!m^O!0
zirtWWT7Dvi+n8DNQLSBB_KNuTy!~qmGG1oU6!rO0m-S>2YP`z*1uW4ye%67C>>4@z
zuY2P&)~dd_UpHM);rn#(b0&GXCvl$dv9&}O<y9Jp0<%GI6Go#lgCj>y3Gd0`(JfLh
z+f`ob8EBmphw5LULOOMk#zv&@Ru>Qg=)t*iF+V+g;hM*DbmtWi#IuPy#=OJ58m(9O
zOfhY*uvIOC!-n@D|1pp!UPBgVnFPh3HDt!~Jn}|~yQmO~1(dW<K3%j8j=_$q$x>D;
zLj|oSW9GNfUR7MZYbz0&iL>tKR_La_gUG`bN*49}{DRX9nJ*Stmr%_rP?R<P_|EQ#
ze+-ZBG219FyN!0?3xj>PKkRzZKQ9-`srrlM8Z+v`+<vDZBPLR+YOSgLI2p0w_}GF!
zzXY_-K;@ZtBPzvaU|qUFF6IHQosRLVQdkJ(-$EmPRuK=5$iCssdSKiZy2BsbEevyD
z;kuGR&~g`f#)1HD;Cz4+GzJzHpWVvqX3t)~GpboR28`KrpybGdVl7Fy((sCTJFm@#
zu#nX5cu|yaC|xm@WV;Y3qjc~83DP~q(?p*&7Sf|=m-W1qr5;>JTN^miPVa>H!?bTi
zj0T}3rN9sI9{3m*9higRT`fz8PQN~f(&P1Lrz>?oD%q?xj6zN5v&&N3`i;-l_kcuT
zcemKIz(_j#?ok6PTYky4&^zw_55h|$5P9_>0hUM4az2oS;Ei-eHo+i%@ooH|Cv_8F
zXaXpwos^~F7#8Czkc?+JD*b<%+lV;fnARAP8c3qIDT<JY9Xc|L{r#~4RWD6luIYnM
zdzYV5q-ye5$}axje2>ji%A@`v4j);n2<9aMQ+#|}LDk7K-=lvn3o*RCsUjM#Q`IP_
zSlc`Qq_mYXRH0V9WgM~Z4TA(Q-W=6Ecpy>8&R>8Y&}nLL`#!H|UkYmCP^hul7|oMr
zc+07LqF^^XLmu`nPT#LR*s}h1OgZC!?E3*u#ZQEX5Tm7~-@<<r6Ep16lXqJC?TF0h
z=_XhZu^Il>4e!Y;xRn;c|Dh+DgPHZEQC{2l$7$!Bb;E<>+d2^3IljxH-5u*}%W_tW
zS8#6WV5ha0+D*dAMT5HOy3uR<B3&vXBlba8?zdhYN%2>l-OSuyT*^6Os+c&D17jBf
zI4KoU6`^Mkz0$+)$P+a@qTC$D0K6cCsq&soBA$~1V2iXC8)}V4X$h6Cz5X$u+c8P0
z`*ZKJGRC&PDCuub-$!vlmK!odLL_1rEG<%blF4^hhbsH^h`Ni#0Xp3oxc~8GA#6*+
z{czpRi^|3AAk;fY@pU8tvxyHNbD%OJSu-TU1C5VtZ5KVG>W3N?g`_P74Mg658SrFn
zqi+(FSxc@ta_U1E=*o;+hk}uvfPku8kcZcC1gbv(_+x`Wcz1V1`8@d9F?|o{UGI+a
zJLo>($-kybGBzX>iRsK!4^!!4xs&`pBd)oe+|5cFNfWKg602z$jZDpVh2&Qwwi4v<
z7=f;j`fJ^u8x6X$#yzkSx4f$pI|1dbXP92{%Bq=eg@8-}1;?G#RlL)UdW0;oZm|qY
zn{eo^8i{(oS|w>()p>f@lz)?enB6!xw#+@u=Cj7?<~7#~ofeJd)8)itrTJNx%m`Yh
zi8Dj70z94HQPe+tg1&&naVlB?MipkXxqGxqx(tY1?|;7V7+=;sPGJCTigrmn`76Lb
z`0KlVN?2E(%cF>tJ3LnZO3y8}D!uR0!v&vsZjp7Y#1^_-l-fNW1TER<HGWNoH4gxl
z^p4%3ZqLTcrV$RYdVhDL!Bbv3{ot+yn2gIJjYx>YUt62+l1_6u+)=X}-{mkqq~hNz
z*=&Z6GSX$k$(hatlKgK2AD}rDB&dIXuUXa)=U|G(DuEh0*1dJ?iox?WLO`$%V-!tk
z*d_}d+Cs^PM=8*nmM3~@XP8OJWI)n{2Np^OxTeOWJdSgjOwaTNuS@c?aJv1tgnwV%
z;7rG;%V!B@^x%PGzPn=w47=aX@<}aIbi9RMCG;kZS`P?@xQ9>Mp~gX-Aw%kTXP!dJ
zhox`6Gh-MdWCdmLxV2XeKqna@@i^)448G%TxJApKng4YwnN&nh;rG?X1Sn6=p)irY
zWsE8+mZ$9OX*QF53p?GwAIG(KKO=5*XB*gj8~zoQBbfPO2eU|8bcxj}L(+5D`iQB!
z>h~Rys}=SY&EFGGd8Cd{hfdUSD<(l36eY+v3T$!#C*DyBA<~B0)EI>)gd4uVZN;Ot
z1vC7}ph=A64x7M^30rEH)Sh&(Vrv<8TR246>apG`_Q`{MTd|wb#CX+JTLozH*=}B$
zP$z}CVb-lmjhNH{L!yfE0;d1}6Z5|#j~E35GF-lBWILS@3ixMb%>zlL3|un1Y_5pL
zUNguyFd~9&Lds^XgCRq23DN)2aG)mF$%^#rtiMv+j@$Xeia*wx0#@NtOJ#LjZTtr$
z*=Zhk{2Y%SfnYrIv1lIk>&St7?6n}zOMm~jK$(F>_??TG0R*SD+keED!|@icfQ=Xo
zwkCg@1|ivR^Qv*X#H*t0a@8+y463X;siVkhY6hID);8&0#&l>tQ;g*tb6yW~C}Fqn
zUF~2eghkh*^~V<C>Nq_JGY475GBk>tuH>jb+5zb5^nYfz>KCEdWvA2s+C->@nv1)o
zJVZh(u8eT#(l1q;AHDRD?`^{rA)HQhP~vs4IWc&cs-2JEeBp9%Fso>bD~MN5O%%~e
zbGO1wEp~7OqBzLJv20#|AB+P4sXn%m+bKE1K4!R9i>&$~e*8%f2n*1?f#BL-CJU*S
zK@5ofFwiU?E<qAJSP>Lh|2)dGoN7#%OyO9G)%ah8TfQocl0@+6xUB;-kTxB(u<i1#
zYN@3RL}r8i&=?@a4!%g^vHl%-kUZ3sRcBgV2s!i8<Mc|`_lNg0uTK2w$?Ecua0O#~
z+5CRa<YXLEt2J?u;fH1|v#wmU?>_>M4m(ktkL#Kv`=3ab-nkwzpubfR!tRLD;Hul`
zdD^St+brFk12qlx!9t+~Zi_R#W@Qm*wdR;Zo~NmIY%~|KCc4V{Grt;34imsV%51nq
zfe@(`h8&=Udqz2yr7eD6o1v0I`alCNZr(x?*mFhOD$TR9xDoBqlO!U5<w-FG{TB_!
zBc`Pvx~ZrKQp?#5!Y}Ta2vDCUVO0b<t?9M$J%lq@x+X9;&Dc|nb+LBv9pvKMFz?>6
zAd*AXj7lPY@;Be+mM>7L9J<+9`xt9P6~?C71^uEqjAbB?q0_hll|Bd;zSYZ2=9RfD
zGx_#e0b<*T4npC7-VfwC1U@+=eRMApZ5!Q^FVN_!O>~W!^X7gp;88&G@rhmU1wc8X
zp966hEX6b0Qi>+d|41990y%Rr$7CUUi1VD!czKyhSJUfe8ma%De}8JuvVzL*);hU7
z?~Q*LJ;aKFHZJDHrF84>?K~Du14^t0TUUSP2yVklp4Xy>$Z{GKhs^IrqBYvOPjYO)
z(%+u{hJDgo4~T0N0*ebL@)O^iR79O;?uhEmufe2ncD<nKsJr)F_c&S0a$ko82~Vw4
zFFnwIi#r3`HD-?^I7KlxL~Y%nbkVTVj1E1!wP<bmOo6%VXzxa@oDID}sS=H|2bC;c
zT_!(0bfrqygt`oW25~YnMxxHrb=y?`vL@vl$mkTj31&g{GMG>1WFS&6$s`ulNUb~A
zm*;j~(T?_*osNqD4*Ig`>gxc444`_v491U8OxXesh^3qvT*5ECN=nhnO?TycUgl_4
z6kqcI+Ist(VBB-ZQbEz0JbXUhgX#=cg_zLZbM2b=+o52>5}D=J)FQ;6lO6_Hq9O?P
zc%{i%nxA@9iOpxXhQ!Ca`cdL&vQ5=y7p1LKU*-vTY!WgD%mlqaQrr+)r8Yb;200AP
zHqTg6E4^;RH;WI;_NA5s{P{)y%YIZ@OQ&rbxQ3FncpZpF70ElbB8U1+Z}Y&@N*nEX
z$GY7^Q@_lCt2=pvZjj04T%<r%G3GX$S;)Y)5W_fMxz%624<~1t?a|jBm`fNEzm@AU
z_;M41)w#oqe;h=EmI<GZCO(*4bq0YI?U+rA1E`ozbhuai6#a64b~RSxQKb;cRV&du
z_EQT+9Nj{ICcISXg79*xvNbX@FBS6(5Ilg5!YY=tM8B+NymQ>}DV__?lVX`mx$l3c
z17Ae-BGsgt92Y%MWtFMo2{G(M;RN|4wT~Bj(PSuvUy{Jq0%ryI-aP(9;t3{KxWm>L
zc&Ajn_3Z@iHl=4*pqW9{zR?pT9OCMu%;Z8y<qN1OH4*cJYK$}acTHvMT{+r}cpTg?
zQQWJ*!QKcLke33Oxj&F}<bxj63~ra3aTL(jQziz=mn(LXuD-3ChjLq!8BfLDC<7?T
z;#u4wn^V{Xp>dBU4%Q9Zx^xng6HfpU7y$}vOQat&BKnF2Pey{>syEU>4Xa5gO=!c3
z>lGeqx{^O|m;UzsOE1xZHbbt#oA)x^GWVA}X9aiudoC8{*28w~Zx;9gEdy0I0?N2@
ztje~f*Fy#+%VVvqteU44to)qJIj1E*A2_Fqi7GU^Wh(c}+>haPI3;T;(9D#-@Rfq7
ztg|0^6JKgptaFJmMb1$);XK|;6XU>&72VdvcG^3;6Q&F|^`gi{qZ4hqo-#pj#~g<X
z#I#C9*e}(*)hmU=jAy_T&}I2SLyHyW(2#2U#%Yh*`}DbPLP+%iSB+=Ue@Q!L5*G!l
zQ0lh5rn@Kp?q5jN&Gd!we`@WA-dUveP0KKidKbvs<y+C7V%btDwK0z@!mcQS426w1
zcDaUbmqS0Z(M{dwg8l~_U(W{A*s(W5cS}$ejGD@^eR5%nFHb<tc-@MBp>#$kOp)vx
z$qg3Yw1O&<hr#Pv5biqw7jvUWQhSsQwH(PZw<Ri6baX`sld**p<8S`YQ#d)yLIT#z
zg%Fm1z;R5_)0+eIU@m?aHM7{bnI_U8zxT?@p6e~yXIBE&p_4aV#fdHAhfYeLh@Oab
zRjnDtUm)a3eK{!;WIiG|s05A!1veI23}m+Gn60?ZsgoUwGZO?@0zzbgO44D|4)^-%
za(jk(o$hS61TNLHvtR~Sdbz9S!@Lx7A=l~Vysne-kU<@^QJ><N?e0KKbd(&-#4q>H
zVW|Gd8RUf1_;kdN3Z5%6p!&GsE1}I~W6*UA$XOi}zjR0J+Ff4h=${WTIU^^FzW-`6
zm>60uDX_fJhVeXPuC;bNHLllAF)p_)KB<myACZm?0?)8zynw&#x9XGe?|Fyg?d=>0
zE#5w^@V&_zzd)=G^R`o0bx%y)7om_W&0;JpdKYK@q&>r*0%b@?Yv9f1^<3j$CMP^n
znotO()E|bU`0d(y@V?|fsnTqwXm$e(5N$j*^$hx)DqE~Gez1xjPjVZ|3&#`p*PyEi
z*Lx@gAGabrPz_E8tr%Q#A|2<kMy_c&_Jk|MD2@Y}WldIyvEIgWCGN`z0@41q_F#p}
zG&)u2<m+Eu<4l6L3EPT+Dt)*1<L2})-ko@|pjXwS3yz!{s2_yKYPQYLIRN}W>NjKH
zSfY9y$4aW11#Sc{CcOZ0q`))9Wde(nl(F#12Cnnj7|qtYJm<`_cPhk91-y>7o6Sb$
z+$loB5@i~^P#<g?HutN9`EG1~i4wg|JG)<|g`yx8spmIF|4o}JIz(nL68Utt;%7>U
zP44tsai`Qn98{poU5b9#`IraM9eM^PSX5*ktWd%<35!lfO1tP;9iD<P)kmX@D4Ai9
z20w!W{k`RAf7-dCDUuZtY8$6Wr3oVXM*!%#2qHl|`BagKDJQ8H^VYNOZoTrWF#O`s
z5erMkzX%iYG>E=3RwxGyzsLXC^`6Fl;_IPZL>bM^QE?n>(uD;>r67RxNTb35bA2^@
zO>BC``2GMvQ=r%NBcS!<*X=$7TSL_<$1cH!;~-({6=f>BwASAqnu1`MM(+Z<=Kt(!
zP<V)x9+WQ5&+#gi6*ho4U`(}u&TwD=Zr2=z?<6Q$M5(k{4$)uq4x3!Wb#{c^rXz;V
z7z3_Q0Q{^EXP|)s{TU;iza}Y~Ex-q^S>h}HOELuTHxtt0<hHS4Pt&7-gB}47y@;fn
z34*!+zDD`BvU}2cq9@lm2oK{gelY30A7HzdmT~E*ky8`^_CxZAx4toug)ryX^~1Bg
zcmx+)!2L?RD!M}Uw)|iT!Y`d3=fm5dC?d2dW~D(RFZvwos>8HdR6jsl2|=;4S^!C*
z%s|bYU6@bqIgL;O6ZU7g9+w!|xC4-%1u^Umd&CNLE!QaCCw+ZiB&V^&=ou08{}R5E
zR~hhIV+v)w(MyI084TpB&Z7w98}7{Y-At1Wg3{9I4W<y?3@Biy{{H?N46U>6#8Ym6
zJQu)c1`&~p0hD{AY3N`Nm?6=B&Zpl|IeWj}dMbS}eMYVJ9UwCso6!fAdnEC}hukj(
zqNYoP!tgIiD%=##;8>k)lKk5_@Ov?#!ImUTh6i1H8C(|o7n5K-_yH55)2pU+i{<n_
zg*77d#SQD2p_YIpi$n$IGwwi#=aSmTL)c7G+iK}jvm%|^LPN|XA;|?Zi2~Ld3eG0O
ziTv*1K{e;UjugfS=fNloR&UPZdDZt}_u^W(A6(go|4bN#^}o1!{$~BW6i6k~fD1XS
z9-H%r|Ei}b7`<Q<+Q(*gd?QaI%;CEnoOY4?=i9i&YytOK6B#!|fZM1y_W(ZD>5d*u
zi~oKK{32)KoM<zl2W{Zg2Y*+)4KqwynZHR41jdJI#mD-KhlSo^<GHpkoREZ9m)(Gv
zKa=$f!jRMteW!}TsSJlQ^ZK)CA0$gA!SaF#N((~f5G!9iJ(r)$BMISl^VX?4cLqSj
zSB4cVJGq}pVYHzW6O0Dh%s?bRqGUko=%^y?asxFZf$ulFpf)T9mV~ZEjw}gxd;ns1
zUkFjA+Bun`VS^wbFTzEu1_?ugEkQ}c-jm0@={|S*zSOvIudI|MBLSK3?Ch!Y&Hyb@
zq^3h;PG)HfVK{tvpL;0<78f47&F9pc6+0Tcy72E#&D&ns&L0QfBui=Q;$mR58MU>r
z4gj#0uuTej*NPM@t}tMv!Sjd<w(gFFYe(L)=ei*}Ft#TQNDPeRUQYnBdke86iy}IO
z(O_cEXoyYM^M&5)Lc-?9Bi8n!f?%QWy-GWPTtQ|{pbi6RKfvr-)`T^fWMu@0N#Pn%
zVlD%+^z)~oJafQf`&CA+c1ZO8#r=~sfm_31sWsvRQ=vP#8dEqLxu#Xv1Qs$EU%KU>
z(MTwy32K@@B#f7bc!rp7H8{ro>QFNP`>eKP6_SfC3aoIg6f_$u4_r3I?22?hE=F4x
zHVSDwDcK&B%@RZf2HDU>dr|<Pc7x7zugp1~P{=vFt{BJDZKNCfd@%4yAX1m%X*qBp
zMOV;L#;f<>e0_{p{l(Ew`)WSF9>3o;cdc=Aac{66Wmfosxk1+}T?kbzHnEB3FNAk+
zrX>H1^$<889Q}!@LZxyrOo7FDSOb{I8Ai~Qd*@8)AEwjiy$Lx+QXvJk8Vti<oMq%~
zG<Bk&^`>{gm8lv*9se66i@xB@W~!=maKFVH`C>!SO+xOLeR{Tq-QANV%FoRF{yX;X
zG;Ev%e#-%hP@xR;3MhlihP2Dyu}@MrEJnokLz0o~nD84ECo}l0`9MUdEb?unwy_Ev
zh~ICa)~+;l(uU|}3zNJZDAu1dMw;&4)&7tGbtqooryh^F+K)dYjbPRaWDgc-T1c|N
z>hlvd9aAzs=Ee%=&9i>K&AE&f1aHU-fQtSP4qOYuXkodG{E!c+Zno-{u4y)Q_)p!;
zyz!*EBN>r}9OLRP0A=!ZT4N3hMUALWKiZ^0*?fbE^`F62FI`iBE(iz3v7H#+XI&z7
z2{QlHD4`O}@UdP^k@*vTon}LF0ec=UDvO4O6}1*_SHU0AEG%10yZX^JEGx8O_aSGC
zJ2C$F>R4IF=238BUest;Q%Fr0kv>g;MEFqM+RRYsDR7lia=qhYU%$ENA8yH+$mCl)
z&EMC4M0=d%G~jNidlV2r3kwF{K)dTK0Ir8AH5m`pMP*vuHCAs0_SxA*rB64W_M|?~
z2q99$9gSlsWI+D&$soWO$GL)`6gb&E;V|wJEXIN(@dT1r?Q{`pr@j**X&DvutV$DQ
zE>Xp$B*0%}WU^$`6^l&mr^ygs!{GWcc{6SDY2gSR2`Yr~r0gZHzuE5a+b-Jb^*kjh
zScoeke1$7>>98J|WaLySi-pz;Xf=H;Aym$9PfD{2^gpev+rZo^wS@^)bxWr+wVT*F
zBLUv;OAlZj?c@n6=r)j<9#x(~LiIqKb2a`XN2mXQFwYr3D~rSyRXlsW&XVATCef(<
znaV^rvn`Q}v2bX6h$l+~d|*G?Sc%hc1<P6Gal9y%m|y~w?a=g4_=Ln@FoKR#<tJL`
zRK+Dx&VnlF|D6`dqyC3p*p+ZT_zYENj$8=CYi$k_7iLVLGRTpank=i>)Opl2C8o{z
zbDwADcQtC)T2w>i$0F~i_JL07SG2G>s$4tjTC^Ij;)O7PQ1b78FT8QF(ludO>~?yb
zaC3kwI4rXlRprngWr1wS;u1t?o@;KU{1jYhhcmcT&yJM0&5L4Z+78gNSB^D8aR;W!
zSX8t7e*qd%m8V>8;ba{bm&V1BKU-0dHqy$jWpfRU!|72P9}RY++Dmu|6b3X_7!VG|
z0iL&o&HQeTN9^IGmdkLPPdK&s0uZP8RnW;Y@qT^<xxlUwuqRGNe7mN;A$+Y=Cmkg#
z8ZnGnpD9Irz3#lRd_hHI(eNA2@Hy%FlCZI&B2Lx$Tq0Lt;!W+I@$W}upjN-_<wG3Z
z-3?D!yNxbs&;?Vv1nJS-<>gYiHhRz)%N=e7DYrK_`zcsV-MRRIi6SfmFLg#=t9L#@
zeBm)+0>lRf^9sBIgd0;r*7PR!_lNZe4AYG8RaOeo67KOHyW9_vf?VZTlm$c$s!EYP
zoUqZpF(~Y{EU!?X1K#Qn4B3^|;MJc~8bbG<5zI>S!dOzP4-{+zIi!so(8j3N^z2l!
z3<6}SQ<t;jHCF*E1i!X4zXomYhC25N2SSI%@unxS8od!Yy0xm*Tt)#!!+iq10Y0v|
zIQ@{5qUtfm0;5)_ZFm~c>~)%WvH6Jl_2<hwjSRKpgY&fiu=UZJ{z;cT8H#}G5_=ib
z8kaZqyIE_Suw;zGr){VtU^cNBWT51V@QzN^dyE$re8qyg6p*cOPa+7MF#*?<VH@UK
zE@*W5aF!N;G0$()EA(ouexIju)u09F_i|4s&g3pLRG@V{qHg>mo*Lie>;z*Xbm3kf
zR9-(=nc)22=9eARlBx-eCWMGEB4!t>i)%N9v*(pUr?v!M)>uGb_sPtZL&KKQ<fb0V
zZ&Md2F}AK=QmHo{tm23qK}ZUO?Bow7s!0F9#AZ4Q=K&o@+ECTHizxWKVIm2I)+m~s
ze|RY-wo@oXxyurZSWLYPcgo7nR??@<kRaF=jTNf$trfnHx$;-Gq18Gl0hledHG)Kq
zWJ$%CYssRiCvetQ1zNs8nvMV(p<nGOV;U)p`fioXWqWG<`D%0-iY%rd$)UD+EBYvF
zegQRzmj~8eo^0Y((aLRoX@){1(V?$aKZHDgG;DV^s4x<>af{k6rli7w5%E*N*vt3(
z;n0g_%!{ikQJ3R&q%DP%r4EZx6jlcIXlPlyfN<nly?hLqUkOYEXvt0!rh*pQOEWW+
zUeph6Duw~eR++u^uC3W2P$S;3rj+iZnRrhS(%GyXbOgB<y28n}L5<Y(u_GfzWUB-0
z+&vB(kedfI8fr~mPLd*IT|4G@7l$K`w+e@vXUP&41(_!G<r=TXiy!X-W({t>XFjDn
zRN1{S(_h^uH(SmM`p0H(Q|TvEu{PAxGmYSDHxCA87F`o##-;={5vuxBZnaiIT1FvV
za_4AD-hcL-O3>m~bee@op2i4<!BU!hG9V2PkG)~$y^%hcqR_*yl%rPV>}3S5Cw`#t
z(cu4>4`HEHd7EnN2zyYyVMi-Mk4a`-(Z-oOUq)Vp6{S4%fRx&>+LF`My#Ww=LmAS{
z=6v#V{xj%MH6X75>bnqgk6s$1ePqp@SU8#aL?emdKQam?!v)bRD^pY5K;TgpAu=!M
z(29;8t>mMyiArQ$$+iB-W+*^+TkGJWziZ!ycZoZ0n*zRikT1h=2ZC)4p?U(I_vi8b
z5gI`)Lt(_}W0bx1b9q{*2dFlFPMH7a(Ng?GG2)fNLs#tY(6aYC<y2vBq8?juu#Tk(
z&gBZ<q7g5jqj-2lgpYTg3Z;26Hm;uJFB}b`@aJV50?>%dMIEKS6&_dXXcG03p~f0H
z3;~wXnR;7$5TU{-?`&8uTimmZ_$EZjqz%!w9z`nmW9NgT#00rx!QW5_f&Z1lN8VZW
z=Ylw*a#YpRd5a6&o)Zm2%c9(KwO|4~H6f{BS34EW+GRL|qVB(S`058R=)u4uNJh?k
zXUfIACD0E+RLAber0-?~H&m6=6+7K5#YUb4fJjXluyie$6$^Pd9oQR}MzJbciI<5(
zzDZn?RVhQBtq}jIs5w~1;Q<Oy;2FXWd-lLHr+4K8!QAZ$GY8_G@0JCT^#`j5%$lW<
z0=E&t43IAmW2YD~^39LR?n*TYZ)svjj|494LNwNF+w)%=#5l_1UEPfkUm!TK8&=7{
z*^tkh0l5JX+%0vYUvqnbyEq3D0!h=LKA#<m7Ph{`SFl;*t|jy!tIMZ9BDkO?tw5N_
z^o9HG&_kt+5~}*v+}GJD46G72YOUhXzCn9?*xQ%ea%fDjuidk#%r6DLMxa0LTliK)
zfmpJOqWEdd4WV1YZZ=@bHhxhgB7eY9VN-pz>hETWT!wLtXscge-YPr{hxm{o$kO`d
zL^sVL;y@ox3PfBpfP$AnH<^fre0V7SzDqQqT@NTq$>=K&j8SlofuhN8n}DAFKLWHb
zVD6h)!Y%inwv0B(saW21TBK6-Z(%1;eg|s%MS^DnCXW=#9TLIngjClwd(FjM_tGIM
zRmTkN>QGnVwa}^oHN#6sw50Yr?88v=k5osmx(}_QJo)XGlIaT@T}u%z8iUj?)~f{A
zU<aZrdRVYiDh}1`|3aG*!1*bbCpHReel#5sB#giCJNGQ4l1^Bk%sCy3^JX|wnB=x6
zdbmsrXl*!oqrJQV<AWkP2~vOp5pbm$Qn!`TNI1kUkp;zacD>Uo00TdTS1bIiwd`dB
z_*)l=fRe3tmjw*y%|80ojs69vM$CJ*fh>Gn4|tmuU`1oM&Q|D8RxxkFu1NV|a5<VC
zA8iBc);9G_;4xiEOj5SLIvQ&yr!w*6MV59x(8sMvQ#X4G@#diQxTLm4t@8Y2&9?~4
z2ij86oKJVr#fee@t(AQ!M5YwKlTfigb@n<P%KR{>6>@v(Te2PqsR5XD@f0&b_tv9&
z@)BT~QqbE#u6x^NIyjFqmvz}AEtg#Tw>$%-VsTj4(^tC+WlSE6r`tb7O{0~{A4b9z
z$pg`UX8@W_rcb~s|DG&g=n2y<25~qyd@T9N^>Ru2kJv3>`xdvcilcM!7lE#a?us7l
zR6<q|#bezW^bIj?nGZGduR`7hyG$83@m*Q#@ofl&e?^?(P|x8ACM4x`O?icpR!m!V
zN~F7?A*nUotdE#l=n!91UOayi$Z0a}gSkT3(iwkt+vd?H4_{6vM1`a%kpRH*ts0w?
zq_D;0JBQ9g9X+Far;yQhIwe?&BC7z?0Wrgl=S#(o>%i<$suRTOWSD}1VglL#_6a>_
z9&M6e;_;3-y%hFA;*M#=FE<9S3B1<8mb@#s`@AG4ekQ19IaF6rqP0A`$9}am3CjjX
zt&w@3m!N!$$-O{sc7Rw=K|S`_8kJVWAN%nz$Op#4hIg_$CdJZ>LQDUt1-S1FJh%s9
z7kMpcfawzd`FNPAr+yY?{Yx;M=T#6Gvbn>2zFy2{Gij+B6Z+;{0J}Svq_g?t+jj<N
zbEQ9mH={l_J-b1Dqd7`a0=#m~bcY%kx0E|3))c;3`2B;vB#jtlcdjq3Sz793PA^{q
zf1DL_a(iBT40)fDkt8~u5D3UcX-QUtc2My%Gn84Pw~sLbum8>W0sdpFhi}ERczeZ3
zube&oBUXQ9$cBeLx!|>$Y_C_e+NTeu_C+rFkI|bz4?~*h|6my9dNxyGwMq5oq^yDs
z@b4^3$eEAdI|iYj%Y8@DjXl~s?ReP|`oTC!hsya+%(SDJ*KQL^1?y3u@=#sCRIrD#
zQ=ENs@VVI%yE+Q=V1&%29qz??eFbGbe3C&Fg}umenwqjaB)}1z1nSmYPF(DyLHD{V
zW*1Y@|NV}rV>6J>dD_jMG-GKuR>W3J>2v=fckWw`Q@Yx>JZ@FMdowNC+9cA5hOI>g
z;>HKf=$9m>g;**-s@g#%Sds=5b2`&osllh4E*GX#A^1?g4Z(wE)@NU_XHlX^<rHcb
zqoiY;{L*=AAzXt8kq4J=9mSRK-lAL_Eu#GfFP;(I&}*%hFCwgA6LnyuaQQ4#Dacth
zQe=W}d+=ie<IKR41n*7MS`m5ZG&w+H*k>!eli$u#f$l{IWi3Ve(KhaB#00qgr|^er
zXFYT|PV&)6-c$3!!-lE{tHMLy0?SnkN0e46i(P%N&|Nr44xEH|6=Wb$*lp$JAOkd3
zA(o=(M}^T=Feq0fsmf)gd&~hUW5aK2;RSf10YsxSvI=gGp^5#Qdd7C55ICyQ`COVN
zAgJ)owa8z!e#XR3>T3FjVJi#>Hf5|$Dl`^R7q^gxArhR?MEc*dU`jm4v%8|O*7THP
zQzF!i9Vq^26F~)M1a05x@H1|S7BBV^f0+Cu*ZR<oE_#5o5@{b?=Q{4Qbro-%YWIQb
z{fF@RI|ex(-R>19K9~1|EsSrakGWEO!3cl~B4q`yySvcTAsHht%*CI1Z0@=C(^8z5
z&~ZA_krem-XB0LJjDr!?*kiC{(}8x~W;@dDK|i(E+%%<of_0E3Tu?HM$#a3P_Rhp5
z#4)BLBSD=F*<T|fFHFm;(D)Dn0le+lW6OFczxhC#5+ZqJ#;Om3`+Ku?(tcq}-8-Fl
z^S;M!8urJkDtQ<!Y=D~)H0&eo9mVntxgTXI^(J0zo3^~rsVOr^AEm<F2>`9&Fk6WV
z%;4=yj)+%8;aXDm#U1~A{NEkP_dzwDWuLqMnL|rqjxAsUA*YgXz$rk?G^DZUPBb|n
zpF{8BZKFn9^hJgwV!xwhVpWm3@TBiHrm9}M;);$}+c^T(Kf47$hrRkhumuybti^kn
zczr`7B7U}`Gs4E$kPpF+IC)Feimt$zTQuG#I<?Kauqnnf%-stc<=K?j^w!rVfRLZA
z?ydyR(bk{t&1Bx6<U1UAB03>j%KF5%0<*w2!e(qXdh^#|01>@4P37vJ4F@c*8kU+R
zugRP1S#@BICY}U!9^eVPB18!|RMeLwDblz^r#r0&fip^RELnCuMW(JF9uQP=U4hkm
z3<IQGZiqnUG0dr*YXS{vz+*@GYw3H$V4U5K;0sXCR8mqyzi~n+LFmdP&w&)1x-ws=
zQca8{oto2T?6~VGt(3CVq<@?CG?y<3%cnOxHMqoMVYtI;(EGQEg5`U#IKH;65hmMM
zUDtkl$q!A0EJmDr5J=mj;nL&}k^U9D!BHSs@UTxmQly3Rs!J1G18RglO9u0a6E}uZ
zutMp6K^?!ahf;=Nrf0jtBw$&huW}7>G4J0R?BQ)JG-yHWVAiw1K2*kar{4r_5W3EC
z+I?9%-3?wSvXgl1O-tfZ9>esm(!e3$3EJqpW(lq~c9iMs*W)K~H?iIF4o`4wMeq!I
z$PFn##S?DWqsq(jWm5qz=(nER?NGAc>2#;-*JVV&ktY#?5SuLt>-W`rB^9wqrnm-3
zte*TOy;p;)!JuD5n_s_et|ezAxQeJs=6klcu_>W>O?BEppMVB7jo4nYXR0!>AVpR(
z$5)ju4ednu<pZ*wGIP)fk;Wti|1tEHFecxq5xwV^d?|T_@EGcUBx81+=YMaK5o=-q
z)u0|QsJEBTChYeN8G8HjI$&m)y0MZy>MzEDMo8sSDVz%Romx2qBA)6NIJJkE0v|yM
z5v_zdmS-~S%n*fOaO0h-M=rsCb}r^I?^`H9@#FIt><;O|&Q)=#23q?AAQN-eT#*Fy
zl|tjrt)063t~Ts<T50b|S+E>t8$>AVnSft}!z1)@(H1hu5l|5=Rk0@?YaFobh?Cd!
zsO;wsqnd*L1*kTB)?u7Yjv{oI>KRVbR}6aA(3IuJssTy}6B;7D$y#2(A*77O(hOa3
zVDOMB5JPldG<wqnc!<pjnt_R*8`V+t#F{_2aT;RI({Rj{FJuo>^D&faKrWa=;t|_?
z>`HKIl6)bn#?qtus+%a;+-5^tsFXr^)dFc@HczDo>u=QUuQTKrp`buY<o{Hzdm_WM
z+v5RACw+G`PjsQiL7`Opwa#H4&XLnHcN<I_gr-~egQinJfVA4;UNK@gKQ8J{Lzgwn
zSTRyygaI4albx&p@^<ctS3sBq1s2X??w<NUoPw>gyVBaqqU0R7UlEIf_1TFxqMu$o
zXqg8y44-iAjukxTCB>01B~>}^^Pss$K*_r|vO!{*m0KN{s6@_jU}9S15l-LYTQ%k~
zdjQ3u5+0wTdXb^Pcq0~h;YP8F<$HrGWzZh!AC|eR=D35e@#y(H-pVBhY?$!8>7aoh
zU?LRy<n?Y`$T5QX4KFEkmR?60^juuk4XMNQKfx@UB3-q8qVax(if@9swax+H93-lQ
z+|3WMYc{)+C3#28!O>aKx>H1!4!5O6-RT!H3=aG;+VmO})~8uYF&TSmExN!Q_){KN
z@Z0?qtdLIU*>u{P?sp#FLS75}kkS_jZnczfr+CkmJvlLesWPu#+3a?)-&Ef(3vKpH
z`yq6$t3MzGoDq*LP{{~qUmA7z-4qCoa=Gj5@9DQZXz#x{6$xxpBPmXxn_2!kH2YrL
zG?87cpkya^v4}|Q1h=_M#h5jw2e%aCU3Wz|-Q*q=KFWCp^jEmJ`^@aeYX<Yfa={XU
z#Yr)0jvO=daJ#sb(Gg{hGGHTacmX112~d{Ag_P4eeYFaDnIXBzyft+}bYMOscMzT6
zfx(c5MMPTQ{|5A~IY|u>J}L1!t`cor#64w}gBH`IR{QWZo>YQ4W0F^@aO2Z79lWt?
z9eq?}eJehONEB?J1zQSv_Uz3{D(S=-O*2NMyU3_e|6X-EcV#Fnr#))9qa>De(?{*2
z705(cwf!&h>^)KP!YQwzQ+N081DTwN3TQa1YUWtg<Vww5_0I%lO_GuVdI9jd#<9?%
zd%enr_Fca<)k>~L?S+~3dA-G9`pK|(6A9hwWyI>iN`rRp)Q3~uVM=3iI3%!#cW4_b
z$VR>bbiITD069R$zfF1=LY8g*<Oa7vZ~{(lV9j6Hq0vsG#=q1}PI{U<B=0pXc2T#S
zaDGH-TVeS|It@UQjU46g-V^|<^agHzDJk?3D=*<(^U{~u1uL3PMHqQhVll+ae%QKz
zl{TbNmIXgpP0jVjez<rMLvy$&P($B%ie4-$&#FZ+ne%L2O=r{2xAW2zrAebfw&3zl
zRDhj1#B4snrW%zEnSf6l$NCNhqE;Ym5FPfQp(>)AFm7WNyk23hDBj?XHgwN(e_dva
z?cJU((;bm9CqR^8g|n2;&Q%dY?`71kx!$&loq~lqBsUKO4s{yL_F#9%JmM9e?16T5
z<g%x=%C0z@8TrkCMV14#y)?!mqmRNvGbt&;9+rb;8f5_GsU(LOEh4TguG-Y~H{wr1
zQfU4Nio=bQ<1Ncox|*TUNoMxqr=<q9WHb}aFnn9JAP@4-<u%!tI0<GH=;*O8&Z;km
zv}Oo_a6X#NvD=js3q`9N5bEuUkJlC#W8eYUA@`f%s^5jTExw$%LG>YXF>b-L27InR
zXA<Leug|B5#lf^W+tU@D;DsLqHmD;%n;?`^ivZHN8I=5^A?rcQ=MTR(Ms7Ozi<@`$
zflqz$mp1O^Owdt->B44QhHyHzZ){$be*>+;jekArCBc8vB8xCxT-cTYMG)hy5T9Mg
z_REb*5`aiNCprV-c21nw@YHpY6thQ8f#$K>hxlZEM+(A`Z9k5MFFLB33`y#OTigL_
zZhP60H?@#@T~ky9+du)6X{h$F*7m!_8hbJ>{uudeEzgzr=$m1A8I`?%40lZ8S2Mgx
z@E^s{c=F~Nz<j?8a7rKwqSUQ?-x36Z*<2eBhB$4MsPbNXfHB}*goE@QY7p4k)>EDJ
z&i#MDq0goAIvzSWZ2%Gdku;_Yo=of*_4^L&0m5!!QxTX<Btq(=0)q5YE!G91elIdL
z8b%;p<ky^mZj2WbA7GJ;0H?vbv^0Ht^+A2gS8pbD?*b+|t>vL9mvknDztNhavd<^@
z(jO)`y`FqCrN#{tg8hz<O=Hd83at|&J7+9GlohPkgq0aMV5_tm;O>gEUVdYyEh6U7
zC3wsS)gi`gpWNWphwxu8^lxkusNI39n(CF0QEc_Q6U1H^V)$NVwgAs=JW-bV?-dPi
zSIWq;F%tw7y}*R-@8@6YhpkcQs*JSFAj5d1jm7EfDlK4$$Pn3?6iCHZt_Smzx<c3S
zhw>E`nWdkkge_S^9DsbQMdvC}5DTIA*3XBJ-N%fnTq*29?^6vIa{HMB15bsM*lR)g
z`G<JZ6fq<ybCS*6c;g|{EsnPJWdw76XS$!Wjg5I_>Q~||f}fga3%m4sjQ`~#f+A7H
z0SR#%(ckBOQF;nVQPo6^&5YKu+3Pa$Y0_GX(P$^b5mBf<%A#fZ=c|&3r@;#|WdL>S
z<6MP1N<UuE?Fa47A4B5ZiUnby`KFCaIfJ{p;8%tqh#>$h9&pWO2NX{!H@B}l4?D61
z(}dZoH=Mh)9M~fCRGMZH9tSZLtN0eruQtYRfB1EY{$oxlZ=T^^%`*xa>vl~^P3Ur*
zS*9QSr-aF%EN-z8B4g|^eXAvo9wM~yCBy4X@!y;^(1glRq%-t0EJEBiE$B-IA&lhL
zHX%0JO+2ejgpJk2mS*|%ew)7F0n=7YU-s#&<kaf3>#OH%>Ma@s>cP>0HhCxXQLMk$
z5KfL{QdK$?Uz#eqr1JiDArTBI&Zk+U)+3<rJw(F@9SeR~iJ)bbq@i*s65HKsj+~p)
zuvpW5V)LrW8{?lH8V}AY6%S-sH+XG56}QX?elOF`a2LkhYJ6snQdSDPPWiaq*gHDG
zk=y7xibFxMvn?-v)d!Jt<9WwUTFj-Tw6g55lIdpx9Gfg`Y+d9ev1T~+fveoyx?XwV
zE8BijVNg)g-?^vGRGcTtJuMw)9e=i$cgX$m_*hB)N4B+e?X{=raGZ?5GnHv?^M496
zr>^sUGDL^^3?+{O2wfp$aq(jP<EFgLZ5g=jCxf1=FAP<f#gloG!eB$C9u8I)_W<*z
z>PRia-QK)cYkV-4{FEG}Ozh`zLrI^EJ0#JZlXNFa1Q$&*?4ya?NC@(IbG|XTFF+pv
zcc_^yHbaJ2Tvy=I<fSK@0lR!sy=s0fu^{~uav+l|-93<5E1-CW>(qS8`dNH{wq1Ls
zjWAK1?r}`QyFlnHzCp4?9bB~*D~s5mS^elPe8@y?f<I^j-V7ZJfid6B;iG(5=u_jA
z({pZw%z*ff?1&~4qNDQsN`tp0ZMGXTV5x$r)ddqj1@wJJ@Px7;hLCEQMqWJPAi7~f
zmI+@ZNGCJgu9T&JIVo$`2J^ed#MWdcCx2dY<OssFc-q&JU=y_NS{m)w8->D!kTQoG
zwLoV`GNGcU8d%+k**I9NYb%Hf8gje0>AmNOCelRjf#fqImFO^!Y?gofnafkX@@o3s
zD;nkxROrZA0NDRk_44}i_f3K1yAzV(VJ32Myb%RwKa=DFlo!MC#k7q~=lUNxcYXGX
z!ApBqQt)l|S!dK<IH>%%#KOMeZ^Efm(MEGKYMj<q_hDo9`EaoB+l642WW0=bO|>zd
zyL#=U7ZrLe;PFOrrReoyLPhOvGbOuXb-fFa9_gF^s9}Y;D$xrQ%T8AZA!QXNqv!RX
zNLtn2sE;3zMM{4fgQ&@`b_Jyb7>C`h5qHY<m)`1y9azF~+B+IMBvzJEmLO(km}x~k
z5%SaI)!HD!@pn2?N1w#Q%0M!A!Mf*c;w7cQBvG7HY^f;*E2$QKt~@&#cTFXKGqOfy
z4J=P`Rje_Wmh17MoE8Jm|FmI$&6fCB5zB^nEFto+epF3W<iiQ$KVie9P+Tt;x&w>q
zHLqi#7J#wHC%$X?K-D#~tziw;ffmm#wD5?`fc27~r}Q&i%^5VuhviGn1S_Yj$TMy3
z2cV+`z(bt{Gwc|Z^m%q}W8HYnbx2jC$%0i-8@A{{=g;`@t#i5LcsJi&j8I+Ici#Y8
z?q`f7r%=TI6sN~bg7+1CsxkRB_-ek~aU%2Hr93@>5NhlLN=Pu?RF|grz{)|x(Ndjr
zwO?1mlxC)Q+GC@kMcb!~*2hCGa{vXN)^~5&#Z@LwIRC%d<VSp^WvS8m8lMBBx`NRN
zVkKycq<`-H3~yJTXy#tmVwwK{C8fikgP(q;1$sN2OR!8U>G{LcH+}DmmzY{QNK;C(
z+Ao<fl9A!ThK*bAIyoz}qL3>_ok1uV9mnhN$_8$JSRwkXMug^Yh002Gkai_n+#EP(
z!ENGsHi-xXDl?E3nu4HBF*&e#UUBgRj<+g7d-B20UbZhAut+GZ_5(UC;Fk1%!^O@O
z1guj%F|lYjUUQ@0A7LzvRZfgoGJ>5i(^kYv`zhP<P}*7;3W0IQ*x=Z2k$H6vxr=&c
z2G5+;tozP_{ZO;3veHucpy`_|hK1yn<HnoFbL`zI{;EUcddBbY_e?d{(y}F@miwXb
zON1{z`Wa+5vEkIFLRSn0V!|Op!<Wf>k)ruEloh7N0stg3&bpxYBRpIFGlC=>)7l{y
zIirRshzriN=XL{aNJmOrW2x0lXgcTyz8cQ7-OgaigZmDhKy@`nVnI1EUJK^ikTfpz
zKKQE&F#@8ZB$XlBZcp}wF~ziYIxf$-b*vwI!x2iI<#G;E)C2R)ACAW{q}{AM?uqXA
zJA)tz;Y;{YGZFWq_*0-b-r!6_`JQyO8_>k3Vwt;p+{uZE$pV;4&dZm)$yM7iq9fO+
zeL#+E%-aS`WJ77VY6*jeYlHdfjFsi&VB!Q#SNaHfl8NV+9#sM|*W|^^ZQcu5z61KL
zoPfB)cx)Y)wCJQ%Z9}#SsB2$vw(uxUwqw^BVJ##3FrA2u9S=ye1^-ZAP!<qkX+;l9
zU++vyAv6R#u&>6?XRTMv8Xy-DQs{reKfUm`7KD5093Ycjkof<uGmyvnFY9MMA~YZv
zi?`+2D*!&G_O){}*e5FHnp8lsU<60BiqAibb&6zq6#sDLztmOj-%Xory3c-FrOU}T
z%POpxe01AaN~h>dUn;ZIrZDk-x_Ji93A!IbE0%4YIz%Yf@iP%2kFSYI1*!vfWjca>
z<BJQ1!dvI@lC;$F?egX){e}5h+N;5?8`x$ccB`=?zKz~QfKd1YlVd>cDY>vj``L>2
zvj^oup&we2Nk%VXRiiBrkD4tBM>CU@MV1xfa!<ztfX+qfEJKxn@S}00(OS7>40&X{
zXaPJyNt->jX5W8BN#)L&x}V{<d2qx3x*1y~7n2#x7vS;^Q`!0f36Z$cfTvJW8BqHt
z$Q8WcKx<At3KZTbcMQ;f$Xcv^f_@AIn~@;R0w2FX&;6Cc)`{H!^(iT-T+YuQQ0}l(
zajuOO@<CwPh;dOfBnx19PGP4Nu;_bRheq^MLT0_pzBBSe)-g^;#33D)NWcokr$fu6
zi%>`$-eE1|k``G?q$73qJ}}0P;hS=;2xo5!UA_P#vd^RLM9u5yM6yt~y=<wZ`r8%l
zQGv6PbCfJ|iqMXk^{xGN-5dV6S}P}(=F^Tr$NMoYaRc1k&)DO3;(v0CL?8$$y!%yo
z1ALNt^kT3ebj^f!Hi<Vds&c&<M(P0CoA!0=qivQtp3zij%oXCyF9L|gB9jk1CX?rx
zHGY=^QtD&NsOF>W3`3KDKI^nQ(LVgtIKWaTgWh8}2@@(wGP3D8k#WfVE!O){*OiAl
zzB{0+1<c4T?qv>OK6LP;r?Jy3&Wp?8P*v-7HO`89g48H}A4V}AnMma;9lFu0+f%U(
zses;PQR4>7%x^?qy4N6P!Z<Sqi5GeBfM#3N;d^B*0(G@Kd<tgAlNjxfN=ZIn;`kno
zjXO$ZWLi`Q(%*peDMRChzZGhL`nA3IBi*kGc400we$-}GdW5>_wx<RTQ0aaPsP~gR
ze{H}?=qO+H2&dQS*~1mtG4X5f&XcHzS5NA4=a?rO&N7{}H8a%tV!$vW>H&*p*Ke>}
zI1`0yu|$o-go?*)5u<SMb&3^b*}F<&>$0a}QK?bd3?xWX=S=}7`j8Rsnj7Cc*~gR`
z@^c8r*^H07gE&^i*Zj{qMiy9YZAXa;iuaNmr5whPOL-W?!!U1eCU-L=iba$WG-&^n
zBx}P)nOydL#P4PLVx$Du$Vpnu9iQ~eL7;k;-RvnNd9O0q#nZg#9%(Dsc}zPCGx72V
z>euk97bYqR=p@ILc=%Whc88s~h3OV)zW)?};O%4w;=Rox3yfPjPJt3DNG;hjCmw%p
z>ky!JPqcDJVE2a55fC~Q+U<|GQ-r;Ffle5N&7Z_rQdgt40#8KlLVnd=5EkA*j=S%W
z>71I5xk2lNeY-01o&U;<uJsd5fLI7D881d%cEqO-NFtXlrAy*vW&ltI(9P4%!=LGT
zeN0OuIL)L-vL$^tsVFR^mxv0gZG?BBXG;(vwh)axam^cl=8p(B41qGoxKO#?E5050
zfOtQrk1?oG*f#Q>HEXkm!=d%hh!m@&8=!I0cN&0Ok(v0?bci7}WL=6yGV9tXfQ+rl
zfATBAANG7AYqr5o!DnC^;UenOYQ`8#si0E0>8dGWaQU~~p|ByqL;R+(xJ_D&uj~k|
z<0N_?cxZk9TxL$>wyer9?h;<mfbc=hWvJCG`dwwDkEILM1Q7Ip?-2x?K#Cng?zNoF
z+2D{t<SS;}&_9iU8;V7AH_Sm4I<-l{(etaTeUbv)?6nqtA_L|KXjq~Af*b}$PT}&d
zGTla0D#7wh6Bhz&sc7V`n<J@E`TloYDs<MLgMM^+G(Su<5ZGnXaf&9sBt5|tw33MJ
z6%lMrOGyHB-Ep0pf;HvNe4V%NWMH<OcO)zdGkypNSJ|OH?ZGZ9Au-D|P}jW~-r=-B
zOU9*Y%RoOk)p;G{?bz}ukHnNs*_(G>^!rPd^YvaG%^Q`e5rk&*q^zlm9XY{IvHhUg
zX@=5Ag2Ich1L-iKxVS>gLN{KBEJS3kJU7;7Z5U@eqo_wNzy!<JD`8sT*73eD*p`-f
zjC5QL{?u|Nx!&o~$A%E&?TCB@`nCEY=bzl?AL9JNNfkri;p!y`vfaH(Ul`OUSjyU=
zczYulKV1^f?*jlf(?<bBlze}f)6i1zR1w72u2a&9vb+Bd-aJ02Ivx@fg<7(Lc#b)C
zmN!!5a5z(-4r`wtm}sdfA<*EDYK+3)om=uepbWFWHOoH^6s_E5f5t1D9uS9bK<`1?
zytmw(v<r~KCqx@#;kcfD!}DL4Rls#2e6n^B-hp(CMXAU4pL7Jg|79uU{!+3j(3>0h
zHsS+!(WR2xUrutOxgAV;1(W=~?m*+%_uSUMW8?YEiOfd94}K{Nulk5;>_s%3mHcR0
zq07%mP9WugHnR@%Fb$$nR;`W2BMojf(N<D&OwwY^I#hy^ulU8TMBK2vyO9^I9Wy&I
zpt|Qp9Pc0#2S*QP9Yi*=_Me!S3OTAzWzP;0@qi@M6iU|S<-Xg@yQ>voNnEpPujuY>
zt~;{vmkvWGe-k-lymi;Gz8-yRsu-7t5vK3iM+fVXET3*P3l5G{`;A6KK103LjRIsu
zb@NcGfyTqIiUOn%c*J~o9K&u#Zh!7uwhlCc!RD`lBSH!&p5J$fx~58*mjKK2e;T?t
zVca5rWakuf=FfbUR5_~IiWrJ<{8kepEfY#pf*{6$TxoJ)fL8J5%jlvNq~RZt$Pje1
zQT|H5Q_WA~Z-0<U;@FE$l}KzwxB^PAKHYcFYWxu4`!eR|^pr#6DefM9tK|zlgA^M&
zS|%vTQR9QOhBlxf1nrm3cDl$tes@oZq0)PaM8cW+M$Xe%J+~}x>xP4YaDhqIbLc)U
zmdXfs%zk!@$zgH^5(Z29FR{Kt=ms{Ivg}V2iX<|t^--#HnuMo#(<ERortRmLvVUP7
zlp2EHd(D`Yl5T3&@fj_caN^i)evm9WVs1&CrqA8JZLZ}TOlDD=(TAYAUQE0vNkV>@
zort;K(b)Y<jX~Z{X^9RLbkj%kixtFw=ID3YO!8)vs7B&(ckw|yU9^6Puurd26DtNM
z_sGCitcm}3f*kVyuk|9_g6*GyhbnnqGI0(GW4R5FLF<c@!}M!ez+>E5<5!pn-bs57
zklJmy`N82Wtaa-ZhJoUElt*}}M7`-=0vCbYCNv|<yKs{b*a1jQD6j{2@TFw2f0%JG
z*|YAav$<UNBOQ!bi1<jp#sJ;0l8&sT&E4_!SLu2YLe?!K&N!IYVd0eqjon*X5zI}C
zzIy;GR9sHfKE#zPGy<auN=@;51g6ouWaLgMVkcR6<y0u7W`6He9L_HcK3)62(;9!i
zw-TnFr&LH9e}{zJWFf;eo@+_pHChu)c!o-JE>3x|xVv$rl2w$Z(7RetlX?3DM?(lG
zv$(4YV|l)ZC_LRVuu4Iqu*R5&$sv1~)ln)TRfPhgYH|7!&RgKTFmD&EYghR!8fVed
zYessG|G~-iv+*I9mAS5vtMMU?@&sjw_v>^Sk4PI|tSkVn=#Z$~M9@FQ@XL;?9A96Q
zJ*Dbw1nu!v?M`m6MdAVs(BAYRqQ#u$uBl-q5{0Z^YZ7ez62L5ED589ISS@sM+3<X{
z6RqS!%GnB5Y~(cqzDeX9OPV`T%>g3jKd@tS8x|Z0z6m}WTbp1^r3Lsy>jr>yV}@?s
zeNkGrt6%ccMH}~n83F!N;@4Yds)7>)&GsFG`DP(sb={5YnZE1%{+xD4QCE83H>%|p
zTV6^a1>(2W1&!xMq*jn;ak`-K(Zb}5Ma0*vbhY>fPpP_tPxVIn(K21Q6<6mIJOHXx
zTUT&6OsDfP*$Xt)*yJuGpTP}{2G!5jGML=9>b%VZ)e$eh-x<#&BaM=$*_${woY6Id
zG<(m=TdaeIW@%vP>+dtLs0f9Ht3cO{huC%9QfJ0bYpsxOl)Va8%cl4UKP?y;tL};x
zNA7BqN-$bHIB2@%HB#<Ko>=EoKx*>fTDtu($5wp1;7O+;bXg*S&bi0Q12O9VkpFb+
zIr&Vn&iN{x+V&XsA5ou08@a&EDSNM|-8mgGek2r-ktfq8C9$ZhdAD4c0Lc}x1qOzY
zvmTH)6hrw+m=in18R}i^0s~}PBJ^TVK8lvyZtJhHVuagja=r6~EsRgK!7RwHoVI2K
z4XPj4t@Le5$&E6%_^=$Pwgw@&ipUDnjI(?uq3bCgx~ce6u6wmh7uSie_tX$U3*aRV
zS=rRJd^zKqCMRN^2c|>EU7CQJ`;wU?nmKYl?2IzdE=}H1TcoSmh)G3}bN~|Um4!A$
zW+_oeh!U;AtS)cl%+$=W{7bcGg<0-&YIo@q+(<HGZ|%<@{RBN{#8N*F$vur-Rw*?-
zsAS;d663R_2ow-SwGdTE{Dr+P_9}>VBye4003g;k1Yi^8uk8>JCRs65^jprjEOlSF
zk+kDE-oLwS37@;zXcF#(<T;xGBHbn^VDcAjzktT;&*FwTLFjVi^6Ih~5Qwa9^|q8<
zpdF?;lRyUZZI_)MiVf}+N&)|6P&)qTY`|+(L0}Mi>cpE)e6z|og)+-eKP``wHIhSM
zLZ2LEp>e_H;T@ZGBNrvP22xf(uG*WhCvLJJTw<<S)8X;4QbKJQz)v2HJZr!IZ}g-S
z5D#Hd8S$OYCr;JOosKG#kF<_No;1{M=Xp?}c5#h6p!cMRoHdMf4!H88Ja1VD=9x{}
z86Xb&u#VM$DLsiiwD67|$5X<QmyMaC$<+HeI2e7y6qyKf^Fe;9KZ^lMRs^8$F-9+V
zmJr!>hICFesI-hGell*U_33shaM<G$pnopJU+MCpIj({~1LNH}xzEmp$LnDFtdf}}
zeUlB5`z6;1AN&9NyauSlY@HyzUkTM^>=#e*MBH|3bb<g~ZDe}sh`f}kqYf<oth<n&
z;tq^^=IlNE^llE>x^8h_*8!AP=hhRgXuBYOLXiNlARg@X#sg_|nY#KT(9U;ZI~xW-
zw_CsOhy!i{L&bQS9{eF=b{AWtOAACck~9~G?aq>y0_4ih8TdD{`HgSr?JhmFT^?nv
zX0I=ShLsh%gZlDx8U3c=OLEC2ikZ1#r|Yo~JC<yXfq{#torOOgROnXMZE=wd(-%%l
z*q)3LDV4EgSVh<o<J`LBm{mp1txnWmkX&`pumzV|-&sfScC0rTxzLgxZiq8;MrP=f
zoC3AQC@$+Q+4g6K5`~NE$;QDVGX0RZR4Sw1OjuI^A-wbX%b+scEaUmShk==dx(>F+
z;roL+KBG|#*Q|vd6sXY%txD>tOUo@D1m2VqMKo)}fbpMz@OUYJokeuA;xjZZ;XQ=7
zdp--r%#V?1GtM_JMW&i5d@4X1I(p4rw41>=4`jl6F>Z*6xW1xoA^KoUpC2Ib)N?lR
zAVTC1<$LT!N4!kgM%7hUN$v^t9S@g8Tj37$^$v9Ke_2tCD^J$99WKWe>PK;sui|{$
zylJDXjvF2KOBsc#u*LIk8R*%|x~PaDS!ho3g&@dQAMH?XvLHn?A?f|}U7%(h{KYNB
zdiye6^&V$<r4*7iokZdKbgI3nrQ#+<LW$0{rGJ&{eIg^UTL5^01cau_uG-0lQk0uK
ze}8S2_VmW788C;R{#FkE?`6zQ{~@5iNL8eNct*+#NROj&E=OwD+(;VAhqRjHj>3~u
zW&j>7NvN&DRGj)*v%M{xeKJVF9Ctb%@;qbWdeqOSv$nFkV0eZ{lT4ade&-a}ViClL
z`(C5^CdWSsrNI+fqMsT1)uhxsUKKDG1xP$mLttHWT|<=<ymsAi0!}mJCCHj1Hk_fd
z*u$DgN!>8$N+y>lF>muMaNd&SjY)X5rdx~4rovR=Tl3{KH~51%!2=9VU-xVz{eK(Q
za}GA5fkh}>iJtj<$`OlxZ?R(ry#j8p(HEmXxNT)F(G6-_bgA?9aTKqB0nEi``ce;F
z63B8OHw8&4p7LRa)B@`A^ff;hf#=G)HAoAVpMb$<lqvATI;GMVX^*Dh*dn9%8Y@pm
zK8Lh%O4<WG{}79rmSJjyy^)ZSSNRa~uYNpAwHaKft0V6;6lHK0!}yzaQ_`v((;ZAY
zE#pp@e;aaFYkaLoQ?Wxs$IKx5VUkD3lDcn1F?0PK%`}cA5n6nsiYLCU>G6rO%CGwF
zbkA}E?1WYN9M>fXhd%Ag3nP$p_ws$vZEB=2+$r;VPAWk{yA+3Q`jfh`s?dKCuHXh&
z@61%(ZeE6GcYk$p7j6No6A_5Ii3dy>Om7hUZ<|VLOoBYY`+H&Ht1sH42h4QAzj-1n
z?uS*)VK(e~F&2Ul`^9Dne`dBlYE+ZJ!gA`E+}-UhjxBwdEAq;#>2wOqneH<(|DD8h
z!<)%5M+xiF6VI(R)V|0e$NBb8txtN2&m9%IHLM*AygRBd9bJI-Zcb!Ctz#`R{g>(P
zMGm)+$@1(=cdTmg**W?C)ox~e&z^ooq?yO39M)5=v(I49i}i24dLJwrXT~u@X`j7-
z8v#E^h)TPZjA0kYamUlN1V&g#|4HFDxI85+ReIc4J~VJ4*4X5}GW?Te;itZdeY$0$
z4x~2JY`w|7L<{@u&*^-S(28!g{&1X4H5C=`s0*fhY|;&%e!AdnoJtpmp}sVT6i`Rq
zqjLVnZ~Cvl(#D7o3g1y77{TS3jWX8O?|?=GBl=`)*wZieOl=i+0WU(y<;CO*aw!UD
z0e)*?7*0!)q3XWpKCS=DRW>TBryr6~EX|B|uNnzIx8Bt*GPac7xE0tZ{7|4hWH^ek
zc@Iv!BOYWIh+S}9x92+Ix@~Zv0(BoQk?@-sp>qyN?u}ryc?zyG*-aUNQHt0Gf>1R-
z!afU5aBl}k{>-eHyzF+3RA0~-a>>|*`_{77S{W!6Tti^AUo&HGzXgzX(4cY4weGw;
z8mC^#)eNPFc2uF>afVX*%LDHe-7%jD{>gq&hn@j)75`2!p8j~vczjLST;g|p+b@`O
z<`)3)gHl0xZ+UwO0J8YnW-cgERB_b&j{I2;f|W>>0{SNV>+K-4Lh~?+bw3@d4(LiL
z2$gR|botcv`!!QKjisqPr*^B}<&IrVh;XzyD`dV!uIs|05#NELm3=f;;SH@UL>4v$
z{g1&pOQNKDVZlbZ&fgLFC7mRbBFO`bmV|`SGoW=lDd0X^@?E1LE%i>3pnw%5E9c~K
zlT`V)FM8$yL#aN2!7y`%2B^{bsc(EKyA|no(=GbmdjF`FF>h2`D_2eo5WuEHSk9S#
zPJZ*A8iiJhnZ5tqm_T+$jRS5I@r#id2uL&pRrtXM!okreK+oZNiz&lWT`|e93U#QU
zFcvrYT*&HxZinmpGk(STe4WUi9=TTo&<Zv+d1uf=@Q{vt9r4BT)`kQ!(zDpG<pb7Y
z8UdR!D}m4le;by6PQI2n2@CzxW1i?5(cMicRSU~nY&5od3aY1awvchW5swWqA&6I4
zMeyqj5Rm^f2wq}@jj*d5<>xZFQe{Zr9e6Y_mM8<K`v+)!9P!0lJ8F%|*J}^>QBDJc
zQofhdoS2VcXCVk(?!fV3{Ei!HJoa14?%Ip?GrkswkjK{2!ZmXYh?T%^Sc$t4dop>F
zll4}%mveCzHC4#mbN8V=z1$Z1e;2De3Z}Xn3o3d}ty?P=f{}0R)%&}<y;qhxzr{M!
ziXMuqPbE^amPG3o`1Z|*ID(eM49>S(nl;{o^utCrVkI6EgLrP7TL~R;Vo{%<KsDIW
zkxpi8hzj2iL@pH@$4VfJrDAu_7Gi^(4zZ1Z?z3y?%Qv1u#VG>3Q;T^{62d`9_BWsS
zWWRL#c@eU50u=Hg5!**5DHF!GjCEmYA`iw)bk7h^|2Q~M-7|YjbKBqg!0oSqvmhdp
zq@u|2h1Uwhf{sUH7n<~e$KQe1R0$WA7LiCO!sUVW@^{NNE5;Y1vkTy;3<&uNb;1cE
z&kt$mdUcVUS11MrH|khoxRZXeUmhJT7w&fo%=kFuYcRON4uyL0($lzCe5$q(1bA~E
znr!9>Cav2TtHW}AAVoEak;DopDRa!+eL|!8#Ew{0!~aXTy<^!hzQ>lnZ)*i7a#itY
zGdHc(hs{)>D%Wf*0C<W*)Q2xTb_e3o-le~w4WIRLj~Wm;eTg@)ziXtoKENR6e%LZS
zR>THm7XJc|>v4?7#+rO?vBSgqYuNN=P>8M1MU)`(;73*NwZ`K@gz`O3SoN5c1$4)J
zf0b~PC9H>6ok%a*88AJ}Fn{7r+y3fOmNW9M1l-ZZGg<*-ILEA=#WBbP!E>&y9acT`
z(J|EFw9pBABJA+pS0Zd6|JbM(d{eP&?AYs4=<X4LlhKuc3CxU|#$SzOO$4tIj@jiI
zdQgE}>oHJ;t>K3UQxc4Mnzi47@4c8#(;6FH;BtM(kXR=uJp~hnM6TcX_(GU+DC203
zhgiF#FX(H}#7DL;;z1JsY!Im_v~=lDx`)W7&+{G*oT9R&Dc>qPth=<ubI$NwERx`%
zN|aUHs&b^fYf)qHA9&%*Xs)&V59c7(lCgqV8QAk|Sw~f##!V8``CTuFFG#We2ZI@J
z$8Ysib~9AOokG?2p}ZS{zdL-`SWJ0nw%d1;Rg}2A3!ic?K{bJT+8zB6es`+(Fe1b`
zJ>850=DbhU(RY66ZBCFTx!XBV`xA}RB`qMBCcqx-9uT%LLv+vKsrP@#mM6+Yl4na@
zg%y8I10{1ksWurm(4gF}$=rKQyQ6;Ss=qO#6wInh%zAQjnLF`|l3r+5;&AXj;Mgp}
zLbTLn8f<?x5pYH<kdejRy$MwRr1jpTtyd6MBHPZ;@gQy){WueD-0<CV^|Aw=^6-s>
zPVmebPl|M0Qbnt<%~Hx`cN8F&TjeQsmC`npg83Tyi+m968Nb(e@dVD69AlM$%$M7Z
ztMO0B`U)uH^0)}kKZxgAS-QrH1EkRkmzhDKP?q<Tz-2uwsRVkS+ZUzGc?5F7rAf?H
zf6&C&j5u3zVLd%)4kl{Tp+uJDt#0U(VlVn9_%lO+8bxTgy0~A;Gz{F!5M)!VGj7Mn
zb9}+iW0{+}YL>jxrU#7P_b+uZbvbMMl3PQBxqIm-hYg8%q<0GJKd1Od#I--z-xpR&
z6gC#K6G4EZeS}6t+Fm=^lZA1GT$NaSSD4toZi4GUB8##)Ad*(m9U~@UPU_{x_=E`$
z=&3`aD4q_do)FZTdfQ>MZF)oYl$pg~nR*@@;gXyu-IeFcAXNA`5WMCdfA=N#`g?5F
z4ZwHOu!*DAIkG5eZcCruk?63<TWzg2R}7N~&8&scL~4Cw%KKT(DN}vEPdyu{wk-V7
zfT13p#h$qQZPULIEWNW!07B;{gv)?=3L@l$h0miho&rg^&f#^%o`rkq9DDh_e%FID
z_4e*UvbB%;wkP@_!PR1Rr|6(vY<rDxbXS@a#yQ@G#20vUf8JUy{7*cxHOrpJRKWf_
zMs)IJ$2fm^vCm+N3f6`t39>(hD0XWeftFmk=T5f|G#J)pCDMw;gAXW|b><Q4KW%$;
z>txJ|-0SdV#H{|WDyCVf!Q2Y(rV+%e)nCAnHG#KF@q%>O5v7W|mlLDy^NCqR->=^y
z%xhLj8W7{b6Oi@rce(yCKZ|Fg>WC4YL-J>w!Gpc@8?6t`)Kdc<Q|2cJ{PoP$<XwaE
zdwoL=EVMk*wMaOoJ~pf_hNzB?_AfXeK`dz3Zm71|rW4<OMt#Z51+g3^e9tSHB8i`F
z4zkwQJy*19Upi>~L+GW>$Sq%^QH~`!E>Z`e$(-IPrKnDRy?EX>s;}d#zo+_Yz)XX+
z05fgMN`1(`?xszBlHQ=tgf`&xp>4o-@7JY{{yDGJMewk+c2ewLfR3T{?Y#vX4U@$3
zac8ouVKXxVg<&&UC&a=AB@~ka<M!!8NX_v+vrIT-kF^5w6q%K!;H9!o0QwlkoK|LU
zt%x3*ROGG9!iUH4V7ajSMPj5O{wQyZVcOYt3_}8-lW49Ar#BfUnr&F>*h5oPg6|^S
zK;8piYF$+l_}uF-rjWn{h(^7m_VqGwfqpJYYr_Z2Yx5BaBM(<W6HBfC<VMZv-r~nM
z05*=v`Qu?ijzFP%A@lP9*b!rwSs4T?k7%%BqeU&BqYjCfbpUorW^n>kqJNFYC3Vbs
zljC7tpFROfJ1R9s;LWz98w5FK#w7}Zb~UI%82Kxwa~hx@z$LG(-iZZ_IXPqzudy#4
zPY30rp2Sgw)o9$a87VZ*aDO359W&z$k$JRK-8<5Jh_q&A1>Z8J39RL`9}p~$>T5=;
zM@)uSX6g44%Ak)C49Cq3Az2yKg?ge%Eqt2F+xeOKz7_$U;dy@;6rI%-C}<6UOI4(s
z&%TmX?R;iDBb;!<+ITP)A-4!La8EBQw0`H&9UU`Y0PitW=J|^UJJ(D<LzMvM27?W@
z!DB%7UW47YWR`CW8u%1X#zIt?0(vP#eMPP4X-Q?l2vgJ%&Sqn`!$O%tFkJpG<_(Vl
zFodmP0?uoyPee@5{qF?yr1rVX+eL^1(L1-EB>Q)ix-HCk>uFSsbTI#j-R(yOl^Ykf
zuFP;JDX{%A5RMHslmY^d2%L&*aG?PlE&CTlkhfES<GYn(_#@W3K&94gXRiQyI&E6o
zHBYTc)C@y*Y}bozV%Mxdj6kWo2fC^DAW5!&Bd8sjB3s@r6<jM2t-veV&Y?aAdye|p
z{UI9pA%vTc4^TeAj_naB!IttQ@=OFdqWDf2`#BUHTLwpqToZivHHUWi=~!&RRk4>J
zey{1Ph&|qvg~=UA8z4$gURNtncEFuUvfP?RgAAr;gY;R{_<lD$C*p=~um~Vq<IF3!
zN;UCl4eZjP*RF)nXG&<F7Vq^_(YY_D%|Wjfp|#1Sci2QO>kW^fQ4}QauBv3Q2hV!?
z5EpXby0^O>Jq?<MQu>k)oe(8m^hErv<^C)6{XZSrkn!Uv&MYV!B!9|9n}P=)*j#am
zfLKiJ!_(dxpw?Sl@djwEuWHU{IY=<ZFx)#p59dQtB~_Th&Ev1Pq&97D88I~s=Lvh_
zSP*`6qR^}@SwR7H(vlG5mt98EAPrd^#~@MfDb0~RED-E%Qt-bf&19AM<ZkW93FHU&
z7eMoW#xQ}*_<nElTK+{B5IW-8dD`gf5c>$yjkx$m$C*KQJzZ^J;SJ$Z2{pm0$hh%2
z8V=OB1&P^r&J4WRJ<N5`b$@Q;Ji}VPU{piM-|#V@AfAAel=Im|$XQzTd5Dj86+^ed
z_Dj&rSRl1AKUhSXQL=#f$lVeMS{tW=eYa1*WyhQ>4HeNpnVg(W`pl`D(C><Cv=X#r
zi^<16Sy4f-kgASolN|uB@JvuAYKZ%X@&IyPi}u*|89UL4`$_cV>-P%jP1S<L>pMS{
zAFV69PF$mzlk9fzM@|}Ts48zKZRG%*=+QzK=g`$vA(^K#d)c6H;cHua@&;S6?5~jq
zdLbb{TN@QSswtnXj)uoUL8X$GO1^KDdyv^d;j(WmZ%u4b8E5NGIR%u`7Jt`F?CCKr
zcBVwSA`W?dA-^nrtBPM-(e+`d*wLLbZljm-#L6OX!8sP9uaG}R?e6;zhH`H|GH601
zseJ<b=U5W+>p6a%j8_LQY*Ldzm#vm63(vC|-%sJQ^`g916F}uk+wMcg*|%-L-`<rK
z{S+}6QimN@55(`a@i+wwaNo|kLq$63W`1um)Yo|0Uy3X5?OJg-18U^Jlv30Tf1m>H
zFrt?-DS)TBDWnL0**E$e9y&d7#wG}>*>od3F67LIgl5}BgxWbgCMg<`?61FRDh(h7
zIL1~hiBymkJtco^<7}gtZl4HZw$~$7=0iV5azhJl8KYpN3MoKs!k~*3W7s`IrNV52
zQ>+j=0~X(p5Pu&}f<LiEM2|3n`lpXzUdu!LtxBubnvUy0E-_sh@Ia`D7U(gPD^kbt
z6+1A$!C9RL>{$7k^9F=-i|~ln;u1W@P3h!EhOPvX7N-)ilki5RXd8Alz8PXwwL$(u
zgixrVdPF$z+SsmT8o{{-WL4~;na_lzqgRa^G#F<#8&n-$NmI2nB3H*l_98Etgk}t#
z%tnk3A+7?MTwkym&I_DqX{I`$S}uGx6<$a>bPMJ2AYWZR3Y(@se@@W+Vr~l)EE8H^
zkS%Uk$ehyQv2@-W5%VLmCu6;DB&?sL!pupock;G;r)UDZM!Q)s@o3|U-JwvqeM_V9
zbbI2l<ZfV8Xrhqan}KatCqx)z+Ur8gq03F)F4NO~K;i}hY0nJE1F2sOA0{gYlX%0;
ziJE}MSF4*n)drB#e+?P4B5mL2Y0X_KvNu~{w<ayPe8OBcJZ1rNMu)8plrT%w@<tY2
zkU`b<<W$0kV5RxI&I~v=_UCKwe<|jRYjPrR^)anb^=O0}KU|^BuJEO>Ic_BUH}68W
zAeEIbSY9Khjt(L#(&@1(;SzSJMyG8vSLd?1P(q0#+&;-F&!!6^y1g44oF1bcW0(^Y
zzh4OxPTv$)bV)U^E{S4OP>V=!gELgzqAUFC)=tLyjNjqdmwZCXEth7}Edb9{H)Q{a
z$WjLX!fguhjDh=Ni@YLSOV~WcYbB@3T6meNsF=Gkf0lAuK9_R>!*~5Xcv5KUPnOEL
zX$^1?SshKe0%V?!ZWIDX&bl5GWSti{FYp6XP*i{{aN=sHbA|x`g@6QhA$;(IF#B|J
zy8DqO#C{vWE;z`!j-DO*K&G7sP)(??CrFRG!=lEUzjp#4Yl1uzCn>l9LarI1ykD77
z8~4&=&h(@1N<ws*31AN&E7tmjyLJhiKWlhSr@}4U?h;G*x<C}v^BHs1V#H|g`?~gA
z<#A_#g=4)@-QI1H_5D#b%hScCm}f&+e2;L#W)u%E&|rJ)(h*p2cC%5Vg><x7I&d`!
z7pqpf-L<MD*8yL*Mhg?KcIHt_sFq_iH++$!|JdErHVo}|8h}bkW3@44LZGdsu+3vP
z+-``U8I-8q%U0+f%0&}{C9<UCwdl;j2{*ARP8|B!mTHgPCp^_oP$A)aUT(T}MT7x~
zO<Gp<dl^ilmM7>7#eS_9&rNR~_ueprVg~i-ACk!__QmJx#Ng08R(8B%2q7chK@16a
z{zsU@nUx~Z)peJCMc+CMhogYzqwDGpKBO|&3{rSAi`bW?(wRvVipxa*lmkna@@^1B
zwl*(f7*|B>6?sBT9k2UV?EsA{S!;X=1_?EDP~xn3C%P}<Ox(M#3<3ADzGN^6Quv3^
zMG9t+chPqSLdOfEGSsL`n5L|Caq|HgOa<KC*s?z3$n<P}zyqDKF(@v)3nlK|xoX7J
zQ#IHV!idoMD}6{JTG{T-MIk`SrB}l*UxK#dMTx6*;Ld@lUph6t1*7iM$cK{N%gKlW
z`VyC*rh-%yfrHUXb?ycq+|c$`peSvPPQ`<%f`4q(ReL4Z4{pW7+(s!{LvaQtImdx~
zQ#(?Crs}$1I1k%V#nE#r-4x*wwwIbrQ|q~cN*`%LE?kz=(z%L}{3sPOLWAnPh<$ar
z{Qo@xQ#=1YItfwMEIm3xGYQLnf2F7+zw=JlcGUB<c?K>A68ZB>z{xev`URzKfrTL2
zMG!tYZ+ua}b%+?IVAHx(O42Q8$L2?H^`s*OV>ho+wFxfxpJ158Y*n>3Qry^34$bPR
z?i7xf;DlJLd%q(R9oHim-o)CIHs>92DXO1fwj@hY-VKzZFu2<vJI6MT$Q@a@w?P4w
zkeqYHS=5k;O-G_js{e2ur%h{UCz5PY9pyt#7eKb5njLt=;q~NTg=-_A*E)lFhPC}!
zZ5;psu>pHlf$6NxdLcc<HBYN7k<1Y>gQ#fk<??*L?bXxvQemcXC0R80#ZD%&huVOP
z%nGkGZ)m^#)+vwz%i4>7>74yK4}gZN>AIX*%I|f;1z`R>*xni8L<!gDqDP7Y6#cZ^
z0PxF^ph+V8>$D9=_~0C1HAA+bb8DW=Y4%7DX(2uAKsO2UJBuWw*XZdFxjf)F{j=m4
zMai86!c5|}-Qbf)3#&n4Br}0a)0gd=;lp3)uF`eQa+~c&zBlLPpsL77|LaGcseIVV
z7H10?y|8*@Cp!Q_8Df~PDJ=qQ0P^7tiCt@MNm^6`6x63A5k5Pi>^aLhG@m>nx9Sxy
z;jXjt=8QF*%dW(~?(q!xa-FgfR$oX2Qj1cv;kDL9P;6PQ`2Pa|ReEuZc&_jG@(64w
z@NVo^vj9Vl(uUsNJRBZ@k;W^TuiS)$eI&`dMv;wXQ6t`pj=+X95aX_tLF?t{m(tMb
zY$Kc?4?FKnm&`B~1?>qzUYyiD)mQ)N&h4f<JV9nWLW|b&exCIs&tyK6uf+9KBdjAI
zABiFEjnvVsI|ftLXEk()uXQ9kGG+-WR6-aRj?;~xG>jwg>~42B@~AVqZk_(lfEudi
zAqrjTqax2pX3EG_`L5G%Bu`uagSS8E3i)R!giolvtJAMG;E}o`|6;3{qj@JUU|=-X
zt4PY?3fN5Vxy1WCqXv*n7V*GUKBx$Pjaz&&#{MAgf&zv}u#$wib7kQu3>=#8TL(pZ
zgST$VJQehoXm(f+2disZB|e(uu0nbY8(;ixp?3JNmc&&!wC2#7xZy@SFgK0+D@B35
z$gE@1U#DXp`XSh#+;ZvvQY%{ka`(e05THeK@B91f2Qw;Dp5a?nmggYjU@LaXBMYKE
z=*rx~%xPP<rAP^tK+oJq_!MS}!H4NaRHQCC<g+YQ0NDDv$ux?-di-!61Vgx5t3^x5
z4WOP2kZQ?DWc~qVA941=dv!x;gw05Jxt`984A0r3kh|?omNc#$TgWk*kI&B4zw^@Z
zJZ@pJY+ZjUJhdG8oVpwViS2moXNsfQy1_Q;`>zQTS^M^UuRffqdb$1gg9e`4YVNAx
zFv035rWe5>cskJlx0@}4VBns}bw0RF_*EEGNpvP6Scmc&WU8IO^fVD?J=m#mAlifN
zuF)P-y+G$&cCaf-{+$NcX_kULE=HC`bNh9y5_e6BVRmX$Rud}s;d_b4X$yS6ve~_0
z&E)EyFKn=>5&pAvwag*`x{YZrLjyIR@++<e(Q((1GFObvfxP6*nCgMqu`G&1%SBO&
zcfySADHcLOX8xpXGN*<54_uxwhfjOmop^enr!C(_(2{SeC@A#HopVaj!`7u*Do<(I
za})Vs0W<AVSec3Jwcn4>;q-|n+doP3#A*pIJ<%wuV>C*J;e-%}4XfxNeg3vEufeo<
z-(`=c&;twpZuO|)|9cpZ^c!$oqD7_eKdY0y%sUDG3aFG}6BNS%ot$5_Twi!@4;Y?p
ztGW@%!c@#?wi9+TqUmXXO$r^0jp=6@mn?3?&6FCDCCH72r&#?T*=ddVrbN9R{NlN3
z>UT#~g!WWBBC}f8V^-JoEkQ*9|GB?TE8)=S^_pih07zvx5q<t$reM7Cw*KhJUTtqs
z4ef-=wuB0)zx9-I9r~WLyL@APPAyBSQ!Vtdi=%sZldZtx_s2Mcn{CE@w9z*dtzy@c
z@XJ_Vvg)ZW16xmB^Th{zw)f&5A#W@qd2r~7pHW~_e=}2+JQg$*5|}u!2zKR}-W+@8
z<k?3ENf-)r85v@P1jLn+JfvG5coDO}QM3eQfB?2hOoS-HPxKDeDJ4xJXAa&|H}ZCy
z0Ix+6SLqEfSs2EkbWJ=#IdAo<u{yNTSmMT9uZq(kcs9~)fcCXK!e4|dZG>a|c57Z)
zDc_m|s^%(>(P?dMyZ(~i|82flCHJ%Hh-YA1k^b0DyAnWI<xB}3cM4@~w}CZ>E7yXG
ziL4zq+k#djv}UNcOVRRAw1a&qDJqB|s5sO1_KIvi{`lY5Nypd3Jvyd=IR^r}1f#Mj
z9AkPzS=(caXDjA8CjB9S8W=!XL_gP5zk29hQlGmz%e;&Plr<%+wrH;JadfX_zK>)l
z&mF`TbZm4esZvH?GmF<fDy)?3y&Pa_7*90>l5u@hXvu9WioJ_e>6}y5=O$t}a8JHo
zvBBI;y9QW;g*zlo_+T19Km`$n|L$e(?lm^j2Nw_Hh=A^=2btDym_$xrnP2eiW9X%0
zb0)Q`xuvlH$psA_6T%m<*E{0NF^PTU079eSr3P{bViZstiBmeh)5wrX%AYJF+S!|o
z5IKs0TxPn<c{J#wuPMbjJ69~i6Eut1bvTZ(nWSW3Mj<}<)S)54_}@b(9|=EMn+e|V
z`PUJIWg@j8{Cd|rI_z;h-7A{oe@OG#W%VmQ5gl)_aBQ!xWZY?j%yV2eJybV_8hO<X
zkM;7D5(|V+=tC3b(D``#=Q$j{OKH@~gO#}0<R?L`YkI?<lXGp|GeDV+K09gECIEcs
z|0_nX71nwfZnfLQ)hDLg>>bv8MJaE2BWr<@GwDnq)~-#*z_SQ(sE;a+hv!r*O#nv=
z^C7Crjj+S4=G~#IjAhu_9$sGiR-^qg<@Eo_t^eHUF}))CJQB6STHvsK>5f{hqoiYP
zDb=vJd4?Zk&TBjrrGYo_;$0O9^UnT)uPR*IUWER7zF1Wt#f{PfdRPQ3Bt`oMm9Piv
z|G<Am>Msxro*=Te23v~XZhGP-&#%G(5JJ$g-LK>wJ*#RMlyp0IWt<<^z6|YU-H@~a
z4x*Db?7a1tgyy5uS0+>b4h%tmvV{B0nlzY6XmKM`hh%av!G)S=(EJ-kPsEA>&3gIH
z_86#P6wbTr;+Ngnyl!UB6;ph+8%9w;2e?w}+>Vii?J=MDFmI{Qc_{Htn~?Py9(5Uj
zDLLbXhSYXTx~1q$Ka+hKpcMbgrW??-IsiRJWJCuy!ef$b?_FBc)Np0mg_geXi;~j!
zZY*xUWP~kmf;A2N(mjD9pjrj-P!>FA#t%do6feUbscAZtD;<dt@+W3@-aK&K#!^j&
z0Mmj%<gO7DxlYSL+{ca({7#dg6gAHu3Rz+Gq)oQO&%Z#N_vc`7o!%~-61}bRo%7HP
zWvbAkCwM?QQTQEgJJ^OYW=I1MPho%5_KBtBayyFL1;m6=2&iO4-L(s%oR5LUl9IZQ
z8luZBjTkr`Q*<YGxgRaJ3H9{h`-L*;+h#fH5f&1w;#p`cV1q9A5^nHo1#;=o5|TC-
zU6GZ4bc}HBdjEhM2v9=Qokge?$z6v~pm=jKLA?EW{qEqz_~`)vyF+jhHh3`;z*CtO
zeMS-7i$d1f<PvE#O*^$M5YqX&Am=OG0P(o$iDUH2Uf&uy+@)lhqC1!V_1{e3By)1|
z#S}@MzYP^S%#*pSWGuSAo-gGrJ<@DFVas|L?)$h)WAb~67Xu86J7BfX_&LT=>uFzq
zW4<uX|BH$+S|PR8SHp`{)~TlGVg@QQ^fbT*HZ+c7_n65KMh`Z@popt|VUNt!MwbX*
z<T4bj_qnGN>(j;NXmhm7Tx3C_Y^A)V8fk%1N7HaHf<KaK{IrvJ|0sDSS>VbPeVKPr
z9`8%amgV2*L{PrFrxAY*Rt2n10$Y8(;%iV%wdNDvW?se&2Gf8eT2c|DGhGrI|3tCr
z=&GBCt!@YbS;GE%F8onXP{u<|icAM!U$=JwS(^F=2zB`f#!s4Qml}S-Kj9h!?fRYF
z1iQ9~6jaUW6n;0J_)ZwV(vBm6*){bJrYTBQoGq9(6w5s)@c$osqKRZe{hg&xlI|~k
zd&h}$<L96I8z=erW^$uORMmnyQwKK1^BvGA(n8xRxi?aKR9x8-nxl?93BmdH%@Mm=
zp^xLNqeIFLCWDc@ndv(CC}i6<-dX@NK+L~4=FxIE;J~2NJ(8!7XhHCMaci6s2m?jM
z=Z<|cy8YZLF2T|p*^u}D?^%c-mw~ND?!I}xjj3qJSotYUr$s_WY1iT~F33*hhbmA&
z&7css#5T|Cpa6O-mpapHuxtPLTjfleBBUOoxz=A%7>BmSNQtE=kYF*X_zZ$OmMDc4
zGrGGCs)=9I90is&i_8%Wd(ZS;Z!-Z7N#5DIJa5pjtTgYqJy*0jp0Pd_r^ZRG-Mpkj
zfL1b_tl84f9G=r}EjzRJRoZMw9flpIf}cb(%2H#YHlNcf&ZixLA-;XxI-7;%Lhn6-
zKReVoZw~{sC)r#DB<wuXMRh2?{`}(sw2fX<Hap%lNmS_b+DdCG9r^Q1s0<f1-}Ma0
z(=`M1@f0;g<T0Yz_Zi^34;fI+c|^<!XgFx!U<5&;CA9D#cZ9%DK$1wA|92-O=T>cZ
zN};lb)_RRQKZPL&V{PA7CQ_NE+t+7YPd|^}FB9%$QKb2JdK1SsnI9?RUAmwxQ+)+M
z0-U!P%uqQp1Jq7-AP7DK0H>Q11mo^8L`j36Q^Y=+D|_Vpo_lW<PSycUOy2*z%tyO)
z`etETUVS4|IRK_wTAEi~4bzckgx%5H*A@&A0O=RDtuaZrLhw`?DFOl(g4C?^6rx%}
z-pQarQchmGq4hevlk1p5eC4CmlDGXB+_?<e3;Tirxa;V16L8^93&C!W7P$GL|I@YW
zE?|D`eX_(NcHS2vs}f+yDz10N;aV=b8nx=weik+tm-DM6=fvcE?@&Q5A$Xd!^T(b3
zyULt9mi9@TE?$j}w@gD8U#(V7o!#`rtT4I;6fX^ZO*nlFap0b48O{<5INC#%PFXh`
zb$ZUMf{eIN(jFjKXt;}kN$XYWATo48uDz48To%^G12{&M;3$(!h8X8BVt7xxy}B0U
z19(vvOQfH{Olw!5Q4T6yC$^^$aV7KhG?AlqFbS@5kk7ksSrnRJvAx9?=G|X}5eqBw
z!8gZa9c8wxU4k;D68biPBzPxOV+dt>T$K`hto&kZR?n?RYSo1F2>E4cvCk{iC}$N2
zgW%;`myV)%gS?D?Z-AA!((yHot_S&RE*!auiyjxj)-EEH&UG*JI;tqn)-JpQiN(X<
zF_rOVxpHjN1%Vso($8Hx=SK^2pi|sV;>NVTm`J^_!@@Y!B#V%YDfAQ?BE>C@H3Qy6
zTx$(UC@vq%WmIbNiIgA{842C!_PeVyWWR$#{{?qz!Jb-%k6X~OmPA9}TXX_0X$(Fa
zjhAjG@Ak1(#ouY=;Eiw_I}T<3h9`@T8mvYZ;%UQtCV0v&(6~t>F)?N?pp6u$Ij+na
zOMx*8@ue9kZ5Op&Ul;D!dKMc%|4#hRgm5!Kl%r_LNy+oBT}KdVz01ssSeRKuU97`Y
zEEOhGOI@A6RE__;C(<@nIA0dM4?mx-$#!btsj8}0(_*zlg3PyL1p>2+o9&9^D?dOo
zU{;tuC+FD)vRFPI<e$MAs~t`-SKEOJkWTuswGD}D;t-7zoz~EEFyUW891S;93@M7r
z^7d{PLS4Xe%oj9`*!N0ID0_ZOBC-33wEyKuWiyoNJB{aB<n4X0Pvkt{GnWkS9pc@s
z*NZ46LAAhsqfo_cvg7Ze56t2sSDvHf`>&15!pY)S8-N+-_2A}ELN!b;S*hZ{LO(7^
zl0P{Y60s0-p^x&E-ZxLEX-^e5aLBp_{>h1l^!^yyKR%**AvZcnWg{Z{zg@CHpres-
zDrLU>?P0u7noIlIlG~o{f`4CoU2W|YHY^Ja>)mWurR4m_d)D;yt_t&4b3RJy=!%(%
z7Y_!*i-_vy^6_Oa-rWE6Q#LEHHyh%G<IGv-5MCJ|kr7Zr9s#XTB~e$hN$zr+UK{or
z)h7It;RVgH{Kxa9BIjY+5CWruNk-f<n6Zg%S17|AgERyYwBGq_djQ(bYmcf>w>7>+
z6O--2A&T9awfl|n?qWmOF7IH3W@$z4n8-+g3EVuChB3Dpf^^6c&%aWNJnMME%qfx<
zg+nZ`%~Te!ti)~UIQ^?60B0A|esIuQX}=llN_aqe{x7Too;?R|v&788%X!dIN!I&6
z##Q4Z{^q-z-HV1Iw`u8^8bD|-lF1uK=+w$~5Gpnzc@106`Q8FDcBER{7{_<D{~lPP
zz?h~0TO1J7Kk$Alq6(Mh2P?q#tKoJ=>%pDnVHIb56u?kkMDfIASlSx1ERwPw!pVV_
z?ogQId771u;!?!Ts_6|eQ6je3dKsCo+Z5%vvp@pBMc@m{u!np^0}xu7zw>%khMwze
z1G#>H1t?=ark3U>-aQGiZy0jBs{mslx7)MGk!GF<CDpKu6fK`seI9rknY#5(IBnhm
z1+5JnVmff#9VV>e1ff(=kq`0_9|dj3o$qL?n8SCjz4SZuYxwK5mGXGA9OO-}U27M~
z9}q+}qyk>h()~84CjO$h70qpcGsdFy2yh>kkMZB4lI?y)mP@|0U*nA5bQ=5ysdR$K
z$%N<kG~7qY&%c8n1p*pq|4)Y5J2kh`y>H#x)Dr*o_7bcZ6@vhTJYmu-I@82>_N;Gy
zE@eL1t5ohEz&g`Q@(Mal)G@X0-iJA_x+-u+9P<_!nA*#w5((QZ_YKYS?*L6h@`E>0
zIOlO#$bfvIR<vU~!|iv0pTB<Ml+JoPTnV4G4gNkHUocCfXaUSaoLG8yXs7*q13k0E
z1u=zCfDs|@Jwk`XxKZ|f9$Jg;l)I7B(4^+78nGZBZfL*bg(i-C4s&nAo%4Mxok=bj
zQTJ^F;-P;b>9oH;p}E!1C!7%w!((GXbAl5S+0<Nz6`2N}16Ry-3eLc19>9_<1tG0(
zUr9!?+l9Wa!L41=x_+)Ng)T21g>bAALVGK^FKFi10VsA<iQGNt-I8HwBWH7vpAF@C
z=ZVwH^*M}brAO*o@2-;X%hkq+uO0@phs3JBVBFieu*Y23<jSCsK1rMCrV7I`f9-8+
z9<f8a;(n>p!r)5_KPH|s(+*Wup_{APkQ5GR_lnO3XRvOe136hGIHm!+nJYiH2G6*2
zPU5K@mNjstZOJrqt4BL$Aw!q^l}D_)F#c*MyqANpw!+e!ZnX+G?&XtSqE-EIEJte?
zaC_0n=x>Lm8b8%S1*Q$No^?nzvrbSE0Xz?7yP~(5cSl&^5Sx#{l7H9>M;ZW#LWibC
zkS@D7?q=l(ZkwmtB#FnoquUK{J>{Kd3qiA!)BjT&n<VcJKro%~NhvI<!XCcL6|JH9
zNF6$bDp7DTsQEi$+YdAn+|fG{^K*K{GfNYLxmn{k?GViKj!cZ_G`q|pIA9im<8tDJ
z$Tw$3{2^~5RHP$Q?>5cume}kM4eQv8o76EG4cp2%+*`-aoVQ!YUW!%ca;8kaO;l;w
zLd_+7Ph8FrJp%D3_B&6GP+ws{v2>8Zm7Gid0rrn{(lprP=XdAW)+8Q=iA6N<Cf?A6
zo@!wp*~FMD)#+9N(dng@j|cWrY>O-T+@RbfwSC8X)gr_b42Yk((KYWBV^Gn{{anHt
z6ObeEW9FDR7$`I_d-xP(;#F)pi)z2iJPMrB)AYOhw{NTDT5-$GgX)DXj~|O#V=^>r
za;P)ehS`5`c=@2-ZR-1<9z=qDpRrf@&Kzo13+7m-xvC*e1q&1v6U@}AQWL7stgU*$
zGRWSwARw<5$S9nv6+{*kwTCO(ee&tq$sTzx&mBBOQ|t-`iv(0O@fH<;)8hw9r+fs^
z=#!UUn)t8QDdY4{$9I2<i*y29XnpLZ^E>Y-&qb+eO$pfic~-|Bj&JnpKyMlqMSd+o
zecdp0jejuMDuXq7O7?DHZg0Qmn3?!5RY*7xsOk!tp0|=!g5E7Lop~XgM%>3iUqXq!
zNIf@2yicE&R1Atr?`=q3vCmWu0(SRbfFt9~t7d%r+~>6E3})aS&c>M!1D=`ixxIId
zx=?-Y;Sxh4T^E6%LOOu^jG@wC&nIcj^_YpRT6i!YKwQLT*yyn|clJEabK#doN5|%R
zsv=~AMn{%e0hJ%f?#*{p2umMYT}HV}zNi~*&orHekq2k9qYIH5L5fGN<N}edgvYy4
z-)wX)^MgMh7Ses%&xGi(U8P$IT4i;yDW?;{gtw>GbZRz?g+vEk$^6jAAHv7WFONwK
z4+$ur2|Fsd$+BD+hIjyt*=#MBcm)bp%ysYla4jz6Q2m&>-x6`qmw0f=!`-2|^!jsf
z`zt{ZW9BH?CPQwsTNC^maIQno{EYCUyftg7E88j<%tJIdQ{0wHpG{{xGbwpSNRvwT
z!y}((?VN11^Q5irvrs3On9K{GbTmXi@KWL6$<F&2Kv8cGle>*7*VEy4L(tjbqQ_J+
zgVZ5sm%11ejxulPBLzF24&r8OXieQ2E<sa}>a*TGpcm(zZ0y7<k}lKJ-uv*33`A{k
zd8lQ0Wl5z1s#~CtNkUT!3;On{RZ_35Ov$MDff_Tkt7XP^S#6E*&A~|Ce&=qbaOS5u
z8~IgP|A!b6e*KO3hPbh(>*Uy<mf(pdU=T8N+o711gw=m-NilcV`ZT9qkNDGdL6ew6
z*D28|y1nGI_-_?pTK)DN5+T^^HPM%UVMF3V^iA%OcQR)AlPG3gf1E>w92a7-A2jLr
zy4_Fg8o{al4qIq$<R^!{@PheOnX9?fz3s@CGRN~<$z6b^*@;*2VSv`lZk;oiJss1v
z2ZFd~3Gw}2Eh8lyAeF7n2BLV?X&3}yK|g)N4NNxbp6<psrLeZ>rtz$j@C-ORL!BhX
zC67GZtfa%b?q;KlWXisl{;aJGN_+o1UqI2V;2MZmG<rx}E(}G|A_R~=`GNkwJDX>M
ziw(e%q~S?KE#tRJmi<Zu5M|K<M*k#|H853tYwAXmMY)^!5f$eMqGG{_fg*9G|3Kg~
z(G}>03jd+D?PoO*oO~_^`nc7E*e?F*Er)vG)mY?Sz3lc~K~kMjvLzK>hC?hI(2rr&
z^Hzz+1O%9$b5abKR^i-f`R8}{MM)Nj-xn%?3a*5ep#N|}>sQoeK&(Li$vRgKFux-|
zJ|Cj$q+DRf1$L(etR-$dYS;5pn93?_u;QFJVGg?8Bom;wH{!R5ix@;SHHn;kkS|fA
z1&>ZF6Ch6yn4a8GKdBQDztqy?155vV5x&sYV9;NzHnwB!eLZtxG3e49^qim}85V2^
zCR%0Wna(@Mcx}<6>0a=1x}ArGjIqX#=gE|-%7Oj4hCoJiMsx;2U}o2mM+@z92@A(z
zarm<CLc|}1mNx5y#@fdY@PB(Bdgn@`SIRp2@R_Ztl_nuHBCpOGdIv=Hs$`oy7Hp#-
z<Y7xK@dLl%N#lnP&8u}jFN-Obn1H6j(Q3NTZ@T<Q*}?}t97f+XYvcfi&gWfpv4PD;
zq~3Pm=4!!K1CD=lpIQn!eJA?jp^Aeq>kUp%vZHj?AGx|usjqs+(Nap4k}Dxpbqc1~
zXm31mkYnM>d@x7GsL49ft~keiQ?B6`j?m_ZVPu34h#a|I5NX&RwEomqAjUcSr}5_X
z-Q;^KyX-|eEuxa0X@mgzDgT3~p3d|<zHlllvMC5N%QI}HZkvUL+K1?26xga9644r3
zqJrjN(vWTQQ?hNV9D>yn=t|5#V$iZWCmk<!n3i9>%mxu!;+Jdj)DDz`hrM~J7z81$
z!C#@l{$)5`#Lf$13W9*bjx{Lo^dcUkOI_^WNzSs=X}K=&#th&MJkWn7Q|W}Jj6v@G
znV8F9cd6=Oh-Use*f*|z{VYRQPzXe15?;|-v>~i_aqp#lU6NBGl@tF&aK8H51)yB3
z7AEf<_BWE1B1X155>kddc~FCCBJZ3!Np5WN5WTl@1rl`Yw@Gn^?+(ASF`}bn5J?#=
z`DPVKvv;pLz0#Hot(`sqer6plj+)5DTYcT1;qE%6<1Jyuh+f8~L!+N7KZ;-i64)9N
z(zrGPyG87SRotJ}gQOKp_U3*k$H-h<$(o<KMgcE9F#BqGqhS#v_*ZTw3~w57U8|w*
zt^aV5ph|&T5fiZCK(_PNnoTGzp#0@Vgfjx+VTZ3FZ6kW4R*ym<RF|ps&ah?MFX4-z
zJiEO!wWwE8dw~e1kumXXM48U!i8?e|ded}vKZJ+`f$OLnmt#bj<UtMHHf<Ipc-nAM
z+0VHpMf|zG`lPFp8~3&5YOaN2P%EX)yqVgjV;aY&<T=6yXm7^ntCM;O<<}%XuePm9
zWGFgN2j%mM3To?|jMK>&a|K0o20FG%YbR%EP?7Z4?Rhobw?&*EMap&q*<^M%@0*vV
z=RM1H(^_7bDNO&lMQSLE&kHZMF{?rr*vwT%1Rk<JeWcB7r3fq30flA#245^7;>)Ts
zARI8|K8r&-vx?|ndk2Qv83LAWaN@cgIN9d}z)sSt5pUGjv{2k-`xn!Hd;$ezl-vGM
zeNh;zq1n6B{oqsu9~L+U7AFSjvSZkim)@IwsyPSK*i+5L#tL#wtE!Y{emy&QyozLd
z(h;3v9}A)_4VS$D9$e&)J-|7bG%x!8-yU#=Mm#Fj1mYu(D<x_-r1LIrbeMe`>hYcm
zqHKI9yh5yiDEXg+Kh-7j)X<t{^0`mqP<WtXr_x+IP-vZ`IhGgSyNu+U7IQplfA*ZB
zZj?{x@gsEm1DT$2!G&g1(R2$$0*2hQ3t;-9;eXG#1{r}QJYe8|5BX4u{N)Dok>uYH
zK9u-g_p+qEpfIS?D&TQrtjx6#o#^PPK@?|h(ev5NXAIYa7bKW(3-E<g`JP}wN#7o>
zF|*f-x)Xv6Brfp&$A&Xq@7{)%AiAV2IK~WkxY4qys_8s;74{D9o(~va$zeC7Av-CJ
zmh4Oy@Nw&33iyq3VlxWMEPzuq_~YdqE-B3EFO!7i;{-qc5O<n*0$nmAJpb>qXxcbP
zt_xoC>MbrRN1FNM%e$1`r4?x4QS@XgZ(gcY=9vv4IYZtSTyhN6yhyXx6rEWf?B#%T
zOH1yGU;#$dAlWUteO+Y=e6vF1ChjOH137RTDI?YcidOA#6lH9{lZ;1*i!YPavarR#
zQ`gkyQD`IdeqPxCEJ=aPdHN*y(LFDINi$?nFMl=SS0G(&5s|Av4LkT{lh}WaNfTV1
z8AbO)Eb6g?teS27LBk!mq!WVmyK8`#wuYbeD!k~Wr?pYXLh$U?iIjXCz!^8@Zxr#_
ze*TcG#10yHVyXsn-vjJ8?~%^V8-&p1YO821f}Bg=Y+1_As5Ys*)*<6f@5B6uC@)s8
zOo>DoL$|?%JMPSNKr6-&!kVDehH`Cyoxf+e%|Fk&%&Qp1zbXW1D-KR3B@+JLD_i3t
zVMaT$t937a`M4h&tQi`I{U??>l5E<F;4XfXf01t+7SahudG`wzGw3(A?O8Iv3lpK>
zm30E@;45B2oXt8t9M_iqg~Vl)5iO(-0O2ub2F6x@Rkoz0u*Y|Dj-k<@jM^zky%ZWC
zew|NxrqZ*eN9yg=&l{|Xp?5rxW!h;j5Cb3}Ec`O{r(Q0<yn<53K~nS~im3XmdR?cS
z>LPU`4+y!ts}7^T;K$p3YpIT<&c4xgY^JZTbBh|Mu?Q%5&i!aUKxGN~(ycYzCPHEc
z2~BS-YslXN)BbQb>5~=@sFMUt`ol+bivgEDLk;7Fr)R1S?lZoE(sIuRV>9+aQ;`p>
z3vmd|TM)cA<Z52i4Wo}z=~aRvo|PAmG0iAf(`o0ofk-dLZLxnpoA1d&hiWmqguefb
z9jpzB56dx}(PS-j9Tw3V{EGzTaT4eGEIpso+Z&8EouxVFhQV3Rz)?tq*Qosc^3042
zbu8o`P6hpgNBK)~4JXysKIGJV_?igKAHec>yC!^bu0Tt55UgI%K}57%qj#_PfFwaD
zIqJNnUne6BHjH|)KfI7dv3-*`T7}d>1J|XTDTJB(yaUy#{B^Z(VnRCq9);jDPbgKY
zZtXHLXQsj<x%p5K0xQn|Sn~=EC;O{9Y-5_rj%_0~lxUqsb$t9y^{`Ya%LeA2qey?3
z;Oo#X>cDA1YS@$0*=)`$nbDBp!E*JU^ftoSDE_^)-giEKn>;6%`uE2BP-ZrTOY3D3
zjH6l}Q-idN{|CWhjIMk{_k|ja8L#mVFYF?;)~&}Sk0#Vfk;XZlQ#!xh{xnFN3s>l)
zk|oEvP-AUjc$oJOd%qs_7#nybI24)!r&xhK@QUa0?7yZ-%2a}RE}R}o55Qt?1**Dm
z%w*#G?M29EdOMFY5}~_ZVXeATKAT6a#|Bo&nhb1dOz~>rnETDle^cPuhW>hLFD9t^
z$(kPfPlJO}b7K}xk)2rWcp)w?0D<FK;~7p(e2u{fmfj*Fs8&ZcO>gRh)nPoMP7+aH
z<gCQ^T76dPlR8xhfhx2?Lo!=HFW;)5#zN&ZahdT5?f_YytZqIZ=H2J@Tg|(v-f^7y
z%EtNd9?Iz#y<M#kF4{wSt8p^oq8B=dUCJhcQK$5x{z{vcH3leEmElRfG<A<NX7%<*
z(XWIEmG<ULXe+&Frm^7(eD~PL%zskS4h(7)8_9kV@_K~KfsM93xw~rvdZe(^4Mx!T
z>7#XDoxqa9X38Elp_C|!G1k^g@I1BEa{0tN#AL_q`Ntn!wFwa=%)kc$&6Ve7HK$g|
z;l<y^?mMe-_04*mA<lj+{MsQWu16GH;hao+?cU-w`JP$#2_D5w!#|ELaH8?d7imM+
z18572N61KAB{pQzY$0^OF>oJb?<T^H&}tsnQ!sz4YI+kw3^?8R*$!m#{Y)4NIYKk~
zSAQd0?FYR`U>7Ct8Gr&W#Z39IdRNf_MCM5G&r4$Wd|<GH1g@316^v%1j<s@%v?66%
z>d>^)YDE)TZ$iN$rO%%*gBH&zjc&Oxly8A{Z%e<2P!xj&K|jC&kI00#jiuQb6R|VT
zN;;a|zscSNV4py+bKz!7u5rMCJ|+rWmm8oJ{%~%xiFYwtFbhP!H~8>mB}KPSTlCss
zsaiEp5nIu33oiSCs*ZgPl*V?!#z$xxzH7b@#L_@FfNCM$8q%u-34bgLRzE~OGKX2@
z{NKnYP)z^}?mJOI=lLl8s!&|?0%>G5|6xqb35U`R6I#TrOq=dA|E)vo+KLMld56uL
zhMfefzYplHF7wALbh~v+_*Y*z?w8Q#WC-TnU1te&f}ELs?j&cnLvfW2)+~dcFP>!9
zD19R?_)%mj3`N1MWXwW2t3eQ3$`8yfY-Z-(hSoU3<JP2`q8_nEfdzMPOf^h@gVmhB
zkMG98zBl=n+MKJPa=1A-&MpzqaIL2ABiU-yRK>pMb1?T7$tIa!vNaP(d`m%LpTxH8
zrNkuO_X9Xd3n2-&OMei(0Lll4f8aI(sJmI4AaZb;0|cw%3uKR#3-oEyQV5CC?|OdO
zYmCM7V$}0`p#-7(yin)<XmMW?nIHLvC5e=>MzF!U#aJ|4cz!&zh9$bNYS~}vtv4E~
z+H83mZg01PhonT@K}c+Phu#j^hso#pp#CV0aZ{?jTG%vre9&D-dy`rn!7V>>UdxnX
ze+^pZ>E8?E*b#VM0a+^LlYD(VjMrPhpfpU&6#!pNNZ8;E&ycJL@RJAYiMDwnnT}pP
zV3DnDoV5_jl*(0W`u)?pbK<F|d<T;^7&wN_0aa5yxl+pmlL8~Gg7lh2AkvY)^z|$d
zW+hIih79h};7+U&;_UdYel84nK}0Ygo^r;}iYh#!h4MAe8wtX&4_XA4c%b%by)ZM3
z`=%ejbq$W4S@VH-8V;1<d8)-}Zl?m(Bc;3-_Y-`6Mgog&m+WZdWms~zR|>|vyR!qe
zIR^@y1XncQS-N{D0)o2P_n*|vjs77<TM!WrDu$S!Fdfk0F7HK^8-YgxE?&@@wGr;H
zkn(aC7hD9H%CDTA`P)rpHSP5uMtD0OY&2)%2@eAv0I*I=x)ZkSnDjqK*H7fFu#=J8
zgt#KbKy`y}ATwDMtL)%FdrLfagHyWPesV%UXgD#lS8FkN<O@_WyGh0FABu4tKIHwI
zg3_HW4fJ0m=4A}7C~Lh1XjCa_4WVKyi#uV^7*$X-27+I3g68kD1TdC^goDC!?*CpA
zm0*4c=aIxoDqA>u=L?2=d9M}Ucov-#x(a<yz-};DLH9ws=Bovyx5JY6ln-wXcHSWE
zeN5syBE10<(|_gTov~OF#~=i-!W7%c2H~n0;l9#tt1_Z$Z3}0QB+<c*(-e)gGmVes
z|D=&@w4B46j`9!8e0sgz`&y?cv0a_6m^XCN9osgs^Pt4;v=Eo<>Xm}?Z5l7_*|<UG
z98%aqX%GYG*FT6RM=oRf)MQ$zv2b~B6QHGl{P;U}4hliVN1^EKjU3pEI5)o13~@lC
zx5I+uXKR>*tDyS_N%76_bP!cuTrN<uJ#h{N(Sf0okOUQ2>%VKVmo~iU8jo3so+i}_
zLdh8i5;KZOZM@Mn50g{}EK=PjUmyky^E$-DhhLge=`<HTy{?od`aZtLy{4#9pr6A`
zJwn7W|3Jvt{A`Lo*UiyuEop)6V_KobhMF03j#HV4M0S~rRH@!E^;~4qeWBHPvA@mv
z(}Fe}+?}47fTfge0I!!WFUgjh^I2BSVk;{8M3AjYQ(neEA5v0FUVq;HuG&ZOS`!oI
z^UYvx%Yyy9?NDOU37!9+_&xbaI7aJz7xgOxQJ}+gz~w&7v>w;Zg7xL4&lySaK5^t^
zOz3O6PCjf53iSm=aYwQ{zeaSut*lR?SPB?Dk<6=+MmSDv({=|Dy>FVurkU5T)g0tP
zo^=9vljhXv@I|4VEDe@wLKH<;Hm&BOlvgXXDF?2&xJkr|7NpSGw)1O3nU-Q7R)VNV
zMuLuVul>k)mh0UP<?<XV)N{d&i7deJkJa;#g0)nz#)S8T(VrzrlWc}o+bX4Vpx}AD
zbm+ZWgYnFPn~AEpjRXW^N@zk83$$dRB7uS?>@!FbCl-8gqhM;@IxO&KW`Z6F6k=4L
zh)DiE9oe2+{fl%fHzWLD6qfMdm=JJ@)vhXZ7$$|y|H-HVmF@LhGk2$u=PzNQELr;<
zN+0`3>0Mr4`z)>-0NX@FeLI(GE0f3tHw#Bgk)4A)Uk>aI*86^ozq}1A?w&G{cHf2S
z`K=Rpfx@`vWFZpzyk&A%_(cv+lCTgkmllDfIq>cxKk}$7u>EcYjb!XqQ<<{gwRTU4
zmOH#^Oy4R`mi|a0>W00rX3d*_31OouOPy*H3{;ucfSh+qIFSi5ukaq9Fus<rlGH{K
zxGc0qKS{f>9O?Dhq2985b400YNUY(}<};hW7)%M@#g;fUE+FxeHlTTB>o*+O9#1p#
z!lt+W8&Qtw?u}rz5SCY#Di?mp=M~B3SNszwuFmAmK&gN`<_9+Wm~MHdRg?V67XQ|B
z*4rJDJ@N1@<8_xEjVb3N)NZ!1_w4qccXtdrI!1i^JIyz=C2`$jE+jR9hk@Leb*C8^
zb;Voe>+4`?Gj}nufvbQJ9wS7W@T14E(g`hjmc8I~*nDX{esMphO?BH@;+&pPNy{FD
zsaAR)DmL*$5&ow@J3rX!rZ36V!+bIQagI++NV@XCGiPIbZz!npJcveL9R5T!rjdWq
zA)#lN3sC~ctpv#9F>O&UmeTweSn#oR?S|j_9rv;-M0u#`C=x8#&km}XjlD3y;SfUs
zFWbCU`wv47S#VVu+*Q2Cp?Im-WwE+lP`&b=w9S(wjTrQnRp}Hny}d^2zwCt{&P7HZ
zf6WV7Jj2T8M+X1(6W$4tsf9H_B7gf1Ed%OvtsUt|7o3a4a_T4yR;41M4kY-=|Fq)@
z_w?8JiN9O#Ea?3<xXtJg#Q;j?+>`E_vK&A`Mv?IotZs=`zWUphJNcAM1H{Z&E11ne
z*Vg4jJk!Xpd%WC=4$zcUW0B2K2$txV9BCPrJsw7bPSIF0r>i~{b%KBDJ4sBjl>X6t
zzYyos00~f;{S=DfXOhKPjXQqfGuJ{aPY!@S+;ERCCsaP8WNH_eU4!59<Kx?3twW+$
zd7AKIRPRS{lI>A?We4(E(32<7)1uE+s@t^&*-KLkOp|A!rqwRZ-hb`glXx_576YZ#
zCUJ5b=~5z<CQ5rr;QBCJW0Ji19j;~k=cT)Y&dP6FYU$alrObLVI&>nnc2l!hd1>sN
zJk(DiGsQ;@2PYz#z*|w|KA&i|B?N8@f@9^0*T4jP*@g^QA6;kTh_hOCRxJd$%W6!5
zcFK03_syLVMVv;)j17}}tmmquJ1?4M=^jz*phB~3NC^V{sXMq=QM?tJyio;%1nhXB
zxe4GV<>l1AwHI3-dgnEtL$h^I+-fs7zNl{6cp5HD2OK<Mp%sjQSkypQ2*#bY`d03A
zM}8?(HL6B*CQN4bUVq4pFayt9nrO_ON0-w?j{l(YSMFbfHL{9ufA8JIO3SKeYWO!;
zk>)96OY9czc?<*PCUP4g$*=TtxlW~deb%Hq(%<!Y3JHdqii*4(ST$<Kjf<eJ<scNt
zY0W2+kVJd5a6?EDm>0L$MtItZ<X;M!ObU<W8!+E!?Cv;x03w(D`BNJ<q1oqtZI?4;
z09WPrE$SzcyNoOgrON;G4e3xHx(dkBlq6%|?wD`bTnSs}VwW64Jsd4<UzIQM#!kWA
z<AQ7|9t4Ba<g8M$M1uXtijIRTlLU*OdPXt_(n$V_b8>Tp8|!W%Mv2Ok?2a3i(hH5i
zTKcCCVSD+hZM3kJ<U(E@$qYc!dVUuEsA2ACBIx73aJ6k_Y|`|QeC1HXUS?3~Zm+@-
z9GIDjS374vcrt9p5t<5OGePcno<6;t{u)vP6i1<?6;k#xt9lr8IXkk<dPs0eEL3&?
zoKgn*qe{A<)zAGpk6O6IUp?kTxPU~EvW4>KglAU78i1q<CzkhPX6o`<VT32WC|V9r
zj(kq;{#z;n6j$y?24yFoXW|J%W|;XO80W`|)qNDU-et5skW=2nk!*H4xSkyRc@k~F
zcH<%e(!`ReIiQ>>{B_-2*lF#fh~;TG^m2vOlf9xnF<*j1=Z-5S#p%*2uc?LHg(AB9
zF=SD~d77)0s;FbRfBjHUG1p`brk^#Pz%V=T1wKe|d7?ja<h5L5h#u*@hm+^4s9nYS
zLPs^%jj9Lg8)I;jX()EwA*oom*g$pxg%cA8V5C>)sIq->Auv6gC#wvLm~y%xaA0DN
z{ElKEDe;0F5a~FJ*FVp6@X0xxLVux$?c`J6Y|@Q1vb<fO@pYx9wsjff3bYo76Vmun
z(;974$6TX(cej9){71QJ>8z(~KI1A_3i2Uh8;1KP&P4wT#g-9d&BzR0plsCR#QccW
zEp-obPZYd0s3(rBy-56#>gf#zApH|?;y5Adtrh~oXC3^i2n_73FH_cIT~WU4vjZA{
zL#}~&jp4Tzzed^8%f3Rj1?l}JtkId_pB#~$|Jc>J?aAsLsWebZ>FY1-Ub61pl8rXb
z9&Sd6jXQfAUVU=?{)`zSb4v-TQWL}!oo09F{Y^+FSdpm8Xb!u=?KJj|O}6r7tcu>4
zU?-Mz(Xu@Wh%nfWXtc3bTNED-c#I_q+J*edFo%&YI=5$nP6E-ZW0XL!)xrh(dd|~5
z82cE>_aIYnLsF%X;dZRjA`97&p{U%P>UZ%k<J3A>_!8}wor|{0@8y;tFaFe=RTgcC
z8~te;=g|MhnJS~q#KP3@*=j_k4p%%A%XW_`HTf?kpaihg7<P+Coq(OtRO361orU{M
z9_X7gm6XW^v4UT&4MqnM+fkiM&BGg+J*4Nv={;d}-mx?R%=x86>v97$b!=s%IA=iF
zSXA;eU5?NwGFFWPVm(<@SE05M&*)IK({{p14VlKu<97=IQtoj8+)??D=XwZW1bfA|
zVHlKVM>exsENJk`yt2{4<YOY@6QKxO5wh~z3>F+~=>G`xWH;ho@@sJSj%hm#*#)o0
z(e~A*tbzQr&x*SrCR0LpoS8};N^>|D*C>m?Blb63tfpP6{`-u#6NzlUXV1Aw1oId4
z0u;eGX2GNpI26=I;O?G_{}Yv_P~L@$sC&nQqth(umO-_SH%x=0_|<2=-oL{o!4)o?
z>IO3amf^D_5|7E!jR>4QoMbr`9V-~^cA@&P`0Cj8HyytDC4`!y;HHxtEt27XLs1CM
zRrb?{cqpWfP@C0RrH57%jPOG^`EvLxBu(Fqrw=~aKJ#eVsTAWoD+1P5#mgX`M9R=0
zNg;sjuSLYGXj(@F)BP`q%oT$_$gj`h3@!&b&->hY1~9AGS<#pwt#dS!@izidzQ4vu
z)Kf&=i~K`7h>=ddVPX2XPsIFJuOM~HEuwDt{Kt>ax%<d@vvMo3!GXP1w%h~;$Vex;
z6K>KQeH1HAN;CK=%wldqH=ZH`0K+FmKEc=EA?NKn>j|$AbRvxf^<?UTec!G)*v%ji
zAxeO8;BHM1bvrY2wD7?SVlVZ0jk(+*6H(oqx9lgiQ2Ppk#J9Ssj*%<G7g*%>4k%9G
zh*{00!d#A#+Yc=kn#x;4H)GA$uyzgHWb;cZ0MERU8vr)h9l2VBBRCYIbBgN#wiuEZ
zx~1P;>#KGg2bJbNj_T0(AF-4`0M=w1ycRmLutxs}54)x@eh0us1uhykNl<DxNTUFr
z{ZEcBe{0qL^6|oU0q^>F3-gwD%x9U5XG5EA)=&H=qL^PRYBfM{uE7225u7N#oR`xo
ziu*x<$D4fV4%^pP&iXzv`jVfcputvBbq>zpg~>ulAWrR>Z=hT1mi<i7V+k~x8EDj1
zr<8e_l85E=_tr6$?CwV4jevvrs|)}wq5aP0RQ|DE98Bv487%i?HNjnyY*<$7mQCr)
zKy4rfph3c9(|N5X^Sr{7p7@MPZ4aSV^|{WGVH*SvhbczFYOf`BPi4*c{_LcmjV@kk
z5+U8P6IF||Ta5hcsv3j9K;f7QBb1FcQZ$fVErRD-UPK{qWBigwW)eJMxCC@u(x7@R
z&!OC!^M`D6f$M08rH<wd>=s-rxIgSg!>72B4ARYd)T>^0j6+m_z>B>KWquMkMCC?+
z*V2*wixx07f|VTRKDm)MyIzZ*LH<pDpL<Nx548{KF_}#b0i&(0ff}g_UzWdV_js0d
zVWhSGY<e^rK@K0|?B1z|qIS{{j@dAEd3P(=bYx!ng!{Y)S3T9Sd>xD^S%28+l1N@-
z73-S;Y*a#h85fv-c6bzsK_t39_~g!XG&-805HHR{N-4f2T9&@8yU|-X%20WzXv64|
z(s8xJ-36CGYPN2C;2&lF7sUoQzjQ<8s?Ol~k+inz30VEV1RWLnq2nirZTIdeM9ZgT
zv`ygG+b)3t0_d|@$<IjG_n!*`i5Ywfy_MeedMbLub9O)MEf*UIuZbMrYqh(@jm3XS
zWvW*kvrdefuK*pv*^0qmuq1Zjb1yYB8dj_->O=9c!oGt$A!kR!)4+;uxT1FLs@E-H
z^L$=~gYl-8#Y9;prF!TfUDZt6BK*d!E2J9ud5&?M5bwT&8NUV~WXLhMQV($21b}@M
z%^DQiRUXq!J>Jve8DDvi0}bkrKDt8<KDos$r8<8JSBX}wSvfTcY}z9J9l2-8(hp3p
zPLLDl_t;@UG`%5_yh^`fKM4EXdD(;;ktROeLJM2~fSa~BlfP(=iS`e!f7Nn(roVSL
z0A=M?qm%3<pIkg7?@2EHUWXwz*?%qjRAshkA5GX%2}Z0|D)618#kJx*WNZJqYECD*
zPyd`DBFIH!H<pN;b7eYq4F=tH`Eu5KVL4x%bBCBid)sW`0jK`GU2<p~&rzrrY7<wU
zA8}Z@Ngss++k`oEs)(evs$vxyfYvCxpryM>zQN6DdV&))atfb(b~T=Wm)hBcJi{AS
z29IJ8bWj^1VkDMoYr7pe@#QSYrttt&!~~RP5&|fo8PYr=rK}lfmz30kzmnZ}iwMzw
zRqzh+K9!i+fEtvV$vjGaJ#~I8pVCn!hTk?QPBFI0hGd+Og{k&z&be%Q-7AJ#UHY7q
zoT6GBI1>S|;}KX;_51K@ll^+*>LkD3J^Ld2gc81W+(EN;(1}U-nWs&Bc!pS4Xec!0
zMP-M|Y$rXK@1(u+nP?7e0@TdcGZm-Vg?3GdlH8XQc&F=|kR<FAFAJ>R;aC!aT3n!F
z1${Cz@hd^raKt7(gxQy(LJU}^R?Rf=Q`K4j%OKsYt0RMRPy?SN8t~02R1E-3F^0Bh
zNST9&+qNSGBG6qM4*gkM!f1TA$YP(YcmW;6uLCIS?^yJRq}XvRK2smoqT~YunH<A&
z#*DV;?>V5_K*nZVx`_=NLAKoKN52jXl*;wJ9VeNwW)X|!_41H3r^}ji&%s8JEw$oi
zJ@qoZ*?a7-{_8&boH0rui>?ga^lDW?@&1RkmYDjJVs9s5IQcnolyPbTTlKQr%w8Y3
zroJrB9p`txXPg;~*smSw^gzJ1l^nL;8*(Rx^=G3pdwP%7U!Lahvi=R+n^oE}fJVuG
z6{cXD<V1Z>0!N>$^|ng?LAEE0x-oV`;m)=NtB-Um2)PcGWtIxmqLLIo@6$uUjabXK
zc*m=*-S9H<*8-ZcDCPWp5ZG-oLC;7N!*aMyeC%6LlmpP$O{<}<?|DZ&(f>SU03(pW
zm|TFR3xs{;^fvz|`}1zq3Ok9}p^-O0^<jehSa)Y%A&dj9PP<mC)@w*5_#5=A1d-#c
zESZxgr(IwwI$A%Qy%FBO1lBSGJK70*bL(UjDzL1L@a)Al1_HC7tt#3?TGoP<XitrI
zc*Jwc#zc;!lD5P~ahx|Swt+U&<1-_WEbZ%@lDXSUbTXhf>dZ{0$#_7o_tj}D(g&Ly
z=UmMa>^C?pz4(~{KDVFJqf>bCy`Nevm`{cnNmS<C9_!cKa|mv%Lxat%*ddhromkQ&
z@<TY_{FP*N*+?|XIeaQ(H7ib?!55GImke5lEB`4|9n&J`(K33T3VFT=HuHaxlG(SD
zkHfW%VhGS9Z|KncJX(f2tfkC&iQhwLyji?EkN)24ofVdm-wcwXk(lb$cxiD>L%E%h
zpEmzk;WV8|Y%~l-pIX$=bJePdWRNKn`iwNJ{Rm5ydM&Os-p@q`TipM<C^&jr<hJV#
zF@GFo$gQ6dwSjgJh4g>lAI==<hq=`o&?b$sd`ejRfLlc~0<xg@p?kKw^0PkI&86sz
z4Cupn)~ZSxauv%w@)st1EzQ&HNxyr6xVKaO<%*=F{tqXtz75;#`|RkJrgXBjEmPVs
z6TxrLb=f^2-t9OCk)`wGw|XH=K}*!d=F{MsR6e)6w;HbnwXdR`EplqvKcTF)7B?Ry
zJ86JN6MDD?7r&FceoI&3eyC?>MEpvZ)x4qkCLSrm@ci|&`8}`|aC<`JDH;XRf`rL2
z+d?I@;52m2X{<CT2Vdwd-+E>gHGMP3VGO@4YSb1MN0#^RG02xDoC**YlxNDz`%3)E
zrIJdB?gU6j{H&|y3;kV=k(c7e_h{6tYcUa0Dw@Hbk1ABNGf_pMAHlq%p(_-ttnboL
zmr2;qR-#Rix7bBaKx-qaVid~7fdY_q4uorb2ihSkUEi?w8b3i|p3AN+`uNwVA6$FM
z(nTMnAgnNyQh>>fdkHAizuk!Vmiz0jQWdkzyt$mk3{DxB&u6}#RmD!7vBt0^($0y7
zAL(U>DKX1<lA8?*xub4EXddAX5}mYWnNIr$jjdM&&-yv65NU|2b&iQ5V0gEa;2sxX
z6<$*;_DYe|ZTe4L#3j^T?gCD~3)i&yTUt)=dh>^tMtR$Q+dxb-IB6rQ$M2X=w+wY`
z`c0=jPuMr|&7M)Z9`2Zx{bEUFP2dP$i{~5VhkEP3NC0~{v!X$}wNdMo*9tdt6D20d
zW!=p8K2b49fQ2Uk_`5=0%@3}%>fZ^T1e5oEd&pfI>~6$A&GH=xUZM>n@bk+s&LBOL
zy5Qd|jB(+Ls7P4i5i)rnc1%*?%9M1TXc=}9TvxYV<e^ajJI9$kL-@}Y-an6*)M%?r
zM!F)gXK>qD>Mr7)^JX>x{Z9~(L&f6Jcjy;b=v1C^W|{E+G_%gN^bTWTL7oUmp=Qfw
zWU2x3z*Tgq5g#LeoP&Qv{)FF6iNs;5`pUpWe~HQTuxL+@fX4EGuc}5K**ZM6tP`Hc
zwVU?Yp~lR25i||t)k+Wa5-9MBVqBFt%I;BwFCa$98^*MX8{`iejo)8}-QCKpW&p0*
zEY!+{I<=$9-&Q$i4qpxqMpiy&J9<<P_f`G1+i@Fn-HQ%2k($6Ap$IkP3LcP=|AVpB
zAZ;i_l=FeO+Or%=@3fSd)0!C4Xku1V_cZ!*xCuE~ur6*^Gmmy+gAHt1Y>FTVqM#PK
zUAh=S1vJDd=S9<bK=xP4LYEs4rZE3tvdYredBvEmtQ}Do?>)0a3kWD<W^LXes*`}o
z@7x9ui`c{zGT`};8y3C9xyhXhl3M?U{QXOwnp+0mrxCBZsIX6gJXF^pt4$PA(WX7%
zX4LJ$?S>yPxzI=KnFHhEyen+0jZ_5vq3SJxoU_b(;ETOSN!^9QTP=-W0?7mjb2%TB
zZRSEwkpi|gDq@V4?`w>rVXP>>)R4Lw^?77f&B8-&8QH@Pzzm5$@js=xmey=8dq#ia
z66^TrfKH=V_dD`^Rrs&7KznRM*ea<SB8=oKO1yi-C&D%Y!{bop1zz6~_@Gtmyz+V_
zx$PD>8BNLI6b(JxO2FwCz$D5M|8O=X6;oC^2kN{nXL3SsazDB!x(rf!Qzlv#nhHwV
zdM`1x*YfQ=7s9erKl1|;bU{@NU#OnAhvgth<T(wMH>&>>8{Pc~7dDFlZ~;5P;6}I~
z$O+03bCo1AbemZdOhH6~i-?J$N$w-k6^P9d>szyxHfk~J|1+IPNErHk@FtK{5wuxD
zHOYZ2NVF+Gb~cuaFa<mydljz(p4{k4GSwj<JAt<vEFEB=;|VKhhrJ}e3mnC|)9kJZ
zfW-BJ;JIDvfG1bn_Fz>09(ffuajlx{ZWhLeu86N`;-zvfC>ZCeS!l9*q~14(!>vYh
zMOW5(KMsn(RO<@z|40&>=;k0YfPGmR#2D2u3yU2LmJs;15jE9kryuAcp<SX`37Eab
zN=`imSat2y>RzK)W3Jn_W4yJ(udZJrnKlZNOEm!UHgoE0`OjY;3)a}bJSpxum+2#Q
zcdoMa@Ho;O*30spgkDJ6Zyfz4bkn`nFhwoVG~3`ras>s&4HmT>O^05DB`byx>#&$*
z1OES}CF&Gr!Q{lzQG(hhGPvv`llLXCkgI>K&10gIr+HYCA;sRKV6;bfW8bTU9$q5P
z&+A=5afxR$NZ#(|wdcB5x#S#6sh7$uf{1c>#8eJ07DK`53*$g%|9e-SbD^!wgit`K
z`=gU^wvQNILll;cK~Iuo`$TVKvy<Oqyj=-WO~z0;9$VV%`eC=r;+G%@4~W-lu7m(t
zbY19@Y69iN7f&kU^3wyi#|sKikOR582D7*YrBjmCCkolcWw9coS}K5xVPjDB;1|Pe
z2eFAW`~CCdR)5Nd`<x8hq(+{9u%KOp%oS33SeQ1cs@};{r>&JmYfjvcC!Z|Bpk@S|
z{hZnyqLK>xkBDW5TvTbq;HCsB+*t@gNRasI$0*nV4TO^4Ye)aSs=PX0-z}a|4m?nV
z$VaXoT**X>2C)oU6npxA0Uli}#&UaAe%Zfi64(atDQDOY0esRjC1<T|$8Sa#PJC*A
zFy0fosja?6Z$hz0Tl`xjB@gJKzL<M)l=lPR!&%_A2oE6$G8z|@exYb2Kx`TcypXvE
zjucp+>0EQL1EE_jKZjUEM&u0r;ZW|vO~_-ayKGw3vxWl|Pz^=_8y&ba6A-^`M<Yq0
zx`HmV^9{Sdd4l@B9!;2a;pbOV(QCMV2)kRMoWKZ)0ja9c@En4`Zug71J9^9($%?vn
zwF@HqQ0t$4goP{;E#!H^KpGft-oyffWLZwxvpNB}i5=;t(~J^X<cMx)@cuJdoocm5
zL#<9#5u8{NvBDSyvf303bSS4j@{V7M86Y?C*K;w*{FI*w*L}_{i?$LA4;^@|o!K94
zsCT}@C}AlD{d&LQ$67)$$v-<!0NW-2APjt{ssg_YzH9L(CpOvgS{H~2#g%n$m9^Fn
z5{u%zjaTg!BgR3lWi+>bChq3{kOk<$T~;(!Ot5`5ZV;qLtPTj(Y1w>aX}Q+CQSDCx
zr{$=mC}lvP9#zQK&sG5h=Ej0)mu%*bVLa)fur~3NIOh+D9aLM;fQyNTBQyvbV-6IY
z(z2;&)A$hSq>}D)8FvI<2@R5qF=kZVzSr>9Ku={A;WoE0o}U!blN?khM5(YW;9*g2
z@hW`9KXMjM$;W-<Xb@wn_C-2g@k9}Gqq3**gIU%j&#TM<fnc=Hj$!~}-I_0fmR4G!
zb`Ek6|IE+cJC8Ra7DhgM(Od^ABy3Kk`}Yvvaubf|x2uhN6~i&)f%5DPJH;V8Jd=)o
z_pGW!1!E52H#}_<a^2OjCJ!y@{1K18X(ar{M8D+~-bzW!QD2OhcWJxoH(8c)gz)Ta
zm!b*l$2th07vP*i@gCreL^7tTk}pI^8;n+sk^`6NNVkHT1RE_aqjvGzo`5G_MYs;p
zNvq)Ig(M`mmky08atr?FvVQlNh;+4$;U=hWI5{g8=#K^;Zcwqba*m-(if!6DaYFGS
zR6rN|v$cgaB$!K<Nk-a*<Ek>zAbU7#BdhUQigI`V9^aK&5BY^OIUnrsx(wMld9Nc7
ztqnKF>|i*}EGMlm#V)pyVU}C~$AECHzJxVX1Z>ogo>ZQ{&pub$g2rL^v7S<}Ati5^
zQlw_$9C(h$wGz*;Wy8_(eMhR#KGyTYQ~Mn-9n#X{P)0Lmz-$&+z&oiT2K)>xIiBFx
zA0AHh)O4=_JM*%~)>cg^m_W*?T(YkpGhM0#TZ1hOJ`B+uU(E-j0D--Ji?yp&N;TeE
zr~tq6(#qqasP6Rhp|Q}yXVs-pm=bX9u!ZfUtH_N2d)N>S<8&O6Mn>{%^O?yL5TB=v
z$g_ECzoy#`bKPnq56+4=?8W0IT-s?aUgQj(4Lnp#JRey;Ns6+s>8Io?jAkbRTrhBf
z&HKr)6f#Og(xAeyoFaf@OE%6D^~B#9mh4S7P&xMGvSQV>(@=ld_9KsG{fL0tQM7Ry
zNe4}%$mODl<zZx$Gu26Wxooc@l=GQMp-N3?F6SI4Pnl(H=>cHuKcSYpQ1LgECPR+n
z@*zwu1+dJAXM@kF0{9wuk+Yc<5o{a!Ax`g~LjRfGd#eyFkQf@*tGzXxGrF_<rVp%E
z76g5KH{r0M_UI<{B3&k@>Iy6nkfDD0eMijDt^`Euze)ukd1L|v!c-&95LFRgmkii2
zW5H)bbMb%*xZgq6I$_NB4Dr;e(MK=GKU<D>fE6#%2#~v<JrHgoZuBjMPefNQi`Lh=
zcN|2Ers$L*%9O#}?lj92+4by2=D2OfH|#sg>aD+bZI*z$(U3TxtO0-s_bAbjjh%EX
zWZcomQ~^sSThANBfpcXE!qFNNHN7==9?X_w$5dI!#h|EZVT8C9D0_{oUrBwo+Bb1d
z490wX7YlM=A%mdi{@o8q<rep6;9q>BJDXzzn3A|V)sN4H`+o1IXI{OYX07KjdivC1
z99I9|Tbw=Em>38iOc_u`0{@8{`f}eqt=KhN5{R8*V8yy^iinru%5!-5AZOCCd%)?v
z5HyqpC<40u(Cy^P`5g6!Kz$1)t{!QL5%85Y$mak#K*qlu4?dVm0_4Vf4zL;W%UpT#
zF5~v391c&4T^Z1?^F%!*<R7pVPlX;IeY*L9NGlK$In~t^Hp7Ile_9jqk7;!`i_8wi
zwuW_|ucWE-%3PU0_vl4EiG1)<Xzw(%Z$g)V=E5@0sUOh5-yS618$l@dg3)5?kw-q;
zY$Ny3{$F?eEx+nWH8q-XMGY%Z!hFawi!@3&MVT`IT>%YVY}a<5DK=~gM}6J&8gv%J
zB4T{9A)sB@3XGA{Ibv)hp<ZiTEG+Bkz4b?jxc$&RSoIa?ju*YIOcQBCWTjW9M-Erd
z@bz1y)RsX5s#7V^34^`f3X)tJ5N2uYJqC=Z0sRJ=!2M?ITKq=Jr`f3Mm-i+&s66o<
z=%t#yl;$v*uOGD-3*k36n_>0W?@D{-Q4QHr)-d!LD2nkV^&rICwSuWOw39==(u_NG
z63D&`ttSSszDynHS1tz8>LL2&Fxr0|G@9WDoSs9IyF?=-W)1>LHpZE-RDZcD`+5~a
zOVhxtPZTpA`ztRif*K7SpT)BFWbE67)rqsSTa(DAS)KykYIYB%-4?-fj#xOt-9<?D
z+jKwG|4=$^OzA5oOu09rsIU^77M#`5d_~oY$Kwm<^wD0ZKN%CQk7Fj_Crl1dGlRVb
z8g^;;Z3!e+w<Ph~>*k|bZB?kJK(ioouw21km6+|T*t%8~8QF+YsMM&OxWqW@Sad^e
z)q6_{Q<=ct1lT~En>W%;pn3>MQZImJv_VcV(Xo>|cFN-^o$p$}w(fpo4bhxGfR+8~
z8CF3)X0aoBxW7kDRGqYU!H5;0h}o&n|GbaRh^B^Cb6cH-EJG{^oqXBgvXVDKb<4}E
zg!4fXY6Vt*0}xM!sO1WRq4l0=(1B?xYAt~0$m<aq3>zxf(SBb<@Xx|24esEf^4%J)
zu$FH8QOnLA_HPD}end7>0s#GSM@5U<L4<#4%x4(|AFBrL{VvCB`7XGUNS^*si|wrc
ze@8wr2R8L+FuJssuE=V_2w;~9No}#0*Rbk1Rn^>uCcXueYW2MZ@^v~tYgmJb2N`FV
zSRun4N>KSy+Ii0C^dGiCy)|5>Fsw`+ZkT8*5Rk>hOxmXrtxvYK=jUrF8!Cn1@s0fI
z6x96}CcHz^Az+3)+W_{UDPsZf&H(gT4t-c`n)j(L;Fvr(?dTyr{eVpPMWK->38a2W
zG$tBV7tB*IH3Pq8{WM;9N_hAdio63H7dhj*)(yD9qvd?5fMRAh^F4gKyRjl%F)dUw
zR!<xdMm(gmkxX(&F?YPC8N}Mhk<HaIKNEp2n_V_{s%0xbI$)R2+mBmy^(L}B;#3>$
z!Mp#i+lRCHQsFPvnJ1NaggG%381}wE4|yo)@QEjjjec}D2E_<9BC8Xy&e{Hi0ka{}
zXG@IMy0?eAW4+J2a+jB$r%!&q=r>5fWoUS@h&XVP+2x#if(aC^F4+D$O2#<Zdt|+C
zDsqIgcbhCF;FmaxnbY=c-f~e&d<PHn6pRrJk%%R^!^m%7Hm7bJxlEXYp{5{kZhE$x
z&s<{&Ad#kcQYa$+u4sBd5ruY>o3N${WyXv85>GPqpI-zYinbChIUjo}ML}@EUXRuv
z3JJ0VzT97wyE9VQtsdyFzZ(Fh!wo$YYA6ZM1{K#0cpyT}RJLRZr;f{&EzB&#mMHc-
zX!8sk%kwbOAX+%}*BS3rysgYs$tH1KYXk<3tH>F(Y5F%Q`+G3KVS`d`j&vVmMz4N}
znyP)0iFGXLr=6kxm#MSlv6@!DN?9oiNTa*i8%iLB++5RBrOP}Zi+X`G*|i7h`_wR}
z+zt@T8d|V4L=c!UMdF9>K6C&;%(qc%FE>Ej-p8PxCxFt{dTJxi&Wyn8F+QZW!*a!%
zOw^^S<qYeE6*N*iC{wV;^bV8H>#j1@1UwbaAv72HGS!Q7R;C<eh18g=5!;_I*W?(h
z0HB`Vv)-;a$>Rp+OEt%3sXkZ#=bQgcik%k|CXPU^A&tWPYV^%8-{0|g!0atgwq$=U
zDoIFExiKd$5xAYAk;z|Iya?IS(!MdG3pi$c7j<*TRT!>Wx@%N2u--WCT;2KiJFB4c
zu}}i#ds9KcXNnzBsUq1Q>XyrTl!C-oIn6Up#;vDElBJI{5&<c?OIanpwr;JteR=tF
zxjwSk=uO#=yN8E!1{v^|Q8|WaS1<M1nJfjq;9588G$=~4rt%7s0j}w^n}Dy76GY`~
zmH%<f-R>d?yDXt)H`$zdb%~7nrT@1<7Ta#pPr-Psi%pq<u})K$h(yLaBP7b5pPKbL
zCNVfLlFohbwsY^!LLg3x18A675;4+p5};QHjcU#j`ZdQNBwz6hgB43JdbJzxAvKs~
z>EfbC%uLf}iHJPUcPUli@q|ZE^labBt7RZhRv|8Ei9vp<VQlbEtuXbUSMVj=<3G?i
zVHDOO75y{J$MM-Tz{#-%4P+c>5r~^OVz^-Z!q+qKWw5!qjcnFupWcr%$IpUqYGjH8
zeGsR$h)jUgT=q3YFL8%+rN&@miWLQ$)9~b@Gw;=e6JpJfG%VagOdE=Zt>BUEZczEI
zF&<dHIqEvQzrZHvP}Iy^K6nO9So^2DF^(?_Wp&1nd^=H`9Y~>|!P-+ydDt*QD>Wz*
z^7urE(Nzzb5z9*yFtPN-RwZ+Yhe*!x@Ks0Sl)YZKjNvvoy_BHVM3DeYat}89^Kp*V
zFVS?!s$t`06^3Nh`0m0-;|$t9G|t}B7?$}_Eqv;t0Q^cHvkim*8Qu}=de<|<aGBOT
z7y7W_W@|E?TuAME{Y)@b_Uo4Bdzn9#Qor-Gxv;{c*~V1sRw1HVc>`!%$+gtC6=050
z6D&)hN{#kbyL#5me9Fr?nJS?0e|%^FiH{+IB+0arX~s~zqnw|k*NzRGI`ucoWMuY`
zkafTi3sX_gZpfpi?nD<x6VPA>hgi;~)+>|FE~~1tdGbEWz(!AH*U8+Cw3)X`xv9Y%
zj)dIU?=XQdOe*8b>N`{zGr!<_$r6M~7-dm}J6PM{Lct4phGMx~-whAWfgD~4ydYf$
zlQqBB2X|Jf?B&|ceV0EQW2U`x3d=@Q^QpqgwKw?~N^-G5t30yb2s%AkzlccQ_Fyj|
zX9wYsx7lQ~Zz;te&Gx!x*#R1<B{&6bFu7X<rK*dnFSh<ti=qva1;;SQ2ZG4mH7UmY
zF(C(nKrl<&L!jLc7=42HQe8QbLZ$jvWV)hl)0ou}q(*)xW7{(e3hJU&1%Cl5TU?rS
z7LCqSE0ZF3j|@CSAtywun8aR(QN1r48mKD4A6k3WPoK(ZY<VETl=hXGc+Hj&O}(04
za;d#VBl$2=f1i_ziwY;Y?(Ai!@<sr>)k0_bJ;v<ds;4J`I3!pqeR3H)*+r57Z+!No
zi274+Ere_;YbvT7?)K6-4UW7lfB|U~ns1OuG7$?)>c=Q&{&w^sW!vS-aE)ttUp-}A
zsJ~P=VbA3R^f+@WXxVt!)N^A4Iow{gTg$RX3|DDc9innlhRG9cNUc9K{s&4(p9bPQ
zaG~I`sY$CX-t!lWJQ5`0h7@F@u3${8+URYF;7^Tc8YFK1a{RYv4W0^Fx0Z&4V=L!F
zALotE?_#oT1=2!zM=|**7QW+IBy0T`B-IRgpOxb|hErm~DeTH#R2M>Wrmk@WG+5BV
z!E0IYQ|*f^A42V?UL|w7g?&j#W;`*VoR!3WqlQlmYVF)sLJ9QU1r(O;e1J6$n~i79
zNhB+7up=cBi4*3mV?dap--<eKqr}{2@!63&)Hjr&78nV5%YQpmeZml_*PZ=xoS4xL
zXkhWu7r(>mX(<#~+M1+|>0n6s!iv?NIu%5c(%y5Fntks40Udx{ESqWS%#h>rXP}%C
z3Ufy5isU96bp+P=rTN5*RSBj2ctN3_qlQpS9Et@#G}=>d@Ns`1AR0n?FLm^zz*cV%
z4nC#C{odFz{z~q)iQ^!>Cw6`g&Ah3tc|ObFl-9B5>ddOwQ7nz^K^UIxs;{97sOcI6
zq1#y{ZSkClpE33AyBqoiG8&4cBZY|ekj+i{kIL@$tu+nS%eNCQ8Z?WZEGeOEL-wKA
zph^njlKQsOZ0<Eo<Ae|qY#EYOOE5Dlk`=J#KzF|i^uxIbyirv)b+Oe8gp*V9sE;Fh
z=M(|Rv=V}LwQ%k96sbnuv$ry#sK0|810}owBw5m;3&1tSRQnrujQjC3owG>|K*5%{
zzhoh^l!!0R0Q1Glq43ck{!_P{m-megvLb=cgGa!Xxj3gj?u=$?+x`f*8d8tY=7iNn
zW0BitW&Ta^sHPkm9CGHwSb!55!VyY$L*=SkD<S`U#p0TVUO^Mj|4|di9?sdqWO0r0
z?i&xsU#NNEqVtPKUeAGDC@Qx_=Km@sB1TY4LK*!PS=~Fpg3MAEeNh&4!c%HY0JZ>!
z%FZX`^-_3(gE$UwLE(XS+6<M*Hu1Fl?HlXD6Q1$dfCflBw1xo&h{;{_@B;GR<lr)k
ziPJny#$CAuZ!fS914c1<ST#j+7i0<S$1_VLmMg7spYHN$2~;^sOR$bW(cm(?4Q*@Q
zUp-_DXUMptyCKy{-T9sS1;w)W;GqVVRp09Uul5r6RF7R%!mmIw<7FbzZ@*zxfZL5$
zlwR2oIml?7lrfE{x+pACXi#7)PeAZ}RvUM%5Hb9p1z@H2`z#~()Nu|I*fE6mIq7?k
zv}=fli;XgxDHM3feH}wAVSZn)w<V0qhp^C44M|~&xPmzC${1<+kmq7>Er-o6r!tPZ
zh7`o1yDE3-aW}@T?goSMnxlWp>lnw=&QjjgWbrf2m_|huBPOySDpz8a*>4@M3T#0O
z>wno>aJVZbuR|dFs{W76=rNnAeqR2OZRD*?acxZWY_%}d!Xjhd?BSm~uAb#Oqi0QO
zj+!emm`*ewiPhhC@-B3GAY^(Ed<F%)y^F{RX74~ibi4M(vy}eBC2ov(jUaTs*rDuz
zM6~G@RoeDlcVs3S1anxU)6Em}I=k~Pg+g13!-xJ4Ymsf0H@47d*5$+oxFHY&hL9r=
zcBPDA=x1-!7b>`qXcESWr+IsYD$=oi4=_&fgNRA_F~s{jQudJ2(17g~?-kD-%oakz
zWamRpfyPnrnw?HHh8q0C1A=?sSp;Irf^@RUVFX}%L~B^B87|!$u0(|hfk;RG3%}!t
zR$SJ2M_rgZlIUenZwh)YX+PW$TmOO=mAG_gvzAW`(OwtU-|z(p;&f@K%UhT!RHFJk
z%Td|oOJWW?ZLf(ce);#QX`7a_<caXc{!E0gP13}E?buh)u&DeOGBSzTYc-ihKziZ}
zH$KrI@k^}CQaDehIyD&-5(E#ChLUHPnBFUQ{ss9UNR;5}r$_3Ijv^;MIH(0V=e&77
zH*2m6;|}>A|NOk=#SH_65ge5(oA{rbG3s7pCK<FXxHyRDbv0c4uEb1$w^;vfIVcy@
zB2v2u)i{qJ(Anc}YjED+iBDdzCvIK9lH(J?Ne~2=-eYA26%0Wb73+Dc(LyE#Sj4<p
zP<Gd_=o}Z_`w{0u(XB3yPG~Z|OwjZ=9&P&@YzGz?q3G=U1?1@(*U9hp)9*tu<8UaJ
z-J0m+yo@&DCwcEu@)LQw%ghV)L|v+!7FjU`+@(#v)91l{;Q!@-bws8OeM_Hcxp2G(
z!F{UL?(}M~*p=;q9Y6kMvb-`fdRF#&KE23GSDe*x94{9?k5_1e`npUM4T~WNd;J(a
zMCmy<;yVAn<-I4YKcvJjV*ILMgSGHSFNO=9r@p76b8+zyH)EDJeTFNvJ!>=oBE~ut
zM`@2dBCwtp(t8;0+0y$u2)rH<`q1Z8S&#ojSoD}uIdzU(Jx;dM$o|=U2QDLiA?<E{
zGT>qF$F^v`gP7(taYYpc^^lA(2Wpq&YH<|!3aX;Q`E`PR&6SkB>hMVbrKxAA!#grV
zALwV*$Tawjj9q2COx8=tX@-!1JG!aTGsJMG=7Pk31(K|F*G@K4JVAgQ{lY6xg@>w(
z<KKjTN}woxSS6HIHe*f*n>Y~I<XV0+kX<*WyDrqaaYSpPJ*c*macea&h>_Zsur@MD
z1wZly5$3=4`5wY4Eq{;Kq_8fI2~~xS?=#{;xtnbdKuoY<BSZI1YU9ew-(@;mV!WOm
z17Xqe!jhrN0!9toYVOir_tgW<q*imc>XPt?q}wRJD2{LreAKp%)6aozj#Z=FqU9)u
zk3KqM<1eYap*YUm?~+m<5hM->Q2$yVI85oO!i5=BuEsz>>B9jv@MoLcxKv6a3hu9y
zLUKy2lSm_)x?jhM?Cg*uzPwSutih+e8q_1;UPrcM9w-R^hgAY=AWv+=io~<L&*GpZ
zUUVMoR5Q>iK9PIzZJd12J>|=Wt%Y^1(dalan<+#9_#12qhP&I4U}>tA;uHS9vXaNn
zjXkt&q0q=U%pPG<_q;#gz^;y9>AE<%j&s8*7^_cAcV&=efcW|np`OwX5hdOsZ~S<8
zWVe7@t^~2_TkXzT1IyZWmu(`MRhE~cNn0Z+aKdW`pLL@h^$CW!buiHr`X<iuGtuqb
zRBCpsrJD={E$7!czOn6@m7ppd!27dKGVRsiKYp~7UlK=RbhnGJ7;J!li1cp^ht;9M
z?Cb`P4>jAiFG_omG%Aiea1itKdrwDHSY**@-*o4|R`&%0as=<Xup#FNHYVQ<d9KIF
z8H4zh_gh+XT7Tnzv<T?qUfj2qEs2uY3elv`K3Uajp1k-bPJBZx7!B9E4^+Io<yYaz
zkyi~TQN4sqt4JkoxlrU!)NF^^RDh6_H|PFgFZFr&HtId61OJfSFtpQ*Q~dsj%uLlj
zL=UU+o#FiX^rvHtbBCu=Lz@g})-}jAjXNwMU5aO{Z!@Fc4qLNlNtZ|j`>f=H6vsUd
zPt={GOz!C@IJvt`YgA%eng{LjA8UyMcuxJOzAXDI2^=ZIGH8-$POAF=H_JqXSMG9u
z3;`T1#7)yrLLk4=XRYlhR&KIWhtDNXJT*i62g<n=+tFR`6J;pJ*_i|x&L$r@EU$zh
zww1+=FD{T8gY*es>D@%I@WcgXBv{|^Da?3fEPD`Y2b71f$o?PM9jx>f>&qsQQsJ6h
zs_}^Hm}p$ciLV&c7Hi(9gTDKqHNp!T7kVWlMts%6P!+<qtk{1GJc3C8P6^p+Q-2^|
zhuEZ5dj;Se63ZOUa=_+_{#s~f^hHwM$_}#<M_aNi6<FZlB#r=6eI>5qj~-oPe7={L
zUjuUI@LQ|nsZh=tNcKBf;l`?fqy5yeYSdro&u?Wed_gPHzvIIvy<>xTv(?jj3c#=1
zd2D&i6x+VMiKt{5gXTmgeMNOM1Ac%0U=|S+Dy8v~qrbRTj7(EN1dr+dkzfv*Z&5fc
zwNAb>L|+k#k+a~Vqnq*7p-+%$La_agfdT-q^*n*!rH2heZ52Wy^pa8X6yRA4;6~Yb
z;wTOG^?WJfHTWy%$3`CjbJPhI=)H_RhLjS#(%60vXU>DK41MD|NfX>tkmGq9X$=dx
zbSUl^V8o6kse~Y0?R^7dH`9f}Y)!bxr}i42kmS1Cl|SbqSzwLchnK&2QnTjK#w%bg
zrj+KiuDV3NXoQ_HRjjmDnGXcFk}fDJv?XAK1ifLbHPw)pTJ{HI;0I8f{?P@*0J-oz
zLmcoyxER$t#L&MGnCFvV=&u}g%Q6FB{0*m)tBDX=rt{=4fC<R2BPU1({}%0-%DKLC
zF=;eei|$90^Lb=NW)ZF+j&wWPw(?+|jTQCLztLR#y<oo<>LtVji`Ex}Owu><3mZ0v
zhkz4m%4yR{lWj?OTTzcPsTC7W^nXl(!Cr<lOPVxK(YMXhJT8%rnskPR>l<T@Oq9?F
z>ZS4Q+DZESXq?v0txreyK__9VjuYl_qMQ&&BsZIMqH3JsErT^auduTZU&K10s2Qz(
z=XSh#BhLqHvJG7!w<qVWf~e2VK6``~a~SPs7Nr+zxIq-<He7l|v8Aly^P?V!#U%_u
zQ5b5k!;^l^B@44dN6uu`{u}Tla4e5Vj5tW3HuProc3^VtyxDow_zbaT5@<TyMCH5F
z7aXHlZL;^ogrqe?8!KKE0iFs0lE6IkguYL};2`8Oc0+mgvlq97Vp%=#S88R15HyTl
z(I(K$5M_%>Meg+BY4ip3*;0wn(Ts0($k_dNA&O-;elwNU(I9&Or%j&j{ELUA9OUNy
z$Eqq2RsEm&?R)|9oad@Y7X(ClZrwUGekS@Ar>7Svo;k7xaH0-_@6KJ87HU9l9`n#I
z6k8qPr^??)(YH<`QY~7C#@TZgfA4%~UE^|-Y<MiLho?y(?edK!we&7<PI>nd1gH^D
zW&7YG%JRR~e_hsCT2(6&rsd893363)gE~i1qK9wsYs|H)qZQXL`j{ho@)jh_Bi?r?
zt^KPUs|>~HDU$y)aWZVfU@(fzD`2MG%zrNig74NGU$z5jjC#%+xYiNOxG6>d8PAK7
zE^U%}act5e@t4q@f!~M#VB*2|(0(lvS+IFlQ^cftkDijOWinL_>zHx-L}^b}pQ`6>
zTXmel-6#f>8x}8Mx2a@9&VJNm#mskICkx(d&R|BPmpONK*b>`v_0a|hYYUnbmlLu^
z+LV)e0@IhjH%>j+VgRM*XeRkpJa46rGoJ~3cg}O6A9jdZXPSb9wb*-VC^pPpiYwI(
z4mO?FXEk9n*y8{{h!~4s-7m$9D~e!zm6@(^51JzCYR7g{3HQn0v#-YXwZmm%(xKao
z>m4-Fg`V4ltWN_O{w2IOp?yXYP$F5!r!!^J6)0p6#z-a|Vy%HBz~&_$vrdM*8Uo^q
zBUF<KTMbX0S55jV##vFU|K~HnnAo^keLH~Md6;Gru9%_cj^x_w<95;u9x2(<kN?fy
z|HHQ&lGV94O5vJHsD<R~DISO;gWTjOI@yuFxVGoZ=wqOT44lqA$P~qh8BjEw&ohp;
zJc)p6yB3_T<eMl!ermS4Ql)>{WdQJX8zUu9j%(D<_zPTTTIdZ5jbD?^XCo<roqv15
zNI1#%i_2ug8mI&mJJrhHXN;Th@jpu1J{@%&aQmkz$E9mjE4TtUoB8Gr5dOVdTgX-X
zye?XqX}X-{VEhg1uRFb&-2Hh*LD7u|u$EjoTAqCtI;i*ZIg<a@B@T75!8&~F>s%NO
z`zmlwc}lO3YIsUd%M6?rHTSJb@Qp8(VSG)fNU3q*dymC4-D&Rz@j9PA$?%RYgdpMO
zUz@{Lav1(f?aA1S@iLXg#EQoM3bE!frA~SRbJBCbMfYEldx;=pHM8pHK_n$VU5;)k
zahoIv@#io0aLZI-U%>{zr>G|S>g=Nm9j){7A{mW(tpbSKHY`DnH;HcoCk&coBZI@T
z|5F~L9SLxIWBC(X+ZX+N!tTCnw&^S$H1ssUaO;hN65C0c$8dswG7<+)>_4t0*QOT<
z9C3u6#0|zGrKcLBJnHo3M(N=)T*!v#-hFhHQ|&70?PL>mPJTv1${>sBeS)mKzH8C`
zP^(PAFYczxXH<H`8NAU6W5$j)%<~Sey^=lq+PB|nmgIoFx|o#RO1IgFP=?9z>h0=P
zK)|0|C6hK-Olqgq#dx#ZTLwN<=+o)=lfekN4{EE3pb!f<c*^1Nyy$JcI>kpUOOu!K
zr8_1QUSmv(8|6|=F#$Xb3v*_Gbki&CJW#KM=wUAUhc_f%nrG0_E+o)JK+#=l>#Gz>
zkOXcIg%|Pv6>xlZ?Cdecrw6vZ7X0`#sPYOPL?n%C&1qSJ5A<<_uRsN_zNPv+A>(I*
zH+}wBttmAK6AG63eL`0T<;xWp{yvtU%^z%Ct(D9@_V?IJZmO%?N+Um`iy>=*hx1*b
z-Lp@34;?WBJ%|k~4)l&AcKe&mg}JXErFd@C59nj*^v_kr*~~!1I^owPs&8+c&!FdL
zV1~G1SCWyBZ^a^OeDljDz|2v#od*cJZaO?uqb#2J8b?*OitS0f(vuRrk}M-UIY#fK
za;?(~1k;AaJd#bXe$S`<<*EXh@gZ8(3&;T5NY>0(qSYRt0*VwyTQ$2*Y50q^sR6^|
z7;hgI9Fvsx8_BctueWw=!nT{_{QLyO7UQ{qmLC6|ml@BOHU&xD23;FS3!%<Hf-*Lr
zb4AgqpUAH*Otdf0Ep;QWjgtN{b=mncuHp6N7=R8FHboXB_8KA3Q14GkKS|wF-VkF9
zT?dmD4YJqJp{4oc^e`#k&XdYg|8ZQYv+lnRmf`IY@~^7m7meZ5pojv4L~dce<-H(P
zXIw8rG5<MV3-@vhEGr9Agsmc^nL(}HUhTErzGGF<=m=s}V!i?cq=ExR#Z*de#FM6B
z`*H7VhHkt-az18d_6hxRlhHX?kZQO4ll|ar?aGKZ)r%RI%e4S3LcUCXxWQr}E@(yc
zFD2n{ldZ~w>Lu}Aeacq6komB5mBE(!6B0HE$Z4`f*>5EA(;=}o5+74AUUz^Z$*TWK
zw4Q9(*WPb?$H}m`L0Ez%2`15FfZ4#iF{4U+)MSBphl{Td07PBMr1kv*psdB{BlgXN
z=~|5+kF02#y|RswCx5#fg3@K6&OrV&h64G!f`d^dhXD5Mv*DwZ>9CNuZ}KAro?Tn=
z_7*mz^=LvzD~@<{TdxB|h&F>79(CE+Ap!PDU1-)b&BWDEwd^6N?pkB44Bc$~l?Nov
ziNqsoq28kkztia1L$|c&N?YB84s5pmqmPA))SLLb<%Hu?KISudTf@`}roW74u(kG`
zS88}urGx7&;b9GC<P-qkM&xsx-q)VbjUA|^aD32Hv~v<^$FH-?r;8Ff_%fAzKLLiH
z+HKq_95a#*CpzhB<V9q<4pVT<UC=zvR-~I;v=w{!IGMU1r%)A9GQc)V?@79MOwpDv
zgWSqxd<;Dw3M>{Ylb?ivob-k%n6O>fV8HH(?d9pFb_~USK?TtL2qqm`YJ2NR_T)N+
z(NEVbEoOXkYnKw$vteB&`c$(_LM*f$dE@~Q%d_nYromNCnb@>nTB4nh+n`qDXeCji
z^W~(llSI!gmXHXra>;<oS&-}Ds!)hRUwvgS44rd@fGrEV-JYr>?u^PXYSq6`%HSx|
zs`xYuZR8l1GVGX%lqa9p@~+zu{x$Q{ufq7@k+;sIRagq$#QmP<<YGqj{i93r6W^~^
z`94}}VQ(Z70wm``k%zeemrIX~Cv<!O3g=kv-Xu+A2=Vz_L0S;eYF7T9IKFDT908^V
z+NvGCW8&d_LG(_z_W1(wyvu%{NpC;w*^k)$2+?mqqHm-D@Y*g0Dcpg{GeZLf{!g|A
zIzKu)DG7IwRDY)?-fX>ib@Y%N>uI%12LMW#=h^icL`JZx0q4Ml&xDFb7V!y3UMh3`
z2yO_LyP~&inYnL_ihaeje(`R|G+W&otw-^HpTEyeW&Bw3NpIOQ;g+YL_(-H^+ZJc<
zI@XrdL41jfy<z2lqc}NBX+8=FW&jXh2F>Tz=iyUb5b*Sr1#XsG!rd}LgQV8AXRgmZ
zMNq?rEi{}(6$|o|(!6;GF=M4K;_n%eCJesK)CO)J%8E1*Cg@he1^7QWof9Ed%(Bhp
z9kef7gx`S~^GLZXHLJu&{8Gq|;e#SeAzgcXt|M1z+}P~0T2QC!#OW$-6L==<Hrxx;
zq&_UW0WMRFqmTxgcLAI(b_Y7J5J+06*6?2t2yP@hhzQc|V+kJG=*Q2u?DV0{K>%@d
z0_9t&T9S7&8xp|&C^KetwRed;>rSU}oqsszCfBR4Y0{kAtS2|?Dlr(2)Pd)_vr1M2
zH52B3?(Fm{ERR&4FDiZBx+0x1kRx`WcIaE1h)}esqrY7JX-p?Q%bJ@qLU`3R6Y>$!
zV~NA2Mz(D%mA<nT%rD6`n0^rvc6LI=i>s?Az?$47Q1Oe;TEYaT&%QmA15pxC_*ymF
zp6y16v=tg$A70vXqd=uiIfYzM1qpNTYC&_WT2eMHTiRJ`z#<v=i^N2Y*BpbfuyzTi
zaL2gzJe+=HZxEguBr;v2NBd$8hQv$0aG?nW6ih0d59b>+p}96UX68R&?u`ct;87H%
z7WJ~n&%5LV4Wj!5@G^B(ywlO}KUzd=S~dV=)eZo7E<^2p2_Gg4Sl8u8Yk?lsC}o}3
zSFTwq75w9WW8<H;7hD8!Pr308{_EMxxv>k*5U@y(6RlPD0VYrTwEuI4XTIdWpAu2|
z*na$LsKv~ypH*Xa$}x0t5|Bb4$7S_(2qPubc6YGqtNi2))$cwf0!}mErU5ek(@EjB
zQBWh0@X?3TK72YfRR`*NUgn+(@Mvr=cDjkX*z9{}D$PFpCm1plhBsIQr!ZB5@PTN{
zR^hfXKT&L#c=RQU1%-OwYXwYSnK@(~ApAG1m$kVZEKxlmb}w4q|Ke7ljYT1+^ur;z
z!A$c`vlPGXFkLwocf8xfCkKo3yiZb7OV<4<*|vU4gglT(txxd45J?`z?yFHZ(rc#e
z?$w%P|7b%xGP!lv6k7$CE<=alVz@86aZcr~)<_E9>WUJMRvtD-*G|C<jyx}lR`!S}
zJ?bCiye#j;*0rmvEc@_Hq~&oP4<Q}YzPk{7WP=XIM`*2L^Y9YFdL@|t`wUG$+k>P`
zEj7;JxLb0pLUw7qyV{lWUn7?$quOaY5*m@>6jvvJ&ADkWOS&8?eR*uximiBCGw7GQ
zT_pd0uk>j_f`YMJNX-xbv{zx`$ObUY{k}b&W-cFcQe2*#uz}h^WaXl84IF>Vrd=gG
zZ7gxg;)BMybVLUomJz{1%q7!+u4SGmbYBTvrM-BB>h*%!zg8jc1aZ8+jWqudBihb(
zNTj2Be^1oJc&fY*rTPs!{64Q(ZTWY^Z=F8UO7+K_n3c~W+V#nmc{y9&nAMqdqsMM!
z957~(;AdNc5zFdf?RGr&!2&q@056_cl2~Pczhs~2`3As%k<%r{$F(!~4T5^ksl`|8
z#b_b9QYrM{QBS}FUQ&Et9Fo#(mL+QUar;{3>VfH;8+k<ms1*%~t#4{IC1La+v`p?U
za}E0IfFfx>8TV9KdrGFc@*#AvMj7Ko2#`;#f_aNrL0_o%GtuMh;W!9e-h5cPPHqIC
zYOjK<_EQAwOJ|ZF-NalDQ!aVo^pS;y)0QUxb*49d{O4+cZ^eYdgMtom0<q5t7d$R*
z;a|2sVdAoZ`YLWSrdMug&G_q?qJdHLo3P0R*tf{IC4M%li1?7WeC6Xr;V_`e&FEs5
z!Du6d#;(}!HB+Ikm1VkNhUdG*ZY%x)n}oqVVcu?YHr-ix78J?3PcDs}OH$(+D4q^q
zO{X|f%IceWos>1!M<+BjRM@=reCb;Nb0;RBD(oKx9&BISsk`Zi)anuK<>IeSaaV{+
z<30sWmOGh}$<asTgo0>4Aw--8Hyh1YXG9Fs?3SMrHy{+-;xCh|K*xeVxk6m>xQdRl
zY%UXjo>y^5arO%eoVWn*;}S3D-xA3r1bD#eBmfMLZfDB4Eo^^u-Iqq@9`dZlCFxuE
zvE0JiFMlwD8>Uq-&A6m-TuWI3+jRn#f=;H9)9Wi^Ytf0e%`4@LxAxNitTy!ZJHHWC
z6QmvUGv#Aqz7qXVH+wEz?<m_2)>sG|MavoD!aVxc>%^KxWj)mjTPsZLj6i>H=0&Ll
z=G(hBJg#!k(e$hfMHDvGW)_G5;ndeczXllax@SkRh_?!$sDh0IMqf39F;(JUR<4yK
z2#w@wal%%8(uD2;e}>*Zi-AKVH6~XN!d)9?Hi4bqE39NQ!Wh1XOb(eVbGkJJN<WT7
z+4BvKWFyFW%ru^rlbgyoL*DmVy&-LQE1dpEnf&OTpe*C&-qp_EJAi_|Jur`r|M0?@
z55%c%K)<y8OlCaH$njI3MMm=0kuQD?1ONUNaUk#pEo+l0%wB?Q50%^_YXFaV3nbRo
z`g~Z41&zy>0UX0?Ym;+gvqow$%9C<O-t<M)+hTn-Rq2aA)z6@mdGRsX)p-t8RV$)x
zg9-)&3C;n`F`x$Z|7D=G!NOiZnp2gAGoiQQ?6LzUUPACq-iJb`3X|#CEPBN1Xhz>#
z<cDEh{U*72*EuDv7r4KKB2IA&6U9diorBRZcFn6M^y!(gp6>kJ_|T>llTVrky*b|b
zV4R!Io%r)N?VO=?rK0j1m(;X<#qIssKi0_AWx`U2Zc_jf^50N`tee8J({zABA}*-i
z&_U#e(avrLCrTIx9bInQ#mhB6<%r`+>}Z34>PFJR3YndwQDl;bN{qP=J!eG-XH>)u
z^`4epIj=Q!H6wC^xhh4-C1Kjw^o2?*EI}iwRH8jZ<3o12P!E_2KWB1PqVToe7O}Yi
zSr(bYV(bG>Khs>@f>P*p1yz1Yp#de|bkqQWnu(fF8jlp(D=U7Ml$DZ%`h?maoiy0|
zNQXi{a?IY!l${2@7z~F|J;!Tromq;FoLps_m2Du|Ta0f#NfH-40rsCQS_A-Hp-YGj
zqp7BtThMU7S~3{exNI5+*0tfrj;H-HUP*wMd{!PUfQ(5YJlK^Mg4?o&271p27y*v>
zSLB?;MHi~s@lrEcP;CTWVx7k^h<Hob2V>bZ{d-5e_x<^d&@DtO=e|OX*{uBQ3!#Mo
zM%Z!OzE!5V`ENGV%*2)WKjv75uQ9ZWx|$2w&Nh3ow;qLfnk7Nx=tqGk;c73<_;RXO
zP7fSy5#CyNI%`0Lc-*wE+z{W~eslyiQ;IEP@GH>=odQ$ta4ij7H#gtb)KT+5&Ik^4
zk-4*bqe~PD*qx-7l7`Q!R@s`Wovo*}i2R&z#{BcWZ@Fhq-+TzF;EN$;cqTKY?!fNj
z`7Um2yznE!rOm;SNJ(F$&8BfyW^KGOx=ifCx1T9@I}{4{-d;)d*~%!Ln#EK+0H!{=
zRy8B?pMEXLQNWs~h&2}i#J6-F6~;OOoG-4Ln<?u=U?ObZbZBrUqUSV@0KTNdQ%DYA
z6b@j3K{xVG(-^LV|GBZ1P#Fo6RqTb*CR(rRmpIwYHvVny&W=_jQ@;@~6~0TvWLaAe
zt`(T7)3C%y%0*EG!-1#AvN+Rg@W>4>Hb`!4A|W)tQp|o`*6Jg-?%%uEsc@is6qL#?
z`RC#HUn_1Z{Dbd-Dvqnq6jc9~C)?%U0*YB$keEx|@<fD%-7iIlSIsaA`PwP8&t@La
zZ)8h?uyat0mw9{>J~1~H-F6o*i!G2GvN5gK%y3yjr!Yk;*})ePv~{N>c2rQRRn*r{
z)40HJVUwpdod6|(@Oc+dkuJT7_cL#H$9izaSFzLp?=~3SC-#P&ecNukHI}XkHzkkD
zTnqszi);qqo3x?G)?6K(Mk*`aQP{o^pt+1^yub1~D?t$hXVBVPq18g@4X$%Z8&=<;
zR_h8*u%}%tZW@1{cj6oOFUwY|iHcxLkT!I*d@k)f(@h+;YQI=(UodV@z`J#%>lGdl
zf%2iR!woFL1a-&*Wb&qu$Y=sh&OhOshzzJgkpoZk97j_MEf4C2x4Cgy>dHj5<xi!x
z_>xW4ETJt{s^Jw)r0q8MKrNr{-(!IE3nmfkJrH6cFk?fB>&1ynIL56@gBxC2Q<HQ0
zG4UyGd6-u)SsP(s^=cLhm;f|%l$fMc4eo53^4E7}SVy%0e0}vQ{wN+cR4O%uXn9fT
z=tCbY?18xK-G7o`f}aao7Bh)JHe7lMxu*hDoohJESGVB+qTqn*S@&%|?KdgBvkhcK
zLby9qym((ymd%xSa1^|B!ykDK%P{?v<?&*QERb{rPF>;=D~sP2I}~-7D>*O4)gxWj
z8ZI#WWlJ>FV^A(}!?k^b<9-qUa<?(ILrhiwV=!$eq*GA36j+5!a*^I4GmZ%y#UhyV
zD3_dG3I%<n_p0&Bm3Tn|?DwWk(i$u5?lA{HwgEO>-C0knP9Ml)T1S(T_T|8u8)Sb)
zb%LhRpxEj{JfuUj-0OKWoy-)qcxWYhFZ(0RH^G_|EFZCDKa1}|*T|dGb30;jjwQ`n
zgF|h1D3MI@I(!LP)1xCsGW71E!W$N)!20GOuxzQbAwQS}IJ_)F1bHAKvE-zsPlEod
zz0S&DucuaGFAIMR=;(hz#x$lf=K+hFyQylI)U3bNr);d42eB3S+grW&H~a-s0Lb}q
zCIk_O*(2U|m4}!FCJUbOaj*(Ei3Sq-zrMK&TdHW$N|-rLrd3k8%cOD2Ef~%qCWxNy
zdetRL(^22R3oI74tzFtF7P$AcZ%6HAQdm!MBOtXp`Gwb$#b`go^-=Uu#b4ikrSh^C
znYuD3Sb##ue+W(5vh<P9MMFC9PMwfUW{+Xom0SuWGQKMgZ<S8>d`fu&Ssx)%e(e&^
z0)c*7F)r)PP#2jYaX@SHvFo-9-;R%iY}m){4l%;OqzRa2v~_IFGSIC!#&?uk&*-`@
zmZ0W#oA~eg`1ATEPXC%mOQS+mZyOn`%ZIh>zg#;Pk&mFSJVM;P>6v4U=da3H6205Q
zd8Tnj1_Upc(Q+_mJe!X)`KH9BQaFycwkr!_tDTt_NLfPYfKqgv@Iv<ZiGsu6(GWP6
zl1-ELJe=-)jO%zitQr^)Qw(M{hOeKkX3;YRf;G*d{4bW}eI51utU%m*&ocY@Ceo``
zl~jJhb(vE!j&@Ngw2u-K_<UOijik<}X_W$PcBJdU=Jhs@MANZ6)wM=>KM`~AOnMt~
z1#zHS>j!o0Ug`1&ElK6Anv-gm_s5SIggpZ3>tW@x@(+ETT~q(sU)arL9)YY*v&*$n
z@qM2Xv@yj4enfA1f4yom7@oql<zC&^bcDqAo|G~ciZg-?Y*8t)P5X*bRLAFC0>5-3
z(}iW^o4rEpsUNy?i!Z?&B~jmVjz8!erskAUFlaEKY{O8aD@@(QIdpWiF$QOoq6)g_
zE?ZE;A{K}>+CUK<*y`(d>!%EfF1mV27jg3t1ifN3B5Z=z&Jb(6oKh&muXQ0iO<KP9
znj<{Z5nzl?4ZYh|@_4BDXtQl78k1jDue>hyep~%GadXuEuG!DzW84p~-4&Qn57LJ5
zkA;M_CyN5SL-8GHg#|T&EP9@~KDeGV$Pz5NMi#e))v1=Wfl9|5i&4WLoQ<wQ1v!1o
z>XyT!Xog^9vlnrR_8K~w#vvW%D^}tnEXQ{CT`E}>CE8JH?E3ud$SRjatBz+wYGK~F
zJUn<VoSR06P!iz$u{5wq*_s$`Hv*u%3$dX!J&AwI3bee{d!2bp=t`e$bV|cM8Uf)s
z8_T^o#3=%tZb1Mh5%+}<{{jSuSBXprP?XnJc^0CGZcT&zuBcBs{Yz&?k>HV#Ev1)C
z16m!z|C_H&rK&B^WX(rdx*z|y%lxqDH}IztK76$q%QmA|e|tj6;34<)cXHr7_ECB;
zsp*?XUA%wILhSkrGjr^#G?;Lh=FuJO*ozGaQ|C4e?tREcyYo7i4l2H}f)kmoyFl2f
z8SJKIm)VlRSxc-!p8&Gx3nJZS=#(`>$<bPJcA$#H=Y~yfPw_(+LCKQgD7;&!<pJF^
zT$|bM8?*fSW4wLT^SL-Y(-zIuLkUs`xtFKG(OH!7*=ck^U{~C-S=Sgm=~7SNEs9%b
zuMSmdWr85o`*xe`M#Mjk4w)Rru9HWEchHSoA2g=?KZ;G)b|CNKLWRL=I>EFUn@g3$
z>fhMti^slg*6~7rxuwb_iI&_usWh{pV(LChOGia$Y(E6S)1-O+-d`z!T;zcc-7Weq
zrLoY^yBVK<G=iid6&+|obro?ws-^M&IhEJzgl0hrq$*pqyk=c2$!o}?KUX|`<>U(3
z*{-K_<mJzU*CjUHW#}21FevT{8Ijazsd=6{NekSeAroz2s)^*Wd_@rGVHAuMj#wTw
z!lh{TV#%3aymh~}__tvGt{4qke=kc{jcV;#Vf^K?DwyTYTAP||jkcu_x%uXDS|TyB
zD*~&>&t4vY3Z3njkrFG)>~`gP<g#qCEl78P`wdJ6{8W`wbvM$6wD(ooZ%;2zTV)~p
z;C+G;LZ1AjW16h)w!$Aw7v$d3@)*>nBuC?dac%fmp@8>L@BOPbK2!-BB6UCLU~C`#
zQv00r5Ra=ZkniaJb+c;}g3$V);CIC>u3L)uz}A$h1+9a&oB!)uwf9LMZySFc6o`Zx
zb2OeC$zg)irLPd;vH+|pRJC<sz#jbEm8#*0tG>JTtv|Nc3mr2$8LycrA)@~g_3IKx
zC(5Or99WTv<nss60&jDd>Sw8NZXMxAv^9@07dd#SU^YyCX9rvug7i?j$QW)>Wzav$
zU!eMK0mr|ag^W1~Qgx=BuQtt1dH=T^lEa#m4(}R@)ohZK7bet5{eTPE*c5iG`X$SC
zqySw)PRh)d2!&tb)uQm6p!4jMjh(Xn=tkOZq`*QV0Aj1y(!6fJ|6pDSnIyV_Qs<{x
zDD4aZbWlU2rZ28z*6Pusb)NA_7roi>F*B~V(g5!u8(O5oM)<6K3n=(>3S;(p@o(#&
zD9oDX{K|-(Sh>@_p^Z={!Q5%9=24Hpj{*pu{?HO5a7xi*4!t-M&aV7aUfbs_&8W_b
zl}m{}2EUXx>X7}9k3+WJA6F>^G4fez+wZBYBB_WyT3<k_^N!H8SJ5NHdDuyg^dPk>
zrNnhL=hN3(y69wDy$xl+%i<I{bNq|QIXGrC@OalOYu5nz<R}S~;9QOR`BRH~mQ=F-
zvl!a=>gh^u`5@J;8qS%BoVl|#WLIiLN6qB^5+DfPyT1{h3vXGib?|0!nzzu49h&I@
z=7^0Akc+mU9+Xwsx0HJrF2PkTp6;FVQ)Af)O8sDhurEX`B!Iv_Mv6xSri9v{d!@OC
zDmpza!RHSf)H0h+kcF%eSrO^=fTe&+wRw@?1oo@Z(0<9vT1G37eLA@P)6LdJ_P{2N
z){bC(ETFQ>)jb5l<JQI(5blUY{r21}BmBXt>g0^gXJ00nuu!XbJhU$|%~A`Qq)(1o
zGWK4FoP~rVcvKheF!zR*La#P@ovhu^iZLg)$?qje1)e?i&Kf~!pW$QkB7(4etwW`}
z9%6$w!gn^3|MiUj_zcS=cmaPEqgW2|W*_A<_0$d$;%hVRr#a19gijWyZG#3u_fc#j
zby86YtMprAZ_F5&M1#5MzhdTcDBvJx_XM}(xaRi*skGQ)bumyeC?}}d?+JtyHQWuu
znb|o{;3Sugl5wM@(V^35;x9Uje{nx)bNq7lDn3a)D|E!nwwMniY1=dMzff9WDO7(F
zw@<eOe@e6K4Hu@;`J_^dJxv{}<Z=bH%WU3lN@sqLOGsB*`Yk)XxkqLB#;iyvfn<Nx
zNmwmbQq-In1|L5B5n7&5xRJyNMHs`03oBM#)VSHCXsLd-zWj?wOBS}2CD#J4a-tr8
z6qux4A;Q^SoDb7&&)(!aPX+%?<Sab8vTyN+eXCt81C#h7mdw#^a1Sb=mX^Wsw(M-W
z!p1MHZw4L3ZV~y!zB}H33N`WRH@W3WKLb_2`|>WDXtS-v5Vu3}caHBV>VWV1V8`ep
zTr{B@r^J~1WUBMeodyh*?wE}~;Rz|iH@{oXHIe3i`_p9NSR(TfT(*m<7PdP*Bx@wk
z+<})=^x={6O%s2JFw&lB<tKG6Ep{YSTu}0U6+P1-J2H|SQyRi|z$;X4Z7@RXlDZ%S
z+mV%>R|(AEl8PDmRx&S6gP(ku<No=PUy1T_AK|h2Dm=9AYjrahLk2E?ys|1Z%Yu|X
zh^*1%+F|9BsYnPYrYk|q2!gk^HnzryG@8{UJ&KU^JY>8!hD<xFow^)s7ut_g0;#9M
zbz)-Knu>I*X4D%>vhYX2@)td1@01IuXpJ~|mp<%3dlMqXmY#D_Y=Lv`HtdEL<ud=Z
znPC4;C^1NLRXNKF@hmC#SvYAw*6YNaa!~sxK{rxr`a{;S7#51*Q-62usJ}NeOLsO<
z5WS6G&BXciRDaHf@=6)<uz0eGP<x6O@E*<NcFhFge){ZkR-#TXp3e7yqrizF2^C_m
zqp5_A$N(_Oepnf`C+tVxQ<rX_%F=!IU;y=Hp8;NGeYjOoMQO=U5t6N}GSV~W7=q>#
zlP2%no4_9|+~T<^qBlRFQo`&QRm&NFh-3eb4Zq=RuACxcufm~y@5RQnozIo{qS$HT
znMUfi{BEyGd#kIPa_Tt<IyY^bGTY*?)XM%FQPt~7S3uJ-mECa--tI(P%##x=WH`2S
zl=A5<fla}xF7ZWDIFCHl-Ke-#dBS160J+ra-nHn7J%3EG%U^Zu{Qmo-d`DiQj!<Sa
z`vq2E7XfoiCQNP>9+>>xdTF5T80*Kb5%lc=la~4=91$(ysxZF|>lUO1TB*LaQv+z^
zt#6)oa#f~T+wkjCr&Ld~IF=#1Pm>H=$j3WXG=_0}@rIqRME{p0a3^eKr@}Zlrz#_O
z5pz;B8pUurgUg5W_=m1$YE&B`ZOV(>v5+>ifZPTBpDeZkY`bi=9o(#YJ8Av9EKph|
z-B9{4^8HKMAyTwZg7R3vL=qKcfYdHPODfVZlG2(v>i;BShhHL=ms9K|Ui30J=I$2w
zEpd|SMLBxGJuEfxCjZ=h;<rDlF#<2uxvrvXDBeq|kO<IQquxwG3hPGc%AaoESZ~VI
z@EOLdU9pK8EeVJ4uP$!`kbCg##TXBsF-f-IX6rkJ^|NZ=?>zDliL7e`0$sHTS|bs9
zj$nTY2k*#3Kc1_OX|sNZ5R}eUXbBh6gr3?_8>YIw)$)NZR`=Jv-9`!yAZ6wIgFr8e
zBY{a+hgQM)7>Yy(v7srhq>Mp5b+X%s)-?-}jiOnrV4*JLP8|(QXgSl=&@Kf#bHq_y
z(ox?sIGN)C>jFKX+18Y>eLB?76Tojn;~-_>{OFcmI#*;BjNbk(_)wRHqyZ^|LJ{vO
z$hQn*euciCQCi-c(BUTChG(NN-U}?~q5J2pe(aL?-q8=hwo}$iTSxtUML9*FW!sLo
zrYam)dcV)5C0vF?MYDUve{T10frd`VtWt1==XY`J@*1JpGd}ZDB$jPv#!6gqiPb~H
z=rRa1nM1DQigKo}-e~DG^-Lg=erhp8fdeh=1ztEQ2Hq#Qj<PJW0^a8j>KFiOk|W<<
z=lwL6x8;#C{n}wdbg4M#`vng>)@Ed%=r8NWd|kXbtY<a=70<H~zxJqb!YX|wi0TrT
zIM(T9_xKzK`El_6JZM?*$l<z%TquHtLI;|CFWa=t0S_q-(g8EZ^};JD&@70op|Rp0
zt??X29{y-Ct&zV(@V9dICn-F}^>;qfc+cJEr)ZJdB5SNat-2!*H&GJ5V6n5H!!2BB
zm2NUqL<JTai>sq5Ky?<z1lM{8tP+&nbrWlTwb5%=z{(#Uh(r!nJ2j9#@$-G-_s>h+
z2oPZr`Ht;iD0mO}i5PpB#!7h`_rmbaPK7}|r2^-<&0{6WMY?~uI=L`PZV}UKi;(^T
z%ntfKQ}jU;REAC+g460~$T?LYV&>qeQH_1L3o&V$c;$4gnOoq=m9*AcAm6Y=p890F
z8VC_>yp^~ilSnD<5Y%Y7cdc`@9&KGC24MJ!4tz|}yg;jkt|KQx8cA~--W*~4Srx#C
z?}Wy>GFz(`kzs+l(4&9T8Hf6jM2Q>lJp!DwCQ)yw@Ha7i3*=)6>odKvPY)YD88Ifp
zxZRG!hUtf_%<uNY^mb&kyv}#;^N8P?3xHYkGnsseZG`0Py*by=yg6hCeYy(WqW}@J
zX$sP-X6mh+R#HuiM(rkHg9WgS`-fMa(-K9XcGjiuKPV`<ED_CS=eWJ507F2$zq(dL
zf;~+_HqU|O+kobmFGq>`YxK}Ror@09fKO9LKjYv3#C5k4eIP7Jga0JVgHBZAc}6NQ
zknO|G_^_6^)w`Yc!^<pERgy+H^v)V4uqizx<fqDZAD^TH@IqJ3d7Ro9p%j;)dX4BX
zJE|sbl^pGkA(T^;(M+|e++~E^x_ISlInIR-HGs!d0u(AkbOYuX87Z)N1vFt)CTvB8
zNrvtAaJ%vcK_Y<@cda*0R~{7G1HfRNhNoFxr+Rd;i<4$SucZ{@6rj~HBqp#`x(uTw
zEH?=X^ofIt+hZs@n2$yvMM#ZnjZKbnHXXw-*Q`t~hSu+cN@zB<ck-<q(x)Z<-x->0
zJ3QGwAJmeP6?r!>y2*-wL>qOKrVdKJvkFpNu4h<<P%?E#No(w!lexq6f727p3B?{z
zA|tX&_-IOKct$;s`3ghaoe}UdJ&z9lRJOxT$Mgf2!mBDahv$z~fa`KKdA)>0z#lis
zZ7S(7`e|0eXcmBRtZi>1{*R3|C6l)x`(!|wScHJ>a@-gOcuH57EQECfy62k_Pg>L4
zZuEhIb5U{~NZ`Br8L=UcBJX3RT?NF0q`^+_Izb<kV|>*tH&xZ31MYHfJ|9gsE_e|N
z=#A;;%FJ%b(GbYC*2I>uj_FEtpJ#DeRKsF;<A^Ogl&0w{@|-AMKcpNh9M5R9Rt=wm
z<c7LhcpeS6XSghj@f0Hc8-_5L$q^*!CGh!>F0zF&wqkqkZJef`ab2uuxjs5)LZR?x
z`W>9>8R4Di6OyYk4yDWqakLI=PZpmJ-e<xAw=Lx?fqcn}Q=Qmavs2h9O2?E3-h_6Z
zFjgz=qQt`Y^38_~R#T-Rv-`d{noN8np`w1hy=xo1L!V?PAL9hx6u@XxuP5Rel_?3G
zAhL_omjlNk+x{Sfl!QNl63QESJ43XgAvrS;cd)n$N#{Z6o3dOcXk|}s<$;jkl$U(B
zO+$=Rf=BzlxCMTo_JK9J4YL1(W@7-i98=n}OauTDXeQS;t?lI*H#1ZXu=Z~Y1_How
zU)dp4xV^i>+AgK<ztR8!Q`zksC}&Vk%7i`?bAj#@B~X%Bd_I<_cbA4WF1dLyv9qRs
z-^+L>Ji)X4uD+%RcHA)Q?|+rl##z0D3Ja$CJ2{-^W*gn9m=jO?5@#JJ*K5!%ru|~x
zr~~RLuBOR~2a4)+BdwdmQ;h|@Z)9zeU<#Hi(EMe;>sl?Ucq|$XFTAu+gfr01a~bOi
zIF_51y38U`vVkC2wiZ5X1U^Vqq8B-8(CHUdx-`sLujM%m>)Wpu?P<(_8}4sFtNoE0
zA+(dNUY14l26b^%2~$&hS3N>7w=F~B12f4y%!E@{{kFcqAe(+^qf@R7PRf*D*_DK-
zl@R*Wv$`1z6u+!B_rHrSyA~$tChzBNPUcEl%aI}cGoDwaur;wf!zmXYbv0*gO!Md*
zjR_>-3|Awe6jhAne}otE((&h0T`(^g4KJYW&Ztx9_~ttnipisfotcD7SRv(u@{9W?
z{<oMq1E419PU1COO?eLU%-fhibUsU-k_@T92d~QY1t*7T-TFZIhZW#)MBxn0E<se%
z5W^d|DUUjdg0*yc;ZR%X6iLytE>yiy0!=|XmLc`c?PYI;@?g<}4aaR6e<5H3+MT(v
zkSqa_n}DHgs_Zz^1eeTOtqx+s6Bjav{7~7AT2W)A;{1djat|U)cycK~1eRv6)S9X?
zhdj&bm2&X>Vw|YBW*;n(+=+^EA;>fZdI7}KzhqiJbYJqr2uR(nU^AN6xt`yKP}azQ
zeQ;lKBmocC{K@sZUIU0<PLn<8OUUMXri2uUd^G1<1pF+RZa5*&RDnV}r|^GrC~j4C
z&_(X!KlhSuCV4{AP-IC4`+^f~e}wL+J#lW~KkC6Lhx^VJFejrmQw%v)j>y?il|1_5
zXRMN>)X{JA*;QhnL4dJrJS0&QV&wL0<Rb|mQ4V?h3mAUkjbD`xhD_KT7X0sF^Y6-_
zf*86tr-9CAU_pgb2gk<fmuZ$r@c3fX61X9{N3!(~6rV2@l;OpdUaSz!qyry`mOF<@
zF2UlH$Hi+AozoR8{=&xQ1!`$dTspv?lgWB5rt_53Tk*hvP=<zQ4B`fX*`y=`?NYr>
zCH#cbXvIRJ{<OZ|*pv$|4@=#8H+sb}r#V{5XOJ{u0HdF(s9vxF_+FeS(6G_?Nj*RU
zG2bevdMs-)S{w=`(Uu+2eZUjwO@b^B+;L|aZe+Spj@z(0ty#yxs_!rg6UiZg0rAN1
zdST)rvb_(Xz#)=XkZqY5CT?Azx+bZ^;>zkBWJ(+w$QYyM#m=i`F{BbkK1`GdHDUk0
zcDEDTzYEs4@v6th{&`KS^kfb5x%Gx$QN``uJ2iw<y;p`zC(L9+aDX<1)Y%92+~A|U
zV1!c@?>1I12<@tkstgAuM7-{=2BQx|?=lR1!JjH5AqKc|?XqI-n9d&A_R53muJGe;
zFR&OL-vA%SIZi!sUNvJBW0<mW2A^lCpQ5ZFMA3z<Ea4o9*=(<w&?_wgS7YmhhH<6s
zE1QxXaG2<?0&Bli<gMu#t>*T8St|FokKQzNG%bdx<qE!Y(x#0HVh~qy>g^;MoAAYs
zb0;L3SwqQb5{2Po2nI?R;c#M;F4|hQ<C}uM8ZI$`3f8&cvvgQ{!t%-6>*(WBuD`xf
ziTSJk$js3&&ZGW9ywo|I=@@X*x+PRkFE>yDa=7mS1(^{viAQ$bpI2xIB6#@1dh&}>
zp<+2C+kaE9CglHgakaRf79wWtF&*F=_SsQV{+@9Z;o<^B94vQ&oH<LLIz$@Ry(QC)
zFINHJ{;8YiY|-|5Q#Ky05KlKf^(^=aiit(W?yH?M;IRafstF#VJPtJ-Nf8s!jszrX
zv`eZc1IlSU%*1Q4<e&i<XU!%+4VYXzFdVDm6Tc1m{mScZXWMgPV?DP-<az<|8*x(=
z-h2KVcp4{iU1gn1H&a;)^;BQ*_CAu+^ur?Sr%}hwd>C$OWv{)pF5%Ii=*%#qA~H4f
zQX?X7`kfmx9WeDOn74w#ZV|(tY%BI=?G1em=ZXv%+NKP9X6(fiZ6K~87jyr3a(CKj
za~QlACX&3Kge5&h_+Atd_fwrpBEjx><n4C6&W}%m{U;NYfqxQ}!)#ZTrnJcQT1U{m
zWxajZN5)-MpgA+oz|>KEGHC)<L)aAAefCeA!Ky~Q(NcTVfYq7c|5=Or`fG~^*VGdy
zG-ri94>u{}JS(E|1lU51sn+u#R9;1?pCf-sIsTdResnm*Vwe8W^~ZF74#aZET-Vzv
zOb5Fu;NF@HH{b;y(X-k1t%1KP?sDHsA<!dr!?}PGzg7&R+QQtUl|I8Hzn;7eN_XOf
z@;*H08bVw3u9kRIu-GjStVySD<;qwkaTv3E<&QkPU5Jju@6!7>)KG_yL0H}4_!}>&
ztoxsZVo8)+=t$=&I9ulhTlY1|Ugq`biI=pXK5Eb7USwdx$0-1WOhw<QM>5TK7`%Vi
zWyN!fDcl?EEyoGCz-A*lNMx>O@HcO;Ktt5mot^G0OYI5AiUN)fb}%Xlxjo@=2o<xg
zphI3Idd(hUK)wVDAm`M2JnLbXr$bC0YDk6JGqKYt6pDy0!~rUvx}~fk!l8Y}5%f(y
z8DHLT(f=eN0}*o;710(cP~}w`N=XRcI&<Fe-bu@Zj`VtOd7HkfTflB%{8<Q{Ru`~b
zvbr)D<e#I~W+*y)6+)r2C8Aumd<(Ou_=}?cx<u^(g+QZwUaxufECVduxzJ>6nWi*x
zG}_7$OoWS5kZDHjSX56#_vPp!+euh^9g}f5L<QMq#|so$!AP1bF+e!rbAIMiu_eDD
z%^ZSLRfS!>5gyh}HKJl#ND4NMNt?+OuJ#Dr8x<-<KT}Ym6C`nBHn_}y5N}Qj0uxo|
zZ%Y?a#hPOnRB(k9df}R1zsDUe2%SX20Uox1C$YG__fsXjgc53*$rs-t6Ab$hsrfKi
zx%6AE7=zco!pGTL7O0{B|9lJquDSIuxnX$r@MQ?k`v_v9i!Z8SeFg5!S^61NECzKd
zj<#?$Nkwv0fIKoavPvq8_=&|wL{G*@0q#z>QkT!M%F(0B2AX1!3<#?G%{DU;SA}18
zJtN)FZww(r3@7xrP(>`3_fp5a`0Im>$<M_v5#jkAY&R!tuOyBR(^gBf_MtFdn|?13
zhI;xHJ<f9AQpkSR5da1u$y8MKLuvaW{U@1#A}@cr6M^GV$kn0PSd-xf_;kq1$;096
z?2{sQkGr#w&=6r+674oDQU;-j?G#9o<LHjCXtWis_8IRa@l@cijwaLYQ`@yd^LRC!
zp;1R=Pm({ZraZWf!y3W%Dy}2!NTx&YJLT+xVR(FVy=H6<e!r#UUSQNi?|6b_%#<w9
zjA~WfFTMy9-?5I_dY(ZG8EuSpkYjF%1!?5a6zMs_g(&_BA~VPPdO|7ki8j}0owded
z>X1U#u9pFED{}hDX$mf@ZJ?6oEPADq`B;;56ga7bN!@5UXn7}$wj}F_B0~<w;6my(
z@B~h9P4!LO==R^!x$+!1zRXKtZ3!wgflVl*L(Xq0^*D>MI2N95Y9oY8`{x2Ucr~68
zu8K)Q`HKsPqz17`X{vhT)gCp?Nks)c4WoJFI3TXSO#x646$fESm>F(M+6K|;SFkYm
z!L-R??ksbz_|Byhc%@7T!nb>4WH}%z{6;M^bonY5g&4N#!51$)VyL>)-WF(^H2lPH
zs-QGT|LGy>YUlv0Yy-a63QlY)hhSEoOo4l=cP9#_zuQ6P;B%C0TK7Z2i1u;^Z;XwC
zJr;|NrC~|ntjs|wD=5PMT9d8|K;-(Mq7Fg>mqxb$LUhr-PL|Pr!bhzL%8!C#({j&w
zaLiGMn2;WG7g-tbSXg*TrO?X`W3&W`ytw{fNxFQ8j*7{G{^q$$7_pFi+~OS6lmjH~
zYlk3)PZEx-LD}R=?{QIM`SuGeXU=VN&Jv&am`hq@<vMvCdzQ3mhr<BQ;F@6x)G8C?
ze=D^WNI2o5jMJ~!n5)MwJ*5y-LnqM2Mz3gu{>*E6hq}Gn9HO;Vs`{TX%CbVnM9@;K
z8cqcilu?_4r25+b<m2{beUi~6gt8ut$BXF>t$@9g+KS`9fFOT<-Qqv9^IqlTwn9?s
zd2V1Ldjwer?q<O_TS0~t*tP+pbX~n1NQm5rOx3tEpmH#w)PnH0hR5p&_HKKlkx#=o
zliSe(rX`(64m2c%Sck!t7xDxEJ`@<uUJh&Pf5gF)@oSn(tZGP6$OU`^C1?8Gp+!)X
zM&5dQGXA~>ObA&dBKU6p23yEj68&@DUrat6(7#o6?Hx<M`LU$)IZ2MADLkDQfOnSe
z+9Lh_T*fGgq7HZWWB%7MG~dN%URtF{Gr*EKQCgw)qa?(kq+L=Ps0F}lB-wCX3eObn
zWs+ZJ()o(py)((HWqA)E!T`MgrE36<;Y5j?Il|J&m)|=)+bG)O$Gm_Tg+Ah((jxAo
z{%nU;AbCaU$T)7<Ap~iKPAH!50WZSSnxuyXzUIbpZOFe-tYXZ~D^l6<0%CuA<6&r|
zzAv`1To!OLQJmra*EFP4Wr!1aaB7P|qh=DsUdHqN!Z=A?z~^K!W}R>bDpBMqO<c=G
z3gKH8M@H)ENiqVE|C1AvvMM_&LxV=CMHw&>?4HXoPMZP!GU-;h>EDrMFUEbI2{PgI
zlgq1L_cnTaZNeu4MlLf+&CW|K>q~*97taI;xo@RutLrO&=*F|72CFXY8huk5+}~Jp
z7a)S;VkNLYrVXnG0{<P`Bt71}B*Y9mh-(MrH}|vIY|wx=)Xv=bojnM<Rxy&>9a)SE
zM4<c;c}+PFr_AZiD3208ZE`&t(-29KwcWhPdGin!3E3V$_6fv<^6241339@*&s+sY
zqO|)+>SGZYmNcn1B@`xof6&T2hYJ5h`iM$0eSO@uIG^JJJ^ffCuvKd>fj!EO>Q;{M
z+uL6IK=yHO<RMd@0?2geeeiy=5>@QDu4A1{{wSDj9_<Q0rotPEun$k!)_TP9n(RkJ
zaJ_ItcgKyQKMPeC+LJjCC%K_L)L>$)5ysA2(f`_HFPrUFgAtER*T+Goi>!(I%Yd=t
z_KGYDXBEO#kOCZ9h%r1(u@S_e3sgeF$lfPcahUtkCCDamn|nr;t8;qtGflS?1)mW}
z>ov6{LKcI2ceUERlmUMrl?&?xcU3}cU^tyJc$eLiy$$<Huygi)A0=(D0etAUcji}U
zWxZlpK$h}ES}|&5jbNb{;+1=7aRd@LHUM9X91Q;M@t=7zwr*HkXkdojYI`oE9N5fe
z&TLQFY$ko*i40Y9<%3q@xhka)a~)Tm<voeFo0#x=k}Gk#OyN^PK%iFU`yyJB$2@`c
z^m}*dOM|qe+U|o&@W-t-?2Z!50xL}to*#uo!L54gu|~O5u8Lyai!=6#mqoX(A_wmM
zbXkZ-*?ITR%46T|qTN~_c6AtTq%KMWBOtgWm~d#9it#AjXqq3=t-he)=qg#?5mDRj
zR`hwfrf-Y1F{JX-h$eY`Kg9?-L_j=E=Xv?7<`2e!x4!D7;Ru=0k4=7F4ZRR*Fz1sT
z%rW;|Cs9Wu?42$<u`k1)+07(pe!*Rm-utc(vf(x|z#A<IA*c$|4O(+WqAQSSI2>pn
z8JMlQ136acUPI52uM#>zyEJQ5D;DwB42vta-!&18$H&PxJ7r^2DWEcp0`woW<jJ0a
z+E8GyHfRSfAdY5EncX05f=`O^Ed2)je`kR&B!(@_)UWzV7I<vOnn~Lyf`Y7Ox8d3>
z@g31{6is(Wc1L+h#6=ZIiQ*binE%ntvsB^5M81F|KK~u+Xn>1MoQ3q_v=~_0Xnd`_
z5y%iNMYa8AwmgIA89+C#z2COGXb%^3CVC62_o8x+(w;_(s-gq%(RmFe1Z0AXeZOj)
z1Il&!c$L8FqUJ_Pjf=99Vq(dBBBjh%dQpou)jNDeaj=0rkMQ2^5&-h{Ag07Ua2O3}
z(WAg!6*@ZUUu)Uy?04g_yu{vbS1YR3sp+RW9f&fkUD&XwC6J@L?aD%bEKMvUHpgwR
zL6yXPyewgTc*)k5d`KvDft<P-K*N8V-_(A19hx^72Mh`5==S4Lc!i4$UISdh!bb~M
zcfmf{>Oo{NT!cf?&j=~x6%?nJvd*hH=fNMKxC|uypW!``75xSjZwrpSeK#H@PAqUE
z&s;J3BCQJ{8Q6gy0u^lS;f2l4sI*>a<al;3B?e|&tc7JV9mrwmJF>mcw<J8~{$(mg
z;Hj3Q36=m>g%E5$(VQPa*KAKM4@~~(sj*q#lgBq|cv~toJHL*hUUYhzOeX4xl<Epb
zEnqs-+nk5gH@%GHn#sX2n6-ZP8L=Cs@LC`SGMPE_8I$5^AOfOZw-TSY-C)$<UuP^q
zA{3h+0_qu=eG1Rr6t<_OfErO~)a{UG`=kP)>W;_-k4^HaCpv?`m;y^jt|OO9oQnAC
zYSub*KA5*NW!w7~d`|@jB+_*?yXQ=&vY~MkDdvoQTcAyubAx-8N(WtfbQ>f@BthWs
zFj05%5*qM<Bt`eKoM}>sF)eedS|7wC1<IW5GfC;3P>;nj4w-$OcKmuqg~#w>mIcQ6
zMQPUZ=Yl{vR-yQT+`*X^bc>xc2Wp-UK5LNnFT#G1OCPSDa83BFlEcu2Z+YKJ<!SiN
zBwBD{kf&9t)#w%m)tY9a13gYTw>Q<GXD@h=FX9gJfmEz7@5qH&b&N~i#&r~F=tH3o
z5hU_X@=*SR$3<!li$5|XY`*Uu?;T+vmh+Z%Ay8GF<_#1K!sg&(`Rb@pcSz*_K1e$9
z_`cYv(M$r>h$fHq`basxz4$>t`RT&#@~^ve3GpC#561Q&4jO$6$Mk6sHo=gZ>EQg?
zP9{a+qpP#K>C7%06EjLeZ6IrFLOFF+jD7Hv4$7%@V0HHP>8-iNe2Mj)PNb(9<+v_N
zC3k#f+M#PR?E(IjkB`xW4Eb;0v0H%blH!ob@n=YGYc}gOwv;^l*=_~41CC#j29b|I
zss5-87k}_Y4ZP9UYQn`xq<v{p+P0ZczYT5*6IOrRv8(W(Tg`$fnsdBd3lp%ywVawU
z{xHNOS<Z~#5nWP&@tDIdqb)$Nbg6&|A1bemqwI(KV+*6j$MFanj^s9)9iWo;_<^}N
ztYf>F;Dru8BJNf$duv6^%$Yy<qhK()v%%>z(edg|BCiS#sqX}d@k4zW`vYrrHP}6o
z3c8RfF09b#p{R_#LoH4;e4r@xp483BZ(e<&dSf{3>EYHVC&-n_u25Qc%(^>=rkQIl
z*u<0bWX6y^cOP4n3cv^Hi~jF^IOd$B3pl?c8f*jwBlhKAzXLJ+L(y?h;6<wTi{#pa
zR>P9$+YtOPf|1V9abG7Vhv!<oCD)LM>V0d<#%y3}cwL`xbY3r+mv~JqZ@9TlJL}0;
z8(uFXPIs%O{gUZLJ|%dcNLqQYmeKHBon>qE02}{G220Dbq~{_+h-PD|3i2{Oef1@|
z2dc{zND5^Vlfs!QC4xRt*)CU{IRX?$U$=EJkY_J_D*`gwa`S5$4gqQt=zeT=XYR%N
zr{$<<La2TByTwN80QrP^ZAZWIFDkMaF%I=ISVL;9l$Sn5V56^r)Z41?m6HYKM2l4G
z4sUJEZSNDP4l<m>yN{|0{EZV#>qkpY_tv7}VOPSt-+FBOVkWpEEUuKjgrNaU3d7@5
z-HUnLmHL6H!jV_$oXahi6@AckSR3%aBSE95>)$XV`)z#^dMO5YPwSe{3{=UY#lfNg
z#-e@6y!Ru98?5pLC7%i~w3rHm996L0R#Rg<?2z3xye2uM;$t$JLL37ud2k@hm{z-U
zbT|8Jxv~nx0<z{~(i4Qk0-U8j%d9s5@yC4$uU;CV^oFxhT1Gj`G;#EUc1phk11bCE
zEOtot@n$Oi#Ev3(4WWHdIJSEFlb?H{f3&$~v6)bcqS&uBa!*3Ooo1W^G)0dpttsdk
z3<;ovD?(dqN&F1hQ=%#%fHM%G4hEW#4%E6*70y`R=&gyC?toxcjA=5@u5!@^wC1iK
zl>h?ND3>EBC_%<C-+D~Pq!Jg*AzP(AjOm`-P?SgmthCZ;)_NLUzb|sJND^)Jc($s!
z9$*(?C$~!i=VU7pE9MDcXI@2=>RA=S#;*Dsy1s_*jQ|#I6;zjz-z|&meUr_Z(iU~P
z_}gP6Ootxq0IaJSC)2p>1Vi5e)ssdipbT{}5O6SWl|2@{pv0&F)=(<k(!&B#8Joqh
z;+%WUU1<9+Yu0sCEyGzjI0^2D`qhl%JbI;G938Yf@Qv#Pxdcr;0B1_G;h6>KoS<AH
zJeuuX0WuwH{MuHY22u<bqV+I=$Q(#apEz9emhzO?AO*u-^{k5FxZ}0){#%)LWV_e+
z!2)iU5Qn98BPVR3e|vF5SDVK>I@>k<Rr0Wt(`Vh5083&QX}uB}z=F!n+}RwN3qs_k
zg=gSvgq7m*m-=<^!VsE<r|!+QHb^W85E?=t8qcsNeVlIg&c9YgoUej>O>K>hKuJ@!
zNAMY@8HqnAp?k&KbHyrxMAwjZrD?^_bcntwUJY6+J)eyM2>rJf{SQsE$4FxPd3N}I
zHYX<2=5zZoVJKUYg1sj+FPd>?+khLOm5@RDpcl=X88yi~GY1!X^^M)eKMMeYYvcVa
z?@HPu3?IIz<VQLiLR_P!3kz!ZUJ}VF@@2qY{2uFWSI+;*y5E&0=slHVnPZy>HDu$i
z;g50^$%Aj+e&-bbWQX`WbqiNokEU34IAWj)cliB=%JOFx2nX$+lt_6OJuIuGPT-eq
z+Nr_NESJJ5Qv;!Khbu)G7lM$=+X<aGi^KZFect=*|9H_qTyj7ytWJ%&H|6jA`9ds(
zut<{=*{kzVb(Ly5F_Zp2r%j({VTG5Ar*@KmZP+^`((*^YwI#BO@@6Y`GTL>9*8pk`
z>b`|yHcLO-GX@Dn6vlE7E8@>1w*%})QC#ft`vCFHG{OA0Z%Z;%ci8N<An0%vM_)~f
z;OE9tOFQ2h@J;=N43)hbwQ?1FZ;R|4S65=V+)^HbUr$hif8d0o6GWkRn4+v$!lhS&
z{i}EPRZ&p6BZMN(ah+KUA3|>lf3CPE4gDu+>y`&!!Nq<G<T=y@dGI5X^kov89pdnv
zGwdRTN2~h=B>0E9=u+lSo4}ViljhxVNsq??>X-w_UhbAeOMwf!KoJO7dsxwl5A{u>
z_8NB-g|gqj!Hn!c5iGwSBW>R8!iju>zC1to;(Rc@J6@z5cQ<hwNO%}=BY5^mc?cC=
z4Zg?ko1wryY9}2*rrQRBv=)SyS?Y^h&g=JlLYlvcy#bwB4=HUz!QX7#DR+!yR5T2E
zi?6d86^)Dx1WYl~iFiUg9nG6PxRN*b+pyxhl}%vZYL_ymX^Fif->5q3S(#}YZxQvJ
z-LGq)l`L}LmC3Bat-u0Cbx1X*JQ*`eb*lP77Csx8ZU-|kCne-Sr-GQoMTJc~{F8P8
zM9_MWc8*>CU^}bwuOVf7Ith?^vtAEY%kq@`7OFxl!fq>9`Cu~pGc0^L_f;a$3iRsr
zimlWoXt5Bn$JV~(#X@JDzeZ)c#psSs@A{AZz}s%~>Cq)wZOa_fR_l3AA?z@j|7zw9
zvnf%xYbXr>b@W6+su1+Ko9}>rYBxI9c;KIOqCS29uA8po#N%Bf2NFE<8CK($97!e-
z9#w<Ezg!h-`Y}^F*osSe85@XS^Ew_VhIbw_=CNe<SQ;)*M<wQ+rpt$G*d?kj2<=wK
zkT@EDu7@^h6hwWRWrlc2VS>`u;ofR|g8k^Yi91Ttu#YRutFrmPp3VAc(3*AVms;8#
zF%awc)z_ei<vF8`_#$9~dZ_!D<pVd_%$HCNM>JAKjK#I<yL;w0a}LN~x@xe?vUIV-
zpRVPxadalJVa*^TBtw;|zjV0_xeDD`)$T*XMSZ-}<*8PnAqOE)LFtEjev8f3M9_di
z+c40={`=9H0HV!xPw*|0{CV5e$~dY}fidCB4qf2UgJ-)WLQekw9U+(c96Rv_hK!Bm
zJ$~<B6eZ&mC_pU*hvsx#Yu}F&@0*gAL5!p&DwbZT>|GAkFH=cUqtxDLb?aPU{c*;m
z8mKao8#jz3)tF#U-w6r;^~Qlkd3P5?s)(BD1p0#{$xYpL_-YF7!rWG~Dm>4&4eI#P
z1-~uiY6YJayiBlGMHxqX&vlkV2(vq?JSz-bY2R0t`v*(^wwEcEP0;~=PAm<I@oDx4
z^0dk!Qk@fF=xm&}U0c}c8(sl-;GU?dR}#P8+xu!dhY~y;l<p@bs<P_RVmZB{-j%A%
zeNJ`*;tk<*&AnbJMPbndO+plu%AN*?K?(h6g&YT)z)Q7_tr@@+%8$fPnPCu3Cqyre
znmTPQIy_@X5kNQoZMJS_TVT>Y%1lG{#3<qZxQGr`&en|-@6sv3l%*9UWm%zg0o;to
z<u+^%^8AoSzH**rPL~Jabo~eR;#zWG>v}ZHdbm@s+fp#?D`tb5X5jnz^h2Wwk(va;
zmU~aEHu1JxY>Vs?sQIU*5BG1mB8yA+qMfn5-LWWQhU|j9sI-C8%gfrg1_2KsWiQY=
z=r?}N!g)8uG+N<~H9GVJox#OmpEpM0$e7=!kb(V&a+{h}9^0nirWDG5FSQsSktRz1
zyz^Z0X<}Wk^5U7WdwjhyL51mNmCMQ|VliMaj8daJJ_)}9rFa7j>59eGtG~Qu5Ie#O
z8*Y_Pj+YDxc*xR`o_>0*9AJUV!F)!^6K(Q;EFi|bTldAqyulK&K}422NyNAvC)zv#
zgjhDQCesQ_jk#ScIZr!28i&zutZliWNoBerrSvhu%`wjS!{@VEAapN0ERrThw@`>L
zh-}lHAt;#3SthORM*WtpD1SPUd1G+?(+yFgH-cw)dVNVa>o3Czw@;>a(y1GaW|?Il
zBdwmqnkSLb!2K-e<F|)7I09x_SZamjq1Q9Oy(vvbVr=A2=@a~OjEa9S@>OfC^+hBO
zS(Sr^z4t@7b^5LmwI6-`^p}K)b`*43=RyaqBAtXCT~~00%Qcu#eKBGGim%hJ0B#}#
z0%{cF2YgIE_52wax0C2bKn4W`XpNHfU)E1)LWQxoT9@^;(wHYSsaLnh_H5jyG8y8x
zSVqMY&`p@e!wgsI>U49~UKP?-pZru8&=G^oBw6vL=7KAuWq^j>{A1D{+kMLLuoKBL
zegtpmxZhm}KBga!!i^7!#cKa$G!*H-hc4c=A4KBSF*Jf0QyNTn?jyNfbOPAON<Hq2
zLjY+o34$A+PjE0&J5-Rj?#RH^+KtFP^IAgYMQcliot!%Cy6QAz=Y+=M6kuMFw-}@!
zdMM8{o5951oEL!O%M#`24(=+n|BJ%^Jl}R6VeMS)38C{#M0DkmCOn&%BP;7Xk@f)I
zLcsnbJLXnp_#g#8>*)_zpLA4Rry<cB$ac0MdRi@3Nfx~*fp3uFl$4=tg@q4FJ^Cy&
zIij89^WJvTk0;=zU?c7Itazx8w(EmNh0d3|l8uhtc^D8Z`$HzPi#RKp9J*3$=k{c!
z&F2{D=dY^9tr)C6Ynopf6=cv?HUsSW=t&?GtvyftYo{<(!-iYtgV}Qi9P~nF<}Du&
zR@*CoG0Q}5frrVxY?pqKodZRDD=Fu&43i`BqBhhZ%$QW){c>OrY_7WySYe0`z<Nk@
zyKQ7!!-&ba;HTM)@Y8SXV?FQOw0hPq!)`m`k!21?B<%sN0S_3WO*?a;36|+y9W_f)
zXU5<nu@KKTVKJ??G4VgF)m|4Yq4U*nM5)6ddTxhE>Iv0lcv?)Q9|F9gyV14W*7?++
z&E}hq6r?2-Yc(R{t@YG%Udi^!q`zSo&y4tE<nhi9WU`t58>MUWN>E0cz*hgPP@qT(
zR@1oV`W20MyKW*-ooJ?xWjCf_LWPd)c|`xbRuO_Oc^nlbU~@gLYYQ4=e<WlMc_Y}J
zr@kuDGqP=E6$GESFy>yDk5dxb;)P5Jp90{sQ1R^aS-ES(d`oArm>q(yS;)E+;awAg
zYYFXlImTMjNeaQQyK_k7XBr=0%GWC4zpJyEL4%obZB>3JdX!aX(A^Y89O+q!l5TqZ
zS@pw_X%MZtrdCFwb>QOtSr%s*v#zL`S%cZ*l^PTgt@aivR(8s&lI&o1Y<I@VOL&H{
zqH6-90s~~>Jn6JGJ;iRLq{pkL!udNHLdjwvXU-P5hY9C43!wK7GmRLIcA>td&Hvvy
z!=iiL6%QZ-vKe{;O=`(@T8Yk@v)(hc-2#NDhw>SSfI|b-d?5S0i{`+yn`cD(Yz#d%
z9w1W(cPI_PR7_HZAF*xHPzih}nrWvqTBE+#5RtJrSelA+C-^3;oUMSD7d8QP^qs5T
zQb4eOz}<hr;B1@jJE48Dec=JLcY00v=OqJmB+5}*yTq&~a<{`}J6t6jqSJ~r@lc6j
z7d2lksMU!Mq#s|D^kYw(F?-c~MYKOvOq9x_-bLT;hIEQz3qE~x#hRWcLgB;Fo!ZrI
z3rM*+YQ!dTWxSv<%{@$IRYIQ&;t}XQOLTBLxB%ZIf#lU0^s_+tSE}_<gnT}}y=Wo}
zw|Yb~6O@1_t}?iASKo#z(yc*JP(m{xPqh!D`8Stw7Jri!S-m^c&E}?Pj|75It`ZDd
z0cK&Aydyvr5|R6ojs9mZ73_*g&k4xv(>Sz95-xQ5ZMD;_o}7ybZ067L#(pLg7_h>m
z(qLl}ruxbblmxKP$2=11>up^>66pF+O~|u|z%9W0D05i0j|OEtXwZj$Vx?so6%r}L
zHT=6DD8O}!*Wfk#f~%;GUc>FE5rXbzq$hr0ab!@(iLfv?nWgr7xiZ=l(NA&zS3D+p
z<Sc`eYJr>~_!lsi7n4|&`FU9EIANc-60ArhyZQZ4EUz9kl#Q<a&y2z_uYTmmq7iN|
zs|(r<Hnmy0FIOTQNJvq$OYOAgY%7)*=hV<Z0YY1>R;;upSMy4I@+y1~D%5T`XC?v{
zFVnf+qQmCdI`D^(v`Zx;YO|NxquPiVCX6O50>+KM;SuQbf1INJ;UIH;+_mfH<p49@
zpLqX@h_Ed+G+cBI+Ac?r{=<Y2lDgkCI!<JdWI&X4RO$YO^j!Jak}o2`Ci|tJebq>l
z6?Y7Q>0hKcI`PsG_P)z?`eJyS$-XF;gi({v-#PrXyh!#k33AB$z(b`2GRY0@fsvLD
zM>h;ZuuAQ0hkgjnpm(w|xZeq&TV({(B9oVcGqtNyHZlL5aNC29H^D5UyKzO?!<b)5
zAR8^oso65H$5xIWYcV2{lT<$;7;GzW^hBgZbZ$dfFV(+hckOR}@d_tY5NmjKP(><^
z1d-_B6es)HDVkKH=s`1#Z67})#EmN>w(mFuqSQ)iTQD&f*imeCdOw1hJo1-7T)S=q
zJt0Dze54|2?!YX7qxMvW!Qm2jWTjWoXeoYq(oXa%&9<0ur^>E8LFPuUUr{(Uv+|qp
z?#`VicfLJ_<zR}^HsBnHd;IS33(c*i9ghd=d#IjPP47SFRz1l`OhXK$s)lAtTu$XU
z;Nhtnn&tVi*J@#i>};1M2#@+Skwmg96iwAqzrSqH7kU*!a~JsS<|Jb>8rADR&L}y~
zdxYs57Ob8MJ|mgA15DZtGaTCjlJ5s#*hAL)sVAp;^|Vr`bv~APIkawmYQi7&NLA^9
z0GOH~cjLrr!zu1nX(!gageYX-9>$$53UT>%NJGv2p35*SBeuv2-%})z5I8zVO(C_f
zVfp4VT^q-vMG+{sDP0M+Sj19~3Tc;{4;B^gqAit005~uBI7J!B5bym1EU=`4lMylZ
zVZse$&sw?Pn7H>vI$+Z?eO_}LcutWbK@8)mJ%5(F?jPm60PA4Nm*uiYRp-&yy!l+-
zuPXd0f|XaC>Q0oIJUTs*T?472F&xpgz?ct53_G!b2fd^qxh9X<7z@7fjc_7-bFgwo
zTtOg|n%J<_BeyF}gaGsylch97V7oMWk~`*=Z!^Q6icl^jXUXM~4$GVRACL{0fqXqD
zoZ^4(wx#A++FWauTK|05gp|0I)IdKpmX{1Z&~i(6+$0*e@U^9UKK68b?~snzlm8UT
zu)(>WPG@;Kju}r-IF&1>#o?C6H2V9LOHu6MpIV7WO0bfp#&IV}0w=JqzUEwD&1S}*
zZ+qkD&|rPyzI38o|2eGYpOyp4xE1;2k_cBm7pl+`WHO|@ux(D~r-a9TALD~vRHT0)
zi@6lUnqEhG7baw;WY1;%HDEy78Kx*jUlD<WB3dJN?gE)cwH$TDhID6m)5@OGR1OQ1
z{o}zuC2&xtiOijJc^IJsDpi4SgSwAe#tVgyHre0*1t|L3TVEzc!%3O>pfWk54Ko-%
zqQBr8W8{E;8!<)i-}5cplIw>6qfdfi5+4Y=F2G{n4i0Df{Xmvv4U`6EfaGIiX|aK$
zDlsRL4U$Vp8%Pbqvvi{hBapUQT~jOw5rb~Pk#;Jtzh}uLS1(?>+{GSQO?t2mjyh<&
zT47CSRzsv-$(UE(JPukTZI4$+Z0e-Nia79|WDtQ@m&WkR5*Oz({T*V!3_4aOebo{o
z2}=lsK}uCDqa6}-ZQM1lX@F$s41hEl%-gJqLCyKC{w2vTUAA;-01I-MRz+ZKzYFB7
zoyAVcu|xA@j$XR^UhFOC=$`#mGM~BfrtdTH{BwKb@HJG`H~N2ufP{*&9qnX!@%A)v
zVxMCD<wIDEv<qaETORS7hFaWAtQQmtwh)1>^3}ha+zkzF&+DIGU4Sx8`>()fy9Os(
zu_B`Jvm%8m0Sq_(9d9RRa}+y+I?t(K5+?KufAO5Iz<73TZ7qkEDrc>>^kwSMr;MVD
zvE5R>CzdAq`k&B($a=I!f$FNT)$%o<@3m92uI2I3LTPL<)Ie&Eb_$TbHy!8s5XAL&
zJOsx$ugz{q{N6)&(n^5~V0d1y)m%{!Jf!`&%Gl_^Wjp{P!ppU&9&JTSr`&;D5E-V#
zoW4XI?c3XOhc}7N?VrolHV8`+lQ|bWHKi@d`}-{sYnm#jEzJqm-tff)mZVM~(&{**
z_4TQaHe+cqT5vBa_aFva^rb>#fX9o+I&uKCl9i1l<RLDgFd{DUZTuXG1*7?ud@ob$
znEwHVe+sfY2r!;r2RVslegD?ypnK&Q9fZWo$*07{O^7h|W<ed(8EXd$DU>S<#%A;l
z(J8Gh)4t2;m$@*^Dz;V;y?L&;fCM)Gf|4^3*Uyq#+=R5m=T$dH)_Fd|y7zTMd@GIu
z_eYMAgI>pDM0n%ZJz_mIwF!J^8KL!Wnp=vPSK@TS6x%1ajvZ%am8q8GLIdK8BDF;u
zSaQ6NnEqUHKYEQReT8fdL3<BNx#&(DwKfcD@3^~bx}@=-01e*^prq)zOJ5AWk-?zA
z0~aC)R`uzvgPUTdB$^7sN5vyoxf`Hmnxu5iY(W6-d#uV5sOXG_P#sW$^(?ZR2do=q
z&Tz5GfJn~&`<A=~pRj7TB7Y=*TbHSG*z9hh!*kkDt0?5r?Fvm;u~Z&fvF%1+2u_x(
zSl$)n)1+;j_=Z$*Abbf#S?e#@J_X03&a+J4v`YUpgL>~l_`>@kIdUKg6Bg0YMZ|Zs
z?L*mO##GrbEbwnat@t-^y(2pBcSWjEK{^FI?3ChJd{IS(E_Su3EAqt3_Gw)DH8(+Q
z<|ByfY+g?)cYco@6!c+C^#}FBK`G^l-Cgz<NAS(y`8+uSK?HWZh0&9!3#m`R<&;;h
z(bB$_R4%u_VjbeBeEslHmh~;`PEnd{|Iys?aSI>m<EFvc61uQ)p`trip>G9{&cHSr
z^EpH47#*U5^gF%y?ajjTgsonE$$~sg9z*=l+ut4#4YMjSJ}C4!T9nz|+!oWY<wB(b
zB=djU5^AFo*NkbDJlaigD1IgBvb$o<!Odw9WvBR7NJLCyeGE;)1_HW9&g-)1nZS{s
zSjvL5ZSpV3{I-m|4qBv^)0t&taUiH~hmO$pSD$x-7^nyh&AD{?2KA-RbD9uft4EU=
zFFV+BCU>ZzUf>d!=(#I`#RZpv;0(%SRu2K<jHCIHEOHoetT!MHp#hKcG31C5O9g#f
zwJC?iKQDxU7oH3MzHK;IM|&A^u#orP5Qh+XBy=GBm)=yf>$8jK-+W!*mN|r3vEJxw
z9!MTHo^pB>v&xNUFtxWU2_fqe38Ms2E&(yX-nZK5@cb&-h+q0rPnz!mA~@R!u>QJB
zy~!?wg{HE7M(uNU6DN@z9*T3_?QUb8Skgp-i}CgfxS<ec$Tsy4kIqCYxet*TGI+gr
zu%-qyAkbF4EOm~+kE|Jv7Pxi{lOx`!XFT(xIvpz>p>AI#3IkamUb^nI%l_QpY|{hT
z>#QOGQEH%_$7|b-l|OZb_>Yxbc_OVaWHXbfwWUM%lYzu*lNw@7#qc>JsQx8ReN5a@
z!(H-6H%c_!d_eKkle~GZ<S!+s^=mF4#}I68t-1Fn4}jxJonT&%5J?cn`hc?^1rpY(
zsWX7OV@$#3S`5TeY+3?EZ*?Ss8g;xsvS$*ebQPbf)jF$9c^Ym%!z@E<X>f6^JtfQ9
zi3cACq&u9oBF_IEt_q@%g@QRgr`YeN_5<M`lJ%hOuH5lHFP+#m=!Qr@T~CyzO7-E_
z?)wct;GQ5>5vaMORttZ;r6d}gx}Zt1G`9)l#dV7?CX){VlP_^bo1;t|j_!xdWgtTT
zj?h3J@lP_X;$lY3s5lJ`fG8%5Hx?@L6?+nNQjk#n^)=Pa)i=Qg_JZIDt8<C#0;AJ2
zGsQWoQX>&PEFHgml5{32G+~bN;_%V#IPem{Iq<mbT#9CeD|kWg*4}9>%XHiBM7|<b
z9BcR-T+#2XrUPj06qWd9I$#0m#L1EV95*GJ^m``TFYGM#2x=c7Y*pRM#eACM(WcAx
zXpih2WG+u#N{sv0aEzIg)5m;`_lVX4!QC}$065kk-HuKz3tR)xgP8kSt^Xvw(saMA
zU5&<%9V%V9apkBLhz>X22rH9pT?Qw+R?_jQjCoOpB5j6pKoG!5T!;G__=gFHY}^dg
z6FD%4*gpaMk`+ijCVl=OfJA7~>rNIdN)KCnGRV?8dOMV?rF6~$>a6~a*^iqtn69dT
z|Ew9e7?J%GZnty8VbFhtiw{FAhZB5!8YBd`{hV!O@ePrYhsq~x@qhhX)MWv*%!h6?
z*-vETUw%BU%WrpT5^U98Y9ckit-dvBNNb}0?Md4p#QNRX!+4npc7et=*=!D0S8fP%
zR9Ix$kd%VkW4>NoTxr#odEls91tPCpIm-$|!IWt+MjH|!J{CqJSayc99hDp;VJv1?
zqrQ8fcMqJw$UY%_l?LCe3KnrrJ6mdfbNF9c6LM3lSyJ2*Q-YHYjN7MIFYv$tHFIZW
zlKiWZ&GZ@r(`sPf>+|y=neIMJohUO8q~6B1#5r})3f6B%FO6g`-;SQ)VYK*czfDo2
zCV<t2OJbX{Sx0Bns1=Q|Q$jhF4y<V^beQj2l1t97|7e5!rJeBEuzV;_ClY97ouWFd
z<%#-i6Pf_?y=)#HSwQ+3R&9$w?2ES^bC+Wdkfqfq!VQnUiPG{!4jHs%gx|;a5ipg%
zITEu3JSP&IuAx3oe{3c;tTQMe$?%YajVL#dtW-gIU8%DNbVp)XynY8Fz>f~YNXCKm
zdb)1@9ZDBBo#<i#fj{wy`mPuUf)r2FbKMEp)eYJ$Jkz>#3rI%tlBYU+7uL9{f_5xj
zV1U2qY>OD-O>HqxzMoyp_~ufO4rRsAVGmX7Sj#1eb1$BWylqw1w&H*}i^9i2^(KwQ
z+7e0#raZ`>AjdN`|Cd`%+&fGTSPQ6%wx<uU0;MM}`s;riYmd-kVHK$`<pS20gZ5q?
z_338X4IhIDdJN|%JR*<3Y?zpe6Ku0;eFw_@Qb)Gcwyi%@(Tx<38yjGiH$FlO2;KW<
z7X8qzYB!a+cqnPI$}t!Vsde?t9Vc6pEp930-T=jR(V$3+jRH-tK#8Qa@!rczi*<pP
zfC3<&46Y0RjW|neq<aaw=-TB?f0lrwNfmJCCga*{<`EC_Up9*}L(j7fMw6*ATc;dO
z&IEdJ_q(hUv`we#V^18?BlmqHqqEkbayqbFduk_6yMmk01S(eQ#$l%ZsoCe=$t8D~
zyWU#IF8wVImiR<JP6_S|4XV_DA6HZ&@Xjg(jOs$sG@E$3jwRF`RyjZPs2-18CsvNV
z*UV44(UHZA^v}Pi(`9=2JA^ZVu>i^5!GLmoSJ_-EBZ%ALu#tAQtQZ`_20k9ik)S{M
zx%Tpk*Lts=!6vNRQz4icUm0nbja+7x)=F6$!<fC$#bn;WPm(2s`+E>5$_qcYRIfsw
zrhFpUzLAHQFATKBK5%$`sizHVI%`dM(1$m0Y+wlkK=-hYMi^j)mHqMK`b-OAAV#fw
zA|B*&!xb@jPZy3#U9>gK`n!2ht*<WET>`wzfI3<<+5vOY@U8s!XUx2@3r>WPbW#&L
zV<xpk0(eqp9{aqK#cY<F5sd^9Y4w#5`Ol@{_^T-2kXLYzUf59g9#MQ9UZju0?VRLu
zHut>3&5n};+YrocWTKjq8T5TJz|8w(HqPnJzOdb#&La1dPU|WsahK;OPWxo)C`RvD
zFNs&&qD*h4a7Mi#>_MM?dTm>$_Bc#-ZGnhhnGy;7t<dQV^KqQFM6#=z_=W(Ou1Ng(
z|JG?F)RF<M{n@~r0Nvbz_xyyp#j3kfb~u=l?$X+V8ryBG#Q_r9sIop%2?ryuCq-jG
zcp5yPZae>iRTgt;dfJ9+o9U))>4;zJ9;SV$WpLJd!TLWEK-i&Q6Nb9`$tIly8H2W6
z@3n@xm%umPP_(<h6rD_x1R`xOT~93Tx<S(n{lDt$+@st@l#W8xv5-6OIqN}1GS(mL
z!PoTt(3&cUW%TntSV0#C0c77>NF?daF8CcOOjsV1TG5t0qrsQ#h@7LDcxE3DB5z?q
zVTX+z;<y=|komvHbn^cde7y|gP;P{~k<CegIg>N-2gE@}3}iQZAKxE0H5PtSMMVoZ
z-QRGyt%E%kfD@9^bl(TFm<NRr$O!{+6tMP6d&g6X;{q$(F%IK!TvLp!0k@KIz+iI&
z4avp|Xj^!Nj%2p!&~-$UA`B#ozU>1<?&g(kFkCTSaBdnpK=#=e$_o6^!ad>&5&6M_
zJ)X%uYi%gx6#Lw$VL8u61rR7>{dA!V8*=u*o;uI#8tyT+$KL;RIZn#VEvh^>SeR0_
zmm<4w$l(CU^~V(pCOWht^Ol1vEn{P004w1&ATn}gDsQFZs5$0c%@se7-CA`MDWYai
zxVHj(*tfc^4h+q>5)%_pw~$wv;@Tzt9n7Jv<{37sm{)Y-q6kz?R34n>JVAToqR`(I
zFYd24pdyL47_LN=vu!7j_qZC+RsTggW|jfv@bH)BEE-2skE(gqxu{JiNOVunl8N&s
zUOg3r%JsNCq2c*ekaH60Nw7o;^XJdArXdvr+lp^zfW;nyuUsZ+HL>Rfue){*7T|-o
z6DsMnD2uJX(EFGk-o?Sg%p|^WTXLINB^Y4SXa1F>L!Nt`scEM)k~ma`_;m&XPIpLe
zCyqyD1WRCeTv;wfrDP<eFmnJ`-;VODq8i47XJ-Ij7x9~{fgcg0*rRMP(-xW6p&@TX
zV4YOGRA{7gePo>h(z^`eE*z&V)F9#?d$nw7JP_eKhCh99c?^Bd4dc_sHKrfc9<j7X
zdve1tgay;Oz6!celDASEZ29{1CCD{y?HBAP=NBqe<m-#iV!;}9Xg5XB{?f!$c&_RD
z#f&RG(ucUCyi3YqmB!nEjX-ihPI-Nbidzlsv%rn2$6w0@j(ptvD&Cv40_U0XuiuVC
z=#`IE@s2~!WyJ3g%RBwrfBVJ{JZXKcg838C=jM=}x#lJ-8(IqankTYn_i;s;D!!Q>
zD}SMMh?O<iq|*n``tpyozfBUOC#q)fXnQ_Cv)`VbX^ea|C}Owa^xR1zHUHQkkh~QZ
z4$*+{k+izmpB;ZvnR%z1I!XK+HpusJs`s594AskuKt9w)YM0)7Lp4(5+&3q)96{9C
z^pT3ta)w=-I{q_7sa(I#_pHIsNe{p7+Db}p0Q$p*zuOEP#R!oyFrZ}14qq`*$6P|t
zg-GMREZ&tx>m{u1W|1^$ln9WN=4L*txG!0&$R8TTT@z8DgT9HmbrL{9n%kAQ?!TP{
zTOQ3Z97mY;ZPGwTNqSjuL0*xGjCEs2f#KTGLuP88qo<l{A?r~g<hk2*2tYDj5rE$;
z@J|21E`_`J+czNns2^rDmEpCKBu}b{2T(}Ei|k{^OAnVp*`6a~CV}jc^nzz?jyc+f
zGX=bMA}*bbaiy@#D4n>hL}dkMNwAOmKdw9$Ex9?@-a#&0jDsQl;fyp=Kw`R3T=az8
zX@IQAMq1(zKVvOAT^N2~BwVl%(eN)T@dSf&ZsXp#Q1jolZ+hPGMJ9PqiE4EZOTm0J
zs(zGoR~k1@hparjDa%k8IC_hA#sg#;iNpM#K1%PFiQ5~tS=sqSm%Mud^MnqK6ex}F
z?F#))TV$-I{7Qx3ts%GYbXgj06;ZZZjK|W@V%JPs9ZjxoTnU1Ql)UO%FdYC%4%p0n
z=4P@Ezu*s6vP@n!%tDBo9h)|3SpjhOiuCQsYF&7(!5;$MH;Ur+-wqrjj7%3^MP0$P
zW4NSlS~F~5f7!&B{i{+|04+e$zYK%Yq!t}tFu8oM@<44`J&VqR@S%!GtWl7-OX)NT
zQU$@i#qO9HGMRn-$wd%{!?JO%J~osqyeWY*K;CsX`o?lLP3t<www92E*C=(q-dL=y
zCw7NLeEv(aXrIAt6rtla0w<?9@;fg2L_y<On!*uK6OiU+u$h^RMptUNSYnlp(vycl
z`d|jB8}m8$*ky*mO1o}uf+Dc%m%A*F)k&I+JxXnwqTR1T&6NXKIFI)5Es$ikI7g9H
zu}Ftom3;x6is8wj=In08OVr>by8nzGI)lSl?7MCId8Ns$GmHXeiiP&g0_uE9tUcbD
zYV>Cr@4zwsDp+PXxMX-k(3%L0`c_ko&2<CE$?juhA}p-0I(SgFk(ca%_lUpV(+7Q6
zI=81@3H~t%KOG)OqptXHL=d!bq)6+=nPG-IlY!@|?C{Q!<Jca?dx{2^DwP@CsHz--
zZiIT^h&jeC4+8?5p;OaZfyo~#>4tj8P<s1mi{<jNMN-aZB3hnFXEPLaCp@tp!QIhr
zWYy(Y0Yd5^mx6N0jBwB^l2Rb)$Q)ofn@*{2ru$j?r%gq+d*%~$jAW0RH|gQ|yI}#P
z%HVgE@HDt!0SO5IMH>M{5eg`QiOz3)-BGiZCm}6^N`=PRN6(bMucKU0QvuUcL#i^f
zR^p<kvMP_+0ie8<fh@p!i0*jX+_(5>SkBDoM7!P@6E4*#FJ#v(YAatJiQuFXDpdut
zx>&k7yqVg=t=!8ST|0(!Eck$FyWO$R{}kw~CLlqFC}D>y#J=vnF5c%Q(WMNb?JO|)
z$Sy1=1?uNk(5B)la{l5-r5>PglyyYcO-E}z+MX_RLX%~Rz^zM%PoZbS1pb>i&iXMz
z!uP?|aC%It^nCsP3n^9`{_!>~X`#bEpFPXou!W~5!oK-^;YXrkMBC`~T#rUYn!0y=
zWt=DGHlSsIQQ!#T48oZgfeQm4LV76xlTw2B`Rgre-Yp#<Bgt0V^zndw_Xj{^)1l@8
z+Z8cKy|Th^J$>shB-;&^yj+GHlNO0498>^e8+jaY+B6)T_|qtpF_b(mS;(GjgIce9
z3?z%-VMHsRn4|q-!p5N6R5RZ-4)&4^um`{4kHZ!nrc}*!@Ot)xY{9St<7yioKEZ^C
zKA_pqV-iOIQE}INZ)v1IDd64}XQ_4uq{BoVKSZ8rW|M$PU9~M-hhMS4V{en0jes)u
zTyGE*NQ81}>4a1^5<0kvCT1E!ag_Ebp1dn3)Wxv)Snh4jF1$_kFWckEezOhD)ehk0
ztGq$Gi$Co?K^uj9o!kktz+e)w?Smi}4_^eM)Ma&{{x<I(41-6!HPmuODIP|@pmVQd
ziA{Qo^Bd=uAnbpB(H+oQXMsN0M7n3@_dD?5%G@B{&57+@3hB(%Uy|#9sUAEJMg-Uk
zRB(N$+Qtcv4ypNWL7KcZt9lTDAj9G^g5fb2iqisFTSs{i?k~B0<9)r6gl_9Wh%ipb
z()$frK_FF}lbQmiCuh?z#mlZ$?0jqpCz(k)PZ%`IDA2~1`HBJ|_mfX0k=iyBl3T0m
zZ=N%=9~&aos~eUOxhTK536Ew@Z+R0_D-0&8<!5X$e|IV?eRL!&y+)W3N`eJ*)*Q6W
zM|YfzU*K8<EQfyeL98!Vq6X1z?p$;1gQJ}Ba#kE#2gAcl_`qH2(SdnE0()s3`eQru
z6PP|sn2hlCT&bs)7?fXrqeAR)Wn5gsz(6`Lvc5bS!^-;zh#VBvh9iqcFPca90e_=?
z^sWd4<ae=Xo5UBM*cPay<va{4v;enw9<B;3)U7C_JN$S)0z)SZn>6&PL^@p5DmMXq
z!N_Gk>MOKX{=3~8;zN1*1Ut3v@P<#qn&PMXC<@m_-(h_p63n!7C-N_H1RJu0<dU=i
z2L@?@q^|B(Vg5j7AkViJ54qqNFY0c;bqEju&0jni5mH5YqNG+MPruE?jU#uCVMnlF
z@j$7{m#wOT$+coB?+EQeVEvy^#DCR#t!`SH)}ejS-KGLEF+Yk*aWm<-q+AMVwll^T
zOuKdK9`OdM8~8Y`62`)hdu){FtK`sg3n<bl!sfNijFCX}1m`FKs3m%m-XXLmbeqI%
zSboaXB8Cm_5wZFB)E@9;urh5GHiS!I>O7w1CZtZ|mEXt%2Wvg~#WgB%$jBoe2rlq&
zCF6+$8zA$c{zr6^S|v@RY!vRX^7@Ui4kEh+7-AzFAd*^QW9qS1QS4PTq^>GC{Al{!
zD9n*}SVX5HUkmAvGE5RIcD|@v#e;XYH5Y*&Go<I(Y=QBsf$3@uFXqftFgF0K;6s-H
zVEmeH&isf%cA`%`{SnNg@d#@~0GwmKOxAz@g2_n_#>G_0V11PrfOARSYWTXET7lkk
z^LS15C!YBVvPvJ*kWlk9%YQ2kd!e6qe9hw}=>RITas4x0Wmjz#aKl&Py|)Xl%OI17
zm}=2`^$@wP3w<NYA9?6b);x`jILhpKRowBhiVh$M9s~z%MmeFq?w}>r7@H{gg^B)1
z(L*o3^-&P!WX*MNNJwOx<IIi>GX;VFFazqGcw4u*b<LfU<ZXf$hS^{EjZyTxDE;w&
zm&wTiw7^w>vVyc}_+&@Zt9oMXeYUlyXhXtUK?5oo@qE68Wt<fQ!jDU~c2t``G1PkZ
zAY7eZGKP{PNswTWN-Oa%l=1c_#MIta4K<dMts&Oluhdz!h<`7S$FZRkv%ALM^+0U+
zqY&=j6A&Mry&O~jK{ekWtWu+-?yweUFjcp3_L>!ssM~zl%9^f86@FrWd`m(7-a}vM
z#2$le6g*84mcs4&QxGzXsF(vdGJOby!iuF&bqStS1wlzns~lIUw-iG9r@S@exfQ#_
zyrf|j@9u5k-gGko6HJrF{>Z4Zi;ypT$r+RpF=T1LS1ja;m1rXxiblNPVrxB_T#?C@
zheydRJNizVx<Z4r$k2xx#7PRFVRDa8**g`&GDm$2|G14KhHv$L_?pr|5{nMF^a&vH
z>NAL8DcQJ33khDiPCAbPXiusVl$ERN@aqtDU2}-}R4)xrkFZkRRLzVKRYF>c+MO*2
zzr5(on?~NowV%`HP&=ci;&P^=n#p05(#h}5{8)-M{!@OC6Dv+9(d)M=1<tm$;`$NE
z0l*e$pW$#H(`Y5y*pt_J|35AKIUAsQUk~@~h08)B@66?<F&s1y!8##bA`tO=B4`i5
z?`IC_)c88XQ)vRWY38jo(-*PtEaHz5oJ)YYsxj@?X{FxRl*Vh7kPp&iv&jJZ1!fc|
z@$#J<^YmyPrm1P%qyRe!;_^0=$(NPYgrD_;etWp}5rxonf4An%K}=ZBrIsSu#LYO^
z;V7Q#(@fKbyONRuK5(LQCwGjJk>4>H&+=J=SY_^|?}4xcT{ECm{*f?pVH}5szA5Vx
z$sjiJvbBAs0}+aR3bU~Dvx_Fuec<_`qihIowJYT3;>S@2fPBlV5*xLNCKEntUBOqU
z^>AzjULZ6ETqz~Bo;QZf_EsCW#6B{wEO}+UAj$V}!yFNnBf?7lX^Hb~(a_%Iu{WNW
z|HpIKZ+%e`E@Li+pM!Z8H@fsOVHm{1yH7l_z@6r^TmYdKX-Tr8JRfO(Tp4!}xZ4s3
zD%B`p5M!KAP4pl&u-jR(KUymXR&}<V0S4_?f}DxN2K=70E*A1&sfH72hX--;Mye3I
zmj?13Hsjj&H*k@f!BpSe;gP0h#NyE=sw`&2UI-@&XFLANL#Q;an8W=QM+V&0I*a*%
zLxOZRSsYVY$=2~~9|fA<msRjr6YeKZJoahUlU+c5$My8N)d?lvIGd|OQ?Eda2`1)q
zo6A|1C)Mm-X)9rRLp(nCi;P-UptqTKs4GnQXsQMWw$k~(I3pf+_X^^-8NJ-YnWCFp
zX=9X@`C<N$D#cLWX0$83#!_-?{f#pQ6RP1q<5euE64_}(UVN5Q$EgWc8PU9^6t(<L
zg*yDT!s|*s%rFr||7$$zB#@8zXK9N4^;=jew~2%#+9$$kO0d;%pe-Hd9`*;f>UHkx
z(o`YmLB%B$YSa-O1-2u@3cF>h;bMzBA)0G!d}mAY-U||BV5}eArFK!XH8Zo~CH@%`
zQuRO1?F8ZHHS_lz`+T#@?(rBqp_Y&dg1)d7d5X2WXI&_khY%3+cG`$<y&6EnLfw72
zSa^8X=O$g7?7~XNpLqy`m&eP{Ipj&v0bHjSAdM;bnn?N@w0bV+NMi~D^(QU{yG>41
zBO~T;K(`k&jd>KP2<>^udHSWbs>}g8L_Ri7zu`=Y*m7>tA_8e*tN*lOcN$zj?w$8?
zwBIzs>s62TKpAw2ffWZk!JZb_U6?*E7@n=+bCQ!5i!9f&26`Y4z*DJ2jNMsSUB{8e
zr0Q>aNHNE51DJ_m>(ys6yx_&hf9K3dz_2h?mK_z>>K26654N)>-7QSE%RtT{Ct$OU
z$xu`Nb4AJ!L2Gf47Lv*{g=UjSaX!8;L_x3z%zKf^pO9qmrjG;LvfD=#N!XbTl?<9x
zTMPtdWf~Ne^|(s#g-VOF2WxwqpLa%oHYYQk_)=pLvY*P-V950JhzEY3o!@eQ0Y^pj
z=2!Xm@(|hEeRHAjjEs%pVJyQ<BvLmM<2<!7P9k6s*(7uyyCIk|$N4%yILkIBrYNTN
z&ZB57^&Z4~^*sG8;=+iD3*B&+;s0;S*JNG$u9tab<HN=B_+!YN*g`=%LeeKW@{R$o
zKW}7LB`V5zBWqqJ9K|p^%uq9wxU46%j`z>7g{>FDzium`i{}xuuq_uK+AYCIjW@sH
zoE4(Bzv1=(C$27P^lD^*cBNg4j)@=9g*-Dny|S9_30tyJ!w>@udQVDg1q)R>A<L;Z
zRQ`kYANmSSG5D1go&B?qz4R%WnJK3U>|XHr)*IL<{p%TP1(@m?-FcpYmg9Rrpk_A+
z83Z^IjOv+mW7uA}lpRsQL*;8!Cfw;dJI~S~2%gYy`o+1_&wIbJ8%K>zJlGL}Kh3u~
zGlb%3Vt(`j`P!R;vkQPISFKR+hg-I$KMmc;OuMM@;fsHJyDBSPU?yu4*pMxL6Agri
zCJa`QzXK6{OZV<G5K}!c-2j&Uu~^N3;Hbk11MIo#yovF@PkD_yGDEL}Ir->AIJvW?
z(2?xn2|?O~q~qj*hPrANzF=pNp8*HVlVtk8#E-WT&3d&Sl)dF-^#li-7Vqt>NDoQR
zM{#94MJhw_I2E-u6NJw7qVA&`1@sTS(T1(L9CP26OEMp^uZ$0wAmLXH?09q+nHq&g
zAL>YSg9Du7dD-Tq1S;wrB1+#|(vratg~N|St-^7~Q=_KqUJ#I__)5nc(%{Rx$NhB0
z$lb|j5Whvoc6Jmus;Z4z-!?E*rUjlZe$lg<J=$g{Ztw19NqieajVrj8zOd`86oS(F
zhV4;TfOGGXAV2z&f$dE6NSggoh^z{9=4@2igypFZ2=9U5rrZjHQ{u(`(Sa{jSbHe9
zKcq77%#C1MO8FV%5@7@>lsGOqLaLQy?vsHC6=JAvMG5SC-ybrSlq)VKS0|0k^Qn*P
zAy2NJCEfMqokyaLeCm31bsn0~qT>MsKC3)7Ua$K1`rbUXQ!#yfl5K1tGB8HaPL!F+
zXv2k2NZsWB*FtOp`Go+3H)5A4rj&qdouJW9qTfrbxdr*cCZB(^r}1M0t%k-s@2L-Q
z9@AJ}KL8Zn+rL4!cIF>{FnE(>ZZbgRYYz40gM*Y6sl4FGINnovmnlG9K>f?mrd{LC
z0C#f;Cwq>s<q76owlB!9=w!iSo1#Xbcu3%vHr}~#E^fwfds8LD8HU&05dz2IG<aFY
zlnLN@f!i{i6ZXZh<V$VY?PfG%F@jpPP)pU)+^AwHP<9jkPmu9jcOCi%^vdl|C&1-q
zAf*n+<jB_`<-uAMxwij;$tG_)V-X&$ejUIv-fUANglhBmRk!$I9qP0+kKPZcpf0eC
z^UXlMB@Tt29MOs9GZk3&pX*5w5A%A2r0N?jldS+$x1S~;U^s&q#yQ6)20jOG7R@_p
zcAJ!x+Geamn`)&ffi+_9*`N$eE0v|Y0pKDIypP;E)ooI{D4KcGK*ZXkOJ0--*=5h@
ziQOYn*D)}c&E`E>iPkH)vC9>XPP%R~Ya<`pc!%7IpRd3zP?*(*umh<3Ta-Ta39nI<
zJE`i~@-B=4N@Due4@!GEbh`JsK(MZtjx(;iu3Pg-n;sDDC}L0zq`Wfnp{3Z1eB4N+
zG4Vmhq5tYYN&tSN%_Qfbf-%7v`G0CMIupe426%&*{&EZnKWfz0H_cj9s|JZDhDeJw
zJ6TLpyfFr?ov%hXG71di9S#9IlD<wa`W^acoSEA(W4oO4JI6Dy3CIKr>SKyZ4k)@|
z=zK1P9*ok|>ZmT11w~?@z|S?Wy3S=yuA6KX_?;og84PMpui|r?yU6!njoY~2l)*p~
z#rYEvYx{-IMRShsQO%lDtt4Ot)d+mS@>vGo_r43(NlLLI#4-3+u8(w=Xg?4+KFV%M
zEZ<@6hPL)!8w(59>KzzMS6igGOlsT<l+SdHqN1Pzx{i`&{nXzA9YxhRZ%A2BtNAIt
zEZ~Cj(S_CFlkzA+U4C65;gnW(s>>5{(eY{UQf#)(U38eSOpi++2gbyg|3!V6aT>U;
zB}{p0KAs1u=0Pe+e*DAmN2WBfmy@S5BVkxl9p@p^pHpY1xT#*q#)dX5dV%+YeH#|V
zLtn-6{jLcI;-Kwdv3}n7{sYZJ&|QU((AUn)6dO!>PW+}-I)CmS0RcDrX=91v{S<7<
zKc>V#vB_%ZYM|mYAw|oRIl0kswv)kz3z<kv1li>;mNYV_Z)ncn#ZD=e9&Ua~Y`5`x
z!N8OWEPsK6wFr3l^00cq`Gtc>a3b5`s0FTx6C6jcjjovM8ds=_(Kr_JoZjUkQMzwL
zg)?A+><VADA>U6Vp8n^A&aw6D{Ufk=smQx>c_k|yI4NYxS6F$@*z7&;9LI9nY_FLs
z?gmD|3-!b}ulm|SqNTy`(fFL>MJ|Pj>aL+r(G_aL{aS_kBZ4afGr*sO#}p61b?(g3
zZe{D&-<~G8?BqA_4B{O1`C?|IvSTP{SEk!7<3^zJXe}N7Attioqr?Jgs$wmC#DJx8
z1c;Rzk@G%CB`e&8GVRR06bZMnO>nEprVX4>&zFOO<a|h&b1-=&KQ6~MoTPZfRI4az
zF!r+y)Mh~d8mg~P^Dt^K>u5gOcdcYm*?;;MBR8wH8(yfrl>YeojcD$m^{OPNw7y>H
zA?&uFSjUD!5&a9cD&1!suyd(#m4}HOlKgOH1eV);+p{r^AX2(R&!|1^t8u|$*gr6G
z>im=BpF<K~ped{>s*RUPROqpt!2^nU#|38Vz>`ynX&T&c{(MmHCCcjvxODUTz4S80
zsgbxJDA|kDPQ#>0l!LY!Q_9XVQoMP7;n5n9z<4DE#Asod@p6rfuZ@nXc~3f*fdzu%
ze>hDP9&$fVbud2?G|)IC4iEM|F4n&`7A_Ck=VpRID|-}y(UWNWkGlF_{kPe6Ty0Wj
zjJrP$x~F!RKH7!TR%^&)Z>7oKXs1QR|Er?giwZv|2F9z(CJwYtaAx`Vce(jmij5!}
zz!%~?nwWLrS#YLuwh)oTmmgj9*MMPe#us}7M8Fbipg$im<r${&Qjy9VLOTjh`^=^1
zMR+M8BW;aZZ64zA3tfQjNw)yU1UH>!2NlzMT2<06?0iz|Duq&ByMCsiLQ(nh7|eYK
zmTNyafKA9bWo3XSmek6VYB`~8%c4N85J_(-q%i%tb5k6T`wUf6Ccn*~!zeFuL04^A
zHj}_IDgA*O$?En~DGN+|h>^w|?i`*o=;!J@8bU+<fVHRO;gGh9f*R1fCfk<_!5!tx
zm{cr!jjz=gHDUTzD2Z_$1Zq-LT_5_MTDuMAi#kzwYxysjr)oWWafnYMFB1a|vFBUM
zhN?nnH7gT+Pb1)|K1;8bLYj`j#j9RdO)aS@m1f0@FBBGc_rx+9+s6?xv;)k2U*&88
zPH=+Vm1F_}y|{>{J0NdCBuDA3RU(o&glntTUDX6Ij{Nz?RJ*Y{Id?%)B0biWow6zj
zHDj#nS<~wnLcNvr2opjYcK`)Dgb&!Z);{Re-JOo^bT))LmkBx|{Gwk(OW8{Bbv`CI
z9G#F1Y;_UT_l*4^BT3&q4PnA?6tuX=qI_e)8<HJK4CQ?t`^?g=;M3EP!btEG#<tZO
z{xDh}bLP@5A@-NjXt79J0`_BR`2HG<tGIo|XVK>GN9SE!NZWGzCP}LXlLla`WtQUr
znV$R`c57_2cm8O!+*bh;Zk_@}JLBQ7by+#3q(a5SC6Bd<By}0S%!B}+ngMogWj0XO
z6So#k4o?(#Nz)B>6>FT4Sl664F{*nUbQG@hH}%Co`|K~4@~0`Rorahvo<^fyWZwJ0
z8kn^0=`s5`dN#R2m#Soyci!?R0nMHH-Mq2kciII)wyoFW5R_k_^PSVSaS7ERCjY;W
z;+n}UA__m*yGNF)-Dd%)npT$HstmWb^a~h>GeED8ObGL3mVhj%mRuj_$2CzS8Q(iM
z)v3<jewHkrWEUg-isk30kaf7a-lYGXBmNZ`n}#<`xzxz5luBOUiLbp|Xj9XCM}eMp
z;qPc_1N}`hqHsV&g3Ncn7o6EFy9;;I_AC{Oq9xN1bsZ=EAdE>o2kt-crlV8Wn4-Ic
zVytN357TM&UL^ihpIo6oeNYmor?dK>-xhxy7Gngucj|1};;)5H7CfS@CF_87QZPyr
zAffo*`tCsES|gtwD0bVGBNAe-$uQi^QV=b{T?J<ND(>(9S<4b3=rBL$5B7L_4j9%<
z7T9c6O56i$-v2?RnF5t;fO<TFrpB2FRpHL`<pDz*_8|BF-O1&b1G>q|@m@E|gOU9M
zZUnbe%0~t#)4{~$POYhh$e|1y2w}9T9LC<|9~xQa{Vm^c=KN5GsfGM69$qwt?$!~t
z1@<S9cs@3dOPIud!M;-XY>HsvES(sbYWfFYTf~YW-vd5RhK)@aOvgq*^StjYli2GM
zrpGIFfZ_4H-t_91&09$q6;q3LUy4~zJL5gY^5^4^6W%1d8cfTX0m`Oi4@Db11Hs#F
zK>rCrX8Y>_1^S<hF_Y@bS&VM)F6Dt$;%8)cgwZD&MHEo2(v*kf^jEw;GRsT%&n&#a
z5M<QNVmSEgZ~Z0Z^o7|yh#O#Cfz(gLdS~>>mtcQpnv@0B<q&s1;0g!0@e}2<#$_vr
zPbqq#8;pIsP-NF)4GroB75244vskeip@G#4TC=l3(lJ~vk~to%3)Qrwmq&D>;GaHQ
zyd`@gW~<*{g9dh>8S^fGXy|v>%`2P)TPF@1)e!M=cqse`1vsduAKIjeeuJ&CsUEY!
zetJgC`#wIA6jR1n@Wk%aa5<0M1!{Us`6Dz3R&UpZS0<mNIkq1vA9&Fza+eXWeL7E~
z%N5cx*}sMPhQA7<mof|YYrlBNsDy<eIO)j%HtCNBV?vSstaHDc-?}$D%6jk2id(oQ
zmd}a-KuoP_KpjWg>roLuRaih^f#OV+%7;Ufp(lrt846RX40;cw4!-6^_{p`YHbnLC
z-@X>ThX5|`F0P5tsgvJq{%UxDteNSg9Xa~)=FWX9n;4<;6zG}$K6`0;L)<~wbjt}5
z=J|8AJuneDY$fxqLB>09-T`p9dOoBs0CmqsxK(+C>jfKPqmJxuFRJ%PM^@B3udDa0
zNyrloXy+g%`}Wtyh$B^ZIcmSgSCLPr4Lim0zD)E<JWFja0Q9p^PPLR+F`Hs~opZ({
zz*eIf<c4U)wtZNxB-ZI1@JlC0^pOgvYIC7jQjPySUw>E!a<C};Hm_1``&wNQ6(Z;n
zxarB(^wfzXG$4v&RIuC3GEo*Hh%&5fTiYUtIYtCSB^3S98mCe_Kj&Ra=0kY!)PN2n
zK$6CN5f{W$@@0#M%}lznB$hp)+=nKX;0_2_XI(ryxLR&K#kw%suqoi$M<$pv2DB+;
zQQ}@D2pHj2(%&Jt2r5Z#_`oxz>=3jn!2Tt=_|b3e&M>*3JxzO3%P%UwGMX%eMEk;D
ziU?jvGEAZ;Tad=Mr;_<ITs$KFYC(TMe#cxIXid9(RidF@fK52#IS}umBn{#=Ds<t>
z{IlnOf%+<bCPOcF?)Rb*z1?Wm4mBau09IWY@M}ABVm$@!!9qFxqm?BH9}l^P<8h1t
zUgjlsT>@>(uU3dhF@7#i^H*{muG2ms09qn9T0(NFWjDt!(NQw7N78R;{p#~8oH8go
z<;hkwQ(Tj}R@{7Of&-rbr55d0se19bX>?fw56#?3p_3kJKmgn&lL%F%F4!Fw4gU}6
zqv7z&?5h5ZZJqt7e=jWXJjVrZYS3L7#2P*rLDZk!VM4kfq@CPS_Cp2AgO+g|r{S!|
zQxkqNl*&SeS843|Ku|Iikvxl|T>Ip+wr~%ZB{O#HS2O&M8y;&iV5MdGR(Vh^Aj&nK
zy&>vYvstecM8{2^-#p4?6{$NczW>Gmavk=<h}EHLzYa|8xWy9Js&tm|fT9`@r?Vl4
z(wXhfcj1qo(;(g(Zkj+YAXkg%?54Wz64w28AR3ira(?x~{;l)#&Ve(zjl|GK{JLFG
z0Tn&Rs!t>gL3z|V*5m>O6MSSN*yUakE+8*jnjU=~{R+S6I9n-%v5Z1CT~C)X6=PG6
zOGj#UhiF)+dmxYeFHa(A`}k;p<%VQuBWy-4|6E<K1@imY9|y#xWC}&_tQMLt9Wed+
zK>dhZYw_K;tYRhgPJ+F%uzGXOM-$k;r(1R`($uEqk9?m6@*;w~up{+@Ay<tTq!dbo
zT&y9s?|}z~7eF{95GEm<exTv$Q%$&R>M@25CDXFKEY;auZ)C7DL6H|Hqjo#vTpA)Y
z_3t38G#U!kgc^Jb0=oM+F<-zd>*sg`)5!GzuNopCRkT~I9D;n_>Q6JWHt+i3E4TNE
zeCuV)X)I@xwXrhaxE6EaZJ)pGQFTOQ{DNJS?`iZ$BHPrhdg<eMygGt`A$G|Mz~;K6
zyq4AEJ!X*nJDV;!LYFyNJCArA2x=v<Banz3r(=cY(qzgTthe5~V3Bq>6nVjd_*|ht
z{pid<u0l*XxP=E)P;>TOs30nz;fW8$a3g>*WVndpIOe|{Lx@0COlU?W#D782<*eX)
z<+dd4JLsKNr8bjSFdvVLN#FEkOs!6F6}~V!E#eq7u;YjIFFtI{3_Kawfqy+cXQ8Sz
zjKt)dXnPaA)v5dSY~LI~xR3O@(be5kzD6$HKL6)ehh)YoHwPP&g12@ywruUh7HY^o
z#0gA-FRT6MYt(^esdlLET$b+eVP%azP3p_jE~F+e+zE_$lbpBO#mN}YDEZZ@xo4#@
zF5|T1na(f;u-uC40cfwu+HrEh^aLnbTA#fiGPPRnrogf@9a1t!i@>^9=eT;=E1O|x
zKYti5?{1HIdf9R9aE`!@ef_c5d|&-vB;xVOP)ubIEuyI0RAwJ#5+jLxf={N&FgYa&
z8Ar#YK=d4_vKLm(f7+O4u_r#Sv!t(h7QL@ISJGw$aR~tR1C$e5kPJsbjK^|^fY|Ot
z;@E2tEj|T6$ATD{5U1m{0E(0o<I}>*d=-KaGR8Y|N9)SMI#;ng>Jd`&+WXGwxqrnh
z;i6leOvKRzEr8wd;TfIVsMGl;Df)Ty)$uK`PKG-MIqIk}y6$DE5*o(QQ6Psawkcvh
z#5PzXvhV8|<bSNRpE^7|$>MfY9yo3TnJ}2VC_UaEgJ2mctm}%?Wgi+bCmh*OR@^7q
zx+%u~DcAstGsNub`f?T<)e9uq?=wF5X9v8yaCh1>!U}ZLKF55OvlDg6k0rE8B6Gu!
zCNHiV1W*ux+#OPxd__ZpJ1w->hyXZbp!-Ld>bg3*o3t8qOC*<P)`C+i$A+Iwyimd?
zhNhX^miNH1Nm_IckjAhCe77`?^9)=cYTFkd9Iy`I3$~potLa=F#Af?X^V@w(pVi?=
zo*bot5($G!i2W{xQ@qwsUIO)mRrhkVp+0}NQr{UlgaB>dlP245HCNo4V7MqR4VGcm
zcJ~ABm6YeU_%{-Q)AQadBJvC`<++1+*1{L@QwLkvp?TxIpr7mnoySYWNYic^jt?z?
z`(Hyk?55WK%EPK8fR!H|^Q!YEfVH9W#>Zo)P1kScZB#=OQjgTL&8T7c3_a)@@#`p2
zet(zCG#Toa3DMtkP!9>6jX1Bz!{HwWnC6>rvyFu|!K3N@T^ObE@i4Md@AShyIz->N
zey5UNq}GR~47g*nUG%fx)vaa?<r@q2U+a8MCo+|AKvYA!g#>_Q*Wkhoer>;aEJd%V
zsLhJkA#NAbXQ`(=D!p|>yd4l@h2ozQ$<d;U6+d$SYqOu`jXR#W&j*GxK;y9w_|1_6
zlFK0ZJJw=knR9I1r~<(W1<2hf@XgqpfHV?CoT*5kebT?JkIuEFYviCH|L240_&#US
zH&T3-tpxuHs^5}XME@o~H3(jqCl?qIp;P&yTr2(2N4Ood!diKRaqqBLDbgaWoO99J
zm2Ew)kh1_FT(`MK9d+y@PyHZTJ?l8EpeDrDnc@%jF#~t_(W0Ui7IAHuxlKU#*HLE#
zZcRd|_p_`5vbQf+@BPqctFcWY^XAfQijo1xYV^37I>=3$t=|>L2S08lX7hiKxOzGY
zT*WSLp?-R6J1~jl>6{>fh=S9=H9#gv<rH=Y2VTJOHp^}^;ak}#Rv{TdXIpOi*(wR4
zA@j@mPJoi;2|1^UJO2f~Oz3hLM#&;%!ezlSx0HS2++e<3l<~w{&URV2N)VRlKWUsD
zd-zLph`aGrb7j??1zEy7ZIH1etB|;$N31EM=ys}(%F9|g;#H<?2}yo@wPrRWB4+%>
z32fe>sdJS}1x4Sc@Gui*q~o_*hb&rdsmr8+@nVi=nDWL<#EEU;6Nd;~Ecr5dWWFw1
z%b9%v2G52muV{A)Wy9(LcWEdctBFYcZb^3m>?6ve#)JqYdKBfGi(lZgQv3(Y_uRjR
zAlSyk`|NRTamV1oe}7p&6j9CvdRwRga`eaM>Af%<d<2J2dv<4bX))Hl1(%&bpB{VT
zKV5JYQAVCtM}qO;it%nd+}^_$Ofa8ho-2;0CSRO|{<LQ;rpLoCS1Xf3b{d@HBGBpW
zVl;qT1<aatr(WJzJJPQ`!)tCfEckRm8Fp#-_^&qi&lQYoLHZAimmvCB%d}j?VXQgv
z_7J4_RSgaj8SPBIDPm{=j!bk&X)ZcvcBxHh{AjNM9$nFmy<x#37Y||SGKt|``Wg*)
zKfX&VZ~7BTB=!UEN_|9`IE52o0+UcKJ~Qg^5DS{>b{gt9mI?G-jwAP*(4`YOU<PZO
z4h|;EA#(!h|JldEQOA5166(k<vJy6yFzqqiY*P0qtAPiJhRORRK!pH*V`nh~%~Qqd
z6J>6<Y=8+-ZV3}Qd?M1S4e^e8TBK+lXa?3_C}lzi!C+0);!#<jB|dRKc!5uD3b`yg
z<5TJ4HA$@qOiO(s!(aOGPo7WIRuvXIa}ai+Nd@Ka!3irfefI4kmIUO`TH2g}0Fr;9
z|0nw?88$-HDT)dF(<I-h3=OT%Lk!>%lRy)SrMYHlIQTm-Li4nb3tN)I%v@-<-soMJ
zbHCNXDjMoF9t&4cDt$Ryx1(6kDCO9i^z-(jz0~}RxNjICYyD0;Q$2zYx%bvAiK(5Y
z#8Qs|uc^HCEb#ygt42CGbHRf0?0gx=GZZewm?UwAgZDnTwpPeQexl=dAaVTt5;Z@v
zb;#AolkIK+Roh74tjBn1H;8U*V~nEZQ|AY-L;3|>tW`(voYSbc43x1&cU#zQ)4*0`
z)PHlHD+#Xbdgi;*r8=^!FrR*Vs3^P^ZALIYSVpSCN~d|`Kl7xjX5k7_D6lJm9|H>%
z5lg&(hZVa|`!T*lbP4;u?qQ{XMjy?Nu>c~o%=+D$-3p)wtKOx}k<Bf}(OH)qrg6#o
z|38A_9Cv+tTBurMlATxYc}wH9(TN60IBX7kk&ls}YL;oA3GD4%indjEuRA2^-s56m
z3?vU_-JCSb_9%)7J7_9*)p_m3infmK1$p9gfZ(Wn9iW3ApIu+22W)a0N&$Eq9)V8I
zT7l%>{%Vl(<uPT2Hyv#!mXQaT=byG1y2h~K*>7XB@AUDK5D$9)4)lPuCQOPJbpPDs
z=vGRvmQ6h&TI=L4R`6n*plNqYMrx0DCM){F7i|reJ6g#}%ZK8Ag^NPDC+<V+fC`$b
zeWL!|Q^-+J6h`^W&hHG&b8b=X%rT_#qw*c~m*a=iG|~~bU0@lUS^<{(S4dpiqjqk{
z_`A(w>`eFTG4Cz*yX_{`qlD={ldziQ1R--=){Yzf{CBNc^A#But&^V(Ye%4f+opK-
z!be}U8?$>h>s56FQz(n<&Wh|*%pP!>R$U!NUhnQ$Y0@k4<rI7ta5VLceDizj;5ud^
z{^jZP8zc6D-L6#>SGI^DlHk?${IMl-|0zB>l89>W34<9Y4QnNg_jhZeV-Cf%@`Wtp
z$<`7Pa0(B*J)&+GQhM65Xbk}(AB9E|Q`5BwXmMa9=&o;@%g@KF!Z?!dDjetg5CX56
zUBam#S1vO}P$GwP4Io&vpwc)O`NFUt<YMlb3$D?{g2ijTh_T8c-i}qi9<eH(w_6$-
ze#jR5*QQ+H_fiU99OHEE6fJ>ibyjP7`RLDH|3s1el)1uQO#PA*jG~}twyz;_6Z5H-
zkvxgknnQ*myPomQx_$Hm?Ruq5e&t11UIeXv2{5IYCI>kwFm<!3u$5k+V+77MkVtm<
z(hl?jWm^Tb86rK)A;F8ure0GIbr>ae`}=JqJpA_)bVl(1hRZ$VcxXlQrfvfow_t3M
z{0uOX2J5#8^Y|d{0ONK}$9wz=W{&T5+YJY7g<u=rM9e4?FrM}!wYKmeJsG}w74ihu
zeb=59xaWhvbfFJ$Z-JvXc3i%a_}5pd5@9hB-CpH4GCgnqhAhW|Q}n-*{){BHm@gvv
zNE%Rigpv=Lx;)TtORBuKj-?DeL9~n|(gJnK#LEZZXd&&Af3&`+O=j7?s6ap3R-wKg
zGqQGlB(4F|%_3W@1|x~vsHDL|EUDR7FfyW$1w&bb<5Bkyb=L@1u2CFsb5|pTS1cto
zKBk7nH|*+NOF2<Bg{B2NGXdytl{G&_@2<}6jYr@A<jS@@(8A3Zbj3`RzC~nk2-Fgv
ztp>+Yyh4$L1Lgy9Wsmu0datgQCZ-rdP^55yNTIXrw@+*iAVU`@v;|Nh??}8a3_6iq
zp(tib9Sq1x(&~&!o2VxZ;vbmsp)RdR>rYJ1a1FdS%?X<08j?-ZM}@8lNogom_}N*r
zjV4q^KG(qmmL9d#agfP8(B9J2S?y7eN9jV68p@Yw9qm1$9y0zD90fRLYk&`Ct=rFQ
zMHT?MGe3@l!O!N)VZ$Lt^RzJ%i%+S?Z!R@;87|hBFb9;Y`tFwt&-_uPFIctdRZ#K=
zcROSM++r#4%tztYN~A??GU7OIO~AR{cHJSjL}6-s`rv&3>4dyAt>F?@OYnix|C7|j
zQ@59dZ*IuXlyk;xxw?7^q=TsicBygLM10_wHI%Ul5(OZ7|GsRSVWXa$?G(biU<<#)
zM-AOwmd7+hrzSj5hwW+FvKb9!297QLkg>-3vH;ui^UW$)+)~Iv=JUkuJMZ$hr~_b@
z%45%+=pK#WNoT(O$}4ey6e@!;t<?F&XpE7S<IDEzlkhW3ORIt9Pr5&4uNdsc{En^i
z(COvcd&G~QeJ-CC)R3!yNrkBk=b2BNHM8U5{qu{TNa0P$McwuW18yyRpdDT1c|dS!
z?9b$WE0)9H(?Uwb#zo&pz%=*QzSSc3Mc?+#VUsDLM8pjlZ~BlI!h(AsAuGC5waJ9e
z0)%ZaI_0O#_}oxmvvW1;-^G`9zG3)cX=m`RWOC|UX?_E2>>=6XOJW#UAlkn@6ofg_
zUJfLQ77j~e?`HIX%#@io?>4`Df)y3z1Fb2-07qmd)F^)dKT+L#Ey7vh?v))!BY0w*
zGvKsMRJkhAeT9kInrKf2%%`EthU8_wbGiQ7mq>9DgvQ4%PqCt!Nr<FIj9nJkZ=>mH
zE~*z3Pux_f49SfuCZ#fPpe6FB!x*e}@L8XLROR@QCh+Wew(fN#*IC`W`0en@fD_y-
zczMEFm3D1@d{<2sQ+Ns3kSA%6-!o@yVV5rqOCp|6krCRJl2I^Gk~kE};sga>^l@<O
zkYSrfMXmM|Ee+_VrHNr=A-*#z0ySet@{M3{<$WUz0#vEvaG5RuZxwkL!wk!g{AMQX
zQRrafTr5JtvMQb?D3N_tjie)Fa1kH-C|eS)bW0mcv!z-zFpGG&d%w0!C`o7Ofk#`U
zqACc?MF|eb<{)9ASE-Cic$^I0=<)UmKyj|e&Vxp<_!JQNozC9-z7?&sr7d(DL|2gS
zTWvE^n$V>-Rw22|uQeavTkqliTtsOFOi$=yeaDwuL@&YUrQJCkC~1)_H59j6@NoVf
z)xa~`U>F0YP4JsR_TV*MMBE`NpLIYf`!Bi(_7KeTxI&K(qY+A($c&bHs5gtxBAvW7
z(AzFk*1RZYrV1QG!@$!cv|NMOP?0{`C=`&q%88Kd<WeX&wE;FptH)xBh)bsoZUE%X
zT_?UE<)R)+vi9G_opXp{MdUEh1SkBT=!<MDDj8AbzEB6FGn_%?yW5gEBdS$nP{N8W
zXAzZct+AJ~cpfc57_JF_27Hxdp*aM`7q+ui6`(8N(L9Q-zfb$9=GIGHhS_;iUNAb=
zasInRhj(g8Gs|tfp?rVdtO`e;IJfJic{>`9SIDAtlIqk38>g@$&+yeN0O#qiI{vNf
zjIk5NNhbJ0e<)MO@HPethgsfb;iY(%C@+-zRR_chSyNVu`nzx-X0Le3&0oO>ECOF;
zUNp3kjfO?m--B)s7NMD0E@nM>ewqQ&Syg=o*o6|F=1gW5q|S^%P9D$Vpi%9swu!H&
zaUhYFYN%+z4mHmi50yYS_5+ei$n#ZnOYt;53Auwqg_&&jfLdg)`ZRPLd>bIY$mz6W
zt`?kgP5RWEQTf*Rc^HJVn7;sHX+~z&fNT|Bnb1rt3v##H{xEo>Aa8|C-TIW%$?Tn6
znN+mUdGcxgdl~5h5|2y;=mUpmVJyr}dp+z9l=^cUJjo;1m#R^U0Q{a)8Q5;V>!jE?
zPr`V_24Qg$Fi_ZEOb?z06WUSk15BWEWT!mew5qlTyBvv;bKB)i=*ps?;<y||FiBmm
zj*FHD$8N}7r+Hsn*tWT1V>EWdw<d|KGIe3~Eh<c%^+mDhMA?zirhb>Jm$Fv)XDxKj
zHJ|kuk`uOs$cVMa^GmRWKNf|flF>@GPCouln{Av+x21>SbHdmk4k|GnvBw@bX%V1e
zQ<V)nn2bJ=^HO^X%DP0u+G6<48beQYjsyCCr;gK56HOlATnWLGhi_kjG52elx-p8m
z!Fqa@6adU$W3G7Dn`L-lieop4<9R6Sdd0u@H;2&`grquOysKP$ta@^!iQ~t=)p#z4
zXsHz5?C;ZWMvyH%U`WJq_EwM|viY6~(^%ON(6fhs#?2~2e(%`ktQe-Tw8qmEUD6G>
zo~;IH?iWZ21V6j#bpKIN&wZ4V4ujuH;g<w1fN_&$(ub<z(N`lyd!_yWEkTNA`~5bK
zq4=#)X%_Hl86<UJea%+k*s9ao{33zd5zeicw=&<T`h(B3kXSTOkCPI69t~Gd_|RQ0
z$`PyQba_p<hT6c9+1yzFhFbVR)u?yiZFKR$T+d$0cQQ3a@1lP7mecTidD#@hlDI$q
znu>Qe>E$lr`|ulMwR^yNaG%^Vcaf>p(j~A5aaoGLQmNf-ogB1zUiG|+AX?~R^9ue7
z)7U2y<Qv<gk0N<S>}3b`Ixg){Vac++zU-VNYo{sd`~c81gm%~$c_jaDs=(SPYvKV_
zDpoV!x2^Aha3A?<yI*<#TaAqO?Rj0===ew~aucZI=o1-r4j7R%_30U<`<)zv^`bIi
z^Of%uNdOTj;X+NoZIf@LE}D^h4UiwrR;ufeY9i_1G^y4>v2d$R&@=6x$IDS)mLJ*N
zwz**C=nH28O)NBXJDe`-^3`zW=L2cmn;~J%4N6YE8WhGJXAW9}b07`KT~@$k&NEO^
zyoh?KI#u(42Bja){S*PQ=HcdBcGWd-nmcCvLPKeoZpK$&p;C(L(WZ?W2DiTeeduap
zD2LNqZ?;<@is-<K_qIGLu>Lk6vo+gV6>Bm70d%vc#T_CBBfEi=#cfVkam{B)YwOyL
z;gmR_3Vb31G8oN{sRxp+V10y+O+o*PqQ+r2v%s~B0}qPyUM9m6e)Mz;!FHDqjJ6MA
zzRuDL-XE6>S{l+@>S@Fr<9VqHjEAi<<x>9T?b+noR6a0LVBQ;vHWauAu*8IcTf#o5
z%3#rG8lDw+FPs!dzHZSF?;y1T?36=zAEtF=8fvC0-o6{_Vn+%G5C^Z^%uDf4X60G9
z$C4u3R?kch=F8lurh0GNi}SRoTbMAj!hE2w7I^Bnn+d5rzU_zpuwj!gX|@3j;<d}(
z1`z{E07a8CT)#j2j2TP-t%pABXF(L`6v)kYhiC*1UaB9amM^<dzi1CQdVxsU-v_la
zJT1ZcxKX$yIS0ZsATweg;C})7L`+Bjy18i>ju*rayg$Dl9Pk$67Y#o5=_N*{v3~)8
zUXqP2=|ml(Fyq0WG^qpkRWZO?k{m03B+L?!Ps!ZWl0hCg{l&@W+*b{wUxF^zVx6c1
z++tNlVY)A{V@*JvBJU(3sAP2Obw%b#x#3j^$vt;+8FtElcagIGq-(I479v9vv~hA{
zz(+({vj=e0)Hla(%R74JL^tHWCWBy6+zA)md<?neV6Ur^bs0lVmI|A_`p#<*oD87g
z^)mHU%_K@jm3*fpF{uDn`AG=Vc3Au<1H4E?v(>gxE;3f?2WLZ6ce^V10n6X|x-tQS
zP6v)yr+0D8QE1$G_Xq)zH#xWQ^!GLTYpG?{vF{3lcU+Y-Ro9Gy^W?ZLvT#4gl3X)p
zVOj}HGoLdy!HwApku5V$&S$XDQkG0DTzc{7*{Zv%2V~p0&y78bv8QS+!YP68WBFLc
z>!B_&$^bd0SmgLx$4G|bCnjZWD}S-70sPFTXG{PLz}}=k1zZ+mxW#))xXI^AVuu!0
z4po;!e~Txne3rbp<zy#TuF)Mi%Gs!s8DnsvHca`gFJ2Bicd+~FZXM%C=k{Wgc-PxY
z=0Ir%CR*%PUX&AZFWzy0bWuEaGRba0+kEOnFVJir=30HVHOyV<84J9j7fBc&YTzps
zVF2wt2`$(cb`_T&`uw42E>WbKL!uGJ0L?NPpPCcCG`kUl*w##&pTJmOyk1ntPh)+(
zrzYj+&QRI{l?PiBKFn=ENQ@4mD=jlbvQc(Lzj{Z4P4(rL{c8v_+H(}BvVbq;+z$NR
zVw?34Xg^t`u`{cxVGswL6a3P|L@J{&+54VW`G@*82HrvZ{MSni_sWN1(ZPA(!R6zR
z%#mF8%#Ug66o&?%yYFDdYzlSZL>!@G{u<{+%4JebDabAhrJoDBst6ICrzyT^{%n|E
z(nEFfKG0|#=lsHm2fT(`J>W`_v;qr$pz`t?#LNl#k;YXQa;iJZ@jLWR)0j?U0ICt+
z=1$(|s^b&?B%)?NtySCoynGw&bX0+6>S*bP`EUbU?I0)HcbOR{tHY<~_Z$rr7tGZP
zZLP5|6@DO3#0a)=l6H|XYDwR^(w@7(e<J$Q+#{w!bN4yuQ3GXh-hkC)gX>O`0^Vgr
zUX8l~Jb=qDyVlb_4c1htV_7Z>(o;dnY?SZ*K?ije)#F)}0*blGCk5AqCsKeHnu?}p
zka%%<GwQMA(rZKbm(rPx6mvIXgGUjJV=RZ<&Kq@Isp9uF^>b<Jo(6mESEMliPQqbu
zr?b0Ggsk!egIu!pO8vl)cWzc_0(CRABWvz@73#S|lnU%88n0{KGy16}&?IQC+S=FB
z%d^^9ydoOc<U7{0KulA7KbFSZN+#4}R;WX_2&a)|M_{))QQ7iY4g(U@5rYGK)ooq*
zFx<@w6c|4p<^CrGjMUu3fM8p|8=)iYhO4_7(&V~fA=+?t6)%y?eZlMlMwE6z_z^EL
z3KC=|RO0iBgA4JmlI6PjTdQ)5o}nr4c?SuQa^|RkU}EWiTBPNRsS(7LN9O23P^VN<
zo0w0%e^5H?*3TXUy%a_rSFwSn$`Iyf0>nW!&oy_&b%;0s$XNy+umHp4Yzq?;EQ&$)
z0}jH8Dir2X`nU*of@xq34i)Ty1uFwe{0zkxw}-n6?qJzUj$jv{AG#;jkC;<G9TYrI
zGjDV%i;|m+M|a!vmLwPm;xPrvtzhx7-^4KE=Ey7@{%&`Hmd+c(`6i^Xu(sAk@m5!#
zJX4~w`VXx)4I~1b@x4u9*Um{whl)$)VO6oyopn2sAVtg&qDw5Jy4S32pyj2*Y<XDs
zUv~JQol|)izx*is$;-1Ul}a{Yd@n^o*|PLhhAM{9Zeidvvicw?%O!d;28Yz)yJ;9~
z%-{r~_vG7^=g{g3M3#tp?S<2`5LWAICO$iP$2>S^SP#3L?%;eTyr~R0E*o7g3F8Kq
zP(6QDE^^!Bsa)xi!Qmm@a|Chu-v*m*EW~zhH|X^qi3k_#miH89J;fN?uHhP?UO4i;
z3xkUG*!(=ck^l*)>u?vPbB;~*u|m}QFE+#8aEN?Y0^^k9{lz9+CSv0Yymf$6AP8%K
zhFYy;01k()58AGpFsa{;3GNzm84o#QgA3h#PMC|efkdaR;}v|Pz-_%*D3Ae={VsMo
z3qqdBjRVC2!NoN76fZsJ@J<UJEULyvVZt4z%LF4fj~o115A7r7d;Qwd8*ZK(2AMnl
zy6Zi+<W{3S3I6xL6hs$O^@sp4TWKRFI-6ZlQv*?h-#mV8lUD0iTh2F_E&+(cw8F@{
zyw4&xTAmNq9z64l1Uw%A>O-j{*mzN_RRTam3_<LXPBw1(R%?i6t{3(rxuWF$oLU}X
zG=<I0EV2u^NI$?!>fZBbj!P3S`4`qGi|#ay)MM~(4+!75+Oz!o^3FQ|UxWsT4ypez
zHa>gbdCVAk@m|Lmn7pPeKprX!IGbWQO`iPH$O&}K)P!eUj@_hNE~udLEjzspr<W_B
z>^%D^!$yBA-nge708aIFAurJs0`^`CPmIykY*KS~V+Jbbeb`_+3{ioG2^1H6{wjOe
zZ0+$1p=u*5?)*#qES~lss#9`sz;#o(0BQdVl?=X|GkBYK@n}zQAu~F;ZRGPK+LZ_W
zL^f`SwL)q&^uAH40(Ibm@{VQ=+u4Zh_W|3Gm@<$9L~MQ&R#9CW3v%VnQl+^iGVCS^
zT{G4ia`Z0zYI?YHPInLi7mbwnGm8Vai9a$)`A#=KJ$+a{j!hwV+t{%j8=clm0i_We
zY>rh+t-LvSTGjfe6@8%g=0MD#-u7u))C{YYzf+U$K$--YSU8Yo{W0K5npV4I)C1>g
zDy&Hs(c<ClUp`bux_1Y!e!>1@>PRjCtS2>TwSN_Mp?%$bnoBH!#`3vUST<n3&}a1e
z95_==wCFMV(NTE+Lt7~9_O0*3+(u_>roS{>Em!|`l>5|5-O?qqO@`@<Nzu_8F9SCG
zzo=^q%0?-#`I&(RbEJlYwXXmnK;FMaNK}Tmg5FCnpw7&5K|3hKIA;GaE-8KDjW=#f
z$g8w~$G7TUKu%Y=JiYgEG&ZMaD%^nzLRZ7pEW_t)LTbOsIt#XHD)Jzi0D?0sZALOS
zP(`H_kI*L;*cdyJL&tqoW_enpy(ZxfX-dXu#b;FWW&>H}$+5;XjeM<`CVx771wB%c
ziJIPs_+X@2AAp4NN@Ts{bk9dkzIH1&t+IfGOXBXD*e8*Nav;*B9=P;o0r4%RqTBMC
ztLJt^U)Pgxhe;^?J7-R^Y|$aa0aDCrMyFj`{;%3b53oC-3(H63o9q*bAtX91Wcfrr
z->bJNe;*%D+b5*SJPexRFDsc@>-^zhyDt9G$Sh(MDhhuMTqbs2Ugt9IK4+ES++dLr
zglKBPjgig|Og*`7(qFUWG=BFWz1x0RAghQSGtM-`!kKvb15p$P=|Jm9ONp<<&WyUH
zVi1uMr7*QTTfsg;@mJOn?O6hz_Q)<3B?egq7~q{K&WUWcHlHp3XkN_#g%R8sFRw(E
z0dY)c%ZltD|Mu-h@xdDElMz~!O_$~0Z46fU<~_!lk<m;RYDFAN_k)$BUq=KUx6QVB
z?l&4O!gTnrt)Im1?lz!GnYbgin4fAn4<W<BJKL>cO;|Y%K>4vwXT*JivCAyWh%-83
z{vxEpq{WBV#s6U>FbQ0?li_v6OzUfp*<cadXZVX-=~*DKXv7iE3v=su++7l9J#r)c
z3Gjp0JxPp8wpsrHRDy~1t4PYJ)jq&}JsbhUrm&31_b}3ac#s(XN>=2|CH}sh=t1)o
z`*4m=1WH-Y-4Y7Yspx<MjJX@-;MzZ;D10nzth~S~3yp`mMCKW_C1u4GNGOm)76Z~`
z)@H}UOgI<+@OCvhS`)gsdG&_X)+B*6PZl8M5WB@3DFsLmi#hY@ce2~I&7sxgF22Fv
zVADkr_AuO6TSYjQH>NTbe%8l*Ve6(e<;j6%KT{^DzbS}A7Q3nP-+{vyosSs(w*(E;
z6ipvHmnntSCOd$&q_*iUnuO*zz6=e%O?kP0PmKOfmgneT*u$lspck8dtFB(7M|kyg
zM_YHPwQ`Ohbhy$x+`_bMHn?MpyQzgTuNv0$OULYMr<DIXG-?1^OwtYE<8vua15Vp2
zUJM|b27sTPK+Q%lc_h}HfW!R|PS)_KTXHeITZK481;Km`8Cg4^gM4$*r=Uc_t96A5
zkujjLA#r8VmL`$e6UonxtuwOy!|!59uHE8Cex2VCLqD!pwvMNNP*mD%gW7wyCALQa
z*pn|};1;Mo_KtHwo5a<&$U7AbZ+QWWFwHod31FE)^_G@Tq3O1I?<=Ya$_=hTHd<DM
z3q3l>Tmy2@IU$AS!U_C~Hx>MA^i9UkrO@TMh9)DC18H_aYymmpVME5#P~nwnTKUy9
z#K}l&jN`dig(=@iy=_<^4wD%74VPnKDHnEqFol`AH0=qP706Uu5b9q8ev!bQf^Z)0
z3_6_>c`aRjSaur%c>3zgL=$L>L7Cm`1ZVMkij%-k^@-0VQ4`)>@XmI0o&KyFmPA^q
zSZ@e~eYR_0MDY0RI)X}~e75XU`4KVT1Ch|RVDhL8)^gLt$!fC<%-2rv=~XBr38x(P
zi*})y<Ch~i2>qB!>-1FWPm=L*k_$JEYxNcDOugKV{q473?nxU!re=eV+Xek5Mcz5;
zuLR*Q)9e!x-=|+ea|K525(uOj7FChJz#e>IsJe4fy)}-ZWiis|NA>?M8{}A9)P97Y
zLjXkya4m>(G2YUN9bB$7%_PK!pXF7&!fv%j(Z35jLEtTLG~(rdk>TxM9Ky3U*W9v;
z3Rj($(Kzd|&S-S&hkSWiX8^Gh@8`lyjwv5UT3M%&Kx)m~?0^#lId!~Q;I3<NO2PpQ
zJIu~0s=_Z8>Q!eWq%zOD(mhl%8iEO7(Tw+67pch-Uk9og%&o53&ku7%NFYFsji3-}
z-E7v=`Db(_0Y27&VbzCe0{mpunB%UM`?8DBL80d}T7_`k1<`u}&i6D*XI#f@S%mA?
zR*+-#^U6$^=%3rf%*P+}f$ctTpa>@xQ)W?8B|H@Jr?DoSSy{@3HBf8XA7Q^to&)C4
zNx4p(c<qnjpU9}yOXbF^i<E>GNDaGzHbDjpBoZ(6NUr<MK*SF@#2_Lw9+_m+MC$Xb
zbSD)yaWILops<E|j^%E+HGH5^Zg1FeLVl~F_MJ$zc_sW={Dbjuld$S_YdQf}))sqT
z?`980IQ|_^+3~1Jeu(3ct;NfbX(JY6SG^LjHxWZ{U-qt|khoCWCh_&dDD4_29<%bg
zrz>$aXWu<{GsTB(4#+-Mo}&ye2C7-%TycL?Rzq)Wx)tPUr|VDu+d*tC89h$Zc-p1o
zTL5NGp7Ou@siFnat?25rYG9p@_&!3OanBLfu`;(O0(sZcq*yP@C}Y6j*Yz$~=p#wF
z)NOaXHEFi<FgWq7cg24W7EGW~x9JaA!7v!uxpI_taW$-52c$O^a$sb`iArgnh5T#S
z6ST|xHlyG&9KLmcj9}_G3@M!0vf7|#*66cYrF*{{kb&QKe^W)+ob`<oimyp+t|B7P
z5CG5$QO2hEMRk_}k8hMxo<5IY_<8S;yU!YeQH~8HwtmSlH~SiPkw>xmu)(xQ2{Uhd
zmw=_~xmSindZiskB{mf&4=$9gHa<UNR0Kq>)hs)6gNPG1D7~lD=|{Mx%7RG*RrJ_;
zaa9qUTD=AeQKB9%CYVk?$)+;&#v9L6SG38wZK5q&B9b|U>ZYEe`dk{TYU{0#`3IIQ
z#p`Y<S<SqR18=5Mr$^31HdcX&tC9j+@c%3J)K4ldh(_1g+iB?^)h+}7V+K<4Vm`Hx
zx=tCiiAj8MPjetO2YGs~44FP}a4;A_(CUu!03mR67jcXWJ|yxq7(kW+#8Ua6^4f*Z
z=NMI0SLKojTz6d<Hi5xsF}wH6uEAa&n!-II2T$xXuk#s~Uk<U=b!je%janv0Wv(gz
z`px=3d!X$gKvLdxg-WcC7XiLLswH4qx5kagGcXrVuCy^w4w(R9V;XXB=vmuiC44SF
zaZ++UDfpbq=RaMx$#TqMjc48&`ZQ|b(2ntcvMM;tF@Ds<&N~^7R=3RAlxc+(-OSNT
zG%HlYfG2E9YP=HNAhMyMI+GDbPBgj}tKbkW3c#*VrR>i{fY{2ZW5C`1nXK_=?$^-w
zrsD4N!_W5AC3P9mb5R-skc{O?TFk*yy^+#V{>rp>O_I^Cd=K3pz_8u_0Ffs6qf|*G
z^sNf7a!KS@sXKjx{?+^YgMTGC#hiSc!`fQk;ri_b34O}9jJUo~ED+&@*kkl~xMY9%
z?=bo+fY{s}m)=@$+A;E<2J3U$XEcy&t{XFCEESwSpp$T(mNplTM$~+wkwrd?_r=hG
ztd%yjLGj9=JAkqW4GcJG6tsWcT;jEke6EWggg1<o^7PUX0*~+{WLRqBePaUl{fDKn
zxJg^)9VX);{@C(OZhc>;aOzqEiOkR@<|8z=GKIB?hI&AQnRIQ@Eu&HB5Li?CN>aN5
z1nn_B@k%t2)D<epl$zGA)dkqs1Du2W<!5jcTf7xki9W%&P8I0Pl|mBi4IFtW5xjT1
z2S&}GyOtt5p!~5)=5b6rCyf6fDMK0?j<BruZvjFzakmT4Z&W71w6fsmQU}+4;`<CB
zfdqP$dNQh+dlRdJ3C5Y+Dm}1xLdl=Vc^Y6ajl?S|`0lC)-*ADSi27=vR=yeKy#3kl
zdx8aIoq~r5Y}IE_t!}ICI-*0Js#GT*$YCh8*iK^bl|Y>vIMk~=vpMd%icc-!pFtfl
zI7R)^M+e%VZZr8Qv{SXB^RmZT(sgu4K)WBsbZD<C$C1~`BD4=PU7JJS(`qG`WFV|@
zN3C){6VH^%3ao-{0%PGF!Ud*7HT*4tCz_r$7Nozj9R7zSEY$9g11jSwB0z5{qF<;z
z-Y?uO3C_YzpjzL+J4We4Ix9KRH%XEi2(~DGC)gaW&c3$-BLM%zkv`Y#6qrLKI3;?1
zrF>;?2pYq|*`b`_4@5z4>08b7y$y)K2=#AnNvS@psS4-I$!);WTV6a(6WsqKEct<*
zUXpC{;!8u7C9=I7m+<`Vz2UI0^2FFZNki}<1!imbRVx3LSYzaO*{oc#EBQk)Jc9f_
z9x1G_XxeyYDk5b^W7Ub@1X!qDxv84xNuUMjaN3fIA$%uCpNA1K!b*<_i|zf=$Qu{N
zD3%En;OF@EI}QXS5C#0{CGBu#(N@zj2S6~A?A~G&;{VfJO(yCLLjztX6%Qi6<QZcK
znNJ8#KC$uoU38uZ@=i2(|J6w#Kl>xc`@s${Q9UTDKAY7+j4sj*yi-7n5A8v}RjW%y
z_DrKpzGZmJ-VO$^V8$Rgx*QJcL7MS}XZx3UFlFcgRFi>{-A|muu~xc|GxUbU#s|&>
z<{!?q3PWy1L2|)9uWzig0q*SO5yr7fj2+7X;9FaTbdH9(CiJ2a$C`6F3gN>uJlLos
zL;9Uwl0rDmb;{C{A#+yRRbveBR8;gwRixOaVE=2i0@pr<tckGcap%tHMTNfR6z9SP
zG}<XE`~+7;ItxDwA5wXn+0lb56)?{SUsDRv*^GS8ks4hxQBhcH4v?fD5DCEQ>qjs3
zPR+U{i4D|nymC;*Cu;Z5Dp;!%s8y}e%6I^NloOVA6SDGI%Ngqq)A_SQ7sIHyAUu;*
zw!TW`)p<#%oN;Lko84P(o9o6Bi#${-%~MG|tyR0@uoCY(aD*{2geEE5VrdkTV{-+*
zvNwb>TLb23=>hup7=nO6c(m1~7KH1|zNY<<rrU_OA>gpX$7ZhAi7poqgO52;=dXkn
z;YaE9YmX1n3GkpFEOX_g40-TSO(!0hUdD!<wvj9(^TqgHwh%y84D+BDZ;+}61}5mV
zFl|qsqT<T==6qz5nc;D7>MBQch|*jwe(TJjVh9|uVHbDe6Fm1Kz56<@C931p3QbrX
z1H*k5p?4giB*vKC#sA1pu%Qcs6IOo$>x=s}f*L!US)n^=81;0|Xw_}~_z#Y!M|W<R
z5eOtZ<E56fdl_yh|Buk1T`r8R-v8WIY-OcTr<|X(xYfCWwxXZlXg`+|INnm9Donom
z8K}{b%0DX|RRK1(1p!X-!QKT3uiQB_;&Fm87bNS;%y=ByxQ5Y3?_rbPnAhiTZga{U
zhU1!=;UvqdXJP-GDoAAMIw{1CI`DLBEdbtU9YZWOXXUz@P`duGqkpj;w_l@gU%01s
zbgqj!eyX0kncq?mIew!<g~vO>U+<SrxfABDO&4&#qd&tCE|oP?{3BpyinqWa{V#>h
z_Wn4It~WM*`XiXmJLYo4H++9S%?CM`^Z_KKUp0nI$MvZ^;0FQ&;pR)7ax$q#U|2cZ
zP$>H?cLLx+b`0oW9jFDtrxq;sOypu_UbCR9VZFpJS#e#L4<g`g%TpA;l$R9Yf`5+g
z)iM6rEjA_%jo-G7k7y-)%9m}R7VIG32An+eSIZYp1}MsP7xWixus#!EVO#ld&njT!
zby#=tn45vd%Zu(VR&l{(z>It9CUwcT*q*1DlxuVX<~I4J7S1zf4M`0m!=bg_3OReY
zdZ&N!4*G9jK|{zt_Zs&cOs`QRCWUi;JgqYV4S`s`EC@P**)W>Vh7yr%xHUnQdyPIR
z@kabnYksh^(iEpFn|+`YlI<x{tleF<!QbL2T+Oq@6?%|h-uvn>PbfT>^mq>p%OgHC
zX5;VPGvGKzuqvB~=h&qOQ_^Te%HC-CSE}BAlxt?T_b7KKxW%oTnLF}I#Hp?};(!a&
z*cM}tWOgKVF^>&A0@u%@3JiHQ5^Vl@cI<saevj{J;Ppz`(r2E<Os|Zd7Vm#1gOeO;
z-gicfC$n$rbo&&9dG&jY*M&K7G-n4-URyydS>1GgB3{jlSq-&J5EE1ul<!Egl`M$o
zD02-`Z`JnbHz2nX=Ps?O%#WQ|l6~HD{K!cl%>Nb{01~9xrgdD9bjv&usPMh(Vq8_9
zx4+K54Wlf17SqI<9zwj%oo9GwKi#X8czRzr*dSEjT((Ae!B~fhkSH}-wzE&36e#_8
z#M4c2Cp-N;Uhdiy`LDpM2q!MMi*C(Ol^O_n+FjU1nH~&G1r(ZKqZ8NO+ZtEtPzrK-
z0yZTWn%3aXJw9Ee97y92W)?doMZrNt{?wVrcvyd!n}~D*B8S)G1x6Te_k<&hNpwmx
zoF_|OwVxgFlYG|kRd!UcLH)h2+S!g^{gQH1^vOXpokVOrp5j_-q3*k1cm#a$OM37@
zp+yk-SBsjKpJ0A>Rebw|N#AjfHrgV+Fufw!s>5Z1Tdb^)ZA{6<<YQjK1~P3+_UfTx
z6n+Y-O*X)K>!SZ)1>?K{#OIV$<+yN1W6=a{z+WdR>GE!-vnP0DRYLFuE)!pwwsVZx
zSBCP#Cur-<k;Sw0f*v4P?H<V|`1gpmQY+v{kA%vb179j>9dV)v4I1}bkr5o>QoaBv
z9a8I~0aiTj%8$zyP(wF^!P>oR4HfZJvFmcXTD(=$IQP7C1Mh;)cK*7e;YFYx33bz;
zwKNu=5s?V5;+joq5OC_%D+-7o>2SEvC%nvS$z1n`tsxHAIEmO^_!-6^LW`Um)%nPM
z5}W+cnA~RtRB*Do)#_qfR2gkcYi>2XB3wwy-apT+c<%WiRIEiLefEzSlnoX%F#KO7
zxKHkjE;)V@Sqw^EFV~%cWgqt&U`X$<d7#8}tIL$1SYguAlAW(Bi4dm=eY>=aC>bDD
zL>}4^Xb{}AD|AvRQ8|V9eRiOfuJVNw+jLe>y-SgP!sa*E?ZvETsdAc{Z6RI*Cfm!)
zaEF5yi{2mTv_VT|7VF!vJoRwjd4i&p#B@0L5YtL0Yo4kQ|K~IP3!<o^`ycWC2%~yN
z5oBm*>cj%QacVEV(5Veb@HZrpEG|a|WUVVpE-VP{B%hjDN%Vz?1yCJVk+<|eO6o3H
zQPAq|jK6dvwopf2(|U+&U*=~TBWp-~1e)mG&!^k&gU!*~7|BR3rsh*XqM%vRba*2l
z{mN60{9T?N5I?v)fE<Q8-^sotY=9EhzJO%~P|;o14tEVALd-&ZT=b4KaiIuVMa3*z
zAaEXI-|;>j3K`whio@fb!@=NFuR`1n4~EJubSObQ>yyj7*X_x>lD%b`E|I(AGiYaP
zPJ5m#WiIn5X^623hy=QU+*^hjy|fM#DslBqu!8W8tn>lI0#s4jIb>sXYbSO8Jh6=i
z)=1{J7w~H_5Vv)*9(-fz6y$l2VXMgw$(Rgk<wPp4p0xH3+>ad648XmPlSyA3j4i6g
z)oY!&;*T>mZZNuJf`bERuXV%%gKcC$bxH3H>2`fVb?P7aTX%N~-^ILqC|&0_h`80J
zDRM&WUF@}K)e56;MD_7~qux5lrt^m(mtGPqq0K(=qsWR5<b{dL&u<r$;fMS_ZeZXn
z6(j?1`FG}s*>5OuoDk>`U?1yaSfKmsL5Ce|Sk*rAr<Q);Dla=SqHy~8Q$Op>Rr{bK
zn^b+qCNr2G&)ET%>@O!1g}RPb6WW+tSWLCc{7Gc4(Es^L!aZo%PAOhN@az)Mbdnt`
zWQC~VuB_2$iD&W96JX=`|3hR{OvxVJeTe?GHZ>8l<8+eJ2<by;2zvP^=rHG-wn4r9
z76^$w_~*g`H1wUj?HD}ita2Ake~MA$uR}I7LuJ_(<(Y$6(jQYvSfph^e(weMmX0yj
zV1wIo6rIpr#;vcw5^-&U=?_%T`+{S0Pa>=G3_fP7>P>h4xVQxmdIGSvvz&60-F&rX
zn;7TgKm`^u$%MkNaw2Bnnla3q46T;7Z8l3?RP7udV?URseq!v0Uo!FB%mpB>B_owe
zJ`5L^;hU4X?vDD6410cQN14klmtStuB%eJ+$2&ft@B(GI1!E9yGyKRi9gS>;jlo5^
zo68I^RXjUU&E^QD<0jTCilmG_lLxL!l~?FDw9QpyfTInb1O10(+1wNgy;O~8Z^7|=
zuX)WcbV?)ms!57XMKj7CGD%Z%Q;#34BAJ_qIi}(sKbV|b9jOyebbBx)s<0C>J)EYW
zhuZJkEB7w1!H9;E8I7#W<3)igl5jOdK7Kn?9F}ng{n%EyRbJ5ah3XbD*?OG}N{I3N
zZK(j{=|uSrQ4>iJZkH&bqhGiFpkB#JqrBxAMk%c;0tGc5Pky#fcYu?}dlMVj>r%mW
zsf%F@V&c&#?Md&{nmVrN*9s+Rr7lsu7A1bK&JEc0Yv0}nNdRwvqK}yYz(mITdtmIS
z0NW1|Wq$^=+|;XPb}F2CvZp+Y{bCpu{1GDf8EHvDv(Vt@;YAq;wrqNhfj$H!_7ngB
zzd0o~VI{+Adsrd(ZVB(rX=QLV*uzb8^$bP#$}p?-E|Ib;CT?Qzklds^Gx|()1lF8z
z`povJM9xdaOL9diA<M2j7gtc5=+-gb9l(JIo6B4-$?_y8+YN#anP>W~?IxYuFS<kA
z64Mqz+#a+S3NKJ+kGcT9p99cYDsqtXGokTw^YE<i1DP9wCYr~UHrXM<U}tNd*=3#q
zX1#kML#D%{Ast-)KbS>EJXTF;x=rkGsedi|L)IijCZz>sTM5pmm~YcvCC};T8CRxt
z`G{=znqQ8_-2S;wjo&Z+Wi6Gxi<7iqgfvVJ1`+eHAB)sc%8UtD6DN{m;cEfA;`Gw8
zA`eGK0K1b_a*GR*eidmt6}2Ft6Tb^aJT>qARsa~M1e217e({zYgh|*uIm?@*K?kZX
z;V*O%zWXL8;T(>*3!!Q4SVgmv$O0<iX)$RWnZ@>r$@+-seIWk2KZHY#mjMB^NMVV*
zMzq(2jNdGKJ#y0c$as)KX#b1d9E2(EU!8AK!KOD;pOXs4_FiYC%nnr8(+5t=(;<}V
zQ<-EE-zj4`>$o(oq?WD%q8J^4M|T8q=an_zs(=H^3qqHn{R!%g#{$-v|BpQ#-RxS=
zbP9#j`NHO<?sxByYgTE~e2`nEy_H=kmM|MzHuijN)VH>Z5%eWo$n*@SKWeR3UCWk`
zR)djZcnIaZ<J0*bg^%$o>hr@b-1YQVKS*~N4ihQ24O%I4VDMl7SEKt9*$GmN&WU%k
z1Nz+>gdYPFFS8|&Hsf)8uFbcr0wK^`S9RM1yYlwP5v}Ndi3rS5aMI^>VgD<;zPXj5
zn-CvPr6a&n2jEqIYKWK%=g@zvZ$Z|o$1e;@SPXm$9<^j2)9n!?LOIXtpe#f~8u=(D
zHn|MAJJAU)XVFt@p5J&Y<%$NVNG!*2&ecTFp-%5TY`<WRkp)Gy<weo`G!U!Ps6L~S
z<pCkJ=e5zGh25msq>9oFj<MVz8v<~YmR#{kqvp1y6z3FZxJGs%oK>Q-aHa+({%4NY
z5eJgW3-TQw4x<p(wy>k6?L_ENkNJ|H@<y_#IDiRKA|}qkri5fsbLla`R?Q`E+^3)U
z4nHcdBde?c^SKL-9XJ}Vko&hL`)WT3z8w&m=->Mtk4ZFzh#x%jUA0;hQAmYuk)|vz
zB$JG1$YmhJH?K9%h@S^wlo<=;%*eVH-;v^rM24j<Jq9JjV}#$xQ=1Grs4x>MV6B~I
z;y#NfCsrd-(;$Kd!+GZLF(NBh>EXWuBbWB1S0fO26{&P2*Vw^v3Z)eas%k?wS|WPS
zf+EP{Tw=RT3yMF+1zy1vj7FRp^pQ^@%T%7X5av&EX}GAlb3Aj0es#`q7a)@M=gQh?
zI_M0u0VE5AU78pY5roscDv*4VH!{JOFhLC*%+sqPQH|wA?+3%_b?9#nEnbKz?`9_T
zhcx$jiEAseqWeIpBt?I2?~(B?jROD4P5vdPw-~A273!9EgspZ3IVaXB>s6t~?71(Q
zf_K`^5O3c1MNDam;LvO=SCfGeVVc7=@>@fu-x6E+JZF()p7KUgV4(Ds%Vk36tMT7G
zGFTZ$=QbR-i{AXhM^TABNGdN7#@VRoiM!&9^oYmgG;t=lY0flM{rV(c$#3!-SNg_i
zV#X8<RR+|42Nrs%`H6nOpq8tX#g}|ADw3Z-7t?-Xs7BSj?n%_%*`$UFiw?55O_XjO
zcxt?ViEY+R?A%kDHzM&(hOQ#r9Kx?iL=KDgpAqLQ^AJut#VxuhQ52_~f5&311};)*
z<%B1Xyqtnzre9zNm)Jt~J6>X~zGV{oS3>e_zyMa4rqj3coA$pC_Cr_;)BsH=TcZt}
zoyfT4H(-V3O3knVEB1|h=SZRgMqZtBHlJ(9<_5{s=EWLk_(gycIRq)MB`B&W;g7t{
z5;k@AlKcuvr?*c+2S@iBvcdK(p&$KdtqjN3+niMLZzby<y-WYwpndx8hnKFPDj1&B
zMB;{P&gvRvKo<ywp}!CfoyL`OX(~=aIq^f^A3YZUj32zE25}Eq{v1`h)mCR7fltU1
zC~^;YR+515c?Wf%YU$q?7PA4Dm9t8p)-}KVW;yEq+cDUDvQm}CH9QlFG;g6UbCCax
z3*$U$(^5xC*a)AxAC8?$qcWbdzO|IGAc9KRfvYb4sJWbkc3<57e?&Fd^Of?&gM#Dz
z^@qfUhkXnv#6jgvz<TiT6*U9H$R3z;GzlG2w8F&OK?$6+n~JNIM;8jC51x`RsoCSG
zgY1P^8$Jv<sB#mwbBPl`6|J(Lqs*ij#7=!NH{E2*JLgjp0{0%m++_ZnGObX45)saz
z#fa_<eW#=4eUCv2kscZbPK;hBp4lggZeEro_plNt*HwA{CBf#H#H7E?#){fi$ZO$@
zZ`lB1WnKTvmEY*OG2x5emONg^h&h4rN)ch{dIirg{BhCgAQw8Vl!cu*>*M?~;k(V_
zUcZ4%SC+Sq`1Sj8do7lf2YNr4GGQ;S?rtm&%$a4R&8w*fjVV8eq$+93MBJ-Ap`^Hi
z^60{87pI*kucnj}(%<Oz69T8F039h?K9KgPJrI4@NzcmGDJ8WC86VabH=#F6e{i+x
zv2BiX>Nv^cEv3b$X7>u$?(V}UlGm}{7=7TVfkzKDbb|hUL14+F(~b5~z!3o0IhME@
zR(&XrqlI1(VKzpt2Ya+5%11V*FL04?#?UuW?Ko+vFP@p7a<wyVZ%^s4v!&jSURWp>
zE^nf<FgIMoRG9Kq>765VS!ZV&*;`L;J9JT1`sd(WOW#D`I9aGwK2fE@euRk51x18)
zRBMneSp6zDq}Xp{ADV1aZJdoE{?el}{3CjkLon*AhJ8fN)MQufLpYx335iTu+FiFw
zxdOEn_khNK9A9VRvdTFnBr3kAr_>O0X&J^4*iUUCWaPD#c3@}|2a?sT9`y{N)w@<;
zgM%`Y*t>m-KrKo?JP<y+jTQf}Ig0`er)#!KUjafHli2rRklj2Q@>Hx;50e0yuK?D=
zL`xMq984iG=hFx^&tl_x7MnoinXH$-U(9m6?o(pgPeEE$F+jO4g2R_M3}<YQpILGK
zH=WhmAxZZiY<HS+0oFLouX!yj<$%4ADGPN#_lnPg60u7z(z~?#lDf`Y^txMfz(@WY
zqIX_gniUwoh}f&F;<K)kd!T-*F0iin)uGtRL75Zr35ve#IcXt0hdB0^xbU#mS0c05
z#46;?NudLEQV_zFR{%u??ReHx*5qBaFhMA}O^H*-mVF0uzX(tm5$YX?LeTFkblZEu
zZ?cofvdFUTVJi4q`G;fL30a-Ka%tF}T_TsLIsjz2dlRpj!!dEjI+N&ivHwr#AQZ61
znfRQFq8@sJTH*>M;^xqG@Go+Av}*hU2Q&$L<?5vqkiO(QNR}(lU>grHo|SuY&e;{<
z^mZheCRVxx@`%!bRuDw(_?;udYgjTaUBDrncEfMXeXx)kHFWE!+)FB&kgi*UosYj&
z${OLTw@sNmy11SGEdKe{Bb(qZsXF?!X|$G;cZ?2<61xT_e)fb$i`98&Rw^TG!SP5$
zrJx(^oMMhSG`4eY^vRh{8lA?5iU?dox+#+!Ny^n~>%q;VK(?Q7+Ub(!s;QVYQ1I1H
zLEXE#b2epFw}$*WIqAOAR7yb(bRA<~*fg|iGJRL+of?*sBwl(;1IocSufh44JBL;1
z+`U*Yi03=ML|;{B0ONltM$yrhp($GfW4KH5;)II0mJnf%lu0V4g%v}=*0&+!Ur*$S
z3Hr+kAEkAzHA=$jrXhAezjq(YJ{aN|eR?pqam2O&w&yyrSdm-v)WnjK7Fg=cs&q*{
z-Iw$x!Me_U6F1cX80+2%CgLAU5Zt!X+&h$UiWYa>m*Zd&mCu)l!l#?IpEPWBK)?X`
z`G;x`X7{Ma^dImoBhIsIBE&*+Bn4<(+}9Jlek*UTHkmI;KzW8yKOXSvEjgA(?i>$`
z<aHH6n6X5tAGi%k%4*!N5Z(96w*&3EwZTncE`>eltuhFaaL5KOmtS$I`KsU+t}0JO
zV+c`A<eKAbms8MEra>)0sVJo#OwWU7oYDA+4MjgK0jqBWDPuo8DrCXGSkG_o!GwWa
zar+5NO+{NnTAVpL)$~e3jnJw-1z_%$uAHc>xnvneX*1RSs&O#`3_<lCdZ={{8XnMQ
z5^nP{=19V~Q4P^z-&2o9ex%<j>sYmE0yj3vRDJb&uXE6pDy~&=VFfilNM6Z_Pv6Hw
zF%t0qQ{O$z7^_76MnSV&p2%wv&5NJqHziWsU_UNR27gLPtUmOR`4!l-tbivvvnSt8
zf?r(R5Xg`Q5+0)oIw$F65g5IJilx6~fLiAGBB5QeTwfh!WO-F;A3To8Nx4t`IZCoN
zgMtLtAuq$A_;qf=UJwPaIPp(bpwV|g58n25S5orr*Gfq`;B?S_q==T)+*69~qRlF;
z+N{|;EQDNQ+rKn4m{q**5Pln3>^k$Czrm$LO}5JNNmA{mk`yceVKZaMBr>a?vbWF#
zknL7{$GcELWErzSU>U!p2+VJZQkLZMx;!swU8qV=r;TXer46mG34FUA!tSqGv??9Q
zgPJSWkTZij3S;W!(Y%wy9hO5lfs=xXCe-<6wbPaZ>c91=n=TswSqtQ$-wW5Gggk*9
zo6T1$>bsEV_4NMzk~R`CVhwQzRJ)P`Q?QW61^Kjh@9j{`l%Z92=fH<(6a1#SJ}ivS
z`?O!jmG>YHQ%nMQg)RlBr6FzfJp<O%3m1}XN7{|<EUJx*zn%|m3V^zzlup1ern;OL
zew0%DsI%;79S5+#Rl5kQa=M{==&Cbqp1wE5gn_J~!q#E-FR8KuOFd^C>eT4$A_Q#|
zoXd3<h^aDy)1K>PM2*5f@1q9d!&$o<WB=Qai0H@RB*c~CP@LOgY&HbIqf~=kqx;F-
zqF{=SjSSEGT_4#4Zc%XNJ>NQbzs4Z*?46G4#N(LS<P_Q#64LRkI_B-OK$d15$=|N8
z1M#1w?Qr`I8q?+!Ko?RYnQ?|?ry!IH@gYbP@{9c6f<Ul7?eM`#8W)&AN_Wn7zI-(l
zl69#iSs85w3jp`Ke9W#P<G%0+rZ1W_3E7L9sGm7T$-(^}&a4L#(xQ+9IZu|l7aMiy
znNn!0$WXXDutMq$VM>M)^L+zKf&KoT$H%l&L-nC#7vj!joj>Mq{PVqi(L>XfxyZPP
zZR_x2`TgBtW@?POx%J*knBln|Wd&2tn{moOY;rfeu0QCelSZ!d+NJC1D!49lHtG9_
zd4eSSZ7~@|N1BL2#+S4{hm%L7Ww;K(oJ8m@OlZrEf{!XwL$Djw_?KU_(DyC|e^YO$
zZ3#;y7a5vULQP3S@hlNC&E_hF)I&P(u}_wYhjQxblv+7Sll->E!cse-&;6gR2z*MU
z&SS(hEe~EO$=uR9(N=+~&z`Mdf)8aNnktu(f565J#?-9vIAa*I+qf#;NF5|uVz;T?
zjm^!6D7V0N;vGC>oOA*Sbm54|l`lr7OgiZF1%L|uii2@u#h9|H(QSPlt~dfZS>owd
zXmVHwfAhwYk|3aRoaA3!>IsY^SK(m<n*|H_>hJ`F@V}a<_qaA*CNUW>{V*uw{X2vr
zLQbUC_eMvDLD?6&tbzX^T}!W}JBeKhEMH}N`D$2|prRnDdJQEySnPn8%4I<16L__+
zSEw2RPDmAW?jjE(6olL$B3&sTx*<48Q7;v57C}vE>w+Jwozz&VL`oQ;xy)sp6bgK+
zKT?w^Mu&M>(T=)r0<b3K24pvSQmRl-SkPK1WH_IpO7K8~f9&h3h?dT@?oL<|OCgvK
z&QO`93FsiuE7)ikoc2iX2A{?lB+Fg231m7XY~mv}4Xn?)$sQi;w$QQ^!G|xfNR*wq
zSAkh4RmV`oO6f%+{q^7((8q2o4@4r3D|V6%pdG~o-)T1~b_<-4WasKug+2k{2)+f%
zU82vw#s!d?O>KDYjcJA$&|I^@u|kbZhb4Yh)#*!rIQrS3^(_WHk;8m64Y}gzsk{jv
zYsMj9mFVro884|hbcs9arK-BhIRvTs6#H~io+==#y>BZyzLn*Vw^>4#H{r2<dc961
zdR+n6ibR_#xO^mnnecC;{63P`ht>SbUsnk=SB;g-SdLkhdiHhr%mP+7jADIqv^%Z(
zju3)_C+=tT&I!^gQVr5(mx?F|Ynt-zn!xL|{TtoXmuYO8^mOs@dNMTzfAoO*o<u$b
z!w@+h!9?hx4)_IEsxIchxXOYeVUaS$F7<`z<mUct$;RLc?wBWdQHsrLze5Lbfy*;8
z;9nJ6P>w*hkp(h(Aulp>v`nr~dCgfs2MB|wXbv$Zx+g(ZM|!GYN1B25s+bwH%cpoE
z0W}i)&tiZ*#HU3CyTjrsG@3<!XkGv?nquK%)9g~hMq>0u=}Ei?*nzJY%g1GDy8cRA
z?fka6OCE5`SW9Gr7p3ei<rFz#5Vh$|6}wmw&ho@UxGEC=BM19Id|0V8@d!08&<h2o
zTZ{io`U9OSC4$d<twj>&jybQOo$B9!=-Y#zINWW}Jw;errPr2d$_b{{L6A{7gXkuY
zEPVs=gbKn7m^Q&tMv3GuyO@!k4LyK`CJb~kbAX5nMUfap&!jZ+rxm6z47y*3He8%$
zRb=*XFW?%COIe(FOoc5Y{~(cRpVe*0z67W-dm{4A2_JpkKLHJ=h(QLd!;wFJ;;;Gp
z4eRgGe;mR!fN*bq07QX+HGX;^YP<>{9`Y`F7IVWB9kb}&k5%WBi1$GUQ!b#Z`m(ck
zZzL_1+*zt!BG!a9Ag!6EjvZg31`zJos<>S`%o_>5o@ilIk`he{Y5$7n9>RVd!59G{
zFhfOL_F9GG?98Zy8=<awQ92f|bOU<`aw6W&kw#~vW;W*M1CIiMXrRdT(g*_!-7ZSF
zeH1^=XGzkhIcqZ3u)ErzR0ER2f3%>H5^!D=GsD>IPd=KO^j}Lf6xZbzJ+vSt#Pe%V
z7dFZ4u}5R~%E}2`!TiSO5XMZ&9Aco^R5UI_0$lNhLm%zr9kJ3D8|*f}YSpphuk(yh
zm16u;&W(ttT$RiVcj`YQUBAlmqKeJy2ajD>?S*W=AxX3XKR$5`&O=h2Yov?Q3AXIF
z!(VefT}jx_hPWBDYE>(?7CwlY{imN_YIl2K7g$QJ_=v>jJqFmEt_N7Da0#Pj>i3uq
z(a=h~OX*-TWQQ_N_VwT>-n?*0P)w0Ay9K2QWF#ern<%CISAH0TewayFI^KJL(k`%r
zU?vEK2vuxci|)?A8W~D!4WzV|SV4!y-v9()K%<-L98@XZyIml56vkv-culs$z!Z8I
zcqCebhfSHH-?saNORt??l$!`3Lcf+u*8a8cWhfc4e$8%pVk>&q)0JUG)&J97d%<Ge
z`ffb$5@qcYf(6ZDb4XlECns(!)1`pStYReydv=Qk4Pm#zXnx^^?n^jFXF|}W=cwjk
zVDbnO{%HN(GsPuZ&j|hV-+aSswCFzJWgFk<9{@(z8iFkHHNt<u&4uT2eY{Yoh+4%%
zVx5%*1HhyuiihQfI`P3%x*H{jl^CmZQw9GU;6JLk`<ea}LXQ}Pz?HTc+1Uf0#F=GX
zK$N?6(0*BzL!}yRBzp)s5vtHaAMMxjH*H;|@gfSkP&0+1=wAoiE$#^2F@Tg*^t{;i
zoJ|c(;_K_y1M;DjoQ8c_nYD`~K*dVtlDS6E=R|i*A~B9sm7=5Qrq>0G#-Ik#m28a~
z7Ju67>|Zo%Kznk1CyOlYQ%ad$u*JT122^ery?_M|AG9E@{cB%oBq<+{)J;vbI>+zm
z1Ux7ltGei2pjAyApamGb99Q`>Aw^#0;A$>P?|9ie*K)%4F~S+KT|VAL(am)q7Zm4l
z=(XYJ+OqurZ%gZZ|3&JJK62bKIua;IfLooUEV(L2`h_RKX8UtzAx0WIyCGj&#uEHJ
zLd5M7g266S0B8qkBMBn>d=u|6JRr$=4&>9vEmH%ktKUWcZ{kIjeSsP?poOwU-5M`M
zyqE9=w}7qjBC6XSy;H{9he0~AG}Q*TE6tM?lkw&D__&xcSCR7QZ&z_HpN3gbjRT-?
zXy|d$gbCP;gpn)(#F-$zw{3@Iu=*xC=#mdSlQ_$eEJV$0zEO2khz{^HH#dQ+&EvW%
z%t@$aMCSn^*Fb~gS=L+swN6x!8-4)VQdigco^VO^iCEhJx4cU_XRb6m0Stab@<GJU
zyo^plGrx9hwco?!(U+ZZ4q}WP1KYPgKuR^DixW_C_pZTjd4Q}+SRx=U0JIbBv?3?l
ztL}yI$OxT7xPB)6d1XmWB(@VtSf34?>*fq10oZ_;IY!a&PcEAX<oG6+%K49`C^r_I
z3(~e!Jqx<Xe@13r-W&-s5)Oe6@noadTRfQlkR1G^;f>->P4VTBJutLaIB*Y0{KLO-
zi)b!{WEJ#p!<e+O-zhqD0><6bYem$~X$tV_c5rK)nvGy5Z_1?~2G{Tc*&RkbQ+inV
zjpe5x8uGlV`b4>5yOW(4k5fjW^`b6))|qRA{o~{{Sjo=NX@cz<gB67y|K>ybiB!?h
zvS{T%PK^Nwa&~Zx(On+@REZioHrFm|f#W?Xiy0T3nagB-;FTLWNoT;UzbD7=>8O>_
zl}P>rWccvn=(5V>pl7sXnhg`{X|^5Z_A?!~iX0x8dXH0k1%e4B(;$g_X4ZC9&tTa8
z<9hWNo6zbd^sG67Kk;CVI>LF81a04LDhPMmUVb6!(l7KPaG3>s%YD<osN4%Zrevtz
zr786CAQny4GO@{bIq&EJ{`3!HUM`IL8e<d4xLpzNv9ii&-oqyVYD|*Q@kUZ?^9a~K
z@W~FaBN|c9R*`nvk(uNqjuE8ta&QjUFo`eGxa`W`4$$_qhwte2?{vj1`i?{?ndL(R
zcS+{UN+z$Y5BT?i_{P+=Nu;;WG%l;j2TohYyoCXMr}>+)cT0582Bi&Jh7jwy?Q&UQ
zUa&knX<nW39B*bkOqUfQgKbze4Z1mq<e;)l!2F^C7ZZ`k5V0j{wB-A>^j#I+hX-lL
z&F}E8F3}q)tZe*b<`H1!8Ykf9ysFXCT{k@xE8>3XZLI*cRbmoj^JmJfRsnpuViu3&
zJrG7=_lZpHy7+lP28pG9@;hAfrGP=$Hnw16%ZrK_OYD78Ind*A>^iz!V091(r&eF~
z)IpbKwDYb7tShZe+-?hfu8G?>dTsQ^#l@2dbX*RrE8rcfr}p~h(gsSlb~Z8VvNeye
zM~`Zi=8DZaUXJxh*Q_vjC^w)e1s0W3RALu~u4N+~eJlqYo4!BMKX7u)ZN47nxOAm-
zoJEK}d!ZxW`1%n`lwN{pa7{j+R&+8;mgUaMp40CVnL=vvVx;+c^R#G43M?I|ggM^M
zI@MmN)*5kE{*Il@!SHRtoUI^oq#H!s>phe1wAtqZ%PESdCq&U<iTTtRW#5l-OvQ}S
z?K72-jkZr}+HuwCP2<fh(k)vu{WQtUg{<z$Oh>F!(B+sP+===_Cdt38xk={XM}?mN
z_B8FZ$KgL%l#SzfiZen?g5!2>IMNnoOn`^mMRzVp@~4vL=gT(eyYf~h4x-Q6pmAQ5
zj<WTE%C?5P5eeZjT>i&gf@0*8R4hgmiHVX?0bDs)L{0J%g;IQPr+e<UTTv<wWY~k7
z9r(q?lHkZW)eR$RmHmAO_2K`iK4?F27*OJfI*PV<TZwU8X4W%m5F;G#)(C9-hzdPO
ztN{!veQ6+hSX9umdM^?+3l?RBJ$Fy76m?w1feD6Z$x3d_V(9q+FghcWL=!bTNQ5L^
zP2?nEJ)o;=m;uiQJU|+@1>Yu-cmW_bz&2DHQ;@6Z58Lke^R|fgX+5J-)Gz=Ls;-0N
zHRcrn<q=$YU~qkGG?&5M{lz$TZuH+_f?jk~PStSu^-zBsKzFz)BXn-nU_S3QT%~IC
zJdx3OPx*gr-!Fw<PC4>B+8SuKj<9NPHYf3Cs6t1=#$}drg5l36Gw}Zb-*IQrav$CR
zW$q%p<AG_8Av>P4e=4XMvjF=pqRB79cZ#;&vMRLmeAQA;9`Bewa_k+d-x+%)S{O`0
z7swN_)bdXW@U)CiF)<RRhsfZenB&W>LI-ys_-zAtyA#o6G$iRr8y5<apAL|nj%rc2
zV)VVw@SOux^*q}nE~*{j7Lft8VG*5+FXL3RQX`O5cF<X*IJ_-L(fz+<L+K=qKqye4
zx&WQ6Fh9F`<8zY+JiUbEAYzS+Il)(iZ&oCK5s1!~8f>Oi2pHdys2W)?Qlb;57Y64H
ze#u$6>m{m}0eeAvVWlw@mIoY3RV;ml0nf~v+ND{<9A&2AX`#_dO~0M$Qn>%XmQgsF
zAcK!Ijb5EfFahA>hnhl-!O}NxgCc4@NKKBjH5Lr1%t4P{!ZXa!*}hUf>zX#02Cuky
zV+<lTqb7IQMg2x3U<_fIJdz^BzLWRF>y8pgNW8P^05+M#IE`{lE0d{}PP@Dv`K!{C
zuOh%6@IgTq#!zk~6qnIbN`am)lTnoO4%FXtJuz?U)7meg-`BR4->6LC@eh2*G_{8Q
zwp1}%MZ2DJLb@2%?;=Cs_2dHF<fSLL{YpC641q~v4E+P}zw^Y5wI1u^N36cKCnnEO
z;QSs>zF1b-s%7(wDGEW>h5ajQX|0%rc+(_=p?I~z*s+m<$3?<{T!xpoT#Gtb>r5Tz
z4Ug|PTB6bvt@{H*rT;1nWhgtDWARcliV|Gf8{e&<g@xf&quFt2#|eZM@3*-?xu1Eh
z%5ewRpfyrKOvuNevsEM|`4VV2x&qxIHv4eYvx@&1H{WZzvln_Ye`Hj${kh9rc_qTz
zLpjgKulXapNq`AG&*ml=zDi9|#vJ$kid5?JL2`qC?!{N~qE}@O)^}1L!+Bh8{tR5<
z@E33W&kvs*dtZ*#vott;e~Fz*WdT&TQxb9Hu@3U?>o$S}Mph*gyeM-8y6v3h=R&4p
zGHNb6`(zegegK)1V&_6Z8r*bOsApniOFd4uR9*&u!-Q!+<bY|Eu5eVdyhQE)cng*8
zkOEg@lG^l^4ci`B*U!I{k+z!fU6=(!NOSw{c}t%ZuK!}ymcnnU_nxZPdQRd@AV7~P
zcCH>%t1KTSW`yqP)W+et%i1g0Uon(g;#*vE%N%3R7)Q|#R|cr`H>s^%f&~hcenXBp
z@~AnTfV(b=;NcoQxNNu;CNZrd<8F1bV4nJTg{IPZ3a{!%4<ud4ssc{?b-yv&46Aqs
zUk4}A5lfy_PthA=Y#N$;N<*t$v}-z4AXy8Ss_MEws=GBIN_f)r;JGsxPq+JA)Mri0
zQkObd6*pb=Zd;5YN}3;Mx@`v9Y1TawxOHLgGhEopO5+Npj9y`45;o)hDhw+r3E6vS
z_wk9;Q>zjSTuVaHo!v7(yQ7`_W@8&LD#1ms5guv!Z~CcP^5L9x*9$g(j6Hkb77#Jj
zrNv~(^MA5ltmja);tXOby(Qq5e%za;rHutb{oWOI)^Q|>n|X7{ly?Kz3Qs&p(p`Bb
zn8CXiayvd=&i2TUXx{-<L>8d}i+u9W$o8JO?|aQpH@9TTz=|z~EX}KjoARl|<)D7K
zh}BYlmMew266EppMX@hq7a2iMRPt!lHCI~q58TeoblGNuX7BW{GJIEf{rZVNcn|f{
zl1LvUzFAz0fCbz+zG^C<$}WW;E4BFQ#~_z6=1Vo(2bt^<q)(GGyiyH9B@mt+GzKTj
zf_f;g%-qf_Z+k*uY&Bt4qCRWxh#a*gqXZs|A-Q=&-m=6&y?DH$Hk4tO#r33CS*lj2
zcdPIxp7diO=we-jIJ^K}n$q^+<1I#v1wd>v-22Z9B(ND7Wr3Xw-K{muSau9pfNEr{
zksE1XWM1H=OaJ}P_PGq=SGS=qJ;kG(9F4&uRlHgyTrDH^rtfYsg7DWx46wLbi+}o0
z{TkKR?QJ)`FWbkLViOdNQk6`pN2m4k9yZhad1w+Nu;AO1?xrl_ApawAq}5B_=jE1M
z^JT&+UbI0DJj@$nV`~R>(LB;cXI0&Sx!KlDlwj6esViW@QwaNBiB23|A?*hHi#%2|
z+k}<{HbPx;l5zXoEId)mFr4$n<h?V<f<M1v=(@C&MFw0>X|(Tfro<^X#Y-RtV0K`z
z!Rb`=3e_p|7JM<*GUKOn7LCd+Fw_N2K#|`T844>82R0>pe$Rn>cE+>1yG>;d^7@%=
z1Xgv9|2~v=Id2S$-$_7%6MW=(Tq0;N>ejcNttaY=aLnC>1ik2uoxzCWgp-=<jRq+&
zxfj1As0hy#YKM;<Wv|lue%G|kiX`T-JPvtwrJgiJV4q9^qJ+VYc<O6KxxL?EMgP$L
zl#i-LbaKs@+@0KRW9oH+?Y#BS24&i_jQaHf<(ukatpzB`4$|7XP}Lo<{@&+SPJsdv
zMd^DllV3Bhb(OP(q!Mt}JHx9Lla}4(=$I!LsyOXGHavNnn@a@`_7v4_`wYJ8)Mg)!
zi$vu30%^9x8Tl!Z=IUUtWQBL#lZi5b*xD;c&t}PQikS$|<>(Hy0Ok5R%zNLaG68e@
zgm8Maoyz^fzr@{HA?7IWs}Z#KJ}FH=XEI=YoSL|gObbpmv^D?;HAhG_?KIr2^p$$|
zh`m7azl&VBga8UoRdW%`&P4oqTc3ROxCDir;9GJ>Su#jv**2>rP;TGnGxBK|ny&br
zFqS_p*QCf0j*XF^j3y)clF#mMe7DyV{Ws&qwa0`vu~>21$Aq4lk#ERcm|NVWHfP+%
zEiM*96Irg#0Hl364cv9gmpVNTUx>kWOp*M>wqq#;#K%FFMB+MAmc5^A1_97cSr_0?
zPZl9Obg|~m>8mm<gI|tlVjp;^v-S<a>K%#Z=%Bq4Y?vDD`t9_&EI$#^99>!<C(&@T
zwFv5P1ss{Ma^0sM<Yx^^hLK)X9@^O_Q9b~Cckc>@eA()?D#Lz7bS_Gy%S&#M(0U}j
zpCrzSDwX{U)fvT1;4`Vnk<ui8ivJr1!P+8=e5DYX>i*)!s8iNopaUbTqmK3!6Rr`M
z_vU*o?t|!bD><}^EY>RB)4x=dwdlO|-%Lufiv7>FtIwZy&lKH)m%`V>pUK3aa-g!V
zVVrhP@l+X929U*|jhg95wh>?_iz*|kU44Y2;PVyY>7(70)<^ciTpvBdR`KKsxFFZZ
z$@2#ZFzxP5<A1ohG&=QaHH@BHQwuJi@#%9%Im1%igNYoZi}Q(y$f<c8{>$SAH83=K
z(%ea1)lmJ=={_bsCD`&bqXT>%!NM(&Hh!d644K$p=vOxngMm@^Tm*<umE68*<;YQv
z#@~F|M_`9j07XE$zkFYlx-5w>Hkjjkk$CVjNY?b6B3ik>fsmD4ai+Xw+V+KX3P@3T
zsmQ_UH7Y=}S{qI)zn<ut(Si3TctlP3pbK~MT=^GYLn1+i#oZf>#Oz?_$GAB7S)@14
zztW0#^Da&*Z|Gm440+XvO*B@;t=16t9?PtfTRTodU)e@qaNz&WN2!xbY;xloXoVG2
zGmW@KADKqcKep}e7SZ~F0C-xbZzYCo>oa9i4B>E{^eq2o-8{S$RR9MmQVp@Me>MLI
z^FpI^xxo8-Pti%4gt>rRzn<8a<DGuJ<4C66S5_SP>5bpXHTRs_^9omom<B78sfg;!
z+yDF!pZo?XXCUGwV8FY<lbST~5m-d@#gyC+wb<ejR{(r|NqkYf`|qoDqfUiwaNkHd
z6uhiLC%U8=u3<{l#C(qN86zJ(M6PtAsnAYbU@8J+T6EB6X*_PJ`ESSGdim}OUQFWw
z_F0Q<9|7_xFYzA}q8zb@pfr>o+i1ogc3ubN^wPLCWSkId+gPb=6AR|?T>3bMnQ+MO
zZ>X1{A?8ZZa5zq&uHo39u0pnH=cdc&zn0t#8<AdQa9YfH#N}4Qnp`j7K<}ydLM8&F
zesQ5|?DV$7G%InwMZ;z|=C6tnKT!4ZSHENEG}`+l6Jgnp__Y-(5rHOF2+#T;Zr==j
z@*D}anI7IwBWv(;B3iT9Uo)!+oR#UOJ#9(d0)pa{l$p4dSlkeS=Ty7PJB;|e1Z`FG
z=D>;Z8q-B^`&KM|R|ah5n7cyCe_>7q@m}j46KwBdWBM__G$Eeyy-JTR9MF9p6Capr
z#KEEgQ}@5G@e$uEn5n58&EUlbw@14cPN*w2zOWA_RC{|{S7qe|_W3Y}F<!7H2Q>H9
zKsFr^$LEsR*ud4rYYNyBJN_wUlmHk}gB4mR^-cD9%NbwwM^Uo;q8@1D{RL9;sa>H-
zPxcb4vi%Jcit$kK3fDFxngoY~s3K8&zC0DF^_LZ1l#}zhL>>z(SvfWm(}4BzPGS|i
zSIPb=xRH|v&jj&OG(FWfGrHIximtWT<kzg?lo(TtK;>ZD#UQu4(*FL>+T>#V=OLy~
z%x@(W+x^ShugE$mh>as`TPQPJLFY2nA~LU>mK0T1-~uT+Bff67C+US?#P$qT^S1HF
zapPlCUTH`vbPBNC3LIq4qnQ*pKf`3Q80xFibg!uJLURc-13RVX17xkh#5(Awhn{UC
z91tLz8Pr|=NBZ!`sw%;Cc@UH4W2kwyehLXfHK7g7e{ugKFlgblKPY)x$yh5xV(r%9
zB4wCJr+i7?`lW<4=xQCODObI-L=Kof?QE!KctI9td)572Jv`b#f!)Uq8_C+OY$)OV
z2Bm?LG!yWR?SvBEJqB~Wuy%PM#bFB`zV8h6<}FBbT^|D2jQ+7<1~B^HS4OoA6N<Ce
zIq&T~3^Dn6YbOzQ`^&!1!kIe6Es399daKpz-dUMU=TH#_#)Eq-e0yV~Mgl{jowHN!
zy|9Y4B5>iaedohbHYIBLk&)0es#e9$+Z8W)9(9~AHy3XFZYN~=!;@xoAhhaE=EVV{
z-sT5*HTa5QaCe7{v%HOwGMLb;9bn1=Gj}sA;~3-t;=sZL_0XB23xdjnknih+`~sU^
zJP293oE{f2TK)6MwL`$OZoc)aB*rf%Yeso58i^7@zJ-B6m@K3l^F-^7w#cp|X;@JN
z!9qtPWHy#Aw&6+{`K8MM<n`r-Vd<oeaofLC_;MmpbZ`GO9P-1i5>Wj-$6qkLhbt@I
zd?G%<H}00nt?-M>AIY->nMTYlj*<^jq;HJv=`oC)5KgRs(8OhL)(~L#(s~X`lAJde
zvYhg8Xv*qP?~!%?mhuhaEWh%7sE<y$G3P-m31;(glOx??nfXR+VBdMG(v@9d!+2u{
z8n8IHctK$!Px$Ox^0&BlL-{5@A{&Mirnr*ZsLq1#ULaaX-8x;N`uqbkvmMtjQ^idC
zz#H1>eDn28Ur`N|u#%rCgc&?B7uitfv5`~^R+t02!cQ>eVJ%9x&=b)5*C74%=!#Pz
z`56IayavO<-)$JA^1OqTJ;A=^qXM@b9fb$?g*Y0+4o(AOm(c4`d_Ert%Tw+zYBxFZ
zKNr63QWd&-V)4^fDy_myYTxAOCBp4&oRgQYpAZV)c9E>b7*4Igejb15i&H5ak9)iy
zWYo8+jkkf}YcT(y@5u4+-c*mU_Jd<ftq6?S;>3=6Lc4avwXkp#XOjj!xrRwRCO4gH
zy*(@}O?_A%@mIqFtK-p44&8VH|Alc%;4Z9E)F43Gu&<gx+^3}vPZu?g>@l!EejpOh
z7rOW$+-aYy&%>vsn9xNiB}J>e+WY7E@`Rd8-H@J{^{c2-B6(+Yxwg=!p$LQ7wN5{;
zqJ~W-&_AKCQ;b30M9iE2Rg|#_(K&rbV83ggCwtIHmp3q~HT(H1**+H}k4~tnX+o9o
zlGME*TwIyaETA-VC93%UP53wOW56=E+P+}4_iESp*Y`vr3UUBz<jL_-7f{n%1H;+r
z{J-a*ihYX=r*%NJeOXbU$#*5YQ5SpSZI${8zMUD$fm@G_(>*O@p8Sf#UPk|lP+@h%
zDO61aC%U6%lT>R2JDR@(wln{onks3YQ%yz*{e2qEt6c4JvN>J-K`{y$)2M~)`-+P2
z!(hR$IT#6`!cJoyz^oD4Y!PKvZXHwNk$Bz}_b>v3=N*D>OB3x-PO$@zP(^4|E?Q~9
zs6eL`Z<__&G42AakvJt3e<Yl@mS&swHU#k%s1edn8Zr>f_xJki^ufA)J1>xj$ja*H
zG1IN|;|+4t+d5IJoKaY?S4kO(><YNufdN|2T_<x0pirXqjmjg;e>`%IKlB%_%-KkW
zkG!$MFHawWMqx_UvtNXdjgv8KPDBZ!?DXsU(jkLyI2^!}iahwmz30~On>uK8B&09<
z*&;LpeQ%+ms1j>VCMjT(CE*;`?0HmwXYwtsad}j5Fcdi2_^YuL{~=&9jj_P<vod1n
zsH`7KSHV5GGz%@;oH)(d4+*G){Z4eK<=aB1YSqU_nNfedlah!%7s6NWturD!Ox%VT
zdySL_D;gY(h5vQSFnj2dcs{}Uj0QR;RdO-5p}uR+$528>e|`3feCWIJ22bHNi~con
z7{I$qjR$~OnfD08WolKrIoA%VIn@M^WNGHvEb2xg)8K9tS5H)Jm)Ly*l~az}Fa`~9
z`Oe{{6aocBzBBuOwppm}9RfM!7{c+>J5YPcRm~rM6>(Z3Ce??F|3kYM@bvOF0XBKh
zR(UEVwUt$|b*|t~zTL_d_XE34bhTIk{BOu=x018}U7?NZbiJil>O{+k$RR1BQ<G&h
zJ#1$;Z|8wWyxK84U;h|eEr}*#4eazKRcHqoW?sY7iQi!|vKn@n6{#J0nOS?_<^1Jc
zIUK|ea3PY*Dv}YrP~Wl^S+rWIvWz9N!5qHA)jfA|0<*(jVw^RN>A@<Wt~&^p)1vn3
zZA(s}Hj5R;wL8PYwOad>qh^%7-(_x_g{znGP_*r|>2H6k2h<e_{5?C6=RI)jA2498
zTq&U3(K@@Oyf$Pm#*&xse=Z7}c%f@J;>M76*zP~Vx9zuX+e?F-h8gl>uLS2Ktu8M7
zI$YQVm+iV2f<67M4Bb^-gm!5S5=t#;P9_dm9aglDt2FZia-w;i(Mpcl8B5JA;qv!3
z-GOEr&iFT!;WVF8LioFin=1`XTEGx##dsiYR1Ilc0etmCq<SwNS2rC78wcP2w)U#J
zWD-}P<B04aKZH@O<#Idt`K}(+{){Q<LLabBn$dBe&;!<1B{9ce=&>jPK15r4WhHND
zDFyvA%d&VkaT|{aLYZId1|vH9kU~~J9KbPOH`@bjR&aFzllB<PBc=d6=^arBcG4%8
zkf$eRaY=x1E$;rJ2QuQ663g<*^&-32tv!QbR)IL$s#!1tHz(7$xk~OugtKR(XsT)9
zK!XTXnKbBv<9jKQy!I+2g;Cq3k;HK_1hCo^T?JBFxw5xVF+WBZh!fH97{7=8yo4@u
zIHsF%H-3+q;-Q+-k<Pr$&ws($@i})5fI`ipt;<Ft&>+1e`6&f`@#j}nQ{T)sWA##~
z4S3+g6F9n#H;a%1SLw0LXQ0NIB$6BCWkX)b@@u;&@^X!qcjIj##hj!*bl6K-yAP5$
zJ+;||XlJiC=b9PU`5MZq{c9cHIfZR;d1JPzQy{W(cp~PThERYunmkOA?bA0k`H^90
z`x=)hB!pPV@RRUQTHJe1SUDV(eKts_)pbfT%H<*QI8;5ScoFbWumbsP5(}5YBpjO>
zH6UfCer%5ALL&a1bS)@=r@jqyy$>=SJ1Hy5`_HD7CXO>Coa;aYHMJku<9Ou^SBx`1
z#=D$su8CBRe(^YL{;E)&j$Gy@!}FUTcc(#ni2LF5d*fPTb|Fvqs2;3N^u15<X-H{x
zydv2J`YB@9(;u`z;pC2;9VLl#!x<lYTHsw!IAcHf`DPOGZJtGZcKcGiuF2*-wgmb%
z(=G!8%kALmy)G+SsNdXMMi>c&yzEsKUdk(D`)M8D@KZ*6O{H8Wb_*5akw#ch>IP7H
z5*r*ypW9Id#3QKPUnHQRCF5Db7f%VKx3?o$9$B%~1})N+P}36cMy3*<S_E`{({8HF
zIqa1p45|?E4xV=IOR<>QpN!+$*?_;8$G0S}Ug7#(NDW!tTz;k4cB&8F_b&lY#<iuD
zt6T&_=s~I>!1Lgeh3U0%O>mwWamSFqC{r$W`PEl9gd}8DOy}Jty%sDdZV_%egBao|
zTIu8TRQ79X@4mcHg?l0KNAd8%L&FW`%^%AaLG4JVvd5gEq9RK(v5gl1gT=nVA=htE
zohM_|zt{x$IGdgK&2XiHU)6T}h@L>MAgjtZD2%NmugDOBkxiVUW|@7(3@sDt{U%ov
zMcv+*eUwmdH-OnKnRq`~<pi%up3*w<0~Ac<Laf;e3F_nX!)6djVUlIz&1ef9n2V<n
z@Nsg*B98A;(wrF0x(AJNn?=<*GVI+c39Q63!<sT@D9Y(-j%P_Rw1z|RjE&t_NXo3{
z=g2#yA4X?TnFw-?)~thk1Ga~B-YyI)2cQ}zr&=9A(cDBx6<nm%W9BUtn3=<9u>i(E
z0vIkB-&Uc5bc~oz{|!6uAssNTKLrj{_-Du<N}8WF$)+^H`g?eMa}RPD6l>R3Te$Y~
z#2%2k0{E=l&umGJA3|RI3?qlg&v(v5FOoElL=y-xAA~$~>=no=IYuhgm2Wf#GL22N
zT++O>g~!-r*HIMMd6Wcv0NvT(e`D;|5v+4gEp-q7P2h7if6nTQGU<9d%NZH16Ai?M
zlcB|UUdx&>OPOZcoj`RIAOspGt%Mi#4mXblDakO>Hpr!ZanXYC%BtF<5ze9S!aydy
z#l$2|ce#+$VjVDvX7fdr-Je&^pn;yKJ;8nF=yiMyp?7Q^5|*=8P5YW}1m4>DG)!`p
zuciBjY$35Ks76fRY?v9kkZ@Nu27gqO_`9M*nBUroLI>+{R~?|9yUy;VVsRlO|D!3+
zU4T9`c{)k;)6_=FryGMN)IU%ybX0_6U6(~Qj%$DK$)W<F&dzgONtc$I*|1K8FA(O{
zspB;+-Miw49p2vT{h>QL+^E40pAzT95u56U1QTijBcoD!hn@NHQOe49(o8jkh-cH!
zaiA@CM}!^)W_Bs}rUZ#QMWGF-y{b{FkQM*E8Tvmc*;02Ybk&5qJf4898OGN+rKdLp
zRk!lP80H$ezo<;TPL4R9vZ^T@&k5@LPx`R$+x8`DJMkvAT@nl(h!0f<V#&?VMZsg+
z(FggwVSS+BL4hXvi=%?jMSkzGJS*eHyxFR<vY-B93KFv1xX_!CA9M9#p}J34?-j?;
zgI@t*J-Pj5BumkgkE{Xa>3jds%RKThOTR=GbMZ$uS3K1eyrHuO@Ya19Ur>~&ehHzj
zk?^+kswi`-62KKrfY8KLX_xbFXDiu&#%OD`Fnw-7KvPpJWy?A2&Ygn1FGwvgV#SJ=
zB}kV4>o@J!@ftEgXZ3NYIqxg1t*oyMvONUf6L#62h3_d9IuIqZAgIzX$|<oJ+vE$+
zsPbf*wMd&(gVpZgu>-K(3-S5Y)c;Cn9xt2{q^Ve{74dmg2@79$Evk|2p8U`PPbHi1
zMU>lKmWx`=mzYu_9>DSu0}LO*OD^h-=CY38ywTrv#Y@<~f;>(FDp}kOlDlZr#Ri%O
zI8uEM2(6`)+gHtc6%wFnkXQ8cGW47o5vUTd4nq>IrXW6Rbz?<^bz%qgBnC#9t~Ro!
zL1{7BO^PJG5^=c<!tJ3Qrtz~u8@gKLJjK8sJcVpUFo@8op0p%y(^38@6qyPT%F+Yu
z*JSvjt&3Q+DX>0LnNk&z*r}p}>!*t8?>)690>@>2kLRuo*pYV_HGKQe<u<^v#5h-z
z#2_or=If(LzTx2X{Zm&c0wSU>{&Go?|7LYsZ*WF&-LT{CFT)0oYV(1(WVl-|-o8uV
zmUTXnz2XLUf^N6I(&1dvly~gJ3vxgnRD|Iwwm}csN`#uc0HuKPeP^CYq9sS#_n8Mb
zQ)I8+2dB2~SWh^ljK>XNYlc`%##Z1;bJ1@VfChEvX|s(;`>;#5+9_ln@gt~YTvCr7
z4W`Pd$3F8PpCLY0j<@A5k<DSF+)(JJ0DbpzGI0Ni|NX#?WE|BA$J?3PFeMYx<#1hj
zOd|-gi()tXk8n(TbuO#SlW@KYv^k<YZQ{ah3M4WUV<DuqyhXZW&utk1V7H1S=mp9j
ztk|NIvLHGd0eBTQ^_Jh?<fCjRwo_kk1>#k+gthuzF%hImZhPLPT;}{liY~g(FN)gm
zkN|vtF1!XtRZe@EC!TIBMG45wV*5hI&yg-r_5HA_ueS+ye7XgJgE6D8^hlZ^@7b&Z
z$MZM?3cG=*AJIl;0bCsg6Sd&-oqThhoQpTqMa05BN>F5>YnsnMdRjkh6a#YlH6wsV
zypNLJj>V$W*;8h7dm6eta(ZudjJ9>H=QwCqFW|-0Ho7LDx}peZzUW<)w1hN)4##y)
z#)Mv&yS^%e85A1t9qRZ<Eb7%##ZAMjrHIqHPYw1?&-R1)B&$cb^iW)P7KQ-vOsw()
z3%Jpath8cHT`j8`{=xUy^7LyH_qLJ<JCKBwGfwQvgN2jl_Q*4qAh7^4w_YDZRMr!c
z3wz`pYA|D#05K+_riGp5y^uc&%XFyC04!0xo*(9}1W|WKRb%k67e5t5u6OLRf}N}~
zkP%u4q_0LW*8xx7vZUgQ1Rf;MyM2tZUTV7{sNN5F2_b5h7?<%(GQ6`z;6{g7;Qfte
z!_&kD7Ma>4@FoxKFg$YO#uKaaWFttj39p5NblruALS$$ylg~ubT;eZQ^MikhW#m4O
zehz!mCJYO6mTvN~%j$l-iS~`rm#AQx#a$DLz#xJrqyDJC%fweZ-;nY-=uQxW<uhi$
z?+fn0KAw{(3a@xbvI|=EBKL?{$1WS_6<dw)6`!$^BTErV_U&!t8_?ShCjFxK`EtT<
z(-acC?G{kh%0^#q5|QO1A^^LoMnj^Xq2FT<ozD;D{mVv;?Lj(StoVghKD&Q)p*QH;
zi~3qF-x`qNm`b(b3pec!oJLg*+WV!4+C}r$pNIylsACQsW0WnJ22NNbgx7>*1Fz*B
zYWU&tG-pQVsdpmOr$2fY_nq(-bU9gvkK<5eh&sj#qJ;lrNPx?qr&mA`wUJ#`Rs)6y
zp4^*kMcmN{INZ#^<#Ph|#G!E)9@QK~DU1E-KQhZdD7Jt`n|Agqa)1~7%Ech(MHCXt
zek_-`3~_kHM=^7Tph-rcxK7Hkvj~QL02nGkO~*O+vA?#Li4S!8=+$;BX$ikp`W4ds
zgEsomW9*^U#TTV5IOrCnLMYeyW9mi##qT>^GV9U6Didc}FBG9GtjsD$+U+<>`5P7w
zB`)r(vqZ$Ihtvv&OD40W?mXt*RYvU~mf3kmXS*#k17w@CV8Sw09%SD2l|3;nt!jtK
z&YY0;dVo;H^q*D?sN|!8%zeU<@)p081c&fTnaCjSM<IYj!t0`lq`^Z+wt`8rlh{}C
zsy{vEgnXXJ?Y7q$6cmVDvrpgXQBWXelSn-Cu$0!Sd|y<Z;Dytw53>I!xWyEQort?<
zv(|54y7<1(o?I|HiS8C>G!8g(xEzx}E_dcAB)0#`+4X;RHsWP+&OfomOnwAqmYH8_
z1!mV3bUS?-v6*&am*UTLlocz~lgP!Luj5FH209#>|C&hj8B0F9i(SF~26GLF6mNus
z|CI;<3D)p4+*o`VuY#quU*k`=r3g>Gmk?*LZ%g>C9i<h{JsSmT-TGtt#e5yji38{&
zIZu_T7@H4i9|(JPx!<)~vG;u#Ef+TFg!1OVBZd>^xRHwhq~Egh&_xBhJ^gUSTVAOI
zEA6N<@tlmO2a=13O|A_M)#)*FVarReI|)@<KZ0*mTMW@E5cq2(KO*J3_TDQhv5{*g
z3u2~s8v~gWcB_fy<M!Kb%HpNZ%dH2DaQQA2#0_*-&t$QOw%pLkJRd=M{B*i9g))tp
zX=e?kIIk!`ZUY$Kv=rd_RsJ=e=aZLbGS|T3q@+?#@K8^af*H+{x}DSqVUqElO2I4p
zUxEL~z*%1Oi=Lg-VZ2DVstqvsTYaeF%=C(ZjHDivWB%+Tg3mOqNwM#lRt_iW_}C@m
zsA72jy21f8vO+k;JL7ZYmS+4o^K;%|o1>lO=Fa>8Y3IlR9BFtxx~he!i*enb{Vi>K
z9J52(0R(k%NI2hP3oM|IClTIOfK;do^u&8#j<`aI`BV^If7AI$E0%_tT&c4_Y}8Gh
z_2#jTef8IOk`nTmlbp9_NsF!H)>k}$wPG>Iy*)z(u^ls^+qnHfXmLHZcs=?i@URsl
z1;3k5{Yoa0*X<I(FQk0VpT)C1GeX<5n{j-HqT$8&f1r>-IlarAs{qqk0~b|dEd0gH
zEonfkl{cR2_qDSm526WsoFIu|5yZo8j;7hdXsK^cAIf&xTBt$vJAXF4#+0b*x)G?R
zJhG9E6aN}X#SZi2QQ4Z#wlk-8oA7yz$r6(3Z51{K>ad{F6e7!aY5499;p_`QEDD<c
z6lrW}d`L+Hd(!}yTQnv(P<hi%0A2huA}oT@i_{Tsj<46)&>J16s#kNN`y{PeMj#jw
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

literal 0
HcmV?d00001


From b60849088580eff4e0668343a18bb0cdb0e038b6 Mon Sep 17 00:00:00 2001
From: Azat Khuzhin <a3at.mail@gmail.com>
Date: Sat, 17 Jun 2023 13:56:29 +0200
Subject: [PATCH 535/722] Fix 02703_max_local_write_bandwidth flakiness
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

LocalWriteThrottlerSleepMicroseconds is too unpredictable in debug
builds, event with 50% of allowed error it still fails [1].

  [1]: https://s3.amazonaws.com/clickhouse-test-reports/51006/6cc4f76707b196b0f02938671f62c9bb3d267faa/stateless_tests__debug__%5B2_5%5D.html

Looking into query_log artifacts:

    $ clickhouse-local --file query_log.tsv.zst --input-format TSVWithNamesAndTypes -q "select query_duration_ms, ProfileEvents['LocalWriteThrottlerSleepMicroseconds'] from table where log_comment = '02703_max_local_write_bandwidth.sh' and type != 'QueryStart' and query_id = 'eebxgbfqyt'" --output-format Vertical
    Row 1:
    ──────
    query_duration_ms:                                                   15'608
    arrayElement(ProfileEvents, 'LocalWriteThrottlerSleepMicroseconds'): 1'385'203

So query duration is 15.6sec, while throttle sleeps only 1.39sec, which
is only 9%, apparently it waits somewhere else.

Signed-off-by: Azat Khuzhin <a.khuzhin@semrush.com>
---
 .../0_stateless/02703_max_local_write_bandwidth.reference     | 2 +-
 tests/queries/0_stateless/02703_max_local_write_bandwidth.sh  | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/queries/0_stateless/02703_max_local_write_bandwidth.reference b/tests/queries/0_stateless/02703_max_local_write_bandwidth.reference
index ad05a699da0..72749c905a3 100644
--- a/tests/queries/0_stateless/02703_max_local_write_bandwidth.reference
+++ b/tests/queries/0_stateless/02703_max_local_write_bandwidth.reference
@@ -1 +1 @@
-1	1	1	1
+1	1	1
diff --git a/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh b/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh
index ccde0903278..31cf6e9606e 100755
--- a/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh
+++ b/tests/queries/0_stateless/02703_max_local_write_bandwidth.sh
@@ -18,8 +18,8 @@ $CLICKHOUSE_CLIENT -nm -q "
     SELECT
         query_duration_ms >= 7e3,
         ProfileEvents['WriteBufferFromFileDescriptorWriteBytes'] > 8e6,
-        ProfileEvents['LocalWriteThrottlerBytes'] > 8e6,
-        ProfileEvents['LocalWriteThrottlerSleepMicroseconds'] > 7e6*0.5
+        ProfileEvents['LocalWriteThrottlerBytes'] > 8e6
+        /* LocalWriteThrottlerSleepMicroseconds is too unreliable in debug build, but query_duration_ms is enough */
     FROM system.query_log
     WHERE current_database = '$CLICKHOUSE_DATABASE' AND query_id = '$query_id' AND type != 'QueryStart'
 "

From 3e880fe1bde4288faa6c62d90f0e7a6724bb61be Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Sat, 17 Jun 2023 13:58:31 +0000
Subject: [PATCH 536/722] Update version_date.tsv and changelogs after
 v23.5.3.24-stable

---
 docker/keeper/Dockerfile             |  2 +-
 docker/server/Dockerfile.alpine      |  2 +-
 docker/server/Dockerfile.ubuntu      |  2 +-
 docs/changelogs/v23.5.3.24-stable.md | 26 ++++++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  4 ++++
 5 files changed, 33 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v23.5.3.24-stable.md

diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 44967af4b32..367f6043b90 100644
--- a/docker/keeper/Dockerfile
+++ b/docker/keeper/Dockerfile
@@ -32,7 +32,7 @@ RUN arch=${TARGETARCH:-amd64} \
     esac
 
 ARG REPOSITORY="https://s3.amazonaws.com/clickhouse-builds/22.4/31c367d3cd3aefd316778601ff6565119fe36682/package_release"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-keeper"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.alpine b/docker/server/Dockerfile.alpine
index 8ab9bf7b077..e7e879fa95f 100644
--- a/docker/server/Dockerfile.alpine
+++ b/docker/server/Dockerfile.alpine
@@ -33,7 +33,7 @@ RUN arch=${TARGETARCH:-amd64} \
 # lts / testing / prestable / etc
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="https://packages.clickhouse.com/tgz/${REPO_CHANNEL}"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index b3b0cfe1510..f393b98cfe6 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -22,7 +22,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # set non-empty deb_location_url url to create a docker image
diff --git a/docs/changelogs/v23.5.3.24-stable.md b/docs/changelogs/v23.5.3.24-stable.md
new file mode 100644
index 00000000000..967a50b3b0e
--- /dev/null
+++ b/docs/changelogs/v23.5.3.24-stable.md
@@ -0,0 +1,26 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.5.3.24-stable (76f54616d3b) FIXME as compared to v23.5.2.7-stable (5751aa1ab9f)
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix Log family table return wrong rows count after truncate [#50585](https://github.com/ClickHouse/ClickHouse/pull/50585) ([flynn](https://github.com/ucasfl)).
+* Fix bug in `uniqExact` parallel merging [#50590](https://github.com/ClickHouse/ClickHouse/pull/50590) ([Nikita Taranov](https://github.com/nickitat)).
+* Revert recent grace hash join changes [#50699](https://github.com/ClickHouse/ClickHouse/pull/50699) ([vdimir](https://github.com/vdimir)).
+* Avoid storing logs in Keeper containing unknown operation [#50751](https://github.com/ClickHouse/ClickHouse/pull/50751) ([Antonio Andelic](https://github.com/antonio2368)).
+* Add compat setting for non-const timezones [#50834](https://github.com/ClickHouse/ClickHouse/pull/50834) ([Robert Schulze](https://github.com/rschu1ze)).
+* Fix iceberg V2 optional metadata parsing [#50974](https://github.com/ClickHouse/ClickHouse/pull/50974) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix subtly broken copy-on-write of ColumnLowCardinality dictionary [#51064](https://github.com/ClickHouse/ClickHouse/pull/51064) ([Michael Kolupaev](https://github.com/al13n321)).
+* Generate safe IVs [#51086](https://github.com/ClickHouse/ClickHouse/pull/51086) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Don't mark a part as broken on `Poco::TimeoutException` [#50811](https://github.com/ClickHouse/ClickHouse/pull/50811) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix a versions' tweak for tagged commits, improve version_helper [#51035](https://github.com/ClickHouse/ClickHouse/pull/51035) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Sqlancer has changed master to main [#51060](https://github.com/ClickHouse/ClickHouse/pull/51060) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 6afce99612f..5c32ebb2683 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,8 +1,11 @@
+v23.5.3.24-stable	2023-06-17
 v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
+v23.4.4.16-stable	2023-06-17
 v23.4.3.48-stable	2023-06-12
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.4.17-lts	2023-06-17
 v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
@@ -46,6 +49,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.19.10-lts	2023-06-17
 v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04

From 4aa507386df0435104d92e2e3b0d34b6b5ebc79a Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Sat, 17 Jun 2023 13:58:33 +0000
Subject: [PATCH 537/722] Update version_date.tsv and changelogs after
 v23.4.4.16-stable

---
 docker/keeper/Dockerfile             |  2 +-
 docker/server/Dockerfile.alpine      |  2 +-
 docker/server/Dockerfile.ubuntu      |  2 +-
 docs/changelogs/v23.4.4.16-stable.md | 22 ++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  4 ++++
 5 files changed, 29 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v23.4.4.16-stable.md

diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 44967af4b32..367f6043b90 100644
--- a/docker/keeper/Dockerfile
+++ b/docker/keeper/Dockerfile
@@ -32,7 +32,7 @@ RUN arch=${TARGETARCH:-amd64} \
     esac
 
 ARG REPOSITORY="https://s3.amazonaws.com/clickhouse-builds/22.4/31c367d3cd3aefd316778601ff6565119fe36682/package_release"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-keeper"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.alpine b/docker/server/Dockerfile.alpine
index 8ab9bf7b077..e7e879fa95f 100644
--- a/docker/server/Dockerfile.alpine
+++ b/docker/server/Dockerfile.alpine
@@ -33,7 +33,7 @@ RUN arch=${TARGETARCH:-amd64} \
 # lts / testing / prestable / etc
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="https://packages.clickhouse.com/tgz/${REPO_CHANNEL}"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index b3b0cfe1510..f393b98cfe6 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -22,7 +22,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # set non-empty deb_location_url url to create a docker image
diff --git a/docs/changelogs/v23.4.4.16-stable.md b/docs/changelogs/v23.4.4.16-stable.md
new file mode 100644
index 00000000000..72056f72091
--- /dev/null
+++ b/docs/changelogs/v23.4.4.16-stable.md
@@ -0,0 +1,22 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.4.4.16-stable (747ba4fc6a0) FIXME as compared to v23.4.3.48-stable (d9199f8d3cc)
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix crash when Pool::Entry::disconnect() is called [#50334](https://github.com/ClickHouse/ClickHouse/pull/50334) ([Val Doroshchuk](https://github.com/valbok)).
+* Fix iceberg V2 optional metadata parsing [#50974](https://github.com/ClickHouse/ClickHouse/pull/50974) ([Kseniia Sumarokova](https://github.com/kssenii)).
+* Fix subtly broken copy-on-write of ColumnLowCardinality dictionary [#51064](https://github.com/ClickHouse/ClickHouse/pull/51064) ([Michael Kolupaev](https://github.com/al13n321)).
+* Generate safe IVs [#51086](https://github.com/ClickHouse/ClickHouse/pull/51086) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Don't mark a part as broken on `Poco::TimeoutException` [#50811](https://github.com/ClickHouse/ClickHouse/pull/50811) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix a versions' tweak for tagged commits, improve version_helper [#51035](https://github.com/ClickHouse/ClickHouse/pull/51035) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Sqlancer has changed master to main [#51060](https://github.com/ClickHouse/ClickHouse/pull/51060) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 6afce99612f..5c32ebb2683 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,8 +1,11 @@
+v23.5.3.24-stable	2023-06-17
 v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
+v23.4.4.16-stable	2023-06-17
 v23.4.3.48-stable	2023-06-12
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.4.17-lts	2023-06-17
 v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
@@ -46,6 +49,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.19.10-lts	2023-06-17
 v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04

From 081ae167e1034a0d49f90b0430aa127104683d7f Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Sat, 17 Jun 2023 13:59:51 +0000
Subject: [PATCH 538/722] Update version_date.tsv and changelogs after
 v23.3.4.17-lts

---
 docker/keeper/Dockerfile             |  2 +-
 docker/server/Dockerfile.alpine      |  2 +-
 docker/server/Dockerfile.ubuntu      |  2 +-
 docs/changelogs/v23.3.4.17-lts.md    | 22 ++++++++++++++++++++++
 utils/list-versions/version_date.tsv |  4 ++++
 5 files changed, 29 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v23.3.4.17-lts.md

diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 44967af4b32..367f6043b90 100644
--- a/docker/keeper/Dockerfile
+++ b/docker/keeper/Dockerfile
@@ -32,7 +32,7 @@ RUN arch=${TARGETARCH:-amd64} \
     esac
 
 ARG REPOSITORY="https://s3.amazonaws.com/clickhouse-builds/22.4/31c367d3cd3aefd316778601ff6565119fe36682/package_release"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-keeper"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.alpine b/docker/server/Dockerfile.alpine
index 8ab9bf7b077..e7e879fa95f 100644
--- a/docker/server/Dockerfile.alpine
+++ b/docker/server/Dockerfile.alpine
@@ -33,7 +33,7 @@ RUN arch=${TARGETARCH:-amd64} \
 # lts / testing / prestable / etc
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="https://packages.clickhouse.com/tgz/${REPO_CHANNEL}"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index b3b0cfe1510..f393b98cfe6 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -22,7 +22,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # set non-empty deb_location_url url to create a docker image
diff --git a/docs/changelogs/v23.3.4.17-lts.md b/docs/changelogs/v23.3.4.17-lts.md
new file mode 100644
index 00000000000..41d9d7dd06c
--- /dev/null
+++ b/docs/changelogs/v23.3.4.17-lts.md
@@ -0,0 +1,22 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.3.4.17-lts (2c99b73ff40) FIXME as compared to v23.3.3.52-lts (cb963c474db)
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix crash when Pool::Entry::disconnect() is called [#50334](https://github.com/ClickHouse/ClickHouse/pull/50334) ([Val Doroshchuk](https://github.com/valbok)).
+* Avoid storing logs in Keeper containing unknown operation [#50751](https://github.com/ClickHouse/ClickHouse/pull/50751) ([Antonio Andelic](https://github.com/antonio2368)).
+* Fix subtly broken copy-on-write of ColumnLowCardinality dictionary [#51064](https://github.com/ClickHouse/ClickHouse/pull/51064) ([Michael Kolupaev](https://github.com/al13n321)).
+* Generate safe IVs [#51086](https://github.com/ClickHouse/ClickHouse/pull/51086) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Don't mark a part as broken on `Poco::TimeoutException` [#50811](https://github.com/ClickHouse/ClickHouse/pull/50811) ([Alexander Tokmakov](https://github.com/tavplubix)).
+* Fix a versions' tweak for tagged commits, improve version_helper [#51035](https://github.com/ClickHouse/ClickHouse/pull/51035) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Sqlancer has changed master to main [#51060](https://github.com/ClickHouse/ClickHouse/pull/51060) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 6afce99612f..5c32ebb2683 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,8 +1,11 @@
+v23.5.3.24-stable	2023-06-17
 v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
+v23.4.4.16-stable	2023-06-17
 v23.4.3.48-stable	2023-06-12
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.4.17-lts	2023-06-17
 v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
@@ -46,6 +49,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.19.10-lts	2023-06-17
 v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04

From fbcec61aecbc8cf8a945bd92ad890fa73a81f24e Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Sat, 17 Jun 2023 14:01:58 +0000
Subject: [PATCH 539/722] Update version_date.tsv and changelogs after
 v22.8.19.10-lts

---
 docker/keeper/Dockerfile             |  2 +-
 docker/server/Dockerfile.alpine      |  2 +-
 docker/server/Dockerfile.ubuntu      |  2 +-
 docs/changelogs/v22.8.19.10-lts.md   | 19 +++++++++++++++++++
 utils/list-versions/version_date.tsv |  4 ++++
 5 files changed, 26 insertions(+), 3 deletions(-)
 create mode 100644 docs/changelogs/v22.8.19.10-lts.md

diff --git a/docker/keeper/Dockerfile b/docker/keeper/Dockerfile
index 44967af4b32..367f6043b90 100644
--- a/docker/keeper/Dockerfile
+++ b/docker/keeper/Dockerfile
@@ -32,7 +32,7 @@ RUN arch=${TARGETARCH:-amd64} \
     esac
 
 ARG REPOSITORY="https://s3.amazonaws.com/clickhouse-builds/22.4/31c367d3cd3aefd316778601ff6565119fe36682/package_release"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-keeper"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.alpine b/docker/server/Dockerfile.alpine
index 8ab9bf7b077..e7e879fa95f 100644
--- a/docker/server/Dockerfile.alpine
+++ b/docker/server/Dockerfile.alpine
@@ -33,7 +33,7 @@ RUN arch=${TARGETARCH:-amd64} \
 # lts / testing / prestable / etc
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="https://packages.clickhouse.com/tgz/${REPO_CHANNEL}"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # user/group precreated explicitly with fixed uid/gid on purpose.
diff --git a/docker/server/Dockerfile.ubuntu b/docker/server/Dockerfile.ubuntu
index b3b0cfe1510..f393b98cfe6 100644
--- a/docker/server/Dockerfile.ubuntu
+++ b/docker/server/Dockerfile.ubuntu
@@ -22,7 +22,7 @@ RUN sed -i "s|http://archive.ubuntu.com|${apt_archive}|g" /etc/apt/sources.list
 
 ARG REPO_CHANNEL="stable"
 ARG REPOSITORY="deb https://packages.clickhouse.com/deb ${REPO_CHANNEL} main"
-ARG VERSION="23.5.2.7"
+ARG VERSION="23.5.3.24"
 ARG PACKAGES="clickhouse-client clickhouse-server clickhouse-common-static"
 
 # set non-empty deb_location_url url to create a docker image
diff --git a/docs/changelogs/v22.8.19.10-lts.md b/docs/changelogs/v22.8.19.10-lts.md
new file mode 100644
index 00000000000..b3990c74e46
--- /dev/null
+++ b/docs/changelogs/v22.8.19.10-lts.md
@@ -0,0 +1,19 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v22.8.19.10-lts (989bc2fe8b0) FIXME as compared to v22.8.18.31-lts (4de7a95a544)
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix subtly broken copy-on-write of ColumnLowCardinality dictionary [#51064](https://github.com/ClickHouse/ClickHouse/pull/51064) ([Michael Kolupaev](https://github.com/al13n321)).
+* Generate safe IVs [#51086](https://github.com/ClickHouse/ClickHouse/pull/51086) ([Salvatore Mesoraca](https://github.com/aiven-sal)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Fix a versions' tweak for tagged commits, improve version_helper [#51035](https://github.com/ClickHouse/ClickHouse/pull/51035) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+* Sqlancer has changed master to main [#51060](https://github.com/ClickHouse/ClickHouse/pull/51060) ([Mikhail f. Shiryaev](https://github.com/Felixoid)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 6afce99612f..5c32ebb2683 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -1,8 +1,11 @@
+v23.5.3.24-stable	2023-06-17
 v23.5.2.7-stable	2023-06-10
 v23.5.1.3174-stable	2023-06-09
+v23.4.4.16-stable	2023-06-17
 v23.4.3.48-stable	2023-06-12
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.4.17-lts	2023-06-17
 v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22
 v23.3.1.2823-lts	2023-03-31
@@ -46,6 +49,7 @@ v22.9.4.32-stable	2022-10-26
 v22.9.3.18-stable	2022-09-30
 v22.9.2.7-stable	2022-09-23
 v22.9.1.2603-stable	2022-09-22
+v22.8.19.10-lts	2023-06-17
 v22.8.18.31-lts	2023-06-12
 v22.8.17.17-lts	2023-04-22
 v22.8.16.32-lts	2023-04-04

From 98bc124317d17cbc6193b2441b87ea9e607394bd Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 17 Jun 2023 17:13:19 +0200
Subject: [PATCH 540/722] Fix typo

---
 src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h b/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h
index 55a9c7b1509..dbed58ba91c 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h
@@ -21,7 +21,7 @@ using SerializationPtr = std::shared_ptr<const ISerialization>;
  * in order to use MergeTreeDataPartReader's.
  * It is a separate interface and not a simple struct because
  * otherwise it will need to copy all the information which might not
- * be even used (for example, an IndexGranulary class object is quite heavy).
+ * be even used (for example, an IndexGranularity class object is quite heavy).
  */
 class IMergeTreeDataPartInfoForReader : public WithContext
 {

From 61e423c5df3fa75f9ddcd0d9e19c74b0477718f8 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 17 Jun 2023 17:14:49 +0200
Subject: [PATCH 541/722] Fix typo

---
 src/Storages/MergeTree/IDataPartStorage.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index 933c9bd9958..8242440b8be 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -73,7 +73,7 @@ struct WriteSettings;
 class TemporaryFileOnDisk;
 
 /// This is an abstraction of storage for data part files.
-/// Ideally, it is assumed to contains read-only methods from IDisk.
+/// Ideally, it is assumed to contain read-only methods from IDisk.
 /// It is not fulfilled now, but let's try our best.
 class IDataPartStorage : public boost::noncopyable
 {

From c7a18c640e30d7726251a3fc7184b2ec53b08f9b Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sat, 17 Jun 2023 17:20:44 +0200
Subject: [PATCH 542/722] Slightly better diagnostics

---
 src/Storages/MergeTree/IMergeTreeReader.cpp    | 18 +++++++++++++++---
 src/Storages/MergeTree/MergeTreeReaderWide.cpp |  5 +++--
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/src/Storages/MergeTree/IMergeTreeReader.cpp b/src/Storages/MergeTree/IMergeTreeReader.cpp
index dc9e9001439..be9aedaf4d5 100644
--- a/src/Storages/MergeTree/IMergeTreeReader.cpp
+++ b/src/Storages/MergeTree/IMergeTreeReader.cpp
@@ -79,7 +79,11 @@ void IMergeTreeReader::fillMissingColumns(Columns & res_columns, bool & should_e
     catch (Exception & e)
     {
         /// Better diagnostics.
-        e.addMessage("(while reading from part " + data_part_info_for_read->getDataPartStorage()->getFullPath() + ")");
+        const auto & part_storage = data_part_info_for_read->getDataPartStorage();
+        e.addMessage(
+            "(while reading from part " + part_storage->getFullPath()
+            + " located on disk " + part_storage->getDiskName()
+            + " of type " + part_storage->getDiskType() + ")");
         throw;
     }
 }
@@ -124,7 +128,11 @@ void IMergeTreeReader::evaluateMissingDefaults(Block additional_columns, Columns
     catch (Exception & e)
     {
         /// Better diagnostics.
-        e.addMessage("(while reading from part " + data_part_info_for_read->getDataPartStorage()->getFullPath() + ")");
+        const auto & part_storage = data_part_info_for_read->getDataPartStorage();
+        e.addMessage(
+            "(while reading from part " + part_storage->getFullPath()
+            + " located on disk " + part_storage->getDiskName()
+            + " of type " + part_storage->getDiskType() + ")");
         throw;
     }
 }
@@ -199,7 +207,11 @@ void IMergeTreeReader::performRequiredConversions(Columns & res_columns) const
     catch (Exception & e)
     {
         /// Better diagnostics.
-        e.addMessage("(while reading from part " + data_part_info_for_read->getDataPartStorage()->getFullPath() + ")");
+        const auto & part_storage = data_part_info_for_read->getDataPartStorage();
+        e.addMessage(
+            "(while reading from part " + part_storage->getFullPath()
+            + " located on disk " + part_storage->getDiskName()
+            + " of type " + part_storage->getDiskType() + ")");
         throw;
     }
 }
diff --git a/src/Storages/MergeTree/MergeTreeReaderWide.cpp b/src/Storages/MergeTree/MergeTreeReaderWide.cpp
index baacfa55c94..38032fae826 100644
--- a/src/Storages/MergeTree/MergeTreeReaderWide.cpp
+++ b/src/Storages/MergeTree/MergeTreeReaderWide.cpp
@@ -188,10 +188,11 @@ size_t MergeTreeReaderWide::readRows(
             data_part_info_for_read->reportBroken();
 
         /// Better diagnostics.
+        const auto & part_storage = data_part_info_for_read->getDataPartStorage();
         e.addMessage(
             fmt::format(
-                "(while reading from part {} from mark {} with max_rows_to_read = {})",
-                data_part_info_for_read->getDataPartStorage()->getFullPath(),
+                "(while reading from part {} located on disk {} of type {}, from mark {} with max_rows_to_read = {})",
+                part_storage->getFullPath(), part_storage->getDiskName(), part_storage->getDiskType(),
                 toString(from_mark), toString(max_rows_to_read)));
         throw;
     }

From 642734e5124ee1782f9375a1458e1504d8a81ea9 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Sat, 17 Jun 2023 23:48:09 +0200
Subject: [PATCH 543/722] fix shell commands source

---
 src/Processors/Sources/ShellCommandSource.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/Processors/Sources/ShellCommandSource.cpp b/src/Processors/Sources/ShellCommandSource.cpp
index ed8f9b41e78..8a7bbcf3261 100644
--- a/src/Processors/Sources/ShellCommandSource.cpp
+++ b/src/Processors/Sources/ShellCommandSource.cpp
@@ -550,11 +550,11 @@ Pipe ShellCommandSourceCoordinator::createPipe(
             CompletedPipelineExecutor executor(*pipeline);
             executor.execute();
 
+            timeout_write_buffer->finalize();
+            timeout_write_buffer->reset();
+
             if (!is_executable_pool)
             {
-                timeout_write_buffer->next();
-                timeout_write_buffer->reset();
-
                 write_buffer->close();
             }
         };

From 59c11cb1501cd32e8a2ff6535d569ff55483e168 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Sat, 17 Jun 2023 11:25:51 +0200
Subject: [PATCH 544/722] Make more parallel get requests to ZooKeeper

---
 .../System/StorageSystemZooKeeper.cpp         | 96 ++++++++++---------
 1 file changed, 53 insertions(+), 43 deletions(-)

diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index e5ea401f2eb..5ed57889c2d 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -435,6 +435,7 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
         ZkPathType path_type;
         String prefix;
         String path_corrected;
+        String path_part;
         std::future<Coordination::ListResponse> future;
     };
     std::vector<ListTask> list_tasks;
@@ -463,8 +464,16 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
             list_tasks.emplace_back(std::move(task));
         }
 
-        for (auto & task : list_tasks)
+        struct GetTask
         {
+            size_t list_task_idx;   /// Index of 'parent' request in list_tasks
+            String node;            /// Node name
+            std::future<Coordination::GetResponse> future;
+        };
+        std::vector<GetTask> get_tasks;
+        for (size_t list_task_idx = 0; list_task_idx < list_tasks.size(); ++list_task_idx)
+        {
+            auto & task = list_tasks[list_task_idx];
             context->getProcessListElement()->checkTimeLimit();
             auto list_result = task.future.get();
 
@@ -475,59 +484,60 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
 
             Strings nodes = std::move(list_result.names);
 
-            String path_part = task.path_corrected;
-            if (path_part == "/")
-                path_part.clear();
+            task.path_part = task.path_corrected;
+            if (task.path_part == "/")
+                task.path_part.clear();
 
             if (!task.prefix.empty())
             {
                 // Remove nodes that do not match specified prefix
-                std::erase_if(nodes, [&task, &path_part] (const String & node)
+                std::erase_if(nodes, [&task] (const String & node)
                 {
-                    return (path_part + '/' + node).substr(0, task.prefix.size()) != task.prefix;
+                    return (task.path_part + '/' + node).substr(0, task.prefix.size()) != task.prefix;
                 });
             }
 
-            std::vector<std::future<Coordination::GetResponse>> futures;
-            futures.reserve(nodes.size());
+            get_tasks.reserve(get_tasks.size() + nodes.size());
             for (const String & node : nodes)
-                futures.push_back(zookeeper->asyncTryGet(path_part + '/' + node));
+                get_tasks.emplace_back(GetTask{list_task_idx, node, zookeeper->asyncTryGet(task.path_part + '/' + node)});
+        }
 
-            for (size_t i = 0, size = nodes.size(); i < size; ++i)
+        for (size_t i = 0, size = get_tasks.size(); i < size; ++i)
+        {
+            auto & get_task = get_tasks[i];
+            auto & list_task = list_tasks[get_task.list_task_idx];
+            context->getProcessListElement()->checkTimeLimit();
+            auto res = get_task.future.get();
+            if (res.error == Coordination::Error::ZNONODE)
+                continue; /// Node was deleted meanwhile.
+
+            // Deduplication
+            String key = list_task.path_part + '/' + get_task.node;
+            if (auto [it, inserted] = added.emplace(key); !inserted)
+                continue;
+
+            const Coordination::Stat & stat = res.stat;
+
+            size_t col_num = 0;
+            res_columns[col_num++]->insert(get_task.node);
+            res_columns[col_num++]->insert(res.data);
+            res_columns[col_num++]->insert(stat.czxid);
+            res_columns[col_num++]->insert(stat.mzxid);
+            res_columns[col_num++]->insert(UInt64(stat.ctime / 1000));
+            res_columns[col_num++]->insert(UInt64(stat.mtime / 1000));
+            res_columns[col_num++]->insert(stat.version);
+            res_columns[col_num++]->insert(stat.cversion);
+            res_columns[col_num++]->insert(stat.aversion);
+            res_columns[col_num++]->insert(stat.ephemeralOwner);
+            res_columns[col_num++]->insert(stat.dataLength);
+            res_columns[col_num++]->insert(stat.numChildren);
+            res_columns[col_num++]->insert(stat.pzxid);
+            res_columns[col_num++]->insert(
+                list_task.path); /// This is the original path. In order to process the request, condition in WHERE should be triggered.
+
+            if (list_task.path_type != ZkPathType::Exact && res.stat.numChildren > 0)
             {
-                context->getProcessListElement()->checkTimeLimit();
-                auto res = futures[i].get();
-                if (res.error == Coordination::Error::ZNONODE)
-                    continue; /// Node was deleted meanwhile.
-
-                // Deduplication
-                String key = path_part + '/' + nodes[i];
-                if (auto [it, inserted] = added.emplace(key); !inserted)
-                    continue;
-
-                const Coordination::Stat & stat = res.stat;
-
-                size_t col_num = 0;
-                res_columns[col_num++]->insert(nodes[i]);
-                res_columns[col_num++]->insert(res.data);
-                res_columns[col_num++]->insert(stat.czxid);
-                res_columns[col_num++]->insert(stat.mzxid);
-                res_columns[col_num++]->insert(UInt64(stat.ctime / 1000));
-                res_columns[col_num++]->insert(UInt64(stat.mtime / 1000));
-                res_columns[col_num++]->insert(stat.version);
-                res_columns[col_num++]->insert(stat.cversion);
-                res_columns[col_num++]->insert(stat.aversion);
-                res_columns[col_num++]->insert(stat.ephemeralOwner);
-                res_columns[col_num++]->insert(stat.dataLength);
-                res_columns[col_num++]->insert(stat.numChildren);
-                res_columns[col_num++]->insert(stat.pzxid);
-                res_columns[col_num++]->insert(
-                    task.path); /// This is the original path. In order to process the request, condition in WHERE should be triggered.
-
-                if (task.path_type != ZkPathType::Exact && res.stat.numChildren > 0)
-                {
-                    paths.emplace_back(key, ZkPathType::Recurse);
-                }
+                paths.emplace_back(key, ZkPathType::Recurse);
             }
         }
     }

From ca298d66cbe7e6c22c4454f9d313c032e46c3796 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Thu, 8 Jun 2023 12:32:33 +0300
Subject: [PATCH 545/722] Sort block improvements

---
 src/Interpreters/sortBlock.cpp | 127 +++++++++++++++++++++++----------
 src/Interpreters/sortBlock.h   |  11 +--
 2 files changed, 92 insertions(+), 46 deletions(-)

diff --git a/src/Interpreters/sortBlock.cpp b/src/Interpreters/sortBlock.cpp
index 2ae5edc43b9..904841f8715 100644
--- a/src/Interpreters/sortBlock.cpp
+++ b/src/Interpreters/sortBlock.cpp
@@ -190,6 +190,78 @@ void getBlockSortPermutationImpl(const Block & block, const SortDescription & de
     }
 }
 
+bool isIdentityPermutation(const IColumn::Permutation & permutation)
+{
+    static_assert(sizeof(permutation[0]) == sizeof(UInt64), "Invalid permutation value size");
+
+    if (permutation.empty())
+        return true;
+
+    size_t size = permutation.size();
+    size_t i = 0;
+
+    if (size >= 8)
+    {
+        static constexpr UInt64 compare_all_elements_equal_mask = (1UL << 16) - 1;
+
+        __m128i permutation_add_vector = { 8, 8 };
+        __m128i permutation_compare_values_vectors[4] { { 0, 1 }, { 2, 3 }, { 4, 5 }, { 6, 7 } };
+
+        const UInt64 * permutation_data = static_cast<const UInt64 *>(permutation.data());
+
+        static constexpr size_t unroll_count = 8;
+        size_t size_unrolled = (size / unroll_count) * unroll_count;
+
+        for (; i < size_unrolled; i += 8)
+        {
+            UInt64 permutation_equals_vector_mask = compare_all_elements_equal_mask;
+
+            for (size_t j = 0; j < 4; ++j)
+            {
+                __m128i permutation_data_vector = _mm_loadu_si128(reinterpret_cast<const __m128i *>(permutation_data + i + j * 2));
+                __m128i permutation_equals_vector = _mm_cmpeq_epi64(permutation_data_vector, permutation_compare_values_vectors[j]);
+                permutation_compare_values_vectors[j] = _mm_add_epi64(permutation_compare_values_vectors[j], permutation_add_vector);
+                permutation_equals_vector_mask &= _mm_movemask_epi8(permutation_equals_vector);
+            }
+
+            if (permutation_equals_vector_mask != compare_all_elements_equal_mask)
+                return false;
+        }
+    }
+
+    for (; i < size; ++i)
+        if (permutation[i] != (permutation[i - 1] + 1))
+            return false;
+
+    return true;
+}
+
+template <typename Comparator>
+bool isAlreadySortedImpl(size_t rows, Comparator compare)
+{
+    /** If the rows are not too few, then let's make a quick attempt to verify that the block is not sorted.
+     * Constants - at random.
+     */
+    static constexpr size_t num_rows_to_try = 10;
+    if (rows > num_rows_to_try * 5)
+    {
+        for (size_t i = 1; i < num_rows_to_try; ++i)
+        {
+            size_t prev_position = rows * (i - 1) / num_rows_to_try;
+            size_t curr_position = rows * i / num_rows_to_try;
+
+            if (compare(curr_position, prev_position))
+                return false;
+        }
+    }
+
+    for (size_t i = 1; i < rows; ++i)
+        if (compare(i, i - 1))
+            return false;
+
+    return true;
+}
+
 }
 
 void sortBlock(Block & block, const SortDescription & description, UInt64 limit)
@@ -200,6 +272,9 @@ void sortBlock(Block & block, const SortDescription & description, UInt64 limit)
     if (permutation.empty())
         return;
 
+    if (isIdentityPermutation(permutation))
+        return;
+
     size_t columns = block.columns();
     for (size_t i = 0; i < columns; ++i)
     {
@@ -208,25 +283,6 @@ void sortBlock(Block & block, const SortDescription & description, UInt64 limit)
     }
 }
 
-void stableSortBlock(Block & block, const SortDescription & description)
-{
-    if (!block)
-        return;
-
-    IColumn::Permutation permutation;
-    getBlockSortPermutationImpl(block, description, IColumn::PermutationSortStability::Stable, 0, permutation);
-
-    if (permutation.empty())
-        return;
-
-    size_t columns = block.columns();
-    for (size_t i = 0; i < columns; ++i)
-    {
-        auto & column_to_sort = block.getByPosition(i).column;
-        column_to_sort = column_to_sort->permute(permutation, 0);
-    }
-}
-
 void stableGetPermutation(const Block & block, const SortDescription & description, IColumn::Permutation & out_permutation)
 {
     if (!block)
@@ -240,33 +296,28 @@ bool isAlreadySorted(const Block & block, const SortDescription & description)
     if (!block)
         return true;
 
-    size_t rows = block.rows();
-
     ColumnsWithSortDescriptions columns_with_sort_desc = getColumnsWithSortDescription(block, description);
+    bool is_collation_required = false;
 
-    PartialSortingLess less(columns_with_sort_desc);
-
-    /** If the rows are not too few, then let's make a quick attempt to verify that the block is not sorted.
-     * Constants - at random.
-     */
-    static constexpr size_t num_rows_to_try = 10;
-    if (rows > num_rows_to_try * 5)
+    for (auto & column_with_sort_desc : columns_with_sort_desc)
     {
-        for (size_t i = 1; i < num_rows_to_try; ++i)
+        if (isCollationRequired(column_with_sort_desc.description))
         {
-            size_t prev_position = rows * (i - 1) / num_rows_to_try;
-            size_t curr_position = rows * i / num_rows_to_try;
-
-            if (less(curr_position, prev_position))
-                return false;
+            is_collation_required = true;
+            break;
         }
     }
 
-    for (size_t i = 1; i < rows; ++i)
-        if (less(i, i - 1))
-            return false;
+    size_t rows = block.rows();
 
-    return true;
+    if (is_collation_required)
+    {
+        PartialSortingLessWithCollation less(columns_with_sort_desc);
+        return isAlreadySortedImpl(rows, less);
+    }
+
+    PartialSortingLess less(columns_with_sort_desc);
+    return isAlreadySortedImpl(rows, less);
 }
 
 }
diff --git a/src/Interpreters/sortBlock.h b/src/Interpreters/sortBlock.h
index 31ae78e90b0..3c82b4c7517 100644
--- a/src/Interpreters/sortBlock.h
+++ b/src/Interpreters/sortBlock.h
@@ -10,20 +10,15 @@ namespace DB
 /// Sort one block by `description`. If limit != 0, then the partial sort of the first `limit` rows is produced.
 void sortBlock(Block & block, const SortDescription & description, UInt64 limit = 0);
 
-/** Used only in StorageMergeTree to sort the data with INSERT.
+/** Same as sortBlock, but do not sort the block, but only calculate the permutation of the values,
+  *  so that you can rearrange the column values yourself.
   * Sorting is stable. This is important for keeping the order of rows in the CollapsingMergeTree engine
   *  - because based on the order of rows it is determined whether to delete or leave groups of rows when collapsing.
-  * Collations are not supported. Partial sorting is not supported.
-  */
-void stableSortBlock(Block & block, const SortDescription & description);
-
-/** Same as stableSortBlock, but do not sort the block, but only calculate the permutation of the values,
-  *  so that you can rearrange the column values yourself.
+  * Used only in StorageMergeTree to sort the data with INSERT.
   */
 void stableGetPermutation(const Block & block, const SortDescription & description, IColumn::Permutation & out_permutation);
 
 /** Quickly check whether the block is already sorted. If the block is not sorted - returns false as fast as possible.
-  * Collations are not supported.
   */
 bool isAlreadySorted(const Block & block, const SortDescription & description);
 

From 8d3212363e19d303c52335a24e319775264cc3bb Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Thu, 8 Jun 2023 22:19:54 +0300
Subject: [PATCH 546/722] Fixed tests

---
 src/Interpreters/sortBlock.cpp | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/Interpreters/sortBlock.cpp b/src/Interpreters/sortBlock.cpp
index 904841f8715..a41a71afcb0 100644
--- a/src/Interpreters/sortBlock.cpp
+++ b/src/Interpreters/sortBlock.cpp
@@ -5,6 +5,9 @@
 #include <Columns/ColumnTuple.h>
 #include <Functions/FunctionHelpers.h>
 
+#ifdef __SSE2__
+    #include <emmintrin.h>
+#endif
 
 namespace DB
 {
@@ -190,16 +193,17 @@ void getBlockSortPermutationImpl(const Block & block, const SortDescription & de
     }
 }
 
-bool isIdentityPermutation(const IColumn::Permutation & permutation)
+bool isIdentityPermutation(const IColumn::Permutation & permutation, size_t limit)
 {
     static_assert(sizeof(permutation[0]) == sizeof(UInt64), "Invalid permutation value size");
 
-    if (permutation.empty())
+    size_t size = limit == 0 ? permutation.size() : limit;
+    if (size == 0)
         return true;
 
-    size_t size = permutation.size();
     size_t i = 0;
 
+#if defined(__SSE2__)
     if (size >= 8)
     {
         static constexpr UInt64 compare_all_elements_equal_mask = (1UL << 16) - 1;
@@ -228,6 +232,7 @@ bool isIdentityPermutation(const IColumn::Permutation & permutation)
                 return false;
         }
     }
+#endif
 
     for (; i < size; ++i)
         if (permutation[i] != (permutation[i - 1] + 1))
@@ -272,7 +277,7 @@ void sortBlock(Block & block, const SortDescription & description, UInt64 limit)
     if (permutation.empty())
         return;
 
-    if (isIdentityPermutation(permutation))
+    if (isIdentityPermutation(permutation, limit))
         return;
 
     size_t columns = block.columns();

From 7d17a70d17afd9976d8305ab966d24dbb4ab4fe6 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Fri, 9 Jun 2023 10:44:22 +0300
Subject: [PATCH 547/722] Fixed tests

---
 src/Interpreters/sortBlock.cpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/src/Interpreters/sortBlock.cpp b/src/Interpreters/sortBlock.cpp
index a41a71afcb0..9ee7d9e644c 100644
--- a/src/Interpreters/sortBlock.cpp
+++ b/src/Interpreters/sortBlock.cpp
@@ -201,6 +201,9 @@ bool isIdentityPermutation(const IColumn::Permutation & permutation, size_t limi
     if (size == 0)
         return true;
 
+    if (permutation[0] != 0)
+        return false;
+
     size_t i = 0;
 
 #if defined(__SSE2__)
@@ -234,6 +237,7 @@ bool isIdentityPermutation(const IColumn::Permutation & permutation, size_t limi
     }
 #endif
 
+    i = std::max(i, static_cast<size_t>(1));
     for (; i < size; ++i)
         if (permutation[i] != (permutation[i - 1] + 1))
             return false;

From 2f3dce5fe686d9a711672f886f3b4206cf4a73d9 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sat, 10 Jun 2023 21:19:40 +0300
Subject: [PATCH 548/722] Fixed tests

---
 src/Interpreters/sortBlock.cpp | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/Interpreters/sortBlock.cpp b/src/Interpreters/sortBlock.cpp
index 9ee7d9e644c..5284fdc7f14 100644
--- a/src/Interpreters/sortBlock.cpp
+++ b/src/Interpreters/sortBlock.cpp
@@ -197,7 +197,8 @@ bool isIdentityPermutation(const IColumn::Permutation & permutation, size_t limi
 {
     static_assert(sizeof(permutation[0]) == sizeof(UInt64), "Invalid permutation value size");
 
-    size_t size = limit == 0 ? permutation.size() : limit;
+    size_t permutation_size = permutation.size();
+    size_t size = limit == 0 ? permutation_size : std::min(limit, permutation_size);
     if (size == 0)
         return true;
 
@@ -214,7 +215,7 @@ bool isIdentityPermutation(const IColumn::Permutation & permutation, size_t limi
         __m128i permutation_add_vector = { 8, 8 };
         __m128i permutation_compare_values_vectors[4] { { 0, 1 }, { 2, 3 }, { 4, 5 }, { 6, 7 } };
 
-        const UInt64 * permutation_data = static_cast<const UInt64 *>(permutation.data());
+        const size_t * permutation_data = permutation.data();
 
         static constexpr size_t unroll_count = 8;
         size_t size_unrolled = (size / unroll_count) * unroll_count;
@@ -281,14 +282,18 @@ void sortBlock(Block & block, const SortDescription & description, UInt64 limit)
     if (permutation.empty())
         return;
 
-    if (isIdentityPermutation(permutation, limit))
+    bool is_identity_permutation = isIdentityPermutation(permutation, limit);
+    if (is_identity_permutation && limit == 0)
         return;
 
     size_t columns = block.columns();
     for (size_t i = 0; i < columns; ++i)
     {
         auto & column_to_sort = block.getByPosition(i).column;
-        column_to_sort = column_to_sort->permute(permutation, limit);
+        if (is_identity_permutation)
+            column_to_sort = column_to_sort->cut(0, std::min(limit, permutation.size()));
+        else
+            column_to_sort = column_to_sort->permute(permutation, limit);
     }
 }
 

From 977cd65cfba43060fbb49b44d8248929b8782c22 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Wed, 14 Jun 2023 19:09:34 +0300
Subject: [PATCH 549/722] Fixed build

---
 src/Interpreters/sortBlock.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/sortBlock.cpp b/src/Interpreters/sortBlock.cpp
index 5284fdc7f14..6d8742f9d9e 100644
--- a/src/Interpreters/sortBlock.cpp
+++ b/src/Interpreters/sortBlock.cpp
@@ -291,7 +291,7 @@ void sortBlock(Block & block, const SortDescription & description, UInt64 limit)
     {
         auto & column_to_sort = block.getByPosition(i).column;
         if (is_identity_permutation)
-            column_to_sort = column_to_sort->cut(0, std::min(limit, permutation.size()));
+            column_to_sort = column_to_sort->cut(0, std::min(static_cast<size_t>(limit), permutation.size()));
         else
             column_to_sort = column_to_sort->permute(permutation, limit);
     }

From ce7cd67981b0d3b7d2bbfede7e616794c1371bab Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Sun, 18 Jun 2023 13:56:10 +0200
Subject: [PATCH 550/722] finalize CascadeWriteBuffer

---
 src/Disks/IO/WriteBufferFromTemporaryFile.cpp       |  2 +-
 .../tests/gtest_cascade_and_memory_write_buffer.cpp |  1 +
 src/IO/CascadeWriteBuffer.cpp                       |  2 ++
 src/IO/CascadeWriteBuffer.h                         |  2 ++
 src/IO/MemoryReadWriteBuffer.cpp                    |  2 ++
 src/IO/MemoryReadWriteBuffer.h                      |  6 ++++--
 src/Interpreters/Cache/WriteBufferToFileSegment.cpp | 12 ------------
 src/Interpreters/Cache/WriteBufferToFileSegment.h   |  2 --
 src/Server/HTTPHandler.cpp                          | 13 +++++++------
 .../MergeTree/MergeTreeBackgroundExecutor.cpp       |  3 ++-
 10 files changed, 21 insertions(+), 24 deletions(-)

diff --git a/src/Disks/IO/WriteBufferFromTemporaryFile.cpp b/src/Disks/IO/WriteBufferFromTemporaryFile.cpp
index 5818c405e93..5bfbb2fa440 100644
--- a/src/Disks/IO/WriteBufferFromTemporaryFile.cpp
+++ b/src/Disks/IO/WriteBufferFromTemporaryFile.cpp
@@ -46,7 +46,7 @@ public:
 ReadBufferPtr WriteBufferFromTemporaryFile::getReadBufferImpl()
 {
     /// ignore buffer, write all data to file and reread it
-    next();
+    finalize();
 
     auto res = ReadBufferFromTemporaryWriteBuffer::createFrom(this);
 
diff --git a/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp b/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp
index a24056a141f..0efaca94424 100644
--- a/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp
+++ b/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp
@@ -166,6 +166,7 @@ static void checkHTTPHandlerCase(size_t input_size, size_t memory_buffer_size)
             });
 
         cascade.write(src.data(), src.size());
+        cascade.finalize();
         EXPECT_EQ(cascade.count(), src.size());
     }
 
diff --git a/src/IO/CascadeWriteBuffer.cpp b/src/IO/CascadeWriteBuffer.cpp
index f0d98027609..f577c729815 100644
--- a/src/IO/CascadeWriteBuffer.cpp
+++ b/src/IO/CascadeWriteBuffer.cpp
@@ -56,6 +56,8 @@ void CascadeWriteBuffer::nextImpl()
 
 void CascadeWriteBuffer::getResultBuffers(WriteBufferPtrs & res)
 {
+    finalize();
+
     /// Sync position with underlying buffer before invalidating
     curr_buffer->position() = position();
 
diff --git a/src/IO/CascadeWriteBuffer.h b/src/IO/CascadeWriteBuffer.h
index 1059c5b8ddb..db491d79d81 100644
--- a/src/IO/CascadeWriteBuffer.h
+++ b/src/IO/CascadeWriteBuffer.h
@@ -47,6 +47,8 @@ public:
 
 private:
 
+    void finalizeImpl() override { /* no op */ }
+
     WriteBuffer * setNextBuffer();
 
     WriteBufferPtrs prepared_sources;
diff --git a/src/IO/MemoryReadWriteBuffer.cpp b/src/IO/MemoryReadWriteBuffer.cpp
index d6f89108561..415a6c6fadb 100644
--- a/src/IO/MemoryReadWriteBuffer.cpp
+++ b/src/IO/MemoryReadWriteBuffer.cpp
@@ -126,6 +126,8 @@ void MemoryWriteBuffer::addChunk()
 
 std::shared_ptr<ReadBuffer> MemoryWriteBuffer::getReadBufferImpl()
 {
+    finalize();
+
     auto res = std::make_shared<ReadBufferFromMemoryWriteBuffer>(std::move(*this));
 
     /// invalidate members
diff --git a/src/IO/MemoryReadWriteBuffer.h b/src/IO/MemoryReadWriteBuffer.h
index ee128c355c6..d6bf231c22b 100644
--- a/src/IO/MemoryReadWriteBuffer.h
+++ b/src/IO/MemoryReadWriteBuffer.h
@@ -30,12 +30,14 @@ public:
         double growth_rate_ = 2.0,
         size_t max_chunk_size_ = 128 * DBMS_DEFAULT_BUFFER_SIZE);
 
-    void nextImpl() override;
-
     ~MemoryWriteBuffer() override;
 
 protected:
 
+    void nextImpl() override;
+
+    void finalizeImpl() override { /* no op */ }
+
     std::shared_ptr<ReadBuffer> getReadBufferImpl() override;
 
     const size_t max_total_size;
diff --git a/src/Interpreters/Cache/WriteBufferToFileSegment.cpp b/src/Interpreters/Cache/WriteBufferToFileSegment.cpp
index 1eac87a804d..d50289a5728 100644
--- a/src/Interpreters/Cache/WriteBufferToFileSegment.cpp
+++ b/src/Interpreters/Cache/WriteBufferToFileSegment.cpp
@@ -71,16 +71,4 @@ std::shared_ptr<ReadBuffer> WriteBufferToFileSegment::getReadBufferImpl()
     return std::make_shared<ReadBufferFromFile>(file_segment->getPathInLocalCache());
 }
 
-WriteBufferToFileSegment::~WriteBufferToFileSegment()
-{
-    try
-    {
-        finalize();
-    }
-    catch (...)
-    {
-        tryLogCurrentException(__PRETTY_FUNCTION__);
-    }
-}
-
 }
diff --git a/src/Interpreters/Cache/WriteBufferToFileSegment.h b/src/Interpreters/Cache/WriteBufferToFileSegment.h
index 4d1e82996a3..d39772873f7 100644
--- a/src/Interpreters/Cache/WriteBufferToFileSegment.h
+++ b/src/Interpreters/Cache/WriteBufferToFileSegment.h
@@ -17,8 +17,6 @@ public:
 
     void nextImpl() override;
 
-    ~WriteBufferToFileSegment() override;
-
 private:
 
     std::shared_ptr<ReadBuffer> getReadBufferImpl() override;
diff --git a/src/Server/HTTPHandler.cpp b/src/Server/HTTPHandler.cpp
index e185b002c5b..fe98ae5f69e 100644
--- a/src/Server/HTTPHandler.cpp
+++ b/src/Server/HTTPHandler.cpp
@@ -289,14 +289,15 @@ void HTTPHandler::pushDelayedResults(Output & used_output)
 
     for (auto & write_buf : write_buffers)
     {
-        IReadableWriteBuffer * write_buf_concrete;
-        ReadBufferPtr reread_buf;
+        if (!write_buf)
+            continue;
 
-        if (write_buf
-            && (write_buf_concrete = dynamic_cast<IReadableWriteBuffer *>(write_buf.get()))
-            && (reread_buf = write_buf_concrete->tryGetReadBuffer()))
+        IReadableWriteBuffer * write_buf_concrete = dynamic_cast<IReadableWriteBuffer *>(write_buf.get());
+        if (write_buf_concrete)
         {
-            read_buffers.emplace_back(wrapReadBufferPointer(reread_buf));
+            ReadBufferPtr reread_buf = write_buf_concrete->tryGetReadBuffer();
+            if (reread_buf)
+                read_buffers.emplace_back(wrapReadBufferPointer(reread_buf));
         }
     }
 
diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index bbb3373ec07..bedc3d57091 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -290,7 +290,8 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
             catch (...)
             {
                 print_task_exception();
-                return on_task_done();
+                on_task_done();
+                return;
             }
         }
 

From a6dde6ab6249c49d9010846d79146b17f500181e Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 18 Jun 2023 20:38:25 +0200
Subject: [PATCH 551/722] Print changed settings on fatal errors

---
 src/Daemon/BaseDaemon.cpp | 167 +++++++++++++++++++++++++-------------
 1 file changed, 109 insertions(+), 58 deletions(-)

diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index 4dd6809d726..a7b10478e16 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -42,6 +42,7 @@
 #include <IO/ReadBufferFromFileDescriptor.h>
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
+#include <IO/Operators.h>
 #include <Common/Exception.h>
 #include <Common/PipeFDs.h>
 #include <Common/StackTrace.h>
@@ -54,6 +55,8 @@
 #include <Common/Elf.h>
 #include <Common/setThreadName.h>
 #include <Common/logger_useful.h>
+#include <Common/FieldVisitorToString.h>
+#include <Interpreters/Context.h>
 #include <filesystem>
 
 #include <Loggers/OwnFormattingChannel.h>
@@ -80,7 +83,9 @@ namespace DB
     }
 }
 
-DB::PipeFDs signal_pipe;
+using namespace DB;
+
+PipeFDs signal_pipe;
 
 
 /** Reset signal handler to the default and send signal to itself.
@@ -89,10 +94,10 @@ DB::PipeFDs signal_pipe;
 static void call_default_signal_handler(int sig)
 {
     if (SIG_ERR == signal(sig, SIG_DFL))
-        DB::throwFromErrno("Cannot set signal handler.", DB::ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
+        throwFromErrno("Cannot set signal handler.", ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
 
     if (0 != raise(sig))
-        DB::throwFromErrno("Cannot send signal.", DB::ErrorCodes::CANNOT_SEND_SIGNAL);
+        throwFromErrno("Cannot send signal.", ErrorCodes::CANNOT_SEND_SIGNAL);
 }
 
 static const size_t signal_pipe_buf_size =
@@ -110,8 +115,8 @@ static void writeSignalIDtoSignalPipe(int sig)
     auto saved_errno = errno;   /// We must restore previous value of errno in signal handler.
 
     char buf[signal_pipe_buf_size];
-    DB::WriteBufferFromFileDescriptor out(signal_pipe.fds_rw[1], signal_pipe_buf_size, buf);
-    DB::writeBinary(sig, out);
+    WriteBufferFromFileDescriptor out(signal_pipe.fds_rw[1], signal_pipe_buf_size, buf);
+    writeBinary(sig, out);
     out.next();
 
     errno = saved_errno;
@@ -141,17 +146,17 @@ static void signalHandler(int sig, siginfo_t * info, void * context)
     auto saved_errno = errno;   /// We must restore previous value of errno in signal handler.
 
     char buf[signal_pipe_buf_size];
-    DB::WriteBufferFromFileDescriptorDiscardOnFailure out(signal_pipe.fds_rw[1], signal_pipe_buf_size, buf);
+    WriteBufferFromFileDescriptorDiscardOnFailure out(signal_pipe.fds_rw[1], signal_pipe_buf_size, buf);
 
     const ucontext_t * signal_context = reinterpret_cast<ucontext_t *>(context);
     const StackTrace stack_trace(*signal_context);
 
-    DB::writeBinary(sig, out);
-    DB::writePODBinary(*info, out);
-    DB::writePODBinary(signal_context, out);
-    DB::writePODBinary(stack_trace, out);
-    DB::writeBinary(static_cast<UInt32>(getThreadId()), out);
-    DB::writePODBinary(DB::current_thread, out);
+    writeBinary(sig, out);
+    writePODBinary(*info, out);
+    writePODBinary(signal_context, out);
+    writePODBinary(stack_trace, out);
+    writeBinary(static_cast<UInt32>(getThreadId()), out);
+    writePODBinary(current_thread, out);
 
     out.next();
 
@@ -203,12 +208,12 @@ public:
         static_assert(PIPE_BUF >= 512);
         static_assert(signal_pipe_buf_size <= PIPE_BUF, "Only write of PIPE_BUF to pipe is atomic and the minimal known PIPE_BUF across supported platforms is 512");
         char buf[signal_pipe_buf_size];
-        DB::ReadBufferFromFileDescriptor in(signal_pipe.fds_rw[0], signal_pipe_buf_size, buf);
+        ReadBufferFromFileDescriptor in(signal_pipe.fds_rw[0], signal_pipe_buf_size, buf);
 
         while (!in.eof())
         {
             int sig = 0;
-            DB::readBinary(sig, in);
+            readBinary(sig, in);
             // We may log some specific signals afterwards, with different log
             // levels and more info, but for completeness we log all signals
             // here at trace level.
@@ -231,8 +236,8 @@ public:
                 UInt32 thread_num;
                 std::string message;
 
-                DB::readBinary(thread_num, in);
-                DB::readBinary(message, in);
+                readBinary(thread_num, in);
+                readBinary(message, in);
 
                 onTerminate(message, thread_num);
             }
@@ -248,17 +253,17 @@ public:
                 ucontext_t * context{};
                 StackTrace stack_trace(NoCapture{});
                 UInt32 thread_num{};
-                DB::ThreadStatus * thread_ptr{};
+                ThreadStatus * thread_ptr{};
 
                 if (sig != SanitizerTrap)
                 {
-                    DB::readPODBinary(info, in);
-                    DB::readPODBinary(context, in);
+                    readPODBinary(info, in);
+                    readPODBinary(context, in);
                 }
 
-                DB::readPODBinary(stack_trace, in);
-                DB::readBinary(thread_num, in);
-                DB::readPODBinary(thread_ptr, in);
+                readPODBinary(stack_trace, in);
+                readBinary(thread_num, in);
+                readPODBinary(thread_ptr, in);
 
                 /// This allows to receive more signals if failure happens inside onFault function.
                 /// Example: segfault while symbolizing stack trace.
@@ -298,9 +303,9 @@ private:
         ucontext_t * context,
         const StackTrace & stack_trace,
         UInt32 thread_num,
-        DB::ThreadStatus * thread_ptr) const
+        ThreadStatus * thread_ptr) const
     {
-        DB::ThreadStatus thread_status;
+        ThreadStatus thread_status;
 
         String query_id;
         String query;
@@ -314,7 +319,7 @@ private:
 
             if (auto logs_queue = thread_ptr->getInternalTextLogsQueue())
             {
-                DB::CurrentThread::attachInternalTextLogsQueue(logs_queue, DB::LogsLevel::trace);
+                CurrentThread::attachInternalTextLogsQueue(logs_queue, LogsLevel::trace);
             }
         }
 
@@ -358,12 +363,12 @@ private:
             /// NOTE: This still require memory allocations and mutex lock inside logger.
             ///       BTW we can also print it to stderr using write syscalls.
 
-            DB::WriteBufferFromOwnString bare_stacktrace;
-            DB::writeString("Stack trace:", bare_stacktrace);
+            WriteBufferFromOwnString bare_stacktrace;
+            writeString("Stack trace:", bare_stacktrace);
             for (size_t i = stack_trace.getOffset(); i < stack_trace.getSize(); ++i)
             {
-                DB::writeChar(' ', bare_stacktrace);
-                DB::writePointerHex(stack_trace.getFramePointers()[i], bare_stacktrace);
+                writeChar(' ', bare_stacktrace);
+                writePointerHex(stack_trace.getFramePointers()[i], bare_stacktrace);
             }
 
             LOG_FATAL(log, fmt::runtime(bare_stacktrace.str()));
@@ -411,8 +416,54 @@ private:
 
         /// Send crash report to developers (if configured)
         if (sig != SanitizerTrap)
+        {
             SentryWriter::onFault(sig, error_message, stack_trace);
 
+            /// Advice the user to send it manually.
+            if constexpr (std::string_view(VERSION_OFFICIAL).contains("official build"))
+            {
+                const auto & date_lut = DateLUT::instance();
+
+                /// Approximate support period, upper bound.
+                if (time(nullptr) - date_lut.makeDate(2000 + VERSION_MAJOR, VERSION_MINOR, 1) < (365 + 30) * 86400)
+                {
+                    LOG_FATAL(log, "Report this error to https://github.com/ClickHouse/ClickHouse/issues");
+                }
+                else
+                {
+                    LOG_FATAL(log, "ClickHouse version {} is old and should be upgraded to the latest version.", VERSION_STRING);
+                }
+            }
+            else
+            {
+                LOG_FATAL(log, "This ClickHouse version is not official and should be upgraded to the official build.");
+            }
+        }
+
+        /// List changed settings.
+        if (!query_id.empty())
+        {
+            ContextPtr query_context = thread_ptr->getQueryContext();
+            if (query_context)
+            {
+                WriteBufferFromOwnString out;
+                const Settings & query_settings = query_context->getSettingsRef();
+                bool first = true;
+                for (const auto & setting : query_settings.allChanged())
+                {
+                    if (!first)
+                        out << ", ";
+                    out << setting.getName() << " = " << applyVisitor(FieldVisitorToString(), setting.getValue());
+                    first = false;
+                }
+
+                if (first)
+                    LOG_FATAL(log, "No settings were changed");
+                else
+                    LOG_FATAL(log, "Changed settings: {}", out.str());
+            }
+        }
+
         /// When everything is done, we will try to send these error messages to client.
         if (thread_ptr)
             thread_ptr->onFatalError();
@@ -436,15 +487,15 @@ static DISABLE_SANITIZER_INSTRUMENTATION void sanitizerDeathCallback()
     /// Also need to send data via pipe. Otherwise it may lead to deadlocks or failures in printing diagnostic info.
 
     char buf[signal_pipe_buf_size];
-    DB::WriteBufferFromFileDescriptorDiscardOnFailure out(signal_pipe.fds_rw[1], signal_pipe_buf_size, buf);
+    WriteBufferFromFileDescriptorDiscardOnFailure out(signal_pipe.fds_rw[1], signal_pipe_buf_size, buf);
 
     const StackTrace stack_trace;
 
     int sig = SignalListener::SanitizerTrap;
-    DB::writeBinary(sig, out);
-    DB::writePODBinary(stack_trace, out);
-    DB::writeBinary(UInt32(getThreadId()), out);
-    DB::writePODBinary(DB::current_thread, out);
+    writeBinary(sig, out);
+    writePODBinary(stack_trace, out);
+    writeBinary(UInt32(getThreadId()), out);
+    writePODBinary(current_thread, out);
 
     out.next();
 
@@ -470,7 +521,7 @@ static DISABLE_SANITIZER_INSTRUMENTATION void sanitizerDeathCallback()
     std::string log_message;
 
     if (std::current_exception())
-        log_message = "Terminate called for uncaught exception:\n" + DB::getCurrentExceptionMessage(true);
+        log_message = "Terminate called for uncaught exception:\n" + getCurrentExceptionMessage(true);
     else
         log_message = "Terminate called without an active exception";
 
@@ -482,11 +533,11 @@ static DISABLE_SANITIZER_INSTRUMENTATION void sanitizerDeathCallback()
         log_message.resize(buf_size - 16);
 
     char buf[buf_size];
-    DB::WriteBufferFromFileDescriptor out(signal_pipe.fds_rw[1], buf_size, buf);
+    WriteBufferFromFileDescriptor out(signal_pipe.fds_rw[1], buf_size, buf);
 
-    DB::writeBinary(static_cast<int>(SignalListener::StdTerminate), out);
-    DB::writeBinary(static_cast<UInt32>(getThreadId()), out);
-    DB::writeBinary(log_message, out);
+    writeBinary(static_cast<int>(SignalListener::StdTerminate), out);
+    writeBinary(static_cast<UInt32>(getThreadId()), out);
+    writeBinary(log_message, out);
     out.next();
 
     abort();
@@ -512,7 +563,7 @@ static bool tryCreateDirectories(Poco::Logger * logger, const std::string & path
     }
     catch (...)
     {
-        LOG_WARNING(logger, "{}: when creating {}, {}", __PRETTY_FUNCTION__, path, DB::getCurrentExceptionMessage(true));
+        LOG_WARNING(logger, "{}: when creating {}, {}", __PRETTY_FUNCTION__, path, getCurrentExceptionMessage(true));
     }
     return false;
 }
@@ -527,7 +578,7 @@ void BaseDaemon::reloadConfiguration()
       * (It's convenient to log in console when you start server without any command line parameters.)
       */
     config_path = config().getString("config-file", getDefaultConfigFileName());
-    DB::ConfigProcessor config_processor(config_path, false, true);
+    ConfigProcessor config_processor(config_path, false, true);
     config_processor.setConfigPath(fs::path(config_path).parent_path());
     loaded_config = config_processor.loadConfig(/* allow_zk_includes = */ true);
 
@@ -548,7 +599,7 @@ BaseDaemon::~BaseDaemon()
     /// Reset signals to SIG_DFL to avoid trying to write to the signal_pipe that will be closed after.
     for (int sig : handled_signals)
         if (SIG_ERR == signal(sig, SIG_DFL))
-            DB::throwFromErrno("Cannot set signal handler.", DB::ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
+            throwFromErrno("Cannot set signal handler.", ErrorCodes::CANNOT_SET_SIGNAL_HANDLER);
     signal_pipe.close();
 }
 
@@ -592,7 +643,7 @@ void BaseDaemon::closeFDs()
         /// Iterate directory separately from closing fds to avoid closing iterated directory fd.
         std::vector<int> fds;
         for (const auto & path : fs::directory_iterator(proc_path))
-            fds.push_back(DB::parse<int>(path.path().filename()));
+            fds.push_back(parse<int>(path.path().filename()));
 
         for (const auto & fd : fds)
         {
@@ -662,7 +713,7 @@ void BaseDaemon::initialize(Application & self)
     }
     umask(umask_num);
 
-    DB::ConfigProcessor(config_path).savePreprocessedConfig(loaded_config, "");
+    ConfigProcessor(config_path).savePreprocessedConfig(loaded_config, "");
 
     /// Write core dump on crash.
     {
@@ -713,12 +764,12 @@ void BaseDaemon::initialize(Application & self)
         ///     {
         ///         try
         ///         {
-        ///             DB::SomeApp app;
+        ///             SomeApp app;
         ///             return app.run(argc, argv);
         ///         }
         ///         catch (...)
         ///         {
-        ///             std::cerr << DB::getCurrentExceptionMessage(true) << "\n";
+        ///             std::cerr << getCurrentExceptionMessage(true) << "\n";
         ///             return 1;
         ///         }
         ///     }
@@ -772,7 +823,7 @@ void BaseDaemon::initialize(Application & self)
 
     /// Create pid file.
     if (config().has("pid"))
-        pid_file.emplace(config().getString("pid"), DB::StatusFile::write_pid);
+        pid_file.emplace(config().getString("pid"), StatusFile::write_pid);
 
     if (is_daemon)
     {
@@ -799,7 +850,7 @@ void BaseDaemon::initialize(Application & self)
     initializeTerminationAndSignalProcessing();
     logRevision();
 
-    for (const auto & key : DB::getMultipleKeysFromConfig(config(), "", "graphite"))
+    for (const auto & key : getMultipleKeysFromConfig(config(), "", "graphite"))
     {
         graphite_writers.emplace(key, std::make_unique<GraphiteWriter>(key));
     }
@@ -887,7 +938,7 @@ void BaseDaemon::initializeTerminationAndSignalProcessing()
     signal_listener_thread.start(*signal_listener);
 
 #if defined(__ELF__) && !defined(OS_FREEBSD)
-    String build_id_hex = DB::SymbolIndex::instance()->getBuildIDHex();
+    String build_id_hex = SymbolIndex::instance()->getBuildIDHex();
     if (build_id_hex.empty())
         build_id = "";
     else
@@ -902,7 +953,7 @@ void BaseDaemon::initializeTerminationAndSignalProcessing()
     std::string executable_path = getExecutablePath();
 
     if (!executable_path.empty())
-        stored_binary_hash = DB::Elf(executable_path).getStoredBinaryHash();
+        stored_binary_hash = Elf(executable_path).getStoredBinaryHash();
 #endif
 }
 
@@ -963,7 +1014,7 @@ void BaseDaemon::handleSignal(int signal_id)
         onInterruptSignals(signal_id);
     }
     else
-        throw DB::Exception::createDeprecated(std::string("Unsupported signal: ") + strsignal(signal_id), 0); // NOLINT(concurrency-mt-unsafe) // it is not thread-safe but ok in this context
+        throw Exception::createDeprecated(std::string("Unsupported signal: ") + strsignal(signal_id), 0); // NOLINT(concurrency-mt-unsafe) // it is not thread-safe but ok in this context
 }
 
 void BaseDaemon::onInterruptSignals(int signal_id)
@@ -1020,7 +1071,7 @@ void BaseDaemon::setupWatchdog()
         pid = fork();
 
         if (-1 == pid)
-            DB::throwFromErrno("Cannot fork", DB::ErrorCodes::SYSTEM_ERROR);
+            throwFromErrno("Cannot fork", ErrorCodes::SYSTEM_ERROR);
 
         if (0 == pid)
         {
@@ -1073,13 +1124,13 @@ void BaseDaemon::setupWatchdog()
                 pf = new OwnJSONPatternFormatter(config());
             else
                 pf = new OwnPatternFormatter;
-            Poco::AutoPtr<DB::OwnFormattingChannel> log = new DB::OwnFormattingChannel(pf, new Poco::ConsoleChannel(std::cerr));
+            Poco::AutoPtr<OwnFormattingChannel> log = new OwnFormattingChannel(pf, new Poco::ConsoleChannel(std::cerr));
             logger().setChannel(log);
         }
 
         /// Cuncurrent writing logs to the same file from two threads is questionable on its own,
         ///  but rotating them from two threads is disastrous.
-        if (auto * channel = dynamic_cast<DB::OwnSplitChannel *>(logger().getChannel()))
+        if (auto * channel = dynamic_cast<OwnSplitChannel *>(logger().getChannel()))
         {
             channel->setChannelProperty("log", Poco::FileChannel::PROP_ROTATION, "never");
             channel->setChannelProperty("log", Poco::FileChannel::PROP_ROTATEONOPEN, "false");
@@ -1191,7 +1242,7 @@ void systemdNotify(const std::string_view & command)
     int s = socket(AF_UNIX, SOCK_DGRAM | SOCK_CLOEXEC, 0);
 
     if (s == -1)
-        DB::throwFromErrno("Can't create UNIX socket for systemd notify.", DB::ErrorCodes::SYSTEM_ERROR);
+        throwFromErrno("Can't create UNIX socket for systemd notify.", ErrorCodes::SYSTEM_ERROR);
 
     SCOPE_EXIT({ close(s); });
 
@@ -1202,7 +1253,7 @@ void systemdNotify(const std::string_view & command)
     addr.sun_family = AF_UNIX;
 
     if (len < 2 || len > sizeof(addr.sun_path) - 1)
-        throw DB::Exception(DB::ErrorCodes::SYSTEM_ERROR, "NOTIFY_SOCKET env var value \"{}\" is wrong.", path);
+        throw Exception(ErrorCodes::SYSTEM_ERROR, "NOTIFY_SOCKET env var value \"{}\" is wrong.", path);
 
     memcpy(addr.sun_path, path, len + 1); /// write last zero as well.
 
@@ -1214,7 +1265,7 @@ void systemdNotify(const std::string_view & command)
     else if (path[0] == '/')
         addrlen += 1; /// non-abstract-addresses should be zero terminated.
     else
-        throw DB::Exception(DB::ErrorCodes::SYSTEM_ERROR, "Wrong UNIX path \"{}\" in NOTIFY_SOCKET env var", path);
+        throw Exception(ErrorCodes::SYSTEM_ERROR, "Wrong UNIX path \"{}\" in NOTIFY_SOCKET env var", path);
 
     const struct sockaddr *sock_addr = reinterpret_cast <const struct sockaddr *>(&addr);
 
@@ -1227,7 +1278,7 @@ void systemdNotify(const std::string_view & command)
             if (errno == EINTR)
                 continue;
             else
-                DB::throwFromErrno("Failed to notify systemd, sendto returned error.", DB::ErrorCodes::SYSTEM_ERROR);
+                throwFromErrno("Failed to notify systemd, sendto returned error.", ErrorCodes::SYSTEM_ERROR);
         }
         else
             sent_bytes_total += sent_bytes;

From b19b87a3e5b83a7adbbe4541f73e007e446afc2f Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 18 Jun 2023 20:42:27 +0200
Subject: [PATCH 552/722] Whitespaces

---
 src/Access/ContextAccess.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Access/ContextAccess.cpp b/src/Access/ContextAccess.cpp
index 04756162b46..0d28edc0a10 100644
--- a/src/Access/ContextAccess.cpp
+++ b/src/Access/ContextAccess.cpp
@@ -333,7 +333,7 @@ void ContextAccess::calculateAccessRights() const
                 boost::algorithm::join(roles_info->getCurrentRolesNames(), ", "),
                 boost::algorithm::join(roles_info->getEnabledRolesNames(), ", "));
         }
-        LOG_TRACE(trace_log, "Settings: readonly={}, allow_ddl={}, allow_introspection_functions={}", params.readonly, params.allow_ddl, params.allow_introspection);
+        LOG_TRACE(trace_log, "Settings: readonly = {}, allow_ddl = {}, allow_introspection_functions = {}", params.readonly, params.allow_ddl, params.allow_introspection);
         LOG_TRACE(trace_log, "List of all grants: {}", access->toString());
         LOG_TRACE(trace_log, "List of all grants including implicit: {}", access_with_implicit->toString());
     }

From 2bbfa279ec043de84c0cb222d6aa8c90983401bc Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Sun, 18 Jun 2023 20:54:40 +0200
Subject: [PATCH 553/722] fix gtest_lru_file_cache, fix remove from pending

---
 .../tests/gtest_lru_file_cache.cpp            |  10 ++
 .../MergeTree/MergeTreeBackgroundExecutor.cpp | 112 ++++++++++--------
 2 files changed, 71 insertions(+), 51 deletions(-)

diff --git a/src/Interpreters/tests/gtest_lru_file_cache.cpp b/src/Interpreters/tests/gtest_lru_file_cache.cpp
index 8c8e715ce92..3cba1e48e1e 100644
--- a/src/Interpreters/tests/gtest_lru_file_cache.cpp
+++ b/src/Interpreters/tests/gtest_lru_file_cache.cpp
@@ -141,6 +141,15 @@ void increasePriority(const HolderPtr & holder)
 class FileCacheTest : public ::testing::Test
 {
 public:
+    FileCacheTest() {
+        /// Context has to be created before calling cache.initialize();
+        /// Otherwise the tests which run before FileCacheTest.get are failed
+        /// It is logical to call destroyContext() at destructor.
+        /// But that wouldn't work because for proper initialization and destruction global/static objects
+        /// testing::Environment has to be used.
+        getContext();
+    }
+
     static void setupLogs(const std::string & level)
     {
         Poco::AutoPtr<Poco::ConsoleChannel> channel(new Poco::ConsoleChannel(std::cerr));
@@ -686,6 +695,7 @@ TEST_F(FileCacheTest, writeBuffer)
         }
         for (auto & t : threads)
             t.join();
+        out.finalize();
         return holder;
     };
 
diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index bedc3d57091..a84843300fb 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -136,6 +136,36 @@ bool MergeTreeBackgroundExecutor<Queue>::trySchedule(ExecutableTaskPtr task)
     return true;
 }
 
+void print_exception_with_respect_to_abort(Poco::Logger * log)
+{
+    std::exception_ptr ex = std::current_exception();
+
+    if (ex == nullptr)
+        return;
+
+    try
+    {
+        std::rethrow_exception(ex);
+    }
+    catch (const Exception & e)
+    {
+        NOEXCEPT_SCOPE({
+            ALLOW_ALLOCATIONS_IN_SCOPE;
+            /// Cancelled merging parts is not an error - log as info.
+            if (e.code() == ErrorCodes::ABORTED)
+                LOG_INFO(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
+            else
+                tryLogCurrentException(__PRETTY_FUNCTION__);
+        });
+    }
+    catch (...)
+    {
+        NOEXCEPT_SCOPE({
+            ALLOW_ALLOCATIONS_IN_SCOPE;
+            tryLogCurrentException(__PRETTY_FUNCTION__);
+        });
+    }
+}
 
 template <class Queue>
 void MergeTreeBackgroundExecutor<Queue>::removeTasksCorrespondingToStorage(StorageID id)
@@ -145,7 +175,16 @@ void MergeTreeBackgroundExecutor<Queue>::removeTasksCorrespondingToStorage(Stora
         std::lock_guard lock(mutex);
 
         /// Erase storage related tasks from pending and select active tasks to wait for
-        pending.remove(id);
+        try
+        {
+            /// An exception context is needed to proper delete write buffers without finalization
+            throw Exception(ErrorCodes::ABORTED, "Storage is about to be deleted. Done pending task as if it was aborted.");
+        }
+        catch (...)
+        {
+            print_exception_with_respect_to_abort(log);
+            pending.remove(id);
+        }
 
         /// Copy items to wait for their completion
         std::copy_if(active.begin(), active.end(), std::back_inserter(tasks_to_wait),
@@ -163,7 +202,6 @@ void MergeTreeBackgroundExecutor<Queue>::removeTasksCorrespondingToStorage(Stora
     }
 }
 
-
 template <class Queue>
 void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
 {
@@ -172,39 +210,12 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
 
     /// All operations with queues are considered no to do any allocations
 
-    auto erase_from_active = [this, &item]() TSA_REQUIRES(mutex)
+    auto erase_from_active = [this](TaskRuntimeDataPtr & item_) TSA_REQUIRES(mutex)
     {
-        active.erase(std::remove(active.begin(), active.end(), item), active.end());
+        active.erase(std::remove(active.begin(), active.end(), item_), active.end());
     };
 
-    auto print_task_exception = [&]()
-    {
-        std::exception_ptr ex = std::current_exception();
-        try
-        {
-            std::rethrow_exception(ex);
-        }
-        catch (const Exception & e)
-        {
-            NOEXCEPT_SCOPE({
-                ALLOW_ALLOCATIONS_IN_SCOPE;
-                /// Cancelled merging parts is not an error - log as info.
-                if (e.code() == ErrorCodes::ABORTED)
-                    LOG_INFO(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
-                else
-                    tryLogCurrentException(__PRETTY_FUNCTION__);
-            });
-        }
-        catch (...)
-        {
-            NOEXCEPT_SCOPE({
-                ALLOW_ALLOCATIONS_IN_SCOPE;
-                tryLogCurrentException(__PRETTY_FUNCTION__);
-            });
-        }
-    };
-
-    auto on_task_done = [&]() TSA_REQUIRES(mutex)
+    auto on_task_done = [] (TaskRuntimeDataPtr && item_) TSA_REQUIRES(mutex)
     {
         /// We have to call reset() under a lock, otherwise a race is possible.
         /// Imagine, that task is finally completed (last execution returned false),
@@ -213,28 +224,27 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
         /// So, the destructor of a task and the destructor of a storage will be executed concurrently.
         NOEXCEPT_SCOPE({
             ALLOW_ALLOCATIONS_IN_SCOPE;
-            item->task.reset();
+            item_->task.reset();
         });
-        item->is_done.set();
-        item = nullptr;
+        item_->is_done.set();
+        item_.reset();
     };
 
-    auto on_task_restart = [&]() TSA_REQUIRES(mutex)
+    auto on_task_restart = [this](TaskRuntimeDataPtr && item_) TSA_REQUIRES(mutex)
     {
         /// After the `guard` destruction `item` has to be in moved from state
         /// Not to own the object it points to.
         /// Otherwise the destruction of the task won't be ordered with the destruction of the
         /// storage.
-        pending.push(std::move(item));
+        pending.push(std::move(item_));
         has_tasks.notify_one();
-        item = nullptr;
-        return;
     };
 
-    auto release_task = [&]()
+    auto release_task = [this, &erase_from_active, &on_task_done](TaskRuntimeDataPtr && item_)
     {
         std::lock_guard guard(mutex);
-        erase_from_active();
+
+        erase_from_active(item_);
         has_tasks.notify_one();
 
         try
@@ -243,14 +253,14 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
             /// In a situation of a lack of memory this method can throw an exception,
             /// because it may interact somehow with BackgroundSchedulePool, which may allocate memory
             /// But it is rather safe, because we have try...catch block here, and another one in ThreadPool.
-            item->task->onCompleted();
+            item_->task->onCompleted();
         }
         catch (...)
         {
-            print_task_exception();
+            print_exception_with_respect_to_abort(log);
         }
 
-        return on_task_done();
+        on_task_done(std::move(item_));
     };
 
     bool need_execute_again = false;
@@ -262,22 +272,22 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
     }
     catch (...)
     {
-        print_task_exception();
+        print_exception_with_respect_to_abort(log);
         /// Release the task with exception context.
         /// An exception context is needed to proper delete write buffers without finalization
-        release_task();
+        release_task(std::move(item));
         return;
     }
 
     if (!need_execute_again)
     {
-        release_task();
+        release_task(std::move(item));
         return;
     }
 
     {
         std::lock_guard guard(mutex);
-        erase_from_active();
+        erase_from_active(item);
 
         if (item->is_currently_deleting)
         {
@@ -289,13 +299,13 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
             }
             catch (...)
             {
-                print_task_exception();
-                on_task_done();
+                print_exception_with_respect_to_abort(log);
+                on_task_done(std::move(item));
                 return;
             }
         }
 
-        on_task_restart();
+        on_task_restart(std::move(item));
     }
 }
 

From 9ae4915655f8363836654c1800f20b247e559c1f Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Sun, 18 Jun 2023 21:08:37 +0200
Subject: [PATCH 554/722] Code simplification

---
 src/Core/BaseSettings.h   | 16 ++++++++++------
 src/Daemon/BaseDaemon.cpp | 17 +++--------------
 2 files changed, 13 insertions(+), 20 deletions(-)

diff --git a/src/Core/BaseSettings.h b/src/Core/BaseSettings.h
index a14cec9cc7d..75b13304326 100644
--- a/src/Core/BaseSettings.h
+++ b/src/Core/BaseSettings.h
@@ -2,6 +2,8 @@
 
 #include <Core/SettingsFields.h>
 #include <Common/SettingsChanges.h>
+#include <Common/FieldVisitorToString.h>
+#include <IO/Operators.h>
 #include <base/range.h>
 #include <boost/blank.hpp>
 #include <unordered_map>
@@ -547,14 +549,16 @@ void BaseSettings<TTraits>::read(ReadBuffer & in, SettingsWriteFormat format)
 template <typename TTraits>
 String BaseSettings<TTraits>::toString() const
 {
-    String res;
-    for (const auto & field : *this)
+    WriteBufferFromOwnString out;
+    bool first = true;
+    for (const auto & setting : *this)
     {
-        if (!res.empty())
-            res += ", ";
-        res += field.getName() + " = " + field.getValueString();
+        if (!first)
+            out << ", ";
+        out << setting.getName() << " = " << applyVisitor(FieldVisitorToString(), setting.getValue());
+        first = false;
     }
-    return res;
+    return out.str();
 }
 
 template <typename TTraits>
diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index a7b10478e16..3a09e9df04a 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -42,7 +42,6 @@
 #include <IO/ReadBufferFromFileDescriptor.h>
 #include <IO/ReadHelpers.h>
 #include <IO/WriteHelpers.h>
-#include <IO/Operators.h>
 #include <Common/Exception.h>
 #include <Common/PipeFDs.h>
 #include <Common/StackTrace.h>
@@ -55,7 +54,6 @@
 #include <Common/Elf.h>
 #include <Common/setThreadName.h>
 #include <Common/logger_useful.h>
-#include <Common/FieldVisitorToString.h>
 #include <Interpreters/Context.h>
 #include <filesystem>
 
@@ -446,21 +444,12 @@ private:
             ContextPtr query_context = thread_ptr->getQueryContext();
             if (query_context)
             {
-                WriteBufferFromOwnString out;
-                const Settings & query_settings = query_context->getSettingsRef();
-                bool first = true;
-                for (const auto & setting : query_settings.allChanged())
-                {
-                    if (!first)
-                        out << ", ";
-                    out << setting.getName() << " = " << applyVisitor(FieldVisitorToString(), setting.getValue());
-                    first = false;
-                }
+                String changed_settings = query_context->getSettingsRef().toString();
 
-                if (first)
+                if (changed_settings.empty())
                     LOG_FATAL(log, "No settings were changed");
                 else
-                    LOG_FATAL(log, "Changed settings: {}", out.str());
+                    LOG_FATAL(log, "Changed settings: {}", changed_settings);
             }
         }
 

From e3f892f84a1df71723c03e042bc9962336929675 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 19 Jun 2023 00:10:42 +0200
Subject: [PATCH 555/722] fix gtest with MemoryWriteBuffer, do not mute
 exception in ReplicatedMergeMutateTaskBase

---
 src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp | 1 +
 src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp    | 2 +-
 src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.cpp  | 4 +++-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp b/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp
index 0efaca94424..16acd109c27 100644
--- a/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp
+++ b/src/Disks/tests/gtest_cascade_and_memory_write_buffer.cpp
@@ -223,6 +223,7 @@ TEST(MemoryWriteBuffer, WriteAndReread)
         {
             MemoryWriteBuffer buf(s - 1);
             EXPECT_THROW(buf.write(data.data(), data.size()), MemoryWriteBuffer::CurrentBufferExhausted);
+            buf.finalize();
         }
     }
 
diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index a84843300fb..db39fd84137 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -295,7 +295,7 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
             {
                 ALLOW_ALLOCATIONS_IN_SCOPE;
                 /// An exception context is needed to proper delete write buffers without finalization
-                throw Exception(ErrorCodes::ABORTED, "Storage is about to be deleted. Done task as if it was aborted.");
+                throw Exception(ErrorCodes::ABORTED, "Storage is about to be deleted. Done active task as if it was aborted.");
             }
             catch (...)
             {
diff --git a/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.cpp b/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.cpp
index 3b361abfc1a..61356558e16 100644
--- a/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeMutateTaskBase.cpp
@@ -119,9 +119,11 @@ bool ReplicatedMergeMutateTaskBase::executeStep()
                 }
             }
         }
-
     }
 
+    if (saved_exception)
+        std::rethrow_exception(saved_exception);
+
     return false;
 }
 

From 004755914ea60b9c84a9f2eb8e39c0f3613c8261 Mon Sep 17 00:00:00 2001
From: jinjunzh <jasper.zhu@intel.com>
Date: Sun, 18 Jun 2023 20:55:10 -0400
Subject: [PATCH 556/722] change to use generic MSan API to bypass
 uninitialized memory check

---
 src/Compression/CompressionCodecDeflateQpl.cpp | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/Compression/CompressionCodecDeflateQpl.cpp b/src/Compression/CompressionCodecDeflateQpl.cpp
index 7da79b5f90d..4a2866d152d 100644
--- a/src/Compression/CompressionCodecDeflateQpl.cpp
+++ b/src/Compression/CompressionCodecDeflateQpl.cpp
@@ -8,6 +8,7 @@
 #include <Poco/Logger.h>
 #include <Common/logger_useful.h>
 #include "libaccel_config.h"
+#include <Common/MemorySanitizer.h>
 
 namespace DB
 {
@@ -382,8 +383,10 @@ UInt32 CompressionCodecDeflateQpl::getMaxCompressedDataSize(UInt32 uncompressed_
 
 UInt32 CompressionCodecDeflateQpl::doCompressData(const char * source, UInt32 source_size, char * dest) const
 {
+/// QPL library is using AVX-512 with some shuffle operations.
+/// Memory sanitizer don't understand if there was uninitialized memory in SIMD register but it was not used in the result of shuffle.
 #if defined(MEMORY_SANITIZER)
-    memset(dest, 0 , getMaxCompressedDataSize(source_size));
+    __msan_unpoison(dest, getMaxCompressedDataSize(source_size));
 #endif
     Int32 res = HardwareCodecDeflateQpl::RET_ERROR;
     if (DeflateQplJobHWPool::instance().isJobPoolReady())
@@ -395,8 +398,10 @@ UInt32 CompressionCodecDeflateQpl::doCompressData(const char * source, UInt32 so
 
 void CompressionCodecDeflateQpl::doDecompressData(const char * source, UInt32 source_size, char * dest, UInt32 uncompressed_size) const
 {
+/// QPL library is using AVX-512 with some shuffle operations.
+/// Memory sanitizer don't understand if there was uninitialized memory in SIMD register but it was not used in the result of shuffle.
 #if defined(MEMORY_SANITIZER)
-    memset(dest, 0 , uncompressed_size);
+    __msan_unpoison(dest, uncompressed_size);
 #endif
     switch (getDecompressMode())
     {

From dcd4cfa5c2752a8ec8ced9e1347867cbb269d3e1 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Mon, 19 Jun 2023 03:28:59 +0200
Subject: [PATCH 557/722] Fix build

---
 src/Daemon/BaseDaemon.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index 3a09e9df04a..bfd5568b71d 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -438,6 +438,8 @@ private:
             }
         }
 
+        /// ClickHouse Keeper does not link to some part of Settings.
+#ifndef CLICKHOUSE_PROGRAM_STANDALONE_BUILD
         /// List changed settings.
         if (!query_id.empty())
         {
@@ -452,6 +454,7 @@ private:
                     LOG_FATAL(log, "Changed settings: {}", changed_settings);
             }
         }
+#endif
 
         /// When everything is done, we will try to send these error messages to client.
         if (thread_ptr)

From 4c729955370c4315fd43bcd27435e253a530670c Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Mon, 19 Jun 2023 13:02:35 +0300
Subject: [PATCH 558/722] Fixed build

---
 src/Interpreters/sortBlock.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/sortBlock.cpp b/src/Interpreters/sortBlock.cpp
index 6d8742f9d9e..89c4220ccdf 100644
--- a/src/Interpreters/sortBlock.cpp
+++ b/src/Interpreters/sortBlock.cpp
@@ -227,7 +227,7 @@ bool isIdentityPermutation(const IColumn::Permutation & permutation, size_t limi
             for (size_t j = 0; j < 4; ++j)
             {
                 __m128i permutation_data_vector = _mm_loadu_si128(reinterpret_cast<const __m128i *>(permutation_data + i + j * 2));
-                __m128i permutation_equals_vector = _mm_cmpeq_epi64(permutation_data_vector, permutation_compare_values_vectors[j]);
+                __m128i permutation_equals_vector = _mm_cmpeq_epi8(permutation_data_vector, permutation_compare_values_vectors[j]);
                 permutation_compare_values_vectors[j] = _mm_add_epi64(permutation_compare_values_vectors[j], permutation_add_vector);
                 permutation_equals_vector_mask &= _mm_movemask_epi8(permutation_equals_vector);
             }

From b472480d48f83198c15c2b7bc8b51482b6c8a941 Mon Sep 17 00:00:00 2001
From: Yatsishin Ilya <2159081+qoega@users.noreply.github.com>
Date: Mon, 19 Jun 2023 10:06:56 +0000
Subject: [PATCH 559/722] Fix branch name

---
 docker/test/sqlancer/process_sqlancer_result.py | 1 -
 docker/test/sqlancer/run.sh                     | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/docker/test/sqlancer/process_sqlancer_result.py b/docker/test/sqlancer/process_sqlancer_result.py
index 3bed4578565..06abb52abf8 100755
--- a/docker/test/sqlancer/process_sqlancer_result.py
+++ b/docker/test/sqlancer/process_sqlancer_result.py
@@ -16,7 +16,6 @@ def process_result(result_folder):
         "TLPGroupBy",
         "TLPHaving",
         "TLPWhere",
-        "TLPWhereGroupBy",
         "NoREC",
     ]
     failed_tests = []
diff --git a/docker/test/sqlancer/run.sh b/docker/test/sqlancer/run.sh
index 4a0f0f6a512..b186bc155a2 100755
--- a/docker/test/sqlancer/run.sh
+++ b/docker/test/sqlancer/run.sh
@@ -33,7 +33,7 @@ cd /workspace
 
 for _ in $(seq 1 60); do if [[ $(wget -q 'localhost:8123' -O-) == 'Ok.' ]]; then break ; else sleep 1; fi ; done
 
-cd /sqlancer/sqlancer-master
+cd /sqlancer/sqlancer-main
 
 TIMEOUT=300
 NUM_QUERIES=1000

From caceb7c862001d1845781bc18862a2698f23e3eb Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@gmail.com>
Date: Mon, 19 Jun 2023 13:21:09 +0300
Subject: [PATCH 560/722] Revert "Added ability to implicitly use file/hdfs/s3
 table functions in clickhouse-local"

---
 programs/local/LocalServer.cpp                |  13 +-
 src/Databases/DatabaseFactory.cpp             |  70 +---
 src/Databases/DatabaseFilesystem.cpp          | 247 --------------
 src/Databases/DatabaseFilesystem.h            |  67 ----
 src/Databases/DatabaseHDFS.cpp                | 234 -------------
 src/Databases/DatabaseHDFS.h                  |  68 ----
 src/Databases/DatabaseS3.cpp                  | 312 ------------------
 src/Databases/DatabaseS3.h                    |  81 -----
 src/Databases/DatabasesOverlay.cpp            | 266 ---------------
 src/Databases/DatabasesOverlay.h              |  66 ----
 src/Databases/IDatabase.h                     |   4 +-
 src/Interpreters/DatabaseCatalog.cpp          |  14 +-
 tests/config/config.d/named_collection.xml    |   5 -
 ...cal_implicit_file_table_function.reference |   9 -
 ...ouse_local_implicit_file_table_function.sh |  45 ---
 .../02722_database_filesystem.reference       |  15 -
 .../0_stateless/02722_database_filesystem.sh  |  72 ----
 .../0_stateless/02724_database_s3.reference   |  21 --
 .../queries/0_stateless/02724_database_s3.sh  |  63 ----
 .../0_stateless/02725_database_hdfs.reference |  12 -
 .../0_stateless/02725_database_hdfs.sh        |  60 ----
 21 files changed, 7 insertions(+), 1737 deletions(-)
 delete mode 100644 src/Databases/DatabaseFilesystem.cpp
 delete mode 100644 src/Databases/DatabaseFilesystem.h
 delete mode 100644 src/Databases/DatabaseHDFS.cpp
 delete mode 100644 src/Databases/DatabaseHDFS.h
 delete mode 100644 src/Databases/DatabaseS3.cpp
 delete mode 100644 src/Databases/DatabaseS3.h
 delete mode 100644 src/Databases/DatabasesOverlay.cpp
 delete mode 100644 src/Databases/DatabasesOverlay.h
 delete mode 100644 tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
 delete mode 100755 tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
 delete mode 100644 tests/queries/0_stateless/02722_database_filesystem.reference
 delete mode 100755 tests/queries/0_stateless/02722_database_filesystem.sh
 delete mode 100644 tests/queries/0_stateless/02724_database_s3.reference
 delete mode 100755 tests/queries/0_stateless/02724_database_s3.sh
 delete mode 100644 tests/queries/0_stateless/02725_database_hdfs.reference
 delete mode 100755 tests/queries/0_stateless/02725_database_hdfs.sh

diff --git a/programs/local/LocalServer.cpp b/programs/local/LocalServer.cpp
index 2afcd48dafb..caca7cfb50d 100644
--- a/programs/local/LocalServer.cpp
+++ b/programs/local/LocalServer.cpp
@@ -8,9 +8,7 @@
 #include <Poco/Logger.h>
 #include <Poco/NullChannel.h>
 #include <Poco/SimpleFileChannel.h>
-#include <Databases/DatabaseFilesystem.h>
 #include <Databases/DatabaseMemory.h>
-#include <Databases/DatabasesOverlay.h>
 #include <Storages/System/attachSystemTables.h>
 #include <Storages/System/attachInformationSchemaTables.h>
 #include <Interpreters/DatabaseCatalog.h>
@@ -52,8 +50,6 @@
 #include <base/argsToConfig.h>
 #include <filesystem>
 
-#include "config.h"
-
 #if defined(FUZZING_MODE)
     #include <Functions/getFuzzerData.h>
 #endif
@@ -174,13 +170,6 @@ static DatabasePtr createMemoryDatabaseIfNotExists(ContextPtr context, const Str
     return system_database;
 }
 
-static DatabasePtr createClickHouseLocalDatabaseOverlay(const String & name_, ContextPtr context_)
-{
-    auto databaseCombiner = std::make_shared<DatabasesOverlay>(name_, context_);
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseFilesystem>(name_, "", context_));
-    databaseCombiner->registerNextDatabase(std::make_shared<DatabaseMemory>(name_, context_));
-    return databaseCombiner;
-}
 
 /// If path is specified and not empty, will try to setup server environment and load existing metadata
 void LocalServer::tryInitPath()
@@ -680,7 +669,7 @@ void LocalServer::processConfig()
       *  if such tables will not be dropped, clickhouse-server will not be able to load them due to security reasons.
       */
     std::string default_database = config().getString("default_database", "_local");
-    DatabaseCatalog::instance().attachDatabase(default_database, createClickHouseLocalDatabaseOverlay(default_database, global_context));
+    DatabaseCatalog::instance().attachDatabase(default_database, std::make_shared<DatabaseMemory>(default_database, global_context));
     global_context->setCurrentDatabase(default_database);
     applyCmdOptions(global_context);
 
diff --git a/src/Databases/DatabaseFactory.cpp b/src/Databases/DatabaseFactory.cpp
index 9d90c61bb41..e1c8afa52c0 100644
--- a/src/Databases/DatabaseFactory.cpp
+++ b/src/Databases/DatabaseFactory.cpp
@@ -3,7 +3,6 @@
 #include <filesystem>
 #include <Databases/DatabaseAtomic.h>
 #include <Databases/DatabaseDictionary.h>
-#include <Databases/DatabaseFilesystem.h>
 #include <Databases/DatabaseLazy.h>
 #include <Databases/DatabaseMemory.h>
 #include <Databases/DatabaseOrdinary.h>
@@ -48,14 +47,6 @@
 #include <Databases/SQLite/DatabaseSQLite.h>
 #endif
 
-#if USE_AWS_S3
-#include <Databases/DatabaseS3.h>
-#endif
-
-#if USE_HDFS
-#include <Databases/DatabaseHDFS.h>
-#endif
-
 namespace fs = std::filesystem;
 
 namespace DB
@@ -140,13 +131,13 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
 
     static const std::unordered_set<std::string_view> database_engines{"Ordinary", "Atomic", "Memory",
         "Dictionary", "Lazy", "Replicated", "MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3", "HDFS"};
+        "PostgreSQL", "MaterializedPostgreSQL", "SQLite"};
 
     if (!database_engines.contains(engine_name))
         throw Exception(ErrorCodes::BAD_ARGUMENTS, "Database engine name `{}` does not exist", engine_name);
 
     static const std::unordered_set<std::string_view> engines_with_arguments{"MySQL", "MaterializeMySQL", "MaterializedMySQL",
-        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite", "Filesystem", "S3", "HDFS"};
+        "Lazy", "Replicated", "PostgreSQL", "MaterializedPostgreSQL", "SQLite"};
 
     static const std::unordered_set<std::string_view> engines_with_table_overrides{"MaterializeMySQL", "MaterializedMySQL", "MaterializedPostgreSQL"};
     bool engine_may_have_arguments = engines_with_arguments.contains(engine_name);
@@ -441,63 +432,6 @@ DatabasePtr DatabaseFactory::getImpl(const ASTCreateQuery & create, const String
     }
 #endif
 
-    else if (engine_name == "Filesystem")
-    {
-        const ASTFunction * engine = engine_define->engine;
-
-        /// If init_path is empty, then the current path will be used
-        std::string init_path;
-
-        if (engine->arguments && !engine->arguments->children.empty())
-        {
-            if (engine->arguments->children.size() != 1)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "Filesystem database requires at most 1 argument: filesystem_path");
-
-            const auto & arguments = engine->arguments->children;
-            init_path = safeGetLiteralValue<String>(arguments[0], engine_name);
-        }
-
-        return std::make_shared<DatabaseFilesystem>(database_name, init_path, context);
-    }
-
-#if USE_AWS_S3
-    else if (engine_name == "S3")
-    {
-        const ASTFunction * engine = engine_define->engine;
-
-        DatabaseS3::Configuration config;
-
-        if (engine->arguments && !engine->arguments->children.empty())
-        {
-            ASTs & engine_args = engine->arguments->children;
-            config = DatabaseS3::parseArguments(engine_args, context);
-        }
-
-        return std::make_shared<DatabaseS3>(database_name, config, context);
-    }
-#endif
-
-#if USE_HDFS
-    else if (engine_name == "HDFS")
-    {
-        const ASTFunction * engine = engine_define->engine;
-
-        /// If source_url is empty, then table name must contain full url
-        std::string source_url;
-
-        if (engine->arguments && !engine->arguments->children.empty())
-        {
-            if (engine->arguments->children.size() != 1)
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, "HDFS database requires at most 1 argument: source_url");
-
-            const auto & arguments = engine->arguments->children;
-            source_url = safeGetLiteralValue<String>(arguments[0], engine_name);
-        }
-
-        return std::make_shared<DatabaseHDFS>(database_name, source_url, context);
-    }
-#endif
-
     throw Exception(ErrorCodes::UNKNOWN_DATABASE_ENGINE, "Unknown database engine: {}", engine_name);
 }
 
diff --git a/src/Databases/DatabaseFilesystem.cpp b/src/Databases/DatabaseFilesystem.cpp
deleted file mode 100644
index 001aa1f9ef6..00000000000
--- a/src/Databases/DatabaseFilesystem.cpp
+++ /dev/null
@@ -1,247 +0,0 @@
-#include <Databases/DatabaseFilesystem.h>
-
-#include <IO/Operators.h>
-#include <IO/WriteBufferFromString.h>
-#include <Interpreters/Context.h>
-#include <Parsers/ASTCreateQuery.h>
-#include <Parsers/ASTFunction.h>
-#include <Parsers/ASTLiteral.h>
-#include <Parsers/ParserCreateQuery.h>
-#include <Parsers/parseQuery.h>
-#include <Storages/IStorage.h>
-#include <TableFunctions/TableFunctionFactory.h>
-#include <Common/filesystemHelpers.h>
-
-#include <filesystem>
-
-namespace fs = std::filesystem;
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-    extern const int UNKNOWN_TABLE;
-    extern const int DATABASE_ACCESS_DENIED;
-    extern const int BAD_ARGUMENTS;
-    extern const int FILE_DOESNT_EXIST;
-}
-
-DatabaseFilesystem::DatabaseFilesystem(const String & name_, const String & path_, ContextPtr context_)
-    : IDatabase(name_), WithContext(context_->getGlobalContext()), path(path_), log(&Poco::Logger::get("DatabaseFileSystem(" + name_ + ")"))
-{
-    bool is_local = context_->getApplicationType() == Context::ApplicationType::LOCAL;
-    fs::path user_files_path = is_local ? "" : fs::canonical(getContext()->getUserFilesPath());
-
-    if (fs::path(path).is_relative())
-    {
-        path = user_files_path / path;
-    }
-    else if (!is_local && !pathStartsWith(fs::path(path), user_files_path))
-    {
-        throw Exception(ErrorCodes::BAD_ARGUMENTS,
-                        "Path must be inside user-files path: {}", user_files_path.string());
-    }
-
-    path = fs::absolute(path).lexically_normal();
-    if (!fs::exists(path))
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Path does not exist: {}", path);
-}
-
-std::string DatabaseFilesystem::getTablePath(const std::string & table_name) const
-{
-    fs::path table_path = fs::path(path) / table_name;
-    return table_path.lexically_normal().string();
-}
-
-void DatabaseFilesystem::addTable(const std::string & table_name, StoragePtr table_storage) const
-{
-    std::lock_guard lock(mutex);
-    auto [_, inserted] = loaded_tables.emplace(table_name, table_storage);
-    if (!inserted)
-        throw Exception(
-            ErrorCodes::LOGICAL_ERROR,
-            "Table with name `{}` already exists in database `{}` (engine {})",
-            table_name, getDatabaseName(), getEngineName());
-}
-
-bool DatabaseFilesystem::checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const
-{
-    /// If run in Local mode, no need for path checking.
-    bool check_path = context_->getApplicationType() != Context::ApplicationType::LOCAL;
-    const auto & user_files_path = context_->getUserFilesPath();
-
-    /// Check access for file before checking its existence.
-    if (check_path && !fileOrSymlinkPathStartsWith(table_path, user_files_path))
-    {
-        if (throw_on_error)
-            throw Exception(ErrorCodes::DATABASE_ACCESS_DENIED, "File is not inside {}", user_files_path);
-        else
-            return false;
-    }
-
-    /// Check if the corresponding file exists.
-    if (!fs::exists(table_path))
-    {
-        if (throw_on_error)
-            throw Exception(ErrorCodes::FILE_DOESNT_EXIST, "File does not exist: {}", table_path);
-        else
-            return false;
-    }
-
-    if (!fs::is_regular_file(table_path))
-    {
-        if (throw_on_error)
-            throw Exception(ErrorCodes::FILE_DOESNT_EXIST,
-                            "File is directory, but expected a file: {}", table_path);
-        else
-            return false;
-    }
-
-    return true;
-}
-
-StoragePtr DatabaseFilesystem::tryGetTableFromCache(const std::string & name) const
-{
-    StoragePtr table = nullptr;
-    {
-        std::lock_guard lock(mutex);
-        auto it = loaded_tables.find(name);
-        if (it != loaded_tables.end())
-            table = it->second;
-    }
-
-    /// Invalidate cache if file no longer exists.
-    if (table && !fs::exists(getTablePath(name)))
-    {
-        std::lock_guard lock(mutex);
-        loaded_tables.erase(name);
-        return nullptr;
-    }
-
-    return table;
-}
-
-bool DatabaseFilesystem::isTableExist(const String & name, ContextPtr context_) const
-{
-    if (tryGetTableFromCache(name))
-        return true;
-
-    return checkTableFilePath(getTablePath(name), context_, /* throw_on_error */false);
-}
-
-StoragePtr DatabaseFilesystem::getTableImpl(const String & name, ContextPtr context_) const
-{
-    /// Check if table exists in loaded tables map.
-    if (auto table = tryGetTableFromCache(name))
-        return table;
-
-    auto table_path = getTablePath(name);
-    checkTableFilePath(table_path, context_, /* throw_on_error */true);
-
-    /// If the file exists, create a new table using TableFunctionFile and return it.
-    auto args = makeASTFunction("file", std::make_shared<ASTLiteral>(table_path));
-
-    auto table_function = TableFunctionFactory::instance().get(args, context_);
-    if (!table_function)
-        return nullptr;
-
-    /// TableFunctionFile throws exceptions, if table cannot be created.
-    auto table_storage = table_function->execute(args, context_, name);
-    if (table_storage)
-        addTable(name, table_storage);
-
-    return table_storage;
-}
-
-StoragePtr DatabaseFilesystem::getTable(const String & name, ContextPtr context_) const
-{
-    /// getTableImpl can throw exceptions, do not catch them to show correct error to user.
-    if (auto storage = getTableImpl(name, context_))
-        return storage;
-
-    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist",
-                    backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
-}
-
-StoragePtr DatabaseFilesystem::tryGetTable(const String & name, ContextPtr context_) const
-{
-    try
-    {
-        return getTableImpl(name, context_);
-    }
-    catch (const Exception & e)
-    {
-        /// Ignore exceptions thrown by TableFunctionFile, which indicate that there is no table
-        /// see tests/02722_database_filesystem.sh for more details.
-        if (e.code() == ErrorCodes::BAD_ARGUMENTS
-            || e.code() == ErrorCodes::DATABASE_ACCESS_DENIED
-            || e.code() == ErrorCodes::FILE_DOESNT_EXIST)
-        {
-            return nullptr;
-        }
-        throw;
-    }
-}
-
-bool DatabaseFilesystem::empty() const
-{
-    std::lock_guard lock(mutex);
-    return loaded_tables.empty();
-}
-
-ASTPtr DatabaseFilesystem::getCreateDatabaseQuery() const
-{
-    const auto & settings = getContext()->getSettingsRef();
-    const String query = fmt::format("CREATE DATABASE {} ENGINE = Filesystem('{}')", backQuoteIfNeed(getDatabaseName()), path);
-
-    ParserCreateQuery parser;
-    ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
-
-    if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
-    {
-        auto & ast_create_query = ast->as<ASTCreateQuery &>();
-        ast_create_query.set(ast_create_query.comment, std::make_shared<ASTLiteral>(database_comment));
-    }
-
-    return ast;
-}
-
-void DatabaseFilesystem::shutdown()
-{
-    Tables tables_snapshot;
-    {
-        std::lock_guard lock(mutex);
-        tables_snapshot = loaded_tables;
-    }
-
-    for (const auto & kv : tables_snapshot)
-    {
-        auto table_id = kv.second->getStorageID();
-        kv.second->flushAndShutdown();
-    }
-
-    std::lock_guard lock(mutex);
-    loaded_tables.clear();
-}
-
-/**
- * Returns an empty vector because the database is read-only and no tables can be backed up
- */
-std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseFilesystem::getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const
-{
-    return {};
-}
-
-/**
- *
- * Returns an empty iterator because the database does not have its own tables
- * But only caches them for quick access
- */
-DatabaseTablesIteratorPtr DatabaseFilesystem::getTablesIterator(ContextPtr, const FilterByNameFunction &) const
-{
-    return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
-}
-
-}
diff --git a/src/Databases/DatabaseFilesystem.h b/src/Databases/DatabaseFilesystem.h
deleted file mode 100644
index 7fe620401dc..00000000000
--- a/src/Databases/DatabaseFilesystem.h
+++ /dev/null
@@ -1,67 +0,0 @@
-#pragma once
-
-#include <mutex>
-#include <Databases/IDatabase.h>
-#include <Parsers/IAST.h>
-#include <Storages/IStorage_fwd.h>
-#include <base/types.h>
-
-namespace DB
-{
-
-class Context;
-
-/**
-  * DatabaseFilesystem allows to interact with files stored on the local filesystem.
-  * Uses TableFunctionFile to implicitly load file when a user requests the table,
-  * and provides a read-only access to the data in the file.
-  * Tables are cached inside the database for quick access
-  *
-  * Used in clickhouse-local to access local files.
-  * For clickhouse-server requires allows to access file only from user_files directory.
-  */
-class DatabaseFilesystem : public IDatabase, protected WithContext
-{
-public:
-    DatabaseFilesystem(const String & name, const String & path, ContextPtr context);
-
-    String getEngineName() const override { return "Filesystem"; }
-
-    bool isTableExist(const String & name, ContextPtr context) const override;
-
-    StoragePtr getTable(const String & name, ContextPtr context) const override;
-
-    StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
-
-    bool shouldBeEmptyOnDetach() const override { return false; } /// Contains only temporary tables.
-
-    bool empty() const override;
-
-    bool isReadOnly() const override { return true; }
-
-    ASTPtr getCreateDatabaseQuery() const override;
-
-    void shutdown() override;
-
-    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
-
-    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
-
-protected:
-    StoragePtr getTableImpl(const String & name, ContextPtr context) const;
-
-    StoragePtr tryGetTableFromCache(const std::string & name) const;
-
-    std::string getTablePath(const std::string & table_name) const;
-
-    void addTable(const std::string & table_name, StoragePtr table_storage) const;
-
-    bool checkTableFilePath(const std::string & table_path, ContextPtr context_, bool throw_on_error) const;
-
-private:
-    String path;
-    mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
-    Poco::Logger * log;
-};
-
-}
diff --git a/src/Databases/DatabaseHDFS.cpp b/src/Databases/DatabaseHDFS.cpp
deleted file mode 100644
index 1a0145b9015..00000000000
--- a/src/Databases/DatabaseHDFS.cpp
+++ /dev/null
@@ -1,234 +0,0 @@
-#include "config.h"
-
-#if USE_HDFS
-
-#include <Databases/DatabaseHDFS.h>
-
-#include <Interpreters/Context.h>
-#include <Parsers/ASTCreateQuery.h>
-#include <Parsers/ASTFunction.h>
-#include <Parsers/ASTLiteral.h>
-#include <Parsers/parseQuery.h>
-#include <Parsers/ParserCreateQuery.h>
-#include <Storages/HDFS/HDFSCommon.h>
-#include <Storages/IStorage.h>
-#include <TableFunctions/TableFunctionFactory.h>
-
-#include <Poco/URI.h>
-#include <re2/re2.h>
-
-#include <filesystem>
-
-namespace fs = std::filesystem;
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-    extern const int UNKNOWN_TABLE;
-    extern const int BAD_ARGUMENTS;
-    extern const int FILE_DOESNT_EXIST;
-    extern const int UNACCEPTABLE_URL;
-    extern const int ACCESS_DENIED;
-    extern const int DATABASE_ACCESS_DENIED;
-    extern const int HDFS_ERROR;
-    extern const int CANNOT_EXTRACT_TABLE_STRUCTURE;
-}
-
-static constexpr std::string_view HDFS_HOST_REGEXP = "^hdfs://[^/]*";
-
-
-DatabaseHDFS::DatabaseHDFS(const String & name_, const String & source_url, ContextPtr context_)
-    : IDatabase(name_)
-    , WithContext(context_->getGlobalContext())
-    , source(source_url)
-    , log(&Poco::Logger::get("DatabaseHDFS(" + name_ + ")"))
-{
-    if (!source.empty())
-    {
-        if (!re2::RE2::FullMatch(source, std::string(HDFS_HOST_REGEXP)))
-            throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs host: {}. "
-                            "It should have structure 'hdfs://<host_name>:<port>'", source);
-
-        context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(source));
-    }
-}
-
-void DatabaseHDFS::addTable(const std::string & table_name, StoragePtr table_storage) const
-{
-    std::lock_guard lock(mutex);
-    auto [_, inserted] = loaded_tables.emplace(table_name, table_storage);
-    if (!inserted)
-        throw Exception(
-            ErrorCodes::LOGICAL_ERROR,
-            "Table with name `{}` already exists in database `{}` (engine {})",
-            table_name, getDatabaseName(), getEngineName());
-}
-
-std::string DatabaseHDFS::getTablePath(const std::string & table_name) const
-{
-    if (table_name.starts_with("hdfs://"))
-        return table_name;
-
-    if (source.empty())
-        throw Exception(ErrorCodes::BAD_ARGUMENTS, "Bad hdfs url: {}. "
-                        "It should have structure 'hdfs://<host_name>:<port>/path'", table_name);
-
-    return fs::path(source) / table_name;
-}
-
-bool DatabaseHDFS::checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const
-{
-    try
-    {
-        checkHDFSURL(url);
-        context_->getGlobalContext()->getRemoteHostFilter().checkURL(Poco::URI(url));
-    }
-    catch (...)
-    {
-        if (throw_on_error)
-            throw;
-        return false;
-    }
-
-    return true;
-}
-
-bool DatabaseHDFS::isTableExist(const String & name, ContextPtr context_) const
-{
-    std::lock_guard lock(mutex);
-    if (loaded_tables.find(name) != loaded_tables.end())
-        return true;
-
-    return checkUrl(name, context_, false);
-}
-
-StoragePtr DatabaseHDFS::getTableImpl(const String & name, ContextPtr context_) const
-{
-    /// Check if the table exists in the loaded tables map.
-    {
-        std::lock_guard lock(mutex);
-        auto it = loaded_tables.find(name);
-        if (it != loaded_tables.end())
-            return it->second;
-    }
-
-    auto url = getTablePath(name);
-
-    checkUrl(url, context_, true);
-
-    auto args = makeASTFunction("hdfs", std::make_shared<ASTLiteral>(url));
-
-    auto table_function = TableFunctionFactory::instance().get(args, context_);
-    if (!table_function)
-        return nullptr;
-
-    /// TableFunctionHDFS throws exceptions, if table cannot be created.
-    auto table_storage = table_function->execute(args, context_, name);
-    if (table_storage)
-        addTable(name, table_storage);
-
-    return table_storage;
-}
-
-StoragePtr DatabaseHDFS::getTable(const String & name, ContextPtr context_) const
-{
-    /// Rethrow all exceptions from TableFunctionHDFS to show correct error to user.
-    if (auto storage = getTableImpl(name, context_))
-        return storage;
-
-    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist",
-                    backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
-}
-
-StoragePtr DatabaseHDFS::tryGetTable(const String & name, ContextPtr context_) const
-{
-    try
-    {
-        return getTableImpl(name, context_);
-    }
-    catch (const Exception & e)
-    {
-        // Ignore exceptions thrown by TableFunctionHDFS, which indicate that there is no table
-        if (e.code() == ErrorCodes::BAD_ARGUMENTS
-            || e.code() == ErrorCodes::ACCESS_DENIED
-            || e.code() == ErrorCodes::DATABASE_ACCESS_DENIED
-            || e.code() == ErrorCodes::FILE_DOESNT_EXIST
-            || e.code() == ErrorCodes::UNACCEPTABLE_URL
-            || e.code() == ErrorCodes::HDFS_ERROR
-            || e.code() == ErrorCodes::CANNOT_EXTRACT_TABLE_STRUCTURE)
-        {
-            return nullptr;
-        }
-        throw;
-    }
-    catch (const Poco::URISyntaxException &)
-    {
-        return nullptr;
-    }
-}
-
-bool DatabaseHDFS::empty() const
-{
-    std::lock_guard lock(mutex);
-    return loaded_tables.empty();
-}
-
-ASTPtr DatabaseHDFS::getCreateDatabaseQuery() const
-{
-    const auto & settings = getContext()->getSettingsRef();
-    ParserCreateQuery parser;
-
-    const String query = fmt::format("CREATE DATABASE {} ENGINE = HDFS('{}')", backQuoteIfNeed(getDatabaseName()), source);
-    ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
-
-    if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
-    {
-        auto & ast_create_query = ast->as<ASTCreateQuery &>();
-        ast_create_query.set(ast_create_query.comment, std::make_shared<ASTLiteral>(database_comment));
-    }
-
-    return ast;
-}
-
-void DatabaseHDFS::shutdown()
-{
-    Tables tables_snapshot;
-    {
-        std::lock_guard lock(mutex);
-        tables_snapshot = loaded_tables;
-    }
-
-    for (const auto & kv : tables_snapshot)
-    {
-        auto table_id = kv.second->getStorageID();
-        kv.second->flushAndShutdown();
-    }
-
-    std::lock_guard lock(mutex);
-    loaded_tables.clear();
-}
-
-/**
- * Returns an empty vector because the database is read-only and no tables can be backed up
- */
-std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseHDFS::getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const
-{
-    return {};
-}
-
-/**
- *
- * Returns an empty iterator because the database does not have its own tables
- * But only caches them for quick access
- */
-DatabaseTablesIteratorPtr DatabaseHDFS::getTablesIterator(ContextPtr, const FilterByNameFunction &) const
-{
-    return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
-}
-
-} // DB
-
-#endif
diff --git a/src/Databases/DatabaseHDFS.h b/src/Databases/DatabaseHDFS.h
deleted file mode 100644
index 957b2080135..00000000000
--- a/src/Databases/DatabaseHDFS.h
+++ /dev/null
@@ -1,68 +0,0 @@
-#pragma once
-
-#include "config.h"
-
-#if USE_HDFS
-
-#include <mutex>
-#include <Databases/IDatabase.h>
-#include <Parsers/IAST.h>
-#include <Storages/IStorage_fwd.h>
-#include <base/types.h>
-
-namespace DB
-{
-
-class Context;
-
-/**
-  * DatabaseHDFS allows to interact with files stored on the file system.
-  * Uses TableFunctionHDFS to implicitly load file when a user requests the table,
-  * and provides read-only access to the data in the file.
-  * Tables are cached inside the database for quick access.
-  */
-class DatabaseHDFS : public IDatabase, protected WithContext
-{
-public:
-    DatabaseHDFS(const String & name, const String & source_url, ContextPtr context);
-
-    String getEngineName() const override { return "S3"; }
-
-    bool isTableExist(const String & name, ContextPtr context) const override;
-
-    StoragePtr getTable(const String & name, ContextPtr context) const override;
-
-    StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
-
-    bool shouldBeEmptyOnDetach() const override { return false; } /// Contains only temporary tables.
-
-    bool empty() const override;
-
-    bool isReadOnly() const override { return true; }
-
-    ASTPtr getCreateDatabaseQuery() const override;
-
-    void shutdown() override;
-
-    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
-    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
-
-protected:
-    StoragePtr getTableImpl(const String & name, ContextPtr context) const;
-
-    void addTable(const std::string & table_name, StoragePtr table_storage) const;
-
-    bool checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const;
-
-    std::string getTablePath(const std::string & table_name) const;
-
-private:
-    const String source;
-
-    mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
-    Poco::Logger * log;
-};
-
-}
-
-#endif
diff --git a/src/Databases/DatabaseS3.cpp b/src/Databases/DatabaseS3.cpp
deleted file mode 100644
index 11655f5f100..00000000000
--- a/src/Databases/DatabaseS3.cpp
+++ /dev/null
@@ -1,312 +0,0 @@
-#include "config.h"
-
-#if USE_AWS_S3
-
-#include <Databases/DatabaseS3.h>
-
-#include <Interpreters/Context.h>
-#include <Interpreters/evaluateConstantExpression.h>
-#include <IO/S3/URI.h>
-#include <Parsers/ASTCreateQuery.h>
-#include <Parsers/ASTFunction.h>
-#include <Parsers/ASTLiteral.h>
-#include <Parsers/parseQuery.h>
-#include <Parsers/ParserCreateQuery.h>
-#include <Storages/checkAndGetLiteralArgument.h>
-#include <Storages/IStorage.h>
-#include <Storages/NamedCollectionsHelpers.h>
-#include <TableFunctions/TableFunctionFactory.h>
-
-#include <boost/algorithm/string.hpp>
-#include <filesystem>
-
-namespace fs = std::filesystem;
-
-namespace DB
-{
-
-static const std::unordered_set<std::string_view> optional_configuration_keys = {
-    "url",
-    "access_key_id",
-    "secret_access_key",
-    "no_sign_request"
-};
-
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-    extern const int UNKNOWN_TABLE;
-    extern const int BAD_ARGUMENTS;
-    extern const int FILE_DOESNT_EXIST;
-    extern const int UNACCEPTABLE_URL;
-    extern const int S3_ERROR;
-
-    extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
-}
-
-DatabaseS3::DatabaseS3(const String & name_, const Configuration& config_, ContextPtr context_)
-    : IDatabase(name_)
-    , WithContext(context_->getGlobalContext())
-    , config(config_)
-    , log(&Poco::Logger::get("DatabaseS3(" + name_ + ")"))
-{
-}
-
-void DatabaseS3::addTable(const std::string & table_name, StoragePtr table_storage) const
-{
-    std::lock_guard lock(mutex);
-    auto [_, inserted] = loaded_tables.emplace(table_name, table_storage);
-    if (!inserted)
-        throw Exception(
-            ErrorCodes::LOGICAL_ERROR,
-            "Table with name `{}` already exists in database `{}` (engine {})",
-            table_name, getDatabaseName(), getEngineName());
-}
-
-std::string DatabaseS3::getFullUrl(const std::string & name) const
-{
-    if (!config.url_prefix.empty())
-        return fs::path(config.url_prefix) / name;
-
-    return name;
-}
-
-bool DatabaseS3::checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const
-{
-    try
-    {
-        S3::URI uri(url);
-        context_->getGlobalContext()->getRemoteHostFilter().checkURL(uri.uri);
-    }
-    catch (...)
-    {
-        if (throw_on_error)
-            throw;
-        return false;
-    }
-    return true;
-}
-
-bool DatabaseS3::isTableExist(const String & name, ContextPtr context_) const
-{
-    std::lock_guard lock(mutex);
-    if (loaded_tables.find(name) != loaded_tables.end())
-        return true;
-
-    return checkUrl(getFullUrl(name), context_, false);
-}
-
-StoragePtr DatabaseS3::getTableImpl(const String & name, ContextPtr context_) const
-{
-    /// Check if the table exists in the loaded tables map.
-    {
-        std::lock_guard lock(mutex);
-        auto it = loaded_tables.find(name);
-        if (it != loaded_tables.end())
-            return it->second;
-    }
-
-    auto url = getFullUrl(name);
-    checkUrl(url, context_, /* throw_on_error */true);
-
-    auto function = std::make_shared<ASTFunction>();
-    function->name = "s3";
-    function->arguments = std::make_shared<ASTExpressionList>();
-    function->children.push_back(function->arguments);
-
-    function->arguments->children.push_back(std::make_shared<ASTLiteral>(url));
-    if (config.no_sign_request)
-    {
-        function->arguments->children.push_back(std::make_shared<ASTLiteral>("NOSIGN"));
-    }
-    else if (config.access_key_id.has_value() && config.secret_access_key.has_value())
-    {
-        function->arguments->children.push_back(std::make_shared<ASTLiteral>(config.access_key_id.value()));
-        function->arguments->children.push_back(std::make_shared<ASTLiteral>(config.secret_access_key.value()));
-    }
-
-    auto table_function = TableFunctionFactory::instance().get(function, context_);
-    if (!table_function)
-        return nullptr;
-
-    /// TableFunctionS3 throws exceptions, if table cannot be created.
-    auto table_storage = table_function->execute(function, context_, name);
-    if (table_storage)
-        addTable(name, table_storage);
-
-    return table_storage;
-}
-
-StoragePtr DatabaseS3::getTable(const String & name, ContextPtr context_) const
-{
-    /// Rethrow all exceptions from TableFunctionS3 to show correct error to user.
-    if (auto storage = getTableImpl(name, context_))
-        return storage;
-
-    throw Exception(ErrorCodes::UNKNOWN_TABLE, "Table {}.{} doesn't exist",
-                    backQuoteIfNeed(getDatabaseName()), backQuoteIfNeed(name));
-}
-
-StoragePtr DatabaseS3::tryGetTable(const String & name, ContextPtr context_) const
-{
-    try
-    {
-        return getTableImpl(name, context_);
-    }
-    catch (const Exception & e)
-    {
-        /// Ignore exceptions thrown by TableFunctionS3, which indicate that there is no table.
-        if (e.code() == ErrorCodes::BAD_ARGUMENTS
-            || e.code() == ErrorCodes::S3_ERROR
-            || e.code() == ErrorCodes::FILE_DOESNT_EXIST
-            || e.code() == ErrorCodes::UNACCEPTABLE_URL)
-        {
-            return nullptr;
-        }
-        throw;
-    }
-    catch (const Poco::URISyntaxException &)
-    {
-        return nullptr;
-    }
-}
-
-bool DatabaseS3::empty() const
-{
-    std::lock_guard lock(mutex);
-    return loaded_tables.empty();
-}
-
-ASTPtr DatabaseS3::getCreateDatabaseQuery() const
-{
-    const auto & settings = getContext()->getSettingsRef();
-    ParserCreateQuery parser;
-
-    std::string creation_args;
-    creation_args += fmt::format("'{}'", config.url_prefix);
-    if (config.no_sign_request)
-        creation_args += ", 'NOSIGN'";
-    else if (config.access_key_id.has_value() && config.secret_access_key.has_value())
-        creation_args += fmt::format(", '{}', '{}'", config.access_key_id.value(), config.secret_access_key.value());
-
-    const String query = fmt::format("CREATE DATABASE {} ENGINE = S3({})", backQuoteIfNeed(getDatabaseName()), creation_args);
-    ASTPtr ast = parseQuery(parser, query.data(), query.data() + query.size(), "", 0, settings.max_parser_depth);
-
-    if (const auto database_comment = getDatabaseComment(); !database_comment.empty())
-    {
-        auto & ast_create_query = ast->as<ASTCreateQuery &>();
-        ast_create_query.set(ast_create_query.comment, std::make_shared<ASTLiteral>(database_comment));
-    }
-
-    return ast;
-}
-
-void DatabaseS3::shutdown()
-{
-    Tables tables_snapshot;
-    {
-        std::lock_guard lock(mutex);
-        tables_snapshot = loaded_tables;
-    }
-
-    for (const auto & kv : tables_snapshot)
-    {
-        auto table_id = kv.second->getStorageID();
-        kv.second->flushAndShutdown();
-    }
-
-    std::lock_guard lock(mutex);
-    loaded_tables.clear();
-}
-
-DatabaseS3::Configuration DatabaseS3::parseArguments(ASTs engine_args, ContextPtr context_)
-{
-    Configuration result;
-
-    if (auto named_collection = tryGetNamedCollectionWithOverrides(engine_args, context_))
-    {
-        auto & collection = *named_collection;
-
-        validateNamedCollection(collection, {}, optional_configuration_keys);
-
-        result.url_prefix = collection.getOrDefault<String>("url", "");
-        result.no_sign_request = collection.getOrDefault<bool>("no_sign_request", false);
-
-        auto key_id = collection.getOrDefault<String>("access_key_id", "");
-        auto secret_key = collection.getOrDefault<String>("secret_access_key", "");
-
-        if (!key_id.empty())
-            result.access_key_id = key_id;
-
-        if (!secret_key.empty())
-            result.secret_access_key = secret_key;
-    }
-    else
-    {
-        const std::string supported_signature =
-            " - S3()\n"
-            " - S3('url')\n"
-            " - S3('url', 'NOSIGN')\n"
-            " - S3('url', 'access_key_id', 'secret_access_key')\n";
-        const auto error_message =
-            fmt::format("Engine DatabaseS3 must have the following arguments signature\n{}", supported_signature);
-
-        for (auto & arg : engine_args)
-            arg = evaluateConstantExpressionOrIdentifierAsLiteral(arg, context_);
-
-        if (engine_args.size() > 3)
-            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, error_message.c_str());
-
-        if (engine_args.empty())
-            return result;
-
-        result.url_prefix = checkAndGetLiteralArgument<String>(engine_args[0], "url");
-
-        // url, NOSIGN
-        if (engine_args.size() == 2)
-        {
-            auto second_arg = checkAndGetLiteralArgument<String>(engine_args[1], "NOSIGN");
-            if (boost::iequals(second_arg, "NOSIGN"))
-                result.no_sign_request = true;
-            else
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, error_message.c_str());
-        }
-
-        // url, access_key_id, secret_access_key
-        if (engine_args.size() == 3)
-        {
-            auto key_id = checkAndGetLiteralArgument<String>(engine_args[1], "access_key_id");
-            auto secret_key = checkAndGetLiteralArgument<String>(engine_args[2], "secret_access_key");
-
-            if (key_id.empty() || secret_key.empty() || boost::iequals(key_id, "NOSIGN"))
-                throw Exception(ErrorCodes::BAD_ARGUMENTS, error_message.c_str());
-
-            result.access_key_id = key_id;
-            result.secret_access_key = secret_key;
-        }
-    }
-
-    return result;
-}
-
-/**
- * Returns an empty vector because the database is read-only and no tables can be backed up
- */
-std::vector<std::pair<ASTPtr, StoragePtr>> DatabaseS3::getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const
-{
-    return {};
-}
-
-/**
- *
- * Returns an empty iterator because the database does not have its own tables
- * But only caches them for quick access
- */
-DatabaseTablesIteratorPtr DatabaseS3::getTablesIterator(ContextPtr, const FilterByNameFunction &) const
-{
-    return std::make_unique<DatabaseTablesSnapshotIterator>(Tables{}, getDatabaseName());
-}
-
-}
-
-#endif
diff --git a/src/Databases/DatabaseS3.h b/src/Databases/DatabaseS3.h
deleted file mode 100644
index 8297ae4e02d..00000000000
--- a/src/Databases/DatabaseS3.h
+++ /dev/null
@@ -1,81 +0,0 @@
-#pragma once
-
-#include "config.h"
-
-#if USE_AWS_S3
-
-#include <mutex>
-#include <Databases/IDatabase.h>
-#include <Parsers/IAST.h>
-#include <Storages/IStorage_fwd.h>
-#include <base/types.h>
-
-namespace DB
-{
-
-class Context;
-
-/**
-  * DatabaseS3 provides access to data stored in S3.
-  * Uses TableFunctionS3 to implicitly load file when a user requests the table,
-  * and provides read-only access to the data in the file.
-  * Tables are cached inside the database for quick access.
-  */
-class DatabaseS3 : public IDatabase, protected WithContext
-{
-public:
-    struct Configuration
-    {
-        std::string url_prefix;
-
-        bool no_sign_request = false;
-
-        std::optional<std::string> access_key_id;
-        std::optional<std::string> secret_access_key;
-    };
-
-    DatabaseS3(const String & name, const Configuration& config, ContextPtr context);
-
-    String getEngineName() const override { return "S3"; }
-
-    bool isTableExist(const String & name, ContextPtr context) const override;
-
-    StoragePtr getTable(const String & name, ContextPtr context) const override;
-
-    StoragePtr tryGetTable(const String & name, ContextPtr context) const override;
-
-    // Contains only temporary tables
-    bool shouldBeEmptyOnDetach() const override { return false; }
-
-    bool empty() const override;
-
-    bool isReadOnly() const override { return true; }
-
-    ASTPtr getCreateDatabaseQuery() const override;
-
-    void shutdown() override;
-
-    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction &, const ContextPtr &) const override;
-    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr, const FilterByNameFunction &) const override;
-
-    static Configuration parseArguments(ASTs engine_args, ContextPtr context);
-
-protected:
-    StoragePtr getTableImpl(const String & name, ContextPtr context) const;
-
-    void addTable(const std::string & table_name, StoragePtr table_storage) const;
-
-    bool checkUrl(const std::string & url, ContextPtr context_, bool throw_on_error) const;
-
-    std::string getFullUrl(const std::string & name) const;
-
-private:
-    const Configuration config;
-
-    mutable Tables loaded_tables TSA_GUARDED_BY(mutex);
-    Poco::Logger * log;
-};
-
-}
-
-#endif
diff --git a/src/Databases/DatabasesOverlay.cpp b/src/Databases/DatabasesOverlay.cpp
deleted file mode 100644
index b44a9798072..00000000000
--- a/src/Databases/DatabasesOverlay.cpp
+++ /dev/null
@@ -1,266 +0,0 @@
-#include <Databases/DatabasesOverlay.h>
-
-#include <Common/typeid_cast.h>
-#include <Interpreters/Context.h>
-#include <Interpreters/InterpreterCreateQuery.h>
-#include <Parsers/ASTCreateQuery.h>
-
-#include <Storages/IStorage_fwd.h>
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-    extern const int CANNOT_GET_CREATE_TABLE_QUERY;
-}
-
-DatabasesOverlay::DatabasesOverlay(const String & name_, ContextPtr context_)
-    : IDatabase(name_), WithContext(context_->getGlobalContext()), log(&Poco::Logger::get("DatabaseOverlay(" + name_ + ")"))
-{
-}
-
-DatabasesOverlay & DatabasesOverlay::registerNextDatabase(DatabasePtr database)
-{
-    databases.push_back(std::move(database));
-    return *this;
-}
-
-bool DatabasesOverlay::isTableExist(const String & table_name, ContextPtr context_) const
-{
-    for (const auto & db : databases)
-    {
-        if (db->isTableExist(table_name, context_))
-            return true;
-    }
-    return false;
-}
-
-StoragePtr DatabasesOverlay::tryGetTable(const String & table_name, ContextPtr context_) const
-{
-    StoragePtr result = nullptr;
-    for (const auto & db : databases)
-    {
-        result = db->tryGetTable(table_name, context_);
-        if (result)
-            break;
-    }
-    return result;
-}
-
-void DatabasesOverlay::createTable(ContextPtr context_, const String & table_name, const StoragePtr & table, const ASTPtr & query)
-{
-    for (auto & db : databases)
-    {
-        if (!db->isReadOnly())
-        {
-            db->createTable(context_, table_name, table, query);
-            return;
-        }
-    }
-    throw Exception(
-        ErrorCodes::LOGICAL_ERROR,
-        "There is no databases for CREATE TABLE `{}` query in database `{}` (engine {})",
-        table_name,
-        getDatabaseName(),
-        getEngineName());
-}
-
-void DatabasesOverlay::dropTable(ContextPtr context_, const String & table_name, bool sync)
-{
-    for (auto & db : databases)
-    {
-        if (db->isTableExist(table_name, context_))
-        {
-            db->dropTable(context_, table_name, sync);
-            return;
-        }
-    }
-    throw Exception(
-        ErrorCodes::LOGICAL_ERROR,
-        "There is no databases for DROP TABLE `{}` query in database `{}` (engine {})",
-        table_name,
-        getDatabaseName(),
-        getEngineName());
-}
-
-void DatabasesOverlay::attachTable(
-    ContextPtr context_, const String & table_name, const StoragePtr & table, const String & relative_table_path)
-{
-    for (auto & db : databases)
-    {
-        try
-        {
-            db->attachTable(context_, table_name, table, relative_table_path);
-            return;
-        }
-        catch (...)
-        {
-            continue;
-        }
-    }
-    throw Exception(
-        ErrorCodes::LOGICAL_ERROR,
-        "There is no databases for ATTACH TABLE `{}` query in database `{}` (engine {})",
-        table_name,
-        getDatabaseName(),
-        getEngineName());
-}
-
-StoragePtr DatabasesOverlay::detachTable(ContextPtr context_, const String & table_name)
-{
-    StoragePtr result = nullptr;
-    for (auto & db : databases)
-    {
-        if (db->isTableExist(table_name, context_))
-            return db->detachTable(context_, table_name);
-    }
-    throw Exception(
-        ErrorCodes::LOGICAL_ERROR,
-        "There is no databases for DETACH TABLE `{}` query in database `{}` (engine {})",
-        table_name,
-        getDatabaseName(),
-        getEngineName());
-}
-
-ASTPtr DatabasesOverlay::getCreateTableQueryImpl(const String & name, ContextPtr context_, bool throw_on_error) const
-{
-    ASTPtr result = nullptr;
-    for (const auto & db : databases)
-    {
-        result = db->tryGetCreateTableQuery(name, context_);
-        if (result)
-            break;
-    }
-    if (!result && throw_on_error)
-        throw Exception(
-            ErrorCodes::CANNOT_GET_CREATE_TABLE_QUERY,
-            "There is no metadata of table `{}` in database `{}` (engine {})",
-            name,
-            getDatabaseName(),
-            getEngineName());
-    return result;
-}
-
-/*
- * DatabaseOverlay cannot be constructed by "CREATE DATABASE" query, as it is not a traditional ClickHouse database
- * To use DatabaseOverlay, it must be constructed programmatically in code
- */
-ASTPtr DatabasesOverlay::getCreateDatabaseQuery() const
-{
-    return std::make_shared<ASTCreateQuery>();
-}
-
-String DatabasesOverlay::getTableDataPath(const String & table_name) const
-{
-    String result;
-    for (const auto & db : databases)
-    {
-        result = db->getTableDataPath(table_name);
-        if (!result.empty())
-            break;
-    }
-    return result;
-}
-
-String DatabasesOverlay::getTableDataPath(const ASTCreateQuery & query) const
-{
-    String result;
-    for (const auto & db : databases)
-    {
-        result = db->getTableDataPath(query);
-        if (!result.empty())
-            break;
-    }
-    return result;
-}
-
-UUID DatabasesOverlay::tryGetTableUUID(const String & table_name) const
-{
-    UUID result = UUIDHelpers::Nil;
-    for (const auto & db : databases)
-    {
-        result = db->tryGetTableUUID(table_name);
-        if (result != UUIDHelpers::Nil)
-            break;
-    }
-    return result;
-}
-
-void DatabasesOverlay::drop(ContextPtr context_)
-{
-    for (auto & db : databases)
-        db->drop(context_);
-}
-
-void DatabasesOverlay::alterTable(ContextPtr local_context, const StorageID & table_id, const StorageInMemoryMetadata & metadata)
-{
-    for (auto & db : databases)
-    {
-        if (!db->isReadOnly() && db->isTableExist(table_id.table_name, local_context))
-        {
-            db->alterTable(local_context, table_id, metadata);
-            return;
-        }
-    }
-    throw Exception(
-        ErrorCodes::LOGICAL_ERROR,
-        "There is no databases for ALTER TABLE `{}` query in database `{}` (engine {})",
-        table_id.table_name,
-        getDatabaseName(),
-        getEngineName());
-}
-
-std::vector<std::pair<ASTPtr, StoragePtr>>
-DatabasesOverlay::getTablesForBackup(const FilterByNameFunction & filter, const ContextPtr & local_context) const
-{
-    std::vector<std::pair<ASTPtr, StoragePtr>> result;
-    for (const auto & db : databases)
-    {
-        auto db_backup = db->getTablesForBackup(filter, local_context);
-        result.insert(result.end(), std::make_move_iterator(db_backup.begin()), std::make_move_iterator(db_backup.end()));
-    }
-    return result;
-}
-
-void DatabasesOverlay::createTableRestoredFromBackup(
-    const ASTPtr & create_table_query,
-    ContextMutablePtr local_context,
-    std::shared_ptr<IRestoreCoordination> /*restore_coordination*/,
-    UInt64 /*timeout_ms*/)
-{
-    /// Creates a tables by executing a "CREATE TABLE" query.
-    InterpreterCreateQuery interpreter{create_table_query, local_context};
-    interpreter.setInternal(true);
-    interpreter.execute();
-}
-
-bool DatabasesOverlay::empty() const
-{
-    for (const auto & db : databases)
-    {
-        if (!db->empty())
-            return false;
-    }
-    return true;
-}
-
-void DatabasesOverlay::shutdown()
-{
-    for (auto & db : databases)
-        db->shutdown();
-}
-
-DatabaseTablesIteratorPtr DatabasesOverlay::getTablesIterator(ContextPtr context_, const FilterByNameFunction & filter_by_table_name) const
-{
-    Tables tables;
-    for (const auto & db : databases)
-    {
-        for (auto table_it = db->getTablesIterator(context_, filter_by_table_name); table_it->isValid(); table_it->next())
-            tables.insert({table_it->name(), table_it->table()});
-    }
-    return std::make_unique<DatabaseTablesSnapshotIterator>(std::move(tables), getDatabaseName());
-}
-
-}
diff --git a/src/Databases/DatabasesOverlay.h b/src/Databases/DatabasesOverlay.h
deleted file mode 100644
index 0f31bbd6a47..00000000000
--- a/src/Databases/DatabasesOverlay.h
+++ /dev/null
@@ -1,66 +0,0 @@
-#pragma once
-
-#include <Storages/IStorage_fwd.h>
-#include <Databases/IDatabase.h>
-
-namespace DB
-{
-
-/**
- * Implements the IDatabase interface and combines multiple other databases
- * Searches for tables in each database in order until found, and delegates operations to the appropriate database
- * Useful for combining databases
- *
- * Used in clickhouse-local to combine DatabaseFileSystem and DatabaseMemory
- */
-class DatabasesOverlay : public IDatabase, protected WithContext
-{
-public:
-    DatabasesOverlay(const String & name_, ContextPtr context_);
-
-    /// Not thread-safe. Use only as factory to initialize database
-    DatabasesOverlay & registerNextDatabase(DatabasePtr database);
-
-    String getEngineName() const override { return "Overlay"; }
-
-public:
-    bool isTableExist(const String & table_name, ContextPtr context) const override;
-
-    StoragePtr tryGetTable(const String & table_name, ContextPtr context) const override;
-
-    void createTable(ContextPtr context, const String & table_name, const StoragePtr & table, const ASTPtr & query) override;
-
-    void dropTable(ContextPtr context, const String & table_name, bool sync) override;
-
-    void attachTable(ContextPtr context, const String & table_name, const StoragePtr & table, const String & relative_table_path) override;
-
-    StoragePtr detachTable(ContextPtr context, const String & table_name) override;
-
-    ASTPtr getCreateTableQueryImpl(const String & name, ContextPtr context, bool throw_on_error) const override;
-    ASTPtr getCreateDatabaseQuery() const override;
-
-    String getTableDataPath(const String & table_name) const override;
-    String getTableDataPath(const ASTCreateQuery & query) const override;
-
-    UUID tryGetTableUUID(const String & table_name) const override;
-
-    void drop(ContextPtr context) override;
-
-    void alterTable(ContextPtr local_context, const StorageID & table_id, const StorageInMemoryMetadata & metadata) override;
-
-    std::vector<std::pair<ASTPtr, StoragePtr>> getTablesForBackup(const FilterByNameFunction & filter, const ContextPtr & local_context) const override;
-
-    void createTableRestoredFromBackup(const ASTPtr & create_table_query, ContextMutablePtr local_context, std::shared_ptr<IRestoreCoordination> restore_coordination, UInt64 timeout_ms) override;
-
-    DatabaseTablesIteratorPtr getTablesIterator(ContextPtr context, const FilterByNameFunction & filter_by_table_name) const override;
-
-    bool empty() const override;
-
-    void shutdown() override;
-
-protected:
-    std::vector<DatabasePtr> databases;
-    Poco::Logger * log;
-};
-
-}
diff --git a/src/Databases/IDatabase.h b/src/Databases/IDatabase.h
index 6508e2ce060..53a2f372814 100644
--- a/src/Databases/IDatabase.h
+++ b/src/Databases/IDatabase.h
@@ -170,7 +170,7 @@ public:
     /// Get the table for work. Return nullptr if there is no table.
     virtual StoragePtr tryGetTable(const String & name, ContextPtr context) const = 0;
 
-    virtual StoragePtr getTable(const String & name, ContextPtr context) const;
+    StoragePtr getTable(const String & name, ContextPtr context) const;
 
     virtual UUID tryGetTableUUID(const String & /*table_name*/) const { return UUIDHelpers::Nil; }
 
@@ -183,8 +183,6 @@ public:
     /// Is the database empty.
     virtual bool empty() const = 0;
 
-    virtual bool isReadOnly() const { return false; }
-
     /// Add the table to the database. Record its presence in the metadata.
     virtual void createTable(
         ContextPtr /*context*/,
diff --git a/src/Interpreters/DatabaseCatalog.cpp b/src/Interpreters/DatabaseCatalog.cpp
index 129323cd6b3..8d3fa91a7fe 100644
--- a/src/Interpreters/DatabaseCatalog.cpp
+++ b/src/Interpreters/DatabaseCatalog.cpp
@@ -338,17 +338,9 @@ DatabaseAndTable DatabaseCatalog::getTableImpl(
         database = it->second;
     }
 
-    StoragePtr table = nullptr;
-    try
-    {
-        table = database->getTable(table_id.table_name, context_);
-    }
-    catch (const Exception & e)
-    {
-        if (exception)
-            exception->emplace(e);
-    }
-
+    auto table = database->tryGetTable(table_id.table_name, context_);
+    if (!table && exception)
+            exception->emplace(Exception(ErrorCodes::UNKNOWN_TABLE, "Table {} doesn't exist", table_id.getNameForLogs()));
     if (!table)
         database = nullptr;
 
diff --git a/tests/config/config.d/named_collection.xml b/tests/config/config.d/named_collection.xml
index 5b716a7b8da..2e49c0c596f 100644
--- a/tests/config/config.d/named_collection.xml
+++ b/tests/config/config.d/named_collection.xml
@@ -32,10 +32,5 @@
             <secret_access_key>testtest</secret_access_key>
             <structure>auto</structure>
         </s3_conn>
-        <s3_conn_db>
-            <url>http://localhost:11111/test/</url>
-            <access_key_id>test</access_key_id>
-            <secret_access_key>testtest</secret_access_key>
-        </s3_conn_db>
     </named_collections>
 </clickhouse>
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
deleted file mode 100644
index ccc02ad4f34..00000000000
--- a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.reference
+++ /dev/null
@@ -1,9 +0,0 @@
-Test 1: check explicit and implicit call of the file table function
-explicit:
-4
-implicit:
-4
-Test 2: check Filesystem database
-4
-Test 3: check show database with Filesystem
-test02707
diff --git a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh b/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
deleted file mode 100755
index 7c9095b3d8b..00000000000
--- a/tests/queries/0_stateless/02707_clickhouse_local_implicit_file_table_function.sh
+++ /dev/null
@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-
-CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
-# shellcheck source=../shell_config.sh
-. "$CURDIR"/../shell_config.sh
-
-dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
-[[ -d $dir ]] && rm -rd $dir
-mkdir $dir
-
-# Create temporary csv file for tests
-echo '"id","str","int","text"' > $dir/tmp.csv
-echo '1,"abc",123,"abacaba"' >> $dir/tmp.csv
-echo '2,"def",456,"bacabaa"' >> $dir/tmp.csv
-echo '3,"story",78912,"acabaab"' >> $dir/tmp.csv
-echo '4,"history",21321321,"cabaaba"' >> $dir/tmp.csv
-
-#################
-echo "Test 1: check explicit and implicit call of the file table function"
-
-echo "explicit:"
-$CLICKHOUSE_LOCAL -q "SELECT COUNT(*) FROM file('${dir}/tmp.csv')"
-echo "implicit:"
-$CLICKHOUSE_LOCAL -q "SELECT COUNT(*) FROM \"${dir}/tmp.csv\""
-
-#################
-echo "Test 2: check Filesystem database"
-$CLICKHOUSE_LOCAL --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test;
-CREATE DATABASE test ENGINE = Filesystem('${dir}');
-SELECT COUNT(*) FROM test.\`tmp.csv\`;
-DROP DATABASE test;
-"""
-
-#################
-echo "Test 3: check show database with Filesystem"
-$CLICKHOUSE_LOCAL --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test02707;
-CREATE DATABASE test02707 ENGINE = Filesystem('${dir}');
-SHOW DATABASES;
-DROP DATABASE test02707;
-""" | grep "test02707"
-
-# Remove temporary dir with files
-rm -rd $dir
diff --git a/tests/queries/0_stateless/02722_database_filesystem.reference b/tests/queries/0_stateless/02722_database_filesystem.reference
deleted file mode 100644
index c65dda7933a..00000000000
--- a/tests/queries/0_stateless/02722_database_filesystem.reference
+++ /dev/null
@@ -1,15 +0,0 @@
-Test 1: create filesystem database and check implicit calls
-0
-test1
-4
-4
-4
-Test 2: check DatabaseFilesystem access rights and errors handling on server
-OK
-OK
-OK
-OK
-OK
-OK
-OK
-OK
diff --git a/tests/queries/0_stateless/02722_database_filesystem.sh b/tests/queries/0_stateless/02722_database_filesystem.sh
deleted file mode 100755
index 4ff659ee746..00000000000
--- a/tests/queries/0_stateless/02722_database_filesystem.sh
+++ /dev/null
@@ -1,72 +0,0 @@
-#!/usr/bin/env bash
-# Tags: no-parallel
-
-CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
-# shellcheck source=../shell_config.sh
-. "$CURDIR"/../shell_config.sh
-
-# see 01658_read_file_to_stringcolumn.sh
-CLICKHOUSE_USER_FILES_PATH=$(clickhouse-client --query "select _path, _file from file('nonexist.txt', 'CSV', 'val1 char')" 2>&1 | grep Exception | awk '{gsub("/nonexist.txt","",$9); print $9}')
-
-# Prepare data
-unique_name=${CLICKHOUSE_TEST_UNIQUE_NAME}
-user_files_tmp_dir=${CLICKHOUSE_USER_FILES_PATH}/${unique_name}
-mkdir -p ${user_files_tmp_dir}/tmp/
-echo '"id","str","int","text"' > ${user_files_tmp_dir}/tmp.csv
-echo '1,"abc",123,"abacaba"' >> ${user_files_tmp_dir}/tmp.csv
-echo '2,"def",456,"bacabaa"' >> ${user_files_tmp_dir}/tmp.csv
-echo '3,"story",78912,"acabaab"' >> ${user_files_tmp_dir}/tmp.csv
-echo '4,"history",21321321,"cabaaba"' >> ${user_files_tmp_dir}/tmp.csv
-
-tmp_dir=${CLICKHOUSE_TEST_UNIQUE_NAME}
-[[ -d $tmp_dir ]] && rm -rd $tmp_dir
-mkdir $tmp_dir
-cp ${user_files_tmp_dir}/tmp.csv ${tmp_dir}/tmp.csv
-cp ${user_files_tmp_dir}/tmp.csv ${user_files_tmp_dir}/tmp/tmp.csv
-cp ${user_files_tmp_dir}/tmp.csv ${user_files_tmp_dir}/tmp.myext
-
-#################
-echo "Test 1: create filesystem database and check implicit calls"
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test1;
-CREATE DATABASE test1 ENGINE = Filesystem;
-"""
-echo $?
-${CLICKHOUSE_CLIENT} --query "SHOW DATABASES" | grep "test1"
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`${unique_name}/tmp.csv\`;"
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`${unique_name}/tmp/tmp.csv\`;"
-${CLICKHOUSE_LOCAL} -q "SELECT COUNT(*) FROM \"${tmp_dir}/tmp.csv\""
-
-#################
-echo "Test 2: check DatabaseFilesystem access rights and errors handling on server"
-# DATABASE_ACCESS_DENIED: Allows list files only inside user_files
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`../tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`/tmp/tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
-${CLICKHOUSE_CLIENT} --multiline --multiquery --query """
-USE test1;
-SELECT COUNT(*) FROM \"../${tmp_dir}/tmp.csv\";
-""" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`../../../../../../tmp.csv\`;" 2>&1| grep -F "Code: 291" > /dev/null && echo "OK"
-
-# BAD_ARGUMENTS: path should be inside user_files
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test2;
-CREATE DATABASE test2 ENGINE = Filesystem('/tmp');
-""" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
-
-# BAD_ARGUMENTS: .../user_files/relative_unknown_dir does not exists
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test2;
-CREATE DATABASE test2 ENGINE = Filesystem('relative_unknown_dir');
-""" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
-
-# FILE_DOESNT_EXIST: unknown file
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`tmp2.csv\`;" 2>&1| grep -F "Code: 107" > /dev/null && echo "OK"
-
-# BAD_ARGUMENTS: Cannot determine the file format by it's extension
-${CLICKHOUSE_CLIENT} --query "SELECT COUNT(*) FROM test1.\`${unique_name}/tmp.myext\`;" 2>&1| grep -F "Code: 36" > /dev/null && echo "OK"
-
-# Clean
-${CLICKHOUSE_CLIENT} --query "DROP DATABASE test1;"
-rm -rd $tmp_dir
-rm -rd $user_files_tmp_dir
diff --git a/tests/queries/0_stateless/02724_database_s3.reference b/tests/queries/0_stateless/02724_database_s3.reference
deleted file mode 100644
index 425cca6a077..00000000000
--- a/tests/queries/0_stateless/02724_database_s3.reference
+++ /dev/null
@@ -1,21 +0,0 @@
-Test 1: select from s3
-1	2	3
-4	5	6
-7	8	9
-0	0	0
-test1
-10	11	12
-13	14	15
-16	17	18
-0	0	0
-10	11	12
-13	14	15
-16	17	18
-0	0	0
-10	11	12
-13	14	15
-16	17	18
-0	0	0
-Test 2: check exceptions
-OK
-OK
diff --git a/tests/queries/0_stateless/02724_database_s3.sh b/tests/queries/0_stateless/02724_database_s3.sh
deleted file mode 100755
index 79199b43571..00000000000
--- a/tests/queries/0_stateless/02724_database_s3.sh
+++ /dev/null
@@ -1,63 +0,0 @@
-#!/usr/bin/env bash
-# Tags: no-fasttest, no-parallel
-# Tag no-fasttest: Depends on AWS
-
-CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
-# shellcheck source=../shell_config.sh
-. "$CUR_DIR"/../shell_config.sh
-
-#################
-echo "Test 1: select from s3"
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test1;
-CREATE DATABASE test1 ENGINE = S3;
-USE test1;
-SELECT * FROM \"http://localhost:11111/test/a.tsv\"
-"""
-${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test1
-
-# check credentials with absolute path
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test2;
-CREATE DATABASE test2 ENGINE = S3('', 'test', 'testtest');
-USE test2;
-SELECT * FROM \"http://localhost:11111/test/b.tsv\"
-"""
-
-# check credentials with relative path
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test4;
-CREATE DATABASE test4 ENGINE = S3('http://localhost:11111/test', 'test', 'testtest');
-USE test4;
-SELECT * FROM \"b.tsv\"
-"""
-
-# Check named collection loading
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test5;
-CREATE DATABASE test5 ENGINE = S3(s3_conn_db);
-SELECT * FROM test5.\`b.tsv\`
-"""
-
-#################
-echo "Test 2: check exceptions"
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test3;
-CREATE DATABASE test3 ENGINE = S3;
-USE test3;
-SELECT * FROM \"http://localhost:11111/test/a.myext\"
-""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK"
-
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-USE test3;
-SELECT * FROM \"abacaba\"
-""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK"
-
-# Cleanup
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test1;
-DROP DATABASE IF EXISTS test2;
-DROP DATABASE IF EXISTS test3;
-DROP DATABASE IF EXISTS test4;
-DROP DATABASE IF EXISTS test5;
-"""
diff --git a/tests/queries/0_stateless/02725_database_hdfs.reference b/tests/queries/0_stateless/02725_database_hdfs.reference
deleted file mode 100644
index ef8adae2bbc..00000000000
--- a/tests/queries/0_stateless/02725_database_hdfs.reference
+++ /dev/null
@@ -1,12 +0,0 @@
-Test 1: select from hdfs database
-1	2	3
-test1
-1	2	3
-test2
-Test 2: check exceptions
-OK0
-OK1
-OK2
-OK3
-OK4
-OK5
diff --git a/tests/queries/0_stateless/02725_database_hdfs.sh b/tests/queries/0_stateless/02725_database_hdfs.sh
deleted file mode 100755
index a78f3e6bbdc..00000000000
--- a/tests/queries/0_stateless/02725_database_hdfs.sh
+++ /dev/null
@@ -1,60 +0,0 @@
-#!/usr/bin/env bash
-# Tags: no-fasttest, use-hdfs, no-parallel
-
-CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
-# shellcheck source=../shell_config.sh
-. "$CURDIR"/../shell_config.sh
-
-# Prepare data
-${CLICKHOUSE_CLIENT} -q "insert into table function hdfs('hdfs://localhost:12222/test_02725_1.tsv', 'TSV', 'column1 UInt32, column2 UInt32, column3 UInt32') select 1, 2, 3 settings hdfs_truncate_on_insert=1;"
-${CLICKHOUSE_CLIENT} -q "insert into table function hdfs('hdfs://localhost:12222/test_02725_2.tsv', 'TSV', 'column1 UInt32, column2 UInt32, column3 UInt32') select 4, 5, 6 settings hdfs_truncate_on_insert=1;"
-
-#################
-echo "Test 1: select from hdfs database"
-
-# Database without specific host
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test1;
-CREATE DATABASE test1 ENGINE = HDFS;
-USE test1;
-SELECT * FROM \"hdfs://localhost:12222/test_02725_1.tsv\"
-"""
-${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test1
-
-# Database with host
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test2;
-CREATE DATABASE test2 ENGINE = HDFS('hdfs://localhost:12222');
-USE test2;
-SELECT * FROM \"test_02725_1.tsv\"
-"""
-${CLICKHOUSE_CLIENT} -q "SHOW DATABASES;" | grep test2
-
-#################
-echo "Test 2: check exceptions"
-
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test3;
-CREATE DATABASE test3 ENGINE = HDFS('abacaba');
-""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK0"
-
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test4;
-CREATE DATABASE test4 ENGINE = HDFS;
-USE test4;
-SELECT * FROM \"abacaba/file.tsv\"
-""" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK1"
-
-${CLICKHOUSE_CLIENT} -q "SELECT * FROM test4.\`http://localhost:11111/test/a.tsv\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK2"
-${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/file.myext\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK3"
-${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222/test_02725_3.tsv\`" 2>&1| grep -F "CANNOT_EXTRACT_TABLE_STRUCTURE" > /dev/null && echo "OK4"
-${CLICKHOUSE_CLIENT} --query "SELECT * FROM test4.\`hdfs://localhost:12222\`" 2>&1| grep -F "BAD_ARGUMENTS" > /dev/null && echo "OK5"
-
-
-# Cleanup
-${CLICKHOUSE_CLIENT} --multiline --multiquery -q """
-DROP DATABASE IF EXISTS test1;
-DROP DATABASE IF EXISTS test2;
-DROP DATABASE IF EXISTS test3;
-DROP DATABASE IF EXISTS test4;
-"""
\ No newline at end of file

From 815f4dc9a64415c3820b51060a57e8f7da47d60d Mon Sep 17 00:00:00 2001
From: Ryadh DAHIMENE <ryadh@clickhouse.com>
Date: Mon, 19 Jun 2023 12:34:36 +0200
Subject: [PATCH 561/722] Added a note about MacOS builds

---
 docs/en/engines/table-engines/integrations/mysql.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/en/engines/table-engines/integrations/mysql.md b/docs/en/engines/table-engines/integrations/mysql.md
index 6ff6221c877..7f292eff34b 100644
--- a/docs/en/engines/table-engines/integrations/mysql.md
+++ b/docs/en/engines/table-engines/integrations/mysql.md
@@ -35,6 +35,10 @@ The table structure can differ from the original MySQL table structure:
 - Column types may differ from those in the original MySQL table. ClickHouse tries to [cast](../../../engines/database-engines/mysql.md#data_types-support) values to the ClickHouse data types.
 - The [external_table_functions_use_nulls](../../../operations/settings/settings.md#external-table-functions-use-nulls) setting defines how to handle Nullable columns. Default value: 1. If 0, the table function does not make Nullable columns and inserts default values instead of nulls. This is also applicable for NULL values inside arrays.
 
+:::note
+The MySQL Table Engine is currently not available on the ClickHouse builds for MacOS ([issue](https://github.com/ClickHouse/ClickHouse/issues/21191))
+:::
+
 **Engine Parameters**
 
 - `host:port` — MySQL server address.

From a2d5c91a283580b771ecdb0d0ef4aee521301a9e Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 19 Jun 2023 11:56:02 +0200
Subject: [PATCH 562/722] cancel temp part with exception context when
 deduplication triggered

---
 src/Client/ClientBase.cpp                         | 15 +++++++++------
 src/Storages/MergeTree/MergeTreeDataWriter.cpp    | 14 ++++++++++++++
 src/Storages/MergeTree/MergeTreeDataWriter.h      |  1 +
 .../MergeTree/ReplicatedMergeTreeSink.cpp         |  2 ++
 4 files changed, 26 insertions(+), 6 deletions(-)

diff --git a/src/Client/ClientBase.cpp b/src/Client/ClientBase.cpp
index 52c1175fb3e..badee99d855 100644
--- a/src/Client/ClientBase.cpp
+++ b/src/Client/ClientBase.cpp
@@ -1165,11 +1165,20 @@ void ClientBase::onProfileEvents(Block & block)
 /// Flush all buffers.
 void ClientBase::resetOutput()
 {
+    /// Order is important: format, compression, file
+
     if (output_format)
         output_format->finalize();
     output_format.reset();
+
     logs_out_stream.reset();
 
+    if (out_file_buf)
+    {
+        out_file_buf->finalize();
+        out_file_buf.reset();
+    }
+
     if (pager_cmd)
     {
         pager_cmd->in.close();
@@ -1177,12 +1186,6 @@ void ClientBase::resetOutput()
     }
     pager_cmd = nullptr;
 
-    if (out_file_buf)
-    {
-        out_file_buf->finalize();
-        out_file_buf.reset();
-    }
-
     if (out_logs_buf)
     {
         out_logs_buf->finalize();
diff --git a/src/Storages/MergeTree/MergeTreeDataWriter.cpp b/src/Storages/MergeTree/MergeTreeDataWriter.cpp
index 6ff4d6be870..da2b9608e43 100644
--- a/src/Storages/MergeTree/MergeTreeDataWriter.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataWriter.cpp
@@ -46,6 +46,7 @@ namespace DB
 
 namespace ErrorCodes
 {
+    extern const int ABORTED;
     extern const int LOGICAL_ERROR;
     extern const int TOO_MANY_PARTS;
 }
@@ -147,6 +148,19 @@ void updateTTL(
 
 }
 
+void MergeTreeDataWriter::TemporaryPart::cancel()
+{
+    try
+    {
+        /// An exception context is needed to proper delete write buffers without finalization
+        throw Exception(ErrorCodes::ABORTED, "Cancel temporary part.");
+    }
+    catch (...)
+    {
+        *this = TemporaryPart{};
+    }
+}
+
 void MergeTreeDataWriter::TemporaryPart::finalize()
 {
     for (auto & stream : streams)
diff --git a/src/Storages/MergeTree/MergeTreeDataWriter.h b/src/Storages/MergeTree/MergeTreeDataWriter.h
index 5dc7bf40922..ed7151886f5 100644
--- a/src/Storages/MergeTree/MergeTreeDataWriter.h
+++ b/src/Storages/MergeTree/MergeTreeDataWriter.h
@@ -71,6 +71,7 @@ public:
 
         scope_guard temporary_directory_lock;
 
+        void cancel();
         void finalize();
     };
 
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
index 28dad454afe..b093b63b5d3 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreeSink.cpp
@@ -567,6 +567,7 @@ void ReplicatedMergeTreeSinkImpl<true>::finishDelayedChunk(const ZooKeeperWithFa
         {
             LOG_TRACE(log, "found duplicated inserts in the block");
             partition.block_with_partition.partition = std::move(partition.temp_part.part->partition.value);
+            partition.temp_part.cancel();
             partition.temp_part = storage.writer.writeTempPart(partition.block_with_partition, metadata_snapshot, context);
         }
 
@@ -585,6 +586,7 @@ void ReplicatedMergeTreeSinkImpl<true>::finishDelayedChunk(const ZooKeeperWithFa
             if (partition.block_id.empty())
                 break;
             partition.block_with_partition.partition = std::move(partition.temp_part.part->partition.value);
+            /// partition.temp_part is already finalized, no need to call cancel
             partition.temp_part = storage.writer.writeTempPart(partition.block_with_partition, metadata_snapshot, context);
         }
     }

From bd80ba17ed8ad9e68b3279434c9b0173372b29f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ra=C3=BAl=20Mar=C3=ADn?= <git@rmr.ninja>
Date: Mon, 19 Jun 2023 12:49:32 +0200
Subject: [PATCH 563/722] Don't report table function accesses to system.errors

---
 .../02789_table_functions_errors.reference           |  2 ++
 .../0_stateless/02789_table_functions_errors.sh      | 12 ++++++++++++
 2 files changed, 14 insertions(+)
 create mode 100644 tests/queries/0_stateless/02789_table_functions_errors.reference
 create mode 100755 tests/queries/0_stateless/02789_table_functions_errors.sh

diff --git a/tests/queries/0_stateless/02789_table_functions_errors.reference b/tests/queries/0_stateless/02789_table_functions_errors.reference
new file mode 100644
index 00000000000..af81158ecae
--- /dev/null
+++ b/tests/queries/0_stateless/02789_table_functions_errors.reference
@@ -0,0 +1,2 @@
+10
+1
diff --git a/tests/queries/0_stateless/02789_table_functions_errors.sh b/tests/queries/0_stateless/02789_table_functions_errors.sh
new file mode 100755
index 00000000000..081f7776ba0
--- /dev/null
+++ b/tests/queries/0_stateless/02789_table_functions_errors.sh
@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# Tags: no-parallel
+# Tag no-parallel: It uses system.errors values which are global
+
+CUR_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CUR_DIR"/../shell_config.sh
+
+# Simply calling a table function correctly should not increase system.errors
+OLD_ERROR_QUANTITY=$(${CLICKHOUSE_CLIENT} --query "SELECT sum(value) FROM system.errors WHERE name = 'UNKNOWN_TABLE'")
+${CLICKHOUSE_CLIENT} --query "SELECT count() FROM numbers(10)"
+${CLICKHOUSE_CLIENT} --query "SELECT sum(value) = ${OLD_ERROR_QUANTITY}  FROM system.errors WHERE name = 'UNKNOWN_TABLE'"

From ebdbf68262fb9b01ec655a4ab7f95e6f34d7adb2 Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Mon, 19 Jun 2023 13:31:35 +0200
Subject: [PATCH 564/722] upd docs

---
 docs/en/sql-reference/data-types/decimal.md | 6 +++++-
 docs/ru/sql-reference/data-types/decimal.md | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/en/sql-reference/data-types/decimal.md b/docs/en/sql-reference/data-types/decimal.md
index 8df8b2519e3..de16462c86e 100644
--- a/docs/en/sql-reference/data-types/decimal.md
+++ b/docs/en/sql-reference/data-types/decimal.md
@@ -32,7 +32,7 @@ For example, Decimal32(4) can contain numbers from -99999.9999 to 99999.9999 wit
 
 Internally data is represented as normal signed integers with respective bit width. Real value ranges that can be stored in memory are a bit larger than specified above, which are checked only on conversion from a string.
 
-Because modern CPUs do not support 128-bit integers natively, operations on Decimal128 are emulated. Because of this Decimal128 works significantly slower than Decimal32/Decimal64.
+Because modern CPUs do not support 128-bit and 256-bit integers natively, operations on Decimal128 and Decimal256 are emulated. Thus, Decimal128 and Decimal256 work significantly slower than Decimal32/Decimal64.
 
 ## Operations and Result Type
 
@@ -59,6 +59,10 @@ Some functions on Decimal return result as Float64 (for example, var or stddev).
 
 During calculations on Decimal, integer overflows might happen. Excessive digits in a fraction are discarded (not rounded). Excessive digits in integer part will lead to an exception.
 
+:::warning
+Overflow check is not implemented for Decimal128 and Decimal256. In case of overflow incorrect result is always silently returned.
+:::
+
 ``` sql
 SELECT toDecimal32(2, 4) AS x, x / 3
 ```
diff --git a/docs/ru/sql-reference/data-types/decimal.md b/docs/ru/sql-reference/data-types/decimal.md
index 81cb5079945..e1267409c70 100644
--- a/docs/ru/sql-reference/data-types/decimal.md
+++ b/docs/ru/sql-reference/data-types/decimal.md
@@ -31,7 +31,7 @@ sidebar_label: Decimal
 ## Внутреннее представление {#vnutrennee-predstavlenie}
 
 Внутри данные представляются как знаковые целые числа, соответсвующей разрядности. Реальные диапазоны, хранящиеся в ячейках памяти несколько больше заявленных. Заявленные диапазоны Decimal проверяются только при вводе числа из строкового представления.
-Поскольку современные CPU не поддерживают 128-битные числа, операции над Decimal128 эмулируются программно. Decimal128 работает в разы медленней чем Decimal32/Decimal64.
+Поскольку современные CPU не поддерживают 128-битные и 256-битные числа, для операций над Decimal128 и Decimal256 эмулируются программно. Данные типы работают в разы медленнее, чем Decimal32/Decimal64.
 
 ## Операции и типы результата {#operatsii-i-tipy-rezultata}
 
@@ -59,6 +59,10 @@ sidebar_label: Decimal
 
 При выполнении операций над типом Decimal могут происходить целочисленные переполнения. Лишняя дробная часть отбрасывается (не округляется). Лишняя целочисленная часть приводит к исключению.
 
+:::warning
+Проверка переполнения не реализована для Decimal128 и Decimal256. В случае переполнения, неверный результат всегда возвращается без выбрасывания исключения.
+:::
+
 ``` sql
 SELECT toDecimal32(2, 4) AS x, x / 3
 ```

From 90ced1aebc378f4a08bffda52b8b935093478c77 Mon Sep 17 00:00:00 2001
From: Nikita Taranov <nikita.taranov@clickhouse.com>
Date: Mon, 19 Jun 2023 13:48:52 +0200
Subject: [PATCH 565/722] use int64

---
 src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp b/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp
index 97586346c8f..8a2ee0ce9e1 100644
--- a/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp
+++ b/src/Storages/MergeTree/MergeTreePrefetchedReadPool.cpp
@@ -494,7 +494,7 @@ MergeTreePrefetchedReadPool::ThreadsTasks MergeTreePrefetchedReadPool::createThr
     ThreadsTasks result_threads_tasks;
     for (size_t i = 0, part_idx = 0; i < threads && part_idx < parts_infos.size(); ++i)
     {
-        ssize_t need_marks = min_marks_per_thread;
+        int64_t need_marks = min_marks_per_thread;
 
         /// Priority is given according to the prefetch number for each thread,
         /// e.g. the first task of each thread has the same priority and is greater

From d492acbcd2fa2807e87f8a07e15ae12684aa45a3 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 19 Jun 2023 13:36:29 +0000
Subject: [PATCH 566/722] Fix tests

---
 src/Processors/Formats/Impl/ORCBlockInputFormat.cpp | 2 +-
 src/Storages/StorageFile.cpp                        | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp b/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp
index 5e3c70bb1ef..016f07731d5 100644
--- a/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp
+++ b/src/Processors/Formats/Impl/ORCBlockInputFormat.cpp
@@ -64,6 +64,7 @@ Chunk ORCBlockInputFormat::generate()
     if (!table || !num_rows)
         return {};
 
+    approx_bytes_read_for_chunk = file_reader->GetRawORCReader()->getStripe(stripe_current)->getDataLength();
     ++stripe_current;
 
     Chunk res;
@@ -71,7 +72,6 @@ Chunk ORCBlockInputFormat::generate()
     /// Otherwise fill the missing columns with zero values of its type.
     BlockMissingValues * block_missing_values_ptr = format_settings.defaults_for_omitted_fields ? &block_missing_values : nullptr;
     arrow_column_to_ch_column->arrowTableToCHChunk(res, table, num_rows, block_missing_values_ptr);
-    approx_bytes_read_for_chunk = file_reader->GetRawORCReader()->getStripe(stripe_current)->getDataLength();
     return res;
 }
 
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index df358bd784d..7c04de1a28a 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -788,6 +788,7 @@ public:
             /// Close file prematurely if stream was ended.
             reader.reset();
             pipeline.reset();
+            input_format.reset();
             read_buf.reset();
         }
 

From d45092d63baa9c8787aff315bcb3885ee8cc3962 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 27 Apr 2023 17:04:56 +0200
Subject: [PATCH 567/722] Process the rebalance recomendation event on post-run

---
 tests/ci/worker/init_runner.sh | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index c8b11bc6e37..4b9c9c73674 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -78,6 +78,13 @@ if [[ ${ROOT_STAT[0]} -lt 3000000 ]] || [[ ${ROOT_STAT[1]} -lt 5 ]]; then
   terminate-and-exit
 fi
 
+# If there is a rebalance event, then the instance could die soon
+# Let's don't wait for it and terminate proactively
+if curl --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
+  echo 'The runner received rebalance recommendation, we are terminating'
+  terminate-and-exit
+fi
+
 # shellcheck disable=SC2046
 docker ps --quiet | xargs --no-run-if-empty docker kill ||:
 # shellcheck disable=SC2046

From 197d0d1314c2855f73735d870f8b1bf1c1db0038 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 3 May 2023 19:45:38 +0200
Subject: [PATCH 568/722] Process lifecycle hook in post-running action hook

---
 tests/ci/worker/init_runner.sh | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 4b9c9c73674..bdf34f01f9c 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -85,6 +85,13 @@ if curl --fail http://169.254.169.254/latest/meta-data/events/recommendations/re
   terminate-and-exit
 fi
 
+# Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish
+ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
+if [ "$ASG_STATUS" == "Terminated" ]; then
+  echo 'The runner is marked as "Terminated" by the autoscaling group, we are terminating'
+  terminate-and-exit
+fi
+
 # shellcheck disable=SC2046
 docker ps --quiet | xargs --no-run-if-empty docker kill ||:
 # shellcheck disable=SC2046

From 6cecdb8fca608ac08c601c509fb90ad8f8cd18f1 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 4 May 2023 14:49:59 +0200
Subject: [PATCH 569/722] Shutdown runner process and do not restart it on
 termination

---
 tests/ci/worker/init_runner.sh | 65 +++++++++++++++++++++-------------
 1 file changed, 41 insertions(+), 24 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index bdf34f01f9c..51c987cb6ae 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -48,6 +48,38 @@ chown ubuntu: /home/ubuntu/.ssh -R
 
 # Create a pre-run script that will provide diagnostics info
 mkdir -p /tmp/actions-hooks
+cat > /tmp/actions-hooks/common.sh << 'EOF'
+terminate-and-exit() {
+  echo "Going to terminate the runner"
+  INSTANCE_ID=$(ec2metadata --instance-id)
+  # To avoid the next job assigned, we kill the runner process with SIGTERM
+  # It should support SIGINT, but it does not work
+  # See https://github.com/actions/runner/issues/2582
+  pkill -SIGTERM Runner.Listener || :
+  # We execute it with `at` to not have it as an orphan process
+  # GH Runners kill all remain processes
+  echo "sleep 10; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
+    aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space
+  exit 0
+}
+
+check-terminating-metadata() {
+  # If there is a rebalance event, then the instance could die soon
+  # Let's don't wait for it and terminate proactively
+  if curl --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
+    echo 'The runner received rebalance recommendation, we are terminating'
+    terminate-and-exit
+  fi
+
+  # Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish
+  ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
+  if [ "$ASG_STATUS" == "Terminated" ]; then
+    echo 'The runner is marked as "Terminated" by the autoscaling group, we are terminating'
+    terminate-and-exit
+  fi
+}
+EOF
+
 cat > /tmp/actions-hooks/pre-run.sh << EOF
 #!/bin/bash
 set -uo pipefail
@@ -61,15 +93,9 @@ cat > /tmp/actions-hooks/post-run.sh << 'EOF'
 #!/bin/bash
 set -xuo pipefail
 
-terminate-and-exit() {
-  echo "Going to terminate the runner"
-  INSTANCE_ID=$(ec2metadata --instance-id)
-  # We execute it with at to not have it as an orphan process
-  # GH Runners kill all remain processes
-  echo "sleep 10; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
-    aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space
-  exit 0
-}
+source /tmp/actions-hooks/common.sh
+
+check-terminating-metadata
 
 # Free KiB, free percents
 ROOT_STAT=($(df / | awk '/\// {print $4 " " int($4/$2 * 100)}'))
@@ -78,20 +104,6 @@ if [[ ${ROOT_STAT[0]} -lt 3000000 ]] || [[ ${ROOT_STAT[1]} -lt 5 ]]; then
   terminate-and-exit
 fi
 
-# If there is a rebalance event, then the instance could die soon
-# Let's don't wait for it and terminate proactively
-if curl --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
-  echo 'The runner received rebalance recommendation, we are terminating'
-  terminate-and-exit
-fi
-
-# Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish
-ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
-if [ "$ASG_STATUS" == "Terminated" ]; then
-  echo 'The runner is marked as "Terminated" by the autoscaling group, we are terminating'
-  terminate-and-exit
-fi
-
 # shellcheck disable=SC2046
 docker ps --quiet | xargs --no-run-if-empty docker kill ||:
 # shellcheck disable=SC2046
@@ -116,12 +128,17 @@ if [ "$(docker ps --all --quiet)" ]; then
 fi
 EOF
 
+source /tmp/actions-hooks/common.sh
+
 while true; do
-    runner_pid=$(pgrep run.sh)
+    runner_pid=$(pgrep Runner.Listener)
     echo "Got runner pid $runner_pid"
 
     cd $RUNNER_HOME || exit 1
     if [ -z "$runner_pid" ]; then
+        # If runner is not active, check that it needs to terminate itself
+        check-terminating-metadata
+
         echo "Receiving token"
         RUNNER_TOKEN=$(/usr/local/bin/aws ssm  get-parameter --name github_runner_registration_token --with-decryption --output text --query Parameter.Value)
 

From 47ea7420762bd3fbdf50c79b2d422bd7dd881086 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 4 May 2023 17:19:12 +0200
Subject: [PATCH 570/722] Do not kill runner on the fly, delay 3 seconds

---
 tests/ci/worker/init_runner.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 51c987cb6ae..1516e9a05aa 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -49,16 +49,16 @@ chown ubuntu: /home/ubuntu/.ssh -R
 # Create a pre-run script that will provide diagnostics info
 mkdir -p /tmp/actions-hooks
 cat > /tmp/actions-hooks/common.sh << 'EOF'
+#!/bin/bash
 terminate-and-exit() {
   echo "Going to terminate the runner"
   INSTANCE_ID=$(ec2metadata --instance-id)
   # To avoid the next job assigned, we kill the runner process with SIGTERM
   # It should support SIGINT, but it does not work
   # See https://github.com/actions/runner/issues/2582
-  pkill -SIGTERM Runner.Listener || :
   # We execute it with `at` to not have it as an orphan process
   # GH Runners kill all remain processes
-  echo "sleep 10; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
+  echo "sleep 3; pkill -SIGTERM Runner.Listener; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
     aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space
   exit 0
 }

From 1688ba5cf5a77b3eac9f7e2bda505a072e94f2db Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 6 Jun 2023 12:37:55 +0200
Subject: [PATCH 571/722] Use ephemeral runners for GH actions

---
 tests/ci/worker/init_runner.sh | 66 +++++++++++++++++++++++-----------
 1 file changed, 46 insertions(+), 20 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 1516e9a05aa..23c1f3ab436 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -42,7 +42,7 @@ systemctl restart amazon-cloudwatch-agent.service
 
 # Refresh teams ssh keys
 TEAM_KEYS_URL=$(aws ssm get-parameter --region us-east-1 --name team-keys-url --query 'Parameter.Value' --output=text)
-curl "${TEAM_KEYS_URL}" > /home/ubuntu/.ssh/authorized_keys2
+curl -s "${TEAM_KEYS_URL}" > /home/ubuntu/.ssh/authorized_keys2
 chown ubuntu: /home/ubuntu/.ssh -R
 
 
@@ -50,23 +50,27 @@ chown ubuntu: /home/ubuntu/.ssh -R
 mkdir -p /tmp/actions-hooks
 cat > /tmp/actions-hooks/common.sh << 'EOF'
 #!/bin/bash
-terminate-and-exit() {
-  echo "Going to terminate the runner"
+terminate-delayed() {
+  sleep=7
+  echo "Going to terminate the runner's instance in $sleep seconds"
   INSTANCE_ID=$(ec2metadata --instance-id)
-  # To avoid the next job assigned, we kill the runner process with SIGTERM
-  # It should support SIGINT, but it does not work
-  # See https://github.com/actions/runner/issues/2582
-  # We execute it with `at` to not have it as an orphan process
+  # We execute it with `at` to not have it as an orphan process, but launched independently
   # GH Runners kill all remain processes
-  echo "sleep 3; pkill -SIGTERM Runner.Listener; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
-    aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space
+  echo "sleep '$sleep'; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
+    aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space or non-installed `at`
   exit 0
 }
 
+terminate-and-exit() {
+  echo "Going to terminate the runner's instance"
+  INSTANCE_ID=$(ec2metadata --instance-id)
+  aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"
+}
+
 check-terminating-metadata() {
   # If there is a rebalance event, then the instance could die soon
   # Let's don't wait for it and terminate proactively
-  if curl --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
+  if curl -s --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
     echo 'The runner received rebalance recommendation, we are terminating'
     terminate-and-exit
   fi
@@ -74,6 +78,14 @@ check-terminating-metadata() {
   # Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish
   ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
   if [ "$ASG_STATUS" == "Terminated" ]; then
+    INSTANCE_ID=$(ec2metadata --instance-id)
+    ASG_NAME=$(aws ec2 describe-tags --filters "Name=resource-id,Values=$INSTANCE_ID" --query "Tags[?Key=='aws:autoscaling:groupName'].Value" --output text)
+    LIFECYCLE_HOOKS=$(aws autoscaling describe-lifecycle-hooks --auto-scaling-group-name "$ASG_NAME" --query "LifecycleHooks[].LifecycleHookName" --output text)
+    for LCH in $LIFECYCLE_HOOKS; do
+      aws autoscaling complete-lifecycle-action --lifecycle-action-result CONTINUE \
+        --lifecycle-hook-name "$LCH" --auto-scaling-group-name "$ASG_NAME" \
+        --instance-id "$INSTANCE_ID"
+    done
     echo 'The runner is marked as "Terminated" by the autoscaling group, we are terminating'
     terminate-and-exit
   fi
@@ -95,13 +107,11 @@ set -xuo pipefail
 
 source /tmp/actions-hooks/common.sh
 
-check-terminating-metadata
-
 # Free KiB, free percents
 ROOT_STAT=($(df / | awk '/\// {print $4 " " int($4/$2 * 100)}'))
 if [[ ${ROOT_STAT[0]} -lt 3000000 ]] || [[ ${ROOT_STAT[1]} -lt 5 ]]; then
   echo "The runner has ${ROOT_STAT[0]}KiB and ${ROOT_STAT[1]}% of free space on /"
-  terminate-and-exit
+  terminate-delayed
 fi
 
 # shellcheck disable=SC2046
@@ -124,7 +134,7 @@ if [ "$(docker ps --all --quiet)" ]; then
     docker info && break || sleep 2
   done
   # Last chance, otherwise we have to terminate poor instance
-  docker info 1>/dev/null || { echo Docker unable to start; terminate-and-exit; }
+  docker info 1>/dev/null || { echo Docker unable to start; terminate-delayed ; }
 fi
 EOF
 
@@ -134,19 +144,21 @@ while true; do
     runner_pid=$(pgrep Runner.Listener)
     echo "Got runner pid $runner_pid"
 
-    cd $RUNNER_HOME || exit 1
     if [ -z "$runner_pid" ]; then
+        cd $RUNNER_HOME || exit 1
         # If runner is not active, check that it needs to terminate itself
+        echo "Checking if the instance suppose to terminate"
         check-terminating-metadata
 
         echo "Receiving token"
         RUNNER_TOKEN=$(/usr/local/bin/aws ssm  get-parameter --name github_runner_registration_token --with-decryption --output text --query Parameter.Value)
 
-        echo "Will try to remove runner"
-        sudo -u ubuntu ./config.sh remove --token "$RUNNER_TOKEN" ||:
-
         echo "Going to configure runner"
-        sudo -u ubuntu ./config.sh --url $RUNNER_URL --token "$RUNNER_TOKEN" --name "$INSTANCE_ID" --runnergroup Default --labels "$LABELS" --work _work
+        sudo -u ubuntu ./config.sh --url $RUNNER_URL --token "$RUNNER_TOKEN" --ephemeral \
+          --runnergroup Default --labels "$LABELS" --work _work --name "$INSTANCE_ID"
+
+        echo "Another one check to avoid race between runner and infrastructure"
+        check-terminating-metadata
 
         echo "Run"
         sudo -u ubuntu \
@@ -156,6 +168,20 @@ while true; do
         sleep 15
     else
         echo "Runner is working with pid $runner_pid, nothing to do"
-        sleep 10
+        # The runner does not provide a way to determine, if it runs the job,
+        # neither the way to determine if it just litens. But there should be a
+        # process for Runner.Worker. So if the runner just hangs around for long,
+        # we check if it's fine to let it go
+        if ! pgrep Runner.Worker > /dev/null; then
+            RUNNER_AGE=$(( $(date +%s) - $(stat -c +%Y /proc/"$runner_pid" 2>/dev/null || date +%s) ))
+            echo "The runner is launched $RUNNER_AGE seconds ago and still doesn't have launched Runner.Worker"
+            if (( 60 < RUNNER_AGE )); then
+                echo "Check if the instance should tear down"
+                check-terminating-metadata
+            fi
+        fi
+        sleep 5
     fi
 done
+
+# vim:ts=4:sw=4

From a5e31e98de93177f3f691d9a948ee6ef1cb5f2a6 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 6 Jun 2023 17:56:07 +0200
Subject: [PATCH 572/722] Decouple cleaning part from metrics lambda to a new
 one

---
 tests/ci/ci_runners_metrics_lambda/app.py     | 153 +--------
 tests/ci/clean_lost_instances_lambda/app.py   | 315 ++++++++++++++++++
 .../build_and_deploy_archive.sh               |   1 +
 .../clean_lost_instances_lambda/lambda_shared |   1 +
 .../requirements.txt                          |   2 +
 5 files changed, 323 insertions(+), 149 deletions(-)
 create mode 100644 tests/ci/clean_lost_instances_lambda/app.py
 create mode 120000 tests/ci/clean_lost_instances_lambda/build_and_deploy_archive.sh
 create mode 120000 tests/ci/clean_lost_instances_lambda/lambda_shared
 create mode 100644 tests/ci/clean_lost_instances_lambda/requirements.txt

diff --git a/tests/ci/ci_runners_metrics_lambda/app.py b/tests/ci/ci_runners_metrics_lambda/app.py
index 71a644fe072..5cb1e45dd14 100644
--- a/tests/ci/ci_runners_metrics_lambda/app.py
+++ b/tests/ci/ci_runners_metrics_lambda/app.py
@@ -30,122 +30,10 @@ from lambda_shared.token import (
 UNIVERSAL_LABEL = "universal"
 
 
-def get_dead_runners_in_ec2(runners: RunnerDescriptions) -> RunnerDescriptions:
-    """Returns instances that are offline/dead in EC2, or not found in EC2"""
-    ids = {
-        runner.name: runner
-        for runner in runners
-        # Only `i-deadbead123` are valid names for an instance ID
-        if runner.name.startswith("i-") and runner.offline and not runner.busy
-    }
-    if not ids:
-        return []
-
-    # Delete all offline runners with wrong name
-    result_to_delete = [
-        runner
-        for runner in runners
-        if not ids.get(runner.name) and runner.offline and not runner.busy
-    ]
-
-    client = boto3.client("ec2")
-
-    i = 0
-    inc = 100
-
-    print("Checking ids: ", " ".join(ids.keys()))
-    instances_statuses = []
-    while i < len(ids.keys()):
-        try:
-            instances_statuses.append(
-                client.describe_instance_status(
-                    InstanceIds=list(ids.keys())[i : i + inc]
-                )
-            )
-            # It applied only if all ids exist in EC2
-            i += inc
-        except ClientError as e:
-            # The list of non-existent instances is in the message:
-            #   The instance IDs 'i-069b1c256c06cf4e3, i-0f26430432b044035,
-            #   i-0faa2ff44edbc147e, i-0eccf2514585045ec, i-0ee4ee53e0daa7d4a,
-            #   i-07928f15acd473bad, i-0eaddda81298f9a85' do not exist
-            message = e.response["Error"]["Message"]
-            if message.startswith("The instance IDs '") and message.endswith(
-                "' do not exist"
-            ):
-                non_existent = message[18:-14].split(", ")
-                for n in non_existent:
-                    result_to_delete.append(ids.pop(n))
-            else:
-                raise
-
-    found_instances = set([])
-    print("Response", instances_statuses)
-    for instances_status in instances_statuses:
-        for instance_status in instances_status["InstanceStatuses"]:
-            if instance_status["InstanceState"]["Name"] in ("pending", "running"):
-                found_instances.add(instance_status["InstanceId"])
-
-    print("Found instances", found_instances)
-    for runner in result_to_delete:
-        print("Instance", runner.name, "is not alive, going to remove it")
-    for instance_id, runner in ids.items():
-        if instance_id not in found_instances:
-            print("Instance", instance_id, "is not found in EC2, going to remove it")
-            result_to_delete.append(runner)
-    return result_to_delete
-
-
-def get_lost_ec2_instances(runners: RunnerDescriptions) -> List[dict]:
-    client = boto3.client("ec2")
-    reservations = client.describe_instances(
-        Filters=[
-            {"Name": "tag-key", "Values": ["github:runner-type"]},
-            {"Name": "instance-state-name", "Values": ["pending", "running"]},
-        ],
-    )["Reservations"]
-    # flatten the reservation into instances
-    instances = [
-        instance
-        for reservation in reservations
-        for instance in reservation["Instances"]
-    ]
-    lost_instances = []
-    offline_runner_names = {
-        runner.name for runner in runners if runner.offline and not runner.busy
-    }
-    runner_names = {runner.name for runner in runners}
-    now = datetime.now().timestamp()
-
-    for instance in instances:
-        # Do not consider instances started 20 minutes ago as problematic
-        if now - instance["LaunchTime"].timestamp() < 1200:
-            continue
-
-        runner_type = [
-            tag["Value"]
-            for tag in instance["Tags"]
-            if tag["Key"] == "github:runner-type"
-        ][0]
-        # If there's no necessary labels in runner type it's fine
-        if not (UNIVERSAL_LABEL in runner_type or runner_type in RUNNER_TYPE_LABELS):
-            continue
-
-        if instance["InstanceId"] in offline_runner_names:
-            lost_instances.append(instance)
-            continue
-
-        if (
-            instance["State"]["Name"] == "running"
-            and not instance["InstanceId"] in runner_names
-        ):
-            lost_instances.append(instance)
-
-    return lost_instances
-
-
 def handler(event, context):
-    main(get_cached_access_token(), True, True)
+    _ = event
+    _ = context
+    main(get_cached_access_token(), True)
 
 
 def group_runners_by_tag(
@@ -226,25 +114,9 @@ def push_metrics_to_cloudwatch(
     client.put_metric_data(Namespace=namespace, MetricData=metrics_data)
 
 
-def delete_runner(access_token: str, runner: RunnerDescription) -> bool:
-    headers = {
-        "Authorization": f"token {access_token}",
-        "Accept": "application/vnd.github.v3+json",
-    }
-
-    response = requests.delete(
-        f"https://api.github.com/orgs/ClickHouse/actions/runners/{runner.id}",
-        headers=headers,
-    )
-    response.raise_for_status()
-    print(f"Response code deleting {runner.name} is {response.status_code}")
-    return bool(response.status_code == 204)
-
-
 def main(
     access_token: str,
     push_to_cloudwatch: bool,
-    delete_offline_runners: bool,
 ) -> None:
     gh_runners = list_runners(access_token)
     grouped_runners = group_runners_by_tag(gh_runners)
@@ -257,20 +129,6 @@ def main(
             for runner in group_runners:
                 print("\t", runner)
 
-    if delete_offline_runners:
-        print("Going to delete offline runners")
-        dead_runners = get_dead_runners_in_ec2(gh_runners)
-        for runner in dead_runners:
-            print("Deleting runner", runner)
-            delete_runner(access_token, runner)
-
-        lost_instances = get_lost_ec2_instances(gh_runners)
-        if lost_instances:
-            print("Going to terminate lost runners")
-            ids = [i["InstanceId"] for i in lost_instances]
-            print("Terminating runners:", ids)
-            boto3.client("ec2").terminate_instances(InstanceIds=ids)
-
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(description="Get list of runners and their states")
@@ -286,9 +144,6 @@ if __name__ == "__main__":
         action="store_true",
         help="Push metrics for active and busy runners to cloudwatch",
     )
-    parser.add_argument(
-        "--delete-offline", action="store_true", help="Remove offline runners"
-    )
 
     args = parser.parse_args()
 
@@ -315,4 +170,4 @@ if __name__ == "__main__":
 
     token = get_access_token_by_key_app(private_key, args.app_id)
 
-    main(token, args.push_to_cloudwatch, args.delete_offline)
+    main(token, args.push_to_cloudwatch)
diff --git a/tests/ci/clean_lost_instances_lambda/app.py b/tests/ci/clean_lost_instances_lambda/app.py
new file mode 100644
index 00000000000..6dfa13a178d
--- /dev/null
+++ b/tests/ci/clean_lost_instances_lambda/app.py
@@ -0,0 +1,315 @@
+#!/usr/bin/env python3
+"""
+Lambda function to:
+    - calculate number of running runners
+    - cleaning dead runners from GitHub
+    - terminating stale lost runners in EC2
+"""
+
+import argparse
+import sys
+from datetime import datetime
+from dataclasses import dataclass
+from typing import Dict, List
+
+import requests  # type: ignore
+import boto3  # type: ignore
+from botocore.exceptions import ClientError  # type: ignore
+
+from lambda_shared import (
+    RUNNER_TYPE_LABELS,
+    RunnerDescription,
+    RunnerDescriptions,
+    list_runners,
+)
+from lambda_shared.token import (
+    get_cached_access_token,
+    get_key_and_app_from_aws,
+    get_access_token_by_key_app,
+)
+
+UNIVERSAL_LABEL = "universal"
+
+
+@dataclass
+class LostInstance:
+    counter: int
+    seen: datetime
+
+    def set_offline(self) -> None:
+        now = datetime.now()
+        if now.timestamp() <= self.seen.timestamp() + 120:
+            # the instance is offline for more than 2 minutes, so we increase
+            # the counter
+            self.counter += 1
+        else:
+            self.counter = 1
+        self.seen = now
+
+    @property
+    def recently_offline(self) -> bool:
+        """Returns True if the instance has been seen less than 5 minutes ago"""
+        return datetime.now().timestamp() <= self.seen.timestamp() + 300
+
+    @property
+    def stable_offline(self) -> bool:
+        return self.counter >= 3
+
+
+LOST_INSTANCES = {}  # type: Dict["str", LostInstance]
+
+
+def get_dead_runners_in_ec2(runners: RunnerDescriptions) -> RunnerDescriptions:
+    """Returns instances that are offline/dead in EC2, or not found in EC2"""
+    ids = {
+        runner.name: runner
+        for runner in runners
+        # Only `i-deadbead123` are valid names for an instance ID
+        if runner.name.startswith("i-") and runner.offline and not runner.busy
+    }
+    if not ids:
+        return []
+
+    # Delete all offline runners with wrong name
+    result_to_delete = [
+        runner
+        for runner in runners
+        if not ids.get(runner.name) and runner.offline and not runner.busy
+    ]
+
+    client = boto3.client("ec2")
+
+    i = 0
+    inc = 100
+
+    print("Checking ids: ", " ".join(ids.keys()))
+    instances_statuses = []
+    while i < len(ids.keys()):
+        try:
+            instances_statuses.append(
+                client.describe_instance_status(
+                    InstanceIds=list(ids.keys())[i : i + inc]
+                )
+            )
+            # It applied only if all ids exist in EC2
+            i += inc
+        except ClientError as e:
+            # The list of non-existent instances is in the message:
+            #   The instance IDs 'i-069b1c256c06cf4e3, i-0f26430432b044035,
+            #   i-0faa2ff44edbc147e, i-0eccf2514585045ec, i-0ee4ee53e0daa7d4a,
+            #   i-07928f15acd473bad, i-0eaddda81298f9a85' do not exist
+            message = e.response["Error"]["Message"]
+            if message.startswith("The instance IDs '") and message.endswith(
+                "' do not exist"
+            ):
+                non_existent = message[18:-14].split(", ")
+                for n in non_existent:
+                    result_to_delete.append(ids.pop(n))
+            else:
+                raise
+
+    found_instances = set([])
+    print("Response", instances_statuses)
+    for instances_status in instances_statuses:
+        for instance_status in instances_status["InstanceStatuses"]:
+            if instance_status["InstanceState"]["Name"] in ("pending", "running"):
+                found_instances.add(instance_status["InstanceId"])
+
+    print("Found instances", found_instances)
+    for runner in result_to_delete:
+        print("Instance", runner.name, "is not alive, going to remove it")
+    for instance_id, runner in ids.items():
+        if instance_id not in found_instances:
+            print("Instance", instance_id, "is not found in EC2, going to remove it")
+            result_to_delete.append(runner)
+    return result_to_delete
+
+
+def handler(event, context):
+    _ = event
+    _ = context
+    main(get_cached_access_token(), True)
+
+
+def delete_runner(access_token: str, runner: RunnerDescription) -> bool:
+    headers = {
+        "Authorization": f"token {access_token}",
+        "Accept": "application/vnd.github.v3+json",
+    }
+
+    response = requests.delete(
+        f"https://api.github.com/orgs/ClickHouse/actions/runners/{runner.id}",
+        headers=headers,
+    )
+    response.raise_for_status()
+    print(f"Response code deleting {runner.name} is {response.status_code}")
+    return bool(response.status_code == 204)
+
+
+def get_lost_ec2_instances(runners: RunnerDescriptions) -> List[str]:
+    global LOST_INSTANCES
+    now = datetime.now()
+    client = boto3.client("ec2")
+    reservations = client.describe_instances(
+        Filters=[
+            {"Name": "tag-key", "Values": ["github:runner-type"]},
+            {"Name": "instance-state-name", "Values": ["pending", "running"]},
+        ],
+    )["Reservations"]
+    # flatten the reservation into instances
+    instances = [
+        instance
+        for reservation in reservations
+        for instance in reservation["Instances"]
+    ]
+    offline_runner_names = {
+        runner.name for runner in runners if runner.offline and not runner.busy
+    }
+    runner_names = {runner.name for runner in runners}
+
+    def offline_instance(iid: str) -> None:
+        if iid in LOST_INSTANCES:
+            LOST_INSTANCES[iid].set_offline()
+            return
+        LOST_INSTANCES[iid] = LostInstance(1, now)
+
+    for instance in instances:
+        # Do not consider instances started 20 minutes ago as problematic
+        if now.timestamp() - instance["LaunchTime"].timestamp() < 1200:
+            continue
+
+        runner_type = [
+            tag["Value"]
+            for tag in instance["Tags"]
+            if tag["Key"] == "github:runner-type"
+        ][0]
+        # If there's no necessary labels in runner type it's fine
+        if not (UNIVERSAL_LABEL in runner_type or runner_type in RUNNER_TYPE_LABELS):
+            continue
+
+        if instance["InstanceId"] in offline_runner_names:
+            offline_instance(instance["InstanceId"])
+            continue
+
+        if (
+            instance["State"]["Name"] == "running"
+            and not instance["InstanceId"] in runner_names
+        ):
+            offline_instance(instance["InstanceId"])
+
+    instance_ids = [instance["InstanceId"] for instance in instances]
+    # clean out long unseen instances
+    LOST_INSTANCES = {
+        instance_id: stats
+        for instance_id, stats in LOST_INSTANCES.items()
+        if stats.recently_offline and instance_id in instance_ids
+    }
+
+    return [
+        instance_id
+        for instance_id, stats in LOST_INSTANCES.items()
+        if stats.stable_offline
+    ]
+
+
+def continue_lifecycle_hooks(delete_offline_runners: bool) -> None:
+    """The function to trigger CONTINUE for instances' lifectycle hooks"""
+    asg_client = boto3.client("autoscaling")
+    as_groups = asg_client.describe_auto_scaling_groups(
+        Filters=[{"Name": "tag-key", "Values": ["github:runner-type"]}]
+    )["AutoScalingGroups"]
+    for asg in as_groups:
+        lifecycle_hooks = [
+            lch
+            for lch in asg_client.describe_lifecycle_hooks(
+                AutoScalingGroupName=asg["AutoScalingGroupName"]
+            )["LifecycleHooks"]
+            if lch["LifecycleTransition"] == "autoscaling:EC2_INSTANCE_TERMINATING"
+        ]
+        if not lifecycle_hooks:
+            continue
+        for instance in asg["Instances"]:
+            if (
+                instance["LifecycleState"] == "Terminating:Wait"
+                and instance["HealthStatus"] == "Unhealthy"
+            ):
+                print(
+                    f"The instance {instance['InstanceId']} is waiting for "
+                    "lyfecycle continue"
+                )
+                if delete_offline_runners:
+                    for lch in lifecycle_hooks:
+                        print(f"Continue lifecycle hook {lch['LifecycleHookName']}")
+                        asg_client.complete_lifecycle_action(
+                            LifecycleHookName=lch["LifecycleHookName"],
+                            AutoScalingGroupName=asg["AutoScalingGroupName"],
+                            LifecycleActionResult="CONTINUE",
+                            InstanceId=instance["InstanceId"],
+                        )
+
+
+def main(
+    access_token: str,
+    delete_offline_runners: bool,
+) -> None:
+    gh_runners = list_runners(access_token)
+
+    dead_runners = get_dead_runners_in_ec2(gh_runners)
+    print("Runners in GH API to terminate: ", [runner.name for runner in dead_runners])
+    if delete_offline_runners and dead_runners:
+        print("Going to delete offline runners")
+        for runner in dead_runners:
+            print("Deleting runner", runner)
+            delete_runner(access_token, runner)
+    elif dead_runners:
+        print("Would delete dead runners: ", dead_runners)
+
+    lost_instances = get_lost_ec2_instances(gh_runners)
+    print("Instances to terminate: ", lost_instances)
+    if delete_offline_runners:
+        if lost_instances:
+            print("Going to terminate lost instances")
+            boto3.client("ec2").terminate_instances(InstanceIds=lost_instances)
+
+    continue_lifecycle_hooks(delete_offline_runners)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="Get list of runners and their states")
+    parser.add_argument(
+        "-p", "--private-key-path", help="Path to file with private key"
+    )
+    parser.add_argument("-k", "--private-key", help="Private key")
+    parser.add_argument(
+        "-a", "--app-id", type=int, help="GitHub application ID", required=True
+    )
+    parser.add_argument(
+        "--delete-offline", action="store_true", help="Remove offline runners"
+    )
+
+    args = parser.parse_args()
+
+    if not args.private_key_path and not args.private_key:
+        print(
+            "Either --private-key-path or --private-key must be specified",
+            file=sys.stderr,
+        )
+
+    if args.private_key_path and args.private_key:
+        print(
+            "Either --private-key-path or --private-key must be specified",
+            file=sys.stderr,
+        )
+
+    if args.private_key:
+        private_key = args.private_key
+    elif args.private_key_path:
+        with open(args.private_key_path, "r") as key_file:
+            private_key = key_file.read()
+    else:
+        print("Attempt to get key and id from AWS secret manager")
+        private_key, args.app_id = get_key_and_app_from_aws()
+
+    token = get_access_token_by_key_app(private_key, args.app_id)
+
+    main(token, args.delete_offline)
diff --git a/tests/ci/clean_lost_instances_lambda/build_and_deploy_archive.sh b/tests/ci/clean_lost_instances_lambda/build_and_deploy_archive.sh
new file mode 120000
index 00000000000..96ba3fa024e
--- /dev/null
+++ b/tests/ci/clean_lost_instances_lambda/build_and_deploy_archive.sh
@@ -0,0 +1 @@
+../team_keys_lambda/build_and_deploy_archive.sh
\ No newline at end of file
diff --git a/tests/ci/clean_lost_instances_lambda/lambda_shared b/tests/ci/clean_lost_instances_lambda/lambda_shared
new file mode 120000
index 00000000000..ba86e090f6c
--- /dev/null
+++ b/tests/ci/clean_lost_instances_lambda/lambda_shared
@@ -0,0 +1 @@
+../lambda_shared_package/lambda_shared
\ No newline at end of file
diff --git a/tests/ci/clean_lost_instances_lambda/requirements.txt b/tests/ci/clean_lost_instances_lambda/requirements.txt
new file mode 100644
index 00000000000..e2b16067a93
--- /dev/null
+++ b/tests/ci/clean_lost_instances_lambda/requirements.txt
@@ -0,0 +1,2 @@
+../lambda_shared_package
+../lambda_shared_package[token]

From 8feb5146fc99e2420f64f1656975b7b238c89b0e Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 6 Jun 2023 18:32:17 +0200
Subject: [PATCH 573/722] Do not "update" the token and the instances
 infinitely

---
 tests/ci/lambda_shared_package/lambda_shared/token.py | 2 ++
 tests/ci/terminate_runner_lambda/app.py               | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/tests/ci/lambda_shared_package/lambda_shared/token.py b/tests/ci/lambda_shared_package/lambda_shared/token.py
index 174ea4625a3..d3bf15ab259 100644
--- a/tests/ci/lambda_shared_package/lambda_shared/token.py
+++ b/tests/ci/lambda_shared_package/lambda_shared/token.py
@@ -83,6 +83,8 @@ def get_cached_access_token() -> str:
     # used. The first setting and close-to-ttl are not counted as update
     if _cached_token.time != 0 or time.time() - 590 < _cached_token.time:
         _cached_token.updating = True
+    else:
+        _cached_token.updating = False
     private_key, app_id = get_key_and_app_from_aws()
     _cached_token.time = int(time.time())
     _cached_token.value = get_access_token_by_key_app(private_key, app_id)
diff --git a/tests/ci/terminate_runner_lambda/app.py b/tests/ci/terminate_runner_lambda/app.py
index 98b14508314..ed198d855b9 100644
--- a/tests/ci/terminate_runner_lambda/app.py
+++ b/tests/ci/terminate_runner_lambda/app.py
@@ -31,6 +31,8 @@ def get_cached_instances() -> dict:
     # used. The first setting and close-to-ttl are not counted as update
     if cached_instances.time != 0 or time.time() - 300 < cached_instances.time:
         cached_instances.updating = True
+    else:
+        cached_instances.updating = False
     ec2_client = boto3.client("ec2")
     instances_response = ec2_client.describe_instances(
         Filters=[{"Name": "instance-state-name", "Values": ["running"]}]

From 026ab3d4ce7d14631898df425a0cc30ecc8a8c2a Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 6 Jun 2023 20:39:05 +0200
Subject: [PATCH 574/722] Calculate current capacity according to HealthStatus

---
 tests/ci/autoscale_runners_lambda/app.py      | 31 +++++++++++++------
 .../autoscale_runners_lambda_test.py          |  1 +
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/tests/ci/autoscale_runners_lambda/app.py b/tests/ci/autoscale_runners_lambda/app.py
index bebfb594b59..4514c38ddad 100644
--- a/tests/ci/autoscale_runners_lambda/app.py
+++ b/tests/ci/autoscale_runners_lambda/app.py
@@ -100,8 +100,15 @@ def set_capacity(
         raise ValueError("Queue status is not in ['in_progress', 'queued']")
 
     scale_down, scale_up = get_scales(runner_type)
+    # With lyfecycle hooks some instances are actually free because some of
+    # them are in 'Terminating:Wait' state
+    effective_capacity = max(
+        asg["DesiredCapacity"],
+        len([ins for ins in asg["Instances"] if ins["HealthStatus"] == "Healthy"]),
+    )
+
     # How much nodes are free (positive) or need to be added (negative)
-    capacity_reserve = asg["DesiredCapacity"] - running - queued
+    capacity_reserve = effective_capacity - running - queued
     stop = False
     if capacity_reserve < 0:
         # This part is about scaling up
@@ -118,10 +125,11 @@ def set_capacity(
         stop = stop or asg["DesiredCapacity"] == desired_capacity
         if stop:
             logging.info(
-                "Do not increase ASG %s capacity, current capacity=%s, "
-                "maximum capacity=%s, running jobs=%s, queue size=%s",
+                "Do not increase ASG %s capacity, current capacity=%s, effective "
+                "capacity=%s, maximum capacity=%s, running jobs=%s, queue size=%s",
                 asg["AutoScalingGroupName"],
-                desired_capacity,
+                asg["DesiredCapacity"],
+                effective_capacity,
                 asg["MaxSize"],
                 running,
                 queued,
@@ -130,9 +138,10 @@ def set_capacity(
 
         logging.info(
             "The ASG %s capacity will be increased to %s, current capacity=%s, "
-            "maximum capacity=%s, running jobs=%s, queue size=%s",
+            "effective capacity=%sm maximum capacity=%s, running jobs=%s, queue size=%s",
             asg["AutoScalingGroupName"],
             desired_capacity,
+            effective_capacity,
             asg["DesiredCapacity"],
             asg["MaxSize"],
             running,
@@ -153,10 +162,11 @@ def set_capacity(
     stop = stop or asg["DesiredCapacity"] == desired_capacity
     if stop:
         logging.info(
-            "Do not decrease ASG %s capacity, current capacity=%s, "
-            "minimum capacity=%s, running jobs=%s, queue size=%s",
+            "Do not decrease ASG %s capacity, current capacity=%s, effective "
+            "capacity=%s, minimum capacity=%s, running jobs=%s, queue size=%s",
             asg["AutoScalingGroupName"],
-            desired_capacity,
+            asg["DesiredCapacity"],
+            effective_capacity,
             asg["MinSize"],
             running,
             queued,
@@ -164,11 +174,12 @@ def set_capacity(
         return
 
     logging.info(
-        "The ASG %s capacity will be decreased to %s, current capacity=%s, "
-        "minimum capacity=%s, running jobs=%s, queue size=%s",
+        "The ASG %s capacity will be decreased to %s, current capacity=%s, effective "
+        "capacity=%s, minimum capacity=%s, running jobs=%s, queue size=%s",
         asg["AutoScalingGroupName"],
         desired_capacity,
         asg["DesiredCapacity"],
+        effective_capacity,
         asg["MinSize"],
         running,
         queued,
diff --git a/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py b/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
index 6772e33374c..b17135df583 100644
--- a/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
+++ b/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
@@ -56,6 +56,7 @@ class TestSetCapacity(unittest.TestCase):
                         "DesiredCapacity": desired_capacity,
                         "MinSize": min_size,
                         "MaxSize": max_size,
+                        "Instances": [],  # necessary for ins["HealthStatus"] check
                     }
                 ]
             }

From 915f431b95cc0e762c8071e77c7c4a17560aeed5 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 7 Jun 2023 13:30:48 +0200
Subject: [PATCH 575/722] Tune the shutting down on rebalance signal

---
 tests/ci/worker/init_runner.sh | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 23c1f3ab436..4190c3fca0b 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -71,8 +71,20 @@ check-terminating-metadata() {
   # If there is a rebalance event, then the instance could die soon
   # Let's don't wait for it and terminate proactively
   if curl -s --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
-    echo 'The runner received rebalance recommendation, we are terminating'
-    terminate-and-exit
+    echo 'The received recommendation to rebalance, checking the uptime'
+    UPTIME=$(< /proc/uptime)
+    UPTIME=${UPTIME%%.*}
+    # We don't shutdown the instances younger than 30m
+    if (( 1800 < UPTIME )); then
+      # To not shutdown everything at once, use the 66% to survive
+      if (( $((RANDOM % 3)) == 0 )); then
+        echo 'The instance is older than 30m and won the roulette'
+        terminate-and-exit
+      fi
+      echo 'The instance is older than 30m, but is not chosen for rebalance'
+    else
+      echo 'The instance is younger than 30m, do not shut it down'
+    fi
   fi
 
   # Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish

From d672bd3382c690e4b2207e1dab1282c42d1915f0 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Wed, 7 Jun 2023 17:27:03 +0200
Subject: [PATCH 576/722] Stop the runner if there are no running jobs for long

---
 tests/ci/worker/init_runner.sh | 168 +++++++++++++++++++++------------
 1 file changed, 106 insertions(+), 62 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 4190c3fca0b..e6dc047bb3a 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -50,60 +50,95 @@ chown ubuntu: /home/ubuntu/.ssh -R
 mkdir -p /tmp/actions-hooks
 cat > /tmp/actions-hooks/common.sh << 'EOF'
 #!/bin/bash
-terminate-delayed() {
-  sleep=7
-  echo "Going to terminate the runner's instance in $sleep seconds"
-  INSTANCE_ID=$(ec2metadata --instance-id)
-  # We execute it with `at` to not have it as an orphan process, but launched independently
-  # GH Runners kill all remain processes
-  echo "sleep '$sleep'; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
-    aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space or non-installed `at`
-  exit 0
-}
-
-terminate-and-exit() {
-  echo "Going to terminate the runner's instance"
-  INSTANCE_ID=$(ec2metadata --instance-id)
-  aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"
-}
-
-check-terminating-metadata() {
-  # If there is a rebalance event, then the instance could die soon
-  # Let's don't wait for it and terminate proactively
-  if curl -s --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
-    echo 'The received recommendation to rebalance, checking the uptime'
-    UPTIME=$(< /proc/uptime)
-    UPTIME=${UPTIME%%.*}
-    # We don't shutdown the instances younger than 30m
-    if (( 1800 < UPTIME )); then
-      # To not shutdown everything at once, use the 66% to survive
-      if (( $((RANDOM % 3)) == 0 )); then
-        echo 'The instance is older than 30m and won the roulette'
-        terminate-and-exit
-      fi
-      echo 'The instance is older than 30m, but is not chosen for rebalance'
-    else
-      echo 'The instance is younger than 30m, do not shut it down'
-    fi
-  fi
-
-  # Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish
-  ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
-  if [ "$ASG_STATUS" == "Terminated" ]; then
-    INSTANCE_ID=$(ec2metadata --instance-id)
-    ASG_NAME=$(aws ec2 describe-tags --filters "Name=resource-id,Values=$INSTANCE_ID" --query "Tags[?Key=='aws:autoscaling:groupName'].Value" --output text)
-    LIFECYCLE_HOOKS=$(aws autoscaling describe-lifecycle-hooks --auto-scaling-group-name "$ASG_NAME" --query "LifecycleHooks[].LifecycleHookName" --output text)
-    for LCH in $LIFECYCLE_HOOKS; do
-      aws autoscaling complete-lifecycle-action --lifecycle-action-result CONTINUE \
-        --lifecycle-hook-name "$LCH" --auto-scaling-group-name "$ASG_NAME" \
-        --instance-id "$INSTANCE_ID"
-    done
-    echo 'The runner is marked as "Terminated" by the autoscaling group, we are terminating'
-    terminate-and-exit
-  fi
-}
 EOF
 
+terminate_delayed() {
+    # The function for post hook to gracefully finish the job and then tear down
+    # The very specific sleep time is used later to determine in the main loop if
+    # the instance is tearing down
+    # IF `sleep` IS CHANGED, CHANGE ANOTHER VALUE IN `pgrep`
+    sleep=13.14159265358979323846
+    echo "Going to terminate the runner's instance in $sleep seconds"
+    INSTANCE_ID=$(ec2metadata --instance-id)
+    # We execute it with `at` to not have it as an orphan process, but launched independently
+    # GH Runners kill all remain processes
+    echo "sleep '$sleep'; aws ec2 terminate-instances --instance-ids $INSTANCE_ID" | at now || \
+        aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"  # workaround for complete out of space or non-installed `at`
+    exit 0
+}
+
+detect_delayed_termination() {
+    # The function look for very specific sleep with pi
+    if pgrep 'sleep 13.14159265358979323846'; then
+        echo 'The instance has delayed termination, sleep the same time to wait if it goes down'
+        sleep 14
+    fi
+}
+
+declare -f terminate_delayed >> /tmp/actions-hooks/common.sh
+
+terminate_and_exit() {
+    # Terminate instance and exit from the script instantly
+    echo "Going to terminate the runner's instance"
+    INSTANCE_ID=$(ec2metadata --instance-id)
+    aws ec2 terminate-instances --instance-ids "$INSTANCE_ID"
+    exit 0
+}
+
+declare -f terminate_and_exit >> /tmp/actions-hooks/common.sh
+
+no_terminating_metadata() {
+    # The function check that instance could continue work
+    # Returns 1 if any of termination events are received
+    if curl -s --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
+        echo 'Received recommendation to rebalance, checking the uptime'
+        UPTIME=$(< /proc/uptime)
+        UPTIME=${UPTIME%%.*}
+        # We don't shutdown the instances younger than 30m
+        if (( 1800 < UPTIME )); then
+            # To not shutdown everything at once, use the 66% to survive
+            if (( $((RANDOM % 3)) == 0 )); then
+                echo 'The instance is older than 30m and won the roulette'
+                return 1
+            fi
+            echo 'The instance is older than 30m, but is not chosen for rebalance'
+        else
+            echo 'The instance is younger than 30m, do not shut it down'
+        fi
+    fi
+
+    local ASG_STATUS
+    ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
+    if [ "$ASG_STATUS" == "Terminated" ]; then
+        echo 'The instance in ASG status Terminating:Wait'
+        return 1
+    fi
+}
+
+terminate_on_event() {
+    # If there is a rebalance event, then the instance could die soon
+    # Let's don't wait for it and terminate proactively
+    if curl -s --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
+        terminate_and_exit
+    fi
+
+    # Here we check if the autoscaling group marked the instance for termination, and it's wait for the job to finish
+    ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
+    if [ "$ASG_STATUS" == "Terminated" ]; then
+        INSTANCE_ID=$(ec2metadata --instance-id)
+        ASG_NAME=$(aws ec2 describe-tags --filters "Name=resource-id,Values=$INSTANCE_ID" --query "Tags[?Key=='aws:autoscaling:groupName'].Value" --output text)
+        LIFECYCLE_HOOKS=$(aws autoscaling describe-lifecycle-hooks --auto-scaling-group-name "$ASG_NAME" --query "LifecycleHooks[].LifecycleHookName" --output text)
+        for LCH in $LIFECYCLE_HOOKS; do
+            aws autoscaling complete-lifecycle-action --lifecycle-action-result CONTINUE \
+                --lifecycle-hook-name "$LCH" --auto-scaling-group-name "$ASG_NAME" \
+                --instance-id "$INSTANCE_ID"
+            true  # autoformat issue
+        done
+        echo 'The runner is marked as "Terminated" by the autoscaling group, we are terminating'
+        terminate_and_exit
+    fi
+}
+
 cat > /tmp/actions-hooks/pre-run.sh << EOF
 #!/bin/bash
 set -uo pipefail
@@ -123,7 +158,7 @@ source /tmp/actions-hooks/common.sh
 ROOT_STAT=($(df / | awk '/\// {print $4 " " int($4/$2 * 100)}'))
 if [[ ${ROOT_STAT[0]} -lt 3000000 ]] || [[ ${ROOT_STAT[1]} -lt 5 ]]; then
   echo "The runner has ${ROOT_STAT[0]}KiB and ${ROOT_STAT[1]}% of free space on /"
-  terminate-delayed
+  terminate_delayed
 fi
 
 # shellcheck disable=SC2046
@@ -146,11 +181,13 @@ if [ "$(docker ps --all --quiet)" ]; then
     docker info && break || sleep 2
   done
   # Last chance, otherwise we have to terminate poor instance
-  docker info 1>/dev/null || { echo Docker unable to start; terminate-delayed ; }
+  docker info 1>/dev/null || { echo Docker unable to start; terminate_delayed ; }
 fi
 EOF
 
-source /tmp/actions-hooks/common.sh
+get_runner_token() {
+    /usr/local/bin/aws ssm  get-parameter --name github_runner_registration_token --with-decryption --output text --query Parameter.Value
+}
 
 while true; do
     runner_pid=$(pgrep Runner.Listener)
@@ -158,19 +195,17 @@ while true; do
 
     if [ -z "$runner_pid" ]; then
         cd $RUNNER_HOME || exit 1
+        detect_delayed_termination
         # If runner is not active, check that it needs to terminate itself
         echo "Checking if the instance suppose to terminate"
-        check-terminating-metadata
-
-        echo "Receiving token"
-        RUNNER_TOKEN=$(/usr/local/bin/aws ssm  get-parameter --name github_runner_registration_token --with-decryption --output text --query Parameter.Value)
+        no_terminating_metadata || terminate_on_event
 
         echo "Going to configure runner"
-        sudo -u ubuntu ./config.sh --url $RUNNER_URL --token "$RUNNER_TOKEN" --ephemeral \
+        sudo -u ubuntu ./config.sh --url $RUNNER_URL --token "$(get_runner_token)" --ephemeral \
           --runnergroup Default --labels "$LABELS" --work _work --name "$INSTANCE_ID"
 
         echo "Another one check to avoid race between runner and infrastructure"
-        check-terminating-metadata
+        no_terminating_metadata || terminate_on_event
 
         echo "Run"
         sudo -u ubuntu \
@@ -189,7 +224,16 @@ while true; do
             echo "The runner is launched $RUNNER_AGE seconds ago and still doesn't have launched Runner.Worker"
             if (( 60 < RUNNER_AGE )); then
                 echo "Check if the instance should tear down"
-                check-terminating-metadata
+                if ! no_terminating_metadata; then
+                    # Another check if the worker still didn't start
+                    if pgrep Runner.Worker; then
+                        echo "During the metadata check the job was assigned, continue"
+                        continue
+                    fi
+                    kill -9 "$runner_pid"
+                    sudo -u ubuntu ./config.sh remove --token "$(get_runner_token)"
+                    terminate_on_event
+                fi
             fi
         fi
         sleep 5

From d8e3d5c80324a200267bcbc73d821d9d682da810 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Thu, 8 Jun 2023 17:59:44 +0200
Subject: [PATCH 577/722] Kill the instance proactively on spot termination

---
 tests/ci/worker/init_runner.sh | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index e6dc047bb3a..327377c1eaf 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -214,7 +214,22 @@ while true; do
           ./run.sh &
         sleep 15
     else
-        echo "Runner is working with pid $runner_pid, nothing to do"
+        echo "Runner is working with pid $runner_pid, checking the metadata in background"
+        if TERMINATION_DATA=$(curl -s --fail http://169.254.169.254/latest/meta-data/spot/instance-action); then
+            # https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-instance-termination-notices.html#instance-action-metadata
+            _action=$(jq '.action' -r <<< "$TERMINATION_DATA")
+            _time=$(jq '.time | fromdate' <<< "$TERMINATION_DATA")
+            _until_action=$((_time - $(date +%s)))
+            echo "Received the $_action event that will be effective in $_until_action seconds"
+            if (( _until_action <= 30 )); then
+                echo "The action $_action will be done in $_until_action, killing the runner and exit"
+                # Kill the runner to not allow it cancelling the job
+                kill -9 "$runner_pid"
+                sudo -u ubuntu ./config.sh remove --token "$(get_runner_token)"
+                terminate_and_exit
+            fi
+
+        fi
         # The runner does not provide a way to determine, if it runs the job,
         # neither the way to determine if it just litens. But there should be a
         # process for Runner.Worker. So if the runner just hangs around for long,

From d782b058459d6b0aba633fb4deb41a9bdf38fe68 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Fri, 9 Jun 2023 15:56:37 +0200
Subject: [PATCH 578/722] Continue LCH for terminated instances, add logging

---
 tests/ci/clean_lost_instances_lambda/app.py | 37 ++++++++++++++++-----
 1 file changed, 29 insertions(+), 8 deletions(-)

diff --git a/tests/ci/clean_lost_instances_lambda/app.py b/tests/ci/clean_lost_instances_lambda/app.py
index 6dfa13a178d..65f6ff78d4a 100644
--- a/tests/ci/clean_lost_instances_lambda/app.py
+++ b/tests/ci/clean_lost_instances_lambda/app.py
@@ -204,6 +204,7 @@ def get_lost_ec2_instances(runners: RunnerDescriptions) -> List[str]:
         for instance_id, stats in LOST_INSTANCES.items()
         if stats.recently_offline and instance_id in instance_ids
     }
+    print("The remained LOST_INSTANCES: ", LOST_INSTANCES)
 
     return [
         instance_id
@@ -214,6 +215,20 @@ def get_lost_ec2_instances(runners: RunnerDescriptions) -> List[str]:
 
 def continue_lifecycle_hooks(delete_offline_runners: bool) -> None:
     """The function to trigger CONTINUE for instances' lifectycle hooks"""
+    client = boto3.client("ec2")
+    reservations = client.describe_instances(
+        Filters=[
+            {"Name": "tag-key", "Values": ["github:runner-type"]},
+            {"Name": "instance-state-name", "Values": ["shutting-down", "terminated"]},
+        ],
+    )["Reservations"]
+    # flatten the reservation into instances
+    terminated_instances = [
+        instance["InstanceId"]
+        for reservation in reservations
+        for instance in reservation["Instances"]
+    ]
+
     asg_client = boto3.client("autoscaling")
     as_groups = asg_client.describe_auto_scaling_groups(
         Filters=[{"Name": "tag-key", "Values": ["github:runner-type"]}]
@@ -229,14 +244,20 @@ def continue_lifecycle_hooks(delete_offline_runners: bool) -> None:
         if not lifecycle_hooks:
             continue
         for instance in asg["Instances"]:
-            if (
-                instance["LifecycleState"] == "Terminating:Wait"
-                and instance["HealthStatus"] == "Unhealthy"
-            ):
-                print(
-                    f"The instance {instance['InstanceId']} is waiting for "
-                    "lyfecycle continue"
-                )
+            continue_instance = False
+            if instance["LifecycleState"] == "Terminating:Wait":
+                if instance["HealthStatus"] == "Unhealthy":
+                    print(f"The instance {instance['InstanceId']} is Unhealthy")
+                    continue_instance = True
+                elif (
+                    instance["HealthStatus"] == "Healthy"
+                    and instance["InstanceId"] in terminated_instances
+                ):
+                    print(
+                        f"The instance {instance['InstanceId']} is already terminated"
+                    )
+                    continue_instance = True
+            if continue_instance:
                 if delete_offline_runners:
                     for lch in lifecycle_hooks:
                         print(f"Continue lifecycle hook {lch['LifecycleHookName']}")

From 4d5160a3bac8c5b847de5d2796e221d731d1bc45 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 12 Jun 2023 16:39:15 +0200
Subject: [PATCH 579/722] Improve determination of job received

---
 tests/ci/worker/init_runner.sh | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 327377c1eaf..19b20f96be6 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -189,6 +189,25 @@ get_runner_token() {
     /usr/local/bin/aws ssm  get-parameter --name github_runner_registration_token --with-decryption --output text --query Parameter.Value
 }
 
+is_job_assigned() {
+    local runner_pid
+    runner_pid=$(pgrep Runner.Listener)
+    if [ -z "$runner_pid" ]; then
+        # if runner has finished, it's fine
+        return 0
+    fi
+    local log_file
+    log_file=$(lsof -p "$runner_pid" 2>/dev/null | grep -o "$RUNNER_HOME/_diag/Runner.*log")
+    if [ -z "$log_file" ]; then
+        # assume, the process is over or just started
+        return 0
+    fi
+    # So far it's the only solid way to determine that the job is starting
+    grep -q 'Terminal] .* Running job:' "$log_file" \
+        && return 0 \
+        || return 1
+}
+
 while true; do
     runner_pid=$(pgrep Runner.Listener)
     echo "Got runner pid $runner_pid"
@@ -230,18 +249,14 @@ while true; do
             fi
 
         fi
-        # The runner does not provide a way to determine, if it runs the job,
-        # neither the way to determine if it just litens. But there should be a
-        # process for Runner.Worker. So if the runner just hangs around for long,
-        # we check if it's fine to let it go
-        if ! pgrep Runner.Worker > /dev/null; then
+        if ! is_job_assigned; then
             RUNNER_AGE=$(( $(date +%s) - $(stat -c +%Y /proc/"$runner_pid" 2>/dev/null || date +%s) ))
-            echo "The runner is launched $RUNNER_AGE seconds ago and still doesn't have launched Runner.Worker"
+            echo "The runner is launched $RUNNER_AGE seconds ago and still has hot received the job"
             if (( 60 < RUNNER_AGE )); then
                 echo "Check if the instance should tear down"
                 if ! no_terminating_metadata; then
                     # Another check if the worker still didn't start
-                    if pgrep Runner.Worker; then
+                    if is_job_assigned; then
                         echo "During the metadata check the job was assigned, continue"
                         continue
                     fi

From 1a8571c46515308757ed3588287b4531b6980640 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 13 Jun 2023 15:23:42 +0200
Subject: [PATCH 580/722] Check and proceed spot termination on runner setup

---
 tests/ci/worker/init_runner.sh | 47 ++++++++++++++++++++++------------
 1 file changed, 31 insertions(+), 16 deletions(-)

diff --git a/tests/ci/worker/init_runner.sh b/tests/ci/worker/init_runner.sh
index 19b20f96be6..171dd743f90 100644
--- a/tests/ci/worker/init_runner.sh
+++ b/tests/ci/worker/init_runner.sh
@@ -87,9 +87,34 @@ terminate_and_exit() {
 
 declare -f terminate_and_exit >> /tmp/actions-hooks/common.sh
 
+check_proceed_spot_termination() {
+    # The function checks and proceeds spot instance termination if exists
+    # The event for spot instance termination
+    if TERMINATION_DATA=$(curl -s --fail http://169.254.169.254/latest/meta-data/spot/instance-action); then
+        # https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-instance-termination-notices.html#instance-action-metadata
+        _action=$(jq '.action' -r <<< "$TERMINATION_DATA")
+        _time=$(jq '.time | fromdate' <<< "$TERMINATION_DATA")
+        _until_action=$((_time - $(date +%s)))
+        echo "Received the '$_action' event that will be effective in $_until_action seconds"
+        if (( _until_action <= 30 )); then
+            echo "The action $_action will be done in $_until_action, killing the runner and exit"
+            local runner_pid
+            runner_pid=$(pgrep Runner.Listener)
+            if [ -n "$runner_pid" ]; then
+                # Kill the runner to not allow it cancelling the job
+                kill -9 "$runner_pid"
+            fi
+            sudo -u ubuntu ./config.sh remove --token "$(get_runner_token)"
+            terminate_and_exit
+        fi
+    fi
+}
+
 no_terminating_metadata() {
     # The function check that instance could continue work
     # Returns 1 if any of termination events are received
+
+    # The event for rebalance recommendation. Not strict, so we have some room to make a decision here
     if curl -s --fail http://169.254.169.254/latest/meta-data/events/recommendations/rebalance; then
         echo 'Received recommendation to rebalance, checking the uptime'
         UPTIME=$(< /proc/uptime)
@@ -107,6 +132,7 @@ no_terminating_metadata() {
         fi
     fi
 
+    # Checks if the ASG in a lifecycle hook state
     local ASG_STATUS
     ASG_STATUS=$(curl -s http://169.254.169.254/latest/meta-data/autoscaling/target-lifecycle-state)
     if [ "$ASG_STATUS" == "Terminated" ]; then
@@ -210,14 +236,15 @@ is_job_assigned() {
 
 while true; do
     runner_pid=$(pgrep Runner.Listener)
-    echo "Got runner pid $runner_pid"
+    echo "Got runner pid '$runner_pid'"
 
     if [ -z "$runner_pid" ]; then
-        cd $RUNNER_HOME || exit 1
+        cd $RUNNER_HOME || terminate_and_exit
         detect_delayed_termination
         # If runner is not active, check that it needs to terminate itself
         echo "Checking if the instance suppose to terminate"
         no_terminating_metadata || terminate_on_event
+        check_proceed_spot_termination
 
         echo "Going to configure runner"
         sudo -u ubuntu ./config.sh --url $RUNNER_URL --token "$(get_runner_token)" --ephemeral \
@@ -225,6 +252,7 @@ while true; do
 
         echo "Another one check to avoid race between runner and infrastructure"
         no_terminating_metadata || terminate_on_event
+        check_proceed_spot_termination
 
         echo "Run"
         sudo -u ubuntu \
@@ -234,21 +262,8 @@ while true; do
         sleep 15
     else
         echo "Runner is working with pid $runner_pid, checking the metadata in background"
-        if TERMINATION_DATA=$(curl -s --fail http://169.254.169.254/latest/meta-data/spot/instance-action); then
-            # https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-instance-termination-notices.html#instance-action-metadata
-            _action=$(jq '.action' -r <<< "$TERMINATION_DATA")
-            _time=$(jq '.time | fromdate' <<< "$TERMINATION_DATA")
-            _until_action=$((_time - $(date +%s)))
-            echo "Received the $_action event that will be effective in $_until_action seconds"
-            if (( _until_action <= 30 )); then
-                echo "The action $_action will be done in $_until_action, killing the runner and exit"
-                # Kill the runner to not allow it cancelling the job
-                kill -9 "$runner_pid"
-                sudo -u ubuntu ./config.sh remove --token "$(get_runner_token)"
-                terminate_and_exit
-            fi
+        check_proceed_spot_termination
 
-        fi
         if ! is_job_assigned; then
             RUNNER_AGE=$(( $(date +%s) - $(stat -c +%Y /proc/"$runner_pid" 2>/dev/null || date +%s) ))
             echo "The runner is launched $RUNNER_AGE seconds ago and still has hot received the job"

From cf8f277c329dd26f227a0feff549ffbd44474401 Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Mon, 19 Jun 2023 13:58:08 +0000
Subject: [PATCH 581/722] Add total_bytes_to_read to TCP protocol for better
 Progress bar

---
 src/Core/ProtocolDefines.h |  4 +++-
 src/IO/Progress.cpp        | 30 +++++++++++++++++++++++++++++-
 2 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/src/Core/ProtocolDefines.h b/src/Core/ProtocolDefines.h
index ff9b1fae442..237ef934081 100644
--- a/src/Core/ProtocolDefines.h
+++ b/src/Core/ProtocolDefines.h
@@ -53,7 +53,7 @@
 /// NOTE: DBMS_TCP_PROTOCOL_VERSION has nothing common with VERSION_REVISION,
 /// later is just a number for server version (one number instead of commit SHA)
 /// for simplicity (sometimes it may be more convenient in some use cases).
-#define DBMS_TCP_PROTOCOL_VERSION 54462
+#define DBMS_TCP_PROTOCOL_VERSION 54463
 
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_INITIAL_QUERY_START_TIME 54449
 
@@ -73,3 +73,5 @@
 #define DBMS_MIN_PROTOCOL_VERSION_WITH_PASSWORD_COMPLEXITY_RULES 54461
 
 #define DBMS_MIN_REVISION_WITH_INTERSERVER_SECRET_V2 54462
+
+#define DBMS_MIN_PROTOCOL_VERSION_WITH_TOTAL_BYTES_IN_PROGRESS 54463
diff --git a/src/IO/Progress.cpp b/src/IO/Progress.cpp
index 1069803633c..bf42cdf91d6 100644
--- a/src/IO/Progress.cpp
+++ b/src/IO/Progress.cpp
@@ -9,11 +9,28 @@
 
 namespace DB
 {
+
+namespace
+{
+    UInt64 getApproxTotalRowsToRead(UInt64 read_rows, UInt64 read_bytes, UInt64 total_bytes_to_read)
+    {
+        if (!read_rows || !read_bytes)
+            return 0;
+
+        auto bytes_per_row = std::ceil(static_cast<double>(read_bytes) / read_rows);
+        return static_cast<UInt64>(std::ceil(static_cast<double>(total_bytes_to_read) / bytes_per_row));
+    }
+}
+
 void ProgressValues::read(ReadBuffer & in, UInt64 server_revision)
 {
     readVarUInt(read_rows, in);
     readVarUInt(read_bytes, in);
     readVarUInt(total_rows_to_read, in);
+    if (server_revision >= DBMS_MIN_PROTOCOL_VERSION_WITH_TOTAL_BYTES_IN_PROGRESS)
+    {
+        readVarUInt(total_bytes_to_read, in);
+    }
     if (server_revision >= DBMS_MIN_REVISION_WITH_CLIENT_WRITE_INFO)
     {
         readVarUInt(written_rows, in);
@@ -30,7 +47,17 @@ void ProgressValues::write(WriteBuffer & out, UInt64 client_revision) const
 {
     writeVarUInt(read_rows, out);
     writeVarUInt(read_bytes, out);
-    writeVarUInt(total_rows_to_read, out);
+    /// In new TCP protocol we can send total_bytes_to_read without total_rows_to_read.
+    /// If client doesn't support total_bytes_to_read, send approx total_rows_to_read
+    /// to indicate at least approx progress.
+    if (client_revision < DBMS_MIN_PROTOCOL_VERSION_WITH_TOTAL_BYTES_IN_PROGRESS && total_bytes_to_read && !total_rows_to_read)
+        writeVarUInt(getApproxTotalRowsToRead(read_rows, read_bytes, total_bytes_to_read), out);
+    else
+        writeVarUInt(total_rows_to_read, out);
+    if (client_revision >= DBMS_MIN_PROTOCOL_VERSION_WITH_TOTAL_BYTES_IN_PROGRESS)
+    {
+        writeVarUInt(total_bytes_to_read, out);
+    }
     if (client_revision >= DBMS_MIN_REVISION_WITH_CLIENT_WRITE_INFO)
     {
         writeVarUInt(written_rows, out);
@@ -190,6 +217,7 @@ void Progress::read(ReadBuffer & in, UInt64 server_revision)
     read_rows.store(values.read_rows, std::memory_order_relaxed);
     read_bytes.store(values.read_bytes, std::memory_order_relaxed);
     total_rows_to_read.store(values.total_rows_to_read, std::memory_order_relaxed);
+    total_bytes_to_read.store(values.total_bytes_to_read, std::memory_order_relaxed);
 
     written_rows.store(values.written_rows, std::memory_order_relaxed);
     written_bytes.store(values.written_bytes, std::memory_order_relaxed);

From 44f1f036e82d6621a37561f9f2165be6e774beb9 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Mon, 19 Jun 2023 16:47:17 +0200
Subject: [PATCH 582/722] Use multi-read requests for list and get

---
 .../System/StorageSystemZooKeeper.cpp         | 33 ++++++++++++-------
 1 file changed, 21 insertions(+), 12 deletions(-)

diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 5ed57889c2d..dcab7d42a73 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -436,13 +436,13 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
         String prefix;
         String path_corrected;
         String path_part;
-        std::future<Coordination::ListResponse> future;
     };
     std::vector<ListTask> list_tasks;
     std::unordered_set<String> added;
     while (!paths.empty())
     {
         list_tasks.clear();
+        Coordination::Requests list_requests;
         while (!paths.empty() && static_cast<Int64>(list_tasks.size()) < max_inflight_requests)
         {
             auto [path, path_type] = std::move(paths.front());
@@ -460,28 +460,30 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
 
             task.path_corrected = pathCorrected(path);
 
-            task.future = zookeeper->asyncTryGetChildren(task.path_corrected);
+            list_requests.emplace_back(zkutil::makeListRequest(task.path_corrected));
             list_tasks.emplace_back(std::move(task));
         }
+        Coordination::Responses list_responses;
+        zookeeper->tryMulti(list_requests, list_responses);
 
         struct GetTask
         {
             size_t list_task_idx;   /// Index of 'parent' request in list_tasks
             String node;            /// Node name
-            std::future<Coordination::GetResponse> future;
         };
         std::vector<GetTask> get_tasks;
+        Coordination::Requests get_requests;
         for (size_t list_task_idx = 0; list_task_idx < list_tasks.size(); ++list_task_idx)
         {
-            auto & task = list_tasks[list_task_idx];
-            context->getProcessListElement()->checkTimeLimit();
-            auto list_result = task.future.get();
-
             /// Node can be deleted concurrently. It's Ok, we don't provide any
             /// consistency guarantees for system.zookeeper table.
-            if (list_result.error == Coordination::Error::ZNONODE)
+            if (list_responses[list_task_idx]->error == Coordination::Error::ZNONODE)
                 continue;
 
+            auto & task = list_tasks[list_task_idx];
+            context->getProcessListElement()->checkTimeLimit();
+            auto & list_result = dynamic_cast<Coordination::ListResponse &>(*list_responses[list_task_idx]);
+
             Strings nodes = std::move(list_result.names);
 
             task.path_part = task.path_corrected;
@@ -499,17 +501,24 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
 
             get_tasks.reserve(get_tasks.size() + nodes.size());
             for (const String & node : nodes)
-                get_tasks.emplace_back(GetTask{list_task_idx, node, zookeeper->asyncTryGet(task.path_part + '/' + node)});
+            {
+                get_requests.emplace_back(zkutil::makeGetRequest(task.path_part + '/' + node));
+                get_tasks.emplace_back(GetTask{list_task_idx, node});
+            }
         }
 
+        Coordination::Responses get_responses;
+        zookeeper->tryMulti(get_requests, get_responses);
+
         for (size_t i = 0, size = get_tasks.size(); i < size; ++i)
         {
+            if (get_responses[i]->error == Coordination::Error::ZNONODE)
+                continue; /// Node was deleted meanwhile.
+
             auto & get_task = get_tasks[i];
             auto & list_task = list_tasks[get_task.list_task_idx];
             context->getProcessListElement()->checkTimeLimit();
-            auto res = get_task.future.get();
-            if (res.error == Coordination::Error::ZNONODE)
-                continue; /// Node was deleted meanwhile.
+            auto & res = dynamic_cast<Coordination::GetResponse &>(*get_responses[i]);
 
             // Deduplication
             String key = list_task.path_part + '/' + get_task.node;

From 0ca2916163406db10894789f3d2fa5c6e9e04576 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 19 Jun 2023 17:16:09 +0200
Subject: [PATCH 583/722] More metrics in cache

---
 src/Common/ProfileEvents.cpp                  | 13 +++
 .../IO/CachedOnDiskReadBufferFromFile.cpp     |  2 +
 .../Cached/CachedObjectStorage.cpp            |  1 +
 src/Interpreters/Cache/FileCache.cpp          | 35 ++++++--
 src/Interpreters/Cache/FileCache.h            |  2 +-
 src/Interpreters/Cache/FileSegment.cpp        | 88 +++++++++++++------
 src/Interpreters/Cache/FileSegment.h          |  3 +-
 src/Interpreters/Cache/Metadata.cpp           | 44 ++++++++--
 src/Interpreters/Cache/Metadata.h             |  1 +
 9 files changed, 142 insertions(+), 47 deletions(-)

diff --git a/src/Common/ProfileEvents.cpp b/src/Common/ProfileEvents.cpp
index f66f7bc6465..1b535f06cb3 100644
--- a/src/Common/ProfileEvents.cpp
+++ b/src/Common/ProfileEvents.cpp
@@ -386,6 +386,19 @@ The server successfully detected this situation and will download merged part fr
     \
     M(FilesystemCacheEvictedBytes, "Number of bytes evicted from filesystem cache") \
     M(FilesystemCacheEvictedFileSegments, "Number of file segments evicted from filesystem cache") \
+    M(FilesystemCacheLockKeyMilliseconds, "Lock cache key time") \
+    M(FilesystemCacheLockMetadataMilliseconds, "Lock filesystem cache metadata time") \
+    M(FilesystemCacheLockCacheMilliseconds, "Lock filesystem cache time") \
+    M(FilesystemCacheReserveMilliseconds, "Filesystem cache space reservation time") \
+    M(FilesystemCacheGetOrSetMilliseconds, "Filesystem cache getOrSet() time") \
+    M(FilesystemCacheGetMilliseconds, "Filesystem cache get() time") \
+    M(FileSegmentWaitMilliseconds, "Wait on DOWNLOADING state") \
+    M(FileSegmentCompleteMilliseconds, "Duration of FileSegment::complete() in filesystem cache") \
+    M(FileSegmentLockMilliseconds, "Lock file segment time") \
+    M(FileSegmentWriteMilliseconds, "File segment write() time") \
+    M(FileSegmentUseMilliseconds, "File segment use() time") \
+    M(FileSegmentRemoveMilliseconds, "File segment remove() time") \
+    M(FileSegmentHolderCompleteMilliseconds, "File segments holder complete() time") \
     \
     M(RemoteFSSeeks, "Total number of seeks for async buffer") \
     M(RemoteFSPrefetches, "Number of prefetches made with asynchronous reading from remote filesystem") \
diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 6317aba20e9..518a0e46b82 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -401,6 +401,8 @@ CachedOnDiskReadBufferFromFile::getImplementationBuffer(FileSegment & file_segme
     current_file_segment_counters.increment(
         ProfileEvents::FileSegmentWaitReadBufferMicroseconds, watch.elapsedMicroseconds());
 
+    ProfileEvents::increment(ProfileEvents::FileSegmentWaitReadBufferMicroseconds);
+
     [[maybe_unused]] auto download_current_segment = read_type == ReadType::REMOTE_FS_READ_AND_PUT_IN_CACHE;
     chassert(download_current_segment == file_segment.isDownloader());
 
diff --git a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
index 3e73e45638b..b1cf8226895 100644
--- a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
@@ -138,6 +138,7 @@ void CachedObjectStorage::removeCacheIfExists(const std::string & path_key_for_c
 
 void CachedObjectStorage::removeObject(const StoredObject & object)
 {
+    removeCacheIfExists(object.remote_path);
     object_storage->removeObject(object);
 }
 
diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index e6bc8b1f79b..128cf2b5ca8 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -11,6 +11,7 @@
 #include <base/hex.h>
 #include <pcg-random/pcg_random.hpp>
 #include <Common/randomSeed.h>
+#include <Common/ElapsedTimeProfileEventIncrement.h>
 
 #include <filesystem>
 
@@ -21,6 +22,10 @@ namespace ProfileEvents
 {
     extern const Event FilesystemCacheEvictedBytes;
     extern const Event FilesystemCacheEvictedFileSegments;
+    extern const Event FilesystemCacheLockCacheMilliseconds;
+    extern const Event FilesystemCacheReserveMilliseconds;
+    extern const Event FilesystemCacheGetOrSetMilliseconds;
+    extern const Event FilesystemCacheGetMilliseconds;
 }
 
 namespace
@@ -129,6 +134,12 @@ void FileCache::initialize()
     cleanup_task->scheduleAfter(delayed_cleanup_interval_ms);
 }
 
+CacheGuard::Lock FileCache::lockCache() const
+{
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockCacheMilliseconds);
+    return cache_guard.lock();
+}
+
 FileSegments FileCache::getImpl(const LockedKey & locked_key, const FileSegment::Range & range) const
 {
     /// Given range = [left, right] and non-overlapping ordered set of file segments,
@@ -414,6 +425,8 @@ FileSegmentsHolderPtr FileCache::set(
 FileSegmentsHolderPtr
 FileCache::getOrSet(const Key & key, size_t offset, size_t size, size_t file_size, const CreateFileSegmentSettings & settings)
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheGetOrSetMilliseconds);
+
     assertInitialized();
 
     const auto aligned_offset = roundDownToMultiple(offset, boundary_alignment);
@@ -448,6 +461,8 @@ FileCache::getOrSet(const Key & key, size_t offset, size_t size, size_t file_siz
 
 FileSegmentsHolderPtr FileCache::get(const Key & key, size_t offset, size_t size)
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheGetMilliseconds);
+
     assertInitialized();
 
     auto locked_key = metadata.lockKeyMetadata(key, CacheMetadata::KeyNotFoundPolicy::RETURN_NULL);
@@ -562,8 +577,10 @@ KeyMetadata::iterator FileCache::addFileSegment(
 
 bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheReserveMilliseconds);
+
     assertInitialized();
-    auto cache_lock = cache_guard.lock();
+    auto cache_lock = lockCache();
 
     LOG_TEST(
         log, "Trying to reserve space ({} bytes) for {}:{}, current usage {}/{}",
@@ -799,7 +816,7 @@ void FileCache::removeAllReleasable()
     /// `remove_persistent_files` defines whether non-evictable by some criteria files
     /// (they do not comply with the cache eviction policy) should also be removed.
 
-    auto lock = cache_guard.lock();
+    auto lock = lockCache();
 
     main_priority->iterate([&](LockedKey & locked_key, FileSegmentMetadataPtr segment_metadata)
     {
@@ -822,7 +839,7 @@ void FileCache::removeAllReleasable()
 
 void FileCache::loadMetadata()
 {
-    auto lock = cache_guard.lock();
+    auto lock = lockCache();
 
     UInt64 offset = 0;
     size_t size = 0;
@@ -1039,7 +1056,7 @@ FileSegmentsHolderPtr FileCache::dumpQueue()
     {
         file_segments.push_back(FileSegment::getSnapshot(segment_metadata->file_segment));
         return PriorityIterationResult::CONTINUE;
-    }, cache_guard.lock());
+    }, lockCache());
 
     return std::make_unique<FileSegmentsHolder>(std::move(file_segments));
 }
@@ -1064,17 +1081,17 @@ std::vector<String> FileCache::tryGetCachePaths(const Key & key)
 
 size_t FileCache::getUsedCacheSize() const
 {
-    return main_priority->getSize(cache_guard.lock());
+    return main_priority->getSize(lockCache());
 }
 
 size_t FileCache::getFileSegmentsNum() const
 {
-    return main_priority->getElementsCount(cache_guard.lock());
+    return main_priority->getElementsCount(lockCache());
 }
 
 void FileCache::assertCacheCorrectness()
 {
-    auto lock = cache_guard.lock();
+    auto lock = lockCache();
     main_priority->iterate([&](LockedKey &, FileSegmentMetadataPtr segment_metadata)
     {
         const auto & file_segment = *segment_metadata->file_segment;
@@ -1100,7 +1117,7 @@ FileCache::QueryContextHolder::~QueryContextHolder()
     /// the query has been completed and the query_context is released.
     if (context && context.use_count() == 2)
     {
-        auto lock = cache->cache_guard.lock();
+        auto lock = cache->lockCache();
         cache->query_limit->removeQueryContext(query_id, lock);
     }
 }
@@ -1111,7 +1128,7 @@ FileCache::QueryContextHolderPtr FileCache::getQueryContextHolder(
     if (!query_limit || settings.filesystem_cache_max_download_size == 0)
         return {};
 
-    auto lock = cache_guard.lock();
+    auto lock = lockCache();
     auto context = query_limit->getOrSetQueryContext(query_id, settings, lock);
     return std::make_unique<QueryContextHolder>(query_id, this, std::move(context));
 }
diff --git a/src/Interpreters/Cache/FileCache.h b/src/Interpreters/Cache/FileCache.h
index 71fc1722844..dc5dd67710c 100644
--- a/src/Interpreters/Cache/FileCache.h
+++ b/src/Interpreters/Cache/FileCache.h
@@ -125,7 +125,7 @@ public:
     using QueryContextHolderPtr = std::unique_ptr<QueryContextHolder>;
     QueryContextHolderPtr getQueryContextHolder(const String & query_id, const ReadSettings & settings);
 
-    CacheGuard::Lock lockCache() { return cache_guard.lock(); }
+    CacheGuard::Lock lockCache() const;
 
 private:
     using KeyAndOffset = FileCacheKeyAndOffset;
diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index 7b82c58080c..ad838b9fbbe 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -9,11 +9,22 @@
 #include <Common/OpenTelemetryTraceContext.h>
 #include <Common/logger_useful.h>
 #include <Common/scope_guard_safe.h>
+#include <Common/ElapsedTimeProfileEventIncrement.h>
 
 #include <magic_enum.hpp>
 
 namespace fs = std::filesystem;
 
+namespace ProfileEvents
+{
+    extern const Event FileSegmentWaitMilliseconds;
+    extern const Event FileSegmentCompleteMilliseconds;
+    extern const Event FileSegmentLockMilliseconds;
+    extern const Event FileSegmentWriteMilliseconds;
+    extern const Event FileSegmentUseMilliseconds;
+    extern const Event FileSegmentHolderCompleteMilliseconds;
+}
+
 namespace DB
 {
 
@@ -83,9 +94,15 @@ FileSegment::FileSegment(
     }
 }
 
+FileSegment::Range::Range(size_t left_, size_t right_) : left(left_), right(right_)
+{
+    if (left > right)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "Attempt to create incorrect range: [{}, {}]", left, right);
+}
+
 FileSegment::State FileSegment::state() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return download_state;
 }
 
@@ -94,6 +111,12 @@ String FileSegment::getPathInLocalCache() const
     return getKeyMetadata()->getFileSegmentPath(*this);
 }
 
+FileSegmentGuard::Lock FileSegment::lockFileSegment() const
+{
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentLockMilliseconds);
+    return segment_guard.lock();
+}
+
 void FileSegment::setDownloadState(State state, const FileSegmentGuard::Lock & lock)
 {
     if (isCompleted(false) && state != State::DETACHED)
@@ -110,19 +133,19 @@ void FileSegment::setDownloadState(State state, const FileSegmentGuard::Lock & l
 
 size_t FileSegment::getReservedSize() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return reserved_size;
 }
 
 FileSegment::Priority::Iterator FileSegment::getQueueIterator() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return queue_iterator;
 }
 
 void FileSegment::setQueueIterator(Priority::Iterator iterator)
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     if (queue_iterator)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Queue iterator cannot be set twice");
     queue_iterator = iterator;
@@ -150,14 +173,14 @@ size_t FileSegment::getDownloadedSize(bool sync) const
 
 void FileSegment::setDownloadedSize(size_t delta)
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     downloaded_size += delta;
     assert(downloaded_size == std::filesystem::file_size(getPathInLocalCache()));
 }
 
 bool FileSegment::isDownloaded() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return download_state == State::DOWNLOADED;
 }
 
@@ -173,7 +196,7 @@ String FileSegment::getCallerId()
 
 String FileSegment::getDownloader() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return getDownloaderUnlocked(lock);
 }
 
@@ -184,7 +207,7 @@ String FileSegment::getDownloaderUnlocked(const FileSegmentGuard::Lock &) const
 
 String FileSegment::getOrSetDownloader()
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
 
     assertNotDetachedUnlocked(lock);
 
@@ -220,7 +243,7 @@ void FileSegment::resetDownloadingStateUnlocked(const FileSegmentGuard::Lock & l
 
 void FileSegment::resetDownloader()
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
 
     SCOPE_EXIT({ cv.notify_all(); });
 
@@ -255,7 +278,7 @@ void FileSegment::assertIsDownloaderUnlocked(const std::string & operation, cons
 
 bool FileSegment::isDownloader() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return isDownloaderUnlocked(lock);
 }
 
@@ -266,14 +289,14 @@ bool FileSegment::isDownloaderUnlocked(const FileSegmentGuard::Lock & lock) cons
 
 FileSegment::RemoteFileReaderPtr FileSegment::getRemoteFileReader()
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     assertIsDownloaderUnlocked("getRemoteFileReader", lock);
     return remote_file_reader;
 }
 
 void FileSegment::resetRemoteFileReader()
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     assertIsDownloaderUnlocked("resetRemoteFileReader", lock);
     remote_file_reader.reset();
 }
@@ -287,7 +310,7 @@ FileSegment::RemoteFileReaderPtr FileSegment::extractRemoteFileReader()
         return std::move(remote_file_reader);
     }
 
-    auto segment_lock = segment_guard.lock();
+    auto segment_lock = lockFileSegment();
 
     assert(download_state != State::DETACHED);
 
@@ -300,7 +323,7 @@ FileSegment::RemoteFileReaderPtr FileSegment::extractRemoteFileReader()
 
 void FileSegment::setRemoteFileReader(RemoteFileReaderPtr remote_file_reader_)
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     assertIsDownloaderUnlocked("setRemoteFileReader", lock);
 
     if (remote_file_reader)
@@ -311,13 +334,15 @@ void FileSegment::setRemoteFileReader(RemoteFileReaderPtr remote_file_reader_)
 
 void FileSegment::write(const char * from, size_t size, size_t offset)
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentWriteMilliseconds);
+
     if (!size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Writing zero size is not allowed");
 
     const auto file_segment_path = getPathInLocalCache();
 
     {
-        auto lock = segment_guard.lock();
+        auto lock = lockFileSegment();
 
         assertIsDownloaderUnlocked("write", lock);
         assertNotDetachedUnlocked(lock);
@@ -372,7 +397,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
     }
     catch (ErrnoException & e)
     {
-        auto lock = segment_guard.lock();
+        auto lock = lockFileSegment();
         e.addMessage(fmt::format("{}, current cache state: {}", e.what(), getInfoForLogUnlocked(lock)));
 
         int code = e.getErrno();
@@ -392,7 +417,7 @@ void FileSegment::write(const char * from, size_t size, size_t offset)
     }
     catch (Exception & e)
     {
-        auto lock = segment_guard.lock();
+        auto lock = lockFileSegment();
         e.addMessage(fmt::format("{}, current cache state: {}", e.what(), getInfoForLogUnlocked(lock)));
         setDownloadFailedUnlocked(lock);
         throw;
@@ -405,7 +430,7 @@ FileSegment::State FileSegment::wait(size_t offset)
 {
     OpenTelemetry::SpanHolder span{fmt::format("FileSegment::wait({})", key().toString())};
 
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
 
     if (downloader_id.empty() || offset < getCurrentWriteOffset(true))
         return download_state;
@@ -416,13 +441,14 @@ FileSegment::State FileSegment::wait(size_t offset)
     if (download_state == State::DOWNLOADING)
     {
         LOG_TEST(log, "{} waiting on: {}, current downloader: {}", getCallerId(), range().toString(), downloader_id);
+        ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentWaitMilliseconds);
 
         chassert(!getDownloaderUnlocked(lock).empty());
         chassert(!isDownloaderUnlocked(lock));
 
         [[maybe_unused]] const auto ok = cv.wait_for(lock, std::chrono::seconds(60), [&, this]()
         {
-            return download_state != State::DOWNLOADING || offset < getCurrentWriteOffset(true);
+            return download_state != State::DOWNLOADING || offset < getCurrentWriteOffset(false);
         });
         /// chassert(ok);
     }
@@ -507,7 +533,7 @@ bool FileSegment::reserve(size_t size_to_reserve)
     reserved = cache->tryReserve(*this, size_to_reserve);
 
     if (!reserved)
-        setDownloadFailedUnlocked(segment_guard.lock());
+        setDownloadFailedUnlocked(lockFileSegment());
 
     return reserved;
 }
@@ -549,7 +575,7 @@ void FileSegment::setDownloadFailedUnlocked(const FileSegmentGuard::Lock & lock)
 
 void FileSegment::completePartAndResetDownloader()
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
 
     SCOPE_EXIT({ cv.notify_all(); });
 
@@ -569,6 +595,8 @@ void FileSegment::completePartAndResetDownloader()
 
 void FileSegment::complete()
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentCompleteMilliseconds);
+
     if (isCompleted())
         return;
 
@@ -582,7 +610,7 @@ void FileSegment::complete()
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Cannot complete file segment: {}", getInfoForLog());
     }
 
-    auto segment_lock = segment_guard.lock();
+    auto segment_lock = lockFileSegment();
 
     if (isCompleted(false))
         return;
@@ -687,7 +715,7 @@ void FileSegment::complete()
 
 String FileSegment::getInfoForLog() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return getInfoForLogUnlocked(lock);
 }
 
@@ -731,7 +759,7 @@ String FileSegment::stateToString(FileSegment::State state)
 
 bool FileSegment::assertCorrectness() const
 {
-    return assertCorrectnessUnlocked(segment_guard.lock());
+    return assertCorrectnessUnlocked(lockFileSegment());
 }
 
 bool FileSegment::assertCorrectnessUnlocked(const FileSegmentGuard::Lock &) const
@@ -779,7 +807,7 @@ bool FileSegment::assertCorrectnessUnlocked(const FileSegmentGuard::Lock &) cons
 
 void FileSegment::assertNotDetached() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     assertNotDetachedUnlocked(lock);
 }
 
@@ -797,7 +825,7 @@ void FileSegment::assertNotDetachedUnlocked(const FileSegmentGuard::Lock & lock)
 
 FileSegmentPtr FileSegment::getSnapshot(const FileSegmentPtr & file_segment)
 {
-    auto lock = file_segment->segment_guard.lock();
+    auto lock = file_segment->lockFileSegment();
 
     auto snapshot = std::make_shared<FileSegment>(
         file_segment->key(),
@@ -816,7 +844,7 @@ FileSegmentPtr FileSegment::getSnapshot(const FileSegmentPtr & file_segment)
 
 bool FileSegment::isDetached() const
 {
-    auto lock = segment_guard.lock();
+    auto lock = lockFileSegment();
     return download_state == State::DETACHED;
 }
 
@@ -832,7 +860,7 @@ bool FileSegment::isCompleted(bool sync) const
         if (is_completed_state())
             return true;
 
-        auto lock = segment_guard.lock();
+        auto lock = lockFileSegment();
         return is_completed_state();
     }
 
@@ -858,6 +886,8 @@ void FileSegment::detach(const FileSegmentGuard::Lock & lock, const LockedKey &)
 
 void FileSegment::use()
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentUseMilliseconds);
+
     if (!cache)
     {
         chassert(isCompleted(true));
@@ -880,6 +910,8 @@ FileSegments::iterator FileSegmentsHolder::completeAndPopFrontImpl()
 
 FileSegmentsHolder::~FileSegmentsHolder()
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentHolderCompleteMilliseconds);
+
     if (!complete_on_dtor)
         return;
 
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 5bf0a9cdcf3..681c0d719e4 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -130,7 +130,7 @@ public:
         size_t left;
         size_t right;
 
-        Range(size_t left_, size_t right_) : left(left_), right(right_) {}
+        Range(size_t left_, size_t right_);
 
         bool operator==(const Range & other) const { return left == other.left && right == other.right; }
 
@@ -293,6 +293,7 @@ private:
     bool assertCorrectnessUnlocked(const FileSegmentGuard::Lock &) const;
 
     LockedKeyPtr lockKeyMetadata(bool assert_exists = true) const;
+    FileSegmentGuard::Lock lockFileSegment() const;
 
     Key file_key;
     Range segment_range;
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index c9a23d1c785..9ab304b598b 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -2,10 +2,17 @@
 #include <Interpreters/Cache/FileCache.h>
 #include <Interpreters/Cache/FileSegment.h>
 #include <Common/logger_useful.h>
+#include <Common/ElapsedTimeProfileEventIncrement.h>
 #include <filesystem>
 
 namespace fs = std::filesystem;
 
+namespace ProfileEvents
+{
+    extern const Event FilesystemCacheLockKeyMilliseconds;
+    extern const Event FilesystemCacheLockMetadataMilliseconds;
+}
+
 namespace DB
 {
 
@@ -69,6 +76,8 @@ LockedKeyPtr KeyMetadata::lock()
 
 LockedKeyPtr KeyMetadata::tryLock()
 {
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+
     auto locked = std::make_unique<LockedKey>(shared_from_this());
     if (key_state == KeyMetadata::KeyState::ACTIVE)
         return locked;
@@ -156,6 +165,12 @@ String CacheMetadata::getPathForKey(const Key & key) const
     return fs::path(path) / key_str.substr(0, 3) / key_str;
 }
 
+CacheMetadataGuard::Lock CacheMetadata::lockMetadata() const
+{
+    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockMetadataMilliseconds);
+    return guard.lock();
+}
+
 LockedKeyPtr CacheMetadata::lockKeyMetadata(
     const FileCacheKey & key,
     KeyNotFoundPolicy key_not_found_policy,
@@ -163,7 +178,7 @@ LockedKeyPtr CacheMetadata::lockKeyMetadata(
 {
     KeyMetadataPtr key_metadata;
     {
-        auto lock = guard.lock();
+        auto lock = lockMetadata();
 
         auto it = find(key);
         if (it == end())
@@ -182,9 +197,13 @@ LockedKeyPtr CacheMetadata::lockKeyMetadata(
     }
 
     {
-        auto locked_metadata = std::make_unique<LockedKey>(key_metadata);
-        const auto key_state = locked_metadata->getKeyState();
+        LockedKeyPtr locked_metadata;
+        {
+            ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+            locked_metadata = std::make_unique<LockedKey>(key_metadata);
+        }
 
+        const auto key_state = locked_metadata->getKeyState();
         if (key_state == KeyMetadata::KeyState::ACTIVE)
             return locked_metadata;
 
@@ -213,10 +232,15 @@ LockedKeyPtr CacheMetadata::lockKeyMetadata(
 
 void CacheMetadata::iterate(IterateCacheMetadataFunc && func)
 {
-    auto lock = guard.lock();
+    auto lock = lockMetadata();
     for (const auto & [key, key_metadata] : *this)
     {
-        auto locked_key = std::make_unique<LockedKey>(key_metadata);
+        LockedKeyPtr locked_key;
+        {
+            ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+            locked_key = std::make_unique<LockedKey>(key_metadata);
+        }
+
         const auto key_state = locked_key->getKeyState();
 
         if (key_state == KeyMetadata::KeyState::ACTIVE)
@@ -235,7 +259,7 @@ void CacheMetadata::iterate(IterateCacheMetadataFunc && func)
 
 void CacheMetadata::doCleanup()
 {
-    auto lock = guard.lock();
+    auto lock = lockMetadata();
 
     FileCacheKey cleanup_key;
     while (cleanup_queue->tryPop(cleanup_key))
@@ -244,9 +268,13 @@ void CacheMetadata::doCleanup()
         if (it == end())
             continue;
 
-        auto locked_metadata = std::make_unique<LockedKey>(it->second);
-        const auto key_state = locked_metadata->getKeyState();
+        LockedKeyPtr locked_metadata;
+        {
+            ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+            locked_metadata = std::make_unique<LockedKey>(it->second);
+        }
 
+        const auto key_state = locked_metadata->getKeyState();
         if (key_state == KeyMetadata::KeyState::ACTIVE)
         {
             /// Key was added back to cache after we submitted it to removal queue.
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 3fd6176f201..bf79bafd659 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -110,6 +110,7 @@ public:
     void doCleanup();
 
 private:
+    CacheMetadataGuard::Lock lockMetadata() const;
     const std::string path; /// Cache base path
     CacheMetadataGuard guard;
     const CleanupQueuePtr cleanup_queue;

From ec86028fd88424c303a523f525e84e0566bdf3ad Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 19 Jun 2023 17:44:28 +0200
Subject: [PATCH 584/722] Change to microseconds

---
 src/Common/ProfileEvents.cpp                  | 27 +++++++++----------
 .../IO/CachedOnDiskReadBufferFromFile.cpp     |  2 +-
 src/Interpreters/Cache/FileCache.cpp          | 16 +++++------
 src/Interpreters/Cache/FileSegment.cpp        | 24 ++++++++---------
 src/Interpreters/Cache/Metadata.cpp           | 14 +++++-----
 src/Interpreters/Cache/Metadata.h             |  2 +-
 6 files changed, 42 insertions(+), 43 deletions(-)

diff --git a/src/Common/ProfileEvents.cpp b/src/Common/ProfileEvents.cpp
index 1b535f06cb3..dfa14548091 100644
--- a/src/Common/ProfileEvents.cpp
+++ b/src/Common/ProfileEvents.cpp
@@ -386,19 +386,19 @@ The server successfully detected this situation and will download merged part fr
     \
     M(FilesystemCacheEvictedBytes, "Number of bytes evicted from filesystem cache") \
     M(FilesystemCacheEvictedFileSegments, "Number of file segments evicted from filesystem cache") \
-    M(FilesystemCacheLockKeyMilliseconds, "Lock cache key time") \
-    M(FilesystemCacheLockMetadataMilliseconds, "Lock filesystem cache metadata time") \
-    M(FilesystemCacheLockCacheMilliseconds, "Lock filesystem cache time") \
-    M(FilesystemCacheReserveMilliseconds, "Filesystem cache space reservation time") \
-    M(FilesystemCacheGetOrSetMilliseconds, "Filesystem cache getOrSet() time") \
-    M(FilesystemCacheGetMilliseconds, "Filesystem cache get() time") \
-    M(FileSegmentWaitMilliseconds, "Wait on DOWNLOADING state") \
-    M(FileSegmentCompleteMilliseconds, "Duration of FileSegment::complete() in filesystem cache") \
-    M(FileSegmentLockMilliseconds, "Lock file segment time") \
-    M(FileSegmentWriteMilliseconds, "File segment write() time") \
-    M(FileSegmentUseMilliseconds, "File segment use() time") \
-    M(FileSegmentRemoveMilliseconds, "File segment remove() time") \
-    M(FileSegmentHolderCompleteMilliseconds, "File segments holder complete() time") \
+    M(FilesystemCacheLockKeyMicroseconds, "Lock cache key time") \
+    M(FilesystemCacheLockMetadataMicroseconds, "Lock filesystem cache metadata time") \
+    M(FilesystemCacheLockCacheMicroseconds, "Lock filesystem cache time") \
+    M(FilesystemCacheReserveMicroseconds, "Filesystem cache space reservation time") \
+    M(FilesystemCacheGetOrSetMicroseconds, "Filesystem cache getOrSet() time") \
+    M(FilesystemCacheGetMicroseconds, "Filesystem cache get() time") \
+    M(FileSegmentWaitMicroseconds, "Wait on DOWNLOADING state") \
+    M(FileSegmentCompleteMicroseconds, "Duration of FileSegment::complete() in filesystem cache") \
+    M(FileSegmentLockMicroseconds, "Lock file segment time") \
+    M(FileSegmentWriteMicroseconds, "File segment write() time") \
+    M(FileSegmentUseMicroseconds, "File segment use() time") \
+    M(FileSegmentRemoveMicroseconds, "File segment remove() time") \
+    M(FileSegmentHolderCompleteMicroseconds, "File segments holder complete() time") \
     \
     M(RemoteFSSeeks, "Total number of seeks for async buffer") \
     M(RemoteFSPrefetches, "Number of prefetches made with asynchronous reading from remote filesystem") \
@@ -420,7 +420,6 @@ The server successfully detected this situation and will download merged part fr
     \
     M(FileSegmentWaitReadBufferMicroseconds, "Metric per file segment. Time spend waiting for internal read buffer (includes cache waiting)") \
     M(FileSegmentReadMicroseconds, "Metric per file segment. Time spend reading from file") \
-    M(FileSegmentWriteMicroseconds, "Metric per file segment. Time spend writing cache") \
     M(FileSegmentCacheWriteMicroseconds, "Metric per file segment. Time spend writing data to cache") \
     M(FileSegmentPredownloadMicroseconds, "Metric per file segment. Time spent predownloading data to cache (predownloading - finishing file segment download (after someone who failed to do that) up to the point current thread was requested to do)") \
     M(FileSegmentUsedBytes, "Metric per file segment. How many bytes were actually used from current file segment") \
diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 518a0e46b82..64f8e553d35 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -401,7 +401,7 @@ CachedOnDiskReadBufferFromFile::getImplementationBuffer(FileSegment & file_segme
     current_file_segment_counters.increment(
         ProfileEvents::FileSegmentWaitReadBufferMicroseconds, watch.elapsedMicroseconds());
 
-    ProfileEvents::increment(ProfileEvents::FileSegmentWaitReadBufferMicroseconds);
+    ProfileEvents::increment(ProfileEvents::FileSegmentWaitReadBufferMicroseconds, watch.elapsedMicroseconds());
 
     [[maybe_unused]] auto download_current_segment = read_type == ReadType::REMOTE_FS_READ_AND_PUT_IN_CACHE;
     chassert(download_current_segment == file_segment.isDownloader());
diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 128cf2b5ca8..ec9220af955 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -22,10 +22,10 @@ namespace ProfileEvents
 {
     extern const Event FilesystemCacheEvictedBytes;
     extern const Event FilesystemCacheEvictedFileSegments;
-    extern const Event FilesystemCacheLockCacheMilliseconds;
-    extern const Event FilesystemCacheReserveMilliseconds;
-    extern const Event FilesystemCacheGetOrSetMilliseconds;
-    extern const Event FilesystemCacheGetMilliseconds;
+    extern const Event FilesystemCacheLockCacheMicroseconds;
+    extern const Event FilesystemCacheReserveMicroseconds;
+    extern const Event FilesystemCacheGetOrSetMicroseconds;
+    extern const Event FilesystemCacheGetMicroseconds;
 }
 
 namespace
@@ -136,7 +136,7 @@ void FileCache::initialize()
 
 CacheGuard::Lock FileCache::lockCache() const
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockCacheMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheLockCacheMicroseconds);
     return cache_guard.lock();
 }
 
@@ -425,7 +425,7 @@ FileSegmentsHolderPtr FileCache::set(
 FileSegmentsHolderPtr
 FileCache::getOrSet(const Key & key, size_t offset, size_t size, size_t file_size, const CreateFileSegmentSettings & settings)
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheGetOrSetMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheGetOrSetMicroseconds);
 
     assertInitialized();
 
@@ -461,7 +461,7 @@ FileCache::getOrSet(const Key & key, size_t offset, size_t size, size_t file_siz
 
 FileSegmentsHolderPtr FileCache::get(const Key & key, size_t offset, size_t size)
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheGetMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheGetMicroseconds);
 
     assertInitialized();
 
@@ -577,7 +577,7 @@ KeyMetadata::iterator FileCache::addFileSegment(
 
 bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheReserveMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheReserveMicroseconds);
 
     assertInitialized();
     auto cache_lock = lockCache();
diff --git a/src/Interpreters/Cache/FileSegment.cpp b/src/Interpreters/Cache/FileSegment.cpp
index ad838b9fbbe..95592fc7c12 100644
--- a/src/Interpreters/Cache/FileSegment.cpp
+++ b/src/Interpreters/Cache/FileSegment.cpp
@@ -17,12 +17,12 @@ namespace fs = std::filesystem;
 
 namespace ProfileEvents
 {
-    extern const Event FileSegmentWaitMilliseconds;
-    extern const Event FileSegmentCompleteMilliseconds;
-    extern const Event FileSegmentLockMilliseconds;
-    extern const Event FileSegmentWriteMilliseconds;
-    extern const Event FileSegmentUseMilliseconds;
-    extern const Event FileSegmentHolderCompleteMilliseconds;
+    extern const Event FileSegmentWaitMicroseconds;
+    extern const Event FileSegmentCompleteMicroseconds;
+    extern const Event FileSegmentLockMicroseconds;
+    extern const Event FileSegmentWriteMicroseconds;
+    extern const Event FileSegmentUseMicroseconds;
+    extern const Event FileSegmentHolderCompleteMicroseconds;
 }
 
 namespace DB
@@ -113,7 +113,7 @@ String FileSegment::getPathInLocalCache() const
 
 FileSegmentGuard::Lock FileSegment::lockFileSegment() const
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentLockMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FileSegmentLockMicroseconds);
     return segment_guard.lock();
 }
 
@@ -334,7 +334,7 @@ void FileSegment::setRemoteFileReader(RemoteFileReaderPtr remote_file_reader_)
 
 void FileSegment::write(const char * from, size_t size, size_t offset)
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentWriteMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FileSegmentWriteMicroseconds);
 
     if (!size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Writing zero size is not allowed");
@@ -441,7 +441,7 @@ FileSegment::State FileSegment::wait(size_t offset)
     if (download_state == State::DOWNLOADING)
     {
         LOG_TEST(log, "{} waiting on: {}, current downloader: {}", getCallerId(), range().toString(), downloader_id);
-        ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentWaitMilliseconds);
+        ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FileSegmentWaitMicroseconds);
 
         chassert(!getDownloaderUnlocked(lock).empty());
         chassert(!isDownloaderUnlocked(lock));
@@ -595,7 +595,7 @@ void FileSegment::completePartAndResetDownloader()
 
 void FileSegment::complete()
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentCompleteMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FileSegmentCompleteMicroseconds);
 
     if (isCompleted())
         return;
@@ -886,7 +886,7 @@ void FileSegment::detach(const FileSegmentGuard::Lock & lock, const LockedKey &)
 
 void FileSegment::use()
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentUseMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FileSegmentUseMicroseconds);
 
     if (!cache)
     {
@@ -910,7 +910,7 @@ FileSegments::iterator FileSegmentsHolder::completeAndPopFrontImpl()
 
 FileSegmentsHolder::~FileSegmentsHolder()
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FileSegmentHolderCompleteMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FileSegmentHolderCompleteMicroseconds);
 
     if (!complete_on_dtor)
         return;
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 9ab304b598b..20af931bbc2 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -9,8 +9,8 @@ namespace fs = std::filesystem;
 
 namespace ProfileEvents
 {
-    extern const Event FilesystemCacheLockKeyMilliseconds;
-    extern const Event FilesystemCacheLockMetadataMilliseconds;
+    extern const Event FilesystemCacheLockKeyMicroseconds;
+    extern const Event FilesystemCacheLockMetadataMicroseconds;
 }
 
 namespace DB
@@ -76,7 +76,7 @@ LockedKeyPtr KeyMetadata::lock()
 
 LockedKeyPtr KeyMetadata::tryLock()
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheLockKeyMicroseconds);
 
     auto locked = std::make_unique<LockedKey>(shared_from_this());
     if (key_state == KeyMetadata::KeyState::ACTIVE)
@@ -167,7 +167,7 @@ String CacheMetadata::getPathForKey(const Key & key) const
 
 CacheMetadataGuard::Lock CacheMetadata::lockMetadata() const
 {
-    ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockMetadataMilliseconds);
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheLockMetadataMicroseconds);
     return guard.lock();
 }
 
@@ -199,7 +199,7 @@ LockedKeyPtr CacheMetadata::lockKeyMetadata(
     {
         LockedKeyPtr locked_metadata;
         {
-            ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+            ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheLockKeyMicroseconds);
             locked_metadata = std::make_unique<LockedKey>(key_metadata);
         }
 
@@ -237,7 +237,7 @@ void CacheMetadata::iterate(IterateCacheMetadataFunc && func)
     {
         LockedKeyPtr locked_key;
         {
-            ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+            ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheLockKeyMicroseconds);
             locked_key = std::make_unique<LockedKey>(key_metadata);
         }
 
@@ -270,7 +270,7 @@ void CacheMetadata::doCleanup()
 
         LockedKeyPtr locked_metadata;
         {
-            ProfileEventTimeIncrement<Milliseconds> watch(ProfileEvents::FilesystemCacheLockKeyMilliseconds);
+            ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::FilesystemCacheLockKeyMicroseconds);
             locked_metadata = std::make_unique<LockedKey>(it->second);
         }
 
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index bf79bafd659..6172808bcf5 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -112,7 +112,7 @@ public:
 private:
     CacheMetadataGuard::Lock lockMetadata() const;
     const std::string path; /// Cache base path
-    CacheMetadataGuard guard;
+    mutable CacheMetadataGuard guard;
     const CleanupQueuePtr cleanup_queue;
     Poco::Logger * log;
 };

From 1ef19dbe4dc6b0c16a4dd582618125ef43e1e13e Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Mon, 19 Jun 2023 16:32:51 +0000
Subject: [PATCH 585/722] drop cache on check of broken part

---
 src/Interpreters/Cache/FileCache.cpp          |  5 ++
 src/Interpreters/Cache/FileCache.h            |  3 +
 .../MergeTree/DataPartStorageOnDiskFull.cpp   |  7 ++
 .../MergeTree/DataPartStorageOnDiskFull.h     |  1 +
 src/Storages/MergeTree/IDataPartStorage.h     |  3 +-
 src/Storages/MergeTree/checkDataPart.cpp      | 88 +++++++++++++++----
 src/Storages/MergeTree/checkDataPart.h        |  9 --
 7 files changed, 88 insertions(+), 28 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index e6bc8b1f79b..74326cb6151 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -791,6 +791,11 @@ void FileCache::removeKeyIfExists(const Key & key)
     locked_key->removeAllReleasable();
 }
 
+void FileCache::removePathIfExists(const String & path)
+{
+    removeKeyIfExists(createKeyForPath(path));
+}
+
 void FileCache::removeAllReleasable()
 {
     assertInitialized();
diff --git a/src/Interpreters/Cache/FileCache.h b/src/Interpreters/Cache/FileCache.h
index 71fc1722844..33a8807d62d 100644
--- a/src/Interpreters/Cache/FileCache.h
+++ b/src/Interpreters/Cache/FileCache.h
@@ -86,6 +86,9 @@ public:
     /// Remove files by `key`. Removes files which might be used at the moment.
     void removeKeyIfExists(const Key & key);
 
+    /// Removes files by `path`. Removes files which might be used at the moment.
+    void removePathIfExists(const String & path);
+
     /// Remove files by `key`. Will not remove files which are used at the moment.
     void removeAllReleasable();
 
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp b/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
index 62ea3e6cd4e..8bb1043975f 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
@@ -90,6 +90,13 @@ UInt32 DataPartStorageOnDiskFull::getRefCount(const String & file_name) const
     return volume->getDisk()->getRefCount(fs::path(root_path) / part_dir / file_name);
 }
 
+std::string DataPartStorageOnDiskFull::getRemotePath(const std::string & file_name) const
+{
+    auto objects = volume->getDisk()->getStorageObjects(fs::path(root_path) / part_dir / file_name);
+    chassert(objects.size() == 1);
+    return objects[0].remote_path;
+}
+
 String DataPartStorageOnDiskFull::getUniqueId() const
 {
     auto disk = volume->getDisk();
diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskFull.h b/src/Storages/MergeTree/DataPartStorageOnDiskFull.h
index 8b38bfd7105..2ceb392e80f 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskFull.h
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskFull.h
@@ -22,6 +22,7 @@ public:
     DataPartStorageIteratorPtr iterate() const override;
     size_t getFileSize(const std::string & file_name) const override;
     UInt32 getRefCount(const std::string & file_name) const override;
+    std::string getRemotePath(const std::string & file_name) const override;
     String getUniqueId() const override;
 
     std::unique_ptr<ReadBufferFromFileBase> readFile(
diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index 8242440b8be..895ecc2cda3 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -110,6 +110,7 @@ public:
     /// Get metadata for a file inside path dir.
     virtual size_t getFileSize(const std::string & file_name) const = 0;
     virtual UInt32 getRefCount(const std::string & file_name) const = 0;
+    virtual std::string getRemotePath(const std::string & file_name) const = 0;
 
     virtual UInt64 calculateTotalSizeOnDisk() const = 0;
 
@@ -173,7 +174,6 @@ public:
     /// Required for distinguish different copies of the same part on remote FS.
     virtual String getUniqueId() const = 0;
 
-
     /// Represents metadata which is required for fetching of part.
     struct ReplicatedFilesDescription
     {
@@ -284,7 +284,6 @@ public:
         bool remove_new_dir_if_exists,
         bool fsync_part_dir) = 0;
 
-
     /// Starts a transaction of mutable operations.
     virtual void beginTransaction() = 0;
     /// Commits a transaction of mutable operations.
diff --git a/src/Storages/MergeTree/checkDataPart.cpp b/src/Storages/MergeTree/checkDataPart.cpp
index 00710ed3ed6..90f37ebe0c4 100644
--- a/src/Storages/MergeTree/checkDataPart.cpp
+++ b/src/Storages/MergeTree/checkDataPart.cpp
@@ -1,4 +1,3 @@
-#include "Storages/MergeTree/IDataPartStorage.h"
 #include <algorithm>
 #include <optional>
 
@@ -8,6 +7,9 @@
 #include <Storages/MergeTree/checkDataPart.h>
 #include <Storages/MergeTree/MergeTreeDataPartCompact.h>
 #include <Storages/MergeTree/MergeTreeDataPartInMemory.h>
+#include <Storages/MergeTree/IDataPartStorage.h>
+#include <Interpreters/Cache/FileCache.h>
+#include <Interpreters/Cache/FileCacheFactory.h>
 #include <Compression/CompressedReadBuffer.h>
 #include <IO/HashingReadBuffer.h>
 #include <Common/CurrentMetrics.h>
@@ -45,12 +47,13 @@ bool isNotEnoughMemoryErrorCode(int code)
 }
 
 
-IMergeTreeDataPart::Checksums checkDataPart(
+static IMergeTreeDataPart::Checksums checkDataPart(
     MergeTreeData::DataPartPtr data_part,
     const IDataPartStorage & data_part_storage,
     const NamesAndTypesList & columns_list,
     const MergeTreeDataPartType & part_type,
     const NameSet & files_without_checksums,
+    const ReadSettings & read_settings,
     bool require_checksums,
     std::function<bool()> is_cancelled)
 {
@@ -65,7 +68,7 @@ IMergeTreeDataPart::Checksums checkDataPart(
     NamesAndTypesList columns_txt;
 
     {
-        auto buf = data_part_storage.readFile("columns.txt", {}, std::nullopt, std::nullopt);
+        auto buf = data_part_storage.readFile("columns.txt", read_settings, std::nullopt, std::nullopt);
         columns_txt.readText(*buf);
         assertEOF(*buf);
     }
@@ -78,9 +81,9 @@ IMergeTreeDataPart::Checksums checkDataPart(
     IMergeTreeDataPart::Checksums checksums_data;
 
     /// This function calculates checksum for both compressed and decompressed contents of compressed file.
-    auto checksum_compressed_file = [](const IDataPartStorage & data_part_storage_, const String & file_path)
+    auto checksum_compressed_file = [&read_settings](const IDataPartStorage & data_part_storage_, const String & file_path)
     {
-        auto file_buf = data_part_storage_.readFile(file_path, {}, std::nullopt, std::nullopt);
+        auto file_buf = data_part_storage_.readFile(file_path, read_settings, std::nullopt, std::nullopt);
         HashingReadBuffer compressed_hashing_buf(*file_buf);
         CompressedReadBuffer uncompressing_buf(compressed_hashing_buf);
         HashingReadBuffer uncompressed_hashing_buf(uncompressing_buf);
@@ -98,7 +101,7 @@ IMergeTreeDataPart::Checksums checkDataPart(
 
     if (data_part_storage.exists(IMergeTreeDataPart::SERIALIZATION_FILE_NAME))
     {
-        auto serialization_file = data_part_storage.readFile(IMergeTreeDataPart::SERIALIZATION_FILE_NAME, {}, std::nullopt, std::nullopt);
+        auto serialization_file = data_part_storage.readFile(IMergeTreeDataPart::SERIALIZATION_FILE_NAME, read_settings, std::nullopt, std::nullopt);
         SerializationInfo::Settings settings{ratio_of_defaults, false};
         serialization_infos = SerializationInfoByName::readJSON(columns_txt, settings, *serialization_file);
     }
@@ -114,7 +117,7 @@ IMergeTreeDataPart::Checksums checkDataPart(
     /// This function calculates only checksum of file content (compressed or uncompressed).
     auto checksum_file = [&](const String & file_name)
     {
-        auto file_buf = data_part_storage.readFile(file_name, {}, std::nullopt, std::nullopt);
+        auto file_buf = data_part_storage.readFile(file_name, read_settings, std::nullopt, std::nullopt);
         HashingReadBuffer hashing_buf(*file_buf);
         hashing_buf.ignoreAll();
         checksums_data.files[file_name] = IMergeTreeDataPart::Checksums::Checksum(hashing_buf.count(), hashing_buf.getHash());
@@ -152,7 +155,7 @@ IMergeTreeDataPart::Checksums checkDataPart(
 
     if (require_checksums || data_part_storage.exists("checksums.txt"))
     {
-        auto buf = data_part_storage.readFile("checksums.txt", {}, std::nullopt, std::nullopt);
+        auto buf = data_part_storage.readFile("checksums.txt", read_settings, std::nullopt, std::nullopt);
         checksums_txt.read(*buf);
         assertEOF(*buf);
     }
@@ -202,7 +205,7 @@ IMergeTreeDataPart::Checksums checkDataPart(
             projection, *data_part_storage.getProjection(projection_file),
             projection->getColumns(), projection->getType(),
             projection->getFileNamesWithoutChecksums(),
-            require_checksums, is_cancelled);
+            read_settings, require_checksums, is_cancelled);
 
         checksums_data.files[projection_file] = IMergeTreeDataPart::Checksums::Checksum(
             projection_checksums.getTotalSizeOnDisk(),
@@ -243,14 +246,65 @@ IMergeTreeDataPart::Checksums checkDataPart(
     if (auto part_in_memory = asInMemoryPart(data_part))
         return checkDataPartInMemory(part_in_memory);
 
-    return checkDataPart(
-        data_part,
-        data_part->getDataPartStorage(),
-        data_part->getColumns(),
-        data_part->getType(),
-        data_part->getFileNamesWithoutChecksums(),
-        require_checksums,
-        is_cancelled);
+    auto drop_cache_and_check = [&]
+    {
+        const auto & data_part_storage = data_part->getDataPartStorage();
+        auto cache_name = data_part_storage.getCacheName();
+
+        if (!cache_name)
+            throw;
+
+        auto & cache = *FileCacheFactory::instance().getByName(*cache_name).cache;
+        for (auto it = data_part_storage.iterate(); it->isValid(); it->next())
+        {
+            auto file_name = it->name();
+            if (!data_part_storage.isDirectory(file_name))
+            {
+                auto remote_path = data_part_storage.getRemotePath(file_name);
+                cache.removePathIfExists(remote_path);
+            }
+        }
+
+        ReadSettings read_settings;
+        read_settings.enable_filesystem_cache = false;
+        read_settings.remote_fs_prefetch = false;
+        read_settings.remote_fs_method = RemoteFSReadMethod::read;
+
+        return checkDataPart(
+            data_part,
+            data_part_storage,
+            data_part->getColumns(),
+            data_part->getType(),
+            data_part->getFileNamesWithoutChecksums(),
+            read_settings,
+            require_checksums,
+            is_cancelled);
+    };
+
+    try
+    {
+        ReadSettings read_settings;
+        return checkDataPart(
+            data_part,
+            data_part->getDataPartStorage(),
+            data_part->getColumns(),
+            data_part->getType(),
+            data_part->getFileNamesWithoutChecksums(),
+            read_settings,
+            require_checksums,
+            is_cancelled);
+    }
+    catch (const Exception & e)
+    {
+        if (isNotEnoughMemoryErrorCode(e.code()))
+            throw;
+
+        return drop_cache_and_check();
+    }
+    catch (...)
+    {
+        return drop_cache_and_check();
+    }
 }
 
 }
diff --git a/src/Storages/MergeTree/checkDataPart.h b/src/Storages/MergeTree/checkDataPart.h
index ecb7a13ca4a..d0cf25b87be 100644
--- a/src/Storages/MergeTree/checkDataPart.h
+++ b/src/Storages/MergeTree/checkDataPart.h
@@ -12,15 +12,6 @@ IMergeTreeDataPart::Checksums checkDataPart(
     bool require_checksums,
     std::function<bool()> is_cancelled = []{ return false; });
 
-IMergeTreeDataPart::Checksums checkDataPart(
-    const DiskPtr & disk,
-    const String & full_relative_path,
-    const NamesAndTypesList & columns_list,
-    const MergeTreeDataPartType & part_type,
-    const NameSet & files_without_checksums,
-    bool require_checksums,
-    std::function<bool()> is_cancelled = []{ return false; });
-
 bool isNotEnoughMemoryErrorCode(int code);
 
 }

From 7f9cd56f618a11ef2a22dd6241c1920cbe57587f Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Mon, 19 Jun 2023 19:22:45 +0200
Subject: [PATCH 586/722] One more

---
 src/Common/ProfileEvents.cpp                    | 1 +
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp | 6 ++++++
 2 files changed, 7 insertions(+)

diff --git a/src/Common/ProfileEvents.cpp b/src/Common/ProfileEvents.cpp
index dfa14548091..ffd7f8ca696 100644
--- a/src/Common/ProfileEvents.cpp
+++ b/src/Common/ProfileEvents.cpp
@@ -381,6 +381,7 @@ The server successfully detected this situation and will download merged part fr
     M(CachedReadBufferReadFromCacheBytes, "Bytes read from filesystem cache") \
     M(CachedReadBufferCacheWriteBytes, "Bytes written from source (remote fs, etc) to filesystem cache") \
     M(CachedReadBufferCacheWriteMicroseconds, "Time spent writing data into filesystem cache") \
+    M(CachedReadBufferCreateBufferMicroseconds, "Prepare buffer time") \
     M(CachedWriteBufferCacheWriteBytes, "Bytes written from source (remote fs, etc) to filesystem cache") \
     M(CachedWriteBufferCacheWriteMicroseconds, "Time spent writing data into filesystem cache") \
     \
diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 64f8e553d35..20751731a27 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -8,6 +8,7 @@
 #include <IO/BoundedReadBuffer.h>
 #include <Common/getRandomASCIIString.h>
 #include <Common/logger_useful.h>
+#include <Common/ElapsedTimeProfileEventIncrement.h>
 #include <base/hex.h>
 #include <Interpreters/Context.h>
 
@@ -26,6 +27,7 @@ extern const Event CachedReadBufferCacheWriteMicroseconds;
 extern const Event CachedReadBufferReadFromSourceBytes;
 extern const Event CachedReadBufferReadFromCacheBytes;
 extern const Event CachedReadBufferCacheWriteBytes;
+extern const Event CachedReadBufferCreateBufferMicroseconds;
 }
 
 namespace DB
@@ -145,6 +147,8 @@ void CachedOnDiskReadBufferFromFile::initialize(size_t offset, size_t size)
 CachedOnDiskReadBufferFromFile::ImplementationBufferPtr
 CachedOnDiskReadBufferFromFile::getCacheReadBuffer(const FileSegment & file_segment) const
 {
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::CachedReadBufferCreateBufferMicroseconds);
+
     /// Use is_persistent flag from in-memory state of the filesegment,
     /// because it is consistent with what is written on disk.
     auto path = file_segment.getPathInLocalCache();
@@ -167,6 +171,8 @@ CachedOnDiskReadBufferFromFile::getCacheReadBuffer(const FileSegment & file_segm
 CachedOnDiskReadBufferFromFile::ImplementationBufferPtr
 CachedOnDiskReadBufferFromFile::getRemoteReadBuffer(FileSegment & file_segment, ReadType read_type_)
 {
+    ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::CachedReadBufferCreateBufferMicroseconds);
+
     switch (read_type_)
     {
         case ReadType::REMOTE_FS_READ_AND_PUT_IN_CACHE:

From 5dd9b10c8e1402852130b2ea67711dcac54b1bdd Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Mon, 19 Jun 2023 12:50:13 +0200
Subject: [PATCH 587/722] fix

---
 docker/test/upgrade/run.sh                                | 4 ++++
 .../queries/0_stateless/02448_clone_replica_lost_part.sql | 8 +++++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/docker/test/upgrade/run.sh b/docker/test/upgrade/run.sh
index 951c443c30d..da2d1172f18 100644
--- a/docker/test/upgrade/run.sh
+++ b/docker/test/upgrade/run.sh
@@ -59,6 +59,8 @@ install_packages previous_release_package_folder
 # available for dump via clickhouse-local
 configure
 
+# it contains some new settings, but we can safely remove it
+rm /etc/clickhouse-server/config.d/merge_tree.xml
 rm /etc/clickhouse-server/users.d/nonconst_timezone.xml
 
 start
@@ -85,6 +87,8 @@ export USE_S3_STORAGE_FOR_MERGE_TREE=1
 export ZOOKEEPER_FAULT_INJECTION=0
 configure
 
+# it contains some new settings, but we can safely remove it
+rm /etc/clickhouse-server/config.d/merge_tree.xml
 rm /etc/clickhouse-server/users.d/nonconst_timezone.xml
 
 start
diff --git a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
index eb4d0f255a7..ec669ace620 100644
--- a/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
+++ b/tests/queries/0_stateless/02448_clone_replica_lost_part.sql
@@ -5,11 +5,13 @@ SET insert_keeper_fault_injection_probability=0; -- disable fault injection; par
 drop table if exists rmt1;
 drop table if exists rmt2;
 create table rmt1 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '1') order by tuple()
-    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
+    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2,
+    max_cleanup_delay_period=1, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
     cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4,
     merge_selecting_sleep_ms=1000, max_merge_selecting_sleep_ms=2000;
 create table rmt2 (n int) engine=ReplicatedMergeTree('/test/02448/{database}/rmt', '2') order by tuple()
-    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
+    settings min_replicated_logs_to_keep=1, max_replicated_logs_to_keep=2,
+    max_cleanup_delay_period=1, cleanup_delay_period=0, cleanup_delay_period_random_add=1,
     cleanup_thread_preferred_points_per_iteration=0, old_parts_lifetime=0, max_parts_to_merge_at_once=4,
     merge_selecting_sleep_ms=1000, max_merge_selecting_sleep_ms=2000;
 
@@ -143,7 +145,7 @@ optimize table rmt2;
 -- give it a chance to cleanup log
 
 select sleepEachRow(2) from url('http://localhost:8123/?param_tries={1..10}&query=' || encodeURLComponent(
-            'select value from system.zookeeper where path=''//test/02448/' || currentDatabase() || '/rmt/replicas/1/is_lost'' and value=''1'''
+            'select value from system.zookeeper where path=''/test/02448/' || currentDatabase() || '/rmt/replicas/1'' and name=''is_lost'' and value=''0'''
     ), 'LineAsString', 's String') settings max_threads=1 format Null;
 
 -- rmt1 will mimic rmt2, but will not be able to fetch parts for a while

From fc3bbc3501e3c2f3909b867af7f4ecfb33adc825 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Tue, 20 Jun 2023 00:00:16 +0300
Subject: [PATCH 588/722] Update decimal.md

---
 docs/en/sql-reference/data-types/decimal.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/data-types/decimal.md b/docs/en/sql-reference/data-types/decimal.md
index de16462c86e..bba5ea74ebe 100644
--- a/docs/en/sql-reference/data-types/decimal.md
+++ b/docs/en/sql-reference/data-types/decimal.md
@@ -60,7 +60,7 @@ Some functions on Decimal return result as Float64 (for example, var or stddev).
 During calculations on Decimal, integer overflows might happen. Excessive digits in a fraction are discarded (not rounded). Excessive digits in integer part will lead to an exception.
 
 :::warning
-Overflow check is not implemented for Decimal128 and Decimal256. In case of overflow incorrect result is always silently returned.
+Overflow check is not implemented for Decimal128 and Decimal256. In case of overflow incorrect result is returned, no exception is thrown.
 :::
 
 ``` sql

From f9b8358409b6e1b1420b8d347d38bc74b791f956 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Tue, 20 Jun 2023 00:01:16 +0300
Subject: [PATCH 589/722] Update decimal.md

---
 docs/ru/sql-reference/data-types/decimal.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ru/sql-reference/data-types/decimal.md b/docs/ru/sql-reference/data-types/decimal.md
index e1267409c70..dbbf18253b2 100644
--- a/docs/ru/sql-reference/data-types/decimal.md
+++ b/docs/ru/sql-reference/data-types/decimal.md
@@ -60,7 +60,7 @@ sidebar_label: Decimal
 При выполнении операций над типом Decimal могут происходить целочисленные переполнения. Лишняя дробная часть отбрасывается (не округляется). Лишняя целочисленная часть приводит к исключению.
 
 :::warning
-Проверка переполнения не реализована для Decimal128 и Decimal256. В случае переполнения, неверный результат всегда возвращается без выбрасывания исключения.
+Проверка переполнения не реализована для Decimal128 и Decimal256. В случае переполнения неверный результат будёт возвращён без выбрасывания исключения.
 :::
 
 ``` sql

From 4754d7863c1a4eb8a1109a13f7e632e81be9501e Mon Sep 17 00:00:00 2001
From: zvonand <azvonov@altinity.com>
Date: Tue, 20 Jun 2023 03:21:03 +0200
Subject: [PATCH 590/722] small

---
 src/Common/DateLUT.h | 12 +++++++-----
 src/Core/Settings.h  |  2 +-
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/src/Common/DateLUT.h b/src/Common/DateLUT.h
index d17cbef80ee..2045d4895e7 100644
--- a/src/Common/DateLUT.h
+++ b/src/Common/DateLUT.h
@@ -17,9 +17,9 @@
 class DateLUT : private boost::noncopyable
 {
 public:
-    /// Return singleton DateLUTImpl instance for session timezone.
-    /// The session timezone is configured by a session setting.
-    /// If not set (empty string), it is the server timezone.
+    /// Return DateLUTImpl instance for session timezone.
+    /// session_timezone is a session-level setting.
+    /// If setting is not set, returns the server timezone.
     static ALWAYS_INLINE const DateLUTImpl & instance()
     {
         const auto & date_lut = getInstance();
@@ -37,7 +37,8 @@ public:
                     return date_lut.getImplementation(timezone_from_context);
             }
 
-            /// Timezone is passed in query_context, but on CH-Client we have no query context,
+            /// On the server side, timezone is passed in query_context,
+            /// but on CH-client side we have no query context,
             /// and each time we modify client's global context
             const DB::ContextPtr global_context = DB::CurrentThread::get().getGlobalContext();
             if (global_context)
@@ -61,7 +62,8 @@ public:
         return date_lut.getImplementation(time_zone);
     }
 
-    // Return singleton DateLUTImpl for the server time zone.
+    /// Return singleton DateLUTImpl for the server time zone.
+    /// It may be set using 'timezone' server setting.
     static ALWAYS_INLINE const DateLUTImpl & serverTimezoneInstance()
     {
         const auto & date_lut = getInstance();
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 344f9a5ee6d..ccfe5c057e3 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -768,7 +768,7 @@ class IColumn;
     M(Bool, allow_experimental_undrop_table_query, false, "Allow to use undrop query to restore dropped table in a limited time", 0) \
     M(Bool, keeper_map_strict_mode, false, "Enforce additional checks during operations on KeeperMap. E.g. throw an exception on an insert for already existing key", 0) \
     M(UInt64, extract_kvp_max_pairs_per_row, 1000, "Max number pairs that can be produced by extractKeyValuePairs function. Used to safeguard against consuming too much memory.", 0) \
-    M(Timezone, session_timezone, "", "The default timezone for the current session. The server default timezone, if empty.", 0) \
+    M(Timezone, session_timezone, "", "The default timezone for current session or query. The server default timezone, if empty.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 

From 129b97c72783e64b0bc7485b72ec1a82f8db0045 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sat, 3 Jun 2023 21:31:08 +0300
Subject: [PATCH 591/722] JIT infrastructure refactoring

---
 src/AggregateFunctions/AggregateFunctionAvg.h |  12 +-
 .../AggregateFunctionAvgWeighted.h            |  11 +-
 .../AggregateFunctionBitwise.h                |   5 +-
 .../AggregateFunctionCount.h                  |   6 +-
 .../AggregateFunctionIf.cpp                   |  48 ++-
 src/AggregateFunctions/AggregateFunctionIf.h  |  24 +-
 .../AggregateFunctionMinMaxAny.h              |   4 +-
 .../AggregateFunctionNull.h                   |  39 +--
 src/AggregateFunctions/AggregateFunctionSum.h |   7 +-
 src/AggregateFunctions/IAggregateFunction.h   |   3 +-
 src/Core/ValueWithType.h                      |  26 ++
 src/Core/ValuesWithType.h                     |  13 +
 src/DataTypes/IDataType.h                     |   5 -
 src/DataTypes/Native.cpp                      | 199 ++++++++++++
 src/DataTypes/Native.h                        | 284 ++++--------------
 src/Functions/FunctionBinaryArithmetic.h      |  35 ++-
 src/Functions/FunctionIfBase.h                |  24 +-
 src/Functions/FunctionUnaryArithmetic.h       |  29 +-
 src/Functions/FunctionsComparison.h           |  20 +-
 src/Functions/FunctionsLogical.h              |  33 +-
 src/Functions/IFunction.cpp                   |  64 ++--
 src/Functions/IFunction.h                     |  13 +-
 src/Functions/IFunctionAdaptors.h             |   6 +-
 src/Interpreters/ExpressionJIT.cpp            |   4 +-
 src/Interpreters/JIT/CHJIT.h                  |   4 +-
 src/Interpreters/JIT/CompileDAG.cpp           |  21 +-
 src/Interpreters/JIT/CompileDAG.h             |   2 +-
 src/Interpreters/JIT/compileFunction.cpp      |  24 +-
 28 files changed, 523 insertions(+), 442 deletions(-)
 create mode 100644 src/Core/ValueWithType.h
 create mode 100644 src/Core/ValuesWithType.h
 create mode 100644 src/DataTypes/Native.cpp

diff --git a/src/AggregateFunctions/AggregateFunctionAvg.h b/src/AggregateFunctions/AggregateFunctionAvg.h
index a86c7d042fc..37f20fca01c 100644
--- a/src/AggregateFunctions/AggregateFunctionAvg.h
+++ b/src/AggregateFunctions/AggregateFunctionAvg.h
@@ -146,8 +146,8 @@ public:
         for (const auto & argument : this->argument_types)
             can_be_compiled &= canBeNativeType(*argument);
 
-        auto return_type = this->getResultType();
-        can_be_compiled &= canBeNativeType(*return_type);
+        const auto & result_type = this->getResultType();
+        can_be_compiled &= canBeNativeType(*result_type);
 
         return can_be_compiled;
     }
@@ -198,8 +198,8 @@ public:
         auto * denominator_ptr = b.CreateConstGEP1_32(b.getInt8Ty(), aggregate_data_ptr, denominator_offset);
         auto * denominator_value = b.CreateLoad(denominator_type, denominator_ptr);
 
-        auto * double_numerator = nativeCast<Numerator>(b, numerator_value, b.getDoubleTy());
-        auto * double_denominator = nativeCast<Denominator>(b, denominator_value, b.getDoubleTy());
+        auto * double_numerator = nativeCast<Numerator>(b, numerator_value, this->getResultType());
+        auto * double_denominator = nativeCast<Denominator>(b, denominator_value, this->getResultType());
 
         return b.CreateFDiv(double_numerator, double_denominator);
     }
@@ -308,7 +308,7 @@ public:
 
 #if USE_EMBEDDED_COMPILER
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
@@ -316,7 +316,7 @@ public:
 
         auto * numerator_ptr = aggregate_data_ptr;
         auto * numerator_value = b.CreateLoad(numerator_type, numerator_ptr);
-        auto * value_cast_to_numerator = nativeCast(b, arguments_types[0], argument_values[0], numerator_type);
+        auto * value_cast_to_numerator = nativeCast(b, arguments[0], toNativeDataType<Numerator>());
         auto * numerator_result_value = numerator_type->isIntegerTy() ? b.CreateAdd(numerator_value, value_cast_to_numerator) : b.CreateFAdd(numerator_value, value_cast_to_numerator);
         b.CreateStore(numerator_result_value, numerator_ptr);
 
diff --git a/src/AggregateFunctions/AggregateFunctionAvgWeighted.h b/src/AggregateFunctions/AggregateFunctionAvgWeighted.h
index bc3e3a32a71..5a3869032ca 100644
--- a/src/AggregateFunctions/AggregateFunctionAvgWeighted.h
+++ b/src/AggregateFunctions/AggregateFunctionAvgWeighted.h
@@ -30,7 +30,7 @@ public:
 
     using Numerator = typename Base::Numerator;
     using Denominator = typename Base::Denominator;
-     using Fraction = typename Base::Fraction;
+    using Fraction = typename Base::Fraction;
 
     void NO_SANITIZE_UNDEFINED add(AggregateDataPtr __restrict place, const IColumn ** columns, size_t row_num, Arena *) const override
     {
@@ -55,7 +55,7 @@ public:
         return can_be_compiled;
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
@@ -63,8 +63,9 @@ public:
         auto * numerator_ptr = aggregate_data_ptr;
         auto * numerator_value = b.CreateLoad(numerator_type, numerator_ptr);
 
-        auto * argument = nativeCast(b, arguments_types[0], argument_values[0], numerator_type);
-        auto * weight = nativeCast(b, arguments_types[1], argument_values[1], numerator_type);
+        auto numerator_data_type = toNativeDataType<Numerator>();
+        auto * argument = nativeCast(b, arguments[0], numerator_data_type);
+        auto * weight = nativeCast(b, arguments[1], numerator_data_type);
 
         llvm::Value * value_weight_multiplication = argument->getType()->isIntegerTy() ? b.CreateMul(argument, weight) : b.CreateFMul(argument, weight);
         auto * numerator_result_value = numerator_type->isIntegerTy() ? b.CreateAdd(numerator_value, value_weight_multiplication) : b.CreateFAdd(numerator_value, value_weight_multiplication);
@@ -75,7 +76,7 @@ public:
         static constexpr size_t denominator_offset = offsetof(Fraction, denominator);
         auto * denominator_ptr = b.CreateConstInBoundsGEP1_64(b.getInt8Ty(), aggregate_data_ptr, denominator_offset);
 
-        auto * weight_cast_to_denominator = nativeCast(b, arguments_types[1], argument_values[1], denominator_type);
+        auto * weight_cast_to_denominator = nativeCast(b, arguments[1], toNativeDataType<Denominator>());
 
         auto * denominator_value = b.CreateLoad(denominator_type, denominator_ptr);
         auto * denominator_value_updated = denominator_type->isIntegerTy() ? b.CreateAdd(denominator_value, weight_cast_to_denominator) : b.CreateFAdd(denominator_value, weight_cast_to_denominator);
diff --git a/src/AggregateFunctions/AggregateFunctionBitwise.h b/src/AggregateFunctions/AggregateFunctionBitwise.h
index 6c94a72bf32..71479b309c7 100644
--- a/src/AggregateFunctions/AggregateFunctionBitwise.h
+++ b/src/AggregateFunctions/AggregateFunctionBitwise.h
@@ -148,7 +148,7 @@ public:
         Data::compileCreate(builder, value_ptr);
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes &, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
@@ -157,8 +157,7 @@ public:
         auto * value_ptr = aggregate_data_ptr;
         auto * value = b.CreateLoad(return_type, value_ptr);
 
-        const auto & argument_value = argument_values[0];
-        auto * result_value = Data::compileUpdate(builder, value, argument_value);
+        auto * result_value = Data::compileUpdate(builder, value, arguments[0].value);
 
         b.CreateStore(result_value, value_ptr);
     }
diff --git a/src/AggregateFunctions/AggregateFunctionCount.h b/src/AggregateFunctions/AggregateFunctionCount.h
index 848a8a4b603..77d3bfeb448 100644
--- a/src/AggregateFunctions/AggregateFunctionCount.h
+++ b/src/AggregateFunctions/AggregateFunctionCount.h
@@ -165,7 +165,7 @@ public:
         b.CreateMemSet(aggregate_data_ptr, llvm::ConstantInt::get(b.getInt8Ty(), 0), sizeof(AggregateFunctionCountData), llvm::assumeAligned(this->alignOfData()));
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes &, const std::vector<llvm::Value *> &) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType &) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
@@ -309,13 +309,13 @@ public:
         b.CreateMemSet(aggregate_data_ptr, llvm::ConstantInt::get(b.getInt8Ty(), 0), sizeof(AggregateFunctionCountData), llvm::assumeAligned(this->alignOfData()));
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes &, const std::vector<llvm::Value *> & values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
         auto * return_type = toNativeType(b, this->getResultType());
 
-        auto * is_null_value = b.CreateExtractValue(values[0], {1});
+        auto * is_null_value = b.CreateExtractValue(arguments[0].value, {1});
         auto * increment_value = b.CreateSelect(is_null_value, llvm::ConstantInt::get(return_type, 0), llvm::ConstantInt::get(return_type, 1));
 
         auto * count_value_ptr = aggregate_data_ptr;
diff --git a/src/AggregateFunctions/AggregateFunctionIf.cpp b/src/AggregateFunctions/AggregateFunctionIf.cpp
index 20bdb32796a..87fa8239507 100644
--- a/src/AggregateFunctions/AggregateFunctionIf.cpp
+++ b/src/AggregateFunctions/AggregateFunctionIf.cpp
@@ -188,18 +188,18 @@ public:
         return canBeNativeType(*this->argument_types.back()) && this->nested_function->isCompilable();
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-        const auto & nullable_type = arguments_types[0];
-        const auto & nullable_value = argument_values[0];
+        const auto & nullable_type = arguments[0].type;
+        const auto & nullable_value = arguments[0].value;
 
         auto * wrapped_value = b.CreateExtractValue(nullable_value, {0});
         auto * is_null_value = b.CreateExtractValue(nullable_value, {1});
 
-        const auto & predicate_type = arguments_types[argument_values.size() - 1];
-        auto * predicate_value = argument_values[argument_values.size() - 1];
+        const auto & predicate_type = arguments.back().type;
+        auto * predicate_value = arguments.back().value;
         auto * is_predicate_true = nativeBoolCast(b, predicate_type, predicate_value);
 
         auto * head = b.GetInsertBlock();
@@ -219,7 +219,7 @@ public:
             b.CreateStore(llvm::ConstantInt::get(b.getInt8Ty(), 1), aggregate_data_ptr);
 
         auto * aggregate_data_ptr_with_prefix_size_offset = b.CreateConstInBoundsGEP1_64(b.getInt8Ty(), aggregate_data_ptr, this->prefix_size);
-        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, { removeNullable(nullable_type) }, { wrapped_value });
+        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, { ValueWithType(wrapped_value, removeNullable(nullable_type)) });
         b.CreateBr(join_block);
 
         b.SetInsertPoint(join_block);
@@ -370,38 +370,31 @@ public:
         return canBeNativeType(*this->argument_types.back()) && this->nested_function->isCompilable();
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
-        /// TODO: Check
-
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-        size_t arguments_size = arguments_types.size();
+        size_t arguments_size = arguments.size();
+
+        ValuesWithType wrapped_arguments;
+        wrapped_arguments.reserve(arguments_size);
 
-        DataTypes non_nullable_types;
-        std::vector<llvm::Value * > wrapped_values;
         std::vector<llvm::Value * > is_null_values;
 
-        non_nullable_types.resize(arguments_size);
-        wrapped_values.resize(arguments_size);
-        is_null_values.resize(arguments_size);
-
         for (size_t i = 0; i < arguments_size; ++i)
         {
-            const auto & argument_value = argument_values[i];
+            const auto & argument_value = arguments[i].value;
+            const auto & argument_type = arguments[i].type;
 
             if (is_nullable[i])
             {
                 auto * wrapped_value = b.CreateExtractValue(argument_value, {0});
-                is_null_values[i] = b.CreateExtractValue(argument_value, {1});
-
-                wrapped_values[i] = wrapped_value;
-                non_nullable_types[i] = removeNullable(arguments_types[i]);
+                is_null_values.emplace_back(b.CreateExtractValue(argument_value, {1}));
+                wrapped_arguments.emplace_back(wrapped_value, removeNullable(argument_type));
             }
             else
             {
-                wrapped_values[i] = argument_value;
-                non_nullable_types[i] = arguments_types[i];
+                wrapped_arguments.emplace_back(argument_value, argument_type);
             }
         }
 
@@ -415,9 +408,6 @@ public:
 
         for (auto * is_null_value : is_null_values)
         {
-            if (!is_null_value)
-                continue;
-
             auto * values_have_null = b.CreateLoad(b.getInt1Ty(), values_have_null_ptr);
             b.CreateStore(b.CreateOr(values_have_null, is_null_value), values_have_null_ptr);
         }
@@ -426,8 +416,8 @@ public:
 
         b.SetInsertPoint(join_block_after_null_checks);
 
-        const auto & predicate_type = arguments_types[argument_values.size() - 1];
-        auto * predicate_value = argument_values[argument_values.size() - 1];
+        const auto & predicate_type = arguments.back().type;
+        auto * predicate_value = arguments.back().value;
         auto * is_predicate_true = nativeBoolCast(b, predicate_type, predicate_value);
 
         auto * if_true = llvm::BasicBlock::Create(head->getContext(), "if_true", head->getParent());
@@ -444,7 +434,7 @@ public:
             b.CreateStore(llvm::ConstantInt::get(b.getInt8Ty(), 1), aggregate_data_ptr);
 
         auto * aggregate_data_ptr_with_prefix_size_offset = b.CreateConstInBoundsGEP1_64(b.getInt8Ty(), aggregate_data_ptr, this->prefix_size);
-        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, non_nullable_types, wrapped_values);
+        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, wrapped_arguments);
         b.CreateBr(join_block);
 
         b.SetInsertPoint(join_block);
diff --git a/src/AggregateFunctions/AggregateFunctionIf.h b/src/AggregateFunctions/AggregateFunctionIf.h
index cd7d7e27a25..afab861e202 100644
--- a/src/AggregateFunctions/AggregateFunctionIf.h
+++ b/src/AggregateFunctions/AggregateFunctionIf.h
@@ -223,12 +223,12 @@ public:
         nested_func->compileCreate(builder, aggregate_data_ptr);
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-        const auto & predicate_type = arguments_types[argument_values.size() - 1];
-        auto * predicate_value = argument_values[argument_values.size() - 1];
+        const auto & predicate_type = arguments.back().type;
+        auto * predicate_value = arguments.back().value;
 
         auto * head = b.GetInsertBlock();
 
@@ -242,21 +242,9 @@ public:
 
         b.SetInsertPoint(if_true);
 
-        size_t arguments_size_without_predicate = arguments_types.size() - 1;
-
-        DataTypes argument_types_without_predicate;
-        std::vector<llvm::Value *> argument_values_without_predicate;
-
-        argument_types_without_predicate.resize(arguments_size_without_predicate);
-        argument_values_without_predicate.resize(arguments_size_without_predicate);
-
-        for (size_t i = 0; i < arguments_size_without_predicate; ++i)
-        {
-            argument_types_without_predicate[i] = arguments_types[i];
-            argument_values_without_predicate[i] = argument_values[i];
-        }
-
-        nested_func->compileAdd(builder, aggregate_data_ptr, argument_types_without_predicate, argument_values_without_predicate);
+        ValuesWithType arguments_without_predicate = arguments;
+        arguments_without_predicate.pop_back();
+        nested_func->compileAdd(builder, aggregate_data_ptr, arguments_without_predicate);
 
         b.CreateBr(join_block);
 
diff --git a/src/AggregateFunctions/AggregateFunctionMinMaxAny.h b/src/AggregateFunctions/AggregateFunctionMinMaxAny.h
index 94c0d60be81..5312df32459 100644
--- a/src/AggregateFunctions/AggregateFunctionMinMaxAny.h
+++ b/src/AggregateFunctions/AggregateFunctionMinMaxAny.h
@@ -1459,11 +1459,11 @@ public:
         b.CreateMemSet(aggregate_data_ptr, llvm::ConstantInt::get(b.getInt8Ty(), 0), this->sizeOfData(), llvm::assumeAligned(this->alignOfData()));
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes &, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         if constexpr (Data::is_compilable)
         {
-            Data::compileChangeIfBetter(builder, aggregate_data_ptr, argument_values[0]);
+            Data::compileChangeIfBetter(builder, aggregate_data_ptr, arguments[0].value);
         }
         else
         {
diff --git a/src/AggregateFunctions/AggregateFunctionNull.h b/src/AggregateFunctions/AggregateFunctionNull.h
index de7b190c949..6b6580bf4c4 100644
--- a/src/AggregateFunctions/AggregateFunctionNull.h
+++ b/src/AggregateFunctions/AggregateFunctionNull.h
@@ -378,12 +378,12 @@ public:
 
 #if USE_EMBEDDED_COMPILER
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-        const auto & nullable_type = arguments_types[0];
-        const auto & nullable_value = argument_values[0];
+        const auto & nullable_type = arguments[0].type;
+        const auto & nullable_value = arguments[0].value;
 
         auto * wrapped_value = b.CreateExtractValue(nullable_value, {0});
         auto * is_null_value = b.CreateExtractValue(nullable_value, {1});
@@ -405,7 +405,7 @@ public:
             b.CreateStore(llvm::ConstantInt::get(b.getInt8Ty(), 1), aggregate_data_ptr);
 
         auto * aggregate_data_ptr_with_prefix_size_offset = b.CreateConstInBoundsGEP1_64(b.getInt8Ty(), aggregate_data_ptr, this->prefix_size);
-        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, { removeNullable(nullable_type) }, { wrapped_value });
+        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, { ValueWithType(wrapped_value, removeNullable(nullable_type)) });
         b.CreateBr(join_block);
 
         b.SetInsertPoint(join_block);
@@ -568,36 +568,32 @@ public:
 
 #if USE_EMBEDDED_COMPILER
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-        size_t arguments_size = arguments_types.size();
+        size_t arguments_size = arguments.size();
 
-        DataTypes non_nullable_types;
-        std::vector<llvm::Value * > wrapped_values;
-        std::vector<llvm::Value * > is_null_values;
+        ValuesWithType wrapped_arguments;
+        wrapped_arguments.reserve(arguments_size);
 
-        non_nullable_types.resize(arguments_size);
-        wrapped_values.resize(arguments_size);
-        is_null_values.resize(arguments_size);
+        std::vector<llvm::Value *> is_null_values;
+        is_null_values.reserve(arguments_size);
 
         for (size_t i = 0; i < arguments_size; ++i)
         {
-            const auto & argument_value = argument_values[i];
+            const auto & argument_value = arguments[i].value;
+            const auto & argument_type = arguments[i].type;
 
             if (is_nullable[i])
             {
                 auto * wrapped_value = b.CreateExtractValue(argument_value, {0});
-                is_null_values[i] = b.CreateExtractValue(argument_value, {1});
-
-                wrapped_values[i] = wrapped_value;
-                non_nullable_types[i] = removeNullable(arguments_types[i]);
+                is_null_values.emplace_back(b.CreateExtractValue(argument_value, {1}));
+                wrapped_arguments.emplace_back(wrapped_value, removeNullable(argument_type));
             }
             else
             {
-                wrapped_values[i] = argument_value;
-                non_nullable_types[i] = arguments_types[i];
+                wrapped_arguments.emplace_back(argument_value, argument_type);
             }
         }
 
@@ -612,9 +608,6 @@ public:
 
         for (auto * is_null_value : is_null_values)
         {
-            if (!is_null_value)
-                continue;
-
             auto * values_have_null = b.CreateLoad(b.getInt1Ty(), values_have_null_ptr);
             b.CreateStore(b.CreateOr(values_have_null, is_null_value), values_have_null_ptr);
         }
@@ -630,7 +623,7 @@ public:
             b.CreateStore(llvm::ConstantInt::get(b.getInt8Ty(), 1), aggregate_data_ptr);
 
         auto * aggregate_data_ptr_with_prefix_size_offset = b.CreateConstInBoundsGEP1_64(b.getInt8Ty(), aggregate_data_ptr, this->prefix_size);
-        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, arguments_types, wrapped_values);
+        this->nested_function->compileAdd(b, aggregate_data_ptr_with_prefix_size_offset, wrapped_arguments);
         b.CreateBr(join_block);
 
         b.SetInsertPoint(join_block);
diff --git a/src/AggregateFunctions/AggregateFunctionSum.h b/src/AggregateFunctions/AggregateFunctionSum.h
index f77d1dae36f..bb0804c14b3 100644
--- a/src/AggregateFunctions/AggregateFunctionSum.h
+++ b/src/AggregateFunctions/AggregateFunctionSum.h
@@ -588,7 +588,7 @@ public:
         b.CreateStore(llvm::Constant::getNullValue(return_type), aggregate_sum_ptr);
     }
 
-    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const DataTypes & arguments_types, const std::vector<llvm::Value *> & argument_values) const override
+    void compileAdd(llvm::IRBuilderBase & builder, llvm::Value * aggregate_data_ptr, const ValuesWithType & arguments) const override
     {
         llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
@@ -597,10 +597,7 @@ public:
         auto * sum_value_ptr = aggregate_data_ptr;
         auto * sum_value = b.CreateLoad(return_type, sum_value_ptr);
 
-        const auto & argument_type = arguments_types[0];
-        const auto & argument_value = argument_values[0];
-
-        auto * value_cast_to_result = nativeCast(b, argument_type, argument_value, return_type);
+        auto * value_cast_to_result = nativeCast(b, arguments[0], this->getResultType());
         auto * sum_result_value = sum_value->getType()->isIntegerTy() ? b.CreateAdd(sum_value, value_cast_to_result) : b.CreateFAdd(sum_value, value_cast_to_result);
 
         b.CreateStore(sum_result_value, sum_value_ptr);
diff --git a/src/AggregateFunctions/IAggregateFunction.h b/src/AggregateFunctions/IAggregateFunction.h
index ddc0535d0e4..df08b6f2109 100644
--- a/src/AggregateFunctions/IAggregateFunction.h
+++ b/src/AggregateFunctions/IAggregateFunction.h
@@ -6,6 +6,7 @@
 #include <Core/Block.h>
 #include <Core/ColumnNumbers.h>
 #include <Core/Field.h>
+#include <Core/ValuesWithType.h>
 #include <Interpreters/Context_fwd.h>
 #include <base/types.h>
 #include <Common/Exception.h>
@@ -389,7 +390,7 @@ public:
     }
 
     /// compileAdd should generate code for updating aggregate function state stored in aggregate_data_ptr
-    virtual void compileAdd(llvm::IRBuilderBase & /*builder*/, llvm::Value * /*aggregate_data_ptr*/, const DataTypes & /*arguments_types*/, const std::vector<llvm::Value *> & /*arguments_values*/) const
+    virtual void compileAdd(llvm::IRBuilderBase & /*builder*/, llvm::Value * /*aggregate_data_ptr*/, const ValuesWithType & /*arguments*/) const
     {
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "{} is not JIT-compilable", getName());
     }
diff --git a/src/Core/ValueWithType.h b/src/Core/ValueWithType.h
new file mode 100644
index 00000000000..b5f61a1c5f7
--- /dev/null
+++ b/src/Core/ValueWithType.h
@@ -0,0 +1,26 @@
+#pragma once
+
+#include <DataTypes/IDataType.h>
+
+namespace llvm
+{
+    class Value;
+}
+
+namespace DB
+{
+
+/// LLVM value with its data type
+struct ValueWithType
+{
+    llvm::Value * value = nullptr;
+    DataTypePtr type;
+
+    ValueWithType() = default;
+    ValueWithType(llvm::Value * value_, DataTypePtr type_)
+        : value(value_)
+        , type(std::move(type_))
+    {}
+};
+
+}
diff --git a/src/Core/ValuesWithType.h b/src/Core/ValuesWithType.h
new file mode 100644
index 00000000000..92060419197
--- /dev/null
+++ b/src/Core/ValuesWithType.h
@@ -0,0 +1,13 @@
+#pragma once
+
+#include <vector>
+
+#include <Core/ValueWithType.h>
+
+
+namespace DB
+{
+
+using ValuesWithType = std::vector<ValueWithType>;
+
+}
diff --git a/src/DataTypes/IDataType.h b/src/DataTypes/IDataType.h
index 7cc18fea00c..7a705e8fd19 100644
--- a/src/DataTypes/IDataType.h
+++ b/src/DataTypes/IDataType.h
@@ -532,11 +532,6 @@ inline bool isNotDecimalButComparableToDecimal(const DataTypePtr & data_type)
     return which.isInt() || which.isUInt() || which.isFloat();
 }
 
-inline bool isCompilableType(const DataTypePtr & data_type)
-{
-    return data_type->isValueRepresentedByNumber() && !isDecimal(data_type);
-}
-
 inline bool isBool(const DataTypePtr & data_type)
 {
     return data_type->getName() == "Bool";
diff --git a/src/DataTypes/Native.cpp b/src/DataTypes/Native.cpp
new file mode 100644
index 00000000000..acbd70ba04f
--- /dev/null
+++ b/src/DataTypes/Native.cpp
@@ -0,0 +1,199 @@
+#include <DataTypes/Native.h>
+
+#if USE_EMBEDDED_COMPILER
+#    include <DataTypes/DataTypeNullable.h>
+#    include <Columns/ColumnConst.h>
+#    include <Columns/ColumnNullable.h>
+
+
+namespace DB
+{
+
+namespace ErrorCodes
+{
+    extern const int NOT_IMPLEMENTED;
+}
+
+bool typeIsSigned(const IDataType & type)
+{
+    WhichDataType data_type(type);
+    return data_type.isNativeInt() || data_type.isFloat() || data_type.isEnum() || data_type.isDate32();
+}
+
+llvm::Type * toNullableType(llvm::IRBuilderBase & builder, llvm::Type * type)
+{
+    auto * is_null_type = builder.getInt1Ty();
+    return llvm::StructType::get(type, is_null_type);
+}
+
+bool canBeNativeType(const IDataType & type)
+{
+    WhichDataType data_type(type);
+
+    if (data_type.isNullable())
+    {
+        const auto & data_type_nullable = static_cast<const DataTypeNullable&>(type);
+        return canBeNativeType(*data_type_nullable.getNestedType());
+    }
+
+    return data_type.isNativeInt() || data_type.isNativeUInt() || data_type.isFloat() || data_type.isDate()
+        || data_type.isDate32() || data_type.isDateTime() || data_type.isEnum();
+}
+
+bool canBeNativeType(const DataTypePtr & type)
+{
+    return canBeNativeType(*type);
+}
+
+llvm::Type * toNativeType(llvm::IRBuilderBase & builder, const IDataType & type)
+{
+    WhichDataType data_type(type);
+
+    if (data_type.isNullable())
+    {
+        const auto & data_type_nullable = static_cast<const DataTypeNullable&>(type);
+        auto * nested_type = toNativeType(builder, *data_type_nullable.getNestedType());
+        return toNullableType(builder, nested_type);
+    }
+
+    /// LLVM doesn't have unsigned types, it has unsigned instructions.
+    if (data_type.isInt8() || data_type.isUInt8())
+        return builder.getInt8Ty();
+    else if (data_type.isInt16() || data_type.isUInt16() || data_type.isDate())
+        return builder.getInt16Ty();
+    else if (data_type.isInt32() || data_type.isUInt32() || data_type.isDate32() || data_type.isDateTime())
+        return builder.getInt32Ty();
+    else if (data_type.isInt64() || data_type.isUInt64())
+        return builder.getInt64Ty();
+    else if (data_type.isFloat32())
+        return builder.getFloatTy();
+    else if (data_type.isFloat64())
+        return builder.getDoubleTy();
+    else if (data_type.isEnum8())
+        return builder.getInt8Ty();
+    else if (data_type.isEnum16())
+        return builder.getInt16Ty();
+
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid cast to native type");
+}
+
+llvm::Type * toNativeType(llvm::IRBuilderBase & builder, const DataTypePtr & type)
+{
+    return toNativeType(builder, *type);
+}
+
+llvm::Value * nativeBoolCast(llvm::IRBuilderBase & b, const DataTypePtr & from_type, llvm::Value * value)
+{
+    if (from_type->isNullable())
+    {
+        auto * inner = nativeBoolCast(b, removeNullable(from_type), b.CreateExtractValue(value, {0}));
+        return b.CreateAnd(b.CreateNot(b.CreateExtractValue(value, {1})), inner);
+    }
+
+    auto * zero = llvm::Constant::getNullValue(value->getType());
+
+    if (value->getType()->isIntegerTy())
+        return b.CreateICmpNE(value, zero);
+    else if (value->getType()->isFloatingPointTy())
+        return b.CreateFCmpUNE(value, zero);
+
+    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Cannot cast non-number {} to bool", from_type->getName());
+}
+
+llvm::Value * nativeBoolCast(llvm::IRBuilderBase & b, const ValueWithType & value_with_type)
+{
+    return nativeBoolCast(b, value_with_type.type, value_with_type.value);
+}
+
+llvm::Value * nativeCast(llvm::IRBuilderBase & b, const DataTypePtr & from_type, llvm::Value * value, const DataTypePtr & to_type)
+{
+    if (from_type->equals(*to_type))
+    {
+        return value;
+    }
+    else if (from_type->isNullable() && to_type->isNullable())
+    {
+        auto * inner = nativeCast(b, removeNullable(from_type), b.CreateExtractValue(value, {0}), to_type);
+        return b.CreateInsertValue(inner, b.CreateExtractValue(value, {1}), {1});
+    }
+    else if (from_type->isNullable())
+    {
+        return nativeCast(b, removeNullable(from_type), b.CreateExtractValue(value, {0}), to_type);
+    }
+    else if (to_type->isNullable())
+    {
+        auto * from_native_type = toNativeType(b, from_type);
+        auto * inner = nativeCast(b, from_type, value, removeNullable(to_type));
+        return b.CreateInsertValue(llvm::Constant::getNullValue(from_native_type), inner, {0});
+    }
+    else
+    {
+        auto * from_native_type = toNativeType(b, from_type);
+        auto * to_native_type = toNativeType(b, to_type);
+
+        if (from_native_type == to_native_type)
+            return value;
+        else if (from_native_type->isIntegerTy() && to_native_type->isFloatingPointTy())
+            return typeIsSigned(*from_type) ? b.CreateSIToFP(value, to_native_type) : b.CreateUIToFP(value, to_native_type);
+        else if (from_native_type->isFloatingPointTy() && to_native_type->isIntegerTy())
+            return typeIsSigned(*to_type) ? b.CreateFPToSI(value, to_native_type) : b.CreateFPToUI(value, to_native_type);
+        else if (from_native_type->isIntegerTy() && from_native_type->isIntegerTy())
+            return b.CreateIntCast(value, to_native_type, typeIsSigned(*from_type));
+        else if (to_native_type->isFloatingPointTy() && to_native_type->isFloatingPointTy())
+            return b.CreateFPCast(value, to_native_type);
+    }
+
+    throw Exception(ErrorCodes::LOGICAL_ERROR,
+        "Invalid cast to native value from type {} to type {}",
+        from_type->getName(),
+        to_type->getName());
+}
+
+llvm::Value * nativeCast(llvm::IRBuilderBase & b, const ValueWithType & value, const DataTypePtr & to_type)
+{
+    return nativeCast(b, value.type, value.value, to_type);
+}
+
+llvm::Constant * getColumnNativeValue(llvm::IRBuilderBase & builder, const DataTypePtr & column_type, const IColumn & column, size_t index)
+{
+    if (const auto * constant = typeid_cast<const ColumnConst *>(&column))
+        return getColumnNativeValue(builder, column_type, constant->getDataColumn(), 0);
+
+    auto * type = toNativeType(builder, column_type);
+
+    WhichDataType column_data_type(column_type);
+    if (column_data_type.isNullable())
+    {
+        const auto & nullable_data_type = assert_cast<const DataTypeNullable &>(*column_type);
+        const auto & nullable_column = assert_cast<const ColumnNullable &>(column);
+
+        auto * value = getColumnNativeValue(builder, nullable_data_type.getNestedType(), nullable_column.getNestedColumn(), index);
+        auto * is_null = llvm::ConstantInt::get(type->getContainedType(1), nullable_column.isNullAt(index));
+
+        return llvm::ConstantStruct::get(static_cast<llvm::StructType *>(type), value, is_null);
+    }
+    else if (column_data_type.isFloat32())
+    {
+        return llvm::ConstantFP::get(type, assert_cast<const ColumnVector<Float32> &>(column).getElement(index));
+    }
+    else if (column_data_type.isFloat64())
+    {
+        return llvm::ConstantFP::get(type, assert_cast<const ColumnVector<Float64> &>(column).getElement(index));
+    }
+    else if (column_data_type.isNativeUInt() || column_data_type.isDate() || column_data_type.isDateTime())
+    {
+        return llvm::ConstantInt::get(type, column.getUInt(index));
+    }
+    else if (column_data_type.isNativeInt() || column_data_type.isEnum() || column_data_type.isDate32())
+    {
+        return llvm::ConstantInt::get(type, column.getInt(index));
+    }
+
+    throw Exception(ErrorCodes::LOGICAL_ERROR,
+        "Cannot get native value for column with type {}",
+        column_type->getName());
+}
+
+}
+
+#endif
diff --git a/src/DataTypes/Native.h b/src/DataTypes/Native.h
index a3c8486fa60..7fee452b1f0 100644
--- a/src/DataTypes/Native.h
+++ b/src/DataTypes/Native.h
@@ -4,65 +4,53 @@
 
 #if USE_EMBEDDED_COMPILER
 #    include <Common/Exception.h>
-
+#    include <Core/ValueWithType.h>
 #    include <DataTypes/IDataType.h>
-#    include <DataTypes/DataTypeNullable.h>
-#    include <Columns/ColumnConst.h>
-#    include <Columns/ColumnNullable.h>
 #    include <llvm/IR/IRBuilder.h>
 
 
 namespace DB
 {
+
 namespace ErrorCodes
 {
-    extern const int NOT_IMPLEMENTED;
+    extern const int LOGICAL_ERROR;
 }
 
-static inline bool typeIsSigned(const IDataType & type)
+/// Returns true if type is signed, false otherwise
+bool typeIsSigned(const IDataType & type);
+
+/// Cast LLVM type to nullable LLVM type
+llvm::Type * toNullableType(llvm::IRBuilderBase & builder, llvm::Type * type);
+
+/// Returns true if type can be native LLVM type, false otherwise
+bool canBeNativeType(const IDataType & type);
+
+/// Returns true if type can be native LLVM type, false otherwise
+bool canBeNativeType(const DataTypePtr & type);
+
+template <typename Type>
+static inline bool canBeNativeType()
 {
-    WhichDataType data_type(type);
-    return data_type.isNativeInt() || data_type.isFloat() || data_type.isEnum();
+    if constexpr (std::is_same_v<Type, Int8> || std::is_same_v<Type, UInt8>)
+        return true;
+    else if constexpr (std::is_same_v<Type, Int16> || std::is_same_v<Type, UInt16>)
+        return true;
+    else if constexpr (std::is_same_v<Type, Int32> || std::is_same_v<Type, UInt32>)
+        return true;
+    else if constexpr (std::is_same_v<Type, Int64> || std::is_same_v<Type, UInt64>)
+        return true;
+    else if constexpr (std::is_same_v<Type, Float32> || std::is_same_v<Type, Float64>)
+        return true;
+
+    return false;
 }
 
-static inline llvm::Type * toNullableType(llvm::IRBuilderBase & builder, llvm::Type * type)
-{
-    auto * is_null_type = builder.getInt1Ty();
-    return llvm::StructType::get(type, is_null_type);
-}
+/// Cast type to native LLVM type
+llvm::Type * toNativeType(llvm::IRBuilderBase & builder, const IDataType & type);
 
-static inline llvm::Type * toNativeType(llvm::IRBuilderBase & builder, const IDataType & type)
-{
-    WhichDataType data_type(type);
-
-    if (data_type.isNullable())
-    {
-        const auto & data_type_nullable = static_cast<const DataTypeNullable&>(type);
-        auto * wrapped = toNativeType(builder, *data_type_nullable.getNestedType());
-        auto * is_null_type = builder.getInt1Ty();
-        return wrapped ? llvm::StructType::get(wrapped, is_null_type) : nullptr;
-    }
-
-    /// LLVM doesn't have unsigned types, it has unsigned instructions.
-    if (data_type.isInt8() || data_type.isUInt8())
-        return builder.getInt8Ty();
-    else if (data_type.isInt16() || data_type.isUInt16() || data_type.isDate())
-        return builder.getInt16Ty();
-    else if (data_type.isInt32() || data_type.isUInt32() || data_type.isDate32() || data_type.isDateTime())
-        return builder.getInt32Ty();
-    else if (data_type.isInt64() || data_type.isUInt64())
-        return builder.getInt64Ty();
-    else if (data_type.isFloat32())
-        return builder.getFloatTy();
-    else if (data_type.isFloat64())
-        return builder.getDoubleTy();
-    else if (data_type.isEnum8())
-        return builder.getInt8Ty();
-    else if (data_type.isEnum16())
-        return builder.getInt16Ty();
-
-    return nullptr;
-}
+/// Cast type to native LLVM type
+llvm::Type * toNativeType(llvm::IRBuilderBase & builder, const DataTypePtr & type);
 
 template <typename ToType>
 static inline llvm::Type * toNativeType(llvm::IRBuilderBase & builder)
@@ -80,203 +68,43 @@ static inline llvm::Type * toNativeType(llvm::IRBuilderBase & builder)
     else if constexpr (std::is_same_v<ToType, Float64>)
         return builder.getDoubleTy();
 
-    return nullptr;
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid cast to native type");
 }
 
-template <typename Type>
-static inline bool canBeNativeType()
+template <typename ToType>
+static inline DataTypePtr toNativeDataType()
 {
-    if constexpr (std::is_same_v<Type, Int8> || std::is_same_v<Type, UInt8>)
-        return true;
-    else if constexpr (std::is_same_v<Type, Int16> || std::is_same_v<Type, UInt16>)
-        return true;
-    else if constexpr (std::is_same_v<Type, Int32> || std::is_same_v<Type, UInt32>)
-        return true;
-    else if constexpr (std::is_same_v<Type, Int64> || std::is_same_v<Type, UInt64>)
-        return true;
-    else if constexpr (std::is_same_v<Type, Float32>)
-        return true;
-    else if constexpr (std::is_same_v<Type, Float64>)
-        return true;
+    if constexpr (std::is_same_v<ToType, Int8> || std::is_same_v<ToType, UInt8> ||
+        std::is_same_v<ToType, Int16> || std::is_same_v<ToType, UInt16> ||
+        std::is_same_v<ToType, Int32> || std::is_same_v<ToType, UInt32> ||
+        std::is_same_v<ToType, Int64> || std::is_same_v<ToType, UInt64> ||
+        std::is_same_v<ToType, Float32> || std::is_same_v<ToType, Float64>)
+        return std::make_shared<DataTypeNumber<ToType>>();
 
-    return false;
+    throw Exception(ErrorCodes::LOGICAL_ERROR, "Invalid cast to native data type");
 }
 
-static inline bool canBeNativeType(const IDataType & type)
-{
-    WhichDataType data_type(type);
+/// Cast LLVM value with type to bool
+llvm::Value * nativeBoolCast(llvm::IRBuilderBase & b, const DataTypePtr & from_type, llvm::Value * value);
 
-    if (data_type.isNullable())
-    {
-        const auto & data_type_nullable = static_cast<const DataTypeNullable&>(type);
-        return canBeNativeType(*data_type_nullable.getNestedType());
-    }
+/// Cast LLVM value with type to bool
+llvm::Value * nativeBoolCast(llvm::IRBuilderBase & b, const ValueWithType & value_with_type);
 
-    return data_type.isNativeInt() || data_type.isNativeUInt() || data_type.isFloat() || data_type.isDate()
-        || data_type.isDate32() || data_type.isDateTime() || data_type.isEnum();
-}
+/// Cast LLVM value with type to specified type
+llvm::Value * nativeCast(llvm::IRBuilderBase & b, const DataTypePtr & from_type, llvm::Value * value, const DataTypePtr & to_type);
 
-static inline llvm::Type * toNativeType(llvm::IRBuilderBase & builder, const DataTypePtr & type)
-{
-    return toNativeType(builder, *type);
-}
-
-static inline llvm::Value * nativeBoolCast(llvm::IRBuilder<> & b, const DataTypePtr & from_type, llvm::Value * value)
-{
-    if (from_type->isNullable())
-    {
-        auto * inner = nativeBoolCast(b, removeNullable(from_type), b.CreateExtractValue(value, {0}));
-        return b.CreateAnd(b.CreateNot(b.CreateExtractValue(value, {1})), inner);
-    }
-    auto * zero = llvm::Constant::getNullValue(value->getType());
-
-    if (value->getType()->isIntegerTy())
-        return b.CreateICmpNE(value, zero);
-    if (value->getType()->isFloatingPointTy())
-        return b.CreateFCmpUNE(value, zero);
-
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Cannot cast non-number {} to bool", from_type->getName());
-}
-
-static inline llvm::Value * nativeCast(llvm::IRBuilder<> & b, const DataTypePtr & from, llvm::Value * value, llvm::Type * to_type)
-{
-    auto * from_type = value->getType();
-
-    if (from_type == to_type)
-        return value;
-    else if (from_type->isIntegerTy() && to_type->isFloatingPointTy())
-        return typeIsSigned(*from) ? b.CreateSIToFP(value, to_type) : b.CreateUIToFP(value, to_type);
-    else if (from_type->isFloatingPointTy() && to_type->isIntegerTy())
-        return typeIsSigned(*from) ? b.CreateFPToSI(value, to_type) : b.CreateFPToUI(value, to_type);
-    else if (from_type->isIntegerTy() && to_type->isIntegerTy())
-        return b.CreateIntCast(value, to_type, typeIsSigned(*from));
-    else if (from_type->isFloatingPointTy() && to_type->isFloatingPointTy())
-        return b.CreateFPCast(value, to_type);
-
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Cannot cast {} to requested type", from->getName());
-}
+/// Cast LLVM value with type to specified type
+llvm::Value * nativeCast(llvm::IRBuilderBase & b, const ValueWithType & value, const DataTypePtr & to_type);
 
 template <typename FromType>
-static inline llvm::Value * nativeCast(llvm::IRBuilder<> & b, llvm::Value * value, llvm::Type * to_type)
+static inline llvm::Value * nativeCast(llvm::IRBuilderBase & b, llvm::Value * value, const DataTypePtr & to)
 {
-    auto * from_type = value->getType();
-
-    static constexpr bool from_type_is_signed = std::numeric_limits<FromType>::is_signed;
-
-    if (from_type == to_type)
-        return value;
-    else if (from_type->isIntegerTy() && to_type->isFloatingPointTy())
-        return from_type_is_signed ? b.CreateSIToFP(value, to_type) : b.CreateUIToFP(value, to_type);
-    else if (from_type->isFloatingPointTy() && to_type->isIntegerTy())
-        return from_type_is_signed ? b.CreateFPToSI(value, to_type) : b.CreateFPToUI(value, to_type);
-    else if (from_type->isIntegerTy() && to_type->isIntegerTy())
-        return b.CreateIntCast(value, to_type, from_type_is_signed);
-    else if (from_type->isFloatingPointTy() && to_type->isFloatingPointTy())
-        return b.CreateFPCast(value, to_type);
-
-    throw Exception(ErrorCodes::NOT_IMPLEMENTED, "Cannot cast {} to requested type", TypeName<FromType>);
+    auto native_data_type = toNativeDataType<FromType>();
+    return nativeCast(b, native_data_type, value, to);
 }
 
-static inline llvm::Value * nativeCast(llvm::IRBuilder<> & b, const DataTypePtr & from, llvm::Value * value, const DataTypePtr & to)
-{
-    auto * n_to = toNativeType(b, to);
-
-    if (value->getType() == n_to)
-    {
-        return value;
-    }
-    else if (from->isNullable() && to->isNullable())
-    {
-        auto * inner = nativeCast(b, removeNullable(from), b.CreateExtractValue(value, {0}), to);
-        return b.CreateInsertValue(inner, b.CreateExtractValue(value, {1}), {1});
-    }
-    else if (from->isNullable())
-    {
-        return nativeCast(b, removeNullable(from), b.CreateExtractValue(value, {0}), to);
-    }
-    else if (to->isNullable())
-    {
-        auto * inner = nativeCast(b, from, value, removeNullable(to));
-        return b.CreateInsertValue(llvm::Constant::getNullValue(n_to), inner, {0});
-    }
-
-    return nativeCast(b, from, value, n_to);
-}
-
-static inline std::pair<llvm::Value *, llvm::Value *> nativeCastToCommon(llvm::IRBuilder<> & b, const DataTypePtr & lhs_type, llvm::Value * lhs, const DataTypePtr & rhs_type, llvm::Value * rhs) /// NOLINT
-{
-    llvm::Type * common;
-
-    bool lhs_is_signed = typeIsSigned(*lhs_type);
-    bool rhs_is_signed = typeIsSigned(*rhs_type);
-
-    if (lhs->getType()->isIntegerTy() && rhs->getType()->isIntegerTy())
-    {
-        /// if one integer has a sign bit, make sure the other does as well. llvm generates optimal code
-        /// (e.g. uses overflow flag on x86) for (word size + 1)-bit integer operations.
-
-        size_t lhs_bit_width = lhs->getType()->getIntegerBitWidth() + (!lhs_is_signed && rhs_is_signed);
-        size_t rhs_bit_width = rhs->getType()->getIntegerBitWidth() + (!rhs_is_signed && lhs_is_signed);
-
-        size_t max_bit_width = std::max(lhs_bit_width, rhs_bit_width);
-        common = b.getIntNTy(static_cast<unsigned>(max_bit_width));
-    }
-    else
-    {
-        /// TODO: Check
-        /// (double, float) or (double, int_N where N <= double's mantissa width) -> double
-        common = b.getDoubleTy();
-    }
-
-    auto * cast_lhs_to_common = nativeCast(b, lhs_type, lhs, common);
-    auto * cast_rhs_to_common = nativeCast(b, rhs_type, rhs, common);
-
-    return std::make_pair(cast_lhs_to_common, cast_rhs_to_common);
-}
-
-static inline llvm::Constant * getColumnNativeValue(llvm::IRBuilderBase & builder, const DataTypePtr & column_type, const IColumn & column, size_t index)
-{
-    if (const auto * constant = typeid_cast<const ColumnConst *>(&column))
-    {
-        return getColumnNativeValue(builder, column_type, constant->getDataColumn(), 0);
-    }
-
-    WhichDataType column_data_type(column_type);
-
-    auto * type = toNativeType(builder, column_type);
-
-    if (!type || column.size() <= index)
-        return nullptr;
-
-    if (column_data_type.isNullable())
-    {
-        const auto & nullable_data_type = assert_cast<const DataTypeNullable &>(*column_type);
-        const auto & nullable_column = assert_cast<const ColumnNullable &>(column);
-
-        auto * value = getColumnNativeValue(builder, nullable_data_type.getNestedType(), nullable_column.getNestedColumn(), index);
-        auto * is_null = llvm::ConstantInt::get(type->getContainedType(1), nullable_column.isNullAt(index));
-
-        return value ? llvm::ConstantStruct::get(static_cast<llvm::StructType *>(type), value, is_null) : nullptr;
-    }
-    else if (column_data_type.isFloat32())
-    {
-        return llvm::ConstantFP::get(type, assert_cast<const ColumnVector<Float32> &>(column).getElement(index));
-    }
-    else if (column_data_type.isFloat64())
-    {
-        return llvm::ConstantFP::get(type, assert_cast<const ColumnVector<Float64> &>(column).getElement(index));
-    }
-    else if (column_data_type.isNativeUInt() || column_data_type.isDate() || column_data_type.isDateTime())
-    {
-        return llvm::ConstantInt::get(type, column.getUInt(index));
-    }
-    else if (column_data_type.isNativeInt() || column_data_type.isEnum() || column_data_type.isDate32())
-    {
-        return llvm::ConstantInt::get(type, column.getInt(index));
-    }
-
-    return nullptr;
-}
+/// Get column value for specified index as LLVM constant
+llvm::Constant * getColumnNativeValue(llvm::IRBuilderBase & builder, const DataTypePtr & column_type, const IColumn & column, size_t index);
 
 }
 
diff --git a/src/Functions/FunctionBinaryArithmetic.h b/src/Functions/FunctionBinaryArithmetic.h
index b205822aab5..50d8abb9bcc 100644
--- a/src/Functions/FunctionBinaryArithmetic.h
+++ b/src/Functions/FunctionBinaryArithmetic.h
@@ -2046,51 +2046,62 @@ ColumnPtr executeStringInteger(const ColumnsWithTypeAndName & arguments, const A
     }
 
 #if USE_EMBEDDED_COMPILER
-    bool isCompilableImpl(const DataTypes & arguments) const override
+    bool isCompilableImpl(const DataTypes & arguments, const DataTypePtr & result_type) const override
     {
         if (2 != arguments.size())
             return false;
 
+        if (!canBeNativeType(*arguments[0]) || !canBeNativeType(*arguments[1]) || !canBeNativeType(*result_type))
+            return false;
+
         return castBothTypes(arguments[0].get(), arguments[1].get(), [&](const auto & left, const auto & right)
         {
             using LeftDataType = std::decay_t<decltype(left)>;
             using RightDataType = std::decay_t<decltype(right)>;
-            if constexpr (std::is_same_v<DataTypeFixedString, LeftDataType> || std::is_same_v<DataTypeFixedString, RightDataType> || std::is_same_v<DataTypeString, LeftDataType> || std::is_same_v<DataTypeString, RightDataType>)
-                return false;
-            else
+            if constexpr (!std::is_same_v<DataTypeFixedString, LeftDataType> &&
+                !std::is_same_v<DataTypeFixedString, RightDataType> &&
+                !std::is_same_v<DataTypeString, LeftDataType> &&
+                !std::is_same_v<DataTypeString, RightDataType>)
             {
                 using ResultDataType = typename BinaryOperationTraits<Op, LeftDataType, RightDataType>::ResultDataType;
                 using OpSpec = Op<typename LeftDataType::FieldType, typename RightDataType::FieldType>;
-                return !std::is_same_v<ResultDataType, InvalidType> && !IsDataTypeDecimal<ResultDataType> && OpSpec::compilable;
+                if constexpr (!std::is_same_v<ResultDataType, InvalidType> && !IsDataTypeDecimal<ResultDataType> && OpSpec::compilable)
+                    return true;
             }
+            return false;
         });
     }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const DataTypes & types, Values values) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const override
     {
-        assert(2 == types.size() && 2 == values.size());
+        assert(2 == arguments.size());
 
         llvm::Value * result = nullptr;
-        castBothTypes(types[0].get(), types[1].get(), [&](const auto & left, const auto & right)
+        castBothTypes(arguments[0].type.get(), arguments[1].type.get(), [&](const auto & left, const auto & right)
         {
             using LeftDataType = std::decay_t<decltype(left)>;
             using RightDataType = std::decay_t<decltype(right)>;
-            if constexpr (!std::is_same_v<DataTypeFixedString, LeftDataType> && !std::is_same_v<DataTypeFixedString, RightDataType> && !std::is_same_v<DataTypeString, LeftDataType> && !std::is_same_v<DataTypeString, RightDataType>)
+            if constexpr (!std::is_same_v<DataTypeFixedString, LeftDataType> &&
+                !std::is_same_v<DataTypeFixedString, RightDataType> &&
+                !std::is_same_v<DataTypeString, LeftDataType> &&
+                !std::is_same_v<DataTypeString, RightDataType>)
             {
                 using ResultDataType = typename BinaryOperationTraits<Op, LeftDataType, RightDataType>::ResultDataType;
                 using OpSpec = Op<typename LeftDataType::FieldType, typename RightDataType::FieldType>;
                 if constexpr (!std::is_same_v<ResultDataType, InvalidType> && !IsDataTypeDecimal<ResultDataType> && OpSpec::compilable)
                 {
                     auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-                    auto type = std::make_shared<ResultDataType>();
-                    auto * lval = nativeCast(b, types[0], values[0], type);
-                    auto * rval = nativeCast(b, types[1], values[1], type);
+                    auto * lval = nativeCast(b, arguments[0], result_type);
+                    auto * rval = nativeCast(b, arguments[1], result_type);
                     result = OpSpec::compile(b, lval, rval, std::is_signed_v<typename ResultDataType::FieldType>);
+
                     return true;
                 }
             }
+
             return false;
         });
+
         return result;
     }
 #endif
diff --git a/src/Functions/FunctionIfBase.h b/src/Functions/FunctionIfBase.h
index 4c9ecf78a12..2d5f42a53a0 100644
--- a/src/Functions/FunctionIfBase.h
+++ b/src/Functions/FunctionIfBase.h
@@ -2,6 +2,7 @@
 
 #include <Functions/IFunction.h>
 #include <DataTypes/Native.h>
+#include <DataTypes/DataTypeNullable.h>
 
 #include "config.h"
 
@@ -12,8 +13,11 @@ class FunctionIfBase : public IFunction
 {
 #if USE_EMBEDDED_COMPILER
 public:
-    bool isCompilableImpl(const DataTypes & types) const override
+    bool isCompilableImpl(const DataTypes & types, const DataTypePtr & result_type) const override
     {
+        if (!canBeNativeType(result_type))
+            return false;
+
         /// It's difficult to compare Date and DateTime - cannot use JIT compilation.
         bool has_date = false;
         bool has_datetime = false;
@@ -31,43 +35,43 @@ public:
             if (has_date && has_datetime)
                 return false;
 
-            if (!isCompilableType(type_removed_nullable))
+            if (!canBeNativeType(type_removed_nullable))
                 return false;
         }
+
         return true;
     }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const DataTypes & types, Values values) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const override
     {
         auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-        auto return_type = getReturnTypeImpl(types);
 
         auto * head = b.GetInsertBlock();
         auto * join = llvm::BasicBlock::Create(head->getContext(), "join_block", head->getParent());
 
         std::vector<std::pair<llvm::BasicBlock *, llvm::Value *>> returns;
-        for (size_t i = 0; i + 1 < types.size(); i += 2)
+        for (size_t i = 0; i + 1 < arguments.size(); i += 2)
         {
             auto * then = llvm::BasicBlock::Create(head->getContext(), "then_" + std::to_string(i), head->getParent());
             auto * next = llvm::BasicBlock::Create(head->getContext(), "next_" + std::to_string(i), head->getParent());
-            auto * cond = values[i];
+            const auto & cond = arguments[i];
 
-            b.CreateCondBr(nativeBoolCast(b, types[i], cond), then, next);
+            b.CreateCondBr(nativeBoolCast(b, cond), then, next);
             b.SetInsertPoint(then);
 
-            auto * value = nativeCast(b, types[i + 1], values[i + 1], return_type);
+            auto * value = nativeCast(b, arguments[i + 1], result_type);
             returns.emplace_back(b.GetInsertBlock(), value);
             b.CreateBr(join);
             b.SetInsertPoint(next);
         }
 
-        auto * else_value = nativeCast(b, types.back(), values.back(), return_type);
+        auto * else_value = nativeCast(b, arguments.back(), result_type);
         returns.emplace_back(b.GetInsertBlock(), else_value);
         b.CreateBr(join);
 
         b.SetInsertPoint(join);
 
-        auto * phi = b.CreatePHI(toNativeType(b, return_type), static_cast<unsigned>(returns.size()));
+        auto * phi = b.CreatePHI(toNativeType(b, result_type), static_cast<unsigned>(returns.size()));
         for (const auto & [block, value] : returns)
             phi->addIncoming(value, block);
 
diff --git a/src/Functions/FunctionUnaryArithmetic.h b/src/Functions/FunctionUnaryArithmetic.h
index 4098d58299c..259dc1c42ba 100644
--- a/src/Functions/FunctionUnaryArithmetic.h
+++ b/src/Functions/FunctionUnaryArithmetic.h
@@ -477,31 +477,45 @@ public:
     }
 
 #if USE_EMBEDDED_COMPILER
-    bool isCompilableImpl(const DataTypes & arguments) const override
+    bool isCompilableImpl(const DataTypes & arguments, const DataTypePtr & result_type) const override
     {
         if (1 != arguments.size())
             return false;
 
+        if (!canBeNativeType(*arguments[0]) || !canBeNativeType(*result_type))
+            return false;
+
         return castType(arguments[0].get(), [&](const auto & type)
         {
             using DataType = std::decay_t<decltype(type)>;
             if constexpr (std::is_same_v<DataTypeFixedString, DataType> || std::is_same_v<DataTypeString, DataType>)
+            {
                 return false;
+            }
             else
-                return !IsDataTypeDecimal<DataType> && Op<typename DataType::FieldType>::compilable;
+            {
+                using T0 = typename DataType::FieldType;
+                using T1 = typename Op<T0>::ResultType;
+                if constexpr (!std::is_same_v<T1, InvalidType> && !IsDataTypeDecimal<DataType> && Op<T0>::compilable)
+                    return true;
+            }
+
+            return false;
         });
     }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const DataTypes & types, Values values) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const override
     {
-        assert(1 == types.size() && 1 == values.size());
+        assert(1 == arguments.size());
 
         llvm::Value * result = nullptr;
-        castType(types[0].get(), [&](const auto & type)
+        castType(arguments[0].type.get(), [&](const auto & type)
         {
             using DataType = std::decay_t<decltype(type)>;
             if constexpr (std::is_same_v<DataTypeFixedString, DataType> || std::is_same_v<DataTypeString, DataType>)
+            {
                 return false;
+            }
             else
             {
                 using T0 = typename DataType::FieldType;
@@ -509,13 +523,16 @@ public:
                 if constexpr (!std::is_same_v<T1, InvalidType> && !IsDataTypeDecimal<DataType> && Op<T0>::compilable)
                 {
                     auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-                    auto * v = nativeCast(b, types[0], values[0], std::make_shared<DataTypeNumber<T1>>());
+                    auto * v = nativeCast(b, arguments[0], result_type);
                     result = Op<T0>::compile(b, v, is_signed_v<T1>);
+
                     return true;
                 }
             }
+
             return false;
         });
+
         return result;
     }
 #endif
diff --git a/src/Functions/FunctionsComparison.h b/src/Functions/FunctionsComparison.h
index 08bc350c1d4..e3a903008f0 100644
--- a/src/Functions/FunctionsComparison.h
+++ b/src/Functions/FunctionsComparison.h
@@ -1384,13 +1384,13 @@ public:
     }
 
 #if USE_EMBEDDED_COMPILER
-    bool isCompilableImpl(const DataTypes & types) const override
+    bool isCompilableImpl(const DataTypes & arguments, const DataTypePtr & result_type) const override
     {
-        if (2 != types.size())
+        if (2 != arguments.size())
             return false;
 
-        WhichDataType data_type_lhs(types[0]);
-        WhichDataType data_type_rhs(types[1]);
+        WhichDataType data_type_lhs(arguments[0]);
+        WhichDataType data_type_rhs(arguments[1]);
 
         auto is_big_integer = [](WhichDataType type) { return type.isUInt64() || type.isInt64(); };
 
@@ -1400,16 +1400,18 @@ public:
             || (data_type_rhs.isDate() && data_type_lhs.isDateTime()))
             return false; /// TODO: implement (double, int_N where N > double's mantissa width)
 
-        return isCompilableType(types[0]) && isCompilableType(types[1]);
+        return canBeNativeType(arguments[0]) && canBeNativeType(arguments[1]) && canBeNativeType(result_type);
     }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const DataTypes & types, Values values) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const override
     {
-        assert(2 == types.size() && 2 == values.size());
+        assert(2 == arguments.size());
 
         auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-        auto [x, y] = nativeCastToCommon(b, types[0], values[0], types[1], values[1]);
-        auto * result = CompileOp<Op>::compile(b, x, y, typeIsSigned(*types[0]) || typeIsSigned(*types[1]));
+        auto * x = nativeCast(b, arguments[0], result_type);
+        auto * y = nativeCast(b, arguments[1], result_type);
+        auto * result = CompileOp<Op>::compile(b, x, y, typeIsSigned(*arguments[0].type) || typeIsSigned(*arguments[1].type));
+
         return b.CreateSelect(result, b.getInt8(1), b.getInt8(0));
     }
 #endif
diff --git a/src/Functions/FunctionsLogical.h b/src/Functions/FunctionsLogical.h
index b2a59c51123..a25bffcdd73 100644
--- a/src/Functions/FunctionsLogical.h
+++ b/src/Functions/FunctionsLogical.h
@@ -184,41 +184,46 @@ public:
     ColumnPtr getConstantResultForNonConstArguments(const ColumnsWithTypeAndName & arguments, const DataTypePtr & result_type) const override;
 
 #if USE_EMBEDDED_COMPILER
-    bool isCompilableImpl(const DataTypes &) const override { return useDefaultImplementationForNulls(); }
+    bool isCompilableImpl(const DataTypes &, const DataTypePtr &) const override { return useDefaultImplementationForNulls(); }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const DataTypes & types, Values values) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & values, const DataTypePtr &) const override
     {
-        assert(!types.empty() && !values.empty());
+        assert(!values.empty());
 
         auto & b = static_cast<llvm::IRBuilder<> &>(builder);
         if constexpr (!Impl::isSaturable())
         {
-            auto * result = nativeBoolCast(b, types[0], values[0]);
-            for (size_t i = 1; i < types.size(); ++i)
-                result = Impl::apply(b, result, nativeBoolCast(b, types[i], values[i]));
+            auto * result = nativeBoolCast(b, values[0]);
+            for (size_t i = 1; i < values.size(); ++i)
+                result = Impl::apply(b, result, nativeBoolCast(b, values[i]));
             return b.CreateSelect(result, b.getInt8(1), b.getInt8(0));
         }
+
         constexpr bool break_on_true = Impl::isSaturatedValue(true);
         auto * next = b.GetInsertBlock();
         auto * stop = llvm::BasicBlock::Create(next->getContext(), "", next->getParent());
         b.SetInsertPoint(stop);
+
         auto * phi = b.CreatePHI(b.getInt8Ty(), static_cast<unsigned>(values.size()));
-        for (size_t i = 0; i < types.size(); ++i)
+
+        for (size_t i = 0; i < values.size(); ++i)
         {
             b.SetInsertPoint(next);
-            auto * value = values[i];
-            auto * truth = nativeBoolCast(b, types[i], value);
-            if (!types[i]->equals(DataTypeUInt8{}))
+            auto * value = values[i].value;
+            auto * truth = nativeBoolCast(b, values[i]);
+            if (!values[i].type->equals(DataTypeUInt8{}))
                 value = b.CreateSelect(truth, b.getInt8(1), b.getInt8(0));
             phi->addIncoming(value, b.GetInsertBlock());
-            if (i + 1 < types.size())
+            if (i + 1 < values.size())
             {
                 next = llvm::BasicBlock::Create(next->getContext(), "", next->getParent());
                 b.CreateCondBr(truth, break_on_true ? stop : next, break_on_true ? next : stop);
             }
         }
+
         b.CreateBr(stop);
         b.SetInsertPoint(stop);
+
         return phi;
     }
 #endif
@@ -248,12 +253,12 @@ public:
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t /*input_rows_count*/) const override;
 
 #if USE_EMBEDDED_COMPILER
-    bool isCompilableImpl(const DataTypes &) const override { return true; }
+    bool isCompilableImpl(const DataTypes &, const DataTypePtr &) const override { return true; }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const DataTypes & types, Values values) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & values, const DataTypePtr &) const override
     {
         auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-        return b.CreateSelect(Impl<UInt8>::apply(b, nativeBoolCast(b, types[0], values[0])), b.getInt8(1), b.getInt8(0));
+        return b.CreateSelect(Impl<UInt8>::apply(b, nativeBoolCast(b, values[0])), b.getInt8(1), b.getInt8(0));
     }
 #endif
 };
diff --git a/src/Functions/IFunction.cpp b/src/Functions/IFunction.cpp
index 7563135f21f..4537dacaa39 100644
--- a/src/Functions/IFunction.cpp
+++ b/src/Functions/IFunction.cpp
@@ -484,59 +484,75 @@ DataTypePtr IFunctionOverloadResolver::getReturnTypeWithoutLowCardinality(const
 
 static std::optional<DataTypes> removeNullables(const DataTypes & types)
 {
+    bool has_nullable = false;
     for (const auto & type : types)
     {
         if (!typeid_cast<const DataTypeNullable *>(type.get()))
             continue;
+
+        has_nullable = true;
+        break;
+    }
+
+    if (has_nullable)
+    {
         DataTypes filtered;
+        filtered.reserve(types.size());
+
         for (const auto & sub_type : types)
             filtered.emplace_back(removeNullable(sub_type));
+
         return filtered;
     }
+
     return {};
 }
 
-bool IFunction::isCompilable(const DataTypes & arguments) const
+bool IFunction::isCompilable(const DataTypes & arguments, const DataTypePtr & result_type) const
 {
-
     if (useDefaultImplementationForNulls())
-        if (auto denulled = removeNullables(arguments))
-            return isCompilableImpl(*denulled);
-    return isCompilableImpl(arguments);
+        if (auto denulled_arguments = removeNullables(arguments))
+            return isCompilableImpl(*denulled_arguments, result_type);
+
+    return isCompilableImpl(arguments, result_type);
 }
 
-llvm::Value * IFunction::compile(llvm::IRBuilderBase & builder, const DataTypes & arguments, Values values) const
+llvm::Value * IFunction::compile(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const
 {
-    auto denulled_arguments = removeNullables(arguments);
-    if (useDefaultImplementationForNulls() && denulled_arguments)
+    DataTypes arguments_types;
+    arguments_types.reserve(arguments.size());
+
+    for (const auto & argument : arguments) {
+        arguments_types.push_back(argument.type);
+    }
+
+    auto denulled_arguments_types = removeNullables(arguments_types);
+    if (useDefaultImplementationForNulls() && denulled_arguments_types)
     {
         auto & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-        std::vector<llvm::Value*> unwrapped_values;
-        std::vector<llvm::Value*> is_null_values;
+        ValuesWithType unwrapped_arguments;
+        unwrapped_arguments.reserve(arguments.size());
 
-        unwrapped_values.reserve(arguments.size());
-        is_null_values.reserve(arguments.size());
+        std::vector<llvm::Value*> is_null_values;
 
         for (size_t i = 0; i < arguments.size(); ++i)
         {
-            auto * value = values[i];
+            const auto & argument = arguments[i];
+            llvm::Value * unwrapped_value = argument.value;
 
-            WhichDataType data_type(arguments[i]);
-            if (data_type.isNullable())
+            if (argument.type->isNullable())
             {
-                unwrapped_values.emplace_back(b.CreateExtractValue(value, {0}));
-                is_null_values.emplace_back(b.CreateExtractValue(value, {1}));
-            }
-            else
-            {
-                unwrapped_values.emplace_back(value);
+                unwrapped_value = b.CreateExtractValue(argument.value, {0});
+                is_null_values.emplace_back(b.CreateExtractValue(argument.value, {1}));
             }
+
+            unwrapped_arguments.emplace_back(unwrapped_value, (*denulled_arguments_types)[i]);
         }
 
-        auto * result = compileImpl(builder, *denulled_arguments, unwrapped_values);
+        auto * result = compileImpl(builder, unwrapped_arguments, removeNullable(result_type));
 
-        auto * nullable_structure_type = toNativeType(b, makeNullable(getReturnTypeImpl(*denulled_arguments)));
+        auto * nullable_structure_type = toNativeType(b, makeNullable(getReturnTypeImpl(*denulled_arguments_types)));
         auto * nullable_structure_value = llvm::Constant::getNullValue(nullable_structure_type);
 
         auto * nullable_structure_with_result_value = b.CreateInsertValue(nullable_structure_value, result, {0});
@@ -548,7 +564,7 @@ llvm::Value * IFunction::compile(llvm::IRBuilderBase & builder, const DataTypes
         return b.CreateInsertValue(nullable_structure_with_result_value, nullable_structure_result_null, {1});
     }
 
-    return compileImpl(builder, arguments, std::move(values));
+    return compileImpl(builder, arguments, result_type);
 }
 
 #endif
diff --git a/src/Functions/IFunction.h b/src/Functions/IFunction.h
index cf2dcc9617e..433cb61d04e 100644
--- a/src/Functions/IFunction.h
+++ b/src/Functions/IFunction.h
@@ -3,6 +3,7 @@
 #include <Core/ColumnNumbers.h>
 #include <Core/ColumnsWithTypeAndName.h>
 #include <Core/Field.h>
+#include <Core/ValuesWithType.h>
 #include <Core/Names.h>
 #include <Core/IResolvedFunction.h>
 #include <Common/Exception.h>
@@ -121,8 +122,6 @@ private:
 
 using ExecutableFunctionPtr = std::shared_ptr<IExecutableFunction>;
 
-using Values = std::vector<llvm::Value *>;
-
 /** Function with known arguments and return type (when the specific overload was chosen).
   * It is also the point where all function-specific properties are known.
   */
@@ -162,7 +161,7 @@ public:
       *       templates with default arguments is impossible and including LLVM in such a generic header
       *       as this one is a major pain.
       */
-    virtual llvm::Value * compile(llvm::IRBuilderBase & /*builder*/, Values /*values*/) const
+    virtual llvm::Value * compile(llvm::IRBuilderBase & /*builder*/, const ValuesWithType & /*arguments*/) const
     {
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "{} is not JIT-compilable", getName());
     }
@@ -530,9 +529,9 @@ public:
 
 #if USE_EMBEDDED_COMPILER
 
-    bool isCompilable(const DataTypes & arguments) const;
+    bool isCompilable(const DataTypes & arguments, const DataTypePtr & result_type) const;
 
-    llvm::Value * compile(llvm::IRBuilderBase &, const DataTypes & arguments, Values values) const;
+    llvm::Value * compile(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const;
 
 #endif
 
@@ -540,9 +539,9 @@ protected:
 
 #if USE_EMBEDDED_COMPILER
 
-    virtual bool isCompilableImpl(const DataTypes &) const { return false; }
+    virtual bool isCompilableImpl(const DataTypes & /*arguments*/, const DataTypePtr & /*result_type*/) const { return false; }
 
-    virtual llvm::Value * compileImpl(llvm::IRBuilderBase &, const DataTypes &, Values) const
+    virtual llvm::Value * compileImpl(llvm::IRBuilderBase & /*builder*/, const ValuesWithType & /*arguments*/, const DataTypePtr & /*result_type*/) const
     {
         throw Exception(ErrorCodes::NOT_IMPLEMENTED, "{} is not JIT-compilable", getName());
     }
diff --git a/src/Functions/IFunctionAdaptors.h b/src/Functions/IFunctionAdaptors.h
index 4ecb45167cc..123fdbc2f50 100644
--- a/src/Functions/IFunctionAdaptors.h
+++ b/src/Functions/IFunctionAdaptors.h
@@ -55,11 +55,11 @@ public:
 
 #if USE_EMBEDDED_COMPILER
 
-    bool isCompilable() const override { return function->isCompilable(getArgumentTypes()); }
+    bool isCompilable() const override { return function->isCompilable(getArgumentTypes(), getResultType()); }
 
-    llvm::Value * compile(llvm::IRBuilderBase & builder, Values values) const override
+    llvm::Value * compile(llvm::IRBuilderBase & builder, const ValuesWithType & compile_arguments) const override
     {
-        return function->compile(builder, getArgumentTypes(), std::move(values));
+        return function->compile(builder, compile_arguments, getResultType());
     }
 
 #endif
diff --git a/src/Interpreters/ExpressionJIT.cpp b/src/Interpreters/ExpressionJIT.cpp
index dfc88e97052..0eacb598fbe 100644
--- a/src/Interpreters/ExpressionJIT.cpp
+++ b/src/Interpreters/ExpressionJIT.cpp
@@ -160,9 +160,9 @@ public:
 
     bool isCompilable() const override { return true; }
 
-    llvm::Value * compile(llvm::IRBuilderBase & builder, Values values) const override
+    llvm::Value * compile(llvm::IRBuilderBase & builder, const ValuesWithType & arguments) const override
     {
-        return dag.compile(builder, values);
+        return dag.compile(builder, arguments).value;
     }
 
     bool isSuitableForShortCircuitArgumentsExecution(const DataTypesWithConstInfo & arguments) const override
diff --git a/src/Interpreters/JIT/CHJIT.h b/src/Interpreters/JIT/CHJIT.h
index cde1129c010..fc883802426 100644
--- a/src/Interpreters/JIT/CHJIT.h
+++ b/src/Interpreters/JIT/CHJIT.h
@@ -19,14 +19,14 @@ class JITModuleMemoryManager;
 class JITSymbolResolver;
 class JITCompiler;
 
-/** Custom jit implementation
+/** Custom JIT implementation.
   * Main use cases:
   * 1. Compiled functions in module.
   * 2. Release memory for compiled functions.
   *
   * In LLVM library there are 2 main JIT stacks MCJIT and ORCv2.
   *
-  * Main reasons for custom implementation vs MCJIT
+  * Main reasons for custom implementation vs MCJIT.
   * MCJIT keeps llvm::Module and compiled object code before linking process after module was compiled.
   * llvm::Module can be removed, but compiled object code cannot be removed. Memory for compiled code
   * will be release only during MCJIT instance destruction. It is too expensive to create MCJIT
diff --git a/src/Interpreters/JIT/CompileDAG.cpp b/src/Interpreters/JIT/CompileDAG.cpp
index 2c5c7731150..972cea7bbf8 100644
--- a/src/Interpreters/JIT/CompileDAG.cpp
+++ b/src/Interpreters/JIT/CompileDAG.cpp
@@ -21,14 +21,14 @@ namespace ErrorCodes
     extern const int LOGICAL_ERROR;
 }
 
-llvm::Value * CompileDAG::compile(llvm::IRBuilderBase & builder, Values input_nodes_values) const
+ValueWithType CompileDAG::compile(llvm::IRBuilderBase & builder, const ValuesWithType & input_nodes_values) const
 {
     assert(input_nodes_values.size() == getInputNodesCount());
 
     llvm::IRBuilder<> & b = static_cast<llvm::IRBuilder<> &>(builder);
 
-    PaddedPODArray<llvm::Value *> compiled_values;
-    compiled_values.resize_fill(nodes.size());
+    ValuesWithType compiled_values;
+    compiled_values.resize(nodes.size());
 
     size_t input_nodes_values_index = 0;
     size_t compiled_values_index = 0;
@@ -44,31 +44,26 @@ llvm::Value * CompileDAG::compile(llvm::IRBuilderBase & builder, Values input_no
             case CompileType::CONSTANT:
             {
                 auto * native_value = getColumnNativeValue(b, node.result_type, *node.column, 0);
-                if (!native_value)
-                    throw Exception(ErrorCodes::LOGICAL_ERROR,
-                    "Cannot find native value for constant column with type {}",
-                    node.result_type->getName());
-
-                compiled_values[compiled_values_index] = native_value;
+                compiled_values[compiled_values_index] = {native_value, node.result_type};
                 break;
             }
             case CompileType::FUNCTION:
             {
-                Values temporary_values;
+                ValuesWithType temporary_values;
                 temporary_values.reserve(node.arguments.size());
 
                 for (auto argument_index : node.arguments)
                 {
-                    assert(compiled_values[argument_index] != nullptr);
+                    assert(compiled_values[argument_index].value != nullptr);
                     temporary_values.emplace_back(compiled_values[argument_index]);
                 }
 
-                compiled_values[compiled_values_index] = node.function->compile(builder, temporary_values);
+                compiled_values[compiled_values_index] = {node.function->compile(builder, temporary_values), node.result_type};
                 break;
             }
             case CompileType::INPUT:
             {
-                compiled_values[compiled_values_index] = input_nodes_values[input_nodes_values_index];
+                compiled_values[compiled_values_index] = {input_nodes_values[input_nodes_values_index].value, node.result_type};
                 ++input_nodes_values_index;
                 break;
             }
diff --git a/src/Interpreters/JIT/CompileDAG.h b/src/Interpreters/JIT/CompileDAG.h
index a05fa629561..77a02230f55 100644
--- a/src/Interpreters/JIT/CompileDAG.h
+++ b/src/Interpreters/JIT/CompileDAG.h
@@ -53,7 +53,7 @@ public:
         std::vector<size_t> arguments;
     };
 
-    llvm::Value * compile(llvm::IRBuilderBase & builder, Values input_nodes_values) const;
+    ValueWithType compile(llvm::IRBuilderBase & builder, const ValuesWithType & input_nodes_values_with_type) const;
 
     std::string dump() const;
 
diff --git a/src/Interpreters/JIT/compileFunction.cpp b/src/Interpreters/JIT/compileFunction.cpp
index a7233433861..a5a646879bb 100644
--- a/src/Interpreters/JIT/compileFunction.cpp
+++ b/src/Interpreters/JIT/compileFunction.cpp
@@ -9,6 +9,8 @@
 #include <Common/Stopwatch.h>
 #include <Common/ProfileEvents.h>
 #include <DataTypes/Native.h>
+#include <DataTypes/DataTypeNullable.h>
+#include <Columns/ColumnNullable.h>
 #include <Interpreters/JIT/CHJIT.h>
 
 namespace
@@ -107,7 +109,7 @@ static void compileFunction(llvm::Module & module, const IFunctionBase & functio
 
     /// Initialize column row values
 
-    Values arguments;
+    ValuesWithType arguments;
     arguments.reserve(function_argument_types.size());
 
     for (size_t i = 0; i < function_argument_types.size(); ++i)
@@ -120,7 +122,7 @@ static void compileFunction(llvm::Module & module, const IFunctionBase & functio
 
         if (!type->isNullable())
         {
-            arguments.emplace_back(column_element_value);
+            arguments.emplace_back(column_element_value, type);
             continue;
         }
 
@@ -128,12 +130,12 @@ static void compileFunction(llvm::Module & module, const IFunctionBase & functio
         auto * is_null = b.CreateICmpNE(column_is_null_element_value, b.getInt8(0));
         auto * nullable_unitialized = llvm::Constant::getNullValue(toNullableType(b, column.data_element_type));
         auto * nullable_value = b.CreateInsertValue(b.CreateInsertValue(nullable_unitialized, column_element_value, {0}), is_null, {1});
-        arguments.emplace_back(nullable_value);
+        arguments.emplace_back(nullable_value, type);
     }
 
     /// Compile values for column rows and store compiled value in result column
 
-    auto * result = function.compile(b, std::move(arguments));
+    auto * result = function.compile(b, arguments);
     auto * result_column_element_ptr = b.CreateGEP(columns.back().data_element_type, columns.back().data_ptr, counter_phi);
 
     if (columns.back().null_data_ptr)
@@ -298,24 +300,24 @@ static void compileAddIntoAggregateStatesFunctions(llvm::Module & module,
     else
         aggregation_place = places_arg;
 
-    std::vector<llvm::Value *> function_arguments_values;
+    ValuesWithType function_arguments;
     previous_columns_size = 0;
 
     for (const auto & function : functions)
     {
-        auto arguments_types = function.function->getArgumentTypes();
+        const auto & arguments_types = function.function->getArgumentTypes();
         size_t function_arguments_size = arguments_types.size();
 
         for (size_t column_argument_index = 0; column_argument_index < function_arguments_size; ++column_argument_index)
         {
             auto & column = columns[previous_columns_size + column_argument_index];
-            auto & argument_type = arguments_types[column_argument_index];
+            const auto & argument_type = arguments_types[column_argument_index];
 
             auto * column_data_element = b.CreateLoad(column.data_element_type, b.CreateGEP(column.data_element_type, column.data_ptr, counter_phi));
 
             if (!argument_type->isNullable())
             {
-                function_arguments_values.push_back(column_data_element);
+                function_arguments.emplace_back(column_data_element, argument_type);
                 continue;
             }
 
@@ -324,16 +326,16 @@ static void compileAddIntoAggregateStatesFunctions(llvm::Module & module,
             auto * nullable_unitialized = llvm::Constant::getNullValue(toNullableType(b, column.data_element_type));
             auto * first_insert = b.CreateInsertValue(nullable_unitialized, column_data_element, {0});
             auto * nullable_value = b.CreateInsertValue(first_insert, is_null, {1});
-            function_arguments_values.push_back(nullable_value);
+            function_arguments.emplace_back(nullable_value, argument_type);
         }
 
         size_t aggregate_function_offset = function.aggregate_data_offset;
         auto * aggregation_place_with_offset = b.CreateConstInBoundsGEP1_64(b.getInt8Ty(), aggregation_place, aggregate_function_offset);
 
         const auto * aggregate_function_ptr = function.function;
-        aggregate_function_ptr->compileAdd(b, aggregation_place_with_offset, arguments_types, function_arguments_values);
+        aggregate_function_ptr->compileAdd(b, aggregation_place_with_offset, function_arguments);
 
-        function_arguments_values.clear();
+        function_arguments.clear();
 
         previous_columns_size += function_arguments_size;
     }

From fcc149a9cdfc3887d3be0bb5efd65517196f9801 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sat, 3 Jun 2023 21:31:26 +0300
Subject: [PATCH 592/722] Added tests

---
 ...1_jit_functions_comparison_crash.reference |  0
 .../02771_jit_functions_comparison_crash.sql  | 36 +++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 tests/queries/0_stateless/02771_jit_functions_comparison_crash.reference
 create mode 100644 tests/queries/0_stateless/02771_jit_functions_comparison_crash.sql

diff --git a/tests/queries/0_stateless/02771_jit_functions_comparison_crash.reference b/tests/queries/0_stateless/02771_jit_functions_comparison_crash.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02771_jit_functions_comparison_crash.sql b/tests/queries/0_stateless/02771_jit_functions_comparison_crash.sql
new file mode 100644
index 00000000000..e02f1a3382d
--- /dev/null
+++ b/tests/queries/0_stateless/02771_jit_functions_comparison_crash.sql
@@ -0,0 +1,36 @@
+SET compile_expressions = 1;
+SET min_count_to_compile_expression = 0;
+
+DROP TABLE IF EXISTS test_table_1;
+CREATE TABLE test_table_1
+(
+    pkey UInt32,
+    c8 UInt32,
+    c9 String,
+    c10 Float32,
+    c11 String
+) ENGINE = MergeTree ORDER BY pkey;
+
+DROP TABLE IF EXISTS test_table_2;
+CREATE TABLE test_table_2
+(
+    vkey UInt32,
+    pkey UInt32,
+    c15 UInt32
+) ENGINE = MergeTree ORDER BY vkey;
+
+WITH test_cte AS
+(
+    SELECT
+        ref_10.c11 as c_2_c2350_1,
+        ref_9.c9 as c_2_c2351_2
+    FROM
+        test_table_1 as ref_9
+        RIGHT OUTER JOIN test_table_1 as ref_10 ON (ref_9.c11 = ref_10.c9)
+        INNER JOIN test_table_2 as ref_11 ON (ref_10.c8 = ref_11.vkey)
+    WHERE ((ref_10.pkey + ref_11.pkey) BETWEEN ref_11.vkey AND (CASE WHEN (-30.87 >= ref_9.c10) THEN ref_11.c15 ELSE ref_11.pkey END))
+)
+SELECT ref_13.c_2_c2350_1 as c_2_c2357_3 FROM test_cte as ref_13 WHERE (ref_13.c_2_c2351_2) in (select ref_14.c_2_c2351_2 as c_5_c2352_0 FROM test_cte as ref_14);
+
+DROP TABLE test_table_1;
+DROP TABLE test_table_2;

From 6e26fde707ff68a864d9799ea8af2b9ef9a049ab Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Sun, 4 Jun 2023 15:01:48 +0300
Subject: [PATCH 593/722] Updated tests

---
 src/DataTypes/Native.cpp                                    | 1 +
 src/Functions/FunctionBinaryArithmetic.h                    | 6 ++++++
 src/Functions/IFunction.cpp                                 | 3 +--
 src/Interpreters/JIT/CompileDAG.cpp                         | 5 -----
 tests/queries/0_stateless/02772_jit_date_time_add.reference | 1 +
 tests/queries/0_stateless/02772_jit_date_time_add.sql       | 6 ++++++
 6 files changed, 15 insertions(+), 7 deletions(-)
 create mode 100644 tests/queries/0_stateless/02772_jit_date_time_add.reference
 create mode 100644 tests/queries/0_stateless/02772_jit_date_time_add.sql

diff --git a/src/DataTypes/Native.cpp b/src/DataTypes/Native.cpp
index acbd70ba04f..6f1ea851dce 100644
--- a/src/DataTypes/Native.cpp
+++ b/src/DataTypes/Native.cpp
@@ -12,6 +12,7 @@ namespace DB
 namespace ErrorCodes
 {
     extern const int NOT_IMPLEMENTED;
+    extern const int LOGICAL_ERROR;
 }
 
 bool typeIsSigned(const IDataType & type)
diff --git a/src/Functions/FunctionBinaryArithmetic.h b/src/Functions/FunctionBinaryArithmetic.h
index 50d8abb9bcc..c699da4eaf6 100644
--- a/src/Functions/FunctionBinaryArithmetic.h
+++ b/src/Functions/FunctionBinaryArithmetic.h
@@ -2054,6 +2054,12 @@ ColumnPtr executeStringInteger(const ColumnsWithTypeAndName & arguments, const A
         if (!canBeNativeType(*arguments[0]) || !canBeNativeType(*arguments[1]) || !canBeNativeType(*result_type))
             return false;
 
+        WhichDataType data_type_lhs(arguments[0]);
+        WhichDataType data_type_rhs(arguments[1]);
+        if ((data_type_lhs.isDateOrDate32() || data_type_lhs.isDateTime()) ||
+            (data_type_rhs.isDateOrDate32() || data_type_rhs.isDateTime()))
+            return false;
+
         return castBothTypes(arguments[0].get(), arguments[1].get(), [&](const auto & left, const auto & right)
         {
             using LeftDataType = std::decay_t<decltype(left)>;
diff --git a/src/Functions/IFunction.cpp b/src/Functions/IFunction.cpp
index 4537dacaa39..650b54d9a37 100644
--- a/src/Functions/IFunction.cpp
+++ b/src/Functions/IFunction.cpp
@@ -522,9 +522,8 @@ llvm::Value * IFunction::compile(llvm::IRBuilderBase & builder, const ValuesWith
     DataTypes arguments_types;
     arguments_types.reserve(arguments.size());
 
-    for (const auto & argument : arguments) {
+    for (const auto & argument : arguments)
         arguments_types.push_back(argument.type);
-    }
 
     auto denulled_arguments_types = removeNullables(arguments_types);
     if (useDefaultImplementationForNulls() && denulled_arguments_types)
diff --git a/src/Interpreters/JIT/CompileDAG.cpp b/src/Interpreters/JIT/CompileDAG.cpp
index 972cea7bbf8..6da17fb4c67 100644
--- a/src/Interpreters/JIT/CompileDAG.cpp
+++ b/src/Interpreters/JIT/CompileDAG.cpp
@@ -16,11 +16,6 @@
 namespace DB
 {
 
-namespace ErrorCodes
-{
-    extern const int LOGICAL_ERROR;
-}
-
 ValueWithType CompileDAG::compile(llvm::IRBuilderBase & builder, const ValuesWithType & input_nodes_values) const
 {
     assert(input_nodes_values.size() == getInputNodesCount());
diff --git a/tests/queries/0_stateless/02772_jit_date_time_add.reference b/tests/queries/0_stateless/02772_jit_date_time_add.reference
new file mode 100644
index 00000000000..dec7d2fabd2
--- /dev/null
+++ b/tests/queries/0_stateless/02772_jit_date_time_add.reference
@@ -0,0 +1 @@
+\N
diff --git a/tests/queries/0_stateless/02772_jit_date_time_add.sql b/tests/queries/0_stateless/02772_jit_date_time_add.sql
new file mode 100644
index 00000000000..61028ac4172
--- /dev/null
+++ b/tests/queries/0_stateless/02772_jit_date_time_add.sql
@@ -0,0 +1,6 @@
+SET compile_expressions = 1;
+SET min_count_to_compile_expression = 0;
+
+SELECT DISTINCT result FROM (SELECT toStartOfFifteenMinutes(toDateTime(toStartOfFifteenMinutes(toDateTime(1000.0001220703125) + (number * 65536))) + (number * 9223372036854775807)) AS result FROM system.numbers LIMIT 1048576) ORDER BY result DESC NULLS FIRST FORMAT Null; -- { serverError 407 }
+SELECT DISTINCT result FROM (SELECT toStartOfFifteenMinutes(toDateTime(toStartOfFifteenMinutes(toDateTime(1000.0001220703125) + (number * 65536))) + toInt64(number * 9223372036854775807)) AS result FROM system.numbers LIMIT 1048576) ORDER BY result DESC NULLS FIRST FORMAT Null;
+SELECT round(round(round(round(round(100)), round(round(round(round(NULL), round(65535)), toTypeName(now() + 9223372036854775807) LIKE 'DateTime%DateTime%DateTime%DateTime%', round(-2)), 255), round(NULL))));

From aa28a1f25915fb7225f6a596a83a4dfa9f8a5f6b Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Tue, 13 Jun 2023 11:44:15 +0300
Subject: [PATCH 594/722] Fixed tests

---
 src/Functions/FunctionsComparison.h | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/Functions/FunctionsComparison.h b/src/Functions/FunctionsComparison.h
index e3a903008f0..767bdf2c823 100644
--- a/src/Functions/FunctionsComparison.h
+++ b/src/Functions/FunctionsComparison.h
@@ -1400,16 +1400,20 @@ public:
             || (data_type_rhs.isDate() && data_type_lhs.isDateTime()))
             return false; /// TODO: implement (double, int_N where N > double's mantissa width)
 
-        return canBeNativeType(arguments[0]) && canBeNativeType(arguments[1]) && canBeNativeType(result_type);
+        DataTypePtr common_type = getLeastSupertype(arguments);
+        return canBeNativeType(arguments[0]) && canBeNativeType(arguments[1]) && canBeNativeType(result_type) && canBeNativeType(common_type);
     }
 
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr & result_type) const override
+    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr &) const override
     {
         assert(2 == arguments.size());
 
+        DataTypePtr common_type = getLeastSupertype(DataTypes{arguments[0].type, arguments[1].type});
+
         auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-        auto * x = nativeCast(b, arguments[0], result_type);
-        auto * y = nativeCast(b, arguments[1], result_type);
+        auto * x = nativeCast(b, arguments[0], common_type);
+        auto * y = nativeCast(b, arguments[1], common_type);
+
         auto * result = CompileOp<Op>::compile(b, x, y, typeIsSigned(*arguments[0].type) || typeIsSigned(*arguments[1].type));
 
         return b.CreateSelect(result, b.getInt8(1), b.getInt8(0));

From 7e5017dd31a4146863413b457de0e7af296525c4 Mon Sep 17 00:00:00 2001
From: Maksim Kita <kitaetoya@gmail.com>
Date: Tue, 20 Jun 2023 11:39:21 +0300
Subject: [PATCH 595/722] Fixed tests

---
 base/base/find_symbols.h                      |  1 +
 programs/copier/ShardPartitionPiece.h         |  2 +
 src/Access/Common/AccessFlags.h               |  1 +
 .../assertProcessUserMatchesDataOwner.h       |  2 +
 src/Core/QualifiedTableName.h                 |  2 +-
 src/Functions/FunctionsComparison.h           | 37 -------------------
 src/Interpreters/JIT/compileFunction.cpp      |  8 ++--
 .../ParallelReplicasReadingCoordinator.cpp    |  2 +-
 src/Storages/MergeTree/RangesInDataPart.cpp   |  2 +-
 9 files changed, 13 insertions(+), 44 deletions(-)

diff --git a/base/base/find_symbols.h b/base/base/find_symbols.h
index a8747ecc9b7..83232669c04 100644
--- a/base/base/find_symbols.h
+++ b/base/base/find_symbols.h
@@ -2,6 +2,7 @@
 
 #include <cstdint>
 #include <string>
+#include <array>
 
 #if defined(__SSE2__)
     #include <emmintrin.h>
diff --git a/programs/copier/ShardPartitionPiece.h b/programs/copier/ShardPartitionPiece.h
index aba378d466d..453364c0fc8 100644
--- a/programs/copier/ShardPartitionPiece.h
+++ b/programs/copier/ShardPartitionPiece.h
@@ -2,6 +2,8 @@
 
 #include <base/types.h>
 
+#include <vector>
+
 namespace DB
 {
 
diff --git a/src/Access/Common/AccessFlags.h b/src/Access/Common/AccessFlags.h
index 270ee1c0045..c9672da7d92 100644
--- a/src/Access/Common/AccessFlags.h
+++ b/src/Access/Common/AccessFlags.h
@@ -4,6 +4,7 @@
 #include <bitset>
 #include <cstring>
 #include <vector>
+#include <unordered_map>
 
 
 namespace DB
diff --git a/src/Common/assertProcessUserMatchesDataOwner.h b/src/Common/assertProcessUserMatchesDataOwner.h
index b31d795da71..7a6c5d36335 100644
--- a/src/Common/assertProcessUserMatchesDataOwner.h
+++ b/src/Common/assertProcessUserMatchesDataOwner.h
@@ -1,5 +1,7 @@
 #pragma once
+
 #include <string>
+#include <functional>
 
 namespace DB
 {
diff --git a/src/Core/QualifiedTableName.h b/src/Core/QualifiedTableName.h
index 3310130629d..bf05bd59caf 100644
--- a/src/Core/QualifiedTableName.h
+++ b/src/Core/QualifiedTableName.h
@@ -127,7 +127,7 @@ namespace fmt
         template <typename FormatContext>
         auto format(const DB::QualifiedTableName & name, FormatContext & ctx)
         {
-            return format_to(ctx.out(), "{}.{}", DB::backQuoteIfNeed(name.database), DB::backQuoteIfNeed(name.table));
+            return fmt::format_to(ctx.out(), "{}.{}", DB::backQuoteIfNeed(name.database), DB::backQuoteIfNeed(name.table));
         }
     };
 }
diff --git a/src/Functions/FunctionsComparison.h b/src/Functions/FunctionsComparison.h
index 767bdf2c823..66269f72866 100644
--- a/src/Functions/FunctionsComparison.h
+++ b/src/Functions/FunctionsComparison.h
@@ -1382,43 +1382,6 @@ public:
             return executeGeneric(col_with_type_and_name_left, col_with_type_and_name_right);
         }
     }
-
-#if USE_EMBEDDED_COMPILER
-    bool isCompilableImpl(const DataTypes & arguments, const DataTypePtr & result_type) const override
-    {
-        if (2 != arguments.size())
-            return false;
-
-        WhichDataType data_type_lhs(arguments[0]);
-        WhichDataType data_type_rhs(arguments[1]);
-
-        auto is_big_integer = [](WhichDataType type) { return type.isUInt64() || type.isInt64(); };
-
-        if ((is_big_integer(data_type_lhs) && data_type_rhs.isFloat())
-            || (is_big_integer(data_type_rhs) && data_type_lhs.isFloat())
-            || (data_type_lhs.isDate() && data_type_rhs.isDateTime())
-            || (data_type_rhs.isDate() && data_type_lhs.isDateTime()))
-            return false; /// TODO: implement (double, int_N where N > double's mantissa width)
-
-        DataTypePtr common_type = getLeastSupertype(arguments);
-        return canBeNativeType(arguments[0]) && canBeNativeType(arguments[1]) && canBeNativeType(result_type) && canBeNativeType(common_type);
-    }
-
-    llvm::Value * compileImpl(llvm::IRBuilderBase & builder, const ValuesWithType & arguments, const DataTypePtr &) const override
-    {
-        assert(2 == arguments.size());
-
-        DataTypePtr common_type = getLeastSupertype(DataTypes{arguments[0].type, arguments[1].type});
-
-        auto & b = static_cast<llvm::IRBuilder<> &>(builder);
-        auto * x = nativeCast(b, arguments[0], common_type);
-        auto * y = nativeCast(b, arguments[1], common_type);
-
-        auto * result = CompileOp<Op>::compile(b, x, y, typeIsSigned(*arguments[0].type) || typeIsSigned(*arguments[1].type));
-
-        return b.CreateSelect(result, b.getInt8(1), b.getInt8(0));
-    }
-#endif
 };
 
 }
diff --git a/src/Interpreters/JIT/compileFunction.cpp b/src/Interpreters/JIT/compileFunction.cpp
index a5a646879bb..fb8dec665b4 100644
--- a/src/Interpreters/JIT/compileFunction.cpp
+++ b/src/Interpreters/JIT/compileFunction.cpp
@@ -118,7 +118,7 @@ static void compileFunction(llvm::Module & module, const IFunctionBase & functio
         const auto & type = function_argument_types[i];
 
         auto * column_data_ptr = column.data_ptr;
-        auto * column_element_value = b.CreateLoad(column.data_element_type, b.CreateGEP(column.data_element_type, column_data_ptr, counter_phi));
+        auto * column_element_value = b.CreateLoad(column.data_element_type, b.CreateInBoundsGEP(column.data_element_type, column_data_ptr, counter_phi));
 
         if (!type->isNullable())
         {
@@ -126,7 +126,7 @@ static void compileFunction(llvm::Module & module, const IFunctionBase & functio
             continue;
         }
 
-        auto * column_is_null_element_value = b.CreateLoad(b.getInt8Ty(), b.CreateGEP(b.getInt8Ty(), column.null_data_ptr, counter_phi));
+        auto * column_is_null_element_value = b.CreateLoad(b.getInt8Ty(), b.CreateInBoundsGEP(b.getInt8Ty(), column.null_data_ptr, counter_phi));
         auto * is_null = b.CreateICmpNE(column_is_null_element_value, b.getInt8(0));
         auto * nullable_unitialized = llvm::Constant::getNullValue(toNullableType(b, column.data_element_type));
         auto * nullable_value = b.CreateInsertValue(b.CreateInsertValue(nullable_unitialized, column_element_value, {0}), is_null, {1});
@@ -136,12 +136,12 @@ static void compileFunction(llvm::Module & module, const IFunctionBase & functio
     /// Compile values for column rows and store compiled value in result column
 
     auto * result = function.compile(b, arguments);
-    auto * result_column_element_ptr = b.CreateGEP(columns.back().data_element_type, columns.back().data_ptr, counter_phi);
+    auto * result_column_element_ptr = b.CreateInBoundsGEP(columns.back().data_element_type, columns.back().data_ptr, counter_phi);
 
     if (columns.back().null_data_ptr)
     {
         b.CreateStore(b.CreateExtractValue(result, {0}), result_column_element_ptr);
-        auto * result_column_is_null_element_ptr = b.CreateGEP(b.getInt8Ty(), columns.back().null_data_ptr, counter_phi);
+        auto * result_column_is_null_element_ptr = b.CreateInBoundsGEP(b.getInt8Ty(), columns.back().null_data_ptr, counter_phi);
         auto * is_result_column_element_null = b.CreateSelect(b.CreateExtractValue(result, {1}), b.getInt8(1), b.getInt8(0));
         b.CreateStore(is_result_column_element_null, result_column_is_null_element_ptr);
     }
diff --git a/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp b/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp
index bb044d15ba2..2814d13cff0 100644
--- a/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp
+++ b/src/Storages/MergeTree/ParallelReplicasReadingCoordinator.cpp
@@ -43,7 +43,7 @@ struct fmt::formatter<DB::Part>
     template <typename FormatContext>
     auto format(const DB::Part & part, FormatContext & ctx)
     {
-        return format_to(ctx.out(), "{} in replicas [{}]", part.description.describe(), fmt::join(part.replicas, ", "));
+        return fmt::format_to(ctx.out(), "{} in replicas [{}]", part.description.describe(), fmt::join(part.replicas, ", "));
     }
 };
 
diff --git a/src/Storages/MergeTree/RangesInDataPart.cpp b/src/Storages/MergeTree/RangesInDataPart.cpp
index 6203f9f7483..e64e9ab0b2a 100644
--- a/src/Storages/MergeTree/RangesInDataPart.cpp
+++ b/src/Storages/MergeTree/RangesInDataPart.cpp
@@ -15,7 +15,7 @@ struct fmt::formatter<DB::RangesInDataPartDescription>
     template <typename FormatContext>
     auto format(const DB::RangesInDataPartDescription & range, FormatContext & ctx)
     {
-        return format_to(ctx.out(), "{}", range.describe());
+        return fmt::format_to(ctx.out(), "{}", range.describe());
     }
 };
 

From 87364fae701229522dc2e9a6e976a02c5e1b30ff Mon Sep 17 00:00:00 2001
From: Tyler Hannan <tyler@clickhouse.com>
Date: Tue, 20 Jun 2023 10:42:38 +0200
Subject: [PATCH 596/722] Update README.md

Add meetups and 23.6
---
 README.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 9561458ba37..87fb4920222 100644
--- a/README.md
+++ b/README.md
@@ -22,12 +22,13 @@ curl https://clickhouse.com/ | sh
 
 ## Upcoming Events
 
-* [**v23.5 Release Webinar**](https://clickhouse.com/company/events/v23-5-release-webinar?utm_source=github&utm_medium=social&utm_campaign=release-webinar-2023-05) - Jun 8 - 23.5 is rapidly approaching. Original creator, co-founder, and CTO of ClickHouse Alexey Milovidov will walk us through the highlights of the release.
-* [**ClickHouse Meetup in Bangalore**](https://www.meetup.com/clickhouse-bangalore-user-group/events/293740066/) - Jun 7
-* [**ClickHouse Meetup in San Francisco**](https://www.meetup.com/clickhouse-silicon-valley-meetup-group/events/293426725/) - Jun 7 
+* [**v23.6 Release Webinar**](https://clickhouse.com/company/events/v23-6-release-call?utm_source=github&utm_medium=social&utm_campaign=release-webinar-2023-06) - Jun 29 - 23.6 is rapidly approaching. Original creator, co-founder, and CTO of ClickHouse Alexey Milovidov will walk us through the highlights of the release.
+* [**ClickHouse Meetup in Paris**](https://www.meetup.com/clickhouse-france-user-group/events/294283460) - Jul 4
+* [**ClickHouse Meetup in Boston**](https://www.meetup.com/clickhouse-boston-user-group/events/293913596) - Jul 18
+* [**ClickHouse Meetup in NYC**](https://www.meetup.com/clickhouse-new-york-user-group/events/293913441) - Jul 19
+* [**ClickHouse Meetup in Toronto**](https://www.meetup.com/clickhouse-toronto-user-group/events/294183127) - Jul 20
 
-
-Also, keep an eye out for upcoming meetups in Amsterdam, Boston, NYC, Beijing, and Toronto. Somewhere else you want us to be? Please feel free to reach out to tyler <at> clickhouse <dot> com.
+Also, keep an eye out for upcoming meetups around the world. Somewhere else you want us to be? Please feel free to reach out to tyler <at> clickhouse <dot> com.
 
 ## Recent Recordings
 * **Recent Meetup Videos**: [Meetup Playlist](https://www.youtube.com/playlist?list=PL0Z2YDlm0b3iNDUzpY1S3L_iV4nARda_U) Whenever possible recordings of the ClickHouse Community Meetups are edited and presented as individual talks. Current featuring "Modern SQL in 2023", "Fast, Concurrent, and Consistent Asynchronous INSERTS in ClickHouse", and "Full-Text Indices: Design and Experiments"

From fcb793dc02731d1b164f5cb71e754e5033beddcf Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Tue, 20 Jun 2023 14:26:09 +0200
Subject: [PATCH 597/722] Update exception

---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 20751731a27..76d54f9d27c 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -944,9 +944,10 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
 
         LOG_TEST(
             log,
-            "Read {} bytes, read type {}, file offset: {}, impl offset: {}/{}, segment: {}",
+            "Read {} bytes, read type {}, file offset: {}, impl offset: {}/{}, impl position: {}, segment: {}",
             size, toString(read_type), file_offset_of_buffer_end,
-            implementation_buffer->getFileOffsetOfBufferEnd(), read_until_position, file_segment.range().toString());
+            implementation_buffer->getFileOffsetOfBufferEnd(), read_until_position,
+            implementation_buffer->getPosition(), file_segment.range().toString());
 
         if (read_type == ReadType::CACHED)
         {
@@ -955,7 +956,7 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
 
             const size_t new_file_offset = file_offset_of_buffer_end + size;
             const size_t file_segment_write_offset = file_segment.getCurrentWriteOffset(true);
-            if (new_file_offset > file_segment.range().right + 1)
+            if (new_file_offset > file_segment.range().right + 1 || new_file_offset > file_segment_write_offset)
             {
                 auto file_segment_path = file_segment.getPathInLocalCache();
                 throw Exception(
@@ -963,13 +964,6 @@ bool CachedOnDiskReadBufferFromFile::nextImplStep()
                     "Read unexpected size. File size: {}, file path: {}, file segment info: {}",
                     fs::file_size(file_segment_path), file_segment_path, file_segment.getInfoForLog());
             }
-            if (new_file_offset > file_segment_write_offset)
-            {
-                throw Exception(
-                    ErrorCodes::LOGICAL_ERROR,
-                    "Read unexpected size. Read {} bytes, file offset: {}, segment: {}, segment write offset: {}",
-                    size, file_offset_of_buffer_end, file_segment.range().toString(), file_segment_write_offset);
-            }
         }
         else
         {

From 1d80072c217e15b717f7fffa8cefa56ffe1e9f3e Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 20 Jun 2023 13:01:47 +0000
Subject: [PATCH 598/722] Fix tests and builds

---
 src/Storages/HDFS/StorageHDFS.cpp      | 1 +
 src/Storages/ReadFromStorageProgress.h | 3 +--
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 6a0ecdf1585..583c45a0633 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -465,6 +465,7 @@ Chunk HDFSSource::generate()
 
         reader.reset();
         pipeline.reset();
+        input_format.reset();
         read_buf.reset();
 
         if (!initialize())
diff --git a/src/Storages/ReadFromStorageProgress.h b/src/Storages/ReadFromStorageProgress.h
index bc1367cc2e7..2be37d26fee 100644
--- a/src/Storages/ReadFromStorageProgress.h
+++ b/src/Storages/ReadFromStorageProgress.h
@@ -5,12 +5,11 @@ namespace DB
 {
 
 class ISource;
-class Chunk;
 
 void updateRowsProgressApprox(
     ISource & source,
     size_t num_rows,
-    size_t chunk_bytes_size,
+    UInt64 chunk_bytes_size,
     UInt64 total_result_size,
     UInt64 & total_rows_approx_accumulated,
     size_t & total_rows_count_times,

From 23d843d379fa337e8fbc842fa0397fdf9d18bf7d Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 19 Jun 2023 18:43:38 +0200
Subject: [PATCH 599/722] Experiment with decreasing scale_up for
 style-checkers

---
 tests/ci/autoscale_runners_lambda/app.py                    | 6 ++++--
 .../autoscale_runners_lambda_test.py                        | 2 +-
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/tests/ci/autoscale_runners_lambda/app.py b/tests/ci/autoscale_runners_lambda/app.py
index 4514c38ddad..d3f26732df6 100644
--- a/tests/ci/autoscale_runners_lambda/app.py
+++ b/tests/ci/autoscale_runners_lambda/app.py
@@ -59,12 +59,14 @@ def get_scales(runner_type: str) -> Tuple[int, int]:
     scale_down = 2
     scale_up = 5
     if runner_type == "style-checker":
-        # the style checkers have so many noise, so it scales up too quickly
+        # The ASG should deflate almost instantly
         scale_down = 1
+        # the style checkers have so many noise, so it scales up too quickly
         # The 5 was too quick, there are complainings regarding too slow with
         # 10. I am trying 7 now.
+        # 7 still looks a bit slow, so I try 6
         # UPDATE THE COMMENT ON CHANGES
-        scale_up = 7
+        scale_up = 6
     elif runner_type == "limited-tester":
         # The limited runners should inflate and deflate faster
         scale_down = 1
diff --git a/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py b/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
index b17135df583..6a6451cbd2a 100644
--- a/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
+++ b/tests/ci/autoscale_runners_lambda/autoscale_runners_lambda_test.py
@@ -72,7 +72,7 @@ class TestSetCapacity(unittest.TestCase):
             # Increase capacity
             TestCase("increase", 1, 13, 20, [Queue("queued", 23, "increase")], 15),
             TestCase(
-                "style-checker", 1, 13, 20, [Queue("queued", 33, "style-checker")], 15
+                "style-checker", 1, 13, 20, [Queue("queued", 33, "style-checker")], 16
             ),
             TestCase("increase", 1, 13, 20, [Queue("queued", 18, "increase")], 14),
             TestCase("increase", 1, 13, 20, [Queue("queued", 183, "increase")], 20),

From 31ece0c5121d08af1ead5d70c6ae91326807494a Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Tue, 20 Jun 2023 13:24:28 +0000
Subject: [PATCH 600/722] add test for check part with cache

---
 .../MergeTree/DataPartStorageOnDiskFull.cpp   |  4 +-
 src/Storages/MergeTree/IDataPartStorage.h     |  2 +
 src/Storages/MergeTree/checkDataPart.cpp      | 10 +-
 .../__init__.py                               |  0
 .../configs/storage_conf.xml                  | 29 ++++++
 .../test.py                                   | 99 +++++++++++++++++++
 6 files changed, 141 insertions(+), 3 deletions(-)
 create mode 100644 tests/integration/test_merge_tree_check_part_with_cache/__init__.py
 create mode 100644 tests/integration/test_merge_tree_check_part_with_cache/configs/storage_conf.xml
 create mode 100644 tests/integration/test_merge_tree_check_part_with_cache/test.py

diff --git a/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp b/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
index 8bb1043975f..e62e5a5d6b2 100644
--- a/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
+++ b/src/Storages/MergeTree/DataPartStorageOnDiskFull.cpp
@@ -93,7 +93,9 @@ UInt32 DataPartStorageOnDiskFull::getRefCount(const String & file_name) const
 std::string DataPartStorageOnDiskFull::getRemotePath(const std::string & file_name) const
 {
     auto objects = volume->getDisk()->getStorageObjects(fs::path(root_path) / part_dir / file_name);
-    chassert(objects.size() == 1);
+    if (objects.size() != 1)
+        throw Exception(ErrorCodes::LOGICAL_ERROR, "One file must be mapped to one object on blob storage in MergeTree tables");
+
     return objects[0].remote_path;
 }
 
diff --git a/src/Storages/MergeTree/IDataPartStorage.h b/src/Storages/MergeTree/IDataPartStorage.h
index 895ecc2cda3..9d6c5d0dcba 100644
--- a/src/Storages/MergeTree/IDataPartStorage.h
+++ b/src/Storages/MergeTree/IDataPartStorage.h
@@ -110,6 +110,8 @@ public:
     /// Get metadata for a file inside path dir.
     virtual size_t getFileSize(const std::string & file_name) const = 0;
     virtual UInt32 getRefCount(const std::string & file_name) const = 0;
+
+    /// Get path on remote filesystem from file name on local filesystem.
     virtual std::string getRemotePath(const std::string & file_name) const = 0;
 
     virtual UInt64 calculateTotalSizeOnDisk() const = 0;
diff --git a/src/Storages/MergeTree/checkDataPart.cpp b/src/Storages/MergeTree/checkDataPart.cpp
index 90f37ebe0c4..5c090cdd739 100644
--- a/src/Storages/MergeTree/checkDataPart.cpp
+++ b/src/Storages/MergeTree/checkDataPart.cpp
@@ -1,3 +1,4 @@
+#include <Poco/Logger.h>
 #include <algorithm>
 #include <optional>
 
@@ -246,6 +247,9 @@ IMergeTreeDataPart::Checksums checkDataPart(
     if (auto part_in_memory = asInMemoryPart(data_part))
         return checkDataPartInMemory(part_in_memory);
 
+    /// If check of part has failed and it is stored on disk with cache
+    /// try to drop cache and check it once again because maybe the cache
+    /// is broken not the part itself.
     auto drop_cache_and_check = [&]
     {
         const auto & data_part_storage = data_part->getDataPartStorage();
@@ -254,6 +258,10 @@ IMergeTreeDataPart::Checksums checkDataPart(
         if (!cache_name)
             throw;
 
+        LOG_DEBUG(
+            &Poco::Logger::get("checkDataPart"),
+            "Will drop cache for data part {} and will check it once again", data_part->name);
+
         auto & cache = *FileCacheFactory::instance().getByName(*cache_name).cache;
         for (auto it = data_part_storage.iterate(); it->isValid(); it->next())
         {
@@ -267,8 +275,6 @@ IMergeTreeDataPart::Checksums checkDataPart(
 
         ReadSettings read_settings;
         read_settings.enable_filesystem_cache = false;
-        read_settings.remote_fs_prefetch = false;
-        read_settings.remote_fs_method = RemoteFSReadMethod::read;
 
         return checkDataPart(
             data_part,
diff --git a/tests/integration/test_merge_tree_check_part_with_cache/__init__.py b/tests/integration/test_merge_tree_check_part_with_cache/__init__.py
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/integration/test_merge_tree_check_part_with_cache/configs/storage_conf.xml b/tests/integration/test_merge_tree_check_part_with_cache/configs/storage_conf.xml
new file mode 100644
index 00000000000..c5e5565e1a9
--- /dev/null
+++ b/tests/integration/test_merge_tree_check_part_with_cache/configs/storage_conf.xml
@@ -0,0 +1,29 @@
+<clickhouse>
+    <storage_configuration>
+        <disks>
+            <s3>
+                <type>s3</type>
+                <endpoint>http://minio1:9001/root/data/</endpoint>
+                <access_key_id>minio</access_key_id>
+                <secret_access_key>minio123</secret_access_key>
+                <s3_max_single_part_upload_size>33554432</s3_max_single_part_upload_size>
+            </s3>
+            <s3_cache>
+                <type>cache</type>
+                <disk>s3</disk>
+                <path>/s3_cache/</path>
+                <max_size>1000000000</max_size>
+                <cache_on_write_operations>1</cache_on_write_operations>
+            </s3_cache>
+        </disks>
+        <policies>
+            <s3_cache>
+                <volumes>
+                    <main>
+                        <disk>s3_cache</disk>
+                    </main>
+                </volumes>
+            </s3_cache>
+        </policies>
+    </storage_configuration>
+</clickhouse>
diff --git a/tests/integration/test_merge_tree_check_part_with_cache/test.py b/tests/integration/test_merge_tree_check_part_with_cache/test.py
new file mode 100644
index 00000000000..87ccf19812f
--- /dev/null
+++ b/tests/integration/test_merge_tree_check_part_with_cache/test.py
@@ -0,0 +1,99 @@
+import pytest
+import os
+import json
+from helpers.cluster import ClickHouseCluster
+
+cluster = ClickHouseCluster(__file__)
+
+node = cluster.add_instance(
+    "node",
+    main_configs=["configs/storage_conf.xml"],
+    with_minio=True,
+)
+
+
+@pytest.fixture(scope="module")
+def start_cluster():
+    try:
+        cluster.start()
+        yield cluster
+    finally:
+        cluster.shutdown()
+
+
+def test_check_part_with_cache(start_cluster):
+    node.query(
+        """
+        CREATE TABLE s3_test (
+            id Int64,
+            data String
+        ) ENGINE=MergeTree()
+        ORDER BY id
+        SETTINGS storage_policy='s3_cache'
+        """
+    )
+
+    node.query("SYSTEM STOP MERGES s3_test")
+
+    node.query(
+        "INSERT INTO s3_test VALUES (0, 'data')",
+        settings={"enable_filesystem_cache_on_write_operations": 1},
+    )
+
+    node.query(
+        "INSERT INTO s3_test VALUES (1, 'data')",
+        settings={"enable_filesystem_cache_on_write_operations": 1},
+    )
+
+    def get_cache_path_of_data_file(part_name):
+        disk_path = node.query(
+            "SELECT path FROM system.disks WHERE name = 's3_cache'"
+        ).strip("\n")
+
+        part_path = node.query(
+            f"SELECT path FROM system.parts WHERE table = 's3_test' AND name = '{part_name}'"
+        ).strip("\n")
+
+        local_data_file_path = os.path.relpath(part_path, disk_path) + "/data.bin"
+
+        return node.query(
+            f"SELECT cache_paths[1] FROM system.remote_data_paths WHERE disk_name = 's3_cache' AND local_path = '{local_data_file_path}'"
+        ).strip("\n")
+
+    cache_path = get_cache_path_of_data_file("all_1_1_0")
+    assert len(cache_path) > 0
+
+    node.exec_in_container(
+        ["bash", "-c", f"truncate -s -1 {cache_path}"], privileged=True
+    )
+
+    assert (
+        node.query(
+            "SELECT count() FROM s3_test WHERE NOT ignore(*)",
+            settings={"enable_filesystem_cache": 0},
+        )
+        == "2\n"
+    )
+
+    with pytest.raises(Exception):
+        node.query(
+            "SELECT count() FROM s3_test WHERE NOT ignore(*)",
+            settings={"enable_filesystem_cache": 1},
+        )
+
+    assert node.query("CHECK TABLE s3_test") == "1\n"
+
+    # Check that cache is removed only for one part after CHECK TABLE
+    cache_path = get_cache_path_of_data_file("all_1_1_0")
+    assert len(cache_path) == 0
+
+    cache_path = get_cache_path_of_data_file("all_2_2_0")
+    assert len(cache_path) > 0
+
+    assert (
+        node.query(
+            "SELECT count() FROM s3_test WHERE NOT ignore(*)",
+            settings={"enable_filesystem_cache": 1},
+        )
+        == "2\n"
+    )

From 154d19ce7274ba762953fa0865f12bf0609e5912 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=83=AD=E5=B0=8F=E9=BE=99?= <467887319@qq.com>
Date: Tue, 20 Jun 2023 21:57:55 +0800
Subject: [PATCH 601/722] The time format (connected_time field) is incorrect
 (#51026)

* The time format (connected_time field) is incorrect

* Change the description and increase the field list display

* Update 02735_system_zookeeper_connection.reference

* Update 02735_system_zookeeper_connection.sql

* Update 02735_system_zookeeper_connection.sql

* Update 02735_system_zookeeper_connection.reference

* fix test

---------

Co-authored-by: Alexander Tokmakov <tavplubix@gmail.com>
Co-authored-by: Alexander Tokmakov <tavplubix@clickhouse.com>
---
 .../system-tables/zookeeper_connection.md     |  9 +++++----
 src/Common/ZooKeeper/ZooKeeper.h              |  2 ++
 .../StorageSystemZooKeeperConnection.cpp      | 19 +++++++++++--------
 ...2735_system_zookeeper_connection.reference |  4 ++--
 .../02735_system_zookeeper_connection.sql     |  8 +++++++-
 5 files changed, 27 insertions(+), 15 deletions(-)

diff --git a/docs/en/operations/system-tables/zookeeper_connection.md b/docs/en/operations/system-tables/zookeeper_connection.md
index 9438cda1808..2f0ed303ce3 100644
--- a/docs/en/operations/system-tables/zookeeper_connection.md
+++ b/docs/en/operations/system-tables/zookeeper_connection.md
@@ -11,7 +11,8 @@ Columns:
 -   `host` ([String](../../sql-reference/data-types/string.md)) — The hostname/IP of the ZooKeeper node that ClickHouse connected to.
 -   `port` ([String](../../sql-reference/data-types/string.md)) — The port of the ZooKeeper node that ClickHouse connected to.
 -   `index` ([UInt8](../../sql-reference/data-types/int-uint.md)) — The index of the ZooKeeper node that ClickHouse connected to. The index is from ZooKeeper config.
--   `connected_time` ([String](../../sql-reference/data-types/string.md)) — When the connection was established
+-   `connected_time` ([DateTime](../../sql-reference/data-types/datetime.md)) — When the connection was established
+-   `session_uptime_elapsed_seconds` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Seconds elapsed since the connection was established
 -   `is_expired` ([UInt8](../../sql-reference/data-types/int-uint.md)) — Is the current connection expired.
 -   `keeper_api_version` ([String](../../sql-reference/data-types/string.md)) — Keeper API version.
 -   `client_id` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Session id of the connection.
@@ -23,7 +24,7 @@ SELECT * FROM system.zookeeper_connection;
 ```
 
 ``` text
-┌─name──────────────┬─host─────────┬─port─┬─index─┬──────connected_time─┬─is_expired─┬─keeper_api_version─┬──────────client_id─┐
-│ default_zookeeper │ 127.0.0.1    │ 2181 │     0 │ 2023-05-19 14:30:16 │          0 │                  0 │ 216349144108826660 │
-└───────────────────┴──────────────┴──────┴───────┴─────────────────────┴────────────┴────────────────────┴────────────────────┘
+┌─name────┬─host──────┬─port─┬─index─┬──────connected_time─┬─session_uptime_elapsed_seconds─┬─is_expired─┬─keeper_api_version─┬─client_id─┐
+│ default │ 127.0.0.1 │ 9181 │     0 │ 2023-06-15 14:36:01 │                           3058 │          0 │                  3 │         5 │
+└─────────┴───────────┴──────┴───────┴─────────────────────┴────────────────────────────────┴────────────┴────────────────────┴───────────┘
 ```
diff --git a/src/Common/ZooKeeper/ZooKeeper.h b/src/Common/ZooKeeper/ZooKeeper.h
index d48ca0a4ef5..f5e00b5f283 100644
--- a/src/Common/ZooKeeper/ZooKeeper.h
+++ b/src/Common/ZooKeeper/ZooKeeper.h
@@ -526,6 +526,7 @@ public:
     String getConnectedZooKeeperHost() const { return connected_zk_host; }
     UInt16 getConnectedZooKeeperPort() const { return connected_zk_port; }
     size_t getConnectedZooKeeperIndex() const { return connected_zk_index; }
+    UInt64 getConnectedTime() const { return connected_time; }
 
 private:
     void init(ZooKeeperArgs args_);
@@ -593,6 +594,7 @@ private:
     String connected_zk_host;
     UInt16 connected_zk_port;
     size_t connected_zk_index;
+    UInt64 connected_time = timeInSeconds(std::chrono::system_clock::now());
 
     std::mutex mutex;
 
diff --git a/src/Storages/System/StorageSystemZooKeeperConnection.cpp b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
index 559e12ad5ee..03886e6ef8b 100644
--- a/src/Storages/System/StorageSystemZooKeeperConnection.cpp
+++ b/src/Storages/System/StorageSystemZooKeeperConnection.cpp
@@ -16,6 +16,7 @@ NamesAndTypesList StorageSystemZooKeeperConnection::getNamesAndTypes()
         {"port", std::make_shared<DataTypeUInt16>()},
         {"index", std::make_shared<DataTypeUInt8>()},
         {"connected_time", std::make_shared<DataTypeDateTime>()},
+        {"session_uptime_elapsed_seconds", std::make_shared<DataTypeUInt64>()},
         {"is_expired", std::make_shared<DataTypeUInt8>()},
         {"keeper_api_version", std::make_shared<DataTypeUInt8>()},
         {"client_id", std::make_shared<DataTypeInt64>()}
@@ -29,10 +30,11 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
     res_columns[1]->insert(context->getZooKeeper()->getConnectedZooKeeperHost());
     res_columns[2]->insert(context->getZooKeeper()->getConnectedZooKeeperPort());
     res_columns[3]->insert(context->getZooKeeper()->getConnectedZooKeeperIndex());
-    res_columns[4]->insert(context->getZooKeeperSessionUptime());
-    res_columns[5]->insert(context->getZooKeeper()->expired());
-    res_columns[6]->insert(context->getZooKeeper()->getApiVersion());
-    res_columns[7]->insert(context->getZooKeeper()->getClientID());
+    res_columns[4]->insert(context->getZooKeeper()->getConnectedTime());
+    res_columns[5]->insert(context->getZooKeeperSessionUptime());
+    res_columns[6]->insert(context->getZooKeeper()->expired());
+    res_columns[7]->insert(context->getZooKeeper()->getApiVersion());
+    res_columns[8]->insert(context->getZooKeeper()->getClientID());
 
     for (const auto & elem : context->getAuxiliaryZooKeepers())
     {
@@ -40,10 +42,11 @@ void StorageSystemZooKeeperConnection::fillData(MutableColumns & res_columns, Co
         res_columns[1]->insert(elem.second->getConnectedZooKeeperHost());
         res_columns[2]->insert(elem.second->getConnectedZooKeeperPort());
         res_columns[3]->insert(elem.second->getConnectedZooKeeperIndex());
-        res_columns[4]->insert(elem.second->getSessionUptime());
-        res_columns[5]->insert(elem.second->expired());
-        res_columns[6]->insert(elem.second->getApiVersion());
-        res_columns[7]->insert(elem.second->getClientID());
+        res_columns[4]->insert(elem.second->getConnectedTime());
+        res_columns[5]->insert(elem.second->getSessionUptime());
+        res_columns[6]->insert(elem.second->expired());
+        res_columns[7]->insert(elem.second->getApiVersion());
+        res_columns[8]->insert(elem.second->getClientID());
     }
 
 }
diff --git a/tests/queries/0_stateless/02735_system_zookeeper_connection.reference b/tests/queries/0_stateless/02735_system_zookeeper_connection.reference
index 1deabd88b88..52ff7657b8d 100644
--- a/tests/queries/0_stateless/02735_system_zookeeper_connection.reference
+++ b/tests/queries/0_stateless/02735_system_zookeeper_connection.reference
@@ -1,2 +1,2 @@
-default	::1	9181	0	0	3
-zookeeper2	::1	9181	0	0	0
+default	::1	9181	0	0	3	1	1
+zookeeper2	::1	9181	0	0	0	1
diff --git a/tests/queries/0_stateless/02735_system_zookeeper_connection.sql b/tests/queries/0_stateless/02735_system_zookeeper_connection.sql
index 8b37c428413..863d90e1654 100644
--- a/tests/queries/0_stateless/02735_system_zookeeper_connection.sql
+++ b/tests/queries/0_stateless/02735_system_zookeeper_connection.sql
@@ -8,8 +8,14 @@ CREATE TABLE test_zk_connection_table (
 ENGINE ReplicatedMergeTree('zookeeper2:/clickhouse/{database}/02731_zk_connection/{shard}', '{replica}')
 ORDER BY tuple();
 
+select name, host, port, index, is_expired, keeper_api_version, (connected_time between yesterday() and now()),
+       (abs(session_uptime_elapsed_seconds  - zookeeperSessionUptime()) < 10)
+from system.zookeeper_connection where name='default';
+
 -- keeper_api_version will by 0 for auxiliary_zookeeper2, because we fail to get /api_version due to chroot
 -- I'm not sure if it's a bug or a useful trick to fallback to basic api
-select name, host, port, index, is_expired, keeper_api_version from system.zookeeper_connection order by name;
+-- Also, auxiliary zookeeper is created lazily
+select name, host, port, index, is_expired, keeper_api_version, (connected_time between yesterday() and now())
+from system.zookeeper_connection where name!='default';
 
 DROP TABLE IF EXISTS test_zk_connection_table;

From 816c6cdeb19b05e92a25d20142eb1f25a70874a4 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Tue, 20 Jun 2023 16:56:50 +0200
Subject: [PATCH 602/722] Simplify the code by using tryGetChildren

---
 src/Storages/System/StorageSystemZooKeeper.cpp | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index dcab7d42a73..90300c11401 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -442,7 +442,7 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
     while (!paths.empty())
     {
         list_tasks.clear();
-        Coordination::Requests list_requests;
+        std::vector<String> paths_to_list;
         while (!paths.empty() && static_cast<Int64>(list_tasks.size()) < max_inflight_requests)
         {
             auto [path, path_type] = std::move(paths.front());
@@ -460,11 +460,10 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
 
             task.path_corrected = pathCorrected(path);
 
-            list_requests.emplace_back(zkutil::makeListRequest(task.path_corrected));
+            paths_to_list.emplace_back(task.path_corrected);
             list_tasks.emplace_back(std::move(task));
         }
-        Coordination::Responses list_responses;
-        zookeeper->tryMulti(list_requests, list_responses);
+        auto list_responses = zookeeper->tryGetChildren(paths_to_list);
 
         struct GetTask
         {
@@ -475,14 +474,14 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
         Coordination::Requests get_requests;
         for (size_t list_task_idx = 0; list_task_idx < list_tasks.size(); ++list_task_idx)
         {
+            auto & list_result = list_responses[list_task_idx];
             /// Node can be deleted concurrently. It's Ok, we don't provide any
             /// consistency guarantees for system.zookeeper table.
-            if (list_responses[list_task_idx]->error == Coordination::Error::ZNONODE)
+            if (list_result.error == Coordination::Error::ZNONODE)
                 continue;
 
             auto & task = list_tasks[list_task_idx];
             context->getProcessListElement()->checkTimeLimit();
-            auto & list_result = dynamic_cast<Coordination::ListResponse &>(*list_responses[list_task_idx]);
 
             Strings nodes = std::move(list_result.names);
 

From 7a1f8547f31d2c12a062ba2c231cb53e76c72297 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Tue, 20 Jun 2023 17:18:05 +0200
Subject: [PATCH 603/722] Simplify the code

---
 src/Storages/System/StorageSystemZooKeeper.cpp | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/src/Storages/System/StorageSystemZooKeeper.cpp b/src/Storages/System/StorageSystemZooKeeper.cpp
index 90300c11401..a3f5761a85e 100644
--- a/src/Storages/System/StorageSystemZooKeeper.cpp
+++ b/src/Storages/System/StorageSystemZooKeeper.cpp
@@ -471,7 +471,7 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
             String node;            /// Node name
         };
         std::vector<GetTask> get_tasks;
-        Coordination::Requests get_requests;
+        std::vector<String> paths_to_get;
         for (size_t list_task_idx = 0; list_task_idx < list_tasks.size(); ++list_task_idx)
         {
             auto & list_result = list_responses[list_task_idx];
@@ -501,23 +501,22 @@ void ReadFromSystemZooKeeper::fillData(MutableColumns & res_columns) const
             get_tasks.reserve(get_tasks.size() + nodes.size());
             for (const String & node : nodes)
             {
-                get_requests.emplace_back(zkutil::makeGetRequest(task.path_part + '/' + node));
+                paths_to_get.emplace_back(task.path_part + '/' + node);
                 get_tasks.emplace_back(GetTask{list_task_idx, node});
             }
         }
 
-        Coordination::Responses get_responses;
-        zookeeper->tryMulti(get_requests, get_responses);
+        auto get_responses = zookeeper->tryGet(paths_to_get);
 
         for (size_t i = 0, size = get_tasks.size(); i < size; ++i)
         {
-            if (get_responses[i]->error == Coordination::Error::ZNONODE)
+            auto & res = get_responses[i];
+            if (res.error == Coordination::Error::ZNONODE)
                 continue; /// Node was deleted meanwhile.
 
             auto & get_task = get_tasks[i];
             auto & list_task = list_tasks[get_task.list_task_idx];
             context->getProcessListElement()->checkTimeLimit();
-            auto & res = dynamic_cast<Coordination::GetResponse &>(*get_responses[i]);
 
             // Deduplication
             String key = list_task.path_part + '/' + get_task.node;

From 28703ccead04e201b2ca6dd4ae3f64472e648de4 Mon Sep 17 00:00:00 2001
From: Justin de Guzman <justin@justindeguzman.net>
Date: Tue, 20 Jun 2023 09:00:03 -0700
Subject: [PATCH 604/722] Specify that user/password is required for dicts in
 SQL Console

---
 .../statements/create/dictionary.md           | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/en/sql-reference/statements/create/dictionary.md b/docs/en/sql-reference/statements/create/dictionary.md
index 29c72d62f24..19087384876 100644
--- a/docs/en/sql-reference/statements/create/dictionary.md
+++ b/docs/en/sql-reference/statements/create/dictionary.md
@@ -82,6 +82,28 @@ LIFETIME(MIN 0 MAX 1000)
 LAYOUT(FLAT())
 ```
 
+:::note
+When using the SQL console in [ClickHouse Cloud](https://clickhouse.com), you must specify a user (`default` or any other user) and password when creating a dictionary.
+:::note
+
+```sql
+CREATE TABLE foo_db.source_table (
+    id UInt64,
+    value String
+) ENGINE = MergeTree
+PRIMARY KEY id;
+
+CREATE DICTIONARY foo_db.id_value_dictionary
+(
+    id UInt64,
+    value String
+)
+PRIMARY KEY id
+SOURCE(CLICKHOUSE(TABLE 'source_table' USER 'foo_user' PASSWORD 'foo_user_complex_password' DB 'foo_db' ))
+LAYOUT(FLAT())
+LIFETIME(MIN 0 MAX 1000);
+```
+
 ### Create a dictionary from a table in a remote ClickHouse service
 
 Input table (in the remote ClickHouse service) `source_table`:

From d5946da5f8434f9d074d0116e493428c36678a86 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 20 Jun 2023 13:31:11 -0300
Subject: [PATCH 605/722] Update settings.md

---
 docs/en/operations/settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
index f0668c1d58f..baefbb2cf6f 100644
--- a/docs/en/operations/settings/settings.md
+++ b/docs/en/operations/settings/settings.md
@@ -2941,7 +2941,7 @@ Default value: `0`.
 
 ## mutations_sync {#mutations_sync}
 
-Allows to execute `ALTER TABLE ... UPDATE|DELETE` queries ([mutations](../../sql-reference/statements/alter/index.md#mutations)) synchronously.
+Allows to execute `ALTER TABLE ... UPDATE|DELETE|MATERIALIZE INDEX|MATERIALIZE PROJECTION|MATERIALIZE COLUMN` queries ([mutations](../../sql-reference/statements/alter/index.md#mutations)) synchronously.
 
 Possible values:
 

From a39088c99aa1392171b539114bddcb4a179436f3 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 20 Jun 2023 13:35:45 -0300
Subject: [PATCH 606/722] Update column.md

---
 docs/en/sql-reference/statements/alter/column.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/en/sql-reference/statements/alter/column.md b/docs/en/sql-reference/statements/alter/column.md
index 378f41c1199..dae2c7dd1d3 100644
--- a/docs/en/sql-reference/statements/alter/column.md
+++ b/docs/en/sql-reference/statements/alter/column.md
@@ -232,6 +232,7 @@ ALTER TABLE table_with_ttl MODIFY COLUMN column_ttl REMOVE TTL;
 
 Materializes or updates a column with an expression for a default value (`DEFAULT` or `MATERIALIZED`).
 It is used if it is necessary to add or update a column with a complicated expression, because evaluating such an expression directly on `SELECT` executing turns out to be expensive. 
+Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 Syntax:
 

From ff8c01c6672f1781fd04fbf95997bfe5ea1d32fc Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 20 Jun 2023 16:37:52 +0000
Subject: [PATCH 607/722] Split long test
 02149_schema_inference_formats_with_schema into several tests to avoid
 timeout in debug

---
 ..._inference_formats_with_schema_1.reference | 170 +++++++++++++
 ..._schema_inference_formats_with_schema_1.sh |  39 +++
 ..._inference_formats_with_schema_2.reference | 238 ++++++++++++++++++
 ..._schema_inference_formats_with_schema_2.sh |  39 +++
 ..._inference_formats_with_schema_3.reference |  27 ++
 ..._schema_inference_formats_with_schema_3.sh |  34 +++
 6 files changed, 547 insertions(+)
 create mode 100644 tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.reference
 create mode 100755 tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.sh
 create mode 100644 tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.reference
 create mode 100755 tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.sh
 create mode 100644 tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference
 create mode 100755 tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh

diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.reference b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.reference
new file mode 100644
index 00000000000..4e020427ad0
--- /dev/null
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.reference
@@ -0,0 +1,170 @@
+Arrow
+int8	Nullable(Int8)					
+uint8	Nullable(UInt8)					
+int16	Nullable(Int16)					
+uint16	Nullable(UInt16)					
+int32	Nullable(Int32)					
+uint32	Nullable(UInt32)					
+int64	Nullable(Int64)					
+uint64	Nullable(UInt64)					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Nullable(Float32)					
+float64	Nullable(Float64)					
+decimal32	Nullable(Decimal(9, 5))					
+decimal64	Nullable(Decimal(18, 5))					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Nullable(UInt16)					
+date32	Nullable(Date32)					
+0	1970-01-01
+1	1970-01-02
+str	Nullable(String)					
+fixed_string	Nullable(FixedString(3))					
+Str: 0	100
+Str: 1	200
+array	Array(Nullable(UInt64))					
+tuple	Tuple(`1` Nullable(UInt64), `2` Nullable(String))					
+map	Map(String, Nullable(UInt64))					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(`1` Array(Nullable(UInt64)), `2` Map(String, Nullable(UInt64))))					
+nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(UInt64))), `2` Map(UInt64, Array(Tuple(`1` Nullable(UInt64), `2` Nullable(String))))), `2` Nullable(UInt8))					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+ArrowStream
+int8	Nullable(Int8)					
+uint8	Nullable(UInt8)					
+int16	Nullable(Int16)					
+uint16	Nullable(UInt16)					
+int32	Nullable(Int32)					
+uint32	Nullable(UInt32)					
+int64	Nullable(Int64)					
+uint64	Nullable(UInt64)					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Nullable(Float32)					
+float64	Nullable(Float64)					
+decimal32	Nullable(Decimal(9, 5))					
+decimal64	Nullable(Decimal(18, 5))					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Nullable(UInt16)					
+date32	Nullable(Date32)					
+0	1970-01-01
+1	1970-01-02
+str	Nullable(String)					
+fixed_string	Nullable(FixedString(3))					
+Str: 0	100
+Str: 1	200
+array	Array(Nullable(UInt64))					
+tuple	Tuple(`1` Nullable(UInt64), `2` Nullable(String))					
+map	Map(String, Nullable(UInt64))					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(`1` Array(Nullable(UInt64)), `2` Map(String, Nullable(UInt64))))					
+nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(UInt64))), `2` Map(UInt64, Array(Tuple(`1` Nullable(UInt64), `2` Nullable(String))))), `2` Nullable(UInt8))					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+Parquet
+int8	Nullable(Int8)					
+uint8	Nullable(UInt8)					
+int16	Nullable(Int16)					
+uint16	Nullable(UInt16)					
+int32	Nullable(Int32)					
+uint32	Nullable(UInt32)					
+int64	Nullable(Int64)					
+uint64	Nullable(UInt64)					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Nullable(Float32)					
+float64	Nullable(Float64)					
+decimal32	Nullable(Decimal(9, 5))					
+decimal64	Nullable(Decimal(18, 5))					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Nullable(UInt16)					
+date32	Nullable(Date32)					
+0	1970-01-01
+1	1970-01-02
+str	Nullable(String)					
+fixed_string	Nullable(FixedString(3))					
+Str: 0	100
+Str: 1	200
+array	Array(Nullable(UInt64))					
+tuple	Tuple(`1` Nullable(UInt64), `2` Nullable(String))					
+map	Map(String, Nullable(UInt64))					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(`1` Array(Nullable(UInt64)), `2` Map(String, Nullable(UInt64))))					
+nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(UInt64))), `2` Map(UInt64, Array(Tuple(`1` Nullable(UInt64), `2` Nullable(String))))), `2` Nullable(UInt8))					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+ORC
+int8	Nullable(Int8)					
+uint8	Nullable(Int8)					
+int16	Nullable(Int16)					
+uint16	Nullable(Int16)					
+int32	Nullable(Int32)					
+uint32	Nullable(Int32)					
+int64	Nullable(Int64)					
+uint64	Nullable(Int64)					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Nullable(Float32)					
+float64	Nullable(Float64)					
+decimal32	Nullable(Decimal(9, 5))					
+decimal64	Nullable(Decimal(18, 5))					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Nullable(Date32)					
+date32	Nullable(Date32)					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	Nullable(String)					
+fixed_string	Nullable(String)					
+Str: 0	100
+Str: 1	200
+array	Array(Nullable(Int64))					
+tuple	Tuple(`1` Nullable(Int64), `2` Nullable(String))					
+map	Map(String, Nullable(Int64))					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(`1` Array(Nullable(Int64)), `2` Map(String, Nullable(Int64))))					
+nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(Int64))), `2` Map(Int64, Array(Tuple(`1` Nullable(Int64), `2` Nullable(String))))), `2` Nullable(Int8))					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+Native
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.sh b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.sh
new file mode 100755
index 00000000000..a74d7c138d3
--- /dev/null
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_1.sh
@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+
+DATA_FILE=$CURDIR/test_$CLICKHOUSE_TEST_UNIQUE_NAME.data
+
+for format in Arrow ArrowStream Parquet ORC Native
+do
+    echo $format
+    $CLICKHOUSE_LOCAL -q "select toInt8(-number) as int8, toUInt8(number) as uint8, toInt16(-number) as int16, toUInt16(number) as uint16, toInt32(-number) as int32, toUInt32(number) as uint32, toInt64(-number) as int64, toUInt64(number) as uint64 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select toFloat32(number * 1.2) as float32, toFloat64(number / 1.3) as float64, toDecimal32(number / 0.3, 5) as decimal32, toDecimal64(number / 0.003, 5) as decimal64 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select toDate(number) as date, toDate32(number) as date32 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select concat('Str: ', toString(number)) as str, toFixedString(toString((number + 1) * 100 % 1000), 3) as fixed_string from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+ 
+    $CLICKHOUSE_LOCAL -q "select [number, number + 1] as array, (number, toString(number)) as tuple, map(toString(number), number) as map from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select [([number, number + 1], map('42', number)), ([], map()), ([42], map('42', 42))] as nested1, (([[number], [number + 1], []], map(number, [(number, '42'), (number + 1, '42')])), 42) as nested2 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+done
+
+rm $DATA_FILE
diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.reference b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.reference
new file mode 100644
index 00000000000..ec6ac9539f8
--- /dev/null
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.reference
@@ -0,0 +1,238 @@
+TSVWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+TSVRawWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+CSVWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+JSONCompactEachRowWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+JSONCompactStringsEachRowWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+RowBinaryWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
+CustomSeparatedWithNamesAndTypes
+int8	Int8					
+uint8	UInt8					
+int16	Int16					
+uint16	UInt16					
+int32	Int32					
+uint32	UInt32					
+int64	Int64					
+uint64	UInt64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+decimal32	Decimal(9, 5)					
+decimal64	Decimal(18, 5)					
+0	0	0	0
+1.2	0.7692307692307692	3.33333	333.33333
+date	Date					
+date32	Date32					
+1970-01-01	1970-01-01
+1970-01-02	1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(UInt64)					
+tuple	Tuple(UInt64, String)					
+map	Map(String, UInt64)					
+[0,1]	(0,'0')	{'0':0}
+[1,2]	(1,'1')	{'1':1}
+nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
+nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
+[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
+[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.sh b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.sh
new file mode 100755
index 00000000000..f6d2d7483a1
--- /dev/null
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_2.sh
@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+DATA_FILE=$CURDIR/test_$CLICKHOUSE_TEST_UNIQUE_NAME.data
+
+for format in TSVWithNamesAndTypes TSVRawWithNamesAndTypes CSVWithNamesAndTypes JSONCompactEachRowWithNamesAndTypes JSONCompactStringsEachRowWithNamesAndTypes RowBinaryWithNamesAndTypes CustomSeparatedWithNamesAndTypes
+do
+    echo $format
+    $CLICKHOUSE_LOCAL -q "select toInt8(-number) as int8, toUInt8(number) as uint8, toInt16(-number) as int16, toUInt16(number) as uint16, toInt32(-number) as int32, toUInt32(number) as uint32, toInt64(-number) as int64, toUInt64(number) as uint64 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select toFloat32(number * 1.2) as float32, toFloat64(number / 1.3) as float64, toDecimal32(number / 0.3, 5) as decimal32, toDecimal64(number / 0.003, 5) as decimal64 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select toDate(number) as date, toDate32(number) as date32 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select concat('Str: ', toString(number)) as str, toFixedString(toString((number + 1) * 100 % 1000), 3) as fixed_string from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+ 
+    $CLICKHOUSE_LOCAL -q "select [number, number + 1] as array, (number, toString(number)) as tuple, map(toString(number), number) as map from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+
+    $CLICKHOUSE_LOCAL -q "select [([number, number + 1], map('42', number)), ([], map()), ([42], map('42', 42))] as nested1, (([[number], [number + 1], []], map(number, [(number, '42'), (number + 1, '42')])), 42) as nested2 from numbers(2) format $format" > $DATA_FILE
+    $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', '$format')"
+    $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', '$format')"
+done
+
+rm $DATA_FILE
+
diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference
new file mode 100644
index 00000000000..caa6e99c224
--- /dev/null
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference
@@ -0,0 +1,27 @@
+Avro
+
+int8	Int32					
+uint8	Int32					
+int16	Int32					
+uint16	Int32					
+int32	Int32					
+uint32	Int32					
+int64	Int64					
+uint64	Int64					
+0	0	0	0	0	0	0	0
+-1	1	-1	1	-1	1	-1	1
+float32	Float32					
+float64	Float64					
+0	0
+1.2	0.7692307692307692
+date	Date32					
+1970-01-01
+1970-01-02
+str	String					
+fixed_string	FixedString(3)					
+Str: 0	100
+Str: 1	200
+array	Array(Int64)					
+nested	Array(Array(Array(Int64)))					
+[0,1]	[[[0],[1]]]
+[1,2]	[[[1],[2]]]
diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh
new file mode 100755
index 00000000000..6ac530abf99
--- /dev/null
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh
@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# Tags: no-fasttest
+
+CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck source=../shell_config.sh
+. "$CURDIR"/../shell_config.sh
+
+DATA_FILE=$CURDIR/test_$CLICKHOUSE_TEST_UNIQUE_NAME.data
+
+echo "Avro"
+
+echo $format
+$CLICKHOUSE_LOCAL -q "select toInt8(-number) as int8, toUInt8(number) as uint8, toInt16(-number) as int16, toUInt16(number) as uint16, toInt32(-number) as int32, toUInt32(number) as uint32, toInt64(-number) as int64, toUInt64(number) as uint64 from numbers(2) format Avro" > $DATA_FILE
+$CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', 'Avro')"
+$CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', 'Avro')"
+
+$CLICKHOUSE_LOCAL -q "select toFloat32(number * 1.2) as float32, toFloat64(number / 1.3) as float64 from numbers(2) format Avro" > $DATA_FILE
+$CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', 'Avro')"
+$CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', 'Avro')"
+
+$CLICKHOUSE_LOCAL -q "select toDate(number) as date from numbers(2) format Avro" > $DATA_FILE
+$CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', 'Avro')"
+$CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', 'Avro')"
+
+$CLICKHOUSE_LOCAL -q "select concat('Str: ', toString(number)) as str, toFixedString(toString((number + 1) * 100 % 1000), 3) as fixed_string from numbers(2) format Avro" > $DATA_FILE
+$CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', 'Avro')"
+$CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', 'Avro')"
+ 
+$CLICKHOUSE_LOCAL -q "select [number, number + 1] as array, [[[number], [number + 1]]] as nested from numbers(2) format Avro" > $DATA_FILE
+$CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', 'Avro')"
+$CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', 'Avro')"
+
+rm $DATA_FILE
+

From c6ada111a31438aac10d8ca44366746a97073a8b Mon Sep 17 00:00:00 2001
From: avogar <avogar@clickhouse.com>
Date: Tue, 20 Jun 2023 16:38:47 +0000
Subject: [PATCH 608/722] Delete old test

---
 ...ma_inference_formats_with_schema.reference | 435 ------------------
 ...49_schema_inference_formats_with_schema.sh |  65 ---
 2 files changed, 500 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02149_schema_inference_formats_with_schema.reference
 delete mode 100755 tests/queries/0_stateless/02149_schema_inference_formats_with_schema.sh

diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema.reference b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema.reference
deleted file mode 100644
index 9a7a1611a7b..00000000000
--- a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema.reference
+++ /dev/null
@@ -1,435 +0,0 @@
-Arrow
-int8	Nullable(Int8)					
-uint8	Nullable(UInt8)					
-int16	Nullable(Int16)					
-uint16	Nullable(UInt16)					
-int32	Nullable(Int32)					
-uint32	Nullable(UInt32)					
-int64	Nullable(Int64)					
-uint64	Nullable(UInt64)					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Nullable(Float32)					
-float64	Nullable(Float64)					
-decimal32	Nullable(Decimal(9, 5))					
-decimal64	Nullable(Decimal(18, 5))					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Nullable(UInt16)					
-date32	Nullable(Date32)					
-0	1970-01-01
-1	1970-01-02
-str	Nullable(String)					
-fixed_string	Nullable(FixedString(3))					
-Str: 0	100
-Str: 1	200
-array	Array(Nullable(UInt64))					
-tuple	Tuple(`1` Nullable(UInt64), `2` Nullable(String))					
-map	Map(String, Nullable(UInt64))					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(`1` Array(Nullable(UInt64)), `2` Map(String, Nullable(UInt64))))					
-nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(UInt64))), `2` Map(UInt64, Array(Tuple(`1` Nullable(UInt64), `2` Nullable(String))))), `2` Nullable(UInt8))					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-ArrowStream
-int8	Nullable(Int8)					
-uint8	Nullable(UInt8)					
-int16	Nullable(Int16)					
-uint16	Nullable(UInt16)					
-int32	Nullable(Int32)					
-uint32	Nullable(UInt32)					
-int64	Nullable(Int64)					
-uint64	Nullable(UInt64)					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Nullable(Float32)					
-float64	Nullable(Float64)					
-decimal32	Nullable(Decimal(9, 5))					
-decimal64	Nullable(Decimal(18, 5))					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Nullable(UInt16)					
-date32	Nullable(Date32)					
-0	1970-01-01
-1	1970-01-02
-str	Nullable(String)					
-fixed_string	Nullable(FixedString(3))					
-Str: 0	100
-Str: 1	200
-array	Array(Nullable(UInt64))					
-tuple	Tuple(`1` Nullable(UInt64), `2` Nullable(String))					
-map	Map(String, Nullable(UInt64))					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(`1` Array(Nullable(UInt64)), `2` Map(String, Nullable(UInt64))))					
-nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(UInt64))), `2` Map(UInt64, Array(Tuple(`1` Nullable(UInt64), `2` Nullable(String))))), `2` Nullable(UInt8))					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-Parquet
-int8	Nullable(Int8)					
-uint8	Nullable(UInt8)					
-int16	Nullable(Int16)					
-uint16	Nullable(UInt16)					
-int32	Nullable(Int32)					
-uint32	Nullable(UInt32)					
-int64	Nullable(Int64)					
-uint64	Nullable(UInt64)					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Nullable(Float32)					
-float64	Nullable(Float64)					
-decimal32	Nullable(Decimal(9, 5))					
-decimal64	Nullable(Decimal(18, 5))					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Nullable(UInt16)					
-date32	Nullable(Date32)					
-0	1970-01-01
-1	1970-01-02
-str	Nullable(String)					
-fixed_string	Nullable(FixedString(3))					
-Str: 0	100
-Str: 1	200
-array	Array(Nullable(UInt64))					
-tuple	Tuple(`1` Nullable(UInt64), `2` Nullable(String))					
-map	Map(String, Nullable(UInt64))					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(`1` Array(Nullable(UInt64)), `2` Map(String, Nullable(UInt64))))					
-nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(UInt64))), `2` Map(UInt64, Array(Tuple(`1` Nullable(UInt64), `2` Nullable(String))))), `2` Nullable(UInt8))					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-ORC
-int8	Nullable(Int8)					
-uint8	Nullable(Int8)					
-int16	Nullable(Int16)					
-uint16	Nullable(Int16)					
-int32	Nullable(Int32)					
-uint32	Nullable(Int32)					
-int64	Nullable(Int64)					
-uint64	Nullable(Int64)					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Nullable(Float32)					
-float64	Nullable(Float64)					
-decimal32	Nullable(Decimal(9, 5))					
-decimal64	Nullable(Decimal(18, 5))					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Nullable(Date32)					
-date32	Nullable(Date32)					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	Nullable(String)					
-fixed_string	Nullable(String)					
-Str: 0	100
-Str: 1	200
-array	Array(Nullable(Int64))					
-tuple	Tuple(`1` Nullable(Int64), `2` Nullable(String))					
-map	Map(String, Nullable(Int64))					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(`1` Array(Nullable(Int64)), `2` Map(String, Nullable(Int64))))					
-nested2	Tuple(`1` Tuple(`1` Array(Array(Nullable(Int64))), `2` Map(Int64, Array(Tuple(`1` Nullable(Int64), `2` Nullable(String))))), `2` Nullable(Int8))					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-Native
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-TSVWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-TSVRawWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-CSVWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-JSONCompactEachRowWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-JSONCompactStringsEachRowWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-RowBinaryWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-CustomSeparatedWithNamesAndTypes
-int8	Int8					
-uint8	UInt8					
-int16	Int16					
-uint16	UInt16					
-int32	Int32					
-uint32	UInt32					
-int64	Int64					
-uint64	UInt64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-decimal32	Decimal(9, 5)					
-decimal64	Decimal(18, 5)					
-0	0	0	0
-1.2	0.7692307692307692	3.33333	333.33333
-date	Date					
-date32	Date32					
-1970-01-01	1970-01-01
-1970-01-02	1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(UInt64)					
-tuple	Tuple(UInt64, String)					
-map	Map(String, UInt64)					
-[0,1]	(0,'0')	{'0':0}
-[1,2]	(1,'1')	{'1':1}
-nested1	Array(Tuple(Array(UInt64), Map(String, UInt64)))					
-nested2	Tuple(Tuple(Array(Array(UInt64)), Map(UInt64, Array(Tuple(UInt64, String)))), UInt8)					
-[([0,1],{'42':0}),([],{}),([42],{'42':42})]	(([[0],[1],[]],{0:[(0,'42'),(1,'42')]}),42)
-[([1,2],{'42':1}),([],{}),([42],{'42':42})]	(([[1],[2],[]],{1:[(1,'42'),(2,'42')]}),42)
-Avro
-CustomSeparatedWithNamesAndTypes
-int8	Int32					
-uint8	Int32					
-int16	Int32					
-uint16	Int32					
-int32	Int32					
-uint32	Int32					
-int64	Int64					
-uint64	Int64					
-0	0	0	0	0	0	0	0
--1	1	-1	1	-1	1	-1	1
-float32	Float32					
-float64	Float64					
-0	0
-1.2	0.7692307692307692
-date	Date32					
-1970-01-01
-1970-01-02
-str	String					
-fixed_string	FixedString(3)					
-Str: 0	100
-Str: 1	200
-array	Array(Int64)					
-nested	Array(Array(Array(Int64)))					
-[0,1]	[[[0],[1]]]
-[1,2]	[[[1],[2]]]
diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema.sh b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema.sh
deleted file mode 100755
index cf5a086fb5e..00000000000
--- a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema.sh
+++ /dev/null
@@ -1,65 +0,0 @@
-#!/usr/bin/env bash
-# Tags: no-parallel, no-fasttest
-
-CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
-# shellcheck source=../shell_config.sh
-. "$CURDIR"/../shell_config.sh
-
-
-USER_FILES_PATH=$(clickhouse-client --query "select _path,_file from file('nonexist.txt', 'CSV', 'val1 char')" 2>&1 | grep Exception | awk '{gsub("/nonexist.txt","",$9); print $9}')
-FILE_NAME=test_$CLICKHOUSE_TEST_UNIQUE_NAME.data
-DATA_FILE=$USER_FILES_PATH/$FILE_NAME
-
-for format in Arrow ArrowStream Parquet ORC Native TSVWithNamesAndTypes TSVRawWithNamesAndTypes CSVWithNamesAndTypes JSONCompactEachRowWithNamesAndTypes JSONCompactStringsEachRowWithNamesAndTypes RowBinaryWithNamesAndTypes CustomSeparatedWithNamesAndTypes
-do
-    echo $format
-    $CLICKHOUSE_CLIENT -q "select toInt8(-number) as int8, toUInt8(number) as uint8, toInt16(-number) as int16, toUInt16(number) as uint16, toInt32(-number) as int32, toUInt32(number) as uint32, toInt64(-number) as int64, toUInt64(number) as uint64 from numbers(2) format $format" > $DATA_FILE
-    $CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', '$format')"
-    $CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', '$format')"
-
-    $CLICKHOUSE_CLIENT -q "select toFloat32(number * 1.2) as float32, toFloat64(number / 1.3) as float64, toDecimal32(number / 0.3, 5) as decimal32, toDecimal64(number / 0.003, 5) as decimal64 from numbers(2) format $format" > $DATA_FILE
-    $CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', '$format')"
-    $CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', '$format')"
-
-    $CLICKHOUSE_CLIENT -q "select toDate(number) as date, toDate32(number) as date32 from numbers(2) format $format" > $DATA_FILE
-    $CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', '$format')"
-    $CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', '$format')"
-
-    $CLICKHOUSE_CLIENT -q "select concat('Str: ', toString(number)) as str, toFixedString(toString((number + 1) * 100 % 1000), 3) as fixed_string from numbers(2) format $format" > $DATA_FILE
-    $CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', '$format')"
-    $CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', '$format')"
- 
-    $CLICKHOUSE_CLIENT -q "select [number, number + 1] as array, (number, toString(number)) as tuple, map(toString(number), number) as map from numbers(2) format $format" > $DATA_FILE
-    $CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', '$format')"
-    $CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', '$format')"
-
-    $CLICKHOUSE_CLIENT -q "select [([number, number + 1], map('42', number)), ([], map()), ([42], map('42', 42))] as nested1, (([[number], [number + 1], []], map(number, [(number, '42'), (number + 1, '42')])), 42) as nested2 from numbers(2) format $format" > $DATA_FILE
-    $CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', '$format')"
-    $CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', '$format')"
-done
-
-echo "Avro"
-
-echo $format
-$CLICKHOUSE_CLIENT -q "select toInt8(-number) as int8, toUInt8(number) as uint8, toInt16(-number) as int16, toUInt16(number) as uint16, toInt32(-number) as int32, toUInt32(number) as uint32, toInt64(-number) as int64, toUInt64(number) as uint64 from numbers(2) format Avro" > $DATA_FILE
-$CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', 'Avro')"
-$CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', 'Avro')"
-
-$CLICKHOUSE_CLIENT -q "select toFloat32(number * 1.2) as float32, toFloat64(number / 1.3) as float64 from numbers(2) format Avro" > $DATA_FILE
-$CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', 'Avro')"
-$CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', 'Avro')"
-
-$CLICKHOUSE_CLIENT -q "select toDate(number) as date from numbers(2) format Avro" > $DATA_FILE
-$CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', 'Avro')"
-$CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', 'Avro')"
-
-$CLICKHOUSE_CLIENT -q "select concat('Str: ', toString(number)) as str, toFixedString(toString((number + 1) * 100 % 1000), 3) as fixed_string from numbers(2) format Avro" > $DATA_FILE
-$CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', 'Avro')"
-$CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', 'Avro')"
- 
-$CLICKHOUSE_CLIENT -q "select [number, number + 1] as array, [[[number], [number + 1]]] as nested from numbers(2) format Avro" > $DATA_FILE
-$CLICKHOUSE_CLIENT -q "desc file('$FILE_NAME', 'Avro')"
-$CLICKHOUSE_CLIENT -q "select * from file('$FILE_NAME', 'Avro')"
-
-rm $DATA_FILE
-

From 9e324b4ebaff87e7eb3ee503abddbcf4d9fc6641 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 20 Jun 2023 13:41:11 -0300
Subject: [PATCH 609/722] Update skipping-index.md

---
 .../statements/alter/skipping-index.md           | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/docs/en/sql-reference/statements/alter/skipping-index.md b/docs/en/sql-reference/statements/alter/skipping-index.md
index 4194731d33a..2d53791d0dd 100644
--- a/docs/en/sql-reference/statements/alter/skipping-index.md
+++ b/docs/en/sql-reference/statements/alter/skipping-index.md
@@ -10,15 +10,21 @@ sidebar_label: INDEX
 
 The following operations are available:
 
-- `ALTER TABLE [db].table_name [ON CLUSTER cluster] ADD INDEX name expression TYPE type [GRANULARITY value] [FIRST|AFTER name]` - Adds index description to tables metadata.
+## ADD INDEX
 
-- `ALTER TABLE [db].table_name [ON CLUSTER cluster] DROP INDEX name` - Removes index description from tables metadata and deletes index files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db].table_name [ON CLUSTER cluster] ADD INDEX name expression TYPE type [GRANULARITY value] [FIRST|AFTER name]` - Adds index description to tables metadata.
 
-- `ALTER TABLE [db.]table_name [ON CLUSTER cluster] MATERIALIZE INDEX name [IN PARTITION partition_name]` - Rebuilds the secondary index `name` for the specified `partition_name`. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations). If `IN PARTITION` part is omitted then it rebuilds the index for the whole table data.
+## DROP INDEX
 
-The first two commands are lightweight in a sense that they only change metadata or remove files.
+`ALTER TABLE [db].table_name [ON CLUSTER cluster] DROP INDEX name` - Removes index description from tables metadata and deletes index files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
-Also, they are replicated, syncing indices metadata via ZooKeeper.
+## MATERIALIZE INDEX
+
+`ALTER TABLE [db.]table_name [ON CLUSTER cluster] MATERIALIZE INDEX name [IN PARTITION partition_name]` - Rebuilds the secondary index `name` for the specified `partition_name`. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations). If `IN PARTITION` part is omitted then it rebuilds the index for the whole table data.
+
+The `ADD` and `DROP` commands are lightweight in a sense that they only change metadata or remove files.
+
+Also, they are replicated, syncing indices metadata via ClickHouse Keeper or ZooKeeper.
 
 :::note    
 Index manipulation is supported only for tables with [`*MergeTree`](/docs/en/engines/table-engines/mergetree-family/mergetree.md) engine (including [replicated](/docs/en/engines/table-engines/mergetree-family/replication.md) variants).

From fe8fbde909519debff544d53f58a97d1a185e8cc Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 20 Jun 2023 13:46:55 -0300
Subject: [PATCH 610/722] Update index.md

---
 docs/en/sql-reference/statements/alter/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/alter/index.md b/docs/en/sql-reference/statements/alter/index.md
index 7a687a067aa..7dadc2be5b2 100644
--- a/docs/en/sql-reference/statements/alter/index.md
+++ b/docs/en/sql-reference/statements/alter/index.md
@@ -60,7 +60,7 @@ You can specify how long (in seconds) to wait for inactive replicas to execute a
 For all `ALTER` queries, if `alter_sync = 2` and some replicas are not active for more than the time, specified in the `replication_wait_for_inactive_replica_timeout` setting, then an exception `UNFINISHED` is thrown.
 :::
 
-For `ALTER TABLE ... UPDATE|DELETE` queries the synchronicity is defined by the [mutations_sync](/docs/en/operations/settings/settings.md/#mutations_sync) setting.
+For `ALTER TABLE ... UPDATE|DELETE|MATERIALIZE INDEX|MATERIALIZE PROJECTION|MATERIALIZE COLUMN` queries the synchronicity is defined by the [mutations_sync](/docs/en/operations/settings/settings.md/#mutations_sync) setting.
 
 ## Related content
 

From 82e770bf9a63230936bfb328f4dbd083e32ce2b2 Mon Sep 17 00:00:00 2001
From: Justin de Guzman <justin@justindeguzman.net>
Date: Tue, 20 Jun 2023 09:48:40 -0700
Subject: [PATCH 611/722] SQL Console must use users with default role for
 dicts

Co-authored-by: Dan Roscigno <dan@roscigno.com>
---
 docs/en/sql-reference/statements/create/dictionary.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/create/dictionary.md b/docs/en/sql-reference/statements/create/dictionary.md
index 19087384876..092d51a64f7 100644
--- a/docs/en/sql-reference/statements/create/dictionary.md
+++ b/docs/en/sql-reference/statements/create/dictionary.md
@@ -83,7 +83,7 @@ LAYOUT(FLAT())
 ```
 
 :::note
-When using the SQL console in [ClickHouse Cloud](https://clickhouse.com), you must specify a user (`default` or any other user) and password when creating a dictionary.
+When using the SQL console in [ClickHouse Cloud](https://clickhouse.com), you must specify a user (`default` or any other user with the role `default_role`) and password when creating a dictionary.
 :::note
 
 ```sql

From 2718dab7faa747983b2bd71c321caefe23a36e45 Mon Sep 17 00:00:00 2001
From: Justin de Guzman <justin@justindeguzman.net>
Date: Tue, 20 Jun 2023 09:49:48 -0700
Subject: [PATCH 612/722] Specify database when creating dicts in docs

Co-authored-by: Dan Roscigno <dan@roscigno.com>
---
 docs/en/sql-reference/statements/create/dictionary.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/en/sql-reference/statements/create/dictionary.md b/docs/en/sql-reference/statements/create/dictionary.md
index 092d51a64f7..9cc56dc1b85 100644
--- a/docs/en/sql-reference/statements/create/dictionary.md
+++ b/docs/en/sql-reference/statements/create/dictionary.md
@@ -87,6 +87,8 @@ When using the SQL console in [ClickHouse Cloud](https://clickhouse.com), you mu
 :::note
 
 ```sql
+CREATE DATABASE foo_db;
+
 CREATE TABLE foo_db.source_table (
     id UInt64,
     value String

From 62044d30794528d7608b163bc7cbd7656e5fa518 Mon Sep 17 00:00:00 2001
From: Justin de Guzman <justin@justindeguzman.net>
Date: Tue, 20 Jun 2023 09:50:49 -0700
Subject: [PATCH 613/722] Add info on creating users when creating dicts in SQL
 Console

Co-authored-by: Dan Roscigno <dan@roscigno.com>
---
 docs/en/sql-reference/statements/create/dictionary.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/en/sql-reference/statements/create/dictionary.md b/docs/en/sql-reference/statements/create/dictionary.md
index 9cc56dc1b85..d4a3b54f130 100644
--- a/docs/en/sql-reference/statements/create/dictionary.md
+++ b/docs/en/sql-reference/statements/create/dictionary.md
@@ -87,6 +87,11 @@ When using the SQL console in [ClickHouse Cloud](https://clickhouse.com), you mu
 :::note
 
 ```sql
+CREATE USER IF NOT EXISTS clickhouse_admin
+IDENTIFIED WITH sha256_password BY 'passworD43$x';
+
+GRANT default_role TO clickhouse_admin;
+
 CREATE DATABASE foo_db;
 
 CREATE TABLE foo_db.source_table (

From af4159e71eabf9b21413cfcd0f37142e3b84fd9a Mon Sep 17 00:00:00 2001
From: Justin de Guzman <justin@justindeguzman.net>
Date: Tue, 20 Jun 2023 09:51:11 -0700
Subject: [PATCH 614/722] Use better user/pw examples for docs when creating
 dicts in SQL Console

Co-authored-by: Dan Roscigno <dan@roscigno.com>
---
 docs/en/sql-reference/statements/create/dictionary.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/create/dictionary.md b/docs/en/sql-reference/statements/create/dictionary.md
index d4a3b54f130..c0a153c5660 100644
--- a/docs/en/sql-reference/statements/create/dictionary.md
+++ b/docs/en/sql-reference/statements/create/dictionary.md
@@ -106,7 +106,7 @@ CREATE DICTIONARY foo_db.id_value_dictionary
     value String
 )
 PRIMARY KEY id
-SOURCE(CLICKHOUSE(TABLE 'source_table' USER 'foo_user' PASSWORD 'foo_user_complex_password' DB 'foo_db' ))
+SOURCE(CLICKHOUSE(TABLE 'source_table' USER 'clickhouse_admin' PASSWORD 'passworD43$x' DB 'foo_db' ))
 LAYOUT(FLAT())
 LIFETIME(MIN 0 MAX 1000);
 ```

From 2cca74df684b0def161aa4a4027114883c8cd31f Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 20 Jun 2023 13:56:34 -0300
Subject: [PATCH 615/722] Update skipping-index.md

---
 .../sql-reference/statements/alter/skipping-index.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/en/sql-reference/statements/alter/skipping-index.md b/docs/en/sql-reference/statements/alter/skipping-index.md
index 2d53791d0dd..7f7a5fb8a0b 100644
--- a/docs/en/sql-reference/statements/alter/skipping-index.md
+++ b/docs/en/sql-reference/statements/alter/skipping-index.md
@@ -12,18 +12,22 @@ The following operations are available:
 
 ## ADD INDEX
 
-`ALTER TABLE [db].table_name [ON CLUSTER cluster] ADD INDEX name expression TYPE type [GRANULARITY value] [FIRST|AFTER name]` - Adds index description to tables metadata.
+`ALTER TABLE [db.]table_name [ON CLUSTER cluster] ADD INDEX [IF NOT EXISTS] name expression TYPE type [GRANULARITY value] [FIRST|AFTER name]` - Adds index description to tables metadata.
 
 ## DROP INDEX
 
-`ALTER TABLE [db].table_name [ON CLUSTER cluster] DROP INDEX name` - Removes index description from tables metadata and deletes index files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db.]table_name [ON CLUSTER cluster] DROP INDEX [IF EXISTS] name` - Removes index description from tables metadata and deletes index files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 ## MATERIALIZE INDEX
 
-`ALTER TABLE [db.]table_name [ON CLUSTER cluster] MATERIALIZE INDEX name [IN PARTITION partition_name]` - Rebuilds the secondary index `name` for the specified `partition_name`. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations). If `IN PARTITION` part is omitted then it rebuilds the index for the whole table data.
+`ALTER TABLE [db.]table_name [ON CLUSTER cluster] MATERIALIZE INDEX [IF EXISTS] name [IN PARTITION partition_name]` - Rebuilds the secondary index `name` for the specified `partition_name`. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations). If `IN PARTITION` part is omitted then it rebuilds the index for the whole table data.
 
-The `ADD` and `DROP` commands are lightweight in a sense that they only change metadata or remove files.
+## CLEAR INDEX
 
+`ALTER TABLE [db.]table_name [ON CLUSTER cluster] CLEAR INDEX [IF EXISTS] name [IN PARTITION partition_name]` - Deletes the secondary index files from disk without removing description. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+
+
+The commands `ADD`, `DROP` and `CLEAR` are lightweight in a sense that they only change metadata or remove files.
 Also, they are replicated, syncing indices metadata via ClickHouse Keeper or ZooKeeper.
 
 :::note    

From ef65367ff02c05b116280cac7859ef91faa1df61 Mon Sep 17 00:00:00 2001
From: Denny Crane <denis.zhuravlov@gmail.com>
Date: Tue, 20 Jun 2023 13:59:18 -0300
Subject: [PATCH 616/722] Update projection.md

---
 docs/en/sql-reference/statements/alter/projection.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/en/sql-reference/statements/alter/projection.md b/docs/en/sql-reference/statements/alter/projection.md
index b7399442d41..fb438927089 100644
--- a/docs/en/sql-reference/statements/alter/projection.md
+++ b/docs/en/sql-reference/statements/alter/projection.md
@@ -142,19 +142,19 @@ The following operations with [projections](/docs/en/engines/table-engines/merge
 
 ## ADD PROJECTION
 
-`ALTER TABLE [db].name ADD PROJECTION [IF NOT EXISTS] name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )` - Adds projection description to tables metadata.
+`ALTER TABLE [db.]name [ON CLUSTER cluster] ADD PROJECTION [IF NOT EXISTS] name ( SELECT <COLUMN LIST EXPR> [GROUP BY] [ORDER BY] )` - Adds projection description to tables metadata.
 
 ## DROP PROJECTION
 
-`ALTER TABLE [db].name DROP PROJECTION [IF EXISTS] name` - Removes projection description from tables metadata and deletes projection files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db.]name [ON CLUSTER cluster] DROP PROJECTION [IF EXISTS] name` - Removes projection description from tables metadata and deletes projection files from disk. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 ## MATERIALIZE PROJECTION
 
-`ALTER TABLE [db.]table MATERIALIZE PROJECTION name IN PARTITION partition_name` - The query rebuilds the projection `name` in the partition `partition_name`. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db.]table [ON CLUSTER cluster] MATERIALIZE PROJECTION [IF EXISTS] name [IN PARTITION partition_name]` - The query rebuilds the projection `name` in the partition `partition_name`. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 ## CLEAR PROJECTION
 
-`ALTER TABLE [db.]table CLEAR PROJECTION [IF EXISTS] name IN PARTITION partition_name` - Deletes projection files from disk without removing description. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
+`ALTER TABLE [db.]table [ON CLUSTER cluster] CLEAR PROJECTION [IF EXISTS] name [IN PARTITION partition_name]` - Deletes projection files from disk without removing description. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 
 The commands `ADD`, `DROP` and `CLEAR` are lightweight in a sense that they only change metadata or remove files.

From 29f6ce871d339e660e9a8f21e252b97c8bc2f7ef Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Tue, 20 Jun 2023 19:00:41 +0200
Subject: [PATCH 617/722] Avoid initializing DateLUT from emptyArray function
 registration

---
 src/Functions/array/emptyArray.cpp | 38 ++++++++++++++++++------------
 1 file changed, 23 insertions(+), 15 deletions(-)

diff --git a/src/Functions/array/emptyArray.cpp b/src/Functions/array/emptyArray.cpp
index aeb7f83c6c5..c9b5c46b19e 100644
--- a/src/Functions/array/emptyArray.cpp
+++ b/src/Functions/array/emptyArray.cpp
@@ -17,11 +17,12 @@ namespace DB
 namespace
 {
 
-template <typename DataType>
+template <typename DataType, const char * FunctionName>
 class FunctionEmptyArray : public IFunction
 {
 public:
-    static String getNameImpl() { return "emptyArray" + DataType().getName(); }
+    /// NOTE: Not using DataType().getName() because DataType ctor might be very heavy (e.g. for DataTypeDateTime as it initializes DateLUT singleton).
+    static String getNameImpl() { return FunctionName; }
     static FunctionPtr create(ContextPtr) { return std::make_shared<FunctionEmptyArray>(); }
 
 private:
@@ -57,19 +58,26 @@ void registerFunction(FunctionFactory & factory)
 
 REGISTER_FUNCTION(EmptyArray)
 {
-    registerFunction<FunctionEmptyArray<DataTypeUInt8>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeUInt16>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeUInt32>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeUInt64>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeInt8>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeInt16>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeInt32>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeInt64>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeFloat32>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeFloat64>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeDate>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeDateTime>>(factory);
-    registerFunction<FunctionEmptyArray<DataTypeString>>(factory);
+
+#define REGISTER_EMPTY_ARRAY_FUNCTION(TYPE) \
+    do { \
+        static const char name[] = "emptyArray" #TYPE; \
+       registerFunction<FunctionEmptyArray<DataType##TYPE, name>>(factory); \
+    } while(0)
+
+    REGISTER_EMPTY_ARRAY_FUNCTION(UInt8);
+    REGISTER_EMPTY_ARRAY_FUNCTION(UInt16);
+    REGISTER_EMPTY_ARRAY_FUNCTION(UInt32);
+    REGISTER_EMPTY_ARRAY_FUNCTION(UInt64);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Int8);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Int16);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Int32);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Int64);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Float32);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Float64);
+    REGISTER_EMPTY_ARRAY_FUNCTION(Date);
+    REGISTER_EMPTY_ARRAY_FUNCTION(DateTime);
+    REGISTER_EMPTY_ARRAY_FUNCTION(String);
 }
 
 }

From 513b28b451bf32de986815d949b2c1ccbb3ebe68 Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Tue, 20 Jun 2023 13:49:16 -0400
Subject: [PATCH 618/722] Update
 docs/en/sql-reference/statements/alter/skipping-index.md

---
 docs/en/sql-reference/statements/alter/skipping-index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/alter/skipping-index.md b/docs/en/sql-reference/statements/alter/skipping-index.md
index 7f7a5fb8a0b..42fd12d9487 100644
--- a/docs/en/sql-reference/statements/alter/skipping-index.md
+++ b/docs/en/sql-reference/statements/alter/skipping-index.md
@@ -27,7 +27,7 @@ The following operations are available:
 `ALTER TABLE [db.]table_name [ON CLUSTER cluster] CLEAR INDEX [IF EXISTS] name [IN PARTITION partition_name]` - Deletes the secondary index files from disk without removing description. Implemented as a [mutation](/docs/en/sql-reference/statements/alter/index.md#mutations).
 
 
-The commands `ADD`, `DROP` and `CLEAR` are lightweight in a sense that they only change metadata or remove files.
+The commands `ADD`, `DROP`, and `CLEAR` are lightweight in the sense that they only change metadata or remove files.
 Also, they are replicated, syncing indices metadata via ClickHouse Keeper or ZooKeeper.
 
 :::note    

From fd292dc730ad54822081db0ae3341303f3e1c4bf Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Mon, 19 Jun 2023 23:33:37 +0200
Subject: [PATCH 619/722] work with comment on the PR

---
 src/IO/CascadeWriteBuffer.cpp                          | 10 ++++++++++
 src/IO/CascadeWriteBuffer.h                            |  2 +-
 .../Formats/Impl/ParallelFormattingOutputFormat.cpp    |  1 +
 src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp | 10 +++++-----
 .../MergeTree/MergeTreeDataPartWriterOnDisk.cpp        |  5 +++++
 5 files changed, 22 insertions(+), 6 deletions(-)

diff --git a/src/IO/CascadeWriteBuffer.cpp b/src/IO/CascadeWriteBuffer.cpp
index f577c729815..305825b9fd8 100644
--- a/src/IO/CascadeWriteBuffer.cpp
+++ b/src/IO/CascadeWriteBuffer.cpp
@@ -69,6 +69,16 @@ void CascadeWriteBuffer::getResultBuffers(WriteBufferPtrs & res)
     lazy_sources.clear();
 }
 
+void CascadeWriteBuffer::finalizeImpl()
+{
+    for (auto & buf : prepared_sources)
+    {
+        if (buf)
+        {
+            buf->finalize();
+        }
+    }
+}
 
 WriteBuffer * CascadeWriteBuffer::setNextBuffer()
 {
diff --git a/src/IO/CascadeWriteBuffer.h b/src/IO/CascadeWriteBuffer.h
index db491d79d81..a003d11bd8a 100644
--- a/src/IO/CascadeWriteBuffer.h
+++ b/src/IO/CascadeWriteBuffer.h
@@ -47,7 +47,7 @@ public:
 
 private:
 
-    void finalizeImpl() override { /* no op */ }
+    void finalizeImpl() override;
 
     WriteBuffer * setNextBuffer();
 
diff --git a/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp b/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp
index 212a404825d..46fe2ba26a8 100644
--- a/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp
+++ b/src/Processors/Formats/Impl/ParallelFormattingOutputFormat.cpp
@@ -224,6 +224,7 @@ namespace DB
 
             /// Flush all the data to handmade buffer.
             formatter->flush();
+            formatter->finalizeBuffers();
             out_buffer.finalize();
             unit.actual_memory_size = out_buffer.getActualSize();
 
diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index db39fd84137..c4473ec96cf 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -136,7 +136,7 @@ bool MergeTreeBackgroundExecutor<Queue>::trySchedule(ExecutableTaskPtr task)
     return true;
 }
 
-void print_exception_with_respect_to_abort(Poco::Logger * log)
+void printExceptionWithRespectToAbort(Poco::Logger * log)
 {
     std::exception_ptr ex = std::current_exception();
 
@@ -182,7 +182,7 @@ void MergeTreeBackgroundExecutor<Queue>::removeTasksCorrespondingToStorage(Stora
         }
         catch (...)
         {
-            print_exception_with_respect_to_abort(log);
+            printExceptionWithRespectToAbort(log);
             pending.remove(id);
         }
 
@@ -257,7 +257,7 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
         }
         catch (...)
         {
-            print_exception_with_respect_to_abort(log);
+            printExceptionWithRespectToAbort(log);
         }
 
         on_task_done(std::move(item_));
@@ -272,7 +272,7 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
     }
     catch (...)
     {
-        print_exception_with_respect_to_abort(log);
+        printExceptionWithRespectToAbort(log);
         /// Release the task with exception context.
         /// An exception context is needed to proper delete write buffers without finalization
         release_task(std::move(item));
@@ -299,7 +299,7 @@ void MergeTreeBackgroundExecutor<Queue>::routine(TaskRuntimeDataPtr item)
             }
             catch (...)
             {
-                print_exception_with_respect_to_abort(log);
+                printExceptionWithRespectToAbort(log);
                 on_task_done(std::move(item));
                 return;
             }
diff --git a/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp b/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
index a28778b6fff..f57ffa5ee14 100644
--- a/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
+++ b/src/Storages/MergeTree/MergeTreeDataPartWriterOnDisk.cpp
@@ -13,6 +13,11 @@ namespace ErrorCodes
 
 void MergeTreeDataPartWriterOnDisk::Stream::preFinalize()
 {
+    /// Here the main goal is to do preFinalize calls for plain_file and marks_file
+    /// Before that all hashing and compression buffers have to be finalized
+    /// Otherwise some data might stuck in the buffers above plain_file and marks_file
+    /// Also the order is important
+
     compressed_hashing.finalize();
     compressor.finalize();
     plain_hashing.finalize();

From ced1ae72879c06d742f91d5edeeb9594fcd21e36 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Tue, 20 Jun 2023 21:20:25 +0300
Subject: [PATCH 620/722] Update emptyArray.cpp

---
 src/Functions/array/emptyArray.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/Functions/array/emptyArray.cpp b/src/Functions/array/emptyArray.cpp
index c9b5c46b19e..56c218279b9 100644
--- a/src/Functions/array/emptyArray.cpp
+++ b/src/Functions/array/emptyArray.cpp
@@ -60,9 +60,10 @@ REGISTER_FUNCTION(EmptyArray)
 {
 
 #define REGISTER_EMPTY_ARRAY_FUNCTION(TYPE) \
-    do { \
+    do \
+    { \
         static const char name[] = "emptyArray" #TYPE; \
-       registerFunction<FunctionEmptyArray<DataType##TYPE, name>>(factory); \
+        registerFunction<FunctionEmptyArray<DataType##TYPE, name>>(factory); \
     } while(0)
 
     REGISTER_EMPTY_ARRAY_FUNCTION(UInt8);

From f973bd7516b53f0955fedd9a897243c25d6cf5e2 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Tue, 20 Jun 2023 23:53:32 +0200
Subject: [PATCH 621/722] suppress check for covered parts in zk

---
 docker/test/upgrade/run.sh                   |  7 ++++
 src/Storages/StorageReplicatedMergeTree.cpp  | 36 ++++++++++++--------
 tests/config/config.d/lost_forever_check.xml |  4 +++
 tests/config/config.d/merge_tree.xml         |  2 --
 tests/config/install.sh                      |  1 +
 5 files changed, 34 insertions(+), 16 deletions(-)
 create mode 100644 tests/config/config.d/lost_forever_check.xml

diff --git a/docker/test/upgrade/run.sh b/docker/test/upgrade/run.sh
index da2d1172f18..e72c28b7167 100644
--- a/docker/test/upgrade/run.sh
+++ b/docker/test/upgrade/run.sh
@@ -119,6 +119,13 @@ mv /var/log/clickhouse-server/clickhouse-server.log /var/log/clickhouse-server/c
 install_packages package_folder
 export ZOOKEEPER_FAULT_INJECTION=1
 configure
+
+# Just in case previous version left some garbage in zk
+sudo cat /etc/clickhouse-server/config.d/lost_forever_check.xml \
+  | sed "s|>1<|>0<|g" \
+  > /etc/clickhouse-server/config.d/lost_forever_check.xml.tmp
+sudo mv /etc/clickhouse-server/config.d/lost_forever_check.xml.tmp /etc/clickhouse-server/config.d/lost_forever_check.xml
+
 start 500
 clickhouse-client --query "SELECT 'Server successfully started', 'OK', NULL, ''" >> /test_output/test_results.tsv \
     || (rg --text "<Error>.*Application" /var/log/clickhouse-server/clickhouse-server.log > /test_output/application_errors.txt \
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index 7cf37d6765e..b362b5e3067 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -1255,6 +1255,10 @@ static void paranoidCheckForCoveredPartsInZooKeeperOnStart(const StorageReplicat
     if (!paranoid_check_for_covered_parts)
         return;
 
+    /// FIXME https://github.com/ClickHouse/ClickHouse/issues/51182
+    if (storage->getSettings()->use_metadata_cache)
+        return;
+
     ActiveDataPartSet active_set(format_version);
     for (const auto & part_name : parts_in_zk)
         active_set.add(part_name);
@@ -1992,7 +1996,7 @@ MutableDataPartStoragePtr StorageReplicatedMergeTree::executeFetchShared(
     }
 }
 
-static void paranoidCheckForCoveredPartsInZooKeeper(const ZooKeeperPtr & zookeeper, const String & replica_path,
+static void paranoidCheckForCoveredPartsInZooKeeper(const StorageReplicatedMergeTree * storage, const ZooKeeperPtr & zookeeper, const String & replica_path,
                                                     MergeTreeDataFormatVersion format_version, const String & covering_part_name)
 {
 #ifdef ABORT_ON_LOGICAL_ERROR
@@ -2003,17 +2007,21 @@ static void paranoidCheckForCoveredPartsInZooKeeper(const ZooKeeperPtr & zookeep
 
     bool paranoid_check_for_covered_parts = Context::getGlobalContextInstance()->getConfigRef().getBool(
         "replicated_merge_tree_paranoid_check_on_drop_range", paranoid_check_for_covered_parts_default);
-    if (paranoid_check_for_covered_parts)
+    if (!paranoid_check_for_covered_parts)
+        return;
+
+    /// FIXME https://github.com/ClickHouse/ClickHouse/issues/51182
+    if (storage->getSettings()->use_metadata_cache)
+        return;
+
+    auto drop_range_info = MergeTreePartInfo::fromPartName(covering_part_name, format_version);
+    Strings parts_remain = zookeeper->getChildren(replica_path + "/parts");
+    for (const auto & part_name : parts_remain)
     {
-        auto drop_range_info = MergeTreePartInfo::fromPartName(covering_part_name, format_version);
-        Strings parts_remain = zookeeper->getChildren(replica_path + "/parts");
-        for (const auto & part_name : parts_remain)
-        {
-            auto part_info = MergeTreePartInfo::fromPartName(part_name, format_version);
-            if (drop_range_info.contains(part_info))
-                throw Exception(ErrorCodes::LOGICAL_ERROR,
-                                "Part {} remains in ZooKeeper after DROP_RANGE {}", part_name, covering_part_name);
-        }
+        auto part_info = MergeTreePartInfo::fromPartName(part_name, format_version);
+        if (drop_range_info.contains(part_info))
+            throw Exception(ErrorCodes::LOGICAL_ERROR,
+                            "Part {} remains in ZooKeeper after DROP_RANGE {}", part_name, covering_part_name);
     }
 }
 
@@ -2072,7 +2080,7 @@ void StorageReplicatedMergeTree::executeDropRange(const LogEntry & entry)
 
     /// Forcibly remove parts from ZooKeeper
     removePartsFromZooKeeperWithRetries(parts_to_remove);
-    paranoidCheckForCoveredPartsInZooKeeper(getZooKeeper(), replica_path, format_version, entry.new_part_name);
+    paranoidCheckForCoveredPartsInZooKeeper(this, getZooKeeper(), replica_path, format_version, entry.new_part_name);
 
     if (entry.detach)
         LOG_DEBUG(log, "Detached {} parts inside {}.", parts_to_remove.size(), entry.new_part_name);
@@ -2209,7 +2217,7 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
         LOG_INFO(log, "All parts from REPLACE PARTITION command have been already attached");
         removePartsFromZooKeeperWithRetries(parts_to_remove);
         if (replace)
-            paranoidCheckForCoveredPartsInZooKeeper(getZooKeeper(), replica_path, format_version, entry_replace.drop_range_part_name);
+            paranoidCheckForCoveredPartsInZooKeeper(this, getZooKeeper(), replica_path, format_version, entry_replace.drop_range_part_name);
         return true;
     }
 
@@ -2510,7 +2518,7 @@ bool StorageReplicatedMergeTree::executeReplaceRange(const LogEntry & entry)
 
     removePartsFromZooKeeperWithRetries(parts_to_remove);
     if (replace)
-        paranoidCheckForCoveredPartsInZooKeeper(getZooKeeper(), replica_path, format_version, entry_replace.drop_range_part_name);
+        paranoidCheckForCoveredPartsInZooKeeper(this, getZooKeeper(), replica_path, format_version, entry_replace.drop_range_part_name);
     res_parts.clear();
     parts_to_remove.clear();
     cleanup_thread.wakeup();
diff --git a/tests/config/config.d/lost_forever_check.xml b/tests/config/config.d/lost_forever_check.xml
new file mode 100644
index 00000000000..a021d694dff
--- /dev/null
+++ b/tests/config/config.d/lost_forever_check.xml
@@ -0,0 +1,4 @@
+<clickhouse>
+    <replicated_merge_tree_paranoid_check_on_drop_range>1</replicated_merge_tree_paranoid_check_on_drop_range>
+    <replicated_merge_tree_paranoid_check_on_startup>1</replicated_merge_tree_paranoid_check_on_startup>
+</clickhouse>
diff --git a/tests/config/config.d/merge_tree.xml b/tests/config/config.d/merge_tree.xml
index 5ec577a0c52..2ac468673fa 100644
--- a/tests/config/config.d/merge_tree.xml
+++ b/tests/config/config.d/merge_tree.xml
@@ -5,6 +5,4 @@
         <max_cleanup_delay_period>60</max_cleanup_delay_period>
         <cleanup_thread_preferred_points_per_iteration>10</cleanup_thread_preferred_points_per_iteration>
     </merge_tree>
-
-    <replicated_merge_tree_paranoid_check_on_drop_range>1</replicated_merge_tree_paranoid_check_on_drop_range>
 </clickhouse>
diff --git a/tests/config/install.sh b/tests/config/install.sh
index b2153db1b2c..50f2627d37c 100755
--- a/tests/config/install.sh
+++ b/tests/config/install.sh
@@ -33,6 +33,7 @@ ln -sf $SRC_PATH/config.d/test_cluster_with_incorrect_pw.xml $DEST_SERVER_PATH/c
 ln -sf $SRC_PATH/config.d/keeper_port.xml $DEST_SERVER_PATH/config.d/
 ln -sf $SRC_PATH/config.d/logging_no_rotate.xml $DEST_SERVER_PATH/config.d/
 ln -sf $SRC_PATH/config.d/merge_tree.xml $DEST_SERVER_PATH/config.d/
+ln -sf $SRC_PATH/config.d/lost_forever_check.xml $DEST_SERVER_PATH/config.d/
 ln -sf $SRC_PATH/config.d/metadata_cache.xml $DEST_SERVER_PATH/config.d/
 ln -sf $SRC_PATH/config.d/tcp_with_proxy.xml $DEST_SERVER_PATH/config.d/
 ln -sf $SRC_PATH/config.d/prometheus.xml $DEST_SERVER_PATH/config.d/

From 75b266e179fc2994e6bbc7d15ad3e49aacffe708 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <evillique@gmail.com>
Date: Wed, 21 Jun 2023 00:04:11 +0000
Subject: [PATCH 622/722] Fix crash in s3 and s3Cluster functions

---
 src/TableFunctions/TableFunctionS3.cpp             | 6 +++---
 tests/queries/0_stateless/02772_s3_crash.reference | 0
 tests/queries/0_stateless/02772_s3_crash.sql       | 2 ++
 3 files changed, 5 insertions(+), 3 deletions(-)
 create mode 100644 tests/queries/0_stateless/02772_s3_crash.reference
 create mode 100644 tests/queries/0_stateless/02772_s3_crash.sql

diff --git a/src/TableFunctions/TableFunctionS3.cpp b/src/TableFunctions/TableFunctionS3.cpp
index c8cc0cddd30..1d84fa8a265 100644
--- a/src/TableFunctions/TableFunctionS3.cpp
+++ b/src/TableFunctions/TableFunctionS3.cpp
@@ -41,13 +41,13 @@ void TableFunctionS3::parseArgumentsImpl(ASTs & args, const ContextPtr & context
     }
     else
     {
-        if (args.empty() || args.size() > 6)
-            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, "The signature of table function {} shall be the following:\n{}", getName(), getSignature());
-
         auto * header_it = StorageURL::collectHeaders(args, configuration.headers_from_ast, context);
         if (header_it != args.end())
             args.erase(header_it);
 
+        if (args.empty() || args.size() > 6)
+            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, "The signature of table function {} shall be the following:\n{}", getName(), getSignature());
+
         for (auto & arg : args)
             arg = evaluateConstantExpressionOrIdentifierAsLiteral(arg, context);
 
diff --git a/tests/queries/0_stateless/02772_s3_crash.reference b/tests/queries/0_stateless/02772_s3_crash.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02772_s3_crash.sql b/tests/queries/0_stateless/02772_s3_crash.sql
new file mode 100644
index 00000000000..856320b4b9a
--- /dev/null
+++ b/tests/queries/0_stateless/02772_s3_crash.sql
@@ -0,0 +1,2 @@
+SELECT * FROM s3(headers('random_header' = 'value')); -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
+SELECT * FROM s3Cluster('test_cluster_two_shards_localhost', headers('random_header' = 'value')); -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }

From f9103abec8df53e8d96224cb23fe5f567920e162 Mon Sep 17 00:00:00 2001
From: Nikolay Degterinsky <43110995+evillique@users.noreply.github.com>
Date: Wed, 21 Jun 2023 02:23:51 +0200
Subject: [PATCH 623/722] Remove test from Fast Test

---
 tests/queries/0_stateless/02772_s3_crash.sql | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/tests/queries/0_stateless/02772_s3_crash.sql b/tests/queries/0_stateless/02772_s3_crash.sql
index 856320b4b9a..5cad83def63 100644
--- a/tests/queries/0_stateless/02772_s3_crash.sql
+++ b/tests/queries/0_stateless/02772_s3_crash.sql
@@ -1,2 +1,5 @@
+-- Tags: no-fasttest
+-- Tag no-fasttest: Depends on AWS
+
 SELECT * FROM s3(headers('random_header' = 'value')); -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
 SELECT * FROM s3Cluster('test_cluster_two_shards_localhost', headers('random_header' = 'value')); -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }

From 3365a8f436214c17ed01e2ba7fdc897cd368f784 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 21 Jun 2023 11:33:09 +1000
Subject: [PATCH 624/722] Temporary check fix PR
 https://github.com/apache/orc/pull/1542#issuecomment-1599784337 with our
 build

---
 .gitmodules | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitmodules b/.gitmodules
index 8bf4f6e8975..f47d68896bb 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -86,7 +86,7 @@
 	url = https://github.com/ClickHouse/fastops
 [submodule "contrib/orc"]
 	path = contrib/orc
-	url = https://github.com/ClickHouse/orc
+	url = https://github.com/wpleonardo/orc/tree/main
 [submodule "contrib/sparsehash-c11"]
 	path = contrib/sparsehash-c11
 	url = https://github.com/sparsehash/sparsehash-c11

From c47e2a1e6465ea9adf742b5a4cfa89d74cedb1b5 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 21 Jun 2023 11:57:47 +1000
Subject: [PATCH 625/722] Fixed wrong contrib orc submodule url i meant to test
 *facepalm*

---
 .gitmodules | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitmodules b/.gitmodules
index f47d68896bb..955b5cc27bb 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -86,7 +86,7 @@
 	url = https://github.com/ClickHouse/fastops
 [submodule "contrib/orc"]
 	path = contrib/orc
-	url = https://github.com/wpleonardo/orc/tree/main
+	url = https://github.com/wpleonardo/orc
 [submodule "contrib/sparsehash-c11"]
 	path = contrib/sparsehash-c11
 	url = https://github.com/sparsehash/sparsehash-c11

From 26fc9ee8dc87cc1415983d27d5367fe9a5c61c19 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 21 Jun 2023 12:25:39 +1000
Subject: [PATCH 626/722] ran git checkout inside contrib/orc

---
 contrib/orc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/orc b/contrib/orc
index f2c191f9653..81fed015072 160000
--- a/contrib/orc
+++ b/contrib/orc
@@ -1 +1 @@
-Subproject commit f2c191f9653a5ddbca016e024ca0fb61508f5eeb
+Subproject commit 81fed0150727e548ceadb489d3240e3132fc851a

From b60520ec55fcda4350f870291d6947254742fddc Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 21 Jun 2023 11:15:55 +0200
Subject: [PATCH 627/722] Disable cache setting
 do_not_evict_index_and_mark_files

---
 src/Interpreters/Cache/FileCacheSettings.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/FileCacheSettings.cpp b/src/Interpreters/Cache/FileCacheSettings.cpp
index 1fe51bf5f3e..47fdb65bec4 100644
--- a/src/Interpreters/Cache/FileCacheSettings.cpp
+++ b/src/Interpreters/Cache/FileCacheSettings.cpp
@@ -47,7 +47,7 @@ void FileCacheSettings::loadFromConfig(const Poco::Util::AbstractConfiguration &
     else
          bypass_cache_threashold = FILECACHE_BYPASS_THRESHOLD;
 
-    do_not_evict_index_and_mark_files = config.getUInt64(config_prefix + ".do_not_evict_index_and_mark_files", true);
+    do_not_evict_index_and_mark_files = config.getUInt64(config_prefix + ".do_not_evict_index_and_mark_files", false);
 
     boundary_alignment = config.getUInt64(config_prefix + ".boundary_alignment", DBMS_DEFAULT_BUFFER_SIZE);
 

From 4d08df8d29794309af4f65dfbde6d9bba0b66bc0 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Wed, 21 Jun 2023 12:27:39 +0200
Subject: [PATCH 628/722] fix finalization of cascade write buffer

---
 src/IO/CascadeWriteBuffer.cpp | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/IO/CascadeWriteBuffer.cpp b/src/IO/CascadeWriteBuffer.cpp
index 305825b9fd8..91a42e77fdb 100644
--- a/src/IO/CascadeWriteBuffer.cpp
+++ b/src/IO/CascadeWriteBuffer.cpp
@@ -71,6 +71,9 @@ void CascadeWriteBuffer::getResultBuffers(WriteBufferPtrs & res)
 
 void CascadeWriteBuffer::finalizeImpl()
 {
+    if (curr_buffer)
+        curr_buffer->position() = position();
+
     for (auto & buf : prepared_sources)
     {
         if (buf)

From 52f6a4f98a713e3e2b622c304f8d6d6de2deba92 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 21 Jun 2023 12:46:09 +0200
Subject: [PATCH 629/722] Fix style

---
 .../0_stateless/02149_schema_inference_formats_with_schema_3.sh  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh
index 6ac530abf99..fef85f0f1ed 100755
--- a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.sh
@@ -9,7 +9,6 @@ DATA_FILE=$CURDIR/test_$CLICKHOUSE_TEST_UNIQUE_NAME.data
 
 echo "Avro"
 
-echo $format
 $CLICKHOUSE_LOCAL -q "select toInt8(-number) as int8, toUInt8(number) as uint8, toInt16(-number) as int16, toUInt16(number) as uint16, toInt32(-number) as int32, toUInt32(number) as uint32, toInt64(-number) as int64, toUInt64(number) as uint64 from numbers(2) format Avro" > $DATA_FILE
 $CLICKHOUSE_LOCAL -q "desc file('$DATA_FILE', 'Avro')"
 $CLICKHOUSE_LOCAL -q "select * from file('$DATA_FILE', 'Avro')"

From c5f8cb644e6187a1080a00988726631e556065c7 Mon Sep 17 00:00:00 2001
From: Kruglov Pavel <48961922+Avogar@users.noreply.github.com>
Date: Wed, 21 Jun 2023 12:46:24 +0200
Subject: [PATCH 630/722] Update test reference

---
 .../02149_schema_inference_formats_with_schema_3.reference       | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference
index caa6e99c224..d076bf9ed4e 100644
--- a/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference
+++ b/tests/queries/0_stateless/02149_schema_inference_formats_with_schema_3.reference
@@ -1,5 +1,4 @@
 Avro
-
 int8	Int32					
 uint8	Int32					
 int16	Int32					

From 118c3af4d6634f1b7b951659cef8fef2692653e0 Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Mon, 19 Jun 2023 18:17:34 +0200
Subject: [PATCH 631/722] Ignore errors for `chown` in fasttests

---
 tests/ci/functional_test_check.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/tests/ci/functional_test_check.py b/tests/ci/functional_test_check.py
index 864c3a81acf..f77ef330ea2 100644
--- a/tests/ci/functional_test_check.py
+++ b/tests/ci/functional_test_check.py
@@ -355,7 +355,10 @@ def main():
         else:
             logging.info("Run failed")
 
-    subprocess.check_call(f"sudo chown -R ubuntu:ubuntu {temp_path}", shell=True)
+    try:
+        subprocess.check_call(f"sudo chown -R ubuntu:ubuntu {temp_path}", shell=True)
+    except subprocess.CalledProcessError:
+        logging.warning("Failed to change files owner in %s, ignoring it", temp_path)
 
     s3_helper = S3Helper()
 

From 4fb2dc838466a8f4a62cb285f688adafeb1a5b7d Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <felixoid@clickhouse.com>
Date: Tue, 20 Jun 2023 01:36:18 +0200
Subject: [PATCH 632/722] Decrease default settings for http headers name and
 value to 128K

---
 programs/keeper/Keeper.cpp | 4 ++--
 src/Bridge/IBridge.cpp     | 2 +-
 src/Core/Settings.h        | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/programs/keeper/Keeper.cpp b/programs/keeper/Keeper.cpp
index cc32b46c6e7..57760b5ebbf 100644
--- a/programs/keeper/Keeper.cpp
+++ b/programs/keeper/Keeper.cpp
@@ -224,12 +224,12 @@ struct Keeper::KeeperHTTPContext : public IHTTPContext
 
     uint64_t getMaxFieldNameSize() const override
     {
-        return context->getConfigRef().getUInt64("keeper_server.http_max_field_name_size", 1048576);
+        return context->getConfigRef().getUInt64("keeper_server.http_max_field_name_size", 128 * 1024);
     }
 
     uint64_t getMaxFieldValueSize() const override
     {
-        return context->getConfigRef().getUInt64("keeper_server.http_max_field_value_size", 1048576);
+        return context->getConfigRef().getUInt64("keeper_server.http_max_field_value_size", 128 * 1024);
     }
 
     uint64_t getMaxChunkSize() const override
diff --git a/src/Bridge/IBridge.cpp b/src/Bridge/IBridge.cpp
index 3c84e22478a..dd3c25e583b 100644
--- a/src/Bridge/IBridge.cpp
+++ b/src/Bridge/IBridge.cpp
@@ -165,7 +165,7 @@ void IBridge::initialize(Application & self)
     http_timeout = config().getUInt64("http-timeout", DEFAULT_HTTP_READ_BUFFER_TIMEOUT);
     max_server_connections = config().getUInt("max-server-connections", 1024);
     keep_alive_timeout = config().getUInt64("keep-alive-timeout", 10);
-    http_max_field_value_size = config().getUInt64("http-max-field-value-size", 1048576);
+    http_max_field_value_size = config().getUInt64("http-max-field-value-size", 128 * 1024);
 
     struct rlimit limit;
     const UInt64 gb = 1024 * 1024 * 1024;
diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index 204a27483df..fbb6528e643 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -315,8 +315,8 @@ class IColumn;
     M(Seconds, http_receive_timeout, DEFAULT_HTTP_READ_BUFFER_TIMEOUT, "HTTP receive timeout", 0) \
     M(UInt64, http_max_uri_size, 1048576, "Maximum URI length of HTTP request", 0) \
     M(UInt64, http_max_fields, 1000000, "Maximum number of fields in HTTP header", 0) \
-    M(UInt64, http_max_field_name_size, 1048576, "Maximum length of field name in HTTP header", 0) \
-    M(UInt64, http_max_field_value_size, 1048576, "Maximum length of field value in HTTP header", 0) \
+    M(UInt64, http_max_field_name_size, 128 * 1024, "Maximum length of field name in HTTP header", 0) \
+    M(UInt64, http_max_field_value_size, 128 * 1024, "Maximum length of field value in HTTP header", 0) \
     M(UInt64, http_max_chunk_size, 100_GiB, "Maximum value of a chunk size in HTTP chunked transfer encoding", 0) \
     M(Bool, http_skip_not_found_url_for_globs, true, "Skip url's for globs with HTTP_NOT_FOUND error", 0) \
     M(Bool, optimize_throw_if_noop, false, "If setting is enabled and OPTIMIZE query didn't actually assign a merge then an explanatory exception is thrown", 0) \

From 5e500cc799ced3b183bb1aefdf56aa7cb2e83646 Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Wed, 21 Jun 2023 11:07:19 +0000
Subject: [PATCH 633/722] fix test

---
 .../test_merge_tree_check_part_with_cache/test.py          | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tests/integration/test_merge_tree_check_part_with_cache/test.py b/tests/integration/test_merge_tree_check_part_with_cache/test.py
index 87ccf19812f..1f50a5ab9de 100644
--- a/tests/integration/test_merge_tree_check_part_with_cache/test.py
+++ b/tests/integration/test_merge_tree_check_part_with_cache/test.py
@@ -22,6 +22,13 @@ def start_cluster():
 
 
 def test_check_part_with_cache(start_cluster):
+    if node.is_built_with_sanitizer() or node.is_debug_build():
+        pytest.skip(
+            "Skip with debug build and sanitizers. \
+            This test manually corrupts cache which triggers LOGICAL_ERROR \
+            and leads to crash with those builds"
+        )
+
     node.query(
         """
         CREATE TABLE s3_test (

From a4137223e35e9cebe6bda028865a545863a03b27 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Wed, 21 Jun 2023 21:44:55 +1000
Subject: [PATCH 634/722] Testing fix for PPC platform
 https://github.com/apache/orc/pull/1542

---
 contrib/orc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contrib/orc b/contrib/orc
index 81fed015072..7d90ebb7c11 160000
--- a/contrib/orc
+++ b/contrib/orc
@@ -1 +1 @@
-Subproject commit 81fed0150727e548ceadb489d3240e3132fc851a
+Subproject commit 7d90ebb7c11b73041dadd276088cb2c1ee2d93d1

From a708adecee1a21b841bea725cfba44f2628a02e6 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 21 Jun 2023 14:00:38 +0200
Subject: [PATCH 635/722] Pass element type as param to ctor

---
 src/Functions/array/emptyArray.cpp | 63 +++++++++++++-----------------
 1 file changed, 27 insertions(+), 36 deletions(-)

diff --git a/src/Functions/array/emptyArray.cpp b/src/Functions/array/emptyArray.cpp
index 56c218279b9..684f8af162a 100644
--- a/src/Functions/array/emptyArray.cpp
+++ b/src/Functions/array/emptyArray.cpp
@@ -1,11 +1,7 @@
 #include <Functions/IFunction.h>
 #include <Functions/FunctionFactory.h>
 #include <DataTypes/DataTypeArray.h>
-#include <DataTypes/DataTypesNumber.h>
-#include <DataTypes/DataTypeDate.h>
-#include <DataTypes/DataTypeDateTime.h>
-#include <DataTypes/DataTypeDateTime64.h>
-#include <DataTypes/DataTypeString.h>
+#include <DataTypes/DataTypeFactory.h>
 #include <Columns/ColumnArray.h>
 #include <Columns/ColumnString.h>
 #include <Columns/ColumnsNumber.h>
@@ -17,25 +13,27 @@ namespace DB
 namespace
 {
 
-template <typename DataType, const char * FunctionName>
 class FunctionEmptyArray : public IFunction
 {
+private:
+    String element_type;
+
 public:
-    /// NOTE: Not using DataType().getName() because DataType ctor might be very heavy (e.g. for DataTypeDateTime as it initializes DateLUT singleton).
-    static String getNameImpl() { return FunctionName; }
-    static FunctionPtr create(ContextPtr) { return std::make_shared<FunctionEmptyArray>(); }
+    static String getNameImpl(const String & element_type) { return "emptyArray" + element_type; }
+
+    explicit FunctionEmptyArray(const String & element_type_) : element_type(element_type_) {}
 
 private:
     String getName() const override
     {
-        return getNameImpl();
+        return getNameImpl(element_type);
     }
 
     size_t getNumberOfArguments() const override { return 0; }
 
     DataTypePtr getReturnTypeImpl(const DataTypes & /*arguments*/) const override
     {
-        return std::make_shared<DataTypeArray>(std::make_shared<DataType>());
+        return std::make_shared<DataTypeArray>(DataTypeFactory::instance().get(element_type));
     }
 
     bool isSuitableForShortCircuitArgumentsExecution(const DataTypesWithConstInfo & /*arguments*/) const override { return false; }
@@ -43,42 +41,35 @@ private:
     ColumnPtr executeImpl(const ColumnsWithTypeAndName &, const DataTypePtr &, size_t input_rows_count) const override
     {
         return ColumnArray::create(
-            DataType().createColumn(),
+            DataTypeFactory::instance().get(element_type)->createColumn(),
             ColumnArray::ColumnOffsets::create(input_rows_count, 0));
     }
 };
 
-template <typename F>
-void registerFunction(FunctionFactory & factory)
+void registerFunction(FunctionFactory & factory, const String & element_type)
 {
-    factory.registerFunction<F>(F::getNameImpl());
+    factory.registerFunction(FunctionEmptyArray::getNameImpl(element_type),
+        [element_type](ContextPtr){ return std::make_unique<FunctionToOverloadResolverAdaptor>(
+            std::make_shared<FunctionEmptyArray>(element_type)); });
 }
 
 }
 
 REGISTER_FUNCTION(EmptyArray)
 {
-
-#define REGISTER_EMPTY_ARRAY_FUNCTION(TYPE) \
-    do \
-    { \
-        static const char name[] = "emptyArray" #TYPE; \
-        registerFunction<FunctionEmptyArray<DataType##TYPE, name>>(factory); \
-    } while(0)
-
-    REGISTER_EMPTY_ARRAY_FUNCTION(UInt8);
-    REGISTER_EMPTY_ARRAY_FUNCTION(UInt16);
-    REGISTER_EMPTY_ARRAY_FUNCTION(UInt32);
-    REGISTER_EMPTY_ARRAY_FUNCTION(UInt64);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Int8);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Int16);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Int32);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Int64);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Float32);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Float64);
-    REGISTER_EMPTY_ARRAY_FUNCTION(Date);
-    REGISTER_EMPTY_ARRAY_FUNCTION(DateTime);
-    REGISTER_EMPTY_ARRAY_FUNCTION(String);
+    registerFunction(factory, "UInt8");
+    registerFunction(factory, "UInt16");
+    registerFunction(factory, "UInt32");
+    registerFunction(factory, "UInt64");
+    registerFunction(factory, "Int8");
+    registerFunction(factory, "Int16");
+    registerFunction(factory, "Int32");
+    registerFunction(factory, "Int64");
+    registerFunction(factory, "Float32");
+    registerFunction(factory, "Float64");
+    registerFunction(factory, "Date");
+    registerFunction(factory, "DateTime");
+    registerFunction(factory, "String");
 }
 
 }

From e650a6094aa95a4d2b27eb66d8229452ca59ac5c Mon Sep 17 00:00:00 2001
From: liuneng <1398775315@qq.com>
Date: Wed, 21 Jun 2023 20:20:37 +0800
Subject: [PATCH 636/722] fix core dump when compile expression

---
 src/DataTypes/Native.cpp                                    | 6 ++++--
 .../02790_fix_coredump_when_compile_expression.reference    | 1 +
 .../02790_fix_coredump_when_compile_expression.sql          | 4 ++++
 3 files changed, 9 insertions(+), 2 deletions(-)
 create mode 100644 tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.reference
 create mode 100644 tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.sql

diff --git a/src/DataTypes/Native.cpp b/src/DataTypes/Native.cpp
index 6f1ea851dce..9af50a180ea 100644
--- a/src/DataTypes/Native.cpp
+++ b/src/DataTypes/Native.cpp
@@ -123,9 +123,11 @@ llvm::Value * nativeCast(llvm::IRBuilderBase & b, const DataTypePtr & from_type,
     }
     else if (to_type->isNullable())
     {
-        auto * from_native_type = toNativeType(b, from_type);
+        auto * to_native_type = toNativeType(b, to_type);
         auto * inner = nativeCast(b, from_type, value, removeNullable(to_type));
-        return b.CreateInsertValue(llvm::Constant::getNullValue(from_native_type), inner, {0});
+        auto * res_ptr = b.CreateAlloca(to_native_type);
+        auto * res_value = b.CreateLoad(to_native_type, res_ptr);
+        return b.CreateInsertValue(res_value, inner, {0});
     }
     else
     {
diff --git a/tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.reference b/tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.reference
new file mode 100644
index 00000000000..b8626c4cff2
--- /dev/null
+++ b/tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.reference
@@ -0,0 +1 @@
+4
diff --git a/tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.sql b/tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.sql
new file mode 100644
index 00000000000..90995da0cca
--- /dev/null
+++ b/tests/queries/0_stateless/02790_fix_coredump_when_compile_expression.sql
@@ -0,0 +1,4 @@
+CREATE TABLE test (col1 Nullable(DOUBLE), col2 Nullable(DOUBLE), col3 DOUBLE) ENGINE=Memory;
+
+insert into test values(1.0 , 2.0, 3.0);
+select multiIf(col1 > 2, col2/col3, 4.0) from test SETTINGS min_count_to_compile_expression=0;

From ab26fce1dda0952c319443ef43888bfe05e3b2d0 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 21 Jun 2023 12:57:33 +0000
Subject: [PATCH 637/722] Typo: passowrd_sha256_hex --> password_sha256_hex

---
 docs/en/operations/named-collections.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/named-collections.md b/docs/en/operations/named-collections.md
index a521a369721..02f52b6f8bf 100644
--- a/docs/en/operations/named-collections.md
+++ b/docs/en/operations/named-collections.md
@@ -50,7 +50,7 @@ To manage named collections with DDL a user must have the `named_control_collect
 ```
 
 :::tip
-In the above example the `passowrd_sha256_hex` value is the hexadecimal representation of the SHA256 hash of the password.  This configuration for the user `default` has the attribute `replace=true` as in the default configuration has a plain text `password` set, and it is not possible to have both plain text and sha256 hex passwords set for a user. 
+In the above example the `password_sha256_hex` value is the hexadecimal representation of the SHA256 hash of the password.  This configuration for the user `default` has the attribute `replace=true` as in the default configuration has a plain text `password` set, and it is not possible to have both plain text and sha256 hex passwords set for a user. 
 :::
 
 ## Storing named collections in configuration files

From 5c38231a146db290cc5a989418de4cf678293652 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 21 Jun 2023 15:18:25 +0200
Subject: [PATCH 638/722] One more profile event for fs cache (#51223)

---
 src/Common/ProfileEvents.cpp         |  1 +
 src/Interpreters/Cache/FileCache.cpp | 56 ++++++++++++++++------------
 2 files changed, 33 insertions(+), 24 deletions(-)

diff --git a/src/Common/ProfileEvents.cpp b/src/Common/ProfileEvents.cpp
index ffd7f8ca696..0838e0366df 100644
--- a/src/Common/ProfileEvents.cpp
+++ b/src/Common/ProfileEvents.cpp
@@ -391,6 +391,7 @@ The server successfully detected this situation and will download merged part fr
     M(FilesystemCacheLockMetadataMicroseconds, "Lock filesystem cache metadata time") \
     M(FilesystemCacheLockCacheMicroseconds, "Lock filesystem cache time") \
     M(FilesystemCacheReserveMicroseconds, "Filesystem cache space reservation time") \
+    M(FilesystemCacheEvictMicroseconds, "Filesystem cache eviction time") \
     M(FilesystemCacheGetOrSetMicroseconds, "Filesystem cache getOrSet() time") \
     M(FilesystemCacheGetMicroseconds, "Filesystem cache get() time") \
     M(FileSegmentWaitMicroseconds, "Wait on DOWNLOADING state") \
diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index ec9220af955..3d1b85dfbde 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -24,6 +24,7 @@ namespace ProfileEvents
     extern const Event FilesystemCacheEvictedFileSegments;
     extern const Event FilesystemCacheLockCacheMicroseconds;
     extern const Event FilesystemCacheReserveMicroseconds;
+    extern const Event FilesystemCacheEvictMicroseconds;
     extern const Event FilesystemCacheGetOrSetMicroseconds;
     extern const Event FilesystemCacheGetMicroseconds;
 }
@@ -612,10 +613,6 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
             file_segment.key(), file_segment.offset());
     }
 
-    /// A file_segment_metadata acquires a LRUQueue iterator on first successful space reservation attempt.
-    auto queue_iterator = file_segment.getQueueIterator();
-    chassert(!queue_iterator || file_segment.getReservedSize() > 0);
-
     struct EvictionCandidates
     {
         explicit EvictionCandidates(KeyMetadataPtr key_metadata_) : key_metadata(key_metadata_) {}
@@ -732,37 +729,48 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
     if (!file_segment.getKeyMetadata()->createBaseDirectory())
         return false;
 
-    for (auto & [current_key, deletion_info] : to_delete)
+    if (!to_delete.empty())
     {
-        auto locked_key = deletion_info.key_metadata->tryLock();
-        if (!locked_key)
-            continue; /// key could become invalid after we released the key lock above, just skip it.
+        LOG_DEBUG(
+            log, "Will evict {} file segments (while reserving {} bytes for {}:{})",
+            to_delete.size(), size, file_segment.key(), file_segment.offset());
 
-        /// delete from vector in reverse order just for efficiency
-        auto & candidates = deletion_info.candidates;
-        while (!candidates.empty())
+        ProfileEventTimeIncrement<Microseconds> evict_watch(ProfileEvents::FilesystemCacheEvictMicroseconds);
+
+        for (auto & [current_key, deletion_info] : to_delete)
         {
-            auto & candidate = candidates.back();
-            chassert(candidate->releasable());
+            auto locked_key = deletion_info.key_metadata->tryLock();
+            if (!locked_key)
+                continue; /// key could become invalid after we released the key lock above, just skip it.
 
-            const auto * segment = candidate->file_segment.get();
+            /// delete from vector in reverse order just for efficiency
+            auto & candidates = deletion_info.candidates;
+            while (!candidates.empty())
+            {
+                auto & candidate = candidates.back();
+                chassert(candidate->releasable());
 
-            ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedFileSegments);
-            ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedBytes, segment->range().size());
+                const auto * segment = candidate->file_segment.get();
 
-            locked_key->removeFileSegment(segment->offset(), segment->lock());
-            segment->getQueueIterator()->remove(cache_lock);
+                ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedFileSegments);
+                ProfileEvents::increment(ProfileEvents::FilesystemCacheEvictedBytes, segment->range().size());
 
-            if (query_context)
-                query_context->remove(current_key, segment->offset(), cache_lock);
+                locked_key->removeFileSegment(segment->offset(), segment->lock());
+                segment->getQueueIterator()->remove(cache_lock);
 
-            candidates.pop_back();
+                if (query_context)
+                    query_context->remove(current_key, segment->offset(), cache_lock);
+
+                candidates.pop_back();
+            }
         }
     }
 
-    /// queue_iteratir is std::nullopt here if no space has been reserved yet, a file_segment_metadata
-    /// acquires queue iterator on first successful space reservation attempt.
-    /// If queue iterator already exists, we need to update the size after each space reservation.
+    /// A file_segment_metadata acquires a LRUQueue iterator on first successful space reservation attempt,
+    /// e.g. queue_iteratir is std::nullopt here if no space has been reserved yet.
+    auto queue_iterator = file_segment.getQueueIterator();
+    chassert(!queue_iterator || file_segment.getReservedSize() > 0);
+
     if (queue_iterator)
     {
         queue_iterator->updateSize(size);

From 3157f29a462bff69affc9c880ee7c98f16d9826e Mon Sep 17 00:00:00 2001
From: serxa <sergei@clickhouse.com>
Date: Wed, 21 Jun 2023 13:25:10 +0000
Subject: [PATCH 639/722] introduce settings enum field with auto-generated
 values list

---
 src/Core/SettingsEnums.cpp | 61 +++++++++-----------------------------
 src/Core/SettingsFields.h  | 41 ++++++++++++++++++-------
 2 files changed, 44 insertions(+), 58 deletions(-)

diff --git a/src/Core/SettingsEnums.cpp b/src/Core/SettingsEnums.cpp
index a291a23c140..612f8689480 100644
--- a/src/Core/SettingsEnums.cpp
+++ b/src/Core/SettingsEnums.cpp
@@ -1,8 +1,10 @@
 #include <Core/SettingsEnums.h>
+#include <magic_enum.hpp>
 
 
 namespace DB
 {
+
 namespace ErrorCodes
 {
     extern const int UNKNOWN_LOAD_BALANCING;
@@ -15,7 +17,6 @@ namespace ErrorCodes
     extern const int UNKNOWN_UNION;
 }
 
-
 IMPLEMENT_SETTING_ENUM(LoadBalancing, ErrorCodes::UNKNOWN_LOAD_BALANCING,
     {{"random",           LoadBalancing::RANDOM},
      {"nearest_hostname", LoadBalancing::NEAREST_HOSTNAME},
@@ -54,7 +55,7 @@ IMPLEMENT_SETTING_ENUM(OverflowMode, ErrorCodes::UNKNOWN_OVERFLOW_MODE,
      {"break", OverflowMode::BREAK}})
 
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(OverflowModeGroupBy, ErrorCodes::UNKNOWN_OVERFLOW_MODE,
+IMPLEMENT_SETTING_ENUM(OverflowModeGroupBy, ErrorCodes::UNKNOWN_OVERFLOW_MODE,
     {{"throw", OverflowMode::THROW},
      {"break", OverflowMode::BREAK},
      {"any", OverflowMode::ANY}})
@@ -67,51 +68,26 @@ IMPLEMENT_SETTING_ENUM(DistributedProductMode, ErrorCodes::UNKNOWN_DISTRIBUTED_P
      {"allow",  DistributedProductMode::ALLOW}})
 
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(DateTimeInputFormat, ErrorCodes::BAD_ARGUMENTS,
+IMPLEMENT_SETTING_ENUM(DateTimeInputFormat, ErrorCodes::BAD_ARGUMENTS,
     {{"basic",       FormatSettings::DateTimeInputFormat::Basic},
      {"best_effort", FormatSettings::DateTimeInputFormat::BestEffort},
      {"best_effort_us", FormatSettings::DateTimeInputFormat::BestEffortUS}})
 
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(DateTimeOutputFormat, ErrorCodes::BAD_ARGUMENTS,
+IMPLEMENT_SETTING_ENUM(DateTimeOutputFormat, ErrorCodes::BAD_ARGUMENTS,
     {{"simple",         FormatSettings::DateTimeOutputFormat::Simple},
      {"iso",            FormatSettings::DateTimeOutputFormat::ISO},
      {"unix_timestamp", FormatSettings::DateTimeOutputFormat::UnixTimestamp}})
 
-IMPLEMENT_SETTING_ENUM(LogsLevel, ErrorCodes::BAD_ARGUMENTS,
-    {{"none",        LogsLevel::none},
-     {"fatal",       LogsLevel::fatal},
-     {"error",       LogsLevel::error},
-     {"warning",     LogsLevel::warning},
-     {"information", LogsLevel::information},
-     {"debug",       LogsLevel::debug},
-     {"trace",       LogsLevel::trace},
-     {"test",        LogsLevel::test}})
+IMPLEMENT_SETTING_AUTO_ENUM(LogsLevel, ErrorCodes::BAD_ARGUMENTS)
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(LogQueriesType, ErrorCodes::BAD_ARGUMENTS,
-    {{"QUERY_START",                QUERY_START},
-     {"QUERY_FINISH",               QUERY_FINISH},
-     {"EXCEPTION_BEFORE_START",     EXCEPTION_BEFORE_START},
-     {"EXCEPTION_WHILE_PROCESSING", EXCEPTION_WHILE_PROCESSING}})
+IMPLEMENT_SETTING_AUTO_ENUM(LogQueriesType, ErrorCodes::BAD_ARGUMENTS)
 
+IMPLEMENT_SETTING_AUTO_ENUM(DefaultDatabaseEngine, ErrorCodes::BAD_ARGUMENTS)
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(DefaultDatabaseEngine, ErrorCodes::BAD_ARGUMENTS,
-    {{"Ordinary", DefaultDatabaseEngine::Ordinary},
-     {"Atomic",   DefaultDatabaseEngine::Atomic}})
+IMPLEMENT_SETTING_AUTO_ENUM(DefaultTableEngine, ErrorCodes::BAD_ARGUMENTS)
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(DefaultTableEngine, ErrorCodes::BAD_ARGUMENTS,
-    {{"None", DefaultTableEngine::None},
-     {"Log", DefaultTableEngine::Log},
-     {"StripeLog", DefaultTableEngine::StripeLog},
-     {"MergeTree", DefaultTableEngine::MergeTree},
-     {"ReplacingMergeTree", DefaultTableEngine::ReplacingMergeTree},
-     {"ReplicatedMergeTree", DefaultTableEngine::ReplicatedMergeTree},
-     {"ReplicatedReplacingMergeTree", DefaultTableEngine::ReplicatedReplacingMergeTree},
-     {"Memory", DefaultTableEngine::Memory}})
-
-IMPLEMENT_SETTING_ENUM(CleanDeletedRows, ErrorCodes::BAD_ARGUMENTS,
-    {{"Never", CleanDeletedRows::Never},
-     {"Always", CleanDeletedRows::Always}})
+IMPLEMENT_SETTING_AUTO_ENUM(CleanDeletedRows, ErrorCodes::BAD_ARGUMENTS)
 
 IMPLEMENT_SETTING_MULTI_ENUM(MySQLDataTypesSupport, ErrorCodes::UNKNOWN_MYSQL_DATATYPES_SUPPORT_LEVEL,
     {{"decimal",    MySQLDataTypesSupport::DECIMAL},
@@ -149,14 +125,7 @@ IMPLEMENT_SETTING_ENUM(CapnProtoEnumComparingMode, ErrorCodes::BAD_ARGUMENTS,
      {"by_values",  FormatSettings::CapnProtoEnumComparingMode::BY_VALUES},
      {"by_names_case_insensitive", FormatSettings::CapnProtoEnumComparingMode::BY_NAMES_CASE_INSENSITIVE}})
 
-IMPLEMENT_SETTING_ENUM(EscapingRule, ErrorCodes::BAD_ARGUMENTS,
-    {{"None", FormatSettings::EscapingRule::None},
-     {"Escaped", FormatSettings::EscapingRule::Escaped},
-     {"Quoted", FormatSettings::EscapingRule::Quoted},
-     {"CSV", FormatSettings::EscapingRule::CSV},
-     {"JSON", FormatSettings::EscapingRule::JSON},
-     {"XML", FormatSettings::EscapingRule::XML},
-     {"Raw", FormatSettings::EscapingRule::Raw}})
+IMPLEMENT_SETTING_AUTO_ENUM(EscapingRule, ErrorCodes::BAD_ARGUMENTS)
 
 IMPLEMENT_SETTING_ENUM(MsgPackUUIDRepresentation, ErrorCodes::BAD_ARGUMENTS,
                        {{"bin", FormatSettings::MsgPackUUIDRepresentation::BIN},
@@ -166,17 +135,15 @@ IMPLEMENT_SETTING_ENUM(MsgPackUUIDRepresentation, ErrorCodes::BAD_ARGUMENTS,
 IMPLEMENT_SETTING_ENUM(Dialect, ErrorCodes::BAD_ARGUMENTS,
     {{"clickhouse", Dialect::clickhouse},
      {"kusto", Dialect::kusto}})
+    // FIXME: do not add 'kusto_auto' to the list. Maybe remove it from code completely?
 
 IMPLEMENT_SETTING_ENUM(ParallelReplicasCustomKeyFilterType, ErrorCodes::BAD_ARGUMENTS,
     {{"default", ParallelReplicasCustomKeyFilterType::DEFAULT},
      {"range", ParallelReplicasCustomKeyFilterType::RANGE}})
 
-IMPLEMENT_SETTING_ENUM(LocalFSReadMethod, ErrorCodes::BAD_ARGUMENTS,
-    {{"mmap", LocalFSReadMethod::mmap},
-     {"pread", LocalFSReadMethod::pread},
-     {"read", LocalFSReadMethod::read}})
+IMPLEMENT_SETTING_AUTO_ENUM(LocalFSReadMethod, ErrorCodes::BAD_ARGUMENTS)
 
-IMPLEMENT_SETTING_ENUM_WITH_RENAME(ParquetVersion, ErrorCodes::BAD_ARGUMENTS,
+IMPLEMENT_SETTING_ENUM(ParquetVersion, ErrorCodes::BAD_ARGUMENTS,
     {{"1.0",       FormatSettings::ParquetVersion::V1_0},
      {"2.4", FormatSettings::ParquetVersion::V2_4},
      {"2.6", FormatSettings::ParquetVersion::V2_6},
diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index 2cd55e6b4c5..d02932c8000 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -10,7 +10,6 @@
 #include <unordered_map>
 #include <string_view>
 
-
 namespace DB
 {
 namespace ErrorCodes
@@ -371,19 +370,25 @@ void SettingFieldEnum<EnumT, Traits>::readBinary(ReadBuffer & in)
     *this = Traits::fromString(SettingFieldEnumHelpers::readBinary(in));
 }
 
+template <typename Type>
+constexpr auto getEnumValues()
+{
+    std::array<std::pair<std::string_view, Type>, magic_enum::enum_count<Type>()> enum_values{};
+    for (auto value : magic_enum::enum_values<Type>())
+        enum_values[magic_enum::enum_integer(value)] = std::pair{magic_enum::enum_name(value), value};
+    return enum_values;
+}
+
 /// NOLINTNEXTLINE
 #define DECLARE_SETTING_ENUM(ENUM_TYPE) \
     DECLARE_SETTING_ENUM_WITH_RENAME(ENUM_TYPE, ENUM_TYPE)
 
-/// NOLINTNEXTLINE
-#define IMPLEMENT_SETTING_ENUM(ENUM_TYPE, ERROR_CODE_FOR_UNEXPECTED_NAME, ...) \
-    IMPLEMENT_SETTING_ENUM_WITH_RENAME(ENUM_TYPE, ERROR_CODE_FOR_UNEXPECTED_NAME, __VA_ARGS__)
-
 /// NOLINTNEXTLINE
 #define DECLARE_SETTING_ENUM_WITH_RENAME(NEW_NAME, ENUM_TYPE) \
     struct SettingField##NEW_NAME##Traits \
     { \
         using EnumType = ENUM_TYPE; \
+        using EnumValuePairs = std::pair<const char *, EnumType>[]; \
         static const String & toString(EnumType value); \
         static EnumType fromString(std::string_view str); \
     }; \
@@ -391,13 +396,20 @@ void SettingFieldEnum<EnumT, Traits>::readBinary(ReadBuffer & in)
     using SettingField##NEW_NAME = SettingFieldEnum<ENUM_TYPE, SettingField##NEW_NAME##Traits>;
 
 /// NOLINTNEXTLINE
-#define IMPLEMENT_SETTING_ENUM_WITH_RENAME(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, ...) \
+#define IMPLEMENT_SETTING_ENUM(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, ...) \
+    IMPLEMENT_SETTING_ENUM_IMPL(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, EnumValuePairs, __VA_ARGS__)
+
+/// NOLINTNEXTLINE
+#define IMPLEMENT_SETTING_AUTO_ENUM(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME) \
+    IMPLEMENT_SETTING_ENUM_IMPL(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, , getEnumValues<EnumType>())
+
+/// NOLINTNEXTLINE
+#define IMPLEMENT_SETTING_ENUM_IMPL(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, PAIRS_TYPE, ...) \
     const String & SettingField##NEW_NAME##Traits::toString(typename SettingField##NEW_NAME::EnumType value) \
     { \
         static const std::unordered_map<EnumType, String> map = [] { \
             std::unordered_map<EnumType, String> res; \
-            constexpr std::pair<const char *, EnumType> pairs[] = __VA_ARGS__; \
-            for (const auto & [name, val] : pairs) \
+            for (const auto & [name, val] : PAIRS_TYPE __VA_ARGS__) \
                 res.emplace(val, name); \
             return res; \
         }(); \
@@ -413,8 +425,7 @@ void SettingFieldEnum<EnumT, Traits>::readBinary(ReadBuffer & in)
     { \
         static const std::unordered_map<std::string_view, EnumType> map = [] { \
             std::unordered_map<std::string_view, EnumType> res; \
-            constexpr std::pair<const char *, EnumType> pairs[] = __VA_ARGS__; \
-            for (const auto & [name, val] : pairs) \
+            for (const auto & [name, val] : PAIRS_TYPE __VA_ARGS__) \
                 res.emplace(name, val); \
             return res; \
         }(); \
@@ -527,6 +538,7 @@ void SettingFieldMultiEnum<EnumT, Traits>::readBinary(ReadBuffer & in)
     struct SettingField##NEW_NAME##Traits \
     { \
         using EnumType = ENUM_TYPE; \
+        using EnumValuePairs = std::pair<const char *, EnumType>[]; \
         static size_t getEnumSize(); \
         static const String & toString(EnumType value); \
         static EnumType fromString(std::string_view str); \
@@ -540,11 +552,18 @@ void SettingFieldMultiEnum<EnumT, Traits>::readBinary(ReadBuffer & in)
 
 /// NOLINTNEXTLINE
 #define IMPLEMENT_SETTING_MULTI_ENUM_WITH_RENAME(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, ...) \
-    IMPLEMENT_SETTING_ENUM_WITH_RENAME(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, __VA_ARGS__)\
+    IMPLEMENT_SETTING_ENUM(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME, __VA_ARGS__)\
     size_t SettingField##NEW_NAME##Traits::getEnumSize() {\
         return std::initializer_list<std::pair<const char*, NEW_NAME>> __VA_ARGS__ .size();\
     }
 
+/// NOLINTNEXTLINE
+#define IMPLEMENT_SETTING_MULTI_AUTO_ENUM(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME) \
+    IMPLEMENT_SETTING_AUTO_ENUM(NEW_NAME, ERROR_CODE_FOR_UNEXPECTED_NAME)\
+    size_t SettingField##NEW_NAME##Traits::getEnumSize() {\
+        return getEnumValues<EnumType>().size();\
+    }
+
 /// Can keep a value of any type. Used for user-defined settings.
 struct SettingFieldCustom
 {

From 6ebeb93a1a9a0a8e25d98867b0e4753d84f9a569 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Wed, 21 Jun 2023 16:05:48 +0200
Subject: [PATCH 640/722] Drop session if we fail to get API version

---
 src/Common/ZooKeeper/ZooKeeperImpl.cpp | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/src/Common/ZooKeeper/ZooKeeperImpl.cpp b/src/Common/ZooKeeper/ZooKeeperImpl.cpp
index 7f23ac00efe..14b31c6a411 100644
--- a/src/Common/ZooKeeper/ZooKeeperImpl.cpp
+++ b/src/Common/ZooKeeper/ZooKeeperImpl.cpp
@@ -1107,17 +1107,20 @@ void ZooKeeper::initApiVersion()
     get(keeper_api_version_path, std::move(callback), {});
     if (future.wait_for(std::chrono::milliseconds(args.operation_timeout_ms)) != std::future_status::ready)
     {
-        LOG_TRACE(log, "Failed to get API version: timeout");
-        return;
+        throw Exception(Error::ZOPERATIONTIMEOUT, "Failed to get API version: timeout");
     }
 
     auto response = future.get();
 
-    if (response.error != Coordination::Error::ZOK)
+    if (response.error == Coordination::Error::ZNONODE)
     {
-        LOG_TRACE(log, "Failed to get API version");
+        LOG_TRACE(log, "API version not found, assuming {}", keeper_api_version);
         return;
     }
+    else if (response.error != Coordination::Error::ZOK)
+    {
+        throw Exception(response.error, "Failed to get API version");
+    }
 
     uint8_t keeper_version{0};
     DB::ReadBufferFromOwnString buf(response.data);

From 76e3d1e7b62340f88475045630061bed12ca08e3 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@gmail.com>
Date: Wed, 21 Jun 2023 17:10:20 +0300
Subject: [PATCH 641/722] Revert "Fix a crash in s3 and s3Cluster functions"

---
 src/TableFunctions/TableFunctionS3.cpp             | 6 +++---
 tests/queries/0_stateless/02772_s3_crash.reference | 0
 tests/queries/0_stateless/02772_s3_crash.sql       | 5 -----
 3 files changed, 3 insertions(+), 8 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02772_s3_crash.reference
 delete mode 100644 tests/queries/0_stateless/02772_s3_crash.sql

diff --git a/src/TableFunctions/TableFunctionS3.cpp b/src/TableFunctions/TableFunctionS3.cpp
index 1d84fa8a265..c8cc0cddd30 100644
--- a/src/TableFunctions/TableFunctionS3.cpp
+++ b/src/TableFunctions/TableFunctionS3.cpp
@@ -41,13 +41,13 @@ void TableFunctionS3::parseArgumentsImpl(ASTs & args, const ContextPtr & context
     }
     else
     {
+        if (args.empty() || args.size() > 6)
+            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, "The signature of table function {} shall be the following:\n{}", getName(), getSignature());
+
         auto * header_it = StorageURL::collectHeaders(args, configuration.headers_from_ast, context);
         if (header_it != args.end())
             args.erase(header_it);
 
-        if (args.empty() || args.size() > 6)
-            throw Exception(ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH, "The signature of table function {} shall be the following:\n{}", getName(), getSignature());
-
         for (auto & arg : args)
             arg = evaluateConstantExpressionOrIdentifierAsLiteral(arg, context);
 
diff --git a/tests/queries/0_stateless/02772_s3_crash.reference b/tests/queries/0_stateless/02772_s3_crash.reference
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/tests/queries/0_stateless/02772_s3_crash.sql b/tests/queries/0_stateless/02772_s3_crash.sql
deleted file mode 100644
index 5cad83def63..00000000000
--- a/tests/queries/0_stateless/02772_s3_crash.sql
+++ /dev/null
@@ -1,5 +0,0 @@
--- Tags: no-fasttest
--- Tag no-fasttest: Depends on AWS
-
-SELECT * FROM s3(headers('random_header' = 'value')); -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }
-SELECT * FROM s3Cluster('test_cluster_two_shards_localhost', headers('random_header' = 'value')); -- { serverError NUMBER_OF_ARGUMENTS_DOESNT_MATCH }

From b723f9e7bf9746aea4bafee642817b83e49d67d8 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 21 Jun 2023 16:45:52 +0200
Subject: [PATCH 642/722] Fix sometimes not correct current_elements_num

---
 src/Interpreters/Cache/LRUFileCachePriority.cpp | 16 ++++++++++++----
 src/Interpreters/Cache/LRUFileCachePriority.h   |  3 ++-
 2 files changed, 14 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/LRUFileCachePriority.cpp b/src/Interpreters/Cache/LRUFileCachePriority.cpp
index 3c36962a0e5..ebdf402908a 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.cpp
+++ b/src/Interpreters/Cache/LRUFileCachePriority.cpp
@@ -49,6 +49,7 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
 
     auto iter = queue.insert(queue.end(), Entry(key, offset, size, key_metadata));
     current_size += size;
+    ++current_elements_num;
 
     CurrentMetrics::add(CurrentMetrics::FilesystemCacheSize, size);
     CurrentMetrics::add(CurrentMetrics::FilesystemCacheElements);
@@ -63,12 +64,13 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
 void LRUFileCachePriority::removeAll(const CacheGuard::Lock &)
 {
     CurrentMetrics::sub(CurrentMetrics::FilesystemCacheSize, current_size);
-    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements, queue.size());
+    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements, current_elements_num);
 
     LOG_TEST(log, "Removed all entries from LRU queue");
 
     queue.clear();
     current_size = 0;
+    current_elements_num = 0;
 }
 
 void LRUFileCachePriority::pop(const CacheGuard::Lock &)
@@ -78,10 +80,15 @@ void LRUFileCachePriority::pop(const CacheGuard::Lock &)
 
 LRUFileCachePriority::LRUQueueIterator LRUFileCachePriority::remove(LRUQueueIterator it)
 {
-    current_size -= it->size;
+    /// If size is 0, entry is annuled, current_elements_num was already updated.
+    if (it->size)
+    {
+        current_size -= it->size;
+        --current_elements_num;
 
-    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheSize, it->size);
-    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements);
+        CurrentMetrics::sub(CurrentMetrics::FilesystemCacheSize, it->size);
+        CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements);
+    }
 
     LOG_TEST(
         log, "Removed entry from LRU queue, key: {}, offset: {}, size: {}",
@@ -157,6 +164,7 @@ void LRUFileCachePriority::LRUFileCacheIterator::annul()
 {
     updateSize(-queue_iter->size);
     chassert(queue_iter->size == 0);
+    --cache_priority->current_elements_num;
 }
 
 void LRUFileCachePriority::LRUFileCacheIterator::updateSize(int64_t size)
diff --git a/src/Interpreters/Cache/LRUFileCachePriority.h b/src/Interpreters/Cache/LRUFileCachePriority.h
index a80e4647f2d..208d05f9ed8 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.h
+++ b/src/Interpreters/Cache/LRUFileCachePriority.h
@@ -22,7 +22,7 @@ public:
 
     size_t getSize(const CacheGuard::Lock &) const override { return current_size; }
 
-    size_t getElementsCount(const CacheGuard::Lock &) const override { return queue.size(); }
+    size_t getElementsCount(const CacheGuard::Lock &) const override { return current_elements_num; }
 
     Iterator add(KeyMetadataPtr key_metadata, size_t offset, size_t size, const CacheGuard::Lock &) override;
 
@@ -37,6 +37,7 @@ private:
     Poco::Logger * log = &Poco::Logger::get("LRUFileCachePriority");
 
     std::atomic<size_t> current_size = 0;
+    std::atomic<size_t> current_elements_num = 0;
 
     LRUQueueIterator remove(LRUQueueIterator it);
 };

From 3224e49757a4d6258f1601915b8ecdffebb79a72 Mon Sep 17 00:00:00 2001
From: liuneng <1398775315@qq.com>
Date: Wed, 21 Jun 2023 22:46:41 +0800
Subject: [PATCH 643/722] fix

---
 src/DataTypes/Native.cpp | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/DataTypes/Native.cpp b/src/DataTypes/Native.cpp
index 9af50a180ea..fd3716c2291 100644
--- a/src/DataTypes/Native.cpp
+++ b/src/DataTypes/Native.cpp
@@ -125,9 +125,7 @@ llvm::Value * nativeCast(llvm::IRBuilderBase & b, const DataTypePtr & from_type,
     {
         auto * to_native_type = toNativeType(b, to_type);
         auto * inner = nativeCast(b, from_type, value, removeNullable(to_type));
-        auto * res_ptr = b.CreateAlloca(to_native_type);
-        auto * res_value = b.CreateLoad(to_native_type, res_ptr);
-        return b.CreateInsertValue(res_value, inner, {0});
+        return b.CreateInsertValue(llvm::Constant::getNullValue(to_native_type), inner, {0});
     }
     else
     {

From 89f19fc912b1dc20b5c19f2601a4bd0de6caa878 Mon Sep 17 00:00:00 2001
From: serxa <sergei@clickhouse.com>
Date: Wed, 21 Jun 2023 14:47:47 +0000
Subject: [PATCH 644/722] fix values indexing

---
 src/Core/SettingsFields.h | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/Core/SettingsFields.h b/src/Core/SettingsFields.h
index d02932c8000..686638d497f 100644
--- a/src/Core/SettingsFields.h
+++ b/src/Core/SettingsFields.h
@@ -374,8 +374,9 @@ template <typename Type>
 constexpr auto getEnumValues()
 {
     std::array<std::pair<std::string_view, Type>, magic_enum::enum_count<Type>()> enum_values{};
+    size_t index = 0;
     for (auto value : magic_enum::enum_values<Type>())
-        enum_values[magic_enum::enum_integer(value)] = std::pair{magic_enum::enum_name(value), value};
+        enum_values[index++] = std::pair{magic_enum::enum_name(value), value};
     return enum_values;
 }
 

From c5ade1c8fcf6ad4bd0ecfd5b2fc76eef312ed018 Mon Sep 17 00:00:00 2001
From: serxa <sergei@clickhouse.com>
Date: Wed, 21 Jun 2023 15:16:18 +0000
Subject: [PATCH 645/722] fix flaky `AsyncLoader` destructor

---
 src/Common/AsyncLoader.cpp | 16 ++++++++++++++--
 src/Common/AsyncLoader.h   |  1 +
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/src/Common/AsyncLoader.cpp b/src/Common/AsyncLoader.cpp
index 86edcdc8f3d..4d885fae2e8 100644
--- a/src/Common/AsyncLoader.cpp
+++ b/src/Common/AsyncLoader.cpp
@@ -200,9 +200,11 @@ void AsyncLoader::start()
 
 void AsyncLoader::wait()
 {
-    // Because job can create new jobs in other pools we have to recheck in cycle
+    // Because job can create new jobs in other pools we have to recheck in cycle.
+    // Also wait for all workers to finish to avoid races on `pool.workers`,
+    // which can be decrease even after all jobs are already finished.
     std::unique_lock lock{mutex};
-    while (!scheduled_jobs.empty())
+    while (!scheduled_jobs.empty() && hasWorker(lock))
     {
         lock.unlock();
         for (auto & p : pools)
@@ -719,4 +721,14 @@ void AsyncLoader::worker(Pool & pool)
     }
 }
 
+bool AsyncLoader::hasWorker(std::unique_lock<std::mutex> &) const
+{
+    for (const Pool & pool : pools)
+    {
+        if (pool.workers > 0)
+            return true;
+    }
+    return false;
+}
+
 }
diff --git a/src/Common/AsyncLoader.h b/src/Common/AsyncLoader.h
index 322a4482e4e..77905319f00 100644
--- a/src/Common/AsyncLoader.h
+++ b/src/Common/AsyncLoader.h
@@ -445,6 +445,7 @@ private:
     void updateCurrentPriorityAndSpawn(std::unique_lock<std::mutex> &);
     void spawn(Pool & pool, std::unique_lock<std::mutex> &);
     void worker(Pool & pool);
+    bool hasWorker(std::unique_lock<std::mutex> &) const;
 
     // Logging
     const bool log_failures; // Worker should log all exceptions caught from job functions.

From 1f901f4ec498078cbb7ae83d7c93275fffbdcedf Mon Sep 17 00:00:00 2001
From: serxa <sergei@clickhouse.com>
Date: Wed, 21 Jun 2023 15:18:49 +0000
Subject: [PATCH 646/722] fix

---
 src/Common/AsyncLoader.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Common/AsyncLoader.cpp b/src/Common/AsyncLoader.cpp
index 4d885fae2e8..43900c3afd5 100644
--- a/src/Common/AsyncLoader.cpp
+++ b/src/Common/AsyncLoader.cpp
@@ -204,7 +204,7 @@ void AsyncLoader::wait()
     // Also wait for all workers to finish to avoid races on `pool.workers`,
     // which can be decrease even after all jobs are already finished.
     std::unique_lock lock{mutex};
-    while (!scheduled_jobs.empty() && hasWorker(lock))
+    while (!scheduled_jobs.empty() || hasWorker(lock))
     {
         lock.unlock();
         for (auto & p : pools)

From 804466f12958949c244d38ef5089ba85315ef252 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 21 Jun 2023 11:20:17 -0400
Subject: [PATCH 647/722] fix server settings nav

---
 .../server-configuration-parameters/index.md     | 16 ----------------
 .../server-configuration-parameters/settings.md  |  8 ++++++++
 2 files changed, 8 insertions(+), 16 deletions(-)
 delete mode 100644 docs/en/operations/server-configuration-parameters/index.md

diff --git a/docs/en/operations/server-configuration-parameters/index.md b/docs/en/operations/server-configuration-parameters/index.md
deleted file mode 100644
index d4b941c0819..00000000000
--- a/docs/en/operations/server-configuration-parameters/index.md
+++ /dev/null
@@ -1,16 +0,0 @@
----
-slug: /en/operations/server-configuration-parameters/
-sidebar_position: 54
-sidebar_label: Server Configuration Parameters
-pagination_next: en/operations/server-configuration-parameters/settings
----
-
-# Server Configuration Parameters 
-
-This section contains descriptions of server settings that cannot be changed at the session or query level.
-
-These settings are stored in the `config.xml` file on the ClickHouse server.
-
-Other settings are described in the “[Settings](../../operations/settings/index.md#session-settings-intro)” section.
-
-Before studying the settings, read the [Configuration files](../../operations/configuration-files.md#configuration_files) section and note the use of substitutions (the `incl` and `optional` attributes).
diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index 83756097cfa..ce62d436813 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -7,6 +7,14 @@ description: This section contains descriptions of server settings that cannot b
 
 # Server Settings
 
+This section contains descriptions of server settings that cannot be changed at the session or query level.
+
+These settings are stored in the `config.xml` file on the ClickHouse server.
+
+Other settings are described in the “[Settings](../../operations/settings/index.md#session-settings-intro)” section.
+
+Before studying the settings, read the [Configuration files](../../operations/configuration-files.md#configuration_files) section and note the use of substitutions (the `incl` and `optional` attributes).
+
 ## allow_use_jemalloc_memory
 
 Allows to use jemalloc memory.

From d18da7098a01a54b592b223c5ed49fd1ec7e4843 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Wed, 21 Jun 2023 17:25:09 +0200
Subject: [PATCH 648/722] Update LRUFileCachePriority.cpp

---
 src/Interpreters/Cache/LRUFileCachePriority.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/LRUFileCachePriority.cpp b/src/Interpreters/Cache/LRUFileCachePriority.cpp
index ebdf402908a..2807fa2d87e 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.cpp
+++ b/src/Interpreters/Cache/LRUFileCachePriority.cpp
@@ -80,7 +80,7 @@ void LRUFileCachePriority::pop(const CacheGuard::Lock &)
 
 LRUFileCachePriority::LRUQueueIterator LRUFileCachePriority::remove(LRUQueueIterator it)
 {
-    /// If size is 0, entry is annuled, current_elements_num was already updated.
+    /// If size is 0, entry is annulled, current_elements_num was already updated.
     if (it->size)
     {
         current_size -= it->size;

From b007c9f194842f27686876e63495c0e70ccaf769 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 21 Jun 2023 18:28:14 +0200
Subject: [PATCH 649/722] Review comments

---
 src/Interpreters/Cache/IFileCachePriority.h     |  2 +-
 src/Interpreters/Cache/LRUFileCachePriority.cpp | 13 +++++++++++--
 src/Interpreters/Cache/LRUFileCachePriority.h   |  4 +++-
 src/Interpreters/Cache/Metadata.cpp             |  2 +-
 4 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/IFileCachePriority.h b/src/Interpreters/Cache/IFileCachePriority.h
index 93343398783..7338d06e756 100644
--- a/src/Interpreters/Cache/IFileCachePriority.h
+++ b/src/Interpreters/Cache/IFileCachePriority.h
@@ -50,7 +50,7 @@ public:
 
         virtual Entry & getEntry() = 0;
 
-        virtual void annul() = 0;
+        virtual void invalidate() = 0;
 
         virtual void updateSize(int64_t size) = 0;
     };
diff --git a/src/Interpreters/Cache/LRUFileCachePriority.cpp b/src/Interpreters/Cache/LRUFileCachePriority.cpp
index ebdf402908a..e2307e63bc7 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.cpp
+++ b/src/Interpreters/Cache/LRUFileCachePriority.cpp
@@ -25,6 +25,14 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
     const CacheGuard::Lock &)
 {
     const auto & key = key_metadata->key;
+    if (size == 0)
+    {
+        throw Exception(
+            ErrorCodes::LOGICAL_ERROR,
+            "Adding zero size entries to LRU queue is not allowed "
+            "(Key: {}, offset: {}", key, offset);
+    }
+
 #ifndef NDEBUG
     for (const auto & entry : queue)
     {
@@ -80,7 +88,7 @@ void LRUFileCachePriority::pop(const CacheGuard::Lock &)
 
 LRUFileCachePriority::LRUQueueIterator LRUFileCachePriority::remove(LRUQueueIterator it)
 {
-    /// If size is 0, entry is annuled, current_elements_num was already updated.
+    /// If size is 0, entry is invalidateed, current_elements_num was already updated.
     if (it->size)
     {
         current_size -= it->size;
@@ -160,11 +168,12 @@ LRUFileCachePriority::LRUFileCacheIterator::remove(const CacheGuard::Lock &)
         cache_priority, cache_priority->remove(queue_iter));
 }
 
-void LRUFileCachePriority::LRUFileCacheIterator::annul()
+void LRUFileCachePriority::LRUFileCacheIterator::invalidate()
 {
     updateSize(-queue_iter->size);
     chassert(queue_iter->size == 0);
     --cache_priority->current_elements_num;
+    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements);
 }
 
 void LRUFileCachePriority::LRUFileCacheIterator::updateSize(int64_t size)
diff --git a/src/Interpreters/Cache/LRUFileCachePriority.h b/src/Interpreters/Cache/LRUFileCachePriority.h
index 208d05f9ed8..afa2cfb4613 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.h
+++ b/src/Interpreters/Cache/LRUFileCachePriority.h
@@ -37,6 +37,8 @@ private:
     Poco::Logger * log = &Poco::Logger::get("LRUFileCachePriority");
 
     std::atomic<size_t> current_size = 0;
+    /// current_elements_num is not always equal to queue.size()
+    /// because of invalidated entries.
     std::atomic<size_t> current_elements_num = 0;
 
     LRUQueueIterator remove(LRUQueueIterator it);
@@ -57,7 +59,7 @@ public:
 
     Iterator remove(const CacheGuard::Lock &) override;
 
-    void annul() override;
+    void invalidate() override;
 
     void updateSize(int64_t size) override;
 
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 20af931bbc2..dd4ac567e2a 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -402,7 +402,7 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     chassert(file_segment->assertCorrectnessUnlocked(segment_lock));
 
     if (file_segment->queue_iterator)
-        file_segment->queue_iterator->annul();
+        file_segment->queue_iterator->invalidate();
 
     const auto path = key_metadata->getFileSegmentPath(*file_segment);
     bool exists = fs::exists(path);

From 3ce17fd5701ed3d48bf5ec011167ff1b52076ef7 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 21 Jun 2023 18:30:46 +0200
Subject: [PATCH 650/722] Fix log message

---
 src/Interpreters/Cache/LRUFileCachePriority.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/LRUFileCachePriority.cpp b/src/Interpreters/Cache/LRUFileCachePriority.cpp
index 3ecb1500a8b..ea437c51050 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.cpp
+++ b/src/Interpreters/Cache/LRUFileCachePriority.cpp
@@ -30,7 +30,7 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "Adding zero size entries to LRU queue is not allowed "
-            "(Key: {}, offset: {}", key, offset);
+            "(Key: {}, offset: {})", key, offset);
     }
 
 #ifndef NDEBUG

From fb47eea283771228f6667cba83d05cdba47f18d8 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 21 Jun 2023 16:41:42 +0000
Subject: [PATCH 651/722] Docs: little cleanup of configuration-files.md

I tried to understand in what ways ClickHouse's configuration can be set
up. Unfortunately, the official documentation is quite lacking and
sometimes self-contradictory. After reading some 3rd party guides and
StackOverflow answers, I tried to clean it up a little bit but there is
more work to be done.
---
 docs/en/operations/configuration-files.md | 41 ++++++++++++++---------
 1 file changed, 26 insertions(+), 15 deletions(-)

diff --git a/docs/en/operations/configuration-files.md b/docs/en/operations/configuration-files.md
index b3583e156ad..d3e21cb2364 100644
--- a/docs/en/operations/configuration-files.md
+++ b/docs/en/operations/configuration-files.md
@@ -6,32 +6,43 @@ sidebar_label: Configuration Files
 
 # Configuration Files
 
-ClickHouse supports multi-file configuration management. The main server configuration file is `/etc/clickhouse-server/config.xml` or `/etc/clickhouse-server/config.yaml`. Other files must be in the `/etc/clickhouse-server/config.d` directory. Note, that any configuration file can be written either in XML or YAML, but mixing formats in one file is not supported. For example, you can have main configs as `config.xml` and `users.xml` and write additional files in `config.d` and `users.d` directories in `.yaml`.
+The ClickHouse server can be configured with configuration files in XML or YAML syntax. In most installation types, the ClickHouse server runs with `/etc/clickhouse-server/config.xml` as default configuration file but it is also possible to specify the location of the configuration file manually at server startup using command line option `--config-file=` or `-C`. Additional configuration files may be placed into directory `config.d/` relative to the main configuration file, for example into directory `/etc/clickhouse-server/config.d/`. Files in this directory and the main configuration are merged in a preprocessing step before the configuration is applied in ClickHouse server. Configuration files are merged in alphabetical order. To simplify updates and improve modularization, it is best practice to keep the default `config.xml` file unmodified and place additional customization into `config.d/`.
 
-All XML files should have the same root element, usually `<clickhouse>`. As for YAML, `clickhouse:` should not be present, the parser will insert it automatically.
+It is possible to mix XML and YAML configuration files, for example you could have a main configuration file `config.xml` and additional configuration files `config.d/network.xml`, `config.d/timezone.yaml` and `config.d/keeper.yaml`. Mixing XML and YAML within a single configuration file is not supported. XML configuration files should use `<clickhouse>...</clickhouse>` as top-level tag. In YAML configuration files, `clickhouse:` is optional, the parser inserts it implicitly if absent.
 
-## Override {#override}
+## Overriding Configuration {#override}
 
-Some settings specified in the main configuration file can be overridden in other configuration files:
+The merge of configuration files behaves as one intuitively expects: The contents of both files are combined recursively, children with the same name are replaced by the element of the more specific configuration file. The merge can be customized using attributes `replace` and `remove`.
+- Attribute `replace` means that the element is replaced by the specified one.
+- Attribute `remove` means that the element is deleted.
 
-- The `replace` or `remove` attributes can be specified for the elements of these configuration files.
-- If neither is specified, it combines the contents of elements recursively, replacing values of duplicate children.
-- If `replace` is specified, it replaces the entire element with the specified one.
-- If `remove` is specified, it deletes the element.
+To specify that a value of an element should be replaced by the value of an environment variable, you can use attribute `from_env`.
 
-You can also declare attributes as coming from environment variables by using `from_env="VARIABLE_NAME"`:
+Example with `$MAX_QUERY_SIZE = 150000`:
 
 ```xml
 <clickhouse>
-    <macros>
-        <replica from_env="REPLICA" />
-        <layer from_env="LAYER" />
-        <shard from_env="SHARD" />
-    </macros>
+    <profiles>
+        <default>
+            <max_query_size from_env="MAX_QUERY_SIZE"/>
+        </default>
+    </profiles>
 </clickhouse>
 ```
 
-## Substitution {#substitution}
+which is equal to
+
+``` xml
+<clickhouse>
+    <profiles>
+        <default>
+            <max_query_size/>150000</max_query_size>
+        </default>
+    </profiles>
+</clickhouse>
+```
+
+## Substituting Configuration {#substitution}
 
 The config can also define “substitutions”. If an element has the `incl` attribute, the corresponding substitution from the file will be used as the value. By default, the path to the file with substitutions is `/etc/metrika.xml`. This can be changed in the [include_from](../operations/server-configuration-parameters/settings.md#server_configuration_parameters-include_from) element in the server config. The substitution values are specified in `/clickhouse/substitution_name` elements in this file. If a substitution specified in `incl` does not exist, it is recorded in the log. To prevent ClickHouse from logging missing substitutions, specify the `optional="true"` attribute (for example, settings for [macros](../operations/server-configuration-parameters/settings.md#macros)).
 

From c14930bc19df80cc3d029da5af6a827557727119 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Wed, 21 Jun 2023 13:11:54 -0400
Subject: [PATCH 652/722] bad path

---
 docs/en/sql-reference/statements/set.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/statements/set.md b/docs/en/sql-reference/statements/set.md
index 14f523adc3b..3e5e86eccf7 100644
--- a/docs/en/sql-reference/statements/set.md
+++ b/docs/en/sql-reference/statements/set.md
@@ -10,7 +10,7 @@ sidebar_label: SET
 SET param = value
 ```
 
-Assigns `value` to the `param` [setting](../../operations/settings/index.md) for the current session. You cannot change [server settings](../../operations/server-configuration-parameters/index.md) this way.
+Assigns `value` to the `param` [setting](../../operations/settings/index.md) for the current session. You cannot change [server settings](../../operations/server-configuration-parameters/settings.md) this way.
 
 You can also set all the values from the specified settings profile in a single query.
 

From e87b9ee84668a56824fd197167bcd1b13f097f59 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Wed, 21 Jun 2023 20:25:10 +0300
Subject: [PATCH 653/722] Update AsyncLoader.cpp

---
 src/Common/AsyncLoader.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Common/AsyncLoader.cpp b/src/Common/AsyncLoader.cpp
index 43900c3afd5..9662146e137 100644
--- a/src/Common/AsyncLoader.cpp
+++ b/src/Common/AsyncLoader.cpp
@@ -202,7 +202,7 @@ void AsyncLoader::wait()
 {
     // Because job can create new jobs in other pools we have to recheck in cycle.
     // Also wait for all workers to finish to avoid races on `pool.workers`,
-    // which can be decrease even after all jobs are already finished.
+    // which can decrease even after all jobs are already finished.
     std::unique_lock lock{mutex};
     while (!scheduled_jobs.empty() || hasWorker(lock))
     {

From 38466169c79410b7873c6d30ab3e266541b34c20 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 21 Jun 2023 20:02:19 +0200
Subject: [PATCH 654/722] Better

---
 .../Cache/LRUFileCachePriority.cpp            | 54 ++++++++++---------
 src/Interpreters/Cache/LRUFileCachePriority.h |  3 ++
 2 files changed, 32 insertions(+), 25 deletions(-)

diff --git a/src/Interpreters/Cache/LRUFileCachePriority.cpp b/src/Interpreters/Cache/LRUFileCachePriority.cpp
index ea437c51050..6f142c0cc6d 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.cpp
+++ b/src/Interpreters/Cache/LRUFileCachePriority.cpp
@@ -30,7 +30,7 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
         throw Exception(
             ErrorCodes::LOGICAL_ERROR,
             "Adding zero size entries to LRU queue is not allowed "
-            "(Key: {}, offset: {})", key, offset);
+            "(key: {}, offset: {})", key, offset);
     }
 
 #ifndef NDEBUG
@@ -56,11 +56,9 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
     }
 
     auto iter = queue.insert(queue.end(), Entry(key, offset, size, key_metadata));
-    current_size += size;
-    ++current_elements_num;
 
-    CurrentMetrics::add(CurrentMetrics::FilesystemCacheSize, size);
-    CurrentMetrics::add(CurrentMetrics::FilesystemCacheElements);
+    updateSize(size);
+    updateElementsCount(1);
 
     LOG_TEST(
         log, "Added entry into LRU queue, key: {}, offset: {}, size: {}",
@@ -71,14 +69,11 @@ IFileCachePriority::Iterator LRUFileCachePriority::add(
 
 void LRUFileCachePriority::removeAll(const CacheGuard::Lock &)
 {
-    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheSize, current_size);
-    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements, current_elements_num);
-
     LOG_TEST(log, "Removed all entries from LRU queue");
 
+    updateSize(-current_size);
+    updateElementsCount(-current_elements_num);
     queue.clear();
-    current_size = 0;
-    current_elements_num = 0;
 }
 
 void LRUFileCachePriority::pop(const CacheGuard::Lock &)
@@ -91,11 +86,8 @@ LRUFileCachePriority::LRUQueueIterator LRUFileCachePriority::remove(LRUQueueIter
     /// If size is 0, entry is invalidated, current_elements_num was already updated.
     if (it->size)
     {
-        current_size -= it->size;
-        --current_elements_num;
-
-        CurrentMetrics::sub(CurrentMetrics::FilesystemCacheSize, it->size);
-        CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements);
+        updateSize(-it->size);
+        updateElementsCount(-1);
     }
 
     LOG_TEST(
@@ -105,6 +97,19 @@ LRUFileCachePriority::LRUQueueIterator LRUFileCachePriority::remove(LRUQueueIter
     return queue.erase(it);
 }
 
+void LRUFileCachePriority::updateSize(int64_t size)
+{
+    current_size += size;
+    CurrentMetrics::add(CurrentMetrics::FilesystemCacheSize, size);
+}
+
+void LRUFileCachePriority::updateElementsCount(int64_t num)
+{
+    current_elements_num += num;
+    CurrentMetrics::add(CurrentMetrics::FilesystemCacheElements, num);
+}
+
+
 LRUFileCachePriority::LRUFileCacheIterator::LRUFileCacheIterator(
     LRUFileCachePriority * cache_priority_,
     LRUFileCachePriority::LRUQueueIterator queue_iter_)
@@ -170,10 +175,14 @@ LRUFileCachePriority::LRUFileCacheIterator::remove(const CacheGuard::Lock &)
 
 void LRUFileCachePriority::LRUFileCacheIterator::invalidate()
 {
-    updateSize(-queue_iter->size);
-    chassert(queue_iter->size == 0);
-    --cache_priority->current_elements_num;
-    CurrentMetrics::sub(CurrentMetrics::FilesystemCacheElements);
+    LOG_TEST(
+        cache_priority->log,
+        "Invalidating entry in LRU queue. Key: {}, offset: {}, previous size: {}",
+        queue_iter->key, queue_iter->offset, queue_iter->size);
+
+    cache_priority->updateSize(-queue_iter->size);
+    cache_priority->updateElementsCount(-1);
+    queue_iter->size = 0;
 }
 
 void LRUFileCachePriority::LRUFileCacheIterator::updateSize(int64_t size)
@@ -183,13 +192,8 @@ void LRUFileCachePriority::LRUFileCacheIterator::updateSize(int64_t size)
         "Update size with {} in LRU queue for key: {}, offset: {}, previous size: {}",
         size, queue_iter->key, queue_iter->offset, queue_iter->size);
 
-    cache_priority->current_size += size;
+    cache_priority->updateSize(size);
     queue_iter->size += size;
-
-    CurrentMetrics::add(CurrentMetrics::FilesystemCacheSize, size);
-
-    chassert(cache_priority->current_size >= 0);
-    chassert(queue_iter->size >= 0);
 }
 
 size_t LRUFileCachePriority::LRUFileCacheIterator::use(const CacheGuard::Lock &)
diff --git a/src/Interpreters/Cache/LRUFileCachePriority.h b/src/Interpreters/Cache/LRUFileCachePriority.h
index afa2cfb4613..8dc4eb0a016 100644
--- a/src/Interpreters/Cache/LRUFileCachePriority.h
+++ b/src/Interpreters/Cache/LRUFileCachePriority.h
@@ -33,6 +33,9 @@ public:
     void iterate(IterateFunc && func, const CacheGuard::Lock &) override;
 
 private:
+    void updateElementsCount(int64_t num);
+    void updateSize(int64_t size);
+
     LRUQueue queue;
     Poco::Logger * log = &Poco::Logger::get("LRUFileCachePriority");
 

From 57070a6a6e773b7fa853eb6f7598660558d4ac8e Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Wed, 21 Jun 2023 18:16:52 +0000
Subject: [PATCH 655/722] Ignore "modularization"

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index 73ec64e2f30..46bd0da4236 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1762,6 +1762,7 @@ misconfiguration
 mispredictions
 mmap
 mmapped
+modularization
 moduloOrZero
 mongodb
 monthName

From 9aa4647f4fb2c25a74df952df2d6d815c27e9ee9 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Wed, 21 Jun 2023 20:48:12 +0200
Subject: [PATCH 656/722] Delete feature

---
 .../IO/CachedOnDiskReadBufferFromFile.cpp     |  5 +---
 src/Disks/IO/CachedOnDiskReadBufferFromFile.h |  2 --
 .../IO/CachedOnDiskWriteBufferFromFile.cpp    |  5 +---
 .../IO/CachedOnDiskWriteBufferFromFile.h      |  2 --
 .../Cached/CachedObjectStorage.cpp            | 15 ----------
 .../Cached/CachedObjectStorage.h              |  4 ---
 src/IO/ReadSettings.h                         |  1 -
 src/IO/WriteSettings.h                        |  1 -
 src/Interpreters/Cache/FileCache.cpp          | 14 +++------
 src/Interpreters/Cache/FileCache.h            |  1 -
 src/Interpreters/Cache/FileCacheSettings.cpp  |  2 --
 src/Interpreters/Cache/FileCacheSettings.h    |  2 --
 src/Interpreters/Cache/FileSegment.h          |  7 -----
 src/Interpreters/Cache/Metadata.cpp           |  3 --
 .../InterpreterDescribeCacheQuery.cpp         |  2 --
 .../System/StorageSystemFilesystemCache.cpp   | 29 +++++++++----------
 16 files changed, 20 insertions(+), 75 deletions(-)

diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
index 76d54f9d27c..59cf8f0174c 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.cpp
@@ -69,7 +69,6 @@ CachedOnDiskReadBufferFromFile::CachedOnDiskReadBufferFromFile(
     , allow_seeks_after_first_read(allow_seeks_after_first_read_)
     , use_external_buffer(use_external_buffer_)
     , query_context_holder(cache_->getQueryContextHolder(query_id, settings_))
-    , is_persistent(settings_.is_file_cache_persistent)
     , cache_log(cache_log_)
 {
 }
@@ -125,7 +124,7 @@ void CachedOnDiskReadBufferFromFile::initialize(size_t offset, size_t size)
     }
     else
     {
-        CreateFileSegmentSettings create_settings(is_persistent ? FileSegmentKind::Persistent : FileSegmentKind::Regular);
+        CreateFileSegmentSettings create_settings(FileSegmentKind::Regular);
         file_segments = cache->getOrSet(cache_key, offset, size, file_size.value(), create_settings);
     }
 
@@ -149,8 +148,6 @@ CachedOnDiskReadBufferFromFile::getCacheReadBuffer(const FileSegment & file_segm
 {
     ProfileEventTimeIncrement<Microseconds> watch(ProfileEvents::CachedReadBufferCreateBufferMicroseconds);
 
-    /// Use is_persistent flag from in-memory state of the filesegment,
-    /// because it is consistent with what is written on disk.
     auto path = file_segment.getPathInLocalCache();
 
     ReadSettings local_read_settings{settings};
diff --git a/src/Disks/IO/CachedOnDiskReadBufferFromFile.h b/src/Disks/IO/CachedOnDiskReadBufferFromFile.h
index 8faf23ad343..b4e7701de75 100644
--- a/src/Disks/IO/CachedOnDiskReadBufferFromFile.h
+++ b/src/Disks/IO/CachedOnDiskReadBufferFromFile.h
@@ -147,8 +147,6 @@ private:
 
     FileCache::QueryContextHolderPtr query_context_holder;
 
-    bool is_persistent;
-
     std::shared_ptr<FilesystemCacheLog> cache_log;
 };
 
diff --git a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp
index b7727555480..33d4ed7b3d7 100644
--- a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp
+++ b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.cpp
@@ -194,7 +194,6 @@ CachedOnDiskWriteBufferFromFile::CachedOnDiskWriteBufferFromFile(
     FileCachePtr cache_,
     const String & source_path_,
     const FileCache::Key & key_,
-    bool is_persistent_cache_file_,
     const String & query_id_,
     const WriteSettings & settings_)
     : WriteBufferFromFileDecorator(std::move(impl_))
@@ -202,7 +201,6 @@ CachedOnDiskWriteBufferFromFile::CachedOnDiskWriteBufferFromFile(
     , cache(cache_)
     , source_path(source_path_)
     , key(key_)
-    , is_persistent_cache_file(is_persistent_cache_file_)
     , query_id(query_id_)
     , enable_cache_log(!query_id_.empty() && settings_.enable_filesystem_cache_log)
     , throw_on_error_from_cache(settings_.throw_on_error_from_cache)
@@ -255,8 +253,7 @@ void CachedOnDiskWriteBufferFromFile::cacheData(char * data, size_t size, bool t
 
     try
     {
-        auto segment_kind = is_persistent_cache_file ? FileSegmentKind::Persistent : FileSegmentKind::Regular;
-        if (!cache_writer->write(data, size, current_download_offset, segment_kind))
+        if (!cache_writer->write(data, size, current_download_offset, FileSegmentKind::Regular))
         {
             LOG_INFO(log, "Write-through cache is stopped as cache limit is reached and nothing can be evicted");
             return;
diff --git a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h
index 8642886d6de..8d39b6eed42 100644
--- a/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h
+++ b/src/Disks/IO/CachedOnDiskWriteBufferFromFile.h
@@ -72,7 +72,6 @@ public:
         FileCachePtr cache_,
         const String & source_path_,
         const FileCache::Key & key_,
-        bool is_persistent_cache_file_,
         const String & query_id_,
         const WriteSettings & settings_);
 
@@ -89,7 +88,6 @@ private:
     String source_path;
     FileCache::Key key;
 
-    bool is_persistent_cache_file;
     size_t current_download_offset = 0;
     const String query_id;
 
diff --git a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
index b1cf8226895..3e7c4d12c42 100644
--- a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
+++ b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.cpp
@@ -119,7 +119,6 @@ std::unique_ptr<WriteBufferFromFileBase> CachedObjectStorage::writeObject( /// N
             cache,
             implementation_buffer->getFileName(),
             key,
-            modified_write_settings.is_file_cache_persistent,
             CurrentThread::isInitialized() && CurrentThread::get().getQueryContext() ? std::string(CurrentThread::getQueryId()) : "",
             modified_write_settings);
     }
@@ -164,20 +163,6 @@ void CachedObjectStorage::removeObjectsIfExist(const StoredObjects & objects)
     object_storage->removeObjectsIfExist(objects);
 }
 
-ReadSettings CachedObjectStorage::getAdjustedSettingsFromMetadataFile(const ReadSettings & settings, const std::string & path) const
-{
-    ReadSettings new_settings{settings};
-    new_settings.is_file_cache_persistent = isFileWithPersistentCache(path) && cache_settings.do_not_evict_index_and_mark_files;
-    return new_settings;
-}
-
-WriteSettings CachedObjectStorage::getAdjustedSettingsFromMetadataFile(const WriteSettings & settings, const std::string & path) const
-{
-    WriteSettings new_settings{settings};
-    new_settings.is_file_cache_persistent = isFileWithPersistentCache(path) && cache_settings.do_not_evict_index_and_mark_files;
-    return new_settings;
-}
-
 void CachedObjectStorage::copyObjectToAnotherObjectStorage( // NOLINT
     const StoredObject & object_from,
     const StoredObject & object_to,
diff --git a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h
index ba9fbd02d94..76f16c9d930 100644
--- a/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h
+++ b/src/Disks/ObjectStorages/Cached/CachedObjectStorage.h
@@ -108,10 +108,6 @@ public:
 
     bool supportParallelWrite() const override { return object_storage->supportParallelWrite(); }
 
-    ReadSettings getAdjustedSettingsFromMetadataFile(const ReadSettings & settings, const std::string & path) const override;
-
-    WriteSettings getAdjustedSettingsFromMetadataFile(const WriteSettings & settings, const std::string & path) const override;
-
     const FileCacheSettings & getCacheSettings() const { return cache_settings; }
 
     static bool canUseReadThroughCache(const ReadSettings & settings);
diff --git a/src/IO/ReadSettings.h b/src/IO/ReadSettings.h
index dae4261e92c..87f249823b2 100644
--- a/src/IO/ReadSettings.h
+++ b/src/IO/ReadSettings.h
@@ -98,7 +98,6 @@ struct ReadSettings
     bool enable_filesystem_cache = true;
     bool read_from_filesystem_cache_if_exists_otherwise_bypass_cache = false;
     bool enable_filesystem_cache_log = false;
-    bool is_file_cache_persistent = false; /// Some files can be made non-evictable.
     /// Don't populate cache when the read is not part of query execution (e.g. background thread).
     bool avoid_readthrough_cache_outside_query_context = true;
 
diff --git a/src/IO/WriteSettings.h b/src/IO/WriteSettings.h
index e160796d9a3..8f22e44145a 100644
--- a/src/IO/WriteSettings.h
+++ b/src/IO/WriteSettings.h
@@ -19,7 +19,6 @@ struct WriteSettings
     /// Filesystem cache settings
     bool enable_filesystem_cache_on_write_operations = false;
     bool enable_filesystem_cache_log = false;
-    bool is_file_cache_persistent = false;
     bool throw_on_error_from_cache = false;
 
     bool s3_allow_parallel_part_upload = true;
diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 3d1b85dfbde..1bbc02eceaf 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -52,7 +52,6 @@ namespace ErrorCodes
 
 FileCache::FileCache(const FileCacheSettings & settings)
     : max_file_segment_size(settings.max_file_segment_size)
-    , allow_persistent_files(settings.do_not_evict_index_and_mark_files)
     , bypass_cache_threshold(settings.enable_bypass_cache_with_threashold ? settings.bypass_cache_threashold : 0)
     , delayed_cleanup_interval_ms(settings.delayed_cleanup_interval_ms)
     , log(&Poco::Logger::get("FileCache"))
@@ -642,10 +641,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
     {
         chassert(segment_metadata->file_segment->assertCorrectness());
 
-        const bool is_persistent = allow_persistent_files && segment_metadata->file_segment->isPersistent();
-        const bool releasable = segment_metadata->releasable() && !is_persistent;
-
-        if (releasable)
+        if (segment_metadata->releasable())
         {
             auto segment = segment_metadata->file_segment;
             if (segment->state() == FileSegment::State::DOWNLOADED)
@@ -820,10 +816,6 @@ void FileCache::removeAllReleasable()
 {
     assertInitialized();
 
-    /// Only releasable file segments are evicted.
-    /// `remove_persistent_files` defines whether non-evictable by some criteria files
-    /// (they do not comply with the cache eviction policy) should also be removed.
-
     auto lock = lockCache();
 
     main_priority->iterate([&](LockedKey & locked_key, FileSegmentMetadataPtr segment_metadata)
@@ -926,7 +918,9 @@ void FileCache::loadMetadata()
                     parsed = tryParse<UInt64>(offset, offset_with_suffix.substr(0, delim_pos));
                     if (offset_with_suffix.substr(delim_pos+1) == "persistent")
                     {
-                        segment_kind = FileSegmentKind::Persistent;
+                        /// For compatibility. Persistent files are no loger supported.
+                        fs::remove(offset_it->path());
+                        continue;
                     }
                     if (offset_with_suffix.substr(delim_pos+1) == "temporary")
                     {
diff --git a/src/Interpreters/Cache/FileCache.h b/src/Interpreters/Cache/FileCache.h
index dc5dd67710c..c211fdfc976 100644
--- a/src/Interpreters/Cache/FileCache.h
+++ b/src/Interpreters/Cache/FileCache.h
@@ -131,7 +131,6 @@ private:
     using KeyAndOffset = FileCacheKeyAndOffset;
 
     const size_t max_file_segment_size;
-    const bool allow_persistent_files;
     const size_t bypass_cache_threshold = 0;
     const size_t delayed_cleanup_interval_ms;
 
diff --git a/src/Interpreters/Cache/FileCacheSettings.cpp b/src/Interpreters/Cache/FileCacheSettings.cpp
index 1fe51bf5f3e..dbe3e8ced02 100644
--- a/src/Interpreters/Cache/FileCacheSettings.cpp
+++ b/src/Interpreters/Cache/FileCacheSettings.cpp
@@ -47,8 +47,6 @@ void FileCacheSettings::loadFromConfig(const Poco::Util::AbstractConfiguration &
     else
          bypass_cache_threashold = FILECACHE_BYPASS_THRESHOLD;
 
-    do_not_evict_index_and_mark_files = config.getUInt64(config_prefix + ".do_not_evict_index_and_mark_files", true);
-
     boundary_alignment = config.getUInt64(config_prefix + ".boundary_alignment", DBMS_DEFAULT_BUFFER_SIZE);
 
     delayed_cleanup_interval_ms = config.getUInt64(config_prefix + ".delayed_cleanup_interval_ms", FILECACHE_DELAYED_CLEANUP_INTERVAL_MS);
diff --git a/src/Interpreters/Cache/FileCacheSettings.h b/src/Interpreters/Cache/FileCacheSettings.h
index eeb2a02c131..cddb8fd459b 100644
--- a/src/Interpreters/Cache/FileCacheSettings.h
+++ b/src/Interpreters/Cache/FileCacheSettings.h
@@ -22,8 +22,6 @@ struct FileCacheSettings
     size_t cache_hits_threshold = FILECACHE_DEFAULT_HITS_THRESHOLD;
     bool enable_filesystem_query_cache_limit = false;
 
-    bool do_not_evict_index_and_mark_files = true;
-
     bool enable_bypass_cache_with_threashold = false;
     size_t bypass_cache_threashold = FILECACHE_BYPASS_THRESHOLD;
     size_t delayed_cleanup_interval_ms = FILECACHE_DELAYED_CLEANUP_INTERVAL_MS;
diff --git a/src/Interpreters/Cache/FileSegment.h b/src/Interpreters/Cache/FileSegment.h
index 681c0d719e4..062f168a046 100644
--- a/src/Interpreters/Cache/FileSegment.h
+++ b/src/Interpreters/Cache/FileSegment.h
@@ -37,11 +37,6 @@ enum class FileSegmentKind
      */
     Regular,
 
-    /* `Persistent` file segment can't be evicted from cache,
-     * it should be removed manually.
-     */
-    Persistent,
-
     /* `Temporary` file segment is removed right after releasing.
      * Also corresponding files are removed during cache loading (if any).
      */
@@ -155,8 +150,6 @@ public:
 
     FileSegmentKind getKind() const { return segment_kind; }
 
-    bool isPersistent() const { return segment_kind == FileSegmentKind::Persistent; }
-
     bool isUnbound() const { return is_unbound; }
 
     String getPathInLocalCache() const;
diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 20af931bbc2..495e335b7ae 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -141,9 +141,6 @@ String CacheMetadata::getFileNameForFileSegment(size_t offset, FileSegmentKind s
     String file_suffix;
     switch (segment_kind)
     {
-        case FileSegmentKind::Persistent:
-            file_suffix = "_persistent";
-            break;
         case FileSegmentKind::Temporary:
             file_suffix = "_temporary";
             break;
diff --git a/src/Interpreters/InterpreterDescribeCacheQuery.cpp b/src/Interpreters/InterpreterDescribeCacheQuery.cpp
index ca875ee57b2..1d2c567d16f 100644
--- a/src/Interpreters/InterpreterDescribeCacheQuery.cpp
+++ b/src/Interpreters/InterpreterDescribeCacheQuery.cpp
@@ -24,7 +24,6 @@ static Block getSampleBlock()
         ColumnWithTypeAndName{std::make_shared<DataTypeUInt64>(), "current_size"},
         ColumnWithTypeAndName{std::make_shared<DataTypeUInt64>(), "current_elements"},
         ColumnWithTypeAndName{std::make_shared<DataTypeString>(), "path"},
-        ColumnWithTypeAndName{std::make_shared<DataTypeNumber<UInt8>>(), "do_not_evict_index_and_mark_files"},
     };
     return Block(columns);
 }
@@ -49,7 +48,6 @@ BlockIO InterpreterDescribeCacheQuery::execute()
     res_columns[5]->insert(cache->getUsedCacheSize());
     res_columns[6]->insert(cache->getFileSegmentsNum());
     res_columns[7]->insert(cache->getBasePath());
-    res_columns[8]->insert(settings.do_not_evict_index_and_mark_files);
 
     BlockIO res;
     size_t num_rows = res_columns[0]->size();
diff --git a/src/Storages/System/StorageSystemFilesystemCache.cpp b/src/Storages/System/StorageSystemFilesystemCache.cpp
index 8e9ad2ac501..e03fd9ca081 100644
--- a/src/Storages/System/StorageSystemFilesystemCache.cpp
+++ b/src/Storages/System/StorageSystemFilesystemCache.cpp
@@ -26,7 +26,6 @@ NamesAndTypesList StorageSystemFilesystemCache::getNamesAndTypes()
         {"cache_hits", std::make_shared<DataTypeUInt64>()},
         {"references", std::make_shared<DataTypeUInt64>()},
         {"downloaded_size", std::make_shared<DataTypeUInt64>()},
-        {"persistent", std::make_shared<DataTypeNumber<UInt8>>()},
         {"kind", std::make_shared<DataTypeString>()},
         {"unbound", std::make_shared<DataTypeNumber<UInt8>>()},
     };
@@ -48,25 +47,25 @@ void StorageSystemFilesystemCache::fillData(MutableColumns & res_columns, Contex
 
         for (const auto & file_segment : *file_segments)
         {
-            res_columns[0]->insert(cache_name);
-            res_columns[1]->insert(cache->getBasePath());
+            size_t i = 0;
+            res_columns[i++]->insert(cache_name);
+            res_columns[i++]->insert(cache->getBasePath());
 
             /// Do not use `file_segment->getPathInLocalCache` here because it will lead to nullptr dereference
             /// (because file_segments in getSnapshot doesn't have `cache` field set)
-            res_columns[2]->insert(cache->getPathInLocalCache(file_segment->key(), file_segment->offset(), file_segment->getKind()));
-            res_columns[3]->insert(file_segment->key().toString());
+            res_columns[i++]->insert(cache->getPathInLocalCache(file_segment->key(), file_segment->offset(), file_segment->getKind()));
+            res_columns[i++]->insert(file_segment->key().toString());
 
             const auto & range = file_segment->range();
-            res_columns[4]->insert(range.left);
-            res_columns[5]->insert(range.right);
-            res_columns[6]->insert(range.size());
-            res_columns[7]->insert(FileSegment::stateToString(file_segment->state()));
-            res_columns[8]->insert(file_segment->getHitsCount());
-            res_columns[9]->insert(file_segment->getRefCount());
-            res_columns[10]->insert(file_segment->getDownloadedSize(false));
-            res_columns[11]->insert(file_segment->isPersistent());
-            res_columns[12]->insert(toString(file_segment->getKind()));
-            res_columns[13]->insert(file_segment->isUnbound());
+            res_columns[i++]->insert(range.left);
+            res_columns[i++]->insert(range.right);
+            res_columns[i++]->insert(range.size());
+            res_columns[i++]->insert(FileSegment::stateToString(file_segment->state()));
+            res_columns[i++]->insert(file_segment->getHitsCount());
+            res_columns[i++]->insert(file_segment->getRefCount());
+            res_columns[i++]->insert(file_segment->getDownloadedSize(false));
+            res_columns[i++]->insert(toString(file_segment->getKind()));
+            res_columns[i++]->insert(file_segment->isUnbound());
         }
     }
 }

From 9240a82c6481e3d1caf7d5c28e1e549d143a55e3 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 21 Jun 2023 21:49:00 +0300
Subject: [PATCH 657/722] Update DatabaseReplicated.cpp

---
 src/Databases/DatabaseReplicated.cpp | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/Databases/DatabaseReplicated.cpp b/src/Databases/DatabaseReplicated.cpp
index 7ab450c24f2..f219c73e19d 100644
--- a/src/Databases/DatabaseReplicated.cpp
+++ b/src/Databases/DatabaseReplicated.cpp
@@ -710,8 +710,9 @@ BlockIO DatabaseReplicated::tryEnqueueReplicatedDDL(const ASTPtr & query, Contex
 
 static UUID getTableUUIDIfReplicated(const String & metadata, ContextPtr context)
 {
-    bool looks_like_replicated = metadata.find("ReplicatedMergeTree") != std::string::npos;
-    if (!looks_like_replicated)
+    bool looks_like_replicated = metadata.find("Replicated") != std::string::npos;
+    bool looks_like_merge_tree = metadata.find("MergeTree") != std::string::npos;
+    if (!looks_like_replicated || !looks_like_merge_tree)
         return UUIDHelpers::Nil;
 
     ParserCreateQuery parser;

From 50ee424148913665d3209102823b3bfc1f69c800 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Wed, 21 Jun 2023 21:07:59 +0200
Subject: [PATCH 658/722] do not update digest during recovery

---
 src/Databases/DatabaseReplicated.cpp | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/Databases/DatabaseReplicated.cpp b/src/Databases/DatabaseReplicated.cpp
index f219c73e19d..e468e533818 100644
--- a/src/Databases/DatabaseReplicated.cpp
+++ b/src/Databases/DatabaseReplicated.cpp
@@ -1181,7 +1181,7 @@ void DatabaseReplicated::dropTable(ContextPtr local_context, const String & tabl
     std::lock_guard lock{metadata_mutex};
     UInt64 new_digest = tables_metadata_digest;
     new_digest -= getMetadataHash(table_name);
-    if (txn && !txn->isCreateOrReplaceQuery())
+    if (txn && !txn->isCreateOrReplaceQuery() && !is_recovering)
         txn->addOp(zkutil::makeSetRequest(replica_path + "/digest", toString(new_digest), -1));
 
     DatabaseAtomic::dropTableImpl(local_context, table_name, sync);
@@ -1235,7 +1235,7 @@ void DatabaseReplicated::renameTable(ContextPtr local_context, const String & ta
         new_digest -= DB::getMetadataHash(to_table_name, statement_to);
         new_digest += DB::getMetadataHash(table_name, statement_to);
     }
-    if (txn)
+    if (txn && !is_recovering)
         txn->addOp(zkutil::makeSetRequest(replica_path + "/digest", toString(new_digest), -1));
 
     DatabaseAtomic::renameTable(local_context, table_name, to_database, to_table_name, exchange, dictionary);
@@ -1261,7 +1261,7 @@ void DatabaseReplicated::commitCreateTable(const ASTCreateQuery & query, const S
     std::lock_guard lock{metadata_mutex};
     UInt64 new_digest = tables_metadata_digest;
     new_digest += DB::getMetadataHash(query.getTable(), statement);
-    if (txn && !txn->isCreateOrReplaceQuery())
+    if (txn && !txn->isCreateOrReplaceQuery() && !is_recovering)
         txn->addOp(zkutil::makeSetRequest(replica_path + "/digest", toString(new_digest), -1));
 
     DatabaseAtomic::commitCreateTable(query, table, table_metadata_tmp_path, table_metadata_path, query_context);
@@ -1285,7 +1285,7 @@ void DatabaseReplicated::commitAlterTable(const StorageID & table_id,
     UInt64 new_digest = tables_metadata_digest;
     new_digest -= getMetadataHash(table_id.table_name);
     new_digest += DB::getMetadataHash(table_id.table_name, statement);
-    if (txn)
+    if (txn && !is_recovering)
         txn->addOp(zkutil::makeSetRequest(replica_path + "/digest", toString(new_digest), -1));
 
     DatabaseAtomic::commitAlterTable(table_id, table_metadata_tmp_path, table_metadata_path, statement, query_context);
@@ -1308,7 +1308,7 @@ void DatabaseReplicated::detachTablePermanently(ContextPtr local_context, const
     std::lock_guard lock{metadata_mutex};
     UInt64 new_digest = tables_metadata_digest;
     new_digest -= getMetadataHash(table_name);
-    if (txn)
+    if (txn && !is_recovering)
         txn->addOp(zkutil::makeSetRequest(replica_path + "/digest", toString(new_digest), -1));
 
     DatabaseAtomic::detachTablePermanently(local_context, table_name);
@@ -1332,7 +1332,7 @@ void DatabaseReplicated::removeDetachedPermanentlyFlag(ContextPtr local_context,
     if (attach)
     {
         new_digest += getMetadataHash(table_name);
-        if (txn)
+        if (txn && !is_recovering)
             txn->addOp(zkutil::makeSetRequest(replica_path + "/digest", toString(new_digest), -1));
     }
 

From 23120c44679902163832c27d2a9787a502e45d50 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Wed, 21 Jun 2023 22:32:33 +0200
Subject: [PATCH 659/722] fix build

---
 src/IO/LZMADeflatingWriteBuffer.h | 2 ++
 src/IO/Lz4DeflatingWriteBuffer.h  | 2 ++
 src/IO/ZlibDeflatingWriteBuffer.h | 2 ++
 src/IO/ZstdDeflatingWriteBuffer.h | 2 ++
 4 files changed, 8 insertions(+)

diff --git a/src/IO/LZMADeflatingWriteBuffer.h b/src/IO/LZMADeflatingWriteBuffer.h
index 5a0864d6071..2e135455e00 100644
--- a/src/IO/LZMADeflatingWriteBuffer.h
+++ b/src/IO/LZMADeflatingWriteBuffer.h
@@ -21,6 +21,8 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
+    ~LZMADeflatingWriteBuffer() override;
+
 private:
     void nextImpl() override;
 
diff --git a/src/IO/Lz4DeflatingWriteBuffer.h b/src/IO/Lz4DeflatingWriteBuffer.h
index a6440f8854f..68873b5f8ee 100644
--- a/src/IO/Lz4DeflatingWriteBuffer.h
+++ b/src/IO/Lz4DeflatingWriteBuffer.h
@@ -21,6 +21,8 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
+    ~Lz4DeflatingWriteBuffer() override;
+
 private:
     void nextImpl() override;
 
diff --git a/src/IO/ZlibDeflatingWriteBuffer.h b/src/IO/ZlibDeflatingWriteBuffer.h
index 05d6e528a23..58e709b54e6 100644
--- a/src/IO/ZlibDeflatingWriteBuffer.h
+++ b/src/IO/ZlibDeflatingWriteBuffer.h
@@ -24,6 +24,8 @@ public:
             char * existing_memory = nullptr,
             size_t alignment = 0);
 
+    ~ZlibDeflatingWriteBuffer() override;
+
 private:
     void nextImpl() override;
 
diff --git a/src/IO/ZstdDeflatingWriteBuffer.h b/src/IO/ZstdDeflatingWriteBuffer.h
index 11e34e2890f..ba83c18d354 100644
--- a/src/IO/ZstdDeflatingWriteBuffer.h
+++ b/src/IO/ZstdDeflatingWriteBuffer.h
@@ -21,6 +21,8 @@ public:
         char * existing_memory = nullptr,
         size_t alignment = 0);
 
+    ~ZstdDeflatingWriteBuffer() override;
+
     void sync() override
     {
         out->sync();

From ad0677147f6b99de4d5b4ed2b96bb9a5fdc2059f Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 21 Jun 2023 21:31:54 +0000
Subject: [PATCH 660/722] Trying slightly improve eviction path

+ less copying of shared pointers
+ less indirection in overflow check
---
 src/Interpreters/Cache/FileCache.cpp        | 40 ++++++++++++---------
 src/Interpreters/Cache/IFileCachePriority.h |  2 +-
 2 files changed, 25 insertions(+), 17 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 710d08a01cd..3c5cf555ac9 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -615,9 +615,9 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
 
     struct EvictionCandidates
     {
-        explicit EvictionCandidates(KeyMetadataPtr key_metadata_) : key_metadata(key_metadata_) {}
+        explicit EvictionCandidates(const KeyMetadataPtr & key_metadata_) : key_metadata(key_metadata_) {}
 
-        void add(FileSegmentMetadataPtr candidate)
+        void add(const FileSegmentMetadataPtr & candidate)
         {
             candidate->removal_candidate = true;
             candidates.push_back(candidate);
@@ -638,7 +638,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
     std::unordered_map<Key, EvictionCandidates> to_delete;
     size_t freeable_space = 0, freeable_count = 0;
 
-    auto iterate_func = [&](LockedKey & locked_key, FileSegmentMetadataPtr segment_metadata)
+    auto iterate_func = [&](LockedKey & locked_key, const FileSegmentMetadataPtr & segment_metadata)
     {
         chassert(segment_metadata->file_segment->assertCorrectness());
 
@@ -658,7 +658,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
                 it->second.add(segment_metadata);
 
                 freeable_space += segment_metadata->size();
-                freeable_count += 1;
+                ++freeable_count;
 
                 return PriorityIterationResult::CONTINUE;
             }
@@ -683,7 +683,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
         if (is_query_priority_overflow())
         {
             query_priority->iterate(
-                [&](LockedKey & locked_key, FileSegmentMetadataPtr segment_metadata)
+                [&](LockedKey & locked_key, const FileSegmentMetadataPtr & segment_metadata)
                 { return is_query_priority_overflow() ? iterate_func(locked_key, segment_metadata) : PriorityIterationResult::BREAK; },
                 cache_lock);
 
@@ -696,14 +696,22 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
             file_segment.key(), file_segment.offset());
     }
 
-    auto is_main_priority_overflow = [&]
+    auto is_main_priority_overflow = [main_priority_size_limit = main_priority->getSizeLimit(),
+                                      main_priority_elements_limit = main_priority->getElementsLimit(),
+                                      size,
+                                      &freeable_space,
+                                      &freeable_count,
+                                      &file_segment,
+                                      &cache_lock,
+                                      main_priority = this->main_priority.get(),
+                                      log = this->log]
     {
-        /// max_size == 0 means unlimited cache size,
-        /// max_element_size == 0 means unlimited number of cache elements.
-        const bool is_overflow = (main_priority->getSizeLimit() != 0
-                                  && (main_priority->getSize(cache_lock) + size - freeable_space > main_priority->getSizeLimit()))
-            || (main_priority->getElementsLimit() != 0
-                && freeable_count == 0 && main_priority->getElementsCount(cache_lock) == main_priority->getElementsLimit());
+        const bool is_overflow =
+            /// size_limit == 0 means unlimited cache size
+            (main_priority_size_limit != 0 && (main_priority->getSize(cache_lock) + size - freeable_space > main_priority_size_limit))
+            /// elements_limit == 0 means unlimited number of cache elements
+            || (main_priority_elements_limit != 0 && freeable_count == 0
+                && main_priority->getElementsCount(cache_lock) == main_priority_elements_limit);
 
         LOG_TEST(
             log, "Overflow: {}, size: {}, ready to remove: {} ({} in number), current cache size: {}/{}, elements: {}/{}, while reserving for {}:{}",
@@ -718,7 +726,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
     if (is_main_priority_overflow())
     {
         main_priority->iterate(
-            [&](LockedKey & locked_key, FileSegmentMetadataPtr segment_metadata)
+            [&](LockedKey & locked_key, const FileSegmentMetadataPtr & segment_metadata)
             { return is_main_priority_overflow() ? iterate_func(locked_key, segment_metadata) : PriorityIterationResult::BREAK; },
             cache_lock);
 
@@ -831,7 +839,7 @@ void FileCache::removeAllReleasable()
 
     auto lock = lockCache();
 
-    main_priority->iterate([&](LockedKey & locked_key, FileSegmentMetadataPtr segment_metadata)
+    main_priority->iterate([&](LockedKey & locked_key, const FileSegmentMetadataPtr & segment_metadata)
     {
         if (segment_metadata->releasable())
         {
@@ -1065,7 +1073,7 @@ FileSegmentsHolderPtr FileCache::dumpQueue()
     assertInitialized();
 
     FileSegments file_segments;
-    main_priority->iterate([&](LockedKey &, FileSegmentMetadataPtr segment_metadata)
+    main_priority->iterate([&](LockedKey &, const FileSegmentMetadataPtr & segment_metadata)
     {
         file_segments.push_back(FileSegment::getSnapshot(segment_metadata->file_segment));
         return PriorityIterationResult::CONTINUE;
@@ -1105,7 +1113,7 @@ size_t FileCache::getFileSegmentsNum() const
 void FileCache::assertCacheCorrectness()
 {
     auto lock = lockCache();
-    main_priority->iterate([&](LockedKey &, FileSegmentMetadataPtr segment_metadata)
+    main_priority->iterate([&](LockedKey &, const FileSegmentMetadataPtr & segment_metadata)
     {
         const auto & file_segment = *segment_metadata->file_segment;
         UNUSED(file_segment);
diff --git a/src/Interpreters/Cache/IFileCachePriority.h b/src/Interpreters/Cache/IFileCachePriority.h
index 93343398783..9af869357d3 100644
--- a/src/Interpreters/Cache/IFileCachePriority.h
+++ b/src/Interpreters/Cache/IFileCachePriority.h
@@ -64,7 +64,7 @@ public:
         CONTINUE,
         REMOVE_AND_CONTINUE,
     };
-    using IterateFunc = std::function<IterationResult(LockedKey &, FileSegmentMetadataPtr)>;
+    using IterateFunc = std::function<IterationResult(LockedKey &, const FileSegmentMetadataPtr &)>;
 
     IFileCachePriority(size_t max_size_, size_t max_elements_) : max_size(max_size_), max_elements(max_elements_) {}
 

From e3b43c2b8862d25934b7274bf9d5f3f2a4292a55 Mon Sep 17 00:00:00 2001
From: Igor Nikonov <igor@clickhouse.com>
Date: Wed, 21 Jun 2023 21:54:44 +0000
Subject: [PATCH 661/722] Move instead of copy

---
 src/Interpreters/Cache/FileCache.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 3c5cf555ac9..17d2c332887 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -615,7 +615,7 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
 
     struct EvictionCandidates
     {
-        explicit EvictionCandidates(const KeyMetadataPtr & key_metadata_) : key_metadata(key_metadata_) {}
+        explicit EvictionCandidates(KeyMetadataPtr key_metadata_) : key_metadata(std::move(key_metadata_)) {}
 
         void add(const FileSegmentMetadataPtr & candidate)
         {

From a050b9e9d98fb25270e5cf41b98135fe44f6d8f2 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 22 Jun 2023 01:28:52 +0300
Subject: [PATCH 662/722] Update FileCache.cpp

---
 src/Interpreters/Cache/FileCache.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index c1256e43afa..f42fc1f8dfc 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -923,7 +923,7 @@ void FileCache::loadMetadata()
                     parsed = tryParse<UInt64>(offset, offset_with_suffix.substr(0, delim_pos));
                     if (offset_with_suffix.substr(delim_pos+1) == "persistent")
                     {
-                        /// For compatibility. Persistent files are no loger supported.
+                        /// For compatibility. Persistent files are no longer supported.
                         fs::remove(offset_it->path());
                         continue;
                     }

From c96a3a8b15754a140d70bf4dc7acd2ccb0e657ab Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Mon, 19 Jun 2023 16:47:19 +0000
Subject: [PATCH 663/722] Unforget to pass callback to readBigAt() in
 ParallelReadBuffer

---
 src/IO/ParallelReadBuffer.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/IO/ParallelReadBuffer.cpp b/src/IO/ParallelReadBuffer.cpp
index fd228336093..92af1ed0b04 100644
--- a/src/IO/ParallelReadBuffer.cpp
+++ b/src/IO/ParallelReadBuffer.cpp
@@ -256,7 +256,7 @@ void ParallelReadBuffer::readerThreadFunction(ReadWorkerPtr read_worker)
             return false;
         };
 
-        size_t r = input.readBigAt(read_worker->segment.data(), read_worker->segment.size(), read_worker->start_offset);
+        size_t r = input.readBigAt(read_worker->segment.data(), read_worker->segment.size(), read_worker->start_offset, on_progress);
 
         if (!on_progress(r) && r < read_worker->segment.size())
             throw Exception(

From f0dcefa0e19c62e3200808065cf1617faa85aa97 Mon Sep 17 00:00:00 2001
From: santrancisco <san.tran@ebfe.pw>
Date: Thu, 22 Jun 2023 18:00:39 +1000
Subject: [PATCH 664/722] Fixing git submodule back to our own fork as this
 pull https://github.com/apache/orc/pull/1542 is now merged into apache/orc
 repository

---
 .gitmodules | 2 +-
 contrib/orc | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.gitmodules b/.gitmodules
index 955b5cc27bb..8bf4f6e8975 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -86,7 +86,7 @@
 	url = https://github.com/ClickHouse/fastops
 [submodule "contrib/orc"]
 	path = contrib/orc
-	url = https://github.com/wpleonardo/orc
+	url = https://github.com/ClickHouse/orc
 [submodule "contrib/sparsehash-c11"]
 	path = contrib/sparsehash-c11
 	url = https://github.com/sparsehash/sparsehash-c11
diff --git a/contrib/orc b/contrib/orc
index 7d90ebb7c11..568d1d60c25 160000
--- a/contrib/orc
+++ b/contrib/orc
@@ -1 +1 @@
-Subproject commit 7d90ebb7c11b73041dadd276088cb2c1ee2d93d1
+Subproject commit 568d1d60c250af1890f226c182bc15bd8cc94cf1

From 0c440b9d6f98bf1630e1b23ed058450086488697 Mon Sep 17 00:00:00 2001
From: Anton Kozlov <anton@cloudflare.com>
Date: Wed, 3 May 2023 12:59:19 +0000
Subject: [PATCH 665/722] Report loading status for executable dictionaries
 correctly

---
 .../ExecutableDictionarySource.cpp            | 17 +++++--
 .../ExecutablePoolDictionarySource.cpp        |  1 +
 src/Processors/Sources/ShellCommandSource.cpp |  4 ++
 src/Processors/Sources/ShellCommandSource.h   |  3 ++
 ...utable_missing_strict_check_dictionary.xml | 29 +++++++++++
 .../test_executable_dictionary/test.py        | 48 +++++++++++--------
 6 files changed, 79 insertions(+), 23 deletions(-)
 create mode 100644 tests/integration/test_executable_dictionary/dictionaries/executable_missing_strict_check_dictionary.xml

diff --git a/src/Dictionaries/ExecutableDictionarySource.cpp b/src/Dictionaries/ExecutableDictionarySource.cpp
index 91f914fb7ad..e40ef07de9e 100644
--- a/src/Dictionaries/ExecutableDictionarySource.cpp
+++ b/src/Dictionaries/ExecutableDictionarySource.cpp
@@ -114,7 +114,10 @@ QueryPipeline ExecutableDictionarySource::loadAll()
     auto command = configuration.command;
     updateCommandIfNeeded(command, coordinator_configuration.execute_direct, context);
 
-    return QueryPipeline(coordinator->createPipe(command, configuration.command_arguments, sample_block, context));
+    ShellCommandSourceConfiguration command_configuration {
+        .check_exit_code = true,
+    };
+    return QueryPipeline(coordinator->createPipe(command, configuration.command_arguments, {}, sample_block, context, command_configuration));
 }
 
 QueryPipeline ExecutableDictionarySource::loadUpdatedAll()
@@ -148,7 +151,11 @@ QueryPipeline ExecutableDictionarySource::loadUpdatedAll()
     update_time = new_update_time;
 
     LOG_TRACE(log, "loadUpdatedAll {}", command);
-    return QueryPipeline(coordinator->createPipe(command, command_arguments, sample_block, context));
+
+    ShellCommandSourceConfiguration command_configuration {
+        .check_exit_code = true,
+    };
+    return QueryPipeline(coordinator->createPipe(command, command_arguments, {}, sample_block, context, command_configuration));
 }
 
 QueryPipeline ExecutableDictionarySource::loadIds(const std::vector<UInt64> & ids)
@@ -179,7 +186,11 @@ QueryPipeline ExecutableDictionarySource::getStreamForBlock(const Block & block)
     Pipes shell_input_pipes;
     shell_input_pipes.emplace_back(std::move(shell_input_pipe));
 
-    auto pipe = coordinator->createPipe(command, configuration.command_arguments, std::move(shell_input_pipes), sample_block, context);
+    ShellCommandSourceConfiguration command_configuration {
+        .check_exit_code = true,
+    };
+
+    auto pipe = coordinator->createPipe(command, configuration.command_arguments, std::move(shell_input_pipes), sample_block, context, command_configuration);
 
     if (configuration.implicit_key)
         pipe.addTransform(std::make_shared<TransformWithAdditionalColumns>(block, pipe.getHeader()));
diff --git a/src/Dictionaries/ExecutablePoolDictionarySource.cpp b/src/Dictionaries/ExecutablePoolDictionarySource.cpp
index 0cc7696585f..94685060a46 100644
--- a/src/Dictionaries/ExecutablePoolDictionarySource.cpp
+++ b/src/Dictionaries/ExecutablePoolDictionarySource.cpp
@@ -132,6 +132,7 @@ QueryPipeline ExecutablePoolDictionarySource::getStreamForBlock(const Block & bl
     ShellCommandSourceConfiguration command_configuration;
     command_configuration.read_fixed_number_of_rows = true;
     command_configuration.number_of_rows_to_read = block.rows();
+    command_configuration.check_exit_code = true;
 
     Pipes shell_input_pipes;
     shell_input_pipes.emplace_back(std::move(shell_input_pipe));
diff --git a/src/Processors/Sources/ShellCommandSource.cpp b/src/Processors/Sources/ShellCommandSource.cpp
index 8a7bbcf3261..ace175f251c 100644
--- a/src/Processors/Sources/ShellCommandSource.cpp
+++ b/src/Processors/Sources/ShellCommandSource.cpp
@@ -352,7 +352,11 @@ namespace
                 }
 
                 if (!executor->pull(chunk))
+                {
+                    if (configuration.check_exit_code)
+                        command->wait();
                     return {};
+                }
 
                 current_read_rows += chunk.getNumRows();
             }
diff --git a/src/Processors/Sources/ShellCommandSource.h b/src/Processors/Sources/ShellCommandSource.h
index b9afaa345cf..6dc6781cc4c 100644
--- a/src/Processors/Sources/ShellCommandSource.h
+++ b/src/Processors/Sources/ShellCommandSource.h
@@ -33,6 +33,9 @@ struct ShellCommandSourceConfiguration
     size_t number_of_rows_to_read = 0;
     /// Max block size
     size_t max_block_size = DEFAULT_BLOCK_SIZE;
+    /// Will throw if the command exited with
+    /// non-zero status code
+    size_t check_exit_code = false;
 };
 
 class ShellCommandSourceCoordinator
diff --git a/tests/integration/test_executable_dictionary/dictionaries/executable_missing_strict_check_dictionary.xml b/tests/integration/test_executable_dictionary/dictionaries/executable_missing_strict_check_dictionary.xml
new file mode 100644
index 00000000000..8562851e69c
--- /dev/null
+++ b/tests/integration/test_executable_dictionary/dictionaries/executable_missing_strict_check_dictionary.xml
@@ -0,0 +1,29 @@
+<dictionaries>
+  <dictionary>
+    <name>executable_input_missing_executable</name>
+    <source>
+      <executable>
+        <!-- OOPS! executable not found -->
+        <command>executable_not_found</command>
+        <format>CSV</format>
+      </executable>
+    </source>
+    <lifetime>
+      <min>86400</min>
+      <max>90000</max>
+    </lifetime>
+    <layout>
+      <flat />
+    </layout>
+    <structure>
+        <id>
+            <name>input</name>
+        </id>
+        <attribute>
+            <name>result</name>
+            <type>String</type>
+            <null_value></null_value>
+        </attribute>
+    </structure>
+  </dictionary>
+</dictionaries>
diff --git a/tests/integration/test_executable_dictionary/test.py b/tests/integration/test_executable_dictionary/test.py
index 43e6ec0a800..22f3442bb95 100644
--- a/tests/integration/test_executable_dictionary/test.py
+++ b/tests/integration/test_executable_dictionary/test.py
@@ -217,33 +217,21 @@ def test_executable_implicit_input_argument_python(started_cluster):
 
 def test_executable_input_signalled_python(started_cluster):
     skip_test_msan(node)
-    assert (
-        node.query(
-            "SELECT dictGet('executable_input_signalled_python', 'result', toUInt64(1))"
-        )
-        == "Default result\n"
+    assert node.query_and_get_error(
+        "SELECT dictGet('executable_input_signalled_python', 'result', toUInt64(1))"
     )
-    assert (
-        node.query(
-            "SELECT dictGet('executable_input_signalled_pool_python', 'result', toUInt64(1))"
-        )
-        == "Default result\n"
+    assert node.query_and_get_error(
+        "SELECT dictGet('executable_input_signalled_pool_python', 'result', toUInt64(1))"
     )
 
 
 def test_executable_implicit_input_signalled_python(started_cluster):
     skip_test_msan(node)
-    assert (
-        node.query(
-            "SELECT dictGet('executable_implicit_input_signalled_python', 'result', toUInt64(1))"
-        )
-        == "Default result\n"
+    assert node.query_and_get_error(
+        "SELECT dictGet('executable_implicit_input_signalled_python', 'result', toUInt64(1))"
     )
-    assert (
-        node.query(
-            "SELECT dictGet('executable_implicit_input_signalled_pool_python', 'result', toUInt64(1))"
-        )
-        == "Default result\n"
+    assert node.query_and_get_error(
+        "SELECT dictGet('executable_implicit_input_signalled_pool_python', 'result', toUInt64(1))"
     )
 
 
@@ -482,3 +470,23 @@ def test_executable_source_updated_python(started_cluster):
         )
         == "Value 1 1\n"
     )
+
+
+def test_executable_source_exit_code_check(started_cluster):
+    skip_test_msan(node)
+    assert "DB::Exception" in node.query_and_get_error(
+        "SELECT * FROM dictionary(executable_input_missing_executable) ORDER BY input"
+    )
+    assert "DB::Exception" in node.query_and_get_error(
+        "SELECT dictGet('executable_input_missing_executable', 'result', toUInt64(1))"
+    )
+
+    assert (
+        node.query(
+            "SELECT status FROM system.dictionaries WHERE name='executable_input_missing_executable'"
+        )
+        == "FAILED\n"
+    )
+    assert "DB::Exception" in node.query(
+        "SELECT last_exception FROM system.dictionaries WHERE name='executable_input_missing_executable'"
+    )

From b3ce64caa5d548edbfa93d15f55062f572b60fd7 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 22 Jun 2023 12:55:05 +0200
Subject: [PATCH 666/722] Fix tests

---
 tests/config/config.d/storage_conf.xml        | 13 ---
 .../02344_describe_cache.reference            |  4 +-
 ...ilesystem_cache_persistent_files.reference | 79 -------------------
 ...2382_filesystem_cache_persistent_files.sql | 76 ------------------
 4 files changed, 2 insertions(+), 170 deletions(-)
 delete mode 100644 tests/queries/0_stateless/02382_filesystem_cache_persistent_files.reference
 delete mode 100644 tests/queries/0_stateless/02382_filesystem_cache_persistent_files.sql

diff --git a/tests/config/config.d/storage_conf.xml b/tests/config/config.d/storage_conf.xml
index dee03307177..deee71bd812 100644
--- a/tests/config/config.d/storage_conf.xml
+++ b/tests/config/config.d/storage_conf.xml
@@ -57,7 +57,6 @@
                 <path>s3_cache/</path>
                 <max_size>128Mi</max_size>
                 <cache_on_write_operations>1</cache_on_write_operations>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache>
             <s3_cache_2>
@@ -65,7 +64,6 @@
                 <disk>s3_disk_2</disk>
                 <path>s3_cache_2/</path>
                 <max_size>128Mi</max_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <max_file_segment_size>100Mi</max_file_segment_size>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_2>
@@ -77,7 +75,6 @@
                 <data_cache_max_size>22548578304</data_cache_max_size>
                 <cache_on_write_operations>1</cache_on_write_operations>
                 <enable_cache_hits_threshold>1</enable_cache_hits_threshold>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_3>
             <s3_cache_4>
@@ -87,7 +84,6 @@
                 <max_size>128Mi</max_size>
                 <cache_on_write_operations>1</cache_on_write_operations>
                 <enable_filesystem_query_cache_limit>1</enable_filesystem_query_cache_limit>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_4>
             <s3_cache_5>
@@ -95,7 +91,6 @@
                 <disk>s3_disk_5</disk>
                 <path>s3_cache_5/</path>
                 <max_size>128Mi</max_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_5>
             <s3_cache_6>
@@ -103,7 +98,6 @@
                 <disk>s3_disk_6</disk>
                 <path>s3_cache_6/</path>
                 <max_size>128Mi</max_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <enable_bypass_cache_with_threashold>1</enable_bypass_cache_with_threashold>
                 <bypass_cache_threashold>100</bypass_cache_threashold>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
@@ -113,7 +107,6 @@
                 <disk>s3_disk_6</disk>
                 <path>s3_cache_small/</path>
                 <max_size>1000</max_size>
-                <do_not_evict_index_and_mark_files>1</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_small>
             <s3_cache_small_segment_size>
@@ -122,7 +115,6 @@
                 <path>s3_cache_small_segment_size/</path>
                 <max_size>128Mi</max_size>
                 <max_file_segment_size>10Ki</max_file_segment_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <cache_on_write_operations>1</cache_on_write_operations>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_small_segment_size>
@@ -146,7 +138,6 @@
                 <path>local_cache/</path>
                 <max_size>22548578304</max_size>
                 <cache_on_write_operations>1</cache_on_write_operations>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </local_cache>
             <local_cache_2>
@@ -154,7 +145,6 @@
                 <disk>local_disk</disk>
                 <path>local_cache_2/</path>
                 <max_size>22548578304</max_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </local_cache_2>
             <local_cache_3>
@@ -164,7 +154,6 @@
                 <max_size>22548578304</max_size>
                 <cache_on_write_operations>1</cache_on_write_operations>
                 <enable_cache_hits_threshold>1</enable_cache_hits_threshold>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </local_cache_3>
             <!-- multi layer cache -->
@@ -173,7 +162,6 @@
                 <disk>s3_cache_5</disk>
                 <path>s3_cache_multi/</path>
                 <max_size>22548578304</max_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_multi>
             <s3_cache_multi_2>
@@ -181,7 +169,6 @@
                 <disk>s3_cache_multi</disk>
                 <path>s3_cache_multi_2/</path>
                 <max_size>22548578304</max_size>
-                <do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>
                 <delayed_cleanup_interval_ms>100</delayed_cleanup_interval_ms>
             </s3_cache_multi_2>
         </disks>
diff --git a/tests/queries/0_stateless/02344_describe_cache.reference b/tests/queries/0_stateless/02344_describe_cache.reference
index d8a2ffab1fa..2e6df4a6a0b 100644
--- a/tests/queries/0_stateless/02344_describe_cache.reference
+++ b/tests/queries/0_stateless/02344_describe_cache.reference
@@ -1,2 +1,2 @@
-134217728	10000000	8388608	1	0	0	0	/var/lib/clickhouse/caches/s3_cache/	0
-134217728	10000000	104857600	0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/	0
+134217728	10000000	8388608	1	0	0	0	/var/lib/clickhouse/caches/s3_cache/
+134217728	10000000	104857600	0	0	0	0	/var/lib/clickhouse/caches/s3_cache_2/
diff --git a/tests/queries/0_stateless/02382_filesystem_cache_persistent_files.reference b/tests/queries/0_stateless/02382_filesystem_cache_persistent_files.reference
deleted file mode 100644
index e77afc98007..00000000000
--- a/tests/queries/0_stateless/02382_filesystem_cache_persistent_files.reference
+++ /dev/null
@@ -1,79 +0,0 @@
--- { echo }
-
-SET enable_filesystem_cache_on_write_operations=0;
-SYSTEM DROP FILESYSTEM CACHE;
-DROP TABLE IF EXISTS nopers;
-CREATE TABLE nopers (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache', min_bytes_for_wide_part = 10485760, compress_marks=false, compress_primary_key=false;
-SYSTEM STOP MERGES nopers;
-INSERT INTO nopers SELECT number, toString(number) FROM numbers(10);
-SELECT * FROM nopers FORMAT Null;
-SELECT sum(size) FROM system.filesystem_cache;
-195
-SELECT extract(local_path, '.*/([\w.]+)') as file, extract(cache_path, '.*/([\w.]+)') as cache, size
-FROM
-(
-    SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path
-    FROM system.remote_data_paths
-) AS data_paths
-INNER JOIN
-    system.filesystem_cache AS caches
-ON data_paths.cache_path = caches.cache_path
-ORDER BY file, cache, size;
-data.bin	0	114
-data.mrk3	0	80
-format_version.txt	0	1
-DROP TABLE IF EXISTS test;
-CREATE TABLE test (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache_small', min_bytes_for_wide_part = 10485760, compress_marks=false, compress_primary_key=false;
-SYSTEM STOP MERGES test;
-INSERT INTO test SELECT number, toString(number) FROM numbers(100);
-SELECT * FROM test FORMAT Null;
-SELECT sum(size) FROM system.filesystem_cache;
-1021
-SELECT count() FROM (SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path FROM system.remote_data_paths ) AS data_paths INNER JOIN system.filesystem_cache AS caches ON data_paths.cache_path = caches.cache_path;
-5
-SELECT count() FROM system.filesystem_cache;
-5
-SELECT extract(local_path, '.*/([\w.]+)') as file, extract(cache_path, '.*/([\w.]+)') as cache, size
-FROM
-(
-    SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path
-    FROM system.remote_data_paths
-) AS data_paths
-INNER JOIN
-    system.filesystem_cache AS caches
-ON data_paths.cache_path = caches.cache_path
-ORDER BY file, cache, size;
-data.bin	0	114
-data.bin	0	746
-data.mrk3	0	80
-data.mrk3	0_persistent	80
-format_version.txt	0	1
-DROP TABLE IF EXISTS test2;
-CREATE TABLE test2 (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache_small', min_bytes_for_wide_part = 10485760, compress_marks=false, compress_primary_key=false;
-SYSTEM STOP MERGES test2;
-INSERT INTO test2 SELECT number, toString(number) FROM numbers(100000);
-SELECT * FROM test2 FORMAT Null;
-SELECT sum(size) FROM system.filesystem_cache;
-795
-SELECT count() FROM (SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path FROM system.remote_data_paths ) AS data_paths INNER JOIN system.filesystem_cache AS caches ON data_paths.cache_path = caches.cache_path;
-5
-SELECT count() FROM system.filesystem_cache;
-5
-SELECT extract(local_path, '.*/([\w.]+)') as file, extract(cache_path, '.*/([\w.]+)') as cache, size
-FROM
-(
-    SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path
-    FROM system.remote_data_paths
-) AS data_paths
-INNER JOIN
-    system.filesystem_cache AS caches
-ON data_paths.cache_path = caches.cache_path
-ORDER BY file, cache, size;
-data.bin	0	114
-data.mrk3	0	80
-data.mrk3	0_persistent	80
-data.mrk3	0_persistent	520
-format_version.txt	0	1
-DROP TABLE test;
-DROP TABLE test2;
-DROP TABLE nopers;
diff --git a/tests/queries/0_stateless/02382_filesystem_cache_persistent_files.sql b/tests/queries/0_stateless/02382_filesystem_cache_persistent_files.sql
deleted file mode 100644
index 6486840602e..00000000000
--- a/tests/queries/0_stateless/02382_filesystem_cache_persistent_files.sql
+++ /dev/null
@@ -1,76 +0,0 @@
--- Tags: no-fasttest, no-parallel, no-s3-storage, no-random-settings
-
--- { echo }
-
-SET enable_filesystem_cache_on_write_operations=0;
-
-SYSTEM DROP FILESYSTEM CACHE;
-
-DROP TABLE IF EXISTS nopers;
-CREATE TABLE nopers (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache', min_bytes_for_wide_part = 10485760, compress_marks=false, compress_primary_key=false;
-SYSTEM STOP MERGES nopers;
-
-INSERT INTO nopers SELECT number, toString(number) FROM numbers(10);
-SELECT * FROM nopers FORMAT Null;
-SELECT sum(size) FROM system.filesystem_cache;
-
-SELECT extract(local_path, '.*/([\w.]+)') as file, extract(cache_path, '.*/([\w.]+)') as cache, size
-FROM
-(
-    SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path
-    FROM system.remote_data_paths
-) AS data_paths
-INNER JOIN
-    system.filesystem_cache AS caches
-ON data_paths.cache_path = caches.cache_path
-ORDER BY file, cache, size;
-
-DROP TABLE IF EXISTS test;
-CREATE TABLE test (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache_small', min_bytes_for_wide_part = 10485760, compress_marks=false, compress_primary_key=false;
-SYSTEM STOP MERGES test;
-
-INSERT INTO test SELECT number, toString(number) FROM numbers(100);
-SELECT * FROM test FORMAT Null;
-
-SELECT sum(size) FROM system.filesystem_cache;
-
-SELECT count() FROM (SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path FROM system.remote_data_paths ) AS data_paths INNER JOIN system.filesystem_cache AS caches ON data_paths.cache_path = caches.cache_path;
-SELECT count() FROM system.filesystem_cache;
-
-SELECT extract(local_path, '.*/([\w.]+)') as file, extract(cache_path, '.*/([\w.]+)') as cache, size
-FROM
-(
-    SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path
-    FROM system.remote_data_paths
-) AS data_paths
-INNER JOIN
-    system.filesystem_cache AS caches
-ON data_paths.cache_path = caches.cache_path
-ORDER BY file, cache, size;
-
-DROP TABLE IF EXISTS test2;
-CREATE TABLE test2 (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache_small', min_bytes_for_wide_part = 10485760, compress_marks=false, compress_primary_key=false;
-SYSTEM STOP MERGES test2;
-
-INSERT INTO test2 SELECT number, toString(number) FROM numbers(100000);
-SELECT * FROM test2 FORMAT Null;
-
-SELECT sum(size) FROM system.filesystem_cache;
-
-SELECT count() FROM (SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path FROM system.remote_data_paths ) AS data_paths INNER JOIN system.filesystem_cache AS caches ON data_paths.cache_path = caches.cache_path;
-SELECT count() FROM system.filesystem_cache;
-
-SELECT extract(local_path, '.*/([\w.]+)') as file, extract(cache_path, '.*/([\w.]+)') as cache, size
-FROM
-(
-    SELECT arrayJoin(cache_paths) AS cache_path, local_path, remote_path
-    FROM system.remote_data_paths
-) AS data_paths
-INNER JOIN
-    system.filesystem_cache AS caches
-ON data_paths.cache_path = caches.cache_path
-ORDER BY file, cache, size;
-
-DROP TABLE test;
-DROP TABLE test2;
-DROP TABLE nopers;

From 95349a405b46c00fb6024a2e90defe0ee28b0b89 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Thu, 22 Jun 2023 11:09:26 +0200
Subject: [PATCH 667/722] release buffers with exception context

---
 src/Daemon/BaseDaemon.cpp                      |  4 ++++
 .../Transforms/ExceptionKeepingTransform.cpp   | 10 +++++-----
 .../Transforms/ExceptionKeepingTransform.h     |  2 +-
 src/Storages/HDFS/StorageHDFS.cpp              |  2 +-
 src/Storages/MessageQueueSink.h                |  2 +-
 src/Storages/PartitionedSink.cpp               |  4 ++--
 src/Storages/PartitionedSink.h                 |  2 +-
 src/Storages/StorageAzureBlob.cpp              |  2 +-
 src/Storages/StorageFile.cpp                   |  2 +-
 src/Storages/StorageS3.cpp                     | 18 +++++++++++-------
 src/Storages/StorageURL.cpp                    |  2 +-
 src/Storages/StorageURL.h                      |  2 +-
 12 files changed, 30 insertions(+), 22 deletions(-)

diff --git a/src/Daemon/BaseDaemon.cpp b/src/Daemon/BaseDaemon.cpp
index bfd5568b71d..732d5b1d2f4 100644
--- a/src/Daemon/BaseDaemon.cpp
+++ b/src/Daemon/BaseDaemon.cpp
@@ -417,6 +417,8 @@ private:
         {
             SentryWriter::onFault(sig, error_message, stack_trace);
 
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wunreachable-code"
             /// Advice the user to send it manually.
             if constexpr (std::string_view(VERSION_OFFICIAL).contains("official build"))
             {
@@ -436,6 +438,8 @@ private:
             {
                 LOG_FATAL(log, "This ClickHouse version is not official and should be upgraded to the official build.");
             }
+#pragma clang diagnostic pop
+
         }
 
         /// ClickHouse Keeper does not link to some part of Settings.
diff --git a/src/Processors/Transforms/ExceptionKeepingTransform.cpp b/src/Processors/Transforms/ExceptionKeepingTransform.cpp
index 266407f21a5..3c40c078225 100644
--- a/src/Processors/Transforms/ExceptionKeepingTransform.cpp
+++ b/src/Processors/Transforms/ExceptionKeepingTransform.cpp
@@ -76,7 +76,7 @@ IProcessor::Status ExceptionKeepingTransform::prepare()
         if (data.exception)
         {
             stage = Stage::Exception;
-            onException();
+            onException(data.exception);
             output.pushData(std::move(data));
             return Status::PortFull;
         }
@@ -139,7 +139,7 @@ void ExceptionKeepingTransform::work()
             stage = Stage::Exception;
             ready_output = true;
             data.exception = exception;
-            onException();
+            onException(data.exception);
         }
     }
     else if (stage == Stage::Consume || stage == Stage::Generate)
@@ -153,7 +153,7 @@ void ExceptionKeepingTransform::work()
                 stage = Stage::Exception;
                 ready_output = true;
                 data.exception = exception;
-                onException();
+                onException(data.exception);
             }
             else
                 stage = Stage::Generate;
@@ -167,7 +167,7 @@ void ExceptionKeepingTransform::work()
                 stage = Stage::Exception;
                 ready_output = true;
                 data.exception = exception;
-                onException();
+                onException(data.exception);
             }
             else
             {
@@ -189,7 +189,7 @@ void ExceptionKeepingTransform::work()
             stage = Stage::Exception;
             ready_output = true;
             data.exception = exception;
-            onException();
+            onException(data.exception);
         }
     }
 }
diff --git a/src/Processors/Transforms/ExceptionKeepingTransform.h b/src/Processors/Transforms/ExceptionKeepingTransform.h
index e2bc161971e..cec0e0eea31 100644
--- a/src/Processors/Transforms/ExceptionKeepingTransform.h
+++ b/src/Processors/Transforms/ExceptionKeepingTransform.h
@@ -52,7 +52,7 @@ protected:
     virtual void onConsume(Chunk chunk) = 0;
     virtual GenerateResult onGenerate() = 0;
     virtual void onFinish() {}
-    virtual void onException() {}
+    virtual void onException(std::exception_ptr /* exception */) {}
 
 public:
     ExceptionKeepingTransform(const Block & in_header, const Block & out_header, bool ignore_on_start_and_finish_ = true);
diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 827d89e26a4..7a9d996e3c2 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -512,7 +512,7 @@ public:
         cancelled = true;
     }
 
-    void onException() override
+    void onException(std::exception_ptr /* exception */) override
     {
         std::lock_guard lock(cancel_mutex);
         finalize();
diff --git a/src/Storages/MessageQueueSink.h b/src/Storages/MessageQueueSink.h
index 590bee7ee4f..b3c1e61734f 100644
--- a/src/Storages/MessageQueueSink.h
+++ b/src/Storages/MessageQueueSink.h
@@ -40,7 +40,7 @@ public:
     void onStart() override;
     void onFinish() override;
     void onCancel() override { onFinish(); }
-    void onException() override { onFinish(); }
+    void onException(std::exception_ptr /* exception */) override { onFinish(); }
 
 protected:
     /// Do some specific initialization before consuming data.
diff --git a/src/Storages/PartitionedSink.cpp b/src/Storages/PartitionedSink.cpp
index 363b4557290..18442a8691f 100644
--- a/src/Storages/PartitionedSink.cpp
+++ b/src/Storages/PartitionedSink.cpp
@@ -111,11 +111,11 @@ void PartitionedSink::consume(Chunk chunk)
     }
 }
 
-void PartitionedSink::onException()
+void PartitionedSink::onException(std::exception_ptr exception)
 {
     for (auto & [_, sink] : partition_id_to_sink)
     {
-        sink->onException();
+        sink->onException(exception);
     }
 }
 
diff --git a/src/Storages/PartitionedSink.h b/src/Storages/PartitionedSink.h
index c4bf9c0622c..68edeb6fd73 100644
--- a/src/Storages/PartitionedSink.h
+++ b/src/Storages/PartitionedSink.h
@@ -22,7 +22,7 @@ public:
 
     void consume(Chunk chunk) override;
 
-    void onException() override;
+    void onException(std::exception_ptr exception) override;
 
     void onFinish() override;
 
diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 336c4eaed9b..65af2ed6d6e 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -489,7 +489,7 @@ public:
         cancelled = true;
     }
 
-    void onException() override
+    void onException(std::exception_ptr /* exception */) override
     {
         std::lock_guard lock(cancel_mutex);
         finalize();
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 7c04de1a28a..50aa47ffca9 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -1031,7 +1031,7 @@ public:
         cancelled = true;
     }
 
-    void onException() override
+    void onException(std::exception_ptr /* exception */) override
     {
         std::lock_guard cancel_lock(cancel_mutex);
         finalize();
diff --git a/src/Storages/StorageS3.cpp b/src/Storages/StorageS3.cpp
index 3c0dbdcd766..292ae4813dd 100644
--- a/src/Storages/StorageS3.cpp
+++ b/src/Storages/StorageS3.cpp
@@ -813,10 +813,18 @@ public:
         cancelled = true;
     }
 
-    void onException() override
+    void onException(std::exception_ptr exception) override
     {
         std::lock_guard lock(cancel_mutex);
-        release();
+        try
+        {
+            std::rethrow_exception(exception);
+        }
+        catch (...)
+        {
+            /// An exception context is needed to proper delete write buffers without finalization
+            release();
+        }
     }
 
     void onFinish() override
@@ -840,17 +848,13 @@ private:
         catch (...)
         {
             /// Stop ParallelFormattingOutputFormat correctly.
-            writer.reset();
-            write_buf->finalize();
+            release();
             throw;
         }
     }
 
     void release()
     {
-        if (!writer)
-            return;
-
         writer.reset();
         write_buf.reset();
     }
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index 1d6aed204cb..651b50518d2 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -480,7 +480,7 @@ void StorageURLSink::onCancel()
     cancelled = true;
 }
 
-void StorageURLSink::onException()
+void StorageURLSink::onException(std::exception_ptr /* exception */)
 {
     std::lock_guard lock(cancel_mutex);
     finalize();
diff --git a/src/Storages/StorageURL.h b/src/Storages/StorageURL.h
index e3305cda89e..c4a5ce1aa7b 100644
--- a/src/Storages/StorageURL.h
+++ b/src/Storages/StorageURL.h
@@ -236,7 +236,7 @@ public:
     std::string getName() const override { return "StorageURLSink"; }
     void consume(Chunk chunk) override;
     void onCancel() override;
-    void onException() override;
+    void onException(std::exception_ptr exception) override;
     void onFinish() override;
 
 private:

From 6929a9b852a6dc25e4bbcb85ba384f416c90c89e Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 22 Jun 2023 14:01:28 +0300
Subject: [PATCH 668/722] Update WriteBufferFromOStream.cpp

---
 src/IO/WriteBufferFromOStream.cpp | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/IO/WriteBufferFromOStream.cpp b/src/IO/WriteBufferFromOStream.cpp
index 2d0d5976f85..5074c226dd3 100644
--- a/src/IO/WriteBufferFromOStream.cpp
+++ b/src/IO/WriteBufferFromOStream.cpp
@@ -18,7 +18,14 @@ void WriteBufferFromOStream::nextImpl()
     ostr->flush();
 
     if (!ostr->good())
-        throw Exception(ErrorCodes::CANNOT_WRITE_TO_OSTREAM, "Cannot write to ostream at offset {}", count());
+    {
+        /// FIXME do not call finalize in dtors (and remove iostreams)
+        bool avoid_throwing_exceptions = std::uncaught_exceptions();
+        if (avoid_throwing_exceptions)
+            LOG_ERROR(&Poco::Logger::get("WriteBufferFromOStream"), "Cannot write to ostream at offset {}. Stack trace: {}", count(), StackTrace().toString());
+        else
+            throw Exception(ErrorCodes::CANNOT_WRITE_TO_OSTREAM, "Cannot write to ostream at offset {}", count());
+    }
 }
 
 WriteBufferFromOStream::WriteBufferFromOStream(

From 4fbf52f2de95983b40921d65c68df6a59d6cd570 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 22 Jun 2023 13:08:38 +0200
Subject: [PATCH 669/722] Less loggers

---
 src/Interpreters/Cache/Metadata.cpp | 16 ++++++++--------
 src/Interpreters/Cache/Metadata.h   |  2 +-
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index 20af931bbc2..af8520fab8a 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -58,6 +58,11 @@ KeyMetadata::KeyMetadata(
     , key_path(key_path_)
     , cleanup_queue(cleanup_queue_)
     , created_base_directory(created_base_directory_)
+#ifdef ABORT_ON_LOGICAL_ERROR
+    , log(&Poco::Logger::get("LockedKey(" + key.toString() + ")"))
+#else
+    , log(&Poco::Logger::get("LockedKey"))
+#endif
 {
     if (created_base_directory)
         chassert(fs::exists(key_path));
@@ -324,11 +329,6 @@ void CacheMetadata::doCleanup()
 LockedKey::LockedKey(std::shared_ptr<KeyMetadata> key_metadata_)
     : key_metadata(key_metadata_)
     , lock(key_metadata->guard.lock())
-#ifdef ABORT_ON_LOGICAL_ERROR
-    , log(&Poco::Logger::get("LockedKey(" + key_metadata_->key.toString() + ")"))
-#else
-    , log(&Poco::Logger::get("LockedKey"))
-#endif
 {
 }
 
@@ -338,7 +338,7 @@ LockedKey::~LockedKey()
         return;
 
     key_metadata->key_state = KeyMetadata::KeyState::REMOVING;
-    LOG_DEBUG(log, "Submitting key {} for removal", getKey());
+    LOG_DEBUG(key_metadata->log, "Submitting key {} for removal", getKey());
     key_metadata->cleanup_queue.add(getKey());
 }
 
@@ -396,7 +396,7 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     auto file_segment = it->second->file_segment;
 
     LOG_DEBUG(
-        log, "Remove from cache. Key: {}, offset: {}, size: {}",
+        key_metadata->log, "Remove from cache. Key: {}, offset: {}, size: {}",
         getKey(), offset, file_segment->reserved_size);
 
     chassert(file_segment->assertCorrectnessUnlocked(segment_lock));
@@ -409,7 +409,7 @@ KeyMetadata::iterator LockedKey::removeFileSegment(size_t offset, const FileSegm
     if (exists)
     {
         fs::remove(path);
-        LOG_TEST(log, "Removed file segment at path: {}", path);
+        LOG_TEST(key_metadata->log, "Removed file segment at path: {}", path);
     }
     else if (file_segment->downloaded_size)
         throw Exception(ErrorCodes::LOGICAL_ERROR, "Expected path {} to exist", path);
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index 6172808bcf5..c9a8e97beee 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -70,6 +70,7 @@ private:
     KeyGuard guard;
     CleanupQueue & cleanup_queue;
     std::atomic<bool> created_base_directory = false;
+    Poco::Logger * log;
 };
 
 using KeyMetadataPtr = std::shared_ptr<KeyMetadata>;
@@ -171,7 +172,6 @@ struct LockedKey : private boost::noncopyable
 private:
     const std::shared_ptr<KeyMetadata> key_metadata;
     KeyGuard::Lock lock; /// `lock` must be destructed before `key_metadata`.
-    Poco::Logger * log;
 };
 
 }

From 8ff8125ebda3352e802ecc46b3f74b79caad6e05 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 22 Jun 2023 13:24:50 +0200
Subject: [PATCH 670/722] Better

---
 src/Interpreters/Cache/Metadata.cpp | 7 ++++---
 src/Interpreters/Cache/Metadata.h   | 1 +
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index af8520fab8a..b19d095692d 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -53,15 +53,16 @@ KeyMetadata::KeyMetadata(
     const Key & key_,
     const std::string & key_path_,
     CleanupQueue & cleanup_queue_,
+    [[maybe_unused]] Poco::Logger * log_,
     bool created_base_directory_)
     : key(key_)
     , key_path(key_path_)
     , cleanup_queue(cleanup_queue_)
     , created_base_directory(created_base_directory_)
 #ifdef ABORT_ON_LOGICAL_ERROR
-    , log(&Poco::Logger::get("LockedKey(" + key.toString() + ")"))
+    , log(&Poco::Logger::get("Key(" + key.toString() + ")"))
 #else
-    , log(&Poco::Logger::get("LockedKey"))
+    , log(log_)
 #endif
 {
     if (created_base_directory)
@@ -195,7 +196,7 @@ LockedKeyPtr CacheMetadata::lockKeyMetadata(
 
             it = emplace(
                 key, std::make_shared<KeyMetadata>(
-                    key, getPathForKey(key), *cleanup_queue, is_initial_load)).first;
+                    key, getPathForKey(key), *cleanup_queue, log, is_initial_load)).first;
         }
 
         key_metadata = it->second;
diff --git a/src/Interpreters/Cache/Metadata.h b/src/Interpreters/Cache/Metadata.h
index c9a8e97beee..635594a289a 100644
--- a/src/Interpreters/Cache/Metadata.h
+++ b/src/Interpreters/Cache/Metadata.h
@@ -44,6 +44,7 @@ struct KeyMetadata : public std::map<size_t, FileSegmentMetadataPtr>,
         const Key & key_,
         const std::string & key_path_,
         CleanupQueue & cleanup_queue_,
+        Poco::Logger * log_,
         bool created_base_directory_ = false);
 
     enum class KeyState

From a1c131c0da77e16b9cf63e8a081ac6e01f08ad7f Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 8 Jun 2023 10:29:51 +0000
Subject: [PATCH 671/722] Query Cache: Try to fix bad cast from ColumnConst to
 ColumnVector<char8_t>

Resolves #49445

The query cache buffers query result chunks and eventually squashes
them before insertion into the cache. Here, squashing failed because not
all chunks were of the same type. Looks like chunks of the same
underlying type (e.g. UInt8) in a query result be of mixed const, sparse
or low-cardinality type. Fix this by always materializing the data
regardless of the compression. Strange thing is that the failing query
in the stress test (*) isn't able to reproduce the bug, and I haven't
managed to trigger the issue otherwise, so no test case is added.

(*) SELECT 1 UNION ALL SELECT 1 INTERSECT SELECT 1
    E.g. here: https://s3.amazonaws.com/clickhouse-test-reports/0/18817517ed6f8849e3d979e10fbb273e0edf0eaa/stress_test__debug_/fatal_messages.txt
---
 src/Interpreters/Cache/QueryCache.cpp | 10 +++++-----
 src/Processors/Chunk.cpp              | 26 ++++++++++++++++++++++++++
 src/Processors/Chunk.h                |  3 +++
 3 files changed, 34 insertions(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/QueryCache.cpp b/src/Interpreters/Cache/QueryCache.cpp
index 3118f386111..364a740abe0 100644
--- a/src/Interpreters/Cache/QueryCache.cpp
+++ b/src/Interpreters/Cache/QueryCache.cpp
@@ -263,23 +263,23 @@ void QueryCache::Writer::finalizeWrite()
 
     if (auto entry = cache.getWithKey(key); entry.has_value() && !IsStale()(entry->key))
     {
-        /// same check as in ctor because a parallel Writer could have inserted the current key in the meantime
+        /// Same check as in ctor because a parallel Writer could have inserted the current key in the meantime
         LOG_TRACE(&Poco::Logger::get("QueryCache"), "Skipped insert (non-stale entry found), query: {}", key.queryStringFromAst());
         return;
     }
 
     if (squash_partial_results)
     {
-        // Squash partial result chunks to chunks of size 'max_block_size' each. This costs some performance but provides a more natural
-        // compression of neither too small nor big blocks. Also, it will look like 'max_block_size' is respected when the query result is
-        // served later on from the query cache.
+        /// Squash partial result chunks to chunks of size 'max_block_size' each. This costs some performance but provides a more natural
+        /// compression of neither too small nor big blocks. Also, it will look like 'max_block_size' is respected when the query result is
+        /// served later on from the query cache.
 
         Chunks squashed_chunks;
         size_t rows_remaining_in_squashed = 0; /// how many further rows can the last squashed chunk consume until it reaches max_block_size
 
         for (auto & chunk : query_result->chunks)
         {
-            convertToFullIfSparse(chunk);
+            convertToFullIfNeeded(chunk);
 
             const size_t rows_chunk = chunk.getNumRows();
             if (rows_chunk == 0)
diff --git a/src/Processors/Chunk.cpp b/src/Processors/Chunk.cpp
index 0a4b2413e4c..24181866087 100644
--- a/src/Processors/Chunk.cpp
+++ b/src/Processors/Chunk.cpp
@@ -2,6 +2,7 @@
 #include <IO/WriteHelpers.h>
 #include <IO/Operators.h>
 #include <Columns/ColumnSparse.h>
+#include <DataTypes/DataTypeLowCardinality.h>
 
 namespace DB
 {
@@ -202,6 +203,24 @@ const ChunkMissingValues::RowsBitMask & ChunkMissingValues::getDefaultsBitmask(s
     return none;
 }
 
+void convertToFullIfConst(Chunk & chunk)
+{
+    size_t num_rows = chunk.getNumRows();
+    auto columns = chunk.detachColumns();
+    for (auto & column : columns)
+        column = column->convertToFullColumnIfConst();
+    chunk.setColumns(std::move(columns), num_rows);
+}
+
+void convertToFullIfLowCardinality(Chunk & chunk)
+{
+    size_t num_rows = chunk.getNumRows();
+    auto columns = chunk.detachColumns();
+    for (auto & column : columns)
+        column = recursiveRemoveLowCardinality(column);
+    chunk.setColumns(std::move(columns), num_rows);
+}
+
 void convertToFullIfSparse(Chunk & chunk)
 {
     size_t num_rows = chunk.getNumRows();
@@ -212,4 +231,11 @@ void convertToFullIfSparse(Chunk & chunk)
     chunk.setColumns(std::move(columns), num_rows);
 }
 
+void convertToFullIfNeeded(Chunk & chunk)
+{
+    convertToFullIfSparse(chunk);
+    convertToFullIfConst(chunk);
+    convertToFullIfLowCardinality(chunk);
+}
+
 }
diff --git a/src/Processors/Chunk.h b/src/Processors/Chunk.h
index 6f2097b71f1..45610ae3276 100644
--- a/src/Processors/Chunk.h
+++ b/src/Processors/Chunk.h
@@ -149,6 +149,9 @@ private:
 /// It's needed, when you have to access to the internals of the column,
 /// or when you need to perform operation with two columns
 /// and their structure must be equal (e.g. compareAt).
+void convertToFullIfConst(Chunk & chunk);
+void convertToFullIfLowCardinality(Chunk & chunk);
 void convertToFullIfSparse(Chunk & chunk);
+void convertToFullIfNeeded(Chunk & chunk);
 
 }

From a9f1393862c628f0cd46bdf7ef3e963b3f516846 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 22 Jun 2023 11:43:11 +0000
Subject: [PATCH 672/722] Make the fix more minimal

---
 src/Interpreters/Cache/QueryCache.cpp |  4 +++-
 src/Processors/Chunk.cpp              | 17 -----------------
 src/Processors/Chunk.h                |  2 --
 3 files changed, 3 insertions(+), 20 deletions(-)

diff --git a/src/Interpreters/Cache/QueryCache.cpp b/src/Interpreters/Cache/QueryCache.cpp
index 364a740abe0..74a1c3c9b18 100644
--- a/src/Interpreters/Cache/QueryCache.cpp
+++ b/src/Interpreters/Cache/QueryCache.cpp
@@ -233,6 +233,7 @@ void QueryCache::Writer::buffer(Chunk && chunk, ChunkType chunk_type)
             auto & buffered_chunk = (chunk_type == ChunkType::Totals) ? query_result->totals : query_result->extremes;
 
             convertToFullIfSparse(chunk);
+            convertToFullIfConst(chunk);
 
             if (!buffered_chunk.has_value())
                 buffered_chunk = std::move(chunk);
@@ -279,7 +280,8 @@ void QueryCache::Writer::finalizeWrite()
 
         for (auto & chunk : query_result->chunks)
         {
-            convertToFullIfNeeded(chunk);
+            convertToFullIfSparse(chunk);
+            convertToFullIfConst(chunk);
 
             const size_t rows_chunk = chunk.getNumRows();
             if (rows_chunk == 0)
diff --git a/src/Processors/Chunk.cpp b/src/Processors/Chunk.cpp
index 24181866087..9ec5bb7adde 100644
--- a/src/Processors/Chunk.cpp
+++ b/src/Processors/Chunk.cpp
@@ -212,30 +212,13 @@ void convertToFullIfConst(Chunk & chunk)
     chunk.setColumns(std::move(columns), num_rows);
 }
 
-void convertToFullIfLowCardinality(Chunk & chunk)
-{
-    size_t num_rows = chunk.getNumRows();
-    auto columns = chunk.detachColumns();
-    for (auto & column : columns)
-        column = recursiveRemoveLowCardinality(column);
-    chunk.setColumns(std::move(columns), num_rows);
-}
-
 void convertToFullIfSparse(Chunk & chunk)
 {
     size_t num_rows = chunk.getNumRows();
     auto columns = chunk.detachColumns();
     for (auto & column : columns)
         column = recursiveRemoveSparse(column);
-
     chunk.setColumns(std::move(columns), num_rows);
 }
 
-void convertToFullIfNeeded(Chunk & chunk)
-{
-    convertToFullIfSparse(chunk);
-    convertToFullIfConst(chunk);
-    convertToFullIfLowCardinality(chunk);
-}
-
 }
diff --git a/src/Processors/Chunk.h b/src/Processors/Chunk.h
index 45610ae3276..413872d512d 100644
--- a/src/Processors/Chunk.h
+++ b/src/Processors/Chunk.h
@@ -150,8 +150,6 @@ private:
 /// or when you need to perform operation with two columns
 /// and their structure must be equal (e.g. compareAt).
 void convertToFullIfConst(Chunk & chunk);
-void convertToFullIfLowCardinality(Chunk & chunk);
 void convertToFullIfSparse(Chunk & chunk);
-void convertToFullIfNeeded(Chunk & chunk);
 
 }

From df2284b8079dc047b621693696d5f32324b40b82 Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 22 Jun 2023 11:56:00 +0000
Subject: [PATCH 673/722] Update version_date.tsv and changelogs after
 v23.3.5.9-lts

---
 docs/changelogs/v23.3.5.9-lts.md     | 19 +++++++++++++++++++
 utils/list-versions/version_date.tsv |  1 +
 2 files changed, 20 insertions(+)
 create mode 100644 docs/changelogs/v23.3.5.9-lts.md

diff --git a/docs/changelogs/v23.3.5.9-lts.md b/docs/changelogs/v23.3.5.9-lts.md
new file mode 100644
index 00000000000..df1aab541ec
--- /dev/null
+++ b/docs/changelogs/v23.3.5.9-lts.md
@@ -0,0 +1,19 @@
+---
+sidebar_position: 1
+sidebar_label: 2023
+---
+
+# 2023 Changelog
+
+### ClickHouse release v23.3.5.9-lts (f5fbc2fd2b3) FIXME as compared to v23.3.4.17-lts (2c99b73ff40)
+
+#### Bug Fix (user-visible misbehavior in an official stable release)
+
+* Fix broken index analysis when binary operator contains a null constant argument [#50177](https://github.com/ClickHouse/ClickHouse/pull/50177) ([Amos Bird](https://github.com/amosbird)).
+* Cleanup moving parts [#50489](https://github.com/ClickHouse/ClickHouse/pull/50489) ([vdimir](https://github.com/vdimir)).
+* Do not apply projection if read-in-order was enabled. [#50923](https://github.com/ClickHouse/ClickHouse/pull/50923) ([Nikolai Kochetov](https://github.com/KochetovNicolai)).
+
+#### NOT FOR CHANGELOG / INSIGNIFICANT
+
+* Increase max array size in group bitmap [#50620](https://github.com/ClickHouse/ClickHouse/pull/50620) ([Kruglov Pavel](https://github.com/Avogar)).
+
diff --git a/utils/list-versions/version_date.tsv b/utils/list-versions/version_date.tsv
index 5c32ebb2683..dd21cc7e953 100644
--- a/utils/list-versions/version_date.tsv
+++ b/utils/list-versions/version_date.tsv
@@ -5,6 +5,7 @@ v23.4.4.16-stable	2023-06-17
 v23.4.3.48-stable	2023-06-12
 v23.4.2.11-stable	2023-05-02
 v23.4.1.1943-stable	2023-04-27
+v23.3.5.9-lts	2023-06-22
 v23.3.4.17-lts	2023-06-17
 v23.3.3.52-lts	2023-06-12
 v23.3.2.37-lts	2023-04-22

From 35c5483ad25d7c34adb45adcff8c16cd73a7ad09 Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 22 Jun 2023 14:56:20 +0300
Subject: [PATCH 674/722] Update WriteBufferFromOStream.cpp

---
 src/IO/WriteBufferFromOStream.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/IO/WriteBufferFromOStream.cpp b/src/IO/WriteBufferFromOStream.cpp
index 5074c226dd3..e0ec0b770e2 100644
--- a/src/IO/WriteBufferFromOStream.cpp
+++ b/src/IO/WriteBufferFromOStream.cpp
@@ -1,4 +1,5 @@
 #include <IO/WriteBufferFromOStream.h>
+#include <Common/logger_useful.h>
 
 
 namespace DB

From ee68e85d310a6843ed833fe9c985a540620f9940 Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Thu, 22 Jun 2023 12:23:51 +0000
Subject: [PATCH 675/722] better reporting of broken parts

---
 .../IMergeTreeDataPartInfoForReader.h         |  2 ++
 src/Storages/MergeTree/IMergeTreeReader.cpp   |  9 +++++++
 src/Storages/MergeTree/IMergeTreeReader.h     |  2 ++
 .../LoadedMergeTreeDataPartInfoForReader.h    |  2 ++
 src/Storages/MergeTree/MergeTreeData.cpp      | 21 ---------------
 .../MergeTree/MergeTreeReaderCompact.cpp      | 24 ++++++++++++++---
 .../MergeTree/MergeTreeReaderWide.cpp         | 26 ++++++++-----------
 .../ReplicatedMergeTreePartCheckThread.cpp    |  2 +-
 src/Storages/MergeTree/checkDataPart.cpp      | 24 ++++++++++++++++-
 src/Storages/MergeTree/checkDataPart.h        |  1 +
 10 files changed, 72 insertions(+), 41 deletions(-)

diff --git a/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h b/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h
index dbed58ba91c..2cc73556f04 100644
--- a/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h
+++ b/src/Storages/MergeTree/IMergeTreeDataPartInfoForReader.h
@@ -66,6 +66,8 @@ public:
 
     virtual const SerializationInfoByName & getSerializationInfos() const = 0;
 
+    virtual String getTableName() const = 0;
+
     virtual void reportBroken() = 0;
 };
 
diff --git a/src/Storages/MergeTree/IMergeTreeReader.cpp b/src/Storages/MergeTree/IMergeTreeReader.cpp
index be9aedaf4d5..d93e88fdeb2 100644
--- a/src/Storages/MergeTree/IMergeTreeReader.cpp
+++ b/src/Storages/MergeTree/IMergeTreeReader.cpp
@@ -278,4 +278,13 @@ void IMergeTreeReader::checkNumberOfColumns(size_t num_columns_to_read) const
                         "Expected {}, got {}", requested_columns.size(), num_columns_to_read);
 }
 
+String IMergeTreeReader::getMessageForDiagnosticOfBrokenPart(size_t from_mark, size_t max_rows_to_read) const
+{
+    return fmt::format(
+        "(while reading from part {} in table {} from mark {} with max_rows_to_read = {})",
+        data_part_info_for_read->getDataPartStorage()->getFullPath(),
+        data_part_info_for_read->getTableName(),
+        from_mark, max_rows_to_read);
+}
+
 }
diff --git a/src/Storages/MergeTree/IMergeTreeReader.h b/src/Storages/MergeTree/IMergeTreeReader.h
index a72d83a55e4..fcab35fb4c2 100644
--- a/src/Storages/MergeTree/IMergeTreeReader.h
+++ b/src/Storages/MergeTree/IMergeTreeReader.h
@@ -74,6 +74,8 @@ protected:
 
     void checkNumberOfColumns(size_t num_columns_to_read) const;
 
+    String getMessageForDiagnosticOfBrokenPart(size_t from_mark, size_t max_rows_to_read) const;
+
     /// avg_value_size_hints are used to reduce the number of reallocations when creating columns of variable size.
     ValueSizeMap avg_value_size_hints;
     /// Stores states for IDataType::deserializeBinaryBulk
diff --git a/src/Storages/MergeTree/LoadedMergeTreeDataPartInfoForReader.h b/src/Storages/MergeTree/LoadedMergeTreeDataPartInfoForReader.h
index aec102f3f7d..f1cb8b34ecf 100644
--- a/src/Storages/MergeTree/LoadedMergeTreeDataPartInfoForReader.h
+++ b/src/Storages/MergeTree/LoadedMergeTreeDataPartInfoForReader.h
@@ -56,6 +56,8 @@ public:
 
     SerializationPtr getSerialization(const NameAndTypePair & column) const override { return data_part->getSerialization(column.name); }
 
+    String getTableName() const override { return data_part->storage.getStorageID().getNameForLogs(); }
+
     MergeTreeData::DataPartPtr getDataPart() const { return data_part; }
 
 private:
diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index c3ffb892871..33d65ceb5da 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -179,8 +179,6 @@ namespace ErrorCodes
     extern const int ZERO_COPY_REPLICATION_ERROR;
     extern const int NOT_INITIALIZED;
     extern const int SERIALIZATION_ERROR;
-    extern const int NETWORK_ERROR;
-    extern const int SOCKET_TIMEOUT;
     extern const int TOO_MANY_MUTATIONS;
 }
 
@@ -1174,25 +1172,6 @@ static void preparePartForRemoval(const MergeTreeMutableDataPartPtr & part)
     }
 }
 
-static bool isRetryableException(const Exception & e)
-{
-    if (isNotEnoughMemoryErrorCode(e.code()))
-        return true;
-
-    if (e.code() == ErrorCodes::NETWORK_ERROR || e.code() == ErrorCodes::SOCKET_TIMEOUT)
-        return true;
-
-#if USE_AWS_S3
-    const auto * s3_exception = dynamic_cast<const S3Exception *>(&e);
-    if (s3_exception && s3_exception->isRetryableError())
-        return true;
-#endif
-
-    /// In fact, there can be other similar situations.
-    /// But it is OK, because there is a safety guard against deleting too many parts.
-    return false;
-}
-
 static constexpr size_t loading_parts_initial_backoff_ms = 100;
 static constexpr size_t loading_parts_max_backoff_ms = 5000;
 static constexpr size_t loading_parts_max_tries = 3;
diff --git a/src/Storages/MergeTree/MergeTreeReaderCompact.cpp b/src/Storages/MergeTree/MergeTreeReaderCompact.cpp
index d22684eaa9d..f65e66ff52d 100644
--- a/src/Storages/MergeTree/MergeTreeReaderCompact.cpp
+++ b/src/Storages/MergeTree/MergeTreeReaderCompact.cpp
@@ -1,5 +1,6 @@
 #include <Storages/MergeTree/MergeTreeReaderCompact.h>
 #include <Storages/MergeTree/MergeTreeDataPartCompact.h>
+#include <Storages/MergeTree/checkDataPart.h>
 #include <DataTypes/DataTypeArray.h>
 #include <DataTypes/NestedUtils.h>
 
@@ -10,7 +11,6 @@ namespace ErrorCodes
 {
     extern const int CANNOT_READ_ALL_DATA;
     extern const int ARGUMENT_OUT_OF_BOUND;
-    extern const int MEMORY_LIMIT_EXCEEDED;
 }
 
 
@@ -112,6 +112,12 @@ void MergeTreeReaderCompact::initialize()
             compressed_data_buffer = non_cached_buffer.get();
         }
     }
+    catch (const Exception & e)
+    {
+        if (!isRetryableException(e))
+            data_part_info_for_read->reportBroken();
+        throw;
+    }
     catch (...)
     {
         data_part_info_for_read->reportBroken();
@@ -207,11 +213,11 @@ size_t MergeTreeReaderCompact::readRows(
             }
             catch (Exception & e)
             {
-                if (e.code() != ErrorCodes::MEMORY_LIMIT_EXCEEDED)
+                if (!isRetryableException(e))
                     data_part_info_for_read->reportBroken();
 
                 /// Better diagnostics.
-                e.addMessage("(while reading column " + columns_to_read[pos].name + ")");
+                e.addMessage(getMessageForDiagnosticOfBrokenPart(from_mark, max_rows_to_read));
                 throw;
             }
             catch (...)
@@ -315,6 +321,7 @@ void MergeTreeReaderCompact::readData(
 }
 
 void MergeTreeReaderCompact::prefetchBeginOfRange(Priority priority)
+try
 {
     if (!initialized)
     {
@@ -326,6 +333,17 @@ void MergeTreeReaderCompact::prefetchBeginOfRange(Priority priority)
     seekToMark(all_mark_ranges.front().begin, 0);
     data_buffer->prefetch(priority);
 }
+catch (const Exception & e)
+{
+    if (!isRetryableException(e))
+        data_part_info_for_read->reportBroken();
+    throw;
+}
+catch (...)
+{
+    data_part_info_for_read->reportBroken();
+    throw;
+}
 
 void MergeTreeReaderCompact::seekToMark(size_t row_index, size_t column_index)
 {
diff --git a/src/Storages/MergeTree/MergeTreeReaderWide.cpp b/src/Storages/MergeTree/MergeTreeReaderWide.cpp
index 38032fae826..140fb6da5df 100644
--- a/src/Storages/MergeTree/MergeTreeReaderWide.cpp
+++ b/src/Storages/MergeTree/MergeTreeReaderWide.cpp
@@ -9,6 +9,7 @@
 #include <Interpreters/Context.h>
 #include <Storages/MergeTree/IMergeTreeReader.h>
 #include <Storages/MergeTree/MergeTreeDataPartWide.h>
+#include <Storages/MergeTree/checkDataPart.h>
 #include <Common/escapeForFileName.h>
 #include <Common/typeid_cast.h>
 
@@ -20,11 +21,6 @@ namespace
     constexpr auto DATA_FILE_EXTENSION = ".bin";
 }
 
-namespace ErrorCodes
-{
-    extern const int MEMORY_LIMIT_EXCEEDED;
-}
-
 MergeTreeReaderWide::MergeTreeReaderWide(
     MergeTreeDataPartInfoForReaderPtr data_part_info_,
     NamesAndTypesList columns_,
@@ -51,6 +47,12 @@ MergeTreeReaderWide::MergeTreeReaderWide(
         for (size_t i = 0; i < columns_to_read.size(); ++i)
             addStreams(columns_to_read[i], serializations[i], profile_callback_, clock_type_);
     }
+    catch (const Exception & e)
+    {
+        if (!isRetryableException(e))
+            data_part_info_for_read->reportBroken();
+        throw;
+    }
     catch (...)
     {
         data_part_info_for_read->reportBroken();
@@ -76,9 +78,9 @@ void MergeTreeReaderWide::prefetchBeginOfRange(Priority priority)
         /// of range only once so there is no such problem.
         /// 4. continue_reading == false, as we haven't read anything yet.
     }
-    catch (Exception & e)
+    catch (const Exception & e)
     {
-        if (e.code() != ErrorCodes::MEMORY_LIMIT_EXCEEDED)
+        if (!isRetryableException(e))
             data_part_info_for_read->reportBroken();
         throw;
     }
@@ -184,22 +186,16 @@ size_t MergeTreeReaderWide::readRows(
     }
     catch (Exception & e)
     {
-        if (e.code() != ErrorCodes::MEMORY_LIMIT_EXCEEDED)
+        if (!isRetryableException(e))
             data_part_info_for_read->reportBroken();
 
         /// Better diagnostics.
-        const auto & part_storage = data_part_info_for_read->getDataPartStorage();
-        e.addMessage(
-            fmt::format(
-                "(while reading from part {} located on disk {} of type {}, from mark {} with max_rows_to_read = {})",
-                part_storage->getFullPath(), part_storage->getDiskName(), part_storage->getDiskType(),
-                toString(from_mark), toString(max_rows_to_read)));
+        e.addMessage(getMessageForDiagnosticOfBrokenPart(from_mark, max_rows_to_read));
         throw;
     }
     catch (...)
     {
         data_part_info_for_read->reportBroken();
-
         throw;
     }
 
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp b/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
index 7bb8d9d758e..43256505135 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
@@ -422,7 +422,7 @@ CheckResult ReplicatedMergeTreePartCheckThread::checkPart(const String & part_na
                 /// Don't count the part as broken if there is not enough memory to load it.
                 /// In fact, there can be many similar situations.
                 /// But it is OK, because there is a safety guard against deleting too many parts.
-                if (isNotEnoughMemoryErrorCode(e.code()))
+                if (isRetryableException(e))
                     throw;
 
                 tryLogCurrentException(log, __PRETTY_FUNCTION__);
diff --git a/src/Storages/MergeTree/checkDataPart.cpp b/src/Storages/MergeTree/checkDataPart.cpp
index 5c090cdd739..1967357a840 100644
--- a/src/Storages/MergeTree/checkDataPart.cpp
+++ b/src/Storages/MergeTree/checkDataPart.cpp
@@ -13,6 +13,7 @@
 #include <Interpreters/Cache/FileCacheFactory.h>
 #include <Compression/CompressedReadBuffer.h>
 #include <IO/HashingReadBuffer.h>
+#include <IO/S3Common.h>
 #include <Common/CurrentMetrics.h>
 
 
@@ -33,6 +34,8 @@ namespace ErrorCodes
     extern const int CANNOT_MUNMAP;
     extern const int CANNOT_MREMAP;
     extern const int UNEXPECTED_FILE_IN_DATA_PART;
+    extern const int NETWORK_ERROR;
+    extern const int SOCKET_TIMEOUT;
 }
 
 
@@ -47,6 +50,25 @@ bool isNotEnoughMemoryErrorCode(int code)
         || code == ErrorCodes::CANNOT_MREMAP;
 }
 
+bool isRetryableException(const Exception & e)
+{
+    if (isNotEnoughMemoryErrorCode(e.code()))
+        return true;
+
+    if (e.code() == ErrorCodes::NETWORK_ERROR || e.code() == ErrorCodes::SOCKET_TIMEOUT)
+        return true;
+
+#if USE_AWS_S3
+    const auto * s3_exception = dynamic_cast<const S3Exception *>(&e);
+    if (s3_exception && s3_exception->isRetryableError())
+        return true;
+#endif
+
+    /// In fact, there can be other similar situations.
+    /// But it is OK, because there is a safety guard against deleting too many parts.
+    return false;
+}
+
 
 static IMergeTreeDataPart::Checksums checkDataPart(
     MergeTreeData::DataPartPtr data_part,
@@ -302,7 +324,7 @@ IMergeTreeDataPart::Checksums checkDataPart(
     }
     catch (const Exception & e)
     {
-        if (isNotEnoughMemoryErrorCode(e.code()))
+        if (isRetryableException(e))
             throw;
 
         return drop_cache_and_check();
diff --git a/src/Storages/MergeTree/checkDataPart.h b/src/Storages/MergeTree/checkDataPart.h
index d0cf25b87be..20ddecad3ed 100644
--- a/src/Storages/MergeTree/checkDataPart.h
+++ b/src/Storages/MergeTree/checkDataPart.h
@@ -13,5 +13,6 @@ IMergeTreeDataPart::Checksums checkDataPart(
     std::function<bool()> is_cancelled = []{ return false; });
 
 bool isNotEnoughMemoryErrorCode(int code);
+bool isRetryableException(const Exception & e);
 
 }

From 94a194d153488c7d1afac6aa212e9f3fea706f7f Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Thu, 22 Jun 2023 08:29:32 -0400
Subject: [PATCH 676/722] move redirects to docusaurus config

---
 docs/redirects.txt | 459 +--------------------------------------------
 1 file changed, 6 insertions(+), 453 deletions(-)

diff --git a/docs/redirects.txt b/docs/redirects.txt
index cea138f7237..ebeda125e01 100644
--- a/docs/redirects.txt
+++ b/docs/redirects.txt
@@ -1,453 +1,6 @@
-agg_functions/combinators.md query-language/agg-functions/combinators.md
-agg_functions/index.md query-language/agg-functions/index.md
-agg_functions/parametric_functions.md query-language/agg-functions/parametric-functions.md
-agg_functions/reference.md query-language/agg-functions/reference.md
-changelog/2017.md whats-new/changelog/2017.md
-changelog/2018.md whats-new/changelog/2018.md
-changelog/2019.md whats-new/changelog/2019.md
-changelog/index.md whats-new/changelog/index.md
-commercial/cloud.md https://clickhouse.com/cloud/
-data_types/array.md sql-reference/data-types/array.md
-data_types/boolean.md sql-reference/data-types/boolean.md
-data_types/date.md sql-reference/data-types/date.md
-data_types/datetime.md sql-reference/data-types/datetime.md
-data_types/datetime64.md sql-reference/data-types/datetime64.md
-data_types/decimal.md sql-reference/data-types/decimal.md
-data_types/domains/ipv4.md sql-reference/data-types/domains/ipv4.md
-data_types/domains/ipv6.md sql-reference/data-types/domains/ipv6.md
-data_types/domains/overview.md sql-reference/data-types/domains/overview.md
-data_types/enum.md sql-reference/data-types/enum.md
-data_types/fixedstring.md sql-reference/data-types/fixedstring.md
-data_types/float.md sql-reference/data-types/float.md
-data_types/index.md sql-reference/data-types/index.md
-data_types/int_uint.md sql-reference/data-types/int-uint.md
-data_types/nested_data_structures/aggregatefunction.md sql-reference/data-types/aggregatefunction.md
-data_types/nested_data_structures/index.md sql-reference/data-types/nested-data-structures/index.md
-data_types/nested_data_structures/nested.md sql-reference/data-types/nested-data-structures/nested.md
-data_types/nullable.md sql-reference/data-types/nullable.md
-data_types/special_data_types/expression.md sql-reference/data-types/special-data-types/expression.md
-data_types/special_data_types/index.md sql-reference/data-types/special-data-types/index.md
-data_types/special_data_types/interval.md sql-reference/data-types/special-data-types/interval.md
-data_types/special_data_types/nothing.md sql-reference/data-types/special-data-types/nothing.md
-data_types/special_data_types/set.md sql-reference/data-types/special-data-types/set.md
-data_types/string.md sql-reference/data-types/string.md
-data_types/tuple.md sql-reference/data-types/tuple.md
-data_types/uuid.md sql-reference/data-types/uuid.md
-database_engines/index.md engines/database-engines/index.md
-database_engines/lazy.md engines/database-engines/lazy.md
-database_engines/mysql.md engines/database-engines/mysql.md
-development/browse_code.md development/browse-code.md
-development/build_cross_arm.md development/build-cross-arm.md
-development/build_cross_osx.md development/build-cross-osx.md
-development/build_osx.md development/build-osx.md
-development/developer_instruction.md development/developer-instruction.md
-dicts/external_dicts.md query-language/dicts/external-dicts.md
-dicts/external_dicts_dict.md query-language/dicts/external-dicts-dict.md
-dicts/external_dicts_dict_layout.md query-language/dicts/external-dicts-dict-layout.md
-dicts/external_dicts_dict_lifetime.md query-language/dicts/external-dicts-dict-lifetime.md
-dicts/external_dicts_dict_sources.md query-language/dicts/external-dicts-dict-sources.md
-dicts/external_dicts_dict_structure.md query-language/dicts/external-dicts-dict-structure.md
-dicts/index.md query-language/dicts/index.md
-dicts/internal_dicts.md query-language/dicts/internal-dicts.md
-engines/database_engines/index.md engines/database-engines/index.md
-engines/database_engines/lazy.md engines/database-engines/lazy.md
-engines/database_engines/mysql.md engines/database-engines/mysql.md
-engines/table-engines/log-family/log-family.md engines/table-engines/log-family/index.md
-engines/table_engines/index.md engines/table-engines/index.md
-engines/table_engines/integrations/hdfs.md engines/table-engines/integrations/hdfs.md
-engines/table_engines/integrations/index.md engines/table-engines/integrations/index.md
-engines/table_engines/integrations/jdbc.md engines/table-engines/integrations/jdbc.md
-engines/table_engines/integrations/kafka.md engines/table-engines/integrations/kafka.md
-engines/table_engines/integrations/mysql.md engines/table-engines/integrations/mysql.md
-engines/table_engines/integrations/odbc.md engines/table-engines/integrations/odbc.md
-engines/table_engines/log_family/index.md engines/table-engines/log-family/index.md
-engines/table_engines/log_family/log.md engines/table-engines/log-family/log.md
-engines/table_engines/log_family/log_family.md engines/table-engines/log-family/log-family.md
-engines/table_engines/log_family/stripelog.md engines/table-engines/log-family/stripelog.md
-engines/table_engines/log_family/tinylog.md engines/table-engines/log-family/tinylog.md
-engines/table_engines/mergetree_family/aggregatingmergetree.md engines/table-engines/mergetree-family/aggregatingmergetree.md
-engines/table_engines/mergetree_family/collapsingmergetree.md engines/table-engines/mergetree-family/collapsingmergetree.md
-engines/table_engines/mergetree_family/custom_partitioning_key.md engines/table-engines/mergetree-family/custom-partitioning-key.md
-engines/table_engines/mergetree_family/graphitemergetree.md engines/table-engines/mergetree-family/graphitemergetree.md
-engines/table_engines/mergetree_family/index.md engines/table-engines/mergetree-family/index.md
-engines/table_engines/mergetree_family/mergetree.md engines/table-engines/mergetree-family/mergetree.md
-engines/table_engines/mergetree_family/replacingmergetree.md engines/table-engines/mergetree-family/replacingmergetree.md
-engines/table_engines/mergetree_family/replication.md engines/table-engines/mergetree-family/replication.md
-engines/table_engines/mergetree_family/summingmergetree.md engines/table-engines/mergetree-family/summingmergetree.md
-engines/table_engines/mergetree_family/versionedcollapsingmergetree.md engines/table-engines/mergetree-family/versionedcollapsingmergetree.md
-engines/table_engines/special/buffer.md engines/table-engines/special/buffer.md
-engines/table_engines/special/dictionary.md engines/table-engines/special/dictionary.md
-engines/table_engines/special/distributed.md engines/table-engines/special/distributed.md
-engines/table_engines/special/external_data.md engines/table-engines/special/external-data.md
-engines/table_engines/special/file.md engines/table-engines/special/file.md
-engines/table_engines/special/generate.md engines/table-engines/special/generate.md
-engines/table_engines/special/index.md engines/table-engines/special/index.md
-engines/table_engines/special/join.md engines/table-engines/special/join.md
-engines/table_engines/special/materializedview.md engines/table-engines/special/materializedview.md
-engines/table_engines/special/memory.md engines/table-engines/special/memory.md
-engines/table_engines/special/merge.md engines/table-engines/special/merge.md
-engines/table_engines/special/null.md engines/table-engines/special/null.md
-engines/table_engines/special/set.md engines/table-engines/special/set.md
-engines/table_engines/special/url.md engines/table-engines/special/url.md
-engines/table_engines/special/view.md engines/table-engines/special/view.md
-extended_roadmap.md whats-new/extended-roadmap.md
-formats.md interfaces/formats.md
-formats/capnproto.md interfaces/formats.md
-formats/csv.md interfaces/formats.md
-formats/csvwithnames.md interfaces/formats.md
-formats/json.md interfaces/formats.md
-formats/jsoncompact.md interfaces/formats.md
-formats/jsoneachrow.md interfaces/formats.md
-formats/native.md interfaces/formats.md
-formats/null.md interfaces/formats.md
-formats/pretty.md interfaces/formats.md
-formats/prettycompact.md interfaces/formats.md
-formats/prettycompactmonoblock.md interfaces/formats.md
-formats/prettynoescapes.md interfaces/formats.md
-formats/prettyspace.md interfaces/formats.md
-formats/rowbinary.md interfaces/formats.md
-formats/tabseparated.md interfaces/formats.md
-formats/tabseparatedraw.md interfaces/formats.md
-formats/tabseparatedwithnames.md interfaces/formats.md
-formats/tabseparatedwithnamesandtypes.md interfaces/formats.md
-formats/tskv.md interfaces/formats.md
-formats/values.md interfaces/formats.md
-formats/vertical.md interfaces/formats.md
-formats/verticalraw.md interfaces/formats.md
-formats/xml.md interfaces/formats.md
-functions/arithmetic_functions.md query-language/functions/arithmetic-functions.md
-functions/array_functions.md query-language/functions/array-functions.md
-functions/array_join.md query-language/functions/array-join.md
-functions/bit_functions.md query-language/functions/bit-functions.md
-functions/bitmap_functions.md query-language/functions/bitmap-functions.md
-functions/comparison_functions.md query-language/functions/comparison-functions.md
-functions/conditional_functions.md query-language/functions/conditional-functions.md
-functions/date_time_functions.md query-language/functions/date-time-functions.md
-functions/encoding_functions.md query-language/functions/encoding-functions.md
-functions/ext_dict_functions.md query-language/functions/ext-dict-functions.md
-functions/hash_functions.md query-language/functions/hash-functions.md
-functions/higher_order_functions.md query-language/functions/higher-order-functions.md
-functions/in_functions.md query-language/functions/in-functions.md
-functions/index.md query-language/functions/index.md
-functions/ip_address_functions.md query-language/functions/ip-address-functions.md
-functions/json_functions.md query-language/functions/json-functions.md
-functions/logical_functions.md query-language/functions/logical-functions.md
-functions/math_functions.md query-language/functions/math-functions.md
-functions/other_functions.md query-language/functions/other-functions.md
-functions/random_functions.md query-language/functions/random-functions.md
-functions/rounding_functions.md query-language/functions/rounding-functions.md
-functions/splitting_merging_functions.md query-language/functions/splitting-merging-functions.md
-functions/string_functions.md query-language/functions/string-functions.md
-functions/string_replace_functions.md query-language/functions/string-replace-functions.md
-functions/string_search_functions.md query-language/functions/string-search-functions.md
-functions/type_conversion_functions.md query-language/functions/type-conversion-functions.md
-functions/url_functions.md query-language/functions/url-functions.md
-functions/ym_dict_functions.md query-language/functions/ym-dict-functions.md
-getting_started/example_datasets/amplab_benchmark.md getting-started/example-datasets/amplab-benchmark.md
-getting_started/example_datasets/criteo.md getting-started/example-datasets/criteo.md
-getting_started/example_datasets/index.md getting-started/example-datasets/index.md
-getting_started/example_datasets/metrica.md getting-started/example-datasets/metrica.md
-getting_started/example_datasets/nyc_taxi.md getting-started/example-datasets/nyc-taxi.md
-getting_started/example_datasets/ontime.md getting-started/example-datasets/ontime.md
-getting_started/example_datasets/star_schema.md getting-started/example-datasets/star-schema.md
-getting_started/example_datasets/wikistat.md getting-started/example-datasets/wikistat.md
-getting_started/index.md getting-started/index.md
-getting_started/install.md getting-started/install.md
-getting_started/playground.md getting-started/playground.md
-getting_started/tutorial.md getting-started/tutorial.md
-images/column_oriented.gif images/column-oriented.gif
-images/row_oriented.gif images/row-oriented.gif
-interfaces/http_interface.md interfaces/http.md
-interfaces/third-party/client_libraries.md interfaces/third-party/client-libraries.md
-interfaces/third-party_client_libraries.md interfaces/third-party/client-libraries.md
-interfaces/third-party_gui.md interfaces/third-party/gui.md
-interfaces/third_party/index.md interfaces/third-party/index.md
-introduction/index.md 
-introduction/distinctive_features.md introduction/distinctive-features.md
-introduction/features_considered_disadvantages.md introduction/distinctive-features.md
-introduction/possible_silly_questions.md faq/general.md
-introduction/ya_metrika_task.md introduction/history.md
-operations/access_rights.md operations/access-rights.md
-operations/configuration_files.md operations/configuration-files.md
-operations/optimizing_performance/index.md operations/optimizing-performance/index.md
-operations/optimizing_performance/sampling_query_profiler.md operations/optimizing-performance/sampling-query-profiler.md
-operations/performance/sampling_query_profiler.md operations/optimizing-performance/sampling-query-profiler.md
-operations/performance_test.md operations/performance-test.md
-operations/server_configuration_parameters/index.md operations/server-configuration-parameters/index.md
-operations/server_configuration_parameters/settings.md operations/server-configuration-parameters/settings.md
-operations/server_settings/index.md operations/server-configuration-parameters/index.md
-operations/server_settings/settings.md operations/server-configuration-parameters/settings.md
-operations/settings/constraints_on_settings.md operations/settings/constraints-on-settings.md
-operations/settings/permissions_for_queries.md operations/settings/permissions-for-queries.md
-operations/settings/query_complexity.md operations/settings/query-complexity.md
-operations/settings/settings_profiles.md operations/settings/settings-profiles.md
-operations/settings/settings_users.md operations/settings/settings-users.md
-operations/system_tables.md operations/system-tables.md
-operations/table_engines/aggregatingmergetree.md engines/table-engines/mergetree-family/aggregatingmergetree.md
-operations/table_engines/buffer.md engines/table-engines/special/buffer.md
-operations/table_engines/collapsingmergetree.md engines/table-engines/mergetree-family/collapsingmergetree.md
-operations/table_engines/custom_partitioning_key.md engines/table-engines/mergetree-family/custom-partitioning-key.md
-operations/table_engines/dictionary.md engines/table-engines/special/dictionary.md
-operations/table_engines/distributed.md engines/table-engines/special/distributed.md
-operations/table_engines/external_data.md engines/table-engines/special/external-data.md
-operations/table_engines/file.md engines/table-engines/special/file.md
-operations/table_engines/generate.md engines/table-engines/special/generate.md
-operations/table_engines/graphitemergetree.md engines/table-engines/mergetree-family/graphitemergetree.md
-operations/table_engines/hdfs.md engines/table-engines/integrations/hdfs.md
-operations/table_engines/index.md engines/table-engines/index.md
-operations/table_engines/jdbc.md engines/table-engines/integrations/jdbc.md
-operations/table_engines/join.md engines/table-engines/special/join.md
-operations/table_engines/kafka.md engines/table-engines/integrations/kafka.md
-operations/table_engines/log.md engines/table-engines/log-family/log.md
-operations/table_engines/log_family.md engines/table-engines/log-family/log-family.md
-operations/table_engines/materializedview.md engines/table-engines/special/materializedview.md
-operations/table_engines/memory.md engines/table-engines/special/memory.md
-operations/table_engines/merge.md engines/table-engines/special/merge.md
-operations/table_engines/mergetree.md engines/table-engines/mergetree-family/mergetree.md
-operations/table_engines/mysql.md engines/table-engines/integrations/mysql.md
-operations/table_engines/null.md engines/table-engines/special/null.md
-operations/table_engines/odbc.md engines/table-engines/integrations/odbc.md
-operations/table_engines/replacingmergetree.md engines/table-engines/mergetree-family/replacingmergetree.md
-operations/table_engines/replication.md engines/table-engines/mergetree-family/replication.md
-operations/table_engines/set.md engines/table-engines/special/set.md
-operations/table_engines/stripelog.md engines/table-engines/log-family/stripelog.md
-operations/table_engines/summingmergetree.md engines/table-engines/mergetree-family/summingmergetree.md
-operations/table_engines/tinylog.md engines/table-engines/log-family/tinylog.md
-operations/table_engines/url.md engines/table-engines/special/url.md
-operations/table_engines/versionedcollapsingmergetree.md engines/table-engines/mergetree-family/versionedcollapsingmergetree.md
-operations/table_engines/view.md engines/table-engines/special/view.md
-operations/utils/clickhouse-benchmark.md operations/utilities/clickhouse-benchmark.md
-operations/utils/clickhouse-copier.md operations/utilities/clickhouse-copier.md
-operations/utils/clickhouse-local.md operations/utilities/clickhouse-local.md
-operations/utils/index.md operations/utilities/index.md
-query_language/agg_functions/combinators.md sql-reference/aggregate-functions/combinators.md
-query_language/agg_functions/index.md sql-reference/aggregate-functions/index.md
-query_language/agg_functions/parametric_functions.md sql-reference/aggregate-functions/parametric-functions.md
-query_language/agg_functions/reference.md sql-reference/aggregate-functions/reference.md
-query_language/alter.md sql-reference/statements/alter.md
-query_language/create.md sql-reference/statements/create.md
-query_language/dicts/external_dicts.md sql-reference/dictionaries/external-dictionaries/external-dicts.md
-query_language/dicts/external_dicts_dict.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict.md
-query_language/dicts/external_dicts_dict_hierarchical.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-hierarchical.md
-query_language/dicts/external_dicts_dict_layout.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-layout.md
-query_language/dicts/external_dicts_dict_lifetime.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-lifetime.md
-query_language/dicts/external_dicts_dict_sources.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-sources.md
-query_language/dicts/external_dicts_dict_structure.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-structure.md
-query_language/dicts/index.md sql-reference/dictionaries/index.md
-query_language/dicts/internal_dicts.md sql-reference/dictionaries/internal-dicts.md
-query_language/functions/arithmetic_functions.md sql-reference/functions/arithmetic-functions.md
-query_language/functions/array_functions.md sql-reference/functions/array-functions.md
-query_language/functions/array_join.md sql-reference/functions/array-join.md
-query_language/functions/bit_functions.md sql-reference/functions/bit-functions.md
-query_language/functions/bitmap_functions.md sql-reference/functions/bitmap-functions.md
-query_language/functions/comparison_functions.md sql-reference/functions/comparison-functions.md
-query_language/functions/conditional_functions.md sql-reference/functions/conditional-functions.md
-query_language/functions/date_time_functions.md sql-reference/functions/date-time-functions.md
-query_language/functions/encoding_functions.md sql-reference/functions/encoding-functions.md
-query_language/functions/ext_dict_functions.md sql-reference/functions/ext-dict-functions.md
-query_language/functions/functions_for_nulls.md sql-reference/functions/functions-for-nulls.md
-query_language/functions/geo.md sql-reference/functions/geo.md
-query_language/functions/hash_functions.md sql-reference/functions/hash-functions.md
-query_language/functions/higher_order_functions.md sql-reference/functions/higher-order-functions.md
-query_language/functions/in_functions.md sql-reference/functions/in-functions.md
-query_language/functions/index.md sql-reference/functions/index.md
-query_language/functions/introspection.md sql-reference/functions/introspection.md
-query_language/functions/ip_address_functions.md sql-reference/functions/ip-address-functions.md
-query_language/functions/json_functions.md sql-reference/functions/json-functions.md
-query_language/functions/logical_functions.md sql-reference/functions/logical-functions.md
-query_language/functions/machine_learning_functions.md sql-reference/functions/machine-learning-functions.md
-query_language/functions/math_functions.md sql-reference/functions/math-functions.md
-query_language/functions/other_functions.md sql-reference/functions/other-functions.md
-query_language/functions/random_functions.md sql-reference/functions/random-functions.md
-query_language/functions/rounding_functions.md sql-reference/functions/rounding-functions.md
-query_language/functions/splitting_merging_functions.md sql-reference/functions/splitting-merging-functions.md
-query_language/functions/string_functions.md sql-reference/functions/string-functions.md
-query_language/functions/string_replace_functions.md sql-reference/functions/string-replace-functions.md
-query_language/functions/string_search_functions.md sql-reference/functions/string-search-functions.md
-query_language/functions/type_conversion_functions.md sql-reference/functions/type-conversion-functions.md
-query_language/functions/url_functions.md sql-reference/functions/url-functions.md
-query_language/functions/uuid_functions.md sql-reference/functions/uuid-functions.md
-query_language/functions/ym_dict_functions.md sql-reference/functions/ym-dict-functions.md
-query_language/index.md sql-reference/index.md
-query_language/insert_into.md sql-reference/statements/insert-into.md
-query_language/misc.md sql-reference/statements/misc.md
-query_language/operators.md sql-reference/operators.md
-query_language/queries.md query-language.md
-query_language/select.md sql-reference/statements/select.md
-query_language/show.md sql-reference/statements/show.md
-query_language/syntax.md sql-reference/syntax.md
-query_language/system.md sql-reference/statements/system.md
-query_language/table_functions/file.md sql-reference/table-functions/file.md
-query_language/table_functions/generate.md sql-reference/table-functions/generate.md
-query_language/table_functions/hdfs.md sql-reference/table-functions/hdfs.md
-query_language/table_functions/index.md sql-reference/table-functions/index.md
-query_language/table_functions/input.md sql-reference/table-functions/input.md
-query_language/table_functions/jdbc.md sql-reference/table-functions/jdbc.md
-query_language/table_functions/merge.md sql-reference/table-functions/merge.md
-query_language/table_functions/mysql.md sql-reference/table-functions/mysql.md
-query_language/table_functions/numbers.md sql-reference/table-functions/numbers.md
-query_language/table_functions/odbc.md sql-reference/table-functions/odbc.md
-query_language/table_functions/remote.md sql-reference/table-functions/remote.md
-query_language/table_functions/url.md sql-reference/table-functions/url.md
-roadmap.md whats-new/roadmap.md
-security_changelog.md whats-new/security-changelog.md
-sql-reference/data-types/domains/overview.md sql-reference/data-types/domains/index.md
-sql_reference/aggregate_functions/combinators.md sql-reference/aggregate-functions/combinators.md
-sql_reference/aggregate_functions/index.md sql-reference/aggregate-functions/index.md
-sql_reference/aggregate_functions/parametric_functions.md sql-reference/aggregate-functions/parametric-functions.md
-sql_reference/aggregate_functions/reference.md sql-reference/aggregate-functions/reference.md
-sql_reference/ansi.md sql-reference/ansi.md
-sql_reference/data_types/aggregatefunction.md sql-reference/data-types/aggregatefunction.md
-sql_reference/data_types/array.md sql-reference/data-types/array.md
-sql_reference/data_types/boolean.md sql-reference/data-types/boolean.md
-sql_reference/data_types/date.md sql-reference/data-types/date.md
-sql_reference/data_types/datetime.md sql-reference/data-types/datetime.md
-sql_reference/data_types/datetime64.md sql-reference/data-types/datetime64.md
-sql_reference/data_types/decimal.md sql-reference/data-types/decimal.md
-sql_reference/data_types/domains/index.md sql-reference/data-types/domains/index.md
-sql_reference/data_types/domains/ipv4.md sql-reference/data-types/domains/ipv4.md
-sql_reference/data_types/domains/ipv6.md sql-reference/data-types/domains/ipv6.md
-sql_reference/data_types/domains/overview.md sql-reference/data-types/domains/overview.md
-sql_reference/data_types/enum.md sql-reference/data-types/enum.md
-sql_reference/data_types/fixedstring.md sql-reference/data-types/fixedstring.md
-sql_reference/data_types/float.md sql-reference/data-types/float.md
-sql_reference/data_types/index.md sql-reference/data-types/index.md
-sql_reference/data_types/int_uint.md sql-reference/data-types/int-uint.md
-sql_reference/data_types/nested_data_structures/index.md sql-reference/data-types/nested-data-structures/index.md
-sql_reference/data_types/nested_data_structures/nested.md sql-reference/data-types/nested-data-structures/nested.md
-sql_reference/data_types/nullable.md sql-reference/data-types/nullable.md
-sql_reference/data_types/simpleaggregatefunction.md sql-reference/data-types/simpleaggregatefunction.md
-sql_reference/data_types/special_data_types/expression.md sql-reference/data-types/special-data-types/expression.md
-sql_reference/data_types/special_data_types/index.md sql-reference/data-types/special-data-types/index.md
-sql_reference/data_types/special_data_types/interval.md sql-reference/data-types/special-data-types/interval.md
-sql_reference/data_types/special_data_types/nothing.md sql-reference/data-types/special-data-types/nothing.md
-sql_reference/data_types/special_data_types/set.md sql-reference/data-types/special-data-types/set.md
-sql_reference/data_types/string.md sql-reference/data-types/string.md
-sql_reference/data_types/tuple.md sql-reference/data-types/tuple.md
-sql_reference/data_types/uuid.md sql-reference/data-types/uuid.md
-sql_reference/dictionaries/external_dictionaries/external_dicts.md sql-reference/dictionaries/external-dictionaries/external-dicts.md
-sql_reference/dictionaries/external_dictionaries/external_dicts_dict.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict.md
-sql_reference/dictionaries/external_dictionaries/external_dicts_dict_hierarchical.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-hierarchical.md
-sql_reference/dictionaries/external_dictionaries/external_dicts_dict_layout.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-layout.md
-sql_reference/dictionaries/external_dictionaries/external_dicts_dict_lifetime.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-lifetime.md
-sql_reference/dictionaries/external_dictionaries/external_dicts_dict_sources.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-sources.md
-sql_reference/dictionaries/external_dictionaries/external_dicts_dict_structure.md sql-reference/dictionaries/external-dictionaries/external-dicts-dict-structure.md
-sql_reference/dictionaries/external_dictionaries/index.md sql-reference/dictionaries/external-dictionaries/index.md
-sql_reference/dictionaries/index.md sql-reference/dictionaries/index.md
-sql_reference/dictionaries/internal_dicts.md sql-reference/dictionaries/internal-dicts.md
-sql_reference/functions/arithmetic_functions.md sql-reference/functions/arithmetic-functions.md
-sql_reference/functions/array_functions.md sql-reference/functions/array-functions.md
-sql_reference/functions/array_join.md sql-reference/functions/array-join.md
-sql_reference/functions/bit_functions.md sql-reference/functions/bit-functions.md
-sql_reference/functions/bitmap_functions.md sql-reference/functions/bitmap-functions.md
-sql_reference/functions/comparison_functions.md sql-reference/functions/comparison-functions.md
-sql_reference/functions/conditional_functions.md sql-reference/functions/conditional-functions.md
-sql_reference/functions/date_time_functions.md sql-reference/functions/date-time-functions.md
-sql_reference/functions/encoding_functions.md sql-reference/functions/encoding-functions.md
-sql_reference/functions/ext_dict_functions.md sql-reference/functions/ext-dict-functions.md
-sql_reference/functions/functions_for_nulls.md sql-reference/functions/functions-for-nulls.md
-sql_reference/functions/geo.md sql-reference/functions/geo.md
-sql_reference/functions/hash_functions.md sql-reference/functions/hash-functions.md
-sql_reference/functions/higher_order_functions.md sql-reference/functions/higher-order-functions.md
-sql_reference/functions/in_functions.md sql-reference/functions/in-functions.md
-sql_reference/functions/index.md sql-reference/functions/index.md
-sql_reference/functions/introspection.md sql-reference/functions/introspection.md
-sql_reference/functions/ip_address_functions.md sql-reference/functions/ip-address-functions.md
-sql_reference/functions/json_functions.md sql-reference/functions/json-functions.md
-sql_reference/functions/logical_functions.md sql-reference/functions/logical-functions.md
-sql_reference/functions/machine_learning_functions.md sql-reference/functions/machine-learning-functions.md
-sql_reference/functions/math_functions.md sql-reference/functions/math-functions.md
-sql_reference/functions/other_functions.md sql-reference/functions/other-functions.md
-sql_reference/functions/random_functions.md sql-reference/functions/random-functions.md
-sql_reference/functions/rounding_functions.md sql-reference/functions/rounding-functions.md
-sql_reference/functions/splitting_merging_functions.md sql-reference/functions/splitting-merging-functions.md
-sql_reference/functions/string_functions.md sql-reference/functions/string-functions.md
-sql_reference/functions/string_replace_functions.md sql-reference/functions/string-replace-functions.md
-sql_reference/functions/string_search_functions.md sql-reference/functions/string-search-functions.md
-sql_reference/functions/type_conversion_functions.md sql-reference/functions/type-conversion-functions.md
-sql_reference/functions/url_functions.md sql-reference/functions/url-functions.md
-sql_reference/functions/uuid_functions.md sql-reference/functions/uuid-functions.md
-sql_reference/functions/ym_dict_functions.md sql-reference/functions/ym-dict-functions.md
-sql_reference/index.md sql-reference/index.md
-sql_reference/operators.md sql-reference/operators.md
-sql_reference/statements/alter.md sql-reference/statements/alter.md
-sql_reference/statements/create.md sql-reference/statements/create.md
-sql_reference/statements/index.md sql-reference/statements/index.md
-sql_reference/statements/insert_into.md sql-reference/statements/insert-into.md
-sql_reference/statements/misc.md sql-reference/statements/misc.md
-sql_reference/statements/select.md sql-reference/statements/select.md
-sql_reference/statements/show.md sql-reference/statements/show.md
-sql_reference/statements/system.md sql-reference/statements/system.md
-sql_reference/syntax.md sql-reference/syntax.md
-sql_reference/table_functions/file.md sql-reference/table-functions/file.md
-sql_reference/table_functions/generate.md sql-reference/table-functions/generate.md
-sql_reference/table_functions/hdfs.md sql-reference/table-functions/hdfs.md
-sql_reference/table_functions/index.md sql-reference/table-functions/index.md
-sql_reference/table_functions/input.md sql-reference/table-functions/input.md
-sql_reference/table_functions/jdbc.md sql-reference/table-functions/jdbc.md
-sql_reference/table_functions/merge.md sql-reference/table-functions/merge.md
-sql_reference/table_functions/mysql.md sql-reference/table-functions/mysql.md
-sql_reference/table_functions/numbers.md sql-reference/table-functions/numbers.md
-sql_reference/table_functions/odbc.md sql-reference/table-functions/odbc.md
-sql_reference/table_functions/remote.md sql-reference/table-functions/remote.md
-sql_reference/table_functions/url.md sql-reference/table-functions/url.md
-system_tables.md operations/system-tables.md
-system_tables/system.asynchronous_metrics.md operations/system-tables.md
-system_tables/system.clusters.md operations/system-tables.md
-system_tables/system.columns.md operations/system-tables.md
-system_tables/system.databases.md operations/system-tables.md
-system_tables/system.dictionaries.md operations/system-tables.md
-system_tables/system.events.md operations/system-tables.md
-system_tables/system.functions.md operations/system-tables.md
-system_tables/system.merges.md operations/system-tables.md
-system_tables/system.metrics.md operations/system-tables.md
-system_tables/system.numbers.md operations/system-tables.md
-system_tables/system.numbers_mt.md operations/system-tables.md
-system_tables/system.one.md operations/system-tables.md
-system_tables/system.parts.md operations/system-tables.md
-system_tables/system.processes.md operations/system-tables.md
-system_tables/system.replicas.md operations/system-tables.md
-system_tables/system.settings.md operations/system-tables.md
-system_tables/system.tables.md operations/system-tables.md
-system_tables/system.zookeeper.md operations/system-tables.md
-table_engines.md operations/table-engines.md
-table_engines/aggregatingmergetree.md operations/table-engines/aggregatingmergetree.md
-table_engines/buffer.md operations/table-engines/buffer.md
-table_engines/collapsingmergetree.md operations/table-engines/collapsingmergetree.md
-table_engines/custom_partitioning_key.md operations/table-engines/custom-partitioning-key.md
-table_engines/dictionary.md operations/table-engines/dictionary.md
-table_engines/distributed.md operations/table-engines/distributed.md
-table_engines/external_data.md operations/table-engines/external-data.md
-table_engines/file.md operations/table-engines/file.md
-table_engines/graphitemergetree.md operations/table-engines/graphitemergetree.md
-table_engines/index.md operations/table-engines/index.md
-table_engines/join.md operations/table-engines/join.md
-table_engines/kafka.md operations/table-engines/kafka.md
-table_engines/log.md operations/table-engines/log.md
-table_engines/materializedview.md operations/table-engines/materializedview.md
-table_engines/memory.md operations/table-engines/memory.md
-table_engines/merge.md operations/table-engines/merge.md
-table_engines/mergetree.md operations/table-engines/mergetree.md
-table_engines/mysql.md operations/table-engines/mysql.md
-table_engines/null.md operations/table-engines/null.md
-table_engines/replacingmergetree.md operations/table-engines/replacingmergetree.md
-table_engines/replication.md operations/table-engines/replication.md
-table_engines/set.md operations/table-engines/set.md
-table_engines/summingmergetree.md operations/table-engines/summingmergetree.md
-table_engines/tinylog.md operations/table-engines/tinylog.md
-table_engines/view.md operations/table-engines/view.md
-table_functions/file.md query-language/table-functions/file.md
-table_functions/index.md query-language/table-functions/index.md
-table_functions/merge.md query-language/table-functions/merge.md
-table_functions/numbers.md query-language/table-functions/numbers.md
-table_functions/remote.md query-language/table-functions/remote.md
-utils.md operations/utils.md
-utils/clickhouse-copier.md operations/utils/clickhouse-copier.md
-utils/clickhouse-local.md operations/utils/clickhouse-local.md
-whats_new/changelog/2017.md whats-new/changelog/2017.md
-whats_new/changelog/2018.md whats-new/changelog/2018.md
-whats_new/changelog/2019.md whats-new/changelog/2019.md
-whats_new/changelog/index.md whats-new/changelog/index.md
-whats_new/index.md whats-new/index.md
-whats_new/roadmap.md whats-new/roadmap.md
-whats_new/security_changelog.md whats-new/security-changelog.md
+The redirects from this file were moved to the Docusaurus configuration file.
+If you need to add a redirect please either open a PR in 
+https://github.com/clickhouse/clickhouse-docs adding the redirect to
+https://github.com/ClickHouse/clickhouse-docs/blob/main/docusaurus.config.js
+or open an issue in the same repo and provide the old URL and new URL to have
+the redirect added.

From d0bb9850614e9be96c489ecf3b8c3ad788aab5d3 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Thu, 22 Jun 2023 14:33:25 +0200
Subject: [PATCH 677/722] fix other classes based on SinkToStorage

---
 src/Storages/HDFS/StorageHDFS.cpp | 21 +++++++++++++++++----
 src/Storages/StorageAzureBlob.cpp | 21 +++++++++++++++++----
 src/Storages/StorageFile.cpp      | 21 +++++++++++++++++----
 src/Storages/StorageURL.cpp       | 21 +++++++++++++++++----
 src/Storages/StorageURL.h         |  1 +
 5 files changed, 69 insertions(+), 16 deletions(-)

diff --git a/src/Storages/HDFS/StorageHDFS.cpp b/src/Storages/HDFS/StorageHDFS.cpp
index 7a9d996e3c2..a41c65cdb2e 100644
--- a/src/Storages/HDFS/StorageHDFS.cpp
+++ b/src/Storages/HDFS/StorageHDFS.cpp
@@ -512,10 +512,18 @@ public:
         cancelled = true;
     }
 
-    void onException(std::exception_ptr /* exception */) override
+    void onException(std::exception_ptr exception) override
     {
         std::lock_guard lock(cancel_mutex);
-        finalize();
+        try
+        {
+            std::rethrow_exception(exception);
+        }
+        catch (...)
+        {
+            /// An exception context is needed to proper delete write buffers without finalization
+            release();
+        }
     }
 
     void onFinish() override
@@ -540,12 +548,17 @@ private:
         catch (...)
         {
             /// Stop ParallelFormattingOutputFormat correctly.
-            writer.reset();
-            write_buf->finalize();
+            release();
             throw;
         }
     }
 
+    void release()
+    {
+        writer.reset();
+        write_buf->finalize();
+    }
+
     std::unique_ptr<WriteBuffer> write_buf;
     OutputFormatPtr writer;
     std::mutex cancel_mutex;
diff --git a/src/Storages/StorageAzureBlob.cpp b/src/Storages/StorageAzureBlob.cpp
index 65af2ed6d6e..133dbb6740f 100644
--- a/src/Storages/StorageAzureBlob.cpp
+++ b/src/Storages/StorageAzureBlob.cpp
@@ -489,10 +489,18 @@ public:
         cancelled = true;
     }
 
-    void onException(std::exception_ptr /* exception */) override
+    void onException(std::exception_ptr exception) override
     {
         std::lock_guard lock(cancel_mutex);
-        finalize();
+        try
+        {
+            std::rethrow_exception(exception);
+        }
+        catch (...)
+        {
+            /// An exception context is needed to proper delete write buffers without finalization
+            release();
+        }
     }
 
     void onFinish() override
@@ -516,12 +524,17 @@ private:
         catch (...)
         {
             /// Stop ParallelFormattingOutputFormat correctly.
-            writer.reset();
-            write_buf->finalize();
+            release();
             throw;
         }
     }
 
+    void release()
+    {
+        writer.reset();
+        write_buf->finalize();
+    }
+
     Block sample_block;
     std::optional<FormatSettings> format_settings;
     std::unique_ptr<WriteBuffer> write_buf;
diff --git a/src/Storages/StorageFile.cpp b/src/Storages/StorageFile.cpp
index 50aa47ffca9..ff67272e542 100644
--- a/src/Storages/StorageFile.cpp
+++ b/src/Storages/StorageFile.cpp
@@ -1031,10 +1031,18 @@ public:
         cancelled = true;
     }
 
-    void onException(std::exception_ptr /* exception */) override
+    void onException(std::exception_ptr exception) override
     {
         std::lock_guard cancel_lock(cancel_mutex);
-        finalize();
+        try
+        {
+            std::rethrow_exception(exception);
+        }
+        catch (...)
+        {
+            /// An exception context is needed to proper delete write buffers without finalization
+            release();
+        }
     }
 
     void onFinish() override
@@ -1058,12 +1066,17 @@ private:
         catch (...)
         {
             /// Stop ParallelFormattingOutputFormat correctly.
-            writer.reset();
-            write_buf->finalize();
+            release();
             throw;
         }
     }
 
+    void release()
+    {
+        writer.reset();
+        write_buf->finalize();
+    }
+
     StorageMetadataPtr metadata_snapshot;
     String table_name_for_log;
 
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index 651b50518d2..20071afb793 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -480,10 +480,18 @@ void StorageURLSink::onCancel()
     cancelled = true;
 }
 
-void StorageURLSink::onException(std::exception_ptr /* exception */)
+void StorageURLSink::onException(std::exception_ptr exception)
 {
     std::lock_guard lock(cancel_mutex);
-    finalize();
+    try
+    {
+        std::rethrow_exception(exception);
+    }
+    catch (...)
+    {
+        /// An exception context is needed to proper delete write buffers without finalization
+        release();
+    }
 }
 
 void StorageURLSink::onFinish()
@@ -506,12 +514,17 @@ void StorageURLSink::finalize()
     catch (...)
     {
         /// Stop ParallelFormattingOutputFormat correctly.
-        writer.reset();
-        write_buf->finalize();
+        release();
         throw;
     }
 }
 
+void StorageURLSink::release()
+{
+    writer.reset();
+    write_buf->finalize();
+}
+
 class PartitionedStorageURLSink : public PartitionedSink
 {
 public:
diff --git a/src/Storages/StorageURL.h b/src/Storages/StorageURL.h
index c4a5ce1aa7b..345f813dd7c 100644
--- a/src/Storages/StorageURL.h
+++ b/src/Storages/StorageURL.h
@@ -241,6 +241,7 @@ public:
 
 private:
     void finalize();
+    void release();
     std::unique_ptr<WriteBuffer> write_buf;
     OutputFormatPtr writer;
     std::mutex cancel_mutex;

From 3c7d749d2ce80373fe7839a08fc3174e999b6a69 Mon Sep 17 00:00:00 2001
From: Smita Kulkarni <Smita.Kulkarni@clickhouse.com>
Date: Thu, 22 Jun 2023 14:47:04 +0200
Subject: [PATCH 678/722] Added check of StorageView before checking
 parameterized view to fix seg fault when materialized view is used with
 brackets

---
 src/Interpreters/Context.cpp                                 | 2 +-
 tests/queries/0_stateless/02428_parameterized_view.reference | 1 +
 tests/queries/0_stateless/02428_parameterized_view.sh        | 3 +++
 3 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/Interpreters/Context.cpp b/src/Interpreters/Context.cpp
index 995e78d8f0b..106264320b2 100644
--- a/src/Interpreters/Context.cpp
+++ b/src/Interpreters/Context.cpp
@@ -1476,7 +1476,7 @@ StoragePtr Context::executeTableFunction(const ASTPtr & table_expression, const
     StoragePtr table = DatabaseCatalog::instance().tryGetTable({database_name, table_name}, getQueryContext());
     if (table)
     {
-        if (table.get()->isView() && table->as<StorageView>()->isParameterizedView())
+        if (table.get()->isView() && table->as<StorageView>() && table->as<StorageView>()->isParameterizedView())
         {
             function->prefer_subquery_to_function_formatting = true;
             return table;
diff --git a/tests/queries/0_stateless/02428_parameterized_view.reference b/tests/queries/0_stateless/02428_parameterized_view.reference
index b73c52c478f..422fdaa4983 100644
--- a/tests/queries/0_stateless/02428_parameterized_view.reference
+++ b/tests/queries/0_stateless/02428_parameterized_view.reference
@@ -40,3 +40,4 @@ ERROR
 10
 10
 1
+ERROR
diff --git a/tests/queries/0_stateless/02428_parameterized_view.sh b/tests/queries/0_stateless/02428_parameterized_view.sh
index 3abfbfc22fc..ad9c672f4c5 100755
--- a/tests/queries/0_stateless/02428_parameterized_view.sh
+++ b/tests/queries/0_stateless/02428_parameterized_view.sh
@@ -112,7 +112,10 @@ $CLICKHOUSE_CLIENT -q "CREATE VIEW 02428_trace_view AS WITH  {trace_id:String} A
                        FROM 02428_otel_traces"
 $CLICKHOUSE_CLIENT -q "SELECT * FROM 02428_trace_view(trace_id='1')"
 
+$CLICKHOUSE_CLIENT -q "CREATE MATERIALIZED VIEW test_02428_mv1 ENGINE = ReplicatedMergeTree('/clickhouse/tables/$CLICKHOUSE_TEST_ZOOKEEPER_PREFIX/materialized_view', 'r1') ORDER BY Name AS SELECT * FROM test_02428_Catalog;"
+$CLICKHOUSE_CLIENT -q "SELECT * FROM test_02428_mv1(test)" 2>&1 |  grep -Fq "UNKNOWN_FUNCTION" && echo 'ERROR' || echo 'OK'
 
+$CLICKHOUSE_CLIENT -q "DROP VIEW test_02428_mv1"
 $CLICKHOUSE_CLIENT -q "DROP VIEW test_02428_pv1"
 $CLICKHOUSE_CLIENT -q "DROP VIEW test_02428_pv2"
 $CLICKHOUSE_CLIENT -q "DROP VIEW test_02428_pv3"

From dd49f4a5651076136ed8deda33ac2f1f71ba8635 Mon Sep 17 00:00:00 2001
From: kssenii <sumarokovakseniia@mail.ru>
Date: Thu, 22 Jun 2023 17:07:52 +0200
Subject: [PATCH 679/722] Remove key

---
 src/Interpreters/Cache/Metadata.cpp | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/Interpreters/Cache/Metadata.cpp b/src/Interpreters/Cache/Metadata.cpp
index b19d095692d..75d37072711 100644
--- a/src/Interpreters/Cache/Metadata.cpp
+++ b/src/Interpreters/Cache/Metadata.cpp
@@ -53,17 +53,13 @@ KeyMetadata::KeyMetadata(
     const Key & key_,
     const std::string & key_path_,
     CleanupQueue & cleanup_queue_,
-    [[maybe_unused]] Poco::Logger * log_,
+    Poco::Logger * log_,
     bool created_base_directory_)
     : key(key_)
     , key_path(key_path_)
     , cleanup_queue(cleanup_queue_)
     , created_base_directory(created_base_directory_)
-#ifdef ABORT_ON_LOGICAL_ERROR
-    , log(&Poco::Logger::get("Key(" + key.toString() + ")"))
-#else
     , log(log_)
-#endif
 {
     if (created_base_directory)
         chassert(fs::exists(key_path));

From 4b0d5a8a96c744912ddb514e779c40a560abb27c Mon Sep 17 00:00:00 2001
From: Thom O'Connor <thom@clickhouse.com>
Date: Thu, 22 Jun 2023 09:30:23 -0600
Subject: [PATCH 680/722] Update remote.md

Simplifying this example for remoteSecure():
* no reason to be using a ReplicatedMergeTree example here
* no reason to be setting index_granularity to a default value
---
 docs/en/sql-reference/table-functions/remote.md | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/docs/en/sql-reference/table-functions/remote.md b/docs/en/sql-reference/table-functions/remote.md
index bf0abd49fc6..8dcae6a0a79 100644
--- a/docs/en/sql-reference/table-functions/remote.md
+++ b/docs/en/sql-reference/table-functions/remote.md
@@ -114,9 +114,8 @@ This example uses one table from a sample dataset.  The database is `imdb`, and
                             `first_name` String,
                             `last_name` String,
                             `gender` FixedString(1))
-                  ENGINE = ReplicatedMergeTree('/clickhouse/tables/{uuid}/{shard}', '{replica}')
-                  ORDER BY (id, first_name, last_name, gender)
-                  SETTINGS index_granularity = 8192
+                  ENGINE = MergeTree
+                  ORDER BY (id, first_name, last_name, gender);
   ```
 
 #### On the destination ClickHouse system:
@@ -132,9 +131,8 @@ This example uses one table from a sample dataset.  The database is `imdb`, and
                             `first_name` String,
                             `last_name` String,
                             `gender` FixedString(1))
-                  ENGINE = ReplicatedMergeTree('/clickhouse/tables/{uuid}/{shard}', '{replica}')
-                  ORDER BY (id, first_name, last_name, gender)
-                  SETTINGS index_granularity = 8192
+                  ENGINE = MergeTree
+                  ORDER BY (id, first_name, last_name, gender);
   ```
 
 #### Back on the source deployment:
@@ -142,7 +140,7 @@ This example uses one table from a sample dataset.  The database is `imdb`, and
 Insert into the new database and table created on the remote system.  You will need the host, port, username, password, destination database, and destination table.
 ```sql
 INSERT INTO FUNCTION
-remoteSecure('remote.clickhouse.cloud:9440', 'imdb.actors', 'USER', 'PASSWORD', rand())
+remoteSecure('remote.clickhouse.cloud:9440', 'imdb.actors', 'USER', 'PASSWORD')
 SELECT * from imdb.actors
 ```
 

From a89bfb9ec507c08c732cb1088915914a42485e41 Mon Sep 17 00:00:00 2001
From: ltrk2 <107155950+ltrk2@users.noreply.github.com>
Date: Thu, 22 Jun 2023 08:59:44 -0700
Subject: [PATCH 681/722] Revert back to value type as requested

---
 src/IO/WriteHelpers.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/IO/WriteHelpers.h b/src/IO/WriteHelpers.h
index 2ee1e1651f6..3d1a5aa49ef 100644
--- a/src/IO/WriteHelpers.h
+++ b/src/IO/WriteHelpers.h
@@ -1183,13 +1183,13 @@ inline void writeBinaryEndian(T x, WriteBuffer & buf)
 }
 
 template <typename T>
-inline void writeBinaryLittleEndian(const T & x, WriteBuffer & buf)
+inline void writeBinaryLittleEndian(T x, WriteBuffer & buf)
 {
     writeBinaryEndian<std::endian::little>(x, buf);
 }
 
 template <typename T>
-inline void writeBinaryBigEndian(const T & x, WriteBuffer & buf)
+inline void writeBinaryBigEndian(T x, WriteBuffer & buf)
 {
     writeBinaryEndian<std::endian::big>(x, buf);
 }

From 2498170253f91f7406452b99ef1dd168c8a9ec2d Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Wed, 21 Jun 2023 23:46:12 +0000
Subject: [PATCH 682/722] Fix use-after-free in StorageURL when switching URLs

---
 src/Formats/FormatFactory.h | 1 +
 src/Storages/StorageURL.cpp | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/src/Formats/FormatFactory.h b/src/Formats/FormatFactory.h
index 1d258beca8d..489db944ee6 100644
--- a/src/Formats/FormatFactory.h
+++ b/src/Formats/FormatFactory.h
@@ -153,6 +153,7 @@ public:
     ///  * Parallel reading.
     ///    To enable it, make sure `buf` is a SeekableReadBuffer implementing readBigAt().
     ///  * Parallel parsing.
+    /// `buf` must outlive the returned IInputFormat.
     InputFormatPtr getInput(
         const String & name,
         ReadBuffer & buf,
diff --git a/src/Storages/StorageURL.cpp b/src/Storages/StorageURL.cpp
index 1d6aed204cb..aa574ef11be 100644
--- a/src/Storages/StorageURL.cpp
+++ b/src/Storages/StorageURL.cpp
@@ -361,6 +361,8 @@ Chunk StorageURLSource::generate()
 
         pipeline->reset();
         reader.reset();
+        input_format.reset();
+        read_buf.reset();
     }
     return {};
 }

From 0823d610a398ffe435e3b3d163e691f72eca89f5 Mon Sep 17 00:00:00 2001
From: Michael Kolupaev <michael.kolupaev@clickhouse.com>
Date: Thu, 22 Jun 2023 00:57:50 +0000
Subject: [PATCH 683/722] A test

---
 .../0_stateless/02790_url_multiple_tsv_files.reference       | 5 +++++
 tests/queries/0_stateless/02790_url_multiple_tsv_files.sql   | 5 +++++
 2 files changed, 10 insertions(+)
 create mode 100644 tests/queries/0_stateless/02790_url_multiple_tsv_files.reference
 create mode 100644 tests/queries/0_stateless/02790_url_multiple_tsv_files.sql

diff --git a/tests/queries/0_stateless/02790_url_multiple_tsv_files.reference b/tests/queries/0_stateless/02790_url_multiple_tsv_files.reference
new file mode 100644
index 00000000000..927a33afecf
--- /dev/null
+++ b/tests/queries/0_stateless/02790_url_multiple_tsv_files.reference
@@ -0,0 +1,5 @@
+136
+136
+136
+136
+136
diff --git a/tests/queries/0_stateless/02790_url_multiple_tsv_files.sql b/tests/queries/0_stateless/02790_url_multiple_tsv_files.sql
new file mode 100644
index 00000000000..b71bd7c737a
--- /dev/null
+++ b/tests/queries/0_stateless/02790_url_multiple_tsv_files.sql
@@ -0,0 +1,5 @@
+select sum(*) from (select * from url('http://127.0.0.1:8123?query=select+{1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16}+as+x+format+TSV', 'TSV') settings max_threads=1, max_download_threads=1);
+select sum(*) from (select * from url('http://127.0.0.1:8123?query=select+{1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16}+as+x+format+CSV', 'CSV') settings max_threads=1, max_download_threads=1);
+select sum(*) from (select * from url('http://127.0.0.1:8123?query=select+{1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16}+as+x+format+JSONEachRow', 'JSONEachRow') settings max_threads=1, max_download_threads=1);
+select sum(*) from (select * from url('http://127.0.0.1:8123?query=select+{1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16}+as+x+format+TSKV', 'TSKV') settings max_threads=1, max_download_threads=1);
+select sum(*) from (select * from url('http://127.0.0.1:8123?query=select+{1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16}+as+x+format+Native', 'Native') settings max_threads=1, max_download_threads=1);

From 456709488ead67d890d965fb04f10e5fcf4fa307 Mon Sep 17 00:00:00 2001
From: Mike Kot <myrrc@double.cloud>
Date: Thu, 22 Jun 2023 20:03:36 +0300
Subject: [PATCH 684/722] Update ext-dict-functions.md

---
 docs/ru/sql-reference/functions/ext-dict-functions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ru/sql-reference/functions/ext-dict-functions.md b/docs/ru/sql-reference/functions/ext-dict-functions.md
index e6cb878d1c7..d14f0ddf027 100644
--- a/docs/ru/sql-reference/functions/ext-dict-functions.md
+++ b/docs/ru/sql-reference/functions/ext-dict-functions.md
@@ -5,7 +5,7 @@ sidebar_label: "Функции для работы с внешними слов
 ---
 
 :::note "Внимание"
-    Для словарей, созданных с помощью [DDL-запросов](../../sql-reference/statements/create/dictionary.md), в параметре `dict_name` указывается полное имя словаря вместе с базой данных, например: `<database>.<dict_name>`. Если база данных не указана, используется текущая.
+Для словарей, созданных с помощью [DDL-запросов](../../sql-reference/statements/create/dictionary.md), в параметре `dict_name` указывается полное имя словаря вместе с базой данных, например: `<database>.<dict_name>`. Если база данных не указана, используется текущая.
 :::
 
 # Функции для работы с внешними словарями {#ext_dict_functions}

From 8afb8bf13afd654a6706b69f58da83b6096770db Mon Sep 17 00:00:00 2001
From: Alexander Tokmakov <tavplubix@clickhouse.com>
Date: Thu, 22 Jun 2023 19:06:28 +0200
Subject: [PATCH 685/722] disable table structure check for secondary queries
 from Replicated db

---
 src/Databases/DatabaseReplicated.cpp          |  4 +-
 src/Databases/DatabaseReplicatedWorker.cpp    |  1 +
 .../MergeTree/registerStorageMergeTree.cpp    |  8 ++-
 src/Storages/StorageReplicatedMergeTree.cpp   | 39 ++++++++++-----
 src/Storages/StorageReplicatedMergeTree.h     |  5 +-
 .../test_replicated_database/test.py          | 49 +++++++++++++++++++
 6 files changed, 90 insertions(+), 16 deletions(-)

diff --git a/src/Databases/DatabaseReplicated.cpp b/src/Databases/DatabaseReplicated.cpp
index e468e533818..de40ee4d82d 100644
--- a/src/Databases/DatabaseReplicated.cpp
+++ b/src/Databases/DatabaseReplicated.cpp
@@ -985,7 +985,7 @@ void DatabaseReplicated::recoverLostReplica(const ZooKeeperPtr & current_zookeep
         const auto & create_query_string = metadata_it->second;
         if (isTableExist(table_name, getContext()))
         {
-            assert(create_query_string == readMetadataFile(table_name));
+            assert(create_query_string == readMetadataFile(table_name) || getTableUUIDIfReplicated(create_query_string, getContext()) != UUIDHelpers::Nil);
             continue;
         }
 
@@ -1274,7 +1274,7 @@ void DatabaseReplicated::commitAlterTable(const StorageID & table_id,
                                           const String & statement, ContextPtr query_context)
 {
     auto txn = query_context->getZooKeeperMetadataTransaction();
-    assert(!ddl_worker->isCurrentlyActive() || txn);
+    assert(!ddl_worker || !ddl_worker->isCurrentlyActive() || txn);
     if (txn && txn->isInitialQuery())
     {
         String metadata_zk_path = zookeeper_path + "/metadata/" + escapeForFileName(table_id.table_name);
diff --git a/src/Databases/DatabaseReplicatedWorker.cpp b/src/Databases/DatabaseReplicatedWorker.cpp
index 66ae5cd250c..ff2675dfd6b 100644
--- a/src/Databases/DatabaseReplicatedWorker.cpp
+++ b/src/Databases/DatabaseReplicatedWorker.cpp
@@ -91,6 +91,7 @@ void DatabaseReplicatedDDLWorker::initializeReplication()
     if (zookeeper->tryGet(database->replica_path + "/digest", digest_str))
     {
         digest = parse<UInt64>(digest_str);
+        LOG_TRACE(log, "Metadata digest in ZooKeeper: {}", digest);
         std::lock_guard lock{database->metadata_mutex};
         local_digest = database->tables_metadata_digest;
     }
diff --git a/src/Storages/MergeTree/registerStorageMergeTree.cpp b/src/Storages/MergeTree/registerStorageMergeTree.cpp
index 027cd1af7c9..75f1542e30e 100644
--- a/src/Storages/MergeTree/registerStorageMergeTree.cpp
+++ b/src/Storages/MergeTree/registerStorageMergeTree.cpp
@@ -23,6 +23,7 @@
 #include <Interpreters/Context.h>
 #include <Interpreters/FunctionNameNormalizer.h>
 #include <Interpreters/evaluateConstantExpression.h>
+#include <Interpreters/DDLTask.h>
 
 
 namespace DB
@@ -684,6 +685,10 @@ static StoragePtr create(const StorageFactory::Arguments & args)
 
     if (replicated)
     {
+        bool need_check_table_structure = true;
+        if (auto txn = args.getLocalContext()->getZooKeeperMetadataTransaction())
+            need_check_table_structure = txn->isInitialQuery();
+
         return std::make_shared<StorageReplicatedMergeTree>(
             zookeeper_path,
             replica_name,
@@ -696,7 +701,8 @@ static StoragePtr create(const StorageFactory::Arguments & args)
             merging_params,
             std::move(storage_settings),
             args.has_force_restore_data_flag,
-            renaming_restrictions);
+            renaming_restrictions,
+            need_check_table_structure);
     }
     else
         return std::make_shared<StorageMergeTree>(
diff --git a/src/Storages/StorageReplicatedMergeTree.cpp b/src/Storages/StorageReplicatedMergeTree.cpp
index bb99e21e4ab..8f34fca85c5 100644
--- a/src/Storages/StorageReplicatedMergeTree.cpp
+++ b/src/Storages/StorageReplicatedMergeTree.cpp
@@ -292,7 +292,8 @@ StorageReplicatedMergeTree::StorageReplicatedMergeTree(
     const MergingParams & merging_params_,
     std::unique_ptr<MergeTreeSettings> settings_,
     bool has_force_restore_data_flag,
-    RenamingRestrictions renaming_restrictions_)
+    RenamingRestrictions renaming_restrictions_,
+    bool need_check_structure)
     : MergeTreeData(table_id_,
                     metadata_,
                     context_,
@@ -492,11 +493,17 @@ StorageReplicatedMergeTree::StorageReplicatedMergeTree(
             /// information in /replica/metadata.
             other_replicas_fixed_granularity = checkFixedGranularityInZookeeper();
 
-            checkTableStructure(zookeeper_path, metadata_snapshot);
+            /// Allow structure mismatch for secondary queries from Replicated database.
+            /// It may happen if the table was altered just after creation.
+            /// Metadata will be updated in cloneMetadataIfNeeded(...), metadata_version will be 0 for a while.
+            bool same_structure = checkTableStructure(zookeeper_path, metadata_snapshot, need_check_structure);
 
-            Coordination::Stat metadata_stat;
-            current_zookeeper->get(zookeeper_path + "/metadata", &metadata_stat);
-            setInMemoryMetadata(metadata_snapshot->withMetadataVersion(metadata_stat.version));
+            if (same_structure)
+            {
+                Coordination::Stat metadata_stat;
+                current_zookeeper->get(zookeeper_path + "/metadata", &metadata_stat);
+                setInMemoryMetadata(metadata_snapshot->withMetadataVersion(metadata_stat.version));
+            }
         }
         catch (Coordination::Exception & e)
         {
@@ -1186,7 +1193,7 @@ bool StorageReplicatedMergeTree::removeTableNodesFromZooKeeper(zkutil::ZooKeeper
 /** Verify that list of columns and table storage_settings_ptr match those specified in ZK (/metadata).
   * If not, throw an exception.
   */
-void StorageReplicatedMergeTree::checkTableStructure(const String & zookeeper_prefix, const StorageMetadataPtr & metadata_snapshot)
+bool StorageReplicatedMergeTree::checkTableStructure(const String & zookeeper_prefix, const StorageMetadataPtr & metadata_snapshot, bool strict_check)
 {
     auto zookeeper = getZooKeeper();
 
@@ -1201,12 +1208,20 @@ void StorageReplicatedMergeTree::checkTableStructure(const String & zookeeper_pr
     auto columns_from_zk = ColumnsDescription::parse(zookeeper->get(fs::path(zookeeper_prefix) / "columns", &columns_stat));
 
     const ColumnsDescription & old_columns = metadata_snapshot->getColumns();
-    if (columns_from_zk != old_columns)
+    if (columns_from_zk == old_columns)
+        return true;
+
+    if (!strict_check && metadata_stat.version != 0)
     {
-        throw Exception(ErrorCodes::INCOMPATIBLE_COLUMNS,
-            "Table columns structure in ZooKeeper is different from local table structure. Local columns:\n"
-            "{}\nZookeeper columns:\n{}", old_columns.toString(), columns_from_zk.toString());
+        LOG_WARNING(log, "Table columns structure in ZooKeeper is different from local table structure. "
+                    "Assuming it's because the table was altered concurrently. Metadata version: {}. Local columns:\n"
+                    "{}\nZookeeper columns:\n{}", metadata_stat.version, old_columns.toString(), columns_from_zk.toString());
+        return false;
     }
+
+    throw Exception(ErrorCodes::INCOMPATIBLE_COLUMNS,
+        "Table columns structure in ZooKeeper is different from local table structure. Local columns:\n"
+        "{}\nZookeeper columns:\n{}", old_columns.toString(), columns_from_zk.toString());
 }
 
 void StorageReplicatedMergeTree::setTableStructure(const StorageID & table_id, const ContextPtr & local_context,
@@ -2993,7 +3008,9 @@ void StorageReplicatedMergeTree::cloneMetadataIfNeeded(const String & source_rep
     dummy_alter.alter_version = source_metadata_version;
     dummy_alter.create_time = time(nullptr);
 
-    zookeeper->create(replica_path + "/queue/queue-", dummy_alter.toString(), zkutil::CreateMode::PersistentSequential);
+    String path_created = zookeeper->create(replica_path + "/queue/queue-", dummy_alter.toString(), zkutil::CreateMode::PersistentSequential);
+    LOG_INFO(log, "Created an ALTER_METADATA entry {} to force metadata update after cloning replica from {}. Entry: {}",
+             path_created, source_replica, dummy_alter.toString());
 
     /// We don't need to do anything with mutation_pointer, because mutation log cleanup process is different from
     /// replication log cleanup. A mutation is removed from ZooKeeper only if all replicas had executed the mutation,
diff --git a/src/Storages/StorageReplicatedMergeTree.h b/src/Storages/StorageReplicatedMergeTree.h
index c08e05090b1..bdd3f0da5bf 100644
--- a/src/Storages/StorageReplicatedMergeTree.h
+++ b/src/Storages/StorageReplicatedMergeTree.h
@@ -108,7 +108,8 @@ public:
         const MergingParams & merging_params_,
         std::unique_ptr<MergeTreeSettings> settings_,
         bool has_force_restore_data_flag,
-        RenamingRestrictions renaming_restrictions_);
+        RenamingRestrictions renaming_restrictions_,
+        bool need_check_structure);
 
     void startup() override;
     void shutdown() override;
@@ -529,7 +530,7 @@ private:
       */
     void createNewZooKeeperNodes();
 
-    void checkTableStructure(const String & zookeeper_prefix, const StorageMetadataPtr & metadata_snapshot);
+    bool checkTableStructure(const String & zookeeper_prefix, const StorageMetadataPtr & metadata_snapshot, bool strict_check = true);
 
     /// A part of ALTER: apply metadata changes only (data parts are altered separately).
     /// Must be called under IStorage::lockForAlter() lock.
diff --git a/tests/integration/test_replicated_database/test.py b/tests/integration/test_replicated_database/test.py
index 2ab2fe499ff..8d4244b69b5 100644
--- a/tests/integration/test_replicated_database/test.py
+++ b/tests/integration/test_replicated_database/test.py
@@ -34,6 +34,7 @@ competing_node = cluster.add_instance(
     main_configs=["configs/config.xml"],
     user_configs=["configs/settings.xml"],
     with_zookeeper=True,
+    stay_alive=True,
     macros={"shard": 1, "replica": 3},
 )
 snapshotting_node = cluster.add_instance(
@@ -1272,3 +1273,51 @@ def test_recover_digest_mismatch(started_cluster):
     dummy_node.query("DROP DATABASE IF EXISTS recover_digest_mismatch")
 
     print("Everything Okay")
+
+def test_replicated_table_structure_alter(started_cluster):
+    main_node.query("DROP DATABASE IF EXISTS table_structure")
+    dummy_node.query("DROP DATABASE IF EXISTS table_structure")
+
+    main_node.query(
+        "CREATE DATABASE table_structure ENGINE = Replicated('/clickhouse/databases/table_structure', 'shard1', 'replica1');"
+    )
+    dummy_node.query(
+        "CREATE DATABASE table_structure ENGINE = Replicated('/clickhouse/databases/table_structure', 'shard1', 'replica2');"
+    )
+    competing_node.query(
+        "CREATE DATABASE table_structure ENGINE = Replicated('/clickhouse/databases/table_structure', 'shard1', 'replica3');"
+    )
+
+    competing_node.query("CREATE TABLE table_structure.mem (n int) ENGINE=Memory")
+    dummy_node.query("DETACH DATABASE table_structure")
+
+    settings = {"distributed_ddl_task_timeout": 0}
+    main_node.query("CREATE TABLE table_structure.rmt (n int, v UInt64) ENGINE=ReplicatedReplacingMergeTree(v) ORDER BY n", settings=settings)
+
+    competing_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
+    competing_node.query("DETACH DATABASE table_structure")
+
+    main_node.query("ALTER TABLE table_structure.rmt ADD COLUMN m int", settings=settings)
+    main_node.query("ALTER TABLE table_structure.rmt COMMENT COLUMN v 'version'", settings=settings)
+    main_node.query("INSERT INTO table_structure.rmt VALUES (1, 2, 3)")
+
+    command = "rm -f /var/lib/clickhouse/metadata/table_structure/mem.sql"
+    competing_node.exec_in_container(["bash", "-c", command])
+    competing_node.restart_clickhouse(kill=True)
+
+    dummy_node.query("ATTACH DATABASE table_structure")
+    dummy_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
+    dummy_node.query("SYSTEM SYNC REPLICA table_structure.rmt")
+    assert "1\t2\t3\n" == dummy_node.query("SELECT * FROM table_structure.rmt")
+
+    competing_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
+    competing_node.query("SYSTEM SYNC REPLICA table_structure.rmt")
+    #time.sleep(600)
+    assert "mem" in competing_node.query("SHOW TABLES FROM table_structure")
+    assert "1\t2\t3\n" == competing_node.query("SELECT * FROM table_structure.rmt")
+
+    main_node.query("ALTER TABLE table_structure.rmt ADD COLUMN k int")
+    main_node.query("INSERT INTO table_structure.rmt VALUES (1, 2, 3, 4)")
+    dummy_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
+    dummy_node.query("SYSTEM SYNC REPLICA table_structure.rmt")
+    assert "1\t2\t3\t0\n1\t2\t3\t4\n" == dummy_node.query("SELECT * FROM table_structure.rmt ORDER BY k")

From ccb42d0afa202aba6b4a8459bae971afa87a67dd Mon Sep 17 00:00:00 2001
From: robot-clickhouse <robot-clickhouse@users.noreply.github.com>
Date: Thu, 22 Jun 2023 17:26:42 +0000
Subject: [PATCH 686/722] Automatic style fix

---
 .../test_replicated_database/test.py          | 20 ++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/tests/integration/test_replicated_database/test.py b/tests/integration/test_replicated_database/test.py
index 8d4244b69b5..b3ba8d4737f 100644
--- a/tests/integration/test_replicated_database/test.py
+++ b/tests/integration/test_replicated_database/test.py
@@ -1274,6 +1274,7 @@ def test_recover_digest_mismatch(started_cluster):
 
     print("Everything Okay")
 
+
 def test_replicated_table_structure_alter(started_cluster):
     main_node.query("DROP DATABASE IF EXISTS table_structure")
     dummy_node.query("DROP DATABASE IF EXISTS table_structure")
@@ -1292,13 +1293,20 @@ def test_replicated_table_structure_alter(started_cluster):
     dummy_node.query("DETACH DATABASE table_structure")
 
     settings = {"distributed_ddl_task_timeout": 0}
-    main_node.query("CREATE TABLE table_structure.rmt (n int, v UInt64) ENGINE=ReplicatedReplacingMergeTree(v) ORDER BY n", settings=settings)
+    main_node.query(
+        "CREATE TABLE table_structure.rmt (n int, v UInt64) ENGINE=ReplicatedReplacingMergeTree(v) ORDER BY n",
+        settings=settings,
+    )
 
     competing_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
     competing_node.query("DETACH DATABASE table_structure")
 
-    main_node.query("ALTER TABLE table_structure.rmt ADD COLUMN m int", settings=settings)
-    main_node.query("ALTER TABLE table_structure.rmt COMMENT COLUMN v 'version'", settings=settings)
+    main_node.query(
+        "ALTER TABLE table_structure.rmt ADD COLUMN m int", settings=settings
+    )
+    main_node.query(
+        "ALTER TABLE table_structure.rmt COMMENT COLUMN v 'version'", settings=settings
+    )
     main_node.query("INSERT INTO table_structure.rmt VALUES (1, 2, 3)")
 
     command = "rm -f /var/lib/clickhouse/metadata/table_structure/mem.sql"
@@ -1312,7 +1320,7 @@ def test_replicated_table_structure_alter(started_cluster):
 
     competing_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
     competing_node.query("SYSTEM SYNC REPLICA table_structure.rmt")
-    #time.sleep(600)
+    # time.sleep(600)
     assert "mem" in competing_node.query("SHOW TABLES FROM table_structure")
     assert "1\t2\t3\n" == competing_node.query("SELECT * FROM table_structure.rmt")
 
@@ -1320,4 +1328,6 @@ def test_replicated_table_structure_alter(started_cluster):
     main_node.query("INSERT INTO table_structure.rmt VALUES (1, 2, 3, 4)")
     dummy_node.query("SYSTEM SYNC DATABASE REPLICA table_structure")
     dummy_node.query("SYSTEM SYNC REPLICA table_structure.rmt")
-    assert "1\t2\t3\t0\n1\t2\t3\t4\n" == dummy_node.query("SELECT * FROM table_structure.rmt ORDER BY k")
+    assert "1\t2\t3\t0\n1\t2\t3\t4\n" == dummy_node.query(
+        "SELECT * FROM table_structure.rmt ORDER BY k"
+    )

From 3d385be9cb9236cd59baead6e4ad83d34316e357 Mon Sep 17 00:00:00 2001
From: Andrey Zvonov <32552679+zvonand@users.noreply.github.com>
Date: Thu, 22 Jun 2023 20:56:50 +0300
Subject: [PATCH 687/722] Update Settings.h

---
 src/Core/Settings.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Core/Settings.h b/src/Core/Settings.h
index d01caeda344..3d42bd582ed 100644
--- a/src/Core/Settings.h
+++ b/src/Core/Settings.h
@@ -770,7 +770,7 @@ class IColumn;
     M(Bool, allow_experimental_undrop_table_query, false, "Allow to use undrop query to restore dropped table in a limited time", 0) \
     M(Bool, keeper_map_strict_mode, false, "Enforce additional checks during operations on KeeperMap. E.g. throw an exception on an insert for already existing key", 0) \
     M(UInt64, extract_kvp_max_pairs_per_row, 1000, "Max number pairs that can be produced by extractKeyValuePairs function. Used to safeguard against consuming too much memory.", 0) \
-    M(Timezone, session_timezone, "", "The default timezone for current session or query. The server default timezone, if empty.", 0) \
+    M(Timezone, session_timezone, "", "The default timezone for current session or query. The server default timezone if empty.", 0) \
     // End of COMMON_SETTINGS
     // Please add settings related to formats into the FORMAT_FACTORY_SETTINGS and move obsolete settings to OBSOLETE_SETTINGS.
 

From 369ad0aea397612a823f28b7aeb3ac72583066f8 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 22 Jun 2023 20:32:29 +0200
Subject: [PATCH 688/722] Remove ALTER of LIVE VIEW

---
 src/Interpreters/InterpreterAlterQuery.cpp | 24 +-------
 src/Storages/LiveView/LiveViewCommands.h   | 65 ----------------------
 2 files changed, 1 insertion(+), 88 deletions(-)
 delete mode 100644 src/Storages/LiveView/LiveViewCommands.h

diff --git a/src/Interpreters/InterpreterAlterQuery.cpp b/src/Interpreters/InterpreterAlterQuery.cpp
index ec2145b38bf..e82415f1aca 100644
--- a/src/Interpreters/InterpreterAlterQuery.cpp
+++ b/src/Interpreters/InterpreterAlterQuery.cpp
@@ -18,8 +18,6 @@
 #include <Parsers/queryToString.h>
 #include <Storages/AlterCommands.h>
 #include <Storages/IStorage.h>
-#include <Storages/LiveView/LiveViewCommands.h>
-#include <Storages/LiveView/StorageLiveView.h>
 #include <Storages/MutationCommands.h>
 #include <Storages/PartitionCommands.h>
 #include <Storages/StorageKeeperMap.h>
@@ -117,7 +115,6 @@ BlockIO InterpreterAlterQuery::executeToTable(const ASTAlterQuery & alter)
     AlterCommands alter_commands;
     PartitionCommands partition_commands;
     MutationCommands mutation_commands;
-    LiveViewCommands live_view_commands;
     for (const auto & child : alter.command_list->children)
     {
         auto * command_ast = child->as<ASTAlterCommand>();
@@ -137,17 +134,13 @@ BlockIO InterpreterAlterQuery::executeToTable(const ASTAlterQuery & alter)
 
             mutation_commands.emplace_back(std::move(*mut_command));
         }
-        else if (auto live_view_command = LiveViewCommand::parse(command_ast))
-        {
-            live_view_commands.emplace_back(std::move(*live_view_command));
-        }
         else
             throw Exception(ErrorCodes::LOGICAL_ERROR, "Wrong parameter type in ALTER query");
     }
 
     if (typeid_cast<DatabaseReplicated *>(database.get()))
     {
-        int command_types_count = !mutation_commands.empty() + !partition_commands.empty() + !live_view_commands.empty() + !alter_commands.empty();
+        int command_types_count = !mutation_commands.empty() + !partition_commands.empty() + !alter_commands.empty();
         bool mixed_settings_amd_metadata_alter = alter_commands.hasSettingsAlterCommand() && !alter_commands.isSettingsAlter();
         if (1 < command_types_count || mixed_settings_amd_metadata_alter)
             throw Exception(ErrorCodes::NOT_IMPLEMENTED, "For Replicated databases it's not allowed "
@@ -170,21 +163,6 @@ BlockIO InterpreterAlterQuery::executeToTable(const ASTAlterQuery & alter)
             res.pipeline = QueryPipeline(std::move(partition_commands_pipe));
     }
 
-    if (!live_view_commands.empty())
-    {
-        live_view_commands.validate(*table);
-        for (const LiveViewCommand & command : live_view_commands)
-        {
-            auto live_view = std::dynamic_pointer_cast<StorageLiveView>(table);
-            switch (command.type)
-            {
-                case LiveViewCommand::REFRESH:
-                    live_view->refresh();
-                    break;
-            }
-        }
-    }
-
     if (!alter_commands.empty())
     {
         auto alter_lock = table->lockForAlter(getContext()->getSettingsRef().lock_acquire_timeout);
diff --git a/src/Storages/LiveView/LiveViewCommands.h b/src/Storages/LiveView/LiveViewCommands.h
deleted file mode 100644
index 2bb2dfb2752..00000000000
--- a/src/Storages/LiveView/LiveViewCommands.h
+++ /dev/null
@@ -1,65 +0,0 @@
-#pragma once
-/* Copyright (c) 2018 BlackBerry Limited
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License. */
-
-#include <optional>
-#include <Parsers/ASTAlterQuery.h>
-#include <Storages/LiveView/StorageLiveView.h>
-
-
-namespace DB
-{
-
-namespace ErrorCodes
-{
-    extern const int UNKNOWN_STORAGE;
-}
-
-struct LiveViewCommand
-{
-    enum Type
-    {
-        REFRESH
-    };
-
-    Type type;
-
-    ASTPtr values;
-
-    static LiveViewCommand refresh(const ASTPtr & values)
-    {
-        LiveViewCommand res;
-        res.type = REFRESH;
-        res.values = values;
-        return res;
-    }
-
-    static std::optional<LiveViewCommand> parse(ASTAlterCommand * command)
-    {
-        if (command->type == ASTAlterCommand::LIVE_VIEW_REFRESH)
-            return refresh(command->values);
-        return {};
-    }
-};
-
-
-class LiveViewCommands : public std::vector<LiveViewCommand>
-{
-public:
-    void validate(const IStorage & table)
-    {
-        if (!empty() && !dynamic_cast<const StorageLiveView *>(&table))
-            throw Exception(DB::ErrorCodes::UNKNOWN_STORAGE, "Wrong storage type. Must be StorageLiveView");
-    }
-};
-
-}

From 2b01711565e919baa39cd6e68ca42481cea6fdb6 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <Sema.Checherinda@clickhouse.com>
Date: Thu, 22 Jun 2023 19:59:33 +0200
Subject: [PATCH 689/722] fix assert in test, revert debug message

---
 src/IO/Lz4DeflatingWriteBuffer.cpp                     | 10 ++--------
 .../test_checking_s3_blobs_paranoid/test.py            |  4 ++--
 2 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/src/IO/Lz4DeflatingWriteBuffer.cpp b/src/IO/Lz4DeflatingWriteBuffer.cpp
index 35feafbc736..27c945f92cf 100644
--- a/src/IO/Lz4DeflatingWriteBuffer.cpp
+++ b/src/IO/Lz4DeflatingWriteBuffer.cpp
@@ -104,14 +104,8 @@ void Lz4DeflatingWriteBuffer::nextImpl()
             if (LZ4F_isError(compressed_size))
                 throw Exception(
                     ErrorCodes::LZ4_ENCODER_FAILED,
-                    "LZ4 failed to encode stream. LZ4F version: {}, CodeName: {},"
-                    " in_capacity: {}, out_capacity: {}, cur_buffer_size: {}, min_compressed_block_size: {}",
-                    LZ4F_VERSION,
-                    LZ4F_getErrorName(compressed_size),
-                    in_capacity,
-                    out_capacity,
-                    cur_buffer_size,
-                    min_compressed_block_size);
+                    "LZ4 failed to encode stream. LZ4F version: {}",
+                    LZ4F_VERSION);
 
             in_capacity -= cur_buffer_size;
             in_data = reinterpret_cast<void *>(working_buffer.end() - in_capacity);
diff --git a/tests/integration/test_checking_s3_blobs_paranoid/test.py b/tests/integration/test_checking_s3_blobs_paranoid/test.py
index 244ca8a2c81..43a313f07dc 100644
--- a/tests/integration/test_checking_s3_blobs_paranoid/test.py
+++ b/tests/integration/test_checking_s3_blobs_paranoid/test.py
@@ -165,5 +165,5 @@ def test_upload_s3_fail_upload_part_when_multi_part_upload(
     assert count_create_multi_part_uploads == 1
     assert count_upload_parts >= 2
     assert (
-        count_s3_errors == 2
-    )  # the second is cancel multipart upload, s3_mock just redirects this request
+        count_s3_errors >= 2
+    )

From 506d52358a1262932df6d41f4dc97503c697038f Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 22 Jun 2023 20:52:50 +0000
Subject: [PATCH 690/722] Query Cache: Remove confusing defaults in server cfg

---
 programs/server/config.xml | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/programs/server/config.xml b/programs/server/config.xml
index d18b4cb2ac9..50db5fc4af6 100644
--- a/programs/server/config.xml
+++ b/programs/server/config.xml
@@ -1542,14 +1542,6 @@
     </rocksdb>
     -->
 
-    <!-- Configuration for the query cache -->
-    <!-- <query_cache> -->
-    <!--     <max_size_in_bytes>1073741824</max_size_in_bytes> -->
-    <!--     <max_entries>1024</max_entries> -->
-    <!--     <max_entry_size_in_bytes>1048576</max_entry_size_in_bytes> -->
-    <!--     <max_entry_size_in_rows>30000000</max_entry_size_in_rows> -->
-    <!-- </query_cache> -->
-
     <!-- Uncomment if enable merge tree metadata cache -->
     <!--merge_tree_metadata_cache>
         <lru_cache_size>268435456</lru_cache_size>

From b6e7f4cf6cd1d0cf5e5aac209a6e962f00bfcf0b Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 22 Jun 2023 23:24:27 +0200
Subject: [PATCH 691/722] Require more checks

---
 tests/ci/ci_config.py            | 93 ++++++++++++++++++++++++++++++++
 tests/ci/commit_status_helper.py |  2 -
 2 files changed, 93 insertions(+), 2 deletions(-)

diff --git a/tests/ci/ci_config.py b/tests/ci/ci_config.py
index d829115cfe1..c680b5810fc 100644
--- a/tests/ci/ci_config.py
+++ b/tests/ci/ci_config.py
@@ -410,6 +410,99 @@ REQUIRED_CHECKS = [
     "Fast test",
     "Stateful tests (release)",
     "Stateless tests (release)",
+    "Stateless tests (debug) [1/5]",
+    "Stateless tests (debug) [2/5]",
+    "Stateless tests (debug) [3/5]",
+    "Stateless tests (debug) [4/5]",
+    "Stateless tests (debug) [5/5]",
+    "AST fuzzer (asan)",
+    "AST fuzzer (msan)",
+    "AST fuzzer (tsan)",
+    "AST fuzzer (ubsan)",
+    "AST fuzzer (debug)",
+    "Compatibility check (aarch64)",
+    "Compatibility check (amd64)",
+    "Install packages (amd64)",
+    "Install packages (arm64)",
+    "Integration tests (asan) [1/6]",
+    "Integration tests (asan) [2/6]",
+    "Integration tests (asan) [3/6]",
+    "Integration tests (asan) [4/6]",
+    "Integration tests (asan) [5/6]",
+    "Integration tests (asan) [6/6]",
+    "Integration tests (release) [1/4]",
+    "Integration tests (release) [2/4]",
+    "Integration tests (release) [3/4]",
+    "Integration tests (release) [4/4]",
+    "Integration tests (tsan) [1/6]",
+    "Integration tests (tsan) [2/6]",
+    "Integration tests (tsan) [3/6]",
+    "Integration tests (tsan) [4/6]",
+    "Integration tests (tsan) [5/6]",
+    "Integration tests (tsan) [6/6]",
+    "Integration tests flaky check (asan)",
+    "Stateful tests (aarch64)",
+    "Stateful tests (asan)",
+    "Stateful tests (asan, ParallelReplicas)",
+    "Stateful tests (debug)",
+    "Stateful tests (debug, ParallelReplicas)",
+    "Stateful tests (msan)",
+    "Stateful tests (msan, ParallelReplicas)",
+    "Stateful tests (release, ParallelReplicas)",
+    "Stateful tests (tsan)",
+    "Stateful tests (tsan, ParallelReplicas)",
+    "Stateful tests (ubsan)",
+    "Stateful tests (ubsan, ParallelReplicas)",
+    "Stateless tests (aarch64)",
+    "Stateless tests (asan) [1/4]",
+    "Stateless tests (asan) [2/4]",
+    "Stateless tests (asan) [3/4]",
+    "Stateless tests (asan) [4/4]",
+    "Stateless tests (debug) [1/5]",
+    "Stateless tests (debug) [2/5]",
+    "Stateless tests (debug) [3/5]",
+    "Stateless tests (debug) [4/5]",
+    "Stateless tests (debug) [5/5]",
+    "Stateless tests (debug, s3 storage) [1/6]",
+    "Stateless tests (debug, s3 storage) [2/6]",
+    "Stateless tests (debug, s3 storage) [3/6]",
+    "Stateless tests (debug, s3 storage) [4/6]",
+    "Stateless tests (debug, s3 storage) [5/6]",
+    "Stateless tests (debug, s3 storage) [6/6]",
+    "Stateless tests (msan) [1/6]",
+    "Stateless tests (msan) [2/6]",
+    "Stateless tests (msan) [3/6]",
+    "Stateless tests (msan) [4/6]",
+    "Stateless tests (msan) [5/6]",
+    "Stateless tests (msan) [6/6]",
+    "Stateless tests (release, DatabaseReplicated) [1/4]",
+    "Stateless tests (release, DatabaseReplicated) [2/4]",
+    "Stateless tests (release, DatabaseReplicated) [3/4]",
+    "Stateless tests (release, DatabaseReplicated) [4/4]",
+    "Stateless tests (release, s3 storage) [1/2]",
+    "Stateless tests (release, s3 storage) [2/2]",
+    "Stateless tests (release, wide parts enabled)",
+    "Stateless tests (tsan) [1/5]",
+    "Stateless tests (tsan) [2/5]",
+    "Stateless tests (tsan) [3/5]",
+    "Stateless tests (tsan) [4/5]",
+    "Stateless tests (tsan) [5/5]",
+    "Stateless tests (tsan, s3 storage) [1/5]",
+    "Stateless tests (tsan, s3 storage) [2/5]",
+    "Stateless tests (tsan, s3 storage) [3/5]",
+    "Stateless tests (tsan, s3 storage) [4/5]",
+    "Stateless tests (tsan, s3 storage) [5/5]",
+    "Stateless tests (ubsan) [1/2]",
+    "Stateless tests (ubsan) [2/2]",
+    "Stress test (asan)",
+    "Stress test (debug)",
+    "Stress test (msan)",
+    "Stress test (tsan)",
+    "Stress test (ubsan)",
+    "Upgrade check (asan)",
+    "Upgrade check (debug)",
+    "Upgrade check (msan)",
+    "Upgrade check (tsan)",
     "Style Check",
     "Unit tests (asan)",
     "Unit tests (msan)",
diff --git a/tests/ci/commit_status_helper.py b/tests/ci/commit_status_helper.py
index 8731f8280e2..4437ddc52c6 100644
--- a/tests/ci/commit_status_helper.py
+++ b/tests/ci/commit_status_helper.py
@@ -369,8 +369,6 @@ def update_mergeable_check(gh: Github, pr_info: PRInfo, check_name: str) -> None
 
     if fail:
         description = "failed: " + ", ".join(fail)
-        if success:
-            description += "; succeeded: " + ", ".join(success)
         description = format_description(description)
         if mergeable_status is None or mergeable_status.description != description:
             set_mergeable_check(commit, description, "failure")

From bfb2debca9416cfed02f9b1349e93afdf2f2a323 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Thu, 22 Jun 2023 21:31:05 +0000
Subject: [PATCH 692/722] Restore settings

---
 programs/server/config.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/programs/server/config.xml b/programs/server/config.xml
index 50db5fc4af6..2f69f23a718 100644
--- a/programs/server/config.xml
+++ b/programs/server/config.xml
@@ -1542,6 +1542,14 @@
     </rocksdb>
     -->
 
+    <!-- Configuration for the query cache -->
+    <query_cache>
+        <max_size_in_bytes>1073741824</max_size_in_bytes>
+        <max_entries>1024</max_entries>
+        <max_entry_size_in_bytes>1048576</max_entry_size_in_bytes>
+        <max_entry_size_in_rows>30000000</max_entry_size_in_rows>
+    </query_cache>
+
     <!-- Uncomment if enable merge tree metadata cache -->
     <!--merge_tree_metadata_cache>
         <lru_cache_size>268435456</lru_cache_size>

From b5b2a2a41a6672488ac19b904b0b13b4df0617fe Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 22 Jun 2023 23:57:37 +0200
Subject: [PATCH 693/722] Fix "metadata loading" test

---
 src/Storages/MergeTree/MergeTreeData.cpp            |  2 +-
 tests/queries/0_stateless/01193_metadata_loading.sh | 11 +++--------
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeData.cpp b/src/Storages/MergeTree/MergeTreeData.cpp
index c3ffb892871..d2f64a406a7 100644
--- a/src/Storages/MergeTree/MergeTreeData.cpp
+++ b/src/Storages/MergeTree/MergeTreeData.cpp
@@ -1453,7 +1453,7 @@ std::vector<MergeTreeData::LoadPartResult> MergeTreeData::loadDataPartsFromDisk(
 {
     const size_t num_parts = parts_to_load.size();
 
-    LOG_DEBUG(log, "Will load {} number of parts using {} threads", num_parts, getActivePartsLoadingThreadPool().get().getMaxThreads());
+    LOG_TRACE(log, "Will load {} parts using up to {} threads", num_parts, getActivePartsLoadingThreadPool().get().getMaxThreads());
 
     /// Shuffle all the parts randomly to possible speed up loading them from JBOD.
     std::shuffle(parts_to_load.begin(), parts_to_load.end(), thread_local_rng);
diff --git a/tests/queries/0_stateless/01193_metadata_loading.sh b/tests/queries/0_stateless/01193_metadata_loading.sh
index d0f3001fceb..b96832e8b00 100755
--- a/tests/queries/0_stateless/01193_metadata_loading.sh
+++ b/tests/queries/0_stateless/01193_metadata_loading.sh
@@ -11,12 +11,7 @@ db="test_01193_$RANDOM"
 tables=1000
 threads=10
 count_multiplier=1
-max_time_ms=1000
-
-# In case of s390x, the query execution time seems to be approximately ~1.1 to ~1.2 secs. So, to match the query execution time, set max_time_ms=1500
-if [[ $(uname -a | grep s390x) ]]; then
-    max_time_ms=1500
-fi
+max_time_ms=5000
 
 debug_or_sanitizer_build=$($CLICKHOUSE_CLIENT -q "WITH ((SELECT value FROM system.build_options WHERE name='BUILD_TYPE') AS build, (SELECT value FROM system.build_options WHERE name='CXX_FLAGS') as flags) SELECT build='Debug' OR flags LIKE '%fsanitize%' OR hasThreadFuzzer()")
 
@@ -46,13 +41,13 @@ wait
 $CLICKHOUSE_CLIENT -q "CREATE TABLE $db.table_merge (i UInt64, d Date, s String, n Nested(i UInt8, f Float32)) ENGINE=Merge('$db', '^table_')"
 $CLICKHOUSE_CLIENT -q "SELECT count() * $count_multiplier, i, d, s, n.i, n.f FROM merge('$db', '^table_9') GROUP BY i, d, s, n.i, n.f ORDER BY i"
 
-for i in {1..5}; do
+for i in {1..10}; do
   $CLICKHOUSE_CLIENT -q "DETACH DATABASE $db"
   $CLICKHOUSE_CLIENT -q "ATTACH DATABASE $db" --query_id="$db-$i";
 done
 
 $CLICKHOUSE_CLIENT -q "SYSTEM FLUSH LOGS"
-$CLICKHOUSE_CLIENT -q "SELECT if(quantile(0.5)(query_duration_ms) < $max_time_ms, 'ok', toString(groupArray(query_duration_ms))) FROM system.query_log WHERE current_database = currentDatabase() AND query_id LIKE '$db-%' AND type=2"
+$CLICKHOUSE_CLIENT -q "SELECT if(min(query_duration_ms) < $max_time_ms, 'ok', toString(groupArray(query_duration_ms))) FROM system.query_log WHERE current_database = currentDatabase() AND query_id LIKE '$db-%' AND type=2"
 
 $CLICKHOUSE_CLIENT -q "SELECT count() * $count_multiplier, i, d, s, n.i, n.f FROM $db.table_merge GROUP BY i, d, s, n.i, n.f ORDER BY i"
 

From 9e433cee200d149b7c752238bf26235e3314012c Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Thu, 22 Jun 2023 23:58:55 +0200
Subject: [PATCH 694/722] Add comment

---
 tests/queries/0_stateless/01193_metadata_loading.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/queries/0_stateless/01193_metadata_loading.sh b/tests/queries/0_stateless/01193_metadata_loading.sh
index b96832e8b00..63fcf8eb93b 100755
--- a/tests/queries/0_stateless/01193_metadata_loading.sh
+++ b/tests/queries/0_stateless/01193_metadata_loading.sh
@@ -5,6 +5,7 @@ CURDIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
 # shellcheck source=../shell_config.sh
 . "$CURDIR"/../shell_config.sh
 
+# Check that attaching a database with a large number of tables is not too slow.
 # it is the worst way of making performance test, nevertheless it can detect significant slowdown and some other issues, that usually found by stress test
 
 db="test_01193_$RANDOM"

From 241d711264fc67b620a36fec3427bfb83215a69b Mon Sep 17 00:00:00 2001
From: Anton Popov <anton@clickhouse.com>
Date: Thu, 22 Jun 2023 22:03:40 +0000
Subject: [PATCH 695/722] better expception message

---
 src/Storages/MergeTree/IMergeTreeReader.cpp            | 10 +++++++---
 .../MergeTree/ReplicatedMergeTreePartCheckThread.cpp   |  7 ++++---
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/src/Storages/MergeTree/IMergeTreeReader.cpp b/src/Storages/MergeTree/IMergeTreeReader.cpp
index d93e88fdeb2..f9b97a6a05d 100644
--- a/src/Storages/MergeTree/IMergeTreeReader.cpp
+++ b/src/Storages/MergeTree/IMergeTreeReader.cpp
@@ -280,11 +280,15 @@ void IMergeTreeReader::checkNumberOfColumns(size_t num_columns_to_read) const
 
 String IMergeTreeReader::getMessageForDiagnosticOfBrokenPart(size_t from_mark, size_t max_rows_to_read) const
 {
+    const auto & data_part_storage = data_part_info_for_read->getDataPartStorage();
     return fmt::format(
-        "(while reading from part {} in table {} from mark {} with max_rows_to_read = {})",
-        data_part_info_for_read->getDataPartStorage()->getFullPath(),
+        "(while reading from part {} in table {} located on disk {} of type {}, from mark {} with max_rows_to_read = {})",
+        data_part_storage->getFullPath(),
         data_part_info_for_read->getTableName(),
-        from_mark, max_rows_to_read);
+        data_part_storage->getDiskName(),
+        data_part_storage->getDiskType(),
+        from_mark,
+        max_rows_to_read);
 }
 
 }
diff --git a/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp b/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
index 43256505135..c495fdaf5e2 100644
--- a/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
+++ b/src/Storages/MergeTree/ReplicatedMergeTreePartCheckThread.cpp
@@ -419,9 +419,10 @@ CheckResult ReplicatedMergeTreePartCheckThread::checkPart(const String & part_na
             }
             catch (const Exception & e)
             {
-                /// Don't count the part as broken if there is not enough memory to load it.
-                /// In fact, there can be many similar situations.
-                /// But it is OK, because there is a safety guard against deleting too many parts.
+                /// Don't count the part as broken if we got known retryable exception.
+                /// In fact, there can be other similar situations because not all
+                /// of the exceptions are classified as retryable/non-retryable. But it is OK,
+                /// because there is a safety guard against deleting too many parts.
                 if (isRetryableException(e))
                     throw;
 

From f14391faaa387de989292bb674b71602a88d3067 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 00:06:27 +0200
Subject: [PATCH 696/722] Change log level

---
 src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
index c4473ec96cf..b569fa73a73 100644
--- a/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
+++ b/src/Storages/MergeTree/MergeTreeBackgroundExecutor.cpp
@@ -151,9 +151,9 @@ void printExceptionWithRespectToAbort(Poco::Logger * log)
     {
         NOEXCEPT_SCOPE({
             ALLOW_ALLOCATIONS_IN_SCOPE;
-            /// Cancelled merging parts is not an error - log as info.
+            /// Cancelled merging parts is not an error - log normally.
             if (e.code() == ErrorCodes::ABORTED)
-                LOG_INFO(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
+                LOG_DEBUG(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ false));
             else
                 tryLogCurrentException(__PRETTY_FUNCTION__);
         });

From 97fc6fcc2c7dbd7a27ec94366ab9d7a8ffb26927 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Thu, 22 Jun 2023 18:14:45 -0400
Subject: [PATCH 697/722] update nav

---
 docs/en/operations/optimizing-performance/index.md | 9 ---------
 1 file changed, 9 deletions(-)
 delete mode 100644 docs/en/operations/optimizing-performance/index.md

diff --git a/docs/en/operations/optimizing-performance/index.md b/docs/en/operations/optimizing-performance/index.md
deleted file mode 100644
index 83e9430ed27..00000000000
--- a/docs/en/operations/optimizing-performance/index.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-slug: /en/operations/optimizing-performance/
-sidebar_label: Optimizing Performance
-sidebar_position: 52
----
-
-# Optimizing Performance
-
-- [Sampling query profiler](../../operations/optimizing-performance/sampling-query-profiler.md)

From 550784e6a0721f1fbf25128ca555277ab290a29b Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 01:08:51 +0200
Subject: [PATCH 698/722] Support clang-17

---
 src/Interpreters/Cache/FileCache.cpp | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/Interpreters/Cache/FileCache.cpp b/src/Interpreters/Cache/FileCache.cpp
index 17d2c332887..b601c4029f3 100644
--- a/src/Interpreters/Cache/FileCache.cpp
+++ b/src/Interpreters/Cache/FileCache.cpp
@@ -703,21 +703,21 @@ bool FileCache::tryReserve(FileSegment & file_segment, const size_t size)
                                       &freeable_count,
                                       &file_segment,
                                       &cache_lock,
-                                      main_priority = this->main_priority.get(),
-                                      log = this->log]
+                                      my_main_priority = this->main_priority.get(),
+                                      my_log = this->log]
     {
         const bool is_overflow =
             /// size_limit == 0 means unlimited cache size
-            (main_priority_size_limit != 0 && (main_priority->getSize(cache_lock) + size - freeable_space > main_priority_size_limit))
+            (main_priority_size_limit != 0 && (my_main_priority->getSize(cache_lock) + size - freeable_space > main_priority_size_limit))
             /// elements_limit == 0 means unlimited number of cache elements
             || (main_priority_elements_limit != 0 && freeable_count == 0
-                && main_priority->getElementsCount(cache_lock) == main_priority_elements_limit);
+                && my_main_priority->getElementsCount(cache_lock) == main_priority_elements_limit);
 
         LOG_TEST(
-            log, "Overflow: {}, size: {}, ready to remove: {} ({} in number), current cache size: {}/{}, elements: {}/{}, while reserving for {}:{}",
+            my_log, "Overflow: {}, size: {}, ready to remove: {} ({} in number), current cache size: {}/{}, elements: {}/{}, while reserving for {}:{}",
             is_overflow, size, freeable_space, freeable_count,
-            main_priority->getSize(cache_lock), main_priority->getSizeLimit(),
-            main_priority->getElementsCount(cache_lock), main_priority->getElementsLimit(),
+            my_main_priority->getSize(cache_lock), my_main_priority->getSizeLimit(),
+            my_main_priority->getElementsCount(cache_lock), my_main_priority->getElementsLimit(),
             file_segment.key(), file_segment.offset());
 
         return is_overflow;

From c958a1a77bcf9ef0ffeaf566665b42b5f19388d5 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 01:23:25 +0200
Subject: [PATCH 699/722] Fix fuzzer failure in ActionsDAG

---
 src/Interpreters/ActionsDAG.cpp               | 31 +++++++++++++------
 ...edicate_pushdown_different_types.reference |  0
 ...791_predicate_pushdown_different_types.sql |  7 +++++
 3 files changed, 28 insertions(+), 10 deletions(-)
 create mode 100644 tests/queries/0_stateless/02791_predicate_pushdown_different_types.reference
 create mode 100644 tests/queries/0_stateless/02791_predicate_pushdown_different_types.sql

diff --git a/src/Interpreters/ActionsDAG.cpp b/src/Interpreters/ActionsDAG.cpp
index 94bdca60e69..906875dd314 100644
--- a/src/Interpreters/ActionsDAG.cpp
+++ b/src/Interpreters/ActionsDAG.cpp
@@ -1876,10 +1876,10 @@ struct ConjunctionNodes
     ActionsDAG::NodeRawConstPtrs rejected;
 };
 
-/// Take a node which result is predicate.
+/// Take a node which result is a predicate.
 /// Assuming predicate is a conjunction (probably, trivial).
 /// Find separate conjunctions nodes. Split nodes into allowed and rejected sets.
-/// Allowed predicate is a predicate which can be calculated using only nodes from allowed_nodes set.
+/// Allowed predicate is a predicate which can be calculated using only nodes from the allowed_nodes set.
 ConjunctionNodes getConjunctionNodes(ActionsDAG::Node * predicate, std::unordered_set<const ActionsDAG::Node *> allowed_nodes)
 {
     ConjunctionNodes conjunction;
@@ -2113,9 +2113,9 @@ ActionsDAGPtr ActionsDAG::cloneActionsForFilterPushDown(
     Node * predicate = const_cast<Node *>(tryFindInOutputs(filter_name));
     if (!predicate)
         throw Exception(ErrorCodes::LOGICAL_ERROR,
-                "Output nodes for ActionsDAG do not contain filter column name {}. DAG:\n{}",
-                filter_name,
-                dumpDAG());
+            "Output nodes for ActionsDAG do not contain filter column name {}. DAG:\n{}",
+            filter_name,
+            dumpDAG());
 
     /// If condition is constant let's do nothing.
     /// It means there is nothing to push down or optimization was already applied.
@@ -2142,18 +2142,29 @@ ActionsDAGPtr ActionsDAG::cloneActionsForFilterPushDown(
     }
 
     auto conjunction = getConjunctionNodes(predicate, allowed_nodes);
-    if (conjunction.rejected.size() == 1 && !conjunction.rejected.front()->result_type->equals(*predicate->result_type)
-        && conjunction.allowed.front()->type == ActionType::COLUMN)
-    {
-        // No further optimization can be done
+
+    if (conjunction.allowed.empty())
         return nullptr;
+
+    chassert(predicate->result_type);
+
+    if (conjunction.rejected.size() == 1)
+    {
+        chassert(conjunction.rejected.front()->result_type);
+
+        if (conjunction.allowed.front()->type == ActionType::COLUMN
+            && !conjunction.rejected.front()->result_type->equals(*predicate->result_type))
+        {
+            /// No further optimization can be done
+            return nullptr;
+        }
     }
 
     auto actions = cloneActionsForConjunction(conjunction.allowed, all_inputs);
     if (!actions)
         return nullptr;
 
-    /// Now, when actions are created, update current DAG.
+    /// Now, when actions are created, update the current DAG.
 
     if (conjunction.rejected.empty())
     {
diff --git a/tests/queries/0_stateless/02791_predicate_pushdown_different_types.reference b/tests/queries/0_stateless/02791_predicate_pushdown_different_types.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02791_predicate_pushdown_different_types.sql b/tests/queries/0_stateless/02791_predicate_pushdown_different_types.sql
new file mode 100644
index 00000000000..121ffb27e9b
--- /dev/null
+++ b/tests/queries/0_stateless/02791_predicate_pushdown_different_types.sql
@@ -0,0 +1,7 @@
+# These queries triggered a crash in old ClickHouse versions:
+
+CREATE TEMPORARY TABLE a (key UInt32, ID LowCardinality(String));
+CREATE TEMPORARY TABLE b (key UInt32);
+SELECT * FROM b JOIN a USING (key) WHERE ID = '1' HAVING ID = '1';
+
+# PS. Predicate pushdown does not work for LowCardinality(String), but it's another problem.

From a996c2b27d1f176eb1ac173c5dec531d5fc64595 Mon Sep 17 00:00:00 2001
From: Sema Checherinda <104093494+CheSema@users.noreply.github.com>
Date: Fri, 23 Jun 2023 07:59:40 +0200
Subject: [PATCH 700/722] Update test.py

---
 tests/integration/test_checking_s3_blobs_paranoid/test.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/tests/integration/test_checking_s3_blobs_paranoid/test.py b/tests/integration/test_checking_s3_blobs_paranoid/test.py
index 43a313f07dc..a80ad93d53d 100644
--- a/tests/integration/test_checking_s3_blobs_paranoid/test.py
+++ b/tests/integration/test_checking_s3_blobs_paranoid/test.py
@@ -164,6 +164,4 @@ def test_upload_s3_fail_upload_part_when_multi_part_upload(
     )
     assert count_create_multi_part_uploads == 1
     assert count_upload_parts >= 2
-    assert (
-        count_s3_errors >= 2
-    )
+    assert count_s3_errors >= 2

From db69c876214d4d53a876f95e71ff0a1e37cab5b7 Mon Sep 17 00:00:00 2001
From: Kseniia Sumarokova <54203879+kssenii@users.noreply.github.com>
Date: Fri, 23 Jun 2023 12:01:22 +0200
Subject: [PATCH 701/722] Remove test

---
 tests/integration/test_merge_tree_s3/test.py | 78 --------------------
 1 file changed, 78 deletions(-)

diff --git a/tests/integration/test_merge_tree_s3/test.py b/tests/integration/test_merge_tree_s3/test.py
index 3ab31f4728b..444fa38cdaf 100644
--- a/tests/integration/test_merge_tree_s3/test.py
+++ b/tests/integration/test_merge_tree_s3/test.py
@@ -740,84 +740,6 @@ def test_cache_with_full_disk_space(cluster, node_name):
     check_no_objects_after_drop(cluster, node_name=node_name)
 
 
-@pytest.mark.parametrize("node_name", ["node"])
-def test_cache_setting_compatibility(cluster, node_name):
-    node = cluster.instances[node_name]
-
-    node.query("DROP TABLE IF EXISTS s3_test SYNC")
-
-    node.query(
-        "CREATE TABLE s3_test (key UInt32, value String) Engine=MergeTree() ORDER BY key SETTINGS storage_policy='s3_cache_r', compress_marks=false, compress_primary_key=false;"
-    )
-    node.query(
-        "INSERT INTO s3_test SELECT * FROM generateRandom('key UInt32, value String') LIMIT 500"
-    )
-
-    result = node.query("SYSTEM DROP FILESYSTEM CACHE")
-
-    result = node.query(
-        "SELECT count() FROM system.filesystem_cache WHERE cache_path LIKE '%persistent'"
-    )
-    assert int(result) == 0
-
-    node.query("SELECT * FROM s3_test")
-
-    result = node.query(
-        "SELECT count() FROM system.filesystem_cache WHERE cache_path LIKE '%persistent'"
-    )
-    assert int(result) > 0
-
-    config_path = os.path.join(
-        SCRIPT_DIR,
-        f"./{cluster.instances_dir_name}/node/configs/config.d/storage_conf.xml",
-    )
-
-    replace_config(
-        config_path,
-        "<do_not_evict_index_and_mark_files>1</do_not_evict_index_and_mark_files>",
-        "<do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>",
-    )
-
-    result = node.query("DESCRIBE FILESYSTEM CACHE 's3_cache_r'")
-    assert result.strip().endswith("1")
-
-    node.restart_clickhouse()
-
-    result = node.query("DESCRIBE FILESYSTEM CACHE 's3_cache_r'")
-    assert result.strip().endswith("0")
-
-    result = node.query(
-        "SELECT count() FROM system.filesystem_cache WHERE cache_path LIKE '%persistent'"
-    )
-    assert int(result) > 0
-
-    node.query("SELECT * FROM s3_test FORMAT Null")
-
-    assert not node.contains_in_log("No such file or directory: Cache info:")
-
-    replace_config(
-        config_path,
-        "<do_not_evict_index_and_mark_files>0</do_not_evict_index_and_mark_files>",
-        "<do_not_evict_index_and_mark_files>1</do_not_evict_index_and_mark_files>",
-    )
-
-    result = node.query(
-        "SELECT count() FROM system.filesystem_cache WHERE cache_path LIKE '%persistent'"
-    )
-    assert int(result) > 0
-
-    node.restart_clickhouse()
-
-    result = node.query("DESCRIBE FILESYSTEM CACHE 's3_cache_r'")
-    assert result.strip().endswith("1")
-
-    node.query("SELECT * FROM s3_test FORMAT Null")
-
-    assert not node.contains_in_log("No such file or directory: Cache info:")
-
-    check_no_objects_after_drop(cluster)
-
-
 @pytest.mark.parametrize("node_name", ["node"])
 def test_merge_canceled_by_drop(cluster, node_name):
     node = cluster.instances[node_name]

From 1ec53049578e53ce44c5c7173dbaafbb270d194d Mon Sep 17 00:00:00 2001
From: Vitaly Baranov <vitlibar@yandex.ru>
Date: Fri, 23 Jun 2023 12:11:18 +0200
Subject: [PATCH 702/722] Fix multiple writing of same file to backup (#51299)

* Fix writing the same file multiple times to backup.

* Add test.

---------

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 src/Backups/BackupCoordinationRemote.cpp      | 25 +++++++--
 src/Backups/BackupCoordinationRemote.h        |  2 +
 .../test_backup_restore_on_cluster/test.py    | 53 +++++++++++++++++++
 3 files changed, 76 insertions(+), 4 deletions(-)

diff --git a/src/Backups/BackupCoordinationRemote.cpp b/src/Backups/BackupCoordinationRemote.cpp
index 4cd06061e1b..214873fb765 100644
--- a/src/Backups/BackupCoordinationRemote.cpp
+++ b/src/Backups/BackupCoordinationRemote.cpp
@@ -721,7 +721,15 @@ void BackupCoordinationRemote::prepareFileInfos() const
 
 bool BackupCoordinationRemote::startWritingFile(size_t data_file_index)
 {
-    bool acquired_writing = false;
+    {
+        /// Check if this host is already writing this file.
+        std::lock_guard lock{writing_files_mutex};
+        if (writing_files.contains(data_file_index))
+            return false;
+    }
+
+    /// Store in Zookeeper that this host is the only host which is allowed to write this file.
+    bool host_is_assigned = false;
     String full_path = zookeeper_path + "/writing_files/" + std::to_string(data_file_index);
     String host_index_str = std::to_string(current_host_index);
 
@@ -733,14 +741,23 @@ bool BackupCoordinationRemote::startWritingFile(size_t data_file_index)
         auto code = zk->tryCreate(full_path, host_index_str, zkutil::CreateMode::Persistent);
 
         if (code == Coordination::Error::ZOK)
-            acquired_writing = true; /// If we've just created this ZooKeeper's node, the writing is acquired, i.e. we should write this data file.
+            host_is_assigned = true; /// If we've just created this ZooKeeper's node, this host is assigned.
         else if (code == Coordination::Error::ZNODEEXISTS)
-            acquired_writing = (zk->get(full_path) == host_index_str); /// The previous retry could write this ZooKeeper's node and then fail.
+            host_is_assigned = (zk->get(full_path) == host_index_str); /// The previous retry could write this ZooKeeper's node and then fail.
         else
             throw zkutil::KeeperException(code, full_path);
     });
 
-    return acquired_writing;
+    if (!host_is_assigned)
+        return false; /// Other host is writing this file.
+
+    {
+        /// Check if this host is already writing this file,
+        /// and if it's not, mark that this host is writing this file.
+        /// We have to check that again because we were accessing ZooKeeper with the mutex unlocked.
+        std::lock_guard lock{writing_files_mutex};
+        return writing_files.emplace(data_file_index).second; /// Return false if this host is already writing this file.
+    }
 }
 
 bool BackupCoordinationRemote::hasConcurrentBackups(const std::atomic<size_t> &) const
diff --git a/src/Backups/BackupCoordinationRemote.h b/src/Backups/BackupCoordinationRemote.h
index 949dd9c9bf0..c1c7a40fc44 100644
--- a/src/Backups/BackupCoordinationRemote.h
+++ b/src/Backups/BackupCoordinationRemote.h
@@ -106,12 +106,14 @@ private:
     mutable std::optional<BackupCoordinationReplicatedAccess> TSA_GUARDED_BY(replicated_access_mutex) replicated_access;
     mutable std::optional<BackupCoordinationReplicatedSQLObjects> TSA_GUARDED_BY(replicated_sql_objects_mutex) replicated_sql_objects;
     mutable std::optional<BackupCoordinationFileInfos> TSA_GUARDED_BY(file_infos_mutex) file_infos;
+    std::unordered_set<size_t> TSA_GUARDED_BY(writing_files_mutex) writing_files;
 
     mutable std::mutex zookeeper_mutex;
     mutable std::mutex replicated_tables_mutex;
     mutable std::mutex replicated_access_mutex;
     mutable std::mutex replicated_sql_objects_mutex;
     mutable std::mutex file_infos_mutex;
+    mutable std::mutex writing_files_mutex;
 };
 
 }
diff --git a/tests/integration/test_backup_restore_on_cluster/test.py b/tests/integration/test_backup_restore_on_cluster/test.py
index 5542eac856d..6af3a7dbab8 100644
--- a/tests/integration/test_backup_restore_on_cluster/test.py
+++ b/tests/integration/test_backup_restore_on_cluster/test.py
@@ -2,6 +2,7 @@ from time import sleep
 import pytest
 import re
 import os.path
+import random, string
 from helpers.cluster import ClickHouseCluster
 from helpers.test_tools import TSV, assert_eq_with_retry
 
@@ -726,6 +727,58 @@ def test_projection():
     )
 
 
+def test_file_deduplication():
+    # Random column name helps finding it in logs.
+    column_name = "".join(random.choice(string.ascii_letters) for x in range(10))
+
+    # Make four replicas in total: 2 on each host.
+    node1.query(
+        f"""
+        CREATE TABLE tbl ON CLUSTER 'cluster' (
+        {column_name} Int32
+        ) ENGINE=ReplicatedMergeTree('/clickhouse/tables/tbl/', '{{replica}}')
+        ORDER BY tuple() SETTINGS min_bytes_for_wide_part=0
+        """
+    )
+
+    node1.query(
+        f"""
+        CREATE TABLE tbl2 ON CLUSTER 'cluster' (
+        {column_name} Int32
+        ) ENGINE=ReplicatedMergeTree('/clickhouse/tables/tbl/', '{{replica}}-2')
+        ORDER BY tuple() SETTINGS min_bytes_for_wide_part=0
+        """
+    )
+
+    # Unique data.
+    node1.query(
+        f"INSERT INTO tbl VALUES (3556), (1177), (4004), (4264), (3729), (1438), (2158), (2684), (415), (1917)"
+    )
+    node1.query("SYSTEM SYNC REPLICA ON CLUSTER 'cluster' tbl")
+    node1.query("SYSTEM SYNC REPLICA ON CLUSTER 'cluster' tbl2")
+
+    backup_name = new_backup_name()
+    node1.query(f"BACKUP TABLE tbl, TABLE tbl2 ON CLUSTER 'cluster' TO {backup_name}")
+
+    node1.query("SYSTEM FLUSH LOGS ON CLUSTER 'cluster'")
+
+    # The bin file should be written to the backup once, and skipped three times (because there are four replicas in total).
+    bin_file_writing_log_line = (
+        f"Writing backup for file .*{column_name}.bin .* (disk default)"
+    )
+    bin_file_skip_log_line = f"Writing backup for file .*{column_name}.bin .* skipped"
+
+    num_bin_file_writings = int(node1.count_in_log(bin_file_writing_log_line)) + int(
+        node2.count_in_log(bin_file_writing_log_line)
+    )
+    num_bin_file_skips = int(node1.count_in_log(bin_file_skip_log_line)) + int(
+        node2.count_in_log(bin_file_skip_log_line)
+    )
+
+    assert num_bin_file_writings == 1
+    assert num_bin_file_skips == 3
+
+
 def test_replicated_table_with_not_synced_def():
     node1.query(
         "CREATE TABLE tbl ("

From 4c8a4f54ce9a1ce58ea2a6f4c7b5f0ea804ac110 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 14:44:33 +0300
Subject: [PATCH 703/722] Add a test for #48894 (#51307)

---
 tests/queries/0_stateless/02795_full_join_assert_cast.reference | 1 +
 tests/queries/0_stateless/02795_full_join_assert_cast.sql       | 1 +
 2 files changed, 2 insertions(+)
 create mode 100644 tests/queries/0_stateless/02795_full_join_assert_cast.reference
 create mode 100644 tests/queries/0_stateless/02795_full_join_assert_cast.sql

diff --git a/tests/queries/0_stateless/02795_full_join_assert_cast.reference b/tests/queries/0_stateless/02795_full_join_assert_cast.reference
new file mode 100644
index 00000000000..102e3209c64
--- /dev/null
+++ b/tests/queries/0_stateless/02795_full_join_assert_cast.reference
@@ -0,0 +1 @@
+String
diff --git a/tests/queries/0_stateless/02795_full_join_assert_cast.sql b/tests/queries/0_stateless/02795_full_join_assert_cast.sql
new file mode 100644
index 00000000000..d3f0060ac79
--- /dev/null
+++ b/tests/queries/0_stateless/02795_full_join_assert_cast.sql
@@ -0,0 +1 @@
+SELECT any(toTypeName(s)) FROM (SELECT ('a' :: String) as s) t1 FULL JOIN (SELECT ('b' :: LowCardinality(String)) as s) t2 USING (s);

From 1ebfaafec8f9abebbc76e73f783287d3cf1240d5 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 14:45:23 +0300
Subject: [PATCH 704/722] Add a test for #47865 (#51306)

* Add a test for #47865

* Add a test for #47865
---
 tests/queries/0_stateless/02794_pushdown_invalid_get.reference | 1 +
 tests/queries/0_stateless/02794_pushdown_invalid_get.sql       | 2 ++
 2 files changed, 3 insertions(+)
 create mode 100644 tests/queries/0_stateless/02794_pushdown_invalid_get.reference
 create mode 100644 tests/queries/0_stateless/02794_pushdown_invalid_get.sql

diff --git a/tests/queries/0_stateless/02794_pushdown_invalid_get.reference b/tests/queries/0_stateless/02794_pushdown_invalid_get.reference
new file mode 100644
index 00000000000..3fbedf693b5
--- /dev/null
+++ b/tests/queries/0_stateless/02794_pushdown_invalid_get.reference
@@ -0,0 +1 @@
+-2
diff --git a/tests/queries/0_stateless/02794_pushdown_invalid_get.sql b/tests/queries/0_stateless/02794_pushdown_invalid_get.sql
new file mode 100644
index 00000000000..949f868259e
--- /dev/null
+++ b/tests/queries/0_stateless/02794_pushdown_invalid_get.sql
@@ -0,0 +1,2 @@
+SELECT * FROM (SELECT toInt128(NULL) AS x UNION ALL SELECT materialize(toInt128(-2))) WHERE x; -- { serverError ILLEGAL_TYPE_OF_COLUMN_FOR_FILTER }
+SELECT * FROM (SELECT toInt128(NULL) AS x UNION ALL SELECT materialize(toInt128(-2))) WHERE x != 0;

From c30c7cf5f65792d51b879a1c1eabc2320b12143e Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 14:47:37 +0300
Subject: [PATCH 705/722] Scratch the strange Python code (#51302)

---
 .../test_host_regexp_hosts_file_resolution/test.py          | 2 +-
 .../test_host_regexp_multiple_ptr_records/test.py           | 6 +++---
 tests/integration/test_kerberos_auth/test.py                | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/tests/integration/test_host_regexp_hosts_file_resolution/test.py b/tests/integration/test_host_regexp_hosts_file_resolution/test.py
index 3fd9e65cf2a..2c07c4d880f 100644
--- a/tests/integration/test_host_regexp_hosts_file_resolution/test.py
+++ b/tests/integration/test_host_regexp_hosts_file_resolution/test.py
@@ -43,4 +43,4 @@ def test_host_regexp_multiple_ptr_hosts_file_v4(started_cluster):
 
     endpoint = build_endpoint_v4(server_ip)
 
-    assert "1\n" == client.exec_in_container((["bash", "-c", f"curl {endpoint}"]))
+    assert "1\n" == client.exec_in_container(["bash", "-c", f"curl {endpoint}"])
diff --git a/tests/integration/test_host_regexp_multiple_ptr_records/test.py b/tests/integration/test_host_regexp_multiple_ptr_records/test.py
index fa2917411e4..ba807d3b5d7 100644
--- a/tests/integration/test_host_regexp_multiple_ptr_records/test.py
+++ b/tests/integration/test_host_regexp_multiple_ptr_records/test.py
@@ -66,7 +66,7 @@ def test_host_regexp_multiple_ptr_v4_fails_with_wrong_resolution(started_cluster
 
     endpoint = build_endpoint_v4(server_ip)
 
-    assert "1\n" != client.exec_in_container((["bash", "-c", f"curl {endpoint}"]))
+    assert "1\n" != client.exec_in_container(["bash", "-c", f"curl {endpoint}"])
 
 
 def test_host_regexp_multiple_ptr_v4(started_cluster):
@@ -79,7 +79,7 @@ def test_host_regexp_multiple_ptr_v4(started_cluster):
 
     endpoint = build_endpoint_v4(server_ip)
 
-    assert "1\n" == client.exec_in_container((["bash", "-c", f"curl {endpoint}"]))
+    assert "1\n" == client.exec_in_container(["bash", "-c", f"curl {endpoint}"])
 
 
 def test_host_regexp_multiple_ptr_v6(started_cluster):
@@ -88,4 +88,4 @@ def test_host_regexp_multiple_ptr_v6(started_cluster):
 
     endpoint = build_endpoint_v6(ch_server.ipv6_address)
 
-    assert "1\n" == client.exec_in_container((["bash", "-c", f"curl -6 {endpoint}"]))
+    assert "1\n" == client.exec_in_container(["bash", "-c", f"curl -6 {endpoint}"])
diff --git a/tests/integration/test_kerberos_auth/test.py b/tests/integration/test_kerberos_auth/test.py
index 3a183ad86a0..a41255cff3e 100644
--- a/tests/integration/test_kerberos_auth/test.py
+++ b/tests/integration/test_kerberos_auth/test.py
@@ -47,7 +47,7 @@ def make_auth(instance):
     instance_ip = cluster.get_instance_ip(instance.name)
 
     client.exec_in_container(
-        (["bash", "-c", f"echo '{instance_ip} {instance.hostname}' >> /etc/hosts"])
+        ["bash", "-c", f"echo '{instance_ip} {instance.hostname}' >> /etc/hosts"]
     )
 
     client.exec_in_container(

From eaf95306ed45a7875c37a36d125350c7f3e10462 Mon Sep 17 00:00:00 2001
From: alesapin <alesapin@clickhouse.com>
Date: Fri, 23 Jun 2023 13:49:07 +0200
Subject: [PATCH 706/722] Add random sleep for zero copy (#51282)

* Add small sleep for zero copy replication merges and mutations

* Update src/Storages/MergeTree/MergeFromLogEntryTask.cpp

Co-authored-by: Sergei Trifonov <sergei@clickhouse.com>

* Update src/Storages/MergeTree/MergeFromLogEntryTask.cpp

Co-authored-by: Sergei Trifonov <sergei@clickhouse.com>

* Update src/Storages/MergeTree/MutateFromLogEntryTask.cpp

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>

* Update src/Storages/MergeTree/MergeFromLogEntryTask.cpp

Co-authored-by: Sergei Trifonov <sergei@clickhouse.com>

* Update src/Storages/MergeTree/MutateFromLogEntryTask.cpp

* Fix darwin build

---------

Co-authored-by: Sergei Trifonov <sergei@clickhouse.com>
Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 .../MergeTree/MergeFromLogEntryTask.cpp       | 25 +++++++++++++++++++
 .../MergeTree/MergeFromLogEntryTask.h         |  3 +++
 src/Storages/MergeTree/MergeTreeSettings.h    |  1 +
 .../MergeTree/MutateFromLogEntryTask.cpp      | 22 ++++++++++++++++
 .../MergeTree/MutateFromLogEntryTask.h        |  5 ++++
 5 files changed, 56 insertions(+)

diff --git a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
index 5cee402f88c..4c6f1bcb016 100644
--- a/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MergeFromLogEntryTask.cpp
@@ -4,6 +4,9 @@
 #include <Common/ProfileEvents.h>
 #include <Common/ProfileEventsScope.h>
 #include <Storages/StorageReplicatedMergeTree.h>
+#include <pcg_random.hpp>
+#include <Common/randomSeed.h>
+#include <cmath>
 
 namespace ProfileEvents
 {
@@ -30,6 +33,7 @@ MergeFromLogEntryTask::MergeFromLogEntryTask(
         storage_,
         selected_entry_,
         task_result_callback_)
+    , rng(randomSeed())
 {
 }
 
@@ -216,6 +220,27 @@ ReplicatedMergeMutateTaskBase::PrepareResult MergeFromLogEntryTask::prepare()
                 };
             }
 
+            if (storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock != 0 &&
+                estimated_space_for_merge >= storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock)
+            {
+                /// In zero copy replication only one replica execute merge/mutation, others just download merged parts metadata.
+                /// Here we are trying to mitigate the skew of merges execution because of faster/slower replicas.
+                /// Replicas can be slow because of different reasons like bigger latency for ZooKeeper or just slight step behind because of bigger queue.
+                /// In this case faster replica can pick up all merges execution, especially large merges while other replicas can just idle. And even in this case
+                /// the fast replica is not overloaded because amount of executing merges doesn't affect the ability to acquire locks for new merges.
+                ///
+                /// So here we trying to solve it with the simplest solution -- sleep random time up to 500ms for 1GB part and up to 7 seconds for 300GB part.
+                /// It can sound too much, but we are trying to aquite these locks in background tasks which can be scheduled each 5 seconds or so.
+                double start_to_sleep_seconds = std::logf(storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock.value);
+                uint64_t right_border_to_sleep_ms = static_cast<uint64_t>((std::log(estimated_space_for_merge) - start_to_sleep_seconds + 0.5) * 1000);
+                uint64_t time_to_sleep_milliseconds = std::min<uint64_t>(10000UL, std::uniform_int_distribution<uint64_t>(1, 1 + right_border_to_sleep_ms)(rng));
+
+                LOG_INFO(log, "Merge size is {} bytes (it's more than sleep threshold {}) so will intentionally sleep for {} ms to allow other replicas to took this big merge",
+                    estimated_space_for_merge, storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock, time_to_sleep_milliseconds);
+
+                std::this_thread::sleep_for(std::chrono::milliseconds(time_to_sleep_milliseconds));
+            }
+
             zero_copy_lock = storage.tryCreateZeroCopyExclusiveLock(entry.new_part_name, disk);
 
             if (!zero_copy_lock || !zero_copy_lock->isLocked())
diff --git a/src/Storages/MergeTree/MergeFromLogEntryTask.h b/src/Storages/MergeTree/MergeFromLogEntryTask.h
index 2c559c06d7e..62908f79fb4 100644
--- a/src/Storages/MergeTree/MergeFromLogEntryTask.h
+++ b/src/Storages/MergeTree/MergeFromLogEntryTask.h
@@ -3,6 +3,8 @@
 #include <memory>
 #include <utility>
 
+#include <pcg_random.hpp>
+
 #include <Storages/MergeTree/IExecutableTask.h>
 #include <Storages/MergeTree/MergeTask.h>
 #include <Storages/MergeTree/ReplicatedMergeTreeQueue.h>
@@ -47,6 +49,7 @@ private:
     Priority priority;
 
     MergeTaskPtr merge_task;
+    pcg64 rng;
 };
 
 
diff --git a/src/Storages/MergeTree/MergeTreeSettings.h b/src/Storages/MergeTree/MergeTreeSettings.h
index a822eb089c8..dc24327712c 100644
--- a/src/Storages/MergeTree/MergeTreeSettings.h
+++ b/src/Storages/MergeTree/MergeTreeSettings.h
@@ -162,6 +162,7 @@ struct Settings;
     M(Bool, check_sample_column_is_correct, true, "Check columns or columns by hash for sampling are unsigned integer.", 0) \
     M(Bool, allow_vertical_merges_from_compact_to_wide_parts, false, "Allows vertical merges from compact to wide parts. This settings must have the same value on all replicas", 0) \
     M(Bool, enable_the_endpoint_id_with_zookeeper_name_prefix, false, "Enable the endpoint id with zookeeper name prefix for the replicated merge tree table", 0) \
+    M(UInt64, zero_copy_merge_mutation_min_parts_size_sleep_before_lock, 1ULL * 1024 * 1024 * 1024, "If zero copy replication is enabled sleep random amount of time before trying to lock depending on parts size for merge or mutation", 0) \
     \
     /** Experimental/work in progress feature. Unsafe for production. */ \
     M(UInt64, part_moves_between_shards_enable, 0, "Experimental/Incomplete feature to move parts between shards. Does not take into account sharding expressions.", 0) \
diff --git a/src/Storages/MergeTree/MutateFromLogEntryTask.cpp b/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
index 42dccef7e6f..4c2def34e8a 100644
--- a/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
+++ b/src/Storages/MergeTree/MutateFromLogEntryTask.cpp
@@ -3,6 +3,7 @@
 #include <Common/logger_useful.h>
 #include <Common/ProfileEvents.h>
 #include <Storages/StorageReplicatedMergeTree.h>
+#include <cmath>
 
 namespace ProfileEvents
 {
@@ -128,6 +129,27 @@ ReplicatedMergeMutateTaskBase::PrepareResult MutateFromLogEntryTask::prepare()
                 };
             }
 
+            if (storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock != 0 &&
+                estimated_space_for_result >= storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock)
+            {
+                /// In zero copy replication only one replica execute merge/mutation, others just download merged parts metadata.
+                /// Here we are trying to metigate the skew of merges execution because of faster/slower replicas.
+                /// Replicas can be slow because of different reasons like bigger latency for ZooKeeper or just slight step behind because of bigger queue.
+                /// In this case faster replica can pick up all merges execution, especially large merges while other replicas can just idle. And even in this case
+                /// the fast replica is not overloaded because amount of executing merges don't affect the ability to aquite locks for new merges.
+                ///
+                /// So here we trying to solve it with the simplest solution -- sleep random time up to 500ms for 1GB part and up to 7 seconds for 300GB part.
+                /// It can sound too much, but we are trying to acquire these locks in background tasks which can be scheduled each 5 seconds or so.
+                double start_to_sleep_seconds = std::logf(storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock.value);
+                uint64_t right_border_to_sleep_ms = static_cast<uint64_t>((std::log(estimated_space_for_result) - start_to_sleep_seconds + 0.5) * 1000);
+                uint64_t time_to_sleep_milliseconds = std::min<uint64_t>(10000UL, std::uniform_int_distribution<uint64_t>(1, 1 + right_border_to_sleep_ms)(rng));
+
+                LOG_INFO(log, "Mutation size is {} bytes (it's more than sleep threshold {}) so will intentionally sleep for {} ms to allow other replicas to took this big mutation",
+                    estimated_space_for_result, storage_settings_ptr->zero_copy_merge_mutation_min_parts_size_sleep_before_lock, time_to_sleep_milliseconds);
+
+                std::this_thread::sleep_for(std::chrono::milliseconds(time_to_sleep_milliseconds));
+            }
+
             zero_copy_lock = storage.tryCreateZeroCopyExclusiveLock(entry.new_part_name, disk);
 
             if (!zero_copy_lock || !zero_copy_lock->isLocked())
diff --git a/src/Storages/MergeTree/MutateFromLogEntryTask.h b/src/Storages/MergeTree/MutateFromLogEntryTask.h
index 42b4debcbf2..b6d3f5d4b6b 100644
--- a/src/Storages/MergeTree/MutateFromLogEntryTask.h
+++ b/src/Storages/MergeTree/MutateFromLogEntryTask.h
@@ -1,5 +1,7 @@
 #pragma once
 
+#include <pcg_random.hpp>
+
 #include <Storages/MergeTree/IExecutableTask.h>
 #include <Storages/MergeTree/MutateTask.h>
 #include <Storages/MergeTree/ReplicatedMergeMutateTaskBase.h>
@@ -7,6 +9,7 @@
 #include <Storages/MergeTree/ReplicatedMergeTreeLogEntry.h>
 #include <Storages/MergeTree/ZeroCopyLock.h>
 #include <Storages/StorageReplicatedMergeTree.h>
+#include <Common/randomSeed.h>
 
 namespace DB
 {
@@ -24,6 +27,7 @@ public:
             storage_,
             selected_entry_,
             task_result_callback_)
+        , rng(randomSeed())
         {}
 
 
@@ -56,6 +60,7 @@ private:
     FutureMergedMutatedPartPtr future_mutated_part{nullptr};
 
     MutateTaskPtr mutate_task;
+    pcg64 rng;
 };
 
 

From 75ef844f99a3af081978a7d905dcf2c214508237 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 14:51:40 +0300
Subject: [PATCH 707/722] Fix long test functions_bad_arguments (#51310)

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 src/Server/GRPCServer.cpp | 2 +-
 src/Server/TCPHandler.cpp | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/Server/GRPCServer.cpp b/src/Server/GRPCServer.cpp
index e335d247a82..bf9ba20a5cf 100644
--- a/src/Server/GRPCServer.cpp
+++ b/src/Server/GRPCServer.cpp
@@ -1299,7 +1299,7 @@ namespace
     {
         io.onException();
 
-        LOG_ERROR(log, getExceptionMessageAndPattern(exception, /* with_stacktrace */ true));
+        LOG_ERROR(log, getExceptionMessageAndPattern(exception, send_exception_with_stacktrace));
 
         if (responder && !responder_finished)
         {
diff --git a/src/Server/TCPHandler.cpp b/src/Server/TCPHandler.cpp
index 50e9d50e2f6..ced40730380 100644
--- a/src/Server/TCPHandler.cpp
+++ b/src/Server/TCPHandler.cpp
@@ -588,7 +588,7 @@ void TCPHandler::runImpl()
                 }
 
                 const auto & e = *exception;
-                LOG_ERROR(log, getExceptionMessageAndPattern(e, /* with_stacktrace */ true));
+                LOG_ERROR(log, getExceptionMessageAndPattern(e, send_exception_with_stack_trace));
                 sendException(*exception, send_exception_with_stack_trace);
             }
         }

From e1b0991de226f795886d2ed13e27ca94cb3a7641 Mon Sep 17 00:00:00 2001
From: Alexey Milovidov <milovidov@clickhouse.com>
Date: Fri, 23 Jun 2023 15:02:53 +0300
Subject: [PATCH 708/722] Add a test for #48676 (#51308)

Co-authored-by: Nikita Mikhaylov <mikhaylovnikitka@gmail.com>
---
 ...6_projection_date_filter_on_view.reference |  0
 .../02796_projection_date_filter_on_view.sql  | 70 +++++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 tests/queries/0_stateless/02796_projection_date_filter_on_view.reference
 create mode 100644 tests/queries/0_stateless/02796_projection_date_filter_on_view.sql

diff --git a/tests/queries/0_stateless/02796_projection_date_filter_on_view.reference b/tests/queries/0_stateless/02796_projection_date_filter_on_view.reference
new file mode 100644
index 00000000000..e69de29bb2d
diff --git a/tests/queries/0_stateless/02796_projection_date_filter_on_view.sql b/tests/queries/0_stateless/02796_projection_date_filter_on_view.sql
new file mode 100644
index 00000000000..9d9d7a3abd5
--- /dev/null
+++ b/tests/queries/0_stateless/02796_projection_date_filter_on_view.sql
@@ -0,0 +1,70 @@
+DROP TABLE IF EXISTS fx_1m;
+DROP TABLE IF EXISTS fx_5m;
+
+-- create source table
+CREATE TABLE fx_1m (
+    `symbol` LowCardinality(String) CODEC(ZSTD),
+    `dt_close` DateTime64(3, 'UTC') CODEC(DoubleDelta, ZSTD),
+    `open` Float32 CODEC(Delta, ZSTD),
+    `high` Float32 CODEC(Delta, ZSTD),
+    `low` Float32 CODEC(Delta, ZSTD),
+    `close` Float32 CODEC(Delta, ZSTD),
+    `volume` Float32 CODEC(Delta, ZSTD)
+)
+ENGINE = MergeTree()
+PARTITION BY toYear(dt_close)
+ORDER BY (symbol, dt_close);
+
+-- add projection
+ALTER TABLE fx_1m
+ADD PROJECTION fx_5m (
+    SELECT
+        symbol,
+        toStartOfInterval(dt_close, INTERVAL 300 SECOND) AS dt_close,
+        argMin(open, dt_close),
+        max(high),
+        min(low),
+        argMax(close, dt_close),
+        sum(volume) volume
+    GROUP BY symbol, dt_close
+);
+
+-- materialize projection
+ALTER TABLE fx_1m MATERIALIZE PROJECTION fx_5m SETTINGS mutations_sync = 2;
+
+-- create view using projection
+CREATE VIEW fx_5m AS
+SELECT
+    symbol,
+    toStartOfInterval(dt_close, INTERVAL 300 SECOND) AS dt_close,
+    argMin(open, dt_close) open,
+    max(high) high,
+    min(low) low,
+    argMax(close, dt_close) close,
+    sum(volume) volume
+FROM fx_1m
+GROUP BY symbol, dt_close;
+
+-- insert sample data
+INSERT INTO fx_1m
+SELECT
+    'EURUSD',
+    toDateTime64('2022-12-12 12:00:00', 3, 'UTC') + number,
+    number + randCanonical(),
+    number + randCanonical(),
+    number + randCanonical(),
+    number + randCanonical(),
+    number + randCanonical()
+FROM numbers(1000000);
+
+-- segmentation fault (filter on dt_close column)
+SELECT
+    dt_close,
+    close
+FROM fx_5m
+where symbol = 'EURUSD' and dt_close between '2022-12-11' and '2022-12-13'
+order by dt_close
+format Null;
+
+DROP TABLE fx_5m;
+DROP TABLE fx_1m;

From cc3398159efe1db53a4043b8a157ad525ab5bed2 Mon Sep 17 00:00:00 2001
From: Robert Schulze <robert@clickhouse.com>
Date: Fri, 23 Jun 2023 14:35:51 +0200
Subject: [PATCH 709/722] Restore Azure build on ARM (#51288)

---
 contrib/CMakeLists.txt                | 4 ++--
 contrib/azure-cmake/CMakeLists.txt    | 2 +-
 contrib/libhdfs3-cmake/CMakeLists.txt | 4 ++--
 src/TableFunctions/CMakeLists.txt     | 9 ++++++++-
 4 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/contrib/CMakeLists.txt b/contrib/CMakeLists.txt
index 4a4ff9982ea..2af468970f1 100644
--- a/contrib/CMakeLists.txt
+++ b/contrib/CMakeLists.txt
@@ -146,7 +146,7 @@ add_contrib (amqpcpp-cmake AMQP-CPP) # requires: libuv
 add_contrib (cassandra-cmake cassandra) # requires: libuv
 if (NOT OS_DARWIN)
     add_contrib (curl-cmake curl)
-    add_contrib (azure-cmake azure)
+    add_contrib (azure-cmake azure) # requires: curl
     add_contrib (sentry-native-cmake sentry-native) # requires: curl
 endif()
 add_contrib (fmtlib-cmake fmtlib)
@@ -157,7 +157,7 @@ add_contrib (librdkafka-cmake librdkafka) # requires: libgsasl
 add_contrib (nats-io-cmake nats-io)
 add_contrib (isa-l-cmake isa-l)
 add_contrib (libhdfs3-cmake libhdfs3) # requires: google-protobuf, krb5, isa-l
-add_contrib (hive-metastore-cmake hive-metastore) # requires: thrift/avro/arrow/libhdfs3
+add_contrib (hive-metastore-cmake hive-metastore) # requires: thrift, avro, arrow, libhdfs3
 add_contrib (cppkafka-cmake cppkafka)
 add_contrib (libpqxx-cmake libpqxx)
 add_contrib (libpq-cmake libpq)
diff --git a/contrib/azure-cmake/CMakeLists.txt b/contrib/azure-cmake/CMakeLists.txt
index 887122e7653..1e2a4c97824 100644
--- a/contrib/azure-cmake/CMakeLists.txt
+++ b/contrib/azure-cmake/CMakeLists.txt
@@ -1,6 +1,6 @@
 option (ENABLE_AZURE_BLOB_STORAGE "Enable Azure blob storage" ${ENABLE_LIBRARIES})
 
-if (NOT ENABLE_AZURE_BLOB_STORAGE OR BUILD_STANDALONE_KEEPER OR OS_FREEBSD OR (NOT ARCH_AMD64))
+if (NOT ENABLE_AZURE_BLOB_STORAGE OR BUILD_STANDALONE_KEEPER OR OS_FREEBSD)
     message(STATUS "Not using Azure blob storage")
     return()
 endif()
diff --git a/contrib/libhdfs3-cmake/CMakeLists.txt b/contrib/libhdfs3-cmake/CMakeLists.txt
index e2f122e282a..a630a8e45c4 100644
--- a/contrib/libhdfs3-cmake/CMakeLists.txt
+++ b/contrib/libhdfs3-cmake/CMakeLists.txt
@@ -1,11 +1,11 @@
-if(NOT ARCH_AARCH64 AND NOT OS_FREEBSD AND NOT APPLE AND NOT ARCH_PPC64LE AND NOT ARCH_S390X)
+if(NOT OS_FREEBSD AND NOT APPLE AND NOT ARCH_PPC64LE AND NOT ARCH_S390X)
     option(ENABLE_HDFS "Enable HDFS" ${ENABLE_LIBRARIES})
 elseif(ENABLE_HDFS)
     message (${RECONFIGURE_MESSAGE_LEVEL} "Cannot use HDFS3 with current configuration")
 endif()
 
 if(NOT ENABLE_HDFS)
-    message(STATUS "Not using hdfs")
+    message(STATUS "Not using HDFS")
     return()
 endif()
 
diff --git a/src/TableFunctions/CMakeLists.txt b/src/TableFunctions/CMakeLists.txt
index 3544c5bf8b4..c9e5c66fe4a 100644
--- a/src/TableFunctions/CMakeLists.txt
+++ b/src/TableFunctions/CMakeLists.txt
@@ -1,5 +1,7 @@
 include("${ClickHouse_SOURCE_DIR}/cmake/dbms_glob_sources.cmake")
+
 add_headers_and_sources(clickhouse_table_functions .)
+
 if (TARGET ch_contrib::hivemetastore)
     add_headers_and_sources(clickhouse_table_functions Hive)
 endif ()
@@ -16,6 +18,11 @@ list(REMOVE_ITEM clickhouse_table_functions_headers
 add_library(clickhouse_table_functions ${clickhouse_table_functions_sources})
 
 target_link_libraries(clickhouse_table_functions PRIVATE clickhouse_parsers clickhouse_storages_system dbms)
+
 if (TARGET ch_contrib::hivemetastore)
-    target_link_libraries(clickhouse_table_functions PRIVATE ch_contrib::hivemetastore ch_contrib::hdfs ch_contrib::parquet ch_contrib::azure_sdk)
+    target_link_libraries(clickhouse_table_functions PRIVATE ch_contrib::hivemetastore ch_contrib::hdfs ch_contrib::parquet)
+endif ()
+
+if (TARGET ch_contrib::azure_sdk)
+    target_link_libraries(clickhouse_table_functions PRIVATE ch_contrib::azure_sdk)
 endif ()

From ffd8183cfa0579927899dde2850fc8c5f95a4316 Mon Sep 17 00:00:00 2001
From: Rich Raposa <richraposa@gmail.com>
Date: Fri, 23 Jun 2023 06:49:41 -0600
Subject: [PATCH 710/722] Fix heading of nlp-functions.md

---
 docs/en/sql-reference/functions/nlp-functions.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/en/sql-reference/functions/nlp-functions.md b/docs/en/sql-reference/functions/nlp-functions.md
index f10415783a5..bb127a939f3 100644
--- a/docs/en/sql-reference/functions/nlp-functions.md
+++ b/docs/en/sql-reference/functions/nlp-functions.md
@@ -4,6 +4,8 @@ sidebar_position: 130
 sidebar_label: NLP (experimental)
 ---
 
+# Natural Language Processing (NLP) Functions
+
 :::note
 This is an experimental feature that is currently in development and is not ready for general use. It will change in unpredictable backwards-incompatible ways in future releases. Set `allow_experimental_nlp_functions = 1` to enable it.
 :::

From b5d9ed5b0c2bb28bd17be3fa3ce08628bdd12c42 Mon Sep 17 00:00:00 2001
From: rfraposa <richraposa@gmail.com>
Date: Fri, 23 Jun 2023 07:16:22 -0600
Subject: [PATCH 711/722] Alphabetize table functions and engines

---
 .../integrations/ExternalDistributed.md            |  2 +-
 .../table-engines/integrations/azureBlobStorage.md |  5 +++--
 .../table-engines/integrations/deltalake.md        |  1 +
 .../table-engines/integrations/embedded-rocksdb.md |  4 ++--
 docs/en/engines/table-engines/integrations/hdfs.md |  4 ++--
 docs/en/engines/table-engines/integrations/hive.md |  2 +-
 docs/en/engines/table-engines/integrations/hudi.md |  1 +
 .../engines/table-engines/integrations/iceberg.md  |  1 +
 docs/en/engines/table-engines/integrations/jdbc.md |  2 +-
 .../en/engines/table-engines/integrations/kafka.md |  2 +-
 .../integrations/materialized-postgresql.md        |  2 +-
 .../engines/table-engines/integrations/mongodb.md  |  2 +-
 .../en/engines/table-engines/integrations/mysql.md |  2 +-
 docs/en/engines/table-engines/integrations/nats.md | 10 +++++-----
 docs/en/engines/table-engines/integrations/odbc.md |  2 +-
 .../table-engines/integrations/postgresql.md       |  2 +-
 .../engines/table-engines/integrations/rabbitmq.md |  2 +-
 .../en/engines/table-engines/integrations/redis.md |  2 +-
 docs/en/engines/table-engines/integrations/s3.md   |  4 ++--
 .../engines/table-engines/integrations/sqlite.md   |  2 +-
 .../table-functions/azureBlobStorage.md            |  9 +++++----
 docs/en/sql-reference/table-functions/cluster.md   | 10 +++++-----
 docs/en/sql-reference/table-functions/deltalake.md |  3 ++-
 .../en/sql-reference/table-functions/dictionary.md |  2 +-
 .../en/sql-reference/table-functions/executable.md |  2 +-
 docs/en/sql-reference/table-functions/file.md      |  2 +-
 docs/en/sql-reference/table-functions/format.md    |  2 +-
 docs/en/sql-reference/table-functions/gcs.md       |  4 ++--
 docs/en/sql-reference/table-functions/generate.md  |  2 +-
 docs/en/sql-reference/table-functions/hdfs.md      |  4 ++--
 .../sql-reference/table-functions/hdfsCluster.md   |  4 ++--
 docs/en/sql-reference/table-functions/hudi.md      |  3 ++-
 docs/en/sql-reference/table-functions/iceberg.md   |  3 ++-
 docs/en/sql-reference/table-functions/index.md     |  4 ++--
 docs/en/sql-reference/table-functions/input.md     |  2 +-
 docs/en/sql-reference/table-functions/jdbc.md      |  2 +-
 docs/en/sql-reference/table-functions/merge.md     |  4 ++--
 docs/en/sql-reference/table-functions/mongodb.md   |  2 +-
 docs/en/sql-reference/table-functions/mysql.md     |  2 +-
 docs/en/sql-reference/table-functions/null.md      |  2 +-
 docs/en/sql-reference/table-functions/numbers.md   |  2 +-
 docs/en/sql-reference/table-functions/odbc.md      |  2 +-
 .../en/sql-reference/table-functions/postgresql.md |  2 +-
 docs/en/sql-reference/table-functions/redis.md     |  4 ++--
 docs/en/sql-reference/table-functions/remote.md    |  6 +++---
 docs/en/sql-reference/table-functions/s3.md        |  4 ++--
 docs/en/sql-reference/table-functions/s3Cluster.md | 14 +++++++-------
 docs/en/sql-reference/table-functions/sqlite.md    |  8 ++++----
 docs/en/sql-reference/table-functions/url.md       |  2 +-
 .../en/sql-reference/table-functions/urlCluster.md |  2 +-
 docs/en/sql-reference/table-functions/view.md      |  2 +-
 51 files changed, 89 insertions(+), 81 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/ExternalDistributed.md b/docs/en/engines/table-engines/integrations/ExternalDistributed.md
index 3fb3fe88b55..d995c34e00a 100644
--- a/docs/en/engines/table-engines/integrations/ExternalDistributed.md
+++ b/docs/en/engines/table-engines/integrations/ExternalDistributed.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/ExternalDistributed
-sidebar_position: 12
+sidebar_position: 55
 sidebar_label: ExternalDistributed
 title: ExternalDistributed
 ---
diff --git a/docs/en/engines/table-engines/integrations/azureBlobStorage.md b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
index 14fbf0c068e..60e448377d0 100644
--- a/docs/en/engines/table-engines/integrations/azureBlobStorage.md
+++ b/docs/en/engines/table-engines/integrations/azureBlobStorage.md
@@ -1,5 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/azureBlobStorage
+sidebar_position: 10
 sidebar_label: Azure Blob Storage
 ---
 
@@ -29,8 +30,8 @@ CREATE TABLE azure_blob_storage_table (name String, value UInt32)
 **Example**
 
 ``` sql
-CREATE TABLE test_table (key UInt64, data String) 
-    ENGINE = AzureBlobStorage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;', 
+CREATE TABLE test_table (key UInt64, data String)
+    ENGINE = AzureBlobStorage('DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://azurite1:10000/devstoreaccount1/;',
     'test_container', 'test_table', 'CSV');
 
 INSERT INTO test_table VALUES (1, 'a'), (2, 'b'), (3, 'c');
diff --git a/docs/en/engines/table-engines/integrations/deltalake.md b/docs/en/engines/table-engines/integrations/deltalake.md
index 3e2e177e28f..b562e9d7fe6 100644
--- a/docs/en/engines/table-engines/integrations/deltalake.md
+++ b/docs/en/engines/table-engines/integrations/deltalake.md
@@ -1,5 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/deltalake
+sidebar_position: 40
 sidebar_label: DeltaLake
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/embedded-rocksdb.md b/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
index 6664b6a4613..2de981d33b7 100644
--- a/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
+++ b/docs/en/engines/table-engines/integrations/embedded-rocksdb.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/embedded-rocksdb
-sidebar_position: 9
+sidebar_position: 50
 sidebar_label: EmbeddedRocksDB
 ---
 
@@ -99,7 +99,7 @@ INSERT INTO test VALUES ('some key', 1, 'value', 3.2);
 
 ### Deletes
 
-Rows can be deleted using `DELETE` query or `TRUNCATE`. 
+Rows can be deleted using `DELETE` query or `TRUNCATE`.
 
 ```sql
 DELETE FROM test WHERE key LIKE 'some%' AND v1 > 1;
diff --git a/docs/en/engines/table-engines/integrations/hdfs.md b/docs/en/engines/table-engines/integrations/hdfs.md
index ff6e3a3bd98..c677123a8d0 100644
--- a/docs/en/engines/table-engines/integrations/hdfs.md
+++ b/docs/en/engines/table-engines/integrations/hdfs.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/hdfs
-sidebar_position: 6
+sidebar_position: 80
 sidebar_label: HDFS
 ---
 
@@ -63,7 +63,7 @@ SELECT * FROM hdfs_engine_table LIMIT 2
     - `ALTER` and `SELECT...SAMPLE` operations.
     - Indexes.
     - [Zero-copy](../../../operations/storing-data.md#zero-copy) replication is possible, but not recommended.
-  
+
   :::note Zero-copy replication is not ready for production
   Zero-copy replication is disabled by default in ClickHouse version 22.8 and higher.  This feature is not recommended for production use.
   :::
diff --git a/docs/en/engines/table-engines/integrations/hive.md b/docs/en/engines/table-engines/integrations/hive.md
index 5d10e417ae3..48867394418 100644
--- a/docs/en/engines/table-engines/integrations/hive.md
+++ b/docs/en/engines/table-engines/integrations/hive.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/hive
-sidebar_position: 4
+sidebar_position: 84
 sidebar_label: Hive
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/hudi.md b/docs/en/engines/table-engines/integrations/hudi.md
index a11e915aa3d..c60618af289 100644
--- a/docs/en/engines/table-engines/integrations/hudi.md
+++ b/docs/en/engines/table-engines/integrations/hudi.md
@@ -1,5 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/hudi
+sidebar_position: 86
 sidebar_label: Hudi
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/iceberg.md b/docs/en/engines/table-engines/integrations/iceberg.md
index 77cefc9283d..9d6395f73ac 100644
--- a/docs/en/engines/table-engines/integrations/iceberg.md
+++ b/docs/en/engines/table-engines/integrations/iceberg.md
@@ -1,5 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/iceberg
+sidebar_position: 90
 sidebar_label: Iceberg
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/jdbc.md b/docs/en/engines/table-engines/integrations/jdbc.md
index 99f851dcf3e..a4a1e2a31ae 100644
--- a/docs/en/engines/table-engines/integrations/jdbc.md
+++ b/docs/en/engines/table-engines/integrations/jdbc.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/jdbc
-sidebar_position: 3
+sidebar_position: 100
 sidebar_label: JDBC
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/kafka.md b/docs/en/engines/table-engines/integrations/kafka.md
index ccfca4c1f1f..b81d5624c1a 100644
--- a/docs/en/engines/table-engines/integrations/kafka.md
+++ b/docs/en/engines/table-engines/integrations/kafka.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/kafka
-sidebar_position: 8
+sidebar_position: 110
 sidebar_label: Kafka
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/materialized-postgresql.md b/docs/en/engines/table-engines/integrations/materialized-postgresql.md
index e112ca3bbb1..bccafd67c2c 100644
--- a/docs/en/engines/table-engines/integrations/materialized-postgresql.md
+++ b/docs/en/engines/table-engines/integrations/materialized-postgresql.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/materialized-postgresql
-sidebar_position: 12
+sidebar_position: 130
 sidebar_label: MaterializedPostgreSQL
 title: MaterializedPostgreSQL
 ---
diff --git a/docs/en/engines/table-engines/integrations/mongodb.md b/docs/en/engines/table-engines/integrations/mongodb.md
index a647ac9993f..912f81573db 100644
--- a/docs/en/engines/table-engines/integrations/mongodb.md
+++ b/docs/en/engines/table-engines/integrations/mongodb.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/mongodb
-sidebar_position: 5
+sidebar_position: 135
 sidebar_label: MongoDB
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/mysql.md b/docs/en/engines/table-engines/integrations/mysql.md
index 7f292eff34b..e50ed8caedd 100644
--- a/docs/en/engines/table-engines/integrations/mysql.md
+++ b/docs/en/engines/table-engines/integrations/mysql.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/mysql
-sidebar_position: 4
+sidebar_position: 138
 sidebar_label: MySQL
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/nats.md b/docs/en/engines/table-engines/integrations/nats.md
index a82d74e0d95..25f442e5ce7 100644
--- a/docs/en/engines/table-engines/integrations/nats.md
+++ b/docs/en/engines/table-engines/integrations/nats.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/nats
-sidebar_position: 14
+sidebar_position: 140
 sidebar_label: NATS
 ---
 
@@ -83,12 +83,12 @@ You can select one of the subjects the table reads from and publish your data th
   CREATE TABLE queue (
     key UInt64,
     value UInt64
-  ) ENGINE = NATS 
+  ) ENGINE = NATS
     SETTINGS nats_url = 'localhost:4444',
              nats_subjects = 'subject1,subject2',
              nats_format = 'JSONEachRow';
 
-  INSERT INTO queue 
+  INSERT INTO queue
   SETTINGS stream_like_engine_insert_queue = 'subject2'
   VALUES (1, 1);
 ```
@@ -102,7 +102,7 @@ Example:
     key UInt64,
     value UInt64,
     date DateTime
-  ) ENGINE = NATS 
+  ) ENGINE = NATS
     SETTINGS nats_url = 'localhost:4444',
              nats_subjects = 'subject1',
              nats_format = 'JSONEachRow',
@@ -137,7 +137,7 @@ Example:
   CREATE TABLE queue (
     key UInt64,
     value UInt64
-  ) ENGINE = NATS 
+  ) ENGINE = NATS
     SETTINGS nats_url = 'localhost:4444',
              nats_subjects = 'subject1',
              nats_format = 'JSONEachRow',
diff --git a/docs/en/engines/table-engines/integrations/odbc.md b/docs/en/engines/table-engines/integrations/odbc.md
index 37e08dc1420..e29e56c10b2 100644
--- a/docs/en/engines/table-engines/integrations/odbc.md
+++ b/docs/en/engines/table-engines/integrations/odbc.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/odbc
-sidebar_position: 2
+sidebar_position: 150
 sidebar_label: ODBC
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/postgresql.md b/docs/en/engines/table-engines/integrations/postgresql.md
index 8eab6fdb421..aa3dc855537 100644
--- a/docs/en/engines/table-engines/integrations/postgresql.md
+++ b/docs/en/engines/table-engines/integrations/postgresql.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/postgresql
-sidebar_position: 11
+sidebar_position: 160
 sidebar_label: PostgreSQL
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/rabbitmq.md b/docs/en/engines/table-engines/integrations/rabbitmq.md
index 7620cd22767..3fd5a130173 100644
--- a/docs/en/engines/table-engines/integrations/rabbitmq.md
+++ b/docs/en/engines/table-engines/integrations/rabbitmq.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/rabbitmq
-sidebar_position: 10
+sidebar_position: 170
 sidebar_label: RabbitMQ
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/redis.md b/docs/en/engines/table-engines/integrations/redis.md
index c1e88e7e92e..568179eb690 100644
--- a/docs/en/engines/table-engines/integrations/redis.md
+++ b/docs/en/engines/table-engines/integrations/redis.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/redis
-sidebar_position: 43
+sidebar_position: 175
 sidebar_label: Redis
 ---
 
diff --git a/docs/en/engines/table-engines/integrations/s3.md b/docs/en/engines/table-engines/integrations/s3.md
index 10a72394b57..c42630a044d 100644
--- a/docs/en/engines/table-engines/integrations/s3.md
+++ b/docs/en/engines/table-engines/integrations/s3.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/s3
-sidebar_position: 7
+sidebar_position: 180
 sidebar_label: S3
 ---
 
@@ -20,7 +20,7 @@ CREATE TABLE s3_engine_table (name String, value UInt32)
 **Engine parameters**
 
 - `path` — Bucket url with path to file. Supports following wildcards in readonly mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc'`, `'def'` — strings. For more information see [below](#wildcards-in-path).
-- `NOSIGN` - If this keyword is provided in place of credentials, all the requests will not be signed. 
+- `NOSIGN` - If this keyword is provided in place of credentials, all the requests will not be signed.
 - `format` — The [format](../../../interfaces/formats.md#formats) of the file.
 - `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file. For more information see [Using S3 for Data Storage](../mergetree-family/mergetree.md#table_engine-mergetree-s3).
 - `compression` — Compression type. Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. Parameter is optional. By default, it will auto-detect compression by file extension.
diff --git a/docs/en/engines/table-engines/integrations/sqlite.md b/docs/en/engines/table-engines/integrations/sqlite.md
index 20597d37a87..c67f863d390 100644
--- a/docs/en/engines/table-engines/integrations/sqlite.md
+++ b/docs/en/engines/table-engines/integrations/sqlite.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-engines/integrations/sqlite
-sidebar_position: 7
+sidebar_position: 185
 sidebar_label: SQLite
 ---
 
diff --git a/docs/en/sql-reference/table-functions/azureBlobStorage.md b/docs/en/sql-reference/table-functions/azureBlobStorage.md
index 5175aabd5d1..7bb5d892c47 100644
--- a/docs/en/sql-reference/table-functions/azureBlobStorage.md
+++ b/docs/en/sql-reference/table-functions/azureBlobStorage.md
@@ -1,5 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/azureBlobStorage
+sidebar_position: 10
 sidebar_label: azureBlobStorage
 keywords: [azure blob storage]
 ---
@@ -34,16 +35,16 @@ A table with the specified structure for reading or writing data in the specifie
 Write data into azure blob storage using the following :
 
 ```sql
-INSERT INTO TABLE FUNCTION azureBlobStorage('http://azurite1:10000/devstoreaccount1', 
+INSERT INTO TABLE FUNCTION azureBlobStorage('http://azurite1:10000/devstoreaccount1',
     'test_container', 'test_{_partition_id}.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==',
     'CSV', 'auto', 'column1 UInt32, column2 UInt32, column3 UInt32') PARTITION BY column3 VALUES (1, 2, 3), (3, 2, 1), (78, 43, 3);
 ```
 
-And then it can be read using 
+And then it can be read using
 
 ```sql
-SELECT * FROM azureBlobStorage('http://azurite1:10000/devstoreaccount1', 
-    'test_container', 'test_1.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==', 
+SELECT * FROM azureBlobStorage('http://azurite1:10000/devstoreaccount1',
+    'test_container', 'test_1.csv', 'devstoreaccount1', 'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==',
     'CSV', 'auto', 'column1 UInt32, column2 UInt32, column3 UInt32');
 ```
 
diff --git a/docs/en/sql-reference/table-functions/cluster.md b/docs/en/sql-reference/table-functions/cluster.md
index 904c678750c..7362c433e0e 100644
--- a/docs/en/sql-reference/table-functions/cluster.md
+++ b/docs/en/sql-reference/table-functions/cluster.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/cluster
-sidebar_position: 50
+sidebar_position: 30
 sidebar_label: cluster
 title: "cluster, clusterAllReplicas"
 ---
@@ -9,7 +9,7 @@ Allows to access all shards in an existing cluster which configured in `remote_s
 
 `clusterAllReplicas` function — same as `cluster`, but all replicas are queried. Each replica in a cluster is used as a separate shard/connection.
 
-:::note    
+:::note
 All available clusters are listed in the [system.clusters](../../operations/system-tables/clusters.md) table.
 :::
 
@@ -23,9 +23,9 @@ clusterAllReplicas('cluster_name', db, table[, sharding_key])
 ```
 **Arguments**
 
-- `cluster_name` – Name of a cluster that is used to build a set of addresses and connection parameters to remote and local servers. 
-- `db.table` or `db`, `table` - Name of a database and a table.  
-- `sharding_key` - A sharding key. Optional. Needs to be specified if the cluster has more than one shard. 
+- `cluster_name` – Name of a cluster that is used to build a set of addresses and connection parameters to remote and local servers.
+- `db.table` or `db`, `table` - Name of a database and a table.
+- `sharding_key` - A sharding key. Optional. Needs to be specified if the cluster has more than one shard.
 
 **Returned value**
 
diff --git a/docs/en/sql-reference/table-functions/deltalake.md b/docs/en/sql-reference/table-functions/deltalake.md
index f1cc4659a2a..885d8df6a1e 100644
--- a/docs/en/sql-reference/table-functions/deltalake.md
+++ b/docs/en/sql-reference/table-functions/deltalake.md
@@ -1,6 +1,7 @@
 ---
 slug: /en/sql-reference/table-functions/deltalake
-sidebar_label: DeltaLake
+sidebar_position: 45
+sidebar_label: deltaLake
 ---
 
 # deltaLake Table Function
diff --git a/docs/en/sql-reference/table-functions/dictionary.md b/docs/en/sql-reference/table-functions/dictionary.md
index 73d5039a64b..d34bc86e0cd 100644
--- a/docs/en/sql-reference/table-functions/dictionary.md
+++ b/docs/en/sql-reference/table-functions/dictionary.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/dictionary
-sidebar_position: 54
+sidebar_position: 47
 sidebar_label: dictionary
 title: dictionary
 ---
diff --git a/docs/en/sql-reference/table-functions/executable.md b/docs/en/sql-reference/table-functions/executable.md
index c6aba61aedb..d377c5d4d0c 100644
--- a/docs/en/sql-reference/table-functions/executable.md
+++ b/docs/en/sql-reference/table-functions/executable.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/engines/table-functions/executable
-sidebar_position: 55
+sidebar_position: 50
 sidebar_label:  executable
 keywords: [udf, user defined function, clickhouse, executable, table, function]
 ---
diff --git a/docs/en/sql-reference/table-functions/file.md b/docs/en/sql-reference/table-functions/file.md
index f25da96fddb..c78ffc1d61c 100644
--- a/docs/en/sql-reference/table-functions/file.md
+++ b/docs/en/sql-reference/table-functions/file.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/file
-sidebar_position: 37
+sidebar_position: 60
 sidebar_label: file
 ---
 
diff --git a/docs/en/sql-reference/table-functions/format.md b/docs/en/sql-reference/table-functions/format.md
index 2813eef5bcf..dcebdf16387 100644
--- a/docs/en/sql-reference/table-functions/format.md
+++ b/docs/en/sql-reference/table-functions/format.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/format
-sidebar_position: 56
+sidebar_position: 65
 sidebar_label: format
 ---
 
diff --git a/docs/en/sql-reference/table-functions/gcs.md b/docs/en/sql-reference/table-functions/gcs.md
index 8574f3ecb9c..01b4e4f6a69 100644
--- a/docs/en/sql-reference/table-functions/gcs.md
+++ b/docs/en/sql-reference/table-functions/gcs.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/gcs
-sidebar_position: 45
+sidebar_position: 70
 sidebar_label: gcs
 keywords: [gcs, bucket]
 ---
@@ -16,7 +16,7 @@ gcs(path [,hmac_key, hmac_secret] [,format] [,structure] [,compression])
 ```
 
 :::tip GCS
-The GCS Table Function integrates with Google Cloud Storage by using the GCS XML API and HMAC keys. See the [Google interoperability docs]( https://cloud.google.com/storage/docs/interoperability) for more details about the endpoint and HMAC. 
+The GCS Table Function integrates with Google Cloud Storage by using the GCS XML API and HMAC keys. See the [Google interoperability docs]( https://cloud.google.com/storage/docs/interoperability) for more details about the endpoint and HMAC.
 
 :::
 
diff --git a/docs/en/sql-reference/table-functions/generate.md b/docs/en/sql-reference/table-functions/generate.md
index 724f6d4a1f2..3b9b077af49 100644
--- a/docs/en/sql-reference/table-functions/generate.md
+++ b/docs/en/sql-reference/table-functions/generate.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/generate
-sidebar_position: 47
+sidebar_position: 75
 sidebar_label: generateRandom
 ---
 
diff --git a/docs/en/sql-reference/table-functions/hdfs.md b/docs/en/sql-reference/table-functions/hdfs.md
index 1b52e786de4..680ac54ee78 100644
--- a/docs/en/sql-reference/table-functions/hdfs.md
+++ b/docs/en/sql-reference/table-functions/hdfs.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/hdfs
-sidebar_position: 45
+sidebar_position: 80
 sidebar_label: hdfs
 ---
 
@@ -79,7 +79,7 @@ SELECT count(*)
 FROM hdfs('hdfs://hdfs1:9000/{some,another}_dir/*', 'TSV', 'name String, value UInt32')
 ```
 
-:::note    
+:::note
 If your listing of files contains number ranges with leading zeros, use the construction with braces for each digit separately or use `?`.
 :::
 
diff --git a/docs/en/sql-reference/table-functions/hdfsCluster.md b/docs/en/sql-reference/table-functions/hdfsCluster.md
index afd1fd28a5a..832be46d05f 100644
--- a/docs/en/sql-reference/table-functions/hdfsCluster.md
+++ b/docs/en/sql-reference/table-functions/hdfsCluster.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/hdfsCluster
-sidebar_position: 55
+sidebar_position: 81
 sidebar_label: hdfsCluster
 ---
 
@@ -50,7 +50,7 @@ SELECT count(*)
 FROM hdfsCluster('cluster_simple', 'hdfs://hdfs1:9000/{some,another}_dir/*', 'TSV', 'name String, value UInt32')
 ```
 
-:::note    
+:::note
 If your listing of files contains number ranges with leading zeros, use the construction with braces for each digit separately or use `?`.
 :::
 
diff --git a/docs/en/sql-reference/table-functions/hudi.md b/docs/en/sql-reference/table-functions/hudi.md
index 5a97b2401b4..959a32fe26d 100644
--- a/docs/en/sql-reference/table-functions/hudi.md
+++ b/docs/en/sql-reference/table-functions/hudi.md
@@ -1,6 +1,7 @@
 ---
 slug: /en/sql-reference/table-functions/hudi
-sidebar_label: Hudi
+sidebar_position: 85
+sidebar_label: hudi
 ---
 
 # hudi Table Function
diff --git a/docs/en/sql-reference/table-functions/iceberg.md b/docs/en/sql-reference/table-functions/iceberg.md
index 713b0f9bbf5..30db0ef00aa 100644
--- a/docs/en/sql-reference/table-functions/iceberg.md
+++ b/docs/en/sql-reference/table-functions/iceberg.md
@@ -1,6 +1,7 @@
 ---
 slug: /en/sql-reference/table-functions/iceberg
-sidebar_label: Iceberg
+sidebar_position: 90
+sidebar_label: iceberg
 ---
 
 # iceberg Table Function
diff --git a/docs/en/sql-reference/table-functions/index.md b/docs/en/sql-reference/table-functions/index.md
index b16295db36a..e8eb983b774 100644
--- a/docs/en/sql-reference/table-functions/index.md
+++ b/docs/en/sql-reference/table-functions/index.md
@@ -1,10 +1,10 @@
 ---
 slug: /en/sql-reference/table-functions/
 sidebar_label: Table Functions
-sidebar_position: 34
+sidebar_position: 1
 ---
 
-# Table Functions 
+# Table Functions
 
 Table functions are methods for constructing tables.
 
diff --git a/docs/en/sql-reference/table-functions/input.md b/docs/en/sql-reference/table-functions/input.md
index 6aa1cab00c1..1541177b990 100644
--- a/docs/en/sql-reference/table-functions/input.md
+++ b/docs/en/sql-reference/table-functions/input.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/input
-sidebar_position: 46
+sidebar_position: 95
 sidebar_label: input
 ---
 
diff --git a/docs/en/sql-reference/table-functions/jdbc.md b/docs/en/sql-reference/table-functions/jdbc.md
index 1c12dba9c2b..fbc917c1e1a 100644
--- a/docs/en/sql-reference/table-functions/jdbc.md
+++ b/docs/en/sql-reference/table-functions/jdbc.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/jdbc
-sidebar_position: 43
+sidebar_position: 100
 sidebar_label: jdbc
 ---
 
diff --git a/docs/en/sql-reference/table-functions/merge.md b/docs/en/sql-reference/table-functions/merge.md
index ba0d19b804e..a1f376ba0eb 100644
--- a/docs/en/sql-reference/table-functions/merge.md
+++ b/docs/en/sql-reference/table-functions/merge.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/merge
-sidebar_position: 38
+sidebar_position: 130
 sidebar_label: merge
 ---
 
@@ -16,7 +16,7 @@ merge('db_name', 'tables_regexp')
 **Arguments**
 
 - `db_name` — Possible values:
-    - database name, 
+    - database name,
     - constant expression that returns a string with a database name, for example, `currentDatabase()`,
     - `REGEXP(expression)`, where `expression` is a regular expression to match the DB names.
 
diff --git a/docs/en/sql-reference/table-functions/mongodb.md b/docs/en/sql-reference/table-functions/mongodb.md
index 042225dd1f0..aad60a7003c 100644
--- a/docs/en/sql-reference/table-functions/mongodb.md
+++ b/docs/en/sql-reference/table-functions/mongodb.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/mongodb
-sidebar_position: 42
+sidebar_position: 135
 sidebar_label: mongodb
 ---
 
diff --git a/docs/en/sql-reference/table-functions/mysql.md b/docs/en/sql-reference/table-functions/mysql.md
index 269a50ec8b7..0e5b0f54d1c 100644
--- a/docs/en/sql-reference/table-functions/mysql.md
+++ b/docs/en/sql-reference/table-functions/mysql.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/mysql
-sidebar_position: 42
+sidebar_position: 137
 sidebar_label: mysql
 ---
 
diff --git a/docs/en/sql-reference/table-functions/null.md b/docs/en/sql-reference/table-functions/null.md
index d27295f1916..76e9c32cdbb 100644
--- a/docs/en/sql-reference/table-functions/null.md
+++ b/docs/en/sql-reference/table-functions/null.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/null
-sidebar_position: 53
+sidebar_position: 140
 sidebar_label: null function
 title: 'null'
 ---
diff --git a/docs/en/sql-reference/table-functions/numbers.md b/docs/en/sql-reference/table-functions/numbers.md
index a7e49be44a1..32f51363a0a 100644
--- a/docs/en/sql-reference/table-functions/numbers.md
+++ b/docs/en/sql-reference/table-functions/numbers.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/numbers
-sidebar_position: 39
+sidebar_position: 145
 sidebar_label: numbers
 ---
 
diff --git a/docs/en/sql-reference/table-functions/odbc.md b/docs/en/sql-reference/table-functions/odbc.md
index 781ebacc680..fe6e5390887 100644
--- a/docs/en/sql-reference/table-functions/odbc.md
+++ b/docs/en/sql-reference/table-functions/odbc.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/odbc
-sidebar_position: 44
+sidebar_position: 150
 sidebar_label: odbc
 ---
 
diff --git a/docs/en/sql-reference/table-functions/postgresql.md b/docs/en/sql-reference/table-functions/postgresql.md
index 3e147fb8417..b9211d70cdb 100644
--- a/docs/en/sql-reference/table-functions/postgresql.md
+++ b/docs/en/sql-reference/table-functions/postgresql.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/postgresql
-sidebar_position: 42
+sidebar_position: 160
 sidebar_label: postgresql
 ---
 
diff --git a/docs/en/sql-reference/table-functions/redis.md b/docs/en/sql-reference/table-functions/redis.md
index 3efbe3520a7..98d9a647cee 100644
--- a/docs/en/sql-reference/table-functions/redis.md
+++ b/docs/en/sql-reference/table-functions/redis.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/redis
-sidebar_position: 43
+sidebar_position: 170
 sidebar_label: redis
 ---
 
@@ -31,7 +31,7 @@ redis(host:port, key, structure[, db_index[, password[, pool_size]]])
 - `primary` must be specified, it supports only one column in the primary key. The primary key will be serialized in binary as a Redis key.
 
 - columns other than the primary key will be serialized in binary as Redis value in corresponding order.
-  
+
 - queries with key equals or in filtering will be optimized to multi keys lookup from Redis. If queries without filtering key full table scan will happen which is a heavy operation.
 
 
diff --git a/docs/en/sql-reference/table-functions/remote.md b/docs/en/sql-reference/table-functions/remote.md
index 8dcae6a0a79..fba3ea55653 100644
--- a/docs/en/sql-reference/table-functions/remote.md
+++ b/docs/en/sql-reference/table-functions/remote.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/remote
-sidebar_position: 40
+sidebar_position: 175
 sidebar_label: remote
 ---
 
@@ -89,10 +89,10 @@ SELECT * FROM remote_table;
 ```
 
 ### Migration of tables from one system to another:
-This example uses one table from a sample dataset.  The database is `imdb`, and the table is `actors`. 
+This example uses one table from a sample dataset.  The database is `imdb`, and the table is `actors`.
 
 #### On the source ClickHouse system (the system that currently hosts the data)
-- Verify the source database and table name (`imdb.actors`)  
+- Verify the source database and table name (`imdb.actors`)
   ```sql
   show databases
   ```
diff --git a/docs/en/sql-reference/table-functions/s3.md b/docs/en/sql-reference/table-functions/s3.md
index 7068c208022..55c825b8b9b 100644
--- a/docs/en/sql-reference/table-functions/s3.md
+++ b/docs/en/sql-reference/table-functions/s3.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/s3
-sidebar_position: 45
+sidebar_position: 180
 sidebar_label: s3
 keywords: [s3, gcs, bucket]
 ---
@@ -33,7 +33,7 @@ For GCS, substitute your HMAC key and HMAC secret where you see `aws_access_key_
   and not ~~https://storage.cloud.google.com~~.
   :::
 
-- `NOSIGN` - If this keyword is provided in place of credentials, all the requests will not be signed. 
+- `NOSIGN` - If this keyword is provided in place of credentials, all the requests will not be signed.
 - `format` — The [format](../../interfaces/formats.md#formats) of the file.
 - `structure` — Structure of the table. Format `'column1_name column1_type, column2_name column2_type, ...'`.
 - `compression` — Parameter is optional. Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. By default, it will autodetect compression by file extension.
diff --git a/docs/en/sql-reference/table-functions/s3Cluster.md b/docs/en/sql-reference/table-functions/s3Cluster.md
index a1d9b9cdad4..d5bdc85f9f8 100644
--- a/docs/en/sql-reference/table-functions/s3Cluster.md
+++ b/docs/en/sql-reference/table-functions/s3Cluster.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/s3Cluster
-sidebar_position: 55
+sidebar_position: 181
 sidebar_label: s3Cluster
 title: "s3Cluster Table Function"
 ---
@@ -31,18 +31,18 @@ Select the data from all the files in the `/root/data/clickhouse` and `/root/dat
 
 ``` sql
 SELECT * FROM s3Cluster(
-    'cluster_simple', 
-    'http://minio1:9001/root/data/{clickhouse,database}/*', 
-    'minio', 
-    'minio123', 
-    'CSV', 
+    'cluster_simple',
+    'http://minio1:9001/root/data/{clickhouse,database}/*',
+    'minio',
+    'minio123',
+    'CSV',
     'name String, value UInt32, polygon Array(Array(Tuple(Float64, Float64)))'
 ) ORDER BY (name, value, polygon);
 ```
 
 Count the total amount of rows in all files in the cluster `cluster_simple`:
 
-:::tip    
+:::tip
 If your listing of files contains number ranges with leading zeros, use the construction with braces for each digit separately or use `?`.
 :::
 
diff --git a/docs/en/sql-reference/table-functions/sqlite.md b/docs/en/sql-reference/table-functions/sqlite.md
index 344fab4fad2..4188b598cb2 100644
--- a/docs/en/sql-reference/table-functions/sqlite.md
+++ b/docs/en/sql-reference/table-functions/sqlite.md
@@ -1,19 +1,19 @@
 ---
 slug: /en/sql-reference/table-functions/sqlite
-sidebar_position: 55
+sidebar_position: 185
 sidebar_label: sqlite
 title: sqlite
 ---
 
 Allows to perform queries on a data stored in an [SQLite](../../engines/database-engines/sqlite.md) database.
 
-**Syntax** 
+**Syntax**
 
 ``` sql
     sqlite('db_path', 'table_name')
 ```
 
-**Arguments** 
+**Arguments**
 
 - `db_path` — Path to a file with an SQLite database. [String](../../sql-reference/data-types/string.md).
 - `table_name` — Name of a table in the SQLite database. [String](../../sql-reference/data-types/string.md).
@@ -40,6 +40,6 @@ Result:
 └───────┴──────┘
 ```
 
-**See Also** 
+**See Also**
 
 - [SQLite](../../engines/table-engines/integrations/sqlite.md) table engine
diff --git a/docs/en/sql-reference/table-functions/url.md b/docs/en/sql-reference/table-functions/url.md
index ac4162c15de..2ab43f1b895 100644
--- a/docs/en/sql-reference/table-functions/url.md
+++ b/docs/en/sql-reference/table-functions/url.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/url
-sidebar_position: 41
+sidebar_position: 200
 sidebar_label: url
 ---
 
diff --git a/docs/en/sql-reference/table-functions/urlCluster.md b/docs/en/sql-reference/table-functions/urlCluster.md
index 07d3f4a7362..cf05189112e 100644
--- a/docs/en/sql-reference/table-functions/urlCluster.md
+++ b/docs/en/sql-reference/table-functions/urlCluster.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/urlCluster
-sidebar_position: 55
+sidebar_position: 201
 sidebar_label: urlCluster
 ---
 
diff --git a/docs/en/sql-reference/table-functions/view.md b/docs/en/sql-reference/table-functions/view.md
index 2c21fe9ff4b..fafb204f31a 100644
--- a/docs/en/sql-reference/table-functions/view.md
+++ b/docs/en/sql-reference/table-functions/view.md
@@ -1,6 +1,6 @@
 ---
 slug: /en/sql-reference/table-functions/view
-sidebar_position: 51
+sidebar_position: 210
 sidebar_label: view
 title: view
 ---

From 6c7487bf551e7f0ed3c648d410c97aa90f32b4ac Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 09:23:50 -0400
Subject: [PATCH 712/722] document partitioned writes for s3 engine

---
 .../engines/table-engines/integrations/s3.md  | 154 +++++++++++++++---
 1 file changed, 130 insertions(+), 24 deletions(-)

diff --git a/docs/en/engines/table-engines/integrations/s3.md b/docs/en/engines/table-engines/integrations/s3.md
index 10a72394b57..5a24dc5458b 100644
--- a/docs/en/engines/table-engines/integrations/s3.md
+++ b/docs/en/engines/table-engines/integrations/s3.md
@@ -8,30 +8,7 @@ sidebar_label: S3
 
 This engine provides integration with [Amazon S3](https://aws.amazon.com/s3/) ecosystem. This engine is similar to the [HDFS](../../../engines/table-engines/special/file.md#table_engines-hdfs) engine, but provides S3-specific features.
 
-## Create Table {#creating-a-table}
-
-``` sql
-CREATE TABLE s3_engine_table (name String, value UInt32)
-    ENGINE = S3(path [, NOSIGN | aws_access_key_id, aws_secret_access_key,] format, [compression])
-    [PARTITION BY expr]
-    [SETTINGS ...]
-```
-
-**Engine parameters**
-
-- `path` — Bucket url with path to file. Supports following wildcards in readonly mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc'`, `'def'` — strings. For more information see [below](#wildcards-in-path).
-- `NOSIGN` - If this keyword is provided in place of credentials, all the requests will not be signed. 
-- `format` — The [format](../../../interfaces/formats.md#formats) of the file.
-- `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file. For more information see [Using S3 for Data Storage](../mergetree-family/mergetree.md#table_engine-mergetree-s3).
-- `compression` — Compression type. Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. Parameter is optional. By default, it will auto-detect compression by file extension.
-
-### PARTITION BY
-
-`PARTITION BY` — Optional. In most cases you don't need a partition key, and if it is needed you generally don't need a partition key more granular than by month. Partitioning does not speed up queries (in contrast to the ORDER BY expression). You should never use too granular partitioning. Don't partition your data by client identifiers or names (instead, make client identifier or name the first column in the ORDER BY expression).
-
-For partitioning by month, use the `toYYYYMM(date_column)` expression, where `date_column` is a column with a date of the type [Date](/docs/en/sql-reference/data-types/date.md). The partition names here have the `"YYYYMM"` format.
-
-**Example**
+## Example
 
 ``` sql
 CREATE TABLE s3_engine_table (name String, value UInt32)
@@ -49,6 +26,135 @@ SELECT * FROM s3_engine_table LIMIT 2;
 │ two  │     2 │
 └──────┴───────┘
 ```
+## Create Table {#creating-a-table}
+
+``` sql
+CREATE TABLE s3_engine_table (name String, value UInt32)
+    ENGINE = S3(path [, NOSIGN | aws_access_key_id, aws_secret_access_key,] format, [compression])
+    [PARTITION BY expr]
+    [SETTINGS ...]
+```
+
+### Engine parameters
+
+- `path` — Bucket url with path to file. Supports following wildcards in readonly mode: `*`, `?`, `{abc,def}` and `{N..M}` where `N`, `M` — numbers, `'abc'`, `'def'` — strings. For more information see [below](#wildcards-in-path).
+- `NOSIGN` - If this keyword is provided in place of credentials, all the requests will not be signed. 
+- `format` — The [format](../../../interfaces/formats.md#formats) of the file.
+- `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file. For more information see [Using S3 for Data Storage](../mergetree-family/mergetree.md#table_engine-mergetree-s3).
+- `compression` — Compression type. Supported values: `none`, `gzip/gz`, `brotli/br`, `xz/LZMA`, `zstd/zst`. Parameter is optional. By default, it will auto-detect compression by file extension.
+
+### PARTITION BY
+
+`PARTITION BY` — Optional. In most cases you don't need a partition key, and if it is needed you generally don't need a partition key more granular than by month. Partitioning does not speed up queries (in contrast to the ORDER BY expression). You should never use too granular partitioning. Don't partition your data by client identifiers or names (instead, make client identifier or name the first column in the ORDER BY expression).
+
+For partitioning by month, use the `toYYYYMM(date_column)` expression, where `date_column` is a column with a date of the type [Date](/docs/en/sql-reference/data-types/date.md). The partition names here have the `"YYYYMM"` format.
+
+### Querying partitioned data
+
+This example uses the [docker compose recipe](https://github.com/ClickHouse/examples/tree/5fdc6ff72f4e5137e23ea075c88d3f44b0202490/docker-compose-recipes/recipes/ch-and-minio-S3), which integrates ClickHouse and MinIO.  You should be able to reproduce the same queries using S3 by replacing the endpoint and authentication values.
+
+Notice that the S3 endpoint in the `ENGINE` configuration uses the parameter token `{_partition_id}` as part of the S3 object (filename), and that the SELECT queries select against those resulting object names (e.g., `test_3.csv`). 
+
+:::note
+As shown in the example, querying from S3 tables that are partitioned is
+not directly supported at this time, but can be accomplished by querying the bucket contents with a wildcard.
+
+The primary use-case for writing 
+partitioned data in S3 is to enable transferring that data into another
+ClickHouse system (for example, moving from on-prem systems to ClickHouse
+Cloud).  Because ClickHouse datasets are often very large, and network
+reliability is sometimes imperfect it makes sense to transfer datasets
+in subsets, hence partitioned writes.
+:::
+
+#### Create the table
+```sql
+CREATE TABLE p
+(
+    `column1` UInt32,
+    `column2` UInt32,
+    `column3` UInt32
+)
+ENGINE = S3(
+# highlight-next-line
+           'http://minio:10000/clickhouse//test_{_partition_id}.csv', 
+           'minioadmin', 
+           'minioadminpassword', 
+           'CSV')
+PARTITION BY column3
+```
+
+#### Insert data
+```sql
+insert into p values (1, 2, 3), (3, 2, 1), (78, 43, 45)
+```
+
+#### Select from partition 3
+
+:::tip
+This query uses the s3 table function
+:::
+
+```sql
+SELECT *
+FROM s3('http://minio:10000/clickhouse//test_3.csv', 'minioadmin', 'minioadminpassword', 'CSV')
+```
+```response
+┌─c1─┬─c2─┬─c3─┐
+│  1 │  2 │  3 │
+└────┴────┴────┘
+```
+
+#### Select from partition 1
+```sql
+SELECT *
+FROM s3('http://minio:10000/clickhouse//test_1.csv', 'minioadmin', 'minioadminpassword', 'CSV')
+```
+```response
+┌─c1─┬─c2─┬─c3─┐
+│  3 │  2 │  1 │
+└────┴────┴────┘
+```
+
+#### Select from partition 45
+```sql
+SELECT *
+FROM s3('http://minio:10000/clickhouse//test_45.csv', 'minioadmin', 'minioadminpassword', 'CSV')
+```
+```response
+┌─c1─┬─c2─┬─c3─┐
+│ 78 │ 43 │ 45 │
+└────┴────┴────┘
+```
+
+#### Select from all partitions
+
+```sql
+SELECT *
+FROM s3('http://minio:10000/clickhouse//**', 'minioadmin', 'minioadminpassword', 'CSV')
+```
+```response
+┌─c1─┬─c2─┬─c3─┐
+│  3 │  2 │  1 │
+└────┴────┴────┘
+┌─c1─┬─c2─┬─c3─┐
+│  1 │  2 │  3 │
+└────┴────┴────┘
+┌─c1─┬─c2─┬─c3─┐
+│ 78 │ 43 │ 45 │
+└────┴────┴────┘
+```
+
+You may naturally try to `Select * from p`, but as noted above, this query will fail; use the preceding query.
+
+```sql
+SELECT * FROM p
+```
+```response
+Received exception from server (version 23.4.1):
+Code: 48. DB::Exception: Received from localhost:9000. DB::Exception: Reading from a partitioned S3 storage is not implemented yet. (NOT_IMPLEMENTED)
+```
+
 ## Virtual columns {#virtual-columns}
 
 - `_path` — Path to the file.

From 3a0db35d16bd8222e8a406064ae60648ca97a23c Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 10:01:54 -0400
Subject: [PATCH 713/722] allow on-prem

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index 46bd0da4236..9db0e96e5a9 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1852,6 +1852,7 @@ observability
 odbc
 ok
 omclickhouse
+on-prem
 onstraints
 ontime
 openSSL
@@ -1936,6 +1937,7 @@ prefertch
 prefetch
 prefetchsize
 preloaded
+prem
 prepend
 prepended
 prepends
@@ -2131,6 +2133,7 @@ scala
 schemas
 seekable
 seektable
+self-managed
 sequenceCount
 sequenceMatch
 sequenceNextNode

From 7e3eaadaaca3bc94939950b76bd49626800276d0 Mon Sep 17 00:00:00 2001
From: Ilya Yatsishin <2159081+qoega@users.noreply.github.com>
Date: Fri, 23 Jun 2023 18:55:04 +0200
Subject: [PATCH 714/722] Make SQLancer check not "always green"

---
 tests/ci/sqlancer_check.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/tests/ci/sqlancer_check.py b/tests/ci/sqlancer_check.py
index 144dea54133..7c8ffbab7f7 100644
--- a/tests/ci/sqlancer_check.py
+++ b/tests/ci/sqlancer_check.py
@@ -153,10 +153,10 @@ def main():
     test_results = []  # type: TestResults
     # Try to get status message saved by the SQLancer
     try:
-        # with open(
-        #     os.path.join(workspace_path, "status.txt"), "r", encoding="utf-8"
-        # ) as status_f:
-        #     status = status_f.readline().rstrip("\n")
+        with open(
+            os.path.join(workspace_path, "status.txt"), "r", encoding="utf-8"
+        ) as status_f:
+            status = status_f.readline().rstrip("\n")
         if os.path.exists(os.path.join(workspace_path, "server_crashed.log")):
             test_results.append(TestResult("Server crashed", "FAIL"))
         with open(
@@ -171,7 +171,7 @@ def main():
         ) as desc_f:
             description = desc_f.readline().rstrip("\n")
     except:
-        # status = "failure"
+        status = "failure"
         description = "Task failed: $?=" + str(retcode)
 
     description = format_description(description)

From 1f38209de9cc306e45939bf74293cb8f83b43049 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 14:45:52 -0400
Subject: [PATCH 715/722] add L2SquaredDistance to docs

---
 .../functions/distance-functions.md           | 37 +++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/en/sql-reference/functions/distance-functions.md b/docs/en/sql-reference/functions/distance-functions.md
index 67affb88a53..67540d7366e 100644
--- a/docs/en/sql-reference/functions/distance-functions.md
+++ b/docs/en/sql-reference/functions/distance-functions.md
@@ -237,6 +237,43 @@ Result:
 └────────────────────────────┘
 ```
 
+L2SquaredDistance
+
+Calculates the sum of the squares of the difference between the corresponding elements of two vectors.
+
+**Syntax**
+
+```sql
+L2SquaredDistance(vector1, vector2)
+```
+
+Alias: `distanceL2Squared`.
+
+**Arguments**
+
+- `vector1` — First vector. [Tuple](../../sql-reference/data-types/tuple.md) or [Array](../../sql-reference/data-types/array.md).
+- `vector2` — Second vector. [Tuple](../../sql-reference/data-types/tuple.md) or [Array](../../sql-reference/data-types/array.md).
+
+**Returned value**
+
+Type: [Float](../../sql-reference/data-types/float.md).
+
+**Example**
+
+Query:
+
+```sql
+SELECT L2SquaredDistance([1, 2, 3], [0, 0, 0])
+```
+
+Result:
+
+```response
+┌─L2SquaredDistance([1, 2, 3], [0, 0, 0])─┐
+│                                      14 │
+└─────────────────────────────────────────┘
+```
+
 ## LinfDistance
 
 Calculates the distance between two points (the values of the vectors are the coordinates) in `L_{inf}` space ([maximum norm](https://en.wikipedia.org/wiki/Norm_(mathematics)#Maximum_norm_(special_case_of:_infinity_norm,_uniform_norm,_or_supremum_norm))).

From d8ccb36621165b88ca25165d442c9465036a4383 Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 15:12:07 -0400
Subject: [PATCH 716/722] hyphens not allowed in dictionary

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 2 --
 1 file changed, 2 deletions(-)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index 2865209cadd..dc68436beef 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1852,7 +1852,6 @@ observability
 odbc
 ok
 omclickhouse
-on-prem
 onstraints
 ontime
 openSSL
@@ -2133,7 +2132,6 @@ scala
 schemas
 seekable
 seektable
-self-managed
 sequenceCount
 sequenceMatch
 sequenceNextNode

From 4d92fc915fd45f8a7913b30e6ac2c296b1364f0d Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 15:16:57 -0400
Subject: [PATCH 717/722] revert to master

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index 2865209cadd..893a2bae74f 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1852,7 +1852,6 @@ observability
 odbc
 ok
 omclickhouse
-on-prem
 onstraints
 ontime
 openSSL
@@ -1937,7 +1936,6 @@ prefertch
 prefetch
 prefetchsize
 preloaded
-prem
 prepend
 prepended
 prepends
@@ -2133,7 +2131,6 @@ scala
 schemas
 seekable
 seektable
-self-managed
 sequenceCount
 sequenceMatch
 sequenceNextNode

From b3dee721215478c497b46de780bc24452a6eb5ca Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 15:19:01 -0400
Subject: [PATCH 718/722] no hyphens in dictionary

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 2 --
 1 file changed, 2 deletions(-)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index 2865209cadd..dc68436beef 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -1852,7 +1852,6 @@ observability
 odbc
 ok
 omclickhouse
-on-prem
 onstraints
 ontime
 openSSL
@@ -2133,7 +2132,6 @@ scala
 schemas
 seekable
 seektable
-self-managed
 sequenceCount
 sequenceMatch
 sequenceNextNode

From 7bde0781b4ec34c86780b945ea894b764ca290f9 Mon Sep 17 00:00:00 2001
From: DanRoscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 16:05:58 -0400
Subject: [PATCH 719/722] missing anchor

---
 docs/en/sql-reference/functions/distance-functions.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/sql-reference/functions/distance-functions.md b/docs/en/sql-reference/functions/distance-functions.md
index 67540d7366e..1774c22014d 100644
--- a/docs/en/sql-reference/functions/distance-functions.md
+++ b/docs/en/sql-reference/functions/distance-functions.md
@@ -237,7 +237,7 @@ Result:
 └────────────────────────────┘
 ```
 
-L2SquaredDistance
+## L2SquaredDistance
 
 Calculates the sum of the squares of the difference between the corresponding elements of two vectors.
 

From cd8cdd4e9b0572522da77b08053250883b83e27e Mon Sep 17 00:00:00 2001
From: Dan Roscigno <dan@roscigno.com>
Date: Fri, 23 Jun 2023 16:20:56 -0400
Subject: [PATCH 720/722] Update aspell-dict.txt

---
 utils/check-style/aspell-ignore/en/aspell-dict.txt | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/utils/check-style/aspell-ignore/en/aspell-dict.txt b/utils/check-style/aspell-ignore/en/aspell-dict.txt
index 893a2bae74f..bf988295644 100644
--- a/utils/check-style/aspell-ignore/en/aspell-dict.txt
+++ b/utils/check-style/aspell-ignore/en/aspell-dict.txt
@@ -772,6 +772,7 @@ SMALLINT
 SPNEGO
 SQEs
 SQLAlchemy
+SquaredDistance
 SQLConsoleDetail
 SQLInsert
 SQLSTATE
@@ -1936,6 +1937,7 @@ prefertch
 prefetch
 prefetchsize
 preloaded
+prem
 prepend
 prepended
 prepends

From 8243b624e91492e440400254b0c6be117de65c2e Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Fri, 23 Jun 2023 23:33:45 +0200
Subject: [PATCH 721/722] Speedup DateLUT initialization

---
 src/Common/DateLUTImpl.cpp | 86 ++++++++++++++++++++++----------------
 1 file changed, 50 insertions(+), 36 deletions(-)

diff --git a/src/Common/DateLUTImpl.cpp b/src/Common/DateLUTImpl.cpp
index 6eb8b47b114..28f326421d1 100644
--- a/src/Common/DateLUTImpl.cpp
+++ b/src/Common/DateLUTImpl.cpp
@@ -33,8 +33,24 @@ UInt8 getDayOfWeek(const cctz::civil_day & date)
     UNREACHABLE();
 }
 
+inline cctz::time_point<cctz::seconds> lookupTz(const cctz::time_zone & cctz_time_zone, const cctz::civil_day & date)
+{
+    cctz::time_zone::civil_lookup lookup = cctz_time_zone.lookup(date);
+
+    /// Ambiguity is possible if time was changed backwards at the midnight
+    /// or after midnight time has been changed back to midnight, for example one hour backwards at 01:00
+    /// or after midnight time has been changed to the previous day, for example two hours backwards at 01:00
+    /// Then midnight appears twice. Usually time change happens exactly at 00:00 or 01:00.
+
+    /// If transition did not involve previous day, we should use the first midnight as the start of the day,
+    /// otherwise it's better to use the second midnight.
+
+    return lookup.trans < lookup.post
+        ? lookup.post /* Second midnight appears after transition, so there was a piece of previous day after transition */
+        : lookup.pre;
 }
 
+}
 
 __attribute__((__weak__)) extern bool inside_main;
 
@@ -63,27 +79,49 @@ DateLUTImpl::DateLUTImpl(const std::string & time_zone_)
     offset_is_whole_number_of_minutes_during_epoch = true;
 
     cctz::civil_day date = lut_start;
+    cctz::time_point<cctz::seconds> start_of_day_time_point = lookupTz(cctz_time_zone, date);
+
+    auto next_transition_date = date;
 
     UInt32 i = 0;
     do
     {
-        cctz::time_zone::civil_lookup lookup = cctz_time_zone.lookup(date);
+        Values & values = lut[i];
 
-        /// Ambiguity is possible if time was changed backwards at the midnight
-        /// or after midnight time has been changed back to midnight, for example one hour backwards at 01:00
-        /// or after midnight time has been changed to the previous day, for example two hours backwards at 01:00
-        /// Then midnight appears twice. Usually time change happens exactly at 00:00 or 01:00.
+        values.time_at_offset_change_value = 0;
+        values.amount_of_offset_change_value = 0;
 
-        /// If transition did not involve previous day, we should use the first midnight as the start of the day,
-        /// otherwise it's better to use the second midnight.
+        if (date >= next_transition_date)
+        {
+            start_of_day_time_point = lookupTz(cctz_time_zone, date);
 
-        std::chrono::time_point start_of_day_time_point = lookup.trans < lookup.post
-            ? lookup.post /* Second midnight appears after transition, so there was a piece of previous day after transition */
-            : lookup.pre;
+            /// If UTC offset was changed this day.
+            /// Change in time zone without transition is possible, e.g. Moscow 1991 Sun, 31 Mar, 02:00 MSK to EEST
+            cctz::time_zone::civil_transition transition{};
+            if (cctz_time_zone.next_transition(start_of_day_time_point - std::chrono::seconds(1), &transition)
+                && (cctz::civil_day(transition.from) == date || cctz::civil_day(transition.to) == date)
+                && transition.from != transition.to)
+            {
+                values.time_at_offset_change_value = (transition.from - cctz::civil_second(date)) / Values::OffsetChangeFactor;
+                values.amount_of_offset_change_value = (transition.to - transition.from) / Values::OffsetChangeFactor;
+
+                /// We don't support too large changes.
+                if (values.amount_of_offset_change_value > 24 * 4)
+                    values.amount_of_offset_change_value = 24 * 4;
+                else if (values.amount_of_offset_change_value < -24 * 4)
+                    values.amount_of_offset_change_value = -24 * 4;
+
+                /// We don't support cases when time change results in switching to previous day.
+                /// Shift the point of time change later.
+                if (values.time_at_offset_change_value + values.amount_of_offset_change_value < 0)
+                    values.time_at_offset_change_value = -values.amount_of_offset_change_value;
+            }
+
+            next_transition_date = std::min(cctz::civil_day(transition.to), cctz::civil_day(transition.from));
+        }
 
         start_of_day = std::chrono::system_clock::to_time_t(start_of_day_time_point);
 
-        Values & values = lut[i];
         values.year = date.year();
         values.month = date.month();
         values.day_of_month = date.day();
@@ -103,38 +141,14 @@ DateLUTImpl::DateLUTImpl(const std::string & time_zone_)
         else
             values.days_in_month = i != 0 ? lut[i - 1].days_in_month : 31;
 
-        values.time_at_offset_change_value = 0;
-        values.amount_of_offset_change_value = 0;
-
         if (offset_is_whole_number_of_hours_during_epoch && start_of_day > 0 && start_of_day % 3600)
             offset_is_whole_number_of_hours_during_epoch = false;
 
         if (offset_is_whole_number_of_minutes_during_epoch && start_of_day > 0 && start_of_day % 60)
             offset_is_whole_number_of_minutes_during_epoch = false;
 
-        /// If UTC offset was changed this day.
-        /// Change in time zone without transition is possible, e.g. Moscow 1991 Sun, 31 Mar, 02:00 MSK to EEST
-        cctz::time_zone::civil_transition transition{};
-        if (cctz_time_zone.next_transition(start_of_day_time_point - std::chrono::seconds(1), &transition)
-            && (cctz::civil_day(transition.from) == date || cctz::civil_day(transition.to) == date)
-            && transition.from != transition.to)
-        {
-            values.time_at_offset_change_value = (transition.from - cctz::civil_second(date)) / Values::OffsetChangeFactor;
-            values.amount_of_offset_change_value = (transition.to - transition.from) / Values::OffsetChangeFactor;
-
-            /// We don't support too large changes.
-            if (values.amount_of_offset_change_value > 24 * 4)
-                values.amount_of_offset_change_value = 24 * 4;
-            else if (values.amount_of_offset_change_value < -24 * 4)
-                values.amount_of_offset_change_value = -24 * 4;
-
-            /// We don't support cases when time change results in switching to previous day.
-            /// Shift the point of time change later.
-            if (values.time_at_offset_change_value + values.amount_of_offset_change_value < 0)
-                values.time_at_offset_change_value = -values.amount_of_offset_change_value;
-        }
-
         /// Going to next day.
+        start_of_day_time_point += std::chrono::hours(24);
         ++date;
         ++i;
     }

From dfc1afab623380ff5230372b847048b04d801117 Mon Sep 17 00:00:00 2001
From: Alexander Gololobov <440544+davenger@users.noreply.github.com>
Date: Sat, 24 Jun 2023 07:14:21 +0200
Subject: [PATCH 722/722] Better naming and comments

---
 src/Common/DateLUTImpl.cpp | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/src/Common/DateLUTImpl.cpp b/src/Common/DateLUTImpl.cpp
index 28f326421d1..d7bdd0bb3d9 100644
--- a/src/Common/DateLUTImpl.cpp
+++ b/src/Common/DateLUTImpl.cpp
@@ -79,10 +79,13 @@ DateLUTImpl::DateLUTImpl(const std::string & time_zone_)
     offset_is_whole_number_of_minutes_during_epoch = true;
 
     cctz::civil_day date = lut_start;
-    cctz::time_point<cctz::seconds> start_of_day_time_point = lookupTz(cctz_time_zone, date);
+    cctz::time_point<cctz::seconds> start_of_day_time_point_if_no_transitions = lookupTz(cctz_time_zone, date);
 
     auto next_transition_date = date;
 
+    /// Fill the lookup table:
+    /// Adjustments only occur at the dates of transitions. We save next_transition_date and add 24h to the
+    /// previous value until we reach the it. Then we do the adjustment and get the new next_transition_date.
     UInt32 i = 0;
     do
     {
@@ -93,12 +96,12 @@ DateLUTImpl::DateLUTImpl(const std::string & time_zone_)
 
         if (date >= next_transition_date)
         {
-            start_of_day_time_point = lookupTz(cctz_time_zone, date);
+            start_of_day_time_point_if_no_transitions = lookupTz(cctz_time_zone, date);
 
             /// If UTC offset was changed this day.
             /// Change in time zone without transition is possible, e.g. Moscow 1991 Sun, 31 Mar, 02:00 MSK to EEST
             cctz::time_zone::civil_transition transition{};
-            if (cctz_time_zone.next_transition(start_of_day_time_point - std::chrono::seconds(1), &transition)
+            if (cctz_time_zone.next_transition(start_of_day_time_point_if_no_transitions - std::chrono::seconds(1), &transition)
                 && (cctz::civil_day(transition.from) == date || cctz::civil_day(transition.to) == date)
                 && transition.from != transition.to)
             {
@@ -120,7 +123,7 @@ DateLUTImpl::DateLUTImpl(const std::string & time_zone_)
             next_transition_date = std::min(cctz::civil_day(transition.to), cctz::civil_day(transition.from));
         }
 
-        start_of_day = std::chrono::system_clock::to_time_t(start_of_day_time_point);
+        start_of_day = std::chrono::system_clock::to_time_t(start_of_day_time_point_if_no_transitions);
 
         values.year = date.year();
         values.month = date.month();
@@ -148,7 +151,7 @@ DateLUTImpl::DateLUTImpl(const std::string & time_zone_)
             offset_is_whole_number_of_minutes_during_epoch = false;
 
         /// Going to next day.
-        start_of_day_time_point += std::chrono::hours(24);
+        start_of_day_time_point_if_no_transitions += std::chrono::hours(24);
         ++date;
         ++i;
     }